@pluno/product-agent-web 0.1.209 → 0.1.210

package/dist/uiFlightRecorder.d.ts

@@ -0,0 +1,42 @@
+import type { ProductAgentState } from "./index";
+export type UiFlightRecord = {
+    sequence: number;
+    occurred_at: string;
+    monotonic_ms: number;
+    kind: "runtime" | "paint" | "click" | "submit" | "focus";
+    action: "new_chat" | "send" | "stop" | "retry" | null;
+    session_id: string | null;
+    run_id: string | null;
+    item_keys: string[];
+    item_count: number;
+    items_truncated: boolean;
+    thinking: boolean;
+    loading: boolean;
+    welcome: boolean;
+    error: boolean;
+    connected: boolean;
+    visible: boolean;
+    output_length: number;
+    active_count: number;
+    terminal_count: number;
+};
+export type UiFlightEvidence = {
+    schema_version: 1;
+    surface: "extension_sidepanel" | "extension_widget" | "main_web_chat" | "embedded_widget";
+    recorder_id: string;
+    sdk_version: string;
+    dropped_records: number;
+    records: UiFlightRecord[];
+};
+export type UiFlightRecorder = {
+    snapshot(): UiFlightEvidence;
+    dispose(): void;
+};
+export type UiFlightRecorderHost = HTMLElement & {
+    __plunoUiFlightRecorder?: UiFlightRecorder;
+};
+export declare function startUiFlightRecorder(host: UiFlightRecorderHost, root: HTMLElement, surface: UiFlightEvidence["surface"], runtime: {
+    getState(): ProductAgentState;
+    on(event: "state", listener: (state: ProductAgentState) => void): () => void;
+    reportInvalidStateTransition?(reason: string, clientMessageId?: string): void;
+}): UiFlightRecorder;

package/dist/uiInvariants.d.ts

@@ -0,0 +1,31 @@
+export type UiInvariantSnapshot = {
+    messageKeys: string[];
+    canonicalItemKeys: string[];
+    toolCallKeys: string[];
+    attachmentKeys: string[];
+    terminalResponseKeys: string[];
+    activeResponseKeys: string[];
+    selectedSessionId: string | null;
+    visibleSessionIds: string[];
+    welcome?: boolean;
+    runtimeItemCount?: number;
+};
+declare const INVARIANT_MESSAGES: {
+    readonly "duplicate-message-item": "A canonical message rendered more than once.";
+    readonly "duplicate-canonical-item": "A canonical session item rendered more than once.";
+    readonly "duplicate-tool-call": "A tool call rendered more than once.";
+    readonly "duplicate-attachment": "An attachment rendered more than once.";
+    readonly "duplicate-terminal-outcome": "A response rendered more than one terminal outcome.";
+    readonly "foreign-session-item-visible": "The visible transcript contains state owned by another session.";
+    readonly "terminal-response-reactivated": "A terminal response became active again.";
+    readonly "terminal-history-not-append-only": "An established terminal outcome disappeared or changed order.";
+    readonly "runtime-transcript-not-rendered": "A nonempty runtime transcript is displaying starter prompts.";
+};
+export type UiInvariantFinding = {
+    code: keyof typeof INVARIANT_MESSAGES;
+    message: string;
+};
+export declare function getProactiveQuestionTraceKey(clientMessageId: string | undefined): string | undefined;
+export declare function isUiInvariantReason(reason: unknown): boolean;
+export declare function checkUiInvariants(snapshot: UiInvariantSnapshot, previous?: UiInvariantSnapshot): UiInvariantFinding[];
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluno/product-agent-web",
-  "version": "0.1.209",
+  "version": "0.1.210",
   "description": "Browser SDK and default widget for embedding Pluno Product Agent into customer web apps.",
   "license": "Apache-2.0",
   "type": "module",