@bdky/aaas-pilot-kit 1.0.2

package/dist/ky-aaas-pilot-kit.umd.js.LICENSE.txt

@@ -0,0 +1,45 @@
+/*! *****************************************************************************
+Copyright (C) Microsoft. All rights reserved.
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy of the
+License at http://www.apache.org/licenses/LICENSE-2.0
+
+THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
+WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
+MERCHANTABLITY OR NON-INFRINGEMENT.
+
+See the Apache Version 2.0 License for specific language governing permissions
+and limitations under the License.
+***************************************************************************** */
+
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+/*! MIT License © Sindre Sorhus */
+
+/**
+ * TraceKit - Cross brower stack traces
+ *
+ * This was originally forked from github.com/occ/TraceKit, but has since been
+ * largely modified and is now maintained as part of Sentry JS SDK.
+ *
+ * NOTE: Last merge with upstream repository
+ * Jul 11,2018 - #f03357c
+ *
+ * https://github.com/csnover/TraceKit
+ * @license MIT
+ * @namespace TraceKit
+ */

package/dist/libs/aaas-pilot-kit/src/http.d.ts

@@ -0,0 +1,4 @@
+export { default as ky } from 'ky';
+export type { KyInstance, Input, Options, NormalizedOptions, RetryOptions, SearchParamsOption, Progress, Hooks, BeforeRequestHook, BeforeRetryHook, BeforeRetryState, BeforeErrorHook, AfterResponseHook, ResponsePromise, KyRequest, KyResponse } from 'ky';
+export { HTTPError, TimeoutError } from 'ky';
+export * as sseHook from '@baidu/ky-sse-hook';

package/dist/libs/aaas-pilot-kit/src/index.d.ts

@@ -0,0 +1,5 @@
+export { BaseAgentService } from './lib/service/agent/baseAgentService';
+export * from './types/config';
+export * from './lib/service/conversation';
+export * from './lib/aaas-pilot-kit';
+export * from './lib/controller';

package/dist/libs/aaas-pilot-kit/src/lib/DI/types.d.ts

@@ -0,0 +1,12 @@
+export declare const TYPES: {
+    readonly AaaSPilotKitController: symbol;
+    readonly SignalingService: symbol;
+    readonly ASRService: symbol;
+    readonly AgentService: symbol;
+    readonly DigitalHumanService: symbol;
+    readonly ConversationService: symbol;
+    readonly CommonRequest: symbol;
+    readonly ErrorManager: symbol;
+    readonly IOptions: symbol;
+};
+export type TypeKeys = keyof typeof TYPES;

package/dist/libs/aaas-pilot-kit/src/lib/aaas-pilot-kit.d.ts

@@ -0,0 +1,5 @@
+import 'reflect-metadata';
+import { AaaSPilotKitController } from './controller';
+import type { IOptions } from '../types/config';
+import { BaseAgentService } from './service/agent/baseAgentService';
+export declare const createAaaSPilotKit: <AS extends BaseAgentService = BaseAgentService>(opts: IOptions) => AaaSPilotKitController<AS>;

package/dist/libs/aaas-pilot-kit/src/lib/api/request.d.ts

@@ -0,0 +1,9 @@
+import { KyInstance } from 'ky';
+import type { IOptions } from '../../types/config';
+export declare class CommonRequest {
+    readonly opts: Required<IOptions>;
+    static ONLINE_HOST: string;
+    static SANDBOX_HOST: string;
+    client: KyInstance;
+    constructor(opts: Required<IOptions>);
+}

package/dist/libs/aaas-pilot-kit/src/lib/constants/env.d.ts

@@ -0,0 +1 @@
+export declare const WEIRWOOD_TOKEN = "8f3abab4743f4114bd632999224323af";

package/dist/libs/aaas-pilot-kit/src/lib/controller.d.ts

@@ -0,0 +1,107 @@
+import Emittery from 'emittery';
+import { BaseAgentService } from './service/agent/baseAgentService';
+import { BaseAsrService } from './service/rtc-asr/asr/baseAsrService';
+import { BaseDigitalHumanService } from './service/digital-human/BaseDigitalHumanService';
+import { ConversationService } from './service/conversation';
+import { ErrorManager } from './error';
+import type { IOptions, IAaaSPilotKitController, IAaaSPilotKitEmitter } from '../types/config';
+export interface IAsrMessageEventPayload {
+    text: string;
+    completed: boolean;
+    id: string;
+    sessionId: string;
+}
+export interface IBusyEventPayload {
+    requestId?: string;
+    queryId?: string;
+    sessionId?: string;
+}
+export interface IInterruptEventPayload {
+    requestId?: string;
+    queryId?: string;
+    sessionId?: string;
+}
+export declare class AaaSPilotKitController<AS extends BaseAgentService = BaseAgentService> implements IAaaSPilotKitController {
+    private readonly opts;
+    private readonly errorManager;
+    readonly agentService: AS;
+    private readonly asrService;
+    private readonly digitalHumanService;
+    readonly conversationService: ConversationService;
+    static ENTRY_EMITTER_NAME: string;
+    emitter: Emittery<IAaaSPilotKitEmitter>;
+    interruptible: boolean;
+    private isRenderingMultiModConversation;
+    private isDigitalHumanServiceReady;
+    private isAsrServiceReady;
+    /** 缓存最新一条agent消息 */
+    private aiWorkerMessageCache;
+    /** 用于中断渲染中的多模态消息的signal */
+    private multiModAbortControllers;
+    /** playWaitFor监听listener */
+    private playWaitForListener;
+    private readonly weirwood;
+    constructor(opts: Required<IOptions>, errorManager: ErrorManager, agentService: AS, asrService: BaseAsrService, digitalHumanService: BaseDigitalHumanService, conversationService: ConversationService);
+    mount: ($container?: HTMLElement) => Promise<void>;
+    getOptions: () => Required<IOptions>;
+    checkNeedsManualActivation: () => boolean;
+    activateManually: () => Promise<void>;
+    keepAlive: () => IAaaSPilotKitController;
+    /**
+     * 请求播放文本
+     *
+     * 如果当前正在播放，则在当前播放内容结束之后再进行播放；否则直接播放
+     *
+     * 如果传入了 shouldStillPlay 函数，则会在播放前调用该函数，如果返回 false，则不会播放
+     */
+    playWaitFor: (text: string, shouldStillPlay?: () => boolean) => Promise<boolean>;
+    playFromFullText: (_fullText: string) => IAaaSPilotKitController;
+    playFromStreamText: (_chunk: string, hasEnded?: boolean) => IAaaSPilotKitController;
+    mute: (muted: boolean) => IAaaSPilotKitController;
+    interrupt: () => IAaaSPilotKitController;
+    playPrologue: () => void;
+    /**
+     * query输入
+     *
+     * @param input 用户输入
+     * @param completed tue: 输入结束 false: 输入中间态
+     */
+    query: (input: string, completed: boolean) => Promise<void>;
+    input: (text: string) => IAaaSPilotKitController;
+    dispose: () => IAaaSPilotKitController;
+    setInterruptible: (interruptible: boolean) => IAaaSPilotKitController;
+    private readonly bindAsrServiceEvents;
+    private readonly bindAgentServiceEvents;
+    private readonly bindDigitalHumanServiceEvents;
+    private readonly bindErrorEvents;
+    private readonly bindEvents;
+    private readonly registerFormatters;
+    /**
+     * 将数字员工播报的字幕转成conversation
+     */
+    private readonly aiWorkerSubtitleToConversation;
+    private readonly handleAgentAnswer;
+    private readonly handleXmlAgentAnswer;
+    /**
+     * 当前对话不是AI Worker的对话，则创建新的对话
+     */
+    private readonly createNewAIWorkerConversation;
+    private readonly handleAgentAnswerCompleted;
+    private readonly handleAgentInstructionReceived;
+    private readonly handleAsrServiceStarted;
+    /**
+     * 处理asr消息
+     */
+    private readonly handleAsrMessage;
+    /**
+     * 处理client conversation
+     */
+    private readonly handleClientConversation;
+    private readonly handleClientConversationCompleted;
+    /**
+     * 打断正在渲染的ai worker conversation
+     */
+    private readonly interruptAIWorkerConversation;
+    private readonly checkServiceReady;
+    private readonly handleAIWorkerConversationChange;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/BaseError.d.ts

@@ -0,0 +1,12 @@
+import { ErrorCategory, ErrorSeverity, IErrorMetadata, IErrorDetails } from './types';
+export declare class BaseError extends Error implements IErrorDetails {
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly metadata: IErrorMetadata;
+    readonly actionRequired?: string;
+    constructor(code: string, message: string, category: ErrorCategory, severity?: ErrorSeverity, metadata?: Partial<IErrorMetadata>, actionRequired?: string);
+    static fromError(error: Error, code: string, category: ErrorCategory, severity?: ErrorSeverity): BaseError;
+    toJSON(): IErrorDetails;
+    toString(): string;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/ErrorEmitter.d.ts

@@ -0,0 +1,54 @@
+import { BaseError } from './BaseError';
+export interface IErrorEventPayload {
+    /** 错误代码 */
+    code: string;
+    /** 错误消息（包含 toString() 的内容） */
+    message: string;
+    /** 错误堆栈 */
+    stack?: string;
+    /** 用户操作指导 */
+    actionRequired: string | null;
+    /** 错误严重级别 */
+    severity: string;
+    /** 错误元数据 */
+    metadata: {
+        timestamp: number;
+        sessionId?: string;
+        requestId?: string;
+        userId?: string;
+        service?: string;
+        context?: Record<string, any>;
+    };
+    /** 原始错误对象（用于内部处理） */
+    originalError?: Error;
+}
+export interface IErrorEmitterEvents {
+    error: IErrorEventPayload;
+}
+export declare class ErrorEmitter {
+    private readonly emitter;
+    /**
+     * 上报错误到外层
+     */
+    emit: (error: Error | BaseError) => void;
+    /**
+     * 监听错误事件
+     */
+    on: (listener: (payload: IErrorEventPayload) => void) => void;
+    /**
+     * 移除错误监听
+     */
+    off: (listener: (payload: IErrorEventPayload) => void) => void;
+    /**
+     * 清除所有监听器
+     */
+    clearListeners: () => void;
+    /**
+     * 将错误对象转换为标准的事件载荷
+     */
+    private readonly transformErrorToPayload;
+    /**
+     * 从错误对象中提取服务类型
+     */
+    private readonly extractServiceFromError;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/ErrorHandler.d.ts

@@ -0,0 +1,17 @@
+import { IErrorHandler, IErrorReporter, IErrorDetails } from './types';
+import { type IErrorManagerOptions } from './ErrorManager';
+export declare class ErrorHandler implements IErrorHandler {
+    private readonly opts;
+    private readonly reporters;
+    constructor(opts: IErrorManagerOptions);
+    addReporter(reporter: IErrorReporter): void;
+    removeReporter(reporter: IErrorReporter): void;
+    handle(error: Error | IErrorDetails): Promise<void>;
+    private processError;
+    private shouldLogError;
+    private shouldReportError;
+    private logError;
+    private getLogLevel;
+    private reportError;
+    private isErrorDetails;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/ErrorManager.d.ts

@@ -0,0 +1,34 @@
+import { ErrorHandler } from './ErrorHandler';
+import { BaseError } from './BaseError';
+import { ErrorEmitter, IErrorEventPayload } from './ErrorEmitter';
+import { MonitoringError } from './monitoring/MonitoringError';
+import type { IOptions } from '../../types/config';
+export interface IErrorManagerOptions {
+    enableConsoleReporter?: boolean;
+    enableHttpReporter?: boolean;
+    httpReporterEndpoint?: string;
+    enableErrorLogging?: boolean;
+    enableErrorReporting?: boolean;
+}
+export declare class ErrorManager extends ErrorEmitter {
+    private readonly opts;
+    private readonly errorHandler;
+    private readonly options;
+    constructor(opts: IOptions);
+    handleError: (error: Error | BaseError) => Promise<void>;
+    getErrorHandler: () => ErrorHandler;
+    getActionRequired: (error: Error) => string | null;
+    /**
+     * 创建用于监控平台的错误实例
+     */
+    createMonitoringError: (payload: IErrorEventPayload) => MonitoringError;
+    /**
+     * 构建增强的错误消息
+     */
+    private readonly buildEnhancedMessage;
+    /**
+     * 序列化元数据，排除内部字段
+     */
+    private readonly stringifyMetadata;
+    private readonly initializeReporters;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/codes.d.ts

@@ -0,0 +1,57 @@
+export declare const ERROR_CODES: {
+    readonly COMMON_UNKNOWN: "1000";
+    readonly COMMON_NETWORK_ERROR: "1001";
+    readonly COMMON_TIMEOUT: "1002";
+    readonly COMMON_INVALID_CONFIG: "1003";
+    readonly COMMON_AUTHENTICATION_FAILED: "1004";
+    readonly COMMON_AUTHORIZATION_FAILED: "1005";
+    readonly COMMON_VALIDATION_ERROR: "1006";
+    readonly COMMON_RESOURCE_NOT_FOUND: "1007";
+    readonly COMMON_RESOURCE_UNAVAILABLE: "1008";
+    readonly COMMON_INTERNAL_ERROR: "1009";
+    readonly AGENT_QUERY_FAILED: "2001";
+    readonly AGENT_RESPONSE_PARSE_ERROR: "2002";
+    readonly AGENT_REQUEST_TIMEOUT: "2003";
+    readonly AGENT_INVALID_RESPONSE: "2004";
+    readonly AGENT_CONNECTION_FAILED: "2005";
+    readonly AGENT_INSTRUCTION_INVALID: "2006";
+    readonly ASR_INITIALIZATION_FAILED: "3001";
+    readonly ASR_START_FAILED: "3002";
+    readonly ASR_STOP_FAILED: "3003";
+    readonly ASR_SIGNALING_ERROR: "3004";
+    readonly ASR_AUDIO_CAPTURE_ERROR: "3005";
+    readonly ASR_RECOGNITION_ERROR: "3006";
+    readonly ASR_NETWORK_ERROR: "3007";
+    readonly ASR_PERMISSION_DENIED: "3008";
+    readonly ASR_DEVICE_NOT_FOUND: "3009";
+    readonly ASR_MESSAGE_PARSE_ERROR: "3010";
+    readonly ASR_SESSION_INVALID: "3011";
+    readonly ASR_MUTE_FAILED: "3012";
+    readonly ASR_MESSAGE_INTERVAL_TIMEOUT: "3013";
+    readonly DH_MOUNT_FAILED: "4001";
+    readonly DH_IFRAME_LOAD_ERROR: "4002";
+    readonly DH_RENDER_ERROR: "4003";
+    readonly DH_WEBSOCKET_ERROR: "4004";
+    readonly DH_RTC_ERROR: "4005";
+    readonly DH_AUTHENTICATION_ERROR: "4006";
+    readonly DH_REACH_SESSION_LIMIT: "4007";
+    readonly DH_RESOURCE_NOT_ENOUGH: "4008";
+    readonly DH_TIMEOUT: "4009";
+    readonly DH_INTERRUPT_FAILED: "4010";
+    readonly DH_SSML_PARSE_ERROR: "4011";
+    readonly DH_INVALID_FIGURE_ID: "4012";
+    readonly DH_INVALID_TOKEN: "4013";
+    readonly DH_STREAM_RENDER_ERROR: "4014";
+    readonly DH_CONTROLLER_NOT_READY: "4015";
+    readonly DH_TEXT_LENGTH_MISMATCH: "4016";
+    readonly CONVERSATION_CREATE_FAILED: "5001";
+    readonly CONVERSATION_INVALID_TYPE: "5002";
+    readonly CONVERSATION_SNAPSHOT_INVALID: "5003";
+    readonly CONVERSATION_BEAN_NOT_FOUND: "5004";
+    readonly CONVERSATION_SERIALIZE_ERROR: "5005";
+    readonly CONVERSATION_DESERIALIZE_ERROR: "5006";
+    readonly CONVERSATION_STATE_INVALID: "5007";
+    readonly CONVERSATION_CLEAR_FAILED: "5008";
+};
+export type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];
+export declare const ERROR_MESSAGES: Record<ErrorCode, string>;

package/dist/libs/aaas-pilot-kit/src/lib/error/index.d.ts

@@ -0,0 +1,16 @@
+import { AgentError, AsrError, DigitalHumanError, ConversationError } from './services';
+export { BaseError } from './BaseError';
+export { ErrorHandler } from './ErrorHandler';
+export { ErrorManager } from './ErrorManager';
+export type { IErrorMetadata, IErrorDetails, IErrorReporter, IErrorHandler } from './types';
+export { ErrorCategory, ErrorSeverity } from './types';
+export { ERROR_CODES, ERROR_MESSAGES } from './codes';
+export type { ErrorCode } from './codes';
+export * from './services';
+export * from './reporters';
+export { ErrorUtils } from './utils/ErrorUtils';
+export { ErrorEmitter, type IErrorEventPayload, type IErrorEmitterEvents } from './ErrorEmitter';
+export declare const createAgentError: (message: string, code?: string) => AgentError;
+export declare const createAsrError: (message: string, code?: string) => AsrError;
+export declare const createDigitalHumanError: (message: string, code?: string) => DigitalHumanError;
+export declare const createConversationError: (message: string, code?: string) => ConversationError;

package/dist/libs/aaas-pilot-kit/src/lib/error/monitoring/MonitoringError.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 监控平台自定义错误类
+ * 基于现代化 ES6+ 语法实现，符合监控平台要求
+ */
+export interface IMonitoringErrorData extends Record<any, any> {
+    page?: string;
+    userId?: string;
+    sessionId?: string;
+    requestId?: string;
+    context?: Record<string, any>;
+    severity?: string;
+    category?: string;
+    code?: string;
+    originalMessage?: string;
+}
+/**
+ * 用于监控平台上报的自定义错误类
+ * 符合监控平台的自定义错误实现规范
+ */
+export declare class MonitoringError extends Error {
+    readonly name: string;
+    readonly message: string;
+    readonly stack: string | undefined;
+    readonly data: IMonitoringErrorData;
+    constructor(type: string, enhancedMessage: string, data?: IMonitoringErrorData);
+    /**
+     * 创建用于监控平台的错误实例
+     */
+    static createForMonitoring(type: string, enhancedMessage: string, data: IMonitoringErrorData): MonitoringError;
+    /**
+     * 获取用于监控平台上报的数据
+     */
+    getMonitoringData(): Record<string, any>;
+    /**
+     * 获取简化的上报数据（用于控制台输出）
+     */
+    getSimplifiedData(): Record<string, any>;
+    /**
+     * 重写 toString 方法
+     */
+    toString(): string;
+    /**
+     * 重写 toJSON 方法，用于序列化
+     */
+    toJSON(): Record<string, any>;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/reporters/ConsoleReporter.d.ts

@@ -0,0 +1,4 @@
+import { IErrorReporter, IErrorDetails } from '../types';
+export declare class ConsoleReporter implements IErrorReporter {
+    report(error: IErrorDetails): Promise<void>;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/reporters/HttpReporter.d.ts

@@ -0,0 +1,16 @@
+import type { IErrorReporter, IErrorDetails } from '../types';
+export interface IHttpReporterOptions {
+    endpoint: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    retryCount?: number;
+    retryDelay?: number;
+}
+export declare class HttpReporter implements IErrorReporter {
+    private readonly options;
+    constructor(options: IHttpReporterOptions);
+    report(error: IErrorDetails): Promise<void>;
+    private buildPayload;
+    private sendRequest;
+    private delay;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/reporters/index.d.ts

@@ -0,0 +1,2 @@
+export { ConsoleReporter } from './ConsoleReporter';
+export { HttpReporter, type IHttpReporterOptions } from './HttpReporter';

package/dist/libs/aaas-pilot-kit/src/lib/error/services/AgentError.d.ts

@@ -0,0 +1,17 @@
+import { BaseError } from '../BaseError';
+import { ErrorSeverity, IErrorMetadata } from '../types';
+export declare class AgentError extends BaseError {
+    constructor(code: string, message?: string, severity?: ErrorSeverity, metadata?: Partial<IErrorMetadata>, actionRequired?: string);
+}
+export declare class AgentQueryError extends AgentError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AgentResponseParseError extends AgentError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AgentConnectionError extends AgentError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AgentInstructionError extends AgentError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/services/AsrError.d.ts

@@ -0,0 +1,23 @@
+import { BaseError } from '../BaseError';
+import { ErrorSeverity, IErrorMetadata } from '../types';
+export declare class AsrError extends BaseError {
+    constructor(code: string, message?: string, severity?: ErrorSeverity, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrInitializationError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrStartError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrStopError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrPermissionError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrMessageParseError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrMessageIntervalTimeoutError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/services/ConversationError.d.ts

@@ -0,0 +1,23 @@
+import { BaseError } from '../BaseError';
+import { ErrorSeverity, IErrorMetadata } from '../types';
+export declare class ConversationError extends BaseError {
+    constructor(code: string, message?: string, severity?: ErrorSeverity, metadata?: Partial<IErrorMetadata>);
+}
+export declare class ConversationCreateError extends ConversationError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class ConversationInvalidTypeError extends ConversationError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class ConversationSnapshotError extends ConversationError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class ConversationBeanNotFoundError extends ConversationError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class ConversationSerializeError extends ConversationError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class ConversationDeserializeError extends ConversationError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/services/DigitalHumanError.d.ts

@@ -0,0 +1,32 @@
+import { BaseError } from '../BaseError';
+import { ErrorSeverity, IErrorMetadata } from '../types';
+export declare class DigitalHumanError extends BaseError {
+    constructor(code: string, message?: string, severity?: ErrorSeverity, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanMountError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanIframeError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanRenderError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanWebSocketError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanRtcError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanAuthError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanResourceError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanSsmlError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class DigitalHumanInvalidTokenError extends DigitalHumanError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './AgentError';
+export * from './AsrError';
+export * from './DigitalHumanError';
+export * from './ConversationError';

package/dist/libs/aaas-pilot-kit/src/lib/error/types.d.ts

@@ -0,0 +1,41 @@
+export declare enum ErrorCategory {
+    NETWORK = "NETWORK",
+    TIMEOUT = "TIMEOUT",
+    AUTHENTICATION = "AUTHENTICATION",
+    AUTHORIZATION = "AUTHORIZATION",
+    RESOURCE = "RESOURCE",
+    CONFIGURATION = "CONFIGURATION",
+    PARSING = "PARSING",
+    SERVICE = "SERVICE",
+    VALIDATION = "VALIDATION",
+    INTERNAL = "INTERNAL"
+}
+export declare enum ErrorSeverity {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    CRITICAL = "CRITICAL"
+}
+export interface IErrorMetadata {
+    timestamp: number;
+    sessionId?: string;
+    requestId?: string;
+    userId?: string;
+    context?: Record<string, any>;
+    stack?: string;
+    originalError?: Error;
+}
+export interface IErrorDetails {
+    code: string;
+    message: string;
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    metadata: IErrorMetadata;
+    actionRequired?: string;
+}
+export interface IErrorReporter {
+    report(error: IErrorDetails): Promise<void>;
+}
+export interface IErrorHandler {
+    handle(error: Error | IErrorDetails): Promise<void>;
+}

package/dist/libs/aaas-pilot-kit/src/lib/error/utils/ErrorUtils.d.ts

@@ -0,0 +1,7 @@
+import { ErrorSeverity, type IErrorMetadata } from '../types';
+export declare class ErrorUtils {
+    static getErrorSeverity(error: Error): ErrorSeverity;
+    static shouldReport(error: Error): boolean;
+    static extractMetadata(error: Error, context?: Record<string, any>): IErrorMetadata;
+    static getActionRequired(error: Error): string | null;
+}