@threadplane/chat 0.0.55 → 0.0.57

package/types/threadplane-chat.d.ts

@@ -9,20 +9,78 @@ 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 * as _cacheplane_partial_markdown from '@cacheplane/partial-markdown';
+import { MarkdownDocumentNode, CitationDefinition, MarkdownNode, MarkdownParagraphNode, MarkdownHeadingNode, MarkdownBlockquoteNode, MarkdownListNode, MarkdownListItemNode, MarkdownCodeBlockNode, MarkdownThematicBreakNode, MarkdownTextNode, MarkdownEmphasisNode, MarkdownStrongNode, MarkdownStrikethroughNode, MarkdownInlineCodeNode, MarkdownMathInlineNode, MarkdownMathDisplayNode, MarkdownHtmlInlineNode, MarkdownHtmlBlockNode, MarkdownLinkNode, MarkdownAutolinkNode, MarkdownImageNode, MarkdownSoftBreakNode, MarkdownHardBreakNode, MarkdownCitationReferenceNode, MarkdownTableNode, MarkdownTableRowNode, MarkdownTableCellNode } from '@cacheplane/partial-markdown';
 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, MarkdownMathInlineNode, MarkdownMathDisplayNode, MarkdownHtmlInlineNode, MarkdownHtmlBlockNode, MarkdownLinkNode, MarkdownAutolinkNode, MarkdownImageNode, MarkdownSoftBreakNode, MarkdownHardBreakNode, MarkdownCitationReferenceNode, MarkdownTableNode, MarkdownTableRowNode, MarkdownTableCellNode } from '@cacheplane/partial-markdown';
 import { SafeHtml, DomSanitizer } from '@angular/platform-browser';
 import { NavigationExtras } from '@angular/router';
 
+type ToolCallStatus = 'pending' | 'running' | 'complete' | 'error';
+interface ToolCall {
+    id: string;
+    name: string;
+    /** Arguments. May be partial while streaming (`status !== 'complete'`). */
+    args: unknown;
+    status: ToolCallStatus;
+    /** Present when status === 'complete' or 'error'. */
+    result?: unknown;
+    /** Optional error payload when status === 'error'. */
+    error?: unknown;
+}
+
+/** Runtime context passed to browser-executed function tool handlers. */
+interface FunctionToolHandlerContext {
+    /** Aborts when the client tool execution should stop without resolving. */
+    readonly signal: AbortSignal;
+}
+/** Execution policy options for browser-executed function tools. */
+interface ClientToolContinuationOptions {
+    /** False when the tool result should be recorded without forcing a continuation. */
+    readonly followUp?: boolean;
+}
+/** Execution policy options for browser-executed function tools. */
+interface ClientToolExecutionOptions extends ClientToolContinuationOptions {
+    /** True when the handler may safely re-run and should skip durable pre-claims. */
+    readonly idempotent?: boolean;
+}
+/** Diagnostic emitted when client-tool continuation would exceed the configured max turn count. */
+interface ClientToolContinuationLimitEvent {
+    readonly maxTurns: number;
+    readonly attemptedTurn: number;
+    readonly toolCallIds: readonly string[];
+    readonly toolNames: readonly string[];
+}
+/** Policy for automatic client-tool continuation. */
+interface ClientToolContinuationPolicy {
+    /** Maximum consecutive client-tool continuation groups per user turn. Default: 10. Use 0 for unlimited. */
+    readonly maxTurns?: number;
+    /** Called when the max-turn guard stops a continuation group. */
+    readonly onLimit?: (event: ClientToolContinuationLimitEvent) => void;
+}
+type ClientToolLifecyclePhase = 'running' | 'complete' | 'error';
+interface ClientToolLifecycle {
+    readonly id: string;
+    readonly name: string;
+    readonly status: ToolCallStatus;
+    readonly phase: ClientToolLifecyclePhase;
+    readonly hasResult: boolean;
+    readonly result?: unknown;
+    readonly error?: unknown;
+}
+type ClientToolViewProps<S extends StandardSchemaV1> = StandardSchemaInferOutput<S> & {
+    readonly status?: ToolCallStatus;
+    readonly clientTool?: ClientToolLifecycle;
+};
 /** 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>;
+    readonly followUp?: boolean;
+    readonly idempotent?: boolean;
+    readonly handler: (args: StandardSchemaInferOutput<S>, context: FunctionToolHandlerContext) => 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
@@ -33,18 +91,22 @@ interface AnyFunctionToolDef {
     readonly kind: 'function';
     readonly description: string;
     readonly schema: StandardSchemaV1;
-    readonly handler: (args: any) => unknown | Promise<unknown>;
+    readonly followUp?: boolean;
+    readonly idempotent?: boolean;
+    readonly handler: (args: any, context: FunctionToolHandlerContext) => unknown | Promise<unknown>;
 }
 interface ViewToolDef<S extends StandardSchemaV1 = StandardSchemaV1, C = unknown> {
     readonly kind: 'view';
     readonly description: string;
     readonly schema: S;
+    readonly followUp?: boolean;
     readonly component: Type<C>;
 }
 interface AskToolDef<S extends StandardSchemaV1 = StandardSchemaV1, C = unknown> {
     readonly kind: 'ask';
     readonly description: string;
     readonly schema: S;
+    readonly followUp?: boolean;
     readonly component: Type<C>;
 }
 /** A client tool the model can call; executed in the browser. */
@@ -162,11 +224,66 @@ interface Citation {
     snippet?: string;
     /** Provider-specific extras (retrieval score, source type, etc.). */
     extra?: Record<string, unknown>;
+    /**
+     * Source classification driving the type badge. Free-form and extensible:
+     * 'web' (default-inferred from an http(s) url) | 'file' | 'app' | 'memory'
+     * | any custom string. Optional — display derives 'web' from the url when absent.
+     */
+    sourceType?: string;
+    /**
+     * Provider-supplied favicon/logo (absolute URL or `data:` URI). NEVER
+     * auto-fetched by the library — supply this from your own resolver if you
+     * want real favicons; otherwise a monogram is rendered.
+     */
+    iconUrl?: string;
+    /** Freshness signal shown in the preview-card footer. */
+    publishedAt?: string | number | Date;
 }
 
+/**
+ * Terminal result of one response attempt.
+ *
+ * `paused` is an intentional stop awaiting resumable input; `interrupted` means
+ * the response stream ended unexpectedly. The other outcomes indicate normal
+ * completion, failure, or caller cancellation.
+ */
+type CompleteOutcome = 'success' | 'error' | 'aborted' | 'interrupted' | 'paused';
+/**
+ * Delivery lifecycle for one response attempt. `generation` identifies that
+ * attempt and is stable only for its lifetime. `streaming` means chunks may
+ * still arrive; `complete` means the attempt has stopped with a terminal outcome.
+ */
+type MessageDelivery = {
+    readonly generation: string;
+    readonly phase: 'streaming';
+} | {
+    readonly generation: string;
+    readonly phase: 'complete';
+    readonly outcome: CompleteOutcome;
+};
+/** Creates the active delivery state for one response-attempt generation. */
+declare function streamingDelivery(generation: string): {
+    readonly generation: string;
+    readonly phase: "streaming";
+};
+/** Creates a terminal delivery state for an existing response-attempt generation. */
+declare function completeDelivery<const TOutcome extends CompleteOutcome>(generation: string, outcome: TOutcome): {
+    readonly generation: string;
+    readonly phase: "complete";
+    readonly outcome: TOutcome;
+};
+/** Creates a successful terminal delivery state for an already-complete message. */
+declare function staticDelivery(messageId: string): {
+    readonly generation: string;
+    readonly phase: "complete";
+    readonly outcome: "success";
+};
+
 type Role = 'user' | 'assistant' | 'system' | 'tool';
 interface Message {
     id: string;
+    /** Adapter-owned authoritative delivery lifecycle state for this message. */
+    delivery: MessageDelivery;
     role: Role;
     /** Plain text, or a list of structured content blocks. */
     content: string | ContentBlock[];
@@ -257,19 +374,6 @@ declare function isSystemMessage(m: Message): m is Message & {
     role: 'system';
 };
 
-type ToolCallStatus = 'pending' | 'running' | 'complete' | 'error';
-interface ToolCall {
-    id: string;
-    name: string;
-    /** Arguments. May be partial while streaming (`status !== 'complete'`). */
-    args: unknown;
-    status: ToolCallStatus;
-    /** Present when status === 'complete' or 'error'. */
-    result?: unknown;
-    /** Optional error payload when status === 'error'. */
-    error?: unknown;
-}
-
 type AgentStatus = 'idle' | 'running' | 'error';
 
 interface AgentInterrupt {
@@ -371,6 +475,15 @@ interface ClientToolsCapability {
     setCatalog(specs: readonly ClientToolSpec[]): void;
     /** Tool calls the model made for client tools that await a client result. */
     readonly pending: Signal<readonly ToolCall[]>;
+    /** Record a client tool's result without continuing the run. */
+    settle?(toolCallId: string, result: ClientToolResult): void;
+    /**
+     * Make every result recorded via {@link settle} durable on the server
+     * WITHOUT continuing the run. No-op for adapters whose settle() is already
+     * durable. Adapters that buffer locally MUST clear their buffer only on a
+     * successful write, so a failure degrades to a later flush or submit.
+     */
+    flush?(): void | Promise<void>;
     /** Return a client tool's result (or error) and continue the run. */
     resolve(toolCallId: string, result: ClientToolResult): void;
 }
@@ -442,7 +555,7 @@ declare const AGENT_ERROR_MESSAGES: Record<AgentErrorKind, string>;
  * Invariant: state lives on signals; `events$` carries only things that are
  * not derivable from signals.
  */
-interface Agent<TState = Record<string, unknown>> {
+interface Agent<TState = unknown> {
     messages: Signal<Message[]>;
     status: Signal<AgentStatus>;
     isLoading: Signal<boolean>;
@@ -525,7 +638,7 @@ interface AgentCheckpoint {
  * implement this. Pure request/response runtimes that don't have checkpoints
  * should implement plain Agent.
  */
-interface AgentWithHistory<TState = Record<string, unknown>> extends Agent<TState> {
+interface AgentWithHistory<TState = unknown> extends Agent<TState> {
     history: Signal<AgentCheckpoint[]>;
     /**
      * Optional reactive map of `messageId → checkpointId`, computed by
@@ -587,7 +700,7 @@ declare class MessageTemplateDirective {
  */
 declare function getMessageType(message: Message): MessageTemplateType;
 declare class ChatMessageListComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<unknown>>;
     readonly messageTemplates: _angular_core.Signal<readonly MessageTemplateDirective[]>;
     readonly messages: _angular_core.Signal<Message[]>;
     readonly getMessageType: typeof getMessageType;
@@ -675,17 +788,19 @@ declare class ChatTraceComponent {
  * step labels often appear in reasoning output).
  *
  * Internal state: a tristate "expanded" — null means follow auto state-
- * driven logic (force-expand on isStreaming, otherwise honor
+ * driven logic (force-expand while delivery is streaming, otherwise honor
  * defaultExpanded), boolean is a manual user choice that wins for the
  * lifetime of the instance.
  */
 declare class ChatReasoningComponent {
     readonly content: _angular_core.InputSignal<string>;
-    readonly isStreaming: _angular_core.InputSignal<boolean>;
+    readonly delivery: _angular_core.InputSignal<MessageDelivery>;
     readonly durationMs: _angular_core.InputSignal<number | undefined>;
     readonly label: _angular_core.InputSignal<string | undefined>;
     readonly defaultExpanded: _angular_core.InputSignal<boolean>;
     readonly hasContent: _angular_core.Signal<boolean>;
+    readonly isStreaming: _angular_core.Signal<boolean>;
+    readonly document: _angular_core.Signal<_threadplane_chat.StreamingMarkdownDocument>;
     /** null = follow auto logic (streaming → expanded, else defaultExpanded). */
     private readonly _expandedOverride;
     readonly expanded: _angular_core.Signal<boolean>;
@@ -694,7 +809,7 @@ declare class ChatReasoningComponent {
     constructor();
     toggle(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatReasoningComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatReasoningComponent, "chat-reasoning", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "isStreaming": { "alias": "isStreaming"; "required": false; "isSignal": true; }; "durationMs": { "alias": "durationMs"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "defaultExpanded": { "alias": "defaultExpanded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatReasoningComponent, "chat-reasoning", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "delivery": { "alias": "delivery"; "required": true; "isSignal": true; }; "durationMs": { "alias": "durationMs"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "defaultExpanded": { "alias": "defaultExpanded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class ChatLauncherButtonComponent {
@@ -722,7 +837,7 @@ declare class ChatSuggestionsComponent {
  */
 declare function submitMessage(agent: Agent, text: string): string | null;
 declare class ChatInputComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<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. */
@@ -774,7 +889,7 @@ declare class ChatInputComponent {
  */
 declare function isTyping(agent: Agent): boolean;
 declare class ChatTypingIndicatorComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<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>;
@@ -883,7 +998,7 @@ declare class ChatScrollBubbleComponent {
  */
 declare function extractErrorMessage(error: unknown): string | null;
 declare class ChatErrorComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<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>;
 }
@@ -902,7 +1017,7 @@ declare class ChatErrorComponent {
  */
 declare function getInterrupt(agent: Agent): AgentInterrupt | undefined;
 declare class ChatInterruptComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<unknown>>;
     readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
     readonly interrupt: _angular_core.Signal<AgentInterrupt | undefined>;
     defaultText(i: AgentInterrupt): string;
@@ -973,7 +1088,7 @@ interface Group {
     subagent?: Subagent;
 }
 declare class ChatToolCallsComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<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>;
@@ -1012,7 +1127,7 @@ declare class ChatToolCallsComponent {
  * (and a `status` a component chooses not to declare) are harmless.
  */
 declare class ChatToolViewsComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<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>;
@@ -1029,7 +1144,7 @@ declare class ChatToolViewsComponent {
 }
 
 declare class ChatSubagentsComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<unknown>>;
     readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
     readonly activeSubagents: _angular_core.Signal<Subagent[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatSubagentsComponent, never>;
@@ -1235,7 +1350,7 @@ declare class ChatGenuiSkeletonComponent {
 }
 
 declare class ChatTimelineComponent {
-    readonly agent: _angular_core.InputSignal<AgentWithHistory<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<AgentWithHistory<unknown>>;
     readonly checkpointSelected: _angular_core.OutputEmitterRef<AgentCheckpoint>;
     readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
     readonly history: _angular_core.Signal<AgentCheckpoint[]>;
@@ -1404,6 +1519,53 @@ declare class ChatConnectedOverlayDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChatConnectedOverlayDirective, "[chatConnectedOverlay]", never, { "origin": { "alias": "chatOverlayOrigin"; "required": true; "isSignal": true; }; "open": { "alias": "chatOverlayOpen"; "required": false; "isSignal": true; }; "positions": { "alias": "chatOverlayPositions"; "required": false; "isSignal": true; }; "panelClass": { "alias": "chatOverlayPanelClass"; "required": false; "isSignal": true; }; }, { "attached": "chatOverlayAttached"; "outsideClick": "chatOverlayOutsideClick"; "detached": "chatOverlayDetach"; }, never, never, true, never>;
 }
 
+type CitationTypeIcon = 'web' | 'file' | 'app' | 'memory' | 'generic';
+interface CitationTypeMeta {
+    type: string;
+    label: string | null;
+    icon: CitationTypeIcon;
+    tone: CitationTypeIcon;
+    isKnown: boolean;
+}
+interface CitationImageVisual {
+    kind: 'image';
+    iconUrl: string;
+}
+interface CitationTypeIconVisual {
+    kind: 'type-icon';
+    icon: CitationTypeIcon;
+    tone: CitationTypeIcon;
+    label: string | null;
+}
+interface CitationMonogramVisual {
+    kind: 'monogram';
+    monogram: string;
+    color: string;
+}
+type CitationSourceVisual = CitationImageVisual | CitationTypeIconVisual | CitationMonogramVisual;
+/** Hostname of `url` with a leading `www.` removed; null if absent/malformed. */
+declare function deriveDomain(url?: string): string | null;
+/** Explicit `sourceType`, else 'web' inferred from a url, else 'unknown'. */
+declare function deriveSourceType(c: Citation): string;
+/** Uppercased first letter of the domain (or title) for the monogram chip. */
+declare function deriveMonogram(c: Citation): string;
+/** Deterministic hue in [0,360) from a seed string (stable monogram color). */
+declare function monogramHue(seed: string): number;
+/** Short freshness label (e.g. "Apr 2024"); null when absent or unparseable. */
+declare function formatPublished(value?: string | number | Date): string | null;
+/** Deterministic monogram-chip background color (stable per source). */
+declare function monogramColor(c: Citation): string;
+/**
+ * Derive normalized source-type metadata for badges, icons, and tone tokens.
+ */
+declare function citationTypeMeta(c: Citation): CitationTypeMeta;
+/**
+ * Choose the visual source marker for a citation: provider image, type icon, or monogram.
+ */
+declare function citationSourceVisual(c: Citation): CitationSourceVisual;
+/** Human label for the source-type badge; null when type is 'unknown'. */
+declare function citationTypeLabel(c: Citation): string | null;
+
 /**
  * ContentChild template directive for custom citation card rendering.
  * Usage: <ng-template chatCitationCard let-citation>...</ng-template>
@@ -1415,37 +1577,79 @@ declare class ChatCitationCardTemplateDirective {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatCitationCardTemplateDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChatCitationCardTemplateDirective, "ng-template[chatCitationCard]", never, {}, {}, never, never, true, never>;
 }
+interface FavEntry {
+    id: string;
+    kind: 'image' | 'type-icon' | 'monogram';
+    iconUrl?: string;
+    icon?: CitationTypeIcon;
+    tone?: CitationTypeIcon;
+    monogram?: string;
+    color?: string;
+}
 declare class ChatCitationsComponent {
     readonly message: _angular_core.InputSignal<Message>;
     readonly heading: _angular_core.InputSignal<string>;
+    protected readonly expanded: _angular_core.WritableSignal<boolean>;
+    protected readonly listId: string;
     cardTpl: ChatCitationCardTemplateDirective | null;
-    /**
-     * Optional resolver — present when chat-citations is rendered inside a
-     * chat-message that provides CitationsResolverService (the standard
-     * placement). When absent, the panel reads only Message.citations.
-     */
     private readonly resolver;
     /**
      * Combined citation list:
      *   1. Message.citations (provider-populated, takes precedence by id)
-     *   2. Markdown sidecar defs (Pandoc-formatted [^id]: lines), merged in
-     *      for any id not already present.
-     *
-     * Sorted by index ascending. This guarantees the sources panel surfaces
-     * citations whether they come from message metadata, content syntax, or
-     * both — matching the same precedence as inline-marker resolution.
+     *   2. Markdown sidecar defs (Pandoc [^id]: lines), merged for unseen ids.
+     * Sorted by index ascending.
      */
     protected readonly citations: _angular_core.Signal<Citation[]>;
+    /** First 3 sources, mapped to favicon/monogram chips for the header preview. */
+    protected readonly favstack: _angular_core.Signal<FavEntry[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatCitationsComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatCitationsComponent, "chat-citations", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; }, {}, ["cardTpl"], never, true, never>;
 }
 
+/**
+ * Sources-panel detail card: index badge, favicon/monogram + domain + type,
+ * title, one-line snippet. Renders as an <a> (opens the source) when a url is
+ * present, otherwise a non-interactive <div>. Shares the panel style module.
+ */
 declare class ChatCitationsCardComponent {
     readonly citation: _angular_core.InputSignal<Citation>;
+    private readonly sourceVisual;
+    private readonly typeMeta;
+    protected readonly domain: _angular_core.Signal<string | null>;
+    protected readonly title: _angular_core.Signal<string | null>;
+    protected readonly sourceIconUrl: _angular_core.Signal<string | null>;
+    protected readonly sourceIcon: _angular_core.Signal<CitationTypeIcon | null>;
+    protected readonly sourceMonogram: _angular_core.Signal<string | null>;
+    protected readonly sourceMonoColor: _angular_core.Signal<string | null>;
+    protected readonly typeLabel: _angular_core.Signal<string | null>;
+    protected readonly typeTone: _angular_core.Signal<CitationTypeIcon>;
+    protected isTypeTone(tone: CitationTypeIcon): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatCitationsCardComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatCitationsCardComponent, "chat-citations-card", never, { "citation": { "alias": "citation"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Presentational provenance card for a single Citation. Rendered inside the
+ * inline marker's connected-overlay pane (hover/tap preview) — self-contained
+ * so its encapsulated styles apply even when portaled to the body-level pane.
+ */
+declare class ChatCitationPreviewComponent {
+    readonly citation: _angular_core.InputSignal<Citation>;
+    private readonly sourceVisual;
+    private readonly typeMeta;
+    protected readonly domain: _angular_core.Signal<string | null>;
+    protected readonly sourceIconUrl: _angular_core.Signal<string | null>;
+    protected readonly sourceIcon: _angular_core.Signal<CitationTypeIcon | null>;
+    protected readonly sourceMonogram: _angular_core.Signal<string | null>;
+    protected readonly sourceMonoColor: _angular_core.Signal<string | null>;
+    protected readonly typeLabel: _angular_core.Signal<string | null>;
+    protected readonly typeTone: _angular_core.Signal<CitationTypeIcon>;
+    protected readonly published: _angular_core.Signal<string | null>;
+    protected isTypeTone(tone: CitationTypeIcon): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatCitationPreviewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatCitationPreviewComponent, "chat-citation-preview", 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>;
@@ -1487,6 +1691,76 @@ interface ChatLifecycle {
 }
 declare const CHAT_LIFECYCLE: InjectionToken<ChatLifecycle>;
 
+/** Durable identity for one client-tool execution on one thread. */
+interface ClientToolExecutionKey {
+    readonly threadId: string;
+    readonly toolCallId: string;
+}
+/** Prior durable execution state returned by a client-tool execution store. */
+type ClientToolExecutionRecord = {
+    readonly status: 'executing';
+} | {
+    readonly status: 'done';
+    readonly result: ClientToolResult;
+} | {
+    readonly status: 'failed';
+    readonly result?: ClientToolResult;
+};
+/** Structural store contract for guarded browser client-tool execution. */
+interface ClientToolExecutionStore {
+    /** Atomically claim a tool-call execution. Returns prior state when present. */
+    claim(key: ClientToolExecutionKey): Promise<'claimed' | ClientToolExecutionRecord>;
+    /** Record the final client-tool result for a claimed execution. */
+    record(key: ClientToolExecutionKey, result: ClientToolResult): Promise<void>;
+    /** Lookup prior execution states for pending tool calls on a thread. */
+    lookup(threadId: string, toolCallIds: readonly string[]): Promise<Record<string, ClientToolExecutionRecord>>;
+}
+/** Opt-in guard configuration for claim-before-execute client tools. */
+interface ClientToolExecutionGuard {
+    readonly threadId: string;
+    readonly store: ClientToolExecutionStore;
+}
+/** Return whether this function tool should claim before browser execution. */
+declare function shouldClaimBeforeExecute(def: AnyFunctionToolDef): boolean;
+/** Default fail-closed result for a stale in-progress client-tool execution. */
+declare function defaultInterruptedClientToolResult(toolCallId: string): ClientToolResult;
+/** Result recorded when the user stops a run while a client tool is running. */
+declare function cancelledClientToolResult(toolCallId: string): ClientToolResult;
+/** Default fail-closed result when the execution guard itself cannot be reached. */
+declare function clientToolGuardFailureResult(toolCallId: string, error: unknown): ClientToolResult;
+
+interface StreamingMarkdownDocument {
+    readonly generation: string;
+    readonly phase: 'streaming' | 'complete';
+    readonly content: string;
+}
+/** Creates the atomic document consumed by the streaming Markdown renderer. */
+declare function markdownDocument(content: string, delivery: MessageDelivery, suffix?: string): StreamingMarkdownDocument;
+type StreamingMarkdownContractViolationPolicy = 'throw' | 'rebuild';
+declare const STREAMING_MARKDOWN_CONTRACT_VIOLATION_POLICY: InjectionToken<StreamingMarkdownContractViolationPolicy>;
+/**
+ * Renders one explicitly-versioned markdown document through the shared view
+ * registry. A generation owns one parser session; append-only updates preserve
+ * parser and subtree identity, while generation changes replace the session.
+ */
+declare class ChatStreamingMdComponent {
+    readonly document: _angular_core.InputSignal<StreamingMarkdownDocument>;
+    readonly viewRegistry: _angular_core.InputSignal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>> | undefined>;
+    readonly resolvedRegistry: _angular_core.Signal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>>>;
+    private readonly resolver;
+    private readonly violationPolicy;
+    private readonly createParser;
+    private parser;
+    private prior;
+    private materializedRoot;
+    readonly root: _angular_core.Signal<MarkdownDocumentNode | null>;
+    constructor();
+    private process;
+    private replaceFrom;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatStreamingMdComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatStreamingMdComponent, "chat-streaming-md", never, { "document": { "alias": "document"; "required": true; "isSignal": true; }; "viewRegistry": { "alias": "viewRegistry"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 interface ElementAccumulationState {
     hasType: boolean;
     hasProps: boolean;
@@ -1629,7 +1903,7 @@ interface ChatRenderEvent {
 }
 
 declare class ChatComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<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
@@ -1670,9 +1944,12 @@ declare class ChatComponent {
      * Default covers the canonical A2UI + json-render schema tools.
      */
     readonly genuiToolNames: _angular_core.InputSignal<readonly string[]>;
+    readonly clientToolExecutionGuard: _angular_core.InputSignal<ClientToolExecutionGuard | undefined>;
+    readonly clientToolContinuationPolicy: _angular_core.InputSignal<ClientToolContinuationPolicy | undefined>;
     readonly showWelcome: _angular_core.Signal<boolean>;
     readonly threadSelected: _angular_core.OutputEmitterRef<string>;
     readonly renderEvent: _angular_core.OutputEmitterRef<ChatRenderEvent>;
+    readonly clientToolContinuationLimit: _angular_core.OutputEmitterRef<ClientToolContinuationLimitEvent>;
     /** Emitted when the user clicks the regenerate button on an assistant message. */
     readonly regenerate: _angular_core.OutputEmitterRef<void>;
     /** Emitted when the user rates an assistant message. */
@@ -1727,13 +2004,6 @@ declare class ChatComponent {
      * back to the original text.
      */
     protected humanContent(message: unknown): string;
-    /**
-     * True while a message's reasoning is mid-stream — i.e. it's the latest
-     * message, the agent is loading, the message has reasoning content, and
-     * no response text has arrived yet. Once the response text begins, the
-     * reasoning pill collapses (per its internal logic).
-     */
-    protected isReasoningStreaming(message: Message, index: number): boolean;
     /** The nearest preceding assistant message (skipping hidden tool messages), or undefined. */
     private prevAssistant;
     /**
@@ -1744,17 +2014,19 @@ declare class ChatComponent {
     protected reasoningRunStart(index: number): boolean;
     /**
      * Aggregate the reasoning RUN starting at `index`: joins each step's
-     * reasoning, sums durations, counts steps, and computes the streaming flag
-     * and the merged label when N > 1 ("Thought for {total} · {N} steps", or
-     * just "{N} steps" when no step reported timing).
+     * reasoning, sums durations, counts steps, and returns the last step's
+     * delivery because that step owns the current aggregate snapshot. Also
+     * computes the merged label when N > 1 ("Thought for {total} · {N} steps",
+     * or just "{N} steps" when no step reported timing).
      */
     protected reasoningRun(index: number): {
         content: string;
         durationMs: number | undefined;
-        streaming: boolean;
+        delivery: MessageDelivery;
         label: string | undefined;
     };
     private readonly classifiers;
+    private readonly markdownDocuments;
     private readonly destroyRef;
     private readonly injector;
     private readonly lifecycle;
@@ -1775,15 +2047,13 @@ declare class ChatComponent {
     private programmaticScrollCount;
     private static readonly PIN_TOLERANCE_PX;
     /**
-     * True iff there's a current (last-index) assistant message that's
-     * still streaming. The bubble's own caret already signals loading;
+     * True iff the current (last-index) assistant message owns an active
+     * delivery generation. The bubble's own caret already signals loading;
      * we suppress the floor typing-indicator in that case so the user
      * doesn't see two loading affordances at once.
      *
      * Matches the same `streaming + current` condition the bubble uses
-     * to enable `.chat-message__caret`:
-     *   `agent().isLoading() && i === agent().messages().length - 1`
-     *   `i === agent().messages().length - 1`
+     * to enable `.chat-message__caret`.
      *
      * Restricted to assistant role because the caret only renders on
      * assistant bubbles (`:host([data-role="assistant"][data-current=...
@@ -1833,9 +2103,8 @@ declare class ChatComponent {
      * unlike a single prev-message check.
      */
     protected isGenuiTurn(message: unknown, _prevMsg: unknown, index?: number): boolean;
-    classifyMessage(content: string, message: {
-        id?: string;
-    }): ContentClassifier;
+    classifyMessage(content: string, message: Pick<Message, 'id' | 'delivery'>): ContentClassifier;
+    protected markdownDocumentFor(content: string, message: Pick<Message, 'id' | 'delivery'>): StreamingMarkdownDocument;
     clearClassifiers(): void;
     onSpecEvent(event: RenderEvent, messageIndex: number): void;
     /**
@@ -1852,11 +2121,11 @@ 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; }; "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>;
+    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; }; "clientToolExecutionGuard": { "alias": "clientToolExecutionGuard"; "required": false; "isSignal": true; }; "clientToolContinuationPolicy": { "alias": "clientToolContinuationPolicy"; "required": false; "isSignal": true; }; }, { "selectedModel": "selectedModelChange"; "threadSelected": "threadSelected"; "renderEvent": "renderEvent"; "clientToolContinuationLimit": "clientToolContinuationLimit"; "regenerate": "regenerate"; "rate": "rate"; "messageCopy": "messageCopy"; }, never, ["[chatWelcomeSuggestions]", "[chatHeader]", "[chatToolCallTemplate]", "[chatInputModelSelect]"], true, never>;
 }
 
 declare class ChatPopupComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<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`. */
@@ -1896,7 +2165,7 @@ declare class ChatPopupComponent {
 }
 
 declare class ChatSidebarComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<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`. */
@@ -1930,7 +2199,7 @@ declare class ChatSidebarComponent {
 }
 
 declare class ChatTimelineSliderComponent {
-    readonly agent: _angular_core.InputSignal<AgentWithHistory<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<AgentWithHistory<unknown>>;
     readonly selectedIndex: _angular_core.WritableSignal<number>;
     readonly history: _angular_core.Signal<AgentCheckpoint[]>;
     readonly replayRequested: _angular_core.OutputEmitterRef<string>;
@@ -1952,7 +2221,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<Record<string, unknown>> | AgentWithHistory<Record<string, unknown>> | null>;
+    readonly agent: _angular_core.InputSignal<Agent<unknown> | AgentWithHistory<unknown> | null>;
     readonly debug: _angular_core.InputSignal<boolean>;
     readonly newChat: _angular_core.OutputEmitterRef<void>;
     readonly threadSelected: _angular_core.OutputEmitterRef<string>;
@@ -2003,7 +2272,7 @@ declare class ChatSidenavScrimComponent {
 
 type InterruptAction = 'accept' | 'edit' | 'respond' | 'ignore';
 declare class ChatInterruptPanelComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<unknown>>;
     readonly action: _angular_core.OutputEmitterRef<InterruptAction>;
     readonly interrupt: _angular_core.Signal<AgentInterrupt | undefined>;
     readonly interruptReason: _angular_core.Signal<string>;
@@ -2013,7 +2282,7 @@ declare class ChatInterruptPanelComponent {
 
 type ChatApprovalAction = 'approve' | 'edit' | 'cancel';
 declare class ChatApprovalCardComponent {
-    readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
+    readonly agent: _angular_core.InputSignal<Agent<unknown>>;
     readonly matchKind: _angular_core.InputSignal<string | undefined>;
     readonly title: _angular_core.InputSignal<string>;
     readonly showEdit: _angular_core.InputSignal<boolean>;
@@ -2043,6 +2312,9 @@ declare function statusColor(status: SubagentStatus): string;
 declare class ChatSubagentCardComponent {
     readonly subagent: _angular_core.InputSignal<Subagent>;
     readonly state: _angular_core.Signal<TraceState>;
+    private readonly markdownDocuments;
+    constructor();
+    protected markdownDocumentFor(content: string, message: Message): StreamingMarkdownDocument;
     protected textOf(m: Message): string;
     protected toolCallsFor(m: Message): ToolCall[];
     protected toToolCallInfo(tc: ToolCall): ToolCallInfo;
@@ -2062,39 +2334,6 @@ declare class CitationsResolverService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<CitationsResolverService>;
 }
 
-/**
- * Renders streaming markdown by walking a @cacheplane/partial-markdown AST
- * through @threadplane/render's view registry.
- *
- * Reactivity model: the live `parser.root` keeps a stable JS reference
- * across pushes (partial-markdown's identity guarantee). To make Angular
- * signals propagate downstream when the underlying tree changes, we surface
- * a materialized snapshot via `materialize()`. The snapshot shares
- * structurally — unchanged subtrees keep the SAME reference, and any
- * descendant change yields a NEW root reference. This lets Angular's
- * `Object.is` equality check both detect changes (root reference differs)
- * and short-circuit unchanged subtrees (per-node references stable).
- *
- * Override per-node-type renderers via the `[viewRegistry]` input or by
- * supplying a different `MARKDOWN_VIEW_REGISTRY` provider in the injector
- * tree.
- */
-declare class ChatStreamingMdComponent {
-    readonly content: _angular_core.InputSignal<string>;
-    readonly streaming: _angular_core.InputSignal<boolean>;
-    readonly viewRegistry: _angular_core.InputSignal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>> | undefined>;
-    readonly resolvedRegistry: _angular_core.Signal<Readonly<Record<string, _angular_core.Type<unknown> | _threadplane_render.RenderViewEntry>>>;
-    private readonly resolver;
-    constructor();
-    private parser;
-    private prior;
-    private finished;
-    private readonly finalizeTick;
-    readonly root: _angular_core.Signal<MarkdownDocumentNode | null>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatStreamingMdComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatStreamingMdComponent, "chat-streaming-md", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "viewRegistry": { "alias": "viewRegistry"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 /**
  * DI token for the markdown view registry consumed by <chat-streaming-md>
  * and <md-children>. Maps MarkdownNode.type strings (e.g. "paragraph",
@@ -2274,10 +2513,41 @@ declare class MarkdownHardBreakComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MarkdownHardBreakComponent, "chat-md-hard-break", never, { "node": { "alias": "node"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Inline citation marker. Renders a numbered pill and reveals a provenance
+ * preview card (portaled via the connected-overlay primitive) on hover/focus
+ * (desktop) or tap (touch). Click navigates on desktop when a url exists;
+ * on touch it previews instead of navigating.
+ */
 declare class MarkdownCitationReferenceComponent {
     readonly node: _angular_core.InputSignal<MarkdownCitationReferenceNode>;
     private readonly resolver;
+    private readonly document;
     protected readonly resolved: _angular_core.Signal<_threadplane_chat.ResolvedCitation | null>;
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    protected readonly positions: ConnectedPosition[];
+    /** Read fresh each time: SSR renders with no window, and hybrid devices change. */
+    private get hoverCapable();
+    private openTimer;
+    private closeTimer;
+    private pane;
+    private justOpenedByFocus;
+    constructor();
+    protected ariaLabel(c: Citation): string;
+    protected onEnter(): void;
+    protected onLeave(): void;
+    protected onFocus(): void;
+    protected onBlur(): void;
+    protected onClick(e: MouseEvent, c: Citation): void;
+    protected onKeydown(e: KeyboardEvent, c: Citation): void;
+    protected onAttached(pane: HTMLElement): void;
+    protected close(): void;
+    private readonly onPaneEnter;
+    private readonly onPaneLeave;
+    private scheduleClose;
+    private cancelOpen;
+    private cancelClose;
+    private clearTimers;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MarkdownCitationReferenceComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MarkdownCitationReferenceComponent, "chat-md-citation-reference", never, { "node": { "alias": "node"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -2874,8 +3144,11 @@ type ViewProps<S extends StandardSchemaV1> = Prettify<StandardSchemaInferOutput<
  * @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}.
+ * @param handler Runs in the browser when the model calls the tool. The second
+ *   argument carries an `AbortSignal`; its return type `R` is carried on the
+ *   resulting {@link FunctionToolDef}.
+ * @param options Execution policy options, including `idempotent: true` to skip
+ *   durable pre-execution claims when a guard is configured.
  * @returns A {@link FunctionToolDef} for inclusion in {@link tools}.
  * @example
  * ```ts
@@ -2883,7 +3156,7 @@ type ViewProps<S extends StandardSchemaV1> = Prettify<StandardSchemaInferOutput<
  * 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>;
+declare function action<S extends StandardSchemaV1, R>(description: string, schema: S, handler: (args: StandardSchemaInferOutput<S>, context: FunctionToolHandlerContext) => R | Promise<R>, options?: ClientToolExecutionOptions): 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.
@@ -2914,7 +3187,7 @@ declare function action<S extends StandardSchemaV1, R>(description: string, sche
  * const registry = tools({ day_card: dayCard });
  * ```
  */
-declare function view<S extends StandardSchemaV1, C>(description: string, schema: S, component: AcceptComponent<S, C>): ViewToolDef<S, C>;
+declare function view<S extends StandardSchemaV1, C>(description: string, schema: S, component: AcceptComponent<S, C>, options?: ClientToolContinuationOptions): 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
@@ -2947,7 +3220,7 @@ declare function view<S extends StandardSchemaV1, C>(description: string, schema
  * const registry = tools({ pick_option: choice });
  * ```
  */
-declare function ask<S extends StandardSchemaV1, C>(description: string, schema: S, component: AcceptComponent<S, C>): AskToolDef<S, C>;
+declare function ask<S extends StandardSchemaV1, C>(description: string, schema: S, component: AcceptComponent<S, C>, options?: ClientToolContinuationOptions): AskToolDef<S, C>;
 /**
  * Collect named client tools into a frozen, name-keyed registry.
  *
@@ -2972,6 +3245,20 @@ declare function ask<S extends StandardSchemaV1, C>(description: string, schema:
  */
 declare function tools<const M extends Record<string, ClientToolDef>>(map: M): Readonly<M>;
 
+/** Inputs for {@link selectPendingClientToolCalls}. */
+interface SelectPendingClientToolCallsInput {
+    /** Whether the agent is currently streaming a run. Pending client tools are hidden while loading. */
+    isLoading: boolean;
+    /** Tool calls observed from the current agent state. */
+    toolCalls: readonly ToolCall[];
+    /** Client-declared tool names that should be handled in the browser. */
+    catalogNames: ReadonlySet<string>;
+    /** Tool-call ids already resolved by the local client instance. */
+    resolvedIds: ReadonlySet<string>;
+}
+/** Select client tool calls that are ready for browser-side resolution. */
+declare function selectPendingClientToolCalls(input: SelectPendingClientToolCallsInput): readonly ToolCall[];
+
 /** Validate raw model args against a Standard Schema. */
 declare function validateArgs(schema: StandardSchemaV1, args: unknown): Promise<{
     ok: true;
@@ -2981,15 +3268,23 @@ declare function validateArgs(schema: StandardSchemaV1, args: unknown): Promise<
     error: string;
 }>;
 /** Validate args, run the handler, and normalize the outcome to a ClientToolResult. */
-declare function executeFunctionTool(def: AnyFunctionToolDef, rawArgs: unknown): Promise<ClientToolResult>;
+declare function executeFunctionTool(def: AnyFunctionToolDef, rawArgs: unknown, context?: FunctionToolHandlerContext): Promise<ClientToolResult>;
 
+/** Options for wiring automatic browser function-tool execution. */
+interface ClientToolExecutorOptions {
+    readonly executionGuard?: ClientToolExecutionGuard;
+    readonly settleToolCall?: (toolCall: ToolCall, result: ClientToolResult) => void;
+    /** Settlement for calls that must NOT continue the run (user abort, teardown). */
+    readonly settleWithoutContinuing?: (toolCall: ToolCall, result: ClientToolResult) => void;
+    readonly shouldExecuteToolCall?: (toolCall: ToolCall) => boolean;
+}
 /**
  * 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;
+declare function startClientToolExecutor(agent: Agent, registry: ClientToolRegistry, options?: ClientToolExecutorOptions): void;
 
 interface ClientToolsCoordinator {
     /** Components for `view`/`ask` tools, keyed by tool name — merge into the chat `views`. */
@@ -3062,8 +3357,10 @@ interface MockAgentOptions {
  * @returns A {@link MockAgent} satisfying the full `Agent` contract.
  * @example
  * ```ts
+ * import { staticDelivery } from '@threadplane/chat';
+ *
  * const agent = mockAgent({
- *   messages: [{ id: '1', role: 'assistant', content: 'Hi' }],
+ *   messages: [{ id: '1', role: 'assistant', content: 'Hi', delivery: staticDelivery('1') }],
  *   isLoading: true,
  * });
  * ```
@@ -3073,5 +3370,5 @@ declare function mockAgent(opts?: MockAgentOptions): MockAgent;
 /** 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, ChatApprovalCardComponent, ChatCitationCardTemplateDirective, ChatCitationsCardComponent, ChatCitationsComponent, ChatComponent, ChatConfirmDialogComponent, ChatConnectedOverlayDirective, ChatErrorComponent, ChatGenerativeUiComponent, ChatGenuiSkeletonComponent, ChatHistorySearchPaletteComponent, ChatInputComponent, ChatInterruptComponent, ChatInterruptPanelComponent, ChatLauncherButtonComponent, ChatMessageActionsComponent, ChatMessageComponent, ChatMessageListComponent, ChatOverflowMenuComponent, ChatOverlayOriginDirective, 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, IS_HEADER_ROW, MARKDOWN_VIEW_REGISTRY, MarkdownAutolinkComponent, MarkdownBlockquoteComponent, MarkdownChildrenComponent, MarkdownCitationReferenceComponent, MarkdownCodeBlockComponent, MarkdownDocumentComponent, MarkdownEmphasisComponent, MarkdownHardBreakComponent, MarkdownHeadingComponent, MarkdownHtmlComponent, MarkdownImageComponent, MarkdownInlineCodeComponent, MarkdownLinkComponent, MarkdownListComponent, MarkdownListItemComponent, MarkdownMathComponent, MarkdownParagraphComponent, MarkdownSoftBreakComponent, MarkdownStrikethroughComponent, MarkdownStrongComponent, MarkdownTableCellComponent, MarkdownTableComponent, MarkdownTableRowComponent, MarkdownTextComponent, MarkdownThematicBreakComponent, MessageTemplateDirective, a2uiBasicCatalog, action, ask, buildA2uiActionMessage, cacheplaneMarkdownViews, createA2uiSurfaceStore, createAgentRef, 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, 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, ConnectedPosition, ContentBlock, ContentClassifier, ContentType, ElementAccumulationState, FunctionToolDef, InterruptAction, Message, MessageTemplateType, MockAgent, MockAgentOptions, OverflowMenuItem, OverlayPositionResult, ParseTreeStore, PartialArgsBridge, Project, ProjectActionAdapter, ResolvedCitation, Role, Subagent, SubagentStatus, Thread, ThreadActionAdapter, ThreadMatch, ThreadRoutingConfig, ToolArgs, ToolCall, ToolCallInfo, ToolCallStatus, TraceState, ViewProps, ViewToolDef };
+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, ChatApprovalCardComponent, ChatCitationCardTemplateDirective, ChatCitationPreviewComponent, ChatCitationsCardComponent, ChatCitationsComponent, ChatComponent, ChatConfirmDialogComponent, ChatConnectedOverlayDirective, ChatErrorComponent, ChatGenerativeUiComponent, ChatGenuiSkeletonComponent, ChatHistorySearchPaletteComponent, ChatInputComponent, ChatInterruptComponent, ChatInterruptPanelComponent, ChatLauncherButtonComponent, ChatMessageActionsComponent, ChatMessageComponent, ChatMessageListComponent, ChatOverflowMenuComponent, ChatOverlayOriginDirective, 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, IS_HEADER_ROW, MARKDOWN_VIEW_REGISTRY, MarkdownAutolinkComponent, MarkdownBlockquoteComponent, MarkdownChildrenComponent, MarkdownCitationReferenceComponent, MarkdownCodeBlockComponent, MarkdownDocumentComponent, MarkdownEmphasisComponent, MarkdownHardBreakComponent, MarkdownHeadingComponent, MarkdownHtmlComponent, MarkdownImageComponent, MarkdownInlineCodeComponent, MarkdownLinkComponent, MarkdownListComponent, MarkdownListItemComponent, MarkdownMathComponent, MarkdownParagraphComponent, MarkdownSoftBreakComponent, MarkdownStrikethroughComponent, MarkdownStrongComponent, MarkdownTableCellComponent, MarkdownTableComponent, MarkdownTableRowComponent, MarkdownTextComponent, MarkdownThematicBreakComponent, MessageTemplateDirective, STREAMING_MARKDOWN_CONTRACT_VIOLATION_POLICY, a2uiBasicCatalog, action, ask, buildA2uiActionMessage, cacheplaneMarkdownViews, cancelledClientToolResult, citationSourceVisual, citationTypeLabel, citationTypeMeta, clientToolGuardFailureResult, completeDelivery, createA2uiSurfaceStore, createAgentRef, createContentClassifier, createParseTreeStore, createPartialArgsBridge, defaultInterruptedClientToolResult, deriveDomain, deriveJsonSchema, deriveMonogram, deriveSourceType, emitBinding, executeFunctionTool, extractErrorMessage, formatDuration, formatPublished, getInterrupt, getMessageType, injectThreadRouting, isAbortError, isAssistantMessage, isSystemMessage, isToolMessage, isTyping, isUserMessage, markdownDocument, messageContent, mockAgent, monogramColor, monogramHue, normalizeEnvelopeArgs, normalizeViewEntry, provideChat, renderMarkdown, selectPendingClientToolCalls, shouldClaimBeforeExecute, startClientToolExecutor, staticDelivery, statusColor, streamingDelivery, submitMessage, 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, CitationImageVisual, CitationMonogramVisual, CitationSourceVisual, CitationTypeIcon, CitationTypeIconVisual, CitationTypeMeta, ClientToolContinuationLimitEvent, ClientToolContinuationOptions, ClientToolContinuationPolicy, ClientToolDef, ClientToolExecutionGuard, ClientToolExecutionKey, ClientToolExecutionOptions, ClientToolExecutionRecord, ClientToolExecutionStore, ClientToolExecutorOptions, ClientToolLifecycle, ClientToolLifecyclePhase, ClientToolRegistry, ClientToolResult, ClientToolSpec, ClientToolViewProps, ClientToolsCapability, ClientToolsCoordinator, CompleteOutcome, ConnectedPosition, ContentBlock, ContentClassifier, ContentType, ElementAccumulationState, FunctionToolDef, FunctionToolHandlerContext, InterruptAction, Message, MessageDelivery, MessageTemplateType, MockAgent, MockAgentOptions, OverflowMenuItem, OverlayPositionResult, ParseTreeStore, PartialArgsBridge, Project, ProjectActionAdapter, ResolvedCitation, Role, SelectPendingClientToolCallsInput, StreamingMarkdownContractViolationPolicy, StreamingMarkdownDocument, Subagent, SubagentStatus, Thread, ThreadActionAdapter, ThreadMatch, ThreadRoutingConfig, ToolArgs, ToolCall, ToolCallInfo, ToolCallStatus, TraceState, ViewProps, ViewToolDef };