@guava-ai/guava-sdk 0.26.0 → 0.27.1

package/src/commands.ts

@@ -1,5 +1,6 @@
 import * as z from "zod";
 import { ActionItem } from "./action-item.ts";
+import { DTMF_DIGITS } from "./events.ts";
 
 export const StartOutboundCallCommand = z.strictObject({
   command_type: z.literal("start-outbound"),
@@ -133,6 +134,12 @@ export const SetAgentDTMFCommand = z.strictObject({
 });
 export type SetAgentDTMFCommand = z.input<typeof SetAgentDTMFCommand>;
 
+export const SendAgentDTMFCommand = z.strictObject({
+  command_type: z.literal("send-agent-dtmf"),
+  digits: z.array(z.enum(DTMF_DIGITS)),
+});
+export type SendAgentDTMFCommand = z.input<typeof SendAgentDTMFCommand>;
+
 export const ExpertErrorCommand = z.strictObject({
   command_type: z.literal("expert-error"),
   message: z.string(),
@@ -156,6 +163,7 @@ export const AnyCommand = z.union([
   ActionSuggestionCommand,
   RetryTaskCommand,
   SetAgentDTMFCommand,
+  SendAgentDTMFCommand,
   ExpertErrorCommand,
 ]);
 export type Command = z.input<typeof AnyCommand>;

package/src/events.ts

@@ -126,27 +126,29 @@ export const ExecuteActionEvent = z.object({
 });
 export type ExecuteActionEvent = z.infer<typeof ExecuteActionEvent>;
 
-export type DTMFDigit =
-  | "0"
-  | "1"
-  | "2"
-  | "3"
-  | "4"
-  | "5"
-  | "6"
-  | "7"
-  | "8"
-  | "9"
-  | "*"
-  | "#"
-  | "A"
-  | "B"
-  | "C"
-  | "D";
+export const DTMF_DIGITS = [
+  "0",
+  "1",
+  "2",
+  "3",
+  "4",
+  "5",
+  "6",
+  "7",
+  "8",
+  "9",
+  "*",
+  "#",
+  "A",
+  "B",
+  "C",
+  "D",
+] as const;
+export type DTMFDigit = (typeof DTMF_DIGITS)[number];
 
 export const DTMFPressedEvent = z.object({
   event_type: z.literal("dtmf"),
-  digit: z.enum(["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "*", "#", "A", "B", "C", "D"]),
+  digit: z.enum(DTMF_DIGITS),
   recent_digits: z.string().default(""),
 });
 export type DTMFPressedEvent = z.infer<typeof DTMFPressedEvent>;

package/src/index.ts

@@ -1,7 +1,6 @@
 export { Client, type InboundConnection } from "./client.ts";
 export { Runner } from "./runner.ts";
 export type { SmsMessage } from "./sms.ts";
-export { CallController, type TaskObjective } from "./call-controller.ts";
 export { Say, Field } from "./action-item.ts";
 export { Logger, getConsoleLogger, getDefaultLogger } from "./logging.ts";
 export { Agent, CallInfo } from "./agent.ts";

package/src/socket/client.ts

@@ -1,4 +1,5 @@
 import WebSocket from "ws";
+import type { IncomingMessage } from "node:http";
 import { randomBytes } from "node:crypto";
 import * as z from "zod";
 import type { Client } from "../client.ts";
@@ -134,6 +135,12 @@ export class GuavaSocket<SendT, RecvT> {
       const headers = await this._client.headers();
 
       try {
+        this._logger.debug(
+          "Connecting to %s (attempt %d/%d)...",
+          this._connectionUrl,
+          attempt,
+          MAX_RECONNECT_ATTEMPTS,
+        );
         const ws = await new Promise<WebSocket>((resolve, reject) => {
           const socket = new WebSocket(this._connectionUrl, { headers });
           let settled = false;
@@ -147,6 +154,21 @@ export class GuavaSocket<SendT, RecvT> {
           };
 
           socket.once("error", (err) => settle(() => reject(err)));
+          socket.once("unexpected-response", (_req, res: IncomingMessage) => {
+            let body = "";
+            res.on("data", (chunk: Buffer) => {
+              body += chunk.toString();
+            });
+            res.on("end", () => {
+              settle(() =>
+                reject(
+                  new Error(
+                    `Unexpected server response: ${res.statusCode}. Body: ${body || "<empty>"}`,
+                  ),
+                ),
+              );
+            });
+          });
           socket.once("close", () =>
             settle(() => reject(new Error("Connection closed before open-ack"))),
           );

package/src/telemetry.ts

@@ -5,7 +5,7 @@ import type { Client } from "./client.ts";
 const QUEUE_MAX_SIZE = 100;
 const UPLOAD_INTERVAL_MS = 10_000;
 
-const debugEnabled = ["yes", "true"].includes(
+const debugEnabled = ["yes", "true", "on"].includes(
   (process.env.GUAVA_DEBUG_TELEMETRY ?? "false").toLowerCase().trim(),
 );
 const logger: Logger = debugEnabled

package/src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "0.26.0";
+export const SDK_VERSION = "0.27.1";

package/dist/src/call-controller.d.ts

@@ -1,137 +0,0 @@
-import { type Logger } from "./logging.ts";
-import { type Command } from "./commands.ts";
-import type { GuavaEvent, CallerSpeechEvent, AgentSpeechEvent } from "./events.ts";
-import { type FieldItem, type SayItem } from "./action-item.ts";
-export type TaskObjective = {
-    objective: string;
-} | {
-    objective?: string;
-    checklist: (FieldItem | SayItem | string)[];
-};
-export type ReachPersonOutcome = {
-    key: string;
-    onOutcome: () => void;
-    description?: string;
-    nextActionPreview?: string;
-};
-type ReachPersonOptions = {
-    onSuccess: () => void;
-    onFailure: () => void;
-    greeting?: string;
-} | {
-    outcomes: ReachPersonOutcome[];
-    greeting?: string;
-};
-/**
- * Interface between Guava services and user-supplied code
- */
-export declare class CallController {
-    private _commandQueue;
-    private _on_complete_current_task?;
-    private _current_task_id?;
-    /**
-     * @protected
-     * @description logger used to emit diagnostics
-     */
-    protected logger: Logger;
-    private _drain?;
-    private _fieldValues;
-    private _searchFunctionsByKey;
-    constructor(logger?: Logger);
-    /**
-     * @description Supply a function used to consume commands from the internal command queue.
-     *
-     * The function is expected to remove from the argument array commands that it has handled (iterating
-     * through the result of `Array.splice(0)` is sufficient)
-     */
-    setDrain(newDrain: (_: Command[]) => Promise<void>): void;
-    /**
-     * @description [inbound] receive a call, and process further.
-     */
-    protected acceptCall(): Promise<void>;
-    /**
-     * @description read a span of text verbatim
-     */
-    protected readScript(script: string): Promise<void>;
-    /**
-     * @description [inbound] reject a call
-     */
-    protected rejectCall(): Promise<void>;
-    protected addInfo(_info: string): Promise<void>;
-    /**
-     * @description read a span of text non-verbatim
-     */
-    protected sendInstruction(instruction: string): Promise<void>;
-    /**
-     * @description provide identifiers the agent will use to identify the virtual agent
-     */
-    protected setPersona(args: {
-        organizationName?: string;
-        agentName?: string;
-        agentPurpose?: string;
-        voice?: string;
-    }): Promise<void>;
-    /**
-     * @description direct the agent to collect information
-     * @param goal {} an objective string and/or a checklist of information to collect
-     * @param on_complete {} a callback to call once the information is available from the agent
-     * @param args {} arguments to pass through to the `on_complete` callback
-     */
-    protected setTask(goal: TaskObjective, on_complete?: (...c: any[]) => void, ...args: any[]): void;
-    /**
-     * @description direct the agent to collect information, continuing execution once the agent has collected the information
-     * @param goal {} an objective string and/or a checklist of information to collect
-     */
-    protected awaitTask(goal: TaskObjective): Promise<void>;
-    /**
-     * @description retrieve a piece of information that the agent has collected
-     * @param key {string} key of the field checklist item
-     */
-    protected getField(key: string): unknown;
-    /**
-     * @description [inbound] hang up an accepted call
-     */
-    protected hangup(final_instructions?: string): Promise<void>;
-    /**
-     * @description helper for reaching a specific contact on an outbound call and recording their availability.
-     */
-    protected reachPerson(contactFullName: string, options: ReachPersonOptions): void;
-    /**
-     * @description transfer an accepted call
-     */
-    protected transfer(to_number: string, transfer_message?: string): void;
-    private sendCommand;
-    private flush;
-    onEvent(event: GuavaEvent): Promise<void>;
-    /**
-     * @description called when an inbound call is received. The overriding function must start
-     * with `await super.onIncomingCall(from_number)`
-     */
-    onIncomingCall(from_number?: string): Promise<void>;
-    /**
-     * @description called when a call is connected by the API, whether inbound or outbound
-     */
-    onCallStart(): Promise<void>;
-    /**
-     * @description called when the caller speaks to the agent.
-     */
-    onCallerSpeech(event: CallerSpeechEvent): Promise<void>;
-    /**
-     * @description called when the agent speaks to the caller.
-     */
-    onAgentSpeech(event: AgentSpeechEvent): Promise<void>;
-    /**
-     * @description called when the caller expresses a task they wish to execute
-     */
-    onIntent(intent: string): Promise<string | null>;
-    /**
-     * @description called when the agent needs to respond to a question that it doesn't know
-     * the answer to.
-     */
-    onQuestion(question: string): Promise<string>;
-    /**
-     * @description called when the bot session has ended.
-     */
-    onSessionDone(): void;
-}
-export {};