@teamlearners/clawops 0.5.1 → 0.5.4

package/dist/agent/index.js

@@ -1,4 +1,5 @@
 import { DEFAULT_BASE_URL, AgentError, AgentConnectionError } from '../chunk-7S2OEBS6.js';
+import pino from 'pino';
 import * as fs from 'fs';
 import * as path from 'path';
 
@@ -322,6 +323,14 @@ function resamplePcm16(pcm, fromRate, toRate) {
   }
   return out;
 }
+var DEFAULT_LOGGER = pino({ name: "clawops.agent" });
+var NOOP_LOGGER = pino({ level: "silent" });
+function createAgentLogger(userLogger) {
+  return userLogger ?? DEFAULT_LOGGER;
+}
+function createPipelineLogger(parent) {
+  return parent.child({ module: "pipeline" });
+}
 
 // src/agent/control-ws.ts
 var INITIAL_RECONNECT_DELAY = 1e3;
@@ -350,6 +359,10 @@ var ControlWebSocket = class {
   _closed = false;
   _connectedResolve = null;
   _connectedPromise;
+  _log = NOOP_LOGGER;
+  setLogger(logger) {
+    this._log = logger;
+  }
   /** Register an event handler for a specific event type. */
   on(event, handler) {
     let list = this._handlers.get(event);
@@ -397,13 +410,14 @@ var ControlWebSocket = class {
         this._connectedResolve();
         this._connectedResolve = null;
       }
+      this._log.info("Control WS connected: %s", this._url);
     });
     ws.on("message", (data) => {
       try {
         const msg = JSON.parse(data.toString());
         this._dispatchEvent(msg);
       } catch {
-        console.error("[ControlWebSocket] Failed to parse message");
+        this._log.warn("Control WS parse error");
       }
     });
     ws.on("close", () => {
@@ -412,7 +426,7 @@ var ControlWebSocket = class {
       }
     });
     ws.on("error", (err) => {
-      console.error("[ControlWebSocket] Error:", err.message);
+      this._log.warn("Control WS error: %s", err.message);
     });
   }
   _dispatchEvent(event) {
@@ -423,11 +437,11 @@ var ControlWebSocket = class {
           const result = handler(event);
           if (result && typeof result.catch === "function") {
             result.catch((err) => {
-              console.error(`[ControlWebSocket] Error in handler for ${event.event}:`, err);
+              this._log.error({ err }, "Control WS handler error: %s", event.event);
             });
           }
         } catch (err) {
-          console.error(`[ControlWebSocket] Error in handler for ${event.event}:`, err);
+          this._log.error({ err }, "Control WS handler error: %s", event.event);
         }
       }
     }
@@ -435,10 +449,11 @@ var ControlWebSocket = class {
   _scheduleReconnect() {
     const delay = this._reconnectDelay;
     this._reconnectDelay = Math.min(this._reconnectDelay * 2, MAX_RECONNECT_DELAY);
+    this._log.info("Control WS reconnecting in %ds...", delay / 1e3);
     setTimeout(() => {
       if (!this._closed) {
         this._doConnect().catch((err) => {
-          console.error("[ControlWebSocket] Reconnect failed:", err);
+          this._log.warn({ err }, "Control WS reconnect failed");
           this._scheduleReconnect();
         });
       }
@@ -450,6 +465,10 @@ var ControlWebSocket = class {
 var MCPClient = class {
   _servers = /* @__PURE__ */ new Map();
   _clients = /* @__PURE__ */ new Map();
+  _log = NOOP_LOGGER;
+  setLogger(logger) {
+    this._log = logger;
+  }
   /** Add an MCP server configuration. */
   addServer(name, config) {
     this._servers.set(name, config);
@@ -462,7 +481,7 @@ var MCPClient = class {
         const tools = await this._connectServer(name, config);
         allTools.push(...tools);
       } catch (err) {
-        console.error(`[MCPClient] Failed to connect to server '${name}':`, err);
+        this._log.error({ err }, "MCP connection failed: %s", name);
       }
     }
     return allTools;
@@ -471,12 +490,13 @@ var MCPClient = class {
   async disconnect() {
     for (const [name, client] of this._clients) {
       try {
+        this._log.debug("MCP closing: %s", name);
         const c = client;
         if (c.close) {
           await c.close();
         }
       } catch (err) {
-        console.error(`[MCPClient] Error disconnecting from '${name}':`, err);
+        this._log.error({ err }, "MCP disconnect error: %s", name);
       }
     }
     this._clients.clear();
@@ -485,6 +505,11 @@ var MCPClient = class {
     const sdk = await import('@modelcontextprotocol/sdk/client/index.js');
     const { Client } = sdk;
     const client = new Client({ name: `clawops-${name}`, version: "1.0.0" });
+    if (config.type === "stdio") {
+      this._log.debug("MCP connecting (stdio): %s", config["command"]);
+    } else if (config.type === "http") {
+      this._log.debug("MCP connecting (http): %s", config["url"]);
+    }
     let transport;
     if (config.type === "stdio") {
       const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');
@@ -513,6 +538,7 @@ var MCPClient = class {
         parameters: inputSchema.properties ?? {},
         required: inputSchema.required ?? [],
         handler: async (args) => {
+          this._log.debug("MCP call_tool: %s", toolDef.name);
           const result = await client.callTool({
             name: toolDef.name,
             arguments: args
@@ -525,6 +551,8 @@ var MCPClient = class {
         }
       });
     }
+    this._log.info("MCP server connected: %d tools found", tools.length);
+    this._log.debug("MCP tools: %s", tools.map((t) => t.name));
     return tools;
   }
 };
@@ -555,6 +583,20 @@ function buildMediaResponse(audioBase64) {
     }
   });
 }
+var VALID_DTMF_DIGITS = new Set("0123456789*#");
+function parseDtmfEvent(data) {
+  const dtmf = data["dtmf"];
+  return {
+    digit: dtmf["digit"] ?? "",
+    track: dtmf["track"] ?? ""
+  };
+}
+function buildDtmfMessage(digit) {
+  if (!VALID_DTMF_DIGITS.has(digit)) {
+    throw new Error(`\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 DTMF digit: ${digit}`);
+  }
+  return JSON.stringify({ event: "dtmf", dtmf: { digit } });
+}
 var MediaWebSocket = class {
   _ws = null;
   _audioQueue = [];
@@ -563,6 +605,12 @@ var MediaWebSocket = class {
   _onAudio = null;
   _onStart = null;
   _onClose = null;
+  _onDtmf = null;
+  _markWaiters = /* @__PURE__ */ new Map();
+  _log = NOOP_LOGGER;
+  setLogger(logger) {
+    this._log = logger;
+  }
   /** Set the handler for inbound audio data. */
   onAudio(handler) {
     this._onAudio = handler;
@@ -575,6 +623,20 @@ var MediaWebSocket = class {
   onClose(handler) {
     this._onClose = handler;
   }
+  /** Set the handler for inbound DTMF events. */
+  onDtmf(handler) {
+    this._onDtmf = handler;
+  }
+  /** Send a single DTMF digit to the platform. */
+  sendDtmf(digit) {
+    if (this._ws && this._ws.readyState === 1) {
+      this._ws.send(buildDtmfMessage(digit));
+    }
+  }
+  /** Whether the WebSocket is connected. */
+  get isConnected() {
+    return this._ws !== null && this._ws.readyState === 1 && !this._closed;
+  }
   /** Connect to a media WebSocket URL with Bearer authentication. */
   async connect(url, apiKey) {
     const { WebSocket } = await import('ws');
@@ -590,6 +652,7 @@ var MediaWebSocket = class {
       ws.on("open", () => {
         this._startSendLoop();
         resolve();
+        this._log.info("Media WS connected: %s", url);
       });
       ws.on("message", (data) => {
         try {
@@ -608,7 +671,7 @@ var MediaWebSocket = class {
         if (!this._ws) {
           reject(err);
         }
-        console.error("[MediaWebSocket] Error:", err.message);
+        this._log.error({ err }, "Media WS error");
       });
     });
   }
@@ -634,6 +697,34 @@ var MediaWebSocket = class {
       );
     }
   }
+  /** Wait for all queued audio to be sent. */
+  flush() {
+    if (this._audioQueue.length === 0 || this._closed) return Promise.resolve();
+    return new Promise((resolve) => {
+      const check = () => {
+        if (this._audioQueue.length === 0 || this._closed) {
+          resolve();
+        } else {
+          setTimeout(check, 5);
+        }
+      };
+      setTimeout(check, 5);
+    });
+  }
+  /** Wait for a named mark to be echoed back by the server. */
+  waitForMark(name, timeoutMs = 5e3) {
+    if (this._closed) return Promise.resolve();
+    return new Promise((resolve) => {
+      const timer = setTimeout(() => {
+        this._markWaiters.delete(name);
+        resolve();
+      }, timeoutMs);
+      this._markWaiters.set(name, () => {
+        clearTimeout(timer);
+        resolve();
+      });
+    });
+  }
   /** Close the media WebSocket. */
   close() {
     this._closed = true;
@@ -659,6 +750,24 @@ var MediaWebSocket = class {
         }
         break;
       }
+      case "dtmf": {
+        const dtmfEvt = parseDtmfEvent(msg);
+        if (this._onDtmf) {
+          this._onDtmf(dtmfEvt.digit);
+        }
+        break;
+      }
+      case "mark": {
+        const markName = msg["mark"]?.["name"];
+        if (markName) {
+          const resolve = this._markWaiters.get(markName);
+          if (resolve) {
+            this._markWaiters.delete(markName);
+            resolve();
+          }
+        }
+        break;
+      }
       case "stop": {
         this.close();
         break;
@@ -723,6 +832,10 @@ var AudioRecorder = class {
   _mixWritten = 0;
   _startTime = 0;
   _started = false;
+  _log = NOOP_LOGGER;
+  setLogger(logger) {
+    this._log = logger;
+  }
   constructor(recordingPath, callId) {
     this._dir = path.join(recordingPath, callId);
   }
@@ -737,6 +850,7 @@ var AudioRecorder = class {
     fs.writeSync(this._fdMix, header);
     this._startTime = performance.now();
     this._started = true;
+    this._log.info("Recording started: %s", this._dir);
   }
   _expectedBytes() {
     const elapsed = (performance.now() - this._startTime) / 1e3;
@@ -789,7 +903,7 @@ var AudioRecorder = class {
       this._inWritten += pcm16_8k.length;
       this._writeToMix(pcm16_8k, posBefore);
     } catch (err) {
-      console.error("Error writing inbound audio:", err);
+      this._log.error({ err }, "Recording write error (inbound)");
     }
   }
   writeOutbound(pcm16_8k) {
@@ -802,7 +916,7 @@ var AudioRecorder = class {
       this._outWritten += pcm16_8k.length;
       this._writeToMix(pcm16_8k, posBefore);
     } catch (err) {
-      console.error("Error writing outbound audio:", err);
+      this._log.error({ err }, "Recording write error (outbound)");
     }
   }
   stop() {
@@ -823,8 +937,10 @@ var AudioRecorder = class {
         fs.writeSync(fd, makeWavHeader(maxWritten), 0, 44, 0);
         fs.closeSync(fd);
       }
+      const maxSec = maxWritten / 16e3;
+      this._log.info("Recording stopped: %s (%ds)", this._dir, maxSec);
     } catch (err) {
-      console.error("Error stopping recorder:", err);
+      this._log.error({ err }, "Recording stop error");
     } finally {
       this._fdIn = null;
       this._fdOut = null;
@@ -847,6 +963,14 @@ var CallSession = class {
   _sendAudioFn = null;
   _clearAudioFn = null;
   _hangupFn = null;
+  /** @internal */
+  _sendDtmfFn = null;
+  /** @internal */
+  _isTransportConnected = null;
+  _dtmfCollectorActive = false;
+  _dtmfResolvers = [];
+  _dtmfBuffer = [];
+  _log = NOOP_LOGGER;
   _handlers = /* @__PURE__ */ new Map();
   _endedPromise;
   _resolveEnded;
@@ -863,6 +987,9 @@ var CallSession = class {
       this._resolveEnded = resolve;
     });
   }
+  setLogger(logger) {
+    this._log = logger;
+  }
   get status() {
     return this._status;
   }
@@ -870,10 +997,12 @@ var CallSession = class {
     return (Date.now() - this.startTime.getTime()) / 1e3;
   }
   /** Bind transport functions (called internally by the agent). */
-  _bindTransport(send, clear, hangup) {
+  _bindTransport(send, clear, hangup, sendDtmf, isConnected) {
     this._sendAudioFn = send;
     this._clearAudioFn = clear;
     this._hangupFn = hangup;
+    if (sendDtmf) this._sendDtmfFn = sendDtmf;
+    if (isConnected) this._isTransportConnected = isConnected;
     this._status = "active";
   }
   /** Send PCM16 or ulaw audio to the caller. */
@@ -888,10 +1017,78 @@ var CallSession = class {
       this._clearAudioFn();
     }
   }
-  /** Hang up the call. */
-  hangup() {
+  /** Hang up the call, waiting for pending audio to finish. */
+  async hangup() {
     if (this._hangupFn) {
-      this._hangupFn();
+      await this._hangupFn();
+    }
+  }
+  /** @internal Route a received DTMF digit to an active collector or buffer. */
+  _routeDtmf(digit) {
+    if (this._dtmfCollectorActive && this._dtmfResolvers.length > 0) {
+      const resolve = this._dtmfResolvers.shift();
+      resolve(digit);
+    } else {
+      this._dtmfBuffer.push(digit);
+    }
+  }
+  /** Collect DTMF digits from the caller. */
+  async collectDtmf(options) {
+    if (this._dtmfCollectorActive) {
+      throw new Error("\uC774\uBBF8 DTMF \uC218\uC9D1 \uC911\uC785\uB2C8\uB2E4");
+    }
+    const { maxDigits, finishOnKey = "#", timeout = 5 } = options;
+    this._dtmfCollectorActive = true;
+    const collected = [];
+    try {
+      while (collected.length < maxDigits) {
+        if (this._dtmfBuffer.length > 0) {
+          const digit2 = this._dtmfBuffer.shift();
+          if (digit2 === finishOnKey) break;
+          collected.push(digit2);
+          continue;
+        }
+        const digit = await Promise.race([
+          new Promise((resolve) => {
+            this._dtmfResolvers.push(resolve);
+          }),
+          new Promise((resolve) => {
+            setTimeout(() => resolve(null), timeout * 1e3);
+          })
+        ]);
+        if (digit === null) break;
+        if (digit === finishOnKey) break;
+        collected.push(digit);
+      }
+    } finally {
+      this._dtmfCollectorActive = false;
+      this._dtmfResolvers = [];
+      this._dtmfBuffer = [];
+    }
+    const result = collected.join("");
+    this._log.info("DTMF collected: %s", result);
+    return result;
+  }
+  /** Send a sequence of DTMF digits. */
+  async sendDtmfSequence(digits) {
+    if (!this._sendDtmfFn) {
+      throw new Error("DTMF \uC804\uC1A1 \uD568\uC218\uAC00 \uBC14\uC778\uB529\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4");
+    }
+    for (const ch of digits) {
+      if (this._isTransportConnected && !this._isTransportConnected()) {
+        throw new Error("DTMF \uC804\uC1A1 \uC911 \uC5F0\uACB0\uC774 \uB04A\uC5B4\uC84C\uC2B5\uB2C8\uB2E4");
+      }
+      if (ch === "w") {
+        await new Promise((r) => setTimeout(r, 500));
+      } else if (ch === "W") {
+        await new Promise((r) => setTimeout(r, 1e3));
+      } else if ("0123456789*#".includes(ch)) {
+        if (this._sendDtmfFn) {
+          await this._sendDtmfFn(ch);
+        }
+      } else {
+        throw new Error(`\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 DTMF \uBB38\uC790: ${ch}`);
+      }
     }
   }
   /** Register an event handler. */
@@ -922,17 +1119,44 @@ var CallSession = class {
           const result = handler(this, ...args);
           if (result && typeof result.catch === "function") {
             result.catch((err) => {
-              console.error(`[CallSession] Error in ${event} handler:`, err);
+              this._log.error({ err }, "CallSession handler error: %s", event);
             });
           }
         } catch (err) {
-          console.error(`[CallSession] Error in ${event} handler:`, err);
+          this._log.error({ err }, "CallSession handler error: %s", event);
         }
       }
     }
   }
 };
 
+// src/agent/builtin-tool.ts
+var BuiltinTool = /* @__PURE__ */ ((BuiltinTool2) => {
+  BuiltinTool2["HANG_UP"] = "hang_up";
+  BuiltinTool2["COLLECT_DTMF"] = "collect_dtmf";
+  BuiltinTool2["SEND_DTMF"] = "send_dtmf";
+  BuiltinTool2["ALL"] = "all";
+  BuiltinTool2["NONE"] = "none";
+  return BuiltinTool2;
+})(BuiltinTool || {});
+var INDIVIDUAL_TOOLS = /* @__PURE__ */ new Set([
+  "hang_up" /* HANG_UP */,
+  "collect_dtmf" /* COLLECT_DTMF */,
+  "send_dtmf" /* SEND_DTMF */
+]);
+function resolveBuiltinTools(value) {
+  if (typeof value === "string") {
+    if (value === "all" /* ALL */) {
+      return new Set(INDIVIDUAL_TOOLS);
+    }
+    if (value === "none" /* NONE */) {
+      return /* @__PURE__ */ new Set();
+    }
+    return /* @__PURE__ */ new Set([value]);
+  }
+  return new Set(value.filter((t) => INDIVIDUAL_TOOLS.has(t)));
+}
+
 // src/agent/tool.ts
 function functionTool(fn) {
   return fn;
@@ -1141,6 +1365,15 @@ var ClawOpsAgent = class {
   _recording;
   _recordingPath;
   _activeSessions = /* @__PURE__ */ new Map();
+  _builtinTools;
+  _passiveDtmfDebounceMs;
+  _passiveDtmfBuffer = [];
+  _passiveDtmfTimer = null;
+  _passiveDtmfCallId = null;
+  _callSessions = /* @__PURE__ */ new Map();
+  _log;
+  _pipelineLog;
+  _isPipelineSession = false;
   constructor(options) {
     this._apiKey = options.apiKey ?? process.env["CLAWOPS_API_KEY"] ?? "";
     this._accountId = options.accountId ?? process.env["CLAWOPS_ACCOUNT_ID"] ?? "";
@@ -1150,9 +1383,14 @@ var ClawOpsAgent = class {
     this._recording = options.recording ?? false;
     this._recordingPath = options.recordingPath ?? "./recordings";
     this._mcpServers = options.mcpServers ?? [];
+    this._builtinTools = resolveBuiltinTools(options.builtinTools ?? "all" /* ALL */);
+    this._passiveDtmfDebounceMs = options.passiveDtmfDebounceMs ?? 500;
     if (options.tracing) {
       setTracingConfig(options.tracing);
     }
+    this._log = createAgentLogger(options.logger);
+    this._pipelineLog = createPipelineLogger(this._log);
+    this._isPipelineSession = "_stt" in this._session && "_llm" in this._session;
   }
   /**
    * Register a function tool.
@@ -1164,7 +1402,9 @@ var ClawOpsAgent = class {
   tool(nameOrTool, description, parameters, handler) {
     if (typeof nameOrTool === "string") {
       if (!description || !parameters || !handler) {
-        throw new AgentError("tool(name, description, parameters, handler) requires all arguments.");
+        throw new AgentError(
+          "tool(name, description, parameters, handler) requires all arguments."
+        );
       }
       this._tools.register({
         name: nameOrTool,
@@ -1200,7 +1440,9 @@ var ClawOpsAgent = class {
       throw new AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
     }
     if (!this._accountId) {
-      throw new AgentError("Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option.");
+      throw new AgentError(
+        "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
+      );
     }
     this._controlWs = new ControlWebSocket({
       baseUrl: this._baseUrl,
@@ -1208,6 +1450,7 @@ var ClawOpsAgent = class {
       accountId: this._accountId,
       number: this._fromNumber
     });
+    this._controlWs.setLogger(this._log);
     this._controlWs.on("call.incoming", (event) => this._handleIncoming(event));
     this._controlWs.on("call.ended", (event) => this._handleEnded(event));
     this._controlWs.on("call.outbound_ready", (event) => this._handleOutboundReady(event));
@@ -1221,7 +1464,7 @@ var ClawOpsAgent = class {
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
       );
     }
-    console.log(`[ClawOpsAgent] Connected on ${this._fromNumber}`);
+    this._log.info("ClawOpsAgent connected on %s", this._fromNumber);
   }
   /**
    * Connect and block until disconnected.
@@ -1247,7 +1490,8 @@ var ClawOpsAgent = class {
       session._markEnded();
     }
     this._activeSessions.clear();
-    console.log("[ClawOpsAgent] Disconnected");
+    this._callSessions.clear();
+    this._log.info("ClawOpsAgent disconnected");
   }
   /**
    * Initiate an outbound call.
@@ -1282,8 +1526,9 @@ var ClawOpsAgent = class {
         callSession.on(evt, handler);
       }
     }
+    callSession.setLogger(this._log);
     this._activeSessions.set(callSession.callId, callSession);
-    console.log(`[ClawOpsAgent] Outbound call initiated: ${this._fromNumber} -> ${to} (${callSession.callId})`);
+    this._log.info("Outbound call initiated: %s -> %s (%s)", this._fromNumber, to, callSession.callId);
     return callSession;
   }
   _handleIncoming(event) {
@@ -1302,13 +1547,15 @@ var ClawOpsAgent = class {
         session.on(evt, handler);
       }
     }
+    session.setLogger(this._log);
     this._activeSessions.set(callId, session);
+    this._log.info("Incoming call: %s -> %s (%s)", fromNumber, this._fromNumber, callId);
     if (this._controlWs) {
       this._controlWs.send({ event: "call.accept", callId });
     }
     if (mediaUrl) {
       this._startCallSession(session, mediaUrl).catch((err) => {
-        console.error(`[ClawOpsAgent] Error in call session ${callId}:`, err);
+        this._log.error({ err }, "Call session error: %s", callId);
       });
     }
   }
@@ -1316,6 +1563,7 @@ var ClawOpsAgent = class {
     const callId = event["callId"];
     const session = this._activeSessions.get(callId);
     if (session) {
+      this._log.info("Call ended (server): %s", callId);
       session._markEnded();
       this._activeSessions.delete(callId);
     }
@@ -1332,6 +1580,7 @@ var ClawOpsAgent = class {
         accountId: this._accountId,
         direction: "outbound"
       });
+      session.setLogger(this._log);
       for (const [evt, handlers] of this._handlers) {
         for (const handler of handlers) {
           session.on(evt, handler);
@@ -1340,8 +1589,9 @@ var ClawOpsAgent = class {
       this._activeSessions.set(callId, session);
     }
     if (mediaUrl) {
+      this._log.info("Outbound call answered: %s -> %s (%s)", this._fromNumber, session.toNumber, callId);
       this._startCallSession(session, mediaUrl).catch((err) => {
-        console.error(`[ClawOpsAgent] Error in call session ${callId}:`, err);
+        this._log.error({ err }, "Call session error: %s", callId);
       });
     }
   }
@@ -1349,18 +1599,43 @@ var ClawOpsAgent = class {
     const callId = event["callId"];
     const session = this._activeSessions.get(callId);
     if (session) {
-      console.log(`[ClawOpsAgent] Outbound call ringing: ${callId}`);
+      this._log.info("Outbound call ringing: %s", callId);
     }
   }
   _handleFailed(event) {
     const callId = event["callId"];
     const session = this._activeSessions.get(callId);
     if (session) {
+      this._log.info("Outbound call failed: %s (%s)", callId, event["reason"] ?? "failed");
       session._emit("call_failed", event["reason"] ?? "failed");
       session._markEnded();
       this._activeSessions.delete(callId);
     }
   }
+  _onDtmfEvent(callSession, digit) {
+    callSession._emit("dtmf", digit);
+    callSession._routeDtmf(digit);
+    if (callSession._dtmfCollectorActive) {
+      callSession.clearAudio();
+      return;
+    }
+    this._passiveDtmfBuffer.push(digit);
+    this._passiveDtmfCallId = callSession.callId;
+    if (this._passiveDtmfTimer) {
+      clearTimeout(this._passiveDtmfTimer);
+    }
+    this._passiveDtmfTimer = setTimeout(() => {
+      const digits = this._passiveDtmfBuffer.join("");
+      this._passiveDtmfBuffer = [];
+      const sessionHandler = this._passiveDtmfCallId ? this._callSessions.get(this._passiveDtmfCallId) : null;
+      this._passiveDtmfCallId = null;
+      if (digits && sessionHandler && sessionHandler.feedDtmf) {
+        sessionHandler.feedDtmf(digits).catch((err) => {
+          this._log.error({ err }, "DTMF feed error");
+        });
+      }
+    }, this._passiveDtmfDebounceMs);
+  }
   async _startCallSession(session, mediaWsUrl) {
     await withSpan(
       "clawops.call_session",
@@ -1375,22 +1650,25 @@ var ClawOpsAgent = class {
         if (this._mcpServers.length > 0) {
           for (const serverConfig of this._mcpServers) {
             const client = new MCPClient();
+            client.setLogger(this._log);
             client.addServer("mcp", serverConfig);
             try {
               const tools = await client.connect();
               sessionTools.registerMcpTools(tools);
               mcpClients.push(client);
             } catch (err) {
-              console.error("[ClawOpsAgent] MCP connection error:", err);
+              this._log.error({ err }, "MCP connection error");
             }
           }
         }
         let recorder = null;
         if (this._recording) {
           recorder = new AudioRecorder(this._recordingPath, session.callId);
+          recorder.setLogger(this._log);
           recorder.start();
         }
         const mediaWs = new MediaWebSocket();
+        mediaWs.setLogger(this._log);
         session._bindTransport(
           (audio) => {
             mediaWs.sendAudio(audio.toString("base64"));
@@ -1398,9 +1676,17 @@ var ClawOpsAgent = class {
           () => {
             mediaWs.sendClear();
           },
-          () => {
+          async () => {
+            await mediaWs.flush();
+            const markName = `hangup-${Date.now()}`;
+            mediaWs.sendMark(markName);
+            await mediaWs.waitForMark(markName, 5e3);
             mediaWs.close();
-          }
+          },
+          async (digit) => {
+            mediaWs.sendDtmf(digit);
+          },
+          () => mediaWs.isConnected
         );
         const sessionHandler = this._session;
         if ("setToolRegistry" in sessionHandler && typeof sessionHandler.setToolRegistry === "function") {
@@ -1409,6 +1695,13 @@ var ClawOpsAgent = class {
         if (recorder && "setRecorder" in sessionHandler && typeof sessionHandler.setRecorder === "function") {
           sessionHandler.setRecorder(recorder);
         }
+        if ("setBuiltinTools" in sessionHandler && typeof sessionHandler.setBuiltinTools === "function") {
+          sessionHandler.setBuiltinTools(this._builtinTools);
+        }
+        if ("setLogger" in sessionHandler && typeof sessionHandler.setLogger === "function") {
+          sessionHandler.setLogger(this._isPipelineSession ? this._pipelineLog : this._log);
+        }
+        this._callSessions.set(session.callId, sessionHandler);
         mediaWs.onAudio((ulawAudio, _timestamp) => {
           if (sessionHandler) {
             sessionHandler.feedAudio(ulawAudio);
@@ -1417,7 +1710,11 @@ var ClawOpsAgent = class {
             recorder.writeInbound(ulawToPcm16(ulawAudio));
           }
         });
+        mediaWs.onDtmf((digit) => {
+          this._onDtmfEvent(session, digit);
+        });
         mediaWs.onClose(() => {
+          this._log.info("Media stream stopped: %s", session.callId);
           if (recorder) {
             recorder.stop();
           }
@@ -1426,11 +1723,12 @@ var ClawOpsAgent = class {
         session._emit("call_start");
         try {
           await mediaWs.connect(mediaWsUrl, this._apiKey);
+          this._log.info("Media stream started: %s", session.callId);
           await sessionHandler.start(session, sessionTools);
           await session.wait();
           await sessionHandler.stop();
         } catch (err) {
-          console.error(`[ClawOpsAgent] Call session error:`, err);
+          this._log.error({ err }, "Call session error: %s", session.callId);
         } finally {
           if (mcpClients.length > 0) {
             sessionTools.clearMcpTools();
@@ -1445,6 +1743,7 @@ var ClawOpsAgent = class {
           session._emit("call_end");
           session._markEnded();
           this._activeSessions.delete(session.callId);
+          this._callSessions.delete(session.callId);
         }
       }
     );
@@ -1457,7 +1756,40 @@ var HANG_UP_TOOL = {
   type: "function",
   name: "hang_up",
   description: "End the phone call. Use when the conversation is finished or the caller says goodbye.",
-  parameters: { type: "object", properties: {}, required: [] }
+  parameters: {
+    type: "object",
+    properties: {},
+    required: []
+  }
+};
+var COLLECT_DTMF_TOOL = {
+  type: "function",
+  name: "collect_dtmf",
+  description: "\uC0AC\uC6A9\uC790\uB85C\uBD80\uD130 DTMF(\uC804\uD654 \uD0A4\uD328\uB4DC) \uC785\uB825\uC744 \uC218\uC9D1\uD569\uB2C8\uB2E4. \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBB34\uC5C7\uC744 \uC785\uB825\uD574\uC57C \uD558\uB294\uC9C0 \uC548\uB0B4\uD55C \uD6C4 \uD638\uCD9C\uD558\uC138\uC694.",
+  parameters: {
+    type: "object",
+    properties: {
+      max_digits: { type: "integer", description: "\uC218\uC9D1\uD560 \uCD5C\uB300 \uC790\uB9BF\uC218" },
+      finish_on_key: { type: "string", description: "\uC785\uB825 \uC885\uB8CC \uD0A4 (\uAE30\uBCF8: #)" },
+      timeout: { type: "integer", description: "\uC785\uB825 \uB300\uAE30 \uC2DC\uAC04(\uCD08, \uAE30\uBCF8: 5)" }
+    },
+    required: ["max_digits"]
+  }
+};
+var SEND_DTMF_TOOL = {
+  type: "function",
+  name: "send_dtmf",
+  description: "DTMF \uC2E0\uD638\uB97C \uC804\uC1A1\uD569\uB2C8\uB2E4. ARS \uBA54\uB274 \uD0D0\uC0C9\uC774\uB098 \uB0B4\uC120\uBC88\uD638 \uC785\uB825 \uC2DC \uC0AC\uC6A9\uD569\uB2C8\uB2E4.",
+  parameters: {
+    type: "object",
+    properties: {
+      digits: {
+        type: "string",
+        description: "\uC804\uC1A1\uD560 \uBC88\uD638 (0-9, *, #). 'w'\uB294 500ms \uB300\uAE30, 'W'\uB294 1000ms \uB300\uAE30."
+      }
+    },
+    required: ["digits"]
+  }
 };
 var OpenAIRealtime = class {
   _apiKey;
@@ -1467,6 +1799,14 @@ var OpenAIRealtime = class {
   _language;
   _eagerness;
   _greeting;
+  _log = NOOP_LOGGER;
+  _builtinTools = null;
+  setLogger(logger) {
+    this._log = logger;
+  }
+  setBuiltinTools(tools) {
+    this._builtinTools = tools;
+  }
   _ws = null;
   _call = null;
   _tools = null;
@@ -1477,6 +1817,9 @@ var OpenAIRealtime = class {
   _responseStartTs = null;
   _sentAudioChunks = 0;
   _audioRemainder = Buffer.alloc(0);
+  // Response state tracking — prevent sending response.create while one is active
+  _responseInProgress = false;
+  _onResponseDone = null;
   constructor(options = {}) {
     this._apiKey = options.apiKey ?? process.env["OPENAI_API_KEY"] ?? "";
     this._systemPrompt = options.systemPrompt ?? "";
@@ -1517,6 +1860,7 @@ var OpenAIRealtime = class {
       const ws = this._ws;
       ws.on("open", () => {
         this._sendSessionUpdate();
+        this._log.info("OpenAI Realtime connected");
         if (this._greeting) {
           this._send({ type: "response.create" });
         }
@@ -1536,10 +1880,22 @@ var OpenAIRealtime = class {
         if (!this._ws) {
           reject(err);
         }
-        console.error("[OpenAIRealtime] WebSocket error:", err.message);
+        this._log.error({ err }, "OpenAI Realtime WS error");
       });
     });
   }
+  async feedDtmf(digits) {
+    await this._waitForResponseDone();
+    this._send({
+      type: "conversation.item.create",
+      item: {
+        type: "message",
+        role: "user",
+        content: [{ type: "input_text", text: `[DTMF \uC785\uB825: ${digits}]` }]
+      }
+    });
+    this._send({ type: "response.create" });
+  }
   feedAudio(audio) {
     if (this._ws && this._ws.readyState === 1 && !this._closed) {
       this._send({
@@ -1558,7 +1914,12 @@ var OpenAIRealtime = class {
   _sendSessionUpdate() {
     if (!this._ws || this._ws.readyState !== 1) return;
     const toolSchemas = this._tools ? this._tools.toOpenAITools().map((t) => ({ type: "function", ...t.function })) : [];
-    toolSchemas.push(HANG_UP_TOOL);
+    if (!this._builtinTools || this._builtinTools.has("hang_up" /* HANG_UP */))
+      toolSchemas.push(HANG_UP_TOOL);
+    if (!this._builtinTools || this._builtinTools.has("collect_dtmf" /* COLLECT_DTMF */))
+      toolSchemas.push(COLLECT_DTMF_TOOL);
+    if (!this._builtinTools || this._builtinTools.has("send_dtmf" /* SEND_DTMF */))
+      toolSchemas.push(SEND_DTMF_TOOL);
     this._send({
       type: "session.update",
       session: {
@@ -1568,7 +1929,7 @@ var OpenAIRealtime = class {
         input_audio_format: "g711_ulaw",
         output_audio_format: "g711_ulaw",
         input_audio_transcription: {
-          model: "gpt-4o-mini-transcribe",
+          model: "whisper-1",
           language: this._language
         },
         input_audio_noise_reduction: { type: "far_field" },
@@ -1625,8 +1986,21 @@ var OpenAIRealtime = class {
         }
         break;
       }
+      case "response.created": {
+        this._responseInProgress = true;
+        break;
+      }
+      case "response.done": {
+        this._responseInProgress = false;
+        if (this._onResponseDone) {
+          const cb = this._onResponseDone;
+          this._onResponseDone = null;
+          cb();
+        }
+        break;
+      }
       case "error": {
-        console.error("[OpenAIRealtime] API error:", msg["error"]);
+        this._log.error({ apiError: msg["error"] }, "OpenAI error");
         break;
       }
     }
@@ -1676,14 +2050,64 @@ var OpenAIRealtime = class {
   async _handleToolCall(item) {
     const funcName = item["name"];
     const callId = item["call_id"];
+    this._log.info("Tool call: %s", funcName);
     if (funcName === "hang_up") {
       if (this._call) {
-        this._call.hangup();
+        await this._call.hangup();
+      }
+      return;
+    }
+    if (funcName === "collect_dtmf") {
+      if (this._call) {
+        let result2;
+        try {
+          const args = JSON.parse(item["arguments"] ?? "{}");
+          result2 = await this._call.collectDtmf({
+            maxDigits: args["max_digits"] ?? 4,
+            finishOnKey: args["finish_on_key"] ?? "#",
+            timeout: args["timeout"] ?? 5
+          });
+        } catch (err) {
+          result2 = `Error: ${err}`;
+        }
+        await this._waitForResponseDone();
+        this._send({
+          type: "conversation.item.create",
+          item: {
+            type: "function_call_output",
+            call_id: callId,
+            output: result2 || "(\uD0C0\uC784\uC544\uC6C3 - \uC785\uB825 \uC5C6\uC74C)"
+          }
+        });
+        this._send({ type: "response.create" });
+      }
+      return;
+    }
+    if (funcName === "send_dtmf") {
+      if (this._call) {
+        let result2;
+        try {
+          const args = JSON.parse(item["arguments"] ?? "{}");
+          await this._call.sendDtmfSequence(args["digits"] ?? "");
+          result2 = "sent";
+        } catch (err) {
+          result2 = `Error: ${err}`;
+        }
+        await this._waitForResponseDone();
+        this._send({
+          type: "conversation.item.create",
+          item: {
+            type: "function_call_output",
+            call_id: callId,
+            output: result2
+          }
+        });
+        this._send({ type: "response.create" });
       }
       return;
     }
     if (!this._tools || !this._tools.has(funcName)) {
-      console.error(`[OpenAIRealtime] Unknown tool: ${funcName}`);
+      this._log.error("Unknown tool: %s", funcName);
       return;
     }
     let result;
@@ -1691,9 +2115,10 @@ var OpenAIRealtime = class {
       const args = JSON.parse(item["arguments"] ?? "{}");
       result = await this._tools.call(funcName, args);
     } catch (err) {
-      console.error(`[OpenAIRealtime] Tool call failed: ${funcName}:`, err);
+      this._log.error({ err }, "Tool call failed: %s", funcName);
       result = `Error: ${err}`;
     }
+    await this._waitForResponseDone();
     this._send({
       type: "conversation.item.create",
       item: {
@@ -1704,6 +2129,12 @@ var OpenAIRealtime = class {
     });
     this._send({ type: "response.create" });
   }
+  _waitForResponseDone() {
+    if (!this._responseInProgress) return Promise.resolve();
+    return new Promise((resolve) => {
+      this._onResponseDone = resolve;
+    });
+  }
   _send(data) {
     if (this._ws && this._ws.readyState === 1 && !this._closed) {
       this._ws.send(JSON.stringify(data));
@@ -1717,6 +2148,33 @@ var HANG_UP_TOOL2 = {
   description: "End the phone call. Use when the conversation is finished or the caller says goodbye.",
   parameters: { type: "object", properties: {} }
 };
+var COLLECT_DTMF_TOOL2 = {
+  name: "collect_dtmf",
+  description: "\uC0AC\uC6A9\uC790\uB85C\uBD80\uD130 DTMF(\uC804\uD654 \uD0A4\uD328\uB4DC) \uC785\uB825\uC744 \uC218\uC9D1\uD569\uB2C8\uB2E4. \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBB34\uC5C7\uC744 \uC785\uB825\uD574\uC57C \uD558\uB294\uC9C0 \uC548\uB0B4\uD55C \uD6C4 \uD638\uCD9C\uD558\uC138\uC694.",
+  parameters: {
+    type: "object",
+    properties: {
+      max_digits: { type: "integer", description: "\uC218\uC9D1\uD560 \uCD5C\uB300 \uC790\uB9BF\uC218" },
+      finish_on_key: { type: "string", description: "\uC785\uB825 \uC885\uB8CC \uD0A4 (\uAE30\uBCF8: #)" },
+      timeout: { type: "integer", description: "\uC785\uB825 \uB300\uAE30 \uC2DC\uAC04(\uCD08, \uAE30\uBCF8: 5)" }
+    },
+    required: ["max_digits"]
+  }
+};
+var SEND_DTMF_TOOL2 = {
+  name: "send_dtmf",
+  description: "DTMF \uC2E0\uD638\uB97C \uC804\uC1A1\uD569\uB2C8\uB2E4. ARS \uBA54\uB274 \uD0D0\uC0C9\uC774\uB098 \uB0B4\uC120\uBC88\uD638 \uC785\uB825 \uC2DC \uC0AC\uC6A9\uD569\uB2C8\uB2E4.",
+  parameters: {
+    type: "object",
+    properties: {
+      digits: {
+        type: "string",
+        description: "\uC804\uC1A1\uD560 \uBC88\uD638 (0-9, *, #). 'w'\uB294 500ms \uB300\uAE30, 'W'\uB294 1000ms \uB300\uAE30."
+      }
+    },
+    required: ["digits"]
+  }
+};
 function resolveRef(ref, defs) {
   const parts = ref.replace(/^#\//, "").split("/");
   let result = defs;
@@ -1779,7 +2237,11 @@ function sanitizeSchemaForGemini(schema, defs, depth = 0) {
     result["properties"] = props;
   }
   if (schema["items"] && typeof schema["items"] === "object" && !Array.isArray(schema["items"])) {
-    result["items"] = sanitizeSchemaForGemini(schema["items"], defs, depth + 1);
+    result["items"] = sanitizeSchemaForGemini(
+      schema["items"],
+      defs,
+      depth + 1
+    );
   }
   if (!result["type"] && result["properties"]) result["type"] = "object";
   if (result["type"] === "object" && !result["properties"]) result["properties"] = {};
@@ -1800,6 +2262,9 @@ var GeminiRealtime = class {
   _closed = false;
   _sentAudioChunks = 0;
   _audioRemainder = Buffer.alloc(0);
+  _builtinTools = null;
+  _toolCallInProgress = false;
+  _log = NOOP_LOGGER;
   constructor(options = {}) {
     this._apiKey = options.apiKey ?? process.env["GOOGLE_API_KEY"] ?? "";
     this._systemPrompt = options.systemPrompt ?? "";
@@ -1816,6 +2281,12 @@ var GeminiRealtime = class {
   setRecorder(recorder) {
     this._recorder = recorder;
   }
+  setBuiltinTools(tools) {
+    this._builtinTools = tools;
+  }
+  setLogger(logger) {
+    this._log = logger;
+  }
   async start(callSession, tools) {
     this._call = callSession;
     if (tools) this._tools = tools;
@@ -1852,9 +2323,10 @@ var GeminiRealtime = class {
       callbacks: {
         onmessage: (msg) => this._handleMessage(msg),
         onerror: (err) => {
-          console.error("[GeminiRealtime] SDK error:", err);
+          this._log.error({ err }, "Gemini SDK error");
         },
-        onclose: () => {
+        onclose: (ev) => {
+          this._log.info({ code: ev?.code ?? "unknown" }, "Gemini connection closed");
           this._closed = true;
         }
       }
@@ -1872,7 +2344,7 @@ var GeminiRealtime = class {
     }
   }
   feedAudio(audio) {
-    if (this._session && !this._closed) {
+    if (this._session && !this._closed && !this._toolCallInProgress) {
       const pcm8k = ulawToPcm16(audio);
       if (this._recorder) {
         this._recorder.writeInbound(pcm8k);
@@ -1886,6 +2358,14 @@ var GeminiRealtime = class {
       });
     }
   }
+  async feedDtmf(digits) {
+    if (this._session) {
+      this._session.sendClientContent({
+        turns: [{ role: "user", parts: [{ text: `[DTMF \uC785\uB825: ${digits}]` }] }],
+        turnComplete: true
+      });
+    }
+  }
   async stop() {
     this._closed = true;
     if (this._session) {
@@ -1904,7 +2384,9 @@ var GeminiRealtime = class {
         t.function.parameters ?? { type: "object", properties: {} }
       )
     })) : [];
-    toolDefs.push(HANG_UP_TOOL2);
+    if (!this._builtinTools || this._builtinTools.has("hang_up" /* HANG_UP */)) toolDefs.push(HANG_UP_TOOL2);
+    if (!this._builtinTools || this._builtinTools.has("collect_dtmf" /* COLLECT_DTMF */)) toolDefs.push(COLLECT_DTMF_TOOL2);
+    if (!this._builtinTools || this._builtinTools.has("send_dtmf" /* SEND_DTMF */)) toolDefs.push(SEND_DTMF_TOOL2);
     return toolDefs;
   }
   _handleMessage(msg) {
@@ -1924,9 +2406,11 @@ var GeminiRealtime = class {
         }
       }
       if (serverContent.turnComplete) {
+        this._log.debug("Turn complete");
         this._flushAudioRemainder();
       }
       if (serverContent.interrupted) {
+        this._log.info("Barge-in detected");
         if (this._call) {
           this._call.clearAudio();
         }
@@ -1935,16 +2419,22 @@ var GeminiRealtime = class {
       }
       const inputText = serverContent.inputTranscription?.text;
       if (inputText && this._call) {
+        this._log.info("User: %s", inputText);
         this._call._emit("transcript", "user", inputText);
       }
       const outputText = serverContent.outputTranscription?.text;
       if (outputText && this._call) {
+        this._log.info("Assistant: %s", outputText);
         this._call._emit("transcript", "assistant", outputText);
       }
     }
     if (msg.toolCall) {
       this._handleToolCall(msg.toolCall);
     }
+    const toolCancellation = msg["toolCallCancellation"];
+    if (toolCancellation) {
+      this._log.info({ ids: toolCancellation.ids }, "Tool call cancelled");
+    }
   }
   _handleAudioData(b64Data) {
     if (!this._call) return;
@@ -1957,9 +2447,9 @@ var GeminiRealtime = class {
     const combined = Buffer.concat([this._audioRemainder, ulaw]);
     const chunkSize = 160;
     const fullEnd = Math.floor(combined.length / chunkSize) * chunkSize;
-    for (let off = 0; off < fullEnd; off += chunkSize) {
-      this._call.sendAudio(combined.subarray(off, off + chunkSize));
-      this._sentAudioChunks++;
+    if (fullEnd > 0) {
+      this._call.sendAudio(combined.subarray(0, fullEnd));
+      this._sentAudioChunks += fullEnd / chunkSize;
     }
     this._audioRemainder = combined.subarray(fullEnd);
   }
@@ -1977,31 +2467,75 @@ var GeminiRealtime = class {
   async _handleToolCall(toolCall) {
     const functionCalls = toolCall.functionCalls;
     if (!functionCalls) return;
+    this._toolCallInProgress = true;
     const responses = [];
     for (const fc of functionCalls) {
       const name = fc.name ?? "";
       const fcId = fc.id ?? "";
       const args = fc.args ?? {};
+      this._log.info({ tool: name, args }, "Tool call: %s", name);
       if (name === "hang_up") {
+        this._log.info("hang_up: ending call");
         if (this._call) {
-          this._call.hangup();
+          await this._call.hangup();
         }
         return;
       }
+      if (name === "collect_dtmf") {
+        if (this._call) {
+          let result;
+          try {
+            this._log.info({ maxDigits: args["max_digits"] ?? 4, timeout: args["timeout"] ?? 5 }, "collect_dtmf: waiting for digits");
+            result = await this._call.collectDtmf({
+              maxDigits: args["max_digits"] ?? 4,
+              finishOnKey: args["finish_on_key"] ?? "#",
+              timeout: args["timeout"] ?? 5
+            });
+            this._log.info("DTMF collected: %s", result || "(empty)");
+          } catch (err) {
+            this._log.error({ err }, "collect_dtmf error");
+            result = `Error: ${err}`;
+          }
+          responses.push({
+            id: fcId,
+            name,
+            response: { result: result || "(\uD0C0\uC784\uC544\uC6C3 - \uC785\uB825 \uC5C6\uC74C)" }
+          });
+        }
+        continue;
+      }
+      if (name === "send_dtmf") {
+        if (this._call) {
+          let result;
+          try {
+            this._log.info('send_dtmf: digits="%s"', args["digits"] ?? "");
+            await this._call.sendDtmfSequence(args["digits"] ?? "");
+            result = "sent";
+            this._log.info("send_dtmf: sent");
+          } catch (err) {
+            this._log.error({ err }, "send_dtmf error");
+            result = `Error: ${err}`;
+          }
+          responses.push({ id: fcId, name, response: { result } });
+        }
+        continue;
+      }
       if (!this._tools || !this._tools.has(name)) {
-        console.error(`[GeminiRealtime] Unknown tool: ${name}`);
+        this._log.error("Unknown tool: %s", name);
         responses.push({ id: fcId, name, response: { error: `Unknown tool: ${name}` } });
         continue;
       }
       try {
         const result = await this._tools.call(name, args);
+        const resultStr = typeof result === "string" ? result : JSON.stringify(result);
+        this._log.info("Tool result: %s -> %s", name, resultStr.substring(0, 200));
         responses.push({
           id: fcId,
           name,
-          response: { result: typeof result === "string" ? result : JSON.stringify(result) }
+          response: { result: resultStr }
         });
       } catch (err) {
-        console.error(`[GeminiRealtime] Tool call error for ${name}:`, err);
+        this._log.error({ err }, "Tool call failed: %s", name);
         responses.push({
           id: fcId,
           name,
@@ -2009,15 +2543,41 @@ var GeminiRealtime = class {
         });
       }
     }
-    if (this._session) {
+    if (responses.length > 0 && this._session) {
+      this._log.debug("Sending %d tool response(s)", responses.length);
       this._session.sendToolResponse({
         functionResponses: responses
       });
     }
+    this._toolCallInProgress = false;
   }
 };
 
 // src/agent/pipeline/pipeline-session.ts
+var COLLECT_DTMF_TOOL3 = {
+  function: {
+    description: "\uC0AC\uC6A9\uC790\uB85C\uBD80\uD130 DTMF(\uC804\uD654 \uD0A4\uD328\uB4DC) \uC785\uB825\uC744 \uC218\uC9D1\uD569\uB2C8\uB2E4.",
+    parameters: {
+      properties: {
+        max_digits: { type: "integer", description: "\uC218\uC9D1\uD560 \uCD5C\uB300 \uC790\uB9BF\uC218" },
+        finish_on_key: { type: "string", description: "\uC785\uB825 \uC885\uB8CC \uD0A4 (\uAE30\uBCF8: #)" },
+        timeout: { type: "integer", description: "\uC785\uB825 \uB300\uAE30 \uC2DC\uAC04(\uCD08, \uAE30\uBCF8: 5)" }
+      },
+      required: ["max_digits"]
+    }
+  }
+};
+var SEND_DTMF_TOOL3 = {
+  function: {
+    description: "DTMF \uC2E0\uD638\uB97C \uC804\uC1A1\uD569\uB2C8\uB2E4. ARS \uBA54\uB274 \uD0D0\uC0C9\uC774\uB098 \uB0B4\uC120\uBC88\uD638 \uC785\uB825 \uC2DC \uC0AC\uC6A9\uD569\uB2C8\uB2E4.",
+    parameters: {
+      properties: {
+        digits: { type: "string", description: "\uC804\uC1A1\uD560 \uBC88\uD638 (0-9, *, #). 'w'\uB294 500ms \uB300\uAE30, 'W'\uB294 1000ms \uB300\uAE30." }
+      },
+      required: ["digits"]
+    }
+  }
+};
 var PipelineSession = class {
   _stt;
   _llm;
@@ -2036,6 +2596,8 @@ var PipelineSession = class {
   _audioBuffer = [];
   _running = false;
   _speaking = false;
+  _builtinTools = null;
+  _log = NOOP_LOGGER;
   constructor(options) {
     this._stt = options.stt;
     this._llm = options.llm;
@@ -2056,10 +2618,23 @@ var PipelineSession = class {
   setRecorder(recorder) {
     this._recorder = recorder;
   }
+  setBuiltinTools(tools) {
+    this._builtinTools = tools;
+  }
+  setLogger(logger) {
+    this._log = logger;
+    if ("setLogger" in this._stt && typeof this._stt.setLogger === "function") {
+      this._stt.setLogger(logger);
+    }
+    if ("setLogger" in this._tts && typeof this._tts.setLogger === "function") {
+      this._tts.setLogger(logger);
+    }
+  }
   async start(callSession, tools) {
     this._callSession = callSession;
     this._tools = tools ?? null;
     this._running = true;
+    this._log.info("PipelineSession started");
     this._conversation = [];
     if (this._systemPrompt) {
       this._conversation.push({
@@ -2069,11 +2644,11 @@ var PipelineSession = class {
     }
     if (this._greeting) {
       this._generateGreeting().catch((err) => {
-        console.error("[PipelineSession] Greeting error:", err);
+        this._log.error({ err }, "Greeting error");
       });
     }
     this._runSttLoop().catch((err) => {
-      console.error("[PipelineSession] STT loop error:", err);
+      this._log.error({ err }, "STT loop error");
     });
   }
   feedAudio(audio) {
@@ -2081,8 +2656,16 @@ var PipelineSession = class {
       this._audioBuffer.push(audio);
     }
   }
+  async feedDtmf(digits) {
+    this._conversation.push({
+      role: "user",
+      content: `[DTMF \uC785\uB825: ${digits}]`
+    });
+    await this._respond();
+  }
   async stop() {
     this._running = false;
+    this._log.info("PipelineSession stopped");
     this._audioBuffer = [];
   }
   async _runSttLoop() {
@@ -2096,8 +2679,10 @@ var PipelineSession = class {
         if (this._callSession) {
           this._callSession.clearAudio();
         }
+        this._log.info('Barge-in: "%s"', event.transcript.substring(0, 30));
       }
       if (event.type === "final" && event.transcript.trim()) {
+        this._log.info("STT: %s", event.transcript);
         await this._handleUserSpeech(event.transcript);
       }
     }
@@ -2122,11 +2707,37 @@ var PipelineSession = class {
     this._conversation.push({ role: "user", content: transcript });
     await this._respond();
   }
+  _buildEffectiveTools() {
+    const includeCollectDtmf = !this._builtinTools || this._builtinTools.has("collect_dtmf" /* COLLECT_DTMF */);
+    const includeSendDtmf = !this._builtinTools || this._builtinTools.has("send_dtmf" /* SEND_DTMF */);
+    if (!includeCollectDtmf && !includeSendDtmf) return this._tools ?? void 0;
+    const base = this._tools ? this._tools.fork() : new ToolRegistry();
+    if (includeCollectDtmf) {
+      base.register({
+        name: "collect_dtmf",
+        description: COLLECT_DTMF_TOOL3.function.description,
+        parameters: COLLECT_DTMF_TOOL3.function.parameters.properties,
+        required: COLLECT_DTMF_TOOL3.function.parameters.required,
+        handler: async () => ""
+      });
+    }
+    if (includeSendDtmf) {
+      base.register({
+        name: "send_dtmf",
+        description: SEND_DTMF_TOOL3.function.description,
+        parameters: SEND_DTMF_TOOL3.function.parameters.properties,
+        required: SEND_DTMF_TOOL3.function.parameters.required,
+        handler: async () => ""
+      });
+    }
+    return base;
+  }
   async _respond() {
     let fullResponse = "";
     const textChunks = [];
+    const effectiveTools = this._buildEffectiveTools();
     const llmStream = this._llm.generate(this._conversation, {
-      tools: this._tools ?? void 0,
+      tools: effectiveTools,
       temperature: this._temperature,
       maxTokens: this._maxTokens
     });
@@ -2140,15 +2751,44 @@ var PipelineSession = class {
       }
     }
     if (fullResponse.trim()) {
+      this._log.info("Assistant: %s", fullResponse.substring(0, 100));
       this._conversation.push({ role: "assistant", content: fullResponse });
       await this._synthesizeAndSend(fullResponse);
     }
   }
   async _handleToolCall(chunk) {
-    if (!chunk.toolCall || !this._tools) return;
+    if (!chunk.toolCall) return;
     const { id, name, arguments: argsStr } = chunk.toolCall;
     try {
       const args = JSON.parse(argsStr);
+      if (name === "collect_dtmf" && this._callSession) {
+        let result2;
+        try {
+          result2 = await this._callSession.collectDtmf({
+            maxDigits: args["max_digits"] ?? 4,
+            finishOnKey: args["finish_on_key"] ?? "#",
+            timeout: args["timeout"] ?? 5
+          });
+        } catch (err) {
+          result2 = `Error: ${err}`;
+        }
+        this._conversation.push({ role: "tool", content: result2 || "(\uD0C0\uC784\uC544\uC6C3 - \uC785\uB825 \uC5C6\uC74C)", tool_call_id: id, name });
+        await this._respond();
+        return;
+      }
+      if (name === "send_dtmf" && this._callSession) {
+        let result2;
+        try {
+          await this._callSession.sendDtmfSequence(args["digits"] ?? "");
+          result2 = "sent";
+        } catch (err) {
+          result2 = `Error: ${err}`;
+        }
+        this._conversation.push({ role: "tool", content: result2, tool_call_id: id, name });
+        await this._respond();
+        return;
+      }
+      if (!this._tools) return;
       const result = await this._tools.call(name, args);
       this._conversation.push({
         role: "assistant",
@@ -2161,9 +2801,10 @@ var PipelineSession = class {
         tool_call_id: id,
         name
       });
+      const effectiveTools = this._buildEffectiveTools();
       let followUpText = "";
       const followUpStream = this._llm.generate(this._conversation, {
-        tools: this._tools ?? void 0,
+        tools: effectiveTools,
         temperature: this._temperature,
         maxTokens: this._maxTokens
       });
@@ -2178,7 +2819,7 @@ var PipelineSession = class {
         await this._synthesizeAndSend(followUpText);
       }
     } catch (err) {
-      console.error(`[PipelineSession] Tool call error for ${name}:`, err);
+      this._log.error({ err }, "Tool call failed: %s", name);
     }
   }
   async _synthesizeAndSend(text) {
@@ -2204,7 +2845,7 @@ var PipelineSession = class {
         }
       }
     } catch (err) {
-      console.error("[PipelineSession] TTS error:", err);
+      this._log.error({ err }, "TTS error");
     } finally {
       this._speaking = false;
     }
@@ -2214,6 +2855,10 @@ var PipelineSession = class {
 // src/agent/pipeline/deepgram-stt.ts
 var DeepgramSTT = class {
   _options;
+  _log = NOOP_LOGGER;
+  setLogger(logger) {
+    this._log = logger;
+  }
   constructor(options = {}) {
     this._options = {
       model: "nova-3",
@@ -2283,7 +2928,7 @@ var DeepgramSTT = class {
       }
     });
     ws.on("error", (err) => {
-      console.error("[DeepgramSTT] WebSocket error:", err.message);
+      this._log.error({ err }, "Deepgram STT error");
       done = true;
       if (resolveWait) {
         resolveWait();
@@ -2294,6 +2939,7 @@ var DeepgramSTT = class {
       ws.on("open", resolve);
       ws.on("error", reject);
     });
+    this._log.info("Deepgram STT connected");
     const feedPromise = (async () => {
       try {
         for await (const chunk of audioStream) {
@@ -2330,6 +2976,10 @@ var DeepgramSTT = class {
 // src/agent/pipeline/elevenlabs-tts.ts
 var ElevenLabsTTS = class {
   _options;
+  _log = NOOP_LOGGER;
+  setLogger(logger) {
+    this._log = logger;
+  }
   constructor(options = {}) {
     this._options = {
       voiceId: "EXAVITQu4vr4xnSDxMaL",
@@ -2429,7 +3079,7 @@ var ElevenLabsTTS = class {
       }
     });
     ws.on("error", (err) => {
-      console.error("[ElevenLabsTTS] WebSocket error:", err.message);
+      this._log.error({ err }, "ElevenLabs TTS error");
       done = true;
       if (resolveWait) {
         resolveWait();
@@ -2440,16 +3090,19 @@ var ElevenLabsTTS = class {
       ws.on("open", resolve);
       ws.on("error", reject);
     });
+    this._log.info("ElevenLabs TTS connected");
     const feedPromise = (async () => {
       try {
         for await (const chunk of textStream) {
           if (done) break;
           if (ws.readyState === 1) {
+            this._log.debug("ElevenLabs sending text: %s", chunk.substring(0, 60));
             ws.send(JSON.stringify({ text: chunk }));
           }
         }
       } finally {
         if (ws.readyState === 1) {
+          this._log.debug("ElevenLabs sending EOS");
           ws.send(JSON.stringify({ text: "" }));
         }
       }
@@ -2987,6 +3640,6 @@ function mcpServerHTTP(options) {
   };
 }
 
-export { AnthropicLLM, AudioRecorder, CallSession, ClawOpsAgent, DECODE_TABLE, DeepSeekLLM, DeepgramSTT, ElevenLabsTTS, FireworksLLM, GeminiLLM, GeminiRealtime, GroqLLM, MCPClient, MistralLLM, OllamaLLM, OpenAICompatLLM, OpenAILLM, OpenAIRealtime, PerplexityLLM, PipelineSession, TogetherLLM, ToolRegistry, XaiLLM, functionTool, getTracingConfig, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };
+export { AnthropicLLM, AudioRecorder, BuiltinTool, CallSession, ClawOpsAgent, DECODE_TABLE, DeepSeekLLM, DeepgramSTT, ElevenLabsTTS, FireworksLLM, GeminiLLM, GeminiRealtime, GroqLLM, MCPClient, MistralLLM, OllamaLLM, OpenAICompatLLM, OpenAILLM, OpenAIRealtime, PerplexityLLM, PipelineSession, TogetherLLM, ToolRegistry, XaiLLM, createAgentLogger, createPipelineLogger, functionTool, getTracingConfig, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map