@exaudeus/workrail 0.11.0 → 0.12.0

package/dist/mcp/handlers/v2-workflow.js

@@ -35,7 +35,7 @@ async function handleV2ListWorkflows(_input, ctx) {
                     kind: 'workflow',
                 };
             }
-            const snapshot = (0, v1_to_v2_shim_js_1.compileV1WorkflowToV2CompiledSnapshotV1)(wf);
+            const snapshot = (0, v1_to_v2_shim_js_1.compileV1WorkflowToV2PreviewSnapshot)(wf);
             const hashRes = (0, hashing_js_1.workflowHashForCompiledSnapshot)(snapshot, crypto);
             if (hashRes.isErr()) {
                 return {
@@ -68,29 +68,29 @@ async function handleV2ListWorkflows(_input, ctx) {
     }
     catch (err) {
         const mapped = (0, error_mapper_js_1.mapUnknownErrorToToolError)(err);
-        return (0, types_js_1.error)(mapped.code, mapped.message, mapped.suggestion);
+        return mapped;
     }
 }
 async function handleV2InspectWorkflow(input, ctx) {
     try {
         const workflow = await withTimeout(ctx.workflowService.getWorkflowById(input.workflowId), TIMEOUT_MS, 'inspect_workflow');
         if (!workflow) {
-            return (0, types_js_1.error)('NOT_FOUND', `Workflow not found: ${input.workflowId}`);
+            return (0, types_js_1.errNotRetryable)('NOT_FOUND', `Workflow not found: ${input.workflowId}`);
         }
         const crypto = new index_js_1.NodeCryptoV2();
         const dataDir = new index_js_2.LocalDataDirV2(process.env);
         const pinnedStore = new index_js_3.LocalPinnedWorkflowStoreV2(dataDir);
-        const snapshot = (0, v1_to_v2_shim_js_1.compileV1WorkflowToV2CompiledSnapshotV1)(workflow);
+        const snapshot = (0, v1_to_v2_shim_js_1.compileV1WorkflowToV2PreviewSnapshot)(workflow);
         const hashRes = (0, hashing_js_1.workflowHashForCompiledSnapshot)(snapshot, crypto);
         if (hashRes.isErr()) {
-            return (0, types_js_1.error)('INTERNAL_ERROR', hashRes.error.message);
+            return (0, types_js_1.errNotRetryable)('INTERNAL_ERROR', hashRes.error.message);
         }
         const workflowHash = hashRes.value;
         const existing = await pinnedStore.get(workflowHash).match((v) => v, () => null);
         if (!existing) {
             const wrote = await pinnedStore.put(workflowHash, snapshot).match(() => ({ ok: true }), (e) => ({ ok: false, error: e }));
             if (!wrote.ok) {
-                return (0, types_js_1.error)('INTERNAL_ERROR', wrote.error.message);
+                return (0, types_js_1.errNotRetryable)('INTERNAL_ERROR', wrote.error.message);
             }
         }
         const compiled = (await pinnedStore.get(workflowHash).match((v) => v, () => null)) ?? snapshot;
@@ -107,6 +107,6 @@ async function handleV2InspectWorkflow(input, ctx) {
     }
     catch (err) {
         const mapped = (0, error_mapper_js_1.mapUnknownErrorToToolError)(err);
-        return (0, types_js_1.error)(mapped.code, mapped.message, mapped.suggestion);
+        return mapped;
     }
 }

package/dist/mcp/handlers/workflow.js

@@ -58,7 +58,7 @@ async function handleWorkflowList(_input, ctx) {
     }
     catch (err) {
         const mapped = (0, error_mapper_js_1.mapUnknownErrorToToolError)(err);
-        return (0, types_js_1.error)(mapped.code, mapped.message, mapped.suggestion);
+        return mapped;
     }
 }
 async function handleWorkflowGet(input, ctx) {
@@ -68,18 +68,22 @@ async function handleWorkflowGet(input, ctx) {
         const result = await withTimeout(getWorkflowUseCase(input.id, input.mode), TIMEOUT_MS, 'workflow_get');
         if (result.isErr()) {
             const mapped = (0, error_mapper_js_1.mapDomainErrorToToolError)(result.error);
-            return (0, types_js_1.error)(mapped.code, mapped.message, mapped.suggestion);
+            return mapped;
         }
         const payload = output_schemas_js_1.WorkflowGetOutputSchema.parse({ workflow: result.value });
         return (0, types_js_1.success)(payload);
     }
     catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        if (message.includes('timed out')) {
-            return (0, types_js_1.error)('TIMEOUT', message);
+        if (err instanceof Error && err.name === 'TimeoutError') {
+            return {
+                type: 'error',
+                code: 'TIMEOUT',
+                message: err.message,
+                retry: { kind: 'retryable_immediate' },
+            };
         }
         const mapped = (0, error_mapper_js_1.mapUnknownErrorToToolError)(err);
-        return (0, types_js_1.error)(mapped.code, mapped.message, mapped.suggestion);
+        return mapped;
     }
 }
 async function handleWorkflowNext(input, ctx) {
@@ -94,7 +98,7 @@ async function handleWorkflowNext(input, ctx) {
             `returned=${result.isOk() ? 'ok' : 'err'}`);
         if (result.isErr()) {
             const mapped = (0, error_mapper_js_1.mapDomainErrorToToolError)(result.error);
-            return (0, types_js_1.error)(mapped.code, mapped.message, mapped.suggestion);
+            return mapped;
         }
         const payload = output_schemas_js_1.WorkflowNextOutputSchema.parse(result.value);
         return (0, types_js_1.success)(payload);
@@ -103,11 +107,16 @@ async function handleWorkflowNext(input, ctx) {
         const elapsed = Date.now() - startTime;
         const message = err instanceof Error ? err.message : String(err);
         console.error(`[workflow_next] Failed after ${elapsed}ms: ${message}`);
-        if (message.includes('timed out')) {
-            return (0, types_js_1.error)('TIMEOUT', message);
+        if (err instanceof Error && err.name === 'TimeoutError') {
+            return {
+                type: 'error',
+                code: 'TIMEOUT',
+                message: err.message,
+                retry: { kind: 'retryable_immediate' },
+            };
         }
         const mapped = (0, error_mapper_js_1.mapUnknownErrorToToolError)(err);
-        return (0, types_js_1.error)(mapped.code, mapped.message, mapped.suggestion);
+        return mapped;
     }
 }
 async function handleWorkflowValidateJson(input, ctx) {
@@ -121,7 +130,7 @@ async function handleWorkflowValidateJson(input, ctx) {
     }
     catch (err) {
         const mapped = (0, error_mapper_js_1.mapUnknownErrorToToolError)(err);
-        return (0, types_js_1.error)(mapped.code, mapped.message, mapped.suggestion);
+        return mapped;
     }
 }
 async function handleWorkflowGetSchema(_input, ctx) {
@@ -162,6 +171,6 @@ async function handleWorkflowGetSchema(_input, ctx) {
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        return (0, types_js_1.error)('INTERNAL_ERROR', message, 'Ensure the workflow schema file exists at spec/workflow.schema.json');
+        return (0, types_js_1.errNotRetryable)('INTERNAL_ERROR', message, { suggestion: 'Ensure the workflow schema file exists at spec/workflow.schema.json' });
     }
 }

package/dist/mcp/index.d.ts

@@ -1,5 +1,5 @@
 export type { ErrorCode, ToolSuccess, ToolError, ToolResult, ToolContext, ToolHandler, } from './types.js';
-export { success, error, } from './types.js';
+export { success, error, errNotRetryable, errRetryAfterMs, errRetryImmediate, } from './types.js';
 export type { ToolAnnotations, ToolDefinition, ToolConfig, ToolBuilder, } from './tool-factory.js';
 export { createToolFactory } from './tool-factory.js';
 export type { DescriptionMode, WorkflowToolName, ToolDescriptionMap, DescriptionsByMode, } from './types/tool-description-types.js';

package/dist/mcp/index.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zodToJsonSchema = exports.startServer = exports.createToolContext = exports.handleOpenDashboard = exports.handleReadSession = exports.handleUpdateSession = exports.handleCreateSession = exports.handleWorkflowGetSchema = exports.handleWorkflowValidateJson = exports.handleWorkflowNext = exports.handleWorkflowGet = exports.handleWorkflowList = exports.sessionTools = exports.openDashboardTool = exports.readSessionTool = exports.updateSessionTool = exports.createSessionTool = exports.OpenDashboardInput = exports.ReadSessionInput = exports.UpdateSessionInput = exports.CreateSessionInput = exports.WORKFLOW_TOOL_TITLES = exports.WORKFLOW_TOOL_ANNOTATIONS = exports.WorkflowGetSchemaInput = exports.WorkflowValidateJsonInput = exports.WorkflowNextInput = exports.WorkflowGetInput = exports.WorkflowListInput = exports.DESCRIPTIONS = exports.StaticToolDescriptionProvider = exports.ToolDescriptionProvider = exports.isWorkflowToolName = exports.isDescriptionMode = exports.WORKFLOW_TOOL_NAMES = exports.DESCRIPTION_MODES = exports.createToolFactory = exports.error = exports.success = void 0;
+exports.zodToJsonSchema = exports.startServer = exports.createToolContext = exports.handleOpenDashboard = exports.handleReadSession = exports.handleUpdateSession = exports.handleCreateSession = exports.handleWorkflowGetSchema = exports.handleWorkflowValidateJson = exports.handleWorkflowNext = exports.handleWorkflowGet = exports.handleWorkflowList = exports.sessionTools = exports.openDashboardTool = exports.readSessionTool = exports.updateSessionTool = exports.createSessionTool = exports.OpenDashboardInput = exports.ReadSessionInput = exports.UpdateSessionInput = exports.CreateSessionInput = exports.WORKFLOW_TOOL_TITLES = exports.WORKFLOW_TOOL_ANNOTATIONS = exports.WorkflowGetSchemaInput = exports.WorkflowValidateJsonInput = exports.WorkflowNextInput = exports.WorkflowGetInput = exports.WorkflowListInput = exports.DESCRIPTIONS = exports.StaticToolDescriptionProvider = exports.ToolDescriptionProvider = exports.isWorkflowToolName = exports.isDescriptionMode = exports.WORKFLOW_TOOL_NAMES = exports.DESCRIPTION_MODES = exports.createToolFactory = exports.errRetryImmediate = exports.errRetryAfterMs = exports.errNotRetryable = exports.error = exports.success = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "success", { enumerable: true, get: function () { return types_js_1.success; } });
 Object.defineProperty(exports, "error", { enumerable: true, get: function () { return types_js_1.error; } });
+Object.defineProperty(exports, "errNotRetryable", { enumerable: true, get: function () { return types_js_1.errNotRetryable; } });
+Object.defineProperty(exports, "errRetryAfterMs", { enumerable: true, get: function () { return types_js_1.errRetryAfterMs; } });
+Object.defineProperty(exports, "errRetryImmediate", { enumerable: true, get: function () { return types_js_1.errRetryImmediate; } });
 var tool_factory_js_1 = require("./tool-factory.js");
 Object.defineProperty(exports, "createToolFactory", { enumerable: true, get: function () { return tool_factory_js_1.createToolFactory; } });
 var tool_description_types_js_1 = require("./types/tool-description-types.js");

package/dist/mcp/output-schemas.d.ts

@@ -63,13 +63,13 @@ export declare const WorkflowNextOutputSchema: z.ZodObject<{
     next: z.ZodNullable<z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>>;
     isComplete: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
+    isComplete: boolean;
     state: import("../domain/execution/state.js").ExecutionState;
     next: JsonValue;
-    isComplete: boolean;
 }, {
+    isComplete: boolean;
     state: import("../domain/execution/state.js").ExecutionState;
     next: JsonValue;
-    isComplete: boolean;
 }>;
 export declare const WorkflowValidateJsonOutputSchema: z.ZodObject<{
     valid: z.ZodBoolean;
@@ -223,15 +223,422 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
     compiled: z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>;
 }, "strip", z.ZodTypeAny, {
     workflowId: string;
-    mode: "metadata" | "preview";
     workflowHash: string;
+    mode: "metadata" | "preview";
     compiled: JsonValue;
 }, {
     workflowId: string;
-    mode: "metadata" | "preview";
     workflowHash: string;
+    mode: "metadata" | "preview";
     compiled: JsonValue;
 }>;
+export declare const V2PendingStepSchema: z.ZodObject<{
+    stepId: z.ZodString;
+    title: z.ZodString;
+    prompt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    prompt: string;
+    stepId: string;
+}, {
+    title: string;
+    prompt: string;
+    stepId: string;
+}>;
+export declare const V2BlockerReportSchema: z.ZodObject<{
+    blockers: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<["USER_ONLY_DEPENDENCY", "MISSING_REQUIRED_OUTPUT", "INVALID_REQUIRED_OUTPUT", "REQUIRED_CAPABILITY_UNKNOWN", "REQUIRED_CAPABILITY_UNAVAILABLE", "INVARIANT_VIOLATION", "STORAGE_CORRUPTION_DETECTED"]>;
+        pointer: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"context_key">;
+            key: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            kind: "context_key";
+        }, {
+            key: string;
+            kind: "context_key";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"output_contract">;
+            contractRef: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "output_contract";
+            contractRef: string;
+        }, {
+            kind: "output_contract";
+            contractRef: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"capability">;
+            capability: z.ZodEnum<["delegation", "web_browsing"]>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "capability";
+            capability: "delegation" | "web_browsing";
+        }, {
+            kind: "capability";
+            capability: "delegation" | "web_browsing";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"workflow_step">;
+            stepId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "workflow_step";
+            stepId: string;
+        }, {
+            kind: "workflow_step";
+            stepId: string;
+        }>]>;
+        message: z.ZodString;
+        suggestedFix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+        pointer: {
+            key: string;
+            kind: "context_key";
+        } | {
+            kind: "output_contract";
+            contractRef: string;
+        } | {
+            kind: "capability";
+            capability: "delegation" | "web_browsing";
+        } | {
+            kind: "workflow_step";
+            stepId: string;
+        };
+        suggestedFix?: string | undefined;
+    }, {
+        message: string;
+        code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+        pointer: {
+            key: string;
+            kind: "context_key";
+        } | {
+            kind: "output_contract";
+            contractRef: string;
+        } | {
+            kind: "capability";
+            capability: "delegation" | "web_browsing";
+        } | {
+            kind: "workflow_step";
+            stepId: string;
+        };
+        suggestedFix?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    blockers: {
+        message: string;
+        code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+        pointer: {
+            key: string;
+            kind: "context_key";
+        } | {
+            kind: "output_contract";
+            contractRef: string;
+        } | {
+            kind: "capability";
+            capability: "delegation" | "web_browsing";
+        } | {
+            kind: "workflow_step";
+            stepId: string;
+        };
+        suggestedFix?: string | undefined;
+    }[];
+}, {
+    blockers: {
+        message: string;
+        code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+        pointer: {
+            key: string;
+            kind: "context_key";
+        } | {
+            kind: "output_contract";
+            contractRef: string;
+        } | {
+            kind: "capability";
+            capability: "delegation" | "web_browsing";
+        } | {
+            kind: "workflow_step";
+            stepId: string;
+        };
+        suggestedFix?: string | undefined;
+    }[];
+}>;
+export declare const V2ContinueWorkflowOutputSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"ok">;
+    stateToken: z.ZodString;
+    ackToken: z.ZodString;
+    checkpointToken: z.ZodString;
+    isComplete: z.ZodBoolean;
+    pending: z.ZodNullable<z.ZodObject<{
+        stepId: z.ZodString;
+        title: z.ZodString;
+        prompt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        prompt: string;
+        stepId: string;
+    }, {
+        title: string;
+        prompt: string;
+        stepId: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    kind: "ok";
+    pending: {
+        title: string;
+        prompt: string;
+        stepId: string;
+    } | null;
+    isComplete: boolean;
+    stateToken: string;
+    ackToken: string;
+    checkpointToken: string;
+}, {
+    kind: "ok";
+    pending: {
+        title: string;
+        prompt: string;
+        stepId: string;
+    } | null;
+    isComplete: boolean;
+    stateToken: string;
+    ackToken: string;
+    checkpointToken: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"blocked">;
+    stateToken: z.ZodString;
+    ackToken: z.ZodString;
+    checkpointToken: z.ZodString;
+    isComplete: z.ZodBoolean;
+    pending: z.ZodNullable<z.ZodObject<{
+        stepId: z.ZodString;
+        title: z.ZodString;
+        prompt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        prompt: string;
+        stepId: string;
+    }, {
+        title: string;
+        prompt: string;
+        stepId: string;
+    }>>;
+    blockers: z.ZodObject<{
+        blockers: z.ZodArray<z.ZodObject<{
+            code: z.ZodEnum<["USER_ONLY_DEPENDENCY", "MISSING_REQUIRED_OUTPUT", "INVALID_REQUIRED_OUTPUT", "REQUIRED_CAPABILITY_UNKNOWN", "REQUIRED_CAPABILITY_UNAVAILABLE", "INVARIANT_VIOLATION", "STORAGE_CORRUPTION_DETECTED"]>;
+            pointer: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"context_key">;
+                key: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                key: string;
+                kind: "context_key";
+            }, {
+                key: string;
+                kind: "context_key";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"output_contract">;
+                contractRef: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "output_contract";
+                contractRef: string;
+            }, {
+                kind: "output_contract";
+                contractRef: string;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"capability">;
+                capability: z.ZodEnum<["delegation", "web_browsing"]>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "capability";
+                capability: "delegation" | "web_browsing";
+            }, {
+                kind: "capability";
+                capability: "delegation" | "web_browsing";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"workflow_step">;
+                stepId: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "workflow_step";
+                stepId: string;
+            }, {
+                kind: "workflow_step";
+                stepId: string;
+            }>]>;
+            message: z.ZodString;
+            suggestedFix: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+            pointer: {
+                key: string;
+                kind: "context_key";
+            } | {
+                kind: "output_contract";
+                contractRef: string;
+            } | {
+                kind: "capability";
+                capability: "delegation" | "web_browsing";
+            } | {
+                kind: "workflow_step";
+                stepId: string;
+            };
+            suggestedFix?: string | undefined;
+        }, {
+            message: string;
+            code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+            pointer: {
+                key: string;
+                kind: "context_key";
+            } | {
+                kind: "output_contract";
+                contractRef: string;
+            } | {
+                kind: "capability";
+                capability: "delegation" | "web_browsing";
+            } | {
+                kind: "workflow_step";
+                stepId: string;
+            };
+            suggestedFix?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        blockers: {
+            message: string;
+            code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+            pointer: {
+                key: string;
+                kind: "context_key";
+            } | {
+                kind: "output_contract";
+                contractRef: string;
+            } | {
+                kind: "capability";
+                capability: "delegation" | "web_browsing";
+            } | {
+                kind: "workflow_step";
+                stepId: string;
+            };
+            suggestedFix?: string | undefined;
+        }[];
+    }, {
+        blockers: {
+            message: string;
+            code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+            pointer: {
+                key: string;
+                kind: "context_key";
+            } | {
+                kind: "output_contract";
+                contractRef: string;
+            } | {
+                kind: "capability";
+                capability: "delegation" | "web_browsing";
+            } | {
+                kind: "workflow_step";
+                stepId: string;
+            };
+            suggestedFix?: string | undefined;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "blocked";
+    pending: {
+        title: string;
+        prompt: string;
+        stepId: string;
+    } | null;
+    blockers: {
+        blockers: {
+            message: string;
+            code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+            pointer: {
+                key: string;
+                kind: "context_key";
+            } | {
+                kind: "output_contract";
+                contractRef: string;
+            } | {
+                kind: "capability";
+                capability: "delegation" | "web_browsing";
+            } | {
+                kind: "workflow_step";
+                stepId: string;
+            };
+            suggestedFix?: string | undefined;
+        }[];
+    };
+    isComplete: boolean;
+    stateToken: string;
+    ackToken: string;
+    checkpointToken: string;
+}, {
+    kind: "blocked";
+    pending: {
+        title: string;
+        prompt: string;
+        stepId: string;
+    } | null;
+    blockers: {
+        blockers: {
+            message: string;
+            code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
+            pointer: {
+                key: string;
+                kind: "context_key";
+            } | {
+                kind: "output_contract";
+                contractRef: string;
+            } | {
+                kind: "capability";
+                capability: "delegation" | "web_browsing";
+            } | {
+                kind: "workflow_step";
+                stepId: string;
+            };
+            suggestedFix?: string | undefined;
+        }[];
+    };
+    isComplete: boolean;
+    stateToken: string;
+    ackToken: string;
+    checkpointToken: string;
+}>]>;
+export declare const V2StartWorkflowOutputSchema: z.ZodObject<{
+    stateToken: z.ZodString;
+    ackToken: z.ZodString;
+    checkpointToken: z.ZodString;
+    isComplete: z.ZodBoolean;
+    pending: z.ZodNullable<z.ZodObject<{
+        stepId: z.ZodString;
+        title: z.ZodString;
+        prompt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        prompt: string;
+        stepId: string;
+    }, {
+        title: string;
+        prompt: string;
+        stepId: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    pending: {
+        title: string;
+        prompt: string;
+        stepId: string;
+    } | null;
+    isComplete: boolean;
+    stateToken: string;
+    ackToken: string;
+    checkpointToken: string;
+}, {
+    pending: {
+        title: string;
+        prompt: string;
+        stepId: string;
+    } | null;
+    isComplete: boolean;
+    stateToken: string;
+    ackToken: string;
+    checkpointToken: string;
+}>;
 export declare const CreateSessionOutputSchema: z.ZodObject<{
     sessionId: z.ZodString;
     workflowId: z.ZodString;

package/dist/mcp/output-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2WorkflowInspectOutputSchema = exports.V2WorkflowListOutputSchema = exports.V2WorkflowListItemSchema = exports.WorkflowGetSchemaOutputSchema = exports.WorkflowValidateJsonOutputSchema = exports.WorkflowNextOutputSchema = exports.WorkflowGetOutputSchema = exports.WorkflowListOutputSchema = exports.WorkflowSummarySchema = exports.JsonValueSchema = void 0;
+exports.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2StartWorkflowOutputSchema = exports.V2ContinueWorkflowOutputSchema = exports.V2BlockerReportSchema = exports.V2PendingStepSchema = exports.V2WorkflowInspectOutputSchema = exports.V2WorkflowListOutputSchema = exports.V2WorkflowListItemSchema = exports.WorkflowGetSchemaOutputSchema = exports.WorkflowValidateJsonOutputSchema = exports.WorkflowNextOutputSchema = exports.WorkflowGetOutputSchema = exports.WorkflowListOutputSchema = exports.WorkflowSummarySchema = exports.JsonValueSchema = void 0;
 const zod_1 = require("zod");
 const state_js_1 = require("../domain/execution/state.js");
 const JsonPrimitiveSchema = zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean(), zod_1.z.null()]);
@@ -62,6 +62,62 @@ exports.V2WorkflowInspectOutputSchema = zod_1.z.object({
     mode: zod_1.z.enum(['metadata', 'preview']),
     compiled: exports.JsonValueSchema,
 });
+exports.V2PendingStepSchema = zod_1.z.object({
+    stepId: zod_1.z.string().min(1),
+    title: zod_1.z.string().min(1),
+    prompt: zod_1.z.string().min(1),
+});
+const V2BlockerPointerSchema = zod_1.z.discriminatedUnion('kind', [
+    zod_1.z.object({ kind: zod_1.z.literal('context_key'), key: zod_1.z.string().min(1) }),
+    zod_1.z.object({ kind: zod_1.z.literal('output_contract'), contractRef: zod_1.z.string().min(1) }),
+    zod_1.z.object({ kind: zod_1.z.literal('capability'), capability: zod_1.z.enum(['delegation', 'web_browsing']) }),
+    zod_1.z.object({ kind: zod_1.z.literal('workflow_step'), stepId: zod_1.z.string().min(1) }),
+]);
+const V2BlockerSchema = zod_1.z.object({
+    code: zod_1.z.enum([
+        'USER_ONLY_DEPENDENCY',
+        'MISSING_REQUIRED_OUTPUT',
+        'INVALID_REQUIRED_OUTPUT',
+        'REQUIRED_CAPABILITY_UNKNOWN',
+        'REQUIRED_CAPABILITY_UNAVAILABLE',
+        'INVARIANT_VIOLATION',
+        'STORAGE_CORRUPTION_DETECTED',
+    ]),
+    pointer: V2BlockerPointerSchema,
+    message: zod_1.z.string().min(1).max(512),
+    suggestedFix: zod_1.z.string().min(1).max(1024).optional(),
+});
+exports.V2BlockerReportSchema = zod_1.z.object({
+    blockers: zod_1.z.array(V2BlockerSchema).min(1).max(10),
+});
+const V2ContinueWorkflowOkSchema = zod_1.z.object({
+    kind: zod_1.z.literal('ok'),
+    stateToken: zod_1.z.string().min(1),
+    ackToken: zod_1.z.string().min(1),
+    checkpointToken: zod_1.z.string().min(1),
+    isComplete: zod_1.z.boolean(),
+    pending: exports.V2PendingStepSchema.nullable(),
+});
+const V2ContinueWorkflowBlockedSchema = zod_1.z.object({
+    kind: zod_1.z.literal('blocked'),
+    stateToken: zod_1.z.string().min(1),
+    ackToken: zod_1.z.string().min(1),
+    checkpointToken: zod_1.z.string().min(1),
+    isComplete: zod_1.z.boolean(),
+    pending: exports.V2PendingStepSchema.nullable(),
+    blockers: exports.V2BlockerReportSchema,
+});
+exports.V2ContinueWorkflowOutputSchema = zod_1.z.discriminatedUnion('kind', [
+    V2ContinueWorkflowOkSchema,
+    V2ContinueWorkflowBlockedSchema,
+]);
+exports.V2StartWorkflowOutputSchema = zod_1.z.object({
+    stateToken: zod_1.z.string().min(1),
+    ackToken: zod_1.z.string().min(1),
+    checkpointToken: zod_1.z.string().min(1),
+    isComplete: zod_1.z.boolean(),
+    pending: exports.V2PendingStepSchema.nullable(),
+});
 exports.CreateSessionOutputSchema = zod_1.z.object({
     sessionId: zod_1.z.string().min(1),
     workflowId: zod_1.z.string().min(1),

package/dist/mcp/server.d.ts

@@ -1,3 +1,3 @@
 import type { ToolContext } from './types.js';
-export declare function createToolContext(): ToolContext;
+export declare function createToolContext(): Promise<ToolContext>;
 export declare function startServer(): Promise<void>;