@voicelayer/sdk 0.5.0 → 0.5.1

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

@@ -1,4 +1,4 @@
-export { b0 as FlowResolver, b1 as GraphResolvers, b2 as GraphTraceEvent, b3 as KnowledgeResolver, b4 as LiveTextConversation, b5 as LiveTurnResult, b6 as PlaybookLibraryEntry, b7 as PlaybookResolver, b8 as RegistryToolsResolver, b9 as RunLiveTextOptions, af as RunTextSessionOptions, ag as RunTextTranscriptOptions, ax as TextSession, ay as TextTranscriptResult, o as ToolExecutor, ba as denyPrivateNetwork, bb as privateNetworkOptInHonoured, bc as runLiveTextConversation, aY as runTextSession, aZ as runTextTranscript, bd as runWithOpenAIScope, be as toPlaybookResolution } from '../text-session-Bf4Jni7H.js';
+export { b0 as EmailResolver, b1 as FlowResolver, b2 as GraphResolvers, b3 as GraphTraceEvent, b4 as KnowledgeResolver, b5 as LiveTextConversation, b6 as LiveTurnResult, b7 as PlaybookLibraryEntry, b8 as PlaybookResolver, b9 as RegistryToolsResolver, ba as RunLiveTextOptions, af as RunTextSessionOptions, ag as RunTextTranscriptOptions, ax as TextSession, ay as TextTranscriptResult, o as ToolExecutor, bb as dedupeConversationEmails, bc as denyPrivateNetwork, bd as privateNetworkOptInHonoured, be as runLiveTextConversation, aY as runTextSession, aZ as runTextTranscript, bf as runWithOpenAIScope, bg as toPlaybookResolution } from '../text-session-BbG3VG50.js';
 import '@livekit/agents';
 import 'zod';
 import '../types-KqrAfY85.js';

package/dist/runtime/text-session.js

@@ -9,8 +9,8 @@ import https from 'https';
 import { Readable } from 'stream';
 import { lookup } from 'dns/promises';
 import 'quickjs-emscripten';
+import { createHash, randomUUID } from 'crypto';
 import { setup, createActor } from 'xstate';
-import { randomUUID } from 'crypto';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -238,6 +238,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",
@@ -1255,6 +1257,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"() {
@@ -2003,6 +2060,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({
@@ -3776,6 +3834,7 @@ var init_src = __esm({
     init_memory();
     init_participants();
     init_forms();
+    init_email();
     init_consultation();
     init_agent_config();
     init_agent_versions();
@@ -5228,7 +5287,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();
@@ -6042,6 +6101,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"
     });
@@ -6054,6 +6171,7 @@ ${collected}`);
       handoff: handoffExecutor,
       llm: llmExecutor,
       tool: toolExecutor,
+      email: emailExecutor,
       set: setExecutor,
       subflow: subflowExecutor,
       decision: decisionExecutor,
@@ -6716,6 +6834,40 @@ init_graph_model();
 init_src();
 init_embedder();
 init_llm();
+z.object({
+  emailId: z.string()
+}).passthrough();
+
+// src/runtime/graph/resolvers.ts
+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;
+  };
+}
 function toPlaybookResolution(pb) {
   const requiredFields = Array.from(
     new Set((pb.exitConditions ?? []).flatMap((e) => e.requiredVariables ?? []))
@@ -8044,4 +8196,4 @@ function runLiveTextConversation(opts) {
   };
 }
 
-export { denyPrivateNetwork, privateNetworkOptInHonoured, runLiveTextConversation, runTextSession, runTextTranscript, runWithOpenAIScope, toPlaybookResolution };
+export { dedupeConversationEmails, denyPrivateNetwork, privateNetworkOptInHonoured, runLiveTextConversation, runTextSession, runTextTranscript, runWithOpenAIScope, toPlaybookResolution };