@squidcloud/client 1.0.424 → 1.0.426

package/dist/internal-common/src/public-types/ai-agent-integrations.public-types.d.ts

@@ -12,6 +12,8 @@ export interface AiAgentDatabaseIntegrationOptions {
      * When this list is not provided (i.e., it is `undefined`) or is empty, the AI agent has access to all collections.
      */
     collectionsToUse?: string[];
+    /** If true, disables the code interpreter when analyzing query results. Default: false. */
+    disableCodeInterpreter?: boolean;
     /** If true, provides more detailed status updates during AI query execution. Default: false. */
     verboseStatusUpdates?: boolean;
     /** If provided, this agent will be used to generate the query. */

package/dist/internal-common/src/public-types/ai-agent.public-types.d.ts

@@ -1,5 +1,5 @@
 import { JSONSchema } from 'json-schema-typed';
-import { AiAudioCreateSpeechModelName, AiAudioTranscriptionModelName, AiChatModelName, AiEmbeddingsModelName, AiImageModelName, AiProviderType, AiRerankProvider, AnthropicChatModelName, GeminiChatModelName, GrokChatModelName, OpenAiAudioCreateSpeechModelName, OpenAiAudioTranscriptionModelName, OpenAiChatModelName, OpenAiCreateSpeechFormat } from './ai-common.public-types';
+import { AiAudioCreateSpeechModelName, AiAudioTranscriptionModelName, AiChatModelName, AiImageModelName, AiProviderType, AiRerankProvider, AnthropicChatModelName, GeminiChatModelName, GrokChatModelName, OpenAiAudioCreateSpeechModelName, OpenAiAudioTranscriptionModelName, OpenAiChatModelName, OpenAiCreateSpeechFormat } from './ai-common.public-types';
 import { AiContextMetadata, AiContextMetadataFilter, AiKnowledgeBaseContextType, AiRagType } from './ai-knowledge-base.public-types';
 import { AiFunctionId, AiFunctionIdWithContext, UserAiChatModelName } from './backend.public-types';
 import { AiAgentId, AiContextId, AiKnowledgeBaseId, AppId, IntegrationId } from './communication.public-types';
@@ -457,6 +457,12 @@ export interface BaseAiChatOptions {
      * Note: Only supported by OpenAI and Gemini models. Ignored for other providers.
      */
     useCodeInterpreter?: 'none' | 'llm';
+    /**
+     * File IDs to include in the chat context.
+     * These are IDs returned from the AI provider's Files API after uploading files.
+     * Files are attached to the conversation and can be read/analyzed by the AI.
+     */
+    fileIds?: string[];
 }
 /**
  * Chat options specific to Gemini models, extending base options.
@@ -560,17 +566,14 @@ export interface AiAgent<T extends AiChatModelName | undefined = undefined> {
     auditLog?: boolean;
     /** The default chat options for the agent, overridable by the user during use. */
     options: AiChatOptions<T>;
-    /** The embedding model name used by the agent. */
-    embeddingModelName: AiEmbeddingsModelName;
     /** Optional api key used specifically for operations on this agent */
     apiKey?: string;
 }
 /**
  * @category AI
  */
-export type UpsertAgentRequest = Omit<AiAgent, 'createdAt' | 'updatedAt' | 'options' | 'embeddingModelName'> & {
+export type UpsertAgentRequest = Omit<AiAgent, 'createdAt' | 'updatedAt' | 'options'> & {
     options?: AiChatOptions;
-    embeddingModelName?: AiEmbeddingsModelName;
 };
 /**
  * A status message from an AI agent operation.
@@ -892,4 +895,79 @@ export interface AiGenerateImageRequest {
     /** Options for image generation */
     options?: AiGenerateImageOptions;
 }
+/**
+ * Revision action types for agent history tracking.
+ * @category AI
+ */
+export type AiAgentRevisionAction = 'created' | 'updated' | 'deleted';
+/**
+ * Represents a single agent revision entry.
+ * @category AI
+ */
+export interface AiAgentRevision {
+    /** The ID of the agent this revision belongs to. */
+    agentId: AiAgentId;
+    /** The revision number, incremented for each change to the agent. */
+    revisionNumber: number;
+    /** The action that triggered this revision (created, updated, or deleted). */
+    action: AiAgentRevisionAction;
+    /** Timestamp when this revision was created. */
+    createdAt: Date;
+    /** Snapshot of the agent data at the time of the revision. */
+    agentSnapshot: AiAgent;
+}
+/**
+ * Request to list all revisions for an agent.
+ * @category AI
+ */
+export interface ListAgentRevisionsRequest {
+    /** The ID of the agent to list revisions for. */
+    agentId: AiAgentId;
+}
+/**
+ * Response containing the list of agent revisions.
+ * @category AI
+ */
+export interface ListAgentRevisionsResponse {
+    /** The list of revisions for the agent, sorted by revision number descending. */
+    revisions: Array<AiAgentRevision>;
+}
+/**
+ * Request to get a specific agent revision.
+ * @category AI
+ */
+export interface GetAgentRevisionRequest {
+    /** The ID of the agent to get the revision for. */
+    agentId: AiAgentId;
+    /** The revision number to retrieve. */
+    revisionNumber: number;
+}
+/**
+ * Response containing a specific agent revision.
+ * @category AI
+ */
+export interface GetAgentRevisionResponse {
+    /** The requested revision, or undefined if not found. */
+    revision: AiAgentRevision | undefined;
+}
+/**
+ * Request to restore an agent to a specific revision.
+ * @category AI
+ */
+export interface RestoreAgentRevisionRequest {
+    /** The ID of the agent to restore. */
+    agentId: AiAgentId;
+    /** The revision number to restore the agent to. */
+    revisionNumber: number;
+}
+/**
+ * Request to delete a specific agent revision.
+ * @category AI
+ */
+export interface DeleteAgentRevisionRequest {
+    /** The ID of the agent whose revision should be deleted. */
+    agentId: AiAgentId;
+    /** The revision number to delete. */
+    revisionNumber: number;
+}
 export {};

package/dist/internal-common/src/public-types/ai-common.public-types.d.ts

@@ -19,37 +19,34 @@ export type AiProviderType = (typeof AI_PROVIDER_TYPES)[number];
  * Type of AI provider that supports file upload operations.
  * Only a subset of AI providers support file management features.
  */
-export type AiFileProviderType = Extract<AiProviderType, 'openai' | 'gemini' | 'anthropic'>;
+export type AiFileProviderType = Extract<AiProviderType, 'openai' | 'gemini' | 'anthropic' | 'grok'>;
 /**
+ * Public OpenAI chat model names (active models only).
  * @category AI
  */
-export declare const OPENAI_CHAT_MODEL_NAMES: readonly ["o1", "o3", "o3-mini", "o4-mini", "gpt-5", "gpt-5-mini", "gpt-5-nano", "gpt-5.1", "gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano", "gpt-4o", "gpt-4o-mini"];
+export declare const OPENAI_CHAT_MODEL_NAMES: readonly ["gpt-5-mini", "gpt-5-nano", "gpt-5.2", "gpt-5.2-pro"];
 /**
+ * Public Gemini chat model names (active models only).
  * @category AI
  */
-export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite"];
+export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-3-pro", "gemini-3-flash", "gemini-2.5-flash-lite"];
 /**
- * Notes:
- * - 'grok-3-mini' model os ~10x less expensive than 'grok-3'.
- * - '*-fast' models are ~2x more expensive than non-fast variants and only marginally faster.
- * - 'grok-4' cost is comparable to 'grok-3-fast'.
- *
+ * Public Grok chat model names (active models only).
  * @category AI
  */
-export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-3", "grok-3-fast", "grok-3-mini", "grok-3-mini-fast", "grok-4", "grok-4-fast-reasoning", "grok-4-fast-non-reasoning", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
+export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-4", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
 /**
+ * Public Anthropic chat model names (active models only).
  * @category AI
  */
-export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-3-7-sonnet-latest", "claude-haiku-4-5-20251001", "claude-opus-4-20250514", "claude-opus-4-1-20250805", "claude-opus-4-5-20251101", "claude-sonnet-4-20250514", "claude-sonnet-4-5-20250929"];
+export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-haiku-4-5-20251001", "claude-opus-4-5-20251101", "claude-sonnet-4-5-20250929"];
 /**
  * The supported AI model names.
  * @category AI
  */
-export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["o1", "o3", "o3-mini", "o4-mini", "gpt-5", "gpt-5-mini", "gpt-5-nano", "gpt-5.1", "gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano", "gpt-4o", "gpt-4o-mini", "claude-3-7-sonnet-latest", "claude-haiku-4-5-20251001", "claude-opus-4-20250514", "claude-opus-4-1-20250805", "claude-opus-4-5-20251101", "claude-sonnet-4-20250514", "claude-sonnet-4-5-20250929", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-3", "grok-3-fast", "grok-3-mini", "grok-3-mini-fast", "grok-4", "grok-4-fast-reasoning", "grok-4-fast-non-reasoning", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
-/**
- * Check if the given model name is a global AI chat model name.
- */
-export declare function isVendorAiChatModelName(modelName: string): modelName is (typeof VENDOR_AI_CHAT_MODEL_NAMES)[number];
+export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5-mini", "gpt-5-nano", "gpt-5.2", "gpt-5.2-pro", "claude-haiku-4-5-20251001", "claude-opus-4-5-20251101", "claude-sonnet-4-5-20250929", "gemini-3-pro", "gemini-3-flash", "gemini-2.5-flash-lite", "grok-4", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
+/** Checks if the given model name is a global AI chat model name.  */
+export declare function isVendorAiChatModelName(modelName: unknown): modelName is VendorAiChatModelName;
 /**
  * @category AI
  */

package/dist/internal-common/src/public-types/ai-query.public-types.d.ts

@@ -1,22 +1,8 @@
 import { AiChatOptions, AiSessionContext } from './ai-agent.public-types';
 import { ApiOptions } from './api-client.public-types';
 import { AiAgentId, IntegrationId } from './communication.public-types';
-/**
- * Request to execute an AI query using a specific integration.
- * Supports additional query execution options.
- * @category AI
- */
-export interface AiQueryRequest {
-    /** ID of the integration to execute the AI query. */
-    integrationId: IntegrationId;
-    /** User-provided prompt for the AI query. */
-    prompt: string;
-    /** Additional options for query execution. */
-    options?: AiQueryOptions;
-}
 /**
  * Options for configuring AI query execution.
- * Includes instructions, model overrides, and additional execution settings.
  * @category AI
  */
 export interface AiQueryOptions {
@@ -38,6 +24,19 @@ export interface AiQueryOptions {
     /** Session information for the AI query execution. */
     sessionContext?: AiSessionContext;
 }
+/**
+ * Request to execute an AI query using a specific integration.
+ * Supports additional query execution options.
+ * @category AI
+ */
+export interface AiQueryRequest {
+    /** ID of the integration to execute the AI query. */
+    integrationId: IntegrationId;
+    /** User-provided prompt for the AI query. */
+    prompt: string;
+    /** Additional options for query execution. */
+    options?: AiQueryOptions;
+}
 /**
  * Options for the collection selection stage.
  *
@@ -77,6 +76,12 @@ export interface AiQueryGenerateQueryOptions {
      * If provided, the AI Query process will use this agent to generate a query.
      */
     agentId?: AiAgentId;
+    /**
+     * When enabled, allows the AI to ask for clarification instead of attempting to generate
+     * a query when the request is ambiguous, too complex, or impossible to answer with the
+     * available schema. Default: false.
+     */
+    allowClarification?: boolean;
 }
 /** Options for the query result analysis. */
 export interface AiQueryAnalyzeResultsOptions {
@@ -107,6 +112,14 @@ export interface AiQueryResponse {
     rawResultsUrl?: string;
     /** Indicates whether the query execution was successful. */
     success: boolean;
+    /** Indicates whether code interpreter was used to analyze the results. */
+    usedCodeInterpreter?: boolean;
+    /**
+     * When the AI needs clarification to generate a query, this field contains the clarification question.
+     * Only populated when `generateQueryOptions.allowClarification` is enabled and the AI determines
+     * it cannot generate a valid query without more information.
+     */
+    clarificationQuestion?: string;
 }
 /**
  * Details of an executed query, including the query text and result type.

package/dist/internal-common/src/public-types/integration.public-types.d.ts

@@ -1,16 +1,16 @@
 import { IntegrationId } from './communication.public-types';
 /** List of all integration types supported by Squid. */
-export declare const INTEGRATION_TYPES: readonly ["active_directory", "ai_agents", "ai_chatbot", "algolia", "alloydb", "api", "auth0", "azure_cosmosdb", "azure_postgresql", "azure_sql", "bigquery", "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", "dynamodb", "elasticsearch", "firebase_auth", "firestore", "gcs", "google_calendar", "google_docs", "google_drive", "graphql", "hubspot", "jira", "jwt_hmac", "jwt_rsa", "kafka", "keycloak", "linear", "mariadb", "monday", "mongo", "mssql", "databricks", "mysql", "newrelic", "okta", "onedrive", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce_crm", "sap_hana", "sentry", "servicenow", "snowflake", "spanner", "xata", "zendesk", "mail", "slack", "mcp", "a2a", "legend", "teams", "openai_compatible"];
+export declare const INTEGRATION_TYPES: readonly ["active_directory", "ai_agents", "ai_chatbot", "algolia", "alloydb", "api", "auth0", "azure_cosmosdb", "azure_postgresql", "azure_sql", "bigquery", "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", "dynamodb", "elasticsearch", "firebase_auth", "firestore", "gcs", "github", "google_calendar", "google_docs", "google_drive", "graphql", "hubspot", "jira", "jwt_hmac", "jwt_rsa", "kafka", "keycloak", "linear", "mariadb", "monday", "mongo", "mssql", "databricks", "mysql", "newrelic", "okta", "onedrive", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce_crm", "sap_hana", "sentry", "servicenow", "snowflake", "spanner", "xata", "zendesk", "mail", "slack", "mcp", "a2a", "legend", "teams", "openai_compatible"];
 /**
  * @category Database
  */
-export declare const DATA_INTEGRATION_TYPES: readonly ["bigquery", "built_in_db", "clickhouse", "cockroach", "mongo", "mssql", "databricks", "mysql", "oracledb", "postgres", "sap_hana", "snowflake", "elasticsearch", "legend"];
+export declare const DATA_INTEGRATION_TYPES: readonly ["bigquery", "built_in_db", "clickhouse", "cockroach", "dynamodb", "mongo", "mssql", "databricks", "mysql", "oracledb", "postgres", "sap_hana", "snowflake", "elasticsearch", "legend"];
 /**
  * @category Auth
  */
 export declare const AUTH_INTEGRATION_TYPES: readonly ["auth0", "jwt_rsa", "jwt_hmac", "cognito", "okta", "keycloak", "descope", "firebase_auth"];
 /** Supported integration types for GraphQL-based services. */
-export declare const GRAPHQL_INTEGRATION_TYPES: readonly ["graphql", "linear"];
+export declare const GRAPHQL_INTEGRATION_TYPES: readonly ["graphql"];
 /** Supported integration types for HTTP-based services. */
 export declare const HTTP_INTEGRATION_TYPES: readonly ["api"];
 /** Represents a supported integration type identifier, such as 'postgres', 'auth0', or 's3'. */

package/dist/internal-common/src/public-types/web.public-types.d.ts

@@ -37,6 +37,28 @@ export interface WebGetUrlContentResponse {
     /** The content fetched from the URL in Markdown format. */
     markdownText: string;
 }
+/**
+ * Options for creating a shortened URL.
+ */
+export interface CreateShortUrlOptions {
+    /** The URL to shorten. It must be a valid URL and should include the protocol (start with http:// or https://). */
+    url: string;
+    /** Seconds to live for the shortened URL. If set to 0, the URL will never expire. Defaults to 1 day. */
+    secondsToLive?: number;
+    /** Optional file extension to include in the shortened URL ID (e.g., 'pdf', 'html'). The extension becomes part of the ID, so 'abc123.pdf' and 'abc123.jpg' are distinct URLs. */
+    fileExtension?: string;
+}
+/**
+ * Options for creating multiple shortened URLs.
+ */
+export interface CreateShortUrlsOptions {
+    /** The URLs to shorten. They must be valid URLs and should include the protocol (start with http:// or https://). */
+    urls: string[];
+    /** Seconds to live for all shortened URLs. If set to 0, the URLs will never expire. Defaults to 1 day. */
+    secondsToLive?: number;
+    /** Optional file extension to include in all shortened URL IDs (e.g., 'pdf', 'html'). The extension becomes part of each ID, so 'abc123.pdf' and 'abc123.jpg' are distinct URLs. */
+    fileExtension?: string;
+}
 /**
  * Request to create a shortened URL.
  */
@@ -45,6 +67,8 @@ export interface WebShortUrlRequest {
     url: string;
     /** Seconds to live for the shortened URL. If set to 0, the URL will never expire. Defaults to 1 day. */
     secondsToLive?: number;
+    /** Optional file extension to include in the shortened URL ID (e.g., 'pdf', 'html'). The extension becomes part of the ID, so 'abc123.pdf' and 'abc123.jpg' are distinct URLs. */
+    fileExtension?: string;
 }
 /**
  * Request to create shortened URLs.
@@ -54,6 +78,8 @@ export interface WebShortUrlBulkRequest {
     urls: string[];
     /** Seconds to live for all shortened URLs. If set to 0, the URLs will never expire. Defaults to 1 day. */
     secondsToLive?: number;
+    /** Optional file extension to include in all shortened URL IDs (e.g., 'pdf', 'html'). The extension becomes part of each ID, so 'abc123.pdf' and 'abc123.jpg' are distinct URLs. */
+    fileExtension?: string;
 }
 /**
  * Response with the newly created shortened URL.

package/dist/typescript-client/src/agent/ai-agent-client-reference.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { AiAgent, AiChatMessage, AiChatModelSelection, AiConnectedAgentMetadata, AiStatusMessage, AiTranscribeAndAskResponse, AllAiAgentChatOptions, GuardrailsOptions, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.public-types';
+import { AiAgent, AiChatMessage, AiChatModelSelection, AiConnectedAgentMetadata, AiStatusMessage, AiTranscribeAndAskResponse, AllAiAgentChatOptions, GuardrailsOptions, ListAgentRevisionsResponse, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.public-types';
 import { AiChatModelName } from '../../../internal-common/src/public-types/ai-common.public-types';
 import { JobId } from '../../../internal-common/src/public-types/job.public-types';
 import { Paths } from '../../../internal-common/src/public-types/typescript.public-types';
@@ -72,6 +72,22 @@ export declare class AiAgentReference {
      * @returns the api key if one exists
      */
     getApiKey(): Promise<string | undefined>;
+    /**
+     * Lists all revisions (history) of the agent.
+     * @returns the list of revisions sorted by newest first
+     */
+    listRevisions(): Promise<ListAgentRevisionsResponse>;
+    /**
+     * Restores the agent to a previous revision.
+     * This will create a new revision with the current state before restoring.
+     * @param revisionNumber The revision number to restore to
+     */
+    restoreRevision(revisionNumber: number): Promise<void>;
+    /**
+     * Deletes a specific revision.
+     * @param revisionNumber The revision number to delete
+     */
+    deleteRevision(revisionNumber: number): Promise<void>;
     /**
      * Sends a prompt to the agent and receives streamed text responses.
      * @param prompt The text prompt to send to the agent.

package/dist/typescript-client/src/ai-client.d.ts

@@ -1,7 +1,6 @@
 import { AiQueryOptions, AiQueryResponse, ExecuteAiApiResponse } from '../../internal-common/src/public-types/ai-query.public-types';
 import { AiAgentClientOptions } from './agent/ai-agent-client';
 import { AiAgentReference } from './agent/ai-agent-client-reference';
-import { AiAssistantClient } from './ai-assistant-client';
 import { AiAudioClient } from './ai-audio-client';
 import { AiFilesClient } from './ai-files-client';
 import { AiImageClient } from './ai-image-client';
@@ -19,7 +18,6 @@ export declare class AiClient {
     private readonly rpcManager;
     private readonly jobClient;
     private readonly backendFunctionManager;
-    private readonly aiAssistantClient;
     private aiAgentClient?;
     private aiKnowledgeBaseClient?;
     /**
@@ -39,11 +37,6 @@ export declare class AiClient {
      * Lists all available AI agents.
      */
     listKnowledgeBases(): Promise<Array<AiKnowledgeBase>>;
-    /**
-     * Retrieves the AI assistant client.
-     * @returns An instance of AiAssistantClient.
-     */
-    assistant(): AiAssistantClient;
     /**
      * Retrieves an AI image client.
      */

package/dist/typescript-client/src/index.d.ts

@@ -2,7 +2,6 @@ export * from './admin-client';
 export * from './agent/ai-agent-client';
 export * from './agent/ai-agent-client-reference';
 export * from './agent/ai-agent-client.types';
-export * from './ai-assistant-client';
 export * from './ai-audio-client';
 export * from './ai-client';
 export * from './ai-files-client';
@@ -30,7 +29,6 @@ export * from './execute-function-options';
 export * from './external-auth-client';
 export * from './extraction-client';
 export * from './file-args-transformer';
-export * from './file-utils';
 export * from './integration-client';
 export * from './job-client';
 export * from './mutation/mutation-sender';

package/dist/typescript-client/src/public-types.d.ts

@@ -1,6 +1,5 @@
 export * from '../../internal-common/src/public-types/ai-agent-integrations.public-types';
 export * from '../../internal-common/src/public-types/ai-agent.public-types';
-export * from '../../internal-common/src/public-types/ai-assistant.public-types';
 export * from '../../internal-common/src/public-types/ai-common.public-types';
 export * from '../../internal-common/src/public-types/ai-knowledge-base.public-types';
 export * from '../../internal-common/src/public-types/ai-matchmaking.public-types';

package/dist/typescript-client/src/version.d.ts

@@ -2,4 +2,4 @@
  * The current version of the SquidCloud client package.
  * @category Platform
  */
-export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.424";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.426";

package/dist/typescript-client/src/web-client.d.ts

@@ -1,4 +1,4 @@
-import { WebAiSearchResponse, WebShortUrlBulkResponse, WebShortUrlResponse } from '../../internal-common/src/public-types/web.public-types';
+import { CreateShortUrlOptions, CreateShortUrlsOptions, WebAiSearchResponse, WebShortUrlBulkResponse, WebShortUrlResponse } from '../../internal-common/src/public-types/web.public-types';
 /**
  * WebClient provides methods to interact with web-related functionalities.
  * @category Platform
@@ -9,6 +9,8 @@ export declare class WebClient {
     private readonly appId;
     private readonly apiKey;
     private readonly consoleRegion;
+    /** Headers for short URL API requests. Only use after asserting apiKey is defined. */
+    private get shortUrlHeaders();
     /**
      * Search the web using AI. Returns a response containing Markdown text and cited URLs.
      * @param query The keywords or query string to search for.
@@ -22,28 +24,21 @@ export declare class WebClient {
     /**
      * Creates a shortened URL for the given URL.
      *
-     * Defaults to a 1 day expiration if no expiry is provided via the `secondsToLive` field.
+     * Defaults to a 1-day expiration if no expiry is provided via the `secondsToLive` field.
      * If `secondsToLive` is set to 0, the URL will never expire.
      *
-     * @param url The URL to shorten. It must be a valid URL and should include the protocol (start with http:// or
-     *   https://).
-     * @param secondsToLive Seconds to live for the shortened URL. If set to 0, the URL will never expire. Defaults to 30
-     *   days.
+     * @param urlOrOptions - Either a URL string or an options object with url and all available options.
      */
-    createShortUrl(url: string, secondsToLive?: number): Promise<WebShortUrlResponse>;
+    createShortUrl(urlOrOptions: string | CreateShortUrlOptions): Promise<WebShortUrlResponse>;
     /**
      * Creates shortened URLs for the given URLs.
      *
-     * Defaults to a 1 day expiration if no expiry is provided via the `secondsToLive` field.
+     * Defaults to a 1-day expiration if no expiry is provided via the `secondsToLive` field.
      * If `secondsToLive` is set to 0, the URL will never expire.
      *
-     * The parameter arrays should be of the same length and in the same order
-     *
-     * @param urls The URLs to shorten. It must be a valid URL and should include the protocol (start with http:// or
-     *   https://).
-     * @param secondsToLive Seconds to live for each shortened URL. If set to 0, the URL will never expire.
+     * @param urlsOrOptions - Either an array of URL strings or an options object and all available options.
      */
-    createShortUrls(urls: string[], secondsToLive?: number): Promise<WebShortUrlBulkResponse>;
+    createShortUrls(urlsOrOptions: string[] | CreateShortUrlsOptions): Promise<WebShortUrlBulkResponse>;
     /**
      * Deletes a shortened URL by its ID.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.424",
+  "version": "1.0.426",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/dist/internal-common/src/metric-name.d.ts

@@ -1,9 +0,0 @@
-/**
- * Names of the Squid metrics.
- * Should be in sync with MetricName.kt.
- * See MetricName.kt for documentation on each value.
- */
-export declare const ALL_SQUID_METRIC_NAMES: readonly ["squid_functionExecution_count", "squid_functionExecution_time", "squid_aiChatbotContext_size", "squid_aiChatbotChatInputTokens_count", "squid_aiChatbotChatOutputTokens_count", "squid_aiChatbotChatOutcome_count", "squid_aiImageGeneration_count", "squid_aiImageGeneration_time", "squid_aiRemoveBackground_count", "squid_aiRemoveBackground_time", "squid_aiAudioTranscribe_count", "squid_aiAudioTranscribe_time", "squid_aiAudioCreateSpeech_count", "squid_aiAudioCreateSpeech_time", "squid_aiIntegrationData_count", "squid_aiIntegrationData_time", "squid_aiIntegrationApi_count", "squid_aiIntegrationApi_time", "squid_apiControllerCall_count", "squid_apiControllerCall_time", "squid_aiContextUpsert_count", "squid_aiContextDelete_count", "squid_codeInitialization_count", "squid_codeInitialization_time", "squid_deleteApiKey_count", "squid_deleteApiKey_time", "squid_deleteSecret_count", "squid_deleteSecret_time", "squid_discoverGraphQLConnectionSchema_count", "squid_discoverGraphQLConnectionSchema_time", "squid_discoverOpenApiSchema_count", "squid_discoverOpenApiSchema_time", "squid_discoverOpenApiSchemaFromFile_count", "squid_discoverOpenApiSchemaFromFile_time", "squid_executeBackendFunction_count", "squid_executeBackendFunction_time", "squid_getAiChatbotProfiles_count", "squid_getAiChatbotProfiles_time", "squid_getAllApiKeys_count", "squid_getAllApiKeys_time", "squid_getAllSecrets_count", "squid_getAllSecrets_time", "squid_getAppApiKey_count", "squid_getAppApiKey_time", "squid_getSecret_count", "squid_getSecret_time", "squid_graphql_count", "squid_graphql_time", "squid_graphqlQuery_count", "squid_graphqlQuery_time", "squid_integrationCount_value", "squid_acquireLock_count", "squid_releaseLock_count", "squid_mutate_count", "squid_mutate_time", "squid_metricQuery_count", "squid_metricQuery_time", "squid_metricReport_count", "squid_metricReport_time", "squid_nativeQuery_count", "squid_nativeQuery_time", "squid_openapi_count", "squid_openapi_time", "squid_produceTopicMessage_count", "squid_produceTopicMessage_time", "squid_query_count", "squid_query_time", "squid_registerQuery_count", "squid_registerQuery_time", "squid_rerankChunks_count", "squid_rerankChunks_time", "squid_schedulerJob_count", "squid_schedulerJob_time", "squid_schema_size", "squid_secrets_entries", "squid_storageDeleteFiles_count", "squid_storageDeleteFiles_time", "squid_storageGetDownloadUrl_count", "squid_storageGetDownloadUrl_time", "squid_storageGetFileMetadata_count", "squid_storageGetFileMetadata_time", "squid_storageListDirectoryContents_count", "squid_storageListDirectoryContents_time", "squid_storageUploadFile_count", "squid_storageUploadFile_time", "squid_subscribeToTopic_count", "squid_subscribeToTopic_time", "squid_testGraphQLConnection_count", "squid_testGraphQLConnection_time", "squid_testAgentProtocolConnection_count", "squid_testAgentProtocolConnection_time", "squid_trigger_count", "squid_trigger_time", "squid_upsertApiKey_count", "squid_upsertApiKey_time", "squid_upsertSecret_count", "squid_upsertSecret_time", "squid_vectorChunks_count", "squid_vectorChunks_time", "squid_webhook_count", "squid_webhook_time"];
-export type MetricName = (typeof ALL_SQUID_METRIC_NAMES)[number];
-/** Common prefix for all Squid metrics. */
-export declare const SQUID_METRIC_NAME_PREFIX = "squid_";

package/dist/internal-common/src/public-types/ai-assistant.public-types.d.ts

@@ -1,31 +0,0 @@
-import { AiReasoningEffort } from './ai-agent.public-types';
-import { OpenAiChatModelName } from './ai-common.public-types';
-import { AiFunctionId } from './backend.public-types';
-/**
- * Response format for AI assistant responses.
- * @category AI
- */
-export type AiAssistantResponseFormat = 'text' | 'json_object';
-/**
- * The type of assistant tool.
- * @category AI
- */
-export type AssistantToolType = 'code_interpreter' | 'file_search';
-/**
- * The options for configuring an AI assistant's behavior and response.
- * @category AI
- */
-export interface QueryAssistantOptions {
-    /** Additional context provided to all AI functions for processing. */
-    agentContext?: Record<string, unknown>;
-    /** Specific context provided per AI function, keyed by function ID. */
-    functionContexts?: Record<AiFunctionId, Record<string, unknown>>;
-    /** The desired format of the AI model's response; defaults to 'text'. */
-    responseFormat?: AiAssistantResponseFormat;
-    /** The OpenAI chat model to use for the assistant, if specified. */
-    model?: OpenAiChatModelName;
-    /** The level of reasoning effort to apply, as defined by OpenAI. */
-    reasoningEffort?: AiReasoningEffort;
-    /** Custom instructions to guide the assistant's behavior, if provided. */
-    instructions?: string;
-}

package/dist/internal-common/src/public-types-backend/api-call.public-context.d.ts

@@ -1,30 +0,0 @@
-import { ApiOptions } from '../public-types/api-client.public-types';
-import { ApiEndpointId, HttpMethod } from '../public-types/api.public-types';
-import { IntegrationId } from '../public-types/communication.public-types';
-/** The headers of an API call. */
-export type ApiHeaders = Record<string, string | number | boolean>;
-/** The context of an API call. */
-export declare class ApiCallContext {
-    readonly integrationId: IntegrationId;
-    readonly endpointId: ApiEndpointId;
-    readonly url: string;
-    readonly method: HttpMethod;
-    readonly body: unknown;
-    readonly options: ApiOptions;
-}
-/**
- * Represents a request to call an API through a specified integration and endpoint.
- * Includes optional method override and additional request options.
- */
-export interface CallApiRequest<BodyType = any> {
-    /** The identifier of the integration through which the API is called. */
-    integrationId: IntegrationId;
-    /** Target API endpoint to invoke. */
-    endpointId: ApiEndpointId;
-    /** Optional request payload. */
-    body?: BodyType;
-    /** Optional HTTP method override. Default is POST. */
-    overrideMethod?: HttpMethod;
-    /** Additional request options. */
-    options: ApiOptions;
-}