@exaudeus/workrail 1.5.1 → 1.5.2

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

@@ -22,6 +22,13 @@ let WorkflowCompiler = class WorkflowCompiler {
             }
             stepById.set(step.id, step);
         }
+        for (const step of steps) {
+            const contractRef = step.outputContract?.contractRef;
+            if (contractRef && !(0, index_1.isValidContractRef)(contractRef)) {
+                return (0, neverthrow_1.err)(error_1.Err.invalidState(`Step '${step.id}' declares unknown outputContract.contractRef '${contractRef}'. ` +
+                    `Known contracts: ${index_1.LOOP_CONTROL_CONTRACT_REF}`));
+            }
+        }
         const compiledLoops = new Map();
         const loopBodyStepIds = new Set();
         for (const step of steps) {
@@ -33,6 +40,11 @@ let WorkflowCompiler = class WorkflowCompiler {
                 return (0, neverthrow_1.err)(bodyResolved.error);
             for (const bodyStep of bodyResolved.value) {
                 loopBodyStepIds.add(bodyStep.id);
+                const ref = bodyStep.outputContract?.contractRef;
+                if (ref && !(0, index_1.isValidContractRef)(ref)) {
+                    return (0, neverthrow_1.err)(error_1.Err.invalidState(`Loop body step '${bodyStep.id}' in loop '${loop.id}' declares unknown outputContract.contractRef '${ref}'. ` +
+                        `Known contracts: ${index_1.LOOP_CONTROL_CONTRACT_REF}`));
+                }
             }
             const conditionSource = this.deriveConditionSource(loop, bodyResolved.value);
             compiledLoops.set(loop.id, {
@@ -56,8 +68,8 @@ let WorkflowCompiler = class WorkflowCompiler {
         if (loop.loop.conditionSource) {
             return loop.loop.conditionSource;
         }
-        const hasLoopControlContract = bodySteps.some((s) => s.outputContract?.contractRef === index_1.LOOP_CONTROL_CONTRACT_REF);
-        if (hasLoopControlContract) {
+        const loopControlStep = bodySteps.find((s) => s.outputContract?.contractRef === index_1.LOOP_CONTROL_CONTRACT_REF);
+        if (loopControlStep) {
             return {
                 kind: 'artifact_contract',
                 contractRef: index_1.LOOP_CONTROL_CONTRACT_REF,

package/dist/infrastructure/session/HttpServer.js

@@ -283,7 +283,12 @@ let HttpServer = class HttpServer {
         this.app.delete('/api/sessions/:workflow/:id', async (req, res) => {
             try {
                 const { workflow, id } = req.params;
-                await this.sessionManager.deleteSession(workflow, id);
+                const result = await this.sessionManager.deleteSession(workflow, id);
+                if (result.isErr()) {
+                    const status = result.error.code === 'SESSION_NOT_FOUND' ? 404 : 500;
+                    res.status(status).json({ success: false, error: result.error.message });
+                    return;
+                }
                 res.json({
                     success: true,
                     message: `Session ${workflow}/${id} deleted successfully`
@@ -291,7 +296,7 @@ let HttpServer = class HttpServer {
             }
             catch (error) {
                 console.error('[HttpServer] Delete session error:', error);
-                res.status(error.message?.includes('not found') ? 404 : 500).json({
+                res.status(500).json({
                     success: false,
                     error: error.message || 'Failed to delete session'
                 });

package/dist/infrastructure/session/SessionManager.d.ts

@@ -1,6 +1,14 @@
 import { EventEmitter } from 'events';
+import { type Result } from 'neverthrow';
 import { SessionDataNormalizer } from './SessionDataNormalizer';
 import { SessionDataValidator } from './SessionDataValidator';
+export type SessionManagerError = {
+    readonly code: 'SESSION_NOT_FOUND';
+    readonly message: string;
+} | {
+    readonly code: 'IO_ERROR';
+    readonly message: string;
+};
 export interface Session {
     id: string;
     workflowId: string;
@@ -30,10 +38,10 @@ export declare class SessionManager extends EventEmitter {
     private findGitRepoRoot;
     private getProjectRoot;
     getSessionPath(workflowId: string, sessionId: string): string;
-    createSession(workflowId: string, sessionId: string, initialData?: Record<string, any>): Promise<Session>;
-    updateSession(workflowId: string, sessionId: string, updates: Record<string, any>): Promise<Session>;
-    readSession(workflowId: string, sessionId: string, queryPath?: string): Promise<any>;
-    deleteSession(workflowId: string, sessionId: string): Promise<void>;
+    createSession(workflowId: string, sessionId: string, initialData?: Record<string, any>): Promise<Result<Session, SessionManagerError>>;
+    updateSession(workflowId: string, sessionId: string, updates: Record<string, any>): Promise<Result<Session, SessionManagerError>>;
+    readSession(workflowId: string, sessionId: string, queryPath?: string): Promise<Result<unknown, SessionManagerError>>;
+    deleteSession(workflowId: string, sessionId: string): Promise<Result<void, SessionManagerError>>;
     deleteSessions(sessions: Array<{
         workflowId: string;
         sessionId: string;

package/dist/infrastructure/session/SessionManager.js

@@ -24,6 +24,7 @@ const child_process_1 = require("child_process");
 const os_1 = __importDefault(require("os"));
 const events_1 = require("events");
 const tsyringe_1 = require("tsyringe");
+const neverthrow_1 = require("neverthrow");
 const tokens_js_1 = require("../../di/tokens.js");
 const SessionDataNormalizer_1 = require("./SessionDataNormalizer");
 const SessionDataValidator_1 = require("./SessionDataValidator");
@@ -76,7 +77,12 @@ let SessionManager = class SessionManager extends events_1.EventEmitter {
     }
     async createSession(workflowId, sessionId, initialData = {}) {
         const sessionPath = this.getSessionPath(workflowId, sessionId);
-        await promises_1.default.mkdir(path_1.default.dirname(sessionPath), { recursive: true });
+        try {
+            await promises_1.default.mkdir(path_1.default.dirname(sessionPath), { recursive: true });
+        }
+        catch (e) {
+            return (0, neverthrow_1.err)({ code: 'IO_ERROR', message: `Failed to create session directory: ${e instanceof Error ? e.message : String(e)}` });
+        }
         const session = {
             id: sessionId,
             workflowId,
@@ -86,15 +92,20 @@ let SessionManager = class SessionManager extends events_1.EventEmitter {
             updatedAt: new Date().toISOString(),
             data: initialData
         };
-        await this.atomicWrite(sessionPath, session);
+        try {
+            await this.atomicWrite(sessionPath, session);
+        }
+        catch (e) {
+            return (0, neverthrow_1.err)({ code: 'IO_ERROR', message: `Failed to write session: ${e instanceof Error ? e.message : String(e)}` });
+        }
         await this.updateProjectMetadata();
-        return session;
+        return (0, neverthrow_1.ok)(session);
     }
     async updateSession(workflowId, sessionId, updates) {
         const sessionPath = this.getSessionPath(workflowId, sessionId);
         const session = await this.getSession(workflowId, sessionId);
         if (!session) {
-            throw new Error(`Session not found: ${workflowId}/${sessionId}`);
+            return (0, neverthrow_1.err)({ code: 'SESSION_NOT_FOUND', message: `Session not found: ${workflowId}/${sessionId}` });
         }
         const mergedData = this.deepMerge(session.data, updates);
         const normalizedData = this.normalizer.normalize(workflowId, mergedData);
@@ -104,36 +115,40 @@ let SessionManager = class SessionManager extends events_1.EventEmitter {
         }
         session.data = normalizedData;
         session.updatedAt = new Date().toISOString();
-        await this.atomicWrite(sessionPath, session);
-        return session;
+        try {
+            await this.atomicWrite(sessionPath, session);
+        }
+        catch (e) {
+            return (0, neverthrow_1.err)({ code: 'IO_ERROR', message: `Failed to write session: ${e instanceof Error ? e.message : String(e)}` });
+        }
+        return (0, neverthrow_1.ok)(session);
     }
     async readSession(workflowId, sessionId, queryPath) {
         const session = await this.getSession(workflowId, sessionId);
         if (!session) {
-            throw new Error(`Session not found: ${workflowId}/${sessionId}`);
+            return (0, neverthrow_1.err)({ code: 'SESSION_NOT_FOUND', message: `Session not found: ${workflowId}/${sessionId}` });
         }
         if (!queryPath) {
-            return session.data;
+            return (0, neverthrow_1.ok)(session.data);
         }
-        return this.getPath(session.data, queryPath);
+        return (0, neverthrow_1.ok)(this.getPath(session.data, queryPath));
     }
     async deleteSession(workflowId, sessionId) {
         const sessionPath = this.getSessionPath(workflowId, sessionId);
         const exists = await promises_1.default.access(sessionPath).then(() => true).catch(() => false);
         if (!exists) {
-            throw new Error(`Session not found: ${workflowId}/${sessionId}`);
+            return (0, neverthrow_1.err)({ code: 'SESSION_NOT_FOUND', message: `Session not found: ${workflowId}/${sessionId}` });
         }
         this.unwatchSession(workflowId, sessionId);
         await promises_1.default.unlink(sessionPath);
         await this.updateProjectMetadata();
+        return (0, neverthrow_1.ok)(undefined);
     }
     async deleteSessions(sessions) {
         for (const { workflowId, sessionId } of sessions) {
-            try {
-                await this.deleteSession(workflowId, sessionId);
-            }
-            catch (error) {
-                console.error(`Failed to delete ${workflowId}/${sessionId}:`, error);
+            const res = await this.deleteSession(workflowId, sessionId);
+            if (res.isErr()) {
+                console.error(`Failed to delete ${workflowId}/${sessionId}:`, res.error.message);
             }
         }
     }

package/dist/manifest.json

@@ -46,8 +46,8 @@
       "bytes": 990
     },
     "application/services/workflow-compiler.js": {
-      "sha256": "1df9fc317ad765d011a57b7995351e6a308f26d7cac17bb91f42a351b1cabc2c",
-      "bytes": 4703
+      "sha256": "f865278e4242867dfd9b679e489d8f2de89f46b578f586a80fc5490ab6c65cdb",
+      "bytes": 5550
     },
     "application/services/workflow-interpreter.d.ts": {
       "sha256": "56b5b5ad06d42096deba9f0abe7642c18a355a1e598749aab1730df4e9847674",
@@ -390,8 +390,8 @@
       "bytes": 1852
     },
     "infrastructure/session/HttpServer.js": {
-      "sha256": "451db710b31e8de848f95383ca6964de2edc3c79063cb464d7b2de1e855c4c01",
-      "bytes": 32208
+      "sha256": "76508602e5d7ee9337ff64c7dffa5153347ef754e1252d191b4ee6243ea24f1b",
+      "bytes": 32446
     },
     "infrastructure/session/SessionDataNormalizer.d.ts": {
       "sha256": "c89bb5e00d7d01fb4aa6d0095602541de53c425c6b99b67fa8367eb29cb63e9e",
@@ -410,12 +410,12 @@
       "bytes": 11512
     },
     "infrastructure/session/SessionManager.d.ts": {
-      "sha256": "05632114129307891d08ca0a8ca2273732cfe29c0cefd8dcfca9a295b1f62345",
-      "bytes": 2186
+      "sha256": "b3a3b4b6b44425204a6a20928132978f998219f99dab70491c017fae10c7d479",
+      "bytes": 2524
     },
     "infrastructure/session/SessionManager.js": {
-      "sha256": "764033447b9ca2cb5d0eb91143b906519bee012f98ff2141b1e9bfc4d7c5d070",
-      "bytes": 20154
+      "sha256": "7044259c881b35c72ccbfece31be867eb5315df1384417924ac49d4cee11aee6",
+      "bytes": 21110
     },
     "infrastructure/session/index.d.ts": {
       "sha256": "52957847da70fcece6a553334bd899efd8ede55cc31f3aa5eb5e3d4bb70e3862",
@@ -514,28 +514,28 @@
       "bytes": 476
     },
     "mcp/error-mapper.d.ts": {
-      "sha256": "9ed8afa42fd432ab9bdf781c90ec157eb51ef03e2b17afbb74ad54b91e5bae8a",
-      "bytes": 267
+      "sha256": "c6e9db65c565063726442b73a4a0cf1a1c07d54c778a85cf0122c4c04ea6a5a9",
+      "bytes": 268
     },
     "mcp/error-mapper.js": {
-      "sha256": "1437bf9380090920512565c0d685a268af29d8b7e747eff62904e1090e69c854",
-      "bytes": 3735
+      "sha256": "582411de477df432854cf31ded65b80f1d9f5673d0e06cc7660ac25aa834b736",
+      "bytes": 3982
     },
     "mcp/handler-factory.d.ts": {
       "sha256": "fad8fff32776b2fe7182708ce0e821c2434fdfce7191390bb9cfaf16a7d31a60",
       "bytes": 796
     },
     "mcp/handler-factory.js": {
-      "sha256": "cfdb8853f1e1a9529899852e4e25b027779647f1f94d3db931f4439052a0b607",
-      "bytes": 2875
+      "sha256": "fca1b2d87d7d0961bc0c3ec337d5c18ffe8a379964af3836b1ac532bab1195ea",
+      "bytes": 3382
     },
     "mcp/handlers/session.d.ts": {
       "sha256": "38926e69a0e4935d1dbcdc53848be9fff0e4d8f96827883da3216f217918fa82",
       "bytes": 1394
     },
     "mcp/handlers/session.js": {
-      "sha256": "4955f0b09766426318f5d21ab3bd8967b11666830000504e44ef3b94beb526ee",
-      "bytes": 6622
+      "sha256": "83c9585400cc7c20cac3691b8771b9ce8cdc508ba7f5d083a96f7ed975aabc05",
+      "bytes": 5967
     },
     "mcp/handlers/shared/with-timeout.d.ts": {
       "sha256": "31ca3db008cb5cd439e0d1132bc4b29be0900c403c452931e3a24a50e45beb54",
@@ -566,8 +566,8 @@
       "bytes": 3500
     },
     "mcp/handlers/v2-advance-core/index.js": {
-      "sha256": "5ead85dbaf573011568ec1dc826be97c482b43a70a6a7ed724cd767e9a9deeb4",
-      "bytes": 5487
+      "sha256": "056de2680358ac496e82619a921a9f6403e51e2f8f1e4fdf0e7acd0da1136bab",
+      "bytes": 6974
     },
     "mcp/handlers/v2-advance-core/input-validation.d.ts": {
       "sha256": "a7b5d0e80eaea2cc500cd576bd1ae25d1c5521dcef76011bd052bf6cf6cf574b",
@@ -606,8 +606,8 @@
       "bytes": 259
     },
     "mcp/handlers/v2-checkpoint.js": {
-      "sha256": "db8702a5d6ccd6103780dea96d9983e3c17ef74cb63cdbdac97fff77091a39e1",
-      "bytes": 9289
+      "sha256": "24b7aaf920fd2c5e4ec801ab9c0f3f7d93aa8280c05b851f12e57343d352a4ec",
+      "bytes": 9196
     },
     "mcp/handlers/v2-context-budget.d.ts": {
       "sha256": "cbad1741a183d52c9cbe558be2e09f776843d1f3ec8cd28d6d0d230668e4298c",
@@ -618,20 +618,20 @@
       "bytes": 7173
     },
     "mcp/handlers/v2-error-mapping.d.ts": {
-      "sha256": "b0f426e2ea4c25caa19fb72ea8c5c65590be01da6bb6678b1236b4333c66ad09",
-      "bytes": 1707
+      "sha256": "bbaf580dfc22ca6b5ef1d57036fb549c640d6f37bd7d525f1a805b4d14c4d75c",
+      "bytes": 1711
     },
     "mcp/handlers/v2-error-mapping.js": {
-      "sha256": "f0b848f39c69128504cca4c157d44ae8e79b68edd4624ee12e1bce657237b1f8",
-      "bytes": 6808
+      "sha256": "95dff130804524a007e1071784c20897ba6af1cc04fb2a636741e261fa22c3f8",
+      "bytes": 10388
     },
     "mcp/handlers/v2-execution-helpers.d.ts": {
-      "sha256": "9ff56752113e6ed25c672b813810cc14ed6d28831863804897d886e64d81d33a",
-      "bytes": 5616
+      "sha256": "1e52f266e991a9447d1254bf047f6a09062b038ed3363a3818d1f5c91eed2fc8",
+      "bytes": 5712
     },
     "mcp/handlers/v2-execution-helpers.js": {
-      "sha256": "980637d9955bcecb0c056e3eab76aba18d1956a72b52229c8a82149675f1e9e6",
-      "bytes": 16266
+      "sha256": "9ac62b0d64ea10a89b18e79a01b1f5b05d35e40eddcb7a9f93a3bcbe737e85b3",
+      "bytes": 18751
     },
     "mcp/handlers/v2-execution.d.ts": {
       "sha256": "f76cd1bb6a6e25c5a37a1f5b01b1046f4afd41162b620f3be3861509e1fcd1d3",
@@ -654,40 +654,40 @@
       "bytes": 1830
     },
     "mcp/handlers/v2-execution/continue-advance.js": {
-      "sha256": "259e2b631c585b171d84c3b235e87621889eb9b213f0d28bbc5f7f6019d7673d",
-      "bytes": 8251
+      "sha256": "bfbc14690fe08f51c5e1e2124e5561e9a093806e511803d68e4a2d22b5918919",
+      "bytes": 7927
     },
     "mcp/handlers/v2-execution/continue-rehydrate.d.ts": {
       "sha256": "af7475b7effe57f18fa8379bfd128d17afb2d27fe1c058c6f2ee8f5b2632e3d0",
       "bytes": 1312
     },
     "mcp/handlers/v2-execution/continue-rehydrate.js": {
-      "sha256": "52de5f0dd7b366a36b68b487119a43dc6c5581c5d4ea5304cc6530052a334973",
-      "bytes": 8675
+      "sha256": "b77850715f6d4300a5b9b7b86063a02eed0e63410bdf6b1572bdae3d40b8a32f",
+      "bytes": 8585
     },
     "mcp/handlers/v2-execution/index.d.ts": {
-      "sha256": "b6ed1b40a7bfd7ea01aa20d9f20defa9394cfda03aff3554da308fdfd5ab3397",
-      "bytes": 950
+      "sha256": "481d74c4ab444964ac9c71e0348da91abd642352a6fc1c69cff70e300d76881e",
+      "bytes": 1185
     },
     "mcp/handlers/v2-execution/index.js": {
-      "sha256": "5ef4e95b9789a6f0f2085417c34186902f576393baa4ab35b20833e1d261d366",
-      "bytes": 5303
+      "sha256": "bc131f6e61d85dd46cf500dab4b6a5865180186f2361205d108e57d05e29ebfe",
+      "bytes": 4716
     },
     "mcp/handlers/v2-execution/replay.d.ts": {
       "sha256": "7a8a9c7993a86fae086510c63e70eb4556aff9af978ac5e10733358698e14097",
       "bytes": 2869
     },
     "mcp/handlers/v2-execution/replay.js": {
-      "sha256": "9d22e419d84f0961cdeb1ca076ab66c7a0e619043f2b560d4b6581b70054df29",
-      "bytes": 12181
+      "sha256": "49b84755c42e40b23a0434cc97f0b4abeff4e46ae6a85c4b0363bd39018c7ea1",
+      "bytes": 11969
     },
     "mcp/handlers/v2-execution/start.d.ts": {
-      "sha256": "ab18fa2d8382e31bab816ddc981f721b76a592dadd724756d27cdd71286eb0d8",
-      "bytes": 2785
+      "sha256": "59de3fb71608b19e6a81a63ff3c74f9be92b90c8e07817e9248e3ee7e4654367",
+      "bytes": 2789
     },
     "mcp/handlers/v2-execution/start.js": {
-      "sha256": "667ba0dec1154018b15f64a9b3be19815457bab674014e0879e772e523be4df9",
-      "bytes": 15986
+      "sha256": "6d6763c4cae68d573d228826af6826e830ce70d016772c74d4780207807b1928",
+      "bytes": 15078
     },
     "mcp/handlers/v2-resume.d.ts": {
       "sha256": "d88f6c35bcaf946666c837b72fda3702a2ebab5e478eb90f7b4b672a0e5fa24f",
@@ -718,8 +718,8 @@
       "bytes": 397
     },
     "mcp/handlers/v2-workflow.js": {
-      "sha256": "ca2c4a36299d425e788eef4af042099eef7bf62d0ff8fc2a7308723a9a99f205",
-      "bytes": 5522
+      "sha256": "bed0ffc401958c14343158e142e4be344bad49cabc95f99a811d872bc76989a7",
+      "bytes": 6027
     },
     "mcp/handlers/workflow.d.ts": {
       "sha256": "050565039a20af3f7fc8311337ff4547438ecc59433e5744aacce8f203326774",
@@ -738,12 +738,12 @@
       "bytes": 7535
     },
     "mcp/output-schemas.d.ts": {
-      "sha256": "f18366a180449212d9a2b280dc9706f4f96a77ccead38bf11035c3859121fd84",
-      "bytes": 45137
+      "sha256": "85bc8019547bbee11374a09344489f9dd99703782e5f3822497193b09dbfba1f",
+      "bytes": 49826
     },
     "mcp/output-schemas.js": {
-      "sha256": "e7aeb43d06950e4a9ed1fa4ecd56418dc7eb32f54453634701b5dc39456eb3e8",
-      "bytes": 11565
+      "sha256": "05fe0824c55da5fdadfc92a0bcaaf95f998ba3fbaedae5a27370ceba53e3dc6e",
+      "bytes": 12015
     },
     "mcp/server.d.ts": {
       "sha256": "bec49b8d07e189a53db7100d2f0e1e84ffe03150f04e1b06908ee3282982b4a2",
@@ -766,8 +766,8 @@
       "bytes": 132
     },
     "mcp/tool-descriptions.js": {
-      "sha256": "76d25a3a2bba38227ad199c4d1240769b6b14411ebecf965e9e00eaac2f2e01c",
-      "bytes": 16389
+      "sha256": "a14ecf27cea136307d6016862f6897d1ba776f51f713e8c9cc65281f4ab7be4e",
+      "bytes": 16654
     },
     "mcp/tool-factory.d.ts": {
       "sha256": "0fe3c6b863b2d7aef0c3d659ff54f3a9ee8a0a3c2005b6565d2f8ad517bc7211",
@@ -786,12 +786,12 @@
       "bytes": 8360
     },
     "mcp/types.d.ts": {
-      "sha256": "564136878ad3e71300d5e82913590b1f43d3dfbafab36479c9a590853cd07a0a",
-      "bytes": 4050
+      "sha256": "ce700982b88189f08c466384b4357b3345ec0ccb6842ff97a0831c2281185c6c",
+      "bytes": 4284
     },
     "mcp/types.js": {
-      "sha256": "0c12576fd0053115ff096fe26b38f77f1e830b7ec4781aaf94564827c4c9e81a",
-      "bytes": 1253
+      "sha256": "d10c4070e4c3454d80f0fa9cdc0e978c69c53c13fd09baa8710fcd802fed8926",
+      "bytes": 1608
     },
     "mcp/types/tool-description-types.d.ts": {
       "sha256": "80984afa5283a0d651ff22c0c9b2d3ff14c85087aeaf735d306ae291d8cdfe4d",
@@ -826,12 +826,12 @@
       "bytes": 3078
     },
     "mcp/v2/tools.d.ts": {
-      "sha256": "5da50237fcbce6240737441d134c8070256a23649b387d5c3438b41b2705905e",
-      "bytes": 4156
+      "sha256": "a6fc8e1feb02807a4f7984dcd00358081a4b63b6b9ec9b88bb2bff833c280322",
+      "bytes": 5172
     },
     "mcp/v2/tools.js": {
-      "sha256": "5c9b958f1a9eb609557ed5867fc9ea131a2a0a4aaf52ff05a38246dffe2b359d",
-      "bytes": 6435
+      "sha256": "7460146a5d0d3a0f67d4d42e512d467455169d22bb99f69ad812848da862b8a4",
+      "bytes": 6721
     },
     "mcp/validation/bounded-json.d.ts": {
       "sha256": "82203ac6123d5c6989606c3b5405aaea99ab829c8958835f9ae3ba45b8bc8fd5",
@@ -1042,8 +1042,8 @@
       "bytes": 395
     },
     "types/workflow-definition.d.ts": {
-      "sha256": "323b388a894c39a1718743a92aee3e2ff941a48325e352f2df690bf93a3e018b",
-      "bytes": 3463
+      "sha256": "719bd8abe73b4377ba9a23c60d9fbdef170b193b8a3c46d6ddc6bc49cb65e8d2",
+      "bytes": 3576
     },
     "types/workflow-definition.js": {
       "sha256": "e269d62f27b7f37f870183d6b77800b7aa1e22dabc894374bab8f34db049a55b",
@@ -1126,8 +1126,8 @@
       "bytes": 465
     },
     "v2/durable-core/canonical/jcs.js": {
-      "sha256": "0611bbe61a30d96c2d18d166383eb9ecd49ede0d66814fcb65ebf2df40eaa23c",
-      "bytes": 2338
+      "sha256": "31dd493338681e305793ceaf4f7de58d60818310b9f3ddff72637c5120ecd9fa",
+      "bytes": 2517
     },
     "v2/durable-core/canonical/json-types.d.ts": {
       "sha256": "6267cfbe4798d6117ed30ef69365e28d85fb6ba1464c1c8313db83a7bf56a4fc",
@@ -1162,12 +1162,12 @@
       "bytes": 3453
     },
     "v2/durable-core/domain/ack-advance-append-plan.d.ts": {
-      "sha256": "957549bbdeec71cc36fee8e39ed3aca33c6e8110856d43f16ec3f4e4cfb28325",
-      "bytes": 1745
+      "sha256": "2e802606656a0c1938192e5533aa46c74bc42789b5c315c79f6de4850017b30e",
+      "bytes": 1533
     },
     "v2/durable-core/domain/ack-advance-append-plan.js": {
-      "sha256": "362bff69902fe67393c64001c175c7f38560277132320cfcc5d711f08b2d5920",
-      "bytes": 7853
+      "sha256": "ae08bded7edd323b817711946dd27a9ba51047ef41248ad10e098d69d5c3015d",
+      "bytes": 6839
     },
     "v2/durable-core/domain/artifact-contract-validator.d.ts": {
       "sha256": "262d667fb49fc68a5a6db9f60d4a50c15b9e45ba9ef5980d5b2036a29582eac8",
@@ -1182,8 +1182,8 @@
       "bytes": 880
     },
     "v2/durable-core/domain/blocked-node-builder.js": {
-      "sha256": "e07b0fee68be1b9ce653f990cbe0dfde767765915c093a540a53448ceb0aa3fd",
-      "bytes": 4011
+      "sha256": "3bd568ec217fb79e8e7ebfd5b7a8474a81f06caf58aceccad9ce3c46c9a06fec",
+      "bytes": 4008
     },
     "v2/durable-core/domain/blocking-decision.d.ts": {
       "sha256": "dd32c4354dd710f94629833e91c5f83cd316212116d63fac1305d7336d4ce353",
@@ -1466,7 +1466,7 @@
       "bytes": 1728
     },
     "v2/durable-core/schemas/artifacts/loop-control.d.ts": {
-      "sha256": "0da9cbedb121753826c6e3f157a4feff1895fcc60b67527e484882ac37ce3eaa",
+      "sha256": "2575028ca2f52f4562857edd76696f6a6cd57f7aaa916346b00c76f62fdec498",
       "bytes": 2743
     },
     "v2/durable-core/schemas/artifacts/loop-control.js": {
@@ -1482,7 +1482,7 @@
       "bytes": 1350
     },
     "v2/durable-core/schemas/execution-snapshot/blocked-snapshot.d.ts": {
-      "sha256": "63e6bdb43c77740935fb8bf49dfd96d5d783a01ae5ce61c0d0f9d61df8e838f6",
+      "sha256": "62fbdd2d901f8338942908bbdef575f871279501ba76b819a7750fe38c1f7976",
       "bytes": 23179
     },
     "v2/durable-core/schemas/execution-snapshot/blocked-snapshot.js": {
@@ -1490,7 +1490,7 @@
       "bytes": 4364
     },
     "v2/durable-core/schemas/execution-snapshot/execution-snapshot.v1.d.ts": {
-      "sha256": "1515649328e6a00fe00053b7fc5aaa5a6dfa325e8c1ea54e99cd44fc54c73280",
+      "sha256": "675f92a72f254f6e737fe86e4fb8e8ab75405507ea5e691fa78c9cf487552b20",
       "bytes": 186498
     },
     "v2/durable-core/schemas/execution-snapshot/execution-snapshot.v1.js": {
@@ -1514,7 +1514,7 @@
       "bytes": 2983
     },
     "v2/durable-core/schemas/export-bundle/index.d.ts": {
-      "sha256": "856a1e4bcaa17ceb03bdd227b6007fac5221bd7063e0cd83a4eaddb43b1d3523",
+      "sha256": "3b922ab53a8cf1c5cc0968f1409aae87b5782b01ab19f74fcb25fef9286cc36a",
       "bytes": 466802
     },
     "v2/durable-core/schemas/export-bundle/index.js": {
@@ -1562,7 +1562,7 @@
       "bytes": 3396
     },
     "v2/durable-core/schemas/session/dag-topology.d.ts": {
-      "sha256": "c8affdc4152be2a6f27b8a1dd06b9262d93b69e345aa82e694a425c76a7b2d45",
+      "sha256": "67fc952e5af8f364764996c62a685bf9db8e7d73727f639cbf87cb1b4f5d8dd6",
       "bytes": 3018
     },
     "v2/durable-core/schemas/session/dag-topology.js": {
@@ -1570,7 +1570,7 @@
       "bytes": 2138
     },
     "v2/durable-core/schemas/session/events.d.ts": {
-      "sha256": "004bbfe44da4ec264aea85d68f3a078d11d805f3507a6fce07b4092cb44a1a70",
+      "sha256": "d3d4d17bf02181c51655c1c4835e2d4945c4f2903e89991b911bc3f445220b86",
       "bytes": 72218
     },
     "v2/durable-core/schemas/session/events.js": {

package/dist/mcp/error-mapper.d.ts

@@ -1,4 +1,4 @@
 import type { DomainError } from '../domain/execution/error.js';
 import type { ToolError } from './types.js';
 export declare function mapDomainErrorToToolError(err: DomainError): ToolError;
-export declare function mapUnknownErrorToToolError(err: unknown): ToolError;
+export declare function mapUnknownErrorToToolError(_err: unknown): ToolError;

package/dist/mcp/error-mapper.js

@@ -3,13 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.mapDomainErrorToToolError = mapDomainErrorToToolError;
 exports.mapUnknownErrorToToolError = mapUnknownErrorToToolError;
 const bounded_json_js_1 = require("./validation/bounded-json.js");
-function assertNever(x) {
+const v2_execution_helpers_js_1 = require("./handlers/v2-execution-helpers.js");
+function assertNever(_x) {
     return {
         type: 'error',
         code: 'INTERNAL_ERROR',
-        message: `Unhandled DomainError variant: ${JSON.stringify(x)}`,
+        message: 'WorkRail encountered an unexpected error. This is not caused by your input.',
         retry: { kind: 'not_retryable' },
-        details: { invariantViolation: 'exhaustiveness_check_failed' },
+        details: { suggestion: (0, v2_execution_helpers_js_1.internalSuggestion)('', 'WorkRail has an internal error.') },
     };
 }
 function mapDomainErrorToToolError(err) {
@@ -80,9 +81,12 @@ function mapDomainErrorToToolError(err) {
             return assertNever(err);
     }
 }
-function mapUnknownErrorToToolError(err) {
-    if (err instanceof Error) {
-        return { type: 'error', code: 'INTERNAL_ERROR', message: err.message, retry: { kind: 'not_retryable' } };
-    }
-    return { type: 'error', code: 'INTERNAL_ERROR', message: String(err), retry: { kind: 'not_retryable' } };
+function mapUnknownErrorToToolError(_err) {
+    return {
+        type: 'error',
+        code: 'INTERNAL_ERROR',
+        message: 'WorkRail encountered an unexpected error. This is not caused by your input.',
+        retry: { kind: 'not_retryable' },
+        details: { suggestion: (0, v2_execution_helpers_js_1.internalSuggestion)('Retry the call.', 'WorkRail has an internal error.') },
+    };
 }

package/dist/mcp/handler-factory.js

@@ -6,6 +6,7 @@ exports.createValidatingHandler = createValidatingHandler;
 const types_js_1 = require("./types.js");
 const index_js_1 = require("./validation/index.js");
 const bounded_json_js_1 = require("./validation/bounded-json.js");
+const v2_execution_helpers_js_1 = require("./handlers/v2-execution-helpers.js");
 function toMcpResult(result) {
     switch (result.type) {
         case 'success':
@@ -41,7 +42,13 @@ function createHandler(schema, handler) {
                 ...suggestionDetails,
             }));
         }
-        return toMcpResult(await handler(parseResult.data, ctx));
+        try {
+            return toMcpResult(await handler(parseResult.data, ctx));
+        }
+        catch (err) {
+            console.error('[WorkRail] Unhandled exception in tool handler:', err);
+            return toMcpResult((0, types_js_1.errNotRetryable)('INTERNAL_ERROR', 'WorkRail encountered an unexpected error. This is not caused by your input.', { suggestion: (0, v2_execution_helpers_js_1.internalSuggestion)('Retry the call.', 'WorkRail has an internal error.') }));
+        }
     };
 }
 function createValidatingHandler(schema, preValidate, handler) {