@exaudeus/workrail 3.11.2 → 3.13.0

package/dist/mcp/types/tool-description-types.d.ts

@@ -1,6 +1,6 @@
 export declare const DESCRIPTION_MODES: readonly ["standard", "authoritative"];
 export type DescriptionMode = typeof DESCRIPTION_MODES[number];
-export declare const WORKFLOW_TOOL_NAMES: readonly ["discover_workflows", "preview_workflow", "advance_workflow", "validate_workflow", "get_workflow_schema", "list_workflows", "inspect_workflow", "start_workflow", "continue_workflow", "checkpoint_workflow", "resume_session"];
+export declare const WORKFLOW_TOOL_NAMES: readonly ["discover_workflows", "preview_workflow", "advance_workflow", "validate_workflow", "get_workflow_schema", "list_workflows", "inspect_workflow", "start_workflow", "continue_workflow", "checkpoint_workflow", "resume_session", "manage_workflow_source"];
 export type WorkflowToolName = typeof WORKFLOW_TOOL_NAMES[number];
 export type ToolDescriptionMap = Readonly<Record<WorkflowToolName, string>>;
 export type DescriptionsByMode = Readonly<Record<DescriptionMode, ToolDescriptionMap>>;

package/dist/mcp/types/tool-description-types.js

@@ -19,6 +19,7 @@ exports.WORKFLOW_TOOL_NAMES = [
     'continue_workflow',
     'checkpoint_workflow',
     'resume_session',
+    'manage_workflow_source',
 ];
 function isDescriptionMode(value) {
     return exports.DESCRIPTION_MODES.includes(value);

package/dist/mcp/types/workflow-tool-edition.d.ts

@@ -2,7 +2,7 @@ import type { z } from 'zod';
 import type { ToolDefinition } from '../tool-factory.js';
 import type { ToolContext } from '../types.js';
 export type V1WorkflowToolName = 'discover_workflows' | 'preview_workflow' | 'advance_workflow' | 'validate_workflow' | 'get_workflow_schema';
-export type V2WorkflowToolName = 'list_workflows' | 'inspect_workflow' | 'start_workflow' | 'continue_workflow' | 'checkpoint_workflow' | 'resume_session';
+export type V2WorkflowToolName = 'list_workflows' | 'inspect_workflow' | 'start_workflow' | 'continue_workflow' | 'checkpoint_workflow' | 'resume_session' | 'manage_workflow_source';
 export type McpCallToolResult = {
     readonly content: ReadonlyArray<{
         readonly type: 'text';

package/dist/mcp/types.d.ts

@@ -20,6 +20,7 @@ import type { ValidationPipelineDepsPhase1a } from '../application/services/work
 import type { TokenAliasStorePortV2 } from '../v2/ports/token-alias-store.port.js';
 import type { RandomEntropyPortV2 } from '../v2/ports/random-entropy.port.js';
 import type { RememberedRootsStorePortV2 } from '../v2/ports/remembered-roots-store.port.js';
+import type { ManagedSourceStorePortV2 } from '../v2/ports/managed-source-store.port.js';
 export interface SessionHealthDetails {
     readonly health: SessionHealthV2;
 }
@@ -61,6 +62,7 @@ export interface V2Dependencies {
     readonly tokenCodecPorts: TokenCodecPorts;
     readonly tokenAliasStore: TokenAliasStorePortV2;
     readonly rememberedRootsStore?: RememberedRootsStorePortV2;
+    readonly managedSourceStore?: ManagedSourceStorePortV2;
     readonly entropy: RandomEntropyPortV2;
     readonly validationPipelineDeps: ValidationPipelineDepsPhase1a;
     readonly resolvedRootUris?: readonly string[];

package/dist/mcp/v2/tool-registry.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildV2ToolRegistry = buildV2ToolRegistry;
 const handler_factory_js_1 = require("../handler-factory.js");
 const tools_js_1 = require("./tools.js");
+const v2_manage_workflow_source_js_1 = require("../handlers/v2-manage-workflow-source.js");
 const v2_execution_js_1 = require("../handlers/v2-execution.js");
 const v2_workflow_js_1 = require("../handlers/v2-workflow.js");
 const v2_checkpoint_js_1 = require("../handlers/v2-checkpoint.js");
@@ -46,6 +47,12 @@ function buildV2ToolRegistry(buildTool) {
             inputSchema: tools_js_1.V2ResumeSessionInput,
             annotations: tools_js_1.V2_TOOL_ANNOTATIONS.resume_session,
         }),
+        buildTool({
+            name: 'manage_workflow_source',
+            title: tools_js_1.V2_TOOL_TITLES.manage_workflow_source,
+            inputSchema: tools_js_1.V2ManageWorkflowSourceInput,
+            annotations: tools_js_1.V2_TOOL_ANNOTATIONS.manage_workflow_source,
+        }),
     ];
     const handlers = {
         list_workflows: (0, handler_factory_js_1.createHandler)(tools_js_1.V2ListWorkflowsInput, v2_workflow_js_1.handleV2ListWorkflows),
@@ -54,6 +61,7 @@ function buildV2ToolRegistry(buildTool) {
         continue_workflow: (0, handler_factory_js_1.createHandler)(tools_js_1.V2ContinueWorkflowInput, v2_execution_js_1.handleV2ContinueWorkflow, tools_js_1.V2ContinueWorkflowInputShape, workflow_protocol_contracts_js_1.CONTINUE_WORKFLOW_PROTOCOL.aliasMap),
         checkpoint_workflow: (0, handler_factory_js_1.createHandler)(tools_js_1.V2CheckpointWorkflowInput, v2_checkpoint_js_1.handleV2CheckpointWorkflow),
         resume_session: (0, handler_factory_js_1.createHandler)(tools_js_1.V2ResumeSessionInput, v2_resume_js_1.handleV2ResumeSession),
+        manage_workflow_source: (0, handler_factory_js_1.createHandler)(tools_js_1.V2ManageWorkflowSourceInput, v2_manage_workflow_source_js_1.handleV2ManageWorkflowSource),
     };
     return { tools, handlers };
 }

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

@@ -2,10 +2,13 @@ import { z } from 'zod';
 import type { ToolAnnotations } from '../tool-factory.js';
 export declare const V2ListWorkflowsInput: z.ZodObject<{
     workspacePath: z.ZodEffects<z.ZodString, string, string>;
+    includeSources: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     workspacePath: string;
+    includeSources?: boolean | undefined;
 }, {
     workspacePath: string;
+    includeSources?: boolean | undefined;
 }>;
 export type V2ListWorkflowsInput = z.infer<typeof V2ListWorkflowsInput>;
 export declare const V2InspectWorkflowInput: z.ZodObject<{
@@ -171,6 +174,17 @@ export declare const V2ResumeSessionInput: z.ZodObject<{
     sameWorkspaceOnly?: boolean | undefined;
 }>;
 export type V2ResumeSessionInput = z.infer<typeof V2ResumeSessionInput>;
+export declare const V2ManageWorkflowSourceInput: z.ZodObject<{
+    action: z.ZodEnum<["attach", "detach"]>;
+    path: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    action: "attach" | "detach";
+}, {
+    path: string;
+    action: "attach" | "detach";
+}>;
+export type V2ManageWorkflowSourceInput = z.infer<typeof V2ManageWorkflowSourceInput>;
 export declare const V2CheckpointWorkflowInput: z.ZodObject<{
     checkpointToken: z.ZodString;
 }, "strict", z.ZodTypeAny, {
@@ -186,5 +200,6 @@ export declare const V2_TOOL_TITLES: {
     readonly continue_workflow: "Continue Workflow (v2)";
     readonly checkpoint_workflow: "Checkpoint Workflow (v2)";
     readonly resume_session: "Resume Session (v2)";
+    readonly manage_workflow_source: "Manage Workflow Source (v2)";
 };
 export declare const V2_TOOL_ANNOTATIONS: Readonly<Record<keyof typeof V2_TOOL_TITLES, ToolAnnotations>>;

package/dist/mcp/v2/tools.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V2_TOOL_ANNOTATIONS = exports.V2_TOOL_TITLES = exports.V2CheckpointWorkflowInput = exports.V2ResumeSessionInput = exports.V2ContinueWorkflowInput = exports.V2ContinueWorkflowInputShape = exports.V2StartWorkflowInput = exports.V2InspectWorkflowInput = exports.V2ListWorkflowsInput = void 0;
+exports.V2_TOOL_ANNOTATIONS = exports.V2_TOOL_TITLES = exports.V2CheckpointWorkflowInput = exports.V2ManageWorkflowSourceInput = exports.V2ResumeSessionInput = exports.V2ContinueWorkflowInput = exports.V2ContinueWorkflowInputShape = exports.V2StartWorkflowInput = exports.V2InspectWorkflowInput = exports.V2ListWorkflowsInput = void 0;
 const path_1 = __importDefault(require("path"));
 const zod_1 = require("zod");
 const workflow_protocol_contracts_js_1 = require("../workflow-protocol-contracts.js");
@@ -16,6 +16,7 @@ const workspacePathField = zod_1.z.string()
 const optionalWorkspacePathField = workspacePathField.optional();
 exports.V2ListWorkflowsInput = zod_1.z.object({
     workspacePath: workspacePathField.describe('Required. Absolute path to your current workspace directory (e.g. the "Workspace:" value from your system parameters). WorkRail uses this to resolve project-scoped workflow variants against the correct workspace for discovery-sensitive workflow listing. Shared MCP servers cannot infer this safely.'),
+    includeSources: zod_1.z.boolean().optional().describe('When true, includes a source catalog in the response showing where workflows come from (built-in, project-scoped, rooted-sharing, external), with effective and shadowed workflow counts per source. Omit or set false for the default workflow-list-only response.'),
 });
 exports.V2InspectWorkflowInput = zod_1.z.object({
     workflowId: zod_1.z.string().min(1).regex(/^([a-z0-9_-]+|[a-z][a-z0-9_-]+\.[a-z][a-z0-9_-]+)$/, 'Workflow ID must be a valid legacy ID (e.g. my-workflow) or namespaced ID (e.g. wr.discovery)').describe('The workflow ID to inspect'),
@@ -111,6 +112,10 @@ exports.V2ResumeSessionInput = zod_1.z.object({
     sameWorkspaceOnly: zod_1.z.boolean().optional().describe('If true, only sessions from the same repo/workspace are considered when repo_root_hash is available. ' +
         'Use this when the user clearly means "resume work from this repo only".'),
 }).strict();
+exports.V2ManageWorkflowSourceInput = zod_1.z.object({
+    action: zod_1.z.enum(['attach', 'detach']).describe('The operation to perform. "attach" registers the directory as a managed workflow source; "detach" removes it. Both operations are idempotent.'),
+    path: zod_1.z.string().min(1).refine((p) => path_1.default.isAbsolute(p), 'path must be an absolute path').describe('Absolute filesystem path to the workflow directory to attach or detach. Must be an absolute path. The path is normalized (resolved) before storage.'),
+}).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. ' +
         'Creates a checkpoint on the current step without advancing. Idempotent — calling with the same token is safe.'),
@@ -122,6 +127,7 @@ exports.V2_TOOL_TITLES = {
     continue_workflow: 'Continue Workflow (v2)',
     checkpoint_workflow: 'Checkpoint Workflow (v2)',
     resume_session: 'Resume Session (v2)',
+    manage_workflow_source: 'Manage Workflow Source (v2)',
 };
 exports.V2_TOOL_ANNOTATIONS = {
     list_workflows: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
@@ -130,4 +136,5 @@ exports.V2_TOOL_ANNOTATIONS = {
     continue_workflow: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
     checkpoint_workflow: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
     resume_session: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    manage_workflow_source: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
 };

package/dist/v2/durable-core/constants.d.ts

@@ -12,6 +12,7 @@ export declare const MAX_VALIDATION_SUGGESTIONS_BYTES = 4096;
 export declare const MAX_CONTEXT_BYTES: number;
 export declare const MAX_CONTEXT_DEPTH = 64;
 export declare const MAX_OBSERVATION_SHORT_STRING_LENGTH = 80;
+export declare const MAX_OBSERVATION_PATH_LENGTH = 512;
 export declare const SESSION_LOCK_RETRY_AFTER_MS = 1000;
 export declare const DEFAULT_RETRY_AFTER_MS = 1000;
 export declare const TRUNCATION_MARKER = "\n\n[TRUNCATED]";

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.PAYLOAD_KIND = exports.OUTPUT_CHANNEL = exports.EVENT_KIND = exports.DELIMITER_SAFE_ID_PATTERN = exports.SHA256_DIGEST_PATTERN = exports.MAX_RESUME_PREVIEW_BYTES = 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.MAX_RESUME_PREVIEW_BYTES = exports.RECOVERY_BUDGET_BYTES = exports.TRUNCATION_MARKER = exports.DEFAULT_RETRY_AFTER_MS = exports.SESSION_LOCK_RETRY_AFTER_MS = exports.MAX_OBSERVATION_PATH_LENGTH = 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;
@@ -15,6 +15,7 @@ exports.MAX_VALIDATION_SUGGESTIONS_BYTES = 4096;
 exports.MAX_CONTEXT_BYTES = 256 * 1024;
 exports.MAX_CONTEXT_DEPTH = 64;
 exports.MAX_OBSERVATION_SHORT_STRING_LENGTH = 80;
+exports.MAX_OBSERVATION_PATH_LENGTH = 512;
 exports.SESSION_LOCK_RETRY_AFTER_MS = 1000;
 exports.DEFAULT_RETRY_AFTER_MS = 1000;
 exports.TRUNCATION_MARKER = '\n\n[TRUNCATED]';

package/dist/v2/durable-core/domain/observation-builder.d.ts

@@ -1,6 +1,6 @@
 import type { WorkspaceAnchor } from '../../ports/workspace-anchor.port.js';
 export interface ObservationEventData {
-    readonly key: 'git_branch' | 'git_head_sha' | 'repo_root_hash';
+    readonly key: 'git_branch' | 'git_head_sha' | 'repo_root_hash' | 'repo_root';
     readonly value: {
         readonly type: 'short_string';
         readonly value: string;
@@ -10,6 +10,9 @@ export interface ObservationEventData {
     } | {
         readonly type: 'sha256';
         readonly value: string;
+    } | {
+        readonly type: 'path';
+        readonly value: string;
     };
     readonly confidence: 'low' | 'med' | 'high';
 }

package/dist/v2/durable-core/domain/observation-builder.js

@@ -33,6 +33,15 @@ function anchorsToObservations(anchors) {
                     confidence: 'high',
                 });
                 break;
+            case 'repo_root':
+                if (anchor.value.length > constants_js_1.MAX_OBSERVATION_PATH_LENGTH)
+                    break;
+                observations.push({
+                    key: 'repo_root',
+                    value: { type: 'path', value: anchor.value },
+                    confidence: 'high',
+                });
+                break;
             default: {
                 const _exhaustive = anchor;
                 return _exhaustive;

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

@@ -110,7 +110,7 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
         kind: z.ZodLiteral<"observation_recorded">;
         scope: z.ZodUndefined;
         data: z.ZodObject<{
-            key: z.ZodEnum<["git_branch", "git_head_sha", "repo_root_hash"]>;
+            key: z.ZodEnum<["git_branch", "git_head_sha", "repo_root_hash", "repo_root"]>;
             value: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                 type: z.ZodLiteral<"short_string">;
                 value: z.ZodString;
@@ -138,6 +138,15 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
             }, {
                 value: string;
                 type: "sha256";
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"path">;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                type: "path";
+            }, {
+                value: string;
+                type: "path";
             }>]>;
             confidence: z.ZodEnum<["low", "med", "high"]>;
         }, "strip", z.ZodTypeAny, {
@@ -150,8 +159,11 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
             } | {
                 value: string;
                 type: "sha256";
+            } | {
+                value: string;
+                type: "path";
             };
-            key: "git_branch" | "git_head_sha" | "repo_root_hash";
+            key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
             confidence: "high" | "low" | "med";
         }, {
             value: {
@@ -163,8 +175,11 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
             } | {
                 value: string;
                 type: "sha256";
+            } | {
+                value: string;
+                type: "path";
             };
-            key: "git_branch" | "git_head_sha" | "repo_root_hash";
+            key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
             confidence: "high" | "low" | "med";
         }>;
     }, "strip", z.ZodTypeAny, {
@@ -180,8 +195,11 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
             } | {
                 value: string;
                 type: "sha256";
+            } | {
+                value: string;
+                type: "path";
             };
-            key: "git_branch" | "git_head_sha" | "repo_root_hash";
+            key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
             confidence: "high" | "low" | "med";
         };
         v: 1;
@@ -202,8 +220,11 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
             } | {
                 value: string;
                 type: "sha256";
+            } | {
+                value: string;
+                type: "path";
             };
-            key: "git_branch" | "git_head_sha" | "repo_root_hash";
+            key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
             confidence: "high" | "low" | "med";
         };
         v: 1;
@@ -4727,8 +4748,11 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
             } | {
                 value: string;
                 type: "sha256";
+            } | {
+                value: string;
+                type: "path";
             };
-            key: "git_branch" | "git_head_sha" | "repo_root_hash";
+            key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
             confidence: "high" | "low" | "med";
         };
         v: 1;
@@ -5300,8 +5324,11 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
             } | {
                 value: string;
                 type: "sha256";
+            } | {
+                value: string;
+                type: "path";
             };
-            key: "git_branch" | "git_head_sha" | "repo_root_hash";
+            key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
             confidence: "high" | "low" | "med";
         };
         v: 1;
@@ -5791,7 +5818,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
             kind: z.ZodLiteral<"observation_recorded">;
             scope: z.ZodUndefined;
             data: z.ZodObject<{
-                key: z.ZodEnum<["git_branch", "git_head_sha", "repo_root_hash"]>;
+                key: z.ZodEnum<["git_branch", "git_head_sha", "repo_root_hash", "repo_root"]>;
                 value: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
                     type: z.ZodLiteral<"short_string">;
                     value: z.ZodString;
@@ -5819,6 +5846,15 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 }, {
                     value: string;
                     type: "sha256";
+                }>, z.ZodObject<{
+                    type: z.ZodLiteral<"path">;
+                    value: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    value: string;
+                    type: "path";
+                }, {
+                    value: string;
+                    type: "path";
                 }>]>;
                 confidence: z.ZodEnum<["low", "med", "high"]>;
             }, "strip", z.ZodTypeAny, {
@@ -5831,8 +5867,11 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 } | {
                     value: string;
                     type: "sha256";
+                } | {
+                    value: string;
+                    type: "path";
                 };
-                key: "git_branch" | "git_head_sha" | "repo_root_hash";
+                key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
                 confidence: "high" | "low" | "med";
             }, {
                 value: {
@@ -5844,8 +5883,11 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 } | {
                     value: string;
                     type: "sha256";
+                } | {
+                    value: string;
+                    type: "path";
                 };
-                key: "git_branch" | "git_head_sha" | "repo_root_hash";
+                key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
                 confidence: "high" | "low" | "med";
             }>;
         }, "strip", z.ZodTypeAny, {
@@ -5861,8 +5903,11 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 } | {
                     value: string;
                     type: "sha256";
+                } | {
+                    value: string;
+                    type: "path";
                 };
-                key: "git_branch" | "git_head_sha" | "repo_root_hash";
+                key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
                 confidence: "high" | "low" | "med";
             };
             v: 1;
@@ -5883,8 +5928,11 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 } | {
                     value: string;
                     type: "sha256";
+                } | {
+                    value: string;
+                    type: "path";
                 };
-                key: "git_branch" | "git_head_sha" | "repo_root_hash";
+                key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
                 confidence: "high" | "low" | "med";
             };
             v: 1;
@@ -10408,8 +10456,11 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 } | {
                     value: string;
                     type: "sha256";
+                } | {
+                    value: string;
+                    type: "path";
                 };
-                key: "git_branch" | "git_head_sha" | "repo_root_hash";
+                key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
                 confidence: "high" | "low" | "med";
             };
             v: 1;
@@ -10981,8 +11032,11 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 } | {
                     value: string;
                     type: "sha256";
+                } | {
+                    value: string;
+                    type: "path";
                 };
-                key: "git_branch" | "git_head_sha" | "repo_root_hash";
+                key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
                 confidence: "high" | "low" | "med";
             };
             v: 1;
@@ -11583,8 +11637,11 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 } | {
                     value: string;
                     type: "sha256";
+                } | {
+                    value: string;
+                    type: "path";
                 };
-                key: "git_branch" | "git_head_sha" | "repo_root_hash";
+                key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
                 confidence: "high" | "low" | "med";
             };
             v: 1;
@@ -12173,8 +12230,11 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                 } | {
                     value: string;
                     type: "sha256";
+                } | {
+                    value: string;
+                    type: "path";
                 };
-                key: "git_branch" | "git_head_sha" | "repo_root_hash";
+                key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
                 confidence: "high" | "low" | "med";
             };
             v: 1;

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

@@ -95,7 +95,7 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
     kind: z.ZodLiteral<"observation_recorded">;
     scope: z.ZodUndefined;
     data: z.ZodObject<{
-        key: z.ZodEnum<["git_branch", "git_head_sha", "repo_root_hash"]>;
+        key: z.ZodEnum<["git_branch", "git_head_sha", "repo_root_hash", "repo_root"]>;
         value: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             type: z.ZodLiteral<"short_string">;
             value: z.ZodString;
@@ -123,6 +123,15 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         }, {
             value: string;
             type: "sha256";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"path">;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            type: "path";
+        }, {
+            value: string;
+            type: "path";
         }>]>;
         confidence: z.ZodEnum<["low", "med", "high"]>;
     }, "strip", z.ZodTypeAny, {
@@ -135,8 +144,11 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         } | {
             value: string;
             type: "sha256";
+        } | {
+            value: string;
+            type: "path";
         };
-        key: "git_branch" | "git_head_sha" | "repo_root_hash";
+        key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
         confidence: "high" | "low" | "med";
     }, {
         value: {
@@ -148,8 +160,11 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         } | {
             value: string;
             type: "sha256";
+        } | {
+            value: string;
+            type: "path";
         };
-        key: "git_branch" | "git_head_sha" | "repo_root_hash";
+        key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
         confidence: "high" | "low" | "med";
     }>;
 }, "strip", z.ZodTypeAny, {
@@ -165,8 +180,11 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         } | {
             value: string;
             type: "sha256";
+        } | {
+            value: string;
+            type: "path";
         };
-        key: "git_branch" | "git_head_sha" | "repo_root_hash";
+        key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
         confidence: "high" | "low" | "med";
     };
     v: 1;
@@ -187,8 +205,11 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         } | {
             value: string;
             type: "sha256";
+        } | {
+            value: string;
+            type: "path";
         };
-        key: "git_branch" | "git_head_sha" | "repo_root_hash";
+        key: "git_branch" | "git_head_sha" | "repo_root_hash" | "repo_root";
         confidence: "high" | "low" | "med";
     };
     v: 1;

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

@@ -107,11 +107,12 @@ exports.DomainEventV1Schema = zod_1.z.discriminatedUnion('kind', [
         kind: zod_1.z.literal('observation_recorded'),
         scope: zod_1.z.undefined(),
         data: zod_1.z.object({
-            key: zod_1.z.enum(['git_branch', 'git_head_sha', 'repo_root_hash']),
+            key: zod_1.z.enum(['git_branch', 'git_head_sha', 'repo_root_hash', 'repo_root']),
             value: zod_1.z.discriminatedUnion('type', [
                 zod_1.z.object({ type: zod_1.z.literal('short_string'), value: zod_1.z.string().min(1).max(constants_js_1.MAX_OBSERVATION_SHORT_STRING_LENGTH) }),
                 zod_1.z.object({ type: zod_1.z.literal('git_sha1'), value: zod_1.z.string().regex(/^[0-9a-f]{40}$/) }),
                 zod_1.z.object({ type: zod_1.z.literal('sha256'), value: sha256DigestSchema }),
+                zod_1.z.object({ type: zod_1.z.literal('path'), value: zod_1.z.string().min(1).max(constants_js_1.MAX_OBSERVATION_PATH_LENGTH) }),
             ]),
             confidence: zod_1.z.enum(['low', 'med', 'high']),
         }),

package/dist/v2/infra/in-memory/managed-source-store/index.d.ts

@@ -0,0 +1,8 @@
+import type { ResultAsync } from 'neverthrow';
+import type { ManagedSourceRecordV2, ManagedSourceStoreError, ManagedSourceStorePortV2 } from '../../../ports/managed-source-store.port.js';
+export declare class InMemoryManagedSourceStoreV2 implements ManagedSourceStorePortV2 {
+    private readonly sources;
+    list(): ResultAsync<readonly ManagedSourceRecordV2[], ManagedSourceStoreError>;
+    attach(sourcePath: string): ResultAsync<void, ManagedSourceStoreError>;
+    detach(sourcePath: string): ResultAsync<void, ManagedSourceStoreError>;
+}

package/dist/v2/infra/in-memory/managed-source-store/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryManagedSourceStoreV2 = void 0;
+const path_1 = __importDefault(require("path"));
+const neverthrow_1 = require("neverthrow");
+class InMemoryManagedSourceStoreV2 {
+    constructor() {
+        this.sources = [];
+    }
+    list() {
+        return (0, neverthrow_1.okAsync)([...this.sources]);
+    }
+    attach(sourcePath) {
+        const normalizedPath = path_1.default.resolve(sourcePath);
+        const alreadyPresent = this.sources.some((s) => s.path === normalizedPath);
+        if (!alreadyPresent) {
+            this.sources.push({ path: normalizedPath, addedAtMs: Date.now() });
+        }
+        return (0, neverthrow_1.okAsync)(undefined);
+    }
+    detach(sourcePath) {
+        const normalizedPath = path_1.default.resolve(sourcePath);
+        const index = this.sources.findIndex((s) => s.path === normalizedPath);
+        if (index !== -1) {
+            this.sources.splice(index, 1);
+        }
+        return (0, neverthrow_1.okAsync)(undefined);
+    }
+}
+exports.InMemoryManagedSourceStoreV2 = InMemoryManagedSourceStoreV2;

package/dist/v2/infra/local/data-dir/index.d.ts

@@ -19,4 +19,6 @@ export declare class LocalDataDirV2 implements DataDirPortV2 {
     sessionManifestPath(sessionId: SessionId): string;
     sessionLockPath(sessionId: SessionId): string;
     tokenIndexPath(): string;
+    managedSourcesPath(): string;
+    managedSourcesLockPath(): string;
 }

package/dist/v2/infra/local/data-dir/index.js

@@ -89,5 +89,11 @@ class LocalDataDirV2 {
     tokenIndexPath() {
         return path.join(this.keysDir(), 'token-index.jsonl');
     }
+    managedSourcesPath() {
+        return path.join(this.root(), 'managed-sources', 'managed-sources.json');
+    }
+    managedSourcesLockPath() {
+        return path.join(this.root(), 'managed-sources', 'managed-sources.lock');
+    }
 }
 exports.LocalDataDirV2 = LocalDataDirV2;

package/dist/v2/infra/local/managed-source-store/index.d.ts

@@ -0,0 +1,15 @@
+import type { ResultAsync } from 'neverthrow';
+import type { DataDirPortV2 } from '../../../ports/data-dir.port.js';
+import type { FileSystemPortV2 } from '../../../ports/fs.port.js';
+import type { ManagedSourceRecordV2, ManagedSourceStoreError, ManagedSourceStorePortV2 } from '../../../ports/managed-source-store.port.js';
+export declare class LocalManagedSourceStoreV2 implements ManagedSourceStorePortV2 {
+    private readonly dataDir;
+    private readonly fs;
+    constructor(dataDir: DataDirPortV2, fs: FileSystemPortV2);
+    list(): ResultAsync<readonly ManagedSourceRecordV2[], ManagedSourceStoreError>;
+    attach(sourcePath: string): ResultAsync<void, ManagedSourceStoreError>;
+    detach(sourcePath: string): ResultAsync<void, ManagedSourceStoreError>;
+    private readSources;
+    private persist;
+    private withLock;
+}