@squidcloud/client 1.0.421 → 1.0.423

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

@@ -120,7 +120,7 @@ export interface AiKnowledgeBaseChatOptions {
     includeMetadata?: boolean;
     /** Which provider's reranker to use for reranking the context. Defaults to 'cohere'. */
     rerankProvider?: AiRerankProvider;
-    /** The maximum number of results to return */
+    /** The maximum number of results to return. Defaults to 30 */
     limit?: number;
     /** How many chunks to look over. Defaults to 100 */
     chunkLimit?: number;

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

@@ -7,7 +7,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, AiAgentId, AiFileProviderType, AiKnowledgeBase, AiKnowledgeBaseId, AiProviderType, AiSessionContext, ApplicationAiSettings, IntegrationId, SecretKey } from './public-types';
+import { AiAgent, AiAgentApiIntegrationOptions, AiAgentId, AiFileProviderType, AiKnowledgeBase, AiKnowledgeBaseId, AiProviderType, AiSessionContext, ApplicationAiSettings, IntegrationId, 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
@@ -99,10 +99,17 @@ export declare class AiClient {
      */
     executeAiQuery(integrationId: IntegrationId, prompt: string, options?: AiQueryOptions): Promise<AiQueryResponse>;
     /**
-     * Request to execute an AI-powered API call.
-     * Allows specifying allowed endpoints and whether to provide an explanation.
+     * Executes an AI-powered API call using a specific integration.
+     * The AI will select appropriate endpoints, generate request bodies,
+     * and analyze responses to answer the provided prompt.
+     *
+     * @param integrationId - The API integration to use
+     * @param prompt - Natural language description of what to accomplish
+     * @param options - Optional configuration including allowed endpoints and verbose updates
+     * @param sessionContext - Optional session context for audit trails and tracing
+     * @returns Promise resolving to the API call result with answer and execution details
      */
-    executeAiApiCall(integrationId: IntegrationId, prompt: string, allowedEndpoints?: string[], provideExplanation?: boolean, generateApiCallAgentId?: AiAgentId, sessionContext?: AiSessionContext): Promise<ExecuteAiApiResponse>;
+    executeAiApiCall(integrationId: IntegrationId, prompt: string, options?: AiAgentApiIntegrationOptions, sessionContext?: AiSessionContext): Promise<ExecuteAiApiResponse>;
     /**
      * Returns name of the secret that stores API key for the given AI provider type.
      * This API key is used for all requests to the AI provider done from the application.

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

@@ -37,7 +37,6 @@ export * from './mutation/mutation-sender';
 export * from './native-query-manager';
 export * from './notification-client';
 export * from './observability-client';
-export * from './personal-storage-client';
 export * from './public-types';
 export * from './public-utils';
 export * from './query-utils';

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

@@ -10,7 +10,6 @@ import { ExtractionClient } from './extraction-client';
 import { JobClient } from './job-client';
 import { NotificationClient } from './notification-client';
 import { ObservabilityClient } from './observability-client';
-import { PersonalStorageClient } from './personal-storage-client';
 import { ApiKey, AppId, CollectionName, DocumentData, EnvironmentId, IntegrationId, SquidDeveloperId, SquidRegion } from './public-types';
 import { QueueManager } from './queue.manager';
 import { SchedulerClient } from './scheduler-client';
@@ -325,12 +324,6 @@ export declare class Squid {
      * @param integrationId The storage integration ID (default is 'built_in_storage').
      */
     storage(integrationId?: IntegrationId): StorageClient;
-    /**
-     * Returns a client for accessing personal (user-specific) file storage.
-     *
-     * @param integrationId The storage integration ID to use.
-     */
-    personalStorage(integrationId: IntegrationId): PersonalStorageClient;
     /**
      * Returns a client for managing external oauth tokens for integrations.
      * Use this to save authorization codes and retrieve access tokens.

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

package/package.json

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

package/dist/typescript-client/src/personal-storage-client.d.ts

@@ -1,85 +0,0 @@
-import { AiContextMetadata } from './public-types';
-/**
- * Response to a request to get the access token for a personal storage service.
- * @category Personal Storage
- */
-export interface PsGetAccessTokenResponse {
-    /** The access token for the personal storage service. */
-    accessToken: string;
-    /** The expiration time of the access token. */
-    expirationTime: Date;
-}
-/**
- * The type of a document in personal storage.
- * @category Personal Storage
- */
-export type PsDocumentType = 'file' | 'folder';
-/**
- * A document indexed for AI processing (as part of the personal storage connector).
- * @category Personal Storage
- */
-export interface PsIndexedDocument {
-    /** The ID of the document. */
-    id: string;
-    /** The name of the document. */
-    name: string;
-    /** The type of the document (file or folder). */
-    type: PsDocumentType;
-    /** Metadata stored about the document */
-    metadata: AiContextMetadata;
-    /** The ID of the parent folder of the document. */
-    folderDocumentId?: string;
-}
-/**
- * Client to handle personal storage integrations such as Google Drive or Microsoft OneDrive.
- * Provides methods for saving authentication tokens, indexing documents or folders for AI processing,
- * and unindexing documents from AI processing.
- * @category Personal Storage
- */
-export declare class PersonalStorageClient {
-    private readonly integrationId;
-    private readonly rpcManager;
-    /**
-     * Saves an authentication token for the personal storage service.
-     *
-     * @param authCode - The authorization code obtained from the OAuth flow for the personal storage service.
-     * @param identifier - A user-provided identifier (usually a user ID) that will be associated with the token.
-     * @returns A promise that resolves with the access token and expiration time.
-     */
-    saveAuthCode(authCode: string, identifier: string): Promise<PsGetAccessTokenResponse>;
-    /**
-     * Retrieves an access token for the personal storage service.
-     *
-     * @param identifier - A user-provided identifier (usually a user ID) that is associated with the token.
-     * @returns A promise that resolves with the access token and expiration time.
-     */
-    getAccessToken(identifier: string): Promise<PsGetAccessTokenResponse>;
-    /**
-     * Indexes a document or folder for AI processing.
-     *
-     * @param documentOrFolderId - The ID of the document or folder to be indexed.
-     * @param identifier - A user-provided identifier (usually a user ID) that will be associated with the document.
-     * @param agentId - The agent ID for the AI processing configuration.
-     * @param metadata - Metadata to include with the index
-     * @returns A promise that resolves when the document or folder is successfully indexed.
-     */
-    indexDocumentOrFolder(documentOrFolderId: string, identifier: string, agentId: string, metadata?: AiContextMetadata): Promise<void>;
-    /**
-     * Lists all documents or folders that have been indexed for AI processing.
-     *
-     * @param identifier - A user-provided identifier (usually a user ID) associated with the indexed documents.
-     * @param agentId - The AI agent ID used when indexing the documents.
-     * @param type - (Optional) The type of items to list: `'file'` or `'folder'`. If omitted, returns both.
-     * @returns A promise that resolves with an array of indexed documents or folders.
-     */
-    listIndexedDocuments(identifier: string, agentId: string, type?: PsDocumentType): Promise<Array<PsIndexedDocument>>;
-    /**
-     * Unindexes a previously indexed document, removing it from AI processing.
-     *
-     * @param documentId - The ID of the document to be unindexed.
-     * @param identifier - A user-provided identifier (usually a user ID) that was associated with the document.
-     * @param agentId - The agent ID for the AI processing configuration.
-     * @returns A promise that resolves when the document is successfully unindexed.
-     */
-    unindexDocument(documentId: string, identifier: string, agentId: string): Promise<void>;
-}