mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-11-16 11:19:33 +01:00
56 lines
2.6 KiB
TypeScript
56 lines
2.6 KiB
TypeScript
/**
|
|||
|
|
* @fileoverview Bounds and endpoint config for Claude voice dictation.
|
||
|
|
*
|
||
|
|
* Backs the browser → Codeman → Anthropic dictation relay (`src/web/voice-stream.ts`,
|
||
|
|
* `src/web/routes/voice-routes.ts`; design in `docs/claude-voice-plan.md`).
|
||
|
|
*
|
||
|
|
* Why everything here is bounded: an open microphone is an open pipe. Each live
|
||
|
|
* stream holds a browser socket, an upstream socket and a keepalive timer, and
|
||
|
|
* every second of audio is billed against the server owner's Claude subscription.
|
||
|
|
* A tab left recording (phone in a pocket, forgotten laptop) must cost a bounded
|
||
|
|
* amount, so streams die on their own at `MAX_STREAM_MS` and the server refuses
|
||
|
|
* more than `MAX_CONCURRENT_STREAMS` at once.
|
||
|
|
*
|
||
|
|
* The audio frame cap is a memory guard on a socket that carries attacker-shaped
|
||
|
|
* binary data: PCM16 at 16 kHz mono is 32 KB/s, so a 256 ms frame is ~8 KB and
|
||
|
|
* anything near 64 KB is either a broken client or an attempt to make the relay
|
||
|
|
* buffer for someone else.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/** Upstream speech-to-text service (the one Claude Code's own `/voice` mode uses). */
|
||
|
|
export const VOICE_STREAM_HOST = 'wss://api.anthropic.com';
|
||
|
|
|
||
|
|
/** Path of the streaming speech-to-text endpoint. */
|
||
|
|
export const VOICE_STREAM_PATH = '/api/ws/speech_to_text/voice_stream';
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Base override, for tests (point the relay at a local mock) and for users on an
|
||
|
|
* Anthropic-compatible gateway. Must be a ws:// or wss:// origin.
|
||
|
|
*/
|
||
|
|
export function voiceStreamBase(env: NodeJS.ProcessEnv = process.env): string {
|
||
|
|
const override = typeof env.CODEMAN_VOICE_STREAM_BASE === 'string' ? env.CODEMAN_VOICE_STREAM_BASE.trim() : '';
|
||
|
|
if (override && /^wss?:\/\//.test(override)) return override.replace(/\/+$/, '');
|
||
|
|
return VOICE_STREAM_HOST;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Upstream drops an idle socket; the CLI pings at 8s and so do we. */
|
||
|
|
export const KEEPALIVE_INTERVAL_MS = 8000;
|
||
|
|
|
||
|
|
/** Hard ceiling on one dictation. Long enough for any real utterance, short enough to bound a forgotten mic. */
|
||
|
|
export const MAX_STREAM_MS = 5 * 60_000;
|
||
|
|
|
||
|
|
/** Concurrent relays server-wide. Dictation is a human-paced, one-at-a-time act. */
|
||
|
|
export const MAX_CONCURRENT_STREAMS = 4;
|
||
|
|
|
||
|
|
/** Largest single audio frame accepted from the browser (~2s of PCM16 @16 kHz mono). */
|
||
|
|
export const MAX_AUDIO_FRAME_BYTES = 64 * 1024;
|
||
|
|
|
||
|
|
/** How long to wait for the final transcript after the client asks to finalize. */
|
||
|
|
export const FINALIZE_TIMEOUT_MS = 3000;
|
||
|
|
|
||
|
|
/** Upstream caps the keyterms header; mirrors the CLI's own limit. */
|
||
|
|
export const MAX_KEYTERMS_HEADER_CHARS = 1024;
|
||
|
|
|
||
|
|
/** Audio format the endpoint is opened with. The browser worklet must match exactly. */
|
||
|
|
export const AUDIO_SAMPLE_RATE = 16000;
|
||
|
|
export const AUDIO_CHANNELS = 1;
|