@hasna/conversations 0.2.39 → 0.2.41

package/bin/index.js

@@ -13645,6 +13645,14 @@ var init_db = __esm(() => {
 });
 
 // src/lib/identity.ts
+var exports_identity = {};
+__export(exports_identity, {
+  updateCachedAutoName: () => updateCachedAutoName,
+  resolveIdentity: () => resolveIdentity,
+  requireIdentity: () => requireIdentity,
+  getAutoName: () => getAutoName,
+  _resetAutoName: () => _resetAutoName
+});
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, mkdirSync as mkdirSync6 } from "fs";
 import { join as join9, dirname as dirname3 } from "path";
 function isNameTaken(name) {
@@ -13692,6 +13700,15 @@ function resolveIdentity(explicit) {
     return envValue;
   return getAutoName();
 }
+function requireIdentity(explicit) {
+  const explicitValue = explicit?.trim();
+  if (explicitValue)
+    return explicitValue;
+  const envValue = process.env.CONVERSATIONS_AGENT_ID?.trim();
+  if (envValue)
+    return envValue;
+  throw new Error("Agent identity required. Set CONVERSATIONS_AGENT_ID env var or pass --from flag.");
+}
 function updateCachedAutoName(newName) {
   cachedAutoName = newName;
   try {
@@ -13700,6 +13717,9 @@ function updateCachedAutoName(newName) {
 `, "utf-8");
   } catch {}
 }
+function _resetAutoName() {
+  cachedAutoName = null;
+}
 var AGENT_ID_FILE, cachedAutoName = null;
 var init_identity = __esm(() => {
   init_names();
@@ -14914,7 +14934,7 @@ var init_presence = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.39",
+    version: "0.2.41",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -45597,6 +45617,10 @@ var init_projects2 = __esm(() => {
 // src/mcp/channel.ts
 function setSessionAgent(agentId) {
   sessionAgentId = agentId;
+  try {
+    const { updateCachedAutoName: updateCachedAutoName2 } = (init_identity(), __toCommonJS(exports_identity));
+    updateCachedAutoName2(agentId);
+  } catch {}
 }
 function getSessionAgent() {
   return sessionAgentId || process.env.CONVERSATIONS_AGENT_ID || null;
@@ -45631,15 +45655,10 @@ function registerChannelBridge(server) {
         markReadByIds([msg.id]);
       } catch {}
     }
-    const context = [
-      `From: ${msg.from_agent}`,
-      `Mode: ${isDirect ? "direct (auto-injected, auto-read)" : "dm (passive, check inbox)"}`,
-      `Message ID: ${msg.id}`,
-      msg.space ? `Space: ${msg.space}` : null,
-      msg.priority && msg.priority !== "normal" ? `Priority: ${msg.priority}` : null
-    ].filter(Boolean).join(" | ");
-    const enrichedContent = `[${context}]
-${msg.content}`;
+    const enrichedContent = `${msg.content}
+
+---
+[Via Conversations MCP from ${msg.from_agent} (message #${msg.id}). To reply, use the conversations send_message tool with to="${msg.from_agent}"]`;
     server.server.notification({
       method: "notifications/claude/channel",
       params: {
@@ -45664,14 +45683,14 @@ ${msg.content}`;
         const agent = getSessionAgent();
         const sid = getSessionId();
         if (agent) {
-          const msgs = readMessages({ to: agent, order: "asc", limit: 20 }).filter((m) => m.id > lastAgentMsgId);
+          const msgs = readMessages({ to: agent, order: "asc", limit: 20 }).filter((m) => m.id > lastAgentMsgId && m.from_agent !== agent);
           for (const msg of msgs) {
             lastAgentMsgId = msg.id;
             pushNotification(msg, false);
           }
         }
         if (sid) {
-          const msgs = readMessages({ to: `session:${sid}`, order: "asc", limit: 20 }).filter((m) => m.id > lastSessionMsgId);
+          const msgs = readMessages({ to: `session:${sid}`, order: "asc", limit: 20 }).filter((m) => m.id > lastSessionMsgId && m.from_agent !== agent);
           for (const msg of msgs) {
             lastSessionMsgId = msg.id;
             pushNotification(msg, true);
@@ -45690,15 +45709,21 @@ var init_channel = __esm(() => {
 // src/mcp/tools/agents.ts
 function registerAgentTools(server, agentFocus, getAgentFocus) {
   server.registerTool("register_agent", {
-    description: "Register an agent with conflict detection. Returns AgentConflictError if another active session exists (active = heartbeat within last 30 min). Optional project_id locks agent to a project for the session.",
+    description: "Register an agent. Just provide the name \u2014 session_id is auto-detected.",
     inputSchema: {
-      name: exports_external2.string(),
-      session_id: exports_external2.string(),
+      name: exports_external2.string().optional().describe("Agent name"),
+      agent_name: exports_external2.string().optional().describe("Agent name (alias)"),
+      agent_id: exports_external2.string().optional().describe("Agent name (alias)"),
+      session_id: exports_external2.string().optional().describe("Auto-detected from environment, do not set manually"),
       role: exports_external2.string().optional(),
       project_id: exports_external2.string().optional()
     }
   }, async (args) => {
-    const { name, session_id, role, project_id } = args;
+    const { name: nameParam, agent_name, agent_id, session_id: manualSid, role, project_id } = args;
+    const name = nameParam || agent_name || agent_id;
+    if (!name)
+      return { content: [{ type: "text", text: "Error: name is required" }], isError: true };
+    const session_id = manualSid || process.env.CONVERSATIONS_SESSION_ID || `${name}-${Date.now()}`;
     try {
       const result = registerAgent(name, session_id, role, project_id);
       setSessionAgent(name);
@@ -45716,14 +45741,16 @@ function registerAgentTools(server, agentFocus, getAgentFocus) {
     }
   });
   server.registerTool("heartbeat", {
-    description: "Send presence heartbeat.",
+    description: "Send presence heartbeat. Use 'from' or 'name' to set agent identity.",
     inputSchema: {
-      from: exports_external2.string().optional(),
+      from: exports_external2.string().optional().describe("Agent name"),
+      name: exports_external2.string().optional().describe("Agent name (alias for from)"),
+      agent_name: exports_external2.string().optional().describe("Agent name (alias for from)"),
       status: exports_external2.string().optional()
     }
   }, async (args) => {
-    const { from: fromParam, status } = args;
-    const agent = resolveIdentity(fromParam);
+    const { from: fromParam, name: nameParam, agent_name, status } = args;
+    const agent = resolveIdentity(fromParam || nameParam || agent_name);
     heartbeat(agent, status);
     setSessionAgent(agent);
     return {

package/bin/mcp.js

@@ -17924,6 +17924,441 @@ var init_db = __esm(() => {
   init_dist();
 });
 
+// src/lib/names.ts
+var AGENT_NAMES;
+var init_names = __esm(() => {
+  AGENT_NAMES = [
+    "amber-fox",
+    "arctic-wolf",
+    "ashen-crow",
+    "azure-hawk",
+    "astral-lynx",
+    "autumn-bear",
+    "agile-puma",
+    "alpine-ibex",
+    "ancient-owl",
+    "aqua-otter",
+    "arid-viper",
+    "atom-finch",
+    "auburn-deer",
+    "aurora-seal",
+    "avid-mink",
+    "blaze-tiger",
+    "bright-heron",
+    "bronze-eagle",
+    "brisk-hare",
+    "burnt-moth",
+    "bold-raven",
+    "blue-whale",
+    "boreal-fox",
+    "brass-cobra",
+    "brave-ram",
+    "brick-crane",
+    "brief-newt",
+    "briny-crab",
+    "broad-elk",
+    "brook-dove",
+    "calm-panda",
+    "cedar-jay",
+    "chief-lion",
+    "chrome-bat",
+    "civic-wren",
+    "clear-swan",
+    "cliff-goat",
+    "coal-shark",
+    "cold-crane",
+    "copper-jay",
+    "coral-fish",
+    "crisp-lark",
+    "cross-mole",
+    "cubic-wasp",
+    "cyan-toad",
+    "dark-stag",
+    "dawn-robin",
+    "deep-squid",
+    "delta-fox",
+    "dense-boar",
+    "dew-spider",
+    "dim-gecko",
+    "draft-bear",
+    "drift-gull",
+    "dry-newt",
+    "dual-crane",
+    "dune-mouse",
+    "dusk-moth",
+    "dusty-mule",
+    "dwarf-carp",
+    "east-falcon",
+    "echo-parrot",
+    "edge-shark",
+    "elm-beetle",
+    "ember-lynx",
+    "epoch-crane",
+    "even-pike",
+    "extra-ant",
+    "elder-stork",
+    "ebon-crow",
+    "ever-finch",
+    "exact-moth",
+    "exile-wren",
+    "equal-dove",
+    "etch-hare",
+    "faint-orca",
+    "far-condor",
+    "fern-mouse",
+    "fierce-yak",
+    "first-kite",
+    "fjord-seal",
+    "flint-wolf",
+    "fog-parrot",
+    "forge-bull",
+    "fossil-ray",
+    "frank-mink",
+    "free-eagle",
+    "fresh-colt",
+    "frost-bear",
+    "fuse-wasp",
+    "gale-hawk",
+    "gem-turtle",
+    "ghost-lynx",
+    "gilt-robin",
+    "glad-moose",
+    "glass-eel",
+    "gleam-puma",
+    "glyph-owl",
+    "gold-crane",
+    "gorge-lion",
+    "grain-duck",
+    "grand-wolf",
+    "gray-fox",
+    "green-hare",
+    "grit-shark",
+    "half-stork",
+    "haze-panther",
+    "heart-dove",
+    "helm-eagle",
+    "herb-toad",
+    "hex-spider",
+    "high-falcon",
+    "hive-hornet",
+    "holo-swan",
+    "hood-cobra",
+    "horn-bison",
+    "huge-squid",
+    "hull-crab",
+    "hunt-marten",
+    "husk-moth",
+    "ice-leopard",
+    "idle-crane",
+    "inch-beetle",
+    "indigo-jay",
+    "inner-fox",
+    "ion-parrot",
+    "iron-bull",
+    "isle-pelican",
+    "ivory-hawk",
+    "ivy-snake",
+    "iota-wren",
+    "ink-raven",
+    "ignite-ram",
+    "inert-slug",
+    "infra-mole",
+    "jade-tiger",
+    "jest-magpie",
+    "jewel-crane",
+    "joint-boar",
+    "jovial-elk",
+    "jump-frog",
+    "jungle-cat",
+    "jury-dove",
+    "just-heron",
+    "jolt-wasp",
+    "keen-osprey",
+    "kelp-seal",
+    "key-falcon",
+    "kind-panda",
+    "knot-viper",
+    "kraft-bear",
+    "kite-mouse",
+    "knoll-deer",
+    "know-crane",
+    "karma-wolf",
+    "lake-otter",
+    "lapis-jay",
+    "last-condor",
+    "leaf-gecko",
+    "lean-coyote",
+    "light-lynx",
+    "lime-parrot",
+    "live-eagle",
+    "long-crane",
+    "lost-fox",
+    "loud-finch",
+    "low-shark",
+    "luck-rabbit",
+    "lunar-owl",
+    "lush-ibis",
+    "malt-badger",
+    "maple-wren",
+    "mars-falcon",
+    "matte-crow",
+    "mesa-hawk",
+    "mild-orca",
+    "mint-dove",
+    "mist-puma",
+    "mock-robin",
+    "mono-wolf",
+    "moon-bear",
+    "moss-turtle",
+    "mud-heron",
+    "mute-swan",
+    "myth-lynx",
+    "navy-eagle",
+    "near-mink",
+    "neon-parrot",
+    "nest-crane",
+    "next-fox",
+    "nimble-ram",
+    "node-spider",
+    "noon-hawk",
+    "north-seal",
+    "nova-owl",
+    "null-moth",
+    "numb-carp",
+    "nutmeg-jay",
+    "neat-cobra",
+    "nomad-elk",
+    "oak-badger",
+    "oat-finch",
+    "odd-pelican",
+    "olive-bear",
+    "onyx-raven",
+    "opal-crane",
+    "open-wolf",
+    "orbit-lynx",
+    "ore-shark",
+    "outer-dove",
+    "pale-tiger",
+    "park-heron",
+    "peak-eagle",
+    "pine-fox",
+    "pixel-owl",
+    "plain-goat",
+    "plum-crane",
+    "polar-ray",
+    "port-falcon",
+    "prime-wolf",
+    "prism-jay",
+    "proud-lion",
+    "pulse-bat",
+    "pure-swan",
+    "pyro-hawk",
+    "quake-bear",
+    "quartz-jay",
+    "quest-falcon",
+    "quick-otter",
+    "quiet-crane",
+    "rain-leopard",
+    "rapid-hare",
+    "raw-condor",
+    "reef-dolphin",
+    "regal-stag",
+    "ridge-fox",
+    "rift-cobra",
+    "rigid-crane",
+    "river-otter",
+    "rock-eagle",
+    "root-mole",
+    "rose-finch",
+    "rough-boar",
+    "ruby-hawk",
+    "rust-wolf",
+    "sage-owl",
+    "salt-crane",
+    "sand-viper",
+    "satin-dove",
+    "scale-dragon",
+    "scarlet-ibis",
+    "sea-falcon",
+    "shade-lynx",
+    "sharp-eagle",
+    "shell-crab",
+    "short-fox",
+    "sigma-jay",
+    "silk-moth",
+    "silver-wolf",
+    "slate-bear",
+    "slim-heron",
+    "smoke-puma",
+    "snap-turtle",
+    "snow-leopard",
+    "solar-crane",
+    "solid-ram",
+    "sonic-bat",
+    "south-seal",
+    "spark-robin",
+    "spice-wren",
+    "split-mink",
+    "spring-elk",
+    "squid-ink",
+    "stark-crow",
+    "steel-hawk",
+    "stern-bull",
+    "still-swan",
+    "stone-fox",
+    "storm-eagle",
+    "stout-boar",
+    "stray-cat",
+    "strong-lion",
+    "sun-parrot",
+    "surf-dolphin",
+    "swift-deer",
+    "teal-crane",
+    "terra-wolf",
+    "thick-bear",
+    "thin-spider",
+    "third-owl",
+    "thorn-fox",
+    "tide-seal",
+    "timber-jay",
+    "tiny-wren",
+    "toast-mole",
+    "topaz-hawk",
+    "torch-lynx",
+    "trace-falcon",
+    "true-eagle",
+    "tusk-walrus",
+    "ultra-crane",
+    "umbra-wolf",
+    "unit-fox",
+    "upper-hawk",
+    "urban-jay",
+    "vale-deer",
+    "vast-eagle",
+    "vault-bear",
+    "velvet-owl",
+    "vent-crane",
+    "verse-fox",
+    "vigor-lynx",
+    "vine-parrot",
+    "vivid-swan",
+    "void-raven",
+    "volt-hawk",
+    "vow-falcon",
+    "vintage-jay",
+    "vista-wolf",
+    "vital-hare",
+    "warm-otter",
+    "wave-dolphin",
+    "wax-crane",
+    "west-falcon",
+    "wheat-mouse",
+    "white-tiger",
+    "wide-eagle",
+    "wild-fox",
+    "wind-hawk",
+    "wire-spider",
+    "wise-owl",
+    "wood-thrush",
+    "wool-ram",
+    "wren-song",
+    "wry-crow",
+    "xeno-crane",
+    "xerus-fox",
+    "yarn-robin",
+    "yew-falcon",
+    "young-wolf",
+    "zeal-hawk",
+    "zen-panda",
+    "zero-crane",
+    "zinc-eagle",
+    "zone-fox"
+  ];
+});
+
+// src/lib/identity.ts
+var exports_identity = {};
+__export(exports_identity, {
+  updateCachedAutoName: () => updateCachedAutoName,
+  resolveIdentity: () => resolveIdentity,
+  requireIdentity: () => requireIdentity,
+  getAutoName: () => getAutoName,
+  _resetAutoName: () => _resetAutoName
+});
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync3, mkdirSync as mkdirSync7 } from "fs";
+import { join as join11, dirname as dirname3 } from "path";
+function isNameTaken(name) {
+  try {
+    const { getDb: getDb2 } = (init_db(), __toCommonJS(exports_db));
+    const db2 = getDb2();
+    const row = db2.prepare("SELECT agent FROM agent_presence WHERE agent = ?").get(name);
+    return !!row;
+  } catch {
+    return false;
+  }
+}
+function getAutoName() {
+  if (cachedAutoName)
+    return cachedAutoName;
+  try {
+    const name2 = readFileSync5(AGENT_ID_FILE, "utf-8").trim();
+    if (name2) {
+      cachedAutoName = name2;
+      return name2;
+    }
+  } catch {}
+  const shuffled = [...AGENT_NAMES].sort(() => Math.random() - 0.5);
+  let name = shuffled[0];
+  for (const candidate of shuffled) {
+    if (!isNameTaken(candidate)) {
+      name = candidate;
+      break;
+    }
+  }
+  cachedAutoName = name;
+  try {
+    mkdirSync7(dirname3(AGENT_ID_FILE), { recursive: true });
+    writeFileSync3(AGENT_ID_FILE, name + `
+`, "utf-8");
+  } catch {}
+  return name;
+}
+function resolveIdentity(explicit) {
+  const explicitValue = explicit?.trim();
+  if (explicitValue)
+    return explicitValue;
+  const envValue = process.env.CONVERSATIONS_AGENT_ID?.trim();
+  if (envValue)
+    return envValue;
+  return getAutoName();
+}
+function requireIdentity(explicit) {
+  const explicitValue = explicit?.trim();
+  if (explicitValue)
+    return explicitValue;
+  const envValue = process.env.CONVERSATIONS_AGENT_ID?.trim();
+  if (envValue)
+    return envValue;
+  throw new Error("Agent identity required. Set CONVERSATIONS_AGENT_ID env var or pass --from flag.");
+}
+function updateCachedAutoName(newName) {
+  cachedAutoName = newName;
+  try {
+    mkdirSync7(dirname3(AGENT_ID_FILE), { recursive: true });
+    writeFileSync3(AGENT_ID_FILE, newName + `
+`, "utf-8");
+  } catch {}
+}
+function _resetAutoName() {
+  cachedAutoName = null;
+}
+var AGENT_ID_FILE, cachedAutoName = null;
+var init_identity = __esm(() => {
+  init_names();
+  init_db();
+  AGENT_ID_FILE = join11(getDataDir2(), "agent-id");
+});
+
 // src/lib/pg-migrations.ts
 var exports_pg_migrations = {};
 __export(exports_pg_migrations, {
@@ -40793,418 +41228,8 @@ function getSessionActivity(sessionId) {
   };
 }
 
-// src/lib/identity.ts
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync3, mkdirSync as mkdirSync7 } from "fs";
-import { join as join11, dirname as dirname3 } from "path";
-
-// src/lib/names.ts
-var AGENT_NAMES = [
-  "amber-fox",
-  "arctic-wolf",
-  "ashen-crow",
-  "azure-hawk",
-  "astral-lynx",
-  "autumn-bear",
-  "agile-puma",
-  "alpine-ibex",
-  "ancient-owl",
-  "aqua-otter",
-  "arid-viper",
-  "atom-finch",
-  "auburn-deer",
-  "aurora-seal",
-  "avid-mink",
-  "blaze-tiger",
-  "bright-heron",
-  "bronze-eagle",
-  "brisk-hare",
-  "burnt-moth",
-  "bold-raven",
-  "blue-whale",
-  "boreal-fox",
-  "brass-cobra",
-  "brave-ram",
-  "brick-crane",
-  "brief-newt",
-  "briny-crab",
-  "broad-elk",
-  "brook-dove",
-  "calm-panda",
-  "cedar-jay",
-  "chief-lion",
-  "chrome-bat",
-  "civic-wren",
-  "clear-swan",
-  "cliff-goat",
-  "coal-shark",
-  "cold-crane",
-  "copper-jay",
-  "coral-fish",
-  "crisp-lark",
-  "cross-mole",
-  "cubic-wasp",
-  "cyan-toad",
-  "dark-stag",
-  "dawn-robin",
-  "deep-squid",
-  "delta-fox",
-  "dense-boar",
-  "dew-spider",
-  "dim-gecko",
-  "draft-bear",
-  "drift-gull",
-  "dry-newt",
-  "dual-crane",
-  "dune-mouse",
-  "dusk-moth",
-  "dusty-mule",
-  "dwarf-carp",
-  "east-falcon",
-  "echo-parrot",
-  "edge-shark",
-  "elm-beetle",
-  "ember-lynx",
-  "epoch-crane",
-  "even-pike",
-  "extra-ant",
-  "elder-stork",
-  "ebon-crow",
-  "ever-finch",
-  "exact-moth",
-  "exile-wren",
-  "equal-dove",
-  "etch-hare",
-  "faint-orca",
-  "far-condor",
-  "fern-mouse",
-  "fierce-yak",
-  "first-kite",
-  "fjord-seal",
-  "flint-wolf",
-  "fog-parrot",
-  "forge-bull",
-  "fossil-ray",
-  "frank-mink",
-  "free-eagle",
-  "fresh-colt",
-  "frost-bear",
-  "fuse-wasp",
-  "gale-hawk",
-  "gem-turtle",
-  "ghost-lynx",
-  "gilt-robin",
-  "glad-moose",
-  "glass-eel",
-  "gleam-puma",
-  "glyph-owl",
-  "gold-crane",
-  "gorge-lion",
-  "grain-duck",
-  "grand-wolf",
-  "gray-fox",
-  "green-hare",
-  "grit-shark",
-  "half-stork",
-  "haze-panther",
-  "heart-dove",
-  "helm-eagle",
-  "herb-toad",
-  "hex-spider",
-  "high-falcon",
-  "hive-hornet",
-  "holo-swan",
-  "hood-cobra",
-  "horn-bison",
-  "huge-squid",
-  "hull-crab",
-  "hunt-marten",
-  "husk-moth",
-  "ice-leopard",
-  "idle-crane",
-  "inch-beetle",
-  "indigo-jay",
-  "inner-fox",
-  "ion-parrot",
-  "iron-bull",
-  "isle-pelican",
-  "ivory-hawk",
-  "ivy-snake",
-  "iota-wren",
-  "ink-raven",
-  "ignite-ram",
-  "inert-slug",
-  "infra-mole",
-  "jade-tiger",
-  "jest-magpie",
-  "jewel-crane",
-  "joint-boar",
-  "jovial-elk",
-  "jump-frog",
-  "jungle-cat",
-  "jury-dove",
-  "just-heron",
-  "jolt-wasp",
-  "keen-osprey",
-  "kelp-seal",
-  "key-falcon",
-  "kind-panda",
-  "knot-viper",
-  "kraft-bear",
-  "kite-mouse",
-  "knoll-deer",
-  "know-crane",
-  "karma-wolf",
-  "lake-otter",
-  "lapis-jay",
-  "last-condor",
-  "leaf-gecko",
-  "lean-coyote",
-  "light-lynx",
-  "lime-parrot",
-  "live-eagle",
-  "long-crane",
-  "lost-fox",
-  "loud-finch",
-  "low-shark",
-  "luck-rabbit",
-  "lunar-owl",
-  "lush-ibis",
-  "malt-badger",
-  "maple-wren",
-  "mars-falcon",
-  "matte-crow",
-  "mesa-hawk",
-  "mild-orca",
-  "mint-dove",
-  "mist-puma",
-  "mock-robin",
-  "mono-wolf",
-  "moon-bear",
-  "moss-turtle",
-  "mud-heron",
-  "mute-swan",
-  "myth-lynx",
-  "navy-eagle",
-  "near-mink",
-  "neon-parrot",
-  "nest-crane",
-  "next-fox",
-  "nimble-ram",
-  "node-spider",
-  "noon-hawk",
-  "north-seal",
-  "nova-owl",
-  "null-moth",
-  "numb-carp",
-  "nutmeg-jay",
-  "neat-cobra",
-  "nomad-elk",
-  "oak-badger",
-  "oat-finch",
-  "odd-pelican",
-  "olive-bear",
-  "onyx-raven",
-  "opal-crane",
-  "open-wolf",
-  "orbit-lynx",
-  "ore-shark",
-  "outer-dove",
-  "pale-tiger",
-  "park-heron",
-  "peak-eagle",
-  "pine-fox",
-  "pixel-owl",
-  "plain-goat",
-  "plum-crane",
-  "polar-ray",
-  "port-falcon",
-  "prime-wolf",
-  "prism-jay",
-  "proud-lion",
-  "pulse-bat",
-  "pure-swan",
-  "pyro-hawk",
-  "quake-bear",
-  "quartz-jay",
-  "quest-falcon",
-  "quick-otter",
-  "quiet-crane",
-  "rain-leopard",
-  "rapid-hare",
-  "raw-condor",
-  "reef-dolphin",
-  "regal-stag",
-  "ridge-fox",
-  "rift-cobra",
-  "rigid-crane",
-  "river-otter",
-  "rock-eagle",
-  "root-mole",
-  "rose-finch",
-  "rough-boar",
-  "ruby-hawk",
-  "rust-wolf",
-  "sage-owl",
-  "salt-crane",
-  "sand-viper",
-  "satin-dove",
-  "scale-dragon",
-  "scarlet-ibis",
-  "sea-falcon",
-  "shade-lynx",
-  "sharp-eagle",
-  "shell-crab",
-  "short-fox",
-  "sigma-jay",
-  "silk-moth",
-  "silver-wolf",
-  "slate-bear",
-  "slim-heron",
-  "smoke-puma",
-  "snap-turtle",
-  "snow-leopard",
-  "solar-crane",
-  "solid-ram",
-  "sonic-bat",
-  "south-seal",
-  "spark-robin",
-  "spice-wren",
-  "split-mink",
-  "spring-elk",
-  "squid-ink",
-  "stark-crow",
-  "steel-hawk",
-  "stern-bull",
-  "still-swan",
-  "stone-fox",
-  "storm-eagle",
-  "stout-boar",
-  "stray-cat",
-  "strong-lion",
-  "sun-parrot",
-  "surf-dolphin",
-  "swift-deer",
-  "teal-crane",
-  "terra-wolf",
-  "thick-bear",
-  "thin-spider",
-  "third-owl",
-  "thorn-fox",
-  "tide-seal",
-  "timber-jay",
-  "tiny-wren",
-  "toast-mole",
-  "topaz-hawk",
-  "torch-lynx",
-  "trace-falcon",
-  "true-eagle",
-  "tusk-walrus",
-  "ultra-crane",
-  "umbra-wolf",
-  "unit-fox",
-  "upper-hawk",
-  "urban-jay",
-  "vale-deer",
-  "vast-eagle",
-  "vault-bear",
-  "velvet-owl",
-  "vent-crane",
-  "verse-fox",
-  "vigor-lynx",
-  "vine-parrot",
-  "vivid-swan",
-  "void-raven",
-  "volt-hawk",
-  "vow-falcon",
-  "vintage-jay",
-  "vista-wolf",
-  "vital-hare",
-  "warm-otter",
-  "wave-dolphin",
-  "wax-crane",
-  "west-falcon",
-  "wheat-mouse",
-  "white-tiger",
-  "wide-eagle",
-  "wild-fox",
-  "wind-hawk",
-  "wire-spider",
-  "wise-owl",
-  "wood-thrush",
-  "wool-ram",
-  "wren-song",
-  "wry-crow",
-  "xeno-crane",
-  "xerus-fox",
-  "yarn-robin",
-  "yew-falcon",
-  "young-wolf",
-  "zeal-hawk",
-  "zen-panda",
-  "zero-crane",
-  "zinc-eagle",
-  "zone-fox"
-];
-
-// src/lib/identity.ts
-init_db();
-var AGENT_ID_FILE = join11(getDataDir2(), "agent-id");
-var cachedAutoName = null;
-function isNameTaken(name) {
-  try {
-    const { getDb: getDb2 } = (init_db(), __toCommonJS(exports_db));
-    const db2 = getDb2();
-    const row = db2.prepare("SELECT agent FROM agent_presence WHERE agent = ?").get(name);
-    return !!row;
-  } catch {
-    return false;
-  }
-}
-function getAutoName() {
-  if (cachedAutoName)
-    return cachedAutoName;
-  try {
-    const name2 = readFileSync5(AGENT_ID_FILE, "utf-8").trim();
-    if (name2) {
-      cachedAutoName = name2;
-      return name2;
-    }
-  } catch {}
-  const shuffled = [...AGENT_NAMES].sort(() => Math.random() - 0.5);
-  let name = shuffled[0];
-  for (const candidate of shuffled) {
-    if (!isNameTaken(candidate)) {
-      name = candidate;
-      break;
-    }
-  }
-  cachedAutoName = name;
-  try {
-    mkdirSync7(dirname3(AGENT_ID_FILE), { recursive: true });
-    writeFileSync3(AGENT_ID_FILE, name + `
-`, "utf-8");
-  } catch {}
-  return name;
-}
-function resolveIdentity(explicit) {
-  const explicitValue = explicit?.trim();
-  if (explicitValue)
-    return explicitValue;
-  const envValue = process.env.CONVERSATIONS_AGENT_ID?.trim();
-  if (envValue)
-    return envValue;
-  return getAutoName();
-}
-function updateCachedAutoName(newName) {
-  cachedAutoName = newName;
-  try {
-    mkdirSync7(dirname3(AGENT_ID_FILE), { recursive: true });
-    writeFileSync3(AGENT_ID_FILE, newName + `
-`, "utf-8");
-  } catch {}
-}
-
 // src/mcp/tools/messaging.ts
+init_identity();
 function registerMessagingTools(server, resolveProjectId) {
   server.registerTool("send_message", {
     description: "Send a DM to an agent by name, or to a specific agent-claude session by ID. When target_session_id is provided, the message is routed to that exact session and auto-injected into its conversation.",
@@ -41732,6 +41757,7 @@ function unarchiveSpace(name) {
 }
 
 // src/mcp/tools/spaces.ts
+init_identity();
 function registerSpaceTools(server) {
   server.registerTool("create_space", {
     description: "Create a space and auto-join.",
@@ -42224,6 +42250,7 @@ function deleteProject(id) {
 }
 
 // src/mcp/tools/projects.ts
+init_identity();
 function registerProjectTools(server) {
   server.registerTool("create_project", {
     description: "Create a project for agent collaboration.",
@@ -42426,11 +42453,18 @@ function registerProjectTools(server) {
   });
 }
 
+// src/mcp/tools/agents.ts
+init_identity();
+
 // src/mcp/channel.ts
 var POLL_INTERVAL_MS = 1000;
 var sessionAgentId = null;
 function setSessionAgent(agentId) {
   sessionAgentId = agentId;
+  try {
+    const { updateCachedAutoName: updateCachedAutoName2 } = (init_identity(), __toCommonJS(exports_identity));
+    updateCachedAutoName2(agentId);
+  } catch {}
 }
 function getSessionAgent() {
   return sessionAgentId || process.env.CONVERSATIONS_AGENT_ID || null;
@@ -42465,15 +42499,10 @@ function registerChannelBridge(server) {
         markReadByIds([msg.id]);
       } catch {}
     }
-    const context = [
-      `From: ${msg.from_agent}`,
-      `Mode: ${isDirect ? "direct (auto-injected, auto-read)" : "dm (passive, check inbox)"}`,
-      `Message ID: ${msg.id}`,
-      msg.space ? `Space: ${msg.space}` : null,
-      msg.priority && msg.priority !== "normal" ? `Priority: ${msg.priority}` : null
-    ].filter(Boolean).join(" | ");
-    const enrichedContent = `[${context}]
-${msg.content}`;
+    const enrichedContent = `${msg.content}
+
+---
+[Via Conversations MCP from ${msg.from_agent} (message #${msg.id}). To reply, use the conversations send_message tool with to="${msg.from_agent}"]`;
     server.server.notification({
       method: "notifications/claude/channel",
       params: {
@@ -42498,14 +42527,14 @@ ${msg.content}`;
         const agent = getSessionAgent();
         const sid = getSessionId();
         if (agent) {
-          const msgs = readMessages({ to: agent, order: "asc", limit: 20 }).filter((m) => m.id > lastAgentMsgId);
+          const msgs = readMessages({ to: agent, order: "asc", limit: 20 }).filter((m) => m.id > lastAgentMsgId && m.from_agent !== agent);
           for (const msg of msgs) {
             lastAgentMsgId = msg.id;
             pushNotification(msg, false);
           }
         }
         if (sid) {
-          const msgs = readMessages({ to: `session:${sid}`, order: "asc", limit: 20 }).filter((m) => m.id > lastSessionMsgId);
+          const msgs = readMessages({ to: `session:${sid}`, order: "asc", limit: 20 }).filter((m) => m.id > lastSessionMsgId && m.from_agent !== agent);
           for (const msg of msgs) {
             lastSessionMsgId = msg.id;
             pushNotification(msg, true);
@@ -42520,15 +42549,21 @@ ${msg.content}`;
 // src/mcp/tools/agents.ts
 function registerAgentTools(server, agentFocus, getAgentFocus) {
   server.registerTool("register_agent", {
-    description: "Register an agent with conflict detection. Returns AgentConflictError if another active session exists (active = heartbeat within last 30 min). Optional project_id locks agent to a project for the session.",
+    description: "Register an agent. Just provide the name \u2014 session_id is auto-detected.",
     inputSchema: {
-      name: exports_external.string(),
-      session_id: exports_external.string(),
+      name: exports_external.string().optional().describe("Agent name"),
+      agent_name: exports_external.string().optional().describe("Agent name (alias)"),
+      agent_id: exports_external.string().optional().describe("Agent name (alias)"),
+      session_id: exports_external.string().optional().describe("Auto-detected from environment, do not set manually"),
       role: exports_external.string().optional(),
       project_id: exports_external.string().optional()
     }
   }, async (args) => {
-    const { name, session_id, role, project_id } = args;
+    const { name: nameParam, agent_name, agent_id, session_id: manualSid, role, project_id } = args;
+    const name = nameParam || agent_name || agent_id;
+    if (!name)
+      return { content: [{ type: "text", text: "Error: name is required" }], isError: true };
+    const session_id = manualSid || process.env.CONVERSATIONS_SESSION_ID || `${name}-${Date.now()}`;
     try {
       const result = registerAgent(name, session_id, role, project_id);
       setSessionAgent(name);
@@ -42546,14 +42581,16 @@ function registerAgentTools(server, agentFocus, getAgentFocus) {
     }
   });
   server.registerTool("heartbeat", {
-    description: "Send presence heartbeat.",
+    description: "Send presence heartbeat. Use 'from' or 'name' to set agent identity.",
     inputSchema: {
-      from: exports_external.string().optional(),
+      from: exports_external.string().optional().describe("Agent name"),
+      name: exports_external.string().optional().describe("Agent name (alias for from)"),
+      agent_name: exports_external.string().optional().describe("Agent name (alias for from)"),
       status: exports_external.string().optional()
     }
   }, async (args) => {
-    const { from: fromParam, status } = args;
-    const agent = resolveIdentity(fromParam);
+    const { from: fromParam, name: nameParam, agent_name, status } = args;
+    const agent = resolveIdentity(fromParam || nameParam || agent_name);
     heartbeat(agent, status);
     setSessionAgent(agent);
     return {
@@ -42709,6 +42746,9 @@ function registerAgentTools(server, agentFocus, getAgentFocus) {
   });
 }
 
+// src/mcp/tools/advanced.ts
+init_identity();
+
 // src/lib/reactions.ts
 init_db();
 function addReaction(messageId, agent, emoji3) {
@@ -44406,7 +44446,7 @@ function registerTmuxTools(server) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.39",
+  version: "0.2.41",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/conversations",
-  "version": "0.2.39",
+  "version": "0.2.41",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {