@hasna/conversations 0.1.29 → 0.1.31

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,
@@ -125,6 +126,20 @@ function getDb() {
       metadata TEXT
     )
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS resource_locks (
+      resource_type TEXT NOT NULL,
+      resource_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      lock_type TEXT NOT NULL DEFAULT 'advisory',
+      locked_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      expires_at TEXT NOT NULL,
+      UNIQUE(resource_type, resource_id, lock_type)
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_resource ON resource_locks(resource_type, resource_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_agent ON resource_locks(agent_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_expires ON resource_locks(expires_at)");
   db.exec(`
     CREATE TABLE IF NOT EXISTS reactions (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -200,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,
@@ -1979,6 +1980,20 @@ function getDb() {
       metadata TEXT
     )
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS resource_locks (
+      resource_type TEXT NOT NULL,
+      resource_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      lock_type TEXT NOT NULL DEFAULT 'advisory',
+      locked_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      expires_at TEXT NOT NULL,
+      UNIQUE(resource_type, resource_id, lock_type)
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_resource ON resource_locks(resource_type, resource_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_agent ON resource_locks(agent_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_expires ON resource_locks(expires_at)");
   db.exec(`
     CREATE TABLE IF NOT EXISTS reactions (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -2054,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")) {
@@ -2265,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));
@@ -2313,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);
@@ -3599,7 +3622,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.29",
+    version: "0.1.31",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -32576,17 +32599,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) }]
@@ -32599,6 +32624,7 @@ 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()

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,
@@ -6611,6 +6612,20 @@ function getDb() {
       metadata TEXT
     )
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS resource_locks (
+      resource_type TEXT NOT NULL,
+      resource_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      lock_type TEXT NOT NULL DEFAULT 'advisory',
+      locked_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      expires_at TEXT NOT NULL,
+      UNIQUE(resource_type, resource_id, lock_type)
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_resource ON resource_locks(resource_type, resource_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_agent ON resource_locks(agent_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_expires ON resource_locks(expires_at)");
   db.exec(`
     CREATE TABLE IF NOT EXISTS reactions (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -6686,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")) {
@@ -28718,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));
@@ -28766,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);
@@ -29872,7 +29895,7 @@ function renameAgent(oldName, newName) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.1.29",
+  version: "0.1.31",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -29961,17 +29984,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) }]
@@ -29984,6 +30009,7 @@ 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()

package/dist/index.d.ts

@@ -19,4 +19,6 @@ export { resolveIdentity, requireIdentity, } from "./lib/identity.js";
 export { addReaction, removeReaction, getReactions, getReactionSummary, } from "./lib/reactions.js";
 export { fireWebhooks, } from "./lib/webhooks.js";
 export { heartbeat, registerAgent, isAgentConflict, getPresence, listAgents, removePresence, renameAgent, } from "./lib/presence.js";
+export { acquireLock, releaseLock, checkLock, cleanExpiredLocks, listLocks, } from "./lib/locks.js";
+export type { ResourceLock } from "./lib/locks.js";
 export type { Message, Session, Space, SpaceInfo, SpaceMember, Project, ProjectInfo, Priority, SendMessageOptions, ReadMessagesOptions, SearchMessagesOptions, AgentPresence, AgentConflictError, RegisterAgentResult, Reaction, Attachment, } from "./types.js";

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,
@@ -138,6 +139,20 @@ function getDb() {
       metadata TEXT
     )
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS resource_locks (
+      resource_type TEXT NOT NULL,
+      resource_id TEXT NOT NULL,
+      agent_id TEXT NOT NULL,
+      lock_type TEXT NOT NULL DEFAULT 'advisory',
+      locked_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%f', 'now')),
+      expires_at TEXT NOT NULL,
+      UNIQUE(resource_type, resource_id, lock_type)
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_resource ON resource_locks(resource_type, resource_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_agent ON resource_locks(agent_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_locks_expires ON resource_locks(expires_at)");
   db.exec(`
     CREATE TABLE IF NOT EXISTS reactions (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -213,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")) {
@@ -2239,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));
@@ -2287,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);
@@ -3557,6 +3580,80 @@ function renameAgent(oldName, newName) {
   db2.prepare("UPDATE agent_presence SET agent = ? WHERE LOWER(agent) = ?").run(normalizedNew, normalizedOld);
   return true;
 }
+// src/lib/locks.ts
+init_db();
+var DEFAULT_LOCK_EXPIRY_MS = 5 * 60 * 1000;
+function acquireLock(resourceType, resourceId, agentId, lockType = "advisory", expiryMs = DEFAULT_LOCK_EXPIRY_MS) {
+  const db2 = getDb();
+  return db2.transaction(() => {
+    cleanExpiredLocks();
+    const existing = db2.prepare(`
+      SELECT * FROM resource_locks
+      WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
+    `).get(resourceType, resourceId, lockType);
+    if (existing) {
+      if (existing.agent_id !== agentId) {
+        return { acquired: false, lock: null, held_by: existing.agent_id };
+      }
+      const expiresAt = new Date(Date.now() + expiryMs).toISOString().replace("T", "T").replace("Z", "");
+      db2.prepare(`
+        UPDATE resource_locks SET expires_at = ?, locked_at = strftime('%Y-%m-%dT%H:%M:%f', 'now')
+        WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
+      `).run(expiresAt, resourceType, resourceId, lockType);
+    } else {
+      const expiresAt = new Date(Date.now() + expiryMs).toISOString().slice(0, -1);
+      db2.prepare(`
+        INSERT INTO resource_locks (resource_type, resource_id, agent_id, lock_type, locked_at, expires_at)
+        VALUES (?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%f', 'now'), ?)
+      `).run(resourceType, resourceId, agentId, lockType, expiresAt);
+    }
+    const lock = db2.prepare(`
+      SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
+    `).get(resourceType, resourceId, lockType);
+    return { acquired: true, lock };
+  }).immediate();
+}
+function releaseLock(resourceType, resourceId, agentId) {
+  const db2 = getDb();
+  const result = db2.prepare(`
+    DELETE FROM resource_locks
+    WHERE resource_type = ? AND resource_id = ? AND agent_id = ?
+  `).run(resourceType, resourceId, agentId);
+  return result.changes > 0;
+}
+function checkLock(resourceType, resourceId) {
+  const db2 = getDb();
+  cleanExpiredLocks();
+  return db2.prepare(`
+    SELECT * FROM resource_locks
+    WHERE resource_type = ? AND resource_id = ?
+    ORDER BY locked_at ASC
+    LIMIT 1
+  `).get(resourceType, resourceId);
+}
+function cleanExpiredLocks() {
+  const db2 = getDb();
+  const result = db2.prepare(`
+    DELETE FROM resource_locks WHERE expires_at < strftime('%Y-%m-%dT%H:%M:%f', 'now')
+  `).run();
+  return result.changes;
+}
+function listLocks(opts) {
+  const db2 = getDb();
+  cleanExpiredLocks();
+  let query = "SELECT * FROM resource_locks WHERE 1=1";
+  const params = [];
+  if (opts?.resource_type) {
+    query += " AND resource_type = ?";
+    params.push(opts.resource_type);
+  }
+  if (opts?.agent_id) {
+    query += " AND agent_id = ?";
+    params.push(opts.agent_id);
+  }
+  query += " ORDER BY locked_at ASC";
+  return db2.prepare(query).all(...params);
+}
 export {
   useSpaceMessages,
   updateSpace,
@@ -3571,6 +3668,7 @@ export {
   renameAgent,
   removeReaction,
   removePresence,
+  releaseLock,
   registerAgent,
   readMessages,
   pinMessage,
@@ -3581,6 +3679,7 @@ export {
   listSpaces,
   listSessions,
   listProjects,
+  listLocks,
   listAgents,
   leaveSpace,
   joinSpace,
@@ -3610,6 +3709,9 @@ export {
   createSpace,
   createProject,
   closeDb,
+  cleanExpiredLocks,
+  checkLock,
   archiveSpace,
-  addReaction
+  addReaction,
+  acquireLock
 };

package/dist/lib/locks.d.ts

@@ -0,0 +1,20 @@
+export interface ResourceLock {
+    resource_type: string;
+    resource_id: string;
+    agent_id: string;
+    lock_type: "advisory" | "exclusive";
+    locked_at: string;
+    expires_at: string;
+}
+export declare function acquireLock(resourceType: string, resourceId: string, agentId: string, lockType?: "advisory" | "exclusive", expiryMs?: number): {
+    acquired: boolean;
+    lock: ResourceLock | null;
+    held_by?: string;
+};
+export declare function releaseLock(resourceType: string, resourceId: string, agentId: string): boolean;
+export declare function checkLock(resourceType: string, resourceId: string): ResourceLock | null;
+export declare function cleanExpiredLocks(): number;
+export declare function listLocks(opts?: {
+    resource_type?: string;
+    agent_id?: string;
+}): ResourceLock[];

package/dist/lib/locks.test.d.ts

@@ -0,0 +1 @@
+export {};

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.29",
+  "version": "0.1.31",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {