@base44-preview/sdk 0.8.57-pr.362.129f8e2 → 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. 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.
+ * - **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. The conversation must belong to the current user. If another user created it, the request fails with a `403` error. 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
@@ -246,7 +246,7 @@ export interface AgentsModule {
     /**
      * Lists the current user's conversations with filtering, sorting, and pagination.
      *
-     * 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()}.
+     * 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.

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;
@@ -1021,8 +1021,11 @@ export interface EntityHandler<T = any> {
      *
      * 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
+     * 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.362.129f8e2",
+  "version": "0.8.57-pr.362.2ee7c13",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",