@squidcloud/client 1.0.481 → 1.0.483

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/ai-query.public-types.d.ts

@@ -214,6 +214,12 @@ export interface AiSpreadsheetQueryOptions {
     instructions?: string;
     /** Overrides the model used to answer the query. */
     model?: AiChatModelName;
+    /**
+     * Background gathered by the calling agent (facts from retrieved chunks, chat history, or earlier
+     * spreadsheet queries in the same conversation). Injected into the sub-agent's prompt as reference
+     * data — not as instructions — so it starts oriented instead of rediscovering the caller's context.
+     */
+    context?: string;
 }
 /**
  * Request for executing an AI-powered query over spreadsheet files.

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

@@ -121,6 +121,116 @@ export interface SpreadsheetSheetInfo {
      * Number of columns in the sheet.
      */
     columnCount: number;
+    /**
+     * Present and true when the sheet is hidden (or very-hidden) in the workbook. Hidden sheets are
+     * extracted like visible ones; the flag lets downstream surfaces say so. Omitted for visible
+     * sheets to keep the stored inventory JSON compact.
+     */
+    hidden?: boolean;
+    /** Cells whose value is computed by a formula. Omitted when zero, keeping the stored JSON compact. */
+    formulaCellCount?: number;
+    /** Merged ranges declared on the sheet. Omitted when zero. */
+    mergedRangeCount?: number;
+    /**
+     * Sheet-qualified references to this sheet from formulas on OTHER VISIBLE sheets. Omitted when
+     * zero. Raw evidence of "a live sheet reads this one", which is why references from hidden sheets
+     * are excluded — those are reported through {@link disconnected}, which walks them transitively.
+     */
+    inboundRefCount?: number;
+    /**
+     * Sheet-qualified references from this sheet's formulas to other sheets OF THIS WORKBOOK. Omitted
+     * when zero. External references (`[Book.xlsx]Sheet1!A1`) are not counted — except in a legacy
+     * .xls, whose formula text does not mark them (see {@link disconnected}), so a reference into
+     * another workbook's same-named sheet counts here.
+     */
+    outboundRefCount?: number;
+    /** Formulas on the sheet containing a `#REF!` error, the signature of deleted precedents. Omitted when zero. */
+    refErrorCount?: number;
+    /**
+     * Present and true when the sheet is hidden AND takes no part in the workbook's live dependency
+     * graph: nothing the live model reads leads to it, and it reads no visible sheet itself.
+     *
+     * Reachability, not adjacency: a hidden sheet read by another hidden sheet that a visible sheet
+     * reads is live, and the walk crosses as many hidden hops as the workbook has. It follows the READ
+     * direction only. A hidden staging or print sheet that merely reads the live model — downstream of
+     * it, not orphaned from it — is spared by that second clause, but sparing it does not spare what
+     * feeds IT: were liveness to flow backwards, one legacy tab still pointing at the current dashboard
+     * would carry its whole cluster of stale detail sheets back into the live set.
+     *
+     * Deliberately conservative on two further counts. It is never asserted for visible sheets, which
+     * are orphaned by design far more often than not (cover pages, chart tabs, mapping tables). And it
+     * remains a heuristic for "legacy", not a proof: `INDIRECT()`, defined-name and VBA/Power Query
+     * references are all invisible to a formula scan, so a hidden sheet reached only that way is a
+     * false positive. Consumers should present it as the evidence it is, never as a verdict.
+     *
+     * It is also under-reported in the legacy .xls container, where a parsed external reference keeps
+     * only the other workbook's sheet NAME: a link to the model this file was copied from can be
+     * credited to that file's own leftover copy of the sheet and spare it the flag. Missing orphans
+     * that way, never inventing them, is the direction this signal can afford to be wrong in.
+     */
+    disconnected?: boolean;
+    /**
+     * Up to a few representative formulas ("C5=SUM(B2:B4)") for the summary preview. NOT persisted in
+     * the bounded inventory JSON — preview-time only.
+     */
+    formulaSample?: Array<string>;
+}
+/**
+ * Workbook-level parts the per-sheet CSV dump cannot express, counted from the container index so
+ * the summary can SAY what it cannot show (chart-locked figures, pivot views, staleness of
+ * external-workbook cached values). Every field is omitted when zero/false.
+ */
+export interface SpreadsheetWorkbookFeatures {
+    /** Charts embedded in the workbook; chart data is not extracted. */
+    chartCount?: number;
+    /** Pivot tables; their computed views are not extracted. */
+    pivotTableCount?: number;
+    /** External-link parts (other workbooks, DDE, or OLE); linked cells carry last-cached values that may be stale. */
+    externalLinkCount?: number;
+    /** Sheets carrying cell comments/notes (not extracted). */
+    commentPartCount?: number;
+    /** The workbook contains VBA macros. */
+    hasVbaMacros?: boolean;
+}
+/** One data series of a chart, with its cached categories and values. */
+export interface SpreadsheetChartSeries {
+    /** The series name. */
+    name?: string;
+    /** The categories (x-axis labels) for the series. */
+    categories: Array<string>;
+    /** The numeric values for the series. */
+    values: Array<number>;
+    /**
+     * The series' true cached point count, present ONLY when extraction retained fewer points than the
+     * series actually declares. Without it, a consumer cannot tell a complete 8-point series apart from
+     * the first 8 points of a 12-point one, and would describe a January-December series as ending in
+     * August.
+     */
+    totalPointCount?: number;
+}
+/** One chart's cached content. Cached values are what the chart last rendered; formulas are not evaluated. */
+export interface SpreadsheetChartInfo {
+    /** The chart's title, when it declares one. */
+    title?: string;
+    /** The worksheet the chart is anchored to, when the relationship graph resolves it. */
+    sheetName?: string;
+    /** The chart's data series, in declaration order. */
+    series: Array<SpreadsheetChartSeries>;
+    /**
+     * The chart's true series count, present ONLY when extraction retained fewer series than the chart
+     * actually declares — so an omitted-series count is computed against what the chart HAS, not against
+     * what survived extraction's own cap.
+     */
+    totalSeriesCount?: number;
+}
+/** One pivot table's identity and fields. Displayed aggregates are NOT extracted — only what it is built from. */
+export interface SpreadsheetPivotInfo {
+    /** The pivot table name. */
+    name?: string;
+    /** The worksheet the pivot table is anchored to. */
+    sheetName?: string;
+    /** The field names used in the pivot table. */
+    fields: Array<string>;
 }
 /**
  * Structural information about a parseable spreadsheet document.
@@ -130,6 +240,12 @@ export interface SpreadsheetDocumentInfo {
      * The sheets of the spreadsheet, in workbook order.
      */
     sheets: Array<SpreadsheetSheetInfo>;
+    /** Workbook-level parts the CSV dump cannot express (best-effort; absent for CSV/TSV and .xls). */
+    features?: SpreadsheetWorkbookFeatures;
+    /** Charts with their cached series (best-effort; absent for .xls and when none exist). */
+    charts?: Array<SpreadsheetChartInfo>;
+    /** Pivot tables with their field names (best-effort; absent for .xls/.xlsb and when none exist). */
+    pivots?: Array<SpreadsheetPivotInfo>;
 }
 /**
  * The full result of extracting data from a document, including all pages and any extracted images.
@@ -247,6 +363,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/langgraph.public-types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Options for starting a new LangGraph run.
+ * @category AI
+ */
+export interface InvokeLangGraphOptions {
+    /** If provided, the run executes against this thread. If omitted, a new thread is created. */
+    threadId?: string;
+    /** Initial state for the run. */
+    input?: Record<string, unknown>;
+}
+/**
+ * Successful result of a LangGraph invocation.
+ * @category AI
+ */
+export interface InvokeLangGraphSuccessResult {
+    /** Always `true` on success. */
+    ok: true;
+    /** Thread the run executed against. */
+    threadId: string;
+    /** `completed` when the graph finished, `interrupted` when awaiting a resume. */
+    status: 'completed' | 'interrupted';
+    /** Final (or paused) state values. */
+    state: Record<string, unknown> | null;
+    /** Next nodes to execute. Empty when `status` is `completed`. */
+    next: string[];
+}
+/**
+ * Successful result of a getState call.
+ * @category AI
+ */
+export interface GetLangGraphStateSuccessResult {
+    /** Always `true` on success. */
+    ok: true;
+    /** Thread the state belongs to. */
+    threadId: string;
+    /** Current state values. */
+    state: Record<string, unknown> | null;
+    /** Next nodes to execute. Empty if the graph has completed. */
+    next: string[];
+}

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/internal-common/src/public-types/web.public-types.d.ts

@@ -4,6 +4,11 @@
 export interface WebAiSearchRequest {
     /** The search query. */
     query: string;
+    /**
+     * When provided, restricts the web search to these domains (subdomains are included).
+     * Cited URLs in the response are guaranteed to belong to one of the listed domains.
+     */
+    allowedDomains?: Array<string>;
 }
 /**
  * Represents a cited URL in the search response.

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/index.d.ts

@@ -33,6 +33,7 @@ export * from './extraction-client';
 export * from './file-args-transformer';
 export * from './integration-client';
 export * from './job-client';
+export * from './langgraph-client';
 export * from './management-client';
 export * from './mutation/mutation-sender';
 export * from './native-query-manager';

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

@@ -0,0 +1,62 @@
+import { JobId } from '../../internal-common/src/public-types/job.public-types';
+import { GetLangGraphStateSuccessResult, InvokeLangGraphOptions, InvokeLangGraphSuccessResult } from '../../internal-common/src/public-types/langgraph.public-types';
+/**
+ * Reference to a specific LangGraph.
+ * @category AI
+ */
+export declare class LangGraphReference {
+    private readonly graphId;
+    private readonly rpcManager;
+    private readonly jobClient;
+    /**
+     * Starts a new LangGraph run and waits for the result.
+     *
+     * For very long graphs where you don't want to hold a Promise, use `invokeAsync()` instead.
+     *
+     * Note: graph execution caps at the tenant IPC timeout (currently 4 minutes).
+     *
+     * @param options Initial state and optional thread to run against.
+     */
+    invoke(options?: InvokeLangGraphOptions): Promise<InvokeLangGraphSuccessResult>;
+    /**
+     * Starts a new LangGraph run without waiting for the result.
+     * Returns a jobId — pass it to `squid.job().awaitJob(jobId)` or `getJob(jobId)` to retrieve the result later.
+     *
+     * Use this for graphs that may run longer than is comfortable to hold a Promise for.
+     *
+     * Note: the underlying graph execution still caps at the tenant IPC timeout (currently 4 minutes)
+     *
+     * @param options Initial state and optional thread to run against.
+     */
+    invokeAsync(options?: InvokeLangGraphOptions): Promise<JobId>;
+    /**
+     * Resumes an interrupted LangGraph thread and waits for the result.
+     * The thread must currently be in `interrupted` status.
+     *
+     * Note: graph execution caps at the tenant IPC timeout (currently 4 minutes).
+     *
+     * @param threadId The thread to resume.
+     * @param resumePayload Value passed to the `interrupt()` call inside the graph.
+     */
+    resume(threadId: string, resumePayload: unknown): Promise<InvokeLangGraphSuccessResult>;
+    /**
+     * Resumes an interrupted LangGraph thread without waiting for the result.
+     * Returns a jobId — pass it to `squid.job().awaitJob(jobId)` or `getJob(jobId)` to retrieve the result later.
+     *
+     * Note: graph execution caps at the tenant IPC timeout (currently 4 minutes)
+     *
+     * @param threadId The thread to resume.
+     * @param resumePayload Value passed to the `interrupt()` call inside the graph.
+     */
+    resumeAsync(threadId: string, resumePayload: unknown): Promise<JobId>;
+    /** Returns the current state of a LangGraph thread. */
+    getState(threadId: string): Promise<GetLangGraphStateSuccessResult>;
+    /**
+     * Deletes all checkpoints for the given thread on this graph. Idempotent — succeeds on a
+     * nonexistent thread. After deletion, `getState(threadId)` returns an empty state and any
+     * subsequent `invoke`/`resume` on the same threadId starts fresh with no prior history.
+     *
+     * @param threadId The thread to delete.
+     */
+    deleteThread(threadId: string): Promise<void>;
+}

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

@@ -20,6 +20,7 @@ export * from '../../internal-common/src/public-types/extraction.public-types';
 export * from '../../internal-common/src/public-types/http-status.public-types';
 export * from '../../internal-common/src/public-types/integration.public-types';
 export * from '../../internal-common/src/public-types/job.public-types';
+export * from '../../internal-common/src/public-types/langgraph.public-types';
 export * from '../../internal-common/src/public-types/metadata-filter.public-types';
 export * from '../../internal-common/src/public-types/metric.public-types';
 export * from '../../internal-common/src/public-types/openapi.public-types';

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

@@ -9,6 +9,7 @@ import { ExecuteFunctionOptions } from './execute-function-options';
 import { ExternalAuthClient } from './external-auth-client';
 import { ExtractionClient } from './extraction-client';
 import { JobClient } from './job-client';
+import { LangGraphReference } from './langgraph-client';
 import { NotificationClient } from './notification-client';
 import { ObservabilityClient } from './observability-client';
 import { ApiKey, AppId, CollectionName, DocumentData, EnvironmentId, IntegrationId, SquidDeveloperId, SquidRegion } from './public-types';
@@ -123,6 +124,7 @@ export declare class Squid {
     private readonly querySender;
     private readonly aiClient;
     private readonly jobClient;
+    private readonly langGraphClient;
     private readonly apiClient;
     private readonly adminClient;
     private readonly webClient;
@@ -329,6 +331,10 @@ export declare class Squid {
      * Returns a set of functionality for interacting with jobs.
      */
     job(): JobClient;
+    /**
+     * Returns a reference to a LangGraph by ID.
+     */
+    langGraph(graphId: string): LangGraphReference;
     /**
      * Returns a set of functionality for interacting with API integrations.
      */

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.483";

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

@@ -14,8 +14,13 @@ 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.
+     * @param allowedDomains Optional list of domains the search is restricted to (subdomains included). When provided,
+     *                       every cited URL in the response belongs to one of the listed domains.
      */
-    aiSearch(query: string): Promise<WebAiSearchResponse>;
+    aiSearch(query: string, abortSignal?: AbortSignal, allowedDomains?: Array<string>): Promise<WebAiSearchResponse>;
     /**
      * Fetch content from a URL.
      * @param url The URL to fetch content from.
@@ -55,4 +60,10 @@ export declare class WebClient {
      * @param ids The IDs of the shortened URL to delete.
      */
     deleteShortUrls(ids: string[]): Promise<void>;
+    /**
+     * POSTs a short URL request to the console `openapi/sqd/<op>` endpoint.
+     * With `'json'` the response body is read and returned parsed; with `'ignore'` it is never read.
+     * Only use after asserting apiKey is defined.
+     */
+    private postShortUrlApi;
 }

package/package.json

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