@introspection-ai/recipes 0.13.0

package/dist/session.js

@@ -0,0 +1,363 @@
+import { randomUUID } from "node:crypto";
+import { InMemoryCredentialStore } from "@earendil-works/pi-ai";
+import { getEnvApiKey, getModel } from "@earendil-works/pi-ai/compat";
+import { createAgentSessionFromServices, createAgentSessionServices, ModelRuntime, SessionManager, SettingsManager, } from "@earendil-works/pi-coding-agent";
+import { instrumentSession, } from "@introspection-sdk/introspection-pi";
+import { createAgentTool } from "./agent-tool.js";
+import { clearMcpCatalogPreload, preloadMcpCatalogs, } from "./mcp-catalog.js";
+import { configureMcpLocalConfigPath, isolateMcpEnvironment, materializeMcpSession, materializeSessionMcpCli, restoreMcpEnvironment, resolveAgentMcpSelections, snapshotMcpEnvironment, stopMcpDaemon, } from "./mcp.js";
+import { expectedProviderEnvVars } from "./provider-env.js";
+import { loadRecipeExtensionFactory } from "./recipe-extensions.js";
+import { applyRecipeAgentModelConfigToModel, applyRecipeAgentModelConfigToSession, } from "./recipe-model.js";
+import { resolveRecipe } from "./recipe/resolve.js";
+export { expectedProviderEnvVars } from "./provider-env.js";
+/** The session model's provider has no resolvable credential. */
+export class RecipeCredentialError extends Error {
+    provider;
+    expectedEnvVars;
+    name = "RecipeCredentialError";
+    constructor(provider, 
+    /** Env vars that would satisfy the provider, most conventional first. */
+    expectedEnvVars) {
+        super(`No credential for model provider "${provider}": set ${expectedEnvVars.join(" or ")}, or pass a CredentialStore via credentials`);
+        this.provider = provider;
+        this.expectedEnvVars = expectedEnvVars;
+    }
+}
+/** The recipe's model spec does not resolve to a known model. */
+export class RecipeModelError extends Error {
+    modelSpec;
+    name = "RecipeModelError";
+    constructor(modelSpec) {
+        super(`Recipe model is not available: ${modelSpec}`);
+        this.modelSpec = modelSpec;
+    }
+}
+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 };
+}
+/**
+ * Ambient-credential providers resolve from their own SDK chain (AWS
+ * profiles, ADC); `getEnvApiKey` reports them as "<authenticated>".
+ */
+const AMBIENT_CREDENTIAL_SENTINEL = "<authenticated>";
+/**
+ * Resolve credentials fail-closed against the session's own `env`, never the
+ * ambient process env: explicit store → per-provider env keys → error.
+ */
+async function resolveCredentialStore(lookupProvider, opts) {
+    if (opts.credentials) {
+        const stored = await opts.credentials.read(lookupProvider);
+        if (!stored) {
+            throw new RecipeCredentialError(lookupProvider, expectedProviderEnvVars(lookupProvider));
+        }
+        return opts.credentials;
+    }
+    const env = opts.env ?? process.env;
+    const store = new InMemoryCredentialStore();
+    const apiKey = getEnvApiKey(lookupProvider, env) ??
+        env[`${lookupProvider.toUpperCase().replace(/-/g, "_")}_API_KEY`];
+    if (!apiKey) {
+        throw new RecipeCredentialError(lookupProvider, expectedProviderEnvVars(lookupProvider));
+    }
+    if (apiKey !== AMBIENT_CREDENTIAL_SENTINEL) {
+        await store.modify(lookupProvider, async () => ({
+            type: "api_key",
+            key: apiKey,
+        }));
+    }
+    // Ambient-credential providers (Bedrock, Vertex ADC) keep an empty store;
+    // the pi-ai provider resolves its own credential chain at stream time.
+    return store;
+}
+function scopedMcpSelections(recipe) {
+    return [recipe.agent, ...recipe.subagents.values()].flatMap((agent) => resolveAgentMcpSelections(agent.mcp));
+}
+const leasedMcpEnvironments = new WeakSet();
+export class RecipeMcpEnvironmentInUseError extends Error {
+    name = "RecipeMcpEnvironmentInUseError";
+    constructor() {
+        super("This environment already belongs to a live materialized Recipe MCP session; use a separate env object per concurrent session or let the host materialize MCP once and pass mcpMode: \"inherit\"");
+    }
+}
+/**
+ * Everything `createRecipeSession` fail-closes on, without creating a
+ * session or starting MCP: recipe resolution, model lookup, credentials.
+ * Hosts with a boot phase (the serve layer) run this once to fail fast.
+ */
+export async function preflightRecipeSession(opts) {
+    const recipe = resolveRecipe({
+        recipeDir: opts.recipeDir,
+        ...(opts.agentName ? { agentName: opts.agentName } : {}),
+    });
+    const modelSpec = opts.model ?? recipe.modelSpec;
+    const { lookupProvider, modelId } = parseModelSpec(modelSpec);
+    const credentialProvider = opts.modelOverride?.provider ?? lookupProvider;
+    const credentials = await resolveCredentialStore(credentialProvider, opts);
+    const modelRuntime = await ModelRuntime.create({
+        credentials,
+        modelsPath: null,
+    });
+    const model = opts.modelOverride ??
+        modelRuntime.getModel(lookupProvider, modelId) ??
+        getModel(lookupProvider, modelId);
+    if (!model) {
+        throw new RecipeModelError(modelSpec);
+    }
+    return recipe;
+}
+/**
+ * Materialize the session MCP runtime for a recipe scope into `env` at
+ * `cwd`. Exposed for hosts that materialize once per process (the serve
+ * layer) and create their sessions with `mcpMode: "inherit"`.
+ */
+export async function materializeRecipeSessionMcp(recipe, cwd, env, opts = {}) {
+    return configureSessionMcp(recipe, cwd, env, {
+        recipeDir: recipe.recipeDir,
+        ...opts,
+    }, false);
+}
+async function configureSessionMcp(recipe, cwd, env, opts, leaseEnvironment) {
+    const selections = scopedMcpSelections(recipe);
+    if (opts.mcpMode === "inherit")
+        return { materialized: false };
+    if (selections.length === 0)
+        return { materialized: false };
+    const snapshot = leaseEnvironment ? snapshotMcpEnvironment(env) : undefined;
+    if (leaseEnvironment) {
+        if (leasedMcpEnvironments.has(env)) {
+            throw new RecipeMcpEnvironmentInUseError();
+        }
+        leasedMcpEnvironments.add(env);
+        isolateMcpEnvironment(env);
+    }
+    const release = async () => {
+        if (!snapshot)
+            return;
+        try {
+            clearMcpCatalogPreload(env);
+            await stopMcpDaemon(env);
+        }
+        finally {
+            restoreMcpEnvironment(env, snapshot);
+            leasedMcpEnvironments.delete(env);
+        }
+    };
+    try {
+        if (opts.mcpBindingsPath) {
+            env.PI_RECIPES_MCP_LOCAL_CONFIG = opts.mcpBindingsPath;
+        }
+        else if (!opts.mcpBindings) {
+            configureMcpLocalConfigPath({ cwd, recipeDir: recipe.recipeDir, env });
+        }
+        const [cliResult, sessionResult] = await Promise.allSettled([
+            materializeSessionMcpCli({ cwd, env }),
+            materializeMcpSession({
+                cwd,
+                manifest: recipe.manifest,
+                agentMcp: selections,
+                env,
+                ...(opts.mcpBindings ? { localConfig: opts.mcpBindings } : {}),
+            }),
+        ]);
+        if (cliResult.status === "rejected")
+            throw cliResult.reason;
+        if (sessionResult.status === "rejected")
+            throw sessionResult.reason;
+        const session = sessionResult.value;
+        if (session.servers.length > 0) {
+            // Warm tool catalogs in the background; sessions work without the warmup.
+            void preloadMcpCatalogs({ env }).catch(() => { });
+        }
+        return {
+            materialized: true,
+            ...(snapshot ? { release } : {}),
+        };
+    }
+    catch (error) {
+        await release();
+        throw error;
+    }
+}
+export async function createRecipeSession(opts) {
+    const recipe = resolveRecipe({
+        recipeDir: opts.recipeDir,
+        ...(opts.agentName ? { agentName: opts.agentName } : {}),
+    });
+    const cwd = opts.cwd ?? process.cwd();
+    const env = opts.env ?? process.env;
+    const otel = opts.otel
+        ? {
+            ...opts.otel,
+            meta: {
+                conversationId: opts.otel.meta?.conversationId ?? randomUUID(),
+                agentId: opts.otel.meta?.agentId ??
+                    `${recipe.manifest.name}/${recipe.agentName}`,
+                agentName: opts.otel.meta?.agentName ?? recipe.agentName,
+            },
+        }
+        : undefined;
+    // Model + credentials, fail-closed before any MCP runtime starts.
+    const modelSpec = opts.model ?? recipe.modelSpec;
+    const { lookupProvider, modelId } = parseModelSpec(modelSpec);
+    const credentialProvider = opts.modelOverride?.provider ?? lookupProvider;
+    const credentials = await resolveCredentialStore(credentialProvider, opts);
+    const modelRuntime = await ModelRuntime.create({ credentials, modelsPath: null });
+    const model = opts.modelOverride ??
+        modelRuntime.getModel(lookupProvider, modelId) ??
+        getModel(lookupProvider, modelId);
+    if (!model) {
+        throw new RecipeModelError(modelSpec);
+    }
+    applyRecipeAgentModelConfigToModel(model, recipe.modelConfig);
+    const mcp = await configureSessionMcp(recipe, cwd, env, opts, true);
+    let session;
+    let runs;
+    let unsubscribe;
+    let detachInstrumentation;
+    const cleanup = async () => {
+        try {
+            unsubscribe?.();
+        }
+        catch {
+            // Continue releasing the remaining session-owned resources.
+        }
+        unsubscribe = undefined;
+        if (runs) {
+            try {
+                for (const run of runs.list()) {
+                    if (run.status !== "closed") {
+                        await runs.close(run.agent_run_id).catch(() => { });
+                    }
+                }
+            }
+            catch {
+                // Child teardown is best-effort; the session still disposes.
+            }
+        }
+        if (session) {
+            try {
+                await session.abort();
+            }
+            catch {
+                // An idle session has nothing to abort.
+            }
+            try {
+                session.dispose();
+            }
+            catch {
+                // Continue releasing instrumentation and MCP state.
+            }
+            session = undefined;
+        }
+        try {
+            detachInstrumentation?.();
+        }
+        catch {
+            // Continue releasing MCP state.
+        }
+        detachInstrumentation = undefined;
+        await mcp.release?.();
+    };
+    try {
+        // Recipe extensions load through the shared jiti loader; host extensions
+        // append after them, matching the Pi extension host's ordering.
+        const inlineExtensions = [];
+        for (const extensionPath of recipe.extensionPaths) {
+            inlineExtensions.push(await loadRecipeExtensionFactory(recipe.recipeDir, extensionPath));
+        }
+        inlineExtensions.push(...(opts.extensionFactories ?? []));
+        const services = await createAgentSessionServices({
+            cwd,
+            agentDir: recipe.recipeDir,
+            modelRuntime,
+            settingsManager: opts.settingsManager ?? SettingsManager.create(cwd, recipe.recipeDir),
+            resourceLoaderOptions: {
+                eventBus: opts.eventBus,
+                noSkills: true,
+                additionalSkillPaths: [
+                    ...(opts.skillPaths ?? recipe.skillPaths),
+                    ...(opts.additionalSkillPaths ?? []),
+                ],
+                additionalPromptTemplatePaths: recipe.promptPaths,
+                extensionFactories: inlineExtensions,
+                systemPromptOverride: (base) => {
+                    const resolved = recipe.systemPromptOverride(base);
+                    return opts.systemPrompt ? opts.systemPrompt(resolved ?? "") : resolved;
+                },
+            },
+        });
+        opts.onDiagnostics?.(services.diagnostics);
+        // Subagents: the shared `agent` tool against an injected or in-process
+        // controller. `runController: null` disables delegation outright.
+        const wantsSubagents = recipe.subagents.size > 0 && opts.runController !== null;
+        if (opts.runController) {
+            runs = opts.runController;
+        }
+        else {
+            const { createInProcessRunController, inertRunController } = await import("./run-controller.js");
+            runs = wantsSubagents
+                ? createInProcessRunController({
+                    recipeDir: recipe.recipeDir,
+                    cwd,
+                    env,
+                    ...(opts.credentials ? { credentials: opts.credentials } : {}),
+                    concurrency: opts.subagentLimits?.concurrency,
+                    ...(otel ? { otel } : {}),
+                })
+                : inertRunController();
+        }
+        const tools = wantsSubagents
+            ? recipe.tools
+            : recipe.tools.filter((tool) => tool !== "agent");
+        const customTools = [
+            ...(opts.customTools ?? []),
+            ...(wantsSubagents
+                ? [createAgentTool(runs, recipe.subagents, opts.agentToolOptions)]
+                : []),
+        ];
+        const created = await createAgentSessionFromServices({
+            services,
+            sessionManager: opts.sessionManager ?? SessionManager.inMemory(cwd),
+            model,
+            ...(opts.thinkingLevel ?? recipe.thinkingLevel
+                ? { thinkingLevel: (opts.thinkingLevel ?? recipe.thinkingLevel) }
+                : {}),
+            tools,
+            customTools,
+        });
+        session = created.session;
+        applyRecipeAgentModelConfigToSession(session, recipe.modelConfig);
+        await session.bindExtensions({});
+        unsubscribe = opts.onEvent ? session.subscribe(opts.onEvent) : undefined;
+        detachInstrumentation = otel
+            ? instrumentSession(session, otel).detach
+            : undefined;
+        const liveSession = session;
+        const liveRuns = runs;
+        let disposed = false;
+        return {
+            session: liveSession,
+            recipe,
+            runs: liveRuns,
+            async dispose() {
+                if (disposed)
+                    return;
+                disposed = true;
+                await cleanup();
+            },
+        };
+    }
+    catch (error) {
+        await cleanup();
+        throw error;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/test-utils.d.ts

@@ -0,0 +1,32 @@
+import type { CreateRecipeSessionOptions, RecipeSessionHandle } from "./session.js";
+export interface RecipeEngineHostAdapter {
+    /**
+     * Create a session the way the host's runtime does — through its own
+     * engine invocation, with the host's default injections applied. The
+     * options here layer the suite's fixture on top.
+     */
+    createSession(options: CreateRecipeSessionOptions): Promise<RecipeSessionHandle>;
+}
+export interface HostConformanceCase {
+    name: string;
+    run(): Promise<void>;
+}
+interface FixtureOptions {
+    agentExtras?: string[];
+    manifestPi?: Record<string, unknown>;
+    subagents?: string[];
+}
+/** Write a minimal recipe package into a fresh temp dir. */
+export declare function writeFixtureRecipe(options?: FixtureOptions): {
+    recipeDir: string;
+    workspaceDir: string;
+    cleanup(): void;
+};
+export declare function hostConformanceCases(host: RecipeEngineHostAdapter): HostConformanceCase[];
+/**
+ * A process env for fixtures: PATH and platform basics without provider
+ * keys, so credential-resolution cases are deterministic.
+ */
+export declare function cleanEnv(): NodeJS.ProcessEnv;
+export {};
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,aAAa,CACX,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,cAAmB,GAAG;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CACjB,CAuDA;AA2BD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,uBAAuB,GAC5B,mBAAmB,EAAE,CA+KvB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAAC,UAAU,CAO5C"}

package/dist/test-utils.js

@@ -0,0 +1,259 @@
+/**
+ * Host conformance suite for the recipe engine.
+ *
+ * A host that adopts `createRecipeSession` with its own injected pieces —
+ * credential store, synthesized MCP bindings, run controller — runs these
+ * cases in its own CI. Passing the suite is what "supported host" means: the
+ * engine's contract cannot drift from its consumers silently.
+ *
+ * The cases are runner-agnostic: each is a `{ name, run }` pair that throws
+ * on failure. In vitest:
+ *
+ * ```ts
+ * import { hostConformanceCases } from "@introspection-ai/recipes/test-utils";
+ * for (const c of hostConformanceCases(myHostAdapter)) it(c.name, c.run);
+ * ```
+ */
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { InMemoryCredentialStore } from "@earendil-works/pi-ai";
+/** Write a minimal recipe package into a fresh temp dir. */
+export function writeFixtureRecipe(options = {}) {
+    const root = mkdtempSync(join(tmpdir(), "recipe-conformance-"));
+    const recipeDir = join(root, "recipe");
+    const workspaceDir = join(root, "workspace");
+    mkdirSync(join(recipeDir, "agents"), { recursive: true });
+    mkdirSync(workspaceDir, { recursive: true });
+    writeFileSync(join(recipeDir, "package.json"), JSON.stringify({
+        name: "conformance-fixture",
+        version: "0.1.0",
+        type: "module",
+        pi: { agents: ["agents/*.yaml"], ...(options.manifestPi ?? {}) },
+    }));
+    writeFileSync(join(recipeDir, "SYSTEM.md"), "You are a conformance fixture.\n");
+    writeFileSync(join(recipeDir, "agents", "agent.yaml"), [
+        "name: agent",
+        "model:",
+        "  name: anthropic/claude-sonnet-4-5",
+        "  thinking_level: low",
+        "tools: [read]",
+        ...(options.subagents?.length
+            ? ["subagents:", ...options.subagents.map((name) => `  - ${name}`)]
+            : []),
+        "system_instructions:",
+        "  mode: append",
+        "  content: Conformance agent",
+        ...(options.agentExtras ?? []),
+        "",
+    ].join("\n"));
+    for (const name of options.subagents ?? []) {
+        writeFileSync(join(recipeDir, "agents", `${name}.yaml`), [
+            `name: ${name}`,
+            "model:",
+            "  name: anthropic/claude-sonnet-4-5",
+            "  thinking_level: low",
+            "tools: [read]",
+            "system_instructions:",
+            "  mode: append",
+            `  content: Subagent ${name}`,
+            "",
+        ].join("\n"));
+    }
+    return {
+        recipeDir,
+        workspaceDir,
+        cleanup: () => rmSync(root, { recursive: true, force: true }),
+    };
+}
+function assert(condition, message) {
+    if (!condition)
+        throw new Error(`Conformance failure: ${message}`);
+}
+async function expectRejection(promise, message) {
+    try {
+        await promise;
+    }
+    catch (err) {
+        return err instanceof Error ? err : new Error(String(err));
+    }
+    throw new Error(`Conformance failure: expected rejection — ${message}`);
+}
+async function testCredentialStore() {
+    const store = new InMemoryCredentialStore();
+    await store.modify("anthropic", async () => ({
+        type: "api_key",
+        key: "conformance-test-key",
+    }));
+    return store;
+}
+export function hostConformanceCases(host) {
+    return [
+        {
+            name: "constructs a session from a resolved recipe with an injected credential store",
+            async run() {
+                const fixture = writeFixtureRecipe();
+                try {
+                    const handle = await host.createSession({
+                        recipeDir: fixture.recipeDir,
+                        cwd: fixture.workspaceDir,
+                        credentials: await testCredentialStore(),
+                        env: { ...cleanEnv() },
+                    });
+                    try {
+                        assert(handle.recipe.agentName === "agent", "agentName resolves");
+                        assert(handle.session.systemPrompt.includes("conformance fixture"), "SYSTEM.md reaches the system prompt");
+                        assert(handle.runs, "handle exposes a run controller");
+                    }
+                    finally {
+                        await handle.dispose();
+                    }
+                }
+                finally {
+                    fixture.cleanup();
+                }
+            },
+        },
+        {
+            name: "fails closed when the model provider has no credential",
+            async run() {
+                const fixture = writeFixtureRecipe();
+                try {
+                    const err = await expectRejection(host.createSession({
+                        recipeDir: fixture.recipeDir,
+                        cwd: fixture.workspaceDir,
+                        env: { ...cleanEnv() },
+                    }), "session construction without credentials");
+                    assert(/ANTHROPIC_API_KEY/.test(err.message), `error names the expected env var (got: ${err.message})`);
+                }
+                finally {
+                    fixture.cleanup();
+                }
+            },
+        },
+        {
+            name: "fails closed on an unbound required MCP server",
+            async run() {
+                const fixture = writeFixtureRecipe({
+                    manifestPi: {
+                        mcp: {
+                            servers: [
+                                { id: "linear", required: true, tools: { include: ["*"] } },
+                            ],
+                        },
+                    },
+                    agentExtras: ["mcp:", "  linear:", '    include: ["*"]'],
+                });
+                try {
+                    const err = await expectRejection(host.createSession({
+                        recipeDir: fixture.recipeDir,
+                        cwd: fixture.workspaceDir,
+                        credentials: await testCredentialStore(),
+                        env: { ...cleanEnv() },
+                    }), "session construction with an unbound required MCP server");
+                    assert(err.message.includes("linear"), `error names the unbound server (got: ${err.message})`);
+                }
+                finally {
+                    fixture.cleanup();
+                }
+            },
+        },
+        {
+            name: "materializes inline MCP bindings without a local config file",
+            async run() {
+                const fixture = writeFixtureRecipe({
+                    manifestPi: {
+                        mcp: {
+                            servers: [
+                                { id: "linear", required: true, tools: { include: ["*"] } },
+                            ],
+                        },
+                    },
+                    agentExtras: ["mcp:", "  linear:", '    include: ["*"]'],
+                });
+                try {
+                    const env = { ...cleanEnv() };
+                    const handle = await host.createSession({
+                        recipeDir: fixture.recipeDir,
+                        cwd: fixture.workspaceDir,
+                        credentials: await testCredentialStore(),
+                        env,
+                        mcpBindings: {
+                            servers: [
+                                {
+                                    id: "linear",
+                                    transport: "streamable_http",
+                                    url: "http://127.0.0.1:9/mcp",
+                                },
+                            ],
+                        },
+                    });
+                    await handle.dispose();
+                }
+                finally {
+                    fixture.cleanup();
+                }
+            },
+        },
+        {
+            name: "errors, never wedges, when a subagent profile does not exist",
+            async run() {
+                const fixture = writeFixtureRecipe({ subagents: ["helper"] });
+                try {
+                    const handle = await host.createSession({
+                        recipeDir: fixture.recipeDir,
+                        cwd: fixture.workspaceDir,
+                        credentials: await testCredentialStore(),
+                        env: { ...cleanEnv() },
+                    });
+                    try {
+                        const settled = await Promise.race([
+                            (async () => {
+                                try {
+                                    const run = await handle.runs.start({
+                                        name: "ghost",
+                                        prompt: "hello",
+                                    });
+                                    if (run.status === "running") {
+                                        return await handle.runs.wait(run.agent_run_id);
+                                    }
+                                    return run;
+                                }
+                                catch (err) {
+                                    // A controller may reject the start outright; that is a
+                                    // valid non-wedging behavior.
+                                    return {
+                                        status: "failed",
+                                        error: err instanceof Error ? err.message : String(err),
+                                    };
+                                }
+                            })(),
+                            new Promise((_, reject) => setTimeout(() => reject(new Error("Conformance failure: ghost subagent start wedged (no settlement in 15s)")), 15_000)),
+                        ]);
+                        assert(settled.status === "failed", `ghost run settles as failed (got: ${settled.status})`);
+                    }
+                    finally {
+                        await handle.dispose();
+                    }
+                }
+                finally {
+                    fixture.cleanup();
+                }
+            },
+        },
+    ];
+}
+/**
+ * A process env for fixtures: PATH and platform basics without provider
+ * keys, so credential-resolution cases are deterministic.
+ */
+export function cleanEnv() {
+    const keep = ["PATH", "HOME", "TMPDIR", "SHELL", "SystemRoot", "TEMP", "TMP"];
+    const env = {};
+    for (const key of keep) {
+        if (process.env[key] !== undefined)
+            env[key] = process.env[key];
+    }
+    return env;
+}
+//# sourceMappingURL=test-utils.js.map