@jingyi0605/codingns4dsh 0.2.0-rc.3 → 0.2.1-beta.1

package/data/build/dist/host/features/assistant-waiting-state.js

@@ -0,0 +1,17 @@
+/** 只消费运行时审批/提问事件，不从 running 状态或历史日志猜测等待。 */
+export class AssistantWaitingState {
+    pending = new Map();
+    request(value) {
+        this.pending.set(value.sessionId, value.kind);
+    }
+    resolve(sessionId) {
+        this.pending.delete(sessionId);
+    }
+    get(sessionId) {
+        return this.pending.get(sessionId) ?? null;
+    }
+    snapshot() {
+        return new Map(this.pending);
+    }
+}
+//# sourceMappingURL=assistant-waiting-state.js.map

package/data/build/dist/host/features/assistant-waiting-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-waiting-state.js","sourceRoot":"","sources":["../../../../../src/host/features/assistant-waiting-state.ts"],"names":[],"mappings":"AAMA,4CAA4C;AAC5C,MAAM,OAAO,qBAAqB;IACf,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAA;IAElE,OAAO,CAAC,KAA8B;QACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAA;IAC5C,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;CACF"}

package/data/build/dist/host/features/global-voice-coordinator.d.ts

@@ -0,0 +1,55 @@
+import type { VoicePcmFrame, VoiceRuntimeAdapter, VoiceRuntimeCapabilities, VoiceRuntimeEvent, VoiceRuntimeState } from '../../shared/contracts/voice-runtime.js';
+export interface GlobalVoiceCoordinatorSnapshot {
+    readonly active: boolean;
+    readonly ownerId: string | null;
+    readonly state: VoiceRuntimeState;
+    readonly epoch: number;
+    readonly capabilities: VoiceRuntimeCapabilities;
+}
+export interface GlobalVoiceCoordinatorOptions {
+    readonly adapter: VoiceRuntimeAdapter;
+    readonly onFinalText?: (text: string, epoch: number) => Promise<void> | void;
+    readonly onAudio?: (bytes: Uint8Array, epoch: number) => void;
+    readonly leaseTtlMs?: number;
+}
+/** Host/Profile 级全局语音协调器，不保存任何目标 sessionId。 */
+export declare class GlobalVoiceCoordinator {
+    private readonly adapter;
+    private readonly onFinalText;
+    private readonly onAudio;
+    private readonly listeners;
+    private readonly eventListeners;
+    private readonly runtimeDispose;
+    private ownerId;
+    private state;
+    private epoch;
+    private started;
+    private clientEpoch;
+    private clientSequence;
+    /** barge-in 后，旧轮次的 final 事件必须在收到新 listening 前丢弃。 */
+    private blockedFinalEpoch;
+    private leaseTimer;
+    private readonly leaseTtlMs;
+    constructor(options: GlobalVoiceCoordinatorOptions);
+    snapshot(): GlobalVoiceCoordinatorSnapshot;
+    subscribe(listener: (snapshot: GlobalVoiceCoordinatorSnapshot) => void): () => void;
+    /** 供二进制语音流把 partial/final/audio 事件回写给持有租约的浏览器。 */
+    subscribeRuntimeEvent(listener: (event: VoiceRuntimeEvent) => void): () => void;
+    start(ownerId: string): Promise<GlobalVoiceCoordinatorSnapshot>;
+    sendPcm(ownerId: string, frame: VoicePcmFrame): Promise<void>;
+    interrupt(ownerId: string): Promise<GlobalVoiceCoordinatorSnapshot>;
+    stop(ownerId: string): Promise<GlobalVoiceCoordinatorSnapshot>;
+    speak(ownerId: string, text: string): Promise<void>;
+    /** 供语音动作桥校验来源页面；不能只保护 start/stop。 */
+    assertOwner(ownerId: string): void;
+    heartbeat(ownerId: string): GlobalVoiceCoordinatorSnapshot;
+    /** 接收 Client 的状态事件；原始 PCM 不经过此边界。 */
+    acceptClientEvent(ownerId: string, event: VoiceRuntimeEvent, sequence?: number): GlobalVoiceCoordinatorSnapshot;
+    dispose(): void;
+    private handleRuntimeEvent;
+    private ensureOwner;
+    private armLeaseTimer;
+    private clearLeaseTimer;
+    private emit;
+}
+//# sourceMappingURL=global-voice-coordinator.d.ts.map

package/data/build/dist/host/features/global-voice-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-voice-coordinator.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/global-voice-coordinator.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/features/global-voice-coordinator.js

@@ -0,0 +1,221 @@
+/** Host/Profile 级全局语音协调器，不保存任何目标 sessionId。 */
+export class GlobalVoiceCoordinator {
+    adapter;
+    onFinalText;
+    onAudio;
+    listeners = new Set();
+    eventListeners = new Set();
+    runtimeDispose;
+    ownerId = null;
+    state = 'disabled';
+    epoch = 0;
+    started = false;
+    clientEpoch = -1;
+    clientSequence = -1;
+    /** barge-in 后，旧轮次的 final 事件必须在收到新 listening 前丢弃。 */
+    blockedFinalEpoch = -1;
+    leaseTimer;
+    leaseTtlMs;
+    constructor(options) {
+        this.adapter = options.adapter;
+        this.onFinalText = options.onFinalText;
+        this.onAudio = options.onAudio;
+        this.leaseTtlMs = Number.isFinite(options.leaseTtlMs) && (options.leaseTtlMs ?? 0) > 0 ? options.leaseTtlMs : 30_000;
+        this.runtimeDispose = this.adapter.subscribe((event) => this.handleRuntimeEvent(event));
+    }
+    snapshot() {
+        const capabilities = typeof this.adapter.capabilities === 'function' ? this.adapter.capabilities() : this.adapter.capabilities;
+        return { active: this.started, ownerId: this.ownerId, state: this.state, epoch: this.epoch, capabilities };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.snapshot());
+        return () => this.listeners.delete(listener);
+    }
+    /** 供二进制语音流把 partial/final/audio 事件回写给持有租约的浏览器。 */
+    subscribeRuntimeEvent(listener) {
+        this.eventListeners.add(listener);
+        return () => this.eventListeners.delete(listener);
+    }
+    async start(ownerId) {
+        const owner = ownerId.trim();
+        if (owner === '')
+            throw new Error('全局语音租约缺少 ownerId');
+        if (this.started && this.ownerId !== owner)
+            throw new Error('全局语音助理正在被另一个页面使用');
+        if (this.started)
+            return this.snapshot();
+        this.ownerId = owner;
+        this.epoch += 1;
+        this.clientEpoch = -1;
+        this.adapter.setEpoch?.(this.epoch);
+        this.clientSequence = -1;
+        this.blockedFinalEpoch = -1;
+        this.state = 'loading';
+        this.emit();
+        try {
+            await this.adapter.start(owner);
+            this.started = true;
+            this.armLeaseTimer(owner);
+            if (this.state === 'loading')
+                this.state = 'standby';
+            this.emit();
+            return this.snapshot();
+        }
+        catch (error) {
+            this.started = false;
+            this.ownerId = null;
+            this.state = 'error';
+            this.emit();
+            throw error;
+        }
+    }
+    async sendPcm(ownerId, frame) {
+        this.ensureOwner(ownerId);
+        if (this.adapter.sendPcm === undefined)
+            throw new Error('流式音频运行时不可用');
+        await this.adapter.sendPcm(frame, this.epoch);
+    }
+    async interrupt(ownerId) {
+        this.ensureOwner(ownerId);
+        this.epoch += 1;
+        this.adapter.setEpoch?.(this.epoch);
+        await this.adapter.interrupt();
+        this.state = 'interrupted';
+        this.blockedFinalEpoch = this.epoch;
+        this.emit();
+        return this.snapshot();
+    }
+    async stop(ownerId) {
+        this.ensureOwner(ownerId);
+        this.clearLeaseTimer();
+        await this.adapter.stop();
+        this.epoch += 1;
+        this.started = false;
+        this.ownerId = null;
+        this.state = 'disabled';
+        this.clientEpoch = -1;
+        this.clientSequence = -1;
+        this.blockedFinalEpoch = -1;
+        this.emit();
+        return this.snapshot();
+    }
+    async speak(ownerId, text) {
+        this.ensureOwner(ownerId);
+        if (this.adapter.speak === undefined)
+            throw new Error('语音播报运行时不可用');
+        this.state = 'speaking';
+        this.emit();
+        await this.adapter.speak(text, this.epoch);
+    }
+    /** 供语音动作桥校验来源页面；不能只保护 start/stop。 */
+    assertOwner(ownerId) { this.ensureOwner(ownerId); }
+    heartbeat(ownerId) {
+        this.ensureOwner(ownerId);
+        this.armLeaseTimer(ownerId);
+        return this.snapshot();
+    }
+    /** 接收 Client 的状态事件；原始 PCM 不经过此边界。 */
+    acceptClientEvent(ownerId, event, sequence) {
+        // Client 的事件通过独立 RPC 异步投递。停止租约后，已经排队的最后一条
+        // 状态事件仍可能晚于 voice/stop 到达；这类事件不再属于任何活动会话，直接
+        // 丢弃即可，不能把正常的清理竞态记录成 Host RPC 异常。
+        if (!this.started || this.ownerId !== ownerId)
+            return this.snapshot();
+        if (sequence !== undefined && sequence < this.clientSequence)
+            return this.snapshot();
+        if (sequence !== undefined)
+            this.clientSequence = sequence;
+        if (event.epoch < this.clientEpoch)
+            return this.snapshot();
+        this.clientEpoch = event.epoch;
+        this.epoch = Math.max(this.epoch, event.epoch);
+        if (event.type === 'state') {
+            this.state = event.state;
+            if (event.state === 'listening' && event.epoch >= this.blockedFinalEpoch)
+                this.blockedFinalEpoch = -1;
+        }
+        else if (event.type === 'wake') {
+            this.state = 'listening';
+            this.blockedFinalEpoch = -1;
+        }
+        else if (event.type === 'barge-in') {
+            this.state = 'interrupted';
+            this.blockedFinalEpoch = Math.max(this.blockedFinalEpoch, event.epoch);
+        }
+        else if (event.type === 'error')
+            this.state = 'error';
+        this.emit();
+        return this.snapshot();
+    }
+    dispose() {
+        this.clearLeaseTimer();
+        if (this.started)
+            void this.adapter.stop();
+        this.runtimeDispose();
+        this.listeners.clear();
+        this.eventListeners.clear();
+        this.ownerId = null;
+        this.started = false;
+        this.state = 'disabled';
+    }
+    handleRuntimeEvent(event) {
+        if (event.epoch < this.epoch)
+            return;
+        this.epoch = event.epoch;
+        if (event.type === 'state') {
+            this.state = event.state;
+            if (event.state === 'listening' && event.epoch >= this.blockedFinalEpoch)
+                this.blockedFinalEpoch = -1;
+        }
+        else if (event.type === 'wake')
+            this.state = 'listening';
+        else if (event.type === 'barge-in') {
+            this.state = 'interrupted';
+            this.blockedFinalEpoch = Math.max(this.blockedFinalEpoch, event.epoch);
+        }
+        else if (event.type === 'error')
+            this.state = 'error';
+        else if (event.type === 'audio')
+            this.onAudio?.(event.bytes, event.epoch);
+        this.emit();
+        for (const listener of [...this.eventListeners]) {
+            try {
+                listener(event);
+            }
+            catch { /* 连接关闭不应破坏运行时 */ }
+        }
+        if (event.type === 'final' && event.epoch > this.blockedFinalEpoch && event.text.trim() !== '') {
+            void this.onFinalText?.(event.text.trim(), event.epoch);
+        }
+    }
+    ensureOwner(ownerId) {
+        if (!this.started || this.ownerId !== ownerId)
+            throw new Error('当前页面没有全局语音租约');
+    }
+    armLeaseTimer(ownerId) {
+        this.clearLeaseTimer();
+        this.leaseTimer = setTimeout(() => {
+            if (!this.started || this.ownerId !== ownerId)
+                return;
+            void this.stop(ownerId).catch(() => undefined);
+        }, this.leaseTtlMs);
+        const timer = this.leaseTimer;
+        timer.unref?.();
+    }
+    clearLeaseTimer() {
+        if (this.leaseTimer !== undefined)
+            clearTimeout(this.leaseTimer);
+        this.leaseTimer = undefined;
+    }
+    emit() {
+        const snapshot = this.snapshot();
+        for (const listener of [...this.listeners]) {
+            try {
+                listener(snapshot);
+            }
+            catch { /* 单个订阅者异常不能破坏全局状态 */ }
+        }
+    }
+}
+//# sourceMappingURL=global-voice-coordinator.js.map

package/data/build/dist/host/features/global-voice-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-voice-coordinator.js","sourceRoot":"","sources":["../../../../../src/host/features/global-voice-coordinator.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/features/global-voice-rpc.d.ts

@@ -0,0 +1,25 @@
+import type { FeatureModule } from '../../shared/contracts/feature.js';
+import type { CodingNsHostServices } from './types.js';
+import { VoiceAgentService } from './voice-agent-service.js';
+/**
+ * 全局智能助理 Host 边界。
+ *
+ * 这里故意不接收 sessionId：会话索引、意图和派发各自通过快照协作，语音租约
+ * 只属于 Host。这样刷新页面或切换当前对话不会改变助理的目标范围。
+ */
+export declare function createGlobalVoiceRpcFeature(): FeatureModule<CodingNsHostServices>;
+/**
+ * 在 Host Context 注册 CodingNS 自己的 voiceAgent 服务。
+ *
+ * 浏览器 Client 负责麦克风和扬声器；Host 侧服务持有 Sherpa 运行时、契约、
+ * 动作注册表和会话句柄。若宿主已经提供同名且契约完整的服务，保留宿主
+ * 实现，避免覆盖其他插件的生命周期所有权；没有 Context 或缺少公开反射 API 时
+ * 才跳过注册。已有同名但契约不完整属于装配错误，必须显式失败，不能伪装成可用。
+ */
+export declare function provideHostVoiceAgentService(ctx: CodingNsHostServices['dshContext'], agent: VoiceAgentService): (() => void | Promise<void>) | undefined;
+/**
+ * readSurface 返回的是已经过滤过的模型表层事件。这里只读取最后几条语义事件，
+ * 不遍历原始日志，也不把工具流式 chunk 当成用户或助理正文。
+ */
+export declare function summarizeSurfaceEvents(events: readonly unknown[]): string | null;
+//# sourceMappingURL=global-voice-rpc.d.ts.map

package/data/build/dist/host/features/global-voice-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-voice-rpc.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/global-voice-rpc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAQtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAS5D;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,aAAa,CAAC,oBAAoB,CAAC,CA8QjF;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,oBAAoB,CAAC,YAAY,CAAC,EACvC,KAAK,EAAE,iBAAiB,GACvB,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAgB1C;AAiOD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAyBhF"}