@squidcloud/client 1.0.482 → 1.0.483

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

@@ -1,3 +1,4 @@
+import { AiAgentMemoryOptions } from './ai-agent.public-types';
 import { AiQueryOptions } from './ai-query.public-types';
 import { AiAgentId } from './communication.public-types';
 /**
@@ -41,6 +42,12 @@ export interface AiApiOptions {
      * user prompt. Default 4.
      */
     maxIterations?: number;
+    /**
+     * Conversation memory configuration. When provided, prior user prompts and AI answers under the same `memoryId`
+     * are provided as additional context to the AI, enabling cross-prompt follow-ups
+     * Defaults to no memory.
+     */
+    memoryOptions?: AiAgentMemoryOptions;
 }
 /**
  * Configuration options for AI agent MCP integration.

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

@@ -843,6 +843,12 @@ export interface BaseUpsertContextStatus {
 export interface UpsertContextStatusSuccess extends BaseUpsertContextStatus {
     /** Whether the context upsert was successful or got an error. */
     status: 'success';
+    /**
+     * Set when the context was stored and is fully searchable (vector/keyword), but was NOT graph-indexed
+     * because the knowledge base is over its per-KB graph chunk cap. Only GraphRAG coverage is absent;
+     * surfaced so bulk operations can report which contexts fell outside the graph.
+     */
+    graphIndexingSkipped?: boolean;
 }
 /**
  * Machine-readable code identifying a specific upsert failure reason.

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

@@ -8,7 +8,7 @@ export declare const RERANK_PROVIDERS: readonly ["cohere", "none"];
  */
 export type AiRerankProvider = (typeof RERANK_PROVIDERS)[number];
 /** List of available AI provider types. See AiProviderType. */
-export declare const AI_PROVIDER_TYPES: readonly ["anthropic", "bedrock", "claude-code", "codex", "cohere", "flux", "gemini", "openai", "grok", "stability", "voyage", "mistral", "textract", "vertex", "external"];
+export declare const AI_PROVIDER_TYPES: readonly ["anthropic", "bedrock", "claude-code", "codex", "cohere", "flux", "gemini", "openai", "openai-compatible", "grok", "stability", "voyage", "mistral", "textract", "vertex", "external"];
 /**
  * Type of the AI provider.
  * References a single AI service, regardless of the model or other AI function it provides (like
@@ -29,7 +29,7 @@ export declare const OPENAI_CHAT_MODEL_NAMES: readonly ["gpt-5.4-mini", "gpt-5.4
  * Public Gemini chat model names (active models only).
  * @category AI
  */
-export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-3.1-pro", "gemini-3.5-flash", "gemini-3.1-flash-lite"];
+export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-3.1-pro", "gemini-3.6-flash", "gemini-3.5-flash-lite"];
 /**
  * Public Grok chat model names (active models only).
  * @category AI
@@ -39,12 +39,12 @@ export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-4.3", "grok-4-1-fast
  * Public Anthropic chat model names (active models only).
  * @category AI
  */
-export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-haiku-4-5-20251001", "claude-opus-4-8", "claude-sonnet-5"];
+export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-haiku-4-5-20251001", "claude-opus-5", "claude-sonnet-5"];
 /**
  * The supported AI model names.
  * @category AI
  */
-export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.5", "gpt-5.5-pro", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "claude-haiku-4-5-20251001", "claude-opus-4-8", "claude-sonnet-5", "gemini-3.1-pro", "gemini-3.5-flash", "gemini-3.1-flash-lite", "grok-4.3", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
+export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["gpt-5.4-mini", "gpt-5.4-nano", "gpt-5.5", "gpt-5.5-pro", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "claude-haiku-4-5-20251001", "claude-opus-5", "claude-sonnet-5", "gemini-3.1-pro", "gemini-3.6-flash", "gemini-3.5-flash-lite", "grok-4.3", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
 /** Checks if the given model name is a global AI chat model name.  */
 export declare function isVendorAiChatModelName(modelName: unknown): modelName is VendorAiChatModelName;
 /**

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

@@ -634,6 +634,12 @@ export interface AiKnowledgeBaseSearchResultChunk {
 export interface UpsertKnowledgeBaseContextResponse {
     /** List of the upsert status of each item sent in the request. */
     failure?: UpsertContextStatusError;
+    /**
+     * Set when the context was stored (and is fully searchable via vector/keyword) but NOT graph-indexed
+     * because the knowledge base is over its per-KB graph chunk cap. Only GraphRAG coverage is absent; the
+     * singular counterpart of {@link UpsertKnowledgeBaseContextsResponse.graphIndexingSkippedContextIds}.
+     */
+    graphIndexingSkipped?: boolean;
 }
 /**
  * Response structure for upserting contexts for an AiKnowledgeBase
@@ -652,6 +658,12 @@ export interface UpsertKnowledgeBaseContextsResponse {
      * `undefined` at runtime — callers must handle its absence rather than trust it is always populated.
      */
     contextIds?: Array<AiContextId>;
+    /**
+     * Contexts that were stored (and are fully searchable via vector/keyword) but NOT graph-indexed because
+     * the knowledge base is over its per-KB graph chunk cap. Only GraphRAG coverage is absent; surfaced so a
+     * caller can report the graph-coverage gap. Absent/empty when nothing was skipped or graph is disabled.
+     */
+    graphIndexingSkippedContextIds?: Array<AiContextId>;
 }
 /**
  * Request structure for searching an AiKnowledgeBase

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/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.

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/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/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.482";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.483";

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

@@ -17,8 +17,10 @@ export declare class WebClient {
      * @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, abortSignal?: AbortSignal): 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.
@@ -58,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.482",
+  "version": "1.0.483",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",