@chatsee/claude-agent-sdk 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,144 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @chatsee/claude-agent-sdk
+
+ChatSee connector for the **Claude Agent SDK** — Anthropic's agent framework,
+the one that powers Claude Code.
+
+```bash
+npm install @chatsee/claude-agent-sdk
+```
+
+```ts
+import { instrumentClaudeAgentSdk } from '@chatsee/claude-agent-sdk';
+
+const chatsee = instrumentClaudeAgentSdk({ agentId: '...', tenantId: '...' });
+
+for await (const message of chatsee.query({ prompt: 'where is my order', options })) {
+  ...
+}
+```
+
+`chatsee-sdk` is installed for you as a dependency. This is the JS twin of the
+Python connector `chatsee-claude-agent-sdk`; the two capture the same fields
+the same way.
+
+## Not the same thing as `@chatsee/anthropic`
+
+| | `@chatsee/anthropic` | this |
+| --- | --- | --- |
+| Package it hooks | `@anthropic-ai/sdk` | `@anthropic-ai/claude-agent-sdk` |
+| Who writes the agent loop | the customer | Anthropic |
+| What we hook | `client.messages.create` | the `query()` message stream |
+
+Use `@chatsee/anthropic` when they call the Messages API and run their own
+tool-use loop. Use this when they call `query()` and let the SDK run it.
+
+## Why a handle rather than a one-liner
+
+There is no client object to patch — the entry point is a module-level
+`query()`. So `instrumentClaudeAgentSdk` returns a handle whose `.query` is a
+drop-in: every message still reaches the caller, unchanged and in order, while
+the turn is assembled alongside and sent when the terminal `result` message
+arrives.
+
+The returned stream is still the SDK's `Query`: `interrupt()`,
+`setPermissionMode()` and the rest are forwarded, so nothing about how the
+agent is driven changes.
+
+The Python connector also replaces `claude_agent_sdk.query` on the module so
+code calling it through the module needs no change. That is not possible in
+JS — module exports are read-only — so the handle is the integration:
+
+```ts
+// before
+import { query } from '@anthropic-ai/claude-agent-sdk';
+for await (const m of query({ prompt, options })) { ... }
+
+// after
+const chatsee = instrumentClaudeAgentSdk({ agentId, tenantId });
+for await (const m of chatsee.query({ prompt, options })) { ... }
+```
+
+## What it captures
+
+Per turn: the prompt, the final answer, the system prompt (`options.systemPrompt`,
+a string or the `append` of a preset), every tool call with its arguments and
+result, and **one model call per model**, with tokens, cached tokens and a real
+dollar cost.
+
+This SDK is the only one that states its own cost (`total_cost_usd`), so that
+figure is passed through rather than estimated. Nothing here invents a price,
+and a turn's cost is never divided across models — a split we made up would
+look like measurement. When the SDK breaks usage down per model (`modelUsage`)
+each model becomes its own call with its own `costUSD`.
+
+Errored turns (`error_max_turns`, `error_during_execution`, ...) are still
+recorded, with the subtype logged as the exception and the assistant's last
+text as the answer.
+
+## Three things this framework does that nothing else does
+
+**The CLI's system prompt is enormous.** Claude Code injects roughly 21k cached
+tokens on every call, so a one-line "hello" costs around $0.027. Those land in
+`cache_read_input_tokens`, not `input_tokens` — both are captured, or the turn
+looks far cheaper than the bill.
+
+**The CLI calls its own tools.** It loads tools on demand and emits a
+`ToolSearch` tool-use alongside the agent's real one. Those are filtered: a
+support agent that never touched a search tool must not show one in its trace.
+
+**Tool names arrive MCP-qualified.** Custom tools reach the model as
+`mcp__<server>__<tool>`. The customer named it `get_order_status`, so the
+prefix is stripped and that is what the screens say.
+
+## JS specifics
+
+* The API message sits under `msg.message`: content blocks and the model are
+  read from `msg.message.content` / `msg.message.model`, tool results from
+  `user` messages' `tool_result` blocks.
+* `permissionMode: 'bypassPermissions'` also needs
+  `allowDangerouslySkipPermissions: true` in JS (Python does not).
+* The SDK peer-requires **zod v4**; custom tools built with `tool()` should
+  import from `zod` v4 (or `zod/v4` on a 3.25+ install).
+* The SDK ships as ES modules. `require()` of it works on Node 20.19+ / 22.12+;
+  on older runtimes the connector falls back to a dynamic `import()`, and the
+  only visible difference is that the first `query()` resolves the module.
+* Streaming-input mode (an async iterable of user messages as `prompt`) is
+  supported: the connector watches the iterable go by to pick up the user
+  text, since the SDK does not echo it back.
+
+## Guarantees
+
+* **Fails open.** A failure inside capture is logged and swallowed.
+* **Never consumes the stream.** Every message is forwarded unchanged, in order.
+* **Idempotent.** Instrumenting twice does not capture twice.
+* **Concurrency-safe.** State is per `query()` call, not per handle, and emits
+  to one tracker are serialised so concurrent queries cannot clobber each other
+  across the tracker's own `await`.
+
+All four are enforced by the contract suite, not just intended.
+
+## Tests
+
+No network, no API key, no CLI subprocess — the SDK is stubbed, ChatSee is not.
+That matters more here than anywhere else: a real turn costs about $0.027, so
+finding a capture bug by running one would be slow and expensive.
+
+```bash
+cd js/connectors/_shared && npm install && npm run build      # the test kit
+cd ../ai_sdk/claude-agent-sdk && npm install && npm test
+```
+
+A live check against real Claude is in `examples/supportAgent.ts`:
+
+```bash
+ANTHROPIC_API_KEY=... CHATSEE_AGENT_ID=... CHATSEE_TENANT_ID=... CHATSEE_ENV=dev \
+  npx tsx examples/supportAgent.ts
+```
+
+## Known gap
+
+Turn-level `duration_ms` comes from the tracker's own wall clock, and all four
+tracker calls are made together once the turn is known to be complete — so it
+reads near zero. The honest latency is on the model call, from the SDK's
+`duration_api_ms`. Fixing it properly means letting `endTurn` accept a measured
+duration, which is a core-SDK change and not this connector's to make.

package/dist/capture.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Reading one Claude Agent SDK turn off its message stream.
+ *
+ * `query()` yields `system` (init) -> `assistant` (text, tool-use and thinking
+ * blocks) -> `user` (tool results) -> a terminal `result` carrying the final
+ * text, usage, cost and session id.
+ *
+ * So a turn is assembled as the stream is consumed and emitted when the
+ * `result` message arrives. Everything here is extraction; nothing builds a
+ * payload, opens a socket or knows a URL.
+ *
+ * Two quirks of this framework, both discovered in the POC and both handled
+ * here rather than left to show up in a customer's analytics:
+ *
+ * - The CLI loads tools on demand and emits its own meta-tool calls alongside
+ *   the agent's real ones. Reporting those would mean a support agent that
+ *   never touched a search tool shows one in its trace.
+ * - Custom tools are exposed over in-process MCP as `mcp__<server>__<tool>`.
+ *   The customer named the tool `get_order_status`, so that is what the
+ *   screens should say.
+ *
+ * Mirrors `chatsee_claude_agent_sdk/_capture.py` in the Python connector. The
+ * one JS-specific difference: the API message sits under `msg.message`, so
+ * content blocks and the model are read from there.
+ */
+import { AssistantLike, ResultLike, UserLike } from './types';
+export declare const FRAMEWORK = "claude-agent-sdk";
+/**
+ * Meta-tools the Claude Code CLI uses for its own bookkeeping. They are not
+ * actions the customer's agent took, so they never reach the tracker.
+ */
+export declare const INTERNAL_TOOLS: ReadonlySet<string>;
+/**
+ * `mcp__support__get_order_status` -> `get_order_status`.
+ *
+ * Custom tools reach the model over in-process MCP, which qualifies the name
+ * with its server. The customer wrote `get_order_status`; reporting the
+ * qualified form would make the same tool look different here than in every
+ * other connector.
+ */
+export declare function cleanToolName(name: unknown): string;
+export declare function isInternalTool(name: unknown): boolean;
+/** A tool result as the SDK hands it over: text blocks, a string, or an object. */
+export declare function toolResultValue(content: unknown): unknown;
+/**
+ * The system prompt, which lives on the caller's options rather than the
+ * stream. It may be a plain string, a string array, a custom object or a
+ * preset object with an append.
+ */
+export declare function systemPromptOf(options: unknown): string | undefined;
+export interface ModelCallEntry {
+    model?: string;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    cached_tokens?: number;
+    cost_usd?: number;
+}
+/**
+ * Token counts off a result message's aggregate `usage` (snake_case, the
+ * Anthropic API shape).
+ *
+ * Reported as the SDK reports them. `input_tokens` / `output_tokens` are the
+ * turn's non-cached tokens; the cache figures are separate, and the CLI's own
+ * ~21k-token system prompt lands in the cache reads rather than the input.
+ */
+export declare function usageCounts(usage: unknown): ModelCallEntry;
+/**
+ * One entry per model the turn used.
+ *
+ * `modelUsage` breaks usage down per model, which is the grain the tracker
+ * wants: a turn that used Haiku for a sub-agent and Sonnet for the answer
+ * should not report one blended number. When it is absent the aggregate
+ * `usage` is the fallback.
+ */
+export declare function modelCallsFrom(result: ResultLike): {
+    entries: ModelCallEntry[];
+    cumulative: boolean;
+};
+/**
+ * Turns the SDK's running totals into one turn's own usage.
+ *
+ * `modelUsage` and `total_cost_usd` are **cumulative for the query() call**:
+ * each result carries the running total so far, not that turn's share. One
+ * turn per call -- a plain string prompt -- makes the two identical, which is
+ * why this is invisible in the common case. A streaming-input session or a
+ * resumed one runs several turns through the same total, and recording it
+ * as-is makes turn three report turns one, two and three. Cost and tokens
+ * then inflate with every turn.
+ *
+ * (The top-level `usage` beside them is already per-turn. It is not
+ * differenced, and must not be.)
+ *
+ * Two cases this deliberately does not pretend to solve:
+ *
+ * - **A session seen for the first time** is recorded as-is, because there is
+ *   nothing to subtract. A *resumed* session's first result already carries
+ *   the turns from before we were watching, so that one turn over-reports.
+ *   Every turn after it is right, which is the best available without the
+ *   transcript.
+ * - **A mid-session `/clear`** resets the SDK's running total. That shows up
+ *   as a total smaller than the one before it, so it is taken as a new
+ *   baseline rather than emitted as a negative.
+ */
+export declare class UsageLedger {
+    private readonly maxSessions;
+    /** Bounded so a long-lived process cannot accumulate sessions forever. */
+    static readonly MAX_SESSIONS = 512;
+    private readonly totals;
+    constructor(maxSessions?: number);
+    private difference;
+    /** Per-model entries from `modelUsage`, differenced. */
+    perTurnModels(sessionId: string | undefined, entries: ModelCallEntry[]): ModelCallEntry[];
+    /**
+     * `total_cost_usd`, differenced. Used on the aggregate path, where the
+     * tokens come from the per-turn `usage` but the cost does not.
+     */
+    perTurnCost(sessionId: string | undefined, totalCostUsd: unknown): number | undefined;
+    get trackedSessions(): number;
+}
+export interface ResolvedToolCall {
+    tool_name: string;
+    arguments: Record<string, unknown>;
+    result: unknown;
+}
+/**
+ * One turn, assembled as its stream is consumed.
+ *
+ * An instance per `query()` call, never shared, so concurrent queries cannot
+ * contaminate each other.
+ */
+export declare class TurnAccumulator {
+    model: string | undefined;
+    private readonly toolCalls;
+    private readonly toolResults;
+    private readonly seenToolIds;
+    private readonly texts;
+    observeAssistant(message: AssistantLike): void;
+    observeUser(message: UserLike): void;
+    /** Tool calls paired with their results, ready for the tracker. */
+    resolvedToolCalls(): ResolvedToolCall[];
+    /** Joined assistant text, for when the result message carries no `result`. */
+    assistantText(): string;
+}
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9D,eAAO,MAAM,SAAS,qBAAqB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAAwC,CAAC;AAIxF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAOnD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAErD;AAeD,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAezD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAoBnE;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAM1D;AAYD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG;IAClD,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;CACrB,CAgBA;AAYD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAW;IASV,OAAO,CAAC,QAAQ,CAAC,WAAW;IARxC,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,YAAY,OAAO;IAEnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGnB;gBAEyB,WAAW,GAAE,MAAiC;IAE3E,OAAO,CAAC,UAAU;IAkDlB,wDAAwD;IACxD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAIzF;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAKrF,IAAI,eAAe,IAAI,MAAM,CAE5B;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB;AAQD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAgC9C,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAUpC,mEAAmE;IACnE,iBAAiB,IAAI,gBAAgB,EAAE;IAQvC,8EAA8E;IAC9E,aAAa,IAAI,MAAM;CAGxB"}

package/dist/capture.js

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurnAccumulator = exports.UsageLedger = exports.INTERNAL_TOOLS = exports.FRAMEWORK = void 0;
+exports.cleanToolName = cleanToolName;
+exports.isInternalTool = isInternalTool;
+exports.toolResultValue = toolResultValue;
+exports.systemPromptOf = systemPromptOf;
+exports.usageCounts = usageCounts;
+exports.modelCallsFrom = modelCallsFrom;
+exports.FRAMEWORK = 'claude-agent-sdk';
+/**
+ * Meta-tools the Claude Code CLI uses for its own bookkeeping. They are not
+ * actions the customer's agent took, so they never reach the tracker.
+ */
+exports.INTERNAL_TOOLS = new Set(['ToolSearch', 'TodoWrite']);
+const MCP_PREFIX = 'mcp__';
+/**
+ * `mcp__support__get_order_status` -> `get_order_status`.
+ *
+ * Custom tools reach the model over in-process MCP, which qualifies the name
+ * with its server. The customer wrote `get_order_status`; reporting the
+ * qualified form would make the same tool look different here than in every
+ * other connector.
+ */
+function cleanToolName(name) {
+    if (typeof name !== 'string')
+        return 'unknown';
+    if (name.startsWith(MCP_PREFIX)) {
+        const parts = name.split('__');
+        if (parts.length >= 3)
+            return parts.slice(2).join('__');
+    }
+    return name;
+}
+function isInternalTool(name) {
+    return typeof name === 'string' && exports.INTERNAL_TOOLS.has(name);
+}
+function field(obj, name) {
+    if (obj === null || obj === undefined || typeof obj !== 'object')
+        return undefined;
+    return obj[name];
+}
+function wholeNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.trunc(value) : undefined;
+}
+function finiteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/** A tool result as the SDK hands it over: text blocks, a string, or an object. */
+function toolResultValue(content) {
+    if (content === null || content === undefined)
+        return content;
+    if (typeof content !== 'object')
+        return content;
+    if (Array.isArray(content)) {
+        const texts = [];
+        for (const block of content) {
+            if (field(block, 'type') === 'text' || field(block, 'text') !== undefined) {
+                const text = field(block, 'text');
+                if (text)
+                    texts.push(String(text));
+            }
+        }
+        if (texts.length > 0)
+            return texts.join('\n');
+        return content.map((b) => (typeof b === 'string' ? b : JSON.stringify(b)));
+    }
+    return content;
+}
+/**
+ * The system prompt, which lives on the caller's options rather than the
+ * stream. It may be a plain string, a string array, a custom object or a
+ * preset object with an append.
+ */
+function systemPromptOf(options) {
+    const prompt = field(options, 'systemPrompt');
+    if (typeof prompt === 'string')
+        return prompt || undefined;
+    if (Array.isArray(prompt)) {
+        const joined = prompt.filter((p) => typeof p === 'string').join('\n');
+        return joined || undefined;
+    }
+    if (prompt !== null && prompt !== undefined) {
+        // Preset form: { type: 'preset', preset: 'claude_code', append?: '...' }
+        const append = field(prompt, 'append');
+        if (typeof append === 'string' && append)
+            return append;
+        // Custom form: { type: 'custom', prompt: '...' | ['...'] }
+        const custom = field(prompt, 'prompt');
+        if (typeof custom === 'string' && custom)
+            return custom;
+        if (Array.isArray(custom)) {
+            const joined = custom.filter((p) => typeof p === 'string').join('\n');
+            return joined || undefined;
+        }
+    }
+    return undefined;
+}
+/**
+ * Token counts off a result message's aggregate `usage` (snake_case, the
+ * Anthropic API shape).
+ *
+ * Reported as the SDK reports them. `input_tokens` / `output_tokens` are the
+ * turn's non-cached tokens; the cache figures are separate, and the CLI's own
+ * ~21k-token system prompt lands in the cache reads rather than the input.
+ */
+function usageCounts(usage) {
+    return {
+        prompt_tokens: wholeNumber(field(usage, 'input_tokens')),
+        completion_tokens: wholeNumber(field(usage, 'output_tokens')),
+        cached_tokens: wholeNumber(field(usage, 'cache_read_input_tokens')),
+    };
+}
+/** Token counts off one `modelUsage` entry (camelCase, the SDK's own shape). */
+function modelUsageCounts(usage) {
+    return {
+        prompt_tokens: wholeNumber(field(usage, 'inputTokens')),
+        completion_tokens: wholeNumber(field(usage, 'outputTokens')),
+        cached_tokens: wholeNumber(field(usage, 'cacheReadInputTokens')),
+        cost_usd: finiteNumber(field(usage, 'costUSD')),
+    };
+}
+/**
+ * One entry per model the turn used.
+ *
+ * `modelUsage` breaks usage down per model, which is the grain the tracker
+ * wants: a turn that used Haiku for a sub-agent and Sonnet for the answer
+ * should not report one blended number. When it is absent the aggregate
+ * `usage` is the fallback.
+ */
+function modelCallsFrom(result) {
+    const perModel = result.modelUsage;
+    if (perModel && typeof perModel === 'object' && !Array.isArray(perModel)) {
+        const models = Object.keys(perModel);
+        if (models.length > 0) {
+            // modelUsage is a running total for the query() call, so the caller has
+            // to difference it against the previous result.
+            return {
+                entries: models.map((model) => ({ ...modelUsageCounts(perModel[model]), model })),
+                cumulative: true,
+            };
+        }
+    }
+    // The top-level usage is already this turn's own. Differencing it would be
+    // wrong, and would quietly zero every turn after the first.
+    return { entries: [usageCounts(result.usage)], cumulative: false };
+}
+/** Fields that arrive as a running total and have to be differenced. */
+const CUMULATIVE_FIELDS = [
+    'prompt_tokens',
+    'completion_tokens',
+    'cached_tokens',
+    'cost_usd',
+];
+/**
+ * Turns the SDK's running totals into one turn's own usage.
+ *
+ * `modelUsage` and `total_cost_usd` are **cumulative for the query() call**:
+ * each result carries the running total so far, not that turn's share. One
+ * turn per call -- a plain string prompt -- makes the two identical, which is
+ * why this is invisible in the common case. A streaming-input session or a
+ * resumed one runs several turns through the same total, and recording it
+ * as-is makes turn three report turns one, two and three. Cost and tokens
+ * then inflate with every turn.
+ *
+ * (The top-level `usage` beside them is already per-turn. It is not
+ * differenced, and must not be.)
+ *
+ * Two cases this deliberately does not pretend to solve:
+ *
+ * - **A session seen for the first time** is recorded as-is, because there is
+ *   nothing to subtract. A *resumed* session's first result already carries
+ *   the turns from before we were watching, so that one turn over-reports.
+ *   Every turn after it is right, which is the best available without the
+ *   transcript.
+ * - **A mid-session `/clear`** resets the SDK's running total. That shows up
+ *   as a total smaller than the one before it, so it is taken as a new
+ *   baseline rather than emitted as a negative.
+ */
+class UsageLedger {
+    constructor(maxSessions = UsageLedger.MAX_SESSIONS) {
+        this.maxSessions = maxSessions;
+        this.totals = new Map();
+    }
+    difference(sessionId, key, current) {
+        var _a;
+        const measured = new Map();
+        for (const field of CUMULATIVE_FIELDS) {
+            const value = current[field];
+            if (typeof value === 'number' && Number.isFinite(value))
+                measured.set(field, value);
+        }
+        if (!sessionId || measured.size === 0)
+            return { ...current };
+        let session = this.totals.get(sessionId);
+        if (!session) {
+            session = new Map();
+            this.totals.set(sessionId, session);
+            while (this.totals.size > this.maxSessions) {
+                const oldest = this.totals.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                this.totals.delete(oldest);
+            }
+        }
+        else {
+            // Keep insertion order meaningful, so eviction drops the least recent.
+            this.totals.delete(sessionId);
+            this.totals.set(sessionId, session);
+        }
+        const previous = session.get(key);
+        const snapshot = {};
+        measured.forEach((value, field) => {
+            snapshot[field] = value;
+        });
+        session.set(key, snapshot);
+        if (!previous)
+            return { ...current };
+        // A total that went backwards means the SDK reset it (/clear, or a fork).
+        // Take the new figure as the baseline rather than reporting a negative.
+        for (const [field, value] of measured) {
+            if (value < ((_a = previous[field]) !== null && _a !== void 0 ? _a : 0))
+                return { ...current };
+        }
+        const out = { ...current };
+        measured.forEach((value, field) => {
+            var _a;
+            const delta = value - ((_a = previous[field]) !== null && _a !== void 0 ? _a : 0);
+            out[field] = field === 'cost_usd' ? delta : Math.round(delta);
+        });
+        return out;
+    }
+    /** Per-model entries from `modelUsage`, differenced. */
+    perTurnModels(sessionId, entries) {
+        return entries.map((entry) => { var _a; return this.difference(sessionId, (_a = entry.model) !== null && _a !== void 0 ? _a : '', entry); });
+    }
+    /**
+     * `total_cost_usd`, differenced. Used on the aggregate path, where the
+     * tokens come from the per-turn `usage` but the cost does not.
+     */
+    perTurnCost(sessionId, totalCostUsd) {
+        if (typeof totalCostUsd !== 'number' || !Number.isFinite(totalCostUsd))
+            return undefined;
+        return this.difference(sessionId, '__total_cost__', { cost_usd: totalCostUsd }).cost_usd;
+    }
+    get trackedSessions() {
+        return this.totals.size;
+    }
+}
+exports.UsageLedger = UsageLedger;
+/** Bounded so a long-lived process cannot accumulate sessions forever. */
+UsageLedger.MAX_SESSIONS = 512;
+/**
+ * One turn, assembled as its stream is consumed.
+ *
+ * An instance per `query()` call, never shared, so concurrent queries cannot
+ * contaminate each other.
+ */
+class TurnAccumulator {
+    constructor() {
+        this.toolCalls = [];
+        this.toolResults = new Map();
+        this.seenToolIds = new Set();
+        this.texts = [];
+    }
+    observeAssistant(message) {
+        const api = message.message;
+        const model = field(api, 'model');
+        if (typeof model === 'string' && model)
+            this.model = model;
+        const content = field(api, 'content');
+        if (!Array.isArray(content))
+            return;
+        for (const block of content) {
+            const type = field(block, 'type');
+            if (type === 'text') {
+                const text = field(block, 'text');
+                if (typeof text === 'string' && text)
+                    this.texts.push(text);
+                continue;
+            }
+            if (type !== 'tool_use' && field(block, 'name') === undefined)
+                continue;
+            const name = field(block, 'name');
+            if (name === undefined || isInternalTool(name))
+                continue;
+            const id = field(block, 'id');
+            if (this.seenToolIds.has(id))
+                continue; // a retried stream must not double-count
+            this.seenToolIds.add(id);
+            const input = field(block, 'input');
+            this.toolCalls.push({
+                id,
+                tool_name: cleanToolName(name),
+                arguments: input !== null && typeof input === 'object' && !Array.isArray(input)
+                    ? input
+                    : {},
+            });
+        }
+    }
+    observeUser(message) {
+        const content = field(message.message, 'content');
+        if (!Array.isArray(content))
+            return;
+        for (const block of content) {
+            const useId = field(block, 'tool_use_id');
+            if (useId === undefined || useId === null)
+                continue;
+            this.toolResults.set(useId, toolResultValue(field(block, 'content')));
+        }
+    }
+    /** Tool calls paired with their results, ready for the tracker. */
+    resolvedToolCalls() {
+        return this.toolCalls.map((call) => ({
+            tool_name: call.tool_name,
+            arguments: call.arguments,
+            result: this.toolResults.get(call.id),
+        }));
+    }
+    /** Joined assistant text, for when the result message carries no `result`. */
+    assistantText() {
+        return this.texts.join('\n');
+    }
+}
+exports.TurnAccumulator = TurnAccumulator;
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":";;;AA6CA,sCAOC;AAED,wCAEC;AAgBD,0CAeC;AAOD,wCAoBC;AAkBD,kCAMC;AAoBD,wCAmBC;AAtJY,QAAA,SAAS,GAAG,kBAAkB,CAAC;AAE5C;;;GAGG;AACU,QAAA,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;AAExF,MAAM,UAAU,GAAG,OAAO,CAAC;AAE3B;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,IAAa;IACzC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,cAAc,CAAC,IAAa;IAC1C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,sBAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,KAAK,CAAC,GAAY,EAAE,IAAY;IACvC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACnF,OAAQ,GAA+B,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7F,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,mFAAmF;AACnF,SAAgB,eAAe,CAAC,OAAgB;IAC9C,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC9D,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAClC,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,OAAgB;IAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,IAAI,SAAS,CAAC;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,MAAM,IAAI,SAAS,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,yEAAyE;QACzE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QACxD,2DAA2D;QAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QACxD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtE,OAAO,MAAM,IAAI,SAAS,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAUD;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO;QACL,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACxD,iBAAiB,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QAC7D,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO;QACL,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACvD,iBAAiB,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAC5D,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;QAChE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,MAAkB;IAI/C,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC;IACnC,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,wEAAwE;YACxE,gDAAgD;YAChD,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBACjF,UAAU,EAAE,IAAI;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,2EAA2E;IAC3E,4DAA4D;IAC5D,OAAO,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACrE,CAAC;AAED,wEAAwE;AACxE,MAAM,iBAAiB,GAAG;IACxB,eAAe;IACf,mBAAmB;IACnB,eAAe;IACf,UAAU;CACF,CAAC;AAIX;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,WAAW;IAStB,YAA6B,cAAsB,WAAW,CAAC,YAAY;QAA9C,gBAAW,GAAX,WAAW,CAAmC;QAL1D,WAAM,GAAG,IAAI,GAAG,EAG9B,CAAC;IAE0E,CAAC;IAEvE,UAAU,CAChB,SAA6B,EAC7B,GAAW,EACX,OAAuB;;QAEvB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QAE7D,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBAC/C,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM;gBAChC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,uEAAuE;YACvE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,QAAQ,GAA6C,EAAE,CAAC;QAC9D,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAChC,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAE3B,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QAErC,0EAA0E;QAC1E,wEAAwE;QACxE,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;YACtC,IAAI,KAAK,GAAG,CAAC,MAAA,QAAQ,CAAC,KAAK,CAAC,mCAAI,CAAC,CAAC;gBAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QAC5D,CAAC;QAED,MAAM,GAAG,GAAmB,EAAE,GAAG,OAAO,EAAE,CAAC;QAC3C,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;;YAChC,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,MAAA,QAAQ,CAAC,KAAK,CAAC,mCAAI,CAAC,CAAC,CAAC;YAC7C,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;IAED,wDAAwD;IACxD,aAAa,CAAC,SAA6B,EAAE,OAAyB;QACpE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,WAAC,OAAA,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAA,KAAK,CAAC,KAAK,mCAAI,EAAE,EAAE,KAAK,CAAC,CAAA,EAAA,CAAC,CAAC;IACtF,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,SAA6B,EAAE,YAAqB;QAC9D,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,SAAS,CAAC;QACzF,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC3F,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;;AA7EH,kCA8EC;AA7EC,0EAA0E;AAC1D,wBAAY,GAAG,GAAG,AAAN,CAAO;AA0FrC;;;;;GAKG;AACH,MAAa,eAAe;IAA5B;QAEmB,cAAS,GAAsB,EAAE,CAAC;QAClC,gBAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC1C,gBAAW,GAAG,IAAI,GAAG,EAAW,CAAC;QACjC,UAAK,GAAa,EAAE,CAAC;IAyDxC,CAAC;IAvDC,gBAAgB,CAAC,OAAsB;QACrC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAE3D,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO;QACpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI;oBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5D,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,SAAS;gBAAE,SAAS;YACxE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzD,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS,CAAC,yCAAyC;YACjF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAClB,EAAE;gBACF,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC;gBAC9B,SAAS,EACP,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBAClE,CAAC,CAAE,KAAiC;oBACpC,CAAC,CAAC,EAAE;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,WAAW,CAAC,OAAiB;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO;QACpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YACpD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,iBAAiB;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SACtC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,8EAA8E;IAC9E,aAAa;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF;AA9DD,0CA8DC"}

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import { QueryFn, TrackerLike } from './types';
+export declare const __version__ = "0.1.0";
+export { FRAMEWORK, INTERNAL_TOOLS, cleanToolName } from './capture';
+export type { QueryFn, QueryLike, QueryParams, TrackerLike } from './types';
+export interface InstrumentOptions {
+    agentId?: string;
+    tenantId?: string;
+    userId?: string;
+    sessionId?: string;
+    apiBaseUrl?: string;
+    /** Private: lets the contract tests inject a fake tracker. */
+    _tracker?: TrackerLike;
+    /** Private: lets the contract tests inject a stub of the SDK's `query()`. */
+    _query?: QueryFn;
+}
+/** Handle returned by {@link instrumentClaudeAgentSdk}. */
+export declare class ChatseeClaudeAgentSdk {
+    private readonly userId?;
+    /**
+     * Emits to one tracker are serialised. `ChatseeTracker` keeps a single turn
+     * in instance fields and clears them only after `endTurn`'s awaited POST,
+     * so two queries emitting concurrently on one handle would clobber each
+     * other across that await. The chain makes the four calls of one turn and
+     * its send happen before the next turn's begin.
+     */
+    private emitChain;
+    /** A drop-in for the SDK's `query()`. */
+    readonly query: QueryFn;
+    private original;
+    constructor(tracker: TrackerLike, original: QueryFn | Promise<QueryFn>, userId?: string | undefined);
+    private readonly tracker;
+    /** Per-session running totals, so cumulative figures become per-turn. */
+    private readonly ledger;
+    private wrap;
+    private metadata;
+    private enqueueEmit;
+    /**
+     * All four tracker calls, together, when the turn is known to be over.
+     *
+     * Emitted in one go rather than opening the turn when the stream starts:
+     * the tracker holds a single turn at a time, so a startTurn left open across
+     * an await would be clobbered by any concurrent query.
+     */
+    private emit;
+}
+/**
+ * Capture every turn the Claude Agent SDK runs.
+ *
+ * `agentId` and `tenantId` say which ChatSee agent the data belongs to, and are
+ * all that is required. `_tracker` and `_query` are private and exist so the
+ * contract tests can inject a fake tracker and a stub SDK. Customers never
+ * pass them.
+ *
+ * Calling this twice does not capture twice: a `_query` that is already a
+ * wrapped query is unwrapped to the original before wrapping again.
+ */
+export declare function instrumentClaudeAgentSdk(options?: InstrumentOptions): ChatseeClaudeAgentSdk;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA8BA,OAAO,EAGL,OAAO,EAIP,WAAW,EAEZ,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAoF5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,2DAA2D;AAC3D,qBAAa,qBAAqB;IAkB9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAjB1B;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,CAAoC;IAErD,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB,OAAO,CAAC,QAAQ,CAA6B;gBAG3C,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACnB,MAAM,CAAC,EAAE,MAAM,YAAA;IASlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAEtC,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAI5C,OAAO,CAAC,IAAI;IA2GZ,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,WAAW;IAanB;;;;;;OAMG;YACW,IAAI;CA2DnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,iBAAsB,GAAG,qBAAqB,CAwB/F"}

package/dist/index.js

@@ -0,0 +1,374 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatseeClaudeAgentSdk = exports.cleanToolName = exports.INTERNAL_TOOLS = exports.FRAMEWORK = exports.__version__ = void 0;
+exports.instrumentClaudeAgentSdk = instrumentClaudeAgentSdk;
+/**
+ * ChatSee connector for the Claude Agent SDK.
+ *
+ *     import { instrumentClaudeAgentSdk } from '@chatsee/claude-agent-sdk';
+ *
+ *     const chatsee = instrumentClaudeAgentSdk({ agentId: '...', tenantId: '...' });
+ *
+ *     for await (const message of chatsee.query({ prompt: 'where is my order', options })) {
+ *       ...
+ *     }
+ *
+ * Unlike the Messages API connector, there is no client object to patch: the
+ * Agent SDK's entry point is a module-level `query()`. So this returns a handle
+ * whose `.query` is a drop-in for it. Every message still reaches the caller,
+ * unchanged and in order, while the turn is assembled alongside and sent when
+ * the terminal `result` message arrives.
+ *
+ * The Python connector also replaces `claude_agent_sdk.query` on the module.
+ * That is not possible here -- ES module and CommonJS exports are read-only --
+ * so the handle is the integration.
+ *
+ * Mirrors `chatsee_claude_agent_sdk/__init__.py` in the Python connector.
+ */
+const capture_1 = require("./capture");
+exports.__version__ = '0.1.0';
+var capture_2 = require("./capture");
+Object.defineProperty(exports, "FRAMEWORK", { enumerable: true, get: function () { return capture_2.FRAMEWORK; } });
+Object.defineProperty(exports, "INTERNAL_TOOLS", { enumerable: true, get: function () { return capture_2.INTERNAL_TOOLS; } });
+Object.defineProperty(exports, "cleanToolName", { enumerable: true, get: function () { return capture_2.cleanToolName; } });
+const SDK_PACKAGE = '@anthropic-ai/claude-agent-sdk';
+/** Tags a wrapped `query` so a second instrument call never wraps it twice. */
+const WRAPPED = Symbol.for('chatsee.claude-agent-sdk.original');
+let cachedFrameworkVersion;
+function frameworkVersion() {
+    if (cachedFrameworkVersion !== undefined)
+        return cachedFrameworkVersion;
+    cachedFrameworkVersion = 'unknown';
+    try {
+        // The SDK's exports map does not expose package.json, so walk up from
+        // its resolved entry point and read the file directly.
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const fs = require('fs');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const path = require('path');
+        let dir = path.dirname(require.resolve(SDK_PACKAGE));
+        for (let i = 0; i < 5; i++) {
+            const candidate = path.join(dir, 'package.json');
+            if (fs.existsSync(candidate)) {
+                const pkg = JSON.parse(fs.readFileSync(candidate, 'utf8'));
+                if ((pkg === null || pkg === void 0 ? void 0 : pkg.name) === SDK_PACKAGE && typeof pkg.version === 'string') {
+                    cachedFrameworkVersion = pkg.version;
+                }
+                break;
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        /* unknown */
+    }
+    return cachedFrameworkVersion;
+}
+function queryOf(sdk) {
+    const query = sdk === null || sdk === void 0 ? void 0 : sdk.query;
+    if (typeof query !== 'function') {
+        throw new Error(`${SDK_PACKAGE} does not export query()`);
+    }
+    return query;
+}
+/**
+ * The SDK's `query()`, resolved on first use rather than at import so the
+ * connector (and its offline tests) load without the SDK installed.
+ *
+ * The SDK ships as ES modules only. `require()` of it works on Node 20.19+
+ * and 22.12+; older runtimes throw ERR_REQUIRE_ESM, and there the load falls
+ * back to a dynamic `import()`, which is why this may return a promise.
+ */
+function loadSdkQuery() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return queryOf(require(SDK_PACKAGE));
+    }
+    catch (error) {
+        if ((error === null || error === void 0 ? void 0 : error.code) !== 'ERR_REQUIRE_ESM')
+            throw error;
+        // A variable specifier keeps TypeScript (CommonJS output) from turning
+        // this into a require().
+        const specifier = SDK_PACKAGE;
+        return Promise.resolve(`${specifier}`).then(s => __importStar(require(s))).then(queryOf);
+    }
+}
+function isResult(message) {
+    return (message === null || message === void 0 ? void 0 : message.type) === 'result';
+}
+function textOf(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter((b) => b && typeof b === 'object' && b.type === 'text')
+        .map((b) => { var _a; return String((_a = b.text) !== null && _a !== void 0 ? _a : ''); })
+        .filter(Boolean)
+        .join('\n');
+}
+/** Handle returned by {@link instrumentClaudeAgentSdk}. */
+class ChatseeClaudeAgentSdk {
+    constructor(tracker, original, userId) {
+        this.userId = userId;
+        /**
+         * Emits to one tracker are serialised. `ChatseeTracker` keeps a single turn
+         * in instance fields and clears them only after `endTurn`'s awaited POST,
+         * so two queries emitting concurrently on one handle would clobber each
+         * other across that await. The chain makes the four calls of one turn and
+         * its send happen before the next turn's begin.
+         */
+        this.emitChain = Promise.resolve();
+        /** Per-session running totals, so cumulative figures become per-turn. */
+        this.ledger = new capture_1.UsageLedger();
+        this.tracker = tracker;
+        this.original = original;
+        const wrapped = (params) => this.wrap(params);
+        wrapped[WRAPPED] = original;
+        this.query = wrapped;
+    }
+    // -- the drop-in ---------------------------------------------------------
+    wrap(params) {
+        // One accumulator per call, never shared, so concurrent queries cannot
+        // contaminate each other.
+        const turn = new capture_1.TurnAccumulator();
+        const prompt = params === null || params === void 0 ? void 0 : params.prompt;
+        let userMessage = typeof prompt === 'string' ? prompt : '';
+        // Streaming-input mode: the prompt is an iterable of user messages. Watch
+        // it go by so the turn still has a user message; the SDK does not echo it.
+        let forwardedParams = params;
+        if (prompt && typeof prompt !== 'string' && typeof prompt[Symbol.asyncIterator] === 'function') {
+            const source = prompt;
+            const watched = {
+                async *[Symbol.asyncIterator]() {
+                    var _a;
+                    for await (const item of source) {
+                        try {
+                            const text = textOf((_a = item === null || item === void 0 ? void 0 : item.message) === null || _a === void 0 ? void 0 : _a.content);
+                            if (text)
+                                userMessage = text;
+                        }
+                        catch {
+                            /* never break the agent */
+                        }
+                        yield item;
+                    }
+                },
+            };
+            forwardedParams = { ...params, prompt: watched };
+        }
+        const handle = this;
+        // Sync when the SDK loaded with require(); a promise when it had to be
+        // import()ed (see loadSdkQuery). The caller sees the same object either
+        // way: iteration awaits the stream, and control methods return promises
+        // in the SDK too, so forwarding them through a promise changes nothing.
+        const query = this.original;
+        const streamOrPromise = typeof query === 'function'
+            ? query(forwardedParams)
+            : query.then((q) => {
+                this.original = q;
+                return q(forwardedParams);
+            });
+        async function* capturing() {
+            const stream = await streamOrPromise;
+            for await (const message of stream) {
+                try {
+                    switch (message === null || message === void 0 ? void 0 : message.type) {
+                        case 'assistant':
+                            turn.observeAssistant(message);
+                            break;
+                        case 'user':
+                            turn.observeUser(message);
+                            break;
+                        default:
+                            if (isResult(message)) {
+                                await handle.enqueueEmit(userMessage, forwardedParams.options, turn, message);
+                            }
+                    }
+                }
+                catch (error) {
+                    // eslint-disable-next-line no-console
+                    console.error(`chatsee-claude-agent-sdk capture failed: ${String(error)}`);
+                }
+                yield message; // forwarded unchanged, in order
+            }
+        }
+        const generator = capturing();
+        // The SDK's Query is an async generator that also carries control methods
+        // (`interrupt()`, `setPermissionMode()`, ...). Iterate through ours and
+        // forward everything else to the original, so the caller loses nothing.
+        const iteration = generator;
+        if (typeof streamOrPromise.then !== 'function') {
+            const stream = streamOrPromise;
+            return new Proxy(stream, {
+                get(target, prop, receiver) {
+                    if (prop === Symbol.asyncIterator)
+                        return () => generator;
+                    if (prop === 'next' || prop === 'return' || prop === 'throw') {
+                        return iteration[prop].bind(generator);
+                    }
+                    const value = Reflect.get(target, prop, receiver);
+                    return typeof value === 'function' ? value.bind(target) : value;
+                },
+            });
+        }
+        const pending = streamOrPromise;
+        return new Proxy({}, {
+            get(_target, prop) {
+                if (prop === Symbol.asyncIterator)
+                    return () => generator;
+                if (prop === 'next' || prop === 'return' || prop === 'throw') {
+                    return iteration[prop].bind(generator);
+                }
+                if (prop === 'then')
+                    return undefined; // not itself a promise
+                return (...args) => pending.then((stream) => {
+                    const value = stream[prop];
+                    return typeof value === 'function' ? value.apply(stream, args) : value;
+                });
+            },
+        });
+    }
+    // -- emitting ------------------------------------------------------------
+    metadata() {
+        return {
+            framework: capture_1.FRAMEWORK,
+            framework_version: frameworkVersion(),
+            connector_version: exports.__version__,
+        };
+    }
+    enqueueEmit(userMessage, options, turn, result) {
+        const run = this.emitChain.then(() => this.emit(userMessage, options, turn, result));
+        // Keep the chain alive past a failed emit; the failure is reported by the
+        // caller's catch, never to the agent.
+        this.emitChain = run.catch(() => undefined);
+        return run;
+    }
+    /**
+     * All four tracker calls, together, when the turn is known to be over.
+     *
+     * Emitted in one go rather than opening the turn when the stream starts:
+     * the tracker holds a single turn at a time, so a startTurn left open across
+     * an await would be clobbered by any concurrent query.
+     */
+    async emit(userMessage, options, turn, result) {
+        var _a;
+        const tracker = this.tracker;
+        const answer = (typeof result.result === 'string' && result.result) ||
+            turn.assistantText() ||
+            (Array.isArray(result.errors) ? result.errors.join('\n') : '');
+        tracker.startTurn(userMessage, this.metadata(), (0, capture_1.systemPromptOf)(options), this.userId);
+        for (const call of turn.resolvedToolCalls()) {
+            tracker.logToolCall(call.tool_name, call.arguments, call.result);
+        }
+        // One entry per model the turn used. The SDK states a real dollar cost,
+        // so it is passed through rather than estimated -- nothing here invents a
+        // price. duration_api_ms is the time actually spent in the API, which is
+        // the honest per-call latency.
+        const apiMs = typeof result.duration_api_ms === 'number' && Number.isFinite(result.duration_api_ms)
+            ? Math.round(result.duration_api_ms)
+            : undefined;
+        // modelUsage and total_cost_usd are running totals for the query() call,
+        // not this turn's share. One turn per call makes them the same number,
+        // which is why it never shows in the ordinary case; a streaming-input or
+        // resumed session runs several turns through one total, and recording it
+        // raw makes turn three report turns one, two and three.
+        const { entries, cumulative } = (0, capture_1.modelCallsFrom)(result);
+        const sessionId = result.session_id;
+        const calls = cumulative ? this.ledger.perTurnModels(sessionId, entries) : entries;
+        const totalCost = cumulative
+            ? undefined // already carried per model
+            : this.ledger.perTurnCost(sessionId, result.total_cost_usd);
+        for (const entry of calls) {
+            tracker.logModelCall({
+                model: (_a = entry.model) !== null && _a !== void 0 ? _a : turn.model,
+                provider: 'anthropic',
+                prompt_tokens: entry.prompt_tokens,
+                completion_tokens: entry.completion_tokens,
+                cached_tokens: entry.cached_tokens,
+                // A per-model cost when the SDK broke it down, otherwise the turn's
+                // cost on the single entry. Never divided up: a split we invented
+                // would look like measurement.
+                cost_usd: entry.cost_usd !== undefined ? entry.cost_usd : calls.length === 1 ? totalCost : undefined,
+                duration_ms: calls.length === 1 ? apiMs : undefined,
+            });
+        }
+        if (result.is_error) {
+            tracker.logException(`claude-agent-sdk reported subtype=${result.subtype}`);
+        }
+        await tracker.endTurn(answer);
+    }
+}
+exports.ChatseeClaudeAgentSdk = ChatseeClaudeAgentSdk;
+/**
+ * Capture every turn the Claude Agent SDK runs.
+ *
+ * `agentId` and `tenantId` say which ChatSee agent the data belongs to, and are
+ * all that is required. `_tracker` and `_query` are private and exist so the
+ * contract tests can inject a fake tracker and a stub SDK. Customers never
+ * pass them.
+ *
+ * Calling this twice does not capture twice: a `_query` that is already a
+ * wrapped query is unwrapped to the original before wrapping again.
+ */
+function instrumentClaudeAgentSdk(options = {}) {
+    var _a;
+    let tracker = options._tracker;
+    if (!tracker) {
+        if (!options.agentId || !options.tenantId) {
+            throw new Error('agentId and tenantId are required.');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { ChatseeTracker } = require('chatsee-sdk');
+        tracker = new ChatseeTracker({
+            agent_id: options.agentId,
+            tenant_id: options.tenantId,
+            user_id: options.userId,
+            session_id: options.sessionId,
+            api_base_url: options.apiBaseUrl,
+        });
+    }
+    let query = (_a = options._query) !== null && _a !== void 0 ? _a : loadSdkQuery();
+    // Instrumenting twice must not wrap twice.
+    while (typeof query === 'function' && query[WRAPPED]) {
+        query = query[WRAPPED];
+    }
+    return new ChatseeClaudeAgentSdk(tracker, query, options.userId);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * The slice of the Claude Agent SDK's message types this connector reads.
+ *
+ * Deliberately structural and deliberately narrow: importing the SDK's own
+ * types would make the connector uncompilable without the SDK installed,
+ * which the offline tests rely on not being the case (the Python connector
+ * identifies `ResultMessage` by shape for the same reason). Field names match
+ * `@anthropic-ai/claude-agent-sdk` exactly, so a real `SDKMessage` satisfies
+ * these without a cast.
+ */
+export interface AssistantLike {
+    type: 'assistant';
+    /** The API message: `content` blocks and `model` live here, not on the top level. */
+    message: unknown;
+    parent_tool_use_id?: string | null;
+}
+export interface UserLike {
+    type: 'user';
+    /** `MessageParam` from the Anthropic SDK: tool results are `content` blocks here. */
+    message: unknown;
+    parent_tool_use_id?: string | null;
+}
+export interface ResultLike {
+    type: 'result';
+    subtype: string;
+    session_id?: string;
+    is_error?: boolean;
+    /** Present on `subtype: 'success'` only. */
+    result?: string;
+    /** Present on the error subtypes only. */
+    errors?: string[];
+    total_cost_usd?: number;
+    duration_ms?: number;
+    duration_api_ms?: number;
+    num_turns?: number;
+    /** Aggregate usage, Anthropic API shape (snake_case). */
+    usage?: unknown;
+    /** Per-model breakdown, SDK shape (camelCase: inputTokens, costUSD, ...). */
+    modelUsage?: Record<string, unknown>;
+}
+/** Any message the stream yields. Everything not listed is forwarded untouched. */
+export type MessageLike = AssistantLike | UserLike | ResultLike | {
+    type: string;
+};
+/** What the SDK's `query()` takes. `options` is passed through untouched. */
+export interface QueryParams {
+    prompt: string | AsyncIterable<unknown>;
+    options?: Record<string, unknown>;
+}
+/**
+ * What the SDK's `query()` returns: an async iterable of messages that also
+ * carries control methods (`interrupt()`, `setPermissionMode()`, ...). The
+ * wrapped stream keeps those reachable.
+ */
+export type QueryLike = AsyncIterable<MessageLike> & Record<string, unknown>;
+export type QueryFn = (params: QueryParams) => QueryLike;
+/** The four tracker calls a connector is allowed to make. */
+export interface TrackerLike {
+    startTurn(userMessage: string, metadata?: Record<string, unknown>, systemPrompt?: string, userId?: string): void;
+    logToolCall(toolName: string, args: Record<string, unknown>, result?: unknown, error?: string, durationMs?: number): void;
+    logModelCall(options: {
+        model?: string;
+        provider?: string;
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        cached_tokens?: number;
+        cost_usd?: number;
+        duration_ms?: number;
+    }): void;
+    logException(exception: Error | string): void;
+    endTurn(botMessage: string, isFinalTurn?: boolean): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,qFAAqF;IACrF,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7E,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAC;AAEzD,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAAC;IACR,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAAC;IACR,YAAY,CAAC,OAAO,EAAE;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI,CAAC;IACT,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE"}

package/dist/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * The slice of the Claude Agent SDK's message types this connector reads.
+ *
+ * Deliberately structural and deliberately narrow: importing the SDK's own
+ * types would make the connector uncompilable without the SDK installed,
+ * which the offline tests rely on not being the case (the Python connector
+ * identifies `ResultMessage` by shape for the same reason). Field names match
+ * `@anthropic-ai/claude-agent-sdk` exactly, so a real `SDKMessage` satisfies
+ * these without a cast.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/package.json

@@ -1,6 +1,37 @@
-{
-  "name": "@chatsee/claude-agent-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@chatsee/claude-agent-sdk",
+  "version": "0.1.0",
+  "description": "ChatSee connector for the Claude Agent SDK — capture every turn with one line.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "test": "jest"
+  },
+  "keywords": ["chatsee", "claude", "claude-agent-sdk", "anthropic", "agent", "monitoring", "tracing"],
+  "author": "ChatSee <contact@chatsee.ai>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "chatsee-sdk": "^2.3.0",
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
+  },
+  "devDependencies": {
+    "@chatsee/connector-testing": "file:../../_shared",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}