@vibesdotdev/integrations-faster-whisper 0.0.0-stage → 1.0.0-rc.1

package/dist/ai/providers/faster-whisper/faster-whisper.provider.impl.js

@@ -0,0 +1,140 @@
+/**
+ * Faster Whisper Provider Type Implementation
+ *
+ * Provider type implementation for Faster Whisper.
+ * Provides helper methods for working with Faster Whisper instances.
+ */
+import { getVibesAIClient } from '@vibesdotdev/ai/client';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { transcriptionRequestSchema } from "../../../schemas/transcription.js";
+import { healthOptionsSchema } from "../../../schemas/probe.js";
+import { fasterWhisperConnectionSchema } from "../local/speech/faster-whisper/config/schemas/index.js";
+import { probePython } from "./python-probe.js";
+export class FasterWhisperProviderType {
+    descriptor;
+    context;
+    constructor(descriptor, context) {
+        this.descriptor = descriptor;
+        this.context = context;
+    }
+    /**
+     * Generate using this provider (delegates to ai/generation)
+     */
+    async generate(providerInstance, model, request, options) {
+        const parsed = transcriptionRequestSchema.safeParse(request);
+        if (!parsed.success)
+            throw new CapabilityError('Invalid transcription request.', 'INVALID_INPUT', { reason: 'invalid-transcription-request' });
+        const ai = await getVibesAIClient(this.context.runtime);
+        const response = await ai.transcribe({ ...parsed.data, provider: providerInstance, model, providerId: providerInstance.id, modelId: model.id }, {
+            ...options,
+            timeoutMs: options?.timeoutMs,
+            workspacePath: options?.workspacePath,
+            executionPolicy: options?.executionPolicy
+        });
+        // SAFETY: the owning schema proved transcription above; T is the validated modality.
+        return { response, adapterId: 'faster-whisper-cli', generationMethod: 'spec-transport' };
+    }
+    /**
+     * Detect installed Faster Whisper instances
+     * Checks whether the canonical python3 runtime can import faster_whisper
+     */
+    async detectInstalled() {
+        if (!(await probePython(this.context.runtime)))
+            return [];
+        return [
+            {
+                name: 'Faster Whisper (Local Python)',
+                config: fasterWhisperConnectionSchema.parse({}),
+                source: 'system'
+            }
+        ];
+    }
+    /**
+     * Recommend models for a use case
+     */
+    async recommendModels(useCase, _context) {
+        const recommendations = [];
+        // Only recommend for transcription use cases
+        if (useCase === 'audio' || useCase === 'transcription') {
+            recommendations.push({
+                modelId: 'base',
+                modelName: 'Whisper Base',
+                score: 75,
+                reason: 'Fastest model with acceptable accuracy for general transcription',
+                capabilities: ['transcription'],
+                useCaseFit: 75
+            }, {
+                modelId: 'small',
+                modelName: 'Whisper Small',
+                score: 80,
+                reason: 'Good balance of speed and accuracy',
+                capabilities: ['transcription'],
+                useCaseFit: 80
+            }, {
+                modelId: 'medium',
+                modelName: 'Whisper Medium',
+                score: 90,
+                reason: 'High accuracy with GPU acceleration',
+                capabilities: ['transcription'],
+                useCaseFit: 90
+            }, {
+                modelId: 'large-v2',
+                modelName: 'Whisper Large V2',
+                score: 95,
+                reason: 'Best accuracy for critical transcription, 4x faster than standard Whisper',
+                capabilities: ['transcription'],
+                useCaseFit: 95
+            }, {
+                modelId: 'large-v3',
+                modelName: 'Whisper Large V3',
+                score: 98,
+                reason: 'Latest model with improved accuracy and multilingual support',
+                capabilities: ['transcription'],
+                useCaseFit: 98
+            });
+        }
+        return recommendations.sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Check health of a Faster Whisper instance
+     */
+    async checkHealth(instanceConfig, options) {
+        const startTime = Date.now();
+        try {
+            const configuration = fasterWhisperConnectionSchema.parse(instanceConfig);
+            const healthOptions = healthOptionsSchema.parse(options ?? {});
+            const available = await probePython(this.context.runtime, {
+                ...configuration, timeout: healthOptions.timeout ?? configuration.timeout
+            });
+            return {
+                healthy: available,
+                latencyMs: Date.now() - startTime,
+                message: available ? 'Faster Whisper is available.' : 'The Python package is not installed.',
+                availableModalities: available ? ['transcription'] : undefined,
+                error: available ? undefined : { code: 'PYTHON_PACKAGE_NOT_FOUND', message: 'The configured Python confirmed package absence.' },
+                checkedAt: new Date()
+            };
+        }
+        catch (error) {
+            const failure = CaughtFailureSchema.parse(error);
+            const probeError = { code: 'PYTHON_PROBE_ERROR', message: failure instanceof Error ? failure.message : String(failure), cause: error };
+            return {
+                healthy: false, latencyMs: Date.now() - startTime,
+                message: 'Failed to probe the Faster Whisper Python runtime',
+                error: probeError,
+                checkedAt: new Date()
+            };
+        }
+    }
+    async validateConnection(config) {
+        const result = fasterWhisperConnectionSchema.safeParse(config);
+        if (!result.success)
+            return { valid: false, errors: result.error.issues.map(issue => issue.message) };
+        return {
+            valid: true,
+            warnings: result.data.timeout < 5000 ? ['Timeout is very short - transcription may fail for longer audio files'] : undefined
+        };
+    }
+    async dispose() { }
+}
+//# sourceMappingURL=faster-whisper.provider.impl.js.map

package/dist/ai/providers/faster-whisper/faster-whisper.provider.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faster-whisper.provider.impl.js","sourceRoot":"","sources":["../../../../src/ai/providers/faster-whisper/faster-whisper.provider.impl.ts"],"names":[],"mappings":"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"}

package/dist/ai/providers/faster-whisper/index.d.ts

@@ -0,0 +1,2 @@
+export { FasterWhisperProviderType } from './faster-whisper.provider.impl.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/providers/faster-whisper/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/faster-whisper/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/ai/providers/faster-whisper/index.js

@@ -0,0 +1,2 @@
+export { FasterWhisperProviderType } from "./faster-whisper.provider.impl.js";
+//# sourceMappingURL=index.js.map

package/dist/ai/providers/faster-whisper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai/providers/faster-whisper/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/ai/providers/faster-whisper/python-probe.d.ts

@@ -0,0 +1,5 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type FasterWhisperConnection } from '../local/speech/faster-whisper/config/schemas/index.ts';
+/** Only an explicit missing-package response counts as absence. Transport failures propagate. */
+export declare function probePython(runtime: RuntimeRef, configuration?: FasterWhisperConnection): Promise<boolean>;
+//# sourceMappingURL=python-probe.d.ts.map

package/dist/ai/providers/faster-whisper/python-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-probe.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/faster-whisper/python-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAiC,KAAK,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AAGrI,iGAAiG;AACjG,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,GAAE,uBAAiE,oBAyBtI"}

package/dist/ai/providers/faster-whisper/python-probe.js

@@ -0,0 +1,35 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { fasterWhisperConnectionSchema } from "../local/speech/faster-whisper/config/schemas/index.js";
+import { pythonAvailabilitySchema } from "../../../schemas/probe.js";
+/** Only an explicit missing-package response counts as absence. Transport failures propagate. */
+export async function probePython(runtime, configuration = fasterWhisperConnectionSchema.parse({})) {
+    const transport = await runtime.query('ai/transport').withId('process').select();
+    if (!transport)
+        throw new CapabilityError('Process transport is unavailable.', 'UNAVAILABLE', { reason: 'process-transport-unavailable' });
+    return runtime.lifecycle.wait(async (signal) => {
+        let stdout = '';
+        const decoder = new TextDecoder();
+        for await (const chunk of transport.impl.send({
+            method: 'POST', path: '', headers: {}, streaming: false,
+            body: { args: ['-c', [
+                        'import importlib.util',
+                        'if importlib.util.find_spec("faster_whisper") is None:',
+                        '    print("missing")',
+                        'else:',
+                        '    from faster_whisper import WhisperModel',
+                        '    print("available")'
+                    ].join('\n')] }
+        }, { runtime, endpointBase: configuration.pythonExecutable, timeoutMs: configuration.timeout, signal, framing: 'none' })) {
+            if (chunk.kind === 'error')
+                throw chunk.error;
+            if (chunk.kind === 'bytes')
+                stdout += decoder.decode(chunk.data, { stream: true });
+        }
+        stdout += decoder.decode();
+        const result = pythonAvailabilitySchema.safeParse(stdout.trim());
+        if (!result.success)
+            throw new CapabilityError('Python probe returned an invalid response.', 'INVALID_INPUT', { reason: 'malformed-probe-output' });
+        return result.data === 'available';
+    }, { timeoutMs: configuration.timeout, reason: 'faster-whisper availability' });
+}
+//# sourceMappingURL=python-probe.js.map

package/dist/ai/providers/faster-whisper/python-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-probe.js","sourceRoot":"","sources":["../../../../src/ai/providers/faster-whisper/python-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,6BAA6B,EAAgC,MAAM,wDAAwD,CAAC;AACrI,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAmB,EAAE,gBAAyC,6BAA6B,CAAC,KAAK,CAAC,EAAE,CAAC;IACtI,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,KAAK,CAA8C,cAAc,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9H,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,eAAe,CAAC,mCAAmC,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC,CAAC;IAC3I,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAC,MAAM,EAAC,EAAE;QAC5C,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK;YACvD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE;wBACpB,uBAAuB;wBACvB,wDAAwD;wBACxD,sBAAsB;wBACtB,OAAO;wBACP,6CAA6C;wBAC7C,wBAAwB;qBACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE;SACf,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,gBAAgB,EAAE,SAAS,EAAE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAC1H,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;gBAAE,MAAM,KAAK,CAAC,KAAK,CAAC;YAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;gBAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,4CAA4C,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACpJ,OAAO,MAAM,CAAC,IAAI,KAAK,WAAW,CAAC;IACpC,CAAC,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/ai/providers/faster-whisper/recommendations.d.ts

@@ -0,0 +1,21 @@
+import { ProviderRecommendation, type ModelAdapter } from '@vibesdotdev/ai/recommendations/base';
+import type { ModelRecommendation, RecommendationContext, SetupMethod, SetupStep, UseCase } from '@vibesdotdev/ai/recommendations/schemas';
+export declare class FasterWhisperRecommendation extends ProviderRecommendation {
+    readonly providerType = "faster-whisper";
+    readonly displayName = "Faster Whisper";
+    getUseCaseScore(useCase: UseCase): number;
+    getReason(): string;
+    getStrengths(): string[];
+    getWeaknesses(): string[];
+    getSupportedSetupMethods(): SetupMethod[];
+    getSetupSteps(_method: SetupMethod): Promise<SetupStep[]>;
+    recommendModels(_adapter: ModelAdapter | null, _context: RecommendationContext): Promise<ModelRecommendation[]>;
+    getExecutionContext(): {
+        recommendModels: "client";
+        getSetupSteps: "client";
+    };
+    supportsLocal(): boolean;
+    requiresGPU(): boolean;
+}
+export default FasterWhisperRecommendation;
+//# sourceMappingURL=recommendations.d.ts.map

package/dist/ai/providers/faster-whisper/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/faster-whisper/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACjG,OAAO,KAAK,EACX,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,SAAS,EACT,OAAO,EACP,MAAM,yCAAyC,CAAC;AAEjD,qBAAa,2BAA4B,SAAQ,sBAAsB;IACtE,QAAQ,CAAC,YAAY,oBAAoB;IACzC,QAAQ,CAAC,WAAW,oBAAoB;IACxC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAGzC,SAAS,IAAI,MAAM;IAGnB,YAAY,IAAI,MAAM,EAAE;IAGxB,aAAa,IAAI,MAAM,EAAE;IAGzB,wBAAwB,IAAI,WAAW,EAAE;IAGnC,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IASzD,eAAe,CACpB,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,QAAQ,EAAE,qBAAqB,GAC7B,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAcjC,mBAAmB;;;;IAGnB,aAAa,IAAI,OAAO;IAGxB,WAAW,IAAI,OAAO;CAGtB;AAED,eAAe,2BAA2B,CAAC"}

package/dist/ai/providers/faster-whisper/recommendations.js

@@ -0,0 +1,54 @@
+import { ProviderRecommendation } from '@vibesdotdev/ai/recommendations/base';
+export class FasterWhisperRecommendation extends ProviderRecommendation {
+    providerType = 'faster-whisper';
+    displayName = 'Faster Whisper';
+    getUseCaseScore(useCase) {
+        return useCase === 'audio' ? 98 : 0;
+    }
+    getReason() {
+        return 'Fast private transcription through the local faster-whisper Python runtime';
+    }
+    getStrengths() {
+        return ['Offline transcription', 'Word timestamps and VAD', 'CPU and GPU execution'];
+    }
+    getWeaknesses() {
+        return ['Requires Python and the faster-whisper package'];
+    }
+    getSupportedSetupMethods() {
+        return ['local_scan'];
+    }
+    async getSetupSteps(_method) {
+        return [
+            {
+                step: 'Install Faster Whisper',
+                description: 'Requires Python and the faster-whisper package.',
+                action: 'https://github.com/SYSTRAN/faster-whisper'
+            }
+        ];
+    }
+    async recommendModels(_adapter, _context) {
+        return [
+            {
+                modelId: 'large-v3',
+                modelName: 'Whisper Large V3',
+                score: 98,
+                reason: 'Fast private transcription through the local faster-whisper Python runtime',
+                capabilities: ['transcription'],
+                isAvailable: true,
+                requiresUpgrade: false,
+                useCaseFit: 98
+            }
+        ];
+    }
+    getExecutionContext() {
+        return { recommendModels: 'client', getSetupSteps: 'client' };
+    }
+    supportsLocal() {
+        return true;
+    }
+    requiresGPU() {
+        return false;
+    }
+}
+export default FasterWhisperRecommendation;
+//# sourceMappingURL=recommendations.js.map

package/dist/ai/providers/faster-whisper/recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.js","sourceRoot":"","sources":["../../../../src/ai/providers/faster-whisper/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAqB,MAAM,sCAAsC,CAAC;AASjG,MAAM,OAAO,2BAA4B,SAAQ,sBAAsB;IAC7D,YAAY,GAAG,gBAAgB,CAAC;IAChC,WAAW,GAAG,gBAAgB,CAAC;IACxC,eAAe,CAAC,OAAgB;QAC/B,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,SAAS;QACR,OAAO,4EAA4E,CAAC;IACrF,CAAC;IACD,YAAY;QACX,OAAO,CAAC,uBAAuB,EAAE,yBAAyB,EAAE,uBAAuB,CAAC,CAAC;IACtF,CAAC;IACD,aAAa;QACZ,OAAO,CAAC,gDAAgD,CAAC,CAAC;IAC3D,CAAC;IACD,wBAAwB;QACvB,OAAO,CAAC,YAAY,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,OAAoB;QACvC,OAAO;YACN;gBACC,IAAI,EAAE,wBAAwB;gBAC9B,WAAW,EAAE,iDAAiD;gBAC9D,MAAM,EAAE,2CAA2C;aACnD;SACD,CAAC;IACH,CAAC;IACD,KAAK,CAAC,eAAe,CACpB,QAA6B,EAC7B,QAA+B;QAE/B,OAAO;YACN;gBACC,OAAO,EAAE,UAAU;gBACnB,SAAS,EAAE,kBAAkB;gBAC7B,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,4EAA4E;gBACpF,YAAY,EAAE,CAAC,eAAe,CAAC;gBAC/B,WAAW,EAAE,IAAI;gBACjB,eAAe,EAAE,KAAK;gBACtB,UAAU,EAAE,EAAE;aACd;SACD,CAAC;IACH,CAAC;IACD,mBAAmB;QAClB,OAAO,EAAE,eAAe,EAAE,QAAiB,EAAE,aAAa,EAAE,QAAiB,EAAE,CAAC;IACjF,CAAC;IACD,aAAa;QACZ,OAAO,IAAI,CAAC;IACb,CAAC;IACD,WAAW;QACV,OAAO,KAAK,CAAC;IACd,CAAC;CACD;AAED,eAAe,2BAA2B,CAAC"}