@squidcloud/client 1.0.484 → 1.0.485

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';
@@ -575,7 +575,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 +660,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 +733,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

@@ -15,6 +15,11 @@ export declare const AI_PROVIDER_TYPES: readonly ["anthropic", "bedrock", "claud
  * 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.
@@ -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/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/internal-common/src/types/ai-agent.types.d.ts

@@ -1,4 +1,4 @@
-import { AgentContextRequest, AiAgent, AiAgentContext, AiAnnotation, AiAudioCreateSpeechOptions, AiChatMessage, AiChatOptions, AiGenerateImageOptions, AllAiAgentChatOptions, ApplicationAiSettings, BuildAgentOptions } from '../public-types/ai-agent.public-types';
+import { AgentContextRequest, AiAgent, AiAgentContext, AiAgentMcpServerConfig, AiAnnotation, AiAudioCreateSpeechOptions, AiChatMessage, AiChatOptions, AiGenerateImageOptions, AllAiAgentChatOptions, ApplicationAiSettings, BuildAgentOptions } from '../public-types/ai-agent.public-types';
 import { AiProviderType, ModelIdSpec } from '../public-types/ai-common.public-types';
 import { AiContextMetadata, AiContextMetadataFilter } from '../public-types/ai-knowledge-base.public-types';
 import { AiAgentId, AiKnowledgeBaseId, AppId, ClientRequestId } from '../public-types/communication.public-types';
@@ -161,6 +161,10 @@ export interface SetAgentDescriptionRequest {
     agentId: AiAgentId;
     description: string;
 }
+export interface SetAgentMcpServerRequest {
+    agentId: AiAgentId;
+    mcpServer: AiAgentMcpServerConfig;
+}
 export interface ListAgentContextsRequest {
     agentId: AiAgentId;
 }

package/dist/internal-common/src/types/notification.types.d.ts

@@ -1,5 +1,19 @@
 import { ClientId } from '../public-types/communication.public-types';
+import { AiStatusMessageToClient, NotificationMessageToClient } from './socket.types';
 export interface PublishNotificationRequest {
     clientIds: Array<ClientId>;
     payload: unknown;
 }
+/**
+ * Body of `/notification/publishSystemNotification`: the payload is a ready-made socket message.
+ *
+ * Deliberately narrower than the `MessageToClient` union: the endpoint exists to carry an AI status
+ * update from the backend SDK, or the same message its sibling `publishNotification` produces, and
+ * both are read defensively by their consumers. The protocol variants are not accepted — their
+ * handlers do structural work on the payload (the SDK's mutation dispatcher iterates it, for
+ * example), so admitting them would let a caller hand its own clients a message that throws.
+ */
+export interface PublishSystemNotificationRequest {
+    clientIds: Array<ClientId>;
+    payload: AiStatusMessageToClient | NotificationMessageToClient;
+}

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/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.485";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.484",
+  "version": "1.0.485",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -51,12 +51,10 @@
   },
   "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",