@hasna/mementos 0.4.38 → 0.4.41

package/dist/cli/index.js

@@ -2405,13 +2405,53 @@ var init_database = __esm(() => {
   ALTER TABLE agents ADD COLUMN active_project_id TEXT REFERENCES projects(id) ON DELETE SET NULL;
   CREATE INDEX IF NOT EXISTS idx_agents_active_project ON agents(active_project_id);
   INSERT OR IGNORE INTO _migrations (id) VALUES (6);
+  `,
+    `
+  ALTER TABLE agents ADD COLUMN session_id TEXT;
+  CREATE INDEX IF NOT EXISTS idx_agents_session ON agents(session_id);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (7);
+  `,
+    `
+  CREATE TABLE IF NOT EXISTS resource_locks (
+    id TEXT PRIMARY KEY,
+    resource_type TEXT NOT NULL CHECK(resource_type IN ('project', 'memory', 'entity', 'agent', 'connector')),
+    resource_id TEXT NOT NULL,
+    agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+    lock_type TEXT NOT NULL DEFAULT 'exclusive' CHECK(lock_type IN ('advisory', 'exclusive')),
+    locked_at TEXT NOT NULL DEFAULT (datetime('now')),
+    expires_at TEXT NOT NULL
+  );
+  CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
+    ON resource_locks(resource_type, resource_id)
+    WHERE lock_type = 'exclusive';
+  CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
+  CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (8);
   `
   ];
 });
 
 // src/types/index.ts
-var EntityNotFoundError, MemoryNotFoundError, VersionConflictError;
+var AgentConflictError, EntityNotFoundError, MemoryNotFoundError, VersionConflictError;
 var init_types = __esm(() => {
+  AgentConflictError = class AgentConflictError extends Error {
+    conflict = true;
+    existing_id;
+    existing_name;
+    last_seen_at;
+    session_hint;
+    working_dir;
+    constructor(opts) {
+      const msg = `Agent "${opts.existing_name}" is already active (session hint: ${opts.session_hint ?? "unknown"}, last seen ${opts.last_seen_at}). Wait 30 minutes or use a different name.`;
+      super(msg);
+      this.name = "AgentConflictError";
+      this.existing_id = opts.existing_id;
+      this.existing_name = opts.existing_name;
+      this.last_seen_at = opts.last_seen_at;
+      this.session_hint = opts.session_hint;
+      this.working_dir = opts.working_dir ?? null;
+    }
+  };
   EntityNotFoundError = class EntityNotFoundError extends Error {
     constructor(id) {
       super(`Entity not found: ${id}`);
@@ -2471,6 +2511,7 @@ function parseAgentRow(row) {
   return {
     id: row["id"],
     name: row["name"],
+    session_id: row["session_id"] || null,
     description: row["description"] || null,
     role: row["role"] || null,
     metadata: JSON.parse(row["metadata"] || "{}"),
@@ -2479,33 +2520,46 @@ function parseAgentRow(row) {
     last_seen_at: row["last_seen_at"]
   };
 }
-function registerAgent(name, description, role, db) {
+function registerAgent(name, sessionId, description, role, projectId, db) {
   const d = db || getDatabase();
   const timestamp = now();
   const normalizedName = name.trim().toLowerCase();
   const existing = d.query("SELECT * FROM agents WHERE LOWER(name) = ?").get(normalizedName);
   if (existing) {
     const existingId = existing["id"];
-    d.run("UPDATE agents SET last_seen_at = ? WHERE id = ?", [
+    const existingSessionId = existing["session_id"] || null;
+    const existingLastSeen = existing["last_seen_at"];
+    if (sessionId && existingSessionId && existingSessionId !== sessionId) {
+      const lastSeenMs = new Date(existingLastSeen).getTime();
+      const nowMs = Date.now();
+      if (nowMs - lastSeenMs < CONFLICT_WINDOW_MS) {
+        throw new AgentConflictError({
+          existing_id: existingId,
+          existing_name: normalizedName,
+          last_seen_at: existingLastSeen,
+          session_hint: existingSessionId.slice(0, 8),
+          working_dir: null
+        });
+      }
+    }
+    d.run("UPDATE agents SET last_seen_at = ?, session_id = ? WHERE id = ?", [
       timestamp,
+      sessionId ?? existingSessionId,
       existingId
     ]);
     if (description) {
-      d.run("UPDATE agents SET description = ? WHERE id = ?", [
-        description,
-        existingId
-      ]);
+      d.run("UPDATE agents SET description = ? WHERE id = ?", [description, existingId]);
     }
     if (role) {
-      d.run("UPDATE agents SET role = ? WHERE id = ?", [
-        role,
-        existingId
-      ]);
+      d.run("UPDATE agents SET role = ? WHERE id = ?", [role, existingId]);
+    }
+    if (projectId !== undefined) {
+      d.run("UPDATE agents SET active_project_id = ? WHERE id = ?", [projectId, existingId]);
     }
     return getAgent(existingId, d);
   }
   const id = shortUuid();
-  d.run("INSERT INTO agents (id, name, description, role, created_at, last_seen_at) VALUES (?, ?, ?, ?, ?, ?)", [id, normalizedName, description || null, role || "agent", timestamp, timestamp]);
+  d.run("INSERT INTO agents (id, name, session_id, description, role, active_project_id, created_at, last_seen_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)", [id, normalizedName, sessionId ?? null, description || null, role || "agent", projectId ?? null, timestamp, timestamp]);
   return getAgent(id, d);
 }
 function getAgent(idOrName, db) {
@@ -2557,8 +2611,11 @@ function updateAgent(id, updates, db) {
   d.run("UPDATE agents SET last_seen_at = ? WHERE id = ?", [timestamp, agent.id]);
   return getAgent(agent.id, d);
 }
+var CONFLICT_WINDOW_MS;
 var init_agents = __esm(() => {
+  init_types();
   init_database();
+  CONFLICT_WINDOW_MS = 30 * 60 * 1000;
 });
 
 // src/db/projects.ts
@@ -5347,10 +5404,10 @@ program2.command("clean").description("Remove expired memories and enforce quota
     handleError(e);
   }
 });
-program2.command("init <name>").description("Register an agent (returns ID)").option("-d, --description <text>", "Agent description").option("-r, --role <role>", "Agent role").action((name, opts) => {
+program2.command("init <name>").description("Register an agent (returns ID)").option("-d, --description <text>", "Agent description").option("-r, --role <role>", "Agent role").option("-p, --project <id>", "Lock agent to a project (sets active_project_id)").action((name, opts) => {
   try {
     const globalOpts = program2.opts();
-    const agent = registerAgent(name, opts.description, opts.role);
+    const agent = registerAgent(name, undefined, opts.description, opts.role, opts.project);
     if (globalOpts.json) {
       outputJson(agent);
     } else {
@@ -5463,7 +5520,7 @@ program2.command("projects").description("Manage projects").option("--add", "Add
     handleError(e);
   }
 });
-program2.command("inject").description("Output injection context for agent system prompts").option("--agent <name>", "Agent ID for scope filtering").option("--project <path>", "Project path for scope filtering").option("--session <id>", "Session ID for scope filtering").option("--max-tokens <n>", "Max approximate token budget", parseInt).option("--categories <cats>", "Comma-separated categories to include").action((opts) => {
+program2.command("inject").description("Output injection context for agent system prompts").option("--agent <name>", "Agent ID for scope filtering").option("--project <path>", "Project path for scope filtering").option("--session <id>", "Session ID for scope filtering").option("--max-tokens <n>", "Max approximate token budget", parseInt).option("--categories <cats>", "Comma-separated categories to include").option("--format <fmt>", "Output format: xml (default), compact, markdown, json").action((opts) => {
   try {
     const globalOpts = program2.opts();
     const maxTokens = opts.maxTokens || 500;
@@ -5527,8 +5584,16 @@ program2.command("inject").description("Output injection context for agent syste
     const charBudget = maxTokens * 4;
     const lines = [];
     let totalChars = 0;
+    const fmt = opts.format || "xml";
     for (const m of unique) {
-      const line = `- [${m.scope}/${m.category}] ${m.key}: ${m.value}`;
+      let line;
+      if (fmt === "compact") {
+        line = `${m.key}: ${m.value}`;
+      } else if (fmt === "json") {
+        line = JSON.stringify({ key: m.key, value: m.value, scope: m.scope, category: m.category, importance: m.importance });
+      } else {
+        line = `- [${m.scope}/${m.category}] ${m.key}: ${m.value}`;
+      }
       if (totalChars + line.length > charBudget)
         break;
       lines.push(line);
@@ -5543,10 +5608,23 @@ program2.command("inject").description("Output injection context for agent syste
       }
       return;
     }
-    const context = `<agent-memories>
+    let context;
+    if (fmt === "compact") {
+      context = lines.join(`
+`);
+    } else if (fmt === "json") {
+      context = `[${lines.join(",")}]`;
+    } else if (fmt === "markdown") {
+      context = `## Agent Memories
+
+${lines.join(`
+`)}`;
+    } else {
+      context = `<agent-memories>
 ${lines.join(`
 `)}
 </agent-memories>`;
+    }
     if (globalOpts.json) {
       outputJson({ context, count: lines.length });
     } else {

package/dist/db/agents.d.ts

@@ -1,6 +1,6 @@
 import { Database } from "bun:sqlite";
 import type { Agent } from "../types/index.js";
-export declare function registerAgent(name: string, description?: string, role?: string, db?: Database): Agent;
+export declare function registerAgent(name: string, sessionId?: string, description?: string, role?: string, projectId?: string, db?: Database): Agent;
 export declare function getAgent(idOrName: string, db?: Database): Agent | null;
 export declare function listAgents(db?: Database): Agent[];
 export declare function touchAgent(idOrName: string, db?: Database): void;

package/dist/db/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAgB/C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,CAsCP;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAsBd;AAED,wBAAgB,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAMjD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAKhE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAM7E;AAED,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACtI,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAyCd"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAoB/C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,CAuDP;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAsBd;AAED,wBAAgB,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAMjD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAKhE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAM7E;AAED,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACtI,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAyCd"}

package/dist/db/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmCtC,wBAAgB,SAAS,IAAI,MAAM,CAkBlC;AAyOD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAerD;AA+BD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAef"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmCtC,wBAAgB,SAAS,IAAI,MAAM,CAkBlC;AAmQD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAerD;AA+BD,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAef"}

package/dist/db/locks.d.ts

@@ -0,0 +1,52 @@
+import { Database } from "bun:sqlite";
+export type ResourceType = "project" | "memory" | "entity" | "agent" | "connector";
+export type LockType = "advisory" | "exclusive";
+export interface ResourceLock {
+    id: string;
+    resource_type: ResourceType;
+    resource_id: string;
+    agent_id: string;
+    lock_type: LockType;
+    locked_at: string;
+    expires_at: string;
+}
+/**
+ * Acquire a lock on a resource.
+ * - advisory: multiple agents can hold advisory locks simultaneously
+ * - exclusive: only one agent can hold an exclusive lock at a time
+ *
+ * Returns the lock if acquired, null if blocked by an existing exclusive lock.
+ * TTL is in seconds (default: 5 minutes).
+ */
+export declare function acquireLock(agentId: string, resourceType: ResourceType, resourceId: string, lockType?: LockType, ttlSeconds?: number, db?: Database): ResourceLock | null;
+/**
+ * Release a specific lock by ID. Only the owning agent can release it.
+ * Returns true if released, false if not found or not owned.
+ */
+export declare function releaseLock(lockId: string, agentId: string, db?: Database): boolean;
+/**
+ * Release all locks held by an agent on a specific resource.
+ */
+export declare function releaseResourceLocks(agentId: string, resourceType: ResourceType, resourceId: string, db?: Database): number;
+/**
+ * Release all locks held by an agent (e.g., on session end).
+ */
+export declare function releaseAllAgentLocks(agentId: string, db?: Database): number;
+/**
+ * Check if a resource is currently locked.
+ * Returns the active lock(s) or empty array.
+ */
+export declare function checkLock(resourceType: ResourceType, resourceId: string, lockType?: LockType, db?: Database): ResourceLock[];
+/**
+ * Check if a specific agent holds a lock on a resource.
+ */
+export declare function agentHoldsLock(agentId: string, resourceType: ResourceType, resourceId: string, lockType?: LockType, db?: Database): ResourceLock | null;
+/**
+ * List all active locks for an agent.
+ */
+export declare function listAgentLocks(agentId: string, db?: Database): ResourceLock[];
+/**
+ * Delete all expired locks. Called automatically by other lock functions.
+ */
+export declare function cleanExpiredLocks(db?: Database): number;
+//# sourceMappingURL=locks.d.ts.map

package/dist/db/locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../src/db/locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AACnF,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,QAAsB,EAChC,UAAU,SAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAuDrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAOnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,EAAE,CAgBhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAcrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAIvD"}

package/dist/index.d.ts

@@ -3,6 +3,9 @@ export { MemoryNotFoundError, DuplicateMemoryError, MemoryExpiredError, InvalidS
 export { getDatabase, closeDatabase, resetDatabase, getDbPath, resolvePartialId, now, uuid, shortUuid, } from "./db/database.js";
 export { createMemory, getMemory, getMemoryByKey, getMemoriesByKey, listMemories, updateMemory, deleteMemory, bulkDeleteMemories, touchMemory, cleanExpiredMemories, getMemoryVersions, } from "./db/memories.js";
 export { registerAgent, getAgent, listAgents, listAgentsByProject, updateAgent, touchAgent, } from "./db/agents.js";
+export { acquireLock, releaseLock, releaseResourceLocks, releaseAllAgentLocks, checkLock, agentHoldsLock, listAgentLocks, cleanExpiredLocks, } from "./db/locks.js";
+export type { ResourceLock, ResourceType, LockType } from "./db/locks.js";
+export { acquireMemoryWriteLock, releaseMemoryWriteLock, checkMemoryWriteLock, withMemoryLock, MemoryLockConflictError, memoryLockId, } from "./lib/memory-lock.js";
 export { registerProject, getProject, listProjects, } from "./db/projects.js";
 export { searchMemories } from "./lib/search.js";
 export { loadConfig, DEFAULT_CONFIG, getActiveProfile, setActiveProfile, listProfiles, deleteProfile, } from "./lib/config.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,KAAK,EACL,OAAO,EACP,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,kBAAkB,EAElB,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,GAAG,EACH,IAAI,EACJ,SAAS,GACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAG/G,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,KAAK,EACL,OAAO,EACP,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,kBAAkB,EAElB,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,GAAG,EACH,IAAI,EACJ,SAAS,GACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG1E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAG/G,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,5 +1,23 @@
 // @bun
 // src/types/index.ts
+class AgentConflictError extends Error {
+  conflict = true;
+  existing_id;
+  existing_name;
+  last_seen_at;
+  session_hint;
+  working_dir;
+  constructor(opts) {
+    const msg = `Agent "${opts.existing_name}" is already active (session hint: ${opts.session_hint ?? "unknown"}, last seen ${opts.last_seen_at}). Wait 30 minutes or use a different name.`;
+    super(msg);
+    this.name = "AgentConflictError";
+    this.existing_id = opts.existing_id;
+    this.existing_name = opts.existing_name;
+    this.last_seen_at = opts.last_seen_at;
+    this.session_hint = opts.session_hint;
+    this.working_dir = opts.working_dir ?? null;
+  }
+}
 class EntityNotFoundError extends Error {
   constructor(id) {
     super(`Entity not found: ${id}`);
@@ -301,6 +319,28 @@ var MIGRATIONS = [
   ALTER TABLE agents ADD COLUMN active_project_id TEXT REFERENCES projects(id) ON DELETE SET NULL;
   CREATE INDEX IF NOT EXISTS idx_agents_active_project ON agents(active_project_id);
   INSERT OR IGNORE INTO _migrations (id) VALUES (6);
+  `,
+  `
+  ALTER TABLE agents ADD COLUMN session_id TEXT;
+  CREATE INDEX IF NOT EXISTS idx_agents_session ON agents(session_id);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (7);
+  `,
+  `
+  CREATE TABLE IF NOT EXISTS resource_locks (
+    id TEXT PRIMARY KEY,
+    resource_type TEXT NOT NULL CHECK(resource_type IN ('project', 'memory', 'entity', 'agent', 'connector')),
+    resource_id TEXT NOT NULL,
+    agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+    lock_type TEXT NOT NULL DEFAULT 'exclusive' CHECK(lock_type IN ('advisory', 'exclusive')),
+    locked_at TEXT NOT NULL DEFAULT (datetime('now')),
+    expires_at TEXT NOT NULL
+  );
+  CREATE UNIQUE INDEX IF NOT EXISTS idx_resource_locks_exclusive
+    ON resource_locks(resource_type, resource_id)
+    WHERE lock_type = 'exclusive';
+  CREATE INDEX IF NOT EXISTS idx_resource_locks_agent ON resource_locks(agent_id);
+  CREATE INDEX IF NOT EXISTS idx_resource_locks_expires ON resource_locks(expires_at);
+  INSERT OR IGNORE INTO _migrations (id) VALUES (8);
   `
 ];
 var _db = null;
@@ -399,10 +439,12 @@ function containsSecrets(text) {
 }
 
 // src/db/agents.ts
+var CONFLICT_WINDOW_MS = 30 * 60 * 1000;
 function parseAgentRow(row) {
   return {
     id: row["id"],
     name: row["name"],
+    session_id: row["session_id"] || null,
     description: row["description"] || null,
     role: row["role"] || null,
     metadata: JSON.parse(row["metadata"] || "{}"),
@@ -411,33 +453,46 @@ function parseAgentRow(row) {
     last_seen_at: row["last_seen_at"]
   };
 }
-function registerAgent(name, description, role, db) {
+function registerAgent(name, sessionId, description, role, projectId, db) {
   const d = db || getDatabase();
   const timestamp = now();
   const normalizedName = name.trim().toLowerCase();
   const existing = d.query("SELECT * FROM agents WHERE LOWER(name) = ?").get(normalizedName);
   if (existing) {
     const existingId = existing["id"];
-    d.run("UPDATE agents SET last_seen_at = ? WHERE id = ?", [
+    const existingSessionId = existing["session_id"] || null;
+    const existingLastSeen = existing["last_seen_at"];
+    if (sessionId && existingSessionId && existingSessionId !== sessionId) {
+      const lastSeenMs = new Date(existingLastSeen).getTime();
+      const nowMs = Date.now();
+      if (nowMs - lastSeenMs < CONFLICT_WINDOW_MS) {
+        throw new AgentConflictError({
+          existing_id: existingId,
+          existing_name: normalizedName,
+          last_seen_at: existingLastSeen,
+          session_hint: existingSessionId.slice(0, 8),
+          working_dir: null
+        });
+      }
+    }
+    d.run("UPDATE agents SET last_seen_at = ?, session_id = ? WHERE id = ?", [
       timestamp,
+      sessionId ?? existingSessionId,
       existingId
     ]);
     if (description) {
-      d.run("UPDATE agents SET description = ? WHERE id = ?", [
-        description,
-        existingId
-      ]);
+      d.run("UPDATE agents SET description = ? WHERE id = ?", [description, existingId]);
     }
     if (role) {
-      d.run("UPDATE agents SET role = ? WHERE id = ?", [
-        role,
-        existingId
-      ]);
+      d.run("UPDATE agents SET role = ? WHERE id = ?", [role, existingId]);
+    }
+    if (projectId !== undefined) {
+      d.run("UPDATE agents SET active_project_id = ? WHERE id = ?", [projectId, existingId]);
     }
     return getAgent(existingId, d);
   }
   const id = shortUuid();
-  d.run("INSERT INTO agents (id, name, description, role, created_at, last_seen_at) VALUES (?, ?, ?, ?, ?, ?)", [id, normalizedName, description || null, role || "agent", timestamp, timestamp]);
+  d.run("INSERT INTO agents (id, name, session_id, description, role, active_project_id, created_at, last_seen_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)", [id, normalizedName, sessionId ?? null, description || null, role || "agent", projectId ?? null, timestamp, timestamp]);
   return getAgent(id, d);
 }
 function getAgent(idOrName, db) {
@@ -1602,6 +1657,134 @@ function getMemoryVersions(memoryId, db) {
     return [];
   }
 }
+// src/db/locks.ts
+function parseLockRow(row) {
+  return {
+    id: row["id"],
+    resource_type: row["resource_type"],
+    resource_id: row["resource_id"],
+    agent_id: row["agent_id"],
+    lock_type: row["lock_type"],
+    locked_at: row["locked_at"],
+    expires_at: row["expires_at"]
+  };
+}
+function acquireLock(agentId, resourceType, resourceId, lockType = "exclusive", ttlSeconds = 300, db) {
+  const d = db || getDatabase();
+  cleanExpiredLocks(d);
+  const ownLock = d.query("SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND agent_id = ? AND lock_type = ? AND expires_at > datetime('now')").get(resourceType, resourceId, agentId, lockType);
+  if (ownLock) {
+    const newExpiry = new Date(Date.now() + ttlSeconds * 1000).toISOString();
+    d.run("UPDATE resource_locks SET expires_at = ? WHERE id = ?", [
+      newExpiry,
+      ownLock["id"]
+    ]);
+    return parseLockRow({ ...ownLock, expires_at: newExpiry });
+  }
+  if (lockType === "exclusive") {
+    const existing = d.query("SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = 'exclusive' AND agent_id != ? AND expires_at > datetime('now')").get(resourceType, resourceId, agentId);
+    if (existing) {
+      return null;
+    }
+  }
+  const id = shortUuid();
+  const lockedAt = now();
+  const expiresAt = new Date(Date.now() + ttlSeconds * 1000).toISOString();
+  d.run("INSERT INTO resource_locks (id, resource_type, resource_id, agent_id, lock_type, locked_at, expires_at) VALUES (?, ?, ?, ?, ?, ?, ?)", [id, resourceType, resourceId, agentId, lockType, lockedAt, expiresAt]);
+  return {
+    id,
+    resource_type: resourceType,
+    resource_id: resourceId,
+    agent_id: agentId,
+    lock_type: lockType,
+    locked_at: lockedAt,
+    expires_at: expiresAt
+  };
+}
+function releaseLock(lockId, agentId, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM resource_locks WHERE id = ? AND agent_id = ?", [lockId, agentId]);
+  return result.changes > 0;
+}
+function releaseResourceLocks(agentId, resourceType, resourceId, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM resource_locks WHERE agent_id = ? AND resource_type = ? AND resource_id = ?", [agentId, resourceType, resourceId]);
+  return result.changes;
+}
+function releaseAllAgentLocks(agentId, db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM resource_locks WHERE agent_id = ?", [agentId]);
+  return result.changes;
+}
+function checkLock(resourceType, resourceId, lockType, db) {
+  const d = db || getDatabase();
+  cleanExpiredLocks(d);
+  const query = lockType ? "SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = ? AND expires_at > datetime('now')" : "SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND expires_at > datetime('now')";
+  const rows = lockType ? d.query(query).all(resourceType, resourceId, lockType) : d.query(query).all(resourceType, resourceId);
+  return rows.map(parseLockRow);
+}
+function agentHoldsLock(agentId, resourceType, resourceId, lockType, db) {
+  const d = db || getDatabase();
+  const query = lockType ? "SELECT * FROM resource_locks WHERE agent_id = ? AND resource_type = ? AND resource_id = ? AND lock_type = ? AND expires_at > datetime('now')" : "SELECT * FROM resource_locks WHERE agent_id = ? AND resource_type = ? AND resource_id = ? AND expires_at > datetime('now')";
+  const row = lockType ? d.query(query).get(agentId, resourceType, resourceId, lockType) : d.query(query).get(agentId, resourceType, resourceId);
+  return row ? parseLockRow(row) : null;
+}
+function listAgentLocks(agentId, db) {
+  const d = db || getDatabase();
+  cleanExpiredLocks(d);
+  const rows = d.query("SELECT * FROM resource_locks WHERE agent_id = ? AND expires_at > datetime('now') ORDER BY locked_at DESC").all(agentId);
+  return rows.map(parseLockRow);
+}
+function cleanExpiredLocks(db) {
+  const d = db || getDatabase();
+  const result = d.run("DELETE FROM resource_locks WHERE expires_at <= datetime('now')");
+  return result.changes;
+}
+// src/lib/memory-lock.ts
+var MEMORY_WRITE_TTL = 30;
+function memoryLockId(key, scope, projectId) {
+  return `${scope}:${key}:${projectId ?? ""}`;
+}
+function acquireMemoryWriteLock(agentId, key, scope, projectId, ttlSeconds = MEMORY_WRITE_TTL, db) {
+  const d = db || getDatabase();
+  return acquireLock(agentId, "memory", memoryLockId(key, scope, projectId), "exclusive", ttlSeconds, d);
+}
+function releaseMemoryWriteLock(lockId, agentId, db) {
+  const d = db || getDatabase();
+  return releaseLock(lockId, agentId, d);
+}
+function checkMemoryWriteLock(key, scope, projectId, db) {
+  const d = db || getDatabase();
+  const locks = checkLock("memory", memoryLockId(key, scope, projectId), "exclusive", d);
+  return locks[0] ?? null;
+}
+function withMemoryLock(agentId, key, scope, projectId, fn, ttlSeconds = MEMORY_WRITE_TTL, db) {
+  const d = db || getDatabase();
+  const lock = acquireMemoryWriteLock(agentId, key, scope, projectId, ttlSeconds, d);
+  if (!lock) {
+    const existing = checkMemoryWriteLock(key, scope, projectId, d);
+    throw new MemoryLockConflictError(key, scope, existing?.agent_id ?? "unknown");
+  }
+  try {
+    return fn();
+  } finally {
+    releaseLock(lock.id, agentId, d);
+  }
+}
+
+class MemoryLockConflictError extends Error {
+  conflict = true;
+  key;
+  scope;
+  blocking_agent_id;
+  constructor(key, scope, blockingAgentId) {
+    super(`Memory key "${key}" (scope: ${scope}) is currently write-locked by agent ${blockingAgentId}. ` + "Retry after a few seconds or use optimistic locking (version field).");
+    this.name = "MemoryLockConflictError";
+    this.key = key;
+    this.scope = scope;
+    this.blocking_agent_id = blockingAgentId;
+  }
+}
 // src/lib/search.ts
 function parseMemoryRow2(row) {
   return {
@@ -2481,6 +2664,7 @@ function syncMemories(agentName, direction = "both", options = {}) {
 }
 var defaultSyncAgents = ["claude", "codex", "gemini"];
 export {
+  withMemoryLock,
   uuid,
   updateMemory,
   updateEntity,
@@ -2495,6 +2679,10 @@ export {
   runCleanup,
   resolvePartialId,
   resetDatabase,
+  releaseResourceLocks,
+  releaseMemoryWriteLock,
+  releaseLock,
+  releaseAllAgentLocks,
   registerProject,
   registerAgent,
   redactSecrets,
@@ -2502,6 +2690,7 @@ export {
   parseEntityRow,
   now,
   mergeEntities,
+  memoryLockId,
   loadConfig,
   listRelations,
   listProjects,
@@ -2510,6 +2699,7 @@ export {
   listEntities,
   listAgentsByProject,
   listAgents,
+  listAgentLocks,
   linkEntityToMemory,
   getRelation,
   getRelatedEntities,
@@ -2543,12 +2733,19 @@ export {
   containsSecrets,
   closeDatabase,
   cleanExpiredMemories,
+  cleanExpiredLocks,
+  checkMemoryWriteLock,
+  checkLock,
   bulkLinkEntities,
   bulkDeleteMemories,
   archiveUnused,
   archiveStale,
+  agentHoldsLock,
+  acquireMemoryWriteLock,
+  acquireLock,
   VersionConflictError,
   MemoryNotFoundError,
+  MemoryLockConflictError,
   MemoryInjector,
   MemoryExpiredError,
   InvalidScopeError,

package/dist/lib/memory-lock.d.ts

@@ -0,0 +1,58 @@
+/**
+ * OPE4-00111: Concurrent memory access coordination
+ *
+ * Uses the resource_locks table (Migration 8) to provide:
+ * - Advisory locks for read-heavy coordination
+ * - Exclusive locks to prevent simultaneous writes to the same key
+ *
+ * Design:
+ * - Reads: always parallel, no locking needed
+ * - Writes: agents SHOULD acquire an exclusive lock on the memory key before writing
+ *   The lock resource_id uses format: "{scope}:{key}:{agent_id}:{project_id}"
+ *   This prevents two agents overwriting the same shared memory simultaneously
+ * - Optimistic fallback: if lock can't be acquired, VersionConflictError from
+ *   updateMemory() provides a second layer of protection
+ */
+import { Database } from "bun:sqlite";
+import { type ResourceLock } from "../db/locks.js";
+/**
+ * Compute the lock resource_id for a memory key.
+ * Scoped by scope + key + project so different projects don't block each other.
+ */
+export declare function memoryLockId(key: string, scope: string, projectId?: string | null): string;
+/**
+ * Acquire an exclusive write lock on a memory key.
+ * Returns the lock if acquired, null if another agent is writing.
+ */
+export declare function acquireMemoryWriteLock(agentId: string, key: string, scope: string, projectId?: string | null, ttlSeconds?: number, db?: Database): ResourceLock | null;
+/**
+ * Release a memory write lock.
+ */
+export declare function releaseMemoryWriteLock(lockId: string, agentId: string, db?: Database): boolean;
+/**
+ * Check if a memory key is currently write-locked.
+ * Returns the active lock or null.
+ */
+export declare function checkMemoryWriteLock(key: string, scope: string, projectId?: string | null, db?: Database): ResourceLock | null;
+/**
+ * Execute a callback with an exclusive memory write lock.
+ * Throws if the lock cannot be acquired (another agent is writing).
+ * Automatically releases the lock after the callback completes.
+ *
+ * Usage:
+ *   withMemoryLock(agentId, "my-key", "shared", projectId, () => {
+ *     createMemory({ key: "my-key", ... });
+ *   });
+ */
+export declare function withMemoryLock<T>(agentId: string, key: string, scope: string, projectId: string | null | undefined, fn: () => T, ttlSeconds?: number, db?: Database): T;
+/**
+ * Error thrown when a memory write lock cannot be acquired.
+ */
+export declare class MemoryLockConflictError extends Error {
+    readonly conflict: true;
+    readonly key: string;
+    readonly scope: string;
+    readonly blocking_agent_id: string;
+    constructor(key: string, scope: string, blockingAgentId: string);
+}
+//# sourceMappingURL=memory-lock.d.ts.map