@squidcloud/client 1.0.302 → 1.0.304

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

@@ -1,6 +1,6 @@
 import { FunctionName, FunctionNameWithContext } from './bundle-data.public-types';
 import { IntegrationId } from './communication.public-types';
-import { AiChatPromptQuotas, AiConnectedAgentMetadata } from '../types/ai-chatbot.types';
+import { AiChatPromptQuotas, AiConnectedAgentMetadata, AiConnectedIntegrationMetadata } from '../types/ai-chatbot.types';
 /** The supported OpenAI models */
 export declare const OPENAI_CHAT_MODEL_NAMES: readonly ["gpt-4o", "gpt-4o-mini", "o1", "o1-mini"];
 export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-1.5-pro", "gemini-1.5-flash"];
@@ -141,6 +141,7 @@ export interface AiChatbotChatOptions {
      * Functions to expose to the AI.
      * Either a function name or a name with an extra function context passed only to this function.
      * The parameter values must be valid serializable JSON values.
+     * Overrides the stored value.
      */
     functions?: Array<FunctionName | FunctionNameWithContext>;
     /** A list of instructions to include with the prompt. */
@@ -149,8 +150,10 @@ export interface AiChatbotChatOptions {
     contextMetadataFilter?: AiContextMetadataFilter;
     /** The options to use for the response in voice. */
     voiceOptions?: AiAudioCreateSpeechOptions;
-    /** List of connected AI agents can be called by the current agent. */
+    /** List of connected AI agents can be called by the current agent. Overrides the stored value. */
     connectedAgents?: Array<AiConnectedAgentMetadata>;
+    /** List of connected AI agents can be called by the current agent. Overrides the stored value. */
+    connectedIntegrations?: Array<AiConnectedIntegrationMetadata>;
     /** Current budget for nested or recursive AI chat calls per single prompt. */
     quotas?: AiChatPromptQuotas;
 }

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

@@ -1,3 +1,4 @@
+import { IntegrationType } from './integration.public-types';
 /** The different types of actions that can be performed on a database. */
 export type DatabaseActionType = 'read' | 'write' | 'update' | 'insert' | 'delete' | 'all';
 /** The different types of actions that can be performed for storage. */
@@ -15,6 +16,14 @@ export interface AiFunctionParam {
     type: AiFunctionParamType;
     required: boolean;
 }
+/** Additional optional readonly  metadata for AI function. */
+export interface AiFunctionAttributes {
+    /**
+     * Type of integration this function is used for.
+     * Functions with defined 'integrationType' require 'integrationId' to be passed as part of the function context.
+     */
+    integrationType?: IntegrationType;
+}
 export type TopicName = string;
 export type FunctionName = string;
 /** Function name with the contextual data. The data must be a serializable JSON. */

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

@@ -1,76 +1,14 @@
 import { IntegrationId } from './communication.public-types';
-export declare enum IntegrationType {
-    'built_in_db' = "built_in_db",
-    'mongo' = "mongo",
-    'mysql' = "mysql",
-    'clickhouse' = "clickhouse",
-    'mssql' = "mssql",
-    'postgres' = "postgres",
-    'cockroach' = "cockroach",
-    'api' = "api",
-    'graphql' = "graphql",
-    'snowflake' = "snowflake",
-    'datadog' = "datadog",
-    'newrelic' = "newrelic",
-    'auth0' = "auth0",
-    'jwt_rsa' = "jwt_rsa",
-    'jwt_hmac' = "jwt_hmac",
-    'ai_chatbot' = "ai_chatbot",
-    'cognito' = "cognito",
-    'okta' = "okta",
-    'descope' = "descope",
-    'firebase_auth' = "firebase_auth",
-    'kafka' = "kafka",
-    'confluent' = "confluent",
-    'built_in_queue' = "built_in_queue",
-    's3' = "s3",
-    'gcs' = "gcs",
-    'built_in_s3' = "built_in_s3",
-    'built_in_gcs' = "built_in_gcs",
-    'google_drive' = "google_drive",
-    'ai_agents' = "ai_agents",
-    'algolia' = "algolia",
-    'elastic_observability' = "elastic_observability",
-    'elastic_search' = "elastic_search",
-    'elastic_enterprise_search' = "elastic_enterprise_search",
-    'sentry' = "sentry",
-    'sap_hana' = "sap_hana",
-    'salesforce_crm' = "salesforce_crm",
-    'documentdb' = "documentdb",
-    'dynamodb' = "dynamodb",
-    'cassandra' = "cassandra",
-    'alloydb' = "alloydb",
-    'spanner' = "spanner",
-    'db2' = "db2",
-    'mariadb' = "mariadb",
-    'oracledb' = "oracledb",
-    'redis' = "redis",
-    'xata' = "xata",
-    'azure_sql' = "azure_sql",
-    'azure_postgresql' = "azure_postgresql",
-    'azure_cosmosdb' = "azure_cosmosdb",
-    'firestore' = "firestore",
-    'bigquery' = "bigquery",
-    'cloudsql' = "cloudsql",
-    'slack' = "slack",
-    'hubspot' = "hubspot",
-    'monday' = "monday",
-    'google_docs' = "google_docs",
-    'onedrive' = "onedrive",
-    'zendesk' = "zendesk",
-    'pinecone' = "pinecone",
-    'active_directory' = "active_directory",
-    'jira' = "jira",
-    'confluence' = "confluence",
-    'servicenow' = "servicenow",
-    'linear' = "linear"
-}
-export declare enum IntegrationSchemaType {
-    'data' = "data",
-    'api' = "api",
-    'graphql' = "graphql"
-}
+/** 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", "confluence", "confluent", "datadog", "db2", "descope", "documentdb", "dynamodb", "elastic_enterprise_search", "elastic_observability", "elastic_search", "firebase_auth", "firestore", "gcs", "google_docs", "google_drive", "graphql", "hubspot", "jira", "jwt_hmac", "jwt_rsa", "kafka", "linear", "mariadb", "monday", "mongo", "mssql", "mysql", "newrelic", "okta", "onedrive", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce_crm", "sap_hana", "sentry", "servicenow", "slack", "snowflake", "spanner", "xata", "zendesk"];
+export type IntegrationType = (typeof INTEGRATION_TYPES)[number];
+export declare const INTEGRATION_SCHEMA_TYPES: readonly ["data", "api", "graphql"];
+export type IntegrationSchemaType = (typeof INTEGRATION_SCHEMA_TYPES)[number];
+export declare const BUILT_IN_DB_INTEGRATION_ID: IntegrationId;
+export declare const BUILT_IN_QUEUE_INTEGRATION_ID: IntegrationId;
 export declare const AI_AGENTS_INTEGRATION_ID: IntegrationId;
+/** ID for the cloud specific storage integration: s3 (built_in_s3) or gcs (built_in_gcs). */
+export declare const BUILT_IN_STORAGE_INTEGRATION_ID: IntegrationId;
 export interface IntegrationInfo<ConfigurationType = Record<string, any> | undefined> {
     id: IntegrationId;
     type: IntegrationType;

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

@@ -1,6 +1,6 @@
 import { AiChatModelName, AiEmbeddingsModelName, VectorDbType } from '../ai-chatbot.public-types';
 import { FunctionName } from '../bundle-data.public-types';
-import { AiConnectedAgentMetadata } from '../../types/ai-chatbot.types';
+import { AiConnectedAgentMetadata, AiConnectedIntegrationMetadata } from '../../types/ai-chatbot.types';
 export type AiChatbotConfiguration = {
     apiKey?: string;
 };
@@ -16,8 +16,10 @@ export type AiChatbotProfileMetadata = {
     vectorDbType?: VectorDbType;
     /** List of AI functions attached to the profile by default. */
     functions?: Array<FunctionName>;
-    /** List of child AI profiles (agents) that can be used by the current agent. */
-    connectedProfiles?: Array<AiConnectedAgentMetadata>;
+    /** List of child AI agents that can be used by the current agent. */
+    connectedAgents?: Array<AiConnectedAgentMetadata>;
+    /** List of connected integrations. */
+    connectedIntegrations?: Array<AiConnectedIntegrationMetadata>;
     auditLog?: boolean;
 };
 export type AiChatbotContextMetadata = {
@@ -26,6 +28,6 @@ export type AiChatbotContextMetadata = {
     preview: boolean;
     sizeBytes?: number;
 };
-export type MutableAiChatbotProfileMetadataFieldsType = keyof Pick<AiChatbotProfileMetadata, 'modelName' | 'isPublic' | 'functions' | 'connectedProfiles' | 'auditLog'>;
+export type MutableAiChatbotProfileMetadataFieldsType = keyof Pick<AiChatbotProfileMetadata, 'modelName' | 'isPublic' | 'functions' | 'connectedAgents' | 'connectedIntegrations' | 'auditLog'>;
 /** List of fields that can be updated in runtime via API. */
 export declare const MUTABLE_AI_CHATBOT_PROFILE_METADATA_FIELDS: Array<MutableAiChatbotProfileMetadataFieldsType>;

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

@@ -60,10 +60,10 @@ export interface ApiEndpoint {
 }
 export interface DiscoverOpenApiSchemaRequest {
     integrationId: IntegrationId;
-    integrationType: IntegrationType.api;
+    integrationType: Extract<IntegrationType, 'api'>;
     discoveryOptions: OpenApiDiscoveryOptions;
 }
 export interface DiscoverOpenApiSchemaFromFileRequest {
     integrationId: IntegrationId;
-    integrationType: IntegrationType.api;
+    integrationType: Extract<IntegrationType, 'api'>;
 }

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

@@ -1,6 +1,7 @@
 import { AiFileUrl } from '../public-types/ai-chatbot.public-types';
-import { AiAgentId } from '../public-types/communication.public-types';
+import { AiAgentId, IntegrationId } from '../public-types/communication.public-types';
 import { FunctionName, FunctionNameWithContext } from '../public-types/bundle-data.public-types';
+import { IntegrationType } from '../public-types/integration.public-types';
 export type AiChatResponseFormat = 'text' | 'json_object';
 export interface AiChatOptions {
     maxTokens: number;
@@ -16,10 +17,12 @@ export interface AiChatOptions {
     agentId?: AiAgentId;
     /** Global per-agent context passed to all AI functions. Must be a serializable JSON. */
     agentContext?: Record<string, unknown>;
-    /** List of AI functions available for the chatbot. */
+    /** List of AI functions available for the chatbot. Overrides the stored list.*/
     functions?: Array<FunctionName | FunctionNameWithContext>;
-    /** List of connected AI agents can be called by the current agent. */
+    /** List of connected AI agents can be called by the current agent. Overrides the stored list.*/
     connectedAgents?: Array<AiConnectedAgentMetadata>;
+    /** List of connected integrations. Overrides the stored list. */
+    connectedIntegrations?: Array<AiConnectedIntegrationMetadata>;
     /** Current budget for nested or recursive AI chat calls per single prompt. */
     quotas?: AiChatPromptQuotas;
 }
@@ -31,6 +34,17 @@ export interface AiConnectedAgentMetadata {
      */
     description: string;
 }
+export interface AiConnectedIntegrationMetadata {
+    integrationId: IntegrationId;
+    /** Type of the connected integration. */
+    integrationType: IntegrationType;
+    /**
+     * Description of the connected integration for the parent agent context.
+     * Works as AI function description.
+     * If not provided the default one is used.
+     */
+    description?: string;
+}
 /** Quotas for a single AI chat prompt (`ask()` method call). */
 export interface AiChatPromptQuotas {
     /**

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

@@ -0,0 +1,15 @@
+import { IntegrationClient } from './integration-client';
+import { RpcManager } from './rpc.manager';
+import { SecretClient } from './secret.client';
+import { SquidRegion } from '../../internal-common/src/public-types/regions.public-types';
+import { AppId } from '../../internal-common/src/public-types/communication.public-types';
+export declare class AdminClient {
+    private readonly rpcManager;
+    private readonly region;
+    private readonly appId;
+    private readonly integrationClient;
+    private readonly secretClient;
+    constructor(rpcManager: RpcManager, region: SquidRegion, appId: AppId);
+    integrations(): IntegrationClient;
+    secrets(): SecretClient;
+}

package/dist/typescript-client/src/console-utils.d.ts

@@ -0,0 +1 @@
+export declare function getConsoleBaseUrl(appRegion: string, path?: string): string;

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

@@ -48,3 +48,5 @@ export * from './personal-storage-client';
 export * from './extraction-client';
 export * from './file-utils';
 export * from './ai-matchmaking-client';
+export * from './admin-client';
+export * from './console-utils';

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

@@ -1,6 +1,10 @@
 import { IntegrationId, IntegrationInfo, IntegrationType } from './public-types';
 export declare class IntegrationClient {
     private readonly rpcManager;
+    private readonly iacBaseUrl;
     list<ConfigurationType = Record<string, any>>(type?: IntegrationType): Promise<Array<IntegrationInfo<ConfigurationType>>>;
-    get<ConfigurationType = Record<string, any>>(id: IntegrationId): Promise<IntegrationInfo<ConfigurationType> | undefined>;
+    get<ConfigurationType = Record<string, any>>(integrationId: IntegrationId): Promise<IntegrationInfo<ConfigurationType> | undefined>;
+    delete(integrationId: IntegrationId): Promise<void>;
+    deleteMany(integrationIds: Array<IntegrationId>): Promise<void>;
+    upsertIntegration<ConfigurationType = Record<string, any>>(integration: IntegrationInfo<ConfigurationType>): Promise<void>;
 }

package/dist/typescript-client/src/squid-http-client.d.ts

@@ -1,3 +1,4 @@
+import { BlobAndFilename } from './types';
 export declare class RpcError<BodyType = unknown> extends Error {
     readonly statusCode: number;
     readonly statusText: string;
@@ -5,6 +6,23 @@ export declare class RpcError<BodyType = unknown> extends Error {
     readonly headers: Record<string, string>;
     readonly body: BodyType;
 }
+/**
+ * A more general request interface for other HTTP methods
+ * (GET, PUT, PATCH, DELETE).
+ */
+interface HttpRequestInput<RequestBodyType = unknown> {
+    url: string;
+    headers: Record<string, string>;
+    message?: RequestBodyType;
+    files?: Array<File | BlobAndFilename>;
+    filesFieldName?: string;
+    extractErrorMessage: boolean;
+    /**
+     * Which method to use. E.g. 'GET', 'PUT', 'PATCH', 'DELETE'...
+     * For POST, we still use `HttpPostInput` for backward-compat.
+     */
+    method: string;
+}
 /** A response object with type T for the body. */
 export interface HttpResponse<BodyType = unknown> {
     status: number;
@@ -12,3 +30,14 @@ export interface HttpResponse<BodyType = unknown> {
     headers: Record<string, string>;
     body: BodyType;
 }
+export declare function rawSquidHttpGet<ResponseType = unknown, RequestType = unknown>(input: Omit<HttpRequestInput<RequestType>, 'method' | 'files' | 'filesFieldName'>): Promise<HttpResponse<ResponseType>>;
+export declare function rawSquidHttpPut<ResponseType = unknown, RequestType = unknown>(input: Omit<HttpRequestInput<RequestType>, 'method'> & {
+    files?: Array<File | BlobAndFilename>;
+    filesFieldName?: string;
+}): Promise<HttpResponse<ResponseType>>;
+export declare function rawSquidHttpPatch<ResponseType = unknown, RequestType = unknown>(input: Omit<HttpRequestInput<RequestType>, 'method'> & {
+    files?: Array<File | BlobAndFilename>;
+    filesFieldName?: string;
+}): Promise<HttpResponse<ResponseType>>;
+export declare function rawSquidHttpDelete<ResponseType = unknown, RequestType = unknown>(input: Omit<HttpRequestInput<RequestType>, 'method' | 'files' | 'filesFieldName'>): Promise<HttpResponse<ResponseType>>;
+export {};

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

@@ -5,14 +5,13 @@ import { ConnectionDetails } from './connection-details';
 import { DistributedLock } from './distributed-lock.manager';
 import { ApiKey, AppId, CollectionName, DocumentData, EnvironmentId, IntegrationId, SquidDeveloperId, SquidRegion } from './public-types';
 import { QueueManager } from './queue.manager';
-import { SecretClient } from './secret.client';
 import { StorageClient } from './storage-client';
 import { TransactionId } from './types';
 import { ObservabilityClient } from './observability-client';
 import { ExtractionClient } from './extraction-client';
 import { PersonalStorageClient } from './personal-storage-client';
 import { SchedulerClient } from './scheduler-client';
-import { IntegrationClient } from './integration-client';
+import { AdminClient } from './admin-client';
 /** The different options that can be used to initialize a Squid instance. */
 export interface SquidOptions {
     /**
@@ -98,15 +97,14 @@ export declare class Squid {
     private readonly clientIdService;
     private readonly aiClientFactory;
     private readonly _connectionDetails;
-    private readonly secretClient;
     private readonly querySender;
     private static readonly squidInstancesMap;
     private readonly aiClient;
     private readonly apiClient;
+    private readonly adminClient;
     private readonly observabilityClient;
     private readonly queueManagerFactory;
     private readonly schedulerClient;
-    private readonly integrationClient;
     private readonly _appId;
     /**
      * Creates a new instance of Squid with the given options.
@@ -207,13 +205,12 @@ export declare class Squid {
      */
     ai(): AiClient;
     api(): ApiClient;
+    admin(): AdminClient;
     storage(integrationId?: IntegrationId): StorageClient;
     personalStorage(integrationId: IntegrationId): PersonalStorageClient;
     extraction(): ExtractionClient;
-    get secrets(): SecretClient;
     get observability(): ObservabilityClient;
     get schedulers(): SchedulerClient;
-    get integrations(): IntegrationClient;
     get appId(): AppId;
     /**
      * Returns a distributed lock for the given mutex. The lock can be used to synchronize access to a shared resource.

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

@@ -1 +1 @@
-export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.302";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.304";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.302",
+  "version": "1.0.304",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "types": "dist/typescript-client/src/index.d.ts",
@@ -38,7 +38,7 @@
   "license": "ISC",
   "dependencies": {
     "json-schema-typed": "^8.0.1",
-    "ws": "^8.18.0"
+    "ws": "^8.17.1"
   },
   "optionalDependencies": {
     "bufferutil": "^4.0.8",
@@ -56,7 +56,7 @@
     "otrie": "^1.1.3",
     "tsconfig-paths-webpack-plugin": "^4.1.0",
     "tscpaths": "^0.0.9",
-    "webpack": "^5.95.0",
+    "webpack": "^5.96.0",
     "webpack-cli": "^5.1.4"
   },
   "engines": {