@opengeni/react 0.48.0 → 0.57.0

package/dist/session-context.d.ts

@@ -1,10 +1,12 @@
-import type { StreamConnectionState, WorkspaceControlEvent } from "@opengeni/sdk";
-import type { EmbeddedFileAttachmentClientLike, EmbeddedGoalClientLike, EmbeddedHumanInputSessionClientLike, EmbeddedRealtimeSessionClientLike, EmbeddedSessionClientLike, EmbeddedSessionLineageClientLike, EmbeddedSessionMcpApprovalPolicyClientLike, EmbeddedSessionReadClientLike, SessionClientLike } from "./client";
+import type { StreamConnectionState, WorkspaceControlEvent, WorkspaceInteractionRevisionEvent } from "@opengeni/sdk";
+import type { EmbeddedFileAttachmentClientLike, EmbeddedGoalClientLike, EmbeddedHumanInputSessionClientLike, EmbeddedBrowserInteractionClientLike, EmbeddedComputerInteractionClientLike, EmbeddedInteractionClientLike, EmbeddedInterventionClientLike, EmbeddedRealtimeSessionClientLike, EmbeddedSessionClientLike, EmbeddedSessionLineageClientLike, EmbeddedSessionMcpApprovalPolicyClientLike, EmbeddedSessionReadClientLike, SessionClientLike } from "./client.js";
 export type OpenGeniContextValue = {
     client: SessionClientLike;
     workspaceId: string;
     workspaceControlEvent: WorkspaceControlEvent | null;
     workspaceControlConnectionState: StreamConnectionState | "idle" | "error";
+    workspaceInteractionEvent: WorkspaceInteractionRevisionEvent | null;
+    workspaceInteractionConnectionState: StreamConnectionState | "idle" | "error";
     registerSessionReconciler: (sessionId: string, key: string, reconcile: () => Promise<void>) => () => void;
     reconcileSession: (sessionId: string) => Promise<void>;
 };
@@ -45,6 +47,22 @@ export type EmbeddedFileAttachmentClientOverride = {
     client?: EmbeddedFileAttachmentClientLike | undefined;
     workspaceId?: string | undefined;
 };
+export type EmbeddedInteractionClientOverride = {
+    client?: EmbeddedInteractionClientLike | undefined;
+    workspaceId?: string | undefined;
+};
+export type EmbeddedInterventionClientOverride = {
+    client?: EmbeddedInterventionClientLike | undefined;
+    workspaceId?: string | undefined;
+};
+export type EmbeddedBrowserInteractionClientOverride = {
+    client?: EmbeddedBrowserInteractionClientLike | undefined;
+    workspaceId?: string | undefined;
+};
+export type EmbeddedComputerInteractionClientOverride = {
+    client?: EmbeddedComputerInteractionClientLike | undefined;
+    workspaceId?: string | undefined;
+};
 export type EmbeddedSessionContextValue = Omit<OpenGeniContextValue, "client"> & {
     client: EmbeddedSessionClientLike;
 };
@@ -53,6 +71,14 @@ type EmbeddedClientContextValue<TClient> = Omit<OpenGeniContextValue, "client">
 };
 /** Resolve client + workspace from explicit overrides or the provider. */
 export declare function useOpenGeni(override?: ClientOverride): OpenGeniContextValue;
+/** Resolve only the workspace-wide Browser/Computer intervention surface. */
+export declare function useEmbeddedInterventions(override?: EmbeddedInterventionClientOverride): EmbeddedClientContextValue<EmbeddedInterventionClientLike>;
+/** Resolve only BrowserSession methods for a standalone Browser embed. */
+export declare function useEmbeddedBrowserInteraction(override?: EmbeddedBrowserInteractionClientOverride): EmbeddedClientContextValue<EmbeddedBrowserInteractionClientLike>;
+/** Resolve only ComputerSession methods for a standalone Computer embed. */
+export declare function useEmbeddedComputerInteraction(override?: EmbeddedComputerInteractionClientOverride): EmbeddedClientContextValue<EmbeddedComputerInteractionClientLike>;
+/** Resolve the complete Browser + Computer client surface. */
+export declare function useEmbeddedInteraction(override?: EmbeddedInteractionClientOverride): EmbeddedClientContextValue<EmbeddedInteractionClientLike>;
 /**
  * Resolve the narrow client required by the session-only hooks. The full
  * provider client is structurally compatible, while an explicit host proxy

package/dist/session-ui.d.ts

@@ -1,14 +1,14 @@
-export { HumanInputForm } from "./components/human-input-form";
-export type { HumanInputAnswerDraft, HumanInputFormMessages, HumanInputFormProps, } from "./components/human-input-form";
-export { HumanInputSurface } from "./components/human-input-surface";
-export type { HumanInputSurfaceProps } from "./components/human-input-surface";
-export { MessageTimeline, TimelineRow } from "./components/message-timeline";
-export type { MessageTimelineProps } from "./components/message-timeline";
-export { UserMessageBody, userMessageLikelyNeedsDisclosure } from "./components/user-message-body";
-export type { UserMessageBodyProps } from "./components/user-message-body";
-export { BUILT_IN_TURN_SUMMARY_FACET_IDS } from "./timeline/turn-summary";
-export type { BuiltInTurnSummaryFacetId, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, } from "./timeline/turn-summary";
-export { QueueSurface } from "./components/queue-surface";
-export type { QueueSurfaceProps } from "./components/queue-surface";
-export { SessionChrome, sessionChromeGoalPillState } from "./components/session-chrome";
-export type { SessionChromeAgentsSignal, SessionChromeProps, SessionChromeSignalId, SessionChromeSignalTone, } from "./components/session-chrome";
+export { HumanInputForm } from "./components/human-input-form.js";
+export type { HumanInputAnswerDraft, HumanInputFormMessages, HumanInputFormProps, } from "./components/human-input-form.js";
+export { HumanInputSurface } from "./components/human-input-surface.js";
+export type { HumanInputSurfaceProps } from "./components/human-input-surface.js";
+export { MessageTimeline, TimelineRow } from "./components/message-timeline.js";
+export type { MessageTimelineProps } from "./components/message-timeline.js";
+export { UserMessageBody, userMessageLikelyNeedsDisclosure } from "./components/user-message-body.js";
+export type { UserMessageBodyProps } from "./components/user-message-body.js";
+export { BUILT_IN_TURN_SUMMARY_FACET_IDS } from "./timeline/turn-summary.js";
+export type { BuiltInTurnSummaryFacetId, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, } from "./timeline/turn-summary.js";
+export { QueueSurface } from "./components/queue-surface.js";
+export type { QueueSurfaceProps } from "./components/queue-surface.js";
+export { SessionChrome, sessionChromeGoalPillState } from "./components/session-chrome.js";
+export type { SessionChromeAgentsSignal, SessionChromeProps, SessionChromeSignalId, SessionChromeSignalTone, } from "./components/session-chrome.js";

package/dist/session-ui.js

@@ -9,13 +9,14 @@ import {
   UserMessageBody,
   sessionChromeGoalPillState,
   userMessageLikelyNeedsDisclosure
-} from "./chunk-XCNTXWBB.js";
-import "./chunk-O4VXOBGF.js";
-import "./chunk-LHLYWG5R.js";
+} from "./chunk-Y7OEDUJ5.js";
+import "./chunk-6KLX2RH5.js";
+import "./chunk-WSK7G5LE.js";
 import "./chunk-FK6VG4LL.js";
-import "./chunk-LAKLF4PA.js";
 import "./chunk-VZTQ73XT.js";
+import "./chunk-LAKLF4PA.js";
 import "./chunk-22KP6LR5.js";
+import "./chunk-JVYQRRC4.js";
 export {
   BUILT_IN_TURN_SUMMARY_FACET_IDS,
   HumanInputForm,

package/dist/session.d.ts

@@ -1,28 +1,28 @@
-export type { EmbeddedFileAttachmentClientLike as FileAttachmentClientLike, EmbeddedGoalClientLike as GoalClientLike, EmbeddedHumanInputSessionClientLike as HumanInputSessionClientLike, EmbeddedSessionLineageClientLike as SessionLineageClientLike, EmbeddedSessionMcpApprovalPolicyClientLike as SessionMcpApprovalPolicyClientLike, EmbeddedSessionReadClientLike as SessionReadClientLike, EmbeddedSessionClientLike as SessionClientLike, } from "./client";
-export type { EmbeddedFileAttachmentClientOverride as FileAttachmentClientOverride, EmbeddedGoalClientOverride as GoalClientOverride, EmbeddedHumanInputClientOverride as HumanInputClientOverride, EmbeddedSessionLineageClientOverride as SessionLineageClientOverride, EmbeddedSessionMcpApprovalPolicyClientOverride as SessionMcpApprovalPolicyClientOverride, EmbeddedSessionReadClientOverride as SessionReadClientOverride, EmbeddedSessionClientOverride as ClientOverride, } from "./session-context";
-export { useSession, isTitleEvent } from "./hooks/use-session";
-export type { UseSessionOptions, UseSessionResult } from "./hooks/use-session";
-export { useSessionEvents } from "./hooks/use-session-events";
-export type { SessionEventsConnectionState, UseSessionEventsOptions, UseSessionEventsResult, } from "./hooks/use-session-events";
-export { useComposer, composeSendInput, shouldSteerOnKey, shouldSubmitOnKey, FILE_ONLY_MESSAGE_TEXT, } from "./hooks/use-composer";
-export type { ComposerSendExtras, ComposerState, UseComposerOptions } from "./hooks/use-composer";
-export { useFileAttachments } from "./hooks/use-file-attachments";
-export type { FileAttachment, UseFileAttachmentsOptions, UseFileAttachmentsResult, } from "./hooks/use-file-attachments";
-export { useTurnQueue, isTurnQueueEvent } from "./hooks/use-turn-queue";
-export type { QueueMutationKind, UseTurnQueueOptions, UseTurnQueueResult, } from "./hooks/use-turn-queue";
-export { useGoal, isGoalEvent } from "./hooks/use-goal";
-export type { UseGoalOptions, UseGoalResult } from "./hooks/use-goal";
-export { useSessionLineage, isLineageRefreshEvent } from "./hooks/use-session-lineage";
-export type { UseSessionLineageOptions, UseSessionLineageResult, } from "./hooks/use-session-lineage";
-export { useSessionControl } from "./hooks/use-session-control";
-export type { UseSessionControlOptions, UseSessionControlResult, } from "./hooks/use-session-control";
-export { isSessionMcpApprovalPolicyEvent, useSessionMcpApprovalPolicy, } from "./hooks/use-session-mcp-approval-policy";
-export type { UseSessionMcpApprovalPolicyOptions, UseSessionMcpApprovalPolicyResult, } from "./hooks/use-session-mcp-approval-policy";
-export { approvalsFromRequiresAction, projectPendingApprovals } from "./approvals";
-export type { PendingApproval } from "./approvals";
-export { humanInputRequestFromEvent, projectPendingHumanInputRequests } from "./human-input";
-export type { PendingHumanInputRequest } from "./human-input";
-export { isHumanInputEvent, useHumanInputRequests } from "./hooks/use-human-input";
-export type { UseHumanInputRequestsOptions, UseHumanInputRequestsResult, } from "./hooks/use-human-input";
-export { buildTimeline, creditExhaustedFromEvents, extractSessionRef, groupTimeline, sessionStatusFromEvents, toolDisplayName, } from "./timeline/projection";
-export type { ActivityItem, AgentMessageItem, AuthNeededItem, GoalItem, MachineInputBatchItem, MachineInputMember, MemoryItem, NoticeItem, ReasoningItem, SandboxItem, SessionStatusItem, TimelineGroup, TimelineItem, TurnOutcome, ToolCallItem, TurnEndItem, UserMessageItem, WorkerCompletionItem, WorkerItem, } from "./timeline/types";
+export type { EmbeddedFileAttachmentClientLike as FileAttachmentClientLike, EmbeddedGoalClientLike as GoalClientLike, EmbeddedHumanInputSessionClientLike as HumanInputSessionClientLike, EmbeddedSessionLineageClientLike as SessionLineageClientLike, EmbeddedSessionMcpApprovalPolicyClientLike as SessionMcpApprovalPolicyClientLike, EmbeddedSessionReadClientLike as SessionReadClientLike, EmbeddedSessionClientLike as SessionClientLike, } from "./client.js";
+export type { EmbeddedFileAttachmentClientOverride as FileAttachmentClientOverride, EmbeddedGoalClientOverride as GoalClientOverride, EmbeddedHumanInputClientOverride as HumanInputClientOverride, EmbeddedSessionLineageClientOverride as SessionLineageClientOverride, EmbeddedSessionMcpApprovalPolicyClientOverride as SessionMcpApprovalPolicyClientOverride, EmbeddedSessionReadClientOverride as SessionReadClientOverride, EmbeddedSessionClientOverride as ClientOverride, } from "./session-context.js";
+export { useSession, isTitleEvent } from "./hooks/use-session.js";
+export type { UseSessionOptions, UseSessionResult } from "./hooks/use-session.js";
+export { useSessionEvents } from "./hooks/use-session-events.js";
+export type { SessionEventsConnectionState, UseSessionEventsOptions, UseSessionEventsResult, } from "./hooks/use-session-events.js";
+export { useComposer, composeSendInput, shouldSteerOnKey, shouldSubmitOnKey, FILE_ONLY_MESSAGE_TEXT, } from "./hooks/use-composer.js";
+export type { ComposerSendExtras, ComposerState, UseComposerOptions } from "./hooks/use-composer.js";
+export { useFileAttachments } from "./hooks/use-file-attachments.js";
+export type { FileAttachment, UseFileAttachmentsOptions, UseFileAttachmentsResult, } from "./hooks/use-file-attachments.js";
+export { useTurnQueue, isTurnQueueEvent } from "./hooks/use-turn-queue.js";
+export type { QueueMutationKind, UseTurnQueueOptions, UseTurnQueueResult, } from "./hooks/use-turn-queue.js";
+export { useGoal, isGoalEvent } from "./hooks/use-goal.js";
+export type { UseGoalOptions, UseGoalResult } from "./hooks/use-goal.js";
+export { useSessionLineage, isLineageRefreshEvent } from "./hooks/use-session-lineage.js";
+export type { UseSessionLineageOptions, UseSessionLineageResult, } from "./hooks/use-session-lineage.js";
+export { useSessionControl } from "./hooks/use-session-control.js";
+export type { UseSessionControlOptions, UseSessionControlResult, } from "./hooks/use-session-control.js";
+export { isSessionMcpApprovalPolicyEvent, useSessionMcpApprovalPolicy, } from "./hooks/use-session-mcp-approval-policy.js";
+export type { UseSessionMcpApprovalPolicyOptions, UseSessionMcpApprovalPolicyResult, } from "./hooks/use-session-mcp-approval-policy.js";
+export { approvalsFromRequiresAction, projectPendingApprovals } from "./approvals.js";
+export type { PendingApproval } from "./approvals.js";
+export { humanInputRequestFromEvent, projectPendingHumanInputRequests } from "./human-input.js";
+export type { PendingHumanInputRequest } from "./human-input.js";
+export { isHumanInputEvent, useHumanInputRequests } from "./hooks/use-human-input.js";
+export type { UseHumanInputRequestsOptions, UseHumanInputRequestsResult, } from "./hooks/use-human-input.js";
+export { buildTimeline, creditExhaustedFromEvents, extractSessionRef, groupTimeline, sessionStatusFromEvents, toolDisplayName, } from "./timeline/projection.js";
+export type { ActivityItem, AgentMessageItem, AuthNeededItem, GoalItem, MachineInputBatchItem, MachineInputMember, MemoryItem, NoticeItem, ReasoningItem, SandboxItem, SessionStatusItem, TimelineGroup, TimelineItem, TurnOutcome, ToolCallItem, TurnEndItem, UserMessageItem, WorkerCompletionItem, WorkerItem, } from "./timeline/types.js";

package/dist/session.js

@@ -18,7 +18,14 @@ import {
   useSessionLineage,
   useSessionMcpApprovalPolicy,
   useTurnQueue
-} from "./chunk-I4MPFDRP.js";
+} from "./chunk-B6WPZSTT.js";
+import {
+  FILE_ONLY_MESSAGE_TEXT,
+  composeSendInput,
+  shouldSteerOnKey,
+  shouldSubmitOnKey,
+  useComposer
+} from "./chunk-IGC6A2ZI.js";
 import {
   buildTimeline,
   creditExhaustedFromEvents,
@@ -26,16 +33,9 @@ import {
   groupTimeline,
   sessionStatusFromEvents,
   toolDisplayName
-} from "./chunk-LHLYWG5R.js";
-import {
-  FILE_ONLY_MESSAGE_TEXT,
-  composeSendInput,
-  shouldSteerOnKey,
-  shouldSubmitOnKey,
-  useComposer
-} from "./chunk-FWXGSNXT.js";
+} from "./chunk-6KLX2RH5.js";
 import "./chunk-KZ73RL76.js";
-import "./chunk-EKZH6IDG.js";
+import "./chunk-C5ZPSSS5.js";
 import "./chunk-LAKLF4PA.js";
 export {
   FILE_ONLY_MESSAGE_TEXT,

package/dist/timeline/activity-rail.d.ts

@@ -1,5 +1,5 @@
-import type { RetainedScreenshotLoader, ToolRegistry } from "./registry";
-import type { ActivityItem } from "./types";
+import type { RetainedArtifactLoader, RetainedScreenshotLoader, ToolRegistry } from "./registry.js";
+import type { ActivityItem } from "./types.js";
 export type ActivityRailProps = {
     items: ActivityItem[];
     /** Renderer registry for tool calls. Defaults to {@link defaultToolRegistry}. */
@@ -13,8 +13,10 @@ export type ActivityRailProps = {
      */
     onMemoryClick?: ((memoryId: string) => void) | undefined;
     loadRetainedScreenshot?: RetainedScreenshotLoader | undefined;
+    /** Resolve permanent generated-image receipts through the authenticated host SDK. */
+    loadRetainedArtifact?: RetainedArtifactLoader | undefined;
     /** Drop the left rule + indent (used inside a folded turn summary). */
     bare?: boolean | undefined;
     className?: string | undefined;
 };
-export declare function ActivityRail({ items, toolRegistry, onOpenSession, onMemoryClick, loadRetainedScreenshot, bare, className, }: ActivityRailProps): import("react/jsx-runtime").JSX.Element;
+export declare function ActivityRail({ items, toolRegistry, onOpenSession, onMemoryClick, loadRetainedScreenshot, loadRetainedArtifact, bare, className, }: ActivityRailProps): import("react").JSX.Element;

package/dist/timeline/disclosure-context.d.ts

@@ -6,7 +6,7 @@ import { type ReactNode } from "react";
 export declare function DisclosureDefaultsProvider({ defaultOpen, children, }: {
     defaultOpen: boolean;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 /**
  * The forced initial-open seed from an ancestor {@link DisclosureDefaultsProvider},
  * or `undefined` when none is mounted (the inert, app-default case).

package/dist/timeline/fleet-decision-projection.d.ts

@@ -1,5 +1,5 @@
 import type { SessionEvent } from "@opengeni/sdk";
-import type { FleetDecisionItem } from "./types";
+import type { FleetDecisionItem } from "./types.js";
 /**
  * Project the identity-free fleet event into the deliberately smaller UI
  * contract. This is a trust boundary: session event payloads are untyped, so

package/dist/timeline/fleet-decision-row.d.ts

@@ -1,10 +1,10 @@
-import type { FleetDecisionItem } from "./types";
+import type { FleetDecisionItem } from "./types.js";
 type RowJsx = typeof import("react/jsx-runtime").jsx;
 type RowJsxs = typeof import("react/jsx-runtime").jsxs;
 export default function FleetDecisionRow({ item, d: ActivityDisclosure, b: BodyNote, j, s, }: {
     item: FleetDecisionItem;
-    d: typeof import("./shared").ActivityDisclosure;
-    b: typeof import("./shared").BodyNote;
+    d: typeof import("./shared.js").ActivityDisclosure;
+    b: typeof import("./shared.js").BodyNote;
     j: RowJsx;
     s: RowJsxs;
 }): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;

package/dist/timeline/index.d.ts

@@ -1,19 +1,19 @@
-export { buildTimeline, creditExhaustedFromEvents, extractSessionRef, groupTimeline, sessionStatusFromEvents, mcpToolLeaf, toolDisplayName, toolMatchesLeaf, } from "./projection";
-export type { ActivityItem, AgentMessageItem, AuthNeededItem, ContextCompactionItem, FleetDecisionItem, FleetDecisionScoreItem, GoalItem, MachineInputBatchItem, MachineInputMember, MemoryItem, NoticeItem, ReasoningItem, SandboxItem, SessionStatusItem, TimelineGroup, TimelineItem, TurnEndItem, ToolCallItem, UserMessageItem, WorkerCompletionItem, WorkerItem, } from "./types";
-export { createToolRegistry, rawTypeOf } from "./registry";
-export type { CreateToolRegistryOptions, RetainedScreenshotLoader, ToolRegistry, ToolRegistryEntry, ToolRenderer, ToolRendererProps, } from "./registry";
-export { createDefaultToolRegistry, defaultToolRegistry } from "./tool-renderers";
-export { ActivityRail } from "./activity-rail";
-export type { ActivityRailProps } from "./activity-rail";
-export { ActivityDisclosure, BodyNote, MediaEmpty, MediaSkeleton, PayloadBlock, ScreenshotFigure, TermBlock, Thumbnail, } from "./shared";
-export type { ActivityDisclosureProps, DisclosureChip } from "./shared";
-export { LightboxProvider, useLightbox, useLightboxOptional } from "./screenshot-lightbox";
-export { DisclosureDefaultsProvider, useForcedDefaultOpen } from "./disclosure-context";
-export { FoldMemoryProvider, inheritFoldRestingState, useFoldMemory } from "./fold-memory";
-export type { FoldRestingState } from "./fold-memory";
-export { SeenActivityIdsProvider, useSeenActivityIds } from "./seen-activity-ids";
-export { TimelineComputeLabelProvider, useTimelineComputeLabel } from "./compute-label";
-export { BUILT_IN_TURN_SUMMARY_FACET_IDS, TurnSummary, useTurnSettleOpen } from "./turn-summary";
-export type { BuiltInTurnSummaryFacetId, TurnOutcome, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, TurnSummaryProps, } from "./turn-summary";
-export { applyPatchOps, applyPatchOpsFromToolItem, parseFreeformApplyPatch, controlCaret, execTruncated, isApplyPatch, isExecSessionLostBanner, looksBinary, parseExecBannerSessionId, parseToolArgs, sandboxCommandExitCode, stripExecBanner, tailPeek, unwrapMcpOutput, v4aToGitFileDiff, } from "./parsers";
-export type { ApplyPatchOperation } from "./parsers";
+export { buildTimeline, creditExhaustedFromEvents, extractSessionRef, groupTimeline, sessionStatusFromEvents, mcpToolLeaf, toolDisplayName, toolMatchesLeaf, } from "./projection.js";
+export type { ActivityItem, AgentMessageItem, AuthNeededItem, ContextCompactionItem, FleetDecisionItem, FleetDecisionScoreItem, GoalItem, MachineInputBatchItem, MachineInputMember, MemoryItem, NoticeItem, ReasoningItem, SandboxItem, SessionStatusItem, TimelineGroup, TimelineItem, TimelineAnnotationSourceDescriptor, TurnEndItem, ToolCallItem, UserMessageItem, WorkerCompletionItem, WorkerItem, } from "./types.js";
+export { createToolRegistry, rawTypeOf } from "./registry.js";
+export type { CreateToolRegistryOptions, RetainedArtifactLoader, RetainedScreenshotLoader, VideoArtifactPlaybackLoader, ToolRegistry, ToolRegistryEntry, ToolRenderer, ToolRendererProps, } from "./registry.js";
+export { createDefaultToolRegistry, defaultToolRegistry } from "./tool-renderers.js";
+export { ActivityRail } from "./activity-rail.js";
+export type { ActivityRailProps } from "./activity-rail.js";
+export { ActivityDisclosure, BodyNote, MediaEmpty, MediaSkeleton, PayloadBlock, ScreenshotFigure, TermBlock, Thumbnail, } from "./shared.js";
+export type { ActivityDisclosureProps, DisclosureChip } from "./shared.js";
+export { LightboxProvider, useLightbox, useLightboxOptional } from "./screenshot-lightbox.js";
+export { DisclosureDefaultsProvider, useForcedDefaultOpen } from "./disclosure-context.js";
+export { FoldMemoryProvider, inheritFoldRestingState, useFoldMemory } from "./fold-memory.js";
+export type { FoldRestingState } from "./fold-memory.js";
+export { SeenActivityIdsProvider, useSeenActivityIds } from "./seen-activity-ids.js";
+export { TimelineComputeLabelProvider, useTimelineComputeLabel } from "./compute-label.js";
+export { BUILT_IN_TURN_SUMMARY_FACET_IDS, TurnSummary, useTurnSettleOpen } from "./turn-summary.js";
+export type { BuiltInTurnSummaryFacetId, TurnOutcome, TurnSummaryContext, TurnSummaryFacet, TurnSummaryFacetConfiguration, TurnSummaryFacetResult, TurnSummaryOptions, TurnSummaryProps, } from "./turn-summary.js";
+export { applyPatchOps, applyPatchOpsFromToolItem, parseFreeformApplyPatch, controlCaret, execTruncated, isApplyPatch, isExecSessionLostBanner, looksBinary, parseExecBannerSessionId, parseToolArgs, sandboxCommandExitCode, stripExecBanner, tailPeek, unwrapMcpOutput, v4aToGitFileDiff, } from "./parsers.js";
+export type { ApplyPatchOperation } from "./parsers.js";

package/dist/timeline/parsers.d.ts

@@ -1,4 +1,5 @@
-import { type GitFileDiff, type RetainedArtifactMetadata } from "@opengeni/sdk";
+import { type GeneratedImageReceipt, type GitFileDiff, type RetainedArtifactMetadata } from "@opengeni/sdk";
+export type { GeneratedImageReceipt };
 /** Recover the exit code from a sandbox exec banner (`Process exited with code N`). */
 export declare function sandboxCommandExitCode(out: unknown): number | null;
 /**
@@ -95,6 +96,8 @@ export declare function unwrapMcpOutput(output: unknown): {
 export declare function screenshotDataUrl(out: unknown): string | null;
 /** Parse the closed retained-screenshot receipt carried by new tool events. */
 export declare function retainedScreenshotMetadata(out: unknown): RetainedArtifactMetadata | null;
+/** Parse the closed permanent generated-image receipt from native/function tools. */
+export declare function generatedImageReceipt(out: unknown): GeneratedImageReceipt | null;
 export type TimelineMediaPreview = {
     type: "media_preview";
     mediaType: string;

package/dist/timeline/projection.d.ts

@@ -1,6 +1,6 @@
-import type { SessionEvent, SessionStatus } from "@opengeni/sdk";
-import type { TimelineGroup, TimelineItem } from "./types";
-export { toolDisplayName, mcpToolLeaf, toolMatchesLeaf } from "./tool-display-name";
+import { type SessionEvent, type SessionStatus } from "@opengeni/sdk";
+import type { TimelineGroup, TimelineItem } from "./types.js";
+export { toolDisplayName, mcpToolLeaf, toolMatchesLeaf } from "./tool-display-name.js";
 export declare function buildTimeline(events: SessionEvent[]): TimelineItem[];
 /**
  * Codex subscription web search can return private citation handles without

package/dist/timeline/registry.d.ts

@@ -1,11 +1,17 @@
-import type { RetainedArtifactReference } from "@opengeni/sdk";
+import type { RetainedArtifactReference, VideoArtifactPlaybackSource } from "@opengeni/sdk";
 import type { ComponentType } from "react";
-import type { ToolCallItem } from "./types";
+import type { ToolCallItem } from "./types.js";
 export type ToolRendererProps = {
     item: ToolCallItem;
     loadRetainedScreenshot?: RetainedScreenshotLoader | undefined;
+    loadRetainedArtifact?: RetainedArtifactLoader | undefined;
 };
 export type RetainedScreenshotLoader = (artifact: RetainedArtifactReference, signal: AbortSignal) => Promise<Uint8Array | null>;
+export type RetainedArtifactLoader = (artifact: RetainedArtifactReference, signal: AbortSignal) => Promise<Uint8Array | {
+    url: string;
+} | null>;
+/** Mint an expiring source for native browser playback without loading video bytes in JS. */
+export type VideoArtifactPlaybackLoader = (artifactId: string, signal: AbortSignal) => Promise<VideoArtifactPlaybackSource>;
 export type ToolRenderer = ComponentType<ToolRendererProps>;
 /** A registry entry: which key it matches and the component that renders it. */
 export type ToolRegistryEntry = {

package/dist/timeline/screenshot-lightbox.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from "react";
 type LightboxController = {
-    open: (src: string, caption?: string, source?: HTMLElement | null) => void;
+    open: (src: string, caption?: string, source?: HTMLElement | null, label?: string) => void;
 };
 /** Open the app-level screenshot lightbox. No-op outside a `LightboxProvider`. */
 export declare function useLightbox(): LightboxController;
@@ -22,5 +22,5 @@ export declare function useLightboxOptional(): LightboxController | null;
  */
 export declare function LightboxProvider({ children }: {
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export {};

package/dist/timeline/shared.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from "react";
+import type { ToolCallTruncation } from "./types.js";
 /**
  * A subtle settle signal — see the CHIP DOCTRINE above. The closed tone set.
  * `"interrupted"` is a calm neutral tone for cancelled items — no dot, same
@@ -8,6 +9,10 @@ export type DisclosureChip = {
     tone: "ok" | "bad" | "muted" | "interrupted";
     text: string;
 };
+export declare function ToolCallTruncationProvider({ value, children, }: {
+    value: ToolCallTruncation | null;
+    children: ReactNode;
+}): import("react").JSX.Element;
 export type ActivityDisclosureProps = {
     icon: ReactNode;
     /** Icon tint. Defaults to the muted foreground; renderers pass accent/failed. */
@@ -52,6 +57,8 @@ export type ActivityDisclosureProps = {
     cancelled?: boolean | undefined;
     /** When false the row is a static line (no expand affordance). */
     expandable?: boolean | undefined;
+    /** Seed this individual disclosure open; user interaction still owns it afterwards. */
+    defaultOpen?: boolean | undefined;
     children?: ReactNode | undefined;
 };
 /**
@@ -60,7 +67,7 @@ export type ActivityDisclosureProps = {
  * inline media, and at most one right-gutter settle chip. Compact by default;
  * the body mounts only when expanded.
  */
-export declare function ActivityDisclosure({ icon, iconTone: iconToneProp, title, titleMono, running, preview, media, chip: chipProp, failed, cancelled, expandable, children, }: ActivityDisclosureProps): import("react/jsx-runtime").JSX.Element;
+export declare function ActivityDisclosure({ icon, iconTone: iconToneProp, title, titleMono, running, preview, media, chip: chipProp, failed, cancelled, expandable, defaultOpen, children, }: ActivityDisclosureProps): import("react").JSX.Element;
 export declare function TermBlock({ command, workdir, output, live, tailLines, failed, }: {
     /**
      * The command shown in the prompt header. Pass `null` when the row title
@@ -81,25 +88,25 @@ export declare function TermBlock({ command, workdir, output, live, tailLines, f
      * toggle reveals the rest (never a dead affordance). Defaults to 12.
      */
     tailLines?: number | undefined;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function PayloadBlock({ label, value, failed, }: {
     label: string;
     value: unknown;
     failed?: boolean | undefined;
-}): import("react/jsx-runtime").JSX.Element | null;
+}): import("react").JSX.Element | null;
 /** A quiet inline note inside an expanded body (lost output, empty frame, …). */
 export declare function BodyNote({ children, tone, }: {
     children: ReactNode;
     tone?: "error" | "muted" | undefined;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 /**
  * A loading screenshot placeholder. A faint camera glyph over a shimmering box,
  * so a still frame of the running state reads unambiguously as "capturing" — not
  * a broken thumbnail.
  */
-export declare function MediaSkeleton(): import("react/jsx-runtime").JSX.Element;
+export declare function MediaSkeleton(): import("react").JSX.Element;
 /** A standardized "tool ran, produced no image" placeholder in the media slot. */
-export declare function MediaEmpty(): import("react/jsx-runtime").JSX.Element;
+export declare function MediaEmpty(): import("react").JSX.Element;
 /**
  * A small inline screenshot thumbnail that opens the app lightbox on click.
  *
@@ -107,19 +114,23 @@ export declare function MediaEmpty(): import("react/jsx-runtime").JSX.Element;
  * Outside one it degrades to a plain, non-interactive image — never a dead
  * "Expand" button that announces an action it cannot perform.
  */
-export declare function Thumbnail({ src, caption, alt, }: {
+export declare function Thumbnail({ src, caption, alt, expandLabel, lightboxLabel, }: {
     src: string;
     caption?: string | undefined;
     alt?: string;
-}): import("react/jsx-runtime").JSX.Element;
+    expandLabel?: string | undefined;
+    lightboxLabel?: string | undefined;
+}): import("react").JSX.Element;
 /**
  * The expanded screenshot inside a tool body: a contained, clickable preview
  * (opens the lightbox) with a quiet caption. Constrained height + object-contain
  * so it never breaks the row layout. Like {@link Thumbnail}, it degrades to a
  * plain image outside a `LightboxProvider`.
  */
-export declare function ScreenshotFigure({ src, caption, alt, }: {
+export declare function ScreenshotFigure({ src, caption, alt, expandLabel, lightboxLabel, }: {
     src: string;
     caption?: string | undefined;
     alt?: string;
-}): import("react/jsx-runtime").JSX.Element;
+    expandLabel?: string | undefined;
+    lightboxLabel?: string | undefined;
+}): import("react").JSX.Element;

package/dist/timeline/tool-diff.d.ts

@@ -1,8 +1,8 @@
 import type { GitFileDiff } from "@opengeni/sdk";
 export declare function ToolDiff({ files }: {
     files: GitFileDiff[];
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 /** Raw-patch fallback for a V4A hunk string the parser could not structure. */
 export declare function RawPatch({ diff }: {
     diff: string;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

package/dist/timeline/tool-renderers.d.ts

@@ -1,4 +1,4 @@
-import { createToolRegistry, type ToolRegistry } from "./registry";
+import { createToolRegistry, type ToolRegistry } from "./registry.js";
 /** The built-in tool renderer registry: every first-party tool plus a fallback. */
 export declare const defaultToolRegistry: ToolRegistry;
 /** Build a registry that extends the built-ins with consumer entries/fallback. */

package/dist/timeline/turn-summary.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from "react";
-import type { ActivityItem, ToolCallItem, TurnOutcome } from "./types";
-export type { TurnOutcome } from "./types";
+import type { ActivityItem, ToolCallItem, TurnOutcome } from "./types.js";
+export type { TurnOutcome } from "./types.js";
 /**
  * True while settle chrome is active (open beat, slow collapse, or the short
  * cancel-close latch). Nested cluster chips stay mounted and forced OPEN for
@@ -113,4 +113,4 @@ export type TurnSummaryProps = {
     /** The rendered activity rail revealed on expand. */
     children: ReactNode;
 };
-export declare function TurnSummary({ items, outcome, failureText, durationMs, defaultOpen, bare, facets: facetConfiguration, settleFold, foldKey, copyText, contextCompactionCount, children, }: TurnSummaryProps): import("react/jsx-runtime").JSX.Element;
+export declare function TurnSummary({ items, outcome, failureText, durationMs, defaultOpen, bare, facets: facetConfiguration, settleFold, foldKey, copyText, contextCompactionCount, children, }: TurnSummaryProps): import("react").JSX.Element;

package/dist/timeline/types.d.ts

@@ -1,8 +1,13 @@
-import type { ResourceRef, SessionStatus, ToolAuthNeededPayload, ToolRef } from "@opengeni/sdk";
+import type { MediaGenerationResult, ResourceRef, SessionStatus, TimelineAnnotation, TimelineAnnotationSource, ToolAuthNeededPayload, ToolRef } from "@opengeni/sdk";
+export type TimelineAnnotationSourceDescriptor = Omit<TimelineAnnotationSource, "startOffset" | "endOffset" | "contextBefore" | "contextAfter"> & {
+    text: string;
+};
 export type UserMessageItem = {
     kind: "user-message";
     id: string;
     text: string;
+    annotations?: TimelineAnnotation[] | undefined;
+    annotationSource?: TimelineAnnotationSourceDescriptor | undefined;
     presentation?: {
         kind: "realtime_voice" | "realtime_voice_handoff";
         /** Full bounded execution context sent with this visible voice request. */
@@ -13,6 +18,13 @@ export type UserMessageItem = {
     /** Tools requested for the turn this message starts. */
     tools: ToolRef[];
     occurredAt: string;
+    /** Local-only delivery projection; absent for authoritative durable events. */
+    delivery?: {
+        state: "sending" | "queued" | "failed";
+        error?: string | undefined;
+        onRetry?: (() => void) | undefined;
+        onRemove?: (() => void) | undefined;
+    } | undefined;
 };
 export type AgentMessageItem = {
     kind: "agent-message";
@@ -22,6 +34,8 @@ export type AgentMessageItem = {
     /** Still receiving deltas (no completed/turn-end seen yet). */
     streaming: boolean;
     occurredAt: string;
+    /** Available only after the canonical completed event lands. */
+    annotationSource?: TimelineAnnotationSourceDescriptor | undefined;
 };
 export type ReasoningItem = {
     kind: "reasoning";
@@ -31,6 +45,22 @@ export type ReasoningItem = {
     streaming: boolean;
     occurredAt: string;
 };
+/**
+ * Bounded delivery metadata carried by a projected tool-output event. The
+ * canonical event remains unchanged; this fact only explains what the current
+ * timeline surface could render and whether separately retained full evidence
+ * exists.
+ */
+export type ToolCallTruncation = {
+    truncated: true;
+    surface: string;
+    reason: string;
+    omittedBytes: number | null;
+    fullEvidence: {
+        available: boolean;
+        reason: string | null;
+    };
+};
 export type ToolCallItem = {
     kind: "tool-call";
     id: string;
@@ -39,6 +69,7 @@ export type ToolCallItem = {
     name: string;
     arguments: unknown;
     output: unknown;
+    truncation?: ToolCallTruncation | null;
     /**
      * The provider-native tool item (`agent.toolCall.created.payload.raw`). Carries
      * `type` (e.g. `apply_patch_call`, `computer_call`, `hosted_tool_call`) and the
@@ -49,6 +80,8 @@ export type ToolCallItem = {
     raw: unknown;
     status: "running" | "complete" | "failed" | "cancelled";
     occurredAt: string;
+    /** Canonical textual projection of the settled tool output. */
+    annotationSource?: TimelineAnnotationSourceDescriptor | undefined;
 };
 /**
  * An orchestration call against another session — the manager spawning or
@@ -65,6 +98,11 @@ export type WorkerItem = {
     prompt: string | null;
     /** The target/spawned worker session id, when parseable from args/output. */
     workerSessionId: string | null;
+    /** Bounded structured failure retained from session_create/session_send_message. */
+    failure: {
+        code: string;
+        message: string;
+    } | null;
     status: "running" | "complete" | "failed" | "cancelled";
     occurredAt: string;
 };
@@ -210,10 +248,11 @@ export type ContextCompactionItem = {
 };
 export type MachineInputMember = {
     id: string;
-    kind: "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "child_terminal_result";
+    kind: "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "child_terminal_result" | "media_generation_result";
     classification: "success" | "failure" | "action_required" | "info";
     sourceId: string;
     summary: string;
+    result?: MediaGenerationResult | undefined;
 };
 /**
  * One or more durable non-human inputs that joined the following agent turn.
@@ -243,7 +282,7 @@ export type AuthNeededItem = {
     /** The runtime surface that requested recovery, when the event is an MCP auth signal. */
     serverId: string | null;
     /** Durable event family that produced this notice. */
-    source?: "tool" | "credential" | undefined;
+    source?: "tool" | "credential" | "capability" | undefined;
     /** The connection's registrable domain, e.g. "linear.app". */
     providerDomain: string;
     /** The lapsed connection to reconnect, when the row survived. */
@@ -257,6 +296,8 @@ export type AuthNeededItem = {
     toolName: string | null;
     /** A pre-minted authorization URL, when the broker already produced one. */
     authorizationUrl: string | null;
+    /** Agent-selected catalog recommendation. The host still owns authorization. */
+    capability?: NonNullable<ToolAuthNeededPayload["capability"]> | null | undefined;
     occurredAt: string;
 };
 export type TurnOutcome = "complete" | "failed" | "cancelled";