@athenaintel/react 0.48.0 → 0.52.1

package/dist/agent-runtime/src/send-recovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"send-recovery.js","sources":["../../../../agent-runtime/src/send-recovery.ts"],"sourcesContent":["import type {\n  StatewireDiagnosticsCommandUpdate,\n  StatewireDiagnosticsRecorder,\n} from './statewire-diagnostics';\nimport { isDeepAgentStateHydrated } from './statewire-state';\nimport type { StatewireFailedSendEntry, StatewireFailedSendLane } from './thread-extras';\n\n/**\n * Transport-level send durability for the deep-agent thread (the successor to\n * Olympus' localStorage outbox, #29368 → #31504).\n *\n * The durable journal itself is the statewire session record: every command is\n * persisted through the mounted session storage from `send()` until the server\n * durably admits or judges it, and a reload resends survivors on the SAME lane\n * seq (exactly-once — the server absorbs replayed seqs at or below its\n * watermark). What the record cannot recover on its own is a send the client\n * had to settle without a server verdict — a proven session loss or a record\n * reset settles it `lost`/`aborted` and RETAINS it in the record's failed lane\n * (message-carrying sends only), where the vendor drops it as soon as a\n * canonical snapshot shows the message landed (`failureCovered`).\n *\n * This controller turns that persisted failed lane back into live sends: once\n * the thread snapshot has hydrated (so covered entries are already gone), every\n * failed send the server NEVER judged is re-dispatched through the thread's own\n * `retryFailed` — same client-minted message id, re-anchored against the\n * current thread — which the host dedupes by id (a still-queued id re-places,\n * a durable one rejects `duplicate-id`). Server-judged fates (`rejected`,\n * `failed`, `crashed`, `expired`) are the user's decision and stay in the\n * manual retry/discard affordance.\n *\n * Ordering: an `aborted` send stamped `predecessorLost` was never attempted\n * because an earlier send of the same batch WAS attempted and settled `lost`\n * — it may or may not have run. Re-dispatching the successor first could land\n * it ahead of a predecessor that later turns out to have landed too, so the\n * successor is held until every preceding `lost` predecessor has settled: it\n * was covered by a snapshot, its retry was judged by the server, or the user\n * discarded it.\n */\n\n/** Fates the server never saw: the send died client-side (unmount, stream\n * gone, session lost) and is safe to re-dispatch under its original message\n * id. The complement — rejected/failed/crashed/expired — is server-judged. */\nconst AUTO_RETRY_FATES: ReadonlySet<string> = new Set(['lost', 'aborted']);\n\n/** A failed send is re-dispatched at most this many times per attach; a\n * persistent failure (repeated session losses) stays in the manual lane. */\nconst MAX_AUTO_RETRIES_PER_MESSAGE = 3;\n\n/** Persisted failures older than this stay manual: auto-sending a message the\n * user abandoned a day ago is worse than surfacing it for a decision. Mirrors\n * the retired outbox's retention window. */\nconst MAX_AUTO_RETRY_AGE_MS = 24 * 60 * 60 * 1000;\n\nexport interface DeepAgentSendRecoveryOptions {\n  /**\n   * Reads the thread's failed-send lane. `null` while it is unavailable (the\n   * client has not mounted yet, or its extras are not a statewire thread) —\n   * the controller stays armed and retries on the next state change.\n   */\n  lane: () => StatewireFailedSendLane | null;\n  /**\n   * Persisted failure stamps (message id → epoch ms of the original send) for\n   * the freshness gate. `null`/absent means no persistence is readable — every\n   * lane entry then counts as fresh (an in-memory failed lane can only hold\n   * failures from this page session).\n   */\n  failureStamps?: (() => ReadonlyMap<string, number> | null) | undefined;\n  /** Transport lifecycle recorder; read per event so a late-mounted recorder still sees retries. */\n  diagnostics?: (() => StatewireDiagnosticsRecorder | undefined) | undefined;\n  /** Injectable clock (tests). */\n  now?: () => number;\n  /** Sweep scheduler; defaults to `queueMicrotask` so a sweep never dispatches\n   * from inside a statewire flush or a React render. */\n  schedule?: (task: () => void) => void;\n}\n\nexport interface DeepAgentSendRecovery {\n  /** Feed every (normalized) statewire state change; hydration arms the mount sweep. */\n  observeStateChange(state: unknown): void;\n  /** Feed every command-lifecycle update; a never-server-judged settle arms a sweep. */\n  observeCommand(update: StatewireDiagnosticsCommandUpdate): void;\n  /** Feed client notifications too: failed history can publish after the\n   * command settles, without any change to the canonical thread snapshot. */\n  observeFailedLaneChange(): void;\n  dispose(): void;\n}\n\n/** Whether a settle failure is a client-side death the recovery re-dispatches\n * (the server never judged the command). Exported for host-side telemetry. */\nexport function shouldAutoRetryFailedSend(failure: { fate: string } | undefined): boolean {\n  return failure !== undefined && AUTO_RETRY_FATES.has(failure.fate);\n}\n\n/** Whether a failed entry must wait for a lost predecessor to settle first. */\nfunction awaitsLostPredecessor(entry: StatewireFailedSendEntry): boolean {\n  return entry.sendFailure.fate === 'aborted' && entry.sendFailure.predecessorLost === true;\n}\n\n/** The client-minted message id a run send carries, off a command update's params. */\nfunction commandMessageId(update: StatewireDiagnosticsCommandUpdate): string | null {\n  const first = update.params?.[0] as { message?: { id?: unknown } } | undefined;\n  const id = first?.message?.id;\n  return typeof id === 'string' ? id : null;\n}\n\nexport function createDeepAgentSendRecovery(\n  options: DeepAgentSendRecoveryOptions\n): DeepAgentSendRecovery {\n  const now = options.now ?? Date.now;\n  const schedule = options.schedule ?? ((task: () => void) => queueMicrotask(task));\n\n  let disposed = false;\n  let hydrated = false;\n  /** Work may exist: set at hydration and on retryable settles, cleared by a\n   * sweep that could actually read the lane. */\n  let armed = false;\n  let sweepScheduled = false;\n  /** Retry budget per message id, for this controller's attach lifetime. */\n  const attempts = new Map<string, number>();\n  /** Message ids already diagnosed as stale/exhausted, so the lane re-scan\n   * stays quiet about them. */\n  const surfacedSkips = new Set<string>();\n  /** Message ids whose deferral behind a lost predecessor was diagnosed once. */\n  const surfacedDeferrals = new Set<string>();\n  /** Re-dispatched sends still awaiting the server's verdict: a successor\n   * stamped `predecessorLost` waits while any of these is pending. */\n  const inFlight = new Set<string>();\n  /** Successors held back by the last sweep; a non-empty set keeps the\n   * controller armed so the next settle or state change re-sweeps. */\n  const deferred = new Set<string>();\n\n  const record = (event: string, data?: Record<string, unknown>): void => {\n    options.diagnostics?.()?.record(event, data);\n  };\n\n  const sweep = (): void => {\n    sweepScheduled = false;\n    if (disposed || !hydrated || !armed) return;\n    const lane = options.lane();\n    // No readable lane yet: stay armed so the next state change re-sweeps.\n    if (lane === null) return;\n    armed = false;\n    deferred.clear();\n    const stamps = options.failureStamps?.() ?? null;\n    // A `lost` entry earlier in lane order that this sweep leaves unsettled\n    // (skipped as stale/exhausted, or re-dispatched and now in flight).\n    let lostPredecessorPending = false;\n    for (const entry of lane.failed) {\n      if (!shouldAutoRetryFailedSend(entry.sendFailure)) continue;\n      // Shared retry/discard may still be waiting for the storage lock. The\n      // visible lane can keep this entry until then; do not spend another\n      // attempt on a send whose previous retry is still awaiting a verdict.\n      if (inFlight.has(entry.id)) {\n        if (entry.sendFailure.fate === 'lost') lostPredecessorPending = true;\n        continue;\n      }\n      if (awaitsLostPredecessor(entry) && (lostPredecessorPending || inFlight.size > 0)) {\n        deferred.add(entry.id);\n        if (!surfacedDeferrals.has(entry.id)) {\n          surfacedDeferrals.add(entry.id);\n          record('send-recovery/deferred', { messageId: entry.id });\n        }\n        continue;\n      }\n      const isLost = entry.sendFailure.fate === 'lost';\n      const stamp = stamps?.get(entry.id);\n      if (stamp !== undefined && now() - stamp > MAX_AUTO_RETRY_AGE_MS) {\n        if (!surfacedSkips.has(entry.id)) {\n          surfacedSkips.add(entry.id);\n          record('send-recovery/stale', { messageId: entry.id, ageMs: Math.round(now() - stamp) });\n        }\n        if (isLost) lostPredecessorPending = true;\n        continue;\n      }\n      const attempt = (attempts.get(entry.id) ?? 0) + 1;\n      if (attempt > MAX_AUTO_RETRIES_PER_MESSAGE) {\n        if (!surfacedSkips.has(entry.id)) {\n          surfacedSkips.add(entry.id);\n          record('send-recovery/exhausted', { messageId: entry.id });\n        }\n        if (isLost) lostPredecessorPending = true;\n        continue;\n      }\n      try {\n        lane.retryFailed(entry.id);\n        attempts.set(entry.id, attempt);\n        inFlight.add(entry.id);\n        if (isLost) lostPredecessorPending = true;\n        record('send-recovery/retry', {\n          messageId: entry.id,\n          fate: entry.sendFailure.fate,\n          attempt,\n        });\n      } catch {\n        // The entry settled or was covered between the lane read and the\n        // retry (the vendor drops covered failures against every snapshot);\n        // nothing was dispatched.\n        record('send-recovery/raced', { messageId: entry.id });\n      }\n    }\n    // Held successors must be revisited once their predecessors settle.\n    if (deferred.size > 0) armed = true;\n  };\n\n  const scheduleSweep = (): void => {\n    if (disposed || sweepScheduled || !hydrated || !armed) return;\n    sweepScheduled = true;\n    schedule(sweep);\n  };\n\n  return {\n    observeStateChange(state) {\n      if (disposed) return;\n      if (!hydrated && isDeepAgentStateHydrated(state)) {\n        // First real snapshot: the vendor's failureCovered pass has had its\n        // chance to drop entries whose message actually landed, so whatever\n        // remains provably never reached the thread.\n        hydrated = true;\n        armed = true;\n      }\n      scheduleSweep();\n    },\n    observeCommand(update) {\n      if (disposed || update.status !== 'settled') return;\n      const messageId = commandMessageId(update);\n      if (messageId !== null) inFlight.delete(messageId);\n      // A never-server-judged settle means new work; any settle while\n      // successors are held may be the predecessor they wait on.\n      if (!shouldAutoRetryFailedSend(update.failure) && deferred.size === 0) return;\n      armed = true;\n      scheduleSweep();\n    },\n    observeFailedLaneChange() {\n      if (disposed) return;\n      armed = true;\n      scheduleSweep();\n    },\n    dispose() {\n      disposed = true;\n    },\n  };\n}\n"],"names":[],"mappings":";AA0CA,MAAM,mBAAwC,oBAAI,IAAI,CAAC,QAAQ,SAAS,CAAC;AAIzE,MAAM,+BAA+B;AAKrC,MAAM,wBAAwB,KAAK,KAAK,KAAK;AAsCtC,SAAS,0BAA0B,SAAgD;AACxF,SAAO,YAAY,UAAa,iBAAiB,IAAI,QAAQ,IAAI;AACnE;AAGA,SAAS,sBAAsB,OAA0C;AACvE,SAAO,MAAM,YAAY,SAAS,aAAa,MAAM,YAAY,oBAAoB;AACvF;AAGA,SAAS,iBAAiB,QAA0D;;AAClF,QAAM,SAAQ,YAAO,WAAP,mBAAgB;AAC9B,QAAM,MAAK,oCAAO,YAAP,mBAAgB;AAC3B,SAAO,OAAO,OAAO,WAAW,KAAK;AACvC;AAEO,SAAS,4BACd,SACuB;AACvB,QAAM,MAAM,QAAQ,OAAO,KAAK;AAChC,QAAM,WAAW,QAAQ,aAAa,CAAC,SAAqB,eAAe,IAAI;AAE/E,MAAI,WAAW;AACf,MAAI,WAAW;AAGf,MAAI,QAAQ;AACZ,MAAI,iBAAiB;AAErB,QAAM,+BAAe,IAAA;AAGrB,QAAM,oCAAoB,IAAA;AAE1B,QAAM,wCAAwB,IAAA;AAG9B,QAAM,+BAAe,IAAA;AAGrB,QAAM,+BAAe,IAAA;AAErB,QAAM,SAAS,CAAC,OAAe,SAAyC;;AACtE,wBAAQ,gBAAR,wDAAyB,OAAO,OAAO;AAAA,EACzC;AAEA,QAAM,QAAQ,MAAY;;AACxB,qBAAiB;AACjB,QAAI,YAAY,CAAC,YAAY,CAAC,MAAO;AACrC,UAAM,OAAO,QAAQ,KAAA;AAErB,QAAI,SAAS,KAAM;AACnB,YAAQ;AACR,aAAS,MAAA;AACT,UAAM,WAAS,aAAQ,kBAAR,qCAA6B;AAG5C,QAAI,yBAAyB;AAC7B,eAAW,SAAS,KAAK,QAAQ;AAC/B,UAAI,CAAC,0BAA0B,MAAM,WAAW,EAAG;AAInD,UAAI,SAAS,IAAI,MAAM,EAAE,GAAG;AAC1B,YAAI,MAAM,YAAY,SAAS,OAAQ,0BAAyB;AAChE;AAAA,MACF;AACA,UAAI,sBAAsB,KAAK,MAAM,0BAA0B,SAAS,OAAO,IAAI;AACjF,iBAAS,IAAI,MAAM,EAAE;AACrB,YAAI,CAAC,kBAAkB,IAAI,MAAM,EAAE,GAAG;AACpC,4BAAkB,IAAI,MAAM,EAAE;AAC9B,iBAAO,0BAA0B,EAAE,WAAW,MAAM,IAAI;AAAA,QAC1D;AACA;AAAA,MACF;AACA,YAAM,SAAS,MAAM,YAAY,SAAS;AAC1C,YAAM,QAAQ,iCAAQ,IAAI,MAAM;AAChC,UAAI,UAAU,UAAa,IAAA,IAAQ,QAAQ,uBAAuB;AAChE,YAAI,CAAC,cAAc,IAAI,MAAM,EAAE,GAAG;AAChC,wBAAc,IAAI,MAAM,EAAE;AAC1B,iBAAO,uBAAuB,EAAE,WAAW,MAAM,IAAI,OAAO,KAAK,MAAM,QAAQ,KAAK,EAAA,CAAG;AAAA,QACzF;AACA,YAAI,OAAQ,0BAAyB;AACrC;AAAA,MACF;AACA,YAAM,WAAW,SAAS,IAAI,MAAM,EAAE,KAAK,KAAK;AAChD,UAAI,UAAU,8BAA8B;AAC1C,YAAI,CAAC,cAAc,IAAI,MAAM,EAAE,GAAG;AAChC,wBAAc,IAAI,MAAM,EAAE;AAC1B,iBAAO,2BAA2B,EAAE,WAAW,MAAM,IAAI;AAAA,QAC3D;AACA,YAAI,OAAQ,0BAAyB;AACrC;AAAA,MACF;AACA,UAAI;AACF,aAAK,YAAY,MAAM,EAAE;AACzB,iBAAS,IAAI,MAAM,IAAI,OAAO;AAC9B,iBAAS,IAAI,MAAM,EAAE;AACrB,YAAI,OAAQ,0BAAyB;AACrC,eAAO,uBAAuB;AAAA,UAC5B,WAAW,MAAM;AAAA,UACjB,MAAM,MAAM,YAAY;AAAA,UACxB;AAAA,QAAA,CACD;AAAA,MACH,QAAQ;AAIN,eAAO,uBAAuB,EAAE,WAAW,MAAM,IAAI;AAAA,MACvD;AAAA,IACF;AAEA,QAAI,SAAS,OAAO,EAAG,SAAQ;AAAA,EACjC;AAEA,QAAM,gBAAgB,MAAY;AAChC,QAAI,YAAY,kBAAkB,CAAC,YAAY,CAAC,MAAO;AACvD,qBAAiB;AACjB,aAAS,KAAK;AAAA,EAChB;AAEA,SAAO;AAAA,IACL,mBAAmB,OAAO;AACxB,UAAI,SAAU;AACd,UAAI,CAAC,YAAY,yBAAyB,KAAK,GAAG;AAIhD,mBAAW;AACX,gBAAQ;AAAA,MACV;AACA,oBAAA;AAAA,IACF;AAAA,IACA,eAAe,QAAQ;AACrB,UAAI,YAAY,OAAO,WAAW,UAAW;AAC7C,YAAM,YAAY,iBAAiB,MAAM;AACzC,UAAI,cAAc,KAAM,UAAS,OAAO,SAAS;AAGjD,UAAI,CAAC,0BAA0B,OAAO,OAAO,KAAK,SAAS,SAAS,EAAG;AACvE,cAAQ;AACR,oBAAA;AAAA,IACF;AAAA,IACA,0BAA0B;AACxB,UAAI,SAAU;AACd,cAAQ;AACR,oBAAA;AAAA,IACF;AAAA,IACA,UAAU;AACR,iBAAW;AAAA,IACb;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"send-recovery.js","sources":["../../../../agent-runtime/src/send-recovery.ts"],"sourcesContent":["import type {\n  StatewireDiagnosticsCommandUpdate,\n  StatewireDiagnosticsRecorder,\n} from './statewire-diagnostics';\nimport { isDeepAgentStateHydrated } from './statewire-state';\nimport type { StatewireFailedSendEntry, StatewireFailedSendLane } from './thread-extras';\n\n/**\n * Transport-level send durability for the deep-agent thread (the successor to\n * Olympus' localStorage outbox, #29368 → #31504).\n *\n * The durable journal itself is the statewire session record: every command is\n * persisted through the mounted session storage from `send()` until the server\n * durably admits or judges it, and a reload resends survivors on the SAME lane\n * seq (exactly-once — the server absorbs replayed seqs at or below its\n * watermark). What the record cannot recover on its own is a send the client\n * had to settle without a server verdict — a proven session loss or a record\n * reset settles it `lost`/`aborted` and RETAINS it in the record's failed lane\n * (message-carrying sends only), where the vendor drops it as soon as a\n * canonical snapshot shows the message landed (`failureCovered`).\n *\n * This controller turns that persisted failed lane back into live sends: once\n * the thread snapshot has hydrated (so covered entries are already gone), every\n * failed send the server NEVER judged is re-dispatched through the thread's own\n * `retryFailed` — same client-minted message id, re-anchored against the\n * current thread — which the host dedupes by id (a still-queued id re-places,\n * a durable one rejects `duplicate-id`). Server-judged fates (`rejected`,\n * `failed`, `crashed`, `expired`) are the user's decision and stay in the\n * manual retry/discard affordance.\n *\n * Ordering: an `aborted` send stamped `predecessorLost` was never attempted\n * because an earlier send of the same batch WAS attempted and settled `lost`\n * — it may or may not have run. Re-dispatching the successor first could land\n * it ahead of a predecessor that later turns out to have landed too, so the\n * successor is held until every preceding `lost` predecessor has settled: it\n * was covered by a snapshot, its retry was judged by the server, or the user\n * discarded it.\n */\n\n/** Fates the server never saw: the send died client-side (unmount, stream\n * gone, session lost) and is safe to re-dispatch under its original message\n * id. The complement — rejected/failed/crashed/expired — is server-judged. */\nconst AUTO_RETRY_FATES: ReadonlySet<string> = new Set(['lost', 'aborted']);\n\n/** A failed send is re-dispatched at most this many times per attach; a\n * persistent failure (repeated session losses) stays in the manual lane. */\nconst MAX_AUTO_RETRIES_PER_MESSAGE = 3;\n\n/** Persisted failures older than this stay manual: auto-sending a message the\n * user abandoned a day ago is worse than surfacing it for a decision. Mirrors\n * the retired outbox's retention window. */\nconst MAX_AUTO_RETRY_AGE_MS = 24 * 60 * 60 * 1000;\n\n/** How many times a host may hold one message's retry (`beforeRetry`\n * returning a promise) before the sweep sends it regardless: a hold is the\n * host's own bounded wait, never a reason to keep a message back for good. */\nexport const MAX_BEFORE_RETRY_HOLDS = 10;\n\nexport interface DeepAgentSendRecoveryOptions {\n  /**\n   * Reads the thread's failed-send lane. `null` while it is unavailable (the\n   * client has not mounted yet, or its extras are not a statewire thread) —\n   * the controller stays armed and retries on the next state change.\n   */\n  lane: () => StatewireFailedSendLane | null;\n  /**\n   * Persisted failure stamps (message id → epoch ms of the original send) for\n   * the freshness gate. `null`/absent means no persistence is readable — every\n   * lane entry then counts as fresh (an in-memory failed lane can only hold\n   * failures from this page session).\n   */\n  failureStamps?: (() => ReadonlyMap<string, number> | null) | undefined;\n  /** Transport lifecycle recorder; read per event so a late-mounted recorder still sees retries. */\n  diagnostics?: (() => StatewireDiagnosticsRecorder | undefined) | undefined;\n  /** Injectable clock (tests). */\n  now?: () => number;\n  /** Sweep scheduler; defaults to `queueMicrotask` so a sweep never dispatches\n   * from inside a statewire flush or a React render. */\n  schedule?: (task: () => void) => void;\n  /**\n   * Called right before a failed send is dispatched again, with its message\n   * id, so a host can put back the per-send context that message was sent\n   * with (Olympus stages the agents it named) before its command leaves.\n   *\n   * Returning a promise holds the retry: the host can't put that context back\n   * yet (every send of the conversation rides one ambient context, and a send\n   * with another context is still on its way). The sweep then stops at this\n   * message, so nothing behind it overtakes it, and asks again once the\n   * promise settles; past {@link MAX_BEFORE_RETRY_HOLDS} holds it sends the\n   * message regardless. A hook that throws never holds a retry back. A\n   * function returned is called when the message does not go after all (the\n   * retry raced its leaving the lane), so the host lets go of what it put back.\n   */\n  beforeRetry?: ((messageId: string) => void | PromiseLike<void> | (() => void)) | undefined;\n}\n\nexport interface DeepAgentSendRecovery {\n  /** Feed every (normalized) statewire state change; hydration arms the mount sweep. */\n  observeStateChange(state: unknown): void;\n  /** Feed every command-lifecycle update; a never-server-judged settle arms a sweep. */\n  observeCommand(update: StatewireDiagnosticsCommandUpdate): void;\n  /** Feed client notifications too: failed history can publish after the\n   * command settles, without any change to the canonical thread snapshot. */\n  observeFailedLaneChange(): void;\n  dispose(): void;\n}\n\n/** Whether a settle failure is a client-side death the recovery re-dispatches\n * (the server never judged the command). Exported for host-side telemetry. */\nexport function shouldAutoRetryFailedSend(failure: { fate: string } | undefined): boolean {\n  return failure !== undefined && AUTO_RETRY_FATES.has(failure.fate);\n}\n\n/** Whether a failed entry must wait for a lost predecessor to settle first. */\nfunction awaitsLostPredecessor(entry: StatewireFailedSendEntry): boolean {\n  return entry.sendFailure.fate === 'aborted' && entry.sendFailure.predecessorLost === true;\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as { then?: unknown }).then === 'function'\n  );\n}\n\n/** The client-minted message id a run send carries, off a command update's params. */\nfunction commandMessageId(update: StatewireDiagnosticsCommandUpdate): string | null {\n  const first = update.params?.[0] as { message?: { id?: unknown } } | undefined;\n  const id = first?.message?.id;\n  return typeof id === 'string' ? id : null;\n}\n\nexport function createDeepAgentSendRecovery(\n  options: DeepAgentSendRecoveryOptions\n): DeepAgentSendRecovery {\n  const now = options.now ?? Date.now;\n  const schedule = options.schedule ?? ((task: () => void) => queueMicrotask(task));\n\n  let disposed = false;\n  let hydrated = false;\n  /** Work may exist: set at hydration and on retryable settles, cleared by a\n   * sweep that could actually read the lane. */\n  let armed = false;\n  let sweepScheduled = false;\n  /** Retry budget per message id, for this controller's attach lifetime. */\n  const attempts = new Map<string, number>();\n  /** Message ids already diagnosed as stale/exhausted, so the lane re-scan\n   * stays quiet about them. */\n  const surfacedSkips = new Set<string>();\n  /** Message ids whose deferral behind a lost predecessor was diagnosed once. */\n  const surfacedDeferrals = new Set<string>();\n  /** Re-dispatched sends still awaiting the server's verdict: a successor\n   * stamped `predecessorLost` waits while any of these is pending. */\n  const inFlight = new Set<string>();\n  /** Successors held back by the last sweep; a non-empty set keeps the\n   * controller armed so the next settle or state change re-sweeps. */\n  const deferred = new Set<string>();\n  /** How many times the host held each message's retry (`beforeRetry`'s promise). */\n  const holds = new Map<string, number>();\n  /** A host's hold in progress: no sweep runs until it settles. */\n  let holding = false;\n\n  const record = (event: string, data?: Record<string, unknown>): void => {\n    options.diagnostics?.()?.record(event, data);\n  };\n\n  const sweep = (): void => {\n    sweepScheduled = false;\n    // A host's hold re-sweeps once it settles; until then nothing is retried.\n    if (disposed || holding || !hydrated || !armed) return;\n    const lane = options.lane();\n    // No readable lane yet: stay armed so the next state change re-sweeps.\n    if (lane === null) return;\n    armed = false;\n    deferred.clear();\n    const stamps = options.failureStamps?.() ?? null;\n    // A `lost` entry earlier in lane order that this sweep leaves unsettled\n    // (skipped as stale/exhausted, or re-dispatched and now in flight).\n    let lostPredecessorPending = false;\n    for (const entry of lane.failed) {\n      if (!shouldAutoRetryFailedSend(entry.sendFailure)) continue;\n      // Shared retry/discard may still be waiting for the storage lock. The\n      // visible lane can keep this entry until then; do not spend another\n      // attempt on a send whose previous retry is still awaiting a verdict.\n      if (inFlight.has(entry.id)) {\n        if (entry.sendFailure.fate === 'lost') lostPredecessorPending = true;\n        continue;\n      }\n      if (awaitsLostPredecessor(entry) && (lostPredecessorPending || inFlight.size > 0)) {\n        deferred.add(entry.id);\n        if (!surfacedDeferrals.has(entry.id)) {\n          surfacedDeferrals.add(entry.id);\n          record('send-recovery/deferred', { messageId: entry.id });\n        }\n        continue;\n      }\n      const isLost = entry.sendFailure.fate === 'lost';\n      const stamp = stamps?.get(entry.id);\n      if (stamp !== undefined && now() - stamp > MAX_AUTO_RETRY_AGE_MS) {\n        if (!surfacedSkips.has(entry.id)) {\n          surfacedSkips.add(entry.id);\n          record('send-recovery/stale', { messageId: entry.id, ageMs: Math.round(now() - stamp) });\n        }\n        if (isLost) lostPredecessorPending = true;\n        continue;\n      }\n      const attempt = (attempts.get(entry.id) ?? 0) + 1;\n      if (attempt > MAX_AUTO_RETRIES_PER_MESSAGE) {\n        if (!surfacedSkips.has(entry.id)) {\n          surfacedSkips.add(entry.id);\n          record('send-recovery/exhausted', { messageId: entry.id });\n        }\n        if (isLost) lostPredecessorPending = true;\n        continue;\n      }\n      let before: ReturnType<NonNullable<DeepAgentSendRecoveryOptions['beforeRetry']>> | undefined;\n      try {\n        before = options.beforeRetry?.(entry.id);\n      } catch {\n        // A host's own context step failing never holds the retry back.\n        record('send-recovery/before-retry-failed', { messageId: entry.id });\n      }\n      if (isThenable(before)) {\n        const held = (holds.get(entry.id) ?? 0) + 1;\n        if (held <= MAX_BEFORE_RETRY_HOLDS) {\n          // The host can't put this message's context back yet: it waits, and\n          // so does everything behind it (nothing overtakes it); the sweep asks\n          // again once the hold settles.\n          holds.set(entry.id, held);\n          holding = true;\n          armed = true;\n          record('send-recovery/held', { messageId: entry.id, holds: held });\n          const resume = (): void => {\n            holding = false;\n            armed = true;\n            scheduleSweep();\n          };\n          before.then(resume, resume);\n          return;\n        }\n        record('send-recovery/held-too-long', { messageId: entry.id });\n      }\n      try {\n        lane.retryFailed(entry.id);\n        attempts.set(entry.id, attempt);\n        inFlight.add(entry.id);\n        if (isLost) lostPredecessorPending = true;\n        record('send-recovery/retry', {\n          messageId: entry.id,\n          fate: entry.sendFailure.fate,\n          attempt,\n        });\n      } catch {\n        // The entry settled or was covered between the lane read and the\n        // retry (the vendor drops covered failures against every snapshot);\n        // nothing was dispatched, so the host lets go of what it put back.\n        record('send-recovery/raced', { messageId: entry.id });\n        try {\n          if (typeof before === 'function') before();\n        } catch {\n          // The host's own step failing never stops the sweep.\n        }\n      }\n    }\n    // Held successors must be revisited once their predecessors settle.\n    if (deferred.size > 0) armed = true;\n  };\n\n  const scheduleSweep = (): void => {\n    if (disposed || sweepScheduled || holding || !hydrated || !armed) return;\n    sweepScheduled = true;\n    schedule(sweep);\n  };\n\n  return {\n    observeStateChange(state) {\n      if (disposed) return;\n      if (!hydrated && isDeepAgentStateHydrated(state)) {\n        // First real snapshot: the vendor's failureCovered pass has had its\n        // chance to drop entries whose message actually landed, so whatever\n        // remains provably never reached the thread.\n        hydrated = true;\n        armed = true;\n      }\n      scheduleSweep();\n    },\n    observeCommand(update) {\n      if (disposed || update.status !== 'settled') return;\n      const messageId = commandMessageId(update);\n      if (messageId !== null) inFlight.delete(messageId);\n      // A never-server-judged settle means new work; any settle while\n      // successors are held may be the predecessor they wait on.\n      if (!shouldAutoRetryFailedSend(update.failure) && deferred.size === 0) return;\n      armed = true;\n      scheduleSweep();\n    },\n    observeFailedLaneChange() {\n      if (disposed) return;\n      armed = true;\n      scheduleSweep();\n    },\n    dispose() {\n      disposed = true;\n    },\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/thread-handoff-flow-machine.d.ts

@@ -54,6 +54,9 @@ export declare const threadHandoffFlowMachine: import("xstate").StateMachine<Han
             claimed_surface?: "chrome" | "desktop" | "mobile" | "spaces" | null | undefined;
             mode?: "text" | "voice" | undefined;
             draft?: string | null | undefined;
+            cursor?: string | null | undefined;
+            revision?: number | undefined;
+            implicit?: boolean | undefined;
         };
         launch: {
             kind: "mobile";
@@ -72,19 +75,19 @@ export declare const threadHandoffFlowMachine: import("xstate").StateMachine<Han
         } | {
             kind: "office_invitation";
             host: "excel" | "powerpoint" | "word";
+        } | {
+            kind: "chrome";
         } | {
             kind: "spaces";
             url: string;
+        } | {
+            kind: "next";
         } | {
             kind: "desktop";
             scheme_url: string;
             download_url: string;
             deployment_url: string;
             protocol_version: 1;
-        } | {
-            kind: "chrome";
-        } | {
-            kind: "next";
         };
     }, {
         run: ThreadHandoffRun;
@@ -114,6 +117,9 @@ export declare const threadHandoffFlowMachine: import("xstate").StateMachine<Han
             claimed_surface?: "chrome" | "desktop" | "mobile" | "spaces" | null | undefined;
             mode?: "text" | "voice" | undefined;
             draft?: string | null | undefined;
+            cursor?: string | null | undefined;
+            revision?: number | undefined;
+            implicit?: boolean | undefined;
         };
         launch: {
             kind: "mobile";
@@ -132,19 +138,19 @@ export declare const threadHandoffFlowMachine: import("xstate").StateMachine<Han
         } | {
             kind: "office_invitation";
             host: "excel" | "powerpoint" | "word";
+        } | {
+            kind: "chrome";
         } | {
             kind: "spaces";
             url: string;
+        } | {
+            kind: "next";
         } | {
             kind: "desktop";
             scheme_url: string;
             download_url: string;
             deployment_url: string;
             protocol_version: 1;
-        } | {
-            kind: "chrome";
-        } | {
-            kind: "next";
         };
     }, {
         run: ThreadHandoffRun;

package/dist/agent-runtime/src/thread-handoff-protocol.d.ts

@@ -29,6 +29,7 @@ export declare const SURFACE_HANDOFF_DESTINATIONS: readonly ['spaces', 'mobile',
 export type SurfaceHandoffDestination = (typeof SURFACE_HANDOFF_DESTINATIONS)[number];
 /** The source composer's unsent text that travels prefilled, never sent. */
 export declare const MAX_HANDOFF_DRAFT_LENGTH = 4000;
+export { MAX_HANDOFF_CURSOR_LENGTH, parseHandoffCursor } from './handoff-cursor-id';
 /**
  * How the person chose to continue. `voice` is an offer the destination shows
  * ("Continue by voice"); it never starts a microphone by itself. Older servers
@@ -94,6 +95,54 @@ export declare const destinationReadinessSchema: z.ZodObject<{
     marketplace_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type DestinationReadiness = z.infer<typeof destinationReadinessSchema>;
+/**
+ * How recently one of the person's four apps was seen, from a real signal: the desktop app and
+ * Chrome by their device tunnel, the phone by its foreground ping (or its push token), Spaces by
+ * workspace awareness. `live` is open right now; `recent` within minutes; `seen` longer ago;
+ * `not_seen` no evidence; `unknown` no signal to judge by; `unsupported` not in this environment.
+ */
+export declare const surfaceLivenessStateSchema: z.ZodEnum<{
+    live: "live";
+    not_seen: "not_seen";
+    recent: "recent";
+    seen: "seen";
+    unknown: "unknown";
+    unsupported: "unsupported";
+}>;
+export type SurfaceLivenessState = z.infer<typeof surfaceLivenessStateSchema>;
+/** The signal a liveness row rests on. */
+export declare const surfaceLivenessBasisSchema: z.ZodEnum<{
+    awareness: "awareness";
+    device_tunnel: "device_tunnel";
+    foreground: "foreground";
+    push_token: "push_token";
+}>;
+export type SurfaceLivenessBasis = z.infer<typeof surfaceLivenessBasisSchema>;
+export declare const surfaceLivenessSchema: z.ZodObject<{
+    surface: z.ZodEnum<{
+        chrome: "chrome";
+        desktop: "desktop";
+        mobile: "mobile";
+        spaces: "spaces";
+    }>;
+    state: z.ZodEnum<{
+        live: "live";
+        not_seen: "not_seen";
+        recent: "recent";
+        seen: "seen";
+        unknown: "unknown";
+        unsupported: "unsupported";
+    }>;
+    basis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        awareness: "awareness";
+        device_tunnel: "device_tunnel";
+        foreground: "foreground";
+        push_token: "push_token";
+    }>>>;
+    last_seen_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SurfaceLiveness = z.infer<typeof surfaceLivenessSchema>;
 export declare const handoffReadinessResponseSchema: z.ZodObject<{
     environment: z.ZodEnum<{
         localhost: "localhost";
@@ -122,11 +171,47 @@ export declare const handoffReadinessResponseSchema: z.ZodObject<{
     supports_office_invitations: z.ZodOptional<z.ZodBoolean>;
     supports_desktop_source: z.ZodOptional<z.ZodBoolean>;
     supports_surface_destinations: z.ZodOptional<z.ZodBoolean>;
+    supports_handoff_cursor: z.ZodOptional<z.ZodBoolean>;
+    supports_surface_liveness: z.ZodOptional<z.ZodBoolean>;
+    surfaces: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<{
+        surface: "chrome" | "desktop" | "mobile" | "spaces";
+        state: "live" | "not_seen" | "recent" | "seen" | "unknown" | "unsupported";
+        basis?: "awareness" | "device_tunnel" | "foreground" | "push_token" | null | undefined;
+        last_seen_at?: string | null | undefined;
+        label?: string | null | undefined;
+    }[], unknown[]>>>>;
 }, z.core.$strip>;
 export type HandoffReadinessResponse = z.infer<typeof handoffReadinessResponseSchema>;
 export declare const supportsDesktopHandoffSource: (readiness: HandoffReadinessResponse | null | undefined) => boolean;
 /** Whether the server can broker the four-surface destinations; absent means an older agora. */
 export declare const supportsSurfaceHandoffDestinations: (readiness: HandoffReadinessResponse | null | undefined) => boolean;
+/** Whether the server takes a reading position (`cursor`); absent means an older agora. */
+export declare const supportsHandoffCursor: (readiness: HandoffReadinessResponse | null | undefined) => boolean;
+/** Whether the server reports where the person's apps were last seen; absent means an older agora. */
+export declare const supportsSurfaceLiveness: (readiness: HandoffReadinessResponse | null | undefined) => boolean;
+/** Index liveness rows by surface; `null` where the server sent none (or can't report liveness). */
+export declare const surfaceLivenessBySurface: (readiness: HandoffReadinessResponse | null | undefined) => Record<PickupSurface, SurfaceLiveness | null>;
+/** "just now", "4 min ago", "3 hr ago", "yesterday", "5 days ago". */
+export declare const livenessAgo: ({ at, now }: {
+    at: number;
+    now: number;
+}) => string;
+export type SurfaceLivenessTone = 'live' | 'recent' | 'idle';
+/** What a "Continue on…" row says about where that app was last seen, and how warm it is. */
+export interface SurfaceLivenessPresentation {
+    text: string;
+    tone: SurfaceLivenessTone;
+}
+/**
+ * The one wording every picker shows for a surface's liveness ("Open now on your Mac", "Chrome is
+ * running", "Your phone was active 2 min ago"). `null` when there is nothing real to say (no row,
+ * an older server, `unknown`, `unsupported`): the row then keeps the text it shows today.
+ */
+export declare const presentSurfaceLiveness: ({ surface, liveness, now, }: {
+    surface: PickupSurface;
+    liveness: SurfaceLiveness | null | undefined;
+    now?: number;
+}) => SurfaceLivenessPresentation | null;
 export declare const threadHandoffViewSchema: z.ZodObject<{
     handoff_id: z.ZodString;
     thread_id: z.ZodString;
@@ -175,8 +260,17 @@ export declare const threadHandoffViewSchema: z.ZodObject<{
         voice: "voice";
     }>>;
     draft: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    revision: z.ZodOptional<z.ZodNumber>;
+    implicit: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ThreadHandoffView = z.infer<typeof threadHandoffViewSchema>;
+/**
+ * What a "Not now" remembers: the ticket at the revision it was offered at (`<id>@<revision>`).
+ * Sent back as `exclude`, it skips that ticket only until the same conversation is sent here
+ * again, which offers it again.
+ */
+export declare function handoffDeclineKey(view: Pick<ThreadHandoffView, 'handoff_id' | 'revision'>): string;
 export declare const mobileHandoffLaunchSchema: z.ZodObject<{
     kind: z.ZodLiteral<"mobile">;
     push_attempted: z.ZodBoolean;
@@ -319,6 +413,9 @@ export declare const createThreadHandoffResponseSchema: z.ZodObject<{
             voice: "voice";
         }>>;
         draft: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        revision: z.ZodOptional<z.ZodNumber>;
+        implicit: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     launch: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"mobile">;
@@ -368,15 +465,40 @@ export interface CreateThreadHandoffInput {
     officeLaunchMode?: OfficeLaunchMode;
     /** An observed workspace precondition, never an authorization grant. */
     expectedWorkspaceId?: string;
-    /** The composer's unsent text; the destination prefills it and never sends it. */
+    /**
+     * The composer's unsent text; the destination prefills it and never sends
+     * it. Blank (the composer is empty) clears an open ticket's draft; omitted
+     * leaves it. See {@link handoffDraftToCarry}.
+     */
     draft?: string;
     /** `voice` offers "Continue by voice" on the destination. Omitted means text. */
     mode?: HandoffMode;
+    /**
+     * Where the source was reading: the id of the last message it showed, or `''`
+     * when it was at the bottom (which also clears a reused ticket's). Send it only
+     * to a host whose readiness says `supports_handoff_cursor`. A value that is
+     * not a message id goes as `''`.
+     */
+    cursor?: string;
 }
+/**
+ * The draft a create carries, the one rule every source follows. An Office
+ * pane never gets one: it neither prefills nor continues by voice. Anywhere
+ * else a surface that read its composer sends what it holds, within the
+ * server's bound, and a blank composer as `''`: agora reuses an open ticket
+ * for the same thread, destination and mode, and an empty draft clears the
+ * one that ticket stored, so text the person deleted never comes back at the
+ * destination. `undefined` or `null` (the surface could not read a composer)
+ * sends none and leaves an open ticket's draft as it was.
+ */
+export declare function handoffDraftToCarry({ destination, draft, }: {
+    destination: ThreadHandoffDestination;
+    draft: string | null | undefined;
+}): string | undefined;
 /** A phone invites the computer's pane; other sources keep their existing launch. */
 export declare function resolveOfficeHandoffLaunchMode({ source, destination, officeLaunchMode, }: CreateThreadHandoffInput): OfficeLaunchMode | undefined;
 /** The same request body for every host's authenticated HTTP adapter. */
-export declare function threadHandoffCreateBody({ threadId, destination, source, officeLaunchMode, expectedWorkspaceId, draft, mode: handoffMode, }: CreateThreadHandoffInput): {
+export declare function threadHandoffCreateBody({ threadId, destination, source, officeLaunchMode, expectedWorkspaceId, draft, mode: handoffMode, cursor, }: CreateThreadHandoffInput): {
     thread_id: string;
     destination: "chrome" | "desktop" | "excel" | "mobile" | "next" | "powerpoint" | "spaces" | "word";
     source: HandoffSource;
@@ -384,6 +506,7 @@ export declare function threadHandoffCreateBody({ threadId, destination, source,
     office_launch_mode?: "invitation" | "new_document" | undefined;
     draft?: string | undefined;
     mode?: "voice" | undefined;
+    cursor?: string | undefined;
 };
 /** Keep a draft within the server's limit at a character boundary; never send more. */
 export declare const clampHandoffDraft: (draft: string) => string;
@@ -429,10 +552,15 @@ export declare function pickupExcludeIds({ issuedHere, declined, }: {
     issuedHere: Iterable<string>;
     declined: Iterable<string>;
 }): string[];
-/** `/pending?destination=…&exclude=…` relative to `/api/handoffs`. */
-export declare function pendingHandoffPath({ destination, exclude, }: {
+/**
+ * `/pending?destination=…&exclude=…` relative to `/api/handoffs`. `includeImplicit` asks for an
+ * implicit ticket too ("pick up without sending"): only on a `next` peek, the one destination an
+ * implicit ticket names. A server that predates it ignores the flag.
+ */
+export declare function pendingHandoffPath({ destination, exclude, includeImplicit, }: {
     destination: Exclude<ThreadHandoffDestination, 'desktop'> | 'desktop';
     exclude?: Iterable<string>;
+    includeImplicit?: boolean;
 }): string;
 export declare const claimThreadHandoffResponseSchema: z.ZodObject<{
     handoff: z.ZodObject<{
@@ -483,6 +611,9 @@ export declare const claimThreadHandoffResponseSchema: z.ZodObject<{
             voice: "voice";
         }>>;
         draft: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        revision: z.ZodOptional<z.ZodNumber>;
+        implicit: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type ClaimThreadHandoffResponse = z.infer<typeof claimThreadHandoffResponseSchema>;
@@ -536,6 +667,9 @@ export declare const pendingThreadHandoffResponseSchema: z.ZodNullable<z.ZodObje
             voice: "voice";
         }>>;
         draft: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        revision: z.ZodOptional<z.ZodNumber>;
+        implicit: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
 }, z.core.$strip>>;
 /**
@@ -551,6 +685,8 @@ export interface ThreadHandoffReceiverTransport {
         destination: Exclude<ThreadHandoffDestination, 'desktop'>;
         /** Tickets this receiver declined or issued itself; the newest other one is returned. */
         exclude?: readonly string[];
+        /** Also an implicit ticket, on a `next` peek ({@link pendingHandoffPath}). */
+        includeImplicit?: boolean;
         signal?: AbortSignal;
     }) => Promise<ClaimThreadHandoffResponse | null>;
     claim: (options: {
@@ -568,16 +704,84 @@ export interface ThreadHandoffReceiverTransport {
         signal?: AbortSignal;
     }) => Promise<ThreadHandoffView>;
 }
+/**
+ * "Pick up without sending": an app offers a conversation the person is driving on another of
+ * their apps only when it just became active (the Spaces tab became visible, the phone came to the
+ * foreground, Chrome's side panel opened, the desktop window gained focus), within this long.
+ */
+export declare const IMPLICIT_PICKUP_ACTIVATION_WINDOW_MS = 10000;
+/**
+ * How long a "Not now" to an implicit offer is kept where declines expire (Chrome, the desktop
+ * app). The ticket keeps its id for as long as the same app drives, past its 10 minutes, so a
+ * decline kept only as long as the ticket's first expiry would let the same offer come back.
+ */
+export declare const IMPLICIT_PICKUP_DECLINE_HOLD_MS: number;
+/** Whether a view is an implicit ticket: left by the app the person drives from, never sent. */
+export declare const isImplicitHandoff: (view: Pick<ThreadHandoffView, 'implicit'> | null | undefined) => boolean;
+/**
+ * What a receiving app knows about itself to judge an implicit ticket. `seenAt` comes from
+ * {@link nextImplicitPickupAnswer}: when this app first saw the ticket after `becameActiveAt`.
+ */
+export interface ImplicitPickupContext {
+    /** This app. */
+    here: PickupSurface;
+    /** The conversation this app shows now; `null` when none. */
+    showingThreadId: string | null;
+    /** When this app last became active; `null` until it has. */
+    becameActiveAt: number | null;
+    /** When this app first saw the ticket after becoming active; `null` when it has not. */
+    seenAt: number | null;
+}
+/**
+ * Whether an implicit ticket may be offered here: it is another app's, this app isn't already
+ * showing that conversation, and this app saw it within {@link IMPLICIT_PICKUP_ACTIVATION_WINDOW_MS}
+ * of becoming active. An idle poll's answer never qualifies on its own, and nothing here ever
+ * raises a notification: only the app's own banner offers one.
+ */
+export declare function implicitPickupAllowed({ pending, context, }: {
+    pending: Pick<ThreadHandoffView, 'source' | 'thread_id'>;
+    context: ImplicitPickupContext;
+}): boolean;
+/** An implicit-pickup peek's answer, with what judging it needs. */
+export interface ImplicitPickupAnswer<View extends {
+    handoff_id: string;
+} = ThreadHandoffView> {
+    view: View | null;
+    /** The activation this answer belongs to. */
+    becameActiveAt: number;
+    /** When this app first saw `view`'s ticket since that activation. */
+    seenAt: number;
+}
+/**
+ * Fold a new peek into the earlier ones: a ticket seen again since the same activation keeps the
+ * time it was first seen, so an offer made on becoming active stays up until it is answered or
+ * goes away, while a ticket that first shows up on a later poll is never offered. `previous` may
+ * be every answer of this activation (one per set of exclusions a host asked with), so declining
+ * another ticket never makes this one look new.
+ */
+export declare function nextImplicitPickupAnswer<View extends {
+    handoff_id: string;
+} = ThreadHandoffView>({ previous, view, becameActiveAt, now, }: {
+    previous: ImplicitPickupAnswer<View> | readonly (ImplicitPickupAnswer<View> | null | undefined)[] | null | undefined;
+    view: View | null;
+    becameActiveAt: number;
+    now?: number;
+}): ImplicitPickupAnswer<View>;
 /**
  * Whether a pending handoff should be offered on this surface: still open,
  * not one this device issued itself, and not one it already declined.
  * Offering never claims; the person's tap does.
+ *
+ * A ticket the person sent is judged exactly as it always was. An implicit
+ * one ("pick up without sending") also needs `implicit`, the receiver's own
+ * context ({@link implicitPickupAllowed}); without it, it is never offered.
  */
-export declare function shouldOfferPendingHandoff({ pending, issuedHere, declined, now, }: {
+export declare function shouldOfferPendingHandoff({ pending, issuedHere, declined, now, implicit, }: {
     pending: ThreadHandoffView | null | undefined;
     issuedHere: ReadonlySet<string>;
     declined: ReadonlySet<string>;
     now?: number;
+    implicit?: ImplicitPickupContext;
 }): boolean;
 /**
  * Surface-specific HTTP adapter. Olympus binds it to `apiClient`; the
@@ -599,6 +803,19 @@ export interface ThreadHandoffTransport {
 export declare const HANDOFF_DESTINATION_LABELS: Record<HandoffDestination, string>;
 /** Picker labels for every destination a "Continue on…" row can name. */
 export declare const THREAD_HANDOFF_DESTINATION_LABELS: Record<ThreadHandoffDestination, string>;
+/**
+ * How a landing names the surface a conversation came from ("Continued from …"), and every other
+ * "from …" an app says about another (a device's "Athena is using Mail, from your phone").
+ */
+export declare const HANDOFF_ORIGIN_LABELS: {
+    readonly spaces: 'Spaces';
+    readonly mobile: 'your phone';
+    readonly chrome: 'Chrome';
+    readonly desktop: 'Athena Desktop';
+    readonly word: 'Word';
+    readonly powerpoint: 'PowerPoint';
+    readonly excel: 'Excel';
+};
 /** "Pick up your conversation from your phone?" — a destination's offer, before any claim. */
 export declare const pickUpOfferLabel: (source: string) => string;
 /** "Continued from your phone" — the divider a destination shows where it picked up. */
@@ -629,6 +846,11 @@ export interface HandoffLanding {
      * "Continue by voice"; nothing starts the microphone on its own.
      */
     continueByVoice: boolean;
+    /**
+     * The message the source was reading; the transcript opens there instead of
+     * at the bottom. `null` when the source was at the bottom (or sent none).
+     */
+    cursor: string | null;
 }
 export declare const handoffLandingFromView: (view: ThreadHandoffView) => HandoffLanding;
 export declare const isOfficeHandoffDestination: (destination: ThreadHandoffDestination) => destination is OfficeHandoffDestination;

package/dist/agent-runtime/src/thread-handoff.d.ts

@@ -1,3 +1,3 @@
 /** Backward-compatible entrypoint. Use the protocol entrypoint without QR rendering. */
-export { type CreateThreadHandoffInput, type CreateThreadHandoffResponse, type DestinationReadiness, HANDOFF_DESTINATIONS, HANDOFF_DESTINATION_LABELS, HANDOFF_URL_PARAM, type HandoffDestination, type HandoffDestinationPresentation, type HandoffEnvironment, HandoffGoneError, type HandoffLaunch, type HandoffOutcome, HandoffPermanentError, type HandoffReadinessResponse, type HandoffReadinessState, type HandoffSource, type HandoffState, type HandoffTransportErrorKind, MOBILE_APP_SCHEME, type MobileHandoffLaunch, type MobileLaunchMode, OFFICE_HANDOFF_DESTINATIONS, type OfficeHandoffDestination, type OfficeHandoffLaunch, type OfficeInvitationLaunch, type OfficeLaunchMode, SERVER_HANDOFF_DESTINATIONS, type ServerHandoffDestination, type ThreadHandoffTransport, type ThreadHandoffView, type WaitForHandoffOutcomeOptions, buildMobileHandoffSchemeUrl, chromeHandoffLaunchSchema, classifyHandoffTransportError, createThreadHandoffResponseSchema, describeHandoffTransportError, destinationReadinessSchema, handoffEnvironmentSchema, handoffHttpError, handoffLaunchSchema, handoffReadinessResponseSchema, handoffReadinessStateSchema, handoffStateSchema, isHandoffGoneError, isHandoffPermanentError, isOfficeHandoffDestination, isRetryableHandoffHttpStatus, isServerHandoffDestination, isTerminalHandoffState, mobileHandoffLaunchSchema, officeHandoffLaunchSchema, officeInvitationLaunchSchema, officeLaunchModeSchema, parseHandoffIdParam, presentHandoffDestination, readinessByDestination, resolveOfficeHandoffLaunchMode, selectMobileLaunchMode, supportsDesktopHandoffSource, threadHandoffCreateBody, threadHandoffViewSchema, waitForHandoffOutcome, type ClaimThreadHandoffResponse, claimThreadHandoffResponseSchema, clampHandoffDraft, continuedFromLabel, pickUpFromLabel, pickUpOfferLabel, type DesktopThreadHandoffLaunch, desktopThreadHandoffLaunchSchema, driverSurfaceForChannel, drivingOnLabel, type HandoffLanding, handoffLandingFromView, isPickupSurface, MAX_HANDOFF_DRAFT_LENGTH, nextHandoffLaunchSchema, parseThreadHandoffCreateResponse, pendingThreadHandoffResponseSchema, pickedUpOnLabel, PICKUP_SURFACES, type PickupSurface, shouldOfferPendingHandoff, SPACES_HANDOFF_URL_PARAM, type SpacesHandoffLaunch, spacesHandoffLaunchSchema, SURFACE_HANDOFF_DESTINATIONS, type SurfaceHandoffDestination, supportsSurfaceHandoffDestinations, THREAD_HANDOFF_DESTINATION_LABELS, THREAD_HANDOFF_DESTINATIONS, threadHandoffClaimBody, threadHandoffCreateRequest, type ThreadHandoffDestination, type ThreadHandoffReceiverTransport, MAX_PENDING_EXCLUDE, pendingExcludeIds, pickupExcludeIds, pendingHandoffPath, type HandoffMode, handoffModeSchema, isVoiceHandoffDestination, } from './thread-handoff-protocol';
+export { type CreateThreadHandoffInput, type CreateThreadHandoffResponse, type DestinationReadiness, HANDOFF_DESTINATIONS, HANDOFF_DESTINATION_LABELS, HANDOFF_URL_PARAM, type HandoffDestination, type HandoffDestinationPresentation, type HandoffEnvironment, HandoffGoneError, type HandoffLaunch, type HandoffOutcome, HandoffPermanentError, type HandoffReadinessResponse, type HandoffReadinessState, type HandoffSource, type HandoffState, type HandoffTransportErrorKind, MOBILE_APP_SCHEME, type MobileHandoffLaunch, type MobileLaunchMode, OFFICE_HANDOFF_DESTINATIONS, type OfficeHandoffDestination, type OfficeHandoffLaunch, type OfficeInvitationLaunch, type OfficeLaunchMode, SERVER_HANDOFF_DESTINATIONS, type ServerHandoffDestination, type ThreadHandoffTransport, type ThreadHandoffView, type WaitForHandoffOutcomeOptions, buildMobileHandoffSchemeUrl, chromeHandoffLaunchSchema, classifyHandoffTransportError, createThreadHandoffResponseSchema, describeHandoffTransportError, destinationReadinessSchema, handoffEnvironmentSchema, handoffHttpError, handoffLaunchSchema, handoffReadinessResponseSchema, handoffReadinessStateSchema, handoffStateSchema, isHandoffGoneError, isHandoffPermanentError, isOfficeHandoffDestination, isRetryableHandoffHttpStatus, isServerHandoffDestination, isTerminalHandoffState, mobileHandoffLaunchSchema, officeHandoffLaunchSchema, officeInvitationLaunchSchema, officeLaunchModeSchema, parseHandoffIdParam, presentHandoffDestination, readinessByDestination, resolveOfficeHandoffLaunchMode, selectMobileLaunchMode, supportsDesktopHandoffSource, threadHandoffCreateBody, threadHandoffViewSchema, waitForHandoffOutcome, type ClaimThreadHandoffResponse, claimThreadHandoffResponseSchema, clampHandoffDraft, handoffDraftToCarry, continuedFromLabel, pickUpFromLabel, pickUpOfferLabel, type DesktopThreadHandoffLaunch, desktopThreadHandoffLaunchSchema, driverSurfaceForChannel, drivingOnLabel, type HandoffLanding, handoffLandingFromView, isPickupSurface, MAX_HANDOFF_DRAFT_LENGTH, nextHandoffLaunchSchema, parseThreadHandoffCreateResponse, pendingThreadHandoffResponseSchema, pickedUpOnLabel, PICKUP_SURFACES, type PickupSurface, shouldOfferPendingHandoff, IMPLICIT_PICKUP_ACTIVATION_WINDOW_MS, IMPLICIT_PICKUP_DECLINE_HOLD_MS, type ImplicitPickupAnswer, type ImplicitPickupContext, implicitPickupAllowed, isImplicitHandoff, nextImplicitPickupAnswer, SPACES_HANDOFF_URL_PARAM, type SpacesHandoffLaunch, spacesHandoffLaunchSchema, SURFACE_HANDOFF_DESTINATIONS, type SurfaceHandoffDestination, supportsSurfaceHandoffDestinations, THREAD_HANDOFF_DESTINATION_LABELS, THREAD_HANDOFF_DESTINATIONS, threadHandoffClaimBody, threadHandoffCreateRequest, type ThreadHandoffDestination, type ThreadHandoffReceiverTransport, MAX_PENDING_EXCLUDE, handoffDeclineKey, pendingExcludeIds, pickupExcludeIds, pendingHandoffPath, type HandoffMode, handoffModeSchema, isVoiceHandoffDestination, MAX_HANDOFF_CURSOR_LENGTH, parseHandoffCursor, supportsHandoffCursor, livenessAgo, presentSurfaceLiveness, type SurfaceLiveness, type SurfaceLivenessBasis, surfaceLivenessBasisSchema, surfaceLivenessBySurface, type SurfaceLivenessPresentation, surfaceLivenessSchema, type SurfaceLivenessState, surfaceLivenessStateSchema, type SurfaceLivenessTone, supportsSurfaceLiveness, } from './thread-handoff-protocol';
 export { buildHandoffQrSvg } from './thread-handoff-qr';

package/dist/agent-runtime/src/use-conversation-list.cjs

@@ -7,7 +7,7 @@ const DEFAULT_PAGE_SIZE = 20;
 const DEFAULT_STALE_TIME_MS = 3e4;
 const DEFAULT_GC_TIME_MS = 10 * 60 * 1e3;
 function useConversationList(options) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const {
     filter,
     pageSize = DEFAULT_PAGE_SIZE,
@@ -133,10 +133,11 @@ function useConversationList(options) {
   return {
     conversations,
     totalCount: ((_b = firstPage.data) == null ? void 0 : _b.totalCount) ?? null,
+    homeAgentApplied: ((_c = firstPage.data) == null ? void 0 : _c.homeAgentApplied) === true,
     isLoading: firstPage.isLoading,
     isFetching: firstPage.isFetching || history.isFetching,
     hasResolvedFirstPage: firstPage.data !== void 0,
-    hasNextPage: hasLoadedHistory ? history.hasNextPage ?? false : ((_c = firstPage.data) == null ? void 0 : _c.hasMore) ?? false,
+    hasNextPage: hasLoadedHistory ? history.hasNextPage ?? false : ((_d = firstPage.data) == null ? void 0 : _d.hasMore) ?? false,
     isFetchingNextPage: history.isFetchingNextPage || !hasLoadedHistory && history.isFetching,
     isFetchNextPageError: history.isError,
     fetchNextPage,

package/dist/agent-runtime/src/use-conversation-list.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-conversation-list.cjs","sources":["../../../../agent-runtime/src/use-conversation-list.ts"],"sourcesContent":["import {\n  type InfiniteData,\n  type QueryClient,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n} from '@tanstack/react-query';\nimport { useCallback, useMemo, useRef } from 'react';\nimport {\n  CONVERSATION_LIST_DEFAULT_SCOPE_KEY,\n  type ConversationListFetcher,\n  type ConversationListFilter,\n  type ConversationListPage,\n  type ConversationSummary,\n  conversationListFilterKey,\n  conversationListQueryKeys,\n  invalidateConversationListCaches,\n  mergeConversationPages,\n  normalizeConversationListFilter,\n  patchConversationsInPage,\n  prependConversationToPage,\n  removeConversationFromPage,\n} from './conversation-list';\n\nconst DEFAULT_PAGE_SIZE = 20;\nconst DEFAULT_STALE_TIME_MS = 30_000;\nconst DEFAULT_GC_TIME_MS = 10 * 60 * 1000;\n\nexport interface UseConversationListOptions {\n  /**\n   * Transport adapter for one page (GraphQL `listConversations`, the REST\n   * thread list, …). Captured in a ref — identity changes do not re-key the\n   * cache, so pair a changing fetcher with a changing `scopeKey`.\n   */\n  fetchPage: ConversationListFetcher;\n  filter?: ConversationListFilter;\n  pageSize?: number;\n  /**\n   * Cache identity beyond the filter. MUST include everything that changes\n   * whose list this is — principal/user id, backend base URL — so a\n   * credential swap can never serve another identity's rows from the cache.\n   */\n  scopeKey?: string;\n  enabled?: boolean;\n  staleTime?: number;\n  gcTime?: number;\n  refetchOnMount?: boolean | 'always';\n  refetchOnWindowFocus?: boolean;\n  /**\n   * Newest-page freshness is push-based by default (the conversation-index\n   * statewire invalidates these caches), so no timer runs unless asked.\n   */\n  refetchInterval?: number | false;\n  retry?: boolean | number | ((failureCount: number, error: Error) => boolean);\n  /**\n   * The client to cache in. Defaults to the one in context; a hook that may\n   * render outside any `QueryClientProvider` (and stays disabled there)\n   * passes its own.\n   */\n  queryClient?: QueryClient;\n}\n\nexport interface ConversationListController {\n  /** Merged newest-first rows: live first page + retained history pages. */\n  conversations: ConversationSummary[];\n  /** Advisory total from the live first page, when the transport counts. */\n  totalCount: number | null;\n  isLoading: boolean;\n  isFetching: boolean;\n  /** True once the live first page has resolved at least once. */\n  hasResolvedFirstPage: boolean;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  /** True while the last next-page request failed (cleared by a successful one). */\n  isFetchNextPageError: boolean;\n  fetchNextPage: () => Promise<unknown>;\n  /** Refetch the live first page (history pages stay frozen). */\n  refresh: () => Promise<unknown>;\n  /** Invalidate every conversation-list cache in this scope (all filters). */\n  invalidate: () => Promise<void>;\n  /** Optimistically show a new conversation at the top of THIS filter view. */\n  prependConversation: (item: ConversationSummary) => void;\n  /** Optimistically drop a conversation from THIS filter view. */\n  removeConversation: (threadId: string) => void;\n  /** Optimistically patch a conversation's row in THIS filter view. */\n  patchConversation: (threadId: string, patch: Partial<ConversationSummary>) => void;\n}\n\n/**\n * The shared headless conversation-list pager (chat-stack unification —\n * thread-list-contract-convergence).\n *\n * Implements, once, the two-tier TanStack Query pattern Olympus and mobile\n * each hand-rolled:\n *\n * - a LIVE first-page query — the only observer that refetches on\n *   invalidation/focus, so push-driven freshness costs one page, and\n * - a permanently-disabled infinite \"history\" query whose pages are fetched\n *   only by explicit `fetchNextPage()` calls and retained without replay\n *   (invalidation/polling never refetches every loaded page).\n *\n * Rows merge newest-first with the live page winning duplicate threads.\n */\nexport function useConversationList(options: UseConversationListOptions): ConversationListController {\n  const {\n    filter,\n    pageSize = DEFAULT_PAGE_SIZE,\n    scopeKey = CONVERSATION_LIST_DEFAULT_SCOPE_KEY,\n    enabled,\n    staleTime = DEFAULT_STALE_TIME_MS,\n    gcTime = DEFAULT_GC_TIME_MS,\n    refetchOnMount,\n    refetchOnWindowFocus,\n    refetchInterval = false,\n    retry,\n  } = options;\n  const queryClient = useQueryClient(options.queryClient);\n\n  const fetchPageRef = useRef(options.fetchPage);\n  fetchPageRef.current = options.fetchPage;\n\n  // The normalized filter is both the cache identity (via the key) and what\n  // queryFn closures fetch, so a cache entry holds exactly what it claims —\n  // fresh-but-equal filter objects from the caller never re-key or refetch.\n  // (Plain per-render values: only the serialized key participates in\n  // identity, so object freshness here is irrelevant.)\n  const normalizedFilter = normalizeConversationListFilter(filter ?? {});\n  const filterKey = conversationListFilterKey(normalizedFilter);\n\n  const firstPageKey = useMemo(\n    () => conversationListQueryKeys.firstPage(scopeKey, filterKey, pageSize),\n    [scopeKey, filterKey, pageSize]\n  );\n  const historyKey = useMemo(\n    () => conversationListQueryKeys.history(scopeKey, filterKey, pageSize),\n    [scopeKey, filterKey, pageSize]\n  );\n\n  // React Query merges per-query options OVER the client's defaultOptions with\n  // Object.assign, which copies explicitly-`undefined` keys — so passing\n  // `refetchOnWindowFocus: undefined` CLOBBERS a consumer's\n  // `refetchOnWindowFocus: false` default and silently re-enables focus\n  // refetching. Options the caller did not set must therefore be omitted, not\n  // forwarded as undefined, so they fall through to the consuming app's client.\n  const passthrough = {\n    ...(enabled !== undefined ? { enabled } : {}),\n    ...(refetchOnMount !== undefined ? { refetchOnMount } : {}),\n    ...(refetchOnWindowFocus !== undefined ? { refetchOnWindowFocus } : {}),\n    ...(retry !== undefined ? { retry } : {}),\n  };\n\n  const firstPage = useQuery(\n    {\n      queryKey: firstPageKey,\n      queryFn: ({ signal }) =>\n        fetchPageRef.current({ limit: pageSize, offset: 0, filter: normalizedFilter, signal }),\n      staleTime,\n      gcTime,\n      refetchInterval,\n      ...passthrough,\n    },\n    queryClient\n  );\n\n  const history = useInfiniteQuery(\n    {\n      queryKey: historyKey,\n      initialPageParam: pageSize,\n      gcTime,\n      queryFn: ({ pageParam, signal }) =>\n        fetchPageRef.current({\n          limit: pageSize,\n          offset: pageParam,\n          filter: normalizedFilter,\n          signal,\n        }),\n      getNextPageParam: (lastPage, _allPages, lastOffset) =>\n        lastPage.hasMore ? lastOffset + pageSize : undefined,\n      ...passthrough,\n      // fetchNextPage/refetch still perform explicit fetches for disabled\n      // queries. Keeping this observer disabled prevents focus, invalidation,\n      // and polling from replaying every retained historical page. This must\n      // win over `passthrough.enabled`, so it is spread last.\n      enabled: false,\n    },\n    queryClient\n  );\n\n  const historyPages = history.data?.pages;\n  const hasLoadedHistory = (historyPages?.length ?? 0) > 0;\n\n  const conversations = useMemo(\n    () =>\n      mergeConversationPages([\n        ...(firstPage.data ? [firstPage.data] : []),\n        ...(historyPages ?? []),\n      ]),\n    [firstPage.data, historyPages]\n  );\n\n  const fetchNextHistoryPage = history.fetchNextPage;\n  const refetchHistoryFirstPage = history.refetch;\n  const fetchNextPage = useCallback(\n    () => (hasLoadedHistory ? fetchNextHistoryPage() : refetchHistoryFirstPage()),\n    [hasLoadedHistory, fetchNextHistoryPage, refetchHistoryFirstPage]\n  );\n\n  const refresh = useCallback(() => firstPage.refetch(), [firstPage.refetch]);\n\n  const invalidate = useCallback(\n    () => invalidateConversationListCaches(queryClient, { scopeKey }),\n    [queryClient, scopeKey]\n  );\n\n  const prependConversation = useCallback(\n    (item: ConversationSummary) => {\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? prependConversationToPage(page, item) : page\n      );\n    },\n    [queryClient, firstPageKey]\n  );\n\n  const removeConversation = useCallback(\n    (threadId: string) => {\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? removeConversationFromPage(page, threadId) : page\n      );\n      queryClient.setQueryData<InfiniteData<ConversationListPage, number>>(historyKey, (data) =>\n        data\n          ? { ...data, pages: data.pages.map((page) => removeConversationFromPage(page, threadId)) }\n          : data\n      );\n    },\n    [queryClient, firstPageKey, historyKey]\n  );\n\n  const patchConversation = useCallback(\n    (threadId: string, patch: Partial<ConversationSummary>) => {\n      const match = (item: ConversationSummary) => item.threadId === threadId;\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? patchConversationsInPage(page, match, patch) : page\n      );\n      queryClient.setQueryData<InfiniteData<ConversationListPage, number>>(historyKey, (data) =>\n        data\n          ? {\n              ...data,\n              pages: data.pages.map((page) => patchConversationsInPage(page, match, patch)),\n            }\n          : data\n      );\n    },\n    [queryClient, firstPageKey, historyKey]\n  );\n\n  return {\n    conversations,\n    totalCount: firstPage.data?.totalCount ?? null,\n    isLoading: firstPage.isLoading,\n    isFetching: firstPage.isFetching || history.isFetching,\n    hasResolvedFirstPage: firstPage.data !== undefined,\n    hasNextPage: hasLoadedHistory\n      ? (history.hasNextPage ?? false)\n      : (firstPage.data?.hasMore ?? false),\n    isFetchingNextPage: history.isFetchingNextPage || (!hasLoadedHistory && history.isFetching),\n    isFetchNextPageError: history.isError,\n    fetchNextPage,\n    refresh,\n    invalidate,\n    prependConversation,\n    removeConversation,\n    patchConversation,\n  };\n}\n"],"names":["CONVERSATION_LIST_DEFAULT_SCOPE_KEY","useQueryClient","useRef","normalizeConversationListFilter","conversationListFilterKey","useMemo","conversationListQueryKeys","useQuery","useInfiniteQuery","mergeConversationPages","useCallback","invalidateConversationListCaches","prependConversationToPage","removeConversationFromPage","patchConversationsInPage"],"mappings":"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"}
+{"version":3,"file":"use-conversation-list.cjs","sources":["../../../../agent-runtime/src/use-conversation-list.ts"],"sourcesContent":["import {\n  type InfiniteData,\n  type QueryClient,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n} from '@tanstack/react-query';\nimport { useCallback, useMemo, useRef } from 'react';\nimport {\n  CONVERSATION_LIST_DEFAULT_SCOPE_KEY,\n  type ConversationListFetcher,\n  type ConversationListFilter,\n  type ConversationListPage,\n  type ConversationSummary,\n  conversationListFilterKey,\n  conversationListQueryKeys,\n  invalidateConversationListCaches,\n  mergeConversationPages,\n  normalizeConversationListFilter,\n  patchConversationsInPage,\n  prependConversationToPage,\n  removeConversationFromPage,\n} from './conversation-list';\n\nconst DEFAULT_PAGE_SIZE = 20;\nconst DEFAULT_STALE_TIME_MS = 30_000;\nconst DEFAULT_GC_TIME_MS = 10 * 60 * 1000;\n\nexport interface UseConversationListOptions {\n  /**\n   * Transport adapter for one page (GraphQL `listConversations`, the REST\n   * thread list, …). Captured in a ref — identity changes do not re-key the\n   * cache, so pair a changing fetcher with a changing `scopeKey`.\n   */\n  fetchPage: ConversationListFetcher;\n  filter?: ConversationListFilter;\n  pageSize?: number;\n  /**\n   * Cache identity beyond the filter. MUST include everything that changes\n   * whose list this is — principal/user id, backend base URL — so a\n   * credential swap can never serve another identity's rows from the cache.\n   */\n  scopeKey?: string;\n  enabled?: boolean;\n  staleTime?: number;\n  gcTime?: number;\n  refetchOnMount?: boolean | 'always';\n  refetchOnWindowFocus?: boolean;\n  /**\n   * Newest-page freshness is push-based by default (the conversation-index\n   * statewire invalidates these caches), so no timer runs unless asked.\n   */\n  refetchInterval?: number | false;\n  retry?: boolean | number | ((failureCount: number, error: Error) => boolean);\n  /**\n   * The client to cache in. Defaults to the one in context; a hook that may\n   * render outside any `QueryClientProvider` (and stays disabled there)\n   * passes its own.\n   */\n  queryClient?: QueryClient;\n}\n\nexport interface ConversationListController {\n  /** Merged newest-first rows: live first page + retained history pages. */\n  conversations: ConversationSummary[];\n  /** Advisory total from the live first page, when the transport counts. */\n  totalCount: number | null;\n  /**\n   * Whether the live first page's latest answer held the conversations with\n   * the filter's `homeAgentId` agent ({@link ConversationListPage.homeAgentApplied}).\n   * `false` until it answers, and wherever the server did not widen the list.\n   */\n  homeAgentApplied: boolean;\n  isLoading: boolean;\n  isFetching: boolean;\n  /** True once the live first page has resolved at least once. */\n  hasResolvedFirstPage: boolean;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  /** True while the last next-page request failed (cleared by a successful one). */\n  isFetchNextPageError: boolean;\n  fetchNextPage: () => Promise<unknown>;\n  /** Refetch the live first page (history pages stay frozen). */\n  refresh: () => Promise<unknown>;\n  /** Invalidate every conversation-list cache in this scope (all filters). */\n  invalidate: () => Promise<void>;\n  /** Optimistically show a new conversation at the top of THIS filter view. */\n  prependConversation: (item: ConversationSummary) => void;\n  /** Optimistically drop a conversation from THIS filter view. */\n  removeConversation: (threadId: string) => void;\n  /** Optimistically patch a conversation's row in THIS filter view. */\n  patchConversation: (threadId: string, patch: Partial<ConversationSummary>) => void;\n}\n\n/**\n * The shared headless conversation-list pager (chat-stack unification —\n * thread-list-contract-convergence).\n *\n * Implements, once, the two-tier TanStack Query pattern Olympus and mobile\n * each hand-rolled:\n *\n * - a LIVE first-page query — the only observer that refetches on\n *   invalidation/focus, so push-driven freshness costs one page, and\n * - a permanently-disabled infinite \"history\" query whose pages are fetched\n *   only by explicit `fetchNextPage()` calls and retained without replay\n *   (invalidation/polling never refetches every loaded page).\n *\n * Rows merge newest-first with the live page winning duplicate threads.\n */\nexport function useConversationList(options: UseConversationListOptions): ConversationListController {\n  const {\n    filter,\n    pageSize = DEFAULT_PAGE_SIZE,\n    scopeKey = CONVERSATION_LIST_DEFAULT_SCOPE_KEY,\n    enabled,\n    staleTime = DEFAULT_STALE_TIME_MS,\n    gcTime = DEFAULT_GC_TIME_MS,\n    refetchOnMount,\n    refetchOnWindowFocus,\n    refetchInterval = false,\n    retry,\n  } = options;\n  const queryClient = useQueryClient(options.queryClient);\n\n  const fetchPageRef = useRef(options.fetchPage);\n  fetchPageRef.current = options.fetchPage;\n\n  // The normalized filter is both the cache identity (via the key) and what\n  // queryFn closures fetch, so a cache entry holds exactly what it claims —\n  // fresh-but-equal filter objects from the caller never re-key or refetch.\n  // (Plain per-render values: only the serialized key participates in\n  // identity, so object freshness here is irrelevant.)\n  const normalizedFilter = normalizeConversationListFilter(filter ?? {});\n  const filterKey = conversationListFilterKey(normalizedFilter);\n\n  const firstPageKey = useMemo(\n    () => conversationListQueryKeys.firstPage(scopeKey, filterKey, pageSize),\n    [scopeKey, filterKey, pageSize]\n  );\n  const historyKey = useMemo(\n    () => conversationListQueryKeys.history(scopeKey, filterKey, pageSize),\n    [scopeKey, filterKey, pageSize]\n  );\n\n  // React Query merges per-query options OVER the client's defaultOptions with\n  // Object.assign, which copies explicitly-`undefined` keys — so passing\n  // `refetchOnWindowFocus: undefined` CLOBBERS a consumer's\n  // `refetchOnWindowFocus: false` default and silently re-enables focus\n  // refetching. Options the caller did not set must therefore be omitted, not\n  // forwarded as undefined, so they fall through to the consuming app's client.\n  const passthrough = {\n    ...(enabled !== undefined ? { enabled } : {}),\n    ...(refetchOnMount !== undefined ? { refetchOnMount } : {}),\n    ...(refetchOnWindowFocus !== undefined ? { refetchOnWindowFocus } : {}),\n    ...(retry !== undefined ? { retry } : {}),\n  };\n\n  const firstPage = useQuery(\n    {\n      queryKey: firstPageKey,\n      queryFn: ({ signal }) =>\n        fetchPageRef.current({ limit: pageSize, offset: 0, filter: normalizedFilter, signal }),\n      staleTime,\n      gcTime,\n      refetchInterval,\n      ...passthrough,\n    },\n    queryClient\n  );\n\n  const history = useInfiniteQuery(\n    {\n      queryKey: historyKey,\n      initialPageParam: pageSize,\n      gcTime,\n      queryFn: ({ pageParam, signal }) =>\n        fetchPageRef.current({\n          limit: pageSize,\n          offset: pageParam,\n          filter: normalizedFilter,\n          signal,\n        }),\n      getNextPageParam: (lastPage, _allPages, lastOffset) =>\n        lastPage.hasMore ? lastOffset + pageSize : undefined,\n      ...passthrough,\n      // fetchNextPage/refetch still perform explicit fetches for disabled\n      // queries. Keeping this observer disabled prevents focus, invalidation,\n      // and polling from replaying every retained historical page. This must\n      // win over `passthrough.enabled`, so it is spread last.\n      enabled: false,\n    },\n    queryClient\n  );\n\n  const historyPages = history.data?.pages;\n  const hasLoadedHistory = (historyPages?.length ?? 0) > 0;\n\n  const conversations = useMemo(\n    () =>\n      mergeConversationPages([\n        ...(firstPage.data ? [firstPage.data] : []),\n        ...(historyPages ?? []),\n      ]),\n    [firstPage.data, historyPages]\n  );\n\n  const fetchNextHistoryPage = history.fetchNextPage;\n  const refetchHistoryFirstPage = history.refetch;\n  const fetchNextPage = useCallback(\n    () => (hasLoadedHistory ? fetchNextHistoryPage() : refetchHistoryFirstPage()),\n    [hasLoadedHistory, fetchNextHistoryPage, refetchHistoryFirstPage]\n  );\n\n  const refresh = useCallback(() => firstPage.refetch(), [firstPage.refetch]);\n\n  const invalidate = useCallback(\n    () => invalidateConversationListCaches(queryClient, { scopeKey }),\n    [queryClient, scopeKey]\n  );\n\n  const prependConversation = useCallback(\n    (item: ConversationSummary) => {\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? prependConversationToPage(page, item) : page\n      );\n    },\n    [queryClient, firstPageKey]\n  );\n\n  const removeConversation = useCallback(\n    (threadId: string) => {\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? removeConversationFromPage(page, threadId) : page\n      );\n      queryClient.setQueryData<InfiniteData<ConversationListPage, number>>(historyKey, (data) =>\n        data\n          ? { ...data, pages: data.pages.map((page) => removeConversationFromPage(page, threadId)) }\n          : data\n      );\n    },\n    [queryClient, firstPageKey, historyKey]\n  );\n\n  const patchConversation = useCallback(\n    (threadId: string, patch: Partial<ConversationSummary>) => {\n      const match = (item: ConversationSummary) => item.threadId === threadId;\n      queryClient.setQueryData<ConversationListPage>(firstPageKey, (page) =>\n        page ? patchConversationsInPage(page, match, patch) : page\n      );\n      queryClient.setQueryData<InfiniteData<ConversationListPage, number>>(historyKey, (data) =>\n        data\n          ? {\n              ...data,\n              pages: data.pages.map((page) => patchConversationsInPage(page, match, patch)),\n            }\n          : data\n      );\n    },\n    [queryClient, firstPageKey, historyKey]\n  );\n\n  return {\n    conversations,\n    totalCount: firstPage.data?.totalCount ?? null,\n    homeAgentApplied: firstPage.data?.homeAgentApplied === true,\n    isLoading: firstPage.isLoading,\n    isFetching: firstPage.isFetching || history.isFetching,\n    hasResolvedFirstPage: firstPage.data !== undefined,\n    hasNextPage: hasLoadedHistory\n      ? (history.hasNextPage ?? false)\n      : (firstPage.data?.hasMore ?? false),\n    isFetchingNextPage: history.isFetchingNextPage || (!hasLoadedHistory && history.isFetching),\n    isFetchNextPageError: history.isError,\n    fetchNextPage,\n    refresh,\n    invalidate,\n    prependConversation,\n    removeConversation,\n    patchConversation,\n  };\n}\n"],"names":["CONVERSATION_LIST_DEFAULT_SCOPE_KEY","useQueryClient","useRef","normalizeConversationListFilter","conversationListFilterKey","useMemo","conversationListQueryKeys","useQuery","useInfiniteQuery","mergeConversationPages","useCallback","invalidateConversationListCaches","prependConversationToPage","removeConversationFromPage","patchConversationsInPage"],"mappings":"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"}

package/dist/agent-runtime/src/use-conversation-list.d.ts

@@ -38,6 +38,12 @@ export interface ConversationListController {
     conversations: ConversationSummary[];
     /** Advisory total from the live first page, when the transport counts. */
     totalCount: number | null;
+    /**
+     * Whether the live first page's latest answer held the conversations with
+     * the filter's `homeAgentId` agent ({@link ConversationListPage.homeAgentApplied}).
+     * `false` until it answers, and wherever the server did not widen the list.
+     */
+    homeAgentApplied: boolean;
     isLoading: boolean;
     isFetching: boolean;
     /** True once the live first page has resolved at least once. */