@ouro.bot/cli 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/heart/daemon/log-tailer.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverLogFiles = discoverLogFiles;
+exports.readLastLines = readLastLines;
+exports.formatLogLine = formatLogLine;
+exports.tailLogs = tailLogs;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const nerves_1 = require("../../nerves");
+const runtime_1 = require("../../nerves/runtime");
+const LEVEL_COLORS = {
+    debug: "\x1b[2m",
+    info: "\x1b[36m",
+    warn: "\x1b[33m",
+    error: "\x1b[31m",
+};
+function discoverLogFiles(options) {
+    /* v8 ignore start -- integration: default DI stubs for real OS @preserve */
+    const homeDir = options.homeDir ?? os.homedir();
+    const existsSync = options.existsSync ?? (() => false);
+    const readdirSync = options.readdirSync ?? (() => []);
+    /* v8 ignore stop */
+    const logDir = path.join(homeDir, ".agentstate", "daemon", "logs");
+    const files = [];
+    if (existsSync(logDir)) {
+        for (const name of readdirSync(logDir)) {
+            if (!name.endsWith(".ndjson"))
+                continue;
+            if (options.agentFilter && !name.includes(options.agentFilter))
+                continue;
+            files.push(path.join(logDir, name));
+        }
+    }
+    return files.sort();
+}
+function readLastLines(filePath, count, readFileSync) {
+    let content;
+    try {
+        content = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return [];
+    }
+    const lines = content.split("\n").filter((l) => l.trim().length > 0);
+    return lines.slice(-count);
+}
+function formatLogLine(ndjsonLine) {
+    try {
+        const entry = JSON.parse(ndjsonLine);
+        const formatted = (0, nerves_1.formatTerminalEntry)(entry);
+        const color = LEVEL_COLORS[entry.level] ?? "";
+        return `${color}${formatted}\x1b[0m`;
+    }
+    catch {
+        return ndjsonLine;
+    }
+}
+function tailLogs(options = {}) {
+    /* v8 ignore start -- integration: default DI stubs for real OS @preserve */
+    const writer = options.writer ?? ((text) => process.stdout.write(text));
+    const lineCount = options.lines ?? 20;
+    const readFileSync = options.readFileSync ?? (() => "");
+    /* v8 ignore stop */
+    const watchFile = options.watchFile;
+    const unwatchFile = options.unwatchFile;
+    const files = discoverLogFiles(options);
+    (0, runtime_1.emitNervesEvent)({ component: "daemon", event: "daemon.log_tailer_started", message: "log tailer started", meta: { fileCount: files.length, follow: !!options.follow } });
+    const fileSizes = new Map();
+    // Read initial lines
+    for (const file of files) {
+        const lines = readLastLines(file, lineCount, readFileSync);
+        for (const line of lines) {
+            writer(`${formatLogLine(line)}\n`);
+        }
+        try {
+            const content = readFileSync(file, "utf-8");
+            fileSizes.set(file, content.length);
+        }
+        catch {
+            fileSizes.set(file, 0);
+        }
+    }
+    // Follow mode
+    if (options.follow && watchFile && unwatchFile) {
+        for (const file of files) {
+            watchFile(file, () => {
+                let content;
+                try {
+                    content = readFileSync(file, "utf-8");
+                }
+                catch {
+                    return;
+                }
+                /* v8 ignore next -- defensive: fileSizes always populated above @preserve */
+                const prevSize = fileSizes.get(file) ?? 0;
+                if (content.length <= prevSize)
+                    return;
+                fileSizes.set(file, content.length);
+                const newContent = content.slice(prevSize);
+                const newLines = newContent.split("\n").filter((l) => l.trim().length > 0);
+                for (const line of newLines) {
+                    writer(`${formatLogLine(line)}\n`);
+                }
+            });
+        }
+        return () => {
+            for (const file of files) {
+                unwatchFile(file);
+            }
+        };
+    }
+    return () => { };
+}

package/dist/heart/daemon/os-cron.js

@@ -0,0 +1,260 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrontabCronManager = exports.LaunchdCronManager = void 0;
+exports.createOsCronManager = createOsCronManager;
+exports.cadenceToSeconds = cadenceToSeconds;
+exports.scheduleToCalendarInterval = scheduleToCalendarInterval;
+exports.generatePlistXml = generatePlistXml;
+exports.plistLabel = plistLabel;
+exports.crontabLine = crontabLine;
+const os = __importStar(require("os"));
+const runtime_1 = require("../../nerves/runtime");
+const PLIST_PREFIX = "bot.ouro.";
+function plistLabel(job) {
+    return `${PLIST_PREFIX}${job.agent}.${job.taskId}`;
+}
+function cadenceToSeconds(schedule) {
+    const parts = schedule.trim().split(/\s+/);
+    if (parts.length !== 5)
+        return null;
+    const [minute, hour, day, month, weekday] = parts;
+    // Simple interval patterns only
+    if (month !== "*" || weekday !== "*" || day !== "*")
+        return null;
+    const everyNMinutes = /^\*\/(\d+)$/.exec(minute);
+    if (everyNMinutes && hour === "*") {
+        return parseInt(everyNMinutes[1], 10) * 60;
+    }
+    const everyNHours = /^\*\/(\d+)$/.exec(hour);
+    if (everyNHours && minute === "0") {
+        return parseInt(everyNHours[1], 10) * 3600;
+    }
+    return null;
+}
+function scheduleToCalendarInterval(schedule) {
+    const parts = schedule.trim().split(/\s+/);
+    if (parts.length !== 5)
+        return null;
+    const [minute, hour, day, month] = parts;
+    const result = {};
+    if (minute !== "*" && !/^\*\//.test(minute))
+        result.Minute = parseInt(minute, 10);
+    if (hour !== "*" && !/^\*\//.test(hour))
+        result.Hour = parseInt(hour, 10);
+    if (day !== "*")
+        result.Day = parseInt(day, 10);
+    if (month !== "*")
+        result.Month = parseInt(month, 10);
+    return Object.keys(result).length > 0 ? result : null;
+}
+function generatePlistXml(job) {
+    const label = plistLabel(job);
+    const seconds = cadenceToSeconds(job.schedule);
+    const calendar = seconds === null ? scheduleToCalendarInterval(job.schedule) : null;
+    let triggerXml;
+    if (seconds !== null) {
+        triggerXml = `  <key>StartInterval</key>\n  <integer>${seconds}</integer>`;
+    }
+    else if (calendar !== null) {
+        const entries = Object.entries(calendar)
+            .map(([k, v]) => `      <key>${k}</key>\n      <integer>${v}</integer>`)
+            .join("\n");
+        triggerXml = `  <key>StartCalendarInterval</key>\n  <dict>\n${entries}\n  </dict>`;
+    }
+    else {
+        triggerXml = `  <key>StartInterval</key>\n  <integer>1800</integer>`;
+    }
+    return [
+        `<?xml version="1.0" encoding="UTF-8"?>`,
+        `<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">`,
+        `<plist version="1.0">`,
+        `<dict>`,
+        `  <key>Label</key>`,
+        `  <string>${label}</string>`,
+        `  <key>ProgramArguments</key>`,
+        `  <array>`,
+        `    <string>${job.command.split(" ")[0]}</string>`,
+        ...job.command.split(" ").slice(1).map((arg) => `    <string>${arg}</string>`),
+        `  </array>`,
+        triggerXml,
+        `  <key>StandardOutPath</key>`,
+        `  <string>/tmp/${label}.stdout.log</string>`,
+        `  <key>StandardErrorPath</key>`,
+        `  <string>/tmp/${label}.stderr.log</string>`,
+        `</dict>`,
+        `</plist>`,
+        ``,
+    ].join("\n");
+}
+class LaunchdCronManager {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get launchAgentsDir() {
+        return `${this.deps.homeDir}/Library/LaunchAgents`;
+    }
+    sync(jobs) {
+        this.deps.mkdirp(this.launchAgentsDir);
+        const desiredLabels = new Set(jobs.map(plistLabel));
+        // Remove stale plists
+        const existing = this.listPlistFiles();
+        for (const filename of existing) {
+            const label = filename.replace(".plist", "");
+            if (!desiredLabels.has(label)) {
+                const fullPath = `${this.launchAgentsDir}/${filename}`;
+                try {
+                    this.deps.exec(`launchctl unload "${fullPath}"`);
+                }
+                catch { /* best effort */ }
+                this.deps.removeFile(fullPath);
+            }
+        }
+        // Write current plists
+        for (const job of jobs) {
+            const label = plistLabel(job);
+            const filename = `${label}.plist`;
+            const fullPath = `${this.launchAgentsDir}/${filename}`;
+            const xml = generatePlistXml(job);
+            try {
+                this.deps.exec(`launchctl unload "${fullPath}"`);
+            }
+            catch { /* best effort */ }
+            this.deps.writeFile(fullPath, xml);
+            try {
+                this.deps.exec(`launchctl load "${fullPath}"`);
+            }
+            catch { /* best effort */ }
+        }
+        (0, runtime_1.emitNervesEvent)({ component: "daemon", event: "daemon.os_cron_synced", message: "synced OS cron entries", meta: { platform: "darwin", jobCount: jobs.length } });
+    }
+    removeAll() {
+        const existing = this.listPlistFiles();
+        for (const filename of existing) {
+            const fullPath = `${this.launchAgentsDir}/${filename}`;
+            try {
+                this.deps.exec(`launchctl unload "${fullPath}"`);
+            }
+            catch { /* best effort */ }
+            this.deps.removeFile(fullPath);
+        }
+    }
+    list() {
+        return this.listPlistFiles().map((f) => f.replace(".plist", ""));
+    }
+    listPlistFiles() {
+        if (!this.deps.existsFile(this.launchAgentsDir))
+            return [];
+        return this.deps.listDir(this.launchAgentsDir).filter((f) => f.startsWith(PLIST_PREFIX) && f.endsWith(".plist"));
+    }
+}
+exports.LaunchdCronManager = LaunchdCronManager;
+const CRONTAB_MARKER_PREFIX = "# ouro:";
+function crontabLine(job) {
+    return `${CRONTAB_MARKER_PREFIX}${job.id}\n${job.schedule} ${job.command}`;
+}
+class CrontabCronManager {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    sync(jobs) {
+        const currentLines = this.readCrontab();
+        const cleaned = this.removeOuroLines(currentLines);
+        const newLines = jobs.map(crontabLine);
+        const combined = [...cleaned, ...newLines].join("\n").trim();
+        this.deps.execWrite("crontab -", combined ? `${combined}\n` : "");
+    }
+    removeAll() {
+        const currentLines = this.readCrontab();
+        const cleaned = this.removeOuroLines(currentLines);
+        const combined = cleaned.join("\n").trim();
+        this.deps.execWrite("crontab -", combined ? `${combined}\n` : "");
+    }
+    list() {
+        const lines = this.readCrontab();
+        return lines
+            .filter((l) => l.startsWith(CRONTAB_MARKER_PREFIX))
+            .map((l) => l.slice(CRONTAB_MARKER_PREFIX.length));
+    }
+    readCrontab() {
+        try {
+            return this.deps.execOutput("crontab -l").split("\n");
+        }
+        catch {
+            return [];
+        }
+    }
+    removeOuroLines(lines) {
+        const result = [];
+        let skipNext = false;
+        for (const line of lines) {
+            if (line.startsWith(CRONTAB_MARKER_PREFIX)) {
+                skipNext = true;
+                continue;
+            }
+            if (skipNext) {
+                skipNext = false;
+                continue;
+            }
+            result.push(line);
+        }
+        return result;
+    }
+}
+exports.CrontabCronManager = CrontabCronManager;
+function createOsCronManager(options = {}) {
+    const platform = options.platform ?? process.platform;
+    if (platform === "darwin") {
+        /* v8 ignore start -- integration: default stubs for real OS operations @preserve */
+        const deps = options.launchdDeps ?? {
+            exec: () => { },
+            writeFile: () => { },
+            removeFile: () => { },
+            existsFile: () => false,
+            listDir: () => [],
+            mkdirp: () => { },
+            homeDir: os.homedir(),
+        };
+        /* v8 ignore stop */
+        return new LaunchdCronManager(deps);
+    }
+    const deps = options.crontabDeps ?? {
+        execOutput: () => "",
+        execWrite: () => { },
+    };
+    return new CrontabCronManager(deps);
+}

package/dist/heart/daemon/ouro-bot-wrapper.js

@@ -37,8 +37,9 @@ exports.runOuroBotWrapper = runOuroBotWrapper;
 const runtime_1 = require("../../nerves/runtime");
 const daemon_cli_1 = require("./daemon-cli");
 async function defaultLoadCanonicalRunner() {
-    const packageName = "@ouro.bot/cli";
-    const specifier = packageName;
+    // Use the subpath export so we get the daemon-cli module directly,
+    // NOT the root entry point which has side-effects (immediately runs the CLI).
+    const specifier = "@ouro.bot/cli/runOuroCli";
     const loaded = await Promise.resolve(`${specifier}`).then(s => __importStar(require(s)));
     const candidate = Object.prototype.hasOwnProperty.call(loaded, "runOuroCli")
         ? loaded["runOuroCli"]
@@ -46,7 +47,7 @@ async function defaultLoadCanonicalRunner() {
     if (typeof candidate === "function") {
         return candidate;
     }
-    throw new Error("@ouro.bot/cli does not export runOuroCli");
+    throw new Error("@ouro.bot/cli/runOuroCli does not export runOuroCli");
 }
 function defaultWriteStdout(_text) {
     // Wrapper is intentionally silent by default to avoid duplicate terminal output.

package/dist/heart/daemon/process-manager.js

@@ -100,7 +100,7 @@ class DaemonProcessManager {
         const child = this.spawnFn("node", args, {
             cwd: runCwd,
             env: state.config.env ? { ...process.env, ...state.config.env } : process.env,
-            stdio: ["ignore", "ignore", "ignore"],
+            stdio: ["ignore", "ignore", "ignore", "ipc"],
         });
         state.process = child;
         state.snapshot.status = "running";
@@ -151,6 +151,23 @@ class DaemonProcessManager {
             await this.stopAgent(state.config.name);
         }
     }
+    sendToAgent(agent, message) {
+        const state = this.requireAgent(agent);
+        if (!state.process)
+            return;
+        try {
+            state.process.send(message);
+        }
+        catch {
+            (0, runtime_1.emitNervesEvent)({
+                level: "warn",
+                component: "daemon",
+                event: "daemon.agent_ipc_send_error",
+                message: "failed to send IPC message to managed agent",
+                meta: { agent },
+            });
+        }
+    }
     getAgentSnapshot(agent) {
         return this.agents.get(agent)?.snapshot;
     }

package/dist/heart/daemon/runtime-logging.js

@@ -43,23 +43,27 @@ const DEFAULT_RUNTIME_LOGGING = {
     level: "info",
     sinks: ["terminal", "ndjson"],
 };
+function defaultLevelForProcess(processName) {
+    return processName === "daemon" ? "info" : "warn";
+}
 function isLogLevel(value) {
     return value === "debug" || value === "info" || value === "warn" || value === "error";
 }
-function resolveRuntimeLoggingConfig(configPath) {
+function resolveRuntimeLoggingConfig(configPath, processName) {
+    const defaultLevel = defaultLevelForProcess(processName);
     let parsed = null;
     try {
         const raw = fs.readFileSync(configPath, "utf-8");
         parsed = JSON.parse(raw);
     }
     catch {
-        return { ...DEFAULT_RUNTIME_LOGGING };
+        return { ...DEFAULT_RUNTIME_LOGGING, level: defaultLevel };
     }
     if (!parsed || typeof parsed !== "object") {
-        return { ...DEFAULT_RUNTIME_LOGGING };
+        return { ...DEFAULT_RUNTIME_LOGGING, level: defaultLevel };
     }
     const candidate = parsed;
-    const level = isLogLevel(candidate.level) ? candidate.level : DEFAULT_RUNTIME_LOGGING.level;
+    const level = isLogLevel(candidate.level) ? candidate.level : defaultLevel;
     const sinks = Array.isArray(candidate.sinks)
         ? candidate.sinks.filter((entry) => entry === "terminal" || entry === "ndjson")
         : DEFAULT_RUNTIME_LOGGING.sinks;
@@ -71,7 +75,7 @@ function resolveRuntimeLoggingConfig(configPath) {
 function configureDaemonRuntimeLogger(processName, options = {}) {
     const homeDir = options.homeDir ?? os.homedir();
     const configPath = options.configPath ?? path.join(homeDir, ".agentstate", "daemon", "logging.json");
-    const config = resolveRuntimeLoggingConfig(configPath);
+    const config = resolveRuntimeLoggingConfig(configPath, processName);
     const sinks = config.sinks.map((sinkName) => {
         if (sinkName === "terminal") {
             return (0, nerves_1.createTerminalSink)();

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

@@ -0,0 +1,161 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAdoptionSpecialist = runAdoptionSpecialist;
+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");
+function listExistingBundles(bundlesRoot) {
+    let entries;
+    try {
+        entries = fs.readdirSync(bundlesRoot, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const discovered = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory() || !entry.name.endsWith(".ouro"))
+            continue;
+        const agentName = entry.name.slice(0, -5);
+        discovered.push(agentName);
+    }
+    return discovered.sort((a, b) => a.localeCompare(b));
+}
+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
+ */
+async function runAdoptionSpecialist(deps) {
+    const { bundleSourceDir, bundlesRoot, secretsRoot, provider, credentials, humanName, callbacks, signal } = deps;
+    const random = deps.random ?? Math.random;
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.specialist_orchestrator_start",
+        message: "starting adoption specialist orchestrator",
+        meta: { provider, bundleSourceDir },
+    });
+    // 1. Read SOUL.md
+    const soulPath = path.join(bundleSourceDir, "psyche", "SOUL.md");
+    let soulText = "";
+    try {
+        soulText = fs.readFileSync(soulPath, "utf-8");
+    }
+    catch {
+        // No SOUL.md -- proceed without it
+    }
+    // 2. Pick random identity
+    const identitiesDir = path.join(bundleSourceDir, "psyche", "identities");
+    const identity = pickRandomIdentity(identitiesDir, random);
+    (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
+    (0, identity_1.setAgentName)("AdoptionSpecialist");
+    (0, identity_1.setAgentConfigOverride)({
+        version: 1,
+        enabled: true,
+        provider,
+        phrases: { thinking: ["thinking"], tool: ["checking"], followup: ["processing"] },
+    });
+    (0, hatch_flow_1.writeSecretsFile)("AdoptionSpecialist", provider, credentials, secretsRoot);
+    (0, config_1.resetConfigCache)();
+    (0, core_1.resetProviderRuntime)();
+    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 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",
+        });
+        return result.hatchedAgentName;
+    }
+    finally {
+        // 7. Cleanup: restore identity/config state
+        (0, identity_1.setAgentConfigOverride)(null);
+        (0, config_1.resetConfigCache)();
+        (0, core_1.resetProviderRuntime)();
+    }
+}