@exaudeus/workrail 0.1.7 → 0.1.8

package/dist/application/app.d.ts

@@ -22,4 +22,9 @@ export declare const METHOD_NAMES: {
     readonly SHUTDOWN: "shutdown";
 };
 export type MethodName = typeof METHOD_NAMES[keyof typeof METHOD_NAMES];
-export declare function buildWorkflowApplication(workflowService: WorkflowService, validator?: MethodValidator): ApplicationMediator;
+export interface IApplicationMediator {
+    execute(method: string, params: any): Promise<any>;
+    register(method: string, handler: any): void;
+    setResponseValidator(fn: (method: string, result: any) => void): void;
+}
+export declare function buildWorkflowApplication(workflowService: WorkflowService, validator?: MethodValidator, enableOutputOptimization?: boolean): IApplicationMediator;

package/dist/application/app.js

@@ -71,6 +71,7 @@ const list_workflows_1 = require("./use-cases/list-workflows");
 const get_workflow_1 = require("./use-cases/get-workflow");
 const get_next_step_1 = require("./use-cases/get-next-step");
 const validate_step_output_1 = require("./use-cases/validate-step-output");
+const simple_output_decorator_1 = require("./decorators/simple-output-decorator");
 exports.METHOD_NAMES = {
     WORKFLOW_LIST: 'workflow_list',
     WORKFLOW_GET: 'workflow_get',
@@ -80,7 +81,7 @@ exports.METHOD_NAMES = {
     TOOLS_LIST: 'tools/list',
     SHUTDOWN: 'shutdown'
 };
-function buildWorkflowApplication(workflowService, validator = request_validator_1.requestValidator) {
+function buildWorkflowApplication(workflowService, validator = request_validator_1.requestValidator, enableOutputOptimization = true) {
     const app = new ApplicationMediator(validator);
     app.setResponseValidator((method, result) => response_validator_1.responseValidator.validate(method, result));
     const listWorkflowsUseCase = (0, list_workflows_1.createListWorkflows)(workflowService);
@@ -112,5 +113,8 @@ function buildWorkflowApplication(workflowService, validator = request_validator
         const { shutdownHandler } = await Promise.resolve().then(() => __importStar(require('../tools/mcp_shutdown')));
         return (await shutdownHandler({ id: 0, params, method: 'shutdown', jsonrpc: '2.0' })).result;
     });
+    if (enableOutputOptimization) {
+        return new simple_output_decorator_1.SimpleOutputDecorator(app);
+    }
     return app;
 }

package/dist/application/decorators/simple-output-decorator.d.ts

@@ -0,0 +1,8 @@
+import { IApplicationMediator } from '../app';
+export declare class SimpleOutputDecorator implements IApplicationMediator {
+    private readonly wrapped;
+    constructor(wrapped: IApplicationMediator);
+    execute(method: string, params: any): Promise<any>;
+    register(method: string, handler: any): void;
+    setResponseValidator(fn: (method: string, result: any) => void): void;
+}

package/dist/application/decorators/simple-output-decorator.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleOutputDecorator = void 0;
+const CONTEXT_OPTIMIZATION_TEXT = `
+
+**CONTEXT OPTIMIZATION REQUIREMENTS**:
+
+The MCP server is STATELESS. You MUST send required data with each request:
+
+**ALWAYS INCLUDE:**
+1. \`workflowId\` - Required for all calls
+2. \`completedSteps\` - Full array of completed step IDs
+3. **Condition Variables** - ANY variable used in step \`runCondition\` fields
+4. **Template Variables** - ANY variable referenced in {{templates}} in prompts/titles
+5. **Your New/Modified Variables** - Variables you created or changed in this step
+
+**CONDITIONALLY INCLUDE:**
+- **Loop Variables** (when in a loop): \`currentIteration\`, \`currentItem\`, \`currentIndex\`
+- **Active Loop State**: Only \`_loopState[currentLoopId]\` if currently in a loop
+- **Referenced Variables**: Any variable that future steps might need
+
+**NEVER INCLUDE:**
+- Large arrays that aren't being actively iterated (e.g., \`implementationSteps\` array)
+- Stale loop states from completed loops
+- Unreferenced historical data
+- Variables only used in completed steps
+
+**SIZE TARGETS:**
+- Normal steps: < 2KB
+- Loop iterations: < 5KB
+- Complex state: < 10KB
+
+**EXAMPLE - Loop Context:**
+\`\`\`json
+{
+  "workflowId": "coding-task-workflow",
+  "completedSteps": ["phase-1", "phase-2", "loop-step-1"],
+  "context": {
+    // Required: condition/template variables
+    "taskComplexity": "Medium",
+    "totalImplementationSteps": 8,
+    "currentStepNumber": 3,
+    
+    // Required: your changes
+    "stepCompleted": true,
+    "testResults": "passed",
+    
+    // Required: active loop state only
+    "_loopState": {
+      "phase-6-loop": { "iteration": 3 }
+    },
+    
+    // DON'T include:
+    // - implementationSteps: [...] // Large array
+    // - analysisResults: {...} // From phase 1
+    // - _loopState.oldLoop: {...} // Completed loop
+  }
+}
+\`\`\`
+
+**VALIDATION CHECK**: Before sending, verify you have ALL variables referenced in:
+- The next step's \`runCondition\`
+- Any {{variable}} in the next step's prompts
+- Variables needed for loop control`;
+class SimpleOutputDecorator {
+    constructor(wrapped) {
+        this.wrapped = wrapped;
+    }
+    async execute(method, params) {
+        const result = await this.wrapped.execute(method, params);
+        if (method === 'workflow_next' && result?.guidance?.prompt) {
+            return {
+                ...result,
+                guidance: {
+                    ...result.guidance,
+                    prompt: result.guidance.prompt + CONTEXT_OPTIMIZATION_TEXT
+                }
+            };
+        }
+        return result;
+    }
+    register(method, handler) {
+        this.wrapped.register(method, handler);
+    }
+    setResponseValidator(fn) {
+        this.wrapped.setResponseValidator(fn);
+    }
+}
+exports.SimpleOutputDecorator = SimpleOutputDecorator;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "MCP server for structured workflow orchestration and step-by-step task guidance",
   "license": "MIT",
   "bin": {