patchwork-os 0.2.0-alpha.3 → 0.2.0-alpha.30

package/dist/recipes/validation.js

@@ -0,0 +1,433 @@
+import { Ajv } from "ajv";
+import { FLAG_SCHEMA_LINT, isEnabled } from "../featureFlags.js";
+import { normalizeRecipeForRuntime } from "./legacyRecipeCompat.js";
+import { generateSchemaSet } from "./schemaGenerator.js";
+import { listToolOutputContextKeys } from "./toolRegistry.js";
+export function validateRecipeDefinition(recipe) {
+    const issues = [];
+    const normalizedRecipe = normalizeRecipeForValidation(recipe);
+    if (!normalizedRecipe || typeof normalizedRecipe !== "object") {
+        issues.push({ level: "error", message: "Recipe must be a YAML object" });
+    }
+    else {
+        const r = normalizedRecipe;
+        if (!r.name || typeof r.name !== "string") {
+            issues.push({
+                level: "error",
+                message: "Missing or invalid 'name' field",
+            });
+        }
+        else if (!/^[a-z0-9-]+$/.test(r.name)) {
+            issues.push({
+                level: "warning",
+                message: "Recipe name should use kebab-case (lowercase letters, numbers, hyphens)",
+            });
+        }
+        if (!r.description || typeof r.description !== "string") {
+            issues.push({ level: "warning", message: "Missing 'description' field" });
+        }
+        if (!r.trigger || typeof r.trigger !== "object") {
+            issues.push({
+                level: "error",
+                message: "Missing or invalid 'trigger' field",
+            });
+        }
+        else {
+            const trigger = r.trigger;
+            const validTypes = [
+                "manual",
+                "cron",
+                "webhook",
+                "file_watch",
+                "git_hook",
+                "on_file_save",
+                "on_test_run",
+                "chained",
+            ];
+            if (!trigger.type || !validTypes.includes(trigger.type)) {
+                issues.push({
+                    level: "error",
+                    message: `Invalid trigger.type. Must be one of: ${validTypes.join(", ")}`,
+                });
+            }
+            if (trigger.type === "cron" && !trigger.at) {
+                issues.push({
+                    level: "warning",
+                    message: "cron trigger should have 'at' (cron expression)",
+                });
+            }
+        }
+        if (!Array.isArray(r.steps) || r.steps.length === 0) {
+            issues.push({
+                level: "error",
+                message: "Recipe must have at least one step",
+            });
+        }
+        else {
+            const triggerType = r.trigger && typeof r.trigger === "object"
+                ? r.trigger.type
+                : undefined;
+            const allowNestedRecipeSteps = triggerType === "chained";
+            for (let i = 0; i < r.steps.length; i++) {
+                const step = r.steps[i];
+                const hasTool = typeof step.tool === "string";
+                const hasAgent = !!step.agent;
+                const hasNestedRecipe = allowNestedRecipeSteps &&
+                    (typeof step.recipe === "string" || typeof step.chain === "string");
+                if (!hasTool && !hasAgent && !hasNestedRecipe) {
+                    issues.push({
+                        level: "error",
+                        message: `Step ${i + 1}: Must have 'tool' or 'agent' field${allowNestedRecipeSteps ? " (or 'recipe'/'chain' for chained recipes)" : ""}`,
+                    });
+                }
+                if (step.agent && typeof step.agent === "object") {
+                    const agent = step.agent;
+                    if (!agent.prompt || typeof agent.prompt !== "string") {
+                        issues.push({
+                            level: "error",
+                            message: `Step ${i + 1}: Agent step missing 'prompt'`,
+                        });
+                    }
+                }
+            }
+            validateTemplateReferences(r, issues);
+        }
+    }
+    if (isEnabled(FLAG_SCHEMA_LINT)) {
+        issues.push(...validateRecipeSchema(normalizedRecipe));
+    }
+    const errors = issues.filter((i) => i.level === "error").length;
+    const warnings = issues.filter((i) => i.level === "warning").length;
+    return {
+        valid: errors === 0,
+        issues,
+        warnings,
+        errors,
+    };
+}
+function normalizeRecipeForValidation(recipe) {
+    const normalized = normalizeRecipeForRuntime(recipe, console.warn);
+    if (!normalized ||
+        typeof normalized !== "object" ||
+        Array.isArray(normalized)) {
+        return normalized;
+    }
+    const validationReady = {
+        ...normalized,
+    };
+    if (validationReady.trigger &&
+        typeof validationReady.trigger === "object" &&
+        !Array.isArray(validationReady.trigger)) {
+        validationReady.trigger = normalizeValidationTrigger(validationReady.trigger);
+    }
+    if (Array.isArray(validationReady.steps)) {
+        validationReady.steps = flattenValidationSteps(validationReady.steps);
+    }
+    return validationReady;
+}
+function normalizeValidationTrigger(trigger) {
+    const normalized = { ...trigger };
+    if (normalized.type === "event") {
+        normalized.type = "webhook";
+        normalized.legacyType = "event";
+        if (typeof normalized.on === "string") {
+            normalized.eventSource = normalized.on;
+        }
+        delete normalized.on;
+        if (normalized.filter !== undefined &&
+            typeof normalized.filter !== "string") {
+            normalized.eventFilter = normalized.filter;
+            delete normalized.filter;
+        }
+        if (normalized.lead_time_hours !== undefined) {
+            normalized.eventLeadTimeHours = normalized.lead_time_hours;
+            delete normalized.lead_time_hours;
+        }
+        if (normalized.lead_time_minutes !== undefined) {
+            normalized.eventLeadTimeMinutes = normalized.lead_time_minutes;
+            delete normalized.lead_time_minutes;
+        }
+    }
+    return normalized;
+}
+function flattenValidationSteps(steps) {
+    const normalizedSteps = [];
+    for (const step of steps) {
+        normalizedSteps.push(...flattenValidationStep(step));
+    }
+    return normalizedSteps;
+}
+function flattenValidationStep(step) {
+    if (!step || typeof step !== "object" || Array.isArray(step)) {
+        return [step];
+    }
+    const record = step;
+    if (Array.isArray(record.parallel)) {
+        const parallelSteps = [];
+        for (const nestedStep of record.parallel) {
+            parallelSteps.push(...flattenValidationStep(nestedStep));
+        }
+        return parallelSteps;
+    }
+    if (Array.isArray(record.branch)) {
+        const branchSteps = [];
+        for (const branchStep of record.branch) {
+            if (!branchStep ||
+                typeof branchStep !== "object" ||
+                Array.isArray(branchStep)) {
+                continue;
+            }
+            const branchRecord = branchStep;
+            const otherwiseStep = branchRecord.otherwise;
+            if (otherwiseStep &&
+                typeof otherwiseStep === "object" &&
+                !Array.isArray(otherwiseStep)) {
+                branchSteps.push(...flattenValidationStep(otherwiseStep));
+                continue;
+            }
+            branchSteps.push(...flattenValidationStep(branchRecord));
+        }
+        return branchSteps.length > 0 ? branchSteps : [record];
+    }
+    return [record];
+}
+function validateRecipeSchema(recipe) {
+    try {
+        const schemas = generateSchemaSet();
+        const ajv = new Ajv({ strict: false, allErrors: true });
+        for (const schema of Object.values(schemas.namespaces)) {
+            ajv.addSchema(schema);
+        }
+        const validate = ajv.compile(schemas.recipe);
+        const valid = validate(recipe);
+        if (valid) {
+            return [];
+        }
+        return (validate.errors ?? []).map(toSchemaLintIssue);
+    }
+    catch (err) {
+        return [
+            {
+                level: "error",
+                message: `Schema validation failed to initialize: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        ];
+    }
+}
+function registerRecipeContextKeys(recipe, availableKeys) {
+    const trigger = recipe.trigger && typeof recipe.trigger === "object"
+        ? recipe.trigger
+        : undefined;
+    if (trigger?.type === "git_hook") {
+        availableKeys.add("hash");
+        availableKeys.add("message");
+        availableKeys.add("branch");
+    }
+    if (trigger?.type === "on_file_save") {
+        availableKeys.add("file");
+    }
+    if (trigger?.type === "on_test_run") {
+        availableKeys.add("runner");
+        availableKeys.add("failed");
+        availableKeys.add("passed");
+        availableKeys.add("total");
+        availableKeys.add("failures");
+    }
+    if (trigger?.legacyType === "event") {
+        availableKeys.add("event");
+    }
+    if (Array.isArray(trigger?.vars)) {
+        for (const item of trigger.vars) {
+            if (item && typeof item === "object" && typeof item.name === "string") {
+                availableKeys.add(item.name);
+            }
+        }
+    }
+    if (Array.isArray(trigger?.inputs)) {
+        for (const item of trigger.inputs) {
+            if (item && typeof item === "object" && typeof item.name === "string") {
+                availableKeys.add(item.name);
+            }
+        }
+    }
+    if (Array.isArray(recipe.context)) {
+        for (const block of recipe.context) {
+            if (!block || typeof block !== "object") {
+                continue;
+            }
+            const typedBlock = block;
+            if (typedBlock.type === "env" && Array.isArray(typedBlock.keys)) {
+                for (const key of typedBlock.keys) {
+                    if (typeof key === "string") {
+                        availableKeys.add(key);
+                    }
+                }
+            }
+        }
+    }
+}
+function toSchemaLintIssue(error) {
+    const path = error.instancePath
+        ? error.instancePath.slice(1).replace(/\//g, ".")
+        : "recipe";
+    return {
+        level: "error",
+        message: `Schema validation: ${path} ${error.message ?? "is invalid"}`,
+    };
+}
+function validateTemplateReferences(recipe, issues) {
+    const builtinKeys = new Set([
+        "date",
+        "time",
+        "YYYY-MM",
+        "YYYY-MM-DD",
+        "ISO_NOW",
+    ]);
+    const availableKeys = new Set(builtinKeys);
+    registerRecipeContextKeys(recipe, availableKeys);
+    const triggerType = recipe.trigger && typeof recipe.trigger === "object"
+        ? recipe.trigger.type
+        : undefined;
+    const isChainedRecipe = triggerType === "chained";
+    const steps = Array.isArray(recipe.steps)
+        ? recipe.steps
+        : [];
+    const seenIntoKeys = new Map();
+    for (let index = 0; index < steps.length; index++) {
+        const step = steps[index] ?? {};
+        const templates = collectRenderedTemplates(step, isChainedRecipe);
+        for (const template of templates) {
+            const scopedKeys = template.extraKeys
+                ? new Set([...availableKeys, ...template.extraKeys])
+                : availableKeys;
+            for (const expression of extractTemplateExpressions(template.value)) {
+                for (const identifier of extractTemplateIdentifiers(expression)) {
+                    if (!scopedKeys.has(identifier)) {
+                        issues.push({
+                            level: "error",
+                            message: `Step ${index + 1}: Unknown template reference '{{${expression}}}' in ${template.label}`,
+                        });
+                        break;
+                    }
+                }
+            }
+        }
+        const intoKey = resolveStepIntoKey(step, isChainedRecipe);
+        if (intoKey) {
+            if (builtinKeys.has(intoKey)) {
+                issues.push({
+                    level: "error",
+                    message: `Step ${index + 1}: 'into: ${intoKey}' shadows a built-in context key`,
+                });
+            }
+            else {
+                const firstSeen = seenIntoKeys.get(intoKey);
+                if (firstSeen !== undefined) {
+                    issues.push({
+                        level: "warning",
+                        message: `Step ${index + 1}: 'into: ${intoKey}' overwrites value already written by step ${firstSeen}`,
+                    });
+                }
+                else {
+                    seenIntoKeys.set(intoKey, index + 1);
+                }
+            }
+        }
+        registerStepContextKeys(step, availableKeys);
+    }
+}
+function collectRenderedTemplates(step, isChainedRecipe) {
+    const templates = [];
+    // transform: renders with $result injected (raw tool output); any key under
+    // $result.* is resolved at runtime and cannot be statically validated.
+    const transformExtraKeys = new Set(["$result"]);
+    for (const [key, value] of Object.entries(step)) {
+        if (key === "tool" || key === "into" || key === "agent") {
+            continue;
+        }
+        if (typeof value === "string") {
+            if (key === "transform") {
+                templates.push({ label: key, value, extraKeys: transformExtraKeys });
+            }
+            else {
+                templates.push({ label: key, value });
+            }
+        }
+    }
+    if (step.agent && typeof step.agent === "object") {
+        const agent = step.agent;
+        if (typeof agent.prompt === "string") {
+            templates.push({ label: "agent.prompt", value: agent.prompt });
+        }
+    }
+    if (isChainedRecipe && step.vars && typeof step.vars === "object") {
+        for (const [key, value] of Object.entries(step.vars)) {
+            if (typeof value === "string") {
+                templates.push({ label: `vars.${key}`, value });
+            }
+        }
+    }
+    return templates;
+}
+function extractTemplateExpressions(template) {
+    const matches = template.matchAll(/\{\{\s*([^}]+?)\s*\}\}/g);
+    const expressions = [];
+    for (const match of matches) {
+        const expression = match[1]?.trim();
+        if (expression) {
+            expressions.push(expression);
+        }
+    }
+    return expressions;
+}
+function extractTemplateIdentifiers(expression) {
+    const reserved = new Set(["true", "false", "null"]);
+    const identifiers = new Set();
+    for (const match of expression.matchAll(/\$?[A-Za-z_][A-Za-z0-9_-]*(?:\.[A-Za-z0-9_-]+)*/g)) {
+        const rawIdentifier = match[0];
+        if (!rawIdentifier) {
+            continue;
+        }
+        const rootIdentifier = rawIdentifier.split(".")[0] ?? rawIdentifier;
+        if (!reserved.has(rootIdentifier)) {
+            identifiers.add(rootIdentifier);
+        }
+    }
+    return Array.from(identifiers);
+}
+function registerStepContextKeys(step, availableKeys) {
+    const stepId = typeof step.id === "string" ? step.id : undefined;
+    if (stepId) {
+        availableKeys.add(stepId);
+    }
+    if (step.agent && typeof step.agent === "object") {
+        const agent = step.agent;
+        const intoKey = typeof agent.into === "string" ? agent.into : "agent_output";
+        availableKeys.add(intoKey);
+        return;
+    }
+    const intoKey = typeof step.into === "string" ? step.into : undefined;
+    if (!intoKey) {
+        return;
+    }
+    availableKeys.add(intoKey);
+    const toolId = typeof step.tool === "string" ? step.tool : undefined;
+    if (!toolId) {
+        return;
+    }
+    for (const key of listToolOutputContextKeys(toolId, intoKey)) {
+        availableKeys.add(key);
+    }
+}
+function resolveStepIntoKey(step, isChainedRecipe) {
+    if (step.agent && typeof step.agent === "object") {
+        const agent = step.agent;
+        return typeof agent.into === "string" ? agent.into : "agent_output";
+    }
+    if (typeof step.into === "string")
+        return step.into;
+    if (isChainedRecipe && typeof step.id === "string")
+        return step.id;
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/dist/recipes/validation.js.map

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

package/dist/recipes/yamlRunner.d.ts

@@ -20,6 +20,8 @@
  *   manual, cron — both run immediately via CLI
  *   git_hook, on_file_save — also runnable manually; trigger context injected
  */
+import type { ErrorPolicy } from "./schema.js";
+import "./tools/index.js";
 export interface YamlStep {
     tool?: string;
     agent?: {
@@ -30,6 +32,11 @@ export interface YamlStep {
     };
     into?: string;
     optional?: boolean;
+    /** Retry count for this step on failure (overrides recipe-level on_error.retry). */
+    retry?: number;
+    /** Delay in ms between retries (default 1000). */
+    retryDelay?: number;
+    transform?: string;
     [key: string]: unknown;
 }
 export interface YamlTrigger {
@@ -39,14 +46,31 @@ export interface YamlTrigger {
     on?: string;
     filter?: string;
 }
+export interface YamlRecipeExpect {
+    stepsRun?: number;
+    outputs?: string[];
+    errorMessage?: string | null;
+    context?: Record<string, string>;
+}
+export interface AssertionFailure {
+    assertion: string;
+    expected: unknown;
+    actual: unknown;
+    message: string;
+}
+export declare function evaluateExpect(result: Pick<RunResult, "stepsRun" | "outputs" | "context" | "errorMessage">, expect: YamlRecipeExpect): AssertionFailure[];
 export interface YamlRecipe {
     name: string;
     description?: string;
     trigger: YamlTrigger;
     steps: YamlStep[];
+    expect?: YamlRecipeExpect;
     output?: {
         path: string;
     };
+    /** Plugin specs (npm package name or local path) to load before running steps. */
+    servers?: string[];
+    on_error?: ErrorPolicy;
 }
 export type RunContext = Record<string, string>;
 export type FetchFn = (url: string, init?: {
@@ -55,6 +79,9 @@ export type FetchFn = (url: string, init?: {
     ok: boolean;
     json(): Promise<unknown>;
 }>;
+export interface MockToolConnector {
+    invoke<TOutput = unknown>(operation: string, input?: unknown): Promise<TOutput>;
+}
 export interface RunnerDeps {
     now?: () => Date;
     readFile?: (p: string) => string;
@@ -71,22 +98,82 @@ export interface RunnerDeps {
     fetchFn?: FetchFn;
     /** Optional token resolver for Gmail. Defaults to getValidAccessToken(). */
     getGmailToken?: () => Promise<string>;
+    /** Override the ~/.patchwork dir used by RecipeRunLog. Useful for tests. */
+    logDir?: string;
     /** Optional Anthropic API caller for agent steps. Defaults to fetch-based impl. */
     claudeFn?: (prompt: string, model: string) => Promise<string>;
     /** Optional Claude Code CLI caller for agent steps with driver: claude-code. */
     claudeCodeFn?: (prompt: string) => Promise<string>;
+    /** Optional local LLM caller (Ollama / LM Studio) for agent steps with driver: local or model: local. */
+    localFn?: (prompt: string, model: string) => Promise<string>;
+    /**
+     * Optional provider driver invoker for agent steps with driver: openai|grok|gemini.
+     * Dispatches to src/drivers/* under the hood. If not provided, the runner will
+     * lazily construct a driver via createDriver() from drivers/index.js.
+     */
+    providerDriverFn?: (driverName: "openai" | "grok" | "gemini", prompt: string, model: string | undefined) => Promise<string>;
+    /** Mock connector replays used by `patchwork recipe test`. */
+    mockConnectors?: Partial<Record<string, MockToolConnector>>;
+    /** Directory to store recorded connector fixtures for `patchwork recipe record`. */
+    recordFixturesDir?: string;
+    /** Suppress run logs / notifications for mocked recipe test execution. */
+    testMode?: boolean;
 }
 export interface RunResult {
     recipe: string;
     stepsRun: number;
     outputs: string[];
     context: RunContext;
+    stepResults: StepResult[];
+    errorMessage?: string;
+    assertionFailures?: AssertionFailure[];
 }
+export type StepResult = {
+    id: string;
+    tool?: string;
+    status: "ok" | "skipped" | "error";
+    error?: string;
+    durationMs: number;
+};
+export type StepDeps = Required<Omit<RunnerDeps, "now" | "logDir" | "recordFixturesDir">> & {
+    workdir: string;
+    logDir?: string;
+    recordFixturesDir?: string;
+    testMode: boolean;
+};
 export declare function loadYamlRecipe(filePath: string): YamlRecipe;
 export declare function validateYamlRecipe(raw: unknown): YamlRecipe;
+/**
+ * Load plugin specs declared in `recipe.servers` and register their tools into
+ * the recipe tool registry. Errors per-spec are logged as warnings — never fatal.
+ */
+export declare function loadRecipeServers(specs: string[]): Promise<void>;
 export declare function runYamlRecipe(recipe: YamlRecipe, deps?: RunnerDeps, seedContext?: RunContext): Promise<RunResult>;
+export declare function executeStep(step: YamlStep, ctx: RunContext, deps: StepDeps): Promise<string | null>;
 /** Minimal `{{ expr }}` renderer — replaces against flat context map. */
 export declare function render(template: string, ctx: RunContext): string;
+/**
+ * Build ExecutionDeps for ChainedRecipeRunner backed by the yamlRunner step
+ * handlers. This lets chained recipes use the same tool set (file.*, git.*,
+ * gmail.*, github.*, linear.*, diagnostics.*) as simple YAML recipes.
+ *
+ * Pass the result as `chainedDeps` when calling `dispatchRecipe` or
+ * `runChainedRecipe` so that `executeTool` is properly wired.
+ */
+export declare function buildChainedDeps(runnerDeps: RunnerDeps, claudeCodeFnOverride?: (prompt: string) => Promise<string>): import("./chainedRunner.js").ExecutionDeps;
+/**
+ * Dispatch a loaded recipe to the appropriate runner.
+ *
+ * Recipes with `trigger.type: "chained"` are routed to the ChainedRecipeRunner
+ * (parallel execution, template variables, nested recipes, dry-run).
+ * All other recipes use the existing synchronous yamlRunner path.
+ *
+ * `chainedDeps` is only required when the recipe is chained; omit for simple recipes.
+ */
+export declare function dispatchRecipe(recipe: YamlRecipe, deps: RunnerDeps & {
+    chainedDeps?: import("./chainedRunner.js").ExecutionDeps;
+    chainedOptions?: Partial<import("./chainedRunner.js").RunOptions>;
+}, seedContext?: RunContext): Promise<RunResult | import("./chainedRunner.js").ChainedRunResult>;
 /** List all YAML recipes in a directory. Returns names. */
 export declare function listYamlRecipes(recipesDir: string): Array<{
     name: string;