@squidcloud/twilio-client 1.0.493 → 1.0.495

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.
@@ -124,6 +124,10 @@ export interface TwilioSmsEvent {
124
124
  /** A phone call handled by the connector, stored in the `twilio_calls` collection under its call id. */
125
125
  export interface TwilioCallRecord {
126
126
  callSid: CallSid;
127
+ channel?: 'phone' | 'web';
128
+ webCallerKey?: string;
129
+ humanHandoffId?: string | null;
130
+ humanHandoffConfirmed?: boolean;
127
131
  integrationId: IntegrationId;
128
132
  /** The agent on the call. */
129
133
  agentId?: string;
@@ -153,6 +157,38 @@ export interface TwilioCallTranscriptEntry {
153
157
  text: string;
154
158
  at: Date;
155
159
  }
160
+ /** Requests an outgoing-only browser credential for one authorized agent. */
161
+ export interface CreateTwilioCustomerVoiceTokenRequest {
162
+ integrationId: IntegrationId;
163
+ agentId: string;
164
+ webCallerKey: string;
165
+ }
166
+ export interface CreateTwilioCustomerVoiceTokenResponse {
167
+ token: string;
168
+ identity: string;
169
+ expiresAt: string;
170
+ }
171
+ export interface GetTwilioCustomerVoiceCallRequest {
172
+ integrationId: IntegrationId;
173
+ identity: string;
174
+ }
175
+ export interface GetTwilioCustomerVoiceCallResponse {
176
+ callSid?: CallSid;
177
+ webCallerKey: string;
178
+ status?: string;
179
+ }
180
+ /** Controls ownership of an existing customer call during a human handoff. */
181
+ export interface SetTwilioHumanHandoffRequest {
182
+ integrationId: IntegrationId;
183
+ callSid: CallSid;
184
+ handoffId: string;
185
+ action?: 'claim' | 'confirm' | 'release';
186
+ handoffUrl?: string;
187
+ }
188
+ export interface SetTwilioHumanHandoffResponse {
189
+ handoffId: string | null;
190
+ confirmed: boolean;
191
+ }
156
192
  /** Request for the `sendSms` executable. */
157
193
  export interface SendTwilioSmsRequest {
158
194
  integrationId: IntegrationId;
@@ -781,6 +781,19 @@ export type AiChatOptions<T extends AiChatModelSelection | undefined = undefined
781
781
  export type AllAiAgentChatOptions = {
782
782
  [K in keyof BaseAiChatOptions | keyof GeminiChatOptions | keyof GrokChatOptions | keyof OpenAiChatOptions | keyof AnthropicChatOptions]?: (K extends keyof BaseAiChatOptions ? BaseAiChatOptions[K] : never) | (K extends keyof GeminiChatOptions ? GeminiChatOptions[K] : never) | (K extends keyof GrokChatOptions ? GrokChatOptions[K] : never) | (K extends keyof OpenAiChatOptions ? OpenAiChatOptions[K] : never) | (K extends keyof AnthropicChatOptions ? AnthropicChatOptions[K] : never);
783
783
  };
784
+ /**
785
+ * Credentials a caller sends with one chat request. The client sends them in the `x-squid-integration-access-tokens`
786
+ * request header rather than with the options, so they reach only the tools that run with them and are never stored
787
+ * with the agent.
788
+ * @category AI
789
+ */
790
+ export interface AiChatRequestCredentials {
791
+ /**
792
+ * Access tokens keyed by integration ID. The integration's tools run with its token for this request when the
793
+ * integration type supports it; other types ignore it.
794
+ */
795
+ integrationAccessTokens?: Record<IntegrationId, string>;
796
+ }
784
797
  /**
785
798
  * Configuration for exposing an AI agent as an MCP server at `/mcp/<agentId>`.
786
799
  * @category AI
@@ -1871,11 +1871,18 @@ export interface BulkIngestionFileStatus {
1871
1871
  * bytes exceed what the extraction provider accepts) and `'UNSUPPORTED_FILE_TYPE'`.
1872
1872
  * `'DUPLICATE_CONTENT'` is a skip rather than a failure: the KB already holds this content.
1873
1873
  * `'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.
1874
+ * cross it under load. So do `'SOURCE_UNREACHABLE'` (the provider could not fetch the source, which a
1875
+ * fresh link can fix) and `'PROVIDER_ACCESS_DENIED'` (the provider refused the credential or its quota is
1876
+ * spent, a fault of the environment). `'JOB_FULL'`: the job's request ceiling had no room left for this
1877
+ * file, so re-submit it in a fresh job; a file that alone exceeds the ceiling fails this way in every job.
1878
+ * Additive; absent for ordinary failures.
1877
1879
  */
1878
- errorCode?: 'CONTENT_TOO_LARGE' | 'DUPLICATE_CONTENT' | 'ENCRYPTED_DOCUMENT' | 'EXTRACTION_TIMED_OUT' | 'JOB_FULL' | 'NO_EMBEDDABLE_CONTENT' | 'SOURCE_OVER_PROVIDER_LIMIT' | 'UNSUPPORTED_FILE_TYPE';
1880
+ 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' | 'UNSUPPORTED_FILE_TYPE';
1881
+ /**
1882
+ * Present only on a failed file an extraction provider answered: a stable fingerprint of that answer
1883
+ * (provider, HTTP status and provider code), so a caller can tell the same failure repeating from a new one.
1884
+ */
1885
+ errorSignature?: string;
1879
1886
  /**
1880
1887
  * Present only on a failed file: the same bytes fail the same way, so a caller must park the file
1881
1888
  * instead of re-submitting it. Absence means retryable.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@squidcloud/twilio-client",
3
- "version": "1.0.493",
3
+ "version": "1.0.495",
4
4
  "description": "Squid Twilio Client",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/client/src/index.d.ts",
@@ -17,7 +17,7 @@
17
17
  "author": "",
18
18
  "license": "ISC",
19
19
  "dependencies": {
20
- "@squidcloud/client": "^1.0.493"
20
+ "@squidcloud/client": "^1.0.495"
21
21
  },
22
22
  "engines": {
23
23
  "node": ">=20.0.0"