@salsita-ai/sdk 0.50.0-develop.b7caacb493 → 0.50.0-develop.b929a82a82

package/dist/client/phoenix-api.d.ts

@@ -303,7 +303,7 @@ export interface paths {
     /** @description Load the caller's latest assistant thread on the configuration with its active run, newest window first. The `x-assistant-thread-continuable` response header is `false` when the thread cannot be continued with this setup, has reached its size limit or is closed; a chat request then answers 409, and the thread continues once it is compacted. The `x-assistant-previous-thread` response header carries the id of the closed thread this one continues, when there is one. */
     readonly get: operations['getAssistantThread']
     readonly put?: never
-    /** @description Run the experimental assistant on the caller's thread of the configuration, or replay the run when the request carries `Last-Event-ID`. Answers 409 when the thread cannot be continued or another run is still answering, and 503 while the server shuts down; sent again, the message reaches another instance. A 409 for a thread that cannot be continued, because it is closed, was started with another setup or has reached its size limit, carries the `x-assistant-thread-continuable: false` response header; the thread continues once it is compacted. Answers 403 unless the customer has the AI Assistant feature flag on. */
+    /** @description Run the experimental assistant on the caller's thread of the configuration, or replay the run when the request carries `Last-Event-ID`. Answers 409 when the thread cannot be continued or another run is still answering, and 503 while the server shuts down; sent again, the message reaches another instance. A 409 for a thread that cannot be continued, because it is closed, was started with another setup or has reached its size limit, carries the `x-assistant-thread-continuable: false` response header; the thread continues once it is compacted. Answers 403 unless the customer has the AI Assistant feature flag on. Answers 429 to a new message when the caller, its network address or its project has used up the assistant's hourly allowance; the `Retry-After` response header holds the seconds to the next full hour, when the message may be sent again. It also answers 429, without `Retry-After`, once the environment or its customer has used up the assistant's monthly allowance, which lasts until the next month or until a super admin raises it. A request that carries tool results for a reply in progress is never refused this way. */
     readonly post: operations['assistantChat']
     readonly delete?: never
     readonly options?: never
@@ -379,6 +379,40 @@ export interface paths {
     readonly patch?: never
     readonly trace?: never
   }
+  readonly '/configurations/{configurationId}/assistant/images': {
+    readonly parameters: {
+      readonly query?: never
+      readonly header?: never
+      readonly path?: never
+      readonly cookie?: never
+    }
+    readonly get?: never
+    readonly put?: never
+    /** @description Store an image in the caller's thread on the configuration: a screenshot the browser took for a run of the assistant, or an image the user attaches to the message they are about to send. Creates the thread when the caller has none yet. The body is the raw JPEG or PNG image of at most 2 MB, with its type as the content type. The answer carries the id that messages and tool results reference the image by, as `assistant-image:<imageId>`. Answers 409 with the `x-assistant-thread-continuable: false` response header when the thread cannot take a new message of the user (closed, started with another setup or at its size limit) and is not in the middle of a reply (no run running and no client tool call waiting); the thread takes images again once it is compacted. Answers 413 for a body over 2 MB and 415 for any other content type. */
+    readonly post: operations['uploadAssistantImage']
+    readonly delete?: never
+    readonly options?: never
+    readonly head?: never
+    readonly patch?: never
+    readonly trace?: never
+  }
+  readonly '/configurations/{configurationId}/assistant/images/{imageId}': {
+    readonly parameters: {
+      readonly query?: never
+      readonly header?: never
+      readonly path?: never
+      readonly cookie?: never
+    }
+    /** @description Load an image of one of the caller's assistant threads on the configuration, a screenshot or an image the user attached, the earlier threads of the chain included. The bytes never change, so the answer may be cached for good. Answers 404 for an image that is not in one of the caller's threads on this configuration. */
+    readonly get: operations['getAssistantImage']
+    readonly put?: never
+    readonly post?: never
+    readonly delete?: never
+    readonly options?: never
+    readonly head?: never
+    readonly patch?: never
+    readonly trace?: never
+  }
   readonly '/configurations/{configurationId}/chat': {
     readonly parameters: {
       readonly query?: never
@@ -1461,6 +1495,13 @@ export interface components {
        */
       readonly scopes?: readonly string[]
     }
+    /** @description Payload Too Large: The request body is larger than the route's limit. */
+    readonly PayloadTooLargeError: {
+      /** @example Request body is too large */
+      readonly message: string
+      /** @enum {number} */
+      readonly statusCode: 413
+    }
     /**
      * @description The slug of the project, used for repository and domain creation.
      * @example my-project
@@ -1503,6 +1544,13 @@ export interface components {
       /** @enum {number} */
       readonly statusCode: 401
     }
+    /** @description Unsupported Media Type: The request body is of a content type the route does not accept. */
+    readonly UnsupportedMediaTypeError: {
+      /** @example Unsupported Media Type! */
+      readonly message: string
+      /** @enum {number} */
+      readonly statusCode: 415
+    }
     /** @description A webhook resource to which the deployment can send requests. */
     readonly Webhook: {
       /**
@@ -2013,6 +2061,11 @@ export interface operations {
           readonly 'application/json': {
             /** @description The SDK-builder customer (workspace) the API token acts in. */
             readonly customer: {
+              /**
+               * Format: uuid
+               * @description Internal UUID of the SDK-builder workspace.
+               */
+              readonly id: string
               /**
                * @description Display name of the SDK-builder workspace.
                * @example Acme
@@ -2020,6 +2073,7 @@ export interface operations {
               readonly name: string
               readonly slug: components['schemas']['CustomeSlug']
             }
+            /** @description Stable ID of the authenticated builder user. */
             readonly userId: string
           }
         }
@@ -2152,6 +2206,11 @@ export interface operations {
           readonly 'application/json': {
             /** @description The SDK-builder customer (workspace) the API token acts in. */
             readonly customer: {
+              /**
+               * Format: uuid
+               * @description Internal UUID of the SDK-builder workspace.
+               */
+              readonly id: string
               /**
                * @description Display name of the SDK-builder workspace.
                * @example Acme
@@ -2161,7 +2220,7 @@ export interface operations {
             }
             /** @description The API token (`phx_...`). */
             readonly token: string
-            /** @description The user who approved the sign-in. */
+            /** @description Stable ID of the builder user who approved the sign-in. */
             readonly userId: string
           }
         }
@@ -3039,6 +3098,15 @@ export interface operations {
           readonly 'application/json': components['schemas']['ConflictError']
         }
       }
+      /** @description Too Many Requests! */
+      readonly 429: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['TooManyRequestsError']
+        }
+      }
       /** @description Bad Gateway! */
       readonly 502: {
         headers: {
@@ -3397,6 +3465,202 @@ export interface operations {
       }
     }
   }
+  readonly uploadAssistantImage: {
+    readonly parameters: {
+      readonly query?: never
+      readonly header?: never
+      readonly path: {
+        /** @description The configuration on which the caller's assistant thread is used. */
+        readonly configurationId: components['schemas']['ConfigurationUuid']
+      }
+      readonly cookie?: never
+    }
+    /** @description The JPEG or PNG image. */
+    readonly requestBody: {
+      readonly content: {
+        readonly 'image/jpeg': string
+        readonly 'image/png': string
+      }
+    }
+    readonly responses: {
+      /** @description The image was stored in the thread. */
+      readonly 200: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': {
+            /**
+             * Format: uuid
+             * @description The id messages and tool results reference the image by.
+             */
+            readonly imageId: string
+          }
+        }
+      }
+      /** @description Bad Request! */
+      readonly 400: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['BadRequestError']
+        }
+      }
+      /** @description Unauthorized! */
+      readonly 401: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['UnauthorizedError']
+        }
+      }
+      /** @description Forbidden! */
+      readonly 403: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['ForbiddenError']
+        }
+      }
+      /** @description Not Found! */
+      readonly 404: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['NotFoundError']
+        }
+      }
+      /** @description Conflict! */
+      readonly 409: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['ConflictError']
+        }
+      }
+      /** @description Payload Too Large! */
+      readonly 413: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['PayloadTooLargeError']
+        }
+      }
+      /** @description Unsupported Media Type! */
+      readonly 415: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['UnsupportedMediaTypeError']
+        }
+      }
+      /** @description Bad Gateway! */
+      readonly 502: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['BadGatewayError']
+        }
+      }
+      /** @description An unexpected error occurred! */
+      readonly default: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['DefaultResponse']
+        }
+      }
+    }
+  }
+  readonly getAssistantImage: {
+    readonly parameters: {
+      readonly query?: never
+      readonly header?: never
+      readonly path: {
+        /** @description The configuration on which the caller's assistant thread is used. */
+        readonly configurationId: components['schemas']['ConfigurationUuid']
+        /** @description The image, as a message or a tool result references it. */
+        readonly imageId: string
+      }
+      readonly cookie?: never
+    }
+    readonly requestBody?: never
+    readonly responses: {
+      /** @description The image. */
+      readonly 200: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'image/jpeg': unknown
+          readonly 'image/png': unknown
+        }
+      }
+      /** @description Bad Request! */
+      readonly 400: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['BadRequestError']
+        }
+      }
+      /** @description Unauthorized! */
+      readonly 401: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['UnauthorizedError']
+        }
+      }
+      /** @description Forbidden! */
+      readonly 403: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['ForbiddenError']
+        }
+      }
+      /** @description Not Found! */
+      readonly 404: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['NotFoundError']
+        }
+      }
+      /** @description Bad Gateway! */
+      readonly 502: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['BadGatewayError']
+        }
+      }
+      /** @description An unexpected error occurred! */
+      readonly default: {
+        headers: {
+          readonly [name: string]: unknown
+        }
+        content: {
+          readonly 'application/json': components['schemas']['DefaultResponse']
+        }
+      }
+    }
+  }
   readonly getChatConversation: {
     readonly parameters: {
       readonly query?: never
@@ -4889,6 +5153,8 @@ export interface operations {
     readonly requestBody: {
       readonly content: {
         readonly 'application/json': {
+          /** @enum {string} */
+          readonly acceptResponseEncoding?: 'gzip'
           readonly sessionId: string
         }
       }
@@ -4986,6 +5252,7 @@ export interface operations {
           readonly headers?: {
             readonly [key: string]: string
           }
+          readonly isBase64Encoded?: boolean
           readonly requestId: string
           readonly sessionId: string
           readonly status: number
@@ -6073,6 +6340,11 @@ export interface operations {
             | boolean
             | {
                 readonly ai: {
+                  readonly hourlyLimits?: {
+                    readonly ip?: number
+                    readonly project?: number
+                    readonly sub?: number
+                  }
                   readonly maxThreadSize?: number
                   /** @enum {string} */
                   readonly model: 'frontier' | 'advanced' | 'balanced' | 'fast'
@@ -6296,6 +6568,11 @@ export interface operations {
             | boolean
             | {
                 readonly ai: {
+                  readonly hourlyLimits?: {
+                    readonly ip?: number
+                    readonly project?: number
+                    readonly sub?: number
+                  }
                   readonly maxThreadSize?: number
                   /** @enum {string} */
                   readonly model: 'frontier' | 'advanced' | 'balanced' | 'fast'

package/dist/configurator/ConfiguratorApp.js

@@ -1 +1 @@
-import{jsx as r,jsxs as e}from"react/jsx-runtime";import{I18nProvider as o}from"@lingui/react";import{QueryClientProvider as i}from"@tanstack/react-query";import n from"mui-modal-provider";import{useEffect as t}from"react";import{standardWebComponentProperties as c}from"#package/domain";import{getAvailableLocales as a,resolveLocale as m}from"#package/i18n";import{ApplicationType as l,ApplicationTypeProvider as d,InvalidDeploymentReload as p,LoaderHost as s,SessionServiceProvider as f,useApplicationQueryClient as u,useI18n as h,useSpecAlwaysExpand as g,useSpecAppLoader as x,useSpecPrefetchTextureUrls as j,useSpecPreview as k,useWebComponentProperty$ as v,useWebComponentPropertySetter as b,useWebComponentPropertyValue as y}from"#package/react-sdk";import{SnackbarProvider as C}from"#package/ui-sdk";import{ConfiguratorDataProvider as w}from"./configurator-context/ConfiguratorDataProvider.js";import{ConfiguratorResponsiveProvider as E}from"./configurator-context/ConfiguratorResponsiveProvider.js";import{usePowerRoutingLifecycle as I}from"./configurator-context/configurator-routing/use-power-routing-lifecycle.js";import{ConfiguratorRoutingProvider as L,OnApplicationStartProvider as P,OnRoutingReadyProvider as Z,OnSessionReadyProvider as q,PresetSelectionProvider as A,PreviewApplicationProvider as B}from"./configurator-context/index.js";import{LoadingErrorBoundary as D}from"./pages/error-boundaries/LoadingErrorBoundary.js";import{GeneralErrorFallback as F,RootPage as R}from"./pages/index.js";import{SceneResourcesProvider as S}from"./scene/index.js";import{EncapsulatedConfiguratorTheme as T}from"./ui/index.js";import{AppLoader as U}from"./ui/phoenix-layout-elements/index.js";export const ConfiguratorApp=()=>{let z=u(),G=h(),H=x(),J=k(),K=g(),M=j(),N=b(c.locale),O=v(c.locale);t(()=>{let r=O.subscribe(r=>{let e=m(r,a(G));G.activate(e)}),e=()=>{N(G.locale)};return G.on("change",e),()=>{r.unsubscribe(),G.removeListener("change",e)}},[O,G,N]);let Q=y(c.containerZIndex),V=y(c.power);return(I(),"off"===V)?null:r(d,{type:l.Configurator,children:r(i,{client:z,children:r(T,{children:r(s,{children:r(E,{containerZIndex:Q,children:r(U,{mode:H,children:r(B,{alwaysExpand:K,preview:J,children:r(o,{i18n:G,children:r(C,{maxSnack:5,children:r(D,{FallbackComponent:F,children:r(S,{prefetchTextureUrls:M,children:r(P,{children:r(f,{children:r(q,{children:"on"===V&&r(L,{children:r(w,{children:r(A,{children:r(Z,{children:e(n,{children:[r(p,{}),r(R,{})]})})})})})})})})})})})})})})})})})})})};
+import{jsx as r,jsxs as e}from"react/jsx-runtime";import{I18nProvider as o}from"@lingui/react";import{QueryClientProvider as n}from"@tanstack/react-query";import i from"mui-modal-provider";import{useEffect as l}from"react";import{standardWebComponentProperties as a}from"#package/domain";import{getAvailableLocales as t,resolveLocale as c}from"#package/i18n";import{ApplicationType as d,ApplicationTypeProvider as m,ConfiguratorDataProvider as s,ConfiguratorProviderSlot as p,ConfiguratorProviderSlotHost as h,ConfiguratorRoutingProvider as u,ConfiguratorUiElement as f,ConfiguratorUiElementHost as g,ErrorFallbackElement as b,LoaderHost as k,OnApplicationStartProvider as x,OnRoutingReadyProvider as j,OnSessionReadyProvider as v,PlainErrorFallback as y,PresetSelectionProvider as C,SessionServiceProvider as w,useApplicationQueryClient as E,useI18n as F,usePowerRoutingLifecycle as L,useSpecAlwaysExpand as R,useSpecPreview as q,useWebComponentProperty$ as A,useWebComponentPropertySetter as B,useWebComponentPropertyValue as D}from"#package/react-sdk";import{PreviewApplicationProvider as G}from"./configurator-context/index.js";import{LoadingErrorBoundary as H}from"./pages/error-boundaries/LoadingErrorBoundary.js";import{RootPage as I}from"./pages/index.js";let M=e=>r(b,{name:f.GeneralErrorFallback,unregisteredFallback:y,...e});export const ConfiguratorApp=()=>{let b=E(),y=F(),S=q(),T=R(),z=B(a.locale),J=A(a.locale);l(()=>{let r=J.subscribe(r=>{let e=c(r,t(y));y.activate(e)}),e=()=>{z(y.locale)};return y.on("change",e),()=>{r.unsubscribe(),y.removeListener("change",e)}},[J,y,z]);let K=D(a.power);return(L(),"off"===K)?null:r(m,{type:d.Configurator,children:r(n,{client:b,children:r(h,{slot:p.Theme,children:r(k,{children:r(h,{slot:p.Container,children:r(h,{slot:p.Loader,children:r(G,{alwaysExpand:T,preview:S,children:r(o,{i18n:y,children:r(h,{slot:p.MessageHost,children:r(H,{FallbackComponent:M,children:r(h,{slot:p.SceneResources,children:r(x,{children:r(w,{children:r(v,{children:"on"===K&&r(u,{children:r(s,{children:r(C,{children:r(j,{children:e(i,{children:[r(g,{name:f.InvalidDeploymentReload}),r(I,{})]})})})})})})})})})})})})})})})})})})})};

package/dist/configurator/application-runtime/extensions/selectors.js

@@ -1 +1 @@
-import{createSelector as e}from"@salsita-ai/common/utils";import{createSessionAssistant as t,isAssistantSetupHandler as n}from"#package/domain";import{AnimationSystem as s,AssistantSystem as o,CameraControlSystem as r,CameraSystem as a,CanvasSystem as i,DragAndDropSystem as g,ExportSystem as m,GraphQLSystem as c,ImageRenderingSystem as l,LayoutSystem as S,SketchingSystem as d}from"./systems/index.js";export const createConfiguratorExtensionSelectors=u=>{let{getState:y,domainContextSelectors:w,specSelectors:C,domainServicesSelectors:f,accessSelectors:p,commonServicesSelectors:h}=u,x=e.withTypes()([C.selectConfiguratorSpec,w.selectInitializationContext],(e,s)=>t({resolved:e.assistant,handler:e.handlers.find(n),inputs:s&&s.access?{role:s.role,sessionData:s.sessionData,access:s.access}:null})),A={getConfigurationId:()=>p.getConfiguratorConfigurationId(),getAuthorizedClient:()=>h.getConfiguratorAuthorizedClient(),getAssistantSetup:()=>x(y()),domainContextSelectors:w,domainServicesSelectors:f,specSelectors:C},I={getSystems:()=>Q,getCanvasSystem:()=>D,getCameraControlSystem:()=>v,getAnimationSystem:()=>b,getDragAndDropSystem:()=>z,getImageRenderingSystem:()=>G,getLayoutSystem:()=>T,getSketchingSystem:()=>j,getExportSystem:()=>k,getCameraSystem:()=>F,getGraphQLSystem:()=>L,getAssistantSystem:()=>R},E={...A,configuratorExtensionSelectors:I},D=new i(A),v=new r({configuratorExtensionSelectors:I}),z=new g(E),b=new s(A),k=new m(E),L=new c({...A,renderScreenshot:async(e,t)=>{let[n]=await I.getImageRenderingSystem().generateImagesFromComponents([e],t,{},{awaitSettledState:!0});if(!n)throw Error("The canvas rendered no image.");return n.blob}}),R=new o(E),T=new S(A),j=new d(E),F=new a(E),G=new l(E),Q={cameraControlSystem:v,layoutSystem:T,sketchingSystem:j,dragAndDropSystem:z,canvasSystem:D,cameraSystem:F,exportSystem:k,imageRenderingSystem:G,animationSystem:b,graphQLSystem:L,assistantSystem:R};return I};
+import{createSelector as e}from"@salsita-ai/common/utils";import{createSessionAssistant as t,isAssistantSetupHandler as n}from"#package/domain";import{AnimationSystem as s,AssistantSystem as o,CameraControlSystem as r,CameraSystem as a,CanvasSystem as i,DragAndDropSystem as g,ExportSystem as m,GraphQLSystem as l,ImageRenderingSystem as c,LayoutSystem as S,SketchingSystem as d}from"./systems/index.js";export const createConfiguratorExtensionSelectors=u=>{let{getState:y,domainContextSelectors:w,specSelectors:p,domainServicesSelectors:C,accessSelectors:f,commonServicesSelectors:h}=u,I=e.withTypes()([p.selectConfiguratorSpec,w.selectInitializationContext],(e,s)=>t({resolved:e.assistant,handler:e.handlers.find(n),inputs:s&&s.access?{role:s.role,sessionData:s.sessionData,access:s.access}:null})),A={getConfigurationId:()=>f.getConfiguratorConfigurationId(),getAuthorizedClient:()=>h.getConfiguratorAuthorizedClient(),getAssistantSetup:()=>I(y()),domainContextSelectors:w,domainServicesSelectors:C,specSelectors:p},x={getSystems:()=>G,getCanvasSystem:()=>E,getCameraControlSystem:()=>D,getAnimationSystem:()=>R,getDragAndDropSystem:()=>v,getImageRenderingSystem:()=>F,getLayoutSystem:()=>T,getSketchingSystem:()=>V,getExportSystem:()=>b,getCameraSystem:()=>j,getGraphQLSystem:()=>k,getAssistantSystem:()=>L},z={...A,configuratorExtensionSelectors:x},E=new i(A),D=new r({configuratorExtensionSelectors:x}),v=new g(z),R=new s(A),b=new m(z),k=new l({...A,renderScreenshot:async(e,t)=>{let[n]=await x.getImageRenderingSystem().generateImagesFromComponents([e],t,{},{awaitSettledState:!0});if(!n)throw Error("The canvas rendered no image.");return n.blob},uploadScreenshot:e=>A.getAuthorizedClient().uploadAssistantImage(A.getConfigurationId(),e)}),L=new o({...z,freezeView:()=>x.getImageRenderingSystem().captureView()}),T=new S(A),V=new d(z),j=new a(z),F=new c(z),G={cameraControlSystem:D,layoutSystem:T,sketchingSystem:V,dragAndDropSystem:v,canvasSystem:E,cameraSystem:j,exportSystem:b,imageRenderingSystem:F,animationSystem:R,graphQLSystem:k,assistantSystem:L};return x};

package/dist/configurator/application-runtime/extensions/systems/assistant-system/assistant-annotation.d.ts

@@ -0,0 +1,31 @@
+import type { AssistantAnnotationPin, AssistantMessageAnnotation } from '@salsita-ai/contracts/assistant';
+/**
+ * What the user made in the annotation editor: the frozen view of the configurator with their marker
+ * strokes and numbered pin badges flattened into one image, ready for the upload, and the comments of
+ * the pins. It is attached to a message like an image; see {@link AssistantSystem.send}.
+ */
+export interface AssistantAnnotation {
+    readonly blob: Blob;
+    readonly pins: ReadonlyArray<AssistantAnnotationPin>;
+}
+/**
+ * What covers the configurator for an annotation, as the layout renders it. The layout is inert
+ * while there is one.
+ *
+ * - `transition`: the view glides between the canvas padding and none; nothing is shown over it.
+ * - `editor`: the frozen view, which the user annotates; `finish` ends the editor with what they
+ *   made, or with `null` when they cancel.
+ * - `viewer`: an annotation of a sent message, read-only, until `close`.
+ */
+export type AssistantAnnotationOverlay = {
+    readonly kind: 'transition';
+} | {
+    readonly kind: 'editor';
+    /** The frozen view, at the canvas's resolution. */
+    readonly view: HTMLCanvasElement;
+    readonly finish: (annotation: AssistantAnnotation | null) => void;
+} | {
+    readonly kind: 'viewer';
+    readonly annotation: AssistantMessageAnnotation;
+    readonly close: () => void;
+};