pi-harness-runtime 1.1.337 → 1.1.338

package/packages/voice-api/src/transcriber.ts

@@ -0,0 +1,136 @@
+/**
+ * Voice Transcriber - Main interface for speech-to-text
+ */
+
+import type { TranscriptionResult, TranscribeOptions, VoiceApiConfig } from './types.js';
+import { WhisperProvider, createOpenAIProvider, createReplicateProvider } from './provider.js';
+
+/**
+ * Voice Transcriber
+ * 
+ * Main interface for transcribing voice messages to text.
+ * Supports multiple providers (OpenAI, Replicate).
+ */
+export class VoiceTranscriber {
+  private providers: Map<string, WhisperProvider> = new Map();
+  private defaultProvider: string = '';
+
+  constructor(config: VoiceApiConfig = {}) {
+    // Initialize OpenAI provider
+    if (config.openaiApiKey) {
+      const provider = createOpenAIProvider(config.openaiApiKey);
+      this.providers.set('openai', provider);
+      this.defaultProvider = 'openai';
+    }
+
+    // Initialize Replicate provider
+    if (config.replicateApiToken) {
+      const provider = createReplicateProvider(config.replicateApiToken);
+      this.providers.set('replicate', provider);
+      if (!this.defaultProvider) {
+        this.defaultProvider = 'replicate';
+      }
+    }
+
+    // Set default provider from config
+    if (config.provider && this.providers.has(config.provider)) {
+      this.defaultProvider = config.provider;
+    }
+  }
+
+  /**
+   * Check if transcriber is configured
+   */
+  isConfigured(): boolean {
+    return this.providers.size > 0;
+  }
+
+  /**
+   * Get configured providers
+   */
+  getProviders(): string[] {
+    return Array.from(this.providers.keys());
+  }
+
+  /**
+   * Get default provider
+   */
+  getDefaultProvider(): string | null {
+    return this.defaultProvider || null;
+  }
+
+  /**
+   * Transcribe audio to text
+   */
+  async transcribe(options: TranscribeOptions): Promise<TranscriptionResult> {
+    const providerName = options.provider || this.defaultProvider;
+    
+    if (!providerName) {
+      return {
+        text: '',
+        timestamp: new Date().toISOString(),
+        provider: 'openai',
+        error: 'No provider configured',
+      };
+    }
+
+    const provider = this.providers.get(providerName);
+    if (!provider) {
+      return {
+        text: '',
+        timestamp: new Date().toISOString(),
+        provider: providerName as 'openai' | 'replicate',
+        error: `Provider ${providerName} not configured`,
+      };
+    }
+
+    return provider.transcribe(options);
+  }
+
+  /**
+   * Add a provider
+   */
+  addProvider(name: string, provider: WhisperProvider): void {
+    this.providers.set(name, provider);
+    if (!this.defaultProvider) {
+      this.defaultProvider = name;
+    }
+  }
+
+  /**
+   * Remove a provider
+   */
+  removeProvider(name: string): boolean {
+    const deleted = this.providers.delete(name);
+    if (this.defaultProvider === name) {
+      this.defaultProvider = this.providers.keys().next().value || '';
+    }
+    return deleted;
+  }
+
+  /**
+   * Set default provider
+   */
+  setDefaultProvider(name: string): boolean {
+    if (this.providers.has(name)) {
+      this.defaultProvider = name;
+      return true;
+    }
+    return false;
+  }
+}
+
+/**
+ * Create a VoiceTranscriber from environment variables
+ */
+export function createFromEnv(): VoiceTranscriber {
+  // SAFETY: globalThis.process is always available in Node.js
+  const env = (globalThis as unknown as { process: { env: Record<string, string> } }).process;
+  const envVars = env?.env ?? {};
+  
+  return new VoiceTranscriber({
+    openaiApiKey: envVars.OPENAI_API_KEY,
+    replicateApiToken: envVars.REPLICATE_API_TOKEN,
+    provider: (envVars.VOICE_PROVIDER as 'openai' | 'replicate') || 'openai',
+  });
+}

package/packages/voice-api/src/types.ts

@@ -0,0 +1,79 @@
+/**
+ * Voice API Types
+ */
+
+/**
+ * Transcription result from Whisper
+ */
+export interface TranscriptionResult {
+  /** The transcribed text */
+  text: string;
+  /** Language detected (ISO 639-1) */
+  language?: string;
+  /** Duration in seconds */
+  duration?: number;
+  /** Confidence score (0-1) */
+  confidence?: number;
+  /** Timestamp of transcription */
+  timestamp: string;
+  /** Provider used (openai/replicate) */
+  provider: 'openai' | 'replicate';
+  /** Error message if failed */
+  error?: string;
+}
+
+/**
+ * Voice message from messaging platforms
+ */
+export interface VoiceMessage {
+  /** Unique message ID */
+  id: string;
+  /** Platform source (telegram/line) */
+  platform: 'telegram' | 'line';
+  /** Chat/user ID */
+  chatId: string;
+  /** Audio file URL or path */
+  audioUrl: string;
+  /** Duration in seconds */
+  duration?: number;
+  /** MIME type */
+  mimeType: string;
+  /** File size in bytes */
+  fileSize?: number;
+  /** Raw platform-specific data */
+  raw?: unknown;
+}
+
+/**
+ * Voice API configuration
+ */
+export interface VoiceApiConfig {
+  /** OpenAI API key (for Whisper) */
+  openaiApiKey?: string;
+  /** Replicate API token (alternative) */
+  replicateApiToken?: string;
+  /** Default provider */
+  provider?: 'openai' | 'replicate';
+  /** Model to use */
+  model?: string;
+  /** Language hint (ISO 639-1) */
+  language?: string;
+  /** Temperature for generation */
+  temperature?: number;
+}
+
+/**
+ * Transcribe options
+ */
+export interface TranscribeOptions {
+  /** Audio URL or file path (required if no audioBuffer) */
+  audioUrl?: string;
+  /** Audio as Buffer (Uint8Array for cross-platform) */
+  audioBuffer?: Uint8Array;
+  /** Language hint */
+  language?: string;
+  /** Model override */
+  model?: string;
+  /** Provider override */
+  provider?: 'openai' | 'replicate';
+}

package/packages/webmcp-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/webmcp-tester",
-  "version": "1.1.337",
+  "version": "1.1.338",
   "description": "WebMCP-powered E2E testing for pi-harness - natural language test scenarios",
   "type": "module",
   "main": "./dist/index.js",

package/packages/wiki/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/wiki",
-  "version": "1.1.337",
+  "version": "1.1.338",
   "description": "LLM Wiki integration for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/workflow-events/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/workflow-events",
-  "version": "1.1.337",
+  "version": "1.1.338",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/workspace-scanner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/workspace-scanner",
-  "version": "1.1.337",
+  "version": "1.1.338",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/worktree/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/worktree",
-  "version": "1.1.337",
+  "version": "1.1.338",
   "description": "pi-harness-runtime — worktree",
   "type": "module",
   "main": "./dist/index.js",

package/packages/write-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/write-review",
-  "version": "1.1.337",
+  "version": "1.1.338",
   "description": "Two-agent write-review loop with blackboard coordination",
   "type": "module",
   "main": "src/index.ts",