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

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
 
@@ -625,12 +616,19 @@ const client = new RoolClient({
   apiUrl: 'https://api.rool.dev',
   authUrl: 'https://rool.dev/auth',
   graphqlUrl: 'https://api.rool.dev/graphql',
+  client: {
+    appName: 'com.example.app',
+    appVersion: '1.4.2',
+    osVersion: 'iOS 17.5',
+  },
   logger: console,
 });
 ```
 
 `apiUrl` defaults to `https://api.rool.dev`; `authUrl` is derived by stripping the `api.` hostname prefix unless provided. `baseUrl` is still accepted as a deprecated alias for `apiUrl`. Pass `authProvider` for Node.js, Electron, or custom auth flows.
 
+`client` is optional application identity sent on requests alongside the SDK package name/version. Compatibility is based only on the SDK version.
+
 | Method/property | Description |
 | --- | --- |
 | `currentUser: CurrentUser | null` | Cached user profile from initialization/fetch. |
@@ -650,7 +648,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,22 +658,27 @@ 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);
+client.on('serverInfoChanged', (info) => void 0);
+client.on('unsupported', (info) => void 0); // SDK older than server minimum
 ```
 
 ## 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 +687,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 +695,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 +711,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 +813,6 @@ interface RoolObjectStat {
   modifiedAt: number;
   modifiedBy: string;
   modifiedByName: string | null;
-  modifiedInChannel: string;
   modifiedInConversation: string | null;
   modifiedInInteraction: string | null;
 }

package/dist/client-info.d.ts

@@ -0,0 +1,18 @@
+export interface RoolClientIdentity {
+    /** Application name, e.g. com.example.app or my-web-app. */
+    appName?: string;
+    /** Application version, e.g. 1.4.2. */
+    appVersion?: string;
+    /** Operating system version, e.g. iOS 17.5 or Android 15. */
+    osVersion?: string;
+}
+export interface RoolClientInfo {
+    sdkName: string;
+    sdkVersion: string;
+    identity: RoolClientIdentity;
+}
+export declare const roolSdkVersion: string;
+export declare function resolveClientInfo(identity?: RoolClientIdentity): RoolClientInfo;
+export declare function addClientInfoHeaders(headers: Headers, clientInfo: RoolClientInfo): void;
+export declare function clientInfoHeaderRecord(clientInfo: RoolClientInfo): Record<string, string>;
+//# sourceMappingURL=client-info.d.ts.map

package/dist/client-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-info.d.ts","sourceRoot":"","sources":["../src/client-info.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAM/E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,GAAG,IAAI,CAOvF;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIzF"}

package/dist/client-info.js

@@ -0,0 +1,25 @@
+import pkg from '../package.json' with { type: 'json' };
+export const roolSdkVersion = pkg.version;
+export function resolveClientInfo(identity) {
+    return {
+        sdkName: pkg.name,
+        sdkVersion: pkg.version,
+        identity: identity ?? {},
+    };
+}
+export function addClientInfoHeaders(headers, clientInfo) {
+    headers.set('X-Rool-SDK-Name', clientInfo.sdkName);
+    headers.set('X-Rool-SDK-Version', clientInfo.sdkVersion);
+    if (clientInfo.identity.appName)
+        headers.set('X-Rool-App-Name', clientInfo.identity.appName);
+    if (clientInfo.identity.appVersion)
+        headers.set('X-Rool-App-Version', clientInfo.identity.appVersion);
+    if (clientInfo.identity.osVersion)
+        headers.set('X-Rool-OS-Version', clientInfo.identity.osVersion);
+}
+export function clientInfoHeaderRecord(clientInfo) {
+    const headers = new Headers();
+    addClientInfoHeaders(headers, clientInfo);
+    return Object.fromEntries(headers.entries());
+}
+//# sourceMappingURL=client-info.js.map

package/dist/client-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-info.js","sourceRoot":"","sources":["../src/client-info.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAiBxD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC;AAE1C,MAAM,UAAU,iBAAiB,CAAC,QAA6B;IAC7D,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,UAAU,EAAE,GAAG,CAAC,OAAO;QACvB,QAAQ,EAAE,QAAQ,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,UAA0B;IAC/E,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAEzD,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7F,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU;QAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtG,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAA0B;IAC/D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC"}

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)
  */
@@ -21,6 +20,8 @@ export declare class RoolClient extends EventEmitter<RoolClientEvents> {
     private router;
     private subscriptionManager;
     private logger;
+    private clientInfo;
+    private _serverInfo;
     private openSpaces;
     private _storageCache;
     private _currentUser;
@@ -131,13 +132,18 @@ export declare class RoolClient extends EventEmitter<RoolClientEvents> {
      * Available after successful authentication.
      */
     get currentUser(): CurrentUser | null;
+    get serverInfo(): {
+        version: string;
+        minimumSdkVersion?: string | null;
+        compatibility: 'ok' | 'unsupported';
+    } | null;
     /**
      * List all spaces accessible to the user.
      */
     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 +152,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 +244,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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"}