@exaudeus/workrail 3.14.0 → 3.16.0

package/dist/mcp/handlers/workflow.d.ts

@@ -19,11 +19,8 @@ export interface WorkflowNextOutput {
 }
 export interface WorkflowValidateJsonOutput {
     valid: boolean;
-    errors?: Array<{
-        message: string;
-        path?: string;
-    }>;
-    suggestions?: string[];
+    issues: string[];
+    suggestions: string[];
 }
 export interface WorkflowGetSchemaOutput {
     schema: unknown;

package/dist/mcp/handlers/workflow.js

@@ -32,21 +32,29 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleWorkflowList = handleWorkflowList;
 exports.handleWorkflowGet = handleWorkflowGet;
 exports.handleWorkflowNext = handleWorkflowNext;
 exports.handleWorkflowValidateJson = handleWorkflowValidateJson;
 exports.handleWorkflowGetSchema = handleWorkflowGetSchema;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 const types_js_1 = require("../types.js");
-const output_schemas_js_1 = require("../output-schemas.js");
 const error_mapper_js_1 = require("../error-mapper.js");
 const TIMEOUT_MS = 30000;
+const WORKFLOW_SCHEMA = (() => {
+    const schemaPath = path_1.default.resolve(__dirname, '../../../spec/workflow.schema.json');
+    return JSON.parse(fs_1.default.readFileSync(schemaPath, 'utf-8'));
+})();
 const with_timeout_js_1 = require("./shared/with-timeout.js");
 async function handleWorkflowList(_input, ctx) {
     try {
         const workflows = await (0, with_timeout_js_1.withTimeout)(ctx.workflowService.listWorkflowSummaries(), TIMEOUT_MS, 'workflow_list');
-        const payload = output_schemas_js_1.WorkflowListOutputSchema.parse({ workflows });
+        const payload = { workflows };
         return (0, types_js_1.success)(payload);
     }
     catch (err) {
@@ -63,7 +71,7 @@ async function handleWorkflowGet(input, ctx) {
             const mapped = (0, error_mapper_js_1.mapDomainErrorToToolError)(result.error);
             return mapped;
         }
-        const payload = output_schemas_js_1.WorkflowGetOutputSchema.parse({ workflow: result.value });
+        const payload = { workflow: result.value };
         return (0, types_js_1.success)(payload);
     }
     catch (err) {
@@ -93,7 +101,7 @@ async function handleWorkflowNext(input, ctx) {
             const mapped = (0, error_mapper_js_1.mapDomainErrorToToolError)(result.error);
             return mapped;
         }
-        const payload = output_schemas_js_1.WorkflowNextOutputSchema.parse(result.value);
+        const payload = result.value;
         return (0, types_js_1.success)(payload);
     }
     catch (err) {
@@ -118,7 +126,7 @@ async function handleWorkflowValidateJson(input, ctx) {
         const { createValidateWorkflowJson } = await Promise.resolve().then(() => __importStar(require('../../application/use-cases/validate-workflow-json.js')));
         const validateWorkflowJsonUseCase = createValidateWorkflowJson();
         const result = await validateWorkflowJsonUseCase(input.workflowJson);
-        const payload = output_schemas_js_1.WorkflowValidateJsonOutputSchema.parse(result);
+        const payload = result;
         return (0, types_js_1.success)(payload);
     }
     catch (err) {
@@ -129,11 +137,7 @@ async function handleWorkflowValidateJson(input, ctx) {
 async function handleWorkflowGetSchema(_input, ctx) {
     void ctx;
     try {
-        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
-        const path = await Promise.resolve().then(() => __importStar(require('path')));
-        const schemaPath = path.resolve(__dirname, '../../../spec/workflow.schema.json');
-        const schemaContent = fs.readFileSync(schemaPath, 'utf-8');
-        const schema = JSON.parse(schemaContent);
+        const schema = WORKFLOW_SCHEMA;
         const result = {
             schema,
             metadata: {
@@ -160,8 +164,7 @@ async function handleWorkflowGetSchema(_input, ctx) {
                 },
             },
         };
-        const payload = output_schemas_js_1.WorkflowGetSchemaOutputSchema.parse(result);
-        return (0, types_js_1.success)(payload);
+        return (0, types_js_1.success)(result);
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);

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

@@ -73,31 +73,16 @@ export declare const WorkflowNextOutputSchema: z.ZodObject<{
 }>;
 export declare const WorkflowValidateJsonOutputSchema: z.ZodObject<{
     valid: z.ZodBoolean;
-    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        message: z.ZodString;
-        path: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        message: string;
-        path?: string | undefined;
-    }, {
-        message: string;
-        path?: string | undefined;
-    }>, "many">>;
-    suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    issues: z.ZodArray<z.ZodString, "many">;
+    suggestions: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
+    issues: string[];
     valid: boolean;
-    suggestions?: string[] | undefined;
-    errors?: {
-        message: string;
-        path?: string | undefined;
-    }[] | undefined;
+    suggestions: string[];
 }, {
+    issues: string[];
     valid: boolean;
-    suggestions?: string[] | undefined;
-    errors?: {
-        message: string;
-        path?: string | undefined;
-    }[] | undefined;
+    suggestions: string[];
 }>;
 export declare const WorkflowGetSchemaOutputSchema: z.ZodObject<{
     schema: z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>;
@@ -262,6 +247,7 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
         reason: string;
         specVersionAtLastReview?: number | undefined;
     }>>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "workflow";
     name: string;
@@ -269,6 +255,7 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
     version: string;
     workflowId: string;
     workflowHash: string | null;
+    examples?: string[] | undefined;
     visibility?: {
         source: {
             kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
@@ -299,6 +286,7 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
     version: string;
     workflowId: string;
     workflowHash: string | null;
+    examples?: string[] | undefined;
     visibility?: {
         source: {
             kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
@@ -325,7 +313,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 +341,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 +370,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 +387,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 +413,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[];
+    examples: string[];
+    displayName: string;
+    count: number;
+}, {
+    id: string;
+    when: string[];
+    examples: string[];
+    displayName: string;
+    count: number;
 }>;
 export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     workflows: z.ZodArray<z.ZodObject<{
@@ -511,6 +534,7 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
             reason: string;
             specVersionAtLastReview?: number | undefined;
         }>>;
+        examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "workflow";
         name: string;
@@ -518,6 +542,7 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: string;
         workflowId: string;
         workflowHash: string | null;
+        examples?: string[] | undefined;
         visibility?: {
             source: {
                 kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
@@ -548,6 +573,7 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: string;
         workflowId: string;
         workflowHash: string | null;
+        examples?: string[] | undefined;
         visibility?: {
             source: {
                 kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
@@ -572,10 +598,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[];
+        examples: string[];
+        displayName: string;
+        count: number;
+    }, {
+        id: string;
+        when: string[];
+        examples: string[];
+        displayName: 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 +650,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 +679,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 +696,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 +722,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: {
@@ -672,6 +735,7 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: string;
         workflowId: string;
         workflowHash: string | null;
+        examples?: string[] | undefined;
         visibility?: {
             source: {
                 kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
@@ -701,7 +765,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 +782,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[];
+        examples: string[];
+        displayName: string;
+        count: number;
     }[] | undefined;
+    _nextStep?: string | undefined;
     staleRoots?: string[] | undefined;
 }, {
     workflows: {
@@ -728,6 +805,7 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: string;
         workflowId: string;
         workflowHash: string | null;
+        examples?: string[] | undefined;
         visibility?: {
             source: {
                 kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
@@ -757,7 +835,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 +852,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[];
+        examples: string[];
+        displayName: string;
+        count: number;
     }[] | undefined;
+    _nextStep?: string | undefined;
     staleRoots?: string[] | undefined;
 }>;
 export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
@@ -859,6 +950,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 +999,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 +1037,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");
@@ -27,13 +27,8 @@ exports.WorkflowNextOutputSchema = zod_1.z.object({
 });
 exports.WorkflowValidateJsonOutputSchema = zod_1.z.object({
     valid: zod_1.z.boolean(),
-    errors: zod_1.z
-        .array(zod_1.z.object({
-        message: zod_1.z.string(),
-        path: zod_1.z.string().optional(),
-    }))
-        .optional(),
-    suggestions: zod_1.z.array(zod_1.z.string()).optional(),
+    issues: zod_1.z.array(zod_1.z.string()),
+    suggestions: zod_1.z.array(zod_1.z.string()),
 });
 exports.WorkflowGetSchemaOutputSchema = zod_1.z.object({
     schema: exports.JsonValueSchema,
@@ -79,10 +74,13 @@ exports.V2WorkflowListItemSchema = zod_1.z.object({
         }).optional(),
     }).optional(),
     staleness: exports.StalenessSummarySchema.optional(),
+    examples: zod_1.z.array(zod_1.z.string().min(10).max(120)).min(1).max(6).optional().describe('Short illustrative goal strings showing what this workflow is used for. ' +
+        'Present when the workflow author has provided examples. ' +
+        'Use these to help users understand what goals to provide when starting this workflow.'),
 });
 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 +94,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 +106,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 +133,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 +389,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),