@threadplane/chat 0.0.55 → 0.0.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threadplane/chat",
-  "version": "0.0.55",
+  "version": "0.0.56",
   "exports": {
     "./chat.css": "./chat.css",
     "./themes/default-dark.css": "./themes/default-dark.css",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@cacheplane/partial-json": ">=0.1.1 <0.3.0",
-    "@cacheplane/partial-markdown": "^0.5.3",
+    "@cacheplane/partial-markdown": "^0.5.5",
     "tslib": "^2.3.0",
     "@threadplane/telemetry": "*"
   },

package/types/threadplane-chat.d.ts

@@ -162,6 +162,20 @@ 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;
 }
 
 type Role = 'user' | 'assistant' | 'system' | 'tool';
@@ -1415,37 +1429,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;
+    iconUrl?: string;
+    mono: 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>;
+    protected readonly domain: _angular_core.Signal<string | null>;
+    protected readonly title: _angular_core.Signal<string | null>;
+    protected readonly monogram: _angular_core.Signal<string>;
+    protected readonly monoColor: _angular_core.Signal<string>;
+    protected readonly typeLabel: _angular_core.Signal<string | null>;
     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>;
+    protected readonly domain: _angular_core.Signal<string | null>;
+    protected readonly monogram: _angular_core.Signal<string>;
+    protected readonly monoColor: _angular_core.Signal<string>;
+    protected readonly typeLabel: _angular_core.Signal<string | null>;
+    protected readonly published: _angular_core.Signal<string | null>;
+    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>;
+}
+
+/** 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;
+/** Human label for the source-type badge; null when type is 'unknown'. */
+declare function citationTypeLabel(c: Citation): string | null;
+
 interface ThreadRoutingConfig {
     /** The app-owned source-of-truth signal for the active thread id. */
     threadId: WritableSignal<string | null>;
@@ -1782,8 +1838,8 @@ declare class ChatComponent {
      *
      * 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`
+     *   `this.agent().isLoading() && i === this.agent().messages().length - 1`
+     *   `i === this.agent().messages().length - 1`
      *
      * Restricted to assistant role because the caret only renders on
      * assistant bubbles (`:host([data-role="assistant"][data-current=...
@@ -2274,10 +2330,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>;
 }
@@ -3073,5 +3160,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 { 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, a2uiBasicCatalog, action, ask, buildA2uiActionMessage, cacheplaneMarkdownViews, citationTypeLabel, createA2uiSurfaceStore, createAgentRef, createContentClassifier, createParseTreeStore, createPartialArgsBridge, deriveDomain, deriveJsonSchema, deriveMonogram, deriveSourceType, emitBinding, executeFunctionTool, extractErrorMessage, formatDuration, formatPublished, getInterrupt, getMessageType, injectThreadRouting, isAbortError, isAssistantMessage, isSystemMessage, isToolMessage, isTyping, isUserMessage, messageContent, mockAgent, monogramColor, monogramHue, 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 };