@voicelayer/sdk 0.1.7 → 0.1.9

package/dist/index.js

@@ -137,6 +137,9 @@ var init_flow = __esm({
       "llm",
       "rag",
       "memory",
+      // Call-wide voice/turn-taking capability (barge-in + endpointing tuning);
+      // managed in the Capabilities panel like `memory`, never a graph step.
+      "speech",
       "classify",
       // Agentic router: per-turn, selects 1-of-N skills by their plain-language
       // descriptions and takes that port (the resident routing surface / hub).
@@ -335,6 +338,19 @@ var init_agents = __esm({
       }).optional(),
       // Tool capabilities compiled from tool nodes (maps to AgentConfig.tools).
       tools: z.array(ProcessToolDTO).max(32).optional(),
+      // Voice turn-taking compiled from the flow's speech capability node (maps to
+      // AgentConfig.speech → applySpeechTurnHandling). Absent = platform defaults.
+      speech: z.object({
+        interruption: z.object({
+          enabled: z.boolean().optional(),
+          minWords: z.number().int().min(0).max(10).optional(),
+          minDuration: z.number().int().min(0).max(5e3).optional()
+        }).optional(),
+        endpointing: z.object({
+          minDelay: z.number().int().min(0).max(5e3).optional(),
+          maxDelay: z.number().int().min(0).max(15e3).optional()
+        }).optional()
+      }).optional(),
       // Graph-preserving compiled program. When present and the flow-runtime graph
       // mode is enabled, the worker executes this node-graph deterministically
       // (the interpreter) instead of the flat goals+rails form above. Embedded here
@@ -494,7 +510,7 @@ var init_consultation = __esm({
     });
   }
 });
-var CALL_CONTROL_PUBSUB_CHANNEL, CallEventKind, SayCommand, HangupCommand, DtmfCommand, InstructCommand, CallControlCommand;
+var CALL_CONTROL_PUBSUB_CHANNEL, CallEventKind, OP_CALL_EVENT_KIND, OpCallEventKind, SayCommand, HangupCommand, DtmfCommand, InstructCommand, CallControlCommand;
 var init_call_events = __esm({
   "../contracts/src/call-events.ts"() {
     init_consultation();
@@ -520,6 +536,8 @@ var init_call_events = __esm({
       "dtmf.received",
       "dtmf.sent"
     ]);
+    OP_CALL_EVENT_KIND = /^(tool|handoff|lookup|record|notify)\.[a-z0-9_]{1,48}(\.[a-z0-9_]{1,48})?$/;
+    OpCallEventKind = z.string().regex(OP_CALL_EVENT_KIND);
     z.object({
       reason: z.string().optional(),
       durationMs: z.number().int().min(0).optional(),
@@ -557,7 +575,8 @@ var init_call_events = __esm({
       seq: z.number().int().min(0),
       callId: z.string().uuid(),
       projectId: z.string().min(1),
-      kind: CallEventKind,
+      // Closed lifecycle kinds OR the namespaced operational vocabulary.
+      kind: z.union([CallEventKind, OpCallEventKind]),
       payload: z.unknown(),
       ts: z.string().datetime()
     });
@@ -1914,7 +1933,20 @@ function nodeConfigFor(node) {
         ...typeof data.connectionRef === "string" ? { connectionRef: data.connectionRef } : {},
         // Registry reference: run the project HTTP tool with this NAME via the
         // server-side proxy instead of the inline url/method/auth above.
-        ...typeof data.toolRef === "string" && data.toolRef ? { toolRef: data.toolRef } : {}
+        ...typeof data.toolRef === "string" && data.toolRef ? { toolRef: data.toolRef } : {},
+        // Promote result fields into NAMED slots on success:
+        // { slotName: "data.path" }. Later nodes then read {{ slotName }}
+        // directly instead of {{ tool.<nodeId>.data.path }} via a set node.
+        ...(() => {
+          if (!data.outputAs || typeof data.outputAs !== "object") return {};
+          const outputAs = {};
+          for (const [slot, path] of Object.entries(data.outputAs)) {
+            if (typeof path === "string" && path.trim() && /^[a-zA-Z_][\w.]*$/.test(slot)) {
+              outputAs[slot] = path.trim();
+            }
+          }
+          return Object.keys(outputAs).length ? { outputAs } : {};
+        })()
       };
     }
     case "gate":
@@ -1927,7 +1959,10 @@ function nodeConfigFor(node) {
         ...typeof data.fallback === "string" ? { fallback: data.fallback } : {},
         ...typeof data.on === "string" ? { on: data.on } : {},
         // Per-node warm (conference brief) / cold (blind REFER) override.
-        ...data.mode === "warm" || data.mode === "cold" ? { mode: data.mode } : {}
+        ...data.mode === "warm" || data.mode === "cold" ? { mode: data.mode } : {},
+        // What the joining human HEARS (warm mode speaks it verbatim once they
+        // answer). {{ }}-interpolated at runtime against the slot scope.
+        ...typeof data.briefing === "string" && data.briefing.trim() ? { briefing: data.briefing } : {}
       };
     case "end":
       return {
@@ -2091,7 +2126,7 @@ var init_flow_compile = __esm({
     HISTORY_POLICIES = /* @__PURE__ */ new Set(["full", "last-turn", "slots-only"]);
     ADHERENCE_MODES = /* @__PURE__ */ new Set(["off", "observe", "enforce"]);
     UNSUPPORTED_NODE_TYPES = /* @__PURE__ */ new Set([]);
-    CAPABILITY_NODE_TYPES = /* @__PURE__ */ new Set(["memory", "trigger"]);
+    CAPABILITY_NODE_TYPES = /* @__PURE__ */ new Set(["memory", "trigger", "speech"]);
     ANNOTATION_NODE_TYPES = /* @__PURE__ */ new Set(["note"]);
   }
 });
@@ -3098,7 +3133,7 @@ var init_executors = __esm({
       const authoredSlot = slot === node.id ? "" : slot.trim();
       const label = authoredSlot.replace(/[_-]+/g, " ");
       if (hasSlot(deps.processRt.getData(), slot)) {
-        console.log("[graph] ask: slot already known, skipping", { slot: slot.trim() });
+        deps.events.note("ask.skipped", { slot: slot.trim(), reason: "already known" });
         return { kind: "advance" };
       }
       const askText = interpolate(
@@ -3112,10 +3147,10 @@ var init_executors = __esm({
         state.lastUtterance = t.text;
         state.lastDtmf = t.dtmf;
         if (hasSlot(deps.processRt.getData(), slot)) {
-          console.log("[graph] ask: captured", { slot: slot.trim() });
+          deps.events.note("ask.captured", { slot: slot.trim() });
           return { kind: "advance" };
         }
-        console.log("[graph] ask: clarify", { slot: slot.trim(), turn });
+        deps.events.note("ask.clarify", { slot: slot.trim(), turn });
         await withHistory(
           deps,
           historyPolicyOf(node),
@@ -3141,7 +3176,7 @@ var init_executors = __esm({
       if (msg) await speak(interpolate(msg, scopeFor(state, deps)), deps);
       return { kind: "end" };
     };
-    handoffExecutor = async (node, _state, deps) => {
+    handoffExecutor = async (node, state, deps) => {
       const cfg = node.config;
       const target = str(cfg.to) || str(cfg.fallback);
       if (!target) {
@@ -3150,9 +3185,14 @@ var init_executors = __esm({
       }
       const reason = str(cfg.reason) || `flow:${node.id}`;
       const mode = cfg.mode === "warm" || cfg.mode === "cold" ? cfg.mode : void 0;
+      const briefing = str(cfg.briefing) ? interpolate(str(cfg.briefing), scopeFor(state, deps)) : void 0;
       deps.events.note("handoff.start", { node: node.id, to: target, ...mode ? { mode } : {} });
       try {
-        await deps.ctx.handoff(target, { reason, ...mode ? { mode } : {} });
+        await deps.ctx.handoff(target, {
+          reason,
+          ...mode ? { mode } : {},
+          ...briefing ? { briefing } : {}
+        });
       } catch (err) {
         deps.events.note("handoff.failed", {
           node: node.id,
@@ -3206,7 +3246,24 @@ ${collected}`);
       const cfg = node.config;
       const name = str(cfg.name) || node.id;
       const routeByOutcome = () => {
-        const ok = state.toolResults[node.id]?.ok === true;
+        const result = state.toolResults[node.id];
+        const ok = result?.ok === true;
+        if (ok && cfg.outputAs && typeof cfg.outputAs === "object") {
+          for (const [slot, path] of Object.entries(cfg.outputAs)) {
+            if (typeof path !== "string" || !path.trim()) continue;
+            const value = resolvePath(result, path.trim());
+            if (value === void 0 || value === null) {
+              deps.events.note("tool.output_missing", { node: node.id, slot, path });
+              continue;
+            }
+            const captured = deps.processRt.captureField(slot, value);
+            deps.events.note(captured ? "tool.output_captured" : "tool.output_rejected", {
+              node: node.id,
+              slot,
+              ...captured ? {} : { reason: "slot not declared or value not coercible" }
+            });
+          }
+        }
         return routeByPort(node, deps, ok ? "ok" : "fail");
       };
       const toolRef = str(cfg.toolRef);
@@ -3713,13 +3770,19 @@ ${collected}`);
     setExecutor = async (node, state, deps) => {
       const assignments = Array.isArray(node.config.assignments) ? node.config.assignments : [];
       let applied = 0;
+      const rejected = [];
       for (const a of assignments) {
         if (!a || typeof a.name !== "string" || !a.name.trim()) continue;
+        const name = a.name.trim();
         const value = interpolate(typeof a.value === "string" ? a.value : "", scopeFor(state, deps));
-        deps.processRt.captureField(a.name.trim(), value);
-        applied += 1;
+        if (deps.processRt.captureField(name, value)) applied += 1;
+        else rejected.push(name);
       }
-      deps.events.note("set.applied", { node: node.id, count: applied });
+      deps.events.note("set.applied", {
+        node: node.id,
+        count: applied,
+        ...rejected.length ? { rejected } : {}
+      });
       return { kind: "advance" };
     };
     MAX_SUBFLOW_DEPTH = 3;
@@ -5262,12 +5325,15 @@ var CallsClient = class {
     );
   }
   /**
-   * Append a structured call event. Today the API accepts consultation
-   * lifecycle kinds only — see apps/api/src/routes/calls.ts AppendEventBody.
+   * Append a structured call event — consultation lifecycle kinds, or the
+   * operational vocabulary the call-detail Timeline renders between
+   * transcript rows (tool.* / handoff.* / lookup.* / record.* / notify.*).
+   * See apps/api/src/routes/calls.ts AppendEventBody for the accepted shapes.
    *
    * The agent SDK's built-in `ask_host` tool calls this on consultation start
-   * / end so the MCP host (via SSE) and dashboard see the "let me check" UX
-   * in real time.
+   * / end; the handoff runtime and graph interpreter emit op events through it
+   * so the operational story (dial → answered → briefed → dropped, tool calls)
+   * is visible in the dashboard, not just the spoken transcript.
    */
   async appendEvent(callId, input) {
     await this.transport.request(
@@ -5686,6 +5752,18 @@ init_conditions();
 init_interpreter();
 
 // src/runtime/graph/events.ts
+var OP_EVENT_NOTE = /^(tool|handoff|lookup|record|notify)\./;
+function withOpEventFanout(events, notify) {
+  return {
+    enter: (nodeId, type) => events.enter(nodeId, type),
+    traverse: (from, to, via) => events.traverse(from, to, via),
+    note(kind, data) {
+      events.note(kind, data);
+      if (OP_EVENT_NOTE.test(kind)) notify(kind, data ?? {});
+    },
+    currentNodeId: () => events.currentNodeId()
+  };
+}
 function createGraphEvents(processRt) {
   let current = null;
   return {
@@ -7299,6 +7377,125 @@ function createTextSessionAdapter(transport) {
   return { adapter, push, setState, close };
 }
 
+// src/flow-runtime.ts
+init_define_tool();
+function processSchemaToDefinition(schema) {
+  const required = new Set(schema.completionGate.requiredFields);
+  const collect = {};
+  for (const f of schema.fields) {
+    collect[f.name] = {
+      type: f.type,
+      required: required.has(f.name) || f.required,
+      ...f.ask !== void 0 ? { ask: f.ask } : {},
+      ...f.pattern !== void 0 ? { pattern: new RegExp(f.pattern) } : {},
+      ...f.min !== void 0 ? { min: f.min } : {},
+      ...f.max !== void 0 ? { max: f.max } : {},
+      ...f.enum !== void 0 ? { enum: f.enum } : {}
+    };
+  }
+  return {
+    collect,
+    completeWhen: "all-required-captured",
+    ...schema.completionGate.backendAck !== void 0 ? { backendAck: schema.completionGate.backendAck } : {}
+  };
+}
+var DEFAULT_FLOW_PROMPT = "You are a helpful voice assistant. Keep replies short and natural.";
+function toTriggerCondition(on) {
+  return on.startsWith("signal:") ? on : new RegExp(on, "i");
+}
+function toTriggerAction(then, graphNodeIds) {
+  if (then === "endCall" || then === "end") return "endCall";
+  if (then === "handoff") return "handoff";
+  if (then.startsWith("say:")) return { say: then.slice(4).trim() };
+  if (graphNodeIds?.has(then)) return { goto: then };
+  return "handoff";
+}
+function processSchemaToAgentParts(schema, opts = {}) {
+  const process2 = processSchemaToDefinition(schema);
+  const promptParts = [];
+  if (opts.basePrompt && opts.basePrompt.trim()) promptParts.push(opts.basePrompt.trim());
+  for (const p of schema.prompts ?? []) {
+    if (p.text.trim()) promptParts.push(p.text.trim());
+  }
+  const prompt = promptParts.length > 0 ? promptParts.join("\n\n") : DEFAULT_FLOW_PROMPT;
+  let triggers;
+  if (schema.triggers && schema.triggers.length > 0) {
+    triggers = {};
+    for (const t of schema.triggers) {
+      triggers[t.name] = {
+        on: toTriggerCondition(t.on),
+        then: toTriggerAction(t.then, opts.graphNodeIds),
+        ...t.onlyWhile ? { onlyWhile: t.onlyWhile } : {}
+      };
+    }
+  }
+  const handoff = schema.handoff?.fallback ? {
+    fallback: schema.handoff.fallback,
+    ...schema.handoff.routes ? { routes: schema.handoff.routes } : {}
+  } : void 0;
+  const memory = schema.memory ? {
+    ...schema.memory.scope ? { scope: schema.memory.scope } : {},
+    ...schema.memory.retentionDays !== void 0 ? { retentionDays: schema.memory.retentionDays } : {},
+    ...schema.memory.piiFields ? { piiFields: schema.memory.piiFields } : {}
+  } : void 0;
+  let tools;
+  if (schema.tools && schema.tools.length > 0) {
+    tools = {};
+    for (const t of schema.tools) {
+      if (t.auth === "connection") {
+        tools[t.name] = {
+          description: t.description,
+          input: t.input,
+          run: () => ({
+            kind: "unavailable",
+            reason: "connection-auth tools need the vault resolver (not wired yet)"
+          })
+        };
+        continue;
+      }
+      Object.assign(
+        tools,
+        httpTool({
+          name: t.name,
+          description: t.description,
+          input: t.input,
+          url: t.url,
+          method: t.method,
+          ...t.headers ? { headers: t.headers } : {}
+        })
+      );
+    }
+  }
+  let speech;
+  if (schema.speech) {
+    const i = schema.speech.interruption;
+    const e = schema.speech.endpointing;
+    const interruption = i ? {
+      ...i.enabled !== void 0 ? { enabled: i.enabled } : {},
+      ...i.minWords !== void 0 ? { minWords: i.minWords } : {},
+      ...i.minDuration !== void 0 ? { minDuration: i.minDuration } : {}
+    } : void 0;
+    const endpointing = e ? {
+      ...e.minDelay !== void 0 ? { minDelay: e.minDelay } : {},
+      ...e.maxDelay !== void 0 ? { maxDelay: e.maxDelay } : {}
+    } : void 0;
+    speech = {
+      ...interruption && Object.keys(interruption).length ? { interruption } : {},
+      ...endpointing && Object.keys(endpointing).length ? { endpointing } : {}
+    };
+    if (Object.keys(speech).length === 0) speech = void 0;
+  }
+  return {
+    prompt,
+    process: process2,
+    ...triggers ? { triggers } : {},
+    ...handoff ? { handoff } : {},
+    ...memory ? { memory } : {},
+    ...tools ? { tools } : {},
+    ...speech ? { speech } : {}
+  };
+}
+
 // src/runtime/text-session.ts
 function buildTextContext(adapter, call, processRt) {
   return {
@@ -7357,14 +7554,51 @@ function runTextSession(opts) {
     end: () => handle.close()
   };
 }
+function deriveCollectFromProgram(program) {
+  const collect = {};
+  for (const [nodeId, node] of Object.entries(program.nodes)) {
+    const cfg = node.config;
+    if (node.type === "ask") {
+      const name = typeof cfg.slot === "string" && cfg.slot ? cfg.slot : nodeId;
+      const type = cfg.type;
+      collect[name] = {
+        type: type === "number" || type === "boolean" || type === "datetime" || type === "string[]" ? type : "string",
+        ...cfg.required !== false ? { required: true } : {},
+        ...typeof cfg.ask === "string" ? { ask: cfg.ask } : {},
+        ...typeof cfg.pattern === "string" ? { pattern: new RegExp(cfg.pattern) } : {}
+      };
+    }
+    if (cfg.outputAs && typeof cfg.outputAs === "object") {
+      for (const slot of Object.keys(cfg.outputAs)) {
+        collect[slot] ??= { type: "string" };
+      }
+    }
+    if (Array.isArray(cfg.assignments)) {
+      for (const a of cfg.assignments) {
+        if (a && typeof a.name === "string" && a.name.trim()) collect[a.name.trim()] ??= { type: "string" };
+      }
+    }
+  }
+  return { collect, completeWhen: "all-required-captured" };
+}
+function definitionFor(opts) {
+  if (opts.schema) {
+    try {
+      return processSchemaToDefinition(opts.schema);
+    } catch {
+    }
+  }
+  return deriveCollectFromProgram(opts.program);
+}
 async function runTextTranscript(opts) {
   const replies = [];
   const trace7 = [];
+  const processRt = opts.processRt ?? createProcessRuntime(definitionFor(opts));
   const session = runTextSession({
     program: opts.program,
     onAgentText: (t) => void replies.push(t),
     onTrace: (e) => void trace7.push(e),
-    ...opts.processRt ? { processRt: opts.processRt } : {},
+    ...processRt ? { processRt } : {},
     ...opts.generate ? { generate: opts.generate } : {},
     ...opts.call ? { call: opts.call } : {},
     ...opts.maxSteps !== void 0 ? { maxSteps: opts.maxSteps } : {}
@@ -8124,105 +8358,6 @@ function computeEmptyRequired(view) {
   }
   return empty;
 }
-
-// src/flow-runtime.ts
-init_define_tool();
-function processSchemaToDefinition(schema) {
-  const required = new Set(schema.completionGate.requiredFields);
-  const collect = {};
-  for (const f of schema.fields) {
-    collect[f.name] = {
-      type: f.type,
-      required: required.has(f.name) || f.required,
-      ...f.ask !== void 0 ? { ask: f.ask } : {},
-      ...f.pattern !== void 0 ? { pattern: new RegExp(f.pattern) } : {},
-      ...f.min !== void 0 ? { min: f.min } : {},
-      ...f.max !== void 0 ? { max: f.max } : {},
-      ...f.enum !== void 0 ? { enum: f.enum } : {}
-    };
-  }
-  return {
-    collect,
-    completeWhen: "all-required-captured",
-    ...schema.completionGate.backendAck !== void 0 ? { backendAck: schema.completionGate.backendAck } : {}
-  };
-}
-var DEFAULT_FLOW_PROMPT = "You are a helpful voice assistant. Keep replies short and natural.";
-function toTriggerCondition(on) {
-  return on.startsWith("signal:") ? on : new RegExp(on, "i");
-}
-function toTriggerAction(then, graphNodeIds) {
-  if (then === "endCall" || then === "end") return "endCall";
-  if (then === "handoff") return "handoff";
-  if (then.startsWith("say:")) return { say: then.slice(4).trim() };
-  if (graphNodeIds?.has(then)) return { goto: then };
-  return "handoff";
-}
-function processSchemaToAgentParts(schema, opts = {}) {
-  const process2 = processSchemaToDefinition(schema);
-  const promptParts = [];
-  if (opts.basePrompt && opts.basePrompt.trim()) promptParts.push(opts.basePrompt.trim());
-  for (const p of schema.prompts ?? []) {
-    if (p.text.trim()) promptParts.push(p.text.trim());
-  }
-  const prompt = promptParts.length > 0 ? promptParts.join("\n\n") : DEFAULT_FLOW_PROMPT;
-  let triggers;
-  if (schema.triggers && schema.triggers.length > 0) {
-    triggers = {};
-    for (const t of schema.triggers) {
-      triggers[t.name] = {
-        on: toTriggerCondition(t.on),
-        then: toTriggerAction(t.then, opts.graphNodeIds),
-        ...t.onlyWhile ? { onlyWhile: t.onlyWhile } : {}
-      };
-    }
-  }
-  const handoff = schema.handoff?.fallback ? {
-    fallback: schema.handoff.fallback,
-    ...schema.handoff.routes ? { routes: schema.handoff.routes } : {}
-  } : void 0;
-  const memory = schema.memory ? {
-    ...schema.memory.scope ? { scope: schema.memory.scope } : {},
-    ...schema.memory.retentionDays !== void 0 ? { retentionDays: schema.memory.retentionDays } : {},
-    ...schema.memory.piiFields ? { piiFields: schema.memory.piiFields } : {}
-  } : void 0;
-  let tools;
-  if (schema.tools && schema.tools.length > 0) {
-    tools = {};
-    for (const t of schema.tools) {
-      if (t.auth === "connection") {
-        tools[t.name] = {
-          description: t.description,
-          input: t.input,
-          run: () => ({
-            kind: "unavailable",
-            reason: "connection-auth tools need the vault resolver (not wired yet)"
-          })
-        };
-        continue;
-      }
-      Object.assign(
-        tools,
-        httpTool({
-          name: t.name,
-          description: t.description,
-          input: t.input,
-          url: t.url,
-          method: t.method,
-          ...t.headers ? { headers: t.headers } : {}
-        })
-      );
-    }
-  }
-  return {
-    prompt,
-    process: process2,
-    ...triggers ? { triggers } : {},
-    ...handoff ? { handoff } : {},
-    ...memory ? { memory } : {},
-    ...tools ? { tools } : {}
-  };
-}
 var BrainConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -10877,29 +11012,59 @@ async function executeHandoff(args, config, deps) {
   const briefing = args.briefing ?? await buildBriefing(config, deps) ?? `Handoff to ${args.to}`;
   const mode = args.mode ?? config?.mode ?? "warm";
   const sipOps = deps.sipOps ?? buildDefaultSipOps();
+  const notify = deps.notify ?? (() => {
+  });
   if (mode === "warm" && sipOps && sipOps.canConference) {
     try {
       await sayFixed(deps, "One moment \u2014 I'm bringing our on-call engineer onto the line now. Stay with me.");
+      notify("handoff.dialing", { to: args.to, mode: "warm" });
       await sipOps.addParticipant(deps.roomName, normalizeSipTarget(args.to));
+      notify("handoff.answered", { to: args.to });
       await sayFixed(deps, briefing);
+      notify("handoff.briefed", { to: args.to, briefing });
       await sayFixed(deps, "You're both connected now \u2014 I'll drop off.");
       await quiesce(deps);
       await deps.disconnect();
+      notify("handoff.agent_dropped", { to: args.to });
       return { ok: true, via: "conference", target: args.to };
     } catch (err) {
       console.error("[handoff] conference bridge failed, falling back to REFER", err);
+      notify("handoff.failed", {
+        to: args.to,
+        via: "conference",
+        error: err instanceof Error ? err.message : String(err)
+      });
     }
   }
-  if (sipOps) {
+  if (sipOps && isSipParticipant(deps.callerIdentity)) {
     if (mode === "warm") {
       await sayFixed(deps, "I'm transferring you now \u2014 one moment.");
     }
     try {
       await sipOps.refer(deps.roomName, deps.callerIdentity, normalizeSipTarget(args.to));
+      notify("handoff.refer", { to: args.to });
       return { ok: true, via: "sip", target: args.to };
     } catch (err) {
       console.error("[handoff] SIP REFER failed, falling back to disconnect", err);
+      notify("handoff.failed", {
+        to: args.to,
+        via: "refer",
+        error: err instanceof Error ? err.message : String(err)
+      });
     }
+  } else if (sipOps) {
+    console.warn("[handoff] caller has no SIP leg; cannot transfer this channel", {
+      callerIdentity: deps.callerIdentity,
+      conferenceAvailable: sipOps.canConference
+    });
+    notify("handoff.unavailable", {
+      to: args.to,
+      reason: sipOps.canConference ? "caller has no SIP leg (web/playground call)" : "caller has no SIP leg and no outbound trunk is configured for conferencing"
+    });
+    await sayFixed(
+      deps,
+      "I'm not able to connect you to a person on this channel \u2014 please call our phone line and we'll pick up right where we left off."
+    );
   }
   try {
     await deps.disconnect();
@@ -10949,6 +11114,9 @@ function buildDefaultSipOps() {
     }
   };
 }
+function isSipParticipant(identity) {
+  return !/^(user[-_]|web[-_]|playground[-_]|vl-client)/i.test(identity.trim());
+}
 function normalizeSipTarget(target) {
   if (target.startsWith("sip:") || target.startsWith("tel:")) return target;
   return `tel:${target}`;
@@ -12645,7 +12813,11 @@ var Agent = class {
             ...parts.triggers ? { triggers: parts.triggers } : {},
             ...parts.handoff ? { handoff: parts.handoff } : {},
             ...parts.memory ? { memory: parts.memory } : {},
-            ...parts.tools ? { tools: { ...effectiveConfig.tools ?? {}, ...parts.tools } } : {}
+            ...parts.tools ? { tools: { ...effectiveConfig.tools ?? {}, ...parts.tools } } : {},
+            // Flow-authored turn-taking (schema.speech). Merged over any
+            // worker-level speech config; applySpeechTurnHandling reads this
+            // off effectiveConfig at session build.
+            ...parts.speech ? { speech: { ...effectiveConfig.speech ?? {}, ...parts.speech } } : {}
           };
           console.log("[agent] booted from flow", {
             agentId: flowAgentId,
@@ -12706,7 +12878,13 @@ var Agent = class {
     const processRt = createProcessRuntime(effectiveConfig.process);
     seedCallPrefill(processRt, dispatchMdEarly);
     await seedProjectVariables(processRt);
-    const graphEvents = graphMode ? createGraphEvents(processRt) : null;
+    let opEventCallId = null;
+    const emitOpEvent = (kind, payload) => {
+      if (!sdkClient || !opEventCallId) return;
+      void sdkClient.calls.appendEvent(opEventCallId, { kind, payload }).catch(() => {
+      });
+    };
+    const graphEvents = graphMode ? withOpEventFanout(createGraphEvents(processRt), emitOpEvent) : null;
     const isOutbound = stringValue(dispatchMdEarly["direction"]) === "outbound";
     const perCallAmd = stringValue(dispatchMdEarly["amd"]);
     const amdMode = perCallAmd === "off" || perCallAmd === "detect" || perCallAmd === "detectMessageEnd" ? perCallAmd : effectiveConfig.outbound?.amd ?? "off";
@@ -12798,6 +12976,7 @@ var Agent = class {
         });
       }
     }
+    opEventCallId = consultationCallId;
     let agentSpeechState = "initializing";
     const idleWaiters = /* @__PURE__ */ new Set();
     const waitUntilAgentIdle = async (timeoutMs) => {
@@ -12981,7 +13160,8 @@ ${callIntent}`
         }
       },
       getProcessData: () => processRt.getData(),
-      transcript
+      transcript,
+      notify: (kind, payload) => emitOpEvent(kind, payload)
     });
     const triggersRt = createTriggersRuntime(effectiveConfig.triggers, handoffRt);
     const audioExperience = new AudioExperiencePrimitive();

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

@@ -1,3 +1,3 @@
-export { a6 as GraphTraceEvent, q as RunTextSessionOptions, r as RunTextTranscriptOptions, T as TextSession, O as TextTranscriptResult, a3 as runTextSession, a4 as runTextTranscript } from '../text-session-B8-jhQzv.js';
+export { aa as GraphTraceEvent, u as RunTextSessionOptions, v as RunTextTranscriptOptions, V as TextSession, W as TextTranscriptResult, a7 as runTextSession, a8 as runTextTranscript } from '../text-session-D1j8nQac.js';
 import '@livekit/agents';
 import 'zod';