@exaudeus/workrail 0.11.0 → 0.13.0

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

@@ -6,9 +6,6 @@ const types_js_1 = require("../types.js");
 const error_mapper_js_1 = require("../error-mapper.js");
 const output_schemas_js_1 = require("../output-schemas.js");
 const v1_to_v2_shim_js_1 = require("../../v2/read-only/v1-to-v2-shim.js");
-const index_js_1 = require("../../v2/infra/local/crypto/index.js");
-const index_js_2 = require("../../v2/infra/local/data-dir/index.js");
-const index_js_3 = require("../../v2/infra/local/pinned-workflow-store/index.js");
 const hashing_js_1 = require("../../v2/durable-core/canonical/hashing.js");
 const TIMEOUT_MS = 30000;
 async function withTimeout(operation, timeoutMs, name) {
@@ -17,12 +14,19 @@ async function withTimeout(operation, timeoutMs, name) {
     });
     return Promise.race([operation, timeoutPromise]);
 }
+function requireV2(ctx) {
+    if (!ctx.v2) {
+        return (0, types_js_1.errNotRetryable)('PRECONDITION_FAILED', 'v2 tools are not enabled');
+    }
+    return null;
+}
 async function handleV2ListWorkflows(_input, ctx) {
+    const v2Err = requireV2(ctx);
+    if (v2Err)
+        return v2Err;
+    const { crypto, pinnedStore } = ctx.v2;
     try {
         const summaries = await withTimeout(ctx.workflowService.listWorkflowSummaries(), TIMEOUT_MS, 'list_workflows');
-        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 compiled = await Promise.all(summaries.map(async (s) => {
             const wf = await ctx.workflowService.getWorkflowById(s.id);
             if (!wf) {
@@ -35,7 +39,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 +72,30 @@ 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) {
+    const v2Err = requireV2(ctx);
+    if (v2Err)
+        return v2Err;
+    const { crypto, pinnedStore } = ctx.v2;
     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 +112,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;