@athenaintel/react 0.48.0 → 0.50.0

package/README.md

@@ -261,7 +261,9 @@ What the statewire transport wires up in `AthenaChat`:
   (or Continue for a generic pause) and resumes the run through the statewire
   `run/input` command. Hosts that build their own thread UI should mount the
   exported `StatewireApprovalCard` themselves — without it an approval-gated
-  run stays parked with no way to answer it. Its `renderDetails`,
+  run stays parked with no way to answer it. A lone call whose resolved
+  envelope carries a headline is titled by it, with its summary under it,
+  above the card's own details (`title` on the slot context). Its `renderDetails`,
   `isHandledElsewhere`, and `readOnly` seams take host-specific review UIs,
   requests another surface answers, and viewers without edit rights; the
   headless `useStatewireApprovalRequest` behind it is exported for hosts with
@@ -365,6 +367,10 @@ What the statewire transport wires up in `AthenaChat`:
   `useAthenaSessionAttention`, and `useRefreshThreadList` read that state
   (and render nothing / return `null` without it). See
   [Session list, attention and wake markers](#session-list-attention-and-wake-markers).
+  The list holds the sessions of the provider's `appId` (and
+  `threadListAdditionalAppIds`); with `threadListAgentHome` and a collab
+  `agent`, also the conversations with that agent on its other channels (see
+  [What's new in 0.50.0](#whats-new-in-0500)).
 
 The `agent` prop only accepts `collab_agent:<asset_id>` refs (see below),
 because the statewire host always runs the Athena deep agent. **Any other
@@ -524,7 +530,8 @@ index pushes.
 Mounted by `AthenaChat` above the thread viewport: a persistent strip while
 the active thread's attention is `needs_you` or the approval hook
 (`useStatewireApprovalRequest`) reports a pending request. Its text is the
-server's `nextAction`, else a summary of the pending request; a click scrolls
+server's `nextAction`, else a summary of the pending request (the approval
+card's title when it has one); a click scrolls
 to the approval card (or to the composer when there is none). It never
 duplicates the card's Approve / Reject buttons. `WaitingOnYouBannerView` is
 the pure presenter for hosts that resolve the inputs themselves.
@@ -671,7 +678,9 @@ Server-applied filters are still checked on rows a live push changed, so a
 session you just read leaves "Unread" and a finished one leaves "Running".
 `listThreads` takes the server filters as `filters` (`ThreadListFilterBody`),
 and `app_ids` (`additionalListAppIds`) now reaches the server: the request
-body used to drop it.
+body used to drop it. With `threadListAgentHome`, `home_agent_id` rides beside
+it, and the answer's `home_agent_applied` says whether the list holds the
+agent's conversations (absent on an older server: it does not).
 
 ## Session workbench
 
@@ -809,7 +818,9 @@ After a handover the person sent in voice mode, a host passes
 `continueByVoice={{ onDone }}` and the composer offers **Continue by voice**:
 one tap starts a call whose model opens by saying where the conversation
 stands (`start({ opening: 'recap' })`). `onDone` runs on the tap, **Not now**,
-or a typed send.
+or a typed send. A host's own "Continue on…" control offers to send the
+conversation in voice mode only while `useChatVoiceEnabled({ enabled })` is
+true: the same workspace gate the composer's voice control uses.
 
 Use `<AthenaChat voice={false} />` to omit realtime voice in a host that cannot
 support it, or `voice={{ model: 'gemini-3.8-live' }}` to request a host-offered
@@ -940,6 +951,24 @@ Both use the same bearer / API key as session creation. The full recipe
 template skill `voice-session-guide.md`. `createAthenaVoiceSession` is also
 exported if you hold the bridge state yourself.
 
+## What's new in 0.50.0
+
+**An agent's own app lists its conversations from every channel.** An app that runs as a collab agent (`agent="collab_agent:<asset_id>"`) can now list the conversations people have with that agent anywhere else, such as Slack, email or SMS, beside its own sessions. Pass `threadListAgentHome` with `enableThreadList`:
+
+```tsx
+<AthenaProvider enableThreadList appId={appId} agent="collab_agent:asset_…" threadListAgentHome>
+```
+
+Every thread-list read the provider makes (`SessionList` and its Pinned group, `SessionsPage`, `Inbox` and `useAthenaSessions`) then names the agent as `home_agent_id`, and once the agent has a home app set, Athena adds the conversations with it that the viewer can already open. Each such row shows where it started ("Slack", "Email", "SMS"), and one that starts while the app is open appears without a reload. Nothing else about the list changes: its search and filters still apply, and Athena checks access to the list exactly as before. Against an Athena that predates the setting, or for an agent without a home app, the list is the app's own sessions, as it was. New sessions are still tagged `appId`. In `@athenaintel/agent-runtime` 0.3.11, `ConversationListFilter` takes `homeAgentId`, the list page and `useConversationList` report `homeAgentApplied`, and a conversation-index entry carries the session's `collab_agent_id`.
+
+## What's new in 0.49.0
+
+**An approval card leads with what it asks.** When the one tool call an approval covers arrives with a headline from Athena (its `approval_context`), `StatewireApprovalCard`, and so `AthenaChat`, shows that headline in place of "`tool` requires approval before it runs", with the summary under it, and names the tool in the details instead, above the facts, warnings and arguments it already showed. The first such approval asks to use one of the person's own devices in a conversation: "Use Studio Mac in this conversation?". The waiting-on-you banner names the approval the same way. A batch keeps the generic heading, since one decision answers every call, and an approval without a headline looks exactly as it did. So does a card whose details come from your `renderDetails` (or an editor from your `renderEditor`): your review shows the envelope, so the header doesn't say the headline again. The title is display-only: Approve and Reject send what they always sent. Your `renderHeader`, `renderDetails` and `renderEditor` receive it as `title` (`{ headline, summary? }`) to lead with if you want it. For an approval UI of your own, `pendingApprovalTitle` from `@athenaintel/agent-runtime` (0.3.10) returns it, and `parsePendingApprovalContext` now keeps an envelope's `headline` and `summary`. Nothing to change in your app.
+
+**Housekeeping written offline stays housekeeping.** A write your app makes inside `runWithDocUpdateAttributions` for a `connectGenericDoc` handle's document while the handle has no connection used to reach Athena inside the reconnect's sync, which carries no attributions, so it counted as the person's edit. The handle now keeps such writes until Athena acknowledges them, and when it reconnects sends each one ahead of that sync as its own marked update. Nothing to change in your app.
+
+**A host can put a failed message's own context back before Retry.** `StatewireQueuedMessages` takes an optional `onBeforeRetry(messageId)`, called right before a failed message is sent again from its Retry button, so a host that keeps per-send context for each message (Athena's web app stages the agents a message named) restores it before the retry leaves. The hook may return a promise to hold the Retry while it can't do that yet (a send with another context is still on its way); the tray asks it again once the promise settles, unless the message was sent or discarded meanwhile, and sends the message regardless after ten holds. A held Retry is held once (clicking it again does nothing), and a function the hook returns is called if the message does not go after all, so the host lets go of what it put back. Nothing to change in your app.
+
 ## What's new in 0.48.0
 
 **Scrolling back through a long session no longer flashes.** Opening a long session loads its newest messages, and scrolling to the top loads older pages. When a session's first loaded turn was one long run, each page of its earlier steps joined that same turn and gave it a new id. `ChatThreadShell` (and so `AthenaChat`) keyed rows by message id, so the turn remounted on every page: it replayed its entrance animation once per page, closed anything you had opened in it, and lost the browser's scroll anchor. A 74-minute run took 16 pages and flashed 16 times. Rows are now keyed by the row key the deep-agent conversion keeps for a turn that grows at its head (`deepAgentRowKey`), so the page lands in the mounted row. `AthenaChat`'s message rows also animate in only when they arrive live (the newest message, mounted while its run is running), never when a session opens or older history loads, and they respect reduced motion. The "Loading earlier messages" row is centred on the thread column. Nothing to change in your app.
@@ -2014,7 +2043,9 @@ host that opens a cited place in Athena on the web writes it into the Spaces lin
 
 Use `AthenaAssetEmbed` to render a native Athena asset without chat, thread history, tabs, or the SDK split-pane layout. It defaults to the editable, full native asset experience (`readOnly={false}` and `displayMode="full"`). The embed token and the current user must still have edit permission; otherwise Athena renders the asset read-only.
 
-With `displayMode="minimal"`, where the viewer does not sign in, pass `allowQuickEdit` (and `readOnly={false}`) to let the viewer Quick Edit a spreadsheet or Word document with ⌘J. Its runs are billed to the asset's workspace, with an hourly cap per link.
+Editing a Word document, an Athena document, a spreadsheet, a user interface or a deck through an embed needs a viewer who is signed in to Athena: give the provider the viewer's `token`, which the component hands the frame. A viewer it hands no token (a provider with only an `apiKey`, or none) is not signed in, and the embed is read-only for them, as a `readOnly` link is, whatever `readOnly={false}` asked for. Athena enforces this on its servers, for links minted before it too. Other asset types are unchanged.
+
+With `displayMode="minimal"`, which runs on the link rather than an Athena sign-in, pass `allowQuickEdit` (and `readOnly={false}`) to let the viewer Quick Edit a spreadsheet, a Word document or a deck with ⌘J. Like editing, it is offered only to a signed-in viewer. Its runs are billed to the asset's workspace, with an hourly cap per link.
 
 A minimal embed shows the asset's comment threads, read-only, only to a signed-in viewer with their own access to the asset (the bearer the component hands the frame, or an Athena session). Pass `allowComments` to show them to everyone holding the link, anonymous viewers included. No embed writes a comment. The request carries `allow_comments: true` only when you ask.
 
@@ -2243,10 +2274,14 @@ runWithDocUpdateAttributions({
 The handle's socket sends that write's update with `origin: background`, so
 Athena counts it as automatic work: it is not shown as the person's edit and
 does not notify subscriptions that follow people's edits. Only a synchronous
-write inside `run` is marked, and only while the handle is connected; a write
-made offline is sent with the reconnect's sync, as the person's. On a read-only
-grant the handle's socket sends nothing that carries document content (presence
-still goes out); Athena would refuse it anyway.
+write inside `run` is marked. One made while the handle has no connection is
+kept until Athena acknowledges it and sent marked the same way when the handle
+reconnects, ahead of the reconnect's sync. The handle keeps it in memory; a
+host whose local copy is Athena's (`@athenaintel/local-copy`, as in Athena's
+desktop and phone apps) also keeps it across restarts. Without one, a reload
+before the reconnect sends it with the person's unsynced edits, as theirs. On a
+read-only grant the handle's socket sends nothing that carries document content
+(presence still goes out); Athena would refuse it anyway.
 
 ### Workspace presence (admin only)
 
@@ -2447,7 +2482,10 @@ as it is, for a host that shows the chat again and wants typing to land in it (a
 launcher window brought back by a shortcut). Asked before the editor has mounted,
 it focuses the editor as it mounts. `useReadComposerDraft()` returns a function
 that reads the draft's text when called, for a host that hands the chat to
-another window and carries the unsent text along.
+another window and carries the unsent text along. `useTryReadComposerDraft()`
+reads the same text but answers `null` when there is no composer to read, for a
+host that must tell a blank composer from one it could not read ("Continue on…"
+sends a blank one as an empty draft and an unread one as none).
 
 Use `useSendMessage()` for workflow buttons, sidebar shortcuts, and other UI that lives outside `<AthenaChat>` but still needs to submit a prompt. Its promise settles once the send has been dispatched, including a send that waited for the connection.
 

package/dist/agent-runtime/src/call-recap.cjs

@@ -0,0 +1,319 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const core = require("@assistant-ui/core");
+const statewireState = require("./statewire-state.cjs");
+const toolResult = require("./tool-result.cjs");
+const voicePresentation = require("./voice-presentation.cjs");
+const VOICE_TYPED_ID_PREFIX = "voicetext_";
+const CALL_SOURCES = /* @__PURE__ */ new Set([
+  voicePresentation.VOICE_SOURCE_SPOKEN,
+  voicePresentation.VOICE_SOURCE_TYPED,
+  voicePresentation.VOICE_SOURCE_DELEGATION
+]);
+function isCallUserMessage(message) {
+  var _a, _b;
+  if (message.role !== "user") return false;
+  if (CALL_SOURCES.has((_b = (_a = message.metadata) == null ? void 0 : _a.custom) == null ? void 0 : _b.source)) return true;
+  return message.id.startsWith(voicePresentation.VOICE_DELEGATION_ID_PREFIX) || message.id.startsWith(VOICE_TYPED_ID_PREFIX);
+}
+function mayHaveLiveCall(state) {
+  if (!statewireState.isDeepAgentStateHydrated(state)) return true;
+  const voice = statewireState.readDeepAgentStreamValues(state).voice;
+  return voice !== null && voice !== void 0;
+}
+const NO_ENTRIES = Object.freeze([]);
+const MARKDOWN_LINK = /\[((?:[^[\]\n]|\[[^[\]\n]*\])*)\]\(\s*<?((?:[^()\s<>]|\([^()\s]*\))+)>?(?:\s+"[^"\n]*")?\s*\)/g;
+const BARE_URL = /\bhttps?:\/\/[^\s<>()[\]"'`]+/g;
+const TRAILING_PUNCTUATION = /[.,;:!?'"*_]+$/;
+const SPACES_PATH = /\/dashboard\/spaces\/?$/;
+const MAX_TOOL_RESULT_CHARS = 2e4;
+function assetEntry(asset) {
+  return {
+    kind: "asset",
+    asset: { kind: "asset", key: `asset:${asset.assetId}`, ...asset }
+  };
+}
+function normalizeAssetType(value) {
+  if (!value) return null;
+  return value === "sheet" ? "spreadsheet" : value;
+}
+function labelOf(raw) {
+  return raw.trim().replace(/^@/, "").trim();
+}
+function displayUrl(url) {
+  const host = url.hostname.replace(/^www\./, "");
+  const path = url.pathname === "/" ? "" : url.pathname.replace(/\/$/, "");
+  return `${host}${path}`;
+}
+const RELATIVE_LINK_BASE = "https://app.athenaintel.com";
+function entriesOfHref(href, rawLabel) {
+  const label = labelOf(rawLabel);
+  let url;
+  try {
+    url = new URL(href, href.startsWith("/") ? RELATIVE_LINK_BASE : void 0);
+  } catch {
+    return [];
+  }
+  if (url.protocol === "mention:") {
+    if (url.hostname !== "asset") return [];
+    const assetId = url.searchParams.get("id") ?? url.searchParams.get("asset_id");
+    if (!(assetId == null ? void 0 : assetId.startsWith("asset_"))) return [];
+    return [
+      assetEntry({
+        assetId,
+        title: label || (url.searchParams.get("name") ?? ""),
+        assetType: normalizeAssetType(
+          url.searchParams.get("asset_type") ?? url.searchParams.get("type")
+        ),
+        href
+      })
+    ];
+  }
+  if (url.protocol !== "https:" && url.protocol !== "http:") return [];
+  const assetIds = url.searchParams.get("asset_ids");
+  if (assetIds && SPACES_PATH.test(url.pathname)) {
+    const ids = [
+      ...new Set(
+        assetIds.split(",").map((id) => id.trim()).filter((id) => id.startsWith("asset_"))
+      )
+    ];
+    const assetType = normalizeAssetType(
+      url.searchParams.get("type") ?? url.searchParams.get("assetType") ?? url.searchParams.get("asset_type")
+    );
+    return ids.map((assetId) => {
+      if (ids.length === 1) return assetEntry({ assetId, title: label, assetType, href });
+      const single = new URL(url.toString());
+      single.searchParams.set("asset_ids", assetId);
+      return assetEntry({
+        assetId,
+        title: label,
+        assetType,
+        href: href.startsWith("/") ? `${single.pathname}${single.search}` : single.toString()
+      });
+    });
+  }
+  if (href.startsWith("/")) return [];
+  const shown = label && label !== href ? label : displayUrl(url);
+  const key = `${url.origin}${url.pathname.replace(/\/$/, "")}${url.search}`;
+  return [
+    {
+      kind: "link",
+      link: { kind: "link", key: `link:${key}`, url: url.toString(), label: shown }
+    }
+  ];
+}
+const CODE = /```[\s\S]*?(?:```|$)|`[^`\n]*`/g;
+function textEntries(raw) {
+  if (!raw.includes("://") && !raw.includes("](/")) return NO_ENTRIES;
+  const text = raw.includes("`") ? raw.replace(CODE, (code) => " ".repeat(code.length)) : raw;
+  const found = [];
+  const covered = [];
+  for (const match of text.matchAll(MARKDOWN_LINK)) {
+    const [whole, label = "", href = ""] = match;
+    covered.push([match.index, match.index + whole.length]);
+    if (text[match.index - 1] === "!") continue;
+    for (const entry of entriesOfHref(href, label)) found.push({ index: match.index, entry });
+  }
+  for (const match of text.matchAll(BARE_URL)) {
+    const start = match.index;
+    if (covered.some(([from, to]) => start >= from && start < to)) continue;
+    const href = match[0].replace(TRAILING_PUNCTUATION, "");
+    for (const entry of entriesOfHref(href, "")) found.push({ index: start, entry });
+  }
+  if (found.length === 0) return NO_ENTRIES;
+  found.sort((a, b) => a.index - b.index);
+  return Object.freeze(found.map(({ entry }) => entry));
+}
+function toolCallEntries(part) {
+  const toolCallId = part.toolCallId;
+  const toolName = part.toolName ?? "tool";
+  if (!toolCallId) return NO_ENTRIES;
+  if (part.result === void 0) {
+    return Object.freeze([{ kind: "open-call", call: { toolCallId, toolName } }]);
+  }
+  if (part.isPreliminary === true) return NO_ENTRIES;
+  if (typeof part.result === "string" && part.result.length > MAX_TOOL_RESULT_CHARS)
+    return NO_ENTRIES;
+  const record = toolResult.resultRecord(part.result);
+  if (!record) return NO_ENTRIES;
+  const assetId = toolResult.stringField(record, ["asset_id", "assetId"]);
+  const title = toolResult.stringField(record, ["title", "asset_title", "name"]);
+  if (!(assetId == null ? void 0 : assetId.startsWith("asset_")) || !title) return NO_ENTRIES;
+  const outcome = toolResult.classifyToolResult({
+    status: { type: "complete" },
+    result: part.result,
+    isError: part.isError
+  });
+  if (outcome.state !== "complete") return NO_ENTRIES;
+  return Object.freeze([
+    assetEntry({
+      assetId,
+      title: title.trim(),
+      assetType: normalizeAssetType(toolResult.stringField(record, ["asset_type", "assetType"])),
+      href: null
+    })
+  ]);
+}
+const partEntriesCache = /* @__PURE__ */ new WeakMap();
+function partEntries(part) {
+  const cached = partEntriesCache.get(part);
+  if (cached !== void 0) return cached;
+  const entries = part.type === "text" && typeof part.text === "string" ? textEntries(part.text) : part.type === "tool-call" ? toolCallEntries(part) : NO_ENTRIES;
+  partEntriesCache.set(part, entries);
+  return entries;
+}
+const factsCache = /* @__PURE__ */ new WeakMap();
+function isBoundPart(part) {
+  return core.getExternalStoreMessages(part).length > 0;
+}
+function messageFacts(message) {
+  var _a, _b;
+  const cached = factsCache.get(message);
+  if (cached !== void 0) return cached;
+  let facts;
+  if (message.role === "user") {
+    const call = isCallUserMessage(message);
+    facts = { breaksCall: !call, callFrom: call ? 0 : -1 };
+  } else if (message.role === "assistant") {
+    let callFrom = message.content.findIndex(
+      (part) => part.type === "text" && voicePresentation.isSpokenTurnTextPart(part) || part.type === "tool-call" && part.toolName === voicePresentation.VOICE_UPDATE_TOOL_NAME
+    );
+    if (callFrom < 0 && ((_b = (_a = message.metadata) == null ? void 0 : _a.custom) == null ? void 0 : _b.source) === voicePresentation.VOICE_SOURCE_SPOKEN && !message.content.some(isBoundPart)) {
+      callFrom = 0;
+    }
+    facts = { breaksCall: false, callFrom };
+  } else {
+    facts = { breaksCall: false, callFrom: -1 };
+  }
+  factsCache.set(message, facts);
+  return facts;
+}
+const recapMemo = /* @__PURE__ */ new WeakMap();
+const internedRecaps = /* @__PURE__ */ new Map();
+const MAX_INTERNED_RECAPS = 200;
+function recapSignature(recap) {
+  return JSON.stringify([
+    recap.endMessageId,
+    recap.trailing,
+    recap.assets.map((asset) => [asset.assetId, asset.title, asset.assetType, asset.href]),
+    recap.links.map((link) => [link.url, link.label]),
+    recap.openToolCalls.map((call) => [call.toolCallId, call.toolName])
+  ]);
+}
+function intern(recap) {
+  const signature = recapSignature(recap);
+  const existing = internedRecaps.get(signature);
+  if (existing !== void 0) {
+    internedRecaps.delete(signature);
+    internedRecaps.set(signature, existing);
+    return existing;
+  }
+  const frozen = Object.freeze({
+    ...recap,
+    assets: Object.freeze([...recap.assets]),
+    links: Object.freeze([...recap.links]),
+    openToolCalls: Object.freeze([...recap.openToolCalls])
+  });
+  internedRecaps.set(signature, frozen);
+  if (internedRecaps.size > MAX_INTERNED_RECAPS) {
+    const oldest = internedRecaps.keys().next().value;
+    if (oldest !== void 0) internedRecaps.delete(oldest);
+  }
+  return frozen;
+}
+function sameSpan(a, b) {
+  if (a.length !== b.length) return false;
+  for (let index = 0; index < a.length; index += 1) {
+    if (a[index] !== b[index]) return false;
+  }
+  return true;
+}
+function buildRecap({
+  span,
+  startPart,
+  trailing
+}) {
+  const assets = /* @__PURE__ */ new Map();
+  const links = /* @__PURE__ */ new Map();
+  const openToolCalls = /* @__PURE__ */ new Map();
+  span.forEach((message, position) => {
+    const parts = position === 0 ? message.content.slice(startPart) : message.content;
+    for (const part of parts) {
+      for (const entry of partEntries(part)) {
+        if (entry.kind === "asset") {
+          const known = assets.get(entry.asset.assetId);
+          if (!known) {
+            assets.set(entry.asset.assetId, entry.asset);
+          } else if (!known.title && entry.asset.title || !known.assetType && entry.asset.assetType) {
+            assets.set(entry.asset.assetId, {
+              ...known,
+              title: known.title || entry.asset.title,
+              assetType: known.assetType ?? entry.asset.assetType,
+              href: known.href ?? entry.asset.href
+            });
+          }
+        } else if (entry.kind === "link") {
+          if (!links.has(entry.link.key)) links.set(entry.link.key, entry.link);
+        } else if (!openToolCalls.has(entry.call.toolCallId)) {
+          openToolCalls.set(entry.call.toolCallId, entry.call);
+        }
+      }
+    }
+  });
+  const end = span[span.length - 1];
+  return {
+    endMessageId: (end == null ? void 0 : end.id) ?? "",
+    trailing,
+    assets: [...assets.values()],
+    links: [...links.values()],
+    openToolCalls: [...openToolCalls.values()]
+  };
+}
+function callRecapAfter(messages, index) {
+  const message = messages[index];
+  if (message === void 0) return null;
+  const next = messages[index + 1];
+  if (next !== void 0 && (next.role !== "user" || isCallUserMessage(next))) return null;
+  let start = -1;
+  let startPart = -1;
+  for (let position = index; position >= 0; position -= 1) {
+    const candidate = messages[position];
+    if (candidate === void 0) break;
+    const facts = messageFacts(candidate);
+    if (facts.breaksCall) break;
+    if (facts.callFrom >= 0) {
+      start = position;
+      startPart = facts.callFrom;
+    }
+  }
+  if (start < 0) return null;
+  const span = messages.slice(start, index + 1);
+  const trailing = next === void 0;
+  const memo = recapMemo.get(message);
+  if (memo !== void 0 && memo.startPart === startPart && memo.trailing === trailing && sameSpan(memo.span, span)) {
+    return memo.recap;
+  }
+  const recap = intern(buildRecap({ span, startPart, trailing }));
+  recapMemo.set(message, { span, startPart, trailing, recap });
+  return recap;
+}
+const EMPTY_IDS = /* @__PURE__ */ new Set();
+function callRecapItems(recap, awaitingApprovalToolCallIds = EMPTY_IDS) {
+  const approvals = recap.openToolCalls.filter((call) => awaitingApprovalToolCallIds.has(call.toolCallId)).map((call) => ({
+    kind: "approval",
+    key: `approval:${call.toolCallId}`,
+    toolCallId: call.toolCallId,
+    toolName: call.toolName
+  }));
+  return [...approvals, ...recap.assets, ...recap.links];
+}
+const CALL_RECAP_TITLE = "From the call";
+const CALL_RECAP_APPROVAL_LABEL = "Waiting for your approval";
+exports.CALL_RECAP_APPROVAL_LABEL = CALL_RECAP_APPROVAL_LABEL;
+exports.CALL_RECAP_TITLE = CALL_RECAP_TITLE;
+exports.VOICE_TYPED_ID_PREFIX = VOICE_TYPED_ID_PREFIX;
+exports.callRecapAfter = callRecapAfter;
+exports.callRecapItems = callRecapItems;
+exports.isCallUserMessage = isCallUserMessage;
+exports.mayHaveLiveCall = mayHaveLiveCall;
+//# sourceMappingURL=call-recap.cjs.map

package/dist/agent-runtime/src/call-recap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-recap.cjs","sources":["../../../../agent-runtime/src/call-recap.ts"],"sourcesContent":["/**\n * \"From the call\": what a voice call produced or mentioned, gathered where the\n * call's stretch of the transcript ends, so a person who talked to the agent\n * and later reads the conversation as text (on the same app or another) finds\n * the call's assets, links and open approvals in one place.\n *\n * Everything here is read from the transcript every app already renders, and\n * nothing is invented: an asset item is an asset link or `@`-mention in a\n * message, or a tool result that names the asset it made or read (`asset_id`\n * with a `title`); a link item is a web link in a message; an approval item is\n * a tool call of the call's that has no result yet, shown only while the\n * host's live approval request still names it (the presenter's\n * {@link callRecapItems}).\n *\n * **Where a call is in the transcript.** The host marks every turn a call\n * commits (`metadata.custom.source`, see `voice-presentation.ts`): spoken turns\n * (`voice`), messages typed into the call (`text`, id `voicetext_…`) and the\n * tasks the live model handed the thread (`voice_delegation`, id\n * `voicetask_…`). A typed message sent outside a call carries none of these. So\n * a call's stretch starts at its first marked turn and runs, through the\n * assistant work in between (the delegated runs), up to the next user message\n * that is not a call turn, or the end of the transcript. A spoken assistant\n * turn the converter joined onto the end of an earlier run's message starts\n * the stretch at that part, so the earlier run's artifacts stay out. A\n * delegated run's `send_voice_update` call (a tool only voice-delegated runs\n * get) marks the call too, so a windowed transcript whose loaded tail starts\n * inside a long delegated run still finds it.\n *\n * Two calls with no typed message between them read as one stretch: the\n * transcript does not say where one ended and the next began (the host keeps\n * no per-call marker), so their card collects both. A stretch that ends the\n * transcript may still be live; the presenter shows it once the host reports\n * no voice session (`state.voice` is null), see {@link mayHaveLiveCall}.\n *\n * **Cost.** Every message row asks {@link callRecapAfter} on every transcript\n * update. A row that does not end a stretch answers after looking at the next\n * message; a row that does walks back over its own stretch only. What a message\n * and each of its parts contribute is memoized per object (statewire replaces a\n * changed message and assistant-ui keeps every unchanged part), and an equal\n * recap is the same frozen object, so a row selecting it re-renders only when\n * the card's contents change. The transcript is never re-scanned per delta.\n */\n\nimport { getExternalStoreMessages, type ThreadMessage } from '@assistant-ui/core';\nimport { isDeepAgentStateHydrated, readDeepAgentStreamValues } from './statewire-state';\nimport {\n  classifyToolResult,\n  resultRecord,\n  stringField,\n  type ToolCallStatusLike,\n} from './tool-result';\nimport {\n  isSpokenTurnTextPart,\n  VOICE_DELEGATION_ID_PREFIX,\n  VOICE_UPDATE_TOOL_NAME,\n  VOICE_SOURCE_DELEGATION,\n  VOICE_SOURCE_SPOKEN,\n  VOICE_SOURCE_TYPED,\n} from './voice-presentation';\n\n/** Id prefix of a message typed into a live call (`voice/user-text`). */\nexport const VOICE_TYPED_ID_PREFIX = 'voicetext_';\n\n/** An asset the call created, read or linked. */\nexport interface CallRecapAsset {\n  readonly kind: 'asset';\n  /** Unique within a recap. */\n  readonly key: string;\n  readonly assetId: string;\n  /** What the transcript calls it (the link's label, or the tool result's title); may be empty. */\n  readonly title: string;\n  /** The asset type the link or tool named (`document`, `spreadsheet`, …), when it named one. */\n  readonly assetType: string | null;\n  /** The link the transcript carried for it, when it came from a link. */\n  readonly href: string | null;\n}\n\n/** A web page the call linked. */\nexport interface CallRecapLink {\n  readonly kind: 'link';\n  readonly key: string;\n  readonly url: string;\n  /** The link's own label, else the page's host and path. */\n  readonly label: string;\n}\n\n/** A tool call of the call's that is waiting for the person's approval. */\nexport interface CallRecapApproval {\n  readonly kind: 'approval';\n  readonly key: string;\n  readonly toolCallId: string;\n  readonly toolName: string;\n}\n\nexport type CallRecapItem = CallRecapAsset | CallRecapLink | CallRecapApproval;\n\n/** A tool call in the stretch with no result yet: an approval while the host's request names it. */\nexport interface CallRecapOpenToolCall {\n  readonly toolCallId: string;\n  readonly toolName: string;\n}\n\nexport interface CallRecap {\n  /** The message the stretch ends at; the card renders right after it. */\n  readonly endMessageId: string;\n  /** The stretch ends the transcript, so the call may still be live. */\n  readonly trailing: boolean;\n  /** Assets, in the order the stretch first mentioned them. */\n  readonly assets: readonly CallRecapAsset[];\n  /** Web links, in the order the stretch first mentioned them. */\n  readonly links: readonly CallRecapLink[];\n  /** Result-less tool calls, in transcript order. */\n  readonly openToolCalls: readonly CallRecapOpenToolCall[];\n}\n\n/** The fields of an assistant-ui thread message this reads (structural, so any runtime's message fits). */\nexport interface CallRecapMessage {\n  readonly id: string;\n  readonly role: string;\n  readonly content: readonly CallRecapPart[];\n  readonly metadata?: { readonly custom?: Record<string, unknown> } | undefined;\n}\n\n/** The fields of a message part this reads. */\nexport interface CallRecapPart {\n  readonly type: string;\n  readonly text?: string;\n  readonly toolCallId?: string;\n  readonly toolName?: string;\n  readonly result?: unknown;\n  readonly isError?: boolean;\n  /** An interim result a running tool published (`markPreliminaryToolResults`); the real one has not arrived. */\n  readonly isPreliminary?: boolean;\n  readonly status?: unknown;\n}\n\nconst CALL_SOURCES: ReadonlySet<unknown> = new Set([\n  VOICE_SOURCE_SPOKEN,\n  VOICE_SOURCE_TYPED,\n  VOICE_SOURCE_DELEGATION,\n]);\n\n/**\n * Whether a user message is one of a call's turns: spoken, typed into the call,\n * or a task the live model delegated (by source, or by id on hosts that drop\n * the command's metadata).\n */\nexport function isCallUserMessage(\n  message: Pick<CallRecapMessage, 'id' | 'role' | 'metadata'>,\n): boolean {\n  if (message.role !== 'user') return false;\n  if (CALL_SOURCES.has(message.metadata?.custom?.source)) return true;\n  return (\n    message.id.startsWith(VOICE_DELEGATION_ID_PREFIX) ||\n    message.id.startsWith(VOICE_TYPED_ID_PREFIX)\n  );\n}\n\n/**\n * Whether a stretch that ends the transcript may still be a live call: the\n * host reports a voice session (`state.voice`), or its state has not loaded\n * yet. A primitive read of the raw statewire state, safe as a selector.\n */\nexport function mayHaveLiveCall(state: unknown): boolean {\n  if (!isDeepAgentStateHydrated(state)) return true;\n  const voice: unknown = readDeepAgentStreamValues(state).voice;\n  return voice !== null && voice !== undefined;\n}\n\n// ── Per-part entries ─────────────────────────────────────────────────────────\n\ntype Entry =\n  | { readonly kind: 'asset'; readonly asset: CallRecapAsset }\n  | { readonly kind: 'link'; readonly link: CallRecapLink }\n  | { readonly kind: 'open-call'; readonly call: CallRecapOpenToolCall };\n\nconst NO_ENTRIES: readonly Entry[] = Object.freeze([]);\n\n/** `[label](href)` with an optional `\"title\"`; one level of brackets in the label, one of parens in the href. */\nconst MARKDOWN_LINK =\n  /\\[((?:[^[\\]\\n]|\\[[^[\\]\\n]*\\])*)\\]\\(\\s*<?((?:[^()\\s<>]|\\([^()\\s]*\\))+)>?(?:\\s+\"[^\"\\n]*\")?\\s*\\)/g;\n/** A bare web address in prose. */\nconst BARE_URL = /\\bhttps?:\\/\\/[^\\s<>()[\\]\"'`]+/g;\n/** Sentence punctuation that follows an address rather than belonging to it. */\nconst TRAILING_PUNCTUATION = /[.,;:!?'\"*_]+$/;\n/** The Spaces route an asset link opens (`/dashboard/spaces?asset_ids=…`). */\nconst SPACES_PATH = /\\/dashboard\\/spaces\\/?$/;\n/** Past this a tool result is not read for an asset: a created asset's answer is small. */\nconst MAX_TOOL_RESULT_CHARS = 20_000;\n\nfunction assetEntry(asset: Omit<CallRecapAsset, 'kind' | 'key'>): Entry {\n  return {\n    kind: 'asset',\n    asset: { kind: 'asset', key: `asset:${asset.assetId}`, ...asset },\n  };\n}\n\n/** `sheet` is the old spelling of `spreadsheet` in Spaces links. */\nfunction normalizeAssetType(value: string | null): string | null {\n  if (!value) return null;\n  return value === 'sheet' ? 'spreadsheet' : value;\n}\n\nfunction labelOf(raw: string): string {\n  return raw.trim().replace(/^@/, '').trim();\n}\n\n/** The page's host and path, for a link that carries no label of its own. */\nfunction displayUrl(url: URL): string {\n  const host = url.hostname.replace(/^www\\./, '');\n  const path = url.pathname === '/' ? '' : url.pathname.replace(/\\/$/, '');\n  return `${host}${path}`;\n}\n\n/** The base a relative Spaces link (`/dashboard/spaces?asset_ids=…`) resolves against; only its query is read. */\nconst RELATIVE_LINK_BASE = 'https://app.athenaintel.com';\n\n/** The assets an Athena link names, the web page a link names, or nothing. */\nfunction entriesOfHref(href: string, rawLabel: string): readonly Entry[] {\n  const label = labelOf(rawLabel);\n  let url: URL;\n  try {\n    url = new URL(href, href.startsWith('/') ? RELATIVE_LINK_BASE : undefined);\n  } catch {\n    return [];\n  }\n  if (url.protocol === 'mention:') {\n    if (url.hostname !== 'asset') return [];\n    const assetId = url.searchParams.get('id') ?? url.searchParams.get('asset_id');\n    if (!assetId?.startsWith('asset_')) return [];\n    return [\n      assetEntry({\n        assetId,\n        title: label || (url.searchParams.get('name') ?? ''),\n        assetType: normalizeAssetType(\n          url.searchParams.get('asset_type') ?? url.searchParams.get('type'),\n        ),\n        href,\n      }),\n    ];\n  }\n  if (url.protocol !== 'https:' && url.protocol !== 'http:') return [];\n  const assetIds = url.searchParams.get('asset_ids');\n  if (assetIds && SPACES_PATH.test(url.pathname)) {\n    const ids = [\n      ...new Set(\n        assetIds\n          .split(',')\n          .map((id) => id.trim())\n          .filter((id) => id.startsWith('asset_')),\n      ),\n    ];\n    const assetType = normalizeAssetType(\n      url.searchParams.get('type') ??\n        url.searchParams.get('assetType') ??\n        url.searchParams.get('asset_type'),\n    );\n    // A link that opens several assets side by side names each of them: one\n    // item per asset, each opening only its own asset.\n    return ids.map((assetId) => {\n      if (ids.length === 1) return assetEntry({ assetId, title: label, assetType, href });\n      const single = new URL(url.toString());\n      single.searchParams.set('asset_ids', assetId);\n      return assetEntry({\n        assetId,\n        title: label,\n        assetType,\n        href: href.startsWith('/') ? `${single.pathname}${single.search}` : single.toString(),\n      });\n    });\n  }\n  // Any other relative link is a route inside the app, not a page the call named.\n  if (href.startsWith('/')) return [];\n  const shown = label && label !== href ? label : displayUrl(url);\n  const key = `${url.origin}${url.pathname.replace(/\\/$/, '')}${url.search}`;\n  return [\n    {\n      kind: 'link',\n      link: { kind: 'link', key: `link:${key}`, url: url.toString(), label: shown },\n    },\n  ];\n}\n\n/** Fenced code blocks and inline code spans: an address shown as code is not a link the message names. */\nconst CODE = /```[\\s\\S]*?(?:```|$)|`[^`\\n]*`/g;\n\n/** The asset and web links a text part carries, in the order it carries them. */\nfunction textEntries(raw: string): readonly Entry[] {\n  // An address (`https://`, `mention://`) or a relative Spaces link (`](/dashboard/…`).\n  if (!raw.includes('://') && !raw.includes('](/')) return NO_ENTRIES;\n  // Blanked to the same length, so the rest keeps its offsets (the order the part names things in).\n  const text = raw.includes('`') ? raw.replace(CODE, (code) => ' '.repeat(code.length)) : raw;\n  const found: { index: number; entry: Entry }[] = [];\n  const covered: [number, number][] = [];\n  for (const match of text.matchAll(MARKDOWN_LINK)) {\n    const [whole, label = '', href = ''] = match;\n    covered.push([match.index, match.index + whole.length]);\n    // `![alt](src)` is an image the message shows, not a link it names.\n    if (text[match.index - 1] === '!') continue;\n    for (const entry of entriesOfHref(href, label)) found.push({ index: match.index, entry });\n  }\n  for (const match of text.matchAll(BARE_URL)) {\n    const start = match.index;\n    if (covered.some(([from, to]) => start >= from && start < to)) continue;\n    const href = match[0].replace(TRAILING_PUNCTUATION, '');\n    for (const entry of entriesOfHref(href, '')) found.push({ index: start, entry });\n  }\n  if (found.length === 0) return NO_ENTRIES;\n  found.sort((a, b) => a.index - b.index);\n  return Object.freeze(found.map(({ entry }) => entry));\n}\n\n/** The asset a finished tool call reports (`asset_id` with a `title`), the open call, or nothing. */\nfunction toolCallEntries(part: CallRecapPart): readonly Entry[] {\n  const toolCallId = part.toolCallId;\n  const toolName = part.toolName ?? 'tool';\n  if (!toolCallId) return NO_ENTRIES;\n  if (part.result === undefined) {\n    return Object.freeze([{ kind: 'open-call', call: { toolCallId, toolName } }]);\n  }\n  // A running tool's interim payload is not its outcome: the asset counts once the tool finished.\n  if (part.isPreliminary === true) return NO_ENTRIES;\n  if (typeof part.result === 'string' && part.result.length > MAX_TOOL_RESULT_CHARS)\n    return NO_ENTRIES;\n  const record = resultRecord(part.result);\n  if (!record) return NO_ENTRIES;\n  const assetId = stringField(record, ['asset_id', 'assetId']);\n  const title = stringField(record, ['title', 'asset_title', 'name']);\n  if (!assetId?.startsWith('asset_') || !title) return NO_ENTRIES;\n  const outcome = classifyToolResult({\n    status: { type: 'complete' } satisfies ToolCallStatusLike,\n    result: part.result,\n    isError: part.isError,\n  });\n  if (outcome.state !== 'complete') return NO_ENTRIES;\n  return Object.freeze([\n    assetEntry({\n      assetId,\n      title: title.trim(),\n      assetType: normalizeAssetType(stringField(record, ['asset_type', 'assetType'])),\n      href: null,\n    }),\n  ]);\n}\n\nconst partEntriesCache = new WeakMap<object, readonly Entry[]>();\n\nfunction partEntries(part: CallRecapPart): readonly Entry[] {\n  const cached = partEntriesCache.get(part);\n  if (cached !== undefined) return cached;\n  const entries =\n    part.type === 'text' && typeof part.text === 'string'\n      ? textEntries(part.text)\n      : part.type === 'tool-call'\n        ? toolCallEntries(part)\n        : NO_ENTRIES;\n  partEntriesCache.set(part, entries);\n  return entries;\n}\n\n// ── Per-message facts ────────────────────────────────────────────────────────\n\ninterface MessageFacts {\n  /** A user message outside any call: it ends the stretch before it. */\n  readonly breaksCall: boolean;\n  /** The first part that belongs to a call (a call turn's first part, a spoken assistant part, a voice update), or -1. */\n  readonly callFrom: number;\n}\n\nconst factsCache = new WeakMap<object, MessageFacts>();\n\n/** Whether the converter bound a part to its wire entry (`isSpokenTurnTextPart` reads that entry). */\nfunction isBoundPart(part: CallRecapPart): boolean {\n  return getExternalStoreMessages<unknown>(part as ThreadMessage['content'][number]).length > 0;\n}\n\nfunction messageFacts(message: CallRecapMessage): MessageFacts {\n  const cached = factsCache.get(message);\n  if (cached !== undefined) return cached;\n  let facts: MessageFacts;\n  if (message.role === 'user') {\n    const call = isCallUserMessage(message);\n    facts = { breaksCall: !call, callFrom: call ? 0 : -1 };\n  } else if (message.role === 'assistant') {\n    // A spoken turn, or the interim-update tool only a run the live model\n    // delegated is given (`send_voice_update`): a delegated run still marks its\n    // call when a windowed transcript has not loaded the turns before it.\n    let callFrom = message.content.findIndex(\n      (part) =>\n        (part.type === 'text' && isSpokenTurnTextPart(part)) ||\n        (part.type === 'tool-call' && part.toolName === VOICE_UPDATE_TOOL_NAME),\n    );\n    // A message no converter bound reads by its own source (one spoken turn).\n    if (\n      callFrom < 0 &&\n      message.metadata?.custom?.source === VOICE_SOURCE_SPOKEN &&\n      !message.content.some(isBoundPart)\n    ) {\n      callFrom = 0;\n    }\n    facts = { breaksCall: false, callFrom };\n  } else {\n    facts = { breaksCall: false, callFrom: -1 };\n  }\n  factsCache.set(message, facts);\n  return facts;\n}\n\n// ── The recap at a row ───────────────────────────────────────────────────────\n\ninterface RecapMemo {\n  /** The stretch's messages, start first, as last read. */\n  readonly span: readonly CallRecapMessage[];\n  readonly startPart: number;\n  readonly trailing: boolean;\n  readonly recap: CallRecap;\n}\n\n/** Keyed by the stretch's last message: a settled stretch answers from here without rebuilding. */\nconst recapMemo = new WeakMap<object, RecapMemo>();\n\n/** Equal recaps share one frozen object (bounded; a miss only costs a rebuild). */\nconst internedRecaps = new Map<string, CallRecap>();\nconst MAX_INTERNED_RECAPS = 200;\n\nfunction recapSignature(recap: CallRecap): string {\n  return JSON.stringify([\n    recap.endMessageId,\n    recap.trailing,\n    recap.assets.map((asset) => [asset.assetId, asset.title, asset.assetType, asset.href]),\n    recap.links.map((link) => [link.url, link.label]),\n    recap.openToolCalls.map((call) => [call.toolCallId, call.toolName]),\n  ]);\n}\n\nfunction intern(recap: CallRecap): CallRecap {\n  const signature = recapSignature(recap);\n  const existing = internedRecaps.get(signature);\n  if (existing !== undefined) {\n    // Most recently used last, so the bound evicts the stalest.\n    internedRecaps.delete(signature);\n    internedRecaps.set(signature, existing);\n    return existing;\n  }\n  const frozen: CallRecap = Object.freeze({\n    ...recap,\n    assets: Object.freeze([...recap.assets]),\n    links: Object.freeze([...recap.links]),\n    openToolCalls: Object.freeze([...recap.openToolCalls]),\n  });\n  internedRecaps.set(signature, frozen);\n  if (internedRecaps.size > MAX_INTERNED_RECAPS) {\n    const oldest = internedRecaps.keys().next().value;\n    if (oldest !== undefined) internedRecaps.delete(oldest);\n  }\n  return frozen;\n}\n\nfunction sameSpan(a: readonly CallRecapMessage[], b: readonly CallRecapMessage[]): boolean {\n  if (a.length !== b.length) return false;\n  for (let index = 0; index < a.length; index += 1) {\n    if (a[index] !== b[index]) return false;\n  }\n  return true;\n}\n\nfunction buildRecap({\n  span,\n  startPart,\n  trailing,\n}: {\n  span: readonly CallRecapMessage[];\n  startPart: number;\n  trailing: boolean;\n}): CallRecap {\n  const assets = new Map<string, CallRecapAsset>();\n  const links = new Map<string, CallRecapLink>();\n  const openToolCalls = new Map<string, CallRecapOpenToolCall>();\n  span.forEach((message, position) => {\n    const parts = position === 0 ? message.content.slice(startPart) : message.content;\n    for (const part of parts) {\n      for (const entry of partEntries(part)) {\n        if (entry.kind === 'asset') {\n          const known = assets.get(entry.asset.assetId);\n          if (!known) {\n            assets.set(entry.asset.assetId, entry.asset);\n          } else if (\n            (!known.title && entry.asset.title) ||\n            (!known.assetType && entry.asset.assetType)\n          ) {\n            // A later mention fills what the first one left out; the first keeps its place.\n            assets.set(entry.asset.assetId, {\n              ...known,\n              title: known.title || entry.asset.title,\n              assetType: known.assetType ?? entry.asset.assetType,\n              href: known.href ?? entry.asset.href,\n            });\n          }\n        } else if (entry.kind === 'link') {\n          if (!links.has(entry.link.key)) links.set(entry.link.key, entry.link);\n        } else if (!openToolCalls.has(entry.call.toolCallId)) {\n          openToolCalls.set(entry.call.toolCallId, entry.call);\n        }\n      }\n    }\n  });\n  const end = span[span.length - 1];\n  return {\n    endMessageId: end?.id ?? '',\n    trailing,\n    assets: [...assets.values()],\n    links: [...links.values()],\n    openToolCalls: [...openToolCalls.values()],\n  };\n}\n\n/**\n * The recap of the call stretch that ends at `messages[index]`, or `null` when\n * no call stretch ends there. Cheap for every other row (it looks at the next\n * message only); the same frozen object while the recap is unchanged, so it is\n * safe as a `useAuiState` selector result.\n */\nexport function callRecapAfter(\n  messages: readonly CallRecapMessage[],\n  index: number,\n): CallRecap | null {\n  const message = messages[index];\n  if (message === undefined) return null;\n  const next = messages[index + 1];\n  // Only a user message outside a call ends a stretch; an assistant message never does.\n  if (next !== undefined && (next.role !== 'user' || isCallUserMessage(next))) return null;\n\n  // Walk back over this stretch only: to the user message outside a call that opened it.\n  let start = -1;\n  let startPart = -1;\n  for (let position = index; position >= 0; position -= 1) {\n    const candidate = messages[position];\n    if (candidate === undefined) break;\n    const facts = messageFacts(candidate);\n    if (facts.breaksCall) break;\n    if (facts.callFrom >= 0) {\n      start = position;\n      startPart = facts.callFrom;\n    }\n  }\n  if (start < 0) return null;\n\n  const span = messages.slice(start, index + 1);\n  const trailing = next === undefined;\n  const memo = recapMemo.get(message);\n  if (\n    memo !== undefined &&\n    memo.startPart === startPart &&\n    memo.trailing === trailing &&\n    sameSpan(memo.span, span)\n  ) {\n    return memo.recap;\n  }\n  const recap = intern(buildRecap({ span, startPart, trailing }));\n  recapMemo.set(message, { span, startPart, trailing, recap });\n  return recap;\n}\n\n/** Whether a recap has anything to show once approvals are matched (see {@link callRecapItems}). */\nexport function callRecapHasItems(\n  recap: CallRecap,\n  awaitingApprovalToolCallIds: ReadonlySet<string> = EMPTY_IDS,\n): boolean {\n  return (\n    recap.assets.length > 0 ||\n    recap.links.length > 0 ||\n    recap.openToolCalls.some((call) => awaitingApprovalToolCallIds.has(call.toolCallId))\n  );\n}\n\nconst EMPTY_IDS: ReadonlySet<string> = new Set();\n\n/**\n * The card's items: the call's tool calls still waiting for the person's\n * approval (the host's live request names them), then its assets, then its\n * web links. Pure; hosts memoize it on the recap and the id set.\n */\nexport function callRecapItems(\n  recap: CallRecap,\n  awaitingApprovalToolCallIds: ReadonlySet<string> = EMPTY_IDS,\n): CallRecapItem[] {\n  const approvals: CallRecapApproval[] = recap.openToolCalls\n    .filter((call) => awaitingApprovalToolCallIds.has(call.toolCallId))\n    .map((call) => ({\n      kind: 'approval',\n      key: `approval:${call.toolCallId}`,\n      toolCallId: call.toolCallId,\n      toolName: call.toolName,\n    }));\n  return [...approvals, ...recap.assets, ...recap.links];\n}\n\n/** The card's heading, worded once for every app. */\nexport const CALL_RECAP_TITLE = 'From the call';\n\n/** An approval item's copy, worded once for every app. */\nexport const CALL_RECAP_APPROVAL_LABEL = 'Waiting for your approval';\n"],"names":["VOICE_SOURCE_SPOKEN","VOICE_SOURCE_TYPED","VOICE_SOURCE_DELEGATION","VOICE_DELEGATION_ID_PREFIX","isDeepAgentStateHydrated","readDeepAgentStreamValues","resultRecord","stringField","classifyToolResult","getExternalStoreMessages","isSpokenTurnTextPart","VOICE_UPDATE_TOOL_NAME"],"mappings":"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"}