@midscene/core 1.12.10-beta-20260920031616.0 → 1.13.0

package/dist/es/test-runner/errors.mjs

@@ -0,0 +1,201 @@
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class WorkflowError extends Error {
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            ...void 0 === this.details ? {} : {
+                details: this.details
+            }
+        };
+    }
+    constructor(message, options = {}){
+        super(message, {
+            cause: options.cause
+        }), _define_property(this, "code", void 0), _define_property(this, "details", void 0);
+        this.name = new.target.name;
+        this.code = options.code ?? 'WORKFLOW_ERROR';
+        this.details = options.details;
+    }
+}
+class WorkflowParseError extends WorkflowError {
+    constructor(message, details, cause){
+        super(message, {
+            code: 'WORKFLOW_PARSE_ERROR',
+            details,
+            cause
+        });
+    }
+}
+class NodeDefinitionError extends WorkflowError {
+    constructor(message, details){
+        super(message, {
+            code: 'NODE_DEFINITION_ERROR',
+            details
+        });
+    }
+}
+class DuplicateNodeError extends WorkflowError {
+    constructor(node){
+        super(`Node "${node}" is already registered.`, {
+            code: 'DUPLICATE_NODE',
+            details: {
+                node
+            }
+        }), _define_property(this, "node", void 0);
+        this.node = node;
+    }
+}
+class NodeNotFoundError extends WorkflowError {
+    constructor(node){
+        super(`Node "${node}" is not registered.`, {
+            code: 'NODE_NOT_FOUND',
+            details: {
+                node
+            }
+        }), _define_property(this, "node", void 0);
+        this.node = node;
+    }
+}
+class NodeInputValidationError extends WorkflowError {
+    static fromZod(node, error) {
+        const issues = error.issues.map((issue)=>({
+                code: issue.code,
+                path: issue.path.map(String).join('.'),
+                message: issue.message
+            }));
+        const firstIssue = issues[0];
+        const path = firstIssue?.path || '<root>';
+        const message = firstIssue?.message ?? 'invalid input';
+        return new NodeInputValidationError(`Node "${node}" input validation failed at "${path}": ${message}`, {
+            node,
+            issues
+        });
+    }
+    constructor(message, details){
+        super(message, {
+            code: 'NODE_INPUT_VALIDATION_ERROR',
+            details
+        });
+    }
+}
+class StepTimeoutError extends WorkflowError {
+    constructor(timeoutMs, node){
+        super(node ? `Node "${node}" timed out after ${timeoutMs}ms.` : `Step timed out after ${timeoutMs}ms.`, {
+            code: 'STEP_TIMEOUT',
+            details: {
+                timeoutMs,
+                ...void 0 === node ? {} : {
+                    node
+                }
+            }
+        }), _define_property(this, "timeoutMs", void 0), _define_property(this, "node", void 0);
+        this.timeoutMs = timeoutMs;
+        this.node = node;
+    }
+}
+class NodeExecutionError extends WorkflowError {
+    constructor(node, cause, output){
+        const causeMessage = cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');
+        super(`Node "${node}" failed: ${causeMessage}`, {
+            code: 'NODE_EXECUTION_ERROR',
+            details: {
+                node
+            },
+            cause
+        }), _define_property(this, "output", void 0), _define_property(this, "node", void 0), this.output = output;
+        this.node = node;
+    }
+}
+class WorkflowLifecycleError extends WorkflowError {
+    constructor(message, details){
+        super(message, {
+            code: 'WORKFLOW_LIFECYCLE_ERROR',
+            details
+        });
+    }
+}
+class ProjectSetupError extends WorkflowError {
+    constructor(cause, details){
+        const causeMessage = cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');
+        super(`Project "${details.projectName}" setup failed: ${causeMessage}`, {
+            code: 'PROJECT_SETUP_ERROR',
+            details,
+            cause
+        });
+    }
+}
+class ProjectTeardownError extends WorkflowError {
+    constructor(cause, details){
+        const causeMessage = cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');
+        super(`Project "${details.projectName}" teardown failed: ${causeMessage}`, {
+            code: 'PROJECT_TEARDOWN_ERROR',
+            details,
+            cause
+        });
+    }
+}
+class NodeScopeTeardownError extends WorkflowError {
+    constructor(cause, details){
+        const causeMessage = cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');
+        super(`${'case' === details.scope ? 'Case attempt' : 'Workflow document'} node teardown failed for "${details.node}": ${causeMessage}`, {
+            code: 'NODE_SCOPE_TEARDOWN_ERROR',
+            details,
+            cause
+        });
+    }
+}
+class FatalDeviceError extends WorkflowError {
+    constructor(message, cause){
+        super(message, {
+            code: 'FATAL_DEVICE_ERROR',
+            cause
+        });
+    }
+}
+const isFatalDeviceError = (error)=>{
+    if (error instanceof FatalDeviceError) return true;
+    if (error instanceof WorkflowError && 'FATAL_DEVICE_ERROR' === error.code) return true;
+    if (error instanceof Error && /device offline|device not found|(?:adb|bdc|device) connection (?:was )?closed/i.test(error.message)) return true;
+    return error instanceof Error && void 0 !== error.cause ? isFatalDeviceError(error.cause) : false;
+};
+class CaseExecutionError extends WorkflowError {
+    constructor(result){
+        super(`Case "${result.name}" failed.`, {
+            code: 'CASE_EXECUTION_FAILED',
+            details: {
+                caseId: result.caseId,
+                runId: result.runId
+            }
+        }), _define_property(this, "result", void 0);
+        this.result = result;
+    }
+}
+class WorkflowDocumentExecutionError extends WorkflowError {
+    constructor(result){
+        super(`Workflow document "${result.sourcePath}" failed.`, {
+            code: 'WORKFLOW_DOCUMENT_EXECUTION_FAILED',
+            details: {
+                documentId: result.documentId,
+                documentRunId: result.documentRunId
+            }
+        }), _define_property(this, "result", void 0);
+        this.result = result;
+    }
+}
+function normalizeNodeExecutionError(error, node) {
+    return error instanceof WorkflowError ? error : new NodeExecutionError(node, error);
+}
+export { CaseExecutionError, DuplicateNodeError, FatalDeviceError, NodeDefinitionError, NodeExecutionError, NodeInputValidationError, NodeNotFoundError, NodeScopeTeardownError, ProjectSetupError, ProjectTeardownError, StepTimeoutError, WorkflowDocumentExecutionError, WorkflowError, WorkflowLifecycleError, WorkflowParseError, isFatalDeviceError, normalizeNodeExecutionError };
+
+//# sourceMappingURL=errors.mjs.map

package/dist/es/test-runner/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner/errors.mjs","sources":["../../../src/test-runner/errors.ts"],"sourcesContent":["import type { z } from 'zod/v4';\n\nexport interface WorkflowErrorOptions {\n  code?: string;\n  details?: unknown;\n  cause?: unknown;\n}\n\nexport class WorkflowError extends Error {\n  readonly code: string;\n  readonly details?: unknown;\n\n  constructor(message: string, options: WorkflowErrorOptions = {}) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code ?? 'WORKFLOW_ERROR';\n    this.details = options.details;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      ...(this.details === undefined ? {} : { details: this.details }),\n    };\n  }\n}\n\nexport class WorkflowParseError extends WorkflowError {\n  constructor(message: string, details?: unknown, cause?: unknown) {\n    super(message, { code: 'WORKFLOW_PARSE_ERROR', details, cause });\n  }\n}\n\nexport class NodeDefinitionError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'NODE_DEFINITION_ERROR', details });\n  }\n}\n\nexport class DuplicateNodeError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string) {\n    super(`Node \"${node}\" is already registered.`, {\n      code: 'DUPLICATE_NODE',\n      details: { node },\n    });\n    this.node = node;\n  }\n}\n\nexport class NodeNotFoundError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string) {\n    super(`Node \"${node}\" is not registered.`, {\n      code: 'NODE_NOT_FOUND',\n      details: { node },\n    });\n    this.node = node;\n  }\n}\n\nexport class NodeInputValidationError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'NODE_INPUT_VALIDATION_ERROR', details });\n  }\n\n  static fromZod(node: string, error: z.ZodError): NodeInputValidationError {\n    const issues = error.issues.map((issue) => ({\n      code: issue.code,\n      path: issue.path.map(String).join('.'),\n      message: issue.message,\n    }));\n    const firstIssue = issues[0];\n    const path = firstIssue?.path || '<root>';\n    const message = firstIssue?.message ?? 'invalid input';\n    return new NodeInputValidationError(\n      `Node \"${node}\" input validation failed at \"${path}\": ${message}`,\n      { node, issues },\n    );\n  }\n}\n\nexport class StepTimeoutError extends WorkflowError {\n  readonly timeoutMs: number;\n  readonly node?: string;\n\n  constructor(timeoutMs: number, node?: string) {\n    super(\n      node\n        ? `Node \"${node}\" timed out after ${timeoutMs}ms.`\n        : `Step timed out after ${timeoutMs}ms.`,\n      {\n        code: 'STEP_TIMEOUT',\n        details: { timeoutMs, ...(node === undefined ? {} : { node }) },\n      },\n    );\n    this.timeoutMs = timeoutMs;\n    this.node = node;\n  }\n}\n\nexport class NodeExecutionError extends WorkflowError {\n  readonly node: string;\n\n  constructor(\n    node: string,\n    cause: unknown,\n    /** Failed actions can still produce useful, JSON-compatible diagnostic data. */\n    readonly output?: import('./node/types').NodeResult,\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Node \"${node}\" failed: ${causeMessage}`, {\n      code: 'NODE_EXECUTION_ERROR',\n      details: { node },\n      cause,\n    });\n    this.node = node;\n  }\n}\n\nexport class WorkflowLifecycleError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'WORKFLOW_LIFECYCLE_ERROR', details });\n  }\n}\n\nexport class ProjectSetupError extends WorkflowError {\n  constructor(cause: unknown, details: { projectName: string }) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Project \"${details.projectName}\" setup failed: ${causeMessage}`, {\n      code: 'PROJECT_SETUP_ERROR',\n      details,\n      cause,\n    });\n  }\n}\n\nexport class ProjectTeardownError extends WorkflowError {\n  constructor(\n    cause: unknown,\n    details: { projectName: string; registrationIndex: number },\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Project \"${details.projectName}\" teardown failed: ${causeMessage}`, {\n      code: 'PROJECT_TEARDOWN_ERROR',\n      details,\n      cause,\n    });\n  }\n}\n\nexport class NodeScopeTeardownError extends WorkflowError {\n  constructor(\n    cause: unknown,\n    details: {\n      scope: 'case' | 'document';\n      scopeId: string;\n      node: string;\n      registrationIndex: number;\n    },\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(\n      `${details.scope === 'case' ? 'Case attempt' : 'Workflow document'} node teardown failed for \"${details.node}\": ${causeMessage}`,\n      { code: 'NODE_SCOPE_TEARDOWN_ERROR', details, cause },\n    );\n  }\n}\n\nexport class FatalDeviceError extends WorkflowError {\n  constructor(message: string, cause?: unknown) {\n    super(message, { code: 'FATAL_DEVICE_ERROR', cause });\n  }\n}\n\nexport const isFatalDeviceError = (error: unknown): boolean => {\n  if (error instanceof FatalDeviceError) return true;\n  if (error instanceof WorkflowError && error.code === 'FATAL_DEVICE_ERROR') {\n    return true;\n  }\n  if (\n    error instanceof Error &&\n    /device offline|device not found|(?:adb|bdc|device) connection (?:was )?closed/i.test(\n      error.message,\n    )\n  ) {\n    return true;\n  }\n  return error instanceof Error && error.cause !== undefined\n    ? isFatalDeviceError(error.cause)\n    : false;\n};\n\nexport class CaseExecutionError extends WorkflowError {\n  readonly result: import('./engine/types').CaseRunResult;\n\n  constructor(result: import('./engine/types').CaseRunResult) {\n    super(`Case \"${result.name}\" failed.`, {\n      code: 'CASE_EXECUTION_FAILED',\n      details: { caseId: result.caseId, runId: result.runId },\n    });\n    this.result = result;\n  }\n}\n\nexport class WorkflowDocumentExecutionError extends WorkflowError {\n  readonly result: import('./engine/types').WorkflowDocumentRunResult;\n\n  constructor(result: import('./engine/types').WorkflowDocumentRunResult) {\n    super(`Workflow document \"${result.sourcePath}\" failed.`, {\n      code: 'WORKFLOW_DOCUMENT_EXECUTION_FAILED',\n      details: {\n        documentId: result.documentId,\n        documentRunId: result.documentRunId,\n      },\n    });\n    this.result = result;\n  }\n}\n\nexport function normalizeNodeExecutionError(\n  error: unknown,\n  node: string,\n): WorkflowError {\n  return error instanceof WorkflowError\n    ? error\n    : new NodeExecutionError(node, error);\n}\n"],"names":["WorkflowError","Error","undefined","message","options","WorkflowParseError","details","cause","NodeDefinitionError","DuplicateNodeError","node","NodeNotFoundError","NodeInputValidationError","error","issues","issue","String","firstIssue","path","StepTimeoutError","timeoutMs","NodeExecutionError","output","causeMessage","WorkflowLifecycleError","ProjectSetupError","ProjectTeardownError","NodeScopeTeardownError","FatalDeviceError","isFatalDeviceError","CaseExecutionError","result","WorkflowDocumentExecutionError","normalizeNodeExecutionError"],"mappings":";;;;;;;;;;AAQO,MAAMA,sBAAsBC;IAWjC,SAAkC;QAChC,OAAO;YACL,MAAM,IAAI,CAAC,IAAI;YACf,SAAS,IAAI,CAAC,OAAO;YACrB,MAAM,IAAI,CAAC,IAAI;YACf,GAAI,AAAiBC,WAAjB,IAAI,CAAC,OAAO,GAAiB,CAAC,IAAI;gBAAE,SAAS,IAAI,CAAC,OAAO;YAAC,CAAC;QACjE;IACF;IAdA,YAAYC,OAAe,EAAEC,UAAgC,CAAC,CAAC,CAAE;QAC/D,KAAK,CAACD,SAAS;YAAE,OAAOC,QAAQ,KAAK;QAAC,IAJxC,uBAAS,QAAT,SACA,uBAAS,WAAT;QAIE,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI;QAC3B,IAAI,CAAC,IAAI,GAAGA,QAAQ,IAAI,IAAI;QAC5B,IAAI,CAAC,OAAO,GAAGA,QAAQ,OAAO;IAChC;AAUF;AAEO,MAAMC,2BAA2BL;IACtC,YAAYG,OAAe,EAAEG,OAAiB,EAAEC,KAAe,CAAE;QAC/D,KAAK,CAACJ,SAAS;YAAE,MAAM;YAAwBG;YAASC;QAAM;IAChE;AACF;AAEO,MAAMC,4BAA4BR;IACvC,YAAYG,OAAe,EAAEG,OAAiB,CAAE;QAC9C,KAAK,CAACH,SAAS;YAAE,MAAM;YAAyBG;QAAQ;IAC1D;AACF;AAEO,MAAMG,2BAA2BT;IAGtC,YAAYU,IAAY,CAAE;QACxB,KAAK,CAAC,CAAC,MAAM,EAAEA,KAAK,wBAAwB,CAAC,EAAE;YAC7C,MAAM;YACN,SAAS;gBAAEA;YAAK;QAClB,IANF,uBAAS,QAAT;QAOE,IAAI,CAAC,IAAI,GAAGA;IACd;AACF;AAEO,MAAMC,0BAA0BX;IAGrC,YAAYU,IAAY,CAAE;QACxB,KAAK,CAAC,CAAC,MAAM,EAAEA,KAAK,oBAAoB,CAAC,EAAE;YACzC,MAAM;YACN,SAAS;gBAAEA;YAAK;QAClB,IANF,uBAAS,QAAT;QAOE,IAAI,CAAC,IAAI,GAAGA;IACd;AACF;AAEO,MAAME,iCAAiCZ;IAK5C,OAAO,QAAQU,IAAY,EAAEG,KAAiB,EAA4B;QACxE,MAAMC,SAASD,MAAM,MAAM,CAAC,GAAG,CAAC,CAACE,QAAW;gBAC1C,MAAMA,MAAM,IAAI;gBAChB,MAAMA,MAAM,IAAI,CAAC,GAAG,CAACC,QAAQ,IAAI,CAAC;gBAClC,SAASD,MAAM,OAAO;YACxB;QACA,MAAME,aAAaH,MAAM,CAAC,EAAE;QAC5B,MAAMI,OAAOD,YAAY,QAAQ;QACjC,MAAMd,UAAUc,YAAY,WAAW;QACvC,OAAO,IAAIL,yBACT,CAAC,MAAM,EAAEF,KAAK,8BAA8B,EAAEQ,KAAK,GAAG,EAAEf,SAAS,EACjE;YAAEO;YAAMI;QAAO;IAEnB;IAjBA,YAAYX,OAAe,EAAEG,OAAiB,CAAE;QAC9C,KAAK,CAACH,SAAS;YAAE,MAAM;YAA+BG;QAAQ;IAChE;AAgBF;AAEO,MAAMa,yBAAyBnB;IAIpC,YAAYoB,SAAiB,EAAEV,IAAa,CAAE;QAC5C,KAAK,CACHA,OACI,CAAC,MAAM,EAAEA,KAAK,kBAAkB,EAAEU,UAAU,GAAG,CAAC,GAChD,CAAC,qBAAqB,EAAEA,UAAU,GAAG,CAAC,EAC1C;YACE,MAAM;YACN,SAAS;gBAAEA;gBAAW,GAAIV,AAASR,WAATQ,OAAqB,CAAC,IAAI;oBAAEA;gBAAK,CAAC;YAAE;QAChE,IAXJ,uBAAS,aAAT,SACA,uBAAS,QAAT;QAYE,IAAI,CAAC,SAAS,GAAGU;QACjB,IAAI,CAAC,IAAI,GAAGV;IACd;AACF;AAEO,MAAMW,2BAA2BrB;IAGtC,YACEU,IAAY,EACZH,KAAc,EAELe,MAA0C,CACnD;QACA,MAAMC,eACJhB,iBAAiBN,QAAQM,MAAM,OAAO,GAAGS,OAAOT,SAAS;QAC3D,KAAK,CAAC,CAAC,MAAM,EAAEG,KAAK,UAAU,EAAEa,cAAc,EAAE;YAC9C,MAAM;YACN,SAAS;gBAAEb;YAAK;YAChBH;QACF,8CAdF,uBAAS,QAAT,cAMWe,MAAM,GAANA;QAST,IAAI,CAAC,IAAI,GAAGZ;IACd;AACF;AAEO,MAAMc,+BAA+BxB;IAC1C,YAAYG,OAAe,EAAEG,OAAiB,CAAE;QAC9C,KAAK,CAACH,SAAS;YAAE,MAAM;YAA4BG;QAAQ;IAC7D;AACF;AAEO,MAAMmB,0BAA0BzB;IACrC,YAAYO,KAAc,EAAED,OAAgC,CAAE;QAC5D,MAAMiB,eACJhB,iBAAiBN,QAAQM,MAAM,OAAO,GAAGS,OAAOT,SAAS;QAC3D,KAAK,CAAC,CAAC,SAAS,EAAED,QAAQ,WAAW,CAAC,gBAAgB,EAAEiB,cAAc,EAAE;YACtE,MAAM;YACNjB;YACAC;QACF;IACF;AACF;AAEO,MAAMmB,6BAA6B1B;IACxC,YACEO,KAAc,EACdD,OAA2D,CAC3D;QACA,MAAMiB,eACJhB,iBAAiBN,QAAQM,MAAM,OAAO,GAAGS,OAAOT,SAAS;QAC3D,KAAK,CAAC,CAAC,SAAS,EAAED,QAAQ,WAAW,CAAC,mBAAmB,EAAEiB,cAAc,EAAE;YACzE,MAAM;YACNjB;YACAC;QACF;IACF;AACF;AAEO,MAAMoB,+BAA+B3B;IAC1C,YACEO,KAAc,EACdD,OAKC,CACD;QACA,MAAMiB,eACJhB,iBAAiBN,QAAQM,MAAM,OAAO,GAAGS,OAAOT,SAAS;QAC3D,KAAK,CACH,GAAGD,AAAkB,WAAlBA,QAAQ,KAAK,GAAc,iBAAiB,oBAAoB,2BAA2B,EAAEA,QAAQ,IAAI,CAAC,GAAG,EAAEiB,cAAc,EAChI;YAAE,MAAM;YAA6BjB;YAASC;QAAM;IAExD;AACF;AAEO,MAAMqB,yBAAyB5B;IACpC,YAAYG,OAAe,EAAEI,KAAe,CAAE;QAC5C,KAAK,CAACJ,SAAS;YAAE,MAAM;YAAsBI;QAAM;IACrD;AACF;AAEO,MAAMsB,qBAAqB,CAAChB;IACjC,IAAIA,iBAAiBe,kBAAkB,OAAO;IAC9C,IAAIf,iBAAiBb,iBAAiBa,AAAe,yBAAfA,MAAM,IAAI,EAC9C,OAAO;IAET,IACEA,iBAAiBZ,SACjB,iFAAiF,IAAI,CACnFY,MAAM,OAAO,GAGf,OAAO;IAET,OAAOA,iBAAiBZ,SAASY,AAAgBX,WAAhBW,MAAM,KAAK,GACxCgB,mBAAmBhB,MAAM,KAAK,IAC9B;AACN;AAEO,MAAMiB,2BAA2B9B;IAGtC,YAAY+B,MAA8C,CAAE;QAC1D,KAAK,CAAC,CAAC,MAAM,EAAEA,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE;YACrC,MAAM;YACN,SAAS;gBAAE,QAAQA,OAAO,MAAM;gBAAE,OAAOA,OAAO,KAAK;YAAC;QACxD,IANF,uBAAS,UAAT;QAOE,IAAI,CAAC,MAAM,GAAGA;IAChB;AACF;AAEO,MAAMC,uCAAuChC;IAGlD,YAAY+B,MAA0D,CAAE;QACtE,KAAK,CAAC,CAAC,mBAAmB,EAAEA,OAAO,UAAU,CAAC,SAAS,CAAC,EAAE;YACxD,MAAM;YACN,SAAS;gBACP,YAAYA,OAAO,UAAU;gBAC7B,eAAeA,OAAO,aAAa;YACrC;QACF,IATF,uBAAS,UAAT;QAUE,IAAI,CAAC,MAAM,GAAGA;IAChB;AACF;AAEO,SAASE,4BACdpB,KAAc,EACdH,IAAY;IAEZ,OAAOG,iBAAiBb,gBACpBa,QACA,IAAIQ,mBAAmBX,MAAMG;AACnC"}

package/dist/es/test-runner/execution-record.mjs

@@ -0,0 +1,83 @@
+function executionRecordToResult(record) {
+    const execution = record.execution?.document;
+    const hostErrors = [
+        ...execution?.hostErrors ?? []
+    ];
+    const add = (phase, error)=>{
+        if (void 0 !== error) hostErrors.push({
+            phase,
+            error
+        });
+    };
+    add('setup', record.setupError);
+    add('execution', record.executionError);
+    for (const error of record.cleanupErrors)add('cleanup', error);
+    add('report', record.reportError);
+    for (const error of record.publicationErrors ?? [])add('publication', error);
+    for (const error of record.observerErrors ?? [])add('observer', error);
+    const projectName = record.projectName ?? execution?.projectName ?? record.platform;
+    return {
+        document: {
+            documentId: record.document.documentId,
+            documentRunId: record.runId,
+            attemptIndex: record.attemptIndex,
+            projectId: record.document.projectId,
+            projectName,
+            sourcePath: record.sourcePath,
+            status: hostErrors.length || execution?.status === 'failed' ? 'failed' : 'success',
+            startedAt: record.startedAt,
+            endedAt: record.endedAt,
+            durationMs: record.durationMs,
+            beforeAll: execution?.beforeAll ?? [],
+            afterAll: execution?.afterAll ?? [],
+            ...hostErrors.length ? {
+                hostErrors
+            } : {},
+            ...execution?.executionErrors?.length ? {
+                executionErrors: execution.executionErrors
+            } : {},
+            ...execution?.teardownErrors?.length ? {
+                teardownErrors: execution.teardownErrors
+            } : {},
+            reportScopeId: execution?.reportScopeId ?? record.runId,
+            reportPaths: [
+                ...record.reportPaths
+            ],
+            ...record.reportSources?.length ? {
+                reportSources: [
+                    ...record.reportSources
+                ]
+            } : {}
+        },
+        cases: record.execution?.cases ?? record.document.cases.map((item)=>({
+                caseId: item.caseId,
+                projectName,
+                name: item.definition.name,
+                sourcePath: item.sourcePath,
+                caseIndex: item.caseIndex,
+                status: 'not-run',
+                notRunReason: 'document-start-failed'
+            }))
+    };
+}
+function serializeWorkflowExecutionRecord(record) {
+    return serializeWorkflowValue(record);
+}
+function serializeWorkflowValue(value) {
+    return JSON.stringify(value, (_key, value)=>value instanceof Error ? {
+            name: value.name,
+            message: value.message,
+            ...'code' in value ? {
+                code: value.code
+            } : {},
+            ...'details' in value ? {
+                details: value.details
+            } : {},
+            ...value instanceof AggregateError ? {
+                errors: value.errors
+            } : {}
+        } : value, 2);
+}
+export { executionRecordToResult, serializeWorkflowExecutionRecord, serializeWorkflowValue };
+
+//# sourceMappingURL=execution-record.mjs.map

package/dist/es/test-runner/execution-record.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner/execution-record.mjs","sources":["../../../src/test-runner/execution-record.ts"],"sourcesContent":["import type {\n  WorkflowDocumentExecutionResult,\n  WorkflowHostError,\n  WorkflowReportSource,\n} from './engine/types';\nimport type { CollectedWorkflowDocument } from './parser/types';\n\n/**\n * One complete document invocation, including work outside the pure kernel.\n * The entry adapter owns resources and records their lifecycle here. A failed\n * setup has a record even though no document could be executed.\n *\n * runId identifies this invocation, not an Agent/report resource. File retries\n * create new records; they do not become per-Case retries. Report projection\n * must not mutate these records or redact the original API output.\n */\nexport interface WorkflowExecutionRecord {\n  readonly runId: string;\n  readonly attemptIndex: number;\n  readonly sourcePath: string;\n  readonly platform: string;\n  readonly projectName?: string;\n  readonly document: CollectedWorkflowDocument;\n  readonly status: 'success' | 'failed';\n  readonly startedAt: string;\n  readonly endedAt: string;\n  readonly durationMs: number;\n  readonly execution?: WorkflowDocumentExecutionResult;\n  readonly setupError?: unknown;\n  readonly executionError?: unknown;\n  readonly cleanupErrors: readonly unknown[];\n  readonly outputs: Readonly<Record<string, unknown>>;\n  readonly reportPaths: readonly string[];\n  readonly reportSources?: readonly WorkflowReportSource[];\n  readonly children?: readonly WorkflowExecutionRecord[];\n  readonly reportError?: unknown;\n  /** Entry-owned report copies or result files failed after execution finished. */\n  readonly publicationErrors?: readonly unknown[];\n  /** Entry progress/result observers failed, independently of action outcomes. */\n  readonly observerErrors?: readonly unknown[];\n}\n\n/** Complete host facts as a kernel result. Report and summary consume this view. */\nexport function executionRecordToResult(\n  record: WorkflowExecutionRecord,\n): WorkflowDocumentExecutionResult {\n  const execution = record.execution?.document;\n  const hostErrors: WorkflowHostError[] = [...(execution?.hostErrors ?? [])];\n  const add = (phase: WorkflowHostError['phase'], error: unknown) => {\n    if (error !== undefined) hostErrors.push({ phase, error });\n  };\n  add('setup', record.setupError);\n  add('execution', record.executionError);\n  for (const error of record.cleanupErrors) add('cleanup', error);\n  add('report', record.reportError);\n  for (const error of record.publicationErrors ?? []) add('publication', error);\n  for (const error of record.observerErrors ?? []) add('observer', error);\n  const projectName =\n    record.projectName ?? execution?.projectName ?? record.platform;\n  return {\n    document: {\n      documentId: record.document.documentId,\n      documentRunId: record.runId,\n      attemptIndex: record.attemptIndex,\n      projectId: record.document.projectId,\n      projectName,\n      sourcePath: record.sourcePath,\n      // Case failures are counted separately; host failures must not convert\n      // successful Cases into retryable action failures.\n      status:\n        hostErrors.length || execution?.status === 'failed'\n          ? 'failed'\n          : 'success',\n      startedAt: record.startedAt,\n      endedAt: record.endedAt,\n      durationMs: record.durationMs,\n      beforeAll: execution?.beforeAll ?? [],\n      afterAll: execution?.afterAll ?? [],\n      ...(hostErrors.length ? { hostErrors } : {}),\n      ...(execution?.executionErrors?.length\n        ? { executionErrors: execution.executionErrors }\n        : {}),\n      ...(execution?.teardownErrors?.length\n        ? { teardownErrors: execution.teardownErrors }\n        : {}),\n      reportScopeId: execution?.reportScopeId ?? record.runId,\n      reportPaths: [...record.reportPaths],\n      ...(record.reportSources?.length\n        ? { reportSources: [...record.reportSources] }\n        : {}),\n    },\n    cases:\n      record.execution?.cases ??\n      record.document.cases.map((item) => ({\n        caseId: item.caseId,\n        projectName,\n        name: item.definition.name,\n        sourcePath: item.sourcePath,\n        caseIndex: item.caseIndex,\n        status: 'not-run' as const,\n        notRunReason: 'document-start-failed' as const,\n      })),\n  };\n}\n\n/** Persist execution facts across workers without dropping native Error fields. */\nexport function serializeWorkflowExecutionRecord(\n  record: WorkflowExecutionRecord,\n): string {\n  return serializeWorkflowValue(record);\n}\n\n/** The same error-preserving encoding for entry results and worker envelopes. */\nexport function serializeWorkflowValue(value: unknown): string {\n  return JSON.stringify(\n    value,\n    (_key, value) =>\n      value instanceof Error\n        ? {\n            name: value.name,\n            message: value.message,\n            ...('code' in value ? { code: value.code } : {}),\n            ...('details' in value ? { details: value.details } : {}),\n            ...(value instanceof AggregateError\n              ? { errors: value.errors }\n              : {}),\n          }\n        : value,\n    2,\n  );\n}\n"],"names":["executionRecordToResult","record","execution","hostErrors","add","phase","error","undefined","projectName","item","serializeWorkflowExecutionRecord","serializeWorkflowValue","value","JSON","_key","Error","AggregateError"],"mappings":"AA2CO,SAASA,wBACdC,MAA+B;IAE/B,MAAMC,YAAYD,OAAO,SAAS,EAAE;IACpC,MAAME,aAAkC;WAAKD,WAAW,cAAc,EAAE;KAAE;IAC1E,MAAME,MAAM,CAACC,OAAmCC;QAC9C,IAAIA,AAAUC,WAAVD,OAAqBH,WAAW,IAAI,CAAC;YAAEE;YAAOC;QAAM;IAC1D;IACAF,IAAI,SAASH,OAAO,UAAU;IAC9BG,IAAI,aAAaH,OAAO,cAAc;IACtC,KAAK,MAAMK,SAASL,OAAO,aAAa,CAAEG,IAAI,WAAWE;IACzDF,IAAI,UAAUH,OAAO,WAAW;IAChC,KAAK,MAAMK,SAASL,OAAO,iBAAiB,IAAI,EAAE,CAAEG,IAAI,eAAeE;IACvE,KAAK,MAAMA,SAASL,OAAO,cAAc,IAAI,EAAE,CAAEG,IAAI,YAAYE;IACjE,MAAME,cACJP,OAAO,WAAW,IAAIC,WAAW,eAAeD,OAAO,QAAQ;IACjE,OAAO;QACL,UAAU;YACR,YAAYA,OAAO,QAAQ,CAAC,UAAU;YACtC,eAAeA,OAAO,KAAK;YAC3B,cAAcA,OAAO,YAAY;YACjC,WAAWA,OAAO,QAAQ,CAAC,SAAS;YACpCO;YACA,YAAYP,OAAO,UAAU;YAG7B,QACEE,WAAW,MAAM,IAAID,WAAW,WAAW,WACvC,WACA;YACN,WAAWD,OAAO,SAAS;YAC3B,SAASA,OAAO,OAAO;YACvB,YAAYA,OAAO,UAAU;YAC7B,WAAWC,WAAW,aAAa,EAAE;YACrC,UAAUA,WAAW,YAAY,EAAE;YACnC,GAAIC,WAAW,MAAM,GAAG;gBAAEA;YAAW,IAAI,CAAC,CAAC;YAC3C,GAAID,WAAW,iBAAiB,SAC5B;gBAAE,iBAAiBA,UAAU,eAAe;YAAC,IAC7C,CAAC,CAAC;YACN,GAAIA,WAAW,gBAAgB,SAC3B;gBAAE,gBAAgBA,UAAU,cAAc;YAAC,IAC3C,CAAC,CAAC;YACN,eAAeA,WAAW,iBAAiBD,OAAO,KAAK;YACvD,aAAa;mBAAIA,OAAO,WAAW;aAAC;YACpC,GAAIA,OAAO,aAAa,EAAE,SACtB;gBAAE,eAAe;uBAAIA,OAAO,aAAa;iBAAC;YAAC,IAC3C,CAAC,CAAC;QACR;QACA,OACEA,OAAO,SAAS,EAAE,SAClBA,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAACQ,OAAU;gBACnC,QAAQA,KAAK,MAAM;gBACnBD;gBACA,MAAMC,KAAK,UAAU,CAAC,IAAI;gBAC1B,YAAYA,KAAK,UAAU;gBAC3B,WAAWA,KAAK,SAAS;gBACzB,QAAQ;gBACR,cAAc;YAChB;IACJ;AACF;AAGO,SAASC,iCACdT,MAA+B;IAE/B,OAAOU,uBAAuBV;AAChC;AAGO,SAASU,uBAAuBC,KAAc;IACnD,OAAOC,KAAK,SAAS,CACnBD,OACA,CAACE,MAAMF,QACLA,iBAAiBG,QACb;YACE,MAAMH,MAAM,IAAI;YAChB,SAASA,MAAM,OAAO;YACtB,GAAI,UAAUA,QAAQ;gBAAE,MAAMA,MAAM,IAAI;YAAC,IAAI,CAAC,CAAC;YAC/C,GAAI,aAAaA,QAAQ;gBAAE,SAASA,MAAM,OAAO;YAAC,IAAI,CAAC,CAAC;YACxD,GAAIA,iBAAiBI,iBACjB;gBAAE,QAAQJ,MAAM,MAAM;YAAC,IACvB,CAAC,CAAC;QACR,IACAA,OACN;AAEJ"}

package/dist/es/test-runner/index.mjs

@@ -0,0 +1,12 @@
+export * from "./engine/index.mjs";
+export * from "./errors.mjs";
+export * from "./execution-record.mjs";
+export * from "./node/index.mjs";
+export * from "./parser/normalize.mjs";
+export * from "./parser/document-format.mjs";
+export * from "./parser/types.mjs";
+export * from "./project.mjs";
+export * from "./reporting/types.mjs";
+export * from "./reporting/sanitize.mjs";
+export * from "./reporting/test-run-report.mjs";
+export * from "./reporting/execution-record.mjs";

package/dist/es/test-runner/node/define-node.mjs

@@ -0,0 +1,44 @@
+import { z } from "zod/v4";
+import { NodeDefinitionError } from "../errors.mjs";
+const validateOptionalText = (value, field, node)=>{
+    if (void 0 !== value && ('string' != typeof value || 0 === value.trim().length)) throw new NodeDefinitionError(`Node "${node}" ${field} must be a non-empty string.`, {
+        node,
+        field
+    });
+};
+const validateInputSchema = (schema, node)=>{
+    if (void 0 === schema) return;
+    if (!(schema instanceof z.ZodObject)) throw new NodeDefinitionError(`Node "${node}" inputSchema must be a Zod object schema.`, {
+        node,
+        field: 'inputSchema'
+    });
+    if ('$' in schema.shape) throw new NodeDefinitionError(`Node "${node}" inputSchema must not declare "$" as an input property.`, {
+        node,
+        field: 'inputSchema.$'
+    });
+};
+const validateDefinition = (options)=>{
+    if (!options || 'object' != typeof options) throw new NodeDefinitionError('Node definition must be an object.');
+    if ('string' != typeof options.name || 0 === options.name.trim().length) throw new NodeDefinitionError('Node name must be a non-empty string.');
+    validateOptionalText(options.title, 'title', options.name);
+    validateOptionalText(options.description, "description", options.name);
+    if (void 0 !== options.stringInputKey && false !== options.stringInputKey && ('string' != typeof options.stringInputKey || 0 === options.stringInputKey.trim().length)) throw new NodeDefinitionError(`Node "${options.name}" stringInputKey must be a non-empty string or false.`, {
+        node: options.name,
+        field: 'stringInputKey'
+    });
+    validateInputSchema(options.inputSchema, options.name);
+    if ('string' == typeof options.stringInputKey && options.inputSchema instanceof z.ZodObject && !(options.stringInputKey in options.inputSchema.shape)) throw new NodeDefinitionError(`Node "${options.name}" stringInputKey must reference a field in inputSchema.`, {
+        node: options.name,
+        field: 'stringInputKey'
+    });
+    if ('function' != typeof options.execute) throw new NodeDefinitionError(`Node "${options.name}" must provide an execute function.`, {
+        node: options.name
+    });
+};
+function defineNode(options) {
+    validateDefinition(options);
+    return options;
+}
+export { defineNode };
+
+//# sourceMappingURL=define-node.mjs.map

package/dist/es/test-runner/node/define-node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner/node/define-node.mjs","sources":["../../../../src/test-runner/node/define-node.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport { NodeDefinitionError } from '../errors';\nimport type {\n  DefineNodeOptions,\n  DefineNodeWithSchemaOptions,\n  NodeDefinition,\n  NodeDefinitionWithSchema,\n  NodeInputSchema,\n} from './types';\n\nconst validateOptionalText = (\n  value: unknown,\n  field: 'title' | 'description',\n  node: string,\n): void => {\n  if (\n    value !== undefined &&\n    (typeof value !== 'string' || value.trim().length === 0)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" ${field} must be a non-empty string.`,\n      { node, field },\n    );\n  }\n};\n\nconst validateInputSchema = (schema: unknown, node: string): void => {\n  if (schema === undefined) return;\n  if (!(schema instanceof z.ZodObject)) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" inputSchema must be a Zod object schema.`,\n      { node, field: 'inputSchema' },\n    );\n  }\n  if ('$' in schema.shape) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" inputSchema must not declare \"$\" as an input property.`,\n      { node, field: 'inputSchema.$' },\n    );\n  }\n};\n\nconst validateDefinition = (options: {\n  name: string;\n  title?: unknown;\n  description?: unknown;\n  stringInputKey?: unknown;\n  inputSchema?: unknown;\n  execute: unknown;\n}): void => {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError('Node definition must be an object.');\n  }\n\n  if (typeof options.name !== 'string' || options.name.trim().length === 0) {\n    throw new NodeDefinitionError('Node name must be a non-empty string.');\n  }\n\n  validateOptionalText(options.title, 'title', options.name);\n  validateOptionalText(options.description, 'description', options.name);\n  if (\n    options.stringInputKey !== undefined &&\n    options.stringInputKey !== false &&\n    (typeof options.stringInputKey !== 'string' ||\n      options.stringInputKey.trim().length === 0)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" stringInputKey must be a non-empty string or false.`,\n      { node: options.name, field: 'stringInputKey' },\n    );\n  }\n  validateInputSchema(options.inputSchema, options.name);\n\n  if (\n    typeof options.stringInputKey === 'string' &&\n    options.inputSchema instanceof z.ZodObject &&\n    !(options.stringInputKey in options.inputSchema.shape)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" stringInputKey must reference a field in inputSchema.`,\n      { node: options.name, field: 'stringInputKey' },\n    );\n  }\n\n  if (typeof options.execute !== 'function') {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" must provide an execute function.`,\n      { node: options.name },\n    );\n  }\n};\n\nexport function defineNode<\n  TSchema extends NodeInputSchema,\n  TData = unknown,\n  TContext = unknown,\n>(\n  options: DefineNodeWithSchemaOptions<TSchema, TData, TContext>,\n): NodeDefinitionWithSchema<TSchema, TData, TContext>;\n\nexport function defineNode<\n  TInput = unknown,\n  TData = unknown,\n  TContext = unknown,\n>(\n  options: DefineNodeOptions<TInput, TData, TContext>,\n): NodeDefinition<TInput, TData, TContext>;\n\nexport function defineNode(\n  options: DefineNodeOptions<any, any, any>,\n): NodeDefinition<any, any, any> {\n  validateDefinition(options);\n  return options;\n}\n"],"names":["validateOptionalText","value","field","node","undefined","NodeDefinitionError","validateInputSchema","schema","z","validateDefinition","options","defineNode"],"mappings":";;AAUA,MAAMA,uBAAuB,CAC3BC,OACAC,OACAC;IAEA,IACEF,AAAUG,WAAVH,SACC,CAAiB,YAAjB,OAAOA,SAAsBA,AAAwB,MAAxBA,MAAM,IAAI,GAAG,MAAM,AAAK,GAEtD,MAAM,IAAII,oBACR,CAAC,MAAM,EAAEF,KAAK,EAAE,EAAED,MAAM,4BAA4B,CAAC,EACrD;QAAEC;QAAMD;IAAM;AAGpB;AAEA,MAAMI,sBAAsB,CAACC,QAAiBJ;IAC5C,IAAII,AAAWH,WAAXG,QAAsB;IAC1B,IAAI,CAAEA,CAAAA,kBAAkBC,EAAE,SAAQ,GAChC,MAAM,IAAIH,oBACR,CAAC,MAAM,EAAEF,KAAK,0CAA0C,CAAC,EACzD;QAAEA;QAAM,OAAO;IAAc;IAGjC,IAAI,OAAOI,OAAO,KAAK,EACrB,MAAM,IAAIF,oBACR,CAAC,MAAM,EAAEF,KAAK,wDAAwD,CAAC,EACvE;QAAEA;QAAM,OAAO;IAAgB;AAGrC;AAEA,MAAMM,qBAAqB,CAACC;IAQ1B,IAAI,CAACA,WAAW,AAAmB,YAAnB,OAAOA,SACrB,MAAM,IAAIL,oBAAoB;IAGhC,IAAI,AAAwB,YAAxB,OAAOK,QAAQ,IAAI,IAAiBA,AAA+B,MAA/BA,QAAQ,IAAI,CAAC,IAAI,GAAG,MAAM,EAChE,MAAM,IAAIL,oBAAoB;IAGhCL,qBAAqBU,QAAQ,KAAK,EAAE,SAASA,QAAQ,IAAI;IACzDV,qBAAqBU,QAAQ,WAAW,EAAE,eAAeA,QAAQ,IAAI;IACrE,IACEA,AAA2BN,WAA3BM,QAAQ,cAAc,IACtBA,AAA2B,UAA3BA,QAAQ,cAAc,IACrB,CAAkC,YAAlC,OAAOA,QAAQ,cAAc,IAC5BA,AAAyC,MAAzCA,QAAQ,cAAc,CAAC,IAAI,GAAG,MAAM,AAAK,GAE3C,MAAM,IAAIL,oBACR,CAAC,MAAM,EAAEK,QAAQ,IAAI,CAAC,qDAAqD,CAAC,EAC5E;QAAE,MAAMA,QAAQ,IAAI;QAAE,OAAO;IAAiB;IAGlDJ,oBAAoBI,QAAQ,WAAW,EAAEA,QAAQ,IAAI;IAErD,IACE,AAAkC,YAAlC,OAAOA,QAAQ,cAAc,IAC7BA,QAAQ,WAAW,YAAYF,EAAE,SAAS,IAC1C,CAAEE,CAAAA,QAAQ,cAAc,IAAIA,QAAQ,WAAW,CAAC,KAAI,GAEpD,MAAM,IAAIL,oBACR,CAAC,MAAM,EAAEK,QAAQ,IAAI,CAAC,uDAAuD,CAAC,EAC9E;QAAE,MAAMA,QAAQ,IAAI;QAAE,OAAO;IAAiB;IAIlD,IAAI,AAA2B,cAA3B,OAAOA,QAAQ,OAAO,EACxB,MAAM,IAAIL,oBACR,CAAC,MAAM,EAAEK,QAAQ,IAAI,CAAC,mCAAmC,CAAC,EAC1D;QAAE,MAAMA,QAAQ,IAAI;IAAC;AAG3B;AAkBO,SAASC,WACdD,OAAyC;IAEzCD,mBAAmBC;IACnB,OAAOA;AACT"}

package/dist/es/test-runner/node/index.mjs

@@ -0,0 +1,2 @@
+export * from "./define-node.mjs";
+export * from "./types.mjs";

package/dist/es/test-runner/parser/document-format.mjs

@@ -0,0 +1,21 @@
+const nativeWorkflowRootKeys = [
+    'beforeAll',
+    'beforeEach',
+    'cases',
+    'afterEach',
+    'afterAll'
+];
+const isMapping = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const classifyWorkflowDocumentFormat = (value)=>{
+    if (!isMapping(value)) return 'unknown';
+    const hasLegacyRoot = Object.hasOwn(value, 'tasks');
+    const hasNativeRoot = nativeWorkflowRootKeys.some((key)=>Object.hasOwn(value, key));
+    if (hasLegacyRoot && hasNativeRoot) return 'mixed';
+    if (hasLegacyRoot) return 'legacy';
+    if (hasNativeRoot) return 'native';
+    if (Array.isArray(value.files)) return 'legacy-batch';
+    return 'unknown';
+};
+export { classifyWorkflowDocumentFormat, nativeWorkflowRootKeys };
+
+//# sourceMappingURL=document-format.mjs.map

package/dist/es/test-runner/parser/document-format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner/parser/document-format.mjs","sources":["../../../../src/test-runner/parser/document-format.ts"],"sourcesContent":["export const nativeWorkflowRootKeys = [\n  'beforeAll',\n  'beforeEach',\n  'cases',\n  'afterEach',\n  'afterAll',\n] as const;\n\nexport type WorkflowDocumentFormat =\n  | 'legacy'\n  | 'legacy-batch'\n  | 'native'\n  | 'mixed'\n  | 'unknown';\n\nconst isMapping = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * Classify only the document envelope. Parsing and schema validation remain\n * owned by the selected command so this helper can never route execution.\n */\nexport const classifyWorkflowDocumentFormat = (\n  value: unknown,\n): WorkflowDocumentFormat => {\n  if (!isMapping(value)) return 'unknown';\n\n  const hasLegacyRoot = Object.hasOwn(value, 'tasks');\n  const hasNativeRoot = nativeWorkflowRootKeys.some((key) =>\n    Object.hasOwn(value, key),\n  );\n\n  if (hasLegacyRoot && hasNativeRoot) return 'mixed';\n  if (hasLegacyRoot) return 'legacy';\n  if (hasNativeRoot) return 'native';\n  if (Array.isArray(value.files)) return 'legacy-batch';\n  return 'unknown';\n};\n"],"names":["nativeWorkflowRootKeys","isMapping","value","Array","classifyWorkflowDocumentFormat","hasLegacyRoot","Object","hasNativeRoot","key"],"mappings":"AAAO,MAAMA,yBAAyB;IACpC;IACA;IACA;IACA;IACA;CACD;AASD,MAAMC,YAAY,CAACC,QACjB,AAAiB,YAAjB,OAAOA,SAAsBA,AAAU,SAAVA,SAAkB,CAACC,MAAM,OAAO,CAACD;AAMzD,MAAME,iCAAiC,CAC5CF;IAEA,IAAI,CAACD,UAAUC,QAAQ,OAAO;IAE9B,MAAMG,gBAAgBC,OAAO,MAAM,CAACJ,OAAO;IAC3C,MAAMK,gBAAgBP,uBAAuB,IAAI,CAAC,CAACQ,MACjDF,OAAO,MAAM,CAACJ,OAAOM;IAGvB,IAAIH,iBAAiBE,eAAe,OAAO;IAC3C,IAAIF,eAAe,OAAO;IAC1B,IAAIE,eAAe,OAAO;IAC1B,IAAIJ,MAAM,OAAO,CAACD,MAAM,KAAK,GAAG,OAAO;IACvC,OAAO;AACT"}

package/dist/es/test-runner/parser/normalize.mjs

@@ -0,0 +1,87 @@
+import { WorkflowParseError } from "../errors.mjs";
+const supportedMetaKeys = new Set([
+    'timeout',
+    'continue-on-error'
+]);
+function isMapping(value) {
+    return 'object' == typeof value && null !== value && !Array.isArray(value) && (Object.getPrototypeOf(value) === Object.prototype || null === Object.getPrototypeOf(value));
+}
+function formatStep(index) {
+    return `step ${index + 1}`;
+}
+function normalizeMeta(value, index) {
+    if (void 0 === value) return {
+        continueOnError: false
+    };
+    if (!isMapping(value)) throw new WorkflowParseError(`${formatStep(index)} "$" must be a mapping.`, {
+        index
+    });
+    for (const key of Object.keys(value))if (!supportedMetaKeys.has(key)) throw new WorkflowParseError(`${formatStep(index)} has unsupported engine metadata "${key}".`, {
+        index,
+        key
+    });
+    const timeout = value.timeout;
+    if (void 0 !== timeout && ('number' != typeof timeout || !Number.isFinite(timeout) || timeout <= 0)) throw new WorkflowParseError(`${formatStep(index)} "$.timeout" must be a positive number of milliseconds.`, {
+        index,
+        timeout
+    });
+    const continueOnError = value['continue-on-error'];
+    if (void 0 !== continueOnError && 'boolean' != typeof continueOnError) throw new WorkflowParseError(`${formatStep(index)} "$.continue-on-error" must be a boolean.`, {
+        index,
+        continueOnError
+    });
+    return {
+        ...void 0 === timeout ? {} : {
+            timeoutMs: timeout
+        },
+        continueOnError: continueOnError ?? false
+    };
+}
+function normalizeStep(value, index = 0, resolveNode) {
+    if (!isMapping(value)) throw new WorkflowParseError(`${formatStep(index)} must be a mapping.`, {
+        index
+    });
+    const entries = Object.entries(value);
+    if (1 !== entries.length) throw new WorkflowParseError(`${formatStep(index)} must contain exactly one node.`, {
+        index,
+        nodes: Object.keys(value)
+    });
+    const [node, rawValue] = entries[0];
+    if (0 === node.trim().length) throw new WorkflowParseError(`${formatStep(index)} node name must not be empty.`, {
+        index
+    });
+    if ('string' == typeof rawValue) {
+        const resolvedNode = resolveNode?.(node);
+        const stringInputKey = resolvedNode ? resolvedNode.stringInputKey : 'prompt';
+        if (false === stringInputKey || void 0 === stringInputKey) throw new WorkflowParseError(`${formatStep(index)} node "${node}" does not accept string shorthand.`, {
+            index,
+            node
+        });
+        return {
+            node,
+            input: {
+                [stringInputKey]: rawValue
+            },
+            meta: {
+                continueOnError: false
+            }
+        };
+    }
+    if (!isMapping(rawValue)) throw new WorkflowParseError(`${formatStep(index)} value must be a string shorthand or a mapping.`, {
+        index,
+        node
+    });
+    const { $: rawMeta, ...input } = rawValue;
+    return {
+        node,
+        input,
+        meta: normalizeMeta(rawMeta, index)
+    };
+}
+function normalizeSteps(steps, resolveNode) {
+    if (!Array.isArray(steps)) throw new WorkflowParseError('Steps must be an array.');
+    return steps.map((step, index)=>normalizeStep(step, index, resolveNode));
+}
+export { normalizeStep, normalizeSteps };
+
+//# sourceMappingURL=normalize.mjs.map

package/dist/es/test-runner/parser/normalize.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner/parser/normalize.mjs","sources":["../../../../src/test-runner/parser/normalize.ts"],"sourcesContent":["import { WorkflowParseError } from '../errors';\nimport type { NormalizedStep, NormalizedStepMeta } from './types';\n\ninterface StringInputNodeDefinition {\n  stringInputKey?: string | false;\n}\n\nexport type ResolveNodeForNormalization = (\n  name: string,\n) => StringInputNodeDefinition | undefined;\n\nconst supportedMetaKeys = new Set(['timeout', 'continue-on-error']);\n\nfunction isMapping(value: unknown): value is Record<string, unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !Array.isArray(value) &&\n    (Object.getPrototypeOf(value) === Object.prototype ||\n      Object.getPrototypeOf(value) === null)\n  );\n}\n\nfunction formatStep(index: number): string {\n  return `step ${index + 1}`;\n}\n\nfunction normalizeMeta(value: unknown, index: number): NormalizedStepMeta {\n  if (value === undefined) {\n    return { continueOnError: false };\n  }\n\n  if (!isMapping(value)) {\n    throw new WorkflowParseError(\n      `${formatStep(index)} \"$\" must be a mapping.`,\n      { index },\n    );\n  }\n\n  for (const key of Object.keys(value)) {\n    if (!supportedMetaKeys.has(key)) {\n      throw new WorkflowParseError(\n        `${formatStep(index)} has unsupported engine metadata \"${key}\".`,\n        { index, key },\n      );\n    }\n  }\n\n  const timeout = value.timeout;\n  if (\n    timeout !== undefined &&\n    (typeof timeout !== 'number' || !Number.isFinite(timeout) || timeout <= 0)\n  ) {\n    throw new WorkflowParseError(\n      `${formatStep(index)} \"$.timeout\" must be a positive number of milliseconds.`,\n      { index, timeout },\n    );\n  }\n\n  const continueOnError = value['continue-on-error'];\n  if (continueOnError !== undefined && typeof continueOnError !== 'boolean') {\n    throw new WorkflowParseError(\n      `${formatStep(index)} \"$.continue-on-error\" must be a boolean.`,\n      { index, continueOnError },\n    );\n  }\n\n  return {\n    ...(timeout === undefined ? {} : { timeoutMs: timeout }),\n    continueOnError: continueOnError ?? false,\n  };\n}\n\nexport function normalizeStep(\n  value: unknown,\n  index = 0,\n  resolveNode?: ResolveNodeForNormalization,\n): NormalizedStep {\n  if (!isMapping(value)) {\n    throw new WorkflowParseError(`${formatStep(index)} must be a mapping.`, {\n      index,\n    });\n  }\n\n  const entries = Object.entries(value);\n  if (entries.length !== 1) {\n    throw new WorkflowParseError(\n      `${formatStep(index)} must contain exactly one node.`,\n      { index, nodes: Object.keys(value) },\n    );\n  }\n\n  const [node, rawValue] = entries[0];\n  if (node.trim().length === 0) {\n    throw new WorkflowParseError(\n      `${formatStep(index)} node name must not be empty.`,\n      { index },\n    );\n  }\n\n  if (typeof rawValue === 'string') {\n    const resolvedNode = resolveNode?.(node);\n    const stringInputKey = resolvedNode\n      ? resolvedNode.stringInputKey\n      : 'prompt';\n    if (stringInputKey === false || stringInputKey === undefined) {\n      throw new WorkflowParseError(\n        `${formatStep(index)} node \"${node}\" does not accept string shorthand.`,\n        { index, node },\n      );\n    }\n    return {\n      node,\n      input: { [stringInputKey]: rawValue },\n      meta: { continueOnError: false },\n    };\n  }\n\n  if (!isMapping(rawValue)) {\n    throw new WorkflowParseError(\n      `${formatStep(index)} value must be a string shorthand or a mapping.`,\n      { index, node },\n    );\n  }\n\n  const { $: rawMeta, ...input } = rawValue;\n\n  return {\n    node,\n    input,\n    meta: normalizeMeta(rawMeta, index),\n  };\n}\n\nexport function normalizeSteps(\n  steps: unknown,\n  resolveNode?: ResolveNodeForNormalization,\n): NormalizedStep[] {\n  if (!Array.isArray(steps)) {\n    throw new WorkflowParseError('Steps must be an array.');\n  }\n  return steps.map((step, index) => normalizeStep(step, index, resolveNode));\n}\n"],"names":["supportedMetaKeys","Set","isMapping","value","Array","Object","formatStep","index","normalizeMeta","undefined","WorkflowParseError","key","timeout","Number","continueOnError","normalizeStep","resolveNode","entries","node","rawValue","resolvedNode","stringInputKey","rawMeta","input","normalizeSteps","steps","step"],"mappings":"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"}

package/dist/es/test-runner/reporting/agent-report.mjs

@@ -0,0 +1,23 @@
+import { collectReportSummary } from "../../report-stats.mjs";
+import { buildTestRunReportDump } from "./test-run-report.mjs";
+function buildAgentTestRunReportDump(input, agentDump, source) {
+    const summary = collectReportSummary(agentDump);
+    return buildTestRunReportDump(input, {
+        sources: agentDump.executions.length ? [
+            {
+                ...source,
+                executionIds: agentDump.executions.flatMap((execution)=>execution.id ? [
+                        execution.id
+                    ] : [])
+            }
+        ] : [],
+        metrics: {
+            modelCallCount: summary.timing.modelCallCount,
+            modelTimeMs: summary.timing.modelCallTimeMs,
+            ...summary.tokens
+        }
+    });
+}
+export { buildAgentTestRunReportDump };
+
+//# sourceMappingURL=agent-report.mjs.map

package/dist/es/test-runner/reporting/agent-report.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner/reporting/agent-report.mjs","sources":["../../../../src/test-runner/reporting/agent-report.ts"],"sourcesContent":["import { collectReportSummary } from '../../report-stats';\nimport type { TestRunReportDump } from '../../test-run-report';\nimport type { ReportActionDump } from '../../types';\nimport { buildTestRunReportDump } from './test-run-report';\nimport type { RunReportInput } from './types';\n\nexport function buildAgentTestRunReportDump(\n  input: RunReportInput,\n  agentDump: ReportActionDump,\n  source: { scopeId: string; reportId: string; sourcePath: string },\n): TestRunReportDump {\n  const summary = collectReportSummary(agentDump);\n  return buildTestRunReportDump(input, {\n    sources: agentDump.executions.length\n      ? [\n          {\n            ...source,\n            executionIds: agentDump.executions.flatMap((execution) =>\n              execution.id ? [execution.id] : [],\n            ),\n          },\n        ]\n      : [],\n    metrics: {\n      modelCallCount: summary.timing.modelCallCount,\n      modelTimeMs: summary.timing.modelCallTimeMs,\n      ...summary.tokens,\n    },\n  });\n}\n"],"names":["buildAgentTestRunReportDump","input","agentDump","source","summary","collectReportSummary","buildTestRunReportDump","execution"],"mappings":";;AAMO,SAASA,4BACdC,KAAqB,EACrBC,SAA2B,EAC3BC,MAAiE;IAEjE,MAAMC,UAAUC,qBAAqBH;IACrC,OAAOI,uBAAuBL,OAAO;QACnC,SAASC,UAAU,UAAU,CAAC,MAAM,GAChC;YACE;gBACE,GAAGC,MAAM;gBACT,cAAcD,UAAU,UAAU,CAAC,OAAO,CAAC,CAACK,YAC1CA,UAAU,EAAE,GAAG;wBAACA,UAAU,EAAE;qBAAC,GAAG,EAAE;YAEtC;SACD,GACD,EAAE;QACN,SAAS;YACP,gBAAgBH,QAAQ,MAAM,CAAC,cAAc;YAC7C,aAAaA,QAAQ,MAAM,CAAC,eAAe;YAC3C,GAAGA,QAAQ,MAAM;QACnB;IACF;AACF"}