@voicelayer/sdk 0.5.0 → 0.5.1

package/dist/index.js

@@ -10,8 +10,8 @@ import { Readable } from 'stream';
 import { lookup } from 'dns/promises';
 import { voice as voice$1, llm } from '@livekit/agents';
 import { getQuickJS, shouldInterruptAfterDeadline } from 'quickjs-emscripten';
+import { randomUUID, createHash } from 'crypto';
 import { setup, createActor } from 'xstate';
-import { randomUUID } from 'crypto';
 import os from 'os';
 import { Resend } from 'resend';
 import { logs } from '@opentelemetry/api-logs';
@@ -303,6 +303,8 @@ var init_flow = __esm({
       "ask",
       "confirm",
       "tool",
+      // Send an email through the workspace's email (metered, wallet-gated; From on a verified domain) — burn-down G-22.
+      "email",
       "decision",
       "handoff",
       "end",
@@ -1369,6 +1371,61 @@ var init_forms = __esm({
   "../contracts/src/forms.ts"() {
   }
 });
+function isEmailAddress(value) {
+  return EMAIL_RE.test(value) && value.length <= 254;
+}
+function normalizeDomain(input) {
+  return input.trim().toLowerCase().replace(/^[a-z]+:\/\//, "").replace(/\/.*$/, "").replace(/\.$/, "");
+}
+function isDomainName(value) {
+  return DOMAIN_RE.test(value);
+}
+var EMAIL_RE, EMAIL_SUBJECT_MAX, EMAIL_TEXT_MAX, EMAIL_HTML_MAX, address, DOMAIN_RE, EmailDomainStatus, EmailDnsRecord;
+var init_email = __esm({
+  "../contracts/src/email.ts"() {
+    EMAIL_RE = /^[^\s@<>"]+@[^\s@<>"]+\.[^\s@<>"]+$/;
+    EMAIL_SUBJECT_MAX = 200;
+    EMAIL_TEXT_MAX = 5e4;
+    EMAIL_HTML_MAX = 2e5;
+    address = z.string().max(254).refine(isEmailAddress, { message: "must be an email address" });
+    z.object({
+      to: address,
+      subject: z.string().min(1).max(EMAIL_SUBJECT_MAX),
+      text: z.string().min(1).max(EMAIL_TEXT_MAX),
+      html: z.string().min(1).max(EMAIL_HTML_MAX).optional(),
+      // An address on one of the workspace's verified sending domains; omitted → the platform sender.
+      from: address.optional(),
+      // The display name shown beside `from` (or beside the platform sender's address).
+      fromName: z.string().trim().min(1).max(64).refine((v) => !/[\r\n<>"]/.test(v), { message: 'must not contain line breaks, <, > or "' }).optional(),
+      // Where a reply goes — any address; it needs no verification.
+      replyTo: address.optional(),
+      // The conversation (a call, a text conversation) the email belongs to — a conversation sends at most 3 emails.
+      conversationId: z.string().min(1).max(128).optional()
+    });
+    DOMAIN_RE = /^(?=.{4,253}$)(?!-)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/;
+    z.object({
+      domain: z.string().max(253).transform(normalizeDomain).refine(isDomainName, { message: "must be a domain like example.com" })
+    });
+    EmailDomainStatus = z.enum(["pending", "verified", "failed"]);
+    EmailDnsRecord = z.object({
+      type: z.enum(["CNAME", "TXT"]),
+      name: z.string(),
+      value: z.string(),
+      // dkim: proves the domain (required); dmarc: recommended, only when the domain has no DMARC record yet.
+      purpose: z.enum(["dkim", "dmarc"]),
+      required: z.boolean()
+    });
+    z.object({
+      id: z.string(),
+      domain: z.string(),
+      status: EmailDomainStatus,
+      records: z.array(EmailDnsRecord),
+      createdAt: z.string().datetime(),
+      lastCheckedAt: z.string().datetime().nullable(),
+      verifiedAt: z.string().datetime().nullable()
+    });
+  }
+});
 var AgentConfigVersionDTO, AgentConfigDiffField, AgentConfigChange;
 var init_agent_versions = __esm({
   "../contracts/src/agent-versions.ts"() {
@@ -2117,6 +2174,20 @@ function nodeConfigFor(node) {
         })()
       };
     }
+    case "email": {
+      const text = (key) => typeof data[key] === "string" && data[key].trim() ? data[key] : void 0;
+      const from = text("from");
+      const fromName = text("fromName");
+      const replyTo = text("replyTo");
+      return {
+        to: text("to") ?? "",
+        subject: text("subject") ?? "",
+        body: text("body") ?? "",
+        ...from ? { from: from.trim() } : {},
+        ...fromName ? { fromName: fromName.trim() } : {},
+        ...replyTo ? { replyTo: replyTo.trim() } : {}
+      };
+    }
     case "gate":
       return {
         requiredFields: Array.isArray(data.requiredFields) ? data.requiredFields.filter((x) => typeof x === "string") : []
@@ -2470,6 +2541,7 @@ var init_flow_validate = __esm({
     init_secret_headers();
     init_network_address();
     init_dispatch_metadata();
+    init_email();
     init_flow_edges();
     FlowIssueSeverity = z.enum(["error", "warning"]);
     FlowIssue = z.object({
@@ -4245,6 +4317,7 @@ var init_src = __esm({
     init_memory();
     init_participants();
     init_forms();
+    init_email();
     init_consultation();
     init_agent_config();
     init_agent_versions();
@@ -6086,7 +6159,7 @@ function menuDigitOf(b) {
 function menuLabelOf(label) {
   return label.replace(/^\s*[0-9*#]\s*[-—–:.]*\s*/, "").trim() || label.trim();
 }
-var ASK_MAX_CLARIFY, COLLECT_MAX_STALLED_TURNS, LLM_MAX_TURNS, HUB_MAX_TURNS, NO_INPUT_MS, sayExecutor, YES_WORDS, NO_WORDS, confirmExecutor, askExecutor, gateExecutor, endExecutor, handoffExecutor, OPENING_SILENCE_MS, llmExecutor, toolExecutor, ragExecutor, codeExecutor, decisionExecutor, MENU_MAX_INPUTS, menuExecutor, classifyExecutor, routerExecutor, playbookExecutor, setExecutor, MAX_SUBFLOW_DEPTH, subflowExecutor, passthroughExecutor, EXECUTORS;
+var ASK_MAX_CLARIFY, COLLECT_MAX_STALLED_TURNS, LLM_MAX_TURNS, HUB_MAX_TURNS, NO_INPUT_MS, sayExecutor, YES_WORDS, NO_WORDS, confirmExecutor, askExecutor, gateExecutor, endExecutor, handoffExecutor, OPENING_SILENCE_MS, llmExecutor, toolExecutor, ragExecutor, codeExecutor, decisionExecutor, MENU_MAX_INPUTS, menuExecutor, classifyExecutor, routerExecutor, playbookExecutor, setExecutor, MAX_SUBFLOW_DEPTH, subflowExecutor, EmailStepTimeout, EMAIL_SEND_TIMEOUT_MS, emailExecutor, passthroughExecutor, EXECUTORS;
 var init_executors = __esm({
   "src/runtime/graph/executors.ts"() {
     init_log();
@@ -6900,6 +6973,64 @@ ${collected}`);
       if (outcome.kind === "handoff") return { kind: "handoff", to: outcome.to };
       return { kind: "advance" };
     };
+    EmailStepTimeout = class extends Error {
+    };
+    EMAIL_SEND_TIMEOUT_MS = 1e4;
+    emailExecutor = async (node, state, deps) => {
+      const cfg = node.config;
+      const scope2 = scopeFor(state, deps);
+      const render = (key) => interpolate(str(cfg[key]), scope2).trim();
+      const to = render("to");
+      const from = render("from");
+      const fromName = render("fromName");
+      const replyTo = render("replyTo");
+      const fail = (error, detail) => {
+        state.nodeResults[node.id] = { ok: false, error, ...detail ? { detail } : {} };
+        deps.events.note("email.failed", { node: node.id, error, ...detail ? { detail } : {} });
+        return routeByPort(node, deps, "fail");
+      };
+      if (!isEmailAddress(to)) return fail("invalid_to", to ? "the recipient is not an email address" : "no recipient was captured");
+      const resolver = deps.resolvers?.email;
+      if (!resolver) {
+        return fail(
+          "email_unavailable",
+          "email isn't sent here: a dry run, or a pool worker that couldn't get this call's workspace identity (worker token)"
+        );
+      }
+      deps.events.note("email.sending", { node: node.id });
+      const abort = new AbortController();
+      let timer;
+      try {
+        const result = await Promise.race([
+          resolver(
+            {
+              to,
+              subject: render("subject"),
+              text: interpolate(str(cfg.body), scope2),
+              ...from ? { from } : {},
+              ...fromName ? { fromName } : {},
+              ...replyTo ? { replyTo } : {}
+            },
+            { signal: abort.signal }
+          ),
+          new Promise((_, reject) => {
+            timer = setTimeout(() => {
+              abort.abort();
+              reject(new EmailStepTimeout());
+            }, EMAIL_SEND_TIMEOUT_MS);
+          })
+        ]);
+        if (!result.ok) return fail(result.error, result.detail);
+        state.nodeResults[node.id] = { ok: true, emailId: result.emailId };
+        deps.events.note("email.sent", { node: node.id, emailId: result.emailId });
+        return routeByPort(node, deps, "ok");
+      } catch (err) {
+        if (err instanceof EmailStepTimeout) return fail("email_outcome_unknown", `no answer in ${EMAIL_SEND_TIMEOUT_MS} ms`);
+        return fail("email_send_failed", err instanceof Error ? err.message : String(err));
+      } finally {
+        if (timer) clearTimeout(timer);
+      }
+    };
     passthroughExecutor = async () => ({
       kind: "advance"
     });
@@ -6912,6 +7043,7 @@ ${collected}`);
       handoff: handoffExecutor,
       llm: llmExecutor,
       tool: toolExecutor,
+      email: emailExecutor,
       set: setExecutor,
       subflow: subflowExecutor,
       decision: decisionExecutor,
@@ -8409,6 +8541,201 @@ function registryToolCapabilities(defs) {
   return Object.entries(defs).map(([name, def]) => def.capability ?? `tool.${name}`);
 }
 
+// src/errors.ts
+var VoiceLayerError = class extends Error {
+  name = "VoiceLayerError";
+};
+var VoiceLayerAuthError = class extends VoiceLayerError {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+  }
+  status;
+  name = "VoiceLayerAuthError";
+};
+var VoiceLayerNetworkError = class extends VoiceLayerError {
+  name = "VoiceLayerNetworkError";
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+  }
+};
+var VoiceLayerValidationError = class extends VoiceLayerError {
+  constructor(message, issues) {
+    super(message);
+    this.issues = issues;
+  }
+  issues;
+  name = "VoiceLayerValidationError";
+};
+var VoiceLayerHttpError = class extends VoiceLayerError {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+  }
+  status;
+  body;
+  name = "VoiceLayerHttpError";
+};
+var SendEmailResponse = z.object({
+  emailId: z.string()
+}).passthrough();
+var EmailClient = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** `signal` aborts the request (the flow's Email step bounds its wait). A provider refusal (502), "email isn't set
+   *  up" (503) and "SES didn't answer — it may have sent" (504) are answers, never retried: a retry could only send
+   *  twice or fail again. */
+  async send(input, opts = {}) {
+    const body = {
+      to: input.to,
+      subject: input.subject,
+      text: input.text,
+      ...input.html !== void 0 ? { html: input.html } : {},
+      ...input.from !== void 0 ? { from: input.from } : {},
+      ...input.fromName !== void 0 ? { fromName: input.fromName } : {},
+      ...input.replyTo !== void 0 ? { replyTo: input.replyTo } : {},
+      ...input.conversationId !== void 0 ? { conversationId: input.conversationId } : {}
+    };
+    const parsed = await this.transport.request(
+      { method: "POST", path: "/v1/email/send", body, noRetryStatuses: [502, 503, 504], ...opts.signal ? { signal: opts.signal } : {} },
+      SendEmailResponse
+    );
+    return { emailId: parsed.emailId };
+  }
+};
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_INITIAL_BACKOFF_MS = 250;
+function buildUrl(baseUrl, path, query) {
+  const trimmedBase = baseUrl.replace(/\/+$/, "");
+  const trimmedPath = path.startsWith("/") ? path : `/${path}`;
+  let url = `${trimmedBase}${trimmedPath}`;
+  if (query) {
+    const params = new URLSearchParams();
+    for (const [k, v] of Object.entries(query)) {
+      if (v !== void 0) params.set(k, v);
+    }
+    const qs = params.toString();
+    if (qs.length > 0) url += `?${qs}`;
+  }
+  return url;
+}
+async function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new VoiceLayerNetworkError("aborted"));
+      return;
+    }
+    const t = setTimeout(() => resolve(), ms);
+    const onAbort = () => {
+      clearTimeout(t);
+      reject(new VoiceLayerNetworkError("aborted"));
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+var Transport = class {
+  constructor(options) {
+    this.options = options;
+    this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    this.initialBackoffMs = options.initialBackoffMs ?? DEFAULT_INITIAL_BACKOFF_MS;
+  }
+  options;
+  fetchImpl;
+  maxRetries;
+  initialBackoffMs;
+  async request(opts, schema) {
+    const url = buildUrl(this.options.baseUrl, opts.path, opts.query);
+    const headers = {
+      authorization: `Bearer ${this.options.apiKey}`,
+      "content-type": "application/json",
+      accept: "application/json"
+    };
+    if (this.options.userAgent) {
+      headers["user-agent"] = this.options.userAgent;
+    }
+    if (opts.headers) {
+      for (const [k, v] of Object.entries(opts.headers)) {
+        headers[k.toLowerCase()] = v;
+      }
+    }
+    const init = {
+      method: opts.method,
+      headers,
+      ...opts.body !== void 0 ? { body: JSON.stringify(opts.body) } : {},
+      ...opts.signal ? { signal: opts.signal } : {}
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      try {
+        const res = await this.fetchImpl(url, init);
+        if (res.status === 401 || res.status === 403) {
+          const body = await safeJson(res);
+          throw new VoiceLayerAuthError(
+            extractMessage(body, `auth failed (${res.status})`),
+            res.status
+          );
+        }
+        if (res.status >= 500 && attempt < this.maxRetries && !opts.noRetryStatuses?.includes(res.status)) {
+          lastError = new VoiceLayerHttpError(`server error ${res.status}`, res.status, await safeJson(res));
+          await sleep(this.backoffMs(attempt), opts.signal);
+          continue;
+        }
+        if (!res.ok) {
+          const body = await safeJson(res);
+          throw new VoiceLayerHttpError(extractMessage(body, `http ${res.status}`), res.status, body);
+        }
+        const json = await res.json();
+        const parsed = schema.safeParse(json);
+        if (!parsed.success) {
+          throw new VoiceLayerValidationError("response failed schema validation", parsed.error.issues);
+        }
+        return parsed.data;
+      } catch (err) {
+        if (err instanceof VoiceLayerAuthError || err instanceof VoiceLayerValidationError || err instanceof VoiceLayerHttpError && (err.status < 500 || opts.noRetryStatuses?.includes(err.status) === true)) {
+          throw err;
+        }
+        if (attempt >= this.maxRetries) {
+          if (err instanceof VoiceLayerHttpError) throw err;
+          throw new VoiceLayerNetworkError(
+            err instanceof Error ? err.message : "network error",
+            err
+          );
+        }
+        lastError = err;
+        await sleep(this.backoffMs(attempt), opts.signal);
+      }
+    }
+    throw lastError instanceof Error ? lastError : new VoiceLayerNetworkError("exhausted retries");
+  }
+  backoffMs(attempt) {
+    const base = this.initialBackoffMs * Math.pow(2, attempt);
+    const jitter2 = Math.random() * base * 0.25;
+    return Math.floor(base + jitter2);
+  }
+};
+async function safeJson(res) {
+  try {
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+function extractMessage(body, fallback) {
+  if (body && typeof body === "object" && "message" in body && typeof body.message === "string") {
+    return body.message;
+  }
+  if (body && typeof body === "object" && "error" in body && typeof body.error === "string") {
+    return body.error;
+  }
+  return fallback;
+}
+
 // src/runtime/graph/resolvers.ts
 var KB_SEARCH_PATH = "/v1/knowledge/search";
 function createKnowledgeResolver(opts) {
@@ -8492,6 +8819,50 @@ function createToolExecutor(opts) {
     }
   };
 }
+function createEmailResolver(email, opts = {}) {
+  return async (req, call) => {
+    try {
+      const sent = await email.send({ ...req, ...opts.conversationId ? { conversationId: opts.conversationId } : {} }, call?.signal ? { signal: call.signal } : {});
+      return { ok: true, emailId: sent.emailId };
+    } catch (err) {
+      if (err instanceof VoiceLayerHttpError) {
+        const body = err.body ?? {};
+        const detail = typeof body.message === "string" ? body.message : typeof body.detail === "string" ? body.detail : void 0;
+        return { ok: false, error: typeof body.error === "string" ? body.error : `http_${err.status}`, ...detail ? { detail } : {} };
+      }
+      return { ok: false, error: "email_outcome_unknown", detail: err instanceof Error ? err.message : String(err) };
+    }
+  };
+}
+var NOT_SENT = /* @__PURE__ */ new Set([
+  "invalid_email",
+  "invalid_body",
+  "from_not_verified",
+  "email_rate_limited",
+  "email_conversation_limit",
+  "email_unavailable",
+  "email_provider_error",
+  "email_send_failed",
+  "insufficient_balance",
+  "spend_cap_exceeded"
+]);
+function dedupeConversationEmails(resolver) {
+  const sends = /* @__PURE__ */ new Map();
+  return (req, opts) => {
+    const body = createHash("sha256").update(req.text).digest("hex");
+    const key = `${req.to.trim().toLowerCase()}
+${req.subject}
+${body}`;
+    const prior = sends.get(key);
+    if (prior) return prior;
+    const sending = resolver(req, opts).then((result) => {
+      if (!result.ok && NOT_SENT.has(result.error)) sends.delete(key);
+      return result;
+    });
+    sends.set(key, sending);
+    return sending;
+  };
+}
 var PLAYBOOKS_PATH = "/v1/playbooks";
 function toPlaybookResolution(pb) {
   const requiredFields = Array.from(
@@ -8637,7 +9008,7 @@ function createCodeResolver(opts) {
     }
   };
 }
-function buildGraphResolvers(credential2) {
+function buildGraphResolvers(credential2, call = {}) {
   const internalToken = process.env["INTERNAL_SERVICE_TOKEN"];
   const resolvers = {};
   resolvers.code = createCodeResolver();
@@ -8647,6 +9018,8 @@ function buildGraphResolvers(credential2) {
   }
   if (credential2) {
     const { baseUrl, apiKey } = credential2;
+    const email = new EmailClient(new Transport({ baseUrl, apiKey }));
+    resolvers.email = dedupeConversationEmails(createEmailResolver(email, call.conversationId ? { conversationId: call.conversationId } : {}));
     resolvers.knowledge = createKnowledgeResolver({ baseUrl, apiKey });
     resolvers.playbooks = createPlaybookResolver({ baseUrl, apiKey });
     resolvers.flows = createFlowResolver({ baseUrl, apiKey });
@@ -10122,174 +10495,6 @@ async function runTextTranscript(opts) {
   return { replies, outcome, trace: trace8 };
 }
 
-// src/errors.ts
-var VoiceLayerError = class extends Error {
-  name = "VoiceLayerError";
-};
-var VoiceLayerAuthError = class extends VoiceLayerError {
-  constructor(message, status) {
-    super(message);
-    this.status = status;
-  }
-  status;
-  name = "VoiceLayerAuthError";
-};
-var VoiceLayerNetworkError = class extends VoiceLayerError {
-  name = "VoiceLayerNetworkError";
-  cause;
-  constructor(message, cause) {
-    super(message);
-    this.cause = cause;
-  }
-};
-var VoiceLayerValidationError = class extends VoiceLayerError {
-  constructor(message, issues) {
-    super(message);
-    this.issues = issues;
-  }
-  issues;
-  name = "VoiceLayerValidationError";
-};
-var VoiceLayerHttpError = class extends VoiceLayerError {
-  constructor(message, status, body) {
-    super(message);
-    this.status = status;
-    this.body = body;
-  }
-  status;
-  body;
-  name = "VoiceLayerHttpError";
-};
-
-// src/transport.ts
-var DEFAULT_MAX_RETRIES = 3;
-var DEFAULT_INITIAL_BACKOFF_MS = 250;
-function buildUrl(baseUrl, path, query) {
-  const trimmedBase = baseUrl.replace(/\/+$/, "");
-  const trimmedPath = path.startsWith("/") ? path : `/${path}`;
-  let url = `${trimmedBase}${trimmedPath}`;
-  if (query) {
-    const params = new URLSearchParams();
-    for (const [k, v] of Object.entries(query)) {
-      if (v !== void 0) params.set(k, v);
-    }
-    const qs = params.toString();
-    if (qs.length > 0) url += `?${qs}`;
-  }
-  return url;
-}
-async function sleep(ms, signal) {
-  return new Promise((resolve, reject) => {
-    if (signal?.aborted) {
-      reject(new VoiceLayerNetworkError("aborted"));
-      return;
-    }
-    const t = setTimeout(() => resolve(), ms);
-    const onAbort = () => {
-      clearTimeout(t);
-      reject(new VoiceLayerNetworkError("aborted"));
-    };
-    signal?.addEventListener("abort", onAbort, { once: true });
-  });
-}
-var Transport = class {
-  constructor(options) {
-    this.options = options;
-    this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
-    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
-    this.initialBackoffMs = options.initialBackoffMs ?? DEFAULT_INITIAL_BACKOFF_MS;
-  }
-  options;
-  fetchImpl;
-  maxRetries;
-  initialBackoffMs;
-  async request(opts, schema) {
-    const url = buildUrl(this.options.baseUrl, opts.path, opts.query);
-    const headers = {
-      authorization: `Bearer ${this.options.apiKey}`,
-      "content-type": "application/json",
-      accept: "application/json"
-    };
-    if (this.options.userAgent) {
-      headers["user-agent"] = this.options.userAgent;
-    }
-    if (opts.headers) {
-      for (const [k, v] of Object.entries(opts.headers)) {
-        headers[k.toLowerCase()] = v;
-      }
-    }
-    const init = {
-      method: opts.method,
-      headers,
-      ...opts.body !== void 0 ? { body: JSON.stringify(opts.body) } : {},
-      ...opts.signal ? { signal: opts.signal } : {}
-    };
-    let lastError;
-    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-      try {
-        const res = await this.fetchImpl(url, init);
-        if (res.status === 401 || res.status === 403) {
-          const body = await safeJson(res);
-          throw new VoiceLayerAuthError(
-            extractMessage(body, `auth failed (${res.status})`),
-            res.status
-          );
-        }
-        if (res.status >= 500 && attempt < this.maxRetries) {
-          lastError = new VoiceLayerHttpError(`server error ${res.status}`, res.status, await safeJson(res));
-          await sleep(this.backoffMs(attempt), opts.signal);
-          continue;
-        }
-        if (!res.ok) {
-          const body = await safeJson(res);
-          throw new VoiceLayerHttpError(extractMessage(body, `http ${res.status}`), res.status, body);
-        }
-        const json = await res.json();
-        const parsed = schema.safeParse(json);
-        if (!parsed.success) {
-          throw new VoiceLayerValidationError("response failed schema validation", parsed.error.issues);
-        }
-        return parsed.data;
-      } catch (err) {
-        if (err instanceof VoiceLayerAuthError || err instanceof VoiceLayerValidationError || err instanceof VoiceLayerHttpError && err.status < 500) {
-          throw err;
-        }
-        if (attempt >= this.maxRetries) {
-          if (err instanceof VoiceLayerHttpError) throw err;
-          throw new VoiceLayerNetworkError(
-            err instanceof Error ? err.message : "network error",
-            err
-          );
-        }
-        lastError = err;
-        await sleep(this.backoffMs(attempt), opts.signal);
-      }
-    }
-    throw lastError instanceof Error ? lastError : new VoiceLayerNetworkError("exhausted retries");
-  }
-  backoffMs(attempt) {
-    const base = this.initialBackoffMs * Math.pow(2, attempt);
-    const jitter2 = Math.random() * base * 0.25;
-    return Math.floor(base + jitter2);
-  }
-};
-async function safeJson(res) {
-  try {
-    return await res.json();
-  } catch {
-    return null;
-  }
-}
-function extractMessage(body, fallback) {
-  if (body && typeof body === "object" && "message" in body && typeof body.message === "string") {
-    return body.message;
-  }
-  if (body && typeof body === "object" && "error" in body && typeof body.error === "string") {
-    return body.error;
-  }
-  return fallback;
-}
-
 // src/agents.ts
 init_src();
 function collectDefaultMetadata() {
@@ -11138,28 +11343,6 @@ var FormsClient = class {
     );
   }
 };
-var SendEmailResponse = z.object({
-  emailId: z.string()
-}).passthrough();
-var EmailClient = class {
-  constructor(transport) {
-    this.transport = transport;
-  }
-  transport;
-  async send(input) {
-    const body = {
-      to: input.to,
-      subject: input.subject,
-      text: input.text,
-      ...input.html !== void 0 ? { html: input.html } : {}
-    };
-    const parsed = await this.transport.request(
-      { method: "POST", path: "/v1/email/send", body },
-      SendEmailResponse
-    );
-    return { emailId: parsed.emailId };
-  }
-};
 
 // src/plans.ts
 init_src();
@@ -14746,6 +14929,24 @@ function guardedRegistryRun(run, router, observe) {
     return result;
   };
 }
+function auditedEmailResolver(resolver, observe) {
+  return async (req, opts) => {
+    const startedAt = /* @__PURE__ */ new Date();
+    const result = await resolver(req, opts);
+    observe({
+      invocationId: randomUUID(),
+      toolName: "flow.email",
+      params: { to: req.to, subject: req.subject, ...req.from ? { from: req.from } : {} },
+      ok: result.ok,
+      blocked: false,
+      result: result.ok ? { emailId: result.emailId } : { error: result.error },
+      ...result.ok ? {} : { errorMessage: result.detail ?? result.error },
+      startedAt,
+      durationMs: Date.now() - startedAt.getTime()
+    });
+    return result;
+  };
+}
 
 // src/runtime/call-room.ts
 init_src();
@@ -18112,9 +18313,14 @@ ${apology}`
       } else if (this.config.onCall) {
         await this.config.onCall(ctx);
       } else if (graphMode && graphProgram && graphEvents) {
-        const builtResolvers = buildGraphResolvers(callCredential);
+        const builtResolvers = buildGraphResolvers(callCredential, { conversationId: ctx.call.callId });
         const registry = builtResolvers?.registryTools;
-        const graphResolvers = builtResolvers && registry ? { ...builtResolvers, registryTools: { catalog: () => registry.catalog(), run: guardedRegistryRun((n, a) => registry.run(n, a), toolkit.router, toolAudit) } } : builtResolvers;
+        const email = builtResolvers?.email;
+        const graphResolvers = builtResolvers ? {
+          ...builtResolvers,
+          ...registry ? { registryTools: { catalog: () => registry.catalog(), run: guardedRegistryRun((n, a) => registry.run(n, a), toolkit.router, toolAudit) } } : {},
+          ...email ? { email: auditedEmailResolver(email, toolAudit) } : {}
+        } : builtResolvers;
         const outcome = await runFlowProgram(graphProgram, ctx, {
           processRt,
           session,