@opengeni/react 0.48.0 → 0.52.1

package/README.md

@@ -24,6 +24,90 @@ ancestor. Components are styled with Tailwind v4 utilities mapped onto the
 tokens, Radix primitives for behavior, and Motion for state-communicating
 animation. Override the tokens to rebrand everything.
 
+## Editable Office artifacts
+
+The optional artifact workbench is isolated from the ordinary session and
+realtime entries. The default browser composition owns one verified WASM
+Worker, durable IndexedDB state, authenticated live sync, teardown, and the
+matching editor for the artifact modality:
+
+```tsx
+import workerUrl from "@opengeni/sdk/editable-artifacts/worker?worker&url";
+import { BrowserEditableArtifactWorkbench } from "@opengeni/react/artifacts";
+import { editableArtifactKernelRuntime } from "@opengeni/artifact-kernel-wasm-spreadsheet";
+
+<BrowserEditableArtifactWorkbench
+  options={{
+    baseUrl: "https://api.example.com",
+    workspaceId,
+    artifact,
+    replicaId,
+    storageAuthority,
+    runtime: {
+      workerUrl,
+      ...editableArtifactKernelRuntime,
+      applicationOrigin: window.location.origin,
+    },
+    transport: { credentials: "include" },
+  }}
+  spreadsheet={{ title: artifact.title }}
+/>;
+```
+
+`storageAuthority` is the host's authenticated deployment/account/workspace/
+principal partition and authorization epoch; it must rotate when that authority
+or any static transport credential changes. `replicaId` is a persisted random
+64-bit writer id. Cookie auth works through `credentials`; self-hosted browser
+consoles may pass static deployment-bound `transport.headers`. Browser API keys
+and custom fetch/WebSocket functions stay on the lower-level
+`EditableArtifactWorkbenchHost`, whose host supplies its own SDK session factory
+and complete `sessionKey`.
+
+Hosts that already own an `EditableArtifactSession` can render one modality
+directly. No snapshot or artifact-tool model crosses onto the React thread:
+
+```tsx
+import { EditableSpreadsheetArtifactSurface } from "@opengeni/react/artifacts/spreadsheet";
+import { EditableDocumentArtifactSurface } from "@opengeni/react/artifacts/document";
+import { EditablePresentationArtifactSurface } from "@opengeni/react/artifacts/presentation";
+
+<EditableSpreadsheetArtifactSurface session={spreadsheetSession} title="Report" />;
+<EditableDocumentArtifactSurface session={documentSession} title="Brief" />;
+<EditablePresentationArtifactSurface session={presentationSession} title="Launch deck" />;
+```
+
+The durable document surface composes bounded summary, body, section, and
+review queries at one native revision. Text edits become UTF-16-correct minimal
+`paragraph.edit` commands; formatting becomes `paragraph.format`. Empty
+documents use the SDK's native-namespace structural allocator to create their
+first durable paragraph without inventing React-side identity rules.
+
+The durable presentation surface composes the bounded slide catalog and
+per-slide editor ABI. It keeps master/layout inheritance and node hierarchy in
+the projection, renders inherited nodes read-only in slide mode, and maps
+movement, resizing, and rich-text changes to canonical node commands. Geometry
+uses the Office EMU-to-CSS-pixel scale; unchanged command fields retain their
+exact canonical values. Slide and text-box insertion/deletion likewise use
+canonical SDK/session commands; optimistic UI never mutates a shadow deck.
+
+Run `OPENGENI_REACT_DEMO_API_TARGET=http://127.0.0.1:8000 bun run demo`, then
+open `http://localhost:3100/editable-artifacts.html?workspaceId=<id>`. This is a
+live public-SDK reference consumer for all three modalities; it has no in-memory
+or permissive fallback.
+
+`DocumentProjectionEditor`, `PresentationProjectionEditor`, and
+`SpreadsheetProjectionGrid` expose the same host-owned projection/async-command
+boundary without requiring the OpenGeni sync session. Pending, failure, retry,
+read-only, focus, and reconciliation behavior stays inside the components.
+
+Projection editors use browser-safe structural views and do not load
+`@opengeni/artifact-tool`, its codecs, or native bindings. Local authoring tools
+can optionally supply the reference models from `@opengeni/artifact-tool/reference`
+to the compatible `DocumentEditor`,
+`PresentationEditor`, or `SpreadsheetGrid` adapters. Those convenience adapters
+deliberately mutate the supplied public authoring model.
+`@opengeni/react/artifacts` remains the all-modality barrel.
+
 ## Install & styles
 
 Hosts that render their own UI should import the session-only surface:
@@ -466,7 +550,10 @@ intentional changes should regenerate those snapshots and review the diff.
 - `MessageTimeline` — the session timeline with stick-to-bottom scrolling, a
   "jump to latest" affordance, streaming caret, collapsible activity clusters,
   and worker cards (wire `onOpenSession` to drill into a worker). Pass
-  `renderMessageText` to plug a markdown renderer.
+  `renderMessageText` to plug a markdown renderer. Pass
+  `loadRetainedArtifact` to render permanent generated-image receipts; a loader
+  may return verified bytes or a short-lived signed URL. The stock web app uses
+  the URL path to avoid copying multi-megabyte images into JavaScript memory.
 - `UserMessageBody` — the shared lossless rendered-height disclosure for
   already-sent user text. Use it inside a custom `renderMessageText` user branch
   so attachments and voice identity remain outside the clipped Markdown region.
@@ -527,7 +614,8 @@ capability document so every surface degrades to a reason instead of crashing.
 - `useSessionCapabilities(sessionId, { attachDesktop?, attachTerminal?, attachFiles? })`
   — negotiates the per-session capability doc, tracks lease liveness
   (`cold`/`warming`/`warm`), and acquires the viewer holder(s) that keep the box
-  warm. Desktop attach is gated behind the un-redacted-pixel acknowledgment.
+  warm. Opening `DesktopViewer` engages the desktop immediately and records any
+  required un-redacted/shared acknowledgment automatically before attaching.
 - `useSandboxFiles` / `useSandboxGit` — the Pierre file tree + git status/diff
   feeds. Initial and refresh reads use the SDK's batched file-frontier and
   multi-repository Git queries behind one sandbox lease; `fs.changed` /

package/dist/artifacts-document.d.ts

@@ -0,0 +1,3 @@
+/** Document-only artifact surface. Import from `@opengeni/react/artifacts/document`. */
+export { EditableDocumentArtifactSurface, type EditableDocumentArtifactSurfaceProps, } from "./components/artifacts/editable-document.js";
+export { DocumentArtifactSurface, DocumentEditor, DocumentProjectionArtifactSurface, DocumentProjectionEditor, 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, } from "./components/artifacts/document-editor.js";

package/dist/artifacts-document.js

@@ -0,0 +1,17 @@
+import {
+  DocumentArtifactSurface,
+  DocumentEditor,
+  DocumentProjectionArtifactSurface,
+  DocumentProjectionEditor,
+  EditableDocumentArtifactSurface
+} from "./chunk-HUIKIDM5.js";
+import "./chunk-KCGXPP5V.js";
+import "./chunk-22KP6LR5.js";
+export {
+  DocumentArtifactSurface,
+  DocumentEditor,
+  DocumentProjectionArtifactSurface,
+  DocumentProjectionEditor,
+  EditableDocumentArtifactSurface
+};
+//# sourceMappingURL=artifacts-document.js.map

package/dist/artifacts-document.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/artifacts-presentation.d.ts

@@ -0,0 +1,3 @@
+/** Presentation-only artifact surface. Import from `@opengeni/react/artifacts/presentation`. */
+export { EditablePresentationArtifactSurface, type EditablePresentationArtifactSurfaceProps, } from "./components/artifacts/editable-presentation.js";
+export { PresentationArtifactSurface, PresentationEditor, PresentationProjectionArtifactSurface, PresentationProjectionEditor, 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, } from "./components/artifacts/presentation-editor.js";

package/dist/artifacts-presentation.js

@@ -0,0 +1,17 @@
+import {
+  EditablePresentationArtifactSurface,
+  PresentationArtifactSurface,
+  PresentationEditor,
+  PresentationProjectionArtifactSurface,
+  PresentationProjectionEditor
+} from "./chunk-PEI6RANI.js";
+import "./chunk-KCGXPP5V.js";
+import "./chunk-22KP6LR5.js";
+export {
+  EditablePresentationArtifactSurface,
+  PresentationArtifactSurface,
+  PresentationEditor,
+  PresentationProjectionArtifactSurface,
+  PresentationProjectionEditor
+};
+//# sourceMappingURL=artifacts-presentation.js.map

package/dist/artifacts-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/artifacts-spreadsheet.d.ts

@@ -0,0 +1,3 @@
+/** Spreadsheet-only artifact surface. Import from `@opengeni/react/artifacts/spreadsheet`. */
+export { SpreadsheetArtifactSurface, SpreadsheetGrid, SpreadsheetProjectionGrid, type SpreadsheetArtifactSurfaceProps, type SpreadsheetCommit, type SpreadsheetRangeCommit, type SpreadsheetGridProps, type SpreadsheetGridProjection, type SpreadsheetProjectionCell, type SpreadsheetProjectionGridProps, type SpreadsheetSelection, type SpreadsheetViewport, } from "./components/artifacts/spreadsheet-grid.js";
+export { EditableSpreadsheetArtifactSurface, EditableSpreadsheetGrid, type EditableSpreadsheetArtifactSurfaceProps, type EditableSpreadsheetGridProps, } from "./components/artifacts/editable-spreadsheet.js";

package/dist/artifacts-spreadsheet.js

@@ -0,0 +1,17 @@
+import {
+  EditableSpreadsheetArtifactSurface,
+  EditableSpreadsheetGrid,
+  SpreadsheetArtifactSurface,
+  SpreadsheetGrid,
+  SpreadsheetProjectionGrid
+} from "./chunk-7WCLAEFV.js";
+import "./chunk-KCGXPP5V.js";
+import "./chunk-22KP6LR5.js";
+export {
+  EditableSpreadsheetArtifactSurface,
+  EditableSpreadsheetGrid,
+  SpreadsheetArtifactSurface,
+  SpreadsheetGrid,
+  SpreadsheetProjectionGrid
+};
+//# sourceMappingURL=artifacts-spreadsheet.js.map

package/dist/artifacts-spreadsheet.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/artifacts.d.ts

@@ -0,0 +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";

package/dist/artifacts.js

@@ -0,0 +1,170 @@
+import {
+  DocumentArtifactSurface,
+  DocumentEditor,
+  DocumentProjectionArtifactSurface,
+  DocumentProjectionEditor,
+  EditableDocumentArtifactSurface
+} from "./chunk-HUIKIDM5.js";
+import {
+  EditablePresentationArtifactSurface,
+  PresentationArtifactSurface,
+  PresentationEditor,
+  PresentationProjectionArtifactSurface,
+  PresentationProjectionEditor
+} from "./chunk-PEI6RANI.js";
+import {
+  EditableSpreadsheetArtifactSurface,
+  EditableSpreadsheetGrid,
+  SpreadsheetArtifactSurface,
+  SpreadsheetGrid,
+  SpreadsheetProjectionGrid
+} from "./chunk-7WCLAEFV.js";
+import {
+  ArtifactSurface,
+  EditableArtifactMessage
+} from "./chunk-KCGXPP5V.js";
+import "./chunk-22KP6LR5.js";
+
+// 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";
+function EditableArtifactWorkbench({
+  session,
+  document,
+  spreadsheet,
+  presentation
+}) {
+  switch (session.modality) {
+    case "document":
+      return /* @__PURE__ */ jsx(
+        EditableDocumentArtifactSurface,
+        {
+          ...document,
+          session,
+          title: document?.title ?? "Document"
+        }
+      );
+    case "spreadsheet":
+      return /* @__PURE__ */ jsx(EditableSpreadsheetArtifactSurface, { ...spreadsheet, session });
+    case "presentation":
+      return /* @__PURE__ */ jsx(EditablePresentationArtifactSurface, { ...presentation, session });
+  }
+}
+function EditableArtifactWorkbenchHost({
+  sessionKey,
+  createSession,
+  document,
+  spreadsheet,
+  presentation
+}) {
+  const createSessionRef = useRef(createSession);
+  const [retryEpoch, setRetryEpoch] = useState(0);
+  const [state, setState] = useState({ key: null, session: null, error: null });
+  useEffect(() => {
+    createSessionRef.current = createSession;
+  }, [createSession]);
+  useEffect(() => {
+    let owned = null;
+    setState({ key: sessionKey, session: null, error: null });
+    try {
+      owned = createSessionRef.current();
+      setState({ key: sessionKey, session: owned, error: null });
+    } catch (cause) {
+      setState({
+        key: sessionKey,
+        session: null,
+        error: cause instanceof Error ? cause : new Error("Could not create artifact session")
+      });
+    }
+    return () => {
+      const closing = owned;
+      owned = null;
+      if (closing) void closing.close().catch(() => void 0);
+    };
+  }, [retryEpoch, sessionKey]);
+  const retry = useCallback(() => setRetryEpoch((value) => value + 1), []);
+  const currentError = state.key === sessionKey ? state.error : null;
+  if (state.key === sessionKey && state.session) {
+    return /* @__PURE__ */ jsx(
+      EditableArtifactWorkbench,
+      {
+        session: state.session,
+        ...document ? { document } : {},
+        ...spreadsheet ? { spreadsheet } : {},
+        ...presentation ? { presentation } : {}
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    EditableArtifactMessage,
+    {
+      title: currentError ? "Could not open this artifact" : "Opening artifact",
+      detail: currentError?.message ?? "Starting the secure editing session\u2026",
+      retry: currentError ? retry : void 0
+    }
+  );
+}
+function BrowserEditableArtifactWorkbench({
+  options,
+  document,
+  spreadsheet,
+  presentation
+}) {
+  const sessionKey = browserSessionKey(options);
+  const createSession = useCallback(() => createBrowserEditableArtifactSession(options), [options]);
+  return /* @__PURE__ */ jsx(
+    EditableArtifactWorkbenchHost,
+    {
+      sessionKey,
+      createSession,
+      ...document ? { document } : {},
+      ...spreadsheet ? { spreadsheet } : {},
+      ...presentation ? { presentation } : {}
+    }
+  );
+}
+function browserSessionKey(options) {
+  const transport = options.transport ? {
+    ...options.transport,
+    // Credentials must not be copied into React lifecycle keys. The
+    // authorization epoch is the explicit credential/grant rotation fence.
+    headers: options.transport.headers ? Object.keys(options.transport.headers).sort() : void 0
+  } : null;
+  return JSON.stringify(
+    {
+      baseUrl: options.baseUrl,
+      workspaceId: options.workspaceId,
+      artifact: { id: options.artifact.id, modality: options.artifact.modality },
+      storageAuthority: options.storageAuthority,
+      runtime: options.runtime,
+      replicaId: options.replicaId ?? null,
+      transport
+    },
+    (_key, value) => value instanceof URL ? value.href : value
+  );
+}
+export {
+  ArtifactSurface,
+  BrowserEditableArtifactWorkbench,
+  DocumentArtifactSurface,
+  DocumentEditor,
+  DocumentProjectionArtifactSurface,
+  DocumentProjectionEditor,
+  EditableArtifactWorkbench,
+  EditableArtifactWorkbenchHost,
+  EditableDocumentArtifactSurface,
+  EditablePresentationArtifactSurface,
+  EditableSpreadsheetArtifactSurface,
+  EditableSpreadsheetGrid,
+  PresentationArtifactSurface,
+  PresentationEditor,
+  PresentationProjectionArtifactSurface,
+  PresentationProjectionEditor,
+  SpreadsheetArtifactSurface,
+  SpreadsheetGrid,
+  SpreadsheetProjectionGrid
+};
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

@@ -0,0 +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":[]}

package/dist/chunk-6BBWWOOU.js

@@ -0,0 +1,82 @@
+// src/lib/relay-wire.ts
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+var STREAM_KIND_DESKTOP = 2;
+var STREAM_KIND_BROWSER = 3;
+var STREAM_KIND_COMPUTER = 4;
+var STREAM_ROLE_CLIENT = 2;
+function encodeChannel(message, writer) {
+  if (message.channelId !== "") writer.uint32(10).string(message.channelId);
+  if (message.workspaceId !== "") writer.uint32(18).string(message.workspaceId);
+  if (message.agentId !== "") writer.uint32(26).string(message.agentId);
+  if (message.kind !== 0) writer.uint32(32).int32(message.kind);
+  if (message.port !== 0) writer.uint32(40).uint32(message.port);
+  return writer;
+}
+function encodeStreamOpen(message) {
+  const writer = new BinaryWriter();
+  encodeChannel(message.channel, writer.uint32(10).fork()).join();
+  if (message.token !== "") writer.uint32(18).string(message.token);
+  if (message.role !== 0) writer.uint32(24).int32(message.role);
+  if (message.resumeFromSeq !== "0") writer.uint32(32).uint64(message.resumeFromSeq);
+  return writer.finish();
+}
+function decodeAgentErrorMessage(reader, length) {
+  const end = reader.pos + length;
+  let message;
+  while (reader.pos < end) {
+    const tag = reader.uint32();
+    if (tag >>> 3 === 2 && tag === 18) {
+      message = reader.string();
+      continue;
+    }
+    if ((tag & 7) === 4 || tag === 0) break;
+    reader.skip(tag & 7);
+  }
+  return message !== void 0 ? { message } : {};
+}
+function decodeStreamOpenAck(bytes) {
+  const reader = new BinaryReader(bytes);
+  const end = reader.len;
+  let accepted = false;
+  let error;
+  while (reader.pos < end) {
+    const tag = reader.uint32();
+    if (tag >>> 3 === 1 && tag === 8) {
+      accepted = reader.bool();
+      continue;
+    }
+    if (tag >>> 3 === 2 && tag === 18) {
+      error = decodeAgentErrorMessage(reader, reader.uint32());
+      continue;
+    }
+    if ((tag & 7) === 4 || tag === 0) break;
+    reader.skip(tag & 7);
+  }
+  return error !== void 0 ? { accepted, error } : { accepted };
+}
+function decodeStreamFrame(bytes) {
+  const reader = new BinaryReader(bytes);
+  const end = reader.len;
+  let data = new Uint8Array(0);
+  while (reader.pos < end) {
+    const tag = reader.uint32();
+    if (tag >>> 3 === 3 && tag === 26) {
+      data = new Uint8Array(reader.bytes());
+      continue;
+    }
+    if ((tag & 7) === 4 || tag === 0) break;
+    reader.skip(tag & 7);
+  }
+  return { data };
+}
+
+export {
+  STREAM_KIND_DESKTOP,
+  STREAM_KIND_BROWSER,
+  STREAM_KIND_COMPUTER,
+  STREAM_ROLE_CLIENT,
+  encodeStreamOpen,
+  decodeStreamOpenAck,
+  decodeStreamFrame
+};
+//# sourceMappingURL=chunk-6BBWWOOU.js.map

package/dist/chunk-6BBWWOOU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/relay-wire.ts"],"sourcesContent":["// Minimal HAND-MIRROR of the relay stream wire messages the desktop frame client\n// needs (`StreamOpen` encode; `StreamOpenAck` + `StreamFrame` decode). It exists\n// because the publish-closure guard (scripts/publish-closure-guard.ts) forbids\n// `@opengeni/react` from depending on `@opengeni/agent-proto` — the published SDK\n// closure may only reach `@opengeni/sdk` among `@opengeni/*` packages. So, exactly\n// as the guard prescribes (\"hand-mirror it\"), we re-encode just these three\n// messages against the third-party `@bufbuild/protobuf/wire` runtime (the same\n// runtime `@opengeni/agent-proto` generates against), byte-compatible with the\n// generated code. Field numbers copied verbatim from\n// `packages/agent-proto/src/gen/opengeni_agent.ts`:\n//   StreamChannel: channelId=1, workspaceId=2, agentId=3, kind=4(int32), port=5(uint32)\n//   StreamOpen:    channel=1(msg), token=2, role=3(int32), resumeFromSeq=4(uint64, omitted when \"0\")\n//   StreamOpenAck: accepted=1(bool), error=2(AgentError msg), resumeFromSeq=3\n//   AgentError:    code=1, message=2, retryable=3, detail=4  (we read only message)\n//   StreamFrame:   channelId=1, seq=2, data=3(bytes), producedAtMs=4  (we read only data)\nimport { BinaryReader, BinaryWriter } from \"@bufbuild/protobuf/wire\";\n\n/** `StreamKind.STREAM_KIND_DESKTOP` (agent-proto enum value). */\nexport const STREAM_KIND_DESKTOP = 2;\n/** `StreamKind.STREAM_KIND_BROWSER` (agent-proto enum value). */\nexport const STREAM_KIND_BROWSER = 3;\n/** `StreamKind.STREAM_KIND_COMPUTER` (agent-proto enum value). */\nexport const STREAM_KIND_COMPUTER = 4;\n/** `StreamRole.STREAM_ROLE_CLIENT` (agent-proto enum value). */\nexport const STREAM_ROLE_CLIENT = 2;\n\nexport interface RelayChannel {\n  channelId: string;\n  workspaceId: string;\n  agentId: string;\n  kind: number;\n  port: number;\n}\n\nexport interface RelayStreamOpen {\n  channel: RelayChannel;\n  token: string;\n  role: number;\n  resumeFromSeq: string;\n}\n\nfunction encodeChannel(message: RelayChannel, writer: BinaryWriter): BinaryWriter {\n  if (message.channelId !== \"\") writer.uint32(10).string(message.channelId);\n  if (message.workspaceId !== \"\") writer.uint32(18).string(message.workspaceId);\n  if (message.agentId !== \"\") writer.uint32(26).string(message.agentId);\n  if (message.kind !== 0) writer.uint32(32).int32(message.kind);\n  if (message.port !== 0) writer.uint32(40).uint32(message.port);\n  return writer;\n}\n\n/** Encode a `StreamOpen`, byte-compatible with `StreamOpen.encode(...).finish()`. */\nexport function encodeStreamOpen(message: RelayStreamOpen): Uint8Array {\n  const writer = new BinaryWriter();\n  encodeChannel(message.channel, writer.uint32(10).fork()).join();\n  if (message.token !== \"\") writer.uint32(18).string(message.token);\n  if (message.role !== 0) writer.uint32(24).int32(message.role);\n  if (message.resumeFromSeq !== \"0\") writer.uint32(32).uint64(message.resumeFromSeq);\n  return writer.finish();\n}\n\n/** The only `AgentError` field we surface from a rejected ack. */\nfunction decodeAgentErrorMessage(reader: BinaryReader, length: number): { message?: string } {\n  const end = reader.pos + length;\n  let message: string | undefined;\n  while (reader.pos < end) {\n    const tag = reader.uint32();\n    if (tag >>> 3 === 2 && tag === 18) {\n      message = reader.string();\n      continue;\n    }\n    if ((tag & 7) === 4 || tag === 0) break;\n    reader.skip(tag & 7);\n  }\n  return message !== undefined ? { message } : {};\n}\n\n/** Decode a `StreamOpenAck` (we need `accepted` + the error message). */\nexport function decodeStreamOpenAck(bytes: Uint8Array): {\n  accepted: boolean;\n  error?: { message?: string };\n} {\n  const reader = new BinaryReader(bytes);\n  const end = reader.len;\n  let accepted = false;\n  let error: { message?: string } | undefined;\n  while (reader.pos < end) {\n    const tag = reader.uint32();\n    if (tag >>> 3 === 1 && tag === 8) {\n      accepted = reader.bool();\n      continue;\n    }\n    if (tag >>> 3 === 2 && tag === 18) {\n      error = decodeAgentErrorMessage(reader, reader.uint32());\n      continue;\n    }\n    if ((tag & 7) === 4 || tag === 0) break;\n    reader.skip(tag & 7);\n  }\n  return error !== undefined ? { accepted, error } : { accepted };\n}\n\n/** Decode a `StreamFrame`, extracting only the `data` (framebuffer PNG) bytes. */\nexport function decodeStreamFrame(bytes: Uint8Array): { data: Uint8Array } {\n  const reader = new BinaryReader(bytes);\n  const end = reader.len;\n  let data = new Uint8Array(0);\n  while (reader.pos < end) {\n    const tag = reader.uint32();\n    if (tag >>> 3 === 3 && tag === 26) {\n      // Copy into a fresh ArrayBuffer-backed view: BinaryReader.bytes() returns\n      // `Uint8Array<ArrayBufferLike>` (a view into the message buffer), which both\n      // narrows the type to `Uint8Array<ArrayBuffer>` and isolates just this frame.\n      data = new Uint8Array(reader.bytes());\n      continue;\n    }\n    if ((tag & 7) === 4 || tag === 0) break;\n    reader.skip(tag & 7);\n  }\n  return { data };\n}\n"],"mappings":";AAeA,SAAS,cAAc,oBAAoB;AAGpC,IAAM,sBAAsB;AAE5B,IAAM,sBAAsB;AAE5B,IAAM,uBAAuB;AAE7B,IAAM,qBAAqB;AAiBlC,SAAS,cAAc,SAAuB,QAAoC;AAChF,MAAI,QAAQ,cAAc,GAAI,QAAO,OAAO,EAAE,EAAE,OAAO,QAAQ,SAAS;AACxE,MAAI,QAAQ,gBAAgB,GAAI,QAAO,OAAO,EAAE,EAAE,OAAO,QAAQ,WAAW;AAC5E,MAAI,QAAQ,YAAY,GAAI,QAAO,OAAO,EAAE,EAAE,OAAO,QAAQ,OAAO;AACpE,MAAI,QAAQ,SAAS,EAAG,QAAO,OAAO,EAAE,EAAE,MAAM,QAAQ,IAAI;AAC5D,MAAI,QAAQ,SAAS,EAAG,QAAO,OAAO,EAAE,EAAE,OAAO,QAAQ,IAAI;AAC7D,SAAO;AACT;AAGO,SAAS,iBAAiB,SAAsC;AACrE,QAAM,SAAS,IAAI,aAAa;AAChC,gBAAc,QAAQ,SAAS,OAAO,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK;AAC9D,MAAI,QAAQ,UAAU,GAAI,QAAO,OAAO,EAAE,EAAE,OAAO,QAAQ,KAAK;AAChE,MAAI,QAAQ,SAAS,EAAG,QAAO,OAAO,EAAE,EAAE,MAAM,QAAQ,IAAI;AAC5D,MAAI,QAAQ,kBAAkB,IAAK,QAAO,OAAO,EAAE,EAAE,OAAO,QAAQ,aAAa;AACjF,SAAO,OAAO,OAAO;AACvB;AAGA,SAAS,wBAAwB,QAAsB,QAAsC;AAC3F,QAAM,MAAM,OAAO,MAAM;AACzB,MAAI;AACJ,SAAO,OAAO,MAAM,KAAK;AACvB,UAAM,MAAM,OAAO,OAAO;AAC1B,QAAI,QAAQ,MAAM,KAAK,QAAQ,IAAI;AACjC,gBAAU,OAAO,OAAO;AACxB;AAAA,IACF;AACA,SAAK,MAAM,OAAO,KAAK,QAAQ,EAAG;AAClC,WAAO,KAAK,MAAM,CAAC;AAAA,EACrB;AACA,SAAO,YAAY,SAAY,EAAE,QAAQ,IAAI,CAAC;AAChD;AAGO,SAAS,oBAAoB,OAGlC;AACA,QAAM,SAAS,IAAI,aAAa,KAAK;AACrC,QAAM,MAAM,OAAO;AACnB,MAAI,WAAW;AACf,MAAI;AACJ,SAAO,OAAO,MAAM,KAAK;AACvB,UAAM,MAAM,OAAO,OAAO;AAC1B,QAAI,QAAQ,MAAM,KAAK,QAAQ,GAAG;AAChC,iBAAW,OAAO,KAAK;AACvB;AAAA,IACF;AACA,QAAI,QAAQ,MAAM,KAAK,QAAQ,IAAI;AACjC,cAAQ,wBAAwB,QAAQ,OAAO,OAAO,CAAC;AACvD;AAAA,IACF;AACA,SAAK,MAAM,OAAO,KAAK,QAAQ,EAAG;AAClC,WAAO,KAAK,MAAM,CAAC;AAAA,EACrB;AACA,SAAO,UAAU,SAAY,EAAE,UAAU,MAAM,IAAI,EAAE,SAAS;AAChE;AAGO,SAAS,kBAAkB,OAAyC;AACzE,QAAM,SAAS,IAAI,aAAa,KAAK;AACrC,QAAM,MAAM,OAAO;AACnB,MAAI,OAAO,IAAI,WAAW,CAAC;AAC3B,SAAO,OAAO,MAAM,KAAK;AACvB,UAAM,MAAM,OAAO,OAAO;AAC1B,QAAI,QAAQ,MAAM,KAAK,QAAQ,IAAI;AAIjC,aAAO,IAAI,WAAW,OAAO,MAAM,CAAC;AACpC;AAAA,IACF;AACA,SAAK,MAAM,OAAO,KAAK,QAAQ,EAAG;AAClC,WAAO,KAAK,MAAM,CAAC;AAAA,EACrB;AACA,SAAO,EAAE,KAAK;AAChB;","names":[]}