@squidcloud/backend 1.0.382 → 1.0.385

package/dist/backend/src/actions.d.ts

@@ -1,7 +1,8 @@
-import { AiFunctionId, ApiEndpointId, CollectionName, IntegrationId, IntegrationType, LlmModelMetadata, TopicName, UserAiChatModelName } from '@squidcloud/client';
-import { ActionMethodDecorator, AiFunctionAction, ClientConnectionStateChangeAction, ExecutableAction, LimiterConfig, LimitsAction, LlmAskAction, SchedulerAction, SecureAiAgentAction, SecureApiAction, SecureDatabaseAction, SecureDistributedLockAction, SecureGraphQLAction, SecureMetricAction, SecureNativeQueryAction, SecureStorageAction, SecureTopicAction, TriggerAction, WebhookAction } from '../../internal-common/src/public-types-backend/bundle-api.public-types';
+import { AiFunctionId, ApiEndpointId, CollectionName, IntegrationId, IntegrationType, TopicName } from '@squidcloud/client';
+import { JSONSchema } from 'json-schema-typed';
+import { ActionMethodDecorator, AiFunctionAction, ClientConnectionStateChangeAction, ExecutableAction, LimiterConfig, LimitsAction, LlmAskAction, McpAuthorizerAction, McpToolAction, SchedulerAction, SecureAiAgentAction, SecureApiAction, SecureDatabaseAction, SecureDistributedLockAction, SecureGraphQLAction, SecureMetricAction, SecureNativeQueryAction, SecureStorageAction, SecureTopicAction, TriggerAction, WebhookAction } from '../../internal-common/src/public-types-backend/bundle-api.public-types';
 import { AiFunctionAttributes, AiFunctionParam, DatabaseActionType, MetricActionType, StorageActionType, TopicActionType } from '../../internal-common/src/public-types-backend/bundle-data.public-types';
-import { AiFunctionsConfiguratorRequest, AiFunctionsConfiguratorResponse, CronExpression, CronExpressionString, MutationType, SchedulerId, TriggerId, WebhookId } from './public-types';
+import { AiFunctionsConfiguratorRequest, AiFunctionsConfiguratorResponse, CronExpression, CronExpressionString, LlmServiceOptions, McpServerOptions, MutationType, SchedulerId, TriggerId, WebhookId } from './public-types';
 /**
  * Decorator that marks a function for securing a database.
  * The decorator takes a type of action and an optional integration ID.
@@ -141,6 +142,18 @@ export interface AiFunctionMetadataOptions {
     /** Additional optional attributes for the function. Example: related integrations. */
     attributes?: AiFunctionAttributes;
 }
+/**
+ * Options for the `@mcpTool` annotation.
+ * @category AI
+ */
+export interface McpToolMetadataOptions {
+    /** Describes the capabilities of the function. This is used by the AI agent to determine when to call it. */
+    description: string;
+    /** Parameters for the MCP Tool. */
+    inputSchema: JSONSchema;
+    /** (Optional) The tool output schema. */
+    outputSchema?: JSONSchema;
+}
 /**
  * Decorator that marks a function for exposing it to the AI assistant.
  * The function accepts a JSON object as described in the description of the function in the annotation.
@@ -405,15 +418,6 @@ export declare function secureAiAgent(agentId?: string): ActionMethodDecorator<S
  * @category Decorator
  */
 export declare function limits(options: LimiterConfig): ActionMethodDecorator<LimitsAction>;
-/**
- * Options for the `@llmService` decorator.
- */
-export interface LlmServiceOptions {
-    /**
-     * Map of model names to their metadata.
-     */
-    models: Record<UserAiChatModelName, LlmModelMetadata>;
-}
 /**
  * Decorator‐factory that takes service options and returns a ClassDecorator.
  * @category Decorator
@@ -424,6 +428,22 @@ export declare function llmService(opts: LlmServiceOptions): ClassDecorator;
  * @category Decorator
  */
 export declare function llmAsk(): ActionMethodDecorator<LlmAskAction>;
+/**
+ * Decorator that marks a class as an MCP server.
+ * @category Decorator
+ */
+export declare function mcpServer(opts: McpServerOptions): ClassDecorator;
+/**
+ * A decorator to mark a function as a tool that can be used by the MCP .
+ * @param options Options for the MCP tool.
+ * @category Decorator
+ */
+export declare function mcpTool(options: McpToolMetadataOptions): ActionMethodDecorator<McpToolAction>;
+/**
+ * A decorator to mark a function as authorized request handler for the MCP.
+ * @category Decorator
+ */
+export declare function mcpAuthorizer(): ActionMethodDecorator<McpAuthorizerAction>;
 /**
  * Decorator that marks a function for handling a client connection state change.
  * @category Platform

package/dist/backend/src/public-types.d.ts

@@ -4,6 +4,8 @@ export * from '../../internal-common/src/public-types-backend/application.public
 export * from '../../internal-common/src/public-types-backend/bundle-api.public-types';
 export * from '../../internal-common/src/public-types-backend/distributed-lock.public-context';
 export * from '../../internal-common/src/public-types-backend/graphql.public-context';
+export * from '../../internal-common/src/public-types-backend/llm.public-types';
+export * from '../../internal-common/src/public-types-backend/mcp.public-types';
 export * from '../../internal-common/src/public-types-backend/metric.public-context';
 export * from '../../internal-common/src/public-types-backend/mutation.public-context';
 export * from '../../internal-common/src/public-types-backend/native-query.public-context';