@introspection-ai/recipes 0.13.0 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@introspection-ai/recipes",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "The open package format for complete, portable Pi agents.",
   "license": "Apache-2.0",
   "type": "module",
@@ -10,18 +10,19 @@
   "files": [
     "dist",
     "vendor/mcp-client",
+    "vendor/recipe-check",
     "docs",
     "README.md",
     "package.json"
   ],
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/introspection-org/pi-recipes.git"
+    "url": "git+ssh://git@github.com/introspection-org/recipes.git"
   },
   "bugs": {
-    "url": "https://github.com/introspection-org/pi-recipes/issues"
+    "url": "https://github.com/introspection-org/recipes/issues"
   },
-  "homepage": "https://github.com/introspection-org/pi-recipes#readme",
+  "homepage": "https://github.com/introspection-org/recipes#readme",
   "publishConfig": {
     "access": "public",
     "tag": "latest"
@@ -35,25 +36,29 @@
       "types": "./dist/interactions.d.ts",
       "import": "./dist/interactions.js"
     },
+    "./extensions": {
+      "types": "./dist/api/extensions.d.ts",
+      "import": "./dist/api/extensions.js"
+    },
+    "./mcp": {
+      "types": "./dist/api/mcp.d.ts",
+      "import": "./dist/api/mcp.js"
+    },
     "./pi-extension": {
       "types": "./dist/pi-extension.d.ts",
       "import": "./dist/pi-extension.js"
     },
-    "./pi": {
-      "types": "./dist/agent-tool.d.ts",
-      "import": "./dist/agent-tool.js"
+    "./agents": {
+      "types": "./dist/agents.d.ts",
+      "import": "./dist/agents.js"
     },
     "./recipe": {
       "types": "./dist/recipe/resolve.d.ts",
       "import": "./dist/recipe/resolve.js"
     },
     "./session": {
-      "types": "./dist/session.d.ts",
-      "import": "./dist/session.js"
-    },
-    "./run": {
-      "types": "./dist/run.d.ts",
-      "import": "./dist/run.js"
+      "types": "./dist/api/session.d.ts",
+      "import": "./dist/api/session.js"
     },
     "./test-utils": {
       "types": "./dist/test-utils.d.ts",
@@ -72,6 +77,7 @@
   "dependencies": {
     "@introspection-sdk/introspection-pi": "^0.13.0",
     "@opentelemetry/api": "^1.9.1",
+    "ajv": "^8.20.0",
     "mcporter": "0.12.3",
     "yaml": "^2.9.0"
   },
@@ -96,11 +102,11 @@
   "scripts": {
     "build": "pnpm build:ts && pnpm build:native",
     "build:ts": "rm -rf dist && tsc && node scripts/build-mcp-daemon.mjs",
-    "build:native": "cargo build --release -p pi-mcp-client && node scripts/package-mcp-client.mjs",
+    "build:native": "cargo build --release -p pi-mcp-client && cargo build --release -p recipe-check --bin recipe-check && node scripts/package-mcp-client.mjs && node scripts/package-recipe-check.mjs",
     "bench:mcp-client": "pnpm build:ts && cargo build --release -p pi-mcp-client && node scripts/benchmark-mcp-client.mjs",
-    "typecheck": "node scripts/check-recipe-check-versions.mjs && tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
-    "test": "pnpm build:ts && cargo test -p pi-mcp-client -p pi-recipe-check && cargo build -p pi-mcp-client && MCP_CLIENT_BIN=target/debug/mcp-client node scripts/package-mcp-client.mjs && vitest run",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "test": "pnpm build:ts && cargo test -p pi-mcp-client -p recipe-check && cargo build -p pi-mcp-client && cargo build -p recipe-check --bin recipe-check && MCP_CLIENT_BIN=target/debug/mcp-client node scripts/package-mcp-client.mjs && vitest run",
     "pack:check": "pnpm pack --dry-run --json | node scripts/check-npm-pack.mjs",
-    "clean": "rm -rf dist .turbo node_modules target vendor/mcp-client"
+    "clean": "rm -rf dist .turbo node_modules target vendor/mcp-client vendor/recipe-check"
   }
 }

package/dist/agent-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-tool.d.ts","sourceRoot":"","sources":["../src/agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGlF,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,IAAI,eAAe,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,KAAK,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/D,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/D,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7C;AAyED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,GAAE;IAAE,sBAAsB,CAAC,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CAAO,GACnE,cAAc,CAuGhB"}

package/dist/agent-tool.js.map

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

package/dist/run.d.ts

@@ -1,28 +0,0 @@
-import type { AgentMessage } from "@earendil-works/pi-agent-core";
-import { type CreateRecipeSessionOptions } from "./session.js";
-/**
- * One turn, no server: create session → single prompt → await settle →
- * dispose, always. The programmatic analog of `pi --mode json -p`.
- *
- * Agent-level failure never throws — it lands in `status: "failed"`. Only
- * caller mistakes (bad options, unreadable recipe, missing credentials)
- * throw, from session construction.
- */
-export interface RunRecipeOptions extends CreateRecipeSessionOptions {
-    prompt: string;
-    timeoutMs?: number;
-    signal?: AbortSignal;
-    /** Session factory; defaults to `createRecipeSession`. Test/DI seam. */
-    sessionFactory?: (options: CreateRecipeSessionOptions) => Promise<import("./session.js").RecipeSessionHandle>;
-}
-export interface RecipeRunResult {
-    status: "finished" | "failed" | "cancelled";
-    /** Final assistant message text ("" if none). */
-    text: string;
-    /** Full transcript, Pi's message shape. */
-    messages: AgentMessage[];
-    /** Present iff status === "failed". */
-    error?: string;
-}
-export declare function runRecipe(options: RunRecipeOptions): Promise<RecipeRunResult>;
-//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,cAAc,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAiB,SAAQ,0BAA0B;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wEAAwE;IACxE,cAAc,CAAC,EAAE,CACf,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,OAAO,cAAc,EAAE,mBAAmB,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAmE1B"}

package/dist/run.js

@@ -1,84 +0,0 @@
-import { promptResultText } from "./child-agent.js";
-import { createRecipeSession, } from "./session.js";
-function lastAssistantStop(messages) {
-    for (let index = messages.length - 1; index >= 0; index -= 1) {
-        const message = messages[index];
-        if (message?.role !== "assistant")
-            continue;
-        return {
-            ...(typeof message.stopReason === "string"
-                ? { stopReason: message.stopReason }
-                : {}),
-            ...(typeof message.errorMessage === "string"
-                ? { errorMessage: message.errorMessage }
-                : {}),
-        };
-    }
-    return {};
-}
-export async function runRecipe(options) {
-    const { prompt, timeoutMs, signal, sessionFactory, ...sessionOptions } = options;
-    if (typeof prompt !== "string" || !prompt.trim()) {
-        throw new TypeError("runRecipe requires a non-empty prompt");
-    }
-    if (signal?.aborted) {
-        return { status: "cancelled", text: "", messages: [] };
-    }
-    const handle = await (sessionFactory ?? createRecipeSession)(sessionOptions);
-    let timedOut = false;
-    let aborted = false;
-    let timer;
-    const onAbort = () => {
-        aborted = true;
-        void handle.session.abort().catch(() => { });
-    };
-    try {
-        if (timeoutMs !== undefined) {
-            timer = setTimeout(() => {
-                timedOut = true;
-                void handle.session.abort().catch(() => { });
-            }, timeoutMs);
-        }
-        signal?.addEventListener("abort", onAbort, { once: true });
-        // The signal may have fired while the asynchronous session factory was
-        // resolving, before the listener existed.
-        if (signal?.aborted) {
-            aborted = true;
-            await handle.session.abort().catch(() => { });
-            return {
-                status: "cancelled",
-                text: "",
-                messages: [...handle.session.messages],
-            };
-        }
-        let promptError;
-        try {
-            await handle.session.prompt(prompt);
-        }
-        catch (err) {
-            promptError = err instanceof Error ? err.message : String(err);
-        }
-        const messages = [...handle.session.messages];
-        const text = promptResultText({ messages });
-        const { stopReason, errorMessage } = lastAssistantStop(messages);
-        if (timedOut || aborted || stopReason === "aborted") {
-            return { status: "cancelled", text, messages };
-        }
-        if (promptError !== undefined || stopReason === "error") {
-            return {
-                status: "failed",
-                text,
-                messages,
-                error: promptError ?? errorMessage ?? "agent error",
-            };
-        }
-        return { status: "finished", text, messages };
-    }
-    finally {
-        if (timer !== undefined)
-            clearTimeout(timer);
-        signal?.removeEventListener("abort", onAbort);
-        await handle.dispose();
-    }
-}
-//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/testing.d.ts

@@ -1,25 +0,0 @@
-import type { ExtensionEvent, ExtensionAPI, RegisteredCommand, ToolDefinition } from "@earendil-works/pi-coding-agent";
-export interface MockExtensionAPI extends ExtensionAPI {
-    commands: Map<string, Omit<RegisteredCommand, "name" | "sourceInfo">>;
-    tools: Map<string, ToolDefinition<any, any, any>>;
-    flags: Map<string, {
-        description?: string;
-        type: "boolean" | "string";
-        default?: boolean | string;
-    }>;
-    flagValues: Map<string, boolean | string>;
-    handlers: Map<string, Array<(event: any, ctx: any) => unknown>>;
-    messages: unknown[];
-    sentMessages: Array<{
-        message: any;
-        options?: any;
-    }>;
-    messageRenderers: Map<string, (message: any, options: any, theme: any) => unknown>;
-    sessionName?: string;
-    activeTools: string[];
-    thinkingLevel?: string;
-    model?: unknown;
-    emitExtensionEvent(event: ExtensionEvent, ctx: any): Promise<unknown[]>;
-}
-export declare function createMockExtensionAPI(): MockExtensionAPI;
-//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACf,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IACtE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACrG,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC;IAChE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,YAAY,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACrD,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACzE;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CA8FzD"}

package/dist/testing.js

@@ -1,96 +0,0 @@
-export function createMockExtensionAPI() {
-    const commands = new Map();
-    const tools = new Map();
-    const flags = new Map();
-    const flagValues = new Map();
-    const handlers = new Map();
-    const messages = [];
-    const sentMessages = [];
-    const messageRenderers = new Map();
-    const api = {
-        commands,
-        tools,
-        flags,
-        flagValues,
-        handlers,
-        messages,
-        sentMessages,
-        messageRenderers,
-        activeTools: [],
-        on(event, handler) {
-            const list = handlers.get(event) ?? [];
-            list.push(handler);
-            handlers.set(event, list);
-        },
-        registerTool(tool) {
-            tools.set(tool.name, tool);
-        },
-        registerCommand(name, options) {
-            commands.set(name, options);
-        },
-        registerShortcut() { },
-        registerFlag(name, options) {
-            flags.set(name, options);
-            if (options.default !== undefined && !flagValues.has(name)) {
-                flagValues.set(name, options.default);
-            }
-        },
-        getFlag(name) {
-            return flagValues.get(name);
-        },
-        registerMessageRenderer(customType, renderer) {
-            messageRenderers.set(customType, renderer);
-        },
-        sendMessage(message, options) {
-            messages.push(message);
-            sentMessages.push({ message, options });
-        },
-        sendUserMessage() { },
-        setSessionName(name) {
-            api.sessionName = name;
-        },
-        getSessionName() {
-            return api.sessionName;
-        },
-        setActiveTools(toolNames) {
-            api.activeTools = toolNames;
-        },
-        getActiveTools() {
-            return api.activeTools;
-        },
-        getAllTools() {
-            return [...tools.values()].map((tool) => ({
-                name: tool.name,
-                description: tool.description,
-                parameters: tool.parameters,
-                sourceInfo: { path: "<test>", source: "test", scope: "temporary", origin: "top-level" },
-            }));
-        },
-        setThinkingLevel(level) {
-            api.thinkingLevel = level;
-        },
-        getThinkingLevel() {
-            return api.thinkingLevel ?? "off";
-        },
-        async setModel(model) {
-            api.model = model;
-            return true;
-        },
-        async emitExtensionEvent(event, ctx) {
-            const results = [];
-            for (const handler of handlers.get(event.type) ?? []) {
-                results.push(await handler(event, ctx));
-            }
-            return results;
-        },
-        events: {
-            emit() { },
-            on() {
-                return () => { };
-            },
-            off() { },
-        },
-    };
-    return api;
-}
-//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/docs/deployment-configuration.md

@@ -1,65 +0,0 @@
-# Deployment configuration
-
-How a recipe declares what its tasks need from the platform that runs them —
-compute resources and scratch disk — and what an implementing platform does
-with those declarations.
-
-This spec is defined here, in Recipes, because it describes *Recipe
-intent*: portable, platform-neutral declarations that any host can honor.
-The validation grammar lives in `pi_recipe_check::resources`
-(`validate_resources`) so every host — the Introspection CLI, a
-platform's manifest validator, wasm/Python bindings — applies identical
-rules with stable diagnostic codes. Platform-specific enforcement (floors,
-caps, billing) is the implementer's job, not part of the grammar.
-
-## Where the declarations live
-
-Recipe *package* contents (`package.json#pi`, `agents/*.yaml`) are
-materialized inside a running sandbox, after the machine that runs them
-already exists — so deployment configuration cannot live there. It lives in
-the host's deployment manifest, the file the platform reads *before*
-provisioning. On Introspection that is the repo-root
-`.introspection/<slug>.yaml` manifest's `runtime:` block:
-
-```yaml
-runtime:
-  resources:
-    requests: { cpu: 500m, memory: 1.5Gi, storage: 10Gi }
-    limits: { cpu: 1500m, memory: 1.5Gi }
-```
-
-## `resources`
-
-Kubernetes-style `requests`/`limits` (`validate_resources`). Grammar:
-`500m` millicores or decimal cores for CPU; bytes with binary
-(`Ki`/`Mi`/`Gi`/`Ti`) or decimal (`k`/`M`/`G`/`T`) suffixes for memory and
-storage (`0.1T` works). Quantities may also be JSON numbers — `cpu: 1.5`
-(cores) or an integer byte count for memory. A request must not exceed its limit.
-
-`storage` is the sandbox scratch-volume size and follows the PVC
-convention (`spec.resources.requests.storage`): request-only — declaring
-it under `limits` is rejected. Whether the scratch volume is persistent
-(survives sandbox teardown for warm restore) or ephemeral stays a
-*deployment* setting on the implementing platform — the recipe only sizes
-it. Future io characteristics (e.g. a storage class) would be siblings in
-the manifest, mirroring how Kubernetes expresses them outside the
-quantity.
-
-## How Introspection implements this
-
-The reference implementation treats every declaration as an **upward
-request** merged onto deployment-configured floors:
-
-- cpu/memory requests: `max(recipe, deployment floor)`, capped by a
-  schedulability guard; limits raise to the resolved request.
-- `requests.storage`: taken as declared — rounded up to whole GiB
-  (smaller scratch bills less; 1Gi is the validated minimum) and capped
-  at 300 GiB; undeclared uses the deployment default (10 GiB). Applied to
-  the sandbox's scratch volume (a persistent PVC when the deployment
-  enables warm storage, ephemeral emptyDir at the same mount path
-  otherwise).
-
-Invalid declarations fail manifest validation at push — a recipe never
-silently spawns with defaults because of a typo. Other platforms may
-choose different enforcement; the declarations and their grammar are the
-portable part.

package/docs/migration.md

@@ -1,70 +0,0 @@
-# Migration to Recipes
-
-The project and npm package are now **Recipes**:
-
-```text
-@introspection-ai/pi-recipes  →  @introspection-ai/recipes
-Pi Recipes                    →  Recipes
-```
-
-The artifact remains **a Recipe**. The package format and focused runtime
-entrypoints remain source-compatible unless noted below.
-
-## Package imports
-
-```diff
-- import { resolveRecipe } from "@introspection-ai/pi-recipes/recipe";
-+ import { resolveRecipe } from "@introspection-ai/recipes/recipe";
-
-- import { createRecipeSession } from "@introspection-ai/pi-recipes/session";
-+ import { createRecipeSession } from "@introspection-ai/recipes/session";
-```
-
-The same replacement applies to `/run`, `/pi`, `/interactions`, and
-`/test-utils`. The former `/tracing` entrypoint is removed: pass a host-owned
-tracer through `createRecipeSession({ otel })` instead.
-
-## Pi extension
-
-```bash
-pi remove npm:@introspection-ai/pi-recipes
-pi install npm:@introspection-ai/recipes
-```
-
-The Recipe extension factory is now `createRecipesExtension`.
-`createPiRecipesExtension` remains as a deprecated source-compatible alias.
-
-Recipe-owned extensions that still import
-`@introspection-ai/pi-recipes/interactions` are aliased to the current runtime
-while they migrate.
-
-## CLI
-
-The standalone `recipes` executable has been retired. Use:
-
-```bash
-introspection init
-introspection check
-introspection local
-introspection dev
-```
-
-Use ordinary Git and filesystem operations to clone, fork, copy, and publish
-Recipe source.
-
-## Hosting
-
-`serveRecipe` and `@introspection-ai/recipes/serve` are not part of the new
-package. Hosts integrate at `createRecipeSession`; HTTP protocols, persistence,
-auth, and deployment adapters belong to the host.
-
-`runRecipe` remains as the small one-turn convenience above the session API.
-
-## Validation
-
-The root npm package no longer downloads a platform-specific
-`recipe-check` executable. Validation remains available through:
-
-- `introspection check`;
-- the `pi-recipe-check` Rust crate and binary;
-- the `pi-recipe-check` Python package.

package/docs/python-bindings-release.md

@@ -1,47 +0,0 @@
-# Python bindings release
-
-The `pi-recipe-check` Rust crate and Python distribution are two artifacts of
-one validator product and always use the same version. The binding's Cargo
-package and dependency on the core must both match the core crate version.
-`scripts/check-recipe-check-versions.mjs` enforces this invariant in CI.
-
-Release Please owns both versions, changelogs, component tags, and GitHub
-releases. Its `linked-versions` plugin advances both components to the same
-version whenever either has a releasable change. The `cargo-workspace` plugin
-keeps the local dependency current, but leaves candidate merging to
-`linked-versions`. A Python-only fix therefore creates a patch release for
-both artifacts, and a core release always includes a matching Python release.
-Routine releases must not bump either Cargo version manually.
-
-When Release Please creates a Python binding release, the release workflow:
-
-1. Builds `abi3` wheels compatible with CPython 3.10 and newer for Linux
-   x86-64 and ARM64, macOS Apple Silicon and Intel, and Windows x86-64.
-2. Builds a source distribution containing the local Rust workspace
-   dependency.
-3. Waits for the matching `pi-recipe-check` crate publication to succeed.
-4. Publishes all Python artifacts to PyPI through trusted publishing.
-
-## One-time PyPI setup
-
-Before the first release, create a pending trusted publisher for the unclaimed
-`pi-recipe-check` project on PyPI with:
-
-- Owner: `introspection-org`
-- Repository: `pi-recipes`
-- Workflow: `release-please.yml`
-- Environment: `publish`
-
-The GitHub `publish` environment should retain its existing deployment
-protection. No long-lived PyPI API token is required.
-
-Local release artifact checks use the locked development environment and the
-same pinned maturin version as CI:
-
-```sh
-uv sync --project bindings/python --locked
-uv run --project bindings/python --locked maturin build --locked --release --out dist \
-  --manifest-path bindings/python/Cargo.toml
-uv run --project bindings/python --locked maturin sdist --out dist \
-  --manifest-path bindings/python/Cargo.toml
-```

package/docs/recipe-evals.md

@@ -1,70 +0,0 @@
-# Recipe eval declarations
-
-A Recipe may pin offline evaluation suites without owning the evaluation
-runner. The declaration makes quality inputs portable and reproducible; a host
-or external tool decides when and where to execute them.
-
-## Registry suite
-
-```json
-{
-  "pi": {
-    "evals": {
-      "suites": [
-        {
-          "name": "smoke",
-          "type": "registry",
-          "dataset": "acme/coding-smoke",
-          "version": "1.2.0"
-        }
-      ]
-    }
-  }
-}
-```
-
-Registry suites MUST pin an exact dataset version. Mutable aliases such as
-`latest` are invalid.
-
-## Git suite
-
-```json
-{
-  "pi": {
-    "evals": {
-      "suites": [
-        {
-          "name": "terminal",
-          "type": "git",
-          "repo": "https://github.com/acme/agent-evals.git",
-          "rev": "4f7c2b0d6d8a...",
-          "dataset": "terminal"
-        }
-      ]
-    }
-  }
-}
-```
-
-Git suites SHOULD pin a commit SHA. The dataset path MUST stay inside the
-checkout.
-
-## Validation
-
-```bash
-introspection check
-```
-
-The validator checks declaration shape, unique suite names, immutable pins,
-safe paths, and supported suite types without cloning or running the suite.
-
-## Runtime boundary
-
-Recipe sessions do not load or execute eval suites. The declaration belongs to
-the portable artifact because it identifies the authored evidence associated
-with that agent. Harbor, CI, Introspection, or another evaluation system may
-adapt that declaration into its own execution model.
-
-The selected Recipe agent remains the source of truth for model and behavior.
-An eval runner MUST make any override explicit rather than silently changing
-the agent under test.