@opengeni/react 0.48.0 → 0.52.1

package/src/timeline/types.ts

@@ -1,4 +1,12 @@
-import type { ResourceRef, SessionStatus, ToolAuthNeededPayload, ToolRef } from "@opengeni/sdk";
+import type {
+  MediaGenerationResult,
+  ResourceRef,
+  SessionStatus,
+  TimelineAnnotation,
+  TimelineAnnotationSource,
+  ToolAuthNeededPayload,
+  ToolRef,
+} from "@opengeni/sdk";
 
 /* ----------------------------------------------------------------------------
    Timeline item types
@@ -9,10 +17,19 @@ import type { ResourceRef, SessionStatus, ToolAuthNeededPayload, ToolRef } from
    and the component demo.
    -------------------------------------------------------------------------- */
 
+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. */
@@ -23,6 +40,15 @@ 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 = {
@@ -33,6 +59,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 = {
@@ -44,6 +72,23 @@ export type ReasoningItem = {
   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;
@@ -52,6 +97,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
@@ -62,6 +108,8 @@ export type ToolCallItem = {
   raw: unknown;
   status: "running" | "complete" | "failed" | "cancelled";
   occurredAt: string;
+  /** Canonical textual projection of the settled tool output. */
+  annotationSource?: TimelineAnnotationSourceDescriptor | undefined;
 };
 
 /**
@@ -256,10 +304,12 @@ export type MachineInputMember = {
     | "goal_continuation"
     | "agent_message"
     | "agent_steer_instruction"
-    | "child_terminal_result";
+    | "child_terminal_result"
+    | "media_generation_result";
   classification: "success" | "failure" | "action_required" | "info";
   sourceId: string;
   summary: string;
+  result?: MediaGenerationResult | undefined;
 };
 
 /**
@@ -291,7 +341,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. */
@@ -305,6 +355,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;
 };