@pluno/product-agent-web 0.1.259 → 0.1.262

package/dist/public/operationRoutes.d.ts

@@ -7,7 +7,7 @@ type PAFunctionKey<T> = {
 }[keyof T] & string;
 type PAPrefixedOperation<TPrefix extends string, TOperation extends string> = `${TPrefix}.${TOperation}`;
 type PASessionEngineOperation = PAPrefixedOperation<"sessionEngine", PAFunctionKey<ProductAgentSessionEngine>>;
-type PARuntimeClientOperation = PAPrefixedOperation<"runtimeClient", PAFunctionKey<ProductAgentRuntimeClient>>;
+type PARuntimeClientOperation = PAPrefixedOperation<"runtimeClient", PAFunctionKey<ProductAgentRuntimeClient> | Extract<keyof ProductAgentRuntimeClient, "recordPromptPresented">>;
 type PAWidgetHandleOperation = PAPrefixedOperation<"widgetHandle", PAFunctionKey<ProductAgentWidgetHandle>>;
 export type PAPublicFacadeOperation = PASessionEngineOperation | PARuntimeClientOperation | PAWidgetHandleOperation | "sdk.init" | "sdk.createProductAgentRuntime" | "widget.createProductAgentPreviewBridgeWebSocketFactory" | "widget.mountPlunoProductAgentWidget";
 export declare const PA_COMPATIBILITY_OPERATION_ROUTES: {
@@ -27,6 +27,7 @@ export declare const PA_COMPATIBILITY_OPERATION_ROUTES: {
     readonly "runtimeClient.destroy": "platform_shell";
     readonly "runtimeClient.warmup": "engine_command";
     readonly "runtimeClient.recordWidgetLifecycle": "platform_shell";
+    readonly "runtimeClient.recordPromptPresented": "engine_command";
     readonly "runtimeClient.sendMessage": "engine_command";
     readonly "runtimeClient.getModel": "projection";
     readonly "runtimeClient.setModel": "engine_command";
@@ -57,6 +58,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.recordPromptPresented": "engine_command";
     readonly "sessionEngine.reportOperationTiming": "platform_shell";
     readonly "sessionEngine.reportResponseVisibility": "platform_shell";
     readonly "sessionEngine.reportDisplayedError": "platform_shell";
@@ -86,6 +88,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.prompt_presented": "engine_command";
     readonly "runtime.report_operation_timing": "platform_shell";
     readonly "runtime.report_response_visibility": "platform_shell";
     readonly "runtime.report_displayed_error": "platform_shell";

package/dist/runtime/composition.d.ts

@@ -1,3 +1,4 @@
+import type { PAStage7Slices, PAStage7Command, PAStage7Effects, PAStage7Ports } from '../core/features/contracts';
 import { type PAActiveUsersState, type PAActiveUsersCommand, type PAActiveUsersEffects } from "../core/active-users/reducer";
 import type { PAEffectHandlers } from "../core/kernel/effects";
 import { type PAModelSelectionState } from "../core/model-selection/state";
@@ -14,8 +15,8 @@ export declare const PA_SLICE_OWNERSHIP: Readonly<{
     readonly directory: "core";
     readonly activeUsers: "core";
     readonly conversation: "core";
-    readonly account: "legacy";
-    readonly interactions: "legacy";
+    readonly account: "core";
+    readonly interactions: "core";
     readonly browserExecution: "legacy";
 }>;
 export type PAProductSlice = keyof typeof PA_SLICE_OWNERSHIP;
@@ -24,16 +25,16 @@ export type PAOwnerSources<T> = Readonly<{
     core?: () => T;
 }>;
 export declare function selectPAOwner<T>(slice: PAProductSlice, sources: PAOwnerSources<T>): T;
-export type PAClientSlices = Readonly<{
+export type PAClientSlices = PAStage7Slices & Readonly<{
     modelSelection: PAModelSelectionState;
     directory: PADirectoryState;
     conversation: PAConversationState;
     activeUsers: PAActiveUsersState;
 }>;
-export type PAClientCommand = PAModelCommand | PADirectoryCommand | PAConversationCommand | PAActiveUsersCommand;
+export type PAClientCommand = PAStage7Command | PAModelCommand | PADirectoryCommand | PAConversationCommand | PAActiveUsersCommand;
 export type PAClientEvent = PAModelEvent | PADirectoryEvent | PAConversationEvent;
-type PAClientEffects = PADirectoryEffects & PAConversationEffects & PAActiveUsersEffects;
-export type PAClientProjection = Readonly<{
+type PAClientEffects = PAStage7Effects & PADirectoryEffects & PAConversationEffects & PAActiveUsersEffects;
+export type PAClientProjection = PAStage7Slices & Readonly<{
     modelSelection: PAModelSelectionState;
     directory: PADirectoryProjection;
     conversation: ReturnType<typeof selectConversation>;
@@ -43,9 +44,11 @@ export declare class PAClientRuntime {
     readonly engine: PAEngine<PAEngineState<PAClientSlices>, PAClientCommand, PAClientEvent, PAClientEffects, PAClientProjection>;
     private readonly disposeListeners;
     private conversationPorts;
-    constructor(directoryPorts?: PADirectoryPorts, conversationPorts?: Partial<PAConversationPorts>, activeUsersPorts?: PAEffectHandlers<PAActiveUsersEffects>);
+    private featurePorts;
+    constructor(directoryPorts?: PADirectoryPorts, conversationPorts?: Partial<PAConversationPorts>, activeUsersPorts?: PAEffectHandlers<PAActiveUsersEffects>, stage7Ports?: Partial<PAStage7Ports>);
     private disposed;
     installConversationPorts(ports: PAConversationPorts): void;
+    installFeaturePorts(ports: Partial<PAStage7Ports>): void;
     get isDisposed(): boolean;
     route<T>(slice: PAProductSlice, sources: PAOwnerSources<T>): T;
     project<T>(slice: PAProductSlice, sources: PAOwnerSources<T>): T;

package/dist/runtimeClient.d.ts

@@ -9,6 +9,10 @@ import { type ProductAgentEntityQueryData, type ProductAgentQueryState } from ".
 export type ProductAgentRuntimeEventName = keyof ProductAgentEventMap;
 export type ProductAgentRuntimeCommand = {
     type: "runtime.connect";
+} | {
+    type: "runtime.prompt_presented";
+    feature: "notifications" | "tab_grouping";
+    openingGeneration: number;
 } | {
     type: "runtime.report_operation_timing";
     timing: OperationTiming;
@@ -71,8 +75,11 @@ export type ProductAgentRuntimeCommand = {
     interactionId: string;
     action: ProductAgentInteractionAction;
     expectedRevision: number;
+    expectedSourceVersion?: number | null;
     snoozeUntil?: string;
     feedback?: string;
+    taskIndex?: number;
+    sharePlatform?: "linkedin" | "x" | "instagram";
 } | {
     type: "conversation.stage_proactive_suggestion";
     question: string;
@@ -127,6 +134,7 @@ export type ProductAgentRuntimeClient = {
     reportInvalidStateTransition?(reason: string, clientMessageId?: string, uiInvariant?: UiInvariantEvidence): void;
     reportDisplayedError?(reason: string, errorFingerprint: string, displayedMessage?: string, renderedError?: RenderedErrorEvidence, historyRefreshFailure?: HistoryRefreshFailure): void;
     warmup(reason?: "panel_open" | "extension_install" | "composer_input"): void;
+    recordPromptPresented?(feature: "notifications" | "tab_grouping", openingGeneration: number): void;
     recordWidgetLifecycle(action: ProductAgentWidgetLifecycleAction, trigger: ProductAgentWidgetLifecycleTrigger): void;
     sendMessage(content: string, options?: {
         attachments?: ProductAgentAttachment[];
@@ -161,6 +169,9 @@ export type ProductAgentRuntimeClient = {
     actOnInteraction(interactionId: string, action: ProductAgentInteractionAction, expectedRevision: number, input?: {
         feedback?: string;
         snoozeUntil?: string;
+        expectedSourceVersion?: number | null;
+        taskIndex?: number;
+        sharePlatform?: 'linkedin' | 'x' | 'instagram';
     }): Promise<void>;
     getAccount(): ProductAgentAccountProjection | null;
     subscribeAccount(listener: (account: ProductAgentAccountProjection | null) => void): () => void;
@@ -196,6 +207,7 @@ export declare class ProductAgentRemoteRuntimeClient implements ProductAgentRunt
     connect(): Promise<void>;
     destroy(): void;
     warmup(reason?: "panel_open" | "extension_install" | "composer_input"): Promise<void>;
+    recordPromptPresented(feature: "notifications" | "tab_grouping", openingGeneration: number): void;
     recordWidgetLifecycle(action: ProductAgentWidgetLifecycleAction, trigger: ProductAgentWidgetLifecycleTrigger): void;
     reportOperationTiming(timing: OperationTiming): void;
     reportResponseVisibility(observation: ResponseVisibilityObservation): void;
@@ -236,6 +248,9 @@ export declare class ProductAgentRemoteRuntimeClient implements ProductAgentRunt
     actOnInteraction(interactionId: string, action: ProductAgentInteractionAction, expectedRevision: number, input?: {
         feedback?: string;
         snoozeUntil?: string;
+        expectedSourceVersion?: number | null;
+        taskIndex?: number;
+        sharePlatform?: 'linkedin' | 'x' | 'instagram';
     }): Promise<void>;
     getAccount(): ProductAgentAccountProjection | null;
     subscribeAccount(listener: (account: ProductAgentAccountProjection | null) => void): () => void;

package/dist/runtimeState.d.ts

@@ -1,3 +1,5 @@
+import type { ProductAgentSubmissionGate, ProductAgentAccountProjection } from "./core/account/presentation";
+export type { ProductAgentSafeUser, ProductAgentSafeWorkspace, ProductAgentAuthProjection, ProductAgentSubmissionGate, ProductAgentAccountProjection } from "./core/account/presentation";
 export type ProductAgentQueryStatus = "not_requested" | "loading" | "ready" | "refreshing" | "loading_more" | "error";
 export type ProductAgentQueryState<T> = {
     key: string;
@@ -62,7 +64,7 @@ export type ProductAgentInteractionScope = {
     key: string;
 };
 export type ProductAgentInteractionStatus = "scheduled" | "presentable" | "pending" | "snoozed" | "resolved" | "suppressed" | "expired" | "error";
-export type ProductAgentInteractionAction = ProductAgentPromptAction | "enable" | "run" | "edit" | "connect" | "submit_feedback";
+export type ProductAgentInteractionAction = ProductAgentPromptAction | "enable" | "run" | "edit" | "connect" | "submit_feedback" | "not_now" | "dont_enable" | "allow" | "pair" | "copy" | "share" | "feedback";
 export type ProductAgentInteractionPresentation = {
     title: string | null;
     body: string;
@@ -74,6 +76,9 @@ export type ProductAgentInteraction<TKind extends string = string, TPayload = un
     category: string;
     scope: ProductAgentInteractionScope;
     payload: TPayload;
+    placement?: "turn" | "bottom_overlay" | "welcome";
+    userMessageId?: string | null;
+    sourceVersion?: number | null;
     presentation: ProductAgentInteractionPresentation;
     eligible: boolean;
     status: ProductAgentInteractionStatus;
@@ -97,55 +102,7 @@ export declare function resolveProductAgentWidgetPresentation(input: {
     minimized: boolean;
     open: boolean;
 }): ProductAgentWidgetPresentation;
-export type ProductAgentSafeUser = {
-    id: string;
-    email: string | null;
-    name: string | null;
-};
-export type ProductAgentSafeWorkspace = {
-    id: string;
-    name: string | null;
-};
-export type ProductAgentAuthProjection = {
-    status: "anonymous" | "checking";
-    user: null;
-    workspace: null;
-} | {
-    status: "refreshing";
-    user: ProductAgentSafeUser;
-    workspace: ProductAgentSafeWorkspace | null;
-} | {
-    status: "authenticated";
-    user: ProductAgentSafeUser;
-    workspace: ProductAgentSafeWorkspace | null;
-} | {
-    status: "error";
-    user: null;
-    workspace: null;
-    errorCode: string;
-    message: string;
-};
-export type ProductAgentSubmissionGate = {
-    allowed: boolean;
-    reason: "allowed" | "authentication_required" | "workspace_required" | "connection_required" | "onboarding_required" | "credits_exhausted" | "payment_issue" | "update_required";
-    actions: readonly ("login" | "create_workspace" | "complete_onboarding" | "earn_credits" | "upgrade" | "update")[];
-};
-export type ProductAgentAccountProjection = {
-    auth?: ProductAgentAuthProjection;
-    actionUrls?: Partial<Record<ProductAgentSubmissionGate["actions"][number], string>>;
-    creditsUsed: number | null;
-    creditLimit: number | null;
-    creditsRemaining: number | null;
-    limitExceeded: boolean;
-    paymentIssue: string | null;
-    pricingUrl: string;
-    earnCreditsUrl: string;
-    onboardingIncomplete?: boolean;
-    onboardingUrl?: string;
-    usingPaidCreditFallback?: boolean;
-    submissionGate?: ProductAgentSubmissionGate;
-};
-export declare function reconcileProductAgentSubmissionGate(gate: ProductAgentSubmissionGate | undefined, errorCode: string | null | undefined): ProductAgentSubmissionGate;
+export { reconcileProductAgentSubmissionGate } from './core/account/presentation';
 export declare function hasProductAgentPaidCreditFallback(metadata: unknown): boolean;
 export type ProductAgentBillingPresentation = {
     state: "hidden";
@@ -186,4 +143,3 @@ export declare function resolveProductAgentComposerAction(input: {
 }): 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/themeColors.d.ts

@@ -0,0 +1,7 @@
+export type Rgb = [number, number, number];
+export declare function hexToRgb(hex: string): Rgb;
+export declare function rgbToHex([r, g, b]: Rgb): string;
+export declare function mix(a: Rgb, b: Rgb, weightB: number): Rgb;
+export declare function rgba([r, g, b]: Rgb, alpha: number): string;
+export declare function ensureAccentContrast(accent: Rgb, bg: Rgb, colorScheme: "light" | "dark", fg: Rgb): Rgb;
+export declare function readableOn(color: Rgb): Rgb;

package/dist/uiFlightRecorder.d.ts

@@ -2,35 +2,8 @@ import { type OperationTiming } from "./operationTiming";
 import { type UiInvariantEvidence } from "./renderDiagnostics";
 import type { ResponseVisibilityObservation } from "./index";
 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[];
-};
+import type { UiFlightEvidence } from "./core/features/uiFlightEvidence";
+export type { UiFlightRecord, UiFlightEvidence } from "./core/features/uiFlightEvidence";
 export type UiFlightRecorder = {
     snapshot(): UiFlightEvidence;
     dispose(): void;

package/package.json

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

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

@@ -1,11 +0,0 @@
-import type { PAConversationPorts } from "../../core/conversation/contracts";
-import type { PADirectoryAuthority } from "../../core/session-directory/contracts";
-import type { ProductAgentInteractionManager } from "../../interactionManager";
-import type { PAClientRuntime } from "../../runtime/composition";
-export declare function createConversationInteractionPort(options: {
-    authority: PADirectoryAuthority;
-    runtime: () => PAClientRuntime;
-    manager: ProductAgentInteractionManager;
-    invalidateAuth: (requestId: string) => void;
-    notify: () => void;
-}): PAConversationPorts["conversation.interactions"];