patchwork-os 0.2.0-alpha.9 → 0.2.0-beta.0

package/dist/recipes/toolRegistry.d.ts

@@ -0,0 +1,186 @@
+/**
+ * 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.
+ *
+ * Refuses to execute write-tier tools when the global write kill switch is
+ * active (`kill-switch.writes` flag — set via `PATCHWORK_FLAG_KILL_SWITCH_WRITES=1`
+ * env var or persisted flag). Read-tier tools are always allowed; the kill
+ * switch is a one-way emergency brake on mutating operations.
+ */
+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,309 @@
+/**
+ * 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 { assertWriteAllowed } from "../featureFlags.js";
+/** 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.
+ *
+ * Refuses to execute write-tier tools when the global write kill switch is
+ * active (`kill-switch.writes` flag — set via `PATCHWORK_FLAG_KILL_SWITCH_WRITES=1`
+ * env var or persisted flag). Read-tier tools are always allowed; the kill
+ * switch is a one-way emergency brake on mutating operations.
+ */
+export async function executeTool(id, context) {
+    const tool = getTool(id);
+    if (!tool) {
+        throw new Error(`Unknown tool: "${id}"`);
+    }
+    if (tool.isWrite) {
+        assertWriteAllowed(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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"}

package/dist/recipes/tools/asana.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Asana tools — read wrappers (workspaces, projects, tasks, user) plus writes
+ * (create_task, update_task, complete_task, add_task_comment).
+ *
+ * Self-registering tool module for the recipe tool registry. Read tools wrap
+ * connector throws into the `{count, items, error}` shape that the runner's
+ * silent-fail detector (PR #75) catches as a step error rather than a silent
+ * empty list. Write tools use a single-object response shape (no count/items)
+ * but still surface failures via an `error` field.
+ *
+ * Note: Asana's only OAuth scope (`default`) grants read+write combined —
+ * there is no read-only-only scope. Defense lives here at the recipe-tool
+ * layer: read tools declare `isWrite: false`, write tools declare
+ * `isWrite: true` so the approval queue gates them appropriately.
+ */
+export {};