@jxgame2020/dsh-token-quota 0.1.40 → 0.1.41

package/lib/types/client/store.d.ts

@@ -9,7 +9,7 @@
  */
 import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
 import type { ModelProviderGroup, ModelSelection } from '@deepseek-ai/dsh-api-session-controller/types';
-import type { TokenQuotaFullAction, TokenQuotaLog, TokenQuotaBalance, TokenQuotaMusicStyle, TokenQuotaNote, TokenQuotaReset, TokenQuotaSnapshot, TokenQuotaUpgrade } from '@jxgame2020/dsh-token-quota/types';
+import type { TokenQuotaFullAction, TokenQuotaLog, TokenQuotaBalance, TokenQuotaMusicStyle, TokenQuotaNote, TokenQuotaReset, TokenQuotaSnapshot, TokenQuotaTranscribeSettings, TokenQuotaUpgrade } from '@jxgame2020/dsh-token-quota/types';
 /** One rendered model row: directory identity merged with the quota snapshot. */
 export interface ModelQuotaRow {
     /** Stable key `provider/model`. */
@@ -74,6 +74,8 @@ export interface TokenQuotaPanelState {
     musicVolume: number;
     musicStyle: TokenQuotaMusicStyle;
     musicOnlyCurrentSession: boolean;
+    /** Voice transcription settings (mirrored from the settings document). */
+    transcribe: TokenQuotaTranscribeSettings;
     /** Latest upgrade availability from the Host; null = up to date or unknown. */
     upgrade: TokenQuotaUpgrade | null;
     /** Whether the one-shot upgrade banner was dismissed for the current latest version. */
@@ -128,6 +130,8 @@ export type TokenQuotaPanelActions = {
     setMusicVolume: (d: TokenQuotaPanelState, volume: number) => void;
     setMusicStyle: (d: TokenQuotaPanelState, style: TokenQuotaMusicStyle) => void;
     setMusicOnlyCurrentSession: (d: TokenQuotaPanelState, only: boolean) => void;
+    /** Adopt the voice transcription settings. */
+    setTranscribeSettings: (d: TokenQuotaPanelState, settings: TokenQuotaTranscribeSettings) => void;
     setUpgrade: (d: TokenQuotaPanelState, upgrade: TokenQuotaUpgrade | null) => void;
     setUpgradeDismissed: (d: TokenQuotaPanelState, dismissed: boolean) => void;
     setCheckingUpdates: (d: TokenQuotaPanelState, checking: boolean) => void;

package/lib/types/client/store.js

@@ -38,6 +38,7 @@ export function createTokenQuotaPanelStore() {
             musicVolume: 0.5,
             musicStyle: 'pentatonic',
             musicOnlyCurrentSession: true,
+            transcribe: { enabled: false, baseURL: 'https://api.siliconflow.cn/v1', apiKeyEnv: 'SILICONFLOW_API_KEY', model: 'XingChenAGI/XingChenASR-V3.2-Ultra' },
             upgrade: null,
             upgradeDismissed: false,
             checkingUpdates: false,
@@ -71,6 +72,7 @@ export function createTokenQuotaPanelStore() {
             setMusicVolume: (d, volume) => { d.musicVolume = volume; },
             setMusicStyle: (d, style) => { d.musicStyle = style; },
             setMusicOnlyCurrentSession: (d, only) => { d.musicOnlyCurrentSession = only; },
+            setTranscribeSettings: (d, settings) => { d.transcribe = settings; },
             setUpgrade: (d, upgrade) => {
                 // Guard against host/client version skew (e.g. the host process still
                 // runs an older bundle after an upgrade): when the reported "latest"

package/lib/types/index.d.ts

@@ -85,6 +85,8 @@ export declare class TokenQuotaService extends Service {
     private disposeRouteClear;
     /** Disposer for the optional balance-refresh route (`POST /token-quota/refresh-balance`). */
     private disposeRouteBalance;
+    /** Disposer for the voice transcription route (`POST /token-quota/transcribe`). */
+    private disposeRouteTranscribe;
     /** Disposer for the optional music-event route (`GET /token-quota/events`, SSE). */
     private disposeRouteEvents;
     /** Live SSE subscribers receiving streamed music actions. */
@@ -129,6 +131,14 @@ export declare class TokenQuotaService extends Service {
      * type. A failed fetch keeps the previous value and marks it as an error.
      */
     private refreshProviderBalance;
+    /**
+     * Forward a recorded audio blob to the configured OpenAI-compatible
+     * `/audio/transcriptions` endpoint and return the recognised text. The API
+     * key resolves through the credential seam (Models page) with an environment
+     * fallback; the request body is the raw audio and the content type carries
+     * the filename for the multipart form.
+     */
+    private handleTranscribe;
     /** Read the full per-cycle usage history (log dialog data). */
     readLog(): TokenQuotaLog;
     /**

package/lib/types/index.js

@@ -38,7 +38,7 @@ import z from '@deepseek-ai/schemastery';
 // the service listens to without importing any runtime value.
 import '@deepseek-ai/dsh-agent';
 import { LlmError } from '@deepseek-ai/dsh-llm';
-import { TOKEN_QUOTA_EXCEEDED_CODE, TOKEN_QUOTA_NAMESPACE, tokenQuotaKey, TOKEN_QUOTA_DEFAULT_MUSIC, TOKEN_QUOTA_MAX_NOTES, TOKEN_QUOTA_DEFAULT_BALANCE, } from "./types.js";
+import { TOKEN_QUOTA_EXCEEDED_CODE, TOKEN_QUOTA_NAMESPACE, tokenQuotaKey, TOKEN_QUOTA_DEFAULT_MUSIC, TOKEN_QUOTA_MAX_NOTES, TOKEN_QUOTA_DEFAULT_BALANCE, TOKEN_QUOTA_DEFAULT_TRANSCRIBE, } from "./types.js";
 import { assertTokenQuotaLimit, splitTokenQuotaKey } from "./invariant.js";
 /** The plugin's package name, used to locate the profile dependency and the registry endpoint. */
 const PACKAGE_NAME = '@jxgame2020/dsh-token-quota';
@@ -232,6 +232,14 @@ const TOKEN_QUOTA_SETTINGS_SCHEMA = z.object({
         enabled: z.boolean().default(TOKEN_QUOTA_DEFAULT_BALANCE.enabled),
         pollMinutes: z.number().min(1).max(120).default(TOKEN_QUOTA_DEFAULT_BALANCE.pollMinutes),
     }).default({ ...TOKEN_QUOTA_DEFAULT_BALANCE }),
+    // Voice transcription: the browser records and the host forwards the audio
+    // to an OpenAI-compatible endpoint.
+    transcribe: z.object({
+        enabled: z.boolean().default(TOKEN_QUOTA_DEFAULT_TRANSCRIBE.enabled),
+        baseURL: z.string().default(TOKEN_QUOTA_DEFAULT_TRANSCRIBE.baseURL),
+        apiKeyEnv: z.string().default(TOKEN_QUOTA_DEFAULT_TRANSCRIBE.apiKeyEnv),
+        model: z.string().default(TOKEN_QUOTA_DEFAULT_TRANSCRIBE.model),
+    }).default({ ...TOKEN_QUOTA_DEFAULT_TRANSCRIBE }),
 });
 /** Two-digit zero-pad helper. */
 function pad2(value) {
@@ -288,7 +296,7 @@ export class TokenQuotaService extends Service {
     history = {};
     limits = {};
     monitored = undefined;
-    settingsSource = () => ({ limits: {}, monitored: [], onFull: 'stop', checkUpdates: true, dimWhenIdle: false, music: { ...TOKEN_QUOTA_DEFAULT_MUSIC }, order: [], notes: [], balance: { ...TOKEN_QUOTA_DEFAULT_BALANCE } });
+    settingsSource = () => ({ limits: {}, monitored: [], onFull: 'stop', checkUpdates: true, dimWhenIdle: false, music: { ...TOKEN_QUOTA_DEFAULT_MUSIC }, order: [], notes: [], balance: { ...TOKEN_QUOTA_DEFAULT_BALANCE }, transcribe: { ...TOKEN_QUOTA_DEFAULT_TRANSCRIBE } });
     /** Whether update checks are enabled (mirrors the settings document). */
     checkUpdates = true;
     /** Cached upgrade availability; recomputed by {@link refreshUpgrade}. */
@@ -325,6 +333,8 @@ export class TokenQuotaService extends Service {
     disposeRouteClear;
     /** Disposer for the optional balance-refresh route (`POST /token-quota/refresh-balance`). */
     disposeRouteBalance;
+    /** Disposer for the voice transcription route (`POST /token-quota/transcribe`). */
+    disposeRouteTranscribe;
     /** Disposer for the optional music-event route (`GET /token-quota/events`, SSE). */
     disposeRouteEvents;
     /** Live SSE subscribers receiving streamed music actions. */
@@ -369,6 +379,18 @@ export class TokenQuotaService extends Service {
                                     ? Math.max(1, Math.min(120, Math.round(doc.balance.pollMinutes)))
                                     : TOKEN_QUOTA_DEFAULT_BALANCE.pollMinutes,
                             },
+                            transcribe: {
+                                enabled: doc.transcribe?.enabled ?? TOKEN_QUOTA_DEFAULT_TRANSCRIBE.enabled,
+                                baseURL: typeof doc.transcribe?.baseURL === 'string' && doc.transcribe.baseURL !== ''
+                                    ? doc.transcribe.baseURL.replace(/\/+$/, '')
+                                    : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.baseURL,
+                                apiKeyEnv: typeof doc.transcribe?.apiKeyEnv === 'string' && doc.transcribe.apiKeyEnv !== ''
+                                    ? doc.transcribe.apiKeyEnv
+                                    : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.apiKeyEnv,
+                                model: typeof doc.transcribe?.model === 'string' && doc.transcribe.model !== ''
+                                    ? doc.transcribe.model
+                                    : TOKEN_QUOTA_DEFAULT_TRANSCRIBE.model,
+                            },
                             notes: Array.isArray(doc.notes)
                                 ? doc.notes.slice(0, TOKEN_QUOTA_MAX_NOTES).flatMap((note) => {
                                     if (typeof note.id !== 'string')
@@ -549,6 +571,30 @@ export class TokenQuotaService extends Service {
                 });
             },
         });
+        this.disposeRouteTranscribe = server.register({
+            kind: 'exact',
+            path: '/token-quota/transcribe',
+            handler: (req, res) => {
+                if (req.method !== 'POST') {
+                    res.writeHead(405);
+                    res.end();
+                    return;
+                }
+                void this.handleTranscribe(req).then((result) => {
+                    if (result.ok) {
+                        res.writeHead(200, { 'content-type': 'application/json', 'cache-control': 'no-store' });
+                        res.end(JSON.stringify({ text: result.text }));
+                    }
+                    else {
+                        res.writeHead(result.status);
+                        res.end(result.message);
+                    }
+                }, (error) => {
+                    res.writeHead(500);
+                    res.end(error instanceof Error ? error.message : String(error));
+                });
+            },
+        });
         this.disposeRouteClear = server.register({
             kind: 'exact',
             path: '/token-quota/clear-log',
@@ -895,6 +941,80 @@ export class TokenQuotaService extends Service {
         this.balanceFetches.set(provider, promise);
         return promise;
     }
+    /**
+     * Forward a recorded audio blob to the configured OpenAI-compatible
+     * `/audio/transcriptions` endpoint and return the recognised text. The API
+     * key resolves through the credential seam (Models page) with an environment
+     * fallback; the request body is the raw audio and the content type carries
+     * the filename for the multipart form.
+     */
+    async handleTranscribe(req) {
+        const settings = this.settingsSource().transcribe;
+        if (!settings.enabled) {
+            return { ok: false, status: 403, message: 'transcription is disabled' };
+        }
+        const chunks = [];
+        for await (const chunk of req) {
+            chunks.push(Buffer.from(chunk));
+        }
+        const audio = Buffer.concat(chunks);
+        if (audio.length === 0) {
+            return { ok: false, status: 400, message: 'empty audio payload' };
+        }
+        const credentials = this.ctx.get('credentials');
+        let key;
+        if (credentials !== undefined) {
+            try {
+                key = (await credentials.resolve(settings.apiKeyEnv))?.value;
+            }
+            catch {
+                // Seam unreachable: fall through to the environment.
+            }
+        }
+        if (key === undefined || key === '')
+            key = process.env[settings.apiKeyEnv];
+        if (key === undefined || key === '') {
+            return { ok: false, status: 400, message: `no API key for credential reference "${settings.apiKeyEnv}"` };
+        }
+        const contentType = req.headers['content-type'] ?? 'application/octet-stream';
+        const disposition = typeof req.headers['content-disposition'] === 'string'
+            ? req.headers['content-disposition']
+            : '';
+        const filenameMatch = /filename="([^"]+)"/.exec(disposition);
+        const filename = filenameMatch?.[1] ?? 'recording.webm';
+        const form = new FormData();
+        form.append('model', settings.model);
+        form.append('file', new Blob([new Uint8Array(audio)], { type: contentType }), filename);
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => { controller.abort(); }, 60_000);
+            let res;
+            try {
+                res = await fetch(`${settings.baseURL}/audio/transcriptions`, {
+                    method: 'POST',
+                    headers: { authorization: `Bearer ${key}`, accept: 'application/json' },
+                    body: form,
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!res.ok) {
+                const detail = await res.text().catch(() => '');
+                return { ok: false, status: res.status, message: `transcription endpoint HTTP ${res.status}${detail !== '' ? `: ${detail.slice(0, 300)}` : ''}` };
+            }
+            const data = (await res.json());
+            const text = typeof data?.text === 'string' ? data.text : '';
+            if (text === '') {
+                return { ok: false, status: 502, message: 'transcription endpoint returned no text' };
+            }
+            return { ok: true, text };
+        }
+        catch (error) {
+            return { ok: false, status: 502, message: error instanceof Error ? error.message : String(error) };
+        }
+    }
     /** Read the full per-cycle usage history (log dialog data). */
     readLog() {
         this.rollCycleIfNeeded();
@@ -1231,6 +1351,8 @@ export class TokenQuotaService extends Service {
             this.disposeRouteClear();
         if (this.disposeRouteBalance !== undefined)
             this.disposeRouteBalance();
+        if (this.disposeRouteTranscribe !== undefined)
+            this.disposeRouteTranscribe();
         if (this.balanceTimer !== undefined) {
             clearTimeout(this.balanceTimer);
             this.balanceTimer = undefined;

package/lib/types/types.d.ts

@@ -55,6 +55,23 @@ export interface TokenQuotaBalanceSettings {
     pollMinutes: number;
 }
 export declare const TOKEN_QUOTA_DEFAULT_BALANCE: TokenQuotaBalanceSettings;
+/**
+ * Voice transcription settings: when enabled the browser shows a mic button
+ * inside the chat composer; a press records the voice, a second press stops
+ * and sends the audio to an OpenAI-compatible `/audio/transcriptions`
+ * endpoint, and the returned text is inserted into the composer.
+ */
+export interface TokenQuotaTranscribeSettings {
+    /** Whether the mic button appears in the composer and transcription is active. */
+    enabled: boolean;
+    /** API base URL of the OpenAI-compatible transcription endpoint. */
+    baseURL: string;
+    /** Credential reference (environment-variable name) holding the API key. */
+    apiKeyEnv: string;
+    /** Speech-to-text model name sent as the `model` field. */
+    model: string;
+}
+export declare const TOKEN_QUOTA_DEFAULT_TRANSCRIBE: TokenQuotaTranscribeSettings;
 /** Fetch state of the provider account balance. */
 export type TokenQuotaBalanceStatus = 'ok' | 'unconfigured' | 'error';
 /**
@@ -211,6 +228,11 @@ export interface TokenQuotaSettings {
      * often the host polls the balance endpoint.
      */
     balance: TokenQuotaBalanceSettings;
+    /**
+     * Voice transcription: mic in the composer plus the OpenAI-compatible
+     * endpoint used to turn a recording into text. Disabled by default.
+     */
+    transcribe: TokenQuotaTranscribeSettings;
     /**
      * Floating scratchpad notes owned by the panel. At most
      * {@link TOKEN_QUOTA_MAX_NOTES} are kept; content, title, placement, size

package/lib/types/types.js

@@ -33,6 +33,12 @@ export const TOKEN_QUOTA_DEFAULT_BALANCE = {
     enabled: true,
     pollMinutes: 5,
 };
+export const TOKEN_QUOTA_DEFAULT_TRANSCRIBE = {
+    enabled: false,
+    baseURL: 'https://api.siliconflow.cn/v1',
+    apiKeyEnv: 'SILICONFLOW_API_KEY',
+    model: 'XingChenAGI/XingChenASR-V3.2-Ultra',
+};
 /** Default music settings: silent until the user flips the panel switch. */
 export const TOKEN_QUOTA_DEFAULT_MUSIC = {
     enabled: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jxgame2020/dsh-token-quota",
   "description": "Daily per-model token quota accounting, enforcement, and a floating quota panel for the DeepSeek Harness — a fully self-contained plugin (no core-Harness wiring, no generated RPC contract)",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "publishConfig": {
     "access": "public"
   },