@humwick/server 0.130.1 → 0.130.3

package/src/memory-area-injection.ts

@@ -1,3 +1,4 @@
+import { createCommandAsync } from "./commands-write";
 // #3410 — on-touch area memory. The runner reports the first file an agent touches in a path area
 // (`.agent-relay/areas.json`) in a context generation. This selects that area's memories of the
 // agent's own project that the startup block holds out (#3409, #3508), renders them, and
@@ -6,10 +7,10 @@
 
 import { injectsAtStartup, cleanAreasConfig, type AreaDefinition } from "@humwick/sdk/areas";
 import { isRecord, stringValue, type AreaEnteredInput, type AreaEnteredResult } from "@humwick/sdk";
-import { createCommand } from "./commands-db";
+
 import { emitCommandEvent } from "./command-events";
 import { contextInjectUnsupported } from "./context-injection-channel";
-import { listActiveEntriesInArea, ValidationError } from "./db";
+import { listActiveEntriesInAreaAsync, ValidationError } from "./db";
 import { entryInjectability } from "./memory-inject-filter";
 import { memoryHeadline, neutralizeMemoryMarkers } from "./memory-preamble";
 import { memorySeamForAgent, projectMemoryEnabledForSeam } from "./memory-seam";
@@ -45,8 +46,8 @@ export function parseAreaEnteredInput(body: unknown): AreaEnteredInput {
 
 /** The agent's own project's active entries for `area` that its startup block does not carry
  *  (#3508), and it may receive: pinned first, then newest. Ancestor projects are not walked. */
-export function selectAreaEntries(projectId: string, area: string, profile: string | undefined, exclude: ReadonlySet<string>, now: number): ProjectEntry[] {
-  const selected = listActiveEntriesInArea(projectId, area).filter((entry) =>
+export async function selectAreaEntries(projectId: string, area: string, profile: string | undefined, exclude: ReadonlySet<string>, now: number): Promise<ProjectEntry[]> {
+  const selected = (await listActiveEntriesInAreaAsync(projectId, area)).filter((entry) =>
     entry.areas?.includes(area)
     && !injectsAtStartup(entry)
     && !exclude.has(entry.id)
@@ -123,7 +124,7 @@ async function selectForAgent(agent: AgentCard, input: AreaEnteredInput, now: nu
   const projectId = seam.identity.projectId;
   if (!projectId) return { definition, entries: [], skipped: "no-project" };
   if (!projectMemoryEnabledForSeam(seam)) return { definition, entries: [], skipped: "project-memory-off" };
-  return { definition, entries: selectAreaEntries(projectId, input.area, seam.identity.profile, new Set(input.exclude), now) };
+  return { definition, entries: await selectAreaEntries(projectId, input.area, seam.identity.profile, new Set(input.exclude), now) };
 }
 
 function areaSummary(area: string, entries: number, tokens: number): string {
@@ -143,7 +144,7 @@ export async function enqueueAreaMemoryInjection(agent: AgentCard, input: AreaEn
   const tokens = selected ? block.tokens : 0;
   const omitted = selected ? block.omitted : 0;
   if (queued) {
-    const command = createCommand({
+    const command = (await createCommandAsync({
       type: "agent.injectContext",
       source: "system",
       target: agent.id,
@@ -158,10 +159,10 @@ export async function enqueueAreaMemoryInjection(agent: AgentCard, input: AreaEn
         tokens,
         omitted,
       },
-    });
+    }));
     emitCommandEvent(command, "command.requested");
   }
-  emitRelayInjectionEvent({
+  (await emitRelayInjectionEvent({
     agentId: agent.id,
     category: AREA_MEMORY_REASON,
     summary: areaSummary(input.area, entryIds.length, tokens),
@@ -178,12 +179,12 @@ export async function enqueueAreaMemoryInjection(agent: AgentCard, input: AreaEn
       ...(skipped ? { skipped } : {}),
     },
     timestamp: now,
-  });
+  }));
   return { area: input.area, queued, entryIds, tokens, omitted, ...(input.inline ? { content: selected ? block.content : "" } : {}) };
 }
 
 /** A `memory-area` inject the runner reported delivered: one more event, `delivered: true`. A stale-generation skip is not one. */
-export function settleAreaMemoryCommand(command: Command, now: number = Date.now()): void {
+export async function settleAreaMemoryCommand(command: Command, now: number = Date.now()): Promise<void> {
   if (command.type !== "agent.injectContext" || command.status !== "succeeded" || command.params.reason !== AREA_MEMORY_REASON) return;
   // #3411 — the runner drops an inject queued before a context reset and reports it in providerResult.
   const providerResult = command.result?.providerResult;
@@ -194,7 +195,7 @@ export function settleAreaMemoryCommand(command: Command, now: number = Date.now
   const generation = typeof params.generation === "number" ? params.generation : 0;
   const entryIds = Array.isArray(params.memoryIds) ? params.memoryIds.filter((id): id is string => typeof id === "string") : [];
   const tokens = typeof params.tokens === "number" ? params.tokens : 0;
-  emitRelayInjectionEvent({
+  (await emitRelayInjectionEvent({
     agentId: command.target,
     category: AREA_MEMORY_REASON,
     summary: `${areaSummary(area, entryIds.length, tokens)} delivered`,
@@ -212,5 +213,5 @@ export function settleAreaMemoryCommand(command: Command, now: number = Date.now
     },
     timestamp: now,
     idempotencyKey: `memory-area:${command.id}:settled`,
-  });
+  }));
 }

package/src/memory-boundary-capture.ts

@@ -138,12 +138,12 @@ export function isBoundaryCaptureDefect(clause: BoundaryCaptureClause): boolean
  * abort the boundary AFTER the continuation envelope has already been advanced. Both are strictly
  * worse outcomes than a missing sentence, so every path here ends in a string.
  */
-export function boundaryCaptureClause(input: {
+export async function boundaryCaptureClause(input: {
   seam: BoundaryCaptureSeam;
   agentId: string;
   slug?: string;
   now?: number;
-}): string {
+}): Promise<string> {
   let clause: BoundaryCaptureClause;
   try {
     clause = resolveBoundaryCaptureClause(input.seam, input.slug);
@@ -157,7 +157,7 @@ export function boundaryCaptureClause(input: {
       error: errMessage(error),
     };
   }
-  if (isBoundaryCaptureDefect(clause)) reportBoundaryCaptureDefect(clause, input.agentId, input.now ?? Date.now());
+  if (isBoundaryCaptureDefect(clause)) (await reportBoundaryCaptureDefect(clause, input.agentId, input.now ?? Date.now()));
   return clause.text;
 }
 
@@ -180,9 +180,9 @@ function describeBoundaryCaptureDefect(clause: BoundaryCaptureClause): string {
  * timeline write itself fails there is nowhere left to say so — the boundary still proceeds, which
  * is the outcome that matters.
  */
-function reportBoundaryCaptureDefect(clause: BoundaryCaptureClause, agentId: string, now: number): void {
+async function reportBoundaryCaptureDefect(clause: BoundaryCaptureClause, agentId: string, now: number): Promise<void> {
   try {
-    emitRelayInjectionEvent({
+    (await emitRelayInjectionEvent({
       agentId,
       category: "memory",
       summary: describeBoundaryCaptureDefect(clause),
@@ -198,7 +198,7 @@ function reportBoundaryCaptureDefect(clause: BoundaryCaptureClause, agentId: str
       },
       timestamp: now,
       idempotencyKey: `memory-capture-clause:${clause.seam}:${agentId}:${clause.status}`,
-    });
+    }));
   } catch {
     // Intentionally swallowed: see the doc comment above. A boundary must not fail because its
     // capture ask could not be announced.

package/src/memory-injection.ts

@@ -1,3 +1,5 @@
+import { setConfigAsync } from "./config-store-write";
+import { createCommandAsync } from "./commands-write";
 import { contextInjectUnsupported, launchContextSurvivesCompact, launchSystemPromptAppend } from "./context-injection-channel";
 // #1565 P4b — closing the auto-inject loop at the OTHER two boundaries (design §4.4).
 //
@@ -56,10 +58,10 @@ import { contextInjectUnsupported, launchContextSurvivesCompact, launchSystemPro
 import { createHash } from "node:crypto";
 import { stripRenderedAtLine } from "./context-block-rendered-at";
 import { errMessage, stringValue } from "@humwick/sdk";
-import { createCommand, findLaunchPromptCommandForAgent } from "./commands-db";
+import { findLaunchPromptCommandForAgent } from "./commands-db";
 import { emitCommandEvent } from "./command-events";
 import { REAP_INTERVAL_MS } from "./config";
-import { getConfig, setConfig } from "./config-store";
+import { getConfig } from "./config-store";
 import { findMessageByIdempotencyKey, getAgent, type MemoryIdentity } from "./db";
 import { composeMemoryPreamble, describeInstructionTruncation, describeMemoryDemotions, describeMemoryOmissions, describeUnresolvedInstructions, extractMemoryPreamble, memoryRetractionBlock, unresolvedInstructionSlugs, withMemorySupersedeNotice, type ComposedMemoryPreamble } from "./memory-preamble";
 import {
@@ -124,8 +126,8 @@ export function readMemoryInjectionState(agentId: string): MemoryInjectionState
   return getConfig<MemoryInjectionState>(MEMORY_INJECTION_NAMESPACE, agentId)?.value ?? null;
 }
 
-export function recordMemoryInjectionState(agentId: string, state: MemoryInjectionState): void {
-  setConfig(MEMORY_INJECTION_NAMESPACE, agentId, state, "memory-injection");
+export async function recordMemoryInjectionState(agentId: string, state: MemoryInjectionState): Promise<void> {
+  (await setConfigAsync(MEMORY_INJECTION_NAMESPACE, agentId, state, "memory-injection"));
 }
 
 /** #2591 — the journal gate's "what did this agent last receive" record. Same lifetime rules
@@ -144,8 +146,8 @@ export function readJournalInjectionState(agentId: string): JournalInjectionStat
   return getConfig<JournalInjectionState>(JOURNAL_INJECTION_NAMESPACE, agentId)?.value ?? null;
 }
 
-export function recordJournalInjectionState(agentId: string, state: JournalInjectionState): void {
-  setConfig(JOURNAL_INJECTION_NAMESPACE, agentId, state, "journal-injection");
+export async function recordJournalInjectionState(agentId: string, state: JournalInjectionState): Promise<void> {
+  (await setConfigAsync(JOURNAL_INJECTION_NAMESPACE, agentId, state, "journal-injection"));
 }
 
 /**
@@ -298,7 +300,7 @@ function hasEmptyBlockAccounting(seam: ResolvedMemorySeam, composed: ComposedMem
  * normal outcome (unchanged set, nothing resolvable, provider cannot inject) and is always
  * reported in the `relay-injection` event rather than being inferred from silence.
  */
-export function enqueueMemoryInjectionAfterContextCommand(command: Command, now: number = Date.now()): Command | null {
+export async function enqueueMemoryInjectionAfterContextCommand(command: Command, now: number = Date.now()): Promise<Command | null> {
   // #2291 — the boundary's status answers "did the runner CONFIRM the destructive step", not "did a
   // boundary HAPPEN". This used to read `!== "succeeded"`, which silently dropped the whole memory
   // block on every unconfirmed clear and every timed-out compact: on the live coordinator that was
@@ -335,7 +337,7 @@ export function enqueueMemoryInjectionAfterContextCommand(command: Command, now:
   if (contextInjectUnsupported(agent)) {
     // Declared and logged, never a crash: this agent keeps whatever its spawn put in the system
     // prompt and simply does not get the boundary refresh.
-    emitMemorySkip(agent, event, seam, composed, "inject-unsupported", command, now);
+    (await emitMemorySkip(agent, event, seam, composed, "inject-unsupported", command, now));
     return null;
   }
 
@@ -366,7 +368,7 @@ export function enqueueMemoryInjectionAfterContextCommand(command: Command, now:
     // empty block reached the agent when the spawn-time block is in fact still in its prompt.
     // Nothing needs the write either — the recorded hash is the block the agent LAST RECEIVED, and
     // if memory reappears the composed hash differs from it and the next boundary re-injects.
-    if (hasEmptyBlockAccounting(seam, composed)) emitMemorySkip(agent, event, seam, composed, "nothing-to-inject", command, now);
+    if (hasEmptyBlockAccounting(seam, composed)) (await emitMemorySkip(agent, event, seam, composed, "nothing-to-inject", command, now));
     if (!journal.delivers) return null;
   } else if (event === "compact" && launchContextSurvivesCompact(agent) && launchBakedMemoryHash(agent) === hash) {
     // §4.3(4): a native compact preserves a real system prompt, so a block BAKED there and still
@@ -375,7 +377,7 @@ export function enqueueMemoryInjectionAfterContextCommand(command: Command, now:
     // of this delta skip (#3698). A clear destroys the context — nothing survives it to be unchanged. #2596 —
     // this reads `launchBakedMemoryHash`, NOT the "recorded last delivery" hash: a block that only
     // ever rode a transcript message has no such proof (see that function's doc).
-    emitMemorySkip(agent, event, seam, composed, "unchanged", command, now);
+    (await emitMemorySkip(agent, event, seam, composed, "unchanged", command, now));
     if (!journal.delivers) return null;
   } else {
     memoryDelivers = true;
@@ -414,7 +416,7 @@ export function enqueueMemoryInjectionAfterContextCommand(command: Command, now:
   // keeping its own markers, notice and gate state).
   const content = [memoryContent, journal.content].filter(Boolean).join("\n\n");
   const boundaryKey = command.type === "agent.clearContext" ? { afterClearCommandId: command.id } : { afterCompactCommandId: command.id };
-  const inject = createCommand({
+  const inject = (await createCommandAsync({
     type: "agent.injectContext",
     source: "system",
     target: command.target,
@@ -448,16 +450,16 @@ export function enqueueMemoryInjectionAfterContextCommand(command: Command, now:
         }
         : {}),
     },
-  });
+  }));
   emitCommandEvent(inject, "command.requested");
-  emitRelayInjectionEvent({
+  (await emitRelayInjectionEvent({
     agentId: agent.id,
     category: "memory",
     summary: deliverySummary(event, composed, memoryDelivers, journal),
     detail: injectionDetail(agent, event, seam, composed, { commandId: inject.id, content, seamVerified, ...journalEventDetail(journal) }),
     timestamp: now,
     idempotencyKey: memoryBoundaryEventKey("delivered", agent.id, command.id),
-  });
+  }));
   return inject;
 }
 
@@ -552,8 +554,8 @@ function memoryBoundaryEventKey(outcome: "delivered" | "skipped" | "failed", age
  * swallowed silently: the operator sees the failure on the agent's timeline. The continuation
  * enqueue runs BEFORE this and is untouched by it, which is the ordering that matters.
  */
-export function settleMemoryInjectionAfterContextCommand(command: Command, now: number = Date.now()): Command | null {
-  return containedMemoryInjection(command, now).inject;
+export async function settleMemoryInjectionAfterContextCommand(command: Command, now: number = Date.now()): Promise<Command | null> {
+  return (await containedMemoryInjection(command, now)).inject;
 }
 
 /**
@@ -564,24 +566,24 @@ export function settleMemoryInjectionAfterContextCommand(command: Command, now:
  * both callers share one containment and one error report — a second try/catch in the sweep would
  * be a second place for the reporting to drift.
  */
-function containedMemoryInjection(command: Command, now: number, sweep = false): { inject: Command | null; composeFailed: boolean } {
+async function containedMemoryInjection(command: Command, now: number, sweep = false): Promise<{ inject: Command | null; composeFailed: boolean }> {
   try {
-    const inject = enqueueMemoryInjectionAfterContextCommand(command, now);
-    settleMemoryInjectionCommand(command, now);
-    settleAreaMemoryCommand(command, now);
+    const inject = (await enqueueMemoryInjectionAfterContextCommand(command, now));
+    (await settleMemoryInjectionCommand(command, now));
+    (await settleAreaMemoryCommand(command, now));
     return { inject, composeFailed: false };
   } catch (error) {
     // #2712 — the sweep runs on a fast-fail connection; a held write lock defers the boundary to the
     // next run rather than counting against its compose-failure cap.
     if (sweep && isSqliteBusyError(error)) throw error;
-    emitRelayInjectionEvent({
+    (await emitRelayInjectionEvent({
       agentId: command.target,
       category: "memory",
       summary: `memory re-injection failed to compose after ${command.type === "agent.compact" ? "compact" : command.type === "agent.clearContext" ? "clear" : command.type}: ${errMessage(error)}`,
       detail: { source: "memory-preamble", agentId: command.target, commandId: command.id, failed: true },
       timestamp: now,
       idempotencyKey: memoryBoundaryEventKey("failed", command.target, command.id),
-    });
+    }));
     return { inject: null, composeFailed: true };
   }
 }
@@ -635,12 +637,12 @@ function containedMemoryInjection(command: Command, now: number, sweep = false):
  * continuation sweep's existing policy (redundant beats wiped) applied to a larger payload, not a
  * new one; the runner's `ProviderInputQueue` serializes them rather than dropping any.
  */
-export function sweepMissedMemoryInjections(now: number = Date.now(), signal?: AbortSignal): { enqueuedCommandIds: string[]; aborted?: true } {
+export async function sweepMissedMemoryInjections(now: number = Date.now(), signal?: AbortSignal): Promise<{ enqueuedCommandIds: string[]; aborted?: true }> {
   const enqueuedCommandIds: string[] = [];
   // #1819 — one candidate is the unit; bailing between candidates leaves the rest for the next tick.
   for (const command of newestBoundaryPerAgent(now, signal)) {
     if (signal?.aborted) break;
-    sweepMemoryBoundary(command, now, enqueuedCommandIds);
+    (await sweepMemoryBoundary(command, now, enqueuedCommandIds));
   }
   return { enqueuedCommandIds, ...(signal?.aborted ? { aborted: true as const } : {}) };
 }
@@ -648,27 +650,27 @@ export function sweepMissedMemoryInjections(now: number = Date.now(), signal?: A
 /** #2712 — the job's form of {@link sweepMissedMemoryInjections}: the same units, one macrotask each. */
 async function sweepMissedMemoryInjectionsPaced(now: number, signal?: AbortSignal): Promise<{ enqueuedCommandIds: string[]; aborted?: true; moreWork?: true }> {
   const enqueuedCommandIds: string[] = [];
-  const { moreWork } = await pacedInjectionSweep(() => newestBoundaryPerAgent(now, signal), (command) => sweepMemoryBoundary(command, now, enqueuedCommandIds), signal);
+  const { moreWork } = await pacedInjectionSweep(() => newestBoundaryPerAgent(now, signal), async (command) => (await sweepMemoryBoundary(command, now, enqueuedCommandIds)), signal);
   return { enqueuedCommandIds, ...(signal?.aborted ? { aborted: true as const } : {}), ...(moreWork ? { moreWork: true as const } : {}) };
 }
 
-function sweepMemoryBoundary(command: Command, now: number, enqueuedCommandIds: string[]): void {
+async function sweepMemoryBoundary(command: Command, now: number, enqueuedCommandIds: string[]): Promise<void> {
   const { decision, attempts } = injectionAttemptDecision(command, MEMORY_INJECTION_REASON);
   if (decision === "in-flight") return;
   if (decision === "exhausted") {
-    notifyMemoryInjectionExhausted(command, attempts, now);
+    (await notifyMemoryInjectionExhausted(command, attempts, now));
     return;
   }
   if (attempts === 0 && (sweepAlreadyDecided(command) || boundaryAlreadyDecided(command))) return;
   // Through the CONTAINED enqueue: composing reaches into the store, the ownership seam and
   // cwd→project resolution, and a throw on one agent must not abort the sweep for every agent
   // behind it (the #1565 F8 rationale, one level up).
-  const { inject, composeFailed } = containedMemoryInjection(command, now, true);
+  const { inject, composeFailed } = (await containedMemoryInjection(command, now, true));
   if (inject) {
     enqueuedCommandIds.push(inject.id);
     return;
   }
-  rememberSweepDecision(command, composeFailed, now);
+  (await rememberSweepDecision(command, composeFailed, now));
 }
 
 /**
@@ -752,13 +754,13 @@ function sweepAlreadyDecided(command: Command): boolean {
   return held?.commandId === command.id && held.done;
 }
 
-function rememberSweepDecision(command: Command, composeFailed: boolean, now: number): void {
+async function rememberSweepDecision(command: Command, composeFailed: boolean, now: number): Promise<void> {
   const held = sweptBoundaryDecisions.get(command.target);
   const composeFailures = (held?.commandId === command.id ? held.composeFailures : 0) + (composeFailed ? 1 : 0);
   const done = !composeFailed || composeFailures >= MAX_INJECTION_ATTEMPTS;
   if (sweptBoundaryDecisions.size >= MAX_SWEPT_DECISIONS && !held) sweptBoundaryDecisions.clear();
   sweptBoundaryDecisions.set(command.target, { commandId: command.id, composeFailures, done });
-  if (composeFailed && done) notifyMemoryInjectionExhausted(command, composeFailures, now, "compose");
+  if (composeFailed && done) (await notifyMemoryInjectionExhausted(command, composeFailures, now, "compose"));
 }
 
 export const MEMORY_INJECTION_SWEEP_JOB = {
@@ -785,22 +787,22 @@ function boundaryAlreadyDecided(command: Command): boolean {
  *  exactly the state #2291 showed nobody can infer from silence. The two ways to spend it — the
  *  DELIVERY failing and the COMPOSITION throwing — carry different keys, or the first one reported
  *  would silence the other for the same boundary. */
-function notifyMemoryInjectionExhausted(command: Command, attempts: number, now: number, kind: "delivery" | "compose" = "delivery"): void {
+async function notifyMemoryInjectionExhausted(command: Command, attempts: number, now: number, kind: "delivery" | "compose" = "delivery"): Promise<void> {
   const idempotencyKey = `memory-injection-exhausted${kind === "compose" ? "-compose" : ""}:${command.target}:${command.id}`;
   if (findMessageByIdempotencyKey(command.target, idempotencyKey)) return;
   const event = command.type === "agent.compact" ? "compact" : "clear";
   const what = kind === "compose" ? "failed to compose" : "could not be delivered";
-  emitRelayInjectionEvent({
+  (await emitRelayInjectionEvent({
     agentId: command.target,
     category: "memory",
     summary: `memory re-injection gave up after ${attempts} attempt(s) at a ${event} boundary — it ${what}, so this agent is running without the current block`,
     detail: { source: "memory-preamble", agentId: command.target, commandId: command.id, event, attempts, exhausted: kind },
     timestamp: now,
     idempotencyKey,
-  });
+  }));
 }
 
-function emitMemorySkip(
+async function emitMemorySkip(
   agent: AgentCard,
   event: MemoryInjectionEvent,
   seam: ResolvedMemorySeam,
@@ -808,20 +810,20 @@ function emitMemorySkip(
   skipped: MemoryInjectionSkip,
   command: Command,
   now: number,
-): void {
+): Promise<void> {
   const summaries: Record<MemoryInjectionSkip, string> = {
     unchanged: `memory unchanged after ${event} — re-injection skipped (${entriesLabel(renderedCount(composed))}, ${composed.tokens}t)`,
     "inject-unsupported": `memory NOT re-injected after ${event}: provider declares context.inject:false (spawn-time block only)`,
     "nothing-to-inject": `memory resolved nothing to inject after ${event}${omissionSuffix(composed)}`,
   };
-  emitRelayInjectionEvent({
+  (await emitRelayInjectionEvent({
     agentId: agent.id,
     category: "memory",
     summary: summaries[skipped],
     detail: injectionDetail(agent, event, seam, composed, { skipped, commandId: command.id }),
     timestamp: now,
     idempotencyKey: memoryBoundaryEventKey("skipped", agent.id, command.id),
-  });
+  }));
 }
 
 /**
@@ -836,7 +838,7 @@ function emitMemorySkip(
  * the same only-on-success rule. Each side records only when ITS payload rode the command, so a
  * journal-only delivery never stamps a phantom memory hash (and vice versa).
  */
-export function settleMemoryInjectionCommand(command: Command, now: number = Date.now()): void {
+export async function settleMemoryInjectionCommand(command: Command, now: number = Date.now()): Promise<void> {
   if (command.type !== "agent.injectContext" || command.status !== "succeeded") return;
   if (command.params.reason !== MEMORY_INJECTION_REASON) return;
   const memory = command.params.memory;
@@ -844,13 +846,13 @@ export function settleMemoryInjectionCommand(command: Command, now: number = Dat
     const record = memory as Record<string, unknown>;
     const hash = typeof record.hash === "string" ? record.hash : undefined;
     if (hash !== undefined) {
-      recordMemoryInjectionState(command.target, {
+      (await recordMemoryInjectionState(command.target, {
         hash,
         tokens: typeof record.tokens === "number" ? record.tokens : 0,
         entries: typeof record.entries === "number" ? record.entries : 0,
         event: record.event === "clear" ? "clear" : "compact",
         at: now,
-      });
+      }));
     }
   }
   const journal = command.params.journal;
@@ -858,13 +860,13 @@ export function settleMemoryInjectionCommand(command: Command, now: number = Dat
     const record = journal as Record<string, unknown>;
     const hash = typeof record.hash === "string" ? record.hash : undefined;
     if (hash !== undefined) {
-      recordJournalInjectionState(command.target, {
+      (await recordJournalInjectionState(command.target, {
         hash,
         tokens: typeof record.tokens === "number" ? record.tokens : 0,
         fields: typeof record.fields === "number" ? record.fields : 0,
         event: record.event === "clear" ? "clear" : "compact",
         at: now,
-      });
+      }));
     }
   }
 }

package/src/merge-pause-maintenance.ts

@@ -1,5 +1,6 @@
+import { releaseExpiredMergePausesAsync } from "./db/runtime-tail-async";
 import { REAP_INTERVAL_MS } from "./config";
-import { releaseExpiredMergePauses } from "./db";
+
 
 export const MERGE_PAUSE_MAINTENANCE_JOB = {
   id: "merge-pause-expiration",
@@ -8,12 +9,12 @@ export const MERGE_PAUSE_MAINTENANCE_JOB = {
   description: "Release expired repo/base auto-merge pauses.",
   intervalMs: REAP_INTERVAL_MS,
   runOnStart: true,
-  // #1819 — SYNCHRONOUS, and ONE atomic statement: `releaseExpiredMergePauses` is a single UPDATE …
+  // #1819 — SYNCHRONOUS, and ONE atomic statement: `releaseExpiredMergePausesAsync` is a single UPDATE …
   // RETURNING. There is no interior checkpoint to add — splitting it would mean splitting a
   // transaction — so the pre-flight check is the whole of its cooperation. It cannot overrun a
   // deadline in any realistic fleet; if it ever does, the fix is #1809 offload, not more checks.
-  handler(context: { signal?: AbortSignal }) {
+  async handler(context: { signal?: AbortSignal }) {
     if (context.signal?.aborted) return { releasedMergePauseIds: [], aborted: true };
-    return { releasedMergePauseIds: releaseExpiredMergePauses() };
+    return { releasedMergePauseIds: (await releaseExpiredMergePausesAsync()) };
   },
 };

package/src/notification-router.ts

@@ -1,9 +1,13 @@
+import { randomUUID } from "node:crypto";
 import { isRecord } from "@humwick/sdk";
-import { notifySystemMessageWithResult } from "./notify";
-import { createActivityEvent, getAgent, getMessage } from "./db";
+import { getGateway } from "./db/gateway";
+import { emitNewMessage } from "./sse";
+import type { SendMessageResult } from "./db/messages";
+import type { AgentNoticeSlot } from "./db/terminal-events";
+import { createActivityEventAsync, getAgent, getMessage } from "./db";
 import { optedInNotificationRecipients, subscriptionDecisionFor } from "./db/notification-subscriptions";
 import { notificationEnabledFor } from "./notification-settings-store";
-import type { Message, MessageKind, NotificationRoutingExplanation, NotificationRoutingPreview, NotificationRoutingRecipientInput } from "./types";
+import type { Message, SendMessageInput, MessageKind, NotificationRoutingExplanation, NotificationRoutingPreview, NotificationRoutingRecipientInput } from "./types";
 import { DEFAULT_TTL_MS } from "./notification-types";
 import type { NotificationScope, NotificationType } from "./notification-types";
 import { isNotificationSuppressedForRole, notificationTarget, resolveAudience } from "./notification-rules";
@@ -89,17 +93,33 @@ function effectiveTtlMs(type: NotificationType, ttlMs: number | null | undefined
  * Recipients are de-duplicated and emptied of falsy entries, so emitters can pass optional ids
  * without guarding. A notification with zero resolved recipients is a no-op.
  */
-export function routeNotification(input: RouteNotificationInput): Message[] {
+export async function routeNotification(input: RouteNotificationInput): Promise<Message[]> {
+  const { inputs, preview, maxAgeSeconds } = prepareNotification(input);
+  if (!inputs.length) return [];
+  const results = await getGateway().write("notifications.route", { inputs }, { critical: true, idempotencyKey: randomUUID() }) as unknown as SendMessageResult[];
+  await emitNotificationResults(results, preview, maxAgeSeconds);
+  return results.map(result => result.message);
+}
+
+/** #1870 — the generation slot and every recipient message commit in one writer transaction. */
+export async function routeAgentNotice(slot: AgentNoticeSlot, input?: RouteNotificationInput): Promise<boolean> {
+  const prepared = input ? prepareNotification(input) : undefined;
+  const result = await getGateway().write("notifications.agentNotice", { slot, inputs: prepared?.inputs ?? [] }, { critical: true, idempotencyKey: randomUUID() }) as unknown as { created: boolean; results: SendMessageResult[] };
+  if (prepared) await emitNotificationResults(result.results, prepared.preview, prepared.maxAgeSeconds);
+  return result.created;
+}
+
+function prepareNotification(input: RouteNotificationInput) {
   const ttl = effectiveTtlMs(input.type, input.ttlMs);
   const emittedAt = input.emittedAt ?? Date.now();
 
   // Staleness guard (#451): if the triggering event is already older than its TTL, drop before
   // sending. On the normal synchronous path emittedAt ≈ now so this rarely fires, but it makes the
   // router correct for any caller that routes a delayed/replayed event.
-  if (ttl !== null && Date.now() - emittedAt > ttl) return [];
+  if (ttl !== null && Date.now() - emittedAt > ttl) return { inputs: [], preview: previewNotificationRouting({ ...input, recipients: [] }), maxAgeSeconds: null };
 
   const preview = previewNotificationRouting(input);
-  if (preview.recipients.length === 0) return [];
+
 
   // Stamp the TTL on the message so the delivery/poll path (pollMessages) enforces it for offline
   // or late-joining recipients too. An explicit `null` (never-expire) is authoritative: it suppresses
@@ -107,7 +127,8 @@ export function routeNotification(input: RouteNotificationInput): Message[] {
   // never-expire intent instead of inheriting the moderate baseline.
   const maxAgeSeconds = ttl === null ? null : Math.max(1, Math.ceil(ttl / 1000));
 
-  return preview.recipients.map((routing) => {
+  const inputs: SendMessageInput[] = [];
+  for (const routing of preview.recipients) {
     const meta = getAgent(routing.recipient)?.meta;
     const channel = meta?.kind === "channel" ? meta : undefined;
     const notificationPayload = {
@@ -115,7 +136,8 @@ export function routeNotification(input: RouteNotificationInput): Message[] {
       ...(input.message.wake === false ? { wake: false } : {}),
       routing: compactRoutingExplanation(routing),
     };
-    const result = notifySystemMessageWithResult(routing.recipient, {
+    inputs.push({
+      to: routing.recipient,
       subject: input.message.subject,
       body: input.message.body,
       payload: channel ? {
@@ -124,16 +146,21 @@ export function routeNotification(input: RouteNotificationInput): Message[] {
         event: { title: input.message.subject, body: input.message.body, notification: notificationPayload },
       } : notificationPayload,
       idempotencyKey: recipientScopedIdempotencyKey(input.message.idempotencyKey, routing.recipient),
-      kind: channel ? "channel.event" : input.message.kind,
-      from: input.message.from,
+      kind: channel ? "channel.event" : input.message.kind ?? "system",
+      from: input.message.from ?? "system",
       replyExpected: channel ? false : input.message.replyExpected,
       maxAgeSeconds,
     });
-    // The message idempotency key is the transition ledger. A retry that resolves to the existing
-    // message must not manufacture another "Notification routed" activity row (#2365).
-    if (result.created || result.updated) auditRoutingTrace(result.message, preview, maxAgeSeconds);
-    return result.message;
-  });
+  }
+  return { inputs, preview, maxAgeSeconds };
+}
+
+async function emitNotificationResults(results: SendMessageResult[], preview: NotificationRoutingPreview, maxAgeSeconds: number | null): Promise<void> {
+  for (const result of results) {
+    if (!result.created && !result.updated) continue;
+    emitNewMessage(result.message);
+    await auditRoutingTrace(result.message, preview, maxAgeSeconds);
+  }
 }
 
 function recipientScopedIdempotencyKey(key: string | undefined, recipient: string): string | undefined {
@@ -301,9 +328,9 @@ function routingExplanationFromPayload(value: unknown): NotificationRoutingExpla
   };
 }
 
-function auditRoutingTrace(message: Message, preview: NotificationRoutingPreview, maxAgeSeconds: number | null): void {
+async function auditRoutingTrace(message: Message, preview: NotificationRoutingPreview, maxAgeSeconds: number | null): Promise<void> {
   try {
-    createActivityEvent({
+    await createActivityEventAsync({
       clientId: `notification-route-${message.id}`,
       kind: "state",
       title: "Notification routed",

package/src/notification-types.ts

@@ -97,7 +97,8 @@ export type NotificationType =
   | "ci.config_mismatch"
   | "ci.root_missing"
   // #1645 — a critical maintenance job is not running (disabled, held indefinitely, a lapsed pause
-  // nobody resumed, or simply silent past several of its own intervals).
+  // nobody resumed, or simply silent past several of its own intervals). Also carries host disk
+  // alerts (#3762) — a new type would grow three MCP tool schemas past their pinned budgets.
   | "maintenance.degraded";
 
 /**

package/src/notify.ts

@@ -1,4 +1,4 @@
-import { sendMessageWithResult } from "./db";
+import { sendMessageWithResultAsync } from "./db/message-send";
 import { emitNewMessage } from "./sse";
 import type { Message, MessageKind } from "./types";
 
@@ -33,13 +33,13 @@ interface SystemNotifyOptions {
  * "relay tells an agent something happened" — store-ahead delivers it on next poll if the
  * recipient is offline (#234). Used by the GC sweep (maintenance) and lifecycle events (#239).
  */
-export function notifySystemMessage(to: string, opts: SystemNotifyOptions): Message {
-  return notifySystemMessageWithResult(to, opts).message;
+export async function notifySystemMessage(to: string, opts: SystemNotifyOptions): Promise<Message> {
+  return (await notifySystemMessageWithResult(to, opts)).message;
 }
 
 /** Same send seam with creation provenance for callers that own one-shot side effects/audits. */
-export function notifySystemMessageWithResult(to: string, opts: SystemNotifyOptions) {
-  const result = sendMessageWithResult({
+export async function notifySystemMessageWithResult(to: string, opts: SystemNotifyOptions) {
+  const result = await sendMessageWithResultAsync({
     from: opts.from ?? "system",
     to,
     kind: opts.kind ?? "system",

package/src/observed-reset-refresh.ts

@@ -8,14 +8,14 @@ import { settleStartupContextInjectionAfterContextCommand } from "./startup-cont
 /** #3698 — a `/clear` typed into the provider, or its auto-compaction, keeps the process and its
  *  launch-baked system prompt. Refresh identity, memory + journal and startup context through the
  *  SAME seams a commanded clear/compact settles; each is idempotent per boundary id. Never throws. */
-export function refreshContextAfterObservedReset(reset: ObservedContextReset, now: number = Date.now()): void {
+export async function refreshContextAfterObservedReset(reset: ObservedContextReset, now: number = Date.now()): Promise<void> {
   const boundary = observedResetBoundary(reset);
   try {
-    enqueueLifecycleIdentityInjectionAfterContextCommand(boundary);
+    (await enqueueLifecycleIdentityInjectionAfterContextCommand(boundary));
   } catch (error) {
     console.error(`#3698 identity refresh after observed ${reset.kind} ${reset.resetId} for ${reset.agentId} failed: ${errMessage(error)}`);
   }
   // Both contained: they report their own failures on the agent's timeline.
-  settleMemoryInjectionAfterContextCommand(boundary, now);
-  settleStartupContextInjectionAfterContextCommand(boundary, now);
+  (await settleMemoryInjectionAfterContextCommand(boundary, now));
+  (await settleStartupContextInjectionAfterContextCommand(boundary, now));
 }