@exaudeus/workrail 3.7.1 → 3.7.3

package/dist/engine/engine-factory.js

@@ -240,7 +240,8 @@ async function createWorkRailEngine(config = {}) {
     engineActive = true;
     const engine = {
         async startWorkflow(workflowId) {
-            const result = await (0, start_js_1.executeStartWorkflow)({ workflowId }, v2Ctx);
+            const workspacePath = process.cwd();
+            const result = await (0, start_js_1.executeStartWorkflow)({ workflowId, workspacePath }, v2Ctx);
             if (result.isErr()) {
                 return (0, types_js_1.engineErr)(mapStartError(result.error));
             }
@@ -248,9 +249,11 @@ async function createWorkRailEngine(config = {}) {
         },
         async continueWorkflow(stateToken, ackToken, output, context) {
             const intent = ackToken ? 'advance' : 'rehydrate';
+            const workspacePath = process.cwd();
             const input = {
                 continueToken: (0, types_js_1.unwrapToken)(stateToken),
                 intent: intent,
+                ...(intent === 'rehydrate' ? { workspacePath } : {}),
                 ...(output ? {
                     output: {
                         notesMarkdown: output.notesMarkdown,

package/dist/manifest.json

@@ -438,8 +438,8 @@
       "bytes": 213
     },
     "engine/engine-factory.js": {
-      "sha256": "07d88be2ab8488615871ae363b9db4fc23caebba8231c8c2aaa2f97da2b18fdd",
-      "bytes": 13658
+      "sha256": "5461827b470642059198115f5248e97463db9bfb012f63971a4c7f69acda5b7c",
+      "bytes": 13841
     },
     "engine/index.d.ts": {
       "sha256": "91e12882c565e96a9809fdf43a0dc0a77fdffdfd562aaf43d2e86e6590ed0b16",
@@ -670,8 +670,8 @@
       "bytes": 883
     },
     "mcp/handler-factory.js": {
-      "sha256": "1216fe5e913c832242b3c9c2d9954441300b08660db59fe9deac8a4b7dc583db",
-      "bytes": 5310
+      "sha256": "6eb67d1501582d1cfcf777d7d930a6cf3cb32ccbd450c7083133745ef27d2661",
+      "bytes": 5381
     },
     "mcp/handlers/session.d.ts": {
       "sha256": "38926e69a0e4935d1dbcdc53848be9fff0e4d8f96827883da3216f217918fa82",
@@ -838,8 +838,8 @@
       "bytes": 3422
     },
     "mcp/handlers/v2-execution/start.js": {
-      "sha256": "593edf798bb1d2d0011ec81e4f170e4f4003b978cd9900fd785b583d15cd1085",
-      "bytes": 18014
+      "sha256": "e572eb50c6a0a30aa138620f32b04702727f07ce2570c29022d1027981c4bcef",
+      "bytes": 18496
     },
     "mcp/handlers/v2-reference-resolver.d.ts": {
       "sha256": "0b1d2640306b6a0c1067ca66bb20e6ec35d291b33dc328a78d5bfa8006394234",
@@ -862,8 +862,8 @@
       "bytes": 471
     },
     "mcp/handlers/v2-resume.js": {
-      "sha256": "726f92eb12aa0b28fafc4ceef354500dac7c4f18b85c4fe02a7997f869fe533f",
-      "bytes": 3612
+      "sha256": "536ba5db0c8fedf8a55c63a59eae4da5ad1cc793e4abf137a5ac9536e6514f68",
+      "bytes": 4140
     },
     "mcp/handlers/v2-state-conversion.d.ts": {
       "sha256": "94bd06904ef58dd210ff17ffb75c2492beea8937eb06d99749e5d860c0e0d96b",
@@ -914,12 +914,12 @@
       "bytes": 7991
     },
     "mcp/output-schemas.d.ts": {
-      "sha256": "450ac819bddaf668eb662b8327591df72b68d553fb16a7bd7797fadc68b8b8c8",
-      "bytes": 51526
+      "sha256": "191d696fd1c8d7dc8f1908c903f84117ceaed6c0aa323fb7606dd3566d739689",
+      "bytes": 53246
     },
     "mcp/output-schemas.js": {
-      "sha256": "73c8cd97868afd6f6e6f3deac1a3aabc38384f82c532be91bd5ea6ad2f744a49",
-      "bytes": 13044
+      "sha256": "28aa9b75ef6c21522b458bd4d05c55e28673510356f8f7e56eb1304544d35132",
+      "bytes": 14384
     },
     "mcp/render-envelope.d.ts": {
       "sha256": "22e83e1aba52968a7136cf289125a217b5f462a5a66a1eebe4669006e3326fdb",
@@ -942,8 +942,8 @@
       "bytes": 960
     },
     "mcp/server.js": {
-      "sha256": "1e5faf28495dff31b83b9f86ba07e05e14fb88c757f4e9e3460235f92c0602ab",
-      "bytes": 11642
+      "sha256": "9689ba068eaac9f36f328fa5429b5abe84bb8bd0062f0a59b60dc361dea09cd2",
+      "bytes": 11677
     },
     "mcp/step-content-envelope.d.ts": {
       "sha256": "19bd63c4d4de1d5d93393d346625d28ffd1bebdc320d4ba4e694cb740ec97d3b",
@@ -1058,12 +1058,12 @@
       "bytes": 2674
     },
     "mcp/v2-response-formatter.d.ts": {
-      "sha256": "b0dfb56016eabbc61fdb9d1f668d35c3fba7e8060b70be5aa74356ae0334ff0e",
-      "bytes": 438
+      "sha256": "3dd2bb5beef01afc8dca6b3df8bfd52283dc4393c5d85d2906a56bf4ae9806c9",
+      "bytes": 527
     },
     "mcp/v2-response-formatter.js": {
-      "sha256": "76615380b865b264d8c124231bae44d285ae738a17dc3b7b2ff5906c08eee646",
-      "bytes": 14437
+      "sha256": "308cc7c1fedd491f5d38607869d4b4e1196bfcf450835a53d52154827b323e23",
+      "bytes": 22402
     },
     "mcp/v2/tool-registry.d.ts": {
       "sha256": "d4d4927728c3cab1c014661d499dd0119538371bc6c5e821a4cd31df7abebedf",
@@ -1074,12 +1074,12 @@
       "bytes": 3276
     },
     "mcp/v2/tools.d.ts": {
-      "sha256": "8802e914f1eae0cfcd5b9b7838d00a3a87c8416c1ade1fce1ee57e7744bf64b9",
-      "bytes": 7010
+      "sha256": "93f1eac69e9d2be8ca354d714fbc64e3cea0e235e6669847677071d83a66450f",
+      "bytes": 7288
     },
     "mcp/v2/tools.js": {
-      "sha256": "a275de4ce4ccf31d429ce2c32f86169485676aad6f41cfe9babc3f00df2495a1",
-      "bytes": 8838
+      "sha256": "2b5d12d4de385ca8c530532d12467f113d58a09a808fe075896d2b1c0caa52ae",
+      "bytes": 10071
     },
     "mcp/validation/bounded-json.d.ts": {
       "sha256": "82203ac6123d5c6989606c3b5405aaea99ab829c8958835f9ae3ba45b8bc8fd5",
@@ -1150,8 +1150,8 @@
       "bytes": 1863
     },
     "mcp/workflow-protocol-contracts.js": {
-      "sha256": "715cf1dfa780a62b5b5dc08a3da9cbba3d444dc75c1d68db0b5c2ede804c5bd3",
-      "bytes": 12840
+      "sha256": "250fb814372bbf75a4cff9adc2d257da4cf0f4f480dac263860e74ebdd405246",
+      "bytes": 13981
     },
     "mcp/workflow-tool-edition-selector.d.ts": {
       "sha256": "75194908a89aaf7dc48fb661aea099827e7032ec76daf8f2de91bd59d46764ef",
@@ -1802,7 +1802,7 @@
       "bytes": 3397
     },
     "v2/durable-core/schemas/export-bundle/index.d.ts": {
-      "sha256": "a0c0c9c904b11e79f403bec154e118583709d1440916b7e30b1f3101b87acbf2",
+      "sha256": "6521642cefd019f75dba36890b71c20c5508e04baef584a09557a4b98f894321",
       "bytes": 479848
     },
     "v2/durable-core/schemas/export-bundle/index.js": {
@@ -1882,7 +1882,7 @@
       "bytes": 715
     },
     "v2/durable-core/schemas/session/manifest.d.ts": {
-      "sha256": "3eff60c200f81c87bb0e0946ba23000bc30fdd98678d316e5a401c189612408b",
+      "sha256": "82840f71d8cde0d10834fe411c9ea494e043af93637c4ffb9c14fdf27bbb1b8c",
       "bytes": 1594
     },
     "v2/durable-core/schemas/session/manifest.js": {
@@ -1938,7 +1938,7 @@
       "bytes": 4205
     },
     "v2/durable-core/tokens/payloads.d.ts": {
-      "sha256": "f0428631b6addaa4c842a1abb4d9e4b1f26cb647b6f42a99060114ccb64eab28",
+      "sha256": "4b84627aeee7c8f6d4c142e9ffb3511674d74d012601731d81193dfd6b95ba1c",
       "bytes": 6921
     },
     "v2/durable-core/tokens/payloads.js": {
@@ -2114,12 +2114,12 @@
       "bytes": 28456
     },
     "v2/infra/local/session-summary-provider/index.d.ts": {
-      "sha256": "59db8bf5e38f983eedd21ff902a24324f7bedbb5f3eade1e4b0d5742b28447c2",
-      "bytes": 1004
+      "sha256": "291d1303ef9f1ee0889830c5b42964a2d9b8c7d27b36a9b55d710ca5950c32ca",
+      "bytes": 1136
     },
     "v2/infra/local/session-summary-provider/index.js": {
-      "sha256": "1d8a543361c582f6e089f63f24318ff7caf97a78659ecdc5b89152b78d18c6aa",
-      "bytes": 5942
+      "sha256": "504d432a35b3ceb75697c00b5db1576570b38c1415304f903ba77d0dfed04ce7",
+      "bytes": 10452
     },
     "v2/infra/local/sha256/index.d.ts": {
       "sha256": "8a727b7e54a38275ca6f9f1b8730f97cfc0a212df035df1bdc58e716e6824230",
@@ -2166,8 +2166,8 @@
       "bytes": 537
     },
     "v2/infra/local/workspace-anchor/index.js": {
-      "sha256": "a0fe032a9205606c6d592221f1300a3113c7d0cb3e126e458fef3dc8fa6e823c",
-      "bytes": 2272
+      "sha256": "d76172ecbe3457760abc0b6f0032eb4089758fb3c9ed473ba0f134ac57d37c1a",
+      "bytes": 2993
     },
     "v2/ports/base32.port.d.ts": {
       "sha256": "64aa2f2003a552917cbf71474472fc5e4afffaa29577204bbcbe5ffa989ceb82",
@@ -2386,12 +2386,12 @@
       "bytes": 732
     },
     "v2/projections/resume-ranking.d.ts": {
-      "sha256": "ff128aa669f995b350a1e4ee8da6f0321f999d492e23975816d3f70caefa4dbb",
-      "bytes": 2595
+      "sha256": "b1d9e7d6fb3e59ced42f7c2e5fd9d8f9a18308aa6f4411a8aabf5dc174aa8dad",
+      "bytes": 3960
     },
     "v2/projections/resume-ranking.js": {
-      "sha256": "381dbac1868bc88bdfa3e3c13da94b1392ba3858f2bc86cc3c4331e919aac899",
-      "bytes": 4300
+      "sha256": "1b256c992ded9ec52150b229799716d118ca2a3659a0cc523e727cde2ebf7b0c",
+      "bytes": 13660
     },
     "v2/projections/run-context.d.ts": {
       "sha256": "a4d57470a435ac9860f60b3244d1b828853995027cd510d8da42762d21b2a687",
@@ -2458,12 +2458,12 @@
       "bytes": 77
     },
     "v2/usecases/enumerate-sessions.d.ts": {
-      "sha256": "46da8960bdeb154f79dee443425260f3ce18c50a0db01e7ab60700432d864857",
-      "bytes": 699
+      "sha256": "230eda9e0f377741cb9018edba4b8c26cecde9439e2db68b249b0cab3e9e50aa",
+      "bytes": 809
     },
     "v2/usecases/enumerate-sessions.js": {
-      "sha256": "4ae73f47c1e8ebea0d9a48dc786e5e4d0442a38827c427378712e9d198410ae2",
-      "bytes": 1050
+      "sha256": "7fd54b65e914487ea0cfbc60e7059aa1134b3f9850ae2af0fdba340f9aa0b282",
+      "bytes": 1091
     },
     "v2/usecases/execution-session-gate.d.ts": {
       "sha256": "339c4a8e02a77416e725e063a57d39a20788244498ae2c7a31dc48d111af6280",

package/dist/mcp/handler-factory.js

@@ -14,7 +14,7 @@ function toMcpResult(result) {
     switch (result.type) {
         case 'success': {
             if (!jsonResponsesOverride) {
-                const formatted = (0, v2_response_formatter_js_1.formatV2ExecutionResponse)(result.data);
+                const formatted = (0, v2_response_formatter_js_1.formatV2ExecutionResponse)(result.data) ?? (0, v2_response_formatter_js_1.formatV2ResumeResponse)(result.data);
                 if (formatted !== null) {
                     const content = [{ type: 'text', text: formatted.primary }];
                     if (formatted.references != null) {

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

@@ -212,15 +212,24 @@ function mintStartTokens(args) {
 }
 function executeStartWorkflow(input, ctx) {
     const { gate, sessionStore, snapshotStore, pinnedStore, crypto, tokenCodecPorts, idFactory, validationPipelineDeps, tokenAliasStore, entropy } = ctx.v2;
-    const workflowReader = (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
+    const shouldUseRequestReader = ctx.featureFlags != null && (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
         workspacePath: input.workspacePath,
         resolvedRootUris: ctx.v2.resolvedRootUris,
-    })
-        ? (0, request_workflow_reader_js_1.createWorkflowReaderForRequest)({
-            featureFlags: ctx.featureFlags,
-            workspacePath: input.workspacePath,
-            resolvedRootUris: ctx.v2.resolvedRootUris,
-        })
+    });
+    const workflowReader = shouldUseRequestReader
+        ? {
+            getWorkflowById: async (workflowId) => {
+                const requestReader = (0, request_workflow_reader_js_1.createWorkflowReaderForRequest)({
+                    featureFlags: ctx.featureFlags,
+                    workspacePath: input.workspacePath,
+                    resolvedRootUris: ctx.v2.resolvedRootUris,
+                });
+                const requestResult = await requestReader.getWorkflowById(workflowId);
+                if (requestResult != null)
+                    return requestResult;
+                return ctx.workflowService.getWorkflowById(workflowId);
+            },
+        }
         : ctx.workflowService;
     return loadAndPinWorkflow({
         workflowId: input.workflowId,

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

@@ -24,7 +24,11 @@ async function handleV2ResumeSession(input, ctx) {
     const query = {
         gitHeadSha: input.gitHeadSha ?? anchorValue(anchors, 'git_head_sha'),
         gitBranch: input.gitBranch ?? anchorValue(anchors, 'git_branch'),
+        repoRootHash: anchorValue(anchors, 'repo_root_hash'),
+        sameWorkspaceOnly: input.sameWorkspaceOnly,
         freeTextQuery: input.query,
+        runId: input.runId,
+        sessionId: input.sessionId,
     };
     const resumeResult = await (0, resume_session_js_1.resumeSession)(query, v2.sessionSummaryProvider);
     if (resumeResult.isErr()) {
@@ -72,9 +76,16 @@ function mintCandidateTokens(candidates, ports) {
             sessionId: candidate.sessionId,
             runId: candidate.runId,
             workflowId: candidate.workflowId,
+            sessionTitle: candidate.sessionTitle,
+            gitBranch: candidate.gitBranch,
             resumeToken: resumeTokenRes.value,
             snippet: candidate.snippet,
             whyMatched: [...candidate.whyMatched],
+            confidence: candidate.confidence,
+            matchExplanation: candidate.matchExplanation,
+            pendingStepId: candidate.pendingStepId,
+            isComplete: candidate.isComplete,
+            lastModifiedMs: candidate.lastModifiedMs,
             nextCall: {
                 tool: 'continue_workflow',
                 params: { continueToken: resumeTokenRes.value, intent: 'rehydrate' },

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

@@ -1160,9 +1160,16 @@ export declare const V2ResumeSessionOutputSchema: z.ZodObject<{
         sessionId: z.ZodString;
         runId: z.ZodString;
         workflowId: z.ZodString;
+        sessionTitle: z.ZodNullable<z.ZodString>;
+        gitBranch: z.ZodNullable<z.ZodString>;
         resumeToken: z.ZodString;
         snippet: z.ZodString;
-        whyMatched: z.ZodArray<z.ZodEnum<["matched_head_sha", "matched_branch", "matched_notes", "matched_workflow_id", "recency_fallback"]>, "many">;
+        confidence: z.ZodEnum<["strong", "medium", "weak"]>;
+        matchExplanation: z.ZodString;
+        pendingStepId: z.ZodNullable<z.ZodString>;
+        isComplete: z.ZodBoolean;
+        lastModifiedMs: z.ZodNullable<z.ZodNumber>;
+        whyMatched: z.ZodArray<z.ZodEnum<["matched_exact_id", "matched_notes", "matched_notes_partial", "matched_workflow_id", "matched_head_sha", "matched_branch", "matched_repo_root", "recency_fallback"]>, "many">;
         nextCall: z.ZodObject<{
             tool: z.ZodLiteral<"continue_workflow">;
             params: z.ZodObject<{
@@ -1189,9 +1196,12 @@ export declare const V2ResumeSessionOutputSchema: z.ZodObject<{
             tool: "continue_workflow";
         }>;
     }, "strip", z.ZodTypeAny, {
+        confidence: "strong" | "weak" | "medium";
         workflowId: string;
-        sessionId: string;
         runId: string;
+        sessionId: string;
+        gitBranch: string | null;
+        isComplete: boolean;
         nextCall: {
             params: {
                 continueToken: string;
@@ -1199,13 +1209,20 @@ export declare const V2ResumeSessionOutputSchema: z.ZodObject<{
             };
             tool: "continue_workflow";
         };
+        sessionTitle: string | null;
         resumeToken: string;
         snippet: string;
-        whyMatched: ("matched_head_sha" | "matched_branch" | "matched_notes" | "matched_workflow_id" | "recency_fallback")[];
+        matchExplanation: string;
+        pendingStepId: string | null;
+        lastModifiedMs: number | null;
+        whyMatched: ("matched_exact_id" | "matched_notes" | "matched_notes_partial" | "matched_workflow_id" | "matched_head_sha" | "matched_branch" | "matched_repo_root" | "recency_fallback")[];
     }, {
+        confidence: "strong" | "weak" | "medium";
         workflowId: string;
-        sessionId: string;
         runId: string;
+        sessionId: string;
+        gitBranch: string | null;
+        isComplete: boolean;
         nextCall: {
             params: {
                 continueToken: string;
@@ -1213,16 +1230,23 @@ export declare const V2ResumeSessionOutputSchema: z.ZodObject<{
             };
             tool: "continue_workflow";
         };
+        sessionTitle: string | null;
         resumeToken: string;
         snippet: string;
-        whyMatched: ("matched_head_sha" | "matched_branch" | "matched_notes" | "matched_workflow_id" | "recency_fallback")[];
+        matchExplanation: string;
+        pendingStepId: string | null;
+        lastModifiedMs: number | null;
+        whyMatched: ("matched_exact_id" | "matched_notes" | "matched_notes_partial" | "matched_workflow_id" | "matched_head_sha" | "matched_branch" | "matched_repo_root" | "recency_fallback")[];
     }>, "many">;
     totalEligible: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     candidates: {
+        confidence: "strong" | "weak" | "medium";
         workflowId: string;
-        sessionId: string;
         runId: string;
+        sessionId: string;
+        gitBranch: string | null;
+        isComplete: boolean;
         nextCall: {
             params: {
                 continueToken: string;
@@ -1230,16 +1254,23 @@ export declare const V2ResumeSessionOutputSchema: z.ZodObject<{
             };
             tool: "continue_workflow";
         };
+        sessionTitle: string | null;
         resumeToken: string;
         snippet: string;
-        whyMatched: ("matched_head_sha" | "matched_branch" | "matched_notes" | "matched_workflow_id" | "recency_fallback")[];
+        matchExplanation: string;
+        pendingStepId: string | null;
+        lastModifiedMs: number | null;
+        whyMatched: ("matched_exact_id" | "matched_notes" | "matched_notes_partial" | "matched_workflow_id" | "matched_head_sha" | "matched_branch" | "matched_repo_root" | "recency_fallback")[];
     }[];
     totalEligible: number;
 }, {
     candidates: {
+        confidence: "strong" | "weak" | "medium";
         workflowId: string;
-        sessionId: string;
         runId: string;
+        sessionId: string;
+        gitBranch: string | null;
+        isComplete: boolean;
         nextCall: {
             params: {
                 continueToken: string;
@@ -1247,9 +1278,13 @@ export declare const V2ResumeSessionOutputSchema: z.ZodObject<{
             };
             tool: "continue_workflow";
         };
+        sessionTitle: string | null;
         resumeToken: string;
         snippet: string;
-        whyMatched: ("matched_head_sha" | "matched_branch" | "matched_notes" | "matched_workflow_id" | "recency_fallback")[];
+        matchExplanation: string;
+        pendingStepId: string | null;
+        lastModifiedMs: number | null;
+        whyMatched: ("matched_exact_id" | "matched_notes" | "matched_notes_partial" | "matched_workflow_id" | "matched_head_sha" | "matched_branch" | "matched_repo_root" | "recency_fallback")[];
     }[];
     totalEligible: number;
 }>;

package/dist/mcp/output-schemas.js

@@ -242,16 +242,29 @@ exports.V2ResumeSessionOutputSchema = zod_1.z.object({
         sessionId: zod_1.z.string().min(1),
         runId: zod_1.z.string().min(1),
         workflowId: zod_1.z.string().min(1),
+        sessionTitle: zod_1.z.string().nullable().describe('Human-readable task/session title derived from persisted workflow context or early recap text.'),
+        gitBranch: zod_1.z.string().nullable().describe('Git branch associated with the session, if available.'),
         resumeToken: zod_1.z.string().regex(token_patterns_js_1.STATE_TOKEN_PATTERN, 'Invalid resumeToken format'),
         snippet: zod_1.z.string().max(1024),
+        confidence: zod_1.z.enum(['strong', 'medium', 'weak']).describe('Coarse confidence band for how likely this candidate is the intended session.'),
+        matchExplanation: zod_1.z.string().min(1).describe('Short natural-language explanation of why this candidate ranked here.'),
+        pendingStepId: zod_1.z.string().nullable().describe('The current pending step ID (e.g. "phase-3-implement") if the workflow is in progress. ' +
+            'Null if the workflow is complete or the step could not be determined.'),
+        isComplete: zod_1.z.boolean().describe('Whether the workflow run has completed. Completed sessions are deprioritized in ranking.'),
+        lastModifiedMs: zod_1.z.number().nullable().describe('Filesystem modification time (epoch ms) of the session. Null if unavailable.'),
         whyMatched: zod_1.z.array(zod_1.z.enum([
-            'matched_head_sha',
-            'matched_branch',
+            'matched_exact_id',
             'matched_notes',
+            'matched_notes_partial',
             'matched_workflow_id',
+            'matched_head_sha',
+            'matched_branch',
+            'matched_repo_root',
             'recency_fallback',
         ])).describe('Match signals explaining why this candidate was ranked. ' +
-            'matched_head_sha/branch/notes/workflow_id = strong signal. ' +
+            'matched_exact_id and matched_notes are strongest. ' +
+            'matched_notes_partial/matched_workflow_id are moderate text signals. ' +
+            'matched_repo_root/head_sha/branch are workspace-context signals. ' +
             'recency_fallback = no strong signal; inspect the snippet before resuming.'),
         nextCall: exports.V2ResumeNextCallSchema,
     })).max(5),

package/dist/mcp/server.js

@@ -129,6 +129,7 @@ async function createToolContext() {
                     directoryListing,
                     dataDir,
                     sessionStore,
+                    snapshotStore,
                 }),
             };
             console.error('[FeatureFlags] v2 tools enabled');

package/dist/mcp/v2/tools.d.ts

@@ -24,13 +24,13 @@ export declare const V2InspectWorkflowInput: z.ZodObject<{
 export type V2InspectWorkflowInput = z.infer<typeof V2InspectWorkflowInput>;
 export declare const V2StartWorkflowInput: z.ZodObject<{
     workflowId: z.ZodString;
-    workspacePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    workspacePath: z.ZodEffects<z.ZodString, string, string>;
 }, "strip", z.ZodTypeAny, {
     workflowId: string;
-    workspacePath?: string | undefined;
+    workspacePath: string;
 }, {
     workflowId: string;
-    workspacePath?: string | undefined;
+    workspacePath: string;
 }>;
 export type V2StartWorkflowInput = z.infer<typeof V2StartWorkflowInput>;
 export declare const V2ContinueWorkflowInputShape: z.ZodObject<{
@@ -147,19 +147,28 @@ export declare const V2ContinueWorkflowInput: z.ZodEffects<z.ZodEffects<z.ZodObj
 export type V2ContinueWorkflowInput = z.infer<typeof V2ContinueWorkflowInput>;
 export declare const V2ResumeSessionInput: z.ZodObject<{
     query: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
     gitBranch: z.ZodOptional<z.ZodString>;
     gitHeadSha: z.ZodOptional<z.ZodString>;
-    workspacePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    workspacePath: z.ZodEffects<z.ZodString, string, string>;
+    sameWorkspaceOnly: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
-    workspacePath?: string | undefined;
+    workspacePath: string;
     query?: string | undefined;
+    runId?: string | undefined;
+    sessionId?: string | undefined;
     gitBranch?: string | undefined;
     gitHeadSha?: string | undefined;
+    sameWorkspaceOnly?: boolean | undefined;
 }, {
-    workspacePath?: string | undefined;
+    workspacePath: string;
     query?: string | undefined;
+    runId?: string | undefined;
+    sessionId?: string | undefined;
     gitBranch?: string | undefined;
     gitHeadSha?: string | undefined;
+    sameWorkspaceOnly?: boolean | undefined;
 }>;
 export type V2ResumeSessionInput = z.infer<typeof V2ResumeSessionInput>;
 export declare const V2CheckpointWorkflowInput: z.ZodObject<{

package/dist/mcp/v2/tools.js

@@ -1,26 +1,33 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.V2_TOOL_ANNOTATIONS = exports.V2_TOOL_TITLES = exports.V2CheckpointWorkflowInput = exports.V2ResumeSessionInput = exports.V2ContinueWorkflowInput = exports.V2ContinueWorkflowInputShape = exports.V2StartWorkflowInput = exports.V2InspectWorkflowInput = exports.V2ListWorkflowsInput = void 0;
+const path_1 = __importDefault(require("path"));
 const zod_1 = require("zod");
 const workflow_protocol_contracts_js_1 = require("../workflow-protocol-contracts.js");
+function isAbsoluteWorkspacePath(p) {
+    return path_1.default.isAbsolute(p);
+}
 const workspacePathField = zod_1.z.string()
-    .refine((p) => p.startsWith('/'), 'workspacePath must be an absolute path (starting with /)')
-    .optional()
+    .refine((p) => isAbsoluteWorkspacePath(p), 'workspacePath must be an absolute path')
     .describe('Absolute path to your current workspace directory (e.g. the "Workspace:" value from your system parameters). Used to resolve project-scoped workflow variants against the correct workspace. If omitted, WorkRail uses MCP roots when available, then falls back to the server process directory.');
+const optionalWorkspacePathField = workspacePathField.optional();
 exports.V2ListWorkflowsInput = zod_1.z.object({
-    workspacePath: workspacePathField,
+    workspacePath: optionalWorkspacePathField,
 });
 exports.V2InspectWorkflowInput = zod_1.z.object({
     workflowId: zod_1.z.string().min(1).regex(/^[A-Za-z0-9_-]+$/, 'Workflow ID must contain only letters, numbers, hyphens, and underscores').describe('The workflow ID to inspect'),
     mode: zod_1.z.enum(['metadata', 'preview']).default('preview').describe('Detail level: metadata (name and description only) or preview (full step-by-step breakdown, default)'),
-    workspacePath: workspacePathField,
+    workspacePath: optionalWorkspacePathField,
 });
 exports.V2StartWorkflowInput = zod_1.z.object({
     workflowId: zod_1.z.string().min(1).regex(/^[A-Za-z0-9_-]+$/, 'Workflow ID must contain only letters, numbers, hyphens, and underscores').describe('The workflow ID to start'),
-    workspacePath: workspacePathField.describe('Absolute path to your current workspace directory (e.g. the "Workspace:" value from your system parameters). Used to resolve the correct project-scoped workflow variant and to anchor this session to your workspace for future resume_session discovery. Pass this on every start_workflow call. If omitted, WorkRail uses MCP roots when available, then falls back to the server process directory.'),
+    workspacePath: workspacePathField.describe('Required. Absolute path to your current workspace directory (e.g. the "Workspace:" value from your system parameters). WorkRail uses this to resolve the correct project-scoped workflow variant and to anchor the session to the correct repo for future resume_session discovery. Shared MCP servers cannot infer this safely.'),
 });
 exports.V2ContinueWorkflowInputShape = zod_1.z.object({
-    workspacePath: workspacePathField,
+    workspacePath: optionalWorkspacePathField,
     continueToken: zod_1.z.string().min(1).describe('The token for your next continue_workflow call. Two valid token kinds: ' +
         '(1) A continueToken (ct_...) from start_workflow or a previous continue_workflow — carries session identity AND advance authority. ' +
         '(2) A resumeToken (st_...) from resume_session or checkpoint_workflow — carries session identity only; valid for intent: "rehydrate", not "advance". ' +
@@ -69,6 +76,13 @@ exports.V2ContinueWorkflowInput = exports.V2ContinueWorkflowInputShape
                 'Rehydration is read-only state recovery — it does not accept output.',
         });
     }
+    if (data.intent === 'rehydrate' && data.workspacePath === undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['workspacePath'],
+            message: 'workspacePath is required for rehydration. Shared WorkRail servers cannot safely infer your current workspace, so pass the absolute "Workspace:" path from your system parameters.',
+        });
+    }
 })
     .transform((data) => {
     const normalized = workflow_protocol_contracts_js_1.CONTINUE_WORKFLOW_PROTOCOL.aliasMap
@@ -85,13 +99,17 @@ exports.V2ContinueWorkflowInput = exports.V2ContinueWorkflowInputShape
 });
 exports.V2ResumeSessionInput = zod_1.z.object({
     query: zod_1.z.string().min(1).max(256).optional().describe('Free text search to find a relevant session. Matches against recap notes and workflow IDs. ' +
+        'Tip: use the user\'s exact words (e.g. "mr ownership", "ACEI-1234"). ' +
         'Without query, only git-context matching runs — the semantic (notes) tier is skipped.'),
+    runId: zod_1.z.string().regex(/^run_[a-z0-9]+$/).optional().describe('Exact run ID to find (e.g. "run_tbi2ag7njfjgc2aitt4qg5eaiq"). ' +
+        'When provided, the matching session is returned as the sole top-priority candidate.'),
+    sessionId: zod_1.z.string().regex(/^sess_[a-zA-Z0-9_]+$/).optional().describe('Exact session ID to find (e.g. "sess_s5o2ieem4mwypoqnn6ztzyyag4"). ' +
+        'When provided, the matching session is returned as the sole top-priority candidate.'),
     gitBranch: zod_1.z.string().max(256).optional().describe('Git branch name to match against session observations. Overrides auto-detected branch.'),
     gitHeadSha: zod_1.z.string().regex(/^[0-9a-f]{40}$/).optional().describe('Git HEAD SHA to match against session observations. Overrides auto-detected HEAD.'),
-    workspacePath: zod_1.z.string()
-        .refine((p) => p.startsWith('/'), 'workspacePath must be an absolute path (starting with /)')
-        .optional()
-        .describe('Absolute path to your current workspace directory (e.g. the "Workspace:" value from your system parameters). Used to resolve your git branch and HEAD SHA for workspace-aware session matching. Pass the same path used in the original start_workflow call. If omitted, WorkRail uses the server process directory which may not match your workspace.'),
+    workspacePath: workspacePathField.describe('Required. Absolute path to your current workspace directory (e.g. the "Workspace:" value from your system parameters). WorkRail uses this to identify the current repo and resume the correct session on shared MCP servers.'),
+    sameWorkspaceOnly: zod_1.z.boolean().optional().describe('If true, only sessions from the same repo/workspace are considered when repo_root_hash is available. ' +
+        'Use this when the user clearly means "resume work from this repo only".'),
 }).strict();
 exports.V2CheckpointWorkflowInput = zod_1.z.object({
     checkpointToken: zod_1.z.string().min(1).describe('The checkpoint token from the most recent start_workflow or continue_workflow response. ' +

package/dist/mcp/v2-response-formatter.d.ts

@@ -9,3 +9,4 @@ export interface FormattedResponse {
     readonly supplements?: readonly FormattedSupplement[];
 }
 export declare function formatV2ExecutionResponse(data: unknown): FormattedResponse | null;
+export declare function formatV2ResumeResponse(data: unknown): FormattedResponse | null;