@teamlearners/clawops 0.5.3 → 0.5.5

package/dist/agent/index.cjs

@@ -1,9 +1,12 @@
 'use strict';
 
 var chunk6IQN5RQD_cjs = require('../chunk-6IQN5RQD.cjs');
+var pino = require('pino');
 var fs = require('fs');
 var path = require('path');
 
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   var n = Object.create(null);
@@ -22,6 +25,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
+var pino__default = /*#__PURE__*/_interopDefault(pino);
 var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
 var path__namespace = /*#__PURE__*/_interopNamespace(path);
 
@@ -345,10 +349,19 @@ function resamplePcm16(pcm, fromRate, toRate) {
   }
   return out;
 }
+var DEFAULT_LOGGER = pino__default.default({ name: "clawops.agent" });
+var NOOP_LOGGER = pino__default.default({ 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;
 var MAX_RECONNECT_DELAY = 3e4;
+var PING_TIMEOUT = 6e4;
 function buildControlWsUrl(options) {
   const scheme = options.baseUrl.startsWith("https") ? "wss" : "ws";
   const host = options.baseUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
@@ -373,6 +386,11 @@ var ControlWebSocket = class {
   _closed = false;
   _connectedResolve = null;
   _connectedPromise;
+  _log = NOOP_LOGGER;
+  _pingTimer = null;
+  setLogger(logger) {
+    this._log = logger;
+  }
   /** Register an event handler for a specific event type. */
   on(event, handler) {
     let list = this._handlers.get(event);
@@ -400,6 +418,7 @@ var ControlWebSocket = class {
   /** Close the WebSocket and stop reconnecting. */
   close() {
     this._closed = true;
+    this._clearPingTimer();
     if (this._ws) {
       this._ws.close();
       this._ws = null;
@@ -416,26 +435,32 @@ var ControlWebSocket = class {
     this._ws = ws;
     ws.on("open", () => {
       this._reconnectDelay = INITIAL_RECONNECT_DELAY;
+      this._resetPingTimer();
       if (this._connectedResolve) {
         this._connectedResolve();
         this._connectedResolve = null;
       }
+      this._log.info("Control WS connected: %s", this._url);
+    });
+    ws.on("ping", () => {
+      this._resetPingTimer();
     });
     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", () => {
+      this._clearPingTimer();
       if (!this._closed) {
         this._scheduleReconnect();
       }
     });
     ws.on("error", (err) => {
-      console.error("[ControlWebSocket] Error:", err.message);
+      this._log.warn("Control WS error: %s", err.message);
     });
   }
   _dispatchEvent(event) {
@@ -446,22 +471,38 @@ 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);
         }
       }
     }
   }
+  _resetPingTimer() {
+    this._clearPingTimer();
+    this._pingTimer = setTimeout(() => {
+      this._log.warn("Control WS ping timeout, closing connection");
+      if (this._ws) {
+        this._ws.terminate();
+      }
+    }, PING_TIMEOUT);
+  }
+  _clearPingTimer() {
+    if (this._pingTimer) {
+      clearTimeout(this._pingTimer);
+      this._pingTimer = null;
+    }
+  }
   _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();
         });
       }
@@ -473,6 +514,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);
@@ -485,7 +530,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;
@@ -494,12 +539,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();
@@ -508,6 +554,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');
@@ -536,6 +587,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
@@ -548,6 +600,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;
   }
 };
@@ -602,6 +656,10 @@ var MediaWebSocket = class {
   _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;
@@ -643,6 +701,7 @@ var MediaWebSocket = class {
       ws.on("open", () => {
         this._startSendLoop();
         resolve();
+        this._log.info("Media WS connected: %s", url);
       });
       ws.on("message", (data) => {
         try {
@@ -661,7 +720,7 @@ var MediaWebSocket = class {
         if (!this._ws) {
           reject(err);
         }
-        console.error("[MediaWebSocket] Error:", err.message);
+        this._log.error({ err }, "Media WS error");
       });
     });
   }
@@ -822,6 +881,10 @@ var AudioRecorder = class {
   _mixWritten = 0;
   _startTime = 0;
   _started = false;
+  _log = NOOP_LOGGER;
+  setLogger(logger) {
+    this._log = logger;
+  }
   constructor(recordingPath, callId) {
     this._dir = path__namespace.join(recordingPath, callId);
   }
@@ -836,6 +899,7 @@ var AudioRecorder = class {
     fs__namespace.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;
@@ -888,7 +952,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) {
@@ -901,7 +965,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() {
@@ -922,8 +986,10 @@ var AudioRecorder = class {
         fs__namespace.writeSync(fd, makeWavHeader(maxWritten), 0, 44, 0);
         fs__namespace.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;
@@ -953,6 +1019,7 @@ var CallSession = class {
   _dtmfCollectorActive = false;
   _dtmfResolvers = [];
   _dtmfBuffer = [];
+  _log = NOOP_LOGGER;
   _handlers = /* @__PURE__ */ new Map();
   _endedPromise;
   _resolveEnded;
@@ -969,6 +1036,9 @@ var CallSession = class {
       this._resolveEnded = resolve;
     });
   }
+  setLogger(logger) {
+    this._log = logger;
+  }
   get status() {
     return this._status;
   }
@@ -1044,7 +1114,9 @@ var CallSession = class {
       this._dtmfResolvers = [];
       this._dtmfBuffer = [];
     }
-    return collected.join("");
+    const result = collected.join("");
+    this._log.info("DTMF collected: %s", result);
+    return result;
   }
   /** Send a sequence of DTMF digits. */
   async sendDtmfSequence(digits) {
@@ -1096,11 +1168,11 @@ 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);
         }
       }
     }
@@ -1348,6 +1420,9 @@ var ClawOpsAgent = class {
   _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"] ?? "";
@@ -1362,6 +1437,9 @@ var ClawOpsAgent = class {
     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.
@@ -1421,6 +1499,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));
@@ -1434,7 +1513,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.
@@ -1461,7 +1540,7 @@ var ClawOpsAgent = class {
     }
     this._activeSessions.clear();
     this._callSessions.clear();
-    console.log("[ClawOpsAgent] Disconnected");
+    this._log.info("ClawOpsAgent disconnected");
   }
   /**
    * Initiate an outbound call.
@@ -1496,10 +1575,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) {
@@ -1518,13 +1596,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);
       });
     }
   }
@@ -1532,6 +1612,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);
     }
@@ -1548,6 +1629,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);
@@ -1556,8 +1638,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);
       });
     }
   }
@@ -1565,13 +1648,14 @@ 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);
@@ -1596,7 +1680,7 @@ var ClawOpsAgent = class {
       this._passiveDtmfCallId = null;
       if (digits && sessionHandler && sessionHandler.feedDtmf) {
         sessionHandler.feedDtmf(digits).catch((err) => {
-          console.error("[ClawOpsAgent] feedDtmf error:", err);
+          this._log.error({ err }, "DTMF feed error");
         });
       }
     }, this._passiveDtmfDebounceMs);
@@ -1615,22 +1699,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"));
@@ -1660,6 +1747,9 @@ var ClawOpsAgent = class {
         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) {
@@ -1673,6 +1763,7 @@ var ClawOpsAgent = class {
           this._onDtmfEvent(session, digit);
         });
         mediaWs.onClose(() => {
+          this._log.info("Media stream stopped: %s", session.callId);
           if (recorder) {
             recorder.stop();
           }
@@ -1681,11 +1772,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();
@@ -1713,7 +1805,11 @@ 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",
@@ -1736,7 +1832,10 @@ var SEND_DTMF_TOOL = {
   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." }
+      digits: {
+        type: "string",
+        description: "\uC804\uC1A1\uD560 \uBC88\uD638 (0-9, *, #). 'w'\uB294 500ms \uB300\uAE30, 'W'\uB294 1000ms \uB300\uAE30."
+      }
     },
     required: ["digits"]
   }
@@ -1749,7 +1848,11 @@ var OpenAIRealtime = class {
   _language;
   _eagerness;
   _greeting;
+  _log = NOOP_LOGGER;
   _builtinTools = null;
+  setLogger(logger) {
+    this._log = logger;
+  }
   setBuiltinTools(tools) {
     this._builtinTools = tools;
   }
@@ -1806,6 +1909,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" });
         }
@@ -1825,7 +1929,7 @@ var OpenAIRealtime = class {
         if (!this._ws) {
           reject(err);
         }
-        console.error("[OpenAIRealtime] WebSocket error:", err.message);
+        this._log.error({ err }, "OpenAI Realtime WS error");
       });
     });
   }
@@ -1859,9 +1963,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 })) : [];
-    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);
+    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: {
@@ -1871,7 +1978,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" },
@@ -1942,7 +2049,7 @@ var OpenAIRealtime = class {
         break;
       }
       case "error": {
-        console.error("[OpenAIRealtime] API error:", msg["error"]);
+        this._log.error({ apiError: msg["error"] }, "OpenAI error");
         break;
       }
     }
@@ -1992,6 +2099,7 @@ 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) {
         await this._call.hangup();
@@ -2048,7 +2156,7 @@ var OpenAIRealtime = class {
       return;
     }
     if (!this._tools || !this._tools.has(funcName)) {
-      console.error(`[OpenAIRealtime] Unknown tool: ${funcName}`);
+      this._log.error("Unknown tool: %s", funcName);
       return;
     }
     let result;
@@ -2056,7 +2164,7 @@ 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();
@@ -2205,6 +2313,7 @@ var GeminiRealtime = class {
   _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 ?? "";
@@ -2224,6 +2333,9 @@ var GeminiRealtime = class {
   setBuiltinTools(tools) {
     this._builtinTools = tools;
   }
+  setLogger(logger) {
+    this._log = logger;
+  }
   async start(callSession, tools) {
     this._call = callSession;
     if (tools) this._tools = tools;
@@ -2260,12 +2372,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: (ev) => {
-          console.log(
-            `[GeminiRealtime] Connection closed: code=${ev?.code ?? "unknown"}`
-          );
+          this._log.info({ code: ev?.code ?? "unknown" }, "Gemini connection closed");
           this._closed = true;
         }
       }
@@ -2345,11 +2455,11 @@ var GeminiRealtime = class {
         }
       }
       if (serverContent.turnComplete) {
-        console.log("[GeminiRealtime] Turn complete");
+        this._log.debug("Turn complete");
         this._flushAudioRemainder();
       }
       if (serverContent.interrupted) {
-        console.log("[GeminiRealtime] Barge-in detected");
+        this._log.info("Barge-in detected");
         if (this._call) {
           this._call.clearAudio();
         }
@@ -2358,12 +2468,12 @@ var GeminiRealtime = class {
       }
       const inputText = serverContent.inputTranscription?.text;
       if (inputText && this._call) {
-        console.log(`[GeminiRealtime] [TRANSCRIPT-USER] ${inputText}`);
+        this._log.info("User: %s", inputText);
         this._call._emit("transcript", "user", inputText);
       }
       const outputText = serverContent.outputTranscription?.text;
       if (outputText && this._call) {
-        console.log(`[GeminiRealtime] [TRANSCRIPT-ASSISTANT] ${outputText}`);
+        this._log.info("Assistant: %s", outputText);
         this._call._emit("transcript", "assistant", outputText);
       }
     }
@@ -2372,9 +2482,7 @@ var GeminiRealtime = class {
     }
     const toolCancellation = msg["toolCallCancellation"];
     if (toolCancellation) {
-      console.log(
-        `[GeminiRealtime] Tool call cancelled: ${(toolCancellation.ids ?? []).join(", ")}`
-      );
+      this._log.info({ ids: toolCancellation.ids }, "Tool call cancelled");
     }
   }
   _handleAudioData(b64Data) {
@@ -2409,17 +2517,14 @@ var GeminiRealtime = class {
     const functionCalls = toolCall.functionCalls;
     if (!functionCalls) return;
     this._toolCallInProgress = true;
-    console.log(
-      `[GeminiRealtime] toolCall: ${functionCalls.map((fc) => fc.name).join(", ")}`
-    );
     const responses = [];
     for (const fc of functionCalls) {
       const name = fc.name ?? "";
       const fcId = fc.id ?? "";
       const args = fc.args ?? {};
-      console.log(`[GeminiRealtime] Tool call: ${name}(${JSON.stringify(args)})`);
+      this._log.info({ tool: name, args }, "Tool call: %s", name);
       if (name === "hang_up") {
-        console.log("[GeminiRealtime] hang_up: ending call");
+        this._log.info("hang_up: ending call");
         if (this._call) {
           await this._call.hangup();
         }
@@ -2429,17 +2534,15 @@ var GeminiRealtime = class {
         if (this._call) {
           let result;
           try {
-            console.log(
-              `[GeminiRealtime] collect_dtmf: waiting for digits (maxDigits=${args["max_digits"] ?? 4}, timeout=${args["timeout"] ?? 5})`
-            );
+            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
             });
-            console.log(`[GeminiRealtime] DTMF collected: ${result || "(empty)"}`);
+            this._log.info("DTMF collected: %s", result || "(empty)");
           } catch (err) {
-            console.error(`[GeminiRealtime] collect_dtmf error:`, err);
+            this._log.error({ err }, "collect_dtmf error");
             result = `Error: ${err}`;
           }
           responses.push({
@@ -2454,12 +2557,12 @@ var GeminiRealtime = class {
         if (this._call) {
           let result;
           try {
-            console.log(`[GeminiRealtime] send_dtmf: digits="${args["digits"] ?? ""}"`);
+            this._log.info('send_dtmf: digits="%s"', args["digits"] ?? "");
             await this._call.sendDtmfSequence(args["digits"] ?? "");
             result = "sent";
-            console.log(`[GeminiRealtime] send_dtmf: sent`);
+            this._log.info("send_dtmf: sent");
           } catch (err) {
-            console.error(`[GeminiRealtime] send_dtmf error:`, err);
+            this._log.error({ err }, "send_dtmf error");
             result = `Error: ${err}`;
           }
           responses.push({ id: fcId, name, response: { result } });
@@ -2467,21 +2570,21 @@ var GeminiRealtime = class {
         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);
-        console.log(`[GeminiRealtime] Tool result: ${name} -> ${resultStr.substring(0, 200)}`);
+        this._log.info("Tool result: %s -> %s", name, resultStr.substring(0, 200));
         responses.push({
           id: fcId,
           name,
           response: { result: resultStr }
         });
       } catch (err) {
-        console.error(`[GeminiRealtime] Tool call failed: ${name}:`, err);
+        this._log.error({ err }, "Tool call failed: %s", name);
         responses.push({
           id: fcId,
           name,
@@ -2490,7 +2593,7 @@ var GeminiRealtime = class {
       }
     }
     if (responses.length > 0 && this._session) {
-      console.log(`[GeminiRealtime] Sending ${responses.length} tool response(s)`);
+      this._log.debug("Sending %d tool response(s)", responses.length);
       this._session.sendToolResponse({
         functionResponses: responses
       });
@@ -2543,6 +2646,7 @@ var PipelineSession = class {
   _running = false;
   _speaking = false;
   _builtinTools = null;
+  _log = NOOP_LOGGER;
   constructor(options) {
     this._stt = options.stt;
     this._llm = options.llm;
@@ -2566,10 +2670,20 @@ var PipelineSession = class {
   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({
@@ -2579,11 +2693,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) {
@@ -2600,6 +2714,7 @@ var PipelineSession = class {
   }
   async stop() {
     this._running = false;
+    this._log.info("PipelineSession stopped");
     this._audioBuffer = [];
   }
   async _runSttLoop() {
@@ -2613,8 +2728,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);
       }
     }
@@ -2683,6 +2800,7 @@ 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);
     }
@@ -2750,7 +2868,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) {
@@ -2776,7 +2894,7 @@ var PipelineSession = class {
         }
       }
     } catch (err) {
-      console.error("[PipelineSession] TTS error:", err);
+      this._log.error({ err }, "TTS error");
     } finally {
       this._speaking = false;
     }
@@ -2786,6 +2904,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",
@@ -2855,7 +2977,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();
@@ -2866,6 +2988,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) {
@@ -2902,6 +3025,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",
@@ -3001,7 +3128,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();
@@ -3012,16 +3139,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: "" }));
         }
       }
@@ -3583,6 +3713,8 @@ exports.PipelineSession = PipelineSession;
 exports.TogetherLLM = TogetherLLM;
 exports.ToolRegistry = ToolRegistry;
 exports.XaiLLM = XaiLLM;
+exports.createAgentLogger = createAgentLogger;
+exports.createPipelineLogger = createPipelineLogger;
 exports.functionTool = functionTool;
 exports.getTracingConfig = getTracingConfig;
 exports.mcpServerHTTP = mcpServerHTTP;