@rool-dev/sdk 0.11.3-dev.a6a4bb1 → 0.11.4

package/README.md

@@ -4,9 +4,8 @@ TypeScript SDK for Rool, a persistent collaborative workspace for objects, AI-as
 
 Core primitives:
 
-- **Spaces** — containers for objects, schema, metadata, channels, collaborators, and files.
-- **Channels** — named contexts within a space for object operations and AI conversations.
-- **Conversations** — independent interaction histories within a channel.
+- **Spaces** — containers for objects, schema, metadata, conversations, collaborators, and files.
+- **Conversations** — independent interaction histories in a space.
 - **Objects** — JSON records addressed by object paths such as `/space/article/welcome.json`.
 - **Files** — user-visible files stored under `/rool-drive/...` through WebDAV.
 
@@ -31,36 +30,36 @@ async function main() {
   }
 
   const space = await client.createSpace('Solar System');
-  const channel = await space.openChannel('main');
+  const conversation = space.conversation('main');
 
-  await channel.createCollection('body', [
+  await conversation.createCollection('body', [
     { name: 'name', type: { kind: 'string' } },
     { name: 'mass', type: { kind: 'string' } },
     { name: 'radius', type: { kind: 'string' } },
     { name: 'orbits', type: { kind: 'maybe', inner: { kind: 'ref' } } },
   ]);
 
-  const { object: sun } = await channel.putObject('/space/body/sun.json', {
+  const { object: sun } = await conversation.putObject('/space/body/sun.json', {
     name: 'Sun',
     mass: '1 solar mass',
     radius: '696,340 km',
   });
 
-  const { object: earth } = await channel.putObject('/space/body/earth.json', {
+  const { object: earth } = await conversation.putObject('/space/body/earth.json', {
     name: 'Earth',
     mass: '1 Earth mass',
     radius: '6,371 km',
     orbits: sun.path,
   });
 
-  const { message, objects } = await channel.prompt(
+  const { message, objects } = await conversation.prompt(
     'Add the other planets in our solar system, each referencing the Sun.'
   );
 
   console.log(message);
   console.log(`Modified ${objects.length} objects`);
 
-  const loadedEarth = await channel.getObject(earth.path);
+  const loadedEarth = await space.getObject(earth.path);
   console.log(loadedEarth?.body.name);
 
   space.close();
@@ -230,58 +229,57 @@ that token to `client.verify(token)` once the link lands back in the app.
 
 A temporarily unreachable server never reads as "logged out". `initialize()` reports authentication from stored credentials, so on an offline start it can return `true` while `currentUser` is still `null` and user storage is empty — the SDK keeps reconnecting in the background and hydrates both automatically once the server is reachable, emitting `currentUserChanged`. Only an invalid or expired refresh token ends the session, via `authStateChanged(false)`.
 
-## Spaces and Channels
+## Spaces and Conversations
 
-Open a space to receive live events and manage collaborators, file storage, and channels. Open a channel to work with objects, schema, metadata, and AI.
+Open a space to receive live events and manage collaborators, file storage, and conversations. Open a conversation to work with objects, schema, metadata, and AI.
 
 ```typescript
 const space = await client.openSpace('space-id');
 
-space.on('channelCreated', (channel) => console.log(channel.id));
+const conversation = space.conversation('main');
 space.on('filesChanged', () => console.log('files changed'));
 
-const channel = await space.openChannel('main');
-await channel.prompt('Summarize this space');
+await conversation.prompt('Summarize this space');
 ```
 
-Channel IDs must be 1–32 characters and contain only letters, numbers, `_`, and `-`.
+Conversation IDs must be 1–32 characters and contain only letters, numbers, `_`, and `-`.
 
 ## Object Operations
 
 Objects are JSON files under `/space`. Create the collection before writing objects in it.
 
 ```typescript
-await channel.createCollection('article', [
+await conversation.createCollection('article', [
   { name: 'title', type: { kind: 'string' } },
   { name: 'status', type: { kind: 'string' } },
 ]);
 
 // Create or replace an exact object path
-const { object } = await channel.putObject('/space/article/welcome.json', {
+const { object } = await conversation.putObject('/space/article/welcome.json', {
   title: 'Welcome',
   status: 'draft',
 });
 
 // Patch fields; null or undefined deletes a field
-await channel.patchObject(object.path, {
+await conversation.patchObject(object.path, {
   data: { status: 'published', obsoleteField: null },
 });
 
 // Read one or many objects
-await channel.getObject('/space/article/welcome.json');
-await channel.getObjects([
+await space.getObject('/space/article/welcome.json');
+await space.getObjects([
   '/space/article/welcome.json',
   '/space/article/intro.json',
 ]);
 
 // Rename or move an object
-await channel.moveObject(
+await conversation.moveObject(
   '/space/article/welcome.json',
   '/space/article/hello-world.json'
 );
 
 // Delete objects
-await channel.deleteObjects(['/space/article/hello-world.json']);
+await conversation.deleteObjects(['/space/article/hello-world.json']);
 ```
 
 | Method | Description |
@@ -299,7 +297,7 @@ await channel.deleteObjects(['/space/article/hello-world.json']);
 `prompt()` invokes the AI agent. The agent can inspect space context and, unless `readOnly` or a read-only effort is used, create/modify/move/delete objects.
 
 ```typescript
-const { message, objects } = await channel.prompt(
+const { message, objects } = await conversation.prompt(
   'Create a topic node for the solar system, then child nodes for each planet.'
 );
 
@@ -322,12 +320,12 @@ console.log(objects.map((object) => object.path));
 
 ```typescript
 // Read-only quick question
-await channel.prompt('What topics are covered?', {
+await conversation.prompt('What topics are covered?', {
   effort: 'QUICK', // fast/read-only
 });
 
 // Focus on existing objects and files
-await channel.prompt('Compare these resources', {
+await conversation.prompt('Compare these resources', {
   attachments: [
     '/space/article/intro.json',
     'rool-machine:/rool-drive/docs/report.pdf',
@@ -335,12 +333,12 @@ await channel.prompt('Compare these resources', {
 });
 
 // Upload a local file as an attachment
-await channel.prompt('Describe this image', {
+await conversation.prompt('Describe this image', {
   attachments: [fileInput.files![0]],
 });
 
 // Structured response
-const { message } = await channel.prompt('Categorize these items', {
+const { message } = await conversation.prompt('Categorize these items', {
   responseSchema: {
     type: 'object',
     properties: {
@@ -353,7 +351,7 @@ const result = JSON.parse(message);
 
 // Stop a long prompt with a signal (when the caller holds the controller)
 const ac = new AbortController();
-const promptPromise = channel.prompt('Do a deep analysis', {
+const promptPromise = conversation.prompt('Do a deep analysis', {
   effort: 'RESEARCH',
   signal: ac.signal,
 });
@@ -365,39 +363,33 @@ await promptPromise;
 
 Use `signal` when the same call site cancels the prompt. When the Stop button
 lives elsewhere — a different component, after a reload, or a prompt another
-client started — stop by ID or stop the conversation's active interaction
-instead. Both are best-effort: the server halts the agent loop and closes the
-stream, but an LLM turn already in flight keeps generating server-side and is
-billed.
+client started — stop by interaction ID or through a conversation handle. Both
+are best-effort: the server halts the agent loop and closes the stream, but an
+LLM turn already in flight keeps generating server-side and is billed.
 
 ```typescript
-// Stop whatever is in flight on this channel's (default) conversation.
-// No-op returning false when nothing is running.
-await channel.stop();
-
-// Stop a specific interaction by ID (e.g. from channel.activeLeafId or
-// the interactions list). Returns whether the server stopped it.
-await channel.stopInteraction(channel.activeLeafId!);
+// Stop a specific interaction by ID (for example, from conversation.activeLeafId
+// or the interactions list). Returns whether the server stopped it.
+await space.stopInteraction(conversation.activeLeafId!);
 
 // Conversation handles stop their own in-flight interaction.
-const thread = channel.conversation('thread-42');
+const thread = space.conversation('thread-42');
 await thread.stop();
 ```
 
 | Method | Description |
 | --- | --- |
-| `stop(): Promise<boolean>` | Stop the in-flight interaction on the default conversation; `false` if none. |
 | `stopInteraction(id): Promise<boolean>` | Ask the server to stop a specific interaction by ID. |
 | `conversation.stop(): Promise<boolean>` | Stop a specific conversation's in-flight interaction. |
 
 ## Conversations
 
-Every channel has a default conversation. Use `channel.conversation(id)` for independent histories (for example, multiple chat threads). Conversations are represented as trees: interactions point at a `parentId`, and the SDK tracks an active leaf for each conversation.
+Use `space.conversation(id)` for independent histories (for example, multiple chat threads). Conversations are represented as trees: interactions point at a `parentId`, and the SDK tracks an active leaf for each conversation.
 
 ```typescript
-await channel.prompt('Hello'); // default conversation
+await conversation.prompt('Hello');
 
-const thread = channel.conversation('thread-42');
+const thread = space.conversation('thread-42');
 await thread.prompt('Hello from another thread');
 await thread.setSystemInstruction('Answer in haiku');
 
@@ -411,15 +403,14 @@ if (thread.activeLeafId) {
 
 | Method/property | Description |
 | --- | --- |
-| `channel.conversation(id): ConversationHandle` | Get a conversation-scoped handle. |
+| `space.conversation(id): ConversationHandle` | Get a conversation-scoped handle. |
 | `getInteractions(): Interaction[]` | Active branch as a flat list. |
 | `getTree(): Record<string, Interaction>` | Full interaction tree. |
 | `activeLeafId` | Current branch tip. |
 | `setActiveLeaf(id): void` | Switch branches. |
 | `getSystemInstruction()` / `setSystemInstruction(value)` | Manage conversation system instruction. Pass `null` to clear. |
-| `getConversations(): ConversationInfo[]` | List channel conversations (on `RoolChannel`). |
+| `getConversations(): ConversationInfo[]` | List conversations in the space. |
 | `deleteConversation(id): Promise<void>` | Delete a non-active conversation. |
-| `renameConversation(name): Promise<void>` | Rename the current/default conversation (on `RoolChannel`). |
 | `conversation.rename(name): Promise<void>` | Rename a specific conversation handle. |
 
 `ConversationHandle` also supports conversation-scoped `putObject`, `patchObject`, `moveObject`, `deleteObjects`, `prompt`, `stop`, collection-schema methods, and `setMetadata`.
@@ -429,7 +420,7 @@ if (thread.activeLeafId) {
 Collections define the schema visible to the AI agent. Hidden body fields whose names start with `_` are useful for app/UI state that should not be considered by AI.
 
 ```typescript
-await channel.createCollection('article', {
+await conversation.createCollection('article', {
   schemaOrgType: 'Article',
   fields: [
     { name: 'title', type: { kind: 'string' } },
@@ -439,15 +430,15 @@ await channel.createCollection('article', {
   ],
 });
 
-const schema = channel.getSchema();
+const schema = space.getSchema();
 
-await channel.alterCollection('article', [
+await conversation.alterCollection('article', [
   { name: 'title', type: { kind: 'string' } },
   { name: 'status', type: { kind: 'string' } },
 ]);
 
-channel.setMetadata('viewport', { x: 0, y: 0, zoom: 1 });
-const viewport = channel.getMetadata('viewport');
+conversation.setMetadata('viewport', { x: 0, y: 0, zoom: 1 });
+const viewport = space.getMetadata('viewport');
 ```
 
 | Method | Description |
@@ -464,14 +455,14 @@ Field kinds: `string`, `number`, `boolean`, `ref`, `enum`, `literal`, `array`, a
 
 ## Undo/Redo
 
-Undo/redo uses checkpoints for the current channel ID. A checkpoint captures space state; call `checkpoint()` before a user action you want to make undoable.
+Undo/redo uses checkpoints over the whole space. A checkpoint captures space state; call `checkpoint()` before a user action you want to make undoable.
 
 ```typescript
-await channel.checkpoint('Delete article');
-await channel.deleteObjects(['/space/article/welcome.json']);
+await space.checkpoint('Delete article');
+await conversation.deleteObjects(['/space/article/welcome.json']);
 
-if (await channel.canUndo()) {
-  await channel.undo();
+if (await space.canUndo()) {
+  await space.undo();
 }
 ```
 
@@ -484,7 +475,7 @@ if (await channel.canUndo()) {
 | `redo(): Promise<boolean>` | Reapply undone work. |
 | `clearHistory(): Promise<void>` | Clear checkpoint history. |
 
-Undo/redo availability and history are scoped to the channel handle (`channel.channelId`).
+Undo/redo availability and history are scoped to the space.
 
 ## File Storage and WebDAV
 
@@ -650,7 +641,7 @@ const client = new RoolClient({
 | `getAllUserStorage(): Record<string, unknown>` | Copy all cached user storage. |
 | `reportEvent(event, url?): void` | Fire-and-forget telemetry event. |
 | `destroy(): void` | Close subscriptions, spaces, auth resources, and listeners. |
-| `generateId(): string` | Generate a 6-character alphanumeric ID. |
+| `generateId(): string` | Generate a unique ID suitable for conversation IDs. |
 
 ### Client events
 
@@ -660,9 +651,6 @@ client.on('currentUserChanged', (user) => void 0); // CurrentUser | null; null o
 client.on('spaceAdded', (space) => void 0);
 client.on('spaceRemoved', (spaceId) => void 0);
 client.on('spaceRenamed', (spaceId, newName) => void 0);
-client.on('channelCreated', (spaceId, channel) => void 0);
-client.on('channelUpdated', (spaceId, channel) => void 0);
-client.on('channelDeleted', (spaceId, channelId) => void 0);
 client.on('userStorageChanged', ({ key, value, source }) => void 0);
 client.on('connectionStateChanged', (state) => void 0);
 client.on('error', (error, context) => void 0);
@@ -670,12 +658,18 @@ client.on('error', (error, context) => void 0);
 
 ## RoolSpace API
 
-Properties: `id`, `name`, `role`, `memberCount`, `channels`, `route`, `webdav`.
+Properties: `id`, `name`, `role`, `memberCount`, `conversations`, `route`, `webdav`.
 
 | Method | Description |
 | --- | --- |
-| `openChannel(channelId): Promise<RoolChannel>` | Open/create a channel. |
-| `close(): void` | Stop subscription and close open channels. |
+| `conversation(conversationId): ConversationHandle` | Get a conversation-scoped handle. |
+| `getObject`, `getObjects`, `stat` | Read object data and stats. |
+| `getConversations`, `deleteConversation` | List and delete conversations. |
+| `getMetadata`, `getAllMetadata`, `getSchema` | Read metadata and schema. |
+| `checkpoint`, `canUndo`, `canRedo`, `undo`, `redo`, `clearHistory` | Space history controls. |
+| `stopInteraction(interactionId): Promise<boolean>` | Stop an in-flight interaction by ID. |
+| `fetch(url, init?): Promise<Response>` | Proxy an external HTTP request through the server to bypass browser CORS. |
+| `close(): void` | Stop the space subscription. |
 | `rename(newName): Promise<void>` | Rename the space. |
 | `delete(): Promise<void>` | Permanently delete the space. |
 | `listUsers(): Promise<SpaceMember[]>` | List collaborators. |
@@ -684,8 +678,6 @@ Properties: `id`, `name`, `role`, `memberCount`, `channels`, `route`, `webdav`.
 | `createInvite(role, options?): Promise<SpaceInviteCreated>` | Mint an invite link; `options` takes `email`, `expiresInDays`, `maxUses`. |
 | `listInvites(): Promise<SpaceInvite[]>` | List currently redeemable invites. |
 | `revokeInvite(inviteId): Promise<boolean>` | Revoke an invite so its link stops working. |
-| `renameChannel(channelId, name): Promise<void>` | Rename a channel. |
-| `deleteChannel(channelId): Promise<void>` | Delete a channel and history. |
 | `exportArchive(): Promise<Blob>` | Export a space archive. |
 | `refresh(): Promise<void>` | Refresh cached space data. |
 | `fetchPath(path, options?): Promise<Response>` | Fetch a `/rool-drive/...` file. |
@@ -694,42 +686,15 @@ Properties: `id`, `name`, `role`, `memberCount`, `channels`, `route`, `webdav`.
 Events:
 
 ```typescript
-space.on('channelCreated', (channel) => void 0);
-space.on('channelUpdated', (channel) => void 0);
-space.on('channelDeleted', (channelId) => void 0);
+space.on('metadataUpdated', ({ metadata, source }) => void 0);
+space.on('schemaUpdated', ({ schema, source }) => void 0);
+space.on('conversationUpdated', ({ conversationId, source }) => void 0);
+space.on('reset', ({ source }) => void 0);
+space.on('syncError', (error) => void 0);
 space.on('filesChanged', ({ spaceId, source, timestamp }) => void 0);
 space.on('filesReset', ({ spaceId, source, timestamp }) => void 0);
 space.on('connectionStateChanged', (state) => void 0);
 ```
-
-## RoolChannel API
-
-Properties: `id` (space ID), `name` (space name), `role`, `userId`, `channelId`, `channelName`, `conversationId`, `isReadOnly`, `activeLeafId`.
-
-| Area | Methods |
-| --- | --- |
-| Lifecycle | `close()`, `rename(name)`, `conversation(id)` |
-| Objects | `getObject`, `getObjects`, `stat`, `putObject`, `patchObject`, `moveObject`, `deleteObjects` |
-| Schema | `getSchema`, `createCollection`, `alterCollection`, `dropCollection` |
-| Metadata | `setMetadata`, `getMetadata`, `getAllMetadata` |
-| Conversations | `getInteractions`, `getTree`, `setActiveLeaf`, `getConversations`, `deleteConversation`, `getSystemInstruction`, `setSystemInstruction`, `renameConversation` |
-| AI | `prompt`, `stop`, `stopInteraction` |
-| Undo/redo | `checkpoint`, `canUndo`, `canRedo`, `undo`, `redo`, `clearHistory` |
-| Utilities | `fetch(url, init?)` server-side proxied fetch |
-
-Channel events:
-
-```typescript
-channel.on('metadataUpdated', ({ metadata, source }) => void 0);
-channel.on('schemaUpdated', ({ schema, source }) => void 0);
-channel.on('channelUpdated', ({ channelId, source }) => void 0);
-channel.on('conversationUpdated', ({ conversationId, channelId, source }) => void 0);
-channel.on('reset', ({ source }) => void 0);
-channel.on('syncError', (error) => void 0);
-```
-
-`channel.fetch(url, init?)` proxies external HTTP requests through the server to bypass browser CORS.
-
 ## Import/Export
 
 ```typescript
@@ -737,7 +702,7 @@ const archive = await space.exportArchive();
 const imported = await client.importArchive('Imported Data', archive);
 ```
 
-Archives include objects, metadata, channels/conversations, and file storage.
+Archives include objects, metadata, conversations, and file storage.
 
 ## Data Types
 
@@ -839,7 +804,6 @@ interface RoolObjectStat {
   modifiedAt: number;
   modifiedBy: string;
   modifiedByName: string | null;
-  modifiedInChannel: string;
   modifiedInConversation: string | null;
   modifiedInInteraction: string | null;
 }

package/dist/client.d.ts

@@ -4,12 +4,11 @@ import type { RoolClientConfig, RoolClientEvents, RoolSpaceInfo, CurrentUser, In
 /**
  * Rool Client - Manages authentication, space lifecycle, and shared infrastructure.
  *
- * The client is lightweight - most operations happen on RoolSpace and RoolChannel instances.
+ * The client is lightweight - most operations happen on RoolSpace instances.
  *
  * Features:
  * - Authentication (login, logout, token management)
  * - Space lifecycle (list, create, delete, rename)
- * - Channel management (open, list, rename, delete)
  * - Client-level subscription for lifecycle events
  * - User storage (cross-device key-value storage)
  */
@@ -137,7 +136,7 @@ export declare class RoolClient extends EventEmitter<RoolClientEvents> {
     listSpaces(): Promise<RoolSpaceInfo[]>;
     /**
      * Open a space with a real-time subscription.
-     * Returns a live RoolSpace handle with channel lifecycle events.
+     * Returns a live RoolSpace handle with conversation and file events.
      * Reuses an existing handle if the space is already open.
      *
      * Call space.close() when done to stop the subscription.
@@ -146,12 +145,12 @@ export declare class RoolClient extends EventEmitter<RoolClientEvents> {
     /**
      * Create a new space.
      * Returns a RoolSpace handle with a real-time subscription.
-     * Call space.openChannel(channelId) to start working with objects.
+     * Use the returned RoolSpace to work with objects, conversations, and AI.
      */
     createSpace(name: string): Promise<RoolSpace>;
     /**
      * Delete a space.
-     * Note: This does not affect any open Channel instances - they become stale.
+     * Note: This closes any cached open RoolSpace handle.
      */
     deleteSpace(spaceId: string): Promise<void>;
     /**
@@ -238,8 +237,6 @@ export declare class RoolClient extends EventEmitter<RoolClientEvents> {
     _graphql<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
     /**
      * Handle a client-level event from the subscription.
-     * Channel events from the client SSE are ignored — they're handled by
-     * the space subscription via RoolSpace instead.
      * @internal
      */
     private handleClientEvent;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -3,19 +3,26 @@ import { AuthManager } from './auth.js';
 import { GraphQLClient } from './graphql.js';
 import { ClientSubscriptionManager } from './subscription.js';
 import { RestClient } from './rest.js';
-import { generateEntityId } from './channel.js';
 import { RoolSpace } from './space.js';
 import { SpaceRouter } from './router.js';
 import { defaultLogger } from './logger.js';
+function generateEntityId() {
+    const alphabet = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_-';
+    const bytes = new Uint8Array(16);
+    globalThis.crypto.getRandomValues(bytes);
+    let id = '';
+    for (let i = 0; i < 16; i++)
+        id += alphabet[bytes[i] & 63];
+    return id;
+}
 /**
  * Rool Client - Manages authentication, space lifecycle, and shared infrastructure.
  *
- * The client is lightweight - most operations happen on RoolSpace and RoolChannel instances.
+ * The client is lightweight - most operations happen on RoolSpace instances.
  *
  * Features:
  * - Authentication (login, logout, token management)
  * - Space lifecycle (list, create, delete, rename)
- * - Channel management (open, list, rename, delete)
  * - Client-level subscription for lifecycle events
  * - User storage (cross-device key-value storage)
  */
@@ -27,7 +34,7 @@ export class RoolClient extends EventEmitter {
     router;
     subscriptionManager = null;
     logger;
-    // Open spaces (cached for reuse by openChannel)
+    // Open spaces (cached for reuse)
     openSpaces = new Map();
     // User storage cache (in-memory; populated from server on initialize)
     _storageCache = {};
@@ -134,7 +141,7 @@ export class RoolClient extends EventEmitter {
     destroy() {
         this.authManager.destroy();
         this.subscriptionManager?.destroy();
-        // Close all open spaces (which close their channels and subscriptions)
+        // Close all open spaces and subscriptions
         for (const space of this.openSpaces.values())
             space.close();
         this.openSpaces.clear();
@@ -222,7 +229,7 @@ export class RoolClient extends EventEmitter {
     logout() {
         this.authManager.logout();
         this.unsubscribe();
-        // Close all open spaces (which close their channels and subscriptions)
+        // Close all open spaces and subscriptions
         for (const space of this.openSpaces.values())
             space.close();
         this.openSpaces.clear();
@@ -271,7 +278,7 @@ export class RoolClient extends EventEmitter {
     }
     /**
      * Open a space with a real-time subscription.
-     * Returns a live RoolSpace handle with channel lifecycle events.
+     * Returns a live RoolSpace handle with conversation and file events.
      * Reuses an existing handle if the space is already open.
      *
      * Call space.close() when done to stop the subscription.
@@ -311,22 +318,12 @@ export class RoolClient extends EventEmitter {
             onClose: () => this.openSpaces.delete(spaceId),
         });
         this.openSpaces.set(spaceId, space);
-        // Forward space channel events to client-level events (backwards compat)
-        space.on('channelCreated', (channel) => {
-            this.emit('channelCreated', spaceId, channel);
-        });
-        space.on('channelUpdated', (channel) => {
-            this.emit('channelUpdated', spaceId, channel);
-        });
-        space.on('channelDeleted', (channelId) => {
-            this.emit('channelDeleted', spaceId, channelId);
-        });
         return space;
     }
     /**
      * Create a new space.
      * Returns a RoolSpace handle with a real-time subscription.
-     * Call space.openChannel(channelId) to start working with objects.
+     * Use the returned RoolSpace to work with objects, conversations, and AI.
      */
     async createSpace(name) {
         // Prevents a rejection here from crashing Node before the caller awaits it.
@@ -336,7 +333,7 @@ export class RoolClient extends EventEmitter {
     }
     /**
      * Delete a space.
-     * Note: This does not affect any open Channel instances - they become stale.
+     * Note: This closes any cached open RoolSpace handle.
      */
     async deleteSpace(spaceId) {
         await this.graphqlClient.deleteSpace(spaceId);
@@ -521,8 +518,6 @@ export class RoolClient extends EventEmitter {
     }
     /**
      * Handle a client-level event from the subscription.
-     * Channel events from the client SSE are ignored — they're handled by
-     * the space subscription via RoolSpace instead.
      * @internal
      */
     handleClientEvent(event) {
@@ -567,11 +562,6 @@ export class RoolClient extends EventEmitter {
             case 'user_storage_changed':
                 this.handleUserStorageChanged(event.key, event.value);
                 break;
-            // Channel events from client SSE are ignored — handled by RoolSpace
-            case 'channel_created':
-            case 'channel_renamed':
-            case 'channel_deleted':
-                break;
         }
     }
     /**