@athenaintel/react 0.43.0 → 0.48.0

package/dist/collab/document-status.cjs

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const offlineStatus = require("../agent-runtime/src/offline-status.cjs");
+const DOCUMENT_STATUS_REFRESH_MS = 5 * 6e4;
+const DOCUMENT_STATUS_REFUSED_REFRESH_MS = 6e4;
+const DOCUMENT_STATUS_READ_TIMEOUT_MS = 3e4;
+function settleWithin({
+  promise,
+  timeoutMs
+}) {
+  return new Promise((resolve) => {
+    const timer = setTimeout(() => resolve(null), timeoutMs);
+    promise.then(
+      (value) => {
+        clearTimeout(timer);
+        resolve(value);
+      },
+      () => {
+        clearTimeout(timer);
+        resolve(null);
+      }
+    );
+  });
+}
+function pageHidden() {
+  return typeof document !== "undefined" && document.visibilityState === "hidden";
+}
+function watchDocumentStatus({
+  read,
+  currentGrant,
+  onChange
+}) {
+  let connected = false;
+  let unconfirmed = false;
+  let writesRefused = false;
+  let reading = false;
+  let readAgain = false;
+  let destroyed = false;
+  let stallRead = false;
+  let stallTimer = null;
+  let cadenceTimer = null;
+  const clearStallTimer = () => {
+    if (stallTimer !== null) {
+      clearTimeout(stallTimer);
+      stallTimer = null;
+    }
+  };
+  const clearCadenceTimer = () => {
+    if (cadenceTimer !== null) {
+      clearTimeout(cadenceTimer);
+      cadenceTimer = null;
+    }
+  };
+  const setWritesRefused = (next) => {
+    if (next === writesRefused) return;
+    writesRefused = next;
+    onChange();
+  };
+  const scheduleCadence = () => {
+    clearCadenceTimer();
+    if (destroyed || !connected) return;
+    cadenceTimer = setTimeout(
+      () => {
+        cadenceTimer = null;
+        if (pageHidden()) {
+          scheduleCadence();
+          return;
+        }
+        void readStatus();
+      },
+      writesRefused ? DOCUMENT_STATUS_REFUSED_REFRESH_MS : DOCUMENT_STATUS_REFRESH_MS
+    );
+  };
+  async function readStatus() {
+    if (destroyed || !connected) return;
+    if (reading) {
+      readAgain = true;
+      return;
+    }
+    const grant = currentGrant();
+    if (grant === null) return;
+    clearCadenceTimer();
+    if (grant.access_type !== "rw") {
+      setWritesRefused(false);
+      return;
+    }
+    reading = true;
+    const answer = await settleWithin({
+      promise: read({ grant }),
+      timeoutMs: DOCUMENT_STATUS_READ_TIMEOUT_MS
+    });
+    reading = false;
+    if (destroyed) return;
+    setWritesRefused((answer == null ? void 0 : answer.writesRefused) === true);
+    if (readAgain) {
+      readAgain = false;
+      void readStatus();
+      return;
+    }
+    scheduleCadence();
+  }
+  const stallChanged = () => {
+    if (!connected || !unconfirmed) {
+      clearStallTimer();
+      stallRead = false;
+      return;
+    }
+    if (stallTimer !== null || stallRead || destroyed) return;
+    stallTimer = setTimeout(() => {
+      stallTimer = null;
+      stallRead = true;
+      void readStatus();
+    }, offlineStatus.UNCONFIRMED_EDITS_STALL_MS);
+  };
+  return {
+    get writesRefused() {
+      return writesRefused;
+    },
+    connected: ({ readNow }) => {
+      if (destroyed) return;
+      connected = true;
+      stallChanged();
+      if (readNow) {
+        void readStatus();
+      } else if (cadenceTimer === null && !reading) {
+        scheduleCadence();
+      }
+    },
+    disconnected: () => {
+      connected = false;
+      clearCadenceTimer();
+      stallChanged();
+    },
+    unconfirmedChanged: (next) => {
+      if (next === unconfirmed) return;
+      unconfirmed = next;
+      stallChanged();
+    },
+    destroy: () => {
+      destroyed = true;
+      clearStallTimer();
+      clearCadenceTimer();
+    }
+  };
+}
+exports.DOCUMENT_STATUS_READ_TIMEOUT_MS = DOCUMENT_STATUS_READ_TIMEOUT_MS;
+exports.DOCUMENT_STATUS_REFRESH_MS = DOCUMENT_STATUS_REFRESH_MS;
+exports.DOCUMENT_STATUS_REFUSED_REFRESH_MS = DOCUMENT_STATUS_REFUSED_REFRESH_MS;
+exports.watchDocumentStatus = watchDocumentStatus;
+//# sourceMappingURL=document-status.cjs.map

package/dist/collab/document-status.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-status.cjs","sources":["../../src/collab/document-status.ts"],"sourcesContent":["/**\n * Keryx's document status for a room `connectGenericDoc` holds: whether Keryx takes the room's\n * writes for now. A quarantined room takes none (doc 20 track 0.6): its sockets are re-checked and\n * reconnect read-only, and Keryx drops a read-only socket's edits without a word, so the transport\n * alone only ever sees them unconfirmed and a chip would say \"Saving…\" for ever. Keryx says so\n * through `GET /document-status/{org}/{docid}` (`keryx/src/document-status.ts`), which answers no\n * cross-origin page, so the host reads it for the handle with the room's own grant\n * (`readDocumentStatus`): Midas through main, the phone's editor page through the app.\n *\n * The handle reads it when Olympus's room does (`olympus/src/providers/keryx-document-status-query.ts`):\n * - on its first connection, so a room opened while quarantined says so at once;\n * - on the connection that follows Keryx's auth re-check close (4401, which a quarantine and a\n *   release both send once the marker is written or cleared), and on one that follows an outage\n *   the handle itself treats as real (no socket for `offlineGateAfterMs`), never on an ordinary\n *   reconnect: a Keryx deploy reconnects every room at once;\n * - once local edits have waited unconfirmed for `UNCONFIRMED_EDITS_STALL_MS` on a connected\n *   socket (a room opened while quarantined is bounced by nothing), once per stall;\n * - on Olympus's cadence while connected and the page is shown: every five minutes, every minute\n *   while Keryx says the room takes no writes, so the chip clears soon after a release that bounced\n *   no socket.\n *\n * One read at a time, each given up after `DOCUMENT_STATUS_READ_TIMEOUT_MS`, and none on a\n * read-only grant (nothing it sends could be refused). A read that can't answer reads as \"takes\n * writes\": never a delay Keryx did not assert.\n */\n\nimport { UNCONFIRMED_EDITS_STALL_MS } from '@athenaintel/agent-runtime/offline-status';\nimport type { CollabTokenResponse } from './mint';\n\n/** What a host read of Keryx's document status for the room. */\nexport interface DocumentStatusReading {\n  /** Keryx takes no writes to the room for now (quarantined while it is repaired). */\n  writesRefused: boolean;\n}\n\n/**\n * Reads Keryx's document status with the grant the room connects with (its token, room and branch:\n * `GET /document-status/{org}/{doc_id}?yauth=&branch=` on the grant's Keryx), so it reads nothing\n * the room's own permission does not. `null` when it can't answer: a Keryx or a host that predates\n * the route, a refusal, a failure. It must settle; the handle stops waiting after\n * {@link DOCUMENT_STATUS_READ_TIMEOUT_MS}.\n */\nexport type ReadDocumentStatus = (params: {\n  grant: CollabTokenResponse;\n}) => Promise<DocumentStatusReading | null>;\n\n/** How often a connected room reads its status while Keryx takes its writes: Olympus's cadence. */\nexport const DOCUMENT_STATUS_REFRESH_MS = 5 * 60_000;\n/** How often it reads while Keryx refuses them, so a release is heard soon after. */\nexport const DOCUMENT_STATUS_REFUSED_REFRESH_MS = 60_000;\n/** How long the handle waits for one read before it gives up on it. */\nexport const DOCUMENT_STATUS_READ_TIMEOUT_MS = 30_000;\n\n/** What the handle tells its document-status reads about its connection. */\nexport interface DocumentStatusWatch {\n  /** Keryx's last answer says the room takes no writes. */\n  readonly writesRefused: boolean;\n  /** The room's socket connected; `readNow`: a connection that reads the status at once. */\n  connected: (params: { readNow: boolean }) => void;\n  /** The room's socket is down: nothing is read until it connects again. */\n  disconnected: () => void;\n  /** Whether local edits wait unconfirmed. */\n  unconfirmedChanged: (unconfirmed: boolean) => void;\n  destroy: () => void;\n}\n\n/** `promise`'s value, or `null` once it rejects or `timeoutMs` passes first. */\nfunction settleWithin<T>({\n  promise,\n  timeoutMs,\n}: {\n  promise: Promise<T>;\n  timeoutMs: number;\n}): Promise<T | null> {\n  return new Promise((resolve) => {\n    const timer = setTimeout(() => resolve(null), timeoutMs);\n    promise.then(\n      (value) => {\n        clearTimeout(timer);\n        resolve(value);\n      },\n      () => {\n        clearTimeout(timer);\n        resolve(null);\n      }\n    );\n  });\n}\n\n/** The page is hidden (a cadence read skips its turn, as TanStack's interval does off screen). */\nfunction pageHidden(): boolean {\n  return typeof document !== 'undefined' && document.visibilityState === 'hidden';\n}\n\nexport function watchDocumentStatus({\n  read,\n  currentGrant,\n  onChange,\n}: {\n  read: ReadDocumentStatus;\n  /** The grant the room's socket connects with now. */\n  currentGrant: () => CollabTokenResponse | null;\n  /** `writesRefused` changed. */\n  onChange: () => void;\n}): DocumentStatusWatch {\n  let connected = false;\n  let unconfirmed = false;\n  let writesRefused = false;\n  let reading = false;\n  let readAgain = false;\n  let destroyed = false;\n  /** The current stall (edits unconfirmed on a connected socket) has had its read. */\n  let stallRead = false;\n  let stallTimer: ReturnType<typeof setTimeout> | null = null;\n  let cadenceTimer: ReturnType<typeof setTimeout> | null = null;\n\n  const clearStallTimer = () => {\n    if (stallTimer !== null) {\n      clearTimeout(stallTimer);\n      stallTimer = null;\n    }\n  };\n\n  const clearCadenceTimer = () => {\n    if (cadenceTimer !== null) {\n      clearTimeout(cadenceTimer);\n      cadenceTimer = null;\n    }\n  };\n\n  const setWritesRefused = (next: boolean) => {\n    if (next === writesRefused) return;\n    writesRefused = next;\n    onChange();\n  };\n\n  const scheduleCadence = () => {\n    clearCadenceTimer();\n    if (destroyed || !connected) return;\n    cadenceTimer = setTimeout(\n      () => {\n        cadenceTimer = null;\n        if (pageHidden()) {\n          scheduleCadence();\n          return;\n        }\n        void readStatus();\n      },\n      writesRefused ? DOCUMENT_STATUS_REFUSED_REFRESH_MS : DOCUMENT_STATUS_REFRESH_MS\n    );\n  };\n\n  async function readStatus(): Promise<void> {\n    if (destroyed || !connected) return;\n    if (reading) {\n      readAgain = true;\n      return;\n    }\n    const grant = currentGrant();\n    if (grant === null) return;\n    clearCadenceTimer();\n    if (grant.access_type !== 'rw') {\n      // A read-only grant sends nothing Keryx could refuse: there is no saving to delay.\n      setWritesRefused(false);\n      return;\n    }\n    reading = true;\n    const answer = await settleWithin({\n      promise: read({ grant }),\n      timeoutMs: DOCUMENT_STATUS_READ_TIMEOUT_MS,\n    });\n    reading = false;\n    if (destroyed) return;\n    setWritesRefused(answer?.writesRefused === true);\n    if (readAgain) {\n      readAgain = false;\n      void readStatus();\n      return;\n    }\n    scheduleCadence();\n  }\n\n  const stallChanged = () => {\n    if (!connected || !unconfirmed) {\n      clearStallTimer();\n      stallRead = false;\n      return;\n    }\n    if (stallTimer !== null || stallRead || destroyed) return;\n    stallTimer = setTimeout(() => {\n      stallTimer = null;\n      stallRead = true;\n      void readStatus();\n    }, UNCONFIRMED_EDITS_STALL_MS);\n  };\n\n  return {\n    get writesRefused() {\n      return writesRefused;\n    },\n    connected: ({ readNow }) => {\n      if (destroyed) return;\n      connected = true;\n      stallChanged();\n      if (readNow) {\n        void readStatus();\n      } else if (cadenceTimer === null && !reading) {\n        scheduleCadence();\n      }\n    },\n    disconnected: () => {\n      connected = false;\n      clearCadenceTimer();\n      stallChanged();\n    },\n    unconfirmedChanged: (next) => {\n      if (next === unconfirmed) return;\n      unconfirmed = next;\n      stallChanged();\n    },\n    destroy: () => {\n      destroyed = true;\n      clearStallTimer();\n      clearCadenceTimer();\n    },\n  };\n}\n"],"names":["UNCONFIRMED_EDITS_STALL_MS"],"mappings":"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"}

package/dist/collab/document-status.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Keryx's document status for a room `connectGenericDoc` holds: whether Keryx takes the room's
+ * writes for now. A quarantined room takes none (doc 20 track 0.6): its sockets are re-checked and
+ * reconnect read-only, and Keryx drops a read-only socket's edits without a word, so the transport
+ * alone only ever sees them unconfirmed and a chip would say "Saving…" for ever. Keryx says so
+ * through `GET /document-status/{org}/{docid}` (`keryx/src/document-status.ts`), which answers no
+ * cross-origin page, so the host reads it for the handle with the room's own grant
+ * (`readDocumentStatus`): Midas through main, the phone's editor page through the app.
+ *
+ * The handle reads it when Olympus's room does (`olympus/src/providers/keryx-document-status-query.ts`):
+ * - on its first connection, so a room opened while quarantined says so at once;
+ * - on the connection that follows Keryx's auth re-check close (4401, which a quarantine and a
+ *   release both send once the marker is written or cleared), and on one that follows an outage
+ *   the handle itself treats as real (no socket for `offlineGateAfterMs`), never on an ordinary
+ *   reconnect: a Keryx deploy reconnects every room at once;
+ * - once local edits have waited unconfirmed for `UNCONFIRMED_EDITS_STALL_MS` on a connected
+ *   socket (a room opened while quarantined is bounced by nothing), once per stall;
+ * - on Olympus's cadence while connected and the page is shown: every five minutes, every minute
+ *   while Keryx says the room takes no writes, so the chip clears soon after a release that bounced
+ *   no socket.
+ *
+ * One read at a time, each given up after `DOCUMENT_STATUS_READ_TIMEOUT_MS`, and none on a
+ * read-only grant (nothing it sends could be refused). A read that can't answer reads as "takes
+ * writes": never a delay Keryx did not assert.
+ */
+import type { CollabTokenResponse } from './mint';
+/** What a host read of Keryx's document status for the room. */
+export interface DocumentStatusReading {
+    /** Keryx takes no writes to the room for now (quarantined while it is repaired). */
+    writesRefused: boolean;
+}
+/**
+ * Reads Keryx's document status with the grant the room connects with (its token, room and branch:
+ * `GET /document-status/{org}/{doc_id}?yauth=&branch=` on the grant's Keryx), so it reads nothing
+ * the room's own permission does not. `null` when it can't answer: a Keryx or a host that predates
+ * the route, a refusal, a failure. It must settle; the handle stops waiting after
+ * {@link DOCUMENT_STATUS_READ_TIMEOUT_MS}.
+ */
+export type ReadDocumentStatus = (params: {
+    grant: CollabTokenResponse;
+}) => Promise<DocumentStatusReading | null>;
+/** How often a connected room reads its status while Keryx takes its writes: Olympus's cadence. */
+export declare const DOCUMENT_STATUS_REFRESH_MS: number;
+/** How often it reads while Keryx refuses them, so a release is heard soon after. */
+export declare const DOCUMENT_STATUS_REFUSED_REFRESH_MS = 60000;
+/** How long the handle waits for one read before it gives up on it. */
+export declare const DOCUMENT_STATUS_READ_TIMEOUT_MS = 30000;
+/** What the handle tells its document-status reads about its connection. */
+export interface DocumentStatusWatch {
+    /** Keryx's last answer says the room takes no writes. */
+    readonly writesRefused: boolean;
+    /** The room's socket connected; `readNow`: a connection that reads the status at once. */
+    connected: (params: {
+        readNow: boolean;
+    }) => void;
+    /** The room's socket is down: nothing is read until it connects again. */
+    disconnected: () => void;
+    /** Whether local edits wait unconfirmed. */
+    unconfirmedChanged: (unconfirmed: boolean) => void;
+    destroy: () => void;
+}
+export declare function watchDocumentStatus({ read, currentGrant, onChange, }: {
+    read: ReadDocumentStatus;
+    /** The grant the room's socket connects with now. */
+    currentGrant: () => CollabTokenResponse | null;
+    /** `writesRefused` changed. */
+    onChange: () => void;
+}): DocumentStatusWatch;

package/dist/collab/document-status.js

@@ -0,0 +1,150 @@
+import { UNCONFIRMED_EDITS_STALL_MS } from "../agent-runtime/src/offline-status.js";
+const DOCUMENT_STATUS_REFRESH_MS = 5 * 6e4;
+const DOCUMENT_STATUS_REFUSED_REFRESH_MS = 6e4;
+const DOCUMENT_STATUS_READ_TIMEOUT_MS = 3e4;
+function settleWithin({
+  promise,
+  timeoutMs
+}) {
+  return new Promise((resolve) => {
+    const timer = setTimeout(() => resolve(null), timeoutMs);
+    promise.then(
+      (value) => {
+        clearTimeout(timer);
+        resolve(value);
+      },
+      () => {
+        clearTimeout(timer);
+        resolve(null);
+      }
+    );
+  });
+}
+function pageHidden() {
+  return typeof document !== "undefined" && document.visibilityState === "hidden";
+}
+function watchDocumentStatus({
+  read,
+  currentGrant,
+  onChange
+}) {
+  let connected = false;
+  let unconfirmed = false;
+  let writesRefused = false;
+  let reading = false;
+  let readAgain = false;
+  let destroyed = false;
+  let stallRead = false;
+  let stallTimer = null;
+  let cadenceTimer = null;
+  const clearStallTimer = () => {
+    if (stallTimer !== null) {
+      clearTimeout(stallTimer);
+      stallTimer = null;
+    }
+  };
+  const clearCadenceTimer = () => {
+    if (cadenceTimer !== null) {
+      clearTimeout(cadenceTimer);
+      cadenceTimer = null;
+    }
+  };
+  const setWritesRefused = (next) => {
+    if (next === writesRefused) return;
+    writesRefused = next;
+    onChange();
+  };
+  const scheduleCadence = () => {
+    clearCadenceTimer();
+    if (destroyed || !connected) return;
+    cadenceTimer = setTimeout(
+      () => {
+        cadenceTimer = null;
+        if (pageHidden()) {
+          scheduleCadence();
+          return;
+        }
+        void readStatus();
+      },
+      writesRefused ? DOCUMENT_STATUS_REFUSED_REFRESH_MS : DOCUMENT_STATUS_REFRESH_MS
+    );
+  };
+  async function readStatus() {
+    if (destroyed || !connected) return;
+    if (reading) {
+      readAgain = true;
+      return;
+    }
+    const grant = currentGrant();
+    if (grant === null) return;
+    clearCadenceTimer();
+    if (grant.access_type !== "rw") {
+      setWritesRefused(false);
+      return;
+    }
+    reading = true;
+    const answer = await settleWithin({
+      promise: read({ grant }),
+      timeoutMs: DOCUMENT_STATUS_READ_TIMEOUT_MS
+    });
+    reading = false;
+    if (destroyed) return;
+    setWritesRefused((answer == null ? void 0 : answer.writesRefused) === true);
+    if (readAgain) {
+      readAgain = false;
+      void readStatus();
+      return;
+    }
+    scheduleCadence();
+  }
+  const stallChanged = () => {
+    if (!connected || !unconfirmed) {
+      clearStallTimer();
+      stallRead = false;
+      return;
+    }
+    if (stallTimer !== null || stallRead || destroyed) return;
+    stallTimer = setTimeout(() => {
+      stallTimer = null;
+      stallRead = true;
+      void readStatus();
+    }, UNCONFIRMED_EDITS_STALL_MS);
+  };
+  return {
+    get writesRefused() {
+      return writesRefused;
+    },
+    connected: ({ readNow }) => {
+      if (destroyed) return;
+      connected = true;
+      stallChanged();
+      if (readNow) {
+        void readStatus();
+      } else if (cadenceTimer === null && !reading) {
+        scheduleCadence();
+      }
+    },
+    disconnected: () => {
+      connected = false;
+      clearCadenceTimer();
+      stallChanged();
+    },
+    unconfirmedChanged: (next) => {
+      if (next === unconfirmed) return;
+      unconfirmed = next;
+      stallChanged();
+    },
+    destroy: () => {
+      destroyed = true;
+      clearStallTimer();
+      clearCadenceTimer();
+    }
+  };
+}
+export {
+  DOCUMENT_STATUS_READ_TIMEOUT_MS,
+  DOCUMENT_STATUS_REFRESH_MS,
+  DOCUMENT_STATUS_REFUSED_REFRESH_MS,
+  watchDocumentStatus
+};
+//# sourceMappingURL=document-status.js.map

package/dist/collab/document-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-status.js","sources":["../../src/collab/document-status.ts"],"sourcesContent":["/**\n * Keryx's document status for a room `connectGenericDoc` holds: whether Keryx takes the room's\n * writes for now. A quarantined room takes none (doc 20 track 0.6): its sockets are re-checked and\n * reconnect read-only, and Keryx drops a read-only socket's edits without a word, so the transport\n * alone only ever sees them unconfirmed and a chip would say \"Saving…\" for ever. Keryx says so\n * through `GET /document-status/{org}/{docid}` (`keryx/src/document-status.ts`), which answers no\n * cross-origin page, so the host reads it for the handle with the room's own grant\n * (`readDocumentStatus`): Midas through main, the phone's editor page through the app.\n *\n * The handle reads it when Olympus's room does (`olympus/src/providers/keryx-document-status-query.ts`):\n * - on its first connection, so a room opened while quarantined says so at once;\n * - on the connection that follows Keryx's auth re-check close (4401, which a quarantine and a\n *   release both send once the marker is written or cleared), and on one that follows an outage\n *   the handle itself treats as real (no socket for `offlineGateAfterMs`), never on an ordinary\n *   reconnect: a Keryx deploy reconnects every room at once;\n * - once local edits have waited unconfirmed for `UNCONFIRMED_EDITS_STALL_MS` on a connected\n *   socket (a room opened while quarantined is bounced by nothing), once per stall;\n * - on Olympus's cadence while connected and the page is shown: every five minutes, every minute\n *   while Keryx says the room takes no writes, so the chip clears soon after a release that bounced\n *   no socket.\n *\n * One read at a time, each given up after `DOCUMENT_STATUS_READ_TIMEOUT_MS`, and none on a\n * read-only grant (nothing it sends could be refused). A read that can't answer reads as \"takes\n * writes\": never a delay Keryx did not assert.\n */\n\nimport { UNCONFIRMED_EDITS_STALL_MS } from '@athenaintel/agent-runtime/offline-status';\nimport type { CollabTokenResponse } from './mint';\n\n/** What a host read of Keryx's document status for the room. */\nexport interface DocumentStatusReading {\n  /** Keryx takes no writes to the room for now (quarantined while it is repaired). */\n  writesRefused: boolean;\n}\n\n/**\n * Reads Keryx's document status with the grant the room connects with (its token, room and branch:\n * `GET /document-status/{org}/{doc_id}?yauth=&branch=` on the grant's Keryx), so it reads nothing\n * the room's own permission does not. `null` when it can't answer: a Keryx or a host that predates\n * the route, a refusal, a failure. It must settle; the handle stops waiting after\n * {@link DOCUMENT_STATUS_READ_TIMEOUT_MS}.\n */\nexport type ReadDocumentStatus = (params: {\n  grant: CollabTokenResponse;\n}) => Promise<DocumentStatusReading | null>;\n\n/** How often a connected room reads its status while Keryx takes its writes: Olympus's cadence. */\nexport const DOCUMENT_STATUS_REFRESH_MS = 5 * 60_000;\n/** How often it reads while Keryx refuses them, so a release is heard soon after. */\nexport const DOCUMENT_STATUS_REFUSED_REFRESH_MS = 60_000;\n/** How long the handle waits for one read before it gives up on it. */\nexport const DOCUMENT_STATUS_READ_TIMEOUT_MS = 30_000;\n\n/** What the handle tells its document-status reads about its connection. */\nexport interface DocumentStatusWatch {\n  /** Keryx's last answer says the room takes no writes. */\n  readonly writesRefused: boolean;\n  /** The room's socket connected; `readNow`: a connection that reads the status at once. */\n  connected: (params: { readNow: boolean }) => void;\n  /** The room's socket is down: nothing is read until it connects again. */\n  disconnected: () => void;\n  /** Whether local edits wait unconfirmed. */\n  unconfirmedChanged: (unconfirmed: boolean) => void;\n  destroy: () => void;\n}\n\n/** `promise`'s value, or `null` once it rejects or `timeoutMs` passes first. */\nfunction settleWithin<T>({\n  promise,\n  timeoutMs,\n}: {\n  promise: Promise<T>;\n  timeoutMs: number;\n}): Promise<T | null> {\n  return new Promise((resolve) => {\n    const timer = setTimeout(() => resolve(null), timeoutMs);\n    promise.then(\n      (value) => {\n        clearTimeout(timer);\n        resolve(value);\n      },\n      () => {\n        clearTimeout(timer);\n        resolve(null);\n      }\n    );\n  });\n}\n\n/** The page is hidden (a cadence read skips its turn, as TanStack's interval does off screen). */\nfunction pageHidden(): boolean {\n  return typeof document !== 'undefined' && document.visibilityState === 'hidden';\n}\n\nexport function watchDocumentStatus({\n  read,\n  currentGrant,\n  onChange,\n}: {\n  read: ReadDocumentStatus;\n  /** The grant the room's socket connects with now. */\n  currentGrant: () => CollabTokenResponse | null;\n  /** `writesRefused` changed. */\n  onChange: () => void;\n}): DocumentStatusWatch {\n  let connected = false;\n  let unconfirmed = false;\n  let writesRefused = false;\n  let reading = false;\n  let readAgain = false;\n  let destroyed = false;\n  /** The current stall (edits unconfirmed on a connected socket) has had its read. */\n  let stallRead = false;\n  let stallTimer: ReturnType<typeof setTimeout> | null = null;\n  let cadenceTimer: ReturnType<typeof setTimeout> | null = null;\n\n  const clearStallTimer = () => {\n    if (stallTimer !== null) {\n      clearTimeout(stallTimer);\n      stallTimer = null;\n    }\n  };\n\n  const clearCadenceTimer = () => {\n    if (cadenceTimer !== null) {\n      clearTimeout(cadenceTimer);\n      cadenceTimer = null;\n    }\n  };\n\n  const setWritesRefused = (next: boolean) => {\n    if (next === writesRefused) return;\n    writesRefused = next;\n    onChange();\n  };\n\n  const scheduleCadence = () => {\n    clearCadenceTimer();\n    if (destroyed || !connected) return;\n    cadenceTimer = setTimeout(\n      () => {\n        cadenceTimer = null;\n        if (pageHidden()) {\n          scheduleCadence();\n          return;\n        }\n        void readStatus();\n      },\n      writesRefused ? DOCUMENT_STATUS_REFUSED_REFRESH_MS : DOCUMENT_STATUS_REFRESH_MS\n    );\n  };\n\n  async function readStatus(): Promise<void> {\n    if (destroyed || !connected) return;\n    if (reading) {\n      readAgain = true;\n      return;\n    }\n    const grant = currentGrant();\n    if (grant === null) return;\n    clearCadenceTimer();\n    if (grant.access_type !== 'rw') {\n      // A read-only grant sends nothing Keryx could refuse: there is no saving to delay.\n      setWritesRefused(false);\n      return;\n    }\n    reading = true;\n    const answer = await settleWithin({\n      promise: read({ grant }),\n      timeoutMs: DOCUMENT_STATUS_READ_TIMEOUT_MS,\n    });\n    reading = false;\n    if (destroyed) return;\n    setWritesRefused(answer?.writesRefused === true);\n    if (readAgain) {\n      readAgain = false;\n      void readStatus();\n      return;\n    }\n    scheduleCadence();\n  }\n\n  const stallChanged = () => {\n    if (!connected || !unconfirmed) {\n      clearStallTimer();\n      stallRead = false;\n      return;\n    }\n    if (stallTimer !== null || stallRead || destroyed) return;\n    stallTimer = setTimeout(() => {\n      stallTimer = null;\n      stallRead = true;\n      void readStatus();\n    }, UNCONFIRMED_EDITS_STALL_MS);\n  };\n\n  return {\n    get writesRefused() {\n      return writesRefused;\n    },\n    connected: ({ readNow }) => {\n      if (destroyed) return;\n      connected = true;\n      stallChanged();\n      if (readNow) {\n        void readStatus();\n      } else if (cadenceTimer === null && !reading) {\n        scheduleCadence();\n      }\n    },\n    disconnected: () => {\n      connected = false;\n      clearCadenceTimer();\n      stallChanged();\n    },\n    unconfirmedChanged: (next) => {\n      if (next === unconfirmed) return;\n      unconfirmed = next;\n      stallChanged();\n    },\n    destroy: () => {\n      destroyed = true;\n      clearStallTimer();\n      clearCadenceTimer();\n    },\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/collab/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const closePolicy = require("./close-policy.cjs");
+const documentStatus = require("./document-status.cjs");
 const client = require("./client.cjs");
+const updateAttributions = require("../keryx-http/src/update-attributions.cjs");
 const mint = require("./mint.cjs");
 const presenceClient = require("./presence-client.cjs");
 const presenceMint = require("./presence-mint.cjs");
@@ -13,9 +15,14 @@ const tokenRefresh = require("./token-refresh.cjs");
 exports.WS_CLOSE_AUTH_REVOKED = closePolicy.WS_CLOSE_AUTH_REVOKED;
 exports.WS_CLOSE_DOC_DELETED = closePolicy.WS_CLOSE_DOC_DELETED;
 exports.classifyClose = closePolicy.classifyClose;
+exports.DOCUMENT_STATUS_READ_TIMEOUT_MS = documentStatus.DOCUMENT_STATUS_READ_TIMEOUT_MS;
+exports.DOCUMENT_STATUS_REFRESH_MS = documentStatus.DOCUMENT_STATUS_REFRESH_MS;
+exports.DOCUMENT_STATUS_REFUSED_REFRESH_MS = documentStatus.DOCUMENT_STATUS_REFUSED_REFRESH_MS;
 exports.DEFAULT_OFFLINE_GATE_AFTER_MS = client.DEFAULT_OFFLINE_GATE_AFTER_MS;
 exports.connectGenericDoc = client.connectGenericDoc;
 exports.isRetryableMintError = client.isRetryableMintError;
+exports.BACKGROUND_UPDATE_ATTRIBUTIONS = updateAttributions.BACKGROUND_UPDATE_ATTRIBUTIONS;
+exports.runWithDocUpdateAttributions = updateAttributions.runWithDocUpdateAttributions;
 exports.CollabTokenError = mint.CollabTokenError;
 exports.getAthenaApiBaseUrl = mint.getAthenaApiBaseUrl;
 exports.mintCollabToken = mint.mintCollabToken;

package/dist/collab/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/collab/index.d.ts

@@ -5,7 +5,10 @@
  * Built on yjs v14 (`@y/y`) and the v14-line WebSocket provider
  * (`@y/websocket`). Document auth flows through the public collab-token mint
  * (`POST /api/v0/assets/{id}/collab-token`), which is allowlisted server-side
- * to `generic_doc` assets and admin-only during the initial rollout.
+ * to `generic_doc` assets and admin-only during the initial rollout. A write
+ * the host makes on its own goes out as housekeeping, not as the person's edit,
+ * when it is made inside `runWithDocUpdateAttributions` for the handle's doc
+ * with `BACKGROUND_UPDATE_ATTRIBUTIONS`.
  *
  * Workspace presence (`useWorkspacePresence` / `connectWorkspacePresence`)
  * observes the Keryx workspace awareness room (`<workspaceId>/awareness`) —
@@ -17,7 +20,9 @@
  * in awareness contexts into titles the caller may see.
  */
 export { classifyClose, WS_CLOSE_AUTH_REVOKED, WS_CLOSE_DOC_DELETED } from './close-policy';
+export { DOCUMENT_STATUS_READ_TIMEOUT_MS, DOCUMENT_STATUS_REFRESH_MS, DOCUMENT_STATUS_REFUSED_REFRESH_MS, type DocumentStatusReading, type ReadDocumentStatus, } from './document-status';
 export { CollabTokenError, connectGenericDoc, DEFAULT_OFFLINE_GATE_AFTER_MS, isRetryableMintError, type CollabAuth, type CollabMint, type CollabTokenResponse, type GenericDocConnectGate, type GenericDocHandle, type GenericDocLocalCopy, type GenericDocStatus, type GenericDocTransportView, type PresenceEntry, } from './client';
+export { BACKGROUND_UPDATE_ATTRIBUTIONS, runWithDocUpdateAttributions, type UpdateAttribution, } from '../keryx-http/src/update-attributions';
 export { getAthenaApiBaseUrl, mintCollabToken } from './mint';
 export { PRESENCE_SWEEP_INTERVAL_MS, connectWorkspacePresence, type WorkspacePresenceHandle, type WorkspacePresenceStatus, } from './presence-client';
 export { mintWorkspacePresenceToken, resolveWorkspacePresence, type WorkspacePresenceResolveRequest, type WorkspacePresenceResolveResponse, type WorkspacePresenceResolvedAsset, type WorkspacePresenceResolvedMember, type WorkspacePresenceResolvedProject, type WorkspacePresenceResolvedSession, type WorkspacePresenceTokenResponse, } from './presence-mint';

package/dist/collab/index.js

@@ -1,5 +1,7 @@
 import { WS_CLOSE_AUTH_REVOKED, WS_CLOSE_DOC_DELETED, classifyClose } from "./close-policy.js";
+import { DOCUMENT_STATUS_READ_TIMEOUT_MS, DOCUMENT_STATUS_REFRESH_MS, DOCUMENT_STATUS_REFUSED_REFRESH_MS } from "./document-status.js";
 import { DEFAULT_OFFLINE_GATE_AFTER_MS, connectGenericDoc, isRetryableMintError } from "./client.js";
+import { BACKGROUND_UPDATE_ATTRIBUTIONS, runWithDocUpdateAttributions } from "../keryx-http/src/update-attributions.js";
 import { CollabTokenError, getAthenaApiBaseUrl, mintCollabToken } from "./mint.js";
 import { PRESENCE_SWEEP_INTERVAL_MS, connectWorkspacePresence } from "./presence-client.js";
 import { mintWorkspacePresenceToken, resolveWorkspacePresence } from "./presence-mint.js";
@@ -9,8 +11,12 @@ import { useGenericDoc } from "./react.js";
 import { defineDocShape } from "./shape.js";
 import { MAX_CONSECUTIVE_REMINTS, MIN_REFRESH_DELAY_MS, REFRESH_HEADROOM_MS, refreshDelayMs } from "./token-refresh.js";
 export {
+  BACKGROUND_UPDATE_ATTRIBUTIONS,
   CollabTokenError,
   DEFAULT_OFFLINE_GATE_AFTER_MS,
+  DOCUMENT_STATUS_READ_TIMEOUT_MS,
+  DOCUMENT_STATUS_REFRESH_MS,
+  DOCUMENT_STATUS_REFUSED_REFRESH_MS,
   MAX_CONSECUTIVE_REMINTS,
   MAX_PRESENCE_CONTEXTS_PER_SLOT,
   MAX_PRESENCE_STRING_CHARS,
@@ -35,6 +41,7 @@ export {
   mintWorkspacePresenceToken,
   refreshDelayMs,
   resolveWorkspacePresence,
+  runWithDocUpdateAttributions,
   useGenericDoc,
   useWorkspacePresence,
   useWorkspacePresenceResolver

package/dist/collab/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/collab/presence-react.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const react = require("react");
+const require$$0 = require("react");
 const AthenaCredentialSourceContext = require("../auth/AthenaCredentialSourceContext.cjs");
 const AthenaContext = require("../provider/AthenaContext.cjs");
 const presenceClient = require("./presence-client.cjs");
@@ -15,9 +15,9 @@ function useWorkspacePresence(workspaceId, options) {
   const identityEpoch = AthenaCredentialSourceContext.useAthenaCredentialIdentityEpoch();
   const enabled = (options == null ? void 0 : options.enabled) !== false && workspaceId !== null;
   const tickMs = (options == null ? void 0 : options.tickMs) ?? PRESENCE_DEFAULT_TICK_MS;
-  const [entry, setEntry] = react.useState(null);
-  const handleRef = react.useRef(null);
-  react.useEffect(() => {
+  const [entry, setEntry] = require$$0.useState(null);
+  const handleRef = require$$0.useRef(null);
+  require$$0.useEffect(() => {
     if (!enabled || workspaceId === null) {
       setEntry(null);
       return;
@@ -39,14 +39,14 @@ function useWorkspacePresence(workspaceId, options) {
     };
   }, [enabled, workspaceId, config.backendUrl, config.apiKey, config.getToken, identityEpoch]);
   const handle = enabled && entry !== null && entry.workspaceId === workspaceId ? entry.handle : null;
-  const subscribe = react.useMemo(() => {
+  const subscribe = require$$0.useMemo(() => {
     return (onStoreChange) => {
       if (!handle) return () => {
       };
       return handle.onChange(onStoreChange);
     };
   }, [handle]);
-  react.useSyncExternalStore(
+  require$$0.useSyncExternalStore(
     subscribe,
     () => {
       if (!handle) return EMPTY_SNAPSHOT;
@@ -54,8 +54,8 @@ function useWorkspacePresence(workspaceId, options) {
     },
     () => EMPTY_SNAPSHOT
   );
-  const [now, setNow] = react.useState(() => Date.now());
-  react.useEffect(() => {
+  const [now, setNow] = require$$0.useState(() => Date.now());
+  require$$0.useEffect(() => {
     if (!enabled) return;
     setNow(Date.now());
     const timer = setInterval(() => {
@@ -66,7 +66,7 @@ function useWorkspacePresence(workspaceId, options) {
     };
   }, [enabled, tickMs]);
   const rosterHumans = (handle == null ? void 0 : handle.humans) ?? NO_HUMANS;
-  const humans = react.useMemo(
+  const humans = require$$0.useMemo(
     () => rosterHumans.map((human) => ({
       ...human,
       state: presenceSlots.derivePresenceState({
@@ -78,7 +78,7 @@ function useWorkspacePresence(workspaceId, options) {
     })),
     [rosterHumans, now]
   );
-  const refreshNow = react.useCallback(() => {
+  const refreshNow = require$$0.useCallback(() => {
     var _a;
     return ((_a = handleRef.current) == null ? void 0 : _a.refreshNow()) ?? Promise.resolve();
   }, []);
@@ -93,7 +93,7 @@ function useWorkspacePresence(workspaceId, options) {
 }
 function useWorkspacePresenceResolver(workspaceId) {
   const config = AthenaContext.useAthenaConfig();
-  return react.useCallback(
+  return require$$0.useCallback(
     (request, signal) => {
       if (workspaceId === null) {
         return Promise.reject(

package/dist/collab/presence-react.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"presence-react.cjs","sources":["../../src/collab/presence-react.ts"],"sourcesContent":["/**\n * React bindings for the workspace presence feed.\n *\n * `useWorkspacePresence(workspaceId)` opens (and owns) a\n * `connectWorkspacePresence` handle, resolving auth from the surrounding\n * `AthenaProvider` (per-viewer bearer when present, API key otherwise), and\n * re-renders on status/roster changes via `useSyncExternalStore`. Each person\n * carries a `state` on the intent ladder, recomputed against a clock that\n * ticks every `tickMs` so `active` decays to `idle` and `away` between\n * awareness events.\n *\n * `useWorkspacePresenceResolver(workspaceId)` returns the batch id→title\n * resolver bound to the same auth. It is deliberately thin: callers own\n * caching (TanStack Query is the expected home for it).\n */\n\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaCredentialIdentityEpoch } from '../auth/AthenaCredentialSourceContext';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type WorkspacePresenceHandle,\n  type WorkspacePresenceStatus,\n  connectWorkspacePresence,\n} from './presence-client';\nimport {\n  type WorkspacePresenceResolveRequest,\n  type WorkspacePresenceResolveResponse,\n  resolveWorkspacePresence,\n} from './presence-mint';\nimport {\n  type PresenceAgent,\n  type PresenceHuman,\n  type PresenceState,\n  derivePresenceState,\n} from './presence-slots';\n\n/** Default cadence for re-deriving each person's intent state. */\nexport const PRESENCE_DEFAULT_TICK_MS = 10_000;\n\nexport interface PresenceHumanWithState extends PresenceHuman {\n  /** Where the person sits on the intent ladder as of the last tick. */\n  state: PresenceState;\n}\n\nexport interface UseWorkspacePresenceOptions {\n  /** `false` closes the feed without unmounting the caller. Default `true`. */\n  enabled?: boolean;\n  /** How often `state` is re-derived from `lastIntentAt`. Default 10 s. */\n  tickMs?: number;\n}\n\nexport interface UseWorkspacePresenceResult {\n  /** `'closed'` while disabled or without a workspace; `'connecting'` until the first mint resolves. */\n  status: WorkspacePresenceStatus;\n  error: Error | null;\n  accessType: 'r' | 'rw' | null;\n  humans: PresenceHumanWithState[];\n  agents: PresenceAgent[];\n  /** Force an early token refresh; resolves immediately when no feed is open. */\n  refreshNow: () => Promise<void>;\n}\n\nconst EMPTY_SNAPSHOT = 'init||0';\nconst NO_HUMANS: PresenceHuman[] = [];\nconst NO_AGENTS: PresenceAgent[] = [];\n\nexport function useWorkspacePresence(\n  workspaceId: string | null,\n  options?: UseWorkspacePresenceOptions\n): UseWorkspacePresenceResult {\n  const config = useAthenaConfig();\n  const identityEpoch = useAthenaCredentialIdentityEpoch();\n  const enabled = options?.enabled !== false && workspaceId !== null;\n  const tickMs = options?.tickMs ?? PRESENCE_DEFAULT_TICK_MS;\n  const [entry, setEntry] = useState<{\n    workspaceId: string;\n    handle: WorkspacePresenceHandle;\n  } | null>(null);\n  const handleRef = useRef<WorkspacePresenceHandle | null>(null);\n\n  useEffect(() => {\n    if (!enabled || workspaceId === null) {\n      setEntry(null);\n      return;\n    }\n    const next = connectWorkspacePresence({\n      workspaceId,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n        getToken: config.getToken,\n      },\n    });\n    handleRef.current = next;\n    setEntry({ workspaceId, handle: next });\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or the signed-in identity changes (the\n    // credential source's identity epoch). A renewed token for the same\n    // identity reaches the next re-mint through `getToken`, so a renewal\n    // does not tear the live connection down.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [enabled, workspaceId, config.backendUrl, config.apiKey, config.getToken, identityEpoch]);\n\n  // React renders with the new arguments before the effect above runs, so a\n  // handle opened for a previous workspace, or before the feed was disabled,\n  // still sits in state for that one render. Expose it only while it is the\n  // handle this render asked for; otherwise the closed / connecting empty\n  // result wins, and a disabled feed never leaks a roster.\n  const handle =\n    enabled && entry !== null && entry.workspaceId === workspaceId ? entry.handle : null;\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  // The ladder decays with wall-clock time, not with awareness events; a\n  // person who stops typing must drift to idle even when nothing arrives.\n  const [now, setNow] = useState(() => Date.now());\n  useEffect(() => {\n    if (!enabled) return;\n    setNow(Date.now());\n    const timer = setInterval(() => {\n      setNow(Date.now());\n    }, tickMs);\n    return () => {\n      clearInterval(timer);\n    };\n  }, [enabled, tickMs]);\n\n  const rosterHumans = handle?.humans ?? NO_HUMANS;\n  const humans = useMemo(\n    () =>\n      rosterHumans.map((human) => ({\n        ...human,\n        state: derivePresenceState({\n          lastIntentAt: human.lastIntentAt,\n          hidden: human.hidden,\n          manualAway: human.manualAway,\n          now,\n        }),\n      })),\n    [rosterHumans, now]\n  );\n\n  const refreshNow = useCallback(() => handleRef.current?.refreshNow() ?? Promise.resolve(), []);\n\n  return {\n    status: handle ? handle.status : enabled ? 'connecting' : 'closed',\n    error: handle?.error ?? null,\n    accessType: handle?.accessType ?? null,\n    humans,\n    agents: handle?.agents ?? NO_AGENTS,\n    refreshNow,\n  };\n}\n\nexport type WorkspacePresenceResolver = (\n  request: WorkspacePresenceResolveRequest,\n  signal?: AbortSignal\n) => Promise<WorkspacePresenceResolveResponse>;\n\n/**\n * A stable resolver bound to the provider's auth and the given workspace.\n * Credentials are read on every call (the provider serves the current token\n * through getters), and `getToken` renews a refused one once. Rejects when\n * called without a workspace; no caching — callers own that.\n */\nexport function useWorkspacePresenceResolver(\n  workspaceId: string | null\n): WorkspacePresenceResolver {\n  const config = useAthenaConfig();\n  return useCallback<WorkspacePresenceResolver>(\n    (request, signal) => {\n      if (workspaceId === null) {\n        return Promise.reject(\n          new Error('[AthenaSDK] useWorkspacePresenceResolver: no workspace selected')\n        );\n      }\n      return resolveWorkspacePresence({\n        auth: {\n          backendUrl: config.backendUrl,\n          apiKey: config.apiKey,\n          token: config.token,\n          getToken: config.getToken,\n        },\n        workspaceId,\n        request,\n        signal,\n      });\n    },\n    [workspaceId, config]\n  );\n}\n"],"names":["useAthenaConfig","useAthenaCredentialIdentityEpoch","useState","useRef","useEffect","connectWorkspacePresence","useMemo","useSyncExternalStore","derivePresenceState","useCallback","resolveWorkspacePresence"],"mappings":"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"}
+{"version":3,"file":"presence-react.cjs","sources":["../../src/collab/presence-react.ts"],"sourcesContent":["/**\n * React bindings for the workspace presence feed.\n *\n * `useWorkspacePresence(workspaceId)` opens (and owns) a\n * `connectWorkspacePresence` handle, resolving auth from the surrounding\n * `AthenaProvider` (per-viewer bearer when present, API key otherwise), and\n * re-renders on status/roster changes via `useSyncExternalStore`. Each person\n * carries a `state` on the intent ladder, recomputed against a clock that\n * ticks every `tickMs` so `active` decays to `idle` and `away` between\n * awareness events.\n *\n * `useWorkspacePresenceResolver(workspaceId)` returns the batch id→title\n * resolver bound to the same auth. It is deliberately thin: callers own\n * caching (TanStack Query is the expected home for it).\n */\n\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaCredentialIdentityEpoch } from '../auth/AthenaCredentialSourceContext';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type WorkspacePresenceHandle,\n  type WorkspacePresenceStatus,\n  connectWorkspacePresence,\n} from './presence-client';\nimport {\n  type WorkspacePresenceResolveRequest,\n  type WorkspacePresenceResolveResponse,\n  resolveWorkspacePresence,\n} from './presence-mint';\nimport {\n  type PresenceAgent,\n  type PresenceHuman,\n  type PresenceState,\n  derivePresenceState,\n} from './presence-slots';\n\n/** Default cadence for re-deriving each person's intent state. */\nexport const PRESENCE_DEFAULT_TICK_MS = 10_000;\n\nexport interface PresenceHumanWithState extends PresenceHuman {\n  /** Where the person sits on the intent ladder as of the last tick. */\n  state: PresenceState;\n}\n\nexport interface UseWorkspacePresenceOptions {\n  /** `false` closes the feed without unmounting the caller. Default `true`. */\n  enabled?: boolean;\n  /** How often `state` is re-derived from `lastIntentAt`. Default 10 s. */\n  tickMs?: number;\n}\n\nexport interface UseWorkspacePresenceResult {\n  /** `'closed'` while disabled or without a workspace; `'connecting'` until the first mint resolves. */\n  status: WorkspacePresenceStatus;\n  error: Error | null;\n  accessType: 'r' | 'rw' | null;\n  humans: PresenceHumanWithState[];\n  agents: PresenceAgent[];\n  /** Force an early token refresh; resolves immediately when no feed is open. */\n  refreshNow: () => Promise<void>;\n}\n\nconst EMPTY_SNAPSHOT = 'init||0';\nconst NO_HUMANS: PresenceHuman[] = [];\nconst NO_AGENTS: PresenceAgent[] = [];\n\nexport function useWorkspacePresence(\n  workspaceId: string | null,\n  options?: UseWorkspacePresenceOptions\n): UseWorkspacePresenceResult {\n  const config = useAthenaConfig();\n  const identityEpoch = useAthenaCredentialIdentityEpoch();\n  const enabled = options?.enabled !== false && workspaceId !== null;\n  const tickMs = options?.tickMs ?? PRESENCE_DEFAULT_TICK_MS;\n  const [entry, setEntry] = useState<{\n    workspaceId: string;\n    handle: WorkspacePresenceHandle;\n  } | null>(null);\n  const handleRef = useRef<WorkspacePresenceHandle | null>(null);\n\n  useEffect(() => {\n    if (!enabled || workspaceId === null) {\n      setEntry(null);\n      return;\n    }\n    const next = connectWorkspacePresence({\n      workspaceId,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n        getToken: config.getToken,\n      },\n    });\n    handleRef.current = next;\n    setEntry({ workspaceId, handle: next });\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or the signed-in identity changes (the\n    // credential source's identity epoch). A renewed token for the same\n    // identity reaches the next re-mint through `getToken`, so a renewal\n    // does not tear the live connection down.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [enabled, workspaceId, config.backendUrl, config.apiKey, config.getToken, identityEpoch]);\n\n  // React renders with the new arguments before the effect above runs, so a\n  // handle opened for a previous workspace, or before the feed was disabled,\n  // still sits in state for that one render. Expose it only while it is the\n  // handle this render asked for; otherwise the closed / connecting empty\n  // result wins, and a disabled feed never leaks a roster.\n  const handle =\n    enabled && entry !== null && entry.workspaceId === workspaceId ? entry.handle : null;\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  // The ladder decays with wall-clock time, not with awareness events; a\n  // person who stops typing must drift to idle even when nothing arrives.\n  const [now, setNow] = useState(() => Date.now());\n  useEffect(() => {\n    if (!enabled) return;\n    setNow(Date.now());\n    const timer = setInterval(() => {\n      setNow(Date.now());\n    }, tickMs);\n    return () => {\n      clearInterval(timer);\n    };\n  }, [enabled, tickMs]);\n\n  const rosterHumans = handle?.humans ?? NO_HUMANS;\n  const humans = useMemo(\n    () =>\n      rosterHumans.map((human) => ({\n        ...human,\n        state: derivePresenceState({\n          lastIntentAt: human.lastIntentAt,\n          hidden: human.hidden,\n          manualAway: human.manualAway,\n          now,\n        }),\n      })),\n    [rosterHumans, now]\n  );\n\n  const refreshNow = useCallback(() => handleRef.current?.refreshNow() ?? Promise.resolve(), []);\n\n  return {\n    status: handle ? handle.status : enabled ? 'connecting' : 'closed',\n    error: handle?.error ?? null,\n    accessType: handle?.accessType ?? null,\n    humans,\n    agents: handle?.agents ?? NO_AGENTS,\n    refreshNow,\n  };\n}\n\nexport type WorkspacePresenceResolver = (\n  request: WorkspacePresenceResolveRequest,\n  signal?: AbortSignal\n) => Promise<WorkspacePresenceResolveResponse>;\n\n/**\n * A stable resolver bound to the provider's auth and the given workspace.\n * Credentials are read on every call (the provider serves the current token\n * through getters), and `getToken` renews a refused one once. Rejects when\n * called without a workspace; no caching — callers own that.\n */\nexport function useWorkspacePresenceResolver(\n  workspaceId: string | null\n): WorkspacePresenceResolver {\n  const config = useAthenaConfig();\n  return useCallback<WorkspacePresenceResolver>(\n    (request, signal) => {\n      if (workspaceId === null) {\n        return Promise.reject(\n          new Error('[AthenaSDK] useWorkspacePresenceResolver: no workspace selected')\n        );\n      }\n      return resolveWorkspacePresence({\n        auth: {\n          backendUrl: config.backendUrl,\n          apiKey: config.apiKey,\n          token: config.token,\n          getToken: config.getToken,\n        },\n        workspaceId,\n        request,\n        signal,\n      });\n    },\n    [workspaceId, config]\n  );\n}\n"],"names":["useAthenaConfig","useAthenaCredentialIdentityEpoch","useState","useRef","useEffect","connectWorkspacePresence","useMemo","useSyncExternalStore","derivePresenceState","useCallback","resolveWorkspacePresence"],"mappings":"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"}