@ouro.bot/cli 0.1.0-alpha.12 → 0.1.0-alpha.14

package/dist/heart/config.js

@@ -35,7 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadConfig = loadConfig;
 exports.resetConfigCache = resetConfigCache;
-exports.setTestConfig = setTestConfig;
+exports.patchRuntimeConfig = patchRuntimeConfig;
 exports.getAzureConfig = getAzureConfig;
 exports.getMinimaxConfig = getMinimaxConfig;
 exports.getAnthropicConfig = getAnthropicConfig;
@@ -233,7 +233,7 @@ function resetConfigCache() {
     _cachedConfig = null;
     _testContextOverride = null;
 }
-function setTestConfig(partial) {
+function patchRuntimeConfig(partial) {
     loadConfig(); // ensure _cachedConfig exists
     const contextPatch = partial.context;
     if (contextPatch) {

package/dist/heart/core.js

@@ -278,7 +278,7 @@ async function runAgent(messages, callbacks, channel, signal, options) {
     }
     catch { /* unsupported */ }
     const toolPreferences = currentContext?.friend?.toolPreferences;
-    const baseTools = (0, tools_1.getToolsForChannel)(channel ? (0, channel_1.getChannelCapabilities)(channel) : undefined, toolPreferences && Object.keys(toolPreferences).length > 0 ? toolPreferences : undefined);
+    const baseTools = options?.tools ?? (0, tools_1.getToolsForChannel)(channel ? (0, channel_1.getChannelCapabilities)(channel) : undefined, toolPreferences && Object.keys(toolPreferences).length > 0 ? toolPreferences : undefined);
     // Rebase provider-owned turn state from canonical messages at user-turn start.
     // This prevents stale provider caches from replaying prior-turn context.
     providerRuntime.resetTurnState(messages);
@@ -444,7 +444,8 @@ async function runAgent(messages, callbacks, channel, signal, options) {
                     let toolResult;
                     let success;
                     try {
-                        toolResult = await (0, tools_1.execTool)(tc.name, args, options?.toolContext);
+                        const execToolFn = options?.execTool ?? tools_1.execTool;
+                        toolResult = await execToolFn(tc.name, args, options?.toolContext);
                         success = true;
                     }
                     catch (e) {

package/dist/heart/daemon/daemon-cli.js

@@ -52,6 +52,8 @@ const ouro_path_installer_1 = require("./ouro-path-installer");
 const subagent_installer_1 = require("./subagent-installer");
 const hatch_flow_1 = require("./hatch-flow");
 const specialist_orchestrator_1 = require("./specialist-orchestrator");
+const specialist_prompt_1 = require("./specialist-prompt");
+const specialist_tools_1 = require("./specialist-tools");
 function stringField(value) {
     return typeof value === "string" ? value : null;
 }
@@ -647,11 +649,13 @@ function discoverExistingCredentials(secretsRoot) {
         return true;
     });
 }
-/* v8 ignore next 95 -- integration: interactive terminal specialist session @preserve */
+/* v8 ignore start -- integration: interactive terminal specialist session @preserve */
 async function defaultRunAdoptionSpecialist() {
-    const readlineModule = await Promise.resolve().then(() => __importStar(require("readline")));
+    const { runCliSession } = await Promise.resolve().then(() => __importStar(require("../../senses/cli")));
+    const { patchRuntimeConfig } = await Promise.resolve().then(() => __importStar(require("../config")));
+    const { setAgentName } = await Promise.resolve().then(() => __importStar(require("../identity")));
     const readlinePromises = await Promise.resolve().then(() => __importStar(require("readline/promises")));
-    const { createCliCallbacks, InputController } = await Promise.resolve().then(() => __importStar(require("../../senses/cli")));
+    const crypto = await Promise.resolve().then(() => __importStar(require("crypto")));
     // Phase 1: cold CLI — collect provider/credentials with a simple readline
     const coldRl = readlinePromises.createInterface({ input: process.stdin, output: process.stdout });
     const coldPrompt = async (q) => {
@@ -660,11 +664,12 @@ async function defaultRunAdoptionSpecialist() {
     };
     let providerRaw;
     let credentials = {};
+    const tempDir = path.join(os.tmpdir(), `ouro-hatch-${crypto.randomUUID()}`);
     try {
         const secretsRoot = path.join(os.homedir(), ".agentsecrets");
         const discovered = discoverExistingCredentials(secretsRoot);
         if (discovered.length > 0) {
-            process.stdout.write("\n🐍 welcome to ouro! let's hatch your first agent.\n");
+            process.stdout.write("\n\ud83d\udc0d welcome to ouro! let's hatch your first agent.\n");
             process.stdout.write("i found existing API credentials:\n\n");
             const unique = [...new Map(discovered.map((d) => [`${d.provider}`, d])).values()];
             for (let i = 0; i < unique.length; i++) {
@@ -699,7 +704,7 @@ async function defaultRunAdoptionSpecialist() {
             }
         }
         else {
-            process.stdout.write("\n🐍 welcome to ouro! let's hatch your first agent.\n");
+            process.stdout.write("\n\ud83d\udc0d welcome to ouro! let's hatch your first agent.\n");
             process.stdout.write("i need an API key to power our conversation.\n\n");
             const pRaw = await coldPrompt("provider (anthropic/azure/minimax/openai-codex): ");
             if (!isAgentProvider(pRaw)) {
@@ -722,34 +727,72 @@ async function defaultRunAdoptionSpecialist() {
         }
         coldRl.close();
         process.stdout.write("\n");
-        // Phase 2: warm specialist session — full CLI experience with markdown, spinners, input control
+        // Phase 2: configure runtime for adoption specialist
         const bundleSourceDir = path.resolve(__dirname, "..", "..", "..", "AdoptionSpecialist.ouro");
         const bundlesRoot = (0, identity_1.getAgentBundlesRoot)();
-        const cliCallbacks = createCliCallbacks();
-        return await (0, specialist_orchestrator_1.runAdoptionSpecialist)({
-            bundleSourceDir,
-            bundlesRoot,
-            secretsRoot,
+        const secretsRoot2 = path.join(os.homedir(), ".agentsecrets");
+        // Configure provider credentials in runtime config
+        patchRuntimeConfig({
+            providers: {
+                [providerRaw]: credentials,
+            },
+        });
+        setAgentName("AdoptionSpecialist");
+        // Build specialist system prompt
+        const soulText = (0, specialist_orchestrator_1.loadSoulText)(bundleSourceDir);
+        const identitiesDir = path.join(bundleSourceDir, "psyche", "identities");
+        const identity = (0, specialist_orchestrator_1.pickRandomIdentity)(identitiesDir);
+        const existingBundles = (0, specialist_orchestrator_1.listExistingBundles)(bundlesRoot);
+        const systemPrompt = (0, specialist_prompt_1.buildSpecialistSystemPrompt)(soulText, identity.content, existingBundles, {
+            tempDir,
             provider: providerRaw,
+        });
+        // Build specialist tools
+        const specialistTools = (0, specialist_tools_1.getSpecialistTools)();
+        const specialistExecTool = (0, specialist_tools_1.createSpecialistExecTool)({
+            tempDir,
             credentials,
-            humanName: os.userInfo().username,
-            createReadline: () => {
-                const rl2 = readlineModule.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
-                const ctrl = new InputController(rl2);
-                return {
-                    question: (q) => new Promise((resolve) => rl2.question(q, resolve)),
-                    close: () => rl2.close(),
-                    inputController: ctrl,
-                };
-            },
-            callbacks: cliCallbacks,
+            provider: providerRaw,
+            bundlesRoot,
+            secretsRoot: secretsRoot2,
+            animationWriter: (text) => process.stdout.write(text),
         });
+        // Run the adoption specialist session via runCliSession
+        const result = await runCliSession({
+            agentName: "AdoptionSpecialist",
+            tools: specialistTools,
+            execTool: specialistExecTool,
+            exitOnToolCall: "complete_adoption",
+            messages: [
+                { role: "system", content: systemPrompt },
+                { role: "user", content: "hi" },
+            ],
+        });
+        if (result.exitReason === "tool_exit" && result.toolResult) {
+            const parsed = typeof result.toolResult === "string" ? JSON.parse(result.toolResult) : result.toolResult;
+            if (parsed.success && parsed.agentName) {
+                return parsed.agentName;
+            }
+        }
+        return null;
     }
     catch {
         coldRl.close();
         return null;
     }
+    finally {
+        // Clean up temp dir if it still exists
+        try {
+            if (fs.existsSync(tempDir)) {
+                fs.rmSync(tempDir, { recursive: true, force: true });
+            }
+        }
+        catch {
+            // Best effort cleanup
+        }
+    }
 }
+/* v8 ignore stop */
 function createDefaultOuroCliDeps(socketPath = "/tmp/ouroboros-daemon.sock") {
     return {
         socketPath,

package/dist/heart/daemon/hatch-flow.js

@@ -207,15 +207,6 @@ function writeFriendImprint(bundleRoot, humanName, now) {
     };
     fs.writeFileSync(path.join(friendsDir, `${id}.json`), `${JSON.stringify(record, null, 2)}\n`, "utf-8");
 }
-function writeHatchlingPsyche(bundleRoot, input, identityFileName) {
-    const psycheDir = path.join(bundleRoot, "psyche");
-    fs.mkdirSync(psycheDir, { recursive: true });
-    fs.writeFileSync(path.join(psycheDir, "SOUL.md"), "# SOUL\n\nI am a practical, collaborative agent. I keep commitments and communicate clearly.\n", "utf-8");
-    fs.writeFileSync(path.join(psycheDir, "IDENTITY.md"), `# IDENTITY\n\nI'm ${input.agentName}, newly hatched and ready to help ${input.humanName}.`, "utf-8");
-    fs.writeFileSync(path.join(psycheDir, "LORE.md"), `# LORE\n\nHatched with specialist identity seed: ${identityFileName}.`, "utf-8");
-    fs.writeFileSync(path.join(psycheDir, "TACIT.md"), "# TACIT\n\n- Save what I learn.\n- Keep tasks current.\n", "utf-8");
-    fs.writeFileSync(path.join(psycheDir, "ASPIRATIONS.md"), "# ASPIRATIONS\n\n- Become a reliable partner for my primary friend.\n", "utf-8");
-}
 function writeMemoryScaffold(bundleRoot) {
     const memoryRoot = path.join(bundleRoot, "psyche", "memory");
     fs.mkdirSync(path.join(memoryRoot, "daily"), { recursive: true });
@@ -267,7 +258,6 @@ async function runHatchFlow(input, deps = {}) {
     writeReadme(path.join(bundleRoot, "senses"), "Sense-specific config.");
     writeReadme(path.join(bundleRoot, "senses", "teams"), "Teams sense config.");
     writeHatchlingAgentConfig(bundleRoot, input);
-    writeHatchlingPsyche(bundleRoot, input, selected.fileName);
     writeMemoryScaffold(bundleRoot);
     writeFriendImprint(bundleRoot, input.humanName, now);
     writeHeartbeatTask(bundleRoot, now);

package/dist/heart/daemon/ouro-path-installer.js

@@ -39,7 +39,7 @@ const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../../nerves/runtime");
 const WRAPPER_SCRIPT = `#!/bin/sh
-exec npx --yes @ouro.bot/cli@latest "$@"
+exec npx --yes ouro.bot "$@"
 `;
 function detectShellProfile(homeDir, shell) {
     if (!shell)
@@ -96,15 +96,31 @@ function installOuroCommand(deps = {}) {
         message: "installing ouro command to PATH",
         meta: { scriptPath, binDir },
     });
-    // If ouro already exists somewhere in PATH, skip
+    // If ouro already exists, check content and repair if stale
     if (existsSync(scriptPath)) {
+        let existingContent = "";
+        try {
+            existingContent = readFileSync(scriptPath, "utf-8");
+        }
+        catch {
+            // Can't read — treat as stale, will overwrite below
+        }
+        if (existingContent === WRAPPER_SCRIPT) {
+            (0, runtime_1.emitNervesEvent)({
+                component: "daemon",
+                event: "daemon.ouro_path_install_skip",
+                message: "ouro command already installed",
+                meta: { scriptPath },
+            });
+            return { installed: false, scriptPath, pathReady: isBinDirInPath(binDir, envPath), shellProfileUpdated: null, skippedReason: "already-installed" };
+        }
+        // Content is stale — repair by overwriting
         (0, runtime_1.emitNervesEvent)({
             component: "daemon",
-            event: "daemon.ouro_path_install_skip",
-            message: "ouro command already installed",
+            event: "daemon.ouro_path_install_repair",
+            message: "repairing stale ouro wrapper script",
             meta: { scriptPath },
         });
-        return { installed: false, scriptPath, pathReady: isBinDirInPath(binDir, envPath), shellProfileUpdated: null, skippedReason: "already-installed" };
     }
     try {
         mkdirSync(binDir, { recursive: true });

package/dist/heart/daemon/ouro-uti.js

@@ -42,7 +42,13 @@ const identity_1 = require("../identity");
 const runtime_1 = require("../../nerves/runtime");
 const LSREGISTER_PATH = "/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister";
 const ICON_SIZES = [16, 32, 128, 256, 512];
-function resolveIconSourcePath(repoRoot) {
+function resolveIconSourcePath(repoRoot, existsSync) {
+    // Prefer bundled asset (shipped with npm package)
+    const bundledPath = path.resolve(repoRoot, "assets", "ouroboros.png");
+    if (existsSync(bundledPath)) {
+        return bundledPath;
+    }
+    // Fall back to adjacent repo path (dev environment)
     return path.resolve(repoRoot, "..", "ouroboros-website", "public", "images", "ouroboros.png");
 }
 function buildIconAsset(iconSourcePath, icnsPath, iconsetDir, deps) {
@@ -91,6 +97,7 @@ function buildInfoPlist(iconInstalled) {
         "      <key>UTTypeConformsTo</key>",
         "      <array>",
         "        <string>public.folder</string>",
+        "        <string>com.apple.package</string>",
         "      </array>",
         "      <key>UTTypeTagSpecification</key>",
         "      <dict>",
@@ -112,6 +119,8 @@ function buildInfoPlist(iconInstalled) {
         "      </array>",
         "      <key>CFBundleTypeRole</key>",
         "      <string>Editor</string>",
+        "      <key>LSTypeIsPackage</key>",
+        "      <true/>",
         `      ${iconTag.trim()}`,
         "    </dict>",
         "  </array>",
@@ -152,7 +161,7 @@ function registerOuroBundleUti(deps = {}) {
     const plistPath = path.join(contentsDir, "Info.plist");
     const icnsPath = path.join(resourcesDir, "ouro.icns");
     const iconsetDir = path.join(supportRoot, "ouro.iconset");
-    const iconSourcePath = resolveIconSourcePath(repoRoot);
+    const iconSourcePath = resolveIconSourcePath(repoRoot, existsSync);
     (0, runtime_1.emitNervesEvent)({
         component: "daemon",
         event: "daemon.ouro_uti_register_start",

package/dist/heart/daemon/specialist-orchestrator.js

@@ -33,17 +33,17 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runAdoptionSpecialist = runAdoptionSpecialist;
+exports.listExistingBundles = listExistingBundles;
+exports.loadIdentityPhrases = loadIdentityPhrases;
+exports.pickRandomIdentity = pickRandomIdentity;
+exports.loadSoulText = loadSoulText;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../../nerves/runtime");
 const identity_1 = require("../identity");
-const config_1 = require("../config");
-const core_1 = require("../core");
-const hatch_flow_1 = require("./hatch-flow");
-const specialist_prompt_1 = require("./specialist-prompt");
-const specialist_tools_1 = require("./specialist-tools");
-const specialist_session_1 = require("./specialist-session");
+/**
+ * List existing .ouro bundles in the given directory.
+ */
 function listExistingBundles(bundlesRoot) {
     let entries;
     try {
@@ -61,6 +61,10 @@ function listExistingBundles(bundlesRoot) {
     }
     return discovered.sort((a, b) => a.localeCompare(b));
 }
+/**
+ * Load identity-specific phrases from the specialist's agent.json.
+ * Falls back to DEFAULT_AGENT_PHRASES if not found.
+ */
 function loadIdentityPhrases(bundleSourceDir, identityFileName) {
     const agentJsonPath = path.join(bundleSourceDir, "agent.json");
     try {
@@ -76,111 +80,50 @@ function loadIdentityPhrases(bundleSourceDir, identityFileName) {
         }
     }
     catch {
-        // agent.json missing or malformed — fall through
+        // agent.json missing or malformed -- fall through
     }
     return { ...identity_1.DEFAULT_AGENT_PHRASES };
 }
-function pickRandomIdentity(identitiesDir, random) {
-    const files = fs.readdirSync(identitiesDir).filter((f) => f.endsWith(".md"));
-    if (files.length === 0) {
-        return { fileName: "default", content: "I am the adoption specialist." };
-    }
-    const idx = Math.floor(random() * files.length);
-    const fileName = files[idx];
-    const content = fs.readFileSync(path.join(identitiesDir, fileName), "utf-8");
-    return { fileName, content };
-}
 /**
- * Run the full adoption specialist flow:
- * 1. Pick a random identity from the bundled AdoptionSpecialist.ouro
- * 2. Read SOUL.md
- * 3. List existing bundles
- * 4. Build system prompt
- * 5. Set up provider (setAgentName, setAgentConfigOverride, writeSecretsFile, reset caches)
- * 6. Run the specialist session
- * 7. Clean up identity/config overrides
- * 8. Return hatchling name
+ * Pick a random identity from the specialist's identities directory.
  */
-async function runAdoptionSpecialist(deps) {
-    const { bundleSourceDir, bundlesRoot, secretsRoot, provider, credentials, humanName, callbacks, signal } = deps;
-    const random = deps.random ?? Math.random;
+function pickRandomIdentity(identitiesDir, random = Math.random) {
     (0, runtime_1.emitNervesEvent)({
         component: "daemon",
-        event: "daemon.specialist_orchestrator_start",
-        message: "starting adoption specialist orchestrator",
-        meta: { provider, bundleSourceDir },
+        event: "daemon.specialist_identity_pick",
+        message: "picking specialist identity",
+        meta: { identitiesDir },
     });
-    // 1. Read SOUL.md
-    const soulPath = path.join(bundleSourceDir, "psyche", "SOUL.md");
-    let soulText = "";
+    let files;
     try {
-        soulText = fs.readFileSync(soulPath, "utf-8");
+        files = fs.readdirSync(identitiesDir).filter((f) => f.endsWith(".md"));
     }
     catch {
-        // No SOUL.md -- proceed without it
+        return { fileName: "default", content: "I am the adoption specialist." };
     }
-    // 2. Pick random identity
-    const identitiesDir = path.join(bundleSourceDir, "psyche", "identities");
-    const identity = pickRandomIdentity(identitiesDir, random);
+    if (files.length === 0) {
+        return { fileName: "default", content: "I am the adoption specialist." };
+    }
+    const idx = Math.floor(random() * files.length);
+    const fileName = files[idx];
+    const content = fs.readFileSync(path.join(identitiesDir, fileName), "utf-8");
     (0, runtime_1.emitNervesEvent)({
         component: "daemon",
         event: "daemon.specialist_identity_picked",
         message: "picked specialist identity",
-        meta: { identity: identity.fileName },
-    });
-    // 3. List existing bundles
-    const existingBundles = listExistingBundles(bundlesRoot);
-    // 4. Build system prompt
-    const systemPrompt = (0, specialist_prompt_1.buildSpecialistSystemPrompt)(soulText, identity.content, existingBundles);
-    // 5. Set up provider with identity-specific phrases
-    const phrases = loadIdentityPhrases(bundleSourceDir, identity.fileName);
-    (0, identity_1.setAgentName)("AdoptionSpecialist");
-    (0, identity_1.setAgentConfigOverride)({
-        version: 1,
-        enabled: true,
-        provider,
-        phrases,
+        meta: { identity: fileName },
     });
-    (0, hatch_flow_1.writeSecretsFile)("AdoptionSpecialist", provider, credentials, secretsRoot);
-    (0, config_1.resetConfigCache)();
-    (0, core_1.resetProviderRuntime)();
+    return { fileName, content };
+}
+/**
+ * Read SOUL.md from the specialist bundle.
+ */
+function loadSoulText(bundleSourceDir) {
+    const soulPath = path.join(bundleSourceDir, "psyche", "SOUL.md");
     try {
-        // Create provider runtime
-        const providerRuntime = (0, core_1.createProviderRegistry)().resolve();
-        if (!providerRuntime) {
-            throw new Error("Failed to create provider runtime for adoption specialist");
-        }
-        // 6. Run session
-        const tools = (0, specialist_tools_1.getSpecialistTools)();
-        const readline = deps.createReadline();
-        const ctrl = readline.inputController;
-        const result = await (0, specialist_session_1.runSpecialistSession)({
-            providerRuntime,
-            systemPrompt,
-            tools,
-            execTool: (name, args) => (0, specialist_tools_1.execSpecialistTool)(name, args, {
-                humanName,
-                provider,
-                credentials,
-                bundlesRoot,
-                secretsRoot,
-                specialistIdentitiesDir: identitiesDir,
-            }),
-            readline,
-            callbacks,
-            signal,
-            kickoffMessage: "hi, i just ran ouro for the first time",
-            suppressInput: ctrl ? (onInterrupt) => ctrl.suppress(onInterrupt) : undefined,
-            restoreInput: ctrl ? () => ctrl.restore() : undefined,
-            flushMarkdown: callbacks.flushMarkdown,
-            writePrompt: ctrl ? () => process.stdout.write("\x1b[36m> \x1b[0m") : undefined,
-        });
-        return result.hatchedAgentName;
+        return fs.readFileSync(soulPath, "utf-8");
     }
-    finally {
-        // 7. Cleanup: restore identity/config state
-        (0, identity_1.setAgentConfigOverride)(null);
-        (0, config_1.resetConfigCache)();
-        (0, core_1.resetProviderRuntime)();
+    catch {
+        return "";
     }
 }

package/dist/heart/daemon/specialist-prompt.js

@@ -6,12 +6,12 @@ const runtime_1 = require("../../nerves/runtime");
  * Build the adoption specialist's system prompt from its components.
  * The prompt is written in first person (the specialist's own voice).
  */
-function buildSpecialistSystemPrompt(soulText, identityText, existingBundles) {
+function buildSpecialistSystemPrompt(soulText, identityText, existingBundles, context) {
     (0, runtime_1.emitNervesEvent)({
         component: "daemon",
         event: "daemon.specialist_prompt_build",
         message: "building specialist system prompt",
-        meta: { bundleCount: existingBundles.length },
+        meta: { bundleCount: existingBundles.length, provider: context.provider },
     });
     const sections = [];
     if (soulText) {
@@ -37,7 +37,37 @@ function buildSpecialistSystemPrompt(soulText, identityText, existingBundles) {
         "I NEVER use headers, bullet lists, numbered lists, or markdown formatting.",
         "I ask ONE question at a time. I do not dump multiple questions or options.",
         "I am warm but brief. Every word earns its place.",
+    ].join("\n"));
+    sections.push([
+        "## System context",
+        `Provider: ${context.provider}`,
+        `Temp directory: ${context.tempDir}`,
+        "Final home: ~/AgentBundles/<Name>.ouro/",
+        "Secrets: ~/.agentsecrets/<name>/secrets.json",
+    ].join("\n"));
+    sections.push([
+        "## Bundle creation guidelines",
+        "A bundle has a psyche/ directory with 5 files that define the agent's personality:",
+        "",
+        "- **SOUL.md** — core values, personality traits, communication style",
+        "- **IDENTITY.md** — who the agent is, its name, relationship to the human",
+        "- **LORE.md** — backstory, origin, any seed narrative",
+        "- **TACIT.md** — implicit operating principles, habits to develop",
+        "- **ASPIRATIONS.md** — goals, what the agent aspires to become",
+        "",
+        "It also needs an **agent.json** with at minimum:",
+        '```json',
+        '{',
+        '  "name": "AgentName",',
+        `  "provider": "${context.provider}",`,
+        '  "enabled": true',
+        '}',
+        '```',
         "",
+        "All psyche files should be written in first person (the agent's own voice).",
+        "Write these files to the temp directory using write_file before calling complete_adoption.",
+    ].join("\n"));
+    sections.push([
         "## Conversation flow",
         "The human just connected. I speak first — I greet them warmly and introduce myself in my own voice.",
         "I briefly mention that I'm one of several adoption specialists and they got me today.",
@@ -45,15 +75,20 @@ function buildSpecialistSystemPrompt(soulText, identityText, existingBundles) {
         "Then I ask what they'd like their agent to help with — one question at a time.",
         "I'm proactive: I suggest ideas and guide them. If they seem unsure, I offer a concrete suggestion.",
         "I don't wait for the human to figure things out — I explain simply what an agent is if needed.",
-        "When I have enough context, I suggest a name for the hatchling and confirm with the human.",
-        "Then I call `hatch_agent` with the agent name and the human's name.",
-        "",
+        "When I have enough context about the agent's personality and purpose:",
+        "1. I write all 5 psyche files to the temp directory using write_file",
+        "2. I write agent.json to the temp directory using write_file",
+        "3. I suggest a PascalCase name for the hatchling and confirm with the human",
+        "4. I call complete_adoption with the name and a warm handoff message",
+        "5. I call final_answer to end the session",
+    ].join("\n"));
+    sections.push([
         "## Tools",
-        "I have these tools available:",
-        "- `hatch_agent`: Create a new agent bundle. I call this with `name` (the agent name, PascalCase) and `humanName` (what the human told me their name is).",
-        "- `final_answer`: End the conversation with a final message to the human. I call this when the adoption process is complete.",
+        "- `write_file`: Write a file to disk. Use this to write psyche files and agent.json to the temp directory.",
         "- `read_file`: Read a file from disk. Useful for reviewing existing agent bundles or migration sources.",
         "- `list_directory`: List directory contents. Useful for exploring existing agent bundles.",
+        "- `complete_adoption`: Finalize the bundle. Validates, scaffolds structural dirs, moves to ~/AgentBundles/, writes secrets, plays hatch animation. I call this with `name` (PascalCase) and `handoff_message` (warm message for the human).",
+        "- `final_answer`: End the conversation with a final message. I call this after complete_adoption succeeds.",
         "",
         "I must call `final_answer` when I am done to end the session cleanly.",
     ].join("\n"));