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

package/README.md

@@ -14,12 +14,12 @@ npm install @rool-dev/svelte
 
 ```svelte
 <script lang="ts">
-  import { createRool, type ReactiveChannel } from '@rool-dev/svelte';
+  import { createRool, type ReactiveSpace, type ReactiveConversationHandle } from '@rool-dev/svelte';
 
   const rool = createRool();
   void rool.init();
 
-  let channel = $state<ReactiveChannel | null>(null);
+  let space = $state<ReactiveSpace | null>(null);
 </script>
 
 {#if rool.authenticated === null}
@@ -30,15 +30,15 @@ npm install @rool-dev/svelte
   <h1>My Spaces</h1>
   {#each rool.spaces ?? [] as spaceInfo}
     <button onclick={async () => {
-      const space = await rool.openSpace(spaceInfo.id);
-      channel = await space.openChannel('main');
+      space = await rool.openSpace(spaceInfo.id);
     }}>
       {spaceInfo.name}
     </button>
   {/each}
 
-  {#if channel}
-    <p>Interactions: {channel.interactions.length}</p>
+  {#if space}
+    {@const conversation = space.conversation('main')}
+    <button onclick={() => void conversation.prompt('Hello')}>Send</button>
   {/if}
 {/if}
 ```
@@ -57,10 +57,9 @@ The Svelte wrapper adds reactive state on top of the SDK:
 | `rool.connectionState` | Client SSE connection state |
 | `rool.userStorage` | User storage (cross-device preferences) |
 | `space.fileTree` | Canonical reactive WebDAV tree for `/`, including `/space` objects and `/rool-drive` user files |
-| `channel.interactions` | Current conversation interactions |
-| `channel.objectPaths` | Object paths derived from `space.fileTree` |
-| `channel.collections` | Collection directories derived from `space.fileTree` |
-| `channel.conversations` | Conversations in this channel (auto-updates on create/delete/rename) |
+| `space.objectPaths` | Object paths derived from `space.fileTree` |
+| `space.collections` | Collection directories derived from `space.fileTree` |
+| `space.conversations` | Conversations in this space (auto-updates on create/delete/rename) |
 | `thread.interactions` | Interactions for a specific conversation (auto-updates) |
 | `watch.objects` | Objects matching a filter (auto-updates) |
 | `watch.loading` | Whether watch is loading |
@@ -81,7 +80,7 @@ space.fileTree.childrenOf('/rool-drive');
 space.fileTree.objectPaths();      // object paths from /space/**/*.json
 ```
 
-Use this tree when UI needs to react to both files and objects. Object helpers like `channel.object()`, `channel.watch()`, `channel.objectPaths`, and `channel.collections` are backed by this tree.
+Use this tree when UI needs to react to both files and objects. Object helpers like `space.object()`, `space.watch()`, `space.objectPaths`, and `space.collections` are backed by this tree.
 
 ## API
 
@@ -147,17 +146,17 @@ Reactive cross-device storage for user preferences. Synced from server on `init(
 </button>
 ```
 
-### Spaces & Channels
+### Spaces & Conversations
 
-Every space has its own SSE subscription. Open a space, then open channels on it. Call `space.close()` when done — this closes all open channels and stops the subscription.
+Every space has its own SSE subscription. Open a space, then get explicit conversation handles from it. Call `space.close()` when done to stop the subscription.
 
 ```typescript
 // Open a space — reactive, with SSE
 const space = await rool.openSpace('space-id');
 
-// Open channels on the space
-const channel = await space.openChannel('my-channel');
-const other = await space.openChannel('research');  // Independent channel, same space
+// Get explicit conversation handles
+const main = space.conversation('main');
+const research = space.conversation('research');
 
 // Space admin
 await space.rename('New Name');
@@ -166,7 +165,7 @@ await space.setUserRole(userId, 'admin');
 
 // Create a new space
 const fresh = await rool.createSpace('My New Space');
-const ch = await fresh.openChannel('main');
+const mainConversation = fresh.conversation('main');
 
 // Import from a zip archive
 const imported = await rool.importArchive('Imported', archiveBlob);
@@ -174,40 +173,40 @@ const imported = await rool.importArchive('Imported', archiveBlob);
 // Delete a space permanently
 await rool.deleteSpace('space-id');
 
-// Clean up — closes all open channels AND stops the subscription
+// Clean up — closes this space and stops its subscription
 space.close();
 ```
 
-### ReactiveChannel
+### ReactiveSpace
 
-`space.openChannel()` returns a `ReactiveChannel` — the SDK's `RoolChannel` with reactive `interactions`, `objectPaths`, `collections`, `conversations`, and file-tree-backed object helpers:
+`rool.openSpace()` returns a `ReactiveSpace` with reactive `conversations`, file-tree-backed object helpers, and explicit reactive conversation handles:
 
 ```svelte
 <script lang="ts">
-  import { createRool, type ReactiveChannel, type ReactiveSpace } from '@rool-dev/svelte';
+  import { createRool, type ReactiveSpace, type ReactiveConversationHandle } from '@rool-dev/svelte';
 
   const rool = createRool();
   void rool.init();
 
   let space = $state<ReactiveSpace | null>(null);
-  let channel = $state<ReactiveChannel | null>(null);
+  let conversation = $state<ReactiveConversationHandle | null>(null);
 
   async function open(spaceId: string) {
     space = await rool.openSpace(spaceId);
-    channel = await space.openChannel('main');
+    conversation = space.conversation('main');
   }
 </script>
 
-{#if channel}
-  <!-- Reactive: updates when the current conversation changes -->
-  {#each channel.interactions as interaction}
+{#if conversation}
+  <!-- Reactive: updates when this conversation changes -->
+  {#each conversation.interactions as interaction}
     <div>
       <strong>{interaction.operation}</strong>: {interaction.output ?? ''}
     </div>
   {/each}
 
-  <!-- All SDK methods work directly -->
-  <button onclick={() => void channel.prompt('Hello')}>Send</button>
+  <!-- Conversation-scoped SDK methods work directly -->
+  <button onclick={() => void conversation.prompt('Hello')}>Send</button>
 {/if}
 ```
 
@@ -217,18 +216,17 @@ Track a single object by machine path with auto-updates:
 
 ```svelte
 <script lang="ts">
-  import { createRool, type ReactiveChannel, type ReactiveObject } from '@rool-dev/svelte';
+  import { createRool, type ReactiveSpace, type ReactiveObject } from '@rool-dev/svelte';
 
   const rool = createRool();
   void rool.init();
 
-  let channel = $state<ReactiveChannel | null>(null);
+  let space = $state<ReactiveSpace | null>(null);
   let item = $state<ReactiveObject | null>(null);
 
   async function open(spaceId: string, path: string) {
-    const space = await rool.openSpace(spaceId);
-    channel = await space.openChannel('main');
-    item = channel.object(path);  // e.g. '/space/article/welcome.json'
+    space = await rool.openSpace(spaceId);
+    item = space.object(path);  // e.g. '/space/article/welcome.json'
   }
 </script>
 
@@ -253,7 +251,7 @@ item.refresh() // Manual re-fetch
 item.close()   // Stop listening for updates
 ```
 
-**Lifecycle:** Reactive objects are tied to their channel. Closing the channel stops all updates — existing reactive objects will retain their last data but no longer refresh. Calling `channel.object()` after `close()` throws.
+**Lifecycle:** Reactive objects are tied to their space. Closing the space stops all updates — existing reactive objects will retain their last data but no longer refresh. Calling `space.object()` after `close()` throws.
 
 ### Reactive Watches
 
@@ -261,19 +259,18 @@ Create auto-updating watches of objects filtered by field values:
 
 ```svelte
 <script lang="ts">
-  import { createRool, type ReactiveChannel, type ReactiveSpace, type ReactiveWatch } from '@rool-dev/svelte';
+  import { createRool, type ReactiveSpace, type ReactiveWatch } from '@rool-dev/svelte';
 
   const rool = createRool();
   void rool.init();
 
   let space = $state<ReactiveSpace | null>(null);
-  let channel = $state<ReactiveChannel | null>(null);
   let articles = $state<ReactiveWatch | null>(null);
+
   async function open(spaceId: string) {
     space = await rool.openSpace(spaceId);
-    channel = await space.openChannel('main');
     // Create a reactive watch of all objects in the 'article' collection
-    articles = channel.watch({ collection: 'article' });
+    articles = space.watch({ collection: 'article' });
   }
 </script>
 
@@ -290,11 +287,11 @@ Create auto-updating watches of objects filtered by field values:
 
 Watches automatically re-fetch when matching object files change in `space.fileTree`.
 
-**Lifecycle:** Watches are tied to their channel. Closing the channel stops all updates — existing watches will retain their last data but no longer refresh. Calling `channel.watch()` after `close()` throws.
+**Lifecycle:** Watches are tied to their space. Closing the space stops all updates — existing watches will retain their last data but no longer refresh. Calling `space.watch()` after `close()` throws.
 
 ```typescript
 // Watch options
-const articles = channel.watch({
+const articles = space.watch({
   collection: 'article',
   where: { status: 'published' },
   order: 'desc',  // by modifiedAt (default)
@@ -310,9 +307,9 @@ articles.refresh() // Manual re-fetch
 articles.close()   // Stop listening for updates
 ```
 
-### Reactive Channel List
+### Reactive Space List
 
-`space.channels` is a reactive `ChannelInfo[]` on an opened `ReactiveSpace`. If you only need a live channel list without managing a `ReactiveSpace`, use `rool.channels(spaceId)` and call `close()` when done.
+`rool.spaces` is a reactive `RoolSpaceInfo[]`. Open individual spaces with `rool.openSpace(spaceId)` and close them when done.
 
 ```svelte
 <script lang="ts">
@@ -321,45 +318,33 @@ articles.close()   // Stop listening for updates
   const rool = createRool();
   void rool.init();
 
-  let space = $state<ReactiveSpace | null>(null);
-  async function open(spaceId: string) {
-    space = await rool.openSpace(spaceId);
-  }
+  let current = $state<ReactiveSpace | null>(null);
 </script>
 
-{#if space}
-  {#each space.channels as ch}
-    <button onclick={() => void space.openChannel(ch.id)}>{ch.name ?? ch.id}</button>
-  {/each}
-{/if}
-```
-
-```typescript
-const channels = rool.channels(spaceId);
-channels.list;       // ChannelInfo[]
-channels.loading;    // boolean
-await channels.refresh();
-channels.close();
+{#each rool.spaces ?? [] as space}
+  <button onclick={async () => current = await rool.openSpace(space.id)}>
+    {space.name}
+  </button>
+{/each}
 ```
 
 ### Reactive Conversation Handle
 
-For apps with multiple independent interaction threads (e.g., chat with threads), use `channel.conversation()` to get a handle with reactive interactions:
+For apps with multiple independent interaction threads (e.g., chat with threads), use `space.conversation()` to get a handle with reactive interactions:
 
 ```svelte
 <script lang="ts">
-  import { createRool, type ReactiveChannel, type ReactiveConversationHandle, type ReactiveSpace } from '@rool-dev/svelte';
+  import { createRool, type ReactiveConversationHandle, type ReactiveSpace } from '@rool-dev/svelte';
 
   const rool = createRool();
   void rool.init();
 
   let space = $state<ReactiveSpace | null>(null);
-  let channel = $state<ReactiveChannel | null>(null);
   let thread = $state<ReactiveConversationHandle | null>(null);
+
   async function openThread(spaceId: string, threadId: string) {
     space = await rool.openSpace(spaceId);
-    channel = await space.openChannel('main');
-    thread = channel.conversation(threadId);
+    thread = space.conversation(threadId);
   }
 </script>
 
@@ -374,7 +359,7 @@ For apps with multiple independent interaction threads (e.g., chat with threads)
 
 ```typescript
 // Reactive state
-thread.interactions   // $state<Interaction[]> — updates from space/channel events
+thread.interactions   // $state<Interaction[]> — updates from space events
 
 // Conversation-scoped methods
 await thread.prompt('Hello')
@@ -390,74 +375,60 @@ thread.getSystemInstruction()
 thread.close()   // Stop listening for updates
 ```
 
-Conversations are auto-created when you first write history or settings. Real-time events are owned by the space subscription; conversation handles subscribe to channel events locally.
+Conversations are auto-created when you first write history or settings. Real-time events are owned by the space subscription; conversation handles subscribe to space events locally.
 
-### Channel Management
+### Space Management
 
 ```typescript
-// Rename a channel on the space handle
-await space.renameChannel('channel-id', 'New Name');
-
-// Delete a channel
-await space.deleteChannel('channel-id');
+// Rename or delete the open space
+await space.rename('New Name');
+await space.delete();
 
-// Rename from within an open channel
-await channel.rename('New Name');
+// Or manage spaces from the client
+const created = await rool.createSpace('New Space');
+await rool.deleteSpace(created.id);
 ```
 
 ### Using the SDK
 
-All `RoolChannel` methods and properties are available on `ReactiveChannel`:
+Common `ReactiveSpace` and `ReactiveConversationHandle` methods:
 
 ```typescript
-// Properties
-channel.id
-channel.name
-channel.role
-channel.channelId
+// Space properties
+space.id
+space.name
+space.role
 
-// Object operations — addressed by exact machine paths
+// Read object data by exact machine path
 const path = '/space/note/welcome.json';
-await channel.getObject(path)
-await channel.putObject(path, { text: 'Hello' })
-await channel.patchObject(path, { data: { text: 'Updated' } })
-await channel.moveObject(path, '/space/note/renamed.json')
-await channel.deleteObjects(['/space/note/renamed.json'])
-
-// AI
-await channel.prompt('Summarize everything')
-await channel.stop()                       // Stop the in-flight interaction (false if none)
-await channel.stopInteraction(channel.activeLeafId!)  // Stop a specific interaction by ID
-
-// Schema
-channel.getSchema()
-await channel.createCollection('article', [
+await space.getObject(path)
+
+// Conversation-scoped writes and AI
+const conversation = space.conversation('thread-42');
+await conversation.putObject(path, { text: 'Hello' })
+await conversation.patchObject(path, { data: { text: 'Updated' } })
+await conversation.moveObject(path, '/space/note/renamed.json')
+await conversation.deleteObjects(['/space/note/renamed.json'])
+await conversation.prompt('Summarize everything')
+await conversation.stop()
+
+// Schema/metadata writes are also attributed to a conversation
+space.getSchema()
+await conversation.createCollection('article', [
   { name: 'title', type: { kind: 'string' } },
   { name: 'status', type: { kind: 'enum', values: ['draft', 'published'] } },
 ])
-await channel.alterCollection('article', updatedFields)
-await channel.dropCollection('article')
-
-// Undo/Redo
-await channel.checkpoint('Before edit')
-await channel.undo()
-await channel.redo()
-
-// Interaction history & conversations
-await channel.setSystemInstruction('You are helpful')
-channel.getInteractions()
-channel.getConversations()
-await channel.deleteConversation('old-thread')
-await channel.renameConversation('Research')
-
-// Conversation handles (reactive interactions for specific conversations)
-const thread = channel.conversation('thread-42');
-await thread.prompt('Hello');        // Uses thread-42's interaction history
-// thread.interactions is reactive $state — updates from space/channel events
-thread.close();                      // Stop listening when done
-
-// Channel admin
-await channel.rename('New Name')
+await conversation.alterCollection('article', updatedFields)
+await conversation.dropCollection('article')
+await conversation.setSystemInstruction('You are helpful')
+conversation.getInteractions()
+
+// Space history/admin
+await space.checkpoint('Before edit')
+await space.undo()
+await space.redo()
+await space.deleteConversation('old-thread')
+await space.rename('New Name')
 ```
 
 See the [SDK documentation](../sdk/README.md) for complete API details.
@@ -474,20 +445,19 @@ machineUri('/space/article/welcome.json');
 // 'rool-machine:/space/article/welcome.json'
 
 isObjectPath('/space/article/welcome.json'); // true
-generateId(); // 6-character alphanumeric ID
+generateId(); // unique ID suitable for conversation IDs
 ```
 
 ## Exported Types
 
 ```typescript
 // Package types
-import type { Rool, ReactiveSpace, ReactiveChannel, ReactiveConversationHandle, ReactiveObject, ReactiveWatch, WatchOptions, ReactiveChannelList, ReactiveFileTree, ReactiveFileNode, ReactiveFileRoot, ReactiveFileTreeEvent, ReactiveFileTreeSyncResult } from '@rool-dev/svelte';
+import type { Rool, ReactiveSpace, ReactiveConversationHandle, ReactiveObject, ReactiveWatch, WatchOptions, ReactiveFileTree, ReactiveFileNode, ReactiveFileRoot, ReactiveFileTreeEvent, ReactiveFileTreeSyncResult } from '@rool-dev/svelte';
 
 // Re-exported from @rool-dev/sdk
 import type {
   RoolClient,
   RoolClientConfig,
-  RoolChannel,
   RoolSpace,
   RoolSpaceInfo,
   RoolObject,
@@ -495,7 +465,6 @@ import type {
   RoolObjectStat,
   RoolUserRole,
   ConnectionState,
-  ChannelInfo,
   Conversation,
   ConversationInfo,
   CurrentUser,

package/dist/index.d.ts

@@ -2,12 +2,11 @@ export { createRool, generateId } from './rool.svelte.js';
 export { isObjectPath, machinePath, machineUri } from '@rool-dev/sdk';
 export { InviteError } from '@rool-dev/sdk';
 export type { InviteErrorCode } from '@rool-dev/sdk';
-export { wrapChannel } from './channel.svelte.js';
 export { wrapSpace } from './space.svelte.js';
 export { ReactiveFileTree } from './file-tree.svelte.js';
 export type { Rool } from './rool.svelte.js';
-export type { ReactiveChannel, ReactiveConversationHandle, ReactiveObject, ReactiveWatch, ReactiveChannelList, WatchOptions } from './channel.svelte.js';
+export type { ReactiveConversationHandle, ReactiveObject, ReactiveWatch, WatchOptions } from './space-session.svelte.js';
 export type { ReactiveSpace } from './space.svelte.js';
 export type { ReactiveFileNode, ReactiveFilePath, ReactiveFileRoot, ReactiveFileTreeEvent, ReactiveFileTreeSyncResult } from './file-tree.svelte.js';
-export type { RoolClientConfig, RoolChannel, RoolSpace, RoolSpaceInfo, RoolObject, GetObjectsResult, RoolObjectStat, RoolUserRole, ConnectionState, ChannelInfo, Conversation, ConversationInfo, CurrentUser, Interaction, PromptOptions, PromptAttachment, UpdateObjectOptions, MoveObjectOptions, CollectionOptions, FieldType, FieldDef, CollectionDef, SpaceSchema, SpaceMember, InviteRole, SpaceInvite, SpaceInviteCreated, InviteEmailStatus, InvitePreview, InviteRedeemResult, RoolClient, RoolSpaceEvents, SpaceFileStorageUsage, WebDAVDepth, WebDAVSyncLevel, WebDAVPropName, WebDAVResponse, WebDAVProps, } from '@rool-dev/sdk';
+export type { RoolClientConfig, RoolSpace, RoolSpaceInfo, RoolObject, GetObjectsResult, RoolObjectStat, RoolUserRole, ConnectionState, ConversationInfo, Conversation, CurrentUser, Interaction, PromptOptions, PromptAttachment, UpdateObjectOptions, MoveObjectOptions, CollectionOptions, FieldType, FieldDef, CollectionDef, SpaceSchema, SpaceMember, InviteRole, SpaceInvite, SpaceInviteCreated, InviteEmailStatus, InvitePreview, InviteRedeemResult, RoolClient, RoolSpaceEvents, SpaceFileStorageUsage, WebDAVDepth, WebDAVSyncLevel, WebDAVPropName, WebDAVResponse, WebDAVProps, } from '@rool-dev/sdk';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,0BAA0B,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzJ,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAGrJ,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,0BAA0B,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzH,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAGrJ,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -5,6 +5,5 @@ export { isObjectPath, machinePath, machineUri } from '@rool-dev/sdk';
 // Invite error — re-exported so apps can match on it without a direct SDK dep
 export { InviteError } from '@rool-dev/sdk';
 // Reactive wrappers
-export { wrapChannel } from './channel.svelte.js';
 export { wrapSpace } from './space.svelte.js';
 export { ReactiveFileTree } from './file-tree.svelte.js';

package/dist/rool.svelte.d.ts

@@ -1,5 +1,4 @@
 import { RoolClient, type RoolSpaceInfo, type ConnectionState, type RoolClientConfig, type CurrentUser } from '@rool-dev/sdk';
-import { type ReactiveChannelList } from './channel.svelte.js';
 import { type ReactiveSpace } from './space.svelte.js';
 /**
  * Rool client with reactive state for Svelte 5.
@@ -8,7 +7,7 @@ import { type ReactiveSpace } from './space.svelte.js';
  * - Reactive auth state (`authenticated`)
  * - Reactive spaces list (`spaces`)
  * - Reactive user storage (`userStorage`)
- * - Channel-based access to spaces
+ * - Space-level access to conversations, objects, and AI
  */
 declare class RoolImpl {
     #private;
@@ -50,7 +49,6 @@ declare class RoolImpl {
     logout(): void;
     /**
      * Open a space with a live SSE subscription. Returns a ReactiveSpace.
-     * Call `space.openChannel(channelId)` to get a ReactiveChannel.
      * Call `space.close()` when done to stop the subscription.
      */
     openSpace(spaceId: string): Promise<ReactiveSpace>;
@@ -126,13 +124,6 @@ declare class RoolImpl {
         slug?: string;
         marketingOptIn?: boolean;
     }): Promise<CurrentUser>;
-    /**
-     * Create a reactive channel list for a space.
-     * Auto-updates when channels are created, updated, or deleted.
-     * Returns immediately with loading=true; populates once the space is ready.
-     * Call close() when done to stop listening.
-     */
-    channels(spaceId: string): ReactiveChannelList;
     /**
      * Clean up resources.
      */

package/dist/rool.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rool.svelte.d.ts","sourceRoot":"","sources":["../src/rool.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rool.svelte.d.ts","sourceRoot":"","sources":["../src/rool.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9H,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;GAQG;AACH,cAAM,QAAQ;;IAMZ,aAAa,iBAAgC;IAC7C,MAAM,8BAAkD;IACxD,aAAa,UAAiB;IAC9B,WAAW,eAA8B;IACzC,eAAe,kBAA2C;IAC1D,WAAW,0BAAuC;IAClD,WAAW,qBAAoC;gBAEnC,MAAM,CAAC,EAAE,gBAAgB;IAKrC;;;OAGG;IACH,IAAI,MAAM,IAAI,UAAU,CAEvB;IAqED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB9B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI7D;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI9D;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM7C;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAOxD;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAOvD;;OAEG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAOjF;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIvD;;OAEG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5C;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAKjD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM;IAI3B;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM;IAMhC;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAOxE;;OAEG;IACH,IAAI,QAAQ,qCAEX;IAED;;OAEG;IACG,cAAc;IAMpB;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE;IAQzF;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC"}

package/dist/rool.svelte.js

@@ -1,5 +1,4 @@
 import { RoolClient } from '@rool-dev/sdk';
-import { createChannelList } from './channel.svelte.js';
 import { wrapSpace } from './space.svelte.js';
 /**
  * Rool client with reactive state for Svelte 5.
@@ -8,7 +7,7 @@ import { wrapSpace } from './space.svelte.js';
  * - Reactive auth state (`authenticated`)
  * - Reactive spaces list (`spaces`)
  * - Reactive user storage (`userStorage`)
- * - Channel-based access to spaces
+ * - Space-level access to conversations, objects, and AI
  */
 class RoolImpl {
     #client;
@@ -151,7 +150,6 @@ class RoolImpl {
     }
     /**
      * Open a space with a live SSE subscription. Returns a ReactiveSpace.
-     * Call `space.openChannel(channelId)` to get a ReactiveChannel.
      * Call `space.close()` when done to stop the subscription.
      */
     async openSpace(spaceId) {
@@ -276,15 +274,6 @@ class RoolImpl {
         this.currentUser = user;
         return user;
     }
-    /**
-     * Create a reactive channel list for a space.
-     * Auto-updates when channels are created, updated, or deleted.
-     * Returns immediately with loading=true; populates once the space is ready.
-     * Call close() when done to stop listening.
-     */
-    channels(spaceId) {
-        return createChannelList(this.#client.openSpace(spaceId));
-    }
     /**
      * Clean up resources.
      */

package/dist/space-session.svelte.d.ts

@@ -0,0 +1,82 @@
+import type { RoolSpace, Interaction, RoolObject, ConversationHandle } from '@rool-dev/sdk';
+import { ReactiveFileTree } from './file-tree.svelte.js';
+/**
+ * Options for creating a reactive watch.
+ * Structured object filter for reactive updates.
+ */
+export interface WatchOptions {
+    /** Field requirements for exact matching */
+    where?: Record<string, unknown>;
+    /** Filter by collection name. */
+    collection?: string;
+    /** Maximum number of objects */
+    limit?: number;
+    /** Sort order by modifiedAt: 'asc' or 'desc' (default: 'desc') */
+    order?: 'asc' | 'desc';
+}
+/**
+ * A reactive watch of objects that auto-updates when matching object files change.
+ */
+export declare class ReactiveWatchImpl {
+    #private;
+    objects: RoolObject[];
+    loading: boolean;
+    constructor(space: RoolSpace, fileTree: ReactiveFileTree, options: WatchOptions);
+    /** Re-fetch matching objects using the canonical file tree for paths. */
+    refresh(): Promise<void>;
+    close(): void;
+}
+export type ReactiveWatch = ReactiveWatchImpl;
+/**
+ * A reactive single object that auto-updates when the object changes.
+ */
+export declare class ReactiveObjectImpl {
+    #private;
+    data: RoolObject | undefined;
+    loading: boolean;
+    constructor(space: RoolSpace, fileTree: ReactiveFileTree, path: string);
+    refresh(): Promise<void>;
+    close(): void;
+}
+export type ReactiveObject = ReactiveObjectImpl;
+export declare class ReactiveConversationHandleImpl {
+    #private;
+    interactions: Interaction[];
+    constructor(space: RoolSpace, conversationId: string);
+    get conversationId(): string;
+    getInteractions(): Interaction[];
+    getTree(): Record<string, Interaction>;
+    get activeLeafId(): string | undefined;
+    setActiveLeaf(interactionId: string): void;
+    getSystemInstruction(): string | undefined;
+    setSystemInstruction(...args: Parameters<ConversationHandle['setSystemInstruction']>): Promise<void>;
+    rename(...args: Parameters<ConversationHandle['rename']>): Promise<void>;
+    delete(): Promise<void>;
+    putObject(...args: Parameters<ConversationHandle['putObject']>): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    patchObject(...args: Parameters<ConversationHandle['patchObject']>): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    moveObject(...args: Parameters<ConversationHandle['moveObject']>): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    deleteObjects(...args: Parameters<ConversationHandle['deleteObjects']>): Promise<void>;
+    /** @deprecated Use deleteObjects instead. */
+    deletePaths(...args: Parameters<ConversationHandle['deletePaths']>): Promise<void>;
+    prompt(...args: Parameters<ConversationHandle['prompt']>): Promise<{
+        message: string;
+        objects: RoolObject[];
+    }>;
+    stop(): Promise<boolean>;
+    createCollection(...args: Parameters<ConversationHandle['createCollection']>): Promise<import("@rool-dev/sdk").CollectionDef>;
+    alterCollection(...args: Parameters<ConversationHandle['alterCollection']>): Promise<import("@rool-dev/sdk").CollectionDef>;
+    dropCollection(...args: Parameters<ConversationHandle['dropCollection']>): Promise<void>;
+    setMetadata(...args: Parameters<ConversationHandle['setMetadata']>): void;
+    close(): void;
+}
+export type ReactiveConversationHandle = ReactiveConversationHandleImpl;
+//# sourceMappingURL=space-session.svelte.d.ts.map

package/dist/space-session.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-session.svelte.d.ts","sourceRoot":"","sources":["../src/space-session.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,kBAAkB,EAEnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAqD,MAAM,uBAAuB,CAAC;AAE5G;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AA8CD;;GAEG;AACH,qBAAa,iBAAiB;;IAO5B,OAAO,eAA4B;IACnC,OAAO,UAAgB;gBAEX,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY;IAgB/E,yEAAyE;IACnE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,KAAK,IAAI,IAAI;CAId;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C;;GAEG;AACH,qBAAa,kBAAkB;;IAO7B,IAAI,yBAA6C;IACjD,OAAO,UAAgB;gBAEX,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM;IAoBhE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,KAAK,IAAI,IAAI;CAId;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAMhD,qBAAa,8BAA8B;;IAMzC,YAAY,gBAA6B;gBAE7B,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM;IAqBpD,IAAI,cAAc,IAAI,MAAM,CAAiC;IAG7D,eAAe;IACf,OAAO;IACP,IAAI,YAAY,uBAAwC;IACxD,aAAa,CAAC,aAAa,EAAE,MAAM;IACnC,oBAAoB;IACpB,oBAAoB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IACpF,MAAM,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM;IAGN,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;;;;IAC9D,WAAW,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;;;;IAClE,UAAU,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;;;;IAChE,aAAa,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACtE,6CAA6C;IAC7C,WAAW,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAGlE,MAAM,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;;;;IACxD,IAAI;IAGJ,gBAAgB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;IAC5E,eAAe,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IAC1E,cAAc,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IAGxE,WAAW,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAElE,KAAK,IAAI,IAAI;CAId;AAED,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,CAAC"}