@x12i/memorix-scoper-functions 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+# @x12i/memorix-scoper-functions
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Runs saved query and scope functions, and asks `@x12i/coder-dispatcher` to write one when a question has no saved function yet.
+
+A **query** function fetches records through the host SDK. A **scope** function answers the question from those records. A function is kept only after it passes its tests. Each kept function is a `@x12i/pagx` sub-package under the directory in `SCOPER_FUNCTIONS_DIR`, so a later process can install it and run the same file.
+
+The parent package is a root and has no `catalog.json`. Each function sub-package has `catalog.json` next to `pagx.json`. Publishing seeds the live catalog and inserts an item id only when that id is not already stored. A later save leaves an existing catalog item as it is.
+
+```ts
+import { createScoper } from "@x12i/memorix-scoper";
+import { createScopeFunctions } from "@x12i/memorix-scoper-functions";
+
+const functions = createScopeFunctions({ dir: "./scope-functions" });
+const scoper = createScoper({ functions });
+```
+
+`@x12i/coder-dispatcher` is optional. Without it, saved functions still run, and a question with no saved function uses the reasoner.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createScopeFunctions, type CreateScopeFunctionsOptions, } from "./registry.js";
+export { signatureId, signatureOf, type FunctionSignature } from "./signature.js";
+export { FunctionSourceError } from "./source.js";
+export { FunctionRunError } from "./run.js";
+export { DEFAULT_PACKAGE_NAME, FUNCTION_AGENT_TYPE } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { createScopeFunctions, } from "./registry.js";
+export { signatureId, signatureOf } from "./signature.js";
+export { FunctionSourceError } from "./source.js";
+export { FunctionRunError } from "./run.js";
+export { DEFAULT_PACKAGE_NAME, FUNCTION_AGENT_TYPE } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,WAAW,EAA0B,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/learn.d.ts

@@ -0,0 +1,66 @@
+import type { DispatcherDeps } from "@x12i/coder-dispatcher";
+import type { ScopeRequest, ScoperBudgets, ScoperProfile } from "@x12i/memorix-scoper-contracts";
+import type { ContextualSdk } from "@x12i/memorix-scoper-sdk";
+import type { ScopeFunctionRecord } from "@x12i/memorix-scoper";
+export interface CoderFile {
+    path: string;
+    content: string;
+}
+export interface CoderRunResult {
+    files: CoderFile[];
+}
+export type RequestCodeFn = (input: {
+    request: string;
+    language: "javascript";
+    deliverable: "function";
+    backend?: "auto";
+}, deps?: DispatcherDeps) => Promise<CoderRunResult>;
+export declare function sourceFromFiles(files: CoderFile[]): string;
+export declare function executeQuery(options: {
+    source: string;
+    request: ScopeRequest;
+    profile: ScoperProfile;
+    budgets: ScoperBudgets;
+    sdk: ContextualSdk;
+}): Promise<ScopeFunctionRecord[]>;
+export declare function executeScope(options: {
+    source: string;
+    request: ScopeRequest;
+    records: ScopeFunctionRecord[];
+    timeoutMs: number;
+}): Promise<string>;
+export declare function proveQuery(options: {
+    source: string;
+    request: ScopeRequest;
+    profile: ScoperProfile;
+    budgets: ScoperBudgets;
+    sdk: ContextualSdk;
+}): Promise<ScopeFunctionRecord[]>;
+export declare function proveScope(options: {
+    source: string;
+    request: ScopeRequest;
+    records: ScopeFunctionRecord[];
+    timeoutMs: number;
+}): Promise<string>;
+export declare function learnQuery(options: {
+    requestCode: RequestCodeFn;
+    coderDeps?: DispatcherDeps;
+    request: ScopeRequest;
+    profile: ScoperProfile;
+    budgets: ScoperBudgets;
+    sdk: ContextualSdk;
+}): Promise<{
+    source: string;
+    records: ScopeFunctionRecord[];
+} | undefined>;
+export declare function learnScope(options: {
+    requestCode: RequestCodeFn;
+    coderDeps?: DispatcherDeps;
+    request: ScopeRequest;
+    records: ScopeFunctionRecord[];
+    timeoutMs: number;
+}): Promise<{
+    source: string;
+    answer: string;
+} | undefined>;
+//# sourceMappingURL=learn.d.ts.map

package/dist/learn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../src/learn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAehE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,EACD,IAAI,CAAC,EAAE,cAAc,KAClB,OAAO,CAAC,cAAc,CAAC,CAAC;AA8C7B,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAU1D;AAyED,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,aAAa,CAAC;CACpB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAWjC;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,aAAa,CAAC;CACpB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA6BjC;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAelB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,aAAa,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAAG,SAAS,CAAC,CAgB1E;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAgB1D"}

package/dist/learn.js

@@ -0,0 +1,204 @@
+import { acceptAnswer, acceptRecords, createLiveSubjects, FunctionRunError, queryPayload, recordIds, runHandle, scopePayload, } from "./run.js";
+import { assertRunnableSource } from "./source.js";
+function stable(value) {
+    if (Array.isArray(value))
+        return `[${value.map((item) => stable(item)).join(",")}]`;
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
+        return `{${entries.map(([key, item]) => `${JSON.stringify(key)}:${stable(item)}`).join(",")}}`;
+    }
+    return JSON.stringify(value) ?? "null";
+}
+function recording(api, calls) {
+    const wrap = (method) => async (args) => {
+        const result = await api[method](args);
+        calls.push({ method, args: stable(args), result: structuredClone(result) });
+        return result;
+    };
+    return { get: wrap("get"), list: wrap("list"), query: wrap("query") };
+}
+function replay(calls) {
+    let index = 0;
+    const take = (method, args) => {
+        const call = calls[index++];
+        if (!call || call.method !== method || call.args !== stable(args)) {
+            throw new FunctionRunError("Query function is not deterministic.", "BAD_RESULT");
+        }
+        return structuredClone(call.result);
+    };
+    return {
+        get: (args) => Promise.resolve(take("get", args)),
+        list: (args) => Promise.resolve(take("list", args)),
+        query: (args) => Promise.resolve(take("query", args)),
+    };
+}
+export function sourceFromFiles(files) {
+    const normalized = files.map((file) => ({
+        ...file,
+        path: file.path.replaceAll("\\", "/"),
+    }));
+    const preferred = normalized.find((file) => file.path === "function.mjs" || file.path.endsWith("/function.mjs"));
+    const handle = normalized.find((file) => /\bfunction\s+handle\b/.test(file.content));
+    const file = preferred ?? handle;
+    if (!file)
+        throw new FunctionRunError("Coder returned no handle function.", "RUN_FAILED");
+    return file.content;
+}
+function rules() {
+    return [
+        "Write one file named function.mjs.",
+        "Export async function handle(input).",
+        "Do not import anything.",
+        "Do not use require, process, fetch, or fs.",
+    ].join("\n");
+}
+function queryPrompt(request, profile, failure) {
+    return [
+        "Kind: query",
+        rules(),
+        "handle fetches the records that answer the question.",
+        "input has question, objective, focus, catalog, and subjects.",
+        "subjects.get({ objectType, contentType, id }) returns { record, ref }.",
+        "subjects.list({ objectType, contentType, limit }) returns { records, refs }.",
+        "subjects.query({ objectType, contentType, limit, filter }) returns { records, refs }.",
+        "Return { records: [{ recordId, objectType, contentType, record }] }.",
+        "Every recordId must be one subjects returned. Return an empty records array when nothing matches.",
+        `Profile: ${profile.id}`,
+        `Allowed capabilities: ${profile.allowedCapabilities.join(", ")}`,
+        `Question: ${request.question}`,
+        `Objective: ${request.objective ?? ""}`,
+        `Focus: ${JSON.stringify(request.focus ?? {})}`,
+        failure ? `The previous function failed its test: ${failure}\nReturn a corrected function.mjs.` : "",
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function scopePrompt(request, failure) {
+    return [
+        "Kind: scope",
+        rules(),
+        "handle answers the question from input.records only.",
+        "input has question, objective, focus, and records.",
+        "Each record has recordId, objectType, contentType, and record.",
+        "Return { answer } as a non-empty string.",
+        "If records is empty, answer UNKNOWN.",
+        "Do not invent record ids.",
+        `Question: ${request.question}`,
+        `Objective: ${request.objective ?? ""}`,
+        `Focus: ${JSON.stringify(request.focus ?? {})}`,
+        failure ? `The previous function failed its test: ${failure}\nReturn a corrected function.mjs.` : "",
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+async function ask(options) {
+    const result = await options.requestCode({
+        request: options.request,
+        language: "javascript",
+        deliverable: "function",
+        backend: "auto",
+    }, options.coderDeps);
+    return sourceFromFiles(result.files);
+}
+export async function executeQuery(options) {
+    assertRunnableSource(options.source);
+    const live = createLiveSubjects(options.sdk, options.profile, options.budgets);
+    const raw = await runHandle({
+        source: options.source,
+        mode: "query",
+        input: queryPayload(options.request, options.profile, options.sdk),
+        subjects: live.api,
+        timeoutMs: options.budgets.maxWallClockMs,
+    });
+    return acceptRecords(raw, live.seen);
+}
+export async function executeScope(options) {
+    assertRunnableSource(options.source);
+    return acceptAnswer(await runHandle({
+        source: options.source,
+        mode: "scope",
+        input: scopePayload(options.request, options.records),
+        timeoutMs: options.timeoutMs,
+    }));
+}
+export async function proveQuery(options) {
+    assertRunnableSource(options.source);
+    const live = createLiveSubjects(options.sdk, options.profile, options.budgets);
+    const calls = [];
+    const input = queryPayload(options.request, options.profile, options.sdk);
+    const timeoutMs = options.budgets.maxWallClockMs;
+    const firstRaw = await runHandle({
+        source: options.source,
+        mode: "query",
+        input,
+        subjects: recording(live.api, calls),
+        timeoutMs,
+    });
+    const first = acceptRecords(firstRaw, live.seen);
+    if (first.length > options.budgets.maxEvidenceItems) {
+        throw new FunctionRunError("Query function returned more records than the evidence budget.", "BAD_RESULT");
+    }
+    const secondRaw = await runHandle({
+        source: options.source,
+        mode: "query",
+        input,
+        subjects: replay(calls),
+        timeoutMs,
+    });
+    const second = acceptRecords(secondRaw, live.seen);
+    if (recordIds(first) !== recordIds(second)) {
+        throw new FunctionRunError("Query function is not deterministic.", "BAD_RESULT");
+    }
+    return first;
+}
+export async function proveScope(options) {
+    assertRunnableSource(options.source);
+    const once = async (records) => acceptAnswer(await runHandle({
+        source: options.source,
+        mode: "scope",
+        input: scopePayload(options.request, records),
+        timeoutMs: options.timeoutMs,
+    }));
+    const first = await once(structuredClone(options.records));
+    const second = await once(structuredClone(options.records));
+    if (first !== second)
+        throw new FunctionRunError("Scope function is not deterministic.", "BAD_RESULT");
+    return first;
+}
+export async function learnQuery(options) {
+    let failure;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const source = await ask({
+                requestCode: options.requestCode,
+                coderDeps: options.coderDeps,
+                request: queryPrompt(options.request, options.profile, failure),
+            });
+            const records = await proveQuery({ ...options, source });
+            return { source, records };
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+    }
+    return undefined;
+}
+export async function learnScope(options) {
+    let failure;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const source = await ask({
+                requestCode: options.requestCode,
+                coderDeps: options.coderDeps,
+                request: scopePrompt(options.request, failure),
+            });
+            const answer = await proveScope({ ...options, source });
+            return { source, answer };
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=learn.js.map

package/dist/learn.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,18 @@
+import type { DispatcherDeps } from "@x12i/coder-dispatcher";
+import type { ScopeFunctions } from "@x12i/memorix-scoper";
+import { type RequestCodeFn } from "./learn.js";
+export interface CreateScopeFunctionsOptions {
+    /** Writable pagx package that receives new function sub-packages. */
+    dir: string;
+    /** Parent package name. Default `@x12i/scope-functions`. */
+    packageName?: string;
+    /** Project whose `.pagx` install tree is also searched. Default `process.cwd()`. */
+    projectDir?: string;
+    /** When false, a miss does not ask the coder. Default true. */
+    learn?: boolean;
+    /** Test double for `@x12i/coder-dispatcher` `requestCode`. */
+    requestCode?: RequestCodeFn;
+    coderDeps?: DispatcherDeps;
+}
+export declare function createScopeFunctions(options: CreateScopeFunctionsOptions): ScopeFunctions;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAwB,cAAc,EAAuB,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAsD,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAWpG,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAWD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,cAAc,CAwHzF"}

package/dist/registry.js

@@ -0,0 +1,142 @@
+import { executeQuery, executeScope, learnQuery, learnScope } from "./learn.js";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { DEFAULT_PACKAGE_NAME, loadFunctionIndex, saveFunction, } from "./store.js";
+import { signatureKey, signatureOf } from "./signature.js";
+async function defaultRequestCode() {
+    try {
+        const loaded = (await import("@x12i/coder-dispatcher"));
+        return typeof loaded.requestCode === "function" ? loaded.requestCode : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function createScopeFunctions(options) {
+    const dir = options.dir;
+    const packageName = options.packageName ?? DEFAULT_PACKAGE_NAME;
+    const projectDir = options.projectDir ?? process.cwd();
+    const learn = options.learn !== false;
+    let index = new Map();
+    let ready = false;
+    let loading;
+    const inflight = new Map();
+    const answering = new Map();
+    let requestCode = options.requestCode;
+    async function load() {
+        if (ready)
+            return;
+        loading ??= loadFunctionIndex(dir, projectDir).then((found) => {
+            index = found;
+            ready = true;
+        });
+        await loading;
+    }
+    async function coder() {
+        if (requestCode)
+            return requestCode;
+        requestCode = await defaultRequestCode();
+        return requestCode;
+    }
+    async function runSavedQuery(saved, input) {
+        const source = saved.source || (await readFile(join(saved.dir, saved.entry), "utf8"));
+        return executeQuery({
+            source,
+            request: input.request,
+            profile: input.profile,
+            budgets: input.budgets,
+            sdk: input.sdk,
+        });
+    }
+    return {
+        async query(input) {
+            await load();
+            const signature = signatureOf(input.request);
+            const key = signatureKey("query", signature);
+            const saved = index.get(key);
+            if (saved)
+                return { handled: true, records: await runSavedQuery(saved, input) };
+            if (!learn)
+                return { handled: false };
+            const existing = inflight.get(key);
+            if (existing)
+                return existing;
+            const pending = (async () => {
+                const requestCodeFn = await coder();
+                if (!requestCodeFn)
+                    return { handled: false };
+                const learned = await learnQuery({
+                    requestCode: requestCodeFn,
+                    coderDeps: options.coderDeps,
+                    request: input.request,
+                    profile: input.profile,
+                    budgets: input.budgets,
+                    sdk: input.sdk,
+                });
+                if (!learned)
+                    return { handled: false };
+                const stored = await saveFunction({
+                    dir,
+                    packageName,
+                    kind: "query",
+                    signature,
+                    source: learned.source,
+                });
+                index.set(key, stored);
+                return { handled: true, records: learned.records };
+            })().finally(() => {
+                inflight.delete(key);
+            });
+            inflight.set(key, pending);
+            return pending;
+        },
+        async answer(input) {
+            await load();
+            const signature = signatureOf(input.request);
+            const key = signatureKey("scope", signature);
+            const saved = index.get(key);
+            if (saved) {
+                const answer = await executeScope({
+                    source: saved.source,
+                    request: input.request,
+                    records: input.records,
+                    timeoutMs: input.budgets.maxWallClockMs,
+                });
+                return { handled: true, answer };
+            }
+            if (!learn)
+                return { handled: false };
+            const existing = answering.get(key);
+            if (existing)
+                return existing;
+            const pending = (async () => {
+                const requestCodeFn = await coder();
+                if (!requestCodeFn)
+                    return { handled: false };
+                const learned = await learnScope({
+                    requestCode: requestCodeFn,
+                    coderDeps: options.coderDeps,
+                    request: input.request,
+                    records: input.records,
+                    timeoutMs: input.budgets.maxWallClockMs,
+                });
+                if (!learned)
+                    return { handled: false };
+                const stored = await saveFunction({
+                    dir,
+                    packageName,
+                    kind: "scope",
+                    signature,
+                    source: learned.source,
+                });
+                index.set(key, stored);
+                return { handled: true, answer: learned.answer };
+            })().finally(() => {
+                answering.delete(key);
+            });
+            answering.set(key, pending);
+            return pending;
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,33 @@
+import type { ScopeRequest, ScoperBudgets, ScoperProfile } from "@x12i/memorix-scoper-contracts";
+import type { ContextualSdk } from "@x12i/memorix-scoper-sdk";
+import type { ScopeFunctionRecord } from "@x12i/memorix-scoper";
+import { FunctionSourceError } from "./source.js";
+export declare class FunctionRunError extends Error {
+    readonly code: "RUN_FAILED" | "TIMEOUT" | "BAD_RESULT";
+    constructor(message: string, code: FunctionRunError["code"]);
+}
+export type SubjectMethod = "get" | "list" | "query";
+export interface SubjectApi {
+    get(args: Record<string, unknown>): Promise<unknown>;
+    list(args: Record<string, unknown>): Promise<unknown>;
+    query(args: Record<string, unknown>): Promise<unknown>;
+}
+export declare function runHandle(options: {
+    source: string;
+    mode: "query" | "scope";
+    input: Record<string, unknown>;
+    subjects?: SubjectApi;
+    timeoutMs: number;
+}): Promise<unknown>;
+export interface LiveSubjects {
+    api: SubjectApi;
+    seen: Map<string, ScopeFunctionRecord>;
+}
+export declare function createLiveSubjects(sdk: ContextualSdk, profile: ScoperProfile, budgets: ScoperBudgets): LiveSubjects;
+export declare function queryPayload(request: ScopeRequest, profile: ScoperProfile, sdk: ContextualSdk): Record<string, unknown>;
+export declare function scopePayload(request: ScopeRequest, records: ScopeFunctionRecord[]): Record<string, unknown>;
+export declare function acceptRecords(raw: unknown, seen: Map<string, ScopeFunctionRecord>): ScopeFunctionRecord[];
+export declare function acceptAnswer(raw: unknown): string;
+export declare function recordIds(records: ScopeFunctionRecord[]): string;
+export declare function isSourceRejection(error: unknown): error is FunctionSourceError;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAwB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAExE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;gBAE3C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC;CAK5D;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD;AA+BD,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiEnB;AAgCD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,UAAU,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACxC;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,GACrB,YAAY,CAwEd;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUvH;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,mBAAmB,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,mBAAmB,EAAE,CAsBzG;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CASjD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAKhE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAE9E"}