@theoremjs/web 0.3.4-next.401.gec4c582 → 0.3.4-next.405.g57fd3a0

package/README.md

@@ -483,6 +483,7 @@ On the browser side, `@theoremjs/web/client` reads what your server sends:
 | `ChatLine`, `ChatLineSink` | A checked line, and the callback that receives each one. |
 | `fetchConversation(url, body, options?)` | POSTs a conversation read, and checks the view your server answers. |
 | `fetchRewound(url, body, options?)` | POSTs a rewind, and checks the rewound conversation. |
+| `fetchStarted(url, body, options?)` | POSTs blocks to start a conversation on, and checks the started conversation. |
 | `failedDecisionTraces(err)` | The trace records that a failed decision left, for the trace inspector. |
 
 ## More documentation

package/client/index.d.ts

@@ -33,5 +33,5 @@ export { hasLead, layoutResult, type ResultChart, type ResultFigure, type Result
 export type { AnsweringGate, ToolDecisionAction, ToolGateResolution, } from './tool-resume.ts';
 export { continueGatedToolInvocation, type PersonGateResolution } from './tool-resume.ts';
 export { createTraceFeed, type TraceFeed } from './trace-feed.ts';
-export { CHAT_LINES, type ChatLine, type ChatLineSink, type ClientTurnEvent, type ConversationLine, type ConversationView, createHttpTransport, fetchConversation, fetchRewound, type HostErrorBody, type HttpOptions, type HttpTransportOptions, hostError, isTheoremStreamError, type MalformedEvent, postJson, postNdjson, readNdjsonStream, type TheoremConversationRequest, type TheoremInvokeRequest, type TheoremReplay, type TheoremRewindRequest, type TheoremRewound, type TheoremSteerRequest, TheoremStreamError, type TheoremTransport, type TheoremTurnInput, type TheoremTurnRequest, type TurnEventSink, type UnsupportedEvent, type WireLines, } from './transport.ts';
+export { CHAT_LINES, type ChatLine, type ChatLineSink, type ClientTurnEvent, type ConversationLine, type ConversationView, createHttpTransport, fetchConversation, fetchRewound, fetchStarted, type HostErrorBody, type HttpOptions, type HttpTransportOptions, hostError, isTheoremStreamError, type MalformedEvent, postJson, postNdjson, readNdjsonStream, type TheoremConversationRequest, type TheoremInvokeRequest, type TheoremReplay, type TheoremRewindRequest, type TheoremRewound, type TheoremStartRequest, type TheoremSteerRequest, TheoremStreamError, type TheoremTransport, type TheoremTurnInput, type TheoremTurnRequest, type TurnEventSink, type UnsupportedEvent, type WireLines, } from './transport.ts';
 export { buildInvokeRequest, buildTurnRequest, foldAssistantTurn, issuedOperationId, type RunScope, type WalkAway, } from './turn-client.ts';

package/client/index.js

@@ -27,5 +27,5 @@ export { DOT_FLOATS, FRAME_SLOT, queryGeometry, SEGMENT_FLOATS, spaceGeometry, }
 export { hasLead, layoutResult, returnedMedia, timeFormats, } from "./tool-result.js";
 export { continueGatedToolInvocation } from "./tool-resume.js";
 export { createTraceFeed } from "./trace-feed.js";
-export { CHAT_LINES, createHttpTransport, fetchConversation, fetchRewound, hostError, isTheoremStreamError, postJson, postNdjson, readNdjsonStream, TheoremStreamError, } from "./transport.js";
+export { CHAT_LINES, createHttpTransport, fetchConversation, fetchRewound, fetchStarted, hostError, isTheoremStreamError, postJson, postNdjson, readNdjsonStream, TheoremStreamError, } from "./transport.js";
 export { buildInvokeRequest, buildTurnRequest, foldAssistantTurn, issuedOperationId, } from "./turn-client.js";

package/client/transport.d.ts

@@ -158,7 +158,13 @@ export type TheoremRewindRequest = {
 };
 /** A `/rewind` body as `createTheoremHandler` reads it. */
 export declare const theoremRewindRequestSchema: z.ZodType<TheoremRewindRequest>;
-/** A rewound conversation: its new ref, and what the browser draws. */
+/** Start a conversation on blocks the host wrote, not ran: a `/conversation/start` body. */
+export type TheoremStartRequest = {
+    blocks: TranscriptBlock[];
+};
+/** A `/conversation/start` body as a host reads it. */
+export declare const theoremStartRequestSchema: z.ZodType<TheoremStartRequest>;
+/** A rewound or started conversation: its new ref, and what the browser draws. */
 export type TheoremRewound = {
     conversation: string;
     view: ConversationView;
@@ -256,6 +262,10 @@ export declare function fetchConversation(url: string, body: unknown, options?:
 export declare function fetchRewound(url: string, body: unknown, options?: HttpOptions & {
     signal?: AbortSignal;
 }): Promise<TheoremRewound>;
+/** POST blocks to start a conversation on to `url`, and check the conversation the host answers. */
+export declare function fetchStarted(url: string, body: unknown, options?: HttpOptions & {
+    signal?: AbortSignal;
+}): Promise<TheoremRewound>;
 export type HttpTransportOptions = HttpOptions & {
     /** Base URL where `createTheoremHandler` is mounted. Default `/api/theorem`. */
     endpoint?: string;

package/client/transport.js

@@ -112,6 +112,10 @@ const theoremRewindRequest = z.object({
 true;
 /** A `/rewind` body as `createTheoremHandler` reads it. */
 export const theoremRewindRequestSchema = theoremRewindRequest;
+const theoremStartRequest = z.object({ blocks: z.array(transcriptBlockSchema) });
+true;
+/** A `/conversation/start` body as a host reads it. */
+export const theoremStartRequestSchema = theoremStartRequest;
 const theoremRewound = z.object({ conversation: z.string().min(1), view: conversationView });
 true;
 /**
@@ -295,10 +299,19 @@ export async function fetchConversation(url, body, options = {}) {
     // labels-exempt: internal diagnostic; the user reads error.bad_response
     return checkWire(conversationView, await fetchJson(url, { body, signal }, http), 'the conversation');
 }
-/** POST a rewind to `url`, and check the rewound conversation the host answers. */
-export async function fetchRewound(url, body, options = {}) {
+async function fetchConversationRef(url, body, options, what) {
     const { signal, ...http } = options;
-    return checkWire(theoremRewound, await fetchJson(url, { body, signal }, http), 'the rewound conversation');
+    return checkWire(theoremRewound, await fetchJson(url, { body, signal }, http), what);
+}
+/** POST a rewind to `url`, and check the rewound conversation the host answers. */
+export function fetchRewound(url, body, options = {}) {
+    // labels-exempt: internal diagnostic; the user reads error.bad_response
+    return fetchConversationRef(url, body, options, 'the rewound conversation');
+}
+/** POST blocks to start a conversation on to `url`, and check the conversation the host answers. */
+export function fetchStarted(url, body, options = {}) {
+    // labels-exempt: internal diagnostic; the user reads error.bad_response
+    return fetchConversationRef(url, body, options, 'the started conversation');
 }
 /** Drops trailing '/'s by scanning back, not with a regex (a `/\/+$/` scan is quadratic on long runs of '/'). */
 function withoutTrailingSlashes(url) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theoremjs/web",
-  "version": "0.3.4-next.401.gec4c582",
+  "version": "0.3.4-next.405.g57fd3a0",
   "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.401.gec4c582"
+    "@theoremjs/agents": "^0.3.4-next.405.g57fd3a0"
   }
 }

package/server/mod.d.ts

@@ -7,7 +7,7 @@
  */
 export { theoremHostCallRequestSchema } from '../client/host-transport.ts';
 export type { LiveClientMessage, LiveOpenMessage } from '../client/live-messages.ts';
-export { theoremConversationRequestSchema, theoremInvokeRequestSchema, theoremReplaySchema, theoremRewindRequestSchema, theoremSteerRequestSchema, theoremTurnRequestSchema, } from '../client/transport.ts';
+export { theoremConversationRequestSchema, theoremInvokeRequestSchema, theoremReplaySchema, theoremRewindRequestSchema, theoremStartRequestSchema, theoremSteerRequestSchema, theoremTurnRequestSchema, } from '../client/transport.ts';
 export { answerReply, type ConversationHost, type ConversationUse, conversationView, type IssuedWalkAway, messageReply, type OpenedConversation, openConversation, type PostedMessage, postedMessage, type ReplyLine, type ReplyRunner, type ReplyTurn, readerConversationHost, rewindConversation, startConversation, statelessRefusal, type WalkedAwayCall, waitingCalls, } from './conversation.ts';
 export { type ConversationSnapshot, type ConversationWriteResult, createMemoryConversationStore, createSealedConversationStore, emptyConversation, type PausedReply, type SealedConversationStoreOptions, type StoredConversation, storedConversationSchema, type TheoremConversationStore, unknownConversation, } from './conversation-store.ts';
 export { createMemoryCredentialStore, type TheoremCredentialStore, type TheoremCredentials, } from './credential-store.ts';

package/server/mod.js

@@ -6,7 +6,7 @@
  * @module
  */
 export { theoremHostCallRequestSchema } from "../client/host-transport.js";
-export { theoremConversationRequestSchema, theoremInvokeRequestSchema, theoremReplaySchema, theoremRewindRequestSchema, theoremSteerRequestSchema, theoremTurnRequestSchema, } from "../client/transport.js";
+export { theoremConversationRequestSchema, theoremInvokeRequestSchema, theoremReplaySchema, theoremRewindRequestSchema, theoremStartRequestSchema, theoremSteerRequestSchema, theoremTurnRequestSchema, } from "../client/transport.js";
 export { answerReply, conversationView, messageReply, openConversation, postedMessage, readerConversationHost, rewindConversation, startConversation, statelessRefusal, waitingCalls, } from "./conversation.js";
 export { createMemoryConversationStore, createSealedConversationStore, emptyConversation, storedConversationSchema, unknownConversation, } from "./conversation-store.js";
 export { createMemoryCredentialStore, } from "./credential-store.js";