agentfootprint 1.23.0 → 2.1.0

package/dist/adapters/llm/BrowserOpenAIProvider.js

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * BrowserOpenAIProvider — fetch-based OpenAI adapter for browsers.
+ *
+ * Pattern: Adapter (GoF). Zero peer dependencies — uses global `fetch`.
+ * Role:    Outer ring. Same `LLMProvider` contract as `OpenAIProvider`
+ *          but skips the `openai` SDK. For prototypes / playgrounds.
+ *          Production apps should proxy through a backend.
+ * Emits:   N/A.
+ *
+ * Also works with OpenAI-compatible endpoints (Ollama, Together, vLLM)
+ * via `apiUrl`.
+ *
+ * ─── 7-panel review ─────────────────────────────────────────────────
+ *
+ *   Same posture as `BrowserAnthropicProvider`: native fetch, SSE
+ *   parser, stateless, error-wrapped, message-conversion mirrors the
+ *   Node `OpenAIProvider`. See that adapter's review for full rubric.
+ *
+ * ─── Limitations ────────────────────────────────────────────────────
+ *
+ * • Multi-modal NOT .
+ * • CORS depends on the endpoint — OpenAI requires the user-supplied
+ *   key in the Authorization header, which they'll do explicitly.
+ *
+ * ─── 7-pattern test coverage ────────────────────────────────────────
+ *
+ *   See `test/adapters/unit/BrowserOpenAIProvider.test.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserOpenAIProvider = exports.browserOpenai = void 0;
+const OPENAI_API_URL = 'https://api.openai.com/v1/chat/completions';
+function browserOpenai(options) {
+    if (!options.apiKey) {
+        throw new Error('BrowserOpenAIProvider requires `apiKey`. Browser providers do not read environment variables.');
+    }
+    const apiUrl = options.apiUrl ?? OPENAI_API_URL;
+    const defaultModel = options.defaultModel ?? 'gpt-4o-mini';
+    const defaultMaxTokens = options.defaultMaxTokens;
+    const fetchImpl = options._fetch ?? fetch;
+    const headers = {
+        'content-type': 'application/json',
+        authorization: `Bearer ${options.apiKey}`,
+    };
+    if (options.organization)
+        headers['openai-organization'] = options.organization;
+    const provider = {
+        name: 'browser-openai',
+        async complete(req) {
+            const body = buildBody(req, defaultModel, defaultMaxTokens, false);
+            let response;
+            try {
+                response = await fetchImpl(apiUrl, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    ...(req.signal && { signal: req.signal }),
+                });
+            }
+            catch (err) {
+                throw wrapError(err);
+            }
+            if (!response.ok)
+                throw await wrapStatus(response);
+            const json = (await response.json());
+            return fromOpenAIResponse(json);
+        },
+        async *stream(req) {
+            const body = buildBody(req, defaultModel, defaultMaxTokens, true);
+            let response;
+            try {
+                response = await fetchImpl(apiUrl, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    ...(req.signal && { signal: req.signal }),
+                });
+            }
+            catch (err) {
+                throw wrapError(err);
+            }
+            if (!response.ok)
+                throw await wrapStatus(response);
+            if (!response.body)
+                throw new Error('[browser-openai] response has no body');
+            const textParts = [];
+            const toolCallsByIndex = new Map();
+            let lastFinishReason = 'stop';
+            let lastUsage;
+            let lastId = '';
+            let tokenIndex = 0;
+            for await (const data of parseSSE(response.body)) {
+                if (data === '[DONE]')
+                    break;
+                const chunk = data;
+                const choice = chunk.choices[0];
+                if (!choice)
+                    continue;
+                if (chunk.id)
+                    lastId = chunk.id;
+                if (chunk.usage)
+                    lastUsage = chunk.usage;
+                if (choice.finish_reason)
+                    lastFinishReason = choice.finish_reason;
+                const delta = choice.delta;
+                if (delta.content) {
+                    textParts.push(delta.content);
+                    yield { tokenIndex, content: delta.content, done: false };
+                    tokenIndex++;
+                }
+                if (delta.tool_calls) {
+                    for (const tcDelta of delta.tool_calls) {
+                        const idx = tcDelta.index;
+                        const existing = toolCallsByIndex.get(idx) ?? { id: '', name: '', argsJson: '' };
+                        if (tcDelta.id)
+                            existing.id = tcDelta.id;
+                        if (tcDelta.function?.name)
+                            existing.name = tcDelta.function.name;
+                        if (tcDelta.function?.arguments)
+                            existing.argsJson += tcDelta.function.arguments;
+                        toolCallsByIndex.set(idx, existing);
+                    }
+                }
+            }
+            const toolCalls = Array.from(toolCallsByIndex.values()).map((tc) => ({
+                id: tc.id,
+                name: tc.name,
+                args: parseArgs(tc.argsJson),
+            }));
+            const finalResponse = {
+                content: textParts.join(''),
+                toolCalls,
+                usage: {
+                    input: lastUsage?.prompt_tokens ?? 0,
+                    output: lastUsage?.completion_tokens ?? 0,
+                },
+                stopReason: normalizeStopReason(lastFinishReason),
+                providerRef: lastId,
+            };
+            yield { tokenIndex, content: '', done: true, response: finalResponse };
+        },
+    };
+    return provider;
+}
+exports.browserOpenai = browserOpenai;
+class BrowserOpenAIProvider {
+    name = 'browser-openai';
+    inner;
+    constructor(options) {
+        this.inner = browserOpenai(options);
+    }
+    complete(req) {
+        return this.inner.complete(req);
+    }
+    stream(req) {
+        if (!this.inner.stream)
+            throw new Error('stream() unavailable');
+        return this.inner.stream(req);
+    }
+}
+exports.BrowserOpenAIProvider = BrowserOpenAIProvider;
+// ─── Internals ──────────────────────────────────────────────────────
+function buildBody(req, defaultModel, defaultMaxTokens, stream) {
+    const body = {
+        model: req.model === 'openai' || req.model === 'browser-openai' ? defaultModel : req.model,
+        messages: toOpenAIMessages(req.messages, req.systemPrompt),
+    };
+    if (stream)
+        body.stream = true;
+    if (req.tools && req.tools.length > 0)
+        body.tools = req.tools.map(toOpenAITool);
+    const max = req.maxTokens ?? defaultMaxTokens;
+    if (max !== undefined)
+        body.max_tokens = max;
+    if (req.temperature !== undefined)
+        body.temperature = req.temperature;
+    if (req.stop && req.stop.length > 0)
+        body.stop = [...req.stop];
+    return body;
+}
+function toOpenAIMessages(messages, systemPrompt) {
+    const result = [];
+    if (systemPrompt)
+        result.push({ role: 'system', content: systemPrompt });
+    for (const m of messages) {
+        if (m.role === 'system') {
+            result.push({ role: 'system', content: m.content });
+            continue;
+        }
+        if (m.role === 'user') {
+            result.push({ role: 'user', content: m.content });
+            continue;
+        }
+        if (m.role === 'assistant') {
+            const msg = { role: 'assistant', content: m.content || null };
+            if (m.toolCalls && m.toolCalls.length > 0) {
+                msg.tool_calls = m.toolCalls.map((tc) => ({
+                    id: tc.id,
+                    type: 'function',
+                    function: { name: tc.name, arguments: JSON.stringify(tc.args) },
+                }));
+            }
+            result.push(msg);
+            continue;
+        }
+        if (m.role === 'tool') {
+            result.push({
+                role: 'tool',
+                content: m.content,
+                tool_call_id: m.toolCallId ?? '',
+            });
+            continue;
+        }
+    }
+    return result;
+}
+function toOpenAITool(schema) {
+    return {
+        type: 'function',
+        function: {
+            name: schema.name,
+            description: schema.description,
+            parameters: { ...schema.inputSchema },
+        },
+    };
+}
+function fromOpenAIResponse(response) {
+    const choice = response.choices[0];
+    if (!choice)
+        throw new Error('[browser-openai] response missing choices[0]');
+    const message = choice.message;
+    const toolCalls = (message.tool_calls ?? []).map((tc) => ({
+        id: tc.id,
+        name: tc.function.name,
+        args: parseArgs(tc.function.arguments),
+    }));
+    return {
+        content: message.content ?? '',
+        toolCalls,
+        usage: {
+            input: response.usage?.prompt_tokens ?? 0,
+            output: response.usage?.completion_tokens ?? 0,
+        },
+        stopReason: normalizeStopReason(choice.finish_reason),
+        providerRef: response.id,
+    };
+}
+function parseArgs(json) {
+    if (!json)
+        return {};
+    try {
+        const parsed = JSON.parse(json);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function normalizeStopReason(raw) {
+    switch (raw) {
+        case 'stop':
+            return 'stop';
+        case 'tool_calls':
+            return 'tool_use';
+        case 'length':
+            return 'max_tokens';
+        case 'content_filter':
+            return 'content_filter';
+        default:
+            return raw;
+    }
+}
+/** Parse OpenAI's SSE stream — `data: ...\n\n` lines, `[DONE]` terminator. */
+async function* parseSSE(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buf = '';
+    try {
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let idx;
+            while ((idx = buf.indexOf('\n\n')) >= 0) {
+                const raw = buf.slice(0, idx);
+                buf = buf.slice(idx + 2);
+                for (const line of raw.split('\n')) {
+                    if (!line.startsWith('data:'))
+                        continue;
+                    const data = line.slice(5).trim();
+                    if (data === '[DONE]') {
+                        yield '[DONE]';
+                        return;
+                    }
+                    if (data) {
+                        try {
+                            yield JSON.parse(data);
+                        }
+                        catch {
+                            /* skip malformed */
+                        }
+                    }
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+async function wrapStatus(response) {
+    let bodyText = '';
+    try {
+        bodyText = await response.text();
+    }
+    catch {
+        /* ignore */
+    }
+    return Object.assign(new Error(`[browser-openai] ${response.status} ${response.statusText} — ${bodyText.slice(0, 200)}`), { name: 'BrowserOpenAIProviderError', status: response.status });
+}
+function wrapError(err) {
+    if (err instanceof Error) {
+        return Object.assign(new Error(`[browser-openai] ${err.message}`), {
+            name: 'BrowserOpenAIProviderError',
+            cause: err,
+        });
+    }
+    return new Error(`[browser-openai] ${String(err)}`);
+}
+//# sourceMappingURL=BrowserOpenAIProvider.js.map

package/dist/adapters/llm/BrowserOpenAIProvider.js.map

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

package/dist/adapters/llm/MockProvider.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * MockProvider — deterministic LLMProvider for tests + examples.
+ *
+ * Pattern: Adapter (GoF, Design Patterns ch. 4).
+ * Role:    Ports-and-Adapters outer ring (Cockburn, 2005) — implements the
+ *          LLMProvider port without calling out to a real LLM service.
+ * Emits:   N/A (adapters don't emit; recorders observe them).
+ *
+ * Two modes, same provider:
+ *   • DEFAULT (no latency options)  — instant `complete()`, no streaming.
+ *     Use in unit tests; behavior unchanged from earlier revisions.
+ *   • REALISTIC (`thinkingMs` set)  — randomised "thinking" latency before
+ *     the response, plus a `stream()` implementation that emits the
+ *     content word-by-word with `chunkDelayMs` between chunks. Lets
+ *     consumers SEE the run unfold (pauses, streaming tokens, tool
+ *     dispatch) instead of having every step finish in microseconds.
+ *
+ * Realistic mode is the right default for the playground / Lens demos:
+ * a real OpenAI / Anthropic call takes 3–8 s, so the UX you build for
+ * that timing is what matters. Use `MockProvider.realistic()` for the
+ * common 3–8 s thinking + 30–80 ms per word streaming preset.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mock = exports.MockProvider = void 0;
+class MockProvider {
+    name;
+    reply;
+    respond;
+    thinkingMs;
+    chunkDelayMs;
+    stopReason;
+    usageOverride;
+    constructor(options = {}) {
+        this.name = options.name ?? 'mock';
+        this.reply = options.reply;
+        this.respond =
+            options.respond ??
+                ((req) => {
+                    const lastUser = [...req.messages].reverse().find((m) => m.role === 'user');
+                    return lastUser ? `echo: ${lastUser.content}` : '';
+                });
+        // `delayMs` is kept as an alias of `thinkingMs` for back-compat.
+        this.thinkingMs = options.thinkingMs ?? options.delayMs ?? 0;
+        this.chunkDelayMs = options.chunkDelayMs ?? 30;
+        this.stopReason = options.stopReason ?? 'stop';
+        this.usageOverride = options.usage;
+    }
+    /**
+     * Convenience factory for the playground / Lens demo defaults: a
+     * real-feel mock with 3–8 s of "thinking" before the response and
+     * 30–80 ms per streamed word. Lets users observe pause/resume,
+     * streaming, and tool dispatch happening live without hitting a
+     * paid API.
+     */
+    static realistic(options = {}) {
+        return new MockProvider({
+            thinkingMs: [3000, 8000],
+            chunkDelayMs: [30, 80],
+            ...options,
+        });
+    }
+    async complete(req) {
+        await sleep(pickMs(this.thinkingMs), req.signal);
+        return this.buildResponse(req);
+    }
+    /**
+     * Streaming mode — emits the response content word-by-word so
+     * consumers (Lens commentary, chat UIs) can render tokens as they
+     * arrive. Tool calls land all at once on the final chunk because
+     * that is how real providers (OpenAI, Anthropic) deliver them too.
+     */
+    async *stream(req) {
+        await sleep(pickMs(this.thinkingMs), req.signal);
+        const response = this.buildResponse(req);
+        const tokens = tokenizeWords(response.content);
+        let tokenIndex = 0;
+        for (const tok of tokens) {
+            yield { tokenIndex: tokenIndex++, content: tok, done: false };
+            // Inter-chunk delay AFTER yielding so the first token shows up
+            // immediately once thinking is done — matches OpenAI's pattern.
+            await sleep(pickMs(this.chunkDelayMs), req.signal);
+        }
+        // Final chunk carries the authoritative LLMResponse (toolCalls,
+        // usage, stopReason). Agent uses this to drive the ReAct loop
+        // without needing a separate `complete()` round-trip. Real
+        // streaming providers (Anthropic SSE, OpenAI delta) deliver
+        // tool_use deltas across chunks; we collapse to the terminal-chunk
+        // shape here because it's the simplest contract that lets one
+        // call serve both UI streaming AND ReAct decisioning.
+        yield { tokenIndex, content: '', done: true, response };
+    }
+    buildResponse(req) {
+        const raw = this.reply !== undefined ? this.reply : this.respond(req);
+        const partial = typeof raw === 'string' ? { content: raw } : raw;
+        const content = partial.content ?? '';
+        const toolCalls = partial.toolCalls ?? [];
+        const inputChars = messagesChars(req.messages) + (req.systemPrompt?.length ?? 0);
+        const outputChars = content.length;
+        return {
+            content,
+            toolCalls,
+            usage: partial.usage ?? {
+                input: this.usageOverride?.input ?? Math.ceil(inputChars / 4),
+                output: this.usageOverride?.output ?? Math.ceil(outputChars / 4),
+                ...(this.usageOverride?.cacheRead !== undefined && {
+                    cacheRead: this.usageOverride.cacheRead,
+                }),
+                ...(this.usageOverride?.cacheWrite !== undefined && {
+                    cacheWrite: this.usageOverride.cacheWrite,
+                }),
+            },
+            stopReason: partial.stopReason ?? (toolCalls.length > 0 ? 'tool_use' : this.stopReason),
+        };
+    }
+}
+exports.MockProvider = MockProvider;
+/**
+ * Lowercase factory for `MockProvider` — matches the v1 `mock()` import
+ * shape so docs and quick-starts stay copy-pasteable. Equivalent to
+ * `new MockProvider(options)`.
+ *
+ * @example
+ *   import { Agent, mock, defineTool } from 'agentfootprint';
+ *
+ *   const agent = Agent.create({ provider: mock({ reply: 'hello' }) })
+ *     .tool(defineTool({ name: 'echo', ... }))
+ *     .build();
+ */
+function mock(options = {}) {
+    return new MockProvider(options);
+}
+exports.mock = mock;
+// ── Helpers ─────────────────────────────────────────────────────────
+/** Pick a delay in ms — fixed when given a number, uniformly random
+ *  when given a `[min, max]` tuple. */
+function pickMs(spec) {
+    if (typeof spec === 'number')
+        return Math.max(0, spec);
+    const [min, max] = spec;
+    if (max <= min)
+        return Math.max(0, min);
+    return Math.floor(min + Math.random() * (max - min));
+}
+/** AbortSignal-aware sleep. Resolves on timeout OR rejects on abort. */
+function sleep(ms, signal) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason ?? new Error('Aborted'));
+            return;
+        }
+        const id = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(id);
+            reject(signal.reason ?? new Error('Aborted'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** Split content into streamable units that read like real tokens —
+ *  whitespace-preserving word chunks. Empty content yields zero chunks. */
+function tokenizeWords(content) {
+    if (content.length === 0)
+        return [];
+    // Split on whitespace, preserve the delimiter so concatenating the
+    // chunks reconstructs the original string exactly.
+    const out = [];
+    for (const m of content.matchAll(/\S+\s*/g))
+        out.push(m[0]);
+    // Edge case: leading whitespace before the first word.
+    const firstNonSpace = content.search(/\S/);
+    if (firstNonSpace > 0)
+        out.unshift(content.slice(0, firstNonSpace));
+    return out;
+}
+function messagesChars(messages) {
+    let n = 0;
+    for (const m of messages)
+        n += m.content.length;
+    return n;
+}
+//# sourceMappingURL=MockProvider.js.map

package/dist/adapters/llm/MockProvider.js.map

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