@squidcloud/client 1.0.479 → 1.0.480

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

@@ -563,6 +563,46 @@ export interface ListAiKnowledgeBaseContextsResponse {
     /** The list of AiKnowledgeBaseContexts */
     contexts: Array<AiKnowledgeBaseContext>;
 }
+/**
+ * Options for {@link AiKnowledgeBaseReference.listContextsPage}
+ * @category AI
+ */
+export interface ListKnowledgeBaseContextsOptions {
+    /** The number of characters after which text is truncated. Optional */
+    truncateTextAfter?: number;
+    /** The number of contexts to skip, for pagination. Optional */
+    offset?: number;
+    /** The maximum number of contexts to return, for pagination. Optional */
+    limit?: number;
+    /** Case-insensitive substring search across id/title only. Optional */
+    search?: string;
+}
+/**
+ * API request for listing a page of AiKnowledgeBaseContexts
+ * @category AI
+ */
+export interface ListAiKnowledgeBaseContextsPageRequest {
+    /** The id of the AiKnowledgeBase */
+    id: string;
+    /** The number of characters after which text is truncated. Optional */
+    truncateTextAfter?: number;
+    /** The number of contexts to skip, for pagination. Optional */
+    offset?: number;
+    /** The maximum number of contexts to return, for pagination. Optional */
+    limit?: number;
+    /** Case-insensitive substring search across id/title only. Optional */
+    search?: string;
+}
+/**
+ * API response to list a page of AiKnowledgeBaseContexts
+ * @category AI
+ */
+export interface ListAiKnowledgeBaseContextsPageResponse {
+    /** The list of AiKnowledgeBaseContexts */
+    contexts: Array<AiKnowledgeBaseContext>;
+    /** The total number of contexts in the AiKnowledgeBase, ignoring offset/limit */
+    totalCount: number;
+}
 /**
  * API response for searching an AiKnowledgeBase
  * @category AI

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

@@ -247,6 +247,6 @@ export interface DocumentMetadata {
     docCreatedAt?: string;
     /** Last-modified timestamp, ISO 8601. */
     docModifiedAt?: string;
-    /** Source document type: `pdf` | `docx` | `pptx` | `xlsx` | `md` | `html` | `txt`. */
+    /** Source document type: `pdf` | `docx` | `pptx` | `xlsx` | `eml` | `msg` | `md` | `html` | `txt`. */
     docType?: string;
 }

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

@@ -1,4 +1,4 @@
-import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResultChunk, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
+import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResultChunk, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, ListAiKnowledgeBaseContextsPageResponse, ListKnowledgeBaseContextsOptions, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
 import { AiContextId } from '../../../internal-common/src/public-types/communication.public-types';
 /**
  * Parameters for creating or updating an AI agent.
@@ -6,6 +6,18 @@ import { AiContextId } from '../../../internal-common/src/public-types/communica
  * @category AI
  */
 export type UpsertKnowledgeBaseRequestParams = Omit<AiKnowledgeBase, 'id'>;
+/**
+ * Options for upserting knowledge base contexts.
+ * @category AI
+ */
+export interface UpsertContextsOptions {
+    /**
+     * Called once the request payload has been uploaded and accepted by the server.
+     * Server-side ingestion (extraction, embedding) continues after this callback; the returned
+     * promise resolves only when ingestion completes.
+     */
+    onUploaded?: () => void;
+}
 /**
  * A reference to an AI knowledge base.
  */
@@ -43,8 +55,16 @@ export declare class AiKnowledgeBaseReference {
     delete(): Promise<void>;
     /**
      * Lists all contexts associated with the knowledge base.
+     * @deprecated Fetches every context in one call with no pagination — expensive for large knowledge
+     * bases. Use {@link listContextsPage} instead, which supports `offset`/`limit`/`search`.
      */
     listContexts(truncateTextAfter?: number): Promise<Array<AiKnowledgeBaseContext>>;
+    /**
+     * Lists contexts associated with the knowledge base, paginated via `offset`/`limit` and optionally
+     * filtered via `search` (case-insensitive substring match on id/title only).
+     * @returns The requested page of contexts, plus `totalCount` (ignoring `offset`/`limit`).
+     */
+    listContextsPage(options?: ListKnowledgeBaseContextsOptions): Promise<ListAiKnowledgeBaseContextsPageResponse>;
     /**
      * Lists the ids for all contexts associated with the knowledge base.
      */
@@ -70,7 +90,7 @@ export declare class AiKnowledgeBaseReference {
      * generates one and rejects the request if identical content already exists in the knowledge base
      * (content-level dedup). Requests that carry an explicit `contextId` overwrite that context unconditionally.
      */
-    upsertContexts(contextRequests: Array<AiKnowledgeBaseContextRequest>, files?: Array<File>): Promise<UpsertKnowledgeBaseContextsResponse>;
+    upsertContexts(contextRequests: Array<AiKnowledgeBaseContextRequest>, files?: Array<File>, options?: UpsertContextsOptions): Promise<UpsertKnowledgeBaseContextsResponse>;
     /**
      * Performs a semantic search in the knowledge base and returns chunks from the different contexts.
      */

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

package/package.json

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