@exaudeus/workrail 1.7.0 → 1.7.1

package/dist/manifest.json

@@ -526,8 +526,8 @@
       "bytes": 796
     },
     "mcp/handler-factory.js": {
-      "sha256": "fca1b2d87d7d0961bc0c3ec337d5c18ffe8a379964af3836b1ac532bab1195ea",
-      "bytes": 3382
+      "sha256": "711bdf8bd71eaf2ad2a6b6b1bf84db004030e06223ce52075e01470a3bffd88d",
+      "bytes": 3805
     },
     "mcp/handlers/session.d.ts": {
       "sha256": "38926e69a0e4935d1dbcdc53848be9fff0e4d8f96827883da3216f217918fa82",
@@ -838,8 +838,8 @@
       "bytes": 5486
     },
     "mcp/v2/tools.js": {
-      "sha256": "0d26b75a7e038f494570f5fdc1d624f5bb28bfa7e368ea4d3259ae27dc889301",
-      "bytes": 7748
+      "sha256": "5af4e1a5a3a6c43df6db4ea40eb6d12fd0757af94f4e3e80d9f875ecf0181544",
+      "bytes": 7812
     },
     "mcp/validation/bounded-json.d.ts": {
       "sha256": "82203ac6123d5c6989606c3b5405aaea99ab829c8958835f9ae3ba45b8bc8fd5",
@@ -850,12 +850,12 @@
       "bytes": 834
     },
     "mcp/validation/index.d.ts": {
-      "sha256": "3e3f12357fd8214470d111454e4002338e5eb93329b5a3758664db51e44c12ec",
-      "bytes": 944
+      "sha256": "2e1bf908d402aa27f939aa1ee8dd78e38ccd6f0d6f5c19e6c18c93807e8fffce",
+      "bytes": 1036
     },
     "mcp/validation/index.js": {
-      "sha256": "dccd3a2dc7e486afd27ee44f77303486f60cc840563821b97ac341f9cad6650c",
-      "bytes": 4445
+      "sha256": "5ab761835388b0dd353293312899ded3433fe69121b38317f6ddf3ab2a6587dc",
+      "bytes": 4664
     },
     "mcp/validation/schema-introspection.d.ts": {
       "sha256": "7e0262e76234dd37079156027e95a30987b8949351f3e9ec0fd7b2be093a159d",
@@ -882,12 +882,12 @@
       "bytes": 592
     },
     "mcp/validation/suggestion-generator.d.ts": {
-      "sha256": "491d983f4a03516fc0ba09ff40da2c859ec600f29a41093b0359ba549c7882cc",
-      "bytes": 450
+      "sha256": "159bde7596e7459f6025e152a24f1ab850d5cbd2bf55461036a05709dc5dbaa1",
+      "bytes": 731
     },
     "mcp/validation/suggestion-generator.js": {
-      "sha256": "e952a4d3cb569222cde1bd01dd9d5be887ee394ba007478bbb446fa177172859",
-      "bytes": 4075
+      "sha256": "e4988260027f7c17398da69a7b1b8dcbb266f1b42100c63723a6d99426a0802e",
+      "bytes": 5250
     },
     "mcp/validation/suggestion-types.d.ts": {
       "sha256": "b93ae2e42f4b24789dcbe19db31a41af9534ad0dca85635339c2a10db42e298b",

package/dist/mcp/handler-factory.js

@@ -34,12 +34,16 @@ function createHandler(schema, handler) {
         if (!parseResult.success) {
             const suggestionResult = (0, index_js_1.generateSuggestions)(args, schema, index_js_1.DEFAULT_SUGGESTION_CONFIG);
             const suggestionDetails = (0, index_js_1.formatSuggestionDetails)(suggestionResult);
+            const patchedTemplate = (0, index_js_1.patchTemplateForFailedOptionals)(suggestionDetails.correctTemplate ?? null, args, parseResult.error.errors, schema, index_js_1.DEFAULT_SUGGESTION_CONFIG.maxTemplateDepth);
+            const patchedDetails = patchedTemplate !== suggestionDetails.correctTemplate
+                ? { ...suggestionDetails, correctTemplate: patchedTemplate }
+                : suggestionDetails;
             return toMcpResult((0, types_js_1.errNotRetryable)('VALIDATION_ERROR', 'Invalid input', {
                 validationErrors: parseResult.error.errors.map(e => ({
                     path: e.path.join('.'),
                     message: e.message,
                 })),
-                ...suggestionDetails,
+                ...patchedDetails,
             }));
         }
         try {

package/dist/mcp/v2/tools.js

@@ -9,7 +9,7 @@ exports.V2InspectWorkflowInput = zod_1.z.object({
 });
 exports.V2StartWorkflowInput = zod_1.z.object({
     workflowId: zod_1.z.string().min(1).regex(/^[A-Za-z0-9_-]+$/, 'Workflow ID must contain only letters, numbers, hyphens, and underscores').describe('The workflow ID to start'),
-    context: zod_1.z.record(zod_1.z.unknown()).optional().describe('External facts influencing execution (ticketId, branch, constraints). Pass once at start to establish baseline. WorkRail auto-loads context on subsequent continue_workflow calls. Only pass context again if facts have CHANGED (e.g., user provided new information). Do NOT re-pass unchanged values.'),
+    context: zod_1.z.record(zod_1.z.unknown()).optional().describe('Structured context for this workflow — must be a JSON OBJECT with string keys, NOT a string. For design/analysis workflows: {"problem":"describe the problem","constraints":"...","goals":"..."}. For coding workflows: {"ticketId":"ACEI-1234","branch":"main"}. WorkRail injects these into step prompts. Pass once at start; re-pass only values that have CHANGED.'),
     workspacePath: zod_1.z.string()
         .refine((p) => p.startsWith('/'), 'workspacePath must be an absolute path (starting with /)')
         .optional()

package/dist/mcp/validation/index.d.ts

@@ -4,4 +4,5 @@ export type { SuggestionConfig } from './suggestion-config.js';
 export { DEFAULT_SUGGESTION_CONFIG, MINIMAL_SUGGESTION_CONFIG } from './suggestion-config.js';
 export { levenshteinDistance, computeSimilarity, computeSimilarityIgnoreCase, findClosestMatch, findAllMatches, type ClosestMatch, } from './string-similarity.js';
 export { extractExpectedKeys, extractRequiredKeys, findUnknownKeys, findMissingRequiredKeys, generateExampleValue, generateTemplate, extractEnumValues, } from './schema-introspection.js';
-export { generateSuggestions, formatSuggestionDetails, hasSuggestions, } from './suggestion-generator.js';
+export { generateSuggestions, formatSuggestionDetails, hasSuggestions, patchTemplateForFailedOptionals, } from './suggestion-generator.js';
+export type { ZodIssue } from './suggestion-generator.js';

package/dist/mcp/validation/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasSuggestions = exports.formatSuggestionDetails = exports.generateSuggestions = exports.extractEnumValues = exports.generateTemplate = exports.generateExampleValue = exports.findMissingRequiredKeys = exports.findUnknownKeys = exports.extractRequiredKeys = exports.extractExpectedKeys = exports.findAllMatches = exports.findClosestMatch = exports.computeSimilarityIgnoreCase = exports.computeSimilarity = exports.levenshteinDistance = exports.MINIMAL_SUGGESTION_CONFIG = exports.DEFAULT_SUGGESTION_CONFIG = exports.isInvalidEnumSuggestion = exports.isMissingRequiredSuggestion = exports.isUnknownKeySuggestion = exports.EMPTY_SUGGESTION_RESULT = exports.similarity = void 0;
+exports.patchTemplateForFailedOptionals = exports.hasSuggestions = exports.formatSuggestionDetails = exports.generateSuggestions = exports.extractEnumValues = exports.generateTemplate = exports.generateExampleValue = exports.findMissingRequiredKeys = exports.findUnknownKeys = exports.extractRequiredKeys = exports.extractExpectedKeys = exports.findAllMatches = exports.findClosestMatch = exports.computeSimilarityIgnoreCase = exports.computeSimilarity = exports.levenshteinDistance = exports.MINIMAL_SUGGESTION_CONFIG = exports.DEFAULT_SUGGESTION_CONFIG = exports.isInvalidEnumSuggestion = exports.isMissingRequiredSuggestion = exports.isUnknownKeySuggestion = exports.EMPTY_SUGGESTION_RESULT = exports.similarity = void 0;
 var suggestion_types_js_1 = require("./suggestion-types.js");
 Object.defineProperty(exports, "similarity", { enumerable: true, get: function () { return suggestion_types_js_1.similarity; } });
 Object.defineProperty(exports, "EMPTY_SUGGESTION_RESULT", { enumerable: true, get: function () { return suggestion_types_js_1.EMPTY_SUGGESTION_RESULT; } });
@@ -28,3 +28,4 @@ var suggestion_generator_js_1 = require("./suggestion-generator.js");
 Object.defineProperty(exports, "generateSuggestions", { enumerable: true, get: function () { return suggestion_generator_js_1.generateSuggestions; } });
 Object.defineProperty(exports, "formatSuggestionDetails", { enumerable: true, get: function () { return suggestion_generator_js_1.formatSuggestionDetails; } });
 Object.defineProperty(exports, "hasSuggestions", { enumerable: true, get: function () { return suggestion_generator_js_1.hasSuggestions; } });
+Object.defineProperty(exports, "patchTemplateForFailedOptionals", { enumerable: true, get: function () { return suggestion_generator_js_1.patchTemplateForFailedOptionals; } });

package/dist/mcp/validation/suggestion-generator.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 import type { SuggestionConfig } from './suggestion-config.js';
 import type { SuggestionResult } from './suggestion-types.js';
+export type { ZodIssue } from 'zod';
 export declare function generateSuggestions(args: unknown, schema: z.ZodType, config: SuggestionConfig): SuggestionResult;
 export declare function formatSuggestionDetails(result: SuggestionResult): Record<string, unknown>;
 export declare function hasSuggestions(result: SuggestionResult): boolean;
+export declare function patchTemplateForFailedOptionals(correctTemplate: Readonly<Record<string, unknown>> | null, args: unknown, zodErrors: readonly z.ZodIssue[], schema: z.ZodType, maxDepth: number): Readonly<Record<string, unknown>> | null;

package/dist/mcp/validation/suggestion-generator.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateSuggestions = generateSuggestions;
 exports.formatSuggestionDetails = formatSuggestionDetails;
 exports.hasSuggestions = hasSuggestions;
+exports.patchTemplateForFailedOptionals = patchTemplateForFailedOptionals;
 const zod_1 = require("zod");
 const suggestion_types_js_1 = require("./suggestion-types.js");
 const string_similarity_js_1 = require("./string-similarity.js");
@@ -99,3 +100,32 @@ function formatSuggestionDetails(result) {
 function hasSuggestions(result) {
     return result.suggestions.length > 0 || result.correctTemplate !== null;
 }
+function patchTemplateForFailedOptionals(correctTemplate, args, zodErrors, schema, maxDepth) {
+    if (correctTemplate === null)
+        return null;
+    if (!(schema instanceof zod_1.z.ZodObject))
+        return correctTemplate;
+    if (args === null || typeof args !== 'object' || Array.isArray(args))
+        return correctTemplate;
+    const argsObj = args;
+    const shape = schema._def.shape();
+    const patched = { ...correctTemplate };
+    let changed = false;
+    for (const error of zodErrors) {
+        if (error.path.length !== 1)
+            continue;
+        const field = error.path[0];
+        if (!(field in argsObj))
+            continue;
+        if (!(field in shape))
+            continue;
+        if (field in patched)
+            continue;
+        const fieldSchema = shape[field];
+        if (!(fieldSchema instanceof zod_1.z.ZodOptional))
+            continue;
+        patched[field] = (0, schema_introspection_js_1.generateExampleValue)(fieldSchema._def.innerType, 0, maxDepth);
+        changed = true;
+    }
+    return changed ? Object.freeze(patched) : correctTemplate;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "Step-by-step workflow enforcement for AI agents via MCP",
   "license": "MIT",
   "repository": {