@opengeni/react 0.27.0 → 0.29.0

package/src/components/message-timeline.tsx

@@ -42,10 +42,12 @@ import {
   type AgentMessageItem,
   type AuthNeededItem,
   type GoalItem,
+  type MachineInputBatchItem,
   type NoticeItem,
   type TimelineGroup,
   type TimelineItem,
   type ToolRegistry,
+  type TurnSummaryOptions,
   type UserMessageItem,
   type WorkerCompletionItem,
   TurnSummary,
@@ -97,6 +99,8 @@ export type MessageTimelineProps = {
    * `createDefaultToolRegistry({ entries })` to add custom tool renderers.
    */
   toolRegistry?: ToolRegistry | undefined;
+  /** Customize collapsed turn facets for this timeline instance. */
+  turnSummary?: TurnSummaryOptions | undefined;
   /** Follow new events when pinned to the bottom. Defaults to true. */
   autoFollow?: boolean | undefined;
   /** Older durable history exists above the current window (see useSessionEvents). */
@@ -127,6 +131,7 @@ export function MessageTimeline({
   onReconnect,
   resolveProviderLogo,
   toolRegistry = defaultToolRegistry,
+  turnSummary,
   autoFollow = true,
   hasOlder = false,
   loadingOlder = false,
@@ -414,6 +419,7 @@ export function MessageTimeline({
                     onReconnect={onReconnect}
                     resolveProviderLogo={resolveProviderLogo}
                     toolRegistry={toolRegistry}
+                    turnSummary={turnSummary}
                     foldLiveCluster={isAgentProgress(groups[index + 1]?.group)}
                   />
                 </div>
@@ -621,6 +627,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
   onReconnect,
   resolveProviderLogo,
   toolRegistry,
+  turnSummary,
   insideTurn = false,
   foldLiveCluster = false,
 }: {
@@ -633,6 +640,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
   onReconnect?: ((item: AuthNeededItem) => void | Promise<void>) | undefined;
   resolveProviderLogo?: ((providerDomain: string) => string | null | undefined) | undefined;
   toolRegistry: ToolRegistry;
+  turnSummary?: TurnSummaryOptions | undefined;
   /** A completed cluster of a still-RUNNING turn (not the live tail) folds
       behind a neutral chip — the one place activity without an outcome still
       folds, bounding the DOM of days-long autonomous turns. */
@@ -651,6 +659,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
           failureText={insideTurn ? undefined : group.failureText}
           defaultOpen={!insideTurn && group.outcome === "failed" ? true : undefined}
           bare={insideTurn}
+          facets={turnSummary?.facets}
         >
           <ActivityRail
             items={group.items}
@@ -683,6 +692,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
           onReconnect={onReconnect}
           resolveProviderLogo={resolveProviderLogo}
           toolRegistry={toolRegistry}
+          turnSummary={turnSummary}
           insideTurn
         />
       ));
@@ -697,6 +707,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
           durationMs={durationBetween(group.startedAt, group.endedAt)}
           defaultOpen={!insideTurn && group.outcome === "failed" ? true : undefined}
           bare={insideTurn}
+          facets={turnSummary?.facets}
         >
           {insideTurn ? (
             // A nested turn is already on an ancestor rail — its body just stacks
@@ -833,6 +844,8 @@ export function TimelineRow({
       return <SessionStatusRow item={item} />;
     case "goal":
       return <GoalRow item={item} />;
+    case "machine-input-batch":
+      return <MachineInputBatchRow item={item} />;
     case "notice":
       return <NoticeRow item={item} />;
     case "auth-needed":
@@ -1155,6 +1168,81 @@ function GoalRow({ item }: { item: GoalItem }) {
   );
 }
 
+const MACHINE_INPUT_META: Record<MachineInputBatchItem["members"][number]["kind"], string> = {
+  scheduled_occurrence: "Scheduled update",
+  goal_continuation: "Goal continued",
+  agent_message: "Agent update",
+  agent_steer_instruction: "Agent direction",
+  child_terminal_result: "Agent finished",
+};
+
+function MachineInputBatchRow({ item }: { item: MachineInputBatchItem }) {
+  const enter = useEntranceAnimation();
+  const visible = item.members.slice(0, 3);
+  return (
+    <div
+      className={cn(
+        enter && "animate-og-enter",
+        "rounded-og-md border border-og-border/70 bg-og-surface-1/55 px-3 py-2.5",
+      )}
+    >
+      {item.members.length > 1 && (
+        <div className="mb-2 text-xs font-medium text-og-fg-subtle">
+          {item.members.length} updates joined this turn
+        </div>
+      )}
+      <div className="space-y-2">
+        {visible.map((member) => (
+          <MachineInputRow key={member.id} member={member} />
+        ))}
+      </div>
+      {item.members.length > visible.length && (
+        <details className="mt-2 pl-8 text-xs text-og-fg-muted">
+          <summary className="cursor-pointer select-none hover:text-og-fg">
+            Show {item.members.length - visible.length} more
+          </summary>
+          <div className="mt-2 space-y-2">
+            {item.members.slice(visible.length).map((member) => (
+              <MachineInputRow key={member.id} member={member} />
+            ))}
+          </div>
+        </details>
+      )}
+    </div>
+  );
+}
+
+function MachineInputRow({ member }: { member: MachineInputBatchItem["members"][number] }) {
+  const source = readableMachineInputSource(member.sourceId);
+  return (
+    <div className="flex min-w-0 items-start gap-2.5">
+      <span className="mt-2 size-1.5 shrink-0 rounded-full bg-og-fg-subtle" aria-hidden />
+      <div className="min-w-0 flex-1">
+        <span className="text-xs font-medium text-og-fg-muted">
+          {MACHINE_INPUT_META[member.kind]}
+        </span>
+        {source && <span className="ml-1.5 text-xs text-og-fg-subtle">from {source}</span>}
+        {member.summary && (
+          <p className="mt-0.5 whitespace-pre-wrap break-words text-sm leading-5 text-og-fg">
+            {truncate(cleanMachineInputSummary(member.summary), 320)}
+          </p>
+        )}
+      </div>
+    </div>
+  );
+}
+
+function readableMachineInputSource(sourceId: string): string | null {
+  const value = sourceId.trim();
+  if (!value || /^[0-9a-f]{8}-[0-9a-f-]{27,}$/i.test(value)) return null;
+  if (/^(goal|schedule|system):/i.test(value)) return null;
+  return value.replaceAll("_", " ");
+}
+
+function cleanMachineInputSummary(summary: string): string {
+  return summary.replace(/^\[[A-Z][A-Z _-]*(?:\s+\d+\/\d+)?\]\s*/, "").trim();
+}
+
 function NoticeRow({ item }: { item: NoticeItem }) {
   const enter = useEntranceAnimation();
   const tone =

package/src/components/queue-surface-implementation.tsx

@@ -16,7 +16,7 @@ import {
   verticalListSortingStrategy,
 } from "@dnd-kit/sortable";
 import { CSS } from "@dnd-kit/utilities";
-import type { SessionTurn } from "@opengeni/sdk";
+import type { SessionPendingInputPreview, SessionTurn } from "@opengeni/sdk";
 import {
   ArrowDownToLineIcon,
   ArrowUpToLineIcon,
@@ -43,7 +43,7 @@ import type { QueueMutationKind, UseTurnQueueResult } from "../hooks/use-turn-qu
 import { requestQueueDraftEdit } from "./queue-draft-policy";
 import { QueueErrorAlert, QueueStoppingStatus } from "./queue-surface-state";
 
-/** The sole human prompt queue: compact above Goal, Agents, and composer. */
+/** The sole pending-input surface: compact above Goal, Agents, and composer. */
 type QueueSurfaceCommonProps = {
   /** Focus the composer owned by this queue after checkout/removal. */
   onRequestComposerFocus?: (() => void) | undefined;
@@ -85,10 +85,21 @@ export function QueueSurface({
     projectedIndex: number;
   } | null>(null);
   const count = queue.queue.length;
+  const pendingInputCount = queue.pendingInputs.length;
+  const totalCount = count + pendingInputCount;
+  const attachedInputIds = queue.pendingInputAttachment?.inputIds ?? [];
+  const attachedInputs = queue.pendingInputs.filter((input) => attachedInputIds.includes(input.id));
+  const standaloneInputs = queue.pendingInputs.filter(
+    (input) => !attachedInputIds.includes(input.id),
+  );
   const canEditInComposer = queueComposerCheckoutEnabled(composer, readOnly);
   const collapsedPreview = useMemo(
-    () => queuePromptPreview(queue.queue[0]?.prompt ?? "", QUEUE_COLLAPSED_PREVIEW_CHARACTERS),
-    [queue.queue],
+    () =>
+      queuePromptPreview(
+        queue.queue[0]?.prompt ?? queue.pendingInputs[0]?.summary ?? "",
+        QUEUE_COLLAPSED_PREVIEW_CHARACTERS,
+      ),
+    [queue.pendingInputs, queue.queue],
   );
   const sensors = useSensors(useSensor(PointerSensor, { activationConstraint: { distance: 6 } }));
 
@@ -227,7 +238,7 @@ export function QueueSurface({
     [canEditInComposer, composer, edit],
   );
 
-  if (count === 0 && !queue.stoppingPreviousAttempt && !queue.error && !queue.mutationError)
+  if (totalCount === 0 && !queue.stoppingPreviousAttempt && !queue.error && !queue.mutationError)
     return null;
 
   return (
@@ -242,23 +253,31 @@ export function QueueSurface({
           type="button"
           className="flex w-full min-w-0 flex-wrap items-center gap-2 px-3 py-2 text-left outline-none transition-colors hover:bg-surface-2/60 focus-visible:bg-surface-2/60 focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring/40 pointer-coarse:min-h-[44px]"
           onClick={() => setOpen((value) => !value)}
-          aria-description={!open && count > 0 ? collapsedPreview.summary : undefined}
+          aria-description={!open && totalCount > 0 ? collapsedPreview.summary : undefined}
           aria-expanded={open}
-          aria-label={`${count} queued prompt${count === 1 ? "" : "s"}${readOnly ? " Read-only" : ""}`}
+          aria-label={`${count} queued prompt${count === 1 ? "" : "s"}${
+            pendingInputCount > 0
+              ? ` and ${pendingInputCount} pending machine input${pendingInputCount === 1 ? "" : "s"}`
+              : ""
+          }${readOnly ? " Read-only" : ""}`}
         >
           <ChevronDownIcon
             aria-hidden="true"
             className={`size-3.5 shrink-0 text-fg-subtle transition-transform ${open ? "rotate-180" : ""}`}
           />
           <span className="text-xs font-medium text-fg">
-            {count} queued prompt{count === 1 ? "" : "s"}
+            {count > 0 ? `${count} queued prompt${count === 1 ? "" : "s"}` : null}
+            {count > 0 && pendingInputCount > 0 ? " · " : null}
+            {pendingInputCount > 0
+              ? `${pendingInputCount} incoming update${pendingInputCount === 1 ? "" : "s"}`
+              : null}
           </span>
           {readOnly ? (
             <span className="shrink-0 rounded border border-border px-1.5 py-0.5 text-2xs text-fg-subtle">
               Read-only
             </span>
           ) : null}
-          {!open && count > 0 ? (
+          {!open && totalCount > 0 ? (
             <span
               aria-hidden="true"
               className={`max-w-full truncate text-fg-muted ${
@@ -275,6 +294,10 @@ export function QueueSurface({
           {queue.loading ? <Loader2Icon className="ml-auto size-3.5 animate-spin" /> : null}
         </button>
 
+        {open && standaloneInputs.length > 0 ? (
+          <PendingMachineInputs inputs={standaloneInputs} />
+        ) : null}
+
         {open && count > 0 && readOnly ? (
           <ol
             className="max-h-[min(30rem,60dvh)] divide-y divide-border overflow-y-auto overscroll-contain border-t border-border"
@@ -286,6 +309,9 @@ export function QueueSurface({
                 key={turn.id}
                 turn={turn}
                 index={index}
+                attachedInputs={
+                  turn.id === queue.pendingInputAttachment?.turnId ? attachedInputs : []
+                }
                 onDisclosureChange={(expanded) =>
                   setAnnouncement(
                     `Full content for queued prompt ${index + 1} ${expanded ? "shown" : "hidden"}.`,
@@ -320,6 +346,9 @@ export function QueueSurface({
                     turn={turn}
                     index={index}
                     count={count}
+                    attachedInputs={
+                      turn.id === queue.pendingInputAttachment?.turnId ? attachedInputs : []
+                    }
                     pending={queue.mutationFor(turn.id)}
                     confirmingReplace={replaceDraftFor === turn.id}
                     keyboardDragging={keyboardDrag?.turnId === turn.id}
@@ -396,6 +425,35 @@ export function QueueSurface({
   );
 }
 
+function PendingMachineInputs({
+  inputs,
+  attached = false,
+}: {
+  inputs: SessionPendingInputPreview[];
+  attached?: boolean;
+}) {
+  return (
+    <section className="border-t border-border px-3 py-2">
+      <p className="text-2xs font-medium text-fg-subtle">
+        {attached
+          ? `${inputs.length} update${inputs.length === 1 ? "" : "s"} will join this prompt`
+          : "Incoming updates waiting to run"}
+      </p>
+      <ol className="mt-1 space-y-1">
+        {inputs.map((input) => (
+          <li key={input.id} className="line-clamp-3 break-words text-xs text-fg" dir="auto">
+            <strong className="capitalize text-fg-muted">
+              {input.kind.replace("_terminal", "").replaceAll("_", " ")}
+            </strong>{" "}
+            · {input.sourceId}
+            {input.summary ? ` — ${input.summary}` : ""}
+          </li>
+        ))}
+      </ol>
+    </section>
+  );
+}
+
 const QUEUE_ROW_PREVIEW_CHARACTERS = 360;
 const QUEUE_COLLAPSED_PREVIEW_CHARACTERS = 180;
 const QUEUE_PREVIEW_GRAPHEME_CONTEXT_CHARACTERS = 32;
@@ -735,7 +793,7 @@ function QueuePrompt({
         aria-controls={fullContentId}
         aria-expanded={expanded}
         aria-label={`${expanded ? "Hide" : "Show"} full content for queued prompt ${index + 1}`}
-        className="mt-1 inline-flex min-h-7 min-w-0 max-w-full items-center gap-1 whitespace-normal rounded-md text-left text-2xs font-medium text-fg-muted outline-none transition-colors hover:text-fg focus-visible:ring-2 focus-visible:ring-ring/40 pointer-coarse:min-h-[44px]"
+        className="mt-1 inline-flex min-h-7 min-w-0 max-w-full items-center gap-1 whitespace-normal rounded-md text-left text-2xs font-medium text-fg outline-none focus-visible:ring-2 focus-visible:ring-ring/40 pointer-coarse:min-h-[44px]"
         data-testid={`queue-prompt-disclosure-${index + 1}`}
         onClick={() => {
           const next = !expanded;
@@ -769,10 +827,12 @@ function QueuePrompt({
 function ReadOnlyQueueRow({
   turn,
   index,
+  attachedInputs,
   onDisclosureChange,
 }: {
   turn: SessionTurn;
   index: number;
+  attachedInputs: SessionPendingInputPreview[];
   onDisclosureChange: (expanded: boolean) => void;
 }) {
   return (
@@ -780,6 +840,9 @@ function ReadOnlyQueueRow({
       <span className="mt-1 shrink-0 font-mono text-2xs text-fg-subtle">{index + 1}</span>
       <div className="min-w-0 flex-1">
         <QueuePrompt prompt={turn.prompt} index={index} onDisclosureChange={onDisclosureChange} />
+        {attachedInputs.length > 0 ? (
+          <PendingMachineInputs inputs={attachedInputs} attached />
+        ) : null}
         <div className="mt-1 flex min-w-0 items-center gap-2 overflow-hidden whitespace-nowrap text-2xs text-fg-subtle">
           {turn.resources.length > 0 ? (
             <span className="shrink-0">
@@ -803,6 +866,7 @@ function SortableQueueRow({
   turn,
   index,
   count,
+  attachedInputs,
   pending,
   confirmingReplace,
   keyboardDragging,
@@ -818,6 +882,7 @@ function SortableQueueRow({
   turn: SessionTurn;
   index: number;
   count: number;
+  attachedInputs: SessionPendingInputPreview[];
   pending: QueueMutationKind | null;
   confirmingReplace: boolean;
   keyboardDragging: boolean;
@@ -864,6 +929,9 @@ function SortableQueueRow({
         </span>
         <div className="col-span-full row-start-2 min-w-0 sm:col-span-1 sm:col-start-3 sm:row-start-1">
           <QueuePrompt prompt={turn.prompt} index={index} onDisclosureChange={onDisclosureChange} />
+          {attachedInputs.length > 0 ? (
+            <PendingMachineInputs inputs={attachedInputs} attached />
+          ) : null}
           <div className="mt-1 flex min-w-0 items-center gap-2 overflow-hidden whitespace-nowrap text-2xs text-fg-subtle">
             {turn.resources.length > 0 ? (
               <span className="shrink-0">
@@ -886,7 +954,7 @@ function SortableQueueRow({
             onClick={onSteer}
             aria-label={`Steer queued prompt ${index + 1}`}
             title="Make this the next direction"
-            className="inline-flex h-7 shrink-0 items-center justify-center gap-1 rounded-md px-2 text-xs font-medium outline-none transition-colors hover:bg-surface-2 focus-visible:ring-2 focus-visible:ring-ring/40 disabled:pointer-events-none disabled:opacity-50 pointer-coarse:min-h-[44px] pointer-coarse:min-w-[44px]"
+            className="inline-flex h-7 shrink-0 items-center justify-center gap-1 rounded-md px-2 text-xs font-medium text-fg outline-none transition-[background-color] hover:bg-surface-2 focus-visible:ring-2 focus-visible:ring-ring/40 disabled:pointer-events-none disabled:opacity-50 pointer-coarse:min-h-[44px] pointer-coarse:min-w-[44px]"
           >
             {pending === "steer" ? (
               <Loader2Icon className="size-3.5 animate-spin" />

package/src/components/queue-surface.tsx

@@ -11,7 +11,7 @@ const loadQueueSurface = () => import("./queue-surface-implementation");
 type QueueSurfaceModule = { QueueSurface: ComponentType<QueueSurfaceProps> };
 type QueueSurfaceLoader = () => Promise<QueueSurfaceModule>;
 
-/** The sole human prompt queue: compact above Goal, Agents, and composer. */
+/** The sole pending-input surface: compact above Goal, Agents, and composer. */
 export const QueueSurface = createQueueSurface(loadQueueSurface);
 
 /** @internal Deterministic Suspense seam for the QueueSurface regression suite. */
@@ -26,20 +26,20 @@ function createQueueSurface(loadImplementation: QueueSurfaceLoader) {
 
   return function QueueSurfaceBoundary(props: QueueSurfaceProps) {
     const { queue } = props;
-    if (queue.queue.length === 0) {
+    if (queue.queue.length + queue.pendingInputs.length === 0) {
       if (!queue.stoppingPreviousAttempt && !queue.error && !queue.mutationError) return null;
       return <EmptyQueueStateSurface queue={queue} />;
     }
 
     return (
-      <Suspense fallback={<QueueSurfaceFallback count={queue.queue.length} />}>
+      <Suspense fallback={<QueueSurfaceFallback />}>
         <LazyQueueSurface {...props} />
       </Suspense>
     );
   };
 }
 
-function QueueSurfaceFallback({ count }: { count: number }) {
+function QueueSurfaceFallback() {
   return (
     <div
       aria-live="polite"
@@ -53,7 +53,7 @@ function QueueSurfaceFallback({ count }: { count: number }) {
             aria-hidden="true"
             className="size-3.5 shrink-0 animate-spin motion-reduce:animate-none"
           />
-          Loading {count} queued prompt{count === 1 ? "" : "s"}…
+          Loading inputs…
         </div>
       </div>
     </div>

package/src/hooks/use-composer.ts

@@ -773,14 +773,8 @@ export function useComposer(
         // The wire contract requires non-empty text (z.string().min(1)) and the
         // worker rejects whitespace-only text; a file-only message therefore
         // carries a minimal default so the attachments still get delivered.
-        const acknowledgedDraft = draftRef.current;
-        const sendExtras =
-          acknowledgedDraft?.toolsProvided === true &&
-          !Object.prototype.hasOwnProperty.call(extras, "tools")
-            ? { ...extras, tools: acknowledgedDraft.tools }
-            : extras;
         pendingClientEventId.current ??= generateClientEventId();
-        const input = composeSendInput(sendText, pendingClientEventId.current, sendExtras, {
+        const input = composeSendInput(sendText, pendingClientEventId.current, extras, {
           ...(options.effectiveControl?.controlEtag
             ? { controlEtag: options.effectiveControl.controlEtag }
             : {}),
@@ -1033,13 +1027,10 @@ export function useComposer(
   const hasDraftContent = useCallback((): boolean => {
     const current = draftRef.current;
     const extras = resolveSendExtras(sendExtrasRef.current);
-    const toolsProvidedByHost = Object.prototype.hasOwnProperty.call(extras, "tools");
-    const tools = toolsProvidedByHost ? (extras.tools ?? []) : (current?.tools ?? []);
     return (
       valueRef.current.length > 0 ||
       restoredResourcesRef.current.length > 0 ||
       (extras.resources?.length ?? 0) > 0 ||
-      tools.length > 0 ||
       (current?.sourceTurnId !== null && current?.sourceTurnId !== undefined)
     );
   }, []);
@@ -1201,8 +1192,6 @@ function draftPayload(draft: ComposerDraft): SaveComposerDraftRequest {
     expectedRevision: draft.revision,
     text: draft.text,
     resources: draft.resources,
-    tools: draft.tools,
-    toolsProvided: draft.toolsProvided,
     model: draft.model,
     reasoningEffort: draft.reasoningEffort,
   };
@@ -1214,13 +1203,10 @@ function composerDraftPayload(
   restoredResources: ResourceRef[],
   extras: ComposerSendExtras,
 ): SaveComposerDraftRequest {
-  const toolsProvidedByHost = Object.prototype.hasOwnProperty.call(extras, "tools");
   return {
     expectedRevision: base.revision,
     text,
     resources: mergeResources(restoredResources, extras.resources ?? []),
-    tools: toolsProvidedByHost ? (extras.tools ?? []) : base.tools,
-    toolsProvided: toolsProvidedByHost ? true : base.toolsProvided,
     model: extras.model ?? base.model,
     reasoningEffort: extras.reasoningEffort ?? base.reasoningEffort,
   };

package/src/hooks/use-turn-queue.ts

@@ -4,6 +4,7 @@ import type {
   SessionEvent,
   SessionQueueMutationResponse,
   SessionQueueSnapshot,
+  SessionPendingInputPreview,
   SessionTurn,
 } from "@opengeni/sdk";
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
@@ -20,6 +21,7 @@ export function isTurnQueueEvent(event: Pick<SessionEvent, "type">): boolean {
     event.type.startsWith("turn.") ||
     event.type.startsWith("session.queue.") ||
     event.type.startsWith("session.control.") ||
+    event.type.startsWith("system.update.") ||
     event.type.startsWith("workspace.inference.")
   );
 }
@@ -47,6 +49,10 @@ export type UseTurnQueueResult = {
   snapshot: SessionQueueSnapshot | null;
   /** Human/API prompts exactly in server execution order. Never client-sorted. */
   queue: SessionTurn[];
+  /** Canonical pending machine inputs. Events only trigger an authoritative refresh. */
+  pendingInputs: SessionPendingInputPreview[];
+  /** Exact pending members projected to join an already-waiting prompt. */
+  pendingInputAttachment: SessionQueueSnapshot["pendingInputAttachment"];
   effectiveControl: EffectiveSessionControl | null;
   /** The latest interrupted attempt has not yet durably proved physical quiescence. */
   stoppingPreviousAttempt: boolean;
@@ -324,6 +330,8 @@ export function useTurnQueue(
   return {
     snapshot: visibleSnapshot,
     queue: visibleSnapshot?.items ?? [],
+    pendingInputs: visibleSnapshot?.pendingInputs ?? [],
+    pendingInputAttachment: visibleSnapshot?.pendingInputAttachment ?? null,
     effectiveControl: visibleSnapshot?.effectiveControl ?? null,
     stoppingPreviousAttempt: visibleSnapshot?.stoppingPreviousAttempt ?? false,
     loading: identityMatches ? loading : enabled,

package/src/index.ts

@@ -245,6 +245,8 @@ export type {
   AgentMessageItem,
   AuthNeededItem,
   GoalItem,
+  MachineInputBatchItem,
+  MachineInputMember,
   NoticeItem,
   ReasoningItem,
   SandboxItem,
@@ -286,6 +288,7 @@ export {
   TermBlock,
   Thumbnail,
   TurnSummary,
+  BUILT_IN_TURN_SUMMARY_FACET_IDS,
   useLightbox,
   useLightboxOptional,
 } from "./timeline";
@@ -293,7 +296,13 @@ export type {
   ActivityDisclosureProps,
   ActivityRailProps,
   DisclosureChip,
+  BuiltInTurnSummaryFacetId,
   TurnOutcome,
+  TurnSummaryContext,
+  TurnSummaryFacet,
+  TurnSummaryFacetConfiguration,
+  TurnSummaryFacetResult,
+  TurnSummaryOptions,
   TurnSummaryProps,
 } from "./timeline";
 

package/src/session-ui.ts

@@ -9,5 +9,14 @@ export type {
 } from "./components/human-input-form";
 export { MessageTimeline, TimelineRow } from "./components/message-timeline";
 export type { MessageTimelineProps } from "./components/message-timeline";
+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";

package/src/session.ts

@@ -96,6 +96,8 @@ export type {
   AgentMessageItem,
   AuthNeededItem,
   GoalItem,
+  MachineInputBatchItem,
+  MachineInputMember,
   MemoryItem,
   NoticeItem,
   ReasoningItem,

package/src/timeline/index.ts

@@ -33,6 +33,8 @@ export type {
   FleetDecisionItem,
   FleetDecisionScoreItem,
   GoalItem,
+  MachineInputBatchItem,
+  MachineInputMember,
   MemoryItem,
   NoticeItem,
   ReasoningItem,
@@ -84,8 +86,17 @@ export { LightboxProvider, useLightbox, useLightboxOptional } from "./screenshot
 export { DisclosureDefaultsProvider, useForcedDefaultOpen } from "./disclosure-context";
 
 // turn-collapse summary chip
-export { TurnSummary } from "./turn-summary";
-export type { TurnOutcome, TurnSummaryProps } from "./turn-summary";
+export { BUILT_IN_TURN_SUMMARY_FACET_IDS, TurnSummary } from "./turn-summary";
+export type {
+  BuiltInTurnSummaryFacetId,
+  TurnOutcome,
+  TurnSummaryContext,
+  TurnSummaryFacet,
+  TurnSummaryFacetConfiguration,
+  TurnSummaryFacetResult,
+  TurnSummaryOptions,
+  TurnSummaryProps,
+} from "./turn-summary";
 
 // parsers (pure, reusable by custom renderers)
 export {

package/src/timeline/parsers.ts

@@ -1,4 +1,4 @@
-import type { GitFileDiff } from "@opengeni/sdk";
+import { normalizeMcpOutput, type GitFileDiff } from "@opengeni/sdk";
 import { tryParseJson } from "../lib/format";
 
 /* ----------------------------------------------------------------------------
@@ -288,36 +288,8 @@ export function unwrapMcpOutput(output: unknown): {
   text: string;
   isError: boolean;
 } {
-  // Managed MCP events persist a normalized single text part as
-  // `{ type: "text", text }`; accept it alongside the SDK-native content array.
-  if (
-    output &&
-    typeof output === "object" &&
-    (output as { type?: unknown }).type === "text" &&
-    typeof (output as { text?: unknown }).text === "string"
-  ) {
-    const record = output as { text: string; isError?: unknown };
-    return { text: record.text, isError: Boolean(record.isError) };
-  }
-  if (output && typeof output === "object" && "content" in output) {
-    const record = output as { content?: unknown; isError?: unknown };
-    const isError = Boolean(record.isError);
-    if (Array.isArray(record.content)) {
-      const textPart = record.content.find(
-        (part): part is { type: string; text: string } =>
-          !!part && typeof part === "object" && (part as { type?: unknown }).type === "text",
-      );
-      return {
-        text: textPart ? String(textPart.text) : JSON.stringify(output),
-        isError,
-      };
-    }
-    return { text: JSON.stringify(output), isError };
-  }
-  return {
-    text: typeof output === "string" ? output : output == null ? "" : JSON.stringify(output),
-    isError: false,
-  };
+  const normalized = normalizeMcpOutput(output);
+  return { text: normalized.text, isError: normalized.isError };
 }
 
 /* --- computer-use screenshot extraction ------------------------------------- */