@agent-native/toolkit 0.5.0 → 0.6.0

package/dist/composer/useVoiceDictation.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Voice dictation hook for the agent composer.
+ *
+ * Wires voice providers behind a single state machine:
+ *   - "auto" / "openai" / "builder" / "builder-gemini" / "gemini" / "groq"
+ *     — MediaRecorder → POST /_agent-native/transcribe-voice
+ *   - "google-realtime"
+ *     — MediaRecorder chunks → POST /_agent-native/transcribe-stream/session
+ *       → managed WebSocket → Google Speech-to-Text streaming
+ *   - "browser" — Web Speech API (low quality, offline capable)
+ *
+ * Provider preference lives in application_state under
+ * `voice-transcription-prefs` (`{ transcriptionMode, provider, instructions }`).
+ * The composer reads it on every start so settings changes take effect
+ * immediately without unmounting the composer.
+ *
+ * The hook exposes amplitude (0..1) and duration (ms) so the composer can
+ * render the Lovable-style live waveform + MM:SS timer.
+ */
+import { type VoiceContextPack } from "./runtime-adapters.js";
+export type VoiceProvider = "auto" | "openai" | "browser" | "google-realtime" | "builder-gemini" | "builder" | "gemini" | "groq";
+export type TranscriptionMode = "mac-native" | "google-realtime" | "batch";
+export interface VoicePrefs {
+    provider: VoiceProvider;
+    transcriptionMode?: TranscriptionMode;
+    instructions?: string;
+    cleanupEnabled?: boolean;
+}
+export interface VoiceCleanupPrefs {
+    enabled?: boolean;
+}
+type VoiceContextPackSource = VoiceContextPack | (() => VoiceContextPack | undefined | Promise<VoiceContextPack | undefined>) | undefined;
+export type VoiceState = "idle" | "starting" | "recording" | "transcribing" | "error";
+export interface UseVoiceDictationOptions {
+    onTranscript: (text: string) => void;
+    onError?: (message: string) => void;
+    /** Called with (accumulatedFinalText, currentInterimText) as speech is recognized in real time. */
+    onLiveUpdate?: (finalText: string, interimText: string) => void;
+    contextPack?: VoiceContextPackSource;
+}
+export interface VoiceDictationApi {
+    state: VoiceState;
+    amplitude: number;
+    durationMs: number;
+    errorMessage: string | null;
+    provider: VoiceProvider;
+    supported: boolean;
+    start: () => Promise<void>;
+    stop: () => void;
+    cancel: () => void;
+    dismissError: () => void;
+}
+export declare function providerForTextCleanup(provider: VoiceProvider): VoiceProvider;
+export declare function voiceDictationStartErrorMessage(error: unknown): string;
+export declare function useVoiceDictation(options: UseVoiceDictationOptions): VoiceDictationApi;
+export {};
+//# sourceMappingURL=useVoiceDictation.d.ts.map

package/dist/composer/useVoiceDictation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVoiceDictation.d.ts","sourceRoot":"","sources":["../../src/composer/useVoiceDictation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,QAAQ,GACR,SAAS,GACT,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,KAAK,sBAAsB,GACvB,gBAAgB,GAChB,CAAC,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC,GAC5E,SAAS,CAAC;AA8Cd,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,UAAU,GACV,WAAW,GACX,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,mGAAmG;IACnG,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAyHD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,CAE7E;AAiED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAkCtE;AAeD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAyzBnB"}