@introspection-ai/recipes 0.13.0

package/dist/child-agent-completions.js

@@ -0,0 +1,135 @@
+/**
+ * Child agent-run completion queue.
+ *
+ * When a background child run settles as `completed`/`failed`, the extension
+ * enqueues an envelope here. The registered deliverer — wired up in
+ * `pi-extension.ts` — drains the queue into a parent-waking custom message
+ * (`pi.sendMessage(..., { triggerTurn: true })`) once the parent session is
+ * idle; while the parent is mid-turn the deliverer holds the queue and
+ * retries shortly after the `agent_end` boundary poke (a message queued
+ * during the turn teardown itself would be stranded on current pi releases).
+ *
+ * Successes batch briefly so N parallel children produce one notice;
+ * failures flush immediately. Runs whose terminal output the model already
+ * saw synchronously (`action:"wait"` or a terminal `status` read) are
+ * acknowledged out of the queue so nothing is delivered
+ * twice.
+ */
+/** Batching window for successful completions. Failures skip it. */
+export const COMPLETION_BATCH_WINDOW_MS = 2_000;
+/** Cap on inline output previews; full output stays in status.json. */
+export const OUTPUT_PREVIEW_CHARS = 4_000;
+export function envelopeFromRun(run) {
+    if (run.status !== "completed" && run.status !== "failed")
+        return null;
+    const started = Date.parse(run.startedAt);
+    const completed = run.completedAt ? Date.parse(run.completedAt) : NaN;
+    const duration = Number.isFinite(started) && Number.isFinite(completed) && completed >= started
+        ? completed - started
+        : undefined;
+    return {
+        id: run.id,
+        agent: run.agent,
+        label: run.label,
+        status: run.status,
+        output_preview: run.output?.slice(0, OUTPUT_PREVIEW_CHARS),
+        error: run.error,
+        duration_ms: duration,
+    };
+}
+/**
+ * Model-facing notice. The `<agent_run_completions>` wrapper marks it as a
+ * runtime notification rather than user input.
+ */
+export function renderCompletionNotice(batch) {
+    const blocks = batch.map((envelope) => {
+        const label = envelope.label ? ` — ${envelope.label}` : "";
+        const header = `[${envelope.agent}] (${envelope.id})${label} [${envelope.status}]`;
+        const body = envelope.status === "failed"
+            ? `Agent failed: ${envelope.error ?? "unknown error"}`
+            : envelope.output_preview?.trim() || "(no output)";
+        return `${header}\n${body}`;
+    });
+    return [
+        "<agent_run_completions>",
+        'The following background agent run(s) finished. This is a runtime notification, not a user message. Review the results, continue the task, and reply to the user with anything they need to know. Use the agent tool with action "status" and the run id for full output.',
+        "",
+        blocks.join("\n\n"),
+        "</agent_run_completions>",
+    ].join("\n");
+}
+export class ChildCompletionQueue {
+    pending = [];
+    deliverer = null;
+    flushTimer = null;
+    deliveryScheduled = false;
+    setDeliverer(deliverer) {
+        this.deliverer = deliverer;
+        if (deliverer && this.pending.length > 0)
+            this.flushNow();
+    }
+    enqueue(envelope) {
+        this.pending.push(envelope);
+        if (envelope.status === "failed") {
+            this.flushNow();
+            return;
+        }
+        if (!this.flushTimer) {
+            this.flushTimer = setTimeout(() => this.flushNow(), COMPLETION_BATCH_WINDOW_MS);
+            this.flushTimer.unref?.();
+        }
+    }
+    /**
+     * Re-attempt delivery of anything still queued (no-op when empty). Called
+     * at the `agent_end` settle boundary: a batch held mid-turn delivers here,
+     * bypassing any open batch window.
+     */
+    poke() {
+        if (this.pending.length === 0)
+            return;
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.deliverer?.();
+    }
+    /**
+     * Drop queued envelopes whose terminal output the model just saw
+     * synchronously (wait or terminal status read).
+     */
+    acknowledge(ids) {
+        if (ids.length === 0 || this.pending.length === 0)
+            return;
+        const acknowledged = new Set(ids);
+        this.pending = this.pending.filter((envelope) => !acknowledged.has(envelope.id));
+    }
+    hasPending() {
+        return this.pending.length > 0;
+    }
+    consumeBatch() {
+        if (this.pending.length === 0)
+            return [];
+        return this.pending.splice(0);
+    }
+    clear() {
+        this.pending = [];
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+    flushNow() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        if (this.deliveryScheduled)
+            return;
+        this.deliveryScheduled = true;
+        queueMicrotask(() => {
+            this.deliveryScheduled = false;
+            this.deliverer?.();
+        });
+    }
+}
+//# sourceMappingURL=child-agent-completions.js.map

package/dist/child-agent-completions.js.map

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

package/dist/child-agent-store.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Filesystem persistence for background agent runs.
+ *
+ * Each run owns `<workspace>/.pi/agents/<runId>/status.json` — a rolling
+ * snapshot of the run state. Snapshots let a later Pi process in the same
+ * workspace rehydrate
+ * run ids referenced by a resumed conversation: rehydrated runs are readable
+ * (status/wait) but not controllable, and a run persisted as `running` died
+ * with the previous process, so it is flipped to `interrupted` on rehydrate
+ * rather than silently "resumed".
+ */
+export type ChildRunStatus = "running" | "completed" | "failed" | "interrupted";
+export type ChildToolStatus = "running" | "completed" | "failed";
+export interface ChildToolActivity {
+    id: string;
+    name: string;
+    args: unknown;
+    status: ChildToolStatus;
+    startedAt: string;
+    completedAt?: string;
+    output?: string;
+    error?: string;
+}
+export interface ChildRunSnapshot {
+    id: string;
+    agent: string;
+    label?: string;
+    prompt: string;
+    status: ChildRunStatus;
+    startedAt: string;
+    completedAt?: string;
+    output?: string;
+    error?: string;
+    toolCalls: ChildToolActivity[];
+}
+export declare class ChildAgentRunStore {
+    private readonly root;
+    private readonly pendingWrites;
+    constructor(workspaceDir: string);
+    writeStatus(snapshot: ChildRunSnapshot): Promise<void>;
+    /**
+     * Status snapshots persisted by any prior process for this workspace, one
+     * per `.pi/agents/<runId>/status.json`. Unreadable or malformed entries are
+     * skipped — rehydration is best-effort.
+     */
+    readPersistedSnapshots(): Promise<ChildRunSnapshot[]>;
+}
+//# sourceMappingURL=child-agent-store.d.ts.map

package/dist/child-agent-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-agent-store.d.ts","sourceRoot":"","sources":["../src/child-agent-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAChF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAoCD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAG9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;gBAEtD,YAAY,EAAE,MAAM;IAI1B,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB5D;;;;OAIG;IACG,sBAAsB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAwB5D"}

package/dist/child-agent-store.js

@@ -0,0 +1,98 @@
+/**
+ * Filesystem persistence for background agent runs.
+ *
+ * Each run owns `<workspace>/.pi/agents/<runId>/status.json` — a rolling
+ * snapshot of the run state. Snapshots let a later Pi process in the same
+ * workspace rehydrate
+ * run ids referenced by a resumed conversation: rehydrated runs are readable
+ * (status/wait) but not controllable, and a run persisted as `running` died
+ * with the previous process, so it is flipped to `interrupted` on rehydrate
+ * rather than silently "resumed".
+ */
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const RUN_STATUSES = [
+    "running",
+    "completed",
+    "failed",
+    "interrupted",
+];
+function normalizeChildRunSnapshot(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const original = value;
+    const prompt = typeof original.prompt === "string"
+        ? original.prompt
+        : typeof original.task === "string"
+            ? original.task
+            : undefined;
+    const record = { ...original, prompt };
+    delete record.task;
+    if (!(typeof record.id === "string" &&
+        typeof record.agent === "string" &&
+        typeof record.prompt === "string" &&
+        typeof record.status === "string" &&
+        RUN_STATUSES.includes(record.status) &&
+        typeof record.startedAt === "string" &&
+        Array.isArray(record.toolCalls))) {
+        return null;
+    }
+    return record;
+}
+export class ChildAgentRunStore {
+    root;
+    // Concurrent writes to one status.json interleave (each truncates on open),
+    // so snapshot writes for a run are chained behind the previous one.
+    pendingWrites = new Map();
+    constructor(workspaceDir) {
+        this.root = join(workspaceDir, ".pi", "agents");
+    }
+    async writeStatus(snapshot) {
+        const previous = this.pendingWrites.get(snapshot.id) ?? Promise.resolve();
+        const write = previous
+            .catch(() => { })
+            .then(async () => {
+            const runDir = join(this.root, snapshot.id);
+            await mkdir(runDir, { recursive: true });
+            await writeFile(join(runDir, "status.json"), `${JSON.stringify(snapshot, null, 2)}\n`, "utf8");
+        });
+        this.pendingWrites.set(snapshot.id, write);
+        try {
+            await write;
+        }
+        finally {
+            if (this.pendingWrites.get(snapshot.id) === write) {
+                this.pendingWrites.delete(snapshot.id);
+            }
+        }
+    }
+    /**
+     * Status snapshots persisted by any prior process for this workspace, one
+     * per `.pi/agents/<runId>/status.json`. Unreadable or malformed entries are
+     * skipped — rehydration is best-effort.
+     */
+    async readPersistedSnapshots() {
+        let runIds;
+        try {
+            runIds = await readdir(this.root);
+        }
+        catch {
+            return [];
+        }
+        const snapshots = [];
+        for (const runId of runIds) {
+            try {
+                const raw = await readFile(join(this.root, runId, "status.json"), "utf8");
+                const parsed = normalizeChildRunSnapshot(JSON.parse(raw));
+                if (parsed?.id === runId) {
+                    snapshots.push(parsed);
+                }
+            }
+            catch {
+                // skip unreadable runs
+            }
+        }
+        return snapshots;
+    }
+}
+//# sourceMappingURL=child-agent-store.js.map

package/dist/child-agent-store.js.map

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

package/dist/child-agent.d.ts

@@ -0,0 +1,43 @@
+import { type CredentialStore } from "@earendil-works/pi-ai";
+import { type ModelRegistry, ModelRuntime } from "@earendil-works/pi-coding-agent";
+export interface CreateRecipeChildAgentRunnerOptions {
+    recipeDir: string;
+    workspaceDir: string;
+    agentName: string;
+    env?: NodeJS.ProcessEnv;
+    credentials?: CredentialStore;
+    modelRuntime?: ModelRuntime;
+    modelRegistry?: ModelRegistry;
+    onAssistantMessage?: (text: string, stream: "delta" | "final") => void;
+    onToolEvent?: (event: RecipeChildToolEvent) => void;
+}
+export interface RecipeChildAgentRunner {
+    start(): Promise<void>;
+    prompt(prompt: string): Promise<string>;
+    steer(message: string): Promise<void>;
+    cancel(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export type CreateRecipeChildAgentRunner = (opts: CreateRecipeChildAgentRunnerOptions) => RecipeChildAgentRunner;
+export type RecipeChildToolEvent = {
+    type: "start";
+    id: string;
+    name: string;
+    args: unknown;
+} | {
+    type: "update";
+    id: string;
+    name: string;
+    args: unknown;
+    partialResult: unknown;
+} | {
+    type: "end";
+    id: string;
+    name: string;
+    args: unknown;
+    result: unknown;
+    isError: boolean;
+};
+export declare function promptResultText(result: unknown): string;
+export declare function createRecipeChildAgentRunner(opts: CreateRecipeChildAgentRunnerOptions): RecipeChildAgentRunner;
+//# sourceMappingURL=child-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"child-agent.d.ts","sourceRoot":"","sources":["../src/child-agent.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEtF,OAAO,EAGL,KAAK,aAAa,EAClB,YAAY,EAKb,MAAM,iCAAiC,CAAC;AAsBzC,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC;IACvE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,MAAM,4BAA4B,GAAG,CACzC,IAAI,EAAE,mCAAmC,KACtC,sBAAsB,CAAC;AAE5B,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;CACxB,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAgGN,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAcxD;AAmMD,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,mCAAmC,GACxC,sBAAsB,CAExB"}

package/dist/child-agent.js

@@ -0,0 +1,268 @@
+import { getEnvApiKey, getModel } from "@earendil-works/pi-ai/compat";
+import { InMemoryCredentialStore } from "@earendil-works/pi-ai";
+import { createAgentSessionFromServices, createAgentSessionServices, ModelRuntime, SessionManager, SettingsManager, } from "@earendil-works/pi-coding-agent";
+import { autoResolveInteractions } from "./interactions.js";
+import { loadRecipeSystemPrompt, REQUIRED_RECIPE_AGENT_FIELDS, resolveRecipeAgentDefinition, validateResolvedRecipeAgentDefinition, } from "./recipe-agent.js";
+import { packageResourcePaths, readPiPackageManifest, } from "./recipe-package.js";
+import { resolveAgentSkillPaths } from "./recipe-skills.js";
+import { applyRecipeAgentModelConfigToModel, applyRecipeAgentModelConfigToSession, } from "./recipe-model.js";
+import { executableRecipeToolNames, } from "./mcp.js";
+function parseModelSpec(spec) {
+    const slash = spec.indexOf("/");
+    if (slash < 0) {
+        throw new Error(`Invalid recipe model "${spec}" - expected "<provider>/<model_id>"`);
+    }
+    const provider = spec.slice(0, slash);
+    const modelId = spec.slice(slash + 1);
+    const lookupProvider = provider === "gemini" ? "google" : provider;
+    return { provider, modelId, lookupProvider };
+}
+function modelFromSpec(spec, modelRegistry) {
+    const { modelId, lookupProvider } = parseModelSpec(spec);
+    return (modelRegistry?.find(lookupProvider, modelId) ??
+        getModel(lookupProvider, modelId));
+}
+async function modelRuntimeForChildAgent(model, opts) {
+    if (opts.modelRuntime)
+        return opts.modelRuntime;
+    const credentials = opts.credentials ?? new InMemoryCredentialStore();
+    if (!opts.credentials) {
+        // Resolve the child's API key up front: prefer the host registry (so a
+        // key configured inside Pi flows to children), then provider env keys.
+        let apiKey;
+        let credentialEnv;
+        if (opts.modelRegistry) {
+            const auth = await opts.modelRegistry.getApiKeyAndHeaders(model);
+            if (auth.ok) {
+                apiKey = auth.apiKey;
+                credentialEnv = auth.env;
+                if (auth.headers) {
+                    model.headers = { ...(model.headers ?? {}), ...auth.headers };
+                }
+            }
+        }
+        const env = opts.env ?? process.env;
+        apiKey ??=
+            getEnvApiKey(model.provider) ??
+                env[`${model.provider.toUpperCase()}_API_KEY`];
+        if (!apiKey && Object.keys(model.headers ?? {}).length === 0) {
+            throw new Error(`${model.provider.toUpperCase()}_API_KEY is required when the background agent is not running inside Pi`);
+        }
+        await credentials.modify(model.provider, async () => ({
+            type: "api_key",
+            ...(apiKey ? { key: apiKey } : {}),
+            ...(credentialEnv ? { env: credentialEnv } : {}),
+        }));
+    }
+    return ModelRuntime.create({ credentials, modelsPath: null });
+}
+function applySystemInstructions(base, instructions) {
+    if (!instructions)
+        return base;
+    if (instructions.mode === "replace")
+        return instructions.content;
+    return [base, instructions.content].filter(Boolean).join("\n\n");
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function contentText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((part) => {
+        const record = asRecord(part);
+        return record?.type === "text" && typeof record.text === "string"
+            ? record.text
+            : "";
+    })
+        .filter(Boolean)
+        .join("\n");
+}
+export function promptResultText(result) {
+    if (typeof result === "string")
+        return result;
+    if (!result || typeof result !== "object")
+        return "";
+    const record = result;
+    if (typeof record.output === "string")
+        return record.output;
+    const messages = Array.isArray(record.messages) ? record.messages : [];
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = asRecord(messages[index]);
+        if (!message)
+            continue;
+        if (message.role && message.role !== "assistant")
+            continue;
+        const text = contentText(message.content).trim();
+        if (text)
+            return text;
+    }
+    return "";
+}
+function messageFromEvent(event) {
+    const record = asRecord(event);
+    const direct = asRecord(record?.message);
+    if (direct)
+        return direct;
+    const assistantEvent = asRecord(record?.assistantMessageEvent);
+    return asRecord(assistantEvent?.partial);
+}
+class RecipeChildAgentSessionRunner {
+    opts;
+    session = null;
+    unsubscribe = null;
+    assistantStreamedText = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    emitAssistantText(text, stream) {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return;
+        this.opts.onAssistantMessage?.(trimmed, stream);
+        if (stream === "delta")
+            this.assistantStreamedText = true;
+    }
+    handleSessionEvent(event) {
+        const record = asRecord(event);
+        const message = messageFromEvent(event);
+        const role = typeof message?.role === "string" ? message.role : undefined;
+        if (record?.type === "tool_execution_start") {
+            this.opts.onToolEvent?.({
+                type: "start",
+                id: String(record.toolCallId ?? ""),
+                name: String(record.toolName ?? ""),
+                args: record.args,
+            });
+            return;
+        }
+        if (record?.type === "tool_execution_update") {
+            this.opts.onToolEvent?.({
+                type: "update",
+                id: String(record.toolCallId ?? ""),
+                name: String(record.toolName ?? ""),
+                args: record.args,
+                partialResult: record.partialResult,
+            });
+            return;
+        }
+        if (record?.type === "tool_execution_end") {
+            this.opts.onToolEvent?.({
+                type: "end",
+                id: String(record.toolCallId ?? ""),
+                name: String(record.toolName ?? ""),
+                args: record.args,
+                result: record.result,
+                isError: record.isError === true,
+            });
+            return;
+        }
+        if (record?.type === "message_start" && role === "assistant") {
+            this.assistantStreamedText = false;
+        }
+        const assistantEvent = asRecord(record?.assistantMessageEvent);
+        if (role === "assistant" &&
+            record?.type === "message_update" &&
+            assistantEvent?.type === "text_delta" &&
+            typeof assistantEvent.delta === "string") {
+            this.emitAssistantText(assistantEvent.delta, "delta");
+            return;
+        }
+        if (role === "assistant" &&
+            record?.type === "message_end" &&
+            !this.assistantStreamedText) {
+            this.emitAssistantText(contentText(message?.content), "final");
+        }
+    }
+    async start() {
+        if (this.session)
+            return;
+        const { agentName, agent } = resolveRecipeAgentDefinition({
+            recipeDir: this.opts.recipeDir,
+            agentName: this.opts.agentName,
+        });
+        if (!agent) {
+            throw new Error(`Agent not found: ${agentName}`);
+        }
+        const validationFindings = validateResolvedRecipeAgentDefinition({
+            recipeDir: this.opts.recipeDir,
+            agentName,
+            requireExplicitName: true,
+            requiredFields: REQUIRED_RECIPE_AGENT_FIELDS,
+        });
+        const validationErrors = validationFindings.filter((finding) => finding.severity !== "warning");
+        if (validationErrors.length > 0) {
+            throw new Error(validationErrors.map((finding) => finding.message).join("\n"));
+        }
+        const modelSpec = agent.model?.name;
+        if (!modelSpec) {
+            throw new Error(`Agent "${agentName}" must declare model.name`);
+        }
+        const model = applyRecipeAgentModelConfigToModel(modelFromSpec(modelSpec, this.opts.modelRegistry), agent.modelConfig);
+        const modelRuntime = await modelRuntimeForChildAgent(model, this.opts);
+        const services = await createAgentSessionServices({
+            cwd: this.opts.workspaceDir,
+            agentDir: this.opts.recipeDir,
+            modelRuntime,
+            settingsManager: SettingsManager.create(this.opts.workspaceDir, this.opts.recipeDir),
+            resourceLoaderOptions: {
+                noSkills: true,
+                additionalSkillPaths: resolveAgentSkillPaths(this.opts.recipeDir, packageResourcePaths(readPiPackageManifest(this.opts.recipeDir), "skills"), agent.skills),
+                systemPromptOverride: (base) => applySystemInstructions(loadRecipeSystemPrompt(this.opts.recipeDir) ?? base, agent.systemInstructions),
+            },
+        });
+        // Delegated recipe agents are intentionally one level deep. An agent
+        // selected as the root session gets the dynamic `agent` tool from the
+        // extension, while the same definition running as a child never does.
+        const executableTools = executableRecipeToolNames(agent.tools).filter((tool) => tool !== "agent");
+        const created = await createAgentSessionFromServices({
+            services,
+            sessionManager: SessionManager.inMemory(this.opts.workspaceDir),
+            model,
+            ...(agent.model?.thinkingLevel
+                ? { thinkingLevel: agent.model.thinkingLevel }
+                : {}),
+            tools: executableTools,
+        });
+        this.session = created.session;
+        applyRecipeAgentModelConfigToSession(this.session, agent.modelConfig);
+        await this.session.bindExtensions({});
+        this.unsubscribe = this.session.subscribe((event) => {
+            this.handleSessionEvent(event);
+        });
+    }
+    async prompt(prompt) {
+        await this.start();
+        if (!this.session)
+            throw new Error("Background agent did not start");
+        // Child sessions do not own the root session's interaction lifecycle.
+        // Resolve their approval tools internally so they cannot open UI or emit
+        // an interrupt that would strand the child waiting for the root user.
+        await autoResolveInteractions(() => this.session.prompt(prompt));
+        return promptResultText({ messages: [...this.session.messages] });
+    }
+    async steer(message) {
+        await this.start();
+        if (!this.session)
+            throw new Error("Background agent did not start");
+        await this.session.steer(message);
+    }
+    async cancel() {
+        await this.session?.abort();
+    }
+    async shutdown() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        this.session?.dispose();
+        this.session = null;
+    }
+}
+export function createRecipeChildAgentRunner(opts) {
+    return new RecipeChildAgentSessionRunner(opts);
+}
+//# sourceMappingURL=child-agent.js.map

package/dist/child-agent.js.map

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

package/dist/direct-cli.d.ts

@@ -0,0 +1,9 @@
+/**
+ * True when the current process was launched with the given module as its
+ * entry script. Compares realpaths: package-manager bin shims and
+ * node_modules symlinks (pnpm) hand us a symlinked argv[1] while
+ * import.meta.url is the real path, so naive equality would silently skip
+ * the CLI main. Callers pass their own `import.meta.url`.
+ */
+export declare function isDirectEntry(moduleUrl: string, entry?: string): boolean;
+//# sourceMappingURL=direct-cli.d.ts.map

package/dist/direct-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-cli.d.ts","sourceRoot":"","sources":["../src/direct-cli.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,SAAkB,GACtB,OAAO,CAST"}