@base44-preview/sdk 0.8.37-pr.228.93ccd45 → 0.8.38-pr.219.9f3b9dd

package/dist/client.js

@@ -151,7 +151,7 @@ export function createClient(config) {
             serverUrl,
             token,
         }),
-        aiGateway: createAiGatewayModule({ serverUrl, token }),
+        aiGateway: createAiGatewayModule({ serverUrl, token, appId }),
         appLogs: createAppLogsModule(axiosClient, appId),
         users: createUsersModule(axiosClient, appId),
         analytics: createAnalyticsModule({
@@ -194,7 +194,7 @@ export function createClient(config) {
             serverUrl,
             token,
         }),
-        aiGateway: createAiGatewayModule({ serverUrl, token: serviceToken }),
+        aiGateway: createAiGatewayModule({ serverUrl, token: serviceToken, appId }),
         appLogs: createAppLogsModule(serviceRoleAxiosClient, appId),
         cleanup: () => {
             if (socket) {
@@ -346,7 +346,6 @@ export function createClientFromRequest(request) {
     const serverUrlHeader = request.headers.get("Base44-Api-Url");
     const functionsVersion = request.headers.get("Base44-Functions-Version");
     const stateHeader = request.headers.get("Base44-State");
-    const dataEnvHeader = request.headers.get("X-Data-Env");
     if (!appId) {
         throw new Error("Base44-App-Id header is required, but is was not found on the request");
     }
@@ -374,14 +373,6 @@ export function createClientFromRequest(request) {
     if (stateHeader) {
         additionalHeaders["Base44-State"] = stateHeader;
     }
-    // Propagate the data environment so entity operations from the function stay
-    // in the same environment (e.g. test data) as the triggering request. This
-    // matters for the user-scoped client: unlike the service token, the user JWT
-    // carries no data-env, so without forwarding this header the callbacks fall
-    // back to production data even when the app runs in test-data mode.
-    if (dataEnvHeader) {
-        additionalHeaders["X-Data-Env"] = dataEnvHeader;
-    }
     return createClient({
         serverUrl: serverUrlHeader || "https://base44.app",
         appId,

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

@@ -1,2 +1,2 @@
 import { AiGatewayModule, AiGatewayModuleConfig } from "./ai-gateway.types.js";
-export declare function createAiGatewayModule({ serverUrl, token, }: AiGatewayModuleConfig): AiGatewayModule;
+export declare function createAiGatewayModule({ serverUrl, token, appId, }: AiGatewayModuleConfig): AiGatewayModule;

package/dist/modules/ai-gateway.js

@@ -1,9 +1,9 @@
 import { getAccessToken } from "../utils/auth-utils.js";
-export function createAiGatewayModule({ serverUrl, token, }) {
+export function createAiGatewayModule({ serverUrl, token, appId, }) {
     const connection = () => {
         var _a;
         return ({
-            baseURL: `${serverUrl}/api/ai/openai/v1`,
+            baseURL: `${serverUrl}/api/apps/${appId}/ai/openai/v1`,
             token: (_a = token !== null && token !== void 0 ? token : getAccessToken()) !== null && _a !== void 0 ? _a : "",
         });
     };

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

@@ -1,9 +1,8 @@
 /**
  * A connection to the Base44 AI Gateway.
  *
- * Contains the base URL and bearer token to use with any OpenAI-compatible client
- * (OpenAI SDK, Mastra, Vercel AI SDK, and others) pointed at the Base44 AI
- * Gateway.
+ * Contains the base URL and bearer token to use with any OpenAI-compatible
+ * client pointed at the Base44 AI Gateway.
  */
 export interface AiGatewayConnection {
     /** Base URL of the gateway's OpenAI-compatible endpoint. */
@@ -20,13 +19,15 @@ export interface AiGatewayModuleConfig {
     serverUrl?: string;
     /** Authentication token */
     token?: string;
+    /** Application ID */
+    appId: string;
 }
 /**
  * AI Gateway module for calling Base44's managed AI models from your own code.
  *
  * The gateway exposes an OpenAI-compatible Chat Completions endpoint, so any
  * OpenAI-compatible SDK works against it:
- * - Build custom AI agents with agent SDKs such as Mastra or the Vercel AI SDK
+ * - Build custom AI agents or call models directly from your backend code
  * - Uses your app's models, billing, and credit quota, no API key to manage
  *
  * Available in user authentication mode (`base44.aiGateway`) and with the
@@ -46,55 +47,41 @@ export interface AiGatewayModule {
      *
      * @example
      * ```typescript
-     * // Build an AI agent with Mastra on top of the gateway, inside a backend function
-     * import { createClientFromRequest } from 'npm:@base44/sdk';
-     * import { Agent } from 'npm:@mastra/core/agent';
-     * import { createTool } from 'npm:@mastra/core/tools';
-     * import { createOpenAICompatible } from 'npm:@ai-sdk/openai-compatible';
-     * import { z } from 'npm:zod';
+     * import { ToolLoopAgent, tool, stepCountIs, hasToolCall } from "ai";
+     * import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+     * import { z } from "zod";
      *
-     * Deno.serve(async (req) => {
-     *   const base44 = createClientFromRequest(req);
-     *   const { baseURL, token } = base44.aiGateway.connection();
-     *   const models = createOpenAICompatible({ name: 'base44', baseURL, apiKey: token });
+     * const request = await base44.entities.ReturnRequest.get(returnId);
+     * const { baseURL, token } = base44.aiGateway.connection();
+     * // Point any OpenAI-compatible client at `baseURL` with `apiKey: token`.
+     * const models = createOpenAICompatible({ name: "base44", baseURL, apiKey: token });
      *
-     *   const agent = new Agent({
-     *     id: 'order-helper',
-     *     name: 'order-helper',
-     *     instructions: 'Help the user with their orders.',
-     *     model: models('claude_sonnet_4_6'),
-     *     tools: {
-     *       lookupOrder: createTool({
-     *         id: 'lookup-order',
-     *         description: 'Fetch an order by id',
-     *         inputSchema: z.object({ orderId: z.string() }),
-     *         execute: async ({ orderId }) => base44.entities.Order.get(orderId),
-     *       }),
-     *     },
-     *   });
-     *
-     *   const { text } = await agent.generate('Where is order 123?');
-     *   return Response.json({ text });
+     * const agent = new ToolLoopAgent({
+     *   model: models("automatic"),
+     *   instructions:
+     *     "Decide whether this return looks fine or needs the owner's attention. " +
+     *     "Check the customer's past orders, then submit your verdict.",
+     *   tools: {
+     *     searchOrders: tool({
+     *       description: "This customer's past orders, optionally filtered by status",
+     *       inputSchema: z.object({ status: z.string().optional() }),
+     *       execute: ({ status }) => {
+     *         const query = { customer_email: request.customer_email };
+     *         if (status) query.status = status;
+     *         return base44.entities.Order.filter(query, "-created_date", 50);
+     *       },
+     *     }),
+     *     submitVerdict: tool({
+     *       description: "Record the final verdict",
+     *       inputSchema: z.object({ decision: z.enum(["approved", "flagged"]), reason: z.string() }),
+     *       execute: ({ decision, reason }) =>
+     *         base44.entities.ReturnRequest.update(returnId, { status: decision, review_note: reason }),
+     *     }),
+     *   },
+     *   stopWhen: [stepCountIs(8), hasToolCall("submitVerdict")],
      * });
-     * ```
      *
-     * @example
-     * ```typescript
-     * // Call a model directly with the OpenAI SDK
-     * import { createClientFromRequest } from 'npm:@base44/sdk';
-     * import OpenAI from 'npm:openai';
-     *
-     * Deno.serve(async (req) => {
-     *   const base44 = createClientFromRequest(req);
-     *   const { baseURL, token } = base44.aiGateway.connection();
-     *
-     *   const openai = new OpenAI({ baseURL, apiKey: token });
-     *   const res = await openai.chat.completions.create({
-     *     model: 'claude_sonnet_4_6',
-     *     messages: [{ role: 'user', content: 'Hello!' }],
-     *   });
-     *   return Response.json({ text: res.choices[0].message.content });
-     * });
+     * await agent.generate({ prompt: `Review this return request: ${JSON.stringify(request)}` });
      * ```
      */
     connection(): AiGatewayConnection;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.37-pr.228.93ccd45",
+  "version": "0.8.38-pr.219.9f3b9dd",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",