@bdky/aaas-pilot-kit 1.0.2 → 1.0.3

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

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

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

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

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

@@ -4,7 +4,7 @@ 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';
+import type { IResolvedOptions, IAaaSPilotKitController, IAaaSPilotKitEmitter } from '../types/config';
 export interface IAsrMessageEventPayload {
     text: string;
     completed: boolean;
@@ -41,9 +41,9 @@ export declare class AaaSPilotKitController<AS extends BaseAgentService = BaseAg
     /** playWaitFor监听listener */
     private playWaitForListener;
     private readonly weirwood;
-    constructor(opts: Required<IOptions>, errorManager: ErrorManager, agentService: AS, asrService: BaseAsrService, digitalHumanService: BaseDigitalHumanService, conversationService: ConversationService);
+    constructor(opts: IResolvedOptions, errorManager: ErrorManager, agentService: AS, asrService: BaseAsrService, digitalHumanService: BaseDigitalHumanService, conversationService: ConversationService);
     mount: ($container?: HTMLElement) => Promise<void>;
-    getOptions: () => Required<IOptions>;
+    getOptions: () => IResolvedOptions;
     checkNeedsManualActivation: () => boolean;
     activateManually: () => Promise<void>;
     keepAlive: () => IAaaSPilotKitController;

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

@@ -28,6 +28,7 @@ export declare const ERROR_CODES: {
     readonly ASR_SESSION_INVALID: "3011";
     readonly ASR_MUTE_FAILED: "3012";
     readonly ASR_MESSAGE_INTERVAL_TIMEOUT: "3013";
+    readonly ASR_RUNTIME_ERROR: "3014";
     readonly DH_MOUNT_FAILED: "4001";
     readonly DH_IFRAME_LOAD_ERROR: "4002";
     readonly DH_RENDER_ERROR: "4003";

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

@@ -21,3 +21,6 @@ export declare class AsrMessageParseError extends AsrError {
 export declare class AsrMessageIntervalTimeoutError extends AsrError {
     constructor(message?: string, metadata?: Partial<IErrorMetadata>);
 }
+export declare class AsrRuntimeError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}

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

@@ -1,6 +1,6 @@
 import Emittery from 'emittery';
 import { CommonRequest } from '../../api/request';
-import type { IOptions } from '../../../types/config';
+import type { IResolvedOptions } from '../../../types/config';
 import { ErrorManager } from '../../error';
 export declare namespace NBaseAgentService {
     interface IEventWithSessionIdPayload {
@@ -28,7 +28,7 @@ export declare namespace NBaseAgentService {
 export declare abstract class BaseAgentService<E extends NBaseAgentService.IEmitter = NBaseAgentService.IEmitter> {
     readonly request: CommonRequest;
     readonly errorManager: ErrorManager;
-    readonly opts: Required<IOptions>;
+    readonly opts: IResolvedOptions;
     readonly emitter: Emittery<E, E & import("emittery").OmnipresentEventData, import("emittery").DatalessEventNames<E>>;
     protected conversationSessionId: string;
     protected abortController: AbortController | null;
@@ -40,7 +40,7 @@ export declare abstract class BaseAgentService<E extends NBaseAgentService.IEmit
      * 上一轮的query id
      */
     protected _lastQueryId: string;
-    constructor(request: CommonRequest, errorManager: ErrorManager, opts: Required<IOptions>);
+    constructor(request: CommonRequest, errorManager: ErrorManager, opts: IResolvedOptions);
     get sessionId(): string;
     get queryId(): string;
     get lastQueryId(): string;

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

@@ -1,4 +1,4 @@
-import { IOptions } from '../../../types/config';
+import type { IResolvedOptions } from '../../../types/config';
 import { ConversationBean, type IConversationBeanSnapshot, NConversationBean } from './conversationBean';
 import { NMultimodalContent, ImageContent, VideoContent, TextContent } from './content';
 export declare namespace NAIWorkerConversationBean {
@@ -18,13 +18,13 @@ export declare namespace NAIWorkerConversationBean {
     }
 }
 export declare class AIWorkerConversationBean extends ConversationBean<'aiWorker', NAIWorkerConversationBean.IEmitter> {
-    readonly opts: Required<IOptions>;
+    readonly opts: IResolvedOptions;
     contents: Array<ImageContent | VideoContent | TextContent>;
     private readonly queue;
     private readonly customXmlParser;
-    constructor(d: Partial<IConversationBeanSnapshot<'aiWorker'>>, opts: Required<IOptions>);
+    constructor(d: Partial<IConversationBeanSnapshot<'aiWorker'>>, opts: IResolvedOptions);
     get fulltext(): string;
-    static create: (opts: Required<IOptions>) => AIWorkerConversationBean;
+    static create: (opts: IResolvedOptions) => AIWorkerConversationBean;
     static isAllTextContents: (contents: Array<ImageContent | VideoContent | TextContent>) => contents is TextContent[];
     static isTextContent: (content: TextContent | ImageContent | VideoContent) => content is TextContent;
     static isImageContent: (content: TextContent | ImageContent | VideoContent) => content is ImageContent;

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

@@ -1,5 +1,5 @@
 import { ConversationBean, NConversationBean, type IConversationBeanSnapshot } from './conversationBean';
-import { IOptions } from '../../../types/config';
+import type { IResolvedOptions } from '../../../types/config';
 import { NMultimodalContent } from './content';
 export declare namespace NClientConversationBean {
     interface IContentChangePayload {
@@ -16,9 +16,9 @@ export declare namespace NClientConversationBean {
     }
 }
 export declare class ClientConversationBean extends ConversationBean<'client', NClientConversationBean.IEmitter> {
-    readonly opts: Required<IOptions>;
-    constructor(d: Partial<IConversationBeanSnapshot<'client'>>, opts: Required<IOptions>);
-    static create(opts: Required<IOptions>): ClientConversationBean;
+    readonly opts: IResolvedOptions;
+    constructor(d: Partial<IConversationBeanSnapshot<'client'>>, opts: IResolvedOptions);
+    static create(opts: IResolvedOptions): ClientConversationBean;
     appendText: (text: string) => void;
     dispose: () => void;
     interrupt: () => void;

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

@@ -1,5 +1,5 @@
 import Emittery from 'emittery';
-import { IOptions } from '../../../types/config';
+import type { IResolvedOptions } from '../../../types/config';
 export type ConversationKind = 'client' | 'aiWorker';
 export interface IConversationBeanSnapshot<K extends ConversationKind = ConversationKind> {
     id: string;
@@ -11,12 +11,12 @@ export declare namespace NConversationBean {
     }
 }
 export declare abstract class ConversationBean<K extends ConversationKind, E = NConversationBean.IEmitter> implements IConversationBeanSnapshot<K> {
-    readonly opts: Required<IOptions>;
+    readonly opts: IResolvedOptions;
     readonly emitter: Emittery<E, E & import("emittery").OmnipresentEventData, import("emittery").DatalessEventNames<E>>;
     id: string;
     type: K;
     text: string;
-    protected constructor(d: Partial<IConversationBeanSnapshot<K>>, opts: Required<IOptions>);
+    protected constructor(d: Partial<IConversationBeanSnapshot<K>>, opts: IResolvedOptions);
     update: (d: Partial<IConversationBeanSnapshot>) => void;
     toJSON: () => Required<IConversationBeanSnapshot>;
     abstract appendText(text: string): void;

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

@@ -1,15 +1,15 @@
 import { type IConversationBeanSnapshot } from './conversationBean';
 import { ClientConversationBean } from './clientConversationBean';
 import { AIWorkerConversationBean } from './aiWorkerConversationBean';
-import type { IOptions } from '../../../types/config';
+import type { IResolvedOptions } from '../../../types/config';
 export type AnyConversation = ClientConversationBean | AIWorkerConversationBean;
 export type IConversationFormatter = (text: string) => string;
 export declare class ConversationService {
-    readonly opts: Required<IOptions>;
+    readonly opts: IResolvedOptions;
     beans: AnyConversation[];
     currentConversation: AnyConversation | null;
     private aiWorkerConversationFormatters;
-    constructor(opts: Required<IOptions>);
+    constructor(opts: IResolvedOptions);
     get last(): AnyConversation | null;
     get currentClientConversation(): ClientConversationBean | null;
     get currentAIWorkerConversation(): AIWorkerConversationBean | null;

package/dist/libs/aaas-pilot-kit/src/lib/service/digital-human/BaseDigitalHumanService.d.ts

@@ -31,7 +31,7 @@ export declare abstract class BaseDigitalHumanService {
     protected readonly opts: IOptions;
     protected readonly request: CommonRequest;
     protected readonly errorManager: ErrorManager;
-    protected static readonly GET_ACCESS_TOKEN_REQUEST_URI = "deepsight/employee/v1/get_digital_token";
+    protected static readonly GET_ACCESS_TOKEN_REQUEST_URI = "employee-console/v1/access/r/ai-agent/get_digital_token";
     emitter: Emittery<NAbstractDigitalHumanService.IEmitter>;
     protected _isRendering: boolean;
     protected _isMuted: boolean;

package/dist/libs/aaas-pilot-kit/src/lib/service/rtc-asr/asr/baseAsrService.d.ts

@@ -1,5 +1,5 @@
 import Emittery from 'emittery';
-import type { IOptions } from '../../../../types/config';
+import type { IResolvedOptions } from '../../../../types/config';
 import type { BaseSignalingService } from '../signal/base';
 import { ErrorManager } from '../../../error';
 export declare namespace NBaseAsrService {
@@ -47,7 +47,7 @@ export declare namespace NBaseAsrService {
     }
 }
 export declare abstract class BaseAsrService<E = NBaseAsrService.IEmitter> {
-    readonly opts: Required<IOptions>;
+    readonly opts: IResolvedOptions;
     readonly signalingService: BaseSignalingService;
     readonly errorManager: ErrorManager;
     disabled: boolean;
@@ -55,7 +55,7 @@ export declare abstract class BaseAsrService<E = NBaseAsrService.IEmitter> {
     muted: boolean;
     readonly emitter: Emittery<E, E & import("emittery").OmnipresentEventData, import("emittery").DatalessEventNames<E>>;
     protected started: boolean;
-    constructor(opts: Required<IOptions>, signalingService: BaseSignalingService, errorManager: ErrorManager);
+    constructor(opts: IResolvedOptions, signalingService: BaseSignalingService, errorManager: ErrorManager);
     get sessionId(): string | null;
     mute: (muted: boolean) => void;
     setMutedByUser: (muted: boolean) => void;

package/dist/libs/aaas-pilot-kit/src/lib/service/rtc-asr/signal/base.d.ts

@@ -2,14 +2,14 @@
  * @file 基础 RTC 信令服务抽象类
  * @author zhangwenxi(zhangwenxi@baidu.com)
  */
-import type { IOptions } from '../../../../types/config';
+import type { IResolvedOptions } from '../../../../types/config';
 import { ErrorManager } from '../../../error';
 export declare abstract class BaseSignalingService {
-    readonly opts: Required<IOptions>;
+    readonly opts: IResolvedOptions;
     readonly errorManager: ErrorManager;
     protected started: boolean;
     protected sessionId: string;
-    constructor(opts: Required<IOptions>, errorManager: ErrorManager);
+    constructor(opts: IResolvedOptions, errorManager: ErrorManager);
     protected readonly _dispose: () => void;
     abstract Start<P extends Record<string, any>>(opts: P): Promise<void>;
     abstract Stop(): Promise<void>;

package/dist/libs/aaas-pilot-kit/src/lib/service/rtc-asr/signal/brtc.d.ts

@@ -40,7 +40,7 @@ export declare namespace NBRTCSignalingService {
         remotevideoviewid?: string | HTMLElement;
         localvideoviewid?: string | HTMLElement;
         success?: () => void;
-        error?: (err: Error) => void;
+        error?: (err: string) => void;
         onmessage?: (msg: IRawMessage) => void;
         userevent_joinedroom?: (id: string, display: string, attribute: string) => void;
         userevent_leavingroom?: (id: string, display: string) => void;
@@ -57,7 +57,7 @@ export declare class BRTCSignalingService extends BaseSignalingService {
     static ONLINE_PREFIX_URL: string;
     static SANDBOX_PREFIX_URL: string;
     static AUTH_URL: string;
-    appId: string;
+    private currentAppId;
     get prefixUrl(): string;
     Start: (params: NBRTCSignalingService.IStartParams) => Promise<void>;
     Stop: () => Promise<void>;

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

@@ -1,3 +1,19 @@
+export declare const getBrowserInfo: () => {
+    userAgent: string;
+    browser: {
+        name: string | undefined;
+        version: string | undefined;
+    };
+    os: {
+        name: string | undefined;
+        version: string | undefined;
+    };
+    device: {
+        type: string | undefined;
+        vendor: string | undefined;
+        model: string | undefined;
+    };
+};
 export declare const isInWeChat: () => boolean;
 export declare const isIOS: () => boolean;
 export declare const isIPadOS: () => boolean;

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

@@ -2,7 +2,7 @@ import type { Newable } from 'inversify';
 import type { AgentConfig } from './agent';
 import type { Env } from './common';
 import { BaseAgentService, NBaseAgentService } from '../lib/service/agent/baseAgentService';
-import type { ReplacementRule } from '../lib/utils/applyTextReplacements';
+import { type ReplacementRule } from '../lib/utils/applyTextReplacements';
 import { NPictureClientDigitalHumanService } from '../lib/service/digital-human/PictureClientDigitalHumanService';
 import Emittery from 'emittery';
 import { AnyConversation, type IConversationBeanSnapshot } from '../lib/service/conversation';
@@ -98,9 +98,11 @@ export interface IOptions<AS extends BaseAgentService = BaseAgentService> {
      */
     enTypeDelay?: number;
     /**
-     *  TODO 大模型 API 相关配置 (现在区分外呼和客服，后续应该统一参数，不应该走 XOR 逻辑)
+     * 🧠【选填】标准 Agent 配置（外呼 / 客服）
+     * - 未传自定义 `agentService` 时，此配置必填，用于驱动内置 Agent 服务
+     * - 已传 `agentService` 时请勿再配置，将由自定义服务完全接管
      */
-    agentConfig: AgentConfig;
+    agentConfig?: AgentConfig;
     /**
      * 📦【选填】挂载容器获取函数 —— 返回你要挂载数字员工形象的 DOM 节点
      * 💡 若不传，需确保在调用 mount($container?: HTMLElement): Promise<void> 时传入，同时确保容器 DOM 已存在
@@ -226,7 +228,7 @@ export interface IOptions<AS extends BaseAgentService = BaseAgentService> {
     conversationFormatters?: TFormatter[];
     /**
      * 🧠【选填】自定义 Agent 服务类（需继承 BaseAgentService）
-     * 用于实现私有 Agent 流式 Api 协议对接，这个绑定后 agentConfig 配置将不可用
+     * 用于实现私有 Agent 流式 Api 协议对接。传入后将完全接管 Agent 相关能力，因此可省略 `agentConfig`。
      */
     agentService?: Newable<AS>;
     /**
@@ -241,7 +243,31 @@ export interface IOptions<AS extends BaseAgentService = BaseAgentService> {
      * ❌ 设为 false → 保留原始背景（适合已有透明通道的素材）
      */
     autoChromaKey?: boolean;
+    /**
+     * 🔌【隐藏参数】RTC 应用 ID（内部使用）
+     * ✅ 默认：'apprjff5d4wek7t'
+     * ⚠️ 外部用户直接使用默认值即可，内部开发可能需要传入不同的值
+     */
+    rtcID?: string;
 }
+export declare const DEFAULT_OPTIONS: {
+    readonly enableDebugMode: false;
+    readonly minSplitLen: 5;
+    readonly ttsModel: "02-turbo";
+    readonly env: "production";
+    readonly asrVad: 600;
+    readonly interruptible: true;
+    readonly rendererMode: "cloud";
+    readonly autoChromaKey: true;
+    readonly typeDelay: 163;
+    readonly enTypeDelay: 45;
+    readonly inactivityPrompt: "您这么久没讲话，是不是有其它事情要忙，那我先挂断了";
+    readonly getMountContainer: () => HTMLElement;
+    readonly hotWordReplacementRules: ReplacementRule[];
+    readonly rtcID: "appreimunmd7utp";
+};
+type DefaultedOptionKeys = keyof typeof DEFAULT_OPTIONS;
+export type IResolvedOptions<AS extends BaseAgentService = BaseAgentService> = IOptions<AS> & Required<Pick<IOptions<AS>, DefaultedOptionKeys>>;
 export interface IAaaSPilotKitEmitter {
     /**
      * 🔇【状态事件】静音状态变更
@@ -419,7 +445,7 @@ export interface IAaaSPilotKitController {
      *
      * @returns 合并默认值后的完整配置对象
      */
-    getOptions(): Required<IOptions>;
+    getOptions(): IResolvedOptions;
     /**
      * 🎬【非流式】整段文本驱动播报 —— 适合预生成回复、公告播报
      *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bdky/aaas-pilot-kit",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "license": "MIT",
     "contributors": [
         {