npm - @swttch/extend-kit - Versions diffs - 0.6.1 → 0.7.0 - Mend

@swttch/extend-kit 0.6.1 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/cli/index.js CHANGED Viewed

@@ -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 { sttCommand } from './stt.js';
 import { getAccountCredentials } from './account-credentials.js';
 import { CcbError } from '../battery/errors.js';
 import { readFileSync } from 'node:fs';
@@ -23,7 +24,10 @@ async function createClient() {
 async function run() {
     const [module, ...subcommand] = command;
     if (flags.has('--capabilities')) {
-        console.log(JSON.stringify({ capabilities: ['oauth.usage.account-file'] }));
+        // A caller checks this before using a command: the plugin has to know
+        // whether the kit on this machine is new enough to stream dictation, since
+        // the only alternative it once had (importing the module) is gone.
+        console.log(JSON.stringify({ capabilities: ['oauth.usage.account-file', 'stt.stream'] }));
         return;
     }
     if (args.some(arg => arg.startsWith('--account-file')) && (!accountFile || module !== 'oauth' || subcommand[0] !== 'usage')) {
@@ -41,13 +45,32 @@ Usage: ccb <command> [options]
 Commands:
   oauth usage      Show usage limits
   oauth profile    Show account profile
+  stt              Transcribe raw PCM audio from stdin (see below)
+  stt --check      Report whether this machine can dictate
 Options:
   --account-file=<path>  Read usage for a CCG saved-account snapshot (no account switch)
+  --language=<code>      BCP-47 language for stt (default: en)
+  --keyterms=<a,b,c>     Extra vocabulary to bias stt toward
+  --interims             Also emit interim stt guesses
   --capabilities   Output supported CLI capabilities as JSON
   --json           Output as JSON
   -h, --help       Show help
-  -v, --version    Show version`);
+  -v, --version    Show version
+stt reads raw PCM on stdin (16-bit LE, 16 kHz, mono) and writes one JSON
+object per line to stdout. Any other audio format transcribes to silence.
+  ffmpeg -f avfoundation -i ':0' -ar 16000 -ac 1 -f s16le - | ccb stt`);
+        return;
+    }
+    // Handled before createClient(): stt reads the login inside the stream, and
+    // building a client up front would turn "not signed in" into a crash before
+    // `stt --check` could answer it calmly.
+    if (module === 'stt') {
+        const code = await sttCommand(subcommand, args, flags, jsonOutput);
+        if (code !== 0)
+            process.exit(code);
         return;
     }
     const client = await createClient();

package/dist/cli/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACxF,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACrE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACvC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAEzG,KAAK,UAAU,YAAY;IACzB,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,cAAc,EAAE,CAAC;IACpG,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC1C,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC;IAExC,IAAI,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,CAAC;~~QAC5E~~,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,KAAK,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,EAAE,CAAC;QAC5H,MAAM,IAAI,QAAQ,CAAC,iDAAiD,EAAE,kBAAkB,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO~~;;;;;;;;;;;;;gCAaC~~,CAAC,CAAC;~~QAC9B~~,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;IAEpC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,MAAM,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;YACnD,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC3B,KAAK,EAAE;oBACL,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D;aACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACvC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/stt.d.ts ADDED Viewed

@@ -0,0 +1,38 @@
+/**
+ * `ccb stt` — dictation as a process, not as a library.
+ *
+ * The plugin cannot call {@link openSpeechToTextStream} directly. Transcribing
+ * reads the machine's Claude Code login, and importing this package into the
+ * backend would put that read inside the plugin's own process — the exact thing
+ * that moved these tools out to a separate package. Spawning instead keeps the
+ * token on this side of the process boundary: the caller writes audio and reads
+ * text, and never holds a credential.
+ *
+ * So the wire format here is the public contract, the same way `oauth usage
+ * --json` is. A terminal user can drive it by hand:
+ *
+ *   ffmpeg -f avfoundation -i ':0' -ar 16000 -ac 1 -f s16le - | ccb stt
+ *
+ * ── stdin ──  raw PCM: 16-bit little-endian, 16 kHz, mono. Nothing else is
+ *              accepted, and a wrong format transcribes to silence rather than
+ *              failing (see CLAUDE.md), so the caller must convert first.
+ * ── stdout ── one JSON object per line, flushed as it happens.
+ * ── exit ───  0 when the speaker finished, 1 when the stream failed to open.
+ */
+/** Line-oriented events written to stdout. */
+export declare enum SttEventType {
+    /** The socket is open and audio is being transcribed. */
+    Open = "open",
+    /** Text arrived. `isFinal` false will be replaced by a later line. */
+    Transcript = "transcript",
+    /** The stream failed. `fatal` means retrying will not help. */
+    Error = "error"
+}
+/**
+ * Entry point for the `stt` module of the CLI.
+ *
+ * Takes no {@link ClaudeCodeClient}: unlike `oauth`, this command reads the
+ * login itself inside the stream, and building a client up front would turn
+ * "not signed in" into a crash before `--check` could answer it.
+ */
+export declare function sttCommand(subcommand: string[], args: string[], flags: Set<string>, jsonOutput: boolean): Promise<number>;

package/dist/cli/stt.js ADDED Viewed

@@ -0,0 +1,154 @@
+import { openSpeechToTextStream, isSpeechToTextAvailable } from '../stt/index.js';
+import { CcbError } from '../battery/errors.js';
+/**
+ * `ccb stt` — dictation as a process, not as a library.
+ *
+ * The plugin cannot call {@link openSpeechToTextStream} directly. Transcribing
+ * reads the machine's Claude Code login, and importing this package into the
+ * backend would put that read inside the plugin's own process — the exact thing
+ * that moved these tools out to a separate package. Spawning instead keeps the
+ * token on this side of the process boundary: the caller writes audio and reads
+ * text, and never holds a credential.
+ *
+ * So the wire format here is the public contract, the same way `oauth usage
+ * --json` is. A terminal user can drive it by hand:
+ *
+ *   ffmpeg -f avfoundation -i ':0' -ar 16000 -ac 1 -f s16le - | ccb stt
+ *
+ * ── stdin ──  raw PCM: 16-bit little-endian, 16 kHz, mono. Nothing else is
+ *              accepted, and a wrong format transcribes to silence rather than
+ *              failing (see CLAUDE.md), so the caller must convert first.
+ * ── stdout ── one JSON object per line, flushed as it happens.
+ * ── exit ───  0 when the speaker finished, 1 when the stream failed to open.
+ */
+/** Line-oriented events written to stdout. */
+export var SttEventType;
+(function (SttEventType) {
+    /** The socket is open and audio is being transcribed. */
+    SttEventType["Open"] = "open";
+    /** Text arrived. `isFinal` false will be replaced by a later line. */
+    SttEventType["Transcript"] = "transcript";
+    /** The stream failed. `fatal` means retrying will not help. */
+    SttEventType["Error"] = "error";
+})(SttEventType || (SttEventType = {}));
+/**
+ * Write one event as a single line.
+ *
+ * `process.stdout.write` rather than `console.log` because the caller parses
+ * this by newline: console.log is the same thing here, but going through the
+ * stream directly makes it explicit that one call must produce exactly one line
+ * and that nothing else may ever be printed to stdout by this command.
+ */
+function emit(event) {
+    process.stdout.write(`${JSON.stringify(event)}\n`);
+}
+/** Split a `--keyterms=a,b,c` value, dropping empties and surrounding spaces. */
+function parseKeyterms(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(',')
+        .map((term) => term.trim())
+        .filter(Boolean);
+}
+/**
+ * `ccb stt --check --json` — can this machine dictate at all?
+ *
+ * Separate from opening a stream because the answer drives different UI: a
+ * machine with no Claude Code login should be told to sign in, not shown a
+ * socket error. Always exits 0; "no" is an answer rather than a failure.
+ */
+async function checkAvailability(jsonOutput) {
+    const available = await isSpeechToTextAvailable().catch(() => false);
+    if (jsonOutput) {
+        console.log(JSON.stringify({ available }));
+        return;
+    }
+    console.log(available ? 'available' : 'unavailable (no Claude Code login on this machine)');
+}
+/**
+ * Open the stream and pump stdin into it until the caller stops writing.
+ *
+ * Audio written before the socket finishes opening is not lost: the stream
+ * buffers pre-open chunks itself, which matters more here than in-process
+ * because a pipe delivers the caller's first chunk almost immediately.
+ */
+async function runStream(options) {
+    if (process.stdin.isTTY) {
+        console.error('ccb stt reads raw PCM audio (16-bit LE, 16 kHz, mono) on stdin; pipe audio into it.');
+        return 1;
+    }
+    let stream;
+    try {
+        stream = await openSpeechToTextStream({
+            onTranscript: (text, isFinal) => emit({ type: SttEventType.Transcript, text, isFinal }),
+            onError: (message, info) => emit({ type: SttEventType.Error, message, fatal: info?.fatal ?? false }),
+            onOpen: () => emit({ type: SttEventType.Open }),
+        }, {
+            language: options.language,
+            extraKeyterms: options.extraKeyterms,
+            typedInterims: options.typedInterims,
+        });
+    }
+    catch (err) {
+        // Failing to open is reported on the same channel as everything else, so a
+        // caller parsing stdout never has to also watch stderr to learn why
+        // dictation did not start. A rejected login lands here.
+        emit({
+            type: SttEventType.Error,
+            message: err instanceof Error ? err.message : String(err),
+            fatal: true,
+        });
+        return 1;
+    }
+    return new Promise((resolve) => {
+        let finished = false;
+        /**
+         * Close once, then exit.
+         *
+         * `close()` waits for the service to flush the last words, so the trailing
+         * transcript is emitted before this resolves. Called from both stdin end
+         * and a termination signal, hence the guard.
+         */
+        const finish = () => {
+            if (finished)
+                return;
+            finished = true;
+            stream
+                .close()
+                .then(() => resolve(0))
+                .catch(() => resolve(0));
+        };
+        process.stdin.on('data', (chunk) => {
+            stream.sendAudio(new Uint8Array(chunk));
+        });
+        process.stdin.on('end', finish);
+        // A parent that kills us instead of closing stdin still gets the last words.
+        process.on('SIGTERM', finish);
+        process.on('SIGINT', finish);
+    });
+}
+/**
+ * Entry point for the `stt` module of the CLI.
+ *
+ * Takes no {@link ClaudeCodeClient}: unlike `oauth`, this command reads the
+ * login itself inside the stream, and building a client up front would turn
+ * "not signed in" into a crash before `--check` could answer it.
+ */
+export async function sttCommand(subcommand, args, flags, jsonOutput) {
+    if (flags.has('--check') || subcommand[0] === 'check') {
+        await checkAvailability(jsonOutput);
+        return 0;
+    }
+    if (subcommand.length > 0) {
+        throw new CcbError(`Unknown stt subcommand: ${subcommand[0]}`, 'invalid_argument');
+    }
+    const language = args.find((arg) => arg.startsWith('--language='))?.slice('--language='.length);
+    const keyterms = args.find((arg) => arg.startsWith('--keyterms='))?.slice('--keyterms='.length);
+    return runStream({
+        language,
+        extraKeyterms: parseKeyterms(keyterms),
+        typedInterims: flags.has('--interims'),
+    });
+}
+//# sourceMappingURL=stt.js.map

package/dist/cli/stt.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@swttch/extend-kit",
-  "version": "0.6.1",
+  "version": "0.7.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",