cyrus-edge-worker 0.2.5 → 0.2.7

package/dist/validation/ValidationLoopController.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ValidationLoopController - Orchestrates the validation loop with retry logic
+ *
+ * This controller manages the validation loop that runs verifications and fixes
+ * up to a configurable maximum number of iterations.
+ */
+import type { ValidationFixerContext, ValidationLoopConfig, ValidationLoopState, ValidationResult } from "./types.js";
+import { VALIDATION_RESULT_SCHEMA } from "./types.js";
+/**
+ * Parse a validation result from an agent's response
+ *
+ * Supports multiple formats:
+ * 1. Native structured output (message.structured_output) - validated with Zod
+ * 2. JSON in response text - validated with Zod
+ * 3. Fallback prompt engineering extraction (for Gemini and other runners)
+ */
+export declare function parseValidationResult(response: string | undefined, structuredOutput?: unknown): ValidationResult;
+/**
+ * Get the JSON schema for validation results
+ */
+export declare function getValidationResultSchema(): typeof VALIDATION_RESULT_SCHEMA;
+/**
+ * Load the validation-fixer prompt template
+ */
+export declare function loadValidationFixerPrompt(): string;
+/**
+ * Render the validation-fixer prompt with context
+ */
+export declare function renderValidationFixerPrompt(context: ValidationFixerContext): string;
+/**
+ * Create initial validation loop state
+ */
+export declare function createInitialState(): ValidationLoopState;
+/**
+ * Record a validation attempt and determine next action
+ */
+export declare function recordAttempt(state: ValidationLoopState, result: ValidationResult, config?: ValidationLoopConfig): ValidationLoopState;
+/**
+ * Get the fixer context for the current state
+ */
+export declare function getFixerContext(state: ValidationLoopState, config?: ValidationLoopConfig): ValidationFixerContext | null;
+/**
+ * Check if the validation loop should continue
+ */
+export declare function shouldContinueLoop(state: ValidationLoopState): boolean;
+/**
+ * Check if we should proceed to the next subroutine after validation
+ */
+export declare function shouldProceedAfterValidation(state: ValidationLoopState, config?: ValidationLoopConfig): boolean;
+/**
+ * Get a summary of the validation loop execution
+ */
+export declare function getValidationSummary(state: ValidationLoopState): string;
+//# sourceMappingURL=ValidationLoopController.d.ts.map

package/dist/validation/ValidationLoopController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationLoopController.d.ts","sourceRoot":"","sources":["../../src/validation/ValidationLoopController.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACX,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEN,wBAAwB,EAExB,MAAM,YAAY,CAAC;AAMpB;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,gBAAgB,CAAC,EAAE,OAAO,GACxB,gBAAgB,CAqGlB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,wBAAwB,CAE3E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CASlD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,sBAAsB,GAC7B,MAAM,CA4BR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,CAOxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,gBAAgB,EACxB,MAAM,GAAE,oBAAqD,GAC3D,mBAAmB,CAmCrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,mBAAmB,EAC1B,MAAM,GAAE,oBAAqD,GAC3D,sBAAsB,GAAG,IAAI,CAmB/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,mBAAmB,EAC1B,MAAM,GAAE,oBAAqD,GAC3D,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAcvE"}

package/dist/validation/ValidationLoopController.js

@@ -0,0 +1,242 @@
+/**
+ * ValidationLoopController - Orchestrates the validation loop with retry logic
+ *
+ * This controller manages the validation loop that runs verifications and fixes
+ * up to a configurable maximum number of iterations.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { DEFAULT_VALIDATION_LOOP_CONFIG, VALIDATION_RESULT_SCHEMA, ValidationResultSchema, } from "./types.js";
+// Get __dirname equivalent for ESM
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Parse a validation result from an agent's response
+ *
+ * Supports multiple formats:
+ * 1. Native structured output (message.structured_output) - validated with Zod
+ * 2. JSON in response text - validated with Zod
+ * 3. Fallback prompt engineering extraction (for Gemini and other runners)
+ */
+export function parseValidationResult(response, structuredOutput) {
+    // 1. Try native structured output first (Claude SDK) - validate with Zod
+    if (structuredOutput && typeof structuredOutput === "object") {
+        const parsed = ValidationResultSchema.safeParse(structuredOutput);
+        if (parsed.success) {
+            return parsed.data;
+        }
+        // Log validation error for debugging but continue to fallback methods
+        console.debug("[parseValidationResult] Structured output validation failed:", parsed.error.message);
+    }
+    // 2. Try to parse JSON from response - validate with Zod
+    if (response) {
+        // Try to extract JSON from markdown code blocks
+        const jsonMatch = response.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+        const jsonString = jsonMatch
+            ? (jsonMatch[1] ?? "").trim()
+            : response.trim();
+        try {
+            const jsonParsed = JSON.parse(jsonString);
+            const zodParsed = ValidationResultSchema.safeParse(jsonParsed);
+            if (zodParsed.success) {
+                return zodParsed.data;
+            }
+        }
+        catch {
+            // JSON parsing failed, continue to fallback
+        }
+        // 3. Fallback: try to infer from response text (for Gemini and other runners)
+        const lowerResponse = response.toLowerCase();
+        // Check for explicit pass/fail indicators
+        if (lowerResponse.includes('"pass": true') ||
+            lowerResponse.includes('"pass":true') ||
+            lowerResponse.includes("pass: true")) {
+            // Extract reason if possible
+            const reasonMatch = response.match(/"reason"\s*:\s*"([^"]+)"|reason:\s*["']?([^"'\n]+)/i);
+            return {
+                pass: true,
+                reason: reasonMatch
+                    ? (reasonMatch[1] ?? reasonMatch[2] ?? "Verifications passed")
+                    : "Verifications passed",
+            };
+        }
+        if (lowerResponse.includes('"pass": false') ||
+            lowerResponse.includes('"pass":false') ||
+            lowerResponse.includes("pass: false")) {
+            const reasonMatch = response.match(/"reason"\s*:\s*"([^"]+)"|reason:\s*["']?([^"'\n]+)/i);
+            return {
+                pass: false,
+                reason: reasonMatch
+                    ? (reasonMatch[1] ?? reasonMatch[2] ?? "Verifications failed")
+                    : "Verifications failed",
+            };
+        }
+        // Last resort: look for success/failure indicators in natural language
+        if (lowerResponse.includes("all verifications passed") ||
+            lowerResponse.includes("all tests pass") ||
+            lowerResponse.includes("verifications successful")) {
+            return {
+                pass: true,
+                reason: response.substring(0, 200),
+            };
+        }
+        if (lowerResponse.includes("verification failed") ||
+            lowerResponse.includes("tests failed") ||
+            lowerResponse.includes("error") ||
+            lowerResponse.includes("failure")) {
+            return {
+                pass: false,
+                reason: response.substring(0, 500),
+            };
+        }
+    }
+    // Default: assume failure if we can't parse
+    return {
+        pass: false,
+        reason: response
+            ? `Could not parse validation result: ${response.substring(0, 200)}`
+            : "No response received from validation",
+    };
+}
+/**
+ * Get the JSON schema for validation results
+ */
+export function getValidationResultSchema() {
+    return VALIDATION_RESULT_SCHEMA;
+}
+/**
+ * Load the validation-fixer prompt template
+ */
+export function loadValidationFixerPrompt() {
+    const promptPath = join(__dirname, "..", "prompts", "subroutines", "validation-fixer.md");
+    return readFileSync(promptPath, "utf-8");
+}
+/**
+ * Render the validation-fixer prompt with context
+ */
+export function renderValidationFixerPrompt(context) {
+    let template = loadValidationFixerPrompt();
+    // Replace template variables
+    template = template.replace("{{FAILURE_REASON}}", context.failureReason);
+    template = template.replace("{{ITERATION}}", String(context.iteration));
+    template = template.replace("{{MAX_ITERATIONS}}", String(context.maxIterations));
+    // Handle previous attempts section
+    if (context.previousAttempts.length > 0) {
+        const attemptsText = context.previousAttempts
+            .map((attempt) => `- Attempt ${attempt.iteration}: ${attempt.reason}`)
+            .join("\n");
+        template = template.replace("{{#if PREVIOUS_ATTEMPTS}}", "");
+        template = template.replace("{{/if}}", "");
+        template = template.replace("{{PREVIOUS_ATTEMPTS}}", attemptsText);
+    }
+    else {
+        // Remove the conditional block if no previous attempts
+        template = template.replace(/{{#if PREVIOUS_ATTEMPTS}}[\s\S]*?{{\/if}}/g, "");
+    }
+    return template;
+}
+/**
+ * Create initial validation loop state
+ */
+export function createInitialState() {
+    return {
+        iteration: 0,
+        attempts: [],
+        completed: false,
+        outcome: "in_progress",
+    };
+}
+/**
+ * Record a validation attempt and determine next action
+ */
+export function recordAttempt(state, result, config = DEFAULT_VALIDATION_LOOP_CONFIG) {
+    const newIteration = state.iteration + 1;
+    const newAttempts = [
+        ...state.attempts,
+        {
+            iteration: newIteration,
+            result,
+            timestamp: Date.now(),
+        },
+    ];
+    if (result.pass) {
+        return {
+            iteration: newIteration,
+            attempts: newAttempts,
+            completed: true,
+            outcome: "passed",
+        };
+    }
+    if (newIteration >= config.maxIterations) {
+        return {
+            iteration: newIteration,
+            attempts: newAttempts,
+            completed: true,
+            outcome: "failed_max_retries",
+        };
+    }
+    return {
+        iteration: newIteration,
+        attempts: newAttempts,
+        completed: false,
+        outcome: "in_progress",
+    };
+}
+/**
+ * Get the fixer context for the current state
+ */
+export function getFixerContext(state, config = DEFAULT_VALIDATION_LOOP_CONFIG) {
+    if (state.completed || state.attempts.length === 0) {
+        return null;
+    }
+    const lastAttempt = state.attempts[state.attempts.length - 1];
+    if (!lastAttempt) {
+        return null;
+    }
+    return {
+        failureReason: lastAttempt.result.reason,
+        iteration: state.iteration,
+        maxIterations: config.maxIterations,
+        previousAttempts: state.attempts.slice(0, -1).map((a) => ({
+            iteration: a.iteration,
+            reason: a.result.reason,
+        })),
+    };
+}
+/**
+ * Check if the validation loop should continue
+ */
+export function shouldContinueLoop(state) {
+    return !state.completed && state.outcome === "in_progress";
+}
+/**
+ * Check if we should proceed to the next subroutine after validation
+ */
+export function shouldProceedAfterValidation(state, config = DEFAULT_VALIDATION_LOOP_CONFIG) {
+    if (state.outcome === "passed") {
+        return true;
+    }
+    if (state.outcome === "failed_max_retries") {
+        return config.continueOnMaxRetries;
+    }
+    // Still in progress - shouldn't call this
+    return false;
+}
+/**
+ * Get a summary of the validation loop execution
+ */
+export function getValidationSummary(state) {
+    if (state.outcome === "passed") {
+        const lastAttempt = state.attempts[state.attempts.length - 1];
+        return `Validation passed after ${state.iteration} attempt(s): ${lastAttempt?.result.reason ?? "unknown"}`;
+    }
+    if (state.outcome === "failed_max_retries") {
+        const reasons = state.attempts
+            .map((a) => `Attempt ${a.iteration}: ${a.result.reason}`)
+            .join("\n");
+        return `Validation failed after ${state.iteration} attempts:\n${reasons}`;
+    }
+    return `Validation in progress: ${state.iteration} attempt(s) so far`;
+}
+//# sourceMappingURL=ValidationLoopController.js.map

package/dist/validation/ValidationLoopController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationLoopController.js","sourceRoot":"","sources":["../../src/validation/ValidationLoopController.ts"],"names":[],"mappings":"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"}

package/dist/validation/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validation loop module - provides functionality for running verification
+ * subroutines with retry logic and structured outputs
+ */
+export { DEFAULT_VALIDATION_LOOP_CONFIG, VALIDATION_RESULT_SCHEMA, type ValidationFixerContext, type ValidationLoopConfig, type ValidationLoopState, type ValidationResult, ValidationResultSchema, } from "./types.js";
+export { createInitialState, getFixerContext, getValidationResultSchema, getValidationSummary, loadValidationFixerPrompt, parseValidationResult, recordAttempt, renderValidationFixerPrompt, shouldContinueLoop, shouldProceedAfterValidation, } from "./ValidationLoopController.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,8BAA8B,EAC9B,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,sBAAsB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,2BAA2B,EAC3B,kBAAkB,EAClB,4BAA4B,GAC5B,MAAM,+BAA+B,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,7 @@
+/**
+ * Validation loop module - provides functionality for running verification
+ * subroutines with retry logic and structured outputs
+ */
+export { DEFAULT_VALIDATION_LOOP_CONFIG, VALIDATION_RESULT_SCHEMA, ValidationResultSchema, } from "./types.js";
+export { createInitialState, getFixerContext, getValidationResultSchema, getValidationSummary, loadValidationFixerPrompt, parseValidationResult, recordAttempt, renderValidationFixerPrompt, shouldContinueLoop, shouldProceedAfterValidation, } from "./ValidationLoopController.js";
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,8BAA8B,EAC9B,wBAAwB,EAKxB,sBAAsB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,2BAA2B,EAC3B,kBAAkB,EAClB,4BAA4B,GAC5B,MAAM,+BAA+B,CAAC"}

package/dist/validation/types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Types for the validation loop system
+ */
+import { z } from "zod";
+/**
+ * Zod schema for ValidationResult - the single source of truth
+ * Used with Claude SDK structured outputs
+ */
+export declare const ValidationResultSchema: z.ZodObject<{
+    /** Whether all verifications passed */
+    pass: z.ZodBoolean;
+    /** Summary of validation results or failure reasons */
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    pass: boolean;
+    reason: string;
+}, {
+    pass: boolean;
+    reason: string;
+}>;
+/**
+ * TypeScript type inferred from the Zod schema
+ */
+export type ValidationResult = z.infer<typeof ValidationResultSchema>;
+/**
+ * JSON Schema for ValidationResult - converted from Zod schema
+ * Used with Claude SDK structured outputs
+ */
+export declare const VALIDATION_RESULT_SCHEMA: {
+    type: "object";
+    properties: {
+        pass: {
+            type: "boolean";
+            description: string;
+        };
+        reason: {
+            type: "string";
+            description: string;
+        };
+    };
+    required: ["pass", "reason"];
+    additionalProperties: false;
+};
+/**
+ * Configuration for the validation loop
+ */
+export interface ValidationLoopConfig {
+    /** Maximum number of validation attempts (default: 4) */
+    maxIterations: number;
+    /** Whether to continue to next subroutine even if validation fails after all retries */
+    continueOnMaxRetries: boolean;
+}
+/**
+ * Default validation loop configuration
+ */
+export declare const DEFAULT_VALIDATION_LOOP_CONFIG: ValidationLoopConfig;
+/**
+ * State tracking for a validation loop execution
+ */
+export interface ValidationLoopState {
+    /** Current iteration (1-based) */
+    iteration: number;
+    /** Results from each validation attempt */
+    attempts: Array<{
+        iteration: number;
+        result: ValidationResult;
+        timestamp: number;
+    }>;
+    /** Whether the loop has completed (either passed or exhausted retries) */
+    completed: boolean;
+    /** Final outcome */
+    outcome: "passed" | "failed_max_retries" | "in_progress";
+}
+/**
+ * Context passed to the validation-fixer subroutine
+ */
+export interface ValidationFixerContext {
+    /** The failure reason from the previous validation attempt */
+    failureReason: string;
+    /** Current iteration number */
+    iteration: number;
+    /** Maximum iterations allowed */
+    maxIterations: number;
+    /** Previous attempt results for context */
+    previousAttempts: Array<{
+        iteration: number;
+        reason: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/validation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IAClC,uCAAuC;;IAEvC,uDAAuD;;;;;;;;EAMtD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAMhC;IACJ,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACX,IAAI,EAAE;YAAE,IAAI,EAAE,SAAS,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,MAAM,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;KAChD,CAAC;IACF,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7B,oBAAoB,EAAE,KAAK,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,oBAAoB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,oBAG5C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,KAAK,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,gBAAgB,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,OAAO,EAAE,QAAQ,GAAG,oBAAoB,GAAG,aAAa,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,gBAAgB,EAAE,KAAK,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACH"}

package/dist/validation/types.js

@@ -0,0 +1,33 @@
+/**
+ * Types for the validation loop system
+ */
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+/**
+ * Zod schema for ValidationResult - the single source of truth
+ * Used with Claude SDK structured outputs
+ */
+export const ValidationResultSchema = z.object({
+    /** Whether all verifications passed */
+    pass: z.boolean().describe("Whether all verifications passed"),
+    /** Summary of validation results or failure reasons */
+    reason: z
+        .string()
+        .describe("Summary of validation results (e.g., '47 tests passing, linting clean, types valid') or failure reasons (e.g., 'TypeScript error in src/foo.ts:42 - Property x does not exist on type Y')"),
+});
+/**
+ * JSON Schema for ValidationResult - converted from Zod schema
+ * Used with Claude SDK structured outputs
+ */
+export const VALIDATION_RESULT_SCHEMA = zodToJsonSchema(ValidationResultSchema, {
+    $refStrategy: "none",
+    target: "jsonSchema7",
+});
+/**
+ * Default validation loop configuration
+ */
+export const DEFAULT_VALIDATION_LOOP_CONFIG = {
+    maxIterations: 4,
+    continueOnMaxRetries: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,uCAAuC;IACvC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC9D,uDAAuD;IACvD,MAAM,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACR,2LAA2L,CAC3L;CACF,CAAC,CAAC;AAOH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CACtD,sBAAsB,EACtB;IACC,YAAY,EAAE,MAAM;IACpB,MAAM,EAAE,aAAa;CACrB,CASD,CAAC;AAYF;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyB;IACnE,aAAa,EAAE,CAAC;IAChB,oBAAoB,EAAE,IAAI;CAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cyrus-edge-worker",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Unified edge worker for processing Linear issues with Claude",
   "type": "module",
   "main": "dist/index.js",
@@ -18,13 +18,15 @@
     "chokidar": "^4.0.3",
     "fastify": "^5.2.0",
     "file-type": "^18.7.0",
-    "cyrus-claude-runner": "0.2.5",
-    "cyrus-cloudflare-tunnel-client": "0.2.5",
-    "cyrus-core": "0.2.5",
-    "cyrus-config-updater": "0.2.5",
-    "cyrus-gemini-runner": "0.2.5",
-    "cyrus-simple-agent-runner": "0.2.5",
-    "cyrus-linear-event-transport": "0.2.5"
+    "zod": "3.24.1",
+    "zod-to-json-schema": "3.24.1",
+    "cyrus-cloudflare-tunnel-client": "0.2.7",
+    "cyrus-claude-runner": "0.2.7",
+    "cyrus-core": "0.2.7",
+    "cyrus-config-updater": "0.2.7",
+    "cyrus-gemini-runner": "0.2.7",
+    "cyrus-linear-event-transport": "0.2.7",
+    "cyrus-simple-agent-runner": "0.2.7"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",