@hasna/conversations 0.2.1 → 0.2.3

package/dist/index.js

@@ -5,39 +5,60 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
-var __moduleCache = /* @__PURE__ */ new WeakMap;
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
   if (entry)
     return entry;
   entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
   __moduleCache.set(from, entry);
   return entry;
 };
+var __moduleCache;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -3646,10 +3667,12 @@ function renameAgent(oldName, newName) {
 // src/lib/locks.ts
 init_db();
 var DEFAULT_LOCK_EXPIRY_MS = 5 * 60 * 1000;
+var STALE_HEARTBEAT_SECONDS = 30 * 60;
 function acquireLock(resourceType, resourceId, agentId, lockType = "advisory", expiryMs = DEFAULT_LOCK_EXPIRY_MS) {
   const db2 = getDb();
   return db2.transaction(() => {
     cleanExpiredLocks();
+    releaseStaleAgentLocks();
     const existing = db2.prepare(`
       SELECT * FROM resource_locks
       WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
@@ -3676,6 +3699,55 @@ function acquireLock(resourceType, resourceId, agentId, lockType = "advisory", e
     return { acquired: true, lock };
   }).immediate();
 }
+function bulkAcquireLock(resources, agentId) {
+  const db2 = getDb();
+  return db2.transaction(() => {
+    cleanExpiredLocks();
+    releaseStaleAgentLocks();
+    const acquired = [];
+    for (const { resource_type, resource_id, lock_type = "advisory", expiry_ms = DEFAULT_LOCK_EXPIRY_MS } of resources) {
+      const existing = db2.prepare(`
+        SELECT * FROM resource_locks
+        WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
+      `).get(resource_type, resource_id, lock_type);
+      if (existing && existing.agent_id !== agentId) {
+        throw { _bulkConflict: true, resource_type, resource_id, held_by: existing.agent_id };
+      }
+      const expiresAt = new Date(Date.now() + expiry_ms).toISOString().slice(0, -1);
+      if (existing) {
+        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, resource_type, resource_id, lock_type);
+      } else {
+        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(resource_type, resource_id, agentId, lock_type, expiresAt);
+      }
+      const lock = db2.prepare(`
+        SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = ?
+      `).get(resource_type, resource_id, lock_type);
+      acquired.push(lock);
+    }
+    return { acquired: true, locks: acquired };
+  }).immediate();
+}
+function tryBulkAcquireLock(resources, agentId) {
+  try {
+    return bulkAcquireLock(resources, agentId);
+  } catch (err) {
+    const e = err;
+    if (e?._bulkConflict) {
+      return {
+        acquired: false,
+        locks: [],
+        blocked_by: { resource_type: e.resource_type, resource_id: e.resource_id, held_by: e.held_by }
+      };
+    }
+    throw err;
+  }
+}
 function releaseLock(resourceType, resourceId, agentId) {
   const db2 = getDb();
   const result = db2.prepare(`
@@ -3687,6 +3759,7 @@ function releaseLock(resourceType, resourceId, agentId) {
 function checkLock(resourceType, resourceId) {
   const db2 = getDb();
   cleanExpiredLocks();
+  releaseStaleAgentLocks();
   return db2.prepare(`
     SELECT * FROM resource_locks
     WHERE resource_type = ? AND resource_id = ?
@@ -3694,6 +3767,17 @@ function checkLock(resourceType, resourceId) {
     LIMIT 1
   `).get(resourceType, resourceId);
 }
+function releaseStaleAgentLocks() {
+  const db2 = getDb();
+  const result = db2.prepare(`
+    DELETE FROM resource_locks
+    WHERE LOWER(agent_id) IN (
+      SELECT LOWER(agent) FROM agent_presence
+      WHERE last_seen_at < strftime('%Y-%m-%dT%H:%M:%f', 'now', '-${STALE_HEARTBEAT_SECONDS} seconds')
+    )
+  `).run();
+  return result.changes;
+}
 function cleanExpiredLocks() {
   const db2 = getDb();
   const result = db2.prepare(`
@@ -3704,6 +3788,7 @@ function cleanExpiredLocks() {
 function listLocks(opts) {
   const db2 = getDb();
   cleanExpiredLocks();
+  releaseStaleAgentLocks();
   let query = "SELECT * FROM resource_locks WHERE 1=1";
   const params = [];
   if (opts?.resource_type) {
@@ -3717,6 +3802,31 @@ function listLocks(opts) {
   query += " ORDER BY locked_at ASC";
   return db2.prepare(query).all(...params);
 }
+function listLocksEnriched(opts) {
+  const locks = listLocks(opts);
+  const db2 = getDb();
+  const nowMs = Date.now();
+  return locks.map((lock) => {
+    const lockedMs = new Date(lock.locked_at + "Z").getTime();
+    const expiresMs = new Date(lock.expires_at + "Z").getTime();
+    const presenceRow = db2.prepare(`
+      SELECT role, status, last_seen_at, project_id FROM agent_presence WHERE LOWER(agent) = LOWER(?)
+    `).get(lock.agent_id);
+    const agent = presenceRow ? {
+      role: presenceRow.role ?? null,
+      status: presenceRow.status ?? null,
+      online: presenceRow.last_seen_at ? nowMs - new Date(presenceRow.last_seen_at + "Z").getTime() < 60000 : false,
+      last_seen_at: presenceRow.last_seen_at ?? null,
+      project_id: presenceRow.project_id ?? null
+    } : null;
+    return {
+      ...lock,
+      locked_seconds_ago: Math.round((nowMs - lockedMs) / 1000),
+      expires_in_seconds: Math.round((expiresMs - nowMs) / 1000),
+      agent
+    };
+  });
+}
 // src/lib/hot.ts
 init_db();
 function computeHotness(sessionId) {
@@ -4201,6 +4311,7 @@ export {
   updateProject,
   unpinMessage,
   unarchiveSpace,
+  tryBulkAcquireLock,
   startPolling,
   sendMessage,
   searchMessages,
@@ -4209,6 +4320,7 @@ export {
   renameAgent,
   removeReaction,
   removePresence,
+  releaseStaleAgentLocks,
   releaseLock,
   registerAgent,
   readMessages,
@@ -4220,6 +4332,7 @@ export {
   listSpaces,
   listSessions,
   listProjects,
+  listLocksEnriched,
   listLocks,
   listHotSessions,
   listAgents,

package/dist/lib/locks.d.ts

@@ -6,15 +6,48 @@ export interface ResourceLock {
     locked_at: string;
     expires_at: string;
 }
+export interface BulkLockRequest {
+    resource_type: string;
+    resource_id: string;
+    lock_type?: "advisory" | "exclusive";
+    expiry_ms?: number;
+}
+export interface BulkAcquireResult {
+    acquired: boolean;
+    locks: ResourceLock[];
+    blocked_by?: {
+        resource_type: string;
+        resource_id: string;
+        held_by: string;
+    };
+}
+export interface EnrichedLock extends ResourceLock {
+    locked_seconds_ago: number;
+    expires_in_seconds: number;
+    agent: {
+        role: string | null;
+        status: string | null;
+        online: boolean;
+        last_seen_at: string | null;
+        project_id: string | null;
+    } | null;
+}
 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 bulkAcquireLock(resources: BulkLockRequest[], agentId: string): BulkAcquireResult;
+export declare function tryBulkAcquireLock(resources: BulkLockRequest[], agentId: string): BulkAcquireResult;
 export declare function releaseLock(resourceType: string, resourceId: string, agentId: string): boolean;
 export declare function checkLock(resourceType: string, resourceId: string): ResourceLock | null;
+export declare function releaseStaleAgentLocks(): number;
 export declare function cleanExpiredLocks(): number;
 export declare function listLocks(opts?: {
     resource_type?: string;
     agent_id?: string;
 }): ResourceLock[];
+export declare function listLocksEnriched(opts?: {
+    resource_type?: string;
+    agent_id?: string;
+}): EnrichedLock[];

package/dist/lib/messages.d.ts

@@ -7,7 +7,34 @@ export declare function markRead(ids: number[], reader: string): number;
 export declare function markSessionRead(sessionId: string, reader: string): number;
 export declare function markSpaceRead(spaceName: string, reader: string): number;
 export declare function getMessageById(id: number): Message | null;
+export declare function markReadByIds(ids: number[]): number;
 export declare function markAllRead(agent: string): number;
+export interface DigestMessage {
+    id: number;
+    from: string;
+    created_at: string;
+    preview: string;
+    priority: string;
+    has_attachments: boolean;
+    space?: string | null;
+    to?: string | null;
+    unread: boolean;
+}
+export interface DigestResult {
+    messages: DigestMessage[];
+    total_unread: number;
+    shown: number;
+}
+export interface ReadDigestOptions {
+    space?: string;
+    session_id?: string;
+    to?: string;
+    since?: string;
+    limit?: number;
+    unread_only?: boolean;
+    project_id?: string;
+}
+export declare function readDigest(opts?: ReadDigestOptions): DigestResult;
 export interface ExportMessagesOptions {
     space?: string;
     session_id?: string;
@@ -29,3 +56,14 @@ export declare function getPinnedMessages(opts?: {
 export declare function getUnreadBlockers(agent: string): Message[];
 export declare function getThreadReplies(messageId: number): Message[];
 export declare function searchMessages(opts: SearchMessagesOptions): SearchResult[];
+export interface UnreadCount {
+    space: string;
+    unread_count: number;
+    latest_message_at: string | null;
+}
+/**
+ * Get unread message counts per space — lightweight alternative to read_messages.
+ * Returns only spaces where the agent is a member (via space_members) or has received messages.
+ * If agent is omitted, returns counts for all spaces.
+ */
+export declare function listUnreadCounts(agent?: string): UnreadCount[];

package/package.json

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