@jxgame2020/dsh-token-quota 0.1.39 → 0.1.41

package/lib/types/client/mic.js

@@ -0,0 +1,158 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Composer mic button: registered into `conversation.input.overlay` so it sits
+ * inside the chat composer card (top-right corner). A press starts recording
+ * from the microphone; a second press stops it and sends the audio blob to the
+ * Host, which forwards it to the configured OpenAI-compatible transcription
+ * endpoint. The returned text is appended to the composer. The button only
+ * renders while transcription is enabled in the token-quota settings.
+ */
+import { useEffect, useRef, useState } from 'react';
+import css from './mic.module.css';
+/**
+ * Append recognised text to the contentEditable composer. Focuses the editor,
+ * moves the caret to the end, and uses `insertText` so the host editor's own
+ * input handling (undo, model binding) sees it as a typed insertion.
+ */
+function appendToComposer(text) {
+    const editor = document.querySelector('[data-composer-input]');
+    if (editor === null) {
+        // No composer on this page — copy to the clipboard as a fallback.
+        void navigator.clipboard?.writeText(text).catch(() => { });
+        return;
+    }
+    editor.focus();
+    // Move the caret to the end of the editor's text content.
+    const selection = window.getSelection();
+    if (selection !== null) {
+        const range = document.createRange();
+        range.selectNodeContents(editor);
+        range.collapse(false);
+        selection.removeAllRanges();
+        selection.addRange(range);
+    }
+    // execCommand is deprecated but remains the only cross-browser way to trigger
+    // a contentEditable editor's own "typed text" handling (undo stack, lexical
+    // binding). The host composer listens to it.
+    let inserted = false;
+    try {
+        inserted = document.execCommand('insertText', false, text);
+    }
+    catch {
+        // Some engines throw on execCommand; fall through to the manual path.
+    }
+    if (!inserted) {
+        editor.appendChild(document.createTextNode(text));
+    }
+}
+/**
+ * Mic button rendered inside the composer card. Manages its own MediaRecorder
+ * lifecycle; only the button is shown — no floating panel UI.
+ */
+export function TokenQuotaMic({ t, useStore, transcribe, }) {
+    const enabled = useStore(s => s.transcribe.enabled);
+    const [recording, setRecording] = useState(false);
+    const [transcribing, setTranscribing] = useState(false);
+    const [error, setError] = useState(null);
+    const mediaRecorderRef = useRef(null);
+    const chunksRef = useRef([]);
+    const streamRef = useRef(null);
+    const errorTimerRef = useRef(undefined);
+    // Clean up the recorder / stream on unmount so a navigation while recording
+    // stops the mic tracks rather than leaving them open.
+    useEffect(() => {
+        return () => {
+            if (errorTimerRef.current !== undefined)
+                clearTimeout(errorTimerRef.current);
+            cleanupRecording();
+        };
+    }, []);
+    const cleanupRecording = () => {
+        if (streamRef.current !== null) {
+            for (const track of streamRef.current.getTracks())
+                track.stop();
+            streamRef.current = null;
+        }
+        mediaRecorderRef.current = null;
+        chunksRef.current = [];
+    };
+    const showError = (message) => {
+        setError(message);
+        if (errorTimerRef.current !== undefined)
+            clearTimeout(errorTimerRef.current);
+        errorTimerRef.current = setTimeout(() => {
+            setError(null);
+            errorTimerRef.current = undefined;
+        }, 4000);
+    };
+    const startRecording = async () => {
+        let stream;
+        try {
+            stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+        }
+        catch {
+            showError(t('transcribeMicDenied'));
+            return;
+        }
+        streamRef.current = stream;
+        chunksRef.current = [];
+        const mimeType = MediaRecorder.isTypeSupported('audio/webm;codecs=opus')
+            ? 'audio/webm;codecs=opus'
+            : MediaRecorder.isTypeSupported('audio/webm')
+                ? 'audio/webm'
+                : '';
+        const recorder = mimeType !== ''
+            ? new MediaRecorder(stream, { mimeType })
+            : new MediaRecorder(stream);
+        mediaRecorderRef.current = recorder;
+        recorder.ondataavailable = (event) => {
+            if (event.data.size > 0)
+                chunksRef.current.push(event.data);
+        };
+        recorder.onstop = () => {
+            const type = mimeType !== '' ? mimeType : 'audio/webm';
+            const blob = new Blob(chunksRef.current, { type });
+            cleanupRecording();
+            if (blob.size === 0) {
+                showError(t('transcribeEmpty'));
+                return;
+            }
+            setTranscribing(true);
+            void transcribe(blob).then((text) => {
+                setTranscribing(false);
+                if (text.trim() !== '')
+                    appendToComposer(text);
+            }, (err) => {
+                setTranscribing(false);
+                showError(err instanceof Error ? err.message : String(err));
+            });
+        };
+        recorder.start();
+        setRecording(true);
+    };
+    const stopAndTranscribe = () => {
+        const recorder = mediaRecorderRef.current;
+        if (recorder !== null && recorder.state !== 'inactive') {
+            recorder.stop();
+        }
+        else {
+            cleanupRecording();
+        }
+        setRecording(false);
+    };
+    const onToggle = () => {
+        if (transcribing)
+            return;
+        if (recording) {
+            stopAndTranscribe();
+        }
+        else {
+            void startRecording();
+        }
+    };
+    if (!enabled)
+        return null;
+    const state = transcribing ? 'busy' : recording ? 'rec' : 'idle';
+    return (_jsxs("div", { className: css.micWrap, title: error ?? t('transcribeHint'), children: [_jsx("button", { type: "button", className: `${css.micBtn}${state === 'rec' ? ` ${css.micRec}` : ''}${state === 'busy' ? ` ${css.micBusy}` : ''}${error !== null ? ` ${css.micErr}` : ''}`, disabled: transcribing, onClick: (event) => { event.stopPropagation(); onToggle(); }, onPointerDown: (event) => { event.stopPropagation(); }, "aria-pressed": recording, "aria-label": error ?? t('transcribeTitle'), children: transcribing ? '…' : '🎤' }), error !== null && _jsx("span", { className: css.micErrTip, children: error })] }));
+}
+//# sourceMappingURL=mic.js.map

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. */
@@ -112,8 +114,16 @@ export declare class TokenQuotaService extends Service {
      * the enabled-transition in `onChange` fetch immediately).
      */
     private syncBalancePolling;
-    /** Refresh every provider the host knows how to query. */
+    /** Refresh every DeepSeek-family provider found in the model directory. */
     private refreshAllBalances;
+    /**
+     * Discover every provider in the model directory that looks like DeepSeek,
+     * together with its own credential reference and endpoint base. This is what
+     * decides which providers are queried: a provider qualifies when its base URL
+     * points at DeepSeek's API host or its credential reference is named with the
+     * `DEEPSEEK` prefix, and it must declare an `apiKeyEnv`.
+     */
+    private discoverBalanceSources;
     /**
      * Refresh one provider's cached account balance. The API key is resolved
      * through the harness credential seam (`credentials.resolve`) with the
@@ -121,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) {
@@ -271,21 +279,8 @@ function usageTokens(usage) {
         + (usage.cacheWriteTokens ?? 0)
         + usage.outputTokens;
 }
-/**
- * Daily token-quota service.
- *
- * Mount it beside the other rows (`@jxgame2020/dsh-token-quota`) and write
- * per-model limits through the `token-quota` settings namespace.
- */
-/**
- * Providers the host can query for account balance, keyed by route key. Each
- * entry names the credential reference (environment-variable name), the
- * balance endpoint base, and the optional `*_BASE_URL` override variable.
- * Directory providers outside this map render as "not integrated for query".
- */
-const BALANCE_SOURCES = {
-    deepseek: { keyEnv: 'DEEPSEEK_API_KEY', baseURL: 'https://api.deepseek.com', baseEnv: 'DEEPSEEK_BASE_URL' },
-};
+/** DeepSeek's public API host; used to recognise DeepSeek-family providers. */
+const DEEPSEEK_BALANCE_HOST = 'api.deepseek.com';
 export class TokenQuotaService extends Service {
     static Config = z.object({
         storagePath: z.string().default(''),
@@ -301,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}. */
@@ -338,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. */
@@ -382,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')
@@ -551,7 +560,7 @@ export class TokenQuotaService extends Service {
                     catch {
                         // Malformed body: fall back to refreshing everything.
                     }
-                    const task = provider !== undefined && provider in BALANCE_SOURCES
+                    const task = provider !== undefined
                         ? this.refreshProviderBalance(provider)
                         : this.refreshAllBalances();
                     void task.finally(() => {
@@ -562,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',
@@ -745,9 +778,66 @@ export class TokenQuotaService extends Service {
         };
         schedule();
     }
-    /** Refresh every provider the host knows how to query. */
+    /** Refresh every DeepSeek-family provider found in the model directory. */
     refreshAllBalances() {
-        return Promise.all(Object.keys(BALANCE_SOURCES).map(provider => this.refreshProviderBalance(provider))).then(() => undefined);
+        return Promise.all([...this.discoverBalanceSources().values()]
+            .map(source => this.refreshProviderBalance(source.provider, source))).then(() => undefined);
+    }
+    /**
+     * Discover every provider in the model directory that looks like DeepSeek,
+     * together with its own credential reference and endpoint base. This is what
+     * decides which providers are queried: a provider qualifies when its base URL
+     * points at DeepSeek's API host or its credential reference is named with the
+     * `DEEPSEEK` prefix, and it must declare an `apiKeyEnv`.
+     */
+    discoverBalanceSources() {
+        const found = new Map();
+        const llm = this.ctx.get('llm');
+        const settings = this.ctx.get('settings');
+        const fallback = () => ({
+            provider: 'deepseek',
+            keyEnv: 'DEEPSEEK_API_KEY',
+            baseURL: process.env.DEEPSEEK_BASE_URL ?? `https://${DEEPSEEK_BALANCE_HOST}`,
+        });
+        if (llm?.listConfigurableProviders === undefined) {
+            found.set('deepseek', fallback());
+            return found;
+        }
+        for (const entry of llm.listConfigurableProviders()) {
+            try {
+                let profile = settings?.get(entry.settingsNs);
+                for (const segment of entry.settingsPath ?? []) {
+                    profile = profile !== null && typeof profile === 'object'
+                        ? profile[segment]
+                        : undefined;
+                }
+                if (profile === null || typeof profile !== 'object')
+                    continue;
+                const record = profile;
+                const keyEnv = typeof record.apiKeyEnv === 'string' && record.apiKeyEnv !== ''
+                    ? record.apiKeyEnv
+                    : undefined;
+                const baseURL = typeof record.baseURL === 'string' && record.baseURL !== ''
+                    ? record.baseURL
+                    : undefined;
+                const isDeepSeek = (baseURL !== undefined && baseURL.includes(DEEPSEEK_BALANCE_HOST))
+                    || (keyEnv !== undefined && keyEnv.startsWith('DEEPSEEK'))
+                    || entry.provider.startsWith('deepseek');
+                if (!isDeepSeek || keyEnv === undefined)
+                    continue;
+                found.set(entry.provider, {
+                    provider: entry.provider,
+                    keyEnv,
+                    baseURL: baseURL ?? `https://${DEEPSEEK_BALANCE_HOST}`,
+                });
+            }
+            catch {
+                // Malformed provider entry — skip it and keep the others.
+            }
+        }
+        if (found.size === 0)
+            found.set('deepseek', fallback());
+        return found;
     }
     /**
      * Refresh one provider's cached account balance. The API key is resolved
@@ -755,9 +845,9 @@ export class TokenQuotaService extends Service {
      * environment as a fallback, so the Models page key is used with nothing to
      * type. A failed fetch keeps the previous value and marks it as an error.
      */
-    async refreshProviderBalance(provider) {
-        const source = BALANCE_SOURCES[provider];
-        if (source === undefined)
+    async refreshProviderBalance(provider, source) {
+        const resolved = source ?? this.discoverBalanceSources().get(provider);
+        if (resolved === undefined)
             return;
         const existing = this.balanceFetches.get(provider);
         if (existing !== undefined)
@@ -769,14 +859,14 @@ export class TokenQuotaService extends Service {
             let key;
             if (credentials !== undefined) {
                 try {
-                    key = (await credentials.resolve(source.keyEnv))?.value;
+                    key = (await credentials.resolve(resolved.keyEnv))?.value;
                 }
                 catch {
                     // Seam unreachable: fall through to the environment.
                 }
             }
             if (key === undefined || key === '')
-                key = process.env[source.keyEnv];
+                key = process.env[resolved.keyEnv];
             if (key === undefined || key === '') {
                 this.balances.set(provider, {
                     provider,
@@ -788,9 +878,7 @@ export class TokenQuotaService extends Service {
                 });
                 return;
             }
-            const base = source.baseEnv !== undefined
-                ? (process.env[source.baseEnv] ?? source.baseURL)
-                : source.baseURL;
+            const base = resolved.baseURL;
             try {
                 const controller = new AbortController();
                 const timer = setTimeout(() => { controller.abort(); }, 10_000);
@@ -853,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();
@@ -1189,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

@@ -56,11 +56,22 @@ export interface TokenQuotaBalanceSettings {
 }
 export declare const TOKEN_QUOTA_DEFAULT_BALANCE: TokenQuotaBalanceSettings;
 /**
- * Provider route keys the host knows how to query for account balance. A
- * directory provider outside this list renders as "not integrated for query"
- * in the balance window.
+ * 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 declare const TOKEN_QUOTA_BALANCE_PROVIDERS: readonly string[];
+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';
 /**
@@ -217,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,12 +33,12 @@ export const TOKEN_QUOTA_DEFAULT_BALANCE = {
     enabled: true,
     pollMinutes: 5,
 };
-/**
- * Provider route keys the host knows how to query for account balance. A
- * directory provider outside this list renders as "not integrated for query"
- * in the balance window.
- */
-export const TOKEN_QUOTA_BALANCE_PROVIDERS = ['deepseek'];
+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.39",
+  "version": "0.1.41",
   "publishConfig": {
     "access": "public"
   },