@hasna/conversations 0.1.0 → 0.1.2

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.0",
+    version: "0.1.2",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -31627,7 +31627,8 @@ 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;
@@ -31649,8 +31650,9 @@ var init_mcp2 = __esm(() => {
   });
   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 +31662,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 +31724,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 +31737,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 +31756,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 +31814,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 +31868,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 +31912,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 +31932,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 +32013,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 +32022,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 +32212,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 +32232,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 +32303,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) }]
@@ -34614,6 +34626,11 @@ program2.command("dashboard").description("Start web dashboard").option("--port
   startDashboardServer2(port, opts.host);
 });
 program2.action(() => {
+  if (!process.stdin.isTTY) {
+    console.error(chalk2.red("Interactive mode requires a TTY terminal."));
+    console.error(chalk2.dim("Use subcommands (send, read, sessions, etc.) for non-interactive use."));
+    process.exit(1);
+  }
   const agent = resolveIdentity();
   render(React8.createElement(App, { agent }));
 });

package/bin/mcp.js

@@ -29098,8 +29098,9 @@ var server = new McpServer({
 });
 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 +29110,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 +29172,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 +29185,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 +29204,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 +29262,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 +29316,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 +29360,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 +29380,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 +29461,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 +29470,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 +29660,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 +29680,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 +29751,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 +29787,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.0",
+  "version": "0.1.2",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {