@hasna/conversations 0.1.1 → 0.1.3

package/bin/index.js

@@ -2685,7 +2685,7 @@ var init_presence = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.1",
+    version: "0.1.3",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -31627,13 +31627,14 @@ var init_stdio2 = __esm(() => {
 // src/mcp/index.ts
 var exports_mcp = {};
 __export(exports_mcp, {
-  startMcpServer: () => startMcpServer
+  startMcpServer: () => startMcpServer,
+  server: () => server
 });
 async function startMcpServer() {
   const transport = new StdioServerTransport;
   await server.connect(transport);
 }
-var server, isDirectRun;
+var import__package, server, isDirectRun;
 var init_mcp2 = __esm(() => {
   init_mcp();
   init_stdio2();
@@ -31643,14 +31644,16 @@ var init_mcp2 = __esm(() => {
   init_spaces();
   init_projects();
   init_presence();
+  import__package = __toESM(require_package(), 1);
   server = new McpServer({
     name: "conversations",
-    version: "0.1.0"
+    version: import__package.default.version
   });
   server.registerTool("send_message", {
     title: "Send Message",
-    description: "Send a direct message to another agent. The sender is auto-resolved from CONVERSATIONS_AGENT_ID env var.",
+    description: "Send a direct message to another agent. Pass 'from' to identify yourself, or it falls back to CONVERSATIONS_AGENT_ID env var.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID (e.g. 'claude-1', 'assistant'). Falls back to CONVERSATIONS_AGENT_ID env var."),
       to: exports_external.string().describe("Recipient agent ID"),
       content: exports_external.string().describe("Message content"),
       session_id: exports_external.string().optional().describe("Session ID (auto-generated if omitted)"),
@@ -31660,8 +31663,8 @@ var init_mcp2 = __esm(() => {
       branch: exports_external.string().optional().describe("Branch context"),
       metadata: exports_external.string().optional().describe("JSON metadata string")
     }
-  }, async ({ to, content, session_id, priority, working_dir, repository, branch, metadata }) => {
-    const from = resolveIdentity();
+  }, async ({ from: fromParam, to, content, session_id, priority, working_dir, repository, branch, metadata }) => {
+    const from = resolveIdentity(fromParam);
     let parsedMetadata;
     if (metadata) {
       try {
@@ -31722,11 +31725,12 @@ var init_mcp2 = __esm(() => {
     title: "Reply to Message",
     description: "Reply to a message by its ID. Automatically uses the same session and sends to the original sender.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       message_id: exports_external.number().describe("ID of the message to reply to"),
       content: exports_external.string().describe("Reply content"),
       priority: exports_external.enum(["low", "normal", "high", "urgent"]).optional().describe("Message priority")
     }
-  }, async ({ message_id, content, priority }) => {
+  }, async ({ from: fromParam, message_id, content, priority }) => {
     const original = getMessageById(message_id);
     if (!original) {
       return {
@@ -31734,7 +31738,7 @@ var init_mcp2 = __esm(() => {
         isError: true
       };
     }
-    const from = resolveIdentity();
+    const from = resolveIdentity(fromParam);
     const space = original.space || (original.session_id?.startsWith("space:") ? original.session_id.slice(6) : undefined);
     const to = space ? space : original.from_agent === from ? original.to_agent : original.from_agent;
     const msg = sendMessage({
@@ -31753,11 +31757,12 @@ var init_mcp2 = __esm(() => {
     title: "Mark Read",
     description: "Mark message IDs as read for the current agent. Set 'all' to true to mark all unread messages as read.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       ids: exports_external.array(exports_external.number()).optional().describe("Message IDs to mark as read"),
       all: exports_external.boolean().optional().describe("Mark all unread messages as read")
     }
-  }, async ({ ids, all }) => {
-    const agent = resolveIdentity();
+  }, async ({ from: fromParam, ids, all }) => {
+    const agent = resolveIdentity(fromParam);
     let count;
     if (all) {
       count = markAllRead(agent);
@@ -31810,13 +31815,14 @@ var init_mcp2 = __esm(() => {
     title: "Create Space",
     description: "Create a new space. The creator is auto-joined. Spaces can be nested (max 3 levels) and associated with a project.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       name: exports_external.string().describe("Space name (e.g. 'deployments', 'code-review')"),
       description: exports_external.string().optional().describe("Space description"),
       parent_id: exports_external.string().optional().describe("Parent space name for nesting (max 3 levels deep)"),
       project_id: exports_external.string().optional().describe("Project ID to associate this space with")
     }
-  }, async ({ name, description, parent_id, project_id }) => {
-    const agent = resolveIdentity();
+  }, async ({ from: fromParam, name, description, parent_id, project_id }) => {
+    const agent = resolveIdentity(fromParam);
     try {
       const sp = createSpace(name, agent, { description, parent_id, project_id });
       return {
@@ -31863,12 +31869,13 @@ var init_mcp2 = __esm(() => {
     title: "Send to Space",
     description: "Send a message to a space. All members can see it.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       space: exports_external.string().describe("Space name"),
       content: exports_external.string().describe("Message content"),
       priority: exports_external.enum(["low", "normal", "high", "urgent"]).optional().describe("Message priority")
     }
-  }, async ({ space, content, priority }) => {
-    const from = resolveIdentity();
+  }, async ({ from: fromParam, space, content, priority }) => {
+    const from = resolveIdentity(fromParam);
     const sp = getSpace(space);
     if (!sp) {
       return {
@@ -31906,10 +31913,11 @@ var init_mcp2 = __esm(() => {
     title: "Join Space",
     description: "Join a space to receive messages.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       space: exports_external.string().describe("Space name to join")
     }
-  }, async ({ space }) => {
-    const agent = resolveIdentity();
+  }, async ({ from: fromParam, space }) => {
+    const agent = resolveIdentity(fromParam);
     const ok = joinSpace(space, agent);
     if (!ok) {
       return {
@@ -31925,10 +31933,11 @@ var init_mcp2 = __esm(() => {
     title: "Leave Space",
     description: "Leave a space.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       space: exports_external.string().describe("Space name to leave")
     }
-  }, async ({ space }) => {
-    const agent = resolveIdentity();
+  }, async ({ from: fromParam, space }) => {
+    const agent = resolveIdentity(fromParam);
     const left = leaveSpace(space, agent);
     return {
       content: [{ type: "text", text: JSON.stringify({ space, agent, left }, null, 2) }]
@@ -32005,6 +32014,7 @@ var init_mcp2 = __esm(() => {
     title: "Create Project",
     description: "Create a new project. Projects organize spaces and provide context for agent collaboration.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       name: exports_external.string().describe("Project name (unique)"),
       description: exports_external.string().optional().describe("Project description"),
       path: exports_external.string().optional().describe("Absolute path to project on disk"),
@@ -32013,8 +32023,8 @@ var init_mcp2 = __esm(() => {
       metadata: exports_external.string().optional().describe("JSON metadata string"),
       settings: exports_external.string().optional().describe("JSON settings string")
     }
-  }, async ({ name, description, path, repository, tags, metadata, settings }) => {
-    const agent = resolveIdentity();
+  }, async ({ from: fromParam, name, description, path, repository, tags, metadata, settings }) => {
+    const agent = resolveIdentity(fromParam);
     let parsedTags;
     if (tags) {
       try {
@@ -32203,12 +32213,13 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("delete_message", {
     title: "Delete Message",
-    description: "Delete a message. Only the sender can delete their own messages. The agent is auto-resolved.",
+    description: "Delete a message. Only the sender can delete their own messages.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       id: exports_external.number().describe("Message ID to delete")
     }
-  }, async ({ id }) => {
-    const agent = resolveIdentity();
+  }, async ({ from: fromParam, id }) => {
+    const agent = resolveIdentity(fromParam);
     const deleted = deleteMessage(id, agent);
     if (!deleted) {
       return {
@@ -32222,13 +32233,14 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("edit_message", {
     title: "Edit Message",
-    description: "Edit a message's content. Only the sender can edit their own messages. The agent is auto-resolved.",
+    description: "Edit a message's content. Only the sender can edit their own messages.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       id: exports_external.number().describe("Message ID to edit"),
       content: exports_external.string().describe("New message content")
     }
-  }, async ({ id, content }) => {
-    const agent = resolveIdentity();
+  }, async ({ from: fromParam, id, content }) => {
+    const agent = resolveIdentity(fromParam);
     const msg = editMessage(id, agent, content);
     if (!msg) {
       return {
@@ -32292,12 +32304,13 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("heartbeat", {
     title: "Heartbeat",
-    description: "Send a heartbeat to indicate agent is alive. Auto-resolves agent from CONVERSATIONS_AGENT_ID env var. Optionally set a status.",
+    description: "Send a heartbeat to indicate agent is alive. Optionally set a status.",
     inputSchema: {
+      from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
       status: exports_external.string().optional().describe("Agent status (e.g. 'online', 'busy', 'idle'). Defaults to 'online'.")
     }
-  }, async ({ status }) => {
-    const agent = resolveIdentity();
+  }, async ({ from: fromParam, status }) => {
+    const agent = resolveIdentity(fromParam);
     heartbeat(agent, status);
     return {
       content: [{ type: "text", text: JSON.stringify({ agent, status: status || "online", heartbeat: true }, null, 2) }]
@@ -32731,8 +32744,8 @@ function startDashboardServer(port = 3456, host) {
       }
       if (path === "/api/version" && req.method === "GET") {
         try {
-          const pkg = await Promise.resolve().then(() => __toESM(require_package(), 1));
-          const current = pkg.version;
+          const pkg2 = await Promise.resolve().then(() => __toESM(require_package(), 1));
+          const current = pkg2.version;
           const res = await fetch("https://registry.npmjs.org/@hasna/conversations/latest");
           const data = await res.json();
           const latest = data.version;
@@ -32746,8 +32759,8 @@ function startDashboardServer(port = 3456, host) {
           return jsonResponse({ error: "Invalid origin" }, 403);
         }
         try {
-          const pkg = await Promise.resolve().then(() => __toESM(require_package(), 1));
-          const current = pkg.version;
+          const pkg2 = await Promise.resolve().then(() => __toESM(require_package(), 1));
+          const current = pkg2.version;
           const res = await fetch("https://registry.npmjs.org/@hasna/conversations/latest");
           const data = await res.json();
           const latest = data.version;
@@ -33830,8 +33843,9 @@ function App({ agent }) {
 }
 
 // src/cli/index.tsx
+var import__package2 = __toESM(require_package(), 1);
 var program2 = new Command;
-program2.name("conversations").description("Real-time CLI messaging for AI agents").version("0.1.0");
+program2.name("conversations").description("Real-time CLI messaging for AI agents").version(import__package2.default.version);
 program2.command("send").description("Send a message to an agent").argument("<message>", "Message content").requiredOption("--to <agent>", "Recipient agent ID").option("--from <agent>", "Sender agent ID").option("--session <id>", "Session ID (auto-generated if omitted)").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--working-dir <path>", "Working directory context").option("--repository <repo>", "Repository context").option("--branch <branch>", "Branch context").option("--metadata <json>", "JSON metadata string").option("--json", "Output as JSON").action((message, opts) => {
   const from = resolveIdentity(opts.from).trim();
   const to = typeof opts.to === "string" ? opts.to.trim() : "";
@@ -34064,8 +34078,8 @@ program2.command("status").description("Show database stats").option("--json", "
   closeDb();
 });
 program2.command("update").description("Check for and install updates").option("--check", "Only check for updates, don't install").option("--json", "Output as JSON").action(async (opts) => {
-  const pkg = await Promise.resolve().then(() => __toESM(require_package(), 1));
-  const current = pkg.version;
+  const pkg3 = await Promise.resolve().then(() => __toESM(require_package(), 1));
+  const current = pkg3.version;
   let latest;
   try {
     const res = await fetch("https://registry.npmjs.org/@hasna/conversations/latest");

package/bin/mcp.js

@@ -29090,16 +29090,91 @@ function listAgents(opts) {
   const rows = db2.prepare(query).all(...params);
   return rows.map(parsePresence);
 }
+// package.json
+var package_default = {
+  name: "@hasna/conversations",
+  version: "0.1.3",
+  description: "Real-time CLI messaging for AI agents",
+  type: "module",
+  bin: {
+    conversations: "bin/index.js",
+    "conversations-mcp": "bin/mcp.js"
+  },
+  exports: {
+    ".": {
+      import: "./dist/index.js",
+      types: "./dist/index.d.ts"
+    }
+  },
+  files: [
+    "dist/",
+    "bin/",
+    "dashboard/dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  scripts: {
+    build: "bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "build:dashboard": "cd dashboard && bun install && bun run build",
+    test: "bun test",
+    dev: "bun run ./src/cli/index.tsx",
+    typecheck: "tsc --noEmit",
+    prepublishOnly: "bun run build"
+  },
+  keywords: [
+    "conversations",
+    "messaging",
+    "ai",
+    "agent",
+    "cli",
+    "typescript",
+    "bun",
+    "claude",
+    "mcp"
+  ],
+  author: "Hasna",
+  license: "Apache-2.0",
+  devDependencies: {
+    "@types/bun": "latest",
+    "@types/react": "^18.2.0",
+    typescript: "^5"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    chalk: "^5.3.0",
+    commander: "^12.1.0",
+    ink: "^5.0.1",
+    "ink-select-input": "^6.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    react: "^18.2.0",
+    zod: "^4.3.6"
+  },
+  engines: {
+    bun: ">=1.0.0"
+  },
+  publishConfig: {
+    registry: "https://registry.npmjs.org",
+    access: "public"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/hasna/conversations.git"
+  }
+};
 
 // src/mcp/index.ts
 var server = new McpServer({
   name: "conversations",
-  version: "0.1.0"
+  version: package_default.version
 });
 server.registerTool("send_message", {
   title: "Send Message",
-  description: "Send a direct message to another agent. The sender is auto-resolved from CONVERSATIONS_AGENT_ID env var.",
+  description: "Send a direct message to another agent. Pass 'from' to identify yourself, or it falls back to CONVERSATIONS_AGENT_ID env var.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID (e.g. 'claude-1', 'assistant'). Falls back to CONVERSATIONS_AGENT_ID env var."),
     to: exports_external.string().describe("Recipient agent ID"),
     content: exports_external.string().describe("Message content"),
     session_id: exports_external.string().optional().describe("Session ID (auto-generated if omitted)"),
@@ -29109,8 +29184,8 @@ server.registerTool("send_message", {
     branch: exports_external.string().optional().describe("Branch context"),
     metadata: exports_external.string().optional().describe("JSON metadata string")
   }
-}, async ({ to, content, session_id, priority, working_dir, repository, branch, metadata }) => {
-  const from = resolveIdentity();
+}, async ({ from: fromParam, to, content, session_id, priority, working_dir, repository, branch, metadata }) => {
+  const from = resolveIdentity(fromParam);
   let parsedMetadata;
   if (metadata) {
     try {
@@ -29171,11 +29246,12 @@ server.registerTool("reply", {
   title: "Reply to Message",
   description: "Reply to a message by its ID. Automatically uses the same session and sends to the original sender.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     message_id: exports_external.number().describe("ID of the message to reply to"),
     content: exports_external.string().describe("Reply content"),
     priority: exports_external.enum(["low", "normal", "high", "urgent"]).optional().describe("Message priority")
   }
-}, async ({ message_id, content, priority }) => {
+}, async ({ from: fromParam, message_id, content, priority }) => {
   const original = getMessageById(message_id);
   if (!original) {
     return {
@@ -29183,7 +29259,7 @@ server.registerTool("reply", {
       isError: true
     };
   }
-  const from = resolveIdentity();
+  const from = resolveIdentity(fromParam);
   const space = original.space || (original.session_id?.startsWith("space:") ? original.session_id.slice(6) : undefined);
   const to = space ? space : original.from_agent === from ? original.to_agent : original.from_agent;
   const msg = sendMessage({
@@ -29202,11 +29278,12 @@ server.registerTool("mark_read", {
   title: "Mark Read",
   description: "Mark message IDs as read for the current agent. Set 'all' to true to mark all unread messages as read.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     ids: exports_external.array(exports_external.number()).optional().describe("Message IDs to mark as read"),
     all: exports_external.boolean().optional().describe("Mark all unread messages as read")
   }
-}, async ({ ids, all }) => {
-  const agent = resolveIdentity();
+}, async ({ from: fromParam, ids, all }) => {
+  const agent = resolveIdentity(fromParam);
   let count;
   if (all) {
     count = markAllRead(agent);
@@ -29259,13 +29336,14 @@ server.registerTool("create_space", {
   title: "Create Space",
   description: "Create a new space. The creator is auto-joined. Spaces can be nested (max 3 levels) and associated with a project.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     name: exports_external.string().describe("Space name (e.g. 'deployments', 'code-review')"),
     description: exports_external.string().optional().describe("Space description"),
     parent_id: exports_external.string().optional().describe("Parent space name for nesting (max 3 levels deep)"),
     project_id: exports_external.string().optional().describe("Project ID to associate this space with")
   }
-}, async ({ name, description, parent_id, project_id }) => {
-  const agent = resolveIdentity();
+}, async ({ from: fromParam, name, description, parent_id, project_id }) => {
+  const agent = resolveIdentity(fromParam);
   try {
     const sp = createSpace(name, agent, { description, parent_id, project_id });
     return {
@@ -29312,12 +29390,13 @@ server.registerTool("send_to_space", {
   title: "Send to Space",
   description: "Send a message to a space. All members can see it.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     space: exports_external.string().describe("Space name"),
     content: exports_external.string().describe("Message content"),
     priority: exports_external.enum(["low", "normal", "high", "urgent"]).optional().describe("Message priority")
   }
-}, async ({ space, content, priority }) => {
-  const from = resolveIdentity();
+}, async ({ from: fromParam, space, content, priority }) => {
+  const from = resolveIdentity(fromParam);
   const sp = getSpace(space);
   if (!sp) {
     return {
@@ -29355,10 +29434,11 @@ server.registerTool("join_space", {
   title: "Join Space",
   description: "Join a space to receive messages.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     space: exports_external.string().describe("Space name to join")
   }
-}, async ({ space }) => {
-  const agent = resolveIdentity();
+}, async ({ from: fromParam, space }) => {
+  const agent = resolveIdentity(fromParam);
   const ok = joinSpace(space, agent);
   if (!ok) {
     return {
@@ -29374,10 +29454,11 @@ server.registerTool("leave_space", {
   title: "Leave Space",
   description: "Leave a space.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     space: exports_external.string().describe("Space name to leave")
   }
-}, async ({ space }) => {
-  const agent = resolveIdentity();
+}, async ({ from: fromParam, space }) => {
+  const agent = resolveIdentity(fromParam);
   const left = leaveSpace(space, agent);
   return {
     content: [{ type: "text", text: JSON.stringify({ space, agent, left }, null, 2) }]
@@ -29454,6 +29535,7 @@ server.registerTool("create_project", {
   title: "Create Project",
   description: "Create a new project. Projects organize spaces and provide context for agent collaboration.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     name: exports_external.string().describe("Project name (unique)"),
     description: exports_external.string().optional().describe("Project description"),
     path: exports_external.string().optional().describe("Absolute path to project on disk"),
@@ -29462,8 +29544,8 @@ server.registerTool("create_project", {
     metadata: exports_external.string().optional().describe("JSON metadata string"),
     settings: exports_external.string().optional().describe("JSON settings string")
   }
-}, async ({ name, description, path, repository, tags, metadata, settings }) => {
-  const agent = resolveIdentity();
+}, async ({ from: fromParam, name, description, path, repository, tags, metadata, settings }) => {
+  const agent = resolveIdentity(fromParam);
   let parsedTags;
   if (tags) {
     try {
@@ -29652,12 +29734,13 @@ server.registerTool("delete_project", {
 });
 server.registerTool("delete_message", {
   title: "Delete Message",
-  description: "Delete a message. Only the sender can delete their own messages. The agent is auto-resolved.",
+  description: "Delete a message. Only the sender can delete their own messages.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     id: exports_external.number().describe("Message ID to delete")
   }
-}, async ({ id }) => {
-  const agent = resolveIdentity();
+}, async ({ from: fromParam, id }) => {
+  const agent = resolveIdentity(fromParam);
   const deleted = deleteMessage(id, agent);
   if (!deleted) {
     return {
@@ -29671,13 +29754,14 @@ server.registerTool("delete_message", {
 });
 server.registerTool("edit_message", {
   title: "Edit Message",
-  description: "Edit a message's content. Only the sender can edit their own messages. The agent is auto-resolved.",
+  description: "Edit a message's content. Only the sender can edit their own messages.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     id: exports_external.number().describe("Message ID to edit"),
     content: exports_external.string().describe("New message content")
   }
-}, async ({ id, content }) => {
-  const agent = resolveIdentity();
+}, async ({ from: fromParam, id, content }) => {
+  const agent = resolveIdentity(fromParam);
   const msg = editMessage(id, agent, content);
   if (!msg) {
     return {
@@ -29741,12 +29825,13 @@ server.registerTool("get_pinned_messages", {
 });
 server.registerTool("heartbeat", {
   title: "Heartbeat",
-  description: "Send a heartbeat to indicate agent is alive. Auto-resolves agent from CONVERSATIONS_AGENT_ID env var. Optionally set a status.",
+  description: "Send a heartbeat to indicate agent is alive. Optionally set a status.",
   inputSchema: {
+    from: exports_external.string().optional().describe("Your agent ID. Falls back to CONVERSATIONS_AGENT_ID env var."),
     status: exports_external.string().optional().describe("Agent status (e.g. 'online', 'busy', 'idle'). Defaults to 'online'.")
   }
-}, async ({ status }) => {
-  const agent = resolveIdentity();
+}, async ({ from: fromParam, status }) => {
+  const agent = resolveIdentity(fromParam);
   heartbeat(agent, status);
   return {
     content: [{ type: "text", text: JSON.stringify({ agent, status: status || "online", heartbeat: true }, null, 2) }]
@@ -29776,5 +29861,6 @@ if (isDirectRun) {
   });
 }
 export {
-  startMcpServer
+  startMcpServer,
+  server
 };

package/dist/mcp/index.d.ts

@@ -7,4 +7,6 @@
  *   conversations mcp          # Start MCP server on stdio
  *   conversations-mcp          # Direct binary
  */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const server: McpServer;
 export declare function startMcpServer(): Promise<void>;

package/dist/mcp/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

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