@opengeni/react 0.48.0 → 0.57.0

package/dist/client.d.ts

@@ -4,7 +4,7 @@ import type { OpenGeniClient } from "@opengeni/sdk";
  * pass the real SDK client, a proxy-backed client that routes through their
  * own API, or a scripted client in tests/demos.
  */
-export type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listHumanInputRequests" | "getHumanInputRequest" | "submitHumanInputResponse" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "getVariableSetVariable" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listPacks" | "registerPack" | "enablePack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "getWorkspaceModelCatalog" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "fsList" | "fsListBatch" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "gitReadBatch" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose">;
+export type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listHumanInputRequests" | "getHumanInputRequest" | "submitHumanInputResponse" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "getVariableSetVariable" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listChannels" | "createChannel" | "updateChannel" | "deleteChannel" | "updateSessionChannel" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listPacks" | "registerPack" | "enablePack" | "previewPackInstallation" | "installPack" | "previewPackUninstall" | "uninstallPack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "getWorkspaceModelCatalog" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "streamWorkspaceInteractionRevisions" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "listNetworkRoutes" | "getNetworkRoute" | "createNetworkRoute" | "updateNetworkRoute" | "listSiteAuthConnections" | "getSiteAuthConnection" | "createSiteAuthConnection" | "updateSiteAuthConnection" | "listAuthRuns" | "getAuthRun" | "startBrowserAuthRun" | "reportBrowserAuthRun" | "protectedBrowserAuthFill" | "verifyBrowserAuthRun" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention" | "listAttachedBrowsers" | "getAttachedBrowser" | "listBrowserIdentities" | "getBrowserIdentity" | "createBrowserIdentity" | "updateBrowserIdentity" | "listBrowserRevisions" | "listBrowserSessions" | "getBrowserSession" | "readBrowserClipboard" | "listBrowserDownloads" | "getBrowserDownload" | "saveBrowserDownload" | "createBrowserSession" | "listBrowserTargets" | "openBrowserTarget" | "selectBrowserTarget" | "closeBrowserTarget" | "observeBrowserTarget" | "actInBrowser" | "getBrowserActionReceipt" | "listBrowserDiagnostics" | "attachBrowserSession" | "heartbeatBrowserSession" | "publishBrowserRevision" | "suspendBrowserSession" | "resumeBrowserSession" | "endBrowserSession" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession" | "fsList" | "fsListBatch" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "gitReadBatch" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose"> & Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource" | "streamWorkspaceLiveEvents">>;
 /**
  * Tenant-safe client surface required by the session-only React entry.
  *
@@ -32,4 +32,12 @@ export type EmbeddedHumanInputSessionClientLike = EmbeddedSessionEventClientLike
 /** Exact client surface required by MCP approval-policy hooks. */
 export type EmbeddedSessionMcpApprovalPolicyClientLike = EmbeddedSessionEventClientLike & Pick<OpenGeniClient, "updateSessionMcpApprovalPolicy">;
 /** Exact client surface required by the public realtime React subpath. */
-export type EmbeddedRealtimeSessionClientLike = Pick<OpenGeniClient, "getWorkspaceRealtimeModelCatalog" | "beginSessionRealtime" | "heartbeatSessionRealtime" | "negotiateCodexRealtimeWebrtc" | "negotiateGatewayRealtime" | "activateCodexRealtimeConnection" | "syncSessionRealtimeLedger" | "endSessionRealtime">;
+export type EmbeddedRealtimeSessionClientLike = Pick<OpenGeniClient, "getWorkspaceRealtimeModelCatalog" | "beginSessionRealtime" | "heartbeatSessionRealtime" | "negotiateCodexRealtimeWebrtc" | "negotiateGatewayRealtime" | "negotiateXaiSubscriptionRealtime" | "activateCodexRealtimeConnection" | "syncSessionRealtimeLedger" | "endSessionRealtime">;
+/** Exact public SDK surface required by cross-surface human interventions. */
+export type EmbeddedInterventionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention">;
+/** Exact public SDK surface required by BrowserSession hooks and components. */
+export type EmbeddedBrowserInteractionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listNetworkRoutes" | "getNetworkRoute" | "createNetworkRoute" | "updateNetworkRoute" | "listSiteAuthConnections" | "getSiteAuthConnection" | "createSiteAuthConnection" | "updateSiteAuthConnection" | "listAuthRuns" | "getAuthRun" | "startBrowserAuthRun" | "reportBrowserAuthRun" | "protectedBrowserAuthFill" | "verifyBrowserAuthRun" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention" | "listAttachedBrowsers" | "getAttachedBrowser" | "listBrowserIdentities" | "getBrowserIdentity" | "createBrowserIdentity" | "updateBrowserIdentity" | "listBrowserRevisions" | "listBrowserSessions" | "getBrowserSession" | "readBrowserClipboard" | "listBrowserDownloads" | "getBrowserDownload" | "saveBrowserDownload" | "createBrowserSession" | "listBrowserTargets" | "openBrowserTarget" | "selectBrowserTarget" | "closeBrowserTarget" | "observeBrowserTarget" | "actInBrowser" | "getBrowserActionReceipt" | "listBrowserDiagnostics" | "attachBrowserSession" | "heartbeatBrowserSession" | "publishBrowserRevision" | "suspendBrowserSession" | "resumeBrowserSession" | "endBrowserSession"> & EmbeddedInterventionClientLike;
+/** Exact public SDK surface required by ComputerSession hooks and components. */
+export type EmbeddedComputerInteractionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession"> & EmbeddedInterventionClientLike;
+/** Complete public Browser + Computer interaction surface. */
+export type EmbeddedInteractionClientLike = EmbeddedBrowserInteractionClientLike & EmbeddedComputerInteractionClientLike;

package/dist/clipboard.d.ts

@@ -0,0 +1 @@
+export { copyTextToClipboard } from "./lib/clipboard.js";

package/dist/clipboard.js

@@ -0,0 +1,7 @@
+import {
+  copyTextToClipboard
+} from "./chunk-JVYQRRC4.js";
+export {
+  copyTextToClipboard
+};
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

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

package/dist/commands/index.d.ts

@@ -1,3 +1,3 @@
-export type { CommandContext, CommandResult, Notice, SlashArg, SlashCommand } from "./types";
-export { argHint, defaultCommands, filterCommands, firstMissingRequiredArg, hasPermission, matchCommand, parseCommandLine, } from "./registry";
-export type { ParsedCommandLine } from "./registry";
+export type { CommandContext, CommandResult, Notice, SlashArg, SlashCommand } from "./types.js";
+export { argHint, defaultCommands, filterCommands, firstMissingRequiredArg, hasPermission, matchCommand, parseCommandLine, } from "./registry.js";
+export type { ParsedCommandLine } from "./registry.js";

package/dist/commands/registry.d.ts

@@ -1,5 +1,5 @@
 import type { Permission } from "@opengeni/sdk";
-import type { CommandContext, SlashArg, SlashCommand } from "./types";
+import type { CommandContext, SlashArg, SlashCommand } from "./types.js";
 /**
  * Parse a composer value into a command name + the rest. A command is
  * recognized ONLY when the value's first character is "/" (the start token);

package/dist/commands/types.d.ts

@@ -1,5 +1,5 @@
 import type { Permission, SessionStatus } from "@opengeni/sdk";
-import type { SessionClientLike } from "../client";
+import type { SessionClientLike } from "../client.js";
 /**
  * The slash-command registry. A command is a SESSION / OPERATOR control — an
  * action on the session or the UI (clear, compact, pause the goal, show help) —

package/dist/components/approval-surface.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import type { PendingApproval } from "../approvals";
+import type { PendingApproval } from "../approvals.js";
 export type ApprovalSurfaceMessages = {
     title: string;
     description: string;
@@ -25,4 +25,4 @@ export type ApprovalSurfaceProps = {
  * projection and control callbacks. It owns only presentation and duplicate
  * click fencing; OpenGeni remains the authority for approval state.
  */
-export declare function ApprovalSurface({ approvals, onApprove, onReject, responding, error, messages: overrides, renderApproval, className, }: ApprovalSurfaceProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ApprovalSurface({ approvals, onApprove, onReject, responding, error, messages: overrides, renderApproval, className, }: ApprovalSurfaceProps): import("react").JSX.Element | null;

package/dist/components/artifacts/artifact-surface.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from "react";
+export type ArtifactModality = "spreadsheet" | "document" | "presentation";
+export type ArtifactSurfaceProps = {
+    modality: ArtifactModality;
+    title: string;
+    subtitle?: ReactNode | undefined;
+    actions?: ReactNode | undefined;
+    children: ReactNode;
+    footer?: ReactNode | undefined;
+    busy?: boolean | undefined;
+    className?: string | undefined;
+};
+/**
+ * Modality-neutral artifact chrome. It deliberately owns no file, session, or
+ * persistence state: hosts can use the same surface for a local draft, a
+ * durable OpenGeni artifact, or a collaborative projection.
+ */
+export declare function ArtifactSurface({ modality, title, subtitle, actions, children, footer, busy, className, }: ArtifactSurfaceProps): import("react").JSX.Element;

package/dist/components/artifacts/document-editor.d.ts

@@ -0,0 +1,172 @@
+import type { Document as ReferenceDocument, DocumentTextStyle as ReferenceDocumentTextStyle } from "@opengeni/artifact-tool/reference";
+import { type ReactNode } from "react";
+export type DocumentLayoutMode = "paginated" | "continuous";
+export type DocumentSelection = {
+    blockId: string;
+    start: number;
+    end: number;
+};
+export type DocumentCommit = {
+    kind: "text";
+    blockId: string;
+    text: string;
+    revision: string | number;
+} | {
+    kind: "format";
+    blockId: string;
+    range: {
+        start: number;
+        end: number;
+    };
+    style: Partial<ReferenceDocumentTextStyle>;
+    revision: string | number;
+} | {
+    kind: "insert-paragraph";
+    blockId: string;
+    revision: string | number;
+};
+export type DocumentCommitHandler = ((commit: DocumentCommit) => void) | ((commit: DocumentCommit) => Promise<void>);
+export type DocumentProjectionPageGeometry = Readonly<{
+    widthPt: number;
+    heightPt: number;
+    marginTopPt: number;
+    marginRightPt: number;
+    marginBottomPt: number;
+    marginLeftPt: number;
+    headerPt?: number;
+    footerPt?: number;
+    gutterPt?: number;
+}>;
+export type DocumentProjectionTextStyle = Readonly<{
+    fontFamily?: string;
+    fontSizePt?: number;
+    color?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+}>;
+export type DocumentProjectionParagraphStyle = Readonly<{
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    alignment?: "left" | "center" | "right" | "justify";
+    spaceBeforePt?: number;
+    spaceAfterPt?: number;
+    lineHeight?: number;
+    keepNext?: boolean;
+    pageBreakBefore?: boolean;
+    list?: Readonly<{
+        kind: "bullet" | "number";
+        level?: number;
+        instanceId?: string;
+    }>;
+}>;
+export type DocumentProjectionTextRun = Readonly<{
+    text: string;
+    style?: DocumentProjectionTextStyle;
+}>;
+export type DocumentProjectionParagraph = Readonly<{
+    kind: "paragraph";
+    id: string;
+    runs: readonly DocumentProjectionTextRun[];
+    style?: DocumentProjectionParagraphStyle;
+}>;
+export type DocumentProjectionTable = Readonly<{
+    kind: "table";
+    id: string;
+    rows: readonly (readonly (readonly DocumentProjectionTextRun[])[])[];
+    style?: Readonly<{
+        widthPt?: number;
+        columnWidthsPt?: readonly number[];
+        headerRows?: number;
+        cellPaddingPt?: number;
+        borderColor?: string;
+        headerFill?: string;
+        allowRowSplit?: boolean;
+    }>;
+}>;
+export type DocumentProjectionPageBreak = Readonly<{
+    kind: "pageBreak";
+    id: string;
+}>;
+export type DocumentProjectionBlock = DocumentProjectionParagraph | DocumentProjectionTable | DocumentProjectionPageBreak;
+export type DocumentProjectionSection = Readonly<{
+    id: string;
+    startBlockIndex: number;
+    page: DocumentProjectionPageGeometry;
+    titlePage?: boolean;
+    headerBlockCounts?: readonly [number, number, number];
+    footerBlockCounts?: readonly [number, number, number];
+}>;
+export type DocumentProjectionComment = Readonly<{
+    id: string;
+    blockId: string;
+    start: number;
+    end: number;
+    resolved: boolean;
+    replies: readonly Readonly<{
+        author: string;
+        text: string;
+        createdAt: string;
+    }>[];
+}>;
+export type DocumentProjectionChange = Readonly<{
+    id: string;
+    blockId: string;
+    kind: "insert" | "delete";
+    start: number;
+    end: number;
+    author: string;
+    createdAt: string;
+}>;
+/** Immutable render/edit projection; canonical document state stays with the host. */
+export type DocumentEditorProjection = Readonly<{
+    revision: string | number;
+    page: DocumentProjectionPageGeometry;
+    blocks: readonly DocumentProjectionBlock[];
+    sections?: readonly DocumentProjectionSection[];
+    comments?: readonly DocumentProjectionComment[];
+    changes?: readonly DocumentProjectionChange[];
+}>;
+export type DocumentEditorProps = {
+    document: ReferenceDocument;
+    /** Controlled projection mode. Omit to let the editor own the toggle. */
+    layout?: DocumentLayoutMode | undefined;
+    defaultLayout?: DocumentLayoutMode | undefined;
+    onLayoutChange?: ((layout: DocumentLayoutMode) => void) | undefined;
+    onSelectionChange?: ((selection: DocumentSelection) => void) | undefined;
+    onCommit?: DocumentCommitHandler | undefined;
+    onCommandError?: ((error: Error) => void) | undefined;
+    readOnly?: boolean | undefined;
+    ariaLabel?: string | undefined;
+    viewportHeight?: number | undefined;
+    overscanPages?: number | undefined;
+    className?: string | undefined;
+};
+export type DocumentProjectionEditorProps = Omit<DocumentEditorProps, "document" | "onSelectionChange" | "onCommit"> & {
+    projection: DocumentEditorProjection;
+    commit?: DocumentCommitHandler | undefined;
+    onCommandError?: ((error: Error) => void) | undefined;
+    onSelectionChange?: ((selection: DocumentSelection) => void) | undefined;
+};
+export type DocumentProjectionArtifactSurfaceProps = Omit<DocumentProjectionEditorProps, "ariaLabel" | "className"> & {
+    title: string;
+    subtitle?: ReactNode | undefined;
+    busy?: boolean | undefined;
+    className?: string | undefined;
+    editorClassName?: string | undefined;
+};
+export type DocumentArtifactSurfaceProps = Omit<DocumentEditorProps, "ariaLabel" | "className"> & {
+    title: string;
+    subtitle?: ReactNode | undefined;
+    busy?: boolean | undefined;
+    className?: string | undefined;
+    editorClassName?: string | undefined;
+};
+/** Compatibility adapter for the public authoring model. */
+export declare function DocumentEditor(props: DocumentEditorProps): import("react").JSX.Element;
+/** Projection-first document editor with one async command boundary. */
+export declare function DocumentProjectionEditor({ projection, commit, onCommandError, onSelectionChange, readOnly, ...props }: DocumentProjectionEditorProps): import("react").JSX.Element;
+/** Artifact chrome plus the reusable document editor. */
+export declare function DocumentArtifactSurface({ document, title, subtitle, busy, className, editorClassName, ...editorProps }: DocumentArtifactSurfaceProps): import("react").JSX.Element;
+/** Artifact chrome over the projection-first document editor. */
+export declare function DocumentProjectionArtifactSurface({ projection, title, subtitle, busy, className, editorClassName, ...editorProps }: DocumentProjectionArtifactSurfaceProps): import("react").JSX.Element;

package/dist/components/artifacts/editable-artifact-ui.d.ts

@@ -0,0 +1,13 @@
+import type { EditableArtifactSession, EditableArtifactSyncView } from "@opengeni/sdk/editable-artifacts";
+export declare function useEditableArtifactView(session: EditableArtifactSession): EditableArtifactSyncView;
+/** Changes whenever the Worker-resident speculative projection may have changed. */
+export declare function editableArtifactProjectionKey(view: EditableArtifactSyncView): string;
+export declare function editableArtifactStatusLabel(view: EditableArtifactSyncView): string;
+/** Revoked read authority must hide any projection retained before invalidation. */
+export declare function editableArtifactAccessRevoked(view: EditableArtifactSyncView): boolean;
+export declare function EditableArtifactMessage({ title, detail, retry, }: {
+    title: string;
+    detail: string;
+    retry?: (() => void) | undefined;
+}): import("react").JSX.Element;
+export declare function asEditableArtifactError(cause: unknown, fallback: string): Error;

package/dist/components/artifacts/editable-artifact-workbench.d.ts

@@ -0,0 +1,49 @@
+import { type CreateBrowserEditableArtifactSessionOptions, type EditableArtifactBrowserRuntime, type EditableArtifactSession } from "@opengeni/sdk/editable-artifacts";
+import { type EditableDocumentArtifactSurfaceProps } from "./editable-document.js";
+import { type EditablePresentationArtifactSurfaceProps } from "./editable-presentation.js";
+import { type EditableSpreadsheetArtifactSurfaceProps } from "./editable-spreadsheet.js";
+export type EditableArtifactWorkbenchProps = Readonly<{
+    session: EditableArtifactSession;
+    document?: Omit<EditableDocumentArtifactSurfaceProps, "session">;
+    spreadsheet?: Omit<EditableSpreadsheetArtifactSurfaceProps, "session">;
+    presentation?: Omit<EditablePresentationArtifactSurfaceProps, "session">;
+}>;
+export type EditableArtifactWorkbenchHostProps = Omit<EditableArtifactWorkbenchProps, "session"> & Readonly<{
+    /**
+     * Complete identity of the browser session authority. Change this when the
+     * artifact, deployment, principal, or authorization epoch changes.
+     */
+    sessionKey: string;
+    /** Called for the active keyed lifecycle and again only after replacement or retry. */
+    createSession: () => EditableArtifactSession;
+}>;
+type DefaultBrowserArtifactTransport = Omit<NonNullable<CreateBrowserEditableArtifactSessionOptions["transport"]>, "apiKey" | "fetch" | "headers" | "webSocketFactory"> & Readonly<{
+    /** Static deployment auth headers; rotate authorizationEpoch when they change. */
+    headers?: Readonly<Record<string, string>>;
+}>;
+export type BrowserEditableArtifactWorkbenchOptions = Omit<CreateBrowserEditableArtifactSessionOptions, "runtime" | "storage" | "transport"> & Readonly<{
+    /** Default module Worker only; custom Worker hosts use EditableArtifactWorkbenchHost. */
+    runtime: Omit<EditableArtifactBrowserRuntime, "workerFactory">;
+    /** Default fetch/WebSocket only; static deployment auth headers are supported. */
+    transport?: DefaultBrowserArtifactTransport;
+}>;
+export type BrowserEditableArtifactWorkbenchProps = Omit<EditableArtifactWorkbenchProps, "session"> & Readonly<{
+    options: BrowserEditableArtifactWorkbenchOptions;
+}>;
+/**
+ * One modality-neutral SDK workbench. Embedding hosts keep one route/component;
+ * each artifact still renders through its complete first-party editor surface.
+ */
+export declare function EditableArtifactWorkbench({ session, document, spreadsheet, presentation, }: EditableArtifactWorkbenchProps): import("react").JSX.Element;
+/**
+ * Route/embed composition that owns exactly one SDK session. The host supplies
+ * the authenticated SDK factory; React guarantees replacement and teardown.
+ */
+export declare function EditableArtifactWorkbenchHost({ sessionKey, createSession, document, spreadsheet, presentation, }: EditableArtifactWorkbenchHostProps): import("react").JSX.Element;
+/**
+ * Complete default-browser composition for embedders: verified WASM Worker,
+ * durable IndexedDB state, authenticated live sync, teardown, and the matching
+ * first-party editor. Advanced/custom transports compose the lower-level host.
+ */
+export declare function BrowserEditableArtifactWorkbench({ options, document, spreadsheet, presentation, }: BrowserEditableArtifactWorkbenchProps): import("react").JSX.Element;
+export {};

package/dist/components/artifacts/editable-document.d.ts

@@ -0,0 +1,24 @@
+import { type EditableArtifactSession } from "@opengeni/sdk/editable-artifacts";
+import { type ReactNode } from "react";
+import { type DocumentCommitHandler, type DocumentEditorProjection, type DocumentProjectionArtifactSurfaceProps } from "./document-editor.js";
+export type EditableDocumentArtifactSurfaceProps = Omit<DocumentProjectionArtifactSurfaceProps, "projection" | "commit" | "readOnly" | "busy" | "subtitle"> & {
+    session: EditableArtifactSession;
+    subtitle?: ReactNode | undefined;
+    readOnly?: boolean | undefined;
+    /** Called only after the durable SDK command has been accepted locally. */
+    onCommit?: DocumentCommitHandler | undefined;
+};
+/**
+ * Durable document editor over the public SDK session. Canonical state and
+ * speculative replay remain Worker-owned; React receives bounded projections.
+ */
+export declare function EditableDocumentArtifactSurface({ session, title, subtitle, readOnly, onCommit, onCommandError, ...surfaceProps }: EditableDocumentArtifactSurfaceProps): import("react").JSX.Element;
+/** Deterministically composes summary/body/sections/review at one Worker revision. */
+export declare function composeDocumentEditorProjection(session: EditableArtifactSession): Promise<DocumentEditorProjection>;
+export declare function minimalUtf16TextEdit(before: string, after: string): {
+    range: {
+        start: number;
+        end: number;
+    };
+    replacement: string;
+} | null;

package/dist/components/artifacts/editable-presentation.d.ts

@@ -0,0 +1,24 @@
+import { type EditableArtifactSession, type PresentationArtifactEditorSceneNode, type PresentationArtifactRichText } from "@opengeni/sdk/editable-artifacts";
+import { type ReactNode } from "react";
+import { type PresentationCommitHandler, type PresentationEditorProjection, type PresentationProjectionArtifactSurfaceProps } from "./presentation-editor.js";
+export type EditablePresentationArtifactSurfaceProps = Omit<PresentationProjectionArtifactSurfaceProps, "projection" | "commit" | "readOnly" | "busy" | "subtitle"> & {
+    session: EditableArtifactSession;
+    subtitle?: ReactNode | undefined;
+    readOnly?: boolean | undefined;
+    /** Called only after the durable SDK command has been accepted locally. */
+    onCommit?: PresentationCommitHandler | undefined;
+};
+export type ComposedPresentationProjection = Readonly<{
+    projection: PresentationEditorProjection;
+    sceneNodes: ReadonlyMap<string, PresentationArtifactEditorSceneNode>;
+}>;
+/**
+ * Durable presentation editor over the public SDK. The Worker owns canonical
+ * state; React only receives bounded catalog and per-slide editor projections.
+ */
+export declare function EditablePresentationArtifactSurface({ session, title, subtitle, readOnly, onCommit, onCommandError, ...surfaceProps }: EditablePresentationArtifactSurfaceProps): import("react").JSX.Element;
+/** Builds a deterministic, bounded catalog + editor-slide projection at one revision. */
+export declare function composePresentationEditorProjection(session: EditableArtifactSession): Promise<ComposedPresentationProjection>;
+export declare function flattenPresentationRichText(text: PresentationArtifactRichText): string;
+/** Preserves unaffected run styles and paragraph alignment across one UTF-16 text edit. */
+export declare function replacePresentationRichText(richText: PresentationArtifactRichText, before: string, after: string): PresentationArtifactRichText;

package/dist/components/artifacts/editable-spreadsheet.d.ts

@@ -0,0 +1,32 @@
+import { type EditableArtifactSession, type EditableSpreadsheetSheetMetadata } from "@opengeni/sdk/editable-artifacts";
+import { type ReactNode } from "react";
+import { type SpreadsheetCommit, type SpreadsheetSelection, type SpreadsheetViewport } from "./spreadsheet-grid.js";
+export type EditableSpreadsheetGridProps = {
+    session: EditableArtifactSession;
+    sheet: EditableSpreadsheetSheetMetadata;
+    metadataRevision: bigint;
+    readOnly?: boolean | undefined;
+    rowCount?: number | undefined;
+    columnCount?: number | undefined;
+    overscanRows?: number | undefined;
+    overscanColumns?: number | undefined;
+    onSelectionChange?: ((selection: SpreadsheetSelection) => void) | undefined;
+    onCommit?: ((commit: SpreadsheetCommit) => void) | undefined;
+    onCommandError?: ((error: Error) => void) | undefined;
+    onViewportChange?: ((viewport: SpreadsheetViewport) => void) | undefined;
+    className?: string | undefined;
+};
+export type EditableSpreadsheetArtifactSurfaceProps = Omit<EditableSpreadsheetGridProps, "metadataRevision" | "sheet"> & {
+    title?: string | undefined;
+    subtitle?: ReactNode | undefined;
+    actions?: ReactNode | undefined;
+    initialSheetId?: string | undefined;
+    allowAddSheet?: boolean | undefined;
+};
+/**
+ * Durable spreadsheet editor over one SDK session. Canonical state remains in
+ * the dedicated Worker; React receives one bounded immutable viewport only.
+ */
+export declare function EditableSpreadsheetGrid({ session, sheet, metadataRevision, readOnly, rowCount: requestedRowCount, columnCount: requestedColumnCount, overscanRows, overscanColumns, onSelectionChange, onCommit, onCommandError, onViewportChange, className, }: EditableSpreadsheetGridProps): import("react").JSX.Element;
+/** Artifact chrome, sheet navigation, and one Worker-backed spreadsheet grid. */
+export declare function EditableSpreadsheetArtifactSurface({ session, title, subtitle, actions, initialSheetId, allowAddSheet, readOnly, ...gridProps }: EditableSpreadsheetArtifactSurfaceProps): import("react").JSX.Element;

package/dist/components/artifacts/index.d.ts

@@ -0,0 +1,9 @@
+export { ArtifactSurface, type ArtifactModality, type ArtifactSurfaceProps, } from "./artifact-surface.js";
+export { PUBLISHED_HTML_ARTIFACT_IFRAME_SANDBOX, PublishedHtmlArtifactFrame, type PublishedHtmlArtifactFrameProps, } from "./published-html-artifact-frame.js";
+export { SpreadsheetArtifactSurface, SpreadsheetGrid, SpreadsheetProjectionGrid, type SpreadsheetArtifactSurfaceProps, type SpreadsheetCommit, type SpreadsheetRangeCommit, type SpreadsheetGridProps, type SpreadsheetGridProjection, type SpreadsheetProjectionCell, type SpreadsheetProjectionGridProps, type SpreadsheetSelection, type SpreadsheetViewport, } from "./spreadsheet-grid.js";
+export { EditableSpreadsheetArtifactSurface, EditableSpreadsheetGrid, type EditableSpreadsheetArtifactSurfaceProps, type EditableSpreadsheetGridProps, } from "./editable-spreadsheet.js";
+export { BrowserEditableArtifactWorkbench, EditableArtifactWorkbench, EditableArtifactWorkbenchHost, type BrowserEditableArtifactWorkbenchOptions, type BrowserEditableArtifactWorkbenchProps, type EditableArtifactWorkbenchHostProps, type EditableArtifactWorkbenchProps, } from "./editable-artifact-workbench.js";
+export { EditableDocumentArtifactSurface, type EditableDocumentArtifactSurfaceProps, } from "./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 "./document-editor.js";
+export { EditablePresentationArtifactSurface, type EditablePresentationArtifactSurfaceProps, } from "./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 "./presentation-editor.js";