@pluno/product-agent-web 0.1.203 → 0.1.204

package/dist/public/operationRoutes.d.ts

@@ -0,0 +1,99 @@
+import type { ProductAgentSessionEngine } from "../index";
+import type { ProductAgentRuntimeClient } from "../runtimeClient";
+import type { ProductAgentWidgetHandle } from "../widget";
+export type PACompatibilityOperationRoute = "engine_command" | "engine_query" | "projection" | "platform_shell";
+type PAFunctionKey<T> = {
+    [TKey in keyof T]-?: T[TKey] extends (...args: never[]) => unknown ? TKey : never;
+}[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 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: {
+    readonly "sdk.init": "platform_shell";
+    readonly "sdk.createProductAgentRuntime": "platform_shell";
+    readonly "widget.createProductAgentPreviewBridgeWebSocketFactory": "platform_shell";
+    readonly "widget.mountPlunoProductAgentWidget": "platform_shell";
+    readonly "widgetHandle.startNewChat": "engine_command";
+    readonly "widgetHandle.updateAppearance": "platform_shell";
+    readonly "widgetHandle.openPanel": "platform_shell";
+    readonly "widgetHandle.closePanel": "platform_shell";
+    readonly "widgetHandle.updateDisplayState": "platform_shell";
+    readonly "widgetHandle.destroy": "platform_shell";
+    readonly "runtimeClient.on": "projection";
+    readonly "runtimeClient.getState": "projection";
+    readonly "runtimeClient.connect": "engine_command";
+    readonly "runtimeClient.destroy": "platform_shell";
+    readonly "runtimeClient.warmup": "engine_command";
+    readonly "runtimeClient.recordWidgetLifecycle": "platform_shell";
+    readonly "runtimeClient.sendMessage": "engine_command";
+    readonly "runtimeClient.getModel": "projection";
+    readonly "runtimeClient.setModel": "engine_command";
+    readonly "runtimeClient.retryLastMessage": "engine_command";
+    readonly "runtimeClient.createLocalAttachment": "platform_shell";
+    readonly "runtimeClient.stop": "engine_command";
+    readonly "runtimeClient.startNewSession": "engine_command";
+    readonly "runtimeClient.listSessions": "engine_query";
+    readonly "runtimeClient.getSessionHistoryState": "projection";
+    readonly "runtimeClient.subscribeSessionHistory": "projection";
+    readonly "runtimeClient.refreshSessionHistory": "engine_query";
+    readonly "runtimeClient.loadMoreSessionHistory": "engine_query";
+    readonly "runtimeClient.setSessionPinned": "engine_command";
+    readonly "runtimeClient.renameSession": "engine_command";
+    readonly "runtimeClient.getInteractions": "projection";
+    readonly "runtimeClient.subscribeInteractions": "projection";
+    readonly "runtimeClient.actOnInteraction": "engine_command";
+    readonly "runtimeClient.getAccount": "projection";
+    readonly "runtimeClient.subscribeAccount": "projection";
+    readonly "runtimeClient.refreshAccount": "engine_query";
+    readonly "runtimeClient.loadSession": "engine_command";
+    readonly "runtimeClient.stageProactiveSuggestionQuestion": "engine_command";
+    readonly "sessionEngine.on": "projection";
+    readonly "sessionEngine.getState": "projection";
+    readonly "sessionEngine.stageProactiveSuggestionQuestion": "engine_command";
+    readonly "sessionEngine.connect": "engine_command";
+    readonly "sessionEngine.disconnect": "engine_command";
+    readonly "sessionEngine.destroy": "platform_shell";
+    readonly "sessionEngine.warmup": "engine_command";
+    readonly "sessionEngine.recordWidgetLifecycle": "platform_shell";
+    readonly "sessionEngine.sendMessage": "engine_command";
+    readonly "sessionEngine.getModel": "projection";
+    readonly "sessionEngine.setModel": "engine_command";
+    readonly "sessionEngine.retryLastMessage": "engine_command";
+    readonly "sessionEngine.createLocalAttachment": "platform_shell";
+    readonly "sessionEngine.uploadAttachment": "platform_shell";
+    readonly "sessionEngine.stop": "engine_command";
+    readonly "sessionEngine.startNewSession": "engine_command";
+    readonly "sessionEngine.listSessions": "engine_query";
+    readonly "sessionEngine.getSessionHistoryState": "projection";
+    readonly "sessionEngine.subscribeSessionHistory": "projection";
+    readonly "sessionEngine.refreshSessionHistory": "engine_query";
+    readonly "sessionEngine.loadMoreSessionHistory": "engine_query";
+    readonly "sessionEngine.setSessionPinned": "engine_command";
+    readonly "sessionEngine.renameSession": "engine_command";
+    readonly "sessionEngine.getInteractions": "projection";
+    readonly "sessionEngine.subscribeInteractions": "projection";
+    readonly "sessionEngine.actOnInteraction": "engine_command";
+    readonly "sessionEngine.getAccount": "projection";
+    readonly "sessionEngine.subscribeAccount": "projection";
+    readonly "sessionEngine.refreshAccount": "engine_query";
+    readonly "sessionEngine.loadSession": "engine_command";
+    readonly "runtime.connect": "engine_command";
+    readonly "runtime.warmup": "engine_command";
+    readonly "runtime.widget_lifecycle": "platform_shell";
+    readonly "session.new": "engine_command";
+    readonly "session.load": "engine_command";
+    readonly "session.list": "engine_query";
+    readonly "session.set_model": "engine_command";
+    readonly "session.pin": "engine_command";
+    readonly "session.rename": "engine_command";
+    readonly "run.stop": "engine_command";
+    readonly "run.retry": "engine_command";
+    readonly "interaction.act": "engine_command";
+    readonly "conversation.stage_proactive_suggestion": "engine_command";
+    readonly "conversation.stage": "engine_command";
+    readonly "conversation.fail_staged": "engine_command";
+    readonly "conversation.send": "engine_command";
+};
+export {};

package/dist/runtime/effectRunner.d.ts

@@ -0,0 +1,19 @@
+import type { PAEffect, PAEffectHandlers, PAEffectMapShape, PAEffectResultEvent } from "../core/kernel/effects";
+import type { PATransportedError } from "../core/protocol/errors";
+export type PAInternalError = Readonly<{
+    code: string;
+    message: string;
+    retryable: boolean;
+    cause?: unknown;
+}>;
+export type PAEffectErrorAdapter = (error: unknown) => PATransportedError;
+export declare class PAEffectRunner<TEffectMap extends PAEffectMapShape<TEffectMap>> {
+    private readonly handlers;
+    private readonly accept;
+    private readonly errorAdapter;
+    private disposed;
+    constructor(handlers: PAEffectHandlers<TEffectMap>, accept: (event: PAEffectResultEvent<TEffectMap>) => void, errorAdapter: PAEffectErrorAdapter);
+    run(effects: readonly PAEffect<TEffectMap>[]): void;
+    dispose(): void;
+    private runEffect;
+}

package/dist/runtime/engine.d.ts

@@ -0,0 +1,33 @@
+import type { PACommand } from "../core/kernel/commands";
+import type { PAEffectHandlers, PAEffectMapShape } from "../core/kernel/effects";
+import type { PADomainEvent, PAEngineEvent } from "../core/kernel/events";
+import type { PAReducer } from "../core/kernel/reducer";
+import type { PAProjectionListener, PASelector, PAUnsubscribe } from "../core/kernel/selectors";
+import { type PAEffectErrorAdapter } from "./effectRunner";
+export type PAEngineOptions<TState, TCommand extends PACommand, TDomainEvent extends PADomainEvent, TEffectMap extends PAEffectMapShape<TEffectMap>, TProjection> = Readonly<{
+    initialState: TState;
+    reducer: PAReducer<TState, TCommand, PAEngineEvent<TDomainEvent, TEffectMap>, TEffectMap>;
+    selector: PASelector<TState, TProjection>;
+    effectHandlers: PAEffectHandlers<TEffectMap>;
+    errorAdapter: PAEffectErrorAdapter;
+}>;
+export declare class PAEngine<TState, TCommand extends PACommand, TDomainEvent extends PADomainEvent, TEffectMap extends PAEffectMapShape<TEffectMap>, TProjection> {
+    private state;
+    private readonly reducer;
+    private readonly selector;
+    private readonly effectRunner;
+    private readonly listeners;
+    private readonly queue;
+    private draining;
+    private disposed;
+    constructor(options: PAEngineOptions<TState, TCommand, TDomainEvent, TEffectMap, TProjection>);
+    dispatch(command: TCommand): Promise<void>;
+    accept(event: TDomainEvent): void;
+    getState(): TState;
+    getProjection(): TProjection;
+    subscribe(listener: PAProjectionListener<TProjection>): PAUnsubscribe;
+    dispose(): void;
+    private acceptEffectResult;
+    private drain;
+    private publish;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluno/product-agent-web",
-  "version": "0.1.203",
+  "version": "0.1.204",
   "description": "Browser SDK and default widget for embedding Pluno Product Agent into customer web apps.",
   "license": "Apache-2.0",
   "type": "module",
@@ -25,9 +25,12 @@
   ],
   "scripts": {
     "build": "vite build --mode sdk && vite build --mode widget && vite build --mode runtime && tsc --emitDeclarationOnly",
-    "check": "tsc --noEmit",
+    "check": "tsc --noEmit && npm run check:core && npm run check:architecture-reference",
+    "check:core": "tsc -p tsconfig.core.json && node scripts/check-core-boundaries.mjs",
+    "check:architecture-reference": "tsc --noEmit --strict --target ES2020 --module ESNext --moduleResolution Bundler --lib ES2020,DOM ../spec/product-agent/client-core-architecture-reference.d.ts",
+    "check:public-api": "node scripts/check-public-api-compatibility.mjs",
     "test": "vitest run",
-    "verify:package": "node scripts/verify-package-contents.mjs",
+    "verify:package": "node scripts/verify-package-contents.mjs && node scripts/verify-declaration-freshness.mjs",
     "prepack": "npm run verify:package"
   },
   "publishConfig": {