@hasna/conversations 0.1.30 → 0.1.32

package/bin/hook.js

@@ -60,6 +60,7 @@ function getDb() {
       from_agent TEXT NOT NULL,
       to_agent TEXT NOT NULL,
       space TEXT,
+      project_id TEXT,
       content TEXT NOT NULL,
       priority TEXT NOT NULL DEFAULT 'normal',
       working_dir TEXT,
@@ -214,6 +215,10 @@ function getDb() {
     db.exec("ALTER TABLE messages ADD COLUMN reply_to INTEGER REFERENCES messages(id)");
     db.exec("CREATE INDEX IF NOT EXISTS idx_messages_reply_to ON messages(reply_to)");
   }
+  if (!colNames2.includes("project_id")) {
+    db.exec("ALTER TABLE messages ADD COLUMN project_id TEXT");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_project ON messages(project_id)");
+  }
   const presenceCols = db.prepare("PRAGMA table_info(agent_presence)").all();
   const presenceColNames = presenceCols.map((c) => c.name);
   if (!presenceColNames.includes("id")) {

package/bin/index.js

@@ -1914,6 +1914,7 @@ function getDb() {
       from_agent TEXT NOT NULL,
       to_agent TEXT NOT NULL,
       space TEXT,
+      project_id TEXT,
       content TEXT NOT NULL,
       priority TEXT NOT NULL DEFAULT 'normal',
       working_dir TEXT,
@@ -2068,6 +2069,10 @@ function getDb() {
     db.exec("ALTER TABLE messages ADD COLUMN reply_to INTEGER REFERENCES messages(id)");
     db.exec("CREATE INDEX IF NOT EXISTS idx_messages_reply_to ON messages(reply_to)");
   }
+  if (!colNames2.includes("project_id")) {
+    db.exec("ALTER TABLE messages ADD COLUMN project_id TEXT");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_project ON messages(project_id)");
+  }
   const presenceCols = db.prepare("PRAGMA table_info(agent_presence)").all();
   const presenceColNames = presenceCols.map((c) => c.name);
   if (!presenceColNames.includes("id")) {
@@ -2279,11 +2284,11 @@ function sendMessage(opts) {
   const blocking = opts.blocking ? 1 : 0;
   const replyTo = opts.reply_to || null;
   const stmt = db2.prepare(`
-    INSERT INTO messages (session_id, from_agent, to_agent, space, content, priority, working_dir, repository, branch, metadata, blocking, reply_to)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    INSERT INTO messages (session_id, from_agent, to_agent, space, project_id, content, priority, working_dir, repository, branch, metadata, blocking, reply_to)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     RETURNING *
   `);
-  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata, blocking, replyTo);
+  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.project_id || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata, blocking, replyTo);
   const message = parseMessage(row);
   if (opts.attachments && opts.attachments.length > 0) {
     const attachmentsDir = join3(getAttachmentsDir(), String(message.id));
@@ -2327,6 +2332,10 @@ function readMessages(opts = {}) {
     conditions.push("space = ?");
     params.push(opts.space);
   }
+  if (opts.project_id) {
+    conditions.push("project_id = ?");
+    params.push(opts.project_id);
+  }
   if (opts.since) {
     conditions.push("created_at > ?");
     params.push(opts.since);
@@ -3613,7 +3622,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.30",
+    version: "0.1.32",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -32563,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();
@@ -32583,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: {
@@ -32590,17 +32612,19 @@ var init_mcp2 = __esm(() => {
       content: exports_external.string(),
       from: exports_external.string().optional(),
       priority: exports_external.string().optional(),
-      blocking: exports_external.coerce.boolean().optional()
+      blocking: exports_external.coerce.boolean().optional(),
+      project_id: exports_external.string().optional()
     }
   }, async (args) => {
-    const { from: fromParam, to, content, priority, blocking } = args;
+    const { from: fromParam, to, content, priority, blocking, project_id } = args;
     const from = resolveIdentity(fromParam);
     const msg = sendMessage({
       from,
       to,
       content,
       priority,
-      blocking
+      blocking,
+      project_id
     });
     return {
       content: [{ type: "text", text: JSON.stringify(msg) }]
@@ -32613,12 +32637,17 @@ var init_mcp2 = __esm(() => {
       from: exports_external.string().optional(),
       to: exports_external.string().optional(),
       space: exports_external.string().optional(),
+      project_id: exports_external.string().optional(),
       since: exports_external.string().optional(),
       limit: exports_external.coerce.number().optional(),
       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) }]
     };
@@ -33210,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: {
@@ -33356,6 +33437,9 @@ var init_mcp2 = __esm(() => {
       "pin_message",
       "unpin_message",
       "get_pinned_messages",
+      "set_focus",
+      "get_focus",
+      "unfocus",
       "register_agent",
       "heartbeat",
       "list_agents",
@@ -33402,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

@@ -6546,6 +6546,7 @@ function getDb() {
       from_agent TEXT NOT NULL,
       to_agent TEXT NOT NULL,
       space TEXT,
+      project_id TEXT,
       content TEXT NOT NULL,
       priority TEXT NOT NULL DEFAULT 'normal',
       working_dir TEXT,
@@ -6700,6 +6701,10 @@ function getDb() {
     db.exec("ALTER TABLE messages ADD COLUMN reply_to INTEGER REFERENCES messages(id)");
     db.exec("CREATE INDEX IF NOT EXISTS idx_messages_reply_to ON messages(reply_to)");
   }
+  if (!colNames2.includes("project_id")) {
+    db.exec("ALTER TABLE messages ADD COLUMN project_id TEXT");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_project ON messages(project_id)");
+  }
   const presenceCols = db.prepare("PRAGMA table_info(agent_presence)").all();
   const presenceColNames = presenceCols.map((c) => c.name);
   if (!presenceColNames.includes("id")) {
@@ -28732,11 +28737,11 @@ function sendMessage(opts) {
   const blocking = opts.blocking ? 1 : 0;
   const replyTo = opts.reply_to || null;
   const stmt = db2.prepare(`
-    INSERT INTO messages (session_id, from_agent, to_agent, space, content, priority, working_dir, repository, branch, metadata, blocking, reply_to)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    INSERT INTO messages (session_id, from_agent, to_agent, space, project_id, content, priority, working_dir, repository, branch, metadata, blocking, reply_to)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     RETURNING *
   `);
-  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata, blocking, replyTo);
+  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.project_id || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata, blocking, replyTo);
   const message = parseMessage(row);
   if (opts.attachments && opts.attachments.length > 0) {
     const attachmentsDir = join3(getAttachmentsDir(), String(message.id));
@@ -28780,6 +28785,10 @@ function readMessages(opts = {}) {
     conditions.push("space = ?");
     params.push(opts.space);
   }
+  if (opts.project_id) {
+    conditions.push("project_id = ?");
+    params.push(opts.project_id);
+  }
   if (opts.since) {
     conditions.push("created_at > ?");
     params.push(opts.since);
@@ -29854,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";
@@ -29886,7 +29901,7 @@ function renameAgent(oldName, newName) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.1.30",
+  version: "0.1.32",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -29968,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: {
@@ -29975,17 +30003,19 @@ server.registerTool("send_message", {
     content: exports_external.string(),
     from: exports_external.string().optional(),
     priority: exports_external.string().optional(),
-    blocking: exports_external.coerce.boolean().optional()
+    blocking: exports_external.coerce.boolean().optional(),
+    project_id: exports_external.string().optional()
   }
 }, async (args) => {
-  const { from: fromParam, to, content, priority, blocking } = args;
+  const { from: fromParam, to, content, priority, blocking, project_id } = args;
   const from = resolveIdentity(fromParam);
   const msg = sendMessage({
     from,
     to,
     content,
     priority,
-    blocking
+    blocking,
+    project_id
   });
   return {
     content: [{ type: "text", text: JSON.stringify(msg) }]
@@ -29998,12 +30028,17 @@ server.registerTool("read_messages", {
     from: exports_external.string().optional(),
     to: exports_external.string().optional(),
     space: exports_external.string().optional(),
+    project_id: exports_external.string().optional(),
     since: exports_external.string().optional(),
     limit: exports_external.coerce.number().optional(),
     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) }]
   };
@@ -30595,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: {
@@ -30741,6 +30828,9 @@ server.registerTool("search_tools", {
     "pin_message",
     "unpin_message",
     "get_pinned_messages",
+    "set_focus",
+    "get_focus",
+    "unfocus",
     "register_agent",
     "heartbeat",
     "list_agents",
@@ -30787,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/dist/index.js

@@ -73,6 +73,7 @@ function getDb() {
       from_agent TEXT NOT NULL,
       to_agent TEXT NOT NULL,
       space TEXT,
+      project_id TEXT,
       content TEXT NOT NULL,
       priority TEXT NOT NULL DEFAULT 'normal',
       working_dir TEXT,
@@ -227,6 +228,10 @@ function getDb() {
     db.exec("ALTER TABLE messages ADD COLUMN reply_to INTEGER REFERENCES messages(id)");
     db.exec("CREATE INDEX IF NOT EXISTS idx_messages_reply_to ON messages(reply_to)");
   }
+  if (!colNames2.includes("project_id")) {
+    db.exec("ALTER TABLE messages ADD COLUMN project_id TEXT");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_messages_project ON messages(project_id)");
+  }
   const presenceCols = db.prepare("PRAGMA table_info(agent_presence)").all();
   const presenceColNames = presenceCols.map((c) => c.name);
   if (!presenceColNames.includes("id")) {
@@ -2253,11 +2258,11 @@ function sendMessage(opts) {
   const blocking = opts.blocking ? 1 : 0;
   const replyTo = opts.reply_to || null;
   const stmt = db2.prepare(`
-    INSERT INTO messages (session_id, from_agent, to_agent, space, content, priority, working_dir, repository, branch, metadata, blocking, reply_to)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    INSERT INTO messages (session_id, from_agent, to_agent, space, project_id, content, priority, working_dir, repository, branch, metadata, blocking, reply_to)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     RETURNING *
   `);
-  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata, blocking, replyTo);
+  const row = stmt.get(sessionId, opts.from, opts.to, opts.space || null, opts.project_id || null, opts.content, normalizedPriority, opts.working_dir || null, opts.repository || null, opts.branch || null, metadata, blocking, replyTo);
   const message = parseMessage(row);
   if (opts.attachments && opts.attachments.length > 0) {
     const attachmentsDir = join3(getAttachmentsDir(), String(message.id));
@@ -2301,6 +2306,10 @@ function readMessages(opts = {}) {
     conditions.push("space = ?");
     params.push(opts.space);
   }
+  if (opts.project_id) {
+    conditions.push("project_id = ?");
+    params.push(opts.project_id);
+  }
   if (opts.since) {
     conditions.push("created_at > ?");
     params.push(opts.since);

package/dist/types.d.ts

@@ -5,6 +5,7 @@ export interface Message {
     from_agent: string;
     to_agent: string;
     space: string | null;
+    project_id: string | null;
     content: string;
     priority: Priority;
     working_dir: string | null;
@@ -80,6 +81,7 @@ export interface SendMessageOptions {
     content: string;
     session_id?: string;
     space?: string;
+    project_id?: string;
     priority?: Priority;
     working_dir?: string;
     repository?: string;
@@ -97,6 +99,7 @@ export interface ReadMessagesOptions {
     from?: string;
     to?: string;
     space?: string;
+    project_id?: string;
     since?: string;
     since_id?: number;
     limit?: number;

package/package.json

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