@exaudeus/workrail 1.13.0 → 1.13.2

package/dist/application/services/enhanced-loop-validator.d.ts

@@ -13,6 +13,7 @@ export declare class EnhancedLoopValidator {
     validateLoopStep(step: LoopStepDefinition): EnhancedValidationResult;
     private getLoopBodySteps;
     private validateConditionalLogic;
+    private getPromptText;
     private validatePromptLength;
     private validateTemplateVariables;
     private getKnownLoopVariables;

package/dist/application/services/enhanced-loop-validator.js

@@ -55,10 +55,40 @@ let EnhancedLoopValidator = class EnhancedLoopValidator {
             }
         }
     }
+    getPromptText(step) {
+        if (step.prompt)
+            return step.prompt;
+        if (!step.promptBlocks)
+            return undefined;
+        const parts = [];
+        const b = step.promptBlocks;
+        if (typeof b.goal === 'string')
+            parts.push(b.goal);
+        if (Array.isArray(b.constraints)) {
+            for (const c of b.constraints) {
+                if (typeof c === 'string')
+                    parts.push(c);
+            }
+        }
+        if (Array.isArray(b.procedure)) {
+            for (const p of b.procedure) {
+                if (typeof p === 'string')
+                    parts.push(p);
+            }
+        }
+        if (Array.isArray(b.verify)) {
+            for (const v of b.verify) {
+                if (typeof v === 'string')
+                    parts.push(v);
+            }
+        }
+        return parts.length > 0 ? parts.join('\n') : undefined;
+    }
     validatePromptLength(step, warnings, suggestions) {
-        if (!step.prompt)
+        const promptText = this.getPromptText(step);
+        if (!promptText)
             return;
-        const promptLength = step.prompt.length;
+        const promptLength = promptText.length;
         if (promptLength > this.PROMPT_ERROR_THRESHOLD) {
             warnings.push(`Step '${step.id}' has a very long prompt (${promptLength} characters). This may cause issues.`);
             suggestions.push(`Consider splitting this into multiple steps or moving content to the guidance section.`);
@@ -67,7 +97,7 @@ let EnhancedLoopValidator = class EnhancedLoopValidator {
             warnings.push(`Step '${step.id}' has a long prompt (${promptLength} characters).`);
             suggestions.push(`For better maintainability, consider breaking this into smaller, focused steps.`);
         }
-        const conditionalMatches = step.prompt.match(/\{\{[^}]*\?[^}]*\}\}/g);
+        const conditionalMatches = step.prompt?.match(/\{\{[^}]*\?[^}]*\}\}/g);
         if (conditionalMatches) {
             let totalConditionalContent = 0;
             for (const match of conditionalMatches) {
@@ -115,15 +145,16 @@ let EnhancedLoopValidator = class EnhancedLoopValidator {
         const bodySteps = this.getLoopBodySteps(step);
         if (step.loop.type === 'for' && bodySteps.length > 0) {
             const firstStep = bodySteps[0];
-            if (firstStep.prompt?.includes('analysis') ||
+            const firstPrompt = this.getPromptText(firstStep);
+            if (firstPrompt?.includes('analysis') ||
                 firstStep.title?.toLowerCase().includes('analysis') ||
-                firstStep.prompt?.includes('Step 1') ||
-                firstStep.prompt?.includes('Structure')) {
+                firstPrompt?.includes('Step 1') ||
+                firstPrompt?.includes('Structure')) {
                 info.push('Progressive analysis pattern detected.');
                 suggestions.push('Consider using the multi-step pattern with separate steps and runCondition for clearer structure.');
             }
         }
-        if (bodySteps.some(s => s.prompt?.includes('===') && s.prompt?.includes('?'))) {
+        if (bodySteps.some(s => { const p = this.getPromptText(s); return p?.includes('===') && p?.includes('?'); })) {
             info.push('Multi-conditional loop pattern detected.');
             suggestions.push('For loops with multiple conditional paths, the separate steps pattern is more maintainable than inline conditionals.');
         }

package/dist/application/services/validation-engine.js

@@ -413,9 +413,9 @@ let ValidationEngine = ValidationEngine_1 = class ValidationEngine {
                         issues.push(`Inline step '${inlineStep.id || 'unknown'}' must have a title`);
                         suggestions.push('Add a title to all inline steps');
                     }
-                    if (!inlineStep.prompt) {
-                        issues.push(`Inline step '${inlineStep.id || 'unknown'}' must have a prompt`);
-                        suggestions.push('Add a prompt to all inline steps');
+                    if (!(0, workflow_definition_1.stepHasPromptSource)(inlineStep)) {
+                        issues.push(`Inline step '${inlineStep.id || 'unknown'}' must have prompt, promptBlocks, or templateCall`);
+                        suggestions.push('Add a prompt string, structured promptBlocks, or a templateCall to all inline steps');
                     }
                     if ((0, workflow_definition_1.isLoopStepDefinition)(inlineStep)) {
                         issues.push(`Nested loops are not currently supported. Inline step '${inlineStep.id}' is a loop`);
@@ -486,8 +486,9 @@ let ValidationEngine = ValidationEngine_1 = class ValidationEngine {
                 if (!step.title) {
                     issues.push(`Step '${step.id}' missing required title`);
                 }
-                if (!step.prompt) {
-                    issues.push(`Step '${step.id}' missing required prompt`);
+                if (!(0, workflow_definition_1.stepHasPromptSource)(step)) {
+                    issues.push(`Step '${step.id}' must have prompt, promptBlocks, or templateCall`);
+                    suggestions.push('Add a prompt string, structured promptBlocks, or a templateCall to each step');
                 }
                 this.collectQuotedJsonValidationMessageWarnings(step, `Step '${step.id}'`, warnings);
                 const callValidation = this.validateStepFunctionCalls(step, workflow.definition.functionDefinitions || []);

package/dist/application/services/workflow-interpreter.js

@@ -322,13 +322,7 @@ let WorkflowInterpreter = class WorkflowInterpreter {
                 if (result.kind === 'found') {
                     return (0, neverthrow_1.ok)(result.decision === 'continue');
                 }
-                return (0, neverthrow_1.err)({
-                    code: 'LOOP_MISSING_CONTEXT',
-                    loopId: loopCompiled.loop.id,
-                    message: result.kind === 'not_found'
-                        ? `Loop '${source.loopId}' requires a wr.loop_control artifact but none was provided`
-                        : `Loop '${source.loopId}' has an invalid loop control artifact: ${result.reason}`,
-                });
+                return (0, neverthrow_1.ok)(true);
             }
             case 'context_variable': {
                 const raw = (0, condition_evaluator_1.evaluateCondition)(source.condition, this.projectLoopContextAtIteration(loopCompiled.loop, iteration, context));

package/dist/application/use-cases/validate-workflow-json.js

@@ -67,10 +67,10 @@ function generateSuggestions(errors) {
         suggestions.push('Use semantic versioning format (e.g., "0.0.1", "1.0.0").');
     }
     if (errorText.includes('steps')) {
-        suggestions.push('Ensure the workflow has at least one step with id, title, and prompt fields.');
+        suggestions.push('Ensure the workflow has at least one step with id, title, and either prompt or promptBlocks.');
     }
     if (errorText.includes('step')) {
-        suggestions.push('Check that all steps have required fields: id, title, and prompt.');
+        suggestions.push('Check that all steps have required fields: id, title, and either prompt or promptBlocks.');
     }
     if (errorText.includes('pattern')) {
         suggestions.push('Review the workflow schema documentation for correct field formats.');

package/dist/manifest.json

@@ -66,12 +66,12 @@
       "bytes": 6252
     },
     "application/services/enhanced-loop-validator.d.ts": {
-      "sha256": "042456f4080212c16acaee730bec5cf3342173f3307f405f85a9dbdaa410797f",
-      "bytes": 774
+      "sha256": "bef909cb861b88beda04b44110f8abb18181bb82be22bfbde5fe819a66654d52",
+      "bytes": 801
     },
     "application/services/enhanced-loop-validator.js": {
-      "sha256": "0af041281661c46cee1c63eebe36ee20d12b9fefc1f95e6baed9d959ae012b6a",
-      "bytes": 7980
+      "sha256": "148e75778723842874037c1d0c4fc3ab737787ddb9e3c78c5386cd49abfd065e",
+      "bytes": 9020
     },
     "application/services/output-normalizer.d.ts": {
       "sha256": "35bd9e50e984132f83dac874f90c2a4e9e8223202c6832426654232c5d7e2236",
@@ -94,8 +94,8 @@
       "bytes": 2030
     },
     "application/services/validation-engine.js": {
-      "sha256": "81592794bad1d77b0f8cdf6ed6486a17c6eebc3a4fe9e484693fbb6f8cdc5c96",
-      "bytes": 31038
+      "sha256": "a2ad656656b8d2554d0a08f6e230c190c72939d11cdba329b8de268d9ad52584",
+      "bytes": 31342
     },
     "application/services/workflow-compiler.d.ts": {
       "sha256": "41d0643ae2f07e5ce77a6e02344b5ca5b3c26bde828fbb307528a2ae097ac9d5",
@@ -110,8 +110,8 @@
       "bytes": 1507
     },
     "application/services/workflow-interpreter.js": {
-      "sha256": "0ea1861801d095d27e1e4c7c97978941b9d48613e28ce3a4c2efe64342814f5c",
-      "bytes": 21402
+      "sha256": "e6ea1bc6f3881bc46a901b78720dee584090f86809bfa1979f04efa4c8a35613",
+      "bytes": 21011
     },
     "application/services/workflow-service.d.ts": {
       "sha256": "b92da17c6d91c90758ec42b4ee3bc448e5d5b1dfe7351f2fe0f5e1d10a715ec6",
@@ -166,8 +166,8 @@
       "bytes": 345
     },
     "application/use-cases/validate-workflow-json.js": {
-      "sha256": "e5f0bfe7dfd8118a23f0690578159e8e591452a5635d77d5d0244685da07b9c2",
-      "bytes": 3651
+      "sha256": "87caff4501c5ee59ce73fc37762eeedc1e00253c7bf7f432349288e07810293f",
+      "bytes": 3690
     },
     "application/validation.d.ts": {
       "sha256": "2b44ccd1db66c81d8d5306e4b3453b50c27bb5c2c4bec85191b325c339d188cc",
@@ -646,8 +646,8 @@
       "bytes": 936
     },
     "mcp/handlers/v2-advance-core/outcome-success.js": {
-      "sha256": "e08268f3b8fd11213e67052721e231a6e055daa1dd4f729784f6ed3b20ddddb4",
-      "bytes": 5961
+      "sha256": "b0e2f52b8843b067b1ca1c3aa6e797d3b6ad7bf175c46b1f036e70fc2174f992",
+      "bytes": 6129
     },
     "mcp/handlers/v2-advance-events.d.ts": {
       "sha256": "02cdb52a2c16dd619645b5496caf0880e57937bf21ea9efe44e6cd195cd43b94",
@@ -674,12 +674,12 @@
       "bytes": 7199
     },
     "mcp/handlers/v2-error-mapping.d.ts": {
-      "sha256": "bbaf580dfc22ca6b5ef1d57036fb549c640d6f37bd7d525f1a805b4d14c4d75c",
-      "bytes": 1711
+      "sha256": "1cf58654dd6f70a0e35b75435c835a410658a2c7220d1b86561124476c8742fa",
+      "bytes": 1798
     },
     "mcp/handlers/v2-error-mapping.js": {
-      "sha256": "95dff130804524a007e1071784c20897ba6af1cc04fb2a636741e261fa22c3f8",
-      "bytes": 10388
+      "sha256": "f63c6711fdd05cf89d7da5f1441a17efa540b2f4985f85759c7f740a6cf2e854",
+      "bytes": 10664
     },
     "mcp/handlers/v2-execution-helpers.d.ts": {
       "sha256": "1e52f266e991a9447d1254bf047f6a09062b038ed3363a3818d1f5c91eed2fc8",
@@ -710,8 +710,8 @@
       "bytes": 1830
     },
     "mcp/handlers/v2-execution/continue-advance.js": {
-      "sha256": "bfbc14690fe08f51c5e1e2124e5561e9a093806e511803d68e4a2d22b5918919",
-      "bytes": 7927
+      "sha256": "864b892e6e69afbe300dbc748d0b6f3476d299b5cbaea36b5197748f9972611b",
+      "bytes": 8332
     },
     "mcp/handlers/v2-execution/continue-rehydrate.d.ts": {
       "sha256": "af7475b7effe57f18fa8379bfd128d17afb2d27fe1c058c6f2ee8f5b2632e3d0",
@@ -790,8 +790,8 @@
       "bytes": 1748
     },
     "mcp/handlers/workflow.js": {
-      "sha256": "a813ad7b201475a4362560b2ae2fbdc679ff416a92a4a5ab5dded4350e692daa",
-      "bytes": 8068
+      "sha256": "c95bbef83298b7d518e5e587147bdf83546bba77d3ef026c3598e8b0c6168004",
+      "bytes": 8233
     },
     "mcp/index.d.ts": {
       "sha256": "525b4247cf90ba3af66769462bcfaab5dbf38ee8c49d2a9ceec1e4b38e33511b",
@@ -1114,12 +1114,12 @@
       "bytes": 395
     },
     "types/workflow-definition.d.ts": {
-      "sha256": "13681513404db7396b07ded2c72fac53a9e42a76e5016c34f0fc77fc6591aa5a",
-      "bytes": 3951
+      "sha256": "19c5588e038d0d703def5ad59809bd9f7bbf4402999e56e664725cfeb9a0e18c",
+      "bytes": 4035
     },
     "types/workflow-definition.js": {
-      "sha256": "e269d62f27b7f37f870183d6b77800b7aa1e22dabc894374bab8f34db049a55b",
-      "bytes": 1584
+      "sha256": "293e18cc856c8b0f4d48858873c5832f7b9d2dc3896256bf19e59c92a222056d",
+      "bytes": 1749
     },
     "types/workflow-source.d.ts": {
       "sha256": "ee439c36ac3002780837ff393120d08a1c21ef2641421cdf72f0e1449d0211eb",
@@ -1542,8 +1542,8 @@
       "bytes": 2743
     },
     "v2/durable-core/schemas/artifacts/loop-control.js": {
-      "sha256": "9d8277a83fb4c6e2e07019feab437853c2eccd94b7e6958eda6500fb064d5f6e",
-      "bytes": 2099
+      "sha256": "1e0b70991023554e0ea3c858517aee7ffd050ab695a2f31768c4ec3d8de1cf92",
+      "bytes": 2152
     },
     "v2/durable-core/schemas/compiled-workflow/index.d.ts": {
       "sha256": "d909c13d0d46bba1dcd411a0c53e767cf7e4c8bc5206581344ca1e7315552d95",
@@ -1802,20 +1802,20 @@
       "bytes": 3036
     },
     "v2/infra/local/directory-listing/index.d.ts": {
-      "sha256": "dbf0a610bf4871eec89cc39f218ebb5267c695ccd8524613868abf5aa79d8d4a",
-      "bytes": 447
+      "sha256": "3139014cb738db3b0f10beca01a3a4a35b9ab8e72c8889b3bbff204fdbcb6b6c",
+      "bytes": 557
     },
     "v2/infra/local/directory-listing/index.js": {
-      "sha256": "1930cb982b9034f46751a000011ea069b6e03becd898973afad4b74e6ebc1759",
-      "bytes": 566
+      "sha256": "f3ed94836fa657dc34692378635efa12a5446e5f63c07637b3476a872e5064b1",
+      "bytes": 844
     },
     "v2/infra/local/fs/index.d.ts": {
-      "sha256": "fe3f06badea2d62e9ade3954f716d0b7aa4778c4d49e5fb9f6f58db6d2e9429a",
-      "bytes": 1323
+      "sha256": "dcfe3510dc6a8d92ededdb9c1376702dc88455ccb189eb7dc3ba2721b6b43d38",
+      "bytes": 1437
     },
     "v2/infra/local/fs/index.js": {
-      "sha256": "05fcd1345b3f003c19a13ee8db4ef657f23815c253e4fa36fa4bd7092f0a0b68",
-      "bytes": 7179
+      "sha256": "6d898cf90fd022530fb4ee4c03e0127955895d9da0f4ef52d85d8843803466df",
+      "bytes": 8262
     },
     "v2/infra/local/hmac-sha256/index.d.ts": {
       "sha256": "dda3865510dfaf2f13947410d998da6ffecc9a2e728b3574f81e69d5db859815",
@@ -1878,8 +1878,8 @@
       "bytes": 1004
     },
     "v2/infra/local/session-summary-provider/index.js": {
-      "sha256": "a38c877faddb8e14bf1c30e173e4299af5edb4a1f8fb4b036732c6ba6f11ca6f",
-      "bytes": 5933
+      "sha256": "1d8a543361c582f6e089f63f24318ff7caf97a78659ecdc5b89152b78d18c6aa",
+      "bytes": 5942
     },
     "v2/infra/local/sha256/index.d.ts": {
       "sha256": "8a727b7e54a38275ca6f9f1b8730f97cfc0a212df035df1bdc58e716e6824230",
@@ -1954,16 +1954,16 @@
       "bytes": 77
     },
     "v2/ports/directory-listing.port.d.ts": {
-      "sha256": "3184229b7793bbd3100611c6308d33a96145c4dc63ba451d8c29ff507084e7b4",
-      "bytes": 207
+      "sha256": "d707e849df351d2cf619942771b68dfeaa14095618ed3f3109e71da4d5f8d0fa",
+      "bytes": 394
     },
     "v2/ports/directory-listing.port.js": {
       "sha256": "d43aa81f5bc89faa359e0f97c814ba25155591ff078fbb9bfd40f8c7c9683230",
       "bytes": 77
     },
     "v2/ports/fs.port.d.ts": {
-      "sha256": "7b0d36b7a1abbf6f3f7279a122fe623bfa5d8b18f9a600c191d536c0e93204f7",
-      "bytes": 1991
+      "sha256": "49b481e09333784c5bbb95293a0cc1833ed5fe498aa3a52e86fad076fefe08d9",
+      "bytes": 2182
     },
     "v2/ports/fs.port.js": {
       "sha256": "d43aa81f5bc89faa359e0f97c814ba25155591ff078fbb9bfd40f8c7c9683230",
@@ -2178,12 +2178,12 @@
       "bytes": 2678
     },
     "v2/usecases/enumerate-sessions.d.ts": {
-      "sha256": "6043d64b45360dfc6a15b822d9f013a0832127596706bf81569dfce256236d2d",
-      "bytes": 499
+      "sha256": "46da8960bdeb154f79dee443425260f3ce18c50a0db01e7ab60700432d864857",
+      "bytes": 699
     },
     "v2/usecases/enumerate-sessions.js": {
-      "sha256": "99e135a7c7411ce850c9dd89963ef6a05d3488078d6c6b2c540cb2d2043a2e89",
-      "bytes": 526
+      "sha256": "4ae73f47c1e8ebea0d9a48dc786e5e4d0442a38827c427378712e9d198410ae2",
+      "bytes": 1050
     },
     "v2/usecases/execution-session-gate.d.ts": {
       "sha256": "339c4a8e02a77416e725e063a57d39a20788244498ae2c7a31dc48d111af6280",

package/dist/mcp/handlers/v2-advance-core/outcome-success.js

@@ -44,6 +44,9 @@ function buildSuccessOutcome(args) {
     });
     const nextRes = interpreter.next(compiledWf.value, advanced.value, v.mergedContext, artifactsForEval);
     if (nextRes.isErr()) {
+        if (nextRes.error._tag === 'MissingContext') {
+            return errAsync({ kind: 'advance_next_missing_context', message: nextRes.error.message });
+        }
         return errAsync({ kind: 'advance_next_failed', message: nextRes.error.message });
     }
     const out = nextRes.value;

package/dist/mcp/handlers/v2-error-mapping.d.ts

@@ -12,6 +12,9 @@ export type InternalError = {
 } | {
     readonly kind: 'advance_next_failed';
     readonly message: string;
+} | {
+    readonly kind: 'advance_next_missing_context';
+    readonly message: string;
 } | {
     readonly kind: 'missing_node_or_run';
 } | {

package/dist/mcp/handlers/v2-error-mapping.js

@@ -122,6 +122,8 @@ function mapInternalErrorToToolError(e) {
             return internalError('WorkRail could not record the workflow advancement. This is not caused by your input.', (0, v2_execution_helpers_js_1.internalSuggestion)('Retry the call.', 'WorkRail could not record the advancement.'));
         case 'advance_next_failed':
             return internalError('WorkRail could not compute the next workflow step. This is not caused by your input.', (0, v2_execution_helpers_js_1.internalSuggestion)('Retry the call.', 'WorkRail could not compute the next step.'));
+        case 'advance_next_missing_context':
+            return (0, types_js_1.errNotRetryable)('PRECONDITION_FAILED', e.message, { suggestion: 'Set the required context variable in the `context` field of your continue_workflow output. The variable must be a JSON array.' });
         default:
             const _exhaustive = e;
             return internalError('WorkRail encountered an unexpected error. This is not caused by your input.', (0, v2_execution_helpers_js_1.internalSuggestion)('Retry the call.', 'WorkRail has an internal error.'));

package/dist/mcp/handlers/v2-execution/continue-advance.js

@@ -120,6 +120,13 @@ function handleAdvanceIntent(args) {
         }))
             .mapErr((cause) => {
             if ((0, v2_error_mapping_js_1.isInternalError)(cause)) {
+                if (cause.kind === 'advance_next_missing_context') {
+                    return {
+                        kind: 'precondition_failed',
+                        message: cause.message,
+                        suggestion: 'Set the required context variable in the `context` field of your continue_workflow output. The variable must be a JSON array.',
+                    };
+                }
                 return {
                     kind: 'invariant_violation',
                     message: `Advance failed due to internal error: ${cause.kind}`,

package/dist/mcp/handlers/workflow.js

@@ -153,8 +153,9 @@ async function handleWorkflowGetSchema(_input, ctx) {
                 stepStructure: {
                     id: 'string (required): Unique step identifier',
                     title: 'string (required): Human-readable step title',
-                    prompt: 'string (required): Instructions for the step',
-                    agentRole: 'string (required): Role description for the agent',
+                    prompt: 'string (optional): Instructions for the step (use prompt OR promptBlocks)',
+                    promptBlocks: 'object (optional): Structured prompt blocks (goal, constraints, procedure, outputRequired, verify)',
+                    agentRole: 'string (optional): Role description for the agent',
                     validationCriteria: 'array (optional): Validation rules for step output',
                 },
             },

package/dist/types/workflow-definition.d.ts

@@ -88,5 +88,6 @@ export interface WorkflowDefinition {
 }
 export declare function isLoopStepDefinition(step: WorkflowStepDefinition | LoopStepDefinition): step is LoopStepDefinition;
 export declare function isWorkflowStepDefinition(step: WorkflowStepDefinition | LoopStepDefinition): step is WorkflowStepDefinition;
+export declare function stepHasPromptSource(step: WorkflowStepDefinition): boolean;
 export declare function hasWorkflowDefinitionShape(obj: unknown): obj is WorkflowDefinition;
 export declare function createWorkflowDefinition(definition: WorkflowDefinition): WorkflowDefinition;

package/dist/types/workflow-definition.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLoopStepDefinition = isLoopStepDefinition;
 exports.isWorkflowStepDefinition = isWorkflowStepDefinition;
+exports.stepHasPromptSource = stepHasPromptSource;
 exports.hasWorkflowDefinitionShape = hasWorkflowDefinitionShape;
 exports.createWorkflowDefinition = createWorkflowDefinition;
 function isLoopStepDefinition(step) {
@@ -10,6 +11,9 @@ function isLoopStepDefinition(step) {
 function isWorkflowStepDefinition(step) {
     return !isLoopStepDefinition(step);
 }
+function stepHasPromptSource(step) {
+    return Boolean(step.prompt || step.promptBlocks || step.templateCall);
+}
 function hasWorkflowDefinitionShape(obj) {
     if (!obj || typeof obj !== 'object')
         return false;

package/dist/v2/durable-core/schemas/artifacts/loop-control.js

@@ -36,7 +36,8 @@ function parseLoopControlArtifact(artifact) {
     return result.success ? result.data : null;
 }
 function findLoopControlArtifact(artifacts, loopId) {
-    for (const artifact of artifacts) {
+    for (let i = artifacts.length - 1; i >= 0; i--) {
+        const artifact = artifacts[i];
         if (!isLoopControlArtifact(artifact))
             continue;
         const parsed = parseLoopControlArtifact(artifact);

package/dist/v2/infra/local/directory-listing/index.d.ts

@@ -1,8 +1,9 @@
 import type { ResultAsync } from 'neverthrow';
 import type { FsError, DirectoryListingOpsPortV2 } from '../../../ports/fs.port.js';
-import type { DirectoryListingPortV2 } from '../../../ports/directory-listing.port.js';
+import type { DirectoryListingPortV2, DirEntryWithMtime } from '../../../ports/directory-listing.port.js';
 export declare class LocalDirectoryListingV2 implements DirectoryListingPortV2 {
     private readonly fs;
     constructor(fs: DirectoryListingOpsPortV2);
     readdir(dirPath: string): ResultAsync<readonly string[], FsError>;
+    readdirWithMtime(dirPath: string): ResultAsync<readonly DirEntryWithMtime[], FsError>;
 }

package/dist/v2/infra/local/directory-listing/index.js

@@ -14,5 +14,13 @@ class LocalDirectoryListingV2 {
             return (0, neverthrow_1.errAsync)(e);
         });
     }
+    readdirWithMtime(dirPath) {
+        return this.fs.readdirWithMtime(dirPath).orElse((e) => {
+            if (e.code === 'FS_NOT_FOUND') {
+                return (0, neverthrow_1.okAsync)([]);
+            }
+            return (0, neverthrow_1.errAsync)(e);
+        });
+    }
 }
 exports.LocalDirectoryListingV2 = LocalDirectoryListingV2;

package/dist/v2/infra/local/fs/index.d.ts

@@ -1,5 +1,5 @@
 import type { ResultAsync } from 'neverthrow';
-import type { FileSystemPortV2, FsError } from '../../../ports/fs.port.js';
+import type { FileSystemPortV2, FsError, FsDirEntryWithMtime } from '../../../ports/fs.port.js';
 export declare class NodeFileSystemV2 implements FileSystemPortV2 {
     mkdirp(dirPath: string): ResultAsync<void, FsError>;
     readFileUtf8(filePath: string): ResultAsync<string, FsError>;
@@ -24,4 +24,5 @@ export declare class NodeFileSystemV2 implements FileSystemPortV2 {
         readonly sizeBytes: number;
     }, FsError>;
     readdir(dirPath: string): ResultAsync<readonly string[], FsError>;
+    readdirWithMtime(dirPath: string): ResultAsync<readonly FsDirEntryWithMtime[], FsError>;
 }

package/dist/v2/infra/local/fs/index.js

@@ -38,6 +38,7 @@ const fs = __importStar(require("fs/promises"));
 const fsCb = __importStar(require("fs"));
 const fs_1 = require("fs");
 const neverthrow_1 = require("neverthrow");
+const path = __importStar(require("path"));
 function nodeErrorCode(e) {
     if (typeof e !== 'object' || e === null)
         return undefined;
@@ -162,5 +163,28 @@ class NodeFileSystemV2 {
     readdir(dirPath) {
         return neverthrow_1.ResultAsync.fromPromise(fs.readdir(dirPath), (e) => mapFsError(e, dirPath));
     }
+    readdirWithMtime(dirPath) {
+        return neverthrow_1.ResultAsync.fromPromise((async () => {
+            const entries = await fs.readdir(dirPath);
+            const withMtime = [];
+            let skipped = 0;
+            for (const name of entries) {
+                try {
+                    const stats = await fs.stat(path.join(dirPath, name));
+                    withMtime.push({ name, mtimeMs: stats.mtimeMs });
+                }
+                catch (e) {
+                    const code = nodeErrorCode(e);
+                    skipped++;
+                    console.error(`[workrail:session-enum] Skipping ${name}: stat failed (${code ?? 'unknown'}: ${e instanceof Error ? e.message : String(e)})`);
+                    continue;
+                }
+            }
+            if (skipped > 0) {
+                console.error(`[workrail:session-enum] Enumerated ${withMtime.length} sessions, skipped ${skipped} (stat failures)`);
+            }
+            return withMtime;
+        })(), (e) => mapFsError(e, dirPath));
+    }
 }
 exports.NodeFileSystemV2 = NodeFileSystemV2;

package/dist/v2/infra/local/session-summary-provider/index.js

@@ -21,7 +21,7 @@ class LocalSessionSummaryProviderV2 {
         this.ports = ports;
     }
     loadHealthySummaries() {
-        return (0, enumerate_sessions_js_1.enumerateSessions)({
+        return (0, enumerate_sessions_js_1.enumerateSessionsByRecency)({
             directoryListing: this.ports.directoryListing,
             dataDir: this.ports.dataDir,
         })

package/dist/v2/ports/directory-listing.port.d.ts

@@ -1,5 +1,10 @@
 import type { ResultAsync } from 'neverthrow';
 import type { FsError } from './fs.port.js';
+export interface DirEntryWithMtime {
+    readonly name: string;
+    readonly mtimeMs: number;
+}
 export interface DirectoryListingPortV2 {
     readdir(dirPath: string): ResultAsync<readonly string[], FsError>;
+    readdirWithMtime(dirPath: string): ResultAsync<readonly DirEntryWithMtime[], FsError>;
 }

package/dist/v2/ports/fs.port.d.ts

@@ -45,8 +45,13 @@ export interface FileManipulationPortV2 {
     unlink(filePath: string): ResultAsync<void, FsError>;
     writeFileBytes(filePath: string, bytes: Uint8Array): ResultAsync<void, FsError>;
 }
+export interface FsDirEntryWithMtime {
+    readonly name: string;
+    readonly mtimeMs: number;
+}
 export interface DirectoryListingOpsPortV2 {
     readdir(dirPath: string): ResultAsync<readonly string[], FsError>;
+    readdirWithMtime(dirPath: string): ResultAsync<readonly FsDirEntryWithMtime[], FsError>;
 }
 export interface CrashSafeFileOpsPortV2 extends DirectoryOpsPortV2, FileReadPortV2, FileDescriptorPortV2, FileManipulationPortV2, DirectoryListingOpsPortV2 {
 }

package/dist/v2/usecases/enumerate-sessions.d.ts

@@ -7,3 +7,7 @@ export declare function enumerateSessions(ports: {
     readonly directoryListing: DirectoryListingPortV2;
     readonly dataDir: DataDirPortV2;
 }): ResultAsync<readonly SessionId[], FsError>;
+export declare function enumerateSessionsByRecency(ports: {
+    readonly directoryListing: DirectoryListingPortV2;
+    readonly dataDir: DataDirPortV2;
+}): ResultAsync<readonly SessionId[], FsError>;

package/dist/v2/usecases/enumerate-sessions.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.enumerateSessions = enumerateSessions;
+exports.enumerateSessionsByRecency = enumerateSessionsByRecency;
 const index_js_1 = require("../durable-core/ids/index.js");
 const SESSION_DIR_PATTERN = /^sess_[a-zA-Z0-9_]+$/;
 function enumerateSessions(ports) {
@@ -11,3 +12,15 @@ function enumerateSessions(ports) {
         .sort()
         .map((entry) => (0, index_js_1.asSessionId)(entry)));
 }
+function enumerateSessionsByRecency(ports) {
+    return ports.directoryListing
+        .readdirWithMtime(ports.dataDir.sessionsDir())
+        .map((entries) => entries
+        .filter((entry) => SESSION_DIR_PATTERN.test(entry.name))
+        .sort((a, b) => {
+        if (a.mtimeMs !== b.mtimeMs)
+            return b.mtimeMs - a.mtimeMs;
+        return a.name.localeCompare(b.name);
+    })
+        .map((entry) => (0, index_js_1.asSessionId)(entry.name)));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "description": "Step-by-step workflow enforcement for AI agents via MCP",
   "license": "MIT",
   "repository": {