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

package/dist/recipes/templateEngine.js

@@ -0,0 +1,182 @@
+/**
+ * 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.
+ */
+/**
+ * Compile a template string into an executable form.
+ * Parses `{{...}}` expressions once, not per-evaluation.
+ */
+export function compileTemplate(template) {
+    const parts = [];
+    // Match {{expression}} — non-greedy, no nesting
+    const regex = /\{\{([^{}]+)\}\}/g;
+    let lastIndex = 0;
+    let match;
+    while ((match = regex.exec(template)) !== null) {
+        // Add literal text before this match
+        if (match.index > lastIndex) {
+            parts.push(template.slice(lastIndex, match.index));
+        }
+        const expression = match[1]?.trim();
+        if (!expression)
+            continue;
+        const parsed = parseExpression(expression);
+        if (!parsed) {
+            return {
+                source: template,
+                hasTemplates: true,
+                evaluate: () => ({
+                    error: {
+                        type: "compile_error",
+                        template,
+                        message: `Invalid expression: ${expression}`,
+                    },
+                }),
+            };
+        }
+        parts.push(parsed);
+        lastIndex = regex.lastIndex;
+    }
+    // Add remaining literal text
+    if (lastIndex < template.length) {
+        parts.push(template.slice(lastIndex));
+    }
+    return {
+        source: template,
+        hasTemplates: parts.some((p) => typeof p !== "string"),
+        evaluate: (context) => evaluateCompiled(parts, context),
+    };
+}
+/**
+ * Parse an expression like "steps.X.data.field" or "env.HOME"
+ * Returns null if invalid syntax.
+ */
+function parseExpression(expr) {
+    const parts = expr.split(".");
+    if (parts.length < 2)
+        return null;
+    const root = parts[0];
+    const rest = parts.slice(1);
+    if (root === "steps" && rest.length >= 2) {
+        // steps.X.data or steps.X.data.field
+        return { path: expr, type: "step" };
+    }
+    if (root === "env" && rest.length === 1) {
+        // env.HOME
+        return { path: expr, type: "env" };
+    }
+    return null;
+}
+function evaluateCompiled(parts, context) {
+    const values = [];
+    for (const part of parts) {
+        if (typeof part === "string") {
+            values.push(part);
+            continue;
+        }
+        const result = evaluateExpression(part, context);
+        if ("error" in result) {
+            return result;
+        }
+        values.push(result.value);
+    }
+    return { value: values.join("") };
+}
+function evaluateExpression(expr, context) {
+    const parts = expr.path.split(".");
+    if (expr.type === "env") {
+        const key = parts[1];
+        if (!key)
+            return { value: "" };
+        const value = context.env[key];
+        return {
+            value: value ?? "",
+        };
+    }
+    // steps.X.data.path...
+    const stepId = parts[1];
+    const dataKey = parts[2];
+    const pathRest = parts.slice(3);
+    if (!stepId || !dataKey) {
+        return { value: "" };
+    }
+    const step = context.steps[stepId];
+    if (!step) {
+        return {
+            error: {
+                type: "eval_error",
+                template: `{{${expr.path}}}`,
+                path: expr.path,
+                message: `Step '${stepId}' not found`,
+            },
+        };
+    }
+    if (dataKey !== "data" && dataKey !== "status" && dataKey !== "metadata") {
+        return {
+            error: {
+                type: "eval_error",
+                template: `{{${expr.path}}}`,
+                path: expr.path,
+                message: `Invalid step accessor '${dataKey}', expected 'data', 'status', or 'metadata'`,
+            },
+        };
+    }
+    let value = step[dataKey];
+    // Walk the rest of the path
+    for (const key of pathRest) {
+        if (value === null || value === undefined) {
+            return { value: "" }; // Missing path resolves to empty string
+        }
+        if (Array.isArray(value)) {
+            const index = parseInt(key, 10);
+            if (Number.isNaN(index) || index < 0 || index >= value.length) {
+                return { value: "" };
+            }
+            value = value[index];
+        }
+        else if (typeof value === "object") {
+            value = value[key];
+        }
+        else {
+            return { value: "" };
+        }
+    }
+    // Serialize to string
+    if (value === null || value === undefined) {
+        return { value: "" };
+    }
+    if (typeof value === "string") {
+        return { value };
+    }
+    return { value: JSON.stringify(value) };
+}
+/**
+ * Convenience: compile and evaluate in one call.
+ * Prefer pre-compilation for repeated evaluations.
+ */
+export function evaluateTemplate(template, context) {
+    return compileTemplate(template).evaluate(context);
+}
+/**
+ * Validate all templates in a recipe at load time.
+ * Returns array of errors, empty if all valid.
+ */
+export function validateRecipeTemplates(templates) {
+    const errors = [];
+    for (const template of templates) {
+        const compiled = compileTemplate(template);
+        if (!compiled.hasTemplates)
+            continue; // literal — valid
+        // Probe with empty context: compile_error surfaces regardless of runtime values
+        const result = compiled.evaluate({ steps: {}, env: {} });
+        if ("error" in result && result.error.type === "compile_error") {
+            errors.push(result.error);
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=templateEngine.js.map

package/dist/recipes/templateEngine.js.map

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

package/dist/recipes/toolRegistry.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Tool Registry — central dispatch for recipe step tools.
+ *
+ * Replaces the switch statement in yamlRunner.ts with a declarative,
+ * self-describing registry that supports:
+ *   - Schema generation for editor autocomplete
+ *   - Dry-run / mock execution
+ *   - Risk tier metadata for approval gates
+ *   - Namespace isolation for connectors
+ */
+import type { RunContext, StepDeps } from "./yamlRunner.js";
+export interface ToolMetadata {
+    /** Unique tool identifier: "namespace.action" */
+    id: string;
+    /** Namespace for grouping: "file", "git", "github", "jira", etc. */
+    namespace: string;
+    /** Human-readable description for hover docs */
+    description: string;
+    /** JSON Schema for input parameters */
+    paramsSchema: unknown;
+    /** JSON Schema for output (enables template linting) */
+    outputSchema: unknown;
+    /** Default risk tier for approval gate decisions */
+    riskDefault: "low" | "medium" | "high";
+    /** Whether this tool performs a write/mutation (affects mock behavior and approval) */
+    isWrite: boolean;
+    /**
+     * Whether this tool calls an external SaaS connector (vs a local/built-in tool).
+     * Drives fixture-backed mocking for `recipe test` and `recipe record`.
+     */
+    isConnector?: boolean;
+}
+export interface ToolContext {
+    /** Rendered step parameters after template substitution */
+    params: Record<string, unknown>;
+    /** Original step for access to raw fields if needed */
+    step: Record<string, unknown>;
+    /** Execution context with prior step outputs */
+    ctx: RunContext;
+    /** Dependencies injected for I/O and connector access */
+    deps: StepDeps;
+}
+export type ToolExecute = (context: ToolContext) => Promise<string | null>;
+export interface RegisteredTool extends ToolMetadata {
+    execute: ToolExecute;
+}
+/**
+ * Register a tool. Duplicate IDs throw.
+ */
+export declare function registerTool(tool: RegisteredTool): void;
+/**
+ * Get a tool by ID. Returns undefined if not found.
+ */
+export declare function getTool(id: string): RegisteredTool | undefined;
+/**
+ * Check if a tool exists.
+ */
+export declare function hasTool(id: string): boolean;
+/**
+ * List all registered tools, optionally filtered by namespace.
+ */
+export declare function listTools(namespace?: string): RegisteredTool[];
+/**
+ * Get all namespaces that have registered tools.
+ */
+export declare function getNamespaces(): string[];
+/**
+ * Execute a tool by ID. Throws if tool not found.
+ */
+export declare function executeTool(id: string, context: ToolContext): Promise<string | null>;
+/**
+ * Clear registry — primarily for testing.
+ */
+export declare function clearRegistry(): void;
+/**
+ * Register tools from a loaded plugin into the recipe tool registry.
+ *
+ * Plugin tools use a flat `name` (e.g. "myPrefix_doThing") rather than the
+ * "namespace.action" convention used by built-in tools. We derive a namespace
+ * from the tool name prefix and wrap the plugin handler so it satisfies
+ * ToolExecute.
+ *
+ * Rules:
+ *  - If a tool with the same ID is already registered, skip it (built-ins win).
+ *  - Errors in individual tool registration are swallowed — other tools proceed.
+ */
+export declare function registerPluginTools(tools: Array<{
+    name: string;
+    handler: (...args: unknown[]) => Promise<unknown>;
+    schema: unknown;
+}>): number;
+/**
+ * Returns true if the given tool id is a registered connector-backed tool.
+ * Drives fixture-backed mocking decisions.
+ */
+export declare function isConnectorTool(toolId: string): boolean;
+/**
+ * Returns true if the given namespace has at least one registered connector tool.
+ */
+export declare function isConnectorNamespace(namespace: string): boolean;
+/**
+ * List all namespaces that contain at least one connector-backed tool.
+ */
+export declare function listConnectorNamespaces(): string[];
+export declare function listToolOutputContextKeys(toolId: string, intoKey: string): string[];
+export declare function seedToolOutputPreviewContext(toolId: string, intoKey: string, stepId: string, ctx: Record<string, string>): void;
+export declare function applyToolOutputContext(toolId: string, intoKey: string, result: string, ctx: Record<string, string>): void;
+/**
+ * Built-in parameter schemas for common patterns.
+ */
+export declare const CommonSchemas: {
+    readonly filePath: {
+        readonly type: "string";
+        readonly description: "File path (supports ~ for home directory)";
+    };
+    readonly optional: {
+        readonly type: "boolean";
+        readonly description: "If true, failure returns empty string instead of throwing";
+        readonly default: false;
+    };
+    readonly when: {
+        readonly type: "string";
+        readonly description: "Conditional expression evaluated before execution";
+    };
+    readonly max: {
+        readonly type: "number";
+        readonly description: "Maximum number of results to return";
+        readonly default: 20;
+    };
+    readonly since: {
+        readonly type: "string";
+        readonly description: "Time expression like '24h', '7d', '2026-01-01'";
+        readonly default: "24h";
+    };
+    readonly into: {
+        readonly type: "string";
+        readonly description: "Variable name to capture output into context";
+    };
+};
+/**
+ * Built-in output schemas for common patterns.
+ */
+export declare const CommonOutputSchemas: {
+    readonly fileContent: {
+        readonly type: "string";
+        readonly description: "File content as string";
+    };
+    readonly fileWriteResult: {
+        readonly type: "object";
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+            };
+            readonly bytesWritten: {
+                readonly type: "number";
+            };
+        };
+    };
+    readonly listResult: {
+        readonly type: "object";
+        readonly properties: {
+            readonly count: {
+                readonly type: "number";
+            };
+            readonly items: {
+                readonly type: "array";
+            };
+        };
+    };
+    readonly successResult: {
+        readonly type: "object";
+        readonly properties: {
+            readonly ok: {
+                readonly type: "boolean";
+            };
+            readonly error: {
+                readonly type: "string";
+            };
+        };
+    };
+};

package/dist/recipes/toolRegistry.js

@@ -0,0 +1,300 @@
+/**
+ * Tool Registry — central dispatch for recipe step tools.
+ *
+ * Replaces the switch statement in yamlRunner.ts with a declarative,
+ * self-describing registry that supports:
+ *   - Schema generation for editor autocomplete
+ *   - Dry-run / mock execution
+ *   - Risk tier metadata for approval gates
+ *   - Namespace isolation for connectors
+ */
+/** Internal registry map */
+const registry = new Map();
+/**
+ * Register a tool. Duplicate IDs throw.
+ */
+export function registerTool(tool) {
+    if (registry.has(tool.id)) {
+        throw new Error(`Tool "${tool.id}" is already registered`);
+    }
+    registry.set(tool.id, tool);
+}
+/**
+ * Get a tool by ID. Returns undefined if not found.
+ */
+export function getTool(id) {
+    return registry.get(id);
+}
+/**
+ * Check if a tool exists.
+ */
+export function hasTool(id) {
+    return registry.has(id);
+}
+/**
+ * List all registered tools, optionally filtered by namespace.
+ */
+export function listTools(namespace) {
+    const tools = Array.from(registry.values());
+    if (!namespace)
+        return tools;
+    return tools.filter((t) => t.namespace === namespace);
+}
+/**
+ * Get all namespaces that have registered tools.
+ */
+export function getNamespaces() {
+    const namespaces = new Set();
+    for (const tool of registry.values()) {
+        namespaces.add(tool.namespace);
+    }
+    return Array.from(namespaces).sort();
+}
+/**
+ * Execute a tool by ID. Throws if tool not found.
+ */
+export async function executeTool(id, context) {
+    const tool = getTool(id);
+    if (!tool) {
+        throw new Error(`Unknown tool: "${id}"`);
+    }
+    return tool.execute(context);
+}
+/**
+ * Clear registry — primarily for testing.
+ */
+export function clearRegistry() {
+    registry.clear();
+}
+/**
+ * Register tools from a loaded plugin into the recipe tool registry.
+ *
+ * Plugin tools use a flat `name` (e.g. "myPrefix_doThing") rather than the
+ * "namespace.action" convention used by built-in tools. We derive a namespace
+ * from the tool name prefix and wrap the plugin handler so it satisfies
+ * ToolExecute.
+ *
+ * Rules:
+ *  - If a tool with the same ID is already registered, skip it (built-ins win).
+ *  - Errors in individual tool registration are swallowed — other tools proceed.
+ */
+export function registerPluginTools(tools) {
+    let registered = 0;
+    for (const t of tools) {
+        if (!t.name || hasTool(t.name))
+            continue;
+        try {
+            // Derive namespace from tool name: everything before the first underscore,
+            // or the full name if there is no underscore.
+            const underscoreIdx = t.name.indexOf("_");
+            const namespace = underscoreIdx > 0 ? t.name.slice(0, underscoreIdx) : t.name;
+            const execute = async (context) => {
+                const result = await t.handler(context.params);
+                if (result === null || result === undefined)
+                    return null;
+                return typeof result === "string" ? result : JSON.stringify(result);
+            };
+            registerTool({
+                id: t.name,
+                namespace,
+                description: t.schema?.description ?? `Plugin tool: ${t.name}`,
+                paramsSchema: t.schema?.inputSchema ?? {},
+                outputSchema: {},
+                riskDefault: "low",
+                isWrite: false,
+                execute,
+            });
+            registered++;
+        }
+        catch {
+            // skip — duplicate guard in registerTool already throws, but hasTool above
+            // guards against that. Any other unexpected error is non-fatal.
+        }
+    }
+    return registered;
+}
+/**
+ * Returns true if the given tool id is a registered connector-backed tool.
+ * Drives fixture-backed mocking decisions.
+ */
+export function isConnectorTool(toolId) {
+    return getTool(toolId)?.isConnector === true;
+}
+/**
+ * Returns true if the given namespace has at least one registered connector tool.
+ */
+export function isConnectorNamespace(namespace) {
+    for (const tool of registry.values()) {
+        if (tool.namespace === namespace && tool.isConnector) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * List all namespaces that contain at least one connector-backed tool.
+ */
+export function listConnectorNamespaces() {
+    const namespaces = new Set();
+    for (const tool of registry.values()) {
+        if (tool.isConnector) {
+            namespaces.add(tool.namespace);
+        }
+    }
+    return Array.from(namespaces).sort();
+}
+function getOutputSchemaProperties(toolId) {
+    const outputSchema = getTool(toolId)?.outputSchema;
+    if (!outputSchema ||
+        typeof outputSchema !== "object" ||
+        !("properties" in outputSchema) ||
+        !outputSchema.properties ||
+        typeof outputSchema.properties !== "object") {
+        return undefined;
+    }
+    return outputSchema.properties;
+}
+function schemaHasType(schema, expected) {
+    if (!schema || typeof schema !== "object" || !("type" in schema)) {
+        return false;
+    }
+    const type = schema.type;
+    if (typeof type === "string") {
+        return type === expected;
+    }
+    return Array.isArray(type) && type.includes(expected);
+}
+function getJsonAliasPropertyName(properties) {
+    for (const [propertyName, propertySchema] of Object.entries(properties)) {
+        if (propertyName === "error") {
+            continue;
+        }
+        if (schemaHasType(propertySchema, "array") ||
+            schemaHasType(propertySchema, "object")) {
+            return propertyName;
+        }
+    }
+    return undefined;
+}
+export function listToolOutputContextKeys(toolId, intoKey) {
+    const properties = getOutputSchemaProperties(toolId);
+    if (!properties) {
+        return [];
+    }
+    const keys = [];
+    for (const [propertyName, propertySchema] of Object.entries(properties)) {
+        if (schemaHasType(propertySchema, "string") ||
+            schemaHasType(propertySchema, "number") ||
+            schemaHasType(propertySchema, "boolean")) {
+            keys.push(`${intoKey}.${propertyName}`);
+        }
+    }
+    if (getJsonAliasPropertyName(properties)) {
+        keys.push(`${intoKey}.json`);
+    }
+    return keys;
+}
+export function seedToolOutputPreviewContext(toolId, intoKey, stepId, ctx) {
+    for (const key of listToolOutputContextKeys(toolId, intoKey)) {
+        const suffix = key.slice(intoKey.length + 1);
+        ctx[key] = `[dry-run:${stepId}.${suffix}]`;
+    }
+}
+export function applyToolOutputContext(toolId, intoKey, result, ctx) {
+    const properties = getOutputSchemaProperties(toolId);
+    if (!properties) {
+        return;
+    }
+    let parsed;
+    try {
+        const parsedResult = JSON.parse(result);
+        if (!parsedResult ||
+            typeof parsedResult !== "object" ||
+            Array.isArray(parsedResult)) {
+            return;
+        }
+        parsed = parsedResult;
+    }
+    catch {
+        return;
+    }
+    for (const [propertyName, propertySchema] of Object.entries(properties)) {
+        const propertyValue = parsed[propertyName];
+        if (propertyValue !== undefined &&
+            (schemaHasType(propertySchema, "string") ||
+                schemaHasType(propertySchema, "number") ||
+                schemaHasType(propertySchema, "boolean")) &&
+            (typeof propertyValue === "string" ||
+                typeof propertyValue === "number" ||
+                typeof propertyValue === "boolean")) {
+            ctx[`${intoKey}.${propertyName}`] = String(propertyValue);
+        }
+    }
+    const jsonAliasProperty = getJsonAliasPropertyName(properties);
+    if (jsonAliasProperty && parsed[jsonAliasProperty] !== undefined) {
+        ctx[`${intoKey}.json`] = JSON.stringify(parsed[jsonAliasProperty]);
+    }
+}
+/**
+ * Built-in parameter schemas for common patterns.
+ */
+export const CommonSchemas = {
+    filePath: {
+        type: "string",
+        description: "File path (supports ~ for home directory)",
+    },
+    optional: {
+        type: "boolean",
+        description: "If true, failure returns empty string instead of throwing",
+        default: false,
+    },
+    when: {
+        type: "string",
+        description: "Conditional expression evaluated before execution",
+    },
+    max: {
+        type: "number",
+        description: "Maximum number of results to return",
+        default: 20,
+    },
+    since: {
+        type: "string",
+        description: "Time expression like '24h', '7d', '2026-01-01'",
+        default: "24h",
+    },
+    into: {
+        type: "string",
+        description: "Variable name to capture output into context",
+    },
+};
+/**
+ * Built-in output schemas for common patterns.
+ */
+export const CommonOutputSchemas = {
+    fileContent: {
+        type: "string",
+        description: "File content as string",
+    },
+    fileWriteResult: {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            bytesWritten: { type: "number" },
+        },
+    },
+    listResult: {
+        type: "object",
+        properties: {
+            count: { type: "number" },
+            items: { type: "array" },
+        },
+    },
+    successResult: {
+        type: "object",
+        properties: {
+            ok: { type: "boolean" },
+            error: { type: "string" },
+        },
+    },
+};
+//# sourceMappingURL=toolRegistry.js.map

package/dist/recipes/toolRegistry.js.map

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