@ouro.bot/cli 0.1.0-alpha.185 → 0.1.0-alpha.186

package/README.md

@@ -48,7 +48,7 @@ The shared harness lives in `src/`:
 
 Other important top-level paths:
 
-- `AdoptionSpecialist.ouro/`
+- `SerpentGuide.ouro/`
   Packaged specialist bundle used by `ouro hatch`.
 - `skills/`
   Harness-level skills shipped with the repo (e.g., `configure-dev-tools.md`). These are available to every agent and serve as fallbacks when an agent doesn't have its own version. Agent-specific skills live in the bundle at `~/AgentBundles/<agent>.ouro/skills/`.

package/changelog.json

@@ -1,16 +1,24 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.186",
+      "changes": [
+        "refactor: rename AdoptionSpecialist to SerpentGuide",
+        "feat(hatch): detect API keys from environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY, AZURE_OPENAI_API_KEY, MINIMAX_API_KEY, GITHUB_TOKEN)",
+        "fix(cli): React unmount warning suppression covers SerpentGuide exit path"
+      ]
+    },
     {
       "version": "0.1.0-alpha.185",
       "changes": [
         "fix(hatch): pass model name to adoption specialist from discovered credentials",
         "feat(continuity): wake packets, episodes, cares, intentions, peer presence, and temporal self",
         "fix(continuity): deduplicate obligations in prompt, keep session summary, pass preloaded data",
-        "feat(continuity): 9 new modules — episodes, cares, agent-relationships, intentions, presence, tempo, temporal-view, wake-packet, obligation enrichment",
-        "feat(continuity): 8 new tools — query_episodes, capture_episode, query_presence, query_cares, care_manage, query_relationships, intention_capture, intention_manage",
-        "feat(continuity): 3-layer architecture — durable state, derived views, surfaces",
-        "feat(pipeline): continuity threading — tempo derivation, wake packet assembly, presence update, episode emission on every turn",
+        "feat(continuity): 9 new modules \u2014 episodes, cares, agent-relationships, intentions, presence, tempo, temporal-view, wake-packet, obligation enrichment",
+        "feat(continuity): 8 new tools \u2014 query_episodes, capture_episode, query_presence, query_cares, care_manage, query_relationships, intention_capture, intention_manage",
+        "feat(continuity): 3-layer architecture \u2014 durable state, derived views, surfaces",
+        "feat(pipeline): continuity threading \u2014 tempo derivation, wake packet assembly, presence update, episode emission on every turn",
         "feat(prompt): wake packet prompt section with token budget and truncation priority",
         "feat(coding): coding context receives compact wake packet, coding completion emits episodes",
         "feat(outlook): expose continuity data (presence, cares, episodes) to outlook surfaces"

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

@@ -1380,7 +1380,7 @@ function discoverExistingCredentials(secretsRoot) {
     });
 }
 /* v8 ignore start -- integration: interactive terminal specialist session @preserve */
-async function defaultRunAdoptionSpecialist() {
+async function defaultRunSerpentGuide() {
     const { runCliSession } = await Promise.resolve().then(() => __importStar(require("../../senses/cli")));
     const { patchRuntimeConfig } = await Promise.resolve().then(() => __importStar(require("../config")));
     const { setAgentName, setAgentConfigOverride } = await Promise.resolve().then(() => __importStar(require("../identity")));
@@ -1409,6 +1409,36 @@ async function defaultRunAdoptionSpecialist() {
             "github-copilot": "claude-sonnet-4.6",
             azure: "",
         };
+        // Scan environment variables for API keys
+        const envKeys = [
+            { provider: "anthropic", envVar: "ANTHROPIC_API_KEY", credKey: "setupToken" },
+            { provider: "openai-codex", envVar: "OPENAI_API_KEY", credKey: "oauthAccessToken" },
+            { provider: "azure", envVar: "AZURE_OPENAI_API_KEY", credKey: "apiKey" },
+            { provider: "azure", envVar: "AZURE_OPENAI_KEY", credKey: "apiKey" },
+            { provider: "minimax", envVar: "MINIMAX_API_KEY", credKey: "apiKey" },
+            { provider: "github-copilot", envVar: "GITHUB_TOKEN", credKey: "token" },
+        ];
+        const envDiscovered = [];
+        for (const { provider, envVar, credKey } of envKeys) {
+            const value = process.env[envVar];
+            if (value) {
+                const envCred = { [credKey]: value };
+                // For Azure, also check for endpoint and deployment env vars
+                if (provider === "azure") {
+                    const endpoint = process.env.AZURE_OPENAI_ENDPOINT;
+                    const deployment = process.env.AZURE_OPENAI_DEPLOYMENT;
+                    if (endpoint)
+                        envCred.endpoint = endpoint;
+                    if (deployment)
+                        envCred.deployment = deployment;
+                }
+                const provCfg = { model: defaultModels[provider] };
+                if (provider === "azure" && envCred.deployment)
+                    provCfg.deployment = envCred.deployment;
+                envDiscovered.push({ provider, agentName: "env", credentials: envCred, providerConfig: provCfg, envVar });
+                discovered.push({ provider, agentName: "env", credentials: envCred, providerConfig: provCfg });
+            }
+        }
         if (discovered.length > 0) {
             process.stdout.write(`\n\ud83d\udc0d welcome to ouroboros! ${hatchVerb}\n`);
             process.stdout.write("i found existing API credentials:\n\n");
@@ -1416,7 +1446,9 @@ async function defaultRunAdoptionSpecialist() {
             for (let i = 0; i < unique.length; i++) {
                 const model = unique[i].providerConfig.model || unique[i].providerConfig.deployment || "";
                 const modelLabel = model ? `, ${model}` : "";
-                process.stdout.write(`  ${i + 1}. ${unique[i].provider}${modelLabel} (from ${unique[i].agentName})\n`);
+                const envMatch = envDiscovered.find((e) => e.provider === unique[i].provider && unique[i].agentName === "env");
+                const sourceLabel = envMatch ? `from env: $${envMatch.envVar}` : `from ${unique[i].agentName}`;
+                process.stdout.write(`  ${i + 1}. ${unique[i].provider}${modelLabel} (${sourceLabel})\n`);
             }
             process.stdout.write("\n");
             const choice = await coldPrompt("use one of these? enter number, or 'new' for a different key: ");
@@ -1473,17 +1505,17 @@ async function defaultRunAdoptionSpecialist() {
         }
         coldRl.close();
         process.stdout.write("\n");
-        // Phase 2: configure runtime for adoption specialist
-        const bundleSourceDir = path.resolve(__dirname, "..", "..", "..", "AdoptionSpecialist.ouro");
+        // Phase 2: configure runtime for serpent guide
+        const bundleSourceDir = path.resolve(__dirname, "..", "..", "..", "SerpentGuide.ouro");
         const bundlesRoot = (0, identity_1.getAgentBundlesRoot)();
         const secretsRoot2 = path.join(os.homedir(), ".agentsecrets");
-        // Suppress non-critical log noise during adoption (no secrets.json, etc.)
+        // Suppress non-critical log noise during hatch (no secrets.json, etc.)
         const { setRuntimeLogger } = await Promise.resolve().then(() => __importStar(require("../../nerves/runtime")));
         const { createLogger } = await Promise.resolve().then(() => __importStar(require("../../nerves")));
         setRuntimeLogger(createLogger({ level: "error" }));
         // Configure runtime: set agent identity + config override so runAgent
-        // doesn't try to read from ~/AgentBundles/AdoptionSpecialist.ouro/
-        setAgentName("AdoptionSpecialist");
+        // doesn't try to read from ~/AgentBundles/SerpentGuide.ouro/
+        setAgentName("SerpentGuide");
         // Build specialist system prompt
         const soulText = (0, specialist_orchestrator_1.loadSoulText)(bundleSourceDir);
         const identitiesDir = path.join(bundleSourceDir, "psyche", "identities");
@@ -1521,9 +1553,9 @@ async function defaultRunAdoptionSpecialist() {
             secretsRoot: secretsRoot2,
             animationWriter: (text) => process.stdout.write(text),
         });
-        // Run the adoption specialist session via runCliSession
+        // Run the serpent guide session via runCliSession
         const result = await runCliSession({
-            agentName: "AdoptionSpecialist",
+            agentName: "SerpentGuide",
             tools: specialistTools,
             execTool: specialistExecTool,
             exitOnToolCall: "complete_adoption",
@@ -1545,7 +1577,7 @@ async function defaultRunAdoptionSpecialist() {
         return null;
     }
     catch (err) {
-        process.stderr.write(`\nouro adoption error: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+        process.stderr.write(`\nouro hatch error: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
         coldRl.close();
         return null;
     }
@@ -1583,7 +1615,7 @@ function createDefaultOuroCliDeps(socketPath = socket_client_1.DEFAULT_DAEMON_SO
         listDiscoveredAgents: defaultListDiscoveredAgents,
         runHatchFlow: hatch_flow_1.runHatchFlow,
         promptInput: defaultPromptInput,
-        runAdoptionSpecialist: defaultRunAdoptionSpecialist,
+        runSerpentGuide: defaultRunSerpentGuide,
         runAuthFlow: auth_flow_1.runRuntimeAuthFlow,
         registerOuroBundleType: ouro_uti_1.registerOuroBundleUti,
         installOuroCommand: ouro_path_installer_1.installOuroCommand,
@@ -2148,10 +2180,10 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
     }
     if (args.length === 0) {
         const discovered = await Promise.resolve(deps.listDiscoveredAgents ? deps.listDiscoveredAgents() : defaultListDiscoveredAgents());
-        if (discovered.length === 0 && deps.runAdoptionSpecialist) {
+        if (discovered.length === 0 && deps.runSerpentGuide) {
             // System setup first — ouro command, subagents, UTI — before the interactive specialist
             await performSystemSetup(deps);
-            const hatchlingName = await deps.runAdoptionSpecialist();
+            const hatchlingName = await deps.runSerpentGuide();
             if (!hatchlingName) {
                 return "";
             }
@@ -3257,12 +3289,12 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
         return "";
     }
     if (command.kind === "hatch.start") {
-        // Route through adoption specialist when no explicit hatch args were provided
+        // Route through serpent guide when no explicit hatch args were provided
         const hasExplicitHatchArgs = !!(command.agentName || command.humanName || command.provider || command.credentials);
-        if (deps.runAdoptionSpecialist && !hasExplicitHatchArgs) {
+        if (deps.runSerpentGuide && !hasExplicitHatchArgs) {
             // System setup first — ouro command, subagents, UTI — before the interactive specialist
             await performSystemSetup(deps);
-            const hatchlingName = await deps.runAdoptionSpecialist();
+            const hatchlingName = await deps.runSerpentGuide();
             if (!hatchlingName) {
                 return "";
             }

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

@@ -161,7 +161,7 @@ async function runHatchFlow(input, deps = {}) {
         identitiesDir: targetIdentities,
         random,
     });
-    const specialistSecretsPath = writeSecretsFile("AdoptionSpecialist", input.provider, input.credentials, secretsRoot);
+    const specialistSecretsPath = writeSecretsFile("SerpentGuide", input.provider, input.credentials, secretsRoot);
     const hatchlingSecretsPath = writeSecretsFile(input.agentName, input.provider, input.credentials, secretsRoot);
     const bundleRoot = path.join(bundlesRoot, `${input.agentName}.ouro`);
     fs.mkdirSync(bundleRoot, { recursive: true });

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

@@ -43,14 +43,14 @@ const path = __importStar(require("path"));
 const runtime_1 = require("../../nerves/runtime");
 function getSpecialistIdentitySourceDir() {
     // Prefer ~/AgentBundles/ if it exists (user may have customized identities)
-    const userSource = path.join(os.homedir(), "AgentBundles", "AdoptionSpecialist.ouro", "psyche", "identities");
+    const userSource = path.join(os.homedir(), "AgentBundles", "SerpentGuide.ouro", "psyche", "identities");
     if (fs.existsSync(userSource))
         return userSource;
     // Fall back to the bundled copy shipped with the npm package
-    return path.join(__dirname, "..", "..", "..", "AdoptionSpecialist.ouro", "psyche", "identities");
+    return path.join(__dirname, "..", "..", "..", "SerpentGuide.ouro", "psyche", "identities");
 }
 function getRepoSpecialistIdentitiesDir() {
-    return path.join(process.cwd(), "AdoptionSpecialist.ouro", "psyche", "identities");
+    return path.join(process.cwd(), "SerpentGuide.ouro", "psyche", "identities");
 }
 function listMarkdownIdentityFiles(dir) {
     let entries;

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

@@ -3,7 +3,7 @@ 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.
+ * Build the serpent guide's system prompt from its components.
  * The prompt is written in first person (the specialist's own voice).
  */
 function buildSpecialistSystemPrompt(soulText, identityText, existingBundles, context) {
@@ -31,7 +31,7 @@ function buildSpecialistSystemPrompt(soulText, identityText, existingBundles, co
         "I am one of thirteen serpent guides who help humans hatch their first agent. The system randomly selected me for this session.",
         "Most humans only go through this process once, so this is likely the only time they'll meet me.",
         "I make this encounter count — warm, memorable, and uniquely mine.",
-        "IMPORTANT: I NEVER refer to myself as an 'adoption specialist' or use the words 'adoption specialist' — those are internal implementation labels, not something the human should ever see. I introduce myself by my own name from my identity.",
+        "IMPORTANT: I NEVER refer to myself by internal implementation labels — I introduce myself by my own name from my identity.",
         "",
         "## Voice rules",
         "IMPORTANT: I keep every response to 1-3 short sentences. I sound like a friend texting, not a manual.",

package/dist/senses/cli.js

@@ -797,7 +797,7 @@ async function runCliSession(options) {
                     }
                 }
                 else {
-                    // Legacy path: inline runAgent (used by adoption specialist and tests)
+                    // Legacy path: inline runAgent (used by serpent guide and tests)
                     const prefix = options.getContentPrefix?.();
                     messages.push({ role: "user", content: prefix ? `${prefix}\n\n${input}` : input });
                     const traceId = (0, nerves_1.createTraceId)();
@@ -845,6 +845,8 @@ async function runCliSession(options) {
         if (inkRef) {
             // Suppress React "state update on unmounted component" warnings during cleanup.
             // Ink's useInput hook fires after unmount — this is harmless but noisy.
+            // This also covers the SerpentGuide exitOnToolCall path, which aborts the
+            // current request and breaks out of the loop into this finally block.
             // eslint-disable-next-line no-console -- intentional console.warn/error override for cleanup
             const origWarn = console.warn;
             const origError = console.error; // eslint-disable-line no-console

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.185",
+  "version": "0.1.0-alpha.186",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",
@@ -9,7 +9,7 @@
   },
   "files": [
     "dist/",
-    "AdoptionSpecialist.ouro/",
+    "SerpentGuide.ouro/",
     "subagents/",
     "skills/",
     "assets/",