@exaudeus/workrail 3.7.1 → 3.7.3

package/dist/mcp/v2-response-formatter.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatV2ExecutionResponse = formatV2ExecutionResponse;
+exports.formatV2ResumeResponse = formatV2ResumeResponse;
 const render_envelope_js_1 = require("./render-envelope.js");
 const response_supplements_js_1 = require("./response-supplements.js");
 function isV2ExecutionResponse(data) {
@@ -388,3 +389,170 @@ function formatV2Clean(data) {
         primary: formatCleanSuccess(data),
     };
 }
+function isResumeSessionResponse(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const d = data;
+    return (Array.isArray(d.candidates) &&
+        typeof d.totalEligible === 'number' &&
+        !('pending' in d) &&
+        !('nextIntent' in d));
+}
+const WHY_MATCHED_LABELS = {
+    matched_exact_id: 'Exact ID match',
+    matched_notes: 'Query matched session notes',
+    matched_notes_partial: 'Query partially matched session notes',
+    matched_workflow_id: 'Query matched workflow type',
+    matched_head_sha: 'Same git commit (HEAD SHA)',
+    matched_branch: 'Same git branch',
+    matched_repo_root: 'Same workspace/repository',
+    recency_fallback: 'No strong match signal (recent session)',
+};
+function formatRelativeTime(epochMs) {
+    const diffMs = Date.now() - epochMs;
+    if (diffMs < 0)
+        return 'just now';
+    const minutes = Math.floor(diffMs / 60000);
+    if (minutes < 1)
+        return 'just now';
+    if (minutes < 60)
+        return `${minutes} minute${minutes === 1 ? '' : 's'} ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours} hour${hours === 1 ? '' : 's'} ago`;
+    const days = Math.floor(hours / 24);
+    if (days < 7)
+        return `${days} day${days === 1 ? '' : 's'} ago`;
+    const weeks = Math.floor(days / 7);
+    if (weeks < 5)
+        return `${weeks} week${weeks === 1 ? '' : 's'} ago`;
+    const months = Math.floor(days / 30);
+    return `${months} month${months === 1 ? '' : 's'} ago`;
+}
+function formatResumeCandidate(c, index) {
+    const lines = [];
+    const matchLabel = c.whyMatched.map(w => WHY_MATCHED_LABELS[w] ?? w).join(', ');
+    const isWeak = c.whyMatched.every(w => w === 'recency_fallback');
+    const statusTag = c.isComplete ? ' (completed)' : '';
+    const heading = c.sessionTitle?.trim() || c.workflowId;
+    lines.push(`### Candidate ${index + 1}: \`${heading}\`${statusTag}${isWeak ? ' (weak match)' : ''}`);
+    lines.push(`- **Session**: \`${c.sessionId}\``);
+    lines.push(`- **Run**: \`${c.runId}\``);
+    lines.push(`- **Workflow**: \`${c.workflowId}\``);
+    lines.push(`- **Match reason**: ${matchLabel}`);
+    if (c.confidence) {
+        lines.push(`- **Confidence**: ${c.confidence}`);
+    }
+    if (c.matchExplanation) {
+        lines.push(`- **Why this ranked here**: ${c.matchExplanation}`);
+    }
+    if (c.gitBranch) {
+        lines.push(`- **Branch**: \`${c.gitBranch}\``);
+    }
+    if (c.pendingStepId) {
+        lines.push(`- **Current step**: \`${c.pendingStepId}\``);
+    }
+    else if (c.isComplete) {
+        lines.push('- **Status**: Workflow completed');
+    }
+    if (c.lastModifiedMs != null) {
+        lines.push(`- **Last active**: ${formatRelativeTime(c.lastModifiedMs)}`);
+    }
+    if (c.snippet) {
+        const preview = c.snippet.length > 200 ? c.snippet.slice(0, 200) + '...' : c.snippet;
+        lines.push(`- **Preview**: ${preview.replace(/\n/g, ' ')}`);
+    }
+    else {
+        lines.push('- **Preview**: (no recap notes available)');
+    }
+    if (c.isComplete) {
+        lines.push('');
+        lines.push('> This workflow has already completed. Resuming it will show the final state.');
+    }
+    lines.push('');
+    lines.push('To inspect or resume this candidate, call `continue_workflow` with:');
+    lines.push('```json');
+    lines.push(JSON.stringify(c.nextCall.params, null, 2));
+    lines.push('```');
+    lines.push('This `rehydrate` call restores the exact workflow state and shows the current step/context.');
+    return lines.join('\n');
+}
+const SEARCH_PARAMS_HELP = [
+    '**To narrow results, call `resume_session` again with any of these parameters:**',
+    '- `query`: Free text keywords from the session (e.g. "mr ownership", "ACEI-1234", "login feature")',
+    '- `runId`: Exact run ID if the user has one (e.g. "run_abc123def456")',
+    '- `sessionId`: Exact session ID if the user has one (e.g. "sess_abc123")',
+    '- `workspacePath`: Absolute path to the workspace (helps match by git branch/commit)',
+    '- `sameWorkspaceOnly`: Restrict results to the current repo/workspace when that is clearly what the user means',
+].join('\n');
+function formatV2ResumeResponse(data) {
+    if (!isResumeSessionResponse(data))
+        return null;
+    const { candidates, totalEligible } = data;
+    const lines = [];
+    if (candidates.length === 0) {
+        lines.push('## No Resumable Sessions Found');
+        lines.push('');
+        lines.push(`Searched ${totalEligible} session(s) but none matched your query or workspace context.`);
+        lines.push('');
+        lines.push('**What to do**: Ask the user for more details about which session they want to resume. They might know:');
+        lines.push('- A description of what they were working on (pass as `query`)');
+        lines.push('- A run ID or session ID (pass as `runId` or `sessionId`)');
+        lines.push('- Or start a fresh workflow with `start_workflow`.');
+        lines.push('');
+        lines.push(SEARCH_PARAMS_HELP);
+        return { primary: lines.join('\n') };
+    }
+    const hasStrongMatch = candidates.some(c => !c.whyMatched.every(w => w === 'recency_fallback'));
+    const allRecencyFallback = !hasStrongMatch;
+    if (allRecencyFallback) {
+        lines.push('## Recent Workflow Sessions');
+        lines.push('');
+        lines.push(`No specific search criteria matched, so here are the **${candidates.length} most recent** sessions (out of ${totalEligible} total).`);
+        lines.push('');
+        lines.push('**Action required**: Present these to the user and ask which one they want to resume. If none of these are right, ask the user to describe what they were working on so you can search more specifically.');
+        lines.push('');
+        for (let i = 0; i < candidates.length; i++) {
+            lines.push(formatResumeCandidate(candidates[i], i));
+            lines.push('');
+        }
+        if (totalEligible > candidates.length) {
+            lines.push('---');
+            lines.push(`${totalEligible - candidates.length} more session(s) not shown.`);
+            lines.push('');
+        }
+        lines.push(SEARCH_PARAMS_HELP);
+    }
+    else {
+        lines.push('## Resumable Workflow Sessions');
+        lines.push('');
+        lines.push(`Found **${totalEligible}** session(s) total. Showing the top ${candidates.length} ranked by match strength.`);
+        lines.push('');
+        const allWorkspaceDriven = candidates.every((c) => c.whyMatched.every((w) => w === 'matched_head_sha' || w === 'matched_branch'));
+        if (allWorkspaceDriven) {
+            lines.push('**Note**: These candidates are ranked primarily from current workspace git context (branch/commit), not from a strong text match on your query.');
+            lines.push('If the previews do not clearly match the user\'s request, inspect a candidate with `continue_workflow(..., intent: "rehydrate")` or ask for a more specific phrase / session ID.');
+            lines.push('');
+        }
+        const best = candidates[0];
+        const bestIsExact = best.whyMatched.includes('matched_exact_id');
+        if (bestIsExact) {
+            lines.push(`**Recommendation**: Candidate 1 is an exact ID match. Resume it directly.`);
+        }
+        else {
+            lines.push(`**Recommendation**: Candidate 1 has the strongest match signal. Present the top candidates to the user and let them confirm which one to resume.`);
+        }
+        lines.push('');
+        for (let i = 0; i < candidates.length; i++) {
+            lines.push(formatResumeCandidate(candidates[i], i));
+            lines.push('');
+        }
+        if (totalEligible > candidates.length) {
+            lines.push('---');
+            lines.push(`${totalEligible - candidates.length} more session(s) not shown.`);
+            lines.push('');
+            lines.push(SEARCH_PARAMS_HELP);
+        }
+    }
+    return { primary: lines.join('\n') };
+}

package/dist/mcp/workflow-protocol-contracts.js

@@ -46,8 +46,8 @@ function findAliasFieldConflicts(value, aliasMap) {
 }
 exports.START_WORKFLOW_PROTOCOL = {
     canonicalParams: {
-        required: ['workflowId'],
-        optional: ['workspacePath'],
+        required: ['workflowId', 'workspacePath'],
+        optional: [],
     },
     descriptions: {
         standard: {
@@ -56,6 +56,7 @@ exports.START_WORKFLOW_PROTOCOL = {
             rules: [
                 'Follow the returned step exactly; treat it as the user\'s current instruction.',
                 'When the step is done, call continue_workflow with the returned continueToken.',
+                'Always pass workspacePath. Shared MCP servers cannot safely infer which repo/workspace you mean.',
                 'Only pass context on later continue_workflow calls if facts changed.',
             ],
             examplePayload: {
@@ -70,7 +71,7 @@ exports.START_WORKFLOW_PROTOCOL = {
             rules: [
                 'Execute the returned step exactly as written.',
                 'When the step is complete, call continue_workflow with the returned continueToken.',
-                'Pass workspacePath when available so WorkRail anchors the session to the correct workspace.',
+                'Pass workspacePath on every call. Shared MCP servers cannot safely infer the correct workspace.',
             ],
             examplePayload: {
                 workflowId: 'coding-task-workflow-agentic',
@@ -83,7 +84,7 @@ exports.START_WORKFLOW_PROTOCOL = {
 exports.CONTINUE_WORKFLOW_PROTOCOL = {
     canonicalParams: {
         required: ['continueToken'],
-        optional: ['intent', 'context', 'output'],
+        optional: ['intent', 'context', 'output', 'workspacePath'],
     },
     aliasMap: {
         contextVariables: 'context',
@@ -95,6 +96,7 @@ exports.CONTINUE_WORKFLOW_PROTOCOL = {
             rules: [
                 'Advance by sending output (and intent: "advance" if you want to be explicit).',
                 'Rehydrate by omitting output (and intent: "rehydrate" if you want to be explicit).',
+                'When rehydrating, always pass workspacePath so WorkRail can restore the correct repo/workspace context on shared servers.',
                 'Put changed facts under context only.',
                 'Round-trip continueToken exactly as returned by WorkRail; use the single-token API only.',
                 'Notes (output.notesMarkdown): write for a human reader. Include what you did and key decisions, what you produced (files, tests, numbers), and anything notable (risks, open questions, deliberate omissions). Use markdown headings, bullets, bold, code refs. Be specific. Scope: THIS step only (WorkRail concatenates automatically). 10-30 lines ideal. Omitting notes blocks the step.',
@@ -114,6 +116,7 @@ exports.CONTINUE_WORKFLOW_PROTOCOL = {
                 'Use continueToken exactly as returned by WorkRail.',
                 'Use the single-token API only.',
                 'Advance by sending output; rehydrate by omitting output.',
+                'For rehydrate calls, pass workspacePath so WorkRail can restore the correct workspace context.',
                 'Put updated facts in context only.',
                 'Notes (output.notesMarkdown): write for a human reader. Include what you did and key decisions, what you produced (files, tests, numbers), and anything notable (risks, open questions, deliberate omissions). Use markdown headings, bullets, bold, code refs. Be specific. Scope: THIS step only (WorkRail concatenates automatically). 10-30 lines ideal. Omitting notes blocks the step.',
             ],
@@ -164,43 +167,43 @@ exports.CHECKPOINT_WORKFLOW_PROTOCOL = {
 };
 exports.RESUME_SESSION_PROTOCOL = {
     canonicalParams: {
-        required: [],
-        optional: ['query', 'gitBranch', 'gitHeadSha', 'workspacePath'],
+        required: ['workspacePath'],
+        optional: ['query', 'runId', 'sessionId', 'gitBranch', 'gitHeadSha'],
     },
     descriptions: {
         standard: {
-            purpose: 'Find and reconnect to an existing WorkRail v2 workflow session.',
-            whenToUse: 'Use this when you need to resume a previously started workflow but no longer have the latest continueToken in chat context.',
+            purpose: 'Find and reconnect to an existing WorkRail workflow session. WorkRail is a workflow engine that persists session state across chat conversations. When a user says "resume my workflow", this is the tool to call.',
+            whenToUse: 'Use this when the user wants to resume, continue, or reconnect to a previously started workflow. The user may provide a session ID, run ID, a description of what they were working on, or nothing at all. This tool searches stored sessions and returns the best matches.',
             rules: [
-                'Always pass query with the user\'s stated topic or intent (e.g. "resume the ACEI-1234 workflow"). Without query, only git-context matching runs and the right session may not surface.',
-                'Pass workspacePath when available so WorkRail can match sessions to the correct workspace and git context.',
-                'Pick the best candidate, then call continue_workflow using its nextCall template — no manual parameter construction needed.',
-                'Do not call read_session to resume; use the nextCall from the chosen candidate.',
-                'If candidates is empty, no eligible session exists — call start_workflow to begin a new session instead.',
-                'If all candidates have whyMatched: ["recency_fallback"], the match had no strong signal (git or notes). Verify the snippet before resuming.',
+                'If the user provides a run ID (run_...) or session ID (sess_...), pass it as runId or sessionId for an exact match. This is the most reliable way to find a specific session.',
+                'If the user describes what they were working on (e.g. "the mr ownership task"), pass their words as query. This searches session recap notes and workflow IDs for matching keywords.',
+                'Always pass workspacePath (from your system parameters). Shared MCP servers cannot safely infer the current workspace, and resume quality depends on the current repo identity.',
+                'The response includes ranked candidates with match explanations and ready-to-use continuation templates. Present the top candidates to the user if there is ambiguity.',
+                'To inspect or resume a candidate: call continue_workflow with the candidate\'s nextCall.params (continueToken and intent: "rehydrate"). This is the correct inspection path for v2 sessions and restores the full session context.',
+                'If no candidates match, ask the user for more details or suggest starting a fresh workflow with start_workflow.',
             ],
             examplePayload: {
                 workspacePath: '/Users/you/git/my-project',
                 query: 'resume the coding task workflow for protocol drift',
             },
-            returns: 'Up to 5 ranked candidates, each with whyMatched explaining the match signal and a nextCall template for continue_workflow. If candidates is empty, call start_workflow.',
+            returns: 'Up to 5 ranked candidates with match signals, session previews, and ready-to-use continuation templates. The response explains which candidate to pick and exactly how to resume it.',
         },
         authoritative: {
-            purpose: 'Find an existing WorkRail v2 session and reconnect to it deterministically.',
-            whenToUse: 'Call this when resuming a workflow without the latest in-chat token block.',
+            purpose: 'Find an existing WorkRail workflow session and reconnect to it. WorkRail persists workflow state across chat conversations. When a user says "resume my workflow", call this tool.',
+            whenToUse: 'Call this when resuming a workflow. The user may provide a run ID, session ID, a description, or nothing.',
             rules: [
-                'Always pass query with the user\'s stated topic or intent. Semantic (notes) matching only runs when query is provided.',
-                'Pass workspacePath set to the current workspace whenever possible.',
-                'Pick the best candidate and call continue_workflow with its nextCall — the resumeToken is already embedded in nextCall.params.continueToken.',
-                'Do not invent token values or call read_session to resume execution.',
-                'If candidates is empty, no eligible session exists — call start_workflow instead.',
-                'whyMatched values: matched_head_sha / matched_branch / matched_notes = strong signal; recency_fallback = no signal, verify snippet before resuming.',
+                'If the user provides a run ID (run_...) or session ID (sess_...), pass it as runId or sessionId for exact lookup.',
+                'If the user describes their task, pass their words as query to search session notes.',
+                'Always pass workspacePath from your system parameters. Shared MCP servers cannot safely infer the current workspace.',
+                'Present candidates to the user when there is ambiguity. The response explains match strength.',
+                'To inspect or resume: call continue_workflow with the chosen candidate\'s nextCall.params (continueToken + intent: "rehydrate"). Do NOT use legacy session tools to inspect a v2 workflow resume candidate.',
+                'If no candidates match, ask for more details or start a fresh workflow.',
             ],
             examplePayload: {
                 workspacePath: '/Users/you/git/my-project',
                 query: 'resume the coding task workflow for protocol drift',
             },
-            returns: 'Up to 5 ranked candidates, each with whyMatched confidence signals and a pre-built nextCall. Empty candidates means no session found — call start_workflow.',
+            returns: 'Up to 5 ranked candidates with match signals, previews, and ready-to-use continuation templates.',
         },
     },
 };

package/dist/v2/durable-core/schemas/export-bundle/index.d.ts

@@ -2183,8 +2183,8 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
         bytes: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         kind: "segment_closed";
-        sha256: string;
         sessionId: string;
+        sha256: string;
         v: 1;
         manifestIndex: number;
         firstEventIndex: number;
@@ -2193,8 +2193,8 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
         bytes: number;
     }, {
         kind: "segment_closed";
-        sha256: string;
         sessionId: string;
+        sha256: string;
         v: 1;
         manifestIndex: number;
         firstEventIndex: number;
@@ -4601,8 +4601,8 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
     })[];
     manifest: ({
         kind: "segment_closed";
-        sha256: string;
         sessionId: string;
+        sha256: string;
         v: 1;
         manifestIndex: number;
         firstEventIndex: number;
@@ -5113,8 +5113,8 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
     })[];
     manifest: ({
         kind: "segment_closed";
-        sha256: string;
         sessionId: string;
+        sha256: string;
         v: 1;
         manifestIndex: number;
         firstEventIndex: number;
@@ -7305,8 +7305,8 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
             bytes: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             kind: "segment_closed";
-            sha256: string;
             sessionId: string;
+            sha256: string;
             v: 1;
             manifestIndex: number;
             firstEventIndex: number;
@@ -7315,8 +7315,8 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
             bytes: number;
         }, {
             kind: "segment_closed";
-            sha256: string;
             sessionId: string;
+            sha256: string;
             v: 1;
             manifestIndex: number;
             firstEventIndex: number;
@@ -9723,8 +9723,8 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
         })[];
         manifest: ({
             kind: "segment_closed";
-            sha256: string;
             sessionId: string;
+            sha256: string;
             v: 1;
             manifestIndex: number;
             firstEventIndex: number;
@@ -10235,8 +10235,8 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
         })[];
         manifest: ({
             kind: "segment_closed";
-            sha256: string;
             sessionId: string;
+            sha256: string;
             v: 1;
             manifestIndex: number;
             firstEventIndex: number;
@@ -10776,8 +10776,8 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
         })[];
         manifest: ({
             kind: "segment_closed";
-            sha256: string;
             sessionId: string;
+            sha256: string;
             v: 1;
             manifestIndex: number;
             firstEventIndex: number;
@@ -11305,8 +11305,8 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
         })[];
         manifest: ({
             kind: "segment_closed";
-            sha256: string;
             sessionId: string;
+            sha256: string;
             v: 1;
             manifestIndex: number;
             firstEventIndex: number;

package/dist/v2/durable-core/schemas/session/manifest.d.ts

@@ -11,8 +11,8 @@ export declare const ManifestRecordV1Schema: z.ZodDiscriminatedUnion<"kind", [z.
     bytes: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     kind: "segment_closed";
-    sha256: string;
     sessionId: string;
+    sha256: string;
     v: 1;
     manifestIndex: number;
     firstEventIndex: number;
@@ -21,8 +21,8 @@ export declare const ManifestRecordV1Schema: z.ZodDiscriminatedUnion<"kind", [z.
     bytes: number;
 }, {
     kind: "segment_closed";
-    sha256: string;
     sessionId: string;
+    sha256: string;
     v: 1;
     manifestIndex: number;
     firstEventIndex: number;

package/dist/v2/durable-core/tokens/payloads.d.ts

@@ -14,13 +14,13 @@ export declare const StateTokenPayloadV1Schema: z.ZodObject<{
     nodeId: z.ZodEffects<z.ZodString, NodeId, string>;
     workflowHashRef: z.ZodEffects<z.ZodString, WorkflowHashRef, string>;
 }, "strip", z.ZodTypeAny, {
+    runId: string & {
+        readonly __brand: "v2.RunId";
+    };
     sessionId: string & {
         readonly __brand: "v2.SessionId";
     };
     tokenKind: "state";
-    runId: string & {
-        readonly __brand: "v2.RunId";
-    };
     nodeId: string & {
         readonly __brand: "v2.NodeId";
     };
@@ -29,9 +29,9 @@ export declare const StateTokenPayloadV1Schema: z.ZodObject<{
     };
     tokenVersion: 1;
 }, {
+    runId: string;
     sessionId: string;
     tokenKind: "state";
-    runId: string;
     nodeId: string;
     workflowHashRef: string;
     tokenVersion: 1;
@@ -52,13 +52,13 @@ export declare const AckTokenPayloadV1Schema: z.ZodObject<{
     nodeId: z.ZodEffects<z.ZodString, NodeId, string>;
     attemptId: z.ZodEffects<z.ZodString, AttemptId, string>;
 }, "strip", z.ZodTypeAny, {
+    runId: string & {
+        readonly __brand: "v2.RunId";
+    };
     sessionId: string & {
         readonly __brand: "v2.SessionId";
     };
     tokenKind: "ack";
-    runId: string & {
-        readonly __brand: "v2.RunId";
-    };
     nodeId: string & {
         readonly __brand: "v2.NodeId";
     };
@@ -67,9 +67,9 @@ export declare const AckTokenPayloadV1Schema: z.ZodObject<{
     };
     tokenVersion: 1;
 }, {
+    runId: string;
     sessionId: string;
     tokenKind: "ack";
-    runId: string;
     nodeId: string;
     attemptId: string;
     tokenVersion: 1;
@@ -90,13 +90,13 @@ export declare const CheckpointTokenPayloadV1Schema: z.ZodObject<{
     nodeId: z.ZodEffects<z.ZodString, NodeId, string>;
     attemptId: z.ZodEffects<z.ZodString, AttemptId, string>;
 }, "strip", z.ZodTypeAny, {
+    runId: string & {
+        readonly __brand: "v2.RunId";
+    };
     sessionId: string & {
         readonly __brand: "v2.SessionId";
     };
     tokenKind: "checkpoint";
-    runId: string & {
-        readonly __brand: "v2.RunId";
-    };
     nodeId: string & {
         readonly __brand: "v2.NodeId";
     };
@@ -105,9 +105,9 @@ export declare const CheckpointTokenPayloadV1Schema: z.ZodObject<{
     };
     tokenVersion: 1;
 }, {
+    runId: string;
     sessionId: string;
     tokenKind: "checkpoint";
-    runId: string;
     nodeId: string;
     attemptId: string;
     tokenVersion: 1;
@@ -128,13 +128,13 @@ export declare const TokenPayloadV1Schema: z.ZodDiscriminatedUnion<"tokenKind",
     nodeId: z.ZodEffects<z.ZodString, NodeId, string>;
     workflowHashRef: z.ZodEffects<z.ZodString, WorkflowHashRef, string>;
 }, "strip", z.ZodTypeAny, {
+    runId: string & {
+        readonly __brand: "v2.RunId";
+    };
     sessionId: string & {
         readonly __brand: "v2.SessionId";
     };
     tokenKind: "state";
-    runId: string & {
-        readonly __brand: "v2.RunId";
-    };
     nodeId: string & {
         readonly __brand: "v2.NodeId";
     };
@@ -143,9 +143,9 @@ export declare const TokenPayloadV1Schema: z.ZodDiscriminatedUnion<"tokenKind",
     };
     tokenVersion: 1;
 }, {
+    runId: string;
     sessionId: string;
     tokenKind: "state";
-    runId: string;
     nodeId: string;
     workflowHashRef: string;
     tokenVersion: 1;
@@ -157,13 +157,13 @@ export declare const TokenPayloadV1Schema: z.ZodDiscriminatedUnion<"tokenKind",
     nodeId: z.ZodEffects<z.ZodString, NodeId, string>;
     attemptId: z.ZodEffects<z.ZodString, AttemptId, string>;
 }, "strip", z.ZodTypeAny, {
+    runId: string & {
+        readonly __brand: "v2.RunId";
+    };
     sessionId: string & {
         readonly __brand: "v2.SessionId";
     };
     tokenKind: "ack";
-    runId: string & {
-        readonly __brand: "v2.RunId";
-    };
     nodeId: string & {
         readonly __brand: "v2.NodeId";
     };
@@ -172,9 +172,9 @@ export declare const TokenPayloadV1Schema: z.ZodDiscriminatedUnion<"tokenKind",
     };
     tokenVersion: 1;
 }, {
+    runId: string;
     sessionId: string;
     tokenKind: "ack";
-    runId: string;
     nodeId: string;
     attemptId: string;
     tokenVersion: 1;
@@ -186,13 +186,13 @@ export declare const TokenPayloadV1Schema: z.ZodDiscriminatedUnion<"tokenKind",
     nodeId: z.ZodEffects<z.ZodString, NodeId, string>;
     attemptId: z.ZodEffects<z.ZodString, AttemptId, string>;
 }, "strip", z.ZodTypeAny, {
+    runId: string & {
+        readonly __brand: "v2.RunId";
+    };
     sessionId: string & {
         readonly __brand: "v2.SessionId";
     };
     tokenKind: "checkpoint";
-    runId: string & {
-        readonly __brand: "v2.RunId";
-    };
     nodeId: string & {
         readonly __brand: "v2.NodeId";
     };
@@ -201,9 +201,9 @@ export declare const TokenPayloadV1Schema: z.ZodDiscriminatedUnion<"tokenKind",
     };
     tokenVersion: 1;
 }, {
+    runId: string;
     sessionId: string;
     tokenKind: "checkpoint";
-    runId: string;
     nodeId: string;
     attemptId: string;
     tokenVersion: 1;

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

@@ -2,12 +2,14 @@ import type { ResultAsync } from 'neverthrow';
 import type { DirectoryListingPortV2 } from '../../../ports/directory-listing.port.js';
 import type { DataDirPortV2 } from '../../../ports/data-dir.port.js';
 import type { SessionEventLogReadonlyStorePortV2 } from '../../../ports/session-event-log-store.port.js';
+import type { SnapshotStorePortV2 } from '../../../ports/snapshot-store.port.js';
 import type { SessionSummaryProviderPortV2, SessionSummaryError } from '../../../ports/session-summary-provider.port.js';
 import type { HealthySessionSummary } from '../../../projections/resume-ranking.js';
 export interface LocalSessionSummaryProviderPorts {
     readonly directoryListing: DirectoryListingPortV2;
     readonly dataDir: DataDirPortV2;
     readonly sessionStore: SessionEventLogReadonlyStorePortV2;
+    readonly snapshotStore?: SnapshotStorePortV2;
 }
 export declare class LocalSessionSummaryProviderV2 implements SessionSummaryProviderPortV2 {
     private readonly ports;