@agenteer/stdlib 1.0.0-rc.1

package/dist/primitives/tool_call.js

@@ -0,0 +1,69 @@
+/**
+ * `@agenteer/node-tool-call` — primitive for invoking a registered tool
+ * (sub-plan 03 §2). §R4 honest dynamic-action disclosure:
+ *   dynamic_actions: true
+ *   dynamic_action_spec: "tool:${input.tool_name}"
+ *
+ * The permission kernel synthesizes `tool:<concrete_name>` at spawn time
+ * and checks against the parent's granted set. Tools themselves are
+ * adapters injected via `Runtime({ toolRegistry })`.
+ */
+import { z } from "zod";
+import { makeManifest, } from "@agenteer/core";
+const MANIFEST = makeManifest({
+    id: "@agenteer/node-tool-call",
+    name: "tool_call",
+    description: "Invoke a registered tool by name. §R4-compliant: declared tool capability is synthesized from input at dispatch.",
+    determinism: "stochastic",
+    required_actions: [],
+    dynamic_actions: true,
+    dynamic_action_spec: "tool:${input.tool_name}",
+    tags: ["primitive"],
+    side_effects: {
+        writes_fs: false,
+        network: true,
+        mutates_ctx: false,
+    },
+});
+const InputSchema = z.object({
+    tool_name: z.string().min(1),
+    args: z.unknown(),
+});
+const OutputSchema = z.object({
+    tool_name: z.string(),
+    value: z.unknown(),
+});
+export function toolCallFactory() {
+    return {
+        manifest: MANIFEST,
+        inputSchema: InputSchema,
+        outputSchema: OutputSchema,
+        ctx: [],
+        model: null,
+        async execute(input, handle) {
+            const { tool_name, args } = input.original;
+            try {
+                const value = await handle.callAction("tool.invoke", {
+                    tool_name,
+                    args,
+                });
+                return {
+                    kind: "output",
+                    value: { tool_name, value },
+                    evidence: { verdict: "pass", tool_output: { command: `tool:${tool_name}` } },
+                };
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                return {
+                    kind: "failed",
+                    reason,
+                    retryable: /rate.?limit|timeout|5\d\d/i.test(reason),
+                    evidence: { verdict: "fail" },
+                };
+            }
+        },
+    };
+}
+export const toolCallManifest = MANIFEST;
+//# sourceMappingURL=tool_call.js.map

package/dist/primitives/tool_call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_call.js","sourceRoot":"","sources":["../../src/primitives/tool_call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,GAMb,MAAM,gBAAgB,CAAC;AAExB,MAAM,QAAQ,GAAiB,YAAY,CAAC;IAC1C,EAAE,EAAE,0BAA0B;IAC9B,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,kHAAkH;IACpH,WAAW,EAAE,YAAY;IACzB,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,yBAAyB;IAC9C,IAAI,EAAE,CAAC,WAAW,CAAC;IACnB,YAAY,EAAE;QACZ,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,KAAK;KACnB;CACF,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;CACnB,CAAC,CAAC;AAKH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,YAAY;QAC1B,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,IAAI;QACX,KAAK,CAAC,OAAO,CAAC,KAAuB,EAAE,MAAyB;YAC9D,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,UAAU,CAAU,aAAa,EAAE;oBAC5D,SAAS;oBACT,IAAI;iBACL,CAAC,CAAC;gBACH,OAAO;oBACL,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;oBAC3B,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,QAAQ,SAAS,EAAE,EAAE,EAAE;iBAC7E,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,OAAO;oBACL,IAAI,EAAE,QAAQ;oBACd,MAAM;oBACN,SAAS,EAAE,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC;oBACpD,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;iBAC9B,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC"}

package/dist/shared/capture.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Streaming stdout/stderr capture with ring-buffer truncation — sub-plan
+ * 03 §S.2. Shared by `shell_exec`, `compile`, `test_run`. One module,
+ * not three, so truncation + timeout + binary-detection behavior stays
+ * consistent across validators.
+ */
+export interface RunCommandOptions {
+    readonly cwd?: string;
+    readonly timeout_ms: number;
+    readonly stdin?: string;
+    readonly signal: AbortSignal;
+    readonly env?: NodeJS.ProcessEnv;
+    /** Per-stream ring buffer cap (default 256 KiB). */
+    readonly capture_limit?: number;
+    /** SIGTERM → SIGKILL grace (default 5s). */
+    readonly kill_grace_ms?: number;
+    readonly onStdoutLine?: (line: string) => void;
+    readonly onStderrLine?: (line: string) => void;
+}
+export interface RunCommandResult {
+    exit_code: number;
+    stdout: string;
+    stderr: string;
+    duration_ms: number;
+    timed_out: boolean;
+    truncated: {
+        stdout: boolean;
+        stderr: boolean;
+    };
+}
+export declare function runCommand(command: string, opts: RunCommandOptions): Promise<RunCommandResult>;
+/** Convenience: tail of a stream for evidence `stdout_tail` / summary. */
+export declare function tailOf(text: string, maxChars?: number): string;
+//# sourceMappingURL=capture.d.ts.map

package/dist/shared/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/shared/capture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CACjD;AAKD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA8G3B;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,CAG5D"}

package/dist/shared/capture.js

@@ -0,0 +1,124 @@
+/**
+ * Streaming stdout/stderr capture with ring-buffer truncation — sub-plan
+ * 03 §S.2. Shared by `shell_exec`, `compile`, `test_run`. One module,
+ * not three, so truncation + timeout + binary-detection behavior stays
+ * consistent across validators.
+ */
+import { spawn } from "node:child_process";
+const DEFAULT_CAPTURE_LIMIT = 256 * 1024;
+const DEFAULT_KILL_GRACE_MS = 5_000;
+export async function runCommand(command, opts) {
+    const startedAt = Date.now();
+    return await new Promise((resolve, reject) => {
+        const child = spawn(command, {
+            shell: true,
+            ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+            ...(opts.env ? { env: opts.env } : {}),
+        });
+        const limit = opts.capture_limit ?? DEFAULT_CAPTURE_LIMIT;
+        let stdout = "";
+        let stderr = "";
+        let stdoutTruncated = false;
+        let stderrTruncated = false;
+        let timedOut = false;
+        let settled = false;
+        let stdoutTail = "";
+        let stderrTail = "";
+        const feed = (chunk, which) => {
+            const s = chunk.toString();
+            const appendTo = (buf, truncated) => {
+                if (truncated)
+                    return [buf, true];
+                if (buf.length + s.length > limit) {
+                    const room = Math.max(0, limit - buf.length);
+                    return [buf + s.slice(0, room), true];
+                }
+                return [buf + s, false];
+            };
+            if (which === "stdout") {
+                [stdout, stdoutTruncated] = appendTo(stdout, stdoutTruncated);
+                if (opts.onStdoutLine) {
+                    stdoutTail += s;
+                    const idx = stdoutTail.lastIndexOf("\n");
+                    if (idx >= 0) {
+                        for (const line of stdoutTail.slice(0, idx).split("\n")) {
+                            if (line.length)
+                                opts.onStdoutLine(line);
+                        }
+                        stdoutTail = stdoutTail.slice(idx + 1);
+                    }
+                }
+            }
+            else {
+                [stderr, stderrTruncated] = appendTo(stderr, stderrTruncated);
+                if (opts.onStderrLine) {
+                    stderrTail += s;
+                    const idx = stderrTail.lastIndexOf("\n");
+                    if (idx >= 0) {
+                        for (const line of stderrTail.slice(0, idx).split("\n")) {
+                            if (line.length)
+                                opts.onStderrLine(line);
+                        }
+                        stderrTail = stderrTail.slice(idx + 1);
+                    }
+                }
+            }
+        };
+        child.stdout.on("data", (c) => feed(c, "stdout"));
+        child.stderr.on("data", (c) => feed(c, "stderr"));
+        const grace = opts.kill_grace_ms ?? DEFAULT_KILL_GRACE_MS;
+        const timeoutTimer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+            const hard = setTimeout(() => child.kill("SIGKILL"), grace);
+            hard.unref();
+        }, opts.timeout_ms);
+        const onAbort = () => {
+            child.kill("SIGTERM");
+        };
+        opts.signal.addEventListener("abort", onAbort, { once: true });
+        child.on("error", (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeoutTimer);
+            opts.signal.removeEventListener("abort", onAbort);
+            reject(err);
+        });
+        child.on("close", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeoutTimer);
+            opts.signal.removeEventListener("abort", onAbort);
+            // Flush any remaining partial lines.
+            if (stdoutTail.length && opts.onStdoutLine)
+                opts.onStdoutLine(stdoutTail);
+            if (stderrTail.length && opts.onStderrLine)
+                opts.onStderrLine(stderrTail);
+            resolve({
+                exit_code: code ?? -1,
+                stdout: stdoutTruncated
+                    ? `${stdout}\n[...stdout truncated at ${limit} bytes...]`
+                    : stdout,
+                stderr: stderrTruncated
+                    ? `${stderr}\n[...stderr truncated at ${limit} bytes...]`
+                    : stderr,
+                duration_ms: Date.now() - startedAt,
+                timed_out: timedOut,
+                truncated: { stdout: stdoutTruncated, stderr: stderrTruncated },
+            });
+        });
+        if (opts.stdin !== undefined) {
+            child.stdin.write(opts.stdin);
+        }
+        child.stdin.end();
+    });
+}
+/** Convenience: tail of a stream for evidence `stdout_tail` / summary. */
+export function tailOf(text, maxChars = 4096) {
+    if (text.length <= maxChars)
+        return text;
+    return `[...]${text.slice(-maxChars)}`;
+}
+//# sourceMappingURL=capture.js.map

package/dist/shared/capture.js.map

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

package/dist/shared/ctx.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ctx_patch builders for stdlib authors (sub-plan 03 §S.4).
+ *
+ * Keeps stdlib code terse: `mergeSetArtifacts({ "plan.head": plan })`
+ * instead of spelling out the `asArtifact` wrapper per entry.
+ */
+import { type CtxPatch } from "@agenteer/core";
+export declare function setArtifacts(entries: Record<string, {
+    body: unknown;
+    media_type?: string;
+    schema_ref?: string;
+}>): Pick<CtxPatch, "set">;
+export declare function mergePatches(...patches: (CtxPatch | undefined)[]): CtxPatch | undefined;
+//# sourceMappingURL=ctx.d.ts.map

package/dist/shared/ctx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctx.d.ts","sourceRoot":"","sources":["../../src/shared/ctx.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAsC,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEnF,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACnF,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CASvB;AAED,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,GAAG,QAAQ,GAAG,SAAS,CAsBvF"}

package/dist/shared/ctx.js

@@ -0,0 +1,48 @@
+/**
+ * ctx_patch builders for stdlib authors (sub-plan 03 §S.4).
+ *
+ * Keeps stdlib code terse: `mergeSetArtifacts({ "plan.head": plan })`
+ * instead of spelling out the `asArtifact` wrapper per entry.
+ */
+import { asArtifact } from "@agenteer/core";
+export function setArtifacts(entries) {
+    const set = {};
+    for (const [key, spec] of Object.entries(entries)) {
+        set[key] = asArtifact(spec.body, {
+            ...(spec.media_type !== undefined ? { media_type: spec.media_type } : {}),
+            ...(spec.schema_ref !== undefined ? { schema_ref: spec.schema_ref } : {}),
+        });
+    }
+    return { set };
+}
+export function mergePatches(...patches) {
+    const set = {};
+    const del = [];
+    const append = {};
+    let any = false;
+    for (const p of patches) {
+        if (!p)
+            continue;
+        any = true;
+        if (p.set)
+            Object.assign(set, p.set);
+        if (p.delete)
+            del.push(...p.delete);
+        if (p.append) {
+            for (const [k, vs] of Object.entries(p.append)) {
+                append[k] = [...(append[k] ?? []), ...vs];
+            }
+        }
+    }
+    if (!any)
+        return undefined;
+    const out = {};
+    if (Object.keys(set).length)
+        out.set = set;
+    if (del.length)
+        out.delete = del;
+    if (Object.keys(append).length)
+        out.append = append;
+    return out;
+}
+//# sourceMappingURL=ctx.js.map

package/dist/shared/ctx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctx.js","sourceRoot":"","sources":["../../src/shared/ctx.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAyC,MAAM,gBAAgB,CAAC;AAEnF,MAAM,UAAU,YAAY,CAC1B,OAAoF;IAEpF,MAAM,GAAG,GAAsC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;YAC/B,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAG,OAAiC;IAC/D,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,GAAG,GAAG,IAAI,CAAC;QACX,IAAI,CAAC,CAAC,GAAG;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;IAC3C,IAAI,GAAG,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;IACjC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACpD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,4 @@
+export { runCommand, tailOf, type RunCommandOptions, type RunCommandResult, } from "./capture.js";
+export { ValidatorIssueSchema, ValidatorOutputSchema, type ValidatorIssue, type ValidatorOutput, passOutput, failOutput, } from "./validator.js";
+export { setArtifacts, mergePatches } from "./ctx.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,MAAM,EACN,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,4 @@
+export { runCommand, tailOf, } from "./capture.js";
+export { ValidatorIssueSchema, ValidatorOutputSchema, passOutput, failOutput, } from "./validator.js";
+export { setArtifacts, mergePatches } from "./ctx.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,MAAM,GAGP,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EAGrB,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/shared/validator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Validator shape (sub-plan 03 §Part B; master plan ratified resolution).
+ *
+ * Validators emit `verdict: "fail"` as DATA on `Output`, not via `Failed`.
+ * `Failed` is reserved for "couldn't run at all" (binary missing,
+ * unreadable input, capability denied). This helper normalizes the
+ * output shape so downstream meta-nodes (repair_loop, judge) can switch
+ * on a single field.
+ */
+import { z } from "zod";
+export declare const ValidatorIssueSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    severity: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>>;
+}, z.core.$strip>;
+export type ValidatorIssue = z.infer<typeof ValidatorIssueSchema>;
+export declare const ValidatorOutputSchema: z.ZodObject<{
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+    }>;
+    issues: z.ZodArray<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        severity: z.ZodDefault<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>>;
+    }, z.core.$strip>>;
+    summary: z.ZodString;
+    exit_code: z.ZodOptional<z.ZodNumber>;
+    stdout_tail: z.ZodOptional<z.ZodString>;
+    stderr_tail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ValidatorOutput = z.infer<typeof ValidatorOutputSchema>;
+export declare function passOutput(summary: string): ValidatorOutput;
+export declare function failOutput(issues: ValidatorIssue[], summary: string, extra?: {
+    exit_code?: number;
+    stdout_tail?: string;
+    stderr_tail?: string;
+}): ValidatorOutput;
+//# sourceMappingURL=validator.d.ts.map

package/dist/shared/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/shared/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;iBAUhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAE3D;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,eAAe,CASjB"}

package/dist/shared/validator.js

@@ -0,0 +1,41 @@
+/**
+ * Validator shape (sub-plan 03 §Part B; master plan ratified resolution).
+ *
+ * Validators emit `verdict: "fail"` as DATA on `Output`, not via `Failed`.
+ * `Failed` is reserved for "couldn't run at all" (binary missing,
+ * unreadable input, capability denied). This helper normalizes the
+ * output shape so downstream meta-nodes (repair_loop, judge) can switch
+ * on a single field.
+ */
+import { z } from "zod";
+export const ValidatorIssueSchema = z.object({
+    path: z.string().optional(),
+    message: z.string(),
+    code: z.string().optional(),
+    severity: z.enum(["error", "warning"]).default("error"),
+});
+export const ValidatorOutputSchema = z.object({
+    verdict: z.enum(["pass", "fail"]),
+    issues: z.array(ValidatorIssueSchema),
+    /** Short human-readable summary for logs / evidence. */
+    summary: z.string(),
+    /** Tool-level exit code if applicable; 0 for pass, non-zero for fail. */
+    exit_code: z.number().int().optional(),
+    /** Tail of raw tool output, bounded. */
+    stdout_tail: z.string().optional(),
+    stderr_tail: z.string().optional(),
+});
+export function passOutput(summary) {
+    return { verdict: "pass", issues: [], summary, exit_code: 0 };
+}
+export function failOutput(issues, summary, extra) {
+    return {
+        verdict: "fail",
+        issues,
+        summary,
+        ...(extra?.exit_code !== undefined ? { exit_code: extra.exit_code } : {}),
+        ...(extra?.stdout_tail ? { stdout_tail: extra.stdout_tail } : {}),
+        ...(extra?.stderr_tail ? { stderr_tail: extra.stderr_tail } : {}),
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/shared/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/shared/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;CACxD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACrC,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,yEAAyE;IACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,wCAAwC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAGH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAAwB,EACxB,OAAe,EACf,KAA0E;IAE1E,OAAO;QACL,OAAO,EAAE,MAAM;QACf,MAAM;QACN,OAAO;QACP,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/validators/compile.d.ts

@@ -0,0 +1,83 @@
+/**
+ * `@agenteer/node-compile` — deterministic compile validator (sub-plan 03 §6).
+ *
+ * M4 ships a TypeScript (`tsc`) adapter only; the adapter interface below
+ * is what community packages (pyright/clippy/go-build) plug into. Choosing
+ * TS-only keeps the surface small and dogfoods from day one.
+ *
+ * Deterministic given identical project state + invoking flags; results
+ * are cacheable on `(manifest, input, ctx_slice)` per sub-plan 00 §11.
+ *
+ * `shell.exec` is declared statically. The caller-supplied `cwd` decides
+ * where tsc runs; capability scope for fs.read is declared dynamically
+ * from input.cwd so workflows only hand over the directory that matters.
+ */
+import { z } from "zod";
+import { type Node } from "@agenteer/core";
+import { type ValidatorIssue, type ValidatorOutput } from "../shared/index.js";
+declare const InputSchema: z.ZodObject<{
+    language: z.ZodEnum<{
+        typescript: "typescript";
+    }>;
+    cwd: z.ZodString;
+    tsconfig: z.ZodOptional<z.ZodString>;
+    flags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    timeout_ms: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type Input = z.input<typeof InputSchema>;
+export declare function compileFactory(): Node<Input, ValidatorOutput>;
+export declare const compileManifest: {
+    manifest_version: 1;
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    required_actions: string[];
+    required_capabilities: {
+        tool_use: boolean;
+        vision: boolean;
+        structured_output: "any" | "native" | "text_parse";
+        min_context_tokens?: number | undefined;
+    };
+    dynamic_actions: boolean;
+    side_effects: {
+        writes_fs: boolean;
+        network: boolean;
+        mutates_ctx: boolean;
+        emits_ctx_variants: string[];
+        reads_ctx_variants: string[];
+    };
+    determinism: "deterministic" | "stochastic";
+    tags: string[];
+    author: string;
+    license: string;
+    input_schema?: unknown;
+    output_schema?: unknown;
+    dynamic_action_spec?: string | undefined;
+    homepage?: string | undefined;
+    repository?: string | undefined;
+    planner_hints?: {
+        cost_tier?: "cheap" | "medium" | "expensive" | undefined;
+        latency_tier?: "medium" | "fast" | "slow" | undefined;
+        typical_use?: string | undefined;
+    } | undefined;
+    sha256?: string | undefined;
+};
+/**
+ * Compile adapter interface — community-extensible.
+ *
+ * A compile adapter maps an opaque `language` id to (a) a shell command
+ * and (b) a stdout/stderr parser that extracts structured issues. The
+ * parser must be best-effort: when tool output cannot be parsed, return
+ * an empty list and let the exit code carry the verdict.
+ */
+export interface CompileAdapter {
+    readonly language: string;
+    command(opts: {
+        tsconfig?: string;
+        flags: readonly string[];
+    }): string;
+    parseIssues(combinedOutput: string): ValidatorIssue[];
+}
+export {};
+//# sourceMappingURL=compile.d.ts.map

package/dist/validators/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/validators/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,IAAI,EAMV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAc5B,QAAA,MAAM,WAAW;;;;;;;;iBASf,CAAC;AAEH,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzC,wBAAgB,cAAc,IAAI,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAqE7D;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,MAAM,CAAC;IACvE,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;CACvD"}

package/dist/validators/compile.js

@@ -0,0 +1,126 @@
+/**
+ * `@agenteer/node-compile` — deterministic compile validator (sub-plan 03 §6).
+ *
+ * M4 ships a TypeScript (`tsc`) adapter only; the adapter interface below
+ * is what community packages (pyright/clippy/go-build) plug into. Choosing
+ * TS-only keeps the surface small and dogfoods from day one.
+ *
+ * Deterministic given identical project state + invoking flags; results
+ * are cacheable on `(manifest, input, ctx_slice)` per sub-plan 00 §11.
+ *
+ * `shell.exec` is declared statically. The caller-supplied `cwd` decides
+ * where tsc runs; capability scope for fs.read is declared dynamically
+ * from input.cwd so workflows only hand over the directory that matters.
+ */
+import { z } from "zod";
+import { makeManifest, authorizeOperation, } from "@agenteer/core";
+import { failOutput, passOutput, runCommand, tailOf, ValidatorOutputSchema, } from "../shared/index.js";
+const MANIFEST = makeManifest({
+    id: "@agenteer/node-compile",
+    name: "compile",
+    description: "Run a compile step (v1: TypeScript `tsc`). Returns structured issue list; verdict is DATA.",
+    determinism: "deterministic",
+    required_actions: ["shell.exec:"],
+    dynamic_actions: true,
+    dynamic_action_spec: "fs.read:${input.cwd}",
+    tags: ["validator"],
+});
+const InputSchema = z.object({
+    /** Which language toolchain. v1 ships `typescript` only; `x-*` reserved for community. */
+    language: z.enum(["typescript"]),
+    cwd: z.string().min(1),
+    /** Explicit tsconfig path relative to cwd (default: `tsconfig.json`). */
+    tsconfig: z.string().optional(),
+    /** Additional flags (e.g. `--incremental false`). */
+    flags: z.array(z.string()).default([]),
+    timeout_ms: z.number().int().min(1).max(600_000).default(300_000),
+});
+export function compileFactory() {
+    return {
+        manifest: MANIFEST,
+        inputSchema: InputSchema,
+        outputSchema: ValidatorOutputSchema,
+        ctx: [],
+        model: null,
+        async execute(input, handle) {
+            const { language, cwd, tsconfig, flags } = input.original;
+            const timeout_ms = input.original.timeout_ms ?? 300_000;
+            try {
+                authorizeOperation(handle.granted, { kind: "shell.exec" });
+            }
+            catch (err) {
+                return {
+                    kind: "failed",
+                    reason: `permission_denied: ${err instanceof Error ? err.message : String(err)}`,
+                    retryable: false,
+                    evidence: { verdict: "fail" },
+                };
+            }
+            const adapter = ADAPTERS[language];
+            const command = adapter.command({ tsconfig, flags: flags ?? [] });
+            try {
+                const r = await runCommand(command, {
+                    cwd,
+                    timeout_ms,
+                    signal: handle.signal,
+                });
+                const issues = adapter.parseIssues(r.stdout + "\n" + r.stderr);
+                const verdict = r.exit_code === 0 && issues.length === 0 ? "pass" : "fail";
+                const out = verdict === "pass"
+                    ? {
+                        ...passOutput(`${language} compile clean (${r.duration_ms}ms)`),
+                        exit_code: r.exit_code,
+                    }
+                    : failOutput(issues.length
+                        ? issues
+                        : [
+                            {
+                                message: `${language} exited ${r.exit_code}${r.timed_out ? " (timed out)" : ""}`,
+                                severity: "error",
+                            },
+                        ], `${language} compile failed: ${issues.length} issue(s)`, {
+                        exit_code: r.exit_code,
+                        stdout_tail: tailOf(r.stdout),
+                        stderr_tail: tailOf(r.stderr),
+                    });
+                return { kind: "output", value: out, evidence: { verdict } };
+            }
+            catch (err) {
+                return {
+                    kind: "failed",
+                    reason: err instanceof Error ? err.message : String(err),
+                    retryable: true,
+                    evidence: { verdict: "fail" },
+                };
+            }
+        },
+    };
+}
+export const compileManifest = MANIFEST;
+/** tsc issue regex — `path(line,col): error TSxxxx: message`. */
+const TSC_ISSUE_RE = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:\s+(.*)$/gm;
+const TYPESCRIPT_ADAPTER = {
+    language: "typescript",
+    command(opts) {
+        const tsconfigArg = opts.tsconfig ? `--project ${JSON.stringify(opts.tsconfig)}` : "";
+        const extra = opts.flags.join(" ");
+        return `npx -y tsc --noEmit ${tsconfigArg} ${extra}`.replace(/\s+/g, " ").trim();
+    },
+    parseIssues(output) {
+        const issues = [];
+        for (const m of output.matchAll(TSC_ISSUE_RE)) {
+            const [, file, line, col, sev, msg] = m;
+            issues.push({
+                path: `${file}:${line}:${col}`,
+                message: msg.trim(),
+                code: "TS",
+                severity: sev === "warning" ? "warning" : "error",
+            });
+        }
+        return issues;
+    },
+};
+const ADAPTERS = {
+    typescript: TYPESCRIPT_ADAPTER,
+};
+//# sourceMappingURL=compile.js.map