@athenaintel/react 0.42.2 → 0.43.0

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

@@ -15,6 +15,7 @@ export { GroupedMessageParts, type GroupedMessagePartsProps } from './GroupedMes
 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 type { TimelineStep } from './timeline-step';
 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/timeline-step.cjs

@@ -30,7 +30,8 @@ function toTimelineStep({
   item,
   index,
   resolveToolDisplayName,
-  assetTitles
+  assetTitles,
+  withSourceUrls = false
 }) {
   const id = item.id ?? `${item.kind}-${index}`;
   if (item.kind !== "tool") {
@@ -44,8 +45,13 @@ function toTimelineStep({
     ...summary.detail ? { detail: summary.detail } : {},
     ...summary.meta ? { chip: summary.meta } : {},
     state: item.state,
-    kind: item.kind
+    kind: item.kind,
+    toolName: item.toolName
   };
+  if (withSourceUrls && item.state === "complete") {
+    const sourceUrls = collectSourceUrls(item.result);
+    if (sourceUrls.length > 0) step.sourceUrls = sourceUrls;
+  }
   const args = item.args;
   if (!args || !item.toolName.startsWith("chrome_")) return step;
   const tabId = args.tabId ?? args.tab_id;
@@ -69,6 +75,59 @@ function visibleTimelineSteps({ steps, limit }) {
     (step, index) => index >= steps.length - safeLimit || step.state === "running" || step.state === "waiting"
   );
 }
+const SOURCE_URL_KEYS = ["url", "link", "href"];
+const MAX_SOURCE_URLS = 3;
+const MAX_SOURCE_DEPTH = 4;
+const MAX_SOURCE_RESULT_CHARS = 256 * 1024;
+function parseJson(text) {
+  if (text.length > MAX_SOURCE_RESULT_CHARS) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function parseResult(result) {
+  if (typeof result === "string") return parseJson(result);
+  if (Array.isArray(result) && result.length > 0 && result.every(isTextBlock)) {
+    return parseJson(result.map((block) => block.text).join(""));
+  }
+  return result;
+}
+function isTextBlock(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const block = value;
+  return block.type === "text" && typeof block.text === "string";
+}
+function collectSourceUrls(result) {
+  const urls = [];
+  const hosts = /* @__PURE__ */ new Set();
+  const visit = ({ value, depth }) => {
+    if (urls.length >= MAX_SOURCE_URLS || depth > MAX_SOURCE_DEPTH || value === null) return;
+    if (Array.isArray(value)) {
+      for (const entry of value) visit({ value: entry, depth: depth + 1 });
+      return;
+    }
+    if (typeof value !== "object") return;
+    const record = value;
+    for (const key of SOURCE_URL_KEYS) {
+      const candidate = record[key];
+      if (typeof candidate !== "string") continue;
+      const host = pageTarget(candidate);
+      if (host && !hosts.has(host)) {
+        hosts.add(host);
+        urls.push(candidate);
+      }
+      break;
+    }
+    for (const entry of Object.values(record)) {
+      if (typeof entry === "object") visit({ value: entry, depth: depth + 1 });
+    }
+  };
+  visit({ value: parseResult(result), depth: 0 });
+  return urls;
+}
+exports.collectSourceUrls = collectSourceUrls;
 exports.toTimelineStep = toTimelineStep;
 exports.visibleTimelineSteps = visibleTimelineSteps;
 //# sourceMappingURL=timeline-step.cjs.map

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, 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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"}
+{"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  /** The tool a `tool` step called, so a host can show that tool's icon. */\n  toolName?: string;\n  /** Web pages a finished step's result names (up to three, one per site), for their favicons. */\n  sourceUrls?: readonly string[];\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  withSourceUrls = false,\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  /** Read the web pages a finished result names into `sourceUrls` (only when the card shows favicons). */\n  withSourceUrls?: boolean;\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    toolName: item.toolName,\n  };\n  if (withSourceUrls && item.state === 'complete') {\n    const sourceUrls = collectSourceUrls(item.result);\n    if (sourceUrls.length > 0) step.sourceUrls = sourceUrls;\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\nconst SOURCE_URL_KEYS = ['url', 'link', 'href'] as const;\nconst MAX_SOURCE_URLS = 3;\nconst MAX_SOURCE_DEPTH = 4;\n\nconst MAX_SOURCE_RESULT_CHARS = 256 * 1024;\n\nfunction parseJson(text: string): unknown {\n  if (text.length > MAX_SOURCE_RESULT_CHARS) return undefined;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n}\n\n/** A result as JSON: an object, a JSON string, or LangChain text blocks holding JSON. */\nfunction parseResult(result: unknown): unknown {\n  if (typeof result === 'string') return parseJson(result);\n  if (Array.isArray(result) && result.length > 0 && result.every(isTextBlock)) {\n    return parseJson(result.map((block) => block.text).join(''));\n  }\n  return result;\n}\n\nfunction isTextBlock(value: unknown): value is { type: 'text'; text: string } {\n  if (typeof value !== 'object' || value === null) return false;\n  const block = value as Record<string, unknown>;\n  return block.type === 'text' && typeof block.text === 'string';\n}\n\n/**\n * The web pages a tool result lists (a search's `results[].url`), at most one\n * per site and three in all, in the order the result gives them. Only http(s)\n * links count; anything else in the result is ignored.\n */\nexport function collectSourceUrls(result: unknown): string[] {\n  const urls: string[] = [];\n  const hosts = new Set<string>();\n  const visit = ({ value, depth }: { value: unknown; depth: number }): void => {\n    if (urls.length >= MAX_SOURCE_URLS || depth > MAX_SOURCE_DEPTH || value === null) return;\n    if (Array.isArray(value)) {\n      for (const entry of value) visit({ value: entry, depth: depth + 1 });\n      return;\n    }\n    if (typeof value !== 'object') return;\n    const record = value as Record<string, unknown>;\n    for (const key of SOURCE_URL_KEYS) {\n      const candidate = record[key];\n      if (typeof candidate !== 'string') continue;\n      const host = pageTarget(candidate);\n      if (host && !hosts.has(host)) {\n        hosts.add(host);\n        urls.push(candidate);\n      }\n      break;\n    }\n    for (const entry of Object.values(record)) {\n      if (typeof entry === 'object') visit({ value: entry, depth: depth + 1 });\n    }\n  };\n  visit({ value: parseResult(result), depth: 0 });\n  return urls;\n}\n"],"names":["getReasoningLabel","summarizeActivityTool"],"mappings":"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"}

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

@@ -11,16 +11,28 @@ export interface TimelineStep {
     chip?: string;
     state: ActivityItem['state'];
     kind: ActivityItem['kind'];
+    /** The tool a `tool` step called, so a host can show that tool's icon. */
+    toolName?: string;
+    /** Web pages a finished step's result names (up to three, one per site), for their favicons. */
+    sourceUrls?: readonly string[];
 }
-export declare function toTimelineStep({ item, index, resolveToolDisplayName, assetTitles, }: {
+export declare function toTimelineStep({ item, index, resolveToolDisplayName, assetTitles, withSourceUrls, }: {
     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>;
+    /** Read the web pages a finished result names into `sourceUrls` (only when the card shows favicons). */
+    withSourceUrls?: boolean;
 }): TimelineStep;
 /** Every unresolved parallel call stays visible even when older settled steps fold away. */
 export declare function visibleTimelineSteps({ steps, limit }: {
     steps: readonly TimelineStep[];
     limit: number;
 }): TimelineStep[];
+/**
+ * The web pages a tool result lists (a search's `results[].url`), at most one
+ * per site and three in all, in the order the result gives them. Only http(s)
+ * links count; anything else in the result is ignored.
+ */
+export declare function collectSourceUrls(result: unknown): string[];

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

@@ -28,7 +28,8 @@ function toTimelineStep({
   item,
   index,
   resolveToolDisplayName,
-  assetTitles
+  assetTitles,
+  withSourceUrls = false
 }) {
   const id = item.id ?? `${item.kind}-${index}`;
   if (item.kind !== "tool") {
@@ -42,8 +43,13 @@ function toTimelineStep({
     ...summary.detail ? { detail: summary.detail } : {},
     ...summary.meta ? { chip: summary.meta } : {},
     state: item.state,
-    kind: item.kind
+    kind: item.kind,
+    toolName: item.toolName
   };
+  if (withSourceUrls && item.state === "complete") {
+    const sourceUrls = collectSourceUrls(item.result);
+    if (sourceUrls.length > 0) step.sourceUrls = sourceUrls;
+  }
   const args = item.args;
   if (!args || !item.toolName.startsWith("chrome_")) return step;
   const tabId = args.tabId ?? args.tab_id;
@@ -67,7 +73,60 @@ function visibleTimelineSteps({ steps, limit }) {
     (step, index) => index >= steps.length - safeLimit || step.state === "running" || step.state === "waiting"
   );
 }
+const SOURCE_URL_KEYS = ["url", "link", "href"];
+const MAX_SOURCE_URLS = 3;
+const MAX_SOURCE_DEPTH = 4;
+const MAX_SOURCE_RESULT_CHARS = 256 * 1024;
+function parseJson(text) {
+  if (text.length > MAX_SOURCE_RESULT_CHARS) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function parseResult(result) {
+  if (typeof result === "string") return parseJson(result);
+  if (Array.isArray(result) && result.length > 0 && result.every(isTextBlock)) {
+    return parseJson(result.map((block) => block.text).join(""));
+  }
+  return result;
+}
+function isTextBlock(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const block = value;
+  return block.type === "text" && typeof block.text === "string";
+}
+function collectSourceUrls(result) {
+  const urls = [];
+  const hosts = /* @__PURE__ */ new Set();
+  const visit = ({ value, depth }) => {
+    if (urls.length >= MAX_SOURCE_URLS || depth > MAX_SOURCE_DEPTH || value === null) return;
+    if (Array.isArray(value)) {
+      for (const entry of value) visit({ value: entry, depth: depth + 1 });
+      return;
+    }
+    if (typeof value !== "object") return;
+    const record = value;
+    for (const key of SOURCE_URL_KEYS) {
+      const candidate = record[key];
+      if (typeof candidate !== "string") continue;
+      const host = pageTarget(candidate);
+      if (host && !hosts.has(host)) {
+        hosts.add(host);
+        urls.push(candidate);
+      }
+      break;
+    }
+    for (const entry of Object.values(record)) {
+      if (typeof entry === "object") visit({ value: entry, depth: depth + 1 });
+    }
+  };
+  visit({ value: parseResult(result), depth: 0 });
+  return urls;
+}
 export {
+  collectSourceUrls,
   toTimelineStep,
   visibleTimelineSteps
 };

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, 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":";AAgBA,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;AAAA,EACA;AACF,GAMiB;AACf,QAAM,KAAK,KAAK,MAAM,GAAG,KAAK,IAAI,IAAI,KAAK;AAC3C,MAAI,KAAK,SAAS,QAAQ;AACxB,WAAO,EAAE,IAAI,MAAM,kBAAkB,KAAK,MAAM,KAAK,KAAK,GAAG,OAAO,KAAK,OAAO,MAAM,KAAK,KAAA;AAAA,EAC7F;AACA,QAAM,UAAU,sBAAsB,MAAM,wBAAwB,WAAW;AAC/E,QAAM,OAAqB;AAAA,IACzB;AAAA,IACA,MAAM,QAAQ;AAAA,IACd,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,KAAA,IAAS,CAAA;AAAA,IAC5C,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAA,IAAW,CAAA;AAAA,IAClD,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,KAAA,IAAS,CAAA;AAAA,IAC5C,OAAO,KAAK;AAAA,IACZ,MAAM,KAAK;AAAA,EAAA;AAEb,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  /** The tool a `tool` step called, so a host can show that tool's icon. */\n  toolName?: string;\n  /** Web pages a finished step's result names (up to three, one per site), for their favicons. */\n  sourceUrls?: readonly string[];\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  withSourceUrls = false,\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  /** Read the web pages a finished result names into `sourceUrls` (only when the card shows favicons). */\n  withSourceUrls?: boolean;\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    toolName: item.toolName,\n  };\n  if (withSourceUrls && item.state === 'complete') {\n    const sourceUrls = collectSourceUrls(item.result);\n    if (sourceUrls.length > 0) step.sourceUrls = sourceUrls;\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\nconst SOURCE_URL_KEYS = ['url', 'link', 'href'] as const;\nconst MAX_SOURCE_URLS = 3;\nconst MAX_SOURCE_DEPTH = 4;\n\nconst MAX_SOURCE_RESULT_CHARS = 256 * 1024;\n\nfunction parseJson(text: string): unknown {\n  if (text.length > MAX_SOURCE_RESULT_CHARS) return undefined;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n}\n\n/** A result as JSON: an object, a JSON string, or LangChain text blocks holding JSON. */\nfunction parseResult(result: unknown): unknown {\n  if (typeof result === 'string') return parseJson(result);\n  if (Array.isArray(result) && result.length > 0 && result.every(isTextBlock)) {\n    return parseJson(result.map((block) => block.text).join(''));\n  }\n  return result;\n}\n\nfunction isTextBlock(value: unknown): value is { type: 'text'; text: string } {\n  if (typeof value !== 'object' || value === null) return false;\n  const block = value as Record<string, unknown>;\n  return block.type === 'text' && typeof block.text === 'string';\n}\n\n/**\n * The web pages a tool result lists (a search's `results[].url`), at most one\n * per site and three in all, in the order the result gives them. Only http(s)\n * links count; anything else in the result is ignored.\n */\nexport function collectSourceUrls(result: unknown): string[] {\n  const urls: string[] = [];\n  const hosts = new Set<string>();\n  const visit = ({ value, depth }: { value: unknown; depth: number }): void => {\n    if (urls.length >= MAX_SOURCE_URLS || depth > MAX_SOURCE_DEPTH || value === null) return;\n    if (Array.isArray(value)) {\n      for (const entry of value) visit({ value: entry, depth: depth + 1 });\n      return;\n    }\n    if (typeof value !== 'object') return;\n    const record = value as Record<string, unknown>;\n    for (const key of SOURCE_URL_KEYS) {\n      const candidate = record[key];\n      if (typeof candidate !== 'string') continue;\n      const host = pageTarget(candidate);\n      if (host && !hosts.has(host)) {\n        hosts.add(host);\n        urls.push(candidate);\n      }\n      break;\n    }\n    for (const entry of Object.values(record)) {\n      if (typeof entry === 'object') visit({ value: entry, depth: depth + 1 });\n    }\n  };\n  visit({ value: parseResult(result), depth: 0 });\n  return urls;\n}\n"],"names":[],"mappings":"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"}

package/dist/chat-ui/mentions/mention-chip.cjs

@@ -10,6 +10,7 @@ const assetUrls = require("../lib/asset-urls.cjs");
 const apiClient = require("./suggestions/data/api-client.cjs");
 const assetTypeIcons = require("./suggestions/data/sources/asset-type-icons.cjs");
 const useMemberAvatar = require("./use-member-avatar.cjs");
+const useMentionAsset = require("./use-mention-asset.cjs");
 const screenPoint = require("../../agent-runtime/src/screen-point.cjs");
 const cnfast = require("cnfast");
 const SPACES_MENTION_PATH = /\/dashboard\/spaces\/?\?/;
@@ -81,11 +82,62 @@ const ASSET_CHIP_ICONS = {
   web_page: lucideReact.Globe2Icon,
   browse_session: lucideReact.Globe2Icon
 };
-function assetChipIcon(assetType, citation) {
-  if ((citation == null ? void 0 : citation.anchorType) === "file_line_range") return lucideReact.FileCodeIcon;
+function assetChipIcon(assetType) {
   return assetType && ASSET_CHIP_ICONS[assetType.toLowerCase()] || lucideReact.FileIcon;
 }
+function GitHubMarkIcon({ className }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "svg",
+    {
+      viewBox: "0 0 16 16",
+      fill: "currentColor",
+      "aria-hidden": "true",
+      className,
+      "data-chip-icon": "github",
+      children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z" })
+    }
+  );
+}
+const SESSION_ANCHORS = /* @__PURE__ */ new Set([
+  "msg",
+  "msg_range",
+  "msg_block",
+  "msg_section",
+  "msg_text",
+  "tool_call"
+]);
+function isSessionLink(assetType, citation) {
+  return (assetType == null ? void 0 : assetType.toLowerCase()) === "session" || citation !== void 0 && SESSION_ANCHORS.has(citation.anchorType);
+}
+const PLACE_FITS_CHARS = 20;
+function splitFileLines(label) {
+  const colon = label.lastIndexOf(":");
+  return colon > 0 ? { file: label.slice(0, colon), lines: label.slice(colon) } : { file: label, lines: "" };
+}
+function restatesPlace(name, citation) {
+  const said = name.trim().toLowerCase();
+  const label = citation.label.toLowerCase();
+  return said === label || said === citation.description.toLowerCase() || said.endsWith(label);
+}
+function informativeLabel({
+  label,
+  shown,
+  citation
+}) {
+  const trimmed = label.trim();
+  if (!trimmed || !SPEAKABLE.test(trimmed)) return null;
+  if (PLACEHOLDER_LABELS.has(trimmed.toLowerCase())) return null;
+  if (citation && restatesPlace(trimmed, citation)) return null;
+  const shownWords = new Set(
+    [...shown, citation == null ? void 0 : citation.description].flatMap((text) => text ? wordsOf(text) : [])
+  );
+  return wordsOf(trimmed).every((word) => shownWords.has(word)) ? null : trimmed;
+}
+function wordsOf(text) {
+  return text.toLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [];
+}
 const SPEAKABLE = /[\p{L}\p{N}]/u;
+const PLACEHOLDER_LABELS = /* @__PURE__ */ new Set(["citation", "source", "link", "here"]);
 function decodeAssetLink(url, decode) {
   try {
     return decode(url);
@@ -97,9 +149,15 @@ function personEmailForMention(parsed) {
   if (parsed.type !== "person") return void 0;
   return parsed.email || (parsed.id.includes("@") ? parsed.id : void 0);
 }
+function textOf(node) {
+  if (typeof node === "string" || typeof node === "number") return String(node);
+  if (Array.isArray(node)) return node.map(textOf).join("");
+  if (react.isValidElement(node)) return textOf(node.props.children);
+  return "";
+}
 const MentionLink = ({ href, children, interactive = true }) => {
   if (href && (href.startsWith("mention://") || isSpacesMentionUrl(href))) {
-    const name = typeof children === "string" ? children.replace(/^@/, "") : Array.isArray(children) ? String(children[0] ?? "").replace(/^@/, "") : "";
+    const name = textOf(children).trim().replace(/^@/, "");
     const parsed = parseMentionUrl(href);
     return /* @__PURE__ */ jsxRuntime.jsx(
       MentionChip,
@@ -124,6 +182,9 @@ const MentionLink = ({ href, children, interactive = true }) => {
   }
   return /* @__PURE__ */ jsxRuntime.jsx("a", { href, target: "_blank", rel: "noopener noreferrer", children });
 };
+const CHIP_PILL_CLASS = "not-prose box-border inline-flex h-5 items-center gap-1.5 whitespace-nowrap rounded-md border border-border bg-muted px-1 py-0.5 align-middle font-normal leading-none text-foreground no-underline";
+const CHIP_LINK_CLASS = "cursor-pointer transition-colors hover:bg-accent hover:text-accent-foreground hover:no-underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-offset-1";
+const CHIP_ICON_CLASS = "size-4 shrink-0";
 const ScreenPointChip = ({ href, children }) => {
   const parsed = screenPoint.parseScreenPointHref(href);
   if (!parsed.ok) {
@@ -133,14 +194,14 @@ const ScreenPointChip = ({ href, children }) => {
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "span",
     {
-      className: "not-prose inline-flex max-w-[260px] items-center gap-1 whitespace-nowrap rounded-md border border-slate-300 bg-white px-1.5 py-px align-middle text-[0.85em] font-medium leading-[1.4] text-slate-600",
+      className: cnfast.cn(CHIP_PILL_CLASS, "max-w-[260px]"),
       title: description,
       "aria-label": description,
       "data-screen-point": "valid",
       children: [
-        /* @__PURE__ */ jsxRuntime.jsx(lucideReact.CrosshairIcon, { className: "size-3.5 shrink-0", "aria-hidden": "true" }),
-        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "max-w-[180px] overflow-hidden text-ellipsis", children }),
-        /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "font-normal text-slate-400", children: [
+        /* @__PURE__ */ jsxRuntime.jsx(lucideReact.CrosshairIcon, { className: CHIP_ICON_CLASS, "aria-hidden": "true" }),
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "min-w-0 max-w-[180px] overflow-hidden text-ellipsis", children }),
+        /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "shrink-0 text-xs text-muted-foreground", children: [
           parsed.point.x,
           ", ",
           parsed.point.y
@@ -164,8 +225,21 @@ const MentionChip = ({
   const memberAvatarUrl = useMemberAvatar.useMemberAvatarUrl(personEmail);
   const [erroredAvatarUrl, setErroredAvatarUrl] = react.useState();
   const excerpt = sourceHref ? readSourceExcerpt(sourceHref) : null;
-  const tooltip = excerpt ?? (citation == null ? void 0 : citation.description) ?? null;
-  const anchorLabel = citation && name !== citation.description && name !== citation.label ? citation.label : null;
+  const repositoryFile = (citation == null ? void 0 : citation.anchorType) === "file_line_range" ? { ...splitFileLines(citation.label), label: citation.label } : null;
+  const asset = useMentionAsset.useMentionAsset(
+    type === "asset" && (assetIds == null ? void 0 : assetIds.length) === 1 && !repositoryFile && !isSessionLink(assetType, citation) ? assetIds[0] : void 0
+  );
+  const assetTitle = (asset == null ? void 0 : asset.title) || null;
+  const chipName = (repositoryFile == null ? void 0 : repositoryFile.label) ?? assetTitle ?? name;
+  const placeLabel = citation && !repositoryFile && !restatesPlace(chipName, citation) ? citation.label : null;
+  const tooltip = citation || excerpt ? tooltipText({
+    lines: [
+      informativeLabel({ label: name, shown: [chipName, assetTitle], citation }),
+      repositoryFile ? assetTitle : null,
+      repositoryFile || !excerpt || ((placeLabel == null ? void 0 : placeLabel.length) ?? 0) > PLACE_FITS_CHARS ? citation == null ? void 0 : citation.description : null
+    ],
+    excerpt
+  }) : null;
   const assetRootHref = type === "asset" && (assetIds == null ? void 0 : assetIds.length) ? assetUrls.createOlympusAssetUrl({
     appUrl: auth == null ? void 0 : auth.appUrl,
     backendUrl: auth == null ? void 0 : auth.backendUrl,
@@ -185,51 +259,71 @@ const MentionChip = ({
       return assetRootHref;
     }
   })();
-  const className = cnfast.cn(
-    "not-prose inline-flex max-w-[220px] items-center gap-1 whitespace-nowrap rounded-md border border-slate-300 bg-white px-1.5 py-px align-middle text-[0.85em] font-medium leading-[1.4] text-slate-600 no-underline",
-    // The cited place gets its own room after a name already at its cap.
-    anchorLabel && "max-w-[340px]",
-    href && "cursor-pointer transition-colors hover:border-slate-400 hover:bg-slate-50 hover:text-slate-800 hover:no-underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-offset-1"
-  );
-  const AssetIcon = assetChipIcon(assetType, citation);
+  const className = cnfast.cn(CHIP_PILL_CLASS, "max-w-[275px]", href && CHIP_LINK_CLASS);
+  const chipThumbnailUrl = repositoryFile ? void 0 : (asset == null ? void 0 : asset.assetType) && assetTypeIcons.assetTypeToThumb(asset.assetType) || thumbnailUrl;
+  const AssetIcon = assetChipIcon((asset == null ? void 0 : asset.assetType) || assetType);
   const contents = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-    thumbnailUrl && /* @__PURE__ */ jsxRuntime.jsx(
+    repositoryFile ? /* @__PURE__ */ jsxRuntime.jsx(GitHubMarkIcon, { className: CHIP_ICON_CLASS }) : chipThumbnailUrl ? /* @__PURE__ */ jsxRuntime.jsx(
       "img",
       {
-        src: thumbnailUrl,
+        src: chipThumbnailUrl,
         alt: "",
-        className: "size-3.5 shrink-0",
+        className: CHIP_ICON_CLASS,
         draggable: false
       }
-    ),
-    !thumbnailUrl && (type === "asset" || type === "folder") && // A host that bundles no asset-type SVGs (computer apps, most SDK
-    // apps) still gets the type's icon.
-    /* @__PURE__ */ jsxRuntime.jsx(AssetIcon, { className: "size-3.5 shrink-0", "aria-hidden": "true" }),
-    !thumbnailUrl && type === "webpage" && /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Globe2Icon, { className: "size-3.5 shrink-0", "aria-hidden": "true" }),
-    !thumbnailUrl && type === "person" && (memberAvatarUrl && erroredAvatarUrl !== memberAvatarUrl ? /* @__PURE__ */ jsxRuntime.jsx(
+    ) : type === "asset" || type === "folder" ? (
+      // A host that bundles no asset-type SVGs (computer apps, most SDK
+      // apps) still gets the type's icon.
+      /* @__PURE__ */ jsxRuntime.jsx(AssetIcon, { className: CHIP_ICON_CLASS, "aria-hidden": "true" })
+    ) : type === "webpage" ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Globe2Icon, { className: CHIP_ICON_CLASS, "aria-hidden": "true" }) : type === "person" ? memberAvatarUrl && erroredAvatarUrl !== memberAvatarUrl ? /* @__PURE__ */ jsxRuntime.jsx(
       "img",
       {
         src: memberAvatarUrl,
         alt: "",
-        className: "size-3.5 shrink-0 rounded-full object-cover",
+        className: cnfast.cn(CHIP_ICON_CLASS, "rounded-full object-cover"),
         draggable: false,
         onError: () => setErroredAvatarUrl(memberAvatarUrl)
       }
-    ) : /* @__PURE__ */ jsxRuntime.jsx(lucideReact.UserIcon, { className: "size-3.5 shrink-0", "aria-hidden": "true" })),
-    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "max-w-[180px] overflow-hidden text-ellipsis", children: name }),
-    citation && anchorLabel && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    ) : /* @__PURE__ */ jsxRuntime.jsx(lucideReact.UserIcon, { className: CHIP_ICON_CLASS, "aria-hidden": "true" }) : null,
+    repositoryFile ? /* @__PURE__ */ jsxRuntime.jsxs(
+      "span",
+      {
+        className: "flex min-w-0 items-center",
+        "data-citation-anchor": "file_line_range",
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "min-w-0 overflow-hidden text-ellipsis", children: repositoryFile.file }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "shrink-0 text-muted-foreground", children: repositoryFile.lines })
+        ]
+      }
+    ) : /* @__PURE__ */ jsxRuntime.jsx(
+      "span",
+      {
+        className: cnfast.cn(
+          "max-w-[180px] overflow-hidden text-ellipsis",
+          // A long place may shorten the name, never make it vanish.
+          placeLabel && "min-w-8"
+        ),
+        children: chipName
+      }
+    ),
+    citation && placeLabel && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
       " ",
-      /* @__PURE__ */ jsxRuntime.jsx(
+      /* @__PURE__ */ jsxRuntime.jsxs(
         "span",
         {
-          className: "max-w-[140px] shrink-0 overflow-hidden text-ellipsis font-normal text-slate-400",
+          className: "flex min-w-0 items-center text-xs text-muted-foreground",
           "data-citation-anchor": citation.anchorType,
-          children: anchorLabel
+          children: [
+            "[",
+            /* @__PURE__ */ jsxRuntime.jsx("span", { className: "min-w-0 overflow-hidden text-ellipsis", children: placeLabel }),
+            "]"
+          ]
         }
       )
     ] })
   ] });
   if (href && interactive) {
+    const speakablePlace = citation && SPEAKABLE.test(citation.description);
     return /* @__PURE__ */ jsxRuntime.jsx(
       "a",
       {
@@ -237,10 +331,10 @@ const MentionChip = ({
         target: "_blank",
         rel: "noopener noreferrer",
         className,
-        "aria-label": anchorLabel && citation && SPEAKABLE.test(citation.description) ? `Open ${name} at ${citation.description} in Spaces` : `Open ${name} in Spaces`,
-        title: tooltip ?? `Open ${name} in Spaces`,
+        "aria-label": repositoryFile && citation ? `Open ${citation.description} in Spaces` : placeLabel && citation && speakablePlace ? `Open ${chipName} at ${citation.description} in Spaces` : `Open ${chipName} in Spaces`,
+        title: tooltip ?? `Open ${chipName} in Spaces`,
         "data-excerpt": excerpt ?? void 0,
-        "data-mention-name": name,
+        "data-mention-name": repositoryFile ? assetTitle ?? name : chipName,
         children: contents
       }
     );
@@ -255,6 +349,18 @@ const MentionChip = ({
     }
   );
 };
+function tooltipText({
+  lines,
+  excerpt
+}) {
+  const kept = [];
+  for (const line of lines) {
+    const trimmed = line == null ? void 0 : line.trim();
+    if (trimmed && !kept.includes(trimmed)) kept.push(trimmed);
+  }
+  if (excerpt) kept.push(kept.length ? `“${excerpt}”` : excerpt);
+  return kept.length ? kept.join("\n") : null;
+}
 function readSourceExcerpt(href) {
   var _a;
   try {
@@ -400,6 +506,9 @@ function mentionsToPlainText(text) {
     return `@${name || parseMentionUrl(url).name}`;
   });
 }
+exports.CHIP_ICON_CLASS = CHIP_ICON_CLASS;
+exports.CHIP_LINK_CLASS = CHIP_LINK_CLASS;
+exports.CHIP_PILL_CLASS = CHIP_PILL_CLASS;
 exports.MentionChip = MentionChip;
 exports.MentionLink = MentionLink;
 exports.ScreenPointChip = ScreenPointChip;