@ouro.bot/cli 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/heart/config.js

@@ -44,6 +44,8 @@ exports.getTeamsConfig = getTeamsConfig;
 exports.getContextConfig = getContextConfig;
 exports.getOAuthConfig = getOAuthConfig;
 exports.getTeamsChannelConfig = getTeamsChannelConfig;
+exports.getBlueBubblesConfig = getBlueBubblesConfig;
+exports.getBlueBubblesChannelConfig = getBlueBubblesChannelConfig;
 exports.getIntegrationsConfig = getIntegrationsConfig;
 exports.getOpenAIEmbeddingsApiKey = getOpenAIEmbeddingsApiKey;
 exports.getLogsDir = getLogsDir;
@@ -92,6 +94,16 @@ const DEFAULT_SECRETS_TEMPLATE = {
         skipConfirmation: true,
         port: 3978,
     },
+    bluebubbles: {
+        serverUrl: "",
+        password: "",
+        accountId: "default",
+    },
+    bluebubblesChannel: {
+        port: 18790,
+        webhookPath: "/bluebubbles-webhook",
+        requestTimeoutMs: 30000,
+    },
     integrations: {
         perplexityApiKey: "",
         openaiEmbeddingsApiKey: "",
@@ -109,6 +121,8 @@ function defaultRuntimeConfig() {
         oauth: { ...DEFAULT_SECRETS_TEMPLATE.oauth },
         context: { ...identity_1.DEFAULT_AGENT_CONTEXT },
         teamsChannel: { ...DEFAULT_SECRETS_TEMPLATE.teamsChannel },
+        bluebubbles: { ...DEFAULT_SECRETS_TEMPLATE.bluebubbles },
+        bluebubblesChannel: { ...DEFAULT_SECRETS_TEMPLATE.bluebubblesChannel },
         integrations: { ...DEFAULT_SECRETS_TEMPLATE.integrations },
     };
 }
@@ -273,6 +287,26 @@ function getTeamsChannelConfig() {
     const { skipConfirmation, flushIntervalMs, port } = config.teamsChannel;
     return { skipConfirmation, flushIntervalMs, port };
 }
+function getBlueBubblesConfig() {
+    const config = loadConfig();
+    const { serverUrl, password, accountId } = config.bluebubbles;
+    if (!serverUrl.trim()) {
+        throw new Error("bluebubbles.serverUrl is required in secrets.json to run the BlueBubbles sense.");
+    }
+    if (!password.trim()) {
+        throw new Error("bluebubbles.password is required in secrets.json to run the BlueBubbles sense.");
+    }
+    return {
+        serverUrl: serverUrl.trim(),
+        password: password.trim(),
+        accountId: accountId.trim() || "default",
+    };
+}
+function getBlueBubblesChannelConfig() {
+    const config = loadConfig();
+    const { port, webhookPath, requestTimeoutMs } = config.bluebubblesChannel;
+    return { port, webhookPath, requestTimeoutMs };
+}
 function getIntegrationsConfig() {
     const config = loadConfig();
     return { ...config.integrations };

package/dist/heart/core.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasToolIntent = exports.buildSystem = exports.toResponsesTools = exports.toResponsesInput = exports.streamResponsesApi = exports.streamChatCompletion = exports.getToolsForChannel = exports.summarizeArgs = exports.execTool = exports.tools = void 0;
 exports.createProviderRegistry = createProviderRegistry;
+exports.resetProviderRuntime = resetProviderRuntime;
 exports.getModel = getModel;
 exports.getProvider = getProvider;
 exports.createSummarize = createSummarize;
@@ -73,6 +74,14 @@ function getProviderRuntime() {
     }
     return _providerRuntime;
 }
+/**
+ * Clear the cached provider runtime so the next call to getProviderRuntime()
+ * re-creates it from current config. Used by the adoption specialist to
+ * switch provider context without restarting the process.
+ */
+function resetProviderRuntime() {
+    _providerRuntime = null;
+}
 function getModel() {
     return getProviderRuntime().model;
 }

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

@@ -49,6 +49,7 @@ const types_1 = require("../../mind/friends/types");
 const ouro_uti_1 = require("./ouro-uti");
 const subagent_installer_1 = require("./subagent-installer");
 const hatch_flow_1 = require("./hatch-flow");
+const specialist_orchestrator_1 = require("./specialist-orchestrator");
 async function ensureDaemonRunning(deps) {
     const alive = await deps.checkSocketAlive(deps.socketPath);
     if (alive) {
@@ -457,6 +458,65 @@ async function defaultLinkFriendIdentity(command) {
     });
     return `linked ${command.provider}:${command.externalId} to ${command.friendId}`;
 }
+/* v8 ignore next 49 -- integration: interactive terminal specialist session @preserve */
+async function defaultRunAdoptionSpecialist() {
+    const readline = await Promise.resolve().then(() => __importStar(require("readline/promises")));
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const prompt = async (q) => {
+        const answer = await rl.question(q);
+        return answer.trim();
+    };
+    try {
+        const humanName = await prompt("Your name: ");
+        const providerRaw = await prompt("Provider (azure|anthropic|minimax|openai-codex): ");
+        if (!humanName || !isAgentProvider(providerRaw)) {
+            process.stdout.write("Invalid input. Run `ouro hatch` to try again.\n");
+            return null;
+        }
+        const credentials = {};
+        if (providerRaw === "anthropic")
+            credentials.setupToken = await prompt("Anthropic API key: ");
+        if (providerRaw === "openai-codex")
+            credentials.oauthAccessToken = await prompt("OpenAI Codex OAuth token: ");
+        if (providerRaw === "minimax")
+            credentials.apiKey = await prompt("MiniMax API key: ");
+        if (providerRaw === "azure") {
+            credentials.apiKey = await prompt("Azure API key: ");
+            credentials.endpoint = await prompt("Azure endpoint: ");
+            credentials.deployment = await prompt("Azure deployment: ");
+        }
+        rl.close();
+        // Locate the bundled AdoptionSpecialist.ouro shipped with the npm package
+        const bundleSourceDir = path.resolve(__dirname, "..", "..", "..", "AdoptionSpecialist.ouro");
+        const bundlesRoot = (0, identity_1.getAgentBundlesRoot)();
+        const secretsRoot = path.join(os.homedir(), ".agentsecrets");
+        return await (0, specialist_orchestrator_1.runAdoptionSpecialist)({
+            bundleSourceDir,
+            bundlesRoot,
+            secretsRoot,
+            provider: providerRaw,
+            credentials,
+            humanName,
+            createReadline: () => {
+                const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
+                return { question: (q) => rl2.question(q), close: () => rl2.close() };
+            },
+            callbacks: {
+                onModelStart: () => { },
+                onModelStreamStart: () => { },
+                onTextChunk: (text) => process.stdout.write(text),
+                onReasoningChunk: () => { },
+                onToolStart: () => { },
+                onToolEnd: () => { },
+                onError: (err) => process.stderr.write(`error: ${err.message}\n`),
+            },
+        });
+    }
+    catch {
+        rl.close();
+        return null;
+    }
+}
 function createDefaultOuroCliDeps(socketPath = "/tmp/ouroboros-daemon.sock") {
     return {
         socketPath,
@@ -471,6 +531,7 @@ function createDefaultOuroCliDeps(socketPath = "/tmp/ouroboros-daemon.sock") {
         listDiscoveredAgents: defaultListDiscoveredAgents,
         runHatchFlow: hatch_flow_1.runHatchFlow,
         promptInput: defaultPromptInput,
+        runAdoptionSpecialist: defaultRunAdoptionSpecialist,
         registerOuroBundleType: ouro_uti_1.registerOuroBundleUti,
         /* v8 ignore next 3 -- integration: launches interactive CLI session @preserve */
         startChat: async (agentName) => {
@@ -556,7 +617,31 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
     }
     if (args.length === 0) {
         const discovered = await Promise.resolve(deps.listDiscoveredAgents ? deps.listDiscoveredAgents() : defaultListDiscoveredAgents());
-        if (discovered.length === 0) {
+        if (discovered.length === 0 && deps.runAdoptionSpecialist) {
+            const hatchlingName = await deps.runAdoptionSpecialist();
+            if (!hatchlingName) {
+                return "";
+            }
+            try {
+                await deps.installSubagents();
+            }
+            catch (error) {
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "daemon",
+                    event: "daemon.subagent_install_error",
+                    message: "subagent auto-install failed",
+                    meta: { error: error instanceof Error ? error.message : /* v8 ignore next -- defensive: non-Error catch branch @preserve */ String(error) },
+                });
+            }
+            await registerOuroBundleTypeNonBlocking(deps);
+            await ensureDaemonRunning(deps);
+            if (deps.startChat) {
+                await deps.startChat(hatchlingName);
+            }
+            return "";
+        }
+        else if (discovered.length === 0) {
             command = { kind: "hatch.start" };
         }
         else if (discovered.length === 1) {

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.playHatchAnimation = playHatchAnimation;
+const runtime_1 = require("../../nerves/runtime");
+const EGG = "\uD83E\uDD5A";
+const SNAKE = "\uD83D\uDC0D";
+const DOTS = " . . . ";
+function wait(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Play the hatch animation: egg -> dots -> snake + name.
+ * The writer function receives each chunk. Default writer is process.stderr.write.
+ */
+async function playHatchAnimation(hatchlingName, writer) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.hatch_animation_start",
+        message: "playing hatch animation",
+        meta: { hatchlingName },
+    });
+    const write = writer ?? ((text) => process.stderr.write(text));
+    write(`\n  ${EGG}`);
+    await wait(400);
+    write(DOTS);
+    await wait(400);
+    write(`${SNAKE} \x1b[1m${hatchlingName}\x1b[0m\n\n`);
+}

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

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeSecretsFile = writeSecretsFile;
 exports.runHatchFlow = runHatchFlow;
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));

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

@@ -0,0 +1,160 @@
+"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,
+        });
+        return result.hatchedAgentName;
+    }
+    finally {
+        // 7. Cleanup: restore identity/config state
+        (0, identity_1.setAgentConfigOverride)(null);
+        (0, config_1.resetConfigCache)();
+        (0, core_1.resetProviderRuntime)();
+    }
+}

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSpecialistSystemPrompt = buildSpecialistSystemPrompt;
+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) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.specialist_prompt_build",
+        message: "building specialist system prompt",
+        meta: { bundleCount: existingBundles.length },
+    });
+    const sections = [];
+    if (soulText) {
+        sections.push(soulText);
+    }
+    if (identityText) {
+        sections.push(identityText);
+    }
+    if (existingBundles.length > 0) {
+        sections.push(`## Existing agents\nThe human already has these agents: ${existingBundles.join(", ")}.`);
+    }
+    else {
+        sections.push("## Existing agents\nThe human has no agents yet. This will be their first hatchling.");
+    }
+    sections.push([
+        "## Tools",
+        "I have these tools available:",
+        "- `hatch_agent`: Create a new agent bundle. I call this with a `name` parameter once I have enough information from the human.",
+        "- `final_answer`: End the conversation with a final message to the human. I call this when the adoption process is complete.",
+        "- `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.",
+        "",
+        "I must call `final_answer` when I am done to end the session cleanly.",
+    ].join("\n"));
+    return sections.join("\n\n");
+}

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

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSpecialistSession = runSpecialistSession;
+const runtime_1 = require("../../nerves/runtime");
+/**
+ * Run the specialist conversation session loop.
+ *
+ * The loop:
+ * 1. Initialize messages with system prompt
+ * 2. Prompt user -> add to messages -> call streamTurn -> process result
+ * 3. If result has no tool calls: push assistant message, re-prompt
+ * 4. If result has final_answer sole call: extract answer, emit via callbacks, done
+ * 5. If result has other tool calls: execute each, push tool results, continue loop
+ * 6. On abort signal: clean exit
+ * 7. Return { hatchedAgentName } -- name from hatch_agent if called
+ */
+async function runSpecialistSession(deps) {
+    const { providerRuntime, systemPrompt, tools, execTool, readline, callbacks, signal } = deps;
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.specialist_session_start",
+        message: "starting specialist session loop",
+        meta: {},
+    });
+    const messages = [
+        { role: "system", content: systemPrompt },
+    ];
+    let hatchedAgentName = null;
+    let done = false;
+    try {
+        while (!done) {
+            if (signal?.aborted)
+                break;
+            // Get user input
+            const userInput = await readline.question("> ");
+            if (!userInput.trim())
+                continue;
+            messages.push({ role: "user", content: userInput });
+            providerRuntime.resetTurnState(messages);
+            // Inner loop: process tool calls until we get a final_answer or plain text
+            let turnDone = false;
+            while (!turnDone) {
+                if (signal?.aborted) {
+                    done = true;
+                    break;
+                }
+                callbacks.onModelStart();
+                const result = await providerRuntime.streamTurn({
+                    messages,
+                    activeTools: tools,
+                    callbacks,
+                    signal,
+                });
+                // Build assistant message
+                const assistantMsg = {
+                    role: "assistant",
+                };
+                if (result.content)
+                    assistantMsg.content = result.content;
+                if (result.toolCalls.length) {
+                    assistantMsg.tool_calls = result.toolCalls.map((tc) => ({
+                        id: tc.id,
+                        type: "function",
+                        function: { name: tc.name, arguments: tc.arguments },
+                    }));
+                }
+                if (!result.toolCalls.length) {
+                    // Plain text response -- push and re-prompt
+                    messages.push(assistantMsg);
+                    turnDone = true;
+                    continue;
+                }
+                // Check for final_answer
+                const isSoleFinalAnswer = result.toolCalls.length === 1 && result.toolCalls[0].name === "final_answer";
+                if (isSoleFinalAnswer) {
+                    let answer;
+                    try {
+                        const parsed = JSON.parse(result.toolCalls[0].arguments);
+                        if (typeof parsed === "string") {
+                            answer = parsed;
+                        }
+                        else if (parsed.answer != null) {
+                            answer = parsed.answer;
+                        }
+                    }
+                    catch {
+                        // malformed
+                    }
+                    if (answer != null) {
+                        callbacks.onTextChunk(answer);
+                        messages.push(assistantMsg);
+                        done = true;
+                        turnDone = true;
+                        continue;
+                    }
+                    // Malformed final_answer -- ask model to retry
+                    messages.push(assistantMsg);
+                    messages.push({
+                        role: "tool",
+                        tool_call_id: result.toolCalls[0].id,
+                        content: "your final_answer was incomplete or malformed. call final_answer again with your complete response.",
+                    });
+                    providerRuntime.appendToolOutput(result.toolCalls[0].id, "retry");
+                    continue;
+                }
+                // Execute tool calls
+                messages.push(assistantMsg);
+                for (const tc of result.toolCalls) {
+                    if (signal?.aborted)
+                        break;
+                    let args = {};
+                    try {
+                        args = JSON.parse(tc.arguments);
+                    }
+                    catch {
+                        // ignore parse error
+                    }
+                    callbacks.onToolStart(tc.name, args);
+                    let toolResult;
+                    try {
+                        toolResult = await execTool(tc.name, args);
+                    }
+                    catch (e) {
+                        toolResult = `error: ${e}`;
+                    }
+                    callbacks.onToolEnd(tc.name, tc.name, true);
+                    // Track hatchling name
+                    if (tc.name === "hatch_agent" && args.name) {
+                        hatchedAgentName = args.name;
+                    }
+                    messages.push({ role: "tool", tool_call_id: tc.id, content: toolResult });
+                    providerRuntime.appendToolOutput(tc.id, toolResult);
+                }
+                // After processing tool calls, continue inner loop for tool result processing
+            }
+        }
+    }
+    finally {
+        readline.close();
+    }
+    return { hatchedAgentName };
+}