@teamlearners/clawops 0.25.0 → 0.26.0

package/dist/agent/index.d.cts

@@ -242,6 +242,14 @@ declare 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 **전에** 최소 한 번은 도구가 들어가 있어야 한다.
+     */
+    private _injectSessionDeps;
     private _startPrewarm;
     private _handleRinging;
     private _handleFailed;
@@ -533,6 +541,11 @@ declare class OpenAIRealtime implements Session {
     private _greeting;
     private _log;
     private _builtinTools;
+    /**
+     * 마지막 session.update 로 LLM 에 알린 tool 이름들. attach() 가 이 값과 현재
+     * registry 를 비교해 달라졌을 때만(=MCP 도구 등 뒤늦게 붙은 경우) 재전송한다.
+     */
+    private _sentToolNames;
     setLogger(logger: Logger): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
     getTelemetry(): SessionTelemetry;
@@ -562,6 +575,15 @@ declare class OpenAIRealtime implements Session {
     feedDtmf(digits: string): Promise<void>;
     feedAudio(audio: Buffer, timestamp?: number): void;
     stop(): Promise<void>;
+    /** Current tool schemas: user tools + builtin tools (flat realtime format). */
+    private _currentToolSchemas;
+    /**
+     * prewarm 이후 도구가 바뀌었으면 session.update 로 재전송한다.
+     *
+     * MCP 도구는 통화 시작 시점에 registry 에 붙으므로 prewarm 시점의 스키마에는
+     * 없다. 여기서 맞춰주지 않으면 발신 통화에서 MCP 도구를 영영 못 쓴다.
+     */
+    private _resyncTools;
     private _sendSessionUpdate;
     private _handleMessage;
     private _handleAudioDelta;
@@ -595,6 +617,13 @@ interface GeminiRealtimeOptions {
     realtimeInputConfig?: Record<string, unknown>;
 }
 declare class GeminiRealtime implements Session {
+    /**
+     * Gemini Live 는 connect 시점의 config 로 도구가 고정되어 세션 도중 변경할 수 없다.
+     *
+     * 통화 시작 시점에야 붙는 MCP 도구는 prewarm 된 세션에 넣을 방법이 없으므로,
+     * `ClawOpsAgent` 가 MCP 서버 설정과 이 플래그를 보고 prewarm 을 건너뛴다.
+     */
+    readonly toolsFrozenAfterPrewarm = true;
     private _apiKey;
     private _systemPrompt;
     private _model;

package/dist/agent/index.d.ts

@@ -242,6 +242,14 @@ declare 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 **전에** 최소 한 번은 도구가 들어가 있어야 한다.
+     */
+    private _injectSessionDeps;
     private _startPrewarm;
     private _handleRinging;
     private _handleFailed;
@@ -533,6 +541,11 @@ declare class OpenAIRealtime implements Session {
     private _greeting;
     private _log;
     private _builtinTools;
+    /**
+     * 마지막 session.update 로 LLM 에 알린 tool 이름들. attach() 가 이 값과 현재
+     * registry 를 비교해 달라졌을 때만(=MCP 도구 등 뒤늦게 붙은 경우) 재전송한다.
+     */
+    private _sentToolNames;
     setLogger(logger: Logger): void;
     setBuiltinTools(tools: Set<BuiltinTool>): void;
     getTelemetry(): SessionTelemetry;
@@ -562,6 +575,15 @@ declare class OpenAIRealtime implements Session {
     feedDtmf(digits: string): Promise<void>;
     feedAudio(audio: Buffer, timestamp?: number): void;
     stop(): Promise<void>;
+    /** Current tool schemas: user tools + builtin tools (flat realtime format). */
+    private _currentToolSchemas;
+    /**
+     * prewarm 이후 도구가 바뀌었으면 session.update 로 재전송한다.
+     *
+     * MCP 도구는 통화 시작 시점에 registry 에 붙으므로 prewarm 시점의 스키마에는
+     * 없다. 여기서 맞춰주지 않으면 발신 통화에서 MCP 도구를 영영 못 쓴다.
+     */
+    private _resyncTools;
     private _sendSessionUpdate;
     private _handleMessage;
     private _handleAudioDelta;
@@ -595,6 +617,13 @@ interface GeminiRealtimeOptions {
     realtimeInputConfig?: Record<string, unknown>;
 }
 declare class GeminiRealtime implements Session {
+    /**
+     * Gemini Live 는 connect 시점의 config 로 도구가 고정되어 세션 도중 변경할 수 없다.
+     *
+     * 통화 시작 시점에야 붙는 MCP 도구는 prewarm 된 세션에 넣을 방법이 없으므로,
+     * `ClawOpsAgent` 가 MCP 서버 설정과 이 플래그를 보고 prewarm 을 건너뛴다.
+     */
+    readonly toolsFrozenAfterPrewarm = true;
     private _apiKey;
     private _systemPrompt;
     private _model;

package/dist/agent/index.js

@@ -1,6 +1,6 @@
-import { DEFAULT_BASE_URL, AgentError, AgentConnectionError, VERSION } from '../chunk-THZNZBP2.js';
-import { NOOP_LOGGER, resolveBuiltinTools, createAgentLogger, createPipelineLogger, BufferingCall, attachBuffered, ulawToPcm16, resamplePcm16, getBuiltinToolSchemas, BUILTIN_TOOL_NAMES, executeBuiltinTool, pcm16ToUlaw, applyUlawGain } from '../chunk-2BAYUQ7O.js';
-export { BUILTIN_TOOL_NAMES, BuiltinTool, DECODE_TABLE, createAgentLogger, createPipelineLogger, executeBuiltinTool, getBuiltinToolSchemas, isBuiltinTool, pcm16ToUlaw, resamplePcm16, ulawToPcm16 } from '../chunk-2BAYUQ7O.js';
+import { DEFAULT_BASE_URL, AgentError, AgentConnectionError, VERSION } from '../chunk-WIA54H3X.js';
+import { NOOP_LOGGER, resolveBuiltinTools, createAgentLogger, createPipelineLogger, BufferingCall, attachBuffered, ulawToPcm16, resamplePcm16, getBuiltinToolSchemas, BUILTIN_TOOL_NAMES, executeBuiltinTool, CALL_NOT_READY_RESULT, pcm16ToUlaw, applyUlawGain } from '../chunk-WKGTY7QT.js';
+export { BUILTIN_TOOL_NAMES, BuiltinTool, DECODE_TABLE, createAgentLogger, createPipelineLogger, executeBuiltinTool, getBuiltinToolSchemas, isBuiltinTool, pcm16ToUlaw, resamplePcm16, ulawToPcm16 } from '../chunk-WKGTY7QT.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import os from 'os';
@@ -1697,10 +1697,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)}`);
@@ -1866,21 +1899,7 @@ 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;
@@ -2208,6 +2227,17 @@ var PipelineSession = class {
           return;
         }
       }
+      if (BUILTIN_TOOL_NAMES.has(name) && this._callSession instanceof BufferingCall) {
+        this._log.warn("Builtin tool %s called before answer \u2014 deferring", name);
+        this._conversation.push({
+          role: "tool",
+          content: 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 BufferingCall) ? new HoldAudioPlayer(this._callSession, this._holdAudioChunks) : null;
@@ -2291,6 +2321,11 @@ var OpenAIRealtime = class {
   _greeting;
   _log = NOOP_LOGGER;
   _builtinTools = null;
+  /**
+   * 마지막 session.update 로 LLM 에 알린 tool 이름들. attach() 가 이 값과 현재
+   * registry 를 비교해 달라졌을 때만(=MCP 도구 등 뒤늦게 붙은 경우) 재전송한다.
+   */
+  _sentToolNames = null;
   setLogger(logger) {
     this._log = logger;
   }
@@ -2400,6 +2435,7 @@ 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;
     attachBuffered(prev, callSession);
@@ -2460,10 +2496,36 @@ var OpenAIRealtime = class {
       });
     }
   }
-  _sendSessionUpdate() {
-    if (!this._ws || this._ws.readyState !== 1) return;
+  /** 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(...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._currentToolSchemas();
+    this._sentToolNames = toolSchemas.map((t) => String(t["name"] ?? ""));
     this._send({
       type: "session.update",
       session: {
@@ -2627,6 +2689,20 @@ var OpenAIRealtime = class {
           return;
         }
       }
+      if (BUILTIN_TOOL_NAMES.has(funcName) && this._call instanceof 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: 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();
@@ -2764,6 +2840,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;
@@ -3069,6 +3152,11 @@ var GeminiRealtime = class _GeminiRealtime {
             continue;
           }
         }
+        if (BUILTIN_TOOL_NAMES.has(name) && this._call instanceof BufferingCall) {
+          this._log.warn("Builtin tool %s called before answer \u2014 deferring", name);
+          responses.push({ id: fcId, name, response: { result: 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}` } });