@wenathlan/saddle 1.8.7 → 1.8.9

package/dist/library/public.js

@@ -0,0 +1,83 @@
+/**
+ * public library helpers compose fetch extraction serialization chunking and crawl contracts.
+ */
+import { crawl } from "../scrape/crawl.js";
+import { chunkmarkdown } from "../ai/chunk.js";
+import { estimatetokens } from "../ai/tokens.js";
+import { extracthtml } from "../scrape/extract.js";
+import { normalizeresponse } from "../scrape/normalize.js";
+import { browseragent } from "../browser/agent.js";
+/** Selects the fetch or browser execution path. */
+export async function saddleurl(url, options = {}) {
+    const mode = options.mode ?? "fetch";
+    if (mode === "browser")
+        return scrapewithbrowser(url, options);
+    return scrapeurl(url, options);
+}
+/** Fetches one URL through the caller supplied transport. */
+export async function scrapeurl(url, options = {}) {
+    const target = safeurl(url);
+    const response = await (options.fetcher ?? fetch)(target, { signal: options.signal, headers: options.headers });
+    if (!response.ok)
+        throw new Error(`scrape request failed with ${response.status}`);
+    const normalized = await normalizeresponse(response, { url: target, defaultcontenttype: "text/html", maxbytes: options.maxbytes });
+    const result = normalized.kind === "html" ? scrapehtml(normalized.content, target, options) : { content: normalized.content, data: normalized.data, metadata: { url: target, contenttype: normalized.contenttype, size: normalized.size }, bytes: normalized.bytes };
+    return formatresult(result, options);
+}
+/** Extracts a serializable result from HTML without network access. */
+export function scrapehtml(html, url, options = {}) {
+    const result = extracthtml(html, url);
+    return { content: result.text, metadata: { url: result.url, title: result.title, description: result.description, links: result.links }, html: options.includehtml ? html : undefined };
+}
+/** Exposes structured extraction for callers that do not need formatting. */
+export function extractcontent(html, options = {}) { return extracthtml(html, options.url); }
+/** Runs a scrape through the injected browser agent contract. */
+export async function scrapewithbrowser(url, options = {}) {
+    const agent = browseragent(options.browser);
+    await agent.navigate({ url, waituntil: options.waituntil ?? "networkidle" });
+    return formatresult({ content: await agent.text(), metadata: { url, title: await agent.title(), html: options.includehtml ? await agent.html() : undefined } }, options);
+}
+/** Serializes a result into a supported output format. */
+export function serializeresult(result, options = {}) {
+    const format = options.format ?? "json";
+    if (format === "json")
+        return JSON.stringify(result, null, options.pretty ? 2 : 0);
+    if (format === "text")
+        return result.content ?? "";
+    if (format === "markdown")
+        return `# ${result.metadata?.title ?? "result"}\n\n${result.content ?? ""}`;
+    if (format === "xml")
+        return `<result><title>${escape(result.metadata?.title ?? "")}</title><content>${escape(result.content ?? "")}</content></result>`;
+    if (format === "redis")
+        return JSON.stringify({ content: result.content, metadata: result.metadata });
+    throw new TypeError(`unsupported format: ${format}`);
+}
+/** Converts local HTML into Markdown. */
+export function serializehtml(html, options = {}) { return serializeresult(scrapehtml(html, options.url), { format: "markdown" }); }
+/** Builds compact context for an agent or a vector pipeline. */
+export function formatforagent(result, options = {}) {
+    const content = result.content ?? "";
+    const chunks = chunkmarkdown(content, { maxtokens: options.maxchunksize ?? 4000 });
+    const lines = content.split(/[.!?]\s+/).filter(Boolean);
+    return { summary: lines.slice(0, 2).join(". "), keypoints: lines.slice(0, options.keypoints ?? 5), relevanturls: result.metadata?.links ?? [], chunks, tokencount: estimatetokens(content, options.model) };
+}
+/** Processes URLs in bounded groups and emits progress events. */
+export async function batchscrape(options = {}) {
+    const urls = options.urls ?? [];
+    const concurrency = options.concurrency ?? 10;
+    const results = [];
+    for (let index = 0; index < urls.length; index += concurrency) {
+        const group = urls.slice(index, index + concurrency);
+        const completed = await Promise.all(group.map((url) => scrapeurl(url, options)));
+        results.push(...completed);
+        options.onprogress?.({ completed: results.length, total: urls.length });
+    }
+    return results;
+}
+/** Runs the crawler through the public scrape contract. */
+export async function crawlurl(url, options = {}) { return crawl(url, { ...options, scrape: (target) => scrapeurl(target, options) }); }
+function safeurl(value) { const url = new URL(value); if (!["http:", "https:"].includes(url.protocol))
+    throw new TypeError("url must use http or https"); return url.href; }
+function formatresult(result, options) { return options.format ? { ...result, serialized: serializeresult(result, options) } : result; }
+function escape(value) { return String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;"); }
+//# sourceMappingURL=public.js.map

package/dist/library/public.js.map

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

package/dist/mcp/browser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * browser MCP tools expose snapshots and actions only through an injected browser adapter.
+ */
+/** Creates optional browser tools for an MCP server without selecting Playwright or another vendor. */
+export declare function browsertools(browser: any): {
+    browser_snapshot: (input?: {}) => Promise<any>;
+    browser_action: (input?: {}) => Promise<any>;
+};
+//# sourceMappingURL=browser.d.ts.map

package/dist/mcp/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../mcp/browser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,OAAO,KAAA;IAGhC,gBAAgB;IAChB,cAAc;EAEjB"}

package/dist/mcp/browser.js

@@ -0,0 +1,13 @@
+/**
+ * browser MCP tools expose snapshots and actions only through an injected browser adapter.
+ */
+/** Creates optional browser tools for an MCP server without selecting Playwright or another vendor. */
+export function browsertools(browser) {
+    if (typeof browser?.snapshot !== "function" || typeof browser?.action !== "function")
+        throw new TypeError("browser MCP tools require snapshot and action");
+    return {
+        browser_snapshot: async (input = {}) => browser.snapshot(input),
+        browser_action: async (input = {}) => browser.action(input)
+    };
+}
+//# sourceMappingURL=browser.js.map

package/dist/mcp/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../mcp/browser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uGAAuG;AACvG,MAAM,UAAU,YAAY,CAAC,OAAO;IAClC,IAAI,OAAO,OAAO,EAAE,QAAQ,KAAK,UAAU,IAAI,OAAO,OAAO,EAAE,MAAM,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IAC3J,OAAO;QACL,gBAAgB,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC/D,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,35 @@
+export declare function mcpserver(options?: {}): {
+    listtools(): {
+        name: string;
+        description: string;
+    }[];
+    handle(request: any): Promise<{
+        jsonrpc: string;
+        id: any;
+        result: {
+            tools: any;
+            content?: undefined;
+        };
+        error?: undefined;
+    } | {
+        jsonrpc: string;
+        id: any;
+        result: {
+            tools?: undefined;
+            content: {
+                type: string;
+                text: string;
+            }[];
+        };
+        error?: undefined;
+    } | {
+        result?: undefined;
+        jsonrpc: string;
+        id: any;
+        error: {
+            code: number;
+            message: any;
+        };
+    }>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../mcp/server.ts"],"names":[],"mappings":"AAQA,wBAAgB,SAAS,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAeoY,IAAI;YAAU,OAAO;;;EAI9b"}

package/dist/mcp/server.js

@@ -0,0 +1,40 @@
+/**
+ * mcp server implements a small JSON RPC tool surface and remains transport agnostic.
+ */
+import { crawl } from "../scrape/crawl.js";
+import { extractwithschema } from "../scrape/schema.js";
+import { jsonencode } from "../protocol/json.js";
+import { browsertools } from "./browser.js";
+export function mcpserver(options = {}) {
+    if (typeof options.scrape !== "function")
+        throw new TypeError("mcp server requires scrape");
+    const tools = {
+        scrape: async (input) => options.scrape(input.url, input),
+        crawl: async (input) => crawl(input.url, { ...input, scrape: (url) => options.scrape(url, input) }),
+        batch: async (input) => ({ results: await Promise.all((input.urls ?? []).map((url) => options.scrape(url, input))) }),
+        extract: async (input) => extractwithschema(input.html, input.schema, input.url),
+        serialize: async (input) => jsonencode(input.value),
+        ...(options.browser ? browsertools(options.browser) : {}),
+        ...(options.tools ?? {})
+    };
+    return {
+        listtools() { return Object.keys(tools).map((name) => ({ name, description: `saddle ${name} tool` })); },
+        async handle(request) {
+            if (request.method === "tools/list")
+                return { jsonrpc: "2.0", id: request.id, result: { tools: this.listtools() } };
+            if (request.method === "tools/call") {
+                const handler = tools[request.params?.name];
+                if (!handler)
+                    return { jsonrpc: "2.0", id: request.id, error: { code: -32601, message: "tool not found" } };
+                try {
+                    return { jsonrpc: "2.0", id: request.id, result: { content: [{ type: "text", text: JSON.stringify(await handler(request.params.arguments ?? {})) }] } };
+                }
+                catch (error) {
+                    return { jsonrpc: "2.0", id: request.id, error: { code: -32000, message: error.message } };
+                }
+            }
+            return { jsonrpc: "2.0", id: request.id, error: { code: -32601, message: "method not found" } };
+        }
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/transport.d.ts

@@ -0,0 +1,7 @@
+/** Creates JSONL and HTTP handlers for the transport agnostic MCP server. */
+export declare function mcptransport(server: any): {
+    handleline(line: any): Promise<string>;
+    stream(lines: any): AsyncGenerator<any, void, unknown>;
+    handlehttp(request: any): Promise<Response>;
+};
+//# sourceMappingURL=transport.d.ts.map

package/dist/mcp/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../mcp/transport.ts"],"names":[],"mappings":"AAKA,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,KAAA;;;;EAOlC"}

package/dist/mcp/transport.js

@@ -0,0 +1,17 @@
+/**
+ * mcp transport keeps JSON RPC framing separate from the tool server.
+ */
+import { jsondecode, jsonencode } from "../protocol/json.js";
+/** Creates JSONL and HTTP handlers for the transport agnostic MCP server. */
+export function mcptransport(server) {
+    if (typeof server?.handle !== "function")
+        throw new TypeError("mcp transport requires server");
+    return {
+        async handleline(line) { const request = jsondecode(line); return jsonencode(await server.handle(request)); },
+        async *stream(lines) { for await (const line of lines)
+            if (String(line).trim())
+                yield await this.handleline(line); },
+        async handlehttp(request) { const body = await request.text(); const response = await server.handle(jsondecode(body)); return new Response(jsonencode(response), { status: 200, headers: { "content-type": "application/json" } }); }
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/mcp/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../mcp/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7D,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,MAAM;IACjC,IAAI,OAAO,MAAM,EAAE,MAAM,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC/F,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7G,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;gBAAE,MAAM,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpH,KAAK,CAAC,UAAU,CAAC,OAAO,IAAI,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;KACtO,CAAC;AACJ,CAAC"}

package/dist/memory/bridge.d.ts

@@ -0,0 +1,14 @@
+export declare function localmemory(options?: {}): {
+    prepare(job: any): Promise<{
+        jobid: any;
+        location: any;
+        resultpath: any;
+        createdat: number;
+    }>;
+    sync(set: any, bytes: any): Promise<{
+        bytes: any;
+        location: any;
+    }>;
+    cleanup(set: any): Promise<void>;
+};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/memory/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../memory/bridge.ts"],"names":[],"mappings":"AAQA,wBAAgB,WAAW,CAAC,OAAO,KAAK;;;;;;;;;;;;EAOvC"}

package/dist/memory/bridge.js

@@ -0,0 +1,16 @@
+/**
+ * memory bridges materialize and clear temporary working sets.
+ */
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { syncresult, workingset } from "../domain/runtime.js";
+export function localmemory(options = {}) {
+    const base = options.base ?? tmpdir();
+    return {
+        async prepare(job) { const location = await mkdtemp(join(base, "saddlejob")); return workingset(job.id, location, join(location, "resultbin")); },
+        async sync(set, bytes) { await mkdir(set.location, { recursive: true }); await writeFile(set.resultpath, bytes); return syncresult(bytes.byteLength, set.resultpath); },
+        async cleanup(set) { await rm(set.location, { recursive: true, force: true }); }
+    };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/memory/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../memory/bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,UAAU,WAAW,CAAC,OAAO,GAAG,EAAE;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;IACtC,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACjJ,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvK,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;KACjF,CAAC;AACJ,CAAC"}

package/dist/memory/engine.d.ts

@@ -0,0 +1,28 @@
+import { transformtocompute, transformtostorage } from "./transforms.js";
+export declare function memoryengine(options?: {}): {
+    load: (key: any) => Promise<any>;
+    persist: (key: any, data: any, options?: {}) => Promise<{
+        id: any;
+        buffer: Uint8Array<ArrayBufferLike>;
+        size: number;
+        type: any;
+        createdat: any;
+        metadata: any;
+    }>;
+    release: (key: any) => void;
+    safeload: (key: any) => Promise<{
+        success: boolean;
+        data: any;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+        data?: undefined;
+    }>;
+    sync: (key: any, options?: {}) => Promise<any[]>;
+    capabilities: () => any;
+    transformtocompute: typeof transformtocompute;
+    transformtostorage: typeof transformtostorage;
+    list(): any[];
+};
+//# sourceMappingURL=engine.d.ts.map

package/dist/memory/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../memory/engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,wBAAgB,YAAY,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;EAqCxC"}

package/dist/memory/engine.js

@@ -0,0 +1,59 @@
+/**
+ * memory engine loads from the first backend and persists to every backend.
+ */
+import { memoryobject, tobytes } from "./objects.js";
+import { transformtocompute, transformtostorage } from "./transforms.js";
+import { storagecapabilities, syncbackends } from "../storage/sync.js";
+export function memoryengine(options = {}) {
+    const backends = options.backends ?? [];
+    const values = new Map();
+    async function load(key) {
+        if (!key)
+            throw new TypeError("memory key is required");
+        if (values.has(key))
+            return values.get(key);
+        let last;
+        for (const backend of backends) {
+            try {
+                const value = await backend.get(key);
+                if (value == null)
+                    continue;
+                const object = memoryobject({ id: key, buffer: value.data ?? value, type: value.contenttype ?? value.type, metadata: value.metadata });
+                values.set(key, object);
+                return object;
+            }
+            catch (error) {
+                last = error;
+            }
+        }
+        if (last)
+            throw new Error(`memory engine load failed for key "${key}": ${last.message}`, { cause: last });
+        throw new Error(`memory engine load failed for key "${key}": not found`);
+    }
+    async function persist(key, data, options = {}) {
+        const payload = tobytes(data?.payload ?? data?.buffer ?? data);
+        const object = memoryobject({ id: key, buffer: payload, type: options.mimetype ?? data?.mimetype, metadata: options.metadata ?? data?.metadata });
+        for (const backend of backends)
+            await backend.put(key, { data: object.buffer, contenttype: object.type, metadata: object.metadata });
+        values.set(key, object);
+        return object;
+    }
+    function release(key) { values.delete(key); }
+    async function safeload(key) { try {
+        return { success: true, data: await load(key) };
+    }
+    catch (error) {
+        return { success: false, error };
+    } }
+    async function sync(key, options = {}) {
+        const sourceindex = Number(options.sourceindex ?? 0);
+        const source = backends[sourceindex];
+        if (!source)
+            throw new TypeError("memory sync source backend is missing");
+        const targets = backends.filter((_backend, index) => index !== sourceindex);
+        return syncbackends(source, targets, key, options);
+    }
+    function capabilities() { return backends.map((backend, index) => ({ index, capabilities: storagecapabilities(backend) })); }
+    return { load, persist, release, safeload, sync, capabilities, transformtocompute, transformtostorage, list() { return [...values.keys()]; } };
+}
+//# sourceMappingURL=engine.js.map

package/dist/memory/engine.js.map

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

package/dist/memory/modes.d.ts

@@ -0,0 +1,43 @@
+/**
+ * memory modes expose the same byte contract with different backing choices.
+ */
+export declare function internalmemory(initial?: {}): {
+    mode: string;
+    put(key: any, value: any): Promise<{
+        key: any;
+        bytes: number;
+    }>;
+    get(key: any): Promise<Uint8Array<ArrayBufferLike>>;
+    delete(key: any): Promise<void>;
+    list(): Promise<string[]>;
+};
+export declare function externalmemory(storage: any): {
+    mode: string;
+    put(key: any, value: any): Promise<any>;
+    get(key: any): Promise<any>;
+    delete(key: any): Promise<any>;
+    list(prefix: any): Promise<any>;
+};
+export declare function physicalmemory(options?: {}): {
+    mode: string;
+    path: any;
+    put: any;
+    get: any;
+    delete: any;
+    list: any;
+};
+export declare function vectorizedmemory(): {
+    mode: string;
+    put(key: any, vector: any): Promise<{
+        key: any;
+        dimensions: any;
+    }>;
+    get(key: any): Promise<any>;
+    average(keys: any): Promise<number[]>;
+    list(): Promise<any[]>;
+};
+export declare function librarymemory(factory: any): {
+    mode: string;
+    load(options: any): Promise<any>;
+};
+//# sourceMappingURL=modes.d.ts.map

package/dist/memory/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../memory/modes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,KAAK;;;;;;;;;EAS1C;AAED,wBAAgB,cAAc,CAAC,OAAO,KAAA;;;;;;EASrC;AAED,wBAAgB,cAAc,CAAC,OAAO,KAAK;IAEhC,IAAI;IAAc,IAAI;IAAgB,GAAG;IAAe,GAAG;IAAe,MAAM;IAAkB,IAAI;EAChH;AAED,wBAAgB,gBAAgB;;;;;;;;;EAS/B;AAED,wBAAgB,aAAa,CAAC,OAAO,KAAA;;;EAGpC"}

package/dist/memory/modes.js

@@ -0,0 +1,66 @@
+/**
+ * memory modes expose the same byte contract with different backing choices.
+ */
+export function internalmemory(initial = {}) {
+    const values = new Map(Object.entries(initial).map(([key, value]) => [key, tobytes(value)]));
+    return {
+        mode: "internal",
+        async put(key, value) { values.set(key, tobytes(value)); return { key, bytes: values.get(key).byteLength }; },
+        async get(key) { return values.get(key) ?? null; },
+        async delete(key) { values.delete(key); },
+        async list() { return [...values.keys()]; }
+    };
+}
+export function externalmemory(storage) {
+    if (!storage?.put || !storage?.get)
+        throw new TypeError("external memory requires storage adapter");
+    return {
+        mode: "external",
+        async put(key, value) { return storage.put({ key, data: tobytes(value) }); },
+        async get(key) { try {
+            return await storage.get(key);
+        }
+        catch (error) {
+            if (error.code === "ARTIFACT_NOT_FOUND")
+                return null;
+            throw error;
+        } },
+        async delete(key) { return storage.delete(key); },
+        async list(prefix) { return storage.list(prefix); }
+    };
+}
+export function physicalmemory(options = {}) {
+    if (!options.path)
+        throw new TypeError("physical memory requires a path");
+    return { mode: "physical", path: options.path, put: options.put, get: options.get, delete: options.delete, list: options.list };
+}
+export function vectorizedmemory() {
+    const vectors = new Map();
+    return {
+        mode: "vectorized",
+        async put(key, vector) { assertvector(vector); vectors.set(key, [...vector]); return { key, dimensions: vector.length }; },
+        async get(key) { return vectors.get(key) ?? null; },
+        async average(keys) { const selected = keys.map((key) => vectors.get(key)).filter(Boolean); if (!selected.length)
+            return null; const size = selected[0].length; const result = Array.from({ length: size }, () => 0); for (const vector of selected)
+            for (let index = 0; index < size; index += 1)
+                result[index] += vector[index] / selected.length; return result; },
+        async list() { return [...vectors.keys()]; }
+    };
+}
+export function librarymemory(factory) {
+    if (typeof factory !== "function")
+        throw new TypeError("library memory requires a factory");
+    return { mode: "library", async load(options) { return factory(options); } };
+}
+function tobytes(value) {
+    if (value instanceof Uint8Array)
+        return value;
+    if (typeof value === "string")
+        return new TextEncoder().encode(value);
+    return new TextEncoder().encode(JSON.stringify(value));
+}
+function assertvector(vector) {
+    if (!Array.isArray(vector) || vector.length === 0 || vector.some((value) => !Number.isFinite(value)))
+        throw new TypeError("vector must be a non empty numeric array");
+}
+//# sourceMappingURL=modes.js.map

package/dist/memory/modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../memory/modes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,EAAE;IACzC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC7G,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAO;IACpC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG;QAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IACpG,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5E,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC;YAAC,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB;gBAAE,OAAO,IAAI,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC,CAAC,CAAC;QAC9I,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,EAAE;IACzC,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;IAC1E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AAClI,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC1B,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1H,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACnD,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,MAAM,IAAI,QAAQ;YAAE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC;gBAAE,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;QACrW,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAO;IACnC,IAAI,OAAO,OAAO,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC5F,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,SAAS,OAAO,CAAC,KAAK;IACpB,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,YAAY,CAAC,MAAM;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;AACxK,CAAC"}

package/dist/memory/objects.d.ts

@@ -0,0 +1,21 @@
+/**
+ * memory objects and compute results are serializable contracts between storage and runtime.
+ */
+export declare function memoryobject(options?: {}): {
+    id: any;
+    buffer: Uint8Array<ArrayBufferLike>;
+    size: number;
+    type: any;
+    createdat: any;
+    metadata: any;
+};
+export declare function computeresult(options?: {}): {
+    id: any;
+    payload: any;
+    mimetype: any;
+    metadata: any;
+    processingtimems: any;
+    memoryusedbytes: any;
+};
+export declare function tobytes(value: any): Uint8Array<ArrayBufferLike>;
+//# sourceMappingURL=objects.d.ts.map

package/dist/memory/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../memory/objects.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,KAAK;;;;;;;EAGxC;AAED,wBAAgB,aAAa,CAAC,OAAO,KAAK;IAC/B,EAAE;IAAoD,OAAO;IAAmB,QAAQ;IAAoB,QAAQ;IAAmC,gBAAgB;IAAiC,eAAe;EACjO;AAED,wBAAgB,OAAO,CAAC,KAAK,KAAA,+BAK5B"}

package/dist/memory/objects.js

@@ -0,0 +1,20 @@
+/**
+ * memory objects and compute results are serializable contracts between storage and runtime.
+ */
+export function memoryobject(options = {}) {
+    const buffer = tobytes(options.buffer ?? options.data ?? new Uint8Array(0));
+    return { id: options.id ?? `memory${Date.now().toString(36)}`, buffer, size: buffer.byteLength, type: options.type ?? "application/octet-stream", createdat: options.createdat ?? Date.now(), metadata: { ...(options.metadata ?? {}) } };
+}
+export function computeresult(options = {}) {
+    return { id: options.id ?? `result${Date.now().toString(36)}`, payload: options.payload, mimetype: options.mimetype, metadata: { ...(options.metadata ?? {}) }, processingtimems: options.processingtimems ?? 0, memoryusedbytes: options.memoryusedbytes ?? 0 };
+}
+export function tobytes(value) {
+    if (value instanceof Uint8Array)
+        return value;
+    if (value instanceof ArrayBuffer)
+        return new Uint8Array(value);
+    if (typeof value === "string")
+        return new TextEncoder().encode(value);
+    return new TextEncoder().encode(JSON.stringify(value));
+}
+//# sourceMappingURL=objects.js.map

package/dist/memory/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../memory/objects.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,EAAE;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,0BAA0B,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;AAC5O,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAO,GAAG,EAAE;IACxC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;AACnQ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAK;IAC3B,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACzD,CAAC"}