patchwork-os 0.2.0-alpha.2 → 0.2.0-alpha.22

package/dist/recipes/yamlRunner.d.ts

@@ -20,6 +20,7 @@
  *   manual, cron — both run immediately via CLI
  *   git_hook, on_file_save — also runnable manually; trigger context injected
  */
+import "./tools/index.js";
 export interface YamlStep {
     tool?: string;
     agent?: {
@@ -30,6 +31,7 @@ export interface YamlStep {
     };
     into?: string;
     optional?: boolean;
+    transform?: string;
     [key: string]: unknown;
 }
 export interface YamlTrigger {
@@ -39,14 +41,30 @@ 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[];
 }
 export type RunContext = Record<string, string>;
 export type FetchFn = (url: string, init?: {
@@ -55,6 +73,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 +92,80 @@ 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 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;