@squidcloud/client 1.0.485 → 1.0.487

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

@@ -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;

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", "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
@@ -39,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;
 /**

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.485",
+  "version": "1.0.487",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -50,15 +50,10 @@
     "rxjs": ">=7.5.7 <8.0.0"
   },
   "devDependencies": {
-    "@supercharge/promise-pool": "^3.2.0",
-    "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",
     "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

package/dist/internal-common/src/ai/system-openai-compatible.d.ts

@@ -1,35 +0,0 @@
-/**
- * System-level OpenAI-compatible backends ("slots") for Squid's own internal AI calls.
- *
- * Generic plumbing for pointing an internal model at ANY OpenAI-compatible HTTP endpoint —
- * primarily Squid's own self-hosted models, but any OpenAI-compatible backend works. The
- * non-secret part of a slot (base URL, optional headers/extra body) is hardcoded here on purpose
- * (changing a backend is a reviewed code change); only the API key lives in Vault under
- * `SystemSecrets['openai-compatible'][slotName].apiKey`.
- *
- * NOT the customer-facing `openai_compatible` Integration (per-app, console-configured). Models
- * served through these slots are declared in `AI_CHAT_MODEL_REGISTRY` with
- * `providerType: 'openai-compatible'` + `openAiCompatibleSlot`, and resolve only with
- * `keyType: 'system'` (see `AiProviderFactory.getChatProviderForModel`) — never customer-reachable.
- *
- * No slots are defined yet (foundation only). To wire one up:
- *   1. add a slot below, e.g. `'my-model': { baseUrl: 'https://llm.internal.squid/v1' }`;
- *   2. seed its key in `SystemSecrets['openai-compatible']['my-model'].apiKey`;
- *   3. add a model entry in ai-model.registry.ts pointing `openAiCompatibleSlot: 'my-model'`.
- */
-/** Non-secret configuration of one system OpenAI-compatible backend. */
-export interface SystemOpenAiCompatibleSlotConfig {
-    /** Base URL of the OpenAI-compatible API, e.g. a self-hosted 'https://llm.internal.squid/v1'. */
-    baseUrl: string;
-    /** Extra HTTP headers sent with every request. */
-    headers?: Record<string, string>;
-    /** Extra JSON body fields merged into every request — reserved wire fields are dropped by the provider. */
-    extraBody?: Record<string, unknown>;
-}
-/** Name of a system OpenAI-compatible slot (a key of `SYSTEM_OPENAI_COMPATIBLE_SLOTS`). */
-export type SystemOpenAiCompatibleSlotName = string;
-/**
- * Registered system OpenAI-compatible slots, keyed by name. Empty by design — add a self-hosted
- * (or any other) OpenAI-compatible backend here; see the module doc above.
- */
-export declare const SYSTEM_OPENAI_COMPATIBLE_SLOTS: Record<SystemOpenAiCompatibleSlotName, SystemOpenAiCompatibleSlotConfig>;

package/dist/internal-common/src/metric-name.d.ts

@@ -1,14 +0,0 @@
-/**
- * Names of the Squid metrics.
- *
- * This list and its Kotlin counterpart (MetricName.kt) may diverge:
- * each side declares only the metrics that its own backend emits.
- * However, metrics emitted by both backends MUST use identical names on both sides —
- * otherwise dashboards and metric queries that mix data from both sources will break.
- *
- * See MetricName.kt for documentation on each value.
- */
-export declare const ALL_SQUID_METRIC_NAMES: readonly ["squid_functionExecution_count", "squid_functionExecution_time", "squid_aiChatbotContext_size", "squid_aiChatbotChatInputTokens_count", "squid_aiChatbotChatOutputTokens_count", "squid_aiChatbotChatReasoningTokens_count", "squid_aiChatbotChatCacheReadInputTokens_count", "squid_aiChatbotChatCacheWriteInputTokens_count", "squid_aiChatbotChatCostUsd_count", "squid_aiChatbotChatOutcome_count", "squid_aiImageGeneration_count", "squid_aiImageGeneration_time", "squid_aiRemoveBackground_count", "squid_aiRemoveBackground_time", "squid_aiAudioTranscribe_count", "squid_aiAudioTranscribe_time", "squid_aiAudioCreateSpeech_count", "squid_aiAudioCreateSpeech_time", "squid_aiIntegrationData_count", "squid_aiIntegrationData_time", "squid_aiIntegrationApi_count", "squid_aiIntegrationApi_time", "squid_apiControllerCall_count", "squid_apiControllerCall_time", "squid_aiContextUpsert_count", "squid_aiContextDelete_count", "squid_codeInitialization_count", "squid_codeInitialization_time", "squid_sourceCodeAnalysis_count", "squid_sourceCodeAnalysis_time", "squid_sourceCodeLeaseWait_time", "squid_sourceCodeWorkspaceBytes_value", "squid_sourceCodeInputTokens_count", "squid_sourceCodeOutputTokens_count", "squid_deleteApiKey_count", "squid_deleteApiKey_time", "squid_deleteSecret_count", "squid_deleteSecret_time", "squid_discoverGraphQLConnectionSchema_count", "squid_discoverGraphQLConnectionSchema_time", "squid_discoverOpenApiSchema_count", "squid_discoverOpenApiSchema_time", "squid_discoverOpenApiSchemaFromFile_count", "squid_discoverOpenApiSchemaFromFile_time", "squid_executeBackendFunction_count", "squid_executeBackendFunction_time", "squid_apiControllerCall_count", "squid_apiControllerCall_time", "squid_getAiChatbotProfiles_count", "squid_getAiChatbotProfiles_time", "squid_getAllApiKeys_count", "squid_getAllApiKeys_time", "squid_getAllSecrets_count", "squid_getAllSecrets_time", "squid_getAppApiKey_count", "squid_getAppApiKey_time", "squid_getSecret_count", "squid_getSecret_time", "squid_graphql_count", "squid_graphql_time", "squid_graphqlQuery_count", "squid_graphqlQuery_time", "squid_integrationCount_value", "squid_mutate_count", "squid_mutate_time", "squid_metricQuery_count", "squid_metricQuery_time", "squid_metricReport_count", "squid_metricReport_time", "squid_nativeQuery_count", "squid_nativeQuery_time", "squid_openapi_count", "squid_openapi_time", "squid_produceTopicMessage_count", "squid_produceTopicMessage_time", "squid_query_count", "squid_query_time", "squid_queueMessageHandler_count", "squid_queueMessageHandler_time", "squid_registerQuery_count", "squid_registerQuery_time", "squid_rerankChunks_count", "squid_rerankChunks_time", "squid_schedulerJob_count", "squid_schedulerJob_time", "squid_eventHandler_count", "squid_eventHandler_time", "squid_schema_size", "squid_secrets_entries", "squid_storageDeleteFiles_count", "squid_storageDeleteFiles_time", "squid_storageGetDownloadUrl_count", "squid_storageGetDownloadUrl_time", "squid_storageGetFileMetadata_count", "squid_storageGetFileMetadata_time", "squid_storageListDirectoryContents_count", "squid_storageListDirectoryContents_time", "squid_storageUploadFile_count", "squid_storageUploadFile_time", "squid_subscribeToTopic_count", "squid_subscribeToTopic_time", "squid_testGraphQLConnection_count", "squid_testGraphQLConnection_time", "squid_testAgentProtocolConnection_count", "squid_testAgentProtocolConnection_time", "squid_trigger_count", "squid_trigger_time", "squid_upsertApiKey_count", "squid_upsertApiKey_time", "squid_upsertSecret_count", "squid_upsertSecret_time", "squid_vectorChunks_count", "squid_vectorChunks_time", "squid_webhook_count", "squid_webhook_time", "squid_acquireLock_count", "squid_acquireLock_time", "squid_releaseLock_count", "squid_releaseLock_time"];
-export type MetricName = (typeof ALL_SQUID_METRIC_NAMES)[number];
-/** Common prefix for all Squid metrics. */
-export declare const SQUID_METRIC_NAME_PREFIX = "squid_";

package/dist/internal-common/src/public-types-backend/api-call.public-context.d.ts

@@ -1,30 +0,0 @@
-import { ApiOptions } from '../public-types/api-client.public-types';
-import { ApiEndpointId, HttpMethod } from '../public-types/api.public-types';
-import { IntegrationId } from '../public-types/communication.public-types';
-/** The headers of an API call. */
-export type ApiHeaders = Record<string, string | number | boolean>;
-/** The context of an API call. */
-export declare class ApiCallContext {
-    readonly integrationId: IntegrationId;
-    readonly endpointId: ApiEndpointId;
-    readonly url: string;
-    readonly method: HttpMethod;
-    readonly body: unknown;
-    readonly options: ApiOptions;
-}
-/**
- * Represents a request to call an API through a specified integration and endpoint.
- * Includes optional method override and additional request options.
- */
-export interface CallApiRequest<BodyType = any> {
-    /** The identifier of the integration through which the API is called. */
-    integrationId: IntegrationId;
-    /** Target API endpoint to invoke. */
-    endpointId: ApiEndpointId;
-    /** Optional request payload. */
-    body?: BodyType;
-    /** Optional HTTP method override. Default is POST. */
-    overrideMethod?: HttpMethod;
-    /** Additional request options. */
-    options: ApiOptions;
-}