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

package/data/build/dist/client/model-catalog-cache.d.ts

@@ -1,5 +1,28 @@
 import type { CodingNsCliModelCatalog } from '../shared/contracts/cli-adapter.js';
 import type { CodingNsRpcClient } from './features/types.js';
+/**
+ * Client 缓存有效期。
+ *
+ * 目录里既有模型清单，也有账号级事实（例如 Codex 的 `officialSubscription`
+ * 与 `defaultServiceTier`）。后者会随用户在外部工具里切换供应商或登录状态而
+ * 变化，而页面不会因此重新挂载。若 Client 永久持有第一次的结果，依赖这些事实
+ * 的控件（Codex 官方订阅的 Fast 档位开关）就会在整场会话里一直缺失。
+ *
+ * 因此这里给出一个短 TTL：命中即用（不阻塞渲染），过期后重新请求。Host 侧还会
+ * 比对 Provider 配置指纹，配置真正变化时立即失效，不依赖这个 TTL。
+ */
+export declare const MODEL_CATALOG_CACHE_TTL_MS = 60000;
+/** 作废某个适配器（或全部适配器）的 Client 目录缓存。 */
+export declare function invalidateModelCatalogCache(rpc: CodingNsRpcClient, adapterId?: string): void;
+/**
+ * 「判定可能过期」时的复检节流。
+ *
+ * 目录声明了服务档位却未确认官方订阅时，值得再探测一次；但真实第三方接入会
+ * 长期停在这个状态，不能每次挂载都发一次请求。这里按适配器记录最近一次复检
+ * 时间，只有超过间隔才允许再次作废缓存。
+ */
+export declare const MODEL_CATALOG_REVALIDATE_INTERVAL_MS = 60000;
+export declare function shouldRevalidateModelCatalog(rpc: CodingNsRpcClient, adapterId: string, needsRevalidation: boolean): boolean;
 export declare function getModelCatalogCache(rpc: CodingNsRpcClient): Map<string, CodingNsCliModelCatalog>;
 export declare function loadModelCatalog(rpc: CodingNsRpcClient, adapterId: string, sessionId?: string): Promise<CodingNsCliModelCatalog>;
 //# sourceMappingURL=model-catalog-cache.d.ts.map

package/data/build/dist/client/model-catalog-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-catalog-cache.d.ts","sourceRoot":"","sources":["../../../../src/client/model-catalog-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAY5D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAQjG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAwBhI"}
+{"version":3,"file":"model-catalog-cache.d.ts","sourceRoot":"","sources":["../../../../src/client/model-catalog-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAY5D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAA;AA4BhD,oCAAoC;AACpC,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAU5F;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,QAAS,CAAA;AAI1D,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAaT;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAQjG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAuBhI"}

package/data/build/dist/client/model-catalog-cache.js

@@ -7,6 +7,72 @@ import { callCliRpc } from './cli-catalog.js';
  */
 const modelCatalogCaches = new WeakMap();
 const modelCatalogLoads = new WeakMap();
+/**
+ * Client 缓存有效期。
+ *
+ * 目录里既有模型清单，也有账号级事实（例如 Codex 的 `officialSubscription`
+ * 与 `defaultServiceTier`）。后者会随用户在外部工具里切换供应商或登录状态而
+ * 变化，而页面不会因此重新挂载。若 Client 永久持有第一次的结果，依赖这些事实
+ * 的控件（Codex 官方订阅的 Fast 档位开关）就会在整场会话里一直缺失。
+ *
+ * 因此这里给出一个短 TTL：命中即用（不阻塞渲染），过期后重新请求。Host 侧还会
+ * 比对 Provider 配置指纹，配置真正变化时立即失效，不依赖这个 TTL。
+ */
+export const MODEL_CATALOG_CACHE_TTL_MS = 60_000;
+const modelCatalogCacheTimes = new WeakMap();
+function cacheEntry(rpc, adapterId) {
+    return cacheTimesFor(rpc).get(adapterId);
+}
+function cacheTimesFor(rpc) {
+    const key = rpc;
+    let times = modelCatalogCacheTimes.get(key);
+    if (times === undefined) {
+        times = new Map();
+        modelCatalogCacheTimes.set(key, times);
+    }
+    return times;
+}
+function storeCatalog(rpc, adapterId, value) {
+    getModelCatalogCache(rpc).set(adapterId, value);
+    cacheTimesFor(rpc).set(adapterId, { value, storedAt: Date.now() });
+}
+/** 作废某个适配器（或全部适配器）的 Client 目录缓存。 */
+export function invalidateModelCatalogCache(rpc, adapterId) {
+    const cache = getModelCatalogCache(rpc);
+    const times = cacheTimesFor(rpc);
+    if (adapterId === undefined) {
+        cache.clear();
+        times.clear();
+        return;
+    }
+    cache.delete(adapterId);
+    times.delete(adapterId);
+}
+/**
+ * 「判定可能过期」时的复检节流。
+ *
+ * 目录声明了服务档位却未确认官方订阅时，值得再探测一次；但真实第三方接入会
+ * 长期停在这个状态，不能每次挂载都发一次请求。这里按适配器记录最近一次复检
+ * 时间，只有超过间隔才允许再次作废缓存。
+ */
+export const MODEL_CATALOG_REVALIDATE_INTERVAL_MS = 60_000;
+const modelCatalogRevalidations = new WeakMap();
+export function shouldRevalidateModelCatalog(rpc, adapterId, needsRevalidation) {
+    if (!needsRevalidation)
+        return false;
+    const key = rpc;
+    let times = modelCatalogRevalidations.get(key);
+    if (times === undefined) {
+        times = new Map();
+        modelCatalogRevalidations.set(key, times);
+    }
+    const last = times.get(adapterId);
+    const now = Date.now();
+    if (last !== undefined && now - last < MODEL_CATALOG_REVALIDATE_INTERVAL_MS)
+        return false;
+    times.set(adapterId, now);
+    return true;
+}
 export function getModelCatalogCache(rpc) {
     const key = rpc;
     let cache = modelCatalogCaches.get(key);
@@ -20,10 +86,11 @@ export function loadModelCatalog(rpc, adapterId, sessionId) {
     const cached = getModelCatalogCache(rpc).get(adapterId);
     // 回退目录只用于当前渲染，不能在 Client 侧永久占住真实目录。Host 会在
     // 短周期内重试产品快照读取；下一次请求必须有机会拿到恢复后的目录。
-    if (cached !== undefined && cached.fallback !== true)
+    if (cached !== undefined && cached.fallback !== true && isFreshCacheEntry(rpc, adapterId, cached)) {
         return Promise.resolve(cached);
-    if (cached?.fallback === true)
-        getModelCatalogCache(rpc).delete(adapterId);
+    }
+    if (cached !== undefined)
+        invalidateModelCatalogCache(rpc, adapterId);
     const loads = getModelCatalogLoadCache(rpc);
     const running = loads.get(adapterId);
     if (running !== undefined)
@@ -32,12 +99,10 @@ export function loadModelCatalog(rpc, adapterId, sessionId) {
         adapterId,
         ...(sessionId === undefined ? {} : { sessionId }),
     }).then((value) => {
-        if (value.fallback === true) {
-            getModelCatalogCache(rpc).delete(adapterId);
-        }
-        else {
-            getModelCatalogCache(rpc).set(adapterId, value);
-        }
+        if (value.fallback === true)
+            invalidateModelCatalogCache(rpc, adapterId);
+        else
+            storeCatalog(rpc, adapterId, value);
         return value;
     }).finally(() => {
         if (loads.get(adapterId) === request)
@@ -46,6 +111,13 @@ export function loadModelCatalog(rpc, adapterId, sessionId) {
     loads.set(adapterId, request);
     return request;
 }
+/** 缓存条目是否仍在有效期内；没有时间戳的旧条目按过期处理并触发一次重新读取。 */
+function isFreshCacheEntry(rpc, adapterId, cached) {
+    const entry = cacheEntry(rpc, adapterId);
+    if (entry === undefined || entry.value !== cached)
+        return false;
+    return Date.now() - entry.storedAt < MODEL_CATALOG_CACHE_TTL_MS;
+}
 function getModelCatalogLoadCache(rpc) {
     const key = rpc;
     let cache = modelCatalogLoads.get(key);

package/data/build/dist/client/model-catalog-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-catalog-cache.js","sourceRoot":"","sources":["../../../../src/client/model-catalog-cache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAgD,CAAA;AACtF,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAyD,CAAA;AAE9F,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,MAAM,GAAG,GAAG,GAAa,CAAA;IACzB,IAAI,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,GAAG,EAAE,CAAA;QACjB,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAsB,EAAE,SAAiB,EAAE,SAAkB;IAC5F,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACvD,2CAA2C;IAC3C,mCAAmC;IACnC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACpF,IAAI,MAAM,EAAE,QAAQ,KAAK,IAAI;QAAE,oBAAoB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC1E,MAAM,KAAK,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAA;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACpC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAA;IACzC,MAAM,OAAO,GAAG,UAAU,CAA0B,GAAG,EAAE,QAAQ,EAAE;QACjE,SAAS;QACT,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;KAClD,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC5B,oBAAoB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC7C,CAAC;aAAM,CAAC;YACN,oBAAoB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACjD,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QACd,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,OAAO;YAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IACF,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAsB;IACtD,MAAM,GAAG,GAAG,GAAa,CAAA;IACzB,IAAI,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACtC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,GAAG,EAAE,CAAA;QACjB,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"model-catalog-cache.js","sourceRoot":"","sources":["../../../../src/client/model-catalog-cache.ts"],"names":[],"mappings":"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"}

package/data/build/dist/client/service-tier.d.ts

@@ -36,6 +36,17 @@ export declare function isServiceTierEnabled(catalog: CodingNsCliModelCatalog |
 export declare function toggledServiceTierId(model: CodingNsCliModel | undefined, enabled: boolean): string | undefined;
 /** 生效档位对应的目录条目；标准速度或未知档位返回 undefined。 */
 export declare function activeServiceTier(catalog: CodingNsCliModelCatalog | null, model: CodingNsCliModel | undefined, selectedId: string | undefined): CodingNsCliServiceTier | undefined;
+/**
+ * 目录是否「声明了档位、但未确认官方订阅」——即档位开关缺席的原因可能只是判定过期。
+ *
+ * 这一状态有两种来源，界面上无法区分：
+ * - 真实第三方中转/纯 API key：档位确实不会生效，应当持续不展示；
+ * - 判定过期：用户在外部工具（cc-switch 等）里刚切回官方订阅，而页面还持有旧目录。
+ *
+ * 因此它只用来决定「值得再探测一次」，不能用来决定「应该展示开关」。重新探测由
+ * Host 的 Provider 配置指纹保证廉价：配置没变时 Host 直接返回缓存，不会重启 CLI。
+ */
+export declare function needsServiceTierRevalidation(catalog: CodingNsCliModelCatalog | null): boolean;
 /**
  * 在“只改了其它字段”的部分更新里保留当前档位选择。
  *

package/data/build/dist/client/service-tier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-tier.d.ts","sourceRoot":"","sources":["../../../../src/client/service-tier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAA;AAE3H;;;;GAIG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,wBAAwB,YAAY,CAAA;AAEjD,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,sBAAsB,EAAE,CAExG;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,GAAG,IAAI,EACvC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAAG,IAAI,EACvC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,CAKR;AAED,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,GAAG,IAAI,EACvC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI9G;AAED,yCAAyC;AACzC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,uBAAuB,GAAG,IAAI,EACvC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,sBAAsB,GAAG,SAAS,CAGpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,GAAG,SAAS,CAIpB"}
+{"version":3,"file":"service-tier.d.ts","sourceRoot":"","sources":["../../../../src/client/service-tier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAA;AAE3H;;;;GAIG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,wBAAwB,YAAY,CAAA;AAEjD,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,sBAAsB,EAAE,CAExG;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,GAAG,IAAI,EACvC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAAG,IAAI,EACvC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,CAKR;AAED,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,GAAG,IAAI,EACvC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI9G;AAED,yCAAyC;AACzC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,uBAAuB,GAAG,IAAI,EACvC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,sBAAsB,GAAG,SAAS,CAGpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,GAAG,OAAO,CAG7F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,GAAG,SAAS,CAIpB"}

package/data/build/dist/client/service-tier.js

@@ -55,6 +55,21 @@ export function activeServiceTier(catalog, model, selectedId) {
     const id = effectiveServiceTierId(catalog, selectedId);
     return modelServiceTiers(model).find((tier) => tier.id === id);
 }
+/**
+ * 目录是否「声明了档位、但未确认官方订阅」——即档位开关缺席的原因可能只是判定过期。
+ *
+ * 这一状态有两种来源，界面上无法区分：
+ * - 真实第三方中转/纯 API key：档位确实不会生效，应当持续不展示；
+ * - 判定过期：用户在外部工具（cc-switch 等）里刚切回官方订阅，而页面还持有旧目录。
+ *
+ * 因此它只用来决定「值得再探测一次」，不能用来决定「应该展示开关」。重新探测由
+ * Host 的 Provider 配置指纹保证廉价：配置没变时 Host 直接返回缓存，不会重启 CLI。
+ */
+export function needsServiceTierRevalidation(catalog) {
+    if (catalog === null || catalog.officialSubscription === true)
+        return false;
+    return catalog.groups.some((group) => group.models.some((model) => modelServiceTiers(model).length > 0));
+}
 /**
  * 在“只改了其它字段”的部分更新里保留当前档位选择。
  *

package/data/build/dist/client/service-tier.js.map

@@ -1 +1 @@
-{"version":3,"file":"service-tier.js","sourceRoot":"","sources":["../../../../src/client/service-tier.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAA;AAEjD,+BAA+B;AAC/B,MAAM,UAAU,iBAAiB,CAAC,KAAmC;IACnE,OAAO,KAAK,EAAE,YAAY,IAAI,EAAE,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAuC,EACvC,KAAmC;IAEnC,OAAO,OAAO,EAAE,oBAAoB,KAAK,IAAI,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AACtF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAuC,EACvC,UAA8B;IAE9B,MAAM,QAAQ,GAAG,UAAU,EAAE,IAAI,EAAE,CAAA;IACnC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAA;IAC9D,MAAM,iBAAiB,GAAG,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAA;IAC7D,OAAO,iBAAiB,KAAK,SAAS,IAAI,iBAAiB,KAAK,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,iBAAiB,CAAA;AACnH,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,oBAAoB,CAClC,OAAuC,EACvC,UAA8B;IAE9B,OAAO,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,wBAAwB,CAAA;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAmC,EAAE,OAAgB;IACxF,IAAI,CAAC,OAAO;QAAE,OAAO,wBAAwB,CAAA;IAC7C,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAA;AACjD,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,iBAAiB,CAC/B,OAAuC,EACvC,KAAmC,EACnC,UAA8B;IAE9B,MAAM,EAAE,GAAG,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IACtD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAChE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAmC,EACnC,SAA6B;IAE7B,MAAM,OAAO,GAAG,SAAS,EAAE,IAAI,EAAE,CAAA;IACjC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IAC7D,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAA;AAC1G,CAAC"}
+{"version":3,"file":"service-tier.js","sourceRoot":"","sources":["../../../../src/client/service-tier.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAA;AAEjD,+BAA+B;AAC/B,MAAM,UAAU,iBAAiB,CAAC,KAAmC;IACnE,OAAO,KAAK,EAAE,YAAY,IAAI,EAAE,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAuC,EACvC,KAAmC;IAEnC,OAAO,OAAO,EAAE,oBAAoB,KAAK,IAAI,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AACtF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAuC,EACvC,UAA8B;IAE9B,MAAM,QAAQ,GAAG,UAAU,EAAE,IAAI,EAAE,CAAA;IACnC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAA;IAC9D,MAAM,iBAAiB,GAAG,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAA;IAC7D,OAAO,iBAAiB,KAAK,SAAS,IAAI,iBAAiB,KAAK,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,iBAAiB,CAAA;AACnH,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,oBAAoB,CAClC,OAAuC,EACvC,UAA8B;IAE9B,OAAO,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,wBAAwB,CAAA;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAmC,EAAE,OAAgB;IACxF,IAAI,CAAC,OAAO;QAAE,OAAO,wBAAwB,CAAA;IAC7C,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAA;AACjD,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,iBAAiB,CAC/B,OAAuC,EACvC,KAAmC,EACnC,UAA8B;IAE9B,MAAM,EAAE,GAAG,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IACtD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAChE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAuC;IAClF,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,oBAAoB,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC3E,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;AAC1G,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAmC,EACnC,SAA6B;IAE7B,MAAM,OAAO,GAAG,SAAS,EAAE,IAAI,EAAE,CAAA;IACjC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IAC7D,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAA;AAC1G,CAAC"}

package/data/build/dist/client/sherpa-voice-adapter.d.ts

@@ -0,0 +1,46 @@
+import type { CodingNsClientServices } from './features/types.js';
+import type { VoiceClientDevice, VoicePcmFrame, VoiceRuntimeAdapter, VoiceRuntimeCapabilities, VoiceRuntimeListener } from '../shared/contracts/voice-runtime.js';
+export interface SherpaClientVoiceAdapterOptions {
+    readonly ownerId: string;
+    readonly services: CodingNsClientServices;
+}
+/** 浏览器侧 Sherpa 数据面：设备和权限在 Client，识别在 Host。 */
+export declare class ClientSherpaVoiceAdapter implements VoiceRuntimeAdapter {
+    private readonly listeners;
+    private readonly services;
+    private readonly devices;
+    private readonly options;
+    private capture;
+    private uploader;
+    private responseAbort;
+    private active;
+    private hostLeaseActive;
+    private epoch;
+    private configuredOwner;
+    private selectedInputDeviceId;
+    private selectedOutputDeviceId;
+    constructor(options: SherpaClientVoiceAdapterOptions);
+    get capabilities(): VoiceRuntimeCapabilities;
+    get ownerId(): string | undefined;
+    get configuredOwnerId(): string;
+    get inputDeviceId(): string | undefined;
+    get outputDeviceId(): string | undefined;
+    get outputDeviceSupported(): boolean;
+    subscribe(listener: VoiceRuntimeListener): () => void;
+    enumerateInputDevices(): Promise<readonly VoiceClientDevice[]>;
+    enumerateOutputDevices(): Promise<readonly VoiceClientDevice[]>;
+    selectInputDevice(deviceId: string): Promise<void>;
+    selectOutputDevice(deviceId: string): Promise<void>;
+    start(ownerId?: string): Promise<void>;
+    stop(): Promise<void>;
+    interrupt(): Promise<void>;
+    sendPcm(frame: VoicePcmFrame, epoch: number): void;
+    speak(text: string, epoch: number): Promise<void>;
+    dispose(): void;
+    private sendPcmFrame;
+    private readEvents;
+    private handleEvent;
+    private applyOutputDevice;
+    private emit;
+}
+//# sourceMappingURL=sherpa-voice-adapter.d.ts.map

package/data/build/dist/client/sherpa-voice-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sherpa-voice-adapter.d.ts","sourceRoot":"","sources":["../../../../src/client/sherpa-voice-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,wBAAwB,EAAqB,oBAAoB,EAAqB,MAAM,sCAAsC,CAAA;AAKvM,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;CAC1C;AAED,8CAA8C;AAC9C,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,qBAAqB,CAAoB;IACjD,OAAO,CAAC,sBAAsB,CAAoB;gBAEtC,OAAO,EAAE,+BAA+B;IAcpD,IAAI,YAAY,IAAI,wBAAwB,CAI3C;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAA0D;IAC3F,IAAI,iBAAiB,IAAI,MAAM,CAAgC;IAC/D,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAAsC;IAC7E,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAAuC;IAC/E,IAAI,qBAAqB,IAAI,OAAO,CAA+I;IAEnL,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAE/C,qBAAqB,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;IAC9D,sBAAsB,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;IAC/D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBrB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhC,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAE5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvD,OAAO,IAAI,IAAI;IAEf,OAAO,CAAC,YAAY;YAMN,UAAU;YAsBV,WAAW;YAaX,iBAAiB;IAQ/B,OAAO,CAAC,IAAI;CACb"}

package/data/build/dist/client/sherpa-voice-adapter.js

@@ -0,0 +1,252 @@
+import { CODINGNS_RPC_CHANNEL } from '../shared/contracts/transport.js';
+import { encodeVoiceStreamMessage, encodeVoiceStreamOpen } from '../shared/voice-stream.js';
+import { BrowserVoiceDeviceManager } from './voice-device-manager.js';
+import { ClientVoiceCapture } from './voice-capture.js';
+/** 浏览器侧 Sherpa 数据面：设备和权限在 Client，识别在 Host。 */
+export class ClientSherpaVoiceAdapter {
+    listeners = new Set();
+    services;
+    devices;
+    options;
+    capture;
+    uploader;
+    responseAbort;
+    active = false;
+    hostLeaseActive = false;
+    epoch = 0;
+    configuredOwner;
+    selectedInputDeviceId;
+    selectedOutputDeviceId;
+    constructor(options) {
+        this.options = options;
+        this.services = options.services;
+        this.configuredOwner = options.ownerId;
+        this.devices = new BrowserVoiceDeviceManager();
+        const snapshot = this.devices.snapshot();
+        this.selectedInputDeviceId = snapshot.selectedInputId ?? undefined;
+        this.selectedOutputDeviceId = snapshot.selectedOutputId ?? undefined;
+        this.devices.subscribe((next) => {
+            this.selectedInputDeviceId = next.selectedInputId ?? undefined;
+            this.selectedOutputDeviceId = next.selectedOutputId ?? undefined;
+        });
+    }
+    get capabilities() {
+        const secure = this.devices.snapshot().secureContext;
+        const supported = secure && typeof globalThis.fetch === 'function' && typeof globalThis.ReadableStream === 'function';
+        return { realtime: supported, wakeWord: false, streamingInput: supported, streamingOutput: false, bargeIn: supported, speechToText: supported, textToSpeech: typeof globalThis.speechSynthesis !== 'undefined' };
+    }
+    get ownerId() { return this.active ? this.configuredOwner : undefined; }
+    get configuredOwnerId() { return this.configuredOwner; }
+    get inputDeviceId() { return this.selectedInputDeviceId; }
+    get outputDeviceId() { return this.selectedOutputDeviceId; }
+    get outputDeviceSupported() { return typeof globalThis.HTMLMediaElement?.prototype?.setSinkId === 'function'; }
+    subscribe(listener) { this.listeners.add(listener); return () => this.listeners.delete(listener); }
+    async enumerateInputDevices() { return (await this.devices.refresh()).inputs; }
+    async enumerateOutputDevices() { return (await this.devices.refresh()).outputs; }
+    async selectInputDevice(deviceId) {
+        await this.devices.selectInput(deviceId);
+        this.selectedInputDeviceId = this.devices.snapshot().selectedInputId ?? undefined;
+        if (this.active) {
+            await this.stop();
+            await this.start(this.configuredOwner);
+        }
+    }
+    async selectOutputDevice(deviceId) {
+        if (!this.outputDeviceSupported)
+            throw new Error('当前浏览器不支持输出设备选择');
+        await this.devices.selectOutput(deviceId);
+        this.selectedOutputDeviceId = this.devices.snapshot().selectedOutputId ?? undefined;
+        await this.applyOutputDevice();
+    }
+    async start(ownerId) {
+        if (this.active)
+            return;
+        this.configuredOwner = ownerId?.trim() || this.configuredOwner;
+        if (this.configuredOwner === '')
+            throw new Error('全局语音租约缺少 ownerId');
+        const lease = await this.services.rpc.call(CODINGNS_RPC_CHANNEL, 'assistant/voice/start', { ownerId: this.configuredOwner });
+        if (!lease.ok)
+            throw new Error(lease.error.message);
+        if (isRecord(lease.value) && lease.value.unavailable === true)
+            throw new Error(typeof lease.value.message === 'string' ? lease.value.message : '本地 Sherpa 语音运行时不可用');
+        this.hostLeaseActive = true;
+        const snapshot = await this.devices.refresh();
+        if (!snapshot.secureContext)
+            throw new Error('当前页面不是安全上下文，请改用 HTTPS 或 localhost 后访问麦克风');
+        this.epoch += 1;
+        const epoch = this.epoch;
+        const uploader = new VoiceStreamUploader();
+        const abort = new AbortController();
+        this.uploader = uploader;
+        this.responseAbort = abort;
+        this.active = true;
+        this.emit({ type: 'state', state: 'loading', epoch });
+        try {
+            uploader.enqueue(encodeVoiceStreamOpen({ ownerId: this.configuredOwner, clientId: createClientId(), sampleRate: 16_000, channels: 1, encoding: 'pcm16le' }));
+            const response = await globalThis.fetch(resolveVoiceStreamUrl(), {
+                method: 'POST',
+                body: uploader.stream,
+                signal: abort.signal,
+                credentials: 'same-origin',
+                headers: { 'content-type': 'application/octet-stream', accept: 'application/x-ndjson' },
+                ...{ duplex: 'half' },
+            });
+            if (!response.ok || response.body === null)
+                throw new Error(`语音流连接失败（HTTP ${response.status}）`);
+            void this.readEvents(response.body, epoch);
+            const capture = new ClientVoiceCapture({ devices: this.devices, targetSampleRate: 16_000, onFrame: (frame) => this.sendPcmFrame(frame, epoch), onEnded: (error) => this.emit({ type: 'error', code: 'voice_capture_ended', message: error.message, recoverable: true, epoch }) });
+            this.capture = capture;
+            await capture.start();
+            this.emit({ type: 'state', state: 'listening', epoch });
+        }
+        catch (error) {
+            await this.stop().catch(() => undefined);
+            throw error;
+        }
+    }
+    async stop() {
+        if (!this.active && this.capture === undefined && !this.hostLeaseActive)
+            return;
+        this.active = false;
+        let captureError;
+        try {
+            await this.capture?.stop();
+        }
+        catch (error) {
+            // 采集器可能已经被浏览器提前终止；无论如何都必须继续释放 Host 租约。
+            captureError = error;
+        }
+        this.capture = undefined;
+        this.uploader?.enqueue(encodeVoiceStreamMessage({ type: 'close', epoch: this.epoch }));
+        this.uploader?.close();
+        this.uploader = undefined;
+        this.responseAbort?.abort();
+        this.responseAbort = undefined;
+        if (this.hostLeaseActive) {
+            this.hostLeaseActive = false;
+            await this.services.rpc.call(CODINGNS_RPC_CHANNEL, 'assistant/voice/stop', { ownerId: this.configuredOwner }).catch(() => undefined);
+        }
+        this.epoch += 1;
+        this.emit({ type: 'state', state: 'disabled', epoch: this.epoch });
+        if (captureError !== undefined)
+            throw captureError;
+    }
+    async interrupt() {
+        this.epoch += 1;
+        globalThis.speechSynthesis?.cancel();
+        this.uploader?.enqueue(encodeVoiceStreamMessage({ type: 'interrupt', epoch: this.epoch }));
+        await this.services.rpc.call(CODINGNS_RPC_CHANNEL, 'assistant/voice/interrupt', { ownerId: this.configuredOwner }).catch(() => undefined);
+        this.emit({ type: 'barge-in', epoch: this.epoch });
+    }
+    sendPcm(frame, epoch) { this.sendPcmFrame(frame, epoch); }
+    async speak(text, epoch) {
+        if (epoch !== this.epoch || text.trim() === '')
+            return;
+        const synthesis = globalThis.speechSynthesis;
+        if (synthesis === undefined || typeof globalThis.SpeechSynthesisUtterance !== 'function')
+            throw new Error('当前浏览器不支持语音播报');
+        synthesis.cancel();
+        await new Promise((resolve) => {
+            const utterance = new SpeechSynthesisUtterance(text.trim());
+            utterance.lang = 'zh-CN';
+            utterance.onend = () => resolve();
+            utterance.onerror = () => resolve();
+            synthesis.speak(utterance);
+        });
+    }
+    dispose() { void this.stop(); this.devices.dispose(); this.listeners.clear(); }
+    sendPcmFrame(frame, epoch) {
+        if (!this.active || this.uploader === undefined || epoch !== this.epoch)
+            return;
+        this.uploader.enqueue(encodeVoiceStreamMessage({ type: 'pcm', sequence: frame.sequence, sampleRate: frame.sampleRate, channels: 1, epoch, byteLength: frame.bytes.byteLength }));
+        this.uploader.enqueue(frame.bytes);
+    }
+    async readEvents(body, streamEpoch) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let text = '';
+        try {
+            while (true) {
+                const next = await reader.read();
+                if (next.done)
+                    break;
+                text += decoder.decode(next.value, { stream: true });
+                let newline = text.indexOf('\n');
+                while (newline >= 0) {
+                    const line = text.slice(0, newline).trim();
+                    text = text.slice(newline + 1);
+                    if (line !== '')
+                        await this.handleEvent(JSON.parse(line), streamEpoch);
+                    newline = text.indexOf('\n');
+                }
+            }
+        }
+        catch (error) {
+            if (this.active)
+                this.emit({ type: 'error', code: 'voice_stream_response_failed', message: error instanceof Error ? error.message : String(error), recoverable: true, epoch: streamEpoch });
+        }
+    }
+    async handleEvent(value, streamEpoch) {
+        if (streamEpoch !== this.epoch || typeof value.type !== 'string')
+            return;
+        if (value.type === 'state' && typeof value.state === 'string')
+            this.emit({ type: 'state', state: value.state, epoch: readEpoch(value, streamEpoch) });
+        else if (value.type === 'partial' && typeof value.text === 'string')
+            this.emit({ type: 'partial', text: value.text, epoch: readEpoch(value, streamEpoch) });
+        else if (value.type === 'final' && typeof value.text === 'string') {
+            const eventEpoch = readEpoch(value, streamEpoch);
+            this.emit({ type: 'final', text: value.text, epoch: eventEpoch });
+            const result = await this.services.rpc.call(CODINGNS_RPC_CHANNEL, 'assistant/voice/text', { ownerId: this.configuredOwner, text: value.text, requestId: createClientId() });
+            if (result.ok && isRecord(result.value) && typeof result.value.speechText === 'string')
+                await this.speak(result.value.speechText, eventEpoch);
+        }
+        else if (value.type === 'barge-in')
+            this.emit({ type: 'barge-in', epoch: readEpoch(value, streamEpoch) });
+        else if (value.type === 'error')
+            this.emit({ type: 'error', code: String(value.code ?? 'voice_stream_error'), message: String(value.message ?? value.code ?? ''), recoverable: value.recoverable !== false, epoch: readEpoch(value, streamEpoch) });
+    }
+    async applyOutputDevice() {
+        if (!this.outputDeviceSupported)
+            return;
+        for (const media of [...document.querySelectorAll('audio,video')]) {
+            const sink = media.setSinkId;
+            if (typeof sink === 'function')
+                await sink.call(media, this.selectedOutputDeviceId ?? '');
+        }
+    }
+    emit(event) { for (const listener of [...this.listeners]) {
+        try {
+            listener(event);
+        }
+        catch { /* UI 订阅者异常不能破坏语音数据面 */ }
+    } }
+}
+class VoiceStreamUploader {
+    stream;
+    controller;
+    closed = false;
+    constructor() { this.stream = new ReadableStream({ start: (controller) => { this.controller = controller; } }); }
+    enqueue(bytes) { if (!this.closed) {
+        try {
+            this.controller?.enqueue(bytes.slice());
+        }
+        catch {
+            this.closed = true;
+        }
+    } }
+    close() { if (this.closed)
+        return; this.closed = true; try {
+        this.controller?.close();
+    }
+    catch { /* fetch 已断开 */ } }
+}
+function resolveVoiceStreamUrl() { return new URL('/api/codingns/assistant/voice/stream', globalThis.location?.origin ?? 'http://localhost').toString(); }
+function createClientId() { try {
+    return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`;
+}
+catch {
+    return `${Date.now()}-${Math.random()}`;
+} }
+function readEpoch(value, fallback) { return typeof value.epoch === 'number' && Number.isInteger(value.epoch) ? value.epoch : fallback; }
+function isRecord(value) { return typeof value === 'object' && value !== null && !Array.isArray(value); }
+//# sourceMappingURL=sherpa-voice-adapter.js.map

package/data/build/dist/client/sherpa-voice-adapter.js.map

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

package/data/build/dist/client/skill-command.d.ts

@@ -0,0 +1,10 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { CodingNsRpcClient } from './features/types.js';
+import type { CodingNsLocale } from './locale.js';
+export interface RegisterSkillCommandOptions {
+    readonly rpc: CodingNsRpcClient;
+    readonly locale: CodingNsLocale;
+}
+/** 把 Codex 原生 Skill 目录接入 DSH `/` 菜单。 */
+export declare function registerSkillCommand(ctx: Context, options: RegisterSkillCommandOptions): () => void;
+//# sourceMappingURL=skill-command.d.ts.map

package/data/build/dist/client/skill-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-command.d.ts","sourceRoot":"","sources":["../../../../src/client/skill-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAiHjD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAChC;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,2BAA2B,GAAG,MAAM,IAAI,CAwBnG"}