@athenaintel/react 0.43.0 → 0.50.0

package/dist/agent-runtime/src/lane-history.cjs

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const store = require("@assistant-ui/store");
 const reactQuery = require("@tanstack/react-query");
-const react = require("react");
+const require$$0 = require("react");
 const runconfigContract = require("./generated/runconfig-contract.cjs");
 const messageWindow = require("./message-window.cjs");
 const protocol = require("./protocol.cjs");
@@ -138,11 +138,11 @@ function useDeepAgentLaneHistory({
     const extras = s.thread.extras;
     return ((_a2 = protocol.readDeepAgentProtocol(extras == null ? void 0 : extras.state)) == null ? void 0 : _a2.version) ?? 0;
   });
-  const sendRef = react.useRef(sendCommand);
+  const sendRef = require$$0.useRef(sendCommand);
   sendRef.current = sendCommand;
-  const [mount] = react.useState(nextMount);
-  const [asked, setAsked] = react.useState(false);
-  const target = react.useMemo(
+  const [mount] = require$$0.useState(nextMount);
+  const [asked, setAsked] = require$$0.useState(false);
+  const target = require$$0.useMemo(
     () => lane !== void 0 ? { lane } : messageId !== void 0 ? { messageId } : void 0,
     [lane, messageId]
   );
@@ -171,21 +171,21 @@ function useDeepAgentLaneHistory({
     refetchOnReconnect: false
   });
   const pages = (_a = query.data) == null ? void 0 : _a.pages;
-  const history = react.useMemo(() => {
+  const history = require$$0.useMemo(() => {
     var _a2, _b;
     if (pages === void 0 || pages.length === 0) return null;
     const entries = [...pages].reverse().flatMap((page) => page.steps);
     return { entries, whole: ((_a2 = pages[0]) == null ? void 0 : _a2.whole) === true, total: ((_b = pages[0]) == null ? void 0 : _b.total) ?? 0 };
   }, [pages]);
   const available = askable && !query.isError;
-  const steps = react.useMemo(
+  const steps = require$$0.useMemo(
     () => history === null ? carried : mergeLaneHistory({ history: history.entries, carried, whole: history.whole }),
     [history, carried]
   );
   const hasEarlier = available && (history === null ? checkpointed || steps.length < (total ?? 0) : query.hasNextPage);
   const loading = query.isFetching;
   const { fetchNextPage } = query;
-  const loadEarlier = react.useCallback(() => {
+  const loadEarlier = require$$0.useCallback(() => {
     if (!hasEarlier || loading) return;
     if (history === null) setAsked(true);
     else void fetchNextPage();

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

@@ -1 +1 @@
-{"version":3,"file":"lane-history.cjs","sources":["../../../../agent-runtime/src/lane-history.ts"],"sourcesContent":["/**\n * A card's whole nested transcript on demand — the client half of agora's\n * `history/lane` read command.\n *\n * A card's own document carries its nested transcript (a `task` subagent's\n * lane) cut to its newest entries whenever older ones are left off — a running\n * card always, and on a version-2 view a finished one too — counting the whole\n * stored transcript under `athena_lane_truncated`. `history/lane`\n * `{messageId, before, at?}` answers a page of it: the newest `before` entries,\n * or those strictly older than `at`, oldest first, each projected like a\n * followed lane step (every inline image a placeholder), with\n * `{more: {before}, total}`. {@link useDeepAgentLaneHistory} pages one card's\n * transcript for a surface that shows it whole, and {@link mergeLaneHistory}\n * reads the pages in under the card's own live entries.\n *\n * An in-eval dispatch's lane (`task()` inside `eval`) streams the same way on\n * its `ptc_subagents` registry entry: its newest steps, the marker counting the\n * lane, running or finished. `history/lane` `{lane, before, at?}` pages it by\n * the dispatch id (the registry key, never with `messageId`), and answers the\n * same page with `lane` set and `messageId` null. A lane whose steps no longer\n * ride pages the same way from its subagent checkpoint once agora recorded its\n * namespace (`ns`), `checkpointed`: a previous run's lane in this activation\n * (a later run left its registry entry only its summary and `ns`), or a\n * reopened session's (the registry died with the activation that streamed it,\n * and the summary its eval persisted records `ns`). It carries no steps, and\n * the first page names the total.\n *\n * Only a cut card or lane is paged. A finished card is cut only by a host that\n * serves `history/lane`, so it is always asked, and so is a cut in-eval lane\n * (a client that never sends `lane` needs no gate); a running card is asked\n * only when the host's `protocol` lane advertises\n * `DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION`. A card whose entries carry no ids\n * cannot be paged: the host says to read the card whole with\n * `history/message`, and that one read stands for the lane. Any other refusal\n * (an older pod answers `history/lane` as an unknown command, or wants a\n * `messageId`; a lane with no recorded checkpoint) leaves the surface on the\n * entries it carries: no error, and that mount never asks again.\n *\n * Surfaces opt in. A surface that pages nothing ships none of this.\n */\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { type InfiniteData, useInfiniteQuery } from '@tanstack/react-query';\nimport { useCallback, useMemo, useRef, useState } from 'react';\nimport {\n  DEEP_AGENT_HISTORY_LANE_COMMAND,\n  DEEP_AGENT_HISTORY_MESSAGE_COMMAND,\n  DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION,\n  DEEP_AGENT_MAX_LANE_PAGE,\n} from './generated/runconfig-contract';\nimport { buildHistoryMessageCommand, readHistoryMessageResult } from './message-window';\nimport { readDeepAgentProtocol } from './protocol';\nimport { nestedMessagesFromArtifact } from './subagents';\nimport { hasStatewireThreadExtras } from './thread-extras';\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 entryId = (entry: unknown): string | undefined => {\n  const id = isRecord(entry) ? entry.id : undefined;\n  return typeof id === 'string' ? id : undefined;\n};\n\n/**\n * The `history/lane` read command on the statewire command union, so\n * `sendCommand({ type: 'history/lane', … })` typechecks wherever the deep-agent\n * host is driven (an attach-ACL read, like `history/message`).\n */\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** A page of one card's nested transcript. */\n      historyLane: HistoryLaneCommand;\n    }\n  }\n}\n\n/**\n * What one `history/lane` read pages: a card's nested transcript, by the card's\n * message id (a finished card or a running placeholder), or an in-eval\n * dispatch's lane, by its dispatch id.\n */\nexport type DeepAgentLaneTarget =\n  | { readonly messageId: string; readonly lane?: undefined }\n  | { readonly lane: string; readonly messageId?: undefined };\n\n/** The `history/lane` command: a page of one card's or lane's steps, oldest first. */\nexport type HistoryLaneCommand = {\n  readonly type: typeof DEEP_AGENT_HISTORY_LANE_COMMAND;\n  /** Entries in the page (`1..DEEP_AGENT_MAX_LANE_PAGE`). */\n  readonly before: number;\n  /** An entry id: the page holds the entries strictly older than it. Without it, the newest. */\n  readonly at?: string;\n} & ({ readonly messageId: string } | { readonly lane: string });\n\nexport function buildHistoryLaneCommand({\n  target,\n  at,\n}: {\n  target: DeepAgentLaneTarget;\n  at?: string | undefined;\n}): HistoryLaneCommand {\n  return {\n    type: DEEP_AGENT_HISTORY_LANE_COMMAND,\n    ...(target.lane !== undefined ? { lane: target.lane } : { messageId: target.messageId }),\n    before: DEEP_AGENT_MAX_LANE_PAGE,\n    ...(at !== undefined && { at }),\n  };\n}\n\n/** One page `history/lane` answered. */\nexport interface HistoryLanePage {\n  /** The card it pages; `null` for a lane. */\n  readonly messageId: string | null;\n  /** The in-eval lane it pages; `null` for a card (a host that predates lanes leaves it out). */\n  readonly lane: string | null;\n  /** The page's entries, oldest first; an entry without a string id is never in one. */\n  readonly steps: readonly LangChainMessage[];\n  /** Whether entries older than the page remain. */\n  readonly hasEarlier: boolean;\n  /** Entries the card's transcript, or the lane's checkpoint, stores. */\n  readonly total: number;\n}\n\nconst nonEmpty = (value: unknown): string | null =>\n  typeof value === 'string' && value ? value : null;\n\nexport function readHistoryLanePage(payload: unknown): HistoryLanePage | null {\n  if (!isRecord(payload)) return null;\n  const { steps, more, total } = payload;\n  const messageId = nonEmpty(payload.messageId);\n  const lane = nonEmpty(payload.lane);\n  if ((messageId === null) === (lane === null) || !Array.isArray(steps)) return null;\n  if (!isRecord(more) || typeof more.before !== 'boolean' || !isCount(total)) return null;\n  return {\n    messageId,\n    lane,\n    steps: steps.filter((step): step is LangChainMessage => entryId(step) !== undefined),\n    hasEarlier: more.before,\n    total,\n  };\n}\n\n/** Whether a page answers a read of `target`. */\nconst answers = (page: HistoryLanePage, target: DeepAgentLaneTarget): boolean =>\n  target.lane !== undefined ? page.lane === target.lane : page.messageId === target.messageId;\n\n/**\n * Whether `history/lane` was refused because the lane's entries carry no ids\n * to page by: the host names `history/message` as the way to read the card.\n */\nexport function isWholeCardRefusal(error: unknown): boolean {\n  const failure = isRecord(error) ? error.failure : undefined;\n  return (\n    isRecord(failure) &&\n    failure.fate === 'rejected' &&\n    typeof failure.message === 'string' &&\n    failure.message.includes(DEEP_AGENT_HISTORY_MESSAGE_COMMAND)\n  );\n}\n\n/** The tool calls an assistant entry makes. */\nconst callCount = (entry: LangChainMessage): number =>\n  entry.type === 'ai' ? (entry.tool_calls?.length ?? 0) : 0;\n\n/**\n * A card's transcript with its paged history read in: the history (whole,\n * oldest first), then the card's own entries newer than the last one the\n * history holds — what the lane did since the history was read. The card's\n * entries older than that one and not in the history yet (a page cut short by\n * its size, or a turn the card keeps for a result it holds) come first, so the\n * view never shows less than the card. An entry the card also carries is the\n * card's copy, which is the newer one: a page is a snapshot, which can catch a\n * step mid-stream, and leaves every inline image a placeholder. The exception\n * is a turn the card keeps cut to the calls it holds results for, which\n * carries fewer calls than the page's copy. Without history, the card's own\n * entries. `whole` history is the card's entire transcript as it was read;\n * when none of its entries can be matched to the card's (they carry no ids),\n * it stands alone.\n */\nexport function mergeLaneHistory({\n  history,\n  carried,\n  whole = false,\n}: {\n  history: readonly LangChainMessage[];\n  carried: readonly LangChainMessage[];\n  whole?: boolean;\n}): readonly LangChainMessage[] {\n  if (history.length === 0) return carried;\n  const held = new Set<string>();\n  for (const entry of history) {\n    const id = entryId(entry);\n    if (id !== undefined) held.add(id);\n  }\n  let anchor = -1;\n  for (let index = carried.length - 1; index >= 0; index -= 1) {\n    const id = entryId(carried[index]);\n    if (id !== undefined && held.has(id)) {\n      anchor = index;\n      break;\n    }\n  }\n  if (anchor < 0) return whole ? history : [...history, ...carried];\n  const own = new Map<string, LangChainMessage>();\n  for (const entry of carried) {\n    const id = entryId(entry);\n    if (id !== undefined) own.set(id, entry);\n  }\n  const read = history.map((entry) => {\n    const id = entryId(entry);\n    const mine = id === undefined ? undefined : own.get(id);\n    return mine !== undefined && callCount(mine) >= callCount(entry) ? mine : entry;\n  });\n  const older = carried.slice(0, anchor).filter((entry) => {\n    const id = entryId(entry);\n    return id !== undefined && !held.has(id);\n  });\n  return [...older, ...read, ...carried.slice(anchor + 1)];\n}\n\n/** What a surface shows of one card's or lane's steps. */\nexport interface DeepAgentLaneHistoryState {\n  /** The steps with the history read so far; the steps it carries before any. */\n  readonly steps: readonly LangChainMessage[];\n  /** Entries the transcript stores, when it is cut (a checkpointed lane's, once a page counted them). */\n  readonly total: number | undefined;\n  /** The host answers `history/lane` for this card or lane, and has not refused it. */\n  readonly available: boolean;\n  /** Entries older than the ones read remain, and can be asked for. */\n  readonly hasEarlier: boolean;\n  readonly loading: boolean;\n  /** Read the page before the earliest entry read so far (the newest page first). */\n  readonly loadEarlier: () => void;\n}\n\n/** One `history/lane` page as the pager holds it. */\ninterface LanePageData {\n  /** The page's entries, oldest first. */\n  readonly steps: readonly LangChainMessage[];\n  readonly hasEarlier: boolean;\n  readonly total: number;\n  /** The card's whole transcript, read with `history/message`. */\n  readonly whole: boolean;\n}\n\n/** One key per card or lane, so a card and a lane never share history or a refusal. */\nconst laneTargetKey = (target: DeepAgentLaneTarget): string =>\n  target.lane !== undefined ? `lane:${target.lane}` : `card:${target.messageId}`;\n\n/**\n * The query key one card's or lane's pages are cached under. A finished card or\n * lane never changes, so its pages are kept while it is cached; a running one\n * is read afresh by each surface that mounts it (`mount`), since an old page of\n * a lane that kept running could leave a gap before the steps it carries now.\n */\nexport const deepAgentLaneHistoryQueryKey = ({\n  target,\n  mount,\n}: {\n  target: string;\n  mount?: number | undefined;\n}) => ['athena-deep-agent', 'history-lane', target, ...(mount === undefined ? [] : [mount])];\n\nlet mountCount = 0;\nconst nextMount = (): number => {\n  mountCount += 1;\n  return mountCount;\n};\n\ntype SendCommand = StatewireThread.Extras['sendCommand'];\n\n/** One page of `target`: `history/lane`, or the card whole when its entries carry no ids. */\nasync function readLanePage({\n  sendCommand,\n  target,\n  at,\n}: {\n  sendCommand: SendCommand;\n  target: DeepAgentLaneTarget;\n  at: string | undefined;\n}): Promise<LanePageData> {\n  try {\n    const page = readHistoryLanePage(await sendCommand(buildHistoryLaneCommand({ target, at })));\n    if (page === null || !answers(page, target)) {\n      throw new Error('history/lane answered another card or lane');\n    }\n    return { steps: page.steps, hasEarlier: page.hasEarlier, total: page.total, whole: false };\n  } catch (error) {\n    if (target.messageId === undefined || !isWholeCardRefusal(error)) throw error;\n    const result = readHistoryMessageResult(\n      await sendCommand(buildHistoryMessageCommand({ messageId: target.messageId }))\n    );\n    if (result === null || result.messageId !== target.messageId) {\n      throw new Error('history/message answered another message');\n    }\n    const card: unknown = result.message;\n    const steps = nestedMessagesFromArtifact(isRecord(card) ? card.artifact : undefined);\n    return { steps, hasEarlier: false, total: steps.length, whole: true };\n  }\n}\n\n/**\n * Pages one card's transcript, or one in-eval lane, through `history/lane` for\n * a surface that shows it whole, as a TanStack infinite query. `auto` reads\n * the newest page as soon as it is cut (an open transcript drawer); otherwise\n * nothing is read until `loadEarlier`. A card whose message id changes (its\n * result replaced the running placeholder) is a new query. A refusal is the\n * query's error: never retried or refetched, so it costs one command, and the\n * surface stays on the steps it carries with no error.\n */\nexport function useDeepAgentLaneHistory({\n  messageId,\n  lane,\n  carried,\n  total,\n  finished = false,\n  checkpointed = false,\n  auto = false,\n}: {\n  /** The card's message id, for a `task` lane. */\n  messageId?: string | undefined;\n  /** The dispatch id, for an in-eval lane; wins over `messageId`. Neither: nothing to page. */\n  lane?: string | undefined;\n  /** The steps the card or the lane's registry entry carries. */\n  carried: readonly LangChainMessage[];\n  /** The cut marker's `messages`; `undefined` while every step rides. */\n  total: number | undefined;\n  /** The cut marker says the lane finished (only a host serving `history/lane` cuts a card then). */\n  finished?: boolean;\n  /**\n   * No steps ride: an in-eval lane a later run or a reopen left only its\n   * summary and namespace. It carries no steps and no marker, `history/lane`\n   * pages its subagent's own steps from its checkpoint, and the first page\n   * names their total.\n   */\n  checkpointed?: boolean;\n  auto?: boolean;\n}): DeepAgentLaneHistoryState {\n  const sendCommand = useAuiState((s) =>\n    hasStatewireThreadExtras(s.thread.extras)\n      ? (s.thread.extras as StatewireThread.Extras).sendCommand\n      : undefined\n  );\n  const hostVersion = useAuiState((s) => {\n    const extras = s.thread.extras as Partial<StatewireThread.Extras> | undefined;\n    return readDeepAgentProtocol(extras?.state)?.version ?? 0;\n  });\n  const sendRef = useRef(sendCommand);\n  sendRef.current = sendCommand;\n  const [mount] = useState(nextMount);\n  const [asked, setAsked] = useState(false);\n\n  const target = useMemo<DeepAgentLaneTarget | undefined>(\n    () =>\n      lane !== undefined ? { lane } : messageId !== undefined ? { messageId } : undefined,\n    [lane, messageId]\n  );\n  // A checkpointed lane's steps were left off once its run had ended.\n  const settled = finished || checkpointed;\n  const askable =\n    (total !== undefined || checkpointed) &&\n    target !== undefined &&\n    sendCommand !== undefined &&\n    (target.lane !== undefined || settled || hostVersion >= DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION);\n\n  const query = useInfiniteQuery<\n    LanePageData,\n    Error,\n    InfiniteData<LanePageData, string | undefined>,\n    readonly unknown[],\n    string | undefined\n  >({\n    queryKey: deepAgentLaneHistoryQueryKey({\n      target: target === undefined ? '' : laneTargetKey(target),\n      mount: settled ? undefined : mount,\n    }),\n    queryFn: ({ pageParam }) => {\n      const send = sendRef.current;\n      if (target === undefined || send === undefined) {\n        return Promise.reject(new Error('no statewire thread to read the lane from'));\n      }\n      return readLanePage({ sendCommand: send, target, at: pageParam });\n    },\n    initialPageParam: undefined,\n    getNextPageParam: (last) => (last.hasEarlier ? entryId(last.steps[0]) : undefined),\n    enabled: askable && (auto || asked),\n    retry: false,\n    retryOnMount: false,\n    staleTime: Number.POSITIVE_INFINITY,\n    refetchOnMount: false,\n    refetchOnWindowFocus: false,\n    refetchOnReconnect: false,\n  });\n\n  const pages = query.data?.pages;\n  const history = useMemo(() => {\n    if (pages === undefined || pages.length === 0) return null;\n    // Pages arrive newest first; each is strictly older than the one before.\n    const entries = [...pages].reverse().flatMap((page) => page.steps);\n    return { entries, whole: pages[0]?.whole === true, total: pages[0]?.total ?? 0 };\n  }, [pages]);\n  const available = askable && !query.isError;\n  const steps = useMemo(\n    () =>\n      history === null\n        ? carried\n        : mergeLaneHistory({ history: history.entries, carried, whole: history.whole }),\n    [history, carried]\n  );\n  // Before its first page, a checkpointed lane has every step still to read.\n  const hasEarlier =\n    available &&\n    (history === null ? checkpointed || steps.length < (total ?? 0) : query.hasNextPage);\n  const loading = query.isFetching;\n  const { fetchNextPage } = query;\n  const loadEarlier = useCallback(() => {\n    if (!hasEarlier || loading) return;\n    if (history === null) setAsked(true);\n    else void fetchNextPage();\n  }, [fetchNextPage, hasEarlier, history, loading]);\n\n  return {\n    steps,\n    // A lane read without a marker (a checkpointed one) counts what its pages say.\n    total: total === undefined ? history?.total : Math.max(total, history?.total ?? 0),\n    available,\n    hasEarlier,\n    loading,\n    loadEarlier,\n  };\n}\n"],"names":["DEEP_AGENT_HISTORY_LANE_COMMAND","DEEP_AGENT_MAX_LANE_PAGE","DEEP_AGENT_HISTORY_MESSAGE_COMMAND","readHistoryMessageResult","buildHistoryMessageCommand","nestedMessagesFromArtifact","useAuiState","hasStatewireThreadExtras","readDeepAgentProtocol","useRef","useState","useMemo","DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION","useInfiniteQuery","_a","useCallback"],"mappings":"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"}
+{"version":3,"file":"lane-history.cjs","sources":["../../../../agent-runtime/src/lane-history.ts"],"sourcesContent":["/**\n * A card's whole nested transcript on demand — the client half of agora's\n * `history/lane` read command.\n *\n * A card's own document carries its nested transcript (a `task` subagent's\n * lane) cut to its newest entries whenever older ones are left off — a running\n * card always, and on a version-2 view a finished one too — counting the whole\n * stored transcript under `athena_lane_truncated`. `history/lane`\n * `{messageId, before, at?}` answers a page of it: the newest `before` entries,\n * or those strictly older than `at`, oldest first, each projected like a\n * followed lane step (every inline image a placeholder), with\n * `{more: {before}, total}`. {@link useDeepAgentLaneHistory} pages one card's\n * transcript for a surface that shows it whole, and {@link mergeLaneHistory}\n * reads the pages in under the card's own live entries.\n *\n * An in-eval dispatch's lane (`task()` inside `eval`) streams the same way on\n * its `ptc_subagents` registry entry: its newest steps, the marker counting the\n * lane, running or finished. `history/lane` `{lane, before, at?}` pages it by\n * the dispatch id (the registry key, never with `messageId`), and answers the\n * same page with `lane` set and `messageId` null. A lane whose steps no longer\n * ride pages the same way from its subagent checkpoint once agora recorded its\n * namespace (`ns`), `checkpointed`: a previous run's lane in this activation\n * (a later run left its registry entry only its summary and `ns`), or a\n * reopened session's (the registry died with the activation that streamed it,\n * and the summary its eval persisted records `ns`). It carries no steps, and\n * the first page names the total.\n *\n * Only a cut card or lane is paged. A finished card is cut only by a host that\n * serves `history/lane`, so it is always asked, and so is a cut in-eval lane\n * (a client that never sends `lane` needs no gate); a running card is asked\n * only when the host's `protocol` lane advertises\n * `DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION`. A card whose entries carry no ids\n * cannot be paged: the host says to read the card whole with\n * `history/message`, and that one read stands for the lane. Any other refusal\n * (an older pod answers `history/lane` as an unknown command, or wants a\n * `messageId`; a lane with no recorded checkpoint) leaves the surface on the\n * entries it carries: no error, and that mount never asks again.\n *\n * Surfaces opt in. A surface that pages nothing ships none of this.\n */\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { type InfiniteData, useInfiniteQuery } from '@tanstack/react-query';\nimport { useCallback, useMemo, useRef, useState } from 'react';\nimport {\n  DEEP_AGENT_HISTORY_LANE_COMMAND,\n  DEEP_AGENT_HISTORY_MESSAGE_COMMAND,\n  DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION,\n  DEEP_AGENT_MAX_LANE_PAGE,\n} from './generated/runconfig-contract';\nimport { buildHistoryMessageCommand, readHistoryMessageResult } from './message-window';\nimport { readDeepAgentProtocol } from './protocol';\nimport { nestedMessagesFromArtifact } from './subagents';\nimport { hasStatewireThreadExtras } from './thread-extras';\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 entryId = (entry: unknown): string | undefined => {\n  const id = isRecord(entry) ? entry.id : undefined;\n  return typeof id === 'string' ? id : undefined;\n};\n\n/**\n * The `history/lane` read command on the statewire command union, so\n * `sendCommand({ type: 'history/lane', … })` typechecks wherever the deep-agent\n * host is driven (an attach-ACL read, like `history/message`).\n */\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** A page of one card's nested transcript. */\n      historyLane: HistoryLaneCommand;\n    }\n  }\n}\n\n/**\n * What one `history/lane` read pages: a card's nested transcript, by the card's\n * message id (a finished card or a running placeholder), or an in-eval\n * dispatch's lane, by its dispatch id.\n */\nexport type DeepAgentLaneTarget =\n  | { readonly messageId: string; readonly lane?: undefined }\n  | { readonly lane: string; readonly messageId?: undefined };\n\n/** The `history/lane` command: a page of one card's or lane's steps, oldest first. */\nexport type HistoryLaneCommand = {\n  readonly type: typeof DEEP_AGENT_HISTORY_LANE_COMMAND;\n  /** Entries in the page (`1..DEEP_AGENT_MAX_LANE_PAGE`). */\n  readonly before: number;\n  /** An entry id: the page holds the entries strictly older than it. Without it, the newest. */\n  readonly at?: string;\n} & ({ readonly messageId: string } | { readonly lane: string });\n\nexport function buildHistoryLaneCommand({\n  target,\n  at,\n}: {\n  target: DeepAgentLaneTarget;\n  at?: string | undefined;\n}): HistoryLaneCommand {\n  return {\n    type: DEEP_AGENT_HISTORY_LANE_COMMAND,\n    ...(target.lane !== undefined ? { lane: target.lane } : { messageId: target.messageId }),\n    before: DEEP_AGENT_MAX_LANE_PAGE,\n    ...(at !== undefined && { at }),\n  };\n}\n\n/** One page `history/lane` answered. */\nexport interface HistoryLanePage {\n  /** The card it pages; `null` for a lane. */\n  readonly messageId: string | null;\n  /** The in-eval lane it pages; `null` for a card (a host that predates lanes leaves it out). */\n  readonly lane: string | null;\n  /** The page's entries, oldest first; an entry without a string id is never in one. */\n  readonly steps: readonly LangChainMessage[];\n  /** Whether entries older than the page remain. */\n  readonly hasEarlier: boolean;\n  /** Entries the card's transcript, or the lane's checkpoint, stores. */\n  readonly total: number;\n}\n\nconst nonEmpty = (value: unknown): string | null =>\n  typeof value === 'string' && value ? value : null;\n\nexport function readHistoryLanePage(payload: unknown): HistoryLanePage | null {\n  if (!isRecord(payload)) return null;\n  const { steps, more, total } = payload;\n  const messageId = nonEmpty(payload.messageId);\n  const lane = nonEmpty(payload.lane);\n  if ((messageId === null) === (lane === null) || !Array.isArray(steps)) return null;\n  if (!isRecord(more) || typeof more.before !== 'boolean' || !isCount(total)) return null;\n  return {\n    messageId,\n    lane,\n    steps: steps.filter((step): step is LangChainMessage => entryId(step) !== undefined),\n    hasEarlier: more.before,\n    total,\n  };\n}\n\n/** Whether a page answers a read of `target`. */\nconst answers = (page: HistoryLanePage, target: DeepAgentLaneTarget): boolean =>\n  target.lane !== undefined ? page.lane === target.lane : page.messageId === target.messageId;\n\n/**\n * Whether `history/lane` was refused because the lane's entries carry no ids\n * to page by: the host names `history/message` as the way to read the card.\n */\nexport function isWholeCardRefusal(error: unknown): boolean {\n  const failure = isRecord(error) ? error.failure : undefined;\n  return (\n    isRecord(failure) &&\n    failure.fate === 'rejected' &&\n    typeof failure.message === 'string' &&\n    failure.message.includes(DEEP_AGENT_HISTORY_MESSAGE_COMMAND)\n  );\n}\n\n/** The tool calls an assistant entry makes. */\nconst callCount = (entry: LangChainMessage): number =>\n  entry.type === 'ai' ? (entry.tool_calls?.length ?? 0) : 0;\n\n/**\n * A card's transcript with its paged history read in: the history (whole,\n * oldest first), then the card's own entries newer than the last one the\n * history holds — what the lane did since the history was read. The card's\n * entries older than that one and not in the history yet (a page cut short by\n * its size, or a turn the card keeps for a result it holds) come first, so the\n * view never shows less than the card. An entry the card also carries is the\n * card's copy, which is the newer one: a page is a snapshot, which can catch a\n * step mid-stream, and leaves every inline image a placeholder. The exception\n * is a turn the card keeps cut to the calls it holds results for, which\n * carries fewer calls than the page's copy. Without history, the card's own\n * entries. `whole` history is the card's entire transcript as it was read;\n * when none of its entries can be matched to the card's (they carry no ids),\n * it stands alone.\n */\nexport function mergeLaneHistory({\n  history,\n  carried,\n  whole = false,\n}: {\n  history: readonly LangChainMessage[];\n  carried: readonly LangChainMessage[];\n  whole?: boolean;\n}): readonly LangChainMessage[] {\n  if (history.length === 0) return carried;\n  const held = new Set<string>();\n  for (const entry of history) {\n    const id = entryId(entry);\n    if (id !== undefined) held.add(id);\n  }\n  let anchor = -1;\n  for (let index = carried.length - 1; index >= 0; index -= 1) {\n    const id = entryId(carried[index]);\n    if (id !== undefined && held.has(id)) {\n      anchor = index;\n      break;\n    }\n  }\n  if (anchor < 0) return whole ? history : [...history, ...carried];\n  const own = new Map<string, LangChainMessage>();\n  for (const entry of carried) {\n    const id = entryId(entry);\n    if (id !== undefined) own.set(id, entry);\n  }\n  const read = history.map((entry) => {\n    const id = entryId(entry);\n    const mine = id === undefined ? undefined : own.get(id);\n    return mine !== undefined && callCount(mine) >= callCount(entry) ? mine : entry;\n  });\n  const older = carried.slice(0, anchor).filter((entry) => {\n    const id = entryId(entry);\n    return id !== undefined && !held.has(id);\n  });\n  return [...older, ...read, ...carried.slice(anchor + 1)];\n}\n\n/** What a surface shows of one card's or lane's steps. */\nexport interface DeepAgentLaneHistoryState {\n  /** The steps with the history read so far; the steps it carries before any. */\n  readonly steps: readonly LangChainMessage[];\n  /** Entries the transcript stores, when it is cut (a checkpointed lane's, once a page counted them). */\n  readonly total: number | undefined;\n  /** The host answers `history/lane` for this card or lane, and has not refused it. */\n  readonly available: boolean;\n  /** Entries older than the ones read remain, and can be asked for. */\n  readonly hasEarlier: boolean;\n  readonly loading: boolean;\n  /** Read the page before the earliest entry read so far (the newest page first). */\n  readonly loadEarlier: () => void;\n}\n\n/** One `history/lane` page as the pager holds it. */\ninterface LanePageData {\n  /** The page's entries, oldest first. */\n  readonly steps: readonly LangChainMessage[];\n  readonly hasEarlier: boolean;\n  readonly total: number;\n  /** The card's whole transcript, read with `history/message`. */\n  readonly whole: boolean;\n}\n\n/** One key per card or lane, so a card and a lane never share history or a refusal. */\nconst laneTargetKey = (target: DeepAgentLaneTarget): string =>\n  target.lane !== undefined ? `lane:${target.lane}` : `card:${target.messageId}`;\n\n/**\n * The query key one card's or lane's pages are cached under. A finished card or\n * lane never changes, so its pages are kept while it is cached; a running one\n * is read afresh by each surface that mounts it (`mount`), since an old page of\n * a lane that kept running could leave a gap before the steps it carries now.\n */\nexport const deepAgentLaneHistoryQueryKey = ({\n  target,\n  mount,\n}: {\n  target: string;\n  mount?: number | undefined;\n}) => ['athena-deep-agent', 'history-lane', target, ...(mount === undefined ? [] : [mount])];\n\nlet mountCount = 0;\nconst nextMount = (): number => {\n  mountCount += 1;\n  return mountCount;\n};\n\ntype SendCommand = StatewireThread.Extras['sendCommand'];\n\n/** One page of `target`: `history/lane`, or the card whole when its entries carry no ids. */\nasync function readLanePage({\n  sendCommand,\n  target,\n  at,\n}: {\n  sendCommand: SendCommand;\n  target: DeepAgentLaneTarget;\n  at: string | undefined;\n}): Promise<LanePageData> {\n  try {\n    const page = readHistoryLanePage(await sendCommand(buildHistoryLaneCommand({ target, at })));\n    if (page === null || !answers(page, target)) {\n      throw new Error('history/lane answered another card or lane');\n    }\n    return { steps: page.steps, hasEarlier: page.hasEarlier, total: page.total, whole: false };\n  } catch (error) {\n    if (target.messageId === undefined || !isWholeCardRefusal(error)) throw error;\n    const result = readHistoryMessageResult(\n      await sendCommand(buildHistoryMessageCommand({ messageId: target.messageId }))\n    );\n    if (result === null || result.messageId !== target.messageId) {\n      throw new Error('history/message answered another message');\n    }\n    const card: unknown = result.message;\n    const steps = nestedMessagesFromArtifact(isRecord(card) ? card.artifact : undefined);\n    return { steps, hasEarlier: false, total: steps.length, whole: true };\n  }\n}\n\n/**\n * Pages one card's transcript, or one in-eval lane, through `history/lane` for\n * a surface that shows it whole, as a TanStack infinite query. `auto` reads\n * the newest page as soon as it is cut (an open transcript drawer); otherwise\n * nothing is read until `loadEarlier`. A card whose message id changes (its\n * result replaced the running placeholder) is a new query. A refusal is the\n * query's error: never retried or refetched, so it costs one command, and the\n * surface stays on the steps it carries with no error.\n */\nexport function useDeepAgentLaneHistory({\n  messageId,\n  lane,\n  carried,\n  total,\n  finished = false,\n  checkpointed = false,\n  auto = false,\n}: {\n  /** The card's message id, for a `task` lane. */\n  messageId?: string | undefined;\n  /** The dispatch id, for an in-eval lane; wins over `messageId`. Neither: nothing to page. */\n  lane?: string | undefined;\n  /** The steps the card or the lane's registry entry carries. */\n  carried: readonly LangChainMessage[];\n  /** The cut marker's `messages`; `undefined` while every step rides. */\n  total: number | undefined;\n  /** The cut marker says the lane finished (only a host serving `history/lane` cuts a card then). */\n  finished?: boolean;\n  /**\n   * No steps ride: an in-eval lane a later run or a reopen left only its\n   * summary and namespace. It carries no steps and no marker, `history/lane`\n   * pages its subagent's own steps from its checkpoint, and the first page\n   * names their total.\n   */\n  checkpointed?: boolean;\n  auto?: boolean;\n}): DeepAgentLaneHistoryState {\n  const sendCommand = useAuiState((s) =>\n    hasStatewireThreadExtras(s.thread.extras)\n      ? (s.thread.extras as StatewireThread.Extras).sendCommand\n      : undefined\n  );\n  const hostVersion = useAuiState((s) => {\n    const extras = s.thread.extras as Partial<StatewireThread.Extras> | undefined;\n    return readDeepAgentProtocol(extras?.state)?.version ?? 0;\n  });\n  const sendRef = useRef(sendCommand);\n  sendRef.current = sendCommand;\n  const [mount] = useState(nextMount);\n  const [asked, setAsked] = useState(false);\n\n  const target = useMemo<DeepAgentLaneTarget | undefined>(\n    () =>\n      lane !== undefined ? { lane } : messageId !== undefined ? { messageId } : undefined,\n    [lane, messageId]\n  );\n  // A checkpointed lane's steps were left off once its run had ended.\n  const settled = finished || checkpointed;\n  const askable =\n    (total !== undefined || checkpointed) &&\n    target !== undefined &&\n    sendCommand !== undefined &&\n    (target.lane !== undefined || settled || hostVersion >= DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION);\n\n  const query = useInfiniteQuery<\n    LanePageData,\n    Error,\n    InfiniteData<LanePageData, string | undefined>,\n    readonly unknown[],\n    string | undefined\n  >({\n    queryKey: deepAgentLaneHistoryQueryKey({\n      target: target === undefined ? '' : laneTargetKey(target),\n      mount: settled ? undefined : mount,\n    }),\n    queryFn: ({ pageParam }) => {\n      const send = sendRef.current;\n      if (target === undefined || send === undefined) {\n        return Promise.reject(new Error('no statewire thread to read the lane from'));\n      }\n      return readLanePage({ sendCommand: send, target, at: pageParam });\n    },\n    initialPageParam: undefined,\n    getNextPageParam: (last) => (last.hasEarlier ? entryId(last.steps[0]) : undefined),\n    enabled: askable && (auto || asked),\n    retry: false,\n    retryOnMount: false,\n    staleTime: Number.POSITIVE_INFINITY,\n    refetchOnMount: false,\n    refetchOnWindowFocus: false,\n    refetchOnReconnect: false,\n  });\n\n  const pages = query.data?.pages;\n  const history = useMemo(() => {\n    if (pages === undefined || pages.length === 0) return null;\n    // Pages arrive newest first; each is strictly older than the one before.\n    const entries = [...pages].reverse().flatMap((page) => page.steps);\n    return { entries, whole: pages[0]?.whole === true, total: pages[0]?.total ?? 0 };\n  }, [pages]);\n  const available = askable && !query.isError;\n  const steps = useMemo(\n    () =>\n      history === null\n        ? carried\n        : mergeLaneHistory({ history: history.entries, carried, whole: history.whole }),\n    [history, carried]\n  );\n  // Before its first page, a checkpointed lane has every step still to read.\n  const hasEarlier =\n    available &&\n    (history === null ? checkpointed || steps.length < (total ?? 0) : query.hasNextPage);\n  const loading = query.isFetching;\n  const { fetchNextPage } = query;\n  const loadEarlier = useCallback(() => {\n    if (!hasEarlier || loading) return;\n    if (history === null) setAsked(true);\n    else void fetchNextPage();\n  }, [fetchNextPage, hasEarlier, history, loading]);\n\n  return {\n    steps,\n    // A lane read without a marker (a checkpointed one) counts what its pages say.\n    total: total === undefined ? history?.total : Math.max(total, history?.total ?? 0),\n    available,\n    hasEarlier,\n    loading,\n    loadEarlier,\n  };\n}\n"],"names":["DEEP_AGENT_HISTORY_LANE_COMMAND","DEEP_AGENT_MAX_LANE_PAGE","DEEP_AGENT_HISTORY_MESSAGE_COMMAND","readHistoryMessageResult","buildHistoryMessageCommand","nestedMessagesFromArtifact","useAuiState","hasStatewireThreadExtras","readDeepAgentProtocol","useRef","useState","useMemo","DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION","useInfiniteQuery","_a","useCallback"],"mappings":"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"}

package/dist/agent-runtime/src/messages.cjs

@@ -13,6 +13,7 @@ const runconfigContract = require("./generated/runconfig-contract.cjs");
 const messageWindow = require("./message-window.cjs");
 const optimisticContent = require("./optimistic-content.cjs");
 const runningToolPlaceholder = require("./running-tool-placeholder.cjs");
+const answerRows = require("./answer-rows.cjs");
 const statewireState = require("./statewire-state.cjs");
 const toolNames = require("./tool-names.cjs");
 const voiceTurnGrouping = require("./voice-turn-grouping.cjs");
@@ -70,13 +71,15 @@ const convertDeepAgentLangChainMessage = (message, metadata) => {
   }
   const usage = nativeStepUsage(message);
   const timing = nativeTurnTiming(message);
-  if (usage === void 0 && timing === void 0) return converted;
+  const runId = answerRows.readAnswerRowKey(message);
+  if (usage === void 0 && timing === void 0 && runId === void 0) return converted;
   return {
     ...converted,
     metadata: {
       ...converted.metadata,
       ...usage !== void 0 && { steps: [{ messageId: message.id, usage }] },
-      ...timing !== void 0 && { timing }
+      ...timing !== void 0 && { timing },
+      ...runId !== void 0 && { runId }
     }
   };
 };
@@ -493,6 +496,30 @@ function liftConversationStatsIntoMetadata(message) {
     }
   };
 }
+const PLACE_INSTRUCTIONS_STAMP_KEY = "athena_place_instructions";
+function liftPlaceInstructionsIntoMetadata(message) {
+  if (message.type !== "ai") return message;
+  const kwargs = message.additional_kwargs;
+  const stamp = kwargs == null ? void 0 : kwargs[PLACE_INSTRUCTIONS_STAMP_KEY];
+  const existingMetadata = kwargs == null ? void 0 : kwargs.metadata;
+  const metadata = typeof existingMetadata === "object" && existingMetadata !== null ? existingMetadata : void 0;
+  if (!Array.isArray(stamp) || stamp.length === 0) {
+    if (metadata === void 0 || !(PLACE_INSTRUCTIONS_STAMP_KEY in metadata)) return message;
+    const { [PLACE_INSTRUCTIONS_STAMP_KEY]: _unvouched, ...rest } = metadata;
+    return {
+      ...message,
+      additional_kwargs: { ...kwargs, metadata: rest }
+    };
+  }
+  if ((metadata == null ? void 0 : metadata[PLACE_INSTRUCTIONS_STAMP_KEY]) === stamp) return message;
+  return {
+    ...message,
+    additional_kwargs: {
+      ...kwargs,
+      metadata: { ...metadata, [PLACE_INSTRUCTIONS_STAMP_KEY]: stamp }
+    }
+  };
+}
 function liftCompactionBoundaryIntoMetadata(message) {
   if (message.type !== "human") return message;
   const kwargs = message.additional_kwargs;
@@ -667,11 +694,13 @@ function liftMessageIntoMetadataChannels(message) {
         liftAopSourceIntoMetadata(
           liftHandoffSummaryIntoMetadata(
             liftCompactionBoundaryIntoMetadata(
-              liftConversationStatsIntoMetadata(
-                liftModelIntoMetadata(
-                  liftErrorsIntoMetadata(
-                    liftTerminationIntoMetadata(
-                      liftRunMarkerIntoMetadata(normalizeStringContentParts(message))
+              liftPlaceInstructionsIntoMetadata(
+                liftConversationStatsIntoMetadata(
+                  liftModelIntoMetadata(
+                    liftErrorsIntoMetadata(
+                      liftTerminationIntoMetadata(
+                        liftRunMarkerIntoMetadata(normalizeStringContentParts(message))
+                      )
                     )
                   )
                 )
@@ -735,7 +764,11 @@ function convertDeepAgentState(state, {
   const sanitized = isLangGraphState(values) ? sanitizeLangChainMessages(values.messages, { toolOutputs }) : [];
   const tail = sanitized[sanitized.length - 1];
   const tailWithdrawn = tail !== void 0 && isWithdrawn(tail);
-  const stateMessages = voiceTurnGrouping.groupSpokenUserTurns(sanitized.filter((message) => !isWithdrawn(message)));
+  const stateMessages = answerRows.withAnswerRows({
+    messages: voiceTurnGrouping.groupSpokenUserTurns(sanitized.filter((message) => !isWithdrawn(message))),
+    addressedTurn: answerRows.readDeepAgentAddressedTurn(values[answerRows.ADDRESSED_TURN_STATE_KEY]),
+    isRunning: isRunning && !tailWithdrawn
+  });
   const sources = [
     ...keepTailRunningAheadOfLanes(
       withPendingAssistantMessage(stateMessages, isRunning && !tailWithdrawn),
@@ -761,6 +794,7 @@ exports.ATHENA_STOP_SOURCE_SEND_NOW = ATHENA_STOP_SOURCE_SEND_NOW;
 exports.ATHENA_TERMINATION_REASON_KEY = ATHENA_TERMINATION_REASON_KEY;
 exports.DeepAgentMessageConversionCache = DeepAgentMessageConversionCache;
 exports.PENDING_ASSISTANT_MESSAGE_ID = PENDING_ASSISTANT_MESSAGE_ID;
+exports.PLACE_INSTRUCTIONS_STAMP_KEY = PLACE_INSTRUCTIONS_STAMP_KEY;
 exports.convertDeepAgentLangChainMessage = convertDeepAgentLangChainMessage;
 exports.convertDeepAgentMessage = convertDeepAgentMessage;
 exports.convertDeepAgentState = convertDeepAgentState;
@@ -779,6 +813,7 @@ exports.liftConversationStatsIntoMetadata = liftConversationStatsIntoMetadata;
 exports.liftErrorsIntoMetadata = liftErrorsIntoMetadata;
 exports.liftHandoffSummaryIntoMetadata = liftHandoffSummaryIntoMetadata;
 exports.liftModelIntoMetadata = liftModelIntoMetadata;
+exports.liftPlaceInstructionsIntoMetadata = liftPlaceInstructionsIntoMetadata;
 exports.liftRunMarkerIntoMetadata = liftRunMarkerIntoMetadata;
 exports.liftTerminationIntoMetadata = liftTerminationIntoMetadata;
 exports.liftToolMessageMetadataIntoArtifact = liftToolMessageMetadataIntoArtifact;