@theoremjs/react 0.3.4-next.373.gab46e23 → 0.3.4-next.375.ga2d1878

package/README.md

@@ -408,6 +408,8 @@ The hooks give you the same state and actions that the ready-made components use
 
 `useTheoremInterface` reads the interface of the profile from the server. `useTheoremChat` keeps the transcript, the streaming state, the drafts, the queue, and the gates.
 
+`useTheoremChat` binds `createChatController` from `@theoremjs/web/client` to React. To draw the chat in another framework, or in none, use the controller directly. See [A chat with no framework](https://github.com/masudl-hub/theoremai/blob/main/web/README.md#a-chat-with-no-framework).
+
 ```tsx
 import { createHttpTransport, useTheoremChat, useTheoremInterface } from '@theoremjs/react';
 

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

@@ -1,6 +1,3 @@
 import { type PageTools } from '@theoremjs/web/client';
-/**
- * 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 declare function usePageToolWarnings(declared: readonly string[] | undefined, pageTools: PageTools | undefined): void;

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

@@ -1,9 +1,6 @@
-import { pageToolMismatch } from '@theoremjs/web/client';
+import { warnPageToolMismatch } from '@theoremjs/web/client';
 import { useEffect } from 'react';
-/**
- * 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,96 +1,51 @@
-import { type ComposerPendingMessage, type ComposerProfileInterface, type ComposerRunPhase, type InterfaceTurnSession, type TranscriptBlock } from '@theoremjs/agents/interface';
-import type { ConversationView, PageTools, TheoremTransport, TurnEventSink } from '@theoremjs/web/client';
-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("@theoremjs/web/client").ClientFailure | null;
-    /** The answer on its way to a gate, shown on it until the answer settles or fails. */
-    answering: import("@theoremjs/web/client").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("@theoremjs/web/client").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;
 };