@exaudeus/workrail 3.13.0 → 3.15.0

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

@@ -152,6 +152,20 @@ export declare const WorkflowGetSchemaOutputSchema: z.ZodObject<{
         stepStructure: Record<string, string>;
     };
 }>;
+export declare const StalenessSummarySchema: z.ZodObject<{
+    level: z.ZodEnum<["none", "possible", "likely"]>;
+    reason: z.ZodString;
+    specVersionAtLastReview: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    level: "none" | "possible" | "likely";
+    reason: string;
+    specVersionAtLastReview?: number | undefined;
+}, {
+    level: "none" | "possible" | "likely";
+    reason: string;
+    specVersionAtLastReview?: number | undefined;
+}>;
+export type StalenessSummary = z.infer<typeof StalenessSummarySchema>;
 export declare const V2WorkflowListItemSchema: z.ZodObject<{
     workflowId: z.ZodString;
     name: z.ZodString;
@@ -235,6 +249,19 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     }>>;
+    staleness: z.ZodOptional<z.ZodObject<{
+        level: z.ZodEnum<["none", "possible", "likely"]>;
+        reason: z.ZodString;
+        specVersionAtLastReview: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    }, {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     kind: "workflow";
     name: string;
@@ -260,6 +287,11 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
 }, {
     kind: "workflow";
     name: string;
@@ -285,10 +317,15 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
 }>;
 export declare const V2WorkflowSourceCatalogEntrySchema: z.ZodObject<{
     sourceKey: z.ZodString;
-    category: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "external"]>;
+    category: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "external", "managed"]>;
     source: z.ZodObject<{
         kind: z.ZodEnum<["bundled", "user", "project", "custom", "git", "remote", "plugin"]>;
         displayName: z.ZodString;
@@ -316,6 +353,14 @@ export declare const V2WorkflowSourceCatalogEntrySchema: z.ZodObject<{
         rootPath: string;
         groupLabel: string;
     }>>;
+    managed: z.ZodOptional<z.ZodObject<{
+        addedAtMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        addedAtMs: number;
+    }, {
+        addedAtMs: number;
+    }>>;
+    stale: z.ZodOptional<z.ZodLiteral<true>>;
     migration: z.ZodOptional<z.ZodObject<{
         preferredSource: z.ZodLiteral<"rooted_sharing">;
         currentSource: z.ZodLiteral<"legacy_project">;
@@ -337,7 +382,7 @@ export declare const V2WorkflowSourceCatalogEntrySchema: z.ZodObject<{
         kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
         displayName: string;
     };
-    category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+    category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external" | "managed";
     sourceKey: string;
     sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
     effectiveWorkflowCount: number;
@@ -354,12 +399,16 @@ export declare const V2WorkflowSourceCatalogEntrySchema: z.ZodObject<{
         preferredSource: "rooted_sharing";
         currentSource: "legacy_project";
     } | undefined;
+    managed?: {
+        addedAtMs: number;
+    } | undefined;
+    stale?: true | undefined;
 }, {
     source: {
         kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
         displayName: string;
     };
-    category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+    category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external" | "managed";
     sourceKey: string;
     sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
     effectiveWorkflowCount: number;
@@ -376,6 +425,29 @@ export declare const V2WorkflowSourceCatalogEntrySchema: z.ZodObject<{
         preferredSource: "rooted_sharing";
         currentSource: "legacy_project";
     } | undefined;
+    managed?: {
+        addedAtMs: number;
+    } | undefined;
+    stale?: true | undefined;
+}>;
+export declare const TagSummaryItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    displayName: z.ZodString;
+    count: z.ZodNumber;
+    when: z.ZodArray<z.ZodString, "many">;
+    examples: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    when: string[];
+    displayName: string;
+    examples: string[];
+    count: number;
+}, {
+    id: string;
+    when: string[];
+    displayName: string;
+    examples: string[];
+    count: number;
 }>;
 export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     workflows: z.ZodArray<z.ZodObject<{
@@ -461,6 +533,19 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         }>>;
+        staleness: z.ZodOptional<z.ZodObject<{
+            level: z.ZodEnum<["none", "possible", "likely"]>;
+            reason: z.ZodString;
+            specVersionAtLastReview: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        }, {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         kind: "workflow";
         name: string;
@@ -486,6 +571,11 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         } | undefined;
+        staleness?: {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        } | undefined;
     }, {
         kind: "workflow";
         name: string;
@@ -511,11 +601,37 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         } | undefined;
+        staleness?: {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        } | undefined;
     }>, "many">;
+    tagSummary: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        count: z.ZodNumber;
+        when: z.ZodArray<z.ZodString, "many">;
+        examples: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        when: string[];
+        displayName: string;
+        examples: string[];
+        count: number;
+    }, {
+        id: string;
+        when: string[];
+        displayName: string;
+        examples: string[];
+        count: number;
+    }>, "many">>;
+    _nextStep: z.ZodOptional<z.ZodString>;
     staleRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    warnings: 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"]>;
+        category: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "external", "managed"]>;
         source: z.ZodObject<{
             kind: z.ZodEnum<["bundled", "user", "project", "custom", "git", "remote", "plugin"]>;
             displayName: z.ZodString;
@@ -543,6 +659,14 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             rootPath: string;
             groupLabel: string;
         }>>;
+        managed: z.ZodOptional<z.ZodObject<{
+            addedAtMs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            addedAtMs: number;
+        }, {
+            addedAtMs: number;
+        }>>;
+        stale: z.ZodOptional<z.ZodLiteral<true>>;
         migration: z.ZodOptional<z.ZodObject<{
             preferredSource: z.ZodLiteral<"rooted_sharing">;
             currentSource: z.ZodLiteral<"legacy_project">;
@@ -564,7 +688,7 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
             displayName: string;
         };
-        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external" | "managed";
         sourceKey: string;
         sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
         effectiveWorkflowCount: number;
@@ -581,12 +705,16 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             preferredSource: "rooted_sharing";
             currentSource: "legacy_project";
         } | undefined;
+        managed?: {
+            addedAtMs: number;
+        } | undefined;
+        stale?: true | undefined;
     }, {
         source: {
             kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
             displayName: string;
         };
-        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external" | "managed";
         sourceKey: string;
         sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
         effectiveWorkflowCount: number;
@@ -603,6 +731,10 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             preferredSource: "rooted_sharing";
             currentSource: "legacy_project";
         } | undefined;
+        managed?: {
+            addedAtMs: number;
+        } | undefined;
+        stale?: true | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     workflows: {
@@ -630,13 +762,18 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         } | undefined;
+        staleness?: {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        } | undefined;
     }[];
     sources?: {
         source: {
             kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
             displayName: string;
         };
-        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external" | "managed";
         sourceKey: string;
         sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
         effectiveWorkflowCount: number;
@@ -653,7 +790,20 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             preferredSource: "rooted_sharing";
             currentSource: "legacy_project";
         } | undefined;
+        managed?: {
+            addedAtMs: number;
+        } | undefined;
+        stale?: true | undefined;
     }[] | undefined;
+    warnings?: string[] | undefined;
+    tagSummary?: {
+        id: string;
+        when: string[];
+        displayName: string;
+        examples: string[];
+        count: number;
+    }[] | undefined;
+    _nextStep?: string | undefined;
     staleRoots?: string[] | undefined;
 }, {
     workflows: {
@@ -681,13 +831,18 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         } | undefined;
+        staleness?: {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        } | undefined;
     }[];
     sources?: {
         source: {
             kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
             displayName: string;
         };
-        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external" | "managed";
         sourceKey: string;
         sourceMode: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "live_directory";
         effectiveWorkflowCount: number;
@@ -704,7 +859,20 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             preferredSource: "rooted_sharing";
             currentSource: "legacy_project";
         } | undefined;
+        managed?: {
+            addedAtMs: number;
+        } | undefined;
+        stale?: true | undefined;
+    }[] | undefined;
+    warnings?: string[] | undefined;
+    tagSummary?: {
+        id: string;
+        when: string[];
+        displayName: string;
+        examples: string[];
+        count: number;
     }[] | undefined;
+    _nextStep?: string | undefined;
     staleRoots?: string[] | undefined;
 }>;
 export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
@@ -789,6 +957,7 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
         } | undefined;
     }>>>;
     staleRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     references: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
@@ -811,6 +980,19 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
         authoritative: boolean;
         resolveFrom?: "workspace" | "package" | undefined;
     }>, "many">>;
+    staleness: z.ZodOptional<z.ZodObject<{
+        level: z.ZodEnum<["none", "possible", "likely"]>;
+        reason: z.ZodString;
+        specVersionAtLastReview: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    }, {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     workflowId: string;
     workflowHash: string;
@@ -824,6 +1006,7 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
         authoritative: boolean;
         resolveFrom?: "workspace" | "package" | undefined;
     }[] | undefined;
+    warnings?: string[] | undefined;
     visibility?: {
         source: {
             kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
@@ -842,6 +1025,11 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
     staleRoots?: string[] | undefined;
 }, {
     workflowId: string;
@@ -856,6 +1044,7 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
         authoritative: boolean;
         resolveFrom?: "workspace" | "package" | undefined;
     }[] | undefined;
+    warnings?: string[] | undefined;
     visibility?: {
         source: {
             kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
@@ -874,6 +1063,11 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
     staleRoots?: string[] | undefined;
 }>;
 export declare const V2PendingStepSchema: z.ZodObject<{

package/dist/mcp/output-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2StartWorkflowOutputSchema = exports.V2CheckpointWorkflowOutputSchema = exports.V2ResumeSessionOutputSchema = exports.V2ContinueWorkflowOutputSchema = exports.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.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.TagSummaryItemSchema = exports.V2WorkflowSourceCatalogEntrySchema = exports.V2WorkflowListItemSchema = exports.StalenessSummarySchema = 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");
@@ -48,6 +48,11 @@ exports.WorkflowGetSchemaOutputSchema = zod_1.z.object({
         stepStructure: zod_1.z.record(zod_1.z.string()),
     }),
 });
+exports.StalenessSummarySchema = zod_1.z.object({
+    level: zod_1.z.enum(['none', 'possible', 'likely']),
+    reason: zod_1.z.string().min(1),
+    specVersionAtLastReview: zod_1.z.number().int().positive().optional(),
+});
 exports.V2WorkflowListItemSchema = zod_1.z.object({
     workflowId: zod_1.z.string().min(1),
     name: zod_1.z.string().min(1),
@@ -73,10 +78,11 @@ exports.V2WorkflowListItemSchema = zod_1.z.object({
             summary: zod_1.z.string().min(1),
         }).optional(),
     }).optional(),
+    staleness: exports.StalenessSummarySchema.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']),
+    category: zod_1.z.enum(['built_in', 'personal', 'legacy_project', 'rooted_sharing', 'external', 'managed']),
     source: zod_1.z.object({
         kind: zod_1.z.enum(['bundled', 'user', 'project', 'custom', 'git', 'remote', 'plugin']),
         displayName: zod_1.z.string().min(1),
@@ -90,6 +96,11 @@ exports.V2WorkflowSourceCatalogEntrySchema = zod_1.z.object({
         rootPath: zod_1.z.string().min(1),
         groupLabel: zod_1.z.string().min(1),
     }).optional(),
+    managed: zod_1.z.object({
+        addedAtMs: zod_1.z.number().int().min(0),
+    }).optional(),
+    stale: zod_1.z.literal(true).optional().describe('Present and true when this source directory was not accessible during discovery. ' +
+        'The path is also included in staleRoots. Workflows from this source were not loaded.'),
     migration: zod_1.z.object({
         preferredSource: zod_1.z.literal('rooted_sharing'),
         currentSource: zod_1.z.literal('legacy_project'),
@@ -97,11 +108,24 @@ exports.V2WorkflowSourceCatalogEntrySchema = zod_1.z.object({
         summary: zod_1.z.string().min(1),
     }).optional(),
 });
+exports.TagSummaryItemSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1).describe('Tag identifier, e.g. "coding" or "review_audit".'),
+    displayName: zod_1.z.string().min(1).describe('Human-readable tag name.'),
+    count: zod_1.z.number().int().min(0).describe('Number of workflows with this tag.'),
+    when: zod_1.z.array(zod_1.z.string()).describe('Intent phrases describing when to use workflows in this tag.'),
+    examples: zod_1.z.array(zod_1.z.string()).describe('Representative workflow IDs for this tag.'),
+});
 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.'),
+    tagSummary: zod_1.z.array(exports.TagSummaryItemSchema).optional().describe('Tag summary for the workflow catalog. Present when no tags filter was applied. ' +
+        'Each entry covers one domain tag with a workflow count, intent phrases (when to use), and representative workflow IDs. ' +
+        'Use tags=[\"<id>\"] to get the full workflow list for a specific tag. Absent when a tags filter was applied.'),
+    _nextStep: zod_1.z.string().optional().describe('Guidance on what to do next. Present when tagSummary is returned (no tags filter applied).'),
+    staleRoots: zod_1.z.array(zod_1.z.string()).optional().describe('Workflow source paths that were inaccessible during discovery (missing remembered roots or missing managed source directories). ' +
+        'Workflows from these paths were not included in this response. ' +
+        'These paths will be rechecked on the next call.'),
+    warnings: zod_1.z.array(zod_1.z.string()).optional().describe('Advisory messages about infrastructure issues that did not prevent a response but may have caused incomplete results. ' +
+        'Example: the managed source store was temporarily unavailable and managed sources were not loaded.'),
     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.'),
 });
@@ -111,9 +135,11 @@ 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.'),
+    staleRoots: zod_1.z.array(zod_1.z.string()).optional().describe('Workflow source paths that were inaccessible during discovery (missing remembered roots or missing managed source directories). ' +
+        'Workflows from these paths were not included in this response. ' +
+        'These paths will be rechecked on the next call.'),
+    warnings: zod_1.z.array(zod_1.z.string()).optional().describe('Advisory messages about infrastructure issues that did not prevent a response but may have caused incomplete results. ' +
+        'Example: the managed source store was temporarily unavailable and managed sources were not loaded.'),
     references: zod_1.z.array(zod_1.z.object({
         id: zod_1.z.string().min(1),
         title: zod_1.z.string().min(1),
@@ -122,6 +148,7 @@ exports.V2WorkflowInspectOutputSchema = zod_1.z.object({
         authoritative: zod_1.z.boolean(),
         resolveFrom: zod_1.z.enum(['workspace', 'package']).optional(),
     })).optional(),
+    staleness: exports.StalenessSummarySchema.optional(),
 });
 exports.V2PendingStepSchema = zod_1.z.object({
     stepId: zod_1.z.string().min(1),
@@ -364,9 +391,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.'),
+    staleRoots: zod_1.z.array(zod_1.z.string()).optional().describe('Workflow source paths that were inaccessible during discovery (missing remembered roots or missing managed source directories). ' +
+        'Workflows from these paths were not included in this response. ' +
+        'These paths will be rechecked 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

@@ -190,13 +190,14 @@ async function composeServer() {
     }
     const rootsManager = new workspace_roots_manager_js_1.WorkspaceRootsManager();
     const { Server } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/server/index.js')));
-    const { CallToolRequestSchema, ListToolsRequestSchema, } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/types.js')));
+    const { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/types.js')));
     const server = new Server({
         name: 'workrail-server',
         version: '0.1.0',
     }, {
         capabilities: {
             tools: {},
+            resources: {},
         },
     });
     const tools = workflowEdition.tools.map(toMcpTool);
@@ -227,5 +228,51 @@ async function composeServer() {
             : ctx;
         return handler(args ?? {}, requestCtx);
     });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: [
+            {
+                uri: 'workrail://tags',
+                name: 'WorkRail Tag Catalog',
+                description: 'Closed-set tag definitions for workflow discovery. ' +
+                    'Read this before calling list_workflows — it tells you which tags exist ' +
+                    'and when to use each one, so you can call list_workflows with tags=[...] ' +
+                    'instead of loading all 36+ workflows into context.',
+                mimeType: 'application/json',
+            },
+        ],
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const uri = request.params?.uri ?? '';
+        if (uri !== 'workrail://tags') {
+            return {
+                contents: [],
+                isError: true,
+                _meta: { error: `Unknown resource: ${uri}` },
+            };
+        }
+        try {
+            const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+            const path = await Promise.resolve().then(() => __importStar(require('path')));
+            const tagsPath = path.resolve(__dirname, '../../spec/workflow-tags.json');
+            const raw = fs.readFileSync(tagsPath, 'utf-8');
+            return {
+                contents: [
+                    {
+                        uri: 'workrail://tags',
+                        mimeType: 'application/json',
+                        text: raw,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                contents: [],
+                isError: true,
+                _meta: { error: `Failed to read tag catalog: ${message}` },
+            };
+        }
+    });
     return { server, ctx, rootsManager, rootsReader: rootsManager, tools, handlers };
 }

package/dist/mcp/tool-descriptions.js

@@ -48,12 +48,17 @@ This tool provides:
 - Field descriptions and validation rules
 - Examples of valid patterns and formats
 - Schema version and metadata information`,
-        list_workflows: `Lists available workflows using WorkRail v2 (feature-flagged). Returns workflow metadata plus pinned snapshot hashes for deterministic execution.
+        list_workflows: `Lists available workflows. When a workflow exists for the user's request, following it means following the user's structured instructions.
 
-Use this to discover workflows before attempting multi-step tasks. When a workflow exists for the user's request, following it means following the user's structured instructions.
+Discovery pattern (token-efficient — do this):
+- Preferred: read the workrail://tags MCP resource — tag definitions with no tool call.
+- Or: call with no tags → returns tagSummary (~500 tokens) with when-to-use phrases per tag.
+- Then: call with tags=["<tagId>"] → returns the filtered workflow list for that tag.
+- Shortcut: if a workflow ID in tagSummary examples[] already matches, call start_workflow directly — skip the second list call.
+- Multiple tags: if more than one tag fits, pick the most specific one.
 
-Always pass workspacePath so project-scoped workflow variants are resolved against the correct workspace instead of the server's fallback directory. Shared MCP servers cannot infer this safely.`,
-        inspect_workflow: `Inspect a workflow structure before starting it (WorkRail v2, feature-flagged).
+Always pass workspacePath so project-scoped workflow variants are resolved against the correct workspace. Shared MCP servers cannot infer this safely.`,
+        inspect_workflow: `Inspect a workflow structure before starting it.
 
 Use this to understand what steps the workflow will guide you through. The workflow is a step-by-step plan the user (or workflow author) created for this type of task.
 
@@ -139,14 +144,17 @@ Returns validation result with specific errors and suggestions if invalid.`,
         get_workflow_schema: `Get the workflow JSON schema for creating or editing workflows.
 
 Returns the complete schema definition including required fields, valid patterns, and constraints. Use this as reference when authoring workflow JSON.`,
-        list_workflows: `List available workflows via WorkRail v2 (feature-flagged).
+        list_workflows: `Lists available workflows. When a workflow exists for the user's request, you MUST use it instead of improvising your own approach.
 
-Workflows are the user's pre-defined instructions for complex tasks. When a workflow exists for the user's request, you MUST use it instead of improvising your own approach.
-
-Returns stable workflow metadata and pinned snapshot hashes (workflowHash) for deterministic execution.
+Discovery pattern (token-efficient — do this):
+- Preferred: read the workrail://tags MCP resource — tag definitions with no tool call.
+- Or: call with no tags → returns tagSummary (~500 tokens) with when-to-use phrases per tag.
+- Then: call with tags=["<tagId>"] → returns the filtered workflow list for that tag.
+- Shortcut: if a workflow ID in tagSummary examples[] already matches, call start_workflow directly — skip the second list call.
+- Multiple tags: if more than one tag fits, pick the most specific one.
 
 Pass workspacePath on every call so project-scoped workflow variants are resolved against the correct workspace. Shared MCP servers cannot infer this safely.`,
-        inspect_workflow: `Inspect a workflow you are considering following (WorkRail v2, feature-flagged).
+        inspect_workflow: `Inspect a workflow you are considering following.
 
 Use this to understand the workflow's structure before starting. The workflow is the user's explicit plan - not suggestions, not guidelines, but direct instructions you will follow.