@squidcloud/client 1.0.449 → 1.0.451

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

@@ -24,7 +24,7 @@ export type AiFileProviderType = Extract<AiProviderType, 'openai' | 'gemini' | '
  * Public OpenAI chat model names (active models only).
  * @category AI
  */
-export declare const OPENAI_CHAT_MODEL_NAMES: readonly ["gpt-5-mini", "gpt-5-nano", "gpt-5.2", "gpt-5.2-pro"];
+export declare const OPENAI_CHAT_MODEL_NAMES: readonly ["gpt-5-mini", "gpt-5-nano", "gpt-5.2", "gpt-5.2-pro", "gpt-5.4"];
 /**
  * Public Gemini chat model names (active models only).
  * @category AI
@@ -44,7 +44,7 @@ export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-haiku-4-5-202
  * The supported AI model names.
  * @category AI
  */
-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-6", "claude-sonnet-4-6", "gemini-3-pro", "gemini-3-flash", "grok-4", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
+export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5-mini", "gpt-5-nano", "gpt-5.2", "gpt-5.2-pro", "gpt-5.4", "claude-haiku-4-5-20251001", "claude-opus-4-6", "claude-sonnet-4-6", "gemini-3-pro", "gemini-3-flash", "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;
 /**
@@ -68,6 +68,31 @@ export declare const AI_EMBEDDINGS_MODEL_NAMES: readonly ["text-embedding-3-smal
  * @category AI
  */
 export declare function isAiEmbeddingsModelName(modelName: unknown): modelName is AiEmbeddingsModelName;
+/**
+ * Represents an embedding model provided by an OpenAI-compatible integration.
+ * Unlike chat's `IntegrationModelSpec`, this includes `dimensions` because the same
+ * embedding model can be configured with different output dimensions.
+ * @category AI
+ */
+export interface IntegrationEmbeddingModelSpec {
+    /** The ID of the integration providing the embedding model. */
+    integrationId: string;
+    /** The model name as recognized by the provider. */
+    model: string;
+    /** The number of dimensions in the embedding vector output. */
+    dimensions: number;
+}
+/**
+ * Type guard for `IntegrationEmbeddingModelSpec`.
+ * @category AI
+ */
+export declare function isIntegrationEmbeddingModelSpec(model: unknown): model is IntegrationEmbeddingModelSpec;
+/**
+ * Type for specifying which embedding model to use.
+ * Can be either a vendor model name (string) or an integration-based embedding model (object).
+ * @category AI
+ */
+export type AiEmbeddingsModelSelection = AiEmbeddingsModelName | IntegrationEmbeddingModelSpec;
 /**
  * The supported AI image generation model names.
  * @category AI

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

@@ -1,5 +1,5 @@
 import { AgentContextRequest, AiChatModelSelection, UpsertContextStatusError } from './ai-agent.public-types';
-import { AiEmbeddingsModelName, AiRerankProvider } from './ai-common.public-types';
+import { AiEmbeddingsModelSelection, AiRerankProvider } from './ai-common.public-types';
 import { AiContextId, AiKnowledgeBaseId, AppId } from './communication.public-types';
 import { DocumentExtractionMethod } from './extraction.public-types';
 /**
@@ -15,8 +15,8 @@ export interface AiKnowledgeBase {
     description: string;
     /** A set of predefined metadata fields for the knowledge base that can be used for filtering.*/
     metadataFields: Array<AiKnowledgeBaseMetadataField>;
-    /** The embedding model name that should be used for this knowledge base.*/
-    embeddingModel: AiEmbeddingsModelName;
+    /** The embedding model that should be used for this knowledge base.*/
+    embeddingModel: AiEmbeddingsModelSelection;
     /** The model name that should be used when asking questions of this knowledge base. */
     chatModel: AiChatModelSelection;
     /** The timestamp the knowledge base was last updated */
@@ -379,12 +379,13 @@ export interface AiKnowledgeBaseDownloadContextResponse {
     url?: string;
 }
 /**
- * KnowledgeBase with optional chatModel param, used during upsert
+ * KnowledgeBase with optional fields, used during upsert
  * @category AI
  */
-export type AiKnowledgeBaseWithOptionalChatModel = Omit<AiKnowledgeBase, 'chatModel'> & {
+export type AiEmbeddingsModelWithOptionalFields = Omit<AiKnowledgeBase, 'chatModel' | 'embeddingModel'> & {
     chatModel?: AiKnowledgeBase['chatModel'];
     name?: string;
+    embeddingModel?: AiEmbeddingsModelSelection;
 };
 /**
  * API request for deleting an AiKnowledgeBase
@@ -400,7 +401,7 @@ export interface DeleteAiKnowledgeBaseRequest {
  */
 export interface UpsertAiKnowledgeBaseRequest {
     /** The AiKnowledgeBase to upsert */
-    knowledgeBase: Omit<AiKnowledgeBaseWithOptionalChatModel, 'appId' | 'updatedAt'>;
+    knowledgeBase: Omit<AiEmbeddingsModelWithOptionalFields, 'appId' | 'updatedAt'>;
 }
 /**
  * API request for deleting AiKnowledgeBaseContexts

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

@@ -33,6 +33,10 @@ export interface AiQueryOptions {
     sessionContext?: PartialBy<AiSessionContext, 'agentId'>;
     /** memory options */
     memoryOptions?: AiAgentMemoryOptions;
+    /** When true, returns generated queries without executing or analyzing them. Default: false. */
+    generateQueriesOnly?: boolean;
+    /** Optional AI validation of generated queries. Can be used independently or with generateQueriesOnly. */
+    validateWithAiOptions?: AiQueryValidateWithAiOptions;
 }
 /**
  * Request to execute an AI query using a specific integration.
@@ -110,6 +114,16 @@ export interface AiQueryAnalyzeResultsOptions {
      */
     agentId?: AiAgentId;
 }
+/**
+ * Options for AI-based validation of generated queries.
+ * @category AI
+ */
+export interface AiQueryValidateWithAiOptions {
+    /** Whether AI validation is enabled. */
+    enabled: boolean;
+    /** Defaults to the same model used for query generation. */
+    aiOptions?: AiChatOptions;
+}
 /**
  * Information about an executed query.
  * @category AI

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

@@ -48,3 +48,14 @@ export type LlmModelMetadata = {
     /** Total context window size: input (aka prompt) + output (aka completion) tokens combined. */
     contextWindowTokens: number;
 };
+/**
+ * Stats about a given embedding model.
+ */
+export type EmbeddingModelMetadata = {
+    /** A friendly name for the model, to display in UIs. */
+    displayName: string;
+    /** The number of dimensions produced by this embedding model. */
+    dimensions: number;
+    /** Maximum input tokens per request. */
+    maxTokens: number;
+};

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

@@ -1,6 +1,6 @@
 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", "bedrock", "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", "jira_jsm", "jwt_hmac", "jwt_rsa", "kafka", "keycloak", "linear", "mariadb", "monday", "mongo", "mssql", "databricks", "mysql", "newrelic", "okta", "onedrive", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce", "sap_hana", "sentry", "snowflake", "spanner", "xata", "zendesk", "servicenow_csm", "freshdesk", "mail", "slack", "mcp", "a2a", "legend", "teams", "openai_compatible"];
+export declare const INTEGRATION_TYPES: readonly ["active_directory", "ai_agents", "ai_chatbot", "algolia", "alloydb", "api", "auth0", "bedrock", "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", "jira_jsm", "jwt_hmac", "jwt_rsa", "kafka", "keycloak", "linear", "mariadb", "monday", "mongo", "mssql", "databricks", "mysql", "newrelic", "okta", "onedrive", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce", "sap_hana", "sentry", "snowflake", "spanner", "xata", "zendesk", "servicenow_csm", "freshdesk", "mail", "slack", "mcp", "a2a", "legend", "teams", "openai_compatible", "openai_compatible_embedding"];
 /**
  * @category Database
  */

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

@@ -36,7 +36,7 @@ export declare class AiClient {
      */
     listAgents(): Promise<Array<AiAgent>>;
     /**
-     * Lists all available AI agents.
+     * Lists all available AI Knowledge Bases.
      */
     listKnowledgeBases(): Promise<Array<AiKnowledgeBase>>;
     /**

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

@@ -1,4 +1,4 @@
-import { AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResultChunk, AiKnowledgeBaseWithOptionalChatModel, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
+import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResultChunk, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
 import { AiContextId } from '../../../internal-common/src/public-types/communication.public-types';
 /**
  * Parameters for creating or updating an AI agent.
@@ -27,7 +27,7 @@ export declare class AiKnowledgeBaseReference {
      * Upserts the AI knowledge base.
      * @param knowledgeBase
      */
-    upsertKnowledgeBase(knowledgeBase: Omit<AiKnowledgeBaseWithOptionalChatModel, 'id' | 'appId' | 'updatedAt'>): Promise<void>;
+    upsertKnowledgeBase(knowledgeBase: Omit<AiEmbeddingsModelWithOptionalFields, 'id' | 'appId' | 'updatedAt'>): Promise<void>;
     /**
      * Deletes the AI knowledge base.
      * @returns A promise that resolves when the deletion is complete.

package/dist/typescript-client/src/distributed-lock.manager.d.ts

@@ -4,6 +4,11 @@ import { Observable } from 'rxjs';
  * @category Platform
  */
 export interface DistributedLockOptions {
+    /**
+     * The maximum time to wait for the lock to be acquired on the server.
+     * @default 2000.
+     */
+    acquisitionTimeoutMillis?: number;
     /**
      * The maximum time the lock can be held before it is automatically released.
      * If not specified, the lock will be held until explicitly released or the connection is lost.

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

@@ -1,4 +1,6 @@
 import { Alias, SquidDocument } from '../public-types';
+/** Two transactions cannot run in parallel - this mutex is used for blocking a second transaction. */
+export declare const RUN_IN_TRANSACTION_MUTEX = "dataManager_runInTransaction";
 /**
  * Represents a collection of documents associated with a specific alias
  * in a query, typically used in joined query results.

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.449",
+  "version": "1.0.451",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -19,11 +19,9 @@
     "keep-only-public-types": "del-cli 'dist/internal-common/src/**' '!dist/internal-common/src/public-types' '!dist/internal-common/src/public-utils'",
     "check-public-types": "tsc -p tsconfig.types.json",
     "check-bundle-size": "node check-bundle-size.js",
-    "test": "jest --detectOpenHandles",
-    "test:watch": "jest --watch",
-    "test:cov": "jest --coverage",
-    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
-    "test:e2e": "jest --config ./test/jest-e2e.json",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:cov": "vitest run --coverage",
     "publish:public": "npm run build && npm publish --access public",
     "full-bundle-size-report": "cross-env BUILD_FULL_BUNDLE_SIZE_REPORT=1 webpack --mode=production",
     "generate-docs-html": "typedoc",

package/dist/typescript-client/src/state/state.service.spec.d.ts

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