{
  "id": "shared-context-spec:agent-mux-observability-telemetry-iface",
  "_kind": "SharedContextSpec",
  "_file": "extensions/shared-context-specs/agent-mux-observability-types.yaml",
  "_cluster": "extensions",
  "attributes": {
    "displayName": "Telemetry (interface)",
    "contextKind": "interface-contract",
    "typescriptInterface": "Telemetry",
    "producerIface": "@a5c-ai/agent-mux-observability createTelemetry (telemetry.ts) / createSimpleTelemetry (telemetry-simple.ts)",
    "consumerIfaces": [
      "@a5c-ai/agent-mux-core runs / dispatcher (span emitters)",
      "@a5c-ai/agent-mux-gateway server.ts (active-runs gauge)"
    ],
    "fieldSchema": [
      "recordRunStart:fn(agent,model?):required:Counter inc",
      "recordRunComplete:fn(agent,model?,duration,cost?):required:Counter+histogram",
      "recordRunError:fn(agent,model?,error,cost?):required:Counter inc",
      "recordToolCall:fn(toolName,duration,success):required:Tool-call metric",
      "recordAuthEvent:fn(agent,method,success):required:Auth metric",
      "startRunSpan|startToolCallSpan|startSubagentSpan:fn(...)->span:required:Span constructors",
      "endSpanSuccess|endSpanError:fn(span,...):required:Span terminators",
      "initialize:fn():optional:Init hook",
      "shutdown:fn()->Promise<void>:optional:Flush + close",
      "setActiveRuns:fn(count):optional:Active-runs gauge"
    ],
    "sourceCitation": "packages/agent-mux/observability/src/types.ts:102-141"
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "package:a5c-ai-agent-mux-observability",
      "to": "shared-context-spec:agent-mux-observability-telemetry-iface",
      "kind": "has_payload_schema",
      "attributes": {}
    }
  ]
}