@voicelayer/sdk 0.1.2 → 0.1.3

package/dist/index.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import OpenAI from 'openai';
+import OpenAI2 from 'openai';
 import IORedis3 from 'ioredis';
 import os from 'os';
 import { Resend } from 'resend';
@@ -113,6 +113,9 @@ var init_flow = __esm({
     FlowStatus = z.enum(["draft", "published", "archived"]);
     z.enum(["shared", "dedicated"]);
     FlowNodeType = z.enum([
+      // Explicit entry marker — the interpreter starts here (falls back to the
+      // first indegree-0 node for older graphs without one).
+      "start",
       "say",
       "ask",
       "confirm",
@@ -203,9 +206,12 @@ var init_flow = __esm({
     });
     z.object({
       name: z.string().trim().min(1).max(200).optional(),
-      graph: FlowGraph.optional()
-    }).refine((b) => b.name !== void 0 || b.graph !== void 0, {
-      message: "provide at least one of `name` or `graph`"
+      graph: FlowGraph.optional(),
+      // Framework is a reversible default-structure switch (Voiceflow parity):
+      // changing kind re-frames the palette/deployability but never touches the graph.
+      kind: FlowKind.optional()
+    }).refine((b) => b.name !== void 0 || b.graph !== void 0 || b.kind !== void 0, {
+      message: "provide at least one of `name`, `graph`, or `kind`"
     });
     z.object({
       note: z.string().max(1e3).optional()
@@ -506,7 +512,12 @@ var init_call_events = __esm({
       // Emitted by the agent's built-in `ask_host` tool. The dashboard and MCP
       // host SSE clients filter on these to surface the "let me check" UX.
       "consultation.requested",
-      "consultation.resolved"
+      "consultation.resolved",
+      // DTMF keypad events. `dtmf.received` fires when a remote participant
+      // presses a key on their leg; `dtmf.sent` fires when our agent (or a
+      // programmatic caller via /v1/calls/:id/dtmf) emits one outbound.
+      "dtmf.received",
+      "dtmf.sent"
     ]);
     z.object({
       reason: z.string().optional(),
@@ -526,6 +537,11 @@ var init_call_events = __esm({
       // through" confirmation in the host chat).
       correlationId: z.string().optional()
     });
+    z.object({
+      digit: z.string().regex(/^[0-9*#A-D]$/),
+      code: z.number().int().min(0).max(15),
+      participantId: z.string().optional()
+    });
     z.object({
       totalUsd: z.string(),
       breakdown: z.object({
@@ -1449,6 +1465,36 @@ var init_project_limits = __esm({
     });
   }
 });
+
+// ../contracts/src/flow-ports.ts
+var init_flow_ports = __esm({
+  "../contracts/src/flow-ports.ts"() {
+  }
+});
+var FlowIssueSeverity, FlowIssue;
+var init_flow_validate = __esm({
+  "../contracts/src/flow-validate.ts"() {
+    init_flow_ports();
+    FlowIssueSeverity = z.enum(["error", "warning"]);
+    FlowIssue = z.object({
+      code: z.string().max(64),
+      severity: FlowIssueSeverity,
+      message: z.string().max(500),
+      nodeId: z.string().max(128).optional(),
+      edgeId: z.string().max(128).optional()
+    });
+    z.object({
+      valid: z.boolean(),
+      issues: z.array(FlowIssue).max(256)
+    });
+  }
+});
+
+// ../contracts/src/flow-builtins.ts
+var init_flow_builtins = __esm({
+  "../contracts/src/flow-builtins.ts"() {
+  }
+});
 var ComplianceRule, ComplianceDecision, ComplianceConfig;
 var init_compliance = __esm({
   "../contracts/src/compliance.ts"() {
@@ -1509,6 +1555,21 @@ var init_compliance = __esm({
     ComplianceConfig.partial();
   }
 });
+var init_call_recording = __esm({
+  "../contracts/src/call-recording.ts"() {
+    z.object({
+      // When false, the call-event sink skips egress entirely — no recording is made.
+      recordingEnabled: z.boolean().default(true),
+      // Optional consent preamble the agent speaks first on every call. null/empty =
+      // no announcement. Capped so it stays a short notice, not a monologue.
+      consentAnnouncement: z.string().max(1e3).nullable().default(null)
+    });
+    z.object({
+      recordingEnabled: z.boolean().optional(),
+      consentAnnouncement: z.string().max(1e3).nullable().optional()
+    });
+  }
+});
 var OutboundAmdMode;
 var init_outbound = __esm({
   "../contracts/src/outbound.ts"() {
@@ -1644,11 +1705,19 @@ function asAdherence(value) {
   return typeof value === "string" && ADHERENCE_MODES.has(value) ? value : "off";
 }
 function branchesFor(data) {
-  return Array.isArray(data.branches) ? data.branches.filter((b) => b && typeof b.id === "string" && typeof b.label === "string").map((b) => ({ id: b.id, label: b.label })) : [];
+  return Array.isArray(data.branches) ? data.branches.filter((b) => b && typeof b.id === "string" && typeof b.label === "string").map((b) => ({
+    id: b.id,
+    label: b.label,
+    ...typeof b.when === "string" && b.when.trim() ? { when: b.when } : {},
+    ...typeof b.digit === "string" && b.digit.trim() ? { digit: b.digit.trim() } : {},
+    ...typeof b.description === "string" && b.description.trim() ? { description: b.description } : {}
+  })) : [];
 }
 function nodeConfigFor(node) {
   const data = node.data;
   switch (node.type) {
+    case "start":
+      return {};
     case "say":
     case "confirm":
       return { text: typeof data.text === "string" ? data.text : "" };
@@ -1824,11 +1893,15 @@ function compileFlowToProgram(graph, id = "flow") {
       id: node.id,
       type: node.type,
       config: nodeConfigFor(node),
-      out: outBySource.get(node.id) ?? []
+      // Defensive: the FlowProgram schema caps out[] at 64 — slice rather than
+      // letting an over-wired node fail the read-side parse (which silently
+      // degrades the whole call to the generic base prompt).
+      out: (outBySource.get(node.id) ?? []).slice(0, 64)
     };
     if (UNSUPPORTED_NODE_TYPES.has(node.type)) unsupportedNodes.push(node.id);
   }
-  let entry = stepNodes.filter((n) => (indeg.get(n.id) ?? 0) === 0).map((n) => n.id);
+  const startNodes = stepNodes.filter((n) => n.type === "start").map((n) => n.id);
+  let entry = startNodes.length ? startNodes : stepNodes.filter((n) => (indeg.get(n.id) ?? 0) === 0).map((n) => n.id);
   if (entry.length === 0 && stepNodes.length > 0) entry = [stepNodes[0].id];
   const { acyclic } = planEnrichment(graph);
   const { completionGate } = compileConversationFlow(graph, id);
@@ -1838,7 +1911,13 @@ function compileFlowToProgram(graph, id = "flow") {
     entry: entry.slice(0, 64),
     nodes,
     completionGate: { requiredFields: completionGate.requiredFields.slice(0, 64) },
-    diagnostics: { acyclic, droppedEdges, unsupportedNodes }
+    // Diagnostics arrays are schema-capped at 256 — slice so a pathological
+    // graph can't fail the read-side parse.
+    diagnostics: {
+      acyclic,
+      droppedEdges: droppedEdges.slice(0, 256),
+      unsupportedNodes: unsupportedNodes.slice(0, 256)
+    }
   };
 }
 var FIELD_TYPES, HTTP_METHODS, HISTORY_POLICIES, ADHERENCE_MODES, UNSUPPORTED_NODE_TYPES, CAPABILITY_NODE_TYPES, ANNOTATION_NODE_TYPES;
@@ -2031,7 +2110,11 @@ var init_src = __esm({
     init_project_limits();
     init_flow();
     init_flow_program();
+    init_flow_ports();
+    init_flow_validate();
+    init_flow_builtins();
     init_compliance();
+    init_call_recording();
     init_outbound();
     init_connection();
     init_flow_compile();
@@ -2178,11 +2261,13 @@ function buildBuiltinScope(deps) {
   const nowIso = (/* @__PURE__ */ new Date()).toISOString();
   const today = nowIso.slice(0, 10);
   const callerId = typeof call?.callerId === "string" ? call.callerId : "";
+  const agentName = deps.ctx.metadata?.["agentName"];
   return {
     caller_id: callerId,
     from: callerId,
     to: typeof call?.to === "string" ? call.to : "",
     call_id: typeof call?.callId === "string" ? call.callId : "",
+    agent_name: typeof agentName === "string" ? agentName : "",
     channel: "voice",
     now: nowIso,
     today,
@@ -2192,6 +2277,7 @@ function buildBuiltinScope(deps) {
 }
 var init_builtins = __esm({
   "src/runtime/graph/builtins.ts"() {
+    init_src();
   }
 });
 function dotProduct(a, b) {
@@ -2222,7 +2308,7 @@ function createOpenAIEmbedder() {
       const controller = new AbortController();
       const timer = setTimeout(() => controller.abort(), EMBED_TIMEOUT_MS);
       try {
-        client ??= new OpenAI();
+        client ??= new OpenAI2();
         const res = await client.embeddings.create(
           { model: EMBED_MODEL, input: key },
           { signal: controller.signal }
@@ -2264,7 +2350,7 @@ var init_embedder = __esm({
 async function selectEdge(edges, ctx) {
   if (edges.length === 0) return null;
   const conditional = edges.filter((e) => e.condition && e.condition.trim());
-  const fallthrough = edges.find((e) => !e.condition || !e.condition.trim());
+  const fallthrough = edges.find((e) => (!e.condition || !e.condition.trim()) && !e.sourceHandle);
   const nl = [];
   for (const edge of conditional) {
     const det = evaluateDeterministicCondition(edge.condition, ctx);
@@ -2373,12 +2459,28 @@ function evaluateDeterministic(atom, ctx) {
     if (ctx.lastDtmf === void 0) return void 0;
     return ctx.lastDtmf === dtmfMatch[1].trim();
   }
-  const opMatch = atom.match(/^(!?)\s*(?:slot:)?(.+?)\s*(==|!=|=|contains)\s*(.+)$/i);
+  const opMatch = atom.match(
+    /^(!?)\s*(?:slot:)?(.+?)\s*(==|!=|=|contains|starts_with|greater_than|less_than|>=|<=|>|<)\s*(.+)$/i
+  );
   if (opMatch) {
     const [, neg, nameRaw, op, valRaw] = opMatch;
-    const value = String(resolvePath(ctx.slots, nameRaw.trim()) ?? "").toLowerCase();
+    const raw = resolvePath(ctx.slots, nameRaw.trim());
+    const value = String(raw ?? "").toLowerCase();
     const target = valRaw.trim().toLowerCase();
-    const res = op.toLowerCase() === "contains" ? value.includes(target) : op === "!=" ? value !== target : value === target;
+    const opKey = op.toLowerCase();
+    let res;
+    if (opKey === "contains") res = value.includes(target);
+    else if (opKey === "starts_with") res = value.startsWith(target);
+    else if (opKey === "greater_than" || opKey === ">" || opKey === ">=" || opKey === "less_than" || opKey === "<" || opKey === "<=") {
+      const a = Number(String(raw ?? "").replace(/[^0-9.+-]/g, ""));
+      const b = Number(valRaw.trim().replace(/[^0-9.+-]/g, ""));
+      if (Number.isNaN(a) || Number.isNaN(b)) res = false;
+      else if (opKey === "greater_than" || opKey === ">") res = a > b;
+      else if (opKey === ">=") res = a >= b;
+      else if (opKey === "less_than" || opKey === "<") res = a < b;
+      else res = a <= b;
+    } else if (opKey === "!=") res = value !== target;
+    else res = value === target;
     return neg ? !res : res;
   }
   const slotPres = atom.match(/^(!?)\s*slot:(.+?)\s*(present|empty)?$/i);
@@ -2397,6 +2499,48 @@ function evaluateDeterministic(atom, ctx) {
   }
   return void 0;
 }
+async function pickOption(options, ctx, hint) {
+  if (options.length === 0) return null;
+  const collected = Object.entries(ctx.slots).filter(([, v]) => v !== void 0 && v !== null && v !== "").map(([k, v]) => `${k.trim()}: ${String(v)}`).join("; ");
+  const list = options.map((o, i) => `${i + 1}. ${o.text}`).join("\n");
+  const prompt = [
+    "Pick which outcome best matches the current state of this voice conversation.",
+    ...hint && hint.trim() ? [`What decides the path: ${hint.trim()}`] : [],
+    `Information collected: ${collected || "(none)"}`,
+    `The caller most recently said: "${ctx.lastUtterance ?? ""}"`,
+    "Outcomes:",
+    list,
+    'Answer with ONLY the outcome number, or "none" if nothing clearly matches.'
+  ].join("\n");
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), JUDGE_TIMEOUT_MS);
+  try {
+    openaiClient ??= new OpenAI2();
+    const res = await openaiClient.chat.completions.create(
+      {
+        model: process.env["VOICELAYER_JUDGE_MODEL"] ?? "gpt-4o-mini",
+        temperature: 0,
+        max_tokens: 4,
+        messages: [
+          { role: "system", content: 'Answer with only a number, or "none".' },
+          { role: "user", content: prompt }
+        ]
+      },
+      { signal: controller.signal }
+    );
+    const answer = (res.choices[0]?.message?.content ?? "").trim().toLowerCase();
+    const n = Number.parseInt(answer.replace(/[^0-9]/g, ""), 10);
+    if (!Number.isInteger(n) || n < 1 || n > options.length) return null;
+    return options[n - 1]?.id ?? null;
+  } catch (err) {
+    console.warn("[graph] option pick failed; treating as undecided", {
+      err: err instanceof Error ? err.message : String(err)
+    });
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
 async function judge(condition, ctx) {
   const collected = Object.entries(ctx.slots).filter(([, v]) => v !== void 0 && v !== null && v !== "").map(([k, v]) => `${k.trim()}: ${String(v)}`).join("; ");
   const prompt = [
@@ -2409,7 +2553,7 @@ async function judge(condition, ctx) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), JUDGE_TIMEOUT_MS);
   try {
-    openaiClient ??= new OpenAI();
+    openaiClient ??= new OpenAI2();
     const res = await openaiClient.chat.completions.create(
       {
         model: process.env["VOICELAYER_JUDGE_MODEL"] ?? "gpt-4o-mini",
@@ -2443,6 +2587,65 @@ var init_conditions = __esm({
   }
 });
 
+// src/runtime/graph/branch-resolve.ts
+function branchOptionsOf(config) {
+  if (!Array.isArray(config.branches)) return [];
+  return config.branches.filter((b) => b && typeof b.id === "string" && typeof b.label === "string").map((b) => ({
+    id: b.id,
+    label: b.label,
+    ...typeof b.when === "string" && b.when.trim() ? { when: b.when } : {},
+    ...typeof b.digit === "string" && b.digit.trim() ? { digit: b.digit.trim() } : {}
+  }));
+}
+async function resolveBranch(branches, ctx, opts) {
+  const candidates = branches.filter((b) => b.id !== ELSE_BRANCH_ID);
+  if (candidates.length === 0) return null;
+  const nl = [];
+  for (const b of candidates) {
+    if (b.when && b.when.trim()) {
+      const det = evaluateDeterministicCondition(b.when, ctx);
+      if (det === true) return b.id;
+      if (det === void 0) nl.push(b);
+    } else {
+      nl.push(b);
+    }
+  }
+  if (nl.length === 0) return null;
+  const utterance = ctx.lastUtterance?.trim();
+  if (utterance) {
+    const embedder = getEmbedder();
+    if (embedder.available) {
+      const uvec = await embedder.embed(utterance);
+      if (uvec) {
+        let best = null;
+        for (const b of nl) {
+          const bvec = await embedder.embed(b.when?.trim() || b.label);
+          if (!bvec) continue;
+          const score = dotProduct(uvec, bvec);
+          if (!best || score > best.score) best = { id: b.id, score };
+        }
+        if (best && best.score >= ROUTE_THRESHOLD) {
+          console.log("[graph] branch: embedding", { id: best.id, score: Number(best.score.toFixed(3)) });
+          return best.id;
+        }
+      }
+    }
+  }
+  return pickOption(
+    nl.map((b) => ({ id: b.id, text: b.when?.trim() || b.label })),
+    ctx,
+    opts?.hint
+  );
+}
+var ELSE_BRANCH_ID;
+var init_branch_resolve = __esm({
+  "src/runtime/graph/branch-resolve.ts"() {
+    init_conditions();
+    init_embedder();
+    ELSE_BRANCH_ID = "else";
+  }
+});
+
 // src/runtime/graph/drift.ts
 function adherenceOf(node) {
   const a = node.config.adherence;
@@ -2490,6 +2693,22 @@ function scopeFor(state, deps) {
 function str(value) {
   return typeof value === "string" ? value : "";
 }
+function evalCtxOf(state, deps) {
+  return {
+    slots: deps.processRt.getData(),
+    tools: state.toolResults,
+    nodeResults: state.nodeResults,
+    ...state.lastUtterance !== void 0 ? { lastUtterance: state.lastUtterance } : {},
+    ...state.lastDtmf !== void 0 ? { lastDtmf: state.lastDtmf } : {}
+  };
+}
+function deterministicEdgeTarget(edges, ctx) {
+  for (const e of edges) {
+    if (!e.condition || !e.condition.trim()) continue;
+    if (evaluateDeterministicCondition(e.condition, ctx) === true) return e.to;
+  }
+  return null;
+}
 async function speak(text, deps) {
   if (!text.trim()) return;
   const session = deps.ctx.livekit.session;
@@ -2526,6 +2745,13 @@ async function nextTurn(deps, reprompt) {
     return { text: evt.text };
   }
 }
+function detectYesNo(text) {
+  const yes = YES_WORDS.test(text);
+  const no = NO_WORDS.test(text);
+  if (yes && !no) return "yes";
+  if (no && !yes) return "no";
+  return null;
+}
 function formatCollected(slots) {
   return Object.entries(slots).filter(([, v]) => v !== void 0 && v !== null && v !== "").map(([k, v]) => `${k.trim()}: ${String(v)}`).join("\n");
 }
@@ -2564,12 +2790,21 @@ ${intent}`
 function routeByPort(node, deps, port) {
   return deps.model.selectByPort(node.id, port) !== null ? { kind: "take", port } : { kind: "advance" };
 }
-var ASK_MAX_CLARIFY, LLM_MAX_TURNS, HUB_MAX_TURNS, NO_INPUT_MS, sayExecutor, askExecutor, gateExecutor, endExecutor, handoffExecutor, llmExecutor, toolExecutor, ragExecutor, codeExecutor, classifyExecutor, routerExecutor, playbookExecutor, setExecutor, MAX_SUBFLOW_DEPTH, subflowExecutor, passthroughExecutor, EXECUTORS;
+function menuDigitOf(b) {
+  if (b.digit && b.digit.trim()) return b.digit.trim();
+  const m = b.label.match(/^\s*([0-9*#])\b/);
+  return m ? m[1] : null;
+}
+function menuLabelOf(label) {
+  return label.replace(/^\s*[0-9*#]\s*[-—–:.]*\s*/, "").trim() || label.trim();
+}
+var ASK_MAX_CLARIFY, LLM_MAX_TURNS, HUB_MAX_TURNS, NO_INPUT_MS, sayExecutor, YES_WORDS, NO_WORDS, confirmExecutor, askExecutor, gateExecutor, endExecutor, handoffExecutor, llmExecutor, toolExecutor, ragExecutor, codeExecutor, decisionExecutor, MENU_MAX_INPUTS, menuExecutor, classifyExecutor, routerExecutor, playbookExecutor, setExecutor, MAX_SUBFLOW_DEPTH, subflowExecutor, passthroughExecutor, EXECUTORS;
 var init_executors = __esm({
   "src/runtime/graph/executors.ts"() {
     init_interpolate();
     init_builtins();
     init_conditions();
+    init_branch_resolve();
     init_drift();
     init_define_tool();
     ASK_MAX_CLARIFY = 4;
@@ -2580,6 +2815,42 @@ var init_executors = __esm({
       await speak(interpolate(str(node.config.text), scopeFor(state, deps)), deps);
       return { kind: "advance" };
     };
+    YES_WORDS = /\b(yes|yeah|yep|yup|correct|right|exactly|sure|affirmative|that'?s right|sounds good|ok(?:ay)?)\b/i;
+    NO_WORDS = /\b(no|nope|nah|wrong|incorrect|negative|not right|that'?s not|change|actually)\b/i;
+    confirmExecutor = async (node, state, deps) => {
+      const text = interpolate(str(node.config.text), scopeFor(state, deps));
+      await speak(text || "Is that correct?", deps);
+      for (let attempt = 0; attempt < 2; attempt++) {
+        const t = await nextTurn(deps, text || "Is that correct?");
+        if ("result" in t) return t.result;
+        state.lastUtterance = t.text;
+        state.lastDtmf = t.dtmf;
+        let verdict = null;
+        if (t.dtmf === "1") verdict = "yes";
+        else if (t.dtmf === "2") verdict = "no";
+        else if (t.text.trim()) verdict = detectYesNo(t.text);
+        if (verdict === null && t.text.trim()) {
+          verdict = await resolveBranch(
+            [
+              { id: "yes", label: "The caller confirms \u2014 the detail is correct." },
+              { id: "no", label: "The caller says it is wrong or wants to change it." }
+            ],
+            evalCtxOf(state, deps)
+          );
+        }
+        if (verdict === "yes") {
+          deps.events.note("confirm.confirmed", { node: node.id });
+          return routeByPort(node, deps, "yes");
+        }
+        if (verdict === "no") {
+          deps.events.note("confirm.denied", { node: node.id });
+          return routeByPort(node, deps, "no");
+        }
+        if (attempt === 0) await speak("Sorry \u2014 is that correct? Yes or no.", deps);
+      }
+      deps.events.note("confirm.unresolved", { node: node.id });
+      return { kind: "advance" };
+    };
     askExecutor = async (node, state, deps) => {
       const slot = str(node.config.slot) || node.id;
       if (hasSlot(deps.processRt.getData(), slot)) {
@@ -2686,11 +2957,60 @@ ${collected}`);
     toolExecutor = async (node, state, deps) => {
       const cfg = node.config;
       const name = str(cfg.name) || node.id;
+      const routeByOutcome = () => {
+        const ok = state.toolResults[node.id]?.ok === true;
+        return routeByPort(node, deps, ok ? "ok" : "fail");
+      };
+      const url = str(cfg.url);
+      if (!url) {
+        state.toolResults[node.id] = { ok: false, status: 0, data: null };
+        deps.events.note("tool.errored", { node: node.id, name, error: "no url" });
+        return routeByOutcome();
+      }
+      const inputSpec = cfg.input && typeof cfg.input === "object" ? cfg.input : {};
+      const slots = deps.processRt.getData();
+      const bag = {};
+      for (const field of Object.keys(inputSpec)) {
+        const v = resolvePath(slots, field);
+        if (v !== void 0 && v !== null && v !== "") bag[field] = v;
+      }
+      const cfgHeaders = cfg.headers && typeof cfg.headers === "object" ? cfg.headers : {};
+      const method = str(cfg.method) || "POST";
+      const auth = cfg.auth === "connection" ? "connection" : void 0;
+      const connectionRef = str(cfg.connectionRef);
+      deps.events.note("tool.invoked", { node: node.id, name });
+      const serverExec = deps.resolvers?.toolExecutor;
+      if (serverExec) {
+        try {
+          const result = await serverExec({
+            name,
+            url,
+            method,
+            ...Object.keys(cfgHeaders).length ? { headers: cfgHeaders } : {},
+            ...Object.keys(bag).length ? { input: bag } : {},
+            ...auth ? { auth } : {},
+            ...auth && connectionRef ? { connectionRef } : {}
+          });
+          state.toolResults[node.id] = result;
+          deps.events.note(result.ok ? "tool.succeeded" : "tool.errored", {
+            node: node.id,
+            name,
+            status: result.status
+          });
+        } catch (err) {
+          state.toolResults[node.id] = {
+            ok: false,
+            status: 0,
+            data: { error: err instanceof Error ? err.message : String(err) }
+          };
+          deps.events.note("tool.errored", { node: node.id, name });
+        }
+        return routeByOutcome();
+      }
       let authHeaders = {};
-      if (cfg.auth === "connection") {
-        const ref = str(cfg.connectionRef);
+      if (auth === "connection") {
         const resolver = deps.resolvers?.secrets;
-        const resolved = ref && resolver ? await resolver(ref) : null;
+        const resolved = connectionRef && resolver ? await resolver(connectionRef) : null;
         if (!resolved || !resolved.ok) {
           state.toolResults[node.id] = {
             ok: false,
@@ -2701,27 +3021,11 @@ ${collected}`);
             }
           };
           deps.events.note("tool.unavailable", { node: node.id, name });
-          return { kind: "advance" };
+          return routeByOutcome();
         }
         authHeaders = resolved.headers;
       }
-      const url = str(cfg.url);
-      if (!url) {
-        state.toolResults[node.id] = { ok: false, status: 0, data: null };
-        deps.events.note("tool.errored", { node: node.id, name, error: "no url" });
-        return { kind: "advance" };
-      }
-      const inputSpec = cfg.input && typeof cfg.input === "object" ? cfg.input : {};
-      const slots = deps.processRt.getData();
-      const bag = {};
-      for (const field of Object.keys(inputSpec)) {
-        const v = resolvePath(slots, field);
-        if (v !== void 0 && v !== null && v !== "") bag[field] = v;
-      }
-      const cfgHeaders = cfg.headers && typeof cfg.headers === "object" ? cfg.headers : {};
       const headers = { ...cfgHeaders, ...authHeaders };
-      const method = str(cfg.method) || "POST";
-      deps.events.note("tool.invoked", { node: node.id, name });
       try {
         const def = httpTool({
           name,
@@ -2747,7 +3051,7 @@ ${collected}`);
         };
         deps.events.note("tool.errored", { node: node.id, name });
       }
-      return { kind: "advance" };
+      return routeByOutcome();
     };
     ragExecutor = async (node, state, deps) => {
       const cfg = node.config;
@@ -2802,7 +3106,7 @@ ${collected}`);
         if (res.ok) {
           state.nodeResults[node.id] = { ok: true, ...res.outputs };
           deps.events.note("code.ok", { node: node.id });
-          return res.next ? routeByPort(node, deps, res.next) : { kind: "advance" };
+          return routeByPort(node, deps, res.next ?? "next");
         }
         state.nodeResults[node.id] = { ok: false, error: res.error };
         deps.events.note("code.errored", { node: node.id });
@@ -2813,25 +3117,85 @@ ${collected}`);
         return routeByPort(node, deps, "error");
       }
     };
+    decisionExecutor = async (node, state, deps) => {
+      const ctx = evalCtxOf(state, deps);
+      const det = deterministicEdgeTarget(deps.model.out(node.id), ctx);
+      if (det !== null) {
+        deps.events.note("decision.routed", { node: node.id, to: det });
+        return { kind: "goto", to: det };
+      }
+      const branches = branchOptionsOf(node.config);
+      if (branches.length === 0) return { kind: "advance" };
+      const choice = await resolveBranch(branches, ctx, { hint: str(node.config.condition) });
+      if (choice) {
+        state.nodeResults[node.id] = { choice };
+        deps.events.note("decision.routed", { node: node.id, choice });
+        return { kind: "take", port: choice };
+      }
+      if (branches.some((b) => b.id === ELSE_BRANCH_ID)) {
+        deps.events.note("decision.defaulted", { node: node.id });
+        return { kind: "take", port: ELSE_BRANCH_ID };
+      }
+      deps.events.note("decision.unresolved", { node: node.id });
+      return { kind: "advance" };
+    };
+    MENU_MAX_INPUTS = 3;
+    menuExecutor = async (node, state, deps) => {
+      const branches = branchOptionsOf(node.config);
+      const fallback = () => branches.some((b) => b.id === ELSE_BRANCH_ID) ? { kind: "take", port: ELSE_BRANCH_ID } : { kind: "advance" };
+      const keyed = branches.filter((b) => b.id !== ELSE_BRANCH_ID && menuDigitOf(b));
+      const synthesized = keyed.length ? `Please choose: ${keyed.map((b) => `press ${menuDigitOf(b)} for ${menuLabelOf(b.label)}`).join(", ")}.` : "";
+      const prompt = interpolate(str(node.config.prompt), scopeFor(state, deps)).trim() || synthesized;
+      await speak(prompt, deps);
+      if (branches.length === 0) return { kind: "advance" };
+      for (let attempt = 0; attempt < MENU_MAX_INPUTS; attempt++) {
+        const t = await nextTurn(deps, prompt);
+        if ("result" in t) return t.result;
+        state.lastUtterance = t.text;
+        state.lastDtmf = t.dtmf;
+        if (t.dtmf) {
+          const hit = branches.find((b) => b.id !== ELSE_BRANCH_ID && menuDigitOf(b) === t.dtmf);
+          if (hit) {
+            deps.events.note("menu.selected", { node: node.id, digit: t.dtmf, choice: hit.id });
+            return { kind: "take", port: hit.id };
+          }
+          deps.events.note("menu.invalid", { node: node.id, digit: t.dtmf });
+          await speak("Sorry, that's not one of the options.", deps);
+          continue;
+        }
+        if (t.text.trim()) {
+          const choice = await resolveBranch(branches, evalCtxOf(state, deps));
+          if (choice) {
+            deps.events.note("menu.selected", { node: node.id, choice });
+            return { kind: "take", port: choice };
+          }
+          await speak(prompt, deps);
+        }
+      }
+      deps.events.note("menu.unmatched", { node: node.id });
+      return fallback();
+    };
     classifyExecutor = async (node, state, deps) => {
       const cfg = node.config;
       const resolver = deps.resolvers?.classify;
-      const branches = Array.isArray(cfg.branches) ? cfg.branches.filter((b) => b && typeof b.id === "string" && typeof b.label === "string").map((b) => ({ id: b.id, label: b.label })) : [];
-      if (!resolver || branches.length === 0) {
+      const branches = branchOptionsOf(cfg);
+      const options = branches.filter((b) => b.id !== ELSE_BRANCH_ID).map((b) => ({ id: b.id, label: b.label }));
+      const fallback = () => branches.some((b) => b.id === ELSE_BRANCH_ID) ? { kind: "take", port: ELSE_BRANCH_ID } : { kind: "advance" };
+      if (!resolver || options.length === 0) {
         deps.events.note("classify.unavailable", { node: node.id });
-        return { kind: "advance" };
+        return fallback();
       }
-      deps.events.note("classify.start", { node: node.id, options: branches.length });
+      deps.events.note("classify.start", { node: node.id, options: options.length });
       try {
         const choice = await resolver({
           instructions: str(cfg.instructions),
-          options: branches,
+          options,
           ...state.lastUtterance !== void 0 ? { lastUtterance: state.lastUtterance } : {},
           slots: deps.processRt.getData()
         });
         if (!choice) {
           deps.events.note("classify.undecided", { node: node.id });
-          return { kind: "advance" };
+          return fallback();
         }
         state.nodeResults[node.id] = { choice };
         deps.events.note("classify.chose", { node: node.id, choice });
@@ -2841,7 +3205,7 @@ ${collected}`);
           node: node.id,
           error: err instanceof Error ? err.message : String(err)
         });
-        return { kind: "advance" };
+        return fallback();
       }
     };
     routerExecutor = async (node, state, deps) => {
@@ -2851,21 +3215,23 @@ ${collected}`);
         // Match on the rich skill description when present; fall back to the label.
         label: typeof b.description === "string" && b.description.trim() ? b.description : b.label
       })) : [];
-      if (!resolver || branches.length === 0) {
+      const options = branches.filter((b) => b.id !== ELSE_BRANCH_ID);
+      const fallback = () => branches.some((b) => b.id === ELSE_BRANCH_ID) ? { kind: "take", port: ELSE_BRANCH_ID } : { kind: "advance" };
+      if (!resolver || options.length === 0) {
         deps.events.note("router.unavailable", { node: node.id });
-        return { kind: "advance" };
+        return fallback();
       }
-      deps.events.note("router.start", { node: node.id, skills: branches.length });
+      deps.events.note("router.start", { node: node.id, skills: options.length });
       try {
         const choice = await resolver({
           instructions: str(node.config.instructions),
-          options: branches,
+          options,
           ...state.lastUtterance !== void 0 ? { lastUtterance: state.lastUtterance } : {},
           slots: deps.processRt.getData()
         });
         if (!choice) {
           deps.events.note("router.undecided", { node: node.id });
-          return { kind: "advance" };
+          return fallback();
         }
         state.nodeResults[node.id] = { choice };
         deps.events.note("router.routed", { node: node.id, choice });
@@ -2875,7 +3241,7 @@ ${collected}`);
           node: node.id,
           error: err instanceof Error ? err.message : String(err)
         });
-        return { kind: "advance" };
+        return fallback();
       }
     };
     playbookExecutor = async (node, state, deps) => {
@@ -2921,14 +3287,25 @@ ${collected}`);
           deps.events.note("playbook.gated", { node: node.id, missing: stillMissing.map((m) => m.trim()) });
           continue;
         }
-        if (conditional.length > 0) {
-          const target = await selectEdge(out, {
-            slots: deps.processRt.getData(),
-            tools: state.toolResults,
-            nodeResults: state.nodeResults,
-            lastDtmf: state.lastDtmf,
-            lastUtterance: state.lastUtterance
-          });
+        const exitCtx = evalCtxOf(state, deps);
+        const det = deterministicEdgeTarget(out, exitCtx);
+        if (det !== null) {
+          deps.events.note("playbook.exit", { node: node.id, to: det });
+          return { kind: "goto", to: det };
+        }
+        const branches = branchOptionsOf(cfg);
+        if (branches.length > 0) {
+          const choice = await resolveBranch(branches, exitCtx, { hint: goal || instr });
+          if (choice) {
+            deps.events.note("playbook.exit", { node: node.id, port: choice });
+            return { kind: "take", port: choice };
+          }
+          if (branches.some((b) => b.id === ELSE_BRANCH_ID)) {
+            deps.events.note("playbook.exit", { node: node.id, port: ELSE_BRANCH_ID });
+            return { kind: "take", port: ELSE_BRANCH_ID };
+          }
+        } else if (conditional.length > 0) {
+          const target = await selectEdge(out, exitCtx);
           if (target) {
             deps.events.note("playbook.exit", { node: node.id, to: target });
             return { kind: "goto", to: target };
@@ -2989,7 +3366,7 @@ ${collected}`);
     });
     EXECUTORS = {
       say: sayExecutor,
-      confirm: sayExecutor,
+      confirm: confirmExecutor,
       ask: askExecutor,
       gate: gateExecutor,
       end: endExecutor,
@@ -2998,6 +3375,8 @@ ${collected}`);
       tool: toolExecutor,
       set: setExecutor,
       subflow: subflowExecutor,
+      decision: decisionExecutor,
+      menu: menuExecutor,
       // Agentic / data nodes — execute by default (no feature flag; the platform is
       // pre-customer, so these ship on rather than dark). Each degrades to a recorded
       // no-op when its resolver/config is absent, so they never throw.
@@ -3006,8 +3385,8 @@ ${collected}`);
       classify: classifyExecutor,
       router: routerExecutor,
       playbook: playbookExecutor
-      // decision/menu/route have no executor — they advance and the interpreter's
-      // condition-aware selectEdge picks the matching outgoing edge.
+      // start (explicit entry marker) and route (routing-plane legacy) have no
+      // executor — they pass through and the default edge / selectEdge routes.
     };
   }
 });
@@ -3025,7 +3404,7 @@ async function selectNext(model, from, result, state, deps) {
   if (result.kind === "take") {
     const target = model.selectByPort(from, result.port);
     if (target !== null) return target;
-    const def = model.out(from).find((e) => !e.condition || !e.condition.trim());
+    const def = model.out(from).find((e) => (!e.condition || !e.condition.trim()) && !e.sourceHandle);
     return def ? def.to : null;
   }
   return selectEdge(model.out(from), {
@@ -3982,6 +4361,7 @@ z.object({
   updatedAt: z.string()
 });
 var CallStateSyncResponse = z.object({ ok: z.literal(true) }).or(z.object({}).passthrough());
+var DtmfEventResponse = z.object({ accepted: z.literal(true) }).or(z.object({}).passthrough());
 var CallEventEnvelopeResponse = z.object({
   event: z.object({
     seq: z.number(),
@@ -4056,6 +4436,21 @@ var CallsClient = class {
       TranscriptSegmentResponse
     );
   }
+  async appendDtmfEvent(callId, input) {
+    await this.transport.request(
+      {
+        method: "POST",
+        path: `/v1/calls/${encodeURIComponent(callId)}/dtmf-events`,
+        body: {
+          direction: input.direction,
+          digit: input.digit,
+          code: input.code,
+          ...input.participantId !== void 0 ? { participantId: input.participantId } : {}
+        }
+      },
+      DtmfEventResponse
+    );
+  }
   /**
    * Append a structured call event. Today the API accepts consultation
    * lifecycle kinds only — see apps/api/src/routes/calls.ts AppendEventBody.
@@ -4246,6 +4641,22 @@ var ConnectionsClient = class {
     }
   }
 };
+
+// src/runtime/session-adapter.ts
+var LK_AGENT_STATE_MAP = {
+  initializing: "initializing",
+  idle: "idle",
+  listening: "listening",
+  thinking: "thinking",
+  speaking: "speaking"
+};
+var NON_BUSY_STATES = /* @__PURE__ */ new Set([
+  "idle",
+  "listening"
+]);
+function normalizeState(raw) {
+  return LK_AGENT_STATE_MAP[raw] ?? "thinking";
+}
 var DEFAULT_OTLP_ENDPOINT = "https://otel.vlayers.ai/v1/otlp";
 var started = false;
 var sdk = null;
@@ -5305,6 +5716,7 @@ function createRailController(deps) {
 
 // src/runtime/graph/index.ts
 init_conditions();
+init_branch_resolve();
 init_embedder();
 init_drift();
 init_interpolate();
@@ -5365,6 +5777,36 @@ function createSecretResolver(opts) {
     }
   };
 }
+var TOOL_EXECUTE_PATH = "/v1/internal/tools/execute";
+function createToolExecutor(opts) {
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const url = opts.baseUrl.replace(/\/+$/, "") + TOOL_EXECUTE_PATH;
+  return async (req) => {
+    try {
+      const res = await fetchImpl(url, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${opts.apiKey}`,
+          "x-internal-token": opts.internalToken
+        },
+        body: JSON.stringify(req)
+      });
+      if (!res.ok) {
+        return { ok: false, status: res.status, data: { kind: "executor_error", reason: `tool execute failed (${res.status})` } };
+      }
+      const body = await res.json();
+      const r = body.result;
+      return { ok: r?.ok ?? false, status: r?.status ?? 0, data: r?.data ?? null };
+    } catch (err) {
+      return {
+        ok: false,
+        status: 0,
+        data: { kind: "executor_error", reason: err instanceof Error ? err.message : String(err) }
+      };
+    }
+  };
+}
 var PLAYBOOKS_PATH = "/v1/playbooks";
 function createPlaybookResolver(opts) {
   const fetchImpl = opts.fetchImpl ?? fetch;
@@ -5446,8 +5888,12 @@ function createCodeResolver(opts) {
         const jsonStr = vm.dump(res.value);
         res.value.dispose();
         const parsed = typeof jsonStr === "string" ? JSON.parse(jsonStr) : null;
+        if (Array.isArray(parsed) && parsed.length === 1 && typeof parsed[0] === "string") {
+          return { ok: true, outputs: {}, next: parsed[0] };
+        }
         const outputs = parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : { value: parsed };
-        return { ok: true, outputs };
+        const next = typeof outputs["next"] === "string" ? outputs["next"] : void 0;
+        return { ok: true, outputs, ...next ? { next } : {} };
       } finally {
         vm.dispose();
         runtime.dispose();
@@ -5472,6 +5918,7 @@ function buildGraphResolvers() {
     resolvers.flows = createFlowResolver({ baseUrl, apiKey });
     if (internalToken) {
       resolvers.secrets = createSecretResolver({ baseUrl, apiKey, internalToken });
+      resolvers.toolExecutor = createToolExecutor({ baseUrl, apiKey, internalToken });
     }
   }
   return Object.keys(resolvers).length > 0 ? resolvers : void 0;
@@ -8249,7 +8696,7 @@ function createProcessRuntime(def) {
   void primitive.loadSchema(schema);
   let completed = false;
   let openai2 = null;
-  const getOpenAi = () => openai2 ??= new OpenAI();
+  const getOpenAi = () => openai2 ??= new OpenAI2();
   return {
     augmentPrompt(basePrompt) {
       const lines = Object.entries(def.collect).map(([name, field]) => {
@@ -9070,6 +9517,8 @@ function makeNoopHandle(callId) {
     publish() {
     },
     syncState() {
+    },
+    publishDtmf() {
     }
   };
 }
@@ -9109,6 +9558,15 @@ async function createCallSyncHandle(init) {
           err: err instanceof Error ? err.message : err
         });
       });
+    },
+    publishDtmf(input) {
+      void init.client.calls.appendDtmfEvent(callId, input).catch((err) => {
+        console.warn("[sdk.call-sync] dtmf publish failed", {
+          direction: input.direction,
+          digit: input.digit,
+          err: err instanceof Error ? err.message : err
+        });
+      });
     }
   };
 }
@@ -9841,18 +10299,26 @@ var defaultClock = {
   clearTimeout: (h) => clearTimeout(h)
 };
 var GUARANTEE_RETRY_MS = 1500;
+var DEFAULT_MAX_CALL_DURATION_MS = 36e5;
 function createEndCallController(deps) {
   const clock = deps.clock ?? defaultClock;
   const log = deps.log ?? (() => {
   });
   let ended = false;
   let idleTimer = null;
+  let durationTimer = null;
   const clearIdle = () => {
     if (idleTimer !== null) {
       clock.clearTimeout(idleTimer);
       idleTimer = null;
     }
   };
+  const clearDuration = () => {
+    if (durationTimer !== null) {
+      clock.clearTimeout(durationTimer);
+      durationTimer = null;
+    }
+  };
   const sleep2 = (ms) => new Promise((resolve) => {
     clock.setTimeout(resolve, ms);
   });
@@ -9874,6 +10340,7 @@ function createEndCallController(deps) {
     if (ended) return;
     ended = true;
     clearIdle();
+    clearDuration();
     const info = {
       ...opts?.reason !== void 0 ? { reason: opts.reason } : {},
       trigger: opts?.trigger ?? "user",
@@ -9913,6 +10380,18 @@ function createEndCallController(deps) {
     cancelIdle() {
       clearIdle();
     },
+    armDuration() {
+      if (ended || deps.maxCallDurationMs === false) return;
+      clearDuration();
+      const durationMs = deps.maxCallDurationMs ?? DEFAULT_MAX_CALL_DURATION_MS;
+      durationTimer = clock.setTimeout(() => {
+        durationTimer = null;
+        void hangUp({
+          trigger: "max_duration",
+          reason: `call exceeded the ${durationMs}ms duration ceiling`
+        });
+      }, durationMs);
+    },
     noteEngineClosed() {
       if (ended) return;
       log("[agent] realtime engine closed; guaranteeing teardown");
@@ -9920,6 +10399,7 @@ function createEndCallController(deps) {
     },
     dispose() {
       clearIdle();
+      clearDuration();
     }
   };
 }
@@ -10026,6 +10506,8 @@ var Agent = class {
     let effectiveConfig = this.config;
     let graphMode = false;
     let graphProgram;
+    let flowBootFailure = null;
+    let flowAgentName = null;
     let loadedPlan = null;
     const planIdValue = stringValue(dispatchMdEarly["planId"]);
     if (planIdValue && sdkClient) {
@@ -10052,56 +10534,84 @@ var Agent = class {
         });
       }
     }
-    if (this.config.flowRuntime && !loadedPlan && sdkClient) {
+    if (this.config.flowRuntime && !loadedPlan) {
       const flowAgentId = stringValue(dispatchMdEarly["agentId"]);
-      if (flowAgentId) {
-        try {
-          const schema = await sdkClient.agents.getProcessSchema(flowAgentId);
-          if (schema) {
-            const graphOn = process.env["VL_FLOW_GRAPH_RUNTIME"] === "1" && !!schema.program;
-            const parts = processSchemaToAgentParts(schema, {
-              ...this.config.flowRuntime.basePrompt ? { basePrompt: this.config.flowRuntime.basePrompt } : {},
-              ...graphOn && schema.program ? { graphNodeIds: new Set(Object.keys(schema.program.nodes)) } : {}
-            });
-            effectiveConfig = {
-              ...effectiveConfig,
-              prompt: parts.prompt,
-              process: parts.process,
-              ...parts.triggers ? { triggers: parts.triggers } : {},
-              ...parts.handoff ? { handoff: parts.handoff } : {},
-              ...parts.memory ? { memory: parts.memory } : {},
-              ...parts.tools ? { tools: { ...effectiveConfig.tools ?? {}, ...parts.tools } } : {}
-            };
-            console.log("[agent] booted from flow", {
-              agentId: flowAgentId,
-              fields: Object.keys(parts.process.collect).length,
-              triggers: Object.keys(parts.triggers ?? {}).length
-            });
-            effectiveConfig = await applyStoredPipeline(
-              sdkClient,
-              flowAgentId,
-              effectiveConfig,
-              void 0
-            );
-            if (graphOn && schema.program) {
-              graphProgram = schema.program;
-              graphMode = true;
-              console.log("[agent] flow graph runtime enabled", {
-                agentId: flowAgentId,
-                nodes: Object.keys(schema.program.nodes).length,
-                entryNodes: schema.program.entry.length
-              });
-            }
-          } else {
-            console.warn("[agent] flowRuntime: agent has no process_schema", {
-              agentId: flowAgentId
-            });
+      if (!sdkClient) {
+        flowBootFailure = "no_api_key";
+        console.error(
+          "[agent] flowRuntime: VOICELAYER_API_KEY is not set \u2014 cannot resolve the flow schema; answering with an apology and ending the call."
+        );
+      } else if (!flowAgentId) {
+        flowBootFailure = "missing_agent_id";
+        console.error(
+          "[agent] flowRuntime: dispatch metadata carries no agentId \u2014 cannot resolve which flow to run.",
+          { room: job.room.name ?? null }
+        );
+      } else {
+        let schema = null;
+        let fetchError = null;
+        for (let attempt = 0; attempt < 2; attempt++) {
+          try {
+            schema = await sdkClient.agents.getProcessSchema(flowAgentId);
+            fetchError = null;
+            break;
+          } catch (err) {
+            fetchError = err;
+            await new Promise((resolve) => setTimeout(resolve, 500));
           }
-        } catch (err) {
-          console.warn("[agent] flow schema fetch failed; using base config", {
+        }
+        if (fetchError) {
+          flowBootFailure = "schema_fetch_failed";
+          console.error("[agent] flowRuntime: flow schema fetch failed after retry", {
             agentId: flowAgentId,
-            err: err instanceof Error ? err.message : String(err)
+            err: fetchError instanceof Error ? fetchError.message : String(fetchError)
+          });
+        } else if (!schema) {
+          flowBootFailure = "no_process_schema";
+          console.error(
+            "[agent] flowRuntime: agent has no process_schema (wrong agentId, or the flow was never deployed)",
+            { agentId: flowAgentId }
+          );
+        } else {
+          const graphOn = process.env["VL_FLOW_GRAPH_RUNTIME"] !== "0" && !!schema.program;
+          const parts = processSchemaToAgentParts(schema, {
+            ...this.config.flowRuntime.basePrompt ? { basePrompt: this.config.flowRuntime.basePrompt } : {},
+            ...graphOn && schema.program ? { graphNodeIds: new Set(Object.keys(schema.program.nodes)) } : {}
           });
+          effectiveConfig = {
+            ...effectiveConfig,
+            prompt: parts.prompt,
+            process: parts.process,
+            ...parts.triggers ? { triggers: parts.triggers } : {},
+            ...parts.handoff ? { handoff: parts.handoff } : {},
+            ...parts.memory ? { memory: parts.memory } : {},
+            ...parts.tools ? { tools: { ...effectiveConfig.tools ?? {}, ...parts.tools } } : {}
+          };
+          console.log("[agent] booted from flow", {
+            agentId: flowAgentId,
+            fields: Object.keys(parts.process.collect).length,
+            triggers: Object.keys(parts.triggers ?? {}).length
+          });
+          effectiveConfig = await applyStoredPipeline(
+            sdkClient,
+            flowAgentId,
+            effectiveConfig,
+            void 0
+          );
+          try {
+            flowAgentName = (await sdkClient.agents.getConfig(flowAgentId))?.name ?? null;
+          } catch {
+            flowAgentName = null;
+          }
+          if (graphOn && schema.program) {
+            graphProgram = schema.program;
+            graphMode = true;
+            console.log("[agent] flow graph runtime enabled", {
+              agentId: flowAgentId,
+              nodes: Object.keys(schema.program.nodes).length,
+              entryNodes: schema.program.entry.length
+            });
+          }
         }
       }
     }
@@ -10348,6 +10858,7 @@ ${callIntent}`
     const endCallTeardown = endCallPolicy.teardown ?? "room";
     const endCallGuaranteeMs = endCallPolicy.guaranteeMs === void 0 ? 4e3 : endCallPolicy.guaranteeMs;
     const endCallIdleMs = endCallPolicy.idleHangupMs === void 0 ? 2e4 : endCallPolicy.idleHangupMs;
+    const endCallMaxDurationMs = endCallPolicy.maxCallDurationMs === void 0 ? DEFAULT_MAX_CALL_DURATION_MS : endCallPolicy.maxCallDurationMs;
     const endCallRoomName = job.room.name ?? `room-${job.job?.id ?? "unknown"}`;
     const localDisconnect = async () => {
       try {
@@ -10359,6 +10870,7 @@ ${callIntent}`
       teardown: endCallTeardown,
       guaranteeMs: endCallGuaranteeMs,
       idleHangupMs: endCallIdleMs,
+      maxCallDurationMs: endCallMaxDurationMs,
       // 'room' deletes the whole LK room (drops the SIP/PSTN leg → carrier BYE);
       // 'agent' only disconnects the agent participant.
       runTeardown: endCallTeardown === "room" ? () => endRoomBestEffort(endCallRoomName, localDisconnect) : localDisconnect,
@@ -10408,6 +10920,7 @@ ${callIntent}`
         throw new Error("publishDtmf not available on this LiveKit runtime");
       }
       await lp.publishDtmf(code, digit);
+      callSync.publishDtmf({ direction: "sent", digit, code });
     };
     const ctx = buildAgentContext({
       job,
@@ -10435,6 +10948,8 @@ ${callIntent}`
       publishDtmf
     });
     ctxRef.current = ctx;
+    if (flowAgentName) ctx.metadata["agentName"] = flowAgentName;
+    else if (this.config.name) ctx.metadata["agentName"] = this.config.name;
     const onboardParticipant = async (p) => {
       let enriched = p;
       if (participantsCfg?.attributes) {
@@ -10511,8 +11026,17 @@ ${callIntent}`
     const onDtmfReceived = (code, digit, participant2) => {
       const identity = participant2?.identity;
       const pid = identity ? liveKitToVoiceLayer.get(identity) ?? ParticipantId(identity) : ParticipantId("unknown");
-      const resolvedDigit = digit && digit.length > 0 ? digit : dtmfCodeToDigit(code) ?? "";
+      const canonicalFromCode = dtmfCodeToDigit(code);
+      const resolvedDigit = canonicalFromCode ?? (digit && digit.length > 0 ? digit.toUpperCase() : "");
       audioExperience.recordDtmf(callInfo.callId, pid);
+      if (resolvedDigit && /^[0-9*#A-D]$/.test(resolvedDigit)) {
+        callSync.publishDtmf({
+          direction: "received",
+          digit: resolvedDigit,
+          code,
+          participantId: String(pid)
+        });
+      }
       const event = {
         participantId: pid,
         code,
@@ -10774,6 +11298,21 @@ ${callIntent}`
         room: job.room.name ?? null,
         participant: participant.identity
       });
+      endCallController.armDuration();
+      {
+        const announceMd = parseJobMetadata(job.job?.metadata);
+        const announcement = stringValue(announceMd["recordingAnnouncement"]);
+        if (announcement) {
+          try {
+            const sessionWithSay = session;
+            if (typeof sessionWithSay.say === "function") {
+              await sessionWithSay.say(announcement, { allowInterruptions: false });
+            }
+          } catch (err) {
+            console.warn("[agent] recording announcement say failed", err);
+          }
+        }
+      }
       if (this.config.puppetMode) {
         const dispatchMd = parseJobMetadata(job.job?.metadata);
         const initialDirective = stringValue(dispatchMd["initialDirective"]);
@@ -10787,6 +11326,18 @@ ${callIntent}`
             console.warn("[agent] puppet initialDirective say failed", err);
           }
         }
+      } else if (flowBootFailure) {
+        const apology = this.config.flowRuntime?.bootFailureMessage ?? "Sorry \u2014 we're having a technical issue starting this call. Please try again in a few minutes. Goodbye.";
+        try {
+          await session.generateReply({
+            instructions: `Say the following line to the user, verbatim and in full \u2014 no additions, omissions, or rephrasing:
+
+${apology}`
+          }).waitForPlayout();
+        } catch (err) {
+          console.warn("[agent] flow boot apology failed to play", err);
+        }
+        await endCallController.hangUp({ trigger: "flow", reason: `flow_boot:${flowBootFailure}` });
       } else if (this.config.onCall) {
         await this.config.onCall(ctx);
       } else if (graphMode && graphProgram && graphEvents) {
@@ -11172,6 +11723,4 @@ function createClient(options = {}) {
   };
 }
 
-export { Agent, BaseTool, CallsClient, EmailClient, FormsClient, PlansClient, VoiceLayerAuthError, VoiceLayerError, VoiceLayerHttpError, VoiceLayerNetworkError, VoiceLayerValidationError, applyPronunciations, assemblyai, asyncProbe, cartesia, collectDefaultMetadata, createClient, createNoOpLLM, deepgram, defineAgent, defineFlowRuntime, defineProcess, defineTool, dtmfCodeToDigit, dtmfDigitToCode, duck, elevenlabs, envProbe, formTools, google, httpTool, livekitTurn, mergeMetadata, mute, openai, ParticipantId as participantId, passthrough, processSchemaToAgentParts, processSchemaToDefinition, puppetEnvAvailable, resendEmailTool, runProbes, silero, startPuppetControl, transform, urlProbe, webhook, wrap };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+export { Agent, BaseTool, CallsClient, EmailClient, FormsClient, LK_AGENT_STATE_MAP, NON_BUSY_STATES, PlansClient, VoiceLayerAuthError, VoiceLayerError, VoiceLayerHttpError, VoiceLayerNetworkError, VoiceLayerValidationError, applyPronunciations, assemblyai, asyncProbe, cartesia, collectDefaultMetadata, createClient, createNoOpLLM, deepgram, defineAgent, defineFlowRuntime, defineProcess, defineTool, dtmfCodeToDigit, dtmfDigitToCode, duck, elevenlabs, envProbe, formTools, google, httpTool, livekitTurn, mergeMetadata, mute, normalizeState, openai, ParticipantId as participantId, passthrough, processSchemaToAgentParts, processSchemaToDefinition, puppetEnvAvailable, resendEmailTool, runProbes, silero, startPuppetControl, transform, urlProbe, webhook, wrap };