@athenaintel/react 0.28.1 → 0.32.0

package/dist/chat/super-grouping/activity-timeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity-timeline.js","sources":["../../../src/chat/super-grouping/activity-timeline.ts"],"sourcesContent":["/**\n * The assistant turn's activity timeline — the one derivation of \"what did\n * this turn do, and how did each step end\" behind the grouped\n * (\"conversational\") view on every surface: the SDK's `AthenaChat`, Olympus's\n * Spaces chat, and the Chrome extension. Pure functions over assistant-ui\n * message parts; `SuperGroupingCard` renders them.\n *\n * Step states come from the shared classifier (`classifyToolResult`) plus the\n * approval outcomes a part carries (`approval`, `interrupt`, a rejection\n * result), so a call that reads as failed, paused, or rejected on one surface\n * cannot read as a green check on another. Copy comes from the shared tool\n * display registry (`toolStatusLabel`).\n */\nimport type {\n  MessageStatus,\n  ThreadAssistantMessagePart,\n  ToolCallMessagePartStatus,\n} from '@assistant-ui/react';\nimport {\n  classifyToolResult,\n  readRejectedToolResult,\n  type ToolStatusLabelState,\n  toolStatusLabel,\n} from '@athenaintel/agent-runtime';\nimport type { GroupingFunction } from './grouping-function';\n\nexport type ActivityToolState = ToolStatusLabelState;\n\nexport type ActivityItem =\n  | {\n      kind: 'reasoning';\n      id?: string;\n      text: string;\n      state: 'running' | 'complete';\n    }\n  | {\n      kind: 'tool';\n      id?: string;\n      toolName: string;\n      args?: ToolCallPart['args'];\n      state: ActivityToolState;\n    };\n\n/** The turn as a whole: still working, parked on the person, ended in error, or done. */\nexport type ActivityPhase = 'running' | 'waiting' | 'complete' | 'error';\n\ntype ToolCallPart = Extract<ThreadAssistantMessagePart, { type: 'tool-call' }>;\n\nexport interface ActivityTimelineOptions {\n  /**\n   * Tools whose unresolved call means the turn is waiting on the person even\n   * without an interrupt or approval on the part (the Chrome extension's\n   * device plan approval, which the tool UI itself collects).\n   */\n  waitingTools?: ReadonlySet<string>;\n  /**\n   * Tools whose result is an application payload relayed verbatim (the Chrome\n   * extension's page JavaScript), so a `success: false` flag counts only with\n   * an error detail — see `classifyToolResult`'s `passThroughPayload`.\n   */\n  passThroughTools?: ReadonlySet<string>;\n}\n\nconst NO_TOOLS: ReadonlySet<string> = new Set();\n\nfunction toolCallStatus(\n  part: ToolCallPart,\n  messageStatus: MessageStatus | undefined,\n): ToolCallMessagePartStatus | undefined {\n  if (part.result !== undefined) return { type: 'complete' };\n  if (messageStatus?.type === 'incomplete') {\n    return {\n      type: 'incomplete',\n      reason: messageStatus.reason === 'tool-calls' ? 'other' : messageStatus.reason,\n      error: messageStatus.error,\n    };\n  }\n  if (messageStatus?.type === 'complete') return { type: 'complete' };\n  if (messageStatus?.type === 'requires-action') {\n    return { type: 'requires-action', reason: messageStatus.reason };\n  }\n  if (messageStatus?.type === 'running') return { type: 'running' };\n  return undefined;\n}\n\n/** How one tool call ended (or is going), reading the approval fields before the result. */\nexport function getActivityToolState(\n  part: ToolCallPart,\n  messageStatus: MessageStatus | undefined,\n  { waitingTools = NO_TOOLS, passThroughTools = NO_TOOLS }: ActivityTimelineOptions = {},\n): ActivityToolState {\n  if (part.approval?.approved === false || readRejectedToolResult(part.result) !== null) {\n    return 'rejected';\n  }\n  if (part.approval?.resolution === 'cancelled' || part.approval?.resolution === 'expired') {\n    return 'cancelled';\n  }\n  const unresolved = part.result === undefined;\n  const messageIsActive =\n    messageStatus === undefined ||\n    messageStatus.type === 'running' ||\n    messageStatus.type === 'requires-action';\n  if (\n    unresolved &&\n    (part.interrupt?.type === 'human' ||\n      (part.approval !== undefined &&\n        part.approval.approved === undefined &&\n        part.approval.resolution === undefined) ||\n      (waitingTools.has(part.toolName) && messageIsActive))\n  ) {\n    return 'waiting';\n  }\n\n  const classification = classifyToolResult({\n    status: toolCallStatus(part, messageStatus),\n    result: part.result,\n    isError: part.isError,\n    passThroughPayload: passThroughTools.has(part.toolName),\n  });\n  if (classification.state === 'requires-action') return 'waiting';\n  return classification.state;\n}\n\n/**\n * The compact reasoning/tool timeline in the order the parts streamed.\n *\n * A reasoning part is still streaming only while it is the final part of a\n * running message — once any later part appears, the thought has settled.\n * Settled reasoning parts with no text are dropped so the list never shows an\n * empty thinking row.\n */\nexport function buildActivityTimeline(\n  content: readonly ThreadAssistantMessagePart[] | undefined,\n  messageStatus: MessageStatus | undefined,\n  options: ActivityTimelineOptions = {},\n): ActivityItem[] {\n  if (!content?.length) return [];\n\n  const lastPartIndex = content.length - 1;\n  const timeline: ActivityItem[] = [];\n  for (let index = 0; index < content.length; index += 1) {\n    const part = content[index];\n    if (part.type === 'tool-call') {\n      timeline.push({\n        kind: 'tool',\n        id: part.toolCallId,\n        args: part.args,\n        toolName: part.toolName,\n        state: getActivityToolState(part, messageStatus, options),\n      });\n      continue;\n    }\n    if (part.type !== 'reasoning') continue;\n\n    const text = typeof part.text === 'string' ? part.text : '';\n    const stillStreaming = messageStatus?.type === 'running' && index === lastPartIndex;\n    if (!stillStreaming && text.trim() === '') continue;\n    timeline.push({\n      kind: 'reasoning',\n      id: `reasoning-${index}`,\n      text,\n      state: stillStreaming ? 'running' : 'complete',\n    });\n  }\n  return timeline;\n}\n\n/** Number of tool calls in the timeline. */\nexport function countActivityTools(timeline: readonly ActivityItem[]): number {\n  return timeline.reduce((count, item) => (item.kind === 'tool' ? count + 1 : count), 0);\n}\n\n/**\n * The turn's phase. Waiting on the person wins over everything — a\n * `requires-action` status, a waiting tool, or a host's own `waitingForInput`\n * assertion (no in-repo host passes one) — then the message's own status.\n */\nexport function resolveActivityPhase(\n  status: MessageStatus | undefined,\n  timeline: readonly ActivityItem[],\n  { waitingForInput = false }: { waitingForInput?: boolean } = {},\n): ActivityPhase {\n  if (\n    waitingForInput ||\n    status?.type === 'requires-action' ||\n    timeline.some((item) => item.kind === 'tool' && item.state === 'waiting')\n  ) {\n    return 'waiting';\n  }\n  if (status?.type === 'running') return 'running';\n  if (status?.type === 'incomplete') return 'error';\n  return 'complete';\n}\n\n/**\n * The status-row copy for one step. `resolveToolDisplayName` lets a host with\n * a richer tool catalog name tools the shared registry has no entry for.\n */\nexport function getActivityItemLabel(\n  item: ActivityItem,\n  resolveToolDisplayName?: (toolName: string) => string | undefined,\n): string {\n  if (item.kind === 'reasoning') {\n    return item.state === 'running' ? 'Thinking' : 'Thought through the next step';\n  }\n  return toolStatusLabel(item.toolName, item.state, resolveToolDisplayName?.(item.toolName));\n}\n\n/** The collapsed-card summary of a finished turn. */\nexport function getActivitySummary(timeline: readonly ActivityItem[]): string {\n  const toolCount = countActivityTools(timeline);\n  const hasIssue = timeline.some(\n    (item) => item.kind === 'tool' && (item.state === 'error' || item.state === 'rejected'),\n  );\n  if (hasIssue) return 'Completed with issues';\n  if (timeline.some((item) => item.kind === 'tool' && item.state === 'cancelled')) {\n    return 'Action cancelled';\n  }\n  if (timeline.some((item) => item.kind === 'tool' && item.state === 'paused')) {\n    return 'Paused during tool use';\n  }\n  if (toolCount > 0) return `Used ${toolCount} ${toolCount === 1 ? 'tool' : 'tools'}`;\n  return 'Reasoning complete';\n}\n\n/** The part shape the final-text read needs; any message role's parts satisfy it. */\nexport type FinalTextPart = { readonly type: string; readonly text?: string };\n\n/**\n * The visible answer of a grouped turn: the text after the final tool call,\n * or all of it when the turn never called a tool. Intermediate text (before\n * or between tool calls) stays available in the details panel.\n */\nexport function getFinalText(content: readonly FinalTextPart[] | undefined): string | null {\n  if (!content?.length) return null;\n\n  let lastToolIndex = -1;\n  for (let index = content.length - 1; index >= 0; index -= 1) {\n    if (content[index]?.type === 'tool-call') {\n      lastToolIndex = index;\n      break;\n    }\n  }\n\n  const texts: string[] = [];\n  for (let index = lastToolIndex + 1; index < content.length; index += 1) {\n    const part = content[index];\n    if (part?.type === 'text' && part.text) texts.push(part.text);\n  }\n  return texts.length > 0 ? texts.join('\\n\\n') : null;\n}\n\n/**\n * Keep the final answer out of the details panel: it renders below the card\n * (`SuperGroupingFinalText`), so the details grouping drops every text part\n * after the last tool call and any group that becomes empty.\n */\nexport function excludeFinalTextFromGroups(grouping: GroupingFunction): GroupingFunction {\n  return (parts) => {\n    const lastToolIndex = parts.findLastIndex((part) => part?.type === 'tool-call');\n    return grouping(parts)\n      .map((group) => ({\n        ...group,\n        indices: group.indices.filter((index) => parts[index]?.type !== 'text' || index <= lastToolIndex),\n      }))\n      .filter((group) => group.indices.length > 0);\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"activity-timeline.js","sources":["../../../src/chat/super-grouping/activity-timeline.ts"],"sourcesContent":["/**\n * The assistant turn's activity timeline — the one derivation of \"what did\n * this turn do, and how did each step end\" behind the grouped\n * (\"conversational\") view on every surface: the SDK's `AthenaChat`, Olympus's\n * Spaces chat, and the Chrome extension. Pure functions over assistant-ui\n * message parts; `SuperGroupingCard` renders them.\n *\n * Step states come from the shared classifier (`classifyToolResult`) plus the\n * approval outcomes a part carries (`approval`, `interrupt`, a rejection\n * result), so a call that reads as failed, paused, or rejected on one surface\n * cannot read as a green check on another. Copy comes from the shared tool\n * summary registry (`summarizeToolCall`), itself built on the display\n * registry.\n */\nimport type {\n  MessageStatus,\n  ThreadAssistantMessagePart,\n  ToolCallMessagePartStatus,\n} from '@assistant-ui/react';\nimport {\n  classifyToolResult,\n  isSpokenTurnTextPart,\n  readRejectedToolResult,\n  type ToolStatusLabelState,\n} from '@athenaintel/agent-runtime';\nimport { summarizeToolCall, type ToolCallSummary } from '../../tools/tool-summary';\nimport type { GroupablePart, GroupingFunction } from './grouping-function';\n\nexport type ActivityToolState = ToolStatusLabelState;\n\nexport type ActivityItem =\n  | {\n      kind: 'reasoning';\n      id?: string;\n      /** Position of the part in the message's content. */\n      partIndex?: number;\n      text: string;\n      state: 'running' | 'complete';\n    }\n  | {\n      kind: 'tool';\n      id?: string;\n      /** Position of the part in the message's content. */\n      partIndex?: number;\n      toolName: string;\n      args?: ToolCallPart['args'];\n      /** The tool's real result; absent while it runs or holds only the streaming placeholder. */\n      result?: unknown;\n      state: ActivityToolState;\n    };\n\n/** The turn as a whole: still working, parked on the person, ended in error, or done. */\nexport type ActivityPhase = 'running' | 'waiting' | 'complete' | 'error';\n\ntype ToolCallPart = Extract<ThreadAssistantMessagePart, { type: 'tool-call' }>;\n\nexport interface ActivityTimelineOptions {\n  /**\n   * Tools whose unresolved call means the turn is waiting on the person even\n   * without an interrupt or approval on the part (the Chrome extension's\n   * device plan approval, which the tool UI itself collects).\n   */\n  waitingTools?: ReadonlySet<string>;\n  /**\n   * Tools whose result is an application payload relayed verbatim (the Chrome\n   * extension's page JavaScript), so a `success: false` flag counts only with\n   * an error detail — see `classifyToolResult`'s `passThroughPayload`.\n   */\n  passThroughTools?: ReadonlySet<string>;\n}\n\nconst NO_TOOLS: ReadonlySet<string> = new Set();\n\n/**\n * Whether a tool-call part still holds the backend's streaming placeholder\n * result rather than the tool's real output. Long-running tools (task\n * subagents, studio and Python execution, deep research) append a ToolMessage\n * the moment they start so their card can fill in live; it carries\n * `additional_kwargs.streaming`, which the runtime converter lifts into\n * `artifact._tool_message_metadata`. The real ToolMessage that replaces it\n * has no such flag, so a defined `result` alone does not mean the tool is done.\n */\nexport function isStreamingToolPlaceholder(part: Pick<ToolCallPart, 'artifact'>): boolean {\n  const artifact: unknown = part.artifact;\n  if (typeof artifact !== 'object' || artifact === null) return false;\n  const metadata: unknown = (artifact as { _tool_message_metadata?: unknown })\n    ._tool_message_metadata;\n  if (typeof metadata !== 'object' || metadata === null) return false;\n  return (metadata as { streaming?: unknown }).streaming === true;\n}\n\n/** The tool's real result: undefined while it has none or only the streaming placeholder. */\nfunction finalResult(part: ToolCallPart): unknown {\n  return isStreamingToolPlaceholder(part) ? undefined : part.result;\n}\n\nfunction toolCallStatus(\n  part: ToolCallPart,\n  messageStatus: MessageStatus | undefined,\n): ToolCallMessagePartStatus | undefined {\n  if (finalResult(part) !== undefined) return { type: 'complete' };\n  if (messageStatus?.type === 'incomplete') {\n    return {\n      type: 'incomplete',\n      reason: messageStatus.reason === 'tool-calls' ? 'other' : messageStatus.reason,\n      error: messageStatus.error,\n    };\n  }\n  if (messageStatus?.type === 'complete') return { type: 'complete' };\n  if (messageStatus?.type === 'requires-action') {\n    return { type: 'requires-action', reason: messageStatus.reason };\n  }\n  if (messageStatus?.type === 'running') return { type: 'running' };\n  return undefined;\n}\n\n/** How one tool call ended (or is going), reading the approval fields before the result. */\nexport function getActivityToolState(\n  part: ToolCallPart,\n  messageStatus: MessageStatus | undefined,\n  { waitingTools = NO_TOOLS, passThroughTools = NO_TOOLS }: ActivityTimelineOptions = {},\n): ActivityToolState {\n  if (part.approval?.approved === false || readRejectedToolResult(part.result) !== null) {\n    return 'rejected';\n  }\n  if (part.approval?.resolution === 'cancelled' || part.approval?.resolution === 'expired') {\n    return 'cancelled';\n  }\n  const result = finalResult(part);\n  const unresolved = result === undefined;\n  const messageIsActive =\n    messageStatus === undefined ||\n    messageStatus.type === 'running' ||\n    messageStatus.type === 'requires-action';\n  if (\n    unresolved &&\n    (part.interrupt?.type === 'human' ||\n      (part.approval !== undefined &&\n        part.approval.approved === undefined &&\n        part.approval.resolution === undefined) ||\n      (waitingTools.has(part.toolName) && messageIsActive))\n  ) {\n    return 'waiting';\n  }\n\n  const classification = classifyToolResult({\n    status: toolCallStatus(part, messageStatus),\n    result,\n    isError: part.isError,\n    passThroughPayload: passThroughTools.has(part.toolName),\n  });\n  if (classification.state === 'requires-action') return 'waiting';\n  return classification.state;\n}\n\n/**\n * The compact reasoning/tool timeline in the order the parts streamed.\n *\n * A reasoning part is still streaming only while it is the final part of a\n * running message — once any later part appears, the thought has settled.\n * Settled reasoning parts with no text are dropped so the list never shows an\n * empty thinking row.\n */\nexport function buildActivityTimeline(\n  content: readonly ThreadAssistantMessagePart[] | undefined,\n  messageStatus: MessageStatus | undefined,\n  options: ActivityTimelineOptions = {},\n): ActivityItem[] {\n  if (!content?.length) return [];\n\n  const lastPartIndex = content.length - 1;\n  const timeline: ActivityItem[] = [];\n  for (let index = 0; index < content.length; index += 1) {\n    const part = content[index];\n    if (part.type === 'tool-call') {\n      const result = finalResult(part);\n      timeline.push({\n        kind: 'tool',\n        id: part.toolCallId,\n        partIndex: index,\n        args: part.args,\n        ...(result !== undefined ? { result } : {}),\n        toolName: part.toolName,\n        state: getActivityToolState(part, messageStatus, options),\n      });\n      continue;\n    }\n    if (part.type !== 'reasoning') continue;\n\n    const text = typeof part.text === 'string' ? part.text : '';\n    const stillStreaming = messageStatus?.type === 'running' && index === lastPartIndex;\n    if (!stillStreaming && text.trim() === '') continue;\n    timeline.push({\n      kind: 'reasoning',\n      id: `reasoning-${index}`,\n      partIndex: index,\n      text,\n      state: stillStreaming ? 'running' : 'complete',\n    });\n  }\n  return timeline;\n}\n\n/** Number of tool calls in the timeline. */\nexport function countActivityTools(timeline: readonly ActivityItem[]): number {\n  return timeline.reduce((count, item) => (item.kind === 'tool' ? count + 1 : count), 0);\n}\n\n/**\n * The turn's phase. Waiting on the person wins over everything — a\n * `requires-action` status, a waiting tool, or a host's own `waitingForInput`\n * assertion (no in-repo host passes one) — then the message's own status.\n */\nexport function resolveActivityPhase(\n  status: MessageStatus | undefined,\n  timeline: readonly ActivityItem[],\n  { waitingForInput = false }: { waitingForInput?: boolean } = {},\n): ActivityPhase {\n  if (\n    waitingForInput ||\n    status?.type === 'requires-action' ||\n    timeline.some((item) => item.kind === 'tool' && item.state === 'waiting')\n  ) {\n    return 'waiting';\n  }\n  if (status?.type === 'running') return 'running';\n  if (status?.type === 'incomplete') return 'error';\n  return 'complete';\n}\n\n/**\n * A settled thought's row: the heading a reasoning summary opens with\n * (\"**Checking the workstation**\" → \"Checking the workstation\"), else the\n * generic wording. The thought itself stays in the run's details.\n */\nexport function getReasoningLabel(text: string, state: 'running' | 'complete'): string {\n  if (state === 'running') return 'Thinking';\n  const heading = /^\\s*\\*\\*([^*\\n]{3,80}?)\\*\\*/.exec(text)?.[1]?.trim();\n  return heading ? heading.replace(/[.:]+$/, '') : 'Thought through the next step';\n}\n\n/**\n * The status-row copy for one step: the call's own summary from the shared\n * summary registry (`summarizeToolCall`: \"Ran git status\", \"Read config.ts\").\n * `resolveToolDisplayName` lets a host with a richer tool catalog name tools\n * neither registry has an entry for; `assetTitles` names the machine or\n * document a call targeted by id when an earlier result in the turn did.\n */\nexport function getActivityItemLabel(\n  item: ActivityItem,\n  resolveToolDisplayName?: (toolName: string) => string | undefined,\n  assetTitles?: ReadonlyMap<string, string>,\n): string {\n  if (item.kind === 'reasoning') return getReasoningLabel(item.text, item.state);\n  return summarizeActivityTool(item, resolveToolDisplayName, assetTitles).label;\n}\n\n/** The summary of one tool step (see {@link getActivityItemLabel}). */\nexport function summarizeActivityTool(\n  item: Extract<ActivityItem, { kind: 'tool' }>,\n  resolveToolDisplayName?: (toolName: string) => string | undefined,\n  assetTitles?: ReadonlyMap<string, string>,\n): ToolCallSummary {\n  return summarizeToolCall({\n    toolName: item.toolName,\n    args: item.args,\n    result: item.result,\n    status: item.state,\n    ...(assetTitles ? { assetTitles } : {}),\n    ...(resolveToolDisplayName ? { displayName: resolveToolDisplayName(item.toolName) } : {}),\n  });\n}\n\n/** The collapsed-card summary of a finished turn. */\nexport function getActivitySummary(timeline: readonly ActivityItem[]): string {\n  const toolCount = countActivityTools(timeline);\n  const hasIssue = timeline.some(\n    (item) => item.kind === 'tool' && (item.state === 'error' || item.state === 'rejected'),\n  );\n  if (hasIssue) return 'Completed with issues';\n  if (timeline.some((item) => item.kind === 'tool' && item.state === 'cancelled')) {\n    return 'Action cancelled';\n  }\n  if (timeline.some((item) => item.kind === 'tool' && item.state === 'paused')) {\n    return 'Paused during tool use';\n  }\n  if (toolCount > 0) return `Used ${toolCount} ${toolCount === 1 ? 'tool' : 'tools'}`;\n  return 'Reasoning complete';\n}\n\n/** The part shape the final-text read needs; any message role's parts satisfy it. */\nexport type FinalTextPart = { readonly type: string; readonly text?: string };\n\n/**\n * Whether a text part shows below the card instead of in the details panel:\n * it comes after the final tool call, or it holds a spoken voice turn's words\n * (a live turn heard during a delegated run lands between the run's tool\n * calls, see `isSpokenTurnTextPart`; it is the conversation, not narration).\n */\nfunction isAnswerTextPart(\n  part: { readonly type: string } | undefined,\n  index: number,\n  lastToolIndex: number,\n): boolean {\n  return part?.type === 'text' && (index > lastToolIndex || isSpokenTurnTextPart(part));\n}\n\n/**\n * The visible answer of a grouped turn: the text after the final tool call\n * (all of it when the turn never called a tool), plus the words of every\n * spoken voice turn in the message, in order. Other intermediate text (before\n * or between tool calls) stays available in the details panel.\n */\nexport function getFinalText(content: readonly FinalTextPart[] | undefined): string | null {\n  const parts = getFinalTextParts(content);\n  return parts.length > 0 ? parts.map((part) => part.text).join('\\n\\n') : null;\n}\n\n/** One text part of the visible answer, with its index in the message content. */\nexport interface FinalTextSegment {\n  index: number;\n  text: string;\n}\n\n/**\n * The parts `getFinalText` joins, each kept separate with its content index.\n * A spoken turn and the run's own reply can stream at the same time, so the\n * earlier part may grow while a later one exists: rendered as one joined\n * string, that text changes in the middle rather than at its end, and the\n * streaming reveal restarts from an empty bubble on every word.\n */\nexport function getFinalTextParts(content: readonly FinalTextPart[] | undefined): FinalTextSegment[] {\n  if (!content?.length) return [];\n\n  const lastToolIndex = content.findLastIndex((part) => part?.type === 'tool-call');\n  const parts: FinalTextSegment[] = [];\n  content.forEach((part, index) => {\n    if (part.text && isAnswerTextPart(part, index, lastToolIndex)) parts.push({ index, text: part.text });\n  });\n  return parts;\n}\n\n/**\n * Keep the answer out of the details panel: it renders below the card\n * (`SuperGroupingFinalText`), so the details grouping drops every text part\n * `getFinalText` shows and any group that becomes empty.\n */\nexport function excludeFinalTextFromGroups(grouping: GroupingFunction): GroupingFunction {\n  return (parts) => {\n    const lastToolIndex = parts.findLastIndex((part) => part?.type === 'tool-call');\n    return grouping(parts)\n      .map((group) => ({\n        ...group,\n        indices: group.indices.filter((index) => !isAnswerTextPart(parts[index], index, lastToolIndex)),\n      }))\n      .filter((group) => group.indices.length > 0);\n  };\n}\n\n/**\n * Drop the parts `exclude` matches from every group, and any group left\n * empty: `SuperGroupingCard` renders inline tool calls outside the details,\n * so they must not render a second time inside it.\n */\nexport function excludePartsFromGroups(\n  grouping: GroupingFunction,\n  exclude: (part: GroupablePart) => boolean,\n): GroupingFunction {\n  return (parts) =>\n    grouping(parts)\n      .map((group) => ({\n        ...group,\n        indices: group.indices.filter((index) => {\n          const part = parts[index];\n          return part === undefined || !exclude(part);\n        }),\n      }))\n      .filter((group) => group.indices.length > 0);\n}\n"],"names":[],"mappings":";;;AAuEA,MAAM,+BAAoC,IAAA;AAWnC,SAAS,2BAA2B,MAA+C;AACxF,QAAM,WAAoB,KAAK;AAC/B,MAAI,OAAO,aAAa,YAAY,aAAa,KAAM,QAAO;AAC9D,QAAM,WAAqB,SACxB;AACH,MAAI,OAAO,aAAa,YAAY,aAAa,KAAM,QAAO;AAC9D,SAAQ,SAAqC,cAAc;AAC7D;AAGA,SAAS,YAAY,MAA6B;AAChD,SAAO,2BAA2B,IAAI,IAAI,SAAY,KAAK;AAC7D;AAEA,SAAS,eACP,MACA,eACuC;AACvC,MAAI,YAAY,IAAI,MAAM,OAAW,QAAO,EAAE,MAAM,WAAA;AACpD,OAAI,+CAAe,UAAS,cAAc;AACxC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,QAAQ,cAAc,WAAW,eAAe,UAAU,cAAc;AAAA,MACxE,OAAO,cAAc;AAAA,IAAA;AAAA,EAEzB;AACA,OAAI,+CAAe,UAAS,WAAY,QAAO,EAAE,MAAM,WAAA;AACvD,OAAI,+CAAe,UAAS,mBAAmB;AAC7C,WAAO,EAAE,MAAM,mBAAmB,QAAQ,cAAc,OAAA;AAAA,EAC1D;AACA,OAAI,+CAAe,UAAS,UAAW,QAAO,EAAE,MAAM,UAAA;AACtD,SAAO;AACT;AAGO,SAAS,qBACd,MACA,eACA,EAAE,eAAe,UAAU,mBAAmB,SAAA,IAAsC,IACjE;;AACnB,QAAI,UAAK,aAAL,mBAAe,cAAa,SAAS,uBAAuB,KAAK,MAAM,MAAM,MAAM;AACrF,WAAO;AAAA,EACT;AACA,QAAI,UAAK,aAAL,mBAAe,gBAAe,iBAAe,UAAK,aAAL,mBAAe,gBAAe,WAAW;AACxF,WAAO;AAAA,EACT;AACA,QAAM,SAAS,YAAY,IAAI;AAC/B,QAAM,aAAa,WAAW;AAC9B,QAAM,kBACJ,kBAAkB,UAClB,cAAc,SAAS,aACvB,cAAc,SAAS;AACzB,MACE,iBACC,UAAK,cAAL,mBAAgB,UAAS,WACvB,KAAK,aAAa,UACjB,KAAK,SAAS,aAAa,UAC3B,KAAK,SAAS,eAAe,UAC9B,aAAa,IAAI,KAAK,QAAQ,KAAK,kBACtC;AACA,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB,mBAAmB;AAAA,IACxC,QAAQ,eAAe,MAAM,aAAa;AAAA,IAC1C;AAAA,IACA,SAAS,KAAK;AAAA,IACd,oBAAoB,iBAAiB,IAAI,KAAK,QAAQ;AAAA,EAAA,CACvD;AACD,MAAI,eAAe,UAAU,kBAAmB,QAAO;AACvD,SAAO,eAAe;AACxB;AAUO,SAAS,sBACd,SACA,eACA,UAAmC,CAAA,GACnB;AAChB,MAAI,EAAC,mCAAS,QAAQ,QAAO,CAAA;AAE7B,QAAM,gBAAgB,QAAQ,SAAS;AACvC,QAAM,WAA2B,CAAA;AACjC,WAAS,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;AACtD,UAAM,OAAO,QAAQ,KAAK;AAC1B,QAAI,KAAK,SAAS,aAAa;AAC7B,YAAM,SAAS,YAAY,IAAI;AAC/B,eAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,IAAI,KAAK;AAAA,QACT,WAAW;AAAA,QACX,MAAM,KAAK;AAAA,QACX,GAAI,WAAW,SAAY,EAAE,OAAA,IAAW,CAAA;AAAA,QACxC,UAAU,KAAK;AAAA,QACf,OAAO,qBAAqB,MAAM,eAAe,OAAO;AAAA,MAAA,CACzD;AACD;AAAA,IACF;AACA,QAAI,KAAK,SAAS,YAAa;AAE/B,UAAM,OAAO,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO;AACzD,UAAM,kBAAiB,+CAAe,UAAS,aAAa,UAAU;AACtE,QAAI,CAAC,kBAAkB,KAAK,KAAA,MAAW,GAAI;AAC3C,aAAS,KAAK;AAAA,MACZ,MAAM;AAAA,MACN,IAAI,aAAa,KAAK;AAAA,MACtB,WAAW;AAAA,MACX;AAAA,MACA,OAAO,iBAAiB,YAAY;AAAA,IAAA,CACrC;AAAA,EACH;AACA,SAAO;AACT;AAGO,SAAS,mBAAmB,UAA2C;AAC5E,SAAO,SAAS,OAAO,CAAC,OAAO,SAAU,KAAK,SAAS,SAAS,QAAQ,IAAI,OAAQ,CAAC;AACvF;AAOO,SAAS,qBACd,QACA,UACA,EAAE,kBAAkB,MAAA,IAAyC,IAC9C;AACf,MACE,oBACA,iCAAQ,UAAS,qBACjB,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU,SAAS,GACxE;AACA,WAAO;AAAA,EACT;AACA,OAAI,iCAAQ,UAAS,UAAW,QAAO;AACvC,OAAI,iCAAQ,UAAS,aAAc,QAAO;AAC1C,SAAO;AACT;AAOO,SAAS,kBAAkB,MAAc,OAAuC;;AACrF,MAAI,UAAU,UAAW,QAAO;AAChC,QAAM,WAAU,yCAA8B,KAAK,IAAI,MAAvC,mBAA2C,OAA3C,mBAA+C;AAC/D,SAAO,UAAU,QAAQ,QAAQ,UAAU,EAAE,IAAI;AACnD;AASO,SAAS,qBACd,MACA,wBACA,aACQ;AACR,MAAI,KAAK,SAAS,YAAa,QAAO,kBAAkB,KAAK,MAAM,KAAK,KAAK;AAC7E,SAAO,sBAAsB,MAAM,wBAAwB,WAAW,EAAE;AAC1E;AAGO,SAAS,sBACd,MACA,wBACA,aACiB;AACjB,SAAO,kBAAkB;AAAA,IACvB,UAAU,KAAK;AAAA,IACf,MAAM,KAAK;AAAA,IACX,QAAQ,KAAK;AAAA,IACb,QAAQ,KAAK;AAAA,IACb,GAAI,cAAc,EAAE,YAAA,IAAgB,CAAA;AAAA,IACpC,GAAI,yBAAyB,EAAE,aAAa,uBAAuB,KAAK,QAAQ,MAAM,CAAA;AAAA,EAAC,CACxF;AACH;AAGO,SAAS,mBAAmB,UAA2C;AAC5E,QAAM,YAAY,mBAAmB,QAAQ;AAC7C,QAAM,WAAW,SAAS;AAAA,IACxB,CAAC,SAAS,KAAK,SAAS,WAAW,KAAK,UAAU,WAAW,KAAK,UAAU;AAAA,EAAA;AAE9E,MAAI,SAAU,QAAO;AACrB,MAAI,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU,WAAW,GAAG;AAC/E,WAAO;AAAA,EACT;AACA,MAAI,SAAS,KAAK,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU,QAAQ,GAAG;AAC5E,WAAO;AAAA,EACT;AACA,MAAI,YAAY,EAAG,QAAO,QAAQ,SAAS,IAAI,cAAc,IAAI,SAAS,OAAO;AACjF,SAAO;AACT;AAWA,SAAS,iBACP,MACA,OACA,eACS;AACT,UAAO,6BAAM,UAAS,WAAW,QAAQ,iBAAiB,qBAAqB,IAAI;AACrF;AAQO,SAAS,aAAa,SAA8D;AACzF,QAAM,QAAQ,kBAAkB,OAAO;AACvC,SAAO,MAAM,SAAS,IAAI,MAAM,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,KAAK,MAAM,IAAI;AAC1E;AAeO,SAAS,kBAAkB,SAAmE;AACnG,MAAI,EAAC,mCAAS,QAAQ,QAAO,CAAA;AAE7B,QAAM,gBAAgB,QAAQ,cAAc,CAAC,UAAS,6BAAM,UAAS,WAAW;AAChF,QAAM,QAA4B,CAAA;AAClC,UAAQ,QAAQ,CAAC,MAAM,UAAU;AAC/B,QAAI,KAAK,QAAQ,iBAAiB,MAAM,OAAO,aAAa,EAAG,OAAM,KAAK,EAAE,OAAO,MAAM,KAAK,MAAM;AAAA,EACtG,CAAC;AACD,SAAO;AACT;AAOO,SAAS,2BAA2B,UAA8C;AACvF,SAAO,CAAC,UAAU;AAChB,UAAM,gBAAgB,MAAM,cAAc,CAAC,UAAS,6BAAM,UAAS,WAAW;AAC9E,WAAO,SAAS,KAAK,EAClB,IAAI,CAAC,WAAW;AAAA,MACf,GAAG;AAAA,MACH,SAAS,MAAM,QAAQ,OAAO,CAAC,UAAU,CAAC,iBAAiB,MAAM,KAAK,GAAG,OAAO,aAAa,CAAC;AAAA,IAAA,EAC9F,EACD,OAAO,CAAC,UAAU,MAAM,QAAQ,SAAS,CAAC;AAAA,EAC/C;AACF;AAOO,SAAS,uBACd,UACA,SACkB;AAClB,SAAO,CAAC,UACN,SAAS,KAAK,EACX,IAAI,CAAC,WAAW;AAAA,IACf,GAAG;AAAA,IACH,SAAS,MAAM,QAAQ,OAAO,CAAC,UAAU;AACvC,YAAM,OAAO,MAAM,KAAK;AACxB,aAAO,SAAS,UAAa,CAAC,QAAQ,IAAI;AAAA,IAC5C,CAAC;AAAA,EAAA,EACD,EACD,OAAO,CAAC,UAAU,MAAM,QAAQ,SAAS,CAAC;AACjD;"}

package/dist/chat/super-grouping/index.cjs

@@ -4,14 +4,21 @@ const activityTimeline = require("./activity-timeline.cjs");
 const CollapsibleGroup = require("./CollapsibleGroup.cjs");
 const groupingFunction = require("./grouping-function.cjs");
 const SuperGroupingCard = require("./SuperGroupingCard.cjs");
+const SuperGroupingTranscript = require("./SuperGroupingTranscript.cjs");
+const turnSegments = require("./turn-segments.cjs");
+const turnTiming = require("./turn-timing.cjs");
 const toolkitMap = require("./toolkit-map.cjs");
 exports.buildActivityTimeline = activityTimeline.buildActivityTimeline;
 exports.countActivityTools = activityTimeline.countActivityTools;
 exports.excludeFinalTextFromGroups = activityTimeline.excludeFinalTextFromGroups;
+exports.excludePartsFromGroups = activityTimeline.excludePartsFromGroups;
 exports.getActivityItemLabel = activityTimeline.getActivityItemLabel;
 exports.getActivitySummary = activityTimeline.getActivitySummary;
 exports.getActivityToolState = activityTimeline.getActivityToolState;
 exports.getFinalText = activityTimeline.getFinalText;
+exports.getFinalTextParts = activityTimeline.getFinalTextParts;
+exports.getReasoningLabel = activityTimeline.getReasoningLabel;
+exports.isStreamingToolPlaceholder = activityTimeline.isStreamingToolPlaceholder;
 exports.resolveActivityPhase = activityTimeline.resolveActivityPhase;
 exports.CollapsibleGroup = CollapsibleGroup.CollapsibleGroup;
 exports.DEFAULT_TOOLKIT_THEME = CollapsibleGroup.DEFAULT_TOOLKIT_THEME;
@@ -22,5 +29,12 @@ exports.SuperGroupingCard = SuperGroupingCard.SuperGroupingCard;
 exports.SuperGroupingFinalText = SuperGroupingCard.SuperGroupingFinalText;
 exports.resetRememberedExpansionsForTests = SuperGroupingCard.resetRememberedExpansionsForTests;
 exports.useActivityExpansion = SuperGroupingCard.useActivityExpansion;
+exports.SuperGroupingTranscript = SuperGroupingTranscript.SuperGroupingTranscript;
+exports.scopeGroupingToSegment = turnSegments.scopeGroupingToSegment;
+exports.splitTurnSegments = turnSegments.splitTurnSegments;
+exports.summarizeSegment = turnSegments.summarizeSegment;
+exports.formatWorkDuration = turnTiming.formatWorkDuration;
+exports.readTurnTiming = turnTiming.readTurnTiming;
+exports.workedDurationMs = turnTiming.workedDurationMs;
 exports.defaultGetToolGroupKey = toolkitMap.defaultGetToolGroupKey;
 //# sourceMappingURL=index.cjs.map

package/dist/chat/super-grouping/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/chat/super-grouping/index.d.ts

@@ -1,12 +1,17 @@
 /**
  * `@athenaintel/react/super-grouping` — the grouped ("conversational") view of
  * an assistant turn: the activity card, its per-toolkit collapsible blocks,
- * the timeline derivation behind them, and the tool-based grouping function.
+ * the timeline derivation behind them, the tool-based grouping function, and
+ * the transcript layout (the agent's sentences in order with the work between
+ * them folded, under a "Working for …" header).
  * A lean entry so hosts with their own thread (Olympus, the Chrome extension)
  * mount it from source without the SDK's composer stack.
  */
-export { type ActivityItem, type ActivityPhase, type ActivityTimelineOptions, type ActivityToolState, buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, type FinalTextPart, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, resolveActivityPhase, } from './activity-timeline';
+export { type ActivityItem, type ActivityPhase, type ActivityTimelineOptions, type ActivityToolState, buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, excludePartsFromGroups, type FinalTextPart, type FinalTextSegment, getActivityItemLabel, getActivitySummary, getReasoningLabel, getActivityToolState, isStreamingToolPlaceholder, getFinalText, getFinalTextParts, resolveActivityPhase, } from './activity-timeline';
 export { CollapsibleGroup, type CollapsibleGroupProps, DEFAULT_TOOLKIT_THEME, SuperGroupingProvider, TOOLKIT_THEMES, type ToolkitTheme, } from './CollapsibleGroup';
 export { createToolBasedGroupingFunction, type GroupablePart, type GroupingFunction, type MessagePartGroup, } from './grouping-function';
 export { resetRememberedExpansionsForTests, SuperGroupingCard, type SuperGroupingCardProps, SuperGroupingFinalText, useActivityExpansion, } from './SuperGroupingCard';
+export { SuperGroupingTranscript, type SuperGroupingTranscriptProps } from './SuperGroupingTranscript';
+export { scopeGroupingToSegment, type SegmentablePart, type SegmentSummary, splitTurnSegments, summarizeSegment, type TurnSegment, } from './turn-segments';
+export { formatWorkDuration, readTurnTiming, type TurnTiming, type TurnTimingSources, workedDurationMs, } from './turn-timing';
 export { defaultGetToolGroupKey, type GetToolGroupKey, type ToolGroupKeyOptions } from './toolkit-map';

package/dist/chat/super-grouping/index.js

@@ -1,7 +1,10 @@
-import { buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, resolveActivityPhase } from "./activity-timeline.js";
+import { buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, excludePartsFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, isStreamingToolPlaceholder, resolveActivityPhase } from "./activity-timeline.js";
 import { CollapsibleGroup, DEFAULT_TOOLKIT_THEME, SuperGroupingProvider, TOOLKIT_THEMES } from "./CollapsibleGroup.js";
 import { createToolBasedGroupingFunction } from "./grouping-function.js";
 import { SuperGroupingCard, SuperGroupingFinalText, resetRememberedExpansionsForTests, useActivityExpansion } from "./SuperGroupingCard.js";
+import { SuperGroupingTranscript } from "./SuperGroupingTranscript.js";
+import { scopeGroupingToSegment, splitTurnSegments, summarizeSegment } from "./turn-segments.js";
+import { formatWorkDuration, readTurnTiming, workedDurationMs } from "./turn-timing.js";
 import { defaultGetToolGroupKey } from "./toolkit-map.js";
 export {
   CollapsibleGroup,
@@ -9,18 +12,29 @@ export {
   SuperGroupingCard,
   SuperGroupingFinalText,
   SuperGroupingProvider,
+  SuperGroupingTranscript,
   TOOLKIT_THEMES,
   buildActivityTimeline,
   countActivityTools,
   createToolBasedGroupingFunction,
   defaultGetToolGroupKey,
   excludeFinalTextFromGroups,
+  excludePartsFromGroups,
+  formatWorkDuration,
   getActivityItemLabel,
   getActivitySummary,
   getActivityToolState,
   getFinalText,
+  getFinalTextParts,
+  getReasoningLabel,
+  isStreamingToolPlaceholder,
+  readTurnTiming,
   resetRememberedExpansionsForTests,
   resolveActivityPhase,
-  useActivityExpansion
+  scopeGroupingToSegment,
+  splitTurnSegments,
+  summarizeSegment,
+  useActivityExpansion,
+  workedDurationMs
 };
 //# sourceMappingURL=index.js.map

package/dist/chat/super-grouping/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/chat/super-grouping/timeline-step.cjs

@@ -29,14 +29,23 @@ function pageTarget(value) {
 function toTimelineStep({
   item,
   index,
-  resolveToolDisplayName
+  resolveToolDisplayName,
+  assetTitles
 }) {
+  const id = item.id ?? `${item.kind}-${index}`;
+  if (item.kind !== "tool") {
+    return { id, verb: activityTimeline.getReasoningLabel(item.text, item.state), state: item.state, kind: item.kind };
+  }
+  const summary = activityTimeline.summarizeActivityTool(item, resolveToolDisplayName, assetTitles);
   const step = {
-    id: item.id ?? `${item.kind}-${index}`,
-    verb: activityTimeline.getActivityItemLabel(item, resolveToolDisplayName),
-    state: item.state
+    id,
+    verb: summary.label,
+    ...summary.code ? { code: summary.code } : {},
+    ...summary.detail ? { detail: summary.detail } : {},
+    ...summary.meta ? { chip: summary.meta } : {},
+    state: item.state,
+    kind: item.kind
   };
-  if (item.kind !== "tool") return step;
   const args = item.args;
   if (!args || !item.toolName.startsWith("chrome_")) return step;
   const tabId = args.tabId ?? args.tab_id;

package/dist/chat/super-grouping/timeline-step.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-step.cjs","sources":["../../../src/chat/super-grouping/timeline-step.ts"],"sourcesContent":["import { type ActivityItem, getActivityItemLabel } from './activity-timeline';\n\nexport interface TimelineStep {\n  id: string;\n  verb: string;\n  chip?: string;\n  state: ActivityItem['state'];\n}\n\nconst COMPUTER_ACTIONS: Record<string, readonly [string, string]> = {\n  screenshot: ['Taking screenshot', 'Took screenshot'],\n  left_click: ['Clicking', 'Clicked'],\n  right_click: ['Right-clicking', 'Right-clicked'],\n  double_click: ['Double-clicking', 'Double-clicked'],\n  triple_click: ['Triple-clicking', 'Triple-clicked'],\n  type: ['Typing', 'Typed'],\n  key: ['Pressing keys', 'Pressed keys'],\n  scroll: ['Scrolling', 'Scrolled'],\n  scroll_to: ['Scrolling to element', 'Scrolled to element'],\n  zoom: ['Zooming', 'Zoomed'],\n  hover: ['Hovering', 'Hovered'],\n  left_click_drag: ['Dragging', 'Dragged'],\n  wait: ['Waiting', 'Waited'],\n};\n\n/** Keep credentials, query strings, fragments, and typed input out of summary chips. */\nfunction pageTarget(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  try {\n    const url = new URL(value);\n    if (url.protocol !== 'http:' && url.protocol !== 'https:') return undefined;\n    return url.hostname;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function toTimelineStep({\n  item,\n  index,\n  resolveToolDisplayName,\n}: {\n  item: ActivityItem;\n  index: number;\n  resolveToolDisplayName?: (toolName: string) => string | undefined;\n}): TimelineStep {\n  const step: TimelineStep = {\n    id: item.id ?? `${item.kind}-${index}`,\n    verb: getActivityItemLabel(item, resolveToolDisplayName),\n    state: item.state,\n  };\n  if (item.kind !== 'tool') return step;\n  const args = item.args;\n  if (!args || !item.toolName.startsWith('chrome_')) return step;\n\n  const tabId = args.tabId ?? args.tab_id;\n  step.chip = pageTarget(args.url) ?? (typeof tabId === 'number' ? `Tab ${tabId}` : undefined);\n  // Only successful/live actions get action-specific tense. Failure, rejection,\n  // cancellation and approval copy continues to come from the shared classifier.\n  if (item.state !== 'running' && item.state !== 'complete') return step;\n  if (item.toolName === 'chrome_computer' && typeof args.action === 'string') {\n    const action = COMPUTER_ACTIONS[args.action];\n    if (action) step.verb = action[item.state === 'running' ? 0 : 1];\n  } else if (item.toolName === 'chrome_navigate') {\n    step.verb = item.state === 'running' ? 'Navigating to' : 'Navigated to';\n  } else if (item.toolName === 'chrome_batch' && Array.isArray(args.steps)) {\n    const count = args.steps.length;\n    step.verb = item.state === 'running' ? 'Running Chrome actions' : 'Completed Chrome actions';\n    step.chip = `${count} ${count === 1 ? 'action' : 'actions'}`;\n  }\n  return step;\n}\n\n/** Every unresolved parallel call stays visible even when older settled steps fold away. */\nexport function visibleTimelineSteps({ steps, limit }: { steps: readonly TimelineStep[]; limit: number }) {\n  const safeLimit = Number.isFinite(limit) ? Math.max(1, Math.floor(limit)) : 3;\n  return steps.filter(\n    (step, index) =>\n      index >= steps.length - safeLimit || step.state === 'running' || step.state === 'waiting',\n  );\n}\n"],"names":["getActivityItemLabel"],"mappings":";;;AASA,MAAM,mBAA8D;AAAA,EAClE,YAAY,CAAC,qBAAqB,iBAAiB;AAAA,EACnD,YAAY,CAAC,YAAY,SAAS;AAAA,EAClC,aAAa,CAAC,kBAAkB,eAAe;AAAA,EAC/C,cAAc,CAAC,mBAAmB,gBAAgB;AAAA,EAClD,cAAc,CAAC,mBAAmB,gBAAgB;AAAA,EAClD,MAAM,CAAC,UAAU,OAAO;AAAA,EACxB,KAAK,CAAC,iBAAiB,cAAc;AAAA,EACrC,QAAQ,CAAC,aAAa,UAAU;AAAA,EAChC,WAAW,CAAC,wBAAwB,qBAAqB;AAAA,EACzD,MAAM,CAAC,WAAW,QAAQ;AAAA,EAC1B,OAAO,CAAC,YAAY,SAAS;AAAA,EAC7B,iBAAiB,CAAC,YAAY,SAAS;AAAA,EACvC,MAAM,CAAC,WAAW,QAAQ;AAC5B;AAGA,SAAS,WAAW,OAAoC;AACtD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,KAAK;AACzB,QAAI,IAAI,aAAa,WAAW,IAAI,aAAa,SAAU,QAAO;AAClE,WAAO,IAAI;AAAA,EACb,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AACF,GAIiB;AACf,QAAM,OAAqB;AAAA,IACzB,IAAI,KAAK,MAAM,GAAG,KAAK,IAAI,IAAI,KAAK;AAAA,IACpC,MAAMA,iBAAAA,qBAAqB,MAAM,sBAAsB;AAAA,IACvD,OAAO,KAAK;AAAA,EAAA;AAEd,MAAI,KAAK,SAAS,OAAQ,QAAO;AACjC,QAAM,OAAO,KAAK;AAClB,MAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,WAAW,SAAS,EAAG,QAAO;AAE1D,QAAM,QAAQ,KAAK,SAAS,KAAK;AACjC,OAAK,OAAO,WAAW,KAAK,GAAG,MAAM,OAAO,UAAU,WAAW,OAAO,KAAK,KAAK;AAGlF,MAAI,KAAK,UAAU,aAAa,KAAK,UAAU,WAAY,QAAO;AAClE,MAAI,KAAK,aAAa,qBAAqB,OAAO,KAAK,WAAW,UAAU;AAC1E,UAAM,SAAS,iBAAiB,KAAK,MAAM;AAC3C,QAAI,aAAa,OAAO,OAAO,KAAK,UAAU,YAAY,IAAI,CAAC;AAAA,EACjE,WAAW,KAAK,aAAa,mBAAmB;AAC9C,SAAK,OAAO,KAAK,UAAU,YAAY,kBAAkB;AAAA,EAC3D,WAAW,KAAK,aAAa,kBAAkB,MAAM,QAAQ,KAAK,KAAK,GAAG;AACxE,UAAM,QAAQ,KAAK,MAAM;AACzB,SAAK,OAAO,KAAK,UAAU,YAAY,2BAA2B;AAClE,SAAK,OAAO,GAAG,KAAK,IAAI,UAAU,IAAI,WAAW,SAAS;AAAA,EAC5D;AACA,SAAO;AACT;AAGO,SAAS,qBAAqB,EAAE,OAAO,SAA4D;AACxG,QAAM,YAAY,OAAO,SAAS,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC,IAAI;AAC5E,SAAO,MAAM;AAAA,IACX,CAAC,MAAM,UACL,SAAS,MAAM,SAAS,aAAa,KAAK,UAAU,aAAa,KAAK,UAAU;AAAA,EAAA;AAEtF;;;"}
+{"version":3,"file":"timeline-step.cjs","sources":["../../../src/chat/super-grouping/timeline-step.ts"],"sourcesContent":["import { type ActivityItem, getReasoningLabel, summarizeActivityTool } from './activity-timeline';\n\nexport interface TimelineStep {\n  id: string;\n  /** The row's line (\"Ran git status\"); `code` marks the literal part of it. */\n  verb: string;\n  /** The span of `verb` that is literal code (a command, a file name, a pattern). */\n  code?: string;\n  /** Longer form for the row's tooltip (the full path, the whole command line). */\n  detail?: string;\n  /** A short chip after the line (\"+4 −1\", \"on jevin-box\", \"Tab 7\"). */\n  chip?: string;\n  state: ActivityItem['state'];\n  kind: ActivityItem['kind'];\n}\n\nconst COMPUTER_ACTIONS: Record<string, readonly [string, string]> = {\n  screenshot: ['Taking screenshot', 'Took screenshot'],\n  left_click: ['Clicking', 'Clicked'],\n  right_click: ['Right-clicking', 'Right-clicked'],\n  double_click: ['Double-clicking', 'Double-clicked'],\n  triple_click: ['Triple-clicking', 'Triple-clicked'],\n  type: ['Typing', 'Typed'],\n  key: ['Pressing keys', 'Pressed keys'],\n  scroll: ['Scrolling', 'Scrolled'],\n  scroll_to: ['Scrolling to element', 'Scrolled to element'],\n  zoom: ['Zooming', 'Zoomed'],\n  hover: ['Hovering', 'Hovered'],\n  left_click_drag: ['Dragging', 'Dragged'],\n  wait: ['Waiting', 'Waited'],\n};\n\n/** Keep credentials, query strings, fragments, and typed input out of summary chips. */\nfunction pageTarget(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  try {\n    const url = new URL(value);\n    if (url.protocol !== 'http:' && url.protocol !== 'https:') return undefined;\n    return url.hostname;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function toTimelineStep({\n  item,\n  index,\n  resolveToolDisplayName,\n  assetTitles,\n}: {\n  item: ActivityItem;\n  index: number;\n  resolveToolDisplayName?: (toolName: string) => string | undefined;\n  /** Titles for asset ids earlier results in the turn named (see `collectAssetTitles`). */\n  assetTitles?: ReadonlyMap<string, string>;\n}): TimelineStep {\n  const id = item.id ?? `${item.kind}-${index}`;\n  if (item.kind !== 'tool') {\n    return { id, verb: getReasoningLabel(item.text, item.state), state: item.state, kind: item.kind };\n  }\n  const summary = summarizeActivityTool(item, resolveToolDisplayName, assetTitles);\n  const step: TimelineStep = {\n    id,\n    verb: summary.label,\n    ...(summary.code ? { code: summary.code } : {}),\n    ...(summary.detail ? { detail: summary.detail } : {}),\n    ...(summary.meta ? { chip: summary.meta } : {}),\n    state: item.state,\n    kind: item.kind,\n  };\n  const args = item.args;\n  if (!args || !item.toolName.startsWith('chrome_')) return step;\n\n  const tabId = args.tabId ?? args.tab_id;\n  step.chip = pageTarget(args.url) ?? (typeof tabId === 'number' ? `Tab ${tabId}` : undefined);\n  // Only successful/live actions get action-specific tense. Failure, rejection,\n  // cancellation and approval copy continues to come from the shared classifier.\n  if (item.state !== 'running' && item.state !== 'complete') return step;\n  if (item.toolName === 'chrome_computer' && typeof args.action === 'string') {\n    const action = COMPUTER_ACTIONS[args.action];\n    if (action) step.verb = action[item.state === 'running' ? 0 : 1];\n  } else if (item.toolName === 'chrome_navigate') {\n    step.verb = item.state === 'running' ? 'Navigating to' : 'Navigated to';\n  } else if (item.toolName === 'chrome_batch' && Array.isArray(args.steps)) {\n    const count = args.steps.length;\n    step.verb = item.state === 'running' ? 'Running Chrome actions' : 'Completed Chrome actions';\n    step.chip = `${count} ${count === 1 ? 'action' : 'actions'}`;\n  }\n  return step;\n}\n\n/** Every unresolved parallel call stays visible even when older settled steps fold away. */\nexport function visibleTimelineSteps({ steps, limit }: { steps: readonly TimelineStep[]; limit: number }) {\n  const safeLimit = Number.isFinite(limit) ? Math.max(1, Math.floor(limit)) : 3;\n  return steps.filter(\n    (step, index) =>\n      index >= steps.length - safeLimit || step.state === 'running' || step.state === 'waiting',\n  );\n}\n"],"names":["getReasoningLabel","summarizeActivityTool"],"mappings":"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"}

package/dist/chat/super-grouping/timeline-step.d.ts

@@ -1,14 +1,23 @@
 import { type ActivityItem } from './activity-timeline';
 export interface TimelineStep {
     id: string;
+    /** The row's line ("Ran git status"); `code` marks the literal part of it. */
     verb: string;
+    /** The span of `verb` that is literal code (a command, a file name, a pattern). */
+    code?: string;
+    /** Longer form for the row's tooltip (the full path, the whole command line). */
+    detail?: string;
+    /** A short chip after the line ("+4 −1", "on jevin-box", "Tab 7"). */
     chip?: string;
     state: ActivityItem['state'];
+    kind: ActivityItem['kind'];
 }
-export declare function toTimelineStep({ item, index, resolveToolDisplayName, }: {
+export declare function toTimelineStep({ item, index, resolveToolDisplayName, assetTitles, }: {
     item: ActivityItem;
     index: number;
     resolveToolDisplayName?: (toolName: string) => string | undefined;
+    /** Titles for asset ids earlier results in the turn named (see `collectAssetTitles`). */
+    assetTitles?: ReadonlyMap<string, string>;
 }): TimelineStep;
 /** Every unresolved parallel call stays visible even when older settled steps fold away. */
 export declare function visibleTimelineSteps({ steps, limit }: {

package/dist/chat/super-grouping/timeline-step.js

@@ -1,4 +1,4 @@
-import { getActivityItemLabel } from "./activity-timeline.js";
+import { getReasoningLabel, summarizeActivityTool } from "./activity-timeline.js";
 const COMPUTER_ACTIONS = {
   screenshot: ["Taking screenshot", "Took screenshot"],
   left_click: ["Clicking", "Clicked"],
@@ -27,14 +27,23 @@ function pageTarget(value) {
 function toTimelineStep({
   item,
   index,
-  resolveToolDisplayName
+  resolveToolDisplayName,
+  assetTitles
 }) {
+  const id = item.id ?? `${item.kind}-${index}`;
+  if (item.kind !== "tool") {
+    return { id, verb: getReasoningLabel(item.text, item.state), state: item.state, kind: item.kind };
+  }
+  const summary = summarizeActivityTool(item, resolveToolDisplayName, assetTitles);
   const step = {
-    id: item.id ?? `${item.kind}-${index}`,
-    verb: getActivityItemLabel(item, resolveToolDisplayName),
-    state: item.state
+    id,
+    verb: summary.label,
+    ...summary.code ? { code: summary.code } : {},
+    ...summary.detail ? { detail: summary.detail } : {},
+    ...summary.meta ? { chip: summary.meta } : {},
+    state: item.state,
+    kind: item.kind
   };
-  if (item.kind !== "tool") return step;
   const args = item.args;
   if (!args || !item.toolName.startsWith("chrome_")) return step;
   const tabId = args.tabId ?? args.tab_id;

package/dist/chat/super-grouping/timeline-step.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-step.js","sources":["../../../src/chat/super-grouping/timeline-step.ts"],"sourcesContent":["import { type ActivityItem, getActivityItemLabel } from './activity-timeline';\n\nexport interface TimelineStep {\n  id: string;\n  verb: string;\n  chip?: string;\n  state: ActivityItem['state'];\n}\n\nconst COMPUTER_ACTIONS: Record<string, readonly [string, string]> = {\n  screenshot: ['Taking screenshot', 'Took screenshot'],\n  left_click: ['Clicking', 'Clicked'],\n  right_click: ['Right-clicking', 'Right-clicked'],\n  double_click: ['Double-clicking', 'Double-clicked'],\n  triple_click: ['Triple-clicking', 'Triple-clicked'],\n  type: ['Typing', 'Typed'],\n  key: ['Pressing keys', 'Pressed keys'],\n  scroll: ['Scrolling', 'Scrolled'],\n  scroll_to: ['Scrolling to element', 'Scrolled to element'],\n  zoom: ['Zooming', 'Zoomed'],\n  hover: ['Hovering', 'Hovered'],\n  left_click_drag: ['Dragging', 'Dragged'],\n  wait: ['Waiting', 'Waited'],\n};\n\n/** Keep credentials, query strings, fragments, and typed input out of summary chips. */\nfunction pageTarget(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  try {\n    const url = new URL(value);\n    if (url.protocol !== 'http:' && url.protocol !== 'https:') return undefined;\n    return url.hostname;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function toTimelineStep({\n  item,\n  index,\n  resolveToolDisplayName,\n}: {\n  item: ActivityItem;\n  index: number;\n  resolveToolDisplayName?: (toolName: string) => string | undefined;\n}): TimelineStep {\n  const step: TimelineStep = {\n    id: item.id ?? `${item.kind}-${index}`,\n    verb: getActivityItemLabel(item, resolveToolDisplayName),\n    state: item.state,\n  };\n  if (item.kind !== 'tool') return step;\n  const args = item.args;\n  if (!args || !item.toolName.startsWith('chrome_')) return step;\n\n  const tabId = args.tabId ?? args.tab_id;\n  step.chip = pageTarget(args.url) ?? (typeof tabId === 'number' ? `Tab ${tabId}` : undefined);\n  // Only successful/live actions get action-specific tense. Failure, rejection,\n  // cancellation and approval copy continues to come from the shared classifier.\n  if (item.state !== 'running' && item.state !== 'complete') return step;\n  if (item.toolName === 'chrome_computer' && typeof args.action === 'string') {\n    const action = COMPUTER_ACTIONS[args.action];\n    if (action) step.verb = action[item.state === 'running' ? 0 : 1];\n  } else if (item.toolName === 'chrome_navigate') {\n    step.verb = item.state === 'running' ? 'Navigating to' : 'Navigated to';\n  } else if (item.toolName === 'chrome_batch' && Array.isArray(args.steps)) {\n    const count = args.steps.length;\n    step.verb = item.state === 'running' ? 'Running Chrome actions' : 'Completed Chrome actions';\n    step.chip = `${count} ${count === 1 ? 'action' : 'actions'}`;\n  }\n  return step;\n}\n\n/** Every unresolved parallel call stays visible even when older settled steps fold away. */\nexport function visibleTimelineSteps({ steps, limit }: { steps: readonly TimelineStep[]; limit: number }) {\n  const safeLimit = Number.isFinite(limit) ? Math.max(1, Math.floor(limit)) : 3;\n  return steps.filter(\n    (step, index) =>\n      index >= steps.length - safeLimit || step.state === 'running' || step.state === 'waiting',\n  );\n}\n"],"names":[],"mappings":";AASA,MAAM,mBAA8D;AAAA,EAClE,YAAY,CAAC,qBAAqB,iBAAiB;AAAA,EACnD,YAAY,CAAC,YAAY,SAAS;AAAA,EAClC,aAAa,CAAC,kBAAkB,eAAe;AAAA,EAC/C,cAAc,CAAC,mBAAmB,gBAAgB;AAAA,EAClD,cAAc,CAAC,mBAAmB,gBAAgB;AAAA,EAClD,MAAM,CAAC,UAAU,OAAO;AAAA,EACxB,KAAK,CAAC,iBAAiB,cAAc;AAAA,EACrC,QAAQ,CAAC,aAAa,UAAU;AAAA,EAChC,WAAW,CAAC,wBAAwB,qBAAqB;AAAA,EACzD,MAAM,CAAC,WAAW,QAAQ;AAAA,EAC1B,OAAO,CAAC,YAAY,SAAS;AAAA,EAC7B,iBAAiB,CAAC,YAAY,SAAS;AAAA,EACvC,MAAM,CAAC,WAAW,QAAQ;AAC5B;AAGA,SAAS,WAAW,OAAoC;AACtD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,KAAK;AACzB,QAAI,IAAI,aAAa,WAAW,IAAI,aAAa,SAAU,QAAO;AAClE,WAAO,IAAI;AAAA,EACb,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AACF,GAIiB;AACf,QAAM,OAAqB;AAAA,IACzB,IAAI,KAAK,MAAM,GAAG,KAAK,IAAI,IAAI,KAAK;AAAA,IACpC,MAAM,qBAAqB,MAAM,sBAAsB;AAAA,IACvD,OAAO,KAAK;AAAA,EAAA;AAEd,MAAI,KAAK,SAAS,OAAQ,QAAO;AACjC,QAAM,OAAO,KAAK;AAClB,MAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,WAAW,SAAS,EAAG,QAAO;AAE1D,QAAM,QAAQ,KAAK,SAAS,KAAK;AACjC,OAAK,OAAO,WAAW,KAAK,GAAG,MAAM,OAAO,UAAU,WAAW,OAAO,KAAK,KAAK;AAGlF,MAAI,KAAK,UAAU,aAAa,KAAK,UAAU,WAAY,QAAO;AAClE,MAAI,KAAK,aAAa,qBAAqB,OAAO,KAAK,WAAW,UAAU;AAC1E,UAAM,SAAS,iBAAiB,KAAK,MAAM;AAC3C,QAAI,aAAa,OAAO,OAAO,KAAK,UAAU,YAAY,IAAI,CAAC;AAAA,EACjE,WAAW,KAAK,aAAa,mBAAmB;AAC9C,SAAK,OAAO,KAAK,UAAU,YAAY,kBAAkB;AAAA,EAC3D,WAAW,KAAK,aAAa,kBAAkB,MAAM,QAAQ,KAAK,KAAK,GAAG;AACxE,UAAM,QAAQ,KAAK,MAAM;AACzB,SAAK,OAAO,KAAK,UAAU,YAAY,2BAA2B;AAClE,SAAK,OAAO,GAAG,KAAK,IAAI,UAAU,IAAI,WAAW,SAAS;AAAA,EAC5D;AACA,SAAO;AACT;AAGO,SAAS,qBAAqB,EAAE,OAAO,SAA4D;AACxG,QAAM,YAAY,OAAO,SAAS,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC,IAAI;AAC5E,SAAO,MAAM;AAAA,IACX,CAAC,MAAM,UACL,SAAS,MAAM,SAAS,aAAa,KAAK,UAAU,aAAa,KAAK,UAAU;AAAA,EAAA;AAEtF;"}
+{"version":3,"file":"timeline-step.js","sources":["../../../src/chat/super-grouping/timeline-step.ts"],"sourcesContent":["import { type ActivityItem, getReasoningLabel, summarizeActivityTool } from './activity-timeline';\n\nexport interface TimelineStep {\n  id: string;\n  /** The row's line (\"Ran git status\"); `code` marks the literal part of it. */\n  verb: string;\n  /** The span of `verb` that is literal code (a command, a file name, a pattern). */\n  code?: string;\n  /** Longer form for the row's tooltip (the full path, the whole command line). */\n  detail?: string;\n  /** A short chip after the line (\"+4 −1\", \"on jevin-box\", \"Tab 7\"). */\n  chip?: string;\n  state: ActivityItem['state'];\n  kind: ActivityItem['kind'];\n}\n\nconst COMPUTER_ACTIONS: Record<string, readonly [string, string]> = {\n  screenshot: ['Taking screenshot', 'Took screenshot'],\n  left_click: ['Clicking', 'Clicked'],\n  right_click: ['Right-clicking', 'Right-clicked'],\n  double_click: ['Double-clicking', 'Double-clicked'],\n  triple_click: ['Triple-clicking', 'Triple-clicked'],\n  type: ['Typing', 'Typed'],\n  key: ['Pressing keys', 'Pressed keys'],\n  scroll: ['Scrolling', 'Scrolled'],\n  scroll_to: ['Scrolling to element', 'Scrolled to element'],\n  zoom: ['Zooming', 'Zoomed'],\n  hover: ['Hovering', 'Hovered'],\n  left_click_drag: ['Dragging', 'Dragged'],\n  wait: ['Waiting', 'Waited'],\n};\n\n/** Keep credentials, query strings, fragments, and typed input out of summary chips. */\nfunction pageTarget(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  try {\n    const url = new URL(value);\n    if (url.protocol !== 'http:' && url.protocol !== 'https:') return undefined;\n    return url.hostname;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function toTimelineStep({\n  item,\n  index,\n  resolveToolDisplayName,\n  assetTitles,\n}: {\n  item: ActivityItem;\n  index: number;\n  resolveToolDisplayName?: (toolName: string) => string | undefined;\n  /** Titles for asset ids earlier results in the turn named (see `collectAssetTitles`). */\n  assetTitles?: ReadonlyMap<string, string>;\n}): TimelineStep {\n  const id = item.id ?? `${item.kind}-${index}`;\n  if (item.kind !== 'tool') {\n    return { id, verb: getReasoningLabel(item.text, item.state), state: item.state, kind: item.kind };\n  }\n  const summary = summarizeActivityTool(item, resolveToolDisplayName, assetTitles);\n  const step: TimelineStep = {\n    id,\n    verb: summary.label,\n    ...(summary.code ? { code: summary.code } : {}),\n    ...(summary.detail ? { detail: summary.detail } : {}),\n    ...(summary.meta ? { chip: summary.meta } : {}),\n    state: item.state,\n    kind: item.kind,\n  };\n  const args = item.args;\n  if (!args || !item.toolName.startsWith('chrome_')) return step;\n\n  const tabId = args.tabId ?? args.tab_id;\n  step.chip = pageTarget(args.url) ?? (typeof tabId === 'number' ? `Tab ${tabId}` : undefined);\n  // Only successful/live actions get action-specific tense. Failure, rejection,\n  // cancellation and approval copy continues to come from the shared classifier.\n  if (item.state !== 'running' && item.state !== 'complete') return step;\n  if (item.toolName === 'chrome_computer' && typeof args.action === 'string') {\n    const action = COMPUTER_ACTIONS[args.action];\n    if (action) step.verb = action[item.state === 'running' ? 0 : 1];\n  } else if (item.toolName === 'chrome_navigate') {\n    step.verb = item.state === 'running' ? 'Navigating to' : 'Navigated to';\n  } else if (item.toolName === 'chrome_batch' && Array.isArray(args.steps)) {\n    const count = args.steps.length;\n    step.verb = item.state === 'running' ? 'Running Chrome actions' : 'Completed Chrome actions';\n    step.chip = `${count} ${count === 1 ? 'action' : 'actions'}`;\n  }\n  return step;\n}\n\n/** Every unresolved parallel call stays visible even when older settled steps fold away. */\nexport function visibleTimelineSteps({ steps, limit }: { steps: readonly TimelineStep[]; limit: number }) {\n  const safeLimit = Number.isFinite(limit) ? Math.max(1, Math.floor(limit)) : 3;\n  return steps.filter(\n    (step, index) =>\n      index >= steps.length - safeLimit || step.state === 'running' || step.state === 'waiting',\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/chat/super-grouping/toolkit-map.cjs

@@ -40,6 +40,7 @@ const DEFAULT_TOOL_TO_TOOLKIT = {
   create_presentation_pptx_studio: "Presentation",
   execute_presentation_code: "Presentation",
   capture_slide_screenshot: "Presentation",
+  capture_slide_screenshots: "Presentation",
   // Studio presentation PTC
   CreatePresentation: "Presentation",
   OpenPresentation: "Presentation",

package/dist/chat/super-grouping/toolkit-map.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"toolkit-map.cjs","sources":["../../../src/chat/super-grouping/toolkit-map.ts"],"sourcesContent":["/**\n * Static map of tool names → toolkit group display key, mirroring Olympus's\n * runtime `toolDefinitionsStore` output. The SDK doesn't ship a backend-fetched\n * toolkit catalog, so this provides the same grouping behavior using the names\n * the agent typically calls. Consumers can override via the `getToolGroupKey`\n * prop on `<AthenaChat>`.\n *\n * Keys here are toolkit *display* names (what users see in the toolkit\n * selector), not toolkit IDs — they match Olympus's\n * `getToolkitToGroupKeyMap()` output.\n */\nconst DEFAULT_TOOL_TO_TOOLKIT: Record<string, string> = {\n  // Web\n  search: 'Web',\n  browse: 'Web',\n  web_search: 'Web',\n  search_web: 'Web',\n  web_scrape: 'Web',\n  scrape_web: 'Web',\n\n  // Document\n  create_new_document: 'Document',\n  create_document_from_markdown: 'Document',\n  append_markdown_to_athena_document: 'Document',\n  replace_markdown_in_athena_document: 'Document',\n  delete_blocks_from_athena_document: 'Document',\n  convert_athena_doc_to_pdf: 'Document',\n  convert_to_pdf: 'Document',\n\n  // Word document (Studio)\n  CreateDocument: 'Document (Word)',\n  CreateParagraph: 'Document (Word)',\n  OpenDocument: 'Document (Word)',\n  execute_word_commands: 'Document (Word)',\n  create_new_word_document: 'Document (Word)',\n\n  // Spreadsheet\n  create_new_sheet: 'Spreadsheet',\n  update_sheet_range: 'Spreadsheet',\n  format_sheet_range: 'Spreadsheet',\n  bulk_format_sheet_range: 'Spreadsheet',\n  create_table: 'Spreadsheet',\n  update_table: 'Spreadsheet',\n  create_chart: 'Spreadsheet',\n  update_chart: 'Spreadsheet',\n  // Studio sheet PTC\n  CreateWorkbook: 'Spreadsheet',\n  AddSheet: 'Spreadsheet',\n  OpenWorkbook: 'Spreadsheet',\n\n  // Presentation\n  create_powerpoint_deck: 'Presentation',\n  create_presentation_pptx_studio: 'Presentation',\n  execute_presentation_code: 'Presentation',\n  capture_slide_screenshot: 'Presentation',\n  // Studio presentation PTC\n  CreatePresentation: 'Presentation',\n  OpenPresentation: 'Presentation',\n  AddSlide: 'Presentation',\n\n  // Notebook\n  create_new_notebook: 'Notebook',\n  run_notebook_cell: 'Notebook',\n\n  // Python / code execution\n  run_python_code: 'Python',\n  run_python: 'Python',\n\n  // Database\n  run_sql: 'Database',\n  run_database_sql: 'Database',\n  run_sql_query_tool: 'Database',\n  execute_sql: 'Database',\n  describe_database: 'Database',\n  list_database_tables: 'Database',\n  get_database_table_schema: 'Database',\n\n  // Email / calendar\n  search_email: 'Email',\n  unified_email_search: 'Email',\n\n  // Media\n  capture_moment: 'Computer',\n};\n\n/**\n * Tools that should never participate in grouping — even when surrounded by\n * tools of the same toolkit. Mirrors Olympus's `UNGROUPED_TOOLS`.\n */\nconst UNGROUPED_TOOLS: readonly string[] = [\n  'read_asset',\n  'read_full_asset',\n  'ask',\n  'open_asset_in_workspace',\n  'create_email_draft',\n  'unified_email_create_draft',\n  'unified_email_send',\n  'unified_email_edit_draft',\n];\n\n/**\n * Generic sandbox runtime tools shared across many toolkits (notebook,\n * computer, session sandbox, …). Mirrors Olympus's `CONTEXT_ONLY_TOOLS`:\n * they never start a toolkit group on their own — they only inherit the\n * surrounding group.\n */\nconst CONTEXT_ONLY_TOOLS: readonly string[] = [\n  'execute',\n  'ls',\n  'read_file',\n  'write_file',\n  'edit_file',\n  'glob',\n  'grep',\n];\n\n/**\n * Group display keys for toolkits that target a sandbox and therefore contain\n * the shared runtime tools. Context-only tools may only inherit these groups —\n * an open Web or Email group must not absorb a sandbox call.\n */\nconst SANDBOX_TOOLKIT_GROUPS: readonly string[] = ['Notebook', 'Computer', 'Session Sandbox'];\n\nexport type ToolGroupKeyOptions = {\n  /** Display name of the surrounding group, when one is already open. */\n  preferredGroupKey?: string;\n  /**\n   * Distinct tool names the message called. Hosts with a toolkit catalog use\n   * it to attribute a tool shared by several toolkits to the one the message\n   * leans on; the default map ignores it.\n   */\n  calledToolNames?: ReadonlySet<string>;\n};\n\n/**\n * Default `getToolGroupKey` implementation used by the SDK's tool grouping.\n * Returns the toolkit display key for a tool name, or `undefined` if the tool\n * is ungrouped or unknown. Context-only tools inherit the surrounding group\n * and are otherwise ungrouped.\n *\n * Override per-app by passing `getToolGroupKey` (or a whole `groupingFunction`) to\n * `SuperGroupingCard`.\n */\nexport const defaultGetToolGroupKey = (\n  toolName: string,\n  options?: ToolGroupKeyOptions\n): string | undefined => {\n  if (UNGROUPED_TOOLS.includes(toolName)) return undefined;\n  if (CONTEXT_ONLY_TOOLS.includes(toolName)) {\n    const preferred = options?.preferredGroupKey;\n    return preferred && SANDBOX_TOOLKIT_GROUPS.includes(preferred) ? preferred : undefined;\n  }\n  return DEFAULT_TOOL_TO_TOOLKIT[toolName];\n};\n\nexport type GetToolGroupKey = (\n  toolName: string,\n  options?: ToolGroupKeyOptions\n) => string | undefined;\n"],"names":[],"mappings":";;AAWA,MAAM,0BAAkD;AAAA;AAAA,EAEtD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA;AAAA,EAGZ,qBAAqB;AAAA,EACrB,+BAA+B;AAAA,EAC/B,oCAAoC;AAAA,EACpC,qCAAqC;AAAA,EACrC,oCAAoC;AAAA,EACpC,2BAA2B;AAAA,EAC3B,gBAAgB;AAAA;AAAA,EAGhB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,uBAAuB;AAAA,EACvB,0BAA0B;AAAA;AAAA,EAG1B,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,yBAAyB;AAAA,EACzB,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA;AAAA,EAEd,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,cAAc;AAAA;AAAA,EAGd,wBAAwB;AAAA,EACxB,iCAAiC;AAAA,EACjC,2BAA2B;AAAA,EAC3B,0BAA0B;AAAA;AAAA,EAE1B,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAClB,UAAU;AAAA;AAAA,EAGV,qBAAqB;AAAA,EACrB,mBAAmB;AAAA;AAAA,EAGnB,iBAAiB;AAAA,EACjB,YAAY;AAAA;AAAA,EAGZ,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,sBAAsB;AAAA,EACtB,2BAA2B;AAAA;AAAA,EAG3B,cAAc;AAAA,EACd,sBAAsB;AAAA;AAAA,EAGtB,gBAAgB;AAClB;AAMA,MAAM,kBAAqC;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQA,MAAM,qBAAwC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOA,MAAM,yBAA4C,CAAC,YAAY,YAAY,iBAAiB;AAsBrF,MAAM,yBAAyB,CACpC,UACA,YACuB;AACvB,MAAI,gBAAgB,SAAS,QAAQ,EAAG,QAAO;AAC/C,MAAI,mBAAmB,SAAS,QAAQ,GAAG;AACzC,UAAM,YAAY,mCAAS;AAC3B,WAAO,aAAa,uBAAuB,SAAS,SAAS,IAAI,YAAY;AAAA,EAC/E;AACA,SAAO,wBAAwB,QAAQ;AACzC;;"}
+{"version":3,"file":"toolkit-map.cjs","sources":["../../../src/chat/super-grouping/toolkit-map.ts"],"sourcesContent":["/**\n * Static map of tool names → toolkit group display key, mirroring Olympus's\n * runtime `toolDefinitionsStore` output. The SDK doesn't ship a backend-fetched\n * toolkit catalog, so this provides the same grouping behavior using the names\n * the agent typically calls. Consumers can override via the `getToolGroupKey`\n * prop on `<AthenaChat>`.\n *\n * Keys here are toolkit *display* names (what users see in the toolkit\n * selector), not toolkit IDs — they match Olympus's\n * `getToolkitToGroupKeyMap()` output.\n */\nconst DEFAULT_TOOL_TO_TOOLKIT: Record<string, string> = {\n  // Web\n  search: 'Web',\n  browse: 'Web',\n  web_search: 'Web',\n  search_web: 'Web',\n  web_scrape: 'Web',\n  scrape_web: 'Web',\n\n  // Document\n  create_new_document: 'Document',\n  create_document_from_markdown: 'Document',\n  append_markdown_to_athena_document: 'Document',\n  replace_markdown_in_athena_document: 'Document',\n  delete_blocks_from_athena_document: 'Document',\n  convert_athena_doc_to_pdf: 'Document',\n  convert_to_pdf: 'Document',\n\n  // Word document (Studio)\n  CreateDocument: 'Document (Word)',\n  CreateParagraph: 'Document (Word)',\n  OpenDocument: 'Document (Word)',\n  execute_word_commands: 'Document (Word)',\n  create_new_word_document: 'Document (Word)',\n\n  // Spreadsheet\n  create_new_sheet: 'Spreadsheet',\n  update_sheet_range: 'Spreadsheet',\n  format_sheet_range: 'Spreadsheet',\n  bulk_format_sheet_range: 'Spreadsheet',\n  create_table: 'Spreadsheet',\n  update_table: 'Spreadsheet',\n  create_chart: 'Spreadsheet',\n  update_chart: 'Spreadsheet',\n  // Studio sheet PTC\n  CreateWorkbook: 'Spreadsheet',\n  AddSheet: 'Spreadsheet',\n  OpenWorkbook: 'Spreadsheet',\n\n  // Presentation\n  create_powerpoint_deck: 'Presentation',\n  create_presentation_pptx_studio: 'Presentation',\n  execute_presentation_code: 'Presentation',\n  capture_slide_screenshot: 'Presentation',\n  capture_slide_screenshots: 'Presentation',\n  // Studio presentation PTC\n  CreatePresentation: 'Presentation',\n  OpenPresentation: 'Presentation',\n  AddSlide: 'Presentation',\n\n  // Notebook\n  create_new_notebook: 'Notebook',\n  run_notebook_cell: 'Notebook',\n\n  // Python / code execution\n  run_python_code: 'Python',\n  run_python: 'Python',\n\n  // Database\n  run_sql: 'Database',\n  run_database_sql: 'Database',\n  run_sql_query_tool: 'Database',\n  execute_sql: 'Database',\n  describe_database: 'Database',\n  list_database_tables: 'Database',\n  get_database_table_schema: 'Database',\n\n  // Email / calendar\n  search_email: 'Email',\n  unified_email_search: 'Email',\n\n  // Media\n  capture_moment: 'Computer',\n};\n\n/**\n * Tools that should never participate in grouping — even when surrounded by\n * tools of the same toolkit. Mirrors Olympus's `UNGROUPED_TOOLS`.\n */\nconst UNGROUPED_TOOLS: readonly string[] = [\n  'read_asset',\n  'read_full_asset',\n  'ask',\n  'open_asset_in_workspace',\n  'create_email_draft',\n  'unified_email_create_draft',\n  'unified_email_send',\n  'unified_email_edit_draft',\n];\n\n/**\n * Generic sandbox runtime tools shared across many toolkits (notebook,\n * computer, session sandbox, …). Mirrors Olympus's `CONTEXT_ONLY_TOOLS`:\n * they never start a toolkit group on their own — they only inherit the\n * surrounding group.\n */\nconst CONTEXT_ONLY_TOOLS: readonly string[] = [\n  'execute',\n  'ls',\n  'read_file',\n  'write_file',\n  'edit_file',\n  'glob',\n  'grep',\n];\n\n/**\n * Group display keys for toolkits that target a sandbox and therefore contain\n * the shared runtime tools. Context-only tools may only inherit these groups —\n * an open Web or Email group must not absorb a sandbox call.\n */\nconst SANDBOX_TOOLKIT_GROUPS: readonly string[] = ['Notebook', 'Computer', 'Session Sandbox'];\n\nexport type ToolGroupKeyOptions = {\n  /** Display name of the surrounding group, when one is already open. */\n  preferredGroupKey?: string;\n  /**\n   * Distinct tool names the message called. Hosts with a toolkit catalog use\n   * it to attribute a tool shared by several toolkits to the one the message\n   * leans on; the default map ignores it.\n   */\n  calledToolNames?: ReadonlySet<string>;\n};\n\n/**\n * Default `getToolGroupKey` implementation used by the SDK's tool grouping.\n * Returns the toolkit display key for a tool name, or `undefined` if the tool\n * is ungrouped or unknown. Context-only tools inherit the surrounding group\n * and are otherwise ungrouped.\n *\n * Override per-app by passing `getToolGroupKey` (or a whole `groupingFunction`) to\n * `SuperGroupingCard`.\n */\nexport const defaultGetToolGroupKey = (\n  toolName: string,\n  options?: ToolGroupKeyOptions\n): string | undefined => {\n  if (UNGROUPED_TOOLS.includes(toolName)) return undefined;\n  if (CONTEXT_ONLY_TOOLS.includes(toolName)) {\n    const preferred = options?.preferredGroupKey;\n    return preferred && SANDBOX_TOOLKIT_GROUPS.includes(preferred) ? preferred : undefined;\n  }\n  return DEFAULT_TOOL_TO_TOOLKIT[toolName];\n};\n\nexport type GetToolGroupKey = (\n  toolName: string,\n  options?: ToolGroupKeyOptions\n) => string | undefined;\n"],"names":[],"mappings":";;AAWA,MAAM,0BAAkD;AAAA;AAAA,EAEtD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA;AAAA,EAGZ,qBAAqB;AAAA,EACrB,+BAA+B;AAAA,EAC/B,oCAAoC;AAAA,EACpC,qCAAqC;AAAA,EACrC,oCAAoC;AAAA,EACpC,2BAA2B;AAAA,EAC3B,gBAAgB;AAAA;AAAA,EAGhB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,uBAAuB;AAAA,EACvB,0BAA0B;AAAA;AAAA,EAG1B,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,yBAAyB;AAAA,EACzB,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA;AAAA,EAEd,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,cAAc;AAAA;AAAA,EAGd,wBAAwB;AAAA,EACxB,iCAAiC;AAAA,EACjC,2BAA2B;AAAA,EAC3B,0BAA0B;AAAA,EAC1B,2BAA2B;AAAA;AAAA,EAE3B,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAClB,UAAU;AAAA;AAAA,EAGV,qBAAqB;AAAA,EACrB,mBAAmB;AAAA;AAAA,EAGnB,iBAAiB;AAAA,EACjB,YAAY;AAAA;AAAA,EAGZ,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,sBAAsB;AAAA,EACtB,2BAA2B;AAAA;AAAA,EAG3B,cAAc;AAAA,EACd,sBAAsB;AAAA;AAAA,EAGtB,gBAAgB;AAClB;AAMA,MAAM,kBAAqC;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQA,MAAM,qBAAwC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOA,MAAM,yBAA4C,CAAC,YAAY,YAAY,iBAAiB;AAsBrF,MAAM,yBAAyB,CACpC,UACA,YACuB;AACvB,MAAI,gBAAgB,SAAS,QAAQ,EAAG,QAAO;AAC/C,MAAI,mBAAmB,SAAS,QAAQ,GAAG;AACzC,UAAM,YAAY,mCAAS;AAC3B,WAAO,aAAa,uBAAuB,SAAS,SAAS,IAAI,YAAY;AAAA,EAC/E;AACA,SAAO,wBAAwB,QAAQ;AACzC;;"}

package/dist/chat/super-grouping/toolkit-map.js

@@ -38,6 +38,7 @@ const DEFAULT_TOOL_TO_TOOLKIT = {
   create_presentation_pptx_studio: "Presentation",
   execute_presentation_code: "Presentation",
   capture_slide_screenshot: "Presentation",
+  capture_slide_screenshots: "Presentation",
   // Studio presentation PTC
   CreatePresentation: "Presentation",
   OpenPresentation: "Presentation",

package/dist/chat/super-grouping/toolkit-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolkit-map.js","sources":["../../../src/chat/super-grouping/toolkit-map.ts"],"sourcesContent":["/**\n * Static map of tool names → toolkit group display key, mirroring Olympus's\n * runtime `toolDefinitionsStore` output. The SDK doesn't ship a backend-fetched\n * toolkit catalog, so this provides the same grouping behavior using the names\n * the agent typically calls. Consumers can override via the `getToolGroupKey`\n * prop on `<AthenaChat>`.\n *\n * Keys here are toolkit *display* names (what users see in the toolkit\n * selector), not toolkit IDs — they match Olympus's\n * `getToolkitToGroupKeyMap()` output.\n */\nconst DEFAULT_TOOL_TO_TOOLKIT: Record<string, string> = {\n  // Web\n  search: 'Web',\n  browse: 'Web',\n  web_search: 'Web',\n  search_web: 'Web',\n  web_scrape: 'Web',\n  scrape_web: 'Web',\n\n  // Document\n  create_new_document: 'Document',\n  create_document_from_markdown: 'Document',\n  append_markdown_to_athena_document: 'Document',\n  replace_markdown_in_athena_document: 'Document',\n  delete_blocks_from_athena_document: 'Document',\n  convert_athena_doc_to_pdf: 'Document',\n  convert_to_pdf: 'Document',\n\n  // Word document (Studio)\n  CreateDocument: 'Document (Word)',\n  CreateParagraph: 'Document (Word)',\n  OpenDocument: 'Document (Word)',\n  execute_word_commands: 'Document (Word)',\n  create_new_word_document: 'Document (Word)',\n\n  // Spreadsheet\n  create_new_sheet: 'Spreadsheet',\n  update_sheet_range: 'Spreadsheet',\n  format_sheet_range: 'Spreadsheet',\n  bulk_format_sheet_range: 'Spreadsheet',\n  create_table: 'Spreadsheet',\n  update_table: 'Spreadsheet',\n  create_chart: 'Spreadsheet',\n  update_chart: 'Spreadsheet',\n  // Studio sheet PTC\n  CreateWorkbook: 'Spreadsheet',\n  AddSheet: 'Spreadsheet',\n  OpenWorkbook: 'Spreadsheet',\n\n  // Presentation\n  create_powerpoint_deck: 'Presentation',\n  create_presentation_pptx_studio: 'Presentation',\n  execute_presentation_code: 'Presentation',\n  capture_slide_screenshot: 'Presentation',\n  // Studio presentation PTC\n  CreatePresentation: 'Presentation',\n  OpenPresentation: 'Presentation',\n  AddSlide: 'Presentation',\n\n  // Notebook\n  create_new_notebook: 'Notebook',\n  run_notebook_cell: 'Notebook',\n\n  // Python / code execution\n  run_python_code: 'Python',\n  run_python: 'Python',\n\n  // Database\n  run_sql: 'Database',\n  run_database_sql: 'Database',\n  run_sql_query_tool: 'Database',\n  execute_sql: 'Database',\n  describe_database: 'Database',\n  list_database_tables: 'Database',\n  get_database_table_schema: 'Database',\n\n  // Email / calendar\n  search_email: 'Email',\n  unified_email_search: 'Email',\n\n  // Media\n  capture_moment: 'Computer',\n};\n\n/**\n * Tools that should never participate in grouping — even when surrounded by\n * tools of the same toolkit. Mirrors Olympus's `UNGROUPED_TOOLS`.\n */\nconst UNGROUPED_TOOLS: readonly string[] = [\n  'read_asset',\n  'read_full_asset',\n  'ask',\n  'open_asset_in_workspace',\n  'create_email_draft',\n  'unified_email_create_draft',\n  'unified_email_send',\n  'unified_email_edit_draft',\n];\n\n/**\n * Generic sandbox runtime tools shared across many toolkits (notebook,\n * computer, session sandbox, …). Mirrors Olympus's `CONTEXT_ONLY_TOOLS`:\n * they never start a toolkit group on their own — they only inherit the\n * surrounding group.\n */\nconst CONTEXT_ONLY_TOOLS: readonly string[] = [\n  'execute',\n  'ls',\n  'read_file',\n  'write_file',\n  'edit_file',\n  'glob',\n  'grep',\n];\n\n/**\n * Group display keys for toolkits that target a sandbox and therefore contain\n * the shared runtime tools. Context-only tools may only inherit these groups —\n * an open Web or Email group must not absorb a sandbox call.\n */\nconst SANDBOX_TOOLKIT_GROUPS: readonly string[] = ['Notebook', 'Computer', 'Session Sandbox'];\n\nexport type ToolGroupKeyOptions = {\n  /** Display name of the surrounding group, when one is already open. */\n  preferredGroupKey?: string;\n  /**\n   * Distinct tool names the message called. Hosts with a toolkit catalog use\n   * it to attribute a tool shared by several toolkits to the one the message\n   * leans on; the default map ignores it.\n   */\n  calledToolNames?: ReadonlySet<string>;\n};\n\n/**\n * Default `getToolGroupKey` implementation used by the SDK's tool grouping.\n * Returns the toolkit display key for a tool name, or `undefined` if the tool\n * is ungrouped or unknown. Context-only tools inherit the surrounding group\n * and are otherwise ungrouped.\n *\n * Override per-app by passing `getToolGroupKey` (or a whole `groupingFunction`) to\n * `SuperGroupingCard`.\n */\nexport const defaultGetToolGroupKey = (\n  toolName: string,\n  options?: ToolGroupKeyOptions\n): string | undefined => {\n  if (UNGROUPED_TOOLS.includes(toolName)) return undefined;\n  if (CONTEXT_ONLY_TOOLS.includes(toolName)) {\n    const preferred = options?.preferredGroupKey;\n    return preferred && SANDBOX_TOOLKIT_GROUPS.includes(preferred) ? preferred : undefined;\n  }\n  return DEFAULT_TOOL_TO_TOOLKIT[toolName];\n};\n\nexport type GetToolGroupKey = (\n  toolName: string,\n  options?: ToolGroupKeyOptions\n) => string | undefined;\n"],"names":[],"mappings":"AAWA,MAAM,0BAAkD;AAAA;AAAA,EAEtD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA;AAAA,EAGZ,qBAAqB;AAAA,EACrB,+BAA+B;AAAA,EAC/B,oCAAoC;AAAA,EACpC,qCAAqC;AAAA,EACrC,oCAAoC;AAAA,EACpC,2BAA2B;AAAA,EAC3B,gBAAgB;AAAA;AAAA,EAGhB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,uBAAuB;AAAA,EACvB,0BAA0B;AAAA;AAAA,EAG1B,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,yBAAyB;AAAA,EACzB,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA;AAAA,EAEd,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,cAAc;AAAA;AAAA,EAGd,wBAAwB;AAAA,EACxB,iCAAiC;AAAA,EACjC,2BAA2B;AAAA,EAC3B,0BAA0B;AAAA;AAAA,EAE1B,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAClB,UAAU;AAAA;AAAA,EAGV,qBAAqB;AAAA,EACrB,mBAAmB;AAAA;AAAA,EAGnB,iBAAiB;AAAA,EACjB,YAAY;AAAA;AAAA,EAGZ,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,sBAAsB;AAAA,EACtB,2BAA2B;AAAA;AAAA,EAG3B,cAAc;AAAA,EACd,sBAAsB;AAAA;AAAA,EAGtB,gBAAgB;AAClB;AAMA,MAAM,kBAAqC;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQA,MAAM,qBAAwC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOA,MAAM,yBAA4C,CAAC,YAAY,YAAY,iBAAiB;AAsBrF,MAAM,yBAAyB,CACpC,UACA,YACuB;AACvB,MAAI,gBAAgB,SAAS,QAAQ,EAAG,QAAO;AAC/C,MAAI,mBAAmB,SAAS,QAAQ,GAAG;AACzC,UAAM,YAAY,mCAAS;AAC3B,WAAO,aAAa,uBAAuB,SAAS,SAAS,IAAI,YAAY;AAAA,EAC/E;AACA,SAAO,wBAAwB,QAAQ;AACzC;"}
+{"version":3,"file":"toolkit-map.js","sources":["../../../src/chat/super-grouping/toolkit-map.ts"],"sourcesContent":["/**\n * Static map of tool names → toolkit group display key, mirroring Olympus's\n * runtime `toolDefinitionsStore` output. The SDK doesn't ship a backend-fetched\n * toolkit catalog, so this provides the same grouping behavior using the names\n * the agent typically calls. Consumers can override via the `getToolGroupKey`\n * prop on `<AthenaChat>`.\n *\n * Keys here are toolkit *display* names (what users see in the toolkit\n * selector), not toolkit IDs — they match Olympus's\n * `getToolkitToGroupKeyMap()` output.\n */\nconst DEFAULT_TOOL_TO_TOOLKIT: Record<string, string> = {\n  // Web\n  search: 'Web',\n  browse: 'Web',\n  web_search: 'Web',\n  search_web: 'Web',\n  web_scrape: 'Web',\n  scrape_web: 'Web',\n\n  // Document\n  create_new_document: 'Document',\n  create_document_from_markdown: 'Document',\n  append_markdown_to_athena_document: 'Document',\n  replace_markdown_in_athena_document: 'Document',\n  delete_blocks_from_athena_document: 'Document',\n  convert_athena_doc_to_pdf: 'Document',\n  convert_to_pdf: 'Document',\n\n  // Word document (Studio)\n  CreateDocument: 'Document (Word)',\n  CreateParagraph: 'Document (Word)',\n  OpenDocument: 'Document (Word)',\n  execute_word_commands: 'Document (Word)',\n  create_new_word_document: 'Document (Word)',\n\n  // Spreadsheet\n  create_new_sheet: 'Spreadsheet',\n  update_sheet_range: 'Spreadsheet',\n  format_sheet_range: 'Spreadsheet',\n  bulk_format_sheet_range: 'Spreadsheet',\n  create_table: 'Spreadsheet',\n  update_table: 'Spreadsheet',\n  create_chart: 'Spreadsheet',\n  update_chart: 'Spreadsheet',\n  // Studio sheet PTC\n  CreateWorkbook: 'Spreadsheet',\n  AddSheet: 'Spreadsheet',\n  OpenWorkbook: 'Spreadsheet',\n\n  // Presentation\n  create_powerpoint_deck: 'Presentation',\n  create_presentation_pptx_studio: 'Presentation',\n  execute_presentation_code: 'Presentation',\n  capture_slide_screenshot: 'Presentation',\n  capture_slide_screenshots: 'Presentation',\n  // Studio presentation PTC\n  CreatePresentation: 'Presentation',\n  OpenPresentation: 'Presentation',\n  AddSlide: 'Presentation',\n\n  // Notebook\n  create_new_notebook: 'Notebook',\n  run_notebook_cell: 'Notebook',\n\n  // Python / code execution\n  run_python_code: 'Python',\n  run_python: 'Python',\n\n  // Database\n  run_sql: 'Database',\n  run_database_sql: 'Database',\n  run_sql_query_tool: 'Database',\n  execute_sql: 'Database',\n  describe_database: 'Database',\n  list_database_tables: 'Database',\n  get_database_table_schema: 'Database',\n\n  // Email / calendar\n  search_email: 'Email',\n  unified_email_search: 'Email',\n\n  // Media\n  capture_moment: 'Computer',\n};\n\n/**\n * Tools that should never participate in grouping — even when surrounded by\n * tools of the same toolkit. Mirrors Olympus's `UNGROUPED_TOOLS`.\n */\nconst UNGROUPED_TOOLS: readonly string[] = [\n  'read_asset',\n  'read_full_asset',\n  'ask',\n  'open_asset_in_workspace',\n  'create_email_draft',\n  'unified_email_create_draft',\n  'unified_email_send',\n  'unified_email_edit_draft',\n];\n\n/**\n * Generic sandbox runtime tools shared across many toolkits (notebook,\n * computer, session sandbox, …). Mirrors Olympus's `CONTEXT_ONLY_TOOLS`:\n * they never start a toolkit group on their own — they only inherit the\n * surrounding group.\n */\nconst CONTEXT_ONLY_TOOLS: readonly string[] = [\n  'execute',\n  'ls',\n  'read_file',\n  'write_file',\n  'edit_file',\n  'glob',\n  'grep',\n];\n\n/**\n * Group display keys for toolkits that target a sandbox and therefore contain\n * the shared runtime tools. Context-only tools may only inherit these groups —\n * an open Web or Email group must not absorb a sandbox call.\n */\nconst SANDBOX_TOOLKIT_GROUPS: readonly string[] = ['Notebook', 'Computer', 'Session Sandbox'];\n\nexport type ToolGroupKeyOptions = {\n  /** Display name of the surrounding group, when one is already open. */\n  preferredGroupKey?: string;\n  /**\n   * Distinct tool names the message called. Hosts with a toolkit catalog use\n   * it to attribute a tool shared by several toolkits to the one the message\n   * leans on; the default map ignores it.\n   */\n  calledToolNames?: ReadonlySet<string>;\n};\n\n/**\n * Default `getToolGroupKey` implementation used by the SDK's tool grouping.\n * Returns the toolkit display key for a tool name, or `undefined` if the tool\n * is ungrouped or unknown. Context-only tools inherit the surrounding group\n * and are otherwise ungrouped.\n *\n * Override per-app by passing `getToolGroupKey` (or a whole `groupingFunction`) to\n * `SuperGroupingCard`.\n */\nexport const defaultGetToolGroupKey = (\n  toolName: string,\n  options?: ToolGroupKeyOptions\n): string | undefined => {\n  if (UNGROUPED_TOOLS.includes(toolName)) return undefined;\n  if (CONTEXT_ONLY_TOOLS.includes(toolName)) {\n    const preferred = options?.preferredGroupKey;\n    return preferred && SANDBOX_TOOLKIT_GROUPS.includes(preferred) ? preferred : undefined;\n  }\n  return DEFAULT_TOOL_TO_TOOLKIT[toolName];\n};\n\nexport type GetToolGroupKey = (\n  toolName: string,\n  options?: ToolGroupKeyOptions\n) => string | undefined;\n"],"names":[],"mappings":"AAWA,MAAM,0BAAkD;AAAA;AAAA,EAEtD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,YAAY;AAAA;AAAA,EAGZ,qBAAqB;AAAA,EACrB,+BAA+B;AAAA,EAC/B,oCAAoC;AAAA,EACpC,qCAAqC;AAAA,EACrC,oCAAoC;AAAA,EACpC,2BAA2B;AAAA,EAC3B,gBAAgB;AAAA;AAAA,EAGhB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,uBAAuB;AAAA,EACvB,0BAA0B;AAAA;AAAA,EAG1B,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,yBAAyB;AAAA,EACzB,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA;AAAA,EAEd,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,cAAc;AAAA;AAAA,EAGd,wBAAwB;AAAA,EACxB,iCAAiC;AAAA,EACjC,2BAA2B;AAAA,EAC3B,0BAA0B;AAAA,EAC1B,2BAA2B;AAAA;AAAA,EAE3B,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAClB,UAAU;AAAA;AAAA,EAGV,qBAAqB;AAAA,EACrB,mBAAmB;AAAA;AAAA,EAGnB,iBAAiB;AAAA,EACjB,YAAY;AAAA;AAAA,EAGZ,SAAS;AAAA,EACT,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,sBAAsB;AAAA,EACtB,2BAA2B;AAAA;AAAA,EAG3B,cAAc;AAAA,EACd,sBAAsB;AAAA;AAAA,EAGtB,gBAAgB;AAClB;AAMA,MAAM,kBAAqC;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQA,MAAM,qBAAwC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOA,MAAM,yBAA4C,CAAC,YAAY,YAAY,iBAAiB;AAsBrF,MAAM,yBAAyB,CACpC,UACA,YACuB;AACvB,MAAI,gBAAgB,SAAS,QAAQ,EAAG,QAAO;AAC/C,MAAI,mBAAmB,SAAS,QAAQ,GAAG;AACzC,UAAM,YAAY,mCAAS;AAC3B,WAAO,aAAa,uBAAuB,SAAS,SAAS,IAAI,YAAY;AAAA,EAC/E;AACA,SAAO,wBAAwB,QAAQ;AACzC;"}

package/dist/chat/super-grouping/turn-segments.cjs

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function lastToolCallIndex(content) {
+  var _a;
+  for (let index = content.length - 1; index >= 0; index -= 1) {
+    if (((_a = content[index]) == null ? void 0 : _a.type) === "tool-call") return index;
+  }
+  return -1;
+}
+function splitTurnSegments(content) {
+  if (!(content == null ? void 0 : content.length)) return [];
+  const answerStart = lastToolCallIndex(content) + 1;
+  const segments = [];
+  let lastActivity = null;
+  for (let index = 0; index < content.length; index += 1) {
+    const part = content[index];
+    if (!part) continue;
+    if (part.type === "text") {
+      if (index >= answerStart) continue;
+      const text = typeof part.text === "string" ? part.text : "";
+      if (text.trim() === "") continue;
+      segments.push({ kind: "prose", key: `prose-${index}`, partIndex: index, text });
+      continue;
+    }
+    const previous = segments.at(-1);
+    if (index < answerStart && (previous == null ? void 0 : previous.kind) === "activity") {
+      previous.partIndices.push(index);
+      continue;
+    }
+    if (index >= answerStart && lastActivity) {
+      lastActivity.partIndices.push(index);
+      continue;
+    }
+    lastActivity = { kind: "activity", key: `activity-${index}`, partIndices: [index] };
+    segments.push(lastActivity);
+  }
+  return segments;
+}
+function scopeGroupingToSegment(grouping, partIndices) {
+  const indices = new Set(partIndices);
+  return (parts) => grouping(parts).map((group) => ({
+    ...group,
+    indices: group.indices.filter((index) => {
+      var _a;
+      return indices.has(index) && ((_a = parts[index]) == null ? void 0 : _a.type) !== "text";
+    })
+  })).filter((group) => group.indices.length > 0);
+}
+function summarizeSegment(steps) {
+  const toolSteps = steps.filter((step) => step.kind === "tool");
+  const running = steps.filter((step) => step.state === "running");
+  const waiting = steps.find((step) => step.state === "waiting");
+  if (waiting) {
+    return { step: waiting, label: waiting.verb, meta: void 0, phase: "waiting" };
+  }
+  if (running.length > 0) {
+    const current = running.at(-1);
+    const doneTools = toolSteps.filter((step) => step.state !== "running").length;
+    return {
+      step: current,
+      label: (current == null ? void 0 : current.verb) ?? "Working",
+      meta: running.length > 1 ? `${running.length} in progress` : doneTools > 0 ? `${doneTools} done` : void 0,
+      phase: "running"
+    };
+  }
+  const primary = toolSteps.at(-1) ?? steps.at(-1);
+  const earlierFailures = toolSteps.filter((step) => step !== primary && step.state === "error").length;
+  const meta = [
+    toolSteps.length > 1 ? `+${toolSteps.length - 1} more` : null,
+    earlierFailures > 0 ? `${earlierFailures} failed` : null
+  ].filter(Boolean).join(" · ");
+  return {
+    step: primary,
+    label: (primary == null ? void 0 : primary.verb) ?? "Thought through the next step",
+    meta: meta || void 0,
+    phase: (primary == null ? void 0 : primary.state) === "error" ? "error" : "complete"
+  };
+}
+exports.scopeGroupingToSegment = scopeGroupingToSegment;
+exports.splitTurnSegments = splitTurnSegments;
+exports.summarizeSegment = summarizeSegment;
+//# sourceMappingURL=turn-segments.cjs.map

package/dist/chat/super-grouping/turn-segments.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-segments.cjs","sources":["../../../src/chat/super-grouping/turn-segments.ts"],"sourcesContent":["/**\n * The grouped transcript's layout of one assistant turn: the agent's own\n * sentences in the order it wrote them, with the work between them (tool calls\n * and reasoning) folded into collapsed activity segments. Pure functions over\n * assistant-ui message parts; `SuperGroupingTranscript` renders them.\n *\n * Text is never folded away. The text after the final tool call is the turn's\n * answer and renders below the transcript (`SuperGroupingFinalText`, the same\n * read `getFinalText` makes), so it is left out of the segments here: every\n * text part renders exactly once, either as prose here or as the answer there.\n */\nimport type { ActivityItem, ActivityPhase } from './activity-timeline';\nimport type { GroupingFunction } from './grouping-function';\nimport type { TimelineStep } from './timeline-step';\n\n/** The part shape segmentation needs; assistant-ui's `ThreadAssistantMessagePart` satisfies it. */\nexport type SegmentablePart = { readonly type: string; readonly text?: string };\n\nexport type TurnSegment =\n  | {\n      kind: 'prose';\n      /** Stable across streaming: parts only ever append. */\n      key: string;\n      partIndex: number;\n      text: string;\n    }\n  | {\n      kind: 'activity';\n      key: string;\n      /** The tool-call, reasoning and other non-text parts this segment folds, in order. */\n      partIndices: number[];\n    };\n\nfunction lastToolCallIndex(content: readonly SegmentablePart[]): number {\n  for (let index = content.length - 1; index >= 0; index -= 1) {\n    if (content[index]?.type === 'tool-call') return index;\n  }\n  return -1;\n}\n\n/**\n * Split a turn into prose and activity segments.\n *\n * - Before the last tool call, each non-blank text part is a prose segment and\n *   every run of other parts between them is one activity segment.\n * - After the last tool call, text is the answer (left to the final-text\n *   renderer), and any other part — a thought streaming before the next\n *   sentence — joins the last activity segment, so it reads as part of the\n *   work that led to the answer.\n */\nexport function splitTurnSegments(content: readonly SegmentablePart[] | undefined): TurnSegment[] {\n  if (!content?.length) return [];\n  const answerStart = lastToolCallIndex(content) + 1;\n  const segments: TurnSegment[] = [];\n  let lastActivity: Extract<TurnSegment, { kind: 'activity' }> | null = null;\n\n  for (let index = 0; index < content.length; index += 1) {\n    const part = content[index];\n    if (!part) continue;\n    if (part.type === 'text') {\n      if (index >= answerStart) continue;\n      const text = typeof part.text === 'string' ? part.text : '';\n      if (text.trim() === '') continue;\n      segments.push({ kind: 'prose', key: `prose-${index}`, partIndex: index, text });\n      continue;\n    }\n    const previous = segments.at(-1);\n    if (index < answerStart && previous?.kind === 'activity') {\n      previous.partIndices.push(index);\n      continue;\n    }\n    if (index >= answerStart && lastActivity) {\n      lastActivity.partIndices.push(index);\n      continue;\n    }\n    lastActivity = { kind: 'activity', key: `activity-${index}`, partIndices: [index] };\n    segments.push(lastActivity);\n  }\n  return segments;\n}\n\n/** The timeline items whose parts a segment folds, in stream order. */\nexport function segmentItems(\n  segment: Extract<TurnSegment, { kind: 'activity' }>,\n  timeline: readonly ActivityItem[],\n): ActivityItem[] {\n  const indices = new Set(segment.partIndices);\n  return timeline.filter((item) => item.partIndex !== undefined && indices.has(item.partIndex));\n}\n\n/**\n * The details-panel grouping for one segment: the host's grouping restricted\n * to the segment's parts, with every text part dropped (prose renders in the\n * transcript, the answer below it) and any group left empty removed.\n */\nexport function scopeGroupingToSegment(\n  grouping: GroupingFunction,\n  partIndices: readonly number[],\n): GroupingFunction {\n  const indices = new Set(partIndices);\n  return (parts) =>\n    grouping(parts)\n      .map((group) => ({\n        ...group,\n        indices: group.indices.filter((index) => indices.has(index) && parts[index]?.type !== 'text'),\n      }))\n      .filter((group) => group.indices.length > 0);\n}\n\nexport interface SegmentSummary {\n  /** The collapsed row's line: the step in progress, else the segment's last tool step. */\n  step: TimelineStep | undefined;\n  /** \"Waiting for your input\" when a step waits on the person. */\n  label: string;\n  /** \"+2 more\" / \"2 in progress\" beside the line. */\n  meta: string | undefined;\n  phase: ActivityPhase;\n}\n\n/**\n * What a collapsed activity segment says: the step in progress while one runs\n * (\"Running git fetch\", with \"2 done\" or \"2 in progress\" for parallel calls), the step\n * waiting on the person, else the last tool step it took (\"Ran git log -1\",\n * \"+2 more\", and how many earlier steps failed). The row reads as failed only\n * when that last step did. A segment that only thought reads as its thought.\n */\nexport function summarizeSegment(steps: readonly TimelineStep[]): SegmentSummary {\n  const toolSteps = steps.filter((step) => step.kind === 'tool');\n  const running = steps.filter((step) => step.state === 'running');\n  const waiting = steps.find((step) => step.state === 'waiting');\n\n  if (waiting) {\n    return { step: waiting, label: waiting.verb, meta: undefined, phase: 'waiting' };\n  }\n  if (running.length > 0) {\n    const current = running.at(-1);\n    const doneTools = toolSteps.filter((step) => step.state !== 'running').length;\n    return {\n      step: current,\n      label: current?.verb ?? 'Working',\n      meta:\n        running.length > 1\n          ? `${running.length} in progress`\n          : doneTools > 0\n            ? `${doneTools} done`\n            : undefined,\n      phase: 'running',\n    };\n  }\n  const primary = toolSteps.at(-1) ?? steps.at(-1);\n  const earlierFailures = toolSteps.filter((step) => step !== primary && step.state === 'error').length;\n  const meta = [\n    toolSteps.length > 1 ? `+${toolSteps.length - 1} more` : null,\n    earlierFailures > 0 ? `${earlierFailures} failed` : null,\n  ]\n    .filter(Boolean)\n    .join(' · ');\n  return {\n    step: primary,\n    label: primary?.verb ?? 'Thought through the next step',\n    meta: meta || undefined,\n    phase: primary?.state === 'error' ? 'error' : 'complete',\n  };\n}\n"],"names":[],"mappings":"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"}