@machina.ai/cell-cli-core 1.40.1-rc2 → 1.41.1-rc1

package/dist/src/voice/geminiLiveTranscriptionProvider.js.map

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

package/dist/src/voice/transcriptionFactory.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { TranscriptionProvider } from './transcriptionProvider.js';
+export declare class TranscriptionFactory {
+    static createProvider(voiceConfig: {
+        backend?: string;
+        whisperModel?: string;
+    } | undefined, apiKey: string): TranscriptionProvider;
+}

package/dist/src/voice/transcriptionFactory.js

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { homedir, CELL_DIR } from '../utils/paths.js';
+import { GeminiLiveTranscriptionProvider } from './geminiLiveTranscriptionProvider.js';
+import { WhisperTranscriptionProvider } from './whisperTranscriptionProvider.js';
+export class TranscriptionFactory {
+    static createProvider(voiceConfig, apiKey) {
+        const backend = voiceConfig?.backend ?? 'gemini-live';
+        if (backend === 'whisper') {
+            const modelsDir = path.join(homedir(), CELL_DIR, 'whisper_models');
+            if (!fs.existsSync(modelsDir)) {
+                fs.mkdirSync(modelsDir, { recursive: true });
+            }
+            const modelName = voiceConfig?.whisperModel ?? 'ggml-base.en.bin';
+            const modelPath = path.join(modelsDir, modelName);
+            return new WhisperTranscriptionProvider({
+                modelPath,
+                threads: 4,
+                step: 0,
+                length: 5000,
+            });
+        }
+        // Default to Gemini Live
+        return new GeminiLiveTranscriptionProvider(apiKey);
+    }
+}
+//# sourceMappingURL=transcriptionFactory.js.map

package/dist/src/voice/transcriptionFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptionFactory.js","sourceRoot":"","sources":["../../../src/voice/transcriptionFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAGjF,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAC,cAAc,CACnB,WAAoE,EACpE,MAAc;QAEd,MAAM,OAAO,GAAG,WAAW,EAAE,OAAO,IAAI,aAAa,CAAC;QAEtD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC;YAED,MAAM,SAAS,GAAG,WAAW,EAAE,YAAY,IAAI,kBAAkB,CAAC;YAClE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAElD,OAAO,IAAI,4BAA4B,CAAC;gBACtC,SAAS;gBACT,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,CAAC;gBACP,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;QACL,CAAC;QAED,yBAAyB;QACzB,OAAO,IAAI,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/src/voice/transcriptionProvider.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { EventEmitter } from 'node:events';
+export interface TranscriptionEvents {
+    /** Emitted when partial or full transcription text is available. */
+    transcription: [string];
+    /** Emitted when a speaking turn is considered complete. */
+    turnComplete: [];
+    /** Emitted when an error occurs during transcription. */
+    error: [Error];
+    /** Emitted when the transcription service connection is closed. */
+    close: [];
+}
+/**
+ * Common interface for all transcription backends (Cloud or Local).
+ */
+export interface TranscriptionProvider extends EventEmitter<TranscriptionEvents> {
+    /** Establish connection to the transcription service. */
+    connect(): Promise<void>;
+    /** Send a chunk of raw audio data to the service. */
+    sendAudioChunk(chunk: Buffer): void;
+    /** Disconnect from the transcription service. */
+    disconnect(): void;
+    /** Get the current full transcription for the session. */
+    getTranscription(): string;
+}

package/dist/src/voice/transcriptionProvider.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=transcriptionProvider.js.map

package/dist/src/voice/transcriptionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptionProvider.js","sourceRoot":"","sources":["../../../src/voice/transcriptionProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/voice/whisperModelManager.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventEmitter } from 'node:events';
+export interface WhisperModelProgress {
+    modelName: string;
+    transferred: number;
+    total: number;
+    percentage: number;
+}
+export interface WhisperModelManagerEvents {
+    progress: [WhisperModelProgress];
+}
+/**
+ * Manages Whisper models (checking existence, downloading).
+ */
+export declare class WhisperModelManager extends EventEmitter<WhisperModelManagerEvents> {
+    private readonly modelsDir;
+    constructor();
+    isModelInstalled(modelName: string): boolean;
+    getModelPath(modelName: string): string;
+    downloadModel(modelName: string): Promise<void>;
+    private validateModelName;
+}

package/dist/src/voice/whisperModelManager.js

@@ -0,0 +1,79 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { EventEmitter } from 'node:events';
+import { homedir, CELL_DIR } from '../utils/paths.js';
+import { debugLogger } from '../utils/debugLogger.js';
+const ALLOWED_MODELS = [
+    'ggml-tiny.en.bin',
+    'ggml-base.en.bin',
+    'ggml-large-v3-turbo-q5_0.bin',
+    'ggml-large-v3-turbo-q8_0.bin',
+];
+/**
+ * Manages Whisper models (checking existence, downloading).
+ */
+export class WhisperModelManager extends EventEmitter {
+    modelsDir;
+    constructor() {
+        super();
+        this.modelsDir = path.join(homedir(), CELL_DIR, 'whisper_models');
+    }
+    isModelInstalled(modelName) {
+        this.validateModelName(modelName);
+        return fs.existsSync(path.join(this.modelsDir, modelName));
+    }
+    getModelPath(modelName) {
+        this.validateModelName(modelName);
+        return path.join(this.modelsDir, modelName);
+    }
+    async downloadModel(modelName) {
+        this.validateModelName(modelName);
+        if (!fs.existsSync(this.modelsDir)) {
+            fs.mkdirSync(this.modelsDir, { recursive: true });
+        }
+        const destination = path.join(this.modelsDir, modelName);
+        const url = `https://huggingface.co/ggerganov/whisper.cpp/resolve/main/${modelName}`;
+        debugLogger.debug(`[WhisperModelManager] Downloading ${modelName} from ${url}`);
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to download model: ${response.statusText}`);
+        }
+        const total = parseInt(response.headers.get('content-length') || '0', 10);
+        let transferred = 0;
+        const reader = response.body?.getReader();
+        if (!reader) {
+            throw new Error('Response body is not readable');
+        }
+        const writer = fs.createWriteStream(destination);
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                transferred += value.length;
+                writer.write(value);
+                const percentage = total > 0 ? transferred / total : 0;
+                this.emit('progress', {
+                    modelName,
+                    transferred,
+                    total,
+                    percentage,
+                });
+            }
+        }
+        finally {
+            writer.end();
+        }
+    }
+    validateModelName(modelName) {
+        if (!ALLOWED_MODELS.includes(modelName)) {
+            throw new Error(`Unauthorized model name: ${modelName}`);
+        }
+    }
+}
+//# sourceMappingURL=whisperModelManager.js.map

package/dist/src/voice/whisperModelManager.js.map

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

package/dist/src/voice/whisperTranscriptionProvider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventEmitter } from 'node:events';
+import type { TranscriptionProvider, TranscriptionEvents } from './transcriptionProvider.js';
+export interface WhisperProviderOptions {
+    modelPath: string;
+    threads?: number;
+    step?: number;
+    length?: number;
+}
+/**
+ * Local transcription provider using `whisper-stream` from whisper.cpp.
+ *
+ * Uses the Sliding Window Mode with VAD (--step 0) for stable,
+ * non-overlapping transcription blocks that can be appended directly.
+ */
+export declare class WhisperTranscriptionProvider extends EventEmitter<TranscriptionEvents> implements TranscriptionProvider {
+    private readonly options;
+    private process;
+    private currentTranscription;
+    constructor(options: WhisperProviderOptions);
+    /**
+     * Checks if `whisper-stream` is available on the system.
+     */
+    static isAvailable(): Promise<boolean>;
+    connect(): Promise<void>;
+    private parseOutput;
+    sendAudioChunk(_chunk: Buffer): void;
+    getTranscription(): string;
+    disconnect(): void;
+}

package/dist/src/voice/whisperTranscriptionProvider.js

@@ -0,0 +1,151 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { spawn } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import commandExists from 'command-exists';
+import { debugLogger } from '../utils/debugLogger.js';
+/**
+ * Local transcription provider using `whisper-stream` from whisper.cpp.
+ *
+ * Uses the Sliding Window Mode with VAD (--step 0) for stable,
+ * non-overlapping transcription blocks that can be appended directly.
+ */
+export class WhisperTranscriptionProvider extends EventEmitter {
+    options;
+    process = null;
+    currentTranscription = '';
+    constructor(options) {
+        super();
+        this.options = options;
+    }
+    /**
+     * Checks if `whisper-stream` is available on the system.
+     */
+    static async isAvailable() {
+        try {
+            await commandExists('whisper-stream');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async connect() {
+        const { modelPath, threads = 4, step = 0, length = 5000 } = this.options;
+        this.currentTranscription = '';
+        const available = await WhisperTranscriptionProvider.isAvailable();
+        if (!available) {
+            return Promise.reject(new Error('The `whisper-stream` command is required for local voice mode. Please install it (e.g., `brew install whisper-cpp` on macOS).'));
+        }
+        debugLogger.debug(`[WhisperTranscription] Starting whisper-stream with model: ${modelPath} (VAD mode: step=${step}, length=${length})`);
+        return new Promise((resolve, reject) => {
+            let isResolved = false;
+            try {
+                // whisper-stream -m <model_path> -t <threads> --step 0 --length <length> -vth 0.6
+                // Setting step == 0 enables sliding window mode with VAD, which outputs
+                // non-overlapping transcription blocks suitable for appending.
+                this.process = spawn('whisper-stream', [
+                    '-m',
+                    modelPath,
+                    '-t',
+                    threads.toString(),
+                    '--step',
+                    step.toString(),
+                    '--length',
+                    length.toString(),
+                    '-vth',
+                    '0.6',
+                ]);
+                this.process.stdout.on('data', (data) => {
+                    const output = data.toString();
+                    this.parseOutput(output);
+                });
+                this.process.stderr.on('data', (data) => {
+                    const msg = data.toString();
+                    if (msg.includes('error')) {
+                        debugLogger.error(`[WhisperTranscription] stderr: ${msg}`);
+                        if (!isResolved) {
+                            isResolved = true;
+                            reject(new Error(msg));
+                        }
+                    }
+                    // whisper-stream prints "whisper_init_from_file_with_params_no_state: loading model from..."
+                    // and finally "main: processing, press Ctrl+C to stop" when ready.
+                    if (!isResolved && msg.includes('main: processing')) {
+                        debugLogger.debug('[WhisperTranscription] whisper-stream is ready');
+                        isResolved = true;
+                        resolve();
+                    }
+                });
+                this.process.on('error', (err) => {
+                    debugLogger.error('[WhisperTranscription] Process error:', err);
+                    this.emit('error', err);
+                    if (!isResolved) {
+                        isResolved = true;
+                        reject(err);
+                    }
+                });
+                this.process.on('close', (code) => {
+                    debugLogger.debug(`[WhisperTranscription] Process closed with code ${code}`);
+                    this.emit('close');
+                    this.process = null;
+                });
+                // Fallback timeout in case "main: processing" is never seen
+                setTimeout(() => {
+                    if (!isResolved) {
+                        debugLogger.warn('[WhisperTranscription] Connection timeout (fallback resolve)');
+                        isResolved = true;
+                        resolve();
+                    }
+                }, 10000);
+            }
+            catch (err) {
+                debugLogger.error('[WhisperTranscription] Failed to spawn process:', err);
+                if (!isResolved) {
+                    isResolved = true;
+                    reject(err);
+                }
+            }
+        });
+    }
+    parseOutput(output) {
+        // whisper-stream output format: "[00:00:00.000 --> 00:00:02.000]   Hello world."
+        const lines = output.split('\n');
+        for (const line of lines) {
+            const match = line.match(/\[.* --> .*\]\s+(.*)/);
+            if (match && match[1]) {
+                let text = match[1].trim();
+                // Filter out [Silence], [music], (laughter), etc.
+                text = text
+                    .replace(/\[[^\]]*\]/g, '')
+                    .replace(/\([^)]*\)/g, '')
+                    .trim();
+                if (text) {
+                    // In VAD mode (step=0), each line is a completed speech block.
+                    // Append it to the buffer to ensure it doesn't disappear.
+                    this.currentTranscription = this.currentTranscription
+                        ? `${this.currentTranscription} ${text}`
+                        : text;
+                    debugLogger.debug(`[WhisperTranscription] Transcription updated (Local-VAD): "${this.currentTranscription}"`);
+                    this.emit('transcription', this.currentTranscription);
+                }
+            }
+        }
+    }
+    sendAudioChunk(_chunk) {
+        // whisper-stream handles its own audio capture.
+    }
+    getTranscription() {
+        return this.currentTranscription;
+    }
+    disconnect() {
+        if (this.process) {
+            this.process.kill('SIGTERM');
+            this.process = null;
+        }
+    }
+}
+//# sourceMappingURL=whisperTranscriptionProvider.js.map

package/dist/src/voice/whisperTranscriptionProvider.js.map

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

package/dist/src/voice/whisperTranscriptionProvider.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/voice/whisperTranscriptionProvider.test.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { WhisperTranscriptionProvider } from './whisperTranscriptionProvider.js';
+import commandExists from 'command-exists';
+vi.mock('command-exists', () => ({
+    default: vi.fn(),
+}));
+describe('WhisperTranscriptionProvider', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should throw a friendly error if whisper-stream is not available', async () => {
+        vi.mocked(commandExists).mockRejectedValue(new Error('not found'));
+        const provider = new WhisperTranscriptionProvider({
+            modelPath: 'test-model.bin',
+        });
+        await expect(provider.connect()).rejects.toThrow('The `whisper-stream` command is required for local voice mode. Please install it (e.g., `brew install whisper-cpp` on macOS).');
+    });
+});
+//# sourceMappingURL=whisperTranscriptionProvider.test.js.map

package/dist/src/voice/whisperTranscriptionProvider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisperTranscriptionProvider.test.js","sourceRoot":"","sources":["../../../src/voice/whisperTranscriptionProvider.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAE3C,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;CACjB,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAEnE,MAAM,QAAQ,GAAG,IAAI,4BAA4B,CAAC;YAChD,SAAS,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAC9C,+HAA+H,CAChI,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}