@uptimizr/agent-core 0.1.0

package/dist/provider.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Headless LLM provider-adapter interface for Uptimizr agents.
+ *
+ * The agent core is provider-agnostic: it hands a provider the running
+ * conversation plus the read-only tool schemas and receives back either tool
+ * calls to execute or a final natural-language answer. Concrete adapters
+ * (WebLLM/WebGPU, an OpenAI-compatible endpoint, an Anthropic endpoint, …) live
+ * outside this package and are user-selected and user-controlled — the core
+ * ships no model and no key (ADR 0050 §4).
+ */
+/** A single message in the agent conversation. */
+export type AgentMessage = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: string;
+} | {
+    role: "assistant";
+    content: string;
+    toolCalls?: AgentToolCall[];
+} | {
+    role: "tool";
+    toolCallId: string;
+    name: string;
+    content: string;
+};
+/** A tool invocation requested by the model. */
+export interface AgentToolCall {
+    /** Provider-assigned id, echoed back on the matching tool result message. */
+    id: string;
+    /** Name of the tool to invoke (must match a catalog tool). */
+    name: string;
+    /** Arguments for the tool, validated against the tool's input schema. */
+    arguments: Record<string, unknown>;
+}
+/**
+ * A tool advertised to the model: its name, a short description, and a
+ * JSON-Schema description of its parameters (derived from the catalog's Zod
+ * shapes, see {@link toToolSchemas}).
+ */
+export interface AgentToolSchema {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** The two possible outcomes of a provider turn. */
+export type ProviderResponse = {
+    kind: "tool_calls";
+    toolCalls: AgentToolCall[];
+    content?: string;
+} | {
+    kind: "final";
+    content: string;
+};
+/** A single provider completion request. */
+export interface ProviderRequest {
+    /** The conversation so far (system + user + prior assistant/tool turns). */
+    messages: AgentMessage[];
+    /** The read-only tools the model may call this turn. */
+    tools: AgentToolSchema[];
+    /** Optional cancellation signal, forwarded by the loop. */
+    signal?: AbortSignal;
+}
+/**
+ * A pluggable LLM backend. Implementations translate {@link ProviderRequest}
+ * into their own wire format and normalise the reply into a
+ * {@link ProviderResponse}.
+ */
+export interface LlmProvider {
+    complete(request: ProviderRequest): Promise<ProviderResponse>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,wDAAwD;IACxD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/D"}

package/dist/provider.js

@@ -0,0 +1,12 @@
+/**
+ * Headless LLM provider-adapter interface for Uptimizr agents.
+ *
+ * The agent core is provider-agnostic: it hands a provider the running
+ * conversation plus the read-only tool schemas and receives back either tool
+ * calls to execute or a final natural-language answer. Concrete adapters
+ * (WebLLM/WebGPU, an OpenAI-compatible endpoint, an Anthropic endpoint, …) live
+ * outside this package and are user-selected and user-controlled — the core
+ * ships no model and no key (ADR 0050 §4).
+ */
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Pure translation between the agent-core conversation shape and the Anthropic
+ * Messages API wire format. No I/O, no dependencies — the hosted adapter owns
+ * the actual `fetch`. Anthropic differs from OpenAI in three ways this module
+ * hides: the system prompt is a top-level field (not a message), tool calls are
+ * `tool_use` content blocks, and tool results are `tool_result` blocks carried
+ * in a following user turn.
+ */
+import type { AgentMessage, AgentToolSchema, ProviderResponse } from "../provider.js";
+/** An Anthropic content block (the subset used here). */
+export type AnthropicContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+} | {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+};
+/** An Anthropic request message. */
+export interface AnthropicMessage {
+    role: "user" | "assistant";
+    content: AnthropicContentBlock[];
+}
+/** An Anthropic tool advertisement. */
+export interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+/** The parts of an Anthropic request this module builds. */
+export interface AnthropicRequestBody {
+    system?: string;
+    messages: AnthropicMessage[];
+    tools: AnthropicTool[];
+}
+/** The subset of an Anthropic Messages response this module reads. */
+export interface AnthropicCompletion {
+    content?: AnthropicContentBlock[];
+}
+/**
+ * Build the Anthropic request pieces (system prompt, messages, tools) from the
+ * agent conversation and tool schemas.
+ */
+export declare function toAnthropicRequest(messages: readonly AgentMessage[], tools: readonly AgentToolSchema[]): AnthropicRequestBody;
+/**
+ * Normalise an Anthropic Messages response into a {@link ProviderResponse}.
+ * Any `tool_use` blocks become tool calls; otherwise the joined text blocks are
+ * the final answer.
+ */
+export declare function parseAnthropicCompletion(completion: AnthropicCompletion): ProviderResponse;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,eAAe,EACf,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,yDAAyD;AACzD,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,KAAK,EAAE,SAAS,eAAe,EAAE,GAChC,oBAAoB,CAuCtB;AAMD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,mBAAmB,GAAG,gBAAgB,CAc1F"}

package/dist/providers/anthropic.js

@@ -0,0 +1,75 @@
+/**
+ * Pure translation between the agent-core conversation shape and the Anthropic
+ * Messages API wire format. No I/O, no dependencies — the hosted adapter owns
+ * the actual `fetch`. Anthropic differs from OpenAI in three ways this module
+ * hides: the system prompt is a top-level field (not a message), tool calls are
+ * `tool_use` content blocks, and tool results are `tool_result` blocks carried
+ * in a following user turn.
+ */
+/**
+ * Build the Anthropic request pieces (system prompt, messages, tools) from the
+ * agent conversation and tool schemas.
+ */
+export function toAnthropicRequest(messages, tools) {
+    const systemParts = [];
+    const out = [];
+    for (const message of messages) {
+        switch (message.role) {
+            case "system":
+                systemParts.push(message.content);
+                break;
+            case "user":
+                out.push({ role: "user", content: [{ type: "text", text: message.content }] });
+                break;
+            case "assistant": {
+                const blocks = [];
+                if (message.content)
+                    blocks.push({ type: "text", text: message.content });
+                for (const call of message.toolCalls ?? [])
+                    blocks.push(toToolUse(call));
+                out.push({ role: "assistant", content: blocks });
+                break;
+            }
+            case "tool":
+                out.push({
+                    role: "user",
+                    content: [
+                        { type: "tool_result", tool_use_id: message.toolCallId, content: message.content },
+                    ],
+                });
+                break;
+        }
+    }
+    return {
+        ...(systemParts.length > 0 ? { system: systemParts.join("\n\n") } : {}),
+        messages: out,
+        tools: tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            input_schema: tool.parameters,
+        })),
+    };
+}
+function toToolUse(call) {
+    return { type: "tool_use", id: call.id, name: call.name, input: call.arguments ?? {} };
+}
+/**
+ * Normalise an Anthropic Messages response into a {@link ProviderResponse}.
+ * Any `tool_use` blocks become tool calls; otherwise the joined text blocks are
+ * the final answer.
+ */
+export function parseAnthropicCompletion(completion) {
+    const blocks = completion.content ?? [];
+    const toolCalls = blocks
+        .filter((b) => b.type === "tool_use")
+        .map((b) => ({ id: b.id, name: b.name, arguments: b.input ?? {} }));
+    const text = blocks
+        .filter((b) => b.type === "text")
+        .map((b) => b.text)
+        .join("");
+    if (toolCalls.length > 0) {
+        return { kind: "tool_calls", toolCalls, ...(text ? { content: text } : {}) };
+    }
+    return { kind: "final", content: text };
+}
+//# 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":"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"}

package/dist/providers/config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * User-controlled backend selection and its browser persistence (ADR 0050 §4).
+ *
+ * The assistant ships no model and no key: the user picks a backend and the
+ * choice persists per-user in `localStorage`. Nothing here talks to a network —
+ * it only records which backend the user chose and the parameters needed to
+ * construct the matching provider adapter. Everything is injectable and
+ * SSR/Node-safe so the same module runs in the browser, in tests, and during a
+ * static export where `localStorage`/`navigator` may be absent.
+ */
+/** The two user-controlled backends (ADR 0050 §4). */
+export type BackendKind = "local" | "hosted";
+/** Wire format of a bring-your-own hosted provider. */
+export type HostedApi = "openai" | "anthropic";
+/** Persisted parameters for the local (WebLLM/WebGPU) backend. */
+export interface WebLlmBackendConfig {
+    /** Curated model id to load (see `CURATED_MODELS`). */
+    model: string;
+}
+/**
+ * Persisted parameters for a bring-your-own hosted backend. The key and
+ * endpoint live only in the user's browser and are sent only to the user's own
+ * provider (ADR 0050 §5).
+ */
+export interface HostedBackendConfig {
+    /** Which wire format the endpoint speaks. */
+    api: HostedApi;
+    /** Base URL of the user's provider (e.g. https://api.openai.com/v1). */
+    endpoint: string;
+    /** The user's provider API key, stored in-browser only. */
+    apiKey: string;
+    /** Model identifier to request from the provider. */
+    model: string;
+}
+/** The persisted assistant backend selection. */
+export interface AssistantBackendConfig {
+    /** Which backend the user selected. */
+    backend: BackendKind;
+    /** Local backend parameters (present when `backend === "local"`). */
+    webllm?: WebLlmBackendConfig;
+    /** Hosted backend parameters (present when `backend === "hosted"`). */
+    hosted?: HostedBackendConfig;
+}
+/** The `localStorage` key the selection is stored under. */
+export declare const BACKEND_CONFIG_STORAGE_KEY = "uptimizr.assistant.backend";
+/** The minimal `localStorage`-like surface this module needs. */
+export interface KeyValueStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/**
+ * Feature-detect WebGPU. The local backend is only offered when this returns
+ * `true`; callers should hide/disable the local option otherwise (ADR 0050 §4).
+ */
+export declare function isWebGpuAvailable(nav?: Navigator | undefined): boolean;
+/**
+ * The privacy-preserving default backend: local (zero egress) when WebGPU is
+ * present, otherwise hosted (ADR 0050 §4/§5).
+ */
+export declare function defaultBackendKind(nav?: Navigator): BackendKind;
+/**
+ * Load the persisted backend selection, or `null` when nothing is stored (or
+ * storage is unavailable / corrupt). Corrupt entries are treated as absent.
+ */
+export declare function loadBackendConfig(storage?: KeyValueStorage | undefined): AssistantBackendConfig | null;
+/**
+ * Persist the backend selection. No-op when storage is unavailable so callers
+ * don't have to guard SSR/Node.
+ */
+export declare function saveBackendConfig(config: AssistantBackendConfig, storage?: KeyValueStorage | undefined): void;
+/** Clear any persisted backend selection. */
+export declare function clearBackendConfig(storage?: KeyValueStorage | undefined): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/providers/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/providers/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7C,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE/C,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,GAAG,EAAE,SAAS,CAAC;IACf,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,OAAO,EAAE,WAAW,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,uEAAuE;IACvE,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAWD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,SAAS,GAAG,SAAgC,GAAG,OAAO,CAE5F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,WAAW,CAE/D;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,eAAe,GAAG,SAA4B,GACtD,sBAAsB,GAAG,IAAI,CAkB/B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,eAAe,GAAG,SAA4B,GACtD,IAAI,CAON;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,eAAe,GAAG,SAA4B,GAAG,IAAI,CAOhG"}

package/dist/providers/config.js

@@ -0,0 +1,93 @@
+/**
+ * User-controlled backend selection and its browser persistence (ADR 0050 §4).
+ *
+ * The assistant ships no model and no key: the user picks a backend and the
+ * choice persists per-user in `localStorage`. Nothing here talks to a network —
+ * it only records which backend the user chose and the parameters needed to
+ * construct the matching provider adapter. Everything is injectable and
+ * SSR/Node-safe so the same module runs in the browser, in tests, and during a
+ * static export where `localStorage`/`navigator` may be absent.
+ */
+/** The `localStorage` key the selection is stored under. */
+export const BACKEND_CONFIG_STORAGE_KEY = "uptimizr.assistant.backend";
+function defaultStorage() {
+    try {
+        return globalThis.localStorage;
+    }
+    catch {
+        // Accessing localStorage can throw in sandboxed iframes / disabled storage.
+        return undefined;
+    }
+}
+/**
+ * Feature-detect WebGPU. The local backend is only offered when this returns
+ * `true`; callers should hide/disable the local option otherwise (ADR 0050 §4).
+ */
+export function isWebGpuAvailable(nav = globalThis.navigator) {
+    return Boolean(nav && "gpu" in nav && nav.gpu);
+}
+/**
+ * The privacy-preserving default backend: local (zero egress) when WebGPU is
+ * present, otherwise hosted (ADR 0050 §4/§5).
+ */
+export function defaultBackendKind(nav) {
+    return isWebGpuAvailable(nav) ? "local" : "hosted";
+}
+function isBackendKind(value) {
+    return value === "local" || value === "hosted";
+}
+/**
+ * Load the persisted backend selection, or `null` when nothing is stored (or
+ * storage is unavailable / corrupt). Corrupt entries are treated as absent.
+ */
+export function loadBackendConfig(storage = defaultStorage()) {
+    if (!storage)
+        return null;
+    let raw;
+    try {
+        raw = storage.getItem(BACKEND_CONFIG_STORAGE_KEY);
+    }
+    catch {
+        return null;
+    }
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        const backend = parsed.backend;
+        if (!isBackendKind(backend))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Persist the backend selection. No-op when storage is unavailable so callers
+ * don't have to guard SSR/Node.
+ */
+export function saveBackendConfig(config, storage = defaultStorage()) {
+    if (!storage)
+        return;
+    try {
+        storage.setItem(BACKEND_CONFIG_STORAGE_KEY, JSON.stringify(config));
+    }
+    catch {
+        // Ignore quota/security errors — persistence is best-effort.
+    }
+}
+/** Clear any persisted backend selection. */
+export function clearBackendConfig(storage = defaultStorage()) {
+    if (!storage)
+        return;
+    try {
+        storage.removeItem(BACKEND_CONFIG_STORAGE_KEY);
+    }
+    catch {
+        // Ignore.
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/providers/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/providers/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwCH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAA4B,CAAC;AASvE,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAQ,UAAiD,CAAC,YAAY,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA6B,UAAU,CAAC,SAAS;IACjF,OAAO,OAAO,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,IAAK,GAAyB,CAAC,GAAG,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAe;IAChD,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,QAAQ,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAuC,cAAc,EAAE;IAEvD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,GAAkB,CAAC;IACvB,IAAI,CAAC;QACH,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACvD,MAAM,OAAO,GAAI,MAAgC,CAAC,OAAO,CAAC;QAC1D,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,MAAgC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA8B,EAC9B,UAAuC,cAAc,EAAE;IAEvD,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,0BAA0B,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;IAC/D,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,kBAAkB,CAAC,UAAuC,cAAc,EAAE;IACxF,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,CAAC;QACH,OAAO,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,UAAU;IACZ,CAAC;AACH,CAAC"}

package/dist/providers/hosted.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Bring-your-own hosted LLM adapter (ADR 0050 §4/§5).
+ *
+ * The user supplies an OpenAI-compatible **or** Anthropic endpoint + key, stored
+ * only in their browser. The browser calls the user's own provider directly —
+ * Uptimizr operates no proxy. Only the prompt and the aggregated tool results
+ * the loop produces leave the browser (never raw events or PII), and only to the
+ * user's chosen provider after explicit opt-in.
+ *
+ * Both providers require CORS to be reachable from a browser:
+ *  - OpenAI-compatible: the endpoint must send permissive `Access-Control-*`
+ *    headers (some gateways/self-hosted servers do; api.openai.com does not).
+ *  - Anthropic: pass the `anthropic-dangerous-direct-browser-access` header
+ *    (added below) which enables their browser CORS path.
+ * See the docs (guides/assistant) for the exact requirements.
+ */
+import type { LlmProvider } from "../provider.js";
+import type { HostedApi } from "./config.js";
+/** Configuration for a bring-your-own hosted provider. */
+export interface HostedProviderConfig {
+    /** Which wire format the endpoint speaks. */
+    api: HostedApi;
+    /**
+     * Base URL of the user's provider. The provider appends the well-known path
+     * (`/chat/completions` or `/messages`) if the URL doesn't already end in it.
+     */
+    endpoint: string;
+    /** The user's provider API key (in-browser only). */
+    apiKey: string;
+    /** Model identifier to request. */
+    model: string;
+    /** Max tokens to generate (Anthropic requires it; default 1024). */
+    maxTokens?: number;
+    /** Anthropic API version header (default "2023-06-01"). */
+    anthropicVersion?: string;
+    /** Injectable fetch for testing; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+/** Thrown when the user's provider responds with a non-2xx status. */
+export declare class HostedProviderError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+/**
+ * Create a hosted provider bound to one `(api, endpoint, apiKey, model)`. The
+ * returned {@link LlmProvider} issues one direct request per turn to the user's
+ * provider and normalises the reply.
+ */
+export declare function createHostedProvider(config: HostedProviderConfig): LlmProvider;
+//# sourceMappingURL=hosted.d.ts.map

package/dist/providers/hosted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted.d.ts","sourceRoot":"","sources":["../../src/providers/hosted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAqC,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAa7C,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,GAAG,EAAE,SAAS,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,sEAAsE;AACtE,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM;CAK1B;AAYD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,WAAW,CAS9E"}

package/dist/providers/hosted.js

@@ -0,0 +1,102 @@
+/**
+ * Bring-your-own hosted LLM adapter (ADR 0050 §4/§5).
+ *
+ * The user supplies an OpenAI-compatible **or** Anthropic endpoint + key, stored
+ * only in their browser. The browser calls the user's own provider directly —
+ * Uptimizr operates no proxy. Only the prompt and the aggregated tool results
+ * the loop produces leave the browser (never raw events or PII), and only to the
+ * user's chosen provider after explicit opt-in.
+ *
+ * Both providers require CORS to be reachable from a browser:
+ *  - OpenAI-compatible: the endpoint must send permissive `Access-Control-*`
+ *    headers (some gateways/self-hosted servers do; api.openai.com does not).
+ *  - Anthropic: pass the `anthropic-dangerous-direct-browser-access` header
+ *    (added below) which enables their browser CORS path.
+ * See the docs (guides/assistant) for the exact requirements.
+ */
+import { parseOpenAiCompletion, toOpenAiMessages, toOpenAiTools, } from "./openai.js";
+import { parseAnthropicCompletion, toAnthropicRequest, } from "./anthropic.js";
+/** Thrown when the user's provider responds with a non-2xx status. */
+export class HostedProviderError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "HostedProviderError";
+    }
+}
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_ANTHROPIC_VERSION = "2023-06-01";
+function joinUrl(base, suffix) {
+    let end = base.length;
+    while (end > 0 && base[end - 1] === "/")
+        end--;
+    const trimmed = base.slice(0, end);
+    return trimmed.endsWith(suffix) ? trimmed : `${trimmed}${suffix}`;
+}
+/**
+ * Create a hosted provider bound to one `(api, endpoint, apiKey, model)`. The
+ * returned {@link LlmProvider} issues one direct request per turn to the user's
+ * provider and normalises the reply.
+ */
+export function createHostedProvider(config) {
+    const fetchImpl = config.fetchImpl ?? fetch;
+    return {
+        complete(request) {
+            return config.api === "anthropic"
+                ? completeAnthropic(config, fetchImpl, request)
+                : completeOpenAi(config, fetchImpl, request);
+        },
+    };
+}
+async function completeOpenAi(config, fetchImpl, request) {
+    const url = joinUrl(config.endpoint, "/chat/completions");
+    const body = {
+        model: config.model,
+        messages: toOpenAiMessages(request.messages),
+        tools: toOpenAiTools(request.tools),
+        tool_choice: "auto",
+    };
+    const res = await fetchImpl(url, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            authorization: `Bearer ${config.apiKey}`,
+        },
+        body: JSON.stringify(body),
+        signal: request.signal,
+    });
+    const completion = (await readJson(res));
+    return parseOpenAiCompletion(completion);
+}
+async function completeAnthropic(config, fetchImpl, request) {
+    const url = joinUrl(config.endpoint, "/messages");
+    const shaped = toAnthropicRequest(request.messages, request.tools);
+    const body = {
+        model: config.model,
+        max_tokens: config.maxTokens ?? DEFAULT_MAX_TOKENS,
+        ...shaped,
+    };
+    const res = await fetchImpl(url, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            "x-api-key": config.apiKey,
+            "anthropic-version": config.anthropicVersion ?? DEFAULT_ANTHROPIC_VERSION,
+            // Enables Anthropic's browser CORS path for direct client-side calls.
+            "anthropic-dangerous-direct-browser-access": "true",
+        },
+        body: JSON.stringify(body),
+        signal: request.signal,
+    });
+    const completion = (await readJson(res));
+    return parseAnthropicCompletion(completion);
+}
+async function readJson(res) {
+    if (!res.ok) {
+        const detail = await res.text().catch(() => "");
+        throw new HostedProviderError(detail || res.statusText, res.status);
+    }
+    return res.json();
+}
+//# sourceMappingURL=hosted.js.map

package/dist/providers/hosted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted.js","sourceRoot":"","sources":["../../src/providers/hosted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC;AAuBxB,sEAAsE;AACtE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAGjC;IAFX,YACE,OAAe,EACN,MAAc;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,WAAM,GAAN,MAAM,CAAQ;QAGvB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAE/C,SAAS,OAAO,CAAC,IAAY,EAAE,MAAc;IAC3C,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;QAAE,GAAG,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC;IAC5C,OAAO;QACL,QAAQ,CAAC,OAAwB;YAC/B,OAAO,MAAM,CAAC,GAAG,KAAK,WAAW;gBAC/B,CAAC,CAAC,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBAC/C,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAA4B,EAC5B,SAAuB,EACvB,OAAwB;IAExB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG;QACX,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5C,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,WAAW,EAAE,MAAe;KAC7B,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;QAC/B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;SACzC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAqB,CAAC;IAC7D,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,MAA4B,EAC5B,SAAuB,EACvB,OAAwB;IAExB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG;QACX,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,SAAS,IAAI,kBAAkB;QAClD,GAAG,MAAM;KACV,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;QAC/B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,IAAI,yBAAyB;YACzE,sEAAsE;YACtE,2CAA2C,EAAE,MAAM;SACpD;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAwB,CAAC;IAChE,OAAO,wBAAwB,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,IAAI,mBAAmB,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * User-controlled LLM provider adapters for `@uptimizr/agent-core` (ADR 0050 §4).
+ *
+ * Import from the specific subpaths to keep the local runtime code-split:
+ *   - `@uptimizr/agent-core/providers/webllm` — local WebGPU backend
+ *   - `@uptimizr/agent-core/providers/hosted` — bring-your-own hosted backend
+ *
+ * This barrel re-exports both plus the shared backend-selection/persistence
+ * helpers for consumers who want everything from one entry point. Importing the
+ * barrel pulls in the WebLLM adapter *module* (small), but never the heavy
+ * `@mlc-ai/web-llm` runtime — that still loads lazily on first use.
+ */
+export { type AssistantBackendConfig, type BackendKind, type HostedApi, type HostedBackendConfig, type KeyValueStorage, type WebLlmBackendConfig, BACKEND_CONFIG_STORAGE_KEY, clearBackendConfig, defaultBackendKind, isWebGpuAvailable, loadBackendConfig, saveBackendConfig, } from "./config.js";
+export { type HostedProviderConfig, HostedProviderError, createHostedProvider } from "./hosted.js";
+export { type CuratedModel, type InitProgress, type WebLlmEngine, type WebLlmProvider, type WebLlmProviderOptions, type WebLlmRuntime, CURATED_MODELS, SUPPORTED_TOOL_CALLING_MODELS, UnsupportedToolCallingModelError, WebGpuUnavailableError, WebLlmConsentError, createWebLlmProvider, } from "./webllm.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnG,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,cAAc,EACd,6BAA6B,EAC7B,gCAAgC,EAChC,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,16 @@
+/**
+ * User-controlled LLM provider adapters for `@uptimizr/agent-core` (ADR 0050 §4).
+ *
+ * Import from the specific subpaths to keep the local runtime code-split:
+ *   - `@uptimizr/agent-core/providers/webllm` — local WebGPU backend
+ *   - `@uptimizr/agent-core/providers/hosted` — bring-your-own hosted backend
+ *
+ * This barrel re-exports both plus the shared backend-selection/persistence
+ * helpers for consumers who want everything from one entry point. Importing the
+ * barrel pulls in the WebLLM adapter *module* (small), but never the heavy
+ * `@mlc-ai/web-llm` runtime — that still loads lazily on first use.
+ */
+export { BACKEND_CONFIG_STORAGE_KEY, clearBackendConfig, defaultBackendKind, isWebGpuAvailable, loadBackendConfig, saveBackendConfig, } from "./config.js";
+export { HostedProviderError, createHostedProvider } from "./hosted.js";
+export { CURATED_MODELS, SUPPORTED_TOOL_CALLING_MODELS, UnsupportedToolCallingModelError, WebGpuUnavailableError, WebLlmConsentError, createWebLlmProvider, } from "./webllm.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAOL,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAA6B,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnG,OAAO,EAOL,cAAc,EACd,6BAA6B,EAC7B,gCAAgC,EAChC,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}