getpatter 0.5.4 → 0.6.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Nicolò Tognoni
+Copyright (c) 2026 Patter Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -62,6 +62,7 @@ await phone.serve({ agent, tunnel: true });
 | Call recording | `serve({ recording: true })` | Record all calls |
 | Call transfer | `transfer_call` (auto-injected) | Transfer to a human |
 | Voicemail drop | `call({ voicemailMessage: "..." })` | Play message on voicemail |
+| Phone-as-a-tool (external agents) | `new PatterTool({ phone, agent }).execute(...)` | Drop into LangChain / OpenAI Assistants / Hermes / MCP |
 
 ## Configuration
 
@@ -182,7 +183,7 @@ import {
   // Engines
   OpenAIRealtime, ElevenLabsConvAI,
   // STT
-  DeepgramSTT, WhisperSTT, CartesiaSTT, SonioxSTT, AssemblyAISTT,
+  DeepgramSTT, WhisperSTT, OpenAITranscribeSTT, CartesiaSTT, SonioxSTT, AssemblyAISTT,
   // TTS
   ElevenLabsTTS, OpenAITTS, CartesiaTTS, RimeTTS, LMNTTTS,
   // LLM
@@ -191,6 +192,8 @@ import {
   CloudflareTunnel, StaticTunnel,
   // Primitives
   Tool, Guardrail, tool, guardrail,
+  // Integrations
+  PatterTool,
 } from "getpatter";
 ```
 
@@ -306,7 +309,7 @@ const agent = phone.agent({
 Pull requests are welcome.
 
 ```bash
-cd sdk-ts && npm install && npm test
+cd libraries/typescript && npm install && npm test
 ```
 
 Please open an issue before submitting large changes so we can discuss the approach first.

package/dist/aec-PJJMUM5E.mjs

@@ -0,0 +1,228 @@
+import {
+  init_esm_shims
+} from "./chunk-N565J3CF.mjs";
+
+// src/audio/aec.ts
+init_esm_shims();
+var DEFAULT_FILTER_TAPS = 512;
+var DEFAULT_STEP_SIZE = 0.1;
+var DEFAULT_WARMUP_STEP_SIZE = 0.5;
+var DEFAULT_WARMUP_SECONDS = 0.5;
+var DEFAULT_LEAKAGE = 0.9999;
+var DEFAULT_DOUBLE_TALK_RHO = 0.6;
+var FAR_END_BUFFER_SECONDS = 0.5;
+var NlmsEchoCanceller = class {
+  taps;
+  step;
+  warmupStep;
+  warmupSamples;
+  leakage;
+  rho;
+  /** Filter coefficients — adapt to match the channel impulse response. */
+  w;
+  /** Far-end ring buffer of past TTS samples, in chronological order. */
+  farBuf;
+  farWriteIdx = 0;
+  farFilled = 0;
+  /**
+   * Sample counter used to taper the step from `warmupStep` down to
+   * `step` over the first `warmupSamples` of processed near-end audio.
+   * Counted from the first `processNearEnd` call (not construction
+   * time) so the warmup window aligns with the actual start of TTS
+   * playback rather than agent setup.
+   */
+  processedSamples = 0;
+  /** Stats — used for diagnostics, never read on the hot path. */
+  framesProcessed = 0;
+  doubleTalkFrames = 0;
+  constructor(opts = {}) {
+    const sampleRate = opts.sampleRate ?? 16e3;
+    if (sampleRate !== 8e3 && sampleRate !== 16e3) {
+      throw new Error(
+        `NlmsEchoCanceller supports 8000 Hz or 16000 Hz only; got ${sampleRate}.`
+      );
+    }
+    const taps = opts.filterTaps ?? DEFAULT_FILTER_TAPS;
+    if (taps < 64) {
+      throw new Error(
+        `filterTaps must be >= 64 to model a meaningful echo path; got ${taps}.`
+      );
+    }
+    const step = opts.stepSize ?? DEFAULT_STEP_SIZE;
+    if (!(step > 0 && step <= 1)) {
+      throw new Error(`stepSize must be in (0, 1]; got ${step}.`);
+    }
+    const warmupStep = opts.warmupStepSize ?? DEFAULT_WARMUP_STEP_SIZE;
+    if (!(warmupStep > 0 && warmupStep <= 1)) {
+      throw new Error(
+        `warmupStepSize must be in (0, 1]; got ${warmupStep}.`
+      );
+    }
+    const warmupSeconds = opts.warmupSeconds ?? DEFAULT_WARMUP_SECONDS;
+    if (warmupSeconds < 0) {
+      throw new Error(
+        `warmupSeconds must be >= 0; got ${warmupSeconds}.`
+      );
+    }
+    const leakage = opts.leakage ?? DEFAULT_LEAKAGE;
+    if (!(leakage > 0 && leakage <= 1)) {
+      throw new Error(`leakage must be in (0, 1]; got ${leakage}.`);
+    }
+    this.taps = taps;
+    this.step = step;
+    this.warmupStep = warmupStep;
+    this.warmupSamples = Math.floor(warmupSeconds * sampleRate);
+    this.leakage = leakage;
+    this.rho = opts.doubleTalkRho ?? DEFAULT_DOUBLE_TALK_RHO;
+    this.w = new Float32Array(taps);
+    const farBufSize = Math.max(
+      taps * 2,
+      Math.floor(sampleRate * FAR_END_BUFFER_SECONDS)
+    );
+    this.farBuf = new Float32Array(farBufSize);
+  }
+  /**
+   * Append far-end (TTS) audio to the reference ring buffer.
+   *
+   * Accepts raw int16 little-endian mono PCM at the configured sample
+   * rate — same shape as what we hand off to the audio sender before the
+   * carrier-specific transcode.
+   */
+  pushFarEnd(pcm) {
+    if (pcm.length === 0) return;
+    const samples = int16BufferToFloat32(pcm);
+    const n = samples.length;
+    const bufLen = this.farBuf.length;
+    if (n >= bufLen) {
+      this.farBuf.set(samples.subarray(n - bufLen));
+      this.farWriteIdx = 0;
+      this.farFilled = bufLen;
+      return;
+    }
+    const end = this.farWriteIdx + n;
+    if (end <= bufLen) {
+      this.farBuf.set(samples, this.farWriteIdx);
+    } else {
+      const head = bufLen - this.farWriteIdx;
+      this.farBuf.set(samples.subarray(0, head), this.farWriteIdx);
+      this.farBuf.set(samples.subarray(head), 0);
+    }
+    this.farWriteIdx = (this.farWriteIdx + n) % bufLen;
+    this.farFilled = Math.min(this.farFilled + n, bufLen);
+  }
+  /**
+   * Subtract estimated echo from the near-end (mic) signal.
+   *
+   * Returns int16 little-endian mono PCM with the estimated echo
+   * removed. When the far-end buffer hasn't been primed yet (no TTS has
+   * played) the call is a pass-through — there is nothing to cancel.
+   */
+  processNearEnd(pcm) {
+    if (pcm.length === 0) return pcm;
+    if (this.farFilled < this.taps) return pcm;
+    const near = int16BufferToFloat32(pcm);
+    const cleaned = this.blockNlms(near);
+    this.framesProcessed += 1;
+    return float32ToInt16Buffer(cleaned);
+  }
+  /**
+   * Clear filter coefficients and far-end history.
+   *
+   * Useful between unrelated turns when the echo path may have changed
+   * (e.g. caller switched from speakerphone to handset).
+   */
+  reset() {
+    this.w.fill(0);
+    this.farBuf.fill(0);
+    this.farWriteIdx = 0;
+    this.farFilled = 0;
+    this.processedSamples = 0;
+    this.framesProcessed = 0;
+    this.doubleTalkFrames = 0;
+  }
+  // --------------------------------------------------------------------
+  // Internals
+  // --------------------------------------------------------------------
+  /** Most-recent ``length`` far-end samples in chronological order. */
+  farWindow(length) {
+    const bufLen = this.farBuf.length;
+    const len = Math.min(length, this.farFilled);
+    const end = this.farWriteIdx;
+    if (end >= len) {
+      return this.farBuf.subarray(end - len, end);
+    }
+    const head = bufLen - (len - end);
+    const out = new Float32Array(len);
+    out.set(this.farBuf.subarray(head));
+    out.set(this.farBuf.subarray(0, end), bufLen - head);
+    return out;
+  }
+  /** Sample-by-sample NLMS over a frame of near-end samples. */
+  blockNlms(near) {
+    const taps = this.taps;
+    const desiredLen = taps + near.length - 1;
+    let farWindow = this.farWindow(desiredLen);
+    if (farWindow.length < desiredLen) {
+      const padded = new Float32Array(desiredLen);
+      padded.set(farWindow, desiredLen - farWindow.length);
+      farWindow = padded;
+    }
+    let farMax = 0;
+    for (let i = 0; i < farWindow.length; i++) {
+      const a = Math.abs(farWindow[i]);
+      if (a > farMax) farMax = a;
+    }
+    let nearMax = 0;
+    for (let i = 0; i < near.length; i++) {
+      const a = Math.abs(near[i]);
+      if (a > nearMax) nearMax = a;
+    }
+    const doubleTalk = farMax > 1e-6 ? nearMax > this.rho * farMax : false;
+    if (doubleTalk) this.doubleTalkFrames += 1;
+    const out = new Float32Array(near.length);
+    const w = this.w;
+    const leakage = this.leakage;
+    const step = this.processedSamples < this.warmupSamples ? this.warmupStep : this.step;
+    for (let i = 0; i < near.length; i++) {
+      let yEst = 0;
+      let norm = 0;
+      const base = i;
+      for (let k = 0; k < taps; k++) {
+        const xk = farWindow[base + k];
+        yEst += w[k] * xk;
+        norm += xk * xk;
+      }
+      const e = near[i] - yEst;
+      out[i] = e;
+      if (!doubleTalk) {
+        const denom = norm + 1e-6;
+        const factor = step * e / denom;
+        for (let k = 0; k < taps; k++) {
+          w[k] = leakage * w[k] + factor * farWindow[base + k];
+        }
+      }
+    }
+    this.processedSamples += near.length;
+    return out;
+  }
+};
+function int16BufferToFloat32(buf) {
+  const samples = new Float32Array(buf.length / 2);
+  for (let i = 0; i < samples.length; i++) {
+    samples[i] = buf.readInt16LE(i * 2) / 32768;
+  }
+  return samples;
+}
+function float32ToInt16Buffer(samples) {
+  const out = Buffer.alloc(samples.length * 2);
+  for (let i = 0; i < samples.length; i++) {
+    let v = Math.round(samples[i] * 32768);
+    if (v > 32767) v = 32767;
+    else if (v < -32768) v = -32768;
+    out.writeInt16LE(v, i * 2);
+  }
+  return out;
+}
+export {
+  NlmsEchoCanceller
+};

package/dist/{banner-3GNZ6VQK.mjs → banner-UYW6UM3J.mjs}

@@ -1,6 +1,9 @@
-import "./chunk-QHHBUCMT.mjs";
+import {
+  init_esm_shims
+} from "./chunk-N565J3CF.mjs";
 
 // src/banner.ts
+init_esm_shims();
 var BANNER = `
 \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557
 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557

package/dist/barge-in-strategies-X6ARMGIQ.mjs

@@ -0,0 +1,12 @@
+import {
+  MinWordsStrategy,
+  evaluateStrategies,
+  resetStrategies
+} from "./chunk-D4424JZR.mjs";
+import "./chunk-MVOQFAEO.mjs";
+import "./chunk-N565J3CF.mjs";
+export {
+  MinWordsStrategy,
+  evaluateStrategies,
+  resetStrategies
+};

package/dist/{carrier-config-33HQ2W4V.mjs → carrier-config-4ZKVYAWV.mjs}

@@ -1,9 +1,12 @@
 import {
   getLogger
-} from "./chunk-VJVDG4V5.mjs";
-import "./chunk-QHHBUCMT.mjs";
+} from "./chunk-MVOQFAEO.mjs";
+import {
+  init_esm_shims
+} from "./chunk-N565J3CF.mjs";
 
 // src/carrier-config.ts
+init_esm_shims();
 var TWILIO_API_BASE = "https://api.twilio.com/2010-04-01";
 var TELNYX_API_BASE = "https://api.telnyx.com/v2";
 async function configureTwilioNumber(accountSid, authToken, phoneNumber, voiceUrl) {

package/dist/{chunk-AFUYSNDH.mjs → chunk-6GR5MHHQ.mjs}

@@ -1,6 +1,15 @@
+import {
+  init_esm_shims
+} from "./chunk-N565J3CF.mjs";
+
 // src/dashboard/persistence.ts
+init_esm_shims();
 import http from "http";
 function notifyDashboard(callData, port = 8e3) {
+  const flag = (process.env.PATTER_DASHBOARD_NOTIFY ?? "").trim().toLowerCase();
+  if (flag === "0" || flag === "false" || flag === "no" || flag === "off") {
+    return;
+  }
   try {
     const body = JSON.stringify(callData);
     const req = http.request(