fauna-api 1.0.692 → 1.0.693

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

@@ -1,7 +1,7 @@
 import { Cicada } from "./index.js";
 import { Platform } from "../integrations.js";
 import { Credentials, ApiKey } from "../authentification.js";
-import type { Text } from "../parrot/generative.js";
+import type { Text, Voice } from "../parrot/generative.js";
 export type InboxGroup = {
     id: string;
     name: string;
@@ -30,8 +30,12 @@ export declare function assign(authorization: Credentials | ApiKey, inboxId: str
 }): Promise<void>;
 export declare function listAccounts(authorization: Credentials | ApiKey, inboxId: string): Promise<InboxAccount[]>;
 /** `dailyLimit` and `spentToday` are dollars per UTC day; at the limit the agent pauses until midnight UTC. */
+/** `reasoning` is one of the text model's catalog tiers, empty for its default; `voiceModel`
+ *  is the realtime voice the agent talks with on calls, empty for the catalog's first. */
 export type AgentSettings = {
     model: Text;
+    reasoning: string;
+    voiceModel: Voice | '';
     instructions: string;
     dailyLimit: number;
     spentToday: number;
@@ -44,6 +48,8 @@ export declare function getAgent(authorization: Credentials | ApiKey, inbox: str
 /** Turns the agent on (it answers messages sent from now on) or updates it. */
 export declare function setAgent(authorization: Credentials | ApiKey, inbox: string, settings: {
     model: Text;
+    reasoning?: string;
+    voiceModel?: Voice;
     instructions: string;
     dailyLimit: number;
 }): Promise<AgentSettings>;

package/dist/src/cicada/inboxes.js

@@ -61,6 +61,8 @@ export const AgentSettings = {
     fromJSON(json) {
         return {
             model: json.model,
+            reasoning: String(json.reasoning ?? ''),
+            voiceModel: String(json.voiceModel ?? ''),
             instructions: String(json.instructions ?? ''),
             dailyLimit: Number(json.dailyLimit ?? 0),
             spentToday: Number(json.spentToday ?? 0),

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

@@ -1,3 +1,4 @@
+import { Cicada } from "./index.js";
 import { Credentials, ApiKey } from "../authentification.js";
 import WebSocket from "isomorphic-ws";
 export type CallEnd = {
@@ -46,3 +47,47 @@ export declare function listen(authorization: Credentials | ApiKey, inbox: strin
 }>;
 /** Calls `to` from one of the inbox's phone lines: `from`, or its first line. */
 export declare function call(authorization: Credentials | ApiKey, inbox: string, to: string, from?: string): Promise<PhoneCall>;
+/** Where in a recording something was said, in milliseconds from its start. */
+export type CallSpan = {
+    startMs: number;
+    endMs: number;
+};
+/** One side speaking in a recorded call, each word timed. `You` is the inbox's side on a
+ *  call a person took or placed; `Agent` is the inbox's agent. */
+export type CallSegment = CallSpan & {
+    speaker: 'Them' | 'You' | 'Agent';
+    text: string;
+    words: CallSpan[];
+};
+/** A call on one of the inbox's lines, with its recording's timed transcript. */
+export type CallRecord = {
+    id: string;
+    direction: 'IN' | 'OUT';
+    /** The other party, E.164. */
+    peer: string;
+    /** The inbox's line, E.164. */
+    line: string;
+    status: string;
+    startedAt: Date;
+    /** Seconds it was connected. */
+    duration: number;
+    /** The inbox's agent took or placed it. */
+    agent: boolean;
+    /** A message left on the line, or a call that reached their voicemail. */
+    voicemail: boolean;
+    /** Its audio can be fetched with recording(). */
+    recorded: boolean;
+    segments: CallSegment[];
+};
+export declare const CallRecord: {
+    fromJSON(json: any): CallRecord;
+};
+/** The inbox's calls, newest first. `voicemails` keeps only voicemails; `query` matches what was said, the number, or the contact's name. */
+export declare function history(authorization: Credentials | ApiKey, inbox: string, opts?: {
+    voicemails?: boolean;
+    query?: string;
+    cursor?: number;
+    max?: number;
+}): Promise<CallRecord[]>;
+/** A recorded call's audio, MP3. */
+export declare function recording(authorization: Credentials | ApiKey, call: string): Promise<Blob>;

package/dist/src/cicada/phone.js

@@ -304,3 +304,49 @@ export async function listen(authorization, inbox, onIncoming) {
 export async function call(authorization, inbox, to, from) {
     return openCall(authorization, { event: 'dial', inbox, to, ...(from ? { from } : {}) });
 }
+export const CallRecord = {
+    fromJSON(json) {
+        return {
+            id: String(json.id),
+            direction: json.direction === 'in' ? 'IN' : 'OUT',
+            peer: String(json.peer ?? ''),
+            line: String(json.line ?? ''),
+            status: String(json.status ?? ''),
+            startedAt: new Date(json.startedAt),
+            duration: Number(json.duration ?? 0),
+            agent: Boolean(json.agent),
+            voicemail: Boolean(json.voicemail),
+            recorded: Boolean(json.recorded),
+            segments: Array.isArray(json.segments) ? json.segments : [],
+        };
+    },
+};
+/** The inbox's calls, newest first. `voicemails` keeps only voicemails; `query` matches what was said, the number, or the contact's name. */
+export async function history(authorization, inbox, opts = {}) {
+    const response = await fetch(`${Cicada.getURL()}/cicada/phone/history`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: 'email' in authorization ? `Token ${authorization.token}` : `ApiKey ${authorization.id}`,
+        },
+        body: JSON.stringify({ inbox, ...opts }),
+    });
+    if (!response.ok)
+        throw new Error(await response.text());
+    const json = await response.json();
+    return (Array.isArray(json) ? json : []).map(CallRecord.fromJSON);
+}
+/** A recorded call's audio, MP3. */
+export async function recording(authorization, call) {
+    const response = await fetch(`${Cicada.getURL()}/cicada/phone/recording`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: 'email' in authorization ? `Token ${authorization.token}` : `ApiKey ${authorization.id}`,
+        },
+        body: JSON.stringify({ call }),
+    });
+    if (!response.ok)
+        throw new Error(await response.text());
+    return await response.blob();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fauna-api",
-  "version": "1.0.692",
+  "version": "1.0.693",
   "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": {