@opengeni/react 1.0.1 → 2.3.0-canary.0

package/dist/session.d.ts

@@ -5,7 +5,7 @@ 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 type { ComposerControllerState, ComposerPolicy, 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";
@@ -25,4 +25,4 @@ 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";
+export type { ActivityItem, AgentMessageItem, AuthNeededItem, GoalItem, HumanInputAnswerSummary, HumanInputItem, MachineInputBatchItem, MachineInputMember, MemoryItem, NoticeItem, ReasoningItem, SandboxItem, SessionStatusItem, TimelineGroup, TimelineItem, TurnOutcome, ToolCallItem, TurnEndItem, UserMessageItem, WorkerCompletionItem, WorkerItem, } from "./timeline/types.js";

package/dist/session.js

@@ -18,14 +18,14 @@ import {
   useSessionLineage,
   useSessionMcpApprovalPolicy,
   useTurnQueue
-} from "./chunk-B6WPZSTT.js";
+} from "./chunk-SE4W4WQ3.js";
 import {
   FILE_ONLY_MESSAGE_TEXT,
   composeSendInput,
   shouldSteerOnKey,
   shouldSubmitOnKey,
   useComposer
-} from "./chunk-IGC6A2ZI.js";
+} from "./chunk-JOAVA2TW.js";
 import {
   buildTimeline,
   creditExhaustedFromEvents,
@@ -33,9 +33,9 @@ import {
   groupTimeline,
   sessionStatusFromEvents,
   toolDisplayName
-} from "./chunk-6KLX2RH5.js";
+} from "./chunk-RSXJN73N.js";
 import "./chunk-KZ73RL76.js";
-import "./chunk-C5ZPSSS5.js";
+import "./chunk-NEXLLTP4.js";
 import "./chunk-LAKLF4PA.js";
 export {
   FILE_ONLY_MESSAGE_TEXT,

package/dist/timeline/index.d.ts

@@ -1,5 +1,5 @@
 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 type { ActivityItem, AgentMessageItem, AuthNeededItem, ContextCompactionItem, FleetDecisionItem, FleetDecisionScoreItem, GoalItem, HumanInputAnswerSummary, HumanInputItem, MachineInputBatchItem, MachineInputMember, MemoryItem, NoticeItem, ReasoningItem, SandboxItem, StartupPhase, StartupPhaseItem, 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";

package/dist/timeline/platform-activity-row.d.ts

@@ -0,0 +1,15 @@
+import type { ReasoningItem, SandboxItem, StartupPhaseItem } from "./types.js";
+type RowJsx = typeof import("react/jsx-runtime").jsx;
+type RowJsxs = typeof import("react/jsx-runtime").jsxs;
+export default function PlatformActivityRow({ item, d: ActivityDisclosure, p: PayloadBlock, t: displayName, b: BotIcon, m: Markdown, r: truncate, j, s, }: {
+    item: ReasoningItem | SandboxItem | StartupPhaseItem;
+    d: typeof import("./shared.js").ActivityDisclosure;
+    p: typeof import("./shared.js").PayloadBlock;
+    t: (name: string) => string;
+    b: typeof import("lucide-react").BotIcon;
+    m: typeof import("../components/markdown.js").Markdown;
+    r: typeof import("../lib/format.js").truncate;
+    j: RowJsx;
+    s: RowJsxs;
+}): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export {};

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, label?: string) => void;
+    open: (src: string, caption?: string, source?: HTMLElement | null, label?: string, downloadFilename?: string) => void;
 };
 /** Open the app-level screenshot lightbox. No-op outside a `LightboxProvider`. */
 export declare function useLightbox(): LightboxController;

package/dist/timeline/shared.d.ts

@@ -114,12 +114,13 @@ export declare function MediaEmpty(): import("react").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, expandLabel, lightboxLabel, }: {
+export declare function Thumbnail({ src, caption, alt, expandLabel, lightboxLabel, downloadFilename, }: {
     src: string;
     caption?: string | undefined;
     alt?: string;
     expandLabel?: string | undefined;
     lightboxLabel?: string | undefined;
+    downloadFilename?: string | undefined;
 }): import("react").JSX.Element;
 /**
  * The expanded screenshot inside a tool body: a contained, clickable preview
@@ -127,10 +128,11 @@ export declare function Thumbnail({ src, caption, alt, expandLabel, lightboxLabe
  * 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, expandLabel, lightboxLabel, }: {
+export declare function ScreenshotFigure({ src, caption, alt, expandLabel, lightboxLabel, downloadFilename, }: {
     src: string;
     caption?: string | undefined;
     alt?: string;
     expandLabel?: string | undefined;
     lightboxLabel?: string | undefined;
+    downloadFilename?: string | undefined;
 }): import("react").JSX.Element;

package/dist/timeline/types.d.ts

@@ -1,10 +1,17 @@
-import type { MediaGenerationResult, ResourceRef, SessionStatus, TimelineAnnotation, TimelineAnnotationSource, ToolAuthNeededPayload, ToolRef } from "@opengeni/sdk";
+import type { HumanInputQuestion, HumanInputResponse, 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;
+    /**
+     * Renderer-only identity shared by a locally acknowledged message and the
+     * durable event that replaces it. The canonical event id remains `id`; this
+     * key only prevents the optimistic-to-durable handoff from remounting and
+     * replaying the row entrance animation.
+     */
+    reconciliationKey?: string | undefined;
     text: string;
     annotations?: TimelineAnnotation[] | undefined;
     annotationSource?: TimelineAnnotationSourceDescriptor | undefined;
@@ -26,11 +33,34 @@ export type UserMessageItem = {
         onRemove?: (() => void) | undefined;
     } | undefined;
 };
+export type HumanInputAnswerSummary = {
+    questionId: string;
+    label: string;
+    prompt: string;
+    values: string[];
+};
+/**
+ * One resolved structured question in the conversation. The live pending form
+ * is rendered at the timeline tip by the host; after settlement this item keeps
+ * both the agent's question and the human's answer visible as chat history.
+ */
+export type HumanInputItem = {
+    kind: "human-input";
+    id: string;
+    turnId: string | null;
+    requestId: string;
+    questions: HumanInputQuestion[];
+    response: HumanInputResponse;
+    answers: HumanInputAnswerSummary[];
+    occurredAt: string;
+};
 export type AgentMessageItem = {
     kind: "agent-message";
     id: string;
     turnId: string | null;
     text: string;
+    /** Provider-declared assistant channel. Absent on legacy and non-Responses events. */
+    phase?: "commentary" | "final_answer" | undefined;
     /** Still receiving deltas (no completed/turn-end seen yet). */
     streaming: boolean;
     occurredAt: string;
@@ -130,6 +160,21 @@ export type SandboxItem = {
     status: "running" | "complete" | "failed" | "cancelled";
     occurredAt: string;
 };
+export type StartupPhase = "queue" | "sandbox" | "rig" | "repository" | "files" | "tools" | "model_preparation" | "provider_first_byte";
+/** A compact user-visible critical-path span reconstructed from durable events. */
+export type StartupPhaseItem = {
+    kind: "startup-phase";
+    id: string;
+    turnId: string | null;
+    phase: StartupPhase;
+    status: "running" | "complete" | "failed" | "cancelled";
+    startedAt: string;
+    completedAt: string | null;
+    durationMs: number | null;
+    /** Sandbox origin and rig marker outcomes refine the settled label only. */
+    outcome: "created" | "restored" | "resumed" | "skipped" | null;
+    occurredAt: string;
+};
 /**
  * A first-party workspace-memory write the agent made mid-turn — a `memory.saved`
  * (it committed a new preference / fact / procedure / decision / history) or a
@@ -209,7 +254,7 @@ export type SessionStatusItem = {
 export type GoalItem = {
     kind: "goal";
     id: string;
-    action: "set" | "updated" | "completed" | "paused" | "resumed" | "cleared" | "continuation";
+    action: "set" | "updated" | "completed" | "paused" | "resumed" | "cleared" | "held" | "continuation";
     text: string | null;
     occurredAt: string;
 };
@@ -248,7 +293,7 @@ export type ContextCompactionItem = {
 };
 export type MachineInputMember = {
     id: string;
-    kind: "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "child_terminal_result" | "media_generation_result";
+    kind: "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "child_terminal_result" | "media_generation_result" | "child_requires_action" | "child_requires_action_resolved" | "child_paused" | "child_waiting_capacity" | "child_progress";
     classification: "success" | "failure" | "action_required" | "info";
     sourceId: string;
     summary: string;
@@ -309,9 +354,9 @@ export type TurnEndItem = {
     failureText: string | null;
     occurredAt: string;
 };
-export type TimelineItem = UserMessageItem | AgentMessageItem | ReasoningItem | ToolCallItem | WorkerItem | WorkerCompletionItem | SandboxItem | SessionStatusItem | GoalItem | NoticeItem | ContextCompactionItem | MachineInputBatchItem | AuthNeededItem | MemoryItem | FleetDecisionItem | TurnEndItem;
+export type TimelineItem = UserMessageItem | HumanInputItem | AgentMessageItem | ReasoningItem | ToolCallItem | WorkerItem | WorkerCompletionItem | SandboxItem | StartupPhaseItem | SessionStatusItem | GoalItem | NoticeItem | ContextCompactionItem | MachineInputBatchItem | AuthNeededItem | MemoryItem | FleetDecisionItem | TurnEndItem;
 /** Activity items cluster between chat messages (reasoning, tools, workers, sandbox, memory). */
-export type ActivityItem = ReasoningItem | ToolCallItem | WorkerItem | SandboxItem | MemoryItem | FleetDecisionItem;
+export type ActivityItem = ReasoningItem | ToolCallItem | WorkerItem | SandboxItem | StartupPhaseItem | MemoryItem | FleetDecisionItem;
 export type TimelineGroup = {
     kind: "item";
     item: TimelineItem;

package/dist/types/machines.d.ts

@@ -1,5 +1,5 @@
-import type { MachineKind, MachineMetricsSeriesResponse, MachinesResponse, MachineState, MachineView, MetricSample } from "@opengeni/sdk";
-export type { MachineKind, MachineMetricsSeriesResponse, MachinesResponse, MachineState, MachineView, MetricSample, };
+import type { MachineKind, MachineMetricsSeriesResponse, MachinesResponse, MachineState, MachineView, MachineRuntime, MachineRuntimeCapabilities, MachineOperationPolicy, MachineUpdateState, MachineUpdateStatus, MetricSample } from "@opengeni/sdk";
+export type { MachineKind, MachineMetricsSeriesResponse, MachinesResponse, MachineState, MachineView, MachineRuntime, MachineRuntimeCapabilities, MachineOperationPolicy, MachineUpdateState, MachineUpdateStatus, MetricSample, };
 /**
  * The three connection-status pill values the UI surfaces across the dashboard,
  * the dock, and the timeline. `consent_required` / `display_unavailable` /

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/react",
-  "version": "1.0.1",
+  "version": "2.3.0-canary.0",
   "description": "React hooks and styled components for OpenGeni: live session streaming, chat composer, message timeline, session status, and fleet views — token-themed (CSS variables), dark-first, built on Tailwind v4 + Radix + Motion.",
   "license": "Apache-2.0",
   "repository": {
@@ -116,7 +116,7 @@
     "@dnd-kit/utilities": "3.2.2",
     "@fontsource-variable/noto-sans-arabic": "5.2.10",
     "@fontsource-variable/noto-sans-jp": "5.2.10",
-    "@opengeni/sdk": "^1.0.1",
+    "@opengeni/sdk": "^2.3.0-canary.0",
     "clsx": "^2.1.1",
     "lucide-react": "^1.8.0",
     "motion": "^12.0.0",
@@ -135,7 +135,7 @@
     "@codemirror/lang-markdown": "^6.0.0",
     "@codemirror/lang-python": "^6.0.0",
     "@novnc/novnc": "^1.7.0",
-    "@opengeni/artifact-tool": ">=0.1.0 <0.3.0",
+    "@opengeni/artifact-tool": ">=0.1.0 <0.4.0",
     "@pierre/diffs": "^1.2.11",
     "@uiw/react-codemirror": "^4.23.0",
     "@xterm/addon-fit": "^0.11.0",

package/src/client.ts

@@ -34,6 +34,7 @@ export type SessionClientLike = Pick<
   | "deleteQueueItem"
   | "getComposerDraft"
   | "saveComposerDraft"
+  | "submitComposerDraft"
   | "listTurns"
   // Goal
   | "getGoal"
@@ -66,6 +67,7 @@ export type SessionClientLike = Pick<
   | "listChannels"
   | "createChannel"
   | "updateChannel"
+  | "reorderChannels"
   | "deleteChannel"
   | "updateSessionChannel"
   // Rigs
@@ -187,7 +189,15 @@ export type SessionClientLike = Pick<
   | "terminalPtyResize"
   | "terminalPtyClose"
 > &
-  Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource" | "streamWorkspaceLiveEvents">>;
+  Partial<
+    Pick<
+      OpenGeniClient,
+      | "createVideoArtifactPlaybackSource"
+      | "streamWorkspaceLiveEvents"
+      | "listSessionBackgroundCommands"
+      | "cancelSessionBackgroundCommand"
+    >
+  >;
 
 /**
  * Tenant-safe client surface required by the session-only React entry.
@@ -205,6 +215,7 @@ export type EmbeddedSessionClientLike = Pick<
   | "streamEvents"
   | "getComposerDraft"
   | "saveComposerDraft"
+  | "submitComposerDraft"
   | "sendMessage"
   | "steerMessage"
   | "getQueue"

package/src/components/artifacts/editable-spreadsheet.tsx

@@ -651,7 +651,7 @@ function spreadsheetCellInput(
   input: string,
   kind: SpreadsheetCommit["kind"],
 ): SpreadsheetCellInput {
-  if (kind === "formula") return { formula: input, cached: null };
+  if (kind === "formula") return { formula: input };
   if (input === "") return null;
   const normalized = input.trim();
   if (/^(?:true|false)$/i.test(normalized)) return normalized.toLowerCase() === "true";