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

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,25 @@
 {
   "_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.187",
+      "changes": [
+        "refactor: collapse AgentRelationship into FriendRecord — one identity system for humans and agents",
+        "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/heart/presence.js

@@ -39,7 +39,6 @@ exports.readPresence = readPresence;
 exports.readPeerPresence = readPeerPresence;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const os = __importStar(require("os"));
 const runtime_1 = require("../nerves/runtime");
 function presenceDir(agentRoot) {
     return path.join(agentRoot, "state", "presence");
@@ -145,40 +144,41 @@ function readPresence(agentRoot, _agentName) {
     }
 }
 function readPeerPresence(agentRoot) {
-    const relDir = path.join(agentRoot, "state", "relationships");
-    if (!fs.existsSync(relDir)) {
+    const friendsDir = path.join(agentRoot, "friends");
+    if (!fs.existsSync(friendsDir)) {
         (0, runtime_1.emitNervesEvent)({
             component: "heart",
             event: "heart.peer_presence_read",
-            message: "no relationships directory, no peers",
+            message: "no friends directory, no peers",
             meta: { peerCount: 0 },
         });
         return [];
     }
-    const files = fs.readdirSync(relDir).filter((f) => f.endsWith(".json"));
+    const files = fs.readdirSync(friendsDir).filter((f) => f.endsWith(".json"));
     const peers = [];
     for (const file of files) {
         try {
-            const raw = fs.readFileSync(path.join(relDir, file), "utf-8");
-            const rel = JSON.parse(raw);
-            const peerName = rel.agentName;
-            // Read peer's presence from their bundle
-            const peerRoot = path.join(os.homedir(), "AgentBundles", `${peerName}.ouro`);
-            const peerPresencePath = path.join(peerRoot, "state", "presence", "self.json");
-            if (fs.existsSync(peerPresencePath)) {
-                const presenceRaw = fs.readFileSync(peerPresencePath, "utf-8");
-                const presence = JSON.parse(presenceRaw);
-                peers.push(presence);
-            }
+            const raw = fs.readFileSync(path.join(friendsDir, file), "utf-8");
+            const friend = JSON.parse(raw);
+            if (friend.kind !== "agent")
+                continue;
+            peers.push({
+                agentName: friend.name ?? path.basename(file, ".json"),
+                availability: "idle",
+                lane: "idle",
+                mission: "",
+                tempo: "brief",
+                updatedAt: friend.updatedAt ?? new Date().toISOString(),
+            });
         }
         catch {
-            // Skip peers with unreadable data
+            // Skip malformed or unreadable files
         }
     }
     (0, runtime_1.emitNervesEvent)({
         component: "heart",
         event: "heart.peer_presence_read",
-        message: `read ${peers.length} peer presence records`,
+        message: `read ${peers.length} agent peer records from friends`,
         meta: { peerCount: peers.length },
     });
     return peers;

package/dist/mind/friends/store-file.js

@@ -127,6 +127,8 @@ class FileFriendStore {
             trustLevel === "stranger"
             ? trustLevel
             : DEFAULT_TRUST_LEVEL;
+        const kind = raw.kind === "human" || raw.kind === "agent" ? raw.kind : "human";
+        const agentMeta = kind === "agent" ? this.normalizeAgentMeta(raw.agentMeta) : undefined;
         return {
             id: raw.id,
             name: raw.name,
@@ -153,6 +155,21 @@ class FileFriendStore {
             createdAt: typeof raw.createdAt === "string" ? raw.createdAt : new Date().toISOString(),
             updatedAt: typeof raw.updatedAt === "string" ? raw.updatedAt : new Date().toISOString(),
             schemaVersion: typeof raw.schemaVersion === "number" ? raw.schemaVersion : 1,
+            kind,
+            agentMeta,
+        };
+    }
+    normalizeAgentMeta(raw) {
+        if (!raw || typeof raw !== "object" || Array.isArray(raw))
+            return undefined;
+        const meta = raw;
+        if (typeof meta.bundleName !== "string")
+            return undefined;
+        return {
+            bundleName: meta.bundleName,
+            familiarity: typeof meta.familiarity === "number" ? meta.familiarity : 0,
+            sharedMissions: Array.isArray(meta.sharedMissions) ? meta.sharedMissions : [],
+            outcomes: Array.isArray(meta.outcomes) ? meta.outcomes : [],
         };
     }
     async readJson(filePath) {

package/dist/repertoire/tools-base.js

@@ -64,7 +64,6 @@ const cross_chat_delivery_1 = require("../heart/cross-chat-delivery");
 const obligations_2 = require("../heart/obligations");
 const episodes_1 = require("../mind/episodes");
 const cares_1 = require("../heart/cares");
-const agent_relationships_1 = require("../heart/agent-relationships");
 const presence_1 = require("../heart/presence");
 const intentions_1 = require("../heart/intentions");
 // Tracks which file paths have been read via read_file in this session.
@@ -1675,13 +1674,15 @@ exports.baseToolDefinitions = [
                 },
             },
         },
-        handler: (a) => {
-            const agentRoot = (0, identity_1.getAgentRoot)();
-            const result = a.agentName
-                ? (0, agent_relationships_1.readRelationship)(agentRoot, a.agentName)
-                : (0, agent_relationships_1.readRelationships)(agentRoot);
+        handler: async (a, ctx) => {
+            const allFriends = ctx?.friendStore?.listAll ? await ctx.friendStore.listAll() : [];
+            let agents = allFriends.filter((f) => f.kind === "agent");
+            if (a.agentName) {
+                const needle = a.agentName.toLowerCase();
+                agents = agents.filter((f) => f.name?.toLowerCase() === needle);
+            }
             (0, runtime_1.emitNervesEvent)({ component: "repertoire", event: "repertoire.query_relationships", message: `queried relationships`, meta: { agentName: a.agentName ?? "all" } });
-            return JSON.stringify(result, null, 2);
+            return JSON.stringify(agents, null, 2);
         },
     },
     {

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.187",
   "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/",

package/dist/heart/agent-relationships.js

@@ -1,161 +0,0 @@
-"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.recordInteraction = recordInteraction;
-exports.readRelationships = readRelationships;
-exports.readRelationship = readRelationship;
-exports.recordOutcome = recordOutcome;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const runtime_1 = require("../nerves/runtime");
-function relationshipsDir(agentRoot) {
-    return path.join(agentRoot, "state", "relationships");
-}
-function relationshipFilePath(agentRoot, agentName) {
-    return path.join(relationshipsDir(agentRoot), `${agentName.toLowerCase()}.json`);
-}
-function readRelationshipFile(agentRoot, agentName) {
-    const filePath = relationshipFilePath(agentRoot, agentName);
-    if (!fs.existsSync(filePath)) {
-        return null;
-    }
-    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
-}
-function writeRelationshipFile(agentRoot, rel) {
-    const dir = relationshipsDir(agentRoot);
-    fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(path.join(dir, `${rel.agentName}.json`), JSON.stringify(rel, null, 2), "utf-8");
-}
-function recordInteraction(agentRoot, agentName, context) {
-    const normalizedName = agentName.toLowerCase();
-    const now = new Date().toISOString();
-    const existing = readRelationshipFile(agentRoot, normalizedName);
-    if (existing) {
-        existing.familiarity += 1;
-        existing.lastInteraction = now;
-        if (context.displayName) {
-            existing.displayName = context.displayName;
-        }
-        if (context.missionId && !existing.sharedMissions.includes(context.missionId)) {
-            existing.sharedMissions.push(context.missionId);
-        }
-        if (context.note) {
-            existing.notes.push(context.note);
-        }
-        writeRelationshipFile(agentRoot, existing);
-        (0, runtime_1.emitNervesEvent)({
-            component: "heart",
-            event: "heart.relationship_updated",
-            message: `relationship updated: ${normalizedName}`,
-            meta: { agentName: normalizedName, familiarity: existing.familiarity },
-        });
-        return existing;
-    }
-    const rel = {
-        agentName: normalizedName,
-        displayName: context.displayName ?? normalizedName,
-        familiarity: 1,
-        trust: "neutral",
-        sharedMissions: context.missionId ? [context.missionId] : [],
-        lastInteraction: now,
-        outcomes: [],
-        notes: context.note ? [context.note] : [],
-    };
-    writeRelationshipFile(agentRoot, rel);
-    (0, runtime_1.emitNervesEvent)({
-        component: "heart",
-        event: "heart.relationship_created",
-        message: `relationship created: ${normalizedName}`,
-        meta: { agentName: normalizedName },
-    });
-    return rel;
-}
-function readRelationships(agentRoot) {
-    const dir = relationshipsDir(agentRoot);
-    if (!fs.existsSync(dir)) {
-        (0, runtime_1.emitNervesEvent)({
-            component: "heart",
-            event: "heart.relationships_read",
-            message: "read relationships: directory missing, returning empty",
-            meta: { count: 0 },
-        });
-        return [];
-    }
-    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
-    const relationships = [];
-    for (const file of files) {
-        try {
-            const content = fs.readFileSync(path.join(dir, file), "utf-8");
-            const rel = JSON.parse(content);
-            relationships.push(rel);
-        }
-        catch {
-            // Skip malformed JSON files
-        }
-    }
-    (0, runtime_1.emitNervesEvent)({
-        component: "heart",
-        event: "heart.relationships_read",
-        message: `read ${relationships.length} relationships`,
-        meta: { count: relationships.length },
-    });
-    return relationships;
-}
-function readRelationship(agentRoot, agentName) {
-    const rel = readRelationshipFile(agentRoot, agentName);
-    (0, runtime_1.emitNervesEvent)({
-        component: "heart",
-        event: "heart.relationship_read",
-        message: rel ? `read relationship: ${agentName.toLowerCase()}` : `relationship not found: ${agentName.toLowerCase()}`,
-        meta: { agentName: agentName.toLowerCase(), found: !!rel },
-    });
-    return rel;
-}
-function recordOutcome(agentRoot, agentName, outcome) {
-    const normalizedName = agentName.toLowerCase();
-    const existing = readRelationshipFile(agentRoot, normalizedName);
-    if (!existing) {
-        throw new Error(`Agent relationship not found: ${normalizedName}`);
-    }
-    existing.outcomes.push(outcome);
-    writeRelationshipFile(agentRoot, existing);
-    (0, runtime_1.emitNervesEvent)({
-        component: "heart",
-        event: "heart.outcome_recorded",
-        message: `outcome recorded for ${normalizedName}: ${outcome.result}`,
-        meta: { agentName: normalizedName, missionId: outcome.missionId, result: outcome.result },
-    });
-    return existing;
-}