@teamlearners/clawops 0.41.0 → 0.42.0

package/dist/agent/index.cjs

@@ -2,8 +2,8 @@
 
 var chunkLLPMUDNE_cjs = require('../chunk-LLPMUDNE.cjs');
 var chunkMXEZQRIL_cjs = require('../chunk-MXEZQRIL.cjs');
-var chunk7ZFSDBM6_cjs = require('../chunk-7ZFSDBM6.cjs');
-require('../chunk-WTG2QGQU.cjs');
+var chunkMQXG2CWP_cjs = require('../chunk-MQXG2CWP.cjs');
+require('../chunk-FQ5SY7WN.cjs');
 var fs = require('fs');
 var path = require('path');
 
@@ -32,6 +32,9 @@ var path__namespace = /*#__PURE__*/_interopNamespace(path);
 var INITIAL_RECONNECT_DELAY = 1e3;
 var MAX_RECONNECT_DELAY = 3e4;
 var PING_TIMEOUT = 6e4;
+var CLOSE_REPLACED = 4409;
+var CLOSE_OWNERSHIP_LOST = 4403;
+var NON_RETRYABLE_CLOSE_CODES = /* @__PURE__ */ new Set([CLOSE_REPLACED, CLOSE_OWNERSHIP_LOST]);
 function buildControlWsUrl(options) {
   const scheme = options.baseUrl.startsWith("https") ? "wss" : "ws";
   const host = options.baseUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
@@ -57,7 +60,7 @@ var ControlWebSocket = class {
   _closed = false;
   _connectedResolve = null;
   _connectedPromise;
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   _pingTimer = null;
   setLogger(logger) {
     this._log = logger;
@@ -153,11 +156,21 @@ var ControlWebSocket = class {
         this._log.warn("Control WS parse error");
       }
     });
-    ws.on("close", () => {
+    ws.on("close", (code, reason) => {
       this._clearPingTimer();
-      if (!this._closed) {
-        this._scheduleReconnect();
+      if (this._closed) return;
+      if (NON_RETRYABLE_CLOSE_CODES.has(code)) {
+        const text = reason?.toString() || "";
+        this._closed = true;
+        this._log.info(
+          "Control WS closed by server (%d %s) \u2014 not reconnecting: this number is now served elsewhere",
+          code,
+          text
+        );
+        this._options.onTerminalClose?.({ code, reason: text });
+        return;
       }
+      this._scheduleReconnect();
     });
     ws.on("error", (err) => {
       this._log.warn("Control WS error: %s", err.message);
@@ -222,7 +235,7 @@ var ControlWebSocket = class {
 var MCPClient = class {
   _servers = /* @__PURE__ */ new Map();
   _clients = /* @__PURE__ */ new Map();
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   setLogger(logger) {
     this._log = logger;
   }
@@ -364,7 +377,7 @@ var MediaWebSocket = class {
   _onClose = null;
   _onDtmf = null;
   _markWaiters = /* @__PURE__ */ new Map();
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   setLogger(logger) {
     this._log = logger;
   }
@@ -590,7 +603,7 @@ var AudioRecorder = class {
   _started = false;
   _baseTs = null;
   _outCursor = 0;
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   setLogger(logger) {
     this._log = logger;
   }
@@ -805,7 +818,7 @@ function generateComfortTone(volume = 0.12) {
     }
   }
   const pcm = int16ArrayToBuffer(concatInt16Arrays(...parts));
-  const ulaw = chunk7ZFSDBM6_cjs.pcm16ToUlaw(pcm);
+  const ulaw = chunkMQXG2CWP_cjs.pcm16ToUlaw(pcm);
   const chunks = [];
   for (let i = 0; i < ulaw.length; i += CHUNK_SIZE) {
     chunks.push(ulaw.subarray(i, i + CHUNK_SIZE));
@@ -862,9 +875,9 @@ function loadHoldAudio(source) {
       pcmData = mono;
     }
     if (sampleRate !== SAMPLE_RATE2) {
-      pcmData = chunk7ZFSDBM6_cjs.resamplePcm16(pcmData, sampleRate, SAMPLE_RATE2);
+      pcmData = chunkMQXG2CWP_cjs.resamplePcm16(pcmData, sampleRate, SAMPLE_RATE2);
     }
-    const ulaw = chunk7ZFSDBM6_cjs.pcm16ToUlaw(pcmData);
+    const ulaw = chunkMQXG2CWP_cjs.pcm16ToUlaw(pcmData);
     const chunks = [];
     for (let i = 0; i < ulaw.length; i += CHUNK_SIZE) {
       chunks.push(ulaw.subarray(i, i + CHUNK_SIZE));
@@ -1099,6 +1112,8 @@ var ATTR_AGENT_ID = "clawops.agent.id";
 
 // src/agent/agent.ts
 var TERMINAL_FRAME_GRACE_MS = 2e3;
+var DEFAULT_DRAIN_TIMEOUT_MS = 12e4;
+var DRAIN_POLL_INTERVAL_MS = 200;
 var ClawOpsAgent = class _ClawOpsAgent {
   _apiKey;
   _accountId;
@@ -1112,6 +1127,17 @@ var ClawOpsAgent = class _ClawOpsAgent {
   _recording;
   _recordingPath;
   _activeSessions = /* @__PURE__ */ new Map();
+  /** Set once the server hands this number to another process (rolling deploy takeover). */
+  _takenOver = false;
+  /**
+   * Set once we deliberately give up the control connection (`drain()`/`disconnect()`).
+   * Distinct from `_controlWs === null`, which also covers "never connected": only after a
+   * hand-back is it certain that no server terminal frame can still arrive.
+   */
+  _controlGivenUp = false;
+  /** serve()'s stop hook, so takeover can end the block the same way a signal does. */
+  _stopServe = null;
+  _onTakenOver;
   /** 미디어 정리를 마친 통화가 서버 종료 프레임을 기다리는 자리. callId → resolve. */
   _terminalWaiters = /* @__PURE__ */ new Map();
   _builtinTools;
@@ -1142,17 +1168,18 @@ var ClawOpsAgent = class _ClawOpsAgent {
     this._recording = options.recording ?? false;
     this._recordingPath = options.recordingPath ?? "./recordings";
     this._mcpServers = options.mcpServers ?? [];
-    this._builtinTools = chunk7ZFSDBM6_cjs.resolveBuiltinTools(options.builtinTools ?? "all" /* ALL */);
+    this._builtinTools = chunkMQXG2CWP_cjs.resolveBuiltinTools(options.builtinTools ?? "all" /* ALL */);
     this._passiveDtmfDebounceMs = options.passiveDtmfDebounceMs ?? 500;
     this._rxGain = _ClawOpsAgent._validateGain("rxGain", options.rxGain ?? 1);
     this._txGain = _ClawOpsAgent._validateGain("txGain", options.txGain ?? 1);
     this._prewarmEnabled = options.prewarmEnabled ?? true;
     this._machineDetection = options.machineDetection;
+    this._onTakenOver = options.onTakenOver;
     if (options.tracing) {
       setTracingConfig(options.tracing);
     }
-    this._log = chunk7ZFSDBM6_cjs.createAgentLogger(options.logger);
-    this._pipelineLog = chunk7ZFSDBM6_cjs.createPipelineLogger(this._log);
+    this._log = chunkMQXG2CWP_cjs.createAgentLogger(options.logger);
+    this._pipelineLog = chunkMQXG2CWP_cjs.createPipelineLogger(this._log);
     this._isPipelineSession = "_stt" in this._session && "_llm" in this._session;
     if (options.toolConfig?.holdAudio) {
       this._holdAudioChunks = loadHoldAudio(options.toolConfig.holdAudio);
@@ -1209,6 +1236,11 @@ var ClawOpsAgent = class _ClawOpsAgent {
   /** Connect to the ClawOps platform and start listening for calls. */
   async connect() {
     if (this._controlWs) return;
+    if (this._takenOver) {
+      throw new chunkMXEZQRIL_cjs.AgentError(
+        `${this._fromNumber} is now served by another process \u2014 reconnecting would evict it. Start a new agent process instead of reconnecting this one.`
+      );
+    }
     if (!this._apiKey) {
       throw new chunkMXEZQRIL_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
     }
@@ -1217,11 +1249,13 @@ var ClawOpsAgent = class _ClawOpsAgent {
         "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
       );
     }
+    this._controlGivenUp = false;
     this._controlWs = new ControlWebSocket({
       baseUrl: this._baseUrl,
       apiKey: this._apiKey,
       accountId: this._accountId,
-      number: this._fromNumber
+      number: this._fromNumber,
+      onTerminalClose: (info) => this._handleTakenOver(info)
     });
     this._controlWs.setLogger(this._log);
     this._controlWs.on("call.incoming", (event) => this._handleIncoming(event));
@@ -1233,7 +1267,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       await this._controlWs.connect();
       await this._controlWs.waitConnected();
       try {
-        this._controlWs.send({ event: "agent.hello", sdk: chunk7ZFSDBM6_cjs.getSdkInfo() });
+        this._controlWs.send({ event: "agent.hello", sdk: chunkMQXG2CWP_cjs.getSdkInfo() });
       } catch {
       }
     } catch (err) {
@@ -1244,21 +1278,140 @@ var ClawOpsAgent = class _ClawOpsAgent {
     this._log.info("ClawOpsAgent connected on %s", this._fromNumber);
   }
   /**
-   * Connect and block until disconnected.
-   * Convenience method for simple agent scripts.
+   * Connect and block until it is time to stop.
+   *
+   * Returns on SIGINT/SIGTERM, or when another process takes over this number — in every case
+   * after `drain()` has let in-flight calls finish. A second signal skips the wait and cuts them.
+   *
+   * Because it returns on takeover, a rolling deploy needs no shutdown wiring: bring the new
+   * instance up, and the old one hands over the number, finishes the calls it still has, and
+   * exits on its own. Give the platform a grace period longer than the drain timeout
+   * (k8s `terminationGracePeriodSeconds`, ECS `stopTimeout`) so it does not SIGKILL mid-drain.
+   *
+   * @param options.drainTimeoutMs Passed through to `drain()`.
    */
-  async serve() {
+  async serve(options) {
     await this.connect();
     return new Promise((resolve) => {
-      const shutdown = () => {
-        this.disconnect().then(resolve).catch(() => resolve());
+      let stopping = false;
+      let signals = 0;
+      const finish = () => {
+        process.off("SIGINT", onSigint);
+        process.off("SIGTERM", onSigterm);
+        this._stopServe = null;
+        resolve();
+      };
+      const stop = (why) => {
+        if (stopping) return;
+        stopping = true;
+        this._log.info("Stopping (%s) \u2014 draining in-flight calls", why);
+        this.drain({ timeoutMs: options?.drainTimeoutMs }).then(finish).catch((err) => {
+          this._log.error({ err }, "Drain failed");
+          finish();
+        });
+      };
+      const onSignal = (why) => {
+        signals += 1;
+        if (signals >= 2) {
+          this._log.warn("Second stop signal (%s) \u2014 ending calls immediately", why);
+          void this.disconnect().finally(finish);
+          return;
+        }
+        if (stopping) {
+          this._log.info(
+            "%s arrived while draining \u2014 still waiting for in-flight calls (signal again to cut)",
+            why
+          );
+          return;
+        }
+        stop(why);
       };
-      process.on("SIGINT", shutdown);
-      process.on("SIGTERM", shutdown);
+      const onSigint = () => onSignal("SIGINT");
+      const onSigterm = () => onSignal("SIGTERM");
+      this._stopServe = stop;
+      process.on("SIGINT", onSigint);
+      process.on("SIGTERM", onSigterm);
     });
   }
+  /**
+   * The server handed this number's control connection to another process.
+   *
+   * Nothing here is an error: it is the normal middle of a rolling deploy, seen from the
+   * instance being replaced. New calls already go to the new process, so all that is left is
+   * to finish the calls we still hold and get out of the way. `serve()` does that by returning;
+   * callers who wired `connect()` themselves get `onTakenOver` and should call `drain()`.
+   */
+  _handleTakenOver(info) {
+    this._takenOver = true;
+    this._log.info(
+      "Another process now serves %s (close %d) \u2014 handing over",
+      this._fromNumber,
+      info.code
+    );
+    this._onTakenOver?.(info);
+    this._stopServe?.("taken over");
+  }
+  /** Whether another process has taken over this number's control connection. */
+  get takenOver() {
+    return this._takenOver;
+  }
+  /**
+   * Stop accepting new calls, let the ones already in progress finish, then disconnect.
+   *
+   * This is what a rolling deploy needs. `disconnect()` cuts live calls mid-sentence, which is
+   * correct when you mean "stop now" and wrong when you mean "hand over". The two are separated
+   * because only the caller knows which one a SIGTERM meant.
+   *
+   * It works because control and media are different connections. Closing the control WebSocket
+   * only gives up this number's delivery slot — the server stops sending us `call.incoming` and
+   * routes new calls to whichever process holds the slot next. Calls already up keep streaming
+   * over their own per-call media connections, which nothing here touches, and each one tears
+   * itself down normally when the caller hangs up.
+   *
+   * Deploy shape this is built for: start the new instance, let it take the slot (the server
+   * hands it over and tells us not to reconnect), then drain the old one. New calls go to the
+   * new instance from the moment it connects; in-flight calls end on the old one. No gap.
+   *
+   * One thing is given up: `endedDuration` on `call_end`. That figure rides the control
+   * connection we just closed, so calls finishing during a drain report a null duration.
+   *
+   * @param options.timeoutMs How long to wait for in-flight calls. Default 120s. Calls still
+   *   running when it expires are ended the way `disconnect()` ends them. Keep the platform's
+   *   own grace period longer than this (k8s `terminationGracePeriodSeconds`, ECS
+   *   `stopTimeout`), or it will SIGKILL the process mid-drain and undo the point of draining.
+   * @returns How many calls ended on their own, and how many had to be cut short.
+   */
+  async drain(options) {
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_DRAIN_TIMEOUT_MS;
+    this._controlGivenUp = true;
+    if (this._controlWs) {
+      this._controlWs.close();
+      this._controlWs = null;
+    }
+    for (const wake of [...this._terminalWaiters.values()]) wake();
+    const inFlight = this._activeSessions.size;
+    if (inFlight === 0) {
+      this._log.info("Drain: no calls in progress");
+      await this.disconnect();
+      return { completed: 0, forced: 0 };
+    }
+    this._log.info("Drain: waiting for %d call(s) to finish (timeout %dms)", inFlight, timeoutMs);
+    const deadline = Date.now() + timeoutMs;
+    while (this._activeSessions.size > 0 && Date.now() < deadline) {
+      await new Promise((resolve) => setTimeout(resolve, DRAIN_POLL_INTERVAL_MS));
+    }
+    const forced = this._activeSessions.size;
+    if (forced > 0) {
+      this._log.warn("Drain timed out \u2014 cutting %d call(s) still in progress", forced);
+    } else {
+      this._log.info("Drain complete: all %d call(s) finished", inFlight);
+    }
+    await this.disconnect();
+    return { completed: inFlight - forced, forced };
+  }
   /** Disconnect from the platform. */
   async disconnect() {
+    this._controlGivenUp = true;
     if (this._controlWs) {
       this._controlWs.close();
       this._controlWs = null;
@@ -1305,7 +1458,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       throw new chunkMXEZQRIL_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
     }
     const data = await resp.json();
-    const callSession = new chunk7ZFSDBM6_cjs.CallSession({
+    const callSession = new chunkMQXG2CWP_cjs.CallSession({
       callId: data["callId"],
       fromNumber: this._fromNumber,
       toNumber: to,
@@ -1329,7 +1482,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
     const callId = event["callId"];
     const fromNumber = event["from"] ?? "";
     const mediaUrl = event["mediaUrl"] ?? "";
-    const session = new chunk7ZFSDBM6_cjs.CallSession({
+    const session = new chunkMQXG2CWP_cjs.CallSession({
       callId,
       fromNumber,
       toNumber: this._fromNumber,
@@ -1363,6 +1516,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
    */
   async _awaitServerTerminal(session) {
     if (session.endedDuration !== null) return;
+    if (this._controlGivenUp) return;
     await new Promise((resolve) => {
       const done = () => {
         clearTimeout(timer);
@@ -1430,7 +1584,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
     const mediaUrl = event["mediaUrl"] ?? "";
     let session = this._activeSessions.get(callId);
     if (!session) {
-      session = new chunk7ZFSDBM6_cjs.CallSession({
+      session = new chunkMQXG2CWP_cjs.CallSession({
         callId,
         fromNumber: this._fromNumber,
         toNumber: event["to"] ?? "",
@@ -1632,9 +1786,9 @@ var ClawOpsAgent = class _ClawOpsAgent {
         let latestMediaTs = 0;
         session._bindTransport(
           (audio) => {
-            const gained = chunk7ZFSDBM6_cjs.applyUlawGain(audio, this._txGain);
+            const gained = chunkMQXG2CWP_cjs.applyUlawGain(audio, this._txGain);
             if (recorder) {
-              recorder.writeOutbound(chunk7ZFSDBM6_cjs.ulawToPcm16(gained), latestMediaTs);
+              recorder.writeOutbound(chunkMQXG2CWP_cjs.ulawToPcm16(gained), latestMediaTs);
             }
             mediaWs.sendAudio(gained.toString("base64"));
             session.recordFirstResponse();
@@ -1655,7 +1809,15 @@ var ClawOpsAgent = class _ClawOpsAgent {
           },
           () => mediaWs.isConnected
         );
-        session._transferFn = (params) => this._controlWs.requestTransfer(session.callId, params);
+        session._transferFn = (params) => {
+          const controlWs = this._controlWs;
+          if (!controlWs) {
+            throw new chunkMXEZQRIL_cjs.AgentError(
+              "transfer unavailable: the control connection is closed (draining, or this number was taken over)"
+            );
+          }
+          return controlWs.requestTransfer(session.callId, params);
+        };
         session._sendMark = (name) => mediaWs.sendMark(name);
         session._waitForMark = (name, timeoutMs) => mediaWs.waitForMark(name, timeoutMs);
         session._flushTransport = () => mediaWs.flush();
@@ -1664,9 +1826,9 @@ var ClawOpsAgent = class _ClawOpsAgent {
         this._callSessions.set(session.callId, sessionHandler);
         mediaWs.onAudio((ulawAudio, timestamp) => {
           latestMediaTs = timestamp;
-          const gained = chunk7ZFSDBM6_cjs.applyUlawGain(ulawAudio, this._rxGain);
+          const gained = chunkMQXG2CWP_cjs.applyUlawGain(ulawAudio, this._rxGain);
           if (recorder) {
-            recorder.writeInbound(chunk7ZFSDBM6_cjs.ulawToPcm16(gained), timestamp);
+            recorder.writeInbound(chunkMQXG2CWP_cjs.ulawToPcm16(gained), timestamp);
           }
           if (sessionHandler) {
             sessionHandler.feedAudio(gained, timestamp);
@@ -1782,7 +1944,7 @@ var PipelineSession = class {
   _speaking = false;
   _builtinTools = null;
   _holdAudioChunks = null;
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   constructor(options) {
     this._stt = options.stt;
     this._llm = options.llm;
@@ -1844,7 +2006,7 @@ var PipelineSession = class {
    */
   async prewarm(tools) {
     if (tools) this._tools = tools;
-    this._callSession = new chunk7ZFSDBM6_cjs.BufferingCall();
+    this._callSession = new chunkMQXG2CWP_cjs.BufferingCall();
     this._running = true;
     this._conversation = [];
     this._log.info("PipelineSession prewarmed");
@@ -1867,7 +2029,7 @@ var PipelineSession = class {
   async attach(callSession) {
     const prev = this._callSession;
     this._callSession = callSession;
-    chunk7ZFSDBM6_cjs.attachBuffered(prev, callSession);
+    chunkMQXG2CWP_cjs.attachBuffered(prev, callSession);
   }
   async start(callSession, tools) {
     this._tools = tools ?? null;
@@ -1914,8 +2076,8 @@ var PipelineSession = class {
     while (this._running) {
       if (this._audioBuffer.length > 0) {
         const ulaw = this._audioBuffer.shift();
-        const pcm8k = chunk7ZFSDBM6_cjs.ulawToPcm16(ulaw);
-        const pcm16k = chunk7ZFSDBM6_cjs.resamplePcm16(pcm8k, 8e3, 16e3);
+        const pcm8k = chunkMQXG2CWP_cjs.ulawToPcm16(ulaw);
+        const pcm16k = chunkMQXG2CWP_cjs.resamplePcm16(pcm8k, 8e3, 16e3);
         yield pcm16k;
       } else {
         await new Promise((resolve) => setTimeout(resolve, 20));
@@ -1931,7 +2093,7 @@ var PipelineSession = class {
     await this._respond();
   }
   _buildEffectiveTools() {
-    const builtinSchemas = chunk7ZFSDBM6_cjs.getBuiltinToolSchemas(this._builtinTools, "chat");
+    const builtinSchemas = chunkMQXG2CWP_cjs.getBuiltinToolSchemas(this._builtinTools, "chat");
     const dtmfSchemas = builtinSchemas.filter((s) => {
       const name = s["function"]?.["name"];
       return name === "collect_dtmf" || name === "send_dtmf";
@@ -1980,8 +2142,8 @@ var PipelineSession = class {
     const { id, name, arguments: argsStr } = chunk.toolCall;
     try {
       const args = JSON.parse(argsStr);
-      if (chunk7ZFSDBM6_cjs.BUILTIN_TOOL_NAMES.has(name) && this._callSession && !(this._callSession instanceof chunk7ZFSDBM6_cjs.BufferingCall)) {
-        const result2 = await chunk7ZFSDBM6_cjs.executeBuiltinTool(name, args, this._callSession);
+      if (chunkMQXG2CWP_cjs.BUILTIN_TOOL_NAMES.has(name) && this._callSession && !(this._callSession instanceof chunkMQXG2CWP_cjs.BufferingCall)) {
+        const result2 = await chunkMQXG2CWP_cjs.executeBuiltinTool(name, args, this._callSession);
         if (result2 !== null) {
           if (name === "hang_up") return;
           this._conversation.push({ role: "tool", content: result2, tool_call_id: id, name });
@@ -1989,11 +2151,11 @@ var PipelineSession = class {
           return;
         }
       }
-      if (chunk7ZFSDBM6_cjs.BUILTIN_TOOL_NAMES.has(name) && this._callSession instanceof chunk7ZFSDBM6_cjs.BufferingCall) {
+      if (chunkMQXG2CWP_cjs.BUILTIN_TOOL_NAMES.has(name) && this._callSession instanceof chunkMQXG2CWP_cjs.BufferingCall) {
         this._log.warn("Builtin tool %s called before answer \u2014 deferring", name);
         this._conversation.push({
           role: "tool",
-          content: chunk7ZFSDBM6_cjs.CALL_NOT_READY_RESULT,
+          content: chunkMQXG2CWP_cjs.CALL_NOT_READY_RESULT,
           tool_call_id: id,
           name
         });
@@ -2002,7 +2164,7 @@ var PipelineSession = class {
       }
       if (!this._tools) return;
       this._callSession?.recordToolCall();
-      const player = this._holdAudioChunks && this._callSession && !(this._callSession instanceof chunk7ZFSDBM6_cjs.BufferingCall) ? new HoldAudioPlayer(this._callSession, this._holdAudioChunks) : null;
+      const player = this._holdAudioChunks && this._callSession && !(this._callSession instanceof chunkMQXG2CWP_cjs.BufferingCall) ? new HoldAudioPlayer(this._callSession, this._holdAudioChunks) : null;
       player?.start();
       let result;
       try {
@@ -2053,8 +2215,8 @@ var PipelineSession = class {
         sampleRate: this._sampleRate
       })) {
         if (!this._running || !this._speaking) break;
-        const pcm8k = chunk7ZFSDBM6_cjs.resamplePcm16(audioChunk, this._sampleRate, 8e3);
-        const ulaw = chunk7ZFSDBM6_cjs.pcm16ToUlaw(pcm8k);
+        const pcm8k = chunkMQXG2CWP_cjs.resamplePcm16(audioChunk, this._sampleRate, 8e3);
+        const ulaw = chunkMQXG2CWP_cjs.pcm16ToUlaw(pcm8k);
         for (let off = 0; off < ulaw.length; off += 160) {
           let chunk = ulaw.subarray(off, off + 160);
           if (chunk.length < 160) {
@@ -2081,7 +2243,7 @@ var OpenAIRealtime = class {
   _language;
   _turnDetection;
   _greeting;
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   _builtinTools = null;
   /**
    * 마지막 session.update 로 LLM 에 알린 tool 이름들. attach() 가 이 값과 현재
@@ -2158,7 +2320,7 @@ var OpenAIRealtime = class {
   /** Open WS + session.update + (optional) response.create without a CallSession. */
   async prewarm(tools) {
     if (tools) this._tools = tools;
-    this._call = new chunk7ZFSDBM6_cjs.BufferingCall();
+    this._call = new chunkMQXG2CWP_cjs.BufferingCall();
     this._closed = false;
     this._playback = null;
     this._latestMediaTs = 0;
@@ -2200,7 +2362,7 @@ var OpenAIRealtime = class {
     this._resyncTools();
     const prev = this._call;
     this._call = callSession;
-    chunk7ZFSDBM6_cjs.attachBuffered(prev, callSession);
+    chunkMQXG2CWP_cjs.attachBuffered(prev, callSession);
   }
   async start(callSession, tools) {
     if (tools) this._tools = tools;
@@ -2261,7 +2423,7 @@ var OpenAIRealtime = class {
   /** Current tool schemas: user tools + builtin tools (flat realtime format). */
   _currentToolSchemas() {
     const toolSchemas = this._tools ? this._tools.toOpenAITools().map((t) => ({ type: "function", ...t.function })) : [];
-    toolSchemas.push(...chunk7ZFSDBM6_cjs.getBuiltinToolSchemas(this._builtinTools, "realtime"));
+    toolSchemas.push(...chunkMQXG2CWP_cjs.getBuiltinToolSchemas(this._builtinTools, "realtime"));
     return toolSchemas;
   }
   /**
@@ -2432,9 +2594,9 @@ var OpenAIRealtime = class {
     const controller = new AbortController();
     this._pendingToolCalls.set(callId, controller);
     try {
-      if (chunk7ZFSDBM6_cjs.BUILTIN_TOOL_NAMES.has(funcName) && this._call && !(this._call instanceof chunk7ZFSDBM6_cjs.BufferingCall)) {
+      if (chunkMQXG2CWP_cjs.BUILTIN_TOOL_NAMES.has(funcName) && this._call && !(this._call instanceof chunkMQXG2CWP_cjs.BufferingCall)) {
         const args = JSON.parse(item["arguments"] ?? "{}");
-        const result2 = await chunk7ZFSDBM6_cjs.executeBuiltinTool(funcName, args, this._call);
+        const result2 = await chunkMQXG2CWP_cjs.executeBuiltinTool(funcName, args, this._call);
         if (result2 !== null) {
           if (funcName === "hang_up") return;
           if (controller.signal.aborted) return;
@@ -2451,7 +2613,7 @@ var OpenAIRealtime = class {
           return;
         }
       }
-      if (chunk7ZFSDBM6_cjs.BUILTIN_TOOL_NAMES.has(funcName) && this._call instanceof chunk7ZFSDBM6_cjs.BufferingCall) {
+      if (chunkMQXG2CWP_cjs.BUILTIN_TOOL_NAMES.has(funcName) && this._call instanceof chunkMQXG2CWP_cjs.BufferingCall) {
         this._log.warn("Builtin tool %s called before answer \u2014 deferring", funcName);
         await this._waitForResponseDone();
         this._send({
@@ -2459,7 +2621,7 @@ var OpenAIRealtime = class {
           item: {
             type: "function_call_output",
             call_id: callId,
-            output: chunk7ZFSDBM6_cjs.CALL_NOT_READY_RESULT
+            output: chunkMQXG2CWP_cjs.CALL_NOT_READY_RESULT
           }
         });
         this._send({ type: "response.create" });
@@ -2480,7 +2642,7 @@ var OpenAIRealtime = class {
         return;
       }
       let result;
-      const player = this._holdAudioChunks && this._call && !(this._call instanceof chunk7ZFSDBM6_cjs.BufferingCall) ? new HoldAudioPlayer(this._call, this._holdAudioChunks) : null;
+      const player = this._holdAudioChunks && this._call && !(this._call instanceof chunkMQXG2CWP_cjs.BufferingCall) ? new HoldAudioPlayer(this._call, this._holdAudioChunks) : null;
       player?.start();
       try {
         const args = JSON.parse(item["arguments"] ?? "{}");
@@ -2629,7 +2791,7 @@ var GeminiRealtime = class _GeminiRealtime {
   _toolDrainTimer = null;
   _lastAudioTime = 0;
   _holdAudioChunks = null;
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   constructor(options = {}) {
     this._apiKey = options.apiKey ?? process.env["GOOGLE_API_KEY"] ?? "";
     this._systemPrompt = options.systemPrompt ?? "";
@@ -2675,7 +2837,7 @@ var GeminiRealtime = class _GeminiRealtime {
   /** Open Live session (no CallSession). Audio deltas accumulate into BufferingCall until attach(). */
   async prewarm(tools) {
     if (tools) this._tools = tools;
-    this._call = new chunk7ZFSDBM6_cjs.BufferingCall();
+    this._call = new chunkMQXG2CWP_cjs.BufferingCall();
     this._closed = false;
     this._sentAudioChunks = 0;
     this._audioRemainder = Buffer.alloc(0);
@@ -2732,7 +2894,7 @@ var GeminiRealtime = class _GeminiRealtime {
   async attach(callSession) {
     const prev = this._call;
     this._call = callSession;
-    chunk7ZFSDBM6_cjs.attachBuffered(prev, callSession);
+    chunkMQXG2CWP_cjs.attachBuffered(prev, callSession);
   }
   async start(callSession, tools) {
     if (tools) this._tools = tools;
@@ -2741,8 +2903,8 @@ var GeminiRealtime = class _GeminiRealtime {
   }
   feedAudio(audio) {
     if (this._session && !this._closed) {
-      const pcm8k = chunk7ZFSDBM6_cjs.ulawToPcm16(audio);
-      const pcm16k = chunk7ZFSDBM6_cjs.resamplePcm16(pcm8k, 8e3, 16e3);
+      const pcm8k = chunkMQXG2CWP_cjs.ulawToPcm16(audio);
+      const pcm16k = chunkMQXG2CWP_cjs.resamplePcm16(pcm8k, 8e3, 16e3);
       this._session.sendRealtimeInput({
         audio: {
           data: Buffer.from(pcm16k).toString("base64"),
@@ -2786,7 +2948,7 @@ var GeminiRealtime = class _GeminiRealtime {
         t.function.parameters ?? { type: "object", properties: {} }
       )
     })) : [];
-    toolDefs.push(...chunk7ZFSDBM6_cjs.getBuiltinToolSchemas(this._builtinTools, "gemini"));
+    toolDefs.push(...chunkMQXG2CWP_cjs.getBuiltinToolSchemas(this._builtinTools, "gemini"));
     return toolDefs;
   }
   _handleMessage(msg) {
@@ -2846,8 +3008,8 @@ var GeminiRealtime = class _GeminiRealtime {
   _handleAudioData(b64Data) {
     if (!this._call) return;
     const pcm24k = Buffer.from(b64Data, "base64");
-    const pcm8k = chunk7ZFSDBM6_cjs.resamplePcm16(pcm24k, 24e3, 8e3);
-    const ulaw = chunk7ZFSDBM6_cjs.pcm16ToUlaw(pcm8k);
+    const pcm8k = chunkMQXG2CWP_cjs.resamplePcm16(pcm24k, 24e3, 8e3);
+    const ulaw = chunkMQXG2CWP_cjs.pcm16ToUlaw(pcm8k);
     const combined = Buffer.concat([this._audioRemainder, ulaw]);
     const chunkSize = 160;
     const fullEnd = Math.floor(combined.length / chunkSize) * chunkSize;
@@ -2890,7 +3052,7 @@ var GeminiRealtime = class _GeminiRealtime {
     const functionCalls = toolCall.functionCalls;
     if (!functionCalls) return;
     const responses = [];
-    const player = this._holdAudioChunks && this._call && !(this._call instanceof chunk7ZFSDBM6_cjs.BufferingCall) ? new HoldAudioPlayer(this._call, this._holdAudioChunks) : null;
+    const player = this._holdAudioChunks && this._call && !(this._call instanceof chunkMQXG2CWP_cjs.BufferingCall) ? new HoldAudioPlayer(this._call, this._holdAudioChunks) : null;
     player?.start();
     try {
       for (const fc of functionCalls) {
@@ -2898,8 +3060,8 @@ var GeminiRealtime = class _GeminiRealtime {
         const fcId = fc.id ?? "";
         const args = fc.args ?? {};
         this._log.info({ tool: name, args }, "Tool call: %s", name);
-        if (chunk7ZFSDBM6_cjs.BUILTIN_TOOL_NAMES.has(name) && this._call && !(this._call instanceof chunk7ZFSDBM6_cjs.BufferingCall)) {
-          const result = await chunk7ZFSDBM6_cjs.executeBuiltinTool(
+        if (chunkMQXG2CWP_cjs.BUILTIN_TOOL_NAMES.has(name) && this._call && !(this._call instanceof chunkMQXG2CWP_cjs.BufferingCall)) {
+          const result = await chunkMQXG2CWP_cjs.executeBuiltinTool(
             name,
             args,
             this._call
@@ -2914,9 +3076,9 @@ var GeminiRealtime = class _GeminiRealtime {
             continue;
           }
         }
-        if (chunk7ZFSDBM6_cjs.BUILTIN_TOOL_NAMES.has(name) && this._call instanceof chunk7ZFSDBM6_cjs.BufferingCall) {
+        if (chunkMQXG2CWP_cjs.BUILTIN_TOOL_NAMES.has(name) && this._call instanceof chunkMQXG2CWP_cjs.BufferingCall) {
           this._log.warn("Builtin tool %s called before answer \u2014 deferring", name);
-          responses.push({ id: fcId, name, response: { result: chunk7ZFSDBM6_cjs.CALL_NOT_READY_RESULT } });
+          responses.push({ id: fcId, name, response: { result: chunkMQXG2CWP_cjs.CALL_NOT_READY_RESULT } });
           continue;
         }
         if (!this._tools || !this._tools.has(name)) {
@@ -2961,7 +3123,7 @@ var GeminiRealtime = class _GeminiRealtime {
 // src/agent/pipeline/stt/deepgram-stt.ts
 var DeepgramSTT = class {
   _options;
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   get provider() {
     return "deepgram";
   }
@@ -3088,7 +3250,7 @@ var DeepgramSTT = class {
 // src/agent/pipeline/tts/elevenlabs-tts.ts
 var ElevenLabsTTS = class {
   _options;
-  _log = chunk7ZFSDBM6_cjs.NOOP_LOGGER;
+  _log = chunkMQXG2CWP_cjs.NOOP_LOGGER;
   get provider() {
     return "elevenlabs";
   }
@@ -3834,55 +3996,55 @@ function mcpServerHTTP(options) {
 
 Object.defineProperty(exports, "BUILTIN_TOOL_NAMES", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.BUILTIN_TOOL_NAMES; }
+  get: function () { return chunkMQXG2CWP_cjs.BUILTIN_TOOL_NAMES; }
 });
 Object.defineProperty(exports, "BuiltinTool", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.BuiltinTool; }
+  get: function () { return chunkMQXG2CWP_cjs.BuiltinTool; }
 });
 Object.defineProperty(exports, "CallSession", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.CallSession; }
+  get: function () { return chunkMQXG2CWP_cjs.CallSession; }
 });
 Object.defineProperty(exports, "DECODE_TABLE", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.DECODE_TABLE; }
+  get: function () { return chunkMQXG2CWP_cjs.DECODE_TABLE; }
 });
 Object.defineProperty(exports, "DtmfCollectorBusyError", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.DtmfCollectorBusyError; }
+  get: function () { return chunkMQXG2CWP_cjs.DtmfCollectorBusyError; }
 });
 Object.defineProperty(exports, "createAgentLogger", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.createAgentLogger; }
+  get: function () { return chunkMQXG2CWP_cjs.createAgentLogger; }
 });
 Object.defineProperty(exports, "createPipelineLogger", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.createPipelineLogger; }
+  get: function () { return chunkMQXG2CWP_cjs.createPipelineLogger; }
 });
 Object.defineProperty(exports, "executeBuiltinTool", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.executeBuiltinTool; }
+  get: function () { return chunkMQXG2CWP_cjs.executeBuiltinTool; }
 });
 Object.defineProperty(exports, "getBuiltinToolSchemas", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.getBuiltinToolSchemas; }
+  get: function () { return chunkMQXG2CWP_cjs.getBuiltinToolSchemas; }
 });
 Object.defineProperty(exports, "isBuiltinTool", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.isBuiltinTool; }
+  get: function () { return chunkMQXG2CWP_cjs.isBuiltinTool; }
 });
 Object.defineProperty(exports, "pcm16ToUlaw", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.pcm16ToUlaw; }
+  get: function () { return chunkMQXG2CWP_cjs.pcm16ToUlaw; }
 });
 Object.defineProperty(exports, "resamplePcm16", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.resamplePcm16; }
+  get: function () { return chunkMQXG2CWP_cjs.resamplePcm16; }
 });
 Object.defineProperty(exports, "ulawToPcm16", {
   enumerable: true,
-  get: function () { return chunk7ZFSDBM6_cjs.ulawToPcm16; }
+  get: function () { return chunkMQXG2CWP_cjs.ulawToPcm16; }
 });
 exports.AnthropicLLM = AnthropicLLM;
 exports.AudioRecorder = AudioRecorder;