@inbrowser/agent 0.0.0-placeholder → 0.1.0

package/dist/strategy.js

@@ -0,0 +1,200 @@
+/**
+ * `createReactLoopStrategy()` — the default `AgentStrategy`.
+ *
+ * Implements the playground's current ReAct-style behavior:
+ *
+ *   1. Compose `[system, ...history, user(prompt)]` as the message
+ *      array.
+ *   2. Issue one chat call against the LLM with the tool list.
+ *   3. Stream `text` / `thinking` / `tool_call` events through.
+ *   4. When the LLM produces tool calls, dispatch each one, append
+ *      the result message, and loop back to step 2.
+ *   5. When the LLM produces no tool calls in a turn, emit
+ *      `turn_complete` and finish.
+ *
+ * Future strategies (planner-executor, graph-of-thoughts,
+ * parallel-branch ensembling) sit alongside this one — same
+ * `AgentStrategy` interface, different control flow.
+ */
+export function createReactLoopStrategy(options = {}) {
+    const maxTurns = options.maxTurns ?? 24;
+    return {
+        id: 'react-loop',
+        async *run(input, signal) {
+            const messages = buildMessages(input);
+            for (let turn = 0; turn < maxTurns; turn++) {
+                if (signal.aborted) {
+                    yield { kind: 'error', message: 'aborted' };
+                    return;
+                }
+                const toolDecls = input.toolList.map((h) => ({
+                    name: h.name,
+                    description: h.description,
+                    parameters: h.parameters,
+                }));
+                const chatRequest = {
+                    messages,
+                    tools: toolDecls,
+                    toolUseEnabled: toolDecls.length > 0 && input.llm.supportsTools,
+                };
+                // Emit the trace BEFORE dispatch. Captures the request as the
+                // strategy assembled it — agent-layer view, not provider-
+                // specific. The `requestId` is `${turnId}#${iteration}`
+                // when the session passed a `turnId`; otherwise we synthesize
+                // a per-iteration id so the trace stays consistent for
+                // standalone strategy callers (CLI, eval harness).
+                if (input.tracer) {
+                    const turnIdForReq = input.turnId ?? 'turn-anon';
+                    input.tracer.emit({
+                        kind: 'llm_request',
+                        data: {
+                            requestId: `${turnIdForReq}#${turn}`,
+                            turnId: turnIdForReq,
+                            iteration: turn,
+                            ts: Date.now(),
+                            systemPrompt: input.systemPrompt,
+                            // Shallow-clone arrays to detach the captured view from
+                            // the in-loop `messages` array that grows under our
+                            // feet on each ReAct iteration. Each iteration's trace
+                            // must reflect the messages AS-SENT at that iteration.
+                            messages: messages.map((m) => ({ ...m })),
+                            tools: toolDecls.map((t) => ({ ...t })),
+                            llm: { id: input.llm.id, supportsTools: input.llm.supportsTools },
+                        },
+                    });
+                }
+                const pendingToolCalls = [];
+                let turnUsage;
+                let turnDetails;
+                let assistantText = '';
+                // Stream the model's reply.
+                for await (const ev of input.llm.chat(chatRequest, signal)) {
+                    if (ev.kind === 'text') {
+                        assistantText += ev.chunk;
+                        yield { kind: 'text', chunk: ev.chunk };
+                    }
+                    else if (ev.kind === 'thinking') {
+                        yield { kind: 'thinking', chunk: ev.chunk };
+                    }
+                    else if (ev.kind === 'tool_call') {
+                        pendingToolCalls.push({
+                            id: ev.id,
+                            name: ev.name,
+                            args: ev.args,
+                            ...(ev.signature ? { signature: ev.signature } : {}),
+                        });
+                        yield {
+                            kind: 'tool_call',
+                            id: ev.id,
+                            name: ev.name,
+                            args: ev.args,
+                            ...(ev.signature ? { signature: ev.signature } : {}),
+                        };
+                    }
+                    else if (ev.kind === 'turn_complete') {
+                        turnUsage = ev.usage;
+                        turnDetails = ev.details;
+                    }
+                    else if (ev.kind === 'error') {
+                        yield { kind: 'error', message: ev.message };
+                        return;
+                    }
+                }
+                // No tool calls → final assistant turn, emit turn_complete + done.
+                if (pendingToolCalls.length === 0) {
+                    if (turnUsage && turnDetails) {
+                        yield { kind: 'turn_complete', usage: turnUsage, details: turnDetails };
+                    }
+                    return;
+                }
+                // Tool calls → run each, append result message, loop.
+                messages.push({
+                    role: 'assistant',
+                    text: assistantText,
+                    toolCalls: pendingToolCalls.map((tc) => ({
+                        callId: tc.id,
+                        name: tc.name,
+                        args: tc.args,
+                        ...(tc.signature ? { signature: tc.signature } : {}),
+                    })),
+                });
+                for (const call of pendingToolCalls) {
+                    const result = await input.tools.execute({ id: call.id, name: call.name, args: call.args }, input.toolContext());
+                    yield { kind: 'tool_result', id: call.id, result };
+                    messages.push({
+                        role: 'tool',
+                        callId: call.id,
+                        name: call.name,
+                        resultJson: JSON.stringify(safeSerializable(result)),
+                        text: '',
+                    });
+                }
+                // Loop to next turn.
+                if (turnUsage && turnDetails) {
+                    yield { kind: 'turn_complete', usage: turnUsage, details: turnDetails };
+                }
+            }
+            yield {
+                kind: 'error',
+                message: `react-loop: exceeded maxTurns (${maxTurns}) without settling`,
+            };
+        },
+    };
+}
+function buildMessages(input) {
+    const out = [];
+    out.push({ role: 'system', text: input.systemPrompt });
+    for (const m of input.history) {
+        if (m.role === 'system')
+            continue; // already emitted
+        if (m.role === 'assistant') {
+            const tc = m.toolCalls?.map((c) => ({
+                callId: c.id,
+                name: c.name,
+                args: safeParse(c.argsJson),
+                ...(c.signature ? { signature: c.signature } : {}),
+            })) ?? [];
+            out.push({
+                role: 'assistant',
+                text: m.text,
+                ...(tc.length > 0 ? { toolCalls: tc } : {}),
+            });
+            for (const c of m.toolCalls ?? []) {
+                if (c.resultJson !== undefined) {
+                    out.push({
+                        role: 'tool',
+                        callId: c.id,
+                        name: c.name,
+                        resultJson: c.resultJson,
+                        text: '',
+                    });
+                }
+            }
+        }
+        else {
+            out.push({ role: m.role, text: m.text });
+        }
+    }
+    out.push({ role: 'user', text: input.prompt });
+    return out;
+}
+function safeParse(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return s;
+    }
+}
+function safeSerializable(value) {
+    // Strip non-serializable fields (functions, symbols) that might
+    // sneak into ToolResult.data. Most handlers return plain objects;
+    // this is belt-and-suspenders.
+    try {
+        return JSON.parse(JSON.stringify(value));
+    }
+    catch {
+        return { ok: value.ok, summary: value.summary };
+    }
+}
+//# sourceMappingURL=strategy.js.map

package/dist/strategy.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `ToolRegistry` + `ToolDispatch` runtime implementations.
+ *
+ * The interfaces ship in slice 1 (`./types/tools.ts`). This module
+ * provides:
+ *
+ *   - `createToolRegistry()` — the basic in-memory registry.
+ *   - `createDispatch(registry)` — stateless executor that looks up
+ *     by name and invokes the handler with the supplied `ToolContext`.
+ *
+ * Both are pure-TS — no React, no stores, no localStorage.
+ */
+import type { ToolDispatch, ToolRegistry } from './types/tools.js';
+export declare function createToolRegistry(): ToolRegistry;
+/**
+ * Create a stateless dispatcher over a registry. The dispatcher
+ * holds a reference to the registry — list/register/unregister calls
+ * on the registry are seen by the dispatcher on the next `execute`.
+ *
+ * Error shape: handlers that throw turn into `{ ok: false, summary:
+ * <message> }` results so the caller's `for await` loop doesn't have
+ * to wrap every tool invocation in a try/catch. The thrown value is
+ * stringified into the summary.
+ */
+export declare function createDispatch(registry: ToolRegistry): ToolDispatch;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAGV,YAAY,EAEZ,YAAY,EAEb,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,kBAAkB,IAAI,YAAY,CA8DjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CA0BnE"}

package/dist/tools.js

@@ -0,0 +1,129 @@
+/**
+ * `ToolRegistry` + `ToolDispatch` runtime implementations.
+ *
+ * The interfaces ship in slice 1 (`./types/tools.ts`). This module
+ * provides:
+ *
+ *   - `createToolRegistry()` — the basic in-memory registry.
+ *   - `createDispatch(registry)` — stateless executor that looks up
+ *     by name and invokes the handler with the supplied `ToolContext`.
+ *
+ * Both are pure-TS — no React, no stores, no localStorage.
+ */
+export function createToolRegistry() {
+    const handlers = new Map();
+    function clone() {
+        return new Map(handlers);
+    }
+    function makeFromMap(map) {
+        return {
+            register(handler) {
+                const existing = map.get(handler.name);
+                if (existing) {
+                    // Include both descriptions when available so the
+                    // composer can spot which two factories shipped the
+                    // same tool name without spelunking through stack
+                    // traces.
+                    const existingDesc = truncate(existing.description ?? '', 80);
+                    const newDesc = truncate(handler.description ?? '', 80);
+                    throw new Error(`ToolRegistry: tool '${handler.name}' is already registered.\n` +
+                        `  Previously registered: ${existingDesc || '(no description)'}\n` +
+                        `  New registration:      ${newDesc || '(no description)'}\n` +
+                        `  Use \`registry.replace(handler)\` if this overlay is intentional.`);
+                }
+                map.set(handler.name, handler);
+            },
+            replace(handler) {
+                map.set(handler.name, handler);
+            },
+            unregister(name) {
+                return map.delete(name);
+            },
+            list(opts) {
+                // No capability filter → return every registered handler.
+                // With a capability filter → drop handlers whose `available`
+                // hook returns false. Handlers without an `available` hook
+                // always pass.
+                const out = [];
+                if (opts?.capabilities === undefined) {
+                    for (const h of map.values())
+                        out.push(h);
+                    return out;
+                }
+                const caps = opts.capabilities;
+                for (const h of map.values()) {
+                    if (h.available && !h.available(caps))
+                        continue;
+                    out.push(h);
+                }
+                return out;
+            },
+            has(name) {
+                return map.has(name);
+            },
+            fork() {
+                // Fresh map cloning the current snapshot; later registrations
+                // on the forked registry don't affect the parent.
+                return makeFromMap(new Map(map));
+            },
+        };
+    }
+    return makeFromMap(handlers);
+}
+/**
+ * Create a stateless dispatcher over a registry. The dispatcher
+ * holds a reference to the registry — list/register/unregister calls
+ * on the registry are seen by the dispatcher on the next `execute`.
+ *
+ * Error shape: handlers that throw turn into `{ ok: false, summary:
+ * <message> }` results so the caller's `for await` loop doesn't have
+ * to wrap every tool invocation in a try/catch. The thrown value is
+ * stringified into the summary.
+ */
+export function createDispatch(registry) {
+    return {
+        async execute(call, ctx) {
+            // We look up via the underlying `list` to avoid exposing a
+            // public `get(name)` on the registry — `list()` already enforces
+            // capability filtering, but for `execute` we should run any
+            // registered handler the caller has on file regardless of
+            // capability (the caller's job to gate before calling).
+            const candidate = findByName(registry, call.name);
+            if (!candidate) {
+                return {
+                    ok: false,
+                    summary: `Unknown tool: ${call.name}`,
+                };
+            }
+            try {
+                const args = call.args;
+                return await candidate.execute(args, ctx);
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    summary: `Tool ${call.name} threw: ${e instanceof Error ? e.message : String(e)}`,
+                };
+            }
+        },
+    };
+}
+/**
+ * Find a handler by name without exposing a `get` method on the
+ * registry interface. Public consumers always go through `list()`;
+ * the dispatcher (a friend of the registry) uses this internal
+ * lookup.
+ */
+function findByName(registry, name) {
+    if (!registry.has(name))
+        return undefined;
+    // The registry doesn't expose a `get`; list() with no capability
+    // filter returns every handler — find by name from there.
+    const all = registry.list();
+    return all.find((h) => h.name === name);
+}
+/** Trim a string to `max` chars with an ellipsis marker. */
+function truncate(s, max) {
+    return s.length <= max ? s : `${s.slice(0, max)}…`;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types/agent.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Inverse-mode types — see `plans/inverse-mode-architecture.md`.
+ *
+ * In inference mode, an agent owns its LlmClient + conversation and the
+ * strategy drives a turn-by-turn loop calling `ToolHandler`s. In inverse
+ * mode, an external LLM host (Claude Code, Claude Desktop) drives the
+ * conversation and calls *behavior-named* `AgentTool`s one-shot.
+ *
+ * AgentTool is intentionally distinct from ToolHandler:
+ *   - `ToolHandler` carries session-coupled context (workspace, runtime,
+ *     sandbox, lint) that the inference loop maintains across turns.
+ *   - `AgentTool` is a pure(-ish) function over input + minimal context.
+ *     No conversation state. Plan/commit chaining is per-tool, enforced
+ *     via planHash, not framework-level.
+ */
+import type { EventLog } from '../events/log-core.js';
+import type { JsonSchema } from './llm.js';
+import type { ProjectContext } from './project-context.js';
+import type { SandboxHandle } from './tools.js';
+/**
+ * A bundle of behavior-named tools that share a domain + (where
+ * applicable) a planHash chain.
+ *
+ * `name` is the developer-facing id (`'hello-firestore'`,
+ * `'firestore-data-modeling'`). It surfaces in `agent describe` and
+ * `--agent` flags. It is NOT what the host LLM sees — each tool's own
+ * `name` is.
+ */
+export interface AgentDefinition {
+    name: string;
+    description: string;
+    tools: AgentTool[];
+}
+/**
+ * One MCP-exposable behavior. The `name` and `description` are what the
+ * host LLM matches against user intent — phrase them as verbs the user
+ * would utter ("design_firestore_schema", not "data_modeling__plan").
+ */
+export interface AgentTool<I = unknown, O = unknown> {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+    execute(input: I, ctx: AgentContext): Promise<AgentToolResult<O>>;
+}
+/**
+ * Per-call context. Distinct from `ToolContext` (the inference-mode
+ * shape): no workspace, no runtime, no lint — those concepts live in
+ * the conversation owner. AgentTools are one-shot from the host's POV.
+ */
+export interface AgentContext {
+    /** Unique per call; correlates the run record + any events emitted. */
+    runId: string;
+    /** Firebase project id — routes the event log + runs log. */
+    projectId: string;
+    /** Append-only mutation log; same one `wrapMutating` writes to. */
+    events: EventLog;
+    /** Cancellation signal. Host typically supplies one per RPC. */
+    signal: AbortSignal;
+    /** Optional sandbox handle for tools that need it. Absent for pure
+     *  computation (e.g. schema design). */
+    sandbox?: SandboxHandle;
+    /** Injectable clock for deterministic tests. */
+    now?: () => number;
+    /**
+     * Initialized `ProjectContext` for tools that need live project
+     * access (admin Firestore reads, REST API rules fetch). Present
+     * when `agent serve` was launched with FIREBASE_SA_BASE64 in env;
+     * absent otherwise. Tools should fail with a clear "needs SA"
+     * message when this is required and missing, not silently no-op.
+     *
+     * Field name preserved (vs. `projectContext`) so the public
+     * AgentContext shape doesn't break external tools that destructure
+     * `ctx.agentApp`; the *type* migrated from `AgentApp` to
+     * `ProjectContext` in Phase C step 13 of the legacy-SDK migration.
+     */
+    agentApp?: ProjectContext;
+}
+export interface AgentToolResult<O = unknown> {
+    ok: boolean;
+    /** One-line summary the host LLM can quote back to the user. */
+    summary: string;
+    /** Structured payload. Host LLM may reference it in follow-up tool calls. */
+    data?: O;
+    /**
+     * Set by preview/plan tools; consumed by the corresponding commit
+     * tool to enforce that the user-approved plan is what gets executed.
+     * Hash content is at the tool author's discretion (typically a SHA
+     * of the canonical JSON of `data`).
+     */
+    planHash?: string;
+    /** Event log ids produced this call. Surfaces to the run record. */
+    eventIds?: string[];
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;CACnE;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,MAAM,EAAE,QAAQ,CAAC;IACjB,gEAAgE;IAChE,MAAM,EAAE,WAAW,CAAC;IACpB;4CACwC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,CAAC,CAAC;IACT;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/types/agent.js

@@ -0,0 +1,17 @@
+/**
+ * Inverse-mode types — see `plans/inverse-mode-architecture.md`.
+ *
+ * In inference mode, an agent owns its LlmClient + conversation and the
+ * strategy drives a turn-by-turn loop calling `ToolHandler`s. In inverse
+ * mode, an external LLM host (Claude Code, Claude Desktop) drives the
+ * conversation and calls *behavior-named* `AgentTool`s one-shot.
+ *
+ * AgentTool is intentionally distinct from ToolHandler:
+ *   - `ToolHandler` carries session-coupled context (workspace, runtime,
+ *     sandbox, lint) that the inference loop maintains across turns.
+ *   - `AgentTool` is a pure(-ish) function over input + minimal context.
+ *     No conversation state. Plan/commit chaining is per-tool, enforced
+ *     via planHash, not framework-level.
+ */
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

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

package/dist/types/capabilities.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `Capabilities` — what the current session can do.
+ *
+ * Computed once per session at start, refreshed at start of each
+ * turn. Drives which tools the agent is told about and which
+ * behaviors the system prompt mentions.
+ */
+export interface Capabilities {
+    /** The active LLM provider advertises tool-use support. */
+    llmSupportsTools: boolean;
+    /** Stitch design tools are available (BYOK present + feature-flag on). */
+    stitchAvailable: boolean;
+    /** Sandbox is initialized and ready to receive tool calls. */
+    sandboxReady: boolean;
+}
+export declare const DEFAULT_CAPABILITIES: Capabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/types/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/types/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,eAAe,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,oBAAoB,EAAE,YAIjB,CAAC"}

package/dist/types/capabilities.js

@@ -0,0 +1,13 @@
+/**
+ * `Capabilities` — what the current session can do.
+ *
+ * Computed once per session at start, refreshed at start of each
+ * turn. Drives which tools the agent is told about and which
+ * behaviors the system prompt mentions.
+ */
+export const DEFAULT_CAPABILITIES = Object.freeze({
+    llmSupportsTools: true,
+    stitchAvailable: false,
+    sandboxReady: false,
+});
+//# sourceMappingURL=capabilities.js.map

package/dist/types/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/types/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,CAAC,MAAM,oBAAoB,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC9D,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,KAAK;CACpB,CAAiB,CAAC"}

package/dist/types/chat.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Chat message shape — the cross-session transcript surface.
+ *
+ * Matches the playground's existing `ChatMessage` shape closely so
+ * the React host can drop in `@inbrowser/agent` types without
+ * rewriting render code. The neutral shape lets non-React hosts
+ * (CLI, eval harness) consume the same transcripts.
+ */
+export type ChatRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface ChatMessage {
+    id: string;
+    role: ChatRole;
+    text: string;
+    /** Streaming flag — true while the LLM is still emitting chunks. */
+    streaming?: boolean;
+    /** Hidden reasoning ("thinking") text — surface only when the host opts in. */
+    thinking?: string;
+    toolCalls?: ToolCall[];
+    /** Turn-scoped usage + cost — stamped on the assistant message at turn end. */
+    metrics?: TurnMetrics;
+    /** Per-turn detail block (servedModel, requestedModel, fingerprint, …). */
+    details?: TurnDetails;
+    /** Wall-clock milliseconds the turn took. */
+    timestamp?: number;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    argsJson: string;
+    /** Stringified result; absent while the call is in flight. */
+    resultJson?: string;
+    ok?: boolean;
+    /** Optional human-readable one-liner the model can quote on the next turn. */
+    summary?: string;
+    /** Provider-specific signature carried through round-trips (Gemini thoughtSignature). */
+    signature?: string;
+}
+export interface TurnMetrics {
+    tokensIn: number;
+    tokensOut: number;
+    tokensCached: number;
+    tokensReasoning: number;
+    costUsd: number;
+    /** True when cost is computed client-side from a pricing table vs returned by the provider. */
+    costEstimated?: boolean;
+    /** True when the user supplied their own key — affects billing display. */
+    isByok?: boolean;
+}
+export interface TurnDetails {
+    /** The model name the host requested. */
+    requestedModel: string;
+    /** The model name the provider actually served (e.g. an OpenRouter routing fallback). */
+    servedModel?: string;
+    /** Provider-stable fingerprint when offered (Gemini systemFingerprint, OpenAI fingerprint). */
+    fingerprint?: string;
+    /** Free-form provider routing info (OpenRouter "provider" field, etc.). */
+    routing?: Record<string, unknown>;
+}
+/** A normalized message shape providers consume — drops React-specific fields like `streaming`. */
+export interface NormalizedMessage {
+    role: ChatRole;
+    text: string;
+    toolCalls?: {
+        callId: string;
+        name: string;
+        args: unknown;
+        signature?: string;
+    }[];
+    /** For `role: 'tool'` only — the result of a previous tool call. */
+    callId?: string;
+    name?: string;
+    resultJson?: string;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/types/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/types/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,mGAAmG;AACnG,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClF,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/chat.js

@@ -0,0 +1,10 @@
+/**
+ * Chat message shape — the cross-session transcript surface.
+ *
+ * Matches the playground's existing `ChatMessage` shape closely so
+ * the React host can drop in `@inbrowser/agent` types without
+ * rewriting render code. The neutral shape lets non-React hosts
+ * (CLI, eval harness) consume the same transcripts.
+ */
+export {};
+//# sourceMappingURL=chat.js.map

package/dist/types/chat.js.map

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