@theoremjs/web 0.3.4-next.419.g1bc04b7 → 0.3.4-next.421.g4bac1c7

package/README.md

@@ -177,7 +177,7 @@ await chat.submit();
 
 - `getState()` returns a `ChatState`. It is a new object after each change, and the same object between changes. So you can compare it by reference, as React's `useSyncExternalStore` does.
 - `subscribe(listener)` calls the listener once for each group of changes, after the code that made them has run. It returns the function that unsubscribes. Until the first subscribe or send, the chat asks nothing of the host. Then it reads a resumed conversation that came without its `conversationView`, and answers a restored page gate as unanswered.
-- `update(options)` gives the controller your latest options, such as a new `context`, `slots`, or `pageTools`. Each turn reads the options as they are when it is sent. `conversation`, `conversationView`, and `initialText` are read only when the controller is created.
+- `update(options)` gives the controller your latest options, such as a new `context`, `slots`, or `pageTools`. Each turn reads the options as they are when it is sent. `conversation`, `conversationView`, `initialText`, `initialFiles`, and `initialPending` are read only when the controller is created.
 - Each method is bound to the controller. Pass it as a callback as it is.
 
 `state.phase` is `'idle'`, `'streaming'`, or `'gated'`. The methods for the composer depend on it:

package/client/chat.d.ts

@@ -21,6 +21,13 @@ export type ChatOptions = {
     conversationView?: ConversationView;
     /** The text the composer starts with. Read once, when the chat is created. */
     initialText?: string;
+    /** The files the composer starts with, staged to send. Read once, when the chat is created. */
+    initialFiles?: readonly File[];
+    /**
+     * The messages the composer starts with set aside: queued, stashed or steering. Read once, when
+     * the chat is created.
+     */
+    initialPending?: readonly ComposerPendingMessage[];
     /**
      * Each new ref the host issues for the conversation: once the message posts, and again as the
      * reply's runs are saved. Keep the latest to resume the chat later. `undefined` when the host

package/client/chat.js

@@ -120,9 +120,9 @@ class Chat {
             streamBlocks: [],
             chatStarted: false,
             draftText: options.initialText ?? '',
-            pendingFiles: [],
+            pendingFiles: [...(options.initialFiles ?? [])],
             pendingVoice: [],
-            pendingMessages: [],
+            pendingMessages: orderComposerPendingMessages([...(options.initialPending ?? [])]),
             issues: [],
             failure: null,
             answering: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theoremjs/web",
-  "version": "0.3.4-next.419.g1bc04b7",
+  "version": "0.3.4-next.421.g4bac1c7",
   "description": "Theorem on the web platform, with no UI framework: Web-standard server handlers that serve a profile, and the browser client that talks to them.",
   "license": "MIT",
   "type": "module",
@@ -25,6 +25,6 @@
   },
   "peerDependencies": {
     "zod": "^4.6.5",
-    "@theoremjs/agents": "^0.3.4-next.419.g1bc04b7"
+    "@theoremjs/agents": "^0.3.4-next.421.g4bac1c7"
   }
 }