@elizaos/plugin-personal-assistant 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/lifeops/work-threads/field-evaluator-thread-ops.js

@@ -0,0 +1,226 @@
+import { hasOwnerAccess } from "@elizaos/agent";
+import { resolvePendingPromptsStore } from "../pending-prompts/store.js";
+import { createWorkThreadStore } from "./store.js";
+const THREAD_OPS_DESCRIPTION = `Thread operations for user's durable work threads.
+
+Use for:
+- long task start -> { "type": "create", "instruction": "<what to do>" }
+- correct/refocus thread -> { "type": "steer", "workThreadId": "<id>", "instruction": "<correction>" }
+- cancel/stop/abort current work -> { "type": "abort", "workThreadId": "<id if known>", "reason": "<short why>" }
+- pause waiting input -> { "type": "mark_waiting", "workThreadId": "<id>" }
+- mark complete -> { "type": "mark_completed", "workThreadId": "<id>" }
+- merge threads -> { "type": "merge", "workThreadId": "<TARGET id>", "sourceWorkThreadIds": ["<id1>", "<id2>"] }
+- attach this room/source -> { "type": "attach_source", "workThreadId": "<id>", "sourceRef": { "connector": "...", "roomId": "...", "canMutate": true } }
+- schedule follow-up -> { "type": "schedule_followup", "workThreadId": "<id>", "instruction": "<what to do later>" }
+
+abort preempts turn: stop in-flight work, emit short ack. Use when user clearly retracts current request ("nvm", "stop", "actually don't", "wait don't do that").
+
+Empty array when no thread intent. Do not invent threads; only use active workThreadId values listed elsewhere in prompt.`;
+const THREAD_OP_TYPE_ENUM = [
+  "create",
+  "steer",
+  "stop",
+  "merge",
+  "attach_source",
+  "schedule_followup",
+  "mark_waiting",
+  "mark_completed",
+  "abort"
+];
+const THREAD_OPS_SCHEMA = {
+  type: "array",
+  description: "Thread operations this turn. Empty array when no thread action.",
+  items: {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      type: {
+        type: "string",
+        enum: [...THREAD_OP_TYPE_ENUM],
+        description: "Operation type. 'abort' preempts turn; others stage mutations for lifeops_thread_control."
+      },
+      workThreadId: {
+        type: ["string", "null"],
+        description: "Target thread id. Required for steer/stop/merge/attach_source/schedule_followup/mark_*; optional for abort (current turn) and create."
+      },
+      sourceWorkThreadIds: {
+        type: "array",
+        description: "merge: source thread ids absorbed into workThreadId. Empty otherwise.",
+        items: { type: "string" }
+      },
+      sourceRef: {
+        type: ["object", "null"],
+        additionalProperties: false,
+        properties: {
+          connector: { type: "string" },
+          channelName: { type: ["string", "null"] },
+          channelKind: { type: ["string", "null"] },
+          roomId: { type: ["string", "null"] },
+          externalThreadId: { type: ["string", "null"] },
+          accountId: { type: ["string", "null"] },
+          grantId: { type: ["string", "null"] },
+          canRead: { type: ["boolean", "null"] },
+          canMutate: { type: ["boolean", "null"] }
+        },
+        required: [
+          "connector",
+          "channelName",
+          "channelKind",
+          "roomId",
+          "externalThreadId",
+          "accountId",
+          "grantId",
+          "canRead",
+          "canMutate"
+        ],
+        description: "For attach_source: the source ref to attach."
+      },
+      instruction: {
+        type: ["string", "null"],
+        description: "What to do for create/steer/schedule_followup. Brief, action-oriented."
+      },
+      reason: {
+        type: ["string", "null"],
+        description: "Why this op (especially useful for abort and stop)."
+      }
+    },
+    required: [
+      "type",
+      "workThreadId",
+      "sourceWorkThreadIds",
+      "sourceRef",
+      "instruction",
+      "reason"
+    ]
+  }
+};
+async function threadOpsShouldRun(ctx) {
+  if (!await hasOwnerAccess(ctx.runtime, ctx.message)) {
+    return false;
+  }
+  const roomId = typeof ctx.message.roomId === "string" ? ctx.message.roomId : null;
+  if (!roomId) return false;
+  const [threads, prompts] = await Promise.all([
+    createWorkThreadStore(ctx.runtime).list({
+      statuses: ["active", "waiting", "paused"],
+      roomId,
+      limit: 1
+    }),
+    resolvePendingPromptsStore(ctx.runtime).list(roomId, {
+      lookbackMinutes: 60 * 24
+    })
+  ]);
+  if (threads.length > 0 || prompts.length > 0) return true;
+  return ctx.runtime.turnControllers.hasActiveTurn(roomId);
+}
+function threadOpsParse(value, _ctx) {
+  if (!Array.isArray(value)) return [];
+  const ops = [];
+  for (const raw of value) {
+    if (!raw || typeof raw !== "object") continue;
+    const r = raw;
+    const type = String(r.type ?? "").trim();
+    if (!THREAD_OP_TYPE_ENUM.includes(type)) continue;
+    const op = {
+      type
+    };
+    if (typeof r.workThreadId === "string" && r.workThreadId.length > 0) {
+      op.workThreadId = r.workThreadId;
+    }
+    if (Array.isArray(r.sourceWorkThreadIds)) {
+      op.sourceWorkThreadIds = r.sourceWorkThreadIds.map((id) => String(id ?? "").trim()).filter((id) => id.length > 0);
+    }
+    if (r.sourceRef && typeof r.sourceRef === "object") {
+      const ref = r.sourceRef;
+      if (typeof ref.connector === "string") {
+        op.sourceRef = {
+          connector: ref.connector,
+          channelName: typeof ref.channelName === "string" ? ref.channelName : void 0,
+          channelKind: typeof ref.channelKind === "string" ? ref.channelKind : void 0,
+          roomId: typeof ref.roomId === "string" ? ref.roomId : void 0,
+          externalThreadId: typeof ref.externalThreadId === "string" ? ref.externalThreadId : void 0,
+          accountId: typeof ref.accountId === "string" ? ref.accountId : void 0,
+          grantId: typeof ref.grantId === "string" ? ref.grantId : void 0,
+          canRead: typeof ref.canRead === "boolean" ? ref.canRead : void 0,
+          canMutate: typeof ref.canMutate === "boolean" ? ref.canMutate : void 0
+        };
+      }
+    }
+    if (typeof r.instruction === "string" && r.instruction.length > 0) {
+      op.instruction = r.instruction;
+    }
+    if (typeof r.reason === "string" && r.reason.length > 0) {
+      op.reason = r.reason;
+    }
+    ops.push(op);
+  }
+  return ops;
+}
+async function threadOpsHandle(ctx) {
+  const ops = ctx.value;
+  if (!Array.isArray(ops) || ops.length === 0) return void 0;
+  const debug = [];
+  const abortOp = ops.find((op) => op.type === "abort");
+  if (abortOp) {
+    const roomId = typeof ctx.message.roomId === "string" ? ctx.message.roomId : "";
+    const reason = typeof abortOp.reason === "string" && abortOp.reason.length > 0 ? abortOp.reason : "user_requested_abort";
+    let aborted = false;
+    if (roomId && ctx.runtime.turnControllers.abortTurn) {
+      aborted = ctx.runtime.turnControllers.abortTurn(roomId, reason);
+    }
+    debug.push(
+      `abort: room=${roomId || "<none>"} aborted=${aborted ? "yes" : "no"} reason=${reason}`
+    );
+    return {
+      mutateResult: (result) => {
+        if (!result.replyText || result.replyText.length === 0) {
+          result.replyText = "Stopped \u2014 partial work preserved.";
+        }
+        result.shouldRespond = "RESPOND";
+        if (!Array.isArray(result.contexts)) result.contexts = [];
+        if (!result.contexts.includes("simple")) {
+          result.contexts = [...result.contexts, "simple"];
+        }
+      },
+      preempt: { mode: "ack-and-stop", reason },
+      debug
+    };
+  }
+  debug.push(
+    `staged ${ops.length} thread op(s): ${ops.map((o) => o.type).join(",")}`
+  );
+  return {
+    mutateResult: (result) => {
+      if (!Array.isArray(result.candidateActionNames)) {
+        result.candidateActionNames = [];
+      }
+      for (const name of ["work_thread", "WORK_THREAD"]) {
+        if (!result.candidateActionNames.includes(name)) {
+          result.candidateActionNames.push(name);
+        }
+      }
+      if (!Array.isArray(result.contexts)) result.contexts = [];
+      for (const ctxName of ["tasks", "messaging", "automation"]) {
+        if (!result.contexts.includes(ctxName)) {
+          result.contexts.push(ctxName);
+        }
+      }
+      result.contexts = result.contexts.filter((c) => c !== "simple");
+    },
+    debug
+  };
+}
+const threadOpsFieldEvaluator = {
+  name: "threadOps",
+  description: THREAD_OPS_DESCRIPTION,
+  priority: 30,
+  // Runs before contexts/candidateActions can be finalized.
+  schema: THREAD_OPS_SCHEMA,
+  shouldRun: threadOpsShouldRun,
+  parse: threadOpsParse,
+  handle: threadOpsHandle
+};
+export {
+  threadOpsFieldEvaluator
+};
+//# sourceMappingURL=field-evaluator-thread-ops.js.map

package/dist/lifeops/work-threads/field-evaluator-thread-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/work-threads/field-evaluator-thread-ops.ts"],"sourcesContent":["/**\n * `threadOps` — response-handler field evaluator owned by app-lifeops.\n *\n * Contributes a typed schema fragment to the SAME Stage-1 LLM call the\n * response handler is already making. The LLM extracts the thread operations\n * from context — no post-parse regex router.\n *\n * The abort intent (\"stop\", \"nvm\", \"actually wait don't do that\") lives as\n * one operation type within threadOps. When the LLM emits\n * `{ threadOps: [{ type: \"abort\", ... }] }`, this evaluator's handler:\n *\n *   1. Calls `runtime.abortTurn(roomId, reason)` synchronously — propagates\n *      through the turn's AbortSignal tree.\n *   2. Returns an `ack-and-stop` preempt — the response handler emits a\n *      short acknowledgement reply and does NOT route to the planner.\n *\n * For all non-abort ops, the handler stages them as a dispatch payload that\n * the existing `lifeops_thread_control` action handler consumes (no need to\n * duplicate the validation / locking / atomic-merge logic).\n */\n\nimport { hasOwnerAccess } from \"@elizaos/agent\";\nimport type {\n  ResponseHandlerFieldContext,\n  ResponseHandlerFieldEffect,\n  ResponseHandlerFieldEvaluator,\n  ResponseHandlerFieldHandleContext,\n} from \"@elizaos/core\";\nimport { resolvePendingPromptsStore } from \"../pending-prompts/store.js\";\nimport { createWorkThreadStore } from \"./store.js\";\nimport type { ThreadSourceRef } from \"./types.js\";\n\n// ---------------------------------------------------------------------------\n// Op shapes — these become the runtime types after parse\n// ---------------------------------------------------------------------------\n\nexport type ThreadOpType =\n  | \"create\"\n  | \"steer\"\n  | \"stop\"\n  | \"merge\"\n  | \"attach_source\"\n  | \"schedule_followup\"\n  | \"mark_waiting\"\n  | \"mark_completed\"\n  | \"abort\";\n\nexport interface ThreadOp {\n  type: ThreadOpType;\n  workThreadId?: string | null;\n  sourceWorkThreadIds?: string[];\n  sourceRef?: ThreadSourceRef;\n  instruction?: string | null;\n  reason?: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// Description — used verbatim as the LLM's prompt slice\n// ---------------------------------------------------------------------------\n\nconst THREAD_OPS_DESCRIPTION = `Thread operations for user's durable work threads.\n\nUse for:\n- long task start -> { \"type\": \"create\", \"instruction\": \"<what to do>\" }\n- correct/refocus thread -> { \"type\": \"steer\", \"workThreadId\": \"<id>\", \"instruction\": \"<correction>\" }\n- cancel/stop/abort current work -> { \"type\": \"abort\", \"workThreadId\": \"<id if known>\", \"reason\": \"<short why>\" }\n- pause waiting input -> { \"type\": \"mark_waiting\", \"workThreadId\": \"<id>\" }\n- mark complete -> { \"type\": \"mark_completed\", \"workThreadId\": \"<id>\" }\n- merge threads -> { \"type\": \"merge\", \"workThreadId\": \"<TARGET id>\", \"sourceWorkThreadIds\": [\"<id1>\", \"<id2>\"] }\n- attach this room/source -> { \"type\": \"attach_source\", \"workThreadId\": \"<id>\", \"sourceRef\": { \"connector\": \"...\", \"roomId\": \"...\", \"canMutate\": true } }\n- schedule follow-up -> { \"type\": \"schedule_followup\", \"workThreadId\": \"<id>\", \"instruction\": \"<what to do later>\" }\n\nabort preempts turn: stop in-flight work, emit short ack. Use when user clearly retracts current request (\"nvm\", \"stop\", \"actually don't\", \"wait don't do that\").\n\nEmpty array when no thread intent. Do not invent threads; only use active workThreadId values listed elsewhere in prompt.`;\n\n// ---------------------------------------------------------------------------\n// JSON schema slice\n// ---------------------------------------------------------------------------\n\nconst THREAD_OP_TYPE_ENUM = [\n  \"create\",\n  \"steer\",\n  \"stop\",\n  \"merge\",\n  \"attach_source\",\n  \"schedule_followup\",\n  \"mark_waiting\",\n  \"mark_completed\",\n  \"abort\",\n];\n\n// Note: declared as JSONSchema (mutable) so it can be passed into the\n// registry's `register()` which expects `JSONSchema` not `Readonly<...>`.\nconst THREAD_OPS_SCHEMA: import(\"@elizaos/core\").JSONSchema = {\n  type: \"array\",\n  description:\n    \"Thread operations this turn. Empty array when no thread action.\",\n  items: {\n    type: \"object\",\n    additionalProperties: false,\n    properties: {\n      type: {\n        type: \"string\",\n        enum: [...THREAD_OP_TYPE_ENUM],\n        description:\n          \"Operation type. 'abort' preempts turn; others stage mutations for lifeops_thread_control.\",\n      },\n      workThreadId: {\n        type: [\"string\", \"null\"],\n        description:\n          \"Target thread id. Required for steer/stop/merge/attach_source/schedule_followup/mark_*; optional for abort (current turn) and create.\",\n      },\n      sourceWorkThreadIds: {\n        type: \"array\",\n        description:\n          \"merge: source thread ids absorbed into workThreadId. Empty otherwise.\",\n        items: { type: \"string\" },\n      },\n      sourceRef: {\n        type: [\"object\", \"null\"],\n        additionalProperties: false,\n        properties: {\n          connector: { type: \"string\" },\n          channelName: { type: [\"string\", \"null\"] },\n          channelKind: { type: [\"string\", \"null\"] },\n          roomId: { type: [\"string\", \"null\"] },\n          externalThreadId: { type: [\"string\", \"null\"] },\n          accountId: { type: [\"string\", \"null\"] },\n          grantId: { type: [\"string\", \"null\"] },\n          canRead: { type: [\"boolean\", \"null\"] },\n          canMutate: { type: [\"boolean\", \"null\"] },\n        },\n        required: [\n          \"connector\",\n          \"channelName\",\n          \"channelKind\",\n          \"roomId\",\n          \"externalThreadId\",\n          \"accountId\",\n          \"grantId\",\n          \"canRead\",\n          \"canMutate\",\n        ],\n        description: \"For attach_source: the source ref to attach.\",\n      },\n      instruction: {\n        type: [\"string\", \"null\"],\n        description:\n          \"What to do for create/steer/schedule_followup. Brief, action-oriented.\",\n      },\n      reason: {\n        type: [\"string\", \"null\"],\n        description: \"Why this op (especially useful for abort and stop).\",\n      },\n    },\n    required: [\n      \"type\",\n      \"workThreadId\",\n      \"sourceWorkThreadIds\",\n      \"sourceRef\",\n      \"instruction\",\n      \"reason\",\n    ],\n  },\n};\n\n// ---------------------------------------------------------------------------\n// shouldRun — only include this field's prompt slice when relevant\n// ---------------------------------------------------------------------------\n\nasync function threadOpsShouldRun(\n  ctx: ResponseHandlerFieldContext,\n): Promise<boolean> {\n  // Only owners can mutate threads.\n  if (!(await hasOwnerAccess(ctx.runtime, ctx.message))) {\n    return false;\n  }\n  const roomId =\n    typeof ctx.message.roomId === \"string\" ? ctx.message.roomId : null;\n  if (!roomId) return false;\n  // Cheap signal: any active thread in the room OR a pending prompt.\n  // Used purely to decide if the LLM should see the threadOps instructions.\n  // The actual decision-making happens in the LLM call.\n  const [threads, prompts] = await Promise.all([\n    createWorkThreadStore(ctx.runtime).list({\n      statuses: [\"active\", \"waiting\", \"paused\"],\n      roomId,\n      limit: 1,\n    }),\n    resolvePendingPromptsStore(ctx.runtime).list(roomId, {\n      lookbackMinutes: 60 * 24,\n    }),\n  ]);\n  if (threads.length > 0 || prompts.length > 0) return true;\n  // Even with no active threads, if the runtime has an active turn for this\n  // room (i.e., a prior handler is still running), the user may want to\n  // abort it. Include the field so abort can be extracted.\n  return ctx.runtime.turnControllers.hasActiveTurn(roomId);\n}\n\n// ---------------------------------------------------------------------------\n// parse — normalize the LLM's value\n// ---------------------------------------------------------------------------\n\nfunction threadOpsParse(\n  value: unknown,\n  _ctx: ResponseHandlerFieldContext,\n): ThreadOp[] | null {\n  if (!Array.isArray(value)) return [];\n  const ops: ThreadOp[] = [];\n  for (const raw of value) {\n    if (!raw || typeof raw !== \"object\") continue;\n    const r = raw as Record<string, unknown>;\n    const type = String(r.type ?? \"\").trim();\n    if (!THREAD_OP_TYPE_ENUM.includes(type)) continue;\n    const op: ThreadOp = {\n      type: type as ThreadOpType,\n    };\n    if (typeof r.workThreadId === \"string\" && r.workThreadId.length > 0) {\n      op.workThreadId = r.workThreadId;\n    }\n    if (Array.isArray(r.sourceWorkThreadIds)) {\n      op.sourceWorkThreadIds = r.sourceWorkThreadIds\n        .map((id) => String(id ?? \"\").trim())\n        .filter((id) => id.length > 0);\n    }\n    if (r.sourceRef && typeof r.sourceRef === \"object\") {\n      const ref = r.sourceRef as Record<string, unknown>;\n      if (typeof ref.connector === \"string\") {\n        op.sourceRef = {\n          connector: ref.connector,\n          channelName:\n            typeof ref.channelName === \"string\" ? ref.channelName : undefined,\n          channelKind:\n            typeof ref.channelKind === \"string\" ? ref.channelKind : undefined,\n          roomId: typeof ref.roomId === \"string\" ? ref.roomId : undefined,\n          externalThreadId:\n            typeof ref.externalThreadId === \"string\"\n              ? ref.externalThreadId\n              : undefined,\n          accountId:\n            typeof ref.accountId === \"string\" ? ref.accountId : undefined,\n          grantId: typeof ref.grantId === \"string\" ? ref.grantId : undefined,\n          canRead: typeof ref.canRead === \"boolean\" ? ref.canRead : undefined,\n          canMutate:\n            typeof ref.canMutate === \"boolean\" ? ref.canMutate : undefined,\n        };\n      }\n    }\n    if (typeof r.instruction === \"string\" && r.instruction.length > 0) {\n      op.instruction = r.instruction;\n    }\n    if (typeof r.reason === \"string\" && r.reason.length > 0) {\n      op.reason = r.reason;\n    }\n    ops.push(op);\n  }\n  return ops;\n}\n\n// ---------------------------------------------------------------------------\n// handle — run the ops\n// ---------------------------------------------------------------------------\n\nasync function threadOpsHandle(\n  ctx: ResponseHandlerFieldHandleContext<ThreadOp[]>,\n): Promise<ResponseHandlerFieldEffect | undefined> {\n  const ops = ctx.value;\n  if (!Array.isArray(ops) || ops.length === 0) return undefined;\n  const debug: string[] = [];\n\n  // Abort op runs FIRST and preempts the rest of the turn.\n  const abortOp = ops.find((op) => op.type === \"abort\");\n  if (abortOp) {\n    const roomId =\n      typeof ctx.message.roomId === \"string\" ? ctx.message.roomId : \"\";\n    const reason =\n      typeof abortOp.reason === \"string\" && abortOp.reason.length > 0\n        ? abortOp.reason\n        : \"user_requested_abort\";\n    let aborted = false;\n    if (roomId && ctx.runtime.turnControllers.abortTurn) {\n      aborted = ctx.runtime.turnControllers.abortTurn(roomId, reason);\n    }\n    debug.push(\n      `abort: room=${roomId || \"<none>\"} aborted=${aborted ? \"yes\" : \"no\"} reason=${reason}`,\n    );\n    // Stage a short ack reply. The preempt below ensures we skip planner.\n    return {\n      mutateResult: (result) => {\n        if (!result.replyText || result.replyText.length === 0) {\n          result.replyText = \"Stopped — partial work preserved.\";\n        }\n        result.shouldRespond = \"RESPOND\";\n        // Force a simple direct reply route.\n        if (!Array.isArray(result.contexts)) result.contexts = [];\n        if (!result.contexts.includes(\"simple\")) {\n          result.contexts = [...result.contexts, \"simple\"];\n        }\n      },\n      preempt: { mode: \"ack-and-stop\", reason },\n      debug,\n    };\n  }\n\n  // Non-abort ops: stage them on the result for the planner / action layer.\n  // The planner will see threadOps in the parsed result and dispatch via the\n  // existing lifeops_thread_control action.\n  debug.push(\n    `staged ${ops.length} thread op(s): ${ops.map((o) => o.type).join(\",\")}`,\n  );\n\n  return {\n    mutateResult: (result) => {\n      // Ensure we route via planner so lifeops_thread_control can run.\n      if (!Array.isArray(result.candidateActionNames)) {\n        result.candidateActionNames = [];\n      }\n      for (const name of [\"work_thread\", \"WORK_THREAD\"]) {\n        if (!result.candidateActionNames.includes(name)) {\n          result.candidateActionNames.push(name);\n        }\n      }\n      if (!Array.isArray(result.contexts)) result.contexts = [];\n      for (const ctxName of [\"tasks\", \"messaging\", \"automation\"]) {\n        if (!result.contexts.includes(ctxName)) {\n          result.contexts.push(ctxName);\n        }\n      }\n      // Drop \"simple\" if it was set — we need the planner.\n      result.contexts = result.contexts.filter((c) => c !== \"simple\");\n    },\n    debug,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Exported evaluator\n// ---------------------------------------------------------------------------\n\nexport const threadOpsFieldEvaluator: ResponseHandlerFieldEvaluator<\n  ThreadOp[]\n> = {\n  name: \"threadOps\",\n  description: THREAD_OPS_DESCRIPTION,\n  priority: 30, // Runs before contexts/candidateActions can be finalized.\n  schema: THREAD_OPS_SCHEMA,\n  shouldRun: threadOpsShouldRun,\n  parse: threadOpsParse,\n  handle: threadOpsHandle,\n};\n"],"mappings":"AAqBA,SAAS,sBAAsB;AAO/B,SAAS,kCAAkC;AAC3C,SAAS,6BAA6B;AA+BtC,MAAM,yBAAyB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoB/B,MAAM,sBAAsB;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIA,MAAM,oBAAwD;AAAA,EAC5D,MAAM;AAAA,EACN,aACE;AAAA,EACF,OAAO;AAAA,IACL,MAAM;AAAA,IACN,sBAAsB;AAAA,IACtB,YAAY;AAAA,MACV,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,MAAM,CAAC,GAAG,mBAAmB;AAAA,QAC7B,aACE;AAAA,MACJ;AAAA,MACA,cAAc;AAAA,QACZ,MAAM,CAAC,UAAU,MAAM;AAAA,QACvB,aACE;AAAA,MACJ;AAAA,MACA,qBAAqB;AAAA,QACnB,MAAM;AAAA,QACN,aACE;AAAA,QACF,OAAO,EAAE,MAAM,SAAS;AAAA,MAC1B;AAAA,MACA,WAAW;AAAA,QACT,MAAM,CAAC,UAAU,MAAM;AAAA,QACvB,sBAAsB;AAAA,QACtB,YAAY;AAAA,UACV,WAAW,EAAE,MAAM,SAAS;AAAA,UAC5B,aAAa,EAAE,MAAM,CAAC,UAAU,MAAM,EAAE;AAAA,UACxC,aAAa,EAAE,MAAM,CAAC,UAAU,MAAM,EAAE;AAAA,UACxC,QAAQ,EAAE,MAAM,CAAC,UAAU,MAAM,EAAE;AAAA,UACnC,kBAAkB,EAAE,MAAM,CAAC,UAAU,MAAM,EAAE;AAAA,UAC7C,WAAW,EAAE,MAAM,CAAC,UAAU,MAAM,EAAE;AAAA,UACtC,SAAS,EAAE,MAAM,CAAC,UAAU,MAAM,EAAE;AAAA,UACpC,SAAS,EAAE,MAAM,CAAC,WAAW,MAAM,EAAE;AAAA,UACrC,WAAW,EAAE,MAAM,CAAC,WAAW,MAAM,EAAE;AAAA,QACzC;AAAA,QACA,UAAU;AAAA,UACR;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QACA,aAAa;AAAA,MACf;AAAA,MACA,aAAa;AAAA,QACX,MAAM,CAAC,UAAU,MAAM;AAAA,QACvB,aACE;AAAA,MACJ;AAAA,MACA,QAAQ;AAAA,QACN,MAAM,CAAC,UAAU,MAAM;AAAA,QACvB,aAAa;AAAA,MACf;AAAA,IACF;AAAA,IACA,UAAU;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAMA,eAAe,mBACb,KACkB;AAElB,MAAI,CAAE,MAAM,eAAe,IAAI,SAAS,IAAI,OAAO,GAAI;AACrD,WAAO;AAAA,EACT;AACA,QAAM,SACJ,OAAO,IAAI,QAAQ,WAAW,WAAW,IAAI,QAAQ,SAAS;AAChE,MAAI,CAAC,OAAQ,QAAO;AAIpB,QAAM,CAAC,SAAS,OAAO,IAAI,MAAM,QAAQ,IAAI;AAAA,IAC3C,sBAAsB,IAAI,OAAO,EAAE,KAAK;AAAA,MACtC,UAAU,CAAC,UAAU,WAAW,QAAQ;AAAA,MACxC;AAAA,MACA,OAAO;AAAA,IACT,CAAC;AAAA,IACD,2BAA2B,IAAI,OAAO,EAAE,KAAK,QAAQ;AAAA,MACnD,iBAAiB,KAAK;AAAA,IACxB,CAAC;AAAA,EACH,CAAC;AACD,MAAI,QAAQ,SAAS,KAAK,QAAQ,SAAS,EAAG,QAAO;AAIrD,SAAO,IAAI,QAAQ,gBAAgB,cAAc,MAAM;AACzD;AAMA,SAAS,eACP,OACA,MACmB;AACnB,MAAI,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACnC,QAAM,MAAkB,CAAC;AACzB,aAAW,OAAO,OAAO;AACvB,QAAI,CAAC,OAAO,OAAO,QAAQ,SAAU;AACrC,UAAM,IAAI;AACV,UAAM,OAAO,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK;AACvC,QAAI,CAAC,oBAAoB,SAAS,IAAI,EAAG;AACzC,UAAM,KAAe;AAAA,MACnB;AAAA,IACF;AACA,QAAI,OAAO,EAAE,iBAAiB,YAAY,EAAE,aAAa,SAAS,GAAG;AACnE,SAAG,eAAe,EAAE;AAAA,IACtB;AACA,QAAI,MAAM,QAAQ,EAAE,mBAAmB,GAAG;AACxC,SAAG,sBAAsB,EAAE,oBACxB,IAAI,CAAC,OAAO,OAAO,MAAM,EAAE,EAAE,KAAK,CAAC,EACnC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;AAAA,IACjC;AACA,QAAI,EAAE,aAAa,OAAO,EAAE,cAAc,UAAU;AAClD,YAAM,MAAM,EAAE;AACd,UAAI,OAAO,IAAI,cAAc,UAAU;AACrC,WAAG,YAAY;AAAA,UACb,WAAW,IAAI;AAAA,UACf,aACE,OAAO,IAAI,gBAAgB,WAAW,IAAI,cAAc;AAAA,UAC1D,aACE,OAAO,IAAI,gBAAgB,WAAW,IAAI,cAAc;AAAA,UAC1D,QAAQ,OAAO,IAAI,WAAW,WAAW,IAAI,SAAS;AAAA,UACtD,kBACE,OAAO,IAAI,qBAAqB,WAC5B,IAAI,mBACJ;AAAA,UACN,WACE,OAAO,IAAI,cAAc,WAAW,IAAI,YAAY;AAAA,UACtD,SAAS,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU;AAAA,UACzD,SAAS,OAAO,IAAI,YAAY,YAAY,IAAI,UAAU;AAAA,UAC1D,WACE,OAAO,IAAI,cAAc,YAAY,IAAI,YAAY;AAAA,QACzD;AAAA,MACF;AAAA,IACF;AACA,QAAI,OAAO,EAAE,gBAAgB,YAAY,EAAE,YAAY,SAAS,GAAG;AACjE,SAAG,cAAc,EAAE;AAAA,IACrB;AACA,QAAI,OAAO,EAAE,WAAW,YAAY,EAAE,OAAO,SAAS,GAAG;AACvD,SAAG,SAAS,EAAE;AAAA,IAChB;AACA,QAAI,KAAK,EAAE;AAAA,EACb;AACA,SAAO;AACT;AAMA,eAAe,gBACb,KACiD;AACjD,QAAM,MAAM,IAAI;AAChB,MAAI,CAAC,MAAM,QAAQ,GAAG,KAAK,IAAI,WAAW,EAAG,QAAO;AACpD,QAAM,QAAkB,CAAC;AAGzB,QAAM,UAAU,IAAI,KAAK,CAAC,OAAO,GAAG,SAAS,OAAO;AACpD,MAAI,SAAS;AACX,UAAM,SACJ,OAAO,IAAI,QAAQ,WAAW,WAAW,IAAI,QAAQ,SAAS;AAChE,UAAM,SACJ,OAAO,QAAQ,WAAW,YAAY,QAAQ,OAAO,SAAS,IAC1D,QAAQ,SACR;AACN,QAAI,UAAU;AACd,QAAI,UAAU,IAAI,QAAQ,gBAAgB,WAAW;AACnD,gBAAU,IAAI,QAAQ,gBAAgB,UAAU,QAAQ,MAAM;AAAA,IAChE;AACA,UAAM;AAAA,MACJ,eAAe,UAAU,QAAQ,YAAY,UAAU,QAAQ,IAAI,WAAW,MAAM;AAAA,IACtF;AAEA,WAAO;AAAA,MACL,cAAc,CAAC,WAAW;AACxB,YAAI,CAAC,OAAO,aAAa,OAAO,UAAU,WAAW,GAAG;AACtD,iBAAO,YAAY;AAAA,QACrB;AACA,eAAO,gBAAgB;AAEvB,YAAI,CAAC,MAAM,QAAQ,OAAO,QAAQ,EAAG,QAAO,WAAW,CAAC;AACxD,YAAI,CAAC,OAAO,SAAS,SAAS,QAAQ,GAAG;AACvC,iBAAO,WAAW,CAAC,GAAG,OAAO,UAAU,QAAQ;AAAA,QACjD;AAAA,MACF;AAAA,MACA,SAAS,EAAE,MAAM,gBAAgB,OAAO;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AAKA,QAAM;AAAA,IACJ,UAAU,IAAI,MAAM,kBAAkB,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC;AAAA,EACxE;AAEA,SAAO;AAAA,IACL,cAAc,CAAC,WAAW;AAExB,UAAI,CAAC,MAAM,QAAQ,OAAO,oBAAoB,GAAG;AAC/C,eAAO,uBAAuB,CAAC;AAAA,MACjC;AACA,iBAAW,QAAQ,CAAC,eAAe,aAAa,GAAG;AACjD,YAAI,CAAC,OAAO,qBAAqB,SAAS,IAAI,GAAG;AAC/C,iBAAO,qBAAqB,KAAK,IAAI;AAAA,QACvC;AAAA,MACF;AACA,UAAI,CAAC,MAAM,QAAQ,OAAO,QAAQ,EAAG,QAAO,WAAW,CAAC;AACxD,iBAAW,WAAW,CAAC,SAAS,aAAa,YAAY,GAAG;AAC1D,YAAI,CAAC,OAAO,SAAS,SAAS,OAAO,GAAG;AACtC,iBAAO,SAAS,KAAK,OAAO;AAAA,QAC9B;AAAA,MACF;AAEA,aAAO,WAAW,OAAO,SAAS,OAAO,CAAC,MAAM,MAAM,QAAQ;AAAA,IAChE;AAAA,IACA;AAAA,EACF;AACF;AAMO,MAAM,0BAET;AAAA,EACF,MAAM;AAAA,EACN,aAAa;AAAA,EACb,UAAU;AAAA;AAAA,EACV,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AACV;","names":[]}

package/dist/lifeops/work-threads/index.d.ts

@@ -0,0 +1,3 @@
+export { type CreateWorkThreadInput, createWorkThreadStore, type UpdateWorkThreadInput, type WorkThreadStore, } from "./store.js";
+export type { ThreadSourceRef, WorkThread, WorkThreadEvent, WorkThreadEventType, WorkThreadListFilter, WorkThreadStatus, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lifeops/work-threads/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lifeops/work-threads/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/lifeops/work-threads/index.js

@@ -0,0 +1,7 @@
+import {
+  createWorkThreadStore
+} from "./store.js";
+export {
+  createWorkThreadStore
+};
+//# sourceMappingURL=index.js.map

package/dist/lifeops/work-threads/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lifeops/work-threads/index.ts"],"sourcesContent":["export {\n  type CreateWorkThreadInput,\n  createWorkThreadStore,\n  type UpdateWorkThreadInput,\n  type WorkThreadStore,\n} from \"./store.js\";\nexport type {\n  ThreadSourceRef,\n  WorkThread,\n  WorkThreadEvent,\n  WorkThreadEventType,\n  WorkThreadListFilter,\n  WorkThreadStatus,\n} from \"./types.js\";\n"],"mappings":"AAAA;AAAA,EAEE;AAAA,OAGK;","names":[]}

package/dist/lifeops/work-threads/store.d.ts

@@ -0,0 +1,91 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { ThreadSourceRef, WorkThread, WorkThreadEventType, WorkThreadListFilter, WorkThreadStatus } from "./types.js";
+export interface CreateWorkThreadInput {
+    ownerEntityId?: string | null;
+    title: string;
+    summary: string;
+    currentPlanSummary?: string | null;
+    primarySourceRef: ThreadSourceRef;
+    sourceRefs?: ThreadSourceRef[];
+    participantEntityIds?: string[];
+    lastMessageMemoryId?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateWorkThreadInput {
+    status?: WorkThreadStatus;
+    title?: string;
+    summary?: string;
+    currentPlanSummary?: string | null;
+    primarySourceRef?: ThreadSourceRef;
+    sourceRefs?: ThreadSourceRef[];
+    participantEntityIds?: string[];
+    currentScheduledTaskId?: string | null;
+    workflowRunId?: string | null;
+    approvalId?: string | null;
+    lastMessageMemoryId?: string | null;
+    metadata?: Record<string, unknown>;
+    eventType?: WorkThreadEventType;
+    reason?: string;
+    detail?: Record<string, unknown>;
+}
+export interface MergeWorkThreadsInput {
+    /** The thread that will absorb the sources. Must be active and mutable. */
+    targetWorkThreadId: string;
+    /** Threads being merged INTO the target. Must be non-empty, active, mutable. */
+    sourceWorkThreadIds: string[];
+    /**
+     * Idempotency key for this merge attempt. If a merge with the same
+     * `mergeRequestId` has already committed against this target, this call is
+     * a no-op and returns the recorded result.
+     *
+     * Derive from `(targetId, sortedSourceIds, currentTurnId)` so retries within
+     * the same turn deduplicate.
+     */
+    mergeRequestId: string;
+    /** Patch applied to the target (summary, instruction, etc). */
+    patch?: {
+        summary?: string;
+        instruction?: string | null;
+        lastMessageMemoryId?: string | null;
+        participantsToAdd?: string[];
+    };
+    reason?: string | null;
+}
+export interface MergeWorkThreadsResult {
+    /** Updated target thread (post-merge). */
+    target: WorkThread;
+    /** Updated source threads (status=stopped, metadata.mergedIntoWorkThreadId). */
+    sources: WorkThread[];
+    /** True when this is the first time this mergeRequestId committed. */
+    freshlyMerged: boolean;
+}
+export interface WorkThreadStore {
+    create(input: CreateWorkThreadInput): Promise<WorkThread>;
+    get(workThreadId: string): Promise<WorkThread | null>;
+    list(filter?: WorkThreadListFilter): Promise<WorkThread[]>;
+    update(workThreadId: string, input: UpdateWorkThreadInput): Promise<WorkThread | null>;
+    appendEvent(workThreadId: string, type: WorkThreadEventType, args?: {
+        reason?: string;
+        detail?: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Atomic thread merge. All UPDATEs + event INSERTs commit together or none.
+     * Uses optimistic concurrency: every thread's `version` must match the read.
+     * Idempotent on `mergeRequestId`.
+     *
+     * Throws `OptimisticLockError` if any version check fails. Throws standard
+     * errors on validation (`NotFoundError`, `MergeBlockedError`).
+     */
+    merge(input: MergeWorkThreadsInput): Promise<MergeWorkThreadsResult>;
+}
+export declare class MergeBlockedError extends Error {
+    readonly code: string;
+    readonly threadId?: string;
+    constructor(args: {
+        code: string;
+        message: string;
+        threadId?: string;
+    });
+}
+export declare function createWorkThreadStore(runtime: IAgentRuntime, agentId?: string): WorkThreadStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/lifeops/work-threads/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/lifeops/work-threads/store.ts"],"names":[],"mappings":"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"}

package/dist/lifeops/work-threads/store.js

@@ -0,0 +1,245 @@
+import crypto from "node:crypto";
+import { LifeOpsRepository } from "../repository.js";
+class MergeBlockedError extends Error {
+  code;
+  threadId;
+  constructor(args) {
+    super(args.message);
+    this.name = "MergeBlockedError";
+    this.code = args.code;
+    this.threadId = args.threadId;
+  }
+}
+function isoNow() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function compactText(value, maxLength) {
+  const trimmed = value.trim();
+  if (trimmed.length <= maxLength) {
+    return trimmed;
+  }
+  return `${trimmed.slice(0, maxLength - 3).trimEnd()}...`;
+}
+function normalizeSourceRefs(primary, refs = []) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const ref of [primary, ...refs]) {
+    if (!ref || typeof ref.connector !== "string" || ref.connector.length === 0) {
+      continue;
+    }
+    const key = [
+      ref.connector,
+      ref.accountId ?? "",
+      ref.grantId ?? "",
+      ref.roomId ?? "",
+      ref.externalThreadId ?? ""
+    ].join(":");
+    if (seen.has(key)) continue;
+    seen.add(key);
+    result.push({
+      connector: ref.connector,
+      ...ref.channelName ? { channelName: ref.channelName } : {},
+      ...ref.channelKind ? { channelKind: ref.channelKind } : {},
+      ...ref.roomId ? { roomId: ref.roomId } : {},
+      ...ref.externalThreadId ? { externalThreadId: ref.externalThreadId } : {},
+      ...ref.accountId ? { accountId: ref.accountId } : {},
+      ...ref.grantId ? { grantId: ref.grantId } : {},
+      canRead: ref.canRead ?? true,
+      canMutate: ref.canMutate ?? false
+    });
+  }
+  return result;
+}
+function createWorkThreadStore(runtime, agentId = runtime.agentId) {
+  const repo = new LifeOpsRepository(runtime);
+  return {
+    async create(input) {
+      const timestamp = isoNow();
+      const sourceRefs = normalizeSourceRefs(
+        input.primarySourceRef,
+        input.sourceRefs
+      );
+      const thread = {
+        id: crypto.randomUUID(),
+        agentId,
+        ownerEntityId: input.ownerEntityId ?? null,
+        status: "active",
+        title: compactText(input.title || "Active thread", 120),
+        summary: compactText(
+          input.summary || input.title || "Active thread",
+          500
+        ),
+        currentPlanSummary: input.currentPlanSummary ?? null,
+        primarySourceRef: sourceRefs[0] ?? input.primarySourceRef,
+        sourceRefs,
+        participantEntityIds: [...new Set(input.participantEntityIds ?? [])],
+        currentScheduledTaskId: null,
+        workflowRunId: null,
+        approvalId: null,
+        lastMessageMemoryId: input.lastMessageMemoryId ?? null,
+        version: 1,
+        createdAt: timestamp,
+        updatedAt: timestamp,
+        lastActivityAt: timestamp,
+        metadata: input.metadata ?? {}
+      };
+      await repo.upsertWorkThread(agentId, thread);
+      await this.appendEvent(thread.id, "created", {
+        detail: { sourceRef: thread.primarySourceRef }
+      });
+      return thread;
+    },
+    get(workThreadId) {
+      return repo.getWorkThread(agentId, workThreadId);
+    },
+    list(filter = {}) {
+      return repo.listWorkThreads(agentId, filter);
+    },
+    async update(workThreadId, input) {
+      const current = await repo.getWorkThread(agentId, workThreadId);
+      if (!current) {
+        return null;
+      }
+      const timestamp = isoNow();
+      const primary = input.primarySourceRef ?? current.primarySourceRef;
+      const sourceRefs = input.sourceRefs ? normalizeSourceRefs(primary, input.sourceRefs) : current.sourceRefs;
+      const next = {
+        ...current,
+        status: input.status ?? current.status,
+        title: typeof input.title === "string" ? compactText(input.title, 120) : current.title,
+        summary: typeof input.summary === "string" ? compactText(input.summary, 500) : current.summary,
+        currentPlanSummary: input.currentPlanSummary !== void 0 ? input.currentPlanSummary : current.currentPlanSummary,
+        primarySourceRef: primary,
+        sourceRefs,
+        participantEntityIds: input.participantEntityIds ? [...new Set(input.participantEntityIds)] : current.participantEntityIds,
+        currentScheduledTaskId: input.currentScheduledTaskId !== void 0 ? input.currentScheduledTaskId : current.currentScheduledTaskId,
+        workflowRunId: input.workflowRunId !== void 0 ? input.workflowRunId : current.workflowRunId,
+        approvalId: input.approvalId !== void 0 ? input.approvalId : current.approvalId,
+        lastMessageMemoryId: input.lastMessageMemoryId !== void 0 ? input.lastMessageMemoryId : current.lastMessageMemoryId,
+        metadata: input.metadata ? { ...current.metadata ?? {}, ...input.metadata } : current.metadata,
+        updatedAt: timestamp,
+        lastActivityAt: timestamp
+      };
+      await repo.upsertWorkThread(agentId, next);
+      await this.appendEvent(workThreadId, input.eventType ?? "updated", {
+        reason: input.reason,
+        detail: input.detail
+      });
+      return next;
+    },
+    async appendEvent(workThreadId, type, args = {}) {
+      await repo.appendWorkThreadEvent({
+        id: crypto.randomUUID(),
+        agentId,
+        workThreadId,
+        occurredAt: isoNow(),
+        type,
+        reason: args.reason ?? null,
+        detail: args.detail
+      });
+    },
+    async merge(input) {
+      const sourceIds = [
+        ...new Set(
+          input.sourceWorkThreadIds.filter(
+            (id) => id && id !== input.targetWorkThreadId
+          )
+        )
+      ];
+      if (sourceIds.length === 0) {
+        throw new MergeBlockedError({
+          code: "MISSING_SOURCE_WORK_THREAD_IDS",
+          message: "No source work threads provided."
+        });
+      }
+      const target = await this.get(input.targetWorkThreadId);
+      if (!target) {
+        throw new MergeBlockedError({
+          code: "TARGET_NOT_FOUND",
+          message: `Target work thread not found: ${input.targetWorkThreadId}`,
+          threadId: input.targetWorkThreadId
+        });
+      }
+      const sources = [];
+      for (const sourceId of sourceIds) {
+        const source = await this.get(sourceId);
+        if (!source) {
+          throw new MergeBlockedError({
+            code: "SOURCE_NOT_FOUND",
+            message: `Source work thread not found: ${sourceId}`,
+            threadId: sourceId
+          });
+        }
+        sources.push(source);
+      }
+      const timestamp = isoNow();
+      const summary = typeof input.patch?.summary === "string" ? compactText(input.patch.summary, 500) : target.summary;
+      const currentPlanSummary = typeof input.patch?.instruction === "string" && input.patch.instruction.trim().length > 0 ? input.patch.instruction.trim() : target.currentPlanSummary;
+      const mergedSourceRefs = [
+        ...target.sourceRefs,
+        ...sources.flatMap((source) => source.sourceRefs)
+      ];
+      const mergedParticipantEntityIds = [
+        .../* @__PURE__ */ new Set([
+          ...target.participantEntityIds,
+          ...sources.flatMap((source) => source.participantEntityIds),
+          ...input.patch?.participantsToAdd ?? []
+        ])
+      ];
+      const existingMetadata = target.metadata ?? {};
+      const existingMergedFrom = (() => {
+        const raw = existingMetadata.mergedFromWorkThreadIds;
+        return Array.isArray(raw) ? raw.filter((value) => typeof value === "string") : [];
+      })();
+      const nextTarget = {
+        ...target,
+        summary,
+        currentPlanSummary,
+        sourceRefs: mergedSourceRefs,
+        participantEntityIds: mergedParticipantEntityIds,
+        lastMessageMemoryId: input.patch?.lastMessageMemoryId !== void 0 ? input.patch.lastMessageMemoryId : target.lastMessageMemoryId,
+        metadata: {
+          ...existingMetadata,
+          mergedFromWorkThreadIds: [
+            .../* @__PURE__ */ new Set([...existingMergedFrom, ...sourceIds])
+          ]
+        },
+        updatedAt: timestamp,
+        lastActivityAt: timestamp
+      };
+      const writeResult = await repo.mergeWorkThreadsAtomic({
+        agentId,
+        target,
+        sources,
+        nextTarget,
+        mergeRequestId: input.mergeRequestId,
+        reason: input.reason ?? null,
+        instruction: input.patch?.instruction ?? null
+      });
+      const refreshedTarget = await this.get(writeResult.targetWorkThreadId);
+      if (!refreshedTarget) {
+        throw new MergeBlockedError({
+          code: "TARGET_VANISHED",
+          message: "Target thread missing post-merge \u2014 concurrent deletion?",
+          threadId: writeResult.targetWorkThreadId
+        });
+      }
+      const refreshedSources = [];
+      for (const sourceId of writeResult.sourceWorkThreadIds) {
+        const source = await this.get(sourceId);
+        if (source) refreshedSources.push(source);
+      }
+      const freshlyMerged = refreshedTarget.version > target.version;
+      return {
+        target: refreshedTarget,
+        sources: refreshedSources,
+        freshlyMerged
+      };
+    }
+  };
+}
+export {
+  MergeBlockedError,
+  createWorkThreadStore
+};
+//# sourceMappingURL=store.js.map