modeldispatcher-browser-agent 0.6.0

package/dist/externalChat.js

@@ -0,0 +1,86 @@
+/**
+ * "Free agent" escape hatch: hand a question off to a free, public AI chat
+ * web product instead of calling any API. For a BYOK app, this is what a
+ * user with no API key configured (or who just doesn't want to set one up)
+ * falls back to — open one of the well-known consumer chat products in a new
+ * tab, with the question pre-filled where the product supports it.
+ *
+ * The query-prefill URL parameters below are undocumented, reverse-engineered
+ * conventions (the kind of thing browser address-bar integrations and
+ * "Ask X" share links rely on) — not a stable public API any vendor promises
+ * to keep working, and they can change or disappear without notice. Treat
+ * them as best-effort: `openExternalChat` always copies the question to the
+ * clipboard too, regardless of whether a prefill parameter exists, so a
+ * broken/removed parameter still leaves the user able to paste it in by hand
+ * instead of silently losing their question.
+ */
+export const EXTERNAL_CHAT_PROVIDERS = {
+    chatgpt: {
+        id: "chatgpt",
+        name: "ChatGPT",
+        homeUrl: "https://chatgpt.com/",
+        buildUrl: (question) => `https://chatgpt.com/?${new URLSearchParams({ q: question, hints: "search" })}`,
+    },
+    claude: {
+        id: "claude",
+        name: "Claude",
+        homeUrl: "https://claude.ai/new",
+        buildUrl: (question) => `https://claude.ai/new?${new URLSearchParams({ q: question })}`,
+    },
+    gemini: {
+        id: "gemini",
+        name: "Gemini (Google AI Mode)",
+        homeUrl: "https://www.google.com/",
+        // gemini.google.com itself has no known prefill parameter. Google
+        // Search's AI Mode does (`udm=50`), and is the more reliable target for
+        // "ask Google's AI this" — that's what this actually opens.
+        buildUrl: (question) => `https://www.google.com/search?${new URLSearchParams({ q: question, udm: "50" })}`,
+    },
+    groq: {
+        id: "groq",
+        name: "Groq",
+        homeUrl: "https://groq.com/",
+        // No known query-prefill parameter for Groq's consumer chat product —
+        // opens the plain homepage; the question still goes to the clipboard.
+        buildUrl: null,
+    },
+};
+function defaultOpen(url) {
+    if (typeof window === "undefined")
+        return;
+    window.open(url, "_blank", "noopener,noreferrer");
+}
+function resolveClipboard(clipboard) {
+    if (clipboard)
+        return clipboard;
+    if (typeof navigator !== "undefined" && navigator.clipboard)
+        return navigator.clipboard;
+    return undefined;
+}
+/**
+ * Open `provider`'s chat with `question`, pre-filled where a prefill
+ * parameter is known, and always copy `question` to the clipboard as well.
+ *
+ * Never throws: a clipboard failure (permissions, a non-secure context, a
+ * non-browser host) is reported via `copiedToClipboard: false` rather than
+ * rejecting, since the tab still opens either way.
+ */
+export async function openExternalChat(provider, question, deps = {}) {
+    const info = EXTERNAL_CHAT_PROVIDERS[provider];
+    const prefilled = info.buildUrl !== null;
+    const url = info.buildUrl ? info.buildUrl(question) : info.homeUrl;
+    const clipboard = resolveClipboard(deps.clipboard);
+    let copiedToClipboard = false;
+    if (clipboard) {
+        try {
+            await clipboard.writeText(question);
+            copiedToClipboard = true;
+        }
+        catch {
+            copiedToClipboard = false;
+        }
+    }
+    (deps.open ?? defaultOpen)(url);
+    return { provider, url, prefilled, copiedToClipboard };
+}
+//# sourceMappingURL=externalChat.js.map

package/dist/externalChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalChat.js","sourceRoot":"","sources":["../src/externalChat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAA6D;IAC/F,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,sBAAsB;QAC/B,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,wBAAwB,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE;KACxG;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,uBAAuB;QAChC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,yBAAyB,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;KACxF;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,yBAAyB;QAClC,kEAAkE;QAClE,wEAAwE;QACxE,4DAA4D;QAC5D,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,iCAAiC,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE;KAC3G;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,mBAAmB;QAC5B,sEAAsE;QACtE,sEAAsE;QACtE,QAAQ,EAAE,IAAI;KACf;CACF,CAAC;AAqBF,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,gBAAgB,CACvB,SAA6C;IAE7C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC,SAAS,CAAC;IACxF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgC,EAChC,QAAgB,EAChB,OAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IAEnE,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACpC,iBAAiB,GAAG,IAAI,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC;IAEhC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;AACzD,CAAC"}

package/dist/externalChatFavorite.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Persistence for a visitor's saved "ask externally" favorite.
+ *
+ * Deliberately separate from {@link ./config.js}'s `AgentConfig`
+ * (provider/key/model for BYOK dispatch): picking a favorite here means the
+ * visitor wants the app to offer opening this free chat product instead of
+ * calling any API, so it has nothing to do with which provider/key is
+ * configured for BYOK and must never be conflated with it. A settings screen
+ * showing both is choosing between two independent, saveable preferences —
+ * selecting a favorite here never itself opens anything (see
+ * {@link ./externalChat.js}'s `openExternalChat` for the action that does).
+ */
+import { type ConfigStorage } from "./config.js";
+import type { ExternalChatProviderId } from "./types.js";
+export declare const DEFAULT_EXTERNAL_CHAT_FAVORITE_KEY = "aiExternalChatFavorite";
+/** Read the saved favorite, or `null` if none is set (or the stored value is
+ * no longer a recognised provider). */
+export declare function loadExternalChatFavorite(storage?: ConfigStorage, key?: string): ExternalChatProviderId | null;
+/** Persist the favorite; pass `null` to clear it. */
+export declare function saveExternalChatFavorite(favorite: ExternalChatProviderId | null, storage?: ConfigStorage, key?: string): void;

package/dist/externalChatFavorite.js

@@ -0,0 +1,33 @@
+/**
+ * Persistence for a visitor's saved "ask externally" favorite.
+ *
+ * Deliberately separate from {@link ./config.js}'s `AgentConfig`
+ * (provider/key/model for BYOK dispatch): picking a favorite here means the
+ * visitor wants the app to offer opening this free chat product instead of
+ * calling any API, so it has nothing to do with which provider/key is
+ * configured for BYOK and must never be conflated with it. A settings screen
+ * showing both is choosing between two independent, saveable preferences —
+ * selecting a favorite here never itself opens anything (see
+ * {@link ./externalChat.js}'s `openExternalChat` for the action that does).
+ */
+import { EXTERNAL_CHAT_PROVIDERS } from "./externalChat.js";
+import { resolveStorage } from "./config.js";
+export const DEFAULT_EXTERNAL_CHAT_FAVORITE_KEY = "aiExternalChatFavorite";
+function isKnownExternalChatProvider(id) {
+    return Object.hasOwn(EXTERNAL_CHAT_PROVIDERS, id);
+}
+/** Read the saved favorite, or `null` if none is set (or the stored value is
+ * no longer a recognised provider). */
+export function loadExternalChatFavorite(storage, key = DEFAULT_EXTERNAL_CHAT_FAVORITE_KEY) {
+    const raw = resolveStorage(storage).getItem(key);
+    return raw !== null && isKnownExternalChatProvider(raw) ? raw : null;
+}
+/** Persist the favorite; pass `null` to clear it. */
+export function saveExternalChatFavorite(favorite, storage, key = DEFAULT_EXTERNAL_CHAT_FAVORITE_KEY) {
+    const store = resolveStorage(storage);
+    if (favorite === null)
+        store.removeItem(key);
+    else
+        store.setItem(key, favorite);
+}
+//# sourceMappingURL=externalChatFavorite.js.map

package/dist/externalChatFavorite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalChatFavorite.js","sourceRoot":"","sources":["../src/externalChatFavorite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AAGjE,MAAM,CAAC,MAAM,kCAAkC,GAAG,wBAAwB,CAAC;AAE3E,SAAS,2BAA2B,CAAC,EAAU;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;uCACuC;AACvC,MAAM,UAAU,wBAAwB,CACtC,OAAuB,EACvB,MAAc,kCAAkC;IAEhD,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,GAAG,KAAK,IAAI,IAAI,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,wBAAwB,CACtC,QAAuC,EACvC,OAAuB,EACvB,MAAc,kCAAkC;IAEhD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,QAAQ,KAAK,IAAI;QAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;;QACxC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/features.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Per-app opt-in/opt-out for the two things this package supplies. This is a
+ * developer/deploy-time decision made once when an app is wired up — never a
+ * switch an end user sees or controls. Both flags default to enabled, so
+ * adopting the shared framework is opt-OUT per app, not opt-in-everywhere.
+ *
+ * This package never reads environment variables itself: every bundler
+ * exposes them differently (`import.meta.env` for Vite, `process.env` for
+ * Next.js/CRA), so resolving env vars is left to each app's own config
+ * module, which passes the result in as `overrides`.
+ */
+/** Which parts of the shared framework this app has enabled. */
+export interface DispatcherFeatureFlags {
+    /** Render `<ModelPicker>`/`<AskExternallyButton>`, or this app's own settings UI. */
+    readonly ui: boolean;
+    /** Route AI calls through `complete()`/`streamComplete()`'s fallback dispatch,
+     * or this app's own existing call path. */
+    readonly dispatch: boolean;
+}
+/** Both features enabled — the framework's out-of-the-box behavior. */
+export declare const DEFAULT_DISPATCHER_FEATURES: DispatcherFeatureFlags;
+/**
+ * Resolves the effective feature flags for this app: enabled-by-default,
+ * merged with whatever this app's own config module decided to override.
+ *
+ * Call this once at your app's own composition root and pass the result down
+ * to wherever the UI/dispatch branching actually happens — see
+ * `docs/USAGE.md` for the full pattern.
+ */
+export declare function resolveDispatcherFeatures(overrides?: Partial<DispatcherFeatureFlags>): DispatcherFeatureFlags;

package/dist/features.js

@@ -0,0 +1,28 @@
+/**
+ * Per-app opt-in/opt-out for the two things this package supplies. This is a
+ * developer/deploy-time decision made once when an app is wired up — never a
+ * switch an end user sees or controls. Both flags default to enabled, so
+ * adopting the shared framework is opt-OUT per app, not opt-in-everywhere.
+ *
+ * This package never reads environment variables itself: every bundler
+ * exposes them differently (`import.meta.env` for Vite, `process.env` for
+ * Next.js/CRA), so resolving env vars is left to each app's own config
+ * module, which passes the result in as `overrides`.
+ */
+/** Both features enabled — the framework's out-of-the-box behavior. */
+export const DEFAULT_DISPATCHER_FEATURES = Object.freeze({
+    ui: true,
+    dispatch: true,
+});
+/**
+ * Resolves the effective feature flags for this app: enabled-by-default,
+ * merged with whatever this app's own config module decided to override.
+ *
+ * Call this once at your app's own composition root and pass the result down
+ * to wherever the UI/dispatch branching actually happens — see
+ * `docs/USAGE.md` for the full pattern.
+ */
+export function resolveDispatcherFeatures(overrides) {
+    return { ...DEFAULT_DISPATCHER_FEATURES, ...overrides };
+}
+//# sourceMappingURL=features.js.map

package/dist/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,uEAAuE;AACvE,MAAM,CAAC,MAAM,2BAA2B,GAA2B,MAAM,CAAC,MAAM,CAAC;IAC/E,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,IAAI;CACf,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAA2C;IAE3C,OAAO,EAAE,GAAG,2BAA2B,EAAE,GAAG,SAAS,EAAE,CAAC;AAC1D,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared HTTP plumbing every provider call needs: a request timeout merged
+ * with the caller's own AbortSignal, one retry on a transient (429/5xx)
+ * failure, Ollama URL validation, and a line-buffered stream reader so each
+ * provider's stream parser only has to know its own line format.
+ */
+export declare const DEFAULT_TIMEOUT_MS = 60000;
+/** A hung provider (dropped connection, stalled proxy) would otherwise hang
+ * forever — fetch() has no default timeout. Merges an optional caller signal
+ * (e.g. "abort because the component unmounted") with a hard ceiling. */
+export declare function requestSignal(signal?: AbortSignal, timeoutMs?: number): AbortSignal;
+/**
+ * fetch() with one retry on a 429/5xx or a network failure. An
+ * externally-aborted request (unmount, a newer request superseding this
+ * one) is never retried — that's a deliberate cancellation, not a
+ * transient failure, and retrying it would just start a request nobody
+ * wants the result of anymore.
+ */
+export declare function fetchWithRetry(url: string, init: RequestInit, externalSignal?: AbortSignal, timeoutMs?: number): Promise<Response>;
+/** Reject a remote Ollama URL that isn't HTTPS (localhost is exempt — that's
+ * the whole point of running it locally). Returns the normalised origin. */
+export declare function validateOllamaUrl(url: string): string;
+/** Feeds each complete line of a streamed response body to `onLine`, so
+ * every provider's stream parser only needs to know its own line format
+ * (SSE "data: " frames vs. bare NDJSON). */
+export declare function consumeLines(res: Response, onLine: (line: string) => void): Promise<void>;
+/** Extract a provider's error message from a JSON error body, falling back
+ * to the raw HTTP status when the body isn't shaped as expected. */
+export declare function describeHttpError(res: Response): Promise<string>;

package/dist/http.js

@@ -0,0 +1,91 @@
+/**
+ * Shared HTTP plumbing every provider call needs: a request timeout merged
+ * with the caller's own AbortSignal, one retry on a transient (429/5xx)
+ * failure, Ollama URL validation, and a line-buffered stream reader so each
+ * provider's stream parser only has to know its own line format.
+ */
+export const DEFAULT_TIMEOUT_MS = 60_000;
+const RETRY_DELAY_MS = 600;
+/** A hung provider (dropped connection, stalled proxy) would otherwise hang
+ * forever — fetch() has no default timeout. Merges an optional caller signal
+ * (e.g. "abort because the component unmounted") with a hard ceiling. */
+export function requestSignal(signal, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const timeoutSignal = AbortSignal.timeout(timeoutMs);
+    return signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+}
+function isRetryableStatus(status) {
+    return status === 429 || (status >= 500 && status < 600);
+}
+/**
+ * fetch() with one retry on a 429/5xx or a network failure. An
+ * externally-aborted request (unmount, a newer request superseding this
+ * one) is never retried — that's a deliberate cancellation, not a
+ * transient failure, and retrying it would just start a request nobody
+ * wants the result of anymore.
+ */
+export async function fetchWithRetry(url, init, externalSignal, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    for (let attempt = 0;; attempt++) {
+        try {
+            const res = await fetch(url, { ...init, signal: requestSignal(externalSignal, timeoutMs) });
+            if (attempt === 0 && isRetryableStatus(res.status)) {
+                await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+                continue;
+            }
+            return res;
+        }
+        catch (err) {
+            if (externalSignal?.aborted || attempt > 0)
+                throw err;
+            await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+        }
+    }
+}
+/** Reject a remote Ollama URL that isn't HTTPS (localhost is exempt — that's
+ * the whole point of running it locally). Returns the normalised origin. */
+export function validateOllamaUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch (err) {
+        throw new Error(`Invalid Ollama URL: ${err.message}`, { cause: err });
+    }
+    const isLocalhost = ["localhost", "127.0.0.1", "::1"].includes(parsed.hostname);
+    if (!isLocalhost && parsed.protocol !== "https:") {
+        throw new Error("Remote Ollama must use HTTPS. For local testing, use http://localhost:11434");
+    }
+    return parsed.origin;
+}
+/** A 200 with no body (adblocker, misbehaving proxy) would otherwise throw a
+ * raw TypeError on getReader() deep inside the parser. */
+function getBodyReader(res) {
+    if (!res.body)
+        throw new Error("Empty response body from AI provider.");
+    return res.body.getReader();
+}
+/** Feeds each complete line of a streamed response body to `onLine`, so
+ * every provider's stream parser only needs to know its own line format
+ * (SSE "data: " frames vs. bare NDJSON). */
+export async function consumeLines(res, onLine) {
+    const reader = getBodyReader(res);
+    const decoder = new TextDecoder();
+    let buffer = "";
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines)
+            onLine(line);
+    }
+}
+/** Extract a provider's error message from a JSON error body, falling back
+ * to the raw HTTP status when the body isn't shaped as expected. */
+export async function describeHttpError(res) {
+    const body = await res.json().catch(() => ({}));
+    const message = body?.error?.message;
+    return message ?? `HTTP ${res.status}`;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * modeldispatcher-browser-agent — public API surface.
+ *
+ * A browser-native, bring-your-own-key AI agent core: the client-side
+ * sibling to `model-dispatcher` for apps with no backend to run the Python
+ * gateway on. Talks directly to Gemini/OpenAI/Anthropic/Groq/Ollama from the
+ * browser, using whatever key the end user supplies — no vendor SDK, no
+ * server, nothing sent anywhere but the provider itself.
+ */
+export { AllProvidersExhaustedError, complete, NoProviderConfiguredError, streamChat, streamComplete, } from "./agent.js";
+export { clearConfig, DEFAULT_CONFIG_KEYS, isConfigReady, isProviderConfigured, loadConfig, resolveStorage, saveConfig, } from "./config.js";
+export type { ConfigKeys, ConfigStorage } from "./config.js";
+export { DEFAULT_TIMEOUT_MS, describeHttpError, validateOllamaUrl } from "./http.js";
+export { EXTERNAL_CHAT_PROVIDERS, openExternalChat } from "./externalChat.js";
+export type { OpenExternalChatDeps, OpenExternalChatResult } from "./externalChat.js";
+export { DEFAULT_EXTERNAL_CHAT_FAVORITE_KEY, loadExternalChatFavorite, saveExternalChatFavorite, } from "./externalChatFavorite.js";
+export { DEFAULT_DISPATCHER_FEATURES, resolveDispatcherFeatures } from "./features.js";
+export type { DispatcherFeatureFlags } from "./features.js";
+export { buildMessages } from "./messages.js";
+export type { BuildMessagesOptions } from "./messages.js";
+export { isKnownProvider, modelOptionsFor, MODEL_OPTIONS, PROVIDERS } from "./registry.js";
+export type { AgentConfig, ChatMessage, ChatRole, ExternalChatProviderId, ExternalChatProviderInfo, ProviderCredential, ProviderId, ProviderInfo, RequestOptions, StreamOptions, } from "./types.js";

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * modeldispatcher-browser-agent — public API surface.
+ *
+ * A browser-native, bring-your-own-key AI agent core: the client-side
+ * sibling to `model-dispatcher` for apps with no backend to run the Python
+ * gateway on. Talks directly to Gemini/OpenAI/Anthropic/Groq/Ollama from the
+ * browser, using whatever key the end user supplies — no vendor SDK, no
+ * server, nothing sent anywhere but the provider itself.
+ */
+export { AllProvidersExhaustedError, complete, NoProviderConfiguredError, streamChat, streamComplete, } from "./agent.js";
+export { clearConfig, DEFAULT_CONFIG_KEYS, isConfigReady, isProviderConfigured, loadConfig, resolveStorage, saveConfig, } from "./config.js";
+export { DEFAULT_TIMEOUT_MS, describeHttpError, validateOllamaUrl } from "./http.js";
+export { EXTERNAL_CHAT_PROVIDERS, openExternalChat } from "./externalChat.js";
+export { DEFAULT_EXTERNAL_CHAT_FAVORITE_KEY, loadExternalChatFavorite, saveExternalChatFavorite, } from "./externalChatFavorite.js";
+export { DEFAULT_DISPATCHER_FEATURES, resolveDispatcherFeatures } from "./features.js";
+export { buildMessages } from "./messages.js";
+export { isKnownProvider, modelOptionsFor, MODEL_OPTIONS, PROVIDERS } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,0BAA0B,EAC1B,QAAQ,EACR,yBAAyB,EACzB,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EACL,kCAAkC,EAClC,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Normalise a UI's chat history into a provider-safe message list: strict
+ * role validation, length capping, and merging consecutive same-role
+ * messages — Anthropic and Gemini both require strict user/assistant
+ * alternation starting with "user", which raw UI state doesn't guarantee.
+ */
+import type { ChatMessage } from "./types.js";
+export interface BuildMessagesOptions {
+    /** If true, always append a trailing filler user turn (e.g. to kick off a
+     * greeting flow) instead of only when the history would otherwise start
+     * with "assistant". */
+    forceTrailingFiller?: boolean;
+    /** The filler turn's content when one is needed to satisfy user-first
+     * ordering. Defaults to "begin". */
+    fillerContent?: string;
+    /** Marker content to drop entirely rather than treat as a real turn
+     * (e.g. a UI-internal "simulate opening" sentinel). */
+    dropContent?: string;
+}
+/**
+ * Build a provider-safe chat history from UI messages: validates/coerces
+ * roles, caps message length, drops sentinel content, ensures user-first
+ * ordering, and merges consecutive same-role turns (required by
+ * Anthropic/Gemini's strict alternation).
+ */
+export declare function buildMessages(uiMessages: readonly ChatMessage[], options?: BuildMessagesOptions): ChatMessage[];

package/dist/messages.js

@@ -0,0 +1,41 @@
+/**
+ * Normalise a UI's chat history into a provider-safe message list: strict
+ * role validation, length capping, and merging consecutive same-role
+ * messages — Anthropic and Gemini both require strict user/assistant
+ * alternation starting with "user", which raw UI state doesn't guarantee.
+ */
+const VALID_TURN_ROLES = new Set(["user", "assistant"]);
+const MAX_MESSAGE_LENGTH = 4000;
+/**
+ * Build a provider-safe chat history from UI messages: validates/coerces
+ * roles, caps message length, drops sentinel content, ensures user-first
+ * ordering, and merges consecutive same-role turns (required by
+ * Anthropic/Gemini's strict alternation).
+ */
+export function buildMessages(uiMessages, options = {}) {
+    const { forceTrailingFiller = false, fillerContent = "begin", dropContent } = options;
+    let messages = uiMessages
+        .map(({ role, content }) => ({
+        role: VALID_TURN_ROLES.has(role) ? role : "user",
+        content: String(content ?? "").trim().slice(0, MAX_MESSAGE_LENGTH),
+    }))
+        .filter((m) => m.content.length > 0 && (dropContent === undefined || m.content !== dropContent));
+    if (forceTrailingFiller) {
+        messages = [...messages, { role: "user", content: fillerContent }];
+    }
+    else if (messages.length > 0 && messages[0]?.role === "assistant") {
+        messages = [{ role: "user", content: fillerContent }, ...messages];
+    }
+    const merged = [];
+    for (const message of messages) {
+        const last = merged.at(-1);
+        if (last && last.role === message.role) {
+            merged[merged.length - 1] = { role: last.role, content: `${last.content}\n\n${message.content}` };
+        }
+        else {
+            merged.push(message);
+        }
+    }
+    return merged.length > 0 ? merged : [{ role: "user", content: fillerContent }];
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAClE,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAehC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAkC,EAClC,UAAgC,EAAE;IAElC,MAAM,EAAE,mBAAmB,GAAG,KAAK,EAAE,aAAa,GAAG,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEtF,IAAI,QAAQ,GAAG,UAAU;SACtB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAe,EAAE,CAAC,CAAC;QACxC,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;QAChD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC;KACnE,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC;IAEnG,IAAI,mBAAmB,EAAE,CAAC;QACxB,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IACrE,CAAC;SAAM,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;QACpE,QAAQ,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACpG,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Anthropic Claude — direct browser call via raw fetch, no SDK dependency.
+ * `anthropic-dangerous-direct-browser-access` is the header the official SDK
+ * sends under `dangerouslyAllowBrowser` — acceptable here because the user
+ * supplies their own key on their own machine; there is no backend to hide
+ * it behind in the first place.
+ */
+import type { ChatMessage, ProviderCallConfig, RequestOptions } from "../types.js";
+export declare function completeAnthropic(cfg: ProviderCallConfig, messages: readonly ChatMessage[], options?: RequestOptions): Promise<string>;
+export declare function streamAnthropic(cfg: ProviderCallConfig, messages: readonly ChatMessage[], onChunk: (fullTextSoFar: string) => void, options?: RequestOptions): Promise<string>;

package/dist/providers/anthropic.js

@@ -0,0 +1,64 @@
+/**
+ * Anthropic Claude — direct browser call via raw fetch, no SDK dependency.
+ * `anthropic-dangerous-direct-browser-access` is the header the official SDK
+ * sends under `dangerouslyAllowBrowser` — acceptable here because the user
+ * supplies their own key on their own machine; there is no backend to hide
+ * it behind in the first place.
+ */
+import { consumeLines, describeHttpError, fetchWithRetry } from "../http.js";
+const DEFAULT_MAX_TOKENS = 1024;
+const ANTHROPIC_URL = "https://api.anthropic.com/v1/messages";
+function toApiMessages(messages) {
+    return messages.filter((m) => m.role !== "system").map((m) => ({ role: m.role, content: m.content }));
+}
+function systemOf(messages, explicit) {
+    return explicit ?? messages.find((m) => m.role === "system")?.content;
+}
+function buildBody(cfg, messages, options, stream) {
+    const system = systemOf(messages, options.systemInstruction);
+    return {
+        model: cfg.model,
+        max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,
+        ...(system ? { system } : {}),
+        messages: toApiMessages(messages),
+        ...(stream ? { stream: true } : {}),
+    };
+}
+function headers(cfg) {
+    return {
+        "Content-Type": "application/json",
+        "x-api-key": cfg.apiKey,
+        "anthropic-version": "2023-06-01",
+        "anthropic-dangerous-direct-browser-access": "true",
+    };
+}
+export async function completeAnthropic(cfg, messages, options = {}) {
+    const res = await fetchWithRetry(ANTHROPIC_URL, { method: "POST", headers: headers(cfg), body: JSON.stringify(buildBody(cfg, messages, options, false)) }, options.signal);
+    if (!res.ok)
+        throw new Error(await describeHttpError(res));
+    const data = await res.json();
+    return data.content?.[0]?.text ?? "";
+}
+export async function streamAnthropic(cfg, messages, onChunk, options = {}) {
+    const res = await fetchWithRetry(ANTHROPIC_URL, { method: "POST", headers: headers(cfg), body: JSON.stringify(buildBody(cfg, messages, options, true)) }, options.signal);
+    if (!res.ok)
+        throw new Error(await describeHttpError(res));
+    let full = "";
+    await consumeLines(res, (line) => {
+        if (!line.startsWith("data: "))
+            return;
+        const raw = line.slice(6).trim();
+        try {
+            const event = JSON.parse(raw);
+            if (event.type === "content_block_delta" && event.delta?.type === "text_delta") {
+                full += event.delta.text;
+                onChunk(full);
+            }
+        }
+        catch {
+            // Skip a malformed/partial SSE frame.
+        }
+    });
+    return full;
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG7E,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,aAAa,GAAG,uCAAuC,CAAC;AAE9D,SAAS,aAAa,CAAC,QAAgC;IACrD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgC,EAAE,QAAiB;IACnE,OAAO,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,OAAO,CAAC;AACxE,CAAC;AAED,SAAS,SAAS,CAAC,GAAuB,EAAE,QAAgC,EAAE,OAAuB,EAAE,MAAe;IACpH,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7D,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,kBAAkB;QACnD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;QACjC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAuB;IACtC,OAAO;QACL,cAAc,EAAE,kBAAkB;QAClC,WAAW,EAAE,GAAG,CAAC,MAAM;QACvB,mBAAmB,EAAE,YAAY;QACjC,2CAA2C,EAAE,MAAM;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAuB,EACvB,QAAgC,EAChC,UAA0B,EAAE;IAE5B,MAAM,GAAG,GAAG,MAAM,cAAc,CAC9B,aAAa,EACb,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,EACzG,OAAO,CAAC,MAAM,CACf,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAuB,EACvB,QAAgC,EAChC,OAAwC,EACxC,UAA0B,EAAE;IAE5B,MAAM,GAAG,GAAG,MAAM,cAAc,CAC9B,aAAa,EACb,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,EACxG,OAAO,CAAC,MAAM,CACf,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAE3D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;QAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC/E,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/providers/gemini.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Google Gemini — direct browser call, no SDK. The key travels in a header
+ * (`x-goog-api-key`) rather than the `?key=` query string: a URL ends up in
+ * proxy/server access logs and browser history, a header does not.
+ */
+import type { ChatMessage, ProviderCallConfig, RequestOptions } from "../types.js";
+export declare function completeGemini(cfg: ProviderCallConfig, messages: readonly ChatMessage[], options?: RequestOptions): Promise<string>;
+export declare function streamGemini(cfg: ProviderCallConfig, messages: readonly ChatMessage[], onChunk: (fullTextSoFar: string) => void, options?: RequestOptions): Promise<string>;

package/dist/providers/gemini.js

@@ -0,0 +1,66 @@
+/**
+ * Google Gemini — direct browser call, no SDK. The key travels in a header
+ * (`x-goog-api-key`) rather than the `?key=` query string: a URL ends up in
+ * proxy/server access logs and browser history, a header does not.
+ */
+import { consumeLines, describeHttpError, fetchWithRetry } from "../http.js";
+const DEFAULT_MAX_TOKENS = 1024;
+function toContents(messages) {
+    return messages
+        .filter((m) => m.role !== "system")
+        .map((m) => ({ role: m.role === "assistant" ? "model" : "user", parts: [{ text: m.content }] }));
+}
+function systemInstructionOf(messages, explicit) {
+    return explicit ?? messages.find((m) => m.role === "system")?.content;
+}
+function buildBody(messages, options) {
+    const system = systemInstructionOf(messages, options.systemInstruction);
+    return {
+        contents: toContents(messages),
+        generationConfig: {
+            maxOutputTokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,
+            ...(options.jsonMode ? { responseMimeType: "application/json" } : {}),
+        },
+        ...(system ? { systemInstruction: { parts: [{ text: system }] } } : {}),
+    };
+}
+export async function completeGemini(cfg, messages, options = {}) {
+    const url = `https://generativelanguage.googleapis.com/v1beta/models/${encodeURIComponent(cfg.model)}:generateContent`;
+    const res = await fetchWithRetry(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "x-goog-api-key": cfg.apiKey },
+        body: JSON.stringify(buildBody(messages, options)),
+    }, options.signal);
+    if (!res.ok)
+        throw new Error(await describeHttpError(res));
+    const data = await res.json();
+    return data.candidates?.[0]?.content?.parts?.[0]?.text ?? "";
+}
+export async function streamGemini(cfg, messages, onChunk, options = {}) {
+    const url = `https://generativelanguage.googleapis.com/v1beta/models/${encodeURIComponent(cfg.model)}:streamGenerateContent?alt=sse`;
+    const res = await fetchWithRetry(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "x-goog-api-key": cfg.apiKey },
+        body: JSON.stringify(buildBody(messages, options)),
+    }, options.signal);
+    if (!res.ok)
+        throw new Error(await describeHttpError(res));
+    let full = "";
+    await consumeLines(res, (line) => {
+        if (!line.startsWith("data: "))
+            return;
+        const raw = line.slice(6).trim();
+        try {
+            const text = JSON.parse(raw).candidates?.[0]?.content?.parts?.[0]?.text;
+            if (text) {
+                full += text;
+                onChunk(full);
+            }
+        }
+        catch {
+            // Skip a malformed/partial SSE frame — the next line may complete it.
+        }
+    });
+    return full;
+}
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

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