@threadplane/chat 0.0.49 → 0.0.51

package/types/threadplane-chat.d.ts

@@ -1,20 +1,57 @@
-import * as _angular_core from '@angular/core';
-import { InjectionToken, Signal, TemplateRef, Type, WritableSignal } from '@angular/core';
 import * as _threadplane_render from '@threadplane/render';
-import { AngularRegistry, RenderEvent, ViewRegistry, RenderViewEntry } from '@threadplane/render';
-export { ViewRegistry, toRenderRegistry, views, withViews, withoutViews } from '@threadplane/render';
-import { Observable } from 'rxjs';
-import * as _json_render_core from '@json-render/core';
-import { StateStore, Spec } from '@json-render/core';
+import { StandardSchemaV1, StandardSchemaInferOutput, AngularRegistry, RenderEvent, ViewRegistry, RenderViewEntry, RenderHost } from '@threadplane/render';
+export { StandardSchemaInferInput, StandardSchemaInferOutput, StandardSchemaV1, ViewRegistry, toRenderRegistry, views, withViews, withoutViews } from '@threadplane/render';
 import { A2uiComponentDef, A2uiSurface, A2uiMessage, A2uiActionMessage } from '@threadplane/a2ui';
 export { A2uiAction, A2uiActionContextEntry, A2uiActionMessage, A2uiChildren, A2uiClientDataModel, A2uiComponent, A2uiComponentDef, A2uiSurface, A2uiTheme, DynamicBoolean, DynamicNumber, DynamicString, isLiteralBoolean, isLiteralNumber, isLiteralString, isPathRef } from '@threadplane/a2ui';
+import * as _angular_core from '@angular/core';
+import { Type, InjectionToken, Signal, TemplateRef, WritableSignal, InputSignal, InputSignalWithTransform } from '@angular/core';
+import * as _json_render_core from '@json-render/core';
+import { StateStore, Spec } from '@json-render/core';
+import { Observable } from 'rxjs';
+import * as _threadplane_chat from '@threadplane/chat';
 import { PartialJsonParser } from '@cacheplane/partial-json';
 import { BaseMessage } from '@langchain/core/messages';
 import * as _cacheplane_partial_markdown from '@cacheplane/partial-markdown';
 import { CitationDefinition, MarkdownDocumentNode, MarkdownNode, MarkdownParagraphNode, MarkdownHeadingNode, MarkdownBlockquoteNode, MarkdownListNode, MarkdownListItemNode, MarkdownCodeBlockNode, MarkdownThematicBreakNode, MarkdownTextNode, MarkdownEmphasisNode, MarkdownStrongNode, MarkdownStrikethroughNode, MarkdownInlineCodeNode, MarkdownLinkNode, MarkdownAutolinkNode, MarkdownImageNode, MarkdownSoftBreakNode, MarkdownHardBreakNode, MarkdownCitationReferenceNode, MarkdownTableNode, MarkdownTableRowNode, MarkdownTableCellNode } from '@cacheplane/partial-markdown';
-import * as _threadplane_chat from '@threadplane/chat';
+import { NavigationExtras } from '@angular/router';
 import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
 
+/** Precise authored function tool — what `action()` returns. Carries the schema
+ *  `S` and the handler's resolved return type `R`. */
+interface FunctionToolDef<S extends StandardSchemaV1 = StandardSchemaV1, R = unknown> {
+    readonly kind: 'function';
+    readonly description: string;
+    readonly schema: S;
+    readonly handler: (args: StandardSchemaInferOutput<S>) => R | Promise<R>;
+}
+/** Bivariant union member used only for registry storage/iteration. The handler
+ *  param is `any` (NOT `never`): `any` is simultaneously a supertype any precise
+ *  `FunctionToolDef<S,R>` is assignable to under `strictFunctionTypes`, AND
+ *  callable by internal code that has narrowed by `kind` and parsed runtime args.
+ *  A `never` param would satisfy the former but break the latter. */
+interface AnyFunctionToolDef {
+    readonly kind: 'function';
+    readonly description: string;
+    readonly schema: StandardSchemaV1;
+    readonly handler: (args: any) => unknown | Promise<unknown>;
+}
+interface ViewToolDef<S extends StandardSchemaV1 = StandardSchemaV1, C = unknown> {
+    readonly kind: 'view';
+    readonly description: string;
+    readonly schema: S;
+    readonly component: Type<C>;
+}
+interface AskToolDef<S extends StandardSchemaV1 = StandardSchemaV1, C = unknown> {
+    readonly kind: 'ask';
+    readonly description: string;
+    readonly schema: S;
+    readonly component: Type<C>;
+}
+/** A client tool the model can call; executed in the browser. */
+type ClientToolDef = AnyFunctionToolDef | ViewToolDef | AskToolDef;
+/** A frozen, name-keyed registry of client tools. */
+type ClientToolRegistry = Readonly<Record<string, ClientToolDef>>;
+
 interface ChatConfig {
     /** Shared render registry for consumers that read CHAT_CONFIG. */
     renderRegistry?: AngularRegistry;
@@ -39,6 +76,46 @@ interface ChatConfig {
     __licensePublicKey?: Uint8Array;
 }
 declare const CHAT_CONFIG: InjectionToken<ChatConfig>;
+/**
+ * Bootstrap `@threadplane/chat` in an Angular application or standalone
+ * component tree.
+ *
+ * Call this once inside `bootstrapApplication` (or the `providers` array of a
+ * root `ApplicationConfig`). It registers the shared {@link ChatConfig} token
+ * so every chat component in the tree can read the render registry, avatar
+ * label, and assistant display name without explicit prop threading.
+ *
+ * A license check is fired asynchronously on every call (it never throws; a
+ * watermark is shown in non-commercial builds when no valid token is supplied).
+ *
+ * @param config Options bag that controls the chat feature set:
+ *   - `renderRegistry` — shared {@link AngularRegistry} wiring tool-view
+ *     components to their names; pass the value returned by
+ *     `defineAngularRegistry` from `\@threadplane/render`.
+ *   - `avatarLabel` — short label shown in the AI avatar bubble (default `"A"`).
+ *   - `assistantName` — display name shown above assistant messages
+ *     (default `"Assistant"`).
+ *   - `license` — signed token from threadplane.ai; omit in development.
+ * @returns An `EnvironmentProviders` value suitable for the `providers` array
+ *   of `bootstrapApplication` or `ApplicationConfig`.
+ * @example
+ * ```ts
+ * // main.ts
+ * import { bootstrapApplication } from '@angular/platform-browser';
+ * import { provideChat } from '@threadplane/chat';
+ * import { defineAngularRegistry, provideRender } from '@threadplane/render';
+ * import { DayCardComponent } from './day-card.component';
+ *
+ * const registry = defineAngularRegistry({ day_card: DayCardComponent });
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideChat({ renderRegistry: registry, avatarLabel: 'AI' }),
+ *     provideRender({ registry }),
+ *   ],
+ * });
+ * ```
+ */
 declare function provideChat(config: ChatConfig): _angular_core.EnvironmentProviders;
 
 type MessageTemplateType = 'human' | 'ai' | 'tool' | 'system' | 'function';
@@ -166,6 +243,12 @@ interface Subagent {
     name?: string;
     status: Signal<SubagentStatus>;
     messages: Signal<Message[]>;
+    /**
+     * The subagent's own tool calls (name/args/result), referenced by
+     * `Message.toolCallIds` in `messages`. Optional: adapters that don't surface
+     * subagent tool calls omit it; consumers default to `[]`.
+     */
+    toolCalls?: Signal<ToolCall[]>;
     state: Signal<Record<string, unknown>>;
 }
 
@@ -210,6 +293,96 @@ interface AgentSubmitOptions {
     signal?: AbortSignal;
 }
 
+/** A client tool spec as shipped to the model / AG-UI RunAgentInput.tools. */
+interface ClientToolSpec {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: Record<string, unknown>;
+}
+/**
+ * Convert a Standard Schema to a JSON Schema for the model's `parameters`.
+ * Uses Zod's converter; throws a clear error for non-Zod validators (callers
+ * should supply a Zod schema — see the client-tools docs).
+ */
+declare function deriveJsonSchema(toolName: string, schema: StandardSchemaV1): Record<string, unknown>;
+
+/** The outcome of running a client tool. */
+type ClientToolResult = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+/**
+ * Optional Agent capability that lets the client declare tools to the model
+ * and return their results. Implemented per-transport by each adapter
+ * (AG-UI: native RunAgentInput.tools + addMessage/re-run; LangGraph: catalog
+ * via run input + ToolMessage re-run).
+ */
+interface ClientToolsCapability {
+    /** Ship the client tool catalog to the model at run start. */
+    setCatalog(specs: readonly ClientToolSpec[]): void;
+    /** Tool calls the model made for client tools that await a client result. */
+    readonly pending: Signal<readonly ToolCall[]>;
+    /** Return a client tool's result (or error) and continue the run. */
+    resolve(toolCallId: string, result: ClientToolResult): void;
+}
+
+/**
+ * The failure class of an {@link AgentError}, used to drive UI and retry logic:
+ *
+ * - `connection` — offline / DNS / connection refused / `fetch` failed. Retryable.
+ * - `auth` — `401` / `403`; credentials or API key are wrong. Not retryable.
+ * - `server` — a `5xx` (retryable) or a non-auth `4xx` like `400`/`404`/`429` (not retryable).
+ * - `interrupted` — the stream closed mid-response after a run had started. Retryable.
+ * - `aborted` — the user pressed stop; treated as a graceful idle, not surfaced as an error.
+ */
+type AgentErrorKind = 'connection' | 'auth' | 'server' | 'interrupted' | 'aborted';
+/**
+ * Structured, classified failure surfaced on `Agent.error`. Extends `Error`, so
+ * existing `.message` / `instanceof Error` reads keep working — but adds a
+ * machine-readable {@link AgentErrorKind}, a `retryable` flag, an optional HTTP
+ * `status`, and the original `cause`.
+ *
+ * You rarely construct one yourself; adapters normalize raw failures via
+ * {@link toAgentError}. Read it off the agent to render legible, cause-specific UI:
+ *
+ * @example
+ * ```ts
+ * const err = agent.error();            // AgentError | undefined
+ * if (err) {
+ *   console.warn(err.message);          // legible, per-kind copy
+ *   if (err.kind === 'auth') showApiKeyHelp();
+ *   if (err.retryable) showRetryButton(); // → agent.retry()
+ * }
+ * ```
+ */
+declare class AgentError extends Error {
+    /** The classified failure type. See {@link AgentErrorKind}. */
+    readonly kind: AgentErrorKind;
+    /** Whether retrying the same request could plausibly succeed:
+     *  `connection` | `server` (5xx) | `interrupted` → true; `auth` | `aborted` | non-auth `4xx` → false. */
+    readonly retryable: boolean;
+    /** The HTTP status code when the failure came from an HTTP response. */
+    readonly status?: number;
+    /** The original raw error this was classified from, preserved for debugging/telemetry. */
+    readonly cause: unknown;
+    constructor(init: {
+        kind: AgentErrorKind;
+        message: string;
+        retryable: boolean;
+        status?: number;
+        cause?: unknown;
+    });
+}
+/**
+ * Default, human-facing copy per {@link AgentErrorKind}. Used as the message when
+ * a classified error has no better text. Override by mapping `error.kind` to your
+ * own strings in a custom error component.
+ */
+declare const AGENT_ERROR_MESSAGES: Record<AgentErrorKind, string>;
+
 /**
  * Runtime-neutral contract chat primitives consume.
  *
@@ -223,15 +396,18 @@ interface AgentSubmitOptions {
  * Invariant: state lives on signals; `events$` carries only things that are
  * not derivable from signals.
  */
-interface Agent {
+interface Agent<TState = Record<string, unknown>> {
     messages: Signal<Message[]>;
     status: Signal<AgentStatus>;
     isLoading: Signal<boolean>;
-    error: Signal<unknown>;
+    error: Signal<AgentError | undefined>;
     toolCalls: Signal<ToolCall[]>;
-    state: Signal<Record<string, unknown>>;
+    state: Signal<TState>;
     submit: (input: AgentSubmitInput, opts?: AgentSubmitOptions) => Promise<void>;
     stop: () => Promise<void>;
+    /** Re-run the last submitted input after a failure. No-op if a run is already
+     *  in flight or there is nothing to retry. Clears `error` and sets loading. */
+    retry: () => Promise<void>;
     /**
      * Discards the assistant message at the given index AND all messages after
      * it, then re-runs the agent against the trimmed conversation tail. The
@@ -244,9 +420,42 @@ interface Agent {
     regenerate: (assistantMessageIndex: number) => Promise<void>;
     interrupt?: Signal<AgentInterrupt | undefined>;
     subagents?: Signal<Map<string, Subagent>>;
+    /** Optional: client-declared, client-executed tools (see ClientToolsCapability). */
+    clientTools?: ClientToolsCapability;
     events$: Observable<AgentEvent>;
 }
 
+/**
+ * Whether `raw` represents an abort (a `DOMException`/`Error` named `AbortError`,
+ * or an abort-ish message). Shared by the runtime adapters and {@link toAgentError}
+ * so a user-requested stop settles to idle instead of surfacing as an error.
+ *
+ * @param raw Any thrown/rejected value.
+ * @returns `true` if it looks like an abort.
+ */
+declare function isAbortError(raw: unknown): boolean;
+/**
+ * Classify any raw error into a structured {@link AgentError}.
+ *
+ * Resolution order (first match wins): an existing `AgentError` is returned
+ * unchanged (idempotent) → a user abort → a structured `status`/`cause.status`
+ * → network/connection markers → an HTTP-shaped status in the message → a
+ * `server` + retryable fallback. The original error is always preserved on
+ * `cause`. Runtime adapters call this before setting `Agent.error`; custom
+ * backends can call it too (or throw an `AgentError` directly).
+ *
+ * @param raw Any thrown/rejected value — an `Error`, a `{ status }` object, a string, etc.
+ * @returns The classified {@link AgentError} (kind, retryable, status?, cause).
+ * @example
+ * ```ts
+ * const e = toAgentError(new Error('HTTP 500: Internal Server Error'));
+ * e.kind;      // 'server'
+ * e.retryable; // true
+ * e.status;    // 500
+ * ```
+ */
+declare function toAgentError(raw: unknown): AgentError;
+
 /**
  * Runtime-neutral snapshot of a point in an agent's execution history.
  *
@@ -270,7 +479,7 @@ interface AgentCheckpoint {
  * implement this. Pure request/response runtimes that don't have checkpoints
  * should implement plain Agent.
  */
-interface AgentWithHistory extends Agent {
+interface AgentWithHistory<TState = Record<string, unknown>> extends Agent<TState> {
     history: Signal<AgentCheckpoint[]>;
     /**
      * Optional reactive map of `messageId → checkpointId`, computed by
@@ -282,6 +491,27 @@ interface AgentWithHistory extends Agent {
     messageCheckpoints?: Signal<ReadonlyMap<string, string>>;
 }
 
+/** A typed handle that threads a state shape through Angular DI from
+ *  `provideAgent(ref, …)` to `injectAgent(ref)` without per-call-site
+ *  restatement of the generic. */
+interface AgentRef<TState> {
+    readonly token: InjectionToken<Agent<TState>>;
+}
+/**
+ * Create a typed agent handle.
+ *
+ * @param debugName Optional name shown in Angular DI error messages.
+ * @returns An {@link AgentRef} carrying a state-typed `InjectionToken`.
+ * @example
+ * ```ts
+ * interface TripState { day: number; places: string[]; }
+ * export const TRIP = createAgentRef<TripState>('trip');
+ * // app.config.ts: provideAgent(TRIP, { assistantId: 'trip' })
+ * // component:     const agent = injectAgent(TRIP); // LangGraphAgent<TripState>
+ * ```
+ */
+declare function createAgentRef<TState>(debugName?: string): AgentRef<TState>;
+
 type AgentRuntimeTelemetryEvent = 'ngaf:runtime_instance_created' | 'ngaf:runtime_request_created' | 'ngaf:stream_started' | 'ngaf:stream_ended' | 'ngaf:stream_errored';
 interface AgentRuntimeTelemetryProperties {
     transport: 'langgraph' | 'ag-ui' | 'custom' | string;
@@ -311,7 +541,7 @@ declare class MessageTemplateDirective {
  */
 declare function getMessageType(message: Message): MessageTemplateType;
 declare class ChatMessageListComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly messageTemplates: _angular_core.Signal<readonly MessageTemplateDirective[]>;
     readonly messages: _angular_core.Signal<Message[]>;
     readonly getMessageType: typeof getMessageType;
@@ -446,7 +676,7 @@ declare class ChatSuggestionsComponent {
  */
 declare function submitMessage(agent: Agent, text: string): string | null;
 declare class ChatInputComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly submitOnEnter: _angular_core.InputSignal<boolean>;
     readonly placeholder: _angular_core.InputSignal<string>;
     /** When true (default), shows a stop button while the agent is streaming. */
@@ -472,6 +702,11 @@ declare class ChatInputComponent {
     constructor();
     focusTextarea(): void;
     onSubmit(): void;
+    /** Sync the textarea's value into the signal on user input. A direct
+     *  [value]/(input) pair is used instead of ngModel: NgModel does not
+     *  reliably write a programmatic clear back to the view under zoneless
+     *  + OnPush, leaving sent text visible in the composer (audit F1). */
+    protected onInput(event: Event): void;
     /** Abort the current streaming response (if the adapter supports it). */
     onStop(): void;
     onKeydown(event: KeyboardEvent): void;
@@ -481,7 +716,7 @@ declare class ChatInputComponent {
 
 declare function isTyping(agent: Agent): boolean;
 declare class ChatTypingIndicatorComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly visible: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatTypingIndicatorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatTypingIndicatorComponent, "chat-typing-indicator", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -577,15 +812,14 @@ declare class ChatScrollBubbleComponent {
 
 declare function extractErrorMessage(error: unknown): string | null;
 declare class ChatErrorComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
-    readonly errorMessage: _angular_core.Signal<string | null>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatErrorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatErrorComponent, "chat-error", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare function getInterrupt(agent: Agent): AgentInterrupt | undefined;
 declare class ChatInterruptComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
     readonly interrupt: _angular_core.Signal<AgentInterrupt | undefined>;
     defaultText(i: AgentInterrupt): string;
@@ -654,7 +888,7 @@ interface Group {
     templateRef?: ChatToolCallTemplateDirective;
 }
 declare class ChatToolCallsComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly message: _angular_core.InputSignal<Message | undefined>;
     readonly grouping: _angular_core.InputSignal<"auto" | "none">;
     readonly groupSummary: _angular_core.InputSignal<((name: string, count: number) => string) | undefined>;
@@ -693,7 +927,8 @@ declare class ChatToolCallsComponent {
  * (and a `status` a component chooses not to declare) are harmless.
  */
 declare class ChatToolViewsComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly events: _angular_core.OutputEmitterRef<RenderEvent>;
     readonly message: _angular_core.InputSignal<Message | undefined>;
     readonly views: _angular_core.InputSignal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>> | undefined>;
     readonly store: _angular_core.InputSignal<StateStore | undefined>;
@@ -705,11 +940,11 @@ declare class ChatToolViewsComponent {
         spec: Spec;
     }[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatToolViewsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatToolViewsComponent, "chat-tool-views", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "store": { "alias": "store"; "required": false; "isSignal": true; }; "handlers": { "alias": "handlers"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatToolViewsComponent, "chat-tool-views", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "store": { "alias": "store"; "required": false; "isSignal": true; }; "handlers": { "alias": "handlers"; "required": false; "isSignal": true; }; }, { "events": "events"; }, never, never, true, never>;
 }
 
 declare class ChatSubagentsComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
     readonly activeSubagents: _angular_core.Signal<Subagent[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatSubagentsComponent, never>;
@@ -915,7 +1150,7 @@ declare class ChatGenuiSkeletonComponent {
 }
 
 declare class ChatTimelineComponent {
-    readonly agent: _angular_core.InputSignal<AgentWithHistory>;
+    readonly agent: _angular_core.InputSignal<AgentWithHistory<Record<string, unknown>>>;
     readonly checkpointSelected: _angular_core.OutputEmitterRef<AgentCheckpoint>;
     readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
     readonly history: _angular_core.Signal<AgentCheckpoint[]>;
@@ -931,6 +1166,17 @@ declare class ChatGenerativeUiComponent {
     readonly handlers: _angular_core.InputSignal<Record<string, (params: Record<string, unknown>) => unknown | Promise<unknown>> | undefined>;
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly events: _angular_core.OutputEmitterRef<RenderEvent>;
+    /** The bound spec with schema-documented `{ statePath }` prop refs
+     * rewritten to engine-native `{ $bindState }` + `_bindings` so values
+     * resolve against the state store instead of interpolating as
+     * "[object Object]" (F4). */
+    protected readonly normalizedSpec: _angular_core.Signal<Spec | null>;
+    /** Last value this component seeded per state path. Lets the seeding
+     * effect distinguish "still the value we wrote (possibly a partial
+     * chunk from streaming — safe to overwrite with the newer one)" from
+     * "user edited it via a bound control — leave it alone". */
+    private readonly seeded;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatGenerativeUiComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatGenerativeUiComponent, "chat-generative-ui", never, { "spec": { "alias": "spec"; "required": false; "isSignal": true; }; "registry": { "alias": "registry"; "required": false; "isSignal": true; }; "store": { "alias": "store"; "required": false; "isSignal": true; }; "handlers": { "alias": "handlers"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, { "events": "events"; }, never, never, true, never>;
 }
@@ -958,14 +1204,17 @@ declare class ChatWelcomeComponent {
 declare class ChatWelcomeSuggestionComponent {
     readonly label: _angular_core.InputSignal<string>;
     readonly value: _angular_core.InputSignal<string>;
+    /** Optional short description, surfaced as a hover/focus tooltip on the chip. */
+    readonly description: _angular_core.InputSignal<string | undefined>;
     readonly selected: _angular_core.OutputEmitterRef<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatWelcomeSuggestionComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatWelcomeSuggestionComponent, "chat-welcome-suggestion", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; }, { "selected": "selected"; }, never, ["[chatWelcomeSuggestionIcon]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatWelcomeSuggestionComponent, "chat-welcome-suggestion", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; }, { "selected": "selected"; }, never, ["[chatWelcomeSuggestionIcon]"], true, never>;
 }
 
 interface ChatSelectOption {
     value: string;
     label: string;
+    description?: string;
     disabled?: boolean;
 }
 /**
@@ -1046,6 +1295,35 @@ declare class ChatCitationsCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatCitationsCardComponent, "chat-citations-card", never, { "citation": { "alias": "citation"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+interface ThreadRoutingConfig {
+    /** The app-owned source-of-truth signal for the active thread id. */
+    threadId: WritableSignal<string | null>;
+    /** Router commands for a thread id (or the bare/welcome path when null).
+     *  Default: `(id) => (id ? ['/', id] : ['/'])`. */
+    toCommands?: (id: string | null) => unknown[];
+    /** Extract the thread id from a URL (null = bare). Default: last non-empty path segment. */
+    threadIdFromUrl?: (url: string) => string | null;
+    /** Optional async validity check; on `false` the helper redirects to the bare path
+     *  (`replaceUrl: true`). LangGraph apps pass `id => threads.getThread(id).then(Boolean)`. */
+    validate?: (id: string) => Promise<boolean>;
+    /** Extras merged into every navigate (default `{ queryParamsHandling: 'preserve' }`). */
+    navigationExtras?: NavigationExtras;
+}
+/**
+ * Bind an app-owned `activeThreadId` signal to the URL — restore on load, stamp on change,
+ * validate-or-redirect, with a bare URL meaning "no thread" (welcome). URL is the source of
+ * truth; nothing is written to localStorage. Must be called in an injection context.
+ *
+ * @example
+ * ```ts
+ * export const ACTIVE_THREAD = signal<string | null>(null);
+ * // providers: provideAgent({ threadId: ACTIVE_THREAD, onThreadId: id => ACTIVE_THREAD.set(id) })
+ * const threads = inject(LangGraphThreadsAdapter);
+ * injectThreadRouting({ threadId: ACTIVE_THREAD, validate: id => threads.getThread(id).then(Boolean) });
+ * ```
+ */
+declare function injectThreadRouting(config: ThreadRoutingConfig): void;
+
 interface ChatLifecycle {
     /** True after `<chat>` initializes with a non-null agent binding. */
     readonly componentReady: Signal<boolean>;
@@ -1159,8 +1437,16 @@ interface ChatRenderEvent {
 }
 
 declare class ChatComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly views: _angular_core.InputSignal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>> | undefined>;
+    /**
+     * Client-declared tools (`view`/`ask`/`function`) the model may call. When
+     * provided, a coordinator ships their catalog to the agent, runs `function`
+     * tools in the browser, and renders/resolves `view`/`ask` tools through the
+     * same tool-views pipeline as `views`. Additive — leave undefined for the
+     * classic server-tools-only experience.
+     */
+    readonly clientTools: _angular_core.InputSignal<Readonly<Record<string, _threadplane_chat.ClientToolDef>> | undefined>;
     readonly store: _angular_core.InputSignal<StateStore | undefined>;
     readonly handlers: _angular_core.InputSignal<Record<string, (params: Record<string, unknown>) => unknown | Promise<unknown>>>;
     readonly threads: _angular_core.InputSignal<Thread[]>;
@@ -1209,10 +1495,26 @@ declare class ChatComponent {
     }>;
     private readonly _internalStore;
     readonly resolvedStore: _angular_core.Signal<StateStore | undefined>;
+    /**
+     * Lazily-built client-tools coordinator, memoized on the `clientTools`
+     * registry input. Undefined when no client tools are declared. The
+     * coordinator owns the catalog/executor wiring and the view/ask render
+     * registry; the composition merges and connects it below.
+     */
+    private readonly coordinator;
+    /**
+     * The view registry actually used for rendering tool-views and for
+     * excluding view-backed tool names from default tool-call cards. Merges
+     * the coordinator's `view`/`ask` components (keyed by tool name) into the
+     * user-supplied `views()` so client-declared component tools render through
+     * the same pipeline. Falls back to `views()` when no client tools exist.
+     */
+    protected readonly effectiveViews: _angular_core.Signal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>> | undefined>;
     readonly renderRegistry: _angular_core.Signal<_threadplane_render.AngularRegistry | undefined>;
-    /** Tool names that have a registered view (keys of the `views` registry).
-     *  These render as inline tool-views and are excluded from the default
-     *  tool-call card so they don't render twice. */
+    /** Tool names that have a registered view (keys of the effective view
+     *  registry, including client-declared view/ask tools). These render as
+     *  inline tool-views and are excluded from the default tool-call card so
+     *  they don't render twice. */
     readonly viewToolNames: _angular_core.Signal<readonly string[]>;
     /** Union of GenUI dispatcher tool names and registered view tool names. */
     readonly excludedToolNames: _angular_core.Signal<readonly string[]>;
@@ -1242,6 +1544,7 @@ declare class ChatComponent {
     protected isReasoningStreaming(message: Message, index: number): boolean;
     private readonly classifiers;
     private readonly destroyRef;
+    private readonly injector;
     private readonly lifecycle;
     private eventsSubscribed;
     /**
@@ -1323,6 +1626,13 @@ declare class ChatComponent {
     }): ContentClassifier;
     clearClassifiers(): void;
     onSpecEvent(event: RenderEvent, messageIndex: number): void;
+    /**
+     * Forwards a render event bubbled up from a `<chat-tool-views>` component
+     * (a client-declared `view`/`ask` tool's rendered UI) to the client-tools
+     * coordinator. The coordinator resolves the matching pending `ask` tool call
+     * when the event is a `result`. No-op when no client tools are wired.
+     */
+    protected onClientToolEvent(event: RenderEvent): void;
     onA2uiAction(message: A2uiActionMessage): void;
     onA2uiEvent(event: RenderEvent, messageIndex: number, surfaceId: string): void;
     /** Regenerate the assistant response at the given message index. */
@@ -1330,15 +1640,17 @@ declare class ChatComponent {
     onRate(message: unknown, value: 'up' | 'down'): void;
     onCopy(message: unknown, content: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatComponent, "chat", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "store": { "alias": "store"; "required": false; "isSignal": true; }; "handlers": { "alias": "handlers"; "required": false; "isSignal": true; }; "threads": { "alias": "threads"; "required": false; "isSignal": true; }; "activeThreadId": { "alias": "activeThreadId"; "required": false; "isSignal": true; }; "welcomeDisabled": { "alias": "welcomeDisabled"; "required": false; "isSignal": true; }; "modelOptions": { "alias": "modelOptions"; "required": false; "isSignal": true; }; "showModelPicker": { "alias": "showModelPicker"; "required": false; "isSignal": true; }; "selectedModel": { "alias": "selectedModel"; "required": false; "isSignal": true; }; "modelPickerPlaceholder": { "alias": "modelPickerPlaceholder"; "required": false; "isSignal": true; }; "genuiToolNames": { "alias": "genuiToolNames"; "required": false; "isSignal": true; }; }, { "selectedModel": "selectedModelChange"; "threadSelected": "threadSelected"; "renderEvent": "renderEvent"; "regenerate": "regenerate"; "rate": "rate"; "messageCopy": "messageCopy"; }, never, ["[chatWelcomeSuggestions]", "[chatHeader]", "[chatToolCallTemplate]", "[chatInputModelSelect]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatComponent, "chat", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "clientTools": { "alias": "clientTools"; "required": false; "isSignal": true; }; "store": { "alias": "store"; "required": false; "isSignal": true; }; "handlers": { "alias": "handlers"; "required": false; "isSignal": true; }; "threads": { "alias": "threads"; "required": false; "isSignal": true; }; "activeThreadId": { "alias": "activeThreadId"; "required": false; "isSignal": true; }; "welcomeDisabled": { "alias": "welcomeDisabled"; "required": false; "isSignal": true; }; "modelOptions": { "alias": "modelOptions"; "required": false; "isSignal": true; }; "showModelPicker": { "alias": "showModelPicker"; "required": false; "isSignal": true; }; "selectedModel": { "alias": "selectedModel"; "required": false; "isSignal": true; }; "modelPickerPlaceholder": { "alias": "modelPickerPlaceholder"; "required": false; "isSignal": true; }; "genuiToolNames": { "alias": "genuiToolNames"; "required": false; "isSignal": true; }; }, { "selectedModel": "selectedModelChange"; "threadSelected": "threadSelected"; "renderEvent": "renderEvent"; "regenerate": "regenerate"; "rate": "rate"; "messageCopy": "messageCopy"; }, never, ["[chatWelcomeSuggestions]", "[chatHeader]", "[chatToolCallTemplate]", "[chatInputModelSelect]"], true, never>;
 }
 
 declare class ChatPopupComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     /** A2UI component catalog forwarded to the inner <chat>. Without it,
      * messages classified as A2UI parse correctly but never mount a
      * surface. Pass `a2uiBasicCatalog()` from `@threadplane/chat`. */
     readonly views: _angular_core.InputSignal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>> | undefined>;
+    /** Frontend-declared client tools forwarded to the inner `<chat>`. */
+    readonly clientTools: _angular_core.InputSignal<Readonly<Record<string, _threadplane_chat.ClientToolDef>> | undefined>;
     /** Forwarded to the inner <chat>. When non-empty, a model picker pill
      * renders in the chat-input chrome. */
     readonly modelOptions: _angular_core.InputSignal<readonly ChatSelectOption[]>;
@@ -1368,15 +1680,17 @@ declare class ChatPopupComponent {
     openWindow(): void;
     closeWindow(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatPopupComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatPopupComponent, "chat-popup", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "modelOptions": { "alias": "modelOptions"; "required": false; "isSignal": true; }; "showModelPicker": { "alias": "showModelPicker"; "required": false; "isSignal": true; }; "selectedModel": { "alias": "selectedModel"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; }, { "selectedModel": "selectedModelChange"; "open": "openChange"; }, never, ["[chatHeader]", "[chatWelcomeSuggestions]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatPopupComponent, "chat-popup", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "clientTools": { "alias": "clientTools"; "required": false; "isSignal": true; }; "modelOptions": { "alias": "modelOptions"; "required": false; "isSignal": true; }; "showModelPicker": { "alias": "showModelPicker"; "required": false; "isSignal": true; }; "selectedModel": { "alias": "selectedModel"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; }, { "selectedModel": "selectedModelChange"; "open": "openChange"; }, never, ["[chatHeader]", "[chatWelcomeSuggestions]"], true, never>;
 }
 
 declare class ChatSidebarComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     /** A2UI component catalog forwarded to the inner <chat>. Without it,
      * messages classified as A2UI parse correctly but never mount a
      * surface. Pass `a2uiBasicCatalog()` from `@threadplane/chat`. */
     readonly views: _angular_core.InputSignal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>> | undefined>;
+    /** Frontend-declared client tools forwarded to the inner `<chat>`. */
+    readonly clientTools: _angular_core.InputSignal<Readonly<Record<string, _threadplane_chat.ClientToolDef>> | undefined>;
     /** Forwarded to the inner <chat>. When non-empty, a model picker pill
      * renders in the chat-input chrome. */
     readonly modelOptions: _angular_core.InputSignal<readonly ChatSelectOption[]>;
@@ -1400,11 +1714,11 @@ declare class ChatSidebarComponent {
     openWindow(): void;
     closeWindow(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatSidebarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatSidebarComponent, "chat-sidebar", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "modelOptions": { "alias": "modelOptions"; "required": false; "isSignal": true; }; "showModelPicker": { "alias": "showModelPicker"; "required": false; "isSignal": true; }; "selectedModel": { "alias": "selectedModel"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "pushContent": { "alias": "pushContent"; "required": false; "isSignal": true; }; }, { "selectedModel": "selectedModelChange"; "open": "openChange"; }, never, ["*", "[chatSidebarPanelTitle]", "[chatHeader]", "[chatWelcomeSuggestions]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatSidebarComponent, "chat-sidebar", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "clientTools": { "alias": "clientTools"; "required": false; "isSignal": true; }; "modelOptions": { "alias": "modelOptions"; "required": false; "isSignal": true; }; "showModelPicker": { "alias": "showModelPicker"; "required": false; "isSignal": true; }; "selectedModel": { "alias": "selectedModel"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "pushContent": { "alias": "pushContent"; "required": false; "isSignal": true; }; }, { "selectedModel": "selectedModelChange"; "open": "openChange"; }, never, ["*", "[chatSidebarPanelTitle]", "[chatHeader]", "[chatWelcomeSuggestions]"], true, never>;
 }
 
 declare class ChatTimelineSliderComponent {
-    readonly agent: _angular_core.InputSignal<AgentWithHistory>;
+    readonly agent: _angular_core.InputSignal<AgentWithHistory<Record<string, unknown>>>;
     readonly selectedIndex: _angular_core.WritableSignal<number>;
     readonly history: _angular_core.Signal<AgentCheckpoint[]>;
     readonly replayRequested: _angular_core.OutputEmitterRef<string>;
@@ -1426,7 +1740,7 @@ declare class ChatSidenavComponent {
     readonly projects: _angular_core.InputSignal<Project[] | null>;
     readonly selectedProjectId: _angular_core.InputSignal<string | null>;
     readonly projectActions: _angular_core.InputSignal<ProjectActionAdapter | null>;
-    readonly agent: _angular_core.InputSignal<Agent | AgentWithHistory | null>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>> | AgentWithHistory<Record<string, unknown>> | null>;
     readonly debug: _angular_core.InputSignal<boolean>;
     readonly newChat: _angular_core.OutputEmitterRef<void>;
     readonly threadSelected: _angular_core.OutputEmitterRef<string>;
@@ -1477,7 +1791,7 @@ declare class ChatSidenavScrimComponent {
 
 type InterruptAction = 'accept' | 'edit' | 'respond' | 'ignore';
 declare class ChatInterruptPanelComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly action: _angular_core.OutputEmitterRef<InterruptAction>;
     readonly interrupt: _angular_core.Signal<AgentInterrupt | undefined>;
     readonly interruptReason: _angular_core.Signal<string>;
@@ -1487,7 +1801,7 @@ declare class ChatInterruptPanelComponent {
 
 type ChatApprovalAction = 'approve' | 'edit' | 'cancel';
 declare class ChatApprovalCardComponent {
-    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
     readonly matchKind: _angular_core.InputSignal<string | undefined>;
     readonly title: _angular_core.InputSignal<string>;
     readonly showEdit: _angular_core.InputSignal<boolean>;
@@ -1517,7 +1831,9 @@ declare function statusColor(status: SubagentStatus): string;
 declare class ChatSubagentCardComponent {
     readonly subagent: _angular_core.InputSignal<Subagent>;
     readonly state: _angular_core.Signal<TraceState>;
-    readonly latestMessageContent: _angular_core.Signal<string>;
+    protected textOf(m: Message): string;
+    protected toolCallsFor(m: Message): ToolCall[];
+    protected toToolCallInfo(tc: ToolCall): ToolCallInfo;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatSubagentCardComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatSubagentCardComponent, "chat-subagent-card", never, { "subagent": { "alias": "subagent"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -1583,9 +1899,9 @@ declare const MARKDOWN_VIEW_REGISTRY: InjectionToken<Readonly<Record<string, _an
  * registry. Each child's `type` is looked up in the registry; the resolved
  * component is rendered with `[node]` bound to that child.
  *
- * Identity-preserving: `track $any(child)` keys on the JS reference of the
- * child node. Because @cacheplane/partial-markdown preserves node identity
- * across pushes, unchanged subtrees never re-render.
+ * Position-stable: `track $index` avoids NG0956 re-creation warnings that
+ * occur when the markdown pipeline re-parses content on every stream delta,
+ * producing new child object references even for unchanged nodes.
  */
 declare class MarkdownChildrenComponent {
     readonly parent: _angular_core.InputSignal<MarkdownNode>;
@@ -1916,14 +2232,15 @@ declare function buildA2uiActionMessage(params: Record<string, unknown>, surface
 
 declare function a2uiBasicCatalog(): ViewRegistry;
 
-/** Emits a data model binding event if the prop has a binding path. */
-declare function emitBinding(emit: (event: string) => void, bindings: Record<string, string> | undefined, prop: string, value: unknown): void;
+/** Writes a typed value to the render state store if the prop has a binding path. */
+declare function emitBinding(host: RenderHost, bindings: Record<string, string> | undefined, prop: string, value: unknown): void;
 
 /** v1 textFieldType values from A2uiTextField. */
 type TextFieldType = 'date' | 'longText' | 'number' | 'shortText' | 'obscured';
 declare class A2uiTextFieldComponent {
     private static _idCounter;
     protected readonly _inputId: string;
+    private readonly host;
     readonly label: _angular_core.InputSignal<string>;
     /** v1 prop: text (resolved string value). */
     readonly text: _angular_core.InputSignal<string>;
@@ -1933,7 +2250,6 @@ declare class A2uiTextFieldComponent {
     readonly textFieldType: _angular_core.InputSignal<TextFieldType>;
     readonly validationRegexp: _angular_core.InputSignal<string>;
     readonly _bindings: _angular_core.InputSignal<Record<string, string>>;
-    readonly emit: _angular_core.InputSignal<(event: string) => void>;
     readonly bindings: _angular_core.InputSignal<Record<string, string>>;
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly childKeys: _angular_core.InputSignal<string[]>;
@@ -1941,17 +2257,17 @@ declare class A2uiTextFieldComponent {
     protected readonly htmlInputType: _angular_core.Signal<string>;
     onInput(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<A2uiTextFieldComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiTextFieldComponent, "a2ui-text-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "textFieldType": { "alias": "textFieldType"; "required": false; "isSignal": true; }; "validationRegexp": { "alias": "validationRegexp"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "emit": { "alias": "emit"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiTextFieldComponent, "a2ui-text-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "textFieldType": { "alias": "textFieldType"; "required": false; "isSignal": true; }; "validationRegexp": { "alias": "validationRegexp"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class A2uiCheckBoxComponent {
+    private readonly host;
     readonly label: _angular_core.InputSignal<string>;
     /** v1 canonical prop: boolean checked state. */
     readonly value: _angular_core.InputSignal<boolean | undefined>;
     /** Pre-v1 alias retained for back-compat. */
     readonly checked: _angular_core.InputSignal<boolean>;
     readonly _bindings: _angular_core.InputSignal<Record<string, string>>;
-    readonly emit: _angular_core.InputSignal<(event: string) => void>;
     readonly bindings: _angular_core.InputSignal<Record<string, string>>;
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly childKeys: _angular_core.InputSignal<string[]>;
@@ -1959,7 +2275,7 @@ declare class A2uiCheckBoxComponent {
     protected readonly effectiveValue: _angular_core.Signal<boolean>;
     onChange(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<A2uiCheckBoxComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiCheckBoxComponent, "a2ui-check-box", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "emit": { "alias": "emit"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiCheckBoxComponent, "a2ui-check-box", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class A2uiButtonComponent {
@@ -1982,6 +2298,7 @@ interface ResolvedOption {
     value: string;
 }
 declare class A2uiMultipleChoiceComponent {
+    private readonly host;
     readonly label: _angular_core.InputSignal<string>;
     /** Resolved current selections from surface-to-spec. Normalized in
      * `selectionsArray` because LLMs sometimes seed the data model with a
@@ -1994,7 +2311,6 @@ declare class A2uiMultipleChoiceComponent {
     /** When ≤ 1 — render as single-select <select>; otherwise multi-select checkboxes. */
     readonly maxAllowedSelections: _angular_core.InputSignal<number>;
     readonly _bindings: _angular_core.InputSignal<Record<string, string>>;
-    readonly emit: _angular_core.InputSignal<(event: string) => void>;
     readonly bindings: _angular_core.InputSignal<Record<string, string>>;
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly childKeys: _angular_core.InputSignal<string[]>;
@@ -2004,12 +2320,13 @@ declare class A2uiMultipleChoiceComponent {
     onSelectChange(event: Event): void;
     onCheckChange(value: string, event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<A2uiMultipleChoiceComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiMultipleChoiceComponent, "a2ui-multiple-choice", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "selections": { "alias": "selections"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "maxAllowedSelections": { "alias": "maxAllowedSelections"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "emit": { "alias": "emit"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiMultipleChoiceComponent, "a2ui-multiple-choice", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "selections": { "alias": "selections"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "maxAllowedSelections": { "alias": "maxAllowedSelections"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class A2uiSliderComponent {
     private static _idCounter;
     protected readonly _inputId: string;
+    private readonly host;
     readonly label: _angular_core.InputSignal<string>;
     /** v1 prop: value (resolved DynamicNumber). */
     readonly value: _angular_core.InputSignal<number>;
@@ -2019,19 +2336,19 @@ declare class A2uiSliderComponent {
     readonly maxValue: _angular_core.InputSignal<number>;
     readonly step: _angular_core.InputSignal<number>;
     readonly _bindings: _angular_core.InputSignal<Record<string, string>>;
-    readonly emit: _angular_core.InputSignal<(event: string) => void>;
     readonly bindings: _angular_core.InputSignal<Record<string, string>>;
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly childKeys: _angular_core.InputSignal<string[]>;
     readonly spec: _angular_core.InputSignal<Spec | undefined>;
     onInput(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<A2uiSliderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiSliderComponent, "a2ui-slider", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "emit": { "alias": "emit"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiSliderComponent, "a2ui-slider", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class A2uiDateTimeInputComponent {
     private static _idCounter;
     protected readonly _inputId: string;
+    private readonly host;
     readonly label: _angular_core.InputSignal<string>;
     /** v1 prop: value (resolved DynamicString). */
     readonly value: _angular_core.InputSignal<string>;
@@ -2040,7 +2357,6 @@ declare class A2uiDateTimeInputComponent {
     /** v1 prop: enableTime — include time portion. */
     readonly enableTime: _angular_core.InputSignal<boolean>;
     readonly _bindings: _angular_core.InputSignal<Record<string, string>>;
-    readonly emit: _angular_core.InputSignal<(event: string) => void>;
     readonly bindings: _angular_core.InputSignal<Record<string, string>>;
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly childKeys: _angular_core.InputSignal<string[]>;
@@ -2049,7 +2365,7 @@ declare class A2uiDateTimeInputComponent {
     protected readonly htmlInputType: _angular_core.Signal<string>;
     onChange(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<A2uiDateTimeInputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiDateTimeInputComponent, "a2ui-date-time-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "enableDate": { "alias": "enableDate"; "required": false; "isSignal": true; }; "enableTime": { "alias": "enableTime"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "emit": { "alias": "emit"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiDateTimeInputComponent, "a2ui-date-time-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "enableDate": { "alias": "enableDate"; "required": false; "isSignal": true; }; "enableTime": { "alias": "enableTime"; "required": false; "isSignal": true; }; "_bindings": { "alias": "_bindings"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type UsageHint = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'caption' | 'body';
@@ -2257,11 +2573,203 @@ declare class A2uiVideoComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiVideoComponent, "a2ui-video", never, { "url": { "alias": "url"; "required": false; "isSignal": true; }; "autoPlay": { "alias": "autoPlay"; "required": false; "isSignal": true; }; "controls": { "alias": "controls"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "emit": { "alias": "emit"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * @internal
+ * Identity mapped type that flattens an object type so editor quick-info shows
+ * the expanded shape instead of a raw conditional/mapped-type expression.
+ */
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
+/** Value type carried by an Angular signal input. */
+type InputValue<P> = P extends InputSignal<infer T> ? T : P extends InputSignalWithTransform<infer T, infer _U> ? T : never;
+/** A component instance's declared signal inputs, as a plain prop bag.
+ *
+ *  Implementation note: Angular's `InputSignal` and `InputSignalWithTransform`
+ *  use `InputSignalNode` in an invariant position, making them invariant in their
+ *  type parameters under TypeScript's structural system. `InputSignal<number>`
+ *  does NOT extend `InputSignal<unknown>`. We therefore use `any` in the filter
+ *  predicate — `any` is a two-way assignability wildcard that correctly subsumes
+ *  all concrete instantiations without widening the extracted value type. */
+type ComponentInputs<C> = {
+    [K in keyof C as C[K] extends InputSignal<any> | InputSignalWithTransform<any, any> ? K : never]: InputValue<C[K]>;
+};
+/** STRICT: every prop the schema PRODUCES must be a declared input with an
+ *  assignable type. FLEXIBLE: the component may declare extra inputs the schema
+ *  doesn't fill. A schema key absent from `Inputs` maps to `never`, so its
+ *  (non-never) value fails assignment and the error pins to that prop.
+ *
+ *  This mapped type is homomorphic over `keyof Out`, so it preserves the
+ *  optionality (`?`) of each schema prop. A consequence: an OPTIONAL schema prop
+ *  is accepted against a `required` component input — the compiler cannot know
+ *  the model will actually supply it. That residual case (required input not
+ *  guaranteed by the schema) is caught at runtime by the schema-readiness mount
+ *  gate, which holds the fallback until the streamed props validate. Compile
+ *  time blocks structural mismatches; runtime blocks missing-but-required props. */
+type CompatibleProps<Out, Inputs> = {
+    [K in keyof Out]: K extends keyof Inputs ? Inputs[K] : never;
+};
+/** The accepted `component` parameter type for `view`/`ask`: the real component
+ *  `Type<C>` when the schema output is compatible, else a labelled error tuple
+ *  that surfaces both shapes in the compiler message.
+ *
+ *  Implementation note: `C extends ...` (distributive over C) lets TypeScript
+ *  infer `C` from the `Type<C>` arm first, then verify the constraint. A bare
+ *  conditional on the param type blocks inference when C appears only on the
+ *  right-hand side of the inner `extends`. */
+type AcceptComponent<S extends StandardSchemaV1, C> = C extends (StandardSchemaInferOutput<S> extends CompatibleProps<StandardSchemaInferOutput<S>, ComponentInputs<C>> ? C : never) ? Type<C> : readonly [
+    'Schema output is not assignable to this component\'s inputs',
+    StandardSchemaInferOutput<S>,
+    ComponentInputs<C>
+];
+/** Reverse helper: derive a component's input prop types FROM a schema, so a
+ *  component authored straight from the schema is guaranteed compatible. */
+type ViewProps<S extends StandardSchemaV1> = Prettify<StandardSchemaInferOutput<S>>;
+
+/**
+ * Declare an async function tool the model can call; its resolved return value
+ * becomes the tool result shipped back to the model.
+ *
+ * @param description Natural-language description the model sees.
+ * @param schema Standard Schema (e.g. a Zod object) for the arguments; the
+ *   handler's argument type is inferred from it.
+ * @param handler Runs in the browser when the model calls the tool; its return
+ *   type `R` is carried on the resulting {@link FunctionToolDef}.
+ * @returns A {@link FunctionToolDef} for inclusion in {@link tools}.
+ * @example
+ * ```ts
+ * const move = action('Move a stop', z.object({ fromDay: z.number() }), (a) => a.fromDay);
+ * const registry = tools({ move_stop: move });
+ * ```
+ */
+declare function action<S extends StandardSchemaV1, R>(description: string, schema: S, handler: (args: StandardSchemaInferOutput<S>) => R | Promise<R>): FunctionToolDef<S, R>;
+/**
+ * Render-only component tool — the model fills the component's props from the
+ * schema's output; the tool call is auto-acknowledged once the component mounts.
+ *
+ * The component's signal inputs are checked against the schema output type
+ * (strict-but-flexible: every schema key must be a declared input with an
+ * assignable type; the component may declare extra inputs the schema doesn't fill).
+ * Author the component with `ViewProps<typeof schema>` as the input type set to
+ * guarantee the shapes stay aligned.
+ *
+ * @param description Natural-language description the model sees.
+ * @param schema Standard Schema defining the props the model must supply.
+ * @param component Angular component whose signal inputs must be compatible with
+ *   the schema output. A type-level error is reported here when they diverge.
+ * @returns A {@link ViewToolDef} for inclusion in {@link tools}.
+ * @example
+ * ```ts
+ * const schema = z.object({ label: z.string(), day: z.number() });
+ * type Inputs = ViewProps<typeof schema>; // { label: string; day: number }
+ *
+ * \@Component({ ... })
+ * class DayCardComponent {
+ *   label = input.required<string>();
+ *   day   = input.required<number>();
+ * }
+ *
+ * const dayCard = view('Show a day card', schema, DayCardComponent);
+ * const registry = tools({ day_card: dayCard });
+ * ```
+ */
+declare function view<S extends StandardSchemaV1, C>(description: string, schema: S, component: AcceptComponent<S, C>): ViewToolDef<S, C>;
+/**
+ * Interactive (human-in-the-loop) component tool — the model fills the
+ * component's props from the schema's output; the value the component emits
+ * back to the framework becomes the tool result sent to the model.
+ *
+ * The component's signal inputs are checked against the schema output type
+ * (strict-but-flexible: every schema key must be a declared input with an
+ * assignable type; the component may declare extra inputs the schema doesn't
+ * fill). Author the component with `ViewProps<typeof schema>` to derive input
+ * prop types directly from the schema.
+ *
+ * @param description Natural-language description the model sees.
+ * @param schema Standard Schema defining the props the model must supply.
+ * @param component Angular component whose signal inputs must be compatible with
+ *   the schema output. A type-level error is reported here when they diverge.
+ * @returns An {@link AskToolDef} for inclusion in {@link tools}.
+ * @example
+ * ```ts
+ * const schema = z.object({ question: z.string(), options: z.array(z.string()) });
+ * type Inputs = ViewProps<typeof schema>;
+ *
+ * \@Component({ ... })
+ * class ChoiceCardComponent {
+ *   question = input.required<string>();
+ *   options  = input.required<string[]>();
+ *   // Emits the chosen option back to the model.
+ * }
+ *
+ * const choice = ask('Ask the user to choose', schema, ChoiceCardComponent);
+ * const registry = tools({ pick_option: choice });
+ * ```
+ */
+declare function ask<S extends StandardSchemaV1, C>(description: string, schema: S, component: AcceptComponent<S, C>): AskToolDef<S, C>;
+/**
+ * Collect named client tools into a frozen, name-keyed registry.
+ *
+ * The overload is generic over the entire map (`const M`) so that each tool's
+ * precise type ({@link FunctionToolDef}`<S,R>`, {@link ViewToolDef}`<S,C>`, or
+ * {@link AskToolDef}`<S,C>`) and every literal key are preserved in the
+ * {@link ClientToolRegistry} passed to `provideChat`. This lets downstream
+ * consumers look up individual tools without losing generic information.
+ *
+ * @param map An object literal mapping tool names to tool definitions created
+ *   by {@link action}, {@link view}, or {@link ask}.
+ * @returns A frozen `Readonly<M>` where `M` is the exact inferred map shape.
+ * @example
+ * ```ts
+ * const move = action('Move a stop', z.object({ fromDay: z.number() }), (a) => a.fromDay);
+ * const dayCard = view('Show a day card', z.object({ label: z.string() }), DayCardComponent);
+ *
+ * const registry = tools({ move_stop: move, day_card: dayCard });
+ * // registry.move_stop is FunctionToolDef<...>
+ * // registry.day_card  is ViewToolDef<...>
+ * ```
+ */
+declare function tools<const M extends Record<string, ClientToolDef>>(map: M): Readonly<M>;
+
+/** Validate raw model args against a Standard Schema. */
+declare function validateArgs(schema: StandardSchemaV1, args: unknown): Promise<{
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+}>;
+/** Validate args, run the handler, and normalize the outcome to a ClientToolResult. */
+declare function executeFunctionTool(def: AnyFunctionToolDef, rawArgs: unknown): Promise<ClientToolResult>;
+
+/**
+ * Watches the agent's pending client tool calls and auto-runs FUNCTION tools,
+ * resolving each with its result. View/ask (component) tools are handled by the
+ * rendering layer, not here. No-op if the agent lacks the clientTools
+ * capability. MUST be called in an injection context (sets up an effect).
+ */
+declare function startClientToolExecutor(agent: Agent, registry: ClientToolRegistry): void;
+
+interface ClientToolsCoordinator {
+    /** Components for `view`/`ask` tools, keyed by tool name — merge into the chat `views`. */
+    readonly viewRegistry: ViewRegistry;
+    /** Wire the coordinator to an agent: ship the catalog, run function tools, auto-ack view tools.
+     *  MUST be called inside an injection context (sets up effects). Safe no-op if the agent lacks
+     *  the clientTools capability. */
+    connect(agent: Agent): void;
+    /** Handle a render event bubbled up from a mounted view/ask component (resolves `ask` results). */
+    handleRenderEvent(agent: Agent, event: RenderEvent): void;
+}
+/** Build the catalog spec list shipped to the model. */
+declare function toClientToolSpecs(registry: ClientToolRegistry): ClientToolSpec[];
+declare function createClientToolsCoordinator(registry: ClientToolRegistry): ClientToolsCoordinator;
+
 interface MockAgent extends Agent {
     messages: WritableSignal<Message[]>;
     status: WritableSignal<AgentStatus>;
     isLoading: WritableSignal<boolean>;
-    error: WritableSignal<unknown>;
+    error: WritableSignal<AgentError | undefined>;
     toolCalls: WritableSignal<ToolCall[]>;
     state: WritableSignal<Record<string, unknown>>;
     interrupt?: WritableSignal<AgentInterrupt | undefined>;
@@ -2298,7 +2806,7 @@ interface MockAgentOptions {
     messages?: Message[];
     status?: AgentStatus;
     isLoading?: boolean;
-    error?: unknown;
+    error?: AgentError;
     toolCalls?: ToolCall[];
     state?: Record<string, unknown>;
     withInterrupt?: boolean;
@@ -2308,5 +2816,8 @@ interface MockAgentOptions {
 }
 declare function mockAgent(opts?: MockAgentOptions): MockAgent;
 
-export { A2uiAudioPlayerComponent, A2uiButtonComponent, A2uiCardComponent, A2uiCheckBoxComponent, A2uiColumnComponent, A2uiDateTimeInputComponent, A2uiDividerComponent, A2uiIconComponent, A2uiImageComponent, A2uiListComponent, A2uiModalComponent, A2uiMultipleChoiceComponent, A2uiRowComponent, A2uiSliderComponent, A2uiSurfaceComponent, A2uiTabsComponent, A2uiTextComponent, A2uiTextFieldComponent, A2uiVideoComponent, CHAT_CONFIG, CHAT_LIFECYCLE, CHAT_MARKDOWN_STYLES, ChatApprovalCardComponent, ChatCitationCardTemplateDirective, ChatCitationsCardComponent, ChatCitationsComponent, ChatComponent, ChatConfirmDialogComponent, ChatErrorComponent, ChatGenerativeUiComponent, ChatGenuiSkeletonComponent, ChatHistorySearchPaletteComponent, ChatInputComponent, ChatInterruptComponent, ChatInterruptPanelComponent, ChatLauncherButtonComponent, ChatMessageActionsComponent, ChatMessageComponent, ChatMessageListComponent, ChatOverflowMenuComponent, ChatPopupComponent, ChatProjectListComponent, ChatReasoningComponent, ChatScrollBubbleComponent, ChatSelectComponent, ChatSidebarComponent, ChatSidenavComponent, ChatSidenavScrimComponent, ChatStreamingMdComponent, ChatSubagentCardComponent, ChatSubagentsComponent, ChatSuggestionsComponent, ChatThreadListComponent, ChatTimelineComponent, ChatTimelineSliderComponent, ChatToolCallCardComponent, ChatToolCallTemplateDirective, ChatToolCallsComponent, ChatToolViewsComponent, ChatTraceComponent, ChatTypingIndicatorComponent, ChatWelcomeComponent, ChatWelcomeSuggestionComponent, ChatWindowComponent, CitationsResolverService, ICON_AGENT, ICON_CHECK, ICON_CHEVRON_DOWN, ICON_CHEVRON_UP, ICON_SEND, ICON_TOOL, ICON_WARNING, IS_HEADER_ROW, MARKDOWN_VIEW_REGISTRY, MarkdownAutolinkComponent, MarkdownBlockquoteComponent, MarkdownChildrenComponent, MarkdownCitationReferenceComponent, MarkdownCodeBlockComponent, MarkdownDocumentComponent, MarkdownEmphasisComponent, MarkdownHardBreakComponent, MarkdownHeadingComponent, MarkdownImageComponent, MarkdownInlineCodeComponent, MarkdownLinkComponent, MarkdownListComponent, MarkdownListItemComponent, MarkdownParagraphComponent, MarkdownSoftBreakComponent, MarkdownStrikethroughComponent, MarkdownStrongComponent, MarkdownTableCellComponent, MarkdownTableComponent, MarkdownTableRowComponent, MarkdownTextComponent, MarkdownThematicBreakComponent, MessageTemplateDirective, a2uiBasicCatalog, buildA2uiActionMessage, cacheplaneMarkdownViews, createA2uiSurfaceStore, createContentClassifier, createParseTreeStore, createPartialArgsBridge, emitBinding, extractErrorMessage, formatDuration, getInterrupt, getMessageType, isAssistantMessage, isSystemMessage, isToolMessage, isTyping, isUserMessage, messageContent, mockAgent, normalizeEnvelopeArgs, normalizeViewEntry, provideChat, renderMarkdown, statusColor, submitMessage, surfaceToSpec };
-export type { A2uiComponentView, A2uiSurfaceState, A2uiSurfaceStore, A2uiViewEntry, A2uiViews, Agent, AgentCheckpoint, AgentCustomEvent, AgentEvent, AgentInterrupt, AgentRuntimeTelemetryEvent, AgentRuntimeTelemetryPayload, AgentRuntimeTelemetryProperties, AgentRuntimeTelemetrySink, AgentStateUpdateEvent, AgentStatus, AgentSubmitInput, AgentSubmitOptions, AgentWithHistory, ChatApprovalAction, ChatConfig, ChatLifecycle, ChatMessageRole, ChatRenderEvent, ChatScrollBubbleMode, ChatSelectOption, ChatSidenavMode, ChatToolCallTemplateContext, Citation, ContentBlock, ContentClassifier, ContentType, ElementAccumulationState, InterruptAction, Message, MessageTemplateType, MockAgent, MockAgentOptions, OverflowMenuItem, ParseTreeStore, PartialArgsBridge, Project, ProjectActionAdapter, ResolvedCitation, Role, Subagent, SubagentStatus, Thread, ThreadActionAdapter, ThreadMatch, ToolCall, ToolCallInfo, ToolCallStatus, TraceState };
+/** Inferred argument type for a schema (alias of StandardSchemaInferOutput). */
+type ToolArgs<S extends StandardSchemaV1> = StandardSchemaInferOutput<S>;
+
+export { A2uiAudioPlayerComponent, A2uiButtonComponent, A2uiCardComponent, A2uiCheckBoxComponent, A2uiColumnComponent, A2uiDateTimeInputComponent, A2uiDividerComponent, A2uiIconComponent, A2uiImageComponent, A2uiListComponent, A2uiModalComponent, A2uiMultipleChoiceComponent, A2uiRowComponent, A2uiSliderComponent, A2uiSurfaceComponent, A2uiTabsComponent, A2uiTextComponent, A2uiTextFieldComponent, A2uiVideoComponent, AGENT_ERROR_MESSAGES, AgentError, CHAT_CONFIG, CHAT_LIFECYCLE, CHAT_MARKDOWN_STYLES, ChatApprovalCardComponent, ChatCitationCardTemplateDirective, ChatCitationsCardComponent, ChatCitationsComponent, ChatComponent, ChatConfirmDialogComponent, ChatErrorComponent, ChatGenerativeUiComponent, ChatGenuiSkeletonComponent, ChatHistorySearchPaletteComponent, ChatInputComponent, ChatInterruptComponent, ChatInterruptPanelComponent, ChatLauncherButtonComponent, ChatMessageActionsComponent, ChatMessageComponent, ChatMessageListComponent, ChatOverflowMenuComponent, ChatPopupComponent, ChatProjectListComponent, ChatReasoningComponent, ChatScrollBubbleComponent, ChatSelectComponent, ChatSidebarComponent, ChatSidenavComponent, ChatSidenavScrimComponent, ChatStreamingMdComponent, ChatSubagentCardComponent, ChatSubagentsComponent, ChatSuggestionsComponent, ChatThreadListComponent, ChatTimelineComponent, ChatTimelineSliderComponent, ChatToolCallCardComponent, ChatToolCallTemplateDirective, ChatToolCallsComponent, ChatToolViewsComponent, ChatTraceComponent, ChatTypingIndicatorComponent, ChatWelcomeComponent, ChatWelcomeSuggestionComponent, ChatWindowComponent, CitationsResolverService, ICON_AGENT, ICON_CHECK, ICON_CHEVRON_DOWN, ICON_CHEVRON_UP, ICON_SEND, ICON_TOOL, ICON_WARNING, IS_HEADER_ROW, MARKDOWN_VIEW_REGISTRY, MarkdownAutolinkComponent, MarkdownBlockquoteComponent, MarkdownChildrenComponent, MarkdownCitationReferenceComponent, MarkdownCodeBlockComponent, MarkdownDocumentComponent, MarkdownEmphasisComponent, MarkdownHardBreakComponent, MarkdownHeadingComponent, MarkdownImageComponent, MarkdownInlineCodeComponent, MarkdownLinkComponent, MarkdownListComponent, MarkdownListItemComponent, MarkdownParagraphComponent, MarkdownSoftBreakComponent, MarkdownStrikethroughComponent, MarkdownStrongComponent, MarkdownTableCellComponent, MarkdownTableComponent, MarkdownTableRowComponent, MarkdownTextComponent, MarkdownThematicBreakComponent, MessageTemplateDirective, a2uiBasicCatalog, action, ask, buildA2uiActionMessage, cacheplaneMarkdownViews, createA2uiSurfaceStore, createAgentRef, createClientToolsCoordinator, createContentClassifier, createParseTreeStore, createPartialArgsBridge, deriveJsonSchema, emitBinding, executeFunctionTool, extractErrorMessage, formatDuration, getInterrupt, getMessageType, injectThreadRouting, isAbortError, isAssistantMessage, isSystemMessage, isToolMessage, isTyping, isUserMessage, messageContent, mockAgent, normalizeEnvelopeArgs, normalizeViewEntry, provideChat, renderMarkdown, startClientToolExecutor, statusColor, submitMessage, surfaceToSpec, toAgentError, toClientToolSpecs, tools, validateArgs, view };
+export type { A2uiComponentView, A2uiSurfaceState, A2uiSurfaceStore, A2uiViewEntry, A2uiViews, Agent, AgentCheckpoint, AgentCustomEvent, AgentErrorKind, AgentEvent, AgentInterrupt, AgentRef, AgentRuntimeTelemetryEvent, AgentRuntimeTelemetryPayload, AgentRuntimeTelemetryProperties, AgentRuntimeTelemetrySink, AgentStateUpdateEvent, AgentStatus, AgentSubmitInput, AgentSubmitOptions, AgentWithHistory, AnyFunctionToolDef, AskToolDef, ChatApprovalAction, ChatConfig, ChatLifecycle, ChatMessageRole, ChatRenderEvent, ChatScrollBubbleMode, ChatSelectOption, ChatSidenavMode, ChatToolCallTemplateContext, Citation, ClientToolDef, ClientToolRegistry, ClientToolResult, ClientToolSpec, ClientToolsCapability, ClientToolsCoordinator, ContentBlock, ContentClassifier, ContentType, ElementAccumulationState, FunctionToolDef, InterruptAction, Message, MessageTemplateType, MockAgent, MockAgentOptions, OverflowMenuItem, ParseTreeStore, PartialArgsBridge, Project, ProjectActionAdapter, ResolvedCitation, Role, Subagent, SubagentStatus, Thread, ThreadActionAdapter, ThreadMatch, ThreadRoutingConfig, ToolArgs, ToolCall, ToolCallInfo, ToolCallStatus, TraceState, ViewProps, ViewToolDef };