@swttch/extend-kit 0.3.0 → 0.5.0

package/README.ko.md

@@ -7,7 +7,7 @@
 | 도구 | 번들에 못 들어가는 이유 |
 | --- | --- |
 | **battery** | *사용자 본인의* 머신에 저장된 Claude Code 로그인 정보(keychain 또는 자격증명 파일)를 읽어야 합니다 |
-| **stt** | 예정. 플러그인이 실어 나를 수 없는 네이티브 바이너리가 필요합니다 |
+| **stt** | 받아쓰기는 OAuth 토큰을 전송하는데, JetBrains 플러그인은 자격증명을 다룰 수 없습니다 |
 
 ## battery
 
@@ -396,6 +396,67 @@ $ ccb oauth usage --json
 }
 ```
 
+## stt
+
+다른 Claude Code 클라이언트들이 쓰는 것과 동일한 음성 서비스로 실시간 받아쓰기를 합니다. 이 머신에 이미 있는 Claude Code 로그인(`battery`가 읽는 그 로그인)으로 인증하므로, 별도의 API 키도 별도의 과금도 없습니다.
+
+```typescript
+import { stt } from '@swttch/extend-kit';
+
+const stream = await stt.openSpeechToTextStream({
+  onTranscript: (text, isFinal) => {
+    // isFinal false → 곧 교체될 추정값입니다. 보여주되 쌓아두지 마세요.
+    // isFinal true  → 확정된 텍스트입니다. 이어붙이세요.
+    if (isFinal) console.log(text);
+  },
+  onError: (message, info) => {
+    // info.fatal 이면 재시도해도 소용없습니다(예: 토큰이 거부됨).
+    console.error(message);
+  },
+});
+
+// 16비트 PCM, 16kHz, 모노를 그대로 넣습니다. 소켓이 열리기 전에 보낸 오디오는
+// 버퍼링되므로, 곧바로 녹음을 시작해도 앞부분이 잘리지 않습니다.
+stream.sendAudio(pcmChunk);
+
+// 닫을 때 마지막 발화를 잠시 기다린 뒤 종료합니다.
+await stream.close();
+```
+
+### 오디오 형식
+
+서비스는 한 가지 형식만 받으며, 다른 것을 보내면 에러가 아니라 **무음으로 처리**됩니다.
+
+| | |
+| --- | --- |
+| 인코딩 | `linear16` (부호 있는 16비트 PCM, 리틀 엔디언) |
+| 샘플레이트 | 16000 Hz |
+| 채널 | 1 (모노) |
+
+런타임에 이 값이 필요하면 `stt.AUDIO_FORMAT`에 들어 있습니다.
+
+### 옵션
+
+```typescript
+await stt.openSpeechToTextStream(handlers, {
+  language: 'ko',                       // BCP-47. 기본값은 'en'
+  extraKeyterms: ['Swttch', 'JCEF'],    // 사용하는 어휘 쪽으로 인식을 유도
+  typedInterims: true,                  // 확정 전 추정값도 함께 스트리밍
+});
+```
+
+일반 음성 모델은 기술 용어를 잘못 알아듣습니다("MCP"를 "MTP"로). 기본 프로그래밍 용어 목록이 항상 적용되며, `extraKeyterms`는 거기에 추가됩니다.
+
+### 사용 가능 여부 먼저 확인하기
+
+```typescript
+if (!(await stt.isSpeechToTextAvailable())) {
+  // 이 머신에 Claude Code가 로그인되어 있지 않습니다.
+}
+```
+
+> **참고**: 이 엔드포인트는 Anthropic이 문서화한 API가 아닙니다. 예고 없이 바뀔 수 있습니다. 클라이언트는 모르는 메시지 타입을 실패로 처리하지 않고 무시하지만, 더 큰 변경이 생기면 받아쓰기가 깨질 수 있습니다.
+
 ## 개발
 
 ### 설치

package/README.md

@@ -7,7 +7,7 @@ The companion tools [Swttch](https://github.com/Swttch/swttch) needs but cannot
 | Tool | Why it lives outside the bundle |
 | --- | --- |
 | **battery** | Reads the Claude Code login stored on *your* machine (keychain, or a credentials file) |
-| **stt** | Planned. Needs native binaries the plugin cannot carry |
+| **stt** | Dictation sends your OAuth token, and a JetBrains plugin may not handle credentials |
 
 ## battery
 
@@ -396,6 +396,67 @@ $ ccb oauth usage --json
 }
 ```
 
+## stt
+
+Live dictation against the same speech service the other Claude Code clients use. It authenticates with the Claude Code login already on this machine — the same one `battery` reads — so there is no separate API key and no separate bill.
+
+```typescript
+import { stt } from '@swttch/extend-kit';
+
+const stream = await stt.openSpeechToTextStream({
+  onTranscript: (text, isFinal) => {
+    // isFinal false → a live guess that will be replaced; show it, don't keep it.
+    // isFinal true  → settled text; append it.
+    if (isFinal) console.log(text);
+  },
+  onError: (message, info) => {
+    // info.fatal means retrying won't help (e.g. the token was rejected).
+    console.error(message);
+  },
+});
+
+// Feed raw 16-bit PCM, 16 kHz, mono. Audio sent before the socket finishes
+// opening is buffered, so you can start recording immediately.
+stream.sendAudio(pcmChunk);
+
+// Closing waits briefly for the last words, then resolves.
+await stream.close();
+```
+
+### Audio format
+
+The service accepts one format, and sending anything else yields silence rather than an error:
+
+| | |
+| --- | --- |
+| Encoding | `linear16` (raw signed 16-bit PCM, little-endian) |
+| Sample rate | 16000 Hz |
+| Channels | 1 (mono) |
+
+`stt.AUDIO_FORMAT` carries these values if you need them at runtime.
+
+### Options
+
+```typescript
+await stt.openSpeechToTextStream(handlers, {
+  language: 'ko',                       // BCP-47; defaults to 'en'
+  extraKeyterms: ['Swttch', 'JCEF'],    // bias recognition toward your vocabulary
+  typedInterims: true,                  // also stream partial guesses
+});
+```
+
+A general speech model mishears technical words — "MCP" becomes "MTP". A default set of programming terms is always applied; `extraKeyterms` adds to it.
+
+### Checking availability first
+
+```typescript
+if (!(await stt.isSpeechToTextAvailable())) {
+  // Claude Code is not logged in on this machine.
+}
+```
+
+> **Note**: this endpoint is not part of Anthropic's documented API. It may change without warning. The client ignores message types it does not recognise rather than failing, but a larger change could still break dictation.
+
 ## Development
 
 ### Installation
@@ -443,3 +504,16 @@ MIT
 ## Author
 
 yhk1038
+
+## Saved-account usage (CLI)
+
+`ccb --capabilities --json` reports `oauth.usage.account-file` when supported.
+`ccb oauth usage --account-file="/path/to/account-snapshot.json" --json` reads a
+CCG account snapshot (`credentials` is a JSON string, `oauthAccount.emailAddress`
+identifies the account) and queries that account without switching the live login.
+Credential values are never command arguments or CLI output. The CLI may use a
+newer live credential when the live email matches the selected snapshot; otherwise
+it uses the snapshot. Expired tokens return `token_expired`. No token refresh,
+credential writes, caching, retries or automatic account switching are performed.
+The caller owns process timeout and recovery policy. Plain `ccb oauth usage`
+retains its existing behaviour.

package/dist/battery/auth/keychain.d.ts

@@ -1,2 +1,2 @@
 import type { ClaudeCredentials } from './types.js';
-export declare function readKeychainCredentials(): Promise<ClaudeCredentials>;
+export declare function readKeychainCredentials(configDir?: string): Promise<ClaudeCredentials>;

package/dist/battery/auth/keychain.js

@@ -1,4 +1,5 @@
 import { execFile } from 'node:child_process';
+import { createHash } from 'node:crypto';
 import { promisify } from 'node:util';
 const execFileAsync = promisify(execFile);
 const SERVICE_NAME = 'Claude Code-credentials';
@@ -6,11 +7,11 @@ async function getOsUsername() {
     const { stdout } = await execFileAsync('whoami');
     return stdout.trim();
 }
-export async function readKeychainCredentials() {
+export async function readKeychainCredentials(configDir) {
     const account = await getOsUsername();
     const { stdout } = await execFileAsync('security', [
         'find-generic-password',
-        '-s', SERVICE_NAME,
+        '-s', configDir ? `${SERVICE_NAME}-${createHash('sha256').update(configDir).digest('hex').slice(0, 8)}` : SERVICE_NAME,
         '-a', account,
         '-w',
     ]);

package/dist/battery/auth/keychain.js.map

@@ -1 +1 @@
-{"version":3,"file":"keychain.js","sourceRoot":"","sources":["../../../src/battery/auth/keychain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C,KAAK,UAAU,aAAa;IAC1B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE;QACjD,uBAAuB;QACvB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,OAAO;QACb,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"keychain.js","sourceRoot":"","sources":["../../../src/battery/auth/keychain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C,KAAK,UAAU,aAAa;IAC1B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,SAAkB;IAC9D,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE;QACjD,uBAAuB;QACvB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY;QACtH,IAAI,EAAE,OAAO;QACb,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/account-credentials.d.ts

@@ -0,0 +1,3 @@
+import type { ClaudeCredentials } from '../battery/auth/types.js';
+/** Read a CCG saved-account snapshot without replacing the active credential slot. */
+export declare function getAccountCredentials(file: string): Promise<ClaudeCredentials>;

package/dist/cli/account-credentials.js

@@ -0,0 +1,43 @@
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { getCredentials } from '../battery/auth/index.js';
+import { readKeychainCredentials } from '../battery/auth/keychain.js';
+import { CcbError } from '../battery/errors.js';
+/** Read a CCG saved-account snapshot without replacing the active credential slot. */
+export async function getAccountCredentials(file) {
+    let snapshot;
+    let credentials;
+    try {
+        snapshot = JSON.parse(await readFile(file, 'utf8'));
+        credentials = JSON.parse(snapshot.credentials ?? '');
+        if (!credentials.claudeAiOauth?.accessToken)
+            throw new Error('Missing access token');
+    }
+    catch {
+        // Parsing errors must never echo a credential blob in stderr.
+        throw new CcbError('Saved account credentials are unavailable or invalid.', 'credentials_not_found');
+    }
+    const email = snapshot.oauthAccount?.emailAddress;
+    const configDir = process.env.CLAUDE_CONFIG_DIR;
+    const liveEmail = async () => {
+        const metadata = JSON.parse(await readFile(join(configDir ?? homedir(), '.claude.json'), 'utf8'));
+        return metadata.oauthAccount?.emailAddress;
+    };
+    // A currently active account can have a newer token than its saved snapshot.
+    // Never use the live slot for a different account. No writes or token refresh.
+    try {
+        if (email && await liveEmail() === email) {
+            const live = process.platform === 'darwin'
+                ? await readKeychainCredentials(configDir) : await getCredentials();
+            if (await liveEmail() === email && live.claudeAiOauth?.accessToken)
+                credentials = live;
+        }
+    }
+    catch { /* The saved snapshot remains the fallback. */ }
+    if (Number.isFinite(credentials.claudeAiOauth.expiresAt) && Date.now() >= credentials.claudeAiOauth.expiresAt) {
+        throw new CcbError('Saved account token has expired. Log in to this account again.', 'token_expired');
+    }
+    return credentials;
+}
+//# sourceMappingURL=account-credentials.js.map

package/dist/cli/account-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-credentials.js","sourceRoot":"","sources":["../../src/cli/account-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,IAAI,QAA4E,CAAC;IACjF,IAAI,WAA8B,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACpD,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;QAC9D,MAAM,IAAI,QAAQ,CAAC,uDAAuD,EAAE,uBAAuB,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAChD,MAAM,SAAS,GAAG,KAAK,IAAiC,EAAE;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE/F,CAAC;QACF,OAAO,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAC7C,CAAC,CAAC;IACF,6EAA6E;IAC7E,+EAA+E;IAC/E,IAAI,CAAC;QACH,IAAI,KAAK,IAAI,MAAM,SAAS,EAAE,KAAK,KAAK,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBACxC,CAAC,CAAC,MAAM,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,cAAc,EAAE,CAAC;YACtE,IAAI,MAAM,SAAS,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,WAAW;gBAAE,WAAW,GAAG,IAAI,CAAC;QACzF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,8CAA8C,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;QAC9G,MAAM,IAAI,QAAQ,CAAC,gEAAgE,EAAE,eAAe,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/cli/index.js

@@ -2,6 +2,7 @@
 import { getCredentials, getAccessToken } from '../battery/auth/index.js';
 import { ClaudeCodeClient } from '../battery/api/index.js';
 import { oauthCommand } from './oauth.js';
+import { getAccountCredentials } from './account-credentials.js';
 import { CcbError } from '../battery/errors.js';
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
@@ -13,13 +14,21 @@ const args = process.argv.slice(2);
 const command = args.filter((a) => !a.startsWith('-'));
 const flags = new Set(args.filter((a) => a.startsWith('-')));
 const jsonOutput = flags.has('--json');
+const accountFile = args.find(arg => arg.startsWith('--account-file='))?.slice('--account-file='.length);
 async function createClient() {
-    const credentials = await getCredentials();
+    const credentials = accountFile ? await getAccountCredentials(accountFile) : await getCredentials();
     const token = getAccessToken(credentials);
     return new ClaudeCodeClient(token);
 }
 async function run() {
     const [module, ...subcommand] = command;
+    if (flags.has('--capabilities')) {
+        console.log(JSON.stringify({ capabilities: ['oauth.usage.account-file'] }));
+        return;
+    }
+    if (args.some(arg => arg.startsWith('--account-file')) && (!accountFile || module !== 'oauth' || subcommand[0] !== 'usage')) {
+        throw new CcbError('Use oauth usage --account-file=<snapshot path>.', 'invalid_argument');
+    }
     if (flags.has('-v') || flags.has('--version')) {
         console.log(VERSION);
         return;
@@ -34,6 +43,8 @@ Commands:
   oauth profile    Show account profile
 
 Options:
+  --account-file=<path>  Read usage for a CCG saved-account snapshot (no account switch)
+  --capabilities   Output supported CLI capabilities as JSON
   --json           Output as JSON
   -h, --help       Show help
   -v, --version    Show version`);

package/dist/cli/index.js.map

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

package/dist/index.d.ts

@@ -13,3 +13,4 @@
  */
 export * from './battery/index.js';
 export * as battery from './battery/index.js';
+export * as stt from './stt/index.js';

package/dist/index.js

@@ -15,4 +15,9 @@ export * from './battery/index.js';
 // Namespaced access, for callers who would rather be explicit about which
 // tool they are reaching for — `import { battery } from '@swttch/extend-kit'`.
 export * as battery from './battery/index.js';
+// Speech-to-text is namespace-only. Its names (`openSpeechToTextStream`,
+// `AUDIO_FORMAT`) are generic enough that exporting them flat would collide
+// with a caller's own, and unlike battery it has no legacy flat imports to
+// preserve — `import { stt } from '@swttch/extend-kit'`.
+export * as stt from './stt/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,oBAAoB,CAAC;AAEnC,0EAA0E;AAC1E,+EAA+E;AAC/E,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,oBAAoB,CAAC;AAEnC,0EAA0E;AAC1E,+EAA+E;AAC/E,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,yDAAyD;AACzD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}

package/dist/stt/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Speech-to-text — dictation against the same service the other Claude Code
+ * clients use.
+ *
+ * It lives out here, outside the plugin bundle, because transcribing means
+ * sending the account's OAuth token and a JetBrains plugin may not handle
+ * credentials. This package already reads the local Claude Code login for the
+ * usage panel, so dictation reuses that path.
+ */
+export { openSpeechToTextStream, isSpeechToTextAvailable } from './stream.js';
+export { DEFAULT_KEYTERMS, packKeyterms } from './keyterms.js';
+export { AUDIO_FORMAT, TranscriptMessageType } from './types.js';
+export type { SpeechToTextOptions, SpeechToTextHandlers, SpeechToTextStream, TranscriptMessage, } from './types.js';

package/dist/stt/index.js

@@ -0,0 +1,13 @@
+/**
+ * Speech-to-text — dictation against the same service the other Claude Code
+ * clients use.
+ *
+ * It lives out here, outside the plugin bundle, because transcribing means
+ * sending the account's OAuth token and a JetBrains plugin may not handle
+ * credentials. This package already reads the local Claude Code login for the
+ * usage panel, so dictation reuses that path.
+ */
+export { openSpeechToTextStream, isSpeechToTextAvailable } from './stream.js';
+export { DEFAULT_KEYTERMS, packKeyterms } from './keyterms.js';
+export { AUDIO_FORMAT, TranscriptMessageType } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/stt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/stt/keyterms.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Words the recognizer is told to expect.
+ *
+ * A general speech model mishears technical vocabulary — "MCP" becomes "MTP",
+ * "grep" becomes "graph". Biasing the recognizer toward terms a developer
+ * actually says fixes that, and costs nothing when they are not spoken.
+ */
+/** Terms every session biases toward, regardless of what the caller asks for. */
+export declare const DEFAULT_KEYTERMS: readonly string[];
+/**
+ * Pack terms into the comma-separated header value the service expects.
+ *
+ * Commas separate entries, so a comma inside a term would split it in two —
+ * they become spaces. Non-ASCII is dropped because the value travels in an
+ * HTTP header, where anything outside printable ASCII is not safely
+ * transmissible. Duplicates are removed so a caller repeating a default term
+ * does not eat the budget twice, and the list is cut at the byte cap rather
+ * than sent over-long.
+ */
+export declare function packKeyterms(terms: readonly string[]): string;

package/dist/stt/keyterms.js

@@ -0,0 +1,62 @@
+/**
+ * Words the recognizer is told to expect.
+ *
+ * A general speech model mishears technical vocabulary — "MCP" becomes "MTP",
+ * "grep" becomes "graph". Biasing the recognizer toward terms a developer
+ * actually says fixes that, and costs nothing when they are not spoken.
+ */
+/** Terms every session biases toward, regardless of what the caller asks for. */
+export const DEFAULT_KEYTERMS = [
+    'VS Code',
+    'IDE',
+    'webview',
+    'IntelliSense',
+    'MCP',
+    'symlink',
+    'grep',
+    'regex',
+    'localhost',
+    'codebase',
+    'TypeScript',
+    'JSON',
+    'OAuth',
+    'webhook',
+    'gRPC',
+    'dotfiles',
+    'subagent',
+    'worktree',
+];
+/** The service caps the keyterm header; longer lists are cut, not rejected. */
+const MAX_KEYTERM_BYTES = 1024;
+/**
+ * Pack terms into the comma-separated header value the service expects.
+ *
+ * Commas separate entries, so a comma inside a term would split it in two —
+ * they become spaces. Non-ASCII is dropped because the value travels in an
+ * HTTP header, where anything outside printable ASCII is not safely
+ * transmissible. Duplicates are removed so a caller repeating a default term
+ * does not eat the budget twice, and the list is cut at the byte cap rather
+ * than sent over-long.
+ */
+export function packKeyterms(terms) {
+    const seen = new Set();
+    const packed = [];
+    let size = 0;
+    for (const term of terms) {
+        const clean = term
+            .replace(/,/g, ' ')
+            .replace(/[^\x20-\x7E]/g, '')
+            .replace(/\s+/g, ' ')
+            .trim();
+        if (!clean || seen.has(clean))
+            continue;
+        const cost = clean.length + (packed.length > 0 ? 1 : 0);
+        if (size + cost > MAX_KEYTERM_BYTES)
+            break;
+        seen.add(clean);
+        packed.push(clean);
+        size += cost;
+    }
+    return packed.join(',');
+}
+//# sourceMappingURL=keyterms.js.map

package/dist/stt/keyterms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyterms.js","sourceRoot":"","sources":["../../src/stt/keyterms.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,SAAS;IACT,KAAK;IACL,SAAS;IACT,cAAc;IACd,KAAK;IACL,SAAS;IACT,MAAM;IACN,OAAO;IACP,WAAW;IACX,UAAU;IACV,YAAY;IACZ,MAAM;IACN,OAAO;IACP,SAAS;IACT,MAAM;IACN,UAAU;IACV,UAAU;IACV,UAAU;CACX,CAAC;AAEF,+EAA+E;AAC/E,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI;aACf,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;aAClB,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;aAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,IAAI,EAAE,CAAC;QACV,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAExC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,IAAI,GAAG,IAAI,GAAG,iBAAiB;YAAE,MAAM;QAE3C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/stt/stream.d.ts

@@ -0,0 +1,26 @@
+import { type SpeechToTextHandlers, type SpeechToTextOptions, type SpeechToTextStream } from './types.js';
+/**
+ * Open a live transcription stream against the same service the other Claude
+ * Code clients use.
+ *
+ * This lives outside the plugin bundle on purpose. Transcribing means sending
+ * the account's OAuth token, and a JetBrains plugin is not allowed to handle
+ * credentials — so the plugin shells out to this package, which reads the
+ * Claude Code login already on the machine, exactly as the usage panel does.
+ *
+ * The endpoint is undocumented. We call it the way the official clients do and
+ * treat every response as untrusted: unknown message types are ignored rather
+ * than surfaced as errors, so a new message type added server-side does not
+ * break dictation.
+ *
+ * @param handlers Callbacks for text, failure, and readiness.
+ * @param options Language and vocabulary hints.
+ * @param token OAuth token; read from the local Claude Code login when omitted.
+ */
+export declare function openSpeechToTextStream(handlers: SpeechToTextHandlers, options?: SpeechToTextOptions, token?: string): Promise<SpeechToTextStream>;
+/**
+ * Whether this machine can transcribe at all — that is, whether Claude Code is
+ * logged in here. Lets a caller show "sign in first" instead of opening a
+ * socket that is bound to be rejected.
+ */
+export declare function isSpeechToTextAvailable(): Promise<boolean>;

package/dist/stt/stream.js

@@ -0,0 +1,227 @@
+import WebSocket from 'ws';
+import { getCredentials, getAccessToken } from '../battery/auth/index.js';
+import { CcbError } from '../battery/errors.js';
+import { DEFAULT_KEYTERMS, packKeyterms } from './keyterms.js';
+import { AUDIO_FORMAT, TranscriptMessageType, } from './types.js';
+const VOICE_STREAM_URL = 'wss://api.anthropic.com/api/ws/speech_to_text/voice_stream';
+/** The service drops idle sockets; this is well inside its window. */
+const KEEPALIVE_INTERVAL_MS = 8000;
+/** How long to wait for trailing words after asking the service to stop. */
+const CLOSE_GRACE_MS = 3000;
+const KEEPALIVE = JSON.stringify({ type: 'KeepAlive' });
+const CLOSE_STREAM = JSON.stringify({ type: 'CloseStream' });
+/**
+ * Open a live transcription stream against the same service the other Claude
+ * Code clients use.
+ *
+ * This lives outside the plugin bundle on purpose. Transcribing means sending
+ * the account's OAuth token, and a JetBrains plugin is not allowed to handle
+ * credentials — so the plugin shells out to this package, which reads the
+ * Claude Code login already on the machine, exactly as the usage panel does.
+ *
+ * The endpoint is undocumented. We call it the way the official clients do and
+ * treat every response as untrusted: unknown message types are ignored rather
+ * than surfaced as errors, so a new message type added server-side does not
+ * break dictation.
+ *
+ * @param handlers Callbacks for text, failure, and readiness.
+ * @param options Language and vocabulary hints.
+ * @param token OAuth token; read from the local Claude Code login when omitted.
+ */
+export async function openSpeechToTextStream(handlers, options = {}, token) {
+    const accessToken = token ?? getAccessToken(await getCredentials());
+    const query = new URLSearchParams({
+        encoding: AUDIO_FORMAT.encoding,
+        sample_rate: String(AUDIO_FORMAT.sampleRate),
+        channels: String(AUDIO_FORMAT.channels),
+        // How long a pause counts as the end of a phrase, and of a whole utterance.
+        endpointing_ms: '300',
+        utterance_end_ms: '1000',
+        language: options.language ?? 'en',
+        use_conversation_engine: 'true',
+        ...(options.typedInterims ? { forward_interims: 'typed' } : {}),
+        stt_provider: 'deepgram-nova3',
+    });
+    const keyterms = packKeyterms([...DEFAULT_KEYTERMS, ...(options.extraKeyterms ?? [])]);
+    const socket = new WebSocket(`${VOICE_STREAM_URL}?${query.toString()}`, {
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            'x-app': 'swttch',
+            'anthropic-client-platform': 'claude_code_swttch',
+            ...(keyterms ? { 'x-config-keyterms': keyterms } : {}),
+        },
+    });
+    let keepalive = null;
+    let closing = false;
+    /**
+     * Audio handed to us before the socket finished opening.
+     *
+     * Opening takes a moment, and a caller that starts recording the instant
+     * this function returns is doing the obvious thing — so dropping those first
+     * chunks would silently lose the beginning of every sentence. We hold them
+     * and flush on open instead. The cap keeps a socket that never opens from
+     * growing without bound; at 16 kHz mono 16-bit that is a few seconds of audio,
+     * far longer than a handshake.
+     */
+    const preOpenAudio = [];
+    let preOpenBytes = 0;
+    const MAX_PREOPEN_BYTES = AUDIO_FORMAT.sampleRate * 2 * 5;
+    /**
+     * Best text so far for the utterance in progress, not yet handed over as
+     * final.
+     *
+     * "Best" rather than "latest" because the service revises downward as well as
+     * up: a run reads "Hello. This is a test", then the next message comes back
+     * as just "Hello." while it reconsiders. Committing whatever arrived last
+     * would throw away the longer reading, so we keep the longest we have seen
+     * and let a later message replace it only when it extends that reading.
+     */
+    let pending = '';
+    function stopKeepalive() {
+        closing = true;
+        if (keepalive) {
+            clearInterval(keepalive);
+            keepalive = null;
+        }
+    }
+    /**
+     * Hand over whatever the speaker said but never finished. Without this, the
+     * last phrase before a close is silently dropped — the user watches their
+     * final sentence disappear.
+     */
+    function flushPending() {
+        if (!pending)
+            return;
+        const text = pending;
+        pending = '';
+        handlers.onTranscript(text, true);
+    }
+    socket.on('open', () => {
+        handlers.onOpen?.();
+        socket.send(KEEPALIVE);
+        // Whatever the caller recorded while we were connecting goes first, in
+        // order, so the transcript starts at the first word actually spoken.
+        for (const chunk of preOpenAudio)
+            socket.send(chunk);
+        preOpenAudio.length = 0;
+        preOpenBytes = 0;
+        keepalive = setInterval(() => {
+            if (socket.readyState === WebSocket.OPEN)
+                socket.send(KEEPALIVE);
+        }, KEEPALIVE_INTERVAL_MS);
+    });
+    socket.on('message', (raw) => {
+        let msg;
+        try {
+            msg = JSON.parse(raw.toString());
+        }
+        catch {
+            // Not JSON: nothing we can act on, and not worth alarming the user.
+            return;
+        }
+        switch (msg.type) {
+            case TranscriptMessageType.TranscriptInterim:
+            case TranscriptMessageType.TranscriptText:
+                // Both are still-changing guesses at the current utterance. Show every
+                // one of them so the caller can render live text, but only remember a
+                // reading that is at least as complete as what we already have — see
+                // the note on `pending` for why the newest is not always the best.
+                if (msg.data) {
+                    if (msg.data.length >= pending.length)
+                        pending = msg.data;
+                    handlers.onTranscript(msg.data, false);
+                }
+                break;
+            case TranscriptMessageType.TranscriptEndpoint:
+                // The speaker paused — what we have is settled.
+                flushPending();
+                break;
+            case TranscriptMessageType.TranscriptError:
+                handlers.onError(msg.description ?? 'transcription error');
+                break;
+            case TranscriptMessageType.Error:
+                handlers.onError(msg.message ?? 'server error');
+                break;
+            default:
+                // Unknown type: ignore. The endpoint is undocumented and may grow new
+                // messages; treating them as failures would break dictation for no reason.
+                break;
+        }
+    });
+    socket.on('error', (err) => {
+        if (closing)
+            return;
+        // A handshake rejection arrives as "Unexpected server response: 401". 4xx is
+        // the account's problem (expired token, no access) and retrying will not
+        // help; 5xx and transport errors are worth another attempt.
+        const status = /^Unexpected server response: (\d+)/.exec(err.message)?.[1];
+        const code = status ? Number(status) : undefined;
+        handlers.onError(`WebSocket error: ${err.message}`, {
+            fatal: code !== undefined && code >= 400 && code < 500,
+        });
+    });
+    socket.on('close', () => {
+        flushPending();
+        stopKeepalive();
+    });
+    return {
+        sendAudio(chunk) {
+            if (closing)
+                return;
+            if (socket.readyState === WebSocket.OPEN) {
+                socket.send(chunk);
+                return;
+            }
+            // Still connecting: hold it rather than drop it. Past the cap we discard
+            // the oldest, because if the socket is this slow the recent audio is the
+            // part still worth transcribing.
+            if (socket.readyState === WebSocket.CONNECTING) {
+                preOpenAudio.push(chunk);
+                preOpenBytes += chunk.byteLength;
+                while (preOpenBytes > MAX_PREOPEN_BYTES && preOpenAudio.length > 0) {
+                    preOpenBytes -= preOpenAudio.shift().byteLength;
+                }
+            }
+        },
+        close() {
+            if (closing || socket.readyState === WebSocket.CLOSED)
+                return Promise.resolve();
+            return new Promise((resolve) => {
+                // Ask politely, then stop waiting. The service usually sends a last
+                // transcript after CloseStream, but a hung socket must not hang the
+                // caller's UI, so the grace period is capped.
+                const giveUp = setTimeout(() => {
+                    stopKeepalive();
+                    flushPending();
+                    if (socket.readyState !== WebSocket.CLOSED)
+                        socket.close();
+                    resolve();
+                }, CLOSE_GRACE_MS);
+                if (socket.readyState === WebSocket.OPEN)
+                    socket.send(CLOSE_STREAM);
+                socket.once('close', () => {
+                    clearTimeout(giveUp);
+                    stopKeepalive();
+                    resolve();
+                });
+            });
+        },
+    };
+}
+/**
+ * Whether this machine can transcribe at all — that is, whether Claude Code is
+ * logged in here. Lets a caller show "sign in first" instead of opening a
+ * socket that is bound to be rejected.
+ */
+export async function isSpeechToTextAvailable() {
+    try {
+        getAccessToken(await getCredentials());
+        return true;
+    }
+    catch (err) {
+        if (err instanceof CcbError)
+            return false;
+        throw err;
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/stt/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/stt/stream.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,qBAAqB,GAKtB,MAAM,YAAY,CAAC;AAEpB,MAAM,gBAAgB,GAAG,4DAA4D,CAAC;AAEtF,sEAAsE;AACtE,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC,4EAA4E;AAC5E,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACxD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAA8B,EAC9B,UAA+B,EAAE,EACjC,KAAc;IAEd,MAAM,WAAW,GAAG,KAAK,IAAI,cAAc,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;IAEpE,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC;QAChC,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC;QAC5C,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC;QACvC,4EAA4E;QAC5E,cAAc,EAAE,KAAK;QACrB,gBAAgB,EAAE,MAAM;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,uBAAuB,EAAE,MAAM;QAC/B,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,YAAY,EAAE,gBAAgB;KAC/B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,GAAG,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEvF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,gBAAgB,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE;QACtE,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,WAAW,EAAE;YACtC,OAAO,EAAE,QAAQ;YACjB,2BAA2B,EAAE,oBAAoB;YACjD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD;KACF,CAAC,CAAC;IAEH,IAAI,SAAS,GAA0B,IAAI,CAAC;IAC5C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB;;;;;;;;;OASG;IACH,MAAM,YAAY,GAAiB,EAAE,CAAC;IACtC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,iBAAiB,GAAG,YAAY,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D;;;;;;;;;OASG;IACH,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,SAAS,aAAa;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,SAAS,EAAE,CAAC;YACd,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,SAAS,YAAY;QACnB,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,IAAI,GAAG,OAAO,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACrB,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,uEAAuE;QACvE,qEAAqE;QACrE,KAAK,MAAM,KAAK,IAAI,YAAY;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,YAAY,GAAG,CAAC,CAAC;QACjB,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAC3B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnE,CAAC,EAAE,qBAAqB,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;QAC3B,IAAI,GAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAsB,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,OAAO;QACT,CAAC;QAED,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,qBAAqB,CAAC,iBAAiB,CAAC;YAC7C,KAAK,qBAAqB,CAAC,cAAc;gBACvC,uEAAuE;gBACvE,sEAAsE;gBACtE,qEAAqE;gBACrE,mEAAmE;gBACnE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;oBACb,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;wBAAE,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;oBAC1D,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACzC,CAAC;gBACD,MAAM;YAER,KAAK,qBAAqB,CAAC,kBAAkB;gBAC3C,gDAAgD;gBAChD,YAAY,EAAE,CAAC;gBACf,MAAM;YAER,KAAK,qBAAqB,CAAC,eAAe;gBACxC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,qBAAqB,CAAC,CAAC;gBAC3D,MAAM;YAER,KAAK,qBAAqB,CAAC,KAAK;gBAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC;gBAChD,MAAM;YAER;gBACE,sEAAsE;gBACtE,2EAA2E;gBAC3E,MAAM;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;QAChC,IAAI,OAAO;YAAE,OAAO;QACpB,6EAA6E;QAC7E,yEAAyE;QACzE,4DAA4D;QAC5D,MAAM,MAAM,GAAG,oCAAoC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjD,QAAQ,CAAC,OAAO,CAAC,oBAAoB,GAAG,CAAC,OAAO,EAAE,EAAE;YAClD,KAAK,EAAE,IAAI,KAAK,SAAS,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,GAAG;SACvD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACtB,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,CAAC,KAAiB;YACzB,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;gBACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,yEAAyE;YACzE,yEAAyE;YACzE,iCAAiC;YACjC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU,EAAE,CAAC;gBAC/C,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzB,YAAY,IAAI,KAAK,CAAC,UAAU,CAAC;gBACjC,OAAO,YAAY,GAAG,iBAAiB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnE,YAAY,IAAI,YAAY,CAAC,KAAK,EAAG,CAAC,UAAU,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK;YACH,IAAI,OAAO,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAEhF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,oEAAoE;gBACpE,oEAAoE;gBACpE,8CAA8C;gBAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC7B,aAAa,EAAE,CAAC;oBAChB,YAAY,EAAE,CAAC;oBACf,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM;wBAAE,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC3D,OAAO,EAAE,CAAC;gBACZ,CAAC,EAAE,cAAc,CAAC,CAAC;gBAEnB,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;oBAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAEpE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;oBACxB,YAAY,CAAC,MAAM,CAAC,CAAC;oBACrB,aAAa,EAAE,CAAC;oBAChB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,IAAI,CAAC;QACH,cAAc,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC1C,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/stt/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Wire types for Claude's speech-to-text stream.
+ *
+ * These mirror what the service actually sends. The endpoint is undocumented,
+ * so the shapes here are what we observed rather than a published contract —
+ * treat every field as possibly absent and never assume a message type we do
+ * not know about is an error.
+ */
+/** Audio the service expects: raw 16-bit PCM, 16 kHz, mono. */
+export declare const AUDIO_FORMAT: {
+    readonly encoding: "linear16";
+    readonly sampleRate: 16000;
+    readonly channels: 1;
+};
+/** Messages the service sends down the socket. */
+export declare enum TranscriptMessageType {
+    /** A partial guess that will still change. Show it, do not commit it. */
+    TranscriptInterim = "TranscriptInterim",
+    /** Improved text for the utterance in progress. Still not final. */
+    TranscriptText = "TranscriptText",
+    /** The speaker paused: whatever we have accumulated is now final. */
+    TranscriptEndpoint = "TranscriptEndpoint",
+    /** Transcription failed. `description` carries the reason. */
+    TranscriptError = "TranscriptError",
+    /** Generic server-side failure. `message` carries the reason. */
+    Error = "error"
+}
+export interface TranscriptMessage {
+    type: TranscriptMessageType | string;
+    /** Present on TranscriptInterim / TranscriptText. */
+    data?: string;
+    /** Present on TranscriptError. */
+    description?: string;
+    /** Present on error. */
+    message?: string;
+}
+export interface SpeechToTextOptions {
+    /** BCP-47 language code the speaker is using. Defaults to 'en'. */
+    language?: string;
+    /**
+     * Domain words to bias recognition toward — product names, jargon, anything
+     * a general model would mishear. A default set of programming terms is
+     * always included; these are added on top.
+     */
+    extraKeyterms?: string[];
+    /**
+     * Ask the service to also stream interim guesses. Off by default: interim
+     * text flickers and rewrites itself, which is fine for a live caption and
+     * distracting in a text field.
+     */
+    typedInterims?: boolean;
+}
+export interface SpeechToTextHandlers {
+    /**
+     * Called as text arrives. `isFinal` marks the end of an utterance: text with
+     * `isFinal: false` will be replaced by a later call, text with `true` is
+     * settled and should be appended.
+     */
+    onTranscript: (text: string, isFinal: boolean) => void;
+    /**
+     * Called when the stream fails. `fatal` means retrying will not help —
+     * typically a rejected token — as opposed to a dropped connection.
+     */
+    onError: (message: string, info?: {
+        fatal?: boolean;
+    }) => void;
+    /** Called once the socket is open and audio can be sent. */
+    onOpen?: () => void;
+}
+/** A live transcription stream. Feed it audio; close it when done speaking. */
+export interface SpeechToTextStream {
+    /** Send one chunk of raw PCM audio. Ignored once the stream is closing. */
+    sendAudio: (chunk: Uint8Array) => void;
+    /**
+     * Stop the stream, giving the service a moment to flush the last words.
+     * Resolves once the socket is closed.
+     */
+    close: () => Promise<void>;
+}

package/dist/stt/types.js

@@ -0,0 +1,29 @@
+/**
+ * Wire types for Claude's speech-to-text stream.
+ *
+ * These mirror what the service actually sends. The endpoint is undocumented,
+ * so the shapes here are what we observed rather than a published contract —
+ * treat every field as possibly absent and never assume a message type we do
+ * not know about is an error.
+ */
+/** Audio the service expects: raw 16-bit PCM, 16 kHz, mono. */
+export const AUDIO_FORMAT = {
+    encoding: 'linear16',
+    sampleRate: 16000,
+    channels: 1,
+};
+/** Messages the service sends down the socket. */
+export var TranscriptMessageType;
+(function (TranscriptMessageType) {
+    /** A partial guess that will still change. Show it, do not commit it. */
+    TranscriptMessageType["TranscriptInterim"] = "TranscriptInterim";
+    /** Improved text for the utterance in progress. Still not final. */
+    TranscriptMessageType["TranscriptText"] = "TranscriptText";
+    /** The speaker paused: whatever we have accumulated is now final. */
+    TranscriptMessageType["TranscriptEndpoint"] = "TranscriptEndpoint";
+    /** Transcription failed. `description` carries the reason. */
+    TranscriptMessageType["TranscriptError"] = "TranscriptError";
+    /** Generic server-side failure. `message` carries the reason. */
+    TranscriptMessageType["Error"] = "error";
+})(TranscriptMessageType || (TranscriptMessageType = {}));
+//# sourceMappingURL=types.js.map

package/dist/stt/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/stt/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,CAAC;CACH,CAAC;AAEX,kDAAkD;AAClD,MAAM,CAAN,IAAY,qBAWX;AAXD,WAAY,qBAAqB;IAC/B,yEAAyE;IACzE,gEAAuC,CAAA;IACvC,oEAAoE;IACpE,0DAAiC,CAAA;IACjC,qEAAqE;IACrE,kEAAyC,CAAA;IACzC,8DAA8D;IAC9D,4DAAmC,CAAA;IACnC,iEAAiE;IACjE,wCAAe,CAAA;AACjB,CAAC,EAXW,qBAAqB,KAArB,qBAAqB,QAWhC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@swttch/extend-kit",
-  "version": "0.3.0",
-  "description": "Companion tools for Swttch that live outside the plugin bundle: Claude Code account/usage SDK and the ccb CLI.",
+  "version": "0.5.0",
+  "description": "Companion tools for Swttch that live outside the plugin bundle: Claude Code account/usage SDK, the ccb CLI, and speech-to-text.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,6 +14,10 @@
       "types": "./dist/battery/index.d.ts",
       "default": "./dist/battery/index.js"
     },
+    "./stt": {
+      "types": "./dist/stt/index.d.ts",
+      "default": "./dist/stt/index.js"
+    },
     "./cli": "./dist/cli/index.js"
   },
   "bin": {
@@ -23,7 +27,7 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "lint": "tsc --noEmit",
-    "test": "node --test dist/**/*.test.js"
+    "test": "node --test \"dist/**/*.test.js\""
   },
   "keywords": [
     "claude",
@@ -52,6 +56,10 @@
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
+    "@types/ws": "^8.18.1",
     "typescript": "^6.0.2"
+  },
+  "dependencies": {
+    "ws": "^8.21.3"
   }
 }