@base44-preview/sdk 0.8.57-pr.361.dda0ab9 → 0.8.57-pr.362.2ee7c13

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

@@ -193,8 +193,8 @@ 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.
- * - **Service role authentication** (`base44.asServiceRole.agents`): Operations are invoked with the service role for backend code that needs elevated permissions.
+ * - **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, even if they have the admin role.
+ * - **Service role authentication** (`base44.asServiceRole.agents`): Operations are invoked with the service role for backend code that needs elevated permissions. This module only reaches conversations created through the service role, so it doesn't give your backend access to conversations that individual users created.
  *
  * ## Generated Types
  *
@@ -204,7 +204,7 @@ export interface AgentsModule {
     /**
      * Gets the current user's conversations with all agents in the app.
      *
-     * Retrieves every conversation the current user started, across all agents. Conversations that other users started aren't included. Use {@linkcode listConversations | listConversations()} to filter which conversations are returned, apply sorting, or paginate results. Use {@linkcode getConversation | getConversation()} to retrieve a specific conversation by ID.
+     * Retrieves every conversation the current user started, across all agents. Conversations that other users started aren't included, even if the current user has the admin role. When you call this method through `base44.asServiceRole.agents`, it returns only the conversations created through the service role, not the conversations that your users created. Use {@linkcode listConversations | listConversations()} to filter which conversations are returned, apply sorting, or paginate results. Use {@linkcode getConversation | getConversation()} to retrieve a specific conversation by ID.
      *
      * @returns Promise resolving to an array of conversations.
      *
@@ -222,13 +222,13 @@ 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. If no conversation has that ID, the request fails with a `404` 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.
      *
      * @param conversationId - The unique identifier of the conversation.
-     * @returns Promise resolving to the conversation, or undefined if not found.
+     * @returns Promise resolving to the conversation.
      *
      * @example
      * ```typescript
@@ -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`. When you call this method through `base44.asServiceRole.agents`, results only include conversations created through the service role. 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

@@ -45,7 +45,7 @@ export interface DeleteManyResult {
 export interface UpdateManyResult {
     /** Whether the operation was successful. */
     success: boolean;
-    /** Number of entities that were updated. */
+    /** Number of entities that were updated. This includes records that already held the new values, because every update refreshes `updated_date`. */
     updated: number;
     /** Whether there are more entities matching the query that were not updated in this batch. When `true`, call `updateMany` again with the same query to update the next batch. */
     has_more: boolean;
@@ -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,8 +1019,13 @@ export interface EntityHandler<T = any> {
      *
      * You can update up to 500 records per request.
      *
-     * 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
+     * This method isn't available for the built-in `User` entity, and calling it fails with a 405 error.
+     *
+     * This isn't a transaction. Before writing, the call checks every record. If an `id`
+     * doesn't match a record you can update, or a change isn't allowed or doesn't match the
+     * entity's schema, the call fails and no records change. After the checks pass, each
+     * record is written on its own, so if a write fails partway, the records already written
+     * stay written. Learn more about
      * [concurrent updates](/developers/backend/resources/entities/entity-schemas#concurrent-updates).
      *
      * To apply the same update to all records matching a query, use

package/package.json

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