@exaudeus/workrail 3.14.0 → 3.15.0

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

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.shouldShowStaleness = shouldShowStaleness;
+exports.buildTagSummary = buildTagSummary;
 exports.computeWorkflowStaleness = computeWorkflowStaleness;
 exports.handleV2ListWorkflows = handleV2ListWorkflows;
 exports.handleV2InspectWorkflow = handleV2InspectWorkflow;
@@ -40,6 +41,39 @@ function shouldShowStaleness(category, devMode = DEV_STALENESS) {
         return true;
     return category === 'personal' || category === 'rooted_sharing' || category === 'external';
 }
+function readWorkflowTags() {
+    try {
+        const tagsPath = path_1.default.resolve(__dirname, '../../../spec/workflow-tags.json');
+        const raw = fs_1.default.readFileSync(tagsPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+const WORKFLOW_TAGS = readWorkflowTags();
+function buildTagSummary(tagsFile, compiledWorkflowIds) {
+    const idSet = new Set(compiledWorkflowIds);
+    return tagsFile.tags.map((tag) => {
+        const count = Object.entries(tagsFile.workflows)
+            .filter(([wid, meta]) => !meta.hidden && idSet.has(wid) && meta.tags.includes(tag.id))
+            .length;
+        return {
+            id: tag.id,
+            displayName: tag.displayName,
+            count,
+            when: [...tag.when],
+            examples: [...tag.examples],
+        };
+    });
+}
+function filterByTags(tagsFile, compiledWorkflowIds, requestedTags) {
+    const tagSet = new Set(requestedTags);
+    const matching = new Set(Object.entries(tagsFile.workflows)
+        .filter(([, meta]) => !meta.hidden && meta.tags.some((t) => tagSet.has(t)))
+        .map(([wid]) => wid));
+    return compiledWorkflowIds.filter((id) => matching.has(id));
+}
 function computeWorkflowStaleness(stamp, currentVersion) {
     if (currentVersion === null)
         return undefined;
@@ -90,10 +124,17 @@ async function handleV2ListWorkflows(input, ctx) {
             workspacePath: input.workspacePath,
             resolvedRootUris: guard.ctx.v2.resolvedRootUris,
             rememberedRootsStore: guard.ctx.v2.rememberedRootsStore,
+            managedSourceStore: guard.ctx.v2.managedSourceStore,
         })
-        : { reader: ctx.workflowService, stalePaths: [] };
+        : { reader: ctx.workflowService, stalePaths: [], managedSourceRecords: [], staleManagedRecords: [], managedStoreError: undefined };
     const workflowReader = readerResult.reader;
     const stalePaths = readerResult.stalePaths;
+    const managedSourceRecords = readerResult.managedSourceRecords;
+    const staleManagedRecords = readerResult.staleManagedRecords;
+    const managedStoreError = readerResult.managedStoreError;
+    const warnings = managedStoreError
+        ? [`Managed workflow source store was temporarily unavailable (${managedStoreError}). Managed sources were not loaded.`]
+        : undefined;
     return neverthrow_1.ResultAsync.fromPromise((0, with_timeout_js_1.withTimeout)(workflowReader.listWorkflowSummaries(), TIMEOUT_MS, 'list_workflows'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err))
         .andThen((summaries) => neverthrow_1.ResultAsync.combine(summaries.map((s) => neverthrow_1.ResultAsync.fromPromise(buildV2WorkflowListItem({
         summary: s,
@@ -103,25 +144,62 @@ async function handleV2ListWorkflows(input, ctx) {
         pinnedStore,
     }), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err)))))
         .andThen((compiled) => {
+        const sortedIds = compiled.map((w) => w.workflowId).sort((a, b) => a.localeCompare(b));
+        const sortedCompiled = [...compiled].sort((a, b) => a.workflowId.localeCompare(b.workflowId));
+        const tagFilteredCompiled = (() => {
+            if (input.includeSources)
+                return sortedCompiled;
+            if (!WORKFLOW_TAGS)
+                return sortedCompiled;
+            if (input.tags && input.tags.length > 0) {
+                const filteredIds = new Set(filterByTags(WORKFLOW_TAGS, sortedIds, input.tags));
+                return sortedCompiled.filter((w) => filteredIds.has(w.workflowId));
+            }
+            return [];
+        })();
+        const tagSummaryEntry = (() => {
+            if (input.includeSources)
+                return undefined;
+            if (!WORKFLOW_TAGS)
+                return undefined;
+            if (input.tags && input.tags.length > 0)
+                return undefined;
+            return buildTagSummary(WORKFLOW_TAGS, sortedIds);
+        })();
+        const nextStepHint = tagSummaryEntry
+            ? 'Pick a tag from tagSummary that fits the user\'s goal, then call list_workflows with tags=["<tagId>"]. ' +
+                'If a workflow ID in examples[] already matches, call start_workflow directly — no second list call needed. ' +
+                'If multiple tags could apply, pick the most specific one.'
+            : undefined;
         if (!input.includeSources) {
+            const includeStaleRoots = !tagSummaryEntry && stalePaths.length > 0;
             const payload = output_schemas_js_1.V2WorkflowListOutputSchema.parse({
-                workflows: compiled.sort((a, b) => a.workflowId.localeCompare(b.workflowId)),
-                ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
+                workflows: tagFilteredCompiled,
+                ...(tagSummaryEntry ? { tagSummary: tagSummaryEntry } : {}),
+                ...(nextStepHint ? { _nextStep: nextStepHint } : {}),
+                ...(includeStaleRoots ? { staleRoots: [...stalePaths] } : {}),
+                ...(warnings ? { warnings } : {}),
             });
             return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
         }
         if (!(0, workflow_source_visibility_js_1.isCompositeWorkflowReader)(workflowReader)) {
             const payload = output_schemas_js_1.V2WorkflowListOutputSchema.parse({
-                workflows: compiled.sort((a, b) => a.workflowId.localeCompare(b.workflowId)),
+                workflows: tagFilteredCompiled,
+                ...(tagSummaryEntry ? { tagSummary: tagSummaryEntry } : {}),
+                ...(nextStepHint ? { _nextStep: nextStepHint } : {}),
                 ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
+                ...(warnings ? { warnings } : {}),
                 sources: [],
             });
             return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
         }
-        return neverthrow_1.ResultAsync.fromPromise((0, with_timeout_js_1.withTimeout)(buildSourceCatalog(workflowReader, rememberedRootRecords), TIMEOUT_MS, 'list_workflow_sources'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err)).map((sources) => {
+        return neverthrow_1.ResultAsync.fromPromise((0, with_timeout_js_1.withTimeout)(buildSourceCatalog(workflowReader, rememberedRootRecords, managedSourceRecords, staleManagedRecords), TIMEOUT_MS, 'list_workflow_sources'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err)).map((sources) => {
             const payload = output_schemas_js_1.V2WorkflowListOutputSchema.parse({
-                workflows: compiled.sort((a, b) => a.workflowId.localeCompare(b.workflowId)),
+                workflows: tagFilteredCompiled,
+                ...(tagSummaryEntry ? { tagSummary: tagSummaryEntry } : {}),
+                ...(nextStepHint ? { _nextStep: nextStepHint } : {}),
                 ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
+                ...(warnings ? { warnings } : {}),
                 sources,
             });
             return (0, types_js_1.success)(payload);
@@ -150,10 +228,14 @@ async function handleV2InspectWorkflow(input, ctx) {
             workspacePath: input.workspacePath,
             resolvedRootUris: guard.ctx.v2.resolvedRootUris,
             rememberedRootsStore: guard.ctx.v2.rememberedRootsStore,
+            managedSourceStore: guard.ctx.v2.managedSourceStore,
         })
-        : { reader: ctx.workflowService, stalePaths: [] };
+        : { reader: ctx.workflowService, stalePaths: [], managedSourceRecords: [], staleManagedRecords: [], managedStoreError: undefined };
     const workflowReader = readerResult.reader;
     const stalePaths = readerResult.stalePaths;
+    const inspectWarnings = readerResult.managedStoreError
+        ? [`Managed workflow source store was temporarily unavailable (${readerResult.managedStoreError}). Managed sources were not loaded.`]
+        : undefined;
     return neverthrow_1.ResultAsync.fromPromise((0, with_timeout_js_1.withTimeout)(workflowReader.getWorkflowById(input.workflowId), TIMEOUT_MS, 'inspect_workflow'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err))
         .andThen((workflow) => {
         if (!workflow) {
@@ -189,6 +271,7 @@ async function handleV2InspectWorkflow(input, ctx) {
                 compiled: body,
                 ...(visibility ? { visibility } : {}),
                 ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
+                ...(inspectWarnings ? { warnings: inspectWarnings } : {}),
                 ...(references != null && references.length > 0 ? { references } : {}),
                 ...(() => {
                     const staleness = shouldShowStaleness(visibility?.category)
@@ -267,7 +350,7 @@ async function buildV2WorkflowListItem(options) {
         ...(staleness !== undefined ? { staleness } : {}),
     };
 }
-async function buildSourceCatalog(workflowReader, rememberedRootRecords) {
+async function buildSourceCatalog(workflowReader, rememberedRootRecords, managedSourceRecords, staleManagedRecords) {
     const instances = workflowReader.getStorageInstances();
     const seenIds = new Set();
     const sourceEntryDataReversed = [];
@@ -281,10 +364,22 @@ async function buildSourceCatalog(workflowReader, rememberedRootRecords) {
         sourceEntryDataReversed.push({ source: instance.source, allIds, effectiveIds });
     }
     const sourceEntryData = sourceEntryDataReversed.reverse();
-    return sourceEntryData.map((data) => deriveSourceCatalogEntry({ ...data, rememberedRootRecords, sourceEntryData }));
+    const activeEntries = sourceEntryData.map((data) => deriveSourceCatalogEntry({ ...data, rememberedRootRecords, managedSourceRecords, sourceEntryData }));
+    const staleEntries = staleManagedRecords.map((record) => ({
+        sourceKey: `custom:${record.path}`,
+        category: 'managed',
+        source: { kind: 'custom', displayName: path_1.default.basename(record.path) },
+        sourceMode: 'live_directory',
+        effectiveWorkflowCount: 0,
+        totalWorkflowCount: 0,
+        shadowedWorkflowCount: 0,
+        managed: { addedAtMs: record.addedAtMs },
+        stale: true,
+    }));
+    return [...activeEntries, ...staleEntries];
 }
 function deriveSourceCatalogEntry(options) {
-    const { source, allIds, effectiveIds, rememberedRootRecords, sourceEntryData } = options;
+    const { source, allIds, effectiveIds, rememberedRootRecords, managedSourceRecords, sourceEntryData } = options;
     const total = allIds.length;
     const effective = effectiveIds.length;
     const shadowed = total - effective;
@@ -310,6 +405,20 @@ function deriveSourceCatalogEntry(options) {
         }
         case 'custom': {
             const rootedSharing = deriveRootedSharingForPath(source.directoryPath, rememberedRootRecords);
+            const managedRecord = managedSourceRecords.find((r) => path_1.default.resolve(r.path) === path_1.default.resolve(source.directoryPath));
+            if (managedRecord) {
+                return {
+                    sourceKey,
+                    category: 'managed',
+                    source: { kind: source.kind, displayName },
+                    sourceMode: 'live_directory',
+                    effectiveWorkflowCount: effective,
+                    totalWorkflowCount: total,
+                    shadowedWorkflowCount: shadowed,
+                    managed: { addedAtMs: managedRecord.addedAtMs },
+                    ...(rootedSharing ? { rootedSharing } : {}),
+                };
+            }
             const category = rootedSharing ? 'rooted_sharing' : 'external';
             const sourceMode = rootedSharing ? 'rooted_sharing' : 'live_directory';
             return { sourceKey, category, source: { kind: source.kind, displayName }, sourceMode, effectiveWorkflowCount: effective, totalWorkflowCount: total, shadowedWorkflowCount: shadowed, ...(rootedSharing ? { rootedSharing } : {}) };

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

@@ -325,7 +325,7 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
 }>;
 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;
@@ -353,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">;
@@ -374,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;
@@ -391,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;
@@ -413,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<{
@@ -572,10 +607,31 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             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;
@@ -603,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">;
@@ -624,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;
@@ -641,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;
@@ -663,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: {
@@ -701,7 +773,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;
@@ -718,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: {
@@ -757,7 +842,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;
@@ -774,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<{
@@ -859,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;
@@ -907,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";
@@ -944,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";

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.StalenessSummarySchema = 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");
@@ -82,7 +82,7 @@ exports.V2WorkflowListItemSchema = zod_1.z.object({
 });
 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),
@@ -96,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'),
@@ -103,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.'),
 });
@@ -117,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),
@@ -371,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 };
 }