@inbrowser/agent 0.0.0-placeholder → 0.1.0

package/dist/llm-adapter.js

@@ -0,0 +1,132 @@
+/**
+ * Adapter from the playground's existing `LlmProvider` shape to the
+ * core `LlmClient` interface. Lets new core code (AgentSession,
+ * AgentStrategy) consume providers via the narrow event-stream
+ * surface without each provider needing a refactor.
+ *
+ * The existing `LlmProvider` is callback-based (`onText`,
+ * `onToolCall`, etc.) and lives in the React host alongside its
+ * BYOK forms + localStorage wiring. This file flips it into the
+ * `AsyncIterable<ChatEvent>` shape the core wants.
+ *
+ * Each provider can later migrate to natively implement `LlmClient`
+ * to drop this adapter. The plan calls this "slice 4 — one
+ * provider at a time"; the adapter exists so slice 4 doesn't have
+ * to land atomically.
+ */
+/**
+ * Wrap a legacy `LlmProvider` instance in the `LlmClient` shape.
+ * The adapter:
+ *
+ *   - Translates `ChatRequest` → legacy `chatWithTools` / `ask`
+ *     call.
+ *   - Buffers callback events into an async queue and replays them
+ *     as a `ChatEvent` `AsyncIterable`.
+ *   - Forwards the final usage + details as a `turn_complete`
+ *     event before closing the stream.
+ */
+export function legacyProviderAsLlmClient(legacy, id) {
+    return {
+        id,
+        supportsTools: legacy.supportsTools ?? typeof legacy.chatWithTools === 'function',
+        chat(req, signal) {
+            return drive(legacy, req, signal);
+        },
+    };
+}
+async function* drive(legacy, req, signal) {
+    const queue = [];
+    let resolver = null;
+    let done = false;
+    function push(ev) {
+        queue.push(ev);
+        resolver?.();
+        resolver = null;
+    }
+    function finish() {
+        done = true;
+        resolver?.();
+        resolver = null;
+    }
+    const callbacks = {
+        onText: (chunk) => push({ kind: 'text', chunk }),
+        onThinking: (chunk) => push({ kind: 'thinking', chunk }),
+        onToolCall: (call) => push({
+            kind: 'tool_call',
+            id: call.callId,
+            name: call.name,
+            args: call.args,
+            signature: call.signature,
+        }),
+        signal,
+    };
+    const messagesLegacy = req.messages.map((m) => ({
+        role: m.role,
+        text: m.text,
+        ...(m.toolCalls ? { toolCalls: m.toolCalls } : {}),
+        ...(m.callId ? { callId: m.callId } : {}),
+        ...(m.name ? { name: m.name } : {}),
+        ...(m.resultJson !== undefined ? { resultJson: m.resultJson } : {}),
+    }));
+    const toolsLegacy = req.tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        parameters: t.parameters,
+    }));
+    let result;
+    let error;
+    const driver = (async () => {
+        try {
+            if (req.toolUseEnabled && legacy.chatWithTools) {
+                result = await legacy.chatWithTools(messagesLegacy, toolsLegacy, callbacks);
+            }
+            else {
+                // Plain-chat path — flatten messages into a single prompt.
+                const prompt = messagesLegacy
+                    .filter((m) => m.role === 'user' || m.role === 'system')
+                    .map((m) => m.text ?? '')
+                    .filter(Boolean)
+                    .join('\n\n');
+                result = await legacy.ask(prompt, callbacks.onText, { signal });
+            }
+        }
+        catch (e) {
+            error = e;
+        }
+        finally {
+            finish();
+        }
+    })();
+    while (!done || queue.length > 0) {
+        if (queue.length === 0) {
+            await new Promise((r) => {
+                resolver = r;
+            });
+        }
+        const next = queue.shift();
+        if (next)
+            yield next;
+    }
+    await driver;
+    if (error) {
+        yield { kind: 'error', message: error instanceof Error ? error.message : String(error) };
+        return;
+    }
+    if (result) {
+        const rawUsage = {
+            promptTokens: result.usage?.promptTokens ?? 0,
+            completionTokens: result.usage?.outputTokens ?? 0,
+            cachedTokens: result.usage?.cachedTokens,
+            reasoningTokens: result.usage?.reasoningTokens,
+            ...(typeof result.usage?.costUsd === 'number' ? { costUsd: result.usage.costUsd } : {}),
+        };
+        const details = {
+            requestedModel: result.details?.requestedModel ?? '',
+            ...(result.details?.servedModel ? { servedModel: result.details.servedModel } : {}),
+            ...(result.details?.fingerprint ? { fingerprint: result.details.fingerprint } : {}),
+            ...(result.details?.routing ? { routing: result.details.routing } : {}),
+        };
+        yield { kind: 'turn_complete', usage: rawUsage, details };
+    }
+}
+//# sourceMappingURL=llm-adapter.js.map

package/dist/llm-adapter.js.map

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

package/dist/mcp/serve.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Inverse-mode MCP serve adapter — exposes a set of `AgentDefinition`s
+ * as stdio MCP tools an external host (Claude Code, Claude Desktop,
+ * Cursor, ...) can call.
+ *
+ * Wire model: each `AgentDefinition.tools[i]` becomes one MCP tool
+ * registered under its own behavior-name verbatim. The host LLM matches
+ * user intent against `description`; nothing about the `AgentDefinition`
+ * itself surfaces. (Developers see definitions; LLMs see tools.)
+ *
+ * The transport is stdio. This module deliberately writes nothing to
+ * stdout — the MCP transport owns that file descriptor. Startup logs
+ * and per-call traces go to stderr.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { EventLog } from '../events/log-core.js';
+import { type RunLog } from '../metrics/runs.js';
+import type { AgentDefinition, AgentTool } from '../types/agent.js';
+import type { ProjectContext } from '../types/project-context.js';
+export interface ServeAgentsOptions {
+    agents: AgentDefinition[];
+    /** Firebase project id — routes event log + runs log paths. */
+    projectId: string;
+    /** Override `~/.pyric/projects` for tests. */
+    eventsDir?: string;
+    /** Override the runs log directory. Defaults to `eventsDir`. */
+    runsDir?: string;
+    /** Server identity advertised in the MCP handshake. */
+    serverName?: string;
+    serverVersion?: string;
+    /** Injectable clock. */
+    now?: () => number;
+    /** Stream for diagnostic messages. Defaults to process.stderr. */
+    stderr?: NodeJS.WriteStream;
+    /**
+     * Initialized `ProjectContext`. Pass through to every
+     * `AgentContext` so tools that need live project access (e.g.
+     * `audit_firestore_backend` in `projectId` mode) can use it.
+     * The caller is responsible for initialization — usually via
+     * `toProjectContext(await initializeAgentApp())` after reading
+     * FIREBASE_SA_BASE64.
+     */
+    agentApp?: ProjectContext;
+}
+export interface ServeAgentsHandle {
+    /** Close the event/run logs and the MCP server. */
+    close(): Promise<void>;
+}
+/**
+ * Build a stdio MCP server exposing the given agents' tools. Connects
+ * immediately and resolves once the transport is wired. The returned
+ * handle lets tests shut down cleanly; in production the process
+ * terminates with the parent (Claude Code, etc.).
+ */
+export declare function serveAgentsOverStdio(opts: ServeAgentsOptions): Promise<ServeAgentsHandle>;
+/**
+ * Lower-level entrypoint — builds the MCP server + logs without
+ * connecting to a transport. Used by tests to drive request handlers
+ * directly without spawning a stdio transport.
+ */
+export declare function buildServer(opts: ServeAgentsOptions): {
+    server: Server;
+    eventLog: EventLog;
+    runLog: RunLog;
+    toolsByName: Map<string, {
+        agent: AgentDefinition;
+        tool: AgentTool;
+    }>;
+};
+//# sourceMappingURL=serve.d.ts.map

package/dist/mcp/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/mcp/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,KAAK,MAAM,EAA6C,MAAM,oBAAoB,CAAC;AAC5F,OAAO,KAAK,EAAgB,eAAe,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiB/F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;CACvE,CAwHA"}

package/dist/mcp/serve.js

@@ -0,0 +1,154 @@
+/**
+ * Inverse-mode MCP serve adapter — exposes a set of `AgentDefinition`s
+ * as stdio MCP tools an external host (Claude Code, Claude Desktop,
+ * Cursor, ...) can call.
+ *
+ * Wire model: each `AgentDefinition.tools[i]` becomes one MCP tool
+ * registered under its own behavior-name verbatim. The host LLM matches
+ * user intent against `description`; nothing about the `AgentDefinition`
+ * itself surfaces. (Developers see definitions; LLMs see tools.)
+ *
+ * The transport is stdio. This module deliberately writes nothing to
+ * stdout — the MCP transport owns that file descriptor. Startup logs
+ * and per-call traces go to stderr.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { openEventLog } from '../events/log.js';
+import { generateRunId, openRunLog } from '../metrics/runs.js';
+/**
+ * Build a stdio MCP server exposing the given agents' tools. Connects
+ * immediately and resolves once the transport is wired. The returned
+ * handle lets tests shut down cleanly; in production the process
+ * terminates with the parent (Claude Code, etc.).
+ */
+export async function serveAgentsOverStdio(opts) {
+    const { server, eventLog, runLog } = buildServer(opts);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    writeStderr(opts.stderr, `[pyric/agents] mcp server up · project=${opts.projectId} · agents=${opts.agents
+        .map((a) => a.name)
+        .join(',')}\n`);
+    return {
+        async close() {
+            await server.close();
+            runLog.close();
+            eventLog.close();
+        },
+    };
+}
+/**
+ * Lower-level entrypoint — builds the MCP server + logs without
+ * connecting to a transport. Used by tests to drive request handlers
+ * directly without spawning a stdio transport.
+ */
+export function buildServer(opts) {
+    if (opts.agents.length === 0) {
+        throw new Error('serveAgentsOverStdio: at least one AgentDefinition is required');
+    }
+    const eventLog = openEventLog({
+        projectId: opts.projectId,
+        logDir: opts.eventsDir,
+        now: opts.now,
+    });
+    const runLog = openRunLog({
+        projectId: opts.projectId,
+        logDir: opts.runsDir ?? opts.eventsDir,
+        now: opts.now,
+    });
+    const toolsByName = new Map();
+    for (const agent of opts.agents) {
+        for (const tool of agent.tools) {
+            if (toolsByName.has(tool.name)) {
+                throw new Error(`serveAgentsOverStdio: duplicate tool name "${tool.name}" across agents (registered by ${toolsByName.get(tool.name).agent.name} and ${agent.name})`);
+            }
+            toolsByName.set(tool.name, { agent, tool });
+        }
+    }
+    const server = new Server({
+        name: opts.serverName ?? 'pyric-agents',
+        version: opts.serverVersion ?? '0.0.0',
+    }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: Array.from(toolsByName.values()).map(({ tool }) => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: args } = req.params;
+        const entry = toolsByName.get(name);
+        if (!entry) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ ok: false, summary: `unknown tool: ${name}` }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const runId = generateRunId(opts.now);
+        const ts = new Date((opts.now ?? Date.now)()).toISOString();
+        const startedAt = (opts.now ?? Date.now)();
+        const ctx = {
+            runId,
+            projectId: opts.projectId,
+            events: eventLog,
+            signal: new AbortController().signal,
+            now: opts.now,
+            ...(opts.agentApp ? { agentApp: opts.agentApp } : {}),
+        };
+        let outcome = 'ok';
+        let errorSummary;
+        let planHash;
+        let eventIds = [];
+        let payload;
+        try {
+            const result = await entry.tool.execute(args ?? {}, ctx);
+            outcome = result.ok ? 'ok' : 'failed';
+            planHash = result.planHash;
+            eventIds = result.eventIds ?? [];
+            payload = result;
+            if (!result.ok)
+                errorSummary = result.summary;
+        }
+        catch (err) {
+            outcome = 'failed';
+            errorSummary = err instanceof Error ? err.message : String(err);
+            payload = { ok: false, summary: errorSummary, eventIds: [] };
+        }
+        const record = {
+            runId,
+            ts,
+            agent: entry.agent.name,
+            tool: entry.tool.name,
+            mode: 'inverse',
+            outcome,
+            durationMs: Math.max(0, (opts.now ?? Date.now)() - startedAt),
+            ...(planHash ? { planHash } : {}),
+            eventIds,
+            ...(errorSummary ? { errorSummary } : {}),
+        };
+        runLog.append(record);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(payload),
+                },
+            ],
+            ...(outcome === 'failed' ? { isError: true } : {}),
+        };
+    });
+    return { server, eventLog, runLog, toolsByName };
+}
+function writeStderr(stream, msg) {
+    (stream ?? process.stderr).write(msg);
+}
+//# sourceMappingURL=serve.js.map

package/dist/mcp/serve.js.map

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

package/dist/metrics/runs.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Per-call run record — `~/.pyric/projects/<projectId>/runs.ndjson`.
+ *
+ * Distinct from `events.ndjson` (mutation audit) and
+ * `<sessionId>.ndjson` (per-session event stream). Runs is a single,
+ * project-scoped, append-only NDJSON file that captures one record per
+ * agent tool invocation. The schema carries a `mode` discriminator so
+ * inference-mode and inverse-mode runs land in the same file for easy
+ * A/B comparison.
+ *
+ * Why a separate file rather than reusing the session log: a session
+ * log scopes to one conversation; a run record scopes to one *call*
+ * across modes. The host-driven (inverse) flow has no session id —
+ * each MCP tool call is its own run.
+ */
+import type { EventLogIO } from '../events/log.js';
+export interface RunRecord {
+    /** Time-prefixed base36; sortable by emission order. */
+    runId: string;
+    /** ISO-8601 timestamp. */
+    ts: string;
+    /** AgentDefinition.name, e.g. 'hello-firestore'. */
+    agent: string;
+    /** AgentTool.name, e.g. 'design_firestore_hello_schema'. */
+    tool: string;
+    /** Discriminator across the dual-mode story. */
+    mode: 'inference' | 'inverse';
+    outcome: 'ok' | 'failed';
+    durationMs: number;
+    /** Hash a preview tool returned; consumed by the commit tool. */
+    planHash?: string;
+    /** Event log ids written this call. */
+    eventIds: string[];
+    /** Truncated error message when outcome !== 'ok'. */
+    errorSummary?: string;
+}
+export type RunRecordFilter = Partial<Pick<RunRecord, 'agent' | 'tool' | 'mode' | 'outcome'>>;
+export interface RunLog {
+    readonly path: string;
+    readonly projectId: string;
+    append(record: RunRecord): void;
+    read(filter?: RunRecordFilter): RunRecord[];
+    close(): void;
+}
+export interface OpenRunLogOptions {
+    projectId: string;
+    /** Defaults to `~/.pyric/projects`. */
+    logDir?: string;
+    /** Injectable IO for tests. Same shape as `events/log.ts`. */
+    io?: EventLogIO;
+    /** Injectable clock. */
+    now?: () => number;
+}
+export declare function defaultRunsLogDir(): string;
+/** Time-prefixed base36 id; matches generateEventId's shape. */
+export declare function generateRunId(now?: () => number): string;
+export declare function openRunLog(opts: OpenRunLogOptions): RunLog;
+//# sourceMappingURL=runs.d.ts.map

package/dist/metrics/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/metrics/runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,IAAI,GAAG,QAAQ,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAE9F,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,SAAS,EAAE,CAAC;IAC5C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AASD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,MAAiB,GAAG,MAAM,CAIlE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CA4D1D"}

package/dist/metrics/runs.js

@@ -0,0 +1,99 @@
+/**
+ * Per-call run record — `~/.pyric/projects/<projectId>/runs.ndjson`.
+ *
+ * Distinct from `events.ndjson` (mutation audit) and
+ * `<sessionId>.ndjson` (per-session event stream). Runs is a single,
+ * project-scoped, append-only NDJSON file that captures one record per
+ * agent tool invocation. The schema carries a `mode` discriminator so
+ * inference-mode and inverse-mode runs land in the same file for easy
+ * A/B comparison.
+ *
+ * Why a separate file rather than reusing the session log: a session
+ * log scopes to one conversation; a run record scopes to one *call*
+ * across modes. The host-driven (inverse) flow has no session id —
+ * each MCP tool call is its own run.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+const DEFAULT_IO = {
+    existsSync,
+    mkdirSync,
+    appendFileSync,
+    readFileSync,
+};
+export function defaultRunsLogDir() {
+    return `${homedir()}/.pyric/projects`;
+}
+/** Time-prefixed base36 id; matches generateEventId's shape. */
+export function generateRunId(now = Date.now) {
+    const ts = now().toString(36).padStart(9, '0');
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `run-${ts}-${rand}`;
+}
+export function openRunLog(opts) {
+    if (!/^[a-zA-Z0-9_.-]+$/.test(opts.projectId)) {
+        throw new Error(`openRunLog: projectId ${JSON.stringify(opts.projectId)} contains disallowed characters; use [a-zA-Z0-9_.-]+`);
+    }
+    const io = opts.io ?? DEFAULT_IO;
+    const baseDir = opts.logDir ?? defaultRunsLogDir();
+    const projectDir = `${baseDir.replace(/\/$/, '')}/${opts.projectId}`;
+    const path = `${projectDir}/runs.ndjson`;
+    if (!io.existsSync(projectDir))
+        io.mkdirSync(projectDir, { recursive: true });
+    let closed = false;
+    function ensureOpen() {
+        if (closed)
+            throw new Error(`run log ${path} is closed`);
+    }
+    return {
+        path,
+        projectId: opts.projectId,
+        append(record) {
+            ensureOpen();
+            // appendFileSync mirrors the events-log atomicity story: one
+            // syscall per record so concurrent writers can't interleave
+            // mid-line on Linux + macOS.
+            io.appendFileSync(path, JSON.stringify(record) + '\n');
+        },
+        read(filter) {
+            ensureOpen();
+            if (!io.existsSync(path))
+                return [];
+            const raw = io.readFileSync(path, 'utf8');
+            if (!raw)
+                return [];
+            const out = [];
+            for (const line of raw.split('\n')) {
+                if (!line)
+                    continue;
+                let parsed;
+                try {
+                    parsed = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                if (filter) {
+                    if (filter.agent && parsed.agent !== filter.agent)
+                        continue;
+                    if (filter.tool && parsed.tool !== filter.tool)
+                        continue;
+                    if (filter.mode && parsed.mode !== filter.mode)
+                        continue;
+                    if (filter.outcome && parsed.outcome !== filter.outcome)
+                        continue;
+                }
+                out.push(parsed);
+            }
+            return out;
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            // No file descriptor to release; close is a logical marker so
+            // subsequent reads/appends throw a clean error.
+        },
+    };
+}
+//# sourceMappingURL=runs.js.map

package/dist/metrics/runs.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `MetricsCollector` implementation — pricing tables + cost
+ * derivation in one place. Pure functions; no I/O.
+ *
+ * Pricing is per-million-token USD figures. When the provider
+ * reports a cost (OpenRouter's `x-cost` header), the collector
+ * skips estimation and marks `costEstimated: false`. When the
+ * model isn't in the pricing table, cost is set to 0 with
+ * `costEstimated: true`.
+ *
+ * Update pricing rows below when providers revise rates — there's
+ * no API to introspect them.
+ */
+import type { TurnMetrics } from './types/llm.js';
+import type { MetricsCollector, RecordTurnInput } from './types/metrics.js';
+interface PricingRow {
+    /** USD per million input tokens. */
+    input: number;
+    /** USD per million output tokens. */
+    output: number;
+    /** USD per million cached input tokens (when cache-hit). */
+    cacheRead: number;
+}
+/**
+ * Look up a pricing row. Returns undefined when the model isn't
+ * priced — caller skips the cost field rather than fabricating one.
+ */
+export declare function findPricing(llmId: string, model: string): PricingRow | undefined;
+/**
+ * Derive a `TurnMetrics` value from one turn's raw usage. Pure
+ * function — used by both the collector below and direct callers
+ * that don't need session-level aggregation.
+ */
+export declare function computeTurnMetrics(input: RecordTurnInput): TurnMetrics;
+/** Build a stateful `MetricsCollector` for one session. */
+export declare function createMetricsCollector(): MetricsCollector;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAiB,MAAM,oBAAoB,CAAC;AAE3F,UAAU,UAAU;IAClB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAeD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CA8CtE;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,IAAI,gBAAgB,CAqCzD"}