@introspection-ai/recipes 0.13.0 → 0.14.0

package/dist/extensions.d.ts

@@ -0,0 +1,29 @@
+import type { ExtensionAPI, ExtensionFactory } from "@earendil-works/pi-coding-agent";
+export interface RecipeExtensionSessionContext {
+    readonly recipe: {
+        readonly name: string;
+    };
+    readonly agent: {
+        readonly name: string;
+    };
+    readonly session: {
+        readonly role: "root" | "subagent";
+    };
+}
+export interface RecipeExtensionRegistrationRegistry {
+    claim(kind: string, name: string, owner: string): void;
+    release(kind: string, name: string, owner: string): void;
+}
+/** @internal Exact tool names a package extension may keep model-visible. */
+export declare function recipeExtensionToolAllowlist(declaredTools: readonly string[], hasAgentTool: boolean, additionalToolNames?: readonly string[]): ReadonlySet<string>;
+/** @internal Reject ambiguous registrations across the package closure. */
+export declare function createRecipeExtensionRegistrationRegistry(): RecipeExtensionRegistrationRegistry;
+/** Return the immutable Recipe identity bound to this extension instance. */
+export declare function getRecipeSessionContext(pi: ExtensionAPI): RecipeExtensionSessionContext;
+/** Register behavior only when this session is running the named agent. */
+export declare function forAgent(pi: ExtensionAPI, agentName: string, register: (context: RecipeExtensionSessionContext) => void): void;
+/** Register behavior only when a session predicate matches. */
+export declare function forRecipeSession(pi: ExtensionAPI, predicate: (context: RecipeExtensionSessionContext) => boolean, register: (context: RecipeExtensionSessionContext) => void): void;
+/** @internal Bind context before Pi invokes a package extension factory. */
+export declare function bindRecipeExtensionFactory(factory: ExtensionFactory, context: RecipeExtensionSessionContext, registrationRegistry?: RecipeExtensionRegistrationRegistry, owner?: string, allowedToolNames?: ReadonlySet<string>): ExtensionFactory;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;KACpC,CAAC;CACH;AAID,MAAM,WAAW,mCAAmC;IAClD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1D;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,YAAY,EAAE,OAAO,EACrB,mBAAmB,GAAE,SAAS,MAAM,EAAO,GAC1C,WAAW,CAAC,MAAM,CAAC,CAMrB;AAED,2EAA2E;AAC3E,wBAAgB,yCAAyC,IAAI,mCAAmC,CAyB/F;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,YAAY,GACf,6BAA6B,CAQ/B;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CACtB,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,IAAI,GACzD,IAAI,CAGN;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,EAC9D,QAAQ,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,IAAI,GACzD,IAAI,CAGN;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,6BAA6B,EACtC,oBAAoB,CAAC,EAAE,mCAAmC,EAC1D,KAAK,SAAuB,EAC5B,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACrC,gBAAgB,CAkFlB"}

package/dist/extensions.js

@@ -0,0 +1,119 @@
+const contexts = new WeakMap();
+/** @internal Exact tool names a package extension may keep model-visible. */
+export function recipeExtensionToolAllowlist(declaredTools, hasAgentTool, additionalToolNames = []) {
+    return new Set([
+        ...declaredTools,
+        ...(hasAgentTool ? ["agent"] : []),
+        ...additionalToolNames,
+    ]);
+}
+/** @internal Reject ambiguous registrations across the package closure. */
+export function createRecipeExtensionRegistrationRegistry() {
+    const owners = new Map();
+    return {
+        claim(kind, name, owner) {
+            const key = `${kind}\0${name}`;
+            const existing = owners.get(key);
+            if (existing === owner)
+                return;
+            if (existing) {
+                throw new Error(`Recipe extension ${kind} registration "${name}" conflicts between ${existing} and ${owner}`);
+            }
+            owners.set(key, owner);
+        },
+        release(kind, name, owner) {
+            const key = `${kind}\0${name}`;
+            const existing = owners.get(key);
+            if (existing !== owner) {
+                throw new Error(`Recipe extension ${owner} cannot unregister ${kind} "${name}" owned by ${existing ?? "<host>"}`);
+            }
+            owners.delete(key);
+        },
+    };
+}
+/** Return the immutable Recipe identity bound to this extension instance. */
+export function getRecipeSessionContext(pi) {
+    const context = contexts.get(pi);
+    if (!context) {
+        throw new Error("This extension is not running inside a Recipe-owned session");
+    }
+    return context;
+}
+/** Register behavior only when this session is running the named agent. */
+export function forAgent(pi, agentName, register) {
+    const context = getRecipeSessionContext(pi);
+    if (context.agent.name === agentName)
+        register(context);
+}
+/** Register behavior only when a session predicate matches. */
+export function forRecipeSession(pi, predicate, register) {
+    const context = getRecipeSessionContext(pi);
+    if (predicate(context))
+        register(context);
+}
+/** @internal Bind context before Pi invokes a package extension factory. */
+export function bindRecipeExtensionFactory(factory, context, registrationRegistry, owner = "<recipe-extension>", allowedToolNames) {
+    return async (pi) => {
+        const registrationKinds = {
+            registerTool: "tool",
+            registerCommand: "command",
+            registerShortcut: "shortcut",
+            registerFlag: "flag",
+            registerMessageRenderer: "message renderer",
+            registerEntryRenderer: "entry renderer",
+            registerProvider: "provider",
+        };
+        const guarded = registrationRegistry || allowedToolNames
+            ? new Proxy(pi, {
+                get(target, property, receiver) {
+                    const value = Reflect.get(target, property, receiver);
+                    const kind = typeof property === "string"
+                        ? registrationKinds[property]
+                        : undefined;
+                    if (!kind || !registrationRegistry || typeof value !== "function") {
+                        if (property === "setActiveTools" &&
+                            typeof value === "function" &&
+                            allowedToolNames) {
+                            return (names) => {
+                                const undeclared = names.filter((name) => !allowedToolNames.has(name));
+                                if (undeclared.length > 0) {
+                                    throw new Error(`Recipe extension attempted to activate undeclared tool(s): ${undeclared.join(", ")}`);
+                                }
+                                return value.call(target, names);
+                            };
+                        }
+                        if (property === "unregisterProvider" &&
+                            typeof value === "function" &&
+                            registrationRegistry) {
+                            return (name) => {
+                                const providerName = typeof name === "string" ? name : name.id;
+                                if (providerName) {
+                                    registrationRegistry.release("provider", providerName, owner);
+                                }
+                                return value.call(target, name);
+                            };
+                        }
+                        return typeof value === "function" ? value.bind(target) : value;
+                    }
+                    return (...args) => {
+                        const registrationName = property === "registerTool"
+                            ? args[0]?.name
+                            : property === "registerProvider" &&
+                                typeof args[0] === "object"
+                                ? args[0]?.id
+                                : args[0];
+                        if (typeof registrationName === "string") {
+                            registrationRegistry.claim(kind, property === "registerShortcut"
+                                ? registrationName.toLowerCase()
+                                : registrationName, owner);
+                        }
+                        return value.apply(target, args);
+                    };
+                },
+            })
+            : pi;
+        contexts.set(guarded, context);
+        await factory(guarded);
+    };
+}
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAiBA,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA+C,CAAC;AAO5E,6EAA6E;AAC7E,MAAM,UAAU,4BAA4B,CAC1C,aAAgC,EAChC,YAAqB,EACrB,sBAAyC,EAAE;IAE3C,OAAO,IAAI,GAAG,CAAC;QACb,GAAG,aAAa;QAChB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,GAAG,mBAAmB;KACvB,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,yCAAyC;IACvD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,OAAO;QACL,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK;YACrB,MAAM,GAAG,GAAG,GAAG,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,QAAQ,KAAK,KAAK;gBAAE,OAAO;YAC/B,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,kBAAkB,IAAI,uBAAuB,QAAQ,QAAQ,KAAK,EAAE,CAC7F,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK;YACvB,MAAM,GAAG,GAAG,GAAG,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,oBAAoB,KAAK,sBAAsB,IAAI,KAAK,IAAI,cAAc,QAAQ,IAAI,QAAQ,EAAE,CACjG,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,uBAAuB,CACrC,EAAgB;IAEhB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CACtB,EAAgB,EAChB,SAAiB,EACjB,QAA0D;IAE1D,MAAM,OAAO,GAAG,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB,CAC9B,EAAgB,EAChB,SAA8D,EAC9D,QAA0D;IAE1D,MAAM,OAAO,GAAG,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,SAAS,CAAC,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,0BAA0B,CACxC,OAAyB,EACzB,OAAsC,EACtC,oBAA0D,EAC1D,KAAK,GAAG,oBAAoB,EAC5B,gBAAsC;IAEtC,OAAO,KAAK,EAAE,EAAE,EAAE,EAAE;QAClB,MAAM,iBAAiB,GAA2B;YAChD,YAAY,EAAE,MAAM;YACpB,eAAe,EAAE,SAAS;YAC1B,gBAAgB,EAAE,UAAU;YAC5B,YAAY,EAAE,MAAM;YACpB,uBAAuB,EAAE,kBAAkB;YAC3C,qBAAqB,EAAE,gBAAgB;YACvC,gBAAgB,EAAE,UAAU;SAC7B,CAAC;QACF,MAAM,OAAO,GAAG,oBAAoB,IAAI,gBAAgB;YACtD,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,EAAE;gBACZ,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;oBAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;oBACtD,MAAM,IAAI,GACR,OAAO,QAAQ,KAAK,QAAQ;wBAC1B,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC;wBAC7B,CAAC,CAAC,SAAS,CAAC;oBAChB,IAAI,CAAC,IAAI,IAAI,CAAC,oBAAoB,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;wBAClE,IACE,QAAQ,KAAK,gBAAgB;4BAC7B,OAAO,KAAK,KAAK,UAAU;4BAC3B,gBAAgB,EAChB,CAAC;4BACD,OAAO,CAAC,KAAe,EAAE,EAAE;gCACzB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CACtC,CAAC;gCACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oCAC1B,MAAM,IAAI,KAAK,CACb,8DAA8D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;gCACJ,CAAC;gCACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;4BACnC,CAAC,CAAC;wBACJ,CAAC;wBACD,IACE,QAAQ,KAAK,oBAAoB;4BACjC,OAAO,KAAK,KAAK,UAAU;4BAC3B,oBAAoB,EACpB,CAAC;4BACD,OAAO,CAAC,IAA8B,EAAE,EAAE;gCACxC,MAAM,YAAY,GAChB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gCAC5C,IAAI,YAAY,EAAE,CAAC;oCACjB,oBAAoB,CAAC,OAAO,CAC1B,UAAU,EACV,YAAY,EACZ,KAAK,CACN,CAAC;gCACJ,CAAC;gCACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;4BAClC,CAAC,CAAC;wBACJ,CAAC;wBACD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;oBAClE,CAAC;oBACD,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;wBAC5B,MAAM,gBAAgB,GACpB,QAAQ,KAAK,cAAc;4BACzB,CAAC,CAAE,IAAI,CAAC,CAAC,CAAoC,EAAE,IAAI;4BACnD,CAAC,CAAC,QAAQ,KAAK,kBAAkB;gCAC7B,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;gCAC7B,CAAC,CAAE,IAAI,CAAC,CAAC,CAAkC,EAAE,EAAE;gCACjD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;wBACd,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;4BACzC,oBAAoB,CAAC,KAAK,CACxB,IAAI,EACJ,QAAQ,KAAK,kBAAkB;gCAC7B,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE;gCAChC,CAAC,CAAC,gBAAgB,EACpB,KAAK,CACN,CAAC;wBACJ,CAAC;wBACD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBACnC,CAAC,CAAC;gBACJ,CAAC;aACF,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,14 +1,5 @@
-export * from "./interactions.js";
-export * from "./agent-tool.js";
-export * from "./inspect.js";
-export * from "./mcp-catalog.js";
-export * from "./mcp.js";
-export * from "./pi-extension.js";
-export * from "./recipe-agent.js";
-export * from "./recipe-model.js";
-export * from "./recipe-package.js";
-export * from "./recipe/resolve.js";
-export * from "./run.js";
-export * from "./run-controller.js";
-export * from "./session.js";
+export { resolveRecipe, RecipeResolutionError, } from "./recipe/resolve.js";
+export type { ResolvedRecipe, ResolvedRecipeAgent, ResolvedRecipeAgentMcp, } from "./recipe/resolve.js";
+export { createAgentSession, RecipeCredentialError, RecipeMcpEnvironmentInUseError, RecipeModelError, RecipeModelTransportError, } from "./api/session.js";
+export type { CreateAgentSessionOptions, RecipeSessionHandle, RecipeSessionOtelOptions, } from "./api/session.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,14 +1,3 @@
-export * from "./interactions.js";
-export * from "./agent-tool.js";
-export * from "./inspect.js";
-export * from "./mcp-catalog.js";
-export * from "./mcp.js";
-export * from "./pi-extension.js";
-export * from "./recipe-agent.js";
-export * from "./recipe-model.js";
-export * from "./recipe-package.js";
-export * from "./recipe/resolve.js";
-export * from "./run.js";
-export * from "./run-controller.js";
-export * from "./session.js";
+export { resolveRecipe, RecipeResolutionError, } from "./recipe/resolve.js";
+export { createAgentSession, RecipeCredentialError, RecipeMcpEnvironmentInUseError, RecipeModelError, RecipeModelTransportError, } from "./api/session.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,EAC9B,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC"}

package/dist/inspect.d.ts

@@ -1,7 +1,35 @@
+import type { RecipeAgentConfigField } from "./recipe-agent.js";
+import type { ResolvedRecipe, ResolvedRecipeAgent } from "./recipe/resolve.js";
+export interface RecipeAgentInspection {
+    name: string;
+    from?: string;
+    declaredFields: RecipeAgentConfigField[];
+    provenance: Partial<Record<RecipeAgentConfigField, string[]>>;
+    model: {
+        name: string;
+        thinkingLevel?: string;
+        config?: ResolvedRecipeAgent["modelConfig"];
+    };
+    prompt: {
+        base: "SYSTEM.md" | "pi";
+        agentInstructions?: {
+            mode: "append" | "replace";
+            source: string;
+        };
+    };
+    tools: {
+        authored: string[];
+        root: string[];
+        subagent: string[];
+    };
+    skills: string[];
+    subagents: string[];
+    mcp?: ResolvedRecipeAgent["mcp"];
+}
 /**
  * What a recipe requires before it can run, derived entirely from the
- * package's existing declarations — no new manifest keys. Hosts and adapters
- * can use this for preflight checks and configuration UIs.
+ * package's existing declarations — no new manifest keys. Hosts can use this
+ * for preflight checks and configuration UIs.
  */
 export interface RecipeInspection {
     name: string;
@@ -9,18 +37,23 @@ export interface RecipeInspection {
     description?: string;
     agents: string[];
     providers: string[];
-    credential_env: string[];
+    credentialEnv: string[];
     mcp: {
         required: string[];
         optional: string[];
     };
-    mcp_env: string[];
+    mcpEnv: string[];
     resources: {
         agents: number;
         skills: number;
         extensions: number;
         prompts: number;
     };
+    packageClosure: {
+        extensions: string[];
+        prompts: string[];
+    };
+    resolvedAgents: RecipeAgentInspection[];
 }
-export declare function inspectRecipe(recipeDir: string): RecipeInspection;
+export declare function inspectRecipe(resolvedRecipe: ResolvedRecipe): RecipeInspection;
 //# sourceMappingURL=inspect.d.ts.map

package/dist/inspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAiFjE"}
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,sBAAsB,EAAE,CAAC;IACzC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9D,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;KAC7C,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;QACzB,iBAAiB,CAAC,EAAE;YAClB,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;IACF,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,cAAc,EAAE;QACd,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,cAAc,EAAE,qBAAqB,EAAE,CAAC;CACzC;AAmFD,wBAAgB,aAAa,CAAC,cAAc,EAAE,cAAc,GAAG,gBAAgB,CA2E9E"}

package/dist/inspect.js

@@ -1,16 +1,84 @@
-import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { loadRecipeAgentDefinitions } from "./recipe-agent.js";
-import { generatedBindingEnvVars, placeholderEnvVars, recipeMcpLocalConfigPath, recipeMcpLocalExamplePath, } from "./recipe-mcp-config.js";
-import { packageResourcePaths, readPiPackageManifest, } from "./recipe-package.js";
+import { generatedBindingEnvVars } from "./recipe-mcp-config.js";
 import { expectedProviderEnvVars } from "./provider-env.js";
-export function inspectRecipe(recipeDir) {
-    const dir = resolve(recipeDir);
-    const manifest = readPiPackageManifest(dir);
-    const definitions = loadRecipeAgentDefinitions(dir);
-    const agents = [...new Set([...definitions.values()].map((a) => a.name))];
+function agentChain(recipe, agent) {
+    const chain = [];
+    const seen = new Set();
+    let current = agent;
+    while (current && !seen.has(current.name)) {
+        seen.add(current.name);
+        chain.unshift(current);
+        current = current.definition.from
+            ? recipe.agents.get(current.definition.from)
+            : undefined;
+    }
+    return chain;
+}
+function inspectAgent(recipe, agent, hasSystemPrompt) {
+    const chain = agentChain(recipe, agent);
+    const fields = [
+        "description",
+        "model",
+        "tools",
+        "mcp",
+        "skills",
+        "subagents",
+        "system_instructions",
+    ];
+    const provenance = Object.fromEntries(fields.flatMap((field) => {
+        const sources = chain
+            .filter((entry) => entry.definition.declaredFields?.includes(field))
+            .map((entry) => entry.name);
+        return sources.length > 0 ? [[field, sources]] : [];
+    }));
+    const instructionSource = provenance.system_instructions?.at(-1);
+    const rootTools = [
+        ...agent.tools,
+        ...(agent.subagents.size > 0 ? ["agent"] : []),
+    ];
+    return {
+        name: agent.name,
+        ...(agent.definition.from ? { from: agent.definition.from } : {}),
+        declaredFields: [...(agent.definition.declaredFields ?? [])],
+        provenance,
+        model: {
+            name: agent.modelSpec,
+            ...(agent.thinkingLevel
+                ? { thinkingLevel: agent.thinkingLevel }
+                : {}),
+            ...(agent.modelConfig ? { config: agent.modelConfig } : {}),
+        },
+        prompt: {
+            base: hasSystemPrompt ? "SYSTEM.md" : "pi",
+            ...(agent.definition.systemInstructions && instructionSource
+                ? {
+                    agentInstructions: {
+                        mode: agent.definition.systemInstructions.mode,
+                        source: instructionSource,
+                    },
+                }
+                : {}),
+        },
+        tools: {
+            authored: [...agent.tools],
+            root: rootTools,
+            subagent: [...agent.tools],
+        },
+        skills: [...agent.skillPaths],
+        subagents: [...agent.subagents.keys()],
+        ...(agent.mcp ? { mcp: agent.mcp } : {}),
+    };
+}
+export function inspectRecipe(resolvedRecipe) {
+    const manifest = resolvedRecipe.manifest;
+    const definitions = [...resolvedRecipe.agents.values()].map((agent) => agent.definition);
+    const agents = [...new Set(definitions.map((agent) => agent.name))];
+    const uniqueResolvedAgents = [
+        ...new Map([...resolvedRecipe.agents.values()].map((agent) => [agent.name, agent])).values(),
+    ];
+    const extensionPaths = resolvedRecipe.resources.extensions;
+    const promptPaths = resolvedRecipe.resources.prompts;
     const providers = [
-        ...new Set([...definitions.values()].flatMap((agent) => {
+        ...new Set(definitions.flatMap((agent) => {
             const spec = agent.model?.name;
             const slash = spec?.indexOf("/") ?? -1;
             return spec && slash > 0 ? [spec.slice(0, slash)] : [];
@@ -25,46 +93,29 @@ export function inspectRecipe(recipeDir) {
     const optional = manifest.mcp.servers
         .filter((server) => !server.required)
         .map((server) => server.id);
-    // Binding env vars: prefer the recipe's own binding file (or its example)
-    // when present; otherwise the generated-binding convention per server.
-    let mcpEnv;
-    const bindingSource = [
-        recipeMcpLocalConfigPath(dir),
-        recipeMcpLocalExamplePath(dir),
-    ].find((path) => existsSync(path));
-    if (bindingSource) {
-        const content = readFileSync(bindingSource, "utf8");
-        const parsed = JSON.parse(content);
-        mcpEnv = [
-            ...new Set([
-                ...placeholderEnvVars(content),
-                ...(parsed.servers ?? []).flatMap((server) => typeof server.oauthClientSecretEnv === "string" &&
-                    server.oauthClientSecretEnv
-                    ? [server.oauthClientSecretEnv]
-                    : []),
-            ]),
-        ].sort();
-    }
-    else {
-        mcpEnv = [
-            ...new Set(manifest.mcp.servers.flatMap((server) => generatedBindingEnvVars(server.id))),
-        ].sort();
-    }
+    const mcpEnv = [
+        ...new Set(manifest.mcp.servers.flatMap((server) => generatedBindingEnvVars(server.id))),
+    ].sort();
     return {
         name: manifest.name,
         version: manifest.version,
         ...(manifest.description ? { description: manifest.description } : {}),
         agents,
         providers,
-        credential_env: credentialEnv,
+        credentialEnv,
         mcp: { required, optional },
-        mcp_env: mcpEnv,
+        mcpEnv,
         resources: {
             agents: agents.length,
-            skills: packageResourcePaths(manifest, "skills").length,
-            extensions: packageResourcePaths(manifest, "extensions").length,
-            prompts: packageResourcePaths(manifest, "prompts").length,
+            skills: resolvedRecipe.resources.skills.length,
+            extensions: extensionPaths.length,
+            prompts: promptPaths.length,
+        },
+        packageClosure: {
+            extensions: [...extensionPaths],
+            prompts: [...promptPaths],
         },
+        resolvedAgents: uniqueResolvedAgents.map((agent) => inspectAgent(resolvedRecipe, agent, resolvedRecipe.resources.hasSystemPrompt)),
     };
 }
 //# sourceMappingURL=inspect.js.map

package/dist/inspect.js.map

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

package/dist/interactions.d.ts

@@ -193,12 +193,28 @@ export interface AskUserResult {
  * make progress without surfacing a UI dialog or an interrupt.
  */
 export declare function autoResolveInteractions<T>(fn: () => Promise<T>): Promise<T>;
-/** @deprecated Use `autoResolveInteractions()` for the explicit behavior. */
-export declare function suppressInterruptResume<T>(fn: () => Promise<T>): Promise<T>;
 /** Ask the user, resolving the best available interaction channel. */
 export declare function askUser(request: AskUserRequest, opts: AskUserOptions): Promise<AskUserResult>;
 /** Ask a blocking clarification question without hand-authoring interrupt details. */
 export declare function askUserQuestion(request: AskUserQuestionRequest, opts: AskUserOptions): Promise<AskUserResult>;
 /** Request approval without hand-authoring interrupt details or display data. */
 export declare function askUserApproval(request: AskUserApprovalRequest, opts: AskUserOptions): Promise<AskUserResult>;
+/**
+ * Render the byte-exact text a Recipe tool receives for an interaction
+ * outcome. Hosts use this when replacing a paused tool result on resume.
+ */
+export declare function formatInteractionOutcome(outcome: AskUserOutcome): string;
+/**
+ * Host-neutral shape for a response to a paused Recipe interaction.
+ * Protocol adapters can pass their resume record without depending on AG-UI
+ * or another transport package.
+ */
+export interface InteractionResumeResponse {
+    status?: string;
+    payload?: unknown;
+}
+/**
+ * Convert a host resume response into the frozen Recipe interaction envelope.
+ */
+export declare function formatInteractionResume(response: InteractionResumeResponse): string;
 //# sourceMappingURL=interactions.d.ts.map

package/dist/interactions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../src/interactions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../src/interactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,iCAAiC,CAAC;AAEzC,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,mBAAmB,CAAC;AAC/D,mEAAmE;AACnE,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAC3D,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,cAAc,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAiBrD,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC;IAC9C;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC;IAC9C,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,wCAAwC;IACxC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,QAAQ,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACtC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,GAAG,EAAE,gBAAgB,CAAC;IACtB;;;;OAIG;IACH,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CACZ,EAAE,EAAE,kBAAkB,EACtB,MAAM,EAAE,wBAAwB,KAC7B,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACzC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,mCAAmC;AACnC,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE;AACtB,4EAA4E;GAC1E;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE;AAC3B,mEAAmE;GACjE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,cAAc,CAAC;CACzB;AAiBD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3E;AAED,sEAAsE;AACtE,wBAAsB,OAAO,CAC3B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,CAAC,CA2CxB;AAED,sFAAsF;AACtF,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,CAAC,CAkBxB;AAED,iFAAiF;AACjF,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,CAAC,CA6BxB;AAyKD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAmBxE;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,yBAAyB,GAClC,MAAM,CAoCR"}

package/dist/interactions.js

@@ -54,9 +54,8 @@ const UNAVAILABLE_ENVELOPE = "User interaction is unavailable in this session; n
 // Recipe extensions and their host may resolve separate physical copies of
 // Recipes (for example, one under the recipe and one under runtime-worker).
 // Keep the async context process-global so either copy can establish the child
-// boundary and every current copy observes it. Retain the pre-rename symbol
-// key so old and new package versions interoperate in the same process.
-const INTERACTION_AUTO_RESOLUTION_KEY = Symbol.for("@introspection-ai/pi-recipes/interaction-auto-resolution");
+// boundary and every current copy observes it.
+const INTERACTION_AUTO_RESOLUTION_KEY = Symbol.for("@introspection-ai/recipes/interaction-auto-resolution");
 const interactionGlobals = globalThis;
 const interactionAutoResolution = interactionGlobals[INTERACTION_AUTO_RESOLUTION_KEY] ??
     new AsyncLocalStorage();
@@ -71,10 +70,6 @@ interactionGlobals[INTERACTION_AUTO_RESOLUTION_KEY] = interactionAutoResolution;
 export function autoResolveInteractions(fn) {
     return interactionAutoResolution.run(true, fn);
 }
-/** @deprecated Use `autoResolveInteractions()` for the explicit behavior. */
-export function suppressInterruptResume(fn) {
-    return autoResolveInteractions(fn);
-}
 /** Ask the user, resolving the best available interaction channel. */
 export async function askUser(request, opts) {
     const env = opts.env ?? process.env;
@@ -286,7 +281,11 @@ function localDialogMessage(request) {
     }
     return lines.join("\n");
 }
-function envelopeText(outcome) {
+/**
+ * Render the byte-exact text a Recipe tool receives for an interaction
+ * outcome. Hosts use this when replacing a paused tool result on resume.
+ */
+export function formatInteractionOutcome(outcome) {
     switch (outcome.type) {
         case "answered":
             return `Answer: ${outcome.answer}`;
@@ -306,6 +305,38 @@ function envelopeText(outcome) {
             return UNAVAILABLE_ENVELOPE;
     }
 }
+/**
+ * Convert a host resume response into the frozen Recipe interaction envelope.
+ */
+export function formatInteractionResume(response) {
+    if (response.status === "cancelled") {
+        return formatInteractionOutcome({ type: "declined" });
+    }
+    const payload = response.payload &&
+        typeof response.payload === "object" &&
+        !Array.isArray(response.payload)
+        ? response.payload
+        : undefined;
+    const answer = typeof payload?.answer === "string" ? payload.answer.trim() : "";
+    if (answer) {
+        return formatInteractionOutcome({ type: "answered", answer });
+    }
+    if (typeof payload?.approved === "boolean") {
+        const feedback = typeof payload.feedback === "string" ? payload.feedback.trim() : "";
+        return formatInteractionOutcome(payload.approved
+            ? {
+                type: "approved",
+                ...(feedback ? { feedback } : {}),
+            }
+            : {
+                type: "revision_requested",
+                ...(feedback ? { feedback } : {}),
+            });
+    }
+    return response.status
+        ? `Interrupt response: ${response.status}`
+        : "Interrupt response received.";
+}
 function normalizeOptions(options) {
     return (options ?? []).flatMap((option) => {
         if (typeof option === "string") {
@@ -343,7 +374,7 @@ function interruptDetails(request, outcome) {
 function finishedResult(request, outcome) {
     return {
         outcome,
-        content: [{ type: "text", text: envelopeText(outcome) }],
+        content: [{ type: "text", text: formatInteractionOutcome(outcome) }],
         details: interruptDetails(request, outcome),
     };
 }
@@ -351,7 +382,7 @@ function awaitingUserResult(request, _toolCallId) {
     const outcome = { type: "awaiting_user" };
     return {
         outcome,
-        content: [{ type: "text", text: envelopeText(outcome) }],
+        content: [{ type: "text", text: formatInteractionOutcome(outcome) }],
         details: interruptDetails(request, outcome),
     };
 }