@squidcloud/twilio-client 1.0.506 → 1.0.507

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.
@@ -434,10 +434,10 @@ export type AiModelRoutingLevel = 'simple' | 'moderate' | 'complex';
434
434
  */
435
435
  export interface AiModelRoutingOptions {
436
436
  /**
437
- * The ladder of vendor models, cheapest first: two or three, no duplicates, each run at its default effort.
437
+ * The ladder, cheapest first: two or three distinct steps, each a vendor model name or a model with its own effort.
438
438
  * Omitted, the platform's fast, medium and capable chat models form the ladder, at low, default and high effort.
439
439
  */
440
- models?: VendorAiChatModelName[];
440
+ models?: Array<VendorAiChatModelName | AiModelRoutingStep>;
441
441
  /** The vendor model that rates the question. */
442
442
  routingModel: VendorAiChatModelName;
443
443
  /**
@@ -446,6 +446,39 @@ export interface AiModelRoutingOptions {
446
446
  */
447
447
  instructions?: string;
448
448
  }
449
+ /**
450
+ * One step of a routing ladder. A bare model name in the ladder runs at the request's or agent's effort, else the
451
+ * model's default.
452
+ * @category AI
453
+ */
454
+ export interface AiModelRoutingStep {
455
+ /** The vendor model of the step. */
456
+ model: VendorAiChatModelName;
457
+ /**
458
+ * The effort the step runs at, resolved to a level the model accepts. Overrides the request's and agent's effort.
459
+ */
460
+ reasoningEffort?: AiReasoningEffort;
461
+ }
462
+ /**
463
+ * Gives the answering model a tool that consults a stronger model mid-turn. The turn stays on its own model, so its
464
+ * prompt cache survives, and the advisor gets only what the answering model passes it.
465
+ * @category AI
466
+ */
467
+ export interface AiAdvisorOptions {
468
+ /** The model that gives the advice. */
469
+ model: AiChatModelSelection;
470
+ /** The effort the advisor runs at. A vendor model runs at the nearest level it accepts. */
471
+ reasoningEffort?: AiReasoningEffort;
472
+ /** Added to the advisor's prompt, to steer what it answers and how. */
473
+ instructions?: string;
474
+ /** Consultations allowed per turn, 1 to 10. Defaults to 3. */
475
+ maxConsultations?: number;
476
+ /**
477
+ * Lets the advisor call the turn's functions, including ones with side effects, and pays for its tool loop.
478
+ * Defaults to false: the advisor sees only what the answering model passes it.
479
+ */
480
+ shareFunctions?: boolean;
481
+ }
449
482
  /**
450
483
  * The model of an `ask` or `chat` request: a concrete model, or a set of models a routing model chooses from.
451
484
  * @category AI
@@ -474,8 +507,8 @@ export interface AiModelRoutingResult {
474
507
  /** The ladder model the request was sent to. A `backupModel` may still have served it. */
475
508
  model: AiChatModelName;
476
509
  /**
477
- * The reasoning effort the chosen model ran at: its ladder step's effort, or the request's or agent's
478
- * effort resolved to a level the model accepts when one was set. Undefined is the model's default.
510
+ * The reasoning effort the chosen model ran at, resolved to a level the model accepts: the step's own effort,
511
+ * else the request's or agent's, else the platform ladder step's. Undefined is the model's default.
479
512
  */
480
513
  reasoningEffort?: AiReasoningEffort;
481
514
  /** The model that rated the question. */
@@ -616,6 +649,8 @@ export interface BaseAiChatOptions {
616
649
  contextMetadataFilterForKnowledgeBase?: Record<AiKnowledgeBaseId, AiContextMetadataFilter>;
617
650
  /** The options to use for the response in voice. */
618
651
  voiceOptions?: AiAudioCreateSpeechOptions;
652
+ /** A stronger model the answering model can consult mid-turn. Overrides the stored value. */
653
+ advisor?: AiAdvisorOptions;
619
654
  /** List of connected AI agents can be called by the current agent. Overrides the stored value. */
620
655
  connectedAgents?: Array<AiConnectedAgentMetadata>;
621
656
  /** List of connected AI agents can be called by the current agent. Overrides the stored value. */
@@ -61,12 +61,12 @@ export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-4.6", "grok-4-1-fast
61
61
  * Public Anthropic chat model names (active models only).
62
62
  * @category AI
63
63
  */
64
- export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-fable-5", "claude-fable-5-1", "claude-haiku-5-5", "claude-opus-5-5", "claude-sonnet-5-5"];
64
+ export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-fable-5-1", "claude-haiku-5-5", "claude-opus-5-5", "claude-sonnet-5-5"];
65
65
  /**
66
66
  * The supported AI model names.
67
67
  * @category AI
68
68
  */
69
- export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5.6-sol", "gpt-5.6-luna", "gpt-6-astra", "gpt-6-luna", "gpt-6.1-sol", "gpt-6.1-terra", "claude-fable-5", "claude-fable-5-1", "claude-haiku-5-5", "claude-opus-5-5", "claude-sonnet-5-5", "gemini-4-argon", "gemini-3.8-flash", "gemini-3.5-flash-lite", "grok-4.6", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
69
+ export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5.6-sol", "gpt-5.6-luna", "gpt-6-astra", "gpt-6-luna", "gpt-6.1-sol", "gpt-6.1-terra", "claude-fable-5-1", "claude-haiku-5-5", "claude-opus-5-5", "claude-sonnet-5-5", "gemini-4-argon", "gemini-3.8-flash", "gemini-3.5-flash-lite", "grok-4.6", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
70
70
  /** Checks if the given model name is a global AI chat model name. */
71
71
  export declare function isVendorAiChatModelName(modelName: unknown): modelName is VendorAiChatModelName;
72
72
  /**
@@ -682,7 +682,7 @@ export interface AiKnowledgeBaseFileContextRequest extends BaseAiKnowledgeBaseCo
682
682
  * Whether Squid discards the downloadable original once the file is extracted; the extracted text and
683
683
  * images are stored either way. Defaults to false: the original is kept so the user can download it and
684
684
  * Squid can reprocess it. Without it, `querySpreadsheetsWithAi` cannot open a workbook context and a
685
- * reupsert of the context fails, on the sync and the bulk lane alike.
685
+ * reupsert of the context fails, on the sync and the bulk path alike.
686
686
  */
687
687
  discardOriginalFile?: boolean;
688
688
  }
@@ -705,7 +705,7 @@ export declare const BULK_INGESTION_MAX_MULTIPART_FILE_BYTES: number;
705
705
  */
706
706
  export declare const MAX_UPLOAD_FILE_BYTES: number;
707
707
  /**
708
- * Largest OneNote section (`.one`) a knowledge base ingests, on either lane. A section carries its attachments,
708
+ * Largest OneNote section (`.one`) a knowledge base ingests, on either path. A section carries its attachments,
709
709
  * each indexed as a context of its own, so it may exceed {@link MAX_UPLOAD_FILE_BYTES}.
710
710
  * @category AI
711
711
  */
@@ -1969,8 +1969,8 @@ export interface BulkIngestionContext {
1969
1969
  */
1970
1970
  stagedObjectKey?: string;
1971
1971
  /**
1972
- * The preferred method for extracting data from a file context; mirrors the sync lane's field of the
1973
- * same name, so a caller's choice survives whichever lane a deployment routes the upload through.
1972
+ * The preferred method for extracting data from a file context; mirrors the sync path's field of the
1973
+ * same name, so a caller's choice survives whichever path a deployment routes the upload through.
1974
1974
  */
1975
1975
  preferredExtractionMethod?: DocumentExtractionMethod;
1976
1976
  /**
@@ -2007,7 +2007,7 @@ export interface BulkIngestionContext {
2007
2007
  scopes?: Array<string>;
2008
2008
  }
2009
2009
  /**
2010
- * Request structure for staging contexts through bulk ingestion: a durable, asynchronous lane that
2010
+ * Request structure for staging contexts through bulk ingestion: a durable, asynchronous path that
2011
2011
  * processes contexts through provider batch APIs rather than inline, for high-volume ingestion. Poll
2012
2012
  * {@link BulkIngestionJobStatusResponse} with the returned job id for progress.
2013
2013
  * @category AI
@@ -2063,7 +2063,7 @@ export interface BulkIngestionUpsertContextsResponse {
2063
2063
  * an existing context or accepted earlier in this same call. Absent when nothing was rejected.
2064
2064
  *
2065
2065
  * Same shape and `errorCode: 'DUPLICATE_CONTENT'` the synchronous `upsertContexts` returns, so a caller
2066
- * handles a duplicate identically on both lanes. These contexts are NOT part of the job: they are not
2066
+ * handles a duplicate identically on both paths. These contexts are NOT part of the job: they are not
2067
2067
  * extracted, not staged, and never appear in its per-file statuses.
2068
2068
  *
2069
2069
  * Covers TEXT contexts and MULTIPART file contexts (their bytes are in hand at staging). A file staged
@@ -2197,8 +2197,8 @@ export interface AiKnowledgeBaseFileStatusInfo {
2197
2197
  errorMessage?: string;
2198
2198
  /**
2199
2199
  * Present only when `status` is `'failed'`: the machine-readable failure class, when known. A bulk
2200
- * lane failure reports {@link BulkIngestionFileErrorCode}; a synchronous `upsertContexts` failure
2201
- * reports {@link UpsertContextErrorCode} — the two lanes use distinct, mostly-overlapping codes.
2200
+ * path failure reports {@link BulkIngestionFileErrorCode}; a synchronous `upsertContexts` failure
2201
+ * reports {@link UpsertContextErrorCode} — the two paths use distinct, mostly-overlapping codes.
2202
2202
  */
2203
2203
  errorCode?: BulkIngestionFileErrorCode | UpsertContextErrorCode;
2204
2204
  /** When this status was last recorded; absent when `status` is `'no_record'`. */
@@ -2272,7 +2272,7 @@ export interface BulkIngestionStagingRefusal {
2272
2272
  }
2273
2273
  /**
2274
2274
  * One provider batch created for a bulk-ingestion job, so a caller can tell a job waiting on a
2275
- * submitted provider batch (healthy — the designed cost/latency tradeoff of the batch lane, with
2275
+ * submitted provider batch (healthy — the designed cost/latency tradeoff of the batch route, with
2276
2276
  * turnaround up to 24 hours) from a job that is actually stuck, and see since when.
2277
2277
  * @category AI
2278
2278
  */
@@ -300,7 +300,7 @@ export interface ExtractDataFromDocumentResponse {
300
300
  documentMetadata?: DocumentMetadata;
301
301
  /**
302
302
  * Structural information about the sheets when the document is a parseable spreadsheet
303
- * (best-effort). Presence marks the document for the spreadsheet summary-embedding lane.
303
+ * (best-effort). Presence marks the document for spreadsheet summary ingestion.
304
304
  */
305
305
  spreadsheet?: SpreadsheetDocumentInfo;
306
306
  }
@@ -1,6 +1,6 @@
1
1
  import { IntegrationId } from './communication.public-types';
2
2
  /** List of all integration types supported by Squid. */
3
- export declare const INTEGRATION_TYPES: readonly ["active_directory", "ai_agents", "ai_chatbot", "algolia", "alloydb", "api", "auth0", "bedrock", "azure_blob", "azure_cosmosdb", "azure_postgresql", "azure_sql", "bigquery", "bitbucket", "built_in_azure_blob", "built_in_db", "built_in_gcs", "built_in_queue", "built_in_s3", "cassandra", "clickhouse", "cloudsql", "cockroach", "cognito", "connected_knowledgebases", "confluence", "confluent", "datadog", "db2", "descope", "documentdb", "azure-entra-external-id", "azure-entra-id", "dynamodb", "elasticsearch", "firebase_auth", "firestore", "gcs", "generic_site_ingester", "github", "google_calendar", "google_docs", "google_drive", "graphql", "hubspot", "jira", "jira_jsm", "jwt_hmac", "jwt_rsa", "kafka", "keycloak", "linear", "mariadb", "monday", "mongo", "mssql", "databricks", "mysql", "newrelic", "okta", "onedrive", "outlook", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce", "salesforce_db", "sap_hana", "sentry", "snowflake", "spanner", "xata", "zendesk", "servicenow_csm", "freshdesk", "mail", "slack", "twilio", "elevenlabs", "openai_voice", "mcp", "a2a", "legend", "teams", "openai_compatible", "openai_compatible_embedding", "bedrock_embedding", "sharepoint", "vertex"];
3
+ export declare const INTEGRATION_TYPES: readonly ["active_directory", "ai_agents", "ai_chatbot", "algolia", "alloydb", "api", "auth0", "bedrock", "azure_blob", "azure_cosmosdb", "azure_postgresql", "azure_sql", "bigquery", "bitbucket", "built_in_azure_blob", "built_in_db", "built_in_gcs", "built_in_queue", "built_in_s3", "cassandra", "clickhouse", "cloudsql", "cockroach", "cognito", "connected_knowledgebases", "confluence", "confluent", "datadog", "db2", "descope", "documentdb", "azure-entra-external-id", "azure-entra-id", "dynamodb", "elasticsearch", "firebase_auth", "firestore", "gcs", "generic_site_ingester", "github", "google_calendar", "google_docs", "google_drive", "graphql", "hubspot", "jira", "jira_jsm", "jwt_hmac", "jwt_rsa", "kafka", "keycloak", "linear", "mariadb", "monday", "mongo", "mssql", "databricks", "databricks_genie", "mysql", "newrelic", "okta", "onedrive", "outlook", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce", "salesforce_db", "sap_hana", "sentry", "snowflake", "spanner", "xata", "zendesk", "servicenow_csm", "freshdesk", "mail", "slack", "twilio", "elevenlabs", "openai_voice", "mcp", "a2a", "legend", "teams", "openai_compatible", "openai_compatible_embedding", "bedrock_embedding", "sharepoint", "vertex"];
4
4
  /**
5
5
  * @category Database
6
6
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@squidcloud/twilio-client",
3
- "version": "1.0.506",
3
+ "version": "1.0.507",
4
4
  "description": "Squid Twilio Client",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/connectors/twilio/twilio-client/src/index.d.ts",
@@ -17,7 +17,7 @@
17
17
  "author": "",
18
18
  "license": "ISC",
19
19
  "dependencies": {
20
- "@squidcloud/client": "^1.0.506"
20
+ "@squidcloud/client": "^1.0.507"
21
21
  },
22
22
  "engines": {
23
23
  "node": ">=20.0.0"