@athenaintel/react 0.28.1 → 0.30.0

package/dist/collab/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../src/collab/client.ts"],"sourcesContent":["/**\n * Vanilla (framework-agnostic) live client for Generic Doc assets.\n *\n * `connectGenericDoc` owns the full connection lifecycle: mint a room-bound\n * token via the public API, open the Keryx WebSocket with the v14 provider\n * (`@y/websocket` + `@y/y`), re-mint before expiry, apply the close-code\n * policy (4401 → one fresh mint, other 44xx → permanent stop, everything\n * else → provider backoff), and expose presence from awareness. React apps\n * use `useGenericDoc` from `@athenaintel/react/collab` instead of calling\n * this directly.\n */\n\nimport { WebsocketProvider } from '@y/websocket';\nimport * as Y from '@y/y';\nimport { classifyClose } from './close-policy';\nimport {\n  type CollabAuth,\n  type CollabTokenResponse,\n  CollabTokenError,\n  mintCollabToken,\n} from './mint';\nimport { MAX_CONSECUTIVE_REMINTS, MIN_REFRESH_DELAY_MS, refreshDelayMs } from './token-refresh';\n\nexport type GenericDocStatus =\n  | 'connecting'\n  | 'connected'\n  | 'disconnected'\n  | 'closed'\n  | 'error';\n\nexport interface PresenceEntry {\n  clientId: number;\n  state: Record<string, unknown>;\n}\n\nexport interface GenericDocHandle {\n  /** The live shared document. Owned by the handle; destroyed with it. */\n  readonly doc: Y.Doc;\n  readonly status: GenericDocStatus;\n  /**\n   * Whether the initial server sync has completed for the current connection.\n   * `status === 'connected'` fires before the server state arrives, so a doc\n   * read immediately after connect can still be empty — gate first reads on\n   * this (or `waitForSync`).\n   */\n  readonly synced: boolean;\n  /** Granted access from the last successful mint. */\n  readonly accessType: 'r' | 'rw' | null;\n  /** Terminal error, when status is 'error' or 'closed'. */\n  readonly error: Error | null;\n  /** Monotonic change counter — bumps on every status/presence notification. */\n  readonly version: number;\n  /**\n   * Resolve once the initial server sync completes; reject on timeout, on a\n   * terminal connection state, or if the handle is destroyed first.\n   */\n  waitForSync: (timeoutMs?: number) => Promise<void>;\n  getPresence: () => PresenceEntry[];\n  /** Broadcast this client's presence state (requires a live connection). */\n  setPresence: (state: Record<string, unknown> | null) => void;\n  /**\n   * Force an early token refresh. Session-preserving: the live connection\n   * stays up until the fresh token is minted; a failed mint retries on a\n   * short timer instead of dropping the session.\n   */\n  refreshNow: () => Promise<void>;\n  onChange: (listener: () => void) => () => void;\n  destroy: () => void;\n}\n\nexport function connectGenericDoc(args: {\n  assetId: string;\n  auth: CollabAuth;\n  access?: 'view' | 'edit';\n}): GenericDocHandle {\n  const access = args.access ?? 'view';\n  const doc = new Y.Doc();\n  const listeners = new Set<() => void>();\n\n  let provider: WebsocketProvider | null = null;\n  let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n  let destroyed = false;\n  let status: GenericDocStatus = 'connecting';\n  let synced = false;\n  let accessType: 'r' | 'rw' | null = null;\n  let error: Error | null = null;\n  let lastPresence: Record<string, unknown> | null = null;\n  let version = 0;\n  let consecutiveRemints = 0;\n\n  const notify = () => {\n    version += 1;\n    for (const listener of listeners) listener();\n  };\n\n  const setStatus = (next: GenericDocStatus, err: Error | null = null) => {\n    if (destroyed && next !== 'closed') return;\n    status = next;\n    error = err;\n    notify();\n  };\n\n  const clearRefreshTimer = () => {\n    if (refreshTimer !== null) {\n      clearTimeout(refreshTimer);\n      refreshTimer = null;\n    }\n  };\n\n  const teardownProvider = () => {\n    clearRefreshTimer();\n    // A future provider must complete its own initial sync; the doc keeps its\n    // content either way. Subscribers must observe the flip immediately —\n    // waiting for the next provider event would let them act on synced=true\n    // across the replacement gap.\n    if (synced) {\n      synced = false;\n      notify();\n    }\n    if (provider) {\n      provider.destroy();\n      provider = null;\n    }\n  };\n\n  const scheduleRefresh = (grant: CollabTokenResponse) => {\n    clearRefreshTimer();\n    const delay = refreshDelayMs({ expiresAtMs: grant.expires_at_ms, now: Date.now() });\n    refreshTimer = setTimeout(() => {\n      void connect({ scheduledRefresh: true });\n    }, delay);\n  };\n\n  const connect = async (opts?: { scheduledRefresh?: boolean }): Promise<void> => {\n    if (destroyed) return;\n    const scheduledRefresh = opts?.scheduledRefresh === true;\n    // A scheduled refresh mints FIRST and keeps the live session up: the old\n    // token has ~5 minutes of headroom, so a transient mint failure retries\n    // on a short timer instead of dropping a healthy connection.\n    if (!scheduledRefresh) {\n      teardownProvider();\n    } else {\n      clearRefreshTimer();\n    }\n    let grant: CollabTokenResponse;\n    try {\n      grant = await mintCollabToken({ auth: args.auth, assetId: args.assetId, access });\n    } catch (err) {\n      if (scheduledRefresh && !destroyed) {\n        refreshTimer = setTimeout(() => {\n          void connect({ scheduledRefresh: true });\n        }, MIN_REFRESH_DELAY_MS);\n        return;\n      }\n      // A denied mint is authoritative (revoked / not shared / not eligible);\n      // anything else (network) is worth telling the caller about too — the\n      // handle stays usable via a later explicit reconnect-by-recreate.\n      setStatus('error', err instanceof Error ? err : new Error(String(err)));\n      return;\n    }\n    if (destroyed) return;\n    if (scheduledRefresh) {\n      teardownProvider();\n    }\n    accessType = grant.access_type;\n\n    const nextProvider = new WebsocketProvider(grant.ws_url, `${grant.org}/${grant.doc_id}`, doc, {\n      params: {\n        yauth: grant.token,\n        branch: grant.branch,\n        gc: 'true',\n      },\n      // BroadcastChannel would sync same-origin clients locally, bypassing the\n      // server's permission enforcement (a read-only tab could write into an\n      // editor tab's doc). Permissioned docs must round-trip the server.\n      disableBc: true,\n    });\n    provider = nextProvider;\n\n    nextProvider.on('status', (event: { status: 'connecting' | 'connected' | 'disconnected' }) => {\n      if (provider !== nextProvider) return;\n      if (event.status === 'connected') {\n        consecutiveRemints = 0;\n      }\n      setStatus(event.status);\n      if (event.status === 'connected' && lastPresence !== null) {\n        nextProvider.awareness.setLocalState(lastPresence);\n      }\n    });\n\n    nextProvider.on('sync', (state: boolean) => {\n      if (provider !== nextProvider) return;\n      if (synced !== state) {\n        synced = state;\n        notify();\n      }\n    });\n\n    nextProvider.on('connection-close', (event: CloseEvent | null) => {\n      if (provider !== nextProvider) return;\n      const action = classifyClose(event?.code);\n      if (action === 'remint') {\n        // Revoked mid-session: a fresh mint re-runs the server-side permission\n        // check. If access is truly gone the mint 403s and we land in 'error'.\n        // Bounded: repeated 4401s without an intervening successful connect\n        // mean the server keeps rejecting freshly minted tokens — stop rather\n        // than loop mint→connect→kick.\n        consecutiveRemints += 1;\n        teardownProvider();\n        if (consecutiveRemints > MAX_CONSECUTIVE_REMINTS) {\n          setStatus(\n            'closed',\n            new Error('Access repeatedly revoked mid-session (4401); giving up.')\n          );\n          return;\n        }\n        void connect();\n      } else if (action === 'stop') {\n        teardownProvider();\n        setStatus(\n          'closed',\n          new Error(`Connection closed permanently (code ${event?.code ?? 'unknown'})`)\n        );\n      }\n      // 'retry': the provider's exponential backoff handles it.\n    });\n\n    nextProvider.awareness.on('change', () => {\n      if (provider !== nextProvider) return;\n      notify();\n    });\n\n    scheduleRefresh(grant);\n  };\n\n  void connect();\n\n  const waitForSync = (timeoutMs = 15_000): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      const terminal = (): Error | null => {\n        if (destroyed) return new Error('Handle destroyed before initial sync');\n        if (status === 'closed' || status === 'error') {\n          return error ?? new Error(`Connection ${status} before initial sync`);\n        }\n        return null;\n      };\n      if (synced) {\n        resolve();\n        return;\n      }\n      const immediate = terminal();\n      if (immediate) {\n        reject(immediate);\n        return;\n      }\n      const cleanup = () => {\n        clearTimeout(timer);\n        listeners.delete(listener);\n      };\n      const timer = setTimeout(() => {\n        cleanup();\n        reject(new Error(`Timed out after ${timeoutMs}ms waiting for initial sync`));\n      }, timeoutMs);\n      const listener = () => {\n        if (synced) {\n          cleanup();\n          resolve();\n          return;\n        }\n        const err = terminal();\n        if (err) {\n          cleanup();\n          reject(err);\n        }\n      };\n      listeners.add(listener);\n    });\n\n  return {\n    doc,\n    get status() {\n      return status;\n    },\n    get synced() {\n      return synced;\n    },\n    get accessType() {\n      return accessType;\n    },\n    get error() {\n      return error;\n    },\n    get version() {\n      return version;\n    },\n    waitForSync,\n    getPresence: () => {\n      if (!provider) return [];\n      const entries: PresenceEntry[] = [];\n      provider.awareness.getStates().forEach((state, clientId) => {\n        entries.push({ clientId, state: state as Record<string, unknown> });\n      });\n      return entries;\n    },\n    setPresence: (state) => {\n      lastPresence = state;\n      provider?.awareness.setLocalState(state);\n    },\n    refreshNow: () => connect({ scheduledRefresh: true }),\n    onChange: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    destroy: () => {\n      if (destroyed) return;\n      destroyed = true;\n      teardownProvider();\n      status = 'closed';\n      // Final notification so pending waitForSync callers reject instead of\n      // hanging on listeners that are about to be dropped.\n      for (const listener of [...listeners]) listener();\n      listeners.clear();\n      doc.destroy();\n    },\n  };\n}\n\nexport { CollabTokenError };\nexport type { CollabAuth, CollabTokenResponse };\n"],"names":[],"mappings":";;;;;;AAsEO,SAAS,kBAAkB,MAIb;AACnB,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,MAAM,IAAI,EAAE,IAAA;AAClB,QAAM,gCAAgB,IAAA;AAEtB,MAAI,WAAqC;AACzC,MAAI,eAAqD;AACzD,MAAI,YAAY;AAChB,MAAI,SAA2B;AAC/B,MAAI,SAAS;AACb,MAAI,aAAgC;AACpC,MAAI,QAAsB;AAC1B,MAAI,eAA+C;AACnD,MAAI,UAAU;AACd,MAAI,qBAAqB;AAEzB,QAAM,SAAS,MAAM;AACnB,eAAW;AACX,eAAW,YAAY,UAAW,UAAA;AAAA,EACpC;AAEA,QAAM,YAAY,CAAC,MAAwB,MAAoB,SAAS;AACtE,QAAI,aAAa,SAAS,SAAU;AACpC,aAAS;AACT,YAAQ;AACR,WAAA;AAAA,EACF;AAEA,QAAM,oBAAoB,MAAM;AAC9B,QAAI,iBAAiB,MAAM;AACzB,mBAAa,YAAY;AACzB,qBAAe;AAAA,IACjB;AAAA,EACF;AAEA,QAAM,mBAAmB,MAAM;AAC7B,sBAAA;AAKA,QAAI,QAAQ;AACV,eAAS;AACT,aAAA;AAAA,IACF;AACA,QAAI,UAAU;AACZ,eAAS,QAAA;AACT,iBAAW;AAAA,IACb;AAAA,EACF;AAEA,QAAM,kBAAkB,CAAC,UAA+B;AACtD,sBAAA;AACA,UAAM,QAAQ,eAAe,EAAE,aAAa,MAAM,eAAe,KAAK,KAAK,IAAA,GAAO;AAClF,mBAAe,WAAW,MAAM;AAC9B,WAAK,QAAQ,EAAE,kBAAkB,MAAM;AAAA,IACzC,GAAG,KAAK;AAAA,EACV;AAEA,QAAM,UAAU,OAAO,SAAyD;AAC9E,QAAI,UAAW;AACf,UAAM,oBAAmB,6BAAM,sBAAqB;AAIpD,QAAI,CAAC,kBAAkB;AACrB,uBAAA;AAAA,IACF,OAAO;AACL,wBAAA;AAAA,IACF;AACA,QAAI;AACJ,QAAI;AACF,cAAQ,MAAM,gBAAgB,EAAE,MAAM,KAAK,MAAM,SAAS,KAAK,SAAS,QAAQ;AAAA,IAClF,SAAS,KAAK;AACZ,UAAI,oBAAoB,CAAC,WAAW;AAClC,uBAAe,WAAW,MAAM;AAC9B,eAAK,QAAQ,EAAE,kBAAkB,MAAM;AAAA,QACzC,GAAG,oBAAoB;AACvB;AAAA,MACF;AAIA,gBAAU,SAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;AACtE;AAAA,IACF;AACA,QAAI,UAAW;AACf,QAAI,kBAAkB;AACpB,uBAAA;AAAA,IACF;AACA,iBAAa,MAAM;AAEnB,UAAM,eAAe,IAAI,kBAAkB,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,MAAM,MAAM,IAAI,KAAK;AAAA,MAC5F,QAAQ;AAAA,QACN,OAAO,MAAM;AAAA,QACb,QAAQ,MAAM;AAAA,QACd,IAAI;AAAA,MAAA;AAAA;AAAA;AAAA;AAAA,MAKN,WAAW;AAAA,IAAA,CACZ;AACD,eAAW;AAEX,iBAAa,GAAG,UAAU,CAAC,UAAmE;AAC5F,UAAI,aAAa,aAAc;AAC/B,UAAI,MAAM,WAAW,aAAa;AAChC,6BAAqB;AAAA,MACvB;AACA,gBAAU,MAAM,MAAM;AACtB,UAAI,MAAM,WAAW,eAAe,iBAAiB,MAAM;AACzD,qBAAa,UAAU,cAAc,YAAY;AAAA,MACnD;AAAA,IACF,CAAC;AAED,iBAAa,GAAG,QAAQ,CAAC,UAAmB;AAC1C,UAAI,aAAa,aAAc;AAC/B,UAAI,WAAW,OAAO;AACpB,iBAAS;AACT,eAAA;AAAA,MACF;AAAA,IACF,CAAC;AAED,iBAAa,GAAG,oBAAoB,CAAC,UAA6B;AAChE,UAAI,aAAa,aAAc;AAC/B,YAAM,SAAS,cAAc,+BAAO,IAAI;AACxC,UAAI,WAAW,UAAU;AAMvB,8BAAsB;AACtB,yBAAA;AACA,YAAI,qBAAqB,yBAAyB;AAChD;AAAA,YACE;AAAA,YACA,IAAI,MAAM,0DAA0D;AAAA,UAAA;AAEtE;AAAA,QACF;AACA,aAAK,QAAA;AAAA,MACP,WAAW,WAAW,QAAQ;AAC5B,yBAAA;AACA;AAAA,UACE;AAAA,UACA,IAAI,MAAM,wCAAuC,+BAAO,SAAQ,SAAS,GAAG;AAAA,QAAA;AAAA,MAEhF;AAAA,IAEF,CAAC;AAED,iBAAa,UAAU,GAAG,UAAU,MAAM;AACxC,UAAI,aAAa,aAAc;AAC/B,aAAA;AAAA,IACF,CAAC;AAED,oBAAgB,KAAK;AAAA,EACvB;AAEA,OAAK,QAAA;AAEL,QAAM,cAAc,CAAC,YAAY,SAC/B,IAAI,QAAc,CAAC,SAAS,WAAW;AACrC,UAAM,WAAW,MAAoB;AACnC,UAAI,UAAW,QAAO,IAAI,MAAM,sCAAsC;AACtE,UAAI,WAAW,YAAY,WAAW,SAAS;AAC7C,eAAO,SAAS,IAAI,MAAM,cAAc,MAAM,sBAAsB;AAAA,MACtE;AACA,aAAO;AAAA,IACT;AACA,QAAI,QAAQ;AACV,cAAA;AACA;AAAA,IACF;AACA,UAAM,YAAY,SAAA;AAClB,QAAI,WAAW;AACb,aAAO,SAAS;AAChB;AAAA,IACF;AACA,UAAM,UAAU,MAAM;AACpB,mBAAa,KAAK;AAClB,gBAAU,OAAO,QAAQ;AAAA,IAC3B;AACA,UAAM,QAAQ,WAAW,MAAM;AAC7B,cAAA;AACA,aAAO,IAAI,MAAM,mBAAmB,SAAS,6BAA6B,CAAC;AAAA,IAC7E,GAAG,SAAS;AACZ,UAAM,WAAW,MAAM;AACrB,UAAI,QAAQ;AACV,gBAAA;AACA,gBAAA;AACA;AAAA,MACF;AACA,YAAM,MAAM,SAAA;AACZ,UAAI,KAAK;AACP,gBAAA;AACA,eAAO,GAAG;AAAA,MACZ;AAAA,IACF;AACA,cAAU,IAAI,QAAQ;AAAA,EACxB,CAAC;AAEH,SAAO;AAAA,IACL;AAAA,IACA,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,IACA,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,IACA,IAAI,aAAa;AACf,aAAO;AAAA,IACT;AAAA,IACA,IAAI,QAAQ;AACV,aAAO;AAAA,IACT;AAAA,IACA,IAAI,UAAU;AACZ,aAAO;AAAA,IACT;AAAA,IACA;AAAA,IACA,aAAa,MAAM;AACjB,UAAI,CAAC,SAAU,QAAO,CAAA;AACtB,YAAM,UAA2B,CAAA;AACjC,eAAS,UAAU,UAAA,EAAY,QAAQ,CAAC,OAAO,aAAa;AAC1D,gBAAQ,KAAK,EAAE,UAAU,MAAA,CAAyC;AAAA,MACpE,CAAC;AACD,aAAO;AAAA,IACT;AAAA,IACA,aAAa,CAAC,UAAU;AACtB,qBAAe;AACf,2CAAU,UAAU,cAAc;AAAA,IACpC;AAAA,IACA,YAAY,MAAM,QAAQ,EAAE,kBAAkB,MAAM;AAAA,IACpD,UAAU,CAAC,aAAa;AACtB,gBAAU,IAAI,QAAQ;AACtB,aAAO,MAAM;AACX,kBAAU,OAAO,QAAQ;AAAA,MAC3B;AAAA,IACF;AAAA,IACA,SAAS,MAAM;AACb,UAAI,UAAW;AACf,kBAAY;AACZ,uBAAA;AACA,eAAS;AAGT,iBAAW,YAAY,CAAC,GAAG,SAAS,EAAG,UAAA;AACvC,gBAAU,MAAA;AACV,UAAI,QAAA;AAAA,IACN;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"client.js","sources":["../../src/collab/client.ts"],"sourcesContent":["/**\n * Vanilla (framework-agnostic) live client for Generic Doc assets.\n *\n * `connectGenericDoc` owns the full connection lifecycle: mint a room-bound\n * token via the public API, open the Keryx WebSocket with the v14 provider\n * (`@y/websocket` + `@y/y`), re-mint before expiry, apply the close-code\n * policy (4401 → one fresh mint, other 44xx → permanent stop, everything\n * else → provider backoff), and expose presence from awareness. React apps\n * use `useGenericDoc` from `@athenaintel/react/collab` instead of calling\n * this directly.\n *\n * A host that keeps a local copy of the document (`localCopy`) gets it applied\n * before the first connection, keeps its unacknowledged edits waiting across\n * sessions, and can hold a connection that would send edits made without one\n * until it has checked them against the server (`beforeConnect`). Offline, a\n * mint that fails for want of the network is retried (`retryMintError`)\n * instead of ending the handle, and past `offlineGateAfterMs` without a socket\n * the handle reconnects itself, re-minting each time, so every reconnect after\n * a real outage re-checks access and passes the host's gate.\n */\n\nimport { WebsocketProvider } from '@y/websocket';\nimport * as Y from '@y/y';\nimport { classifyClose } from './close-policy';\nimport {\n  type CollabAuth,\n  type CollabTokenResponse,\n  CollabTokenError,\n  mintCollabToken,\n} from './mint';\nimport { MAX_CONSECUTIVE_REMINTS, MIN_REFRESH_DELAY_MS, refreshDelayMs } from './token-refresh';\n\nexport type GenericDocStatus =\n  | 'connecting'\n  | 'connected'\n  | 'disconnected'\n  | 'closed'\n  | 'error';\n\nexport interface PresenceEntry {\n  clientId: number;\n  state: Record<string, unknown>;\n}\n\nexport interface GenericDocHandle {\n  /** The live shared document. Owned by the handle; destroyed with it. */\n  readonly doc: Y.Doc;\n  readonly status: GenericDocStatus;\n  /**\n   * Whether the initial server sync has completed for the current connection.\n   * `status === 'connected'` fires before the server state arrives, so a doc\n   * read immediately after connect can still be empty — gate first reads on\n   * this (or `waitForSync`).\n   */\n  readonly synced: boolean;\n  /**\n   * Whether every change made to this document has reached the server: `false` from a local edit\n   * until the server sends it back (`@y/websocket`'s `syncStatus.localUpdatesSynced`; yhub echoes\n   * every update to its sender). Kept across reconnects and re-mints: a replaced provider hands its\n   * unconfirmed edits to the next, and an edit made between providers waits for one. A host that\n   * closes the document while this is `false` loses those edits, unless a local copy keeps them.\n   */\n  readonly localChangesSynced: boolean;\n  /** Granted access from the last successful mint. */\n  readonly accessType: 'r' | 'rw' | null;\n  /** Terminal error, when status is 'error' or 'closed'. */\n  readonly error: Error | null;\n  /**\n   * Whether the document holds what the host's local copy stored (always `true` without one).\n   * Mount readers after it: until then the document is still empty.\n   */\n  readonly prepared: boolean;\n  /**\n   * A connection the host's `beforeConnect` held: the handle waits, sending nothing, until the\n   * host calls `resume()` (or destroys the handle).\n   */\n  readonly held: boolean;\n  /** Monotonic change counter — bumps on every status/presence notification. */\n  readonly version: number;\n  /**\n   * Resolve once the initial server sync completes; reject on timeout, on a\n   * terminal connection state, or if the handle is destroyed first.\n   */\n  waitForSync: (timeoutMs?: number) => Promise<void>;\n  getPresence: () => PresenceEntry[];\n  /** Broadcast this client's presence state (requires a live connection). */\n  setPresence: (state: Record<string, unknown> | null) => void;\n  /**\n   * Force an early token refresh. Session-preserving: the live connection\n   * stays up until the fresh token is minted; a failed mint retries on a\n   * short timer instead of dropping the session. Without a connection it\n   * reconnects now.\n   */\n  refreshNow: () => Promise<void>;\n  /** Connect past a hold, without asking `beforeConnect` again. */\n  resume: () => void;\n  /** Local edits the server has not echoed yet (handed between providers too), or `null`. */\n  unconfirmedEdits: () => Y.ContentIds | null;\n  onChange: (listener: () => void) => () => void;\n  destroy: () => void;\n}\n\n/**\n * Issues a room-bound Keryx token for one asset. The default calls the public\n * `/collab-token` route with the handle's `auth`; a host with its own trusted\n * mint (a desktop app's main process holding the user's key) passes one\n * instead, and the handle uses it for the first mint and every re-mint.\n */\nexport type CollabMint = (params: {\n  assetId: string;\n  access: 'view' | 'edit';\n}) => Promise<CollabTokenResponse>;\n\n/** What a host's local copy reads of the handle's transport. */\nexport interface GenericDocTransportView {\n  /** True for a transaction the transport applied (the server's state, a peer's edit). */\n  isRemoteOrigin: (origin: unknown) => boolean;\n  /** Local edits the server has not echoed yet, or `null`. */\n  getUnconfirmed: () => Y.ContentIds | null;\n  /** Connected, past the initial sync, and nothing unconfirmed. */\n  isFullySynced: () => boolean;\n}\n\n/** What `beforeConnect` is asked about. */\nexport interface GenericDocConnectGate {\n  /** The grant the connection would use (its access is the server's current verdict). */\n  grant: CollabTokenResponse;\n  /** The handle has not connected yet. */\n  firstConnection: boolean;\n  /** How long the handle had been without a connection, when it had one before. */\n  offlineForMs: number | null;\n  /** Local edits made without a connection (or inherited from an earlier session) wait to be sent. */\n  hasUnsyncedEdits: boolean;\n}\n\n/** A host's local copy of the document (`@athenaintel/local-copy` behind a host's glue). */\nexport interface GenericDocLocalCopy {\n  /**\n   * Called once, before the first mint: apply the stored copy to `doc` and return the local edits\n   * it holds that the server never acknowledged. The handle sends them and waits for their echo\n   * like its own. A failure here must resolve `{ unsyncedEdits: null }`: the handle then runs\n   * without a copy.\n   */\n  prepare: (params: {\n    doc: Y.Doc;\n    transport: GenericDocTransportView;\n  }) => Promise<{ unsyncedEdits: Y.ContentIds | null }>;\n  /** The handle's unconfirmed edits or sync state changed. */\n  transportChanged: () => void;\n  /**\n   * Asked after each mint and before the connection it would open: the first connection, a\n   * reconnect after an outage longer than `offlineGateAfterMs`, and a re-mint after a revocation\n   * (never a scheduled token refresh of a live connection, never past `resume()`). The host\n   * checks what it must before anything is sent (the document still opens here; access; edits\n   * made without a connection against the server's). `'hold'` keeps the handle from connecting\n   * until `resume()`; a throw counts as \"not yet\" and is asked again on the next attempt.\n   */\n  beforeConnect?: (gate: GenericDocConnectGate) => Promise<'connect' | 'hold'>;\n}\n\n/** After this long without a socket, the handle reconnects itself (re-mint, gate) instead of the provider. */\nexport const DEFAULT_OFFLINE_GATE_AFTER_MS = 15_000;\n\n/** Retry delays for a mint that failed for want of the network. */\nconst MINT_RETRY_DELAYS_MS = [1_000, 2_000, 4_000, 8_000, 15_000, 30_000, 60_000];\n\n/**\n * The default `retryMintError`: a network failure, a timeout, a rate limit or a server error is\n * worth retrying; a refusal (401/403/404) is the server's verdict and ends the handle.\n */\nexport function isRetryableMintError(error: unknown): boolean {\n  if (error instanceof CollabTokenError) {\n    return error.status >= 500 || error.status === 408 || error.status === 429;\n  }\n  return error instanceof TypeError || (error instanceof DOMException && error.name === 'TimeoutError');\n}\n\nfunction resolveMint({ auth, mint }: { auth?: CollabAuth; mint?: CollabMint }): CollabMint {\n  if (mint) return mint;\n  if (!auth) throw new Error('connectGenericDoc needs `auth` or `mint`');\n  return ({ assetId, access }) => mintCollabToken({ auth, assetId, access });\n}\n\nexport function connectGenericDoc(args: {\n  assetId: string;\n  /** Credentials for the default mint; not used when `mint` is given. */\n  auth?: CollabAuth;\n  access?: 'view' | 'edit';\n  mint?: CollabMint;\n  /** A local copy of the document the host keeps (see {@link GenericDocLocalCopy}). */\n  localCopy?: GenericDocLocalCopy;\n  /** Whether a failed mint is worth retrying; defaults to {@link isRetryableMintError}. */\n  retryMintError?: (error: unknown) => boolean;\n  /** See {@link DEFAULT_OFFLINE_GATE_AFTER_MS}. */\n  offlineGateAfterMs?: number;\n}): GenericDocHandle {\n  const access = args.access ?? 'view';\n  const mint = resolveMint({ auth: args.auth, mint: args.mint });\n  const localCopy = args.localCopy;\n  const retryMintError = args.retryMintError ?? isRetryableMintError;\n  const offlineGateAfterMs = args.offlineGateAfterMs ?? DEFAULT_OFFLINE_GATE_AFTER_MS;\n  const doc = new Y.Doc();\n  const listeners = new Set<() => void>();\n\n  let provider: WebsocketProvider | null = null;\n  let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n  let retryTimer: ReturnType<typeof setTimeout> | null = null;\n  let offlineTimer: ReturnType<typeof setTimeout> | null = null;\n  /** The provider whose socket was still opening, with nothing to send, at the threshold. */\n  let openingPastThreshold: WebsocketProvider | null = null;\n  let mintRetries = 0;\n  let destroyed = false;\n  let status: GenericDocStatus = 'connecting';\n  let synced = false;\n  let accessType: 'r' | 'rw' | null = null;\n  let error: Error | null = null;\n  let lastPresence: Record<string, unknown> | null = null;\n  let version = 0;\n  let consecutiveRemints = 0;\n  let prepared = localCopy === undefined;\n  let held = false;\n  let heldGrant: CollabTokenResponse | null = null;\n  let everConnected = false;\n  let disconnectedSince: number | null = null;\n  /** Bumped by every connect attempt: an attempt that finds it changed after an await stops. */\n  let connectSeq = 0;\n  /** Local edits no provider holds: handed on by a replaced provider, or made with none. */\n  let carriedUpdates: WebsocketProvider['unconfirmedUpdates'] = [];\n  let localChangesSynced = true;\n\n  const notify = () => {\n    version += 1;\n    for (const listener of listeners) listener();\n  };\n\n  const unconfirmedEdits = (): Y.ContentIds | null => {\n    const all = [...carriedUpdates, ...(provider?.unconfirmedUpdates ?? [])].map(\n      (entry) => entry.ids as Y.ContentIds\n    );\n    if (all.length === 0) return null;\n    return all.length === 1 ? (all[0] as Y.ContentIds) : Y.mergeContentIds(all);\n  };\n\n  const transport: GenericDocTransportView = {\n    isRemoteOrigin: (origin) => origin instanceof WebsocketProvider,\n    getUnconfirmed: unconfirmedEdits,\n    isFullySynced: () => status === 'connected' && synced && localChangesSynced,\n  };\n\n  const transportChanged = () => {\n    localCopy?.transportChanged();\n  };\n\n  const refreshLocalChangesSynced = () => {\n    const next = carriedUpdates.length === 0 && (provider?.unconfirmedUpdates.length ?? 0) === 0;\n    if (next !== localChangesSynced) {\n      localChangesSynced = next;\n      notify();\n    }\n    // After the flag: the copy reads `isFullySynced()` in its callback.\n    transportChanged();\n  };\n\n  // An edit made while no provider exists (a re-mint in flight, offline) is sent by the next one,\n  // which takes it as unconfirmed. The local copy's own load is not an edit.\n  doc.on('update', (update: Uint8Array, origin: unknown) => {\n    if (!prepared || provider !== null || destroyed || origin instanceof WebsocketProvider) return;\n    carriedUpdates = [\n      ...carriedUpdates,\n      { created: Date.now(), ids: Y.createContentIdsFromUpdate(update) },\n    ];\n    refreshLocalChangesSynced();\n  });\n\n  const setStatus = (next: GenericDocStatus, err: Error | null = null) => {\n    if (destroyed && next !== 'closed') return;\n    const wasConnected = status === 'connected';\n    status = next;\n    error = err;\n    if (next === 'connected') {\n      everConnected = true;\n      disconnectedSince = null;\n      clearOfflineTimer();\n    } else if (wasConnected || (everConnected && disconnectedSince === null)) {\n      disconnectedSince = Date.now();\n    }\n    transportChanged();\n    notify();\n  };\n\n  const clearRefreshTimer = () => {\n    if (refreshTimer !== null) {\n      clearTimeout(refreshTimer);\n      refreshTimer = null;\n    }\n  };\n\n  const clearRetryTimer = () => {\n    if (retryTimer !== null) {\n      clearTimeout(retryTimer);\n      retryTimer = null;\n    }\n  };\n\n  function clearOfflineTimer() {\n    if (offlineTimer !== null) {\n      clearTimeout(offlineTimer);\n      offlineTimer = null;\n    }\n  }\n\n  const teardownProvider = () => {\n    clearRefreshTimer();\n    // A future provider must complete its own initial sync; the doc keeps its\n    // content either way. Subscribers must observe the flip immediately —\n    // waiting for the next provider event would let them act on synced=true\n    // across the replacement gap.\n    if (synced) {\n      synced = false;\n      notify();\n    }\n    if (provider) {\n      // Its unconfirmed edits outlive it: the next provider sends them and waits for their echo.\n      carriedUpdates = [...carriedUpdates, ...provider.unconfirmedUpdates];\n      provider.destroy();\n      provider = null;\n    }\n  };\n\n  const scheduleRefresh = (grant: CollabTokenResponse) => {\n    clearRefreshTimer();\n    const delay = refreshDelayMs({ expiresAtMs: grant.expires_at_ms, now: Date.now() });\n    refreshTimer = setTimeout(() => {\n      void connect({ scheduledRefresh: true });\n    }, delay);\n  };\n\n  /** A failed attempt that is worth retrying: try again later, or as soon as the network returns. */\n  const scheduleRetry = () => {\n    clearRetryTimer();\n    const delay = MINT_RETRY_DELAYS_MS[Math.min(mintRetries, MINT_RETRY_DELAYS_MS.length - 1)];\n    mintRetries += 1;\n    retryTimer = setTimeout(() => {\n      retryTimer = null;\n      void connect();\n    }, delay);\n  };\n\n  const onBrowserOnline = () => {\n    // Only a handle waiting to retry: a refused or permanently closed one stays stopped.\n    if (destroyed || status === 'closed' || status === 'error' || provider !== null || held) return;\n    mintRetries = 0;\n    clearRetryTimer();\n    void connect();\n  };\n  if (typeof window !== 'undefined') window.addEventListener('online', onBrowserOnline);\n\n  /**\n   * Past the gate's threshold without a socket, the handle reconnects itself (re-mint, gate). A\n   * socket still being opened with nothing waiting to be sent is left to finish (a slow network\n   * is not restarted every threshold), and the handle looks again a threshold later; if it opens\n   * holding edits made since, they go through the gate first (`status`).\n   */\n  const armOfflineTakeover = () => {\n    if (offlineTimer !== null || !localCopy?.beforeConnect) return;\n    offlineTimer = setTimeout(() => {\n      offlineTimer = null;\n      if (destroyed || status === 'connected' || provider === null) return;\n      if (provider.wsconnecting && !hasUnsyncedLocalEdits()) {\n        openingPastThreshold = provider;\n        armOfflineTakeover();\n        return;\n      }\n      teardownProvider();\n      void connect();\n    }, offlineGateAfterMs);\n  };\n\n  const hasUnsyncedLocalEdits = () =>\n    carriedUpdates.length > 0 || (provider?.unconfirmedUpdates.length ?? 0) > 0;\n\n\n  const connect = async (opts?: {\n    scheduledRefresh?: boolean;\n    skipGate?: boolean;\n    grant?: CollabTokenResponse;\n  }): Promise<void> => {\n    if (destroyed) return;\n    await preparing;\n    if (destroyed) return;\n    const seq = ++connectSeq;\n    // Only a live connection is refreshed in place (and skips the host's gate); a refresh while the\n    // socket is down is a reconnect like any other.\n    const scheduledRefresh = opts?.scheduledRefresh === true && status === 'connected';\n    // A scheduled refresh mints FIRST and keeps the live session up: the old\n    // token has ~5 minutes of headroom, so a transient mint failure retries\n    // on a short timer instead of dropping a healthy connection.\n    if (!scheduledRefresh) {\n      teardownProvider();\n    } else {\n      clearRefreshTimer();\n    }\n    clearRetryTimer();\n    let grant: CollabTokenResponse;\n    if (opts?.grant && opts.grant.expires_at_ms - Date.now() > MIN_REFRESH_DELAY_MS) {\n      grant = opts.grant;\n    } else {\n      try {\n        grant = await mint({ assetId: args.assetId, access });\n      } catch (err) {\n        if (destroyed || seq !== connectSeq) return;\n        if (scheduledRefresh) {\n          refreshTimer = setTimeout(() => {\n            void connect({ scheduledRefresh: true });\n          }, MIN_REFRESH_DELAY_MS);\n          return;\n        }\n        if (retryMintError(err)) {\n          // Offline (or the mint's server is): keep the document and try again.\n          if (status !== 'disconnected') setStatus('disconnected');\n          scheduleRetry();\n          return;\n        }\n        // A denied mint is authoritative (revoked / not shared / not eligible).\n        setStatus('error', err instanceof Error ? err : new Error(String(err)));\n        return;\n      }\n    }\n    if (destroyed || seq !== connectSeq) return;\n    mintRetries = 0;\n    accessType = grant.access_type;\n    const beforeConnect = localCopy?.beforeConnect;\n    if (beforeConnect && !scheduledRefresh && !opts?.skipGate) {\n      const firstConnection = !everConnected;\n      const offlineForMs = disconnectedSince === null ? null : Date.now() - disconnectedSince;\n      let decision: 'connect' | 'hold';\n      try {\n        decision = await beforeConnect({\n          grant,\n          firstConnection,\n          offlineForMs,\n          hasUnsyncedEdits: hasUnsyncedLocalEdits(),\n        });\n      } catch {\n        if (destroyed || seq !== connectSeq) return;\n        if (status !== 'disconnected') setStatus('disconnected');\n        scheduleRetry();\n        return;\n      }\n      if (destroyed || seq !== connectSeq) return;\n      if (decision === 'hold') {\n        held = true;\n        heldGrant = grant;\n        if (status !== 'disconnected') setStatus('disconnected');\n        else notify();\n        return;\n      }\n    }\n    if (scheduledRefresh) {\n      teardownProvider();\n    }\n\n    const nextProvider = new WebsocketProvider(grant.ws_url, `${grant.org}/${grant.doc_id}`, doc, {\n      params: {\n        yauth: grant.token,\n        branch: grant.branch,\n        gc: 'true',\n      },\n      // BroadcastChannel would sync same-origin clients locally, bypassing the\n      // server's permission enforcement (a read-only tab could write into an\n      // editor tab's doc). Permissioned docs must round-trip the server.\n      disableBc: true,\n    });\n    provider = nextProvider;\n    nextProvider.unconfirmedUpdates = [...carriedUpdates, ...nextProvider.unconfirmedUpdates];\n    carriedUpdates = [];\n    refreshLocalChangesSynced();\n\n    nextProvider.on('sync-status', () => {\n      if (provider !== nextProvider) return;\n      refreshLocalChangesSynced();\n    });\n\n    nextProvider.on('status', (event: { status: 'connecting' | 'connected' | 'disconnected' }) => {\n      if (provider !== nextProvider) return;\n      if (\n        event.status === 'connected' &&\n        openingPastThreshold === nextProvider &&\n        hasUnsyncedLocalEdits()\n      ) {\n        // Opened after the threshold holding edits made meanwhile: before its handshake sends\n        // them (`@y/websocket` reports `connected` first), they go through the gate.\n        teardownProvider();\n        void connect();\n        return;\n      }\n      if (event.status === 'connected') {\n        consecutiveRemints = 0;\n      }\n      setStatus(event.status);\n      if (event.status === 'connected' && lastPresence !== null) {\n        nextProvider.awareness.setLocalState(lastPresence);\n      }\n      // `@y/websocket` reports `disconnected` only for a socket that had opened: one that never\n      // opens (the server unreachable while the mint goes through) only ever reports `connecting`,\n      // and is just as offline.\n      if (event.status !== 'connected') armOfflineTakeover();\n    });\n    // Its first `connecting` came from its constructor, before this listener existed.\n    if (!nextProvider.wsconnected) armOfflineTakeover();\n\n    nextProvider.on('sync', (state: boolean) => {\n      if (provider !== nextProvider) return;\n      if (synced !== state) {\n        synced = state;\n        transportChanged();\n        notify();\n      }\n    });\n\n    nextProvider.on('connection-close', (event: CloseEvent | null) => {\n      if (provider !== nextProvider) return;\n      const action = classifyClose(event?.code);\n      if (action === 'remint') {\n        // Revoked mid-session: a fresh mint re-runs the server-side permission\n        // check. If access is truly gone the mint 403s and we land in 'error'.\n        // Bounded: repeated 4401s without an intervening successful connect\n        // mean the server keeps rejecting freshly minted tokens — stop rather\n        // than loop mint→connect→kick.\n        consecutiveRemints += 1;\n        teardownProvider();\n        if (consecutiveRemints > MAX_CONSECUTIVE_REMINTS) {\n          setStatus(\n            'closed',\n            new Error('Access repeatedly revoked mid-session (4401); giving up.')\n          );\n          return;\n        }\n        void connect();\n      } else if (action === 'stop') {\n        teardownProvider();\n        setStatus(\n          'closed',\n          new Error(`Connection closed permanently (code ${event?.code ?? 'unknown'})`)\n        );\n      }\n      // 'retry': the provider's exponential backoff handles it, until the offline takeover.\n    });\n\n    nextProvider.awareness.on('change', () => {\n      if (provider !== nextProvider) return;\n      notify();\n    });\n\n    scheduleRefresh(grant);\n  };\n\n  const preparing: Promise<void> = localCopy\n    ? localCopy\n        .prepare({ doc, transport })\n        .catch(() => ({ unsyncedEdits: null }))\n        .then(({ unsyncedEdits }) => {\n          if (destroyed) return;\n          if (unsyncedEdits && !(unsyncedEdits.inserts.isEmpty() && unsyncedEdits.deletes.isEmpty())) {\n            carriedUpdates = [...carriedUpdates, { created: Date.now(), ids: unsyncedEdits }];\n          }\n          prepared = true;\n          refreshLocalChangesSynced();\n          notify();\n        })\n    : Promise.resolve();\n\n  void connect();\n\n  const waitForSync = (timeoutMs = 15_000): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      const terminal = (): Error | null => {\n        if (destroyed) return new Error('Handle destroyed before initial sync');\n        if (status === 'closed' || status === 'error') {\n          return error ?? new Error(`Connection ${status} before initial sync`);\n        }\n        return null;\n      };\n      if (synced) {\n        resolve();\n        return;\n      }\n      const immediate = terminal();\n      if (immediate) {\n        reject(immediate);\n        return;\n      }\n      const cleanup = () => {\n        clearTimeout(timer);\n        listeners.delete(listener);\n      };\n      const timer = setTimeout(() => {\n        cleanup();\n        reject(new Error(`Timed out after ${timeoutMs}ms waiting for initial sync`));\n      }, timeoutMs);\n      const listener = () => {\n        if (synced) {\n          cleanup();\n          resolve();\n          return;\n        }\n        const err = terminal();\n        if (err) {\n          cleanup();\n          reject(err);\n        }\n      };\n      listeners.add(listener);\n    });\n\n  return {\n    doc,\n    get status() {\n      return status;\n    },\n    get synced() {\n      return synced;\n    },\n    get localChangesSynced() {\n      return localChangesSynced;\n    },\n    get accessType() {\n      return accessType;\n    },\n    get error() {\n      return error;\n    },\n    get prepared() {\n      return prepared;\n    },\n    get held() {\n      return held;\n    },\n    get version() {\n      return version;\n    },\n    waitForSync,\n    getPresence: () => {\n      if (!provider) return [];\n      const entries: PresenceEntry[] = [];\n      provider.awareness.getStates().forEach((state, clientId) => {\n        entries.push({ clientId, state: state as Record<string, unknown> });\n      });\n      return entries;\n    },\n    setPresence: (state) => {\n      lastPresence = state;\n      provider?.awareness.setLocalState(state);\n    },\n    refreshNow: () => {\n      if (held) return Promise.resolve();\n      return provider ? connect({ scheduledRefresh: true }) : connect();\n    },\n    resume: () => {\n      if (!held || destroyed) return;\n      held = false;\n      const grant = heldGrant;\n      heldGrant = null;\n      notify();\n      void connect({ skipGate: true, grant: grant ?? undefined });\n    },\n    unconfirmedEdits,\n    onChange: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    destroy: () => {\n      if (destroyed) return;\n      destroyed = true;\n      teardownProvider();\n      clearRetryTimer();\n      clearOfflineTimer();\n      if (typeof window !== 'undefined') window.removeEventListener('online', onBrowserOnline);\n      status = 'closed';\n      // Final notification so pending waitForSync callers reject instead of\n      // hanging on listeners that are about to be dropped.\n      for (const listener of [...listeners]) listener();\n      listeners.clear();\n      doc.destroy();\n    },\n  };\n}\n\nexport { CollabTokenError };\nexport type { CollabAuth, CollabTokenResponse };\n"],"names":[],"mappings":"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"}

package/dist/collab/index.cjs

@@ -13,7 +13,9 @@ 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.DEFAULT_OFFLINE_GATE_AFTER_MS = client.DEFAULT_OFFLINE_GATE_AFTER_MS;
 exports.connectGenericDoc = client.connectGenericDoc;
+exports.isRetryableMintError = client.isRetryableMintError;
 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

@@ -17,7 +17,7 @@
  * in awareness contexts into titles the caller may see.
  */
 export { classifyClose, WS_CLOSE_AUTH_REVOKED, WS_CLOSE_DOC_DELETED } from './close-policy';
-export { CollabTokenError, connectGenericDoc, type CollabAuth, type CollabTokenResponse, type GenericDocHandle, type GenericDocStatus, type PresenceEntry, } from './client';
+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 { 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,5 @@
 import { WS_CLOSE_AUTH_REVOKED, WS_CLOSE_DOC_DELETED, classifyClose } from "./close-policy.js";
-import { connectGenericDoc } from "./client.js";
+import { DEFAULT_OFFLINE_GATE_AFTER_MS, connectGenericDoc, isRetryableMintError } from "./client.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";
@@ -10,6 +10,7 @@ import { defineDocShape } from "./shape.js";
 import { MAX_CONSECUTIVE_REMINTS, MIN_REFRESH_DELAY_MS, REFRESH_HEADROOM_MS, refreshDelayMs } from "./token-refresh.js";
 export {
   CollabTokenError,
+  DEFAULT_OFFLINE_GATE_AFTER_MS,
   MAX_CONSECUTIVE_REMINTS,
   MAX_PRESENCE_CONTEXTS_PER_SLOT,
   MAX_PRESENCE_STRING_CHARS,
@@ -28,6 +29,7 @@ export {
   defineDocShape,
   derivePresenceState,
   getAthenaApiBaseUrl,
+  isRetryableMintError,
   mergePresenceStates,
   mintCollabToken,
   mintWorkspacePresenceToken,

package/dist/composer/AttachmentContext.cjs

@@ -2,21 +2,46 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
 const react = require("react");
+const zustand = require("zustand");
+const vanilla = require("zustand/vanilla");
 const athenaUrls = require("../lib/athena-urls.cjs");
 const AttachmentCtx = react.createContext(null);
-function AttachmentProvider({ children }) {
-  const [attachments, setAttachments] = react.useState([]);
-  const [isUploading, setIsUploading] = react.useState(false);
-  const addAttachments = react.useCallback((assets) => {
-    setAttachments((prev) => [...prev, ...assets]);
-  }, []);
-  const removeAttachment = react.useCallback((id) => {
-    setAttachments((prev) => prev.filter((a) => a.id !== id));
-  }, []);
-  const clearAttachments = react.useCallback(() => setAttachments([]), []);
+function createAttachmentStore() {
+  return vanilla.createStore(() => ({ attachments: [], isUploading: false }));
+}
+function AttachmentProvider({
+  children,
+  store
+}) {
+  const outer = react.useContext(AttachmentCtx);
+  if (store) return /* @__PURE__ */ jsxRuntime.jsx(StoreAttachmentProvider, { store, children });
+  if (outer) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  return /* @__PURE__ */ jsxRuntime.jsx(OwnAttachmentProvider, { children });
+}
+function OwnAttachmentProvider({ children }) {
+  const [store] = react.useState(createAttachmentStore);
+  return /* @__PURE__ */ jsxRuntime.jsx(StoreAttachmentProvider, { store, children });
+}
+function StoreAttachmentProvider({
+  children,
+  store
+}) {
+  const attachments = zustand.useStore(store, (state) => state.attachments);
+  const isUploading = zustand.useStore(store, (state) => state.isUploading);
+  const actions = react.useMemo(
+    () => ({
+      addAttachments: (assets) => store.setState((state) => ({ attachments: [...state.attachments, ...assets] })),
+      removeAttachment: (id) => store.setState((state) => ({
+        attachments: state.attachments.filter((attachment) => attachment.id !== id)
+      })),
+      clearAttachments: () => store.setState({ attachments: [] }),
+      setIsUploading: (uploading) => store.setState({ isUploading: uploading })
+    }),
+    [store]
+  );
   const value = react.useMemo(
-    () => ({ attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading }),
-    [attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading]
+    () => ({ attachments, isUploading, ...actions }),
+    [attachments, isUploading, actions]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(AttachmentCtx.Provider, { value, children });
 }
@@ -36,5 +61,6 @@ function buildAttachmentMarkdownWithAppUrl({
 }
 exports.AttachmentProvider = AttachmentProvider;
 exports.buildAttachmentMarkdownWithAppUrl = buildAttachmentMarkdownWithAppUrl;
+exports.createAttachmentStore = createAttachmentStore;
 exports.useAttachments = useAttachments;
 //# sourceMappingURL=AttachmentContext.cjs.map

package/dist/composer/AttachmentContext.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentContext.cjs","sources":["../../src/composer/AttachmentContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useMemo, useState, type ReactNode } from 'react';\nimport { createAthenaSpacesUrl, DEFAULT_APP_URL } from '../lib/athena-urls';\nimport type { UploadedAsset } from './useFileUpload';\n\ninterface AttachmentContextValue {\n  attachments: UploadedAsset[];\n  addAttachments: (assets: UploadedAsset[]) => void;\n  removeAttachment: (id: string) => void;\n  clearAttachments: () => void;\n  /** True when one or more files are currently being uploaded. */\n  isUploading: boolean;\n  setIsUploading: (v: boolean) => void;\n}\n\nconst AttachmentCtx = createContext<AttachmentContextValue | null>(null);\n\nexport function AttachmentProvider({ children }: { children: ReactNode }) {\n  const [attachments, setAttachments] = useState<UploadedAsset[]>([]);\n  const [isUploading, setIsUploading] = useState(false);\n\n  const addAttachments = useCallback((assets: UploadedAsset[]) => {\n    setAttachments((prev) => [...prev, ...assets]);\n  }, []);\n\n  const removeAttachment = useCallback((id: string) => {\n    setAttachments((prev) => prev.filter((a) => a.id !== id));\n  }, []);\n\n  const clearAttachments = useCallback(() => setAttachments([]), []);\n\n  const value = useMemo(\n    () => ({ attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading }),\n    [attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading],\n  );\n\n  return (\n    <AttachmentCtx.Provider value={value}>\n      {children}\n    </AttachmentCtx.Provider>\n  );\n}\n\nexport function useAttachments(): AttachmentContextValue {\n  const ctx = useContext(AttachmentCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAttachments must be used within <AttachmentProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Build the markdown references for the current attachments.\n * Returns empty string if no attachments.\n *\n * @deprecated Use `buildAttachmentMarkdownWithAppUrl` to avoid defaulting links to the production Athena app URL.\n */\nexport function buildAttachmentMarkdown(attachments: UploadedAsset[]): string {\n  return buildAttachmentMarkdownWithAppUrl({ attachments });\n}\n\nexport function buildAttachmentMarkdownWithAppUrl({\n  attachments,\n  appUrl = DEFAULT_APP_URL,\n}: {\n  attachments: UploadedAsset[];\n  appUrl?: string;\n}): string {\n  if (attachments.length === 0) return '';\n  return attachments\n    .map((attachment) => `[@${attachment.title}](${createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`)\n    .join('\\n');\n}\n"],"names":["createContext","useState","useCallback","useMemo","jsx","useContext","DEFAULT_APP_URL","createAthenaSpacesUrl"],"mappings":";;;;;AAcA,MAAM,gBAAgBA,MAAAA,cAA6C,IAAI;AAEhE,SAAS,mBAAmB,EAAE,YAAqC;AACxE,QAAM,CAAC,aAAa,cAAc,IAAIC,MAAAA,SAA0B,CAAA,CAAE;AAClE,QAAM,CAAC,aAAa,cAAc,IAAIA,MAAAA,SAAS,KAAK;AAEpD,QAAM,iBAAiBC,kBAAY,CAAC,WAA4B;AAC9D,mBAAe,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AAAA,EAC/C,GAAG,CAAA,CAAE;AAEL,QAAM,mBAAmBA,kBAAY,CAAC,OAAe;AACnD,mBAAe,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAAA,EAC1D,GAAG,CAAA,CAAE;AAEL,QAAM,mBAAmBA,MAAAA,YAAY,MAAM,eAAe,CAAA,CAAE,GAAG,CAAA,CAAE;AAEjE,QAAM,QAAQC,MAAAA;AAAAA,IACZ,OAAO,EAAE,aAAa,gBAAgB,kBAAkB,kBAAkB,aAAa;IACvF,CAAC,aAAa,gBAAgB,kBAAkB,kBAAkB,aAAa,cAAc;AAAA,EAAA;AAG/F,SACEC,2BAAAA,IAAC,cAAc,UAAd,EAAuB,OACrB,SAAA,CACH;AAEJ;AAEO,SAAS,iBAAyC;AACvD,QAAM,MAAMC,MAAAA,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qEAAqE;AAAA,EACvF;AACA,SAAO;AACT;AAYO,SAAS,kCAAkC;AAAA,EAChD;AAAA,EACA,SAASC,WAAAA;AACX,GAGW;AACT,MAAI,YAAY,WAAW,EAAG,QAAO;AACrC,SAAO,YACJ,IAAI,CAAC,eAAe,KAAK,WAAW,KAAK,KAAKC,WAAAA,sBAAsB,EAAE,QAAQ,UAAU,WAAW,GAAA,CAAI,CAAC,GAAG,EAC3G,KAAK,IAAI;AACd;;;;"}
+{"version":3,"file":"AttachmentContext.cjs","sources":["../../src/composer/AttachmentContext.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, useState, type ReactNode } from 'react';\nimport { useStore } from 'zustand';\nimport { createStore, type StoreApi } from 'zustand/vanilla';\nimport { createAthenaSpacesUrl, DEFAULT_APP_URL } from '../lib/athena-urls';\nimport type { UploadedAsset } from './useFileUpload';\n\ninterface AttachmentContextValue {\n  attachments: UploadedAsset[];\n  addAttachments: (assets: UploadedAsset[]) => void;\n  removeAttachment: (id: string) => void;\n  clearAttachments: () => void;\n  /** True when one or more files are currently being uploaded. */\n  isUploading: boolean;\n  setIsUploading: (v: boolean) => void;\n}\n\nconst AttachmentCtx = createContext<AttachmentContextValue | null>(null);\n\ninterface AttachmentStoreState {\n  attachments: UploadedAsset[];\n  isUploading: boolean;\n}\n\n/**\n * A composer's staged attachments, kept outside React (`createAttachmentStore`):\n * a host that shows several chats gives each its own, and keeps it while that\n * chat's `AthenaChat` remounts (a tab moving between windows).\n */\nexport type AttachmentStore = StoreApi<AttachmentStoreState>;\n\n/** An empty `AttachmentStore`, for `<AttachmentProvider store>`. */\nexport function createAttachmentStore(): AttachmentStore {\n  return createStore<AttachmentStoreState>(() => ({ attachments: [], isUploading: false }));\n}\n\n/**\n * Staged attachments for the composer. With a `store`, they are that store's,\n * whatever is mounted above: one per chat when a host shows several. Without\n * one, a provider already mounted above (a host's, outliving a remounting\n * \\`AthenaChat\\` such as a tab moving between windows) is reused instead of\n * starting empty.\n */\nexport function AttachmentProvider({\n  children,\n  store,\n}: {\n  children: ReactNode;\n  store?: AttachmentStore;\n}) {\n  const outer = useContext(AttachmentCtx);\n  if (store) return <StoreAttachmentProvider store={store}>{children}</StoreAttachmentProvider>;\n  if (outer) return <>{children}</>;\n  return <OwnAttachmentProvider>{children}</OwnAttachmentProvider>;\n}\n\nfunction OwnAttachmentProvider({ children }: { children: ReactNode }) {\n  const [store] = useState(createAttachmentStore);\n  return <StoreAttachmentProvider store={store}>{children}</StoreAttachmentProvider>;\n}\n\nfunction StoreAttachmentProvider({\n  children,\n  store,\n}: {\n  children: ReactNode;\n  store: AttachmentStore;\n}) {\n  const attachments = useStore(store, (state) => state.attachments);\n  const isUploading = useStore(store, (state) => state.isUploading);\n  const actions = useMemo(\n    () => ({\n      addAttachments: (assets: UploadedAsset[]) =>\n        store.setState((state) => ({ attachments: [...state.attachments, ...assets] })),\n      removeAttachment: (id: string) =>\n        store.setState((state) => ({\n          attachments: state.attachments.filter((attachment) => attachment.id !== id),\n        })),\n      clearAttachments: () => store.setState({ attachments: [] }),\n      setIsUploading: (uploading: boolean) => store.setState({ isUploading: uploading }),\n    }),\n    [store],\n  );\n  const value = useMemo(\n    () => ({ attachments, isUploading, ...actions }),\n    [attachments, isUploading, actions],\n  );\n\n  return (\n    <AttachmentCtx.Provider value={value}>\n      {children}\n    </AttachmentCtx.Provider>\n  );\n}\n\nexport function useAttachments(): AttachmentContextValue {\n  const ctx = useContext(AttachmentCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAttachments must be used within <AttachmentProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Build the markdown references for the current attachments.\n * Returns empty string if no attachments.\n *\n * @deprecated Use `buildAttachmentMarkdownWithAppUrl` to avoid defaulting links to the production Athena app URL.\n */\nexport function buildAttachmentMarkdown(attachments: UploadedAsset[]): string {\n  return buildAttachmentMarkdownWithAppUrl({ attachments });\n}\n\nexport function buildAttachmentMarkdownWithAppUrl({\n  attachments,\n  appUrl = DEFAULT_APP_URL,\n}: {\n  attachments: UploadedAsset[];\n  appUrl?: string;\n}): string {\n  if (attachments.length === 0) return '';\n  return attachments\n    .map((attachment) => `[@${attachment.title}](${createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`)\n    .join('\\n');\n}\n"],"names":["createContext","createStore","useContext","jsx","Fragment","useState","useStore","useMemo","DEFAULT_APP_URL","createAthenaSpacesUrl"],"mappings":";;;;;;;AAgBA,MAAM,gBAAgBA,MAAAA,cAA6C,IAAI;AAehE,SAAS,wBAAyC;AACvD,SAAOC,QAAAA,YAAkC,OAAO,EAAE,aAAa,CAAA,GAAI,aAAa,QAAQ;AAC1F;AASO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AACF,GAGG;AACD,QAAM,QAAQC,MAAAA,WAAW,aAAa;AACtC,MAAI,MAAO,QAAOC,2BAAAA,IAAC,yBAAA,EAAwB,OAAe,UAAS;AACnE,MAAI,MAAO,QAAOA,2BAAAA,IAAAC,WAAAA,UAAA,EAAG,SAAA,CAAS;AAC9B,SAAOD,+BAAC,yBAAuB,UAAS;AAC1C;AAEA,SAAS,sBAAsB,EAAE,YAAqC;AACpE,QAAM,CAAC,KAAK,IAAIE,MAAAA,SAAS,qBAAqB;AAC9C,SAAOF,2BAAAA,IAAC,yBAAA,EAAwB,OAAe,SAAA,CAAS;AAC1D;AAEA,SAAS,wBAAwB;AAAA,EAC/B;AAAA,EACA;AACF,GAGG;AACD,QAAM,cAAcG,QAAAA,SAAS,OAAO,CAAC,UAAU,MAAM,WAAW;AAChE,QAAM,cAAcA,QAAAA,SAAS,OAAO,CAAC,UAAU,MAAM,WAAW;AAChE,QAAM,UAAUC,MAAAA;AAAAA,IACd,OAAO;AAAA,MACL,gBAAgB,CAAC,WACf,MAAM,SAAS,CAAC,WAAW,EAAE,aAAa,CAAC,GAAG,MAAM,aAAa,GAAG,MAAM,IAAI;AAAA,MAChF,kBAAkB,CAAC,OACjB,MAAM,SAAS,CAAC,WAAW;AAAA,QACzB,aAAa,MAAM,YAAY,OAAO,CAAC,eAAe,WAAW,OAAO,EAAE;AAAA,MAAA,EAC1E;AAAA,MACJ,kBAAkB,MAAM,MAAM,SAAS,EAAE,aAAa,CAAA,GAAI;AAAA,MAC1D,gBAAgB,CAAC,cAAuB,MAAM,SAAS,EAAE,aAAa,WAAW;AAAA,IAAA;AAAA,IAEnF,CAAC,KAAK;AAAA,EAAA;AAER,QAAM,QAAQA,MAAAA;AAAAA,IACZ,OAAO,EAAE,aAAa,aAAa,GAAG,QAAA;AAAA,IACtC,CAAC,aAAa,aAAa,OAAO;AAAA,EAAA;AAGpC,SACEJ,2BAAAA,IAAC,cAAc,UAAd,EAAuB,OACrB,SAAA,CACH;AAEJ;AAEO,SAAS,iBAAyC;AACvD,QAAM,MAAMD,MAAAA,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qEAAqE;AAAA,EACvF;AACA,SAAO;AACT;AAYO,SAAS,kCAAkC;AAAA,EAChD;AAAA,EACA,SAASM,WAAAA;AACX,GAGW;AACT,MAAI,YAAY,WAAW,EAAG,QAAO;AACrC,SAAO,YACJ,IAAI,CAAC,eAAe,KAAK,WAAW,KAAK,KAAKC,WAAAA,sBAAsB,EAAE,QAAQ,UAAU,WAAW,GAAA,CAAI,CAAC,GAAG,EAC3G,KAAK,IAAI;AACd;;;;;"}

package/dist/composer/AttachmentContext.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from 'react';
+import { type StoreApi } from 'zustand/vanilla';
 import type { UploadedAsset } from './useFileUpload';
 interface AttachmentContextValue {
     attachments: UploadedAsset[];
@@ -9,8 +10,28 @@ interface AttachmentContextValue {
     isUploading: boolean;
     setIsUploading: (v: boolean) => void;
 }
-export declare function AttachmentProvider({ children }: {
+interface AttachmentStoreState {
+    attachments: UploadedAsset[];
+    isUploading: boolean;
+}
+/**
+ * A composer's staged attachments, kept outside React (`createAttachmentStore`):
+ * a host that shows several chats gives each its own, and keeps it while that
+ * chat's `AthenaChat` remounts (a tab moving between windows).
+ */
+export type AttachmentStore = StoreApi<AttachmentStoreState>;
+/** An empty `AttachmentStore`, for `<AttachmentProvider store>`. */
+export declare function createAttachmentStore(): AttachmentStore;
+/**
+ * Staged attachments for the composer. With a `store`, they are that store's,
+ * whatever is mounted above: one per chat when a host shows several. Without
+ * one, a provider already mounted above (a host's, outliving a remounting
+ * \`AthenaChat\` such as a tab moving between windows) is reused instead of
+ * starting empty.
+ */
+export declare function AttachmentProvider({ children, store, }: {
     children: ReactNode;
+    store?: AttachmentStore;
 }): import("react").JSX.Element;
 export declare function useAttachments(): AttachmentContextValue;
 /**

package/dist/composer/AttachmentContext.js

@@ -1,20 +1,45 @@
-import { jsx } from "react/jsx-runtime";
-import { useState, useCallback, useMemo, useContext, createContext } from "react";
+import { jsx, Fragment } from "react/jsx-runtime";
+import { useContext, createContext, useMemo, useState } from "react";
+import { useStore } from "zustand";
+import { createStore } from "zustand/vanilla";
 import { createAthenaSpacesUrl, DEFAULT_APP_URL } from "../lib/athena-urls.js";
 const AttachmentCtx = createContext(null);
-function AttachmentProvider({ children }) {
-  const [attachments, setAttachments] = useState([]);
-  const [isUploading, setIsUploading] = useState(false);
-  const addAttachments = useCallback((assets) => {
-    setAttachments((prev) => [...prev, ...assets]);
-  }, []);
-  const removeAttachment = useCallback((id) => {
-    setAttachments((prev) => prev.filter((a) => a.id !== id));
-  }, []);
-  const clearAttachments = useCallback(() => setAttachments([]), []);
+function createAttachmentStore() {
+  return createStore(() => ({ attachments: [], isUploading: false }));
+}
+function AttachmentProvider({
+  children,
+  store
+}) {
+  const outer = useContext(AttachmentCtx);
+  if (store) return /* @__PURE__ */ jsx(StoreAttachmentProvider, { store, children });
+  if (outer) return /* @__PURE__ */ jsx(Fragment, { children });
+  return /* @__PURE__ */ jsx(OwnAttachmentProvider, { children });
+}
+function OwnAttachmentProvider({ children }) {
+  const [store] = useState(createAttachmentStore);
+  return /* @__PURE__ */ jsx(StoreAttachmentProvider, { store, children });
+}
+function StoreAttachmentProvider({
+  children,
+  store
+}) {
+  const attachments = useStore(store, (state) => state.attachments);
+  const isUploading = useStore(store, (state) => state.isUploading);
+  const actions = useMemo(
+    () => ({
+      addAttachments: (assets) => store.setState((state) => ({ attachments: [...state.attachments, ...assets] })),
+      removeAttachment: (id) => store.setState((state) => ({
+        attachments: state.attachments.filter((attachment) => attachment.id !== id)
+      })),
+      clearAttachments: () => store.setState({ attachments: [] }),
+      setIsUploading: (uploading) => store.setState({ isUploading: uploading })
+    }),
+    [store]
+  );
   const value = useMemo(
-    () => ({ attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading }),
-    [attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading]
+    () => ({ attachments, isUploading, ...actions }),
+    [attachments, isUploading, actions]
   );
   return /* @__PURE__ */ jsx(AttachmentCtx.Provider, { value, children });
 }
@@ -35,6 +60,7 @@ function buildAttachmentMarkdownWithAppUrl({
 export {
   AttachmentProvider,
   buildAttachmentMarkdownWithAppUrl,
+  createAttachmentStore,
   useAttachments
 };
 //# sourceMappingURL=AttachmentContext.js.map

package/dist/composer/AttachmentContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentContext.js","sources":["../../src/composer/AttachmentContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useMemo, useState, type ReactNode } from 'react';\nimport { createAthenaSpacesUrl, DEFAULT_APP_URL } from '../lib/athena-urls';\nimport type { UploadedAsset } from './useFileUpload';\n\ninterface AttachmentContextValue {\n  attachments: UploadedAsset[];\n  addAttachments: (assets: UploadedAsset[]) => void;\n  removeAttachment: (id: string) => void;\n  clearAttachments: () => void;\n  /** True when one or more files are currently being uploaded. */\n  isUploading: boolean;\n  setIsUploading: (v: boolean) => void;\n}\n\nconst AttachmentCtx = createContext<AttachmentContextValue | null>(null);\n\nexport function AttachmentProvider({ children }: { children: ReactNode }) {\n  const [attachments, setAttachments] = useState<UploadedAsset[]>([]);\n  const [isUploading, setIsUploading] = useState(false);\n\n  const addAttachments = useCallback((assets: UploadedAsset[]) => {\n    setAttachments((prev) => [...prev, ...assets]);\n  }, []);\n\n  const removeAttachment = useCallback((id: string) => {\n    setAttachments((prev) => prev.filter((a) => a.id !== id));\n  }, []);\n\n  const clearAttachments = useCallback(() => setAttachments([]), []);\n\n  const value = useMemo(\n    () => ({ attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading }),\n    [attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading],\n  );\n\n  return (\n    <AttachmentCtx.Provider value={value}>\n      {children}\n    </AttachmentCtx.Provider>\n  );\n}\n\nexport function useAttachments(): AttachmentContextValue {\n  const ctx = useContext(AttachmentCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAttachments must be used within <AttachmentProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Build the markdown references for the current attachments.\n * Returns empty string if no attachments.\n *\n * @deprecated Use `buildAttachmentMarkdownWithAppUrl` to avoid defaulting links to the production Athena app URL.\n */\nexport function buildAttachmentMarkdown(attachments: UploadedAsset[]): string {\n  return buildAttachmentMarkdownWithAppUrl({ attachments });\n}\n\nexport function buildAttachmentMarkdownWithAppUrl({\n  attachments,\n  appUrl = DEFAULT_APP_URL,\n}: {\n  attachments: UploadedAsset[];\n  appUrl?: string;\n}): string {\n  if (attachments.length === 0) return '';\n  return attachments\n    .map((attachment) => `[@${attachment.title}](${createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`)\n    .join('\\n');\n}\n"],"names":[],"mappings":";;;AAcA,MAAM,gBAAgB,cAA6C,IAAI;AAEhE,SAAS,mBAAmB,EAAE,YAAqC;AACxE,QAAM,CAAC,aAAa,cAAc,IAAI,SAA0B,CAAA,CAAE;AAClE,QAAM,CAAC,aAAa,cAAc,IAAI,SAAS,KAAK;AAEpD,QAAM,iBAAiB,YAAY,CAAC,WAA4B;AAC9D,mBAAe,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AAAA,EAC/C,GAAG,CAAA,CAAE;AAEL,QAAM,mBAAmB,YAAY,CAAC,OAAe;AACnD,mBAAe,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAAA,EAC1D,GAAG,CAAA,CAAE;AAEL,QAAM,mBAAmB,YAAY,MAAM,eAAe,CAAA,CAAE,GAAG,CAAA,CAAE;AAEjE,QAAM,QAAQ;AAAA,IACZ,OAAO,EAAE,aAAa,gBAAgB,kBAAkB,kBAAkB,aAAa;IACvF,CAAC,aAAa,gBAAgB,kBAAkB,kBAAkB,aAAa,cAAc;AAAA,EAAA;AAG/F,SACE,oBAAC,cAAc,UAAd,EAAuB,OACrB,SAAA,CACH;AAEJ;AAEO,SAAS,iBAAyC;AACvD,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qEAAqE;AAAA,EACvF;AACA,SAAO;AACT;AAYO,SAAS,kCAAkC;AAAA,EAChD;AAAA,EACA,SAAS;AACX,GAGW;AACT,MAAI,YAAY,WAAW,EAAG,QAAO;AACrC,SAAO,YACJ,IAAI,CAAC,eAAe,KAAK,WAAW,KAAK,KAAK,sBAAsB,EAAE,QAAQ,UAAU,WAAW,GAAA,CAAI,CAAC,GAAG,EAC3G,KAAK,IAAI;AACd;"}
+{"version":3,"file":"AttachmentContext.js","sources":["../../src/composer/AttachmentContext.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, useState, type ReactNode } from 'react';\nimport { useStore } from 'zustand';\nimport { createStore, type StoreApi } from 'zustand/vanilla';\nimport { createAthenaSpacesUrl, DEFAULT_APP_URL } from '../lib/athena-urls';\nimport type { UploadedAsset } from './useFileUpload';\n\ninterface AttachmentContextValue {\n  attachments: UploadedAsset[];\n  addAttachments: (assets: UploadedAsset[]) => void;\n  removeAttachment: (id: string) => void;\n  clearAttachments: () => void;\n  /** True when one or more files are currently being uploaded. */\n  isUploading: boolean;\n  setIsUploading: (v: boolean) => void;\n}\n\nconst AttachmentCtx = createContext<AttachmentContextValue | null>(null);\n\ninterface AttachmentStoreState {\n  attachments: UploadedAsset[];\n  isUploading: boolean;\n}\n\n/**\n * A composer's staged attachments, kept outside React (`createAttachmentStore`):\n * a host that shows several chats gives each its own, and keeps it while that\n * chat's `AthenaChat` remounts (a tab moving between windows).\n */\nexport type AttachmentStore = StoreApi<AttachmentStoreState>;\n\n/** An empty `AttachmentStore`, for `<AttachmentProvider store>`. */\nexport function createAttachmentStore(): AttachmentStore {\n  return createStore<AttachmentStoreState>(() => ({ attachments: [], isUploading: false }));\n}\n\n/**\n * Staged attachments for the composer. With a `store`, they are that store's,\n * whatever is mounted above: one per chat when a host shows several. Without\n * one, a provider already mounted above (a host's, outliving a remounting\n * \\`AthenaChat\\` such as a tab moving between windows) is reused instead of\n * starting empty.\n */\nexport function AttachmentProvider({\n  children,\n  store,\n}: {\n  children: ReactNode;\n  store?: AttachmentStore;\n}) {\n  const outer = useContext(AttachmentCtx);\n  if (store) return <StoreAttachmentProvider store={store}>{children}</StoreAttachmentProvider>;\n  if (outer) return <>{children}</>;\n  return <OwnAttachmentProvider>{children}</OwnAttachmentProvider>;\n}\n\nfunction OwnAttachmentProvider({ children }: { children: ReactNode }) {\n  const [store] = useState(createAttachmentStore);\n  return <StoreAttachmentProvider store={store}>{children}</StoreAttachmentProvider>;\n}\n\nfunction StoreAttachmentProvider({\n  children,\n  store,\n}: {\n  children: ReactNode;\n  store: AttachmentStore;\n}) {\n  const attachments = useStore(store, (state) => state.attachments);\n  const isUploading = useStore(store, (state) => state.isUploading);\n  const actions = useMemo(\n    () => ({\n      addAttachments: (assets: UploadedAsset[]) =>\n        store.setState((state) => ({ attachments: [...state.attachments, ...assets] })),\n      removeAttachment: (id: string) =>\n        store.setState((state) => ({\n          attachments: state.attachments.filter((attachment) => attachment.id !== id),\n        })),\n      clearAttachments: () => store.setState({ attachments: [] }),\n      setIsUploading: (uploading: boolean) => store.setState({ isUploading: uploading }),\n    }),\n    [store],\n  );\n  const value = useMemo(\n    () => ({ attachments, isUploading, ...actions }),\n    [attachments, isUploading, actions],\n  );\n\n  return (\n    <AttachmentCtx.Provider value={value}>\n      {children}\n    </AttachmentCtx.Provider>\n  );\n}\n\nexport function useAttachments(): AttachmentContextValue {\n  const ctx = useContext(AttachmentCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAttachments must be used within <AttachmentProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Build the markdown references for the current attachments.\n * Returns empty string if no attachments.\n *\n * @deprecated Use `buildAttachmentMarkdownWithAppUrl` to avoid defaulting links to the production Athena app URL.\n */\nexport function buildAttachmentMarkdown(attachments: UploadedAsset[]): string {\n  return buildAttachmentMarkdownWithAppUrl({ attachments });\n}\n\nexport function buildAttachmentMarkdownWithAppUrl({\n  attachments,\n  appUrl = DEFAULT_APP_URL,\n}: {\n  attachments: UploadedAsset[];\n  appUrl?: string;\n}): string {\n  if (attachments.length === 0) return '';\n  return attachments\n    .map((attachment) => `[@${attachment.title}](${createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`)\n    .join('\\n');\n}\n"],"names":[],"mappings":";;;;;AAgBA,MAAM,gBAAgB,cAA6C,IAAI;AAehE,SAAS,wBAAyC;AACvD,SAAO,YAAkC,OAAO,EAAE,aAAa,CAAA,GAAI,aAAa,QAAQ;AAC1F;AASO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AACF,GAGG;AACD,QAAM,QAAQ,WAAW,aAAa;AACtC,MAAI,MAAO,QAAO,oBAAC,yBAAA,EAAwB,OAAe,UAAS;AACnE,MAAI,MAAO,QAAO,oBAAA,UAAA,EAAG,SAAA,CAAS;AAC9B,SAAO,oBAAC,yBAAuB,UAAS;AAC1C;AAEA,SAAS,sBAAsB,EAAE,YAAqC;AACpE,QAAM,CAAC,KAAK,IAAI,SAAS,qBAAqB;AAC9C,SAAO,oBAAC,yBAAA,EAAwB,OAAe,SAAA,CAAS;AAC1D;AAEA,SAAS,wBAAwB;AAAA,EAC/B;AAAA,EACA;AACF,GAGG;AACD,QAAM,cAAc,SAAS,OAAO,CAAC,UAAU,MAAM,WAAW;AAChE,QAAM,cAAc,SAAS,OAAO,CAAC,UAAU,MAAM,WAAW;AAChE,QAAM,UAAU;AAAA,IACd,OAAO;AAAA,MACL,gBAAgB,CAAC,WACf,MAAM,SAAS,CAAC,WAAW,EAAE,aAAa,CAAC,GAAG,MAAM,aAAa,GAAG,MAAM,IAAI;AAAA,MAChF,kBAAkB,CAAC,OACjB,MAAM,SAAS,CAAC,WAAW;AAAA,QACzB,aAAa,MAAM,YAAY,OAAO,CAAC,eAAe,WAAW,OAAO,EAAE;AAAA,MAAA,EAC1E;AAAA,MACJ,kBAAkB,MAAM,MAAM,SAAS,EAAE,aAAa,CAAA,GAAI;AAAA,MAC1D,gBAAgB,CAAC,cAAuB,MAAM,SAAS,EAAE,aAAa,WAAW;AAAA,IAAA;AAAA,IAEnF,CAAC,KAAK;AAAA,EAAA;AAER,QAAM,QAAQ;AAAA,IACZ,OAAO,EAAE,aAAa,aAAa,GAAG,QAAA;AAAA,IACtC,CAAC,aAAa,aAAa,OAAO;AAAA,EAAA;AAGpC,SACE,oBAAC,cAAc,UAAd,EAAuB,OACrB,SAAA,CACH;AAEJ;AAEO,SAAS,iBAAyC;AACvD,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qEAAqE;AAAA,EACvF;AACA,SAAO;AACT;AAYO,SAAS,kCAAkC;AAAA,EAChD;AAAA,EACA,SAAS;AACX,GAGW;AACT,MAAI,YAAY,WAAW,EAAG,QAAO;AACrC,SAAO,YACJ,IAAI,CAAC,eAAe,KAAK,WAAW,KAAK,KAAK,sBAAsB,EAAE,QAAQ,UAAU,WAAW,GAAA,CAAI,CAAC,GAAG,EAC3G,KAAK,IAAI;AACd;"}

package/dist/composer/QuoteContext.cjs

@@ -2,11 +2,32 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
 const react = require("react");
+const zustand = require("zustand");
+const vanilla = require("zustand/vanilla");
 const QuoteCtx = react.createContext(null);
-function QuoteProvider({ children }) {
-  const [quote, setQuote] = react.useState(null);
-  const clearQuote = react.useCallback(() => setQuote(null), []);
-  const value = react.useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);
+function createQuoteStore() {
+  return vanilla.createStore(() => ({ quote: null }));
+}
+function QuoteProvider({ children, store }) {
+  const outer = react.useContext(QuoteCtx);
+  if (store) return /* @__PURE__ */ jsxRuntime.jsx(StoreQuoteProvider, { store, children });
+  if (outer) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  return /* @__PURE__ */ jsxRuntime.jsx(OwnQuoteProvider, { children });
+}
+function OwnQuoteProvider({ children }) {
+  const [store] = react.useState(createQuoteStore);
+  return /* @__PURE__ */ jsxRuntime.jsx(StoreQuoteProvider, { store, children });
+}
+function StoreQuoteProvider({ children, store }) {
+  const quote = zustand.useStore(store, (state) => state.quote);
+  const actions = react.useMemo(
+    () => ({
+      setQuote: (next) => store.setState({ quote: next }),
+      clearQuote: () => store.setState({ quote: null })
+    }),
+    [store]
+  );
+  const value = react.useMemo(() => ({ quote, ...actions }), [quote, actions]);
   return /* @__PURE__ */ jsxRuntime.jsx(QuoteCtx.Provider, { value, children });
 }
 function useQuote() {
@@ -16,38 +37,66 @@ function useQuote() {
   }
   return ctx;
 }
-function isDirectChildFrame(source) {
-  if (!source || source === window) return false;
-  for (const frame of document.querySelectorAll("iframe")) {
+function isDirectChildFrame(source, win = window) {
+  if (!source || source === win) return false;
+  for (const frame of win.document.querySelectorAll("iframe")) {
     if (frame.contentWindow === source) return true;
   }
   try {
-    return Reflect.get(source, "parent") === window;
+    return Reflect.get(source, "parent") === win;
   } catch {
     return false;
   }
 }
-function useQuoteFromPostMessage() {
+const CHAT_ROOT_SELECTOR = ".aui-thread-root";
+const lastFocusedChatRoots = /* @__PURE__ */ new WeakMap();
+function elementOf(node) {
+  if (!node) return null;
+  return node.nodeType === 1 ? node : node.parentElement;
+}
+function useQuoteFromPostMessage({ scope } = {}) {
   const { setQuote } = useQuote();
   react.useEffect(() => {
+    var _a;
+    const doc = ((_a = scope == null ? void 0 : scope.current) == null ? void 0 : _a.ownerDocument) ?? document;
+    const win = doc.defaultView ?? window;
+    const chatRoot = () => {
+      var _a2;
+      return ((_a2 = scope == null ? void 0 : scope.current) == null ? void 0 : _a2.closest(CHAT_ROOT_SELECTOR)) ?? null;
+    };
+    const takes = (anchor) => {
+      var _a2;
+      const mine = chatRoot();
+      if (!mine) return true;
+      const owner = ((_a2 = elementOf(anchor)) == null ? void 0 : _a2.closest(CHAT_ROOT_SELECTOR)) ?? null;
+      if (owner) return owner === mine;
+      const remembered = lastFocusedChatRoots.get(doc);
+      const focused = (remembered == null ? void 0 : remembered.isConnected) ? remembered : doc.querySelector(CHAT_ROOT_SELECTOR);
+      return focused === mine;
+    };
+    const handleFocusIn = (event) => {
+      const mine = chatRoot();
+      const target = event.target;
+      if (mine && target && typeof target.nodeType === "number" && mine.contains(target)) {
+        lastFocusedChatRoots.set(doc, mine);
+      }
+    };
     const handleKeydown = (e) => {
-      var _a;
+      var _a2;
       if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "l") {
-        const sel = window.getSelection();
-        const selection = (_a = sel == null ? void 0 : sel.toString()) == null ? void 0 : _a.trim();
-        if (selection && selection.length > 0) {
+        const sel = doc.getSelection();
+        const selection = (_a2 = sel == null ? void 0 : sel.toString()) == null ? void 0 : _a2.trim();
+        if (selection && selection.length > 0 && takes((sel == null ? void 0 : sel.anchorNode) ?? null)) {
           e.preventDefault();
           let messageId;
           let role;
-          let node = sel == null ? void 0 : sel.anchorNode;
-          while (node && node !== document.body) {
-            if (node instanceof HTMLElement) {
-              const dataRole = node.getAttribute("data-role");
-              if (dataRole === "assistant" || dataRole === "user") {
-                role = dataRole;
-                messageId = node.getAttribute("data-message-id") ?? void 0;
-                break;
-              }
+          let node = elementOf(sel == null ? void 0 : sel.anchorNode);
+          while (node && node !== doc.body) {
+            const dataRole = node.getAttribute("data-role");
+            if (dataRole === "assistant" || dataRole === "user") {
+              role = dataRole;
+              messageId = node.getAttribute("data-message-id") ?? void 0;
+              break;
             }
             node = node.parentElement;
           }
@@ -57,7 +106,7 @@ function useQuoteFromPostMessage() {
     };
     const handleMessage = (event) => {
       const data = event.data;
-      if (data && typeof data === "object" && data.type === "athena-add-to-composer" && typeof data.text === "string" && data.text.trim().length > 0 && isDirectChildFrame(event.source)) {
+      if (data && typeof data === "object" && data.type === "athena-add-to-composer" && typeof data.text === "string" && data.text.trim().length > 0 && isDirectChildFrame(event.source, win) && takes(null)) {
         setQuote({
           text: data.text,
           sourceTitle: data.sourceTitle,
@@ -65,15 +114,18 @@ function useQuoteFromPostMessage() {
         });
       }
     };
-    document.addEventListener("keydown", handleKeydown, true);
-    window.addEventListener("message", handleMessage);
+    doc.addEventListener("keydown", handleKeydown, true);
+    doc.addEventListener("focusin", handleFocusIn, true);
+    win.addEventListener("message", handleMessage);
     return () => {
-      document.removeEventListener("keydown", handleKeydown, true);
-      window.removeEventListener("message", handleMessage);
+      doc.removeEventListener("keydown", handleKeydown, true);
+      doc.removeEventListener("focusin", handleFocusIn, true);
+      win.removeEventListener("message", handleMessage);
     };
-  }, [setQuote]);
+  }, [scope, setQuote]);
 }
 exports.QuoteProvider = QuoteProvider;
+exports.createQuoteStore = createQuoteStore;
 exports.isDirectChildFrame = isDirectChildFrame;
 exports.useQuote = useQuote;
 exports.useQuoteFromPostMessage = useQuoteFromPostMessage;

package/dist/composer/QuoteContext.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"QuoteContext.cjs","sources":["../../src/composer/QuoteContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState, type ReactNode } from 'react';\n\nexport interface QuoteData {\n  /** The selected/quoted text. */\n  text: string;\n  /** Title of the source (e.g., asset title, document name). */\n  sourceTitle?: string;\n  /** Asset ID of the source (for attribution). */\n  sourceAssetId?: string;\n  /** Message ID of the source message (when quoting from chat). */\n  sourceMessageId?: string;\n  /** Role of the source message ('assistant' | 'user'). */\n  sourceRole?: string;\n}\n\ninterface QuoteContextValue {\n  quote: QuoteData | null;\n  setQuote: (quote: QuoteData | null) => void;\n  clearQuote: () => void;\n}\n\nconst QuoteCtx = createContext<QuoteContextValue | null>(null);\n\nexport function QuoteProvider({ children }: { children: ReactNode }) {\n  const [quote, setQuote] = useState<QuoteData | null>(null);\n  const clearQuote = useCallback(() => setQuote(null), []);\n\n  const value = useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);\n\n  return (\n    <QuoteCtx.Provider value={value}>\n      {children}\n    </QuoteCtx.Provider>\n  );\n}\n\nexport function useQuote(): QuoteContextValue {\n  const ctx = useContext(QuoteCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useQuote must be used within <QuoteProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Whether a message came from a frame embedded directly in this window, for\n * any origin: the window of one of this document's iframes (an identity\n * comparison, safe cross-origin), or, for a frame inside a shadow root, a\n * window whose `parent` is this window (`parent` is readable on a\n * cross-origin window). A message port, a worker, this window itself, a\n * grandchild frame or an unrelated window is refused.\n */\nexport function isDirectChildFrame(source: MessageEventSource | null): boolean {\n  if (!source || source === window) return false;\n  for (const frame of document.querySelectorAll('iframe')) {\n    if (frame.contentWindow === source) return true;\n  }\n  try {\n    return Reflect.get(source, 'parent') === window;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Listens for:\n * 1. Cmd+L / Ctrl+L keydown — grabs the current text selection and sets it as a quote.\n *    `preventDefault` stops the browser from focusing the URL bar.\n * 2. PostMessage events from child iframes (asset panels, embedded content)\n *    with type `athena-add-to-composer`, only from a frame embedded directly\n *    in this window ({@link isDirectChildFrame}).\n *\n * Mount this once inside AthenaProvider.\n */\nexport function useQuoteFromPostMessage() {\n  const { setQuote } = useQuote();\n\n  useEffect(() => {\n    // ── Cmd+L / Ctrl+L keyboard handler ──────────────────────────────\n    const handleKeydown = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'l') {\n        const sel = window.getSelection();\n        const selection = sel?.toString()?.trim();\n\n        if (selection && selection.length > 0) {\n          e.preventDefault();\n\n          // Walk up from the selection anchor to find the message container.\n          // assistant-ui message roots have data-role=\"assistant\" or data-role=\"user\".\n          let messageId: string | undefined;\n          let role: string | undefined;\n          let node = sel?.anchorNode as HTMLElement | null;\n          while (node && node !== document.body) {\n            if (node instanceof HTMLElement) {\n              const dataRole = node.getAttribute('data-role');\n              if (dataRole === 'assistant' || dataRole === 'user') {\n                role = dataRole;\n                // assistant-ui sets data-message-id on message roots\n                messageId = node.getAttribute('data-message-id') ?? undefined;\n                break;\n              }\n            }\n            node = node.parentElement;\n          }\n\n          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });\n        }\n      }\n    };\n\n    // ── PostMessage handler (from iframes) ───────────────────────────\n    // Accepts messages from any origin, but only from a frame embedded\n    // directly in this window: the SDK consumer controls which iframes are\n    // embedded, and that is the trust boundary. A popup, an opener or another\n    // tab holding a reference to this window cannot stage composer text.\n    const handleMessage = (event: MessageEvent) => {\n      const data = event.data;\n      if (\n        data &&\n        typeof data === 'object' &&\n        data.type === 'athena-add-to-composer' &&\n        typeof data.text === 'string' &&\n        data.text.trim().length > 0 &&\n        isDirectChildFrame(event.source)\n      ) {\n        setQuote({\n          text: data.text,\n          sourceTitle: data.sourceTitle,\n          sourceAssetId: data.sourceAssetId,\n        });\n      }\n    };\n\n    document.addEventListener('keydown', handleKeydown, true); // capture phase to beat the browser\n    window.addEventListener('message', handleMessage);\n\n    return () => {\n      document.removeEventListener('keydown', handleKeydown, true);\n      window.removeEventListener('message', handleMessage);\n    };\n  }, [setQuote]);\n}\n"],"names":["createContext","useState","useCallback","useMemo","jsx","useContext","useEffect"],"mappings":";;;;AAqBA,MAAM,WAAWA,MAAAA,cAAwC,IAAI;AAEtD,SAAS,cAAc,EAAE,YAAqC;AACnE,QAAM,CAAC,OAAO,QAAQ,IAAIC,MAAAA,SAA2B,IAAI;AACzD,QAAM,aAAaC,MAAAA,YAAY,MAAM,SAAS,IAAI,GAAG,CAAA,CAAE;AAEvD,QAAM,QAAQC,MAAAA,QAAQ,OAAO,EAAE,OAAO,UAAU,WAAA,IAAe,CAAC,OAAO,UAAU,UAAU,CAAC;AAE5F,SACEC,2BAAAA,IAAC,SAAS,UAAT,EAAkB,OAChB,SAAA,CACH;AAEJ;AAEO,SAAS,WAA8B;AAC5C,QAAM,MAAMC,MAAAA,WAAW,QAAQ;AAC/B,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO;AACT;AAUO,SAAS,mBAAmB,QAA4C;AAC7E,MAAI,CAAC,UAAU,WAAW,OAAQ,QAAO;AACzC,aAAW,SAAS,SAAS,iBAAiB,QAAQ,GAAG;AACvD,QAAI,MAAM,kBAAkB,OAAQ,QAAO;AAAA,EAC7C;AACA,MAAI;AACF,WAAO,QAAQ,IAAI,QAAQ,QAAQ,MAAM;AAAA,EAC3C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAYO,SAAS,0BAA0B;AACxC,QAAM,EAAE,SAAA,IAAa,SAAA;AAErBC,QAAAA,UAAU,MAAM;AAEd,UAAM,gBAAgB,CAAC,MAAqB;;AAC1C,WAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,YAAA,MAAkB,KAAK;AAC3D,cAAM,MAAM,OAAO,aAAA;AACnB,cAAM,aAAY,gCAAK,eAAL,mBAAiB;AAEnC,YAAI,aAAa,UAAU,SAAS,GAAG;AACrC,YAAE,eAAA;AAIF,cAAI;AACJ,cAAI;AACJ,cAAI,OAAO,2BAAK;AAChB,iBAAO,QAAQ,SAAS,SAAS,MAAM;AACrC,gBAAI,gBAAgB,aAAa;AAC/B,oBAAM,WAAW,KAAK,aAAa,WAAW;AAC9C,kBAAI,aAAa,eAAe,aAAa,QAAQ;AACnD,uBAAO;AAEP,4BAAY,KAAK,aAAa,iBAAiB,KAAK;AACpD;AAAA,cACF;AAAA,YACF;AACA,mBAAO,KAAK;AAAA,UACd;AAEA,mBAAS,EAAE,MAAM,WAAW,YAAY,MAAM,iBAAiB,WAAW;AAAA,QAC5E;AAAA,MACF;AAAA,IACF;AAOA,UAAM,gBAAgB,CAAC,UAAwB;AAC7C,YAAM,OAAO,MAAM;AACnB,UACE,QACA,OAAO,SAAS,YAChB,KAAK,SAAS,4BACd,OAAO,KAAK,SAAS,YACrB,KAAK,KAAK,OAAO,SAAS,KAC1B,mBAAmB,MAAM,MAAM,GAC/B;AACA,iBAAS;AAAA,UACP,MAAM,KAAK;AAAA,UACX,aAAa,KAAK;AAAA,UAClB,eAAe,KAAK;AAAA,QAAA,CACrB;AAAA,MACH;AAAA,IACF;AAEA,aAAS,iBAAiB,WAAW,eAAe,IAAI;AACxD,WAAO,iBAAiB,WAAW,aAAa;AAEhD,WAAO,MAAM;AACX,eAAS,oBAAoB,WAAW,eAAe,IAAI;AAC3D,aAAO,oBAAoB,WAAW,aAAa;AAAA,IACrD;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AACf;;;;;"}
+{"version":3,"file":"QuoteContext.cjs","sources":["../../src/composer/QuoteContext.tsx"],"sourcesContent":["import {\n  createContext,\n  type RefObject,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from 'react';\nimport { useStore } from 'zustand';\nimport { createStore, type StoreApi } from 'zustand/vanilla';\n\nexport interface QuoteData {\n  /** The selected/quoted text. */\n  text: string;\n  /** Title of the source (e.g., asset title, document name). */\n  sourceTitle?: string;\n  /** Asset ID of the source (for attribution). */\n  sourceAssetId?: string;\n  /** Message ID of the source message (when quoting from chat). */\n  sourceMessageId?: string;\n  /** Role of the source message ('assistant' | 'user'). */\n  sourceRole?: string;\n}\n\ninterface QuoteContextValue {\n  quote: QuoteData | null;\n  setQuote: (quote: QuoteData | null) => void;\n  clearQuote: () => void;\n}\n\nconst QuoteCtx = createContext<QuoteContextValue | null>(null);\n\ninterface QuoteStoreState {\n  quote: QuoteData | null;\n}\n\n/**\n * A composer's pending quote, kept outside React (`createQuoteStore`), like\n * `AttachmentStore`: one per chat when a host shows several.\n */\nexport type QuoteStore = StoreApi<QuoteStoreState>;\n\n/** An empty `QuoteStore`, for `<QuoteProvider store>`. */\nexport function createQuoteStore(): QuoteStore {\n  return createStore<QuoteStoreState>(() => ({ quote: null }));\n}\n\n/**\n * The composer's pending quote. Like \\`AttachmentProvider\\`, a `store` makes\n * it that store's, and without one it reuses a provider already mounted\n * above, so a host can keep the quote across a remounting \\`AthenaChat\\`.\n */\nexport function QuoteProvider({ children, store }: { children: ReactNode; store?: QuoteStore }) {\n  const outer = useContext(QuoteCtx);\n  if (store) return <StoreQuoteProvider store={store}>{children}</StoreQuoteProvider>;\n  if (outer) return <>{children}</>;\n  return <OwnQuoteProvider>{children}</OwnQuoteProvider>;\n}\n\nfunction OwnQuoteProvider({ children }: { children: ReactNode }) {\n  const [store] = useState(createQuoteStore);\n  return <StoreQuoteProvider store={store}>{children}</StoreQuoteProvider>;\n}\n\nfunction StoreQuoteProvider({ children, store }: { children: ReactNode; store: QuoteStore }) {\n  const quote = useStore(store, (state) => state.quote);\n  const actions = useMemo(\n    () => ({\n      setQuote: (next: QuoteData | null) => store.setState({ quote: next }),\n      clearQuote: () => store.setState({ quote: null }),\n    }),\n    [store],\n  );\n  const value = useMemo(() => ({ quote, ...actions }), [quote, actions]);\n\n  return (\n    <QuoteCtx.Provider value={value}>\n      {children}\n    </QuoteCtx.Provider>\n  );\n}\n\nexport function useQuote(): QuoteContextValue {\n  const ctx = useContext(QuoteCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useQuote must be used within <QuoteProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Whether a message came from a frame embedded directly in this window, for\n * any origin: the window of one of this document's iframes (an identity\n * comparison, safe cross-origin), or, for a frame inside a shadow root, a\n * window whose `parent` is this window (`parent` is readable on a\n * cross-origin window). A message port, a worker, this window itself, a\n * grandchild frame or an unrelated window is refused. `win` is the window the\n * message came to (default: this one), e.g. a popped-out chat's.\n */\nexport function isDirectChildFrame(\n  source: MessageEventSource | null,\n  win: Window = window,\n): boolean {\n  if (!source || source === win) return false;\n  for (const frame of win.document.querySelectorAll('iframe')) {\n    if (frame.contentWindow === source) return true;\n  }\n  try {\n    return Reflect.get(source, 'parent') === win;\n  } catch {\n    return false;\n  }\n}\n\n/** `AthenaChat`'s thread root: the chats `useQuoteFromPostMessage` tells apart. */\nconst CHAT_ROOT_SELECTOR = '.aui-thread-root';\n\n/**\n * The chat the person last focused in each window, which takes a quote that\n * names no chat (a selection outside every chat, an embedded frame's text)\n * when that window shows several. A focus, not data: no state of the chats\n * themselves.\n */\nconst lastFocusedChatRoots = new WeakMap<Document, Element>();\n\n/** The element a node is, or sits in; duck-typed, since a pop-out window's nodes are another realm's. */\nfunction elementOf(node: Node | null | undefined): Element | null {\n  if (!node) return null;\n  return node.nodeType === 1 ? (node as Element) : node.parentElement;\n}\n\nexport interface QuoteFromPostMessageOptions {\n  /**\n   * An element inside the chat this composer belongs to. With several chats in\n   * one window, a ⌘L selection goes to the chat it was made in, and one made\n   * outside every chat (or an embedded frame's text) to the chat the person\n   * last focused; the keys and an embedded frame's messages are heard in this\n   * element's own window, a pop-out included. Without it, every quote is this\n   * composer's, as before.\n   */\n  scope?: RefObject<Element | null>;\n}\n\n/**\n * Listens for:\n * 1. Cmd+L / Ctrl+L keydown — grabs the current text selection and sets it as a quote.\n *    `preventDefault` stops the browser from focusing the URL bar.\n * 2. PostMessage events from child iframes (asset panels, embedded content)\n *    with type `athena-add-to-composer`, only from a frame embedded directly\n *    in this window ({@link isDirectChildFrame}).\n *\n * Mount this once per composer inside AthenaProvider (`AthenaChat` does).\n */\nexport function useQuoteFromPostMessage({ scope }: QuoteFromPostMessageOptions = {}) {\n  const { setQuote } = useQuote();\n\n  useEffect(() => {\n    const doc = scope?.current?.ownerDocument ?? document;\n    const win = doc.defaultView ?? window;\n    const chatRoot = () => scope?.current?.closest(CHAT_ROOT_SELECTOR) ?? null;\n    // Whether this composer takes a quote made at `anchor` (null: one that names no chat).\n    const takes = (anchor: Node | null) => {\n      const mine = chatRoot();\n      if (!mine) return true;\n      const owner = elementOf(anchor)?.closest(CHAT_ROOT_SELECTOR) ?? null;\n      if (owner) return owner === mine;\n      const remembered = lastFocusedChatRoots.get(doc);\n      const focused = remembered?.isConnected ? remembered : doc.querySelector(CHAT_ROOT_SELECTOR);\n      return focused === mine;\n    };\n\n    const handleFocusIn = (event: FocusEvent) => {\n      const mine = chatRoot();\n      const target = event.target as Node | null;\n      if (mine && target && typeof target.nodeType === 'number' && mine.contains(target)) {\n        lastFocusedChatRoots.set(doc, mine);\n      }\n    };\n\n    // ── Cmd+L / Ctrl+L keyboard handler ──────────────────────────────\n    const handleKeydown = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'l') {\n        const sel = doc.getSelection();\n        const selection = sel?.toString()?.trim();\n\n        if (selection && selection.length > 0 && takes(sel?.anchorNode ?? null)) {\n          e.preventDefault();\n\n          // Walk up from the selection anchor to find the message container.\n          // assistant-ui message roots have data-role=\"assistant\" or data-role=\"user\".\n          let messageId: string | undefined;\n          let role: string | undefined;\n          let node = elementOf(sel?.anchorNode);\n          while (node && node !== doc.body) {\n            const dataRole = node.getAttribute('data-role');\n            if (dataRole === 'assistant' || dataRole === 'user') {\n              role = dataRole;\n              // assistant-ui sets data-message-id on message roots\n              messageId = node.getAttribute('data-message-id') ?? undefined;\n              break;\n            }\n            node = node.parentElement;\n          }\n\n          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });\n        }\n      }\n    };\n\n    // ── PostMessage handler (from iframes) ───────────────────────────\n    // Accepts messages from any origin, but only from a frame embedded\n    // directly in this window: the SDK consumer controls which iframes are\n    // embedded, and that is the trust boundary. A popup, an opener or another\n    // tab holding a reference to this window cannot stage composer text.\n    const handleMessage = (event: MessageEvent) => {\n      const data = event.data;\n      if (\n        data &&\n        typeof data === 'object' &&\n        data.type === 'athena-add-to-composer' &&\n        typeof data.text === 'string' &&\n        data.text.trim().length > 0 &&\n        isDirectChildFrame(event.source, win) &&\n        takes(null)\n      ) {\n        setQuote({\n          text: data.text,\n          sourceTitle: data.sourceTitle,\n          sourceAssetId: data.sourceAssetId,\n        });\n      }\n    };\n\n    doc.addEventListener('keydown', handleKeydown, true); // capture phase to beat the browser\n    doc.addEventListener('focusin', handleFocusIn, true);\n    win.addEventListener('message', handleMessage);\n\n    return () => {\n      doc.removeEventListener('keydown', handleKeydown, true);\n      doc.removeEventListener('focusin', handleFocusIn, true);\n      win.removeEventListener('message', handleMessage);\n    };\n  }, [scope, setQuote]);\n}\n"],"names":["createContext","createStore","useContext","jsx","Fragment","useState","useStore","useMemo","useEffect","_a"],"mappings":"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"}