@base44-preview/sdk 0.8.57-pr.361.dda0ab9 → 0.8.57-pr.362.129f8e2

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

@@ -193,7 +193,7 @@ export interface AgentsModuleConfig {
  *
  * This module is available to use with a client in all authentication modes:
  *
- * - **Anonymous or User authentication** (`base44.agents`): Access is scoped to the current user's permissions. Users must be authenticated to create and access conversations.
+ * - **Anonymous or User authentication** (`base44.agents`): Access is scoped to the current user's permissions. Users must be authenticated to create and access conversations. Each user can read and add messages only to conversations they created.
  * - **Service role authentication** (`base44.asServiceRole.agents`): Operations are invoked with the service role for backend code that needs elevated permissions.
  *
  * ## Generated Types
@@ -222,7 +222,7 @@ export interface AgentsModule {
     /**
      * Gets a specific conversation by ID.
      *
-     * Retrieves a single conversation using its unique identifier. To retrieve
+     * Retrieves a single conversation using its unique identifier. The conversation must belong to the current user. If another user created it, the request fails with a `403` error. To retrieve
      * all of the current user's 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.
@@ -239,14 +239,14 @@ export interface AgentsModule {
      * }
      * ```
      *
-     * @see {@linkcode getConversations | getConversations()} for retrieving all conversations
+     * @see {@linkcode getConversations | getConversations()} for retrieving all of the current user's conversations
      * @see {@linkcode listConversations | listConversations()} for filtering and sorting conversations
      */
     getConversation(conversationId: string): Promise<AgentConversation | undefined>;
     /**
-     * Lists conversations with filtering, sorting, and pagination.
+     * Lists the current user's conversations with filtering, sorting, and pagination.
      *
-     * Provides querying capabilities including filtering by fields, sorting, pagination, and field selection. For cases where you need all of the current user's conversations without filtering, use {@linkcode getConversations | getConversations()}. To retrieve a specific conversation by ID, use {@linkcode getConversation | getConversation()}.
+     * Provides querying capabilities including filtering by fields, sorting, pagination, and field selection. Results only include conversations the current user created, even if `q` filters on a different `created_by_id`. For cases where you need all of the current user's conversations without filtering, use {@linkcode getConversations | getConversations()}. To retrieve a specific conversation by ID, use {@linkcode getConversation | getConversation()}.
      *
      * @param filterParams - Filter parameters for querying conversations.
      * @returns Promise resolving to an array of filtered conversations.
@@ -273,13 +273,15 @@ export interface AgentsModule {
      * });
      * ```
      *
-     * @see {@linkcode getConversations | getConversations()} for retrieving all conversations without filtering
+     * @see {@linkcode getConversations | getConversations()} for retrieving all of the current user's conversations without filtering
      * @see {@linkcode getConversation | getConversation()} for retrieving a specific conversation by ID
      */
     listConversations(filterParams: ModelFilterParams): Promise<AgentConversation[]>;
     /**
      * Creates a new conversation with an agent.
      *
+     * The conversation belongs to the current user. Only that user can read it or add messages to it.
+     *
      * @param conversation - Conversation details including agent name and optional metadata.
      * @returns Promise resolving to the created conversation.
      *
@@ -301,7 +303,7 @@ export interface AgentsModule {
     /**
      * Adds a message to a conversation.
      *
-     * Sends a message to the agent and updates the conversation. This method
+     * Sends a message to the agent and updates the conversation. You can only add messages to conversations the current user created. This method
      * also updates the realtime socket to notify any subscribers.
      *
      * @param conversation - The conversation to add the message to.
@@ -323,7 +325,7 @@ export interface AgentsModule {
      * Subscribes to realtime updates for a conversation.
      *
      * Establishes a WebSocket connection to receive instant updates when new
-     * messages are added to the conversation. Returns an unsubscribe function
+     * messages are added to the conversation. You can only subscribe to conversations the current user created. Returns an unsubscribe function
      * to clean up the connection.
      *
      * <Note>

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

@@ -777,6 +777,8 @@ export interface EntityHandler<T = any> {
      * records first and then updates them. Learn more about
      * [concurrent updates](/developers/backend/resources/entities/entity-schemas#concurrent-updates).
      *
+     * This method isn't available for the built-in `User` entity, and calling it fails with a 405 error.
+     *
      * To update a single record by ID, use {@linkcode update | update()} instead. To update
      * multiple specific records with different data each, use {@linkcode bulkUpdate | bulkUpdate()}.
      *
@@ -1017,6 +1019,8 @@ export interface EntityHandler<T = any> {
      *
      * You can update up to 500 records per request.
      *
+     * This method isn't available for the built-in `User` entity, and calling it fails with a 405 error.
+     *
      * This isn't a transaction. Each record is written on its own, so if the call
      * fails partway, the records already written stay written. Learn more about
      * [concurrent updates](/developers/backend/resources/entities/entity-schemas#concurrent-updates).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.57-pr.361.dda0ab9",
+  "version": "0.8.57-pr.362.129f8e2",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",