@opengeni/react 0.52.1 → 0.57.0

package/README.md

@@ -381,6 +381,49 @@ loading, realtime-first creation, Codex Live, Gateway models, mute, recovery,
 delegation/context timeline updates, structured questions, and stop/restart
 through published package APIs only.
 
+## Browser and computer surfaces (`@opengeni/react/interaction`)
+
+The interaction subpath renders the same browser-native and semantic computer
+surfaces used by the OpenGeni web app. It consumes only the public SDK client:
+workspace discovery, peer switching, tabs/windows, live frames, human input,
+identity versions, interventions, diagnostics, reconnect, and lifecycle state do
+not require app-private controller glue.
+
+```tsx
+import { OpenGeniProvider } from "@opengeni/react";
+import { BrowserViewer, ComputerViewer } from "@opengeni/react/interaction";
+
+<OpenGeniProvider client={client} workspaceId={workspaceId}>
+  <BrowserViewer
+    sessionId={sessionId}
+    onOpenComputer={(computerSessionId) => setSelectedComputer(computerSessionId)}
+  />
+  {selectedComputer ? (
+    <ComputerViewer
+      sessionId={sessionId}
+      requestedComputerSessionId={selectedComputer}
+      requestedComputerRequestId={selectedComputer}
+    />
+  ) : null}
+</OpenGeniProvider>;
+```
+
+`BrowserViewer` follows the current agent until the human pins another workspace
+browser. A headed managed browser can receive `createLinkedComputer`; the
+returned ComputerSession must be the exact placement/window the browser uses.
+`onOpenComputer` then changes the host layout to that resource—it must not open a
+lookalike desktop. Closing either viewer never ends its durable resource.
+
+The provider opens one shared workspace interaction-revision stream and every
+catalog refreshes only when its revision advances; hidden or disconnected pages
+fall back to bounded polling and reconcile from the retained cursor. Hosts that
+do not use `OpenGeniProvider` may pass the same structural `client` and
+`workspaceId` directly.
+
+Run `bun run demo` and open `browser.html` or `computer.html`. Their `mode=mock`
+paths are deterministic; `mode=live&workspaceId=…&sessionId=…` uses the
+same-origin `/demo-api` proxy and the exact published SDK/React entrypoints.
+
 ## Composer customization (`@opengeni/react/composer`)
 
 Use `ChatComposer` for the standard layout and its `controlsStart`, `header`,
@@ -531,6 +574,11 @@ so consumers can render attachment chips. `groupTimeline` clusters consecutive
 activity for collapsed display. Use them directly if you want custom rendering
 with the same semantics.
 
+Failed worker items may also carry `failure: { code, message }`. The projection
+accepts only the bounded structured orchestration envelope retained in MCP
+output; it does not reinterpret arbitrary legacy error strings. `ActivityRail`
+renders the code and message directly beneath the failed worker row.
+
 ### Compatibility
 
 The projection is a tolerant reader over `SessionEvent.payload` because the wire

package/dist/artifacts.d.ts

@@ -1,2 +1,2 @@
 /** Public artifact surfaces. Import from `@opengeni/react/artifacts`. */
-export { ArtifactSurface, DocumentArtifactSurface, DocumentEditor, DocumentProjectionArtifactSurface, DocumentProjectionEditor, BrowserEditableArtifactWorkbench, EditableDocumentArtifactSurface, EditableArtifactWorkbench, EditableArtifactWorkbenchHost, EditablePresentationArtifactSurface, EditableSpreadsheetArtifactSurface, EditableSpreadsheetGrid, PresentationArtifactSurface, PresentationEditor, PresentationProjectionArtifactSurface, PresentationProjectionEditor, SpreadsheetArtifactSurface, SpreadsheetGrid, SpreadsheetProjectionGrid, type ArtifactModality, type ArtifactSurfaceProps, type DocumentArtifactSurfaceProps, type DocumentCommit, type DocumentCommitHandler, type DocumentEditorProps, type DocumentEditorProjection, type DocumentLayoutMode, type DocumentProjectionArtifactSurfaceProps, type DocumentProjectionBlock, type DocumentProjectionChange, type DocumentProjectionComment, type DocumentProjectionEditorProps, type DocumentProjectionPageBreak, type DocumentProjectionPageGeometry, type DocumentProjectionParagraph, type DocumentProjectionParagraphStyle, type DocumentProjectionSection, type DocumentProjectionTable, type DocumentProjectionTextRun, type DocumentProjectionTextStyle, type DocumentSelection, type BrowserEditableArtifactWorkbenchOptions, type BrowserEditableArtifactWorkbenchProps, type EditableDocumentArtifactSurfaceProps, type EditableArtifactWorkbenchHostProps, type EditableArtifactWorkbenchProps, type EditablePresentationArtifactSurfaceProps, type EditableSpreadsheetArtifactSurfaceProps, type EditableSpreadsheetGridProps, type PresentationArtifactSurfaceProps, type PresentationCommit, type PresentationCommitHandler, type PresentationEditorProps, type PresentationEditorProjection, type PresentationProjectionArtifactSurfaceProps, type PresentationProjectionChart, type PresentationProjectionChartSeries, type PresentationProjectionConnector, type PresentationProjectionEditorProps, type PresentationProjectionElementMetadata, type PresentationProjectionElement, type PresentationProjectionFill, type PresentationProjectionGroup, type PresentationProjectionImage, type PresentationProjectionLine, type PresentationProjectionPosition, type PresentationProjectionRichText, type PresentationProjectionShape, type PresentationProjectionTable, type PresentationProjectionTableCell, type PresentationProjectionTextParagraph, type PresentationProjectionTextRun, type PresentationProjectionTextStyle, type PresentationSlideProjection, type SpreadsheetArtifactSurfaceProps, type SpreadsheetCommit, type SpreadsheetRangeCommit, type SpreadsheetGridProps, type SpreadsheetGridProjection, type SpreadsheetProjectionCell, type SpreadsheetProjectionGridProps, type SpreadsheetSelection, type SpreadsheetViewport, } from "./components/artifacts/index.js";
+export { ArtifactSurface, DocumentArtifactSurface, DocumentEditor, DocumentProjectionArtifactSurface, DocumentProjectionEditor, BrowserEditableArtifactWorkbench, EditableDocumentArtifactSurface, EditableArtifactWorkbench, EditableArtifactWorkbenchHost, EditablePresentationArtifactSurface, EditableSpreadsheetArtifactSurface, EditableSpreadsheetGrid, PresentationArtifactSurface, PresentationEditor, PresentationProjectionArtifactSurface, PresentationProjectionEditor, PublishedHtmlArtifactFrame, PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX, SpreadsheetArtifactSurface, SpreadsheetGrid, SpreadsheetProjectionGrid, type ArtifactModality, type ArtifactSurfaceProps, type DocumentArtifactSurfaceProps, type DocumentCommit, type DocumentCommitHandler, type DocumentEditorProps, type DocumentEditorProjection, type DocumentLayoutMode, type DocumentProjectionArtifactSurfaceProps, type DocumentProjectionBlock, type DocumentProjectionChange, type DocumentProjectionComment, type DocumentProjectionEditorProps, type DocumentProjectionPageBreak, type DocumentProjectionPageGeometry, type DocumentProjectionParagraph, type DocumentProjectionParagraphStyle, type DocumentProjectionSection, type DocumentProjectionTable, type DocumentProjectionTextRun, type DocumentProjectionTextStyle, type DocumentSelection, type BrowserEditableArtifactWorkbenchOptions, type BrowserEditableArtifactWorkbenchProps, type EditableDocumentArtifactSurfaceProps, type EditableArtifactWorkbenchHostProps, type EditableArtifactWorkbenchProps, type EditablePresentationArtifactSurfaceProps, type EditableSpreadsheetArtifactSurfaceProps, type EditableSpreadsheetGridProps, type PresentationArtifactSurfaceProps, type PresentationCommit, type PresentationCommitHandler, type PresentationEditorProps, type PresentationEditorProjection, type PresentationProjectionArtifactSurfaceProps, type PresentationProjectionChart, type PresentationProjectionChartSeries, type PresentationProjectionConnector, type PresentationProjectionEditorProps, type PublishedHtmlArtifactFrameProps, type PresentationProjectionElementMetadata, type PresentationProjectionElement, type PresentationProjectionFill, type PresentationProjectionGroup, type PresentationProjectionImage, type PresentationProjectionLine, type PresentationProjectionPosition, type PresentationProjectionRichText, type PresentationProjectionShape, type PresentationProjectionTable, type PresentationProjectionTableCell, type PresentationProjectionTextParagraph, type PresentationProjectionTextRun, type PresentationProjectionTextStyle, type PresentationSlideProjection, type SpreadsheetArtifactSurfaceProps, type SpreadsheetCommit, type SpreadsheetRangeCommit, type SpreadsheetGridProps, type SpreadsheetGridProjection, type SpreadsheetProjectionCell, type SpreadsheetProjectionGridProps, type SpreadsheetSelection, type SpreadsheetViewport, } from "./components/artifacts/index.js";

package/dist/artifacts.js

@@ -1,10 +1,3 @@
-import {
-  DocumentArtifactSurface,
-  DocumentEditor,
-  DocumentProjectionArtifactSurface,
-  DocumentProjectionEditor,
-  EditableDocumentArtifactSurface
-} from "./chunk-HUIKIDM5.js";
 import {
   EditablePresentationArtifactSurface,
   PresentationArtifactSurface,
@@ -19,18 +12,52 @@ import {
   SpreadsheetGrid,
   SpreadsheetProjectionGrid
 } from "./chunk-7WCLAEFV.js";
+import {
+  DocumentArtifactSurface,
+  DocumentEditor,
+  DocumentProjectionArtifactSurface,
+  DocumentProjectionEditor,
+  EditableDocumentArtifactSurface
+} from "./chunk-HUIKIDM5.js";
 import {
   ArtifactSurface,
   EditableArtifactMessage
 } from "./chunk-KCGXPP5V.js";
 import "./chunk-22KP6LR5.js";
 
+// src/components/artifacts/published-html-artifact-frame.tsx
+import { jsx } from "react/jsx-runtime";
+var PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX = [
+  "allow-downloads",
+  "allow-forms",
+  "allow-modals",
+  "allow-orientation-lock",
+  "allow-pointer-lock",
+  "allow-popups",
+  "allow-popups-to-escape-sandbox",
+  "allow-presentation",
+  "allow-scripts"
+].join(" ");
+function PublishedHtmlArtifactFrame(props) {
+  return /* @__PURE__ */ jsx(
+    "iframe",
+    {
+      title: props.title,
+      sandbox: PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX,
+      referrerPolicy: "no-referrer",
+      srcDoc: props.html,
+      className: props.className,
+      style: props.style
+    }
+  );
+}
+
 // src/components/artifacts/editable-artifact-workbench.tsx
 import {
   createBrowserEditableArtifactSession
 } from "@opengeni/sdk/editable-artifacts";
 import { useCallback, useEffect, useRef, useState } from "react";
-import { jsx } from "react/jsx-runtime";
+import { jsx as jsx2 } from "react/jsx-runtime";
 function EditableArtifactWorkbench({
   session,
   document,
@@ -39,7 +66,7 @@ function EditableArtifactWorkbench({
 }) {
   switch (session.modality) {
     case "document":
-      return /* @__PURE__ */ jsx(
+      return /* @__PURE__ */ jsx2(
         EditableDocumentArtifactSurface,
         {
           ...document,
@@ -48,9 +75,9 @@ function EditableArtifactWorkbench({
         }
       );
     case "spreadsheet":
-      return /* @__PURE__ */ jsx(EditableSpreadsheetArtifactSurface, { ...spreadsheet, session });
+      return /* @__PURE__ */ jsx2(EditableSpreadsheetArtifactSurface, { ...spreadsheet, session });
     case "presentation":
-      return /* @__PURE__ */ jsx(EditablePresentationArtifactSurface, { ...presentation, session });
+      return /* @__PURE__ */ jsx2(EditablePresentationArtifactSurface, { ...presentation, session });
   }
 }
 function EditableArtifactWorkbenchHost({
@@ -88,7 +115,7 @@ function EditableArtifactWorkbenchHost({
   const retry = useCallback(() => setRetryEpoch((value) => value + 1), []);
   const currentError = state.key === sessionKey ? state.error : null;
   if (state.key === sessionKey && state.session) {
-    return /* @__PURE__ */ jsx(
+    return /* @__PURE__ */ jsx2(
       EditableArtifactWorkbench,
       {
         session: state.session,
@@ -98,7 +125,7 @@ function EditableArtifactWorkbenchHost({
       }
     );
   }
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx2(
     EditableArtifactMessage,
     {
       title: currentError ? "Could not open this artifact" : "Opening artifact",
@@ -115,7 +142,7 @@ function BrowserEditableArtifactWorkbench({
 }) {
   const sessionKey = browserSessionKey(options);
   const createSession = useCallback(() => createBrowserEditableArtifactSession(options), [options]);
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx2(
     EditableArtifactWorkbenchHost,
     {
       sessionKey,
@@ -159,10 +186,12 @@ export {
   EditablePresentationArtifactSurface,
   EditableSpreadsheetArtifactSurface,
   EditableSpreadsheetGrid,
+  PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX,
   PresentationArtifactSurface,
   PresentationEditor,
   PresentationProjectionArtifactSurface,
   PresentationProjectionEditor,
+  PublishedHtmlArtifactFrame,
   SpreadsheetArtifactSurface,
   SpreadsheetGrid,
   SpreadsheetProjectionGrid

package/dist/artifacts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/artifacts/editable-artifact-workbench.tsx"],"sourcesContent":["import {\n  createBrowserEditableArtifactSession,\n  type CreateBrowserEditableArtifactSessionOptions,\n  type EditableArtifactBrowserRuntime,\n  type EditableArtifactSession,\n} from \"@opengeni/sdk/editable-artifacts\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { EditableArtifactMessage } from \"./editable-artifact-ui\";\nimport {\n  EditableDocumentArtifactSurface,\n  type EditableDocumentArtifactSurfaceProps,\n} from \"./editable-document\";\nimport {\n  EditablePresentationArtifactSurface,\n  type EditablePresentationArtifactSurfaceProps,\n} from \"./editable-presentation\";\nimport {\n  EditableSpreadsheetArtifactSurface,\n  type EditableSpreadsheetArtifactSurfaceProps,\n} from \"./editable-spreadsheet\";\n\nexport type EditableArtifactWorkbenchProps = Readonly<{\n  session: EditableArtifactSession;\n  document?: Omit<EditableDocumentArtifactSurfaceProps, \"session\">;\n  spreadsheet?: Omit<EditableSpreadsheetArtifactSurfaceProps, \"session\">;\n  presentation?: Omit<EditablePresentationArtifactSurfaceProps, \"session\">;\n}>;\n\nexport type EditableArtifactWorkbenchHostProps = Omit<EditableArtifactWorkbenchProps, \"session\"> &\n  Readonly<{\n    /**\n     * Complete identity of the browser session authority. Change this when the\n     * artifact, deployment, principal, or authorization epoch changes.\n     */\n    sessionKey: string;\n    /** Called for the active keyed lifecycle and again only after replacement or retry. */\n    createSession: () => EditableArtifactSession;\n  }>;\n\ntype DefaultBrowserArtifactTransport = Omit<\n  NonNullable<CreateBrowserEditableArtifactSessionOptions[\"transport\"]>,\n  \"apiKey\" | \"fetch\" | \"headers\" | \"webSocketFactory\"\n> &\n  Readonly<{\n    /** Static deployment auth headers; rotate authorizationEpoch when they change. */\n    headers?: Readonly<Record<string, string>>;\n  }>;\n\nexport type BrowserEditableArtifactWorkbenchOptions = Omit<\n  CreateBrowserEditableArtifactSessionOptions,\n  \"runtime\" | \"storage\" | \"transport\"\n> &\n  Readonly<{\n    /** Default module Worker only; custom Worker hosts use EditableArtifactWorkbenchHost. */\n    runtime: Omit<EditableArtifactBrowserRuntime, \"workerFactory\">;\n    /** Default fetch/WebSocket only; static deployment auth headers are supported. */\n    transport?: DefaultBrowserArtifactTransport;\n  }>;\n\nexport type BrowserEditableArtifactWorkbenchProps = Omit<\n  EditableArtifactWorkbenchProps,\n  \"session\"\n> &\n  Readonly<{ options: BrowserEditableArtifactWorkbenchOptions }>;\n\n/**\n * One modality-neutral SDK workbench. Embedding hosts keep one route/component;\n * each artifact still renders through its complete first-party editor surface.\n */\nexport function EditableArtifactWorkbench({\n  session,\n  document,\n  spreadsheet,\n  presentation,\n}: EditableArtifactWorkbenchProps) {\n  switch (session.modality) {\n    case \"document\":\n      return (\n        <EditableDocumentArtifactSurface\n          {...document}\n          session={session}\n          title={document?.title ?? \"Document\"}\n        />\n      );\n    case \"spreadsheet\":\n      return <EditableSpreadsheetArtifactSurface {...spreadsheet} session={session} />;\n    case \"presentation\":\n      return <EditablePresentationArtifactSurface {...presentation} session={session} />;\n  }\n}\n\n/**\n * Route/embed composition that owns exactly one SDK session. The host supplies\n * the authenticated SDK factory; React guarantees replacement and teardown.\n */\nexport function EditableArtifactWorkbenchHost({\n  sessionKey,\n  createSession,\n  document,\n  spreadsheet,\n  presentation,\n}: EditableArtifactWorkbenchHostProps) {\n  const createSessionRef = useRef(createSession);\n  const [retryEpoch, setRetryEpoch] = useState(0);\n  const [state, setState] = useState<\n    | Readonly<{ key: string; session: EditableArtifactSession; error: null }>\n    | Readonly<{ key: string | null; session: null; error: Error | null }>\n  >({ key: null, session: null, error: null });\n\n  useEffect(() => {\n    createSessionRef.current = createSession;\n  }, [createSession]);\n\n  useEffect(() => {\n    let owned: EditableArtifactSession | null = null;\n    setState({ key: sessionKey, session: null, error: null });\n    try {\n      owned = createSessionRef.current();\n      setState({ key: sessionKey, session: owned, error: null });\n    } catch (cause) {\n      setState({\n        key: sessionKey,\n        session: null,\n        error: cause instanceof Error ? cause : new Error(\"Could not create artifact session\"),\n      });\n    }\n    return () => {\n      const closing = owned;\n      owned = null;\n      if (closing) void closing.close().catch(() => undefined);\n    };\n  }, [retryEpoch, sessionKey]);\n\n  const retry = useCallback(() => setRetryEpoch((value) => value + 1), []);\n  const currentError = state.key === sessionKey ? state.error : null;\n  if (state.key === sessionKey && state.session) {\n    return (\n      <EditableArtifactWorkbench\n        session={state.session}\n        {...(document ? { document } : {})}\n        {...(spreadsheet ? { spreadsheet } : {})}\n        {...(presentation ? { presentation } : {})}\n      />\n    );\n  }\n  return (\n    <EditableArtifactMessage\n      title={currentError ? \"Could not open this artifact\" : \"Opening artifact\"}\n      detail={currentError?.message ?? \"Starting the secure editing session…\"}\n      retry={currentError ? retry : undefined}\n    />\n  );\n}\n\n/**\n * Complete default-browser composition for embedders: verified WASM Worker,\n * durable IndexedDB state, authenticated live sync, teardown, and the matching\n * first-party editor. Advanced/custom transports compose the lower-level host.\n */\nexport function BrowserEditableArtifactWorkbench({\n  options,\n  document,\n  spreadsheet,\n  presentation,\n}: BrowserEditableArtifactWorkbenchProps) {\n  const sessionKey = browserSessionKey(options);\n  const createSession = useCallback(() => createBrowserEditableArtifactSession(options), [options]);\n  return (\n    <EditableArtifactWorkbenchHost\n      sessionKey={sessionKey}\n      createSession={createSession}\n      {...(document ? { document } : {})}\n      {...(spreadsheet ? { spreadsheet } : {})}\n      {...(presentation ? { presentation } : {})}\n    />\n  );\n}\n\nfunction browserSessionKey(options: BrowserEditableArtifactWorkbenchOptions): string {\n  const transport = options.transport\n    ? {\n        ...options.transport,\n        // Credentials must not be copied into React lifecycle keys. The\n        // authorization epoch is the explicit credential/grant rotation fence.\n        headers: options.transport.headers\n          ? Object.keys(options.transport.headers).sort()\n          : undefined,\n      }\n    : null;\n  return JSON.stringify(\n    {\n      baseUrl: options.baseUrl,\n      workspaceId: options.workspaceId,\n      artifact: { id: options.artifact.id, modality: options.artifact.modality },\n      storageAuthority: options.storageAuthority,\n      runtime: options.runtime,\n      replicaId: options.replicaId ?? null,\n      transport,\n    },\n    (_key, value: unknown) => (value instanceof URL ? value.href : value),\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/components/artifacts/published-html-artifact-frame.tsx","../src/components/artifacts/editable-artifact-workbench.tsx"],"sourcesContent":["import type { CSSProperties } from \"react\";\n\nexport const PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX = [\n  \"allow-downloads\",\n  \"allow-forms\",\n  \"allow-modals\",\n  \"allow-orientation-lock\",\n  \"allow-pointer-lock\",\n  \"allow-popups\",\n  \"allow-popups-to-escape-sandbox\",\n  \"allow-presentation\",\n  \"allow-scripts\",\n].join(\" \");\n\nexport type PublishedHtmlArtifactFrameProps = {\n  html: string;\n  title: string;\n  className?: string;\n  style?: CSSProperties;\n};\n\n/**\n * Render exact published HTML in an opaque-origin iframe. Artifact scripts,\n * external resources, forms, popups, and downloads work without granting\n * parent-origin authority, shared cookies/storage, or top-level navigation.\n */\nexport function PublishedHtmlArtifactFrame(props: PublishedHtmlArtifactFrameProps) {\n  return (\n    <iframe\n      title={props.title}\n      sandbox={PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX}\n      referrerPolicy=\"no-referrer\"\n      srcDoc={props.html}\n      className={props.className}\n      style={props.style}\n    />\n  );\n}\n","import {\n  createBrowserEditableArtifactSession,\n  type CreateBrowserEditableArtifactSessionOptions,\n  type EditableArtifactBrowserRuntime,\n  type EditableArtifactSession,\n} from \"@opengeni/sdk/editable-artifacts\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { EditableArtifactMessage } from \"./editable-artifact-ui\";\nimport {\n  EditableDocumentArtifactSurface,\n  type EditableDocumentArtifactSurfaceProps,\n} from \"./editable-document\";\nimport {\n  EditablePresentationArtifactSurface,\n  type EditablePresentationArtifactSurfaceProps,\n} from \"./editable-presentation\";\nimport {\n  EditableSpreadsheetArtifactSurface,\n  type EditableSpreadsheetArtifactSurfaceProps,\n} from \"./editable-spreadsheet\";\n\nexport type EditableArtifactWorkbenchProps = Readonly<{\n  session: EditableArtifactSession;\n  document?: Omit<EditableDocumentArtifactSurfaceProps, \"session\">;\n  spreadsheet?: Omit<EditableSpreadsheetArtifactSurfaceProps, \"session\">;\n  presentation?: Omit<EditablePresentationArtifactSurfaceProps, \"session\">;\n}>;\n\nexport type EditableArtifactWorkbenchHostProps = Omit<EditableArtifactWorkbenchProps, \"session\"> &\n  Readonly<{\n    /**\n     * Complete identity of the browser session authority. Change this when the\n     * artifact, deployment, principal, or authorization epoch changes.\n     */\n    sessionKey: string;\n    /** Called for the active keyed lifecycle and again only after replacement or retry. */\n    createSession: () => EditableArtifactSession;\n  }>;\n\ntype DefaultBrowserArtifactTransport = Omit<\n  NonNullable<CreateBrowserEditableArtifactSessionOptions[\"transport\"]>,\n  \"apiKey\" | \"fetch\" | \"headers\" | \"webSocketFactory\"\n> &\n  Readonly<{\n    /** Static deployment auth headers; rotate authorizationEpoch when they change. */\n    headers?: Readonly<Record<string, string>>;\n  }>;\n\nexport type BrowserEditableArtifactWorkbenchOptions = Omit<\n  CreateBrowserEditableArtifactSessionOptions,\n  \"runtime\" | \"storage\" | \"transport\"\n> &\n  Readonly<{\n    /** Default module Worker only; custom Worker hosts use EditableArtifactWorkbenchHost. */\n    runtime: Omit<EditableArtifactBrowserRuntime, \"workerFactory\">;\n    /** Default fetch/WebSocket only; static deployment auth headers are supported. */\n    transport?: DefaultBrowserArtifactTransport;\n  }>;\n\nexport type BrowserEditableArtifactWorkbenchProps = Omit<\n  EditableArtifactWorkbenchProps,\n  \"session\"\n> &\n  Readonly<{ options: BrowserEditableArtifactWorkbenchOptions }>;\n\n/**\n * One modality-neutral SDK workbench. Embedding hosts keep one route/component;\n * each artifact still renders through its complete first-party editor surface.\n */\nexport function EditableArtifactWorkbench({\n  session,\n  document,\n  spreadsheet,\n  presentation,\n}: EditableArtifactWorkbenchProps) {\n  switch (session.modality) {\n    case \"document\":\n      return (\n        <EditableDocumentArtifactSurface\n          {...document}\n          session={session}\n          title={document?.title ?? \"Document\"}\n        />\n      );\n    case \"spreadsheet\":\n      return <EditableSpreadsheetArtifactSurface {...spreadsheet} session={session} />;\n    case \"presentation\":\n      return <EditablePresentationArtifactSurface {...presentation} session={session} />;\n  }\n}\n\n/**\n * Route/embed composition that owns exactly one SDK session. The host supplies\n * the authenticated SDK factory; React guarantees replacement and teardown.\n */\nexport function EditableArtifactWorkbenchHost({\n  sessionKey,\n  createSession,\n  document,\n  spreadsheet,\n  presentation,\n}: EditableArtifactWorkbenchHostProps) {\n  const createSessionRef = useRef(createSession);\n  const [retryEpoch, setRetryEpoch] = useState(0);\n  const [state, setState] = useState<\n    | Readonly<{ key: string; session: EditableArtifactSession; error: null }>\n    | Readonly<{ key: string | null; session: null; error: Error | null }>\n  >({ key: null, session: null, error: null });\n\n  useEffect(() => {\n    createSessionRef.current = createSession;\n  }, [createSession]);\n\n  useEffect(() => {\n    let owned: EditableArtifactSession | null = null;\n    setState({ key: sessionKey, session: null, error: null });\n    try {\n      owned = createSessionRef.current();\n      setState({ key: sessionKey, session: owned, error: null });\n    } catch (cause) {\n      setState({\n        key: sessionKey,\n        session: null,\n        error: cause instanceof Error ? cause : new Error(\"Could not create artifact session\"),\n      });\n    }\n    return () => {\n      const closing = owned;\n      owned = null;\n      if (closing) void closing.close().catch(() => undefined);\n    };\n  }, [retryEpoch, sessionKey]);\n\n  const retry = useCallback(() => setRetryEpoch((value) => value + 1), []);\n  const currentError = state.key === sessionKey ? state.error : null;\n  if (state.key === sessionKey && state.session) {\n    return (\n      <EditableArtifactWorkbench\n        session={state.session}\n        {...(document ? { document } : {})}\n        {...(spreadsheet ? { spreadsheet } : {})}\n        {...(presentation ? { presentation } : {})}\n      />\n    );\n  }\n  return (\n    <EditableArtifactMessage\n      title={currentError ? \"Could not open this artifact\" : \"Opening artifact\"}\n      detail={currentError?.message ?? \"Starting the secure editing session…\"}\n      retry={currentError ? retry : undefined}\n    />\n  );\n}\n\n/**\n * Complete default-browser composition for embedders: verified WASM Worker,\n * durable IndexedDB state, authenticated live sync, teardown, and the matching\n * first-party editor. Advanced/custom transports compose the lower-level host.\n */\nexport function BrowserEditableArtifactWorkbench({\n  options,\n  document,\n  spreadsheet,\n  presentation,\n}: BrowserEditableArtifactWorkbenchProps) {\n  const sessionKey = browserSessionKey(options);\n  const createSession = useCallback(() => createBrowserEditableArtifactSession(options), [options]);\n  return (\n    <EditableArtifactWorkbenchHost\n      sessionKey={sessionKey}\n      createSession={createSession}\n      {...(document ? { document } : {})}\n      {...(spreadsheet ? { spreadsheet } : {})}\n      {...(presentation ? { presentation } : {})}\n    />\n  );\n}\n\nfunction browserSessionKey(options: BrowserEditableArtifactWorkbenchOptions): string {\n  const transport = options.transport\n    ? {\n        ...options.transport,\n        // Credentials must not be copied into React lifecycle keys. The\n        // authorization epoch is the explicit credential/grant rotation fence.\n        headers: options.transport.headers\n          ? Object.keys(options.transport.headers).sort()\n          : undefined,\n      }\n    : null;\n  return JSON.stringify(\n    {\n      baseUrl: options.baseUrl,\n      workspaceId: options.workspaceId,\n      artifact: { id: options.artifact.id, modality: options.artifact.modality },\n      storageAuthority: options.storageAuthority,\n      runtime: options.runtime,\n      replicaId: options.replicaId ?? null,\n      transport,\n    },\n    (_key, value: unknown) => (value instanceof URL ? value.href : value),\n  );\n}\n"],"mappings":"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","names":["jsx"]}

package/dist/{chunk-ROIRTM37.js → chunk-5UQPNLIO.js}

@@ -1,6 +1,10 @@
+import {
+  shouldSteerOnKey,
+  shouldSubmitOnKey
+} from "./chunk-IGC6A2ZI.js";
 import {
   groupPickerRowsByBillingClass
-} from "./chunk-23EJ676W.js";
+} from "./chunk-XBZWOM2K.js";
 import {
   Tooltip,
   TooltipContent,
@@ -10,10 +14,6 @@ import {
 import {
   ComposerResponsiveContext
 } from "./chunk-VZTQ73XT.js";
-import {
-  shouldSteerOnKey,
-  shouldSubmitOnKey
-} from "./chunk-724BW4TW.js";
 import {
   composerSubmissionErrorMessage,
   formatBytes,
@@ -4531,4 +4531,4 @@ export {
   Status,
   ComposerTranscriptionControl
 };
-//# sourceMappingURL=chunk-ROIRTM37.js.map
+//# sourceMappingURL=chunk-5UQPNLIO.js.map

package/dist/{chunk-JR3QFY6B.js → chunk-6KLX2RH5.js}

@@ -267,6 +267,8 @@ function asRecord(value) {
 // src/timeline/projection.ts
 var WORKER_SPAWN_TOOL = "session_create";
 var WORKER_MESSAGE_TOOL = "session_send_message";
+var WORKER_FAILURE_CODE_MAX_LENGTH = 128;
+var WORKER_FAILURE_MESSAGE_MAX_UTF8_BYTES = 1024;
 var LANDMARK_ONLY_TOOL_LEAVES = /* @__PURE__ */ new Set(["memory_save", "memory_correct"]);
 var TIMELINE_ANNOTATION_ANSI_SEQUENCE = new RegExp("\\u001B\\[[0-?]*[ -/]*[@-~]", "g");
 function safeTimelineAnnotationJson(value) {
@@ -499,6 +501,7 @@ function buildTimeline(events) {
             action: toolMatchesLeaf(name, WORKER_SPAWN_TOOL) ? "spawn" : "message",
             prompt: workerPrompt(args),
             workerSessionId: extractSessionRef(args),
+            failure: null,
             status: "running",
             occurredAt: event.occurredAt
           });
@@ -548,6 +551,7 @@ function buildTimeline(events) {
         if (target.kind === "worker") {
           target.status = isErrorOutput(payload) ? "failed" : "complete";
           target.workerSessionId = target.workerSessionId ?? extractSessionRef(payload.output);
+          target.failure = target.status === "failed" ? workerFailure(payload.output) : null;
           break;
         }
         const truncation = toolCallTruncation(payload);
@@ -1162,7 +1166,7 @@ function foldSettledTurn(groups, turnEnd) {
   );
 }
 function isTurnBoundary(group) {
-  return group?.kind === "turn" || group?.kind === "item" && (group.item.kind === "user-message" || group.item.kind === "context-compaction" || group.item.kind === "notice" && group.item.tone === "input");
+  return group?.kind === "turn" || group?.kind === "item" && (group.item.kind === "user-message" || group.item.kind === "context-compaction" || group.item.kind === "machine-input-batch" && group.item.members.some((member) => member.kind === "media_generation_result") || group.item.kind === "notice" && group.item.tone === "input");
 }
 function belongsToDifferentTurn(group, turnId) {
   if (!group || !turnId) {
@@ -1501,6 +1505,49 @@ function workerPrompt(args) {
   }
   return null;
 }
+function boundedWorkerFailureMessage(value) {
+  const normalized = value.replace(/[\u0000-\u001f\u007f]+/g, " ").trim();
+  if (!normalized) return null;
+  const encoded = new TextEncoder().encode(normalized);
+  if (encoded.byteLength <= WORKER_FAILURE_MESSAGE_MAX_UTF8_BYTES) return normalized;
+  let end = WORKER_FAILURE_MESSAGE_MAX_UTF8_BYTES;
+  while (end > 0 && (encoded[end] & 192) === 128) end -= 1;
+  return new TextDecoder().decode(encoded.slice(0, end)).trim();
+}
+function boundedWorkerFailure(value) {
+  const record = asRecord2(value);
+  const code = typeof record.code === "string" ? record.code.trim() : "";
+  const message = typeof record.message === "string" ? boundedWorkerFailureMessage(record.message) : null;
+  if (!/^[A-Za-z0-9._:-]{1,128}$/.test(code) || !message) return null;
+  return { code: code.slice(0, WORKER_FAILURE_CODE_MAX_LENGTH), message };
+}
+function workerFailure(value, depth = 0) {
+  if (depth > 6 || value === null || value === void 0) return null;
+  if (typeof value === "string") {
+    const parsed = tryParseJson(value);
+    return parsed === value ? null : workerFailure(parsed, depth + 1);
+  }
+  if (Array.isArray(value)) {
+    for (const entry of value) {
+      const failure = workerFailure(entry, depth + 1);
+      if (failure) return failure;
+    }
+    return null;
+  }
+  if (typeof value !== "object") return null;
+  const record = value;
+  const direct = boundedWorkerFailure(record.error);
+  if (direct) return direct;
+  for (const key of ["structuredContent", "content", "result", "output"]) {
+    if (!(key in record)) continue;
+    const failure = workerFailure(record[key], depth + 1);
+    if (failure) return failure;
+  }
+  if (record.type === "text" && typeof record.text === "string") {
+    return workerFailure(record.text, depth + 1);
+  }
+  return null;
+}
 function extractSessionRef(value, depth = 0) {
   if (depth > 6 || value === null || value === void 0) {
     return null;
@@ -1557,4 +1604,4 @@ export {
   groupTimeline,
   extractSessionRef
 };
-//# sourceMappingURL=chunk-JR3QFY6B.js.map
+//# sourceMappingURL=chunk-6KLX2RH5.js.map