@squidcloud/client 1.0.481 → 1.0.482

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

@@ -1,4 +1,5 @@
-import { AiContextMetadata, AiContextMetadataFilter } from './ai-knowledge-base.public-types';
+import { AiContextMetadata } from './ai-knowledge-base.public-types';
+import { MetadataFilter } from './metadata-filter.public-types';
 /**
  * Represents a category in the matchmaker.
  * The description is used by the AI to extract features from the content.
@@ -56,7 +57,7 @@ export interface MmEntityMatch extends MmEntity {
  */
 export interface MmFindMatchesOptions {
     /** Optional metadata filter conditions to narrow down matching entities; defaults to none. */
-    metadataFilter?: AiContextMetadataFilter;
+    metadataFilter?: MetadataFilter;
     /** The maximum number of matches to return; defaults to 100, with a maximum of 100. */
     limit?: number;
     /** The category ID to match entities against; defaults to the next or first category in the matchmaker. */
@@ -68,7 +69,7 @@ export interface MmFindMatchesOptions {
  */
 export interface MmListEntitiesOptions {
     /** Optional metadata filter conditions to narrow down listed entities; defaults to none. */
-    metadataFilter?: AiContextMetadataFilter;
+    metadataFilter?: MetadataFilter;
     /** The maximum number of entities to return; defaults to 100. */
     limit?: number;
 }

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

@@ -4,7 +4,7 @@
  * 'CONNECTOR_PACKAGES_TO_EXCLUDE_FROM_AUTO_SYNC' in ConnectorsService (console-backend).
  * @category Platform
  */
-export declare const CONNECTOR_IDS: readonly ["confluence", "cotomi", "essentials", "freshdesk", "github", "google_calendar", "google_drive", "hubspot", "sharepoint", "jira", "jira_jsm", "linear", "mail", "onedrive", "salesforce", "servicenow_csm", "slack", "teams", "ticketmind_companion", "zendesk"];
+export declare const CONNECTOR_IDS: readonly ["confluence", "cotomi", "essentials", "freshdesk", "github", "google_calendar", "google_drive", "hubspot", "sharepoint", "jira", "jira_jsm", "linear", "mail", "onedrive", "outlook", "salesforce", "servicenow_csm", "slack", "teams", "ticketmind_companion", "zendesk"];
 /**
  * Unique connector package name.
  * @category Platform

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

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

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

@@ -1,6 +1,6 @@
 import { IntegrationId } from './communication.public-types';
 /** List of all integration types supported by Squid. */
-export declare const INTEGRATION_TYPES: readonly ["active_directory", "ai_agents", "ai_chatbot", "algolia", "alloydb", "api", "auth0", "bedrock", "azure_blob", "azure_cosmosdb", "azure_postgresql", "azure_sql", "bigquery", "built_in_azure_blob", "built_in_db", "built_in_gcs", "built_in_queue", "built_in_s3", "cassandra", "clickhouse", "cloudsql", "cockroach", "cognito", "connected_knowledgebases", "confluence", "confluent", "datadog", "db2", "descope", "documentdb", "azure-entra-external-id", "dynamodb", "elasticsearch", "firebase_auth", "firestore", "gcs", "github", "google_calendar", "google_docs", "google_drive", "graphql", "hubspot", "jira", "jira_jsm", "jwt_hmac", "jwt_rsa", "kafka", "keycloak", "linear", "mariadb", "monday", "mongo", "mssql", "databricks", "mysql", "newrelic", "okta", "onedrive", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce", "sap_hana", "sentry", "snowflake", "spanner", "xata", "zendesk", "servicenow_csm", "freshdesk", "mail", "slack", "mcp", "a2a", "legend", "teams", "openai_compatible", "openai_compatible_embedding", "sharepoint", "vertex"];
+export declare const INTEGRATION_TYPES: readonly ["active_directory", "ai_agents", "ai_chatbot", "algolia", "alloydb", "api", "auth0", "bedrock", "azure_blob", "azure_cosmosdb", "azure_postgresql", "azure_sql", "bigquery", "built_in_azure_blob", "built_in_db", "built_in_gcs", "built_in_queue", "built_in_s3", "cassandra", "clickhouse", "cloudsql", "cockroach", "cognito", "connected_knowledgebases", "confluence", "confluent", "datadog", "db2", "descope", "documentdb", "azure-entra-external-id", "dynamodb", "elasticsearch", "firebase_auth", "firestore", "gcs", "github", "google_calendar", "google_docs", "google_drive", "graphql", "hubspot", "jira", "jira_jsm", "jwt_hmac", "jwt_rsa", "kafka", "keycloak", "linear", "mariadb", "monday", "mongo", "mssql", "databricks", "mysql", "newrelic", "okta", "onedrive", "outlook", "oracledb", "pinecone", "postgres", "redis", "s3", "salesforce", "sap_hana", "sentry", "snowflake", "spanner", "xata", "zendesk", "servicenow_csm", "freshdesk", "mail", "slack", "mcp", "a2a", "legend", "teams", "openai_compatible", "openai_compatible_embedding", "sharepoint", "vertex"];
 /**
  * @category Database
  */

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

@@ -6,7 +6,9 @@
  * `$lte`, `$in`, `$nin`, `$exists`) and boolean combinators (`$and`, `$or`).
  *
  * Originally created for AI knowledge base context filtering, these types are now
- * shared across metrics tag filtering, matchmaking, and other subsystems.
+ * shared across metrics tag filtering, matchmaking, and other subsystems. Operators
+ * specific to one subsystem (e.g. the knowledge base's `$underPath` for hierarchical
+ * path scoping) live with that subsystem, not here.
  */
 /** Primitive metadata value. */
 export type MetadataValue = number | string | boolean | undefined;
@@ -57,7 +59,9 @@ export interface MetadataExistsFilter {
     /** Whether the field must exist. */
     $exists: boolean;
 }
-/** A single-field operator: one of `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$exists`. */
+/**
+ * A single-field operator: one of `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$exists`.
+ */
 export type MetadataSimpleFilter = MetadataEqFilter | MetadataNeFilter | MetadataGtFilter | MetadataGteFilter | MetadataLtFilter | MetadataLteFilter | MetadataInFilter | MetadataNinFilter | MetadataExistsFilter;
 /**
  * A filter for metadata based on field-specific conditions or direct values.

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, ListAiKnowledgeBaseContextsPageResponse, ListKnowledgeBaseContextsOptions, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
+import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResponse, AiKnowledgeBaseSearchResultChunk, ExploreKnowledgeBaseGraphRequest, ExploreKnowledgeBaseGraphResponse, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, GetKnowledgeBaseGraphStatusResponse, ListAiKnowledgeBaseContextsPageResponse, ListKnowledgeBaseContextsOptions, QueryKnowledgeBaseGraphRequest, QueryKnowledgeBaseGraphResponse, RebuildKnowledgeBaseGraphRequest, 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.
@@ -97,6 +97,39 @@ export declare class AiKnowledgeBaseReference {
     search(options: AiKnowledgeBaseChatOptions & {
         prompt: string;
     }): Promise<Array<AiKnowledgeBaseSearchResultChunk>>;
+    /**
+     * Like {@link search}, but returns the full response — including `graphContext` (the traversed
+     * subgraph) when the search ran with `searchMode: 'graph'` and `graphOptions.includeGraphContext`.
+     * {@link search} predates `graphContext` and keeps returning only the chunks.
+     */
+    searchWithGraphContext(options: AiKnowledgeBaseChatOptions & {
+        prompt: string;
+    }): Promise<AiKnowledgeBaseSearchResponse>;
+    /**
+     * Queries the knowledge base's graph (documents, entities, themes, facets) through the closed op set
+     * — overview / resolve / describe / subtree / docsUnder / conceptsOf / neighborhood / pathBetween /
+     * globalSummary. Requires `graphRag.enabled` on the knowledge base.
+     */
+    queryGraph(request: Omit<QueryKnowledgeBaseGraphRequest, 'knowledgeBaseId'>): Promise<QueryKnowledgeBaseGraphResponse>;
+    /**
+     * Returns the knowledge base's graph build/readiness status: counts, facets, staleness, the most
+     * recent rebuild job, and the graph's LLM token/cost usage (`ingestUsage`, `lastRebuildUsage`).
+     */
+    getGraphStatus(): Promise<GetKnowledgeBaseGraphStatusResponse>;
+    /**
+     * Enqueues a graph rebuild/backfill. The default `'full'` mode re-extracts every context with an
+     * LLM and rebuilds the concept layer (topics + facets); `mode: 'structural'` keeps the
+     * already-extracted entity graph (extracting only contexts never graph-indexed) and rebuilds just
+     * the concept layer — a small fraction of a full rebuild's LLM cost. Requires `graphRag.enabled`.
+     * Track progress via {@link getGraphStatus}'s `buildJob`; only one rebuild can run per knowledge
+     * base at a time.
+     */
+    rebuildGraph(request?: Omit<RebuildKnowledgeBaseGraphRequest, 'knowledgeBaseId'>): Promise<void>;
+    /**
+     * Returns a bounded slice of the knowledge base's entity graph (highest-degree entities and the
+     * relationships among them) for exploration/visualization. Requires `graphRag.enabled`.
+     */
+    exploreGraph(request?: Omit<ExploreKnowledgeBaseGraphRequest, 'knowledgeBaseId'>): Promise<ExploreKnowledgeBaseGraphResponse>;
     /**
      * Performs a semantic search in the knowledge base and returns contexts with reasoning.
      * Can be used for matchmaking or similarity search.

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

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

@@ -14,8 +14,11 @@ export declare class WebClient {
     /**
      * Search the web using AI. Returns a response containing Markdown text and cited URLs.
      * @param query The keywords or query string to search for.
+     * @param abortSignal Optional signal used to abort the underlying request. When the signal aborts, the in-flight
+     *                    HTTP request is cancelled and its promise rejects, allowing callers to bound a single call
+     *                    without leaking the request.
      */
-    aiSearch(query: string): Promise<WebAiSearchResponse>;
+    aiSearch(query: string, abortSignal?: AbortSignal): Promise<WebAiSearchResponse>;
     /**
      * Fetch content from a URL.
      * @param url The URL to fetch content from.

package/package.json

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