@squidcloud/twilio-client 1.0.494 → 1.0.496

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -42,6 +42,10 @@ export interface AiAgentTwilioIntegrationOptions {
42
42
  openAiVoiceIntegrationId?: IntegrationId;
43
43
  /** OpenAI engine: the realtime model that talks on the call. Defaults to the integration's default model. */
44
44
  voiceModel?: string;
45
+ /** OpenAI engine: whether caller speech interrupts the model. Omitted values keep OpenAI's default. */
46
+ allowInterruptions?: boolean;
47
+ /** OpenAI engine: how readily caller speech is detected. Omitted values keep OpenAI's default. */
48
+ interruptionSensitivity?: 'low' | 'normal' | 'high';
45
49
  /** Spoken as soon as a call is answered. Defaults to a short greeting in `language`, when one is known. */
46
50
  welcomeGreeting?: string;
47
51
  /**
@@ -1,2 +1,2 @@
1
- export { AiAgentTwilioIntegrationOptions, GetTwilioCallTranscriptRequest, GetTwilioCallTranscriptResponse, ListTwilioPhoneNumbersRequest, ListTwilioPhoneNumbersResponse, PlaceTwilioCallRequest, PlaceTwilioCallResponse, ProvisionTwilioAgentRequest, ProvisionTwilioAgentResponse, SMS_EVENT_TYPE, SendTwilioSmsRequest, SendTwilioSmsResponse, TwilioAgentProvisioning, TwilioCallRecord, TwilioCallTranscriptEntry, TwilioPhoneNumber, TwilioSmsEvent, VoiceEngine, VoiceMode, } from '../../common/src/twilio-types';
1
+ export { AiAgentTwilioIntegrationOptions, CallSid, CreateTwilioCustomerVoiceTokenRequest, CreateTwilioCustomerVoiceTokenResponse, ElevenLabsProvisionedIds, GetTwilioCallTranscriptRequest, GetTwilioCallTranscriptResponse, GetTwilioCustomerVoiceCallRequest, GetTwilioCustomerVoiceCallResponse, ListTwilioPhoneNumbersRequest, ListTwilioPhoneNumbersResponse, OpenAiVoiceSipTarget, PlaceTwilioCallRequest, PlaceTwilioCallResponse, ProvisionTwilioAgentRequest, ProvisionTwilioAgentResponse, SMS_EVENT_TYPE, SendTwilioSmsRequest, SendTwilioSmsResponse, SetTwilioHumanHandoffRequest, SetTwilioHumanHandoffResponse, TwilioAgentProvisioning, TwilioCallRecord, TwilioCallTranscriptEntry, TwilioPhoneNumber, TwilioSmsEvent, VOICE_ENGINES, VOICE_MODES, VoiceEngine, VoiceMode, } from '../../common/src/twilio-types';
2
2
  export * from './twilio-client';
@@ -1,5 +1,5 @@
1
1
  import { Squid } from '@squidcloud/client';
2
- import { GetTwilioCallTranscriptRequest, GetTwilioCallTranscriptResponse, ListTwilioPhoneNumbersResponse, PlaceTwilioCallRequest, PlaceTwilioCallResponse, ProvisionTwilioAgentRequest, ProvisionTwilioAgentResponse, SendTwilioSmsRequest, SendTwilioSmsResponse } from '../../common/src/twilio-types';
2
+ import { CreateTwilioCustomerVoiceTokenRequest, CreateTwilioCustomerVoiceTokenResponse, GetTwilioCallTranscriptRequest, GetTwilioCallTranscriptResponse, GetTwilioCustomerVoiceCallRequest, GetTwilioCustomerVoiceCallResponse, ListTwilioPhoneNumbersResponse, PlaceTwilioCallRequest, PlaceTwilioCallResponse, ProvisionTwilioAgentRequest, ProvisionTwilioAgentResponse, SendTwilioSmsRequest, SendTwilioSmsResponse, SetTwilioHumanHandoffRequest, SetTwilioHumanHandoffResponse } from '../../common/src/twilio-types';
3
3
  /** Client of the Twilio connector for one integration; every call needs an app API key. */
4
4
  export declare class SquidTwilioClient {
5
5
  private readonly squid;
@@ -15,4 +15,16 @@ export declare class SquidTwilioClient {
15
15
  listPhoneNumbers(): Promise<ListTwilioPhoneNumbersResponse>;
16
16
  /** Wires an agent's number up again and returns the outcome; saving the agent's connection does this on its own. */
17
17
  provisionAgent(request: Omit<ProvisionTwilioAgentRequest, 'integrationId'>): Promise<ProvisionTwilioAgentResponse>;
18
+ /**
19
+ * Issues a short-lived Twilio Voice SDK credential for a browser call with one agent. The browser connects
20
+ * with it and the call rings the agent like a call to its number; needs the integration's API key.
21
+ */
22
+ createCustomerVoiceToken(request: Omit<CreateTwilioCustomerVoiceTokenRequest, 'integrationId'>): Promise<CreateTwilioCustomerVoiceTokenResponse>;
23
+ /** The call a browser credential was used for, once the browser connected. */
24
+ getCustomerVoiceCall(request: Omit<GetTwilioCustomerVoiceCallRequest, 'integrationId'>): Promise<GetTwilioCustomerVoiceCallResponse>;
25
+ /**
26
+ * Claims a live call for a human handoff, confirms the human is on, or releases an unconfirmed claim. A
27
+ * claimed call is routed to `handoffUrl` at its next Twilio callback and is no longer ended by the agent.
28
+ */
29
+ setHumanHandoff(request: Omit<SetTwilioHumanHandoffRequest, 'integrationId'>): Promise<SetTwilioHumanHandoffResponse>;
18
30
  }
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- (()=>{"use strict";const e={d:(t,i)=>{if(Array.isArray(i))for(var n=0;n<i.length;){var r=i[n++],o=i[n++];e.o(t,r)?0===o&&n++:0===o?Object.defineProperty(t,r,{enumerable:!0,value:i[n++]}):Object.defineProperty(t,r,{enumerable:!0,get:o})}else for(var r in i)e.o(i,r)&&!e.o(t,r)&&Object.defineProperty(t,r,{enumerable:!0,get:i[r]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}};let t={};e.r(t),e.d(t,{SMS_EVENT_TYPE:()=>i,SquidTwilioClient:()=>n});const i="twilio-sms-event";class n{constructor(e,t){this.squid=e,this.integrationId=t}async sendSms(e){return this.squid.executeFunction("sendSms",{...e,integrationId:this.integrationId})}async placeCall(e){return this.squid.executeFunction("placeCall",{...e,integrationId:this.integrationId})}async getCallTranscript(e){return this.squid.executeFunction("getCallTranscript",{...e,integrationId:this.integrationId})}async listPhoneNumbers(){return this.squid.executeFunction("twilioListPhoneNumbers",{integrationId:this.integrationId})}async provisionAgent(e){return this.squid.executeFunction("twilioProvisionAgent",{...e,integrationId:this.integrationId})}}const r=exports;for(var o in t)r[o]=t[o];t.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();
1
+ (()=>{"use strict";const e={d:(t,i)=>{if(Array.isArray(i))for(var n=0;n<i.length;){var r=i[n++],o=i[n++];e.o(t,r)?0===o&&n++:0===o?Object.defineProperty(t,r,{enumerable:!0,value:i[n++]}):Object.defineProperty(t,r,{enumerable:!0,get:o})}else for(var r in i)e.o(i,r)&&!e.o(t,r)&&Object.defineProperty(t,r,{enumerable:!0,get:i[r]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}};let t={};e.r(t),e.d(t,{SMS_EVENT_TYPE:()=>i,SquidTwilioClient:()=>o,VOICE_ENGINES:()=>r,VOICE_MODES:()=>n});const i="twilio-sms-event",n=["relay","gather"],r=["twilio","elevenlabs","openai"];class o{constructor(e,t){this.squid=e,this.integrationId=t}async sendSms(e){return this.squid.executeFunction("sendSms",{...e,integrationId:this.integrationId})}async placeCall(e){return this.squid.executeFunction("placeCall",{...e,integrationId:this.integrationId})}async getCallTranscript(e){return this.squid.executeFunction("getCallTranscript",{...e,integrationId:this.integrationId})}async listPhoneNumbers(){return this.squid.executeFunction("twilioListPhoneNumbers",{integrationId:this.integrationId})}async provisionAgent(e){return this.squid.executeFunction("twilioProvisionAgent",{...e,integrationId:this.integrationId})}async createCustomerVoiceToken(e){return this.squid.executeFunction("twilioCreateCustomerVoiceToken",{...e,integrationId:this.integrationId})}async getCustomerVoiceCall(e){return this.squid.executeFunction("twilioGetCustomerVoiceCall",{...e,integrationId:this.integrationId})}async setHumanHandoff(e){return this.squid.executeFunction("twilioSetHumanHandoff",{...e,integrationId:this.integrationId})}}const s=exports;for(var a in t)s[a]=t[a];t.__esModule&&Object.defineProperty(s,"__esModule",{value:!0})})();
@@ -950,6 +950,12 @@ export interface AiStatusMessage {
950
950
  /** Optional tags providing additional metadata about the status. */
951
951
  tags?: Record<string, any>;
952
952
  }
953
+ /**
954
+ * `errorType` on a failed chat/ask job when the AI provider itself failed (a stall, timeout, or
955
+ * unrecognized 5xx) rather than Squid or the caller's request.
956
+ * @category AI
957
+ */
958
+ export declare const AI_PROVIDER_ERROR_TYPE = "AI_PROVIDER_ERROR";
953
959
  /** List of all chat history (memory) sources. */
954
960
  export declare const AI_CHAT_MESSAGE_SOURCE: readonly ["user", "ai"];
955
961
  /** Source of the chat history entry: either an AI response or a user. */
@@ -1068,17 +1074,12 @@ export interface UpsertContextStatusSuccess extends BaseUpsertContextStatus {
1068
1074
  imageFailureCount?: number;
1069
1075
  }
1070
1076
  /**
1071
- * Machine-readable code identifying a specific upsert failure reason.
1072
- *
1073
- * `DUPLICATE_CONTENT` means the request omitted a contextId and its content is
1074
- * byte-identical to an existing context in the same knowledge base.
1075
- *
1076
- * `EMBEDDING_FAILED` means extraction succeeded but embedding the context's chunks did not; the
1077
- * content was not written (an overwrite target keeps its previous content) and the request can be
1078
- * safely retried as-is.
1077
+ * Names an upsert failure; `DUPLICATE_CONTENT` identifies existing content when contextId is omitted.
1078
+ * `EMBEDDING_FAILED`, `EXTRACTION_TIMED_OUT`, `PROVIDER_ACCESS_DENIED`, and `SOURCE_UNREACHABLE` may
1079
+ * succeed on retry. Document faults carry `retryable: false` because the same bytes fail again.
1079
1080
  * @category AI
1080
1081
  */
1081
- export type UpsertContextErrorCode = 'DUPLICATE_CONTENT' | 'EMBEDDING_FAILED';
1082
+ export type UpsertContextErrorCode = 'CONTENT_TOO_LARGE' | 'DUPLICATE_CONTENT' | 'EMBEDDING_FAILED' | 'ENCRYPTED_DOCUMENT' | 'EXTRACTION_TIMED_OUT' | 'NO_EMBEDDABLE_CONTENT' | 'PROVIDER_ACCESS_DENIED' | 'SOURCE_OVER_PROVIDER_LIMIT' | 'SOURCE_UNREACHABLE' | 'UNREADABLE_WORKBOOK' | 'UNSUPPORTED_FILE_TYPE';
1082
1083
  /**
1083
1084
  * The existing context a `DUPLICATE_CONTENT` rejection points at — where the byte-identical original
1084
1085
  * already lives.
@@ -1105,6 +1106,11 @@ export interface UpsertContextStatusError extends BaseUpsertContextStatus {
1105
1106
  errorMessage: string;
1106
1107
  /** Machine-readable code for the failure, when one applies. */
1107
1108
  errorCode?: UpsertContextErrorCode;
1109
+ /**
1110
+ * Present only when the same bytes fail the same way again, so a caller must not retry the request
1111
+ * as-is. Absence means the failure may be transient.
1112
+ */
1113
+ retryable?: false;
1108
1114
  /**
1109
1115
  * The existing context this request duplicated, when `errorCode` is `DUPLICATE_CONTENT`. Lets a caller
1110
1116
  * point the user at where the original already lives (e.g. its folder) instead of only reporting the
@@ -1,4 +1,4 @@
1
- import { AgentContextRequest, AiChatModelSelection, AiReasoningEffort, ContextImageFailure, UpsertContextStatusError } from './ai-agent.public-types';
1
+ import { AiChatModelSelection, AiReasoningEffort, ContextImageFailure, UpsertContextStatusError } from './ai-agent.public-types';
2
2
  import { AiEmbeddingsModelSelection, AiRerankProvider } from './ai-common.public-types';
3
3
  import { AiContextId, AiKnowledgeBaseId, AppId } from './communication.public-types';
4
4
  import { DocumentExtractionMethod } from './extraction.public-types';
@@ -265,6 +265,13 @@ export interface AiKnowledgeBaseGraphConceptsConfig {
265
265
  * @category AI
266
266
  */
267
267
  export declare const FOLDER_PATH_METADATA_FIELD_NAME = "folderPath";
268
+ /**
269
+ * The canonical file-name metadata field: the source file's name, stamped by file ingestion (console
270
+ * upload, document connectors). Metadata extraction reads it, beside {@link FOLDER_PATH_METADATA_FIELD_NAME},
271
+ * as evidence about the document.
272
+ * @category AI
273
+ */
274
+ export declare const FILE_NAME_METADATA_FIELD_NAME = "filename";
268
275
  /**
269
276
  * A path facet: a deterministic tree built by splitting a hierarchical path field on {@link separator}.
270
277
  * Interior nodes are the path prefixes; scoping a search to one node matches that folder and everything
@@ -498,9 +505,18 @@ export interface AiKnowledgeBaseContext {
498
505
  * content-level dedup on upsert. Absent on legacy contexts ingested before hashing was introduced.
499
506
  */
500
507
  contentHash?: string;
501
- /** Original request configuration for how the context content was processed. */
502
- requestConfig?: AgentContextRequest;
508
+ /**
509
+ * The options the context was ingested with, replayed when it is reupserted. Absent on contexts that
510
+ * carry none; their reupsert takes the defaults.
511
+ */
512
+ requestConfig?: AiKnowledgeBaseContextRequestConfig;
503
513
  }
514
+ /**
515
+ * The ingestion request's options only. Everything else a reupsert needs lives on the context itself —
516
+ * its text or stored file, title, metadata and access scopes — where it can change after ingestion.
517
+ * @category AI
518
+ */
519
+ export type AiKnowledgeBaseContextRequestConfig = Omit<AiKnowledgeBaseTextContextRequest, 'text' | 'title' | 'metadata' | 'scopes'> | Omit<AiKnowledgeBaseFileContextRequest, 'metadata' | 'scopes'>;
504
520
  /**
505
521
  * @category AI
506
522
  */
@@ -633,11 +649,10 @@ export interface AiKnowledgeBaseFileContextRequest extends BaseAiKnowledgeBaseCo
633
649
  /** The preferred method for extracting data from the document. */
634
650
  preferredExtractionMethod?: DocumentExtractionMethod;
635
651
  /**
636
- * Whether Squid keeps or discards the original file.
637
- *
638
- * Keeping the original file allows reprocessing and the ability for the user to download it later.
639
- *
640
- * Defaults to false.
652
+ * Whether Squid discards the downloadable original once the file is extracted; the extracted text and
653
+ * images are stored either way. Defaults to false: the original is kept so the user can download it and
654
+ * Squid can reprocess it. Without it, `querySpreadsheetsWithAi` cannot open a workbook context and a
655
+ * reupsert of the context fails, on the sync and the bulk lane alike.
641
656
  */
642
657
  discardOriginalFile?: boolean;
643
658
  }
@@ -945,9 +960,9 @@ export interface GrepKnowledgeBaseResponse {
945
960
  */
946
961
  unscannedContextCount?: number;
947
962
  /**
948
- * With `limitation: 'truncatedContent'`, the file names of documents known to have lost content at
949
- * ingest. A bounded sample, not a complete list — present it as an example, and do not infer that
950
- * documents missing from it are intact.
963
+ * Every in-scope document known to have lost content at ingest, by file name. Present whenever such a
964
+ * document is in scope, alongside whichever {@link limitation} the scan reported — a cut document is no
965
+ * less cut because the scan also stopped early. Absent when none is.
951
966
  */
952
967
  truncatedContentFileNames?: Array<string>;
953
968
  }
@@ -1710,7 +1725,8 @@ export interface QueryKnowledgeBaseGraphResponse {
1710
1725
  summaries?: Array<KnowledgeBaseGraphQueryGlobalSummary>;
1711
1726
  }
1712
1727
  /**
1713
- * One context to stage through bulk ingestion.
1728
+ * One context to stage through bulk ingestion. Unlike the sync request, `imageExtractionModel` is not
1729
+ * accepted: a job bills one fixed vision model for every image it describes.
1714
1730
  * @category AI
1715
1731
  */
1716
1732
  export interface BulkIngestionContext {
@@ -1744,6 +1760,24 @@ export interface BulkIngestionContext {
1744
1760
  * same name, so a caller's choice survives whichever lane a deployment routes the upload through.
1745
1761
  */
1746
1762
  preferredExtractionMethod?: DocumentExtractionMethod;
1763
+ /**
1764
+ * The RAG type and chunk overlap this context is chunked and indexed with; mirrors the sync request's
1765
+ * `options`, with the same defaults (the knowledge base's `ragType`, and the overlap that type implies).
1766
+ * `chunkOverlap` must be a number below the 4,000-character chunk size.
1767
+ */
1768
+ options?: BaseAiKnowledgeBaseContextOptions;
1769
+ /**
1770
+ * Minimum width/height in pixels for an extracted image to be kept; mirrors the sync request's field of
1771
+ * the same name. Smaller images are skipped, and an inline markdown/HTML image below it keeps its raw
1772
+ * reference in the text.
1773
+ */
1774
+ imageMinSizePixels?: number;
1775
+ /**
1776
+ * Whether Squid discards a file context's downloadable original once it is extracted (the extracted
1777
+ * text and images are stored either way); mirrors {@link AiKnowledgeBaseFileContextRequest.discardOriginalFile},
1778
+ * with the same consequences. Ignored for a text context.
1779
+ */
1780
+ discardOriginalFile?: boolean;
1747
1781
  /**
1748
1782
  * Optional metadata associated with the context item; mirrors {@link BaseAiKnowledgeBaseContextRequest.metadata}.
1749
1783
  * Squid-reserved keys are stripped server-side, and values are validated/normalized against the target
@@ -1868,14 +1902,22 @@ export interface BulkIngestionFileStatus {
1868
1902
  * Machine-readable class of a failed file, for outcomes to treat differently from real failures.
1869
1903
  * Terminal — reported with `retryable: false` — are `'CONTENT_TOO_LARGE'` (past the per-context
1870
1904
  * ceiling), `'ENCRYPTED_DOCUMENT'`, `'NO_EMBEDDABLE_CONTENT'`, `'SOURCE_OVER_PROVIDER_LIMIT'` (the
1871
- * bytes exceed what the extraction provider accepts) and `'UNSUPPORTED_FILE_TYPE'`.
1905
+ * bytes exceed what the extraction provider accepts), `'UNREADABLE_WORKBOOK'` (a spreadsheet whose
1906
+ * content the parser cannot read) and `'UNSUPPORTED_FILE_TYPE'`.
1872
1907
  * `'DUPLICATE_CONTENT'` is a skip rather than a failure: the KB already holds this content.
1873
1908
  * `'EXTRACTION_TIMED_OUT'` stays retryable — the deadline is contended, so a borderline document can
1874
- * cross it under load. `'JOB_FULL'`: the job's request ceiling had no room left for this file, so re-submit it
1875
- * in a fresh job; a file that alone exceeds the ceiling fails this way in every job. Additive; absent for
1876
- * ordinary failures.
1909
+ * cross it under load. So do `'SOURCE_UNREACHABLE'` (the provider could not fetch the source, which a
1910
+ * fresh link can fix) and `'PROVIDER_ACCESS_DENIED'` (the provider refused the credential or its quota is
1911
+ * spent, a fault of the environment). `'JOB_FULL'`: the job's request ceiling had no room left for this
1912
+ * file, so re-submit it in a fresh job; a file that alone exceeds the ceiling fails this way in every job.
1913
+ * Additive; absent for ordinary failures.
1914
+ */
1915
+ errorCode?: 'CONTENT_TOO_LARGE' | 'DUPLICATE_CONTENT' | 'ENCRYPTED_DOCUMENT' | 'EXTRACTION_TIMED_OUT' | 'JOB_FULL' | 'NO_EMBEDDABLE_CONTENT' | 'PROVIDER_ACCESS_DENIED' | 'SOURCE_OVER_PROVIDER_LIMIT' | 'SOURCE_UNREACHABLE' | 'UNREADABLE_WORKBOOK' | 'UNSUPPORTED_FILE_TYPE';
1916
+ /**
1917
+ * Present only on a failed file an extraction provider answered: a stable fingerprint of that answer
1918
+ * (provider, HTTP status and provider code), so a caller can tell the same failure repeating from a new one.
1877
1919
  */
1878
- errorCode?: 'CONTENT_TOO_LARGE' | 'DUPLICATE_CONTENT' | 'ENCRYPTED_DOCUMENT' | 'EXTRACTION_TIMED_OUT' | 'JOB_FULL' | 'NO_EMBEDDABLE_CONTENT' | 'SOURCE_OVER_PROVIDER_LIMIT' | 'UNSUPPORTED_FILE_TYPE';
1920
+ errorSignature?: string;
1879
1921
  /**
1880
1922
  * Present only on a failed file: the same bytes fail the same way, so a caller must park the file
1881
1923
  * instead of re-submitting it. Absence means retryable.
@@ -1888,7 +1930,25 @@ export interface BulkIngestionFileStatus {
1888
1930
  imageFailures?: Array<ContextImageFailure>;
1889
1931
  /** Total number of failed images, which exceeds `imageFailures.length` when the list was capped. */
1890
1932
  imageFailureCount?: number;
1933
+ /**
1934
+ * Set on a `completed` file that is stored and searchable but that the job withheld from graph indexing;
1935
+ * the bulk counterpart of {@link UpsertKnowledgeBaseContextsResponse.graphIndexingSkippedContextIds}, and
1936
+ * `graphIndexingSkipReason` says why. Records the job's own outcome: it is written when the job's graph
1937
+ * run admits its files, which can be after the job completes (a poll of the job status sees it, the
1938
+ * terminal push may not), and it stays set even if a later graph build indexes the file.
1939
+ */
1940
+ graphIndexingSkipped?: boolean;
1941
+ /** Why graph indexing was withheld; present exactly when `graphIndexingSkipped` is. */
1942
+ graphIndexingSkipReason?: BulkIngestionGraphSkipReason;
1891
1943
  }
1944
+ /**
1945
+ * Why a bulk-ingested file was withheld from graph indexing. `'cap'`: the knowledge base is over its
1946
+ * per-KB graph chunk cap (or the cap could not be checked and the job failed closed), so the file stays
1947
+ * out until the cap allows it. `'queue'`: the graph-indexing queue was full when the file finalized; the
1948
+ * file is left to the graph auto-build sweep, which indexes it under the same cap once the job goes quiet.
1949
+ * @category AI
1950
+ */
1951
+ export type BulkIngestionGraphSkipReason = 'cap' | 'queue';
1892
1952
  /**
1893
1953
  * Why a whole bulk-ingestion staging call was refused, on the `details` of its 400 response. The
1894
1954
  * refusal names the one context that caused it, so a caller recording per-file outcomes charges only
@@ -78,6 +78,10 @@ export interface AnswerOpenAiVoiceCallRequest {
78
78
  model?: string;
79
79
  /** Voice of the realtime model; defaults to the integration's default voice. */
80
80
  voice?: string;
81
+ /** Whether caller speech interrupts the realtime model. Omitted values keep OpenAI's default. */
82
+ allowInterruptions?: boolean;
83
+ /** How readily OpenAI detects caller speech. Omitted values keep OpenAI's default. */
84
+ interruptionSensitivity?: 'low' | 'normal' | 'high';
81
85
  /** Instructions of the realtime model. */
82
86
  instructions: string;
83
87
  /** Spoken as soon as the call is answered; without it the model waits for the caller to speak first. */
@@ -124,6 +128,10 @@ export interface StartOpenAiWebVoiceCallRequest {
124
128
  model?: string;
125
129
  /** Voice of the realtime model. */
126
130
  voice?: string;
131
+ /** Whether caller speech interrupts the model; defaults to the phone line, then OpenAI's default. */
132
+ allowInterruptions?: boolean;
133
+ /** How readily caller speech is detected; defaults to the phone line, then OpenAI's default. */
134
+ interruptionSensitivity?: 'low' | 'normal' | 'high';
127
135
  /** Language the call starts in, as an ISO code or BCP-47 tag. */
128
136
  language?: string;
129
137
  /** Whether the caller may switch language mid-call. */
@@ -14,7 +14,7 @@ export declare const AUTH_INTEGRATION_TYPES: readonly ["auth0", "jwt_rsa", "jwt_
14
14
  * `AiAgentMcpServerConfig.oauthIntegrationId`). Kept in sync with the providers supported by the
15
15
  * MCP OAuth validation in core.
16
16
  */
17
- export declare const MCP_OAUTH_INTEGRATION_TYPES: readonly ["auth0"];
17
+ export declare const MCP_OAUTH_INTEGRATION_TYPES: readonly ["auth0", "azure-entra-id", "azure-entra-external-id"];
18
18
  /** Supported integration types for GraphQL-based services. */
19
19
  export declare const GRAPHQL_INTEGRATION_TYPES: readonly ["graphql"];
20
20
  /** Supported integration types for HTTP-based services. */
@@ -84,4 +84,18 @@ export interface AsyncJob<T = any> {
84
84
  * This is optional.
85
85
  */
86
86
  error?: string;
87
+ /**
88
+ * A machine-readable category for the error, if the job has failed. Lets a caller branch on the
89
+ * failure kind (e.g. `'AI_PROVIDER_ERROR'`) without parsing {@link error}.
90
+ */
91
+ errorType?: string;
92
+ }
93
+ /**
94
+ * An `Error` carrying a machine-readable {@link errorType}, thrown by `JobClient.awaitJob` when a
95
+ * failed job's {@link AsyncJob.errorType} is set. Lets a caller branch on the failure kind (e.g.
96
+ * `'AI_PROVIDER_ERROR'`) without parsing `message`.
97
+ */
98
+ export interface JobError extends Error {
99
+ /** The category the failed job's error was tagged with, if any (e.g. `'AI_PROVIDER_ERROR'`). */
100
+ errorType?: string;
87
101
  }
package/package.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "@squidcloud/twilio-client",
3
- "version": "1.0.494",
3
+ "version": "1.0.496",
4
4
  "description": "Squid Twilio Client",
5
5
  "main": "dist/index.js",
6
- "types": "dist/client/src/index.d.ts",
6
+ "types": "dist/connectors/twilio/twilio-client/src/index.d.ts",
7
7
  "scripts": {
8
8
  "prebuild": "del-cli dist",
9
9
  "build": "webpack --mode=production",
@@ -17,7 +17,7 @@
17
17
  "author": "",
18
18
  "license": "ISC",
19
19
  "dependencies": {
20
- "@squidcloud/client": "^1.0.494"
20
+ "@squidcloud/client": "^1.0.496"
21
21
  },
22
22
  "engines": {
23
23
  "node": ">=20.0.0"