@ixo/oracle-runtime-workers 0.20.0 → 0.20.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ixo/oracle-runtime-workers",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "description": "QiForge oracle runtime for Cloudflare Workers — Durable Object per user (SQLite in WASM over DO storage), Matrix E2EE gateway Durable Object, Hono HTTP/SSE shell.",
   "private": false,
   "publishConfig": {
@@ -58,8 +58,8 @@
     "wa-sqlite": "1.0.0",
     "yjs": "13.6.32",
     "zod": "^4.4.3",
-    "@ixo/common": "1.7.0",
     "@ixo/ixo-transaction": "0.1.0",
+    "@ixo/common": "1.7.0",
     "@ixo/ucan": "2.2.1"
   },
   "devDependencies": {

package/src/do/user-oracle-do.ts

@@ -3253,6 +3253,7 @@ export function createUserOracleDO(opts: UserOracleDOOptions) {
       keepGathering();
       return async (onSlow, signal) => {
         if (signal.aborted) return undefined;
+        const waitedFrom = Date.now();
         const timer = setTimeout(onSlow, USER_CONTEXT_PROGRESS_GRACE_MS);
         let onAbort: (() => void) | undefined;
         const aborted = new Promise<undefined>((resolve) => {
@@ -3261,6 +3262,12 @@ export function createUserOracleDO(opts: UserOracleDOOptions) {
         });
         try {
           const outcome = await Promise.race([pending, aborted]);
+          // One line per first contact, at warn so it stands out when logs
+          // are read at warn and above: what the turn was given and how
+          // long it waited for it.
+          console.warn(
+            `[user-context] first contact room=${input.roomId} session=${input.sessionId} outcome=${outcome?.kind ?? 'aborted'} waited=${Date.now() - waitedFrom}ms`,
+          );
           return outcome?.kind === 'cached' || outcome?.kind === 'fresh'
             ? withEverySlot(outcome.context)
             : undefined;

package/src/memory/user-context-fetcher.ts

@@ -557,8 +557,18 @@ type GatherResult = Extract<
 
 interface InFlightGather {
   promise: Promise<GatherResult>;
+  /** `now()` when the gather started; a gather older than its request timeout plus grace is treated as lost. */
+  startedAt: number;
 }
 
+/**
+ * Grace past `requestTimeoutMs` before an unsettled gather is given up on.
+ * A gather settles within its request timeout; one that has not after this
+ * long never will (its request context is gone), and a room must not keep
+ * joining it.
+ */
+const STALE_GATHER_GRACE_MS = 5_000;
+
 function describe(err: unknown): string {
   return err instanceof Error ? err.message : String(err);
 }
@@ -769,7 +779,18 @@ export class UserContextFetcher {
     }
 
     const existing = this.inFlight.get(roomId);
-    if (existing) return existing;
+    if (existing) {
+      const ageMs = this.now() - existing.startedAt;
+      if (ageMs <= this.requestTimeoutMs + STALE_GATHER_GRACE_MS) {
+        return existing;
+      }
+      // Lost: never settled within its own timeout. Detach it (a late
+      // settle must not repopulate the room) and gather again.
+      logger.warn(
+        `[user-context] gather for room=${roomId} unsettled after ${ageMs}ms; starting a new one`,
+      );
+      this.inFlight.delete(roomId);
+    }
 
     if (this.recentlyFailed(roomId)) {
       logger.log(
@@ -785,6 +806,7 @@ export class UserContextFetcher {
     }
 
     const entry: InFlightGather = {
+      startedAt: this.now(),
       promise: this.gather(engineUrl, roomId).then(
         (result) => this.settle(roomId, entry, result),
         (err: unknown) =>