@hasna/conversations 0.1.31 → 0.1.32

package/bin/index.js

@@ -3622,7 +3622,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.31",
+    version: "0.1.32",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -32572,11 +32572,23 @@ __export(exports_mcp, {
   startMcpServer: () => startMcpServer,
   server: () => server
 });
+function getAgentFocus(agentId) {
+  if (agentFocus.has(agentId))
+    return agentFocus.get(agentId).project_id;
+  const presence = getPresence(agentId);
+  return presence?.project_id ?? null;
+}
+function resolveProjectId(explicitProjectId, agentId) {
+  if (explicitProjectId)
+    return explicitProjectId;
+  const focused = getAgentFocus(agentId);
+  return focused ?? undefined;
+}
 async function startMcpServer() {
   const transport = new StdioServerTransport;
   await server.connect(transport);
 }
-var import__package, server, isDirectRun;
+var import__package, server, agentFocus, isDirectRun;
 var init_mcp2 = __esm(() => {
   init_mcp();
   init_stdio2();
@@ -32592,6 +32604,7 @@ var init_mcp2 = __esm(() => {
     name: "conversations",
     version: import__package.default.version
   });
+  agentFocus = new Map;
   server.registerTool("send_message", {
     description: "Send a DM to an agent.",
     inputSchema: {
@@ -32630,7 +32643,11 @@ var init_mcp2 = __esm(() => {
       unread_only: exports_external.coerce.boolean().optional()
     }
   }, async (args) => {
-    const messages = readMessages(args);
+    const agent = resolveIdentity(args.from);
+    const messages = readMessages({
+      ...args,
+      project_id: args.project_id ?? resolveProjectId(undefined, agent)
+    });
     return {
       content: [{ type: "text", text: JSON.stringify(messages) }]
     };
@@ -33222,6 +33239,58 @@ var init_mcp2 = __esm(() => {
       content: [{ type: "text", text: JSON.stringify(messages) }]
     };
   });
+  server.registerTool("set_focus", {
+    description: "Set agent focus to a project. All read-heavy tools will default to this project scope. Stores in MCP session memory AND updates agent_presence.project_id in DB.",
+    inputSchema: {
+      project_id: exports_external.string(),
+      from: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const { project_id, from: fromParam } = args;
+    const agent = resolveIdentity(fromParam);
+    agentFocus.set(agent, { project_id });
+    const db2 = (await Promise.resolve().then(() => (init_db(), exports_db))).getDb();
+    db2.prepare("UPDATE agent_presence SET project_id = ? WHERE agent = ?").run(project_id, agent);
+    return {
+      content: [{ type: "text", text: JSON.stringify({ agent, focused: true, project_id }) }]
+    };
+  });
+  server.registerTool("get_focus", {
+    description: "Get the current focus state for an agent. Returns session focus, DB project_id, and effective project_id used for filtering.",
+    inputSchema: {
+      from: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const agent = resolveIdentity(args.from);
+    const sessionFocus = agentFocus.get(agent) ?? null;
+    const presence = getPresence(agent);
+    const effective = getAgentFocus(agent);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          agent,
+          session_focus: sessionFocus?.project_id ?? null,
+          db_project_id: presence?.project_id ?? null,
+          effective_project_id: effective
+        })
+      }]
+    };
+  });
+  server.registerTool("unfocus", {
+    description: "Clear agent focus. Removes session focus and clears agent_presence.project_id in DB.",
+    inputSchema: {
+      from: exports_external.string().optional()
+    }
+  }, async (args) => {
+    const agent = resolveIdentity(args.from);
+    agentFocus.delete(agent);
+    const db2 = (await Promise.resolve().then(() => (init_db(), exports_db))).getDb();
+    db2.prepare("UPDATE agent_presence SET project_id = NULL WHERE agent = ?").run(agent);
+    return {
+      content: [{ type: "text", text: JSON.stringify({ agent, focused: false, project_id: null }) }]
+    };
+  });
   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.",
     inputSchema: {
@@ -33368,6 +33437,9 @@ var init_mcp2 = __esm(() => {
       "pin_message",
       "unpin_message",
       "get_pinned_messages",
+      "set_focus",
+      "get_focus",
+      "unfocus",
       "register_agent",
       "heartbeat",
       "list_agents",
@@ -33414,6 +33486,9 @@ var init_mcp2 = __esm(() => {
       pin_message: "Pin a message. Required: id",
       unpin_message: "Unpin a message. Required: id",
       get_pinned_messages: "Get pinned messages. Optional: space?, session_id?, limit?",
+      set_focus: "Set agent focus to a project. All read tools default to this scope. Required: project_id. Optional: from?",
+      get_focus: "Get current focus: session focus, DB project_id, effective project_id. Optional: from?",
+      unfocus: "Clear agent focus (session + DB). Optional: from?",
       register_agent: "Register agent with conflict detection (30min active window). Required: name, session_id. Optional: role?. Returns AgentConflictError if another session is active.",
       heartbeat: "Register/refresh agent presence. Optional: from?, status?(online|busy|idle, default: online)",
       list_agents: "List agents with presence timestamps. Optional: online_only?(only agents seen in last 60s)",

package/bin/mcp.js

@@ -29863,6 +29863,12 @@ function heartbeat(agent, status, metadata, sessionId) {
       metadata = excluded.metadata
   `).run(id, normalizedAgent, sessionId ?? null, resolvedStatus, metadataJson);
 }
+function getPresence(agent) {
+  const db2 = getDb();
+  const normalizedAgent = agent.trim().toLowerCase();
+  const row = db2.prepare("SELECT * FROM agent_presence WHERE LOWER(agent) = ?").get(normalizedAgent);
+  return row ? parsePresence(row) : null;
+}
 function listAgents(opts) {
   const db2 = getDb();
   let query = "SELECT * FROM agent_presence";
@@ -29895,7 +29901,7 @@ function renameAgent(oldName, newName) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.1.31",
+  version: "0.1.32",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -29977,6 +29983,19 @@ var server = new McpServer({
   name: "conversations",
   version: package_default.version
 });
+var agentFocus = new Map;
+function getAgentFocus(agentId) {
+  if (agentFocus.has(agentId))
+    return agentFocus.get(agentId).project_id;
+  const presence = getPresence(agentId);
+  return presence?.project_id ?? null;
+}
+function resolveProjectId(explicitProjectId, agentId) {
+  if (explicitProjectId)
+    return explicitProjectId;
+  const focused = getAgentFocus(agentId);
+  return focused ?? undefined;
+}
 server.registerTool("send_message", {
   description: "Send a DM to an agent.",
   inputSchema: {
@@ -30015,7 +30034,11 @@ server.registerTool("read_messages", {
     unread_only: exports_external.coerce.boolean().optional()
   }
 }, async (args) => {
-  const messages = readMessages(args);
+  const agent = resolveIdentity(args.from);
+  const messages = readMessages({
+    ...args,
+    project_id: args.project_id ?? resolveProjectId(undefined, agent)
+  });
   return {
     content: [{ type: "text", text: JSON.stringify(messages) }]
   };
@@ -30607,6 +30630,58 @@ server.registerTool("get_pinned_messages", {
     content: [{ type: "text", text: JSON.stringify(messages) }]
   };
 });
+server.registerTool("set_focus", {
+  description: "Set agent focus to a project. All read-heavy tools will default to this project scope. Stores in MCP session memory AND updates agent_presence.project_id in DB.",
+  inputSchema: {
+    project_id: exports_external.string(),
+    from: exports_external.string().optional()
+  }
+}, async (args) => {
+  const { project_id, from: fromParam } = args;
+  const agent = resolveIdentity(fromParam);
+  agentFocus.set(agent, { project_id });
+  const db2 = (await Promise.resolve().then(() => (init_db(), exports_db))).getDb();
+  db2.prepare("UPDATE agent_presence SET project_id = ? WHERE agent = ?").run(project_id, agent);
+  return {
+    content: [{ type: "text", text: JSON.stringify({ agent, focused: true, project_id }) }]
+  };
+});
+server.registerTool("get_focus", {
+  description: "Get the current focus state for an agent. Returns session focus, DB project_id, and effective project_id used for filtering.",
+  inputSchema: {
+    from: exports_external.string().optional()
+  }
+}, async (args) => {
+  const agent = resolveIdentity(args.from);
+  const sessionFocus = agentFocus.get(agent) ?? null;
+  const presence = getPresence(agent);
+  const effective = getAgentFocus(agent);
+  return {
+    content: [{
+      type: "text",
+      text: JSON.stringify({
+        agent,
+        session_focus: sessionFocus?.project_id ?? null,
+        db_project_id: presence?.project_id ?? null,
+        effective_project_id: effective
+      })
+    }]
+  };
+});
+server.registerTool("unfocus", {
+  description: "Clear agent focus. Removes session focus and clears agent_presence.project_id in DB.",
+  inputSchema: {
+    from: exports_external.string().optional()
+  }
+}, async (args) => {
+  const agent = resolveIdentity(args.from);
+  agentFocus.delete(agent);
+  const db2 = (await Promise.resolve().then(() => (init_db(), exports_db))).getDb();
+  db2.prepare("UPDATE agent_presence SET project_id = NULL WHERE agent = ?").run(agent);
+  return {
+    content: [{ type: "text", text: JSON.stringify({ agent, focused: false, project_id: null }) }]
+  };
+});
 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.",
   inputSchema: {
@@ -30753,6 +30828,9 @@ server.registerTool("search_tools", {
     "pin_message",
     "unpin_message",
     "get_pinned_messages",
+    "set_focus",
+    "get_focus",
+    "unfocus",
     "register_agent",
     "heartbeat",
     "list_agents",
@@ -30799,6 +30877,9 @@ server.registerTool("describe_tools", {
     pin_message: "Pin a message. Required: id",
     unpin_message: "Unpin a message. Required: id",
     get_pinned_messages: "Get pinned messages. Optional: space?, session_id?, limit?",
+    set_focus: "Set agent focus to a project. All read tools default to this scope. Required: project_id. Optional: from?",
+    get_focus: "Get current focus: session focus, DB project_id, effective project_id. Optional: from?",
+    unfocus: "Clear agent focus (session + DB). Optional: from?",
     register_agent: "Register agent with conflict detection (30min active window). Required: name, session_id. Optional: role?. Returns AgentConflictError if another session is active.",
     heartbeat: "Register/refresh agent presence. Optional: from?, status?(online|busy|idle, default: online)",
     list_agents: "List agents with presence timestamps. Optional: online_only?(only agents seen in last 60s)",

package/package.json

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