@haibun/core 4.0.0-alpha.1 → 4.0.0-alpha.3

package/build/lib/stepper-registry.d.ts

@@ -1,4 +1,4 @@
-import { AStepper } from './astepper.js';
+import { AStepper } from "./astepper.js";
 /**
  * Metadata for a single step, extracted from a stepper definition.
  * Used by both LSP (for autocomplete/hover) and MCP (for tool registration).
@@ -8,7 +8,10 @@ export interface StepDescriptor {
     stepName: string;
     method: string;
     pattern: string;
-    params: Record<string, 'string' | 'number'>;
+    params: Record<string, "string" | "number">;
+    /** Domain key for each parameter (e.g., { data: 'haibun-email', id: 'string' }) */
+    paramDomains?: Record<string, string>;
+    capability?: string;
     inputSchema?: Record<string, unknown>;
     outputSchema?: Record<string, unknown>;
 }
@@ -19,7 +22,7 @@ export interface StepDescriptor {
 export declare class StepperRegistry {
     /**
      * Extract metadata from all steps in the provided steppers.
-     * Filters out steps marked with `expose: false`.
+     * Filters out steps marked with `exposeMCP: false`.
      */
     static getMetadata(steppers: AStepper[]): StepDescriptor[];
     /**

package/build/lib/stepper-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stepper-registry.d.ts","sourceRoot":"","sources":["../../src/lib/stepper-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE;IAwB1D;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAIjD"}
+{"version":3,"file":"stepper-registry.d.ts","sourceRoot":"","sources":["../../src/lib/stepper-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC5C,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC3B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE;IAyB1D;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAIhD"}

package/build/lib/stepper-registry.js

@@ -1,5 +1,5 @@
-import { constructorName } from './util/index.js';
-import { namedInterpolation } from './namedVars.js';
+import { constructorName } from "./util/index.js";
+import { namedInterpolation } from "./namedVars.js";
 /**
  * Central registry for extracting step metadata from steppers.
  * Ensures that LSP and MCP share identical step definitions.
@@ -7,27 +7,28 @@ import { namedInterpolation } from './namedVars.js';
 export class StepperRegistry {
     /**
      * Extract metadata from all steps in the provided steppers.
-     * Filters out steps marked with `expose: false`.
+     * Filters out steps marked with `exposeMCP: false`.
      */
     static getMetadata(steppers) {
-        return steppers.flatMap(stepper => {
+        return steppers.flatMap((stepper) => {
             const stepperName = constructorName(stepper);
             return Object.entries(stepper.steps)
-                .filter(([, def]) => def.expose !== false)
+                .filter(([, def]) => def.exposeMCP !== false)
                 .map(([stepName, stepDef]) => {
                 const params = {};
                 const pattern = stepDef.gwta || stepDef.exact || stepDef.match?.toString() || stepName;
+                const paramDomains = {};
                 if (stepDef.gwta) {
                     const { stepValuesMap } = namedInterpolation(stepDef.gwta);
                     if (stepValuesMap) {
                         for (const v of Object.values(stepValuesMap)) {
-                            // Treat 'number' domain as number type, everything else as string
-                            params[v.term] = v.domain === 'number' ? 'number' : 'string';
+                            params[v.term] = v.domain === "number" ? "number" : "string";
+                            paramDomains[v.term] = v.domain || "string";
                         }
                     }
                 }
                 const method = `${stepperName}-${stepName}`;
-                return { stepperName, stepName, method, pattern, params };
+                return { stepperName, stepName, method, pattern, params, paramDomains, capability: stepDef.capability };
             });
         });
     }

package/build/lib/stepper-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepper-registry.js","sourceRoot":"","sources":["../../src/lib/stepper-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAgBpD;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAoB;QACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAChC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;iBACjC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC;iBACzC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE;gBAC3B,MAAM,MAAM,GAAwC,EAAE,CAAC;gBACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,QAAQ,CAAC;gBAEvF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,MAAM,EAAE,aAAa,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC3D,IAAI,aAAa,EAAE,CAAC;wBAClB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;4BAC7C,kEAAkE;4BAClE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;wBAC/D,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,MAAM,MAAM,GAAG,GAAG,WAAW,IAAI,QAAQ,EAAE,CAAC;gBAC5C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAC5D,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAe;QACrC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,OAAO,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC;IACtF,CAAC;CACF"}
+{"version":3,"file":"stepper-registry.js","sourceRoot":"","sources":["../../src/lib/stepper-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAmBpD;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC3B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAoB;QACtC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACnC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;iBAClC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,KAAK,CAAC;iBAC5C,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE;gBAC5B,MAAM,MAAM,GAAwC,EAAE,CAAC;gBACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,QAAQ,CAAC;gBAEvF,MAAM,YAAY,GAA2B,EAAE,CAAC;gBAChD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBAClB,MAAM,EAAE,aAAa,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC3D,IAAI,aAAa,EAAE,CAAC;wBACnB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;4BAC9C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;4BAC7D,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC;wBAC7C,CAAC;oBACF,CAAC;gBACF,CAAC;gBACD,MAAM,MAAM,GAAG,GAAG,WAAW,IAAI,QAAQ,EAAE,CAAC;gBAC5C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;YACzG,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAe;QACtC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,OAAO,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC;IACrF,CAAC;CACD"}

package/build/lib/subprocess-runner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * subprocess-runner.ts
+ *
+ * Child process entry point for subprocess sandboxing.
+ * Forked by SubprocessTransport. Uses Node.js IPC (process.send / process.on('message')).
+ *
+ * Protocol (structured-clone messages over IPC):
+ *   Startup:  child → { type: "ready", steps: StepDescriptor[] }
+ *   Request:  parent → { type: "call", method, params?, seqPath? }
+ *   Response: child  → { type: "result", ok: true, products } | { type: "result", ok: false, error }
+ */
+import type { CStepper, TWorld } from "./execution.js";
+import { type StepDescriptor } from "./stepper-registry.js";
+export type SubprocessReadyMessage = {
+    type: "ready";
+    steps: StepDescriptor[];
+};
+export type SubprocessCallMessage = {
+    type: "call";
+    method: string;
+    params?: Record<string, unknown>;
+    seqPath?: number[];
+};
+export type SubprocessResultMessage = {
+    type: "result";
+    ok: true;
+    products: Record<string, unknown>;
+} | {
+    type: "result";
+    ok: false;
+    error: string;
+};
+export type SubprocessMessage = SubprocessReadyMessage | SubprocessCallMessage | SubprocessResultMessage;
+export declare function runSubprocess(csteppers: CStepper[], world: TWorld): Promise<void>;
+//# sourceMappingURL=subprocess-runner.d.ts.map

package/build/lib/subprocess-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess-runner.d.ts","sourceRoot":"","sources":["../../src/lib/subprocess-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAIvD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE7E,MAAM,MAAM,sBAAsB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAC3H,MAAM,MAAM,uBAAuB,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,uBAAuB,CAAC;AAEzG,wBAAsB,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CvF"}

package/build/lib/subprocess-runner.js

@@ -0,0 +1,60 @@
+/**
+ * subprocess-runner.ts
+ *
+ * Child process entry point for subprocess sandboxing.
+ * Forked by SubprocessTransport. Uses Node.js IPC (process.send / process.on('message')).
+ *
+ * Protocol (structured-clone messages over IPC):
+ *   Startup:  child → { type: "ready", steps: StepDescriptor[] }
+ *   Request:  parent → { type: "call", method, params?, seqPath? }
+ *   Response: child  → { type: "result", ok: true, products } | { type: "result", ok: false, error }
+ */
+import { StepRegistry, validateToolInput, buildSyntheticFeatureStep } from "./step-dispatch.js";
+import { createSteppers, setStepperWorldsAndDomains } from "./util/index.js";
+import { addStepperConcerns } from "../phases/Executor.js";
+import { StepperRegistry } from "./stepper-registry.js";
+export async function runSubprocess(csteppers, world) {
+    const steppers = await createSteppers(csteppers);
+    await setStepperWorldsAndDomains(steppers, world);
+    await addStepperConcerns(world, steppers);
+    world.runtime.steppers = steppers;
+    const registry = new StepRegistry(steppers, world);
+    const steps = StepperRegistry.getMetadata(steppers);
+    process.send?.({ type: "ready", steps });
+    process.on("message", async (msg) => {
+        if (msg.type !== "call")
+            return;
+        const tool = registry.get(msg.method);
+        if (!tool) {
+            process.send?.({ type: "result", ok: false, error: `Method not found: ${msg.method}` });
+            return;
+        }
+        if (!msg.seqPath || msg.seqPath.length === 0) {
+            process.send?.({
+                type: "result",
+                ok: false,
+                error: `Method ${msg.method}: missing seqPath — subprocess dispatches must thread the caller's seqPath`,
+            });
+            return;
+        }
+        try {
+            const validated = validateToolInput(tool, msg.params ?? {}, world);
+            const featureStep = buildSyntheticFeatureStep(tool, validated, msg.seqPath);
+            const hr = await tool.handler(featureStep, world);
+            if (hr.ok) {
+                process.send?.({ type: "result", ok: true, products: hr.products ?? {} });
+            }
+            else {
+                process.send?.({ type: "result", ok: false, error: hr.errorMessage ?? "Step failed" });
+            }
+        }
+        catch (err) {
+            process.send?.({
+                type: "result",
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+}
+//# sourceMappingURL=subprocess-runner.js.map

package/build/lib/subprocess-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess-runner.js","sourceRoot":"","sources":["../../src/lib/subprocess-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAuB,MAAM,uBAAuB,CAAC;AAU7E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAqB,EAAE,KAAa;IACvE,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1C,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAElC,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAmC,CAAC,CAAC;IAE1E,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAsB,EAAE,EAAE;QACtD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO;QAEhC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,GAAG,CAAC,MAAM,EAAE,EAAoC,CAAC,CAAC;YAC1H,OAAO;QACR,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,EAAE,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,UAAU,GAAG,CAAC,MAAM,4EAA4E;aACrE,CAAC,CAAC;YACrC,OAAO;QACR,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YACnE,MAAM,WAAW,GAAG,yBAAyB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5E,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAClD,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE,EAAoC,CAAC,CAAC;YAC7G,CAAC;iBAAM,CAAC;gBACP,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,IAAI,aAAa,EAAoC,CAAC,CAAC;YAC1H,CAAC;QACF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,EAAE,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACrB,CAAC,CAAC;QACtC,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/build/lib/subprocess-transport.d.ts

@@ -0,0 +1,37 @@
+/**
+ * subprocess-transport.ts
+ *
+ * Parent-side subprocess transport. Forks a child process running runSubprocess(),
+ * reads its step list via IPC, and injects proxy StepTools into the parent's StepRegistry.
+ *
+ * Uses Node.js fork() IPC (structured-clone messages) — no framing, no seq IDs, no readline.
+ * The child signals readiness with { type: "ready", steps }, then serves
+ * { type: "call", method, params, seqPath } → { type: "result", ok, products|error }.
+ *
+ * seqPath threading: every call includes the caller's seqPath so the child
+ * can append its own step numbers, preserving the full [feature.scenario.step...] hierarchy.
+ */
+import type { TWorld } from "./execution.js";
+import type { TActionResult } from "../schema/protocol.js";
+import { type StepRegistry } from "./step-dispatch.js";
+import type { StepDescriptor } from "./stepper-registry.js";
+export declare class SubprocessTransport {
+    private child;
+    private stepDescriptors;
+    private constructor();
+    private pending;
+    static spawn(entryPath: string, _world: TWorld): Promise<SubprocessTransport>;
+    injectInto(registry: StepRegistry): void;
+    /**
+     * seqPath is required. Every call must thread the caller's seqPath so
+     * observations produced in the subprocess link back to the caller's
+     * execution context. Synthetic [0, N] roots are no longer produced —
+     * a caller with no meaningful seqPath should not be invoking a
+     * subprocess transport.
+     */
+    call(method: string, params: Record<string, unknown>, seqPath: number[]): Promise<TActionResult>;
+    private handleMessage;
+    kill(): void;
+    get descriptors(): StepDescriptor[];
+}
+//# sourceMappingURL=subprocess-transport.d.ts.map

package/build/lib/subprocess-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess-transport.d.ts","sourceRoot":"","sources":["../../src/lib/subprocess-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,qBAAa,mBAAmB;IAE9B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,eAAe;IAFxB,OAAO;IAaP,OAAO,CAAC,OAAO,CAAuD;WAEzD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+BnF,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IA0BxC;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAmBhG,OAAO,CAAC,aAAa,CAInB;IAEF,IAAI,IAAI,IAAI;IAIZ,IAAI,WAAW,IAAI,cAAc,EAAE,CAElC;CACD"}

package/build/lib/subprocess-transport.js

@@ -0,0 +1,113 @@
+/**
+ * subprocess-transport.ts
+ *
+ * Parent-side subprocess transport. Forks a child process running runSubprocess(),
+ * reads its step list via IPC, and injects proxy StepTools into the parent's StepRegistry.
+ *
+ * Uses Node.js fork() IPC (structured-clone messages) — no framing, no seq IDs, no readline.
+ * The child signals readiness with { type: "ready", steps }, then serves
+ * { type: "call", method, params, seqPath } → { type: "result", ok, products|error }.
+ *
+ * seqPath threading: every call includes the caller's seqPath so the child
+ * can append its own step numbers, preserving the full [feature.scenario.step...] hierarchy.
+ */
+import { fork } from "child_process";
+import { actionNotOK } from "./util/index.js";
+export class SubprocessTransport {
+    child;
+    stepDescriptors;
+    constructor(child, stepDescriptors) {
+        this.child = child;
+        this.stepDescriptors = stepDescriptors;
+        child.on("exit", (code) => {
+            if (this.pending) {
+                this.pending({ type: "result", ok: false, error: `subprocess exited with code ${code}` });
+                this.pending = null;
+            }
+        });
+    }
+    // At most one in-flight call at a time (subprocess steps execute sequentially).
+    pending = null;
+    static async spawn(entryPath, _world) {
+        const child = fork(entryPath, [], { silent: true });
+        child.stderr?.on("data", (data) => {
+            process.stderr.write(`[subprocess] ${data.toString()}`);
+        });
+        const stepDescriptors = await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => reject(new Error(`subprocess at ${entryPath} did not send ready message within 10s`)), 10_000);
+            child.once("message", (msg) => {
+                clearTimeout(timeout);
+                if (msg.type !== "ready") {
+                    reject(new Error(`subprocess first message was not "ready": ${JSON.stringify(msg)}`));
+                    return;
+                }
+                resolve(msg.steps);
+            });
+            child.once("exit", (code) => {
+                clearTimeout(timeout);
+                reject(new Error(`subprocess exited before ready (code ${code})`));
+            });
+        });
+        return new SubprocessTransport(child, stepDescriptors);
+    }
+    injectInto(registry) {
+        for (const descriptor of this.stepDescriptors) {
+            const tool = {
+                name: descriptor.method,
+                description: descriptor.pattern,
+                inputSchema: descriptor.inputSchema ?? { type: "object" },
+                paramSchemas: new Map(),
+                paramDomainKeys: new Map(),
+                stepperName: descriptor.stepperName,
+                stepName: descriptor.stepName,
+                capability: descriptor.capability,
+                isAsync: true,
+                transport: "subprocess",
+                handler: (featureStep, _world) => this.call(descriptor.method, featureStep.action?.stepValuesMap
+                    ? Object.fromEntries(Object.entries(featureStep.action.stepValuesMap).map(([k, v]) => [k, v.term]))
+                    : {}, featureStep.seqPath),
+            };
+            registry.set(tool);
+        }
+    }
+    /**
+     * seqPath is required. Every call must thread the caller's seqPath so
+     * observations produced in the subprocess link back to the caller's
+     * execution context. Synthetic [0, N] roots are no longer produced —
+     * a caller with no meaningful seqPath should not be invoking a
+     * subprocess transport.
+     */
+    call(method, params, seqPath) {
+        return new Promise((resolve, reject) => {
+            if (this.pending) {
+                reject(new Error("SubprocessTransport: concurrent calls not supported"));
+                return;
+            }
+            this.pending = (result) => {
+                this.pending = null;
+                if (result.ok) {
+                    resolve({ ok: true, products: result.products });
+                }
+                else {
+                    resolve(actionNotOK(result.error));
+                }
+            };
+            this.child.on("message", this.handleMessage);
+            this.child.send({ type: "call", method, params, seqPath });
+        });
+    }
+    handleMessage = (msg) => {
+        if (msg.type !== "result")
+            return;
+        this.child.off("message", this.handleMessage);
+        if (this.pending)
+            this.pending(msg);
+    };
+    kill() {
+        this.child.kill();
+    }
+    get descriptors() {
+        return this.stepDescriptors;
+    }
+}
+//# sourceMappingURL=subprocess-transport.js.map

package/build/lib/subprocess-transport.js.map

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

package/build/lib/test/EventCollectorStepper.d.ts

@@ -1,6 +1,6 @@
-import { AStepper } from '../astepper.js';
-import { TWorld } from '../defs.js';
-import { THaibunEvent } from '../../schema/protocol.js';
+import { AStepper } from "../astepper.js";
+import { TWorld } from "../execution.js";
+import { THaibunEvent } from "../../schema/protocol.js";
 /**
  * EventCollectorStepper - Collects events for test inspection.
  *

package/build/lib/test/EventCollectorStepper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventCollectorStepper.d.ts","sourceRoot":"","sources":["../../../src/lib/test/EventCollectorStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,WAAW,SAAyC;IAEpD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,kBAAkB,CAAC,CAAgC;IAErD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE,KAAK,KAAM;IAEX,+BAA+B;IAC/B,SAAS,IAAI,YAAY,EAAE;IAI3B,qCAAqC;IACrC,aAAa,IAAI,YAAY,EAAE;IAI/B,sCAAsC;IACtC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,YAAY,EAAE;IAInE,6BAA6B;IAC7B,KAAK,IAAI,IAAI;IAIb,oCAAoC;IACpC,KAAK,IAAI,IAAI;CAMd;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"EventCollectorStepper.d.ts","sourceRoot":"","sources":["../../../src/lib/test/EventCollectorStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;IAClD,WAAW,SAAyC;IAEpD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,kBAAkB,CAAC,CAAgC;IAErD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE,KAAK,KAAM;IAEX,+BAA+B;IAC/B,SAAS,IAAI,YAAY,EAAE;IAI3B,qCAAqC;IACrC,aAAa,IAAI,YAAY,EAAE;IAI/B,sCAAsC;IACtC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,YAAY,EAAE;IAInE,6BAA6B;IAC7B,KAAK,IAAI,IAAI;IAIb,oCAAoC;IACpC,KAAK,IAAI,IAAI;CAMb;AAED,eAAe,qBAAqB,CAAC"}

package/build/lib/test/EventCollectorStepper.js

@@ -1,4 +1,4 @@
-import { AStepper } from '../astepper.js';
+import { AStepper } from "../astepper.js";
 /**
  * EventCollectorStepper - Collects events for test inspection.
  *
@@ -11,7 +11,7 @@ import { AStepper } from '../astepper.js';
  * ```
  */
 export class EventCollectorStepper extends AStepper {
-    description = 'Collects events for test inspection';
+    description = "Collects events for test inspection";
     events = [];
     subscriberCallback;
     async setWorld(world, steppers) {
@@ -28,7 +28,7 @@ export class EventCollectorStepper extends AStepper {
     }
     /** Get step lifecycle events only */
     getStepEvents() {
-        return this.events.filter(e => 'type' in e && e.type === 'step');
+        return this.events.filter((e) => "type" in e && e.type === "step");
     }
     /** Get events matching a predicate */
     findEvents(predicate) {

package/build/lib/test/EventCollectorStepper.js.map

@@ -1 +1 @@
-{"version":3,"file":"EventCollectorStepper.js","sourceRoot":"","sources":["../../../src/lib/test/EventCollectorStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C;;;;;;;;;;GAUG;AACH,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD,WAAW,GAAG,qCAAqC,CAAC;IAE5C,MAAM,GAAmB,EAAE,CAAC;IAC5B,kBAAkB,CAAiC;IAE3D,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,QAAoB;QAChD,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,kBAAkB,GAAG,CAAC,KAAmB,EAAE,EAAE;YAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC;QACF,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,GAAG,EAAE,CAAC;IAEX,+BAA+B;IAC/B,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,qCAAqC;IACrC,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,sCAAsC;IACtC,UAAU,CAAC,SAAuC;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,oCAAoC;IACpC,KAAK;QACH,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;YACvD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC5D,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACtC,CAAC;IACH,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"EventCollectorStepper.js","sourceRoot":"","sources":["../../../src/lib/test/EventCollectorStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C;;;;;;;;;;GAUG;AACH,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IAClD,WAAW,GAAG,qCAAqC,CAAC;IAE5C,MAAM,GAAmB,EAAE,CAAC;IAC5B,kBAAkB,CAAiC;IAE3D,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,QAAoB;QACjD,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,kBAAkB,GAAG,CAAC,KAAmB,EAAE,EAAE;YACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC;QACF,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,GAAG,EAAE,CAAC;IAEX,+BAA+B;IAC/B,SAAS;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,qCAAqC;IACrC,aAAa;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,sCAAsC;IACtC,UAAU,CAAC,SAAuC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACJ,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,oCAAoC;IACpC,KAAK;QACJ,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;YACxD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC5D,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACrC,CAAC;IACF,CAAC;CACD;AAED,eAAe,qBAAqB,CAAC"}

package/build/lib/test/SetTimeStepper.d.ts

@@ -1,10 +1,10 @@
-import { TStepArgs } from '../../schema/protocol.js';
-import { AStepper } from '../astepper.js';
+import { TStepArgs } from "../../schema/protocol.js";
+import { AStepper } from "../astepper.js";
 export default class SetTimeStepper extends AStepper {
     steps: {
         setTime: {
             gwta: string;
-            action: ({ y, m, d, h, min, s }: TStepArgs) => Promise<import("../../schema/protocol.js").TOKActionResult>;
+            action: ({ y, m, d, h, min, s }: TStepArgs) => Promise<import("../../schema/protocol.js").TActionResult>;
         };
     };
 }

package/build/lib/test/SetTimeStepper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SetTimeStepper.d.ts","sourceRoot":"","sources":["../../../src/lib/test/SetTimeStepper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAM,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,QAAQ;IAClD,KAAK;;;6CAGgC,SAAS;;MAQ5C;CACH"}
+{"version":3,"file":"SetTimeStepper.d.ts","sourceRoot":"","sources":["../../../src/lib/test/SetTimeStepper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAM,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,QAAQ;IACnD,KAAK;;;6CAG8B,SAAS;;MAsB1C;CACF"}

package/build/lib/test/SetTimeStepper.js

@@ -1,6 +1,6 @@
-import { vi } from 'vitest';
-import { OK } from '../../schema/protocol.js';
-import { AStepper } from '../astepper.js';
+import { vi } from "vitest";
+import { OK } from "../../schema/protocol.js";
+import { AStepper } from "../astepper.js";
 const checkedInt = (p, v) => {
     if (v === undefined)
         throw Error(`undefined value "${v}" for ${p}`);
@@ -9,17 +9,17 @@ const checkedInt = (p, v) => {
 export default class SetTimeStepper extends AStepper {
     steps = {
         setTime: {
-            gwta: 'change date to {y}-{m}-{d} {h}:{min}:{s}',
+            gwta: "change date to {y}-{m}-{d} {h}:{min}:{s}",
             action: ({ y, m, d, h, min, s }) => {
                 for (const v of [y, m, d, h, min, s]) {
                     if (Array.isArray(v))
-                        throw new Error('date parts must be strings');
+                        throw new Error("date parts must be strings");
                 }
                 const ys = y, ms = m, ds = d, hs = h, mins = min, ss = s;
-                const date = new Date(checkedInt('year', ys), checkedInt('month', ms) - 1, checkedInt('day', ds), checkedInt('hour', hs), checkedInt('minute', mins), checkedInt('second', ss));
+                const date = new Date(checkedInt("year", ys), checkedInt("month", ms) - 1, checkedInt("day", ds), checkedInt("hour", hs), checkedInt("minute", mins), checkedInt("second", ss));
                 vi.setSystemTime(date);
                 return Promise.resolve(OK);
-            }
+            },
         },
     };
 }

package/build/lib/test/SetTimeStepper.js.map

@@ -1 +1 @@
-{"version":3,"file":"SetTimeStepper.js","sourceRoot":"","sources":["../../../src/lib/test/SetTimeStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAa,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE;IAC1C,IAAI,CAAC,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC,CAAA;AACD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,QAAQ;IAClD,KAAK,GAAG;QACN,OAAO,EAAE;YACP,IAAI,EAAE,0CAA0C;YAChD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAa,EAAE,EAAE;gBAC5C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;oBAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;gBAAC,CAAC;gBAC9G,MAAM,EAAE,GAAG,CAAW,EAAE,EAAE,GAAG,CAAW,EAAE,EAAE,GAAG,CAAW,EAAE,EAAE,GAAG,CAAW,EAAE,IAAI,GAAG,GAAa,EAAE,EAAE,GAAG,CAAW,CAAC;gBACrH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;gBAChL,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACvB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;SACF;KACF,CAAC;CACH"}
+{"version":3,"file":"SetTimeStepper.js","sourceRoot":"","sources":["../../../src/lib/test/SetTimeStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAa,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE;IAC3C,IAAI,CAAC,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxB,CAAC,CAAC;AACF,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,QAAQ;IACnD,KAAK,GAAG;QACP,OAAO,EAAE;YACR,IAAI,EAAE,0CAA0C;YAChD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAa,EAAE,EAAE;gBAC7C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;oBACtC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;gBACrE,CAAC;gBACD,MAAM,EAAE,GAAG,CAAW,EACrB,EAAE,GAAG,CAAW,EAChB,EAAE,GAAG,CAAW,EAChB,EAAE,GAAG,CAAW,EAChB,IAAI,GAAG,GAAa,EACpB,EAAE,GAAG,CAAW,CAAC;gBAClB,MAAM,IAAI,GAAG,IAAI,IAAI,CACpB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EACtB,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,EAC3B,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,EACrB,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EACtB,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,EAC1B,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CACxB,CAAC;gBACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACvB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;SACD;KACD,CAAC;CACF"}

package/build/lib/test/TestSteps.d.ts

@@ -1,18 +1,18 @@
-import { AStepper } from '../astepper.js';
+import { AStepper } from "../astepper.js";
 declare const TestSteps: {
     new (): {
         steps: {
             fails: {
                 gwta: string;
-                action: () => Promise<import("../../schema/protocol.js").TNotOKActionResult>;
+                action: () => Promise<import("../../schema/protocol.js").TActionResult>;
             };
             test: {
                 exact: string;
-                action: () => Promise<import("../../schema/protocol.js").TOKActionResult>;
+                action: () => Promise<import("../../schema/protocol.js").TActionResult>;
             };
             passes: {
                 exact: string;
-                action: () => Promise<import("../../schema/protocol.js").TOKActionResult>;
+                action: () => Promise<import("../../schema/protocol.js").TActionResult>;
             };
             throws: {
                 gwta: string;
@@ -20,10 +20,10 @@ declare const TestSteps: {
             };
         };
         description?: string;
-        world?: import("../defs.js").TWorld;
+        world?: import("../execution.js").TWorld;
         kind?: import("../astepper.js").TStepperKind;
-        setWorld(world: import("../defs.js").TWorld, _steppers: AStepper[]): Promise<void>;
-        getWorld(): import("../defs.js").TWorld;
+        setWorld(world: import("../execution.js").TWorld, _steppers: AStepper[]): Promise<void>;
+        getWorld(): import("../execution.js").TWorld;
         startFeatureResolution?(_path: string): void;
     };
 };

package/build/lib/test/TestSteps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestSteps.d.ts","sourceRoot":"","sources":["../../../src/lib/test/TestSteps.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqBd,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"TestSteps.d.ts","sourceRoot":"","sources":["../../../src/lib/test/TestSteps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqBd,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/build/lib/test/TestSteps.js

@@ -1,21 +1,21 @@
-import { AStepper } from '../astepper.js';
-import { actionNotOK, actionOK } from '../util/index.js';
+import { AStepper } from "../astepper.js";
+import { actionNotOK, actionOK } from "../util/index.js";
 const TestSteps = class TestSteps extends AStepper {
     steps = {
         fails: {
-            gwta: 'fails',
-            action: async () => Promise.resolve(actionNotOK('test fail')),
+            gwta: "fails",
+            action: async () => Promise.resolve(actionNotOK("test fail")),
         },
         test: {
-            exact: 'have a test',
+            exact: "have a test",
             action: async () => Promise.resolve(actionOK()),
         },
         passes: {
-            exact: 'passes',
+            exact: "passes",
             action: async () => Promise.resolve(actionOK()),
         },
         throws: {
-            gwta: 'throw an exception',
+            gwta: "throw an exception",
             action: () => {
                 throw Error(`<Thrown for test case>`);
             },

package/build/lib/test/TestSteps.js.map

@@ -1 +1 @@
-{"version":3,"file":"TestSteps.js","sourceRoot":"","sources":["../../../src/lib/test/TestSteps.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,SAAS,GAAG,MAAM,SAAU,SAAQ,QAAQ;IACjD,KAAK,GAAG;QACP,KAAK,EAAE;YACN,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;SAC7D;QACD,IAAI,EAAE;YACL,KAAK,EAAE,aAAa;YACpB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;SAC/C;QACD,MAAM,EAAE;YACP,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;SAC/C;QACD,MAAM,EAAE;YACP,IAAI,EAAE,oBAAoB;YAC1B,MAAM,EAAE,GAAG,EAAE;gBACZ,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACvC,CAAC;SACD;KACD,CAAC;CACF,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"TestSteps.js","sourceRoot":"","sources":["../../../src/lib/test/TestSteps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,SAAS,GAAG,MAAM,SAAU,SAAQ,QAAQ;IACjD,KAAK,GAAG;QACP,KAAK,EAAE;YACN,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;SAC7D;QACD,IAAI,EAAE;YACL,KAAK,EAAE,aAAa;YACpB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;SAC/C;QACD,MAAM,EAAE;YACP,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;SAC/C;QACD,MAAM,EAAE;YACP,IAAI,EAAE,oBAAoB;YAC1B,MAAM,EAAE,GAAG,EAAE;gBACZ,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACvC,CAAC;SACD;KACD,CAAC;CACF,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/build/lib/test/TestStepsWithOptions.d.ts

@@ -1,5 +1,5 @@
-import { AStepper } from '../astepper.js';
-import { z } from 'zod';
+import { AStepper } from "../astepper.js";
+import { z } from "zod";
 export declare const TestStepsWithOptions: {
     new (): {
         options: {
@@ -16,14 +16,14 @@ export declare const TestStepsWithOptions: {
                 outputSchema: z.ZodObject<{
                     summary: z.ZodString;
                 }, z.core.$strip>;
-                action: () => Promise<import("../../schema/protocol.js").TActionOKWithProducts>;
+                action: () => Promise<import("../../schema/protocol.js").TActionResult>;
             };
         };
         description?: string;
-        world?: import("../defs.js").TWorld;
+        world?: import("../execution.js").TWorld;
         kind?: import("../astepper.js").TStepperKind;
-        setWorld(world: import("../defs.js").TWorld, _steppers: AStepper[]): Promise<void>;
-        getWorld(): import("../defs.js").TWorld;
+        setWorld(world: import("../execution.js").TWorld, _steppers: AStepper[]): Promise<void>;
+        getWorld(): import("../execution.js").TWorld;
         startFeatureResolution?(_path: string): void;
     };
 };

package/build/lib/test/TestStepsWithOptions.js

@@ -1,20 +1,20 @@
-import { AStepper } from '../astepper.js';
-import { actionOKWithProducts, getStepperOption } from '../util/index.js';
-import { z } from 'zod';
+import { AStepper } from "../astepper.js";
+import { actionOKWithProducts, getStepperOption } from "../util/index.js";
+import { z } from "zod";
 export const TestStepsWithOptions = class TestStepsWithOptions extends AStepper {
     options = {
         EXISTS: {
-            desc: 'option exists',
+            desc: "option exists",
             parse: () => ({ result: 42 }),
         },
     };
     steps = {
         test: {
-            exact: 'have a stepper option',
+            exact: "have a stepper option",
             outputSchema: z.object({ summary: z.string() }),
             action: () => {
-                const _res = getStepperOption(this, 'EXISTS', this.getWorld().moduleOptions);
-                return Promise.resolve(actionOKWithProducts({ summary: 'options' }));
+                const _res = getStepperOption(this, "EXISTS", this.getWorld().moduleOptions);
+                return Promise.resolve(actionOKWithProducts({ summary: "options" }));
             },
         },
     };