@teamlearners/clawops 0.23.0 → 0.24.0

package/dist/agent/index.js

@@ -1,359 +1,10 @@
-import { DEFAULT_BASE_URL, AgentError, AgentConnectionError, VERSION } from '../chunk-JU36ASTU.js';
-import pino from 'pino';
+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 * as fs from 'fs';
 import * as path from 'path';
 import os from 'os';
 
-// src/agent/audio.ts
-var _BIAS = 132;
-var _CLIP = 32635;
-var DECODE_TABLE = [
-  -32124,
-  -31100,
-  -30076,
-  -29052,
-  -28028,
-  -27004,
-  -25980,
-  -24956,
-  -23932,
-  -22908,
-  -21884,
-  -20860,
-  -19836,
-  -18812,
-  -17788,
-  -16764,
-  -15996,
-  -15484,
-  -14972,
-  -14460,
-  -13948,
-  -13436,
-  -12924,
-  -12412,
-  -11900,
-  -11388,
-  -10876,
-  -10364,
-  -9852,
-  -9340,
-  -8828,
-  -8316,
-  -7932,
-  -7676,
-  -7420,
-  -7164,
-  -6908,
-  -6652,
-  -6396,
-  -6140,
-  -5884,
-  -5628,
-  -5372,
-  -5116,
-  -4860,
-  -4604,
-  -4348,
-  -4092,
-  -3900,
-  -3772,
-  -3644,
-  -3516,
-  -3388,
-  -3260,
-  -3132,
-  -3004,
-  -2876,
-  -2748,
-  -2620,
-  -2492,
-  -2364,
-  -2236,
-  -2108,
-  -1980,
-  -1884,
-  -1820,
-  -1756,
-  -1692,
-  -1628,
-  -1564,
-  -1500,
-  -1436,
-  -1372,
-  -1308,
-  -1244,
-  -1180,
-  -1116,
-  -1052,
-  -988,
-  -924,
-  -876,
-  -844,
-  -812,
-  -780,
-  -748,
-  -716,
-  -684,
-  -652,
-  -620,
-  -588,
-  -556,
-  -524,
-  -492,
-  -460,
-  -428,
-  -396,
-  -372,
-  -356,
-  -340,
-  -324,
-  -308,
-  -292,
-  -276,
-  -260,
-  -244,
-  -228,
-  -212,
-  -196,
-  -180,
-  -164,
-  -148,
-  -132,
-  -120,
-  -112,
-  -104,
-  -96,
-  -88,
-  -80,
-  -72,
-  -64,
-  -56,
-  -48,
-  -40,
-  -32,
-  -24,
-  -16,
-  -8,
-  0,
-  32124,
-  31100,
-  30076,
-  29052,
-  28028,
-  27004,
-  25980,
-  24956,
-  23932,
-  22908,
-  21884,
-  20860,
-  19836,
-  18812,
-  17788,
-  16764,
-  15996,
-  15484,
-  14972,
-  14460,
-  13948,
-  13436,
-  12924,
-  12412,
-  11900,
-  11388,
-  10876,
-  10364,
-  9852,
-  9340,
-  8828,
-  8316,
-  7932,
-  7676,
-  7420,
-  7164,
-  6908,
-  6652,
-  6396,
-  6140,
-  5884,
-  5628,
-  5372,
-  5116,
-  4860,
-  4604,
-  4348,
-  4092,
-  3900,
-  3772,
-  3644,
-  3516,
-  3388,
-  3260,
-  3132,
-  3004,
-  2876,
-  2748,
-  2620,
-  2492,
-  2364,
-  2236,
-  2108,
-  1980,
-  1884,
-  1820,
-  1756,
-  1692,
-  1628,
-  1564,
-  1500,
-  1436,
-  1372,
-  1308,
-  1244,
-  1180,
-  1116,
-  1052,
-  988,
-  924,
-  876,
-  844,
-  812,
-  780,
-  748,
-  716,
-  684,
-  652,
-  620,
-  588,
-  556,
-  524,
-  492,
-  460,
-  428,
-  396,
-  372,
-  356,
-  340,
-  324,
-  308,
-  292,
-  276,
-  260,
-  244,
-  228,
-  212,
-  196,
-  180,
-  164,
-  148,
-  132,
-  120,
-  112,
-  104,
-  96,
-  88,
-  80,
-  72,
-  64,
-  56,
-  48,
-  40,
-  32,
-  24,
-  16,
-  8,
-  0
-];
-function encodeUlawSample(sample) {
-  let sign = 0;
-  if (sample < 0) {
-    sign = 128;
-    sample = -sample;
-  }
-  if (sample > _CLIP) {
-    sample = _CLIP;
-  }
-  sample += _BIAS;
-  let exponent = 7;
-  const expValues = [16384, 8192, 4096, 2048, 1024, 512, 256];
-  for (const expVal of expValues) {
-    if (sample >= expVal) {
-      break;
-    }
-    exponent -= 1;
-  }
-  const mantissa = sample >> exponent + 3 & 15;
-  return ~(sign | exponent << 4 | mantissa) & 255;
-}
-function pcm16ToUlaw(pcm) {
-  if (!pcm.length) return Buffer.alloc(0);
-  const nSamples = pcm.length >> 1;
-  const out = Buffer.alloc(nSamples);
-  for (let i = 0; i < nSamples; i++) {
-    const sample = pcm.readInt16LE(i * 2);
-    out[i] = encodeUlawSample(sample);
-  }
-  return out;
-}
-function ulawToPcm16(ulaw) {
-  if (!ulaw.length) return Buffer.alloc(0);
-  const out = Buffer.alloc(ulaw.length * 2);
-  for (let i = 0; i < ulaw.length; i++) {
-    out.writeInt16LE(DECODE_TABLE[ulaw[i]], i * 2);
-  }
-  return out;
-}
-function applyPcm16Gain(pcm, gain) {
-  if (!pcm.length) return Buffer.alloc(0);
-  if (gain === 1) return pcm;
-  if (!Number.isFinite(gain) || gain < 0) {
-    throw new Error("gain must be a finite number >= 0");
-  }
-  const nSamples = pcm.length >> 1;
-  const out = Buffer.alloc(nSamples * 2);
-  for (let i = 0; i < nSamples; i++) {
-    let value = Math.round(pcm.readInt16LE(i * 2) * gain);
-    if (value > 32767) value = 32767;
-    else if (value < -32768) value = -32768;
-    out.writeInt16LE(value, i * 2);
-  }
-  return out;
-}
-function applyUlawGain(ulaw, gain) {
-  if (!ulaw.length) return Buffer.alloc(0);
-  if (gain === 1) return ulaw;
-  return pcm16ToUlaw(applyPcm16Gain(ulawToPcm16(ulaw), gain));
-}
-function resamplePcm16(pcm, fromRate, toRate) {
-  if (fromRate === toRate || !pcm.length) return pcm;
-  const nSamples = pcm.length >> 1;
-  const ratio = fromRate / toRate;
-  const outLen = Math.floor(nSamples / ratio);
-  const out = Buffer.alloc(outLen * 2);
-  for (let i = 0; i < outLen; i++) {
-    const srcPos = i * ratio;
-    const idx = Math.floor(srcPos);
-    const frac = srcPos - idx;
-    let val;
-    if (idx + 1 < nSamples) {
-      val = pcm.readInt16LE(idx * 2) * (1 - frac) + pcm.readInt16LE((idx + 1) * 2) * frac;
-    } else {
-      val = pcm.readInt16LE(idx * 2);
-    }
-    out.writeInt16LE(Math.round(val), i * 2);
-  }
-  return out;
-}
-var DEFAULT_LOGGER = pino({ name: "clawops.agent" });
-var NOOP_LOGGER = pino({ level: "silent" });
-function createAgentLogger(userLogger) {
-  return userLogger ?? DEFAULT_LOGGER;
-}
-function createPipelineLogger(parent) {
-  return parent.child({ module: "pipeline" });
-}
-
 // src/agent/control-ws.ts
 var INITIAL_RECONNECT_DELAY = 1e3;
 var MAX_RECONNECT_DELAY = 3e4;
@@ -1097,6 +748,17 @@ var CallSession = class {
   _transferFn = null;
   /** @internal */
   _isTransportConnected = null;
+  /**
+   * @internal Media WS playout 마커 훅. LiveKit(`ClawOpsAudioOutput`)이 재생 완료
+   * 판정(mark echo)과 barge-in 절단 위치 계산에 쓴다. 다른 세션 타입은 읽지 않는다.
+   * prewarm 중(BufferingCall)에는 바인딩되지 않아 null 이다.
+   */
+  /** @internal */
+  _sendMark = null;
+  /** @internal */
+  _waitForMark = null;
+  /** @internal */
+  _flushTransport = null;
   _dtmfCollectorActive = false;
   _dtmfResolvers = [];
   _dtmfBuffer = [];
@@ -1310,35 +972,6 @@ var CallSession = class {
     }
   }
 };
-
-// src/agent/builtin-tool.ts
-var BuiltinTool = /* @__PURE__ */ ((BuiltinTool2) => {
-  BuiltinTool2["HANG_UP"] = "hang_up";
-  BuiltinTool2["COLLECT_DTMF"] = "collect_dtmf";
-  BuiltinTool2["SEND_DTMF"] = "send_dtmf";
-  BuiltinTool2["TRANSFER_CALL"] = "transfer_call";
-  BuiltinTool2["ALL"] = "all";
-  BuiltinTool2["NONE"] = "none";
-  return BuiltinTool2;
-})(BuiltinTool || {});
-var INDIVIDUAL_TOOLS = /* @__PURE__ */ new Set([
-  "hang_up" /* HANG_UP */,
-  "collect_dtmf" /* COLLECT_DTMF */,
-  "send_dtmf" /* SEND_DTMF */,
-  "transfer_call" /* TRANSFER_CALL */
-]);
-function resolveBuiltinTools(value) {
-  if (typeof value === "string") {
-    if (value === "all" /* ALL */) {
-      return new Set(INDIVIDUAL_TOOLS);
-    }
-    if (value === "none" /* NONE */) {
-      return /* @__PURE__ */ new Set();
-    }
-    return /* @__PURE__ */ new Set([value]);
-  }
-  return new Set(value.filter((t) => INDIVIDUAL_TOOLS.has(t)));
-}
 var CHUNK_SIZE = 160;
 var SAMPLE_RATE2 = 8e3;
 var BELL_PARTIALS = [
@@ -2199,6 +1832,9 @@ var ClawOpsAgent = class _ClawOpsAgent {
           () => mediaWs.isConnected
         );
         session._transferFn = (params) => this._controlWs.requestTransfer(session.callId, params);
+        session._sendMark = (name) => mediaWs.sendMark(name);
+        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);
@@ -2314,232 +1950,6 @@ var ClawOpsAgent = class _ClawOpsAgent {
   }
 };
 
-// src/agent/pipeline/builtin-tool-schemas.ts
-var HANG_UP = {
-  name: "hang_up",
-  description: "End the phone call. Use when the conversation is finished or the caller says goodbye.",
-  parameters: { type: "object", properties: {} }
-};
-var COLLECT_DTMF = {
-  name: "collect_dtmf",
-  description: "\uC0AC\uC6A9\uC790\uB85C\uBD80\uD130 DTMF(\uC804\uD654 \uD0A4\uD328\uB4DC) \uC785\uB825\uC744 \uC218\uC9D1\uD569\uB2C8\uB2E4. \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBB34\uC5C7\uC744 \uC785\uB825\uD574\uC57C \uD558\uB294\uC9C0 \uC548\uB0B4\uD55C \uD6C4 \uD638\uCD9C\uD558\uC138\uC694.",
-  parameters: {
-    type: "object",
-    properties: {
-      max_digits: { type: "integer", description: "\uC218\uC9D1\uD560 \uCD5C\uB300 \uC790\uB9BF\uC218" },
-      finish_on_key: { type: "string", description: "\uC785\uB825 \uC885\uB8CC \uD0A4 (\uAE30\uBCF8: #)" },
-      timeout: { type: "integer", description: "\uC785\uB825 \uB300\uAE30 \uC2DC\uAC04(\uCD08, \uAE30\uBCF8: 5)" }
-    },
-    required: ["max_digits"]
-  }
-};
-var SEND_DTMF = {
-  name: "send_dtmf",
-  description: "DTMF \uC2E0\uD638\uB97C \uC804\uC1A1\uD569\uB2C8\uB2E4. ARS \uBA54\uB274 \uD0D0\uC0C9\uC774\uB098 \uB0B4\uC120\uBC88\uD638 \uC785\uB825 \uC2DC \uC0AC\uC6A9\uD569\uB2C8\uB2E4.",
-  parameters: {
-    type: "object",
-    properties: {
-      digits: {
-        type: "string",
-        description: "\uC804\uC1A1\uD560 \uBC88\uD638 (0-9, *, #). 'w'\uB294 500ms \uB300\uAE30, 'W'\uB294 1000ms \uB300\uAE30. \uC608: '1', '1234#', '1w2'"
-      }
-    },
-    required: ["digits"]
-  }
-};
-var TRANSFER_CALL = {
-  name: "transfer_call",
-  description: "Transfer the current call to another phone number or SIP endpoint. Use for blind transfer (direct handoff) or warm transfer (with whisper message to the target).",
-  parameters: {
-    type: "object",
-    properties: {
-      to: { type: "string", description: "Transfer destination. A phone number when destination_type is 'pstn', or a SIP URI (e.g. 'sip:user@host') when destination_type is 'sip'." },
-      destination_type: { type: "string", enum: ["pstn", "sip"], description: "pstn: dial a phone number via carrier (default). sip: connect directly to a SIP endpoint (no carrier/PSTN)." },
-      mode: { type: "string", enum: ["blind", "warm"], description: "blind: direct transfer (default), warm: play whisper to target first" },
-      after_transfer: { type: "string", enum: ["terminate", "return"], description: "terminate: end AI session (default), return: AI resumes after transfer ends" },
-      whisper: { type: "string", description: "Message to speak to transfer target before connecting customer (warm mode only)" },
-      caller_id: { type: "string", description: "Override caller ID for the transfer leg" },
-      timeout: { type: "integer", description: "Seconds to wait for transfer target to answer (default 30)" }
-    },
-    required: ["to"]
-  }
-};
-var TOOL_MAP = /* @__PURE__ */ new Map([
-  ["hang_up" /* HANG_UP */, HANG_UP],
-  ["collect_dtmf" /* COLLECT_DTMF */, COLLECT_DTMF],
-  ["send_dtmf" /* SEND_DTMF */, SEND_DTMF],
-  ["transfer_call" /* TRANSFER_CALL */, TRANSFER_CALL]
-]);
-var BUILTIN_TOOL_NAMES = new Set(
-  Array.from(TOOL_MAP.values()).map((s) => s.name)
-);
-function toChatCompletions(schema) {
-  return {
-    type: "function",
-    function: {
-      name: schema.name,
-      description: schema.description,
-      parameters: schema.parameters
-    }
-  };
-}
-function toRealtime(schema) {
-  return {
-    type: "function",
-    name: schema.name,
-    description: schema.description,
-    parameters: schema.parameters
-  };
-}
-function toGemini(schema) {
-  return {
-    name: schema.name,
-    description: schema.description,
-    parameters: schema.parameters
-  };
-}
-var CONVERTERS = {
-  chat: toChatCompletions,
-  realtime: toRealtime,
-  gemini: toGemini
-};
-function getBuiltinToolSchemas(builtinTools, fmt) {
-  const converter = CONVERTERS[fmt];
-  const result = [];
-  for (const [toolEnum, schema] of TOOL_MAP) {
-    if (builtinTools === null || builtinTools.has(toolEnum)) {
-      result.push(converter(schema));
-    }
-  }
-  return result;
-}
-function isBuiltinTool(name) {
-  return BUILTIN_TOOL_NAMES.has(name);
-}
-async function executeBuiltinTool(funcName, args, call) {
-  if (funcName === "hang_up") {
-    await call.hangup();
-    return "";
-  }
-  if (funcName === "collect_dtmf") {
-    try {
-      const result = await call.collectDtmf({
-        maxDigits: args["max_digits"] ?? 4,
-        finishOnKey: args["finish_on_key"] ?? "#",
-        timeout: args["timeout"] ?? 5
-      });
-      return result || "(\uD0C0\uC784\uC544\uC6C3 - \uC785\uB825 \uC5C6\uC74C)";
-    } catch (e) {
-      return `Error: ${e}`;
-    }
-  }
-  if (funcName === "send_dtmf") {
-    try {
-      await call.sendDtmfSequence(args["digits"] ?? "");
-      return "sent";
-    } catch (e) {
-      return `Error: ${e}`;
-    }
-  }
-  if (funcName === "transfer_call") {
-    try {
-      call.transfer(args["to"], {
-        destinationType: args["destination_type"] ?? void 0,
-        mode: args["mode"] ?? void 0,
-        afterTransfer: args["after_transfer"] ?? void 0,
-        whisper: args["whisper"] ?? void 0,
-        callerId: args["caller_id"] ?? void 0,
-        timeout: args["timeout"] ?? void 0
-      }).catch(() => {
-      });
-      return JSON.stringify({ status: "transfer_initiated" });
-    } catch (e) {
-      return `Error: ${e}`;
-    }
-  }
-  return null;
-}
-
-// src/agent/pipeline/buffering-call.ts
-var MetricsStub = class {
-  recordToolCall() {
-  }
-  recordInterrupt() {
-  }
-  recordToolError() {
-  }
-};
-var BufferingCall = class {
-  _buffer = [];
-  _droppedEvents = {};
-  metrics = new MetricsStub();
-  async sendAudio(chunk) {
-    this._buffer.push(chunk);
-  }
-  /** clearAudio 도 prewarm 동안엔 no-op (드물긴 하지만 안전하게). */
-  clearAudio() {
-    this._buffer = [];
-  }
-  /**
-   * transcript 등 lifecycle 이벤트는 prewarm 동안 무시한다. silent drop 은 디버깅이
-   * 어려우므로 event name 별 카운터로 누적하고 attachBuffered() 시 한 번에 로깅한다.
-   */
-  _emit(...args) {
-    this._recordDropped(args);
-  }
-  async emit(...args) {
-    this._recordDropped(args);
-  }
-  _recordDropped(args) {
-    let eventName = "?";
-    if (args.length > 0 && typeof args[0] === "string") {
-      eventName = args[0];
-    }
-    this._droppedEvents[eventName] = (this._droppedEvents[eventName] ?? 0) + 1;
-  }
-  recordToolCall() {
-  }
-  recordToolError() {
-  }
-  recordFirstResponse() {
-  }
-  recordBargeIn() {
-  }
-  drainBuffer() {
-    const out = this._buffer;
-    this._buffer = [];
-    return out;
-  }
-  drainDroppedEvents() {
-    const out = this._droppedEvents;
-    this._droppedEvents = {};
-    return out;
-  }
-};
-function attachBuffered(prev, next) {
-  if (!(prev instanceof BufferingCall)) {
-    return false;
-  }
-  const drained = prev.drainBuffer();
-  const flushed = drained.length > 0;
-  const callId = next.callId ?? "?";
-  if (flushed) {
-    console.info(
-      `[PREWARM-T] first-audio call_id=${callId} t=${(process.hrtime.bigint() / 1000000n).toString()} buffered_chunks=${drained.length} source=prebuffer`
-    );
-  }
-  for (const chunk of drained) {
-    next.sendAudio(chunk);
-  }
-  const dropped = prev.drainDroppedEvents();
-  if (Object.keys(dropped).length > 0) {
-    console.info(
-      `[PREWARM] dropped events during prewarm call_id=${callId} events=${JSON.stringify(dropped)}`
-    );
-  }
-  return flushed;
-}
-
 // src/agent/pipeline/pipeline-session.ts
 var PipelineSession = class {
   _stt;
@@ -4542,6 +3952,6 @@ function mcpServerHTTP(options) {
   };
 }
 
-export { AnthropicLLM, AudioRecorder, BUILTIN_TOOL_NAMES, BuiltinTool, CallSession, ClawOpsAgent, ControlWebSocket, DECODE_TABLE, DeepSeekLLM, DeepgramSTT, ElevenLabsTTS, FireworksLLM, GeminiLLM, GeminiRealtime, GroqLLM, MCPClient, MediaWebSocket, MistralLLM, OllamaLLM, OpenAICompatLLM, OpenAILLM, OpenAIRealtime, PerplexityLLM, PipelineSession, TogetherLLM, ToolRegistry, XaiLLM, buildControlWsUrl, createAgentLogger, createPipelineLogger, executeBuiltinTool, functionTool, getBuiltinToolSchemas, getTracingConfig, isBuiltinTool, mcpServerHTTP, mcpServerStdio, pcm16ToUlaw, resamplePcm16, resetTracingConfig, setTracingConfig, ulawToPcm16, zodToToolParams };
+export { AnthropicLLM, AudioRecorder, CallSession, ClawOpsAgent, ControlWebSocket, DeepSeekLLM, DeepgramSTT, ElevenLabsTTS, FireworksLLM, GeminiLLM, GeminiRealtime, GroqLLM, MCPClient, MediaWebSocket, MistralLLM, OllamaLLM, OpenAICompatLLM, OpenAILLM, OpenAIRealtime, PerplexityLLM, PipelineSession, TogetherLLM, ToolRegistry, XaiLLM, buildControlWsUrl, functionTool, getTracingConfig, mcpServerHTTP, mcpServerStdio, resetTracingConfig, setTracingConfig, zodToToolParams };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map