@threadplane/chat 0.0.46

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@threadplane/chat",
+  "version": "0.0.46",
+  "exports": {
+    "./chat.css": "./chat.css",
+    "./themes/default-dark.css": "./themes/default-dark.css",
+    "./themes/default-light.css": "./themes/default-light.css",
+    "./themes/material-dark.css": "./themes/material-dark.css",
+    "./themes/material-light.css": "./themes/material-light.css",
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/threadplane-chat.d.ts",
+      "default": "./fesm2022/threadplane-chat.mjs"
+    },
+    "./debug": {
+      "types": "./types/threadplane-chat-debug.d.ts",
+      "default": "./fesm2022/threadplane-chat-debug.mjs"
+    },
+    "./testing": {
+      "types": "./types/threadplane-chat-testing.d.ts",
+      "default": "./fesm2022/threadplane-chat-testing.mjs"
+    }
+  },
+  "dependencies": {
+    "@cacheplane/partial-json": ">=0.1.1 <0.3.0",
+    "@cacheplane/partial-markdown": "^0.3.0",
+    "tslib": "^2.3.0",
+    "@threadplane/telemetry": "*"
+  },
+  "peerDependencies": {
+    "@angular/core": "^20.0.0 || ^21.0.0",
+    "@angular/common": "^20.0.0 || ^21.0.0",
+    "@angular/forms": "^20.0.0 || ^21.0.0",
+    "@angular/platform-browser": "^20.0.0 || ^21.0.0",
+    "@threadplane/licensing": "*",
+    "@threadplane/render": "*",
+    "@threadplane/a2ui": "*",
+    "@json-render/core": "^0.16.0",
+    "@langchain/core": "^1.1.33",
+    "rxjs": "~7.8.0",
+    "marked": "^15.0.0 || ^16.0.0"
+  },
+  "license": "PolyForm-Noncommercial-1.0.0 OR LicenseRef-Threadplane-Commercial",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cacheplane/angular-agent-framework.git",
+    "directory": "libs/chat"
+  },
+  "homepage": "https://github.com/cacheplane/angular-agent-framework#readme",
+  "bugs": {
+    "url": "https://github.com/cacheplane/angular-agent-framework/issues"
+  },
+  "sideEffects": [
+    "**/chat-tokens.ts",
+    "./fesm2022/threadplane-chat.mjs",
+    "**/*.css"
+  ],
+  "module": "fesm2022/threadplane-chat.mjs",
+  "typings": "types/threadplane-chat.d.ts",
+  "scripts": {
+    "postinstall": "threadplane-telemetry-postinstall || true"
+  }
+}

package/themes/default-dark.css

@@ -0,0 +1,32 @@
+/*
+ * @threadplane/chat — default dark theme
+ * SPDX-License-Identifier: MIT
+ *
+ * The lib's `:host` defaults on `<a2ui-surface>` already declare these
+ * exact values — this preset is a no-op @import for symmetry/docs and
+ * for consumers who want their `:root` to make the choice explicit.
+ *
+ * Usage in your global stylesheet:
+ *   @import '@threadplane/chat/themes/default-dark.css';
+ *
+ * The agent's `beginRendering.styles.primaryColor` continues to override
+ * `--a2ui-primary` per surface (host inline-style binding, highest
+ * specificity).
+ */
+:root {
+  /* === Color (dark, blue accent) === */
+  --a2ui-primary: #4f8df5;
+  --a2ui-on-primary: #ffffff;
+  --a2ui-primary-hover: #6699f7;
+  --a2ui-secondary: #8a92a3;
+  --a2ui-on-secondary: #ffffff;
+  --a2ui-surface: #1a1d23;
+  --a2ui-on-surface: #ffffff;
+  --a2ui-surface-variant: rgba(255, 255, 255, 0.05);
+  --a2ui-on-surface-variant: rgba(255, 255, 255, 0.7);
+  --a2ui-outline: rgba(255, 255, 255, 0.1);
+  --a2ui-outline-variant: rgba(255, 255, 255, 0.05);
+  --a2ui-error: #f5524f;
+  --a2ui-on-error: #ffffff;
+  --a2ui-scrim: rgba(0, 0, 0, 0.6);
+}

package/themes/default-light.css

@@ -0,0 +1,36 @@
+/*
+ * @threadplane/chat — default light theme
+ * SPDX-License-Identifier: MIT
+ *
+ * Neutral light palette with blue accent. Off-white surface (#FAFAFA)
+ * for friendlier contrast vs. pure white. Same blue accent (#4f8df5)
+ * as default-dark — the only theming decision is foreground/background
+ * inversion + outline lightening + softer elevation.
+ *
+ * Usage in your global stylesheet:
+ *   @import '@threadplane/chat/themes/default-light.css';
+ */
+:root {
+  /* === Color (light, blue accent) === */
+  --a2ui-primary: #4f8df5;
+  --a2ui-on-primary: #ffffff;
+  --a2ui-primary-hover: #3b7be3;
+  --a2ui-secondary: #5b6275;
+  --a2ui-on-secondary: #ffffff;
+  --a2ui-surface: #fafafa;
+  --a2ui-on-surface: #1a1d23;
+  --a2ui-surface-variant: rgba(0, 0, 0, 0.04);
+  --a2ui-on-surface-variant: rgba(0, 0, 0, 0.6);
+  --a2ui-outline: rgba(0, 0, 0, 0.12);
+  --a2ui-outline-variant: rgba(0, 0, 0, 0.06);
+  --a2ui-error: #d33533;
+  --a2ui-on-error: #ffffff;
+  --a2ui-scrim: rgba(0, 0, 0, 0.4);
+
+  /* === Elevation (softer shadows on light backgrounds) === */
+  --a2ui-elevation-1: 0 1px 2px rgba(0, 0, 0, 0.08);
+  --a2ui-elevation-2: 0 2px 4px rgba(0, 0, 0, 0.10);
+  --a2ui-elevation-3: 0 4px 8px rgba(0, 0, 0, 0.12);
+  --a2ui-elevation-4: 0 8px 16px rgba(0, 0, 0, 0.14);
+  --a2ui-elevation-5: 0 16px 32px rgba(0, 0, 0, 0.16);
+}

package/themes/material-dark.css

@@ -0,0 +1,38 @@
+/*
+ * @threadplane/chat — Material Design 3 dark theme
+ * SPDX-License-Identifier: MIT
+ *
+ * Maps Google's Material Design 3 dark color tokens (m3.material.io)
+ * into the @threadplane/chat token vocabulary. No `@angular/material` runtime
+ * dependency — pure CSS custom-property declarations.
+ *
+ * Color values from the Material Design 3 spec
+ * (https://m3.material.io/styles/color/the-color-system/tokens).
+ *
+ * Usage in your global stylesheet:
+ *   @import '@threadplane/chat/themes/material-dark.css';
+ */
+:root {
+  /* === Color (M3 dark) === */
+  --a2ui-primary: #D0BCFF;
+  --a2ui-on-primary: #381E72;
+  --a2ui-primary-hover: #B69DF8;
+  --a2ui-secondary: #CCC2DC;
+  --a2ui-on-secondary: #332D41;
+  --a2ui-surface: #1C1B1F;
+  --a2ui-on-surface: #E6E1E5;
+  --a2ui-surface-variant: #49454F;
+  --a2ui-on-surface-variant: #CAC4D0;
+  --a2ui-outline: #938F99;
+  --a2ui-outline-variant: #49454F;
+  --a2ui-error: #F2B8B5;
+  --a2ui-on-error: #601410;
+  --a2ui-scrim: rgba(0, 0, 0, 0.6);
+
+  /* === Shape (M3 favors slightly larger radii) === */
+  --a2ui-shape-extra-small: 4px;
+  --a2ui-shape-small: 8px;
+  --a2ui-shape-medium: 12px;
+  --a2ui-shape-large: 16px;
+  --a2ui-shape-extra-large: 28px;
+}

package/themes/material-light.css

@@ -0,0 +1,45 @@
+/*
+ * @threadplane/chat — Material Design 3 light theme
+ * SPDX-License-Identifier: MIT
+ *
+ * Maps Google's Material Design 3 light color tokens (m3.material.io)
+ * into the @threadplane/chat token vocabulary. No `@angular/material` runtime
+ * dependency — pure CSS custom-property declarations.
+ *
+ * Color values from the Material Design 3 spec
+ * (https://m3.material.io/styles/color/the-color-system/tokens).
+ *
+ * Usage in your global stylesheet:
+ *   @import '@threadplane/chat/themes/material-light.css';
+ */
+:root {
+  /* === Color (M3 light) === */
+  --a2ui-primary: #6750A4;
+  --a2ui-on-primary: #FFFFFF;
+  --a2ui-primary-hover: #533F8E;
+  --a2ui-secondary: #625B71;
+  --a2ui-on-secondary: #FFFFFF;
+  --a2ui-surface: #FFFBFE;
+  --a2ui-on-surface: #1C1B1F;
+  --a2ui-surface-variant: #E7E0EC;
+  --a2ui-on-surface-variant: #49454F;
+  --a2ui-outline: #79747E;
+  --a2ui-outline-variant: #CAC4D0;
+  --a2ui-error: #B3261E;
+  --a2ui-on-error: #FFFFFF;
+  --a2ui-scrim: rgba(0, 0, 0, 0.4);
+
+  /* === Shape (M3 favors slightly larger radii) === */
+  --a2ui-shape-extra-small: 4px;
+  --a2ui-shape-small: 8px;
+  --a2ui-shape-medium: 12px;
+  --a2ui-shape-large: 16px;
+  --a2ui-shape-extra-large: 28px;
+
+  /* === Elevation (softer shadows on light backgrounds) === */
+  --a2ui-elevation-1: 0 1px 2px rgba(0, 0, 0, 0.08);
+  --a2ui-elevation-2: 0 2px 4px rgba(0, 0, 0, 0.10);
+  --a2ui-elevation-3: 0 4px 8px rgba(0, 0, 0, 0.12);
+  --a2ui-elevation-4: 0 8px 16px rgba(0, 0, 0, 0.14);
+  --a2ui-elevation-5: 0 16px 32px rgba(0, 0, 0, 0.16);
+}

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

@@ -0,0 +1,66 @@
+import * as _angular_core from '@angular/core';
+import { Signal } from '@angular/core';
+
+interface DebugAgentCheckpoint {
+    id?: string;
+    label?: string;
+    values?: Record<string, unknown>;
+}
+interface DebugAgent {
+    messages: Signal<unknown[]>;
+    status: Signal<string>;
+    isLoading: Signal<boolean>;
+    error: Signal<unknown>;
+    toolCalls: Signal<unknown[]>;
+    state: Signal<Record<string, unknown>>;
+}
+interface DebugAgentWithHistory extends DebugAgent {
+    history: Signal<DebugAgentCheckpoint[]>;
+}
+
+type DockPosition = 'right' | 'bottom' | 'left';
+interface TabEntry {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: 'builtin-timeline' | 'builtin-state';
+}
+declare class ChatDebugComponent {
+    readonly agent: _angular_core.InputSignal<DebugAgent | DebugAgentWithHistory | null>;
+    readonly dock: _angular_core.InputSignal<DockPosition>;
+    readonly defaultOpen: _angular_core.InputSignal<boolean>;
+    readonly launcher: _angular_core.InputSignal<"floating" | "none">;
+    readonly storageKey: _angular_core.InputSignal<string>;
+    readonly replayRequested: _angular_core.OutputEmitterRef<string>;
+    readonly forkRequested: _angular_core.OutputEmitterRef<string>;
+    readonly openChange: _angular_core.OutputEmitterRef<boolean>;
+    readonly dockChange: _angular_core.OutputEmitterRef<DockPosition>;
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    protected readonly dockState: _angular_core.WritableSignal<DockPosition>;
+    /** Set to `true` the first time the user explicitly clicks a dock button.
+     *  Auto-dock detection becomes a no-op after this flips. Not persisted —
+     *  fresh session = fresh chance for the smart default. */
+    private readonly userDockOverride;
+    protected readonly activeTabId: _angular_core.WritableSignal<string>;
+    protected readonly historyAgent: _angular_core.Signal<DebugAgentWithHistory | null>;
+    private readonly hydrated;
+    /** Reads `agent.status()` reactively for the launcher dot. */
+    protected readonly isStreaming: _angular_core.Signal<boolean>;
+    protected readonly tabs: _angular_core.Signal<TabEntry[]>;
+    protected readonly activeTab: _angular_core.Signal<TabEntry | undefined>;
+    private readonly hostEl;
+    constructor();
+    setOpen(value: boolean): void;
+    setDock(next: DockPosition): void;
+    setActiveTab(id: string): void;
+    protected onEsc(): void;
+    /**
+     * Click-outside dismiss. When the panel is open, any click whose
+     * composed path doesn't include our host element closes the panel.
+     */
+    protected onDocumentClick(event: MouseEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatDebugComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatDebugComponent, "chat-debug", never, { "agent": { "alias": "agent"; "required": false; "isSignal": true; }; "dock": { "alias": "dock"; "required": false; "isSignal": true; }; "defaultOpen": { "alias": "defaultOpen"; "required": false; "isSignal": true; }; "launcher": { "alias": "launcher"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; }, { "replayRequested": "replayRequested"; "forkRequested": "forkRequested"; "openChange": "openChange"; "dockChange": "dockChange"; }, never, never, true, never>;
+}
+
+export { ChatDebugComponent };
+export type { DockPosition };

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

@@ -0,0 +1,39 @@
+import { Agent, AgentCheckpoint, AgentWithHistory, Message } from '@threadplane/chat';
+
+/**
+ * Runs a suite of contract conformance assertions against a factory that
+ * produces a fresh Agent. Adapter packages should call this in their
+ * own test suites to verify the contract is satisfied.
+ */
+declare function runAgentConformance(label: string, factory: () => Agent): void;
+
+/**
+ * Conformance suite for AgentWithHistory implementations.
+ *
+ * Runs the base Agent conformance suite, then verifies the history
+ * signal is present and returns an array of AgentCheckpoint-shaped entries.
+ */
+declare function runAgentWithHistoryConformance(label: string, factory: (seed?: {
+    history?: AgentCheckpoint[];
+}) => AgentWithHistory): void;
+
+declare const REASONING_FIXTURE_MESSAGE_ID = "fixture-msg-1";
+declare const REASONING_FIXTURE_REASONING = "I read the prompt and decided to greet the user.";
+declare const REASONING_FIXTURE_RESPONSE = "Hello!";
+interface AbstractEvent {
+    kind: 'reasoning-start' | 'reasoning-chunk' | 'reasoning-end' | 'text-start' | 'text-chunk' | 'text-end';
+    delta?: string;
+}
+/**
+ * Canonical sequence: reasoning starts, three reasoning chunks, reasoning
+ * ends, text starts, three text chunks, text ends.
+ */
+declare const REASONING_FIXTURE_EVENTS: AbstractEvent[];
+/**
+ * Assertion — common to both adapters. Throws if the produced messages
+ * don't match the shared expectation.
+ */
+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 };