@squidcloud/client 1.0.326 → 1.0.327

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

@@ -1,5 +1,3 @@
-export declare enum ClientConnectionState {
-    CONNECTED = "CONNECTED",
-    DISCONNECTED = "DISCONNECTED",
-    REMOVED = "REMOVED"
-}
+export declare const CLIENT_CONNECTION_STATES: readonly ["CONNECTED", "DISCONNECTED", "REMOVED"];
+/** Squid client connection state. */
+export type ClientConnectionState = (typeof CLIENT_CONNECTION_STATES)[number];

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

@@ -1,34 +1 @@
-import { AiChatPromptQuotas, AiConnectedAgentMetadata, AiConnectedIntegrationMetadata, AiFileUrl } from '../public-types/ai-agent.public-types';
-import { AiAgentId } from '../public-types/communication.public-types';
-import { FunctionName, FunctionNameWithContext } from '../public-types/bundle-data.public-types';
-export type AiChatResponseFormat = 'text' | 'json_object';
-export interface AiChatOptions {
-    maxTokens: number;
-    responseFormat: AiChatResponseFormat;
-    temperature: number;
-    topP: number;
-    instructions: Array<string>;
-    clientId: string;
-    fileUrls: Array<AiFileUrl>;
-    /** Constrains effort on reasoning for reasoning models. o1 models only. */
-    reasoningEffort?: 'low' | 'medium' | 'high';
-    /** Current AI profile ID (AI agent ID). */
-    agentId?: AiAgentId;
-    /** A unique chat ID for the conversation. */
-    chatId?: string;
-    /** A unique ID for the currentt trace. */
-    traceId?: string;
-    /** 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 agent. Overrides the stored list.*/
-    functions?: Array<FunctionName | FunctionNameWithContext>;
-    /** 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;
-    /** Enables grounding with real-time web search to enhance AI responses with up-to-date information.
-     * Currently supported only for gemini-2.0-flash. */
-    groundingWithWebSearch?: boolean;
-}
+export {};

package/dist/internal-common/src/utils/validation.d.ts

@@ -1,9 +1,8 @@
-import { HttpStatus } from '../public-types/http-status.enum';
-export type StatusCode = HttpStatus.BAD_REQUEST | HttpStatus.NOT_FOUND | HttpStatus.FORBIDDEN | HttpStatus.UNAUTHORIZED | HttpStatus.CONFLICT | HttpStatus.INTERNAL_SERVER_ERROR;
+import { HttpStatusCode } from '../public-types/http-status.enum';
 export declare class ValidationError extends Error {
-    readonly statusCode: StatusCode;
+    readonly statusCode: HttpStatusCode;
     readonly details?: any;
-    constructor(error: string, statusCode: StatusCode, details?: Record<string, any>);
+    constructor(error: string, statusCode: HttpStatusCode, details?: Record<string, any>);
 }
 export declare function isValidId(id: unknown, maxLength?: number): boolean;
 export declare function validateFieldSort(fieldSort: unknown): void;

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

@@ -1,14 +1,11 @@
 import { IntegrationClient } from './integration-client';
 import { SecretClient } from './secret.client';
-import { AgentClient } from './agent-client';
 export declare class AdminClient {
     private readonly rpcManager;
     private readonly region;
     private readonly appId;
     private readonly integrationClient;
     private readonly secretClient;
-    private readonly agentClient;
     integrations(): IntegrationClient;
     secrets(): SecretClient;
-    agents(): AgentClient;
 }

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

@@ -0,0 +1,36 @@
+import { AgentContextRequest, AiAgent, AiAgentChatOptions, AiAgentContext, AiChatModelName, AiConnectedAgentMetadata, AiObserveStatusOptions, AiSearchOptions, AiSearchResponse, AiStatusMessage, AiTranscribeAndAskResponse, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.public-types';
+import { BlobAndFilename } from '../types';
+import { Observable } from 'rxjs';
+import { AskOptionsWithoutVoice, AskWithVoiceResponse, ChatOptionsWithoutVoice, TranscribeAndAskWithVoiceResponse, TranscribeAndChatResponse } from './ai-agent-client.types';
+export type UpsertAgentRequestParams = Omit<UpsertAgentRequest, 'id'>;
+export declare class AiAgentReference {
+    private readonly agentId;
+    private readonly ongoingChatSequences;
+    private readonly statusUpdates;
+    private readonly rpcManager;
+    get(): Promise<AiAgent | undefined>;
+    upsert(agent: UpsertAgentRequestParams): Promise<void>;
+    delete(): Promise<void>;
+    updateInstructions(instructions: string): Promise<void>;
+    updateModel(model: AiChatModelName): Promise<void>;
+    updateConnectedAgents(connectedAgents: Array<AiConnectedAgentMetadata>): Promise<void>;
+    getContext(contextId: string): Promise<AiAgentContext | undefined>;
+    listContexts(): Promise<Array<AiAgentContext>>;
+    deleteContext(contextId: string): Promise<void>;
+    deleteContexts(contextIds: Array<string>): Promise<void>;
+    upsertContext(contextRequest: AgentContextRequest, file?: File | BlobAndFilename): Promise<void>;
+    upsertContexts(contextRequests: Array<AgentContextRequest>, files?: Array<File | BlobAndFilename>): Promise<void>;
+    provideFeedback(feedback: string): Promise<void>;
+    resetFeedback(): Promise<void>;
+    chat(prompt: string, options?: ChatOptionsWithoutVoice): Observable<string>;
+    transcribeAndChat(fileToTranscribe: File, options?: ChatOptionsWithoutVoice): Promise<TranscribeAndChatResponse>;
+    search(options: AiSearchOptions): Promise<AiSearchResponse>;
+    ask(prompt: string, options?: AskOptionsWithoutVoice): Promise<string>;
+    observeStatusUpdates(options?: AiObserveStatusOptions): Observable<AiStatusMessage>;
+    transcribeAndAsk(fileToTranscribe: File, options?: AskOptionsWithoutVoice): Promise<AiTranscribeAndAskResponse>;
+    transcribeAndAskWithVoiceResponse(fileToTranscribe: File, options?: Omit<AiAgentChatOptions, 'smoothTyping'>): Promise<TranscribeAndAskWithVoiceResponse>;
+    askWithVoiceResponse(prompt: string, options?: Omit<AiAgentChatOptions, 'smoothTyping'>): Promise<AskWithVoiceResponse>;
+    private askInternal;
+    private createStatusSubject;
+    private chatInternal;
+}

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

@@ -0,0 +1,13 @@
+import { AiAgent, AiAgentId } from '../public-types';
+import { AiAgentReference } from './ai-agent-client-reference';
+export declare class AiAgentClient {
+    private readonly rpcManager;
+    private readonly socketManager;
+    private readonly ongoingChatSequences;
+    private readonly statusUpdates;
+    agent(id: AiAgentId): AiAgentReference;
+    listAgents(): Promise<Array<AiAgent>>;
+    private handleChatResponse;
+    private handleStatusMessage;
+    private getStatusSubject;
+}

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

@@ -0,0 +1,17 @@
+import { AiAgentChatOptions } from '../../../internal-common/src/public-types/ai-agent.public-types';
+import { Observable } from 'rxjs';
+export interface TranscribeAndChatResponse {
+    transcribedPrompt: string;
+    responseStream: Observable<string>;
+}
+export interface TranscribeAndAskWithVoiceResponse {
+    transcribedPrompt: string;
+    responseString: string;
+    voiceResponseFile: File;
+}
+export interface AskWithVoiceResponse {
+    responseString: string;
+    voiceResponseFile: File;
+}
+export type ChatOptionsWithoutVoice = Omit<AiAgentChatOptions, 'voiceOptions'>;
+export type AskOptionsWithoutVoice = Omit<AiAgentChatOptions, 'voiceOptions' | 'smoothTyping'>;

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

@@ -1,10 +1,10 @@
-import { AiAgentReference } from './ai-agent-client';
 import { AiAssistantClient } from './ai-assistant-client';
-import { AiAgentId, IntegrationId } from './public-types';
+import { AiAgent, AiAgentId, IntegrationId } from './public-types';
 import { AiImageClient } from './ai-image-client';
 import { AiAudioClient } from './ai-audio-client';
 import { AiMatchMakingClient } from './ai-matchmaking-client';
 import { ExecuteAiApiResponse, ExecuteAiQueryMultiResponse, ExecuteAiQueryOptions, ExecuteAiQueryResponse } from './ai.types';
+import { AiAgentReference } from './agent/ai-agent-client-reference';
 /**
  * AiClient class serves as a facade for interacting with different AI services.
  * It provides simplified access to AI chatbot and assistant functionalities
@@ -16,6 +16,7 @@ export declare class AiClient {
     private readonly aiAssistantClient;
     private aiAgentClient?;
     agent(agentId?: AiAgentId): AiAgentReference;
+    listAgents(): Promise<Array<AiAgent>>;
     /**
      * Retrieves the AI assistant client.
      * @returns An instance of AiAssistantClient.

package/dist/typescript-client/src/collection-reference.d.ts

@@ -20,7 +20,7 @@ export interface DocIdAndData<T extends DocumentData> {
  * collection in a NoSQL database.
  *
  * Read more about collection references in the
- * {@link https://docs.getsquid.ai/docs/database/collection-reference documentation}.
+ * {@link https://docs.getsquid.ai/docs/client-sdk/database/collection-reference documentation}.
  * @typeParam T The type of the document data.
  */
 export declare class CollectionReference<T extends DocumentData> {

package/dist/typescript-client/src/document-reference.d.ts

@@ -9,7 +9,7 @@ import { DeepRecord, Paths } from '../../internal-common/src/public-types/typesc
  * use to create a new document.
  *
  * Read more about document references in the
- * {@link https://docs.getsquid.ai/docs/database/document-reference documentation}.
+ * {@link https://docs.getsquid.ai/docs/client-sdk/database/document-reference documentation}.
  * @typeParam T The type of the document data.
  */
 export declare class DocumentReference<T extends DocumentData = any> {

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

@@ -1,5 +1,5 @@
 export * from './ai-assistant-client';
-export * from './ai-agent-client';
+export * from './agent/ai-agent-client';
 export * from './ai-image-client';
 export * from './ai-audio-client';
 export * from './ai.types';
@@ -38,7 +38,6 @@ export * from './observability-client';
 export * from './secret.client';
 export * from './scheduler-client';
 export * from './integration-client';
-export * from './agent-client';
 export * from './socket.manager';
 export * from './squid-http-client';
 export * from './squid';
@@ -51,3 +50,6 @@ export * from './ai-matchmaking-client';
 export * from './admin-client';
 export * from './console-utils';
 export * from './ai-client';
+export * from './agent/ai-agent-client';
+export * from './agent/ai-agent-client.types';
+export * from './agent/ai-agent-client-reference';

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

@@ -8,7 +8,6 @@ export * from '../../internal-common/src/public-types/context.public-types';
 export * from '../../internal-common/src/public-types/document.public-types';
 export * from '../../internal-common/src/public-types/http-status.enum';
 export * from '../../internal-common/src/public-types/integration.public-types';
-export * from '../../internal-common/src/public-types/integrations/ai_agent.public-types';
 export * from '../../internal-common/src/public-types/integrations/api.public-types';
 export * from '../../internal-common/src/public-types/metric.public-types';
 export * from '../../internal-common/src/public-types/mutation.public-types';

package/dist/typescript-client/src/query/join-query-builder.factory.d.ts

@@ -40,7 +40,7 @@ interface HasGrouped {
 /**
  * A query builder that can participate in a join.
  * To learn more about join queries, see the
- * {@link https://docs.getsquid.ai/docs/database/queries#joining-data-across-collections-and-integrations
+ * {@link https://docs.getsquid.ai/docs/client-sdk/database/queries#joining-data-across-collections-and-integrations
  * documentation}.
  */
 export declare class JoinQueryBuilder<Aliases extends Record<Alias, Alias[]>, ReturnType extends Record<Alias, DocumentData>, LatestAlias extends Alias, RootAlias extends Alias> extends BaseQueryBuilder<ReturnType> implements SnapshotEmitter<WithDocumentReferences<ReturnType>>, HasGrouped, HasDereference {

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

@@ -142,7 +142,7 @@ export declare class Squid {
      * If the integrationId is not provided, the `built_in_db` integration id will be used.
      *
      * For more information on the CollectionReference object, please refer to the
-     * {@link https://docs.getsquid.ai/docs/database/collection-reference documentation}.
+     * {@link https://docs.getsquid.ai/docs/client-sdk/database/collection-reference documentation}.
      *
      * @param collectionName The name of the collection.
      * @param integrationId The id of the integration, default to `built_in_db`.
@@ -155,7 +155,7 @@ export declare class Squid {
      * will be atomic. Note that mutations for different integrations will not be atomic.
      *
      * For more information about transactions in Squid, please refer to the
-     * {@link https://docs.getsquid.ai/docs/database/transactions documentation}.
+     * {@link https://docs.getsquid.ai/docs/client-sdk/database/transactions documentation}.
      *
      * @param fn The callback to run as an atomic change. The function receives a transactionId that should be used for
      * all the mutations that should be atomic. The function should return a promise.
@@ -177,7 +177,7 @@ export declare class Squid {
     executeFunction<T = any>(functionName: string, ...params: any[]): Promise<T>;
     /**
      * Executes a native relational query with the given parameters and returns a promise with the result.
-     * See https://docs.getsquid.ai/docs/database/native-queries.
+     * See https://docs.getsquid.ai/docs/client-sdk/database/native-queries.
      *
      * @param integrationId The id of the integration that the query is associated with.
      * @param query The raw SQL or other database-specific query to execute.
@@ -188,7 +188,7 @@ export declare class Squid {
     executeNativeRelationalQuery<T = any>(integrationId: IntegrationId, query: string, params?: Record<string, any>): Promise<Array<T>>;
     /**
      * Executes a native Mongo/built-in-db query with the given pipeline and returns a promise with the result.
-     * See https://docs.getsquid.ai/docs/database/native-queries#native-mongodb-queries.
+     * See https://docs.getsquid.ai/docs/client-sdk/database/native-queries#native-mongodb-queries.
      *
      * @param integrationId The id of the integration that the query is associated with.
      * @param collectionName The collection to query.

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

@@ -1 +1 @@
-export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.326";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.327";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.326",
+  "version": "1.0.327",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "types": "dist/typescript-client/src/index.d.ts",

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

@@ -1,47 +0,0 @@
-import { AiChatModelName, AiConnectedAgentMetadata, AiConnectedIntegrationMetadata, AiEmbeddingsModelName, VectorDbType } from '../ai-agent.public-types';
-import { FunctionName } from '../bundle-data.public-types';
-import { AiAgentId } from '../communication.public-types';
-export type AiAgentConfiguration = {
-    apiKey?: string;
-};
-export type AiAgentMetadata = {
-    modelName: AiChatModelName;
-    description?: string;
-    isPublic: boolean;
-    strictContext?: boolean;
-    instructions: Record<string, string>;
-    feedbackInstructions?: string;
-    /** 'text-embedding-ada-002' if undefined. */
-    embeddingModelName?: AiEmbeddingsModelName;
-    /** 'pinecone' if undefined. */
-    vectorDbType?: VectorDbType;
-    /** List of AI functions attached to the profile by default. */
-    functions?: Array<FunctionName>;
-    /** 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 interface AiAgent extends AiAgentMetadata {
-    agentId: AiAgentId;
-}
-export type AiAgentContextMetadata = {
-    title: string;
-    text: string;
-    preview: boolean;
-    sizeBytes?: number;
-    type?: 'text' | 'url' | 'file';
-};
-export type MutableAiAgentMetadataFieldsType = keyof Pick<AiAgentMetadata, 'modelName' | 'description' | 'isPublic' | 'functions' | 'connectedAgents' | 'connectedIntegrations' | 'auditLog'>;
-/** List of fields that can be updated in runtime via API. */
-export declare const MUTABLE_AI_AGENT_METADATA_FIELDS: Array<MutableAiAgentMetadataFieldsType>;
-export interface ListAgentsResponse {
-    agents: Array<AiAgent>;
-}
-export interface GetAgentRequest {
-    agentId: AiAgentId;
-}
-export interface GetAgentResponse {
-    agent: AiAgent | undefined;
-}

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

@@ -1,6 +0,0 @@
-import { AiAgent, AiAgentId } from './public-types';
-export declare class AgentClient {
-    private readonly rpcManager;
-    list(): Promise<Array<AiAgent>>;
-    get(agentId: AiAgentId): Promise<AiAgent | undefined>;
-}

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

@@ -1,228 +0,0 @@
-import { AiAgentChatOptions, AiAgentId, AiAgentMetadata, AiContext, AiObserveStatusOptions, AiSearchOptions, AiSearchResponse, AiStatusMessage, AiTranscribeAndAskResponse, AiTranscribeAndChatResponse, MUTABLE_AI_AGENT_METADATA_FIELDS } from './public-types';
-import { Observable } from 'rxjs';
-import { BlobAndFilename } from './types';
-export interface TranscribeAndChatResponse {
-    transcribedPrompt: string;
-    responseStream: Observable<string>;
-}
-export interface TranscribeAndAskWithVoiceResponse {
-    transcribedPrompt: string;
-    responseString: string;
-    voiceResponseFile: File;
-}
-export interface AskWithVoiceResponse {
-    responseString: string;
-    voiceResponseFile: File;
-}
-export interface ChatInternalResponse {
-    responseStream: Observable<string>;
-    serverResponse?: Promise<AiTranscribeAndChatResponse>;
-}
-export type ChatOptionsWithoutVoice = Omit<AiAgentChatOptions, 'voiceOptions'>;
-export type AskOptionsWithoutVoice = Omit<AiAgentChatOptions, 'voiceOptions' | 'smoothTyping'>;
-export declare class AiAgentClient {
-    private readonly rpcManager;
-    private readonly socketManager;
-    private readonly ongoingChatSequences;
-    private readonly statusUpdates;
-    /**
-     * Retrieves a reference to an agent with the specified ID.
-     * The returned agent reference can be used to create and update the agent,
-     * add instructions and context, and initiate chats.
-     *
-     * @param id - The ID of the agent.
-     * @returns A reference to the agent.
-     */
-    agent(id: AiAgentId): AiAgentReference;
-    /**
-     * Sends a prompt to the specified agent id.
-     *
-     * @param agentId - The agent id.
-     * @param prompt - The prompt.
-     * @param options - The options to send to the chat model.
-     * @returns An observable that emits when a new response token is received. The emitted value is the entire response
-     * that has been received so far.
-     */
-    chat(agentId: AiAgentId, prompt: string, options?: ChatOptionsWithoutVoice): Observable<string>;
-    transcribeAndChat(agentId: AiAgentId, fileToTranscribe: File, options?: ChatOptionsWithoutVoice): Promise<TranscribeAndChatResponse>;
-    private chatInternal;
-    search(agentId: AiAgentId, options: AiSearchOptions): Promise<AiSearchResponse>;
-    /**
-     * Sends a prompt to the specified agent id and returns the response as a Promise of string.
-     *
-     * @param agentId - The agent id.
-     * @param prompt - The prompt.
-     * @param options - The options to send to the chat model.
-     * @returns A promise that resolves when the chat is complete. The resolved value is the entire response.
-     */
-    ask(agentId: AiAgentId, prompt: string, options?: AskOptionsWithoutVoice): Promise<string>;
-    observeStatusUpdates(agentId: AiAgentId, options?: AiObserveStatusOptions): Observable<AiStatusMessage>;
-    transcribeAndAsk(agentId: AiAgentId, fileToTranscribe: File, options?: AskOptionsWithoutVoice): Promise<AiTranscribeAndAskResponse>;
-    transcribeAndAskWithVoiceResponse(agentId: AiAgentId, fileToTranscribe: File, options?: Omit<AiAgentChatOptions, 'smoothTyping'>): Promise<TranscribeAndAskWithVoiceResponse>;
-    askWithVoiceResponse(agentId: AiAgentId, prompt: string, options?: Omit<AiAgentChatOptions, 'smoothTyping'>): Promise<AskWithVoiceResponse>;
-    askInternal<T>(agentId: AiAgentId, prompt: string | File, isVoiceResponse: boolean, options?: Omit<AiAgentChatOptions, 'smoothTyping'>): Promise<T>;
-    private handleChatResponse;
-    private handleStatusMessage;
-    private createStatusSubject;
-}
-export interface AiChatBotContextData {
-    title: string;
-    context: AiContext;
-}
-export interface AiChatBotContextDataWithId extends AiChatBotContextData {
-    id?: string;
-}
-export type AiAgentData = Pick<AiAgentMetadata, (typeof MUTABLE_AI_AGENT_METADATA_FIELDS)[number]>;
-export interface AiInstructionData {
-    instruction: string;
-}
-export declare class AiAgentReference {
-    private readonly client;
-    private readonly integrationId;
-    private readonly agentId;
-    /**
-     * Sends a prompt to the current agent.
-     *
-     * @param prompt - The prompt.
-     * @param options - The chat options.
-     * @returns An observable that emits when a new response token is received. The emitted value is the entire response
-     * that has been received so far.
-     */
-    chat(prompt: string, options?: AiAgentChatOptions): Observable<string>;
-    transcribeAndChat(fileToTranscribe: File, options?: AiAgentChatOptions): Promise<TranscribeAndChatResponse>;
-    /**
-     * Sends a prompt to the current agent and returns the response.
-     * @param prompt - The prompt.
-     * @param options - The chat options.
-     */
-    ask(prompt: string, options?: Omit<AiAgentChatOptions, 'smoothTyping'>): Promise<string>;
-    observeStatusUpdates(options?: AiObserveStatusOptions): Observable<AiStatusMessage>;
-    transcribeAndAsk(fileToTranscribe: File, options?: AskOptionsWithoutVoice): Promise<AiTranscribeAndAskResponse>;
-    transcribeAndAskWithVoiceResponse(fileToTranscribe: File, options?: Omit<AiAgentChatOptions, 'smoothTyping'>): Promise<TranscribeAndAskWithVoiceResponse>;
-    askWithVoiceResponse(prompt: string, options?: Omit<AiAgentChatOptions, 'smoothTyping'>): Promise<AskWithVoiceResponse>;
-    search(options: AiSearchOptions): Promise<AiSearchResponse>;
-    /**
-     * Retrieves a context reference for the current agent. A context reference can be used to add a new context entry
-     * to the agent, or update/delete an existing entry context.
-     *
-     * @param id - The id of the context entry. If no id is passed, an id will be
-     * generated and the reference will point to a new context entry.
-     * @returns The context reference.
-     */
-    context(id?: string): AiAgentContextReference;
-    insertContexts(contexts: Array<AiChatBotContextDataWithId>, files?: Array<File | BlobAndFilename>): Promise<void>;
-    /**
-     * Retrieves an instruction reference for the current agent. An instruction reference can be used to add a new
-     * instruction entry to the agent, or update/delete an existing instruction entry.
-     *
-     * @param id - The id of the instruction entry. If no id is passed, an id will be
-     * generated and the reference will point to a new instruction entry.
-     * @returns The instruction reference.
-     */
-    instruction(id?: string): AiAgentInstructionReference;
-    /**
-     * Creates a new AI Agent.
-     * This will result in an error if an agent already exists with the same id.
-     *
-     * @param data An object containing options for creating the agent.
-     * @param data.modelName - The name of the AI model (`gpt-3.5, `gpt-4`, `claude-3-5-sonnet-latest` or
-     *   `claude-3-5-haiku-latest`, `gemini-1.5-pro`, `gemini-2.0-flash`).
-     * @param data.isPublic - Whether the chat functionality of the agent can be accessed without security rules.
-     * @returns A promise that resolves when the agent is successfully created.
-     */
-    create(data: AiAgentData): Promise<void>;
-    /**
-     * Updates an existing agent.
-     * An error will be thrown if the agent has not yet been created for the current agent ID.
-     *
-     * @param data - An object containing options for updating the agent.
-     * @param data.modelName - The name of the OpenAI model (`gpt-3.5`, `gpt-4`, `claude-3-5-sonnet-latest`,
-     *   `claude-3-5-haiku-latest`, `gemini-1.5-pro`, `gemini-2.0-flash`).
-     * @param data.isPublic - Whether the chat functionality of the agent can be accessed without security rules.
-     * @param file - The file to upload (optional).
-     * @returns A promise that resolves when the agent is successfully updated.
-     */
-    update(data: Partial<AiAgentData>, file?: File | BlobAndFilename): Promise<void>;
-    /**
-     * Deletes an existing agent.
-     * Throws an error if the agent has not been created for the current agent ID.
-     *
-     * @returns A promise that resolves when the agent is successfully deleted.
-     */
-    delete(): Promise<void>;
-    feedback(feedback: string): Promise<void>;
-    resetFeedback(): Promise<void>;
-}
-export declare class AiAgentContextReference {
-    private readonly client;
-    private readonly integrationId;
-    private readonly agentId;
-    private readonly id;
-    /**
-     * Adds a new context entry to the agent.
-     * Throws an error if an entry with the same ID already exists.
-     *
-     * @param data - An object containing options for creating the entry.
-     * @param data.title - The title of the entry.
-     * @param data.context - The context data.
-     * @param file - The file to upload (optional).
-     * @returns A promise that resolves when the context entry is successfully created.
-     */
-    insert(data: AiChatBotContextData, file?: File | BlobAndFilename): Promise<void>;
-    /**
-     * Appends data to an existing context entry on the agent.
-     * This will result in an error if an entry is not found.
-     *
-     * @param data An object containing options for appending the entry.
-     * @param file - The file to append.
-     */
-    append(data: AiChatBotContextData, file?: File): Promise<void>;
-    /**
-     * Updates an existing context entry for the agent.
-     * Throws an error if an entry with the specified context ID does not exist.
-     *
-     * @param data - An object containing options for updating the entry.
-     * @param data.title - The title of the entry.
-     * @param data.context - The context data.
-     * @returns A promise that resolves when the context entry is successfully updated.
-     */
-    update(data: Partial<AiChatBotContextData>): Promise<void>;
-    /**
-     * Deletes an existing context entry for the agent.
-     * Throws an error if an entry with the specified context ID does not exist.
-     *
-     * @returns A promise that resolves when the context entry is successfully deleted.
-     */
-    delete(): Promise<void>;
-}
-export declare class AiAgentInstructionReference {
-    private readonly client;
-    private readonly integrationId;
-    private readonly agentId;
-    private readonly id;
-    /**
-     * Adds a new instruction entry to the agent.
-     * Throws an error if an entry with the same ID already exists.
-     *
-     * @param data - An object containing options for creating the entry.
-     * @param data.instruction - The instruction data.
-     * @returns A promise that resolves when the instruction entry is successfully created.
-     */
-    insert(data: AiInstructionData): Promise<void>;
-    /**
-     * Updates an existing instruction entry for the agent.
-     * Throws an error if an entry with the specified instruction ID does not exist.
-     *
-     * @param data - An object containing options for updating the entry.
-     * @param data.instruction - The instruction data.
-     * @returns A promise that resolves when the instruction entry is successfully updated.
-     */
-    update(data: AiInstructionData): Promise<void>;
-    /**
-     * Deletes an existing instruction entry for the agent.
-     * Throws an error if an entry with the specified instruction ID does not exist.
-     *
-     * @returns A promise that resolves when the instruction entry is successfully deleted.
-     */
-    delete(): Promise<void>;
-}