@squidcloud/client 1.0.469 → 1.0.471

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

@@ -8,7 +8,7 @@
  *
  * 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_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", "squid_acquireLock_count", "squid_acquireLock_time", "squid_releaseLock_count", "squid_releaseLock_time"];
+export declare const ALL_SQUID_METRIC_NAMES: readonly ["squid_functionExecution_count", "squid_functionExecution_time", "squid_aiChatbotContext_size", "squid_aiChatbotChatInputTokens_count", "squid_aiChatbotChatOutputTokens_count", "squid_aiChatbotChatReasoningTokens_count", "squid_aiChatbotChatCacheReadInputTokens_count", "squid_aiChatbotChatCacheWriteInputTokens_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_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", "squid_acquireLock_count", "squid_acquireLock_time", "squid_releaseLock_count", "squid_releaseLock_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-agent.public-types.d.ts

@@ -1041,9 +1041,22 @@ export interface ListAgentsResponse {
     /** All AI agents defined for the application. */
     agents: Array<AiAgent>;
 }
+/**
+ * Request options for listing the chat models available to an application.
+ * @category AI
+ */
+export interface ListChatModelsRequest {
+    /**
+     * When true, deprecated vendor models (those with `replacedBy`) are included.
+     * Defaults to false (only active models are returned).
+     */
+    includeDeprecated?: boolean;
+}
 /**
  * Response containing the list of chat models available to an application.
  * Includes both Squid-provided vendor models and any custom integration models.
+ * Vendor models carry a human-readable `description`. Deprecated vendor models are
+ * included only when requested via `includeDeprecated` and are marked with `replacedBy`.
  * @category AI
  */
 export interface ListChatModelsResponse {

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

@@ -206,6 +206,15 @@ export type StableDiffusionModelName = (typeof STABLE_DIFFUSION_MODEL_NAMES)[num
  * @category AI
  */
 export type FluxModelName = (typeof FLUX_MODEL_NAMES)[number];
+/**
+ * Where a chat model offered to an app comes from. See {@link ModelIdSpec.source}.
+ * @category AI
+ */
+export declare const AI_MODEL_SOURCES: readonly ["vendor", "connector", "custom"];
+/**
+ * @category AI
+ */
+export type AiModelSource = (typeof AI_MODEL_SOURCES)[number];
 /** Represents an AI model. */
 export interface ModelIdSpec {
     /** The model ID used for API calls. */
@@ -214,6 +223,20 @@ export interface ModelIdSpec {
     integrationId?: string;
     /** Human-readable display name for the model (e.g. "GPT-4o"). */
     displayName?: string;
+    /** Short human-readable description of the model. Undefined for custom integration models. */
+    description?: string;
+    /**
+     * Set only for deprecated models: the active model that calls to this model are routed to.
+     * Undefined for active models.
+     */
+    replacedBy?: AiChatModelName;
+    /**
+     * Where the model comes from. Always set on `listChatModels()` results:
+     * - 'vendor': a Squid-provided model from the vendor model registry.
+     * - 'connector': provided by an integration configured on the app (OpenAI-compatible, Bedrock, Vertex).
+     * - 'custom': a user-added model from the app's bundle (e.g. CLI agent models like Claude Code or Codex).
+     */
+    source?: AiModelSource;
 }
 /**
  * Type guard to check if a model selection is integration-based.

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

@@ -2,6 +2,7 @@ import { AgentContextRequest, AiChatModelSelection, UpsertContextStatusError } f
 import { AiEmbeddingsModelSelection, AiRerankProvider } from './ai-common.public-types';
 import { AiContextId, AiKnowledgeBaseId, AppId } from './communication.public-types';
 import { DocumentExtractionMethod } from './extraction.public-types';
+import { MetadataAndFilter, MetadataFieldFilter, MetadataFilter, MetadataOrFilter, MetadataSimpleFilter, MetadataValue, MetadataValueArray } from './metadata-filter.public-types';
 /**
  * The set of supported vector store backends for a knowledge base. The authoritative backend for a
  * given KB is persisted on its record; reads/writes route through the matching vector provider.
@@ -57,67 +58,37 @@ export interface AiKnowledgeBaseMetadataField {
 export type AiContextMetadata = Record<string, AiContextMetadataValue>;
 /**
  * @category AI
+ * @deprecated Use {@link MetadataValue} from `metadata-filter.public-types` instead.
  */
-export type AiContextMetadataValue = number | string | boolean | undefined;
+export type AiContextMetadataValue = MetadataValue;
 /**
  * @category AI
+ * @deprecated Use {@link MetadataValueArray} from `metadata-filter.public-types` instead.
  */
-export type AiContextMetadataValueArray = AiContextMetadataValue[];
-interface AiContextMetadataEqFilter {
-    $eq: AiContextMetadataValue;
-}
-interface AiContextMetadataNeFilter {
-    $ne: AiContextMetadataValue;
-}
-interface AiContextMetadataGtFilter {
-    $gt: number;
-}
-interface AiContextMetadataGteFilter {
-    $gte: number;
-}
-interface AiContextMetadataLtFilter {
-    $lt: number;
-}
-interface AiContextMetadataLteFilter {
-    $lte: number;
-}
-interface AiContextMetadataInFilter {
-    $in: AiContextMetadataValueArray;
-}
-interface AiContextMetadataNinFilter {
-    $nin: AiContextMetadataValueArray;
-}
-interface AiContextMetadataExistsFilter {
-    $exists: boolean;
-}
+export type AiContextMetadataValueArray = MetadataValueArray;
 /**
  * @category AI
+ * @deprecated Use {@link MetadataSimpleFilter} from `metadata-filter.public-types` instead.
  */
-export type AiContextMetadataSimpleFilter = AiContextMetadataEqFilter | AiContextMetadataNeFilter | AiContextMetadataGtFilter | AiContextMetadataGteFilter | AiContextMetadataLtFilter | AiContextMetadataLteFilter | AiContextMetadataInFilter | AiContextMetadataNinFilter | AiContextMetadataExistsFilter;
+export type AiContextMetadataSimpleFilter = MetadataSimpleFilter;
 /**
  * A filter for AI context metadata based on field-specific conditions or values.
  * @category AI
+ * @deprecated Use {@link MetadataFieldFilter} from `metadata-filter.public-types` instead.
  */
-export interface AiContextMetadataFieldFilter {
-    /** A record where keys are field names and values are either simple filters or direct metadata values. */
-    [field: string]: AiContextMetadataSimpleFilter | AiContextMetadataValue;
-}
+export type AiContextMetadataFieldFilter = MetadataFieldFilter;
 /**
  * A filter combining multiple AI context metadata filters with a logical AND operation.
  * @category AI
+ * @deprecated Use {@link MetadataAndFilter} from `metadata-filter.public-types` instead.
  */
-export interface AiContextMetadataAndFilter {
-    /** An array of filters that must all be true for the condition to pass. */
-    $and: AiContextMetadataFilter[];
-}
+export type AiContextMetadataAndFilter = MetadataAndFilter;
 /**
  * A filter combining multiple AI context metadata filters with a logical OR operation.
  * @category AI
+ * @deprecated Use {@link MetadataOrFilter} from `metadata-filter.public-types` instead.
  */
-export interface AiContextMetadataOrFilter {
-    /** An array of filters where at least one must be true for the condition to pass. */
-    $or: AiContextMetadataFilter[];
-}
+export type AiContextMetadataOrFilter = MetadataOrFilter;
 /**
  * The options for the AI knowledgebase search method.
  * @category AI
@@ -167,8 +138,9 @@ export interface AiHybridSearchWeights {
 }
 /**
  * @category AI
+ * @deprecated Use {@link MetadataFilter} from `metadata-filter.public-types` instead.
  */
-export type AiContextMetadataFilter = AiContextMetadataFieldFilter | AiContextMetadataAndFilter | AiContextMetadataOrFilter;
+export type AiContextMetadataFilter = MetadataFilter;
 /**
  * Represents an AI knowledge base's context entry with metadata and content.
  * @category AI

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

@@ -35,6 +35,15 @@ export interface ExtractDataFromDocumentOptions {
      * the content. Only consulted by extractors that handle text input.
      */
     textFormat?: 'auto' | 'markdown' | 'html' | 'plain';
+    /**
+     * Whether to read document-level properties (title/author/dates) from the source container and
+     * return them as `documentMetadata`. Off by default: container parsing has a real per-file cost
+     * (zip/PDF re-parse), so callers opt in only when the owning knowledge base declares metadata fields.
+     *
+     * Honored only by file-based extraction (which owns the original buffer for every format);
+     * URL-based extraction ignores it and never returns `documentMetadata`.
+     */
+    collectDocumentMetadata?: boolean;
 }
 /**
  * Request payload for extracting data from a document via URL.
@@ -108,6 +117,11 @@ export interface ExtractDataFromDocumentResponse {
      * Path to the original file in cloud storage, if applicable.
      */
     longTermStoragePath?: string;
+    /**
+     * Document-level metadata extracted from the source container (best-effort). Present only when the
+     * extractor was able to read it.
+     */
+    documentMetadata?: DocumentMetadata;
 }
 /**
  * Create PDF request type.
@@ -186,3 +200,22 @@ export interface CreatePdfResponse {
     /** The generated filename. */
     fileName?: string;
 }
+/**
+ * Document-level properties read from the source container during extraction. Every field is optional
+ * and best-effort: when a container does not expose a property (or parsing fails) the field is simply
+ * absent. Consumed by schema-driven metadata extraction as the deterministic source for matching
+ * knowledge-base `metadataFields` before falling back to LLM extraction.
+ * @category AI
+ */
+export interface DocumentMetadata {
+    /** Document title (e.g. OOXML `dc:title`, PDF `/Title`, front-matter `title`, `<title>`). */
+    docTitle?: string;
+    /** Document author (e.g. OOXML `dc:creator`, PDF `/Author`, front-matter / `<meta author>`). */
+    docAuthor?: string;
+    /** Creation timestamp, ISO 8601. */
+    docCreatedAt?: string;
+    /** Last-modified timestamp, ISO 8601. */
+    docModifiedAt?: string;
+    /** Source document type: `pdf` | `docx` | `pptx` | `xlsx` | `md` | `html` | `txt`. */
+    docType?: string;
+}

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

@@ -0,0 +1,85 @@
+/**
+ * Generic metadata filter types used across the platform.
+ *
+ * These types define a MongoDB-style filter syntax for filtering records by metadata
+ * fields. They support field-level operators (`$eq`, `$ne`, `$gt`, `$gte`, `$lt`,
+ * `$lte`, `$in`, `$nin`, `$exists`) and boolean combinators (`$and`, `$or`).
+ *
+ * Originally created for AI knowledge base context filtering, these types are now
+ * shared across metrics tag filtering, matchmaking, and other subsystems.
+ */
+/** Primitive metadata value. */
+export type MetadataValue = number | string | boolean | undefined;
+/** Array of metadata values (used by `$in` / `$nin`). */
+export type MetadataValueArray = MetadataValue[];
+interface MetadataEqFilter {
+    $eq: MetadataValue;
+}
+interface MetadataNeFilter {
+    $ne: MetadataValue;
+}
+interface MetadataGtFilter {
+    $gt: number;
+}
+interface MetadataGteFilter {
+    $gte: number;
+}
+interface MetadataLtFilter {
+    $lt: number;
+}
+interface MetadataLteFilter {
+    $lte: number;
+}
+interface MetadataInFilter {
+    $in: MetadataValueArray;
+}
+interface MetadataNinFilter {
+    $nin: MetadataValueArray;
+}
+interface MetadataExistsFilter {
+    $exists: boolean;
+}
+/** A single-field operator: one of `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$exists`. */
+export type MetadataSimpleFilter = MetadataEqFilter | MetadataNeFilter | MetadataGtFilter | MetadataGteFilter | MetadataLtFilter | MetadataLteFilter | MetadataInFilter | MetadataNinFilter | MetadataExistsFilter;
+/**
+ * A filter for metadata based on field-specific conditions or direct values.
+ * @category Metadata
+ */
+export interface MetadataFieldFilter {
+    /** A record where keys are field names and values are either operator objects or direct scalar values. */
+    [field: string]: MetadataSimpleFilter | MetadataValue;
+}
+/**
+ * A filter combining multiple metadata filters with a logical AND operation.
+ * @category Metadata
+ */
+export interface MetadataAndFilter {
+    /** An array of filters that must all be true for the condition to pass. */
+    $and: MetadataFilter[];
+}
+/**
+ * A filter combining multiple metadata filters with a logical OR operation.
+ * @category Metadata
+ */
+export interface MetadataOrFilter {
+    /** An array of filters where at least one must be true for the condition to pass. */
+    $or: MetadataFilter[];
+}
+/**
+ * A composable metadata filter supporting field operators and boolean combinators.
+ *
+ * @example Simple equality
+ * ```ts
+ * { status: 'active' }
+ * ```
+ * @example Operators
+ * ```ts
+ * { age: { $gte: 18 }, role: { $in: ['admin', 'editor'] } }
+ * ```
+ * @example Boolean combinators
+ * ```ts
+ * { $or: [{ status: 'active' }, { role: { $ne: 'guest' } }] }
+ * ```
+ */
+export type MetadataFilter = MetadataFieldFilter | MetadataAndFilter | MetadataOrFilter;
+export {};

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

@@ -1,3 +1,11 @@
+import { MetadataFilter } from './metadata-filter.public-types';
+/**
+ * Tag filter for metric queries. Accepts either a simple key-value record (backward compatible)
+ * or the full {@link MetadataFilter} tree with `$eq`, `$ne`, `$in`, `$nin`, `$exists`,
+ * `$gt`, `$gte`, `$lt`, `$lte`, `$and`, `$or`.
+ * @category Metrics
+ */
+export type MetricTagFilter = Record<string, string> | MetadataFilter;
 /**
  * Name of metrics publicly provided by the system.
  * - Metrics suffixed by '_time' are 'gauge' metrics.
@@ -49,10 +57,22 @@ export interface QueryMetricsRequestCommon {
      */
     fillValue?: number | null;
     /**
-     * Tag filters.
-     * TODO: add operations to exclude tags: !=, !contains...
+     * Tag filters. Supports two formats:
+     * - Simple: `Record<string, string>` — each key-value pair is an exact equality match.
+     * - Advanced: `AiContextMetadataFilter` — the same filter syntax used by AI knowledge base
+     *   metadata, supporting `$eq`, `$ne`, `$in`, `$nin`, `$exists`, `$and`, `$or`, and
+     *   comparison operators (`$gt`, `$gte`, `$lt`, `$lte` — numeric comparisons on string tags).
+     *
+     * @example Simple format
+     * ```ts
+     * tagFilter: { aiModel: 'claude-sonnet-4-5-20250514', isError: '0' }
+     * ```
+     * @example Advanced format
+     * ```ts
+     * tagFilter: { $or: [{ aiModel: { $in: ['claude-sonnet-4-5-20250514', 'gpt-4o'] } }, { isError: { $ne: '0' } }] }
+     * ```
      */
-    tagFilter?: Record<string, string>;
+    tagFilter?: MetricTagFilter;
     /**
      * A mapping of known tag values that must be present in the response groups.
      *

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

@@ -107,6 +107,12 @@ export interface AgentAuditLogUpdateEvent {
     inputUsage?: AiUsageMetric;
     /** Output usage metric (tokens or characters depending on provider). */
     outputUsage?: AiUsageMetric;
+    /** Reasoning tokens consumed (where the provider reports them separately from output tokens). */
+    reasoningTokens?: number;
+    /** Number of input tokens served from the provider's prompt cache (read hits). */
+    cacheReadInputTokens?: number;
+    /** Number of input tokens written into the provider's prompt cache (cache misses that created new entries). */
+    cacheWriteInputTokens?: number;
 }
 /** Tag for metric events. Value: '0' - not an error, '1' - is an error. */
 export declare const O11Y_TAG_IS_ERROR = "isError";
@@ -120,6 +126,7 @@ export declare const O11Y_TAG_AI_PROFILE = "aiProfile";
 /** Tag for AI KnowledgeBase events */
 export declare const O11Y_TAG_AI_KNOWLEDGE_BASE_MODEL = "aiKnowledgeBaseModel";
 export declare const O11Y_TAG_API_KEY_SOURCE = "apiKeySource";
+export declare const O11Y_TAG_AI_JOB_ID = "aiJobId";
 /** Tag for metric and log events. Value: '0' - not a tenant originated, '1' - is a tenant originated. */
 export declare const O11Y_TAG_IS_TENANT_ORIGINATED = "isTenantOriginated";
 /** Contains a full (with a service name) function name for backend functions. */

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

@@ -8,7 +8,7 @@ import { AiFilesClient } from './ai-files-client';
 import { AiImageClient } from './ai-image-client';
 import { AiKnowledgeBaseReference } from './ai-knowledge-base/ai-knowledge-base-client-reference';
 import { AiMatchMakingClient } from './ai-matchmaking-client';
-import { AiAgent, AiAgentApiIntegrationOptions, AiAgentId, AiFileProviderType, AiKnowledgeBase, AiKnowledgeBaseId, AiProviderType, AiSessionContext, AiStatusMessage, ApplicationAiSettings, IntegrationId, JobId, ModelIdSpec, SecretKey } from './public-types';
+import { AiAgent, AiAgentApiIntegrationOptions, AiAgentId, AiFileProviderType, AiKnowledgeBase, AiKnowledgeBaseId, AiProviderType, AiSessionContext, AiStatusMessage, ApplicationAiSettings, IntegrationId, JobId, ListChatModelsRequest, ModelIdSpec, SecretKey } from './public-types';
 /**
  * AiClient class serves as a facade for interacting with different AI services.
  * It provides simplified access to AI chatbot and assistant functionalities
@@ -47,8 +47,10 @@ export declare class AiClient {
     /**
      * Returns a list of all available AI chat models.
      * Includes both Squid-provided vendor models and custom integration models.
+     * Vendor models carry a human-readable `description`. Deprecated vendor models are
+     * included only when `options.includeDeprecated` is true and are marked with `replacedBy`.
      */
-    listChatModels(): Promise<ModelIdSpec[]>;
+    listChatModels(options?: ListChatModelsRequest): Promise<ModelIdSpec[]>;
     /**
      * Retrieves an AI image client.
      */

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.469";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.471";

package/package.json

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