@pluno/product-agent-web 0.1.229 → 0.1.232

package/dist/protocolTrace.d.ts

@@ -0,0 +1,3 @@
+type TraceData = Record<string, string | number | boolean | null>;
+export declare function summarizeCanonicalDisplayEvent(event: Record<string, unknown>): TraceData;
+export {};

package/dist/public/operationRoutes.d.ts

@@ -57,6 +57,7 @@ export declare const PA_COMPATIBILITY_OPERATION_ROUTES: {
     readonly "sessionEngine.destroy": "platform_shell";
     readonly "sessionEngine.warmup": "engine_command";
     readonly "sessionEngine.recordWidgetLifecycle": "platform_shell";
+    readonly "sessionEngine.reportOperationTiming": "platform_shell";
     readonly "sessionEngine.reportResponseVisibility": "platform_shell";
     readonly "sessionEngine.reportDisplayedError": "platform_shell";
     readonly "sessionEngine.reportInvalidStateTransition": "platform_shell";
@@ -85,6 +86,7 @@ export declare const PA_COMPATIBILITY_OPERATION_ROUTES: {
     readonly "runtime.connect": "engine_command";
     readonly "runtime.warmup": "engine_command";
     readonly "runtime.widget_lifecycle": "platform_shell";
+    readonly "runtime.report_operation_timing": "platform_shell";
     readonly "runtime.report_response_visibility": "platform_shell";
     readonly "runtime.report_displayed_error": "platform_shell";
     readonly "runtime.report_invalid_state_transition": "platform_shell";

package/dist/renderDiagnostics.d.ts

@@ -0,0 +1,31 @@
+import type { ProductAgentState } from "./index";
+import type { UiInvariantSnapshot } from "./uiInvariants";
+export type RenderedErrorEvidence = {
+    sessionId: string | null;
+    itemId: string;
+    userMessageId: string | null;
+    createdAt: string | null;
+    runId: string | null;
+    retryable?: boolean;
+};
+export type UiStructureEvidence = {
+    sessionId: string | null;
+    messageKeys: string[];
+    canonicalItemKeys: string[];
+    terminalResponseKeys: string[];
+    toolCallKeys: string[];
+    activeResponseKeys: string[];
+    thinkingSequence?: ("user" | "thinking")[];
+    runtimeItemCount: number;
+    welcome: boolean;
+    truncated: boolean;
+};
+export type UiInvariantEvidence = {
+    before: UiStructureEvidence | null;
+    current: UiStructureEvidence;
+};
+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 isUiInvariantEvidence(value: unknown): value is UiInvariantEvidence;

package/dist/responseDiagnostics.d.ts

@@ -5,6 +5,7 @@ export declare function getResponseVisibility(owner: object, surface: string, se
 export declare function buildResponseDiagnostics(owner: object, surface: string, sessionId: string | null, clientMessageId: string | undefined, authenticated: boolean, activeClientMessageId: string | null, pendingClientMessageId: string | null, items: ReadonlyArray<{
     id: string;
     role?: string;
+    dataType?: string;
     clientMessageId?: string;
     respondsToUserMessageId?: string;
 }>, draftRespondsToUserMessageId?: string | null, hasDraft?: boolean): ResponseDiagnostics;

package/dist/runtime/composition.d.ts

@@ -6,12 +6,14 @@ import type { PAModelEvent } from "../core/model-selection/events";
 import type { PAEngineState } from "../core/kernel/state";
 import type { PADirectoryCommand, PADirectoryEffects, PADirectoryEvent, PADirectoryPorts, PADirectoryState, PADirectoryProjection } from "../core/session-directory/contracts";
 import { PAEngine } from "./engine";
+import type { PAConversationCommand, PAConversationEffects, PAConversationEvent, PAConversationPorts, PAConversationState } from "../core/conversation/contracts";
+import { selectConversation } from "../core/conversation/selectors";
 export type PASliceOwner = "legacy" | "core";
 export declare const PA_SLICE_OWNERSHIP: Readonly<{
     readonly modelSelection: "core";
     readonly directory: "core";
     readonly activeUsers: "core";
-    readonly conversation: "legacy";
+    readonly conversation: "core";
     readonly account: "legacy";
     readonly interactions: "legacy";
     readonly browserExecution: "legacy";
@@ -25,23 +27,29 @@ export declare function selectPAOwner<T>(slice: PAProductSlice, sources: PAOwner
 export type PAClientSlices = Readonly<{
     modelSelection: PAModelSelectionState;
     directory: PADirectoryState;
+    conversation: PAConversationState;
     activeUsers: PAActiveUsersState;
 }>;
-export type PAClientCommand = PAModelCommand | PADirectoryCommand | PAActiveUsersCommand;
-export type PAClientEvent = PAModelEvent | PADirectoryEvent;
+export type PAClientCommand = PAModelCommand | PADirectoryCommand | PAConversationCommand | PAActiveUsersCommand;
+export type PAClientEvent = PAModelEvent | PADirectoryEvent | PAConversationEvent;
+type PAClientEffects = PADirectoryEffects & PAConversationEffects & PAActiveUsersEffects;
 export type PAClientProjection = Readonly<{
     modelSelection: PAModelSelectionState;
     directory: PADirectoryProjection;
+    conversation: ReturnType<typeof selectConversation>;
     activeUsers: PAActiveUsersState;
 }>;
 export declare class PAClientRuntime {
-    readonly engine: PAEngine<PAEngineState<PAClientSlices>, PAClientCommand, PAClientEvent, PADirectoryEffects & PAActiveUsersEffects, PAClientProjection>;
+    readonly engine: PAEngine<PAEngineState<PAClientSlices>, PAClientCommand, PAClientEvent, PAClientEffects, PAClientProjection>;
     private readonly disposeListeners;
-    constructor(directoryPorts?: PADirectoryPorts, activeUsersPorts?: PAEffectHandlers<PAActiveUsersEffects>);
+    private conversationPorts;
+    constructor(directoryPorts?: PADirectoryPorts, conversationPorts?: Partial<PAConversationPorts>, activeUsersPorts?: PAEffectHandlers<PAActiveUsersEffects>);
     private disposed;
+    installConversationPorts(ports: PAConversationPorts): void;
     get isDisposed(): boolean;
     route<T>(slice: PAProductSlice, sources: PAOwnerSources<T>): T;
     project<T>(slice: PAProductSlice, sources: PAOwnerSources<T>): T;
     onDispose(listener: () => void): () => void;
     dispose(): void;
 }
+export {};

package/dist/runtime/modelSelection.d.ts

@@ -9,6 +9,6 @@ export declare const getRuntimeModelScope: (runtime: PAClientRuntime, clientScop
     submissions: Readonly<Record<string, import("../core/model-selection/state").PAModelSubmission>>;
 }>;
 export declare const getRuntimeModel: (runtime: PAClientRuntime, clientScopeId: PAClientScopeId) => "anthropic/claude-opus-5" | "anthropic/claude-sonnet-5" | "deepseek/deepseek-chat-v3.1" | "deepseek/deepseek-v4-flash" | "gpt-5.4-nano" | "gpt-5.4-mini" | "gpt-5.4" | "gpt-5.6-luna" | "gpt-5.6-terra" | "gpt-5.6-sol" | undefined;
-export declare function captureRequestedModel(runtime: PAClientRuntime, clientScopeId: PAClientScopeId, clientMessageId: string, requestedModel?: PAProductAgentModel): PAProductAgentModel | undefined;
+export declare function captureRequestedModel(runtime: PAClientRuntime, clientScopeId: PAClientScopeId, clientMessageId: string, requestedModel?: PAProductAgentModel | null): PAProductAgentModel | undefined;
 export declare function acceptModelRouting(runtime: PAClientRuntime, clientScopeId: PAClientScopeId, sessionId: string, clientMessageId: string, value: unknown, updatedAt?: string): void;
 export declare function hydrateModelRouting(runtime: PAClientRuntime, clientScopeId: PAClientScopeId, sessionId: string, turns: unknown): void;

package/dist/runtime.d.ts

@@ -1,5 +1,5 @@
-export { createProductAgentQueryState, mergeProductAgentEntityPages, normalizeProductAgentEntityPage, ProductAgentQueryController, reconcileProductAgentSubmissionGate, resolveProductAgentComposerAction, resolveProductAgentBillingPresentation, resolveProductAgentWidgetPresentation, hasProductAgentPaidCreditFallback, selectProductAgentQueryEntities, } from "./runtimeState";
-export type { ProductAgentAuthProjection, ProductAgentComposerAction, ProductAgentEntity, ProductAgentEntityPage, ProductAgentEntityQueryData, ProductAgentInteraction, ProductAgentInteractionAction, ProductAgentInteractionPresentation, ProductAgentInteractionScope, ProductAgentInteractionStatus, ProductAgentPromptAction, ProductAgentPromptDecision, ProductAgentPromptDecisionScope, ProductAgentQueryLoadMode, ProductAgentQueryState, ProductAgentQueryStatus, ProductAgentSafeUser, ProductAgentSafeWorkspace, ProductAgentSubmissionGate, ProductAgentWidgetPresentation, } from "./runtimeState";
+export { createProductAgentQueryState, mergeProductAgentEntityPages, normalizeProductAgentEntityPage, ProductAgentQueryController, reconcileProductAgentSubmissionGate, resolveProductAgentComposerAction, canSubmitPersonalProductAgentMessage, isProductAgentAuthReconnectError, PRODUCT_AGENT_AUTH_RECONNECTING_ERROR_MESSAGE, resolveProductAgentBillingPresentation, resolveProductAgentWidgetPresentation, hasProductAgentPaidCreditFallback, selectProductAgentQueryEntities, } from "./runtimeState";
+export type { ProductAgentAuthProjection, ProductAgentSubmissionContext, ProductAgentComposerAction, ProductAgentEntity, ProductAgentEntityPage, ProductAgentEntityQueryData, ProductAgentInteraction, ProductAgentInteractionAction, ProductAgentInteractionPresentation, ProductAgentInteractionScope, ProductAgentInteractionStatus, ProductAgentPromptAction, ProductAgentPromptDecision, ProductAgentPromptDecisionScope, ProductAgentQueryLoadMode, ProductAgentQueryState, ProductAgentQueryStatus, ProductAgentSafeUser, ProductAgentSafeWorkspace, ProductAgentSubmissionGate, ProductAgentWidgetPresentation, } from "./runtimeState";
 export { ProductAgentSessionHistoryManager } from "./sessionHistoryState";
 export type { ProductAgentSessionHistoryEntity, ProductAgentSessionHistoryLoader, ProductAgentSessionHistoryPage, } from "./sessionHistoryState";
 export { createLocalStorageInteractionDecisionStorage, ProductAgentInteractionManager, readLocalStorageInteractionDecisions, } from "./interactionManager";

package/dist/runtimeClient.d.ts

@@ -1,9 +1,14 @@
+import { type OperationTiming } from "./operationTiming";
+import { type RenderedErrorEvidence, type UiInvariantEvidence } from "./renderDiagnostics";
 import type { ResponseVisibilityObservation, ProductAgentAttachment, ProductAgentEventMap, ProductAgentInvocation, ProductAgentModel, ProductAgentSessionHistoryPage, ProductAgentSessionHistoryEntry, ProductAgentState, ProductAgentWidgetLifecycleAction, ProductAgentWidgetLifecycleTrigger } from "./index";
 import type { ProductAgentAccountProjection, ProductAgentInteraction, ProductAgentInteractionAction } from "./runtimeState";
 import { type ProductAgentEntityQueryData, type ProductAgentQueryState } from "./runtimeState";
 export type ProductAgentRuntimeEventName = keyof ProductAgentEventMap;
 export type ProductAgentRuntimeCommand = {
     type: "runtime.connect";
+} | {
+    type: "runtime.report_operation_timing";
+    timing: OperationTiming;
 } | {
     type: "runtime.report_response_visibility";
     observation: ResponseVisibilityObservation;
@@ -12,8 +17,10 @@ export type ProductAgentRuntimeCommand = {
     reason: string;
     errorFingerprint: string;
     displayedMessage?: string;
+    renderedError?: RenderedErrorEvidence;
 } | {
     type: "runtime.report_invalid_state_transition";
+    uiInvariant?: UiInvariantEvidence;
     reason: string;
     clientMessageId?: string;
 } | {
@@ -65,6 +72,9 @@ export type ProductAgentRuntimeCommand = {
     clientMessageId: string;
 } | {
     type: "conversation.stage";
+    initiatedBy?: "pluno";
+    invocation?: ProductAgentInvocation | "pluno";
+    automationOnboarding?: boolean;
     requestedModel?: ProductAgentModel;
     content: string;
     clientMessageId: string;
@@ -104,9 +114,10 @@ export type ProductAgentRuntimeClient = {
     getState(): ProductAgentState;
     connect(): Promise<void>;
     destroy(): void;
+    reportOperationTiming?(timing: OperationTiming): void;
     reportResponseVisibility?(observation: ResponseVisibilityObservation): void;
-    reportInvalidStateTransition?(reason: string, clientMessageId?: string): void;
-    reportDisplayedError?(reason: string, errorFingerprint: string, displayedMessage?: string): void;
+    reportInvalidStateTransition?(reason: string, clientMessageId?: string, uiInvariant?: UiInvariantEvidence): void;
+    reportDisplayedError?(reason: string, errorFingerprint: string, displayedMessage?: string, renderedError?: RenderedErrorEvidence): void;
     warmup(reason?: "panel_open" | "extension_install" | "composer_input"): void;
     recordWidgetLifecycle(action: ProductAgentWidgetLifecycleAction, trigger: ProductAgentWidgetLifecycleTrigger): void;
     sendMessage(content: string, options?: {
@@ -162,9 +173,11 @@ export declare class ProductAgentRemoteRuntimeClient implements ProductAgentRunt
     private interactions;
     private account;
     private stagedProactiveSuggestionClientMessageId;
-    private readonly unacknowledgedSubmissions;
+    private readonly pendingTransfers;
+    private readonly submissionPreviews;
     private submissionGeneration;
-    private stoppedProjection;
+    private pendingStop;
+    private stopError;
     private operationQueue;
     private destroyed;
     constructor(initialState: ProductAgentState, adapter: ProductAgentRuntimeClientAdapter, model?: ProductAgentModel);
@@ -175,9 +188,10 @@ export declare class ProductAgentRemoteRuntimeClient implements ProductAgentRunt
     destroy(): void;
     warmup(reason?: "panel_open" | "extension_install" | "composer_input"): Promise<void>;
     recordWidgetLifecycle(action: ProductAgentWidgetLifecycleAction, trigger: ProductAgentWidgetLifecycleTrigger): void;
+    reportOperationTiming(timing: OperationTiming): void;
     reportResponseVisibility(observation: ResponseVisibilityObservation): void;
-    reportInvalidStateTransition(reason: string, clientMessageId?: string): void;
-    reportDisplayedError(reason: string, errorFingerprint: string, displayedMessage?: string): void;
+    reportInvalidStateTransition(reason: string, clientMessageId?: string, uiInvariant?: UiInvariantEvidence): void;
+    reportDisplayedError(reason: string, errorFingerprint: string, displayedMessage?: string, renderedError?: RenderedErrorEvidence): void;
     sendMessage(content: string, options?: {
         attachments?: ProductAgentAttachment[];
         clientMessageId?: string;

package/dist/runtimeState.d.ts

@@ -160,6 +160,19 @@ export type ProductAgentBillingPresentation = {
     state: "usage";
 };
 export declare function resolveProductAgentBillingPresentation(account: ProductAgentAccountProjection | null | undefined): ProductAgentBillingPresentation;
+export type ProductAgentSubmissionContext = {
+    currentPageResolved: boolean;
+    isWebsiteBlocked: boolean;
+};
+export declare function canSubmitPersonalProductAgentMessage(input: {
+    submissionAllowed: boolean;
+    isAuthenticated: boolean;
+    hasWorkspace: boolean;
+    isWebsiteBlocked: boolean;
+    isCurrentPageResolved: boolean;
+    isSubmitting: boolean;
+    hasPendingMessage: boolean;
+}): boolean;
 export type ProductAgentComposerAction = {
     action: "send" | "stop";
     disabled: boolean;
@@ -171,4 +184,6 @@ export declare function resolveProductAgentComposerAction(input: {
     canStopRunningTurn: boolean;
     canSubmitMessage: boolean;
 }): ProductAgentComposerAction;
+export declare const PRODUCT_AGENT_AUTH_RECONNECTING_ERROR_MESSAGE = "Pluno is reconnecting. Try again in a moment.";
+export declare function isProductAgentAuthReconnectError(error: unknown): boolean;
 export {};

package/dist/shareCard.d.ts

@@ -11,6 +11,7 @@ export type ProductAgentShareSessionItem = {
     data: unknown;
 };
 export type ProductAgentShareCandidate = {
+    variant?: ProductAgentSharePromptVariant;
     id: string;
     userPrompt: string;
     assistantAnswer: string;

package/dist/uiFlightRecorder.d.ts

@@ -1,3 +1,5 @@
+import { type OperationTiming } from "./operationTiming";
+import { type UiInvariantEvidence } from "./renderDiagnostics";
 import type { ResponseVisibilityObservation } from "./index";
 import type { ProductAgentState } from "./index";
 export type UiFlightRecord = {
@@ -39,6 +41,7 @@ export type UiFlightRecorderHost = HTMLElement & {
 export declare function startUiFlightRecorder(host: UiFlightRecorderHost, root: HTMLElement, surface: UiFlightEvidence["surface"], runtime: {
     getState(): ProductAgentState;
     on(event: "state", listener: (state: ProductAgentState) => void): () => void;
+    reportOperationTiming?(timing: OperationTiming): void;
     reportResponseVisibility?(observation: ResponseVisibilityObservation): void;
-    reportInvalidStateTransition?(reason: string, clientMessageId?: string): void;
+    reportInvalidStateTransition?(reason: string, clientMessageId?: string, evidence?: UiInvariantEvidence): void;
 }): UiFlightRecorder;

package/dist/uiInvariants.d.ts

@@ -13,10 +13,12 @@ export type UiInvariantSnapshot = {
     thinkingIdleMs?: number;
     inProgress?: boolean;
     hasComposerText?: boolean;
+    hasComposerAttachment?: boolean;
     enabledStopControlCount?: number;
     stopPendingMs?: number;
 };
 declare const INVARIANT_MESSAGES: {
+    readonly "stop-without-rendered-message": "Stop is enabled while no message is rendered or the welcome screen is still visible.";
     readonly "in-progress-stop-unavailable": "An in-progress response has no visible enabled interrupt control.";
     readonly "stop-did-not-interrupt": "The stopped response remained in progress after an interrupt click.";
     readonly "duplicate-message-item": "A canonical message rendered more than once.";

package/package.json

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