@squidcloud/client 1.0.449 → 1.0.450

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

@@ -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 */

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/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.450";

package/package.json

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