fauna-api 1.0.771 → 1.0.780

package/dist/src/cicada/contacts.d.ts

@@ -1,3 +1,4 @@
+import { Cicada } from "./index.js";
 import { Credentials, ApiKey } from "../authentification.js";
 export type AddressKind = 'email' | 'phone' | 'discord';
 export type Address = {
@@ -14,6 +15,19 @@ export type Contact = {
     /** That Fauna account's picture. */
     icon?: string;
 };
+/** One of the inbox's owners, behind one of their verified addresses: show "You" when
+ *  `owner` is your own email, else their name. */
+export type Owner = {
+    /** The owner's email. */
+    owner: string;
+    displayName?: string;
+    icon?: string;
+    /** The address as it appeared. */
+    address: string;
+};
+export declare const Owner: {
+    fromJSON(json: any): Owner;
+};
 /** Every contact, sorted by display name. */
 export declare function list(authorization: Credentials | ApiKey): Promise<Contact[]>;
 /** Creates a contact, or with `id` renames one and replaces its addresses. */

package/dist/src/cicada/contacts.js

@@ -1,4 +1,14 @@
 import { Cicada } from "./index.js";
+export const Owner = {
+    fromJSON(json) {
+        return {
+            owner: String(json.owner),
+            ...(json.displayName ? { displayName: String(json.displayName) } : {}),
+            ...(json.icon ? { icon: String(json.icon) } : {}),
+            address: String(json.address ?? ''),
+        };
+    },
+};
 /** Every contact, sorted by display name. */
 export async function list(authorization) {
     const response = await fetch(`${Cicada.getURL()}/cicada/contacts`, {

package/dist/src/cicada/conversations.d.ts

@@ -1,11 +1,11 @@
-import { Contact } from "./contacts.js";
+import { Contact, Owner } from "./contacts.js";
 import { Platform } from "../integrations.js";
 import { Credentials, ApiKey } from "../authentification.js";
 import { File as FaunaFile } from "../drive.js";
 export type Conversation = {
     id: string;
     inboxId?: string;
-    participants: (Contact | string)[];
+    participants: (Contact | Owner | string)[];
     activeAt: Date;
     unread: number;
 };
@@ -22,14 +22,14 @@ export type ScheduledSend = {
         conversation: string;
         platform?: Platform;
     } | {
-        recipients: (Contact | string)[];
+        recipients: (Contact | Owner | string)[];
         mode: 'broadcast' | 'group';
         platform: Platform;
     };
 };
 export type Message = {
     id: string;
-    author: Contact | string;
+    author: Contact | Owner | string;
     platform: Platform;
     createdAt: Date;
     message: string;

package/dist/src/cicada/phone.d.ts

@@ -1,4 +1,5 @@
 import { Cicada } from "./index.js";
+import { Owner } from "./contacts.js";
 import { Credentials, ApiKey } from "../authentification.js";
 import WebSocket from "isomorphic-ws";
 export type CallEnd = {
@@ -65,6 +66,8 @@ export type CallRecord = {
     direction: 'IN' | 'OUT';
     /** The other party, E.164. */
     peer: string;
+    /** When `peer` is one of the inbox's owners: who they are. */
+    peerOwner?: Owner;
     /** The inbox's line, E.164. */
     line: string;
     status: string;

package/dist/src/cicada/phone.js

@@ -11,6 +11,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _PhoneCall_instances, _PhoneCall_ws, _PhoneCall_statusListeners, _PhoneCall_queue, _PhoneCall_wake, _PhoneCall_closed, _PhoneCall_ended, _PhoneCall_setStatus, _IncomingCall_authorization, _IncomingCall_ringing, _IncomingCall_accepted;
 import { Cicada } from "./index.js";
+import { Owner } from "./contacts.js";
 import WebSocket from "isomorphic-ws";
 function toBytes(data) {
     if (data instanceof Uint8Array)
@@ -310,6 +311,7 @@ export const CallRecord = {
             id: String(json.id),
             direction: json.direction === 'in' ? 'IN' : 'OUT',
             peer: String(json.peer ?? ''),
+            ...(json.peerOwner ? { peerOwner: Owner.fromJSON(json.peerOwner) } : {}),
             line: String(json.line ?? ''),
             status: String(json.status ?? ''),
             startedAt: new Date(json.startedAt),

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.771",
+  "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": {