@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

package/dist/capabilities/code.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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;
+}): 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;AAE9D,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,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;CACxB,GACA,OAAO,CAAC,gBAAgB,CAAC,CA8H3B;AAsGD,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,327 @@
+/**
+ * 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 { 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) {
+    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
+    });
+    let modules;
+    let capabilities;
+    if (params.withToolbelt) {
+        const { mountJsScriptSandbox } = await import("../js-script-sandbox.js");
+        const mounted = await mountJsScriptSandbox(params.code, context);
+        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 { resolveImportedPacks } = await import("../js-script-sandbox.js");
+        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)));
+    }
+    // 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,
+        timeoutMs: params.timeoutSeconds * 1000,
+        globals,
+        limits: { secretScope: [...params.secrets] },
+        ...(staged ?? {})
+    };
+    if (modules)
+        sandboxOptions.modules = modules;
+    if (capabilities)
+        sandboxOptions.capabilities = capabilities;
+    const result = await runInSandbox(sandboxOptions);
+    const logs = result.logs ?? [];
+    if (!result.success) {
+        return fail(result.error ?? "Code execution failed", logs);
+    }
+    if (emitContract) {
+        // No `onEmit` sink is passed, so the host accumulates the emits and hands
+        // them back in call order; the return value carries no output semantics.
+        return {
+            ok: true,
+            outputs: result.outputs ?? {},
+            streamed: 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
+    };
+}
+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":"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"}

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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"}

package/dist/capabilities/collections.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The `collections` capability module — knowledge collections and the vector
+ * store behind them.
+ *
+ * Eight capabilities that used to be eight `Tool` subclasses: the two
+ * zero-arg discovery/query tools from `collection-tools.ts`, and the
+ * six `vector_*` tools from `../tools/vector-tools.ts`.
+ *
+ * What was a constructor argument is now a field on the run. The six vector
+ * tools took a `VectorCollection`; their schemas name no collection, so a run
+ * that binds none cannot serve them and they say so instead of guessing.
+ * `@nodetool-ai/vectorstore` stays imported inside the two implementations
+ * that need it, which is what kept those two out of the zero-arg catalogs.
+ *
+ * Design: docs/tool-class-retirement-design.md § "Migration" (`/collections`).
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const listCollections: CapabilityExport;
+declare const queryCollection: CapabilityExport;
+declare const vectorTextSearch: CapabilityExport;
+declare const vectorIndex: CapabilityExport;
+declare const vectorHybridSearch: CapabilityExport;
+declare const vectorRecursiveSplitAndIndex: CapabilityExport;
+declare const vectorMarkdownSplitAndIndex: CapabilityExport;
+declare const vectorBatchIndex: CapabilityExport;
+/** Every collection capability: discovery and query first, then the store. */
+/**
+ * Collection lifecycle, under the ownership rules the HTTP layer applies.
+ *
+ * The `VectorProvider` interface has no concept of a user — collections are
+ * one flat namespace — so ownership is a metadata stamp checked at the
+ * boundary (`@nodetool-ai/vectorstore/collection-access`). The read
+ * capabilities predate that and stay as they are; these two do not, because
+ * creating and destroying a store is where a shared namespace stops being
+ * something others can see and starts being something others lose. A
+ * collection with no owner recorded predates the stamp and stays shared, which
+ * is the same answer the API gives.
+ */
+declare const createCollection: CapabilityExport;
+declare const deleteCollection: CapabilityExport;
+export declare const COLLECTION_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listCollections, queryCollection, vectorTextSearch, vectorIndex, vectorHybridSearch, vectorRecursiveSplitAndIndex, vectorMarkdownSplitAndIndex, vectorBatchIndex, createCollection, deleteCollection };
+//# sourceMappingURL=collections.d.ts.map