@teamlearners/clawops 0.24.0 → 0.25.1

package/dist/agent/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FunctionTool, S as Session, B as BuiltinTool, C as CallSession, a as STT, L as LLM, T as TTS, b as ToolRegistry, c as SessionTelemetry, d as SpeechEvent, e as ConversationMessage, f as LLMChunk } from '../base-Z-uZdd27.cjs';
-export { g as CallDirection, h as CallStatus, O as OpenAIToolDefinition, i as ToolCallRequest, j as functionTool, z as zodToToolParams } from '../base-Z-uZdd27.cjs';
+import { F as FunctionTool, S as Session, B as BuiltinTool, C as CallSession, a as STT, L as LLM, T as TTS, b as ToolRegistry, c as SessionTelemetry, d as SpeechEvent, e as ConversationMessage, f as LLMChunk } from '../base-Cje1TDJi.cjs';
+export { g as CallDirection, h as CallStatus, O as OpenAIToolDefinition, i as ToolCallRequest, j as functionTool, z as zodToToolParams } from '../base-Cje1TDJi.cjs';
 import { Logger } from 'pino';
 export { Logger } from 'pino';
 import 'zod';
@@ -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

@@ -1,5 +1,5 @@
-import { F as FunctionTool, S as Session, B as BuiltinTool, C as CallSession, a as STT, L as LLM, T as TTS, b as ToolRegistry, c as SessionTelemetry, d as SpeechEvent, e as ConversationMessage, f as LLMChunk } from '../base-Z-uZdd27.js';
-export { g as CallDirection, h as CallStatus, O as OpenAIToolDefinition, i as ToolCallRequest, j as functionTool, z as zodToToolParams } from '../base-Z-uZdd27.js';
+import { F as FunctionTool, S as Session, B as BuiltinTool, C as CallSession, a as STT, L as LLM, T as TTS, b as ToolRegistry, c as SessionTelemetry, d as SpeechEvent, e as ConversationMessage, f as LLMChunk } from '../base-Cje1TDJi.js';
+export { g as CallDirection, h as CallStatus, O as OpenAIToolDefinition, i as ToolCallRequest, j as functionTool, z as zodToToolParams } from '../base-Cje1TDJi.js';
 import { Logger } from 'pino';
 export { Logger } from 'pino';
 import 'zod';
@@ -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-7P2HGIPS.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-2QE6GHWC.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';
@@ -739,6 +739,7 @@ var CallSession = class {
   startTime;
   metadata;
   _status;
+  _endedStatus = null;
   _sendAudioFn = null;
   _clearAudioFn = null;
   _hangupFn = null;
@@ -787,6 +788,17 @@ var CallSession = class {
   get status() {
     return this._status;
   }
+  /**
+   * 서버가 통보한 최종 종료 상태. 통화가 끝나기 전에는 null.
+   *
+   * `completed`(성사) / `no-answer`(벨은 울렸으나 무응답) / `busy`(통화중) /
+   * `rejected`(수신 거절) / `canceled`(응답 전 발신 측 취소) / `failed`(시스템·망 오류).
+   * `status` 는 SDK 내부 수명주기(ringing→active→ended)이므로 통화 성사 여부는
+   * 이 값이나 `call_failed` 이벤트로 판단한다.
+   */
+  get endedStatus() {
+    return this._endedStatus;
+  }
   get duration() {
     return (Date.now() - this.startTime.getTime()) / 1e3;
   }
@@ -947,8 +959,20 @@ var CallSession = class {
   async wait() {
     return this._endedPromise;
   }
-  /** Mark the session as ended (called internally). */
-  _markEnded() {
+  /**
+   * Mark the session as ended (called internally).
+   *
+   * @param status 서버가 통보한 최종 상태(completed/no-answer/busy/rejected/canceled/
+   *   failed). 주어지면 `endedStatus` 로 확정한다 — 상대가 받지 않은 통화를 성사된 통화와
+   *   구분하기 위함이다. 생략하면 미디어 세션 정리 경로에서의 호출이므로, 아직 종료 전일
+   *   때만 'completed' 로 채우고 이미 확정된 서버 상태는 덮어쓰지 않는다.
+   */
+  _markEnded(status) {
+    if (status !== void 0) {
+      this._endedStatus = status;
+    } else if (this._status !== "ended") {
+      this._endedStatus = "completed";
+    }
     this._status = "ended";
     this._resolveEnded();
   }
@@ -1600,10 +1624,15 @@ var ClawOpsAgent = class _ClawOpsAgent {
   }
   _handleEnded(event) {
     const callId = event["callId"];
+    const status = event["status"] || "completed";
     const session = this._activeSessions.get(callId);
     if (session) {
-      this._log.info("Call ended (server): %s", callId);
-      session._markEnded();
+      this._log.info("Call ended (server): %s (status=%s)", callId, status);
+      if (status !== "completed") {
+        this._log.info("Outbound call not connected: %s (%s)", callId, status);
+        session._emit("call_failed", status);
+      }
+      session._markEnded(status);
       this._activeSessions.delete(callId);
     }
     void this._cleanupPrewarm(callId);
@@ -1668,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)}`);
@@ -1715,9 +1777,10 @@ var ClawOpsAgent = class _ClawOpsAgent {
     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();
+      const reason = event["reason"] ?? "failed";
+      this._log.info("Outbound call failed: %s (%s)", callId, reason);
+      session._emit("call_failed", reason);
+      session._markEnded(reason);
       this._activeSessions.delete(callId);
     }
     void this._cleanupPrewarm(callId);
@@ -1836,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;
@@ -2178,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;
@@ -2261,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;
   }
@@ -2370,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);
@@ -2430,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: {
@@ -2597,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();
@@ -2734,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;
@@ -3039,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}` } });