@voicelayer/sdk 0.1.8 → 0.1.10

package/dist/index.js

@@ -3133,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(
@@ -3147,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),
@@ -3251,11 +3251,18 @@ ${collected}`);
         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.processRt.captureField(slot, value);
-              deps.events.note("tool.output_captured", { node: node.id, slot });
+            const raw = resolvePath(result, path.trim());
+            if (raw === void 0 || raw === null) {
+              deps.events.note("tool.output_missing", { node: node.id, slot, path });
+              continue;
             }
+            const value = typeof raw === "string" ? raw : typeof raw === "number" || typeof raw === "boolean" || typeof raw === "bigint" ? String(raw) : JSON.stringify(raw);
+            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");
@@ -3764,13 +3771,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;
@@ -7365,6 +7378,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 {
@@ -7382,6 +7514,18 @@ function buildTextContext(adapter, call, processRt) {
     get process() {
       return { data: processRt.getData(), complete: processRt.isComplete() };
     },
+    // Voice-only actions, stubbed so a flow containing them can still be dry-run
+    // over text. Without these the handoff node threw "deps.ctx.handoff is not
+    // a function" mid-trace (seen in the builder's dry run); the graph now
+    // reaches its handoff outcome cleanly and the trace says why nothing dialed.
+    handoff: async (to) => {
+      processRt.recordEvent({
+        kind: "handoff.simulated",
+        data: { to, reason: "text dry run \u2014 no telephony leg to transfer" }
+      });
+    },
+    endCall: async () => {
+    },
     // Voice-only escape hatch is absent on text; left undefined.
     livekit: { session: {}, job: {} }
   };
@@ -7423,14 +7567,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 } : {}
@@ -8190,125 +8371,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 } : {}
-        })
-      );
-    }
-  }
-  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 } : {}
-  };
-}
 var BrainConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -10987,7 +11049,7 @@ async function executeHandoff(args, config, deps) {
       });
     }
   }
-  if (sipOps) {
+  if (sipOps && isSipParticipant(deps.callerIdentity)) {
     if (mode === "warm") {
       await sayFixed(deps, "I'm transferring you now \u2014 one moment.");
     }
@@ -11003,6 +11065,19 @@ async function executeHandoff(args, config, deps) {
         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();
@@ -11052,6 +11127,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}`;

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-BoUmDEX9.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';