@introspection-ai/recipes 0.13.0

package/dist/recipe-extensions.js

@@ -0,0 +1,81 @@
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+const require = createRequire(import.meta.url);
+function resolvePackage(specifier) {
+    try {
+        return import.meta.resolve(specifier);
+    }
+    catch {
+        // Fall through to CommonJS resolution for packages that do not expose ESM exports.
+    }
+    try {
+        return require.resolve(specifier);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolvePackageModuleRoot(packageName) {
+    const resolved = resolvePackage(packageName);
+    if (!resolved)
+        return undefined;
+    return dirname(resolved.startsWith("file:") ? fileURLToPath(resolved) : resolved);
+}
+function recipeExtensionAliases() {
+    const recipesRoot = resolvePackageModuleRoot("@introspection-ai/recipes");
+    return Object.fromEntries([
+        // Jiti aliases are package-prefix mappings. They must point at the
+        // directory containing a package's resolved modules, not an entry file,
+        // so Jiti can append exported subpaths without corrupting the path.
+        // The self-alias also keeps recipe interaction imports on this package
+        // instance, sharing interrupt state with the child-agent runner.
+        ["@introspection-ai/recipes", recipesRoot],
+        // Recipes authored before the package rename keep sharing this runtime's
+        // interaction state instead of loading a second legacy package copy.
+        ["@introspection-ai/pi-recipes", recipesRoot],
+        ["@earendil-works/pi-coding-agent", resolvePackageModuleRoot("@earendil-works/pi-coding-agent")],
+        ["@earendil-works/pi-agent-core", resolvePackageModuleRoot("@earendil-works/pi-agent-core")],
+        ["@earendil-works/pi-ai", resolvePackageModuleRoot("@earendil-works/pi-ai")],
+        ["typebox", resolvePackageModuleRoot("typebox")],
+        ["@sinclair/typebox", resolvePackageModuleRoot("typebox")],
+    ].filter((entry) => Boolean(entry[1])));
+}
+function loadJiti() {
+    try {
+        return require("jiti");
+    }
+    catch {
+        const piAgentEntry = resolvePackage("@earendil-works/pi-coding-agent");
+        if (!piAgentEntry) {
+            throw new Error("Unable to resolve @earendil-works/pi-coding-agent for recipe extension loading");
+        }
+        const piRequire = createRequire(piAgentEntry);
+        return piRequire("jiti");
+    }
+}
+/**
+ * Load a recipe-declared extension module and return its factory. TS sources
+ * load through jiti with package aliases pinned to this package's resolved
+ * module instances, so recipe extensions share interaction/interrupt state
+ * with their host.
+ */
+export async function loadRecipeExtensionFactory(recipeDir, extensionPath) {
+    const { createJiti } = loadJiti();
+    const recipeLoaderUrl = pathToFileURL(join(recipeDir, ".recipe-extension-loader.js")).href;
+    const jiti = createJiti(recipeLoaderUrl, {
+        moduleCache: false,
+        alias: recipeExtensionAliases(),
+    });
+    const loaded = await jiti.import(extensionPath, { default: true });
+    const factory = typeof loaded === "function"
+        ? loaded
+        : loaded && typeof loaded === "object" && "default" in loaded && typeof loaded.default === "function"
+            ? loaded.default
+            : undefined;
+    if (!factory) {
+        throw new Error(`Recipe extension does not export a factory function: ${extensionPath}`);
+    }
+    return factory;
+}
+//# sourceMappingURL=recipe-extensions.js.map

package/dist/recipe-extensions.js.map

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

package/dist/recipe-mcp-config.d.ts

@@ -0,0 +1,15 @@
+import type { RecipePackageManifest } from "./recipe-package.js";
+export interface RecipeMcpLocalConfigResult {
+    path: string;
+    created: boolean;
+    source: "example" | "generated" | "existing";
+    envVars: string[];
+}
+export declare function recipeMcpLocalExamplePath(recipeDir: string): string;
+export declare function recipeMcpLocalConfigPath(recipeDir: string): string;
+export declare function envPrefixForServer(id: string): string;
+/** The generated-binding env var names for a package MCP server id. */
+export declare function generatedBindingEnvVars(serverId: string): string[];
+export declare function placeholderEnvVars(content: string): string[];
+export declare function materializeRecipeMcpLocalConfig(recipeDir: string, manifest: RecipePackageManifest): Promise<RecipeMcpLocalConfigResult | undefined>;
+//# sourceMappingURL=recipe-mcp-config.d.ts.map

package/dist/recipe-mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-mcp-config.d.ts","sourceRoot":"","sources":["../src/recipe-mcp-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAGlE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ5D;AAkBD,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CA6CjD"}

package/dist/recipe-mcp-config.js

@@ -0,0 +1,82 @@
+import { existsSync } from "node:fs";
+import { chmod, copyFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export function recipeMcpLocalExamplePath(recipeDir) {
+    return join(recipeDir, ".pi", "mcp.local.example.json");
+}
+export function recipeMcpLocalConfigPath(recipeDir) {
+    return join(recipeDir, ".pi", "mcp.local.json");
+}
+export function envPrefixForServer(id) {
+    const normalized = id
+        .replace(/[^a-zA-Z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .toUpperCase();
+    return normalized.replace(/_MCP$/, "") || "MCP";
+}
+/** The generated-binding env var names for a package MCP server id. */
+export function generatedBindingEnvVars(serverId) {
+    const prefix = envPrefixForServer(serverId);
+    return [`${prefix}_MCP_URL`, `${prefix}_MCP_TOKEN`];
+}
+export function placeholderEnvVars(content) {
+    return Array.from(new Set(Array.from(content.matchAll(/\$\{([A-Z_][A-Z0-9_]*)\}/g))
+        .map((match) => match[1])
+        .sort()));
+}
+function generatedMcpLocalConfig(manifest) {
+    const servers = manifest.mcp.servers.map((server) => {
+        const prefix = envPrefixForServer(server.id);
+        return {
+            id: server.id,
+            transport: "streamable_http",
+            url: `\${${prefix}_MCP_URL}`,
+            headers: {
+                Authorization: `Bearer \${${prefix}_MCP_TOKEN}`,
+            },
+        };
+    });
+    return `${JSON.stringify({ servers }, null, 2)}\n`;
+}
+export async function materializeRecipeMcpLocalConfig(recipeDir, manifest) {
+    const target = recipeMcpLocalConfigPath(recipeDir);
+    const example = recipeMcpLocalExamplePath(recipeDir);
+    const hasExample = existsSync(example);
+    const hasMcp = hasExample ||
+        manifest.mcp.servers.length > 0 ||
+        manifest.mcp.manifests.length > 0;
+    if (!hasMcp)
+        return undefined;
+    if (existsSync(target)) {
+        const content = await readFile(target, "utf8");
+        return {
+            path: target,
+            created: false,
+            source: "existing",
+            envVars: placeholderEnvVars(content),
+        };
+    }
+    await mkdir(dirname(target), { recursive: true });
+    if (hasExample) {
+        await copyFile(example, target);
+        await chmod(target, 0o600);
+        const content = await readFile(target, "utf8");
+        return {
+            path: target,
+            created: true,
+            source: "example",
+            envVars: placeholderEnvVars(content),
+        };
+    }
+    if (manifest.mcp.servers.length === 0)
+        return undefined;
+    const content = generatedMcpLocalConfig(manifest);
+    await writeFile(target, content, { mode: 0o600 });
+    return {
+        path: target,
+        created: true,
+        source: "generated",
+        envVars: placeholderEnvVars(content),
+    };
+}
+//# sourceMappingURL=recipe-mcp-config.js.map

package/dist/recipe-mcp-config.js.map

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

package/dist/recipe-model.d.ts

@@ -0,0 +1,49 @@
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+import type { CacheRetention, Model, OpenRouterRouting } from "@earendil-works/pi-ai";
+import type { AgentSession } from "@earendil-works/pi-coding-agent";
+export interface RecipeAgentModelStreamOptions {
+    temperature?: number;
+    maxTokens?: number;
+    cacheRetention?: CacheRetention;
+    timeoutMs?: number;
+    maxRetries?: number;
+    maxRetryDelayMs?: number;
+}
+export interface RecipeAgentModelAnthropicOptions {
+    betas?: string[];
+    contextManagement?: unknown;
+}
+export interface RecipeAgentModelConfig {
+    name?: string;
+    thinkingLevel?: ThinkingLevel;
+    streamOptions?: RecipeAgentModelStreamOptions;
+    openrouter?: OpenRouterRouting;
+    anthropic?: RecipeAgentModelAnthropicOptions;
+}
+export declare class RecipeModelConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse an agent YAML `model:` block into a validated config.
+ *
+ * Accepts the documented keys only; unknown keys, malformed values, and
+ * conflicting `thinking_level`/`reasoning_effort` throw
+ * {@link RecipeModelConfigError} so typos fail loudly instead of silently
+ * changing model behavior.
+ */
+export declare function parseRecipeAgentModelConfig(context: string, value: unknown): RecipeAgentModelConfig | undefined;
+/**
+ * Merge a child agent's model config over its `from:` base. Sections
+ * (`streamOptions`, `openrouter`, `anthropic`) merge by key so a child can
+ * override one option without restating the base's.
+ */
+export declare function mergeRecipeAgentModelConfig(base: RecipeAgentModelConfig | undefined, overlay: RecipeAgentModelConfig | undefined): RecipeAgentModelConfig | undefined;
+/** Apply provider routing and header options onto a pi-ai model instance. */
+export declare function applyRecipeAgentModelConfigToModel<T extends Model<any>>(model: T, config: RecipeAgentModelConfig | undefined): T;
+/**
+ * Apply stream options and Anthropic context management onto a live agent
+ * session. Wraps the session's stream function and payload hook; safe to call
+ * once per session.
+ */
+export declare function applyRecipeAgentModelConfigToSession(session: AgentSession, config: RecipeAgentModelConfig | undefined): void;
+//# sourceMappingURL=recipe-model.d.ts.map

package/dist/recipe-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-model.d.ts","sourceRoot":"","sources":["../src/recipe-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,cAAc,EACd,KAAK,EACL,iBAAiB,EAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAiDpE,MAAM,WAAW,6BAA6B;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,6BAA6B,CAAC;IAC9C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,gCAAgC,CAAC;CAC9C;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAqLD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,sBAAsB,GAAG,SAAS,CA2FpC;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,sBAAsB,GAAG,SAAS,EACxC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAC1C,sBAAsB,GAAG,SAAS,CAsBpC;AAED,6EAA6E;AAC7E,wBAAgB,kCAAkC,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,EACrE,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,sBAAsB,GAAG,SAAS,GACzC,CAAC,CAsBH;AA4BD;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,sBAAsB,GAAG,SAAS,GACzC,IAAI,CA2BN"}

package/dist/recipe-model.js

@@ -0,0 +1,299 @@
+const THINKING_LEVELS = new Set([
+    "off",
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+]);
+const CACHE_RETENTIONS = new Set(["none", "short", "long"]);
+const MODEL_KEYS = new Set([
+    "name",
+    "thinking_level",
+    "thinkingLevel",
+    "reasoning_effort",
+    "temperature",
+    "max_tokens",
+    "cache_retention",
+    "timeout_ms",
+    "max_retries",
+    "max_retry_delay_ms",
+    "providers",
+]);
+const PROVIDER_KEYS = new Set(["openrouter", "anthropic"]);
+const OPENROUTER_PROVIDER_KEYS = new Set(["routing"]);
+const OPENROUTER_KEYS = new Set([
+    "allow_fallbacks",
+    "require_parameters",
+    "data_collection",
+    "zdr",
+    "enforce_distillable_text",
+    "order",
+    "only",
+    "ignore",
+    "quantizations",
+    "sort",
+    "max_price",
+    "preferred_min_throughput",
+    "preferred_max_latency",
+]);
+const ANTHROPIC_KEYS = new Set(["betas", "context_management"]);
+export class RecipeModelConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RecipeModelConfigError";
+    }
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function hasKeys(value) {
+    return value !== undefined && Object.keys(value).length > 0;
+}
+function optionalString(context, key, value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string") {
+        throw new RecipeModelConfigError(`${context} has invalid ${key}: expected string`);
+    }
+    return value.trim() || undefined;
+}
+function optionalNumber(context, key, value, min) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < min) {
+        throw new RecipeModelConfigError(`${context} has invalid ${key}: expected number >= ${min}`);
+    }
+    return value;
+}
+function optionalInteger(context, key, value, min) {
+    const parsed = optionalNumber(context, key, value, min);
+    if (parsed === undefined)
+        return undefined;
+    if (!Number.isInteger(parsed)) {
+        throw new RecipeModelConfigError(`${context} has invalid ${key}: expected integer`);
+    }
+    return parsed;
+}
+function optionalStringArray(context, key, value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) ||
+        !value.every((item) => typeof item === "string" && item.trim())) {
+        throw new RecipeModelConfigError(`${context} has invalid ${key}: expected string array`);
+    }
+    return value.map((item) => item.trim());
+}
+function parseThinkingLevel(context, key, value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || !THINKING_LEVELS.has(value)) {
+        throw new RecipeModelConfigError(`${context} has unsupported ${key} "${value}"`);
+    }
+    return value;
+}
+function assertKnownKeys(context, keyPrefix, data, allowed) {
+    const unknown = Object.keys(data).filter((key) => !allowed.has(key));
+    if (unknown.length > 0) {
+        throw new RecipeModelConfigError(`${context} has unsupported ${keyPrefix} key(s): ${unknown.join(", ")}`);
+    }
+}
+function parseOpenRouterRouting(context, value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw new RecipeModelConfigError(`${context} has invalid model.providers.openrouter.routing: expected object`);
+    }
+    assertKnownKeys(context, "model.providers.openrouter.routing", value, OPENROUTER_KEYS);
+    return { ...value };
+}
+function parseOpenRouterProvider(context, value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw new RecipeModelConfigError(`${context} has invalid model.providers.openrouter: expected object`);
+    }
+    assertKnownKeys(context, "model.providers.openrouter", value, OPENROUTER_PROVIDER_KEYS);
+    return parseOpenRouterRouting(context, value.routing);
+}
+function parseAnthropic(context, value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw new RecipeModelConfigError(`${context} has invalid model.providers.anthropic: expected object`);
+    }
+    assertKnownKeys(context, "model.providers.anthropic", value, ANTHROPIC_KEYS);
+    const betas = optionalStringArray(context, "model.providers.anthropic.betas", value.betas);
+    return {
+        ...(betas ? { betas } : {}),
+        ...(value.context_management !== undefined
+            ? { contextManagement: value.context_management }
+            : {}),
+    };
+}
+function parseProviders(context, value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw new RecipeModelConfigError(`${context} has invalid model.providers: expected object`);
+    }
+    assertKnownKeys(context, "model.providers", value, PROVIDER_KEYS);
+    const openrouter = parseOpenRouterProvider(context, value.openrouter);
+    const anthropic = parseAnthropic(context, value.anthropic);
+    return {
+        ...(openrouter ? { openrouter } : {}),
+        ...(anthropic ? { anthropic } : {}),
+    };
+}
+/**
+ * Parse an agent YAML `model:` block into a validated config.
+ *
+ * Accepts the documented keys only; unknown keys, malformed values, and
+ * conflicting `thinking_level`/`reasoning_effort` throw
+ * {@link RecipeModelConfigError} so typos fail loudly instead of silently
+ * changing model behavior.
+ */
+export function parseRecipeAgentModelConfig(context, value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        throw new RecipeModelConfigError(`${context} has invalid model: expected object`);
+    }
+    assertKnownKeys(context, "model", value, MODEL_KEYS);
+    const thinkingLevel = parseThinkingLevel(context, "model.thinking_level", value.thinking_level ?? value.thinkingLevel);
+    const reasoningEffort = parseThinkingLevel(context, "model.reasoning_effort", value.reasoning_effort);
+    if (thinkingLevel !== undefined &&
+        reasoningEffort !== undefined &&
+        thinkingLevel !== reasoningEffort) {
+        throw new RecipeModelConfigError(`${context} sets both model.thinking_level and model.reasoning_effort with different values`);
+    }
+    const cacheRetention = optionalString(context, "model.cache_retention", value.cache_retention);
+    if (cacheRetention !== undefined && !CACHE_RETENTIONS.has(cacheRetention)) {
+        throw new RecipeModelConfigError(`${context} has unsupported model.cache_retention "${cacheRetention}"`);
+    }
+    const temperature = optionalNumber(context, "model.temperature", value.temperature, 0);
+    const maxTokens = optionalInteger(context, "model.max_tokens", value.max_tokens, 1);
+    const timeoutMs = optionalInteger(context, "model.timeout_ms", value.timeout_ms, 1);
+    const maxRetries = optionalInteger(context, "model.max_retries", value.max_retries, 0);
+    const maxRetryDelayMs = optionalInteger(context, "model.max_retry_delay_ms", value.max_retry_delay_ms, 0);
+    const streamOptions = {
+        ...(temperature !== undefined ? { temperature } : {}),
+        ...(maxTokens !== undefined ? { maxTokens } : {}),
+        ...(cacheRetention
+            ? { cacheRetention: cacheRetention }
+            : {}),
+        ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+        ...(maxRetries !== undefined ? { maxRetries } : {}),
+        ...(maxRetryDelayMs !== undefined ? { maxRetryDelayMs } : {}),
+    };
+    const name = optionalString(context, "model.name", value.name);
+    const providers = parseProviders(context, value.providers);
+    return {
+        ...(name ? { name } : {}),
+        ...((thinkingLevel ?? reasoningEffort)
+            ? { thinkingLevel: (thinkingLevel ?? reasoningEffort) }
+            : {}),
+        ...(hasKeys(streamOptions) ? { streamOptions } : {}),
+        ...(providers ?? {}),
+    };
+}
+/**
+ * Merge a child agent's model config over its `from:` base. Sections
+ * (`streamOptions`, `openrouter`, `anthropic`) merge by key so a child can
+ * override one option without restating the base's.
+ */
+export function mergeRecipeAgentModelConfig(base, overlay) {
+    if (!base)
+        return overlay;
+    if (!overlay)
+        return base;
+    const streamOptions = {
+        ...(base.streamOptions ?? {}),
+        ...(overlay.streamOptions ?? {}),
+    };
+    const openrouter = {
+        ...(base.openrouter ?? {}),
+        ...(overlay.openrouter ?? {}),
+    };
+    const anthropic = {
+        ...(base.anthropic ?? {}),
+        ...(overlay.anthropic ?? {}),
+    };
+    return {
+        ...base,
+        ...overlay,
+        ...(hasKeys(streamOptions) ? { streamOptions } : {}),
+        ...(hasKeys(openrouter) ? { openrouter } : {}),
+        ...(hasKeys(anthropic) ? { anthropic } : {}),
+    };
+}
+/** Apply provider routing and header options onto a pi-ai model instance. */
+export function applyRecipeAgentModelConfigToModel(model, config) {
+    if (!config)
+        return model;
+    if (config.openrouter) {
+        model.compat = {
+            ...(model.compat ?? {}),
+            openRouterRouting: config.openrouter,
+        };
+    }
+    if (config.anthropic?.betas?.length) {
+        const existing = model.headers?.["anthropic-beta"]
+            ?.split(",")
+            .map((item) => item.trim())
+            .filter(Boolean);
+        const betas = [
+            ...new Set([...(existing ?? []), ...config.anthropic.betas]),
+        ];
+        model.headers = {
+            ...(model.headers ?? {}),
+            "anthropic-beta": betas.join(","),
+        };
+    }
+    return model;
+}
+function mergeStreamOptions(current, configured) {
+    if (!configured || Object.keys(configured).length === 0)
+        return current;
+    return {
+        ...(current ?? {}),
+        ...configured,
+    };
+}
+function withAnthropicContextManagement(payload, model, config) {
+    const contextManagement = config.anthropic?.contextManagement;
+    if (contextManagement === undefined)
+        return payload;
+    if (model.api !== "anthropic-messages")
+        return payload;
+    if (!isRecord(payload))
+        return payload;
+    return {
+        ...payload,
+        context_management: contextManagement,
+    };
+}
+/**
+ * Apply stream options and Anthropic context management onto a live agent
+ * session. Wraps the session's stream function and payload hook; safe to call
+ * once per session.
+ */
+export function applyRecipeAgentModelConfigToSession(session, config) {
+    if (!config)
+        return;
+    if (config.streamOptions) {
+        const baseStreamFn = session.agent.streamFunction;
+        session.agent.streamFunction = (model, context, options) => baseStreamFn(model, context, mergeStreamOptions(options, config.streamOptions));
+    }
+    if (config.anthropic?.contextManagement !== undefined) {
+        const previousOnPayload = session.agent.onPayload;
+        session.agent.onPayload = async (payload, model) => {
+            const nextPayload = withAnthropicContextManagement(payload, model, config);
+            const previousResult = previousOnPayload
+                ? await previousOnPayload(nextPayload, model)
+                : undefined;
+            return previousResult === undefined ? nextPayload : previousResult;
+        };
+    }
+}
+//# sourceMappingURL=recipe-model.js.map

package/dist/recipe-model.js.map

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

package/dist/recipe-package.d.ts

@@ -0,0 +1,79 @@
+export interface RecipePackageResources {
+    agents: string[];
+    extensions: string[];
+    skills: string[];
+    prompts: string[];
+}
+export interface RecipePackageMcpServer {
+    id: string;
+    required: boolean;
+    tools: RecipeMcpToolSelection;
+}
+export interface RecipeMcpToolSelection {
+    /** Exact tool names or the reserved whole-toolset `*` sentinel. Omission allows no tools. */
+    include?: string[];
+    /** Exact tool names removed after inclusion. */
+    exclude?: string[];
+}
+/** Parse a selection while preserving whether its source shape was malformed. */
+export declare function parseRecipeMcpToolSelection(value: unknown): RecipeMcpToolSelection;
+/** Minimal runtime guard; recipe-check owns detailed authoring diagnostics. */
+export declare function isValidRecipeMcpToolSelection(selection: RecipeMcpToolSelection): boolean;
+export interface RecipePackageMcpConfig {
+    manifests: string[];
+    servers: RecipePackageMcpServer[];
+}
+export type RecipeEvalSuite = {
+    name: string;
+    type: "registry";
+    dataset: string;
+    version: string;
+} | {
+    name: string;
+    type: "git";
+    repo: string;
+    rev: string;
+    dataset: string;
+};
+export interface RecipeEvalsConfig {
+    suites: RecipeEvalSuite[];
+    raw?: unknown;
+}
+export interface RecipePackageManifest {
+    name: string;
+    version: string;
+    description?: string;
+    path: string;
+    resources: RecipePackageResources;
+    mcp: RecipePackageMcpConfig;
+    evals: RecipeEvalsConfig;
+}
+export type PiPackageResources = RecipePackageResources;
+export type PiPackageManifest = RecipePackageManifest;
+export type RecipeValidationSeverity = "error" | "warning";
+export interface RecipeValidationFinding {
+    severity: RecipeValidationSeverity;
+    code: string;
+    message: string;
+    packageName?: string;
+}
+export interface RecipeValidationReport {
+    valid: boolean;
+    findings: RecipeValidationFinding[];
+}
+export declare class RecipePackageError extends Error {
+    constructor(message: string);
+}
+export declare function parseEvalsConfig(value: unknown, present?: boolean): RecipeEvalsConfig;
+export declare function validateRecipeEvalsConfig(evals: RecipeEvalsConfig, packageName?: string): RecipeValidationReport;
+export declare function readPiPackageManifest(packageDir: string): RecipePackageManifest;
+export declare function resolvePiPackageMcpManifestPaths(pkg: RecipePackageManifest, opts?: {
+    allowEmptyGlobMatches?: boolean;
+}): string[];
+export declare function resolvePiPackageResourcePaths(pkg: RecipePackageManifest, key: keyof RecipePackageResources, opts?: {
+    allowEmptyGlobMatches?: boolean;
+}): string[];
+export declare function defaultPiPackageResourcePaths(pkg: RecipePackageManifest, key: keyof RecipePackageResources): string[];
+export declare function packageResourcePaths(pkg: RecipePackageManifest, key: keyof RecipePackageResources): string[];
+export declare function validatePiPackageManifest(pkg: RecipePackageManifest): RecipeValidationReport;
+//# sourceMappingURL=recipe-package.d.ts.map

package/dist/recipe-package.d.ts.map

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