[abrahams-wix]

Summary

JSDoc fixes from reader and Customer Care feedback.

This PR is stacked on #361. Its base is docs-feedback-fixes, so the diff shows only these changes. Retarget it to main once #361 merges.

Agents module (packages/sdk/src/modules/agents.types.ts)

• The module description says each user can read and add messages only to conversations they created, even with the admin role.
• With base44.asServiceRole.agents, the module only reaches conversations created through the service role. It doesn't give your backend access to conversations that individual users created.
• getConversation() says the conversation must belong to the current user (otherwise a 403 error), and that a missing conversation fails with a 404 error. @returns no longer says it resolves to undefined.
• listConversations(), createConversation(), addMessage(), and subscribeToConversation() say the conversation belongs to the current user.

Entities module (packages/sdk/src/modules/entities.types.ts)

• updateMany() and bulkUpdate() say they aren't available for the built-in User entity and fail with a 405 error.
• UpdateManyResult.updated includes records that already held the new values, because every update refreshes updated_date.
• bulkUpdate() says the call checks every record before writing. If a check fails, no records change. If a write fails partway, earlier records stay written.

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.57-pr.362.26c8eba

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/sdk:

npm i "@base44/sdk@npm:@base44-preview/sdk@0.8.57-pr.362.26c8eba"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.57-pr.362.26c8eba"
  }
}

• 📦 Preview Package: @base44-preview/sdk@0.8.57-pr.362.26c8eba
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}