keepwork-sdk 1.0.0

package/dist-npm/types/src/digital-human/DigitalHuman.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DigitalHuman.d.ts","sourceRoot":"","sources":["../../../../src/digital-human/DigitalHuman.ts"],"names":[],"mappings":"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"}

package/dist-npm/types/src/digital-human/DigitalHumanBridge.d.ts

@@ -0,0 +1,54 @@
+/**
+ * DigitalHumanBridge.ts — DigitalHuman 外部上下文与 page-router 心跳桥接工具
+ *
+ * 这些函数操作传入的 DigitalHuman 实例（target）内部字段，用于：
+ * - 管理"外部上下文"的去抖自动 flush（注入额外上下文后延迟发送 "(continue)"）
+ * - 停止 page-router 心跳调度
+ */
+/** 外部上下文消息 */
+export interface ExternalContextMessage {
+    /** 上下文文本 */
+    text?: string;
+    /** 去抖毫秒数；省略或非有限值表示一直缓存到下次用户消息 */
+    debounce?: number;
+    /** 是否跳过历史记录 */
+    skipHistory?: boolean;
+}
+/**
+ * 桥接函数操作的目标对象（DigitalHuman 实例需具备的字段/方法）。
+ * 用结构化接口而非 any，保持类型安全。
+ */
+export interface ExternalContextTarget {
+    _externalContextDebounceTimer: ReturnType<typeof setTimeout> | null;
+    _externalContextSkipHistory: boolean;
+    _pageRouterHeartbeatToken: number;
+    _pageRouterHeartbeatTimer: ReturnType<typeof setTimeout> | null;
+    /** 缓存外部上下文 */
+    sendContext(text: string): void;
+    /** 发送用户消息 */
+    send(text: string, options?: Record<string, unknown>): Promise<unknown>;
+    /** 内部 auto-flush 实现（由 autoFlushExternalContext 触发） */
+    _autoFlushExternalContext(): Promise<unknown> | void;
+}
+/**
+ * 清除待发送的外部上下文去抖定时器。
+ * 外部上下文本身已被 sendContext() 入队，此处仅停止延迟的 "(continue)" auto-flush。
+ */
+export declare function clearExternalContextDebounce(target: ExternalContextTarget): void;
+/**
+ * 停止 page-router 心跳调度并使在途定时器失效（通过自增 token）。
+ */
+export declare function stopPageRouterHeartbeat(target: ExternalContextTarget): void;
+/**
+ * 缓存外部上下文，并可选地启动 auto-flush 去抖定时器。
+ * 默认去抖为 Infinity（上下文一直排队，直到下一条显式用户消息）；
+ * 有限去抖值会在到期后自动发送 "(continue)"。
+ * @returns 是否成功处理（text 非空）
+ */
+export declare function handleExternalContextMessage(target: ExternalContextTarget, msg?: ExternalContextMessage): boolean;
+/**
+ * 通过发送合成的 "(continue)" 用户消息来 auto-flush 缓存的外部上下文。
+ * 当缓存上下文请求了 skipHistory 时，转发 fullHistoryOnly 以保留原行为。
+ */
+export declare function autoFlushExternalContext(target: ExternalContextTarget): Promise<unknown>;
+//# sourceMappingURL=DigitalHumanBridge.d.ts.map

package/dist-npm/types/src/digital-human/DigitalHumanBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DigitalHumanBridge.d.ts","sourceRoot":"","sources":["../../../../src/digital-human/DigitalHumanBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc;AACd,MAAM,WAAW,sBAAsB;IACrC,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IACpE,2BAA2B,EAAE,OAAO,CAAC;IACrC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAChE,cAAc;IACd,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa;IACb,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,sDAAsD;IACtD,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAKhF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,EAC7B,GAAG,GAAE,sBAA2B,GAC/B,OAAO,CAkBT;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAI9F"}

package/dist-npm/types/src/digital-human/DigitalHumanConfig.d.ts

@@ -0,0 +1,104 @@
+/**
+ * DigitalHumanConfig.ts — DigitalHuman 配置解析工具
+ *
+ * 把 DigitalHuman 的原始配置对象拆解为各子系统所需的配置片段：
+ * ChatSession 配置、Frame 状态、工具分类、FileOps、searchPaths、keepHistory 等。
+ *
+ * 这些函数处理用户提供的松散配置对象，故大量使用 `Record<string, unknown>` /
+ * 可选字段；难以静态约束处用 unknown + 运行时判断，避免 any。
+ */
+/** DigitalHuman 原始配置（松散结构，仅声明常用字段，其余通过索引签名） */
+export type DigitalHumanConfigInput = Record<string, unknown> & {
+    _configSourceUrl?: string;
+    system_prompt?: string;
+    enable_system_prompt?: boolean;
+    llm_model?: string;
+    tools?: Record<string, unknown>;
+    workspace?: string;
+    mountFolder?: string;
+    searchPaths?: SearchPathInput[];
+};
+/** searchPath 原始条目 */
+export interface SearchPathInput {
+    prefix?: string;
+    baseUrl?: string;
+    baseUrlLocal?: string;
+    [key: string]: unknown;
+}
+/** 解析后的 searchPath 条目 */
+export interface ResolvedSearchPathEntry {
+    prefix: string;
+    baseUrl: string;
+}
+/**
+ * 在解析后的配置对象上记录原始配置源 URL，
+ * 以便后续将相对资源（如 searchPaths）解析为绝对地址。
+ * 内联 JSON（以 `{` 开头）默认不记录，除非 allowInlineJson=true。
+ */
+export declare function markConfigSourceUrl<T extends Record<string, unknown>>(config: T, source: string | Record<string, unknown>, options?: {
+    allowInlineJson?: boolean;
+}): T;
+/**
+ * 从 DigitalHuman 配置派生出 ChatSession 所需的配置片段。
+ */
+export declare function buildDigitalHumanSessionConfig(config?: DigitalHumanConfigInput): Record<string, unknown>;
+/** DigitalHumanFrame 初始状态片段 */
+export interface DigitalHumanFrameState {
+    characterInfo: Record<string, unknown>;
+    initialMessage: string;
+    quickReplies: unknown[];
+    objective: unknown;
+    completionMessages: unknown;
+    voiceChatConfig: Record<string, unknown>;
+    subtitleConfig: unknown;
+    avatarOnlyMode: boolean;
+}
+/**
+ * 从配置中提取 DigitalHumanFrame 的初始状态。
+ */
+export declare function extractDigitalHumanFrameState(config?: DigitalHumanConfigInput): DigitalHumanFrameState;
+/**
+ * 根据配置构建启用的工具分类列表。
+ * 若提供 options.resolveEnabledCategories（来自 CopilotTools），优先使用其结果。
+ */
+export declare function resolveEnabledToolCategories(config?: DigitalHumanConfigInput, options?: {
+    resolveEnabledCategories?: (tools: unknown) => string[];
+}): string[];
+/**
+ * 重建 restartAgent 的工具配置：保留非分类键，并把指定分类强制 enabled=true。
+ */
+export declare function buildRestartToolConfig(enabledCategories?: string[], sourceTools?: Record<string, unknown>, options?: {
+    registry?: Record<string, unknown>;
+}): Record<string, unknown>;
+/** resolveFileOpsConfig 返回结构 */
+export interface ResolvedFileOpsConfig {
+    fileOps: Record<string, unknown>;
+    workspace: string | undefined;
+    mountFolder: string | undefined;
+    pathPrefix: string | undefined;
+    searchPaths: SearchPathInput[];
+}
+/**
+ * 从 DigitalHuman 配置中解析 FileOps 的 workspace / pathPrefix / searchPaths。
+ */
+export declare function resolveFileOpsConfig(config?: DigitalHumanConfigInput): ResolvedFileOpsConfig;
+/**
+ * 解析并绝对化 PersonalPageStore 的 search-path 条目。
+ * 相对 baseUrl 会基于记录的配置源 URL 展开；本地主机下 baseUrlLocal 优先。
+ */
+export declare function resolveSearchPathEntries(config?: DigitalHumanConfigInput, fallbackConfig?: DigitalHumanConfigInput | null): ResolvedSearchPathEntry[];
+/** keepHistory 配置解析结果 */
+export interface ResolvedKeepHistoryConfig {
+    enabled: boolean;
+    historyLength: number;
+    fileName: string;
+    keepFullHistory: boolean;
+    dailyDeltaThreshold: number;
+    autoSummarizeContentThreshold: number;
+}
+/**
+ * 从 createSession / characterConfig / constructor 解析 keepHistory 配置。
+ * @param source - true 表示使用默认值；对象则覆盖默认值；其余返回 null。
+ */
+export declare function resolveKeepHistoryConfig(source: boolean | Record<string, unknown> | null | undefined): ResolvedKeepHistoryConfig | null;
+//# sourceMappingURL=DigitalHumanConfig.d.ts.map

package/dist-npm/types/src/digital-human/DigitalHumanConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DigitalHumanConfig.d.ts","sourceRoot":"","sources":["../../../../src/digital-human/DigitalHumanConfig.ts"],"names":[],"mappings":"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"}

package/dist-npm/types/src/digital-human/DigitalHumanFrame.d.ts

@@ -0,0 +1,390 @@
+/**
+ * DigitalHumanFrame — Renders a DigitalHuman avatar inside an iframe (via srcdoc),
+ * exposing the same public API as DigitalHuman. AI tool calls inside the iframe
+ * are automatically delegated to the parent frame's AIChatSession via AgentRouter
+ * and the SandboxToolEnv toolProxy mechanism.
+ *
+ * Why iframe?
+ *   - Process isolation: Live2D / heavy video rendering won't block the parent page.
+ *   - Style isolation: Avatar CSS and PIXI globals don't leak into the host page.
+ *   - Easy teardown: destroying the iframe reclaims all resources.
+ *
+ * Architecture (AgentRouter based tool delegation):
+ *   1. Parent creates a local proxy session for resolving tool calls and registers it
+ *      with the AgentRouter as \`parentToolAgent_\${frameId}\`.
+ *   2. Iframe runs a full KeepworkSDK and owns the REAL AI Session.
+ *   3. Iframe configures its session with a \`toolProxy\` that maps all
+ *      tool categories to the \`parentToolAgent_\${frameId}\` agent.
+ *   4. When the Iframe AI wants to call a tool (e.g. \`read_file\`), the iframe's
+ *      SandboxToolEnv intercepts it and uses AgentRouter.submitTask({ toolCallOnly: true })
+ *      to send the execution command to the Parent.
+ *   5. Parent's AgentRouter receives it, maps it to the local proxy session,
+ *      which then delegates back to the Parent's real \`sdk.copilotTools.execute()\`.
+ *
+ * Usage:
+ *   const dhf = new DigitalHumanFrame({ sdk, container: document.getElementById('avatar-root') });
+ *   await dhf.initFromConfig(config);       // same config as DigitalHuman, including textToSpeech.autoReadReply
+ *   dhf.on('message', ({ partialText }) => { ... });
+ *   await dhf.send('Hello');
+ *   dhf.playAction('happy', 5);
+ */
+type DHFAny = Record<string, any>;
+export default class DigitalHumanFrame {
+    sdk: DHFAny;
+    container: HTMLElement;
+    workspace: unknown;
+    frameId: string;
+    parentToolAgentName: string;
+    characterConfig: DHFAny | null;
+    characterInfo: DHFAny | null;
+    voiceChatConfig: DHFAny;
+    _iframe: HTMLIFrameElement | null;
+    _pendingCalls: Map<string, DHFAny>;
+    _commands: Record<string, DHFAny>;
+    [key: string]: any;
+    /**
+     * @param {Object} options
+     * @param {Object} options.sdk - KeepworkSDK instance (used for tool execution on parent side)
+     * @param {HTMLElement} options.container - Container element for the iframe
+     * @param {string} [options.sdkSrc] - URL to keepworkSDK.iife.js
+     * @param {boolean} [options.useLocalSdk] - Set to true if sdkSrc is a local ES module instead of IIFE bundle
+     */
+    constructor({ sdk, container, sdkSrc, useLocalSdk, useExternalHtml, workspace, proxyCategories, subtitle }?: DHFAny);
+    get on(): any;
+    get off(): any;
+    get emit(): any;
+    /**
+     * Auto-register the `minigame` copilot tool category on the PARENT SDK and
+     * subscribe this frame to iframe events. Because the inner DigitalHuman
+     * proxies all LLM tool calls to the parent via AgentRouter, the minigame
+     * overlay is always created in the containing window (not inside the
+     * iframe). Default `gameFinished` handling:
+     *   1. Emit `minigameEvent` for host integrations.
+     *   2. Call `this.restartAgent()` so the inner DH picks up workspace changes.
+     * Disable step 2 via characterConfig.minigame.autoRestartAgent = false.
+     */
+    _registerMinigameTool(): void;
+    launchSkill(promptFile?: string, options?: DHFAny): Promise<{
+        ok: boolean;
+        slot: any;
+        restart: DHFAny;
+        session: any;
+    }>;
+    preloadSkill(promptFile?: DHFAny, options?: DHFAny): Promise<{
+        ok: boolean;
+        slot: any;
+        restart: DHFAny;
+        session: any;
+        preloaded: boolean;
+    }>;
+    showPreloadedSkill(options?: DHFAny): Promise<{
+        ok: boolean;
+        reason: string;
+        slot?: undefined;
+        session?: undefined;
+    } | {
+        ok: boolean;
+        slot: any;
+        session: any;
+        reason: string;
+    } | {
+        ok: boolean;
+        slot: any;
+        session: any;
+        reason?: undefined;
+    }>;
+    _handleLaunchedMinigameClosed(data: DHFAny, launchSession: DHFAny): Promise<void>;
+    _formatMinigameResult(data?: DHFAny, session?: DHFAny): string;
+    _createProxySession(): void;
+    _registerDigitalHumanProxyAPIs(): void;
+    _destroyProxySession(): void;
+    /**
+     * Close a minigame iframe overlay (if open) and optionally restart the agent.
+     * @param {Object} [options]
+     * @param {string} [options.slot] - Slot to close. Defaults to active slot.
+     * @param {string} [options.reason='user'] - Close reason passed to MinigameTools.close()
+     * @param {boolean} [options.restartAgent=true] - Whether to restart the agent after closing
+     * @returns {Promise<void>}
+     */
+    closeMinigame(options?: DHFAny): Promise<void>;
+    /** Forward user ASR subtitles from the DigitalHuman iframe into the active minigame. */
+    _forwardUserVoiceInputToMinigame(data?: DHFAny): void;
+    _forwardAssistantSpeakingToMinigame(data?: DHFAny): void;
+    /**
+     * Inject parent tool definitions and proxy category list into a config
+     * before sending it to the iframe. The iframe's setupToolProxy reads these
+     * to register unknown categories and build the proxy map dynamically.
+     * @param {Object} config - The session/init config (mutated in place)
+     */
+    _injectParentToolInfo(config: DHFAny): void;
+    /** Create and inject the iframe into the container. */
+    _ensureIframe(): any;
+    /**
+     * Send a command to the iframe and wait for a response.
+     * @param {string} type - Message type
+     * @param {Object} [payload] - Additional payload fields
+     * @returns {Promise<Object>} The response result
+     */
+    _rpc(type: string, payload?: DHFAny): Promise<DHFAny>;
+    /** Send a fire-and-forget command to the iframe (no response expected). */
+    _post(type: string, payload?: DHFAny): void;
+    _handleMessage(e: MessageEvent): void;
+    /**
+     * Handle an external send message. Optionally interrupts, then forwards
+     * to the iframe via the SEND RPC.
+     * @private
+     * @param {Object} msg - { type: 'dh:send', text: string, interrupt?: boolean, options?: object }
+     */
+    _handleExternalSend(msg: DHFAny): Promise<void>;
+    /**
+     * Handle an external context message. Sends context to the iframe and
+     * optionally starts a debounce timer for auto-flush.
+     * @private
+     */
+    _handleExternalContext(msg: DHFAny): void;
+    /** @private */
+    _autoFlushExternalContext(): Promise<void>;
+    /** @private */
+    _sendCurrentPageRouterWakeupIfNeeded(): Promise<boolean>;
+    /**
+     * Wait for the inner voice agent to become ready by listening for the
+     * first `voiceChatState` event relayed from the iframe.
+     * @private
+     * @param {number} [timeout=8000]
+     * @returns {Promise<boolean>}
+     */
+    _waitForVoiceReady(timeout?: number): Promise<unknown>;
+    /** @private */
+    _startPageRouterHeartbeat(page: string, routerEntry: DHFAny): void;
+    /**
+     * Handle an AppPageOpened message. Forwards to the iframe DigitalHuman
+     * which owns the pageRouters config and handles agent switching.
+     * @private
+     * @param {Object} msg - { type: 'dh:app-page-opened', page: string }
+     */
+    _handleAppPageOpened(msg: DHFAny): Promise<void>;
+    /**
+     * Register a slash command intercepted by send().
+     * @param {string} name - Command name (without /)
+     * @param {Object} def
+     * @param {string} def.description - Short help text
+     * @param {boolean} [def.needsArg=true] - Whether the command requires an argument
+     * @param {function(string, DigitalHumanFrame):void|Promise<void>} def.handler
+     */
+    registerCommand(name: string, { description, needsArg, handler }: DHFAny): void;
+    unregisterCommand(name: string): void;
+    listCommands(): {
+        name: string;
+        description: any;
+        needsArg: any;
+    }[];
+    tryCommand(text: string): {
+        handled: boolean;
+        name?: undefined;
+        error?: undefined;
+        result?: undefined;
+    } | {
+        handled: boolean;
+        name: string;
+        error: string;
+        result?: undefined;
+    } | {
+        handled: boolean;
+        name: string;
+        result: any;
+        error?: undefined;
+    };
+    initAvatar(videoActions: DHFAny, options?: DHFAny): Promise<void>;
+    /**
+     * Shared pre-processing for configs sent to the iframe: sync workspace/mountFolder
+     * to the parent proxy session, inject parent tool info, and pre-resolve
+     * summarizeAgent.config URLs.
+     * @param {Object} config - Mutated in place
+     */
+    _prepareConfigForIframe(config: DHFAny): Promise<void>;
+    initFromConfig(config?: DHFAny): Promise<{
+        session: any;
+        config: any;
+        character: any;
+        initial_message: any;
+        quick_replies: any;
+        objective: any;
+        completion_messages: any;
+        voiceChat: any;
+    }>;
+    /**
+     * Load a DigitalHuman config from a URL (JSON / YML / MD), inline JSON string, or object,
+     * then initialize the iframe avatar and AI session in one call.
+     *
+     * The config is fetched and parsed on the parent side (using DigitalHuman.fetchConfig),
+     * then passed to the iframe via the existing initFromConfig RPC.
+     *
+     * @param {string|Object} source - URL string, JSON string, or config object
+     * @returns {Promise<Object>} Result of initFromConfig
+     */
+    loadConfig(source: DHFAny): Promise<{
+        session: any;
+        config: any;
+        character: any;
+        initial_message: any;
+        quick_replies: any;
+        objective: any;
+        completion_messages: any;
+        voiceChat: any;
+    }>;
+    createSession(config?: DHFAny): Promise<any>;
+    /**
+     * Get the current session (parent-side proxy).
+     * @returns {Object|null}
+     */
+    getSession(): any;
+    /**
+     * Unified send — mirrors DigitalHuman.send().
+      * Pass options.autoReadReply=false to suppress automatic text-mode reply playback.
+     */
+    send(userMessage: string, options?: DHFAny): Promise<any>;
+    /**
+     * Send a message via the inner text AI session.
+     */
+    sendMessage(userMessage: string, options?: DHFAny): Promise<any>;
+    /**
+     * Cancel any active/queued text sends (aborts in-flight LLM requests and stops TTS).
+     * Useful for barge-in scenarios where a new user utterance should immediately
+     * supersede the current response.
+     * @param {string} [reason='barge-in'] - Reason label for logging/debugging
+     * @returns {Promise<{canceledCount: number}>}
+     */
+    cancelSend(reason?: string): Promise<any>;
+    /**
+     * Expand an inline system prompt inside the iframe's own DigitalHuman session.
+     * This avoids resolving ${...} against the parent proxy sandbox.
+     * @param {string} text
+     * @returns {Promise<string>}
+     */
+    expandInlineSystemPrompt(text: string): Promise<any>;
+    /**
+     * Send the configured boot message explicitly after the caller finishes
+     * restoring any prior history into the UI.
+     */
+    sendBootMessage(bootMessage: string, options?: DHFAny): Promise<any>;
+    /**
+     * Immediately send heartbeat text in the inner DigitalHuman. If text is omitted,
+     * the inner DigitalHuman uses the current page router heartbeatText, then
+     * falls back to "[heartbeat]".
+     * @param {string} [text]
+     * @param {Object} [options] - send() options forwarded to DigitalHuman.
+     * @returns {Promise<Object>}
+     */
+    sendHeartbeat(text: string, options?: DHFAny): Promise<any>;
+    /**
+     * Trigger the voice heartbeat path immediately from the host app.
+     * This uses the same RTC voice guards and event stream as automatic
+     * silence heartbeat, but the app provides the current business context.
+     * @param {string|Object} input - Explicit heartbeat text, or { text, reason, context, data }.
+     * @param {Object} [options] - Heartbeat options forwarded to DigitalHuman.
+     * @returns {Promise<Object>}
+     */
+    triggerVoiceHeartbeat(input?: {}, options?: DHFAny): Promise<any>;
+    /**
+     * Set whether the framed DigitalHuman is actively listening/speaking.
+     * This does not switch text/voice mode.
+     * @param {boolean} active
+     * @param {Object} [options]
+     * @returns {Promise<Object>}
+     */
+    setActive(active?: boolean, options?: DHFAny): Promise<DHFAny>;
+    get isActive(): any;
+    playAction(actionKey: string, duration?: number): void;
+    switchVideo(type: string): void;
+    switchToIdle(): void;
+    switchToTalking(): void;
+    setMouthOpen(value: number): void;
+    playMotion(preferredGroups: DHFAny, priority?: number): void;
+    getActions(): Promise<any>;
+    getActionList(lang?: string): Promise<any>;
+    getAvatarStatus(): Promise<any>;
+    getSessionData(): Promise<any>;
+    startVoiceChat(preset?: {}, options?: DHFAny): Promise<void>;
+    stopVoiceChat(): Promise<void>;
+    setSubtitleConfig(config?: DHFAny): Promise<any>;
+    getSubtitleConfig(): Promise<any>;
+    clearSubtitle(options?: DHFAny): Promise<DHFAny>;
+    /**
+     * Update an active voice chat session (REST API proxy).
+     * @param {string} command - e.g. 'ExternalTextToSpeech', 'UpdateParameters', 'interrupt'
+     * @param {Object} [options] - Additional fields (Message, InterruptMode, Parameters, etc.)
+     * @returns {Promise<Object>}
+     */
+    updateVoiceChat(command: string, options?: DHFAny): Promise<DHFAny>;
+    /**
+     * Restart voice chat with optional config overrides (deep-merged into the last preset).
+     * @param {Object} [configOverrides] - Partial preset overrides
+     * @returns {Promise<Object>}
+     */
+    restartVoiceChat(configOverrides?: DHFAny): Promise<DHFAny>;
+    /** @private */
+    _cancelRestartAgentDebounce(result?: DHFAny): boolean;
+    /**
+     * Restart the agent session with an optional prompt file.
+     * Delegates to the iframe's DigitalHuman.restartAgent() via RPC.
+     * @param {string} [promptFile] - URL or path to agent config file
+     * @param {string[]} [tools] - Optional tool category override. Empty means inherit defaults.
+     * @param {Object} [options]
+    * @param {number} [options.debounceMs=0] - Delay empty-prompt restarts; cancelled by any later explicit prompt restart.
+    * @param {boolean} [options.autoContinue=true] - Automatically send "(continue)" after a prompt-file restart.
+     * @returns {Promise<Object>} { configSource, mode }
+     */
+    restartAgent(promptFile?: string, tools?: DHFAny, options?: DHFAny): Promise<DHFAny>;
+    handleAuthStateChange(change?: DHFAny): Promise<any>;
+    reloadForAuthChange(change?: DHFAny): Promise<any>;
+    /**
+     * Tear down the iframe, proxy session, registered search paths and pending RPCs.
+     * Shared by destroy() and reloadForAuthChange(). Does NOT remove outer-instance
+     * listeners (window message, auth, minigame, audio resume) since the DHF
+     * instance may continue living after a reload.
+     * @private
+     * @param {string} [pendingRejectReason]
+     */
+    _tearDownIframe(pendingRejectReason?: string): Promise<void>;
+    sendText(text: string): void;
+    sendVoiceText(text: string): void;
+    /**
+     * Send background context to the voice chat LLM via WebSocket (binary channel).
+     * Does not trigger a reply — injected as context for the next response.
+     * @param {string} text - Context text
+     * @param {Object} [options]
+     * @param {boolean} [options.insertToHistory=false] - Also persist as a Q/A pair in history
+     */
+    sendContext(text: string, options?: DHFAny): void;
+    /**
+     * Send text to the agent's TTS (text-to-speech) via the iframe voice chat session.
+     * @param {string} text
+     * @param {Object} [options]
+     * @param {boolean} [options.useREST=false] - Use REST API instead of binary channel
+     * @param {number} [options.interruptMode] - REST only: interrupt priority
+     */
+    sendTTS(text: string, options?: DHFAny): void;
+    /**
+     * Load a dedicated summarize agent config.
+     * The config is fetched on the parent side and sent to the iframe DigitalHuman.
+     * @param {string|Object} source - Config URL, JSON string, or config object
+     * @returns {Promise<void>}
+     */
+    loadSummarizeAgentConfig(source: DHFAny): Promise<void>;
+    /**
+     * Trigger conversation summarization in the iframe DigitalHuman.
+     * Returns immediately. Only one summarization runs at a time; subsequent
+     * calls are queued and merged so the latest options win.
+     * Listen for the 'summarized' event to receive the result.
+     * @param {Object} [options]
+     * @param {number} [options.keepRecentRounds] - Recent pairs to preserve
+     * @param {string} [options.mode] - 'replace' or 'append'
+     */
+    summarize(options?: DHFAny): void;
+    /** @private Called when the iframe emits a 'summarized' event to drain the queue. */
+    _onSummarizeComplete(): void;
+    muteMicrophone(muted: boolean): void;
+    destroy(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=DigitalHumanFrame.d.ts.map

package/dist-npm/types/src/digital-human/DigitalHumanFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DigitalHumanFrame.d.ts","sourceRoot":"","sources":["../../../../src/digital-human/DigitalHumanFrame.ts"],"names":[],"mappings":"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"}

package/dist-npm/types/src/digital-human/DigitalHumanFrameMessages.d.ts

@@ -0,0 +1,59 @@
+/**
+ * DigitalHumanFrameMessages.ts — DigitalHumanFrame 跨 iframe 消息类型常量
+ *
+ * 定义父页面 ↔ iframe（DigitalHuman 内嵌帧）之间 postMessage 通信使用的消息类型字符串。
+ * 所有消息类型都带统一前缀（默认 `dh-frame:`）以避免与其他 postMessage 冲突。
+ */
+/** DigitalHumanFrame 消息类型前缀 */
+export declare const FRAME_MSG_PREFIX = "dh-frame:";
+/** DigitalHumanFrame 消息类型表（key → 完整消息类型字符串） */
+export interface FrameMessages {
+    INIT_AVATAR: string;
+    INIT_FROM_CONFIG: string;
+    CREATE_SESSION: string;
+    SEND: string;
+    SEND_MESSAGE: string;
+    CANCEL_SEND: string;
+    SEND_BOOT_MESSAGE: string;
+    PLAY_ACTION: string;
+    SWITCH_VIDEO: string;
+    SWITCH_TO_IDLE: string;
+    SWITCH_TO_TALKING: string;
+    SET_MOUTH_OPEN: string;
+    PLAY_MOTION: string;
+    GET_ACTIONS: string;
+    GET_ACTION_LIST: string;
+    GET_AVATAR_STATUS: string;
+    DESTROY: string;
+    GET_SESSION: string;
+    START_VOICE_CHAT: string;
+    STOP_VOICE_CHAT: string;
+    SEND_VOICE_TEXT: string;
+    SEND_CONTEXT: string;
+    SEND_TTS: string;
+    MUTE_MICROPHONE: string;
+    UPDATE_VOICE_CHAT: string;
+    RESTART_VOICE_CHAT: string;
+    RESTART_AGENT: string;
+    SEND_HEARTBEAT: string;
+    TRIGGER_VOICE_HEARTBEAT: string;
+    SET_ACTIVE: string;
+    SET_SUBTITLE_CONFIG: string;
+    GET_SUBTITLE_CONFIG: string;
+    CLEAR_SUBTITLE: string;
+    EXPAND_INLINE_SYSTEM_PROMPT: string;
+    LOAD_SUMMARIZE_AGENT_CONFIG: string;
+    SUMMARIZE: string;
+    SET_TOKEN: string;
+    EVENT: string;
+    READY: string;
+    RESPONSE: string;
+}
+/**
+ * 用指定前缀生成一套消息类型常量。
+ * @param prefix - 消息类型前缀（默认 FRAME_MSG_PREFIX）
+ */
+export declare function createFrameMessages(prefix?: string): FrameMessages;
+/** 默认消息类型常量（使用默认前缀） */
+export declare const MSG: FrameMessages;
+//# sourceMappingURL=DigitalHumanFrameMessages.d.ts.map

package/dist-npm/types/src/digital-human/DigitalHumanFrameMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DigitalHumanFrameMessages.d.ts","sourceRoot":"","sources":["../../../../src/digital-human/DigitalHumanFrameMessages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B,EAAE,MAAM,CAAC;IACpC,2BAA2B,EAAE,MAAM,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,MAAyB,GAAG,aAAa,CA2CpF;AAED,uBAAuB;AACvB,eAAO,MAAM,GAAG,EAAE,aAAqD,CAAC"}