@exaudeus/workrail 1.6.0 → 1.7.0

package/dist/manifest.json

@@ -558,8 +558,8 @@
       "bytes": 2464
     },
     "mcp/handlers/v2-advance-core/event-builders.js": {
-      "sha256": "6a8f51c9723ce0486f20749e392c1ec8e3fc9ccf83de43df6658d0a9c9d06441",
-      "bytes": 5722
+      "sha256": "cb510635b173965f6cb2af312289f0903600a7483376b8b7156351f5bcf1fbd2",
+      "bytes": 5774
     },
     "mcp/handlers/v2-advance-core/index.d.ts": {
       "sha256": "a927c7e13912cfcad6340922a24f5b9331d513ce25191049aabdce96a7a86a68",
@@ -614,8 +614,8 @@
       "bytes": 674
     },
     "mcp/handlers/v2-context-budget.js": {
-      "sha256": "41633eaf3b61838a62457768393dd0134cf4ffb1b201af28e048bfb711f6f01d",
-      "bytes": 7173
+      "sha256": "5450c08d25900fd639090ba0090fc4c866e02295ee11aa52c187447424fdc4c2",
+      "bytes": 7199
     },
     "mcp/handlers/v2-error-mapping.d.ts": {
       "sha256": "bbaf580dfc22ca6b5ef1d57036fb549c640d6f37bd7d525f1a805b4d14c4d75c",
@@ -686,16 +686,16 @@
       "bytes": 2789
     },
     "mcp/handlers/v2-execution/start.js": {
-      "sha256": "5eab7a7a5fdf021f7e4bc656de1dbfe791e6610ab9e1bacb15dad4f6423f1d58",
-      "bytes": 15248
+      "sha256": "aeee2ba6b1cc0d461d2421eed0f99ca22f4006baa7f5663cc28855d00c950d87",
+      "bytes": 15015
     },
     "mcp/handlers/v2-resume.d.ts": {
       "sha256": "d88f6c35bcaf946666c837b72fda3702a2ebab5e478eb90f7b4b672a0e5fa24f",
       "bytes": 471
     },
     "mcp/handlers/v2-resume.js": {
-      "sha256": "a8f51a680eec031e23148bd64f6d647d765c79eec738cbd6182650533248f16f",
-      "bytes": 2929
+      "sha256": "74d66519764615780c556828c23ada5fa7df887c8263793de4323322aef14408",
+      "bytes": 2826
     },
     "mcp/handlers/v2-state-conversion.d.ts": {
       "sha256": "94bd06904ef58dd210ff17ffb75c2492beea8937eb06d99749e5d860c0e0d96b",
@@ -721,6 +721,14 @@
       "sha256": "bed0ffc401958c14343158e142e4be344bad49cabc95f99a811d872bc76989a7",
       "bytes": 6027
     },
+    "mcp/handlers/v2-workspace-resolution.d.ts": {
+      "sha256": "45cdf30b7989d16201b4569c6c109e9ccea04c76fd044af1471fe57faa49da3a",
+      "bytes": 483
+    },
+    "mcp/handlers/v2-workspace-resolution.js": {
+      "sha256": "4c6765112c49ade9c04b5f0606026e5058071ce278a6fb9c3b8207b7ca79c697",
+      "bytes": 909
+    },
     "mcp/handlers/workflow.d.ts": {
       "sha256": "050565039a20af3f7fc8311337ff4547438ecc59433e5744aacce8f203326774",
       "bytes": 1748
@@ -766,8 +774,8 @@
       "bytes": 132
     },
     "mcp/tool-descriptions.js": {
-      "sha256": "a14ecf27cea136307d6016862f6897d1ba776f51f713e8c9cc65281f4ab7be4e",
-      "bytes": 16654
+      "sha256": "1444469a7f3ac328573cc8af0cca347754e17fb184a832f78405fd4f21ed6350",
+      "bytes": 17534
     },
     "mcp/tool-factory.d.ts": {
       "sha256": "0fe3c6b863b2d7aef0c3d659ff54f3a9ee8a0a3c2005b6565d2f8ad517bc7211",
@@ -826,12 +834,12 @@
       "bytes": 3078
     },
     "mcp/v2/tools.d.ts": {
-      "sha256": "a6fc8e1feb02807a4f7984dcd00358081a4b63b6b9ec9b88bb2bff833c280322",
-      "bytes": 5172
+      "sha256": "8d37b32d7a00d534b2ecbdc71018e3849714531ec3021862427494be85909eab",
+      "bytes": 5486
     },
     "mcp/v2/tools.js": {
-      "sha256": "7460146a5d0d3a0f67d4d42e512d467455169d22bb99f69ad812848da862b8a4",
-      "bytes": 6721
+      "sha256": "0d26b75a7e038f494570f5fdc1d624f5bb28bfa7e368ea4d3259ae27dc889301",
+      "bytes": 7748
     },
     "mcp/validation/bounded-json.d.ts": {
       "sha256": "82203ac6123d5c6989606c3b5405aaea99ab829c8958835f9ae3ba45b8bc8fd5",
@@ -1162,12 +1170,12 @@
       "bytes": 447
     },
     "v2/durable-core/constants.d.ts": {
-      "sha256": "73121ae0a507f2ceb073c29e5f156e7958db47a47a034589c7534baa7769faa9",
-      "bytes": 3511
+      "sha256": "2cdc1fe66cb2024e17977e024c73b9bb50845b70c9ac3925c2635e843a94f7f8",
+      "bytes": 3699
     },
     "v2/durable-core/constants.js": {
-      "sha256": "67a2be5aa35498610cd199edec0f6558fef6efbdd0739e53c53f1f9198d66067",
-      "bytes": 3453
+      "sha256": "29372d3e7f868b5c40d6270a1f39477a680524688e73b03613305fafef4a9553",
+      "bytes": 3558
     },
     "v2/durable-core/domain/ack-advance-append-plan.d.ts": {
       "sha256": "2e802606656a0c1938192e5533aa46c74bc42789b5c315c79f6de4850017b30e",
@@ -1310,8 +1318,8 @@
       "bytes": 983
     },
     "v2/durable-core/domain/recap-recovery.js": {
-      "sha256": "d0145878abcf5b71fa1fdf87faacb7dee861217450947b6420422c1371d36fad",
-      "bytes": 2879
+      "sha256": "4829d21e589ce5ed35beb9118eb07ffe05f6c1f18f6a20d7830b29ccc2da4e89",
+      "bytes": 3034
     },
     "v2/durable-core/domain/recommendation-warnings.d.ts": {
       "sha256": "a9f9e4c09f2ab72e858d8f4045201448a62cbf7b4b1070d0448498f858331222",
@@ -1614,8 +1622,8 @@
       "bytes": 4285
     },
     "v2/durable-core/schemas/session/outputs.js": {
-      "sha256": "d41959a26236e75ab4a323619df2f8ea79f002b448504045a908dfeacfade378",
-      "bytes": 2050
+      "sha256": "8ec5056762f2a0000ab2b1caf01b468f39695b778039c68ea85a9f42fccf3986",
+      "bytes": 2156
     },
     "v2/durable-core/schemas/session/preferences.d.ts": {
       "sha256": "763697078bda9fa8fb7a499978a94d85d1852f0fd8fc07af295ac895d25dba66",
@@ -1810,12 +1818,12 @@
       "bytes": 28456
     },
     "v2/infra/local/session-summary-provider/index.d.ts": {
-      "sha256": "8843c26694d12147c322a4ff1f220cef53774c1ea7087241cb6badd12a360fda",
-      "bytes": 1069
+      "sha256": "59db8bf5e38f983eedd21ff902a24324f7bedbb5f3eade1e4b0d5742b28447c2",
+      "bytes": 1004
     },
     "v2/infra/local/session-summary-provider/index.js": {
-      "sha256": "5dadd21632795d624d0be4be1957329242df6c105ccf507e024e397ab3e63e7f",
-      "bytes": 5728
+      "sha256": "f6c0df4a3355241ee3eb83c0013f9a252479f27f4c9172e0607464339fba6920",
+      "bytes": 5655
     },
     "v2/infra/local/sha256/index.d.ts": {
       "sha256": "8a727b7e54a38275ca6f9f1b8730f97cfc0a212df035df1bdc58e716e6824230",
@@ -1850,12 +1858,12 @@
       "bytes": 304
     },
     "v2/infra/local/workspace-anchor/index.d.ts": {
-      "sha256": "90515ae92ac0230a279a28b82e26bc8be8f62c4cd6f6999630dc07f9a64e3296",
-      "bytes": 705
+      "sha256": "ac5cfe8d36fab1bcff8ee1e4c13cd4b8f20b7cf109647b76bfb74e720b9eda41",
+      "bytes": 537
     },
     "v2/infra/local/workspace-anchor/index.js": {
-      "sha256": "69541a7f2a6837ff0790c99740000a71521a60671b4fd7c4a2245a48e56bb9b7",
-      "bytes": 2102
+      "sha256": "a0fe032a9205606c6d592221f1300a3113c7d0cb3e126e458fef3dc8fa6e823c",
+      "bytes": 2272
     },
     "v2/ports/base32.port.d.ts": {
       "sha256": "64aa2f2003a552917cbf71474472fc5e4afffaa29577204bbcbe5ffa989ceb82",
@@ -1994,8 +2002,8 @@
       "bytes": 77
     },
     "v2/ports/workspace-anchor.port.d.ts": {
-      "sha256": "228cce9bff3cbaa430bf38be3a1bc326885ec07c7952af2824735bc7adbf9af3",
-      "bytes": 759
+      "sha256": "8614bc27a958291d53d6a24ffc30fdf5352d98f02b79470993d6c134e72d83eb",
+      "bytes": 751
     },
     "v2/ports/workspace-anchor.port.js": {
       "sha256": "d43aa81f5bc89faa359e0f97c814ba25155591ff078fbb9bfd40f8c7c9683230",
@@ -2014,8 +2022,8 @@
       "bytes": 955
     },
     "v2/projections/artifacts.js": {
-      "sha256": "e20ae7c41813de53701dc5993b4ead5e09af9eb724340dfd8d7a0b2670857217",
-      "bytes": 2007
+      "sha256": "eb06aff128112850fdc8b3bfafae759500ca65aed279f096a077e000a9a1bf99",
+      "bytes": 2033
     },
     "v2/projections/capabilities.d.ts": {
       "sha256": "ee4c4bb728b5fc7343a43c9bb13a981a9bf0bd1b39e68ff8c866b4119012eac1",

package/dist/mcp/handlers/v2-advance-core/event-builders.js

@@ -84,7 +84,7 @@ function buildNotesOutputs(allowNotesAppend, attemptId, inputOutput) {
             outputId: String((0, index_js_1.asOutputId)(`out_recap_${String(attemptId)}`)),
             outputChannel: constants_js_1.OUTPUT_CHANNEL.RECAP,
             payload: {
-                payloadKind: 'notes',
+                payloadKind: constants_js_1.PAYLOAD_KIND.NOTES,
                 notesMarkdown: (0, notes_markdown_js_1.toNotesMarkdownV1)(inputOutput.notesMarkdown),
             },
         }];
@@ -102,7 +102,7 @@ function buildArtifactOutputs(inputArtifacts, attemptId, sha256) {
             outputId: (0, index_js_1.asOutputId)(`out_artifact_${String(attemptId)}_${idx}`),
             outputChannel: constants_js_1.OUTPUT_CHANNEL.ARTIFACT,
             payload: {
-                payloadKind: 'artifact_ref',
+                payloadKind: constants_js_1.PAYLOAD_KIND.ARTIFACT_REF,
                 sha256: sha256.sha256(canonicalBytes),
                 contentType: 'application/json',
                 byteLength: canonicalBytes.length,

package/dist/mcp/handlers/v2-context-budget.js

@@ -158,7 +158,7 @@ function collectArtifactsForEvaluation(args) {
             continue;
         if (e.data.outputChannel !== constants_js_1.OUTPUT_CHANNEL.ARTIFACT)
             continue;
-        if (e.data.payload.payloadKind !== 'artifact_ref')
+        if (e.data.payload.payloadKind !== constants_js_1.PAYLOAD_KIND.ARTIFACT_REF)
             continue;
         const payload = e.data.payload;
         if (payload.content === undefined)

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

@@ -16,6 +16,7 @@ const observation_builder_js_1 = require("../../../v2/durable-core/domain/observ
 const workflow_source_js_1 = require("../../../types/workflow-source.js");
 const workflow_definition_js_1 = require("../../../types/workflow-definition.js");
 const v2_execution_helpers_js_1 = require("../v2-execution-helpers.js");
+const v2_workspace_resolution_js_1 = require("../v2-workspace-resolution.js");
 const v2_token_ops_js_1 = require("../v2-token-ops.js");
 const v2_state_conversion_js_1 = require("../v2-state-conversion.js");
 const v2_execution_helpers_js_2 = require("../v2-execution-helpers.js");
@@ -229,15 +230,8 @@ function executeStartWorkflow(input, ctx) {
         pinnedStore,
     })
         .andThen(({ workflow, firstStep, workflowHash, pinnedWorkflow }) => {
-        const workspaceResolver = ctx.v2.workspaceResolver;
-        const primaryRootUri = ctx.v2.resolvedRootUris?.[0];
-        const anchorsRA = workspaceResolver
-            ? (primaryRootUri
-                ? workspaceResolver.resolveFromUri(primaryRootUri)
-                : workspaceResolver.resolveFromCwd())
-                .map((anchors) => (0, observation_builder_js_1.anchorsToObservations)(anchors))
-                .orElse(() => (0, neverthrow_1.okAsync)([]))
-            : (0, neverthrow_1.okAsync)([]);
+        const anchorsRA = (0, v2_workspace_resolution_js_1.resolveWorkspaceAnchors)(ctx.v2, input.workspacePath)
+            .map((anchors) => (0, observation_builder_js_1.anchorsToObservations)(anchors));
         return anchorsRA.andThen((observations) => {
             const sessionId = idFactory.mintSessionId();
             const runId = idFactory.mintRunId();

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

@@ -6,6 +6,7 @@ const output_schemas_js_1 = require("../output-schemas.js");
 const v2_token_ops_js_1 = require("./v2-token-ops.js");
 const index_js_1 = require("../../v2/durable-core/ids/index.js");
 const resume_session_js_1 = require("../../v2/usecases/resume-session.js");
+const v2_workspace_resolution_js_1 = require("./v2-workspace-resolution.js");
 function anchorValue(anchors, key) {
     const anchor = anchors.find((a) => a.key === key);
     return anchor?.value;
@@ -18,16 +19,8 @@ async function handleV2ResumeSession(input, ctx) {
     if (!v2.sessionSummaryProvider) {
         return (0, types_js_1.errNotRetryable)('INTERNAL_ERROR', 'resume_session requires sessionSummaryProvider port');
     }
-    let anchors = [];
-    if (v2.workspaceResolver) {
-        const primaryRootUri = v2.resolvedRootUris?.[0];
-        const anchorRes = await (primaryRootUri
-            ? v2.workspaceResolver.resolveFromUri(primaryRootUri)
-            : v2.workspaceResolver.resolveFromCwd());
-        if (anchorRes.isOk()) {
-            anchors = anchorRes.value;
-        }
-    }
+    const anchorsResult = await (0, v2_workspace_resolution_js_1.resolveWorkspaceAnchors)(v2, input.workspacePath);
+    const anchors = anchorsResult.isOk() ? anchorsResult.value : [];
     const query = {
         gitHeadSha: input.gitHeadSha ?? anchorValue(anchors, 'git_head_sha'),
         gitBranch: input.gitBranch ?? anchorValue(anchors, 'git_branch'),

package/dist/mcp/handlers/v2-workspace-resolution.d.ts

@@ -0,0 +1,5 @@
+import type { ResultAsync } from 'neverthrow';
+import type { WorkspaceAnchor, WorkspaceSource } from '../../v2/ports/workspace-anchor.port.js';
+import type { V2Dependencies } from '../types.js';
+export declare function selectWorkspaceSource(workspacePath: string | undefined, resolvedRootUris: readonly string[]): WorkspaceSource;
+export declare function resolveWorkspaceAnchors(v2: V2Dependencies, workspacePath: string | undefined): ResultAsync<readonly WorkspaceAnchor[], never>;

package/dist/mcp/handlers/v2-workspace-resolution.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectWorkspaceSource = selectWorkspaceSource;
+exports.resolveWorkspaceAnchors = resolveWorkspaceAnchors;
+const neverthrow_1 = require("neverthrow");
+function selectWorkspaceSource(workspacePath, resolvedRootUris) {
+    if (workspacePath !== undefined) {
+        return { kind: 'explicit_path', path: workspacePath };
+    }
+    const primaryUri = resolvedRootUris[0];
+    if (primaryUri !== undefined) {
+        return { kind: 'mcp_root_uri', uri: primaryUri };
+    }
+    return { kind: 'server_cwd' };
+}
+function resolveWorkspaceAnchors(v2, workspacePath) {
+    if (!v2.workspaceResolver)
+        return (0, neverthrow_1.okAsync)([]);
+    const source = selectWorkspaceSource(workspacePath, v2.resolvedRootUris ?? []);
+    return v2.workspaceResolver.resolve(source)
+        .orElse(() => (0, neverthrow_1.okAsync)([]));
+}

package/dist/mcp/tool-descriptions.js

@@ -75,6 +75,8 @@ What to do:
 3. Optionally add output.notesMarkdown summarizing your work
 4. Don't predict what comes next - the workflow will tell you
 
+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).
 
@@ -130,6 +132,8 @@ Returns: checkpointNodeId + a fresh stateToken.`,
 
 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)
@@ -225,6 +229,11 @@ REQUIRED BEHAVIOR:
 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
@@ -295,6 +304,10 @@ Call this when resuming a workflow without a stateToken. WorkRail ranks sessions
 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.`,
     },
 };

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

@@ -16,12 +16,15 @@ export type V2InspectWorkflowInput = z.infer<typeof V2InspectWorkflowInput>;
 export declare const V2StartWorkflowInput: z.ZodObject<{
     workflowId: z.ZodString;
     context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    workspacePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
     workflowId: string;
     context?: Record<string, unknown> | undefined;
+    workspacePath?: string | undefined;
 }, {
     workflowId: string;
     context?: Record<string, unknown> | undefined;
+    workspacePath?: string | undefined;
 }>;
 export type V2StartWorkflowInput = z.infer<typeof V2StartWorkflowInput>;
 export declare const V2ContinueWorkflowInput: z.ZodPipeline<z.ZodEffects<z.ZodObject<{
@@ -119,12 +122,15 @@ export declare const V2ResumeSessionInput: z.ZodObject<{
     query: z.ZodOptional<z.ZodString>;
     gitBranch: z.ZodOptional<z.ZodString>;
     gitHeadSha: z.ZodOptional<z.ZodString>;
+    workspacePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strict", z.ZodTypeAny, {
     query?: string | undefined;
+    workspacePath?: string | undefined;
     gitBranch?: string | undefined;
     gitHeadSha?: string | undefined;
 }, {
     query?: string | undefined;
+    workspacePath?: string | undefined;
     gitBranch?: string | undefined;
     gitHeadSha?: string | undefined;
 }>;

package/dist/mcp/v2/tools.js

@@ -10,6 +10,10 @@ exports.V2InspectWorkflowInput = zod_1.z.object({
 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'),
     context: zod_1.z.record(zod_1.z.unknown()).optional().describe('External facts influencing execution (ticketId, branch, constraints). Pass once at start to establish baseline. WorkRail auto-loads context on subsequent continue_workflow calls. Only pass context again if facts have CHANGED (e.g., user provided new information). Do NOT re-pass unchanged values.'),
+    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 anchor this session to your workspace for future resume_session discovery. Pass this on every start_workflow call. If omitted, WorkRail uses the server process directory which may not match your workspace.'),
 });
 exports.V2ContinueWorkflowInput = zod_1.z.object({
     intent: zod_1.z.enum(['advance', 'rehydrate']).optional().describe('What you want to do. Auto-inferred from ackToken if omitted: ' +
@@ -62,6 +66,10 @@ exports.V2ResumeSessionInput = zod_1.z.object({
     query: zod_1.z.string().max(256).optional().describe('Free text search to find a relevant session. Matches against recap notes and workflow IDs.'),
     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.'),
 }).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/v2/durable-core/constants.d.ts

@@ -40,6 +40,11 @@ export declare const OUTPUT_CHANNEL: {
     readonly ARTIFACT: "artifact";
 };
 export type OutputChannelV1 = typeof OUTPUT_CHANNEL[keyof typeof OUTPUT_CHANNEL];
+export declare const PAYLOAD_KIND: {
+    readonly NOTES: "notes";
+    readonly ARTIFACT_REF: "artifact_ref";
+};
+export type PayloadKindV1 = typeof PAYLOAD_KIND[keyof typeof PAYLOAD_KIND];
 export declare const EDGE_KIND: {
     readonly ACKED_STEP: "acked_step";
     readonly CHECKPOINT: "checkpoint";

package/dist/v2/durable-core/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AUTONOMY_MODE = exports.ADVANCE_INTENT = exports.MANIFEST_KIND = exports.EDGE_CAUSE = exports.ADVANCE_OUTCOME = exports.ENGINE_STATE = exports.EDGE_KIND = exports.OUTPUT_CHANNEL = exports.EVENT_KIND = exports.DELIMITER_SAFE_ID_PATTERN = exports.SHA256_DIGEST_PATTERN = exports.RECOVERY_BUDGET_BYTES = exports.TRUNCATION_MARKER = exports.DEFAULT_RETRY_AFTER_MS = exports.SESSION_LOCK_RETRY_AFTER_MS = exports.MAX_OBSERVATION_SHORT_STRING_LENGTH = exports.MAX_CONTEXT_DEPTH = exports.MAX_CONTEXT_BYTES = exports.MAX_VALIDATION_SUGGESTIONS_BYTES = exports.MAX_VALIDATION_ISSUES_BYTES = exports.MAX_VALIDATION_SUGGESTION_ITEM_BYTES = exports.MAX_VALIDATION_ISSUE_ITEM_BYTES = exports.MAX_OUTPUT_NOTES_MARKDOWN_BYTES = exports.MAX_DECISION_TRACE_TOTAL_BYTES = exports.MAX_DECISION_TRACE_ENTRY_SUMMARY_BYTES = exports.MAX_DECISION_TRACE_ENTRIES = exports.MAX_BLOCKER_SUGGESTED_FIX_BYTES = exports.MAX_BLOCKER_MESSAGE_BYTES = exports.MAX_BLOCKERS = void 0;
+exports.AUTONOMY_MODE = exports.ADVANCE_INTENT = exports.MANIFEST_KIND = exports.EDGE_CAUSE = exports.ADVANCE_OUTCOME = exports.ENGINE_STATE = exports.EDGE_KIND = exports.PAYLOAD_KIND = exports.OUTPUT_CHANNEL = exports.EVENT_KIND = exports.DELIMITER_SAFE_ID_PATTERN = exports.SHA256_DIGEST_PATTERN = exports.RECOVERY_BUDGET_BYTES = exports.TRUNCATION_MARKER = exports.DEFAULT_RETRY_AFTER_MS = exports.SESSION_LOCK_RETRY_AFTER_MS = exports.MAX_OBSERVATION_SHORT_STRING_LENGTH = exports.MAX_CONTEXT_DEPTH = exports.MAX_CONTEXT_BYTES = exports.MAX_VALIDATION_SUGGESTIONS_BYTES = exports.MAX_VALIDATION_ISSUES_BYTES = exports.MAX_VALIDATION_SUGGESTION_ITEM_BYTES = exports.MAX_VALIDATION_ISSUE_ITEM_BYTES = exports.MAX_OUTPUT_NOTES_MARKDOWN_BYTES = exports.MAX_DECISION_TRACE_TOTAL_BYTES = exports.MAX_DECISION_TRACE_ENTRY_SUMMARY_BYTES = exports.MAX_DECISION_TRACE_ENTRIES = exports.MAX_BLOCKER_SUGGESTED_FIX_BYTES = exports.MAX_BLOCKER_MESSAGE_BYTES = exports.MAX_BLOCKERS = void 0;
 exports.MAX_BLOCKERS = 10;
 exports.MAX_BLOCKER_MESSAGE_BYTES = 512;
 exports.MAX_BLOCKER_SUGGESTED_FIX_BYTES = 1024;
@@ -41,6 +41,10 @@ exports.OUTPUT_CHANNEL = {
     RECAP: 'recap',
     ARTIFACT: 'artifact',
 };
+exports.PAYLOAD_KIND = {
+    NOTES: 'notes',
+    ARTIFACT_REF: 'artifact_ref',
+};
 exports.EDGE_KIND = {
     ACKED_STEP: 'acked_step',
     CHECKPOINT: 'checkpoint',

package/dist/v2/durable-core/domain/recap-recovery.js

@@ -4,6 +4,7 @@ exports.collectAncestryRecap = collectAncestryRecap;
 exports.collectDownstreamRecap = collectDownstreamRecap;
 exports.buildChildSummary = buildChildSummary;
 const neverthrow_1 = require("neverthrow");
+const constants_js_1 = require("../constants.js");
 function collectAncestryRecap(args) {
     const buildChain = (cur, visited) => {
         if (!cur || visited.has(cur))
@@ -22,9 +23,9 @@ function collectAncestryRecap(args) {
         if (!nodeOutputs)
             return [];
         return nodeOutputs.currentByChannel.recap
-            .filter(r => r.payload.payloadKind === 'notes')
+            .filter(r => r.payload.payloadKind === constants_js_1.PAYLOAD_KIND.NOTES)
             .map(r => {
-            if (r.payload.payloadKind === 'notes') {
+            if (r.payload.payloadKind === constants_js_1.PAYLOAD_KIND.NOTES) {
                 return r.payload.notesMarkdown;
             }
             return '';
@@ -48,9 +49,9 @@ function collectDownstreamRecap(args) {
         if (!nodeOutputs)
             return [];
         return nodeOutputs.currentByChannel.recap
-            .filter(r => r.payload.payloadKind === 'notes')
+            .filter(r => r.payload.payloadKind === constants_js_1.PAYLOAD_KIND.NOTES)
             .map(r => {
-            if (r.payload.payloadKind === 'notes') {
+            if (r.payload.payloadKind === constants_js_1.PAYLOAD_KIND.NOTES) {
                 return r.payload.notesMarkdown;
             }
             return '';

package/dist/v2/durable-core/schemas/session/outputs.js

@@ -10,7 +10,7 @@ const sha256DigestSchema = zod_1.z
     .describe('sha256 digest in WorkRail v2 format');
 exports.OutputChannelSchema = zod_1.z.enum(['recap', 'artifact']);
 exports.NotesPayloadV1Schema = zod_1.z.object({
-    payloadKind: zod_1.z.literal('notes'),
+    payloadKind: zod_1.z.literal(constants_js_1.PAYLOAD_KIND.NOTES),
     notesMarkdown: zod_1.z
         .string()
         .min(1)
@@ -19,7 +19,7 @@ exports.NotesPayloadV1Schema = zod_1.z.object({
     }),
 });
 exports.ArtifactRefPayloadV1Schema = zod_1.z.object({
-    payloadKind: zod_1.z.literal('artifact_ref'),
+    payloadKind: zod_1.z.literal(constants_js_1.PAYLOAD_KIND.ARTIFACT_REF),
     sha256: sha256DigestSchema,
     contentType: zod_1.z.string().min(1),
     byteLength: zod_1.z.number().int().nonnegative(),
@@ -34,7 +34,7 @@ exports.NodeOutputAppendedDataV1Schema = zod_1.z
     payload: exports.OutputPayloadV1Schema,
 })
     .superRefine((v, ctx) => {
-    if (v.outputChannel === 'recap' && v.payload.payloadKind !== 'notes') {
+    if (v.outputChannel === constants_js_1.OUTPUT_CHANNEL.RECAP && v.payload.payloadKind !== constants_js_1.PAYLOAD_KIND.NOTES) {
         ctx.addIssue({
             code: zod_1.z.ZodIssueCode.custom,
             message: 'outputChannel=recap requires payloadKind=notes',

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

@@ -13,6 +13,4 @@ export declare class LocalSessionSummaryProviderV2 implements SessionSummaryProv
     private readonly ports;
     constructor(ports: LocalSessionSummaryProviderPorts);
     loadHealthySummaries(): ResultAsync<readonly HealthySessionSummary[], SessionSummaryError>;
-    private collectHealthySummaries;
-    private tryLoadSummary;
 }

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

@@ -9,6 +9,16 @@ const run_dag_js_1 = require("../../../projections/run-dag.js");
 const node_outputs_js_1 = require("../../../projections/node-outputs.js");
 const constants_js_1 = require("../../../durable-core/constants.js");
 const MAX_SESSIONS_TO_SCAN = 50;
+const MAX_RECAP_ANCESTOR_DEPTH = 100;
+const EMPTY_OBSERVATIONS = {
+    gitHeadSha: null,
+    gitBranch: null,
+    repoRootHash: null,
+};
+const UNKNOWN_WORKFLOW = {
+    workflowId: null,
+    workflowName: null,
+};
 class LocalSessionSummaryProviderV2 {
     constructor(ports) {
         this.ports = ports;
@@ -22,123 +32,107 @@ class LocalSessionSummaryProviderV2 {
             code: 'SESSION_SUMMARY_ENUMERATION_FAILED',
             message: `Failed to enumerate sessions: ${fsErr.message}`,
         }))
-            .andThen((sessionIds) => {
-            const capped = sessionIds.slice(0, MAX_SESSIONS_TO_SCAN);
-            return this.collectHealthySummaries(capped);
-        });
-    }
-    collectHealthySummaries(sessionIds) {
-        const summaries = [];
-        let chain = (0, neverthrow_1.okAsync)(undefined);
-        for (const sessionId of sessionIds) {
-            chain = chain.andThen(() => this.tryLoadSummary(sessionId).map((summary) => {
-                if (summary !== null) {
-                    summaries.push(summary);
-                }
-            }));
-        }
-        return chain.map(() => summaries);
-    }
-    tryLoadSummary(sessionId) {
-        return this.ports.sessionStore
-            .load(sessionId)
-            .map((truth) => {
-            const healthRes = (0, session_health_js_1.projectSessionHealthV2)(truth);
-            if (healthRes.isErr())
-                return null;
-            if (healthRes.value.kind !== 'healthy')
-                return null;
-            const dagRes = (0, run_dag_js_1.projectRunDagV2)(truth.events);
-            if (dagRes.isErr())
-                return null;
-            const runs = Object.values(dagRes.value.runsById);
-            if (runs.length === 0)
-                return null;
-            const runsWithActivity = runs
-                .filter((r) => r.preferredTipNodeId !== null)
-                .map((r) => {
-                const tipNode = r.nodesById[r.preferredTipNodeId];
-                const maxEventIndex = tipNode ? tipNode.createdAtEventIndex : 0;
-                return { run: r, lastActivityEventIndex: maxEventIndex };
-            })
-                .sort((a, b) => b.lastActivityEventIndex - a.lastActivityEventIndex);
-            if (runsWithActivity.length === 0)
-                return null;
-            const bestRun = runsWithActivity[0];
-            const run = bestRun.run;
-            const outputsRes = (0, node_outputs_js_1.projectNodeOutputsV2)(truth.events);
-            const recapSnippet = outputsRes.isOk() && run.preferredTipNodeId
-                ? extractRecapFromOutputs(outputsRes.value, run.preferredTipNodeId)
-                : null;
-            const observations = extractObservations(truth.events);
-            const workflow = extractWorkflowIdentity(truth.events, run.runId);
-            return {
-                sessionId,
-                runId: run.runId,
-                preferredTip: {
-                    nodeId: run.preferredTipNodeId,
-                    lastActivityEventIndex: bestRun.lastActivityEventIndex,
-                },
-                recapSnippet,
-                observations,
-                workflow,
-            };
-        })
-            .orElse(() => (0, neverthrow_1.okAsync)(null));
+            .andThen((sessionIds) => collectHealthySummaries(sessionIds.slice(0, MAX_SESSIONS_TO_SCAN), this.ports.sessionStore));
     }
 }
 exports.LocalSessionSummaryProviderV2 = LocalSessionSummaryProviderV2;
-function extractRecapFromOutputs(outputs, nodeId) {
-    const nodeView = outputs.nodesById[nodeId];
-    if (!nodeView)
+function collectHealthySummaries(sessionIds, sessionStore) {
+    return sessionIds.reduce((acc, sessionId) => acc.andThen((summaries) => loadSessionSummary(sessionId, sessionStore).map((summary) => summary !== null ? [...summaries, summary] : summaries)), (0, neverthrow_1.okAsync)([]));
+}
+function loadSessionSummary(sessionId, sessionStore) {
+    return sessionStore
+        .load(sessionId)
+        .map((truth) => projectSessionSummary(sessionId, truth))
+        .orElse(() => (0, neverthrow_1.okAsync)(null));
+}
+function projectSessionSummary(sessionId, truth) {
+    const health = (0, session_health_js_1.projectSessionHealthV2)(truth);
+    if (health.isErr() || health.value.kind !== 'healthy')
         return null;
-    const recapOutputs = nodeView.currentByChannel['recap'];
-    if (!recapOutputs || recapOutputs.length === 0)
+    const dag = (0, run_dag_js_1.projectRunDagV2)(truth.events);
+    if (dag.isErr())
         return null;
-    const latest = recapOutputs[recapOutputs.length - 1];
-    if (latest.payload.payloadKind !== 'notes')
+    const bestRun = selectBestRun(Object.values(dag.value.runsById));
+    if (!bestRun)
         return null;
-    const markdown = latest.payload.notesMarkdown;
-    if (!markdown || typeof markdown !== 'string')
+    const outputsRes = (0, node_outputs_js_1.projectNodeOutputsV2)(truth.events);
+    const recapSnippet = outputsRes.isOk()
+        ? extractAggregateRecap(outputsRes.value, bestRun.run, bestRun.tipNodeId)
+        : null;
+    return {
+        sessionId,
+        runId: bestRun.run.runId,
+        preferredTip: {
+            nodeId: bestRun.tipNodeId,
+            lastActivityEventIndex: bestRun.lastActivityEventIndex,
+        },
+        recapSnippet,
+        observations: extractObservations(truth.events),
+        workflow: extractWorkflowIdentity(truth.events, bestRun.run.runId),
+    };
+}
+function selectBestRun(runs) {
+    const runsWithTip = runs.flatMap((r) => {
+        const tipNodeId = r.preferredTipNodeId;
+        if (!tipNodeId)
+            return [];
+        const tipNode = r.nodesById[tipNodeId];
+        return [{ run: r, tipNodeId, lastActivityEventIndex: tipNode?.createdAtEventIndex ?? 0 }];
+    });
+    if (runsWithTip.length === 0)
         return null;
-    return (0, resume_ranking_js_1.asRecapSnippet)(markdown);
+    return runsWithTip.reduce((best, r) => r.lastActivityEventIndex > best.lastActivityEventIndex ? r : best);
 }
 function extractObservations(events) {
-    let gitHeadSha = null;
-    let gitBranch = null;
-    let repoRootHash = null;
-    for (const event of events) {
-        if (event.kind !== constants_js_1.EVENT_KIND.OBSERVATION_RECORDED)
-            continue;
-        const data = event.data;
-        switch (data.key) {
-            case 'git_head_sha':
-                gitHeadSha = data.value.value;
-                break;
-            case 'git_branch':
-                gitBranch = data.value.value;
-                break;
-            case 'repo_root_hash':
-                repoRootHash = data.value.value;
-                break;
-            default:
-                break;
+    return events
+        .filter((e) => e.kind === constants_js_1.EVENT_KIND.OBSERVATION_RECORDED)
+        .reduce((acc, e) => {
+        switch (e.data.key) {
+            case 'git_head_sha': return { ...acc, gitHeadSha: e.data.value.value };
+            case 'git_branch': return { ...acc, gitBranch: e.data.value.value };
+            case 'repo_root_hash': return { ...acc, repoRootHash: e.data.value.value };
         }
-    }
-    return { gitHeadSha, gitBranch, repoRootHash };
+    }, EMPTY_OBSERVATIONS);
 }
 function extractWorkflowIdentity(events, runId) {
-    for (const event of events) {
-        if (event.kind !== constants_js_1.EVENT_KIND.RUN_STARTED)
-            continue;
-        const scope = event.scope;
-        if (scope?.runId !== runId)
-            continue;
-        const data = event.data;
-        return {
-            workflowId: data.workflowId ?? null,
-            workflowName: null,
-        };
-    }
-    return { workflowId: null, workflowName: null };
+    const event = events
+        .filter((e) => e.kind === constants_js_1.EVENT_KIND.RUN_STARTED)
+        .find((e) => e.scope.runId === runId);
+    if (!event)
+        return UNKNOWN_WORKFLOW;
+    return {
+        workflowId: event.data.workflowId,
+        workflowName: null,
+    };
+}
+function collectAncestorNodeIds(nodesById, nodeId, remainingDepth) {
+    if (remainingDepth === 0)
+        return [nodeId];
+    const node = nodesById[nodeId];
+    if (!node)
+        return [nodeId];
+    const parentIds = node.parentNodeId
+        ? collectAncestorNodeIds(nodesById, node.parentNodeId, remainingDepth - 1)
+        : [];
+    return [nodeId, ...parentIds];
+}
+function extractNodeRecapMarkdown(outputs, nodeId) {
+    const nodeView = outputs.nodesById[nodeId];
+    if (!nodeView)
+        return null;
+    const recapOutputs = nodeView.currentByChannel[constants_js_1.OUTPUT_CHANNEL.RECAP];
+    if (!recapOutputs || recapOutputs.length === 0)
+        return null;
+    const latest = recapOutputs.at(-1);
+    if (!latest || latest.payload.payloadKind !== constants_js_1.PAYLOAD_KIND.NOTES)
+        return null;
+    return latest.payload.notesMarkdown;
+}
+function extractAggregateRecap(outputs, run, tipNodeId) {
+    const parts = collectAncestorNodeIds(run.nodesById, tipNodeId, MAX_RECAP_ANCESTOR_DEPTH)
+        .map((nodeId) => extractNodeRecapMarkdown(outputs, nodeId))
+        .filter((md) => md !== null);
+    if (parts.length === 0)
+        return null;
+    return (0, resume_ranking_js_1.asRecapSnippet)(parts.join('\n\n'));
 }

package/dist/v2/infra/local/workspace-anchor/index.d.ts

@@ -1,12 +1,10 @@
 import { ResultAsync as RA } from 'neverthrow';
-import type { WorkspaceAnchorPortV2, WorkspaceContextResolverPortV2, WorkspaceAnchor, WorkspaceAnchorError } from '../../../ports/workspace-anchor.port.js';
-export declare class LocalWorkspaceAnchorV2 implements WorkspaceAnchorPortV2, WorkspaceContextResolverPortV2 {
+import type { WorkspaceContextResolverPortV2, WorkspaceSource, WorkspaceAnchor, WorkspaceAnchorError } from '../../../ports/workspace-anchor.port.js';
+export declare class LocalWorkspaceAnchorV2 implements WorkspaceContextResolverPortV2 {
     private readonly defaultCwd;
     constructor(defaultCwd: string);
-    resolveAnchors(): RA<readonly WorkspaceAnchor[], WorkspaceAnchorError>;
-    resolveFromUri(rootUri: string): RA<readonly WorkspaceAnchor[], WorkspaceAnchorError>;
-    resolveFromCwd(): RA<readonly WorkspaceAnchor[], WorkspaceAnchorError>;
-    private resolveFromPath;
-    private resolve;
+    resolve(source: WorkspaceSource): RA<readonly WorkspaceAnchor[], WorkspaceAnchorError>;
+    private resolveGitIdentityAt;
+    private runGitCommands;
     private gitCommand;
 }

package/dist/v2/infra/local/workspace-anchor/index.js

@@ -10,25 +10,27 @@ class LocalWorkspaceAnchorV2 {
     constructor(defaultCwd) {
         this.defaultCwd = defaultCwd;
     }
-    resolveAnchors() {
-        return this.resolveFromPath(this.defaultCwd);
-    }
-    resolveFromUri(rootUri) {
-        const fsPath = uriToFsPath(rootUri);
-        if (fsPath === null)
-            return (0, neverthrow_1.okAsync)([]);
-        return this.resolveFromPath(fsPath);
-    }
-    resolveFromCwd() {
-        return this.resolveFromPath(this.defaultCwd);
+    resolve(source) {
+        switch (source.kind) {
+            case 'explicit_path':
+                return this.resolveGitIdentityAt(source.path);
+            case 'mcp_root_uri': {
+                const fsPath = uriToFsPath(source.uri);
+                if (fsPath === null)
+                    return (0, neverthrow_1.okAsync)([]);
+                return this.resolveGitIdentityAt(fsPath);
+            }
+            case 'server_cwd':
+                return this.resolveGitIdentityAt(this.defaultCwd);
+        }
     }
-    resolveFromPath(cwd) {
-        return neverthrow_1.ResultAsync.fromPromise(this.resolve(cwd), (cause) => ({
+    resolveGitIdentityAt(cwd) {
+        return neverthrow_1.ResultAsync.fromPromise(this.runGitCommands(cwd), (cause) => ({
             code: 'ANCHOR_RESOLVE_FAILED',
             message: `Failed to resolve workspace anchors: ${String(cause)}`,
         }));
     }
-    async resolve(cwd) {
+    async runGitCommands(cwd) {
         const anchors = [];
         const branch = await this.gitCommand('git rev-parse --abbrev-ref HEAD', cwd);
         if (branch && branch !== 'HEAD') {

package/dist/v2/ports/workspace-anchor.port.d.ts

@@ -13,10 +13,15 @@ export type WorkspaceAnchorError = {
     readonly code: 'ANCHOR_RESOLVE_FAILED';
     readonly message: string;
 };
-export interface WorkspaceAnchorPortV2 {
-    resolveAnchors(): ResultAsync<readonly WorkspaceAnchor[], WorkspaceAnchorError>;
-}
+export type WorkspaceSource = {
+    readonly kind: 'explicit_path';
+    readonly path: string;
+} | {
+    readonly kind: 'mcp_root_uri';
+    readonly uri: string;
+} | {
+    readonly kind: 'server_cwd';
+};
 export interface WorkspaceContextResolverPortV2 {
-    resolveFromUri(rootUri: string): ResultAsync<readonly WorkspaceAnchor[], WorkspaceAnchorError>;
-    resolveFromCwd(): ResultAsync<readonly WorkspaceAnchor[], WorkspaceAnchorError>;
+    resolve(source: WorkspaceSource): ResultAsync<readonly WorkspaceAnchor[], WorkspaceAnchorError>;
 }

package/dist/v2/projections/artifacts.js

@@ -20,7 +20,7 @@ function projectArtifactsV2(events) {
         if (e.data.outputChannel !== constants_js_1.OUTPUT_CHANNEL.ARTIFACT)
             continue;
         const payload = e.data.payload;
-        if (payload.payloadKind !== 'artifact_ref')
+        if (payload.payloadKind !== constants_js_1.PAYLOAD_KIND.ARTIFACT_REF)
             continue;
         const contentPayload = payload;
         if (contentPayload.content === undefined)

package/package.json

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