@qodo/sdk 0.13.4 → 2.0.0-next.0

package/dist/observability/attributes.js

@@ -0,0 +1,184 @@
+/**
+ * OTel attribute keys used by the SDK 2.0 observability layer.
+ *
+ * Mirrors QAR's `src/qar/observability/attributes.py` discipline: every attribute
+ * string lives here, never inline. Per-attribute notes record the rationale so
+ * future implementers don't accidentally re-add keys that were
+ * intentionally skipped on the SDK side.
+ *
+ * Span emission lives in `src/observability/spans.ts` (per-public-API,
+ * client-side) and `src/tracing/SdkTracer.ts` (observer-side). Attribute
+ * strings are read from this module exclusively — grep for `qar.` /
+ * `gen_ai.` outside this file fails the audit test.
+ */
+// ---------------------------------------------------------------------------
+// Service-level (SDK process identity)
+// ---------------------------------------------------------------------------
+export const SERVICE_NAME = 'service.name';
+export const SERVICE_VERSION = 'service.version';
+export const SERVICE_NAMESPACE = 'service.namespace';
+/** Stamped on every SDK-side span. QAR's spans carry `service.name = "qar"`; correlation across the wire is by `trace_id`, never service identity. */
+export const SERVICE_NAME_VALUE = '@qodo/sdk';
+/** Same `qodo` namespace QAR uses, so a Phoenix query filtering `service.namespace = "qodo"` returns SDK + runtime spans. */
+export const SERVICE_NAMESPACE_VALUE = 'qodo';
+// ---------------------------------------------------------------------------
+// QAR runtime — applied on the SDK side (the SDK has the knowledge to set these)
+// ---------------------------------------------------------------------------
+export const QAR_SESSION_ID = 'qar.session_id';
+export const QAR_MESSAGE_ID = 'qar.message_id';
+export const QAR_PARENT_MESSAGE_ID = 'qar.parent_message_id';
+export const QAR_TASK_ID = 'qar.task_id';
+export const QAR_ENVELOPE_KIND = 'qar.envelope.kind';
+export const QAR_TOOL_NAME = 'qar.tool_name';
+export const QAR_TOOL_CALL_ID = 'qar.tool_call_id';
+/** `"sdk-side"` on every tool span the SDK opens; QAR sets `"runtime-side"` / `"mcp:<server>"` on its own. */
+export const QAR_TOOL_ORIGIN = 'qar.tool_origin';
+export const QAR_TOOL_OUTCOME = 'qar.tool_outcome';
+/**
+ * Originating node name for parallel-batched tool calls. Set on every
+ * `qar.client.tool.handler` and `qar.client.tool.respond` span:
+ * `default` (or the configured agent
+ * identifier) for single-agent Pattern A/B, the graph node id for Pattern C.
+ * Without this, multi-node graphs with parallel in-flight tool calls couldn't
+ * be disambiguated in traces.
+ */
+export const QAR_NODE_NAME = 'qar.node_name';
+export const QAR_SKILL_NAME = 'qar.skill_name';
+export const QAR_AGENT_ID = 'qar.agent_id';
+/**
+ * Inline-graph attributes. Set on the `qar.client.task.start` span the
+ * SDK opens for an inline-graph dispatch.
+ *
+ *   - `qar.graph.entry`  — entry-point node name (`graph.entry`).
+ *   - `qar.graph.depth`  — longest acyclic path length from `entry`, computed
+ *     client-side at validate-time. Lets traces distinguish flat fan-outs
+ *     (depth 1) from deeply-nested chains without re-parsing the spec.
+ *   - `qar.agent.kind`   — closed value set `"inline" | "agent_id"`. The
+ *     SDK stamps the parent `qar.client.task.start` span with `"inline"`
+ *     when *any* node carries an inline `AgentSpec` and `"agent_id"` when
+ *     every node is a server-static reference. QAR's per-node spans use
+ *     the same vocabulary, set per-node from each agent's shape.
+ */
+export const QAR_GRAPH_ENTRY = 'qar.graph.entry';
+export const QAR_GRAPH_DEPTH = 'qar.graph.depth';
+export const QAR_AGENT_KIND = 'qar.agent.kind';
+/**
+ * Evaluator attributes. Set on per-node spans QAR emits when the runtime
+ * dispatches an evaluator node and a `VerdictResult` returns.
+ *
+ *   - `qar.agent.role`            — closed enum from `InlineGraphRole`.
+ *   - `qar.evaluator.verdict`     — `verdict` from the returned `VerdictResult`.
+ *   - `qar.evaluator.confidence`  — `confidence` from the same (if present).
+ *
+ * SDK-side these are exported strings; QAR's `dispatch_evaluator` stamps
+ * them on the matching server-side span. The SDK never sees the verdict
+ * payload directly — it surfaces through QAR's runtime trace.
+ */
+export const QAR_AGENT_ROLE = 'qar.agent.role';
+export const QAR_EVALUATOR_VERDICT = 'qar.evaluator.verdict';
+export const QAR_EVALUATOR_CONFIDENCE = 'qar.evaluator.confidence';
+// ---------------------------------------------------------------------------
+// gen_ai semconv — the SDK contributes the conversation correlation
+// ---------------------------------------------------------------------------
+export const GEN_AI_CONVERSATION_ID = 'gen_ai.conversation.id';
+export const GEN_AI_OPERATION_NAME = 'gen_ai.operation.name';
+/** Sub-agent activation reports `"invoke_agent"`; the spawn-vs-invoke nuance lives on `qar.spawn_protocol`, not by overloading the operation name. */
+export const GEN_AI_OP_INVOKE_AGENT = 'invoke_agent';
+/** Per OTel GenAI semconv: tool execution. */
+export const GEN_AI_OP_EXECUTE_TOOL = 'execute_tool';
+// ---------------------------------------------------------------------------
+// Skipped on the SDK side — server-only knowledge.
+//
+// Each entry pairs the attribute key with a one-line rationale. `SKIPPED_ATTRIBUTES`
+// is the array consumers + the `attributes-skip.test.ts` audit walk; the per-attr
+// reasons live next to the key so a future contributor opening this file in a
+// PR diff sees *why* they're not exported. If you find yourself wanting to set
+// one of these on an SDK span, the right answer is almost always "no — let the
+// server-side span carry it."
+// ---------------------------------------------------------------------------
+/**
+ * Tuple of attribute strings the SDK is intentionally NOT setting on its own
+ * spans. Tests + audits import this; emission code never does.
+ *
+ * Rationale per entry:
+ *   - `qar.tenant_id`            — resolved by QAR via `/platform/v2/users`. SDK never sees the tenant id.
+ *   - `qar.principal_id`         — same: resolved server-side from the bearer token.
+ *   - `qar.deployment_kind`      — server-side concept (`qodo-cloud` vs `self-tenant`); the SDK is identical across both.
+ *   - `qar.skill_version`        — bound at task-start by QAR's skill registry.
+ *   - `qar.skill_state_schema_v` — same: resolved by the server's skill loader.
+ *   - `qar.skill_invocation_id`  — minted by QAR per skill activation.
+ *   - `qar.skill_activation`     — `"agent" | "user" | "always"`; server-side bookkeeping.
+ *   - `gen_ai.provider.name`     — provider chosen by QAR's gateway/router; SDK never sees model details.
+ *   - `gen_ai.request.model`     — same: chosen at dispatch time.
+ *   - `gen_ai.request.temperature`, `gen_ai.request.top_p`, `gen_ai.request.max_tokens` — request params QAR sends to the LLM provider.
+ *   - `gen_ai.response.model`    — model that actually answered (provider may downgrade); only QAR sees it.
+ *   - `gen_ai.response.finish_reason` / `gen_ai.response.finish_reasons` — emitted by the LLM provider span.
+ *   - `gen_ai.usage.input_tokens`, `gen_ai.usage.output_tokens`, `gen_ai.usage.total_tokens` — token accounting attached to the LLM-provider span.
+ *   - `qar.usage.cost_usd`       — cost rollup computed by QAR over the LLM response.
+ *   - `qar.bulletin.topic`, `qar.bulletin.from_agent`, `qar.bulletin.to_agent` — server-emitted on `bulletin.post` envelopes; the SDK forwards as wire payloads, doesn't attach to its own spans.
+ *   - `qar.state.skill`, `qar.state.op`, `qar.state.size_bytes`, `qar.state.schema_version` — server-emitted on `state.update` envelopes; same forwarding rule.
+ *
+ * (Order: server-only identity first (tenant / principal / deployment),
+ *  then skill bookkeeping, then `gen_ai.*` LLM-call detail, then
+ *  per-envelope server-side attrs.)
+ */
+export const SKIPPED_ATTRIBUTES = [
+    'qar.tenant_id',
+    'qar.principal_id',
+    'qar.deployment_kind',
+    'qar.skill_version',
+    'qar.skill_state_schema_v',
+    'qar.skill_invocation_id',
+    'qar.skill_activation',
+    'gen_ai.provider.name',
+    'gen_ai.request.model',
+    'gen_ai.request.temperature',
+    'gen_ai.request.top_p',
+    'gen_ai.request.max_tokens',
+    'gen_ai.response.model',
+    'gen_ai.response.finish_reason',
+    'gen_ai.response.finish_reasons',
+    'gen_ai.usage.input_tokens',
+    'gen_ai.usage.output_tokens',
+    'gen_ai.usage.total_tokens',
+    'qar.usage.cost_usd',
+    'qar.bulletin.topic',
+    'qar.bulletin.from_agent',
+    'qar.bulletin.to_agent',
+    'qar.state.skill',
+    'qar.state.op',
+    'qar.state.size_bytes',
+    'qar.state.schema_version',
+];
+// ---------------------------------------------------------------------------
+// Span names — `qar.client.<kind>` mirroring QAR's `qar.protocol.<kind>` convention
+// ---------------------------------------------------------------------------
+/** Observer-side span name — used by `SdkTracer.onEvent` for the per-task lifecycle it stitches from inbound envelopes. Distinct from the per-public-API `qar.client.task.start`. */
+export const SPAN_TASK_OBSERVED = 'qar.client.task.observed';
+export const SPAN_TASK_START = 'qar.client.task.start';
+export const SPAN_TASK_CONTINUE = 'qar.client.task.continue';
+export const SPAN_TASK_CANCEL = 'qar.client.task.cancel';
+export const SPAN_TASK_RESUBSCRIBE = 'qar.client.task.resubscribe';
+export const SPAN_TOOL_REQUEST = 'qar.client.tool.request';
+export const SPAN_TOOL_RESPOND = 'qar.client.tool.respond';
+/** Span around an inbound `tool.request` → registered handler invocation. Distinct from `tool.respond` (which covers the WS write). */
+export const SPAN_TOOL_HANDLER = 'qar.client.tool.handler';
+export const SPAN_CONNECT = 'qar.client.connect';
+export const SPAN_DISCONNECT = 'qar.client.disconnect';
+export const SPAN_PIPELINE = 'qar.client.pipeline';
+export const SPAN_PIPELINE_STEP = 'qar.client.pipeline.step';
+/** Pipeline child-span attribute — name of the executed step (or gate). */
+export const QAR_PIPELINE_STEP_NAME = 'qar.pipeline.step_name';
+/** Pipeline gate child-span attribute — whether the predicate evaluated truthy. */
+export const QAR_PIPELINE_GATE_PASSED = 'qar.pipeline.gate_passed';
+/** Pipeline root-span attribute — count of errors aggregated under `collect` strategy. */
+export const QAR_PIPELINE_COLLECTED_ERRORS = 'qar.pipeline.collected_errors';
+/** Pipeline root-span attribute — `true` when a gate short-circuited the run. */
+export const QAR_PIPELINE_GATED = 'qar.pipeline.gated';
+/** Constant value the SDK stamps on tool spans so server-side tools are distinguishable. */
+export const TOOL_ORIGIN_SDK_SIDE = 'sdk-side';
+/** Tool-outcome value enums — the SDK reports one of these on every closed tool span. */
+export const TOOL_OUTCOME_SUCCESS = 'success';
+export const TOOL_OUTCOME_ERROR = 'error';
+export const TOOL_OUTCOME_DENIED = 'denied';
+//# sourceMappingURL=attributes.js.map

package/dist/observability/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../src/observability/attributes.ts"],"names":[],"mappings":"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"}

package/dist/observability/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Public re-exports for the SDK 2.0 observability layer.
+ *
+ * Attribute constants are re-exported by name; consumers who need to set their
+ * own `qar.*` attributes (e.g., wrapping a custom tool handler) import from here
+ * rather than reaching into `src/observability/attributes.ts` directly.
+ */
+export { SERVICE_NAME, SERVICE_VERSION, SERVICE_NAMESPACE, SERVICE_NAME_VALUE, SERVICE_NAMESPACE_VALUE, QAR_SESSION_ID, QAR_MESSAGE_ID, QAR_PARENT_MESSAGE_ID, QAR_TASK_ID, QAR_ENVELOPE_KIND, QAR_TOOL_NAME, QAR_TOOL_CALL_ID, QAR_TOOL_ORIGIN, QAR_TOOL_OUTCOME, QAR_NODE_NAME, QAR_SKILL_NAME, QAR_AGENT_ID, QAR_GRAPH_ENTRY, QAR_GRAPH_DEPTH, QAR_AGENT_KIND, QAR_AGENT_ROLE, QAR_EVALUATOR_VERDICT, QAR_EVALUATOR_CONFIDENCE, GEN_AI_CONVERSATION_ID, GEN_AI_OPERATION_NAME, GEN_AI_OP_INVOKE_AGENT, GEN_AI_OP_EXECUTE_TOOL, SKIPPED_ATTRIBUTES, SPAN_TASK_OBSERVED, SPAN_TASK_START, SPAN_TASK_CONTINUE, SPAN_TASK_CANCEL, SPAN_TASK_RESUBSCRIBE, SPAN_TOOL_REQUEST, SPAN_TOOL_RESPOND, SPAN_TOOL_HANDLER, SPAN_CONNECT, SPAN_DISCONNECT, SPAN_PIPELINE, SPAN_PIPELINE_STEP, QAR_PIPELINE_STEP_NAME, QAR_PIPELINE_GATE_PASSED, QAR_PIPELINE_COLLECTED_ERRORS, QAR_PIPELINE_GATED, TOOL_ORIGIN_SDK_SIDE, TOOL_OUTCOME_SUCCESS, TOOL_OUTCOME_ERROR, TOOL_OUTCOME_DENIED, } from './attributes.js';
+export type { SkippedAttribute } from './attributes.js';
+export { TraceContextProvider, formatTraceparent } from './traceContext.js';
+export type { TraceContextValue } from './traceContext.js';
+export { SpanRecorder } from './spans.js';
+export type { SpanLifecycle, ToolHandlerOutcome, TaskSpanContext } from './spans.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,11 @@
+/**
+ * Public re-exports for the SDK 2.0 observability layer.
+ *
+ * Attribute constants are re-exported by name; consumers who need to set their
+ * own `qar.*` attributes (e.g., wrapping a custom tool handler) import from here
+ * rather than reaching into `src/observability/attributes.ts` directly.
+ */
+export { SERVICE_NAME, SERVICE_VERSION, SERVICE_NAMESPACE, SERVICE_NAME_VALUE, SERVICE_NAMESPACE_VALUE, QAR_SESSION_ID, QAR_MESSAGE_ID, QAR_PARENT_MESSAGE_ID, QAR_TASK_ID, QAR_ENVELOPE_KIND, QAR_TOOL_NAME, QAR_TOOL_CALL_ID, QAR_TOOL_ORIGIN, QAR_TOOL_OUTCOME, QAR_NODE_NAME, QAR_SKILL_NAME, QAR_AGENT_ID, QAR_GRAPH_ENTRY, QAR_GRAPH_DEPTH, QAR_AGENT_KIND, QAR_AGENT_ROLE, QAR_EVALUATOR_VERDICT, QAR_EVALUATOR_CONFIDENCE, GEN_AI_CONVERSATION_ID, GEN_AI_OPERATION_NAME, GEN_AI_OP_INVOKE_AGENT, GEN_AI_OP_EXECUTE_TOOL, SKIPPED_ATTRIBUTES, SPAN_TASK_OBSERVED, SPAN_TASK_START, SPAN_TASK_CONTINUE, SPAN_TASK_CANCEL, SPAN_TASK_RESUBSCRIBE, SPAN_TOOL_REQUEST, SPAN_TOOL_RESPOND, SPAN_TOOL_HANDLER, SPAN_CONNECT, SPAN_DISCONNECT, SPAN_PIPELINE, SPAN_PIPELINE_STEP, QAR_PIPELINE_STEP_NAME, QAR_PIPELINE_GATE_PASSED, QAR_PIPELINE_COLLECTED_ERRORS, QAR_PIPELINE_GATED, TOOL_ORIGIN_SDK_SIDE, TOOL_OUTCOME_SUCCESS, TOOL_OUTCOME_ERROR, TOOL_OUTCOME_DENIED, } from './attributes.js';
+export { TraceContextProvider, formatTraceparent } from './traceContext.js';
+export { SpanRecorder } from './spans.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/observability/resolveOTel.browser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser stub for `resolveOTel`. The Node version uses
+ * `createRequire(import.meta.url)` from `node:module` to synchronously probe
+ * for an installed `@opentelemetry/api`. That probe makes no sense in
+ * browser — `node:module` is unavailable, and a browser consumer who wants
+ * OTel passes the API explicitly via `ClientOptions.otel`.
+ *
+ * So this stub: explicit-only. Returns `undefined` when nothing was passed,
+ * which the SDK's emission layer treats as "no-op every span call".
+ */
+import type { OTelAPI } from '../tracing/types.js';
+export declare function resolveOTel(explicit: OTelAPI | undefined): OTelAPI | undefined;
+//# sourceMappingURL=resolveOTel.browser.d.ts.map

package/dist/observability/resolveOTel.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOTel.browser.d.ts","sourceRoot":"","sources":["../../src/observability/resolveOTel.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAE9E"}

package/dist/observability/resolveOTel.browser.js

@@ -0,0 +1,14 @@
+/**
+ * Browser stub for `resolveOTel`. The Node version uses
+ * `createRequire(import.meta.url)` from `node:module` to synchronously probe
+ * for an installed `@opentelemetry/api`. That probe makes no sense in
+ * browser — `node:module` is unavailable, and a browser consumer who wants
+ * OTel passes the API explicitly via `ClientOptions.otel`.
+ *
+ * So this stub: explicit-only. Returns `undefined` when nothing was passed,
+ * which the SDK's emission layer treats as "no-op every span call".
+ */
+export function resolveOTel(explicit) {
+    return explicit;
+}
+//# sourceMappingURL=resolveOTel.browser.js.map

package/dist/observability/resolveOTel.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOTel.browser.js","sourceRoot":"","sources":["../../src/observability/resolveOTel.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,UAAU,WAAW,CAAC,QAA6B;IACvD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/observability/resolveOTel.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Resolve the OTel API the SDK should emit spans against.
+ *
+ * Priority:
+ *   1. Explicit `ClientOptions.otel` — pass it through.
+ *   2. Module already on the dependency graph at construction time —
+ *      `require('@opentelemetry/api')` succeeds when the consumer has it
+ *      installed, returns `undefined` otherwise.
+ *
+ * Resolution is synchronous + best-effort. If `@opentelemetry/api` isn't
+ * installed (it's an OPTIONAL peer), the SDK proceeds with `undefined` and
+ * every span call is a no-op. No warnings, no bundled fallback.
+ *
+ * Why `createRequire` rather than dynamic `import('@opentelemetry/api')`?
+ * Dynamic `import()` is async; widening every call site that wants the OTel
+ * API to be async would push the resolution into the hot path. The peer
+ * module is small and synchronously-loadable; resolving once at construction
+ * is the right tradeoff.
+ */
+import type { OTelAPI } from '../tracing/types.js';
+/**
+ * Resolve an OTel API instance given an explicit override. Returns
+ * `undefined` if neither the override nor a global `@opentelemetry/api` is
+ * available — the SDK's emission layer treats `undefined` as "no-op every
+ * span call".
+ */
+export declare function resolveOTel(explicit: OTelAPI | undefined): OTelAPI | undefined;
+//# sourceMappingURL=resolveOTel.d.ts.map

package/dist/observability/resolveOTel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOTel.d.ts","sourceRoot":"","sources":["../../src/observability/resolveOTel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAa9E"}

package/dist/observability/resolveOTel.js

@@ -0,0 +1,74 @@
+/**
+ * Resolve the OTel API the SDK should emit spans against.
+ *
+ * Priority:
+ *   1. Explicit `ClientOptions.otel` — pass it through.
+ *   2. Module already on the dependency graph at construction time —
+ *      `require('@opentelemetry/api')` succeeds when the consumer has it
+ *      installed, returns `undefined` otherwise.
+ *
+ * Resolution is synchronous + best-effort. If `@opentelemetry/api` isn't
+ * installed (it's an OPTIONAL peer), the SDK proceeds with `undefined` and
+ * every span call is a no-op. No warnings, no bundled fallback.
+ *
+ * Why `createRequire` rather than dynamic `import('@opentelemetry/api')`?
+ * Dynamic `import()` is async; widening every call site that wants the OTel
+ * API to be async would push the resolution into the hot path. The peer
+ * module is small and synchronously-loadable; resolving once at construction
+ * is the right tradeoff.
+ */
+import { createRequire } from 'node:module';
+/**
+ * Resolve an OTel API instance given an explicit override. Returns
+ * `undefined` if neither the override nor a global `@opentelemetry/api` is
+ * available — the SDK's emission layer treats `undefined` as "no-op every
+ * span call".
+ */
+export function resolveOTel(explicit) {
+    if (explicit !== undefined)
+        return explicit;
+    try {
+        // `createRequire` keeps this CJS-style synchronous resolve usable from
+        // the SDK's ESM source; `require` in pure ESM throws.
+        const req = createRequire(import.meta.url);
+        const mod = req('@opentelemetry/api');
+        if (looksLikeOTelAPI(mod))
+            return mod;
+    }
+    catch {
+        // Module not installed (the typical case for SDK consumers without OTel)
+        // — fall through to undefined.
+    }
+    return undefined;
+}
+/**
+ * Duck-type check: a value is `OTelAPI`-shaped when it carries the three
+ * surfaces the SDK touches. Strict enough to reject malformed shims; loose
+ * enough that an `@opentelemetry/api` major-version bump doesn't
+ * false-negative as long as the documented surface is preserved.
+ */
+function looksLikeOTelAPI(x) {
+    if (typeof x !== 'object' || x === null)
+        return false;
+    const obj = x;
+    if (typeof obj.trace !== 'object' || obj.trace === null)
+        return false;
+    if (typeof obj.context !== 'object' || obj.context === null)
+        return false;
+    const traceObj = obj.trace;
+    if (typeof traceObj.getTracer !== 'function')
+        return false;
+    if (typeof traceObj.getActiveSpan !== 'function')
+        return false;
+    if (typeof traceObj.setSpan !== 'function')
+        return false;
+    const ctxObj = obj.context;
+    if (typeof ctxObj.active !== 'function')
+        return false;
+    if (typeof ctxObj.with !== 'function')
+        return false;
+    if (typeof obj.SpanStatusCode !== 'object' || obj.SpanStatusCode === null)
+        return false;
+    return true;
+}
+//# sourceMappingURL=resolveOTel.js.map

package/dist/observability/resolveOTel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOTel.js","sourceRoot":"","sources":["../../src/observability/resolveOTel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAA6B;IACvD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,CAAC;QACH,uEAAuE;QACvE,sDAAsD;QACtD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,oBAAoB,CAAY,CAAC;QACjD,IAAI,gBAAgB,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;QACzE,+BAA+B;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,CAAU;IAClC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,CAA4B,CAAC;IACzC,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1E,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAgC,CAAC;IACtD,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,OAAO,QAAQ,CAAC,aAAa,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/D,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAkC,CAAC;IACtD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/observability/spans.d.ts

@@ -0,0 +1,198 @@
+/**
+ * SDK 2.0 span emission helpers.
+ *
+ * Public-API methods on the client open and close spans through `SpanRecorder`.
+ * The recorder is the single place that knows about the OTel API: when no OTel
+ * is configured, every method returns a no-op `SpanLifecycle` so the call
+ * sites don't branch.
+ *
+ * Span boundaries:
+ *
+ *   - `qar.client.connect`           — wraps `client.connect()` until the WS upgrade resolves.
+ *   - `qar.client.disconnect`        — short-lived; ends when teardown returns.
+ *   - `qar.client.task.start`        — wraps `tasks.start`; ends when the iterator closes.
+ *   - `qar.client.task.continue`     — same shape, distinct name.
+ *   - `qar.client.task.cancel`       — short-lived; ends when `task.done(canceled)` arrives.
+ *   - `qar.client.task.resubscribe`  — wraps `tasks.resubscribe` invocation.
+ *   - `qar.client.tool.respond`      — short-lived; ends when the WS write resolves.
+ *   - `qar.client.tool.handler`      — wraps the inbound `tool.request` → handler invocation.
+ *
+ * Spans inherit from the consumer's currently-active OTel context. Errors
+ * record an exception and set `ERROR` status. Cleanly-terminated spans set
+ * `OK`. Iterator early-termination still records `OK` (cancellation isn't an
+ * error), with an attribute distinguishing terminal vs cancel paths.
+ */
+import { TOOL_OUTCOME_DENIED, TOOL_OUTCOME_ERROR, TOOL_OUTCOME_SUCCESS } from './attributes.js';
+import type { OTelAPI, OTelContext } from '../tracing/types.js';
+/** Tool-handler outcome the SDK reports as a span attribute on `qar.client.tool.handler`. */
+export type ToolHandlerOutcome = typeof TOOL_OUTCOME_SUCCESS | typeof TOOL_OUTCOME_ERROR | typeof TOOL_OUTCOME_DENIED;
+/**
+ * A span's lifecycle handle. Non-recording when no OTel API is configured —
+ * every method is a no-op, so call sites never branch.
+ */
+export interface SpanLifecycle {
+    /** Set an attribute on the underlying span. No-op without OTel. */
+    setAttribute(key: string, value: string | number | boolean): void;
+    /** Close the span with `OK` status. No-op if already closed. */
+    succeed(): void;
+    /** Close the span with `ERROR` status, recording the exception. */
+    fail(err: unknown): void;
+    /**
+     * Run `fn` with this span's context active. Used to chain child operations
+     * (e.g. an outbound `task.continue` from inside a `task.start` span).
+     */
+    withContext<T>(fn: () => T): T;
+    /**
+     * Return the OTel `Context` carrying this span. `undefined` when no OTel —
+     * call sites use this to reattach context to async iterator boundaries.
+     */
+    context(): OTelContext | undefined;
+}
+/**
+ * A live task span's context handle. Threaded through `TaskSubscription` so the
+ * subscription can re-attach the span's context every time it pushes an event
+ * to the consumer's iterator (otherwise the consumer's `for await` resumes
+ * outside the span and child spans would parent against the wrong frame).
+ */
+export interface TaskSpanContext {
+    /** Span lifecycle handle — call sites end / fail this directly. */
+    readonly lifecycle: SpanLifecycle;
+    /** OTel context carrying the span. `undefined` when no OTel. */
+    readonly otelContext: OTelContext | undefined;
+}
+/**
+ * Span emission entry-point. One instance per `QodoClient`. Methods return a
+ * `SpanLifecycle` the call site closes when the operation completes (or fails).
+ *
+ * A `SpanRecorder` constructed with `otel === undefined` returns a single
+ * shared no-op lifecycle for every method. No allocations, no overhead beyond
+ * a method-call dispatch.
+ */
+export declare class SpanRecorder {
+    private readonly otel;
+    private readonly tracer;
+    private readonly statusOk;
+    private readonly statusError;
+    /** Cached resource attrs stamped on every span so Phoenix groups by service. */
+    private readonly resourceAttrs;
+    constructor(otel: OTelAPI | undefined, sdkVersion: string);
+    /** Whether OTel emission is wired (vs no-op). */
+    get isEnabled(): boolean;
+    /**
+     * Open a `qar.client.task.start` span. The caller is responsible for closing
+     * it — typically via the `TaskSubscription` lifecycle wired in `TaskClient`.
+     */
+    startTaskStartSpan(attrs: TaskStartSpanAttrs): TaskSpanContext;
+    /** Open a `qar.client.task.continue` span. */
+    startTaskContinueSpan(attrs: TaskContinueSpanAttrs): TaskSpanContext;
+    /** Open a `qar.client.task.cancel` span. */
+    startTaskCancelSpan(attrs: TaskCancelSpanAttrs): SpanLifecycle;
+    /** Open a `qar.client.task.resubscribe` span. */
+    startTaskResubscribeSpan(attrs: TaskResubscribeSpanAttrs): TaskSpanContext;
+    /**
+     * Open a `qar.client.tool.respond` span — short-lived, ends on WS write.
+     *
+     * Every outbound `tool.response` envelope carries a `node_name` so the
+     * span records it for parallel-graph telemetry routing.
+     */
+    startToolRespondSpan(attrs: ToolRespondSpanAttrs): SpanLifecycle;
+    /**
+     * Open a `qar.client.tool.handler` span around the invocation of a registered
+     * handler for one `ToolCall` from an inbound `tool.request`. Caller updates
+     * `qar.tool_outcome` and closes via `succeed()` / `fail()` based on the
+     * handler's per-call result.
+     *
+     * A parallel-batched `tool.request` carrying N calls opens N sibling
+     * spans (one per call), each tagged with its own
+     * `qar.tool_call_id` and the request's `qar.node_name`. The shared parent
+     * is whatever OTel context was active when the inbound envelope arrived —
+     * typically the task span.
+     */
+    startToolHandlerSpan(attrs: ToolHandlerSpanAttrs): SpanLifecycle;
+    /** Open a `qar.client.connect` span. Ends when the WS upgrade resolves. */
+    startConnectSpan(): SpanLifecycle;
+    /** Open a `qar.client.disconnect` span. */
+    startDisconnectSpan(attrs: DisconnectSpanAttrs): SpanLifecycle;
+    /**
+     * Internal: open a span as a child of the consumer's currently-active
+     * context, attaching attributes + the resource attrs. Returns a
+     * `SpanLifecycle` the caller closes.
+     */
+    private openSpan;
+    /**
+     * Internal: open a span and return both the lifecycle and the OTel context
+     * pinning that span — so a caller (e.g. `TaskSubscription`) can re-attach
+     * the context every time it yields an event to the consumer's iterator.
+     */
+    private openTaskSpan;
+}
+/** Outcome-attribute helper used by `TaskClient`/`ToolClient` call sites. */
+export declare function toolOutcomeFor(outcome: 'success' | 'error' | 'denied'): ToolHandlerOutcome;
+export interface TaskStartSpanAttrs {
+    /**
+     * Optional — `task.start` opens its span BEFORE the server's
+     * `task.started` ack arrives with the derived `session_id`. The span
+     * lifecycle remains correct without the attribute; consumers correlate
+     * via `qar.task_id` (set lazily on first inbound) and `qar.message_id`.
+     * The attribute is stamped onto the span by the subscription's later
+     * `setAttribute` call when admission completes.
+     */
+    readonly sessionId?: string;
+    readonly messageId: string;
+    readonly agentId?: string;
+    readonly skillName?: string;
+    /** Optional `gen_ai.operation.name` value, e.g. `"invoke_agent"`. */
+    readonly operationName?: string;
+    /**
+     * Inline-graph dispatch attrs. Set when the `task.start` payload
+     * is `{ graph, input }`; absent for `{ agent_id }` / `{ agent }` shapes.
+     */
+    readonly graphEntry?: string;
+    /** Longest acyclic path length from `entry`, computed at validate-time. */
+    readonly graphDepth?: number;
+    /**
+     * `"inline"` when the dispatch carries an inline `AgentSpec` or a
+     * graph with any inline-spec node; absent for purely server-static
+     * `agent_id` dispatches.
+     */
+    readonly agentKind?: string;
+}
+export interface TaskContinueSpanAttrs {
+    /** Optional — see {@link TaskStartSpanAttrs.sessionId}. */
+    readonly sessionId?: string;
+    readonly messageId: string;
+    readonly taskId: string;
+}
+export interface TaskCancelSpanAttrs {
+    /** Optional — see {@link TaskStartSpanAttrs.sessionId}. */
+    readonly sessionId?: string;
+    readonly messageId: string;
+    readonly taskId: string;
+}
+export interface TaskResubscribeSpanAttrs {
+    /** Optional — see {@link TaskStartSpanAttrs.sessionId}. */
+    readonly sessionId?: string;
+    readonly messageId: string;
+    readonly taskId: string;
+    readonly sinceMessageId?: string;
+}
+export interface ToolRespondSpanAttrs {
+    /** Optional — see {@link TaskStartSpanAttrs.sessionId}. */
+    readonly sessionId?: string;
+    readonly toolCallId: string;
+    readonly outcome: ToolHandlerOutcome;
+    /** Required `node_name` of the originating `tool.request`. */
+    readonly nodeName: string;
+}
+export interface ToolHandlerSpanAttrs {
+    /** Optional — see {@link TaskStartSpanAttrs.sessionId}. */
+    readonly sessionId?: string;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    /** Required `node_name` of the inbound `tool.request`. */
+    readonly nodeName: string;
+}
+export interface DisconnectSpanAttrs {
+    readonly sessionId?: string;
+}
+//# sourceMappingURL=spans.d.ts.map

package/dist/observability/spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.d.ts","sourceRoot":"","sources":["../../src/observability/spans.ts"],"names":[],"mappings":"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"}