@inbrowser/agent 0.0.0-placeholder → 0.1.0

package/dist/metrics.js

@@ -0,0 +1,123 @@
+/**
+ * `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.
+ */
+/**
+ * Per-(provider, model) pricing table. Keys are `${llmId}:${model}`
+ * to avoid collisions when two providers ship a same-named model.
+ */
+const PRICING = {
+    'gemini:gemini-3.1-pro-preview': { input: 2.5, output: 20.0, cacheRead: 0.625 },
+    'gemini:gemini-3-flash-preview': { input: 0.5, output: 4.0, cacheRead: 0.125 },
+    'gemini:gemini-3.1-flash-lite': { input: 0.15, output: 0.6, cacheRead: 0.0375 },
+    // OpenRouter quotes cost on the response — we don't need a row.
+    // Ollama is local — no cost.
+    // Nano is on-device — no cost.
+};
+/**
+ * Look up a pricing row. Returns undefined when the model isn't
+ * priced — caller skips the cost field rather than fabricating one.
+ */
+export function findPricing(llmId, model) {
+    return PRICING[`${llmId}:${model}`];
+}
+/**
+ * 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 function computeTurnMetrics(input) {
+    const { llmId, model, rawUsage, isByok } = input;
+    const tokensCached = rawUsage.cachedTokens ?? 0;
+    const tokensReasoning = rawUsage.reasoningTokens ?? 0;
+    // Provider reported cost directly (OpenRouter): trust it.
+    if (typeof rawUsage.costUsd === 'number') {
+        return {
+            tokensIn: rawUsage.promptTokens,
+            tokensOut: rawUsage.completionTokens,
+            tokensCached,
+            tokensReasoning,
+            costUsd: rawUsage.costUsd,
+            costEstimated: false,
+            isByok,
+        };
+    }
+    // Estimate from the table.
+    const row = findPricing(llmId, model);
+    if (!row) {
+        return {
+            tokensIn: rawUsage.promptTokens,
+            tokensOut: rawUsage.completionTokens,
+            tokensCached,
+            tokensReasoning,
+            costUsd: 0,
+            costEstimated: true,
+            isByok,
+        };
+    }
+    // Math: cached tokens get the cache rate; the rest of the prompt
+    // gets the standard input rate; output tokens (which include
+    // reasoning per most providers' billing) get the output rate.
+    const billedInput = Math.max(0, rawUsage.promptTokens - tokensCached);
+    const costUsd = (billedInput * row.input) / 1_000_000 +
+        (tokensCached * row.cacheRead) / 1_000_000 +
+        (rawUsage.completionTokens * row.output) / 1_000_000;
+    return {
+        tokensIn: rawUsage.promptTokens,
+        tokensOut: rawUsage.completionTokens,
+        tokensCached,
+        tokensReasoning,
+        costUsd,
+        costEstimated: true,
+        isByok,
+    };
+}
+/** Build a stateful `MetricsCollector` for one session. */
+export function createMetricsCollector() {
+    let totals = {
+        tokensTotal: 0,
+        tokensIn: 0,
+        tokensOut: 0,
+        tokensCached: 0,
+        tokensReasoning: 0,
+        costUsdTotal: 0,
+        turnCount: 0,
+    };
+    return {
+        recordTurn(input) {
+            const m = computeTurnMetrics(input);
+            totals = {
+                tokensTotal: totals.tokensTotal + m.tokensIn + m.tokensOut,
+                tokensIn: totals.tokensIn + m.tokensIn,
+                tokensOut: totals.tokensOut + m.tokensOut,
+                tokensCached: totals.tokensCached + m.tokensCached,
+                tokensReasoning: totals.tokensReasoning + m.tokensReasoning,
+                costUsdTotal: totals.costUsdTotal + m.costUsd,
+                turnCount: totals.turnCount + 1,
+            };
+            return m;
+        },
+        totals: () => ({ ...totals }),
+        reset() {
+            totals = {
+                tokensTotal: 0,
+                tokensIn: 0,
+                tokensOut: 0,
+                tokensCached: 0,
+                tokensReasoning: 0,
+                costUsdTotal: 0,
+                turnCount: 0,
+            };
+        },
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Node-only entry point.
+ *
+ * The event log writer imports `node:fs` / `node:os` at module init
+ * for append-only NDJSON logging to disk. It lives here so the
+ * browser-facing root entry (`@inbrowser/agent`) stays free of Node
+ * builtins.
+ *
+ * Consumers running in Node (the CLI, the MCP server, sdk's agent
+ * definitions, integration tests) import from `@inbrowser/agent/node`.
+ * Browser consumers (playground) use the root entry, which exposes
+ * the browser-safe events helpers (`wrapMutating`, `replayEvents`,
+ * codec utilities) directly without going through `events/index.js`.
+ *
+ * Other Node-only files in this package (`metrics/runs`, `agents/
+ * firestore`, the CLI commands) have no external consumers via the
+ * public barrel today, so they stay reachable via relative paths
+ * within the package.
+ */
+export { openEventLog, defaultProjectLogDir } from './events/log.js';
+export { generateEventId, buildRollbackEvent, HOST_AGENT_ID, EventTooLargeError, DEFAULT_MAX_EVENT_BYTES, } from './events/log-core.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/node.js

@@ -0,0 +1,22 @@
+/**
+ * Node-only entry point.
+ *
+ * The event log writer imports `node:fs` / `node:os` at module init
+ * for append-only NDJSON logging to disk. It lives here so the
+ * browser-facing root entry (`@inbrowser/agent`) stays free of Node
+ * builtins.
+ *
+ * Consumers running in Node (the CLI, the MCP server, sdk's agent
+ * definitions, integration tests) import from `@inbrowser/agent/node`.
+ * Browser consumers (playground) use the root entry, which exposes
+ * the browser-safe events helpers (`wrapMutating`, `replayEvents`,
+ * codec utilities) directly without going through `events/index.js`.
+ *
+ * Other Node-only files in this package (`metrics/runs`, `agents/
+ * firestore`, the CLI commands) have no external consumers via the
+ * public barrel today, so they stay reachable via relative paths
+ * within the package.
+ */
+export { openEventLog, defaultProjectLogDir } from './events/log.js';
+export { generateEventId, buildRollbackEvent, HOST_AGENT_ID, EventTooLargeError, DEFAULT_MAX_EVENT_BYTES, } from './events/log-core.js';
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `createAgentSession()` — the host-facing session container.
+ *
+ * Generic over the strategy. Translates a `StrategyEvent` stream
+ * into the typed `SessionEvent` stream the host consumes. Tracks
+ * workspace + runtime patches as tool results flow in.
+ */
+import type { AgentSession, AgentSessionConfig } from './types/session.js';
+export declare function createAgentSession(config: AgentSessionConfig): AgentSession;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAgB,MAAM,oBAAoB,CAAC;AAOzF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CA+H3E"}

package/dist/session.js

@@ -0,0 +1,179 @@
+/**
+ * `createAgentSession()` — the host-facing session container.
+ *
+ * Generic over the strategy. Translates a `StrategyEvent` stream
+ * into the typed `SessionEvent` stream the host consumes. Tracks
+ * workspace + runtime patches as tool results flow in.
+ */
+let sessionCounter = 0;
+export function createAgentSession(config) {
+    const id = config.id ?? `session-${++sessionCounter}-${Date.now().toString(36)}`;
+    let workspace = freezeWorkspace(config.history.length > 0 ? extractInitialWorkspace(config) : initialWorkspace());
+    let runtime = initialRuntime();
+    let history = [...config.history];
+    let currentAbort = null;
+    const session = {
+        id,
+        get workspace() {
+            return workspace;
+        },
+        get runtime() {
+            return runtime;
+        },
+        submit(prompt, externalSignal) {
+            // Compose an internal controller that listens to both the
+            // external signal and our `cancel()` override.
+            const inner = new AbortController();
+            currentAbort = inner;
+            const linked = linkSignals(externalSignal, inner.signal);
+            return run(prompt, linked);
+        },
+        cancel() {
+            currentAbort?.abort();
+        },
+    };
+    function bumpWorkspace(patch) {
+        if (!patch)
+            return false;
+        workspace = freezeWorkspace({ ...workspace, ...patch });
+        return true;
+    }
+    function bumpRuntime(patch) {
+        if (!patch)
+            return false;
+        runtime = freezeRuntime({ ...runtime, ...patch });
+        return true;
+    }
+    async function* run(prompt, signal) {
+        const turnId = `t-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+        yield { kind: 'turn_started', turnId };
+        // Capture the user message in history so the next turn sees it.
+        const userMsg = {
+            id: `u-${turnId}`,
+            role: 'user',
+            text: prompt,
+            timestamp: Date.now(),
+        };
+        history = [...history, userMsg];
+        const systemPrompt = config.systemPromptBuilder(workspace, runtime);
+        const strategyEvents = config.strategy.run({
+            prompt,
+            history,
+            workspace,
+            runtime,
+            llm: config.llm,
+            tools: config.tools,
+            toolList: config.toolList,
+            toolContext: config.toolContext,
+            systemPrompt,
+            ...(config.tracer ? { tracer: config.tracer } : {}),
+            turnId,
+        }, signal);
+        let assistantText = '';
+        const assistantId = `a-${turnId}`;
+        for await (const ev of strategyEvents) {
+            if (ev.kind === 'text') {
+                assistantText += ev.chunk;
+                yield { kind: 'text', turnId, chunk: ev.chunk };
+            }
+            else if (ev.kind === 'thinking') {
+                yield { kind: 'thinking', turnId, chunk: ev.chunk };
+            }
+            else if (ev.kind === 'tool_call') {
+                yield {
+                    kind: 'tool_started',
+                    turnId,
+                    callId: ev.id,
+                    name: ev.name,
+                    args: ev.args,
+                    ...(ev.signature ? { signature: ev.signature } : {}),
+                };
+            }
+            else if (ev.kind === 'tool_result') {
+                const wsBumped = bumpWorkspace(ev.result.workspacePatch);
+                const rtBumped = bumpRuntime(ev.result.runtimePatch);
+                yield { kind: 'tool_finished', turnId, callId: ev.id, result: ev.result };
+                if (wsBumped)
+                    yield { kind: 'workspace_changed', workspace };
+                if (rtBumped)
+                    yield { kind: 'runtime_changed', runtime };
+            }
+            else if (ev.kind === 'turn_complete') {
+                const metrics = config.metrics.recordTurn({
+                    llmId: config.llm.id,
+                    model: ev.details.requestedModel,
+                    durationMs: 0,
+                    rawUsage: ev.usage,
+                });
+                // Append assistant message to history.
+                const assistantMsg = {
+                    id: assistantId,
+                    role: 'assistant',
+                    text: assistantText,
+                    metrics,
+                    details: ev.details,
+                    timestamp: Date.now(),
+                };
+                history = [...history, assistantMsg];
+                yield { kind: 'turn_completed', turnId, metrics, details: ev.details };
+            }
+            else if (ev.kind === 'error') {
+                yield { kind: 'error', turnId, message: ev.message };
+                return;
+            }
+            else if (ev.kind === 'custom') {
+                yield { kind: 'strategy_event', name: ev.name, data: ev.data };
+            }
+        }
+        yield { kind: 'completed' };
+    }
+    return session;
+}
+function initialWorkspace() {
+    return freezeWorkspace({
+        presetId: '',
+        rules: '',
+        code: '',
+        appSource: '',
+        stitch: { projectId: null, latestScreenUrl: null, brief: null },
+    });
+}
+function extractInitialWorkspace(config) {
+    // History-only resume — workspace can be threaded in by the caller
+    // via a follow-up patch, but the session's initial workspace shape
+    // matches the empty defaults until then.
+    void config;
+    return initialWorkspace();
+}
+function initialRuntime() {
+    return freezeRuntime({
+        terminal: [],
+        runSummary: null,
+        deploy: null,
+        parseError: null,
+        uiErrors: [],
+        sandboxVersion: 0,
+    });
+}
+function freezeWorkspace(w) {
+    return Object.freeze({ ...w, stitch: Object.freeze({ ...w.stitch }) });
+}
+function freezeRuntime(r) {
+    return Object.freeze({
+        ...r,
+        terminal: Object.freeze([...r.terminal]),
+        uiErrors: Object.freeze([...r.uiErrors]),
+    });
+}
+/** Combine two abort signals into one that fires when either fires. */
+function linkSignals(a, b) {
+    const controller = new AbortController();
+    if (a.aborted || b.aborted) {
+        controller.abort();
+        return controller.signal;
+    }
+    a.addEventListener('abort', () => controller.abort(), { once: true });
+    b.addEventListener('abort', () => controller.abort(), { once: true });
+    return controller.signal;
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `Storage` runtime helpers — adapters over the `Storage` interface
+ * in `./types/storage.ts`. `noopStorage` and `createMemoryStorage`
+ * are exported from the types module since they have no dependencies;
+ * this file adds adapters that DO have host-specific deps.
+ */
+import type { Storage } from './types/storage.js';
+/**
+ * Browser-only adapter over `window.localStorage`. Errors (private
+ * browsing, quota-exceeded) are swallowed silently — `get` returns
+ * null, `set` is a no-op, the host doesn't crash.
+ */
+export declare function createLocalStorageAdapter(): Storage;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAwCnD"}

package/dist/storage.js

@@ -0,0 +1,58 @@
+/**
+ * `Storage` runtime helpers — adapters over the `Storage` interface
+ * in `./types/storage.ts`. `noopStorage` and `createMemoryStorage`
+ * are exported from the types module since they have no dependencies;
+ * this file adds adapters that DO have host-specific deps.
+ */
+/**
+ * Browser-only adapter over `window.localStorage`. Errors (private
+ * browsing, quota-exceeded) are swallowed silently — `get` returns
+ * null, `set` is a no-op, the host doesn't crash.
+ */
+export function createLocalStorageAdapter() {
+    return {
+        get(key) {
+            try {
+                return globalThis.localStorage?.getItem(key) ?? null;
+            }
+            catch {
+                return null;
+            }
+        },
+        set(key, value) {
+            try {
+                globalThis.localStorage?.setItem(key, value);
+            }
+            catch {
+                /* quota / private-mode */
+            }
+        },
+        remove(key) {
+            try {
+                globalThis.localStorage?.removeItem(key);
+            }
+            catch {
+                /* ignored */
+            }
+        },
+        keys(prefix) {
+            try {
+                const ls = globalThis.localStorage;
+                if (!ls)
+                    return [];
+                const out = [];
+                for (let i = 0; i < ls.length; i++) {
+                    const k = ls.key(i);
+                    if (k !== null && (prefix === undefined || k.startsWith(prefix))) {
+                        out.push(k);
+                    }
+                }
+                return out;
+            }
+            catch {
+                return [];
+            }
+        },
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,GAAG,CAAC,GAAG;YACL,IAAI,CAAC;gBACH,OAAO,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,KAAK;YACZ,IAAI,CAAC;gBACH,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;QACD,MAAM,CAAC,GAAG;YACR,IAAI,CAAC;gBACH,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa;YACf,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM;YACT,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC;gBACnC,IAAI,CAAC,EAAE;oBAAE,OAAO,EAAE,CAAC;gBACnB,MAAM,GAAG,GAAa,EAAE,CAAC;gBACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACnC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBACpB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;wBACjE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACd,CAAC;gBACH,CAAC;gBACD,OAAO,GAAG,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/strategy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `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.
+ */
+import type { AgentStrategy } from './types/strategy.js';
+interface ReactLoopOptions {
+    /** Cap on loop iterations to avoid runaway tool-call ping-pong. Default 24. */
+    maxTurns?: number;
+}
+export declare function createReactLoopStrategy(options?: ReactLoopOptions): AgentStrategy;
+export {};
+//# sourceMappingURL=strategy.d.ts.map

package/dist/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../src/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAmC,MAAM,qBAAqB,CAAC;AAG1F,UAAU,gBAAgB;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,gBAAqB,GAAG,aAAa,CAoIrF"}