fauna-api 1.0.773 → 1.0.780

package/dist/src/parrot/agent.d.ts

@@ -30,10 +30,13 @@ export declare function generateTextSync(authorization: Credentials | ApiKey, mo
 export declare function generateVoice(authorization: Credentials | ApiKey, model: Voice, options?: Partial<{
     content: Content[];
     audio: AsyncIterable<Uint8Array>;
+    notes: AsyncIterable<string>;
     tools: Tool[] | Tool;
     maxTools: number;
     voice: Partial<Demographic>;
     memories: number;
+    brain: Text;
+    reasoning: string;
     group: Group;
     signal: AbortSignal;
 }>): AsyncGenerator<VoiceEvent>;

package/dist/src/parrot/agent.js

@@ -78,7 +78,10 @@ export async function* generateText(authorization, model, options) {
 export async function generateTextSync(authorization, model, options) {
     return collectText(generateText(authorization, model, options));
 }
-// Realtime voice: PCM16 16 kHz in from `audio`, PCM16 24 kHz out as audio events.
+// Realtime voice: PCM16 16 kHz in from `audio`, PCM16 24 kHz out as audio events. Each of
+// `notes` tells the model something to act on now. An ElevenLabs voice thinks with `brain`
+// (a text model, through Fauna) at `reasoning`, and needs one; OpenAI and xAI voices are their
+// own brain.
 export async function* generateVoice(authorization, model, options) {
     yield* streamVoice(authorization, '/agent/voice', model, options);
 }

package/dist/src/parrot/generative.d.ts

@@ -54,7 +54,7 @@ export declare enum Speech {
 }
 export declare enum Transcription {
     GPT_TRANSCRIBE = "gpt-transcribe",
-    GROK_STT = "grok-stt",
+    GROK_VOICE_TRANSCRIBE_2_0 = "grok-voice-transcribe-2.0",
     SCRIBE_V2 = "scribe_v2"
 }
 export declare enum Embedding {
@@ -245,17 +245,23 @@ export declare function generateTranscription(authorization: Credentials | ApiKe
 export declare function generateVoice(authorization: Credentials | ApiKey, model: Voice, options?: Partial<{
     content: Content[];
     audio: AsyncIterable<Uint8Array>;
+    notes: AsyncIterable<string>;
     tools: Tool[] | Tool;
     maxTools: number;
     voice: Partial<Demographic>;
+    brain: Text;
+    reasoning: string;
     signal: AbortSignal;
     group: Group;
 }>): AsyncGenerator<VoiceEvent>;
 export declare function generateVoiceSync(authorization: Credentials | ApiKey, model: Voice, options?: Partial<{
     content: Content[];
     audio: AsyncIterable<Uint8Array>;
+    notes: AsyncIterable<string>;
     tools: Tool[] | Tool;
     maxTools: number;
     voice: Partial<Demographic>;
+    brain: Text;
+    reasoning: string;
     group: Group;
 }>): Promise<TextResponse>;

package/dist/src/parrot/generative.js

@@ -68,7 +68,7 @@ export var Transcription;
     // OpenAI
     Transcription["GPT_TRANSCRIBE"] = "gpt-transcribe";
     // xAI
-    Transcription["GROK_STT"] = "grok-stt";
+    Transcription["GROK_VOICE_TRANSCRIBE_2_0"] = "grok-voice-transcribe-2.0";
     // ElevenLabs
     Transcription["SCRIBE_V2"] = "scribe_v2";
 })(Transcription || (Transcription = {}));
@@ -176,7 +176,9 @@ export async function generateSpeech(authorization, model, options = {}) {
 export async function generateTranscription(authorization, model, options = {}) {
     return generateMedia(authorization, '/generative/transcription', model, options, 'application/octet-stream');
 }
-// Streaming Voice Generation
+// Streaming Voice Generation. Each of `notes` tells the model something to act on now. An
+// ElevenLabs voice thinks with `brain` (a text model, through Fauna) at `reasoning`, and needs
+// one; OpenAI and xAI voices are their own brain.
 export async function* generateVoice(authorization, model, options = {}) {
     yield* streamVoice(authorization, '/generative/voice', model, options);
 }

package/dist/src/parrot/socket.d.ts

@@ -1,7 +1,7 @@
 import { Credentials, ApiKey } from "../authentification.js";
 import type { Group } from "../groups.js";
 import type { Demographic } from "../ant/persona.js";
-import { type Content, type StreamEvent, type TextResponse, type Tool, type VoiceEvent } from "./generative.js";
+import { type Content, type StreamEvent, type Text, type TextResponse, type Tool, type VoiceEvent } from "./generative.js";
 /** A Parrot socket URL; `group` adds the Group header (shared memory, group billing). */
 export declare function socketUrl(path: string, authorization: Credentials | ApiKey, group?: Group): string;
 /** FILE parts become path or access code refs (uploading offline files first); no binaries go up. */
@@ -27,10 +27,13 @@ export declare function collectText(stream: AsyncGenerator<StreamEvent>): Promis
 type VoiceOptions = Partial<{
     content: Content[];
     audio: AsyncIterable<Uint8Array>;
+    notes: AsyncIterable<string>;
     tools: Tool[] | Tool;
     maxTools: number;
     voice: Partial<Demographic>;
     memories: number;
+    brain: Text;
+    reasoning: string;
     group: Group;
     signal: AbortSignal;
 }>;

package/dist/src/parrot/socket.js

@@ -393,6 +393,8 @@ export async function* streamVoice(authorization, path, model, options = {}) {
             maxTools: options.maxTools,
             voice: options.voice,
             memories: options.memories,
+            brain: options.brain,
+            reasoning: options.reasoning,
         }));
         ws.send(JSON.stringify({ event: 'start' }));
         if (options.audio) {
@@ -407,6 +409,18 @@ export async function* streamVoice(authorization, path, model, options = {}) {
                 catch { }
             })();
         }
+        if (options.notes) {
+            void (async () => {
+                try {
+                    for await (const text of options.notes) {
+                        if (ws.readyState !== WebSocket.OPEN)
+                            break;
+                        ws.send(JSON.stringify({ event: 'note', text }));
+                    }
+                }
+                catch { }
+            })();
+        }
         yield* readEvents(ws, (msg, queue) => {
             const data = msg.data;
             if (typeof data !== 'string') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fauna-api",
-  "version": "1.0.773",
+  "version": "1.0.780",
   "description": "The Fauna SDK: accounts, Drive, groups, calendar, chats, payments and every Fauna app (Parrot, Marmot, Magpie, Cicada, Ant, Termite), plus React UI.",
   "homepage": "https://docs.faunakit.com",
   "repository": {