@automatalabs/workflows 0.28.0 → 0.29.0

package/README.md

@@ -482,16 +482,56 @@ failure, `2` dry-run failure, `3` usage error.
 Flags: `--args <json>` / `--args-file <path>`, `--workflows-dir <dir>` (repeatable — validate by
 NAME and resolve nested `workflow("<name>")` calls from your folder), `--parse-only`,
 `--cwd <dir>`, `--token-budget <n>` (exercise `budget`-guarded paths; the mock reports 1000
-tokens per call), `--max-agents <n>`, `--timeout-ms <n>`, `--json`.
-
-The same check is available programmatically — it never throws for an invalid script:
+tokens per call), `--max-agents <n>`, `--timeout-ms <n>`, `--mock-answers <json>`,
+`--mock-answers-file <path>`, `--json`. The two mock-answer flags are mutually exclusive.
+
+Mock answers select the final resolved agent label with case-sensitive, whole-label globs: `*`
+matches any characters (including `:` and `/`), `?` matches one character, and `\` escapes the
+next character. Rules are captured once in object-member order and the **last matching rule wins**,
+so put broad defaults before narrow exceptions. Raw canonical array-index property names (`"0"`
+through `"4294967294"`, with no leading zero) are rejected because JavaScript reorders them;
+escape a digit to match a numeric label, for example the JSON key `"\\10"` matches label `10`.
+`"01"` and `"4294967295"` are ordinary keys.
+
+A rule is either one reusable JSON answer or `{ "$sequence": [...] }`, a finite sequence consumed
+only when that rule wins. A raw JSON array is one array-valued answer. Each schema-bearing answer
+deep-merges over a fresh `fabricateFromSchema()` base: objects merge recursively, while arrays,
+`null`, scalars, and falsy primitives replace. The merged value is checked without coercion. Any
+answer-caused schema violation fails with `SCHEMA_NONCOMPLIANCE`; an identical failure inherited
+from an untouched limitation of the simple fabricator may be accepted with a grouped warning.
+Schema-less answers must be nonblank strings. Sequences never repeat or fall back: exhaustion fails
+the dry run, while unconsumed singles/items remain non-fatal and appear in structured `unused`
+records plus grouped warnings. Supplying mock answers serializes dry-run agent service for stable
+FIFO sequence allocation, so this mode is not a concurrency/load simulator and its token-budget
+admission timing can differ from an unscripted concurrent dry run.
+
+Fixture input is capped at 256 KiB (raw CLI UTF-8 and canonical programmatic JSON), 256 rules,
+256 UTF-16 code units per glob, 256 sequence entries, and answer nesting depth 32. Values must be
+plain JSON data. Reports and fixture errors expose only globs, counters, positions, and schema
+diagnostics—not answer bodies. A fixture is still handed to workflow code like a real agent result,
+so the script can deliberately expose it through `log()` or its return value; do not put credentials
+or production data in mock-answer files.
+
+The same check is available programmatically. Invalid workflow scripts still resolve to reports;
+an invalid `mockAnswers` option is an option-contract error and throws `TypeError` before parsing:
 
 ```ts
-import { validateWorkflowScript } from "@automatalabs/workflows";
-
-const report = await validateWorkflowScript(script, { args: { target: "src/" } });
+import { validateWorkflowScript, type MockAnswers } from "@automatalabs/workflows";
+
+const mockAnswers: MockAnswers = {
+  "*": { approved: true },
+  "refute:*": { real: false },
+  "quality:review": {
+    $sequence: [
+      { ok: false, feedback: "exercise the revision path" },
+      { ok: true },
+    ],
+  },
+};
+const report = await validateWorkflowScript(script, { args: { target: "src/" }, mockAnswers });
 report.ok;                 // parse ok AND dry run completed
-report.dryRun?.agentCalls; // [{ label, phase, model, backend, schema }, …]
+report.dryRun?.agentCalls; // calls include mockAnswer: { glob, sequenceIndex?, sequenceLength? }
+report.dryRun?.mockAnswers;// normalized rule counters + item-level unused records
 report.warnings;           // approval reminders, phase mismatches, headless-abort checkpoints, …
 ```
 
@@ -593,6 +633,8 @@ AGENTPRISM_PERSISTENCE_ROOT_ENV,
 
 // ── Types ──
 RunDynamicWorkflowOptions, WorkflowRunOptions, AgentOptions, ExecOptions,
+MockAnswerJson, MockAnswerSequence, MockAnswerRule, MockAnswers,
+ValidatedMockAnswerUse, ValidatedMockAnswerRule, UnusedMockAnswer, ValidatedMockAnswers,
 ValidateWorkflowOptions, ValidateWorkflowReport, ValidatedAgentCall, ValidatedCheckpoint,
 WorkflowManagerOptions, CheckpointOptions, WorkflowRunResult, WorkflowSnapshot,
 WorkflowPathOptions, RunPersistence, RunPersistenceOptions,

package/dist/cli.js

@@ -7,7 +7,7 @@
 // syntax, determinism blocklist), then a dry run over an in-process mock AgentRunner
 // that fabricates schema-conforming results — no ACP process is spawned. See
 // ./validate.ts for the programmatic API (`validateWorkflowScript`).
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { openWorkflowDir } from "@automatalabs/workflow-engine";
 import { validateWorkflowScript, formatValidateReport } from "./validate.js";
@@ -22,6 +22,8 @@ Validates an AgentPrism workflow script without spending tokens:
 Options:
   --args <json>          the script's \`args\` global for the dry run (a JSON value)
   --args-file <path>     read the args JSON from a file instead
+  --mock-answers <json>       label-glob mock answers for dry-run agent calls
+  --mock-answers-file <path>  read the label-glob mock answers JSON from a UTF-8 file
   --workflows-dir <dir>  a directory of workflow scripts (repeatable; precedence in
                          the order given). Enables validating by NAME (filename stem)
                          and resolves nested workflow("<name>") calls in the dry run
@@ -44,7 +46,7 @@ Notes:
 
 Exit codes: 0 valid · 1 parse/static failure · 2 dry-run failure · 3 usage error`;
 function fail(message) {
-    process.stderr.write(`${message}\n\nRun \`agentprism-workflows validate --help\` for usage.\n`);
+    writeFileSync(process.stderr.fd, `${message}\n\nRun \`agentprism-workflows validate --help\` for usage.\n`);
     process.exit(3);
 }
 function parseIntFlag(name, raw) {
@@ -63,6 +65,7 @@ async function main(argv) {
         fail(`unknown command "${command}" — the only command is: validate`);
     let file;
     let json = false;
+    let mockAnswersFlag;
     const workflowDirs = [];
     const options = {};
     for (let i = 0; i < rest.length; i++) {
@@ -95,6 +98,47 @@ async function main(argv) {
                     fail(`--args-file: ${error instanceof Error ? error.message : String(error)}`);
                 }
                 break;
+            case "--mock-answers": {
+                if (mockAnswersFlag === arg)
+                    fail(`${arg} may appear at most once`);
+                if (mockAnswersFlag)
+                    fail("--mock-answers and --mock-answers-file are mutually exclusive");
+                mockAnswersFlag = arg;
+                const source = rest[++i];
+                if (source === undefined)
+                    fail("--mock-answers expects a JSON object (quote it for your shell)");
+                if (Buffer.byteLength(source, "utf8") > 256 * 1024)
+                    fail("--mock-answers exceeds the 256 KiB source limit");
+                try {
+                    options.mockAnswers = JSON.parse(source);
+                }
+                catch {
+                    fail("--mock-answers expects a JSON object (quote it for your shell)");
+                }
+                break;
+            }
+            case "--mock-answers-file": {
+                if (mockAnswersFlag === arg)
+                    fail(`${arg} may appear at most once`);
+                if (mockAnswersFlag)
+                    fail("--mock-answers and --mock-answers-file are mutually exclusive");
+                mockAnswersFlag = arg;
+                const rawPath = rest[++i];
+                if (rawPath === undefined)
+                    fail("--mock-answers-file expects a path");
+                const path = resolve(rawPath);
+                try {
+                    if (statSync(path).size > 256 * 1024)
+                        fail("--mock-answers-file exceeds the 256 KiB source limit");
+                    options.mockAnswers = JSON.parse(readFileSync(path, "utf8"));
+                }
+                catch (error) {
+                    if (error instanceof SyntaxError)
+                        fail(`--mock-answers-file: ${error.message}`);
+                    fail(`--mock-answers-file: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                break;
+            }
             case "--workflows-dir":
                 workflowDirs.push(resolve(rest[++i] ?? fail("--workflows-dir expects a directory")));
                 break;
@@ -144,9 +188,18 @@ async function main(argv) {
     else {
         fail(`cannot read ${file}: no such file (pass --workflows-dir to validate by name)`);
     }
-    const report = await validateWorkflowScript(script, options);
-    process.stdout.write(json ? `${JSON.stringify(report, null, 2)}\n` : `${formatValidateReport(report)}\n`);
-    process.exit(report.exitCode);
+    let report;
+    try {
+        report = await validateWorkflowScript(script, options);
+    }
+    catch (error) {
+        if (mockAnswersFlag && error instanceof TypeError) {
+            fail(`${mockAnswersFlag}: ${error.message}`);
+        }
+        throw error;
+    }
+    writeFileSync(process.stdout.fd, json ? `${JSON.stringify(report, null, 2)}\n` : `${formatValidateReport(report)}\n`);
+    process.exitCode = report.exitCode;
 }
 main(process.argv.slice(2)).catch((error) => {
     process.stderr.write(`validate crashed: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`);

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import type { AgentRunner, WorkflowBackendConfig, WorkflowRunResult } from "@aut
 export { runWorkflow, parseWorkflowScript, redactText, truncateUtf8 } from "@automatalabs/workflow-engine";
 export { openWorkflowDir, type WorkflowDir, type WorkflowDirEntry, type OpenWorkflowDirOptions, } from "@automatalabs/workflow-engine";
 export { validateWorkflowScript, fabricateFromSchema, formatValidateReport, MOCK_TOKENS_PER_AGENT } from "./validate.js";
-export type { ValidateWorkflowOptions, ValidateWorkflowReport, ValidatedAgentCall, ValidatedCheckpoint, } from "./validate.js";
+export type { MockAnswerJson, MockAnswerRule, MockAnswers, MockAnswerSequence, UnusedMockAnswer, ValidateWorkflowOptions, ValidateWorkflowReport, ValidatedAgentCall, ValidatedCheckpoint, ValidatedMockAnswerRule, ValidatedMockAnswers, ValidatedMockAnswerUse, } from "./validate.js";
 export type { WorkflowRunOptions, AgentOptions, ExecOptions, WorkflowManagerOptions, CheckpointOptions, WorkflowRunResult, WorkflowSnapshot, WorkflowPathOptions, RunPersistence, RunPersistenceOptions, PersistedRunState, PersistedAgentState, WorkflowLogTail, WorkflowRunCallStatus, WorkflowRunInspectionOptions, WorkflowRunStatus, WorkflowRunStatusTruncation, } from "@automatalabs/workflow-engine";
 export { AGENTPRISM_PERSISTENCE_ROOT_ENV, WorkflowError, WorkflowErrorCode, isWorkflowError, isProviderUsageLimit, isAuthRequired, } from "@automatalabs/workflow-engine";
 export { createAcpRunner, AcpAgentRunner, InteractiveSession, selectBackend, ClaudeBackend, CodexBackend, CustomAcpBackend, AGENT_METHODS, CLIENT_METHODS, AGENT_METHOD_COVERAGE, CLIENT_METHOD_COVERAGE, ACP_AUTH_REQUIRED_ERROR_CODE, clientCapabilitiesFor, adaptPromptContent, resolveBackendRegistry, BACKENDS_ENV, toJsonSchema, toStrictJsonSchema, } from "@automatalabs/acp-agents";

package/dist/index.d.ts.map

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

package/dist/validate.d.ts

@@ -1,5 +1,14 @@
 import type { WorkflowDir } from "@automatalabs/workflow-engine";
 import type { WorkflowMeta } from "@automatalabs/shared-types";
+export type MockAnswerJson = null | boolean | number | string | MockAnswerJson[] | {
+    [key: string]: MockAnswerJson;
+};
+export interface MockAnswerSequence {
+    readonly $sequence: readonly MockAnswerJson[];
+}
+export type MockAnswerRule = MockAnswerJson | MockAnswerSequence;
+/** Label glob -> one reusable answer or one finite answer sequence. */
+export type MockAnswers = Readonly<Record<string, MockAnswerRule>>;
 export interface ValidateWorkflowOptions {
     /** The `args` global handed to the script during the dry run. */
     args?: unknown;
@@ -18,6 +27,34 @@ export interface ValidateWorkflowOptions {
     maxAgents?: number;
     /** Dry-run wall-clock limit. Default 30_000 ms. */
     timeoutMs?: number;
+    /** Dry-run answers selected by the resolved agent label. */
+    mockAnswers?: MockAnswers;
+}
+export interface ValidatedMockAnswerUse {
+    glob: string;
+    /** Zero-based in the machine report; absent for a reusable single answer. */
+    sequenceIndex?: number;
+    sequenceLength?: number;
+}
+export interface ValidatedMockAnswerRule {
+    glob: string;
+    kind: "single" | "sequence";
+    /** Reached calls whose labels matched this glob, including calls won by a later glob. */
+    matchingCalls: number;
+    /** Calls for which this rule won and reserved an answer, including fixture-validation failures. */
+    consumedCalls: number;
+    sequenceLength?: number;
+}
+export interface UnusedMockAnswer {
+    glob: string;
+    /** Zero-based sequence item; absent for a reusable single answer. */
+    sequenceIndex?: number;
+    reason: "no-match" | "shadowed" | "not-reached";
+}
+export interface ValidatedMockAnswers {
+    /** Captured normalized rule order, which also documents last-match precedence. */
+    rules: ValidatedMockAnswerRule[];
+    unused: UnusedMockAnswer[];
 }
 /** One agent() call observed during the dry run, with its backend attribution. */
 export interface ValidatedAgentCall {
@@ -32,6 +69,7 @@ export interface ValidatedAgentCall {
     backend: string;
     /** True when the call requested structured output. */
     schema: boolean;
+    mockAnswer?: ValidatedMockAnswerUse;
 }
 export interface ValidatedCheckpoint {
     prompt: string;
@@ -62,6 +100,7 @@ export interface ValidateWorkflowReport {
         durationMs: number;
         /** The script's return value, composed from fabricated agent results. */
         result?: unknown;
+        mockAnswers?: ValidatedMockAnswers;
     };
     warnings: string[];
 }

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAA2B,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAExF,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;2FACuF;IACvF,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,CAAC;IAC5C;6EACyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;8CAC0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;6FACyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,KAAK,EAAE;QACL,EAAE,EAAE,OAAO,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,YAAY,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,0EAA0E;QAC1E,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,kBAAkB,EAAE,CAAC;QACjC,WAAW,EAAE,mBAAmB,EAAE,CAAC;QACnC,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,yEAAyE;QACzE,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,SAAU,EAAE,KAAK,SAAI,GAAG,OAAO,CA2DvF;AAcD;qDACqD;AACrD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAqB1C;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAwLjC;AAMD,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAgC3E"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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"}

package/dist/validate.js

@@ -9,8 +9,463 @@
 import { mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { openWorkflowDir, WorkflowManager, parseWorkflowScript } from "@automatalabs/workflow-engine";
+import { openWorkflowDir, WorkflowError, WorkflowErrorCode, WorkflowManager, parseWorkflowScript, redactText, } from "@automatalabs/workflow-engine";
 import { resolveBackendRegistry, selectBackend } from "@automatalabs/acp-agents";
+import { Check, Errors } from "typebox/value";
+const MAX_MOCK_ANSWERS_BYTES = 256 * 1024;
+const MAX_MOCK_ANSWER_RULES = 256;
+const MAX_MOCK_ANSWER_GLOB_LENGTH = 256;
+const MAX_MOCK_ANSWER_SEQUENCE_LENGTH = 256;
+const MAX_MOCK_ANSWER_DEPTH = 32;
+const MAX_FIXTURE_REASON_LENGTH = 1024;
+function defineDataProperty(target, key, value) {
+    Object.defineProperty(target, key, {
+        value,
+        enumerable: true,
+        configurable: true,
+        writable: true,
+    });
+}
+function isJsonRecord(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function validateRecordContainer(value, path) {
+    if (!isJsonRecord(value))
+        throw new TypeError(`${path} must be an ordinary JSON object`);
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key !== "string")
+            throw new TypeError(`${path} must not contain symbol keys`);
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!descriptor || !descriptor.enumerable || !("value" in descriptor)) {
+            throw new TypeError(`${path} must contain only enumerable string-keyed data properties`);
+        }
+    }
+}
+function validateArrayContainer(value, path) {
+    if (!Array.isArray(value))
+        throw new TypeError(`${path} must be an array`);
+    for (const key of Reflect.ownKeys(value)) {
+        if (key === "length")
+            continue;
+        if (typeof key !== "string" || !/^(0|[1-9]\d*)$/.test(key) || Number(key) >= value.length) {
+            throw new TypeError(`${path} arrays must contain only indexed JSON data`);
+        }
+    }
+    for (let index = 0; index < value.length; index++) {
+        if (!Object.prototype.hasOwnProperty.call(value, index))
+            throw new TypeError(`${path} must not contain array holes`);
+        const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+        if (!descriptor || !descriptor.enumerable || !("value" in descriptor)) {
+            throw new TypeError(`${path} must contain only enumerable data properties`);
+        }
+    }
+}
+function validateJsonGraph(root, rootPath) {
+    const active = new Set();
+    const stack = [{ value: root, path: rootPath }];
+    while (stack.length > 0) {
+        const item = stack.pop();
+        const value = item.value;
+        if (item.exit) {
+            active.delete(value);
+            continue;
+        }
+        if (value === null || typeof value === "string" || typeof value === "boolean")
+            continue;
+        if (typeof value === "number") {
+            if (!Number.isFinite(value))
+                throw new TypeError(`${item.path} must contain only finite JSON numbers`);
+            continue;
+        }
+        if (typeof value !== "object")
+            throw new TypeError(`${item.path} must contain only JSON data`);
+        if (active.has(value))
+            throw new TypeError(`${item.path} must not contain cycles`);
+        active.add(value);
+        stack.push({ value, path: item.path, exit: true });
+        if (Array.isArray(value)) {
+            validateArrayContainer(value, item.path);
+            for (let index = value.length - 1; index >= 0; index--) {
+                const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+                if (!descriptor || !("value" in descriptor))
+                    throw new TypeError(`${item.path} contains invalid array data`);
+                stack.push({ value: descriptor.value, path: `${item.path}[${index}]` });
+            }
+            continue;
+        }
+        validateRecordContainer(value, item.path);
+        const keys = Reflect.ownKeys(value);
+        for (let index = keys.length - 1; index >= 0; index--) {
+            const key = keys[index];
+            if (typeof key !== "string")
+                throw new TypeError(`${item.path} contains an invalid symbol key`);
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (!descriptor || !("value" in descriptor))
+                throw new TypeError(`${item.path} contains an invalid data property`);
+            stack.push({ value: descriptor.value, path: `${item.path}.${key}` });
+        }
+    }
+}
+function validateJsonData(value, path, depth, ancestors) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new TypeError(`${path} must contain only finite JSON numbers`);
+        return;
+    }
+    if (typeof value !== "object")
+        throw new TypeError(`${path} must contain only JSON data`);
+    if (ancestors.has(value))
+        throw new TypeError(`${path} must not contain cycles`);
+    if (depth > MAX_MOCK_ANSWER_DEPTH) {
+        throw new TypeError(`${path} exceeds the maximum answer nesting depth of ${MAX_MOCK_ANSWER_DEPTH}`);
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            validateArrayContainer(value, path);
+            for (let index = 0; index < value.length; index++) {
+                const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+                if (!descriptor || !("value" in descriptor))
+                    throw new TypeError(`${path} contains invalid array data`);
+                validateJsonData(descriptor.value, `${path}[${index}]`, depth + 1, ancestors);
+            }
+            return;
+        }
+        validateRecordContainer(value, path);
+        for (const key of Reflect.ownKeys(value)) {
+            if (typeof key !== "string")
+                throw new TypeError(`${path} contains an invalid symbol key`);
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (!descriptor || !("value" in descriptor))
+                throw new TypeError(`${path} contains an invalid data property`);
+            validateJsonData(descriptor.value, `${path}.${key}`, depth + 1, ancestors);
+        }
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function cloneJsonData(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return Object.freeze(value.map((item) => cloneJsonData(item)));
+    const output = Object.create(Object.getPrototypeOf(value) === null ? null : Object.prototype);
+    for (const key of Object.keys(value))
+        defineDataProperty(output, key, cloneJsonData(value[key]));
+    return Object.freeze(output);
+}
+function isCanonicalArrayIndex(key) {
+    if (!/^(0|[1-9]\d*)$/.test(key))
+        return false;
+    return BigInt(key) <= 4294967294n;
+}
+function compileMockAnswerGlob(glob) {
+    if (glob.length === 0)
+        throw new TypeError("mock-answer globs must not be empty");
+    if (glob.length > MAX_MOCK_ANSWER_GLOB_LENGTH) {
+        throw new TypeError(`mock-answer glob ${JSON.stringify(glob)} exceeds ${MAX_MOCK_ANSWER_GLOB_LENGTH} UTF-16 code units`);
+    }
+    const points = Array.from(glob);
+    const tokens = [];
+    for (let index = 0; index < points.length; index++) {
+        const point = points[index];
+        if (point === "\\") {
+            const escaped = points[++index];
+            if (escaped === undefined)
+                throw new TypeError(`mock-answer glob ${JSON.stringify(glob)} has a trailing escape`);
+            tokens.push(Object.freeze({ kind: "literal", value: escaped }));
+        }
+        else if (point === "*") {
+            if (tokens.at(-1)?.kind !== "many")
+                tokens.push(Object.freeze({ kind: "many" }));
+        }
+        else if (point === "?") {
+            tokens.push(Object.freeze({ kind: "one" }));
+        }
+        else {
+            tokens.push(Object.freeze({ kind: "literal", value: point }));
+        }
+    }
+    return Object.freeze(tokens);
+}
+function matchesMockAnswerGlob(tokens, label) {
+    const points = Array.from(label);
+    let current = new Array(points.length + 1).fill(false);
+    current[0] = true;
+    for (const token of tokens) {
+        const next = new Array(points.length + 1).fill(false);
+        if (token.kind === "many") {
+            next[0] = current[0];
+            for (let index = 1; index <= points.length; index++)
+                next[index] = current[index] || next[index - 1];
+        }
+        else {
+            for (let index = 1; index <= points.length; index++) {
+                next[index] = current[index - 1] && (token.kind === "one" || token.value === points[index - 1]);
+            }
+        }
+        current = next;
+    }
+    return current[points.length];
+}
+function normalizeMockAnswers(value) {
+    if (!isJsonRecord(value))
+        throw new TypeError("mockAnswers must be an object mapping label globs to answers");
+    validateJsonGraph(value, "mockAnswers");
+    const globs = Object.keys(value);
+    if (globs.length > MAX_MOCK_ANSWER_RULES) {
+        throw new TypeError(`mockAnswers supports at most ${MAX_MOCK_ANSWER_RULES} rules`);
+    }
+    const rules = globs.map((glob) => {
+        if (isCanonicalArrayIndex(glob)) {
+            throw new TypeError(`mock-answer glob ${JSON.stringify(glob)} is a reserved canonical array-index key; escape a digit to match a numeric label`);
+        }
+        const tokens = compileMockAnswerGlob(glob);
+        const rawRule = value[glob];
+        if (isJsonRecord(rawRule) && Object.prototype.hasOwnProperty.call(rawRule, "$sequence")) {
+            validateRecordContainer(rawRule, `mockAnswers.${glob}`);
+            const keys = Object.keys(rawRule);
+            if (keys.length !== 1) {
+                throw new TypeError(`mock-answer sequence ${JSON.stringify(glob)} must contain only the top-level $sequence property`);
+            }
+            const sequence = rawRule.$sequence;
+            if (!Array.isArray(sequence) || sequence.length === 0) {
+                throw new TypeError(`mock-answer sequence ${JSON.stringify(glob)} must be a non-empty array`);
+            }
+            validateArrayContainer(sequence, `mockAnswers.${glob}.$sequence`);
+            if (sequence.length > MAX_MOCK_ANSWER_SEQUENCE_LENGTH) {
+                throw new TypeError(`mock-answer sequence ${JSON.stringify(glob)} supports at most ${MAX_MOCK_ANSWER_SEQUENCE_LENGTH} entries`);
+            }
+            sequence.forEach((answer, index) => validateJsonData(answer, `mockAnswers.${glob}.$sequence[${index}]`, 1, new Set()));
+            return Object.freeze({
+                glob,
+                tokens,
+                kind: "sequence",
+                answers: Object.freeze(sequence.map((answer) => cloneJsonData(answer))),
+            });
+        }
+        validateJsonData(rawRule, `mockAnswers.${glob}`, 1, new Set());
+        return Object.freeze({
+            glob,
+            tokens,
+            kind: "single",
+            answers: Object.freeze([cloneJsonData(rawRule)]),
+        });
+    });
+    const canonical = JSON.stringify(value);
+    if (Buffer.byteLength(canonical, "utf8") > MAX_MOCK_ANSWERS_BYTES) {
+        throw new TypeError(`mockAnswers exceeds the maximum canonical JSON size of ${MAX_MOCK_ANSWERS_BYTES} bytes`);
+    }
+    return {
+        rules: Object.freeze(rules),
+        counters: rules.map(() => ({ matchingCalls: 0, consumedCalls: 0 })),
+        inheritedWarnings: new Map(),
+    };
+}
+function reserveMockAnswer(state, label) {
+    let winningIndex = -1;
+    for (let index = 0; index < state.rules.length; index++) {
+        if (matchesMockAnswerGlob(state.rules[index].tokens, label)) {
+            state.counters[index].matchingCalls++;
+            winningIndex = index;
+        }
+    }
+    if (winningIndex < 0)
+        return undefined;
+    const rule = state.rules[winningIndex];
+    const counter = state.counters[winningIndex];
+    if (rule.kind === "sequence" && counter.consumedCalls >= rule.answers.length) {
+        const message = redactText(`Mock answer sequence exhausted for agent ${JSON.stringify(label)} using glob ${JSON.stringify(rule.glob)}: ` +
+            `sequence length ${rule.answers.length}, ${counter.consumedCalls} already consumed.`).value;
+        throw new WorkflowError(truncate(message, MAX_FIXTURE_REASON_LENGTH), WorkflowErrorCode.SCRIPT_VALIDATION_ERROR, {
+            recoverable: false,
+            agentLabel: label,
+        });
+    }
+    const sequenceIndex = rule.kind === "sequence" ? counter.consumedCalls : undefined;
+    const answer = rule.answers[sequenceIndex ?? 0];
+    counter.consumedCalls++;
+    return {
+        ruleIndex: winningIndex,
+        rule,
+        answer,
+        use: {
+            glob: rule.glob,
+            ...(sequenceIndex === undefined
+                ? {}
+                : { sequenceIndex, sequenceLength: rule.answers.length }),
+        },
+    };
+}
+function cloneMergeValue(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return value.map((item) => cloneMergeValue(item));
+    const output = Object.create(Object.getPrototypeOf(value) === null ? null : Object.prototype);
+    for (const key of Object.keys(value))
+        defineDataProperty(output, key, cloneMergeValue(value[key]));
+    return output;
+}
+function mergeMockAnswer(base, override, path, replacedPaths) {
+    if (isJsonRecord(base) && isJsonRecord(override)) {
+        const output = Object.create(Object.getPrototypeOf(base) === null ? null : Object.prototype);
+        for (const key of Object.keys(base))
+            defineDataProperty(output, key, cloneMergeValue(base[key]));
+        for (const key of Object.keys(override)) {
+            if (Object.prototype.hasOwnProperty.call(base, key)) {
+                defineDataProperty(output, key, mergeMockAnswer(base[key], override[key], [...path, key], replacedPaths));
+            }
+            else {
+                replacedPaths.push([...path, key]);
+                defineDataProperty(output, key, cloneMergeValue(override[key]));
+            }
+        }
+        return output;
+    }
+    replacedPaths.push(path);
+    return cloneMergeValue(override);
+}
+function parseJsonPointer(pointer) {
+    if (pointer === "")
+        return [];
+    return pointer
+        .slice(1)
+        .split("/")
+        .map((token) => token.replace(/~1/g, "/").replace(/~0/g, "~"));
+}
+function renderJsonPointer(tokens) {
+    if (tokens.length === 0)
+        return "/";
+    return `/${tokens.map((token) => token.replace(/~/g, "~0").replace(/\//g, "~1")).join("/")}`;
+}
+function relatedPaths(left, right) {
+    const length = Math.min(left.length, right.length);
+    for (let index = 0; index < length; index++) {
+        if (left[index] !== right[index])
+            return false;
+    }
+    return true;
+}
+function normalizedSchemaErrors(schema, value) {
+    return Errors(schema, value).map((error) => {
+        const tokens = parseJsonPointer(error.instancePath);
+        return { path: error.instancePath, tokens, message: error.message };
+    });
+}
+function schemaFailure(label, reservation, errors) {
+    const position = reservation.use.sequenceIndex === undefined
+        ? ""
+        : ` sequence ${reservation.use.sequenceIndex + 1}/${reservation.use.sequenceLength}`;
+    const diagnostics = errors.length === 0
+        ? "schema validation could not compare the fabricated base and scripted answer"
+        : errors
+            .slice(0, 3)
+            .map((error) => `${renderJsonPointer(error.tokens)} ${error.message}`)
+            .join("; ");
+    const message = redactText(`Mock answer for agent ${JSON.stringify(label)} from glob ${JSON.stringify(reservation.rule.glob)}${position} ` +
+        `failed schema validation: ${diagnostics}`).value;
+    return new WorkflowError(truncate(message, MAX_FIXTURE_REASON_LENGTH), WorkflowErrorCode.SCHEMA_NONCOMPLIANCE, {
+        recoverable: false,
+        agentLabel: label,
+    });
+}
+function applyStructuredMockAnswer(schema, base, reservation, label, state) {
+    const replacedPaths = [];
+    const merged = mergeMockAnswer(base, reservation.answer, [], replacedPaths);
+    try {
+        if (Check(schema, merged))
+            return merged;
+        Check(schema, base);
+        const mergedErrors = normalizedSchemaErrors(schema, merged);
+        const baseErrors = normalizedSchemaErrors(schema, base);
+        const baseFingerprints = new Set(baseErrors.map((error) => `${error.path}\u0000${error.message}`));
+        const introduced = mergedErrors.filter((error) => !baseFingerprints.has(`${error.path}\u0000${error.message}`) ||
+            replacedPaths.some((replaced) => relatedPaths(error.tokens, replaced)));
+        if (introduced.length > 0)
+            throw schemaFailure(label, reservation, introduced);
+        const paths = [...new Set(mergedErrors.map((error) => renderJsonPointer(error.tokens)))];
+        const warningKey = `${reservation.ruleIndex}\u0000${label}\u0000${paths.join("\u0000")}`;
+        const previous = state.inheritedWarnings.get(warningKey);
+        if (previous)
+            previous.count++;
+        else
+            state.inheritedWarnings.set(warningKey, { ruleIndex: reservation.ruleIndex, label, paths, count: 1 });
+        return merged;
+    }
+    catch (error) {
+        if (error instanceof WorkflowError)
+            throw error;
+        throw schemaFailure(label, reservation, []);
+    }
+}
+function applyTextMockAnswer(reservation, label) {
+    if (typeof reservation.answer === "string" && reservation.answer.trim().length > 0)
+        return reservation.answer;
+    throw schemaFailure(label, reservation, [
+        { path: "", tokens: [], message: "Expected a non-blank string for a schema-less agent call" },
+    ]);
+}
+function buildMockAnswersReport(state) {
+    const rules = state.rules.map((rule, index) => ({
+        glob: rule.glob,
+        kind: rule.kind,
+        matchingCalls: state.counters[index].matchingCalls,
+        consumedCalls: state.counters[index].consumedCalls,
+        ...(rule.kind === "sequence" ? { sequenceLength: rule.answers.length } : {}),
+    }));
+    const unused = [];
+    for (let ruleIndex = 0; ruleIndex < state.rules.length; ruleIndex++) {
+        const rule = state.rules[ruleIndex];
+        const counter = state.counters[ruleIndex];
+        if (rule.kind === "single") {
+            if (counter.consumedCalls === 0) {
+                unused.push({
+                    glob: rule.glob,
+                    reason: counter.matchingCalls === 0 ? "no-match" : "shadowed",
+                });
+            }
+            continue;
+        }
+        for (let sequenceIndex = counter.consumedCalls; sequenceIndex < rule.answers.length; sequenceIndex++) {
+            unused.push({
+                glob: rule.glob,
+                sequenceIndex,
+                reason: counter.matchingCalls === 0
+                    ? "no-match"
+                    : counter.consumedCalls === 0
+                        ? "shadowed"
+                        : "not-reached",
+            });
+        }
+    }
+    return { rules, unused };
+}
+function appendMockAnswerWarnings(state, report, warnings) {
+    for (let ruleIndex = 0; ruleIndex < state.rules.length; ruleIndex++) {
+        for (const incident of state.inheritedWarnings.values()) {
+            if (incident.ruleIndex !== ruleIndex)
+                continue;
+            const shownPaths = incident.paths.slice(0, 3);
+            const more = incident.paths.length > shownPaths.length ? ` (+${incident.paths.length - shownPaths.length} more)` : "";
+            warnings.push(`mock-answer rule ${JSON.stringify(state.rules[ruleIndex].glob)} for agent ${JSON.stringify(incident.label)} ` +
+                `was accepted with pre-existing fabricated-default limitations at ${shownPaths.join(", ")}${more} ` +
+                `(${incident.count} occurrence${incident.count === 1 ? "" : "s"})`);
+        }
+        const unused = report.unused.filter((entry) => entry.glob === state.rules[ruleIndex].glob);
+        if (unused.length > 0) {
+            const reasons = [...new Set(unused.map((entry) => entry.reason))].join(", ");
+            warnings.push(`mock-answer rule ${JSON.stringify(state.rules[ruleIndex].glob)} has ${unused.length} unused answer` +
+                `${unused.length === 1 ? "" : "s"} (${reasons})`);
+        }
+    }
+}
 /**
  * Fabricate a value that structurally satisfies a JSON Schema — the dry run's stand-in
  * for a real agent's structured output. Deterministic and intentionally simple: first
@@ -46,11 +501,12 @@ export function fabricateFromSchema(schema, hint = "value", depth = 0) {
         case "object": {
             const out = {};
             const props = (s.properties ?? {});
-            for (const [name, sub] of Object.entries(props))
-                out[name] = fabricateFromSchema(sub, name, depth + 1);
+            for (const [name, sub] of Object.entries(props)) {
+                defineDataProperty(out, name, fabricateFromSchema(sub, name, depth + 1));
+            }
             for (const name of Array.isArray(s.required) ? s.required : []) {
-                if (!(name in out))
-                    out[name] = `mock-${name}`;
+                if (!Object.prototype.hasOwnProperty.call(out, name))
+                    defineDataProperty(out, name, `mock-${name}`);
             }
             return out;
         }
@@ -115,6 +571,7 @@ function attributeBackend(model, tier, declared) {
  * AgentRunner. Never throws for an invalid script — read `report.ok` / `report.exitCode`.
  */
 export async function validateWorkflowScript(script, options = {}) {
+    const mockAnswerState = options.mockAnswers === undefined ? undefined : normalizeMockAnswers(options.mockAnswers);
     const warnings = [];
     let meta;
     try {
@@ -141,15 +598,30 @@ export async function validateWorkflowScript(script, options = {}) {
     const ownedCwd = options.cwd === undefined;
     const baseCwd = options.cwd ?? mkdtempSync(join(tmpdir(), "agentprism-validate-"));
     const persistenceRoot = mkdtempSync(join(tmpdir(), "agentprism-validate-state-"));
+    const agentCalls = [];
+    const pendingAgentCalls = [];
+    const checkpoints = [];
     const mockMeta = new Map();
     const runner = {
         async run(_prompt, runOptions = {}) {
             const label = runOptions.label ?? "";
-            mockMeta.set(label, {
+            const metadata = {
                 tier: runOptions.tier,
                 mode: runOptions.mode,
                 schema: runOptions.schema !== undefined,
-            });
+            };
+            mockMeta.set(label, metadata);
+            const pendingCall = mockAnswerState ? pendingAgentCalls.shift() : undefined;
+            if (pendingCall) {
+                pendingCall.tier = metadata.tier;
+                pendingCall.mode = metadata.mode;
+                pendingCall.schema = metadata.schema;
+                pendingCall.backend = attributeBackend(pendingCall.model, metadata.tier, declaredBackends);
+            }
+            const base = runOptions.schema === undefined ? undefined : fabricateFromSchema(runOptions.schema);
+            const reservation = mockAnswerState ? reserveMockAnswer(mockAnswerState, label) : undefined;
+            if (reservation && pendingCall)
+                pendingCall.mockAnswer = reservation.use;
             runOptions.onUsage?.({
                 input: MOCK_TOKENS_PER_AGENT - 250,
                 output: 250,
@@ -158,13 +630,16 @@ export async function validateWorkflowScript(script, options = {}) {
                 total: MOCK_TOKENS_PER_AGENT,
                 cost: 0,
             });
-            if (runOptions.schema !== undefined)
-                return fabricateFromSchema(runOptions.schema);
+            if (runOptions.schema !== undefined) {
+                if (!reservation)
+                    return base;
+                return applyStructuredMockAnswer(runOptions.schema, base, reservation, label, mockAnswerState);
+            }
+            if (reservation)
+                return applyTextMockAnswer(reservation, label);
             return `[dry-run] mock output for ${runOptions.label ?? "agent"}`;
         },
     };
-    const agentCalls = [];
-    const checkpoints = [];
     const controller = new AbortController();
     let timedOut = false;
     const timeoutMs = options.timeoutMs ?? 30_000;
@@ -181,13 +656,14 @@ export async function validateWorkflowScript(script, options = {}) {
     const manager = new WorkflowManager({
         agent: runner,
         cwd: baseCwd,
+        ...(mockAnswerState ? { concurrency: 1 } : {}),
         journaling: false,
         persistenceRoot,
         loadSavedWorkflow: flows?.resolve,
     });
     manager.on("agentStart", (event) => {
         const extra = mockMeta.get(event.label) ?? mockMeta.get("") ?? { schema: false };
-        agentCalls.push({
+        const call = {
             label: event.label,
             phase: event.phase,
             model: event.model,
@@ -195,7 +671,10 @@ export async function validateWorkflowScript(script, options = {}) {
             mode: extra.mode,
             backend: attributeBackend(event.model, extra.tier, declaredBackends),
             schema: extra.schema,
-        });
+        };
+        agentCalls.push(call);
+        if (mockAnswerState)
+            pendingAgentCalls.push(call);
     });
     try {
         const run = await manager.runSync(script, options.args, {
@@ -217,13 +696,15 @@ export async function validateWorkflowScript(script, options = {}) {
         });
         // agentStart fires BEFORE the mock records its options, so backfill attribution for
         // any call whose mock metadata arrived after the event (same tick ordering).
-        for (const call of agentCalls) {
-            const extra = mockMeta.get(call.label);
-            if (extra) {
-                call.tier = extra.tier;
-                call.mode = extra.mode;
-                call.schema = extra.schema;
-                call.backend = attributeBackend(call.model, extra.tier, declaredBackends);
+        if (!mockAnswerState) {
+            for (const call of agentCalls) {
+                const extra = mockMeta.get(call.label);
+                if (extra) {
+                    call.tier = extra.tier;
+                    call.mode = extra.mode;
+                    call.schema = extra.schema;
+                    call.backend = attributeBackend(call.model, extra.tier, declaredBackends);
+                }
             }
         }
         const ok = run.status === "completed";
@@ -249,6 +730,9 @@ export async function validateWorkflowScript(script, options = {}) {
                 }
             }
         }
+        const mockAnswers = mockAnswerState ? buildMockAnswersReport(mockAnswerState) : undefined;
+        if (mockAnswerState && mockAnswers)
+            appendMockAnswerWarnings(mockAnswerState, mockAnswers, warnings);
         return {
             ok,
             exitCode: ok ? 0 : 2,
@@ -264,6 +748,7 @@ export async function validateWorkflowScript(script, options = {}) {
                 logs: run.logs ?? [],
                 durationMs: run.durationMs,
                 result: run.result,
+                ...(mockAnswers ? { mockAnswers } : {}),
             },
             warnings,
         };
@@ -307,7 +792,13 @@ export function formatValidateReport(report) {
         lines.push(dry.ok ? `✓ dry run   completed — ${summary}` : `✗ dry run   ${dry.status} — ${dry.reason ?? "unknown failure"} (${summary})`);
         for (const call of dry.agentCalls) {
             const spec = call.model ?? (call.tier ? `tier=${call.tier}` : "(default model)");
-            const bits = [call.phase ? `[${call.phase}]` : undefined, spec, `→ ${call.backend}`, call.schema ? "(schema)" : undefined, call.mode ? `mode=${call.mode}` : undefined]
+            const mock = call.mockAnswer
+                ? `mock=${JSON.stringify(call.mockAnswer.glob)}` +
+                    (call.mockAnswer.sequenceIndex === undefined
+                        ? ""
+                        : `[${call.mockAnswer.sequenceIndex + 1}/${call.mockAnswer.sequenceLength}]`)
+                : undefined;
+            const bits = [call.phase ? `[${call.phase}]` : undefined, spec, `→ ${call.backend}`, call.schema ? "(schema)" : undefined, call.mode ? `mode=${call.mode}` : undefined, mock]
                 .filter(Boolean)
                 .join("  ");
             lines.push(`    • ${call.label}  ${bits}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automatalabs/workflows",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "license": "Apache-2.0",
   "engines": {
     "node": ">=22"
@@ -30,12 +30,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@automatalabs/shared-types": "0.17.0",
+    "typebox": "1.3.2",
+    "@automatalabs/workflow-engine": "0.18.0",
     "@automatalabs/acp-agents": "0.24.8",
-    "@automatalabs/workflow-engine": "0.18.0"
-  },
-  "devDependencies": {
-    "typebox": "1.3.2"
+    "@automatalabs/shared-types": "0.17.0"
   },
   "scripts": {
     "build": "tsc -b",