@hasna/conversations 0.1.29 → 0.1.30

package/bin/hook.js

@@ -125,6 +125,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,

package/bin/index.js

@@ -1979,6 +1979,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,
@@ -3599,7 +3613,7 @@ var init_poll = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.1.29",
+    version: "0.1.30",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {

package/bin/mcp.js

@@ -6611,6 +6611,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,
@@ -29872,7 +29886,7 @@ function renameAgent(oldName, newName) {
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.1.29",
+  version: "0.1.30",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {

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

@@ -138,6 +138,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,
@@ -3557,6 +3571,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 +3659,7 @@ export {
   renameAgent,
   removeReaction,
   removePresence,
+  releaseLock,
   registerAgent,
   readMessages,
   pinMessage,
@@ -3581,6 +3670,7 @@ export {
   listSpaces,
   listSessions,
   listProjects,
+  listLocks,
   listAgents,
   leaveSpace,
   joinSpace,
@@ -3610,6 +3700,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/package.json

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