@athenaintel/react 0.55.0 → 0.56.0

package/dist/agent-runtime/src/history-store.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-store.cjs","sources":["../../../../agent-runtime/src/history-store.ts"],"sourcesContent":["import type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport {\n  DEEP_AGENT_HISTORY_PAGE_COMMAND,\n  DEEP_AGENT_HISTORY_PAGE_PROTOCOL_VERSION,\n  DEEP_AGENT_MAIN_NS,\n  DEEP_AGENT_MAX_HISTORY_PAGE_STEPS,\n  DEEP_AGENT_MAX_HISTORY_PAGE_TURNS,\n  DEEP_AGENT_MESSAGE_HISTORY_HEADER,\n  DEEP_AGENT_MESSAGE_HISTORY_PAGED,\n} from './generated/runconfig-contract';\nimport { QUIET_TOOL_NAMES } from './tool-names';\n\n/**\n * Older history on the client — the client half of agora's `history/page`.\n *\n * On a host whose `protocol` lane advertises\n * `DEEP_AGENT_HISTORY_PAGE_PROTOCOL_VERSION`, an attach states only its head\n * (and its lane follows) on `athena/interest`, and says on its attach headers\n * that it keeps older history itself ({@link withDeclaredPagedHistory}).\n * Older messages come back from the one-shot `history/page` command\n * (`{before, turns}` answers whole turns ending before `before`, oldest\n * first; a long turn rides as its prompt and answer, its steps counted) and\n * live here, never in the attach's view, so the interest document stays the\n * same small size however deep the viewer scrolls, and scrolling back moves\n * the page anchor instead of growing a list.\n *\n * The store keeps each message's parent as the reader sees the transcript,\n * and which message starts it. Every read of the interest window records the\n * parents its live chain shows, so a message that slides out of the head (the\n * host holds the head down to its floor for at most\n * `DEEP_AGENT_MAX_HELD_HEAD` messages) stays reachable here, and a re-attach\n * on any pod finds what was loaded. A page records the parents it shows (a\n * summarized turn's answer follows its prompt). A host parent never changes:\n * an edit or rewind mints new ids, a branch switch keeps each id's parent.\n * {@link readDeepAgentMessageWindow} joins the store under the live chain by\n * walking parents back from its first message, so only ancestors of the live\n * view are ever shown: a rewound tail is never reached.\n *\n * A summarized turn's left-out steps come back on request (`history/page`\n * with its `turn`, newest first, {@link DeepAgentHistoryStore.loadSteps}) and\n * are spliced in where the page left them out: between the turn's prompt and\n * the first message shown after it. The join marks each summarized turn on\n * its first reply message ({@link DEEP_AGENT_TURN_STEPS_KEY}), so a renderer\n * reads its exact counts (\"Used 313 tools\") and can offer the steps still\n * left out.\n *\n * One store per conversation, shared by every reader in the JS context (the\n * converter, the edit path, the history edge), so they agree on what is\n * loaded. The registry keeps the most recently read\n * {@link DEEP_AGENT_HISTORY_STORE_LIMIT} conversations.\n */\n\n/** Conversations whose stores the registry keeps (least recently read evicted). */\nexport const DEEP_AGENT_HISTORY_STORE_LIMIT = 8;\n\n/** Steps of one summarized turn one `history/page` asks for. */\nexport const DEEP_AGENT_TURN_STEPS_PAGE = 100;\n\n/** `additional_kwargs` key the join marks a summarized turn's first reply message with. */\nexport const DEEP_AGENT_TURN_STEPS_KEY = 'athena_turn_steps';\n\n/**\n * What a summarized turn's page left out (`steps` on a `history/page` turn):\n * counted over the left-out messages only, so a reader adds what it holds.\n */\nexport interface DeepAgentHistoryTurnSteps {\n  /** Messages left out. */\n  count: number;\n  /** Tool calls among the messages left out. */\n  tools: number;\n  /** Of which `task` delegations. */\n  delegations: number;\n  /** The oldest and newest message left out. */\n  first: string | null;\n  last: string | null;\n}\n\n/** A turn a page summarized: what it left out, and where. */\nexport interface DeepAgentHistorySummarizedTurn {\n  steps: DeepAgentHistoryTurnSteps;\n  /**\n   * The message the left-out steps end before: the first the page shows after\n   * the turn's prompt, or — for a turn cut short by what the asker held — the\n   * message the page was asked before.\n   */\n  resume: string;\n}\n\n/** One `history/page` answer, read off the wire. */\nexport interface DeepAgentHistoryPage {\n  /** The message the page ends before. */\n  before: string;\n  /** Oldest first. */\n  messages: LangChainMessage[];\n  /** Whether the transcript holds messages older than the page. */\n  moreBefore: boolean;\n  /** The page's summarized turns, by their first message's id. */\n  summarized?: ReadonlyMap<string, DeepAgentHistorySummarizedTurn>;\n}\n\n/** One `history/page` answer to `{turn, before, steps}`: a summarized turn's steps. */\nexport interface DeepAgentTurnStepsPage {\n  turn: string;\n  /** Steps, oldest first. */\n  messages: LangChainMessage[];\n  /** Older steps of the turn remain. */\n  moreBefore: boolean;\n}\n\n/** What the store holds older than one message. */\nexport interface DeepAgentHistoryOlder {\n  /** Ids, oldest first, ending right before the message asked about. */\n  ids: string[];\n  messages: LangChainMessage[];\n  /** Whether anything older than `ids[0]` (or the message itself) may exist. */\n  hasOlder: boolean;\n}\n\n/**\n * The marker the join puts on a summarized turn's first reply message: the\n * turn's steps not shown yet, so a renderer reads exact counts and knows\n * whether opening it has steps to fetch ({@link loadDeepAgentTurnSteps}).\n */\nexport interface DeepAgentTurnStepsMarker {\n  /** The turn's first message: the id its steps are paged by. */\n  turn: string;\n  /** The conversation it belongs to (its history store). */\n  thread: string;\n  /** Steps not loaded yet. */\n  hiddenSteps: number;\n  /** Tool calls among them. */\n  hiddenTools: number;\n  /** Of which `task` delegations. */\n  hiddenDelegations: number;\n  /** The oldest step loaded; `undefined` while none is. */\n  before: string | undefined;\n}\n\n/** How the store asks the host: the thread's `sendCommand` (its answer, the command's payload). */\nexport type DeepAgentHistorySend = (command: HistoryPageCommand | TurnStepsCommand) => unknown;\n\nexport interface DeepAgentHistoryStore {\n  /**\n   * Whether the host refused `history/page` although its `protocol` lane\n   * advertises it (a host without the command): readers then read the live\n   * view alone and page by interest, until {@link markServed}.\n   */\n  readonly unserved: boolean;\n  /** The connection the refusal came on (`markUnserved`): a later one may land on a host that serves it. */\n  readonly unservedBy: unknown;\n  /** Bumped on every change readers can see (a page, steps, the unserved flag). */\n  readonly version: number;\n  markUnserved(connection?: unknown): void;\n  markServed(): void;\n  /**\n   * Record what a live chain shows: each entry's parent is the one before it,\n   * and with `startsTranscript` its first entry has none. Messages are kept by\n   * id (the newest form seen). Silent: a live chain changes nothing its own\n   * reader shows.\n   */\n  recordChain(\n    ids: readonly string[],\n    messages: ReadonlyMap<string, LangChainMessage>,\n    startsTranscript: boolean\n  ): void;\n  /**\n   * Take in one page; notifies. `false` for an empty page that told nothing\n   * new. A page's messages are the transcript as the reader sees it: a\n   * summarized turn's answer follows its prompt, its steps left out.\n   */\n  addPage(page: DeepAgentHistoryPage): boolean;\n  /**\n   * Take in a summarized turn's older steps, spliced in where its page left\n   * them out; notifies. `false` for a turn the store does not hold.\n   */\n  addSteps(page: DeepAgentTurnStepsPage): boolean;\n  /** What a summarized turn's page left out, by the turn's first message id. */\n  turnSteps(turnId: string): DeepAgentHistoryTurnSteps | undefined;\n  /** Everything the store holds older than `id`, walking parents back. */\n  olderThan(id: string): DeepAgentHistoryOlder;\n  /** The host parent of `id`: `null` at the transcript's start, `undefined` while unknown. */\n  parentOf(id: string): string | null | undefined;\n  /**\n   * `messages` (a transcript as a reader shows it, oldest first) with each\n   * summarized turn's marker on its first reply message\n   * ({@link DEEP_AGENT_TURN_STEPS_KEY}); the same array when none applies.\n   */\n  markTurns(threadId: string, messages: LangChainMessage[]): LangChainMessage[];\n  /** Whether a steps request for the turn is in flight — the loader's dedupe. */\n  isLoadingSteps(turn: string): boolean;\n  /**\n   * Fetches a summarized turn's next older steps (`history/page` with its\n   * `turn`) into the store. A turn already loading, unknown, or with no steps\n   * left is a no-op. Rejects with the host's refusal, or when the answer is\n   * not a page this client reads.\n   */\n  loadSteps(options: { send: DeepAgentHistorySend; turn: string; steps?: number }): Promise<void>;\n  subscribe(listener: () => void): () => void;\n}\n\ninterface SummarizedTurnState extends DeepAgentHistorySummarizedTurn {\n  /** The message the page showed right after the gap; `resume` moves down as steps load. */\n  shownAfter: string;\n  /** Steps loaded, oldest first. */\n  loaded: LangChainMessage[];\n  /** Older steps remain to load. */\n  more: boolean;\n}\n\n/**\n * The tool calls among `messages` a converter shows. The host counts every\n * call of a turn; a quiet call (`QUIET_TOOL_NAMES`) never renders, so it stays\n * in the hidden count once loaded and the turn's total holds still as its\n * steps load.\n */\nfunction toolCalls(messages: readonly LangChainMessage[]): { tools: number; delegations: number } {\n  let tools = 0;\n  let delegations = 0;\n  for (const message of messages) {\n    if (message.type !== 'ai') continue;\n    for (const call of message.tool_calls ?? []) {\n      if (QUIET_TOOL_NAMES.has(call.name)) continue;\n      tools += 1;\n      if (call.name === 'task') delegations += 1;\n    }\n  }\n  return { tools, delegations };\n}\n\n/** The marked copy of a message, reused while the message and its marker are the same. */\nconst markedCopies = new WeakMap<object, { key: string; message: LangChainMessage }>();\n\nfunction withMarker(message: LangChainMessage, marker: DeepAgentTurnStepsMarker): LangChainMessage {\n  const key = `${marker.thread}\\u0000${marker.turn}\\u0000${marker.hiddenSteps}\\u0000${marker.hiddenTools}\\u0000${marker.hiddenDelegations}\\u0000${marker.before ?? ''}`;\n  const cached = markedCopies.get(message);\n  if (cached?.key === key) return cached.message;\n  // Every wire message carries `additional_kwargs` in practice; the upstream\n  // type leaves it off tool messages.\n  const kwargs = (message as { additional_kwargs?: Record<string, unknown> }).additional_kwargs;\n  const marked = {\n    ...message,\n    additional_kwargs: { ...(kwargs ?? {}), [DEEP_AGENT_TURN_STEPS_KEY]: marker },\n  } as LangChainMessage;\n  markedCopies.set(message, { key, message: marked });\n  return marked;\n}\n\nexport function createDeepAgentHistoryStore(): DeepAgentHistoryStore {\n  const parents = new Map<string, string | null>();\n  const summaries = new Map<string, SummarizedTurnState>();\n  /** A summarized turn by the messages its marker may start at: its prompt and where its steps resume. */\n  const turnStarts = new Map<string, string>();\n  const messages = new Map<string, LangChainMessage>();\n  const loadingSteps = new Set<string>();\n  const listeners = new Set<() => void>();\n  let unserved = false;\n  let unservedBy: unknown;\n  let version = 0;\n  const notify = () => {\n    version += 1;\n    for (const listener of [...listeners]) listener();\n  };\n  const marker = (threadId: string, turn: string, state: SummarizedTurnState): DeepAgentTurnStepsMarker => {\n    // The host counts only the messages the page left out; of those, the\n    // steps loaded since render on their own, so they leave the hidden count.\n    const loaded = toolCalls(state.loaded);\n    return {\n      turn,\n      thread: threadId,\n      hiddenSteps: state.more ? Math.max(0, state.steps.count - state.loaded.length) : 0,\n      hiddenTools: Math.max(0, state.steps.tools - loaded.tools),\n      hiddenDelegations: Math.max(0, state.steps.delegations - loaded.delegations),\n      before: state.loaded[0]?.id,\n    };\n  };\n  const store: DeepAgentHistoryStore = {\n    get unserved() {\n      return unserved;\n    },\n    get unservedBy() {\n      return unservedBy;\n    },\n    get version() {\n      return version;\n    },\n    markUnserved(connection) {\n      unservedBy = connection;\n      if (unserved) return;\n      unserved = true;\n      notify();\n    },\n    markServed() {\n      unservedBy = undefined;\n      if (!unserved) return;\n      unserved = false;\n      notify();\n    },\n    recordChain(ids, chainMessages, startsTranscript) {\n      for (let index = 0; index < ids.length; index += 1) {\n        const id = ids[index] as string;\n        if (index > 0) parents.set(id, ids[index - 1] as string);\n        else if (startsTranscript) parents.set(id, null);\n        const message = chainMessages.get(id);\n        if (message !== undefined) messages.set(id, message);\n      }\n    },\n    addPage({ before, messages: page, moreBefore, summarized }) {\n      let changed = false;\n      const setParent = (id: string, parent: string | null) => {\n        if (parents.get(id) === parent) return;\n        parents.set(id, parent);\n        changed = true;\n      };\n      const ids: string[] = [];\n      for (const message of page) {\n        if (typeof message.id !== 'string' || !message.id) continue;\n        ids.push(message.id);\n        if (messages.get(message.id) !== message) {\n          messages.set(message.id, message);\n          changed = true;\n        }\n      }\n      for (const [index, id] of ids.entries()) {\n        if (index > 0) setParent(id, ids[index - 1] as string);\n        else if (!moreBefore) setParent(id, null);\n        else if (parents.get(id) === null) {\n          // The host says more lies before it: a remembered start was wrong.\n          parents.delete(id);\n          changed = true;\n        }\n      }\n      const last = ids.at(-1);\n      if (last !== undefined) setParent(before, last);\n      else if (!moreBefore) setParent(before, null);\n      for (const [turn, summary] of summarized ?? []) {\n        const held = summaries.get(turn);\n        if (held === undefined) {\n          summaries.set(turn, {\n            ...summary,\n            shownAfter: summary.resume,\n            loaded: [],\n            more: summary.steps.count > 0,\n          });\n          turnStarts.set(turn, turn);\n          turnStarts.set(summary.resume, turn);\n          changed = true;\n          continue;\n        }\n        const oldest = held.loaded[0];\n        const newest = held.loaded.at(-1);\n        if (oldest !== undefined && newest !== undefined) {\n          // The same turn paged again (another reader asked the same page):\n          // keep the steps already spliced in where the page left them out.\n          setParent(oldest.id as string, parents.get(held.shownAfter) ?? null);\n          setParent(held.shownAfter, newest.id as string);\n        }\n      }\n      if (unserved) {\n        unserved = false;\n        unservedBy = undefined;\n        changed = true;\n      }\n      if (changed) notify();\n      return changed;\n    },\n    addSteps({ turn, messages: steps, moreBefore }) {\n      const held = summaries.get(turn);\n      if (held === undefined) return false;\n      const loadedIds = new Set(held.loaded.map((message) => message.id));\n      const fresh = steps.filter(\n        (message) => typeof message.id === 'string' && message.id && !loadedIds.has(message.id)\n      );\n      const more = moreBefore && fresh.length > 0;\n      if (fresh.length === 0) {\n        if (held.more === more) return false;\n        held.more = more;\n        notify();\n        return true;\n      }\n      // Splice the steps in where the gap is: after what precedes it (the\n      // prompt), before where the shown transcript resumes.\n      const above = parents.get(held.resume);\n      const freshIds = fresh.map((message) => message.id as string);\n      for (const [index, id] of freshIds.entries()) {\n        messages.set(id, fresh[index] as LangChainMessage);\n        if (index > 0) parents.set(id, freshIds[index - 1] as string);\n        else if (above !== undefined) parents.set(id, above);\n      }\n      parents.set(held.resume, freshIds.at(-1) as string);\n      turnStarts.delete(held.resume);\n      held.resume = freshIds[0] as string;\n      turnStarts.set(held.resume, turn);\n      held.loaded = [...fresh, ...held.loaded];\n      held.more = more;\n      notify();\n      return true;\n    },\n    olderThan(id) {\n      const ids: string[] = [];\n      const older: LangChainMessage[] = [];\n      const seen = new Set<string>([id]);\n      let parent = parents.get(id);\n      while (typeof parent === 'string' && !seen.has(parent)) {\n        const message = messages.get(parent);\n        if (message === undefined) break;\n        seen.add(parent);\n        ids.push(parent);\n        older.push(message);\n        parent = parents.get(parent);\n      }\n      ids.reverse();\n      older.reverse();\n      return { ids, messages: older, hasOlder: parent !== null };\n    },\n    parentOf(id) {\n      return parents.get(id);\n    },\n    turnSteps(turnId) {\n      return summaries.get(turnId)?.steps;\n    },\n    markTurns(threadId, transcript) {\n      if (summaries.size === 0) return transcript;\n      let marked: LangChainMessage[] | null = null;\n      let pending: DeepAgentTurnStepsMarker | null = null;\n      const started = new Set<string>();\n      for (const [index, message] of transcript.entries()) {\n        const id = typeof message.id === 'string' ? message.id : undefined;\n        const turn = id === undefined ? undefined : turnStarts.get(id);\n        if (turn !== undefined && !started.has(turn)) {\n          started.add(turn);\n          const state = summaries.get(turn) as SummarizedTurnState;\n          pending = marker(threadId, turn, state);\n        } else if (message.type === 'human') {\n          // The turn showed no reply before the next one began.\n          pending = null;\n        }\n        // The marker rides an assistant message: a tool result whose call is\n        // older than what is shown converts to no row.\n        if (pending === null || message.type !== 'ai') continue;\n        marked ??= [...transcript];\n        marked[index] = withMarker(message, pending);\n        pending = null;\n      }\n      return marked ?? transcript;\n    },\n    isLoadingSteps(turn) {\n      return loadingSteps.has(turn);\n    },\n    async loadSteps({ send, turn, steps = DEEP_AGENT_TURN_STEPS_PAGE }) {\n      const held = summaries.get(turn);\n      if (held === undefined || !held.more || loadingSteps.has(turn)) return;\n      loadingSteps.add(turn);\n      try {\n        const answer = readTurnStepsResult(await send(buildTurnStepsCommand({ turn, before: held.resume, steps })));\n        if (answer === null || answer.turn !== turn) {\n          throw new Error('history/page answered steps in a shape this client cannot read');\n        }\n        store.addSteps(answer);\n      } finally {\n        loadingSteps.delete(turn);\n      }\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n  return store;\n}\n\n/**\n * The registry lives on `globalThis`, not in module scope, because two copies\n * of this module can run in one page: the SDK bundles agent-runtime into its\n * dist while a host (Spaces, the Chrome extension, the Office add-in) imports\n * it directly. The host's thread joins pages through its copy while the SDK's\n * history edge and steps control load them through their own; both must see\n * one store per conversation.\n */\nconst HISTORY_STORES = Symbol.for('@athenaintel/agent-runtime/history-stores');\n\ninterface HistoryStoreRegistry {\n  stores: Map<string, DeepAgentHistoryStore>;\n  listeners: Set<() => void>;\n  version: number;\n}\n\ntype HistoryStoreRegistryHost = typeof globalThis & { [HISTORY_STORES]?: HistoryStoreRegistry };\n\n// process-local: this client only — the older history it has read, in memory; nothing is persisted\nfunction registry(): HistoryStoreRegistry {\n  const host = globalThis as HistoryStoreRegistryHost;\n  return (host[HISTORY_STORES] ??= { stores: new Map(), listeners: new Set(), version: 0 });\n}\n\nconst notifyRegistry = () => {\n  const shared = registry();\n  shared.version += 1;\n  for (const listener of [...shared.listeners]) listener();\n};\n\n/** The conversation's history store, created on first use and marked most recently read. */\nexport function deepAgentHistoryStore(threadId: string): DeepAgentHistoryStore {\n  const { stores } = registry();\n  let store = stores.get(threadId);\n  if (store !== undefined) {\n    stores.delete(threadId);\n    stores.set(threadId, store);\n    return store;\n  }\n  store = createDeepAgentHistoryStore();\n  store.subscribe(notifyRegistry);\n  stores.set(threadId, store);\n  while (stores.size > DEEP_AGENT_HISTORY_STORE_LIMIT) {\n    const oldest = stores.keys().next().value as string;\n    stores.delete(oldest);\n  }\n  return store;\n}\n\n/** The conversation's store if the registry holds one, without creating or touching it. */\nexport function peekDeepAgentHistoryStore(threadId: string): DeepAgentHistoryStore | undefined {\n  return registry().stores.get(threadId);\n}\n\n/** Any store's visible change (a page, steps, the unserved flag): what a converter re-runs on. */\nexport function subscribeDeepAgentHistory(listener: () => void): () => void {\n  const { listeners } = registry();\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\nexport function deepAgentHistoryVersion(): number {\n  return registry().version;\n}\n\n/** Drop every conversation's store (sign-out, an identity change, tests). */\nexport function clearDeepAgentHistoryStores(): void {\n  const { stores } = registry();\n  if (stores.size === 0) return;\n  stores.clear();\n  notifyRegistry();\n}\n\n/**\n * Fetch the next older steps of the summarized turn a marker names, into its\n * conversation's store (the converter re-runs and shows them). A no-op when\n * the store is gone (evicted, cleared) or the turn has no steps left.\n */\nexport function loadDeepAgentTurnSteps({\n  send,\n  marker,\n  steps,\n}: {\n  send: DeepAgentHistorySend;\n  marker: Pick<DeepAgentTurnStepsMarker, 'thread' | 'turn' | 'hiddenSteps'>;\n  steps?: number;\n}): Promise<void> {\n  if (marker.hiddenSteps === 0) return Promise.resolve();\n  const store = peekDeepAgentHistoryStore(marker.thread);\n  if (store === undefined) return Promise.resolve();\n  return store.loadSteps({ send, turn: marker.turn, ...(steps !== undefined && { steps }) });\n}\n\n/** Whether a steps request for the marker's turn is in flight. */\nexport function isLoadingDeepAgentTurnSteps(marker: Pick<DeepAgentTurnStepsMarker, 'thread' | 'turn'>): boolean {\n  return peekDeepAgentHistoryStore(marker.thread)?.isLoadingSteps(marker.turn) ?? false;\n}\n\n/** Whether the host's advertised contract version serves `history/page`. */\nexport function hostServesHistoryPage(version: number | null | undefined): boolean {\n  return typeof version === 'number' && version >= DEEP_AGENT_HISTORY_PAGE_PROTOCOL_VERSION;\n}\n\n/**\n * Whether a `history/page` failure says this host does not serve the\n * command: statewire's `unknown-command`, a host without it although its\n * `protocol` lane advertises it. Any other refusal (a vanished anchor, a\n * malformed request, a host that cannot answer right now) is that page's\n * failure, reported to the reader, who may ask again; it never takes the\n * conversation off its store, whose history stays shown.\n */\nexport function isHistoryPageUnserved(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; code?: unknown } } | null | undefined)\n    ?.failure;\n  return failure?.fate === 'rejected' && failure.code === 'unknown-command';\n}\n\n/**\n * Attach headers saying the client keeps older history itself\n * (`x-athena-deep-agent-history: paged`): the host then holds its head down\n * to its floor for at most `DEEP_AGENT_MAX_HELD_HEAD` messages, since what\n * slides out stays in the store. Every attach of this build says so: every\n * reader joins the store (`readDeepAgentMessageWindow`). An explicit entry\n * wins.\n */\nexport function withDeclaredPagedHistory(headers: Record<string, string>): Record<string, string> {\n  if (DEEP_AGENT_MESSAGE_HISTORY_HEADER in headers) return headers;\n  return { ...headers, [DEEP_AGENT_MESSAGE_HISTORY_HEADER]: DEEP_AGENT_MESSAGE_HISTORY_PAGED };\n}\n\n/**\n * The windowed wire's page commands on the statewire command union, so\n * `sendCommand({ type: 'history/page', … })` typechecks wherever the\n * deep-agent host is driven (an attach-ACL read, like `history/lane`).\n */\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** One page of older transcript history. */\n      historyPage: HistoryPageCommand;\n      /** One summarized turn's steps. */\n      historyTurnSteps: TurnStepsCommand;\n    }\n  }\n}\n\n/**\n * The turns `history/page` reads per page: about a screen and a half of\n * conversation, however long each run was (a long turn rides as its prompt\n * and answer, its steps counted).\n */\nexport const DEEP_AGENT_HISTORY_PAGE_TURNS = 10;\n\n/** The `history/page` command: up to `turns` whole turns ending before `before`. */\nexport interface HistoryPageCommand {\n  readonly type: typeof DEEP_AGENT_HISTORY_PAGE_COMMAND;\n  readonly before: string;\n  readonly turns: number;\n}\n\n/** The `history/page` command asking for one summarized turn's steps older than `before`. */\nexport interface TurnStepsCommand {\n  readonly type: typeof DEEP_AGENT_HISTORY_PAGE_COMMAND;\n  readonly turn: string;\n  readonly before?: string;\n  readonly steps: number;\n}\n\nexport function buildHistoryPageCommand({\n  before,\n  turns = DEEP_AGENT_HISTORY_PAGE_TURNS,\n}: {\n  before: string;\n  turns?: number;\n}): HistoryPageCommand {\n  return {\n    type: DEEP_AGENT_HISTORY_PAGE_COMMAND,\n    before,\n    turns: Math.max(1, Math.min(DEEP_AGENT_MAX_HISTORY_PAGE_TURNS, Math.trunc(turns))),\n  };\n}\n\nexport function buildTurnStepsCommand({\n  turn,\n  before,\n  steps = DEEP_AGENT_TURN_STEPS_PAGE,\n}: {\n  turn: string;\n  before?: string | undefined;\n  steps?: number;\n}): TurnStepsCommand {\n  return {\n    type: DEEP_AGENT_HISTORY_PAGE_COMMAND,\n    turn,\n    ...(before !== undefined && { before }),\n    steps: Math.max(1, Math.min(DEEP_AGENT_MAX_HISTORY_PAGE_STEPS, Math.trunc(steps))),\n  };\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst isCount = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 0;\n\nconst isId = (value: unknown): value is string => typeof value === 'string' && value.length > 0;\n\nconst readTurnSteps = (value: unknown): DeepAgentHistoryTurnSteps | null | undefined => {\n  if (value === null) return null;\n  if (!isRecord(value)) return undefined;\n  const { count, tools, delegations, first, last } = value;\n  if (!isCount(count) || !isCount(tools) || !isCount(delegations)) return undefined;\n  const id = (entry: unknown) => (isId(entry) ? entry : null);\n  return { count, tools, delegations, first: id(first), last: id(last) };\n};\n\nfunction readMessages(value: unknown): LangChainMessage[] | null {\n  if (!Array.isArray(value)) return null;\n  for (const message of value) {\n    if (!isRecord(message) || !isId(message.id)) return null;\n  }\n  return value as LangChainMessage[];\n}\n\n/**\n * A `history/page` answer to `{before, turns}` read as one page of messages:\n * the turns' shown messages, oldest first (a summarized turn's prompt and\n * answer, its steps left out and counted in `summarized`). `null` when\n * malformed.\n */\nexport function readHistoryPageResult(\n  payload: unknown,\n  before: string\n): (DeepAgentHistoryPage & { summarized: ReadonlyMap<string, DeepAgentHistorySummarizedTurn> }) | null {\n  if (!isRecord(payload) || !Array.isArray(payload.turns) || !isRecord(payload.more)) return null;\n  if (typeof payload.more.before !== 'boolean') return null;\n  const page: LangChainMessage[] = [];\n  const turns: { id: string; messages: LangChainMessage[]; steps: DeepAgentHistoryTurnSteps | null }[] = [];\n  for (const turn of payload.turns) {\n    if (!isRecord(turn) || !isId(turn.id)) return null;\n    const turnMessages = readMessages(turn.messages);\n    if (turnMessages === null) return null;\n    const steps = readTurnSteps(turn.steps);\n    if (steps === undefined && turn.steps !== undefined) return null;\n    turns.push({ id: turn.id, messages: turnMessages, steps: steps ?? null });\n    page.push(...turnMessages);\n  }\n  const summarized = new Map<string, DeepAgentHistorySummarizedTurn>();\n  for (const [index, turn] of turns.entries()) {\n    if (turn.steps === null) continue;\n    // The steps left out sit right after the prompt; the shown transcript\n    // resumes at the next message the page carries, or — a turn the asker's\n    // own messages cut short — at the message the page was asked before.\n    const shown = turn.messages[0]?.id === turn.id ? turn.messages.slice(1) : turn.messages;\n    const resume = shown[0]?.id ?? turns[index + 1]?.messages[0]?.id ?? before;\n    summarized.set(turn.id, { steps: turn.steps, resume });\n  }\n  return { before, messages: page, moreBefore: payload.more.before, summarized };\n}\n\n/** A `history/page` answer to `{turn, before?, steps}`, or `null` when it is malformed. */\nexport function readTurnStepsResult(payload: unknown): DeepAgentTurnStepsPage | null {\n  if (!isRecord(payload) || !isId(payload.turn) || !isRecord(payload.more)) return null;\n  if (typeof payload.more.before !== 'boolean') return null;\n  const steps = readMessages(payload.messages);\n  if (steps === null) return null;\n  return { turn: payload.turn, messages: steps, moreBefore: payload.more.before };\n}\n\n/** The marker a join put on a source message, or `undefined`. */\nexport function readTurnStepsMarker(message: unknown): DeepAgentTurnStepsMarker | undefined {\n  if (!isRecord(message) || !isRecord(message.additional_kwargs)) return undefined;\n  const marker = message.additional_kwargs[DEEP_AGENT_TURN_STEPS_KEY];\n  if (!isRecord(marker) || !isId(marker.turn) || !isId(marker.thread)) return undefined;\n  const { hiddenSteps, hiddenTools, hiddenDelegations, before } = marker;\n  if (!isCount(hiddenSteps) || !isCount(hiddenTools) || !isCount(hiddenDelegations)) return undefined;\n  return {\n    turn: marker.turn,\n    thread: marker.thread,\n    hiddenSteps,\n    hiddenTools,\n    hiddenDelegations,\n    before: isId(before) ? before : undefined,\n  };\n}\n\n/** The interest-request shape a page is reported as (telemetry parity with interest pages). */\nexport function historyPageAsInterestRequest(command: HistoryPageCommand): {\n  ns: typeof DEEP_AGENT_MAIN_NS;\n  before: number;\n  at: string;\n} {\n  return { ns: DEEP_AGENT_MAIN_NS, before: command.turns, at: command.before };\n}\n"],"names":["QUIET_TOOL_NAMES","DEEP_AGENT_HISTORY_PAGE_PROTOCOL_VERSION","DEEP_AGENT_MESSAGE_HISTORY_HEADER","DEEP_AGENT_MESSAGE_HISTORY_PAGED","DEEP_AGENT_HISTORY_PAGE_COMMAND","DEEP_AGENT_MAX_HISTORY_PAGE_TURNS","DEEP_AGENT_MAX_HISTORY_PAGE_STEPS","DEEP_AGENT_MAIN_NS"],"mappings":"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"}

package/dist/agent-runtime/src/history-store.d.ts

@@ -0,0 +1,282 @@
+import type { LangChainMessage } from '@assistant-ui/react-langgraph';
+import { DEEP_AGENT_HISTORY_PAGE_COMMAND, DEEP_AGENT_MAIN_NS } from './generated/runconfig-contract';
+/**
+ * Older history on the client — the client half of agora's `history/page`.
+ *
+ * On a host whose `protocol` lane advertises
+ * `DEEP_AGENT_HISTORY_PAGE_PROTOCOL_VERSION`, an attach states only its head
+ * (and its lane follows) on `athena/interest`, and says on its attach headers
+ * that it keeps older history itself ({@link withDeclaredPagedHistory}).
+ * Older messages come back from the one-shot `history/page` command
+ * (`{before, turns}` answers whole turns ending before `before`, oldest
+ * first; a long turn rides as its prompt and answer, its steps counted) and
+ * live here, never in the attach's view, so the interest document stays the
+ * same small size however deep the viewer scrolls, and scrolling back moves
+ * the page anchor instead of growing a list.
+ *
+ * The store keeps each message's parent as the reader sees the transcript,
+ * and which message starts it. Every read of the interest window records the
+ * parents its live chain shows, so a message that slides out of the head (the
+ * host holds the head down to its floor for at most
+ * `DEEP_AGENT_MAX_HELD_HEAD` messages) stays reachable here, and a re-attach
+ * on any pod finds what was loaded. A page records the parents it shows (a
+ * summarized turn's answer follows its prompt). A host parent never changes:
+ * an edit or rewind mints new ids, a branch switch keeps each id's parent.
+ * {@link readDeepAgentMessageWindow} joins the store under the live chain by
+ * walking parents back from its first message, so only ancestors of the live
+ * view are ever shown: a rewound tail is never reached.
+ *
+ * A summarized turn's left-out steps come back on request (`history/page`
+ * with its `turn`, newest first, {@link DeepAgentHistoryStore.loadSteps}) and
+ * are spliced in where the page left them out: between the turn's prompt and
+ * the first message shown after it. The join marks each summarized turn on
+ * its first reply message ({@link DEEP_AGENT_TURN_STEPS_KEY}), so a renderer
+ * reads its exact counts ("Used 313 tools") and can offer the steps still
+ * left out.
+ *
+ * One store per conversation, shared by every reader in the JS context (the
+ * converter, the edit path, the history edge), so they agree on what is
+ * loaded. The registry keeps the most recently read
+ * {@link DEEP_AGENT_HISTORY_STORE_LIMIT} conversations.
+ */
+/** Conversations whose stores the registry keeps (least recently read evicted). */
+export declare const DEEP_AGENT_HISTORY_STORE_LIMIT = 8;
+/** Steps of one summarized turn one `history/page` asks for. */
+export declare const DEEP_AGENT_TURN_STEPS_PAGE = 100;
+/** `additional_kwargs` key the join marks a summarized turn's first reply message with. */
+export declare const DEEP_AGENT_TURN_STEPS_KEY = "athena_turn_steps";
+/**
+ * What a summarized turn's page left out (`steps` on a `history/page` turn):
+ * counted over the left-out messages only, so a reader adds what it holds.
+ */
+export interface DeepAgentHistoryTurnSteps {
+    /** Messages left out. */
+    count: number;
+    /** Tool calls among the messages left out. */
+    tools: number;
+    /** Of which `task` delegations. */
+    delegations: number;
+    /** The oldest and newest message left out. */
+    first: string | null;
+    last: string | null;
+}
+/** A turn a page summarized: what it left out, and where. */
+export interface DeepAgentHistorySummarizedTurn {
+    steps: DeepAgentHistoryTurnSteps;
+    /**
+     * The message the left-out steps end before: the first the page shows after
+     * the turn's prompt, or — for a turn cut short by what the asker held — the
+     * message the page was asked before.
+     */
+    resume: string;
+}
+/** One `history/page` answer, read off the wire. */
+export interface DeepAgentHistoryPage {
+    /** The message the page ends before. */
+    before: string;
+    /** Oldest first. */
+    messages: LangChainMessage[];
+    /** Whether the transcript holds messages older than the page. */
+    moreBefore: boolean;
+    /** The page's summarized turns, by their first message's id. */
+    summarized?: ReadonlyMap<string, DeepAgentHistorySummarizedTurn>;
+}
+/** One `history/page` answer to `{turn, before, steps}`: a summarized turn's steps. */
+export interface DeepAgentTurnStepsPage {
+    turn: string;
+    /** Steps, oldest first. */
+    messages: LangChainMessage[];
+    /** Older steps of the turn remain. */
+    moreBefore: boolean;
+}
+/** What the store holds older than one message. */
+export interface DeepAgentHistoryOlder {
+    /** Ids, oldest first, ending right before the message asked about. */
+    ids: string[];
+    messages: LangChainMessage[];
+    /** Whether anything older than `ids[0]` (or the message itself) may exist. */
+    hasOlder: boolean;
+}
+/**
+ * The marker the join puts on a summarized turn's first reply message: the
+ * turn's steps not shown yet, so a renderer reads exact counts and knows
+ * whether opening it has steps to fetch ({@link loadDeepAgentTurnSteps}).
+ */
+export interface DeepAgentTurnStepsMarker {
+    /** The turn's first message: the id its steps are paged by. */
+    turn: string;
+    /** The conversation it belongs to (its history store). */
+    thread: string;
+    /** Steps not loaded yet. */
+    hiddenSteps: number;
+    /** Tool calls among them. */
+    hiddenTools: number;
+    /** Of which `task` delegations. */
+    hiddenDelegations: number;
+    /** The oldest step loaded; `undefined` while none is. */
+    before: string | undefined;
+}
+/** How the store asks the host: the thread's `sendCommand` (its answer, the command's payload). */
+export type DeepAgentHistorySend = (command: HistoryPageCommand | TurnStepsCommand) => unknown;
+export interface DeepAgentHistoryStore {
+    /**
+     * Whether the host refused `history/page` although its `protocol` lane
+     * advertises it (a host without the command): readers then read the live
+     * view alone and page by interest, until {@link markServed}.
+     */
+    readonly unserved: boolean;
+    /** The connection the refusal came on (`markUnserved`): a later one may land on a host that serves it. */
+    readonly unservedBy: unknown;
+    /** Bumped on every change readers can see (a page, steps, the unserved flag). */
+    readonly version: number;
+    markUnserved(connection?: unknown): void;
+    markServed(): void;
+    /**
+     * Record what a live chain shows: each entry's parent is the one before it,
+     * and with `startsTranscript` its first entry has none. Messages are kept by
+     * id (the newest form seen). Silent: a live chain changes nothing its own
+     * reader shows.
+     */
+    recordChain(ids: readonly string[], messages: ReadonlyMap<string, LangChainMessage>, startsTranscript: boolean): void;
+    /**
+     * Take in one page; notifies. `false` for an empty page that told nothing
+     * new. A page's messages are the transcript as the reader sees it: a
+     * summarized turn's answer follows its prompt, its steps left out.
+     */
+    addPage(page: DeepAgentHistoryPage): boolean;
+    /**
+     * Take in a summarized turn's older steps, spliced in where its page left
+     * them out; notifies. `false` for a turn the store does not hold.
+     */
+    addSteps(page: DeepAgentTurnStepsPage): boolean;
+    /** What a summarized turn's page left out, by the turn's first message id. */
+    turnSteps(turnId: string): DeepAgentHistoryTurnSteps | undefined;
+    /** Everything the store holds older than `id`, walking parents back. */
+    olderThan(id: string): DeepAgentHistoryOlder;
+    /** The host parent of `id`: `null` at the transcript's start, `undefined` while unknown. */
+    parentOf(id: string): string | null | undefined;
+    /**
+     * `messages` (a transcript as a reader shows it, oldest first) with each
+     * summarized turn's marker on its first reply message
+     * ({@link DEEP_AGENT_TURN_STEPS_KEY}); the same array when none applies.
+     */
+    markTurns(threadId: string, messages: LangChainMessage[]): LangChainMessage[];
+    /** Whether a steps request for the turn is in flight — the loader's dedupe. */
+    isLoadingSteps(turn: string): boolean;
+    /**
+     * Fetches a summarized turn's next older steps (`history/page` with its
+     * `turn`) into the store. A turn already loading, unknown, or with no steps
+     * left is a no-op. Rejects with the host's refusal, or when the answer is
+     * not a page this client reads.
+     */
+    loadSteps(options: {
+        send: DeepAgentHistorySend;
+        turn: string;
+        steps?: number;
+    }): Promise<void>;
+    subscribe(listener: () => void): () => void;
+}
+export declare function createDeepAgentHistoryStore(): DeepAgentHistoryStore;
+/** The conversation's history store, created on first use and marked most recently read. */
+export declare function deepAgentHistoryStore(threadId: string): DeepAgentHistoryStore;
+/** The conversation's store if the registry holds one, without creating or touching it. */
+export declare function peekDeepAgentHistoryStore(threadId: string): DeepAgentHistoryStore | undefined;
+/** Any store's visible change (a page, steps, the unserved flag): what a converter re-runs on. */
+export declare function subscribeDeepAgentHistory(listener: () => void): () => void;
+export declare function deepAgentHistoryVersion(): number;
+/** Drop every conversation's store (sign-out, an identity change, tests). */
+export declare function clearDeepAgentHistoryStores(): void;
+/**
+ * Fetch the next older steps of the summarized turn a marker names, into its
+ * conversation's store (the converter re-runs and shows them). A no-op when
+ * the store is gone (evicted, cleared) or the turn has no steps left.
+ */
+export declare function loadDeepAgentTurnSteps({ send, marker, steps, }: {
+    send: DeepAgentHistorySend;
+    marker: Pick<DeepAgentTurnStepsMarker, 'thread' | 'turn' | 'hiddenSteps'>;
+    steps?: number;
+}): Promise<void>;
+/** Whether a steps request for the marker's turn is in flight. */
+export declare function isLoadingDeepAgentTurnSteps(marker: Pick<DeepAgentTurnStepsMarker, 'thread' | 'turn'>): boolean;
+/** Whether the host's advertised contract version serves `history/page`. */
+export declare function hostServesHistoryPage(version: number | null | undefined): boolean;
+/**
+ * Whether a `history/page` failure says this host does not serve the
+ * command: statewire's `unknown-command`, a host without it although its
+ * `protocol` lane advertises it. Any other refusal (a vanished anchor, a
+ * malformed request, a host that cannot answer right now) is that page's
+ * failure, reported to the reader, who may ask again; it never takes the
+ * conversation off its store, whose history stays shown.
+ */
+export declare function isHistoryPageUnserved(error: unknown): boolean;
+/**
+ * Attach headers saying the client keeps older history itself
+ * (`x-athena-deep-agent-history: paged`): the host then holds its head down
+ * to its floor for at most `DEEP_AGENT_MAX_HELD_HEAD` messages, since what
+ * slides out stays in the store. Every attach of this build says so: every
+ * reader joins the store (`readDeepAgentMessageWindow`). An explicit entry
+ * wins.
+ */
+export declare function withDeclaredPagedHistory(headers: Record<string, string>): Record<string, string>;
+/**
+ * The windowed wire's page commands on the statewire command union, so
+ * `sendCommand({ type: 'history/page', … })` typechecks wherever the
+ * deep-agent host is driven (an attach-ACL read, like `history/lane`).
+ */
+declare module '@assistant-ui/core' {
+    namespace Assistant {
+        interface Commands {
+            /** One page of older transcript history. */
+            historyPage: HistoryPageCommand;
+            /** One summarized turn's steps. */
+            historyTurnSteps: TurnStepsCommand;
+        }
+    }
+}
+/**
+ * The turns `history/page` reads per page: about a screen and a half of
+ * conversation, however long each run was (a long turn rides as its prompt
+ * and answer, its steps counted).
+ */
+export declare const DEEP_AGENT_HISTORY_PAGE_TURNS = 10;
+/** The `history/page` command: up to `turns` whole turns ending before `before`. */
+export interface HistoryPageCommand {
+    readonly type: typeof DEEP_AGENT_HISTORY_PAGE_COMMAND;
+    readonly before: string;
+    readonly turns: number;
+}
+/** The `history/page` command asking for one summarized turn's steps older than `before`. */
+export interface TurnStepsCommand {
+    readonly type: typeof DEEP_AGENT_HISTORY_PAGE_COMMAND;
+    readonly turn: string;
+    readonly before?: string;
+    readonly steps: number;
+}
+export declare function buildHistoryPageCommand({ before, turns, }: {
+    before: string;
+    turns?: number;
+}): HistoryPageCommand;
+export declare function buildTurnStepsCommand({ turn, before, steps, }: {
+    turn: string;
+    before?: string | undefined;
+    steps?: number;
+}): TurnStepsCommand;
+/**
+ * A `history/page` answer to `{before, turns}` read as one page of messages:
+ * the turns' shown messages, oldest first (a summarized turn's prompt and
+ * answer, its steps left out and counted in `summarized`). `null` when
+ * malformed.
+ */
+export declare function readHistoryPageResult(payload: unknown, before: string): (DeepAgentHistoryPage & {
+    summarized: ReadonlyMap<string, DeepAgentHistorySummarizedTurn>;
+}) | null;
+/** A `history/page` answer to `{turn, before?, steps}`, or `null` when it is malformed. */
+export declare function readTurnStepsResult(payload: unknown): DeepAgentTurnStepsPage | null;
+/** The marker a join put on a source message, or `undefined`. */
+export declare function readTurnStepsMarker(message: unknown): DeepAgentTurnStepsMarker | undefined;
+/** The interest-request shape a page is reported as (telemetry parity with interest pages). */
+export declare function historyPageAsInterestRequest(command: HistoryPageCommand): {
+    ns: typeof DEEP_AGENT_MAIN_NS;
+    before: number;
+    at: string;
+};