@csntgao/ai-employee-client 0.14.3

package/dist/index.d.ts

@@ -0,0 +1,680 @@
+type AiEmployeeMessageRole = 'user' | 'assistant' | 'system' | 'error';
+interface AiEmployeeMessage {
+    id: string;
+    sessionId: string;
+    role: AiEmployeeMessageRole;
+    content: string;
+    createdAt: string;
+}
+interface AiEmployeeSessionSummary {
+    sessionId: string;
+    title: string;
+    latestMessage: string;
+    latestMessageId?: string;
+    updatedAt: string;
+    unreadCount: number;
+}
+interface AiEmployeeAttachmentReference {
+    transactionId: string;
+    fspath: string;
+}
+interface AiEmployeeFirstMessageOptions {
+    attachments?: readonly AiEmployeeAttachmentReference[];
+    trustedContext?: Readonly<Record<string, unknown>> | null;
+}
+interface AiEmployeeFirstMessageRequest {
+    requestId: string;
+    aeCode: string;
+    agentCode: string;
+    content: string;
+    attachments: readonly AiEmployeeAttachmentReference[];
+    trustedContext: Readonly<Record<string, unknown>> | null;
+}
+interface AiEmployeeFirstMessageResult {
+    sessionId: string;
+    messageId: string;
+    executionId: string;
+    status: 'running' | 'queued';
+    startedAt: string;
+    aeCode: string;
+    agentCode: string;
+    conversationType: string;
+    title?: string;
+    createdAt?: string;
+}
+interface AiEmployeeFirstMessageRequestState {
+    fingerprint: string;
+    requestId: string;
+}
+interface AiEmployeeFirstMessageRequestStore {
+    load(scope: string): AiEmployeeFirstMessageRequestState | null | Promise<AiEmployeeFirstMessageRequestState | null>;
+    save(scope: string, state: AiEmployeeFirstMessageRequestState): void | Promise<void>;
+    clear(scope: string): void | Promise<void>;
+}
+interface AiEmployeeTransport {
+    createSessionWithFirstMessage(request: AiEmployeeFirstMessageRequest): Promise<AiEmployeeFirstMessageResult>;
+    listSessions?(): Promise<AiEmployeeSessionSummary[]>;
+    markSessionRead?(sessionId: string, latestMessageId: string): Promise<void>;
+    listMessages(sessionId: string): Promise<AiEmployeeMessage[]>;
+    sendMessage(sessionId: string, content: string): Promise<void>;
+    getAccessToken(): Promise<string>;
+}
+type AiEmployeeTransportErrorCode = 'UNAUTHORIZED' | 'ACCESS_DENIED' | 'AI_EMPLOYEE_NOT_AVAILABLE' | 'APPLICATION_NOT_SUPPORTED' | 'ORGANIZATION_CONTEXT_REQUIRED' | 'INVALID_ARGUMENT' | 'IDEMPOTENCY_CONFLICT' | 'REALTIME_UNAVAILABLE' | 'TOO_MANY_REQUESTS';
+type AiEmployeeConnectionState = 'idle' | 'connecting' | 'authenticating' | 'subscribing' | 'connected' | 'reconnecting' | 'disconnected' | 'destroyed';
+type AiEmployeeErrorCode = 'INVALID_CONFIGURATION' | 'SESSION_UNAVAILABLE' | 'HISTORY_LOAD_FAILED' | 'TOKEN_UNAVAILABLE' | 'WEBSOCKET_UNAVAILABLE' | 'WEBSOCKET_ERROR' | 'AUTHENTICATION_FAILED' | 'ORGANIZATION_CONTEXT_REQUIRED' | 'REALTIME_UNAVAILABLE' | 'CHANNEL_UNAVAILABLE' | 'SESSION_NOT_FOUND' | 'PROTOCOL_ERROR' | 'SEND_FAILED' | 'FIRST_MESSAGE_CONFLICT' | 'RATE_LIMITED' | 'SEND_IN_PROGRESS' | 'EMPTY_MESSAGE' | 'SOURCE_SESSION_NOT_FOUND' | 'SOURCE_SESSION_ACCESS_DENIED' | 'HANDOFF_ACTION_NOT_FOUND' | 'HANDOFF_ACTION_MISMATCH' | 'CUSTOMER_SUPPORT_UNAVAILABLE' | 'CUSTOMER_SUPPORT_HANDOFF_FAILED' | 'CLIENT_DESTROYED';
+interface AiEmployeeClientErrorDetail {
+    code: AiEmployeeErrorCode;
+    message: string;
+    recoverable: boolean;
+}
+interface AiEmployeeClientEventMap {
+    ready: {
+        sessionId: string;
+    };
+    history: {
+        sessionId: string;
+        messages: readonly AiEmployeeMessage[];
+    };
+    message: {
+        sessionId: string;
+        message: AiEmployeeMessage;
+        source: 'local' | 'realtime';
+    };
+    title: {
+        sessionId: string;
+        title: string;
+    };
+    'connection-state-change': {
+        previous: AiEmployeeConnectionState;
+        current: AiEmployeeConnectionState;
+    };
+    'processing-state-change': {
+        processing: boolean;
+    };
+    error: AiEmployeeClientErrorDetail;
+}
+interface AiEmployeeReconnectOptions {
+    initialDelayMs: number;
+    maximumDelayMs: number;
+    factor: number;
+    jitter: number;
+}
+type AiEmployeeWebSocketFactory = (url: string) => WebSocket;
+interface AiEmployeeClientOptions {
+    realtimeUrl: string;
+    aeCode: string;
+    agentCode: string;
+    transport: AiEmployeeTransport;
+    sessionId?: string;
+    reconnect?: Partial<AiEmployeeReconnectOptions>;
+    webSocketFactory?: AiEmployeeWebSocketFactory;
+    requestIdFactory?: () => string;
+    firstMessageRequestStore?: AiEmployeeFirstMessageRequestStore | null;
+    /** Primarily useful for deterministic tests. Production heartbeats are never faster than 5s. */
+    minimumHeartbeatMs?: number;
+}
+interface AiEmployeeClientStartResult {
+    sessionId: string | null;
+    messages: readonly AiEmployeeMessage[];
+}
+type AiEmployeeClientListener<K extends keyof AiEmployeeClientEventMap> = (detail: AiEmployeeClientEventMap[K]) => void;
+
+declare class AiEmployeeClientError extends Error {
+    readonly code: AiEmployeeErrorCode;
+    constructor(code: AiEmployeeErrorCode, message: string);
+}
+declare class AiEmployeeTransportError extends Error {
+    readonly code: AiEmployeeTransportErrorCode;
+    constructor(code: AiEmployeeTransportErrorCode);
+}
+declare class AiEmployeeClient {
+    readonly aeCode: string;
+    readonly agentCode: string;
+    private readonly realtimeUrl;
+    private readonly transport;
+    private readonly webSocketFactory;
+    private readonly reconnectOptions;
+    private readonly minimumHeartbeatMs;
+    private readonly requestIdFactory;
+    private readonly firstMessageRequestStore;
+    private readonly firstMessageRequestScope;
+    private readonly listeners;
+    private readonly seenMessageIds;
+    private readonly pendingLocalMessages;
+    private assistantReceivedInCurrentTurn;
+    private socket;
+    private reconnectTimer;
+    private heartbeatTimer;
+    private initializePromise;
+    private currentMessages;
+    private currentSessionId;
+    private currentState;
+    private reconnectAttempt;
+    private socketGeneration;
+    private lifecycleGeneration;
+    private shouldReconnect;
+    private destroyed;
+    private sending;
+    private processing;
+    private localMessageSequence;
+    private replayHistoryOnNextSubscription;
+    private socketAuthenticationFailure;
+    private availabilityReconnectAttempt;
+    private pendingFirstMessage;
+    constructor(options: AiEmployeeClientOptions);
+    get connectionState(): AiEmployeeConnectionState;
+    get sessionId(): string | null;
+    get messages(): readonly AiEmployeeMessage[];
+    get isProcessing(): boolean;
+    get isDestroyed(): boolean;
+    on<K extends keyof AiEmployeeClientEventMap>(type: K, listener: AiEmployeeClientListener<K>): () => void;
+    connect(): Promise<AiEmployeeClientStartResult>;
+    start(): Promise<AiEmployeeClientStartResult>;
+    bindSession(sessionId: string): Promise<AiEmployeeClientStartResult>;
+    startNewConversation(): Promise<AiEmployeeClientStartResult>;
+    refreshMessages(): Promise<readonly AiEmployeeMessage[]>;
+    sendMessage(content: string, options?: AiEmployeeFirstMessageOptions): Promise<AiEmployeeMessage>;
+    disconnect(): void;
+    destroy(): void;
+    private sendFollowUp;
+    private sendFirstMessage;
+    private initialize;
+    private loadStoredFirstMessageRequest;
+    private saveStoredFirstMessageRequest;
+    private clearStoredFirstMessageRequest;
+    private refreshHistory;
+    private replaceHistory;
+    private openSocket;
+    private authenticateSocket;
+    private handleSocketData;
+    private handleServerMessage;
+    private handleAiEmployeeEvent;
+    private subscribeCurrentSession;
+    private rememberPendingLocalMessage;
+    /**
+     * 本地已渲染的用户消息会被服务端以 replay 和实时事件多次回送，且不保证复用
+     * 同一个消息 ID。窗口期内不消费该条目，多次回声都要挡住；本地发送本身每次都
+     * 会追加气泡，所以重复发送同样内容不会因此丢消息。
+     */
+    private matchesPendingLocalMessage;
+    private appendMessage;
+    private rememberMessageId;
+    private handleChannelError;
+    private startHeartbeat;
+    private handleSocketClose;
+    private scheduleAvailabilityReconnect;
+    private scheduleReconnect;
+    private recoverAndReconnect;
+    private stopConnection;
+    private closeCurrentSocket;
+    private clearReconnectTimer;
+    private clearHeartbeatTimer;
+    private setState;
+    private setProcessing;
+    private emitError;
+    private emit;
+    private isCurrentSocket;
+    private isCurrentLifecycle;
+    private assertUsable;
+}
+
+interface OpenCustomerSupportAssistantAction {
+    type: 'assistant_action';
+    action: 'open_customer_support';
+    transactionId: string;
+    trigger: 'out_of_scope';
+    entry: 'help_and_support';
+}
+type AiEmployeeAssistantAction = OpenCustomerSupportAssistantAction;
+interface ParsedAiEmployeeAssistantContent {
+    content: string;
+    actions: readonly AiEmployeeAssistantAction[];
+}
+/**
+ * Parses a trusted platform action from the final standalone JSON block of an
+ * assistant response. Invalid or ambiguous input is returned unchanged and is
+ * never made executable.
+ */
+declare function parseAiEmployeeAssistantContent(content: string): ParsedAiEmployeeAssistantContent;
+declare function isUuidV4(value: unknown): value is string;
+
+type CustomerSupportSessionStatus = 'waiting' | 'active' | 'closed';
+type CustomerSupportSenderType = 'customer' | 'agent' | 'system';
+interface CustomerSupportAgent {
+    id: string;
+    name: string;
+    avatarUrl: string;
+    roleName: string;
+}
+interface CustomerSupportMessage {
+    id: string;
+    sessionId: string;
+    sequence: string;
+    clientMessageId: string;
+    senderType: CustomerSupportSenderType;
+    senderName: string;
+    content: string;
+    createdAt: string;
+}
+interface CustomerSupportSession {
+    id: string;
+    sessionNo: string;
+    title: string;
+    status: CustomerSupportSessionStatus;
+    statusText: string;
+    primaryAgent: CustomerSupportAgent | null;
+    lastMessage: string;
+    unreadCount: number;
+    openedAt: string;
+    updatedAt: string;
+    version: string;
+}
+interface CustomerSupportMessagePage {
+    messages: readonly CustomerSupportMessage[];
+    latestSequence: string;
+    sessionVersion: string;
+}
+interface CustomerSupportCreateSessionRequest {
+    clientRequestId: string;
+    title?: string;
+    initialMessage?: string;
+}
+interface CustomerSupportCreateSessionResult {
+    session: CustomerSupportSession;
+    initialMessage?: CustomerSupportMessage;
+}
+interface CustomerSupportHandoffRequest {
+    sourceSessionId: string;
+    actionTransactionId: string;
+}
+interface CustomerSupportHandoffResult {
+    session: CustomerSupportSession;
+    initialMessage: CustomerSupportMessage;
+    created: boolean;
+    repaired: boolean;
+}
+interface CustomerSupportTransport {
+    getAccessToken(): Promise<string>;
+    listSessions(): Promise<readonly CustomerSupportSession[]>;
+    getSession?(sessionId: string): Promise<CustomerSupportSession>;
+    createSession(request: CustomerSupportCreateSessionRequest): Promise<CustomerSupportCreateSessionResult>;
+    createHandoffSession?(request: CustomerSupportHandoffRequest): Promise<CustomerSupportHandoffResult>;
+    listMessages(sessionId: string): Promise<CustomerSupportMessagePage>;
+    sendMessage(sessionId: string, clientMessageId: string, content: string): Promise<CustomerSupportMessage>;
+    markRead?(sessionId: string, lastReadSequence: string): Promise<void>;
+}
+interface CustomerSupportClientOptions {
+    realtimeUrl: string;
+    transport: CustomerSupportTransport;
+    sessionId?: string;
+    reconnect?: Partial<AiEmployeeReconnectOptions>;
+    webSocketFactory?: (url: string) => WebSocket;
+    requestIdFactory?: () => string;
+    minimumHeartbeatMs?: number;
+}
+type CustomerSupportErrorCode = 'INVALID_CONFIGURATION' | 'SESSION_UNAVAILABLE' | 'HISTORY_LOAD_FAILED' | 'TOKEN_UNAVAILABLE' | 'WEBSOCKET_UNAVAILABLE' | 'WEBSOCKET_ERROR' | 'AUTHENTICATION_FAILED' | 'ORGANIZATION_CONTEXT_REQUIRED' | 'REALTIME_UNAVAILABLE' | 'CHANNEL_UNAVAILABLE' | 'PROTOCOL_ERROR' | 'SEND_FAILED' | 'SEND_IN_PROGRESS' | 'EMPTY_MESSAGE' | 'CLIENT_DESTROYED';
+interface CustomerSupportErrorDetail {
+    code: CustomerSupportErrorCode;
+    message: string;
+    recoverable: boolean;
+}
+interface CustomerSupportClientEventMap {
+    ready: {
+        sessionId: string | null;
+    };
+    sessions: {
+        sessions: readonly CustomerSupportSession[];
+    };
+    session: {
+        session: CustomerSupportSession;
+    };
+    history: {
+        sessionId: string;
+        messages: readonly CustomerSupportMessage[];
+    };
+    message: {
+        sessionId: string;
+        message: CustomerSupportMessage;
+        source: 'local' | 'realtime';
+    };
+    'connection-state-change': {
+        previous: AiEmployeeConnectionState;
+        current: AiEmployeeConnectionState;
+    };
+    error: CustomerSupportErrorDetail;
+}
+type CustomerSupportClientListener<K extends keyof CustomerSupportClientEventMap> = (detail: CustomerSupportClientEventMap[K]) => void;
+
+declare class CustomerSupportClientError extends Error {
+    readonly code: CustomerSupportErrorCode;
+    constructor(code: CustomerSupportErrorCode, message: string);
+}
+declare class CustomerSupportClient {
+    private readonly realtimeUrl;
+    private readonly transport;
+    private readonly webSocketFactory;
+    private readonly requestIdFactory;
+    private readonly reconnectOptions;
+    private readonly minimumHeartbeatMs;
+    private readonly listeners;
+    private currentSession;
+    private currentSessions;
+    private currentMessages;
+    private currentState;
+    private socket;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private tokenReconnectAttempt;
+    private availabilityReconnectAttempt;
+    private socketGeneration;
+    private socketAuthenticationFailure;
+    private destroyed;
+    private shouldReconnect;
+    private sending;
+    private historyRefresh;
+    private sessionsRefresh;
+    private readonly readCursorStates;
+    private readLifecycleGeneration;
+    private requestedSessionId;
+    constructor(options: CustomerSupportClientOptions);
+    get session(): CustomerSupportSession | null;
+    get messages(): readonly CustomerSupportMessage[];
+    get connectionState(): AiEmployeeConnectionState;
+    on<K extends keyof CustomerSupportClientEventMap>(type: K, listener: CustomerSupportClientListener<K>): () => void;
+    start(): Promise<void>;
+    prepareNewConversation(): void;
+    bindSession(sessionId: string): Promise<void>;
+    sendMessage(content: string): Promise<CustomerSupportMessage>;
+    listSessions(): Promise<readonly CustomerSupportSession[]>;
+    destroy(): void;
+    private refreshHistory;
+    private markReadIfNeeded;
+    private submitReadCursor;
+    private readCursorState;
+    private isCurrentReadRequest;
+    private openSocket;
+    private authenticate;
+    private handleSocketData;
+    private handleServerMessage;
+    private handleCustomerSupportEvent;
+    private refreshFromRealtime;
+    private refreshSessions;
+    private refreshSessionsFromRealtime;
+    private replaceSessions;
+    private upsertSession;
+    private refreshSessionFromRealtime;
+    private appendMessage;
+    private startHeartbeat;
+    private handleSocketClose;
+    private scheduleAvailabilityReconnect;
+    private scheduleReconnect;
+    private clearTimers;
+    private isCurrentSocket;
+    private setState;
+    private emitError;
+    private emit;
+    private assertUsable;
+}
+
+type NotificationReadStatus = 'unread' | 'read';
+type NotificationContentType = 'text' | 'markdown';
+interface NotificationSource {
+    type: string;
+    code: string;
+    id: string;
+    name: string;
+    avatarUrl: string;
+}
+interface NotificationResource {
+    type: string;
+    id: string;
+    title: string;
+    aeCode: string;
+}
+interface NotificationAttachment {
+    fileId: string;
+    versionId: string;
+    name: string;
+    sizeBytes: number;
+    mimeType: string;
+}
+interface NotificationDto {
+    id: string;
+    type: string;
+    typeName: string;
+    title: string;
+    summary: string;
+    content: string;
+    contentType: NotificationContentType;
+    priority: string;
+    source: NotificationSource | null;
+    resources: readonly NotificationResource[];
+    attachments: readonly NotificationAttachment[];
+    readStatus: NotificationReadStatus;
+    readAt: string | null;
+    archivedAt: string | null;
+    createdAt: string;
+    expiresAt: string | null;
+}
+/** 分类目录条目：稳定 code 加后端字典给出的展示名（可能为空）。 */
+interface NotificationTypeSummary {
+    type: string;
+    name: string;
+}
+interface NotificationInboxQuery {
+    pageSize: number;
+    beforeId?: string | null;
+    includeTypeFacets?: boolean;
+    notificationTypes?: readonly string[];
+    readStatus?: 'all' | 'unread' | 'read';
+    includeArchived?: boolean;
+    applicationName: string;
+}
+interface NotificationInboxResult {
+    items: readonly NotificationDto[];
+    hasMore: boolean;
+    nextId: string | null;
+    types?: readonly NotificationTypeSummary[];
+}
+interface NotificationMarkReadResult {
+    unreadCount: number;
+    readAt: string | null;
+}
+interface NotificationMarkAllReadResult {
+    markedCount: number;
+    unreadCount: number;
+}
+type NotificationRealtimeChange = {
+    kind: 'created';
+    notification: NotificationDto;
+    unreadCount?: number;
+} | {
+    kind: 'read';
+    notificationIds: readonly string[];
+    unreadCount?: number;
+    readAt?: string | null;
+} | {
+    kind: 'archived';
+    notificationIds: readonly string[];
+    unreadCount?: number;
+};
+interface NotificationCenterTransport {
+    listInbox(query: NotificationInboxQuery): Promise<NotificationInboxResult>;
+    getUnreadCount(params: {
+        applicationName: string;
+    }): Promise<{
+        unreadCount: number;
+    }>;
+    markRead(params: {
+        notificationId: string;
+        applicationName: string;
+    }): Promise<NotificationMarkReadResult>;
+    markAllRead(params: {
+        beforeId?: string | null;
+        notificationTypes?: readonly string[];
+        applicationName: string;
+    }): Promise<NotificationMarkAllReadResult>;
+    downloadAttachment(params: {
+        fileId: string;
+        name?: string;
+    }): Promise<Blob>;
+    archive?(params: {
+        notificationId: string;
+        applicationName: string;
+    }): Promise<{
+        unreadCount: number;
+    }>;
+    parseRealtimeEvent?(event: unknown): NotificationRealtimeChange | null;
+}
+interface NotificationCenterClientOptions {
+    transport: NotificationCenterTransport;
+    applicationName: string;
+    pageSize?: number;
+    readStatus?: 'all' | 'unread' | 'read';
+    preferredTypeOrder?: readonly string[];
+}
+type NotificationCenterErrorCode = 'INVALID_CONFIGURATION' | 'INBOX_LOAD_FAILED' | 'MARK_READ_FAILED' | 'DOWNLOAD_FAILED' | 'CLIENT_DESTROYED';
+interface NotificationCenterErrorDetail {
+    code: NotificationCenterErrorCode;
+    message: string;
+    recoverable: boolean;
+}
+interface NotificationCenterClientEventMap {
+    ready: Record<string, never>;
+    inbox: NotificationInboxResult;
+    'types-change': {
+        types: readonly NotificationTypeSummary[];
+    };
+    'unread-count-change': {
+        unreadCount: number;
+    };
+    'notification-read': {
+        notificationId: string;
+    };
+    error: NotificationCenterErrorDetail;
+}
+type NotificationCenterClientListener<K extends keyof NotificationCenterClientEventMap> = (detail: NotificationCenterClientEventMap[K]) => void;
+
+declare class NotificationCenterClientError extends Error {
+    readonly code: NotificationCenterErrorCode;
+    constructor(code: NotificationCenterErrorCode, message: string);
+}
+/**
+ * Inbox store and HTTP orchestration for the notification center.
+ *
+ * The client owns no realtime connection. The host keeps the single
+ * `/api/user-realtime/ws` socket it already maintains for its other channels and
+ * hands notification events in through {@link applyRealtimeEvent}; cursors,
+ * heartbeats, authentication and reconnect stay on the host side.
+ */
+declare class NotificationCenterClient {
+    private readonly transport;
+    private readonly applicationName;
+    private readonly pageSize;
+    private readonly readStatus;
+    private readonly preferredTypeOrder;
+    private readonly listeners;
+    private items;
+    private hasMore;
+    private nextId;
+    private unreadCount;
+    private notificationTypes;
+    private availableTypes;
+    private typeCatalogFromBackend;
+    private inboxGeneration;
+    private destroyed;
+    private loadingInbox;
+    private pendingResync;
+    constructor(options: NotificationCenterClientOptions);
+    get notifications(): readonly NotificationDto[];
+    get unread(): number;
+    /** 数据中实际存在的通知分类，供 UI 渲染页签；不是写死的枚举。 */
+    get types(): readonly NotificationTypeSummary[];
+    on<K extends keyof NotificationCenterClientEventMap>(type: K, listener: NotificationCenterClientListener<K>): () => void;
+    start(): Promise<void>;
+    setTypeFilter(types: readonly string[]): Promise<void>;
+    getTypeFilter(): readonly string[];
+    loadMore(): Promise<void>;
+    refresh(): Promise<void>;
+    /**
+     * Consume a notification realtime event captured by the host socket.
+     *
+     * The raw event is mapped through the transport so the DTO contract stays in
+     * this SDK; anything that cannot be mapped degrades to a full refresh. Events
+     * that arrive while an inbox request is in flight are replaced by a resync so a
+     * late server page cannot drop them.
+     */
+    applyRealtimeEvent(event: unknown): void;
+    markRead(notificationId: string): Promise<void>;
+    markAllRead(): Promise<void>;
+    downloadAttachment(fileId: string, name?: string): Promise<Blob>;
+    destroy(): void;
+    private reloadInbox;
+    private finishInboxLoad;
+    /**
+     * 分类页签的数据来源。
+     *
+     * `notification_type` 是后端自由文本列，展示名来自后端字典（`notification_type_name`），
+     * 前端不维护 code 到中文名的映射。权威目录是 `inbox` 在 `includeTypeFacets` 下返回的
+     * `types`（后端按收件人可见范围统计，忽略类型筛选与分页）；后端未提供时退回累积已加载
+     * 页面里出现过的分类——这在分页深处才出现的分类上会暂时缺页签，属已知取舍。
+     */
+    private applyTypeCatalog;
+    private rememberTypes;
+    private setAvailableTypes;
+    private refreshUnreadCount;
+    private applyRealtimeChange;
+    private syncRealtimeUnreadCount;
+    private applyRead;
+    private refreshFromRealtime;
+    private emitInbox;
+    private setUnreadCount;
+    private emitError;
+    private emit;
+    private assertUsable;
+}
+
+type JsonRecord = Record<string, unknown>;
+interface AuthenticateFrame {
+    type: 'authenticate';
+    protocol_version: 1;
+    access_token: string;
+    requested_channels: ['ai_employee'];
+    cursors: Record<string, never>;
+}
+interface SessionSubscriptionFrame {
+    action: 'subscribe' | 'unsubscribe';
+    channel: 'ai_employee';
+    resource_type: 'session';
+    resource_id: string;
+    replay_history?: boolean;
+}
+interface PingFrame {
+    action: 'ping';
+    timestamp: string;
+}
+interface ParsedSessionMessage {
+    messages: AiEmployeeMessage[];
+    fallbackResult?: AiEmployeeMessage;
+    processing?: boolean;
+}
+type ParsedAiEmployeeEvent = {
+    kind: 'session-message';
+    sessionId: string;
+    result: ParsedSessionMessage;
+} | {
+    kind: 'session-title';
+    sessionId: string;
+    title: string;
+} | {
+    kind: 'ignored';
+};
+declare function createAuthenticateFrame(accessToken: string): AuthenticateFrame;
+declare function createSubscriptionFrame(sessionId: string, action?: 'subscribe' | 'unsubscribe', replayHistory?: boolean): SessionSubscriptionFrame;
+declare function createPingFrame(now?: Date): PingFrame;
+declare function parseJsonRecord(raw: string): JsonRecord | null;
+declare function parseAiEmployeeEvent(raw: unknown): ParsedAiEmployeeEvent;
+declare function hashText(value: string): string;
+
+export { type AiEmployeeAssistantAction, type AiEmployeeAttachmentReference, AiEmployeeClient, AiEmployeeClientError, type AiEmployeeClientErrorDetail, type AiEmployeeClientEventMap, type AiEmployeeClientListener, type AiEmployeeClientOptions, type AiEmployeeClientStartResult, type AiEmployeeConnectionState, type AiEmployeeErrorCode, type AiEmployeeFirstMessageOptions, type AiEmployeeFirstMessageRequest, type AiEmployeeFirstMessageRequestState, type AiEmployeeFirstMessageRequestStore, type AiEmployeeFirstMessageResult, type AiEmployeeMessage, type AiEmployeeMessageRole, type AiEmployeeReconnectOptions, type AiEmployeeSessionSummary, type AiEmployeeTransport, AiEmployeeTransportError, type AiEmployeeTransportErrorCode, type AiEmployeeWebSocketFactory, type AuthenticateFrame, type CustomerSupportAgent, CustomerSupportClient, CustomerSupportClientError, type CustomerSupportClientEventMap, type CustomerSupportClientListener, type CustomerSupportClientOptions, type CustomerSupportCreateSessionRequest, type CustomerSupportCreateSessionResult, type CustomerSupportErrorCode, type CustomerSupportErrorDetail, type CustomerSupportHandoffRequest, type CustomerSupportHandoffResult, type CustomerSupportMessage, type CustomerSupportMessagePage, type CustomerSupportSenderType, type CustomerSupportSession, type CustomerSupportSessionStatus, type CustomerSupportTransport, type NotificationAttachment, NotificationCenterClient, NotificationCenterClientError, type NotificationCenterClientEventMap, type NotificationCenterClientListener, type NotificationCenterClientOptions, type NotificationCenterErrorCode, type NotificationCenterErrorDetail, type NotificationCenterTransport, type NotificationContentType, type NotificationDto, type NotificationInboxQuery, type NotificationInboxResult, type NotificationMarkAllReadResult, type NotificationMarkReadResult, type NotificationReadStatus, type NotificationRealtimeChange, type NotificationResource, type NotificationSource, type NotificationTypeSummary, type OpenCustomerSupportAssistantAction, type ParsedAiEmployeeAssistantContent, type ParsedAiEmployeeEvent, type ParsedSessionMessage, type PingFrame, type SessionSubscriptionFrame, createAuthenticateFrame, createPingFrame, createSubscriptionFrame, hashText, isUuidV4, parseAiEmployeeAssistantContent, parseAiEmployeeEvent, parseJsonRecord };