@theoremjs/react 0.3.4-next.363.g11be542 → 0.3.4-next.375.ga2d1878

package/components/live/use-live-runner-model.d.ts

@@ -1,7 +1,6 @@
 import type { LiveProfileInterface } from '@theoremjs/agents/interface';
+import type { LiveCallOptions, LiveConnection } from '@theoremjs/web/client';
 import { type LiveCaptionState, type LiveCaptionTurn } from '../../client/live/live-captions.ts';
-import type { LiveCallOptions } from '../../client/live/live-page-tool.ts';
-import type { LiveConnection } from '../../client/live-client.ts';
 /**
  * Owns LiveRunner state, session client, and stage callbacks.
  * `connection` resolves what the call opens: a host with a fixed profile returns
@@ -10,11 +9,11 @@ import type { LiveConnection } from '../../client/live-client.ts';
  */
 export declare function useLiveRunnerModel(iface: LiveProfileInterface, connection: () => LiveConnection | Promise<LiveConnection>, options?: LiveCallOptions): {
     handle: string;
-    traces: import("../../index.ts").TraceFeed;
+    traces: import("@theoremjs/web/client").TraceFeed;
     callStarted: boolean;
     pastCalls: LiveCaptionTurn[][];
     captions: LiveCaptionState;
-    failure: import("../../index.ts").ClientFailure | null;
+    failure: import("@theoremjs/web/client").ClientFailure | null;
     sessionEnded: string | null;
     levelsRef: import("react").RefObject<{
         input: number;
@@ -23,9 +22,9 @@ export declare function useLiveRunnerModel(iface: LiveProfileInterface, connecti
     isMuted: boolean;
     isVideoOn: boolean;
     sessionActive: boolean;
-    liveState: import("../../index.ts").LiveState;
+    liveState: import("@theoremjs/web/client").LiveState;
     activeTool: string | null;
-    status: import("../../index.ts").LiveSessionStatus;
+    status: import("@theoremjs/web/client").LiveSessionStatus;
     textAvailable: boolean;
     textDraft: string;
     toolActive: boolean;
@@ -34,7 +33,7 @@ export declare function useLiveRunnerModel(iface: LiveProfileInterface, connecti
     videoPreview: HTMLVideoElement | null;
     voiceAvailable: boolean;
     canRestart: boolean;
-    gatePrompt: import("../../index.ts").LiveToolGatePrompt | null;
+    gatePrompt: import("@theoremjs/web/client").LiveToolGatePrompt | null;
     setTextDraft: import("react").Dispatch<import("react").SetStateAction<string>>;
     handleEnd: () => void;
     startCall: (options: {
@@ -45,5 +44,5 @@ export declare function useLiveRunnerModel(iface: LiveProfileInterface, connecti
     handleToggleMic: () => void;
     handleFlipCamera: () => Promise<void>;
     handleToggleVideo: () => Promise<void>;
-    resolveGateDecision: (resolution: import("../../index.ts").ToolGateResolution) => void;
+    resolveGateDecision: (resolution: import("@theoremjs/web/client").ToolGateResolution) => void;
 };

package/components/live/use-live-runner-model.js

@@ -1,8 +1,7 @@
 import { liveIngressEnabledFromSpec } from '@theoremjs/agents';
+import { createTraceFeed, liveState } from '@theoremjs/web/client';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { stashLiveCaptionCall, } from "../../client/live/live-captions.js";
-import { liveState } from "../../client/live/live-state.js";
-import { createTraceFeed } from "../../client/trace-feed.js";
 import { usePageToolWarnings } from "../../hooks/use-page-tool-warnings.js";
 import { useLiveRunnerControls } from "./use-live-runner-controls.js";
 import { useLiveRunnerGate, useLiveRunnerUiState } from "./use-live-runner-ui.js";

package/components/live/use-live-runner-ui.d.ts

@@ -1,12 +1,10 @@
 import { type LabelOverrides, type SessionEventOf } from '@theoremjs/agents';
+import type { LiveConnectPhase, LiveGateAnswer, LiveSessionStatus, LiveToolGatePrompt, ToolGateResolution } from '@theoremjs/web/client';
+import { type ClientFailure } from '@theoremjs/web/client';
 import { type Dispatch, type SetStateAction } from 'react';
-import { type ClientFailure } from '../../client/failure.ts';
 import { applyLiveTurnToolEvent } from '../../client/live/apply-live-turn-tool-event.ts';
 import { type LiveCaptionState } from '../../client/live/live-captions.ts';
-import type { LiveConnectPhase, LiveSessionStatus } from '../../client/live/live-state.ts';
-import type { LiveGateAnswer, LiveToolGatePrompt } from '../../client/live/live-tool.ts';
 import type { LiveFacingMode, LiveVideoCapture } from '../../client/live/live-video.ts';
-import type { ToolGateResolution } from '../../client/tool-resume.ts';
 /** UI + media state bag for the live runner. `labels` is the interface's: the profile's wording. */
 export declare function useLiveRunnerUiState(labels: LabelOverrides): {
     status: LiveSessionStatus;

package/components/live/use-live-runner-ui.js

@@ -1,6 +1,6 @@
 import { TheoremError } from '@theoremjs/agents';
+import { clientFailure } from '@theoremjs/web/client';
 import { useCallback, useEffect, useRef, useState, } from 'react';
-import { clientFailure } from "../../client/failure.js";
 import { applyLiveTurnToolEvent } from "../../client/live/apply-live-turn-tool-event.js";
 import { applyLiveTurnEvent, clearLiveCaptionInterim, emptyLiveCaptionState, } from "../../client/live/live-captions.js";
 /** UI + media state bag for the live runner. `labels` is the interface's: the profile's wording. */

package/components/live/use-live-session-client.d.ts

@@ -1,12 +1,9 @@
 import { type SessionEventOf, type TurnEvent } from '@theoremjs/agents';
+import type { LiveCallOptions, LiveConnectPhase, LiveGateAnswer, LiveSessionStatus, LiveToolGatePrompt, TraceFeed } from '@theoremjs/web/client';
+import { type LiveConnection, LiveSessionClient } from '@theoremjs/web/client';
 import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
 import { type LiveCaptionState } from '../../client/live/live-captions.ts';
-import type { LiveCallOptions } from '../../client/live/live-page-tool.ts';
-import type { LiveConnectPhase, LiveSessionStatus } from '../../client/live/live-state.ts';
-import type { LiveGateAnswer, LiveToolGatePrompt } from '../../client/live/live-tool.ts';
 import type { LiveFacingMode, LiveVideoCapture } from '../../client/live/live-video.ts';
-import { type LiveConnection, LiveSessionClient } from '../../client/live-client.ts';
-import type { TraceFeed } from '../../client/trace-feed.ts';
 export type LiveClientBindings = LiveCallOptions & {
     voiceAvailable: boolean;
     /** Where the session's trace records go, when the relay delivers them. */

package/components/live/use-live-session-client.js

@@ -1,8 +1,8 @@
 import { TheoremError } from '@theoremjs/agents';
+import { LiveSessionClient } from '@theoremjs/web/client';
 import { useCallback, useRef, } from 'react';
 import { applyLiveTranscript } from "../../client/live/live-captions.js";
 import { runLiveToolCall } from "../../client/live/run-live-tool-call.js";
-import { LiveSessionClient } from "../../client/live-client.js";
 function onLiveStatusChange(next, bindings) {
     bindings.setStatus(next);
     if (next === 'listening' || next === 'ready') {

package/hooks/use-described.d.ts

@@ -1,4 +1,4 @@
-import { type ClientFailure } from '../client/failure.ts';
+import { type ClientFailure } from '@theoremjs/web/client';
 /**
  * What a transport describes, read once per transport; a failure when it can't be read. A new
  * transport keeps the last description up until it describes itself, so swapping one in (a

package/hooks/use-described.js

@@ -1,5 +1,5 @@
+import { clientFailure } from '@theoremjs/web/client';
 import { useEffect, useState } from 'react';
-import { clientFailure } from "../client/failure.js";
 /**
  * What a transport describes, read once per transport; a failure when it can't be read. A new
  * transport keeps the last description up until it describes itself, so swapping one in (a

package/hooks/use-embedding-index.d.ts

@@ -1,5 +1,5 @@
 import type { EmbeddingInput, EmbeddingUsage } from '@theoremjs/agents';
-import type { EmbeddingInterface, EmbeddingTransport } from '../client/embedding-transport.ts';
+import type { EmbeddingInterface, EmbeddingTransport } from '@theoremjs/web/client';
 import { type OneCallState } from './use-one-call.ts';
 /** Documents embedded for search: each one's vector, in the order given. */
 export type EmbeddingIndex = {

package/hooks/use-embedding-index.js

@@ -1,5 +1,5 @@
+import { addUsage, embeddingBatches } from '@theoremjs/web/client';
 import { useState } from 'react';
-import { addUsage, embeddingBatches } from "../client/embedding-input.js";
 import { useOneCall } from "./use-one-call.js";
 async function indexWith(transport, signal, inputs, rules, onProgress) {
     const batches = embeddingBatches(inputs, rules);

package/hooks/use-one-call.d.ts

@@ -1,6 +1,6 @@
 import type { TraceRecord } from '@theoremjs/agents';
-import { type ClientFailure } from '../client/failure.ts';
-import type { TraceFeed } from '../client/trace-feed.ts';
+import type { TraceFeed } from '@theoremjs/web/client';
+import { type ClientFailure } from '@theoremjs/web/client';
 /** A profile that answers in one call: a decision or an embedding. */
 export type OneCallTransport = {
     traces?: TraceFeed;

package/hooks/use-one-call.js

@@ -1,6 +1,5 @@
+import { clientFailure, failedTraces } from '@theoremjs/web/client';
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { failedTraces } from "../client/decision-transport.js";
-import { clientFailure } from "../client/failure.js";
 const IDLE = {
     status: 'idle',
     result: null,

package/hooks/use-page-tool-warnings.d.ts

@@ -1,6 +1,3 @@
-import { type PageTools } from '../client/live/live-page-tool.ts';
-/**
- * Says in the console, once, where the page's tools and the profile's disagree. A wrong name is
- * the builder's to fix, so it is never said to the visitor.
- */
+import { type PageTools } from '@theoremjs/web/client';
+/** Says in the console, once for each set of names, where the page's tools and the profile's disagree. */
 export declare function usePageToolWarnings(declared: readonly string[] | undefined, pageTools: PageTools | undefined): void;

package/hooks/use-page-tool-warnings.js

@@ -1,9 +1,6 @@
+import { warnPageToolMismatch } from '@theoremjs/web/client';
 import { useEffect } from 'react';
-import { pageToolMismatch } from "../client/live/live-page-tool.js";
-/**
- * Says in the console, once, where the page's tools and the profile's disagree. A wrong name is
- * the builder's to fix, so it is never said to the visitor.
- */
+/** Says in the console, once for each set of names, where the page's tools and the profile's disagree. */
 export function usePageToolWarnings(declared, pageTools) {
     const handled = Object.keys(pageTools ?? {})
         .sort()
@@ -12,14 +9,6 @@ export function usePageToolWarnings(declared, pageTools) {
     useEffect(() => {
         if (named === undefined)
             return;
-        const { unanswered, unused } = pageToolMismatch(named ? named.split('\n') : [], handled ? handled.split('\n') : []);
-        for (const name of unanswered) {
-            // labels-exempt: builder diagnostic
-            console.warn(`Theorem: page tool '${name}' has no handler in pageTools; the agent gets no answer.`);
-        }
-        for (const name of unused) {
-            // labels-exempt: builder diagnostic
-            console.warn(`Theorem: pageTools has '${name}', which the profile does not declare answeredBy: 'page'.`);
-        }
+        warnPageToolMismatch(named ? named.split('\n') : [], handled ? handled.split('\n') : []);
     }, [named, handled]);
 }

package/hooks/use-theorem-chat.d.ts

@@ -1,97 +1,51 @@
-import { type ComposerPendingMessage, type ComposerProfileInterface, type ComposerRunPhase, type InterfaceTurnSession, type TranscriptBlock } from '@theoremjs/agents/interface';
-import type { PageTools } from '../client/live/live-page-tool.ts';
-import type { ConversationView, TheoremTransport, TurnEventSink } from '../client/transport.ts';
-import { type MessageDelivery } from './use-theorem-chat-state.ts';
-export type UseTheoremChatOptions = {
-    transport: TheoremTransport;
-    /** Composer interface for the host profile — see `useTheoremInterface`. `null` while loading. */
-    iface: ComposerProfileInterface | null;
-    /**
-     * The ref of a conversation to resume, as `onConversationChange` reported it. Read once, when
-     * the chat mounts: the chat draws the conversation as the host keeps it. A stateless profile
-     * keeps no conversation, so it has no ref.
-     */
-    conversation?: string;
-    /**
-     * The conversation under `conversation` as the host showed it with the ref, as
-     * `startConversation` returns it. Read once, when the chat mounts: the chat draws it at once,
-     * and does not read it from the host again.
-     */
-    conversationView?: ConversationView;
-    /** The text the composer starts with. Read once, when the chat mounts. */
-    initialText?: string;
-    /**
-     * 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.
-     */
-    onConversationChange?: (ref: string) => void;
-    /**
-     * The value chosen for each of the profile's `inputs.slots`. Sent with every turn. A slot you
-     * name here is fixed to that value; one you leave out is chosen in the composer, starting at
-     * its first allowed value.
-     */
-    slots?: Record<string, string>;
-    /** Told each time the visitor chooses a slot in the composer, with every slot's value. */
-    onSlotsChange?: (slots: Record<string, string>) => void;
-    /** What the page wants the agent to know: any JSON. The latest value goes with every turn. */
-    context?: unknown;
-    /** The page's tools, by name: each answers a tool the profile declares with `answeredBy: 'page'`. */
-    pageTools?: PageTools;
-    /**
-     * Every event of every turn, as it arrives and before the transcript takes it: the ones the
-     * transcript shows, and the ones it does not (a stage, a session, a guardrail decision).
-     */
-    onTurnEvent?: TurnEventSink;
-};
-/** What `sendText` hands back: the blocks the turn added, its user message, and the reply. */
-export type SentTurn = {
-    blocks: TranscriptBlock[];
-};
+import { type ChatOptions, type SentTurn } from '@theoremjs/web/client';
+export type { SentTurn };
+export type UseTheoremChatOptions = ChatOptions;
 /**
  * Headless chat model: transcript, streaming, composer drafts, pending
  * queue / steer / stash, tool gates. Render it with `@theoremjs/react/ui` or
- * your own components.
+ * your own components. A React binding of `createChatController` from
+ * `@theoremjs/web/client`, which works with no framework.
  */
-export declare function useTheoremChat({ transport, iface, conversation: initialConversation, conversationView, initialText, onConversationChange, slots, onSlotsChange, context, pageTools, onTurnEvent, }: UseTheoremChatOptions): {
-    iface: ComposerProfileInterface | null;
-    blocks: TranscriptBlock[];
-    chatStarted: boolean;
-    draftText: string;
-    failure: import("../index.ts").ClientFailure | null;
-    /** The answer on its way to a gate, shown on it until the answer settles or fails. */
-    answering: import("../index.ts").AnsweringGate | null;
-    issues: import("@theoremjs/agents").AttachmentValidationIssue[];
-    pendingFiles: File[];
-    pendingMessages: ComposerPendingMessage[];
-    pendingVoice: File[];
-    phase: ComposerRunPhase;
-    session: InterfaceTurnSession;
-    /** The latest message's delivery; `null` before the first and once its turn failed. */
-    delivery: MessageDelivery | null;
-    streamBlocks: TranscriptBlock[];
-    streaming: boolean;
-    setDraftText: import("react").Dispatch<import("react").SetStateAction<string>>;
-    setPendingFiles: import("react").Dispatch<import("react").SetStateAction<File[]>>;
-    setPendingVoice: import("react").Dispatch<import("react").SetStateAction<File[]>>;
-    setPendingMessages: import("react").Dispatch<import("react").SetStateAction<ComposerPendingMessage[]>>;
-    setIssues: import("react").Dispatch<import("react").SetStateAction<import("@theoremjs/agents").AttachmentValidationIssue[]>>;
+export declare function useTheoremChat(options: UseTheoremChatOptions): {
+    slotChoices: {
+        onChange: (name: string, value: string) => void;
+        declared: Record<string, string[]>;
+        values: Record<string, string>;
+    } | undefined;
+    setDraftText: (value: import("@theoremjs/web/client").ChatUpdate<string>) => void;
+    setPendingFiles: (value: import("@theoremjs/web/client").ChatUpdate<File[]>) => void;
+    setPendingVoice: (value: import("@theoremjs/web/client").ChatUpdate<File[]>) => void;
+    setPendingMessages: (value: import("@theoremjs/web/client").ChatUpdate<import("../../../src/interface/pending").ComposerPendingMessage[]>) => void;
+    setIssues: (value: import("@theoremjs/web/client").ChatUpdate<import("../../../mod").AttachmentValidationIssue[]>) => void;
     handleAuthenticated: (_index: number, secret?: string) => Promise<void>;
     handleBranch: (index: number) => Promise<void>;
     handleSubmit: () => Promise<void>;
     handleStop: () => void;
-    handleMenuAction: (action: import("@theoremjs/agents/interface").ComposerMenuAction) => void;
+    handleMenuAction: (action: import("../../../src/interface/composer-actions").ComposerMenuAction) => void;
     handlePendingQueue: (id: string) => void;
     handlePendingRestore: (id: string) => Promise<void>;
-    handleSendNow: (draftSource?: ComposerPendingMessage) => Promise<void>;
-    handleToolDecision: (_index: number, action: import("../index.ts").ToolDecisionAction) => Promise<void>;
+    handleSendNow: (source?: import("../../../src/interface/pending").ComposerPendingMessage) => Promise<void>;
+    handleToolDecision: (_index: number, action: "allow" | "deny") => Promise<void>;
     handleGenerationChange: (next: {
         modelId: string;
         effort?: string;
     }) => void;
-    slotChoices: {
-        declared: Record<string, string[]>;
-        values: Record<string, string>;
-        onChange: (name: string, value: string) => void;
-    } | undefined;
     sendText: (text: string, files?: readonly File[]) => Promise<SentTurn | null>;
+    iface: import("../../../src/interface/types").ComposerProfileInterface | null;
+    blocks: import("../../../src/interface/types").TranscriptBlock[];
+    streamBlocks: import("../../../src/interface/types").TranscriptBlock[];
+    chatStarted: boolean;
+    draftText: string;
+    pendingFiles: File[];
+    pendingVoice: File[];
+    pendingMessages: import("../../../src/interface/pending").ComposerPendingMessage[];
+    issues: import("../../../mod").AttachmentValidationIssue[];
+    failure: import("@theoremjs/web/client").ClientFailure | null;
+    answering: import("@theoremjs/web/client").AnsweringGate | null;
+    phase: import("../../../src/interface/composer-actions").ComposerRunPhase;
+    session: import("../../../src/interface/session").InterfaceTurnSession;
+    delivery: import("@theoremjs/web/client").MessageDelivery | null;
+    streaming: boolean;
+    slots: import("@theoremjs/web/client").ChatSlots | undefined;
 };