@exaudeus/workrail 3.3.0 → 3.4.0

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

@@ -286,6 +286,31 @@ export declare const V2NextCallSchema: z.ZodNullable<z.ZodObject<{
     };
     tool: "continue_workflow";
 }>>;
+export declare const V2ResumeNextCallSchema: z.ZodObject<{
+    tool: z.ZodLiteral<"continue_workflow">;
+    params: z.ZodObject<{
+        continueToken: z.ZodString;
+        intent: z.ZodLiteral<"rehydrate">;
+    }, "strip", z.ZodTypeAny, {
+        continueToken: string;
+        intent: "rehydrate";
+    }, {
+        continueToken: string;
+        intent: "rehydrate";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    params: {
+        continueToken: string;
+        intent: "rehydrate";
+    };
+    tool: "continue_workflow";
+}, {
+    params: {
+        continueToken: string;
+        intent: "rehydrate";
+    };
+    tool: "continue_workflow";
+}>;
 export declare const V2BlockerReportSchema: z.ZodEffects<z.ZodObject<{
     blockers: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         code: z.ZodEnum<["USER_ONLY_DEPENDENCY", "MISSING_REQUIRED_OUTPUT", "INVALID_REQUIRED_OUTPUT", "MISSING_REQUIRED_NOTES", "MISSING_CONTEXT_KEY", "CONTEXT_BUDGET_EXCEEDED", "REQUIRED_CAPABILITY_UNKNOWN", "REQUIRED_CAPABILITY_UNAVAILABLE", "INVARIANT_VIOLATION", "STORAGE_CORRUPTION_DETECTED"]>;
@@ -458,6 +483,23 @@ export declare const V2BlockerReportSchema: z.ZodEffects<z.ZodObject<{
         suggestedFix?: string | undefined;
     }[];
 }>;
+export type { BindingDriftWarning as V2BindingDriftWarning } from '../v2/durable-core/domain/binding-drift.js';
+export declare const V2BindingDriftWarningSchema: z.ZodObject<{
+    code: z.ZodLiteral<"BINDING_DRIFT">;
+    slotId: z.ZodString;
+    pinnedValue: z.ZodString;
+    currentValue: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: "BINDING_DRIFT";
+    slotId: string;
+    pinnedValue: string;
+    currentValue: string;
+}, {
+    code: "BINDING_DRIFT";
+    slotId: string;
+    pinnedValue: string;
+    currentValue: string;
+}>;
 export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"ok">;
     continueToken: z.ZodOptional<z.ZodString>;
@@ -510,6 +552,22 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
         };
         tool: "continue_workflow";
     }>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodLiteral<"BINDING_DRIFT">;
+        slotId: z.ZodString;
+        pinnedValue: z.ZodString;
+        currentValue: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: "BINDING_DRIFT";
+        slotId: string;
+        pinnedValue: string;
+        currentValue: string;
+    }, {
+        code: "BINDING_DRIFT";
+        slotId: string;
+        pinnedValue: string;
+        currentValue: string;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "ok";
     pending: {
@@ -530,6 +588,12 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
         };
         tool: "continue_workflow";
     } | null;
+    warnings?: {
+        code: "BINDING_DRIFT";
+        slotId: string;
+        pinnedValue: string;
+        currentValue: string;
+    }[] | undefined;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
 }, {
@@ -552,6 +616,12 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
         };
         tool: "continue_workflow";
     } | null;
+    warnings?: {
+        code: "BINDING_DRIFT";
+        slotId: string;
+        pinnedValue: string;
+        currentValue: string;
+    }[] | undefined;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
 }>, z.ZodObject<{
@@ -910,6 +980,12 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
         };
         tool: "continue_workflow";
     } | null;
+    warnings?: {
+        code: "BINDING_DRIFT";
+        slotId: string;
+        pinnedValue: string;
+        currentValue: string;
+    }[] | undefined;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
 } | {
@@ -982,6 +1058,12 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
         };
         tool: "continue_workflow";
     } | null;
+    warnings?: {
+        code: "BINDING_DRIFT";
+        slotId: string;
+        pinnedValue: string;
+        currentValue: string;
+    }[] | undefined;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
 } | {
@@ -1039,37 +1121,95 @@ export declare const V2ResumeSessionOutputSchema: z.ZodObject<{
     candidates: z.ZodArray<z.ZodObject<{
         sessionId: z.ZodString;
         runId: z.ZodString;
-        stateToken: z.ZodString;
+        workflowId: 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">;
+        nextCall: z.ZodObject<{
+            tool: z.ZodLiteral<"continue_workflow">;
+            params: z.ZodObject<{
+                continueToken: z.ZodString;
+                intent: z.ZodLiteral<"rehydrate">;
+            }, "strip", z.ZodTypeAny, {
+                continueToken: string;
+                intent: "rehydrate";
+            }, {
+                continueToken: string;
+                intent: "rehydrate";
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            params: {
+                continueToken: string;
+                intent: "rehydrate";
+            };
+            tool: "continue_workflow";
+        }, {
+            params: {
+                continueToken: string;
+                intent: "rehydrate";
+            };
+            tool: "continue_workflow";
+        }>;
     }, "strip", z.ZodTypeAny, {
+        workflowId: string;
         sessionId: string;
         runId: string;
-        stateToken: string;
+        nextCall: {
+            params: {
+                continueToken: string;
+                intent: "rehydrate";
+            };
+            tool: "continue_workflow";
+        };
+        resumeToken: string;
         snippet: string;
         whyMatched: ("matched_head_sha" | "matched_branch" | "matched_notes" | "matched_workflow_id" | "recency_fallback")[];
     }, {
+        workflowId: string;
         sessionId: string;
         runId: string;
-        stateToken: string;
+        nextCall: {
+            params: {
+                continueToken: string;
+                intent: "rehydrate";
+            };
+            tool: "continue_workflow";
+        };
+        resumeToken: string;
         snippet: string;
         whyMatched: ("matched_head_sha" | "matched_branch" | "matched_notes" | "matched_workflow_id" | "recency_fallback")[];
     }>, "many">;
     totalEligible: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     candidates: {
+        workflowId: string;
         sessionId: string;
         runId: string;
-        stateToken: string;
+        nextCall: {
+            params: {
+                continueToken: string;
+                intent: "rehydrate";
+            };
+            tool: "continue_workflow";
+        };
+        resumeToken: string;
         snippet: string;
         whyMatched: ("matched_head_sha" | "matched_branch" | "matched_notes" | "matched_workflow_id" | "recency_fallback")[];
     }[];
     totalEligible: number;
 }, {
     candidates: {
+        workflowId: string;
         sessionId: string;
         runId: string;
-        stateToken: string;
+        nextCall: {
+            params: {
+                continueToken: string;
+                intent: "rehydrate";
+            };
+            tool: "continue_workflow";
+        };
+        resumeToken: string;
         snippet: string;
         whyMatched: ("matched_head_sha" | "matched_branch" | "matched_notes" | "matched_workflow_id" | "recency_fallback")[];
     }[];
@@ -1077,7 +1217,7 @@ export declare const V2ResumeSessionOutputSchema: z.ZodObject<{
 }>;
 export declare const V2CheckpointWorkflowOutputSchema: z.ZodObject<{
     checkpointNodeId: z.ZodString;
-    stateToken: z.ZodString;
+    resumeToken: z.ZodString;
     nextCall: z.ZodNullable<z.ZodObject<{
         tool: z.ZodLiteral<"continue_workflow">;
         params: z.ZodObject<{
@@ -1105,7 +1245,7 @@ export declare const V2CheckpointWorkflowOutputSchema: z.ZodObject<{
         };
         tool: "continue_workflow";
     } | null;
-    stateToken: string;
+    resumeToken: string;
     checkpointNodeId: string;
 }, {
     nextCall: {
@@ -1114,7 +1254,7 @@ export declare const V2CheckpointWorkflowOutputSchema: z.ZodObject<{
         };
         tool: "continue_workflow";
     } | null;
-    stateToken: string;
+    resumeToken: string;
     checkpointNodeId: string;
 }>;
 export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{

package/dist/mcp/output-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2StartWorkflowOutputSchema = exports.V2CheckpointWorkflowOutputSchema = exports.V2ResumeSessionOutputSchema = exports.V2ContinueWorkflowOutputSchema = exports.V2BlockerReportSchema = exports.V2NextCallSchema = exports.V2NextIntentSchema = exports.V2PreferencesSchema = exports.V2PendingStepSchema = exports.V2WorkflowInspectOutputSchema = exports.V2WorkflowListOutputSchema = exports.V2WorkflowListItemSchema = exports.WorkflowGetSchemaOutputSchema = exports.WorkflowValidateJsonOutputSchema = exports.WorkflowNextOutputSchema = exports.WorkflowGetOutputSchema = exports.WorkflowListOutputSchema = exports.WorkflowSummarySchema = exports.JsonValueSchema = void 0;
+exports.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2StartWorkflowOutputSchema = exports.V2CheckpointWorkflowOutputSchema = exports.V2ResumeSessionOutputSchema = exports.V2ContinueWorkflowOutputSchema = exports.V2BindingDriftWarningSchema = exports.V2BlockerReportSchema = exports.V2ResumeNextCallSchema = exports.V2NextCallSchema = exports.V2NextIntentSchema = exports.V2PreferencesSchema = exports.V2PendingStepSchema = exports.V2WorkflowInspectOutputSchema = exports.V2WorkflowListOutputSchema = exports.V2WorkflowListItemSchema = exports.WorkflowGetSchemaOutputSchema = exports.WorkflowValidateJsonOutputSchema = exports.WorkflowNextOutputSchema = exports.WorkflowGetOutputSchema = exports.WorkflowListOutputSchema = exports.WorkflowSummarySchema = exports.JsonValueSchema = void 0;
 exports.toPendingStep = toPendingStep;
 const zod_1 = require("zod");
 const state_js_1 = require("../domain/execution/state.js");
@@ -94,6 +94,13 @@ exports.V2NextCallSchema = zod_1.z.object({
     tool: zod_1.z.literal('continue_workflow'),
     params: zod_1.z.object({ continueToken: zod_1.z.string().min(1) }),
 }).nullable();
+exports.V2ResumeNextCallSchema = zod_1.z.object({
+    tool: zod_1.z.literal('continue_workflow'),
+    params: zod_1.z.object({
+        continueToken: zod_1.z.string().min(1),
+        intent: zod_1.z.literal('rehydrate'),
+    }),
+});
 function utf8ByteLength(s) {
     return new TextEncoder().encode(s).length;
 }
@@ -182,6 +189,12 @@ exports.V2BlockerReportSchema = zod_1.z
 });
 const checkpointTokenSchema = zod_1.z.string().regex(token_patterns_js_1.CHECKPOINT_TOKEN_PATTERN, 'Invalid checkpointToken format').optional();
 const continueTokenSchema = zod_1.z.string().regex(token_patterns_js_1.CONTINUE_TOKEN_PATTERN, 'Invalid continueToken format').optional();
+exports.V2BindingDriftWarningSchema = zod_1.z.object({
+    code: zod_1.z.literal('BINDING_DRIFT'),
+    slotId: zod_1.z.string().min(1),
+    pinnedValue: zod_1.z.string().min(1),
+    currentValue: zod_1.z.string().min(1),
+});
 const V2ContinueWorkflowOkSchema = zod_1.z.object({
     kind: zod_1.z.literal('ok'),
     continueToken: continueTokenSchema,
@@ -191,6 +204,7 @@ const V2ContinueWorkflowOkSchema = zod_1.z.object({
     preferences: exports.V2PreferencesSchema,
     nextIntent: exports.V2NextIntentSchema,
     nextCall: exports.V2NextCallSchema,
+    warnings: zod_1.z.array(exports.V2BindingDriftWarningSchema).optional(),
 });
 const V2ContinueWorkflowBlockedSchema = zod_1.z.object({
     kind: zod_1.z.literal('blocked'),
@@ -219,7 +233,8 @@ exports.V2ResumeSessionOutputSchema = zod_1.z.object({
     candidates: zod_1.z.array(zod_1.z.object({
         sessionId: zod_1.z.string().min(1),
         runId: zod_1.z.string().min(1),
-        stateToken: zod_1.z.string().regex(token_patterns_js_1.STATE_TOKEN_PATTERN, 'Invalid stateToken format'),
+        workflowId: zod_1.z.string().min(1),
+        resumeToken: zod_1.z.string().regex(token_patterns_js_1.STATE_TOKEN_PATTERN, 'Invalid resumeToken format'),
         snippet: zod_1.z.string().max(1024),
         whyMatched: zod_1.z.array(zod_1.z.enum([
             'matched_head_sha',
@@ -227,13 +242,16 @@ exports.V2ResumeSessionOutputSchema = zod_1.z.object({
             'matched_notes',
             'matched_workflow_id',
             'recency_fallback',
-        ])),
+        ])).describe('Match signals explaining why this candidate was ranked. ' +
+            'matched_head_sha/branch/notes/workflow_id = strong signal. ' +
+            'recency_fallback = no strong signal; inspect the snippet before resuming.'),
+        nextCall: exports.V2ResumeNextCallSchema,
     })).max(5),
     totalEligible: zod_1.z.number().int().min(0),
 });
 exports.V2CheckpointWorkflowOutputSchema = zod_1.z.object({
     checkpointNodeId: zod_1.z.string().min(1),
-    stateToken: zod_1.z.string().regex(token_patterns_js_1.STATE_TOKEN_PATTERN, 'Invalid stateToken format'),
+    resumeToken: zod_1.z.string().regex(token_patterns_js_1.STATE_TOKEN_PATTERN, 'Invalid resumeToken format'),
     nextCall: exports.V2NextCallSchema.describe('Pre-built template for your next continue_workflow call. ' +
         'After checkpoint, use this to rehydrate and continue working on the current step.'),
 });

package/dist/mcp/server.d.ts

@@ -1,5 +1,5 @@
 import type { ToolContext } from './types.js';
-import { WorkspaceRootsManager } from './workspace-roots-manager.js';
+import { WorkspaceRootsManager, type RootsReader } from './workspace-roots-manager.js';
 import { type ToolAnnotations } from './tool-factory.js';
 import type { WrappedToolHandler } from './types/workflow-tool-edition.js';
 interface Tool {
@@ -12,10 +12,12 @@ export declare function createToolContext(): Promise<ToolContext>;
 export interface ComposedServer {
     readonly server: import('@modelcontextprotocol/sdk/server/index.js').Server;
     readonly ctx: ToolContext;
-    readonly rootsManager: WorkspaceRootsManager;
+    readonly rootsReader: RootsReader;
     readonly tools: readonly Tool[];
     readonly handlers: Record<string, WrappedToolHandler>;
 }
-export declare function composeServer(): Promise<ComposedServer>;
-export declare function startServer(): Promise<void>;
+export interface ComposedServerInternal extends ComposedServer {
+    readonly rootsManager: WorkspaceRootsManager;
+}
+export declare function composeServer(): Promise<ComposedServerInternal>;
 export {};

package/dist/mcp/server.js

@@ -35,7 +35,6 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createToolContext = createToolContext;
 exports.composeServer = composeServer;
-exports.startServer = startServer;
 const zod_to_json_schema_js_1 = require("./zod-to-json-schema.js");
 const container_js_1 = require("../di/container.js");
 const tokens_js_1 = require("../di/tokens.js");
@@ -186,8 +185,7 @@ async function composeServer() {
     }
     const rootsManager = new workspace_roots_manager_js_1.WorkspaceRootsManager();
     const { Server } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/server/index.js')));
-    const { StdioServerTransport } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/server/stdio.js')));
-    const { CallToolRequestSchema, ListToolsRequestSchema, RootsListChangedNotificationSchema, } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/types.js')));
+    const { CallToolRequestSchema, ListToolsRequestSchema, } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/types.js')));
     const server = new Server({
         name: 'workrail-server',
         version: '0.1.0',
@@ -224,58 +222,5 @@ async function composeServer() {
             : ctx;
         return handler(args ?? {}, requestCtx);
     });
-    return { server, ctx, rootsManager, tools, handlers };
-}
-async function startServer() {
-    const { server, ctx, rootsManager } = await composeServer();
-    const { StdioServerTransport } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/server/stdio.js')));
-    const { RootsListChangedNotificationSchema, } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/types.js')));
-    server.setNotificationHandler(RootsListChangedNotificationSchema, async () => {
-        try {
-            const result = await server.listRoots();
-            rootsManager.updateRootUris(result.roots.map((r) => r.uri));
-            console.error(`[Roots] Updated workspace roots: ${result.roots.map((r) => r.uri).join(', ') || '(none)'}`);
-        }
-        catch {
-            console.error('[Roots] Failed to fetch updated roots after change notification');
-        }
-    });
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    try {
-        const result = await server.listRoots();
-        rootsManager.updateRootUris(result.roots.map((r) => r.uri));
-        console.error(`[Roots] Initial workspace roots: ${result.roots.map((r) => r.uri).join(', ') || '(none)'}`);
-    }
-    catch {
-        console.error('[Roots] Client does not support roots/list; workspace context will use server CWD fallback');
-    }
-    console.error('WorkRail MCP Server running on stdio');
-    const shutdownEvents = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ShutdownEvents);
-    const processSignals = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ProcessSignals);
-    const terminator = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ProcessTerminator);
-    processSignals.on('SIGINT', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGINT' }));
-    processSignals.on('SIGTERM', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGTERM' }));
-    processSignals.on('SIGHUP', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGHUP' }));
-    process.stdin.on('end', () => {
-        console.error('[MCP] stdin closed, initiating shutdown');
-        shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGHUP' });
-    });
-    let shutdownStarted = false;
-    shutdownEvents.onShutdown((event) => {
-        if (shutdownStarted)
-            return;
-        shutdownStarted = true;
-        void (async () => {
-            try {
-                console.error(`[Shutdown] Requested by ${event.signal}. Stopping services...`);
-                await ctx.httpServer?.stop();
-                terminator.terminate({ kind: 'success' });
-            }
-            catch (err) {
-                console.error('[Shutdown] Error while stopping services:', err);
-                terminator.terminate({ kind: 'failure' });
-            }
-        })();
-    });
+    return { server, ctx, rootsManager, rootsReader: rootsManager, tools, handlers };
 }

package/dist/mcp/tool-descriptions.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DESCRIPTIONS = void 0;
+const workflow_protocol_contracts_js_1 = require("./workflow-protocol-contracts.js");
 exports.DESCRIPTIONS = {
     standard: {
         discover_workflows: `Your primary tool for any complex or multi-step request. Call this FIRST to see if a reliable, pre-defined workflow exists, as this is the preferred method over improvisation.
@@ -63,79 +64,10 @@ Returns:
 Pass workspacePath when available so project-scoped workflow variants are resolved against the correct workspace.
 
 Remember: inspecting is read-only. Call start_workflow when ready to begin.`,
-        start_workflow: `Begin following a workflow's step-by-step instructions (WorkRail v2, feature-flagged).
-
-The workflow represents the user's plan for this task. Each step will tell you exactly what to do. Your job is to execute each step's instructions and report back.
-
-The response contains your first step's instructions as the main content, with tokens in a JSON code block at the end. The step title is the heading, and the step prompt is the body.
-
-What to do:
-1. Read the step instructions (the main body of the response) and execute them exactly
-2. When done, call continue_workflow with the stateToken and ackToken from the JSON block at the end
-3. Add output.notesMarkdown documenting your work (see notes guidance below)
-4. Don't predict what comes next — the workflow will tell you
-
-Notes guidance: Write output.notesMarkdown for a human reader who will reference it later. Include what you did, key decisions and trade-offs, what you produced (files, endpoints, test results), and anything notable (risks, open questions, things you deliberately skipped). Use markdown formatting. Be specific — names, paths, numbers. 10–30 lines is ideal; too short is worse than too long.
-
-Workspace anchoring: Pass workspacePath (the "Workspace:" path from your system parameters) so this session can be found by resume_session in future chats. Without it, session discovery may not work.
-
-Context auto-loads: If you provide context at start, WorkRail remembers it. On future continue_workflow calls, only pass context if you have NEW information to add.`,
-        continue_workflow: `Get the next step in the workflow (WorkRail v2, feature-flagged).
-
-QUICK START — How to call back after completing a step:
-Copy the stateToken and ackToken from the JSON code block at the end of the previous response. Just add your output.
-
-Two modes:
-
-ADVANCE (with ackToken):
-- "I completed the current step; give me the next one"
-- Requires: stateToken + ackToken (from the JSON block in previous response)
-- Optional: output (your work summary), context (if facts changed)
-- Result: WorkRail advances to next step and returns it
-
-REHYDRATE (without ackToken):
-- "Remind me what the current step is" (after rewind or lost context)
-- Requires: stateToken only
-- Do NOT include ackToken or output
-- Result: Same pending step returned; no advancement; side-effect-free
-
-Intent is auto-inferred: ackToken present → advance, ackToken absent → rehydrate.
-You can set intent explicitly if you prefer, but it's optional.
-
-Reading the response:
-The response is natural language with your step instructions as the main content. A JSON code block at the end contains the tokens for your next call. The response tells you directly what to do — execute the step, retry with corrections, wait for user input, or acknowledge completion.
-
-Parameters:
-- stateToken (required): From the JSON block in the previous response
-- ackToken (required for advance): From the JSON block in the previous response
-- intent (optional): "advance" or "rehydrate" — auto-inferred from ackToken if omitted
-- context (optional): NEW facts only. Omit if unchanged — WorkRail auto-loads previous context
-- output.notesMarkdown (advance only): Recap of THIS step — what you did, key decisions, what you produced, anything notable. Write for a human reviewer. Use markdown, be specific (names, paths, numbers). 10–30 lines; never accumulate previous steps.
-
-The workflow is the user's structured instructions. Follow each step exactly as described.`,
-        checkpoint_workflow: `Save a checkpoint on the current workflow step (WorkRail v2, feature-flagged).
-
-Creates a durable checkpoint on your current step without advancing. Useful for saving progress on long-running steps.
-
-Requires: checkpointToken (from the most recent start_workflow or continue_workflow response).
-
-Idempotent: calling with the same checkpointToken multiple times is safe and returns the same result.
-
-Returns: checkpointNodeId + a fresh stateToken.`,
-        resume_session: `Find and reconnect to an existing workflow session (WorkRail v2, feature-flagged).
-
-Use this when you need to resume a previously started workflow but don't have the stateToken (e.g., new chat, lost context).
-
-Pass workspacePath (the "Workspace:" path from your system parameters) to match sessions anchored to your current workspace. Without it, git-based tier matching won't work.
-
-WorkRail ranks sessions using a 5-tier matching algorithm:
-1. Exact git HEAD SHA match
-2. Git branch match (exact or prefix)
-3. Free text match against session notes
-4. Free text match against workflow ID
-5. Recency fallback
-
-Returns: Up to 5 ranked candidates, each with a stateToken you can use with continue_workflow.`,
+        start_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.START_WORKFLOW_PROTOCOL, 'standard'),
+        continue_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.CONTINUE_WORKFLOW_PROTOCOL, 'standard'),
+        checkpoint_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.CHECKPOINT_WORKFLOW_PROTOCOL, 'standard'),
+        resume_session: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.RESUME_SESSION_PROTOCOL, 'standard'),
     },
     authoritative: {
         discover_workflows: `Check for workflows that apply to the user's request. Workflows are the user's pre-defined instructions that you MUST follow when they exist.
@@ -209,90 +141,9 @@ Parameters:
 - workspacePath: optional absolute workspace path for correct project-scoped workflow resolution
 
 This is read-only. Call start_workflow when ready to commit to following the workflow.`,
-        start_workflow: `Begin executing the user's workflow instructions (WorkRail v2, feature-flagged).
-
-The workflow is the USER'S VOICE expressing their plan for this task. Each step is a DIRECT INSTRUCTION from the user (or workflow author representing user intent). You MUST execute each step exactly as specified.
-
-The response contains your first step's instructions as the main content (heading + body), with tokens in a JSON code block at the end.
-
-REQUIRED BEHAVIOR:
-1. Execute the step instructions (the main body of the response) EXACTLY as described
-2. When done, call continue_workflow with the stateToken and ackToken from the JSON block at the end
-3. Add output.notesMarkdown documenting your work — write for a human reader who will reference it later. Include what you did, key decisions/trade-offs, what you produced (files, endpoints, test results), and anything notable (risks, open questions, deliberate omissions). Use markdown formatting, be specific (names, paths, numbers). 10–30 lines; too short is worse than too long.
-4. Round-trip tokens UNCHANGED (don't decode, inspect, or modify them)
-5. Follow the workflow to completion — don't improvise alternative approaches
-
-Workspace anchoring (IMPORTANT):
-- Pass workspacePath set to the "Workspace:" value from your system parameters
-- This anchors the session to your workspace so resume_session can find it in future chats
-- Example: workspacePath: "/Users/you/git/my-project"
-
-Context handling:
-- Pass context at start to establish baseline facts
-- WorkRail auto-loads context on subsequent calls
-- Only pass context again if facts have CHANGED (e.g., user provided new information)`,
-        continue_workflow: `Get your next INSTRUCTION from the workflow (WorkRail v2, feature-flagged).
-
-The workflow represents the USER'S PLAN. The step returned is a DIRECT INSTRUCTION you MUST follow.
-
-HOW TO CALL — Copy the stateToken and ackToken from the JSON code block at the end of the previous response. Add output if desired.
-
-Two modes:
-
-ADVANCE (with ackToken):
-- Purpose: "I completed the current step; give me the next instruction"
-- Requires: stateToken + ackToken (from the JSON block in the previous response)
-- Optional: output (your work summary), context (if facts changed)
-- Result: WorkRail advances to next step
-- Idempotent: Safe to retry with same tokens if unsure
-
-REHYDRATE (without ackToken):
-- Purpose: "Remind me what the current step is" (after rewind/lost context)
-- Requires: stateToken only
-- Do NOT include ackToken or output
-- Result: Same pending step returned; no advancement
-- Side-effect-free: No durable writes; pure state recovery
-
-Intent is auto-inferred: ackToken present → advance, ackToken absent → rehydrate.
-You can set intent explicitly if you prefer, but it's optional.
-
-REQUIRED BEHAVIOR:
-1. Execute the step EXACTLY as described in the response body
-2. When done, call continue_workflow with tokens from the JSON block — do NOT construct params manually
-3. Do NOT predict what comes next — call continue_workflow and the workflow will tell you
-4. Do NOT skip steps, combine steps, or improvise your own approach
-
-Reading the response:
-The response is natural language. The step instructions are the main content (heading + body). A JSON code block at the end has the tokens for your next call. The response tells you directly what to do — execute the step, retry with corrections, wait for user input, or acknowledge completion.
-
-Parameters:
-- stateToken (required): From the JSON block in the previous response
-- ackToken (required for advance): From the JSON block in the previous response
-- intent (optional): "advance" or "rehydrate" — auto-inferred from ackToken if omitted
-- context (optional): NEW facts only (auto-merges with previous). Omit if unchanged
-- output.notesMarkdown (advance only): Recap of THIS step — what you did, key decisions, what you produced, anything notable. Write for a human reviewer. Use markdown, be specific (names, paths, numbers). 10–30 lines; never accumulate previous steps.
-
-The workflow is the user's structured will. Follow it exactly — it may validate, loop, or branch in ways you don't predict.`,
-        checkpoint_workflow: `Save a checkpoint on the current workflow step (WorkRail v2, feature-flagged).
-
-Creates a durable checkpoint without advancing. Use for long-running steps to save progress.
-
-Requires: checkpointToken from the most recent response. Idempotent.
-
-Returns: checkpointNodeId + fresh stateToken.`,
-        resume_session: `Find and reconnect to an existing workflow session (WorkRail v2, feature-flagged).
-
-Call this when resuming a workflow without a stateToken. WorkRail ranks sessions deterministically:
-1. Exact git HEAD SHA match (tier 1)
-2. Git branch match (tier 2)
-3. Notes content match (tier 3)
-4. Workflow ID match (tier 4)
-5. Recency (tier 5)
-
-IMPORTANT: Pass workspacePath set to the "Workspace:" value from your system parameters.
-Without it, tier 1 and tier 2 matching won't work (git context defaults to server directory, not yours).
-Example: workspacePath: "/Users/you/git/my-project"
-
-Returns: Up to 5 candidates with stateTokens. Use the best match's stateToken with continue_workflow.`,
+        start_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.START_WORKFLOW_PROTOCOL, 'authoritative'),
+        continue_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.CONTINUE_WORKFLOW_PROTOCOL, 'authoritative'),
+        checkpoint_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.CHECKPOINT_WORKFLOW_PROTOCOL, 'authoritative'),
+        resume_session: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.RESUME_SESSION_PROTOCOL, 'authoritative'),
     },
 };

package/dist/mcp/transports/http-entry.js

@@ -39,8 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.startHttpServer = startHttpServer;
 const server_js_1 = require("../server.js");
 const http_listener_js_1 = require("./http-listener.js");
-const container_js_1 = require("../../di/container.js");
-const tokens_js_1 = require("../../di/tokens.js");
+const shutdown_hooks_js_1 = require("./shutdown-hooks.js");
 const crypto = __importStar(require("crypto"));
 const express_1 = __importDefault(require("express"));
 async function startHttpServer(port) {
@@ -60,28 +59,10 @@ async function startHttpServer(port) {
     const boundPort = listener.getBoundPort();
     console.error('[Transport] WorkRail MCP Server running on HTTP');
     console.error(`[Transport] MCP endpoint: http://localhost:${boundPort}/mcp`);
-    const shutdownEvents = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ShutdownEvents);
-    const processSignals = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ProcessSignals);
-    const terminator = container_js_1.container.resolve(tokens_js_1.DI.Runtime.ProcessTerminator);
-    processSignals.on('SIGINT', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGINT' }));
-    processSignals.on('SIGTERM', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGTERM' }));
-    processSignals.on('SIGHUP', () => shutdownEvents.emit({ kind: 'shutdown_requested', signal: 'SIGHUP' }));
-    let shutdownStarted = false;
-    shutdownEvents.onShutdown((event) => {
-        if (shutdownStarted)
-            return;
-        shutdownStarted = true;
-        void (async () => {
-            try {
-                console.error(`[Shutdown] Requested by ${event.signal}. Stopping services...`);
-                await listener.stop();
-                await ctx.httpServer?.stop();
-                terminator.terminate({ kind: 'success' });
-            }
-            catch (err) {
-                console.error('[Shutdown] Error while stopping services:', err);
-                terminator.terminate({ kind: 'failure' });
-            }
-        })();
+    (0, shutdown_hooks_js_1.wireShutdownHooks)({
+        onBeforeTerminate: async () => {
+            await listener.stop();
+            await ctx.httpServer?.stop();
+        },
     });
 }