@pluno/product-agent-web 0.1.246 → 0.1.248

package/INTEGRATION.md

@@ -32,6 +32,11 @@ Content-Type: application/json
 }
 ```
 
+Set `metadata.user_id` from the authenticated user on your server. Strings and integers are accepted;
+`24207` and `"24207"` identify the same customer within this integration. Keep the value stable across
+browsers and token refreshes. Omit it only for anonymous chat. Null, booleans, floats, empty strings,
+arrays, and objects are rejected with HTTP 422. Browser widget metadata cannot override this identity.
+
 Pluno returns:
 
 ```json
@@ -135,3 +140,15 @@ the hosted module explicitly own the returned widget handle and should call `des
 - The runtime validates the browser WebSocket `Origin` header against the token origin.
 - Network capture is always installed by the SDK/widget, shared across instances, and removed after final teardown. There is intentionally no configuration or opt-out for now.
 - Browser-side redaction runs before network events and tool results are sent to Pluno.
+
+## Connection recovery
+
+Use `tokenEndpoint` with the widget, or `tokenProvider` with the SDK, so expired tokens can refresh.
+Temporary failures retry automatically for up to two minutes. The widget preserves the current conversation
+and unsent draft, then offers **Try again** if recovery cannot complete. Setup/access refusals stop retries
+and explain whether the user should sign in again or contact their app administrator. After fixing the cause,
+click **Try again**; remounting the widget is unnecessary.
+
+Diagnostics include SDK version, connection attempt, failure stage, HTTP status/classification, and recovery
+outcome. Pending startup diagnostics are bounded and delivered after authenticated recovery. They do not
+include token endpoint response bodies, credentials, draft text, or conversation content.

package/dist/adapters/web/directoryAdapters.d.ts

@@ -41,6 +41,7 @@ export type PADirectoryRecoveryHandles = {
 export declare class ProductAgentDirectoryObservationAdapter {
     private readonly options;
     private readonly queryRequests;
+    private readonly queryRetries;
     private readonly queryWaiters;
     private readonly refreshAfterRequest;
     private readonly observations;

package/dist/core/session-directory/contracts.d.ts

@@ -40,7 +40,7 @@ export type PADirectoryAuthority = Readonly<{
     generation: number;
 }>;
 export type PADirectoryQuery = Readonly<{
-    kind: "recent" | "pinned";
+    kind: "recent" | "pinned" | "all";
     origin: string | null;
     limit: number;
 }>;
@@ -52,6 +52,7 @@ export type PADirectoryQueryState = PAQueryState<string, readonly PASessionId[]>
     startedAtMetadataRevision: number;
     startedAtActivityRevisionBySessionId: Readonly<Record<string, number>>;
     pageData: readonly PASessionId[];
+    consecutiveFailures: number;
 }>;
 export type PADirectoryPatch = Readonly<{
     title?: string;
@@ -135,6 +136,7 @@ export type PADirectoryCommand = PADirectoryAuthority & (Readonly<{
     requestId: PARequestId;
     mode: "replace" | "append";
     cursor?: string | null;
+    resetRecovery?: boolean;
 }> | Readonly<{
     type: "directory.invalidate";
 }> | Readonly<{

package/dist/core/session-directory/state.d.ts

@@ -4,3 +4,5 @@ export declare function createDirectoryState(): PADirectoryState;
 export declare function directoryQueryKey(query: PADirectoryQuery): string;
 export declare function selectDirectoryPagesForOrigin(queries: Readonly<Record<string, PADirectoryQueryState>>, origin: string | null): readonly PADirectoryQueryState[];
 export declare function selectCombinedDirectoryPage(pages: readonly PADirectoryQueryState[]): PADirectoryQueryState | undefined;
+export declare function selectDirectorySessionIds(pages: readonly PADirectoryQueryState[]): import("..").PASessionId[];
+export declare function canRetryDirectoryQuery(query: PADirectoryQueryState): boolean;

package/dist/index.d.ts

@@ -318,6 +318,10 @@ export declare class ProductAgentSessionEngine {
     private socketConnectTimer;
     private socketAuthTimer;
     private reconnectAttempts;
+    private embeddedRecoveryTimer;
+    private recoveryDiagnosticId;
+    private rejectedDiagnosticsToken;
+    private lastRecoveryStage;
     private connectionAttemptId;
     private connectionInProgress;
     private token;
@@ -474,6 +478,9 @@ export declare class ProductAgentSessionEngine {
     private executeRuntimeHelper;
     private enableNetworkCapture;
     private enqueueNetworkEvent;
+    private startEmbeddedRecoveryBudget;
+    private clearEmbeddedRecoveryBudget;
+    private connectionFailureDiagnostic;
     private scheduleReconnect;
     private replaceDefaultTransportCredentials;
     private stopAuthentication;