@squidcloud/client 1.0.424 → 1.0.425

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';
@@ -560,17 +560,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 +889,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

@@ -77,6 +77,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 +113,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

@@ -4,13 +4,13 @@ export declare const INTEGRATION_TYPES: readonly ["active_directory", "ai_agents
 /**
  * @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/internal-common/src/types/ai-agent.types.d.ts

@@ -1,5 +1,5 @@
 import { AgentContextRequest, AiAgent, AiAgentContext, AiAnnotation, AiAudioCreateSpeechOptions, AiChatMessage, AiChatOptions, AiGenerateImageOptions, AllAiAgentChatOptions, ApplicationAiSettings } from '../public-types/ai-agent.public-types';
-import { AiChatModelName, AiEmbeddingsModelName, AiProviderType } from '../public-types/ai-common.public-types';
+import { AiProviderType } from '../public-types/ai-common.public-types';
 import { AiContextMetadata, AiContextMetadataFilter } from '../public-types/ai-knowledge-base.public-types';
 import { AiAgentId, AiKnowledgeBaseId, AppId, ClientRequestId } from '../public-types/communication.public-types';
 import { JobId } from '../public-types/job.public-types';
@@ -11,10 +11,6 @@ export type AiModelSpec = {
     /** Total context window size: input (aka prompt) + output (aka completion) tokens combined. */
     contextWindowTokens: number;
 };
-/** Map of AI model details by model name. */
-export declare const AI_VENDOR_MODEL_SPECS: Record<AiChatModelName, AiModelSpec>;
-/** Map of embedding AI model specs by model name. */
-export declare const AI_VENDOR_EMBEDDING_MODEL_SPECS: Record<AiEmbeddingsModelName, AiModelSpec>;
 export interface AiChatRequest {
     agentId: AiAgentId;
     clientRequestId: ClientRequestId;

package/dist/internal-common/src/types/observability.types.d.ts

@@ -51,6 +51,29 @@ export interface AuditLogEvent {
     };
     tags: Record<string, string>;
 }
+/** Agent audit log entry - one per agent invocation */
+export interface AgentAuditLogEvent {
+    appId: AppId;
+    agentId: string;
+    jobId: string;
+    prompt: string;
+    tags: Record<string, string>;
+    createdAt: Date;
+}
+export type AgentAuditLogUpdateType = 'statusUpdate' | 'response';
+/** Agent audit log update entry - status updates and responses for agent invocations */
+export interface AgentAuditLogUpdateEvent {
+    appId: AppId;
+    agentId: string;
+    jobId: string;
+    statusUpdateId: string;
+    title: string;
+    parentStatusUpdateId?: string;
+    tags: Record<string, string>;
+    body: string;
+    type: AgentAuditLogUpdateType;
+    createdAt: Date;
+}
 /** Tag for metric events. Value: '0' - not an error, '1' - is an error. */
 export declare const O11Y_TAG_IS_ERROR = "isError";
 /** Tag for log events. Metrics have an explicit appId field. */

package/dist/internal-common/src/types/url-shortener.types.d.ts

@@ -9,6 +9,8 @@ export interface ShortUrlRequest {
     appId: AppId;
     /** 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.
@@ -20,6 +22,8 @@ export interface ShortUrlBulkRequest {
     appId: AppId;
     /** 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 delete a shortened URL.

package/dist/internal-common/src/utils/file-utils.d.ts

@@ -0,0 +1,2 @@
+/** Gets file extension from filename. */
+export declare function getFileExtension(filename: string): string | undefined;

package/dist/internal-common/src/utils/object.d.ts

@@ -56,3 +56,31 @@ export declare function getSortedEntries<T>(record: Record<string, T>): Array<[s
 /** Removes top level fields which are empty objects. May be used for value formatting. */
 export declare function removeEmptyTopLevelRecords<T extends object>(record: T): Partial<T>;
 export declare function removeUndefinedValues<V>(tags: Record<string, V | undefined>): Record<string, V>;
+export declare function extractKey(line: string | undefined): string | null;
+/** Represents a line in a diff output */
+export interface DiffLine {
+    lineNumber: number;
+    text: string;
+    type: 'unchanged' | 'added' | 'removed' | 'changed';
+}
+/** Result of computing a line-by-line diff between two objects */
+export interface DiffResult {
+    leftLines: Array<DiffLine>;
+    rightLines: Array<DiffLine>;
+    hasChanges: boolean;
+}
+/**
+ * Computes a line-by-line diff between two objects.
+ * Objects are serialized to JSON with sorted keys for consistent comparison.
+ * @param before The previous/left object (can be undefined for new objects)
+ * @param after The current/right object
+ * @returns DiffResult with left and right lines and whether there are changes
+ */
+export declare function computeObjectDiff(before: unknown, after: unknown): DiffResult;
+/**
+ * Formats an object as diff lines (all unchanged).
+ * Useful for displaying a single object without comparison.
+ * @param obj The object to format
+ * @returns Array of DiffLine with all lines marked as unchanged
+ */
+export declare function formatObjectAsLines(obj: unknown): Array<DiffLine>;

package/dist/internal-common/src/utils/serialization.d.ts

@@ -1,3 +1,4 @@
+export declare function sortKeys(json: unknown): any;
 export declare function normalizeJsonAsString(json: unknown): string;
 export declare function serializeObj(obj: unknown): string;
 export declare function deserializeObj<T = any>(str: string): T;

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.425";

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.425",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

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/types/ai-assistant.types.d.ts

@@ -1 +0,0 @@
-export {};