@squidcloud/client 1.0.410 → 1.0.412

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

@@ -1,7 +1,8 @@
 import { Observable } from 'rxjs';
-import { AiAgent, AiChatMessage, AiConnectedAgentMetadata, AiSearchOptions, AiSearchResultChunk, AiStatusMessage, AiTranscribeAndAskResponse, GuardrailsOptions, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.public-types';
+import { AiAgent, AiChatMessage, AiConnectedAgentMetadata, AiSearchOptions, AiSearchResultChunk, AiStatusMessage, AiTranscribeAndAskResponse, AllAiAgentChatOptions, GuardrailsOptions, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.public-types';
 import { AiChatModelName } from '../../../internal-common/src/public-types/ai-common.public-types';
 import { JobId } from '../../../internal-common/src/public-types/job.public-types';
+import { Paths } from '../../../internal-common/src/public-types/typescript.public-types';
 import { AiAskOptions, AiAskOptionsWithVoice, AiChatOptionsWithoutVoice, AskResponse, AskWithVoiceResponse, TranscribeAndAskWithVoiceResponse, TranscribeAndChatResponse } from './ai-agent-client.types';
 /**
  * Parameters for creating or updating an AI agent.
@@ -21,6 +22,7 @@ export declare class AiAgentReference {
     private readonly rpcManager;
     private readonly socketManager;
     private readonly jobClient;
+    private readonly backendFunctionManager;
     /**
      * Retrieves metadata and configuration of the AI agent.
      */
@@ -45,14 +47,6 @@ export declare class AiAgentReference {
      * Updates the list of agents connected to this agent.
      */
     updateConnectedAgents(connectedAgents: Array<AiConnectedAgentMetadata>): Promise<void>;
-    /**
-     * Sends user feedback to the agent.
-     */
-    provideFeedback(feedback: string): Promise<void>;
-    /**
-     * Resets any feedback previously provided to the agent.
-     */
-    resetFeedback(): Promise<void>;
     /**
      * Updates the agent's guardrails with the provided options.
      */
@@ -96,13 +90,6 @@ export declare class AiAgentReference {
      *   knows it can look up the job’s status.
      */
     ask<T extends AiChatModelName | undefined = undefined>(prompt: string, options?: AiAskOptions<T>, jobId?: JobId): Promise<string>;
-    /**
-     * Helper to replace ${id:fileId} tags in the AI output with their corresponding Markdown.
-     * @param aiResponse
-     * @param annotations
-     * @private
-     */
-    private replaceFileTags;
     /**
      * Sends a prompt and returns the string response and file annotations.
      * @param prompt The text prompt to send to the agent.
@@ -159,6 +146,23 @@ export declare class AiAgentReference {
      *   knows it can look up the job’s status.
      */
     askWithVoiceResponse<T extends AiChatModelName | undefined>(prompt: string, options?: AiAskOptionsWithVoice<T>, jobId?: JobId): Promise<AskWithVoiceResponse>;
+    /**
+     * Sets a value at a specific path within the agent's options.
+     */
+    setAgentOptionInPath(path: Paths<AllAiAgentChatOptions> | string, value: unknown): Promise<void>;
+    /**
+     * Submits a feedback string for the agent. Requires an API Key.
+     * This feedback may update the agent's instructions, connected integrations, and may be forwarded to connected agents.
+     * @param feedback The feedback to provide for the agent.
+     */
+    provideFeedback(feedback: string): Promise<string>;
+    /**
+     * Helper to replace ${id:fileId} tags in the AI output with their corresponding Markdown.
+     * @param aiResponse
+     * @param annotations
+     * @private
+     */
+    private replaceFileTags;
     private askInternal;
     private chatInternal;
 }

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

@@ -10,6 +10,7 @@ export declare class AiAgentClient {
     private readonly rpcManager;
     private readonly socketManager;
     private readonly jobClient;
+    private readonly backendFunctionManager;
     private readonly ongoingChatSequences;
     /**
      * Retrieves an instance of AiAgentReference for a specific agent ID.

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

@@ -16,6 +16,7 @@ export declare class AiClient {
     private readonly socketManager;
     private readonly rpcManager;
     private readonly jobClient;
+    private readonly backendFunctionManager;
     private readonly aiAssistantClient;
     private aiAgentClient?;
     private aiKnowledgeBaseClient?;

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

@@ -36,7 +36,7 @@ export declare class AiKnowledgeBaseReference {
     /**
      * Lists all contexts associated with the knowledge base.
      */
-    listContexts(): Promise<Array<AiKnowledgeBaseContext>>;
+    listContexts(truncateTextAfter?: number): Promise<Array<AiKnowledgeBaseContext>>;
     /**
      * Lists the ids for all contexts associated with the knowledge base.
      */

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

@@ -70,7 +70,6 @@ export declare class DocumentReference<T extends DocumentData = any> {
      * @returns Whether the locally available version of the document may not be the latest version on the server.
      */
     isDirty(): boolean;
-    private isTracked;
     /**
      * Updates the document with the given data.
      * The `update` will be reflected optimistically locally and will be applied to the server later.
@@ -147,5 +146,6 @@ export declare class DocumentReference<T extends DocumentData = any> {
      *   immediately.
      */
     delete(transactionId?: TransactionId): Promise<void>;
+    private isTracked;
     private hasSquidPlaceholderId;
 }

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

@@ -27,7 +27,15 @@ export declare class IntegrationClient {
      * @param integrationId - The ID of the integration to retrieve.
      * @returns A promise that resolves with the integration schema, or `undefined` if not found.
      */
-    getIntegrationSchema<ConfigurationType = Record<string, any>>(integrationId: IntegrationId): Promise<IntegrationInfo<ConfigurationType> | undefined>;
+    getIntegrationSchema<SchemaType = Record<string, any>>(integrationId: IntegrationId): Promise<SchemaType | undefined>;
+    /**
+     * Sets the integration's schema by its ID.
+     *
+     * @param integrationId - The ID of the integration to update.
+     * @param schema - The schema to set for the integration.
+     * @returns A promise that resolves when the schema has been updated.
+     */
+    setIntegrationSchema<SchemaType = Record<string, any>>(integrationId: IntegrationId, schema: SchemaType): Promise<void>;
     /**
      * Deletes the integration with the given ID.
      *

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

@@ -293,7 +293,6 @@ export declare class GroupedJoin<Aliases extends Record<Alias, Alias[]>, ReturnT
     peek(): Array<Grouped<Aliases, WithDocumentReferences<ReturnType>, RootAlias>>;
     /** @inheritDoc */
     dereference(): SnapshotEmitter<Grouped<Aliases, ReturnType, RootAlias>>;
-    private groupData;
     /** @inheritDoc */
     getSortOrders(): Array<FieldSort<any>>;
     /** @inheritDoc */
@@ -313,4 +312,5 @@ export declare class GroupedJoin<Aliases extends Record<Alias, Alias[]>, ReturnT
      * @returns A {@link Pagination} object for fetching paginated results.
      */
     paginate(options?: Partial<PaginationOptions>): Pagination<Grouped<Aliases, WithDocumentReferences<ReturnType>, RootAlias>>;
+    private groupData;
 }

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

@@ -36,15 +36,8 @@ export declare class Pagination<ReturnType> {
     private onFirstPage;
     private navigatingToLastPage;
     private lastElement;
-    private goToFirstPage;
-    private compareObjects;
-    private dataReceived;
-    private doNewQuery;
-    private waitForInternalState;
-    private internalStateToState;
     /** Unsubscribes from the pagination. */
     unsubscribe(): void;
-    private prevInternal;
     /** Returns a promise that resolves when the previous page of data is available. */
     prev(): Promise<PaginationState<ReturnType>>;
     /** Returns a promise that resolves when the next page of data is available. */
@@ -62,4 +55,11 @@ export declare class Pagination<ReturnType> {
      * underlying query, regardless of whether the total document count is evenly divisible by the page size.
      */
     last(): Promise<PaginationState<ReturnType>>;
+    private goToFirstPage;
+    private compareObjects;
+    private dataReceived;
+    private doNewQuery;
+    private waitForInternalState;
+    private internalStateToState;
+    private prevInternal;
 }

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

@@ -20,14 +20,6 @@ export interface HasDereference {
  *  @category Database
  */
 export declare abstract class BaseQueryBuilder<MyDocType extends DocumentData> {
-    /**
-     * Adds a condition to the query.
-     * @param fieldName The name of the field to query.
-     * @param operator The operator to use.
-     * @param value The value to compare against.
-     * @returns The query builder.
-     */
-    abstract where(fieldName: (keyof MyDocType & FieldName) | string, operator: Operator | 'in' | 'not in', value: PrimitiveFieldType | Array<PrimitiveFieldType>): this;
     /**
      * A shortcut for `where(fieldName, '==', value)`
      *
@@ -131,6 +123,14 @@ export declare abstract class BaseQueryBuilder<MyDocType extends DocumentData> {
      * @returns The query builder.
      */
     arrayNotIncludes(fieldName: (keyof MyDocType & FieldName) | string, values: Array<PrimitiveFieldType>): this;
+    /**
+     * Adds a condition to the query.
+     * @param fieldName The name of the field to query.
+     * @param operator The operator to use.
+     * @param value The value to compare against.
+     * @returns The query builder.
+     */
+    abstract where(fieldName: (keyof MyDocType & FieldName) | string, operator: Operator | 'in' | 'not in', value: PrimitiveFieldType | Array<PrimitiveFieldType>): this;
     /**
      * Sets a limit to the number of results returned by the query. The maximum limit is 20,000 and the default is 1,000
      * if none is provided.
@@ -165,6 +165,13 @@ export declare class QueryBuilder<DocumentType extends DocumentData> extends Bas
     private readonly queryBuilderFactory;
     private readonly documentIdentityService;
     private forceFetchFromServer;
+    /**
+     * A unique hash for the query. Identical queries should return the same hash
+     * value.
+     *
+     * @returns The query's hash string.
+     */
+    get hash(): string;
     /** @inheritDoc */
     where(fieldName: (keyof DocumentType & FieldName) | string, operator: Operator, value: PrimitiveFieldType | Array<PrimitiveFieldType>): this;
     /** @inheritDoc */
@@ -175,7 +182,6 @@ export declare class QueryBuilder<DocumentType extends DocumentData> extends Bas
     sortBy(fieldName: (keyof DocumentType & FieldName) | string, asc?: boolean): this;
     /** @inheritDoc */
     build(): Query;
-    private mergeConditions;
     getSortOrder(): FieldSort<DocumentType>[];
     /**
      * @inheritDoc
@@ -198,13 +204,6 @@ export declare class QueryBuilder<DocumentType extends DocumentData> extends Bas
      * @inheritDoc
      */
     changes(): Observable<Changes<DocumentType>>;
-    /**
-     * A unique hash for the query. Identical queries should return the same hash
-     * value.
-     *
-     * @returns The query's hash string.
-     */
-    get hash(): string;
     /** @inheritDoc */
     dereference(): SnapshotEmitter<DocumentType>;
     getSortOrders(): Array<FieldSort<any>>;
@@ -213,6 +212,7 @@ export declare class QueryBuilder<DocumentType extends DocumentData> extends Bas
     flipSortOrder(): QueryBuilder<DocumentType>;
     serialize(): SerializedSimpleQuery;
     paginate(options?: Partial<PaginationOptions>): Pagination<DocumentReference<DocumentType>>;
+    private mergeConditions;
 }
 /**
  * Describes the changes to a query result.

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

@@ -6,6 +6,12 @@ import { SecretEntry, SecretKey, SecretValue, SetSecretRequestEntry } from './pu
  */
 export declare class SecretClient {
     private readonly rpcManager;
+    /**
+     * Provides access to API key secret management operations.
+     *
+     * @returns An instance of {@link ApiKeysSecretClient} for managing API keys.
+     */
+    get apiKeys(): ApiKeysSecretClient;
     /**
      * Retrieves a stored custom secret by its key.
      *
@@ -54,12 +60,6 @@ export declare class SecretClient {
      * @returns A promise that resolves when the deletion request is complete.
      */
     deleteMany(keys: Array<SecretKey>, force?: boolean): Promise<void>;
-    /**
-     * Provides access to API key secret management operations.
-     *
-     * @returns An instance of {@link ApiKeysSecretClient} for managing API keys.
-     */
-    get apiKeys(): ApiKeysSecretClient;
 }
 /**
  * ApiKeysSecretClient manages API key secrets, providing methods

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

package/package.json

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