@threadplane/chat 0.0.47 → 0.0.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threadplane/chat",
-  "version": "0.0.47",
+  "version": "0.0.49",
   "exports": {
     "./chat.css": "./chat.css",
     "./themes/default-dark.css": "./themes/default-dark.css",

package/types/threadplane-chat-testing.d.ts

@@ -1,5 +1,19 @@
 import { Agent, AgentCheckpoint, AgentWithHistory, Message } from '@threadplane/chat';
 
+/**
+ * Shared config for the adapters' `provideFakeAgent()` helpers
+ * (@threadplane/langgraph and @threadplane/ag-ui). Drives an in-process
+ * fake backend that streams a canned assistant reply.
+ */
+interface FakeAgentConfig {
+    /** Assistant reply, streamed token-by-token. */
+    tokens?: string[];
+    /** Optional reasoning chunks emitted before the text reply. */
+    reasoningTokens?: string[];
+    /** Milliseconds between successive token emissions. */
+    delayMs?: number;
+}
+
 /**
  * Runs a suite of contract conformance assertions against a factory that
  * produces a fresh Agent. Adapter packages should call this in their
@@ -36,4 +50,4 @@ declare const REASONING_FIXTURE_EVENTS: AbstractEvent[];
 declare function assertReasoningFixtureMessages(messages: readonly Message[]): void;
 
 export { REASONING_FIXTURE_EVENTS, REASONING_FIXTURE_MESSAGE_ID, REASONING_FIXTURE_REASONING, REASONING_FIXTURE_RESPONSE, assertReasoningFixtureMessages, runAgentConformance, runAgentWithHistoryConformance };
-export type { AbstractEvent };
+export type { AbstractEvent, FakeAgentConfig };

package/types/threadplane-chat.d.ts

@@ -2,10 +2,10 @@ 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 { VIEW_REGISTRY, ViewRegistry, provideViews, toRenderRegistry, views, withViews, withoutViews } 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 { Spec, StateStore } from '@json-render/core';
+import { StateStore, Spec } from '@json-render/core';
 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 { PartialJsonParser } from '@cacheplane/partial-json';
@@ -679,6 +679,35 @@ declare class ChatToolCallsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatToolCallsComponent, "chat-tool-calls", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "grouping": { "alias": "grouping"; "required": false; "isSignal": true; }; "groupSummary": { "alias": "groupSummary"; "required": false; "isSignal": true; }; "excludeToolNames": { "alias": "excludeToolNames"; "required": false; "isSignal": true; }; }, {}, ["templates"], never, true, never>;
 }
 
+/**
+ * Renders a frontend component for a tool call by reusing the chat
+ * composition's `views` registry. A tool call whose `name` matches a
+ * registry key is bridged into a synthetic one-element render spec
+ * (`{ root: name, elements: { [name]: { type: name, props } } }`) and
+ * rendered through the existing render-spec pipeline.
+ *
+ * Props merge the live `args` (present while the call streams) with the
+ * `result` (on completion) and always include `status`, so a view
+ * component can show its own loading/empty/error states. `RenderElement`
+ * filters props down to the component's declared inputs, so extra keys
+ * (and a `status` a component chooses not to declare) are harmless.
+ */
+declare class ChatToolViewsComponent {
+    readonly agent: _angular_core.InputSignal<Agent>;
+    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>;
+    readonly handlers: _angular_core.InputSignal<Record<string, (params: Record<string, unknown>) => unknown | Promise<unknown>>>;
+    readonly registry: _angular_core.Signal<_threadplane_render.AngularRegistry | undefined>;
+    readonly toolViews: _angular_core.Signal<{
+        id: string;
+        loading: boolean;
+        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>;
+}
+
 declare class ChatSubagentsComponent {
     readonly agent: _angular_core.InputSignal<Agent>;
     readonly templateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
@@ -1181,6 +1210,12 @@ declare class ChatComponent {
     private readonly _internalStore;
     readonly resolvedStore: _angular_core.Signal<StateStore | 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. */
+    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[]>;
     readonly messageContent: typeof messageContent;
     /**
      * Renderable content for a human-role message bubble. Most human
@@ -1189,7 +1224,7 @@ declare class ChatComponent {
      * on a rendered surface) flow through the same submit channel and
      * land in the message stream as a HumanMessage whose content is a
      * JSON-serialized `A2uiActionMessage`. Showing the raw JSON as if
-     * the user typed it leaks the protocol; per the A2UI v0.9 spec
+     * the user typed it leaks the protocol; per the A2UI spec
      * those events resemble tool calls more than user utterances.
      *
      * `a2uiActionLabel` returns a short human-readable label for
@@ -1450,6 +1485,28 @@ declare class ChatInterruptPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatInterruptPanelComponent, "chat-interrupt-panel", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; }, { "action": "action"; }, never, never, true, never>;
 }
 
+type ChatApprovalAction = 'approve' | 'edit' | 'cancel';
+declare class ChatApprovalCardComponent {
+    readonly agent: _angular_core.InputSignal<Agent>;
+    readonly matchKind: _angular_core.InputSignal<string | undefined>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly showEdit: _angular_core.InputSignal<boolean>;
+    readonly action: _angular_core.OutputEmitterRef<ChatApprovalAction>;
+    protected readonly bodyTemplate: _angular_core.Signal<TemplateRef<unknown> | undefined>;
+    private readonly dialogRef;
+    private readonly interrupt;
+    protected readonly payload: _angular_core.Signal<{
+        kind?: unknown;
+    } | undefined>;
+    constructor();
+    protected emit(action: ChatApprovalAction): void;
+    protected onCancelEvent(ev: Event): void;
+    private closeDialog;
+    protected onDialogClose(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatApprovalCardComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatApprovalCardComponent, "chat-approval-card", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "matchKind": { "alias": "matchKind"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "showEdit": { "alias": "showEdit"; "required": false; "isSignal": true; }; }, { "action": "action"; }, ["bodyTemplate"], never, true, never>;
+}
+
 /**
  * Returns a CSS style string for a subagent's status badge.
  * Kept exported for backward compatibility with existing consumers; the
@@ -2251,5 +2308,5 @@ 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, 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, 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, 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 };
+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 };