@theoremjs/web 0.3.4-next.675.g8fb1e99 → 0.3.4-next.679.gcdf1a3a

package/README.md

@@ -258,7 +258,7 @@ const transport = withPageToolDispatch(
 | `provider` | Host options, including the credential vault. A function can return these options per request, for example for tenant-specific credentials. |
 | `session` | Returns the session id of the caller, for example `${userId}:${conversationId}`. Return `undefined` to refuse the request with a 401. Default: a random id in an HttpOnly, SameSite=Lax cookie that lasts 30 days. |
 | `host` | App data for the tool handlers (`ctx.host`), such as the signed-in user. |
-| `prepare` | Your app's own turn, from the one the handler builds (`TurnWiring.prepare` from `@theoremjs/agents`). Set what your app sets per turn, such as `system`, `credentials`, `onStage` and `onAgentCall`; read your app data as `turn.host`. The handler keeps its profile, its tool execution and its abort. Your `onStage` runs before the handler's steering, and your `credentials` are read before the session's. |
+| `prepare` | Your app's own turn, from the one the handler builds (`TurnWiring.prepare` from `@theoremjs/agents`). Set what your app sets per turn, such as `system`, `credentials`, `onStage` and `onAgentCall`; read your app data as `turn.host`. The handler keeps its profile, its tool execution and its abort. Your `onStage` runs before the handler's steering, and your `credentials` are read before the session's. A call held at a gate runs on, once answered, with the `host`, `onStage` and `credentials` you give for that call's turn. |
 | `onStage` | The server's own stage handler, on every call the handler runs, a host profile's included: after your app's (`prepare`), before steering. For a rule the server adds to whatever the app says, such as a question before each tool that writes. |
 | `pageToolBroker` | Delivers results to active page dispatches. Default: bounded process memory. |
 | `conversationStore` | Where the conversation is kept. Required, except for a stateless profile, which must not have one. See [Keep the conversation](#keep-the-conversation). |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theoremjs/web",
-  "version": "0.3.4-next.675.g8fb1e99",
+  "version": "0.3.4-next.679.gcdf1a3a",
   "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.675.g8fb1e99"
+    "@theoremjs/agents": "^0.3.4-next.679.gcdf1a3a"
   }
 }

package/server/handler.d.ts

@@ -70,7 +70,7 @@ export type TheoremHandlerOptions = {
      * value the application's other call sites use too. The handler keeps its profile, its tool
      * execution and its abort. The application's `onStage` runs before the handler's steering, and
      * its `credentials` are read before the session's. A call held at a gate runs on, once
-     * answered, with the `onStage` and `credentials` it gives for that call's turn.
+     * answered, with the `host`, `onStage` and `credentials` it gives for that call's turn.
      */
     prepare?: TurnWiring['prepare'];
     /**

package/server/handler.js

@@ -362,8 +362,8 @@ async function* settleAnswered(ctx, request, session, answered) {
 }
 async function* invokeAnswered(ctx, request, sessionId, { callId, pending, answer }) {
     const host = await ctx.options.host?.(request);
-    // why: The held call goes on with what the application set for its turn: its stage handler and credentials.
-    const { credentials, onStage } = await preparedTurn(ctx.options.prepare, { profile: ctx.profile.id, input: pending.turnInput ?? {}, host, signal: request.signal }, {
+    // why: The held call goes on with what the application set for its turn: its context, stage handler and credentials.
+    const prepared = await preparedTurn(ctx.options.prepare, { profile: ctx.profile.id, input: pending.turnInput ?? {}, host, signal: request.signal }, {
         credentials: sessionCredentials(ctx, sessionId),
         ...(ctx.options.onStage ? { onStage: ctx.options.onStage } : {}),
     });
@@ -381,14 +381,14 @@ async function* invokeAnswered(ctx, request, sessionId, { callId, pending, answe
             ? { page: answer.page ?? { unanswered: true } }
             : {}),
         sessionPermissions: answer.sessionPermissions,
-        credentials,
-        ...(onStage ? { onStage } : {}),
+        credentials: prepared.credentials,
+        ...(prepared.onStage ? { onStage: prepared.onStage } : {}),
         turnInput: pending.turnInput,
         snapshot: pending.snapshot,
         promoted: pending.promoted,
         model: pending.model,
         signal: request.signal,
-        host,
+        host: prepared.host,
     });
 }
 /** A settled call's answer, streamed again. */