@exaudeus/workrail 1.16.0 → 1.16.1

package/dist/mcp/handlers/v2-execution/replay.js

@@ -11,6 +11,7 @@ const workflow_hash_ref_js_1 = require("../../../v2/durable-core/ids/workflow-ha
 const neverthrow_1 = require("neverthrow");
 const validation_loader_js_1 = require("../../../v2/durable-core/domain/validation-loader.js");
 const v2_execution_helpers_js_1 = require("../v2-execution-helpers.js");
+const prompt_renderer_js_1 = require("../../../v2/durable-core/domain/prompt-renderer.js");
 const v2_token_ops_js_1 = require("../v2-token-ops.js");
 const v2_state_conversion_js_1 = require("../v2-state-conversion.js");
 const constants_js_1 = require("../../../v2/durable-core/constants.js");
@@ -19,8 +20,9 @@ function buildBlockedReplayResponse(args) {
     const { sessionId, runId, nodeId, attemptId, blockers, snapshot, truth, workflow, inputStateToken, inputAckToken, ports } = args;
     const pendingNow = snapshot ? (0, snapshot_state_js_1.derivePendingStep)(snapshot.enginePayload.engineState) : null;
     const isCompleteNow = snapshot ? (0, snapshot_state_js_1.deriveIsComplete)(snapshot.enginePayload.engineState) : false;
-    const meta = pendingNow
-        ? (0, v2_execution_helpers_js_1.renderPendingPromptOrDefault)({
+    let metaOrNull = null;
+    if (pendingNow) {
+        const result = (0, prompt_renderer_js_1.renderPendingPrompt)({
             workflow,
             stepId: String(pendingNow.stepId),
             loopPath: pendingNow.loopPath,
@@ -28,10 +30,14 @@ function buildBlockedReplayResponse(args) {
             runId: (0, index_js_2.asRunId)(String(runId)),
             nodeId: (0, index_js_2.asNodeId)(String(nodeId)),
             rehydrateOnly: false,
-        })
-        : null;
+        });
+        if (result.isErr()) {
+            return (0, neverthrow_1.errAsync)({ kind: 'prompt_render_failed', message: result.error.message });
+        }
+        metaOrNull = result.value;
+    }
     const preferences = (0, v2_execution_helpers_js_1.derivePreferencesOrDefault)({ truth, runId, nodeId });
-    const nextIntent = (0, v2_state_conversion_js_1.deriveNextIntent)({ rehydrateOnly: false, isComplete: isCompleteNow, pending: meta });
+    const nextIntent = (0, v2_state_conversion_js_1.deriveNextIntent)({ rehydrateOnly: false, isComplete: isCompleteNow, pending: metaOrNull });
     const replayCheckpointTokenRes = pendingNow
         ? (0, v2_token_ops_js_1.signTokenOrErr)({
             payload: { tokenVersion: 1, tokenKind: 'checkpoint', sessionId, runId, nodeId, attemptId },
@@ -44,10 +50,10 @@ function buildBlockedReplayResponse(args) {
         ackToken: inputAckToken,
         checkpointToken: replayCheckpointTokenRes.isOk() ? replayCheckpointTokenRes.value : undefined,
         isComplete: isCompleteNow,
-        pending: meta ? { stepId: meta.stepId, title: meta.title, prompt: meta.prompt } : null,
+        pending: metaOrNull ? { stepId: metaOrNull.stepId, title: metaOrNull.title, prompt: metaOrNull.prompt } : null,
         preferences,
         nextIntent,
-        nextCall: (0, index_js_3.buildNextCall)({ stateToken: inputStateToken, ackToken: inputAckToken, isComplete: isCompleteNow, pending: meta }),
+        nextCall: (0, index_js_3.buildNextCall)({ stateToken: inputStateToken, ackToken: inputAckToken, isComplete: isCompleteNow, pending: metaOrNull }),
         blockers,
         retryable: undefined,
         retryAckToken: undefined,
@@ -114,8 +120,9 @@ function buildAdvancedReplayResponse(args) {
             return (0, neverthrow_1.errAsync)({ kind: 'token_signing_failed', cause: retryAckTokenRes.error });
         }
         const validation = (0, validation_loader_js_1.loadValidationResultV1)(truth.events, String(blocked.validationRef)).unwrapOr(null) ?? undefined;
-        const meta = pending
-            ? (0, v2_execution_helpers_js_1.renderPendingPromptOrDefault)({
+        let blockedMeta = null;
+        if (pending) {
+            const result = (0, prompt_renderer_js_1.renderPendingPrompt)({
                 workflow,
                 stepId: String(pending.stepId),
                 loopPath: pending.loopPath,
@@ -123,28 +130,33 @@ function buildAdvancedReplayResponse(args) {
                 runId: (0, index_js_2.asRunId)(String(runId)),
                 nodeId: (0, index_js_2.asNodeId)(String(toNodeIdBranded)),
                 rehydrateOnly: false,
-            })
-            : null;
+            });
+            if (result.isErr()) {
+                return (0, neverthrow_1.errAsync)({ kind: 'prompt_render_failed', message: result.error.message });
+            }
+            blockedMeta = result.value;
+        }
         const preferences = (0, v2_execution_helpers_js_1.derivePreferencesOrDefault)({ truth, runId, nodeId: toNodeIdBranded });
-        const nextIntent = (0, v2_state_conversion_js_1.deriveNextIntent)({ rehydrateOnly: false, isComplete, pending: meta });
+        const nextIntent = (0, v2_state_conversion_js_1.deriveNextIntent)({ rehydrateOnly: false, isComplete, pending: blockedMeta });
         return (0, neverthrow_1.okAsync)(output_schemas_js_1.V2ContinueWorkflowOutputSchema.parse({
             kind: 'blocked',
             stateToken: nextStateTokenRes.value,
             ackToken: pending ? nextAckTokenRes.value : undefined,
             checkpointToken: pending ? nextCheckpointTokenRes.value : undefined,
             isComplete,
-            pending: meta ? { stepId: meta.stepId, title: meta.title, prompt: meta.prompt } : null,
+            pending: blockedMeta ? { stepId: blockedMeta.stepId, title: blockedMeta.title, prompt: blockedMeta.prompt } : null,
             preferences,
             nextIntent,
-            nextCall: (0, index_js_3.buildNextCall)({ stateToken: nextStateTokenRes.value, ackToken: pending ? nextAckTokenRes.value : undefined, isComplete, pending: meta, retryable, retryAckToken: retryAckTokenRes.value }),
+            nextCall: (0, index_js_3.buildNextCall)({ stateToken: nextStateTokenRes.value, ackToken: pending ? nextAckTokenRes.value : undefined, isComplete, pending: blockedMeta, retryable, retryAckToken: retryAckTokenRes.value }),
             blockers,
             retryable,
             retryAckToken: retryAckTokenRes.value,
             validation,
         }));
     }
-    const meta = pending
-        ? (0, v2_execution_helpers_js_1.renderPendingPromptOrDefault)({
+    let okMeta = null;
+    if (pending) {
+        const result = (0, prompt_renderer_js_1.renderPendingPrompt)({
             workflow,
             stepId: String(pending.stepId),
             loopPath: pending.loopPath,
@@ -152,20 +164,24 @@ function buildAdvancedReplayResponse(args) {
             runId: (0, index_js_2.asRunId)(String(runId)),
             nodeId: (0, index_js_2.asNodeId)(String(toNodeIdBranded)),
             rehydrateOnly: false,
-        })
-        : { stepId: '', title: '', prompt: '', requireConfirmation: false };
+        });
+        if (result.isErr()) {
+            return (0, neverthrow_1.errAsync)({ kind: 'prompt_render_failed', message: result.error.message });
+        }
+        okMeta = result.value;
+    }
     const preferences = (0, v2_execution_helpers_js_1.derivePreferencesOrDefault)({ truth, runId, nodeId: toNodeIdBranded });
-    const nextIntent = (0, v2_state_conversion_js_1.deriveNextIntent)({ rehydrateOnly: false, isComplete, pending: pending ? meta : null });
+    const nextIntent = (0, v2_state_conversion_js_1.deriveNextIntent)({ rehydrateOnly: false, isComplete, pending: okMeta });
     return (0, neverthrow_1.okAsync)(output_schemas_js_1.V2ContinueWorkflowOutputSchema.parse({
         kind: 'ok',
         stateToken: nextStateTokenRes.value,
         ackToken: pending ? nextAckTokenRes.value : undefined,
         checkpointToken: pending ? nextCheckpointTokenRes.value : undefined,
         isComplete,
-        pending: pending ? { stepId: meta.stepId, title: meta.title, prompt: meta.prompt } : null,
+        pending: okMeta ? { stepId: okMeta.stepId, title: okMeta.title, prompt: okMeta.prompt } : null,
         preferences,
         nextIntent,
-        nextCall: (0, index_js_3.buildNextCall)({ stateToken: nextStateTokenRes.value, ackToken: pending ? nextAckTokenRes.value : undefined, isComplete, pending: pending ? meta : null }),
+        nextCall: (0, index_js_3.buildNextCall)({ stateToken: nextStateTokenRes.value, ackToken: pending ? nextAckTokenRes.value : undefined, isComplete, pending: okMeta }),
     }));
 }
 function replayFromRecordedAdvance(args) {

package/dist/mcp/handlers/v2-execution/start.js

@@ -15,13 +15,14 @@ const hashing_js_1 = require("../../../v2/durable-core/canonical/hashing.js");
 const observation_builder_js_1 = require("../../../v2/durable-core/domain/observation-builder.js");
 const workflow_source_js_1 = require("../../../types/workflow-source.js");
 const workflow_definition_js_1 = require("../../../types/workflow-definition.js");
-const v2_execution_helpers_js_1 = require("../v2-execution-helpers.js");
+const prompt_renderer_js_1 = require("../../../v2/durable-core/domain/prompt-renderer.js");
 const v2_workspace_resolution_js_1 = require("../v2-workspace-resolution.js");
 const v2_token_ops_js_1 = require("../v2-token-ops.js");
 const v2_state_conversion_js_1 = require("../v2-state-conversion.js");
-const v2_execution_helpers_js_2 = require("../v2-execution-helpers.js");
+const v2_execution_helpers_js_1 = require("../v2-execution-helpers.js");
 const constants_js_1 = require("../../../v2/durable-core/constants.js");
 const index_js_2 = require("./index.js");
+const start_construction_js_1 = require("../../../v2/durable-core/domain/start-construction.js");
 function loadAndPinWorkflow(args) {
     const { workflowId, workflowService, crypto, pinnedStore } = args;
     return neverthrow_1.ResultAsync.fromPromise(workflowService.getWorkflowById(workflowId), (e) => ({
@@ -32,14 +33,20 @@ function loadAndPinWorkflow(args) {
         if (!workflow) {
             return (0, neverthrow_1.errAsync)({ kind: 'workflow_not_found', workflowId: (0, index_js_1.asWorkflowId)(workflowId) });
         }
-        const firstStep = workflow.definition.steps[0];
-        if (!firstStep) {
+        if (workflow.definition.steps.length === 0) {
             return (0, neverthrow_1.errAsync)({ kind: 'workflow_has_no_steps', workflowId: (0, index_js_1.asWorkflowId)(workflowId) });
         }
-        return (0, neverthrow_1.okAsync)({ workflow, firstStep });
+        return (0, neverthrow_1.okAsync)({ workflow });
     })
-        .andThen(({ workflow, firstStep }) => {
-        const compiled = (0, v1_to_v2_shim_js_1.compileV1WorkflowToPinnedSnapshot)(workflow);
+        .andThen(({ workflow }) => {
+        const normalizeResult = (0, v1_to_v2_shim_js_1.normalizeV1WorkflowToPinnedSnapshot)(workflow);
+        if (normalizeResult.isErr()) {
+            return (0, neverthrow_1.errAsync)({
+                kind: 'workflow_compile_failed',
+                message: normalizeResult.error.message,
+            });
+        }
+        const compiled = normalizeResult.value;
         const workflowHashRes = (0, hashing_js_1.workflowHashForCompiledSnapshot)(compiled, crypto);
         if (workflowHashRes.isErr()) {
             return (0, neverthrow_1.errAsync)({ kind: 'hash_computation_failed', message: workflowHashRes.error.message });
@@ -63,6 +70,14 @@ function loadAndPinWorkflow(args) {
                 });
             }
             const pinnedWorkflow = (0, workflow_js_1.createWorkflow)(pinned.definition, (0, workflow_source_js_1.createBundledSource)());
+            const resolution = (0, start_construction_js_1.resolveFirstStep)(workflow, pinned);
+            if (resolution.isErr()) {
+                const error = resolution.error.reason === 'no_steps'
+                    ? { kind: 'workflow_has_no_steps', workflowId: (0, index_js_1.asWorkflowId)(resolution.error.detail) }
+                    : { kind: 'invariant_violation', message: resolution.error.detail };
+                return (0, neverthrow_1.errAsync)(error);
+            }
+            const firstStep = resolution.value;
             return (0, neverthrow_1.okAsync)({ workflow, firstStep, workflowHash, pinnedWorkflow });
         });
     });
@@ -126,12 +141,12 @@ function buildInitialEvents(args) {
                 changeId,
                 source: 'system',
                 delta: [
-                    { key: 'autonomy', value: v2_execution_helpers_js_2.defaultPreferences.autonomy },
-                    { key: 'riskPolicy', value: v2_execution_helpers_js_2.defaultPreferences.riskPolicy },
+                    { key: 'autonomy', value: v2_execution_helpers_js_1.defaultPreferences.autonomy },
+                    { key: 'riskPolicy', value: v2_execution_helpers_js_1.defaultPreferences.riskPolicy },
                 ],
                 effective: {
-                    autonomy: v2_execution_helpers_js_2.defaultPreferences.autonomy,
-                    riskPolicy: v2_execution_helpers_js_2.defaultPreferences.riskPolicy,
+                    autonomy: v2_execution_helpers_js_1.defaultPreferences.autonomy,
+                    riskPolicy: v2_execution_helpers_js_1.defaultPreferences.riskPolicy,
                 },
             },
         },
@@ -278,7 +293,7 @@ function executeStartWorkflow(input, ctx) {
             workflowHashRef: wfRefRes.value,
             ports: tokenCodecPorts,
         }).andThen((tokens) => {
-            const meta = (0, v2_execution_helpers_js_1.renderPendingPromptOrDefault)({
+            const metaResult = (0, prompt_renderer_js_1.renderPendingPrompt)({
                 workflow: pinnedWorkflow,
                 stepId: firstStep.id,
                 loopPath: [],
@@ -287,8 +302,15 @@ function executeStartWorkflow(input, ctx) {
                 nodeId: (0, index_js_1.asNodeId)(String(nodeId)),
                 rehydrateOnly: false,
             });
+            if (metaResult.isErr()) {
+                return (0, neverthrow_1.errAsync)({
+                    kind: 'prompt_render_failed',
+                    message: metaResult.error.message,
+                });
+            }
+            const meta = metaResult.value;
             const pending = { stepId: meta.stepId, title: meta.title, prompt: meta.prompt };
-            const preferences = v2_execution_helpers_js_2.defaultPreferences;
+            const preferences = v2_execution_helpers_js_1.defaultPreferences;
             const nextIntent = (0, v2_state_conversion_js_1.deriveNextIntent)({ rehydrateOnly: false, isComplete: false, pending: meta });
             return (0, neverthrow_1.okAsync)(output_schemas_js_1.V2StartWorkflowOutputSchema.parse({
                 stateToken: tokens.stateToken,

package/dist/mcp/handlers/v2-execution-helpers.d.ts

@@ -25,6 +25,9 @@ export type StartWorkflowError = {
 } | {
     readonly kind: 'workflow_has_no_steps';
     readonly workflowId: WorkflowId;
+} | {
+    readonly kind: 'workflow_compile_failed';
+    readonly message: string;
 } | {
     readonly kind: 'keyring_load_failed';
     readonly cause: KeyringError;
@@ -43,6 +46,9 @@ export type StartWorkflowError = {
 } | {
     readonly kind: 'token_signing_failed';
     readonly cause: TokenDecodeErrorV2 | TokenVerifyErrorV2 | TokenSignErrorV2;
+} | {
+    readonly kind: 'prompt_render_failed';
+    readonly message: string;
 };
 export type ContinueWorkflowError = {
     readonly kind: 'precondition_failed';
@@ -86,6 +92,9 @@ export type ContinueWorkflowError = {
 } | {
     readonly kind: 'advance_execution_failed';
     readonly cause: ExecutionSessionGateErrorV2 | SessionEventLogStoreError;
+} | {
+    readonly kind: 'prompt_render_failed';
+    readonly message: string;
 };
 export declare function mapStartWorkflowErrorToToolError(e: StartWorkflowError): ToolFailure;
 export declare function mapContinueWorkflowErrorToToolError(e: ContinueWorkflowError): ToolFailure;
@@ -98,19 +107,8 @@ export declare function mapExecutionSessionGateErrorToToolError(e: ExecutionSess
 export declare function mapSnapshotStoreErrorToToolError(e: SnapshotStoreError, _suggestion?: string): ToolFailure;
 export declare function mapPinnedWorkflowStoreErrorToToolError(e: PinnedWorkflowStoreError, _suggestion?: string): ToolFailure;
 export declare function mapSessionOrGateErrorToToolError(e: SessionEventLogStoreError | ExecutionSessionGateErrorV2): ToolFailure;
-import type { LoopPathFrameV1 } from '../../v2/durable-core/schemas/execution-snapshot/index.js';
 import type { RunId, NodeId } from '../../v2/durable-core/ids/index.js';
 import type { LoadedSessionTruthV2 } from '../../v2/ports/session-event-log-store.port.js';
-import { type StepMetadata } from '../../v2/durable-core/domain/prompt-renderer.js';
-export declare function renderPendingPromptOrDefault(args: {
-    readonly workflow: ReturnType<typeof import('../../types/workflow.js').createWorkflow>;
-    readonly stepId: string;
-    readonly loopPath: readonly LoopPathFrameV1[];
-    readonly truth: LoadedSessionTruthV2;
-    readonly runId: RunId;
-    readonly nodeId: NodeId;
-    readonly rehydrateOnly: boolean;
-}): StepMetadata;
 export type PreferencesV2 = {
     readonly autonomy: 'guided' | 'full_auto_stop_on_user_deps' | 'full_auto_never_stop';
     readonly riskPolicy: 'conservative' | 'balanced' | 'aggressive';

package/dist/mcp/handlers/v2-execution-helpers.js

@@ -13,7 +13,6 @@ exports.mapExecutionSessionGateErrorToToolError = mapExecutionSessionGateErrorTo
 exports.mapSnapshotStoreErrorToToolError = mapSnapshotStoreErrorToToolError;
 exports.mapPinnedWorkflowStoreErrorToToolError = mapPinnedWorkflowStoreErrorToToolError;
 exports.mapSessionOrGateErrorToToolError = mapSessionOrGateErrorToToolError;
-exports.renderPendingPromptOrDefault = renderPendingPromptOrDefault;
 exports.derivePreferencesOrDefault = derivePreferencesOrDefault;
 const types_js_1 = require("../types.js");
 const types_js_2 = require("../types.js");
@@ -37,6 +36,8 @@ function mapStartWorkflowErrorToToolError(e) {
             return (0, types_js_1.errNotRetryable)('PRECONDITION_FAILED', `Workflow "${e.workflowId}" has no steps and cannot be started.`, {
                 suggestion: 'Tell the user: "This workflow definition is empty (no steps). The workflow JSON file needs to be fixed."',
             });
+        case 'workflow_compile_failed':
+            return (0, types_js_1.errNotRetryable)('PRECONDITION_FAILED', `Workflow definition is invalid and cannot be started: ${e.message}`, { suggestion: 'Tell the user: "The workflow definition has an authoring error that prevents execution. Fix the workflow JSON file and try again."' });
         case 'keyring_load_failed':
             return mapKeyringErrorToToolError(e.cause);
         case 'hash_computation_failed':
@@ -49,6 +50,8 @@ function mapStartWorkflowErrorToToolError(e) {
             return mapSessionOrGateErrorToToolError(e.cause);
         case 'token_signing_failed':
             return mapTokenSigningErrorToToolError(e.cause);
+        case 'prompt_render_failed':
+            return (0, types_js_1.errNotRetryable)('INTERNAL_ERROR', `WorkRail could not render the pending step prompt: ${e.message}`, { suggestion: internalSuggestion('Retry start_workflow.', 'A step referenced by the workflow was not found in the executable definition.') });
         default:
             const _exhaustive = e;
             return _exhaustive;
@@ -82,6 +85,8 @@ function mapContinueWorkflowErrorToToolError(e) {
             return mapTokenSigningErrorToToolError(e.cause);
         case 'advance_execution_failed':
             return mapSessionOrGateErrorToToolError(e.cause);
+        case 'prompt_render_failed':
+            return (0, types_js_1.errNotRetryable)('INTERNAL_ERROR', `WorkRail could not render the pending step prompt: ${e.message}`, { suggestion: internalSuggestion('Retry continue_workflow.', 'A step referenced by the workflow was not found in the executable definition.') });
         default:
             const _exhaustive = e;
             return _exhaustive;
@@ -257,23 +262,6 @@ function mapSessionOrGateErrorToToolError(e) {
     const _exhaustive = e;
     return _exhaustive;
 }
-const prompt_renderer_js_1 = require("../../v2/durable-core/domain/prompt-renderer.js");
-function renderPendingPromptOrDefault(args) {
-    return (0, prompt_renderer_js_1.renderPendingPrompt)({
-        workflow: args.workflow,
-        stepId: args.stepId,
-        loopPath: args.loopPath,
-        truth: args.truth,
-        runId: args.runId,
-        nodeId: args.nodeId,
-        rehydrateOnly: args.rehydrateOnly,
-    }).unwrapOr({
-        stepId: args.stepId,
-        title: args.stepId,
-        prompt: `Pending step: ${args.stepId}`,
-        requireConfirmation: false,
-    });
-}
 const constants_js_1 = require("../../v2/durable-core/constants.js");
 const preferences_js_1 = require("../../v2/projections/preferences.js");
 exports.defaultPreferences = {

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

@@ -238,12 +238,12 @@ export declare const V2PendingStepSchema: z.ZodObject<{
     prompt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     stepId: string;
-    prompt: string;
     title: string;
+    prompt: string;
 }, {
     stepId: string;
-    prompt: string;
     title: string;
+    prompt: string;
 }>;
 export declare const V2PreferencesSchema: z.ZodObject<{
     autonomy: z.ZodEnum<["guided", "full_auto_stop_on_user_deps", "full_auto_never_stop"]>;
@@ -485,12 +485,12 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
         prompt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     }, {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     }>>;
     preferences: z.ZodObject<{
         autonomy: z.ZodEnum<["guided", "full_auto_stop_on_user_deps", "full_auto_never_stop"]>;
@@ -552,8 +552,8 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     kind: "ok";
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -579,8 +579,8 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     kind: "ok";
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -614,12 +614,12 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
         prompt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     }, {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     }>>;
     preferences: z.ZodObject<{
         autonomy: z.ZodEnum<["guided", "full_auto_stop_on_user_deps", "full_auto_never_stop"]>;
@@ -887,8 +887,8 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     };
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -942,8 +942,8 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     };
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -975,8 +975,8 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     kind: "ok";
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -1024,8 +1024,8 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     };
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -1057,8 +1057,8 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     kind: "ok";
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -1106,8 +1106,8 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     };
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -1264,12 +1264,12 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
         prompt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     }, {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     }>>;
     preferences: z.ZodObject<{
         autonomy: z.ZodEnum<["guided", "full_auto_stop_on_user_deps", "full_auto_never_stop"]>;
@@ -1330,8 +1330,8 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -1356,8 +1356,8 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
 }, {
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -1382,8 +1382,8 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;
@@ -1408,8 +1408,8 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
 }, {
     pending: {
         stepId: string;
-        prompt: string;
         title: string;
+        prompt: string;
     } | null;
     isComplete: boolean;
     stateToken: string;

package/dist/types/storage.d.ts

@@ -12,6 +12,7 @@ export interface IWorkflowStorage extends IWorkflowReader {
 export interface ICompositeWorkflowStorage extends IWorkflowReader {
     readonly kind: 'composite';
     getSources(): readonly WorkflowSource[];
+    getStorageInstances(): readonly IWorkflowStorage[];
 }
 export type AnyWorkflowStorage = IWorkflowStorage | ICompositeWorkflowStorage;
 export declare function isSingleSourceStorage(storage: AnyWorkflowStorage): storage is IWorkflowStorage;

package/dist/v2/durable-core/domain/prompt-renderer.js

@@ -170,16 +170,22 @@ function loadRecoveryProjections(args) {
 }
 function renderPendingPrompt(args) {
     const step = (0, workflow_js_1.getStepById)(args.workflow, args.stepId);
-    const baseTitle = step?.title ?? args.stepId;
-    const basePrompt = step?.prompt ?? `Pending step: ${args.stepId}`;
-    const requireConfirmation = Boolean(step?.requireConfirmation);
-    const functionReferences = step?.functionReferences ?? [];
-    const outputContract = step && typeof step === 'object' && 'outputContract' in step
+    if (!step) {
+        return (0, neverthrow_1.err)({
+            code: 'RENDER_FAILED',
+            message: `Step '${args.stepId}' not found in workflow '${args.workflow.definition.id}'`,
+        });
+    }
+    const baseTitle = step.title;
+    const basePrompt = step.prompt;
+    const requireConfirmation = Boolean(step.requireConfirmation);
+    const functionReferences = step.functionReferences ?? [];
+    const outputContract = 'outputContract' in step
         ? step.outputContract
         : undefined;
     const isExitStep = outputContract?.contractRef === index_js_2.LOOP_CONTROL_CONTRACT_REF;
     const loopBanner = buildLoopContextBanner({ loopPath: args.loopPath, isExitStep });
-    const validationCriteria = step?.validationCriteria;
+    const validationCriteria = step.validationCriteria;
     const requirements = (0, validation_requirements_extractor_js_1.extractValidationRequirements)(validationCriteria);
     const requirementsSection = requirements.length > 0
         ? `\n\n**OUTPUT REQUIREMENTS:**\n${requirements.map(r => `- ${r}`).join('\n')}`
@@ -189,7 +195,7 @@ function renderPendingPrompt(args) {
         ? `\n\n**OUTPUT REQUIREMENTS (System):**\n${contractRequirements.map(r => `- ${r}`).join('\n')}`
         : '';
     const isNotesOptional = outputContract !== undefined ||
-        (step !== null && step !== undefined && 'notesOptional' in step && step.notesOptional === true);
+        ('notesOptional' in step && step.notesOptional === true);
     const notesSection = isNotesOptional
         ? ''
         : '\n\n**NOTES REQUIRED (System):** You must include `output.notesMarkdown` when advancing. ' +

package/dist/v2/durable-core/domain/start-construction.d.ts

@@ -0,0 +1,22 @@
+import type { Workflow } from '../../../types/workflow.js';
+import type { CompiledWorkflowSnapshotV1 } from '../schemas/compiled-workflow/index.js';
+import { type Result } from 'neverthrow';
+export type StartabilityFailure = {
+    readonly reason: 'no_steps';
+    readonly detail: 'Workflow has no steps in authored form';
+} | {
+    readonly reason: 'first_step_not_in_executable';
+    readonly authoredStepId: string;
+    readonly detail: string;
+} | {
+    readonly reason: 'no_reachable_step';
+    readonly detail: 'Interpreter returned isComplete=true with zero completed steps';
+} | {
+    readonly reason: 'interpreter_error';
+    readonly detail: string;
+};
+export declare function resolveFirstStep(authoredWorkflow: Workflow, pinnedSnapshot: Extract<CompiledWorkflowSnapshotV1, {
+    sourceKind: 'v1_pinned';
+}>): Result<{
+    readonly id: string;
+}, StartabilityFailure>;

package/dist/v2/durable-core/domain/start-construction.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFirstStep = resolveFirstStep;
+const neverthrow_1 = require("neverthrow");
+function resolveFirstStep(authoredWorkflow, pinnedSnapshot) {
+    const firstStep = authoredWorkflow.definition.steps[0];
+    if (!firstStep) {
+        return (0, neverthrow_1.err)({
+            reason: 'no_steps',
+            detail: 'Workflow has no steps in authored form',
+        });
+    }
+    const firstStepId = firstStep.id;
+    const definition = pinnedSnapshot.definition;
+    const steps = typeof definition === 'object' &&
+        definition !== null &&
+        !Array.isArray(definition) &&
+        'steps' in definition &&
+        Array.isArray(definition.steps)
+        ? definition.steps
+        : [];
+    const executableStep = steps.find((s) => typeof s === 'object' && s !== null && 'id' in s && s.id === firstStepId);
+    if (!executableStep) {
+        return (0, neverthrow_1.err)({
+            reason: 'first_step_not_in_executable',
+            authoredStepId: firstStepId,
+            detail: `Step '${firstStepId}' from authored workflow steps[0] not found in executable workflow`,
+        });
+    }
+    return (0, neverthrow_1.ok)({ id: firstStepId });
+}