patchwork-os 0.2.0-beta.10.canary.98 → 0.2.0-beta.11

package/dist/recipes/simulation/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * What-If Preview — types for the static counterfactual simulation of a recipe.
+ *
+ * P0 ("static" fidelity): the report is a pure, honest superset of the
+ * dry-run plan (`RecipeDryRunPlan`). It NEVER executes a step. Every field is
+ * derived from the static plan + tool-registry metadata, so the report cannot
+ * make a real external call, write a file, or spend a token.
+ *
+ * Design constraints baked into the shape (from the 2026-06-04 investigation,
+ * `docs/counterfactual-sim-engine-investigation.md`):
+ *   - `gatedOnRecipeSteps` is a first-class boolean so a consumer can NEVER
+ *     imply an approval gate that does not exist on the recipe execution path
+ *     today (the live gate in transport.ts only gates MCP bridge calls).
+ *   - cost carries an explicit `basis` and is never a precise dollar figure or
+ *     `$0` — at static fidelity USD is genuinely not projectable.
+ *   - conditional branches resolve to `"undetermined"`, never a faked
+ *     taken/skipped, because dry-run sentinels are truthy and would lie.
+ *
+ * Later phases bump `fidelity` ("mocked" | "hybrid") and `schemaVersion`.
+ */
+/**
+ * Stable schema version for consumers; bump on breaking shape changes.
+ *
+ * v2 (P2 mocked sandbox): adds `fidelity:"mocked"`, `SimulationStep.mockedFrom`,
+ * and the `taken`/`skipped` branch outcomes (alongside the existing
+ * `undetermined`). All additions are additive/back-compatible — a static report
+ * is still a valid v2 report.
+ */
+export declare const SIMULATION_SCHEMA_VERSION = 2;
+export type RiskTier = "low" | "medium" | "high";
+/**
+ * Side-effect class for a single step, derived from registry metadata
+ * (`isWrite` / `isConnector` / `namespace`) — never from execution.
+ */
+export type SideEffectKind = "local-read" | "local-write" | "connector-read" | "connector-write" | "external-http" | "agent-llm" | "nested-recipe" | "unknown";
+export interface SimulationStep {
+    id: string;
+    type: "tool" | "agent" | "recipe";
+    tool?: string;
+    namespace?: string;
+    /** True when the tool id resolved in the registry at plan time. */
+    resolved: boolean;
+    optional?: boolean;
+    dependencies?: string[];
+    /** Present for chained steps with a `when:` condition. */
+    condition?: string;
+    /** The step's own risk (explicit on the step, or the registry default). */
+    baseRisk: RiskTier;
+    /**
+     * Risk including blast-radius propagation: at least as high as the highest
+     * risk among the steps that must have run before this one (its transitive
+     * dependencies). Equals `baseRisk` when nothing higher-risk precedes it.
+     */
+    effectiveRisk: RiskTier;
+    sideEffect: SideEffectKind;
+    isWrite: boolean;
+    isConnector: boolean;
+    /**
+     * P2 mocked fidelity only. Present when the report is `fidelity:"mocked"`:
+     * `"history"` → this step's output was taken from a real prior run;
+     * `"synthesized"` → no history existed, so the mocked sandbox fed the step a
+     * synthesized placeholder (still executing nothing for real). Absent at
+     * static fidelity.
+     */
+    mockedFrom?: "history" | "synthesized";
+}
+/** Per-step approval projection — "what WOULD gate, if recipe steps were gated". */
+export interface ApprovalProjection {
+    stepId: string;
+    tool?: string;
+    tier: RiskTier;
+    /** True if this step's tier would trip an approval gate (tier !== "low"). */
+    wouldRequireApproval: boolean;
+    reason: string;
+}
+/** A conditional branch surfaced by the engine. */
+export interface BranchProjection {
+    stepId: string;
+    condition: string;
+    /**
+     * At static fidelity always `"undetermined"` — sentinels would lie.
+     * At mocked fidelity (P2): `"taken"` / `"skipped"` when every step id the
+     * `when:` references has a real historical value (so the condition resolves
+     * realistically), else `"undetermined"`.
+     */
+    outcome: "taken" | "skipped" | "undetermined";
+    reason: string;
+}
+export interface RiskComponents {
+    highSteps: number;
+    mediumSteps: number;
+    writeSteps: number;
+    connectorWriteSteps: number;
+    externalHttpSteps: number;
+    unresolvedSteps: number;
+}
+export interface RunRiskSummary {
+    /** 0–100 derived workflow risk score. Always shown WITH its components. */
+    score: number;
+    tier: RiskTier;
+    components: RiskComponents;
+    /** Highest single-step effective risk in the plan. */
+    highestStepRisk: RiskTier;
+}
+export interface SimulationCost {
+    /**
+     * "history": median of the P1 per-step token corpus (P3).
+     * "heuristic": a coarse chars/4 token estimate (no run history yet).
+     * "unavailable": no agent steps / nothing to estimate.
+     */
+    basis: "history" | "heuristic" | "unavailable";
+    /**
+     * Loud confidence signal (P3). "high" only when every agent step has enough
+     * historical samples; "low" when some fall back to chars/4; "none" otherwise.
+     */
+    confidence?: "high" | "low" | "none";
+    /** Prior runs that contributed at least one sample (history basis). */
+    sampleRuns?: number;
+    agentSteps: number;
+    /** Agent steps with any estimate (history or prompt-heuristic). */
+    estimatedAgentSteps: number;
+    /**
+     * Back-compat input-token proxy: chars/4 sum at static fidelity, or the
+     * median-summed input tokens once a history projection exists.
+     */
+    estPromptTokens: number | null;
+    /** P3 — projected total input tokens (median-summed). */
+    estInputTokens?: number | null;
+    /** P3 — projected total output tokens (median-summed). */
+    estOutputTokens?: number | null;
+    /**
+     * Expected USD — sum of per-step median historical costUsd. null when there
+     * is no billable history (e.g. subscription/subprocess drivers); NEVER a $0
+     * placeholder. (Was always null pre-P3.)
+     */
+    usd: number | null;
+    /** P3 — USD range across history (sum of per-step min/max). null when none. */
+    minUsd?: number | null;
+    maxUsd?: number | null;
+    /** P3 — agent steps whose projection used real history (vs chars/4). */
+    historyAgentSteps?: number;
+    note: string;
+}
+export interface SimulationSummary {
+    totalSteps: number;
+    writeSteps: number;
+    connectorSteps: number;
+    agentSteps: number;
+    unresolvedSteps: number;
+    sideEffectCounts: Record<SideEffectKind, number>;
+    connectorNamespaces: string[];
+}
+export interface RecipeSimulationReport {
+    schemaVersion: typeof SIMULATION_SCHEMA_VERSION;
+    kind: "what-if-preview";
+    recipe: string;
+    triggerType: string;
+    /** ISO-8601 generation timestamp. */
+    generatedAt: string;
+    /**
+     * Simulation fidelity. `"static"` (P0): pure transform of the dry-run plan,
+     * nothing executed. `"mocked"` (P2): a chained recipe WITH run history driven
+     * through the real chained runner with history-backed `mockedOutputs` +
+     * fully-stubbed deps — still zero real I/O, but downstream templates and
+     * `when:` branches resolve realistically.
+     */
+    fidelity: "static" | "mocked";
+    /**
+     * P2 mocked fidelity only — number of prior runs sampled to synthesize the
+     * mocked outputs. Absent at static fidelity.
+     */
+    sampleRuns?: number;
+    /** "chained" recipes have a real DAG; "flat" recipes are a linear list. */
+    topology: "chained" | "flat";
+    /**
+     * CRITICAL honesty field. False today: the approval queue does NOT gate
+     * recipe-runner steps. Consumers MUST surface this so the approval
+     * projection is never read as live gate behaviour.
+     */
+    gatedOnRecipeSteps: boolean;
+    steps: SimulationStep[];
+    summary: SimulationSummary;
+    risk: RunRiskSummary;
+    approvals: {
+        gatedOnRecipeSteps: boolean;
+        projected: ApprovalProjection[];
+        note: string;
+    };
+    cost: SimulationCost;
+    /** Conditional branches surfaced but not resolved (honest "rejected paths"). */
+    branches: BranchProjection[];
+    lint: {
+        errors: string[];
+        warnings: string[];
+    };
+    /** Loud, human-readable caveats about what this fidelity can and cannot show. */
+    notes: string[];
+}

package/dist/recipes/simulation/types.js

@@ -0,0 +1,30 @@
+/**
+ * What-If Preview — types for the static counterfactual simulation of a recipe.
+ *
+ * P0 ("static" fidelity): the report is a pure, honest superset of the
+ * dry-run plan (`RecipeDryRunPlan`). It NEVER executes a step. Every field is
+ * derived from the static plan + tool-registry metadata, so the report cannot
+ * make a real external call, write a file, or spend a token.
+ *
+ * Design constraints baked into the shape (from the 2026-06-04 investigation,
+ * `docs/counterfactual-sim-engine-investigation.md`):
+ *   - `gatedOnRecipeSteps` is a first-class boolean so a consumer can NEVER
+ *     imply an approval gate that does not exist on the recipe execution path
+ *     today (the live gate in transport.ts only gates MCP bridge calls).
+ *   - cost carries an explicit `basis` and is never a precise dollar figure or
+ *     `$0` — at static fidelity USD is genuinely not projectable.
+ *   - conditional branches resolve to `"undetermined"`, never a faked
+ *     taken/skipped, because dry-run sentinels are truthy and would lie.
+ *
+ * Later phases bump `fidelity` ("mocked" | "hybrid") and `schemaVersion`.
+ */
+/**
+ * Stable schema version for consumers; bump on breaking shape changes.
+ *
+ * v2 (P2 mocked sandbox): adds `fidelity:"mocked"`, `SimulationStep.mockedFrom`,
+ * and the `taken`/`skipped` branch outcomes (alongside the existing
+ * `undetermined`). All additions are additive/back-compatible — a static report
+ * is still a valid v2 report.
+ */
+export const SIMULATION_SCHEMA_VERSION = 2;
+//# sourceMappingURL=types.js.map

package/dist/recipes/simulation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/recipes/simulation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC"}

package/dist/recipes/stepObservation.d.ts

@@ -32,6 +32,18 @@ export interface SilentFailMatch {
  * the runner doesn't already catch.
  */
 export declare function detectSilentFail(result: unknown): SilentFailMatch | null;
+export declare const REDACTED = "[REDACTED]";
+/**
+ * Build a context copy in which the values of `secretKeys` (keys populated
+ * from a recipe-level `type: env` block) are replaced with the REDACTED
+ * marker. Used to render the LLM-facing agent prompt so an env-sourced
+ * secret never reaches the model verbatim. Tool-step param interpolation
+ * uses the ORIGINAL context — tools legitimately need the real value.
+ *
+ * Returns the input unchanged (same reference) when there are no secret
+ * keys, so the common no-secrets recipe path allocates nothing.
+ */
+export declare function redactSecretsForPrompt<T extends Record<string, string>>(ctx: T, secretKeys: ReadonlySet<string>): T;
 /**
  * Capture a value for inclusion in `RunStepResult`. Returns undefined if
  * the value is `undefined` (don't bloat the log row for steps that

package/dist/recipes/stepObservation.js

@@ -152,8 +152,28 @@ const SENSITIVE_KEY_PATTERNS = [
     "access-token",
     "access_token",
 ];
-const REDACTED = "[REDACTED]";
+export const REDACTED = "[REDACTED]";
 const TRUNCATED = "[truncated]";
+/**
+ * Build a context copy in which the values of `secretKeys` (keys populated
+ * from a recipe-level `type: env` block) are replaced with the REDACTED
+ * marker. Used to render the LLM-facing agent prompt so an env-sourced
+ * secret never reaches the model verbatim. Tool-step param interpolation
+ * uses the ORIGINAL context — tools legitimately need the real value.
+ *
+ * Returns the input unchanged (same reference) when there are no secret
+ * keys, so the common no-secrets recipe path allocates nothing.
+ */
+export function redactSecretsForPrompt(ctx, secretKeys) {
+    if (secretKeys.size === 0)
+        return ctx;
+    const out = { ...ctx };
+    for (const key of secretKeys) {
+        if (Object.hasOwn(out, key))
+            out[key] = REDACTED;
+    }
+    return out;
+}
 function isSensitiveKey(key) {
     const lower = key.toLowerCase();
     for (const pattern of SENSITIVE_KEY_PATTERNS) {

package/dist/recipes/stepObservation.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * Airtable tools — record access via the Airtable REST API v0.
+ *
+ * Self-registering tool module for the recipe tool registry. Read tools
+ * (list_records, get_record, list_bases) declare `isWrite: false`; the write
+ * tool (create_record) declares `isWrite: true` so the approval queue and
+ * kill-switch gate it appropriately.
+ *
+ * Mirrors the `AirtableConnector` method signatures exactly:
+ *   - listRecords(baseId, tableIdOrName, params?)
+ *   - getRecord(baseId, tableIdOrName, recordId)
+ *   - createRecord(baseId, tableIdOrName, fields)
+ *   - listBases()
+ */
+export {};

package/dist/recipes/tools/airtable.js

@@ -0,0 +1,240 @@
+/**
+ * Airtable tools — record access via the Airtable REST API v0.
+ *
+ * Self-registering tool module for the recipe tool registry. Read tools
+ * (list_records, get_record, list_bases) declare `isWrite: false`; the write
+ * tool (create_record) declares `isWrite: true` so the approval queue and
+ * kill-switch gate it appropriately.
+ *
+ * Mirrors the `AirtableConnector` method signatures exactly:
+ *   - listRecords(baseId, tableIdOrName, params?)
+ *   - getRecord(baseId, tableIdOrName, recordId)
+ *   - createRecord(baseId, tableIdOrName, fields)
+ *   - listBases()
+ */
+import { CommonSchemas, registerTool } from "../toolRegistry.js";
+import { wrapConnectorExecute } from "./wrapConnectorExecute.js";
+// ============================================================================
+// airtable.list_records
+// ============================================================================
+registerTool({
+    id: "airtable.list_records",
+    namespace: "airtable",
+    description: "List records from an Airtable table, with optional filter formula, view, sort, field selection, and paging.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            baseId: {
+                type: "string",
+                description: "Airtable base id (app...)",
+            },
+            tableIdOrName: {
+                type: "string",
+                description: "Airtable table id (tbl...) or table name",
+            },
+            filterByFormula: {
+                type: "string",
+                description: "Airtable formula to filter records server-side",
+            },
+            view: {
+                type: "string",
+                description: "Restrict results to a named view",
+            },
+            maxRecords: {
+                type: "number",
+                description: "Max records to return (default 100, hard cap 1000)",
+            },
+            pageSize: {
+                type: "number",
+                description: "Records per page (max 100)",
+            },
+            fields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Restrict returned fields to this list",
+            },
+            sort: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        field: { type: "string" },
+                        direction: { type: "string", enum: ["asc", "desc"] },
+                    },
+                    required: ["field"],
+                },
+                description: "Sort directives, applied in order",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["baseId", "tableIdOrName"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            records: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        createdTime: { type: "string" },
+                        fields: { type: "object" },
+                    },
+                },
+            },
+            offset: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getAirtableConnector } = await import("../../connectors/airtable.js");
+        const connector = getAirtableConnector();
+        const result = await connector.listRecords(params.baseId, params.tableIdOrName, {
+            filterByFormula: typeof params.filterByFormula === "string"
+                ? params.filterByFormula
+                : undefined,
+            view: typeof params.view === "string" ? params.view : undefined,
+            maxRecords: typeof params.maxRecords === "number" ? params.maxRecords : undefined,
+            pageSize: typeof params.pageSize === "number" ? params.pageSize : undefined,
+            fields: Array.isArray(params.fields)
+                ? params.fields
+                : undefined,
+            sort: Array.isArray(params.sort)
+                ? params.sort
+                : undefined,
+        });
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// airtable.get_record
+// ============================================================================
+registerTool({
+    id: "airtable.get_record",
+    namespace: "airtable",
+    description: "Fetch a single Airtable record by id.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            baseId: {
+                type: "string",
+                description: "Airtable base id (app...)",
+            },
+            tableIdOrName: {
+                type: "string",
+                description: "Airtable table id (tbl...) or table name",
+            },
+            recordId: {
+                type: "string",
+                description: "Airtable record id (rec...)",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["baseId", "tableIdOrName", "recordId"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            createdTime: { type: "string" },
+            fields: { type: "object" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getAirtableConnector } = await import("../../connectors/airtable.js");
+        const connector = getAirtableConnector();
+        const result = await connector.getRecord(params.baseId, params.tableIdOrName, params.recordId);
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// airtable.create_record  (write-gated)
+// ============================================================================
+registerTool({
+    id: "airtable.create_record",
+    namespace: "airtable",
+    description: "Create a single record in an Airtable table.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            baseId: {
+                type: "string",
+                description: "Airtable base id (app...)",
+            },
+            tableIdOrName: {
+                type: "string",
+                description: "Airtable table id (tbl...) or table name",
+            },
+            fields: {
+                type: "object",
+                description: "Field values for the new record, keyed by Airtable field name or id",
+            },
+            into: CommonSchemas.into,
+        },
+        required: ["baseId", "tableIdOrName", "fields"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            createdTime: { type: "string" },
+            fields: { type: "object" },
+        },
+    },
+    riskDefault: "medium",
+    isWrite: true,
+    isConnector: true,
+    execute: wrapConnectorExecute(async ({ params }) => {
+        const { getAirtableConnector } = await import("../../connectors/airtable.js");
+        const connector = getAirtableConnector();
+        const result = await connector.createRecord(params.baseId, params.tableIdOrName, params.fields ?? {});
+        return JSON.stringify(result);
+    }),
+});
+// ============================================================================
+// airtable.list_bases
+// ============================================================================
+registerTool({
+    id: "airtable.list_bases",
+    namespace: "airtable",
+    description: "List Airtable bases the authenticated token can access.",
+    paramsSchema: {
+        type: "object",
+        properties: {
+            into: CommonSchemas.into,
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            bases: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        name: { type: "string" },
+                        permissionLevel: { type: "string" },
+                    },
+                },
+            },
+            offset: { type: "string" },
+        },
+    },
+    riskDefault: "low",
+    isWrite: false,
+    isConnector: true,
+    execute: wrapConnectorExecute(async () => {
+        const { getAirtableConnector } = await import("../../connectors/airtable.js");
+        const connector = getAirtableConnector();
+        const result = await connector.listBases();
+        return JSON.stringify(result);
+    }),
+});
+//# sourceMappingURL=airtable.js.map

package/dist/recipes/tools/airtable.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Cal.diy tools — scheduling via the Cal.com-compatible API.
+ *
+ * Self-registering tool module for the recipe tool registry. Read tools wrap
+ * event types and bookings; the single write tool cancels a booking.
+ *
+ * Wraps the Cal.diy connector (src/connectors/caldiy.ts):
+ *   - getEventTypes()                       → list_event_types (read)
+ *   - getBookings({status, attendeeEmail,…}) → list_bookings    (read)
+ *   - getBooking(uid)                        → get_booking      (read)
+ *   - cancelBooking(uid, reason?)            → cancel_booking   (write)
+ */
+export {};