@hasna/conversations 0.1.28 → 0.1.29

package/bin/hook.js

@@ -118,6 +118,7 @@ function getDb() {
       agent TEXT PRIMARY KEY,
       session_id TEXT,
       role TEXT NOT NULL DEFAULT 'agent',
+      project_id TEXT,
       status TEXT NOT NULL DEFAULT 'online',
       last_seen_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
       created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
@@ -219,6 +220,9 @@ function getDb() {
     db.exec("ALTER TABLE agent_presence ADD COLUMN created_at TEXT NOT NULL DEFAULT ''");
     db.exec("UPDATE agent_presence SET created_at = last_seen_at WHERE created_at = ''");
   }
+  if (!presenceColNames.includes("project_id")) {
+    db.exec("ALTER TABLE agent_presence ADD COLUMN project_id TEXT");
+  }
   const ftsExists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='messages_fts'").get();
   if (!ftsExists) {
     db.exec(`

package/bin/index.js

@@ -1972,6 +1972,7 @@ function getDb() {
       agent TEXT PRIMARY KEY,
       session_id TEXT,
       role TEXT NOT NULL DEFAULT 'agent',
+      project_id TEXT,
       status TEXT NOT NULL DEFAULT 'online',
       last_seen_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
       created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
@@ -2073,6 +2074,9 @@ function getDb() {
     db.exec("ALTER TABLE agent_presence ADD COLUMN created_at TEXT NOT NULL DEFAULT ''");
     db.exec("UPDATE agent_presence SET created_at = last_seen_at WHERE created_at = ''");
   }
+  if (!presenceColNames.includes("project_id")) {
+    db.exec("ALTER TABLE agent_presence ADD COLUMN project_id TEXT");
+  }
   const ftsExists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='messages_fts'").get();
   if (!ftsExists) {
     db.exec(`
@@ -3339,6 +3343,7 @@ function parsePresence(row) {
     agent: row.agent,
     session_id: row.session_id ?? null,
     role: row.role || "agent",
+    project_id: row.project_id ?? null,
     status: row.status,
     last_seen_at: lastSeenAt,
     created_at: row.created_at || lastSeenAt,
@@ -3351,43 +3356,46 @@ function isActiveSession(lastSeenAt) {
   const nowMs = Date.now();
   return nowMs - lastSeenMs < CONFLICT_THRESHOLD_SECONDS * 1000;
 }
-function registerAgent(name, sessionId, role) {
+function registerAgent(name, sessionId, role, projectId) {
   const db2 = getDb();
   const normalizedName = name.trim().toLowerCase();
-  const existing = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-  if (existing) {
-    const lastSeenAt = existing.last_seen_at;
-    const existingSessionId = existing.session_id;
-    if (isActiveSession(lastSeenAt) && existingSessionId && existingSessionId !== sessionId) {
-      return {
-        conflict: true,
-        error: "agent_conflict",
-        message: `Agent "${normalizedName}" is already active (last seen: ${lastSeenAt}). Wait 30 minutes or use force takeover.`,
-        existing_id: existing.id,
-        existing_name: normalizedName,
-        existing_session_id: existingSessionId,
-        last_seen_at: lastSeenAt,
-        session_hint: existingSessionId ? existingSessionId.slice(0, 8) : null,
-        working_dir: null
-      };
-    }
-    const tookOver = existingSessionId !== sessionId;
+  const result = db2.transaction(() => {
+    const existing = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+    if (existing) {
+      const lastSeenAt = existing.last_seen_at;
+      const existingSessionId = existing.session_id;
+      if (isActiveSession(lastSeenAt) && existingSessionId && existingSessionId !== sessionId) {
+        return {
+          conflict: true,
+          error: "agent_conflict",
+          message: `Agent "${normalizedName}" is already active (last seen: ${lastSeenAt}). Wait 30 minutes or use force takeover.`,
+          existing_id: existing.id,
+          existing_name: normalizedName,
+          existing_session_id: existingSessionId,
+          last_seen_at: lastSeenAt,
+          session_hint: existingSessionId ? existingSessionId.slice(0, 8) : null,
+          working_dir: null
+        };
+      }
+      const tookOver = existingSessionId !== sessionId;
+      db2.prepare(`
+        UPDATE agent_presence
+        SET session_id = ?, role = ?, project_id = ?, last_seen_at = strftime('%Y-%m-%dT%H:%M:%f', 'now')
+        WHERE agent = ?
+      `).run(sessionId, role || existing.role || "agent", projectId ?? existing.project_id ?? null, normalizedName);
+      const updated = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+      return { agent: parsePresence(updated), created: false, took_over: tookOver };
+    }
+    const id = crypto.randomUUID().slice(0, 8);
+    const resolvedRole = role || "agent";
     db2.prepare(`
-      UPDATE agent_presence
-      SET session_id = ?, role = ?, last_seen_at = strftime('%Y-%m-%dT%H:%M:%f', 'now')
-      WHERE agent = ?
-    `).run(sessionId, role || existing.role || "agent", normalizedName);
-    const updated = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-    return { agent: parsePresence(updated), created: false, took_over: tookOver };
-  }
-  const id = crypto.randomUUID().slice(0, 8);
-  const resolvedRole = role || "agent";
-  db2.prepare(`
-    INSERT INTO agent_presence (id, agent, session_id, role, status, last_seen_at, created_at)
-    VALUES (?, ?, ?, ?, 'online', strftime('%Y-%m-%dT%H:%M:%f', 'now'), strftime('%Y-%m-%dT%H:%M:%f', 'now'))
-  `).run(id, normalizedName, sessionId, resolvedRole);
-  const created = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-  return { agent: parsePresence(created), created: true, took_over: false };
+      INSERT INTO agent_presence (id, agent, session_id, role, project_id, status, last_seen_at, created_at)
+      VALUES (?, ?, ?, ?, ?, 'online', strftime('%Y-%m-%dT%H:%M:%f', 'now'), strftime('%Y-%m-%dT%H:%M:%f', 'now'))
+    `).run(id, normalizedName, sessionId, resolvedRole, projectId ?? null);
+    const created = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+    return { agent: parsePresence(created), created: true, took_over: false };
+  }).immediate();
+  return result;
 }
 function heartbeat(agent, status, metadata, sessionId) {
   const db2 = getDb();
@@ -3591,7 +3599,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.28",
+    version: "0.1.29",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -33189,15 +33197,16 @@ var init_mcp2 = __esm(() => {
     };
   });
   server.registerTool("register_agent", {
-    description: "Register an agent with conflict detection. Returns AgentConflictError if another active session exists (active = heartbeat within last 30 min).",
+    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: {
       name: exports_external.string(),
       session_id: exports_external.string(),
-      role: exports_external.string().optional()
+      role: exports_external.string().optional(),
+      project_id: exports_external.string().optional()
     }
   }, async (args) => {
-    const { name, session_id, role } = args;
-    const result = registerAgent(name, session_id, role);
+    const { name, session_id, role, project_id } = args;
+    const result = registerAgent(name, session_id, role, project_id);
     return {
       content: [{ type: "text", text: JSON.stringify(result) }]
     };

package/bin/mcp.js

@@ -6604,6 +6604,7 @@ function getDb() {
       agent TEXT PRIMARY KEY,
       session_id TEXT,
       role TEXT NOT NULL DEFAULT 'agent',
+      project_id TEXT,
       status TEXT NOT NULL DEFAULT 'online',
       last_seen_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
       created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
@@ -6705,6 +6706,9 @@ function getDb() {
     db.exec("ALTER TABLE agent_presence ADD COLUMN created_at TEXT NOT NULL DEFAULT ''");
     db.exec("UPDATE agent_presence SET created_at = last_seen_at WHERE created_at = ''");
   }
+  if (!presenceColNames.includes("project_id")) {
+    db.exec("ALTER TABLE agent_presence ADD COLUMN project_id TEXT");
+  }
   const ftsExists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='messages_fts'").get();
   if (!ftsExists) {
     db.exec(`
@@ -29765,6 +29769,7 @@ function parsePresence(row) {
     agent: row.agent,
     session_id: row.session_id ?? null,
     role: row.role || "agent",
+    project_id: row.project_id ?? null,
     status: row.status,
     last_seen_at: lastSeenAt,
     created_at: row.created_at || lastSeenAt,
@@ -29777,43 +29782,46 @@ function isActiveSession(lastSeenAt) {
   const nowMs = Date.now();
   return nowMs - lastSeenMs < CONFLICT_THRESHOLD_SECONDS * 1000;
 }
-function registerAgent(name, sessionId, role) {
+function registerAgent(name, sessionId, role, projectId) {
   const db2 = getDb();
   const normalizedName = name.trim().toLowerCase();
-  const existing = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-  if (existing) {
-    const lastSeenAt = existing.last_seen_at;
-    const existingSessionId = existing.session_id;
-    if (isActiveSession(lastSeenAt) && existingSessionId && existingSessionId !== sessionId) {
-      return {
-        conflict: true,
-        error: "agent_conflict",
-        message: `Agent "${normalizedName}" is already active (last seen: ${lastSeenAt}). Wait 30 minutes or use force takeover.`,
-        existing_id: existing.id,
-        existing_name: normalizedName,
-        existing_session_id: existingSessionId,
-        last_seen_at: lastSeenAt,
-        session_hint: existingSessionId ? existingSessionId.slice(0, 8) : null,
-        working_dir: null
-      };
-    }
-    const tookOver = existingSessionId !== sessionId;
+  const result = db2.transaction(() => {
+    const existing = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+    if (existing) {
+      const lastSeenAt = existing.last_seen_at;
+      const existingSessionId = existing.session_id;
+      if (isActiveSession(lastSeenAt) && existingSessionId && existingSessionId !== sessionId) {
+        return {
+          conflict: true,
+          error: "agent_conflict",
+          message: `Agent "${normalizedName}" is already active (last seen: ${lastSeenAt}). Wait 30 minutes or use force takeover.`,
+          existing_id: existing.id,
+          existing_name: normalizedName,
+          existing_session_id: existingSessionId,
+          last_seen_at: lastSeenAt,
+          session_hint: existingSessionId ? existingSessionId.slice(0, 8) : null,
+          working_dir: null
+        };
+      }
+      const tookOver = existingSessionId !== sessionId;
+      db2.prepare(`
+        UPDATE agent_presence
+        SET session_id = ?, role = ?, project_id = ?, last_seen_at = strftime('%Y-%m-%dT%H:%M:%f', 'now')
+        WHERE agent = ?
+      `).run(sessionId, role || existing.role || "agent", projectId ?? existing.project_id ?? null, normalizedName);
+      const updated = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+      return { agent: parsePresence(updated), created: false, took_over: tookOver };
+    }
+    const id = crypto.randomUUID().slice(0, 8);
+    const resolvedRole = role || "agent";
     db2.prepare(`
-      UPDATE agent_presence
-      SET session_id = ?, role = ?, last_seen_at = strftime('%Y-%m-%dT%H:%M:%f', 'now')
-      WHERE agent = ?
-    `).run(sessionId, role || existing.role || "agent", normalizedName);
-    const updated = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-    return { agent: parsePresence(updated), created: false, took_over: tookOver };
-  }
-  const id = crypto.randomUUID().slice(0, 8);
-  const resolvedRole = role || "agent";
-  db2.prepare(`
-    INSERT INTO agent_presence (id, agent, session_id, role, status, last_seen_at, created_at)
-    VALUES (?, ?, ?, ?, 'online', strftime('%Y-%m-%dT%H:%M:%f', 'now'), strftime('%Y-%m-%dT%H:%M:%f', 'now'))
-  `).run(id, normalizedName, sessionId, resolvedRole);
-  const created = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-  return { agent: parsePresence(created), created: true, took_over: false };
+      INSERT INTO agent_presence (id, agent, session_id, role, project_id, status, last_seen_at, created_at)
+      VALUES (?, ?, ?, ?, ?, 'online', strftime('%Y-%m-%dT%H:%M:%f', 'now'), strftime('%Y-%m-%dT%H:%M:%f', 'now'))
+    `).run(id, normalizedName, sessionId, resolvedRole, projectId ?? null);
+    const created = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+    return { agent: parsePresence(created), created: true, took_over: false };
+  }).immediate();
+  return result;
 }
 function heartbeat(agent, status, metadata, sessionId) {
   const db2 = getDb();
@@ -29864,7 +29872,7 @@ function renameAgent(oldName, newName) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.1.28",
+  version: "0.1.29",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -30574,15 +30582,16 @@ server.registerTool("get_pinned_messages", {
   };
 });
 server.registerTool("register_agent", {
-  description: "Register an agent with conflict detection. Returns AgentConflictError if another active session exists (active = heartbeat within last 30 min).",
+  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: {
     name: exports_external.string(),
     session_id: exports_external.string(),
-    role: exports_external.string().optional()
+    role: exports_external.string().optional(),
+    project_id: exports_external.string().optional()
   }
 }, async (args) => {
-  const { name, session_id, role } = args;
-  const result = registerAgent(name, session_id, role);
+  const { name, session_id, role, project_id } = args;
+  const result = registerAgent(name, session_id, role, project_id);
   return {
     content: [{ type: "text", text: JSON.stringify(result) }]
   };

package/dist/index.js

@@ -131,6 +131,7 @@ function getDb() {
       agent TEXT PRIMARY KEY,
       session_id TEXT,
       role TEXT NOT NULL DEFAULT 'agent',
+      project_id TEXT,
       status TEXT NOT NULL DEFAULT 'online',
       last_seen_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
       created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
@@ -232,6 +233,9 @@ function getDb() {
     db.exec("ALTER TABLE agent_presence ADD COLUMN created_at TEXT NOT NULL DEFAULT ''");
     db.exec("UPDATE agent_presence SET created_at = last_seen_at WHERE created_at = ''");
   }
+  if (!presenceColNames.includes("project_id")) {
+    db.exec("ALTER TABLE agent_presence ADD COLUMN project_id TEXT");
+  }
   const ftsExists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='messages_fts'").get();
   if (!ftsExists) {
     db.exec(`
@@ -3444,6 +3448,7 @@ function parsePresence(row) {
     agent: row.agent,
     session_id: row.session_id ?? null,
     role: row.role || "agent",
+    project_id: row.project_id ?? null,
     status: row.status,
     last_seen_at: lastSeenAt,
     created_at: row.created_at || lastSeenAt,
@@ -3459,43 +3464,46 @@ function isActiveSession(lastSeenAt) {
 function isAgentConflict(result) {
   return result.conflict === true;
 }
-function registerAgent(name, sessionId, role) {
+function registerAgent(name, sessionId, role, projectId) {
   const db2 = getDb();
   const normalizedName = name.trim().toLowerCase();
-  const existing = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-  if (existing) {
-    const lastSeenAt = existing.last_seen_at;
-    const existingSessionId = existing.session_id;
-    if (isActiveSession(lastSeenAt) && existingSessionId && existingSessionId !== sessionId) {
-      return {
-        conflict: true,
-        error: "agent_conflict",
-        message: `Agent "${normalizedName}" is already active (last seen: ${lastSeenAt}). Wait 30 minutes or use force takeover.`,
-        existing_id: existing.id,
-        existing_name: normalizedName,
-        existing_session_id: existingSessionId,
-        last_seen_at: lastSeenAt,
-        session_hint: existingSessionId ? existingSessionId.slice(0, 8) : null,
-        working_dir: null
-      };
+  const result = db2.transaction(() => {
+    const existing = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+    if (existing) {
+      const lastSeenAt = existing.last_seen_at;
+      const existingSessionId = existing.session_id;
+      if (isActiveSession(lastSeenAt) && existingSessionId && existingSessionId !== sessionId) {
+        return {
+          conflict: true,
+          error: "agent_conflict",
+          message: `Agent "${normalizedName}" is already active (last seen: ${lastSeenAt}). Wait 30 minutes or use force takeover.`,
+          existing_id: existing.id,
+          existing_name: normalizedName,
+          existing_session_id: existingSessionId,
+          last_seen_at: lastSeenAt,
+          session_hint: existingSessionId ? existingSessionId.slice(0, 8) : null,
+          working_dir: null
+        };
+      }
+      const tookOver = existingSessionId !== sessionId;
+      db2.prepare(`
+        UPDATE agent_presence
+        SET session_id = ?, role = ?, project_id = ?, last_seen_at = strftime('%Y-%m-%dT%H:%M:%f', 'now')
+        WHERE agent = ?
+      `).run(sessionId, role || existing.role || "agent", projectId ?? existing.project_id ?? null, normalizedName);
+      const updated = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+      return { agent: parsePresence(updated), created: false, took_over: tookOver };
     }
-    const tookOver = existingSessionId !== sessionId;
+    const id = crypto.randomUUID().slice(0, 8);
+    const resolvedRole = role || "agent";
     db2.prepare(`
-      UPDATE agent_presence
-      SET session_id = ?, role = ?, last_seen_at = strftime('%Y-%m-%dT%H:%M:%f', 'now')
-      WHERE agent = ?
-    `).run(sessionId, role || existing.role || "agent", normalizedName);
-    const updated = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-    return { agent: parsePresence(updated), created: false, took_over: tookOver };
-  }
-  const id = crypto.randomUUID().slice(0, 8);
-  const resolvedRole = role || "agent";
-  db2.prepare(`
-    INSERT INTO agent_presence (id, agent, session_id, role, status, last_seen_at, created_at)
-    VALUES (?, ?, ?, ?, 'online', strftime('%Y-%m-%dT%H:%M:%f', 'now'), strftime('%Y-%m-%dT%H:%M:%f', 'now'))
-  `).run(id, normalizedName, sessionId, resolvedRole);
-  const created = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
-  return { agent: parsePresence(created), created: true, took_over: false };
+      INSERT INTO agent_presence (id, agent, session_id, role, project_id, status, last_seen_at, created_at)
+      VALUES (?, ?, ?, ?, ?, 'online', strftime('%Y-%m-%dT%H:%M:%f', 'now'), strftime('%Y-%m-%dT%H:%M:%f', 'now'))
+    `).run(id, normalizedName, sessionId, resolvedRole, projectId ?? null);
+    const created = db2.prepare("SELECT * FROM agent_presence WHERE agent = ?").get(normalizedName);
+    return { agent: parsePresence(created), created: true, took_over: false };
+  }).immediate();
+  return result;
 }
 function heartbeat(agent, status, metadata, sessionId) {
   const db2 = getDb();

package/dist/lib/presence.d.ts

@@ -1,6 +1,6 @@
 import type { AgentPresence, AgentConflictError, RegisterAgentResult } from "../types.js";
 export declare function isAgentConflict(result: RegisterAgentResult | AgentConflictError): result is AgentConflictError;
-export declare function registerAgent(name: string, sessionId: string, role?: string): RegisterAgentResult | AgentConflictError;
+export declare function registerAgent(name: string, sessionId: string, role?: string, projectId?: string): RegisterAgentResult | AgentConflictError;
 export declare function heartbeat(agent: string, status?: string, metadata?: Record<string, unknown>, sessionId?: string): void;
 export declare function getPresence(agent: string): AgentPresence | null;
 export declare function listAgents(opts?: {

package/dist/types.d.ts

@@ -116,6 +116,7 @@ export interface AgentPresence {
     agent: string;
     session_id: string | null;
     role: string;
+    project_id: string | null;
     status: string;
     last_seen_at: string;
     created_at: string;

package/package.json

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