@exaudeus/workrail 3.11.2 → 3.13.0

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

@@ -286,6 +286,97 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
         } | undefined;
     } | undefined;
 }>;
+export declare const V2WorkflowSourceCatalogEntrySchema: z.ZodObject<{
+    sourceKey: z.ZodString;
+    category: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "external"]>;
+    source: z.ZodObject<{
+        kind: z.ZodEnum<["bundled", "user", "project", "custom", "git", "remote", "plugin"]>;
+        displayName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+        displayName: string;
+    }, {
+        kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+        displayName: string;
+    }>;
+    sourceMode: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "live_directory"]>;
+    effectiveWorkflowCount: z.ZodNumber;
+    totalWorkflowCount: z.ZodNumber;
+    shadowedWorkflowCount: z.ZodNumber;
+    rootedSharing: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"remembered_root">;
+        rootPath: z.ZodString;
+        groupLabel: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "remembered_root";
+        rootPath: string;
+        groupLabel: string;
+    }, {
+        kind: "remembered_root";
+        rootPath: string;
+        groupLabel: string;
+    }>>;
+    migration: z.ZodOptional<z.ZodObject<{
+        preferredSource: z.ZodLiteral<"rooted_sharing">;
+        currentSource: z.ZodLiteral<"legacy_project">;
+        reason: z.ZodLiteral<"legacy_project_precedence">;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        reason: "legacy_project_precedence";
+        preferredSource: "rooted_sharing";
+        currentSource: "legacy_project";
+    }, {
+        summary: string;
+        reason: "legacy_project_precedence";
+        preferredSource: "rooted_sharing";
+        currentSource: "legacy_project";
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    source: {
+        kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+        displayName: string;
+    };
+    category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+    sourceKey: string;
+    sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
+    effectiveWorkflowCount: number;
+    totalWorkflowCount: number;
+    shadowedWorkflowCount: number;
+    rootedSharing?: {
+        kind: "remembered_root";
+        rootPath: string;
+        groupLabel: string;
+    } | undefined;
+    migration?: {
+        summary: string;
+        reason: "legacy_project_precedence";
+        preferredSource: "rooted_sharing";
+        currentSource: "legacy_project";
+    } | undefined;
+}, {
+    source: {
+        kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+        displayName: string;
+    };
+    category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+    sourceKey: string;
+    sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
+    effectiveWorkflowCount: number;
+    totalWorkflowCount: number;
+    shadowedWorkflowCount: number;
+    rootedSharing?: {
+        kind: "remembered_root";
+        rootPath: string;
+        groupLabel: string;
+    } | undefined;
+    migration?: {
+        summary: string;
+        reason: "legacy_project_precedence";
+        preferredSource: "rooted_sharing";
+        currentSource: "legacy_project";
+    } | undefined;
+}>;
 export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     workflows: z.ZodArray<z.ZodObject<{
         workflowId: z.ZodString;
@@ -421,6 +512,98 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             } | undefined;
         } | undefined;
     }>, "many">;
+    staleRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sourceKey: z.ZodString;
+        category: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "external"]>;
+        source: z.ZodObject<{
+            kind: z.ZodEnum<["bundled", "user", "project", "custom", "git", "remote", "plugin"]>;
+            displayName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        }, {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        }>;
+        sourceMode: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "live_directory"]>;
+        effectiveWorkflowCount: z.ZodNumber;
+        totalWorkflowCount: z.ZodNumber;
+        shadowedWorkflowCount: z.ZodNumber;
+        rootedSharing: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"remembered_root">;
+            rootPath: z.ZodString;
+            groupLabel: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        }, {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        }>>;
+        migration: z.ZodOptional<z.ZodObject<{
+            preferredSource: z.ZodLiteral<"rooted_sharing">;
+            currentSource: z.ZodLiteral<"legacy_project">;
+            reason: z.ZodLiteral<"legacy_project_precedence">;
+            summary: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            summary: string;
+            reason: "legacy_project_precedence";
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        }, {
+            summary: string;
+            reason: "legacy_project_precedence";
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        sourceKey: string;
+        sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
+        effectiveWorkflowCount: number;
+        totalWorkflowCount: number;
+        shadowedWorkflowCount: number;
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            summary: string;
+            reason: "legacy_project_precedence";
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    }, {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        sourceKey: string;
+        sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
+        effectiveWorkflowCount: number;
+        totalWorkflowCount: number;
+        shadowedWorkflowCount: number;
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            summary: string;
+            reason: "legacy_project_precedence";
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     workflows: {
         kind: "workflow";
@@ -448,6 +631,30 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             } | undefined;
         } | undefined;
     }[];
+    sources?: {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        sourceKey: string;
+        sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
+        effectiveWorkflowCount: number;
+        totalWorkflowCount: number;
+        shadowedWorkflowCount: number;
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            summary: string;
+            reason: "legacy_project_precedence";
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    }[] | undefined;
+    staleRoots?: string[] | undefined;
 }, {
     workflows: {
         kind: "workflow";
@@ -475,6 +682,30 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             } | undefined;
         } | undefined;
     }[];
+    sources?: {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        sourceKey: string;
+        sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
+        effectiveWorkflowCount: number;
+        totalWorkflowCount: number;
+        shadowedWorkflowCount: number;
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            summary: string;
+            reason: "legacy_project_precedence";
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    }[] | undefined;
+    staleRoots?: string[] | undefined;
 }>;
 export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
     workflowId: z.ZodString;
@@ -557,6 +788,7 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     }>>>;
+    staleRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     references: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
@@ -610,6 +842,7 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleRoots?: string[] | undefined;
 }, {
     workflowId: string;
     workflowHash: string;
@@ -641,6 +874,7 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleRoots?: string[] | undefined;
 }>;
 export declare const V2PendingStepSchema: z.ZodObject<{
     stepId: z.ZodString;
@@ -946,6 +1180,61 @@ export declare const V2BindingDriftWarningSchema: z.ZodObject<{
     pinnedValue: string;
     currentValue: string;
 }>;
+export declare const V2StepContextSchema: z.ZodObject<{
+    assessments: z.ZodOptional<z.ZodObject<{
+        assessmentId: z.ZodString;
+        dimensions: z.ZodArray<z.ZodObject<{
+            dimensionId: z.ZodString;
+            level: z.ZodString;
+            rationale: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            level: string;
+            dimensionId: string;
+            rationale?: string | undefined;
+        }, {
+            level: string;
+            dimensionId: string;
+            rationale?: string | undefined;
+        }>, "many">;
+        normalizationNotes: z.ZodReadonly<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        assessmentId: string;
+        dimensions: {
+            level: string;
+            dimensionId: string;
+            rationale?: string | undefined;
+        }[];
+        normalizationNotes: readonly string[];
+    }, {
+        assessmentId: string;
+        dimensions: {
+            level: string;
+            dimensionId: string;
+            rationale?: string | undefined;
+        }[];
+        normalizationNotes: readonly string[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    assessments?: {
+        assessmentId: string;
+        dimensions: {
+            level: string;
+            dimensionId: string;
+            rationale?: string | undefined;
+        }[];
+        normalizationNotes: readonly string[];
+    } | undefined;
+}, {
+    assessments?: {
+        assessmentId: string;
+        dimensions: {
+            level: string;
+            dimensionId: string;
+            rationale?: string | undefined;
+        }[];
+        normalizationNotes: readonly string[];
+    } | undefined;
+}>;
 export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"ok">;
     continueToken: z.ZodOptional<z.ZodString>;
@@ -1014,6 +1303,61 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
         pinnedValue: string;
         currentValue: string;
     }>, "many">>;
+    stepContext: z.ZodOptional<z.ZodObject<{
+        assessments: z.ZodOptional<z.ZodObject<{
+            assessmentId: z.ZodString;
+            dimensions: z.ZodArray<z.ZodObject<{
+                dimensionId: z.ZodString;
+                level: z.ZodString;
+                rationale: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }, {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }>, "many">;
+            normalizationNotes: z.ZodReadonly<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            assessmentId: string;
+            dimensions: {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }[];
+            normalizationNotes: readonly string[];
+        }, {
+            assessmentId: string;
+            dimensions: {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }[];
+            normalizationNotes: readonly string[];
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        assessments?: {
+            assessmentId: string;
+            dimensions: {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }[];
+            normalizationNotes: readonly string[];
+        } | undefined;
+    }, {
+        assessments?: {
+            assessmentId: string;
+            dimensions: {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }[];
+            normalizationNotes: readonly string[];
+        } | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     kind: "ok";
     pending: {
@@ -1042,6 +1386,17 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     }[] | undefined;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
+    stepContext?: {
+        assessments?: {
+            assessmentId: string;
+            dimensions: {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }[];
+            normalizationNotes: readonly string[];
+        } | undefined;
+    } | undefined;
 }, {
     kind: "ok";
     pending: {
@@ -1070,6 +1425,17 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     }[] | undefined;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
+    stepContext?: {
+        assessments?: {
+            assessmentId: string;
+            dimensions: {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }[];
+            normalizationNotes: readonly string[];
+        } | undefined;
+    } | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"blocked">;
     continueToken: z.ZodOptional<z.ZodString>;
@@ -1496,6 +1862,17 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     }[] | undefined;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
+    stepContext?: {
+        assessments?: {
+            assessmentId: string;
+            dimensions: {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }[];
+            normalizationNotes: readonly string[];
+        } | undefined;
+    } | undefined;
 } | {
     kind: "blocked";
     blockers: {
@@ -1582,6 +1959,17 @@ export declare const V2ContinueWorkflowOutputSchema: z.ZodEffects<z.ZodDiscrimin
     }[] | undefined;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
+    stepContext?: {
+        assessments?: {
+            assessmentId: string;
+            dimensions: {
+                level: string;
+                dimensionId: string;
+                rationale?: string | undefined;
+            }[];
+            normalizationNotes: readonly string[];
+        } | undefined;
+    } | undefined;
 } | {
     kind: "blocked";
     blockers: {
@@ -1867,6 +2255,7 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
         };
         tool: "continue_workflow";
     }>>;
+    staleRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     pending: {
         stepId: string;
@@ -1888,6 +2277,7 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
     } | null;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
+    staleRoots?: string[] | undefined;
 }, {
     pending: {
         stepId: string;
@@ -1909,6 +2299,7 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
     } | null;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
+    staleRoots?: string[] | undefined;
 }>, {
     pending: {
         stepId: string;
@@ -1930,6 +2321,7 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
     } | null;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
+    staleRoots?: string[] | undefined;
 }, {
     pending: {
         stepId: string;
@@ -1951,6 +2343,7 @@ export declare const V2StartWorkflowOutputSchema: z.ZodEffects<z.ZodObject<{
     } | null;
     continueToken?: string | undefined;
     checkpointToken?: string | undefined;
+    staleRoots?: string[] | undefined;
 }>;
 export declare const CreateSessionOutputSchema: z.ZodObject<{
     sessionId: z.ZodString;

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.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.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2StartWorkflowOutputSchema = exports.V2CheckpointWorkflowOutputSchema = exports.V2ResumeSessionOutputSchema = exports.V2ContinueWorkflowOutputSchema = exports.V2StepContextSchema = exports.V2BindingDriftWarningSchema = exports.V2BlockerReportSchema = exports.V2ResumeNextCallSchema = exports.V2NextCallSchema = exports.V2NextIntentSchema = exports.V2PreferencesSchema = exports.V2PendingStepSchema = exports.V2WorkflowInspectOutputSchema = exports.V2WorkflowListOutputSchema = exports.V2WorkflowSourceCatalogEntrySchema = 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");
@@ -74,8 +74,36 @@ exports.V2WorkflowListItemSchema = zod_1.z.object({
         }).optional(),
     }).optional(),
 });
+exports.V2WorkflowSourceCatalogEntrySchema = zod_1.z.object({
+    sourceKey: zod_1.z.string().min(1).describe('Stable identifier for this source. Format: "{kind}:{absolutePath}" for filesystem sources (e.g. "project:/path/to/workflows", "custom:/path/to/.workrail/workflows"), or "built_in" for bundled sources.'),
+    category: zod_1.z.enum(['built_in', 'personal', 'legacy_project', 'rooted_sharing', 'external']),
+    source: zod_1.z.object({
+        kind: zod_1.z.enum(['bundled', 'user', 'project', 'custom', 'git', 'remote', 'plugin']),
+        displayName: zod_1.z.string().min(1),
+    }),
+    sourceMode: zod_1.z.enum(['built_in', 'personal', 'legacy_project', 'rooted_sharing', 'live_directory']),
+    effectiveWorkflowCount: zod_1.z.number().int().min(0),
+    totalWorkflowCount: zod_1.z.number().int().min(0),
+    shadowedWorkflowCount: zod_1.z.number().int().min(0),
+    rootedSharing: zod_1.z.object({
+        kind: zod_1.z.literal('remembered_root'),
+        rootPath: zod_1.z.string().min(1),
+        groupLabel: zod_1.z.string().min(1),
+    }).optional(),
+    migration: zod_1.z.object({
+        preferredSource: zod_1.z.literal('rooted_sharing'),
+        currentSource: zod_1.z.literal('legacy_project'),
+        reason: zod_1.z.literal('legacy_project_precedence'),
+        summary: zod_1.z.string().min(1),
+    }).optional(),
+});
 exports.V2WorkflowListOutputSchema = zod_1.z.object({
     workflows: zod_1.z.array(exports.V2WorkflowListItemSchema),
+    staleRoots: zod_1.z.array(zod_1.z.string()).optional().describe('Remembered workspace roots that were inaccessible during workflow discovery. ' +
+        'Workflows from these roots were not included in this response. ' +
+        'These roots will be retried on the next call.'),
+    sources: zod_1.z.array(exports.V2WorkflowSourceCatalogEntrySchema).optional().describe('Source catalog for this workspace. Only present when includeSources was true in the request. ' +
+        'Shows where workflows come from with effective and shadowed counts per source.'),
 });
 exports.V2WorkflowInspectOutputSchema = zod_1.z.object({
     workflowId: zod_1.z.string().min(1),
@@ -83,6 +111,9 @@ exports.V2WorkflowInspectOutputSchema = zod_1.z.object({
     mode: zod_1.z.enum(['metadata', 'preview']),
     compiled: exports.JsonValueSchema,
     visibility: exports.V2WorkflowListItemSchema.shape.visibility.optional(),
+    staleRoots: zod_1.z.array(zod_1.z.string()).optional().describe('Remembered workspace roots that were inaccessible during workflow discovery. ' +
+        'Workflows from these roots were not included in this response. ' +
+        'These roots will be retried on the next call.'),
     references: zod_1.z.array(zod_1.z.object({
         id: zod_1.z.string().min(1),
         title: zod_1.z.string().min(1),
@@ -232,6 +263,19 @@ exports.V2BindingDriftWarningSchema = zod_1.z.object({
     pinnedValue: zod_1.z.string().min(1),
     currentValue: zod_1.z.string().min(1),
 });
+exports.V2StepContextSchema = zod_1.z.object({
+    assessments: zod_1.z
+        .object({
+        assessmentId: zod_1.z.string().min(1),
+        dimensions: zod_1.z.array(zod_1.z.object({
+            dimensionId: zod_1.z.string().min(1),
+            level: zod_1.z.string().min(1),
+            rationale: zod_1.z.string().optional(),
+        })),
+        normalizationNotes: zod_1.z.array(zod_1.z.string()).readonly(),
+    })
+        .optional(),
+});
 const V2ContinueWorkflowOkSchema = zod_1.z.object({
     kind: zod_1.z.literal('ok'),
     continueToken: continueTokenSchema,
@@ -242,6 +286,7 @@ const V2ContinueWorkflowOkSchema = zod_1.z.object({
     nextIntent: exports.V2NextIntentSchema,
     nextCall: exports.V2NextCallSchema,
     warnings: zod_1.z.array(exports.V2BindingDriftWarningSchema).optional(),
+    stepContext: exports.V2StepContextSchema.optional(),
 });
 const V2ContinueWorkflowBlockedSchema = zod_1.z.object({
     kind: zod_1.z.literal('blocked'),
@@ -319,6 +364,9 @@ exports.V2StartWorkflowOutputSchema = zod_1.z.object({
     preferences: exports.V2PreferencesSchema,
     nextIntent: exports.V2NextIntentSchema,
     nextCall: exports.V2NextCallSchema,
+    staleRoots: zod_1.z.array(zod_1.z.string()).optional().describe('Remembered workspace roots that were inaccessible during workflow discovery. ' +
+        'Workflows from these roots were not included in this response. ' +
+        'These roots will be retried on the next call.'),
 }).refine((data) => (data.pending ? data.continueToken != null : true), { message: 'continueToken is required when a pending step exists' });
 exports.CreateSessionOutputSchema = zod_1.z.object({
     sessionId: zod_1.z.string().min(1),

package/dist/mcp/server.js

@@ -110,6 +110,7 @@ async function createToolContext() {
                 console.error(`[V2Init] Token alias index load warning: ${aliasLoadResult.error.message}`);
             }
             const rememberedRootsStore = container_js_1.container.resolve(tokens_js_1.DI.V2.RememberedRootsStore);
+            const managedSourceStore = container_js_1.container.resolve(tokens_js_1.DI.V2.ManagedSourceStore);
             v2 = {
                 gate,
                 sessionStore,
@@ -122,6 +123,7 @@ async function createToolContext() {
                 tokenCodecPorts,
                 tokenAliasStore,
                 rememberedRootsStore,
+                managedSourceStore,
                 validationPipelineDeps,
                 resolvedRootUris: [],
                 workspaceResolver: new index_js_1.LocalWorkspaceAnchorV2(process.cwd()),

package/dist/mcp/tool-descriptions.js

@@ -73,6 +73,16 @@ Remember: inspecting is read-only. Call start_workflow when ready to begin.`,
         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'),
+        manage_workflow_source: `Attach or detach a workflow directory as a managed source.
+
+Use this to explicitly add a directory containing workflow files so its workflows appear in list_workflows as managed entries.
+
+Parameters:
+- action: "attach" to add a directory, "detach" to remove it. Both are idempotent.
+- path: absolute filesystem path to the workflow directory
+
+Attach is idempotent: attaching an already-attached path is a no-op.
+Detach is idempotent: detaching an absent path is a no-op.`,
     },
     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.
@@ -150,5 +160,15 @@ This is read-only. Call start_workflow when ready to commit to following the wor
         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'),
+        manage_workflow_source: `Attach or detach a workflow directory as a managed source.
+
+When the user wants to register an external workflow directory, use attach. When they want to remove it, use detach. Both are idempotent.
+
+Parameters:
+- action: "attach" to add a directory, "detach" to remove it. Both are idempotent.
+- path: absolute filesystem path to the workflow directory
+
+Attach is idempotent: attaching an already-attached path is a no-op.
+Detach is idempotent: detaching an absent path is a no-op.`,
     },
 };

package/dist/mcp/tools.js

@@ -92,6 +92,11 @@ exports.WORKFLOW_TOOL_ANNOTATIONS = {
         destructiveHint: false,
         idempotentHint: true,
     },
+    manage_workflow_source: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
 };
 exports.WORKFLOW_TOOL_TITLES = {
     discover_workflows: 'Discover Available Workflows',
@@ -105,6 +110,7 @@ exports.WORKFLOW_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.CreateSessionInput = zod_1.z.object({
     workflowId: zod_1.z