@hasna/conversations 0.2.40 → 0.2.42

package/bin/index.js

@@ -14934,7 +14934,7 @@ var init_presence = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.40",
+    version: "0.2.42",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -45615,16 +45615,24 @@ var init_projects2 = __esm(() => {
 });
 
 // src/mcp/channel.ts
-function setSessionAgent(agentId) {
+function setSessionAgent(agentId, claudeSessionId) {
   sessionAgentId = agentId;
+  if (claudeSessionId)
+    sessionClaudeId = claudeSessionId;
   try {
     const { updateCachedAutoName: updateCachedAutoName2 } = (init_identity(), __toCommonJS(exports_identity));
     updateCachedAutoName2(agentId);
   } catch {}
 }
+function setClaudeSessionId(id) {
+  sessionClaudeId = id;
+}
 function getSessionAgent() {
   return sessionAgentId || process.env.CONVERSATIONS_AGENT_ID || null;
 }
+function getClaudeSessionId() {
+  return sessionClaudeId || process.env.CONVERSATIONS_SESSION_ID || null;
+}
 function registerChannelBridge(server) {
   server.server.registerCapabilities({
     experimental: { "claude/channel": {} }
@@ -45633,7 +45641,7 @@ function registerChannelBridge(server) {
   let lastSessionMsgId = 0;
   let pollTimer = null;
   function getSessionId() {
-    return process.env.CONVERSATIONS_SESSION_ID || null;
+    return getClaudeSessionId();
   }
   function seedLastSeen() {
     const agent = getSessionAgent();
@@ -45655,15 +45663,12 @@ 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 senderSession = msg.session_id;
+    const replyHint = `To reply, use conversations send_message with to="${msg.from_agent}". For direct session injection, use send_to_session with target_session_id from the sender's session.`;
+    const enrichedContent = `${msg.content}
+
+---
+[Via Conversations from ${msg.from_agent} (msg #${msg.id}). ${replyHint}]`;
     server.server.notification({
       method: "notifications/claude/channel",
       params: {
@@ -45706,7 +45711,7 @@ ${msg.content}`;
   }
   setTimeout(() => startPolling2(), 2000);
 }
-var POLL_INTERVAL_MS = 1000, sessionAgentId = null;
+var POLL_INTERVAL_MS = 1000, sessionAgentId = null, sessionClaudeId = null;
 var init_channel = __esm(() => {
   init_messages();
 });
@@ -45714,18 +45719,27 @@ 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 claudeSid = process.env.CONVERSATIONS_SESSION_ID || null;
+    const session_id = manualSid || claudeSid || `${name}-${Date.now()}`;
     try {
       const result = registerAgent(name, session_id, role, project_id);
       setSessionAgent(name);
+      if (claudeSid)
+        setClaudeSessionId(claudeSid);
       return {
         content: [{ type: "text", text: JSON.stringify(result) }]
       };
@@ -45740,14 +45754,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

@@ -42459,16 +42459,25 @@ init_identity();
 // src/mcp/channel.ts
 var POLL_INTERVAL_MS = 1000;
 var sessionAgentId = null;
-function setSessionAgent(agentId) {
+var sessionClaudeId = null;
+function setSessionAgent(agentId, claudeSessionId) {
   sessionAgentId = agentId;
+  if (claudeSessionId)
+    sessionClaudeId = claudeSessionId;
   try {
     const { updateCachedAutoName: updateCachedAutoName2 } = (init_identity(), __toCommonJS(exports_identity));
     updateCachedAutoName2(agentId);
   } catch {}
 }
+function setClaudeSessionId(id) {
+  sessionClaudeId = id;
+}
 function getSessionAgent() {
   return sessionAgentId || process.env.CONVERSATIONS_AGENT_ID || null;
 }
+function getClaudeSessionId() {
+  return sessionClaudeId || process.env.CONVERSATIONS_SESSION_ID || null;
+}
 function registerChannelBridge(server) {
   server.server.registerCapabilities({
     experimental: { "claude/channel": {} }
@@ -42477,7 +42486,7 @@ function registerChannelBridge(server) {
   let lastSessionMsgId = 0;
   let pollTimer = null;
   function getSessionId() {
-    return process.env.CONVERSATIONS_SESSION_ID || null;
+    return getClaudeSessionId();
   }
   function seedLastSeen() {
     const agent = getSessionAgent();
@@ -42499,15 +42508,12 @@ 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 senderSession = msg.session_id;
+    const replyHint = `To reply, use conversations send_message with to="${msg.from_agent}". For direct session injection, use send_to_session with target_session_id from the sender's session.`;
+    const enrichedContent = `${msg.content}
+
+---
+[Via Conversations from ${msg.from_agent} (msg #${msg.id}). ${replyHint}]`;
     server.server.notification({
       method: "notifications/claude/channel",
       params: {
@@ -42554,18 +42560,27 @@ ${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 claudeSid = process.env.CONVERSATIONS_SESSION_ID || null;
+    const session_id = manualSid || claudeSid || `${name}-${Date.now()}`;
     try {
       const result = registerAgent(name, session_id, role, project_id);
       setSessionAgent(name);
+      if (claudeSid)
+        setClaudeSessionId(claudeSid);
       return {
         content: [{ type: "text", text: JSON.stringify(result) }]
       };
@@ -42580,14 +42595,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 {
@@ -44443,7 +44460,7 @@ function registerTmuxTools(server) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.40",
+  version: "0.2.42",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {

package/dist/mcp/channel.d.ts

@@ -16,6 +16,9 @@
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /** Called by agent tools when register_agent or heartbeat fires */
-export declare function setSessionAgent(agentId: string): void;
+export declare function setSessionAgent(agentId: string, claudeSessionId?: string): void;
+/** Called by register_agent to store the claude session ID */
+export declare function setClaudeSessionId(id: string): void;
 export declare function getSessionAgent(): string | null;
+export declare function getClaudeSessionId(): string | null;
 export declare function registerChannelBridge(server: McpServer): void;

package/package.json

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