@unofficialbox/box-open-elements 0.5.0 → 0.6.0

package/dist/patterns/agent-chat/agent-chat.d.ts

@@ -0,0 +1,75 @@
+import { AgentChatController } from "./controller.js";
+import type { AgentChatTransport } from "./types.js";
+import { BaseElement } from "../../core/index.js";
+/**
+ * The agent conversation surface (opportunity 1 of the component roadmap):
+ * a streaming message thread over the headless `AgentChatController`, with
+ * the two card types that matter more than the bubbles — citation chips
+ * (same contract as `box-timeline` evidence, deep-linking into a preview)
+ * and human-in-the-loop action cards where the agent's proposed action is
+ * approved or rejected inline.
+ *
+ * The composer lives outside the patched thread region, so a streaming
+ * reply never disturbs what the user is typing.
+ */
+export declare class AgentChat extends BaseElement {
+    static readonly tagName: string;
+    static get observedAttributes(): string[];
+    private controller;
+    private ownsController;
+    private pendingStart;
+    private unsubscribeFns;
+    private transportValue;
+    private threadEl;
+    private inputEl;
+    private sendEl;
+    private stopEl;
+    private statusEl;
+    get heading(): string;
+    set heading(value: string);
+    get token(): string | null;
+    set token(value: string | null);
+    /** Display name on agent bubbles. */
+    get agentName(): string;
+    set agentName(value: string);
+    get placeholder(): string;
+    set placeholder(value: string);
+    get transport(): AgentChatTransport | null;
+    set transport(value: AgentChatTransport | null);
+    /**
+     * The live session controller. Assign one to share a conversation with
+     * another surface; otherwise the element creates and owns its own from
+     * `transport` + `token`.
+     */
+    get chatController(): AgentChatController | null;
+    set chatController(value: AgentChatController | null);
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /** Send the composer's contents (or an explicit body) as a user turn. */
+    send(body?: string): Promise<void>;
+    /** Stop the in-flight generation; the partial reply is kept. */
+    stop(): void;
+    private scheduleStart;
+    private startController;
+    private adoptController;
+    private subscribeToController;
+    private teardownController;
+    private citationHtml;
+    private proposalHtml;
+    private messageInnerHtml;
+    /**
+     * Everything about a message except its body text. While this is stable,
+     * a delta only rewrites one text node — so `role="log"` sees no additions
+     * and assistive tech does not re-announce the conversation per token.
+     */
+    private messageSignature;
+    private createMessageNode;
+    /** The streaming hot path: one text-node write, nothing else touched. */
+    private patchBody;
+    protected renderTemplate(): void;
+    protected setupListeners(): void;
+    /** Composer affordances reflect stream state without rebuilding the input. */
+    private syncComposer;
+    protected update(): void;
+}