voicegate 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voicegate",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Node.js SDK for VoiceGate — voice infrastructure for AI agents, with KYA agent identity (by CallsFlow Ltd)",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -22,7 +22,7 @@
   "homepage": "https://aivoicegate.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/IgorSokhinov/voicegate-sdk.git"
+    "url": "https://github.com/CallsFlow/voicegate-sdk.git"
   },
   "engines": {
     "node": ">=18"

package/src/index.js

@@ -92,16 +92,20 @@ class VoiceGateError extends Error {
 
 class VoiceGate {
   constructor(opts = {}) {
-    this.base = (opts.baseUrl || 'https://api.aivoicegate.com').replace(/\/+$/, '');
+    this.base = (opts.baseUrl || 'https://aivoicegate.com').replace(/\/+$/, '');
     this.kya = (opts.kyaUrl || opts.baseUrl || this.base).replace(/\/+$/, '');
     this.apiKey = opts.apiKey || null;
     this.timeout = opts.timeout || 30000;
     this._session = null;
   }
 
-  async _request(method, url, body, auth) {
+  // `auth` is a KYA session token (Bearer); `apiKey` is the account key the
+  // gateway expects in x-api-key. Different headers — a key sent as Bearer
+  // just earns a 401.
+  async _request(method, url, body, auth, apiKey) {
     const headers = { 'Content-Type': 'application/json' };
     if (auth) headers['Authorization'] = 'Bearer ' + auth;
+    if (apiKey) headers['x-api-key'] = apiKey;
     const ctrl = new AbortController();
     const t = setTimeout(() => ctrl.abort(), this.timeout);
     let resp;
@@ -120,11 +124,51 @@ class VoiceGate {
     return text ? JSON.parse(text) : null;
   }
 
+  // Чем представляться шлюзу. Сессия агента (вход по KYA-удостоверению) важнее
+  // ключа-интегратора: если агент вошёл сам, он и платит за свои звонки. Ключ
+  // от нас нужен только тем, кто ведёт много агентов из собственной системы.
+  _creds() {
+    return this._session ? [this._session, null] : [null, this.apiKey];
+  }
+
   // ── voice call (private beta) ──────────────────────────────────────────────
-  async call({ to, agentWebhook, voice = 'female', language = 'en', initialMessage } = {}) {
-    const body = { to, voice, language, agent_webhook: agentWebhook, pay: 'usdc:base' };
-    if (initialMessage) body.initial_message = initialMessage;
-    return this._request('POST', this.base + '/v1/agent-call', body, this.apiKey);
+  /**
+   * Place an outbound call.
+   *
+   * `greeting` is spoken the moment the line connects — say who is calling and
+   * on whose behalf. `prompt` drives the agent's side: goal, acceptable
+   * outcomes, when to hang up.
+   *
+   * Resolves to { status, call_uuid, hold_micros, rate_micros_per_min,
+   * destination_region }. The hold covers the maximum call length; you are
+   * charged for the billable seconds actually talked.
+   */
+  async call({ to, greeting, prompt, language = 'en', voice = 'female', agentId, callerId } = {}) {
+    const body = { to, greeting, prompt, language, voice };
+    if (agentId) body.agent_id = agentId;
+    if (callerId) body.caller_id = callerId;
+    return this._request('POST', this.base + '/v1/agent-call', body, ...this._creds());
+  }
+
+  // ── billing ────────────────────────────────────────────────────────────────
+  /** Balance, holds and the terms this account is charged under. */
+  async balance(agentId) {
+    return this._request('GET', `${this.base}/v1/billing/${agentId}/balance`, null, ...this._creds());
+  }
+
+  /**
+   * Bind a Base address so incoming USDC from it credits this agent. Link
+   * before sending anything: a transfer from an unknown address still arrives,
+   * but cannot be attributed to you automatically.
+   */
+  async linkWallet(agentId, walletAddress) {
+    return this._request('POST', `${this.base}/v1/billing/${agentId}/wallet`,
+      { wallet_address: walletAddress }, ...this._creds());
+  }
+
+  /** Append-only ledger: topup, hold, release, charge, refund, adjust. */
+  async transactions(agentId) {
+    return this._request('GET', `${this.base}/v1/billing/${agentId}/transactions`, null, ...this._creds());
   }
 
   // ── KYA — Know Your Agent (live) ───────────────────────────────────────────