npm - @bbclaw/core - Versions diffs - 0.1.0 - Mend

@bbclaw/core 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (85) hide show

package/dist/providers/web-bridge/promptInjector.d.ts ADDED Viewed

@@ -0,0 +1,63 @@
+/**
+ * Tool-use emulation prompt protocol — arg-tag format.
+ *
+ * Web-bridge backends (DeepSeek/Kimi/ChatGPT/...) don't speak native function
+ * calling on the wire — they only see prompt text. We teach them this XML
+ * protocol via the prompt:
+ *
+ *   1. Inject a system prompt that explains how to invoke tools.
+ *   2. Stream-parse the model's output looking for `<tool_use>` blocks.
+ *   3. Convert detected blocks back into Anthropic `content_block.tool_use`
+ *      events so the upper agent layer never sees the difference.
+ *
+ * Why arg tags and not a single JSON `<input>`? The original protocol asked
+ * the model to emit ONE JSON object containing all argument values. For
+ * string arguments holding file contents (HTML, code), the model had to
+ * JSON-escape every quote/newline/backslash — which doubles payload size,
+ * dramatically raises the failure rate (models routinely produce subtly
+ * invalid JSON when escaping a few thousand characters of HTML), and gets
+ * silently truncated by max_tokens with no clean recovery.
+ *
+ * The arg-tag protocol moves each argument into its own delimited block of
+ * RAW text. No JSON escaping at all. The only thing the model has to escape
+ * is the literal substring `</arg>`, which essentially never appears in
+ * real code.
+ *
+ * Format the model is told to emit:
+ *
+ *   <tool_use>
+ *   <name>ToolName</name>
+ *   <arg name="path">/some/path/file.html</arg>
+ *   <arg name="content">
+ *   <!DOCTYPE html>
+ *   <html>...</html>
+ *   </arg>
+ *   </tool_use>
+ *
+ * The parser collects each <arg>...</arg> body into a string and assembles
+ * them into an `{ argName: value }` object.
+ */
+import type { ToolUnion } from '@anthropic-ai/sdk/resources/messages/messages.js';
+export declare const TOOL_USE_OPEN = "<tool_use>";
+export declare const TOOL_USE_CLOSE = "</tool_use>";
+export declare const TOOL_NAME_OPEN = "<name>";
+export declare const TOOL_NAME_CLOSE = "</name>";
+export declare const ARG_OPEN_PREFIX = "<arg name=\"";
+export declare const ARG_OPEN_SUFFIX = "\">";
+export declare const ARG_CLOSE = "</arg>";
+/** What the model writes when it needs the literal text "</arg>" inside content. */
+export declare const ARG_CLOSE_ESCAPE_TOKEN = "&lt;/arg&gt;";
+/**
+ * Build the system-prompt fragment that teaches the protocol. Caller is
+ * responsible for combining this with any other system text and the message
+ * history.
+ *
+ * If no tools are present, returns an empty string — letting the upper layer
+ * skip the whole tool-emulation overhead.
+ */
+export declare function buildToolProtocolPrompt(tools: ToolUnion[] | undefined): string;
+/** Decode the single escape token `&lt;/arg&gt;` back into the literal `</arg>`. */
+export declare function unescapeArgContent(s: string): string;
+/** Inverse of unescapeArgContent — used when serializing prior tool_use blocks. */
+export declare function escapeArgContent(s: string): string;
+//# sourceMappingURL=promptInjector.d.ts.map

package/dist/providers/web-bridge/promptInjector.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"promptInjector.d.ts","sourceRoot":"","sources":["../../../src/providers/web-bridge/promptInjector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAQ,SAAS,EAAE,MAAM,kDAAkD,CAAA;AAEvF,eAAO,MAAM,aAAa,eAAe,CAAA;AACzC,eAAO,MAAM,cAAc,gBAAgB,CAAA;AAC3C,eAAO,MAAM,cAAc,WAAW,CAAA;AACtC,eAAO,MAAM,eAAe,YAAY,CAAA;AACxC,eAAO,MAAM,eAAe,iBAAgB,CAAA;AAC5C,eAAO,MAAM,eAAe,QAAO,CAAA;AACnC,eAAO,MAAM,SAAS,WAAW,CAAA;AACjC,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,iBAAiB,CAAA;AAEpD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,MAAM,CAsC9E;AA8FD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/providers/web-bridge/promptInjector.js ADDED Viewed

@@ -0,0 +1,189 @@
+/**
+ * Tool-use emulation prompt protocol — arg-tag format.
+ *
+ * Web-bridge backends (DeepSeek/Kimi/ChatGPT/...) don't speak native function
+ * calling on the wire — they only see prompt text. We teach them this XML
+ * protocol via the prompt:
+ *
+ *   1. Inject a system prompt that explains how to invoke tools.
+ *   2. Stream-parse the model's output looking for `<tool_use>` blocks.
+ *   3. Convert detected blocks back into Anthropic `content_block.tool_use`
+ *      events so the upper agent layer never sees the difference.
+ *
+ * Why arg tags and not a single JSON `<input>`? The original protocol asked
+ * the model to emit ONE JSON object containing all argument values. For
+ * string arguments holding file contents (HTML, code), the model had to
+ * JSON-escape every quote/newline/backslash — which doubles payload size,
+ * dramatically raises the failure rate (models routinely produce subtly
+ * invalid JSON when escaping a few thousand characters of HTML), and gets
+ * silently truncated by max_tokens with no clean recovery.
+ *
+ * The arg-tag protocol moves each argument into its own delimited block of
+ * RAW text. No JSON escaping at all. The only thing the model has to escape
+ * is the literal substring `</arg>`, which essentially never appears in
+ * real code.
+ *
+ * Format the model is told to emit:
+ *
+ *   <tool_use>
+ *   <name>ToolName</name>
+ *   <arg name="path">/some/path/file.html</arg>
+ *   <arg name="content">
+ *   <!DOCTYPE html>
+ *   <html>...</html>
+ *   </arg>
+ *   </tool_use>
+ *
+ * The parser collects each <arg>...</arg> body into a string and assembles
+ * them into an `{ argName: value }` object.
+ */
+export const TOOL_USE_OPEN = '<tool_use>';
+export const TOOL_USE_CLOSE = '</tool_use>';
+export const TOOL_NAME_OPEN = '<name>';
+export const TOOL_NAME_CLOSE = '</name>';
+export const ARG_OPEN_PREFIX = '<arg name="';
+export const ARG_OPEN_SUFFIX = '">';
+export const ARG_CLOSE = '</arg>';
+/** What the model writes when it needs the literal text "</arg>" inside content. */
+export const ARG_CLOSE_ESCAPE_TOKEN = '&lt;/arg&gt;';
+/**
+ * Build the system-prompt fragment that teaches the protocol. Caller is
+ * responsible for combining this with any other system text and the message
+ * history.
+ *
+ * If no tools are present, returns an empty string — letting the upper layer
+ * skip the whole tool-emulation overhead.
+ */
+export function buildToolProtocolPrompt(tools) {
+    const customTools = (tools ?? []).filter(isCustomTool);
+    if (customTools.length === 0)
+        return '';
+    const toolListing = customTools.map(renderToolDescription).join('\n\n---\n\n');
+    return [
+        '## Tool use protocol',
+        '',
+        'You have access to a set of tools. When you need to call a tool, output ONLY this exact format and then stop:',
+        '',
+        '```',
+        TOOL_USE_OPEN,
+        `${TOOL_NAME_OPEN}ToolName${TOOL_NAME_CLOSE}`,
+        `${ARG_OPEN_PREFIX}argument1${ARG_OPEN_SUFFIX}first argument value as plain text${ARG_CLOSE}`,
+        `${ARG_OPEN_PREFIX}argument2${ARG_OPEN_SUFFIX}`,
+        'second argument value can be multi-line raw text — code, JSON, markdown,',
+        'anything. Quotes "like this", backslashes \\, angle brackets <like this>',
+        'are all literal. Do not escape them.',
+        ARG_CLOSE,
+        TOOL_USE_CLOSE,
+        '```',
+        '',
+        'Rules — read carefully:',
+        '',
+        '1. Output exactly ONE `<tool_use>` block per response. If you need multiple tools, call them in successive turns (the system will return each result before you decide the next call).',
+        '2. After the closing `</tool_use>` tag, STOP. Do not add commentary or further text. The system will return the result in the next user message.',
+        `3. Each tool argument lives inside its own \`${ARG_OPEN_PREFIX}<argName>${ARG_OPEN_SUFFIX} ... ${ARG_CLOSE}\` tag. The \`name\` attribute MUST match the parameter name from the tool's description.`,
+        '4. Content between an opening `<arg ...>` tag and its `</arg>` close is RAW TEXT. Do NOT JSON-encode it. Do not wrap in quotes. Newlines, double-quotes, backslashes, and angle brackets are all literal — write code, HTML, or markdown directly.',
+        `5. The ONLY thing you must escape is the literal substring \`${ARG_CLOSE}\` if it appears in your content — write it as \`${ARG_CLOSE_ESCAPE_TOKEN}\`. This is rare; most code, markup, and prose never contain the exact text \`${ARG_CLOSE}\`.`,
+        '6. Do NOT wrap the `<tool_use>` block in a markdown code fence or quote it. Output the tags directly.',
+        '7. If you do NOT need a tool, answer the user in plain text as you normally would. Do not output `<tool_use>` tags speculatively.',
+        '8. Tool results from previous turns appear as `[Tool result for ToolName]: ...` in user messages. Trust them as authoritative; do not re-issue the same call.',
+        '',
+        `## Available tools (${customTools.length})`,
+        '',
+        toolListing,
+    ].join('\n');
+}
+function renderToolDescription(tool) {
+    const lines = [];
+    lines.push(`### Tool: ${tool.name}`);
+    if (tool.description)
+        lines.push('', tool.description.trim());
+    const schema = tool.input_schema;
+    if (schema?.properties && typeof schema.properties === 'object') {
+        const required = new Set(schema.required ?? []);
+        lines.push('', 'Parameters:');
+        for (const [key, raw] of Object.entries(schema.properties)) {
+            const desc = describeProperty(key, raw, required.has(key));
+            lines.push(`  - ${desc}`);
+        }
+    }
+    // A short example helps the model nail the format on the first try.
+    const example = buildExampleArgs(schema);
+    if (example) {
+        lines.push('', 'Example:');
+        lines.push('```');
+        lines.push(TOOL_USE_OPEN);
+        lines.push(`${TOOL_NAME_OPEN}${tool.name}${TOOL_NAME_CLOSE}`);
+        for (const [argName, argValue] of example) {
+            lines.push(`${ARG_OPEN_PREFIX}${argName}${ARG_OPEN_SUFFIX}${argValue}${ARG_CLOSE}`);
+        }
+        lines.push(TOOL_USE_CLOSE);
+        lines.push('```');
+    }
+    return lines.join('\n');
+}
+function describeProperty(key, raw, required) {
+    if (typeof raw !== 'object' || raw === null)
+        return `\`${key}\``;
+    const prop = raw;
+    const typeStr = prop.type ?? 'any';
+    const reqStr = required ? 'required' : 'optional';
+    const enumStr = Array.isArray(prop.enum)
+        ? ` (one of: ${prop.enum.map((v) => JSON.stringify(v)).join(', ')})`
+        : '';
+    const descStr = prop.description
+        ? ` — ${prop.description.replace(/\s+/g, ' ').trim()}`
+        : '';
+    return `\`${key}\` (${typeStr}, ${reqStr})${enumStr}${descStr}`;
+}
+function buildExampleArgs(schema) {
+    if (!schema?.properties)
+        return null;
+    const required = schema.required ?? [];
+    if (required.length === 0)
+        return null;
+    const out = [];
+    for (const key of required) {
+        const prop = schema.properties[key];
+        if (!prop)
+            continue;
+        let example = '...';
+        if (Array.isArray(prop.enum) && prop.enum.length > 0) {
+            example = String(prop.enum[0] ?? '...');
+        }
+        else {
+            switch (prop.type) {
+                case 'number':
+                case 'integer':
+                    example = '1';
+                    break;
+                case 'boolean':
+                    example = 'true';
+                    break;
+                case 'array':
+                    example = '[]';
+                    break;
+                case 'object':
+                    example = '{}';
+                    break;
+                default:
+                    example = '...';
+            }
+        }
+        out.push([key, example]);
+    }
+    return out;
+}
+function isCustomTool(t) {
+    // Anthropic's built-in tools (computer_20250124, bash_20250124, ...) have a
+    // `type` field; user-defined tools don't.
+    return !(typeof t === 'object' && t !== null && 'type' in t);
+}
+/** Decode the single escape token `&lt;/arg&gt;` back into the literal `</arg>`. */
+export function unescapeArgContent(s) {
+    return s.split(ARG_CLOSE_ESCAPE_TOKEN).join(ARG_CLOSE);
+}
+/** Inverse of unescapeArgContent — used when serializing prior tool_use blocks. */
+export function escapeArgContent(s) {
+    return s.split(ARG_CLOSE).join(ARG_CLOSE_ESCAPE_TOKEN);
+}
+//# sourceMappingURL=promptInjector.js.map

package/dist/providers/web-bridge/promptInjector.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"promptInjector.js","sourceRoot":"","sources":["../../../src/providers/web-bridge/promptInjector.ts"],"names":[],"mappings":"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"}

package/dist/providers/web-bridge/provider.d.ts ADDED Viewed

@@ -0,0 +1,59 @@
+/**
+ * WebBridgeProvider — adapts the web-bridge stack to the Provider interface.
+ *
+ * Responsibilities:
+ *   - Capability declaration (nativeTools=false, promptCaching=false, etc).
+ *   - Per-turn lifecycle: open new chat → serialize history → submit prompt →
+ *     parse streamed text into Anthropic events → yield events.
+ *   - Login orchestration via setHeadless(false) / setHeadless(true).
+ *
+ * What it deliberately doesn't do:
+ *   - Multi-Agent concurrency: one browser session, one turn at a time. The
+ *     upper agent layer is responsible for serializing.
+ *   - Prompt caching: the web bridge has no cache control. We strip
+ *     cache_control hints in the request translator already.
+ */
+import type { Message, MessageCreateParamsStreaming, MessageStreamParams, RawMessageStreamEvent } from '@anthropic-ai/sdk/resources/messages/messages.js';
+import type { Logger } from '@bbclaw/shared';
+import { BaseProvider, type HealthCheckResult, type ProviderCapabilities } from '../types.js';
+import { type WebBridgeAdapterOptions } from './shared/WebBridgeAdapter.js';
+import type { WebBridgeSpec, WebBridgeState } from './shared/types.js';
+export interface WebBridgeProviderOptions extends WebBridgeAdapterOptions {
+    /** Stable provider id (defaults to the spec's serviceId). */
+    id?: string;
+    /** Display name override. */
+    displayName?: string;
+    /** Capability overrides — most users won't need to touch this. */
+    capabilities?: Partial<ProviderCapabilities>;
+    logger?: Logger;
+}
+export declare class WebBridgeProvider extends BaseProvider {
+    readonly kind: "web-bridge";
+    readonly id: string;
+    readonly displayName: string;
+    readonly capabilities: ProviderCapabilities;
+    readonly defaultModel: string;
+    private readonly adapter;
+    private readonly spec;
+    constructor(spec: WebBridgeSpec, opts: WebBridgeProviderOptions);
+    streamMessage(params: MessageStreamParams | MessageCreateParamsStreaming): Promise<AsyncIterable<RawMessageStreamEvent>>;
+    createMessage(params: MessageStreamParams): Promise<Message>;
+    healthCheck(): Promise<HealthCheckResult>;
+    close(): Promise<void>;
+    /** Show the browser so the user can complete the login flow. */
+    showForLogin(): Promise<void>;
+    /** Toggle headless mode (e.g. for debugging silent failures). */
+    setHeadless(headless: boolean): Promise<void>;
+    /** Confirm login worked and switch back to headless. Returns whether composer is reachable. */
+    confirmLogin(): Promise<boolean>;
+    /** Current page URL — useful diagnostic during login flows. */
+    currentUrl(): string | undefined;
+    getBridgeState(): WebBridgeState;
+    /**
+     * Convert the cumulative-text stream from the adapter into Anthropic
+     * RawMessageStreamEvent events. The adapter yields snapshots of the full
+     * response so far; we diff to deltas and feed them into the protocol parser.
+     */
+    private adaptToAnthropicEvents;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/providers/web-bridge/provider.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/providers/web-bridge/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,OAAO,EACP,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kDAAkD,CAAA;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EACL,YAAY,EAEZ,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEtE,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB;IACvE,6DAA6D;IAC7D,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAoBD,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAS;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,SAAkB,YAAY,EAAE,MAAM,CAAA;IAEtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;gBAExB,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,wBAAwB;IAmBzD,aAAa,CACjB,MAAM,EAAE,mBAAmB,GAAG,4BAA4B,GACzD,OAAO,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAYjC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrE,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAiBhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC,gEAAgE;IAC1D,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC,iEAAiE;IAC3D,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,+FAA+F;IACzF,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAQtC,+DAA+D;IAC/D,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC,cAAc,IAAI,cAAc;IAMhC;;;;OAIG;YACY,sBAAsB;CAoDtC"}

package/dist/providers/web-bridge/provider.js ADDED Viewed

@@ -0,0 +1,176 @@
+/**
+ * WebBridgeProvider — adapts the web-bridge stack to the Provider interface.
+ *
+ * Responsibilities:
+ *   - Capability declaration (nativeTools=false, promptCaching=false, etc).
+ *   - Per-turn lifecycle: open new chat → serialize history → submit prompt →
+ *     parse streamed text into Anthropic events → yield events.
+ *   - Login orchestration via setHeadless(false) / setHeadless(true).
+ *
+ * What it deliberately doesn't do:
+ *   - Multi-Agent concurrency: one browser session, one turn at a time. The
+ *     upper agent layer is responsible for serializing.
+ *   - Prompt caching: the web bridge has no cache control. We strip
+ *     cache_control hints in the request translator already.
+ */
+import { randomUUID } from 'node:crypto';
+import { BaseProvider, collectStreamToMessage, } from '../types.js';
+import { serializeHistory } from './historySerializer.js';
+import { ToolUseStreamParser } from './toolUseParser.js';
+import { WebBridgeAdapter } from './shared/WebBridgeAdapter.js';
+/**
+ * Capability baseline for a "generic modern chat-web" service. Individual
+ * specs / instances can override via constructor option.
+ */
+const WEB_BRIDGE_CAPABILITIES_DEFAULT = {
+    // No native function calling. Tool support is emulated via the XML protocol
+    // we inject into the prompt. nativeTools=false signals to the upper agent
+    // that it should expect emulation behavior (smaller tool counts, simpler
+    // schemas, more retries on malformed tool input).
+    nativeTools: false,
+    promptCaching: false,
+    extendedThinking: false, // we strip thinking blocks visually but don't echo them
+    vision: false, // image uploads via DOM are technically possible but out of scope for v0.1
+    contextWindow: 32_000,
+    maxOutputTokens: 8_192,
+    streaming: true,
+};
+export class WebBridgeProvider extends BaseProvider {
+    kind = 'web-bridge';
+    id;
+    displayName;
+    capabilities;
+    defaultModel;
+    adapter;
+    spec;
+    constructor(spec, opts) {
+        super(opts.logger ?? { debug: () => { }, info: () => { }, warn: () => { }, error: () => { } });
+        this.spec = spec;
+        this.id = opts.id ?? spec.serviceId;
+        this.displayName = opts.displayName ?? spec.displayName;
+        // The web bridge doesn't route by model name (the service picks its own),
+        // but a sentinel value flows through message_start.model so downstream
+        // consumers see a stable identifier instead of an empty string.
+        this.defaultModel = spec.serviceId;
+        this.capabilities = {
+            ...WEB_BRIDGE_CAPABILITIES_DEFAULT,
+            contextWindow: spec.contextWindowEstimate,
+            ...opts.capabilities,
+        };
+        this.adapter = new WebBridgeAdapter(spec, opts);
+    }
+    // ---- Provider interface ----
+    async streamMessage(params) {
+        // Each turn starts in a fresh chat — messages[] is the source of truth.
+        await this.adapter.start();
+        await this.adapter.newChat();
+        const prompt = serializeHistory(params);
+        if (prompt.length === 0)
+            throw new Error('WebBridgeProvider: empty prompt after serialization');
+        const rawStream = this.adapter.askStream(prompt);
+        return this.adaptToAnthropicEvents(rawStream, params.model);
+    }
+    async createMessage(params) {
+        const stream = await this.streamMessage(params);
+        return collectStreamToMessage(stream);
+    }
+    async healthCheck() {
+        const start = Date.now();
+        try {
+            await this.adapter.start();
+            const ok = await this.adapter.isLoggedIn(3_000);
+            return ok
+                ? { ok: true, latencyMs: Date.now() - start }
+                : { ok: false, latencyMs: Date.now() - start, reason: 'login required' };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                latencyMs: Date.now() - start,
+                reason: e instanceof Error ? e.message : String(e),
+            };
+        }
+    }
+    async close() {
+        await this.adapter.stop();
+    }
+    // ---- web-bridge specific ----
+    /** Show the browser so the user can complete the login flow. */
+    async showForLogin() {
+        await this.adapter.setHeadless(false);
+        await this.adapter.start();
+    }
+    /** Toggle headless mode (e.g. for debugging silent failures). */
+    async setHeadless(headless) {
+        await this.adapter.setHeadless(headless);
+    }
+    /** Confirm login worked and switch back to headless. Returns whether composer is reachable. */
+    async confirmLogin() {
+        // First-time post-login the SPA can take several seconds to hydrate the
+        // composer. Give it longer than the routine isLoggedIn() probe.
+        const ok = await this.adapter.isLoggedIn(15_000);
+        if (ok)
+            await this.adapter.setHeadless(true);
+        return ok;
+    }
+    /** Current page URL — useful diagnostic during login flows. */
+    currentUrl() {
+        return this.adapter.currentUrl();
+    }
+    getBridgeState() {
+        return this.adapter.getState();
+    }
+    // ---- internals ----
+    /**
+     * Convert the cumulative-text stream from the adapter into Anthropic
+     * RawMessageStreamEvent events. The adapter yields snapshots of the full
+     * response so far; we diff to deltas and feed them into the protocol parser.
+     */
+    async *adaptToAnthropicEvents(rawStream, model) {
+        const messageId = `msg_${randomUUID()}`;
+        const parser = new ToolUseStreamParser();
+        let lastEmittedLength = 0;
+        yield {
+            type: 'message_start',
+            message: {
+                id: messageId,
+                type: 'message',
+                role: 'assistant',
+                model,
+                content: [],
+                stop_reason: null,
+                stop_sequence: null,
+                usage: {
+                    input_tokens: 0,
+                    output_tokens: 0,
+                    cache_creation_input_tokens: null,
+                    cache_read_input_tokens: null,
+                },
+            },
+        };
+        let lastText = '';
+        for await (const chunk of rawStream) {
+            const delta = chunk.text.slice(lastEmittedLength);
+            lastEmittedLength = chunk.text.length;
+            lastText = chunk.text;
+            if (delta.length > 0)
+                yield* parser.feed(delta);
+            if (chunk.done)
+                break;
+        }
+        yield* parser.flush();
+        // Rough token estimate. Web bridges don't give us real usage numbers, so
+        // we approximate based on char count. Mixed-language average ~ 0.3 tok/char.
+        const outputTokens = Math.max(1, Math.ceil(lastText.length * 0.3));
+        yield {
+            type: 'message_delta',
+            delta: {
+                stop_reason: parser.stopReason,
+                stop_sequence: null,
+            },
+            usage: { output_tokens: outputTokens },
+        };
+        yield { type: 'message_stop' };
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/providers/web-bridge/provider.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/providers/web-bridge/provider.ts"],"names":[],"mappings":"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"}

package/dist/providers/web-bridge/shared/BrowserSession.d.ts ADDED Viewed

@@ -0,0 +1,51 @@
+/**
+ * Persistent Chromium session wrapper.
+ *
+ * Holds the cookies, localStorage, and IndexedDB of a chat service across
+ * invocations, so the user only logs in once. Toggleable headless mode lets
+ * the same userDataDir serve a visible browser during login flows and a
+ * background browser during day-to-day prompts.
+ *
+ * One BrowserSession owns ONE BrowserContext and ONE Page. We don't need
+ * multiple pages — each chat service uses a single tab.
+ */
+import { type Page } from 'playwright';
+export interface BrowserSessionOptions {
+    /** Directory for persistent profile (cookies, etc). Must be writable. */
+    userDataDir: string;
+    /** Default headless. Can be toggled later via .restart(). */
+    headless?: boolean;
+    /** Viewport. Match a common laptop default. */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Custom user agent. When omitted, Playwright's default is used. */
+    userAgent?: string;
+    /** Locale and timezone — match a real machine to avoid trivial fingerprints. */
+    locale?: string;
+    timezoneId?: string;
+    /** Extra launch args passed to Chromium. */
+    extraArgs?: string[];
+}
+export declare class BrowserSession {
+    private opts;
+    private context?;
+    private page?;
+    private currentHeadless;
+    constructor(opts: BrowserSessionOptions);
+    get isOpen(): boolean;
+    get headless(): boolean;
+    /**
+     * Open the persistent context (if not already open) and return a page at
+     * `url`. If a page is already open on a matching origin, it's reused.
+     */
+    ensurePage(url: string): Promise<Page>;
+    /**
+     * Switch headless on/off. Requires a full restart since Chromium can't
+     * change modes mid-flight. Persistent data survives.
+     */
+    restart(headless: boolean): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=BrowserSession.d.ts.map

package/dist/providers/web-bridge/shared/BrowserSession.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"BrowserSession.d.ts","sourceRoot":"","sources":["../../../../src/providers/web-bridge/shared/BrowserSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAiC,KAAK,IAAI,EAAE,MAAM,YAAY,CAAA;AAErE,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,qBAAa,cAAc;IAKb,OAAO,CAAC,IAAI;IAJxB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,IAAI,CAAC,CAAM;IACnB,OAAO,CAAC,eAAe,CAAS;gBAEZ,IAAI,EAAE,qBAAqB;IAI/C,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5C;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}

package/dist/providers/web-bridge/shared/BrowserSession.js ADDED Viewed

@@ -0,0 +1,88 @@
+/**
+ * Persistent Chromium session wrapper.
+ *
+ * Holds the cookies, localStorage, and IndexedDB of a chat service across
+ * invocations, so the user only logs in once. Toggleable headless mode lets
+ * the same userDataDir serve a visible browser during login flows and a
+ * background browser during day-to-day prompts.
+ *
+ * One BrowserSession owns ONE BrowserContext and ONE Page. We don't need
+ * multiple pages — each chat service uses a single tab.
+ */
+import { mkdir } from 'node:fs/promises';
+import { chromium } from 'playwright';
+export class BrowserSession {
+    opts;
+    context;
+    page;
+    currentHeadless;
+    constructor(opts) {
+        this.opts = opts;
+        this.currentHeadless = opts.headless ?? true;
+    }
+    get isOpen() {
+        return !!this.page && !this.page.isClosed();
+    }
+    get headless() {
+        return this.currentHeadless;
+    }
+    /**
+     * Open the persistent context (if not already open) and return a page at
+     * `url`. If a page is already open on a matching origin, it's reused.
+     */
+    async ensurePage(url) {
+        if (this.page && !this.page.isClosed()) {
+            // Reuse only if origin matches — otherwise navigate.
+            if (!sameOrigin(this.page.url(), url)) {
+                await this.page.goto(url, { waitUntil: 'domcontentloaded' });
+            }
+            return this.page;
+        }
+        await mkdir(this.opts.userDataDir, { recursive: true });
+        this.context = await chromium.launchPersistentContext(this.opts.userDataDir, {
+            headless: this.currentHeadless,
+            viewport: this.opts.viewport ?? { width: 1280, height: 800 },
+            userAgent: this.opts.userAgent,
+            locale: this.opts.locale,
+            timezoneId: this.opts.timezoneId,
+            args: this.opts.extraArgs,
+        });
+        // launchPersistentContext gives back a context that may or may not have a
+        // default page depending on platform — be tolerant.
+        this.page = this.context.pages()[0] ?? (await this.context.newPage());
+        if (!sameOrigin(this.page.url(), url)) {
+            await this.page.goto(url, { waitUntil: 'domcontentloaded' });
+        }
+        return this.page;
+    }
+    /**
+     * Switch headless on/off. Requires a full restart since Chromium can't
+     * change modes mid-flight. Persistent data survives.
+     */
+    async restart(headless) {
+        if (this.currentHeadless === headless && this.isOpen)
+            return;
+        await this.close();
+        this.currentHeadless = headless;
+        // Next ensurePage() will relaunch.
+    }
+    async close() {
+        try {
+            await this.context?.close();
+        }
+        catch {
+            // Context may already be torn down; ignore.
+        }
+        this.context = undefined;
+        this.page = undefined;
+    }
+}
+function sameOrigin(current, target) {
+    try {
+        return new URL(current).origin === new URL(target).origin;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=BrowserSession.js.map