@pluno/product-agent-web 0.1.203 → 0.1.204

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

@@ -0,0 +1,2 @@
+import { type PATransportedError } from "../../core/protocol/errors";
+export declare function toPAWebTransportedError(error: unknown): PATransportedError;

package/dist/core/browser-execution/contracts.d.ts

@@ -0,0 +1,16 @@
+import type { PAAuthorityId, PARunId, PASessionId } from "../kernel/state";
+import type { PAJsonObject } from "../protocol/json";
+export type PABrowserToolCall = Readonly<{
+    authorityId: PAAuthorityId;
+    sessionId: PASessionId;
+    runId: PARunId;
+    callId: string;
+    executorId: string;
+    inputFingerprint: string;
+    input: PAJsonObject;
+}>;
+export type PABrowserToolOutcome = Readonly<{
+    callId: string;
+    status: "completed" | "failed" | "outcome_unknown";
+    output: PAJsonObject;
+}>;

package/dist/core/conversation/contracts.d.ts

@@ -0,0 +1,21 @@
+import type { PAClientScopeId, PARequestId, PASessionId, PAViewId } from "../kernel/state";
+import type { PAJsonObject } from "../protocol/json";
+export type PAAttachmentSource = Readonly<{
+    sourceId: string;
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+}>;
+export type PARendererComposerSubmission = Readonly<{
+    viewId: PAViewId;
+    clientScopeId: PAClientScopeId;
+    rendererRevision: number;
+    content: string;
+    attachments: readonly PAAttachmentSource[];
+    metadata?: PAJsonObject;
+}>;
+export type PASubmissionReceipt = Readonly<{
+    requestId: PARequestId;
+    sessionId: PASessionId;
+    acceptedRendererRevision: number;
+}>;

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./browser-execution/contracts";
+export * from "./conversation/contracts";
+export * from "./interactions/contracts";
+export * from "./kernel/capabilities";
+export * from "./kernel/commands";
+export * from "./kernel/effects";
+export * from "./kernel/events";
+export * from "./kernel/reducer";
+export * from "./kernel/selectors";
+export * from "./kernel/state";
+export * from "./model-selection/contracts";
+export * from "./ports";
+export * from "./protocol/errors";
+export * from "./protocol/json";

package/dist/core/interactions/contracts.d.ts

@@ -0,0 +1,8 @@
+import type { PAJsonObject } from "../protocol/json";
+export type PAInteractionAction = "connect" | "dismiss" | "dont_show_again" | "enable" | "later" | "never" | "run" | "snooze" | "submit_feedback";
+export type PAInteractionActionInput = Readonly<{
+    interactionId: string;
+    action: PAInteractionAction;
+    expectedRevision: number;
+    payload?: PAJsonObject;
+}>;

package/dist/core/kernel/capabilities.d.ts

@@ -0,0 +1,333 @@
+export declare const PA_OPERATION_CAPABILITY: {
+    readonly connect: "canConnect";
+    readonly read_account: "canReadAccount";
+    readonly read_appearance: "canReadAppearance";
+    readonly read_history: "canReadHistory";
+    readonly start_conversation: "canStartConversation";
+    readonly send_message: "canCompose";
+    readonly retry_message: "canRetryMessages";
+    readonly stop_run: "canStopRuns";
+    readonly upload_attachment: "canUploadAttachments";
+    readonly execute_browser_tool: "canExecuteCurrentPageTools";
+    readonly manage_tabs: "canManageTabs";
+    readonly group_session_tabs: "canGroupSessionTabs";
+    readonly change_task_page_title: "canChangeTaskPageTitle";
+    readonly open_external_link: "canOpenExternalLinks";
+    readonly use_runtime_helper: "canUseRuntimeHelpers";
+    readonly use_sandbox_files: "canUseSandboxFiles";
+    readonly show_notification: "canShowSystemNotifications";
+    readonly share: "canShare";
+    readonly submit_feedback: "canSubmitFeedback";
+    readonly pin_session: "canPinSessions";
+    readonly rename_session: "canRenameSessions";
+    readonly delete_session: "canDeleteSessions";
+    readonly select_model: "canSelectModel";
+    readonly select_browser_mode: "canSelectBrowserMode";
+    readonly manage_session_prompt: "canManageSessionPrompt";
+    readonly refresh_context: "canRefreshOriginContext";
+    readonly refresh_user_context: "canRefreshUserContext";
+    readonly manage_origin_style: "canManageOriginStyle";
+    readonly manage_origin_access: "canManageOriginAccess";
+    readonly start_deep_flow: "canStartDeepFlow";
+    readonly manage_preferences: "canManagePreferences";
+    readonly read_starter_prompts: "canReadStarterPrompts";
+    readonly manage_morning_report: "canManageMorningReport";
+    readonly manage_proactive_suggestions: "canManageProactiveSuggestions";
+    readonly manage_notification_permission: "canRequestNotificationPermission";
+    readonly manage_tab_group_permission: "canRequestTabGroupPermission";
+    readonly manage_integration_auth: "canManageIntegrationAuth";
+    readonly read_active_users: "canReadActiveUsers";
+    readonly manage_extension_update: "canManageExtensionUpdate";
+    readonly record_widget_lifecycle: "canRecordWidgetLifecycle";
+    readonly read_hosted_browser_eligibility: "canReadHostedBrowserEligibility";
+    readonly manage_interactions: "canManageInteractions";
+    readonly invoke_conversation_action: "canInvokeConversationActions";
+};
+export type PAOperation = keyof typeof PA_OPERATION_CAPABILITY;
+export type PAOperationCapability = typeof PA_OPERATION_CAPABILITY[PAOperation];
+export type PASurfaceCapabilities = Readonly<{
+    canConnect: boolean;
+    canRenderConversation: boolean;
+    canReadHistory: boolean;
+    canStartConversation: boolean;
+    canCompose: boolean;
+    canRetryMessages: boolean;
+    canStopRuns: boolean;
+    canUploadAttachments: boolean;
+    canExecuteCurrentPageTools: boolean;
+    canManageTabs: boolean;
+    canGroupSessionTabs: boolean;
+    canChangeTaskPageTitle: boolean;
+    canShowSystemNotifications: boolean;
+    canRequestNotificationPermission: boolean;
+    canRequestTabGroupPermission: boolean;
+    canOpenExternalLinks: boolean;
+    canShare: boolean;
+    canSubmitFeedback: boolean;
+    canPinSessions: boolean;
+    canRenameSessions: boolean;
+    canDeleteSessions: boolean;
+    canReadAccount: boolean;
+    canReadAppearance: boolean;
+    canManagePreferences: boolean;
+    canInvokeConversationActions: boolean;
+    canShowPersonalFeatures: boolean;
+    canSelectModel: boolean;
+    canSelectBrowserMode: boolean;
+    canManageSessionPrompt: boolean;
+    canRefreshOriginContext: boolean;
+    canRefreshUserContext: boolean;
+    canManageOriginStyle: boolean;
+    canManageOriginAccess: boolean;
+    canStartDeepFlow: boolean;
+    canUseRuntimeHelpers: boolean;
+    canUseSandboxFiles: boolean;
+    canReadHostedBrowserEligibility: boolean;
+    canManageInteractions: boolean;
+    canReadStarterPrompts: boolean;
+    canManageMorningReport: boolean;
+    canManageProactiveSuggestions: boolean;
+    canManageIntegrationAuth: boolean;
+    canReadActiveUsers: boolean;
+    canManageExtensionUpdate: boolean;
+    canRecordWidgetLifecycle: boolean;
+}>;
+export type PAClientCapabilityProfile = "extension_sidepanel" | "extension_widget" | "main_web_chat" | "embedded_widget" | "embedded_custom_ui";
+export declare const PA_SURFACE_PROFILES: {
+    readonly extension_sidepanel: Readonly<{
+        canConnect: boolean;
+        canRenderConversation: boolean;
+        canReadHistory: boolean;
+        canStartConversation: boolean;
+        canCompose: boolean;
+        canRetryMessages: boolean;
+        canStopRuns: boolean;
+        canUploadAttachments: boolean;
+        canExecuteCurrentPageTools: boolean;
+        canManageTabs: boolean;
+        canGroupSessionTabs: boolean;
+        canChangeTaskPageTitle: boolean;
+        canShowSystemNotifications: boolean;
+        canRequestNotificationPermission: boolean;
+        canRequestTabGroupPermission: boolean;
+        canOpenExternalLinks: boolean;
+        canShare: boolean;
+        canSubmitFeedback: boolean;
+        canPinSessions: boolean;
+        canRenameSessions: boolean;
+        canDeleteSessions: boolean;
+        canReadAccount: boolean;
+        canReadAppearance: boolean;
+        canManagePreferences: boolean;
+        canInvokeConversationActions: boolean;
+        canShowPersonalFeatures: boolean;
+        canSelectModel: boolean;
+        canSelectBrowserMode: boolean;
+        canManageSessionPrompt: boolean;
+        canRefreshOriginContext: boolean;
+        canRefreshUserContext: boolean;
+        canManageOriginStyle: boolean;
+        canManageOriginAccess: boolean;
+        canStartDeepFlow: boolean;
+        canUseRuntimeHelpers: boolean;
+        canUseSandboxFiles: boolean;
+        canReadHostedBrowserEligibility: boolean;
+        canManageInteractions: boolean;
+        canReadStarterPrompts: boolean;
+        canManageMorningReport: boolean;
+        canManageProactiveSuggestions: boolean;
+        canManageIntegrationAuth: boolean;
+        canReadActiveUsers: boolean;
+        canManageExtensionUpdate: boolean;
+        canRecordWidgetLifecycle: boolean;
+    }>;
+    readonly extension_widget: Readonly<{
+        canConnect: boolean;
+        canRenderConversation: boolean;
+        canReadHistory: boolean;
+        canStartConversation: boolean;
+        canCompose: boolean;
+        canRetryMessages: boolean;
+        canStopRuns: boolean;
+        canUploadAttachments: boolean;
+        canExecuteCurrentPageTools: boolean;
+        canManageTabs: boolean;
+        canGroupSessionTabs: boolean;
+        canChangeTaskPageTitle: boolean;
+        canShowSystemNotifications: boolean;
+        canRequestNotificationPermission: boolean;
+        canRequestTabGroupPermission: boolean;
+        canOpenExternalLinks: boolean;
+        canShare: boolean;
+        canSubmitFeedback: boolean;
+        canPinSessions: boolean;
+        canRenameSessions: boolean;
+        canDeleteSessions: boolean;
+        canReadAccount: boolean;
+        canReadAppearance: boolean;
+        canManagePreferences: boolean;
+        canInvokeConversationActions: boolean;
+        canShowPersonalFeatures: boolean;
+        canSelectModel: boolean;
+        canSelectBrowserMode: boolean;
+        canManageSessionPrompt: boolean;
+        canRefreshOriginContext: boolean;
+        canRefreshUserContext: boolean;
+        canManageOriginStyle: boolean;
+        canManageOriginAccess: boolean;
+        canStartDeepFlow: boolean;
+        canUseRuntimeHelpers: boolean;
+        canUseSandboxFiles: boolean;
+        canReadHostedBrowserEligibility: boolean;
+        canManageInteractions: boolean;
+        canReadStarterPrompts: boolean;
+        canManageMorningReport: boolean;
+        canManageProactiveSuggestions: boolean;
+        canManageIntegrationAuth: boolean;
+        canReadActiveUsers: boolean;
+        canManageExtensionUpdate: boolean;
+        canRecordWidgetLifecycle: boolean;
+    }>;
+    readonly main_web_chat: Readonly<{
+        canConnect: boolean;
+        canRenderConversation: boolean;
+        canReadHistory: boolean;
+        canStartConversation: boolean;
+        canCompose: boolean;
+        canRetryMessages: boolean;
+        canStopRuns: boolean;
+        canUploadAttachments: boolean;
+        canExecuteCurrentPageTools: boolean;
+        canManageTabs: boolean;
+        canGroupSessionTabs: boolean;
+        canChangeTaskPageTitle: boolean;
+        canShowSystemNotifications: boolean;
+        canRequestNotificationPermission: boolean;
+        canRequestTabGroupPermission: boolean;
+        canOpenExternalLinks: boolean;
+        canShare: boolean;
+        canSubmitFeedback: boolean;
+        canPinSessions: boolean;
+        canRenameSessions: boolean;
+        canDeleteSessions: boolean;
+        canReadAccount: boolean;
+        canReadAppearance: boolean;
+        canManagePreferences: boolean;
+        canInvokeConversationActions: boolean;
+        canShowPersonalFeatures: boolean;
+        canSelectModel: boolean;
+        canSelectBrowserMode: boolean;
+        canManageSessionPrompt: boolean;
+        canRefreshOriginContext: boolean;
+        canRefreshUserContext: boolean;
+        canManageOriginStyle: boolean;
+        canManageOriginAccess: boolean;
+        canStartDeepFlow: boolean;
+        canUseRuntimeHelpers: boolean;
+        canUseSandboxFiles: boolean;
+        canReadHostedBrowserEligibility: boolean;
+        canManageInteractions: boolean;
+        canReadStarterPrompts: boolean;
+        canManageMorningReport: boolean;
+        canManageProactiveSuggestions: boolean;
+        canManageIntegrationAuth: boolean;
+        canReadActiveUsers: boolean;
+        canManageExtensionUpdate: boolean;
+        canRecordWidgetLifecycle: boolean;
+    }>;
+    readonly embedded_widget: Readonly<{
+        canConnect: boolean;
+        canRenderConversation: boolean;
+        canReadHistory: boolean;
+        canStartConversation: boolean;
+        canCompose: boolean;
+        canRetryMessages: boolean;
+        canStopRuns: boolean;
+        canUploadAttachments: boolean;
+        canExecuteCurrentPageTools: boolean;
+        canManageTabs: boolean;
+        canGroupSessionTabs: boolean;
+        canChangeTaskPageTitle: boolean;
+        canShowSystemNotifications: boolean;
+        canRequestNotificationPermission: boolean;
+        canRequestTabGroupPermission: boolean;
+        canOpenExternalLinks: boolean;
+        canShare: boolean;
+        canSubmitFeedback: boolean;
+        canPinSessions: boolean;
+        canRenameSessions: boolean;
+        canDeleteSessions: boolean;
+        canReadAccount: boolean;
+        canReadAppearance: boolean;
+        canManagePreferences: boolean;
+        canInvokeConversationActions: boolean;
+        canShowPersonalFeatures: boolean;
+        canSelectModel: boolean;
+        canSelectBrowserMode: boolean;
+        canManageSessionPrompt: boolean;
+        canRefreshOriginContext: boolean;
+        canRefreshUserContext: boolean;
+        canManageOriginStyle: boolean;
+        canManageOriginAccess: boolean;
+        canStartDeepFlow: boolean;
+        canUseRuntimeHelpers: boolean;
+        canUseSandboxFiles: boolean;
+        canReadHostedBrowserEligibility: boolean;
+        canManageInteractions: boolean;
+        canReadStarterPrompts: boolean;
+        canManageMorningReport: boolean;
+        canManageProactiveSuggestions: boolean;
+        canManageIntegrationAuth: boolean;
+        canReadActiveUsers: boolean;
+        canManageExtensionUpdate: boolean;
+        canRecordWidgetLifecycle: boolean;
+    }>;
+    readonly embedded_custom_ui: Readonly<{
+        canConnect: boolean;
+        canRenderConversation: boolean;
+        canReadHistory: boolean;
+        canStartConversation: boolean;
+        canCompose: boolean;
+        canRetryMessages: boolean;
+        canStopRuns: boolean;
+        canUploadAttachments: boolean;
+        canExecuteCurrentPageTools: boolean;
+        canManageTabs: boolean;
+        canGroupSessionTabs: boolean;
+        canChangeTaskPageTitle: boolean;
+        canShowSystemNotifications: boolean;
+        canRequestNotificationPermission: boolean;
+        canRequestTabGroupPermission: boolean;
+        canOpenExternalLinks: boolean;
+        canShare: boolean;
+        canSubmitFeedback: boolean;
+        canPinSessions: boolean;
+        canRenameSessions: boolean;
+        canDeleteSessions: boolean;
+        canReadAccount: boolean;
+        canReadAppearance: boolean;
+        canManagePreferences: boolean;
+        canInvokeConversationActions: boolean;
+        canShowPersonalFeatures: boolean;
+        canSelectModel: boolean;
+        canSelectBrowserMode: boolean;
+        canManageSessionPrompt: boolean;
+        canRefreshOriginContext: boolean;
+        canRefreshUserContext: boolean;
+        canManageOriginStyle: boolean;
+        canManageOriginAccess: boolean;
+        canStartDeepFlow: boolean;
+        canUseRuntimeHelpers: boolean;
+        canUseSandboxFiles: boolean;
+        canReadHostedBrowserEligibility: boolean;
+        canManageInteractions: boolean;
+        canReadStarterPrompts: boolean;
+        canManageMorningReport: boolean;
+        canManageProactiveSuggestions: boolean;
+        canManageIntegrationAuth: boolean;
+        canReadActiveUsers: boolean;
+        canManageExtensionUpdate: boolean;
+        canRecordWidgetLifecycle: boolean;
+    }>;
+};
+export declare function hasPASurfaceCapability(profile: PAClientCapabilityProfile, capability: string): boolean;

package/dist/core/kernel/commands.d.ts

@@ -0,0 +1,7 @@
+export type PACommand = Readonly<{
+    type: string;
+}>;
+export type PACommandReducerInput<TCommand extends PACommand> = Readonly<{
+    source: "command";
+    value: TCommand;
+}>;

package/dist/core/kernel/effects.d.ts

@@ -0,0 +1,37 @@
+import type { PAEffectId } from "./state";
+import type { PATransportedError } from "../protocol/errors";
+import type { PAJsonValue } from "../protocol/json";
+export type PAEffectContract = Readonly<{
+    input: PAJsonValue;
+    output: PAJsonValue;
+}>;
+export type PAEffectMapShape<TMap> = {
+    readonly [TKind in keyof TMap]: PAEffectContract;
+};
+export type PAEffect<TEffectMap extends PAEffectMapShape<TEffectMap>> = {
+    readonly [TKind in keyof TEffectMap & string]: Readonly<{
+        id: PAEffectId;
+        kind: TKind;
+        input: TEffectMap[TKind]["input"];
+    }>;
+}[keyof TEffectMap & string];
+export type PAEffectCompletedEvent<TEffectMap extends PAEffectMapShape<TEffectMap>> = {
+    readonly [TKind in keyof TEffectMap & string]: Readonly<{
+        type: "effect.completed";
+        effectId: PAEffectId;
+        effectKind: TKind;
+        output: TEffectMap[TKind]["output"];
+    }>;
+}[keyof TEffectMap & string];
+export type PAEffectFailedEvent<TEffectMap extends PAEffectMapShape<TEffectMap>> = {
+    readonly [TKind in keyof TEffectMap & string]: Readonly<{
+        type: "effect.failed";
+        effectId: PAEffectId;
+        effectKind: TKind;
+        error: PATransportedError;
+    }>;
+}[keyof TEffectMap & string];
+export type PAEffectResultEvent<TEffectMap extends PAEffectMapShape<TEffectMap>> = PAEffectCompletedEvent<TEffectMap> | PAEffectFailedEvent<TEffectMap>;
+export type PAEffectHandlers<TEffectMap extends PAEffectMapShape<TEffectMap>> = {
+    readonly [TKind in keyof TEffectMap]: (input: TEffectMap[TKind]["input"]) => Promise<TEffectMap[TKind]["output"]>;
+};

package/dist/core/kernel/events.d.ts

@@ -0,0 +1,9 @@
+import type { PAEffectMapShape, PAEffectResultEvent } from "./effects";
+export type PADomainEvent = Readonly<{
+    type: string;
+}>;
+export type PAEngineEvent<TDomainEvent extends PADomainEvent, TEffectMap extends PAEffectMapShape<TEffectMap>> = TDomainEvent | PAEffectResultEvent<TEffectMap>;
+export type PAEventReducerInput<TEvent extends PADomainEvent> = Readonly<{
+    source: "event";
+    value: TEvent;
+}>;

package/dist/core/kernel/reducer.d.ts

@@ -0,0 +1,10 @@
+import type { PACommand, PACommandReducerInput } from "./commands";
+import type { PAEffect, PAEffectMapShape } from "./effects";
+import type { PADomainEvent, PAEventReducerInput } from "./events";
+export type PAReduction<TState, TEffectMap extends PAEffectMapShape<TEffectMap>> = Readonly<{
+    state: TState;
+    effects: readonly PAEffect<TEffectMap>[];
+}>;
+export type PAReducerInput<TCommand extends PACommand, TEvent extends PADomainEvent> = PACommandReducerInput<TCommand> | PAEventReducerInput<TEvent>;
+export type PAReducer<TState, TCommand extends PACommand, TEvent extends PADomainEvent, TEffectMap extends PAEffectMapShape<TEffectMap>> = (state: TState, input: PAReducerInput<TCommand, TEvent>) => PAReduction<TState, TEffectMap>;
+export declare function unchangedPAReduction<TState, TEffectMap extends PAEffectMapShape<TEffectMap>>(state: TState): PAReduction<TState, TEffectMap>;

package/dist/core/kernel/selectors.d.ts

@@ -0,0 +1,3 @@
+export type PASelector<TState, TProjection> = (state: TState) => TProjection;
+export type PAProjectionListener<TProjection> = (projection: TProjection) => void;
+export type PAUnsubscribe = () => void;

package/dist/core/kernel/state.d.ts

@@ -0,0 +1,46 @@
+import type { PATransportedError } from "../protocol/errors";
+declare const paIdentifierBrand: unique symbol;
+export type PABrandedIdentifier<TName extends string> = string & {
+    readonly [paIdentifierBrand]: TName;
+};
+export type PAAuthorityId = PABrandedIdentifier<"authority">;
+export type PAClientScopeId = PABrandedIdentifier<"client-scope">;
+export type PAConversationScopeId = PABrandedIdentifier<"conversation-scope">;
+export type PAEffectId = PABrandedIdentifier<"effect">;
+export type PARequestId = PABrandedIdentifier<"request">;
+export type PARunId = PABrandedIdentifier<"run">;
+export type PASessionId = PABrandedIdentifier<"session">;
+export type PAViewId = PABrandedIdentifier<"view">;
+export type PAQueryStatus = "not_requested" | "loading" | "ready" | "refreshing" | "loading_more" | "error";
+export type PAQueryState<TKey extends string, TData> = Readonly<{
+    key: TKey;
+    status: PAQueryStatus;
+    data: TData | null;
+    cursor: string | null;
+    error: PATransportedError | null;
+    requestId: PARequestId | null;
+    updatedAt: number | null;
+}>;
+export declare function createPAQueryState<TKey extends string, TData>(key: TKey): PAQueryState<TKey, TData>;
+export declare function beginPAQuery<TKey extends string, TData>(state: PAQueryState<TKey, TData>, input: Readonly<{
+    key: TKey;
+    requestId: PARequestId;
+    mode: "replace" | "append";
+}>): PAQueryState<TKey, TData>;
+export declare function completePAQuery<TKey extends string, TData>(state: PAQueryState<TKey, TData>, input: Readonly<{
+    key: TKey;
+    requestId: PARequestId;
+    data: TData;
+    cursor: string | null;
+    updatedAt: number;
+}>): PAQueryState<TKey, TData>;
+export declare function failPAQuery<TKey extends string, TData>(state: PAQueryState<TKey, TData>, input: Readonly<{
+    key: TKey;
+    requestId: PARequestId;
+    error: PATransportedError;
+}>): PAQueryState<TKey, TData>;
+export type PAEngineState<TSlices extends object> = Readonly<{
+    revision: number;
+    slices: Readonly<TSlices>;
+}>;
+export {};

package/dist/core/model-selection/contracts.d.ts

@@ -0,0 +1,6 @@
+import type { PAClientScopeId } from "../kernel/state";
+export type PAProductAgentModel = "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";
+export type PAComposerModelSelection = Readonly<{
+    clientScopeId: PAClientScopeId;
+    requestedModel: PAProductAgentModel;
+}>;

package/dist/core/ports.d.ts

@@ -0,0 +1,14 @@
+import type { PAEffectId, PARequestId } from "./kernel/state";
+import type { PAJsonValue } from "./protocol/json";
+export interface PAClockPort {
+    now(): number;
+}
+export interface PAIdPort {
+    createEffectId(): PAEffectId;
+    createRequestId(): PARequestId;
+}
+export interface PAKeyValuePort {
+    get(key: string): Promise<PAJsonValue | undefined>;
+    set(key: string, value: PAJsonValue): Promise<void>;
+    remove(key: string): Promise<void>;
+}

package/dist/core/protocol/errors.d.ts

@@ -0,0 +1,9 @@
+import { type PAJsonObject } from "./json";
+export type PATransportedErrorCode = "capability_unavailable" | "connection_interrupted" | "request_timed_out" | "validation_failed" | "unknown" | (string & {});
+export type PATransportedError = Readonly<{
+    code: PATransportedErrorCode;
+    message: string;
+    retryable: boolean;
+    details?: PAJsonObject;
+}>;
+export declare function createPATransportedError(input: PATransportedError): PATransportedError;

package/dist/core/protocol/json.d.ts

@@ -0,0 +1,6 @@
+export type PAJsonPrimitive = string | number | boolean | null;
+export type PAJsonValue = PAJsonPrimitive | readonly PAJsonValue[] | {
+    readonly [key: string]: PAJsonValue;
+};
+export type PAJsonObject = Readonly<Record<string, PAJsonValue>>;
+export declare function isPAJsonValue(value: unknown): value is PAJsonValue;