@base44-preview/sdk 0.8.52-pr.297.c6f2448 → 0.8.52-pr.299.9f7108e

package/dist/client.js

@@ -11,6 +11,7 @@ import { createAgentsModule } from "./modules/agents.js";
 import { createAiGatewayModule } from "./modules/ai-gateway.js";
 import { createAppLogsModule } from "./modules/app-logs.js";
 import { createAppModule } from "./modules/app.js";
+import { createMcpModule } from "./modules/mcp.js";
 import { createUsersModule } from "./modules/users.js";
 import { RoomsSocket } from "./utils/socket-utils.js";
 import { createAnalyticsModule } from "./modules/analytics.js";
@@ -201,6 +202,7 @@ export function createClient(config) {
         }),
         appLogs: createAppLogsModule(axiosClient, appId),
         app: createAppModule(axiosClient, appId),
+        mcp: createMcpModule(axiosClient, appId),
         users: createUsersModule(axiosClient, appId),
         analytics: createAnalyticsModule({
             axiosClient,

package/dist/client.types.d.ts

@@ -8,6 +8,7 @@ import type { AgentsModule } from "./modules/agents.types.js";
 import type { AiGatewayModule } from "./modules/ai-gateway.types.js";
 import type { AppLogsModule } from "./modules/app-logs.types.js";
 import type { AppModule } from "./modules/app.types.js";
+import type { McpModule } from "./modules/mcp.types.js";
 import type { AnalyticsModule } from "./modules/analytics.types.js";
 import type { ActorsModule } from "./modules/actors.types.js";
 import type { FetchWithAuthInit } from "./utils/fetch-with-auth.js";
@@ -138,6 +139,8 @@ export interface Base44Client {
     functions: FunctionsModule;
     /** {@link IntegrationsModule | Integrations module} for calling pre-built integration endpoints. */
     integrations: IntegrationsModule;
+    /** {@link McpModule | MCP module} for the app's MCP consent page. */
+    mcp: McpModule;
     /** Cleanup function to disconnect WebSocket connections. Call when you're done with the client. */
     cleanup: () => void;
     /**

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export type { AgentsModule, AgentName, AgentNameRegistry, AgentConversation, Age
 export type { AiGatewayModule, AiGatewayConnection, AiGatewayConnectionOptions, } from "./modules/ai-gateway.types.js";
 export type { AppLogsModule } from "./modules/app-logs.types.js";
 export type { AppModule, AppPublicSettings, AppPublicSettingsResponse, } from "./modules/app.types.js";
+export type { McpModule, McpConsentInfo, McpConsentTool, McpConsentAction, McpAuthorizeGrantResponse, } from "./modules/mcp.types.js";
 export type { ActorsModule, ActorClient, ActorRef, Connection, ActorSubscription, ActorConnectOptions, ActorNameRegistry, ActorRegistry, } from "./modules/actors.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 export { Actor, type Conn } from "./actor.js";

package/dist/modules/ai-gateway.types.d.ts

@@ -51,9 +51,9 @@ export interface AiGatewayModuleConfig {
  * against the provider directly, no separate account, API key, or billing
  * setup with the underlying model provider required.
  *
- * By default, `connection()` uses the OpenAI-compatible provider, which serves
- * chat, images, and videos. Pass `{ provider: "typesafe" }` for
- * structured evaluations.
+ * By default, `connection()` uses the OpenAI-compatible provider. Pass
+ * `{ provider: "typesafe" }` to connect to TypeSafe for structured evaluations
+ * with `@ai-sdk/typesafe-ai`.
  *
  * Call `connection()` from a backend function rather than the browser. This
  * keeps your instructions, tools, and business logic server-side, and lets
@@ -76,26 +76,6 @@ export interface AiGatewayModuleConfig {
  * `'gemini_3_1_flash_image'` or `'gpt_image_2'`. For request options, the
  * full model list, and limits, see [Generate images with the AI Gateway](/developers/references/sdk/getting-started/ai-gateway-images).
  *
- * ## Videos
- *
- * The gateway serves OpenAI's asynchronous video endpoints through the
- * `openai` SDK's `videos` client. `videos.create()` starts a job and returns
- * its `id` right away; call `videos.retrieve(id)` until `status` is
- * `completed` or `failed`. A completed job exposes the stored video at `url`.
- * A backend function is a bounded HTTP call, so don't poll inside one: return
- * the `id`, then retrieve it from a later call or scheduled run. Video
- * requests need a specific model, such as `'veo_3_1_fast'` or
- * `'seedance_2_fast'`; there's no `'automatic'` option.
- *
- * ## Structured evaluations
- *
- * The `typesafe` provider runs the `jev` evaluation model through
- * `@ai-sdk/typesafe-ai` and the `ai` package's `experimental_evaluate`. Give
- * it some app state and a set of questions, each a `choice`, `score`, or
- * `boolean`, and it returns each answer with its probabilities. Use it
- * to classify, score, or route records, then apply your own thresholds and
- * actions in code.
- *
  * ## Authentication Modes
  *
  * There's no permission difference between modes. Both just determine which
@@ -207,70 +187,6 @@ export interface AiGatewayModule {
      * const file = new File([image.uint8Array], "lighthouse.png", { type: image.mediaType });
      * const { file_url } = await base44.integrations.Core.UploadFile({ file });
      * ```
-     *
-     * @example
-     * ```typescript
-     * // Start a video job, then check on it from a later call
-     * import { createClientFromRequest } from "@base44/sdk";
-     * import OpenAI from "openai";
-     *
-     * // Runs inside a backend function
-     * const base44 = createClientFromRequest(request);
-     * const { baseURL, token, headers } = base44.aiGateway.connection();
-     * const { videos } = new OpenAI({ baseURL, apiKey: token, defaultHeaders: headers });
-     *
-     * const { videoId } = await request.json();
-     * if (!videoId) {
-     *   // Avoid automatic replays of billed requests
-     *   const job = await videos.create(
-     *     { model: "veo_3_1_fast", prompt: "A paper boat drifting down a rainy street", seconds: "4" },
-     *     { maxRetries: 0 },
-     *   );
-     *   return Response.json({ videoId: job.id, status: job.status }, { status: 202 });
-     * }
-     *
-     * const video = await videos.retrieve(videoId);
-     * // `queued` and `in_progress` mean unfinished; `url` is set once `completed`
-     * return Response.json(video);
-     * ```
-     *
-     * @example
-     * ```typescript
-     * // Route a support ticket with a structured evaluation
-     * import { createClientFromRequest } from "@base44/sdk";
-     * import { experimental_evaluate as evaluate } from "ai";
-     * import { createTypeSafeAi } from "@ai-sdk/typesafe-ai";
-     *
-     * // Runs inside a backend function
-     * const base44 = createClientFromRequest(request);
-     * const { baseURL, token, headers } = base44.aiGateway.connection({ provider: "typesafe" });
-     * const typesafe = createTypeSafeAi({ baseURL, apiKey: token, headers });
-     *
-     * const { answers } = await evaluate({
-     *   model: typesafe.evaluationModel("jev"),
-     *   maxRetries: 0,
-     *   state: { message: "Please refund today's duplicate charge." },
-     *   questions: {
-     *     department: {
-     *       type: "choice",
-     *       instructions: "Which team should handle this?",
-     *       criteria: { billing: "Payments and refunds", support: "Other requests" },
-     *     },
-     *     urgency: {
-     *       type: "score",
-     *       instructions: "How urgent is this?",
-     *       criteria: ["No deadline", "Requested today", "Immediate emergency"],
-     *     },
-     *     refund: { type: "boolean", instructions: "Is a refund explicitly requested?" },
-     *   },
-     * });
-     *
-     * // answers.department → { type: "choice", choice: "billing", probabilities: { billing: 0.97, support: 0.03 } }
-     * // answers.urgency    → { type: "score", score: 1.2, probabilities: { 0: 0.1, 1: 0.6, 2: 0.3 } }
-     * // answers.refund     → { type: "boolean", probability: 0.99 }
-     * // Pick your own thresholds and act on them in code
-     * const autoRefund = answers.department.choice === "billing" && answers.refund.probability > 0.9;
-     * ```
      */
     connection(options?: AiGatewayConnectionOptions): AiGatewayConnection;
 }

package/dist/modules/mcp.d.ts

@@ -0,0 +1,11 @@
+import { AxiosInstance } from "axios";
+import { McpModule } from "./mcp.types";
+/**
+ * Creates the MCP module for the Base44 SDK.
+ *
+ * @param axios - Axios instance
+ * @param appId - Application ID
+ * @returns MCP module for the app's MCP consent page
+ * @internal
+ */
+export declare function createMcpModule(axios: AxiosInstance, appId: string): McpModule;

package/dist/modules/mcp.js

@@ -0,0 +1,20 @@
+/**
+ * Creates the MCP module for the Base44 SDK.
+ *
+ * @param axios - Axios instance
+ * @param appId - Application ID
+ * @returns MCP module for the app's MCP consent page
+ * @internal
+ */
+export function createMcpModule(axios, appId) {
+    return {
+        async getConsentInfo(ctx) {
+            return axios.get(`/apps/${appId}/mcp/consent-info`, {
+                params: { handle: ctx },
+            });
+        },
+        async authorizeGrant(ctx, action) {
+            return axios.post(`/apps/${appId}/mcp/authorize-grant`, { ctx, action });
+        },
+    };
+}

package/dist/modules/mcp.types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * One tool shown on the MCP consent page.
+ */
+export interface McpConsentTool {
+    /** The tool's MCP name. */
+    name: string;
+    /** Human-readable title, when the tool has one. */
+    title?: string | null;
+    /** What the tool does. */
+    description?: string | null;
+    /** Whether the tool only reads data. */
+    read_only_hint?: boolean | null;
+}
+/**
+ * Display details for a pending MCP authorization request, as returned by
+ * {@link McpModule.getConsentInfo}.
+ */
+export interface McpConsentInfo {
+    /** The app's display name. */
+    app_name: string;
+    /** The name of the AI client asking for access. */
+    client_name: string;
+    /**
+     * Whether the request came from a signed-in user of this app. When `false`,
+     * send the user to `login_path` before showing approve and deny.
+     */
+    authenticated: boolean;
+    /** The tools the client will be able to use. Empty unless `authenticated` is `true`. */
+    tools: McpConsentTool[];
+    /** The app's login route for a signed-out user, such as `/login`. */
+    login_path: string;
+}
+/**
+ * The user's decision on an MCP authorization request.
+ */
+export type McpConsentAction = "approve" | "deny";
+/**
+ * Result of {@link McpModule.authorizeGrant}.
+ */
+export interface McpAuthorizeGrantResponse {
+    /**
+     * Where to send the browser next: the AI client's redirect URI, carrying the
+     * authorization code on approve or an `access_denied` error on deny. It may
+     * use a custom scheme such as `cursor://`.
+     */
+    redirect_url: string;
+}
+/**
+ * MCP module for the app's MCP consent page.
+ *
+ * When an AI client connects to the app's MCP server, Base44 sends the user to
+ * the app's consent page with an opaque `ctx` query parameter. The page reads
+ * the request's details with {@link McpModule.getConsentInfo | getConsentInfo()}
+ * and records the user's decision with {@link McpModule.authorizeGrant | authorizeGrant()}.
+ *
+ * ## Authentication Modes
+ *
+ * This module is available to use with a client in user authentication mode. The
+ * signed-in user's token is sent when the client has one; otherwise the app's
+ * session cookie identifies the user.
+ */
+export interface McpModule {
+    /**
+     * Gets the display details for a pending MCP authorization request.
+     *
+     * Rejects with a {@linkcode Base44Error} with `status` `404` when the `ctx`
+     * handle is unknown or expired.
+     *
+     * @param ctx - The `ctx` query parameter the consent page was opened with.
+     * @returns Promise resolving to the request's display details.
+     *
+     * @example
+     * ```typescript
+     * const ctx = new URLSearchParams(window.location.search).get('ctx');
+     * const info = await base44.mcp.getConsentInfo(ctx);
+     * if (!info.authenticated) {
+     *   window.location.href = info.login_path;
+     * }
+     * ```
+     */
+    getConsentInfo(ctx: string): Promise<McpConsentInfo>;
+    /**
+     * Records the signed-in user's decision on an MCP authorization request.
+     *
+     * The `ctx` handle is single-use. Rejects with a {@linkcode Base44Error}:
+     * `status` `401` when the user must sign in again (the handle is still valid),
+     * and `400`, `403`, `404` or `409` when the request can no longer be
+     * completed and the user must reconnect from the AI client.
+     *
+     * @param ctx - The `ctx` query parameter the consent page was opened with.
+     * @param action - `"approve"` to grant access, `"deny"` to refuse it.
+     * @returns Promise resolving to the URL to send the browser to.
+     *
+     * @example
+     * ```typescript
+     * const { redirect_url } = await base44.mcp.authorizeGrant(ctx, 'approve');
+     * window.location.href = redirect_url;
+     * ```
+     */
+    authorizeGrant(ctx: string, action: McpConsentAction): Promise<McpAuthorizeGrantResponse>;
+}

package/dist/modules/mcp.types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.52-pr.297.c6f2448",
+  "version": "0.8.52-pr.299.9f7108e",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",