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

package/dist/recipes/schemaGenerator.js

@@ -0,0 +1,565 @@
+/**
+ * Schema Generator — produces JSON Schema from tool registry.
+ *
+ * Generates composable schemas for editor autocomplete:
+ *   - schemas/recipe.v1.json — top-level recipe schema
+ *   - schemas/tools/<namespace>.json — per-namespace tool param schemas
+ */
+import { getNamespaces, listTools } from "./toolRegistry.js";
+/**
+ * Generate complete schema set from current registry state.
+ */
+export function generateSchemaSet() {
+    const namespaces = {};
+    for (const ns of getNamespaces()) {
+        namespaces[ns] = generateNamespaceSchema(ns);
+    }
+    return {
+        recipe: generateRecipeSchema(namespaces),
+        namespaces,
+        dryRunPlan: generateDryRunPlanSchema(),
+    };
+}
+/**
+ * JSON Schema for RecipeDryRunPlan. Consumers (dashboard run timeline, external CI)
+ * should pin on `schemaVersion` and validate against this.
+ */
+export function generateDryRunPlanSchema() {
+    const riskEnum = { type: "string", enum: ["low", "medium", "high"] };
+    const planStep = {
+        type: "object",
+        required: ["id", "type"],
+        properties: {
+            id: { type: "string" },
+            type: { type: "string", enum: ["tool", "agent", "recipe"] },
+            tool: { type: "string" },
+            namespace: { type: "string" },
+            into: { type: "string" },
+            optional: { type: "boolean" },
+            prompt: { type: "string" },
+            params: { type: "object", additionalProperties: true },
+            dependencies: { type: "array", items: { type: "string" } },
+            condition: { type: "string" },
+            risk: riskEnum,
+            isWrite: { type: "boolean" },
+            isConnector: { type: "boolean" },
+            resolved: {
+                type: "boolean",
+                description: "True if the tool id is known to the registry at plan time",
+            },
+        },
+    };
+    return {
+        $schema: "http://json-schema.org/draft-07/schema#",
+        $id: "https://patchworkos.com/schema/dry-run-plan.v1.json",
+        title: "Patchwork Recipe Dry-Run Plan",
+        description: "Stable machine-readable output of `patchwork recipe run --dry-run`. Pin consumers on schemaVersion.",
+        type: "object",
+        required: [
+            "schemaVersion",
+            "recipe",
+            "mode",
+            "triggerType",
+            "generatedAt",
+            "steps",
+        ],
+        properties: {
+            schemaVersion: { type: "number", const: 1 },
+            recipe: { type: "string" },
+            mode: { type: "string", const: "dry-run" },
+            triggerType: { type: "string" },
+            generatedAt: {
+                type: "string",
+                description: "ISO-8601 timestamp when plan was generated",
+            },
+            stepSelection: {
+                type: "object",
+                properties: {
+                    query: { type: "string" },
+                    matchedBy: { type: "string" },
+                    matchedValue: { type: "string" },
+                },
+            },
+            steps: { type: "array", items: planStep },
+            parallelGroups: {
+                type: "array",
+                items: { type: "array", items: { type: "string" } },
+            },
+            maxDepth: { type: "number" },
+            connectorNamespaces: { type: "array", items: { type: "string" } },
+            hasWriteSteps: { type: "boolean" },
+        },
+    };
+}
+/**
+ * Generate top-level recipe schema that composes namespace tool schemas.
+ */
+function generateRecipeSchema(namespaceSchemas) {
+    const chainedStepMetadataProperties = {
+        id: {
+            type: "string",
+            description: "Unique chained step identifier used for outputs and dependencies",
+        },
+        awaits: {
+            type: "array",
+            description: "Step IDs that must complete before this step runs",
+            items: {
+                type: "string",
+            },
+        },
+        when: {
+            type: "string",
+            description: "Template condition that controls whether this step runs",
+        },
+        optional: {
+            type: "boolean",
+            description: "Whether step failure should be tolerated",
+        },
+        risk: {
+            type: "string",
+            enum: ["low", "medium", "high"],
+            description: "Risk level for this step",
+        },
+        transform: {
+            type: "string",
+            description: "Template rendered after tool execution. Use $result to reference the tool output. Supports all template expressions.",
+        },
+        retry: {
+            type: "number",
+            description: "Number of times to retry this step on failure (overrides recipe-level on_error.retry)",
+        },
+        retryDelay: {
+            type: "number",
+            description: "Milliseconds to wait between retries (default 1000)",
+        },
+    };
+    const toolRefs = Object.keys(namespaceSchemas).map((ns) => ({
+        allOf: [
+            {
+                $ref: `./tools/${ns}.json`,
+            },
+            {
+                type: "object",
+                properties: {
+                    ...chainedStepMetadataProperties,
+                },
+            },
+        ],
+    }));
+    const knownToolIds = listTools()
+        .map((tool) => tool.id)
+        .sort();
+    const chainedRecipeStep = {
+        type: "object",
+        anyOf: [{ required: ["recipe"] }, { required: ["chain"] }],
+        properties: {
+            ...chainedStepMetadataProperties,
+            recipe: {
+                type: "string",
+                description: "Nested recipe name or path",
+            },
+            chain: {
+                type: "string",
+                description: "Alias for nested recipe name or path",
+            },
+            vars: {
+                type: "object",
+                description: "Template variables passed into a nested recipe step",
+                additionalProperties: {
+                    type: "string",
+                },
+            },
+            output: {
+                type: "string",
+                description: "Output key for the nested recipe result",
+            },
+        },
+    };
+    // Leaf step variants reused inside parallel: items (one level, no recursion).
+    const leafStepVariants = [
+        ...toolRefs,
+        {
+            type: "object",
+            required: ["agent"],
+            properties: {
+                ...chainedStepMetadataProperties,
+                agent: {
+                    type: "object",
+                    required: ["prompt"],
+                    description: "Agent step configuration",
+                    properties: {
+                        prompt: { type: "string" },
+                        model: { type: "string" },
+                        driver: {
+                            type: "string",
+                            enum: [
+                                "claude",
+                                "claude-code",
+                                "api",
+                                "openai",
+                                "grok",
+                                "gemini",
+                                "anthropic",
+                            ],
+                        },
+                        into: { type: "string" },
+                    },
+                },
+            },
+        },
+        {
+            type: "object",
+            required: ["tool"],
+            properties: {
+                ...chainedStepMetadataProperties,
+                tool: { type: "string", not: { enum: knownToolIds } },
+                into: { type: "string" },
+            },
+        },
+        chainedRecipeStep,
+    ];
+    const parallelStep = {
+        type: "object",
+        required: ["parallel"],
+        properties: {
+            id: {
+                type: "string",
+                description: "Optional group id — used as awaits target by later steps",
+            },
+            awaits: {
+                type: "array",
+                description: "Step IDs that must complete before this group starts",
+                items: { type: "string" },
+            },
+            parallel: {
+                type: "array",
+                description: "Run these steps concurrently. All must finish before later steps that await this group.",
+                items: { oneOf: leafStepVariants },
+            },
+        },
+    };
+    return {
+        $schema: "http://json-schema.org/draft-07/schema#",
+        $id: "https://patchworkos.com/schema/recipe.v1.json",
+        title: "Patchwork Recipe",
+        description: "YAML recipe schema for Patchwork automation",
+        // taplo formatter: auto-associates *.patchwork.yaml files
+        "x-taplo": {
+            "file-patterns": ["*.patchwork.yaml", "*.patchwork.yml"],
+        },
+        type: "object",
+        required: ["name", "trigger", "steps"],
+        properties: {
+            name: {
+                type: "string",
+                description: "Recipe name (kebab-case recommended)",
+                pattern: "^[a-z0-9-]+$",
+            },
+            description: {
+                type: "string",
+                description: "Human-readable description of what this recipe does",
+            },
+            maxConcurrency: {
+                type: "number",
+                description: "Maximum number of chained steps that may execute in parallel",
+            },
+            maxDepth: {
+                type: "number",
+                description: "Maximum nested recipe depth for chained recipes",
+            },
+            version: {
+                type: "string",
+                description: "Semantic version",
+                default: "1.0.0",
+            },
+            apiVersion: {
+                type: "string",
+                description: "Patchwork API version",
+                enum: ["patchwork.sh/v1"],
+                default: "patchwork.sh/v1",
+            },
+            trigger: {
+                type: "object",
+                description: "When to run this recipe",
+                required: ["type"],
+                properties: {
+                    type: {
+                        type: "string",
+                        enum: [
+                            "manual",
+                            "cron",
+                            "webhook",
+                            "file_watch",
+                            "git_hook",
+                            "on_file_save",
+                            "on_test_run",
+                            "chained",
+                        ],
+                        description: "Trigger type",
+                    },
+                    at: {
+                        type: "string",
+                        description: "Cron expression (for cron trigger)",
+                    },
+                    glob: {
+                        type: "string",
+                        description: "File glob pattern (for file_watch trigger)",
+                    },
+                    on: {
+                        type: "string",
+                        enum: ["post-commit", "pre-push", "post-merge"],
+                        description: "Git hook event (for git_hook trigger)",
+                    },
+                    filter: {
+                        type: "string",
+                        description: "File filter pattern (for file_watch trigger)",
+                    },
+                    eventSource: {
+                        type: "string",
+                        description: "Webhook/event source name after legacy trigger normalization",
+                    },
+                    eventFilter: {
+                        oneOf: [
+                            {
+                                type: "string",
+                            },
+                            {
+                                type: "object",
+                            },
+                        ],
+                        description: "Webhook/event filter after legacy trigger normalization",
+                    },
+                    eventLeadTimeHours: {
+                        type: "number",
+                        description: "Lead time in hours after legacy trigger normalization",
+                    },
+                    eventLeadTimeMinutes: {
+                        type: "number",
+                        description: "Lead time in minutes after legacy trigger normalization",
+                    },
+                    legacyType: {
+                        type: "string",
+                        enum: ["event"],
+                        description: "Original trigger type preserved during legacy normalization",
+                    },
+                },
+            },
+            context: {
+                type: "array",
+                description: "Context blocks to load before running steps",
+                items: {
+                    type: "object",
+                    required: ["type"],
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: ["file", "env"],
+                        },
+                        path: { type: "string" },
+                        keys: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
+                    },
+                },
+            },
+            steps: {
+                type: "array",
+                description: "Sequence of steps to execute",
+                items: {
+                    oneOf: [
+                        ...toolRefs,
+                        {
+                            type: "object",
+                            required: ["agent"],
+                            properties: {
+                                ...chainedStepMetadataProperties,
+                                agent: {
+                                    type: "object",
+                                    required: ["prompt"],
+                                    description: "Agent step configuration",
+                                    properties: {
+                                        prompt: {
+                                            type: "string",
+                                            description: "Prompt to send to the AI (supports {{templates}})",
+                                        },
+                                        model: {
+                                            type: "string",
+                                            description: "Model to use for the agent step",
+                                        },
+                                        driver: {
+                                            type: "string",
+                                            enum: [
+                                                "claude",
+                                                "claude-code",
+                                                "api",
+                                                "openai",
+                                                "grok",
+                                                "gemini",
+                                                "anthropic",
+                                            ],
+                                            description: "Driver for agent execution",
+                                        },
+                                        into: {
+                                            type: "string",
+                                            description: "Variable name to store output in context",
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                        {
+                            type: "object",
+                            required: ["tool"],
+                            properties: {
+                                ...chainedStepMetadataProperties,
+                                tool: {
+                                    type: "string",
+                                    not: {
+                                        enum: knownToolIds,
+                                    },
+                                },
+                                into: {
+                                    type: "string",
+                                },
+                            },
+                        },
+                        chainedRecipeStep,
+                        parallelStep,
+                    ],
+                },
+            },
+            expect: {
+                type: "object",
+                description: "Optional assertions for mocked recipe tests",
+                properties: {
+                    stepsRun: {
+                        type: "number",
+                        description: "Expected number of executed steps",
+                    },
+                    outputs: {
+                        type: "array",
+                        description: "Expected output paths or keys recorded by the run",
+                        items: { type: "string" },
+                    },
+                    errorMessage: {
+                        type: ["string", "null"],
+                        description: "Expected final error message, or null for a clean run",
+                    },
+                    context: {
+                        type: "object",
+                        description: "Expected context key/value pairs after the run",
+                        additionalProperties: { type: "string" },
+                    },
+                },
+            },
+            output: {
+                type: "object",
+                description: "Output file configuration",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Path to write final output",
+                    },
+                },
+            },
+            on_error: {
+                type: "object",
+                description: "Error handling policy",
+                properties: {
+                    retry: {
+                        type: "number",
+                        description: "Number of retries per failing step (overridden by step.retry)",
+                        default: 0,
+                    },
+                    retryDelay: {
+                        type: "number",
+                        description: "Milliseconds between retries (overridden by step.retryDelay)",
+                        default: 1000,
+                    },
+                    fallback: {
+                        type: "string",
+                        enum: ["log_only", "abort", "deliver_original"],
+                        description: "log_only / deliver_original: treat step failure as non-fatal (like optional); fail-open. abort (default): propagate failure.",
+                    },
+                    notify: {
+                        type: "boolean",
+                        description: "Reserved. yamlRunner currently posts Slack notifications on any step failure when slack is connected; gating on this flag is not yet wired.",
+                        default: true,
+                    },
+                },
+            },
+        },
+    };
+}
+/**
+ * Generate schema for a namespace's tools.
+ */
+function generateNamespaceSchema(namespace) {
+    const tools = listTools(namespace);
+    const definitions = {};
+    const anyOf = [];
+    for (const tool of tools) {
+        const toolSchema = generateToolSchema(tool);
+        definitions[tool.id.replace(".", "_")] = toolSchema;
+        anyOf.push({ $ref: `#/definitions/${tool.id.replace(".", "_")}` });
+    }
+    return {
+        $schema: "http://json-schema.org/draft-07/schema#",
+        $id: `https://patchworkos.com/schema/tools/${namespace}.json`,
+        title: `${capitalize(namespace)} Tools`,
+        description: `Tool parameters for ${namespace} namespace`,
+        definitions,
+        anyOf,
+    };
+}
+/**
+ * Extract properties from tool paramsSchema, merging with base tool property.
+ */
+function getToolProperties(tool) {
+    const base = {
+        tool: {
+            type: "string",
+            const: tool.id,
+            description: `Tool: ${tool.id}`,
+        },
+    };
+    const schema = tool.paramsSchema;
+    const extra = schema && typeof schema === "object" && "properties" in schema
+        ? schema.properties
+        : undefined;
+    return extra ? { ...base, ...extra } : base;
+}
+/**
+ * Generate schema for a single tool's parameters.
+ */
+function generateToolSchema(tool) {
+    const schema = tool.paramsSchema;
+    const requiredFromParams = schema && typeof schema === "object" && Array.isArray(schema.required)
+        ? schema.required.filter((value) => typeof value === "string")
+        : [];
+    return {
+        type: "object",
+        title: tool.id,
+        description: tool.description,
+        properties: getToolProperties(tool),
+        required: ["tool", ...requiredFromParams],
+    };
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/**
+ * Write schema files to disk.
+ */
+export async function writeSchemas(outputDir, schemas, writeFile) {
+    // Write main recipe schema
+    await writeFile(`${outputDir}/recipe.v1.json`, JSON.stringify(schemas.recipe, null, 2));
+    // Write dry-run plan schema
+    await writeFile(`${outputDir}/dry-run-plan.v1.json`, JSON.stringify(schemas.dryRunPlan, null, 2));
+    // Write per-namespace schemas
+    for (const [ns, schema] of Object.entries(schemas.namespaces)) {
+        await writeFile(`${outputDir}/tools/${ns}.json`, JSON.stringify(schema, null, 2));
+    }
+}
+//# sourceMappingURL=schemaGenerator.js.map

package/dist/recipes/schemaGenerator.js.map

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

package/dist/recipes/templateEngine.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Template Engine — safe template resolution for recipe step outputs.
+ *
+ * Replaces the deprecated `vm2` approach with a pure AST-based evaluator.
+ * Supports: `{{steps.X.data}}`, `{{steps.X.data.field.subfield}}`, `{{env.Y}}`
+ *
+ * Security: No eval, no Function constructor, no VM. Just path walking.
+ */
+export interface TemplateContext {
+    steps: Record<string, StepOutput>;
+    env: Record<string, string | undefined>;
+}
+export interface StepOutput {
+    status: "success" | "error" | "skipped";
+    data: unknown;
+    metadata?: {
+        startedAt: Date;
+        completedAt: Date;
+        model?: string;
+        tokenUsage?: number;
+    };
+}
+export interface TemplateCompileError {
+    type: "compile_error";
+    template: string;
+    message: string;
+}
+export interface TemplateEvalError {
+    type: "eval_error";
+    template: string;
+    path: string;
+    message: string;
+}
+export type TemplateError = TemplateCompileError | TemplateEvalError;
+export interface CompiledTemplate {
+    readonly source: string;
+    readonly hasTemplates: boolean;
+    evaluate(context: TemplateContext): {
+        value: string;
+    } | {
+        error: TemplateError;
+    };
+}
+/**
+ * Compile a template string into an executable form.
+ * Parses `{{...}}` expressions once, not per-evaluation.
+ */
+export declare function compileTemplate(template: string): CompiledTemplate;
+/**
+ * Convenience: compile and evaluate in one call.
+ * Prefer pre-compilation for repeated evaluations.
+ */
+export declare function evaluateTemplate(template: string, context: TemplateContext): {
+    value: string;
+} | {
+    error: TemplateError;
+};
+/**
+ * Validate all templates in a recipe at load time.
+ * Returns array of errors, empty if all valid.
+ */
+export declare function validateRecipeTemplates(templates: string[]): TemplateError[];