@pluno/product-agent-web 0.1.233 → 0.1.235

package/dist/renderDiagnostics.d.ts

@@ -1,5 +1,24 @@
 import type { ProductAgentState } from "./index";
 import type { UiInvariantSnapshot } from "./uiInvariants";
+import { type OwnerDiagnostics } from "./runtime/transitionDiagnostics";
+export type UiTransitionContext = {
+    capturedAt: number;
+    selectionKey: string | null;
+    userId: string | null;
+    loading: boolean;
+    draft: boolean;
+    thinking: boolean;
+    connected: boolean;
+    hasError: boolean;
+    phase: string | null;
+    queryStatus: string | null;
+    queryRequestId: string | null;
+    queryUpdatedAt: number | null;
+    renderSource: "state" | "account" | "interactions" | "local" | "sidepanel_layout";
+    selectionFencePending: boolean;
+    guardCreatedAt: number | null;
+    owner?: OwnerDiagnostics;
+};
 export type RenderedErrorEvidence = {
     sessionId: string | null;
     itemId: string;
@@ -9,6 +28,7 @@ export type RenderedErrorEvidence = {
     retryable?: boolean;
 };
 export type UiStructureEvidence = {
+    context?: UiTransitionContext;
     sessionId: string | null;
     messageKeys: string[];
     canonicalItemKeys: string[];
@@ -27,5 +47,5 @@ export type UiInvariantEvidence = {
 export declare function isRenderedErrorEvidence(value: unknown): value is RenderedErrorEvidence;
 export declare function renderedErrorEvidence(state: ProductAgentState, itemId?: string): RenderedErrorEvidence | undefined;
 export declare function uiInvariantEvidence(current: UiInvariantSnapshot, before?: UiInvariantSnapshot): UiInvariantEvidence;
-export declare function captureUiStructure(root: HTMLElement, state: Pick<ProductAgentState, "sessionId" | "messages">): UiStructureEvidence;
+export declare function captureUiStructure(root: HTMLElement, state: Pick<ProductAgentState, "sessionId" | "messages"> & Partial<ProductAgentState>, render?: Partial<Pick<UiTransitionContext, "renderSource" | "selectionFencePending" | "guardCreatedAt">>): UiStructureEvidence;
 export declare function isUiInvariantEvidence(value: unknown): value is UiInvariantEvidence;

package/dist/runtime/engine.d.ts

@@ -1,4 +1,5 @@
 import type { PACommand } from "../core/kernel/commands";
+import { type OwnerDiagnostics } from "./transitionDiagnostics";
 import type { PAEffectHandlers, PAEffectMapShape } from "../core/kernel/effects";
 import type { PADomainEvent, PAEngineEvent } from "../core/kernel/events";
 import type { PAReducer } from "../core/kernel/reducer";
@@ -20,10 +21,19 @@ export declare class PAEngine<TState, TCommand extends PACommand, TDomainEvent e
     private readonly queue;
     private draining;
     private disposed;
+    private diagnosticEffects;
+    private scopedDiagnostics;
+    private diagnostics;
     constructor(options: PAEngineOptions<TState, TCommand, TDomainEvent, TEffectMap, TProjection>);
     dispatch(command: TCommand): Promise<void>;
     accept(event: TDomainEvent): void;
     getState(): TState;
+    recordDiagnosticTransition(value: object, changed?: boolean): void;
+    getDiagnostics(scope?: {
+        clientScopeId: string;
+        scopeId?: string | null;
+        sessionId?: string | null;
+    }): OwnerDiagnostics;
     getProjection(): TProjection;
     subscribe(listener: PAProjectionListener<TProjection>): PAUnsubscribe;
     dispose(): void;

package/dist/runtime/transitionDiagnostics.d.ts

@@ -0,0 +1,35 @@
+export type OwnerTransition = {
+    sequence: number;
+    at: number;
+    type: string;
+    changed: boolean;
+    generation: number | null;
+    sessionId: string | null;
+    scopeId: string | null;
+    requestId: string | null;
+    effectId: string | null;
+    clientScopeId: string | null;
+    reason: string | null;
+    effectKind: string | null;
+    eventType: string | null;
+    itemCount: number | null;
+    removedCount: number | null;
+    projectionReady: boolean | null;
+};
+export type OwnerDiagnostics = {
+    ownerId: string;
+    revision: number;
+    dropped: number;
+    lastIntent?: OwnerTransition | null;
+    lastSelection: OwnerTransition | null;
+    transitions: OwnerTransition[];
+};
+export type ConversationDiagnostics = {
+    owner?: OwnerDiagnostics;
+    queryStatus: string | null;
+    queryRequestId: string | null;
+    queryUpdatedAt: number | null;
+};
+export declare const diagnosticId: (value: unknown) => string | null;
+export declare function isOwnerDiagnostics(value: unknown): value is OwnerDiagnostics;
+export declare function ownerTransition(value: object, sequence: number, changed: boolean): OwnerTransition | null;

package/dist/uiInvariants.d.ts

@@ -1,4 +1,5 @@
 export type UiInvariantSnapshot = {
+    executionKey?: string;
     messageKeys: string[];
     canonicalItemKeys: string[];
     toolCallKeys: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluno/product-agent-web",
-  "version": "0.1.233",
+  "version": "0.1.235",
   "description": "Browser SDK and default widget for embedding Pluno Product Agent into customer web apps.",
   "license": "Apache-2.0",
   "type": "module",
@@ -59,5 +59,8 @@
   },
   "dependencies": {
     "socket.io-client": "4.8.3"
+  },
+  "overrides": {
+    "es-module-lexer": "^3.0.2"
   }
 }