@statewalker/cellb 0.0.0-stage → 0.1.0

package/dist/bindings/worker-loader.js

@@ -0,0 +1,183 @@
+import { classHandle, cross, ctxExports, entrypointStub, ISOLATED, pipeTo, REFUSE, rpcPromise, } from "../core/handles.js";
+/** workerd's refusal of a loaded Worker's entrypoint passed on to another Worker. */
+const DYNAMIC_ENTRYPOINT = "Entrypoints to dynamically-loaded workers cannot be transferred to other Workers, because the system does not know how to reload this Worker from scratch. Instead, have the parent Worker expose an entrypoint which constructs the dynamic worker and forwards to it.";
+/**
+ * One `WorkerCode.modules` entry as ES module source; text and JSON become a default export,
+ * wasm bytes a compiled `WebAssembly.Module`.
+ */
+export function moduleText(entry) {
+    if (typeof entry === "string")
+        return entry;
+    const m = entry; // workerLoader refuses data
+    if (m.wasm) {
+        const bytes = ArrayBuffer.isView(m.wasm)
+            ? new Uint8Array(m.wasm.buffer, m.wasm.byteOffset, m.wasm.byteLength)
+            : new Uint8Array(m.wasm);
+        let bin = "";
+        for (const b of bytes)
+            bin += String.fromCharCode(b);
+        return `export default new WebAssembly.Module(Uint8Array.from(atob("${btoa(bin)}"), (c) => c.charCodeAt(0)));`;
+    }
+    return m.js ?? m.esModule ?? `export default ${JSON.stringify(m.text ?? m.json)};`;
+}
+/**
+ * The `fetch` loaded code sees, from `WorkerCode.globalOutbound`: omitted → the loader's own
+ * (undefined: no override); `null` → every fetch throws; a Fetcher → each fetch goes through it.
+ */
+export function outboundFetch(code) {
+    const o = code.globalOutbound;
+    if (o === undefined)
+        return undefined;
+    if (o === null)
+        return (async () => {
+            throw new Error("This worker is not permitted to access the internet via global functions like fetch(). It must use capabilities (such as bindings in 'env') to talk to the outside world.");
+        });
+    if (typeof o.fetch === "function")
+        return ((input, init) => o.fetch(input, init));
+    throw new TypeError("globalOutbound must be null or a Fetcher");
+}
+/**
+ * The Worker Loader binding (`worker_loaders` in wrangler config): runtime-loaded code,
+ * cached by id; the callback runs only when the id is not loaded yet.
+ */
+export function workerLoader(load, opts = {}) {
+    // With isolated loading, Durable Object classes (facets) still load in this realm.
+    const classCache = new Map();
+    const cache = new Map();
+    let anonymous = 0;
+    const loader = {
+        /** Compiles and runs code without the id cache (a fresh Worker per call). */
+        load(code) {
+            return loader.get(`__load-${++anonymous}-${Math.random().toString(36).slice(2)}`, () => code, false);
+        },
+        get(id, getCode, cached = true) {
+            let own; // load(): memoized per handle, not in the id cache
+            const loaded = () => {
+                let p = cached ? cache.get(id) : own;
+                if (!p) {
+                    p = (async () => {
+                        const code = await getCode();
+                        // celld takes module source and wasm bytes only, not `data` modules.
+                        for (const [name, m] of Object.entries(code.modules))
+                            if (typeof m === "object" && "data" in m)
+                                throw new Error(`worker loader: module "${name}" must be a string or wasm bytes`);
+                        const logs = [];
+                        const sink = (level, message) => logs.push({ level, message, timestamp: Date.now() });
+                        const module = await load(id, code, sink);
+                        const env = code.env ?? {};
+                        return { module, env, exports: ctxExports(module, env), code, logs };
+                    })();
+                    p.catch(() => cache.delete(id));
+                    if (cached)
+                        cache.set(id, p);
+                    else
+                        own = p;
+                }
+                return p;
+            };
+            /**
+             * Runs one invocation of loaded code, then hands its logs/exceptions to the Tail Workers.
+             * Returns the run's result as is (an RpcPromise stays one, for pipelining).
+             */
+            const traced = (l, request, run) => {
+                const from = l.logs.length;
+                const t0 = Date.now();
+                let r;
+                try {
+                    r = run();
+                }
+                catch (e) {
+                    r = Promise.reject(e);
+                }
+                const report = (exceptions) => {
+                    const event = {
+                        scriptName: id,
+                        outcome: exceptions.length ? "exception" : "ok",
+                        eventTimestamp: t0,
+                        event: request ? { request: { url: request.url, method: request.method } } : null,
+                        logs: l.logs.splice(from),
+                        exceptions,
+                        diagnosticsChannelEvents: [],
+                    };
+                    for (const t of l.code.tails ?? [])
+                        void Promise.resolve(t.tail([event])).catch(() => { });
+                };
+                Promise.resolve(r).then(() => report([]), (e) => report([
+                    {
+                        name: e?.name ?? "Error",
+                        message: String(e?.message ?? e),
+                        timestamp: Date.now(),
+                    },
+                ]));
+                return r;
+            };
+            return {
+                getDurableObjectClass(name) {
+                    const classesLoaded = () => {
+                        let p = classCache.get(id);
+                        if (!p) {
+                            p = (async () => {
+                                const code = await getCode();
+                                return { module: await opts.classes(id, code), env: code.env ?? {} };
+                            })();
+                            classCache.set(id, p);
+                        }
+                        return p;
+                    };
+                    return classHandle(async () => {
+                        if (!opts.classes) {
+                            const iso = (await loaded()).module[ISOLATED];
+                            if (iso)
+                                return { isolated: iso(name) };
+                        }
+                        const { module, env } = opts.classes ? await classesLoaded() : await loaded();
+                        const cls = module[name];
+                        if (typeof cls !== "function")
+                            throw new Error(`Loaded worker "${id}" does not export class "${name}"`);
+                        return { cls: cls, env };
+                    });
+                },
+                /** Releases the loaded Worker: the id leaves the cache; a later get() loads again. */
+                dispose() {
+                    cache.delete(id);
+                },
+                getEntrypoint(name = "default", options = {}) {
+                    // Props cross now (workerd serializes them here): a refusal is a rejected promise,
+                    // so `await` and `assert.rejects` see it.
+                    try {
+                        cross(options.props);
+                    }
+                    catch (e) {
+                        const refused = Promise.reject(e);
+                        refused.catch(() => { });
+                        return refused;
+                    }
+                    return new Proxy({}, {
+                        get(_t, prop) {
+                            if (prop === REFUSE)
+                                return DYNAMIC_ENTRYPOINT;
+                            if (prop === "then" || typeof prop === "symbol")
+                                return undefined;
+                            return (...args) => {
+                                // Boxed, so awaiting the load does not await the call: calls on its
+                                // RpcPromise are pipelined.
+                                const run = loaded().then((l) => {
+                                    const stub = entrypointStub(l.module[name], l.env, options.props, l.exports);
+                                    const request = prop === "fetch"
+                                        ? new Request(args[0], args[1])
+                                        : undefined;
+                                    return {
+                                        r: traced(l, request, () => stub[prop](...(request ? [request] : args))),
+                                    };
+                                });
+                                return rpcPromise(run.then((b) => b.r), (path, a) => run.then((b) => pipeTo(b.r, path, a)));
+                            };
+                        },
+                    });
+                },
+            };
+        },
+    };
+    return loader;
+}
+//# sourceMappingURL=worker-loader.js.map

package/dist/bindings/worker-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-loader.js","sourceRoot":"","sources":["../../src/bindings/worker-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  classHandle,\n  cross,\n  ctxExports,\n  type DurableObjectClass,\n  entrypointStub,\n  ISOLATED,\n  type IsolatedClass,\n  pipeTo,\n  REFUSE,\n  rpcPromise,\n} from \"../core/handles.js\";\n\n/** workerd's refusal of a loaded Worker's entrypoint passed on to another Worker. */\nconst DYNAMIC_ENTRYPOINT =\n  \"Entrypoints to dynamically-loaded workers cannot be transferred to other Workers, because the system does not know how to reload this Worker from scratch. Instead, have the parent Worker expose an entrypoint which constructs the dynamic worker and forwards to it.\";\n\n/** What `env.LOADER.get(id, () => code)` returns from its callback (workerd's WorkerCode). */\nexport interface WorkerCode {\n  compatibilityDate?: string;\n  compatibilityFlags?: string[];\n  mainModule: string;\n  modules: Record<\n    string,\n    | string\n    | { js?: string; esModule?: string; text?: string; json?: unknown; wasm?: BufferSource }\n    | { data: BufferSource }\n  >;\n  env?: Record<string, unknown>;\n  globalOutbound?: unknown;\n  /** Tail Workers: stubs whose `tail(events)` receives each invocation's logs and exceptions. */\n  tails?: { tail(events: TailEvent[]): unknown }[];\n}\n\nexport interface TailLog {\n  message: unknown[];\n  level: string;\n  timestamp: number;\n}\n\nexport interface TailEvent {\n  scriptName: string;\n  outcome: \"ok\" | \"exception\";\n  eventTimestamp: number;\n  event: { request?: { url: string; method: string } } | null;\n  logs: TailLog[];\n  exceptions: { name: string; message: string; timestamp: number }[];\n  diagnosticsChannelEvents: unknown[];\n}\n\n/**\n * One `WorkerCode.modules` entry as ES module source; text and JSON become a default export,\n * wasm bytes a compiled `WebAssembly.Module`.\n */\nexport function moduleText(entry: WorkerCode[\"modules\"][string]): string {\n  if (typeof entry === \"string\") return entry;\n  const m = entry as Exclude<typeof entry, { data: BufferSource }>; // workerLoader refuses data\n  if (m.wasm) {\n    const bytes = ArrayBuffer.isView(m.wasm)\n      ? new Uint8Array(m.wasm.buffer, m.wasm.byteOffset, m.wasm.byteLength)\n      : new Uint8Array(m.wasm);\n    let bin = \"\";\n    for (const b of bytes) bin += String.fromCharCode(b);\n    return `export default new WebAssembly.Module(Uint8Array.from(atob(\"${btoa(bin)}\"), (c) => c.charCodeAt(0)));`;\n  }\n  return m.js ?? m.esModule ?? `export default ${JSON.stringify(m.text ?? m.json)};`;\n}\n\n/**\n * The `fetch` loaded code sees, from `WorkerCode.globalOutbound`: omitted → the loader's own\n * (undefined: no override); `null` → every fetch throws; a Fetcher → each fetch goes through it.\n */\nexport function outboundFetch(code: WorkerCode): typeof fetch | undefined {\n  const o = code.globalOutbound as { fetch?: typeof fetch } | null | undefined;\n  if (o === undefined) return undefined;\n  if (o === null)\n    return (async () => {\n      throw new Error(\n        \"This worker is not permitted to access the internet via global functions like fetch(). It must use capabilities (such as bindings in 'env') to talk to the outside world.\",\n      );\n    }) as typeof fetch;\n  if (typeof o.fetch === \"function\")\n    return ((input: RequestInfo | URL, init?: RequestInit) =>\n      o.fetch!(input, init)) as typeof fetch;\n  throw new TypeError(\"globalOutbound must be null or a Fetcher\");\n}\n\n/** Where the `console` of loaded code writes (the host forwards to the real console too). */\nexport type LogSink = (level: string, args: unknown[]) => void;\n\n/** Compiles a WorkerCode into a module namespace (host specific: esbuild on Node, webrun-modules in browsers). */\nexport type ModuleLoader = (\n  id: string,\n  code: WorkerCode,\n  logs?: LogSink,\n) => Promise<Record<string, unknown>>;\n\n/**\n * The Worker Loader binding (`worker_loaders` in wrangler config): runtime-loaded code,\n * cached by id; the callback runs only when the id is not loaded yet.\n */\nexport function workerLoader(load: ModuleLoader, opts: { classes?: ModuleLoader } = {}) {\n  // With isolated loading, Durable Object classes (facets) still load in this realm.\n  const classCache = new Map<string, Promise<{ module: Record<string, unknown>; env: unknown }>>();\n  type Loaded = {\n    module: Record<string, unknown>;\n    env: unknown;\n    /** ctx.exports of the loaded code (empty for an isolated module: the isolate builds its own). */\n    exports: Record<string, unknown>;\n    code: WorkerCode;\n    logs: TailLog[];\n  };\n  const cache = new Map<string, Promise<Loaded>>();\n  let anonymous = 0;\n  const loader = {\n    /** Compiles and runs code without the id cache (a fresh Worker per call). */\n    load(code: WorkerCode) {\n      return loader.get(\n        `__load-${++anonymous}-${Math.random().toString(36).slice(2)}`,\n        () => code,\n        false,\n      );\n    },\n    get(id: string, getCode: () => WorkerCode | Promise<WorkerCode>, cached = true) {\n      let own: Promise<Loaded> | undefined; // load(): memoized per handle, not in the id cache\n      const loaded = () => {\n        let p = cached ? cache.get(id) : own;\n        if (!p) {\n          p = (async () => {\n            const code = await getCode();\n            // celld takes module source and wasm bytes only, not `data` modules.\n            for (const [name, m] of Object.entries(code.modules))\n              if (typeof m === \"object\" && \"data\" in m)\n                throw new Error(`worker loader: module \"${name}\" must be a string or wasm bytes`);\n            const logs: TailLog[] = [];\n            const sink: LogSink = (level, message) =>\n              logs.push({ level, message, timestamp: Date.now() });\n            const module = await load(id, code, sink);\n            const env = code.env ?? {};\n            return { module, env, exports: ctxExports(module, env), code, logs };\n          })();\n          p.catch(() => cache.delete(id));\n          if (cached) cache.set(id, p);\n          else own = p;\n        }\n        return p;\n      };\n      /**\n       * Runs one invocation of loaded code, then hands its logs/exceptions to the Tail Workers.\n       * Returns the run's result as is (an RpcPromise stays one, for pipelining).\n       */\n      const traced = (l: Loaded, request: Request | undefined, run: () => unknown): unknown => {\n        const from = l.logs.length;\n        const t0 = Date.now();\n        let r: unknown;\n        try {\n          r = run();\n        } catch (e) {\n          r = Promise.reject(e);\n        }\n        const report = (exceptions: TailEvent[\"exceptions\"]) => {\n          const event: TailEvent = {\n            scriptName: id,\n            outcome: exceptions.length ? \"exception\" : \"ok\",\n            eventTimestamp: t0,\n            event: request ? { request: { url: request.url, method: request.method } } : null,\n            logs: l.logs.splice(from),\n            exceptions,\n            diagnosticsChannelEvents: [],\n          };\n          for (const t of l.code.tails ?? []) void Promise.resolve(t.tail([event])).catch(() => {});\n        };\n        Promise.resolve(r).then(\n          () => report([]),\n          (e) =>\n            report([\n              {\n                name: (e as Error)?.name ?? \"Error\",\n                message: String((e as Error)?.message ?? e),\n                timestamp: Date.now(),\n              },\n            ]),\n        );\n        return r;\n      };\n      return {\n        getDurableObjectClass(name: string) {\n          const classesLoaded = () => {\n            let p = classCache.get(id);\n            if (!p) {\n              p = (async () => {\n                const code = await getCode();\n                return { module: await opts.classes!(id, code), env: code.env ?? {} };\n              })();\n              classCache.set(id, p);\n            }\n            return p;\n          };\n          return classHandle(async () => {\n            if (!opts.classes) {\n              const iso = (await loaded()).module[ISOLATED as unknown as string] as\n                | ((name: string) => IsolatedClass)\n                | undefined;\n              if (iso) return { isolated: iso(name) };\n            }\n            const { module, env } = opts.classes ? await classesLoaded() : await loaded();\n            const cls = module[name];\n            if (typeof cls !== \"function\")\n              throw new Error(`Loaded worker \"${id}\" does not export class \"${name}\"`);\n            return { cls: cls as DurableObjectClass, env };\n          });\n        },\n        /** Releases the loaded Worker: the id leaves the cache; a later get() loads again. */\n        dispose() {\n          cache.delete(id);\n        },\n        getEntrypoint(name = \"default\", options: { props?: unknown } = {}) {\n          // Props cross now (workerd serializes them here): a refusal is a rejected promise,\n          // so `await` and `assert.rejects` see it.\n          try {\n            cross(options.props);\n          } catch (e) {\n            const refused = Promise.reject(e);\n            refused.catch(() => {});\n            return refused as never;\n          }\n          return new Proxy(\n            {},\n            {\n              get(_t, prop) {\n                if (prop === REFUSE) return DYNAMIC_ENTRYPOINT;\n                if (prop === \"then\" || typeof prop === \"symbol\") return undefined;\n                return (...args: unknown[]) => {\n                  // Boxed, so awaiting the load does not await the call: calls on its\n                  // RpcPromise are pipelined.\n                  const run = loaded().then((l) => {\n                    const stub = entrypointStub(l.module[name], l.env, options.props, l.exports);\n                    const request =\n                      prop === \"fetch\"\n                        ? new Request(args[0] as RequestInfo, args[1] as RequestInit)\n                        : undefined;\n                    return {\n                      r: traced(l, request, () =>\n                        stub[prop as string](...(request ? [request] : args)),\n                      ),\n                    };\n                  });\n                  return rpcPromise(\n                    run.then((b) => b.r),\n                    (path, a) => run.then((b) => pipeTo(b.r, path, a)),\n                  );\n                };\n              },\n            },\n          );\n        },\n      };\n    },\n  };\n  return loader;\n}\n"]}

package/dist/bindings/workers-ai.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Workers AI (`env.AI`, wrangler `ai: { binding }`) served by an OpenAI-compatible endpoint:
+ * a local llama.cpp or Ollama server, a hosted API, or a test's fake. Text generation and
+ * embeddings; other model kinds (images, speech) are refused.
+ *
+ *   env.AI.run(model, { prompt } | { messages, tools?, stream?, ... }, options?)
+ *     → { response, tool_calls?, usage }           (Workers AI's shape)
+ *     → ReadableStream of `data: {"response": …}`  (with `stream: true`)
+ *     → the endpoint's Response as is              (with `returnRawResponse`: Flue's path)
+ *   env.AI.run(model, { text })                    → { shape, data, pooling } (embeddings)
+ */
+/** Plain data, so that it can travel to a browser worker with the rest of a project's options. */
+export interface WorkersAiOptions {
+    /** The endpoint's base URL, up to `/v1` (e.g. `http://127.0.0.1:8080/v1`). */
+    baseUrl: string;
+    /** Sent as `Authorization: Bearer …`. */
+    apiKey?: string;
+    /**
+     * Workers AI model id (`@cf/meta/llama-3.1-8b-instruct`) → the endpoint's model name; `"*"`
+     * names the model for every id not listed. Ids that map to nothing are sent as they are.
+     */
+    models?: Record<string, string>;
+}
+/** `env.AI.run`'s third argument (the parts cellb honours; `gateway` is accepted and ignored). */
+export interface AiRunOptions {
+    returnRawResponse?: boolean;
+    signal?: AbortSignal;
+    extraHeaders?: Record<string, string>;
+    gateway?: unknown;
+}
+/** Workers AI's error: `run` rejects with it when the endpoint answers with an error status. */
+export declare class AiError extends Error {
+    constructor(message: string);
+}
+export declare function workersAi(opts: WorkersAiOptions, fetchImpl?: typeof fetch): {
+    run(model: string, inputs: unknown, options?: AiRunOptions): Promise<unknown>;
+    /** Workers AI's AI Gateway: not available, `run` ignores its `gateway` option. */
+    gateway(): never;
+};

package/dist/bindings/workers-ai.js

@@ -0,0 +1,175 @@
+/**
+ * Workers AI (`env.AI`, wrangler `ai: { binding }`) served by an OpenAI-compatible endpoint:
+ * a local llama.cpp or Ollama server, a hosted API, or a test's fake. Text generation and
+ * embeddings; other model kinds (images, speech) are refused.
+ *
+ *   env.AI.run(model, { prompt } | { messages, tools?, stream?, ... }, options?)
+ *     → { response, tool_calls?, usage }           (Workers AI's shape)
+ *     → ReadableStream of `data: {"response": …}`  (with `stream: true`)
+ *     → the endpoint's Response as is              (with `returnRawResponse`: Flue's path)
+ *   env.AI.run(model, { text })                    → { shape, data, pooling } (embeddings)
+ */
+/** Workers AI's error: `run` rejects with it when the endpoint answers with an error status. */
+export class AiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AiError";
+    }
+}
+export function workersAi(opts, fetchImpl = (r, i) => fetch(r, i)) {
+    const base = opts.baseUrl.replace(/\/+$/, "");
+    const modelOf = (id) => opts.models?.[id] ?? opts.models?.["*"] ?? id;
+    const post = (path, body, o) => fetchImpl(`${base}/${path}`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            ...(opts.apiKey ? { authorization: `Bearer ${opts.apiKey}` } : {}),
+            ...o.extraHeaders,
+        },
+        body: JSON.stringify(body),
+        signal: o.signal,
+    });
+    const failed = async (res) => new AiError(`Workers AI: the model endpoint answered ${res.status}: ${await res.text()}`);
+    async function chat(model, inputs, o) {
+        const { prompt, messages, tools, stream, raw: _raw, lora: _lora, ...rest } = inputs;
+        const body = {
+            ...rest,
+            model: modelOf(model),
+            messages: messages ?? [{ role: "user", content: String(prompt) }],
+            stream: !!stream,
+        };
+        // Workers AI tools are { name, description, parameters }; OpenAI's are wrapped in `function`.
+        if (Array.isArray(tools))
+            body.tools = tools.map((t) => t.type === "function"
+                ? t
+                : {
+                    type: "function",
+                    function: { name: t.name, description: t.description, parameters: t.parameters },
+                });
+        const res = await post("chat/completions", body, o);
+        if (o.returnRawResponse)
+            return res;
+        if (!res.ok)
+            throw await failed(res);
+        if (stream && res.body)
+            return res.body.pipeThrough(toWorkersAiStream());
+        const json = (await res.json());
+        const message = json.choices?.[0]?.message ?? {};
+        const out = { response: message.content ?? "" };
+        if (message.tool_calls?.length)
+            out.tool_calls = message.tool_calls.map(toWorkersAiToolCall);
+        if (json.usage)
+            out.usage = json.usage;
+        return out;
+    }
+    async function embed(model, inputs, o) {
+        const res = await post("embeddings", { model: modelOf(model), input: inputs.text }, o);
+        if (o.returnRawResponse)
+            return res;
+        if (!res.ok)
+            throw await failed(res);
+        const json = (await res.json());
+        const data = json.data.map((d) => d.embedding);
+        return { shape: [data.length, data[0]?.length ?? 0], data, pooling: "mean" };
+    }
+    return {
+        async run(model, inputs, options = {}) {
+            if (!inputs || typeof inputs !== "object")
+                throw new TypeError("Workers AI: run(model, inputs) takes an inputs object");
+            const i = inputs;
+            if ("messages" in i || "prompt" in i)
+                return chat(model, i, options);
+            if ("text" in i)
+                return embed(model, i, options);
+            throw new AiError(`Workers AI: cellb serves text generation ({ prompt } or { messages }) and embeddings ({ text }) only; ${model} got neither`);
+        },
+        /** Workers AI's AI Gateway: not available, `run` ignores its `gateway` option. */
+        gateway() {
+            throw new AiError("Workers AI: AI Gateway is not supported by cellb");
+        },
+    };
+}
+/** Workers AI's tool call: `{ name, arguments }`, with the arguments parsed. */
+function toWorkersAiToolCall(tc) {
+    let args = tc.function?.arguments ?? {};
+    if (typeof args === "string")
+        try {
+            args = JSON.parse(args || "{}");
+        }
+        catch {
+            // not JSON: passed on as the model wrote it
+        }
+    return { name: tc.function?.name ?? "", arguments: args };
+}
+/**
+ * OpenAI chat-completion chunks (`data: {"choices":[{"delta":…}]}`) → Workers AI's stream
+ * (`data: {"response":"…"}`, then `data: [DONE]`), usage riding along. Tool calls stream in
+ * fragments (a name, then pieces of the arguments' JSON, keyed by `index`): they are gathered and
+ * sent whole, once, before `[DONE]`, as `{ response: "", tool_calls: [{ name, arguments }] }`.
+ */
+function toWorkersAiStream() {
+    const decoder = new TextDecoder();
+    const encoder = new TextEncoder();
+    let buffer = "";
+    let done = false;
+    const calls = new Map();
+    const emit = (c, data) => c.enqueue(encoder.encode(`data: ${data}\n\n`));
+    const finish = (c) => {
+        if (done)
+            return;
+        done = true;
+        if (calls.size) {
+            const toolCalls = [...calls.entries()]
+                .sort(([a], [b]) => a - b)
+                .map(([, call]) => toWorkersAiToolCall({ function: call }));
+            emit(c, JSON.stringify({ response: "", tool_calls: toolCalls }));
+        }
+        emit(c, "[DONE]");
+    };
+    const line = (c, l) => {
+        if (!l.startsWith("data:"))
+            return;
+        const data = l.slice(5).trim();
+        if (data === "[DONE]")
+            return finish(c);
+        let chunk;
+        try {
+            chunk = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        const delta = chunk.choices?.[0]?.delta;
+        for (const [i, tc] of (delta?.tool_calls ?? []).entries()) {
+            const index = tc.index ?? i;
+            const call = calls.get(index) ?? { name: "", arguments: "" };
+            call.name += tc.function?.name ?? "";
+            call.arguments += tc.function?.arguments ?? "";
+            calls.set(index, call);
+        }
+        const out = { response: delta?.content ?? "" };
+        if (chunk.usage)
+            out.usage = chunk.usage;
+        if (out.response === "" && !out.usage)
+            return;
+        emit(c, JSON.stringify(out));
+    };
+    return new TransformStream({
+        transform(bytes, c) {
+            buffer += decoder.decode(bytes, { stream: true });
+            let nl = buffer.indexOf("\n");
+            while (nl >= 0) {
+                line(c, buffer.slice(0, nl).replace(/\r$/, ""));
+                buffer = buffer.slice(nl + 1);
+                nl = buffer.indexOf("\n");
+            }
+        },
+        flush(c) {
+            buffer += decoder.decode();
+            if (buffer)
+                line(c, buffer.trim());
+            finish(c);
+        },
+    });
+}
+//# sourceMappingURL=workers-ai.js.map

package/dist/bindings/workers-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-ai.js","sourceRoot":"","sources":["../../src/bindings/workers-ai.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Workers AI (`env.AI`, wrangler `ai: { binding }`) served by an OpenAI-compatible endpoint:\n * a local llama.cpp or Ollama server, a hosted API, or a test's fake. Text generation and\n * embeddings; other model kinds (images, speech) are refused.\n *\n *   env.AI.run(model, { prompt } | { messages, tools?, stream?, ... }, options?)\n *     → { response, tool_calls?, usage }           (Workers AI's shape)\n *     → ReadableStream of `data: {\"response\": …}`  (with `stream: true`)\n *     → the endpoint's Response as is              (with `returnRawResponse`: Flue's path)\n *   env.AI.run(model, { text })                    → { shape, data, pooling } (embeddings)\n */\n\n/** Plain data, so that it can travel to a browser worker with the rest of a project's options. */\nexport interface WorkersAiOptions {\n  /** The endpoint's base URL, up to `/v1` (e.g. `http://127.0.0.1:8080/v1`). */\n  baseUrl: string;\n  /** Sent as `Authorization: Bearer …`. */\n  apiKey?: string;\n  /**\n   * Workers AI model id (`@cf/meta/llama-3.1-8b-instruct`) → the endpoint's model name; `\"*\"`\n   * names the model for every id not listed. Ids that map to nothing are sent as they are.\n   */\n  models?: Record<string, string>;\n}\n\n/** `env.AI.run`'s third argument (the parts cellb honours; `gateway` is accepted and ignored). */\nexport interface AiRunOptions {\n  returnRawResponse?: boolean;\n  signal?: AbortSignal;\n  extraHeaders?: Record<string, string>;\n  gateway?: unknown;\n}\n\ntype Json = Record<string, unknown>;\n\n/** Workers AI's error: `run` rejects with it when the endpoint answers with an error status. */\nexport class AiError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"AiError\";\n  }\n}\n\nexport function workersAi(opts: WorkersAiOptions, fetchImpl: typeof fetch = (r, i) => fetch(r, i)) {\n  const base = opts.baseUrl.replace(/\\/+$/, \"\");\n  const modelOf = (id: string) => opts.models?.[id] ?? opts.models?.[\"*\"] ?? id;\n  const post = (path: string, body: Json, o: AiRunOptions) =>\n    fetchImpl(`${base}/${path}`, {\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(opts.apiKey ? { authorization: `Bearer ${opts.apiKey}` } : {}),\n        ...o.extraHeaders,\n      },\n      body: JSON.stringify(body),\n      signal: o.signal,\n    });\n  const failed = async (res: Response) =>\n    new AiError(`Workers AI: the model endpoint answered ${res.status}: ${await res.text()}`);\n\n  async function chat(model: string, inputs: Json, o: AiRunOptions) {\n    const { prompt, messages, tools, stream, raw: _raw, lora: _lora, ...rest } = inputs;\n    const body: Json = {\n      ...rest,\n      model: modelOf(model),\n      messages: messages ?? [{ role: \"user\", content: String(prompt) }],\n      stream: !!stream,\n    };\n    // Workers AI tools are { name, description, parameters }; OpenAI's are wrapped in `function`.\n    if (Array.isArray(tools))\n      body.tools = tools.map((t: Json) =>\n        t.type === \"function\"\n          ? t\n          : {\n              type: \"function\",\n              function: { name: t.name, description: t.description, parameters: t.parameters },\n            },\n      );\n    const res = await post(\"chat/completions\", body, o);\n    if (o.returnRawResponse) return res;\n    if (!res.ok) throw await failed(res);\n    if (stream && res.body) return res.body.pipeThrough(toWorkersAiStream());\n    const json = (await res.json()) as {\n      choices?: { message?: { content?: string | null; tool_calls?: OpenAiToolCall[] } }[];\n      usage?: unknown;\n    };\n    const message = json.choices?.[0]?.message ?? {};\n    const out: Json = { response: message.content ?? \"\" };\n    if (message.tool_calls?.length) out.tool_calls = message.tool_calls.map(toWorkersAiToolCall);\n    if (json.usage) out.usage = json.usage;\n    return out;\n  }\n\n  async function embed(model: string, inputs: Json, o: AiRunOptions) {\n    const res = await post(\"embeddings\", { model: modelOf(model), input: inputs.text }, o);\n    if (o.returnRawResponse) return res;\n    if (!res.ok) throw await failed(res);\n    const json = (await res.json()) as { data: { embedding: number[] }[] };\n    const data = json.data.map((d) => d.embedding);\n    return { shape: [data.length, data[0]?.length ?? 0], data, pooling: \"mean\" };\n  }\n\n  return {\n    async run(model: string, inputs: unknown, options: AiRunOptions = {}): Promise<unknown> {\n      if (!inputs || typeof inputs !== \"object\")\n        throw new TypeError(\"Workers AI: run(model, inputs) takes an inputs object\");\n      const i = inputs as Json;\n      if (\"messages\" in i || \"prompt\" in i) return chat(model, i, options);\n      if (\"text\" in i) return embed(model, i, options);\n      throw new AiError(\n        `Workers AI: cellb serves text generation ({ prompt } or { messages }) and embeddings ({ text }) only; ${model} got neither`,\n      );\n    },\n    /** Workers AI's AI Gateway: not available, `run` ignores its `gateway` option. */\n    gateway(): never {\n      throw new AiError(\"Workers AI: AI Gateway is not supported by cellb\");\n    },\n  };\n}\n\ninterface OpenAiToolCall {\n  /** In a streamed chunk: which call a fragment belongs to. */\n  index?: number;\n  id?: string;\n  function?: { name?: string; arguments?: string };\n}\n\n/** Workers AI's tool call: `{ name, arguments }`, with the arguments parsed. */\nfunction toWorkersAiToolCall(tc: OpenAiToolCall) {\n  let args: unknown = tc.function?.arguments ?? {};\n  if (typeof args === \"string\")\n    try {\n      args = JSON.parse(args || \"{}\");\n    } catch {\n      // not JSON: passed on as the model wrote it\n    }\n  return { name: tc.function?.name ?? \"\", arguments: args };\n}\n\n/**\n * OpenAI chat-completion chunks (`data: {\"choices\":[{\"delta\":…}]}`) → Workers AI's stream\n * (`data: {\"response\":\"…\"}`, then `data: [DONE]`), usage riding along. Tool calls stream in\n * fragments (a name, then pieces of the arguments' JSON, keyed by `index`): they are gathered and\n * sent whole, once, before `[DONE]`, as `{ response: \"\", tool_calls: [{ name, arguments }] }`.\n */\nfunction toWorkersAiStream(): TransformStream<Uint8Array, Uint8Array> {\n  const decoder = new TextDecoder();\n  const encoder = new TextEncoder();\n  let buffer = \"\";\n  let done = false;\n  const calls = new Map<number, { name: string; arguments: string }>();\n  const emit = (c: TransformStreamDefaultController<Uint8Array>, data: string) =>\n    c.enqueue(encoder.encode(`data: ${data}\\n\\n`));\n  const finish = (c: TransformStreamDefaultController<Uint8Array>) => {\n    if (done) return;\n    done = true;\n    if (calls.size) {\n      const toolCalls = [...calls.entries()]\n        .sort(([a], [b]) => a - b)\n        .map(([, call]) => toWorkersAiToolCall({ function: call }));\n      emit(c, JSON.stringify({ response: \"\", tool_calls: toolCalls }));\n    }\n    emit(c, \"[DONE]\");\n  };\n  const line = (c: TransformStreamDefaultController<Uint8Array>, l: string) => {\n    if (!l.startsWith(\"data:\")) return;\n    const data = l.slice(5).trim();\n    if (data === \"[DONE]\") return finish(c);\n    let chunk: {\n      choices?: { delta?: { content?: string | null; tool_calls?: OpenAiToolCall[] } }[];\n      usage?: unknown;\n    };\n    try {\n      chunk = JSON.parse(data);\n    } catch {\n      return;\n    }\n    const delta = chunk.choices?.[0]?.delta;\n    for (const [i, tc] of (delta?.tool_calls ?? []).entries()) {\n      const index = tc.index ?? i;\n      const call = calls.get(index) ?? { name: \"\", arguments: \"\" };\n      call.name += tc.function?.name ?? \"\";\n      call.arguments += tc.function?.arguments ?? \"\";\n      calls.set(index, call);\n    }\n    const out: Json = { response: delta?.content ?? \"\" };\n    if (chunk.usage) out.usage = chunk.usage;\n    if (out.response === \"\" && !out.usage) return;\n    emit(c, JSON.stringify(out));\n  };\n  return new TransformStream({\n    transform(bytes, c) {\n      buffer += decoder.decode(bytes, { stream: true });\n      let nl = buffer.indexOf(\"\\n\");\n      while (nl >= 0) {\n        line(c, buffer.slice(0, nl).replace(/\\r$/, \"\"));\n        buffer = buffer.slice(nl + 1);\n        nl = buffer.indexOf(\"\\n\");\n      }\n    },\n    flush(c) {\n      buffer += decoder.decode();\n      if (buffer) line(c, buffer.trim());\n      finish(c);\n    },\n  });\n}\n"]}

package/dist/browser.d.ts

@@ -0,0 +1,7 @@
+export { sahpoolOpener } from "./adapters/wasm-sqlite.js";
+export { idbObjectStore } from "./bucket/idb-object-store.js";
+export { type BrowserBucket, type BrowserProjectOptions, browserProjectRuntime, } from "./project/browser-host.js";
+export { type ProjectShards, serveProjectShard, startProjectShards, } from "./project/browser-shards.js";
+export { installProjectRouter, joinProjectShards, type ProjectTabs, type ProjectTabsOptions, type ServiceWorkerScope, shardOwner, } from "./project/browser-tabs.js";
+export { createProjectSite } from "./project/site.js";
+export { serviceWorkerConnector } from "./ws/sw-connector.js";

package/dist/browser.js

@@ -0,0 +1,8 @@
+export { sahpoolOpener } from "./adapters/wasm-sqlite.js";
+export { idbObjectStore } from "./bucket/idb-object-store.js";
+export { browserProjectRuntime, } from "./project/browser-host.js";
+export { serveProjectShard, startProjectShards, } from "./project/browser-shards.js";
+export { installProjectRouter, joinProjectShards, shardOwner, } from "./project/browser-tabs.js";
+export { createProjectSite } from "./project/site.js";
+export { serviceWorkerConnector } from "./ws/sw-connector.js";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAGL,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EAIjB,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export { sahpoolOpener } from \"./adapters/wasm-sqlite.js\";\nexport { idbObjectStore } from \"./bucket/idb-object-store.js\";\nexport {\n  type BrowserBucket,\n  type BrowserProjectOptions,\n  browserProjectRuntime,\n} from \"./project/browser-host.js\";\nexport {\n  type ProjectShards,\n  serveProjectShard,\n  startProjectShards,\n} from \"./project/browser-shards.js\";\nexport {\n  installProjectRouter,\n  joinProjectShards,\n  type ProjectTabs,\n  type ProjectTabsOptions,\n  type ServiceWorkerScope,\n  shardOwner,\n} from \"./project/browser-tabs.js\";\nexport { createProjectSite } from \"./project/site.js\";\nexport { serviceWorkerConnector } from \"./ws/sw-connector.js\";\n"]}

package/dist/bucket/celld-cells.d.ts

@@ -0,0 +1,86 @@
+import type { CellBackup, CellDurability } from "../ports.js";
+import { type ObjectStore } from "./object-store.js";
+/**
+ * Cells stored the way celld stores them (docs/guarantees.md, and the keys celld dev writes
+ * in `.celld/dev/objects.sqlite3`), on any ObjectStore:
+ *
+ *   cells/<Class>:<idHex>/own.json                     {"node","epoch"}: ownership record
+ *   cells/<Class>:<idHex>/ltx/e<epoch>/0000/<min>-<max>.ltx   LTX v3, legacy LZ4 frames
+ *   nodes/<node>.json                                  {"node","expires_ms","addr",…}: node lease
+ *
+ * Ownership: an activation creates the record (If-None-Match) or advances its epoch with a
+ * compare-and-swap (If-Match), taking over only from a node whose lease expired. Durability:
+ * each committed transaction becomes an LTX file in the cell's current epoch prefix — the
+ * first one a snapshot (TXID 1), then the changed pages — and the output gate waits for the
+ * PUT. Restore: the newest epoch that starts with a snapshot, its files in TXID order.
+ */
+export interface CelldBucketOptions {
+    /** This node's name (celld: `dev-…` / the fleet node name). */
+    node: string;
+    addr?: string;
+    leaseTtlMs?: number;
+    now?: () => number;
+    /** The waker-role lease (celld: 3 × its due-scan tick); match 3 × the runtime's wakePollMs. */
+    wakerTtlMs?: number;
+}
+/** celld 0.6.3: how long a node refuses a cell whose ownership record it found lost. */
+export declare const LOST_RECORD_RECHECK_MS = 10000;
+/** The bucket's `close()` also closes `store` (when it has a `close`): pass a store of its own. */
+export declare function celldBucket(store: ObjectStore & {
+    close?(): void;
+}, opts: CelldBucketOptions): {
+    ownership: {
+        tryAcquire(cellKey: string): Promise<{
+            name: string;
+            epoch: number;
+            lost: AbortSignal;
+            release: () => Promise<void>;
+        } | undefined>;
+    };
+    durability: CellDurability & CellBackup & {
+        logCommit: CellDurability["committed"];
+    } & {
+        begin(cellKey: string, epoch: number): void;
+        forget(cellKey: string): void;
+    } & {
+        wakes(): Promise<{
+            cellKey: string;
+            className: string;
+            at: number;
+        }[]>;
+    };
+    backup: CellDurability & CellBackup & {
+        logCommit: CellDurability["committed"];
+    } & {
+        begin(cellKey: string, epoch: number): void;
+        forget(cellKey: string): void;
+    } & {
+        wakes(): Promise<{
+            cellKey: string;
+            className: string;
+            at: number;
+        }[]>;
+    };
+    /** The fleet bucket itself (R2 objects live directly in it, under `r2/<bucket>/`). */
+    objects: ObjectStore & {
+        close?(): void;
+    };
+    /**
+     * The address celld nodes reach this node at (its celld peer server): published in the
+     * node record now, so celld routes requests for our cells here instead of refusing them.
+     */
+    /**
+     * Answers celld's signed peer probe (peer_probe.rs): an Ed25519 signature over
+     * "cells-peer-probe-v1\n<node>\n<advertised addr>\n<challenge>" by this node's probe key.
+     */
+    probe(challenge: string): Promise<{
+        version: number;
+        node: string;
+        advertise: string;
+        challenge: string;
+        signature: string;
+    }>;
+    advertise(address: string): Promise<void>;
+    /** Clean shutdown: stop renewing, remove this node's lease record, close the store. */
+    close(): Promise<void>;
+};