@exaudeus/workrail 3.15.0 → 3.16.0

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

@@ -1,6 +1,10 @@
 import type { ToolContext, ToolResult } from '../types.js';
 import type { V2InspectWorkflowInput, V2ListWorkflowsInput } from '../v2/tools.js';
 import type { StalenessSummary } from '../output-schemas.js';
+import type { RememberedRootRecordV2 } from '../../v2/ports/remembered-roots-store.port.js';
+import type { CryptoPortV2 } from '../../v2/durable-core/canonical/hashing.js';
+import type { PinnedWorkflowStorePortV2 } from '../../v2/ports/pinned-workflow-store.port.js';
+import type { Workflow } from '../../types/workflow.js';
 export declare function shouldShowStaleness(category: string | undefined, devMode?: boolean): boolean;
 interface WorkflowTagsFile {
     readonly tags: ReadonlyArray<{
@@ -22,6 +26,82 @@ export declare function buildTagSummary(tagsFile: WorkflowTagsFile, compiledWork
     examples: string[];
 }>;
 export declare function computeWorkflowStaleness(stamp: number | undefined, currentVersion: number | null): StalenessSummary | undefined;
+interface WorkflowLookupReader {
+    readonly getWorkflowById: (id: string) => Promise<Workflow | null>;
+    readonly listWorkflowSummaries: () => Promise<readonly {
+        readonly id: string;
+        readonly name: string;
+        readonly description: string;
+        readonly version: string;
+    }[]>;
+    readonly loadAllWorkflows: () => Promise<readonly Workflow[]>;
+}
 export declare function handleV2ListWorkflows(input: V2ListWorkflowsInput, ctx: ToolContext): Promise<ToolResult<unknown>>;
 export declare function handleV2InspectWorkflow(input: V2InspectWorkflowInput, ctx: ToolContext): Promise<ToolResult<unknown>>;
+export declare function buildV2WorkflowListItem(options: {
+    readonly workflow: Workflow | null;
+    readonly summary: {
+        readonly id: string;
+        readonly name: string;
+        readonly description: string;
+        readonly version: string;
+    };
+    readonly workflowReader: WorkflowLookupReader;
+    readonly rememberedRootRecords: readonly RememberedRootRecordV2[];
+    readonly crypto: CryptoPortV2;
+    readonly pinnedStore: PinnedWorkflowStorePortV2;
+}): Promise<{
+    workflowId: string;
+    name: string;
+    description: string;
+    version: string;
+    workflowHash: null;
+    kind: "workflow";
+} | {
+    examples: string[];
+    workflowId: string;
+    name: string;
+    description: string;
+    version: string;
+    workflowHash: null;
+    kind: "workflow";
+    visibility: import("./shared/workflow-source-visibility.js").WorkflowVisibility;
+} | {
+    examples?: undefined;
+    workflowId: string;
+    name: string;
+    description: string;
+    version: string;
+    workflowHash: null;
+    kind: "workflow";
+    visibility: import("./shared/workflow-source-visibility.js").WorkflowVisibility;
+} | {
+    examples: string[];
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
+    workflowId: string;
+    name: string;
+    description: string;
+    version: string;
+    workflowHash: never;
+    kind: "workflow";
+    visibility: import("./shared/workflow-source-visibility.js").WorkflowVisibility;
+} | {
+    examples?: undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
+    workflowId: string;
+    name: string;
+    description: string;
+    version: string;
+    workflowHash: never;
+    kind: "workflow";
+    visibility: import("./shared/workflow-source-visibility.js").WorkflowVisibility;
+}>;
 export {};

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

@@ -8,13 +8,13 @@ exports.buildTagSummary = buildTagSummary;
 exports.computeWorkflowStaleness = computeWorkflowStaleness;
 exports.handleV2ListWorkflows = handleV2ListWorkflows;
 exports.handleV2InspectWorkflow = handleV2InspectWorkflow;
+exports.buildV2WorkflowListItem = buildV2WorkflowListItem;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const neverthrow_1 = require("neverthrow");
 const types_js_1 = require("../types.js");
 const error_mapper_js_1 = require("../error-mapper.js");
 const v2_execution_helpers_js_1 = require("./v2-execution-helpers.js");
-const output_schemas_js_1 = require("../output-schemas.js");
 const v1_to_v2_shim_js_1 = require("../../v2/read-only/v1-to-v2-shim.js");
 const hashing_js_1 = require("../../v2/durable-core/canonical/hashing.js");
 const TIMEOUT_MS = 30000;
@@ -135,14 +135,24 @@ async function handleV2ListWorkflows(input, ctx) {
     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,
-        workflowReader,
-        rememberedRootRecords,
-        crypto,
-        pinnedStore,
-    }), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err)))))
+    return neverthrow_1.ResultAsync.fromPromise((0, with_timeout_js_1.withTimeout)(workflowReader.loadAllWorkflows(), TIMEOUT_MS, 'list_workflows'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err))
+        .andThen((allWorkflows) => {
+        const workflowMap = new Map(allWorkflows.map((w) => [w.definition.id, w]));
+        const summaries = allWorkflows.map((w) => ({
+            id: w.definition.id,
+            name: w.definition.name,
+            description: w.definition.description,
+            version: w.definition.version,
+        }));
+        return neverthrow_1.ResultAsync.combine(summaries.map((s) => neverthrow_1.ResultAsync.fromPromise(buildV2WorkflowListItem({
+            workflow: workflowMap.get(s.id) ?? null,
+            summary: s,
+            workflowReader,
+            rememberedRootRecords,
+            crypto,
+            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));
@@ -173,35 +183,35 @@ async function handleV2ListWorkflows(input, ctx) {
             : undefined;
         if (!input.includeSources) {
             const includeStaleRoots = !tagSummaryEntry && stalePaths.length > 0;
-            const payload = output_schemas_js_1.V2WorkflowListOutputSchema.parse({
+            const payload = {
                 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({
+            const payload = {
                 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, 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({
+            const payload = {
                 workflows: tagFilteredCompiled,
                 ...(tagSummaryEntry ? { tagSummary: tagSummaryEntry } : {}),
                 ...(nextStepHint ? { _nextStep: nextStepHint } : {}),
                 ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
                 ...(warnings ? { warnings } : {}),
-                sources,
-            });
+                sources: [...sources],
+            };
             return (0, types_js_1.success)(payload);
         });
     })
@@ -264,7 +274,7 @@ async function handleV2InspectWorkflow(input, ctx) {
                 ? { schemaVersion: compiled.schemaVersion, sourceKind: compiled.sourceKind, workflowId: compiled.workflowId }
                 : compiled;
             const references = workflow.definition.references;
-            const payload = output_schemas_js_1.V2WorkflowInspectOutputSchema.parse({
+            const payload = {
                 workflowId: input.workflowId,
                 workflowHash,
                 mode: input.mode,
@@ -272,14 +282,14 @@ async function handleV2InspectWorkflow(input, ctx) {
                 ...(visibility ? { visibility } : {}),
                 ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
                 ...(inspectWarnings ? { warnings: inspectWarnings } : {}),
-                ...(references != null && references.length > 0 ? { references } : {}),
+                ...(references != null && references.length > 0 ? { references: [...references] } : {}),
                 ...(() => {
                     const staleness = shouldShowStaleness(visibility?.category)
                         ? computeWorkflowStaleness(workflow.definition.validatedAgainstSpecVersion, CURRENT_SPEC_VERSION)
                         : undefined;
                     return staleness !== undefined ? { staleness } : {};
                 })(),
-            });
+            };
             return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
         }));
     })
@@ -294,8 +304,7 @@ async function buildWorkflowVisibility(workflow, workflowReader, rememberedRootR
     return (0, workflow_source_visibility_js_1.toWorkflowVisibility)(workflow, rememberedRootRecords, { migration });
 }
 async function buildV2WorkflowListItem(options) {
-    const { summary, workflowReader, rememberedRootRecords, crypto, pinnedStore } = options;
-    const workflow = await workflowReader.getWorkflowById(summary.id);
+    const { workflow, summary, workflowReader, rememberedRootRecords, crypto, pinnedStore } = options;
     if (!workflow) {
         return {
             workflowId: summary.id,
@@ -307,6 +316,9 @@ async function buildV2WorkflowListItem(options) {
         };
     }
     const visibility = await buildWorkflowVisibility(workflow, workflowReader, rememberedRootRecords);
+    const examples = workflow.definition.examples?.length
+        ? { examples: [...workflow.definition.examples] }
+        : {};
     const snapshot = (0, v1_to_v2_shim_js_1.compileV1WorkflowToV2PreviewSnapshot)(workflow);
     const hashRes = (0, hashing_js_1.workflowHashForCompiledSnapshot)(snapshot, crypto);
     if (hashRes.isErr()) {
@@ -318,6 +330,7 @@ async function buildV2WorkflowListItem(options) {
             workflowHash: null,
             kind: 'workflow',
             visibility,
+            ...examples,
         };
     }
     const hash = hashRes.value;
@@ -333,6 +346,7 @@ async function buildV2WorkflowListItem(options) {
                 workflowHash: hash,
                 kind: 'workflow',
                 visibility,
+                ...examples,
             };
         }
     }
@@ -348,6 +362,7 @@ async function buildV2WorkflowListItem(options) {
         kind: 'workflow',
         visibility,
         ...(staleness !== undefined ? { staleness } : {}),
+        ...examples,
     };
 }
 async function buildSourceCatalog(workflowReader, rememberedRootRecords, managedSourceRecords, staleManagedRecords) {

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";
@@ -439,14 +427,14 @@ export declare const TagSummaryItemSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     when: string[];
-    displayName: string;
     examples: string[];
+    displayName: string;
     count: number;
 }, {
     id: string;
     when: string[];
-    displayName: string;
     examples: string[];
+    displayName: string;
     count: number;
 }>;
 export declare const V2WorkflowListOutputSchema: z.ZodObject<{
@@ -546,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;
@@ -553,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";
@@ -583,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";
@@ -616,14 +607,14 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         when: string[];
-        displayName: string;
         examples: string[];
+        displayName: string;
         count: number;
     }, {
         id: string;
         when: string[];
-        displayName: string;
         examples: string[];
+        displayName: string;
         count: number;
     }>, "many">>;
     _nextStep: z.ZodOptional<z.ZodString>;
@@ -744,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";
@@ -799,8 +791,8 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     tagSummary?: {
         id: string;
         when: string[];
-        displayName: string;
         examples: string[];
+        displayName: string;
         count: number;
     }[] | undefined;
     _nextStep?: string | undefined;
@@ -813,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";
@@ -868,8 +861,8 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     tagSummary?: {
         id: string;
         when: string[];
-        displayName: string;
         examples: string[];
+        displayName: string;
         count: number;
     }[] | undefined;
     _nextStep?: string | undefined;

package/dist/mcp/output-schemas.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,6 +74,9 @@ 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.'),

package/dist/mcp/server.js

@@ -47,6 +47,8 @@ const workspace_roots_manager_js_1 = require("./workspace-roots-manager.js");
 const index_js_2 = require("../v2/infra/local/directory-listing/index.js");
 const index_js_3 = require("../v2/infra/local/session-summary-provider/index.js");
 const tool_factory_js_1 = require("./tool-factory.js");
+const dev_mode_js_1 = require("./dev-mode.js");
+const tool_call_timing_js_1 = require("./tool-call-timing.js");
 const handler_factory_js_1 = require("./handler-factory.js");
 const workflow_tool_edition_selector_js_1 = require("./workflow-tool-edition-selector.js");
 const tools_js_1 = require("./tools.js");
@@ -159,8 +161,9 @@ function toMcpTool(tool) {
     };
 }
 async function composeServer() {
-    await (0, container_js_1.bootstrap)({ runtimeMode: { kind: 'production' } });
+    await (0, container_js_1.bootstrap)();
     const ctx = await createToolContext();
+    const timingRingBuffer = new tool_call_timing_js_1.ToolCallTimingRingBuffer(tool_call_timing_js_1.DEFAULT_RING_BUFFER_CAPACITY);
     if (ctx.v2 && ctx.httpServer && ctx.v2.dataDir && ctx.v2.directoryListing) {
         const { ConsoleService } = await Promise.resolve().then(() => __importStar(require('../v2/usecases/console-service.js')));
         const { mountConsoleRoutes } = await Promise.resolve().then(() => __importStar(require('../v2/usecases/console-routes.js')));
@@ -171,7 +174,7 @@ async function composeServer() {
             snapshotStore: ctx.v2.snapshotStore,
             pinnedWorkflowStore: ctx.v2.pinnedStore,
         });
-        ctx.httpServer.mountRoutes((app) => mountConsoleRoutes(app, consoleService));
+        ctx.httpServer.mountRoutes((app) => mountConsoleRoutes(app, consoleService, ctx.workflowService, timingRingBuffer));
         console.error('[Console] v2 Console API routes mounted at /api/v2/');
     }
     ctx.httpServer?.finalize();
@@ -214,19 +217,34 @@ async function composeServer() {
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools,
     }));
+    const timingSink = dev_mode_js_1.DEV_MODE
+        ? (0, tool_call_timing_js_1.composeSinks)((0, tool_call_timing_js_1.createRingBufferSink)(timingRingBuffer), (0, tool_call_timing_js_1.createDevPerfSink)())
+        : (0, tool_call_timing_js_1.createRingBufferSink)(timingRingBuffer);
+    if (dev_mode_js_1.DEV_MODE) {
+        console.error('[PerfTrace] WORKRAIL_DEV=1 -- tool call timing active');
+    }
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
+        const handlerStartMs = Date.now();
+        const handlerStartHr = performance.now();
         const handler = handlers[name];
         if (!handler) {
-            return {
+            const unknownResult = {
                 content: [{ type: 'text', text: `Unknown tool: ${name}` }],
                 isError: true,
             };
+            const durationMs = Math.round((performance.now() - handlerStartHr) * 100) / 100;
+            try {
+                timingSink({ toolName: name ?? '(unknown)', startedAtMs: handlerStartMs, durationMs, outcome: 'unknown_tool' });
+            }
+            catch {
+            }
+            return unknownResult;
         }
         const requestCtx = ctx.v2
             ? { ...ctx, v2: { ...ctx.v2, resolvedRootUris: rootsManager.getCurrentRootUris() } }
             : ctx;
-        return handler(args ?? {}, requestCtx);
+        return (0, tool_call_timing_js_1.withToolCallTiming)(name, () => handler(args ?? {}, requestCtx), timingSink);
     });
     server.setRequestHandler(ListResourcesRequestSchema, async () => ({
         resources: [

package/dist/mcp/tool-call-timing.d.ts

@@ -0,0 +1,24 @@
+export type ToolCallOutcome = 'success' | 'error' | 'unknown_tool';
+export interface ToolCallTiming {
+    readonly toolName: string;
+    readonly startedAtMs: number;
+    readonly durationMs: number;
+    readonly outcome: ToolCallOutcome;
+}
+export type ToolCallTimingSink = (timing: ToolCallTiming) => void;
+export declare const noopToolCallTimingSink: ToolCallTimingSink;
+export declare class ToolCallTimingRingBuffer {
+    private readonly capacity;
+    private readonly buffer;
+    private head;
+    private count;
+    constructor(capacity: number);
+    push(timing: ToolCallTiming): void;
+    recent(limit?: number): readonly ToolCallTiming[];
+    get size(): number;
+}
+export declare const DEFAULT_RING_BUFFER_CAPACITY = 100;
+export declare function createRingBufferSink(buffer: ToolCallTimingRingBuffer): ToolCallTimingSink;
+export declare function createDevPerfSink(): ToolCallTimingSink;
+export declare function composeSinks(...sinks: ToolCallTimingSink[]): ToolCallTimingSink;
+export declare function withToolCallTiming<T>(toolName: string, handler: () => Promise<T>, sink: ToolCallTimingSink): Promise<T>;