@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/trajectory/transcript-parsers/gemini-session.js

@@ -0,0 +1,138 @@
+/**
+ * Gemini CLI session transcript parser.
+ *
+ * Reads `~/.gemini/sessions/<id>.jsonl` (or comparable path) line-by-line,
+ * mapping per-record content to canonical TranscriptEvent shapes (Task 3.1).
+ *
+ * Gemini's content shape follows the GenerativeAI Content schema: each record
+ * has a `role` ('user' or 'model') and a `parts` array. Each part may be:
+ *   - { text: string }                  → user-message / assistant-message
+ *   - { functionCall: { name, args } }  → tool-call
+ *   - { functionResponse: { name, response } } → tool-result
+ *
+ * Multiple parts in a single record can produce multiple events, mirroring
+ * the Claude Code parser's tool_use-block handling. Text parts within the
+ * same model record are concatenated into a single assistant-message; mixing
+ * text and functionCall parts emits both, in order.
+ *
+ * `parseChunk` preserves any incomplete trailing line across calls.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import { readFile } from 'node:fs/promises';
+export class GeminiSessionParser {
+    tool = 'gemini-cli';
+    buffer = '';
+    parseChunk(input) {
+        const text = typeof input.chunk === 'string' ? input.chunk : input.chunk.toString('utf-8');
+        this.buffer += text;
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() ?? '';
+        const events = [];
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            let record;
+            try {
+                record = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            events.push(...this.recordToEvents(record));
+        }
+        return events;
+    }
+    async parseFull(input) {
+        const text = await readFile(input.path, 'utf-8');
+        const normalised = text.endsWith('\n') ? text : text + '\n';
+        const previousBuffer = this.buffer;
+        this.buffer = '';
+        try {
+            return this.parseChunk({ sessionId: input.sessionId, chunk: normalised });
+        }
+        finally {
+            this.buffer = previousBuffer;
+        }
+    }
+    recordToEvents(record) {
+        if (!record || typeof record !== 'object')
+            return [];
+        const ts = record.timestamp ?? record.ts;
+        if (typeof ts !== 'string')
+            return [];
+        if (!Array.isArray(record.parts))
+            return [];
+        const role = record.role;
+        const out = [];
+        for (const part of record.parts) {
+            if (!part || typeof part !== 'object')
+                continue;
+            if (isTextPart(part)) {
+                if (role === 'user') {
+                    out.push({ kind: 'user-message', timestamp: ts, content: part.text });
+                }
+                else if (role === 'model' || role === 'assistant') {
+                    out.push({ kind: 'assistant-message', timestamp: ts, content: part.text });
+                }
+                continue;
+            }
+            if (isFunctionCallPart(part)) {
+                out.push({
+                    kind: 'tool-call',
+                    timestamp: ts,
+                    name: part.functionCall.name,
+                    args: part.functionCall.args ?? {},
+                });
+                continue;
+            }
+            if (isFunctionResponsePart(part)) {
+                const response = part.functionResponse.response;
+                const content = stringifyResponse(response);
+                out.push({
+                    kind: 'tool-result',
+                    timestamp: ts,
+                    name: part.functionResponse.name,
+                    content,
+                    isError: false,
+                });
+                continue;
+            }
+        }
+        return out;
+    }
+}
+function isTextPart(part) {
+    return (typeof part === 'object' &&
+        part !== null &&
+        typeof part.text === 'string');
+}
+function isFunctionCallPart(part) {
+    if (typeof part !== 'object' || part === null)
+        return false;
+    const fc = part.functionCall;
+    return Boolean(fc) && typeof fc.name === 'string';
+}
+function isFunctionResponsePart(part) {
+    if (typeof part !== 'object' || part === null)
+        return false;
+    const fr = part.functionResponse;
+    return Boolean(fr) && typeof fr.name === 'string';
+}
+function stringifyResponse(response) {
+    if (response == null)
+        return '';
+    if (typeof response === 'string')
+        return response;
+    // Gemini wraps tool output as { response: { content: '...' } } commonly;
+    // unwrap a single-string `content` field for readability, otherwise
+    // round-trip the JSON.
+    if (typeof response === 'object' &&
+        !Array.isArray(response) &&
+        'content' in response &&
+        typeof response.content === 'string') {
+        return response.content;
+    }
+    return JSON.stringify(response);
+}
+//# sourceMappingURL=gemini-session.js.map

package/dist/trajectory/transcript-parsers/gemini-session.js.map

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

package/dist/trajectory/transcript-parsers/types.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+export declare const TranscriptEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"user-message">;
+    timestamp: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "user-message";
+    timestamp: string;
+    content: string;
+}, {
+    kind: "user-message";
+    timestamp: string;
+    content: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"assistant-message">;
+    timestamp: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "assistant-message";
+    timestamp: string;
+    content: string;
+}, {
+    kind: "assistant-message";
+    timestamp: string;
+    content: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"tool-call">;
+    timestamp: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    kind: "tool-call";
+    timestamp: string;
+    args: Record<string, unknown>;
+}, {
+    name: string;
+    kind: "tool-call";
+    timestamp: string;
+    args: Record<string, unknown>;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"tool-result">;
+    timestamp: z.ZodString;
+    name: z.ZodString;
+    content: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    kind: "tool-result";
+    timestamp: string;
+    content: string;
+    isError?: boolean | undefined;
+}, {
+    name: string;
+    kind: "tool-result";
+    timestamp: string;
+    content: string;
+    isError?: boolean | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"edit">;
+    timestamp: z.ZodString;
+    path: z.ZodString;
+    diff: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    kind: "edit";
+    timestamp: string;
+    diff: string;
+}, {
+    path: string;
+    kind: "edit";
+    timestamp: string;
+    diff: string;
+}>]>;
+export type TranscriptEvent = z.infer<typeof TranscriptEventSchema>;
+/**
+ * Per-tool transcript parser. Each implementation reads the native disk format
+ * for one tool (Claude Code JSONL, Cursor SQLite, Aider history, etc.) and
+ * normalises into the canonical TranscriptEvent shape so the synthetic-span
+ * builder (Task 3.2) can produce uniform OTel spans regardless of source.
+ */
+export interface TranscriptParser {
+    /** Tool identity. Used by the synthetic-span builder to brand `service.name`. */
+    readonly tool: 'claude-code' | 'codex' | 'gemini-cli' | 'cursor' | 'aider' | 'continue';
+    /**
+     * Incremental parser. Called when the watcher observes new bytes appended
+     * to the transcript file. Returns events drained since the last call.
+     */
+    parseChunk(input: {
+        sessionId: string;
+        chunk: Buffer | string;
+    }): TranscriptEvent[];
+    /**
+     * One-shot parser for a complete transcript file. Used by the
+     * `jinn capture import` CLI and as the path-D safety-net ingest at session end.
+     */
+    parseFull(input: {
+        sessionId: string;
+        path: string;
+    }): Promise<TranscriptEvent[]>;
+}

package/dist/trajectory/transcript-parsers/types.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export const TranscriptEventSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('user-message'),
+        timestamp: z.string().datetime(),
+        content: z.string(),
+    }),
+    z.object({
+        kind: z.literal('assistant-message'),
+        timestamp: z.string().datetime(),
+        content: z.string(),
+    }),
+    z.object({
+        kind: z.literal('tool-call'),
+        timestamp: z.string().datetime(),
+        name: z.string(),
+        args: z.record(z.unknown()),
+    }),
+    z.object({
+        kind: z.literal('tool-result'),
+        timestamp: z.string().datetime(),
+        name: z.string(),
+        content: z.string(),
+        isError: z.boolean().optional(),
+    }),
+    z.object({
+        kind: z.literal('edit'),
+        timestamp: z.string().datetime(),
+        path: z.string(),
+        diff: z.string(),
+    }),
+]);
+//# sourceMappingURL=types.js.map

package/dist/trajectory/transcript-parsers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/trajectory/transcript-parsers/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAChE,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;KAC5B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;QAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;CACH,CAAC,CAAC"}

package/dist/trajectory/transcript-watcher.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Transcript watcher dispatcher.
+ *
+ * Watches operator-supplied transcript files via chokidar; on append, reads
+ * only the new bytes (tail-from-end semantics) and dispatches through the
+ * matching per-tool parser into the canonical DispatchEnvelope shape:
+ *   { tool, sessionId, event }
+ *
+ * Composes the path-B end-to-end capture flow:
+ *
+ *   fs change → watcher → per-tool parser → TranscriptEvent[]
+ *             → synthetic-span builder (Task 3.2) → OTel receiver
+ *             → processors → pending_captures
+ *
+ * The operator wires `onEvent` to `emitSyntheticSpan(provider, envelope)` so
+ * capture-bound spans flow into the receiver+processor pipeline.
+ *
+ * ## Tail-from-end semantics
+ *
+ * On `startTranscriptWatcher`, each source's current file size is recorded
+ * as the read offset. Only bytes appended *after* the watcher starts are
+ * dispatched. This is important so re-launching the daemon does not re-emit
+ * every previously-seen transcript record. (The `jinn capture import` CLI
+ * uses `parser.parseFull` for one-shot history ingest.)
+ *
+ * ## Cursor SQLite quirk — fail loudly
+ *
+ * The Cursor parser's `parseChunk` is a no-op: SQLite isn't streaming, and
+ * watching the `.vscdb` file via chokidar would miss WAL deltas. Polling-
+ * based Cursor support is a Phase 3.5+ follow-up. To avoid silently dropping
+ * Cursor data, this watcher throws at startup if any source has
+ * `tool === 'cursor'`. Operators should run `jinn capture import` for Cursor
+ * sessions until polling support lands.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import type { TranscriptEvent } from './transcript-parsers/types.js';
+export type WatchedTool = 'claude-code' | 'codex' | 'gemini-cli' | 'cursor' | 'aider' | 'continue';
+export interface WatchedSource {
+    /** Identity of the source tool — selects the parser. */
+    tool: WatchedTool;
+    /** Absolute path to the transcript file. */
+    path: string;
+    /**
+     * Operator-assigned session id. Carried through to the dispatched
+     * envelope and ultimately into the synthetic span as `session.id`.
+     */
+    sessionId: string;
+}
+export interface DispatchEnvelope {
+    tool: WatchedTool;
+    sessionId: string;
+    event: TranscriptEvent;
+}
+export interface TranscriptWatcherConfig {
+    sources: WatchedSource[];
+    onEvent: (envelope: DispatchEnvelope) => void;
+}
+export interface TranscriptWatcher {
+    shutdown(): Promise<void>;
+}
+export declare function startTranscriptWatcher(cfg: TranscriptWatcherConfig): Promise<TranscriptWatcher>;

package/dist/trajectory/transcript-watcher.js

@@ -0,0 +1,157 @@
+/**
+ * Transcript watcher dispatcher.
+ *
+ * Watches operator-supplied transcript files via chokidar; on append, reads
+ * only the new bytes (tail-from-end semantics) and dispatches through the
+ * matching per-tool parser into the canonical DispatchEnvelope shape:
+ *   { tool, sessionId, event }
+ *
+ * Composes the path-B end-to-end capture flow:
+ *
+ *   fs change → watcher → per-tool parser → TranscriptEvent[]
+ *             → synthetic-span builder (Task 3.2) → OTel receiver
+ *             → processors → pending_captures
+ *
+ * The operator wires `onEvent` to `emitSyntheticSpan(provider, envelope)` so
+ * capture-bound spans flow into the receiver+processor pipeline.
+ *
+ * ## Tail-from-end semantics
+ *
+ * On `startTranscriptWatcher`, each source's current file size is recorded
+ * as the read offset. Only bytes appended *after* the watcher starts are
+ * dispatched. This is important so re-launching the daemon does not re-emit
+ * every previously-seen transcript record. (The `jinn capture import` CLI
+ * uses `parser.parseFull` for one-shot history ingest.)
+ *
+ * ## Cursor SQLite quirk — fail loudly
+ *
+ * The Cursor parser's `parseChunk` is a no-op: SQLite isn't streaming, and
+ * watching the `.vscdb` file via chokidar would miss WAL deltas. Polling-
+ * based Cursor support is a Phase 3.5+ follow-up. To avoid silently dropping
+ * Cursor data, this watcher throws at startup if any source has
+ * `tool === 'cursor'`. Operators should run `jinn capture import` for Cursor
+ * sessions until polling support lands.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import * as fs from 'node:fs/promises';
+import chokidar from 'chokidar';
+import { ClaudeCodeJsonlParser } from './transcript-parsers/claude-code-jsonl.js';
+import { CodexSessionParser } from './transcript-parsers/codex-session.js';
+import { GeminiSessionParser } from './transcript-parsers/gemini-session.js';
+import { AiderHistoryParser } from './transcript-parsers/aider-history.js';
+import { ContinueDevDataParser } from './transcript-parsers/continue-devdata.js';
+function makeParser(tool) {
+    switch (tool) {
+        case 'claude-code':
+            return new ClaudeCodeJsonlParser();
+        case 'codex':
+            return new CodexSessionParser();
+        case 'gemini-cli':
+            return new GeminiSessionParser();
+        case 'aider':
+            return new AiderHistoryParser();
+        case 'continue':
+            return new ContinueDevDataParser();
+        case 'cursor':
+            // See file header. Cursor streaming via chokidar would silently miss
+            // WAL deltas; the parser's parseChunk is a deliberate no-op. Polling-
+            // based Cursor support is a Phase 3.5+ follow-up; until then operators
+            // should use `jinn capture import` for Cursor sessions.
+            throw new Error("Cursor SQLite watching not yet supported in v0 — use 'jinn capture import' " +
+                'for Cursor sessions or wait for polling support (Phase 3.5+).');
+        default: {
+            const exhaustive = tool;
+            throw new Error(`No parser for tool: ${String(exhaustive)}`);
+        }
+    }
+}
+export async function startTranscriptWatcher(cfg) {
+    const states = new Map();
+    for (const source of cfg.sources) {
+        // Construct the parser first so a Cursor source fails loudly *before* we
+        // open any chokidar handles.
+        const parser = makeParser(source.tool);
+        let nextOffset = 0;
+        try {
+            const stats = await fs.stat(source.path);
+            nextOffset = stats.size;
+        }
+        catch {
+            // File doesn't exist yet — start at offset 0; chokidar will fire `add`
+            // when it appears.
+            nextOffset = 0;
+        }
+        states.set(source.path, { source, parser, nextOffset, inFlight: Promise.resolve() });
+    }
+    let shuttingDown = false;
+    const watcher = chokidar.watch(cfg.sources.map((s) => s.path), {
+        persistent: true,
+        // Wait for writers to settle before reading; cheap insurance against
+        // half-written JSONL lines.
+        awaitWriteFinish: { stabilityThreshold: 50, pollInterval: 25 },
+        // Tail-from-end: on startup, current contents are the baseline. Only
+        // mutations *after* startup should dispatch.
+        ignoreInitial: true,
+    });
+    const enqueue = (filepath) => {
+        if (shuttingDown)
+            return;
+        const state = states.get(filepath);
+        if (!state)
+            return;
+        state.inFlight = state.inFlight.then(() => handleChange(state));
+    };
+    watcher.on('add', enqueue);
+    watcher.on('change', enqueue);
+    async function handleChange(state) {
+        if (shuttingDown)
+            return;
+        let size;
+        try {
+            const stats = await fs.stat(state.source.path);
+            size = stats.size;
+        }
+        catch {
+            return;
+        }
+        // Truncation or stale event — skip. (We deliberately do not reset
+        // nextOffset on truncation; if the file is rotated we'd need explicit
+        // operator intervention. Phase 3.5+ may add inode-change detection.)
+        if (size <= state.nextOffset)
+            return;
+        const handle = await fs.open(state.source.path, 'r');
+        try {
+            const length = size - state.nextOffset;
+            const buf = Buffer.alloc(length);
+            await handle.read({ buffer: buf, position: state.nextOffset, length });
+            state.nextOffset = size;
+            const events = state.parser.parseChunk({
+                sessionId: state.source.sessionId,
+                chunk: buf,
+            });
+            if (shuttingDown)
+                return;
+            for (const event of events) {
+                cfg.onEvent({
+                    tool: state.source.tool,
+                    sessionId: state.source.sessionId,
+                    event,
+                });
+            }
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    return {
+        async shutdown() {
+            shuttingDown = true;
+            await watcher.close();
+            // Drain any in-flight per-source handlers so post-shutdown the map is
+            // settled. Errors here are intentionally swallowed — we're tearing down.
+            await Promise.allSettled(Array.from(states.values(), (state) => state.inFlight));
+        },
+    };
+}
+//# sourceMappingURL=transcript-watcher.js.map

package/dist/trajectory/transcript-watcher.js.map

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

package/dist/trajectory/wrappers/http.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Traced HTTP client wrapper.
+ *
+ * Emits one span per call. spanKind controls attribute profile:
+ *   - jinn.llm_call → gen_ai.* attributes from OTel GenAI semconv
+ *   - jinn.venue_io → net.peer.name + http.* attributes
+ *
+ * Collector scrubs secret headers automatically (Authorization, etc.).
+ * On throw: span records ERROR status with message; error is re-raised.
+ */
+import type { TrajectoryCollector } from '../collector.js';
+export interface HttpRequestLike {
+    url: string;
+    method: string;
+    headers?: Record<string, string>;
+}
+export interface HttpResponseLike {
+    status: number;
+    body?: unknown;
+}
+export interface GenAiAttrs {
+    system: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface TracedHttpCallParams {
+    collector: TrajectoryCollector;
+    spanKind: 'jinn.llm_call' | 'jinn.venue_io';
+    req: HttpRequestLike;
+    invoke: () => Promise<HttpResponseLike>;
+    genAi?: GenAiAttrs;
+    parentSpanId?: string;
+    /** Human-readable span name. Defaults to `${method} ${url.host}`. */
+    name?: string;
+}
+export declare function tracedHttpCall(p: TracedHttpCallParams): Promise<HttpResponseLike>;

package/dist/trajectory/wrappers/http.js

@@ -0,0 +1,85 @@
+/**
+ * Traced HTTP client wrapper.
+ *
+ * Emits one span per call. spanKind controls attribute profile:
+ *   - jinn.llm_call → gen_ai.* attributes from OTel GenAI semconv
+ *   - jinn.venue_io → net.peer.name + http.* attributes
+ *
+ * Collector scrubs secret headers automatically (Authorization, etc.).
+ * On throw: span records ERROR status with message; error is re-raised.
+ */
+function nowNanos() {
+    return `${BigInt(Date.now()) * 1000000n}`;
+}
+function hostOf(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+}
+export async function tracedHttpCall(p) {
+    const start = nowNanos();
+    const name = p.name ?? `${p.req.method} ${hostOf(p.req.url)}`;
+    const baseAttrs = {
+        'jinn.span.kind': p.spanKind,
+        'net.peer.name': hostOf(p.req.url),
+        'http.request.method': p.req.method,
+        'url.full': p.req.url,
+    };
+    if (p.req.headers) {
+        for (const [k, v] of Object.entries(p.req.headers)) {
+            baseAttrs[`http.request.header.${k.toLowerCase()}`] = v;
+        }
+    }
+    if (p.spanKind === 'jinn.llm_call' && p.genAi) {
+        baseAttrs['gen_ai.system'] = p.genAi.system;
+        baseAttrs['gen_ai.request.model'] = p.genAi.model;
+        baseAttrs['gen_ai.usage.input_tokens'] = p.genAi.inputTokens;
+        baseAttrs['gen_ai.usage.output_tokens'] = p.genAi.outputTokens;
+    }
+    try {
+        const res = await p.invoke();
+        const end = nowNanos();
+        p.collector.addSpan({
+            name,
+            kind: 'CLIENT',
+            startTimeUnixNano: start,
+            endTimeUnixNano: end,
+            attributes: {
+                ...baseAttrs,
+                'http.response.status_code': res.status,
+            },
+            events: [],
+            status: { code: res.status >= 400 ? 'ERROR' : 'OK' },
+            parentSpanId: p.parentSpanId,
+        });
+        return res;
+    }
+    catch (err) {
+        const end = nowNanos();
+        p.collector.addSpan({
+            name,
+            kind: 'CLIENT',
+            startTimeUnixNano: start,
+            endTimeUnixNano: end,
+            attributes: {
+                ...baseAttrs,
+                // Provide a stub status so jinn.venue_io profile requirement is met.
+                'http.response.status_code': 0,
+            },
+            events: [
+                {
+                    timeUnixNano: end,
+                    name: 'exception',
+                    attributes: { 'exception.message': err.message },
+                },
+            ],
+            status: { code: 'ERROR', message: err.message },
+            parentSpanId: p.parentSpanId,
+        });
+        throw err;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/trajectory/wrappers/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/trajectory/wrappers/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiCH,SAAS,QAAQ;IACf,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,QAAU,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,MAAM,CAAC,GAAW;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,CAAuB;IAEvB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9D,MAAM,SAAS,GAA4B;QACzC,gBAAgB,EAAE,CAAC,CAAC,QAAQ;QAC5B,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QAClC,qBAAqB,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM;QACnC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG;KACtB,CAAC;IACF,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,SAAS,CAAC,uBAAuB,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,KAAK,eAAe,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC9C,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5C,SAAS,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAClD,SAAS,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;QAC7D,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IACjE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;QACvB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YAClB,IAAI;YACJ,IAAI,EAAE,QAAQ;YACd,iBAAiB,EAAE,KAAK;YACxB,eAAe,EAAE,GAAG;YACpB,UAAU,EAAE;gBACV,GAAG,SAAS;gBACZ,2BAA2B,EAAE,GAAG,CAAC,MAAM;aACxC;YACD,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE;YACpD,YAAY,EAAE,CAAC,CAAC,YAAY;SAC7B,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;QACvB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YAClB,IAAI;YACJ,IAAI,EAAE,QAAQ;YACd,iBAAiB,EAAE,KAAK;YACxB,eAAe,EAAE,GAAG;YACpB,UAAU,EAAE;gBACV,GAAG,SAAS;gBACZ,qEAAqE;gBACrE,2BAA2B,EAAE,CAAC;aAC/B;YACD,MAAM,EAAE;gBACN;oBACE,YAAY,EAAE,GAAG;oBACjB,IAAI,EAAE,WAAW;oBACjB,UAAU,EAAE,EAAE,mBAAmB,EAAG,GAAa,CAAC,OAAO,EAAE;iBAC5D;aACF;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE;YAC1D,YAAY,EAAE,CAAC,CAAC,YAAY;SAC7B,CAAC,CAAC;QACH,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/trajectory/wrappers/mcp.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Traced MCP tool-call wrapper.
+ *
+ * Every MCP tool invocation emits one jinn.mcp_call span. Top-level args
+ * are surfaced as mcp.tool.args.<name> attributes (collector scrubs secret
+ * names). Nested arg redaction is Plan F tightening.
+ */
+import type { TrajectoryCollector } from '../collector.js';
+export interface TracedMcpCallParams<T> {
+    collector: TrajectoryCollector;
+    server: string;
+    tool: string;
+    args: Record<string, unknown>;
+    invoke: () => Promise<T>;
+    parentSpanId?: string;
+}
+export declare function tracedMcpCall<T>(p: TracedMcpCallParams<T>): Promise<T>;