@teamlearners/clawops 0.25.0 → 0.26.0

package/README.md

@@ -195,19 +195,6 @@ const done = await client.calls.get(amdCall.callId);
 console.log(done.answeredBy);
 // statusCallback 을 설정했다면 completed 이벤트 payload 의 AnsweredBy 로도 통보됩니다.
 
-// AI Completion 모드 — AI가 직접 통화를 처리
-const aiCall = await client.calls.create({
-  to: '01012345678',
-  from: '07052358010',
-  ai: {
-    provider: 'openai',
-    model: 'gpt-realtime',
-    apiKey: process.env.OPENAI_API_KEY!,
-    voice: 'marin',
-    messages: [{ role: 'system', content: '당신은 예약 확인 AI입니다.' }],
-  },
-});
-
 // 통화 목록 조회 (페이지네이션)
 const page = await client.calls.list({ status: 'completed', page: 0, pageSize: 20 });
 for (const call of page) {

package/dist/agent/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkIVJXHNUN_cjs = require('../chunk-IVJXHNUN.cjs');
-var chunkU4UFTVLX_cjs = require('../chunk-U4UFTVLX.cjs');
+var chunkAF2MNFN4_cjs = require('../chunk-AF2MNFN4.cjs');
+var chunkXAOA3XFQ_cjs = require('../chunk-XAOA3XFQ.cjs');
 var fs = require('fs');
 var path = require('path');
 var os = require('os');
@@ -59,7 +59,7 @@ var ControlWebSocket = class {
   _closed = false;
   _connectedResolve = null;
   _connectedPromise;
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   _pingTimer = null;
   setLogger(logger) {
     this._log = logger;
@@ -224,7 +224,7 @@ var ControlWebSocket = class {
 var MCPClient = class {
   _servers = /* @__PURE__ */ new Map();
   _clients = /* @__PURE__ */ new Map();
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   setLogger(logger) {
     this._log = logger;
   }
@@ -366,7 +366,7 @@ var MediaWebSocket = class {
   _onClose = null;
   _onDtmf = null;
   _markWaiters = /* @__PURE__ */ new Map();
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   setLogger(logger) {
     this._log = logger;
   }
@@ -592,7 +592,7 @@ var AudioRecorder = class {
   _started = false;
   _baseTs = null;
   _outCursor = 0;
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   setLogger(logger) {
     this._log = logger;
   }
@@ -728,7 +728,7 @@ var MAX_ERROR_MESSAGE_LENGTH = 200;
 function getSdkInfo() {
   return {
     name: "clawops-node",
-    version: chunkIVJXHNUN_cjs.VERSION,
+    version: chunkAF2MNFN4_cjs.VERSION,
     runtime: `node/${process.versions.node}`,
     os: `${process.platform}/${os__default.default.arch()}`
   };
@@ -788,7 +788,7 @@ var CallSession = class {
   _dtmfCollectorActive = false;
   _dtmfResolvers = [];
   _dtmfBuffer = [];
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   _handlers = /* @__PURE__ */ new Map();
   _endedPromise;
   _resolveEnded;
@@ -1105,7 +1105,7 @@ function generateComfortTone(volume = 0.12) {
     }
   }
   const pcm = int16ArrayToBuffer(concatInt16Arrays(...parts));
-  const ulaw = chunkU4UFTVLX_cjs.pcm16ToUlaw(pcm);
+  const ulaw = chunkXAOA3XFQ_cjs.pcm16ToUlaw(pcm);
   const chunks = [];
   for (let i = 0; i < ulaw.length; i += CHUNK_SIZE) {
     chunks.push(ulaw.subarray(i, i + CHUNK_SIZE));
@@ -1162,9 +1162,9 @@ function loadHoldAudio(source) {
       pcmData = mono;
     }
     if (sampleRate !== SAMPLE_RATE2) {
-      pcmData = chunkU4UFTVLX_cjs.resamplePcm16(pcmData, sampleRate, SAMPLE_RATE2);
+      pcmData = chunkXAOA3XFQ_cjs.resamplePcm16(pcmData, sampleRate, SAMPLE_RATE2);
     }
-    const ulaw = chunkU4UFTVLX_cjs.pcm16ToUlaw(pcmData);
+    const ulaw = chunkXAOA3XFQ_cjs.pcm16ToUlaw(pcmData);
     const chunks = [];
     for (let i = 0; i < ulaw.length; i += CHUNK_SIZE) {
       chunks.push(ulaw.subarray(i, i + CHUNK_SIZE));
@@ -1433,13 +1433,13 @@ var ClawOpsAgent = class _ClawOpsAgent {
   constructor(options) {
     this._apiKey = options.apiKey ?? process.env["CLAWOPS_API_KEY"] ?? "";
     this._accountId = options.accountId ?? process.env["CLAWOPS_ACCOUNT_ID"] ?? "";
-    this._baseUrl = options.baseUrl ?? chunkIVJXHNUN_cjs.DEFAULT_BASE_URL;
+    this._baseUrl = options.baseUrl ?? chunkAF2MNFN4_cjs.DEFAULT_BASE_URL;
     this._fromNumber = options.from;
     this._session = options.session;
     this._recording = options.recording ?? false;
     this._recordingPath = options.recordingPath ?? "./recordings";
     this._mcpServers = options.mcpServers ?? [];
-    this._builtinTools = chunkU4UFTVLX_cjs.resolveBuiltinTools(options.builtinTools ?? "all" /* ALL */);
+    this._builtinTools = chunkXAOA3XFQ_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);
@@ -1448,8 +1448,8 @@ var ClawOpsAgent = class _ClawOpsAgent {
     if (options.tracing) {
       setTracingConfig(options.tracing);
     }
-    this._log = chunkU4UFTVLX_cjs.createAgentLogger(options.logger);
-    this._pipelineLog = chunkU4UFTVLX_cjs.createPipelineLogger(this._log);
+    this._log = chunkXAOA3XFQ_cjs.createAgentLogger(options.logger);
+    this._pipelineLog = chunkXAOA3XFQ_cjs.createPipelineLogger(this._log);
     this._isPipelineSession = "_stt" in this._session && "_llm" in this._session;
     if (options.toolConfig?.holdAudio) {
       this._holdAudioChunks = loadHoldAudio(options.toolConfig.holdAudio);
@@ -1457,7 +1457,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   }
   static _validateGain(name, gain) {
     if (typeof gain !== "number" || !Number.isFinite(gain) || gain < 0) {
-      throw new chunkIVJXHNUN_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
+      throw new chunkAF2MNFN4_cjs.AgentError(`${name}=${gain} must be a finite number >= 0`);
     }
     return gain;
   }
@@ -1471,7 +1471,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
   tool(nameOrTool, description, parameters, handler) {
     if (typeof nameOrTool === "string") {
       if (!description || !parameters || !handler) {
-        throw new chunkIVJXHNUN_cjs.AgentError(
+        throw new chunkAF2MNFN4_cjs.AgentError(
           "tool(name, description, parameters, handler) requires all arguments."
         );
       }
@@ -1507,10 +1507,10 @@ var ClawOpsAgent = class _ClawOpsAgent {
   async connect() {
     if (this._controlWs) return;
     if (!this._apiKey) {
-      throw new chunkIVJXHNUN_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
+      throw new chunkAF2MNFN4_cjs.AgentError("API key is required. Set CLAWOPS_API_KEY or pass apiKey option.");
     }
     if (!this._accountId) {
-      throw new chunkIVJXHNUN_cjs.AgentError(
+      throw new chunkAF2MNFN4_cjs.AgentError(
         "Account ID is required. Set CLAWOPS_ACCOUNT_ID or pass accountId option."
       );
     }
@@ -1534,7 +1534,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
       } catch {
       }
     } catch (err) {
-      throw new chunkIVJXHNUN_cjs.AgentConnectionError(
+      throw new chunkAF2MNFN4_cjs.AgentConnectionError(
         `Failed to connect to ClawOps: ${err instanceof Error ? err.message : String(err)}`
       );
     }
@@ -1598,7 +1598,7 @@ var ClawOpsAgent = class _ClawOpsAgent {
     });
     if (resp.status !== 201) {
       const error = await resp.json();
-      throw new chunkIVJXHNUN_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
+      throw new chunkAF2MNFN4_cjs.AgentError(`\uBC1C\uC2E0 \uC2E4\uD328 (${resp.status}): ${error["error"] ?? ""}`);
     }
     const data = await resp.json();
     const callSession = new CallSession({
@@ -1722,10 +1722,43 @@ var ClawOpsAgent = class _ClawOpsAgent {
    * multiple times — only the first invocation starts the task. Failures are
    * recorded in _prewarmFailed so the call-session path can fall back to start().
    */
+  /**
+   * 세션에 콜별 의존성(도구·내장도구·hold audio·recorder·logger)을 주입한다.
+   *
+   * prewarm 과 _startCallSession 양쪽에서 부른다. prewarm 은 세션이 LLM 에 보낼
+   * tool 스키마를 그 시점에 확정하므로(OpenAI session.update / Gemini live connect
+   * config), prewarm **전에** 최소 한 번은 도구가 들어가 있어야 한다.
+   */
+  _injectSessionDeps(tools, recorder) {
+    const sessionHandler = this._session;
+    if ("setToolRegistry" in sessionHandler && typeof sessionHandler.setToolRegistry === "function") {
+      sessionHandler.setToolRegistry(tools);
+    }
+    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);
+    }
+    if (this._holdAudioChunks && "setHoldAudio" in sessionHandler && typeof sessionHandler.setHoldAudio === "function") {
+      sessionHandler.setHoldAudio(this._holdAudioChunks);
+    }
+  }
   _startPrewarm(callId) {
     if (this._prewarmTasks.has(callId)) return;
     const sessionHandler = this._session;
     if (typeof sessionHandler.prewarm !== "function") return;
+    if (this._mcpServers.length > 0 && sessionHandler.toolsFrozenAfterPrewarm) {
+      this._log.info(
+        { callId },
+        "Skipping prewarm \u2014 \uC138\uC158\uC774 \uC5F0\uACB0 \uD6C4 \uB3C4\uAD6C \uBCC0\uACBD\uC744 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC544 MCP \uB3C4\uAD6C\uAC00 \uB204\uB77D\uB41C\uB2E4."
+      );
+      return;
+    }
+    this._injectSessionDeps(this._tools.fork());
     const PREWARM_TIMEOUT_MS = 1e4;
     const t0 = Date.now();
     this._log.info(`[PREWARM-T] start call_id=${callId} t=${(t0 / 1e3).toFixed(3)}`);
@@ -1863,9 +1896,9 @@ var ClawOpsAgent = class _ClawOpsAgent {
         let latestMediaTs = 0;
         session._bindTransport(
           (audio) => {
-            const gained = chunkU4UFTVLX_cjs.applyUlawGain(audio, this._txGain);
+            const gained = chunkXAOA3XFQ_cjs.applyUlawGain(audio, this._txGain);
             if (recorder) {
-              recorder.writeOutbound(chunkU4UFTVLX_cjs.ulawToPcm16(gained), latestMediaTs);
+              recorder.writeOutbound(chunkXAOA3XFQ_cjs.ulawToPcm16(gained), latestMediaTs);
             }
             mediaWs.sendAudio(gained.toString("base64"));
             session.recordFirstResponse();
@@ -1891,27 +1924,13 @@ var ClawOpsAgent = class _ClawOpsAgent {
         session._waitForMark = (name, timeoutMs) => mediaWs.waitForMark(name, timeoutMs);
         session._flushTransport = () => mediaWs.flush();
         const sessionHandler = this._session;
-        if ("setToolRegistry" in sessionHandler && typeof sessionHandler.setToolRegistry === "function") {
-          sessionHandler.setToolRegistry(sessionTools);
-        }
-        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);
-        }
-        if (this._holdAudioChunks && "setHoldAudio" in sessionHandler && typeof sessionHandler.setHoldAudio === "function") {
-          sessionHandler.setHoldAudio(this._holdAudioChunks);
-        }
+        this._injectSessionDeps(sessionTools, recorder);
         this._callSessions.set(session.callId, sessionHandler);
         mediaWs.onAudio((ulawAudio, timestamp) => {
           latestMediaTs = timestamp;
-          const gained = chunkU4UFTVLX_cjs.applyUlawGain(ulawAudio, this._rxGain);
+          const gained = chunkXAOA3XFQ_cjs.applyUlawGain(ulawAudio, this._rxGain);
           if (recorder) {
-            recorder.writeInbound(chunkU4UFTVLX_cjs.ulawToPcm16(gained), timestamp);
+            recorder.writeInbound(chunkXAOA3XFQ_cjs.ulawToPcm16(gained), timestamp);
           }
           if (sessionHandler) {
             sessionHandler.feedAudio(gained, timestamp);
@@ -2026,7 +2045,7 @@ var PipelineSession = class {
   _speaking = false;
   _builtinTools = null;
   _holdAudioChunks = null;
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   constructor(options) {
     this._stt = options.stt;
     this._llm = options.llm;
@@ -2088,7 +2107,7 @@ var PipelineSession = class {
    */
   async prewarm(tools) {
     if (tools) this._tools = tools;
-    this._callSession = new chunkU4UFTVLX_cjs.BufferingCall();
+    this._callSession = new chunkXAOA3XFQ_cjs.BufferingCall();
     this._running = true;
     this._conversation = [];
     this._log.info("PipelineSession prewarmed");
@@ -2111,7 +2130,7 @@ var PipelineSession = class {
   async attach(callSession) {
     const prev = this._callSession;
     this._callSession = callSession;
-    chunkU4UFTVLX_cjs.attachBuffered(prev, callSession);
+    chunkXAOA3XFQ_cjs.attachBuffered(prev, callSession);
   }
   async start(callSession, tools) {
     this._tools = tools ?? null;
@@ -2158,8 +2177,8 @@ var PipelineSession = class {
     while (this._running) {
       if (this._audioBuffer.length > 0) {
         const ulaw = this._audioBuffer.shift();
-        const pcm8k = chunkU4UFTVLX_cjs.ulawToPcm16(ulaw);
-        const pcm16k = chunkU4UFTVLX_cjs.resamplePcm16(pcm8k, 8e3, 16e3);
+        const pcm8k = chunkXAOA3XFQ_cjs.ulawToPcm16(ulaw);
+        const pcm16k = chunkXAOA3XFQ_cjs.resamplePcm16(pcm8k, 8e3, 16e3);
         yield pcm16k;
       } else {
         await new Promise((resolve) => setTimeout(resolve, 20));
@@ -2175,7 +2194,7 @@ var PipelineSession = class {
     await this._respond();
   }
   _buildEffectiveTools() {
-    const builtinSchemas = chunkU4UFTVLX_cjs.getBuiltinToolSchemas(this._builtinTools, "chat");
+    const builtinSchemas = chunkXAOA3XFQ_cjs.getBuiltinToolSchemas(this._builtinTools, "chat");
     const dtmfSchemas = builtinSchemas.filter((s) => {
       const name = s["function"]?.["name"];
       return name === "collect_dtmf" || name === "send_dtmf";
@@ -2224,8 +2243,8 @@ var PipelineSession = class {
     const { id, name, arguments: argsStr } = chunk.toolCall;
     try {
       const args = JSON.parse(argsStr);
-      if (chunkU4UFTVLX_cjs.BUILTIN_TOOL_NAMES.has(name) && this._callSession && !(this._callSession instanceof chunkU4UFTVLX_cjs.BufferingCall)) {
-        const result2 = await chunkU4UFTVLX_cjs.executeBuiltinTool(name, args, this._callSession);
+      if (chunkXAOA3XFQ_cjs.BUILTIN_TOOL_NAMES.has(name) && this._callSession && !(this._callSession instanceof chunkXAOA3XFQ_cjs.BufferingCall)) {
+        const result2 = await chunkXAOA3XFQ_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 });
@@ -2233,9 +2252,20 @@ var PipelineSession = class {
           return;
         }
       }
+      if (chunkXAOA3XFQ_cjs.BUILTIN_TOOL_NAMES.has(name) && this._callSession instanceof chunkXAOA3XFQ_cjs.BufferingCall) {
+        this._log.warn("Builtin tool %s called before answer \u2014 deferring", name);
+        this._conversation.push({
+          role: "tool",
+          content: chunkXAOA3XFQ_cjs.CALL_NOT_READY_RESULT,
+          tool_call_id: id,
+          name
+        });
+        await this._respond();
+        return;
+      }
       if (!this._tools) return;
       this._callSession?.recordToolCall();
-      const player = this._holdAudioChunks && this._callSession && !(this._callSession instanceof chunkU4UFTVLX_cjs.BufferingCall) ? new HoldAudioPlayer(this._callSession, this._holdAudioChunks) : null;
+      const player = this._holdAudioChunks && this._callSession && !(this._callSession instanceof chunkXAOA3XFQ_cjs.BufferingCall) ? new HoldAudioPlayer(this._callSession, this._holdAudioChunks) : null;
       player?.start();
       let result;
       try {
@@ -2286,8 +2316,8 @@ var PipelineSession = class {
         sampleRate: this._sampleRate
       })) {
         if (!this._running || !this._speaking) break;
-        const pcm8k = chunkU4UFTVLX_cjs.resamplePcm16(audioChunk, this._sampleRate, 8e3);
-        const ulaw = chunkU4UFTVLX_cjs.pcm16ToUlaw(pcm8k);
+        const pcm8k = chunkXAOA3XFQ_cjs.resamplePcm16(audioChunk, this._sampleRate, 8e3);
+        const ulaw = chunkXAOA3XFQ_cjs.pcm16ToUlaw(pcm8k);
         for (let off = 0; off < ulaw.length; off += 160) {
           let chunk = ulaw.subarray(off, off + 160);
           if (chunk.length < 160) {
@@ -2314,8 +2344,13 @@ var OpenAIRealtime = class {
   _language;
   _turnDetection;
   _greeting;
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   _builtinTools = null;
+  /**
+   * 마지막 session.update 로 LLM 에 알린 tool 이름들. attach() 가 이 값과 현재
+   * registry 를 비교해 달라졌을 때만(=MCP 도구 등 뒤늦게 붙은 경우) 재전송한다.
+   */
+  _sentToolNames = null;
   setLogger(logger) {
     this._log = logger;
   }
@@ -2386,7 +2421,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 chunkU4UFTVLX_cjs.BufferingCall();
+    this._call = new chunkXAOA3XFQ_cjs.BufferingCall();
     this._closed = false;
     this._playback = null;
     this._latestMediaTs = 0;
@@ -2425,9 +2460,10 @@ var OpenAIRealtime = class {
   }
   /** Attach a real CallSession to the prewarmed session and flush buffered audio. */
   async attach(callSession) {
+    this._resyncTools();
     const prev = this._call;
     this._call = callSession;
-    chunkU4UFTVLX_cjs.attachBuffered(prev, callSession);
+    chunkXAOA3XFQ_cjs.attachBuffered(prev, callSession);
   }
   async start(callSession, tools) {
     if (tools) this._tools = tools;
@@ -2485,10 +2521,36 @@ 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(...chunkXAOA3XFQ_cjs.getBuiltinToolSchemas(this._builtinTools, "realtime"));
+    return toolSchemas;
+  }
+  /**
+   * prewarm 이후 도구가 바뀌었으면 session.update 로 재전송한다.
+   *
+   * MCP 도구는 통화 시작 시점에 registry 에 붙으므로 prewarm 시점의 스키마에는
+   * 없다. 여기서 맞춰주지 않으면 발신 통화에서 MCP 도구를 영영 못 쓴다.
+   */
+  _resyncTools() {
+    if (!this._ws || this._ws.readyState !== 1) return;
+    const toolSchemas = this._currentToolSchemas();
+    const names = toolSchemas.map((t) => String(t["name"] ?? ""));
+    if (this._sentToolNames && names.length === this._sentToolNames.length && names.every((n, i) => n === this._sentToolNames[i])) {
+      return;
+    }
+    this._send({
+      type: "session.update",
+      session: { type: "realtime", tools: toolSchemas }
+    });
+    this._sentToolNames = names;
+    this._log.info("Tool schema resynced after prewarm: %s", names.join(", "));
+  }
   _sendSessionUpdate() {
     if (!this._ws || this._ws.readyState !== 1) return;
-    const toolSchemas = this._tools ? this._tools.toOpenAITools().map((t) => ({ type: "function", ...t.function })) : [];
-    toolSchemas.push(...chunkU4UFTVLX_cjs.getBuiltinToolSchemas(this._builtinTools, "realtime"));
+    const toolSchemas = this._currentToolSchemas();
+    this._sentToolNames = toolSchemas.map((t) => String(t["name"] ?? ""));
     this._send({
       type: "session.update",
       session: {
@@ -2633,9 +2695,9 @@ var OpenAIRealtime = class {
     const controller = new AbortController();
     this._pendingToolCalls.set(callId, controller);
     try {
-      if (chunkU4UFTVLX_cjs.BUILTIN_TOOL_NAMES.has(funcName) && this._call && !(this._call instanceof chunkU4UFTVLX_cjs.BufferingCall)) {
+      if (chunkXAOA3XFQ_cjs.BUILTIN_TOOL_NAMES.has(funcName) && this._call && !(this._call instanceof chunkXAOA3XFQ_cjs.BufferingCall)) {
         const args = JSON.parse(item["arguments"] ?? "{}");
-        const result2 = await chunkU4UFTVLX_cjs.executeBuiltinTool(funcName, args, this._call);
+        const result2 = await chunkXAOA3XFQ_cjs.executeBuiltinTool(funcName, args, this._call);
         if (result2 !== null) {
           if (funcName === "hang_up") return;
           if (controller.signal.aborted) return;
@@ -2652,6 +2714,20 @@ var OpenAIRealtime = class {
           return;
         }
       }
+      if (chunkXAOA3XFQ_cjs.BUILTIN_TOOL_NAMES.has(funcName) && this._call instanceof chunkXAOA3XFQ_cjs.BufferingCall) {
+        this._log.warn("Builtin tool %s called before answer \u2014 deferring", funcName);
+        await this._waitForResponseDone();
+        this._send({
+          type: "conversation.item.create",
+          item: {
+            type: "function_call_output",
+            call_id: callId,
+            output: chunkXAOA3XFQ_cjs.CALL_NOT_READY_RESULT
+          }
+        });
+        this._send({ type: "response.create" });
+        return;
+      }
       if (!this._tools || !this._tools.has(funcName)) {
         this._log.error("Unknown tool: %s", funcName);
         await this._waitForResponseDone();
@@ -2667,7 +2743,7 @@ var OpenAIRealtime = class {
         return;
       }
       let result;
-      const player = this._holdAudioChunks && this._call && !(this._call instanceof chunkU4UFTVLX_cjs.BufferingCall) ? new HoldAudioPlayer(this._call, this._holdAudioChunks) : null;
+      const player = this._holdAudioChunks && this._call && !(this._call instanceof chunkXAOA3XFQ_cjs.BufferingCall) ? new HoldAudioPlayer(this._call, this._holdAudioChunks) : null;
       player?.start();
       try {
         const args = JSON.parse(item["arguments"] ?? "{}");
@@ -2789,6 +2865,13 @@ function sanitizeSchemaForGemini(schema, defs, depth = 0) {
   return result;
 }
 var GeminiRealtime = class _GeminiRealtime {
+  /**
+   * Gemini Live 는 connect 시점의 config 로 도구가 고정되어 세션 도중 변경할 수 없다.
+   *
+   * 통화 시작 시점에야 붙는 MCP 도구는 prewarm 된 세션에 넣을 방법이 없으므로,
+   * `ClawOpsAgent` 가 MCP 서버 설정과 이 플래그를 보고 prewarm 을 건너뛴다.
+   */
+  toolsFrozenAfterPrewarm = true;
   _apiKey;
   _systemPrompt;
   _model;
@@ -2809,7 +2892,7 @@ var GeminiRealtime = class _GeminiRealtime {
   _toolDrainTimer = null;
   _lastAudioTime = 0;
   _holdAudioChunks = null;
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   constructor(options = {}) {
     this._apiKey = options.apiKey ?? process.env["GOOGLE_API_KEY"] ?? "";
     this._systemPrompt = options.systemPrompt ?? "";
@@ -2855,7 +2938,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 chunkU4UFTVLX_cjs.BufferingCall();
+    this._call = new chunkXAOA3XFQ_cjs.BufferingCall();
     this._closed = false;
     this._sentAudioChunks = 0;
     this._audioRemainder = Buffer.alloc(0);
@@ -2912,7 +2995,7 @@ var GeminiRealtime = class _GeminiRealtime {
   async attach(callSession) {
     const prev = this._call;
     this._call = callSession;
-    chunkU4UFTVLX_cjs.attachBuffered(prev, callSession);
+    chunkXAOA3XFQ_cjs.attachBuffered(prev, callSession);
   }
   async start(callSession, tools) {
     if (tools) this._tools = tools;
@@ -2921,8 +3004,8 @@ var GeminiRealtime = class _GeminiRealtime {
   }
   feedAudio(audio) {
     if (this._session && !this._closed) {
-      const pcm8k = chunkU4UFTVLX_cjs.ulawToPcm16(audio);
-      const pcm16k = chunkU4UFTVLX_cjs.resamplePcm16(pcm8k, 8e3, 16e3);
+      const pcm8k = chunkXAOA3XFQ_cjs.ulawToPcm16(audio);
+      const pcm16k = chunkXAOA3XFQ_cjs.resamplePcm16(pcm8k, 8e3, 16e3);
       this._session.sendRealtimeInput({
         audio: {
           data: Buffer.from(pcm16k).toString("base64"),
@@ -2966,7 +3049,7 @@ var GeminiRealtime = class _GeminiRealtime {
         t.function.parameters ?? { type: "object", properties: {} }
       )
     })) : [];
-    toolDefs.push(...chunkU4UFTVLX_cjs.getBuiltinToolSchemas(this._builtinTools, "gemini"));
+    toolDefs.push(...chunkXAOA3XFQ_cjs.getBuiltinToolSchemas(this._builtinTools, "gemini"));
     return toolDefs;
   }
   _handleMessage(msg) {
@@ -3026,8 +3109,8 @@ var GeminiRealtime = class _GeminiRealtime {
   _handleAudioData(b64Data) {
     if (!this._call) return;
     const pcm24k = Buffer.from(b64Data, "base64");
-    const pcm8k = chunkU4UFTVLX_cjs.resamplePcm16(pcm24k, 24e3, 8e3);
-    const ulaw = chunkU4UFTVLX_cjs.pcm16ToUlaw(pcm8k);
+    const pcm8k = chunkXAOA3XFQ_cjs.resamplePcm16(pcm24k, 24e3, 8e3);
+    const ulaw = chunkXAOA3XFQ_cjs.pcm16ToUlaw(pcm8k);
     const combined = Buffer.concat([this._audioRemainder, ulaw]);
     const chunkSize = 160;
     const fullEnd = Math.floor(combined.length / chunkSize) * chunkSize;
@@ -3070,7 +3153,7 @@ var GeminiRealtime = class _GeminiRealtime {
     const functionCalls = toolCall.functionCalls;
     if (!functionCalls) return;
     const responses = [];
-    const player = this._holdAudioChunks && this._call && !(this._call instanceof chunkU4UFTVLX_cjs.BufferingCall) ? new HoldAudioPlayer(this._call, this._holdAudioChunks) : null;
+    const player = this._holdAudioChunks && this._call && !(this._call instanceof chunkXAOA3XFQ_cjs.BufferingCall) ? new HoldAudioPlayer(this._call, this._holdAudioChunks) : null;
     player?.start();
     try {
       for (const fc of functionCalls) {
@@ -3078,8 +3161,8 @@ var GeminiRealtime = class _GeminiRealtime {
         const fcId = fc.id ?? "";
         const args = fc.args ?? {};
         this._log.info({ tool: name, args }, "Tool call: %s", name);
-        if (chunkU4UFTVLX_cjs.BUILTIN_TOOL_NAMES.has(name) && this._call && !(this._call instanceof chunkU4UFTVLX_cjs.BufferingCall)) {
-          const result = await chunkU4UFTVLX_cjs.executeBuiltinTool(
+        if (chunkXAOA3XFQ_cjs.BUILTIN_TOOL_NAMES.has(name) && this._call && !(this._call instanceof chunkXAOA3XFQ_cjs.BufferingCall)) {
+          const result = await chunkXAOA3XFQ_cjs.executeBuiltinTool(
             name,
             args,
             this._call
@@ -3094,6 +3177,11 @@ var GeminiRealtime = class _GeminiRealtime {
             continue;
           }
         }
+        if (chunkXAOA3XFQ_cjs.BUILTIN_TOOL_NAMES.has(name) && this._call instanceof chunkXAOA3XFQ_cjs.BufferingCall) {
+          this._log.warn("Builtin tool %s called before answer \u2014 deferring", name);
+          responses.push({ id: fcId, name, response: { result: chunkXAOA3XFQ_cjs.CALL_NOT_READY_RESULT } });
+          continue;
+        }
         if (!this._tools || !this._tools.has(name)) {
           this._log.error("Unknown tool: %s", name);
           responses.push({ id: fcId, name, response: { error: `Unknown tool: ${name}` } });
@@ -3136,7 +3224,7 @@ var GeminiRealtime = class _GeminiRealtime {
 // src/agent/pipeline/stt/deepgram-stt.ts
 var DeepgramSTT = class {
   _options;
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   get provider() {
     return "deepgram";
   }
@@ -3263,7 +3351,7 @@ var DeepgramSTT = class {
 // src/agent/pipeline/tts/elevenlabs-tts.ts
 var ElevenLabsTTS = class {
   _options;
-  _log = chunkU4UFTVLX_cjs.NOOP_LOGGER;
+  _log = chunkXAOA3XFQ_cjs.NOOP_LOGGER;
   get provider() {
     return "elevenlabs";
   }
@@ -4009,47 +4097,47 @@ function mcpServerHTTP(options) {
 
 Object.defineProperty(exports, "BUILTIN_TOOL_NAMES", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.BUILTIN_TOOL_NAMES; }
+  get: function () { return chunkXAOA3XFQ_cjs.BUILTIN_TOOL_NAMES; }
 });
 Object.defineProperty(exports, "BuiltinTool", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.BuiltinTool; }
+  get: function () { return chunkXAOA3XFQ_cjs.BuiltinTool; }
 });
 Object.defineProperty(exports, "DECODE_TABLE", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.DECODE_TABLE; }
+  get: function () { return chunkXAOA3XFQ_cjs.DECODE_TABLE; }
 });
 Object.defineProperty(exports, "createAgentLogger", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.createAgentLogger; }
+  get: function () { return chunkXAOA3XFQ_cjs.createAgentLogger; }
 });
 Object.defineProperty(exports, "createPipelineLogger", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.createPipelineLogger; }
+  get: function () { return chunkXAOA3XFQ_cjs.createPipelineLogger; }
 });
 Object.defineProperty(exports, "executeBuiltinTool", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.executeBuiltinTool; }
+  get: function () { return chunkXAOA3XFQ_cjs.executeBuiltinTool; }
 });
 Object.defineProperty(exports, "getBuiltinToolSchemas", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.getBuiltinToolSchemas; }
+  get: function () { return chunkXAOA3XFQ_cjs.getBuiltinToolSchemas; }
 });
 Object.defineProperty(exports, "isBuiltinTool", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.isBuiltinTool; }
+  get: function () { return chunkXAOA3XFQ_cjs.isBuiltinTool; }
 });
 Object.defineProperty(exports, "pcm16ToUlaw", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.pcm16ToUlaw; }
+  get: function () { return chunkXAOA3XFQ_cjs.pcm16ToUlaw; }
 });
 Object.defineProperty(exports, "resamplePcm16", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.resamplePcm16; }
+  get: function () { return chunkXAOA3XFQ_cjs.resamplePcm16; }
 });
 Object.defineProperty(exports, "ulawToPcm16", {
   enumerable: true,
-  get: function () { return chunkU4UFTVLX_cjs.ulawToPcm16; }
+  get: function () { return chunkXAOA3XFQ_cjs.ulawToPcm16; }
 });
 exports.AnthropicLLM = AnthropicLLM;
 exports.AudioRecorder = AudioRecorder;