@artipod/core 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Medical Informatics Engineering, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# artipod
+
+**A pod for artifacts: a virtual filesystem your AI can reason in, your users can shell into, and your infrastructure can version, encrypt, and synchronize — in the browser and on Linux.**
+
+> **Status: shipped through plan Phase 6.6.** Everything below marked ✅ ships in `@artipod/core` today — the Node/Docker core, the browser sandbox, OCI layering, encryption & authority, and sync (the browser app lives at [examples/artipod-sync](examples/artipod-sync)). 🔮 marks the remaining design work (Phase 7 live streams), tracked phase-by-phase in [artipod-layer-plan.md](artipod-layer-plan.md). Previous implementation-state READMEs are archived in `attic/` ([v0.1](attic/v0.1-node.README.md), [v0.3](attic/v0.3-node.README.md) — the v0.3 one documents the pre-merge Node/Docker API, including podman support, read-only mounts, and the main mount).
+
+## What is an artipod?
+
+An **artipod** is a self-contained, portable workspace — a declarative set of mounts over a virtual filesystem, plus everything that operates on it:
+
+- a **bash isolate** (real bash semantics, browser and server) ✅
+- **AI agent tools** with VS Code-compatible schemas, an agent loop, and context/prompt building ✅
+- **OCI layering** for revision control: every pod is image/volume layers + a writable upper; snapshot, checkout, diff, commit, push, pull ✅
+- **encryption & authority**: ciphertext at rest, leased keys, offline grants, delegated managers ✅
+- **sync**: content-addressed, resumable, relay-friendly — browser ↔ server ↔ home base ✅
+
+Three consumer surfaces, one layer:
+
+| Surface | What it gets |
+|---|---|
+| **AI reasoning** | `buildPrompt()` context, VS Code-schema tools (`read_file`, `apply_patch`, …, `bash`), agent loop, `/proc` introspection — all confined to the pod |
+| **Revision control** | OCI snapshots: cheap (reference-based) checkpoints of *everything*, including shell side effects; time-travel, branch, diff, compact |
+| **Synchronization** | push/pull of digest-addressed layers through registries, proxies, or relays; offline-first by construction |
+
+> **Coming from Docker or Podman?** The muscle memory transfers (`artipod run -it alpine:3.22`, `artipod pods`), but the model inverts: in Docker the image is the artifact and the container's writable layer is scratch; here the writable state *is* the artifact — versioned, encrypted, pushable. And a pod is **not a Kubernetes Pod** — it's durable state that execution attaches to, not scheduled compute. Full orientation and concept map: [docs/containers.md](docs/containers.md).
+
+## Quick starts
+
+### The CLI: a pod in your terminal (✅)
+
+```sh
+npx @artipod/core run -it              # fresh pod → artipod-bash, kept under ~/.artipod/pods
+npx @artipod/core run -it alpine:3.22  # a registry image, cloned in writable
+npm install -g @artipod/core           # permanent `artipod` on PATH
+artipod pods                           # past runs — the `docker ps -a` of pods
+artipod run -it 500edf8b               # resume a kept pod by id prefix
+artipod run -it field/notes:1          # a ref you pushed earlier
+```
+
+(`npx github:mieweb/artipod` also works — it compiles from source on first run and caches.)
+
+Pods are kept on the real filesystem by default, so `exit` loses nothing — create-on-write: a
+fresh pod that saw no writes is quietly removed again. `--rm` makes the pod ephemeral (RAM only
+— add `--disk` to back it by a deleted-on-exit temp dir when changes may not fit in memory),
+`artipod rm <pod>` / `artipod prune` clean up kept pods, `--dir <path>` keeps a pod at a path of
+your choosing, `--store <path>` (default `~/.artipod/store`) backs `push`/`pull`/`clone` and REF
+lookup, `-c '<cmd>'` runs one line and exits. Inside the shell, `artipod` lists the pod verbs
+(snapshot, commit, push, hydrate, …).
+
+### Browser pod with a shell (✅ `@artipod/core/sandbox`)
+
+```ts
+import { initFileSystem, createSandbox } from '@artipod/core/sandbox';
+
+const { zfs } = await initFileSystem();     // IndexedDB (default) or OPFS
+const sandbox = createSandbox({ zfs });     // just-bash over ZenFS
+const r = await sandbox.exec('git clone https://github.com/user/repo && ls repo | head');
+```
+
+### Linux / server pod with Docker/Podman execution (✅ core shipped)
+
+```ts
+import { ArtiPod, ArtiMount } from '@artipod/core';
+
+const pod = new ArtiPod({
+  workspaceDir: '/data/workspaces',                    // auto-creates the writable 'main' mount
+  mounts: [new ArtiMount('src', '/data/project/src', /* readonly */ true)],
+});
+await pod.initialize();
+await pod.startContainer('./container/Dockerfile');   // hardened: CapDrop ALL, seccomp, no network
+const out = await pod.executeCommand('grep -r TODO /context/src | wc -l');
+```
+
+See [docs/linux.md](docs/linux.md) for the full server story (realizers, OCI-layout store, systemd).
+
+### An agent working inside a pod (✅ `@artipod/core/agent`)
+
+```ts
+import { createToolRegistry } from '@artipod/core/tools';
+import { ToolCallingLoop } from '@artipod/core/agent';
+
+const tools = createToolRegistry(pod);      // read_file, apply_patch, bash, … — pod-confined
+const loop = new ToolCallingLoop(client, tools);
+await loop.run('Summarize the README, then fix the failing test.');
+// tool-executing turns auto-snapshot (pod.agentLoopOptions(), default on) — `artipod snapshot diff` shows what the model did
+```
+
+The agent is **confined to the pod**. Anything outside it requires `sudo` — which the agent cannot self-approve. See [docs/security-model.md](docs/security-model.md).
+
+### The Ctrl+~ console (✅)
+
+One line to give any web app a drop-down artipod console (Quake-style):
+
+```ts
+import { installConsole } from '@artipod/core/console';
+installConsole({ sandbox, hotkey: 'Ctrl+`' });   // Ctrl+` / Ctrl+~ toggles the overlay
+```
+
+See [docs/console.md](docs/console.md).
+
+## Package layout
+
+Single package, ESM subpath exports (browser/node split via export conditions):
+
+```
+@artipod/core            ArtiPod, ArtiMount, pod manifest, pod events
+@artipod/core/tools      VS Code-schema tools + bash, OpenAI & MCP serializers
+@artipod/core/prompts    prompt templates + buildPrompt
+@artipod/core/sandbox    just-bash isolate, ZenFS adapter, storage backends
+@artipod/core/agent      tool-calling loop, OpenAI-compatible + local ONNX clients
+@artipod/core/proc       /proc providers (host state as files)
+@artipod/core/host       headless UI controllers (terminal session, file buffer, tree)
+@artipod/core/console    Ctrl+~ drop-in overlay console
+@artipod/core/manager    pod hosting, PodStore, keyring, leases, policy
+@artipod/core/server     fetch-style hosting handlers: pod store, exec, git/OCI proxies (node-only)
+@artipod/core/oci        blob store, layer FS, snapshots, transports
+@artipod/core/docker     hardened Docker execution (node-only)
+```
+
+## Security model in five lines
+
+1. **Disk holds only ciphertext + wrapped keys**; usable keys live in a memory keyring, on server-issued leases with a TTL. Lock = the key evaporates; login restores it.
+2. **Offline is first-class**: signed offline grants (e.g. 24 h) wrap keys to a device; delegated manager certificates let a ship/station/site issue leases with no home-base round trip.
+3. **The agent is confined to its pod.** `sudo` is the only escape, it requires explicit human approval, and the human may only approve if admin policy grants them that right.
+4. **Relays never need plaintext** — content addressing verifies end-to-end, so untrusted hops can cache and forward.
+5. Honesty: a browser can enforce cryptography, not process boundaries — see the threat-model tables in [docs/encryption.md](docs/encryption.md) before assuming more.
+
+Built for real disconnection profiles: a 24-hour offline clinic visit, a light-minutes-away station where all operations are local and sync is merely delayed, and an intermittently-connected ship where laptops relay through an on-board server. Walkthroughs in [docs/encryption.md](docs/encryption.md#offline-use-cases).
+
+## Documentation
+
+| Doc | Contents |
+|---|---|
+| [docs/containers.md](docs/containers.md) | Orientation for Docker/Podman/Kubernetes users: concept map, where each runtime fits, the pod-term collision |
+| [docs/on-disk-layout.md](docs/on-disk-layout.md) | What lands on disk: `~/.artipod`, the per-pod `/.artipod` store, plaintext vs ciphertext |
+| [docs/browser.md](docs/browser.md) | Browser implementation: ZenFS backends, OPFS/IndexedDB, ingest API, devices |
+| [docs/linux.md](docs/linux.md) | Linux/server implementation: realizers, Docker hardening, stores, deployment |
+| [docs/bash-isolate.md](docs/bash-isolate.md) | The bash isolate in browser and server: semantics, sessions, limits |
+| [docs/encryption.md](docs/encryption.md) | Encryption at rest, keyring, leases, offline grants, delegation |
+| [docs/security-model.md](docs/security-model.md) | Agent confinement, `sudo`, approval flow, admin policy |
+| [docs/console.md](docs/console.md) | The Ctrl+~ installable console module |
+| [artipod-layer-plan.md](artipod-layer-plan.md) | The living implementation plan (phases, decisions, worklogs) |
+
+## License
+
+MIT

package/dist/agent/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @artipod/core/agent — tool-calling loop, clients, and sandbox tool bindings.
+ *
+ * Framework-free (browser + Node). The local ONNX worker is exported as its
+ * own entry (`@artipod/core/agent/local/worker`) so bundlers can target it
+ * with `new Worker(new URL(...))`.
+ */
+export { ToolCallingLoop } from './loop.js';
+export { OzwellClient } from './ozwell-client.js';
+export type { OzwellClientConfig } from './ozwell-client.js';
+export { createSandboxTools, toOpenAiToolDefinitions, toMcpToolDescriptors, truncateOutput, MAX_TOOL_OUTPUT_BYTES, } from './tools.js';
+export type { ChatCompletionClient, ChatCompletionOptions, ChatCompletionRequest, ChatCompletionResponse, ChatMessage, McpToolDescriptor, MessageRole, TokenUsage, ToolCall, ToolCallingLoopOptions, ToolCallingLoopResult, ToolDefinition, ToolHandler, ToolResult, } from './types.js';
+export { LocalModelClient, webGpuAvailable } from './local/client.js';
+export type { LocalModelClientOptions } from './local/client.js';
+export { CURATED_MODELS, DEFAULT_LOCAL_MODEL, listLocalModels, modelInfo, type LocalModelInfo, type OnnxDtype, } from './local/model-registry.js';
+export { formatBytes, listCachedModels, modelIdFromCacheKey } from './local/model-cache.js';
+export type { CachedModel } from './local/model-cache.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,14 @@
+/**
+ * @artipod/core/agent — tool-calling loop, clients, and sandbox tool bindings.
+ *
+ * Framework-free (browser + Node). The local ONNX worker is exported as its
+ * own entry (`@artipod/core/agent/local/worker`) so bundlers can target it
+ * with `new Worker(new URL(...))`.
+ */
+export { ToolCallingLoop } from './loop.js';
+export { OzwellClient } from './ozwell-client.js';
+export { createSandboxTools, toOpenAiToolDefinitions, toMcpToolDescriptors, truncateOutput, MAX_TOOL_OUTPUT_BYTES, } from './tools.js';
+export { LocalModelClient, webGpuAvailable } from './local/client.js';
+export { CURATED_MODELS, DEFAULT_LOCAL_MODEL, listLocalModels, modelInfo, } from './local/model-registry.js';
+export { formatBytes, listCachedModels, modelIdFromCacheKey } from './local/model-cache.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAiBpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,SAAS,GAGV,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/agent/local/client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LocalModelClient — ChatCompletionClient over the ONNX worker, so
+ * ToolCallingLoop works identically with in-browser models. WebGPU only.
+ */
+import type { ChatCompletionClient, ChatCompletionOptions, ChatCompletionResponse, ChatMessage } from '../types.js';
+import type { OnnxDtype } from './model-registry.js';
+export interface LocalModelClientOptions {
+    modelId: string;
+    dtype?: OnnxDtype;
+    /** Download / load progress for the UI. */
+    onProgress?: (status: string, file: string, progress?: number) => void;
+}
+export declare function webGpuAvailable(): boolean;
+export declare class LocalModelClient implements ChatCompletionClient {
+    private readonly opts;
+    private worker;
+    private nextId;
+    private readonly pending;
+    constructor(opts: LocalModelClientOptions);
+    private getWorker;
+    createChatCompletion(messages: ChatMessage[], options?: ChatCompletionOptions): Promise<ChatCompletionResponse>;
+    dispose(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/agent/local/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/agent/local/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAOD,qBAAa,gBAAiB,YAAW,oBAAoB;IAK/C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAEzB,IAAI,EAAE,uBAAuB;IAE1D,OAAO,CAAC,SAAS;IAuBX,oBAAoB,CACxB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,sBAAsB,CAAC;IAiDlC,OAAO,IAAI,IAAI;CAKhB"}

package/dist/agent/local/client.js

@@ -0,0 +1,88 @@
+export function webGpuAvailable() {
+    return typeof navigator !== 'undefined' && 'gpu' in navigator;
+}
+export class LocalModelClient {
+    opts;
+    worker = null;
+    nextId = 1;
+    pending = new Map();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    getWorker() {
+        if (!this.worker) {
+            this.worker = new Worker(new URL('./worker.js', import.meta.url), { type: 'module' });
+            this.worker.onmessage = (event) => {
+                const msg = event.data;
+                if (msg.type === 'progress') {
+                    this.opts.onProgress?.(msg.status, msg.file, msg.progress);
+                    return;
+                }
+                const pending = msg.id !== undefined ? this.pending.get(msg.id) : undefined;
+                if (!pending)
+                    return;
+                this.pending.delete(msg.id);
+                if (msg.type === 'result')
+                    pending.resolve(msg);
+                else
+                    pending.reject(new Error(msg.message));
+            };
+            this.worker.onerror = (e) => {
+                this.pending.forEach((p) => p.reject(new Error(e.message || 'local model worker crashed')));
+                this.pending.clear();
+            };
+        }
+        return this.worker;
+    }
+    async createChatCompletion(messages, options = {}) {
+        if (!webGpuAvailable()) {
+            throw new Error('WebGPU is not available in this browser — local ONNX models need it.');
+        }
+        const id = this.nextId++;
+        const request = {
+            type: 'generate',
+            id,
+            modelId: this.opts.modelId,
+            dtype: this.opts.dtype ?? 'q4',
+            messages,
+            tools: options.tools,
+            maxNewTokens: options.maxTokens ?? 1024,
+        };
+        const worker = this.getWorker();
+        const onAbort = () => worker.postMessage({ type: 'abort', id });
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+        try {
+            const result = await new Promise((resolve, reject) => {
+                this.pending.set(id, { resolve, reject });
+                worker.postMessage(request);
+            });
+            const message = {
+                role: 'assistant',
+                content: result.toolCalls.length && !result.content ? null : result.content,
+                ...(result.toolCalls.length ? { tool_calls: result.toolCalls } : {}),
+            };
+            return {
+                id: `local-${id}`,
+                object: 'chat.completion',
+                created: Math.floor(Date.now() / 1000),
+                model: this.opts.modelId,
+                choices: [
+                    {
+                        index: 0,
+                        message,
+                        finish_reason: result.toolCalls.length ? 'tool_calls' : 'stop',
+                    },
+                ],
+            };
+        }
+        finally {
+            options.signal?.removeEventListener('abort', onAbort);
+        }
+    }
+    dispose() {
+        this.worker?.terminate();
+        this.worker = null;
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/agent/local/client.js.map

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

package/dist/agent/local/model-cache.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Which models are already in the OPFS weight cache (artipod-models/).
+ * Cache files are named encodeURIComponent(<download URL>), so decoding the
+ * names and grouping by HF repo id tells us what's downloaded.
+ */
+/** huggingface.co/<org>/<name>/resolve/... → "<org>/<name>"; null for runtime assets. */
+export declare function modelIdFromCacheKey(decodedUrl: string): string | null;
+export interface CachedModel {
+    bytes: number;
+    /** True once an .onnx/.onnx_data file is present (config-only ≠ downloaded). */
+    hasWeights: boolean;
+}
+export declare function listCachedModels(): Promise<Map<string, CachedModel>>;
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=model-cache.d.ts.map

package/dist/agent/local/model-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-cache.d.ts","sourceRoot":"","sources":["../../../src/agent/local/model-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUrE;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAyB1E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/agent/local/model-cache.js

@@ -0,0 +1,61 @@
+/**
+ * Which models are already in the OPFS weight cache (artipod-models/).
+ * Cache files are named encodeURIComponent(<download URL>), so decoding the
+ * names and grouping by HF repo id tells us what's downloaded.
+ */
+const MODELS_DIR = 'artipod-models';
+/** huggingface.co/<org>/<name>/resolve/... → "<org>/<name>"; null for runtime assets. */
+export function modelIdFromCacheKey(decodedUrl) {
+    try {
+        const url = new URL(decodedUrl);
+        if (url.hostname !== 'huggingface.co')
+            return null;
+        const segments = url.pathname.split('/').filter(Boolean);
+        if (segments.length < 4 || segments[2] !== 'resolve')
+            return null;
+        return `${segments[0]}/${segments[1]}`;
+    }
+    catch {
+        return null;
+    }
+}
+const isWeightsFile = (decodedUrl) => /\.onnx(_data.*)?$/.test(decodedUrl);
+export async function listCachedModels() {
+    const cached = new Map();
+    if (typeof navigator === 'undefined' || !navigator.storage?.getDirectory)
+        return cached;
+    try {
+        const root = await navigator.storage.getDirectory();
+        const dir = await root.getDirectoryHandle(MODELS_DIR);
+        const entries = dir.entries();
+        for (;;) {
+            const { done, value } = await entries.next();
+            if (done)
+                break;
+            const [name, handle] = value;
+            if (handle.kind !== 'file')
+                continue;
+            const decoded = decodeURIComponent(name);
+            const modelId = modelIdFromCacheKey(decoded);
+            if (!modelId)
+                continue;
+            const size = (await handle.getFile()).size;
+            const entry = cached.get(modelId) ?? { bytes: 0, hasWeights: false };
+            entry.bytes += size;
+            entry.hasWeights = entry.hasWeights || isWeightsFile(decoded);
+            cached.set(modelId, entry);
+        }
+    }
+    catch {
+        // no cache dir yet
+    }
+    return cached;
+}
+export function formatBytes(bytes) {
+    if (bytes >= 1e9)
+        return `${(bytes / 1e9).toFixed(1)} GB`;
+    if (bytes >= 1e6)
+        return `${Math.round(bytes / 1e6)} MB`;
+    return `${Math.round(bytes / 1e3)} kB`;
+}
+//# sourceMappingURL=model-cache.js.map

package/dist/agent/local/model-cache.js.map

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

package/dist/agent/local/model-registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * In-browser ONNX model registry: curated tool-capable defaults merged with
+ * a live query of the Hugging Face Hub (the de-facto ONNX model registry —
+ * CORS-enabled REST API), so the dropdown stays current without shipping a
+ * hardcoded list.
+ */
+/** Quantizations Transformers.js accepts for ONNX models. */
+export type OnnxDtype = 'auto' | 'q4' | 'q4f16' | 'q8' | 'int8' | 'uint8' | 'fp16' | 'fp32';
+export interface LocalModelInfo {
+    /** HF repo id, e.g. onnx-community/Qwen2.5-1.5B-Instruct */
+    id: string;
+    label: string;
+    /** Approximate q4 download size, shown in the picker. */
+    approxSize?: string;
+    /** ONNX quantization to request. */
+    dtype: OnnxDtype;
+    curated: boolean;
+}
+export declare const CURATED_MODELS: LocalModelInfo[];
+export declare const DEFAULT_LOCAL_MODEL: string;
+/** Curated list first, then popular Hub extras; Hub failure degrades to curated. */
+export declare function listLocalModels(fetchFn?: typeof fetch): Promise<LocalModelInfo[]>;
+export declare function modelInfo(id: string, models: LocalModelInfo[]): LocalModelInfo;
+//# sourceMappingURL=model-registry.d.ts.map

package/dist/agent/local/model-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../src/agent/local/model-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5F,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,cAAc,EAsB1C,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAuB,CAAC;AASxD,oFAAoF;AACpF,wBAAsB,eAAe,CAAC,OAAO,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAiB9F;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,CAE9E"}

package/dist/agent/local/model-registry.js

@@ -0,0 +1,56 @@
+/**
+ * In-browser ONNX model registry: curated tool-capable defaults merged with
+ * a live query of the Hugging Face Hub (the de-facto ONNX model registry —
+ * CORS-enabled REST API), so the dropdown stays current without shipping a
+ * hardcoded list.
+ */
+export const CURATED_MODELS = [
+    {
+        id: 'onnx-community/Qwen2.5-1.5B-Instruct',
+        label: 'Qwen2.5 1.5B Instruct (best small tool-caller)',
+        approxSize: '~1.8 GB',
+        dtype: 'q4',
+        curated: true,
+    },
+    {
+        id: 'onnx-community/Qwen2.5-0.5B-Instruct',
+        label: 'Qwen2.5 0.5B Instruct (fastest, weakest)',
+        approxSize: '~0.8 GB',
+        dtype: 'q4',
+        curated: true,
+    },
+    {
+        id: 'onnx-community/Llama-3.2-1B-Instruct-ONNX',
+        label: 'Llama 3.2 1B Instruct',
+        approxSize: '~1.7 GB',
+        dtype: 'q4',
+        curated: true,
+    },
+];
+export const DEFAULT_LOCAL_MODEL = CURATED_MODELS[0].id;
+const HUB_QUERY = 'https://huggingface.co/api/models?author=onnx-community&pipeline_tag=text-generation&sort=downloads&direction=-1&limit=30';
+/** Curated list first, then popular Hub extras; Hub failure degrades to curated. */
+export async function listLocalModels(fetchFn = fetch) {
+    const models = [...CURATED_MODELS];
+    try {
+        const res = await fetchFn(HUB_QUERY);
+        if (res.ok) {
+            const hub = (await res.json());
+            const known = new Set(models.map((m) => m.id));
+            for (const { id } of hub) {
+                // only instruct/chat-style repos are useful for tool calling
+                if (known.has(id) || !/instruct|chat|it-/i.test(id))
+                    continue;
+                models.push({ id, label: id.replace('onnx-community/', ''), dtype: 'q4', curated: false });
+            }
+        }
+    }
+    catch {
+        // offline / rate-limited: curated list is the fallback
+    }
+    return models;
+}
+export function modelInfo(id, models) {
+    return models.find((m) => m.id === id) ?? { id, label: id, dtype: 'q4', curated: false };
+}
+//# sourceMappingURL=model-registry.js.map

package/dist/agent/local/model-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.js","sourceRoot":"","sources":["../../../src/agent/local/model-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C;QACE,EAAE,EAAE,sCAAsC;QAC1C,KAAK,EAAE,gDAAgD;QACvD,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,sCAAsC;QAC1C,KAAK,EAAE,0CAA0C;QACjD,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,2CAA2C;QAC/C,KAAK,EAAE,uBAAuB;QAC9B,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;KACd;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAExD,MAAM,SAAS,GACb,2HAA2H,CAAC;AAM9H,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAwB,KAAK;IACjE,MAAM,MAAM,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC;gBACzB,6DAA6D;gBAC7D,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAE,SAAS;gBAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,MAAwB;IAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3F,CAAC"}

package/dist/agent/local/parse-tool-calls.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Parse tool calls out of small-model chat output into OpenAI shape.
+ * Tolerates the two formats our supported templates emit:
+ *   - Qwen:  <tool_call>{"name": "...", "arguments": {...}}</tool_call>
+ *   - Llama: a bare JSON object {"name": "...", "parameters": {...}}
+ */
+import type { ToolCall } from '../types.js';
+export interface ParsedGeneration {
+    content: string;
+    toolCalls: ToolCall[];
+}
+export declare function parseGeneration(output: string): ParsedGeneration;
+//# sourceMappingURL=parse-tool-calls.d.ts.map

package/dist/agent/local/parse-tool-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-tool-calls.d.ts","sourceRoot":"","sources":["../../../src/agent/local/parse-tool-calls.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AA0BD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CA2BhE"}

package/dist/agent/local/parse-tool-calls.js

@@ -0,0 +1,46 @@
+let counter = 0;
+const nextId = () => `local_call_${++counter}_${Date.now().toString(36)}`;
+function toToolCall(raw) {
+    if (typeof raw?.name !== 'string' || !raw.name)
+        return null;
+    const args = raw.arguments ?? raw.parameters ?? {};
+    return {
+        id: nextId(),
+        type: 'function',
+        function: {
+            name: raw.name,
+            arguments: typeof args === 'string' ? args : JSON.stringify(args),
+        },
+    };
+}
+const TOOL_CALL_BLOCK = /<tool_call>\s*([\s\S]*?)\s*<\/tool_call>/g;
+export function parseGeneration(output) {
+    const toolCalls = [];
+    const content = output
+        .replace(TOOL_CALL_BLOCK, (_match, body) => {
+        try {
+            const call = toToolCall(JSON.parse(body));
+            if (call)
+                toolCalls.push(call);
+        }
+        catch {
+            // malformed block: keep it visible as content instead of dropping it
+            return _match;
+        }
+        return '';
+    })
+        .trim();
+    if (toolCalls.length === 0 && content.startsWith('{') && content.endsWith('}')) {
+        // Llama-style bare JSON tool call
+        try {
+            const call = toToolCall(JSON.parse(content));
+            if (call)
+                return { content: '', toolCalls: [call] };
+        }
+        catch {
+            // plain JSON-looking prose: fall through
+        }
+    }
+    return { content, toolCalls };
+}
+//# sourceMappingURL=parse-tool-calls.js.map

package/dist/agent/local/parse-tool-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-tool-calls.js","sourceRoot":"","sources":["../../../src/agent/local/parse-tool-calls.ts"],"names":[],"mappings":"AAaA,IAAI,OAAO,GAAG,CAAC,CAAC;AAChB,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,cAAc,EAAE,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAQ1E,SAAS,UAAU,CAAC,GAAY;IAC9B,IAAI,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;IACnD,OAAO;QACL,EAAE,EAAE,MAAM,EAAE;QACZ,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAClE;KACF,CAAC;AACJ,CAAC;AAED,MAAM,eAAe,GAAG,2CAA2C,CAAC;AAEpE,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAG,MAAM;SACnB,OAAO,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1C,IAAI,IAAI;gBAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;SACD,IAAI,EAAE,CAAC;IAEV,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/E,kCAAkC;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7C,IAAI,IAAI;gBAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC"}

package/dist/agent/local/protocol.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Message protocol between LocalModelClient and the model worker.
+ */
+import type { ChatMessage, ToolCall, ToolDefinition } from '../types.js';
+import type { OnnxDtype } from './model-registry.js';
+export interface GenerateRequest {
+    type: 'generate';
+    id: number;
+    modelId: string;
+    dtype: OnnxDtype;
+    messages: ChatMessage[];
+    tools?: ToolDefinition[];
+    maxNewTokens: number;
+}
+export interface AbortRequest {
+    type: 'abort';
+    id: number;
+}
+export type WorkerRequest = GenerateRequest | AbortRequest;
+export interface ProgressEvent {
+    type: 'progress';
+    file: string;
+    /** 0..100 for determinate files. */
+    progress?: number;
+    status: string;
+}
+export interface ResultEvent {
+    type: 'result';
+    id: number;
+    content: string;
+    toolCalls: ToolCall[];
+}
+export interface ErrorEvent {
+    type: 'error';
+    id?: number;
+    message: string;
+}
+export type WorkerResponse = ProgressEvent | ResultEvent | ErrorEvent;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/agent/local/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/agent/local/protocol.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,YAAY,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC"}

package/dist/agent/local/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map