@openvulcan/dsh-vulcancode 0.4.3 → 0.4.4

package/node_modules/@openvulcan/dsh-vulcan-voice-input/lib/cloud.d.ts

@@ -0,0 +1,39 @@
+import { type Credential } from '@openvulcan/openvulcan-account';
+import type { VoiceCatalog, VoiceErrorCode, VoiceSelection } from './contract.js';
+export declare const MAX_SECONDS = 120;
+export declare const MAX_AUDIO_BYTES: number;
+/**
+ * A classified voice failure with an HTTP status and optional upstream wait time.
+ * 带 HTTP 状态和可选上游等待时间的语音输入错误。
+ */
+export declare class VoiceFailure extends Error {
+    readonly code: VoiceErrorCode;
+    readonly status: number;
+    readonly retryAfter?: number | undefined;
+    constructor(code: VoiceErrorCode, status: number, retryAfter?: number | undefined);
+}
+/**
+ * The validated site catalogue, or null if its microphone channel is disabled.
+ * 经校验的站点模型目录。站点麦克风通道停用时为 null。
+ */
+export type Publication = VoiceCatalog | null;
+/**
+ * Read a body within the supplied byte limit. Oversized streams are cancelled before parsing.
+ * 在指定字节限制内读取正文。超限时在解析前取消流。
+ */
+export declare function readBounded(message: Request | Response, limit: number, failure: VoiceFailure, signal?: AbortSignal): Promise<Uint8Array<ArrayBuffer>>;
+/**
+ * Validate the precise PCM WAV produced by the browser encoder before sending it upstream.
+ * 在转发前校验浏览器编码器生成的精确 PCM WAV 格式。
+ */
+export declare function validateWav(bytes: Uint8Array): void;
+/**
+ * Get the free channel's current catalogue for one verified regional credential.
+ * 根据已校验的区域凭据读取免费通道当前的模型目录。
+ */
+export declare function getPublication(transport: typeof fetch, credential: Credential, signal: AbortSignal): Promise<Publication>;
+/**
+ * Send one bounded recording to the selected publication and return its recognized text.
+ * 向已选发布模型发送一段有界录音并返回识别文本。
+ */
+export declare function transcribe(transport: typeof fetch, credential: Credential, signal: AbortSignal, selection: VoiceSelection, wav: Uint8Array<ArrayBuffer>): Promise<string>;

package/node_modules/@openvulcan/dsh-vulcan-voice-input/lib/cloud.js

@@ -0,0 +1,187 @@
+import { SITES } from '@openvulcan/openvulcan-account';
+// The version-one microphone contract accepts 120 seconds of canonical 16 kHz mono PCM.
+// 第一版麦克风协议接受最长 120 秒的标准 16 kHz 单声道 PCM。
+export const MAX_SECONDS = 120;
+// The audio and JSON limits apply before parsing or copying upstream data.
+// 在解析或复制上游数据前执行音频和 JSON 体积上限。
+export const MAX_AUDIO_BYTES = 44 + MAX_SECONDS * 16_000 * 2;
+const MAX_JSON_BYTES = 1024 * 1024;
+// Only these paths under the regional Auth origin serve the free microphone channel.
+// 只有各站点 Auth 域名下的这些路径提供免费麦克风通道。
+const BASE = '/api/v1/vulcancode/voice-input/';
+/**
+ * A classified voice failure with an HTTP status and optional upstream wait time.
+ * 带 HTTP 状态和可选上游等待时间的语音输入错误。
+ */
+export class VoiceFailure extends Error {
+    code;
+    status;
+    retryAfter;
+    constructor(code, status, retryAfter) {
+        super(code);
+        this.code = code;
+        this.status = status;
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Read a body within the supplied byte limit. Oversized streams are cancelled before parsing.
+ * 在指定字节限制内读取正文。超限时在解析前取消流。
+ */
+export async function readBounded(message, limit, failure, signal) {
+    const declared = message.headers.get('content-length');
+    if (declared !== null && (!/^\d+$/.test(declared) || Number(declared) > limit)) {
+        void message.body?.cancel().catch(() => { });
+        throw failure;
+    }
+    if (message.body === null)
+        return new Uint8Array(0);
+    const reader = message.body.getReader();
+    const bytes = new Uint8Array(limit);
+    let length = 0;
+    // Cancel a slow upload when its caller, authorization or deadline ends.
+    // 调用方、设备授权或截止时间结束时取消缓慢上传。
+    const cancel = () => { void reader.cancel().catch(() => { }); };
+    signal?.addEventListener('abort', cancel, { once: true });
+    try {
+        if (signal?.aborted)
+            cancel();
+        for (;;) {
+            const chunk = await reader.read();
+            signal?.throwIfAborted();
+            if (chunk.done)
+                return bytes.subarray(0, length);
+            if (length + chunk.value.byteLength > limit) {
+                void reader.cancel().catch(() => { });
+                throw failure;
+            }
+            bytes.set(chunk.value, length);
+            length += chunk.value.byteLength;
+        }
+    }
+    finally {
+        signal?.removeEventListener('abort', cancel);
+        reader.releaseLock();
+    }
+}
+/**
+ * Validate the precise PCM WAV produced by the browser encoder before sending it upstream.
+ * 在转发前校验浏览器编码器生成的精确 PCM WAV 格式。
+ */
+export function validateWav(bytes) {
+    if (bytes.length <= 44 || bytes.length > MAX_AUDIO_BYTES || bytes.length % 2 !== 0) {
+        throw new VoiceFailure('invalid_audio', 400);
+    }
+    const wav = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    if (wav.getUint32(0) !== 0x52494646 || wav.getUint32(4, true) !== bytes.length - 8 ||
+        wav.getUint32(8) !== 0x57415645 || wav.getUint32(12) !== 0x666d7420 || wav.getUint32(16, true) !== 16 ||
+        wav.getUint16(20, true) !== 1 || wav.getUint16(22, true) !== 1 || wav.getUint32(24, true) !== 16_000 ||
+        wav.getUint32(28, true) !== 32_000 || wav.getUint16(32, true) !== 2 || wav.getUint16(34, true) !== 16 ||
+        wav.getUint32(36) !== 0x64617461 || wav.getUint32(40, true) !== bytes.length - 44) {
+        throw new VoiceFailure('invalid_audio', 400);
+    }
+}
+/**
+ * Narrow a JSON object before reading protocol fields.
+ * 在读取协议字段前将 JSON 值缩窄为对象。
+ */
+function object(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate the version-one catalogue and the reference to its published default.
+ * 校验第一版模型目录及其已发布的默认模型引用。
+ */
+function parsePublication(value) {
+    if (!object(value) || value.contract_version !== 1 || value.max_duration_seconds !== MAX_SECONDS ||
+        typeof value.available !== 'boolean' || typeof value.default_model_id !== 'string' ||
+        !Array.isArray(value.models))
+        throw new VoiceFailure('unavailable', 502);
+    if (!value.available && value.default_model_id === '' && value.models.length === 0)
+        return null;
+    if (!value.available || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(value.default_model_id)) {
+        throw new VoiceFailure('unavailable', 502);
+    }
+    // Validate every entry before exposing it as a selectable model or header value.
+    // 逐条验证目录，再将条目用于模型选择或请求头。
+    const models = [];
+    const ids = new Set();
+    for (const model of value.models) {
+        if (!object(model) || typeof model.id !== 'string' || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(model.id) ||
+            ids.has(model.id) || model.category !== 'speech_transcribe' || typeof model.display_name !== 'string' ||
+            model.display_name.trim() === '' || !Array.isArray(model.supported_languages) ||
+            !model.supported_languages.every((language) => typeof language === 'string' && /^[a-z]{2,3}(?:-[a-z]{2})?$/.test(language)) ||
+            new Set(model.supported_languages).size !== model.supported_languages.length) {
+            throw new VoiceFailure('unavailable', 502);
+        }
+        ids.add(model.id);
+        models.push({ id: model.id, label: model.display_name, languages: model.supported_languages });
+    }
+    if (!ids.has(value.default_model_id))
+        throw new VoiceFailure('unavailable', 502);
+    return { defaultModelId: value.default_model_id, models };
+}
+/**
+ * Send one native request to the account's Auth domain. Redirects would move the credential or audio.
+ * 向账号的 Auth 域名发送一次原生请求。重定向会转移凭据或录音，因此禁止重定向。
+ */
+async function send(transport, credential, path, signal, upload) {
+    const origin = SITES[credential.site].auth;
+    if (credential.auth_origin !== origin)
+        throw new VoiceFailure('signed_out', 401);
+    const headers = new Headers({ authorization: `Auth ${credential.access_token}`, accept: 'application/json' });
+    if (upload !== undefined) {
+        headers.set('content-type', 'audio/wav');
+        headers.set('x-vulcan-voice-model', upload.selection.modelId);
+        if (upload.selection.language !== undefined)
+            headers.set('x-vulcan-asr-language', upload.selection.language);
+    }
+    const response = await transport(`${origin}${BASE}${path}`, {
+        method: upload === undefined ? 'GET' : 'POST',
+        headers,
+        redirect: 'error',
+        signal: AbortSignal.any([signal, AbortSignal.timeout(upload === undefined ? 5000 : 65000)]),
+        ...(upload === undefined ? {} : { body: upload.wav }),
+    });
+    if (response.status === 401) {
+        void response.body?.cancel().catch(() => { });
+        throw new VoiceFailure('signed_out', 401);
+    }
+    const bytes = await readBounded(response, MAX_JSON_BYTES, new VoiceFailure('unavailable', 502));
+    const value = JSON.parse(new TextDecoder().decode(bytes));
+    if (response.status === 200)
+        return value;
+    const code = object(value) && object(value.error) ? value.error.code : undefined;
+    if ((response.status === 404 && code === 'voice_model_unavailable') ||
+        (response.status === 400 && code === 'unsupported_voice_language'))
+        throw new VoiceFailure('selection_unavailable', 409);
+    const wait = Number(response.headers.get('retry-after'));
+    const retryAfter = Number.isInteger(wait) && wait >= 1 && wait <= 86_400 ? wait : undefined;
+    if (response.status === 429 && code === 'voice_rate_limited')
+        throw new VoiceFailure('rate_limited', 429, retryAfter);
+    if (response.status === 503 && code === 'voice_busy')
+        throw new VoiceFailure('busy', 503, retryAfter);
+    if (code === 'invalid_voice_audio' || code === 'voice_audio_too_large' || code === 'unsupported_voice_audio') {
+        throw new VoiceFailure('invalid_audio', 400);
+    }
+    throw new VoiceFailure('unavailable', 502);
+}
+/**
+ * Get the free channel's current catalogue for one verified regional credential.
+ * 根据已校验的区域凭据读取免费通道当前的模型目录。
+ */
+export async function getPublication(transport, credential, signal) {
+    return parsePublication(await send(transport, credential, 'capabilities', signal));
+}
+/**
+ * Send one bounded recording to the selected publication and return its recognized text.
+ * 向已选发布模型发送一段有界录音并返回识别文本。
+ */
+export async function transcribe(transport, credential, signal, selection, wav) {
+    const result = await send(transport, credential, 'transcriptions', signal, { selection, wav });
+    if (!object(result) || typeof result.text !== 'string' ||
+        typeof result.request_id !== 'string' || result.request_id.length === 0) {
+        throw new VoiceFailure('unavailable', 502);
+    }
+    return result.text;
+}

package/node_modules/@openvulcan/dsh-vulcan-voice-input/lib/contract.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Public microphone state returned by the dsh Host. Ready state binds a recording to one authorization.
+ * dsh 宿主返回的麦克风公开状态。就绪状态将录音绑定至一次设备授权。
+ */
+export type VoiceState = {
+    readonly status: 'signed_out' | 'unavailable';
+} | {
+    readonly status: 'disabled';
+    readonly site: 'cn' | 'global';
+} | {
+    readonly status: 'ready';
+    readonly site: 'cn' | 'global';
+    readonly authorizationId: string;
+    readonly catalog: VoiceCatalog;
+    readonly maxSeconds: number;
+};
+/**
+ * Localized failure keys shared by the Host response and composer.
+ * 宿主响应与输入框共用的本地化错误键。
+ */
+export type VoiceErrorCode = 'signed_out' | 'unavailable' | 'selection_unavailable' | 'invalid_audio' | 'rate_limited' | 'busy';
+/**
+ * The Host returns only text or a stable failure key and optional server wait time.
+ * 宿主仅返回转写文本，或稳定的错误键和可选的服务端等待时间。
+ */
+export type VoiceReply = {
+    readonly ok: true;
+    readonly text: string;
+} | {
+    readonly ok: false;
+    readonly code: VoiceErrorCode;
+    readonly retryAfter?: number;
+};
+/**
+ * One published transcription model and its supported language hints.
+ * 一个已发布的转写模型及它支持的优先语言。
+ */
+export interface VoiceModel {
+    readonly id: string;
+    readonly label: string;
+    readonly languages: readonly string[];
+}
+/**
+ * The regional model catalog used by both voice controls.
+ * 两处语音控件共用的站点模型目录。
+ */
+export interface VoiceCatalog {
+    readonly defaultModelId: string;
+    readonly models: readonly VoiceModel[];
+}
+/**
+ * The exact model and optional language captured when recording begins.
+ * 开始录音时捕获的模型及可选优先语言。
+ */
+export interface VoiceSelection {
+    readonly modelId: string;
+    readonly language?: string;
+}

package/node_modules/@openvulcan/dsh-vulcan-voice-input/lib/contract.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@openvulcan/dsh-vulcan-voice-input/lib/index.d.ts

@@ -0,0 +1,49 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { OpenVulcanAccountService } from '@openvulcan/dsh-vulcan-account';
+import type { Credential } from '@openvulcan/openvulcan-account';
+export declare const name = "vulcan-voice-input";
+/**
+ * The identity captured before an async operation, with its cancellation generation.
+ * 异步操作开始前捕获的账号身份及其取消信号。
+ */
+interface AccountBinding {
+    readonly account: Pick<OpenVulcanAccountService, 'status' | 'credential'>;
+    readonly site: Credential['site'];
+    readonly id: string;
+    readonly signal: AbortSignal;
+}
+/**
+ * Gate the free microphone channel on the active OpenVulcan device authorization.
+ * 仅允许当前有效的 OpenVulcan 设备授权使用免费麦克风通道。
+ */
+export declare class VoiceInput {
+    #private;
+    private readonly getAccount;
+    private readonly transport;
+    /**
+     * Read the active account from its owning Cordis service and use the supplied native transport.
+     * 从所属 Cordis 服务读取当前账号，并使用指定的原生传输实现。
+     */
+    constructor(getAccount: () => AccountBinding['account'] | undefined, transport?: typeof fetch);
+    /**
+     * Discard readiness and cancel work associated with the previous device authorization.
+     * 清除可用状态并取消上一次设备授权所属的任务。
+     */
+    accountChanged(): void;
+    /**
+     * Report login, regional publication and the default model. Refresh is an explicit settings action.
+     * 返回登录状态、区域服务和默认模型。立即刷新由设置页显式触发。
+     */
+    status(request: Request): Promise<Response>;
+    /**
+     * Validate, submit and return one recording. Only one bounded upload is read at a time.
+     * 校验并提交一段录音，同一时刻只读取一份有界上传。
+     */
+    upload(request: Request): Promise<Response>;
+}
+/**
+ * Install the settings and audio routes within dsh's authenticated owner connection.
+ * 在 dsh 已认证的所有者连接内挂载设置与音频路由。
+ */
+export declare function apply(ctx: Context): void;
+export {};

package/node_modules/@openvulcan/dsh-vulcan-voice-input/lib/index.js

@@ -0,0 +1,204 @@
+import { getPublication, MAX_AUDIO_BYTES, MAX_SECONDS, readBounded, transcribe, validateWav, VoiceFailure } from './cloud.js';
+// Cordis entry identity and owner-only routes used by the browser contribution.
+// Cordis 条目标识与浏览器扩展使用的仅限所有者路由。
+export const name = 'vulcan-voice-input';
+const BASE = '/api/vulcan-voice-input/';
+// Status reads can reuse a recent directory; actual transcription always refreshes it.
+// 状态查询可复用近期目录，实际转写每次都重新读取目录。
+const CATALOG_TTL_MS = 60_000;
+/**
+ * Encode an owner-only response without allowing it to enter an HTTP cache.
+ * 编码仅限所有者的响应，并禁止 HTTP 缓存。
+ */
+function json(body, status = 200) {
+    return Response.json(body, { status, headers: { 'cache-control': 'no-store' } });
+}
+/**
+ * Drain a rejected, length-bounded browser upload without retaining audio so dsh can flush the error.
+ * 丢弃长度有界的浏览器上传且不保留音频，让 dsh 能完整返回错误。
+ */
+async function discardRejectedUpload(request) {
+    const length = request.headers.get('content-length');
+    if (request.body === null || request.bodyUsed || length === null || !/^\d+$/.test(length) ||
+        Number(length) > MAX_AUDIO_BYTES)
+        return;
+    // dsh closes an unread streaming request. A known-length HTTP body cannot exceed its framing length.
+    // dsh 会关闭未读完的流式请求。已知长度的 HTTP 正文不会超过其分帧长度。
+    const signal = AbortSignal.any([request.signal, AbortSignal.timeout(3000)]);
+    await request.body.pipeTo(new WritableStream(), { signal }).catch(() => { });
+}
+/**
+ * Gate the free microphone channel on the active OpenVulcan device authorization.
+ * 仅允许当前有效的 OpenVulcan 设备授权使用免费麦克风通道。
+ */
+export class VoiceInput {
+    getAccount;
+    transport;
+    // An account change invalidates cached readiness and cancels upstream work.
+    // 账号变化会清除缓存的可用状态并取消上游任务。
+    #epoch = new AbortController();
+    #catalog;
+    #uploading = false;
+    /**
+     * Read the active account from its owning Cordis service and use the supplied native transport.
+     * 从所属 Cordis 服务读取当前账号，并使用指定的原生传输实现。
+     */
+    constructor(getAccount, transport = fetch) {
+        this.getAccount = getAccount;
+        this.transport = transport;
+    }
+    /**
+     * Discard readiness and cancel work associated with the previous device authorization.
+     * 清除可用状态并取消上一次设备授权所属的任务。
+     */
+    accountChanged() {
+        this.#catalog = undefined;
+        this.#epoch.abort();
+        this.#epoch = new AbortController();
+    }
+    /**
+     * Report login, regional publication and the default model. Refresh is an explicit settings action.
+     * 返回登录状态、区域服务和默认模型。立即刷新由设置页显式触发。
+     */
+    async status(request) {
+        try {
+            const binding = await this.#binding();
+            const cached = this.#catalog;
+            let publication;
+            if (new URL(request.url).searchParams.get('refresh') !== '1' &&
+                cached !== undefined && cached.id === binding.id && cached.site === binding.site && cached.expires > Date.now()) {
+                publication = cached.publication;
+            }
+            else {
+                const credential = await this.#credential(binding);
+                publication = await getPublication(this.transport, credential, AbortSignal.any([binding.signal, request.signal]));
+                await this.#confirm(binding);
+                this.#catalog = { id: binding.id, site: binding.site, expires: Date.now() + CATALOG_TTL_MS, publication };
+            }
+            return publication === null ? json({ status: 'disabled', site: binding.site }) : json({
+                status: 'ready', site: binding.site, authorizationId: binding.id, catalog: publication, maxSeconds: MAX_SECONDS,
+            });
+        }
+        catch (error) {
+            return json({ status: error instanceof VoiceFailure && error.code === 'signed_out' ? 'signed_out' : 'unavailable' });
+        }
+    }
+    /**
+     * Validate, submit and return one recording. Only one bounded upload is read at a time.
+     * 校验并提交一段录音，同一时刻只读取一份有界上传。
+     */
+    async upload(request) {
+        let ownsUpload = false;
+        try {
+            const binding = await this.#binding();
+            if (request.headers.get('x-vulcan-voice-authorization') !== binding.id)
+                throw new VoiceFailure('signed_out', 401);
+            if (request.headers.get('content-type') !== 'audio/wav' || request.headers.has('content-encoding')) {
+                throw new VoiceFailure('invalid_audio', 415);
+            }
+            if (this.#uploading)
+                throw new VoiceFailure('busy', 503);
+            this.#uploading = ownsUpload = true;
+            const signal = AbortSignal.any([binding.signal, request.signal, AbortSignal.timeout(80_000)]);
+            const wav = await readBounded(request, MAX_AUDIO_BYTES, new VoiceFailure('invalid_audio', 413), signal);
+            validateWav(wav);
+            const credential = await this.#credential(binding);
+            const publication = await getPublication(this.transport, credential, signal);
+            await this.#confirm(binding);
+            if (publication === null)
+                throw new VoiceFailure('unavailable', 503);
+            // Validate the recording's frozen selection against the account's current regional catalog.
+            // 对照该账号的当前站点目录，验证录音开始时冻结的选项。
+            const modelId = request.headers.get('x-vulcan-voice-model') ?? publication.defaultModelId;
+            const language = request.headers.get('x-vulcan-asr-language');
+            const model = publication.models.find(entry => entry.id === modelId);
+            if (model === undefined || (language !== null && !model.languages.includes(language))) {
+                throw new VoiceFailure('selection_unavailable', 409);
+            }
+            const text = await transcribe(this.transport, credential, signal, {
+                modelId, ...(language === null ? {} : { language }),
+            }, wav);
+            await this.#confirm(binding);
+            return json({ ok: true, text });
+        }
+        catch (error) {
+            await discardRejectedUpload(request);
+            const failure = error instanceof VoiceFailure ? error : new VoiceFailure('unavailable', 502);
+            return json({
+                ok: false, code: failure.code,
+                ...(failure.retryAfter === undefined ? {} : { retryAfter: failure.retryAfter }),
+            }, failure.status);
+        }
+        finally {
+            if (ownsUpload)
+                this.#uploading = false;
+        }
+    }
+    /**
+     * Capture the current account and its verified local authorization state.
+     * 捕获当前账号服务及已校验的本地设备授权状态。
+     */
+    async #binding() {
+        const signal = this.#epoch.signal;
+        const account = this.getAccount();
+        if (account === undefined)
+            throw new VoiceFailure('signed_out', 401);
+        const status = await account.status();
+        if (signal.aborted || this.getAccount() !== account || !status.signedIn || status.reauthRequired ||
+            status.site === undefined || status.authorizationId === undefined)
+            throw new VoiceFailure('signed_out', 401);
+        return { account, id: status.authorizationId, site: status.site, signal };
+    }
+    /**
+     * Recheck the account after awaits so work cannot move to a new authorization.
+     * 在异步等待后复核账号，防止任务跨设备授权继续执行。
+     */
+    async #confirm(binding) {
+        const current = await this.#binding();
+        if (binding.signal.aborted || binding.account !== current.account || binding.id !== current.id ||
+            binding.site !== current.site)
+            throw new VoiceFailure('signed_out', 401);
+    }
+    /**
+     * Refresh a native credential through the account service and verify its owner.
+     * 通过账号服务刷新原生凭据，并验证其归属。
+     */
+    async #credential(binding) {
+        const credential = await binding.account.credential().catch(() => { throw new VoiceFailure('signed_out', 401); });
+        await this.#confirm(binding);
+        if (credential.authorization_id !== binding.id || credential.site !== binding.site) {
+            throw new VoiceFailure('signed_out', 401);
+        }
+        return credential;
+    }
+}
+/**
+ * Install the settings and audio routes within dsh's authenticated owner connection.
+ * 在 dsh 已认证的所有者连接内挂载设置与音频路由。
+ */
+export function apply(ctx) {
+    // Cordis wraps services on each lookup, so capture one proxy for each injection lifetime.
+    // Cordis 每次查找都会包装服务，因此在每次注入的生命周期内复用同一个代理。
+    let account;
+    const voice = new VoiceInput(() => account);
+    ctx.inject(['openvulcanAccount'], child => {
+        child.effect(() => {
+            const activeAccount = child.openvulcanAccount;
+            const stop = activeAccount.onChange(() => voice.accountChanged());
+            account = activeAccount;
+            return () => {
+                account = undefined;
+                stop();
+                voice.accountChanged();
+            };
+        }, 'vulcan-voice-input: account');
+    });
+    ctx.inject(['connection'], child => {
+        child.effect(() => child.connection.fetch.register({
+            path: `${BASE}state`, methods: ['GET'], requestBody: 'buffered', fetch: request => voice.status(request),
+        }), 'vulcan-voice-input: state');
+        child.effect(() => child.connection.fetch.register({
+            path: `${BASE}transcriptions`, methods: ['POST'], requestBody: 'streaming', fetch: request => voice.upload(request),
+        }), 'vulcan-voice-input: transcriptions');
+    });
+}

package/node_modules/@openvulcan/dsh-vulcan-voice-input/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@openvulcan/dsh-vulcan-voice-input",
+  "version": "0.4.4",
+  "description": "Microphone dictation in DeepSeek Harness using OpenVulcan's free transcription service.",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "!lib/**/*.test.*"
+  ],
+  "engines": {
+    "dsh": ">=0.2.1-rc.2 <0.3.0"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-general",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
+    }
+  },
+  "dependencies": {
+    "@openvulcan/openvulcan-account": "0.4.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/dsh-client-connection": "^0.2.1-rc.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/node_modules/@openvulcan/openvulcan-account/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvulcan/openvulcan-account",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "OpenVulcan account: device sign-in, credential storage and refresh, shared by the Vulcan tools.",
   "license": "MIT",
   "repository": {

package/node_modules/@openvulcan/vulcan-decision/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvulcan/vulcan-decision",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Vulcan Decision: judge AI coding tool calls before they run, with OpenVulcan cloud endpoints or an optional local model runtime.",
   "license": "MIT",
   "repository": {
@@ -35,6 +35,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@openvulcan/openvulcan-account": "0.4.3"
+    "@openvulcan/openvulcan-account": "0.4.4"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openvulcan/dsh-vulcancode",
-  "version": "0.4.3",
-  "description": "VulcanCode for DeepSeek Harness (dsh): OpenVulcan account, Vulcan Decision permission guard, interactive answers, LuaSkills, long-term memory, custom thinking levels and the VulcanCode look. Community plugins, not affiliated with DeepSeek.",
+  "version": "0.4.4",
+  "description": "VulcanCode for DeepSeek Harness (dsh): OpenVulcan account, Vulcan Decision permission guard, interactive answers, LuaSkills, long-term memory, custom thinking levels, voice input and the VulcanCode look. Community plugins, not affiliated with DeepSeek.",
   "license": "MIT",
   "icon": "./assets/openvulcan-icon.svg",
   "repository": {
@@ -27,18 +27,19 @@
     }
   },
   "dependencies": {
-    "@openvulcan/dsh-decision-guard": "0.4.3",
-    "@openvulcan/dsh-vulcan-account": "0.4.3",
-    "@openvulcan/dsh-vulcan-answers": "0.4.3",
-    "@openvulcan/dsh-vulcan-luaskills": "0.4.3",
-    "@openvulcan/dsh-vulcan-memory": "0.4.3",
-    "@openvulcan/dsh-vulcan-reasoning": "0.4.3",
-    "@openvulcan/dsh-vulcan-style": "0.4.3",
+    "@openvulcan/dsh-decision-guard": "0.4.4",
+    "@openvulcan/dsh-vulcan-account": "0.4.4",
+    "@openvulcan/dsh-vulcan-answers": "0.4.4",
+    "@openvulcan/dsh-vulcan-luaskills": "0.4.4",
+    "@openvulcan/dsh-vulcan-memory": "0.4.4",
+    "@openvulcan/dsh-vulcan-reasoning": "0.4.4",
+    "@openvulcan/dsh-vulcan-style": "0.4.4",
+    "@openvulcan/dsh-vulcan-voice-input": "0.4.4",
     "fflate": "^0.8.3",
     "mdast-util-from-markdown": "^2.0.2",
     "zod": "4.4.3",
-    "@openvulcan/openvulcan-account": "0.4.3",
-    "@openvulcan/vulcan-decision": "0.4.3"
+    "@openvulcan/openvulcan-account": "0.4.4",
+    "@openvulcan/vulcan-decision": "0.4.4"
   },
   "publishConfig": {
     "access": "public"
@@ -51,6 +52,7 @@
     "@openvulcan/dsh-vulcan-memory",
     "@openvulcan/dsh-vulcan-reasoning",
     "@openvulcan/dsh-vulcan-style",
+    "@openvulcan/dsh-vulcan-voice-input",
     "@openvulcan/openvulcan-account",
     "@openvulcan/vulcan-decision"
   ]