@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/capabilities/code.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The `code` capability module — the Code-node authoring harness.
+ *
+ * Three capabilities that give any agent the write → validate → run → test
+ * loop for a `nodetool.code.Code` body, without authoring a workflow and
+ * without going through CodeAct:
+ *
+ *   validate_code — the static check the graph validator and the editor run
+ *   run_code      — execute a body in the QuickJS sandbox with given inputs
+ *   test_code     — run a case list and grade each against expected outputs
+ *
+ * Execution matches the Code node: the body gets the `inputs` object and a
+ * fresh `state`, and the same probe the node uses (`usesEmitOutputContract`)
+ * decides which output contract applies. A body calling `emit`/`output` runs
+ * verbatim — emitted values come back as `streamed`, final values as
+ * `outputs`, its return value ignored. A body calling neither runs the legacy
+ * path (implicit return wrapping, `yield` collection, return-bag
+ * normalization) through the `@nodetool-ai/node-sdk` code-body helpers, one
+ * implementation for both hosts. What the harness deliberately does NOT
+ * provide: the node toolbelt (imports / `nodetool.*`) and secrets outside
+ * the call's own `secrets` list — authoring runs are hermetic by default.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+import { type HarnessRunResult } from "./code-grading.js";
+export type { EmittedEntry, StreamedItems, HarnessRunResult } from "./code-grading.js";
+/**
+ * Run one Code-node body the way the node runs it. Off by default this is
+ * hermetic (no belt, no `nodetool.*`); pass `withToolbelt` for a JS
+ * script run. Returns rather than throws: a failing body is a result to
+ * report.
+ *
+ * Takes a `ProcessingContext` rather than a `CapabilityRun` because that is
+ * all it ever used, and the JS-script run endpoint reaches it from a host that
+ * has a context and no capability run.
+ */
+export declare function runCodeBody(context: ProcessingContext, params: {
+    code: string;
+    inputs: Record<string, unknown>;
+    secrets: readonly string[];
+    timeoutSeconds: number;
+    inputStreams?: Record<string, unknown[]>;
+    /**
+     * Give the guest the Code-node belt (imports / `nodetool.*`) and every
+     * installed sandbox pack plus platform module by import. Off for
+     * `run_code` / `test_code` (authoring stays hermetic). On for every JS
+     * script run.
+     */
+    withToolbelt?: boolean;
+    /**
+     * Sees each `emit()` as the guest makes it, for a host that streams the
+     * run. The emits still come back in `streamed`, in call order.
+     */
+    onEmit?: (name: string, value: unknown) => void;
+}): Promise<HarnessRunResult>;
+declare const validateCode: CapabilityExport;
+declare const runCode: CapabilityExport;
+declare const testCode: CapabilityExport;
+export declare const module: CapabilityModule;
+export { validateCode, runCode, testCode };
+//# sourceMappingURL=code.d.ts.map

package/dist/capabilities/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/capabilities/code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAe3B,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD,GACA,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AA0QD,QAAA,MAAM,YAAY,EAAE,gBAwCnB,CAAC;AAqBF,QAAA,MAAM,OAAO,EAAE,gBAGd,CAAC;AAMF,QAAA,MAAM,QAAQ,EAAE,gBA8Cf,CAAC;AAQF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/capabilities/code.js

@@ -0,0 +1,366 @@
+/**
+ * The `code` capability module — the Code-node authoring harness.
+ *
+ * Three capabilities that give any agent the write → validate → run → test
+ * loop for a `nodetool.code.Code` body, without authoring a workflow and
+ * without going through CodeAct:
+ *
+ *   validate_code — the static check the graph validator and the editor run
+ *   run_code      — execute a body in the QuickJS sandbox with given inputs
+ *   test_code     — run a case list and grade each against expected outputs
+ *
+ * Execution matches the Code node: the body gets the `inputs` object and a
+ * fresh `state`, and the same probe the node uses (`usesEmitOutputContract`)
+ * decides which output contract applies. A body calling `emit`/`output` runs
+ * verbatim — emitted values come back as `streamed`, final values as
+ * `outputs`, its return value ignored. A body calling neither runs the legacy
+ * path (implicit return wrapping, `yield` collection, return-bag
+ * normalization) through the `@nodetool-ai/node-sdk` code-body helpers, one
+ * implementation for both hosts. What the harness deliberately does NOT
+ * provide: the node toolbelt (imports / `nodetool.*`) and secrets outside
+ * the call's own `secrets` list — authoring runs are hermetic by default.
+ */
+import { withSpan, recordTraceEvent } from "@nodetool-ai/runtime";
+import { SpanStatusCode } from "@opentelemetry/api";
+import { resolveImportedPacks } from "../sandbox-pack-resolution.js";
+import { gradeCodeCases } from "./code-grading.js";
+import { validateCodeSpec, runCodeSpec, testCodeSpec, MAX_TIMEOUT_SECONDS, DEFAULT_TIMEOUT_SECONDS, MAX_TEST_CASES } from "./code.specs.js";
+import { isNonBlankString, isObjectLike, isRecord } from "../utils/type-guards.js";
+/**
+ * Run one Code-node body the way the node runs it. Off by default this is
+ * hermetic (no belt, no `nodetool.*`); pass `withToolbelt` for a JS
+ * script run. Returns rather than throws: a failing body is a result to
+ * report.
+ *
+ * Takes a `ProcessingContext` rather than a `CapabilityRun` because that is
+ * all it ever used, and the JS-script run endpoint reaches it from a host that
+ * has a context and no capability run.
+ */
+export async function runCodeBody(context, params) {
+    return withSpan("script.run", {}, async (span) => {
+        const result = await runCodeBodyImpl(context, params);
+        if (!result.ok) {
+            span?.setStatus({ code: SpanStatusCode.ERROR });
+        }
+        return result;
+    });
+}
+async function runCodeBodyImpl(context, params) {
+    const { hasReturnStatement, hasYieldStatement, wrapImplicitReturn, normalizeCodeOutput, usesEmitOutputContract } = await import("@nodetool-ai/node-sdk");
+    const { runInSandbox } = await import("../js-sandbox.js");
+    const started = Date.now();
+    const fail = (error, logs = []) => ({
+        ok: false,
+        error,
+        logs,
+        duration_ms: Date.now() - started
+    });
+    // The same deadline reaches both the guest and in-flight capabilities.
+    // Aborting this invocation must not cancel or copy the caller's context.
+    const completion = new AbortController();
+    const signal = AbortSignal.any([context.signal, completion.signal]);
+    const deadline = setTimeout(() => completion.abort(new Error("Script execution deadline exceeded.")), Math.max(1, Math.ceil(params.timeoutSeconds * 1000)));
+    deadline.unref();
+    try {
+        let modules;
+        let capabilities;
+        if (params.withToolbelt) {
+            const { mountJsScriptSandbox } = await import("../js-script-sandbox.js");
+            const mounted = await mountJsScriptSandbox(params.code, context, {
+                signal
+            });
+            if (!mounted.ok) {
+                return fail(mounted.error);
+            }
+            modules = mounted.modules;
+            capabilities = mounted.capabilities;
+        }
+        else {
+            // Hermetic: the body's pack imports still resolve against the installed
+            // catalog, but no platform module is mounted, so importing one fails in
+            // the guest the way any unserved specifier does.
+            const packs = resolveImportedPacks(params.code, context, {
+                subject: "The code"
+            });
+            if (!packs.ok) {
+                return fail(packs.error);
+            }
+            modules = packs.modules;
+        }
+        const code = params.code;
+        // The emit/output contract names its outputs, so nothing is inferred from
+        // the body's shape and nothing is rewritten: it runs exactly as written.
+        const emitContract = usesEmitOutputContract(code);
+        const streaming = !emitContract && hasYieldStatement(code);
+        const body = emitContract
+            ? code
+            : streaming
+                ? `const __yielded = [];
+  function yield_(value) { __yielded.push(value); }
+  ${code.replace(/\byield\b/g, "yield_")}
+  return __yielded;`
+                : hasReturnStatement(code)
+                    ? code
+                    : wrapImplicitReturn(code);
+        const globals = {
+            inputs: params.inputs,
+            state: {}
+        };
+        let source = body;
+        if (params.withToolbelt) {
+            const { NODETOOL_PRELUDE, assembleJsScriptToolbelt, sandboxToolBridgeGlobals } = await import("../sandbox-toolbelt.js");
+            source = `${NODETOOL_PRELUDE}\n${body}`;
+            Object.assign(globals, sandboxToolBridgeGlobals(context, await assembleJsScriptToolbelt(context), { signal }));
+        }
+        // A body reading `stream` needs a source, or every verb throws. Only a call
+        // that staged items gets one — without `inputStreams` the harness behaves
+        // exactly as before.
+        const staged = params.inputStreams
+            ? stagedInputStreams(params.inputStreams)
+            : undefined;
+        const sandboxOptions = {
+            code: source,
+            context,
+            signal,
+            timeoutMs: params.timeoutSeconds * 1000,
+            globals,
+            limits: { secretScope: [...params.secrets] },
+            onLog: (level, message) => {
+                recordTraceEvent("console", { "log.level": level, "log.source": "script", "log.message": message });
+            },
+            ...(staged ?? {})
+        };
+        if (modules)
+            sandboxOptions.modules = modules;
+        if (capabilities)
+            sandboxOptions.capabilities = capabilities;
+        const relayed = [];
+        const watch = params.onEmit;
+        if (watch) {
+            sandboxOptions.onEmit = (name, value) => {
+                relayed.push({ name, value });
+                watch(name, value);
+            };
+        }
+        const result = await runInSandbox(sandboxOptions);
+        const logs = result.logs ?? [];
+        if (!result.success) {
+            return fail(result.error ?? "Code execution failed", logs);
+        }
+        if (emitContract) {
+            // Without a sink the host accumulates the emits and hands them back in
+            // call order; with one they were collected as they were relayed. The
+            // return value carries no output semantics.
+            return {
+                ok: true,
+                outputs: result.outputs ?? {},
+                streamed: watch ? relayed : (result.emitted ?? []),
+                logs,
+                duration_ms: Date.now() - started
+            };
+        }
+        if (streaming) {
+            const items = Array.isArray(result.result) ? result.result : [];
+            return {
+                ok: true,
+                streamed: items.map(normalizeCodeOutput),
+                logs,
+                duration_ms: Date.now() - started
+            };
+        }
+        return {
+            ok: true,
+            outputs: normalizeCodeOutput(result.result),
+            logs,
+            duration_ms: Date.now() - started
+        };
+    }
+    finally {
+        clearTimeout(deadline);
+        // Revoke unawaited capabilities after both successful and failed scripts.
+        completion.abort(new Error("Script invocation has finished."));
+    }
+}
+function stagedInputStreams(streams) {
+    const queues = new Map(Object.entries(streams).map(([handle, values]) => [
+        handle,
+        Array.isArray(values) ? [...values] : []
+    ]));
+    const arrival = [];
+    const deepest = Math.max(0, ...[...queues.values()].map((queue) => queue.length));
+    for (let index = 0; index < deepest; index++) {
+        for (const [handle, queue] of queues) {
+            if (queue.length > index)
+                arrival.push(handle);
+        }
+    }
+    const dropFromArrival = (handle) => {
+        const at = arrival.indexOf(handle);
+        if (at >= 0)
+            arrival.splice(at, 1);
+    };
+    return {
+        onTakeInput: async (handle) => {
+            const next = handle ?? arrival[0];
+            if (next === undefined)
+                return { done: true };
+            const queue = queues.get(next);
+            if (!queue || queue.length === 0)
+                return { done: true };
+            dropFromArrival(next);
+            return { done: false, handle: next, value: queue.shift() };
+        },
+        onStreamOpen: (handle) => (queues.get(handle)?.length ?? 0) > 0
+    };
+}
+function stringList(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === "string");
+}
+/**
+ * `{handle: [items]}` staged for a body that reads `stream`. Entries that are
+ * not arrays are dropped: a handle with nothing behind it reads as ended.
+ */
+function inputStreamBag(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const staged = {};
+    for (const [handle, items] of Object.entries(value)) {
+        if (Array.isArray(items))
+            staged[handle] = [...items];
+    }
+    return Object.keys(staged).length > 0 ? staged : undefined;
+}
+function inputBag(value) {
+    if (isRecord(value)) {
+        return value;
+    }
+    return {};
+}
+function timeoutSeconds(value) {
+    const parsed = Number(value ?? DEFAULT_TIMEOUT_SECONDS);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return DEFAULT_TIMEOUT_SECONDS;
+    return Math.min(parsed, MAX_TIMEOUT_SECONDS);
+}
+// ---------------------------------------------------------------------------
+// validate_code
+// ---------------------------------------------------------------------------
+/** Issue category for a body still on the return/yield output contract. */
+const CODE_LEGACY_CONTRACT = "code_legacy_contract";
+const validateCode = {
+    spec: validateCodeSpec,
+    impl: async (run, params) => {
+        const { validateCodeNodeBody, usesEmitOutputContract } = await import("@nodetool-ai/node-sdk");
+        const issues = validateCodeNodeBody({
+            code: params["code"],
+            availableInputs: stringList(params["inputs"]),
+            declaredOutputs: stringList(params["outputs"]),
+            sandboxModuleCatalog: run.context.sandboxModuleCatalog
+        });
+        // The legacy return/yield contract runs for one more release. The shared
+        // validator is where that warning belongs; this adds it only when the
+        // shared layer did not, so the harness warns either way and never twice.
+        const code = String(params["code"] ?? "");
+        const alreadyWarned = issues.some((issue) => issue.code === CODE_LEGACY_CONTRACT || /deprecat/i.test(issue.message));
+        // The pristine default body is an empty node, not a legacy body.
+        if (code.trim() !== "" &&
+            code.trim() !== "return {};" &&
+            !usesEmitOutputContract(code) &&
+            !alreadyWarned) {
+            issues.push({
+                severity: "warning",
+                code: CODE_LEGACY_CONTRACT,
+                message: "The return/yield output contract is deprecated; use " +
+                    "emit(name, value) to stream a value and output(name, value) to " +
+                    "set a final one."
+            });
+        }
+        return {
+            ok: !issues.some((issue) => issue.severity === "error"),
+            issues
+        };
+    }
+};
+// ---------------------------------------------------------------------------
+// run_code
+// ---------------------------------------------------------------------------
+/** `run_code`'s arguments as {@link runCodeBody} params. */
+function runCodeParams(params) {
+    const bodyParams = {
+        code: String(params["code"] ?? ""),
+        inputs: inputBag(params["inputs"]),
+        secrets: stringList(params["secrets"]),
+        timeoutSeconds: timeoutSeconds(params["timeout_seconds"])
+    };
+    const staged = inputStreamBag(params["input_streams"]);
+    if (staged !== undefined)
+        bodyParams.inputStreams = staged;
+    return bodyParams;
+}
+const runCode = {
+    spec: runCodeSpec,
+    impl: async (run, params) => runCodeBody(run.context, runCodeParams(params))
+};
+// ---------------------------------------------------------------------------
+// test_code
+// ---------------------------------------------------------------------------
+const testCode = {
+    spec: testCodeSpec,
+    impl: async (run, params) => {
+        const rawCases = Array.isArray(params["cases"]) ? params["cases"] : [];
+        if (rawCases.length === 0) {
+            return { error: "test_code needs at least one case." };
+        }
+        if (rawCases.length > MAX_TEST_CASES) {
+            return {
+                error: `test_code runs at most ${MAX_TEST_CASES} cases per call (got ${rawCases.length}).`
+            };
+        }
+        const code = String(params["code"] ?? "");
+        const secrets = stringList(params["secrets"]);
+        const timeout = timeoutSeconds(params["timeout_seconds"]);
+        const cases = rawCases.map((entry, i) => {
+            const raw = isObjectLike(entry) ? entry : {};
+            const name = isNonBlankString(raw["name"])
+                ? raw["name"]
+                : `case ${i + 1}`;
+            const staged = inputStreamBag(raw["input_streams"]);
+            const graded = { name, inputs: inputBag(raw["inputs"]) };
+            if (isObjectLike(raw["expect"])) {
+                graded.expect = raw["expect"];
+            }
+            if (Array.isArray(raw["expected_streamed"])) {
+                graded.expectedStreamed = raw["expected_streamed"];
+            }
+            if (staged !== undefined)
+                graded.inputStreams = staged;
+            return graded;
+        });
+        return gradeCodeCases(cases, (testCase) => {
+            const bodyParams = {
+                code,
+                inputs: testCase.inputs,
+                secrets,
+                timeoutSeconds: timeout
+            };
+            if (testCase.inputStreams !== undefined) {
+                bodyParams.inputStreams = testCase.inputStreams;
+            }
+            return runCodeBody(run.context, bodyParams);
+        });
+    }
+};
+const CODE_CAPABILITIES = [
+    validateCode,
+    runCode,
+    testCode
+];
+export const module = {
+    module: "code",
+    exports: CODE_CAPABILITIES
+};
+export { validateCode, runCode, testCode };
+//# sourceMappingURL=code.js.map

package/dist/capabilities/code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/capabilities/code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAMrE,OAAO,EACL,cAAc,EAIf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACT,MAAM,yBAAyB,CAAC;AAQjC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA0B,EAC1B,MAkBC;IAED,OAAO,QAAQ,CAAC,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,OAA0B,EAC1B,MAAyC;IAEzC,MAAM,EACJ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACvB,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAC1C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,IAAI,GAAa,EAAE,EAAoB,EAAE,CAAC,CAAC;QACtE,EAAE,EAAE,KAAK;QACT,KAAK;QACL,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KAClC,CAAC,CAAC;IAEH,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,UAAU,CACzB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,EACxE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC,CACrD,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,OAAO,CAAC;QACZ,IAAI,YAAY,CAAC;QACjB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE;gBAC/D,MAAM;aACP,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAC1B,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,wEAAwE;YACxE,iDAAiD;YACjD,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE;gBACvD,OAAO,EAAE,UAAU;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC1B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,0EAA0E;QAC1E,yEAAyE;QACzE,MAAM,YAAY,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,CAAC,YAAY,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,YAAY;YACvB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,SAAS;gBACT,CAAC,CAAC;;IAEN,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC;oBACpB;gBACZ,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC;oBACxB,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEjC,MAAM,OAAO,GAA4B;YACvC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,EAAE;SACV,CAAC;QACF,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,EACJ,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,EACzB,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,gBAAgB,KAAK,IAAI,EAAE,CAAC;YACxC,MAAM,CAAC,MAAM,CACX,OAAO,EACP,wBAAwB,CACtB,OAAO,EACP,MAAM,wBAAwB,CAAC,OAAO,CAAC,EACvC,EAAE,MAAM,EAAE,CACX,CACF,CAAC;QACJ,CAAC;QAED,4EAA4E;QAC5E,0EAA0E;QAC1E,qBAAqB;QACrB,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY;YAChC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC;YACzC,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,cAAc,GAAsB;YACxC,IAAI,EAAE,MAAM;YACZ,OAAO;YACP,MAAM;YACN,SAAS,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI;YACvC,OAAO;YACP,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE;YAC5C,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBACxB,gBAAgB,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;YACtG,CAAC;YACD,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;SAClB,CAAC;QACF,IAAI,OAAO;YAAE,cAAc,CAAC,OAAO,GAAG,OAAO,CAAC;QAC9C,IAAI,YAAY;YAAE,cAAc,CAAC,YAAY,GAAG,YAAY,CAAC;QAC7D,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,KAAK,EAAE,CAAC;YACV,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACtC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC9B,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACrB,CAAC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,CAAC;QAElD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,uBAAuB,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACjB,uEAAuE;YACvE,qEAAqE;YACrE,4CAA4C;YAC5C,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;gBAC7B,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;gBAClD,IAAI;gBACJ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aAClC,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC;gBACxC,IAAI;gBACJ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aAClC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC;YAC3C,IAAI;YACJ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SAClC,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvB,0EAA0E;QAC1E,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAsBD,SAAS,kBAAkB,CACzB,OAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAChD,MAAM;QACN,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;KACzC,CAAC,CACH,CAAC;IACF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,CAAC,EACD,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CACrD,CAAC;IACF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,CAAC,MAAc,EAAQ,EAAE;QAC/C,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,EAAE,IAAI,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACxD,eAAe,CAAC,IAAI,CAAC,CAAC;YACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAC7D,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAC1C,KAAgC,CACjC,EAAE,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,KAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,uBAAuB,CAAC;IAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,2EAA2E;AAC3E,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAEpD,MAAM,YAAY,GAAqB;IACrC,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;QAC1B,MAAM,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,GACpD,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,oBAAoB,CAAC;YAClC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7C,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC9C,oBAAoB,EAAE,GAAG,CAAC,OAAO,CAAC,oBAAoB;SACvD,CAAC,CAAC;QACH,yEAAyE;QACzE,sEAAsE;QACtE,yEAAyE;QACzE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAC/B,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,KAAK,oBAAoB,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CACzE,CAAC;QACF,iEAAiE;QACjE,IACE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAClB,IAAI,CAAC,IAAI,EAAE,KAAK,YAAY;YAC5B,CAAC,sBAAsB,CAAC,IAAI,CAAC;YAC7B,CAAC,aAAa,EACd,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EACL,sDAAsD;oBACtD,iEAAiE;oBACjE,kBAAkB;aACrB,CAAC,CAAC;QACL,CAAC;QACD,OAAO;YACL,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC;YACvD,MAAM;SACP,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,4DAA4D;AAC5D,SAAS,aAAa,CACpB,MAAqC;IAErC,MAAM,UAAU,GAAsC;QACpD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtC,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;KAC1D,CAAC;IACF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;IACvD,IAAI,MAAM,KAAK,SAAS;QAAE,UAAU,CAAC,YAAY,GAAG,MAAM,CAAC;IAC3D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,OAAO,GAAqB;IAChC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC7E,CAAC;AAEF,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,QAAQ,GAAqB;IACjC,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;QACzD,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YACrC,OAAO;gBACL,KAAK,EAAE,0BAA0B,cAAc,wBAAwB,QAAQ,CAAC,MAAM,IAAI;aAC3F,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAE1D,MAAM,KAAK,GAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACpD,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACxC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;gBACb,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;YACpD,MAAM,MAAM,GAAe,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACrE,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;gBAChC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,CAA4B,CAAC;YAC3D,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC;gBAC5C,MAAM,CAAC,gBAAgB,GAAG,GAAG,CAAC,mBAAmB,CAAc,CAAC;YAClE,CAAC;YACD,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC;YACvD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE;YACxC,MAAM,UAAU,GAAsC;gBACpD,IAAI;gBACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO;gBACP,cAAc,EAAE,OAAO;aACxB,CAAC;YACF,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACxC,UAAU,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;YAClD,CAAC;YACD,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAgC;IACrD,YAAY;IACZ,OAAO;IACP,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAqB;IACtC,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,iBAAiB;CAC3B,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/capabilities/code.specs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The `code` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `code.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `code.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+import type { CapabilitySpec } from "./types.js";
+import type { JsonSchema } from "@nodetool-ai/runtime";
+export declare const MAX_TIMEOUT_SECONDS = 120;
+export declare const DEFAULT_TIMEOUT_SECONDS = 30;
+export declare const MAX_TEST_CASES = 20;
+export declare const CODE_FIELD: JsonSchema;
+export declare const INPUT_STREAMS_FIELD: JsonSchema;
+export declare const validateCodeSpec: CapabilitySpec;
+export declare const runCodeSpec: CapabilitySpec;
+export declare const testCodeSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const codeSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=code.specs.d.ts.map

package/dist/capabilities/code.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/code.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,eAAO,MAAM,UAAU,EAAE,UASxB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,UAWjC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cA4B9B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,cAsCzB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,cA0E1B,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,SAAS,EAAE,SAAS,cAAc,EAI9C,CAAC"}

package/dist/capabilities/code.specs.js

@@ -0,0 +1,175 @@
+/**
+ * The `code` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `code.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `code.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+export const MAX_TIMEOUT_SECONDS = 120;
+export const DEFAULT_TIMEOUT_SECONDS = 30;
+export const MAX_TEST_CASES = 20;
+export const CODE_FIELD = {
+    type: "string",
+    description: "The Code-node body: plain JavaScript. Declared inputs arrive on the " +
+        "`inputs` object. Outputs leave through two calls: " +
+        "`await emit(name, value)` streams one value from an output handle, and " +
+        "`await output(name, value)` sets a handle's final value. `return` is " +
+        "control flow only — its value is ignored. A body calling neither runs " +
+        "the deprecated return/yield contract for one more release."
+};
+export const INPUT_STREAMS_FIELD = {
+    type: "object",
+    description: "Items to feed a body that reads its inputs with `stream`, as " +
+        '{handle: [item, …]}, e.g. {"numbers": [1, 2, 3]}. The body runs once ' +
+        "and pulls them: `stream(name)` yields one handle's items in order, " +
+        "`stream.any()` yields [handle, value] round-robin by index across the " +
+        "handles in declaration order, `stream.first(name)` takes one, and " +
+        "`stream.open(name)` reports whether items remain. Omit it for a " +
+        "buffered body, whose values go in `inputs` instead.",
+    additionalProperties: { type: "array" }
+};
+export const validateCodeSpec = {
+    name: "validate_code",
+    description: "Statically check a Code-node body without running it: syntax, imports " +
+        "against the installed sandbox packs, undefined names, undeclared " +
+        "`inputs.*` reads, unused inputs, and whether every declared output is " +
+        "reached by an `emit` or `output` call. Same check the workflow " +
+        "validator runs. Call it after every edit — it is far cheaper than " +
+        "run_code.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            code: CODE_FIELD,
+            inputs: {
+                type: "array",
+                items: { type: "string" },
+                description: "Input names the node declares (keys on `inputs`)."
+            },
+            outputs: {
+                type: "array",
+                items: { type: "string" },
+                description: "Output handle names the node declares."
+            },
+        },
+        required: ["code"]
+    },
+    category: "read",
+    userMessage: () => "Validating code"
+};
+export const runCodeSpec = {
+    name: "run_code",
+    description: "Run a Code-node body in the QuickJS sandbox with the given `inputs` " +
+        "and report its outputs, console logs, and error. Values passed to " +
+        "`output(name, value)` come back as `outputs`; values passed to " +
+        "`emit(name, value)` come back as `streamed`, an ordered list of " +
+        "`{name, value}`. A legacy return/yield body reports its return bag as " +
+        "`outputs` and its yielded items as `streamed`. A body that reads its " +
+        "inputs with `stream` runs once over the items staged in " +
+        "`input_streams`. The run is hermetic: no " +
+        "node toolbelt, and only the secrets named in `secrets` are readable. " +
+        "Use it to debug a body before saving it onto a node.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            code: CODE_FIELD,
+            inputs: {
+                type: "object",
+                description: "Input values the body reads from the `inputs` object.",
+                additionalProperties: true
+            },
+            input_streams: INPUT_STREAMS_FIELD,
+            secrets: {
+                type: "array",
+                items: { type: "string" },
+                description: "Secret names the body may read via getSecret(). Default: none."
+            },
+            timeout_seconds: {
+                type: "number",
+                description: `Execution timeout (default ${DEFAULT_TIMEOUT_SECONDS}, max ${MAX_TIMEOUT_SECONDS}).`
+            }
+        },
+        required: ["code"]
+    },
+    category: "execute",
+    userMessage: () => "Running code in the sandbox"
+};
+export const testCodeSpec = {
+    name: "test_code",
+    description: "Run a Code-node body against a list of test cases and grade each one. " +
+        "A case supplies `inputs` (or `input_streams`, for a body that reads " +
+        "`stream`) and optionally `expect` — expected final " +
+        "values per output handle, compared structurally; outputs not named in " +
+        "`expect` are ignored — and `expected_streamed`, the full ordered list " +
+        "of `{name, value}` the body must emit. A case with neither passes when " +
+        "the body runs without error. Use it as the regression check after " +
+        "editing code.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            code: CODE_FIELD,
+            cases: {
+                type: "array",
+                description: `Test cases (max ${MAX_TEST_CASES}).`,
+                items: {
+                    type: "object",
+                    properties: {
+                        name: { type: "string", description: "Case label." },
+                        inputs: {
+                            type: "object",
+                            description: "Input values for this case.",
+                            additionalProperties: true
+                        },
+                        input_streams: INPUT_STREAMS_FIELD,
+                        expect: {
+                            type: "object",
+                            description: "Expected final value per output handle, compared " +
+                                "structurally.",
+                            additionalProperties: true
+                        },
+                        expected_streamed: {
+                            type: "array",
+                            description: "Every value the body must emit, in call order. The list is " +
+                                "compared whole: a differing length or entry fails the case.",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    name: {
+                                        type: "string",
+                                        description: "Output handle the value was emitted from."
+                                    },
+                                    value: { description: "The emitted value." }
+                                },
+                                required: ["name", "value"]
+                            }
+                        }
+                    },
+                    required: []
+                }
+            },
+            secrets: {
+                type: "array",
+                items: { type: "string" },
+                description: "Secret names the body may read via getSecret(). Default: none."
+            },
+            timeout_seconds: {
+                type: "number",
+                description: `Per-case timeout (default ${DEFAULT_TIMEOUT_SECONDS}, max ${MAX_TIMEOUT_SECONDS}).`
+            }
+        },
+        required: ["code", "cases"]
+    },
+    category: "execute",
+    userMessage: (params) => {
+        const count = Array.isArray(params["cases"]) ? params["cases"].length : 0;
+        return `Testing code against ${count} case${count === 1 ? "" : "s"}`;
+    }
+};
+/** Every spec this module declares, in declaration order. */
+export const codeSpecs = [
+    validateCodeSpec,
+    runCodeSpec,
+    testCodeSpec
+];
+//# sourceMappingURL=code.specs.js.map

package/dist/capabilities/code.specs.js.map

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