@memorax/memorax-code 0.1.7 → 0.1.9

package/lib/memorax-code-dsh-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/dsh-memorax-code",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "private": true,
   "type": "module",
   "description": "DeepSeek Harness native memory adapter for MemoraX Code.",

package/lib/memorax-code-dsh-adapter/skills/memorax-code/SKILL.md

@@ -82,10 +82,4 @@ Apply instructions in this order: system and developer instructions, `AGENTS.md`
 
 For MemoraX Code coding memory, use `memorax-cli` exactly as described by the selected reference. Invoke this skill as `$memorax-code` in Codex or `/memorax-code` in Claude Code. In OpenCode, ask the agent to use the `memorax-code` skill by name. These invocation forms are not shell commands. `memorax-code` is the lifecycle CLI and must not be used for memory search or add. Do not call MemoraX HTTP endpoints directly.
 
-When explaining Memory Viewer, describe only `/memory-viewer`. It is a
-content-free local summary and must not expose conversation or memory text,
-session or turn identifiers, paths, or trace details. The page never queries
-MemoraX directly; it projects client-qualified local activity and keeps each
-supported harness isolated.
-
 Never store secrets, credentials, `.env` content, sensitive personal data, raw transcripts, hidden tests, exact patches, temporary target commits, or unsafe destructive commands. Do not announce internal routing or reference loading.

package/lib/memorax-code-dsh-adapter/skills/memorax-code/references/memorax-add.md

@@ -83,6 +83,6 @@ Do not add speculation, assistant-only praise, or a current instruction merely b
 
 ## Output
 
-If a successful Add returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not coding memory content, and continue the current task.
+If a successful Add returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or anonymous-account claim details. A guest reminder may already contain the local Mark ID; present it once as part of the reminder, but do not repeat or separately quote it. Never run `memorax-code account --show-mark-id` for the user or ask for its output. Treat the reminder as user-facing operational output, not coding memory content, and continue the current task.
 
 After an add request is accepted, confirm briefly that it was submitted for processing and identify the reusable coding lesson at a high level. If add is disabled or fails, report the issue and continue without bypassing the CLI.

package/lib/memorax-code-dsh-adapter/skills/memorax-code/references/memorax-search.md

@@ -88,6 +88,6 @@ Do not apply this retry to `memorax-cli add`, authentication or configuration fa
 
 ## Output
 
-If a successful Search returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not recalled memory, and continue the current task.
+If a successful Search returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or anonymous-account claim details. A guest reminder may already contain the local Mark ID; present it once as part of the reminder, but do not repeat or separately quote it. Never run `memorax-code account --show-mark-id` for the user or ask for its output. Treat the reminder as user-facing operational output, not recalled memory, and continue the current task.
 
 Mention only an invariant, pitfall, convention, or validation idea that materially affects the answer. Ground claims about current implementation behavior in live code and checks.

package/lib/memorax-code-opencode-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/opencode-adapter",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "private": true,
   "type": "module",
   "description": "OpenCode plugin adapter for MemoraX Code memory services.",

package/lib/memorax-code-opencode-adapter/skills/memorax-code/SKILL.md

@@ -82,10 +82,4 @@ Apply instructions in this order: system and developer instructions, `AGENTS.md`
 
 For MemoraX Code coding memory, use `memorax-cli` exactly as described by the selected reference. Invoke this skill as `$memorax-code` in Codex or `/memorax-code` in Claude Code. In OpenCode, ask the agent to use the `memorax-code` skill by name. These invocation forms are not shell commands. `memorax-code` is the lifecycle CLI and must not be used for memory search or add. Do not call MemoraX HTTP endpoints directly.
 
-When explaining Memory Viewer, describe only `/memory-viewer`. It is a
-content-free local summary and must not expose conversation or memory text,
-session or turn identifiers, paths, or trace details. The page never queries
-MemoraX directly; it projects client-qualified local activity and keeps each
-supported harness isolated.
-
 Never store secrets, credentials, `.env` content, sensitive personal data, raw transcripts, hidden tests, exact patches, temporary target commits, or unsafe destructive commands. Do not announce internal routing or reference loading.

package/lib/memorax-code-opencode-adapter/skills/memorax-code/references/memorax-add.md

@@ -83,6 +83,6 @@ Do not add speculation, assistant-only praise, or a current instruction merely b
 
 ## Output
 
-If a successful Add returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not coding memory content, and continue the current task.
+If a successful Add returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or anonymous-account claim details. A guest reminder may already contain the local Mark ID; present it once as part of the reminder, but do not repeat or separately quote it. Never run `memorax-code account --show-mark-id` for the user or ask for its output. Treat the reminder as user-facing operational output, not coding memory content, and continue the current task.
 
 After an add request is accepted, confirm briefly that it was submitted for processing and identify the reusable coding lesson at a high level. If add is disabled or fails, report the issue and continue without bypassing the CLI.

package/lib/memorax-code-opencode-adapter/skills/memorax-code/references/memorax-search.md

@@ -88,6 +88,6 @@ Do not apply this retry to `memorax-cli add`, authentication or configuration fa
 
 ## Output
 
-If a successful Search returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not recalled memory, and continue the current task.
+If a successful Search returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or anonymous-account claim details. A guest reminder may already contain the local Mark ID; present it once as part of the reminder, but do not repeat or separately quote it. Never run `memorax-code account --show-mark-id` for the user or ask for its output. Treat the reminder as user-facing operational output, not recalled memory, and continue the current task.
 
 Mention only an invariant, pitfall, convention, or validation idea that materially affects the answer. Ground claims about current implementation behavior in live code and checks.

package/lib/memorax-code-opencode-adapter/src/plugin.mjs

@@ -103,13 +103,14 @@ export function createMemoraxOpenCodePlugin(options = {}) {
           && message.info.id === turn.userMessageId
           && message.info.sessionID === sessionId
         ));
-        const assistant = terminalAssistantFor(
+        const terminal = terminalTurnFor(
           messages,
           sessionId,
           turn.userMessageId,
           target?.assistantMessageId,
         );
-        if (!user || !assistant) continue;
+        if (!user || !terminal) continue;
+        const { assistant, evidence } = terminal;
         let result;
         try {
           result = await postBackend(options, "/memory/writeback", {
@@ -118,7 +119,7 @@ export function createMemoraxOpenCodePlugin(options = {}) {
             sessionId,
             userMessageId: turn.userMessageId,
             assistantMessageId: assistant.info.id,
-            messages: [user, assistant],
+            messages: evidence,
             cwd: workspaceRoot,
             workspaceKind,
           }, WRITEBACK_TIMEOUT_MS);
@@ -281,10 +282,13 @@ export function createMemoraxOpenCodePlugin(options = {}) {
           return;
         }
         if (event?.type === "message.updated") {
-          const interrupted = interruptedAssistantFromEvent(event, pendingTurns);
+          const interrupted = terminalErrorAssistantFromEvent(event, pendingTurns);
           if (interrupted) {
             track(
-              queueSessionFlush(interrupted.sessionId, interrupted),
+              queueSessionFlush(
+                interrupted.sessionId,
+                interrupted.userMessageId ? interrupted : undefined,
+              ),
               "opencode interrupted turn finalization failed",
             );
           }
@@ -310,18 +314,16 @@ export function createMemoraxOpenCodePlugin(options = {}) {
 export const MemoraxOpenCodePlugin = createMemoraxOpenCodePlugin();
 export default MemoraxOpenCodePlugin;
 
-function terminalAssistantFor(messages, sessionId, userMessageId, assistantMessageId) {
-  return messages
+function terminalTurnFor(messages, sessionId, userMessageId, assistantMessageId) {
+  const lineage = turnLineage(messages, sessionId, userMessageId);
+  if (!lineage || lineage.awaitingContinuation) return undefined;
+  const assistant = lineage.messages
     .filter((message) => (
       message?.info?.role === "assistant"
       && message.info.sessionID === sessionId
-      && message.info.parentID === userMessageId
+      && message.info.parentID === lineage.terminalUserMessageId
       && (!assistantMessageId || message.info.id === assistantMessageId)
       && Number.isFinite(message.info.time?.completed)
-      && (
-        message.info.error === undefined
-        || message.info.error?.name === "MessageAbortedError"
-      )
       && message.info.summary !== true
       && !message.parts?.some((part) => part?.type === "compaction")
     ))
@@ -330,24 +332,127 @@ function terminalAssistantFor(messages, sessionId, userMessageId, assistantMessa
       || String(left.info.id).localeCompare(String(right.info.id))
     ))
     .at(-1);
+  if (!assistant) return undefined;
+  return {
+    assistant,
+    evidence: uniqueMessages([...lineage.evidence, assistant]),
+  };
 }
 
-function interruptedAssistantFromEvent(event, pendingTurns) {
+function turnLineage(messages, sessionId, userMessageId) {
+  const sessionMessages = messages.filter((message) => (
+    message?.info?.sessionID === sessionId
+    && stringValue(message.info.id)
+    && Array.isArray(message.parts)
+  ));
+  const startIndex = sessionMessages.findIndex((message) => (
+    message.info.role === "user" && message.info.id === userMessageId
+  ));
+  if (startIndex < 0) return undefined;
+  const original = sessionMessages[startIndex];
+  const lineageAssistants = new Map();
+  const evidence = [original];
+  let terminalUserMessageId = userMessageId;
+  let awaitingContinuation = false;
+
+  for (const message of sessionMessages.slice(startIndex + 1)) {
+    if (message.info.role === "assistant") {
+      if (message.info.parentID === terminalUserMessageId) {
+        lineageAssistants.set(message.info.id, message);
+      }
+      continue;
+    }
+    if (message.info.role !== "user") continue;
+    if (hasCompactionPart(message.parts)) {
+      const compactionTailId = compactionTailStartId(message, sessionId);
+      if (!compactionTailId || awaitingContinuation) return undefined;
+      const tail = lineageAssistants.get(compactionTailId);
+      if (!tail) return undefined;
+      evidence.push(minimalAssistantEvidence(tail), message);
+      awaitingContinuation = true;
+      continue;
+    }
+    if (isCompactionContinuation(message, sessionId)) {
+      if (!awaitingContinuation) return undefined;
+      terminalUserMessageId = message.info.id;
+      evidence.push(message);
+      awaitingContinuation = false;
+      continue;
+    }
+    break;
+  }
+  return {
+    messages: sessionMessages.slice(startIndex + 1),
+    terminalUserMessageId,
+    awaitingContinuation,
+    evidence,
+  };
+}
+
+function hasCompactionPart(parts) {
+  return parts.some((part) => part?.type === "compaction");
+}
+
+function compactionTailStartId(message, sessionId) {
+  const messageId = stringValue(message?.info?.id);
+  const parts = message?.parts?.filter((part) => (
+    part?.type === "compaction"
+    && part.sessionID === sessionId
+    && part.messageID === messageId
+  )) ?? [];
+  if (parts.length !== 1) return undefined;
+  return stringValue(parts[0].tail_start_id);
+}
+
+function minimalAssistantEvidence(message) {
+  return {
+    info: {
+      id: message.info.id,
+      sessionID: message.info.sessionID,
+      role: message.info.role,
+      parentID: message.info.parentID,
+    },
+    parts: [],
+  };
+}
+
+function isCompactionContinuation(message, sessionId) {
+  const messageId = stringValue(message?.info?.id);
+  return message?.parts?.some((part) => (
+    part?.type === "text"
+    && part.synthetic === true
+    && part.metadata?.compaction_continue === true
+    && part.sessionID === sessionId
+    && part.messageID === messageId
+  )) === true;
+}
+
+function uniqueMessages(messages) {
+  const unique = new Map();
+  for (const message of messages) unique.set(message.info.id, message);
+  return [...unique.values()];
+}
+
+function terminalErrorAssistantFromEvent(event, pendingTurns) {
   const info = event?.properties?.info;
   const sessionId = stringValue(info?.sessionID);
   const userMessageId = stringValue(info?.parentID);
   const assistantMessageId = stringValue(info?.id);
   if (
     info?.role !== "assistant"
-    || info?.error?.name !== "MessageAbortedError"
+    || !stringValue(info?.error?.name)
     || !Number.isFinite(info?.time?.completed)
     || info?.summary === true
     || !sessionId
     || !userMessageId
     || !assistantMessageId
-    || !pendingTurns.has(turnKey({ sessionId, userMessageId }))
   ) return undefined;
-  return { sessionId, userMessageId, assistantMessageId };
+  if (pendingTurns.has(turnKey({ sessionId, userMessageId }))) {
+    return { sessionId, userMessageId, assistantMessageId };
+  }
+  return [...pendingTurns.values()].some((turn) => turn.sessionId === sessionId)
+    ? { sessionId }
+    : undefined;
 }
 
 function textParts(parts) {

package/lib/memorax-code-opencode-adapter/src/repo-memory-server-runner.mjs

@@ -7,6 +7,7 @@ import { fileURLToPath } from "node:url";
 export const OPENCODE_REPO_MEMORY_AGENT = "memorax-code-repo-memory";
 
 const OWNED_SERVER_USERNAME = "memorax-code";
+const OWNED_SERVER_DATABASE = ":memory:";
 const DEFAULT_SERVER_START_TIMEOUT_MS = 20_000;
 const DEFAULT_SERVER_STOP_TIMEOUT_MS = 5_000;
 const MAX_SERVER_START_OUTPUT = 8_192;
@@ -155,6 +156,7 @@ async function startOwnedOpenCodeServer(input) {
     cwd: input.directory,
     env: {
       ...input.env,
+      OPENCODE_DB: OWNED_SERVER_DATABASE,
       OPENCODE_SERVER_USERNAME: username,
       OPENCODE_SERVER_PASSWORD: password,
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax/memorax-code",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Persistent coding memory for Codex, Claude Code, DeepSeek Harness, and OpenCode.",
   "license": "MIT",
   "type": "module",

package/lib/memorax-code-backend/dist/clients/codex/effective-prompt.js

@@ -1,54 +0,0 @@
-export function stripCodexPreambleSegments(text) {
-    let remaining = text;
-    for (;;) {
-        const next = stripOneLeadingCodexPreambleSegment(remaining);
-        if (next === remaining) {
-            return stripCodexSkillSegments(stripCodexAmbientUiSegments(remaining)).trim();
-        }
-        remaining = next.trimStart();
-    }
-}
-function stripOneLeadingCodexPreambleSegment(text) {
-    return stripLeadingEnvironmentContext(text)
-        ?? stripLeadingInstructionsBlock(text)
-        ?? stripLeadingSessionPreamble(text)
-        ?? text;
-}
-function stripCodexSkillSegments(text) {
-    return text.replace(/(^|\n)[^\S\n]*<skill\b[\s\S]*?<\/skill>[^\S\n]*(?=\n|$)/gi, (match, prefix) => {
-        const block = match.slice(prefix.length).trim();
-        return isCodexSkillSegment(block) ? prefix : match;
-    });
-}
-function stripCodexAmbientUiSegments(text) {
-    let removedAmbientContext = false;
-    const withoutAmbientContext = text.replace(/(^|\n)[^\S\n]*<in-app-browser-context\b[\s\S]*?<\/in-app-browser-context>[^\S\n]*(?=\n|$)/gi, (_match, prefix) => {
-        removedAmbientContext = true;
-        return prefix;
-    });
-    if (!removedAmbientContext)
-        return text;
-    return withoutAmbientContext
-        .replace(/(^|\n)[^\S\n]*##\s+My request for Codex:[^\S\n]*(?=\n|$)/gi, "$1")
-        .replace(/\n[^\S\n]*(?:\n[^\S\n]*){2,}/g, "\n\n");
-}
-function isCodexSkillSegment(text) {
-    return /^<skill\b/i.test(text)
-        && /<name>[^<\n]+<\/name>/i.test(text)
-        && /<path>[\s\S]*?SKILL\.md[\s\S]*?<\/path>/i.test(text);
-}
-function stripLeadingEnvironmentContext(text) {
-    const match = text.match(/^\s*<environment_context\b[\s\S]*?<\/environment_context>\s*/);
-    return match ? text.slice(match[0].length) : undefined;
-}
-function stripLeadingInstructionsBlock(text) {
-    const match = text.match(/^\s*#\s+(?:AGENTS|CLAUDE)\.md[^\n]*[\s\S]*?<\/INSTRUCTIONS>\s*/i);
-    return match ? text.slice(match[0].length) : undefined;
-}
-function stripLeadingSessionPreamble(text) {
-    const trimmed = text.trimStart();
-    if (!trimmed.startsWith("You are Claude Code"))
-        return undefined;
-    const boundary = trimmed.indexOf("\n\n");
-    return boundary >= 0 ? trimmed.slice(boundary + 2) : "";
-}

package/lib/memorax-code-backend/dist/memory/writeback-reconciler.js

@@ -1,244 +0,0 @@
-import { createHash } from "node:crypto";
-import { backendDebug } from "../shared/debug-log.js";
-import { callMemoAddStatus, memoraxConfigFromEnv } from "../provider/memorax/adapter.js";
-import { MEMORAX_PROVIDER_ID, memoraxWritebackEnabled } from "../provider/memorax/config.js";
-import { completeMemoryWritebackTask, createMemoryWritebackTaskProjection, } from "./writeback-task-projection.js";
-import { clientTraceConfigFromEnv } from "../trace/config.js";
-import { recordTraceEvent } from "../trace/store.js";
-const DEFAULT_INTERVAL_MS = 60_000;
-const DEFAULT_MAX_TASKS_PER_RUN = 20;
-const DEFAULT_CONCURRENCY = 4;
-const DEFAULT_MAX_BACKOFF_MS = 60 * 60_000;
-export async function reconcileMemoryWritebackStatuses(options) {
-    return reconcileMemoryWritebackStatusesWithPolicy(options);
-}
-export function startMemoryWritebackReconciler(options) {
-    let closed = false;
-    let active;
-    let candidateOffset = 0;
-    const intervalMs = positiveInteger(options.intervalMs, DEFAULT_INTERVAL_MS);
-    const maxTasks = positiveInteger(options.maxTasks, DEFAULT_MAX_TASKS_PER_RUN);
-    const taskProjection = resolveTaskProjection(options);
-    const policy = createReconcileBackoffPolicy({
-        now: options.now ?? Date.now,
-        baseDelayMs: intervalMs,
-        maxDelayMs: Math.max(intervalMs, positiveInteger(options.maxBackoffMs, DEFAULT_MAX_BACKOFF_MS)),
-    });
-    const runNow = () => {
-        if (closed)
-            return Promise.resolve(emptyReport());
-        if (active)
-            return active;
-        active = reconcileMemoryWritebackStatusesWithPolicy({
-            ...options,
-            maxTasks,
-            candidateOffset,
-            taskProjection,
-        }, policy).finally(() => {
-            candidateOffset += maxTasks;
-            active = undefined;
-        });
-        return active;
-    };
-    const scheduleRun = () => {
-        void runNow().catch((error) => {
-            backendDebug("memory_writeback_reconciler.run_failed", {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        });
-    };
-    scheduleRun();
-    const timer = setInterval(scheduleRun, intervalMs);
-    timer.unref?.();
-    return {
-        runNow,
-        async close() {
-            closed = true;
-            clearInterval(timer);
-            await active?.catch(() => undefined);
-        },
-    };
-}
-async function reconcileMemoryWritebackStatusesWithPolicy(options, policy) {
-    const env = { ...(options.env ?? process.env), MEMORAX_CODE_HOME: options.memoraxCodeHome };
-    const config = memoraxConfigFromEnv(env);
-    const taskProjection = resolveTaskProjection(options);
-    if (!clientTraceConfigFromEnv(taskProjection.client, env).enabled
-        || !config.ok
-        || !memoraxWritebackEnabled(env)) {
-        return emptyReport();
-    }
-    const maxTasks = positiveInteger(options.maxTasks, DEFAULT_MAX_TASKS_PER_RUN);
-    const concurrency = positiveInteger(options.concurrency, DEFAULT_CONCURRENCY);
-    const pendingWritebacks = await taskProjection.listPending();
-    policy?.retainPending(pendingWritebacks);
-    const dueWritebacks = pendingWritebacks.filter((task) => policy?.isDue(task) ?? true);
-    const candidates = rotatedBatch(dueWritebacks, maxTasks, options.candidateOffset ?? 0);
-    const queue = [...candidates];
-    const report = { inspected: 0, persisted: 0, pending: 0, failed: 0 };
-    const workers = Array.from({ length: Math.min(concurrency, queue.length) }, async () => {
-        for (;;) {
-            const task = queue.shift();
-            if (!task)
-                return;
-            report.inspected += 1;
-            try {
-                const raw = await callMemoAddStatus(config.config, task.taskId, options.fetchImpl);
-                const status = normalizeAddStatus(raw);
-                if (isPendingWritebackStatus(status.status)) {
-                    report.pending += 1;
-                    policy?.recordResult(task, "pending");
-                    continue;
-                }
-                await persistTerminalWritebackStatus(options.memoraxCodeHome, env, task, status);
-                report.persisted += 1;
-                policy?.recordResult(task, "persisted");
-            }
-            catch (error) {
-                report.failed += 1;
-                policy?.recordResult(task, "failed");
-                backendDebug("memory_writeback_reconciler.status_failed", {
-                    taskId: task.taskId,
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-        }
-    });
-    await Promise.all(workers);
-    return report;
-}
-function resolveTaskProjection(options) {
-    return options.taskProjection ?? createMemoryWritebackTaskProjection({
-        memoraxCodeHome: options.memoraxCodeHome,
-        client: options.client ?? "codex",
-    });
-}
-async function persistTerminalWritebackStatus(memoraxCodeHome, env, task, status) {
-    const completed = completeMemoryWritebackTask({
-        status: status.status,
-        ...(status.memoryKnown ? { memory: status.memory, memoryKnown: true } : {}),
-        error: status.error,
-    });
-    const capturedAt = new Date().toISOString();
-    const recorded = await recordTraceEvent({
-        memoraxCodeHome,
-        env,
-        eventId: terminalEventId(task, completed.status),
-        traceContext: {
-            schemaVersion: "1",
-            client: task.client,
-            sessionId: task.sessionId,
-            ...(task.turnId ? { turnId: task.turnId } : {}),
-            ...(task.memoryProject ? { memoryProject: task.memoryProject } : {}),
-            contextOrigin: "manual",
-            capturedAt,
-        },
-        type: "memory_writeback_status",
-        source: "writeback_reconciler",
-        operation: "writeback",
-        ok: completed.ok,
-        request: {
-            task_id: task.taskId,
-            original_event_id: task.eventId,
-            provider: MEMORAX_PROVIDER_ID,
-        },
-        response: {
-            taskId: task.taskId,
-            status: completed.status,
-            outcome: completed.outcome,
-            ...(completed.savedMemoryCount === undefined ? {} : { savedMemoryCount: completed.savedMemoryCount }),
-            ...(completed.savedMemoryIds?.length ? { savedMemoryIds: completed.savedMemoryIds } : {}),
-            ...(completed.savedMemories?.length ? { savedMemories: completed.savedMemories } : {}),
-        },
-        error: completed.error,
-    });
-    if (!recorded.written && recorded.reason !== "duplicate_event") {
-        throw new Error(`writeback terminal status was not persisted: ${recorded.reason}`);
-    }
-}
-function createReconcileBackoffPolicy(options) {
-    const retries = new Map();
-    return {
-        retainPending(tasks) {
-            const pendingKeys = new Set(tasks.map(reconcileCandidateKey));
-            for (const key of retries.keys()) {
-                if (!pendingKeys.has(key))
-                    retries.delete(key);
-            }
-        },
-        isDue(task) {
-            const key = reconcileCandidateKey(task);
-            return (retries.get(key)?.nextAttemptAt ?? 0) <= options.now();
-        },
-        recordResult(task, result) {
-            const key = reconcileCandidateKey(task);
-            if (result === "persisted") {
-                retries.delete(key);
-                return;
-            }
-            const attempts = (retries.get(key)?.attempts ?? 0) + 1;
-            const multiplier = 2 ** Math.min(attempts - 1, 30);
-            const delayMs = Math.min(options.maxDelayMs, options.baseDelayMs * multiplier);
-            retries.set(key, {
-                attempts,
-                nextAttemptAt: options.now() + delayMs,
-            });
-        },
-    };
-}
-function reconcileCandidateKey(task) {
-    return JSON.stringify([
-        task.client,
-        task.sessionId,
-        task.eventId,
-        task.taskId,
-    ]);
-}
-function normalizeAddStatus(raw) {
-    const envelope = record(raw);
-    const data = record(envelope?.data) ?? envelope;
-    const status = typeof data?.status === "string" ? data.status.trim().toLowerCase() : "unknown";
-    const error = typeof data?.error === "string" && data.error.trim() ? data.error.trim() : null;
-    const hasMemoryField = Boolean(data)
-        && (Object.prototype.hasOwnProperty.call(data, "memory")
-            || Object.prototype.hasOwnProperty.call(data, "memories"));
-    const memory = data?.memory ?? data?.memories;
-    const memoryKnown = hasMemoryField && memory !== null && memory !== undefined;
-    return {
-        status,
-        ...(memoryKnown ? { memory } : {}),
-        memoryKnown,
-        error,
-    };
-}
-function isPendingWritebackStatus(status) {
-    return status === "accepted"
-        || status === "processing"
-        || status === "queued"
-        || status === "pending"
-        || status === "unknown";
-}
-function terminalEventId(task, status) {
-    const digest = createHash("sha256")
-        .update(`${task.sessionId}\u0000${task.eventId}\u0000${task.taskId}\u0000${status}`)
-        .digest("hex")
-        .slice(0, 32);
-    return `memory-writeback-status-${digest}`;
-}
-function positiveInteger(value, fallback) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : fallback;
-}
-function rotatedBatch(items, limit, offset) {
-    if (items.length <= limit)
-        return [...items];
-    const start = Number.isSafeInteger(offset) && offset > 0 ? offset % items.length : 0;
-    return Array.from({ length: limit }, (_, index) => items[(start + index) % items.length]);
-}
-function emptyReport() {
-    return { inspected: 0, persisted: 0, pending: 0, failed: 0 };
-}
-function record(value) {
-    return value && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : undefined;
-}