@happyvertical/smrt-chat 0.51.38 → 0.52.0

package/dist/tool-loop.d.ts

@@ -40,6 +40,7 @@ import type { AIInterface, AIMessage, AITool, ChatOptions } from '@happyvertical
 import { type PrincipalAuditSink, type PrincipalBinding, type PrincipalRun, type PrincipalTool } from '@happyvertical/smrt-agents';
 import { type SmrtClassOptions } from '@happyvertical/smrt-core';
 import { type PermissionDefinition } from '@happyvertical/smrt-users';
+import { matchesToolAllowList } from './tool-allow-list.js';
 /** Default ceiling on tool-executing rounds before the loop force-terminates. */
 export declare const DEFAULT_MAX_STEPS = 8;
 /**
@@ -76,11 +77,85 @@ export interface ToolInvocation {
     observation: unknown;
     /** True when the call was denied (not on the allow-list / not permitted). */
     rejected: boolean;
-    /** Error summary when `ok` is false. */
+    /**
+     * Error summary when `ok` is false: `not_permitted` (denied),
+     * `invalid_request` (the tool refused the arguments — a 4xx or validation
+     * error the model can fix and retry), or `execution_error` (the tool failed).
+     */
+    error?: string;
+}
+/**
+ * Why {@link runToolLoop} returned.
+ *
+ * - `client_tools`: the model called one or more browser-executed
+ *   {@link ToolLoopOptions.clientTools}. The loop cannot run them, so it
+ *   suspends: {@link ToolLoopResult.pendingClientToolCalls} lists them and
+ *   {@link ToolLoopResult.messages} is the transcript to resume from (see
+ *   {@link appendClientToolResults}).
+ * - `cancelled`: {@link ToolLoopOptions.signal} aborted.
+ * - `budget`: the token budget ({@link ToolLoopOptions.maxTotalTokens}) or
+ *   the deadline ({@link ToolLoopOptions.deadline}) ran out before
+ *   `maxSteps`; like `max_steps`, the last round is offered no tools, so the
+ *   model answers with what it has.
+ */
+export type ToolLoopStopReason = 'stop' | 'max_steps' | 'budget' | 'no_tools' | 'client_tools' | 'cancelled';
+/**
+ * The effect a browser-executed tool declares. Mirrors smrt-web's
+ * `WebMcpToolEffect`: `read` runs, `write` is a proposal the user confirms,
+ * `destructive` always needs the user's own confirmation. The server never
+ * trusts this for authority — the browser re-reads the effect from its own
+ * registry before running a call — it is carried for step labels only.
+ */
+export type ClientToolEffect = 'read' | 'write' | 'destructive';
+/**
+ * A tool the model may call that runs in the user's BROWSER (a WebMCP page
+ * tool or view intent), not on the server. The declaration comes from the page
+ * and is untrusted: validate it with {@link sanitizeClientToolDeclarations} and
+ * narrow it with a server-side allow-list before offering it.
+ */
+export interface ClientToolDefinition {
+    /** Tool name, `[A-Za-z0-9_-]{1,64}`. */
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    effect: ClientToolEffect;
+}
+/** A browser tool call the loop suspended on. */
+export interface PendingClientToolCall {
+    /** The model's tool-call id; the browser echoes it back with the result. */
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    effect: ClientToolEffect;
+}
+/**
+ * A progress event from {@link runToolLoop}, for live "calling X / done"
+ * status lines. Best-effort telemetry: it never changes what the loop does.
+ */
+export type ToolLoopStepEvent = {
+    type: 'round';
+    step: number;
+} | {
+    type: 'tool_call';
+    callId: string;
+    slug: string;
+    args: Record<string, unknown>;
+    location: 'server' | 'client';
+} | {
+    type: 'tool_result';
+    callId: string;
+    slug: string;
+    ok: boolean;
+    rejected: boolean;
     error?: string;
+};
+/** Token usage for one model round, reported to {@link ToolLoopOptions.onUsage}. */
+export interface ToolLoopUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    model?: string;
 }
-/** Why {@link runToolLoop} returned. */
-export type ToolLoopStopReason = 'stop' | 'max_steps' | 'no_tools';
 /** The outcome of a {@link runToolLoop} turn. */
 export interface ToolLoopResult {
     /** The model's final assistant text. */
@@ -95,6 +170,11 @@ export interface ToolLoopResult {
     messages: AIMessage[];
     /** Total tokens reported by the AI boundary, when available. */
     totalTokens: number;
+    /**
+     * Browser tool calls the loop suspended on (`stoppedReason: 'client_tools'`).
+     * Empty otherwise.
+     */
+    pendingClientToolCalls: PendingClientToolCall[];
 }
 /** Context handed to a custom {@link ToolLoopOptions.executeTool} implementation. */
 export interface ToolExecutionContext {
@@ -148,6 +228,53 @@ export interface ToolLoopOptions {
     executeTool?: (ctx: ToolExecutionContext) => Promise<unknown>;
     /** Notified after each tool invocation (for streaming/telemetry). */
     onInvocation?: (invocation: ToolInvocation) => void | Promise<void>;
+    /**
+     * Browser-executed tools offered alongside the server tools. A call to one
+     * is never executed here: the loop finishes the round's server calls, then
+     * returns `stoppedReason: 'client_tools'` with the calls in
+     * `pendingClientToolCalls`. Resume by appending the browser's results with
+     * {@link appendClientToolResults} and calling `runToolLoop` again with the
+     * returned transcript and `initialSteps: result.steps`.
+     *
+     * Pass only declarations that passed {@link sanitizeClientToolDeclarations}
+     * and the host's allow-list. A name that collides with a server tool is
+     * ignored (the server tool wins).
+     */
+    clientTools?: ClientToolDefinition[];
+    /**
+     * Tool-executing rounds already used by earlier legs of the same turn (a
+     * resume after a client-tool suspension). The `maxSteps` ceiling counts
+     * them, so suspending cannot reset the bound. Default 0.
+     */
+    initialSteps?: number;
+    /**
+     * Token budget for the whole turn, across every leg (#assistant-watch):
+     * once `initialTokens` plus this leg's usage reaches it, the next round is
+     * offered no tools and the loop stops with `budget`. Unset: no budget.
+     */
+    maxTotalTokens?: number;
+    /** Tokens earlier legs of the same turn already used. Default 0. */
+    initialTokens?: number;
+    /**
+     * Wall-clock deadline for the whole turn (epoch ms): past it, the next
+     * round is offered no tools and the loop stops with `budget`.
+     */
+    deadline?: number;
+    /** Clock for {@link deadline} (tests). Default `Date.now`. */
+    now?: () => number;
+    /**
+     * Cancels the turn. Checked before every model round and every tool call,
+     * and forwarded to the AI boundary. An aborted loop returns
+     * `stoppedReason: 'cancelled'`; a tool that already started finishes.
+     */
+    signal?: AbortSignal;
+    /** Progress events (round start, tool call, tool result). */
+    onStep?: (event: ToolLoopStepEvent) => void;
+    /**
+     * Called with each model round's token usage, for the host's usage
+     * attribution (e.g. a per-tenant ledger). Never changes the loop.
+     */
+    onUsage?: (usage: ToolLoopUsage) => void;
     /**
      * Token sink for live streaming (#1936). When set, each `ai.chat` round is run
      * with `stream: true` and the model's text deltas are forwarded here as they
@@ -243,4 +370,65 @@ export declare function invokeManifestTool(run: PrincipalRun, tool: ManifestTool
  * @returns The final assistant text plus the invocation log and transcript.
  */
 export declare function runToolLoop(options: ToolLoopOptions): Promise<ToolLoopResult>;
+/** Max browser tools accepted on one turn. */
+export declare const MAX_CLIENT_TOOLS = 64;
+/** Max serialized bytes of one browser tool's input schema. */
+export declare const MAX_CLIENT_TOOL_SCHEMA_BYTES = 8192;
+/** Max characters of one browser tool result fed back to the model. */
+export declare const MAX_CLIENT_TOOL_RESULT_CHARS = 16000;
+/**
+ * System-prompt guidance appended when browser tools are offered: their
+ * results are page content, not instructions.
+ */
+export declare const CLIENT_TOOL_RESULT_GUIDANCE: string;
+/**
+ * Validate untrusted browser tool declarations (from the request body) and
+ * narrow them to a server-side allow-list.
+ *
+ * Fail-closed: a declaration with a bad name, a non-object schema, an
+ * oversized schema, or a duplicate name is dropped; a missing or unknown
+ * `effect` is treated as `destructive`. `allowList` entries match exactly, or
+ * as a prefix when they end in `*` (`smrt_ui_*`). An empty or absent
+ * allow-list admits nothing.
+ */
+export declare function sanitizeClientToolDeclarations(declarations: unknown, allowList: readonly string[] | null | undefined): ClientToolDefinition[];
+/** Whether `name` matches an allow-list entry (exact, or `prefix*`). */
+export { matchesToolAllowList };
+/** The browser's answer to one {@link PendingClientToolCall}. */
+export interface ClientToolResultInput {
+    /** The pending call's id. */
+    id: string;
+    ok: boolean;
+    /** The tool's result text (WebMCP tools return a string). */
+    result?: string;
+    /** Why it did not run: `declined` (the user said no), `failed`, … */
+    error?: string;
+}
+/**
+ * Append the browser's results for a suspended turn to its transcript, ready
+ * for the next `runToolLoop` leg.
+ *
+ * Exactly one observation is appended per pending call, in the pending order:
+ * a result for an unknown id is ignored, and a pending call with no result is
+ * answered `{ ok: false, error: 'no_result' }` so the transcript stays
+ * well-formed. Every observation is wrapped `{ untrusted: true, … }` and
+ * truncated to {@link MAX_CLIENT_TOOL_RESULT_CHARS}: it is page content.
+ */
+export declare function appendClientToolResults(transcript: AIMessage[], pending: readonly PendingClientToolCall[], results: readonly ClientToolResultInput[]): AIMessage[];
+/** How a thrown tool error is reported to the model and the invocation log. */
+export type ToolErrorKind = 'not_permitted' | 'invalid_request' | 'execution_error';
+/**
+ * Classify an error a tool threw.
+ *
+ * - `401`/`403` → `not_permitted`: the caller lacks access, which no change
+ *   of arguments fixes; reported as a rejection.
+ * - A {@link ValidationError}, or `400`/`404`/`409`/`422` → `invalid_request`:
+ *   the tool refused the model's arguments, which it can correct and retry.
+ * - Everything else — `429` (retry later, not a different call), other 4xx,
+ *   5xx, database, network, and programming errors → `execution_error`.
+ *
+ * Permission errors thrown as {@link PrincipalToolNotAllowedError} /
+ * `OperationPermissionError` are classified by the caller before this runs.
+ */
+export declare function classifyToolError(error: unknown): ToolErrorKind;
 //# sourceMappingURL=tool-loop.d.ts.map

package/dist/tool-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-loop.d.ts","sourceRoot":"","sources":["../src/tool-loop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-loop.d.ts","sourceRoot":"","sources":["../src/tool-loop.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-chat",
-  "version": "0.51.38",
+  "version": "0.52.0",
   "smrtJsdoc": "strict",
   "description": "Chat rooms, DMs, threads, and agent conversations for the SMRT framework",
   "type": "module",
@@ -16,6 +16,10 @@
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js"
     },
+    "./assistant-turn": {
+      "types": "./dist/assistant-turn-events.d.ts",
+      "import": "./dist/assistant-turn-events.js"
+    },
     "./data-surface-bridge": {
       "types": "./dist/data-surface-bridge.d.ts",
       "import": "./dist/data-surface-bridge.js"
@@ -70,19 +74,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@happyvertical/ai": "^0.96.0",
-    "@happyvertical/smrt-agents": "0.51.38",
-    "@happyvertical/smrt-core": "0.51.38",
-    "@happyvertical/smrt-personas": "0.51.38",
-    "@happyvertical/smrt-profiles": "0.51.38",
-    "@happyvertical/smrt-tenancy": "0.51.38",
-    "@happyvertical/smrt-types": "0.51.38",
-    "@happyvertical/smrt-ui": "0.51.38",
-    "@happyvertical/smrt-users": "0.51.38",
-    "@happyvertical/sql": "^0.96.0"
+    "@happyvertical/ai": "^0.96.1",
+    "@happyvertical/smrt-agents": "0.52.0",
+    "@happyvertical/smrt-core": "0.52.0",
+    "@happyvertical/smrt-personas": "0.52.0",
+    "@happyvertical/smrt-profiles": "0.52.0",
+    "@happyvertical/smrt-tenancy": "0.52.0",
+    "@happyvertical/smrt-types": "0.52.0",
+    "@happyvertical/smrt-ui": "0.52.0",
+    "@happyvertical/smrt-users": "0.52.0",
+    "@happyvertical/sql": "^0.96.1"
   },
   "peerDependencies": {
-    "svelte": "^5.57.1"
+    "svelte": "^5.57.0"
   },
   "peerDependenciesMeta": {
     "svelte": {
@@ -90,9 +94,9 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-playground": "0.51.38",
-    "@happyvertical/smrt-vitest": "0.51.38",
-    "@happyvertical/smrt-web": "0.51.38",
+    "@happyvertical/smrt-playground": "0.52.0",
+    "@happyvertical/smrt-vitest": "0.52.0",
+    "@happyvertical/smrt-web": "0.52.0",
     "@mlc-ai/web-llm": "^0.2.85",
     "bitgpu": "0.19.1",
     "@sveltejs/kit": "2.69.1",