@axiom-lattice/local-stores 2.0.10 → 3.0.1

package/dist/index.mjs

@@ -28,8 +28,9 @@ var DatabaseWrapper = class {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   run(sql, ...params) {
     this.db.run(sql, params);
+    const changes = this.db.getRowsModified();
     this.save();
-    return new RunResult(this.db);
+    return new RunResult(changes);
   }
   /**
    * Prepare and execute a query returning all matching rows as objects.
@@ -114,19 +115,20 @@ var StatementWrapper = class {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   run(...params) {
     this.db.run(this.sql, params);
+    const changes = this.db.getRowsModified();
     if (this.parent) {
       this.parent.save();
     }
-    return new RunResult(this.db);
+    return new RunResult(changes);
   }
 };
 var RunResult = class {
-  constructor(db) {
-    this.db = db;
+  constructor(modifiedRows) {
+    this.modifiedRows = modifiedRows;
   }
   /** Number of rows modified by the last INSERT/UPDATE/DELETE. */
   get changes() {
-    return this.db.getRowsModified();
+    return this.modifiedRows;
   }
 };
 async function initDatabase(options = {}) {
@@ -594,6 +596,7 @@ CREATE TABLE IF NOT EXISTS lt_projects (
   name TEXT NOT NULL,
   description TEXT,
   config TEXT,
+  kind TEXT DEFAULT 'business',
   created_at TEXT NOT NULL,
   updated_at TEXT NOT NULL,
   PRIMARY KEY (tenant_id, id)
@@ -604,8 +607,15 @@ var LocalProjectStore = class {
   constructor(db) {
     this.db = db;
     ensureTable(db, DDL4);
+    this.ensureColumn("lt_projects", "kind", "kind TEXT DEFAULT 'business'");
   }
-  async getProjectsByWorkspace(tenantId, workspaceId) {
+  async getProjectsByWorkspace(tenantId, workspaceId, filter) {
+    if (filter?.kind !== void 0) {
+      const rows2 = this.db.prepare(
+        `SELECT * FROM lt_projects WHERE tenant_id = ? AND workspace_id = ? AND kind = ? ORDER BY created_at DESC`
+      ).all(tenantId, workspaceId, filter.kind);
+      return rows2.map(mapRowToProject);
+    }
     const rows = this.db.prepare(
       `SELECT * FROM lt_projects WHERE tenant_id = ? AND workspace_id = ? ORDER BY created_at DESC`
     ).all(tenantId, workspaceId);
@@ -619,16 +629,18 @@ var LocalProjectStore = class {
   }
   async createProject(tenantId, workspaceId, id, data) {
     const now = nowISO();
+    const kind = data.kind || "business";
     this.db.prepare(
-      `INSERT INTO lt_projects (id, tenant_id, workspace_id, name, description, config, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      `INSERT INTO lt_projects (id, tenant_id, workspace_id, name, description, config, kind, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
        ON CONFLICT(tenant_id, id) DO UPDATE SET
          workspace_id = excluded.workspace_id,
          name = excluded.name,
          description = excluded.description,
          config = excluded.config,
+         kind = excluded.kind,
          updated_at = excluded.updated_at`
-    ).run(id, tenantId, workspaceId, data.name, data.description || null, data.config ? JSON.stringify(data.config) : null, now, now);
+    ).run(id, tenantId, workspaceId, data.name, data.description || null, data.config ? JSON.stringify(data.config) : null, kind, now, now);
     return {
       id,
       tenantId,
@@ -636,6 +648,7 @@ var LocalProjectStore = class {
       name: data.name,
       description: data.description,
       config: data.config,
+      kind,
       createdAt: parseISO(now),
       updatedAt: parseISO(now)
     };
@@ -657,6 +670,10 @@ var LocalProjectStore = class {
       setClauses.push("config = ?");
       values.push(updates.config ? JSON.stringify(updates.config) : null);
     }
+    if (updates.kind !== void 0) {
+      setClauses.push("kind = ?");
+      values.push(updates.kind);
+    }
     if (setClauses.length === 0) return existing;
     const now = nowISO();
     setClauses.push("updated_at = ?");
@@ -673,6 +690,13 @@ var LocalProjectStore = class {
     ).run(tenantId, id);
     return result.changes > 0;
   }
+  /** Add a column if it does not exist (SQLite version compatible). */
+  ensureColumn(table, column, ddl) {
+    const cols = this.db.prepare(`PRAGMA table_info(${table})`).all();
+    if (!cols.some((c) => c.name === column)) {
+      this.db.exec(`ALTER TABLE ${table} ADD COLUMN ${ddl}`);
+    }
+  }
 };
 function mapRowToProject(row) {
   return {
@@ -682,6 +706,7 @@ function mapRowToProject(row) {
     name: row.name,
     description: row.description || void 0,
     config: row.config ? JSON.parse(row.config) : void 0,
+    kind: row.kind || "business",
     createdAt: parseISO(row.created_at),
     updatedAt: parseISO(row.updated_at)
   };
@@ -2775,15 +2800,7 @@ var LocalChannelInstallationStore = class {
     this.db.prepare(
       `INSERT INTO lt_channel_installations
        (id, tenant_id, channel, name, config, enabled, fallback_agent_id, reject_when_no_binding, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-       ON CONFLICT(id) DO UPDATE SET
-         channel = excluded.channel,
-         name = excluded.name,
-         config = excluded.config,
-         enabled = excluded.enabled,
-         fallback_agent_id = excluded.fallback_agent_id,
-         reject_when_no_binding = excluded.reject_when_no_binding,
-         updated_at = excluded.updated_at`
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
     ).run(
       installationId,
       tenantId,
@@ -2875,7 +2892,7 @@ CREATE TABLE IF NOT EXISTS lt_a2a_api_keys (
   key_value TEXT NOT NULL,
   tenant_id TEXT NOT NULL,
   project_id TEXT,
-  workspace_id TEXT,
+  assistant_ids TEXT,
   label TEXT,
   enabled INTEGER NOT NULL DEFAULT 1,
   created_at TEXT NOT NULL,
@@ -2885,10 +2902,41 @@ CREATE TABLE IF NOT EXISTS lt_a2a_api_keys (
 function generateApiKey() {
   return `a2a_${randomUUID3().replace(/-/g, "")}`;
 }
+function parseAssistantIds(raw) {
+  if (!raw) return void 0;
+  try {
+    const parsed = JSON.parse(raw);
+    return Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
 var LocalA2AApiKeyStore = class {
   constructor(db) {
     this.db = db;
     ensureTable(db, DDL16);
+    this.ensureColumn("lt_a2a_api_keys", "assistant_ids", "assistant_ids TEXT");
+    this.repairManagementIds();
+  }
+  /** Add a column if it does not exist (SQLite version compatible). */
+  ensureColumn(table, column, ddl) {
+    const cols = this.db.prepare(`PRAGMA table_info(${table})`).all();
+    if (!cols.some((c) => c.name === column)) {
+      this.db.exec(`ALTER TABLE ${table} ADD COLUMN ${ddl}`);
+    }
+  }
+  repairManagementIds() {
+    const rows = this.db.prepare(
+      `SELECT rowid, id FROM lt_a2a_api_keys`
+    ).all();
+    const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    for (const row of rows) {
+      if (!row.id || !uuidPattern.test(row.id)) {
+        this.db.prepare(
+          `UPDATE lt_a2a_api_keys SET id = ? WHERE rowid = ?`
+        ).run(randomUUID3(), row.rowid);
+      }
+    }
   }
   async findByKey(key) {
     const rows = this.db.prepare(
@@ -2902,6 +2950,12 @@ var LocalA2AApiKeyStore = class {
     }
     return null;
   }
+  async findById(id) {
+    const row = this.db.prepare(
+      `SELECT * FROM lt_a2a_api_keys WHERE id = ?`
+    ).get(id);
+    return row ? mapRowToRecord(row) : null;
+  }
   async list(params) {
     const limit = params.limit || 100;
     const offset = params.offset || 0;
@@ -2918,19 +2972,19 @@ var LocalA2AApiKeyStore = class {
     return rows.map(mapRowToRecord);
   }
   async create(input) {
+    const id = randomUUID3();
     const key = generateApiKey();
     const now = nowISO();
     this.db.prepare(
-      `INSERT INTO lt_a2a_api_keys (key_value, tenant_id, project_id, workspace_id, label, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?)`
-    ).run(encrypt3(key), input.tenantId, input.projectId || null, input.workspaceId || null, input.label || null, now, now);
-    const lastId = this.db.prepare(`SELECT last_insert_rowid() as id`).get();
+      `INSERT INTO lt_a2a_api_keys (id, key_value, tenant_id, project_id, assistant_ids, label, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`
+    ).run(id, encrypt3(key), input.tenantId, input.projectId, input.assistantIds ? JSON.stringify(input.assistantIds) : null, input.label || null, now, now);
     const record = {
-      id: String(lastId.id),
+      id,
       key,
       tenantId: input.tenantId,
       projectId: input.projectId,
-      workspaceId: input.workspaceId,
+      assistantIds: input.assistantIds,
       label: input.label,
       enabled: true,
       createdAt: parseISO(now),
@@ -2982,8 +3036,8 @@ var LocalA2AApiKeyStore = class {
         map.set(key, {
           key,
           tenantId: row.tenant_id,
-          projectId: row.project_id || void 0,
-          workspaceId: row.workspace_id || void 0
+          projectId: row.project_id,
+          assistantIds: parseAssistantIds(row.assistant_ids)
         });
       } catch {
       }
@@ -3002,8 +3056,8 @@ function mapRowToRecord(row) {
     id: row.id,
     key,
     tenantId: row.tenant_id,
-    projectId: row.project_id || void 0,
-    workspaceId: row.workspace_id || void 0,
+    projectId: row.project_id,
+    assistantIds: parseAssistantIds(row.assistant_ids),
     label: row.label || void 0,
     enabled: row.enabled === 1,
     createdAt: parseISO(row.created_at),
@@ -3652,6 +3706,12 @@ function mapRowToTask(row) {
 
 // src/stores/LocalTaskStore.ts
 import { randomUUID as randomUUID5 } from "crypto";
+var MAX_CANONICAL_TASK_TIME = "9999-12-31T23:59:59.999Z";
+var NEXT_UPDATED_AT_SQL = `updated_at = CASE
+  WHEN strftime('%Y-%m-%dT%H:%M:%fZ', updated_at) = updated_at AND updated_at >= ?
+    THEN strftime('%Y-%m-%dT%H:%M:%fZ', updated_at, '+0.001 seconds')
+  ELSE ?
+END`;
 var DDL20 = `
 CREATE TABLE IF NOT EXISTS lt_tasks (
   id TEXT NOT NULL,
@@ -3715,6 +3775,10 @@ function mapRowToTask2(row) {
     updatedAt: parseISO(row.updated_at)
   };
 }
+function nextISO(previous) {
+  const previousMs = new Date(previous).getTime();
+  return new Date(Math.max(Date.now(), previousMs + 1)).toISOString();
+}
 var LocalTaskStore = class {
   constructor(db) {
     this.db = db;
@@ -3735,7 +3799,7 @@ var LocalTaskStore = class {
     }
   }
   async create(params) {
-    const id = randomUUID5();
+    const id = params.id ?? randomUUID5();
     const now = nowISO();
     this.db.prepare(
       `INSERT INTO lt_tasks (id, tenant_id, owner_type, owner_id, title, description, status, priority, due_date, metadata, parent_id, source_id, context, require_review, dependencies, result, failure_reason, workspace_id, project_id, files, created_at, updated_at)
@@ -3836,8 +3900,8 @@ var LocalTaskStore = class {
     const existing = await this.getById(tenantId, id);
     if (!existing) return null;
     const now = nowISO();
-    const setClauses = ["updated_at = ?"];
-    const values = [now];
+    const setClauses = [NEXT_UPDATED_AT_SQL];
+    const values = [now, now];
     if (updates.title !== void 0) {
       setClauses.push("title = ?");
       values.push(updates.title);
@@ -3872,7 +3936,7 @@ var LocalTaskStore = class {
     }
     if (updates.context !== void 0) {
       setClauses.push("context = ?");
-      values.push(JSON.stringify(updates.context));
+      values.push(updates.context === null ? null : JSON.stringify(updates.context));
     }
     if (updates.ownerType !== void 0) {
       setClauses.push("owner_type = ?");
@@ -3911,10 +3975,369 @@ var LocalTaskStore = class {
       values.push(JSON.stringify(updates.files));
     }
     if (setClauses.length === 1) return existing;
-    values.push(tenantId, id);
-    this.db.prepare(
-      `UPDATE lt_tasks SET ${setClauses.join(", ")} WHERE tenant_id = ? AND id = ?`
+    values.push(tenantId, id, MAX_CANONICAL_TASK_TIME);
+    const result = this.db.prepare(
+      `UPDATE lt_tasks SET ${setClauses.join(", ")} WHERE tenant_id = ? AND id = ? AND updated_at <> ?`
+    ).run(...values);
+    if (result.changes === 0) return null;
+    return this.getById(tenantId, id);
+  }
+  /**
+   * Atomically update a task unless its current status is blocked.
+   *
+   * @param tenantId Tenant identifier.
+   * @param id Task identifier.
+   * @param updates Partial task data to update.
+   * @param blockedStatuses Current statuses that prevent the update.
+   * @returns The updated task, or `null` when missing or blocked.
+   */
+  async updateIfStatusNotIn(tenantId, id, updates, blockedStatuses) {
+    const now = nowISO();
+    const setClauses = [NEXT_UPDATED_AT_SQL];
+    const values = [now, now];
+    if (updates.title !== void 0) {
+      setClauses.push("title = ?");
+      values.push(updates.title);
+    }
+    if (updates.description !== void 0) {
+      setClauses.push("description = ?");
+      values.push(updates.description);
+    }
+    if (updates.status !== void 0) {
+      setClauses.push("status = ?");
+      values.push(updates.status);
+    }
+    if (updates.priority !== void 0) {
+      setClauses.push("priority = ?");
+      values.push(updates.priority);
+    }
+    if (updates.dueDate !== void 0) {
+      setClauses.push("due_date = ?");
+      values.push(updates.dueDate);
+    }
+    if (updates.metadata !== void 0) {
+      setClauses.push("metadata = ?");
+      values.push(JSON.stringify(updates.metadata));
+    }
+    if (updates.parentId !== void 0) {
+      setClauses.push("parent_id = ?");
+      values.push(updates.parentId);
+    }
+    if (updates.sourceId !== void 0) {
+      setClauses.push("source_id = ?");
+      values.push(updates.sourceId);
+    }
+    if (updates.context !== void 0) {
+      setClauses.push("context = ?");
+      values.push(updates.context === null ? null : JSON.stringify(updates.context));
+    }
+    if (updates.ownerType !== void 0) {
+      setClauses.push("owner_type = ?");
+      values.push(updates.ownerType);
+    }
+    if (updates.ownerId !== void 0) {
+      setClauses.push("owner_id = ?");
+      values.push(updates.ownerId);
+    }
+    if (updates.requireReview !== void 0) {
+      setClauses.push("require_review = ?");
+      values.push(updates.requireReview ? 1 : 0);
+    }
+    if (updates.dependencies !== void 0) {
+      setClauses.push("dependencies = ?");
+      values.push(JSON.stringify(updates.dependencies));
+    }
+    if (updates.result !== void 0) {
+      setClauses.push("result = ?");
+      values.push(updates.result);
+    }
+    if (updates.failureReason !== void 0) {
+      setClauses.push("failure_reason = ?");
+      values.push(updates.failureReason);
+    }
+    if (updates.workspaceId !== void 0) {
+      setClauses.push("workspace_id = ?");
+      values.push(updates.workspaceId);
+    }
+    if (updates.projectId !== void 0) {
+      setClauses.push("project_id = ?");
+      values.push(updates.projectId);
+    }
+    if (updates.files !== void 0) {
+      setClauses.push("files = ?");
+      values.push(JSON.stringify(updates.files));
+    }
+    const statusClause = blockedStatuses.length > 0 ? ` AND status NOT IN (${blockedStatuses.map(() => "?").join(", ")})` : "";
+    values.push(tenantId, id, MAX_CANONICAL_TASK_TIME, ...blockedStatuses);
+    const result = this.db.prepare(
+      `UPDATE lt_tasks SET ${setClauses.join(", ")} WHERE tenant_id = ? AND id = ? AND updated_at <> ?${statusClause}`
+    ).run(...values);
+    if (result.changes === 0) return null;
+    return this.getById(tenantId, id);
+  }
+  /** Atomically update a task only when its current status is expected. */
+  async updateIfStatusIn(tenantId, id, updates, expectedStatuses) {
+    if (expectedStatuses.length === 0) return null;
+    const now = nowISO();
+    const setClauses = [NEXT_UPDATED_AT_SQL];
+    const values = [now, now];
+    if (updates.title !== void 0) {
+      setClauses.push("title = ?");
+      values.push(updates.title);
+    }
+    if (updates.description !== void 0) {
+      setClauses.push("description = ?");
+      values.push(updates.description);
+    }
+    if (updates.status !== void 0) {
+      setClauses.push("status = ?");
+      values.push(updates.status);
+    }
+    if (updates.priority !== void 0) {
+      setClauses.push("priority = ?");
+      values.push(updates.priority);
+    }
+    if (updates.dueDate !== void 0) {
+      setClauses.push("due_date = ?");
+      values.push(updates.dueDate);
+    }
+    if (updates.metadata !== void 0) {
+      setClauses.push("metadata = ?");
+      values.push(JSON.stringify(updates.metadata));
+    }
+    if (updates.parentId !== void 0) {
+      setClauses.push("parent_id = ?");
+      values.push(updates.parentId);
+    }
+    if (updates.sourceId !== void 0) {
+      setClauses.push("source_id = ?");
+      values.push(updates.sourceId);
+    }
+    if (updates.context !== void 0) {
+      setClauses.push("context = ?");
+      values.push(updates.context === null ? null : JSON.stringify(updates.context));
+    }
+    if (updates.ownerType !== void 0) {
+      setClauses.push("owner_type = ?");
+      values.push(updates.ownerType);
+    }
+    if (updates.ownerId !== void 0) {
+      setClauses.push("owner_id = ?");
+      values.push(updates.ownerId);
+    }
+    if (updates.requireReview !== void 0) {
+      setClauses.push("require_review = ?");
+      values.push(updates.requireReview ? 1 : 0);
+    }
+    if (updates.dependencies !== void 0) {
+      setClauses.push("dependencies = ?");
+      values.push(JSON.stringify(updates.dependencies));
+    }
+    if (updates.result !== void 0) {
+      setClauses.push("result = ?");
+      values.push(updates.result);
+    }
+    if (updates.failureReason !== void 0) {
+      setClauses.push("failure_reason = ?");
+      values.push(updates.failureReason);
+    }
+    if (updates.workspaceId !== void 0) {
+      setClauses.push("workspace_id = ?");
+      values.push(updates.workspaceId);
+    }
+    if (updates.projectId !== void 0) {
+      setClauses.push("project_id = ?");
+      values.push(updates.projectId);
+    }
+    if (updates.files !== void 0) {
+      setClauses.push("files = ?");
+      values.push(JSON.stringify(updates.files));
+    }
+    values.push(tenantId, id, MAX_CANONICAL_TASK_TIME, ...expectedStatuses);
+    const result = this.db.prepare(
+      `UPDATE lt_tasks SET ${setClauses.join(", ")} WHERE tenant_id = ? AND id = ? AND updated_at <> ? AND status IN (${expectedStatuses.map(() => "?").join(", ")})`
+    ).run(...values);
+    if (result.changes === 0) return null;
+    return this.getById(tenantId, id);
+  }
+  /** Atomically update a task only when status and updatedAt match a read snapshot. */
+  async updateIfStatusAndUpdatedAt(tenantId, id, updates, expectedStatuses, expectedUpdatedAt) {
+    if (expectedStatuses.length === 0) return null;
+    const expectedIso = new Date(expectedUpdatedAt).toISOString();
+    if (expectedIso === MAX_CANONICAL_TASK_TIME) return null;
+    const setClauses = ["updated_at = ?"];
+    const values = [nextISO(expectedIso)];
+    if (updates.title !== void 0) {
+      setClauses.push("title = ?");
+      values.push(updates.title);
+    }
+    if (updates.description !== void 0) {
+      setClauses.push("description = ?");
+      values.push(updates.description);
+    }
+    if (updates.status !== void 0) {
+      setClauses.push("status = ?");
+      values.push(updates.status);
+    }
+    if (updates.priority !== void 0) {
+      setClauses.push("priority = ?");
+      values.push(updates.priority);
+    }
+    if (updates.dueDate !== void 0) {
+      setClauses.push("due_date = ?");
+      values.push(updates.dueDate);
+    }
+    if (updates.metadata !== void 0) {
+      setClauses.push("metadata = ?");
+      values.push(JSON.stringify(updates.metadata));
+    }
+    if (updates.parentId !== void 0) {
+      setClauses.push("parent_id = ?");
+      values.push(updates.parentId);
+    }
+    if (updates.sourceId !== void 0) {
+      setClauses.push("source_id = ?");
+      values.push(updates.sourceId);
+    }
+    if (updates.context !== void 0) {
+      setClauses.push("context = ?");
+      values.push(updates.context === null ? null : JSON.stringify(updates.context));
+    }
+    if (updates.ownerType !== void 0) {
+      setClauses.push("owner_type = ?");
+      values.push(updates.ownerType);
+    }
+    if (updates.ownerId !== void 0) {
+      setClauses.push("owner_id = ?");
+      values.push(updates.ownerId);
+    }
+    if (updates.requireReview !== void 0) {
+      setClauses.push("require_review = ?");
+      values.push(updates.requireReview ? 1 : 0);
+    }
+    if (updates.dependencies !== void 0) {
+      setClauses.push("dependencies = ?");
+      values.push(JSON.stringify(updates.dependencies));
+    }
+    if (updates.result !== void 0) {
+      setClauses.push("result = ?");
+      values.push(updates.result);
+    }
+    if (updates.failureReason !== void 0) {
+      setClauses.push("failure_reason = ?");
+      values.push(updates.failureReason);
+    }
+    if (updates.workspaceId !== void 0) {
+      setClauses.push("workspace_id = ?");
+      values.push(updates.workspaceId);
+    }
+    if (updates.projectId !== void 0) {
+      setClauses.push("project_id = ?");
+      values.push(updates.projectId);
+    }
+    if (updates.files !== void 0) {
+      setClauses.push("files = ?");
+      values.push(JSON.stringify(updates.files));
+    }
+    values.push(tenantId, id, ...expectedStatuses, expectedIso);
+    const result = this.db.prepare(
+      `UPDATE lt_tasks SET ${setClauses.join(", ")} WHERE tenant_id = ? AND id = ? AND status IN (${expectedStatuses.map(() => "?").join(", ")}) AND updated_at = ?`
+    ).run(...values);
+    if (result.changes === 0) return null;
+    return this.getById(tenantId, id);
+  }
+  /** Atomically update a child only when both child and parent snapshots match. */
+  async updateIfStatusUpdatedAtAndParentUpdatedAt(tenantId, id, updates, expectedStatuses, expectedUpdatedAt, parentId, expectedParentUpdatedAt) {
+    if (expectedStatuses.length === 0) return null;
+    const expectedIso = new Date(expectedUpdatedAt).toISOString();
+    if (expectedIso === MAX_CANONICAL_TASK_TIME) return null;
+    const parentExpectedIso = new Date(expectedParentUpdatedAt).toISOString();
+    const setClauses = ["updated_at = ?"];
+    const values = [nextISO(expectedIso)];
+    if (updates.title !== void 0) {
+      setClauses.push("title = ?");
+      values.push(updates.title);
+    }
+    if (updates.description !== void 0) {
+      setClauses.push("description = ?");
+      values.push(updates.description);
+    }
+    if (updates.status !== void 0) {
+      setClauses.push("status = ?");
+      values.push(updates.status);
+    }
+    if (updates.priority !== void 0) {
+      setClauses.push("priority = ?");
+      values.push(updates.priority);
+    }
+    if (updates.dueDate !== void 0) {
+      setClauses.push("due_date = ?");
+      values.push(updates.dueDate);
+    }
+    if (updates.metadata !== void 0) {
+      setClauses.push("metadata = ?");
+      values.push(JSON.stringify(updates.metadata));
+    }
+    if (updates.parentId !== void 0) {
+      setClauses.push("parent_id = ?");
+      values.push(updates.parentId);
+    }
+    if (updates.sourceId !== void 0) {
+      setClauses.push("source_id = ?");
+      values.push(updates.sourceId);
+    }
+    if (updates.context !== void 0) {
+      setClauses.push("context = ?");
+      values.push(updates.context === null ? null : JSON.stringify(updates.context));
+    }
+    if (updates.ownerType !== void 0) {
+      setClauses.push("owner_type = ?");
+      values.push(updates.ownerType);
+    }
+    if (updates.ownerId !== void 0) {
+      setClauses.push("owner_id = ?");
+      values.push(updates.ownerId);
+    }
+    if (updates.requireReview !== void 0) {
+      setClauses.push("require_review = ?");
+      values.push(updates.requireReview ? 1 : 0);
+    }
+    if (updates.dependencies !== void 0) {
+      setClauses.push("dependencies = ?");
+      values.push(JSON.stringify(updates.dependencies));
+    }
+    if (updates.result !== void 0) {
+      setClauses.push("result = ?");
+      values.push(updates.result);
+    }
+    if (updates.failureReason !== void 0) {
+      setClauses.push("failure_reason = ?");
+      values.push(updates.failureReason);
+    }
+    if (updates.workspaceId !== void 0) {
+      setClauses.push("workspace_id = ?");
+      values.push(updates.workspaceId);
+    }
+    if (updates.projectId !== void 0) {
+      setClauses.push("project_id = ?");
+      values.push(updates.projectId);
+    }
+    if (updates.files !== void 0) {
+      setClauses.push("files = ?");
+      values.push(JSON.stringify(updates.files));
+    }
+    values.push(tenantId, id, ...expectedStatuses, expectedIso, parentId, parentExpectedIso);
+    const result = this.db.prepare(
+      `UPDATE lt_tasks AS child SET ${setClauses.join(", ")}
+       WHERE tenant_id = ? AND id = ?
+         AND status IN (${expectedStatuses.map(() => "?").join(", ")})
+         AND updated_at = ?
+         AND EXISTS (
+           SELECT 1 FROM lt_tasks AS parent
+           WHERE parent.tenant_id = child.tenant_id AND parent.id = ? AND parent.updated_at = ?
+         )`
     ).run(...values);
+    if (result.changes === 0) return null;
     return this.getById(tenantId, id);
   }
   async delete(tenantId, id) {
@@ -3957,6 +4380,7 @@ function mapRowToWorkItem(row) {
     attempt: row.attempt ?? void 0,
     workspaceId: row.workspace_id ?? void 0,
     projectId: row.project_id ?? void 0,
+    eventKey: row.event_key ?? void 0,
     createdAt: parseISO(row.created_at)
   };
 }
@@ -3964,8 +4388,18 @@ var LocalTaskWorkItemStore = class {
   constructor(db) {
     this.db = db;
     ensureTable(db, DDL21);
-    this.db.exec(`ALTER TABLE lt_task_work_items ADD COLUMN workspace_id TEXT;`);
-    this.db.exec(`ALTER TABLE lt_task_work_items ADD COLUMN project_id TEXT;`);
+    this.ensureColumn("lt_task_work_items", "workspace_id", "workspace_id TEXT");
+    this.ensureColumn("lt_task_work_items", "project_id", "project_id TEXT");
+    this.ensureColumn("lt_task_work_items", "event_key", "event_key TEXT");
+    this.db.exec(`CREATE UNIQUE INDEX IF NOT EXISTS idx_task_work_items_event_key
+      ON lt_task_work_items (tenant_id, task_id, event_key);`);
+  }
+  /** Add a column if it does not exist (SQLite version compatible). */
+  ensureColumn(table, column, ddl) {
+    const cols = this.db.prepare(`PRAGMA table_info(${table})`).all();
+    if (!cols.some((c) => c.name === column)) {
+      this.db.exec(`ALTER TABLE ${table} ADD COLUMN ${ddl}`);
+    }
   }
   async create(params) {
     const id = uuid2();
@@ -3992,6 +4426,39 @@ var LocalTaskWorkItemStore = class {
     ).get(params.tenantId, id);
     return mapRowToWorkItem(row);
   }
+  /** Find an event by its tenant- and task-scoped key without pagination. */
+  async findByEventKey(tenantId, taskId, eventKey) {
+    const row = this.db.prepare(
+      `SELECT * FROM lt_task_work_items WHERE tenant_id = ? AND task_id = ? AND event_key = ?`
+    ).get(tenantId, taskId, eventKey);
+    return row ? mapRowToWorkItem(row) : null;
+  }
+  /** Atomically return an existing event or create it once. */
+  async createIfAbsentByEventKey(params) {
+    const id = uuid2();
+    this.db.prepare(
+      `INSERT INTO lt_task_work_items (id, tenant_id, task_id, action, actor, thread_id, summary, detail, attempt, workspace_id, project_id, event_key, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT (tenant_id, task_id, event_key) DO NOTHING`
+    ).run(
+      id,
+      params.tenantId,
+      params.taskId,
+      params.action,
+      params.actor,
+      params.threadId || null,
+      params.summary || null,
+      params.detail ? JSON.stringify(params.detail) : null,
+      params.attempt ?? null,
+      params.workspaceId || null,
+      params.projectId || null,
+      params.eventKey,
+      nowISO()
+    );
+    const item = await this.findByEventKey(params.tenantId, params.taskId, params.eventKey);
+    if (!item) throw new Error("Task work item insert did not return a row");
+    return item;
+  }
   async list(filter) {
     const conditions = ["tenant_id = ?", "task_id = ?"];
     const params = [filter.tenantId, filter.taskId];
@@ -3999,11 +4466,20 @@ var LocalTaskWorkItemStore = class {
       conditions.push("action = ?");
       params.push(filter.action);
     }
+    if (filter.workspaceId) {
+      conditions.push("workspace_id = ?");
+      params.push(filter.workspaceId);
+    }
+    if (filter.projectId) {
+      conditions.push("project_id = ?");
+      params.push(filter.projectId);
+    }
     const where = conditions.join(" AND ");
     const limit = filter.limit || 100;
     const offset = filter.offset || 0;
+    const order = filter.order === "asc" ? "ASC" : "DESC";
     const rows = this.db.prepare(
-      `SELECT * FROM lt_task_work_items WHERE ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`
+      `SELECT * FROM lt_task_work_items WHERE ${where} ORDER BY created_at ${order}, id ${order} LIMIT ? OFFSET ?`
     ).all(...params, limit, offset);
     return rows.map(mapRowToWorkItem);
   }