@voicelayer/sdk 0.4.1 → 0.4.2

package/dist/index.js

@@ -1796,6 +1796,46 @@ var init_call_result = __esm({
     });
   }
 });
+var WEBHOOK_EVENT_TYPES, CallWebhookDirection, CallWebhookOutcome, CallWebhookAttributes, Party;
+var init_webhook_events = __esm({
+  "../contracts/src/webhook-events.ts"() {
+    WEBHOOK_EVENT_TYPES = ["call.started", "call.ended", "recording.ready"];
+    z.enum(WEBHOOK_EVENT_TYPES);
+    CallWebhookDirection = z.enum(["inbound", "outbound", "web"]);
+    CallWebhookOutcome = z.enum(["completed", "dropped", "failed", "no_answer", "other"]);
+    CallWebhookAttributes = z.record(z.union([z.string(), z.number(), z.boolean()]));
+    Party = z.string().min(1).nullable();
+    z.object({
+      callId: z.string().uuid(),
+      startedAt: z.string().datetime(),
+      agentId: z.string().nullable(),
+      phoneNumberId: z.string().nullable(),
+      callerE164: Party,
+      toE164: Party,
+      // Null when it can't be told yet: an inbound phone call and a web session look alike until the caller joins. When
+      // set, it is the same value `call.ended` carries; `call.ended` always has one.
+      direction: CallWebhookDirection.nullable()
+    });
+    z.object({
+      callId: z.string().uuid(),
+      durationMs: z.number().int().min(0),
+      endedAt: z.string().datetime(),
+      endReason: z.string(),
+      agentId: z.string().nullable(),
+      phoneNumberId: z.string().nullable(),
+      callerE164: Party,
+      toE164: Party,
+      direction: CallWebhookDirection,
+      outcome: CallWebhookOutcome,
+      attributes: CallWebhookAttributes
+    });
+    z.object({
+      callId: z.string().uuid(),
+      recordingUrl: z.string().url(),
+      status: z.enum(["starting", "active", "completed", "failed", "aborted"])
+    });
+  }
+});
 var PhoneNumberStatus, PhoneNumberProvider, PhoneNumberCapabilities, PhoneNumberRecord;
 var init_numbers = __esm({
   "../contracts/src/numbers.ts"() {
@@ -4017,6 +4057,7 @@ var init_src = __esm({
     init_tests();
     init_call_review();
     init_call_result();
+    init_webhook_events();
     init_numbers();
     init_project_limits();
     init_flow();
@@ -9352,6 +9393,12 @@ function createAgentEventEmitter() {
 var TextTurnReplyAccepted = z.object({ accepted: z.literal(true) });
 var DeleteAgentResponseSchema = z.object({ ok: z.literal(true) });
 var HEARTBEAT_FAILURE_DEGRADE_THRESHOLD = 3;
+function isAgentNameReservedError(err) {
+  return err instanceof VoiceLayerHttpError && err.status === 422 && err.body?.error === "agent_name_reserved";
+}
+function agentNameReservedMessage(name) {
+  return `[voicelayer] registration REFUSED: the agent name "${name}" is reserved for VoiceLayer's own workers (names starting "voicelayer-", the platform worker names, or ending "::text"). The agent will not appear online. Rename it in defineAgent({ name }) and restart.`;
+}
 var AgentsClient = class {
   constructor(transport, options = {}) {
     this.transport = transport;
@@ -9473,10 +9520,16 @@ var AgentsClient = class {
       ...input.mcpExposed !== void 0 ? { mcpExposed: input.mcpExposed } : {},
       metadata
     });
-    const response = await this.transport.request(
-      { method: "POST", path: "/v1/agents/register", body },
-      RegisterAgentResponse
-    );
+    let response;
+    try {
+      response = await this.transport.request(
+        { method: "POST", path: "/v1/agents/register", body },
+        RegisterAgentResponse
+      );
+    } catch (err) {
+      if (isAgentNameReservedError(err)) console.error(agentNameReservedMessage(body.name));
+      throw err;
+    }
     events.emit({ type: "registered", agent: response.agent });
     const cadence = opts.heartbeatIntervalMs ?? response.heartbeatIntervalMs ?? AGENT_HEARTBEAT_INTERVAL_MS;
     const state = {
@@ -9671,11 +9724,16 @@ var HeartbeatTicker = class {
         this.state.consecutiveFailures = 0;
       } catch (reErr) {
         this.state.consecutiveFailures += 1;
+        const reserved = isAgentNameReservedError(reErr);
+        if (reserved) {
+          this.stopped = true;
+          console.error(agentNameReservedMessage(this.state.registerInput.body.name));
+        }
         this.opts.events.emit({
           type: "heartbeat_error",
           error: reErr instanceof Error ? reErr : new Error(String(reErr)),
           consecutiveFailures: this.state.consecutiveFailures,
-          willRetry: true
+          willRetry: !reserved
         });
       }
       return;

package/dist/runtime/text-session.d.ts

@@ -1,4 +1,4 @@
-export { ab as GraphTraceEvent, ac as LiveTextConversation, ad as LiveTurnResult, ae as RunLiveTextOptions, u as RunTextSessionOptions, v as RunTextTranscriptOptions, V as TextSession, W as TextTranscriptResult, af as runLiveTextConversation, a8 as runTextSession, a9 as runTextTranscript, ag as runWithOpenAIScope } from '../text-session-BB0dLLH2.js';
+export { ab as GraphTraceEvent, ac as LiveTextConversation, ad as LiveTurnResult, ae as RunLiveTextOptions, u as RunTextSessionOptions, v as RunTextTranscriptOptions, V as TextSession, W as TextTranscriptResult, af as runLiveTextConversation, a8 as runTextSession, a9 as runTextTranscript, ag as runWithOpenAIScope } from '../text-session-CtXihRr6.js';
 import '@livekit/agents';
 import 'zod';
 import 'openai';

package/dist/runtime/text-session.js

@@ -1682,6 +1682,46 @@ var init_call_result = __esm({
     });
   }
 });
+var WEBHOOK_EVENT_TYPES, CallWebhookDirection, CallWebhookOutcome, CallWebhookAttributes, Party;
+var init_webhook_events = __esm({
+  "../contracts/src/webhook-events.ts"() {
+    WEBHOOK_EVENT_TYPES = ["call.started", "call.ended", "recording.ready"];
+    z.enum(WEBHOOK_EVENT_TYPES);
+    CallWebhookDirection = z.enum(["inbound", "outbound", "web"]);
+    CallWebhookOutcome = z.enum(["completed", "dropped", "failed", "no_answer", "other"]);
+    CallWebhookAttributes = z.record(z.union([z.string(), z.number(), z.boolean()]));
+    Party = z.string().min(1).nullable();
+    z.object({
+      callId: z.string().uuid(),
+      startedAt: z.string().datetime(),
+      agentId: z.string().nullable(),
+      phoneNumberId: z.string().nullable(),
+      callerE164: Party,
+      toE164: Party,
+      // Null when it can't be told yet: an inbound phone call and a web session look alike until the caller joins. When
+      // set, it is the same value `call.ended` carries; `call.ended` always has one.
+      direction: CallWebhookDirection.nullable()
+    });
+    z.object({
+      callId: z.string().uuid(),
+      durationMs: z.number().int().min(0),
+      endedAt: z.string().datetime(),
+      endReason: z.string(),
+      agentId: z.string().nullable(),
+      phoneNumberId: z.string().nullable(),
+      callerE164: Party,
+      toE164: Party,
+      direction: CallWebhookDirection,
+      outcome: CallWebhookOutcome,
+      attributes: CallWebhookAttributes
+    });
+    z.object({
+      callId: z.string().uuid(),
+      recordingUrl: z.string().url(),
+      status: z.enum(["starting", "active", "completed", "failed", "aborted"])
+    });
+  }
+});
 var PhoneNumberStatus, PhoneNumberProvider, PhoneNumberCapabilities, PhoneNumberRecord;
 var init_numbers = __esm({
   "../contracts/src/numbers.ts"() {
@@ -3553,6 +3593,7 @@ var init_src = __esm({
     init_tests();
     init_call_review();
     init_call_result();
+    init_webhook_events();
     init_numbers();
     init_project_limits();
     init_flow();