@spekoai/sdk 0.4.3 → 0.5.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.5.2
+
+### Fixes
+
+- Correct the SDK User-Agent version and verify it against package.json before publication.
+
 ## 0.4.2 (2026-06-05)
 
 ### 🚀 Features

package/README.md

@@ -76,6 +76,94 @@ const { text, toolCalls } = await speko.complete({
 Webhook, builtin, and integration tools run server-side and are folded back into
 the response; inline tools come back to you as `toolCalls` to execute yourself.
 
+## Programmable voice (call control)
+
+`speko.callControl` drives **human** calls — on a browser softphone,
+phones on the PSTN — the way Telnyx Call Control does. Every leg of a call has
+an opaque `controlId`, and every verb is addressed to that handle, so a Telnyx
+integration ports one command to one command.
+
+```ts
+// Come online so inbound can ring you, and hold the presence connection open.
+import { PRESENCE_STALE_AFTER_MS } from '@spekoai/sdk';
+
+// The API key authenticates the org; brokerId identifies this softphone.
+const speko = new Speko({ apiKey: process.env.SPEKO_API_KEY, brokerId: 'broker-42' });
+
+await speko.callControl.register();
+const presence = await speko.callControl.presenceToken(); // → { token, url, ... }
+setInterval(() => speko.callControl.heartbeat(), PRESENCE_STALE_AFTER_MS / 3);
+
+// Dial out. The call comes back with its legs attached, plus the room
+// credentials for your own browser leg — you must be in the room before the far
+// end answers, or the first moments are silent.
+const { call, join } = await speko.callControl.dial({ to: '+12015551234' });
+const mine = call.legs.find((leg) => leg.kind === 'browser')!;
+const theirs = call.legs.find((leg) => leg.kind === 'pstn')!;
+// In the browser, join the room with those credentials:
+// VoiceConversation.create({ transportToken: join.token, transportUrl: join.url })
+
+await speko.callControl.mute(mine.controlId);
+// DTMF is addressed to the leg the tones are *for* — the customer's PSTN leg.
+// (Speko relays them out through an in-room browser leg, because only a
+// participant inside the room can publish SIP DTMF, but that's internal:
+// naming a non-PSTN leg fails with UNSUPPORTED_COMMAND.)
+await speko.callControl.dtmf(theirs.controlId, { digits: '1w2' });
+await speko.callControl.transfer(mine.controlId, { to: '+12015559876', mode: 'warm' });
+await speko.callControl.hangup(mine.controlId, { reason: 'resolved' });
+```
+
+Answering an inbound ring is the mirror image. A `RingOffer` arrives on the
+presence connection carrying **your own** leg's `controlId`; take a room token
+for it, connect, then answer:
+
+```ts
+// message: PresenceMessage, parsed off the presence data channel
+if (message.type === 'incoming_call') {
+  const credentials = await speko.callControl.join(message.controlId);
+  await VoiceConversation.create({
+    transportToken: credentials.token,
+    transportUrl: credentials.url,
+  });
+  await speko.callControl.answer(message.controlId); // join the room first, then answer
+}
+```
+
+The full verb set is `answer`, `hangup`, `bridge`, `hold`, `unhold`, `mute`,
+`unmute`, `dtmf`, `transfer` — each resolving to the leg's post-command state,
+so you never re-read to find out what you just did. `get`, `list`, and `events`
+read calls back; `events` is the recorded equivalent of the Telnyx webhook
+stream. The same events can be delivered as workspace webhooks (`call.initiated`
+… `call.hangup`); those are sent once, without automatic retry, so treat
+`events` as the durable record and reconcile from it.
+
+### Broker identity
+
+The API key authenticates the organization. `brokerId`, supplied once to
+`new Speko({ apiKey, brokerId })`, identifies the softphone. The SDK includes it
+automatically on `dial`, `join`, `register`, `heartbeat`, `setStatus`, and
+`presenceToken`.
+
+The command surface — `answer`, `hangup`, `hold`/`unhold`, `mute`/`unmute`,
+`dtmf`, `bridge`, `transfer`, plus `get`, `list`, `events` — accepts API keys on
+purpose: server-side automation acting on a live call is the point of a
+programmable-voice API, and those are scoped by the leg's organization.
+
+Two things differ from Telnyx and will bite if you assume otherwise:
+
+- **`hold` is silent.** It is synthesized from mute + unsubscribe; with no
+  music-on-hold source configured the held party hears nothing at all. Say so in
+  your UI — callers read silence as a dropped call.
+- **There is no SIP registrar.** Desk phones, third-party softphones, and other
+  PBXes cannot register and be rung. Human legs are browser legs; `browser` and
+  `pstn` are the only human-reachable leg kinds.
+
+Errors carry stable codes on `SpekoApiError.code`, exported as
+`VOICE_ERROR_CODES` so you can branch without string-matching prose.
+
+> `speko.voice.dial(...)` is a different thing and is unchanged: it dials an
+> **AI agent** out over the same telephony gateway.
+
 ## Documentation
 
 Full API reference and guides: <https://docs.speko.dev>

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { Speko } from './lib/client.js';
 export { SpekoApiError, SpekoAuthError, SpekoRateLimitError } from './lib/errors.js';
-export type { AgentAmbientClip, AgentBackgroundAudio, AgentCallListEntry, AgentCallListPage, AgentCallListParams, AgentCreateParams, AgentIntent, AgentLifecycleWebhookCreate, AgentLifecycleWebhookSerialized, AgentLifecycleWebhookUpdate, AgentLlmOptions, AgentRow, AgentStackPreferences, AgentSttOptions, AgentToolCreateParams, AgentToolRow, AgentToolSourceBuiltin, AgentToolSourceCreate, AgentToolSourceInline, AgentToolSourceIntegration, AgentToolSourceSerialized, AgentToolSourceUpdate, AgentToolSourceWebhookCreate, AgentToolSourceWebhookSerialized, AgentToolSourceWebhookUpdate, AgentToolUpdateParams, AgentUpdateParams, AgentWebhooksCreate, AgentWebhooksSerialized, AgentWebhooksUpdate, AvailablePhoneNumber, BlindTransferParams, CallCostLine, CallDetail, CallEvent, CallRecording, CallReport, CallTranscriptEntry, CallTransfer, CallTransferResponse, CancelScheduledCallbackParams, CancelWarmTransferParams, ChatMessage, ChatTool, ChatToolCall, ChatToolChoice, ChatToolExecutionMode, ChatToolSource, CompleteParams, CompleteResult, CompleteStreamEvent, CompleteWarmTransferParams, CreditLedgerEntry, CreditLedgerKind, CreditLedgerPage, CreditLedgerQueryParams, FinalizeCallReportParams, FinalizeCallReportResult, KeySource, KnowledgeBaseCreateParams, KnowledgeBaseDocumentCreateParams, KnowledgeBaseDocumentCreateResult, KnowledgeBaseDocumentPollOptions, KnowledgeBaseDocumentRow, KnowledgeBaseDocumentStatus, KnowledgeBaseDocumentUploadParams, KnowledgeBaseDocumentUploadSpec, KnowledgeBaseListParams, KnowledgeBaseRow, OptimizeFor, OrganizationBalance, PhoneNumberCreateParams, PhoneNumberDirection, PhoneNumberImportSipTrunkParams, PhoneNumberKybAuthorizedRepresentative, PhoneNumberKybBusinessProfile, PhoneNumberKybDraftParams, PhoneNumberKybOverview, PhoneNumberKybSlackNotificationStatus, PhoneNumberKybStatus, PhoneNumberKybSubmission, PhoneNumberKybSubmissionStatus, PhoneNumberKybSubmitParams, PhoneNumberRow, PhoneNumberSearchParams, PhoneNumberSetupStatus, PhoneNumberSmsAssignmentStatus, PhoneNumberSource, PhoneNumberUpdateParams, PipelineConstraints, RealtimeConnectParams, RealtimeEventHandler, RealtimeFrame, RealtimeProvider, RealtimeSessionHandle, RealtimeToolSpec, RoutingIntent, ScheduledCallback, ScheduledCallbackStatus, ScheduledCallbacksListParams, SpekoClientOptions, SynthesizeOptions, SynthesizeResult, SynthesizeStreamResult, TranscribeOptions, TranscribeResult, TranscribeStreamEvent, UsageByProvider, UsageQueryParams, UsageSummary, VoiceCatalogEntry, VoiceDialParams, VoiceDialResult, VoicesListParams, VoicesListResult, VoicesProviderEntry, WarmTransferDestination, WarmTransferFallback, WarmTransferFallbackResult, WarmTransferParams, WarmTransferVoicemailDetection, } from './lib/types/index.js';
+export type { AgentAmbientClip, AgentBackgroundAudio, AgentCallListEntry, AgentCallListPage, AgentCallListParams, AgentCreateParams, AgentExtractionField, AgentIntent, AgentLifecycleWebhookCreate, AgentLifecycleWebhookSerialized, AgentLifecycleWebhookUpdate, AgentLlmOptions, AgentRow, AgentStackPreferences, AgentSttOptions, AgentToolCreateParams, AgentToolRow, AgentToolSourceBuiltin, AgentToolSourceCreate, AgentToolSourceInline, AgentToolSourceIntegration, AgentToolSourceSerialized, AgentToolSourceUpdate, AgentToolSourceWebhookCreate, AgentToolSourceWebhookSerialized, AgentToolSourceWebhookUpdate, AgentToolUpdateParams, AgentUpdateParams, AgentWebhookAuthHeader, AgentWebhookAuthHeaderInput, AgentWebhooksCreate, AgentWebhooksSerialized, AgentWebhooksUpdate, AvailablePhoneNumber, BlindTransferParams, CallControlDialParams, CallControlDialResult, CallControlListParams, CallCostLine, CallDetail, CallEvent, CallRecording, CallReport, CallReportWebhookDelivery, CallTranscriptEntry, CallTransfer, CallTransferResponse, CancelScheduledCallbackParams, CancelWarmTransferParams, ChatMessage, ChatTool, ChatToolCall, ChatToolChoice, ChatToolExecutionMode, ChatToolSource, CompleteParams, CompleteResult, CompleteStreamEvent, CompleteWarmTransferParams, CreditLedgerEntry, CreditLedgerKind, CreditLedgerPage, CreditLedgerQueryParams, EndCallResult, FinalizeCallReportParams, FinalizeCallReportResult, KeySource, KnowledgeBaseCreateParams, KnowledgeBaseDocumentCreateParams, KnowledgeBaseDocumentCreateResult, KnowledgeBaseDocumentPollOptions, KnowledgeBaseDocumentRow, KnowledgeBaseDocumentStatus, KnowledgeBaseDocumentUploadParams, KnowledgeBaseDocumentUploadSpec, KnowledgeBaseListParams, KnowledgeBaseRow, OptimizeFor, OrganizationBalance, PhoneNumberCreateParams, PhoneNumberDirection, PhoneNumberImportSipTrunkParams, PhoneNumberKybAttestationContract, PhoneNumberKybAttestor, PhoneNumberKybAuthorizedRepresentative, PhoneNumberKybBusinessProfile, PhoneNumberKybDeclaration, PhoneNumberKybDraftParams, PhoneNumberKybOverview, PhoneNumberKybSlackNotificationStatus, PhoneNumberKybStatus, PhoneNumberKybSubmission, PhoneNumberKybSubmissionStatus, PhoneNumberKybSubmitParams, PhoneNumberRow, PhoneNumberSearchParams, PhoneNumberSetupStatus, PhoneNumberSmsAssignmentStatus, PhoneNumberSource, PhoneNumberUpdateParams, PipelineConstraints, RealtimeConnectParams, RealtimeEventHandler, RealtimeFrame, RealtimeProvider, RealtimeSessionHandle, RealtimeToolSpec, RoutingIntent, ScheduledCallback, ScheduledCallbackStatus, ScheduledCallbacksListParams, SessionStreamEvent, SessionStreamOptions, SessionTranscript, SessionTranscriptEntry, SmsBatch, SmsBatchCreateParams, SmsBatchRecipient, SmsConsent, SmsConsentInput, SmsConsentListParams, SmsConsentSource, SmsConversation, SmsConversationListParams, SmsConversationNote, SmsConversationSendParams, SmsConversationUpdate, SmsMessage, SmsMessageDirection, SmsMessageListParams, SmsMessageOrigin, SmsMessageStatus, SmsPage, SmsSegmentEstimate, SmsSendParams, SmsSettings, SmsSettingsUpdate, SmsStreamEvent, SmsSuppression, SpekoClientOptions, SynthesizeOptions, SynthesizeResult, SynthesizeStreamResult, TranscribeOptions, TranscribeResult, TranscribeStreamEvent, UsageByProvider, UsageQueryParams, UsageSummary, VoiceCatalogEntry, VoiceDialParams, VoiceDialResult, VoicesListParams, VoicesListResult, VoicesProviderEntry, WarmTransferDestination, WarmTransferFallback, WarmTransferFallbackResult, WarmTransferParams, WarmTransferVoicemailDetection, WebhookDelivery, WebhookDeliveryAttempt, WebhookDeliveryDetail, WebhookDeliveryEndpointOption, WebhookDeliveryListParams, WebhookDeliveryPage, WebhookDeliveryStatus, WebhookEndpoint, WebhookEndpointAuthHeaderInput, WebhookEndpointAuthHeaderUpdate, WebhookEndpointInput, WebhookEndpointUpdate, WebhookEventType, WebJoinParams, WebJoinResult, WorkspaceWebhookEventType, } from './lib/types/index.js';
+export type { BridgeCommandPayload, BrokerPresenceResource, BrokerPresenceStatus, CallCommand, CallCommandPayload, CallCommandResult, CallDirection, CallEventNotice, CallEventResource, CallEventType, CallJoinCredentials, CallLegKind, CallLegResource, CallLegStatus, CallResource, CallStatus, DtmfCommandPayload, HangupCommandPayload, PresenceMessage, RingOffer, TransferCommandPayload, VoiceErrorCode, } from './lib/voice-contract.js';
+export { BROKER_ID_PATTERN, CALL_COMMANDS, CALL_EVENTS, DTMF_PATTERN, PRESENCE_STALE_AFTER_MS, VOICE_ERROR_CODES, } from './lib/voice-contract.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACrF,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,2BAA2B,EAC3B,+BAA+B,EAC/B,2BAA2B,EAC3B,eAAe,EACf,QAAQ,EACR,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,EAC5B,gCAAgC,EAChC,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,6BAA6B,EAC7B,wBAAwB,EACxB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,SAAS,EACT,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,iCAAiC,EACjC,+BAA+B,EAC/B,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,+BAA+B,EAC/B,sCAAsC,EACtC,6BAA6B,EAC7B,yBAAyB,EACzB,sBAAsB,EACtB,qCAAqC,EACrC,oBAAoB,EACpB,wBAAwB,EACxB,8BAA8B,EAC9B,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { Speko } from './lib/client.js';
 export { SpekoApiError, SpekoAuthError, SpekoRateLimitError } from './lib/errors.js';
+export { BROKER_ID_PATTERN, CALL_COMMANDS, CALL_EVENTS, DTMF_PATTERN, PRESENCE_STALE_AFTER_MS, VOICE_ERROR_CODES, } from './lib/voice-contract.js';

package/dist/lib/client.d.ts

@@ -5,9 +5,12 @@ import { Credits } from './resources/credits.js';
 import { KnowledgeBases } from './resources/knowledge-bases.js';
 import { PhoneNumbers } from './resources/phone-numbers.js';
 import { Realtime } from './resources/realtime.js';
+import { Sessions } from './resources/sessions.js';
+import { Sms } from './resources/sms.js';
 import { Usage } from './resources/usage.js';
-import { Voice } from './resources/voice.js';
+import { CallControl, Voice } from './resources/voice.js';
 import { Voices } from './resources/voices.js';
+import { Webhooks } from './resources/webhooks.js';
 import type { CompleteParams, CompleteResult, CompleteStreamEvent, SpekoClientOptions, SynthesizeOptions, SynthesizeResult, SynthesizeStreamResult, TranscribeOptions, TranscribeResult, TranscribeStreamEvent } from './types/index.js';
 /**
  * Speko client — one API, every voice provider.
@@ -28,12 +31,21 @@ export declare class Speko {
     readonly credits: Credits;
     readonly realtime: Realtime;
     readonly voice: Voice;
+    /**
+     * Programmable voice: `controlId`-addressed call control for human calls,
+     * plus broker presence. See {@link CallControl} for the Telnyx Call Control
+     * mapping — including where it deliberately differs.
+     */
+    readonly callControl: CallControl;
     readonly voices: Voices;
     readonly phoneNumbers: PhoneNumbers;
     readonly agents: Agents;
     readonly knowledgeBases: KnowledgeBases;
     readonly calls: Calls;
     readonly callbacks: Callbacks;
+    readonly sessions: Sessions;
+    readonly webhooks: Webhooks;
+    readonly sms: Sms;
     private readonly transcribeResource;
     private readonly synthesizeResource;
     private readonly completeResource;

package/dist/lib/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAK1B;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;gBAEhC,OAAO,EAAE,kBAAkB;IA0BvC;;;;;;OAMG;IACH,UAAU,CACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAI5B,gBAAgB,CACd,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,qBAAqB,CAAC,qBAAqB,CAAC;IAI/C;;;;OAIG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAI5B,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,sBAAsB,CAAC;IAIlC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAIpF,cAAc,CACZ,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,WAAW,GACxB,qBAAqB,CAAC,mBAAmB,CAAC;CAG9C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"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"}

package/dist/lib/client.js

@@ -7,11 +7,15 @@ import { Credits } from './resources/credits.js';
 import { KnowledgeBases } from './resources/knowledge-bases.js';
 import { PhoneNumbers } from './resources/phone-numbers.js';
 import { Realtime } from './resources/realtime.js';
+import { Sessions } from './resources/sessions.js';
+import { Sms } from './resources/sms.js';
 import { Synthesize } from './resources/synthesize.js';
 import { Transcribe } from './resources/transcribe.js';
 import { Usage } from './resources/usage.js';
-import { Voice } from './resources/voice.js';
+import { CallControl, Voice } from './resources/voice.js';
 import { Voices } from './resources/voices.js';
+import { Webhooks } from './resources/webhooks.js';
+import { BROKER_ID_PATTERN } from './voice-contract.js';
 const DEFAULT_BASE_URL = 'https://api.speko.dev';
 const DEFAULT_TIMEOUT = 30_000;
 /**
@@ -33,18 +37,30 @@ export class Speko {
     credits;
     realtime;
     voice;
+    /**
+     * Programmable voice: `controlId`-addressed call control for human calls,
+     * plus broker presence. See {@link CallControl} for the Telnyx Call Control
+     * mapping — including where it deliberately differs.
+     */
+    callControl;
     voices;
     phoneNumbers;
     agents;
     knowledgeBases;
     calls;
     callbacks;
+    sessions;
+    webhooks;
+    sms;
     transcribeResource;
     synthesizeResource;
     completeResource;
     constructor(options) {
         if (!options.apiKey) {
-            throw new Error('Speko: apiKey is required. Get one at https://platform.speko.dev/api-keys');
+            throw new Error('Speko: apiKey is required. Get one at https://platform.speko.dev/agents/keys');
+        }
+        if (options.brokerId !== undefined && !BROKER_ID_PATTERN.test(options.brokerId)) {
+            throw new Error('Speko: brokerId must start with a letter or digit and contain only letters, digits, dot, underscore, or hyphen (max 128 characters)');
         }
         const http = new HttpClient({
             baseUrl: options.baseUrl ?? options.baseURL ?? DEFAULT_BASE_URL,
@@ -55,12 +71,16 @@ export class Speko {
         this.credits = new Credits(http);
         this.realtime = new Realtime(http);
         this.voice = new Voice(http);
+        this.callControl = new CallControl(http, options.brokerId);
         this.voices = new Voices(http);
         this.phoneNumbers = new PhoneNumbers(http);
         this.agents = new Agents(http);
         this.knowledgeBases = new KnowledgeBases(http);
         this.calls = new Calls(http);
         this.callbacks = new Callbacks(http);
+        this.sessions = new Sessions(http);
+        this.webhooks = new Webhooks(http);
+        this.sms = new Sms(http);
         this.transcribeResource = new Transcribe(http);
         this.synthesizeResource = new Synthesize(http);
         this.completeResource = new Complete(http);

package/dist/lib/http.d.ts

@@ -9,9 +9,9 @@ export declare class HttpClient {
     private readonly jsonHeaders;
     private readonly timeout;
     constructor(options: HttpClientOptions);
-    request<T>(method: string, path: string, body?: unknown, externalSignal?: AbortSignal): Promise<T>;
+    request<T>(method: string, path: string, body?: unknown, externalSignal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<T>;
     get<T>(path: string, externalSignal?: AbortSignal): Promise<T>;
-    post<T>(path: string, body: unknown, externalSignal?: AbortSignal): Promise<T>;
+    post<T>(path: string, body: unknown, externalSignal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<T>;
     put<T>(path: string, body: unknown, externalSignal?: AbortSignal): Promise<T>;
     delete<T>(path: string, externalSignal?: AbortSignal): Promise<T>;
     patch<T>(path: string, body: unknown, externalSignal?: AbortSignal): Promise<T>;
@@ -29,15 +29,23 @@ export declare class HttpClient {
         bytes: Uint8Array;
         headers: Record<string, string>;
     }>;
-    requestSse(method: string, path: string, body: unknown, externalSignal?: AbortSignal, extraHeaders?: Record<string, string>): AsyncIterableIterator<{
+    requestSse(method: string, path: string, body: unknown, externalSignal?: AbortSignal, extraHeaders?: Record<string, string>, 
+    /**
+     * Per-request override of the client timeout. Long-lived SSE responses
+     * (session observation) outlive the default 30 s, which would abort them
+     * mid-stream.
+     */
+    timeoutMs?: number): AsyncIterableIterator<{
         event: string;
+        id?: string;
         data: unknown;
     }>;
     requestRawSse(method: string, path: string, bodyBytes: Uint8Array, extraHeaders: Record<string, string>, externalSignal?: AbortSignal): Promise<AsyncIterableIterator<{
         event: string;
+        id?: string;
         data: unknown;
     }>>;
-    requestBinaryStream(method: string, path: string, body: unknown, externalSignal?: AbortSignal): Promise<{
+    requestBinaryStream(method: string, path: string, body: unknown, externalSignal?: AbortSignal, extraHeaders?: Record<string, string>): Promise<{
         chunks: AsyncIterableIterator<Uint8Array>;
         headers: Record<string, string>;
     }>;

package/dist/lib/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"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"}

package/dist/lib/http.js

@@ -1,5 +1,5 @@
 import { SpekoApiError, SpekoAuthError, SpekoRateLimitError } from './errors.js';
-const USER_AGENT = '@spekoai/sdk/0.4.1';
+const USER_AGENT = '@spekoai/sdk/0.5.2';
 export class HttpClient {
     baseUrl;
     authHeader;
@@ -15,19 +15,21 @@ export class HttpClient {
         };
         this.timeout = options.timeout;
     }
-    async request(method, path, body, externalSignal) {
+    async request(method, path, body, externalSignal, extraHeaders) {
         const url = `${this.baseUrl}${path}`;
         const { signal, cleanup } = this.buildSignal(externalSignal);
         try {
             const response = await fetch(url, {
                 method,
-                headers: this.jsonHeaders,
+                headers: { ...this.jsonHeaders, ...extraHeaders },
                 body: body ? JSON.stringify(body) : undefined,
                 signal,
             });
             if (!response.ok) {
                 await this.handleError(response);
             }
+            if (response.status === 204)
+                return undefined;
             return (await response.json());
         }
         finally {
@@ -37,8 +39,8 @@ export class HttpClient {
     async get(path, externalSignal) {
         return this.request('GET', path, undefined, externalSignal);
     }
-    async post(path, body, externalSignal) {
-        return this.request('POST', path, body, externalSignal);
+    async post(path, body, externalSignal, extraHeaders) {
+        return this.request('POST', path, body, externalSignal, extraHeaders);
     }
     async put(path, body, externalSignal) {
         return this.request('PUT', path, body, externalSignal);
@@ -106,9 +108,15 @@ export class HttpClient {
             cleanup();
         }
     }
-    async *requestSse(method, path, body, externalSignal, extraHeaders) {
+    async *requestSse(method, path, body, externalSignal, extraHeaders, 
+    /**
+     * Per-request override of the client timeout. Long-lived SSE responses
+     * (session observation) outlive the default 30 s, which would abort them
+     * mid-stream.
+     */
+    timeoutMs) {
         const url = `${this.baseUrl}${path}`;
-        const { signal, cleanup } = this.buildSignal(externalSignal);
+        const { signal, cleanup } = this.buildSignal(externalSignal, timeoutMs);
         let reader;
         try {
             const response = await fetch(url, {
@@ -171,12 +179,12 @@ export class HttpClient {
         }
         return this.readSseBody(response.body, cleanup);
     }
-    async requestBinaryStream(method, path, body, externalSignal) {
+    async requestBinaryStream(method, path, body, externalSignal, extraHeaders) {
         const url = `${this.baseUrl}${path}`;
         const { signal, cleanup } = this.buildSignal(externalSignal);
         const response = await fetch(url, {
             method,
-            headers: this.jsonHeaders,
+            headers: { ...this.jsonHeaders, ...extraHeaders },
             body: body ? JSON.stringify(body) : undefined,
             signal,
         });
@@ -244,9 +252,10 @@ export class HttpClient {
      * that callers can cancel in-flight requests (e.g. LiveKit Agents tearing
      * down a session) while still enforcing the client's configured timeout.
      */
-    buildSignal(externalSignal) {
+    buildSignal(externalSignal, timeoutMs) {
         const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), this.timeout);
+        const effectiveTimeout = timeoutMs ?? this.timeout;
+        const timer = effectiveTimeout > 0 ? setTimeout(() => controller.abort(), effectiveTimeout) : null;
         if (externalSignal) {
             if (externalSignal.aborted) {
                 controller.abort(externalSignal.reason);
@@ -257,7 +266,8 @@ export class HttpClient {
                 return {
                     signal: controller.signal,
                     cleanup: () => {
-                        clearTimeout(timer);
+                        if (timer)
+                            clearTimeout(timer);
                         externalSignal.removeEventListener('abort', onAbort);
                     },
                 };
@@ -265,7 +275,10 @@ export class HttpClient {
         }
         return {
             signal: controller.signal,
-            cleanup: () => clearTimeout(timer),
+            cleanup: () => {
+                if (timer)
+                    clearTimeout(timer);
+            },
         };
     }
     async handleError(response) {
@@ -303,11 +316,15 @@ function drainSseEvents(buffer) {
         if (!block.trim())
             continue;
         let event = 'message';
+        let id;
         const dataLines = [];
         for (const line of block.split(/\r?\n/)) {
             if (line.startsWith('event:')) {
                 event = line.slice('event:'.length).trim();
             }
+            else if (line.startsWith('id:')) {
+                id = line.slice('id:'.length).trim();
+            }
             else if (line.startsWith('data:')) {
                 dataLines.push(line.slice('data:'.length).trimStart());
             }
@@ -320,7 +337,7 @@ function drainSseEvents(buffer) {
         catch {
             // Keep non-JSON SSE payloads as strings.
         }
-        items.push({ event, data });
+        items.push({ event, ...(id ? { id } : {}), data });
     }
     return { items, remainder: buffer.slice(cursor) };
 }

package/dist/lib/resources/agents.d.ts

@@ -67,7 +67,15 @@ export declare class Agents {
 export declare class AgentTools {
     private readonly http;
     constructor(http: HttpClient);
-    list(agentId: string, abortSignal?: AbortSignal): Promise<AgentToolRow[]>;
+    /**
+     * @param opts.available When true, the server returns only tools the agent
+     *   can actually run right now — integration tools whose backing installation
+     *   is disconnected/missing are omitted. Use this on the runtime path so the
+     *   model is never offered a tool that would fail.
+     */
+    list(agentId: string, abortSignal?: AbortSignal, opts?: {
+        available?: boolean;
+    }): Promise<AgentToolRow[]>;
     create(agentId: string, params: AgentToolCreateParams, abortSignal?: AbortSignal): Promise<AgentToolRow>;
     get(agentId: string, toolId: string, abortSignal?: AbortSignal): Promise<AgentToolRow>;
     update(agentId: string, toolId: string, params: AgentToolUpdateParams, abortSignal?: AbortSignal): Promise<AgentToolRow>;
@@ -80,6 +88,8 @@ export declare class AgentTools {
      * four source kinds (`inline`, `webhook`, `builtin`, `integration`) — load
      * once and pass the result straight to `speko.complete({ tools })`.
      */
-    listChatTools(agentId: string, abortSignal?: AbortSignal): Promise<ChatTool[]>;
+    listChatTools(agentId: string, abortSignal?: AbortSignal, opts?: {
+        available?: boolean;
+    }): Promise<ChatTool[]>;
 }
 //# sourceMappingURL=agents.d.ts.map

package/dist/lib/resources/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,MAAM;IAGL,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;gBAEE,IAAI,EAAE,UAAU;IAI7C,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI3B,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAItD;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOlF;;;;;OAKG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOjE;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAUzF;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAOzE,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,qBAAqB,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,YAAY,CAAC;IAQxB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAOtF,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qBAAqB,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,YAAY,CAAC;IAQxB,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAOhC;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAIrF"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,MAAM;IAGL,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;gBAEE,IAAI,EAAE,UAAU;IAI7C,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI3B,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAItD;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOlF;;;;;OAKG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOjE;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAUzF;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;OAKG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,WAAW,EACzB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC;IAQ1B,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,qBAAqB,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,YAAY,CAAC;IAQxB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAOtF,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qBAAqB,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,YAAY,CAAC;IAQxB,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAOhC;;;;;OAKG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,WAAW,EACzB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,OAAO,CAAC,QAAQ,EAAE,CAAC;CAIvB"}

package/dist/lib/resources/agents.js

@@ -92,8 +92,15 @@ export class AgentTools {
     constructor(http) {
         this.http = http;
     }
-    list(agentId, abortSignal) {
-        return this.http.get(`/v1/agents/${encodeURIComponent(agentId)}/tools`, abortSignal);
+    /**
+     * @param opts.available When true, the server returns only tools the agent
+     *   can actually run right now — integration tools whose backing installation
+     *   is disconnected/missing are omitted. Use this on the runtime path so the
+     *   model is never offered a tool that would fail.
+     */
+    list(agentId, abortSignal, opts) {
+        const query = opts?.available ? '?available=1' : '';
+        return this.http.get(`/v1/agents/${encodeURIComponent(agentId)}/tools${query}`, abortSignal);
     }
     create(agentId, params, abortSignal) {
         return this.http.post(`/v1/agents/${encodeURIComponent(agentId)}/tools`, params, abortSignal);
@@ -113,8 +120,8 @@ export class AgentTools {
      * four source kinds (`inline`, `webhook`, `builtin`, `integration`) — load
      * once and pass the result straight to `speko.complete({ tools })`.
      */
-    async listChatTools(agentId, abortSignal) {
-        const rows = await this.list(agentId, abortSignal);
+    async listChatTools(agentId, abortSignal, opts) {
+        const rows = await this.list(agentId, abortSignal, opts);
         return rows.map(toChatTool);
     }
 }
@@ -130,5 +137,6 @@ function toChatTool(row) {
         parameters: row.parameters,
         executionMode: row.source.kind,
         source: row.source,
+        ...(row.preToolSpeech !== undefined && { preToolSpeech: row.preToolSpeech }),
     };
 }

package/dist/lib/resources/calls.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../http.js';
-import type { BlindTransferParams, CallDetail, CallEvent, CallRecording, CallReport, CallTransfer, CallTransferResponse, CancelWarmTransferParams, CompleteWarmTransferParams, FinalizeCallReportParams, FinalizeCallReportResult, WarmTransferParams } from '../types/index.js';
+import type { BlindTransferParams, CallDetail, CallEvent, CallRecording, CallReport, CallTransfer, CallTransferResponse, CancelWarmTransferParams, CompleteWarmTransferParams, EndCallResult, FinalizeCallReportParams, FinalizeCallReportResult, WarmTransferParams, WebJoinParams, WebJoinResult } from '../types/index.js';
 export declare class Calls {
     private readonly http;
     constructor(http: HttpClient);
@@ -10,6 +10,24 @@ export declare class Calls {
     report(callId: string): Promise<CallReport>;
     finalizeReport(callId: string, params?: FinalizeCallReportParams): Promise<FinalizeCallReportResult>;
     recording(callId: string): Promise<CallRecording>;
+    /**
+     * Browser bridge-in: mint a short-lived token that joins THIS live call's
+     * room from a web client (pass `token`/`url` to `@spekoai/client`'s
+     * `VoiceConversation.create({ transportToken, transportUrl })`). Once the
+     * browser publishes audio the platform bridges it to the phone leg and
+     * mutes the agent; when the browser leaves, the agent resumes.
+     *
+     * Mint at click time — the token is short-TTL and a `409` means the call
+     * is no longer live. Concurrent/repeat joins are allowed (rejoin after a
+     * drop just calls this again).
+     */
+    webJoin(callId: string, params?: WebJoinParams): Promise<WebJoinResult>;
+    /**
+     * End a live call now (kill switch): tears the room down, which hangs up
+     * every leg. Resolves with `status: 'ending'` once teardown is requested,
+     * or `status: 'already_ended'` if the call was over.
+     */
+    end(callId: string): Promise<EndCallResult>;
     blindTransfer(callId: string, params: BlindTransferParams): Promise<CallTransfer>;
     warmTransfer(callId: string, params: WarmTransferParams): Promise<CallTransferResponse>;
     completeWarmTransfer(callId: string, transferId: string, params?: CompleteWarmTransferParams): Promise<CallTransfer>;

package/dist/lib/resources/calls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAIxD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3C,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAOpC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAOjF,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOvF,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,0BAA+B,GACtC,OAAO,CAAC,YAAY,CAAC;IASxB,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,oBAAoB,CAAC;CAMjC"}
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,aAAa,EACb,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAIxD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3C,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAOpC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAO3E;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI3C,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAOjF,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOvF,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,0BAA+B,GACtC,OAAO,CAAC,YAAY,CAAC;IASxB,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,oBAAoB,CAAC;CAMjC"}

package/dist/lib/resources/calls.js

@@ -18,6 +18,28 @@ export class Calls {
     recording(callId) {
         return this.http.get(`/v1/calls/${encodeURIComponent(callId)}/recording`);
     }
+    /**
+     * Browser bridge-in: mint a short-lived token that joins THIS live call's
+     * room from a web client (pass `token`/`url` to `@spekoai/client`'s
+     * `VoiceConversation.create({ transportToken, transportUrl })`). Once the
+     * browser publishes audio the platform bridges it to the phone leg and
+     * mutes the agent; when the browser leaves, the agent resumes.
+     *
+     * Mint at click time — the token is short-TTL and a `409` means the call
+     * is no longer live. Concurrent/repeat joins are allowed (rejoin after a
+     * drop just calls this again).
+     */
+    webJoin(callId, params = {}) {
+        return this.http.post(`/v1/calls/${encodeURIComponent(callId)}/web-join`, params);
+    }
+    /**
+     * End a live call now (kill switch): tears the room down, which hangs up
+     * every leg. Resolves with `status: 'ending'` once teardown is requested,
+     * or `status: 'already_ended'` if the call was over.
+     */
+    end(callId) {
+        return this.http.post(`/v1/calls/${encodeURIComponent(callId)}/end`, {});
+    }
     blindTransfer(callId, params) {
         return this.http.post(`/v1/calls/${encodeURIComponent(callId)}/transfers/blind`, params);
     }

package/dist/lib/resources/knowledge-bases.d.ts

@@ -2,7 +2,7 @@ import type { HttpClient } from '../http.js';
 import type { KnowledgeBaseCreateParams, KnowledgeBaseDocumentCreateParams, KnowledgeBaseDocumentCreateResult, KnowledgeBaseDocumentPollOptions, KnowledgeBaseDocumentRow, KnowledgeBaseDocumentUploadParams, KnowledgeBaseListParams, KnowledgeBaseRow } from '../types/index.js';
 /**
  * Per-agent knowledge bases. Each KB owns documents that get embedded
- * into a Chroma collection so the agent can retrieve relevant chunks
+ * into a PHALANX tenant so the agent can retrieve relevant chunks
  * during a call. Every agent created via {@link Agents.create}
  * auto-provisions a `Default` KB; additional KBs can be created
  * explicitly with {@link KnowledgeBases.create}.

package/dist/lib/resources/knowledge-bases.js

@@ -3,7 +3,7 @@ const DEFAULT_POLL_INTERVAL_MS = 2_000;
 const DEFAULT_POLL_TIMEOUT_MS = 120_000;
 /**
  * Per-agent knowledge bases. Each KB owns documents that get embedded
- * into a Chroma collection so the agent can retrieve relevant chunks
+ * into a PHALANX tenant so the agent can retrieve relevant chunks
  * during a call. Every agent created via {@link Agents.create}
  * auto-provisions a `Default` KB; additional KBs can be created
  * explicitly with {@link KnowledgeBases.create}.

package/dist/lib/resources/phone-numbers.d.ts

@@ -56,7 +56,8 @@ export declare class PhoneNumbers {
      */
     saveKybDraft(params: PhoneNumberKybDraftParams): Promise<PhoneNumberKybSubmission>;
     /**
-     * Submit business verification for review. `attestationAccepted` must be `true`.
+     * Submit a business declaration for asynchronous review. A current minimal
+     * declaration enables purchasing immediately; the legacy full profile remains accepted.
      */
     submitKyb(params: PhoneNumberKybSubmitParams): Promise<PhoneNumberKybSubmission>;
 }

package/dist/lib/resources/phone-numbers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phone-numbers.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/phone-numbers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIjC;;;;;;;;;;OAUG;IACH,eAAe,CAAC,MAAM,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAWtF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxC,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhE,cAAc,CAAC,MAAM,EAAE,+BAA+B,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI5E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAIlD;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAIzC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIlF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAGjF"}
+{"version":3,"file":"phone-numbers.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/phone-numbers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EACvB,+BAA+B,EAC/B,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIjC;;;;;;;;;;OAUG;IACH,eAAe,CAAC,MAAM,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAWtF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxC,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhE,cAAc,CAAC,MAAM,EAAE,+BAA+B,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI5E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAIlD;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAIzC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIlF;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAGjF"}