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

package/dist/trajectory/synthetic-span-builder.js

@@ -0,0 +1,115 @@
+/**
+ * Synthetic span builder — bridges canonical TranscriptEvents (Task 3.1)
+ * into OTel spans landing in the embedded receiver (Task 1.1).
+ *
+ * Path B (transcript-tail) traversal: a per-tool parser observes new bytes
+ * appended to a transcript file, normalises into TranscriptEvent, and feeds
+ * each event through this module. The result is a span emitted via OTLP/HTTP
+ * to the embedded receiver, which dispatches it through the same processor
+ * stack as path-A native OTel spans (identity-scrub, path-scrub,
+ * credential-scrub, manifest-builder, sqlite-exporter). That uniformity is
+ * the whole point — by the time scrubbing + persistence run, path provenance
+ * has been erased.
+ *
+ * Per-session traceId stability is provided via a session-root span: the
+ * first event for a sessionId starts a long-lived "session" span; every
+ * subsequent event for that session is emitted as a child within the
+ * session's active context. Child spans inherit the session's traceId. The
+ * session-root span is held open for the life of the provider; the watcher
+ * dispatcher (Task 3.9) will own end-of-session lifecycle later.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import { trace, context as otelContext, SpanKind, } from '@opentelemetry/api';
+import { BasicTracerProvider, BatchSpanProcessor, } from '@opentelemetry/sdk-trace-base';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+// ---------------------------------------------------------------------------
+// Provider lifecycle
+// ---------------------------------------------------------------------------
+export function startSyntheticSpanProvider(cfg = {}) {
+    const exporter = new OTLPTraceExporter(cfg.otlpHttpEndpoint ? { url: cfg.otlpHttpEndpoint } : {});
+    const processor = new BatchSpanProcessor(exporter, {
+        // Tight bounds: synthetic spans should land in the receiver fast so the
+        // flush() awaitable in tests is honest about what's been exported.
+        scheduledDelayMillis: 50,
+    });
+    const provider = new BasicTracerProvider({
+        spanProcessors: [processor],
+    });
+    const tracer = provider.getTracer('jinn-synthetic-spans');
+    const sessionRoots = new Map();
+    return {
+        tracer,
+        sessionRoots,
+        async flush() {
+            await processor.forceFlush();
+        },
+        async shutdown() {
+            // End every session-root span so we don't leak open spans on the
+            // exporter side. The watcher dispatcher will own session-end semantics
+            // proper (Phase 6 / Task 3.9); on provider shutdown we just close them.
+            for (const root of sessionRoots.values()) {
+                root.end();
+            }
+            sessionRoots.clear();
+            await provider.shutdown();
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Emission
+// ---------------------------------------------------------------------------
+function getOrCreateSessionRoot(provider, sessionId, tool) {
+    let root = provider.sessionRoots.get(sessionId);
+    if (!root) {
+        root = provider.tracer.startSpan('session', { kind: SpanKind.INTERNAL });
+        root.setAttribute('jinn.session.id', sessionId);
+        root.setAttribute('transcript.tool', tool);
+        provider.sessionRoots.set(sessionId, root);
+    }
+    return root;
+}
+export function emitSyntheticSpan(provider, input) {
+    const root = getOrCreateSessionRoot(provider, input.sessionId, input.tool);
+    // Pass the session-root span as the explicit parent context. Avoids
+    // depending on a globally-registered ContextManager (BasicTracerProvider
+    // does not auto-register one); the third arg of `Tracer.startSpan` is the
+    // parent context, and `trace.setSpan(ctx, root)` injects the root as the
+    // parent so the new span inherits its traceId.
+    const parentCtx = trace.setSpan(otelContext.active(), root);
+    const span = provider.tracer.startSpan(input.event.kind, { kind: SpanKind.INTERNAL }, parentCtx);
+    // Universal attributes — every synthetic span carries these so processors
+    // (sqlite-exporter routes on jinn.session.id, manifest-builder keys on
+    // transcript.tool) can operate without sniffing event-kind specifics.
+    span.setAttribute('jinn.session.id', input.sessionId);
+    span.setAttribute('transcript.tool', input.tool);
+    // Event-kind-specific attributes. Switch is exhaustive over the
+    // TranscriptEvent discriminated union; adding a new kind in types.ts will
+    // surface as a TS exhaustiveness error here.
+    switch (input.event.kind) {
+        case 'user-message':
+        case 'assistant-message':
+            span.setAttribute('message.content', input.event.content);
+            break;
+        case 'tool-call':
+            span.setAttribute('tool.name', input.event.name);
+            span.setAttribute('tool.args', JSON.stringify(input.event.args));
+            break;
+        case 'tool-result':
+            span.setAttribute('tool.name', input.event.name);
+            span.setAttribute('tool.result', input.event.content);
+            span.setAttribute('tool.result.is_error', input.event.isError ?? false);
+            break;
+        case 'edit':
+            span.setAttribute('edit.path', input.event.path);
+            span.setAttribute('edit.diff', input.event.diff);
+            break;
+        default: {
+            // Exhaustiveness guard — TS will complain if a new kind is added.
+            const _exhaustive = input.event;
+            void _exhaustive;
+        }
+    }
+    span.end();
+}
+//# sourceMappingURL=synthetic-span-builder.js.map

package/dist/trajectory/synthetic-span-builder.js.map

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

package/dist/trajectory/transcript-parsers/aider-history.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Aider history parser.
+ *
+ * Aider records two transcript flavours:
+ *
+ *   1. `.aider.analytics.log.jsonl` (preferred; emitted when --analytics-log
+ *      is enabled). One JSON record per line. Common events:
+ *        - { event: 'message_send', role: 'user', content }   → user-message
+ *        - { event: 'model_response', role: 'assistant', content } → assistant-message
+ *        - { event: 'edit', path, diff }                      → edit
+ *
+ *   2. `.aider.chat.history.md` (fallback; always emitted by Aider). A
+ *      timestamped markdown log:
+ *        # 2026-05-07 00:00:00 +0000
+ *
+ *        > user message
+ *
+ *        assistant reply text
+ *
+ * The parser dispatches on file extension: `.jsonl` → analytics path; `.md`
+ * (or anything else) → markdown path. Both produce canonical TranscriptEvents.
+ *
+ * For the JSONL path, `parseChunk` follows the streaming pattern (preserves
+ * any incomplete trailing line). For the markdown path, `parseChunk` is a
+ * no-op — markdown is not line-stable, so the watcher polls and replays
+ * `parseFull`.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import type { TranscriptEvent, TranscriptParser } from './types.js';
+export declare class AiderHistoryParser implements TranscriptParser {
+    readonly tool: "aider";
+    private buffer;
+    parseChunk(input: {
+        sessionId: string;
+        chunk: Buffer | string;
+    }): TranscriptEvent[];
+    parseFull(input: {
+        sessionId: string;
+        path: string;
+    }): Promise<TranscriptEvent[]>;
+}

package/dist/trajectory/transcript-parsers/aider-history.js

@@ -0,0 +1,182 @@
+/**
+ * Aider history parser.
+ *
+ * Aider records two transcript flavours:
+ *
+ *   1. `.aider.analytics.log.jsonl` (preferred; emitted when --analytics-log
+ *      is enabled). One JSON record per line. Common events:
+ *        - { event: 'message_send', role: 'user', content }   → user-message
+ *        - { event: 'model_response', role: 'assistant', content } → assistant-message
+ *        - { event: 'edit', path, diff }                      → edit
+ *
+ *   2. `.aider.chat.history.md` (fallback; always emitted by Aider). A
+ *      timestamped markdown log:
+ *        # 2026-05-07 00:00:00 +0000
+ *
+ *        > user message
+ *
+ *        assistant reply text
+ *
+ * The parser dispatches on file extension: `.jsonl` → analytics path; `.md`
+ * (or anything else) → markdown path. Both produce canonical TranscriptEvents.
+ *
+ * For the JSONL path, `parseChunk` follows the streaming pattern (preserves
+ * any incomplete trailing line). For the markdown path, `parseChunk` is a
+ * no-op — markdown is not line-stable, so the watcher polls and replays
+ * `parseFull`.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import { readFile } from 'node:fs/promises';
+export class AiderHistoryParser {
+    tool = 'aider';
+    buffer = '';
+    parseChunk(input) {
+        // parseChunk is the streaming-friendly path; only meaningful for the
+        // JSONL analytics format. Callers wiring the markdown fallback through
+        // a watcher poll the file and re-run parseFull.
+        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;
+            }
+            const event = analyticsRecordToEvent(record);
+            if (event)
+                events.push(event);
+        }
+        return events;
+    }
+    async parseFull(input) {
+        const lower = input.path.toLowerCase();
+        if (lower.endsWith('.jsonl')) {
+            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;
+            }
+        }
+        // Markdown fallback (.md or otherwise).
+        const text = await readFile(input.path, 'utf-8');
+        return parseMarkdownHistory(text);
+    }
+}
+function analyticsRecordToEvent(record) {
+    if (!record || typeof record !== 'object')
+        return null;
+    const ts = record.ts ?? record.timestamp;
+    if (typeof ts !== 'string')
+        return null;
+    const event = record.event;
+    if (event === 'message_send' || record.role === 'user') {
+        if (typeof record.content !== 'string')
+            return null;
+        return { kind: 'user-message', timestamp: ts, content: record.content };
+    }
+    if (event === 'model_response' || record.role === 'assistant') {
+        if (typeof record.content !== 'string')
+            return null;
+        return { kind: 'assistant-message', timestamp: ts, content: record.content };
+    }
+    if (event === 'edit') {
+        if (typeof record.path !== 'string' || typeof record.diff !== 'string')
+            return null;
+        return { kind: 'edit', timestamp: ts, path: record.path, diff: record.diff };
+    }
+    return null;
+}
+/**
+ * Best-effort markdown chat-history parser. The format is human-friendly and
+ * not designed for round-tripping; we split on date headings (`# YYYY-MM-DD ...`)
+ * and within each block treat lines starting with `> ` as user messages and
+ * the remaining non-empty text as the assistant reply.
+ */
+function parseMarkdownHistory(text) {
+    const events = [];
+    const lines = text.split('\n');
+    let currentTs = null;
+    let userBuf = [];
+    let assistantBuf = [];
+    let mode = 'idle';
+    const flush = () => {
+        if (!currentTs) {
+            userBuf = [];
+            assistantBuf = [];
+            mode = 'idle';
+            return;
+        }
+        if (userBuf.length > 0) {
+            const content = userBuf.join('\n').trim();
+            if (content) {
+                events.push({ kind: 'user-message', timestamp: currentTs, content });
+            }
+        }
+        if (assistantBuf.length > 0) {
+            const content = assistantBuf.join('\n').trim();
+            if (content) {
+                events.push({ kind: 'assistant-message', timestamp: currentTs, content });
+            }
+        }
+        userBuf = [];
+        assistantBuf = [];
+        mode = 'idle';
+    };
+    for (const line of lines) {
+        const headingMatch = /^#\s+(\d{4}-\d{2}-\d{2})\s+(\d{2}:\d{2}:\d{2})/.exec(line);
+        if (headingMatch) {
+            flush();
+            // Normalise to ISO 8601 UTC. The header includes a tz offset which we
+            // drop here for v0; downstream ingest only needs a parseable timestamp.
+            currentTs = `${headingMatch[1]}T${headingMatch[2]}.000Z`;
+            continue;
+        }
+        if (line.startsWith('> ')) {
+            // Switch into user-message mode. If we were previously in assistant
+            // mode, flush the assistant buffer as the previous turn's reply.
+            if (mode === 'assistant') {
+                if (currentTs) {
+                    const content = assistantBuf.join('\n').trim();
+                    if (content) {
+                        events.push({ kind: 'assistant-message', timestamp: currentTs, content });
+                    }
+                }
+                assistantBuf = [];
+            }
+            mode = 'user';
+            userBuf.push(line.slice(2));
+            continue;
+        }
+        if (line.startsWith('>')) {
+            // Continuation of a user message ("> ").
+            if (mode === 'user')
+                userBuf.push(line.slice(1));
+            continue;
+        }
+        if (mode === 'user' && line.trim() === '') {
+            // Blank line ends the user block; assistant text (if any) follows.
+            mode = 'assistant';
+            continue;
+        }
+        if (mode === 'assistant' || (mode === 'idle' && currentTs && line.trim() !== '')) {
+            mode = 'assistant';
+            assistantBuf.push(line);
+        }
+    }
+    flush();
+    return events;
+}
+//# sourceMappingURL=aider-history.js.map

package/dist/trajectory/transcript-parsers/aider-history.js.map

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

package/dist/trajectory/transcript-parsers/claude-code-jsonl.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Claude Code JSONL transcript parser.
+ *
+ * Reads `~/.claude/projects/<project>/<session-id>.jsonl` line-by-line, mapping
+ * per-record content to canonical TranscriptEvent shapes (Task 3.1):
+ *  - user record with string content              → user-message
+ *  - user record with tool_result content blocks  → tool-result
+ *  - assistant record with text content blocks    → assistant-message
+ *  - assistant record with tool_use content blocks → tool-call
+ *
+ * `parseChunk` preserves any incomplete trailing line across calls so the
+ * watcher (Task 3.9) can stream tail bytes without losing partial records.
+ * `parseFull` is a one-shot for `jinn capture import` and end-of-session
+ * safety-net ingest.
+ *
+ * Known v0 limitation: `tool-result.name` is filled from `tool_use_id` (the
+ * reference back to the originating call) rather than the actual tool name —
+ * resolving the name requires remembering each `tool_use` block's name across
+ * the stream. A follow-up will add that resolution map; for now, downstream
+ * consumers see a stable identifier even if it carries less display signal.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import type { TranscriptEvent, TranscriptParser } from './types.js';
+export declare class ClaudeCodeJsonlParser implements TranscriptParser {
+    readonly tool: "claude-code";
+    private buffer;
+    parseChunk(input: {
+        sessionId: string;
+        chunk: Buffer | string;
+    }): TranscriptEvent[];
+    parseFull(input: {
+        sessionId: string;
+        path: string;
+    }): Promise<TranscriptEvent[]>;
+    private recordToEvents;
+}

package/dist/trajectory/transcript-parsers/claude-code-jsonl.js

@@ -0,0 +1,143 @@
+/**
+ * Claude Code JSONL transcript parser.
+ *
+ * Reads `~/.claude/projects/<project>/<session-id>.jsonl` line-by-line, mapping
+ * per-record content to canonical TranscriptEvent shapes (Task 3.1):
+ *  - user record with string content              → user-message
+ *  - user record with tool_result content blocks  → tool-result
+ *  - assistant record with text content blocks    → assistant-message
+ *  - assistant record with tool_use content blocks → tool-call
+ *
+ * `parseChunk` preserves any incomplete trailing line across calls so the
+ * watcher (Task 3.9) can stream tail bytes without losing partial records.
+ * `parseFull` is a one-shot for `jinn capture import` and end-of-session
+ * safety-net ingest.
+ *
+ * Known v0 limitation: `tool-result.name` is filled from `tool_use_id` (the
+ * reference back to the originating call) rather than the actual tool name —
+ * resolving the name requires remembering each `tool_use` block's name across
+ * the stream. A follow-up will add that resolution map; for now, downstream
+ * consumers see a stable identifier even if it carries less display signal.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import { readFile } from 'node:fs/promises';
+export class ClaudeCodeJsonlParser {
+    tool = 'claude-code';
+    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');
+        // Last fragment (no trailing newline) is preserved for the next chunk.
+        this.buffer = lines.pop() ?? '';
+        const events = [];
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            let record;
+            try {
+                record = JSON.parse(line);
+            }
+            catch {
+                // Malformed line — skip silently. The watcher cannot recover bytes
+                // we drop, but a single corrupt line should not poison the stream.
+                continue;
+            }
+            events.push(...this.recordToEvents(record));
+        }
+        return events;
+    }
+    async parseFull(input) {
+        const text = await readFile(input.path, 'utf-8');
+        // Ensure the final record has a terminating newline so parseChunk drains it.
+        const normalised = text.endsWith('\n') ? text : text + '\n';
+        // parseFull is a one-shot. Use a fresh parser-like state to avoid leaking
+        // the buffer if a caller reuses the same instance for streaming + full.
+        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.timestamp !== 'string')
+            return [];
+        const ts = record.timestamp;
+        if (record.type === 'user') {
+            const content = record.message?.content;
+            // String content is the canonical user message shape.
+            if (typeof content === 'string') {
+                return [{ kind: 'user-message', timestamp: ts, content }];
+            }
+            // Array content typically carries tool_result blocks (Claude Code emits
+            // tool responses inside a synthetic user turn). Other block types in a
+            // user-array record are skipped.
+            if (Array.isArray(content)) {
+                const out = [];
+                for (const block of content) {
+                    if (isToolResultBlock(block)) {
+                        const resultText = typeof block.content === 'string'
+                            ? block.content
+                            : JSON.stringify(block.content);
+                        out.push({
+                            kind: 'tool-result',
+                            timestamp: ts,
+                            // v0: use the reference id as `name`. Resolution-map upgrade
+                            // pending — see file header.
+                            name: block.tool_use_id,
+                            content: resultText,
+                            isError: block.is_error ?? false,
+                        });
+                    }
+                }
+                return out;
+            }
+            return [];
+        }
+        if (record.type === 'assistant') {
+            const content = record.message?.content;
+            const blocks = Array.isArray(content)
+                ? content
+                : typeof content === 'string'
+                    ? [{ type: 'text', text: content }]
+                    : [];
+            const out = [];
+            for (const block of blocks) {
+                if (isTextBlock(block)) {
+                    out.push({ kind: 'assistant-message', timestamp: ts, content: block.text });
+                }
+                else if (isToolUseBlock(block)) {
+                    out.push({
+                        kind: 'tool-call',
+                        timestamp: ts,
+                        name: block.name,
+                        args: block.input ?? {},
+                    });
+                }
+                // `thinking` and any other unrecognised block types are intentionally
+                // dropped — the canonical TranscriptEvent shape doesn't carry them and
+                // including them would violate downstream identity-scrub assumptions.
+            }
+            return out;
+        }
+        // Records with unknown `type` (e.g. queue-operation, summary) are dropped.
+        return [];
+    }
+}
+function isTextBlock(block) {
+    return block.type === 'text' && typeof block.text === 'string';
+}
+function isToolUseBlock(block) {
+    return (block.type === 'tool_use' &&
+        typeof block.name === 'string' &&
+        typeof block.id === 'string');
+}
+function isToolResultBlock(block) {
+    return (block.type === 'tool_result' &&
+        typeof block.tool_use_id === 'string');
+}
+//# sourceMappingURL=claude-code-jsonl.js.map

package/dist/trajectory/transcript-parsers/claude-code-jsonl.js.map

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

package/dist/trajectory/transcript-parsers/codex-session.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Codex CLI session transcript parser.
+ *
+ * Reads `~/.codex/sessions/<id>.jsonl` line-by-line, mapping per-record content
+ * to canonical TranscriptEvent shapes (Task 3.1):
+ *  - role: 'user' with string content       → user-message
+ *  - role: 'assistant' with string content  → assistant-message
+ *  - role: 'function' with function_call    → tool-call (also: assistant with
+ *    a top-level function_call field)
+ *  - role: 'tool' with content               → tool-result
+ *
+ * `parseChunk` preserves any incomplete trailing line across calls so the
+ * watcher (Task 3.9) can stream tail bytes without losing partial records.
+ *
+ * Codex CLI versions vary in their on-disk shape; this parser follows a
+ * defensible best-effort: timestamps are read from `ts` (or `timestamp`),
+ * function-call arguments are JSON-decoded best-effort, and tool-results
+ * carry the call's `name` (or `tool_call_id` as a fallback) so downstream
+ * consumers always see a stable identifier even if it is opaque.
+ *
+ * Spec: spec/2026-05-07-telemetry-collector-and-task-generator.md §4.2 path B.
+ */
+import type { TranscriptEvent, TranscriptParser } from './types.js';
+export declare class CodexSessionParser implements TranscriptParser {
+    readonly tool: "codex";
+    private buffer;
+    parseChunk(input: {
+        sessionId: string;
+        chunk: Buffer | string;
+    }): TranscriptEvent[];
+    parseFull(input: {
+        sessionId: string;
+        path: string;
+    }): Promise<TranscriptEvent[]>;
+    private recordToEvents;
+}