@cat-factory/orchestration 0.35.1 → 0.36.1

package/dist/modules/execution/step-handler-registry.d.ts

@@ -0,0 +1,40 @@
+import type { Block, ExecutionInstance, PipelineStep } from '@cat-factory/kernel';
+import type { AdvanceResult, AdvanceOptions } from './advance.js';
+/** Everything a {@link StepHandler} needs about the step it may handle. */
+export interface StepHandlerContext {
+    workspaceId: string;
+    instance: ExecutionInstance;
+    step: PipelineStep;
+    /** The run's block, already loaded by the preamble. */
+    block: Block;
+    /** Whether this step is the pipeline's last (drives terminal finalization). */
+    isFinalStep: boolean;
+    /** The advance options threaded from the durable driver (e.g. `rethrowAgentErrors`). */
+    options: AdvanceOptions;
+}
+/**
+ * One step-kind's slice of the old `stepInstance` per-kind body. The engine builds the
+ * ordered list once, caches it, and dispatches each step to the first handler that
+ * `canHandle`s it.
+ */
+export interface StepHandler {
+    /** Documentary id for the handled kind(s); dispatch is by `canHandle`, not this. */
+    readonly kind: string;
+    /**
+     * Dispatch order — the lower it runs first, so a specific handler can shadow the
+     * generic fallthrough. Replaces the load-bearing-but-implicit ordering of the old
+     * `if`/early-return chain with an explicit, declared number.
+     */
+    readonly order: number;
+    /** Whether this handler owns the given step (keyed on `step.agentKind` / gate lookup). */
+    canHandle(ctx: StepHandlerContext): boolean;
+    /** Run the step's per-kind work, returning the same outcome `stepInstance` always has. */
+    handle(ctx: StepHandlerContext): Promise<AdvanceResult>;
+}
+/**
+ * The order of the generic container/inline-agent fallthrough handler — the LAST resort,
+ * matching every step that no more-specific handler claimed (today's body tail). Kept far
+ * above any specific handler's order so specific handlers always shadow it.
+ */
+export declare const FALLTHROUGH_STEP_HANDLER_ORDER: number;
+//# sourceMappingURL=step-handler-registry.d.ts.map

package/dist/modules/execution/step-handler-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-handler-registry.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/step-handler-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAsBjE,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,IAAI,EAAE,YAAY,CAAA;IAClB,uDAAuD;IACvD,KAAK,EAAE,KAAK,CAAA;IACZ,+EAA+E;IAC/E,WAAW,EAAE,OAAO,CAAA;IACpB,wFAAwF;IACxF,OAAO,EAAE,cAAc,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,0FAA0F;IAC1F,SAAS,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAA;IAC3C,0FAA0F;IAC1F,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CACxD;AAED;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,QAA0B,CAAA"}

package/dist/modules/execution/step-handler-registry.js

@@ -0,0 +1,7 @@
+/**
+ * The order of the generic container/inline-agent fallthrough handler — the LAST resort,
+ * matching every step that no more-specific handler claimed (today's body tail). Kept far
+ * above any specific handler's order so specific handlers always shadow it.
+ */
+export const FALLTHROUGH_STEP_HANDLER_ORDER = Number.MAX_SAFE_INTEGER;
+//# sourceMappingURL=step-handler-registry.js.map

package/dist/modules/execution/step-handler-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-handler-registry.js","sourceRoot":"","sources":["../../../src/modules/execution/step-handler-registry.ts"],"names":[],"mappings":"AAwDA;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,gBAAgB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.35.1",
+  "version": "0.36.1",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -25,19 +25,19 @@
   },
   "dependencies": {
     "ai": "^6.0.209",
-    "@cat-factory/agents": "0.21.0",
-    "@cat-factory/contracts": "0.42.0",
-    "@cat-factory/integrations": "0.25.2",
-    "@cat-factory/kernel": "0.44.0",
-    "@cat-factory/prompt-fragments": "0.7.41",
-    "@cat-factory/sandbox": "0.8.23",
-    "@cat-factory/spend": "0.10.15",
-    "@cat-factory/workspaces": "0.9.6"
+    "@cat-factory/agents": "0.21.2",
+    "@cat-factory/integrations": "0.26.1",
+    "@cat-factory/contracts": "0.43.0",
+    "@cat-factory/sandbox": "0.8.25",
+    "@cat-factory/kernel": "0.45.1",
+    "@cat-factory/prompt-fragments": "0.8.0",
+    "@cat-factory/workspaces": "0.9.8",
+    "@cat-factory/spend": "0.10.17"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc",
     "vitest": "^4.1.9",
-    "@cat-factory/sandbox-fixtures": "0.7.42"
+    "@cat-factory/sandbox-fixtures": "0.7.43"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",