@exaudeus/workrail 3.65.0 → 3.67.0

package/dist/infrastructure/storage/schema-validating-workflow-storage.d.ts

@@ -1,6 +1,17 @@
 import { IWorkflowStorage, ICompositeWorkflowStorage } from '../../types/storage';
 import { Workflow, WorkflowSummary, WorkflowDefinition, WorkflowSource } from '../../types/workflow';
-export declare class SchemaValidatingWorkflowStorage implements IWorkflowStorage {
+export interface ValidationWarning {
+    readonly workflowId: string;
+    readonly sourceKind: string;
+    readonly errors: string[];
+}
+export interface HasValidationWarnings {
+    loadAllWorkflowsWithWarnings(): Promise<{
+        readonly workflows: readonly Workflow[];
+        readonly warnings: readonly ValidationWarning[];
+    }>;
+}
+export declare class SchemaValidatingWorkflowStorage implements IWorkflowStorage, HasValidationWarnings {
     private readonly inner;
     readonly kind: "single";
     private readonly validator;
@@ -8,11 +19,15 @@ export declare class SchemaValidatingWorkflowStorage implements IWorkflowStorage
     get source(): WorkflowSource;
     private validateDefinition;
     loadAllWorkflows(): Promise<readonly Workflow[]>;
+    loadAllWorkflowsWithWarnings(): Promise<{
+        readonly workflows: readonly Workflow[];
+        readonly warnings: readonly ValidationWarning[];
+    }>;
     getWorkflowById(id: string): Promise<Workflow | null>;
     listWorkflowSummaries(): Promise<readonly WorkflowSummary[]>;
     save(definition: WorkflowDefinition): Promise<void>;
 }
-export declare class SchemaValidatingCompositeWorkflowStorage implements ICompositeWorkflowStorage {
+export declare class SchemaValidatingCompositeWorkflowStorage implements ICompositeWorkflowStorage, HasValidationWarnings {
     private readonly inner;
     readonly kind: "composite";
     private readonly validator;
@@ -21,6 +36,10 @@ export declare class SchemaValidatingCompositeWorkflowStorage implements ICompos
     getSources(): readonly WorkflowSource[];
     getStorageInstances(): readonly IWorkflowStorage[];
     loadAllWorkflows(): Promise<readonly Workflow[]>;
+    loadAllWorkflowsWithWarnings(): Promise<{
+        readonly workflows: readonly Workflow[];
+        readonly warnings: readonly ValidationWarning[];
+    }>;
     getWorkflowById(id: string): Promise<Workflow | null>;
     listWorkflowSummaries(): Promise<readonly WorkflowSummary[]>;
     save(definition: WorkflowDefinition): Promise<void>;

package/dist/infrastructure/storage/schema-validating-workflow-storage.js

@@ -54,6 +54,30 @@ class SchemaValidatingWorkflowStorage {
         }
         return validWorkflows;
     }
+    async loadAllWorkflowsWithWarnings() {
+        const workflows = await this.inner.loadAllWorkflows();
+        const validWorkflows = [];
+        const warnings = [];
+        for (const workflow of workflows) {
+            try {
+                if (this.validateDefinition(workflow.definition, workflow.source.kind)) {
+                    validWorkflows.push(workflow);
+                }
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                reportValidationFailure(workflow.definition.id, workflow.source.kind, errorMessage);
+                if (workflow.source.kind !== 'bundled') {
+                    warnings.push({
+                        workflowId: workflow.definition.id,
+                        sourceKind: workflow.source.kind,
+                        errors: [errorMessage],
+                    });
+                }
+            }
+        }
+        return { workflows: validWorkflows, warnings };
+    }
     async getWorkflowById(id) {
         const workflow = await this.inner.getWorkflowById(id);
         if (!workflow) {
@@ -117,6 +141,30 @@ class SchemaValidatingCompositeWorkflowStorage {
         }
         return validWorkflows;
     }
+    async loadAllWorkflowsWithWarnings() {
+        const workflows = await this.inner.loadAllWorkflows();
+        const validWorkflows = [];
+        const warnings = [];
+        for (const workflow of workflows) {
+            try {
+                if (this.validateDefinition(workflow.definition, workflow.source.kind)) {
+                    validWorkflows.push(workflow);
+                }
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                reportValidationFailure(workflow.definition.id, workflow.source.kind, errorMessage);
+                if (workflow.source.kind !== 'bundled') {
+                    warnings.push({
+                        workflowId: workflow.definition.id,
+                        sourceKind: workflow.source.kind,
+                        errors: [errorMessage],
+                    });
+                }
+            }
+        }
+        return { workflows: validWorkflows, warnings };
+    }
     async getWorkflowById(id) {
         const workflow = await this.inner.getWorkflowById(id);
         if (!workflow)

package/dist/manifest.json

@@ -230,8 +230,8 @@
       "bytes": 460
     },
     "application/validation.js": {
-      "sha256": "ca4e2618fe7433eb1f6e66afc91ecacead737a8798f2f11377e68bbd916a12a7",
-      "bytes": 1527
+      "sha256": "12e4d064d5500259b62df0ab594a5fd9e5e0c59e7d7766b19ef80a7ada46a795",
+      "bytes": 1512
     },
     "cli-worktrain.d.ts": {
       "sha256": "43e818adf60173644896298637f47b01d5819b17eda46eaa32d0c7d64724d012",
@@ -477,12 +477,12 @@
       "sha256": "40290b50e21ee7e82433efe13b1aa31c1ea608bd057a5c4e324982f284bc928b",
       "bytes": 60673
     },
-    "console-ui/assets/index-DmFHE8v_.js": {
-      "sha256": "c7ef94aea9b5ea532428c8883d25a73fa623bf90bc2d24e81ca401d442c029dd",
+    "console-ui/assets/index-tOl8Vowf.js": {
+      "sha256": "f598d8869c96cf01f1adc245ac289f9614d7616ce1d8f0a86a0bb9665a26fe5d",
       "bytes": 767983
     },
     "console-ui/index.html": {
-      "sha256": "310cdfdf0c020a8b14aa86ec5d0126b2c412bbacfb042b678124b8a450155b26",
+      "sha256": "908a96c5cb785772a69156cc4c8abaa821f37104d8b7ed0ce0f8db077d7d62e3",
       "bytes": 417
     },
     "console/standalone-console.d.ts": {
@@ -490,8 +490,8 @@
       "bytes": 788
     },
     "console/standalone-console.js": {
-      "sha256": "bfe72ea5161d6d3af917180fad905abae05b9ae5cb329dadbe3d8acaed6aed9a",
-      "bytes": 6314
+      "sha256": "4847b32ce53ad1934e6f18dde435bcf7f0fc4374125eb58360d9cdeada616fe7",
+      "bytes": 6689
     },
     "context-assembly/deps.d.ts": {
       "sha256": "d699ae8f8f081d92708eba5969e35cf24a45d3f86de72d308ffc4a542b954bc3",
@@ -902,12 +902,12 @@
       "bytes": 7902
     },
     "infrastructure/storage/schema-validating-workflow-storage.d.ts": {
-      "sha256": "049b68de8c5df6394f8018a9c9c666770cb4d2f20d061cbe5da482aff1c3239c",
-      "bytes": 1318
+      "sha256": "f22a2e7e65407478d86aa5d5a7546ca35947dc448425309e5be5ba4f8efa5ce6",
+      "bytes": 2023
     },
     "infrastructure/storage/schema-validating-workflow-storage.js": {
-      "sha256": "be5300cb1133537ae88aabd7c338c9265fc0c1a074901311999dc08c69ba3975",
-      "bytes": 5787
+      "sha256": "4004fac4f8cb1b5cadbe060a389fe6a97377eedc6d4209b92da0d82d36a5e1b0",
+      "bytes": 7801
     },
     "infrastructure/storage/storage.d.ts": {
       "sha256": "481c5c0ef797baa7f18cff6a468a1de6d1ef34dd4b35f53e318e30b825b31e63",
@@ -1234,8 +1234,8 @@
       "bytes": 4343
     },
     "mcp/handlers/v2-workflow.js": {
-      "sha256": "73137ab66383cd5804856f086bb665414f8c302cb90dd934b24aaf12c6a96ae9",
-      "bytes": 26893
+      "sha256": "ed2594e771344c5c3fed99e92b196f72dcfdf1d34ef8dc911bf6e9a12669ef0d",
+      "bytes": 28075
     },
     "mcp/handlers/v2-workspace-resolution.d.ts": {
       "sha256": "dd4de57b4918ebe749cf8c1df70c02bf1effc50932634bae60db53c9a157e872",
@@ -1262,12 +1262,12 @@
       "bytes": 7991
     },
     "mcp/output-schemas.d.ts": {
-      "sha256": "ecd9ff8b4a2e2514385d5f5031a4c99bb67884f6a96ea9dd42b62c31bf2687d1",
-      "bytes": 93176
+      "sha256": "03207cb284fb77d0859cb089b0717ac38d9a1f2a997f101324d8efb90c540b5c",
+      "bytes": 94179
     },
     "mcp/output-schemas.js": {
-      "sha256": "b9901935144a7842dd237a869b51fdd72153ce2970225da1e83cc22193bd1293",
-      "bytes": 22211
+      "sha256": "73547ff9f84f0f91c0d541a846d917eb1595d7feaec0684afe2271658b774402",
+      "bytes": 23062
     },
     "mcp/render-envelope.d.ts": {
       "sha256": "22e83e1aba52968a7136cf289125a217b5f462a5a66a1eebe4669006e3326fdb",
@@ -1782,8 +1782,8 @@
       "bytes": 395
     },
     "types/workflow-definition.d.ts": {
-      "sha256": "7ff8bf4aff8685ebe9bc45fe9c6400c5d68dfdf522e2af0e15c53f279291002e",
-      "bytes": 6015
+      "sha256": "1d79940ddcbea1a97a20383685c76a2a749dc371d997434a5af740a756e6252c",
+      "bytes": 6110
     },
     "types/workflow-definition.js": {
       "sha256": "33e3c33243f18cb3440a38d79b3c25daa87fe6ad14f2d28c43b9a4e12a72fcd6",
@@ -2062,12 +2062,12 @@
       "bytes": 942
     },
     "v2/durable-core/domain/prompt-renderer.d.ts": {
-      "sha256": "e362b644bf9fbac3b704cdf4195bf44cce12b4028c88265445147ddebb0c7239",
-      "bytes": 1482
+      "sha256": "bb5f2781d439c533184749c4d02259965546accaedad18c33571961c56e6d167",
+      "bytes": 1664
     },
     "v2/durable-core/domain/prompt-renderer.js": {
-      "sha256": "513d49cb4e2cbe28e1c3567251626f1a10fb9df7a8be28317dc1357ec9929c68",
-      "bytes": 19757
+      "sha256": "fe7d177a79cf8cbf2ee814a0e20e24b4cb3ea1b332c4f6aaf57d0f601a95419b",
+      "bytes": 22976
     },
     "v2/durable-core/domain/reason-model.d.ts": {
       "sha256": "a944e7e0d9b3c73468488263cb0aa1e446c023f8084fd2af53cbda3f3bfcd37a",
@@ -3062,12 +3062,12 @@
       "bytes": 550
     },
     "v2/projections/session-metrics.d.ts": {
-      "sha256": "f9ec2280053a9424f691246212522359263e526701cb4b3605e44870600c862c",
-      "bytes": 741
+      "sha256": "e145784946e29a7a6473c130cc7e11032f62ecd98274796b181136821e4c2aa0",
+      "bytes": 730
     },
     "v2/projections/session-metrics.js": {
-      "sha256": "932dde53bb03804546741a50516b9be78d7723b0fa7beb81ad4225f1f346f2b1",
-      "bytes": 3890
+      "sha256": "89a1ee5aae79a19c7fc60840e62741a7dd93028562e72cd26a15e4988953c6c4",
+      "bytes": 3421
     },
     "v2/read-only/v1-to-v2-shim.d.ts": {
       "sha256": "b122df1d4eb4119b65465baa00f157ca4466575d3bc6ac20054a361eaff48e02",
@@ -3078,8 +3078,8 @@
       "bytes": 4795
     },
     "v2/usecases/console-routes.d.ts": {
-      "sha256": "bb8abe9b6510ab09ab9aec1af24c253bf16b538c18c5ac583caffe48ef347536",
-      "bytes": 596
+      "sha256": "9acde26458a0cb2dabcafa9daa2ea1ba72e261422b77491e9d086ecc54c19234",
+      "bytes": 572
     },
     "v2/usecases/console-routes.js": {
       "sha256": "cac41733df0270c8882c1ccc57e616862e422b7dd4aaf78783bb98a21c6edd81",

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

@@ -192,7 +192,14 @@ 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.loadAllWorkflows(), TIMEOUT_MS, 'list_workflows'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err))
+    const hasValidationWarnings = (r) => typeof r.loadAllWorkflowsWithWarnings === 'function';
+    let capturedValidationWarnings;
+    return neverthrow_1.ResultAsync.fromPromise(hasValidationWarnings(workflowReader)
+        ? (0, with_timeout_js_1.withTimeout)(workflowReader.loadAllWorkflowsWithWarnings(), TIMEOUT_MS, 'list_workflows').then(({ workflows, warnings }) => {
+            capturedValidationWarnings = warnings.length > 0 ? warnings : undefined;
+            return workflows;
+        })
+        : (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) => ({
@@ -233,11 +240,18 @@ async function handleV2ListWorkflows(input, ctx) {
                 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;
+        const nextStepHint = (() => {
+            if (tagSummaryEntry) {
+                return '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.';
+            }
+            if (capturedValidationWarnings) {
+                return 'One or more workflow files failed validation and were excluded from the workflows list. ' +
+                    'Fix the errors listed in validationWarnings in the workflow file(s) and retry list_workflows to confirm.';
+            }
+            return undefined;
+        })();
         if (!input.includeSources) {
             const includeStaleRoots = !tagSummaryEntry && stalePaths.length > 0;
             const payload = {
@@ -246,6 +260,7 @@ async function handleV2ListWorkflows(input, ctx) {
                 ...(nextStepHint ? { _nextStep: nextStepHint } : {}),
                 ...(includeStaleRoots ? { staleRoots: [...stalePaths] } : {}),
                 ...(warnings ? { warnings } : {}),
+                ...(capturedValidationWarnings ? { validationWarnings: [...capturedValidationWarnings] } : {}),
             };
             return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
         }
@@ -256,6 +271,7 @@ async function handleV2ListWorkflows(input, ctx) {
                 ...(nextStepHint ? { _nextStep: nextStepHint } : {}),
                 ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
                 ...(warnings ? { warnings } : {}),
+                ...(capturedValidationWarnings ? { validationWarnings: [...capturedValidationWarnings] } : {}),
                 sources: [],
             };
             return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
@@ -267,6 +283,7 @@ async function handleV2ListWorkflows(input, ctx) {
                 ...(nextStepHint ? { _nextStep: nextStepHint } : {}),
                 ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
                 ...(warnings ? { warnings } : {}),
+                ...(capturedValidationWarnings ? { validationWarnings: [...capturedValidationWarnings] } : {}),
                 sources: [...sources],
             };
             return (0, types_js_1.success)(payload);

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

@@ -437,6 +437,19 @@ export declare const TagSummaryItemSchema: z.ZodObject<{
     displayName: string;
     count: number;
 }>;
+export declare const V2ValidationWarningSchema: z.ZodObject<{
+    workflowId: z.ZodString;
+    sourceKind: z.ZodString;
+    errors: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    workflowId: string;
+    sourceKind: string;
+    errors: string[];
+}, {
+    workflowId: string;
+    sourceKind: string;
+    errors: string[];
+}>;
 export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     workflows: z.ZodArray<z.ZodObject<{
         workflowId: z.ZodString;
@@ -727,6 +740,19 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         } | undefined;
         stale?: true | undefined;
     }>, "many">>;
+    validationWarnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        workflowId: z.ZodString;
+        sourceKind: z.ZodString;
+        errors: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        workflowId: string;
+        sourceKind: string;
+        errors: string[];
+    }, {
+        workflowId: string;
+        sourceKind: string;
+        errors: string[];
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     workflows: {
         kind: "workflow";
@@ -797,6 +823,11 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     }[] | undefined;
     _nextStep?: string | undefined;
     staleRoots?: string[] | undefined;
+    validationWarnings?: {
+        workflowId: string;
+        sourceKind: string;
+        errors: string[];
+    }[] | undefined;
 }, {
     workflows: {
         kind: "workflow";
@@ -867,6 +898,11 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     }[] | undefined;
     _nextStep?: string | undefined;
     staleRoots?: string[] | undefined;
+    validationWarnings?: {
+        workflowId: string;
+        sourceKind: string;
+        errors: string[];
+    }[] | undefined;
 }>;
 export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
     workflowId: z.ZodString;

package/dist/mcp/output-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2StartWorkflowOutputSchema = exports.V2CheckpointWorkflowOutputSchema = exports.V2ResumeSessionOutputSchema = exports.V2ContinueWorkflowOutputSchema = exports.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.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.V2ValidationWarningSchema = 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");
@@ -113,6 +113,11 @@ exports.TagSummaryItemSchema = zod_1.z.object({
     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.V2ValidationWarningSchema = zod_1.z.object({
+    workflowId: zod_1.z.string().min(1),
+    sourceKind: zod_1.z.string().min(1),
+    errors: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+});
 exports.V2WorkflowListOutputSchema = zod_1.z.object({
     workflows: zod_1.z.array(exports.V2WorkflowListItemSchema),
     tagSummary: zod_1.z.array(exports.TagSummaryItemSchema).optional().describe('Tag summary for the workflow catalog. Present when no tags filter was applied. ' +
@@ -126,6 +131,11 @@ exports.V2WorkflowListOutputSchema = zod_1.z.object({
         '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.'),
+    validationWarnings: zod_1.z.array(exports.V2ValidationWarningSchema).optional().describe('Structured validation errors for non-bundled workflow files that failed JSON schema validation ' +
+        'and were excluded from the workflows list. Each entry identifies which workflow failed ' +
+        '(workflowId), which source it came from (sourceKind), and the specific validation errors (errors[]). ' +
+        'Absent when all workflows pass validation. Fix the listed errors in the workflow file and retry ' +
+        'list_workflows to confirm. Bundled (built-in) workflow failures are never included here.'),
 });
 exports.V2WorkflowInspectOutputSchema = zod_1.z.object({
     workflowId: zod_1.z.string().min(1),

package/dist/types/workflow-definition.d.ts

@@ -138,6 +138,7 @@ export interface WorkflowDefinition {
     readonly validatedAgainstSpecVersion?: number;
     readonly about?: string;
     readonly examples?: readonly string[];
+    readonly metricsProfile?: 'coding' | 'review' | 'research' | 'design' | 'ticket' | 'none';
 }
 export declare function isLoopStepDefinition(step: WorkflowStepDefinition | LoopStepDefinition): step is LoopStepDefinition;
 export declare function isWorkflowStepDefinition(step: WorkflowStepDefinition | LoopStepDefinition): step is WorkflowStepDefinition;

package/dist/v2/durable-core/domain/prompt-renderer.d.ts

@@ -9,6 +9,7 @@ export type PromptRenderError = {
     readonly message: string;
 };
 export declare function formatAssessmentRequirementsForTest(assessments: readonly Pick<AssessmentDefinition, 'id' | 'purpose' | 'dimensions'>[]): readonly string[];
+export declare function buildMetricsSection(profile: 'coding' | 'review' | 'research' | 'design' | 'ticket' | 'none' | undefined, isLastStep: boolean, cleanFormat: boolean): string;
 export declare function assembleFragmentedPrompt(fragments: readonly PromptFragment[], context: Record<string, unknown>): string;
 export interface StepMetadata {
     readonly stepId: string;

package/dist/v2/durable-core/domain/prompt-renderer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatAssessmentRequirementsForTest = formatAssessmentRequirementsForTest;
+exports.buildMetricsSection = buildMetricsSection;
 exports.assembleFragmentedPrompt = assembleFragmentedPrompt;
 exports.renderPendingPrompt = renderPendingPrompt;
 const neverthrow_1 = require("neverthrow");
@@ -204,6 +205,39 @@ function formatAssessmentRequirements(assessments) {
     }
     return requirements;
 }
+function buildMetricsSection(profile, isLastStep, cleanFormat) {
+    if (!profile || profile === 'none')
+        return '';
+    switch (profile) {
+        case 'coding': {
+            const shaFooter = cleanFormat
+                ? '\n\nMetrics: update context.metrics_commit_shas with the FULL accumulated SHA list (shallow merge -- partial lists lose earlier commits).'
+                : '\n\n**METRICS (System):** This is a coding workflow. After each commit, update `context.metrics_commit_shas` with the FULL accumulated list of commit SHAs from this session -- not just the current step\'s commits. Context uses shallow merge: sending only new SHAs permanently loses earlier ones.\n\nCall `continue_workflow` with:\n- `context: { metrics_commit_shas: ["<sha1>", "<sha2>", ...] }` -- full list, every step that has commits';
+            if (!isLastStep)
+                return shaFooter;
+            const finalFooter = cleanFormat
+                ? '\n\nMetrics (final): also set metrics_outcome, metrics_pr_numbers, metrics_files_changed, metrics_lines_added, metrics_lines_removed in context.'
+                : '\n\n**METRICS (System):** This is the final step. Also report:\n- `metrics_outcome`: `"success"` | `"partial"` | `"abandoned"` | `"error"`\n- `metrics_pr_numbers`: array of integer PR numbers (not URLs)\n- `metrics_files_changed`: integer count\n- `metrics_lines_added`: integer count\n- `metrics_lines_removed`: integer count\n\nCall `continue_workflow` with all of the above in `context: { metrics_commit_shas: [...], metrics_outcome: "success", ... }`.';
+            return shaFooter + finalFooter;
+        }
+        case 'review': {
+            if (!isLastStep)
+                return '';
+            return cleanFormat
+                ? '\n\nMetrics (final): set metrics_pr_numbers (integer array) and metrics_outcome in context.'
+                : '\n\n**METRICS (System):** This is the final step of a review workflow. Report:\n- `metrics_pr_numbers`: array of integer PR numbers reviewed (not URLs)\n- `metrics_outcome`: `"success"` | `"partial"` | `"abandoned"` | `"error"`\n\nCall `continue_workflow` with `context: { metrics_pr_numbers: [123], metrics_outcome: "success" }`.';
+        }
+        case 'research':
+        case 'design':
+        case 'ticket': {
+            if (!isLastStep)
+                return '';
+            return cleanFormat
+                ? '\n\nMetrics (final): set metrics_outcome in context.'
+                : '\n\n**METRICS (System):** This is the final step. Report:\n- `metrics_outcome`: `"success"` | `"partial"` | `"abandoned"` | `"error"`\n\nCall `continue_workflow` with `context: { metrics_outcome: "success" }`.';
+        }
+    }
+}
 function assembleFragmentedPrompt(fragments, context) {
     return fragments
         .filter(f => (0, condition_evaluator_js_1.evaluateCondition)(f.when, context))
@@ -336,6 +370,11 @@ function renderPendingPrompt(args) {
     const fragmentSuffix = promptFragments && promptFragments.length > 0
         ? assembleFragmentedPrompt(promptFragments, renderContext)
         : '';
+    const lastTopLevelStepId = args.workflow.definition.steps.at(-1)?.id;
+    const isLastTopLevelStep = args.stepId === lastTopLevelStepId;
+    const isLastExitStep = isExitStep && resolveParentLoopStep(args.workflow, args.stepId)?.id === lastTopLevelStepId;
+    const isLastStep = isLastTopLevelStep || isLastExitStep;
+    const metricsSection = buildMetricsSection(args.workflow.definition.metricsProfile, isLastStep, cleanResponseFormat);
     const enhancedPrompt = [
         loopBanner,
         basePrompt,
@@ -344,6 +383,7 @@ function renderPendingPrompt(args) {
         assessmentSection,
         notesSection,
         fragmentSuffix ? '\n\n' + fragmentSuffix : '',
+        metricsSection,
     ].join('');
     if (!args.rehydrateOnly) {
         return (0, neverthrow_1.ok)({ stepId: args.stepId, title: baseTitle, prompt: enhancedPrompt, agentRole, requireConfirmation });

package/dist/v2/projections/session-metrics.d.ts

@@ -4,7 +4,7 @@ export interface SessionMetricsV2 {
     readonly endGitSha: string | null;
     readonly gitBranch: string | null;
     readonly agentCommitShas: readonly string[];
-    readonly captureConfidence: 'high' | 'medium' | 'none';
+    readonly captureConfidence: 'high' | 'none';
     readonly durationMs: number | undefined;
     readonly outcome: 'success' | 'partial' | 'abandoned' | 'error' | null;
     readonly prNumbers: readonly number[];

package/dist/v2/projections/session-metrics.js

@@ -3,24 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectSessionMetricsV2 = projectSessionMetricsV2;
 const constants_js_1 = require("../durable-core/constants.js");
 function projectSessionMetricsV2(events) {
-    let runCompletedData = null;
-    let runCompletedRunId = null;
+    let runCompleted = null;
     for (const e of events) {
-        const asUnknown = e;
-        if (asUnknown.kind === 'run_completed') {
-            runCompletedData = asUnknown.data;
-            runCompletedRunId = asUnknown.scope?.runId ?? null;
+        if (e.kind === 'run_completed') {
+            runCompleted = e;
             break;
         }
     }
-    if (runCompletedData === null) {
+    if (runCompleted === null) {
         return null;
     }
+    const runCompletedRunId = runCompleted.scope.runId;
     const metricsContext = {};
     for (const e of events) {
         if (e.kind !== constants_js_1.EVENT_KIND.CONTEXT_SET)
             continue;
-        if (runCompletedRunId !== null && e.scope?.runId !== runCompletedRunId)
+        if (e.scope?.runId !== runCompletedRunId)
             continue;
         const ctx = e.data.context;
         if (!ctx || typeof ctx !== 'object' || Array.isArray(ctx))
@@ -32,25 +30,15 @@ function projectSessionMetricsV2(events) {
             }
         }
     }
-    const d = runCompletedData;
+    const d = runCompleted.data;
     const startGitSha = typeof d.startGitSha === 'string' ? d.startGitSha : null;
     const endGitSha = typeof d.endGitSha === 'string' ? d.endGitSha : null;
     const gitBranch = typeof d.gitBranch === 'string' ? d.gitBranch : null;
-    const agentCommitShas = [];
-    if (Array.isArray(d.agentCommitShas)) {
-        for (const sha of d.agentCommitShas) {
-            if (typeof sha === 'string') {
-                agentCommitShas.push(sha);
-            }
-        }
-    }
-    const captureConfidenceRaw = d.captureConfidence;
-    const captureConfidence = captureConfidenceRaw === 'high' || captureConfidenceRaw === 'medium' || captureConfidenceRaw === 'none'
-        ? captureConfidenceRaw
-        : 'none';
-    const durationMs = typeof d.durationMs === 'number' && Number.isFinite(d.durationMs)
-        ? d.durationMs
-        : undefined;
+    const agentCommitShas = Array.isArray(d.agentCommitShas)
+        ? d.agentCommitShas.filter((s) => typeof s === 'string')
+        : [];
+    const durationMs = typeof d.durationMs === 'number' && Number.isFinite(d.durationMs) ? d.durationMs : undefined;
+    const captureConfidence = d.captureConfidence === 'high' ? 'high' : 'none';
     const outcomeRaw = metricsContext['metrics_outcome'];
     const outcome = outcomeRaw === 'success' || outcomeRaw === 'partial' || outcomeRaw === 'abandoned' || outcomeRaw === 'error'
         ? outcomeRaw
@@ -68,24 +56,17 @@ function projectSessionMetricsV2(events) {
     const metricCommitShas = [];
     if (Array.isArray(commitShasRaw)) {
         for (const sha of commitShasRaw) {
-            if (typeof sha === 'string') {
+            if (typeof sha === 'string')
                 metricCommitShas.push(sha);
-            }
         }
     }
     const finalAgentCommitShas = metricCommitShas.length > 0 ? metricCommitShas : agentCommitShas;
     const filesChangedRaw = metricsContext['metrics_files_changed'];
-    const filesChanged = typeof filesChangedRaw === 'number' && Number.isFinite(filesChangedRaw)
-        ? filesChangedRaw
-        : null;
+    const filesChanged = typeof filesChangedRaw === 'number' && Number.isFinite(filesChangedRaw) ? filesChangedRaw : null;
     const linesAddedRaw = metricsContext['metrics_lines_added'];
-    const linesAdded = typeof linesAddedRaw === 'number' && Number.isFinite(linesAddedRaw)
-        ? linesAddedRaw
-        : null;
+    const linesAdded = typeof linesAddedRaw === 'number' && Number.isFinite(linesAddedRaw) ? linesAddedRaw : null;
     const linesRemovedRaw = metricsContext['metrics_lines_removed'];
-    const linesRemoved = typeof linesRemovedRaw === 'number' && Number.isFinite(linesRemovedRaw)
-        ? linesRemovedRaw
-        : null;
+    const linesRemoved = typeof linesRemovedRaw === 'number' && Number.isFinite(linesRemovedRaw) ? linesRemovedRaw : null;
     return {
         startGitSha,
         endGitSha,

package/dist/v2/usecases/console-routes.d.ts

@@ -1,6 +1,6 @@
 import type { Application } from 'express';
 import type { ConsoleService } from './console-service.js';
-import type { WorkflowService } from '../../application/services/workflow-service.js';
+import type { IWorkflowReader } from '../../types/storage.js';
 import type { ToolCallTimingRingBuffer } from '../../mcp/tool-call-timing.js';
 import type { V2ToolContext } from '../../mcp/types.js';
-export declare function mountConsoleRoutes(app: Application, consoleService: ConsoleService, workflowService?: WorkflowService, timingRingBuffer?: ToolCallTimingRingBuffer, toolCallsPerfFile?: string, serverVersion?: string, v2ToolContext?: V2ToolContext): () => void;
+export declare function mountConsoleRoutes(app: Application, consoleService: ConsoleService, workflowService?: IWorkflowReader, timingRingBuffer?: ToolCallTimingRingBuffer, toolCallsPerfFile?: string, serverVersion?: string, v2ToolContext?: V2ToolContext): () => void;