@opengeni/react 6.1.0 → 7.0.0-canary.35625901699001

package/src/timeline/compaction-copy.ts

@@ -0,0 +1,40 @@
+import type { ContextCompactionItem } from "./types";
+
+/**
+ * Subtitle for a settled compaction landmark. A definitive provider rejection
+ * repeats deterministically for the same conversation, so it names the
+ * rejected field and withholds the generic retry promise; every other skip
+ * keeps its existing copy.
+ */
+export function compactionSkipSubtitle(
+  reason: string | null,
+  providerRejection: ContextCompactionItem["providerRejection"] = null,
+): string {
+  switch (reason) {
+    case "no_history":
+      return "No active history to compact";
+    case "replacement_not_smaller":
+      return "Checkpoint would not reduce memory size";
+    case "replacement_unchanged":
+      return "Checkpoint made no progress";
+    case "summarization_failed":
+      return providerRejection
+        ? `The model provider rejected the compaction request (${describeCompactionProviderRejection(providerRejection)}). Chat history is unchanged. Repeating it fails the same way until the conversation changes; if a new message fails again, start a new session.`
+        : "Request it again to retry. Chat history is unchanged.";
+    default:
+      return "Compaction was not needed. Chat history is unchanged.";
+  }
+}
+
+/** `HTTP 400 invalid_request_error, param input[3].encrypted_content`; identifiers only. */
+export function describeCompactionProviderRejection(
+  rejection: NonNullable<ContextCompactionItem["providerRejection"]>,
+): string {
+  const parts = [
+    `HTTP ${rejection.httpStatus}${rejection.type ? ` ${rejection.type}` : ""}${
+      rejection.code ? ` ${rejection.code}` : ""
+    }`,
+  ];
+  if (rejection.param) parts.push(`param ${rejection.param}`);
+  return parts.join(", ");
+}

package/src/timeline/platform-activity-row.tsx

@@ -73,7 +73,7 @@ export default function PlatformActivityRow({
         : startupPhaseTitle(item.phase, item.status, item.outcome),
     preview:
       item.phase === "model_preparation"
-        ? "Includes overlapping sandbox, rig, repository, and runtime setup shown below."
+        ? "Includes overlapping sandbox startup, custom environment setup, repository preparation, and runtime setup shown below."
         : undefined,
     running,
     failed,
@@ -140,7 +140,7 @@ function startupPhaseTitle(
     return `Sandbox ${outcome === "resumed" ? "reattached" : outcome}`;
   }
   if (status === "complete" && phase === "rig" && outcome === "skipped") {
-    return "Rig already ready";
+    return "Sandbox Environment already ready";
   }
   const statusIndex =
     status === "running" ? 0 : status === "failed" ? 1 : status === "cancelled" ? 2 : 3;
@@ -163,7 +163,12 @@ const STARTUP_PHASE_TITLES: Record<
     "Sandbox startup interrupted",
     "Sandbox ready",
   ],
-  rig: ["Setting up rig", "Rig setup failed", "Rig setup interrupted", "Rig ready"],
+  rig: [
+    "Setting up sandbox environment",
+    "Sandbox Environment setup failed",
+    "Sandbox Environment setup interrupted",
+    "Sandbox Environment ready",
+  ],
   repository: [
     "Preparing repository",
     "Repository preparation failed",

package/src/timeline/projection.ts

@@ -1,5 +1,6 @@
 import {
   parseMediaGenerationResult,
+  parseToolDisplayMetadata,
   type HumanInputAnswer,
   type HumanInputQuestion,
   type HumanInputResponse,
@@ -129,10 +130,20 @@ function timelineAnnotationToolOutputText(output: unknown): string | null {
   return text.length > 0 ? text : null;
 }
 
-export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
+export function buildTimeline(
+  events: SessionEvent[],
+  options: { partialStart?: boolean } = {},
+): TimelineItem[] {
   const items: TimelineItem[] = [];
   const prescan = prescanTurnAnchors(events);
   const ordered = orderTimelineEvents(events, prescan);
+  // A bounded replay can begin halfway through a message (including inside an
+  // interactive fence). Never parse that suffix as a complete Markdown source.
+  // Keep the raw events available for pagination; a completed receipt restores
+  // the authoritative message without requiring an unbounded history fetch.
+  let completeHistoryPrefix = options.partialStart !== true;
+  const knownMessagePrefixTurns = new Set<string | null>();
+  const incompleteMessageKeys = new Set<string>();
   const pendingWaitOutcomeByTurn = new Map<string | null, PendingWaitOutcome>();
   const latestAgentResponseByTurn = new Map<string | null, TrackedAgentResponse>();
   const identifiedMessages = new Map<string, AgentMessageItem>();
@@ -299,6 +310,18 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
   for (const event of ordered) {
     const payload = asRecord(event.payload);
     const turnId = event.turnId ?? null;
+    if (event.type === "session.created") {
+      completeHistoryPrefix = true;
+    } else if (
+      event.type === "turn.started" ||
+      (event.type === "user.message" &&
+        payload.delivery !== "steer" &&
+        payload.routing !== "accepted_for_steering")
+    ) {
+      // Accepted Steer is visible before its replacement turn starts. It says
+      // nothing about the prefix of a still-streaming message from the old turn.
+      knownMessagePrefixTurns.add(turnId);
+    }
     startupEvent = event;
     startupTurnId = turnId;
     startupAttemptId =
@@ -415,6 +438,13 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
         }
         const messageId = stringValue(payload.messageId);
         const messageKey = messageId ? JSON.stringify([turnId, messageId]) : null;
+        if (
+          (!completeHistoryPrefix && !knownMessagePrefixTurns.has(turnId)) ||
+          (messageKey && incompleteMessageKeys.has(messageKey))
+        ) {
+          if (messageKey) incompleteMessageKeys.add(messageKey);
+          break;
+        }
         const identified = messageKey ? identifiedMessages.get(messageKey) : undefined;
         if (identified) {
           if (identified.annotationSource?.eventType !== "agent.message.completed") {
@@ -470,6 +500,7 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
       }
 
       case "agent.message.completed": {
+        knownMessagePrefixTurns.add(turnId);
         const text = stringValue(payload.text);
         const messageId = stringValue(payload.messageId);
         const messageKey = messageId ? JSON.stringify([turnId, messageId]) : null;
@@ -580,6 +611,7 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
 
       case "agent.toolCall.created": {
         const name = typeof payload.name === "string" ? payload.name : "tool";
+        const display = parseToolDisplayMetadata(payload.display);
         const callId = typeof payload.id === "string" ? payload.id : null;
         const args = payload.arguments ?? null;
         closeStreamingTail();
@@ -621,6 +653,7 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
               (item): item is ToolCallItem => item.kind === "tool-call" && item.callId === callId,
             );
           if (existing) {
+            if (display) existing.display = display;
             if (args != null) {
               existing.arguments = args;
             }
@@ -637,6 +670,7 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
           turnId,
           callId,
           name,
+          ...(display ? { display } : {}),
           arguments: args,
           output: undefined,
           truncation: null,
@@ -915,6 +949,7 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
           estimatedTokensBefore: numberOrNull(payload.estimatedTokensBefore),
           estimatedTokensAfter: null,
           skipReason: null,
+          providerRejection: null,
           implementation:
             typeof payload.implementation === "string" ? payload.implementation : null,
           occurredAt: event.occurredAt,
@@ -932,6 +967,7 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
           estimatedTokensBefore: numberOrNull(payload.estimatedTokensBefore),
           estimatedTokensAfter: numberOrNull(payload.estimatedTokensAfter),
           skipReason: null,
+          providerRejection: null,
           implementation:
             typeof payload.implementation === "string" ? payload.implementation : null,
           occurredAt: event.occurredAt,
@@ -949,6 +985,7 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
           estimatedTokensBefore: numberOrNull(payload.estimatedTokensBefore),
           estimatedTokensAfter: null,
           skipReason: typeof payload.reason === "string" ? payload.reason : null,
+          providerRejection: compactionProviderRejection(payload),
           implementation:
             typeof payload.implementation === "string" ? payload.implementation : null,
           occurredAt: event.occurredAt,
@@ -1001,6 +1038,13 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
           id: event.id,
           turnId,
           serverId: typeof payload.serverId === "string" ? payload.serverId : null,
+          canonicalServerId:
+            typeof payload.canonicalServerId === "string" ? payload.canonicalServerId : null,
+          connectionSubjectScope:
+            payload.connectionSubjectScope === "subject" ||
+            payload.connectionSubjectScope === "workspace"
+              ? payload.connectionSubjectScope
+              : null,
           source: capability
             ? "capability"
             : event.type === "tool.auth_needed"
@@ -1277,7 +1321,16 @@ export function buildTimeline(events: SessionEvent[]): TimelineItem[] {
     }
   }
 
+  const sourceEventsById = new Map(events.map((event) => [event.id, event]));
   for (const item of items) {
+    const source = sourceEventsById.get(item.id);
+    const canonical = "annotationSource" in item ? item.annotationSource : undefined;
+    item.sourceEvents = [
+      ...(source ? [{ eventId: source.id, sequence: source.sequence }] : []),
+      ...(canonical && canonical.eventId !== source?.id
+        ? [{ eventId: canonical.eventId, sequence: canonical.sequence }]
+        : []),
+    ];
     if (item.kind === "agent-message") {
       item.text = stripOpaqueCitationTokens(item.text);
     }
@@ -2096,6 +2149,29 @@ function numberOrNull(value: unknown): number | null {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
 
+/**
+ * Read the closed provider-rejection record a `summarization_failed` skip
+ * carries. Only bounded identifiers are accepted; a provider message is never
+ * part of the payload and would be ignored here anyway.
+ */
+function compactionProviderRejection(
+  payload: Record<string, unknown>,
+): ContextCompactionItem["providerRejection"] {
+  const record = asRecord(payload.providerRejection);
+  if (typeof record.httpStatus !== "number" || !Number.isFinite(record.httpStatus)) {
+    return null;
+  }
+  const text = (value: unknown): string | null =>
+    typeof value === "string" && value.trim() ? value : null;
+  return {
+    httpStatus: record.httpStatus,
+    type: text(record.type),
+    code: text(record.code),
+    param: text(record.param),
+    requestId: text(record.requestId),
+  };
+}
+
 function compactionTrigger(payload: Record<string, unknown>): ContextCompactionItem["trigger"] {
   const trigger = payload.trigger;
   return trigger === "auto" ||
@@ -2527,7 +2603,7 @@ function capabilityAuthorizationRequest(
   if (
     typeof record.id !== "string" ||
     typeof record.name !== "string" ||
-    !["pack", "mcp", "api", "skill", "plugin"].includes(String(kind)) ||
+    !["mcp", "api", "skill", "plugin"].includes(String(kind)) ||
     !["built_in", "library", "configured", "public_registry", "registry", "manual"].includes(
       String(source),
     ) ||

package/src/timeline/rolling-activity.tsx

@@ -36,7 +36,9 @@ export function RollingActivity({
   const fallback = (
     <span className="og-rolling-label">
       <WrenchIcon className="size-3.5" />
-      <span>{item.kind === "tool-call" ? toolDisplayName(item.name) : "Working"}</span>
+      <span>
+        {item.kind === "tool-call" ? toolDisplayName(item.name, item.display) : "Working"}
+      </span>
     </span>
   );
   return (
@@ -46,7 +48,7 @@ export function RollingActivity({
     >
       <span className="sr-only">
         {item.kind === "tool-call"
-          ? toolDisplayName(item.name)
+          ? toolDisplayName(item.name, item.display)
           : item.kind === "reasoning"
             ? "Thinking"
             : "Working"}

package/src/timeline/shared.tsx

@@ -1,5 +1,6 @@
 import { CameraIcon, CameraOffIcon, ChevronRightIcon } from "lucide-react";
-import { createContext, useContext, useState, type ReactNode } from "react";
+import { createContext, useContext, useEffect, useState, type ReactNode } from "react";
+import { useTimelineSearchReveal } from "../components/timeline-search";
 import { cn } from "../lib/cn";
 import { stringifyPayload } from "../lib/format";
 import { useForcedDefaultOpen } from "./disclosure-context";
@@ -154,6 +155,10 @@ export function ActivityDisclosure({
   // absent in normal app usage, where the row starts collapsed.
   const forcedDefaultOpen = useForcedDefaultOpen();
   const [open, setOpen] = useState(defaultOpen ?? forcedDefaultOpen ?? false);
+  const searchReveal = useTimelineSearchReveal();
+  useEffect(() => {
+    if (searchReveal) setOpen(true);
+  }, [searchReveal]);
   const truncation = useContext(ToolCallTruncationContext);
   const compact = useContext(CompactActivityContext);
   if (compact)

package/src/timeline/startup-timings.tsx

@@ -3,7 +3,7 @@ import type { StartupPhaseItem } from "./types";
 const LABELS: Record<StartupPhaseItem["phase"], string> = {
   queue: "Worker queue",
   sandbox: "Sandbox",
-  rig: "Rig",
+  rig: "Sandbox Environment",
   repository: "Repository",
   files: "Files",
   tools: "Tools",

package/src/timeline/tool-display-name.ts

@@ -7,6 +7,8 @@
  * from argument JSON.
  */
 
+import type { ToolDisplayMetadata } from "@opengeni/sdk";
+
 /** Leaf tool name after the first `__` server boundary (or the whole name). */
 export function mcpToolLeaf(name: string): string {
   const boundary = name.indexOf("__");
@@ -26,10 +28,10 @@ export function toolMatchesLeaf(wireName: string, leaf: string): boolean {
  * Readable label for a tool call ("session_create" / "opengeni__session_create"
  * → "Session create"). Title-cases the first character of the leaf phrase.
  */
-export function toolDisplayName(name: string): string {
-  const phrase = mcpToolLeaf(name).replace(/[_-]+/g, " ").trim();
-  if (!phrase) {
-    return name;
-  }
-  return phrase.charAt(0).toUpperCase() + phrase.slice(1);
+export function toolDisplayName(name: string, display?: ToolDisplayMetadata): string {
+  if (!display && /^[a-f0-9]{64}$/.test(name)) return "Tool call";
+  const phrase = (display?.toolName ?? mcpToolLeaf(name)).replace(/[_-]+/g, " ").trim();
+  const title =
+    display?.title ?? (phrase ? phrase.charAt(0).toUpperCase() + phrase.slice(1) : name);
+  return display?.accountLabel ? `${title} — ${display.accountLabel}` : title;
 }

package/src/timeline/tool-renderers.tsx

@@ -1786,7 +1786,9 @@ function ToolSearchRenderer({ item }: ToolRendererProps) {
 function DocsSearchRenderer({ item }: ToolRendererProps) {
   const args = parseToolArgs(item.arguments);
   const query = typeof args.query === "string" ? args.query.trim() : "";
-  const title = query ? `Search “${truncatePreview(query, 48)}”` : toolDisplayName(item.name);
+  const title = query
+    ? `Search “${truncatePreview(query, 48)}”`
+    : toolDisplayName(item.name, item.display);
   const running = item.status === "running";
 
   if (running) {
@@ -1860,7 +1862,7 @@ function DocsSearchRenderer({ item }: ToolRendererProps) {
 function SetSessionTitleRenderer({ item }: ToolRendererProps) {
   const args = parseToolArgs(item.arguments);
   const titleArg = typeof args.title === "string" ? args.title.trim() : "";
-  const display = toolDisplayName(item.name);
+  const display = toolDisplayName(item.name, item.display);
   const previewTitle = titleArg ? truncatePreview(titleArg, 72) : "";
   const icon = <MessagesSquareIcon className={ICON_SIZE} />;
 
@@ -2198,7 +2200,7 @@ function RunOnRenderer({ item }: ToolRendererProps) {
 function GenericRenderer({ item }: ToolRendererProps) {
   const running = item.status === "running";
   const args = parseToolArgs(item.arguments);
-  const display = toolDisplayName(item.name);
+  const display = toolDisplayName(item.name, item.display);
   const icon = <GenericToolIcon name={item.name} />;
   // Goal tools: surface the objective text on the collapsed row so the in-cluster
   // tool replaces the old breakaway GoalRow pill without losing the gist.

package/src/timeline/turn-summary.tsx

@@ -14,6 +14,7 @@ import { CopyButton } from "../components/copy-button";
 import { cn } from "../lib/cn";
 import { MOTION_INSPECT_SCALE } from "../lib/motion-inspect";
 import { useForcedDefaultOpen } from "./disclosure-context";
+import { useTimelineSearchReveal } from "../components/timeline-search";
 import { useEntranceAnimation } from "./entrance";
 import { useFoldMemory, type FoldRestingState } from "./fold-memory";
 import {
@@ -125,8 +126,8 @@ export type TurnSummaryProps = {
   items: ActivityItem[];
   /**
    * The settled verdict — or absent for a completed CLUSTER of a still-running
-   * turn, which folds neutrally: no verdict glyph (the turn has none yet), a
-   * quiet pulse dot in its place so alignment and the running feel both hold.
+   * turn, which folds neutrally. Only unfinished activity inside this summary
+   * animates; the parent turn may still be composing a response elsewhere.
    */
   outcome?: TurnOutcome | undefined;
   /** A short failure reason shown inline on a failed chip (never hidden). */
@@ -202,6 +203,7 @@ export function TurnSummary({
   // An explicit `defaultOpen` always wins; otherwise an ancestor may seed it
   // (screenshot instrumentation); otherwise the turn starts folded.
   const forcedDefaultOpen = useForcedDefaultOpen();
+  const searchReveal = useTimelineSearchReveal();
   const foldMemory = useFoldMemory();
   // A remembered resting state outranks author defaults: a fold that already
   // finished its settle collapse (or that the reader closed) mounts closed
@@ -315,6 +317,18 @@ export function TurnSummary({
     }
     // oxlint-disable-next-line react-hooks/exhaustive-deps
   }, [settleFold]);
+  useEffect(() => {
+    if (!searchReveal) return;
+    clearSettleTimers();
+    settleArmedRef.current = false;
+    setSettling(false);
+    setSettlePhase(false);
+    setNestSuppressLatch(false);
+    setOpen(true);
+    rememberResting("open");
+    // Search is an explicit, persistent reader action, not a new fold default.
+    // oxlint-disable-next-line react-hooks/exhaustive-deps
+  }, [searchReveal]);
   const onOpenChange = (next: boolean) => {
     // The reader took over — cancel the pending auto-collapse for good.
     // Clear settle CSS phase immediately (fast collapse) but keep nest latch
@@ -447,7 +461,7 @@ export function TurnSummary({
             />
             {/* Completion is the quiet default and needs no repeated glyph. Failed,
             cancelled, and still-running folds retain a visible state marker. */}
-            {outcome === "complete" || (liveHeader && !outcome) ? null : (
+            {outcome === "complete" || (!outcome && (liveHeader || context.settled)) ? null : (
               <span
                 className={cn(
                   "inline-flex shrink-0 items-center justify-center",

package/src/timeline/types.ts

@@ -8,6 +8,7 @@ import type {
   TimelineAnnotationSource,
   ToolAuthNeededPayload,
   ToolRef,
+  ToolDisplayMetadata,
 } from "@opengeni/sdk";
 
 /* ----------------------------------------------------------------------------
@@ -129,6 +130,7 @@ export type ToolCallItem = {
   turnId: string | null;
   callId: string | null;
   name: string;
+  display?: ToolDisplayMetadata;
   arguments: unknown;
   output: unknown;
   truncation?: ToolCallTruncation | null;
@@ -383,11 +385,24 @@ export type ContextCompactionItem = {
   estimatedTokensBefore: number | null;
   estimatedTokensAfter: number | null;
   skipReason: string | null;
+  /**
+   * Present only for a `summarization_failed` skip where the provider
+   * definitively rejected the compaction request. Content-free identifiers.
+   */
+  providerRejection: ContextCompactionProviderRejection | null;
   /** Provider implementation id for debug disclosure only. */
   implementation: string | null;
   occurredAt: string;
 };
 
+export type ContextCompactionProviderRejection = {
+  httpStatus: number;
+  type: string | null;
+  code: string | null;
+  param: string | null;
+  requestId: string | null;
+};
+
 export type MachineInputMember = {
   id: string;
   kind:
@@ -438,6 +453,9 @@ export type AuthNeededItem = {
   turnId: string | null;
   /** The runtime surface that requested recovery, when the event is an MCP auth signal. */
   serverId: string | null;
+  /** Explicit recovery identity; never inferred from an opaque execution alias. */
+  canonicalServerId?: string | null;
+  connectionSubjectScope?: "workspace" | "subject" | null;
   /** Durable event family that produced this notice. */
   source?: "tool" | "credential" | "capability" | undefined;
   /** The connection's registrable domain, e.g. "linear.app". */
@@ -473,7 +491,7 @@ export type TurnEndItem = {
   occurredAt: string;
 };
 
-export type TimelineItem =
+export type TimelineItem = (
   | UserMessageItem
   | HumanInputItem
   | AgentMessageItem
@@ -492,7 +510,11 @@ export type TimelineItem =
   | MemoryItem
   | KnowledgeItem
   | FleetDecisionItem
-  | TurnEndItem;
+  | TurnEndItem
+) & {
+  /** Durable identities, independent of renderer/reconciliation keys. */
+  sourceEvents?: readonly { eventId: string; sequence: number }[] | undefined;
+};
 
 /** Activity items cluster between chat messages (reasoning, tools, workers, sandbox, memory). */
 export type ActivityItem =