@erdoai/server 0.1.9 → 0.1.10

package/dist/index.d.ts

@@ -22,7 +22,36 @@ declare class ErdoClient {
      * The returned token can be passed to a client-side ErdoClient for
      * scoped access to specific bots.
      *
-     * @example
+     * ## External User IDs
+     *
+     * Use `externalUserId` to associate threads with your users. This enables:
+     * - `listThreads()` returns only that user's threads
+     * - Thread access is automatically scoped to the user
+     *
+     * **Important**: Store the external user ID in your database so you can
+     * create tokens with the same ID when the user returns:
+     *
+     * ```typescript
+     * // In your database (e.g., users table):
+     * // { id: 'user-abc', email: '...', erdo_external_user_id: 'ext-123' }
+     *
+     * // When creating tokens, use the stored ID:
+     * const user = await db.users.find(userId);
+     * const { token } = await serverClient.createToken({
+     *   botKeys: ['my-org.data-analyst'],
+     *   externalUserId: user.erdo_external_user_id,  // Persisted ID
+     *   expiresInSeconds: 3600,
+     * });
+     *
+     * // User can now list their threads from previous sessions
+     * const { threads } = await clientClient.listThreads();
+     * ```
+     *
+     * The external user ID can be your own user ID or a separate UUID you generate
+     * once per user and store. It's embedded in the token and never exposed to
+     * the client - users cannot access other users' threads.
+     *
+     * @example Basic token creation
      * ```typescript
      * // Server-side: Create a token for the frontend
      * const serverClient = new ErdoClient({ authToken: process.env.ERDO_AUTH_TOKEN });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/server",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Erdo server SDK for invoking agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,7 +40,7 @@
     "directory": "packages/server"
   },
   "dependencies": {
-    "@erdoai/types": "^0.1.8"
+    "@erdoai/types": "^0.1.9"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",