@base44-preview/sdk 0.8.19-pr.126.c537ed8 → 0.8.19-pr.127.7353bb5

package/dist/index.d.ts

@@ -4,11 +4,11 @@ import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl } from
 export { createClient, createClientFromRequest, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
 export type { Base44Client, CreateClientConfig, CreateClientOptions, Base44ErrorJSON, };
 export * from "./types.js";
-export type { EntitiesModule, EntityHandler, EntityRecord, EntityTypeRegistry, RealtimeEventType, RealtimeEvent, RealtimeCallback, } from "./modules/entities.types.js";
+export type { DeleteManyResult, DeleteResult, EntitiesModule, EntityHandler, EntityRecord, EntityTypeRegistry, ImportResult, RealtimeEventType, RealtimeEvent, RealtimeCallback, } from "./modules/entities.types.js";
 export type { AuthModule, LoginResponse, RegisterParams, VerifyOtpParams, ChangePasswordParams, ResetPasswordParams, User, } from "./modules/auth.types.js";
 export type { IntegrationsModule, IntegrationPackage, IntegrationEndpointFunction, CoreIntegrations, InvokeLLMParams, GenerateImageParams, GenerateImageResult, UploadFileParams, UploadFileResult, SendEmailParams, SendEmailResult, ExtractDataFromUploadedFileParams, ExtractDataFromUploadedFileResult, UploadPrivateFileParams, UploadPrivateFileResult, CreateFileSignedUrlParams, CreateFileSignedUrlResult, } from "./modules/integrations.types.js";
-export type { FunctionsModule, FunctionNameRegistry, } from "./modules/functions.types.js";
-export type { AgentsModule, AgentNameRegistry, AgentConversation, AgentMessage, AgentMessageReasoning, AgentMessageToolCall, AgentMessageUsage, AgentMessageCustomContext, AgentMessageMetadata, CreateConversationParams, } from "./modules/agents.types.js";
+export type { FunctionsModule, FunctionName, FunctionNameRegistry, } from "./modules/functions.types.js";
+export type { AgentsModule, AgentName, AgentNameRegistry, AgentConversation, AgentMessage, AgentMessageReasoning, AgentMessageToolCall, AgentMessageUsage, AgentMessageCustomContext, AgentMessageMetadata, CreateConversationParams, } from "./modules/agents.types.js";
 export type { AppLogsModule } from "./modules/app-logs.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 export type { ConnectorsModule } from "./modules/connectors.types.js";

package/dist/modules/agents.js

@@ -3,8 +3,6 @@ export function createAgentsModule({ axios, getSocket, appId, serverUrl, token,
     const baseURL = `/apps/${appId}/agents`;
     // Track active conversations
     const currentConversations = {};
-    // Stores client tool handlers keyed by conversation ID
-    const clientToolHandlers = {};
     const getConversations = () => {
         return axios.get(`${baseURL}/conversations`);
     };
@@ -22,60 +20,6 @@ export function createAgentsModule({ axios, getSocket, appId, serverUrl, token,
     const addMessage = async (conversation, message) => {
         return axios.post(`${baseURL}/conversations/v2/${conversation.id}/messages`, message);
     };
-    const registerClientToolHandlers = (conversationId, handlers) => {
-        clientToolHandlers[conversationId] = {
-            ...(clientToolHandlers[conversationId] || {}),
-            ...handlers,
-        };
-    };
-    const submitToolResults = (conversationId, results) => {
-        return axios.post(`${baseURL}/conversations/${conversationId}/client-tool-results`, { results });
-    };
-    const handlePendingClientTools = async (conversationId, message) => {
-        var _a;
-        if (!(message === null || message === void 0 ? void 0 : message.tool_calls))
-            return false;
-        const pendingCalls = message.tool_calls.filter((tc) => tc.status === "pending_client_execution");
-        if (pendingCalls.length === 0)
-            return false;
-        const handlers = clientToolHandlers[conversationId];
-        if (!handlers)
-            return false;
-        const results = [];
-        for (const tc of pendingCalls) {
-            const handler = handlers[tc.name];
-            if (!handler) {
-                results.push({
-                    tool_call_id: tc.id,
-                    result: `Error: No handler registered for client tool '${tc.name}'`,
-                });
-                continue;
-            }
-            try {
-                const args = JSON.parse(tc.arguments_string);
-                const context = {
-                    appId,
-                    conversationId,
-                    toolCallId: tc.id,
-                    toolName: tc.name,
-                    messages: ((_a = currentConversations[conversationId]) === null || _a === void 0 ? void 0 : _a.messages) || [],
-                };
-                const result = await handler(args, context);
-                results.push({
-                    tool_call_id: tc.id,
-                    result: typeof result === "string" ? result : JSON.stringify(result),
-                });
-            }
-            catch (error) {
-                results.push({
-                    tool_call_id: tc.id,
-                    result: `Error executing client tool '${tc.name}': ${error.message}`,
-                });
-            }
-        }
-        await submitToolResults(conversationId, results);
-        return true;
-    };
     const subscribeToConversation = (conversationId, onUpdate) => {
         const room = `/agent-conversations/${conversationId}`;
         const socket = getSocket();
@@ -105,8 +49,6 @@ export function createAgentsModule({ axios, getSocket, appId, serverUrl, token,
                             messages: updatedMessages,
                         };
                         onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate(currentConversations[conversationId]);
-                        // Automatically handle pending client tool calls
-                        await handlePendingClientTools(conversationId, message);
                     }
                 }
             },
@@ -129,9 +71,6 @@ export function createAgentsModule({ axios, getSocket, appId, serverUrl, token,
         listConversations,
         createConversation,
         addMessage,
-        registerClientToolHandlers,
-        submitToolResults,
-        handlePendingClientTools,
         subscribeToConversation,
         getWhatsAppConnectURL,
     };

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

@@ -2,13 +2,19 @@ import { AxiosInstance } from "axios";
 import { RoomsSocket } from "../utils/socket-utils.js";
 import { ModelFilterParams } from "../types.js";
 /**
- * Registry of agent names.
- * Augment this interface to enable autocomplete for agent names.
+ * Registry of agent names. The [`types generate`](/developers/references/cli/commands/types-generate) command fills this registry, then [`AgentName`](#agentname) resolves to a union of the keys.
  */
 export interface AgentNameRegistry {
 }
 /**
- * Agent name type - uses registry keys if augmented, otherwise string.
+ * Union of all agent names from the [`AgentNameRegistry`](#agentnameregistry). Defaults to `string` when no types have been generated.
+ *
+ * @example
+ * ```typescript
+ * // Using generated agent name types
+ * // With generated types, you get autocomplete on agent names
+ * const conversation = await base44.agents.createConversation({ agent_name: 'SupportBot' });
+ * ```
  */
 export type AgentName = keyof AgentNameRegistry extends never ? string : keyof AgentNameRegistry;
 /**
@@ -37,7 +43,7 @@ export interface AgentMessageToolCall {
     /** Arguments passed to the tool as JSON string. */
     arguments_string: string;
     /** Status of the tool call. */
-    status: "running" | "success" | "error" | "stopped" | "pending_client_execution";
+    status: "running" | "success" | "error" | "stopped";
     /** Results from the tool call. */
     results?: string;
 }
@@ -141,37 +147,6 @@ export interface CreateConversationParams {
     /** Optional metadata to attach to the conversation. */
     metadata?: Record<string, any>;
 }
-/**
- * Context passed to client tool handlers during execution.
- */
-export interface ClientToolContext {
-    /** The app ID. */
-    appId: string;
-    /** The conversation ID. */
-    conversationId: string;
-    /** The unique tool call ID. */
-    toolCallId: string;
-    /** The tool name. */
-    toolName: string;
-    /** The conversation messages so far. */
-    messages: AgentMessage[];
-}
-/**
- * A client tool handler function.
- *
- * Receives parsed arguments and execution context, returns a string result
- * (or an object that will be JSON.stringified).
- */
-export type ClientToolHandler = (args: Record<string, any>, context: ClientToolContext) => Promise<string | Record<string, any>> | string | Record<string, any>;
-/**
- * Result of a client tool execution, to be submitted back to the server.
- */
-export interface ClientToolResult {
-    /** The tool call ID this result corresponds to. */
-    tool_call_id: string;
-    /** The result string. */
-    result: string;
-}
 /**
  * Configuration for creating the agents module.
  * @internal
@@ -215,6 +190,9 @@ export interface AgentsModuleConfig {
  * - **Anonymous or User authentication** (`base44.agents`): Access is scoped to the current user's permissions. Users must be authenticated to create and access conversations.
  * - **Service role authentication** (`base44.asServiceRole.agents`): Operations have elevated admin-level permissions. Can access all conversations that the app's admin role has access to.
  *
+ * ## Generated Types
+ *
+ * If you're working in a TypeScript project, you can generate types from your agents to get autocomplete on agent names when creating conversations or subscribing to updates. See the [Generated Types](/developers/references/sdk/getting-started/generated-types) guide to get started.
  */
 export interface AgentsModule {
     /**
@@ -239,7 +217,7 @@ export interface AgentsModule {
      * Gets a specific conversation by ID.
      *
      * Retrieves a single conversation using its unique identifier. To retrieve
-     * all conversations, use {@linkcode getConversations | getConversations()} To filter, sort, or paginate conversations, use {@linkcode listConversations | listConversations()}.
+     * all conversations, use {@linkcode getConversations | getConversations()}. To filter, sort, or paginate conversations, use {@linkcode listConversations | listConversations()}.
      *
      * This function returns the complete stored conversation including full tool call results, even for large responses.
      *
@@ -335,71 +313,6 @@ export interface AgentsModule {
      * ```
      */
     addMessage(conversation: AgentConversation, message: Partial<AgentMessage>): Promise<AgentMessage>;
-    /**
-     * Registers handler functions for client-side tools defined in the agent configuration.
-     *
-     * Client tools are tools that execute in the browser rather than on the server.
-     * They are defined by the app builder in the agent configuration (name, description,
-     * parameters). The SDK caller provides the handler functions that run locally when
-     * the agent invokes these tools.
-     *
-     * When subscribed to the conversation via {@linkcode subscribeToConversation | subscribeToConversation()},
-     * client tool calls are handled automatically — the SDK detects pending client tool calls,
-     * executes the registered handlers, and submits results back to the server.
-     *
-     * For user info inside a handler, call `base44.auth.me()` from the handler body.
-     *
-     * @param conversationId - The conversation ID to register handlers for.
-     * @param handlers - Map of tool name to handler function. Each handler receives
-     *   `(args, context)` where `args` are the parsed tool arguments and `context`
-     *   includes `appId`, `conversationId`, `toolCallId`, `toolName`, and `messages`.
-     *
-     * @example
-     * ```typescript
-     * base44.agents.registerClientToolHandlers(conversation.id, {
-     *   get_current_location: async ({ accuracy }, { conversationId, messages }) => {
-     *     const pos = await new Promise((resolve, reject) =>
-     *       navigator.geolocation.getCurrentPosition(resolve, reject, {
-     *         enableHighAccuracy: accuracy === 'high'
-     *       })
-     *     );
-     *     return JSON.stringify({
-     *       lat: pos.coords.latitude,
-     *       lng: pos.coords.longitude
-     *     });
-     *   },
-     *   get_clipboard_text: async () => {
-     *     return await navigator.clipboard.readText();
-     *   }
-     * });
-     * ```
-     */
-    registerClientToolHandlers(conversationId: string, handlers: Record<string, ClientToolHandler>): void;
-    /**
-     * Submits results for client-side tool calls.
-     *
-     * This is called automatically when using {@linkcode subscribeToConversation | subscribeToConversation()}
-     * with registered handlers. You only need to call this directly if you are
-     * implementing custom tool call handling logic outside of the subscription flow.
-     *
-     * @param conversationId - The conversation ID.
-     * @param results - Array of tool call results.
-     */
-    submitToolResults(conversationId: string, results: ClientToolResult[]): Promise<any>;
-    /**
-     * Processes pending client-side tool calls from a message.
-     *
-     * Finds tool calls with `pending_client_execution` status, executes their
-     * registered handlers, and submits the results back to the server.
-     *
-     * This is called automatically by {@linkcode subscribeToConversation | subscribeToConversation()}.
-     * You only need to call this directly for custom handling flows.
-     *
-     * @param conversationId - The conversation ID.
-     * @param message - The message containing tool calls.
-     * @returns `true` if client tool calls were processed, `false` otherwise.
-     */
-    handlePendingClientTools(conversationId: string, message: AgentMessage): Promise<boolean>;
     /**
      * Subscribes to realtime updates for a conversation.
      *
@@ -407,12 +320,9 @@ export interface AgentsModule {
      * messages are added to the conversation. Returns an unsubscribe function
      * to clean up the connection.
      *
-     * Client tool handlers registered via {@linkcode registerClientToolHandlers | registerClientToolHandlers()}
-     * are automatically executed when tool calls with `pending_client_execution` status arrive.
-     *
      * <Note>
-  When receiving messages through this function, tool call data is truncated for efficiency. The `arguments_string` is limited to 500 characters and `results` to 50 characters. The complete tool call data is always saved in storage and can be retrieved by calling {@linkcode getConversation | getConversation()} after the message completes.
-  </Note>
+     * When receiving messages through this function, tool call data is truncated for efficiency. The `arguments_string` is limited to 500 characters and `results` to 50 characters. The complete tool call data is always saved in storage and can be retrieved by calling {@linkcode getConversation | getConversation()} after the message completes.
+     * </Note>
      *
      * @param conversationId - The conversation ID to subscribe to.
      * @param onUpdate - Callback function called when the conversation is updated. The callback receives a conversation object with the following properties:

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

@@ -27,16 +27,16 @@ export type RealtimeCallback<T = any> = (event: RealtimeEvent<T>) => void;
  * Result returned when deleting a single entity.
  */
 export interface DeleteResult {
-    /** Whether the deletion was successful */
+    /** Whether the deletion was successful. */
     success: boolean;
 }
 /**
  * Result returned when deleting multiple entities.
  */
 export interface DeleteManyResult {
-    /** Whether the deletion was successful */
+    /** Whether the deletion was successful. */
     success: boolean;
-    /** Number of entities that were deleted */
+    /** Number of entities that were deleted. */
     deleted: number;
 }
 /**
@@ -45,11 +45,11 @@ export interface DeleteManyResult {
  * @typeParam T - The entity type for imported records. Defaults to `any`.
  */
 export interface ImportResult<T = any> {
-    /** Status of the import operation */
+    /** Status of the import operation. */
     status: "success" | "error";
-    /** Details message, e.g., "Successfully imported 3 entities with RLS enforcement" */
+    /** Details message, e.g., "Successfully imported 3 entities with RLS enforcement". */
     details: string | null;
-    /** Array of created entity objects when successful, or null on error */
+    /** Array of created entity objects when successful, or null on error. */
     output: T[] | null;
 }
 /**
@@ -88,13 +88,33 @@ interface ServerEntityFields {
     is_sample?: boolean;
 }
 /**
- * Registry mapping entity names to their TypeScript types.
- * Augment this interface with your entity schema (user-defined fields only).
+ * Registry mapping entity names to their TypeScript types. The [`types generate`](/developers/references/cli/commands/types-generate) command fills this registry, then [`EntityRecord`](#entityrecord) adds server fields.
  */
 export interface EntityTypeRegistry {
 }
 /**
- * Full record type for each entity: schema fields + server-injected fields (id, created_date, etc.).
+ * Combines the [`EntityTypeRegistry`](#entitytyperegistry) schemas with server fields like `id`, `created_date`, and `updated_date` to give the complete record type for each entity. Use this when you need to type variables holding entity data.
+ *
+ * @example
+ * ```typescript
+ * // Type-safe entity records
+ * import type { EntityRecord } from '@base44/sdk';
+ * // Import your generated entity schema
+ * import type { Task } from '@/base44/.types/types';
+ *
+ * // Combine your schema with server fields (id, created_date, etc.)
+ * type TaskRecord = EntityRecord['Task'];
+ *
+ * const task: TaskRecord = await base44.entities.Task.create({
+ *   title: 'My task',
+ *   status: 'pending'
+ * });
+ *
+ * // Task now includes both your fields and server fields:
+ * console.log(task.id);           // Server field
+ * console.log(task.created_date); // Server field
+ * console.log(task.title);        // Your field
+ * ```
  */
 export type EntityRecord = {
     [K in keyof EntityTypeRegistry]: EntityTypeRegistry[K] & ServerEntityFields;
@@ -401,7 +421,7 @@ type DynamicEntitiesModule = {
  * Entities are accessed dynamically using the pattern:
  * `base44.entities.EntityName.method()`
  *
- * This module is available to use with a client in all three authentication modes:
+ * This module is available to use with a client in all authentication modes:
  *
  * - **Anonymous or User authentication** (`base44.entities`): Access is scoped to the current user's permissions. Anonymous users can only access public entities, while authenticated users can access entities they have permission to view or modify.
  * - **Service role authentication** (`base44.asServiceRole.entities`): Operations have elevated admin-level permissions. Can access all entities that the app's admin role has access to.
@@ -412,6 +432,10 @@ type DynamicEntitiesModule = {
  *
  * Regular users can only read and update their own user record. With service role authentication, you can read, update, and delete any user. You can't create users using the entities module. Instead, use the functions of the {@link AuthModule | auth module} to invite or register new users.
  *
+ * ## Generated Types
+ *
+ * If you're working in a TypeScript project, you can generate types from your entity schemas to get autocomplete and type checking on all entity methods. See the [Generated Types](/developers/references/sdk/getting-started/generated-types) guide to get started.
+ *
  * @example
  * ```typescript
  * // Get all records from the MyEntity entity

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

@@ -1,11 +1,17 @@
 /**
- * Registry of function names.
- * Augment this interface to enable autocomplete for function names.
+ * Registry of function names. The [`types generate`](/developers/references/cli/commands/types-generate) command fills this registry, then [`FunctionName`](#functionname) resolves to a union of the keys.
  */
 export interface FunctionNameRegistry {
 }
 /**
- * Function name type - uses registry keys if augmented, otherwise string.
+ * Union of all function names from the [`FunctionNameRegistry`](#functionnameregistry). Defaults to `string` when no types have been generated.
+ *
+ * @example
+ * ```typescript
+ * // Using generated function name types
+ * // With generated types, you get autocomplete on function names
+ * await base44.functions.invoke('calculateTotal', { items: ['item1', 'item2'] });
+ * ```
  */
 export type FunctionName = keyof FunctionNameRegistry extends never ? string : keyof FunctionNameRegistry;
 /**
@@ -17,6 +23,10 @@ export type FunctionName = keyof FunctionNameRegistry extends never ? string : k
  *
  * - **Anonymous or User authentication** (`base44.functions`): Functions are invoked with the current user's permissions. Anonymous users invoke functions without authentication, while authenticated users invoke functions with their authentication context.
  * - **Service role authentication** (`base44.asServiceRole.functions`): Functions are invoked with elevated admin-level permissions. The function code receives a request with admin authentication context.
+ *
+ * ## Generated Types
+ *
+ * If you're working in a TypeScript project, you can generate types from your backend functions to get autocomplete on function names when calling `invoke()`. See the [Generated Types](/developers/references/sdk/getting-started/generated-types) guide to get started.
  */
 export interface FunctionsModule {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.19-pr.126.c537ed8",
+  "version": "0.8.19-pr.127.7353bb5",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",