@squidcloud/client 1.0.484 → 1.0.486

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

@@ -1,5 +1,5 @@
 import { JSONSchema } from 'json-schema-typed';
-import { AiAudioCreateSpeechModelName, AiAudioTranscriptionModelName, AiChatModelName, AiImageModelName, AiProviderType, AiRerankProvider, AnthropicChatModelName, GeminiChatModelName, GrokChatModelName, ModelIdSpec, OpenAiAudioCreateSpeechModelName, OpenAiAudioTranscriptionModelName, OpenAiChatModelName, OpenAiCreateSpeechFormat, OpenAiImageModelName } from './ai-common.public-types';
+import { AiAudioCreateSpeechModelName, AiAudioTranscriptionModelName, AiChatModelName, AiImageModelName, AiProviderType, AiRerankProvider, AnthropicChatModelName, CanonicalReasoningEffort, GeminiChatModelName, GrokChatModelName, ModelIdSpec, OpenAiAudioCreateSpeechModelName, OpenAiAudioTranscriptionModelName, OpenAiChatModelName, OpenAiCreateSpeechFormat, OpenAiImageModelName } from './ai-common.public-types';
 import { AiContextMetadata, AiContextMetadataFilter, AiKnowledgeBaseContextType, AiRagType } from './ai-knowledge-base.public-types';
 import { AiFunctionId, AiFunctionIdWithContext, UserAiChatModelName } from './backend.public-types';
 import { AiAgentId, AiContextId, AiKnowledgeBaseId, AppId, IntegrationId } from './communication.public-types';
@@ -153,11 +153,12 @@ export type ApiKeySource = 'user' | 'system';
 /**
  * Structured output format configuration for AI models that support schema-constrained responses.
  *
- * When used with supported models,
- * this guarantees that responses will strictly conform to the provided JSON schema through
- * constrained decoding - the model cannot generate tokens that violate the schema.
+ * The schema is sent to the model's provider, which constrains decoding to it - the model cannot
+ * generate tokens that violate the schema, so the response conforms to it exactly.
  *
- * If the model does not support structured output, the response format will default to 'json_object'.
+ * A schema the provider rejects is reported as a `400` carrying its diagnostic, and a model whose
+ * protocol cannot carry a schema at all refuses the request with `STRUCTURED_OUTPUT_NOT_SUPPORTED`
+ * rather than answering without the shape that was asked for.
  * **Example:**
  * ```typescript
  * {
@@ -175,13 +176,13 @@ export type ApiKeySource = 'user' | 'system';
  * ```
  *
  * @see https://docs.anthropic.com/en/docs/build-with-claude/structured-outputs
+ * @see https://platform.openai.com/docs/guides/structured-outputs
+ * @see https://ai.google.dev/gemini-api/docs/structured-output
+ * @see https://docs.x.ai/docs/guides/structured-outputs
  * @category AI
  */
 export interface AiStructuredOutputFormat {
-    /**
-     * The type of structured output.
-     * Currently only 'json_schema' is supported by Anthropic models.
-     */
+    /** The type of structured output. 'json_schema' is the only one. */
     type: 'json_schema';
     /**
      * The JSON schema that the AI response must strictly conform to.
@@ -195,12 +196,19 @@ export interface AiStructuredOutputFormat {
  * **Available formats:**
  * - `'text'`: Plain text response (default) - standard conversational output
  * - `'json_object'`: JSON response - model attempts to return valid JSON, but without strict schema validation
- * - `AiStructuredOutputFormat`: Structured output with schema (Anthropic only) - guarantees JSON conforms exactly to provided schema
+ * - `AiStructuredOutputFormat`: Structured output with schema - guarantees JSON conforms exactly to provided schema
  *
- * **Structured outputs (Anthropic-specific):**
- * For Anthropic models that support structured outputs, you can pass an object with `type: 'json_schema'`
- * and a JSON schema. This uses constrained decoding to guarantee the response matches your schema perfectly,
- * eliminating parsing errors and validation issues.
+ * **Structured outputs:**
+ * Pass an object with `type: 'json_schema'` and a JSON schema. The schema travels to the model's
+ * provider, which constrains decoding to it, so the response matches the schema perfectly and
+ * parsing or validating it again is unnecessary. A schema the provider rejects comes back as a
+ * `400` carrying its diagnostic.
+ *
+ * Every vendor model carries a schema. The exception is a model whose protocol has no field for
+ * one — the CLI agents (`claude-code`, `codex`) and models a customer serves through
+ * `@llmService` — where such a request is refused with `STRUCTURED_OUTPUT_NOT_SUPPORTED` rather
+ * than answered without the shape it asked for. Use `'json_object'` and state the shape in the
+ * prompt for those.
  *
  * **Example with structured output:**
  * ```typescript
@@ -306,7 +314,10 @@ export interface AiConnectedKnowledgeBaseMetadata {
     knowledgeBaseId: AiKnowledgeBaseId;
     /** A description of when to use this AiKnowledgeBase */
     description: string;
-    /** Whether to include document metadata when providing KB search results to the agent. Defaults to false. */
+    /**
+     * Whether to include document metadata when providing this KB's results to the agent — both chunk
+     * search results and literal-scan matches. Defaults to false.
+     */
     includeMetadata?: boolean;
     /**
      * When true, the chat agent gets a tool to enumerate/search this KB's metadata field values on
@@ -450,7 +461,11 @@ export interface BaseAiChatOptions {
     enablePromptRewriteForRag?: boolean;
     /** Whether to include references from the source context in the response. Default to false. */
     includeReference?: boolean;
-    /** The format of the response from the AI model. Note that not all models support JSON format. Default to  'text'. */
+    /**
+     * The format of the response from the AI model. Defaults to 'text'. A `json_schema` format is
+     * refused for a model whose provider has no way to carry a schema — see
+     * {@link AiAgentResponseFormat}.
+     */
     responseFormat?: AiAgentResponseFormat;
     /** Whether to response in a "smooth typing" way, beneficial when the chat result is displayed in a UI. Default to true. */
     smoothTyping?: boolean;
@@ -520,7 +535,8 @@ export interface BaseAiChatOptions {
      * Use `low` for brief responses, `medium` for balanced detail, or `high` for comprehensive explanations.
      * Default: 'medium'.
      *
-     * Note: this parameter is only supported by OpenAI plain text responses and is ignored for others.
+     * Note: this parameter is only supported by OpenAI and is ignored for others. It applies to every
+     * response format, including `json_object` and `json_schema`.
      * For other providers ask about verbosity in prompt and using `maxOutputTokens`.
      */
     verbosity?: AiVerbosityLevel;
@@ -575,7 +591,7 @@ export interface OpenAiChatOptions extends BaseAiChatOptions {
  * not support the exact requested level.
  * @category AI
  */
-export type CanonicalReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export type { CanonicalReasoningEffort } from './ai-common.public-types';
 /**
  * AI reasoning effort. Pass one of the canonical levels for portable, autocomplete-friendly usage, or
  * a raw provider-native string when a model exposes a level outside the canonical set.
@@ -660,6 +676,56 @@ export type AiChatOptions<T extends AiChatModelSelection | undefined = undefined
 export type AllAiAgentChatOptions = {
     [K in keyof BaseAiChatOptions | keyof GeminiChatOptions | keyof GrokChatOptions | keyof OpenAiChatOptions | keyof AnthropicChatOptions]?: (K extends keyof BaseAiChatOptions ? BaseAiChatOptions[K] : never) | (K extends keyof GeminiChatOptions ? GeminiChatOptions[K] : never) | (K extends keyof GrokChatOptions ? GrokChatOptions[K] : never) | (K extends keyof OpenAiChatOptions ? OpenAiChatOptions[K] : never) | (K extends keyof AnthropicChatOptions ? AnthropicChatOptions[K] : never);
 };
+/**
+ * Configuration for exposing an AI agent as an MCP server at `/mcp/<agentId>`.
+ * @category AI
+ */
+export interface AiAgentMcpServerConfig {
+    /** Whether the agent is exposed as an MCP server. */
+    enabled: boolean;
+    /**
+     * Description of the MCP server, served as the `instructions` field of the MCP initialize
+     * result. Defaults to the agent description when not provided.
+     */
+    description?: string;
+    /**
+     * Description of the MCP `ask` tool, exposed in the tools manifest.
+     * Defaults to a generic ask-the-agent description when not provided.
+     */
+    toolDescription?: string;
+    /**
+     * ID of an auth integration used to OAuth-protect the MCP server. When set, MCP requests must
+     * include a valid bearer token from this integration. Without this and `requireApiKey`, the
+     * MCP endpoint is public.
+     */
+    oauthIntegrationId?: IntegrationId;
+    /**
+     * When true, MCP requests must present the agent's API key as a bearer token
+     * (`Authorization: Bearer <agent API key>` or the `x-squid-agent-api-key` header). Can be
+     * combined with `oauthIntegrationId`, in which case either credential is accepted.
+     */
+    requireApiKey?: boolean;
+}
+/**
+ * Request to AI-generate the MCP server and tool descriptions for an agent based on its
+ * instructions and connected resources.
+ * @category AI
+ */
+export interface GenerateAgentMcpDescriptionsRequest {
+    /** The ID of the agent to generate MCP descriptions for. */
+    agentId: AiAgentId;
+}
+/**
+ * AI-generated MCP descriptions for an agent. Returned without persisting — the caller saves them
+ * onto the agent's MCP server configuration.
+ * @category AI
+ */
+export interface GenerateAgentMcpDescriptionsResponse {
+    /** Generated description of the MCP server. */
+    description: string;
+    /** Generated description of the MCP `ask` tool. */
+    toolDescription: string;
+}
 /**
  * A definition of an AI agent with its properties and default chat options.
  * @category AI
@@ -683,6 +749,8 @@ export interface AiAgent<T extends AiChatModelSelection | undefined = undefined>
     options: AiChatOptions<T>;
     /** Optional api key used specifically for operations on this agent */
     apiKey?: string;
+    /** Optional configuration for exposing the agent as an MCP server. */
+    mcpServer?: AiAgentMcpServerConfig;
 }
 /**
  * @category AI

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

@@ -8,13 +8,18 @@ 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", "openai-compatible", "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", "azure_document_intelligence", "vertex", "external"];
 /**
  * Type of the AI provider.
  * References a single AI service, regardless of the model or other AI function it provides (like
  * chat/search/transcribe etc...).
  */
 export type AiProviderType = (typeof AI_PROVIDER_TYPES)[number];
+/**
+ * Canonical reasoning-effort levels, ordered from least to most effort.
+ * @category AI
+ */
+export type CanonicalReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra';
 /**
  * Type of AI provider that supports file upload operations.
  * Only a subset of AI providers support file management features.
@@ -34,17 +39,17 @@ export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-3.1-pro", "gemin
  * Public Grok chat model names (active models only).
  * @category AI
  */
-export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-4.3", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
+export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-4.5", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
 /**
  * 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-5", "claude-sonnet-5"];
+export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-fable-5", "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-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"];
+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-fable-5", "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.5", "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;
 /**
@@ -219,6 +224,10 @@ export type AiModelSource = (typeof AI_MODEL_SOURCES)[number];
 export interface ModelIdSpec {
     /** The model ID used for API calls. */
     modelId: AiChatModelName;
+    /** The provider serving this model when Squid can determine it from the model registry. */
+    providerType?: AiProviderType;
+    /** Canonical reasoning-effort levels accepted natively by this model. */
+    reasoningEfforts?: CanonicalReasoningEffort[];
     /** The integration ID if this model comes from an integration (OpenAI-compatible, Bedrock). Is undefined for Squid-provided models. */
     integrationId?: string;
     /** Human-readable display name for the model (e.g. "GPT-4o"). */

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

@@ -554,6 +554,16 @@ export interface AiKnowledgeBaseFileContextRequest extends BaseAiKnowledgeBaseCo
      */
     discardOriginalFile?: boolean;
 }
+/**
+ * Largest single file the bulk multipart staging endpoint accepts (`bulkUpsertContexts` with `files`).
+ *
+ * Public and shared deliberately: the upload parser rejects an oversized part with a 413 that carries no
+ * fallback token, so a client that does not know this bound has no way to route around it — every retry
+ * fails identically. Callers with larger files should use `createBulkUploadUrls` + `stagedObjectKey`, which
+ * uploads straight to storage and is not subject to it.
+ * @category AI
+ */
+export declare const BULK_INGESTION_MAX_MULTIPART_FILE_BYTES: number;
 /**
  * @category AI
  */
@@ -1430,3 +1440,176 @@ export interface QueryKnowledgeBaseGraphResponse {
     /** `globalSummary`: the KB's topic summaries ranked against the query, most relevant first. */
     summaries?: Array<KnowledgeBaseGraphQueryGlobalSummary>;
 }
+/**
+ * One context to stage through bulk ingestion.
+ * @category AI
+ */
+export interface BulkIngestionContext {
+    /** `'text'` (the default) stages a text context; `'file'` consumes the next uploaded file positionally. */
+    type?: 'text' | 'file';
+    /** Title for a text context (required); optional display title for a file context. */
+    title?: string;
+    /** The text content to stage; required for `type: 'text'`. */
+    text?: string;
+    /** Whether to extract images: inline markdown/HTML images for text contexts, embedded images for files. */
+    extractImages?: boolean;
+    /** Hint about a text context's format; only meaningful for `type: 'text'`. */
+    format?: 'markdown' | 'html' | 'plain';
+    /**
+     * Key returned by bulk/createUploadUrls; the server ingests the staged object as this context's file.
+     * Mutually exclusive with a positional multipart file.
+     */
+    stagedObjectKey?: string;
+    /**
+     * The preferred method for extracting data from a file context; mirrors the sync lane's field of the
+     * same name, so a caller's choice survives whichever lane a deployment routes the upload through.
+     */
+    preferredExtractionMethod?: DocumentExtractionMethod;
+    /**
+     * Optional metadata associated with the context item; mirrors {@link BaseAiKnowledgeBaseContextRequest.metadata}.
+     * Squid-reserved keys are stripped server-side, and values are validated/normalized against the target
+     * knowledge base's `metadataFields` schema when one is declared.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Request structure for staging contexts through bulk ingestion: a durable, asynchronous lane that
+ * processes contexts through provider batch APIs rather than inline, for high-volume ingestion. Poll
+ * {@link BulkIngestionJobStatusResponse} with the returned job id for progress.
+ * @category AI
+ */
+export interface BulkIngestionUpsertContextsRequest {
+    /** The id of the AiKnowledgeBase to ingest into. */
+    knowledgeBaseId: string;
+    /** The contexts to stage; each becomes one bulk-ingestion file. */
+    contexts: Array<BulkIngestionContext>;
+}
+/**
+ * Response for a staged bulk-ingestion request.
+ * @category AI
+ */
+export interface BulkIngestionUpsertContextsResponse {
+    /** The id of the staged bulk-ingestion job. */
+    jobId: string;
+    /**
+     * Context ids assigned to the staged contexts, in the same order as the request's `contexts` array. A
+     * context rejected as a duplicate still occupies its slot here, so this stays index-aligned with the
+     * request; cross-reference `duplicates` by `contextId` to tell which ids were actually staged.
+     */
+    contextIds: Array<string>;
+    /**
+     * Contexts rejected because the knowledge base already holds identical content — either stored under an
+     * existing context or accepted earlier in this same call. Absent when nothing was rejected.
+     *
+     * Same shape and `errorCode: 'DUPLICATE_CONTENT'` the synchronous `upsertContexts` returns, so a caller
+     * handles a duplicate identically on both lanes. These contexts are NOT part of the job: they are not
+     * extracted, not staged, and never appear in its per-file statuses.
+     */
+    duplicates?: Array<UpsertContextStatusError>;
+}
+/**
+ * Request structure for reading a bulk-ingestion job's progress.
+ * @category AI
+ */
+export interface BulkIngestionJobStatusRequest {
+    /** The id of the bulk-ingestion job to inspect. */
+    jobId: string;
+}
+/**
+ * Progress counters for a bulk-ingestion job, aggregated from its files and logical requests.
+ * @category AI
+ */
+export interface BulkIngestionJobStatusCounts {
+    /** Total files staged for the job. */
+    files: number;
+    /** Files whose contexts have been finalized into the knowledge base. */
+    finalized: number;
+    /** Files that terminally failed. */
+    failed: number;
+    /** Logical requests still pending submission. */
+    requestsPending: number;
+    /** Logical requests submitted to the provider and awaiting results. */
+    requestsSubmitted: number;
+}
+/**
+ * Per-file/per-context status within a bulk-ingestion job, so a caller can see which file finished,
+ * which is still processing, and why a file failed.
+ * @category AI
+ */
+export interface BulkIngestionFileStatus {
+    /** The context id assigned to this file at staging. */
+    contextId: string;
+    /** The file's title — the uploaded file name, or the caller-supplied title for text contexts. */
+    title: string;
+    /** User-facing per-file status. */
+    status: 'processing' | 'completed' | 'failed';
+    /** Present only when status is 'failed': the terminal failure reason. */
+    errorMessage?: string;
+}
+/**
+ * Response describing a bulk-ingestion job's current state and progress counts.
+ * @category AI
+ */
+export interface BulkIngestionJobStatusResponse {
+    /** The job's lifecycle state (e.g. running, completed, failed, cancelled). */
+    state: string;
+    /** Progress counters aggregated from the job's files and logical requests. */
+    counts: BulkIngestionJobStatusCounts;
+    /** Provider batch ids submitted for this job. */
+    providerBatchIds: Array<string>;
+    /** Per-file status, one entry per staged context (bounded by the job's file cap). */
+    files: Array<BulkIngestionFileStatus>;
+}
+/**
+ * Request structure for cancelling a running bulk-ingestion job.
+ * @category AI
+ */
+export interface BulkIngestionCancelRequest {
+    /** The id of the bulk-ingestion job to cancel. */
+    jobId: string;
+}
+/**
+ * Request structure for subscribing to push updates on a bulk-ingestion job. Once subscribed, the caller's
+ * client id receives a `bulkIngestionStatus` socket event on each orchestrator tick that touches the job,
+ * plus one final event on completion/failure/cancellation — in addition to (not instead of) polling
+ * {@link BulkIngestionJobStatusResponse} through `bulk/getJob`.
+ * @category AI
+ */
+export interface BulkIngestionSubscribeRequest {
+    /** The id of the bulk-ingestion job to subscribe to. */
+    jobId: string;
+}
+/**
+ * Request structure for minting presigned upload URLs for direct-to-storage bulk ingestion: the caller
+ * PUTs each file's bytes straight to storage, then references it in {@link BulkIngestionContext} via
+ * `stagedObjectKey`, bypassing multipart upload through core.
+ * @category AI
+ */
+export interface BulkIngestionCreateUploadUrlsRequest {
+    /** The files to mint upload URLs for (at most 500 per call). */
+    files: Array<{
+        fileName: string;
+    }>;
+}
+/**
+ * Response listing a presigned upload URL and staged-object key for each requested file, positionally
+ * aligned with the request's `files` array.
+ * @category AI
+ */
+export interface BulkIngestionCreateUploadUrlsResponse {
+    /** One entry per requested file. */
+    uploads: Array<{
+        /** The original file name, echoed back from the request. */
+        fileName: string;
+        /** Presigned URL the caller PUTs the file's bytes to; expires shortly after minting. */
+        uploadUrl: string;
+        /**
+         * Headers the PUT MUST carry in addition to the caller's own `Content-Type`. Empty on storage
+         * backends that mandate none (S3); on Azure Blob Storage the PUT is rejected with 400
+         * `MissingRequiredHeader` unless these are sent.
+         */
+        requiredHeaders: Record<string, string>;
+        /** Key to pass as {@link BulkIngestionContext.stagedObjectKey} once the PUT completes. */
+        stagedObjectKey: string;
+    }>;
+}

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

@@ -1,7 +1,7 @@
 /**
  * The extraction method to use for processing documents.
  */
-export type DocumentExtractionMethod = 'mistral_ocr' | 'legacy' | 'amazon_textract';
+export type DocumentExtractionMethod = 'mistral_ocr' | 'legacy' | 'amazon_textract' | 'azure_document_intelligence';
 /**
  * Options for customizing how data is extracted from a document.
  */

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

@@ -9,6 +9,12 @@ export declare const DATA_INTEGRATION_TYPES: readonly ["bigquery", "built_in_db"
  * @category Auth
  */
 export declare const AUTH_INTEGRATION_TYPES: readonly ["auth0", "jwt_rsa", "jwt_hmac", "cognito", "okta", "keycloak", "descope", "firebase_auth", "azure-entra-external-id"];
+/**
+ * Auth integration types that can OAuth-protect an MCP server (see `McpOAuthOptions` and
+ * `AiAgentMcpServerConfig.oauthIntegrationId`). Kept in sync with the providers supported by the
+ * MCP OAuth validation in core.
+ */
+export declare const MCP_OAUTH_INTEGRATION_TYPES: readonly ["auth0"];
 /** Supported integration types for GraphQL-based services. */
 export declare const GRAPHQL_INTEGRATION_TYPES: readonly ["graphql"];
 /** Supported integration types for HTTP-based services. */

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

@@ -1,3 +1,4 @@
+import type { CanonicalReasoningEffort } from './ai-agent.public-types';
 import type { IntegrationInfo } from './integration.public-types';
 /** Identifies the source-code analysis AI function. */
 export declare const SOURCE_CODE_ANALYZE_FUNCTION_ID = "analyzeCode";
@@ -23,6 +24,10 @@ export interface AiAgentSourceCodeIntegrationOptions {
     codeAnalysisEnabled: boolean;
     /** Selects the CLI provider used for code analysis. */
     analyzerModel?: SourceCodeAnalyzerModel;
+    /** Selects a concrete model from the analyzer provider's CLI registry. */
+    analyzerModelId?: string;
+    /** Selects the reasoning effort used by the analyzer CLI. */
+    analyzerReasoningEffort?: CanonicalReasoningEffort;
     /** Provides supplemental code-analysis instructions. */
     analyzerInstructions?: string;
 }

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

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { AiAgent, AiChatMessage, AiChatModelSelection, AiConnectedAgentMetadata, AiConnectedIntegrationMetadata, AiConnectedKnowledgeBaseMetadata, AiStatusMessage, AiTranscribeAndAskResponse, AllAiAgentChatOptions, BuildAgentOptions, GuardrailsOptions, ListAgentRevisionsResponse, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.public-types';
+import { AiAgent, AiAgentMcpServerConfig, AiChatMessage, AiChatModelSelection, AiConnectedAgentMetadata, AiConnectedIntegrationMetadata, AiConnectedKnowledgeBaseMetadata, AiStatusMessage, AiTranscribeAndAskResponse, AllAiAgentChatOptions, BuildAgentOptions, GenerateAgentMcpDescriptionsResponse, GuardrailsOptions, ListAgentRevisionsResponse, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.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';
@@ -52,6 +52,17 @@ export declare class AiAgentReference {
      * Updates the agent's guardrails with the provided options.
      */
     updateGuardrails(guardrails: GuardrailsOptions): Promise<void>;
+    /**
+     * Updates the agent's MCP server configuration, controlling whether the agent is exposed as an
+     * MCP server at `/mcp/<agentId>`. Requires an API key.
+     */
+    updateMcpServer(mcpServer: AiAgentMcpServerConfig): Promise<void>;
+    /**
+     * AI-generates the MCP server and `ask` tool descriptions for the agent based on its
+     * instructions and connected resources. Returns the descriptions without persisting them —
+     * save them with {@link updateMcpServer}. Requires an API key.
+     */
+    generateMcpDescriptions(): Promise<GenerateAgentMcpDescriptionsResponse>;
     /**
      * Updates the agent's custom guardrails with the provided custom guardrail.
      */

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

@@ -19,6 +19,7 @@ export declare class AiClient {
     private readonly socketManager;
     private readonly rpcManager;
     private readonly jobClient;
+    private readonly clientIdService;
     private readonly backendFunctionManager;
     private readonly getMetricAnnotations;
     private aiAgentClient?;

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

@@ -1,4 +1,5 @@
-import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResponse, AiKnowledgeBaseSearchResultChunk, ExploreKnowledgeBaseGraphRequest, ExploreKnowledgeBaseGraphResponse, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, GetKnowledgeBaseGraphStatusResponse, GrepKnowledgeBaseOptions, GrepKnowledgeBaseResponse, ListAiKnowledgeBaseContextsPageResponse, ListKnowledgeBaseContextsOptions, QueryKnowledgeBaseGraphRequest, QueryKnowledgeBaseGraphResponse, RebuildKnowledgeBaseGraphRequest, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
+import { Observable } from 'rxjs';
+import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResponse, AiKnowledgeBaseSearchResultChunk, BulkIngestionContext, BulkIngestionCreateUploadUrlsResponse, BulkIngestionJobStatusResponse, BulkIngestionUpsertContextsResponse, ExploreKnowledgeBaseGraphRequest, ExploreKnowledgeBaseGraphResponse, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, GetKnowledgeBaseGraphStatusResponse, GrepKnowledgeBaseOptions, GrepKnowledgeBaseResponse, 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.
@@ -25,6 +26,8 @@ export declare class AiKnowledgeBaseReference {
     private readonly knowledgeBaseId;
     private readonly rpcManager;
     private readonly jobClient;
+    private readonly socketManager;
+    private readonly clientIdService;
     /**
      * Returns the AI knowledge base.
      * @returns A promise that resolves to the AI knowledge base or undefined if not found.
@@ -91,6 +94,56 @@ export declare class AiKnowledgeBaseReference {
      * (content-level dedup). Requests that carry an explicit `contextId` overwrite that context unconditionally.
      */
     upsertContexts(contextRequests: Array<AiKnowledgeBaseContextRequest>, files?: Array<File>, options?: UpsertContextsOptions): Promise<UpsertKnowledgeBaseContextsResponse>;
+    /**
+     * Stages contexts through bulk ingestion — a durable, asynchronous lane that processes contexts through
+     * provider batch APIs rather than inline, built for high-volume ingestion. Unlike {@link upsertContexts},
+     * this method returns as soon as the request is staged and **never** awaits ingestion completion; track
+     * progress with {@link observeBulkIngestionJob} or by polling {@link getBulkIngestionJob} with the
+     * returned job id.
+     * @param contextRequests The contexts to stage; each becomes one bulk-ingestion file.
+     * @param files Positional files for contexts with `type: 'file'` and no `stagedObjectKey`. At most 50
+     * files, and 256 MB across all of them — the multipart body is buffered in memory server-side, so both
+     * caps are enforced by the upload parser and exceeding either is rejected before staging runs. For larger
+     * sets use {@link createBulkUploadUrls} and pass `stagedObjectKey` instead, which uploads straight to
+     * storage and is subject to neither cap.
+     * @returns The id of the staged bulk-ingestion job, plus the context id assigned to each staged context
+     * (in the same order as `contextRequests`).
+     */
+    bulkUpsertContexts(contextRequests: Array<BulkIngestionContext>, files?: Array<File>): Promise<BulkIngestionUpsertContextsResponse>;
+    /**
+     * Mints presigned upload URLs for direct-to-storage bulk files, bypassing multipart upload through core.
+     * PUT each file's bytes to its `uploadUrl` — sending every header in that entry's `requiredHeaders`,
+     * which some storage backends reject the PUT without — then reference the matching `stagedObjectKey` in
+     * a {@link BulkIngestionContext} passed to {@link bulkUpsertContexts}.
+     * @param fileNames The names of the files to mint upload URLs for (at most 500 per call).
+     */
+    createBulkUploadUrls(fileNames: Array<string>): Promise<BulkIngestionCreateUploadUrlsResponse>;
+    /**
+     * Returns a bulk-ingestion job's current lifecycle state and progress counts.
+     */
+    getBulkIngestionJob(jobId: string): Promise<BulkIngestionJobStatusResponse>;
+    /**
+     * Cancels a running bulk-ingestion job. Already-finalized contexts are kept; the job transitions to
+     * `cancelled` once in-flight provider work drains.
+     */
+    cancelBulkIngestionJob(jobId: string): Promise<void>;
+    /**
+     * Emits every `bulkIngestionStatus` push the server sends for the job and completes once a terminal
+     * state (`completed`, `failed` or `cancelled`) is emitted. Unlike {@link JobClient.awaitJob}, a terminal
+     * `failed`/`cancelled` state is delivered as a normal emitted value — the observable itself never errors
+     * because the job reached a terminal state; it only errors on a transport/subscription failure.
+     *
+     * Re-subscribes to the server-side push automatically if the client's connection id changes mid-subscription
+     * (e.g. after a long disconnect). Unsubscribing tears down the underlying socket listener. The observable is
+     * cold: each subscription independently registers a server-side push subscription, so share it (e.g. rxjs
+     * `share()`) when multiple consumers observe one job.
+     *
+     * If the job's app or knowledge base is deleted mid-flight, the job row is purged without a terminal push,
+     * so the observable never completes on its own; bound it (e.g. rxjs `timeout()`) when deletion is possible.
+     */
+    observeBulkIngestionJob(jobId: string): Observable<BulkIngestionJobStatusResponse & {
+        jobId: string;
+    }>;
     /**
      * Performs a semantic search in the knowledge base and returns chunks from the different contexts.
      */

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

@@ -10,6 +10,8 @@ import { AiKnowledgeBaseReference } from './ai-knowledge-base-client-reference';
 export declare class AiKnowledgeBaseClient {
     private readonly rpcManager;
     private readonly jobClient;
+    private readonly socketManager;
+    private readonly clientIdService;
     /**
      * Retrieves an instance of AiKnowledeBaseReference for a specific kb ID.
      * This reference provides methods for interacting with the knowledgebase.

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.484",
+  "version": "1.0.486",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -50,17 +50,10 @@
     "rxjs": ">=7.5.7 <8.0.0"
   },
   "devDependencies": {
-    "@supercharge/promise-pool": "^3.2.0",
-    "@webpack-cli/generators": "^3.0.7",
-    "copy-webpack-plugin": "^14.0.0",
     "generate-package-json-webpack-plugin": "^2.6.0",
     "otrie": "^1.2.2",
-    "tsconfig-paths-webpack-plugin": "^4.1.0",
-    "tscpaths": "^0.0.9",
     "typedoc": "^0.28.10",
-    "typedoc-plugin-markdown": "^4.8.1",
-    "webpack": "^5.106.2",
-    "webpack-cli": "^5.1.4"
+    "typedoc-plugin-markdown": "^4.8.1"
   },
   "browser": {
     "ws": false