@rool-dev/svelte 0.10.2 → 0.11.0-dev.59f195f

package/README.md

@@ -2,9 +2,7 @@
 
 Svelte 5 bindings for Rool Spaces. Adds reactive state to the SDK using `$state` runes.
 
-> **Building a new Rool extension?** Start with [`@rool-dev/extension`](/extension/) — it includes a reactive channel and handles hosting for you. This package is for integrating Rool into an existing Svelte application that manages its own auth, routing, and build setup.
-
-**Requires Svelte 5.** For core concepts (objects, references, AI placeholders, undo/redo), see the [SDK documentation](../sdk/README.md).
+**Requires Svelte 5.** For core concepts (objects, references, AI, WebDAV files, undo/redo), see the [SDK documentation](../sdk/README.md).
 
 ## Installation
 
@@ -15,16 +13,18 @@ npm install @rool-dev/svelte
 ## Quick Start
 
 ```svelte
-<script>
-  import { createRool } from '@rool-dev/svelte';
+<script lang="ts">
+  import { createRool, type ReactiveChannel } from '@rool-dev/svelte';
 
   const rool = createRool();
-  rool.init();
+  void rool.init();
 
-  let channel = $state(null);
+  let channel = $state<ReactiveChannel | null>(null);
 </script>
 
-{#if !rool.authenticated}
+{#if rool.authenticated === null}
+  <p>Checking session...</p>
+{:else if !rool.authenticated}
   <button onclick={() => rool.login('My App')}>Login</button>
 {:else}
   <h1>My Spaces</h1>
@@ -50,14 +50,16 @@ The Svelte wrapper adds reactive state on top of the SDK:
 | Reactive Property | Description |
 |-------------------|-------------|
 | `rool.authenticated` | Auth state (`null` = checking, `true`/`false` = known) |
+| `rool.currentUser` | Current user profile after authentication |
 | `rool.spaces` | List of available spaces |
 | `rool.spacesLoading` | Whether spaces are loading |
 | `rool.spacesError` | Error from loading spaces |
-| `rool.connectionState` | SSE connection state |
+| `rool.connectionState` | Client SSE connection state |
 | `rool.userStorage` | User storage (cross-device preferences) |
-| `channel.interactions` | Channel interactions (auto-updates) |
-| `channel.objectLocations` | All object locations in the space (auto-updates on create/delete/move) |
-| `channel.collections` | Collection names from the schema (auto-updates) |
+| `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) |
 | `thread.interactions` | Interactions for a specific conversation (auto-updates) |
 | `watch.objects` | Objects matching a filter (auto-updates) |
@@ -65,6 +67,22 @@ The Svelte wrapper adds reactive state on top of the SDK:
 
 Everything else passes through to the SDK directly. See the [SDK documentation](../sdk/README.md) for full API details.
 
+### Reactive File Tree
+
+Every `ReactiveSpace` owns a canonical reactive WebDAV tree. It is kept current with server `filesChanged`/`filesReset` events and WebDAV `sync-collection`, so it covers both object files and user files without polling.
+
+```ts
+const space = await rool.openSpace(spaceId);
+
+space.fileTree.nodes;              // ReactiveFileNode[]
+space.fileTree.byPath['/space'];   // lookup by machine/WebDAV path
+space.fileTree.childrenOf('/');    // /space and /rool-drive
+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.
+
 ## API
 
 ### Lifecycle
@@ -72,7 +90,7 @@ Everything else passes through to the SDK directly. See the [SDK documentation](
 ```typescript
 const rool = createRool();
 
-rool.init();              // Process auth callbacks (call on app startup)
+void rool.init();         // Process auth callbacks (call on app startup)
 rool.login('My App');     // Redirect to login page
 rool.signup('My App');    // Redirect to signup page
 rool.verify(token);       // Sign in from an email verification link (used by the official Rool app)
@@ -91,6 +109,7 @@ rool.destroy();           // Clean up all resources
   // rool.spacesError      → Error | null
   // rool.connectionState  → 'connected' | 'disconnected' | 'reconnecting'
   // rool.userStorage      → Record<string, unknown>
+  // rool.currentUser      → CurrentUser | null
 </script>
 
 {#if rool.spacesLoading}
@@ -109,9 +128,10 @@ rool.destroy();           // Clean up all resources
 Reactive cross-device storage for user preferences. Synced from server on `init()`, then kept up-to-date via SSE.
 
 ```svelte
-<script>
+<script lang="ts">
+  import { createRool } from '@rool-dev/svelte';
   const rool = createRool();
-  rool.init();
+  void rool.init();
 </script>
 
 <!-- Reactive binding to storage values -->
@@ -122,9 +142,7 @@ Reactive cross-device storage for user preferences. Synced from server on `init(
 {/if}
 
 <!-- Theme toggle -->
-<button onclick={() => rool.setUserStorage('theme',
-  rool.userStorage.theme === 'dark' ? 'light' : 'dark'
-)}>
+<button onclick={() => rool.setUserStorage('theme', rool.userStorage.theme === 'dark' ? 'light' : 'dark')}>
   Toggle theme
 </button>
 ```
@@ -161,47 +179,55 @@ space.close();
 
 ### ReactiveChannel
 
-`space.openChannel()` returns a `ReactiveChannel` — the SDK's `RoolChannel` with reactive `interactions` and `objectLocations`:
+`space.openChannel()` returns a `ReactiveChannel` — the SDK's `RoolChannel` with reactive `interactions`, `objectPaths`, `collections`, `conversations`, and file-tree-backed object helpers:
 
 ```svelte
-<script>
-  let space = $state(null);
-  let channel = $state(null);
+<script lang="ts">
+  import { createRool, type ReactiveChannel, type ReactiveSpace } from '@rool-dev/svelte';
+
+  const rool = createRool();
+  void rool.init();
+
+  let space = $state<ReactiveSpace | null>(null);
+  let channel = $state<ReactiveChannel | null>(null);
 
-  async function open(spaceId) {
+  async function open(spaceId: string) {
     space = await rool.openSpace(spaceId);
     channel = await space.openChannel('main');
   }
 </script>
 
 {#if channel}
-  <!-- Reactive: updates as AI makes tool calls -->
+  <!-- Reactive: updates when the current conversation changes -->
   {#each channel.interactions as interaction}
     <div>
-      <strong>{interaction.operation}</strong>: {interaction.output}
+      <strong>{interaction.operation}</strong>: {interaction.output ?? ''}
     </div>
   {/each}
 
   <!-- All SDK methods work directly -->
-  <button onclick={() => channel.prompt('Hello')}>Send</button>
+  <button onclick={() => void channel.prompt('Hello')}>Send</button>
 {/if}
 ```
 
 ### Reactive Object
 
-Track a single object by location with auto-updates:
+Track a single object by machine path with auto-updates:
 
 ```svelte
-<script>
-  let channel = $state(null);
-  let item = $state(null);
+<script lang="ts">
+  import { createRool, type ReactiveChannel, type ReactiveObject } from '@rool-dev/svelte';
 
-  let space = $state(null);
+  const rool = createRool();
+  void rool.init();
 
-  async function open(spaceId, location) {
-    space = await rool.openSpace(spaceId);
+  let channel = $state<ReactiveChannel | 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(location);  // e.g. '/space/article/welcome.json'
+    item = channel.object(path);  // e.g. '/space/article/welcome.json'
   }
 </script>
 
@@ -209,7 +235,7 @@ Track a single object by location with auto-updates:
   {#if item.loading}
     <p>Loading...</p>
   {:else if item.data}
-    <div>{item.data.body.title}</div>
+    <div>{String(item.data.body.title ?? '')}</div>
   {:else}
     <p>Object not found</p>
   {/if}
@@ -233,13 +259,16 @@ item.close()   // Stop listening for updates
 Create auto-updating watches of objects filtered by field values:
 
 ```svelte
-<script>
-  let channel = $state(null);
-  let articles = $state(null);
+<script lang="ts">
+  import { createRool, type ReactiveChannel, type ReactiveSpace, type ReactiveWatch } from '@rool-dev/svelte';
 
-  let space = $state(null);
+  const rool = createRool();
+  void rool.init();
 
-  async function open(spaceId) {
+  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
@@ -252,18 +281,18 @@ Create auto-updating watches of objects filtered by field values:
     <p>Loading...</p>
   {:else}
     {#each articles.objects as article}
-      <div>{article.body.title}</div>
+      <div>{String(article.body.title ?? '')}</div>
     {/each}
   {/if}
 {/if}
 ```
 
-Watches automatically re-fetch when objects matching the filter are created, updated, or deleted. Since the SDK caches objects locally, re-fetches are typically instant (no network round-trip).
+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.
 
 ```typescript
-// Watch options (same as findObjects, but no AI prompt)
+// Watch options
 const articles = channel.watch({
   collection: 'article',
   where: { status: 'published' },
@@ -282,36 +311,51 @@ articles.close()   // Stop listening for updates
 
 ### Reactive Channel List
 
-`space.channels` is a reactive `ChannelInfo[]` that auto-updates as channels are created, renamed, or deleted.
+`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.
 
 ```svelte
-<script>
-  let space = $state(null);
+<script lang="ts">
+  import { createRool, type ReactiveSpace } from '@rool-dev/svelte';
+
+  const rool = createRool();
+  void rool.init();
 
-  async function open(spaceId) {
+  let space = $state<ReactiveSpace | null>(null);
+  async function open(spaceId: string) {
     space = await rool.openSpace(spaceId);
   }
 </script>
 
 {#if space}
   {#each space.channels as ch}
-    <button onclick={() => space.openChannel(ch.id)}>{ch.name ?? ch.id}</button>
+    <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();
+```
+
 ### 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:
 
 ```svelte
-<script>
-  let channel = $state(null);
-  let thread = $state(null);
+<script lang="ts">
+  import { createRool, type ReactiveChannel, type ReactiveConversationHandle, type ReactiveSpace } from '@rool-dev/svelte';
 
-  let space = $state(null);
+  const rool = createRool();
+  void rool.init();
 
-  async function openThread(spaceId, threadId) {
+  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);
@@ -323,17 +367,19 @@ For apps with multiple independent interaction threads (e.g., chat with threads)
     <div>{interaction.output}</div>
   {/each}
 
-  <button onclick={() => thread.prompt('Hello')}>Send</button>
+  <button onclick={() => void thread.prompt('Hello')}>Send</button>
 {/if}
 ```
 
 ```typescript
 // Reactive state
-thread.interactions   // $state<Interaction[]> — auto-updates via SSE
+thread.interactions   // $state<Interaction[]> — updates from space/channel events
 
-// All conversation-scoped methods
+// Conversation-scoped methods
 await thread.prompt('Hello')
-await thread.createObject('note', { text: 'Note' })
+await thread.stop()   // Stop this thread's in-flight interaction (false if none)
+await thread.putObject('/space/note/welcome.json', { text: 'Note' })
+await thread.patchObject('/space/note/welcome.json', { data: { text: 'Updated' } })
 await thread.setSystemInstruction('Respond in haiku')
 await thread.rename('Research Thread')
 thread.getInteractions()      // Manual read
@@ -343,7 +389,7 @@ thread.getSystemInstruction()
 thread.close()   // Stop listening for updates
 ```
 
-Conversations are auto-created on first interaction. All conversations share one SSE connection per channel.
+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.
 
 ### Channel Management
 
@@ -369,17 +415,18 @@ channel.name
 channel.role
 channel.channelId
 
-// Object operations — addressed by location (`/space/<collection>/<basename>.json`)
-await channel.getObject(location)
-await channel.createObject('note', { text: 'Hello' })
-await channel.createObject('note', { text: 'Hello' }, { basename: 'welcome' })
-await channel.updateObject(location, { data: { text: 'Updated' } })
-await channel.moveObject(from, to)
-await channel.deleteObjects([location])
-await channel.findObjects({ collection: 'note' })
+// Object operations — addressed by exact machine paths
+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()
@@ -387,7 +434,7 @@ await channel.createCollection('article', [
   { name: 'title', type: { kind: 'string' } },
   { name: 'status', type: { kind: 'enum', values: ['draft', 'published'] } },
 ])
-await channel.alterCollection('article', [...updatedProps])
+await channel.alterCollection('article', updatedFields)
 await channel.dropCollection('article')
 
 // Undo/Redo
@@ -405,7 +452,7 @@ 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 — auto-updates via SSE
+// thread.interactions is reactive $state — updates from space/channel events
 thread.close();                      // Stop listening when done
 
 // Channel admin
@@ -417,22 +464,23 @@ See the [SDK documentation](../sdk/README.md) for complete API details.
 ### Utilities
 
 ```typescript
-import { generateBasename, loc, parseLocation, normalizeLocation } from '@rool-dev/svelte';
+import { machinePath, machineUri, isObjectPath, generateId } from '@rool-dev/svelte';
 
-// 6-character alphanumeric basename
-const basename = generateBasename();
+machinePath('rool-machine:/rool-drive/docs/read%20me.md');
+// '/rool-drive/docs/read me.md'
 
-// Build / parse location strings
-const location = loc('article', basename);        // '/space/article/<basename>.json'
-const parts = parseLocation(location);            // { collection, basename }
-const canonical = normalizeLocation('article/welcome'); // '/space/article/welcome.json'
+machineUri('/space/article/welcome.json');
+// 'rool-machine:/space/article/welcome.json'
+
+isObjectPath('/space/article/welcome.json'); // true
+generateId(); // 6-character alphanumeric ID
 ```
 
 ## Exported Types
 
 ```typescript
 // Package types
-import type { Rool, ReactiveChannel, ReactiveConversationHandle, ReactiveObject, ReactiveWatch, WatchOptions, ReactiveChannelList } from '@rool-dev/svelte';
+import type { Rool, ReactiveSpace, ReactiveChannel, ReactiveConversationHandle, ReactiveObject, ReactiveWatch, WatchOptions, ReactiveChannelList, ReactiveFileTree, ReactiveFileNode, ReactiveFileRoot, ReactiveFileTreeEvent, ReactiveFileTreeSyncResult } from '@rool-dev/svelte';
 
 // Re-exported from @rool-dev/sdk
 import type {
@@ -442,6 +490,7 @@ import type {
   RoolSpace,
   RoolSpaceInfo,
   RoolObject,
+  GetObjectsResult,
   RoolObjectStat,
   RoolUserRole,
   ConnectionState,
@@ -450,30 +499,27 @@ import type {
   ConversationInfo,
   CurrentUser,
   Interaction,
-  FindObjectsOptions,
   PromptOptions,
-  CreateObjectOptions,
+  PromptAttachment,
   UpdateObjectOptions,
   MoveObjectOptions,
+  CollectionOptions,
   FieldType,
   FieldDef,
   CollectionDef,
   SpaceSchema,
   SpaceMember,
   UserResult,
-  PublishedExtensionInfo,
-  PublishExtensionOptions,
-  ExtensionManifest,
-  FindExtensionsOptions,
-
+  SpaceFileStorageUsage,
+  RoolSpaceEvents,
+  WebDAVDepth,
+  WebDAVSyncLevel,
+  WebDAVPropName,
+  WebDAVResponse,
+  WebDAVProps,
 } from '@rool-dev/svelte';
 ```
 
-## Examples
-
-- [soft-sql](../../examples/soft-sql) — SQL-style natural language queries with live tool call progress
-- [flashcards](../../examples/flashcards) — Spaced repetition with AI-generated cards
-
 ## License
 
 MIT - see [LICENSE](../../LICENSE) for details.

package/dist/channel.svelte.d.ts

@@ -1,7 +1,8 @@
 import type { RoolChannel, RoolSpace, Interaction, RoolObject, ChannelInfo, ConversationInfo, ConversationHandle } from '@rool-dev/sdk';
+import { ReactiveFileTree } from './file-tree.svelte.js';
 /**
  * Options for creating a reactive watch.
- * Same as FindObjectsOptions but without `prompt` (AI queries are too slow for reactive updates).
+ * Structured object filter for reactive updates.
  */
 export interface WatchOptions {
     /** Field requirements for exact matching */
@@ -14,16 +15,14 @@ export interface WatchOptions {
     order?: 'asc' | 'desc';
 }
 /**
- * A reactive watch of objects that auto-updates when matching objects change.
+ * A reactive watch of objects that auto-updates when matching object files change.
  */
 declare class ReactiveWatchImpl {
     #private;
     objects: RoolObject[];
     loading: boolean;
-    constructor(channel: RoolChannel, options: WatchOptions);
-    /**
-     * Re-fetch the watched objects from the channel.
-     */
+    constructor(channel: RoolChannel, fileTree: ReactiveFileTree, options: WatchOptions);
+    /** Re-fetch matching objects using the canonical file tree for paths. */
     refresh(): Promise<void>;
     close(): void;
 }
@@ -35,7 +34,7 @@ declare class ReactiveObjectImpl {
     #private;
     data: RoolObject | undefined;
     loading: boolean;
-    constructor(channel: RoolChannel, location: string);
+    constructor(channel: RoolChannel, fileTree: ReactiveFileTree, path: string);
     refresh(): Promise<void>;
     close(): void;
 }
@@ -52,15 +51,11 @@ declare class ReactiveConversationHandleImpl {
     getSystemInstruction(): string | undefined;
     setSystemInstruction(...args: Parameters<ConversationHandle['setSystemInstruction']>): Promise<void>;
     rename(...args: Parameters<ConversationHandle['rename']>): Promise<void>;
-    findObjects(...args: Parameters<ConversationHandle['findObjects']>): Promise<{
-        objects: RoolObject[];
-        message: string;
-    }>;
-    createObject(...args: Parameters<ConversationHandle['createObject']>): Promise<{
+    putObject(...args: Parameters<ConversationHandle['putObject']>): Promise<{
         object: RoolObject;
         message: string;
     }>;
-    updateObject(...args: Parameters<ConversationHandle['updateObject']>): Promise<{
+    patchObject(...args: Parameters<ConversationHandle['patchObject']>): Promise<{
         object: RoolObject;
         message: string;
     }>;
@@ -69,10 +64,13 @@ declare class ReactiveConversationHandleImpl {
         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>;
@@ -87,10 +85,10 @@ export type ReactiveConversationHandle = ReactiveConversationHandleImpl;
 declare class ReactiveChannelImpl {
     #private;
     interactions: Interaction[];
-    objectLocations: string[];
+    objectPaths: string[];
     collections: string[];
     conversations: ConversationInfo[];
-    constructor(channel: RoolChannel);
+    constructor(channel: RoolChannel, fileTree: ReactiveFileTree);
     get id(): string;
     get name(): string;
     get role(): import("@rool-dev/sdk").RoolUserRole;
@@ -99,22 +97,16 @@ declare class ReactiveChannelImpl {
     get channelName(): string | null;
     get isReadOnly(): boolean;
     get linkAccess(): import("@rool-dev/sdk").LinkAccess;
-    get extensionUrl(): string | null;
-    get manifest(): import("@rool-dev/sdk").ExtensionManifest | null;
     get isClosed(): boolean;
     close(): void;
     getObject(...args: Parameters<RoolChannel['getObject']>): Promise<RoolObject | undefined>;
+    getObjects(...args: Parameters<RoolChannel['getObjects']>): Promise<import("@rool-dev/sdk").GetObjectsResult>;
     stat(...args: Parameters<RoolChannel['stat']>): import("@rool-dev/sdk").RoolObjectStat | undefined;
-    findObjects(...args: Parameters<RoolChannel['findObjects']>): Promise<{
-        objects: RoolObject[];
-        message: string;
-    }>;
-    getObjectLocations(...args: Parameters<RoolChannel['getObjectLocations']>): string[];
-    createObject(...args: Parameters<RoolChannel['createObject']>): Promise<{
+    putObject(...args: Parameters<RoolChannel['putObject']>): Promise<{
         object: RoolObject;
         message: string;
     }>;
-    updateObject(...args: Parameters<RoolChannel['updateObject']>): Promise<{
+    patchObject(...args: Parameters<RoolChannel['patchObject']>): Promise<{
         object: RoolObject;
         message: string;
     }>;
@@ -123,10 +115,14 @@ declare class ReactiveChannelImpl {
         message: string;
     }>;
     deleteObjects(...args: Parameters<RoolChannel['deleteObjects']>): Promise<void>;
+    /** @deprecated Use deleteObjects instead. */
+    deletePaths(...args: Parameters<RoolChannel['deletePaths']>): Promise<void>;
     prompt(...args: Parameters<RoolChannel['prompt']>): Promise<{
         message: string;
         objects: RoolObject[];
     }>;
+    stop(): Promise<boolean>;
+    stopInteraction(...args: Parameters<RoolChannel['stopInteraction']>): Promise<boolean>;
     checkpoint(...args: Parameters<RoolChannel['checkpoint']>): Promise<string>;
     canUndo(): Promise<boolean>;
     canRedo(): Promise<boolean>;
@@ -155,15 +151,15 @@ declare class ReactiveChannelImpl {
     on(...args: Parameters<RoolChannel['on']>): () => void;
     off(...args: Parameters<RoolChannel['off']>): void;
     /**
-     * Create a reactive object that auto-updates when the object at this location changes.
+     * Create a reactive object that auto-updates when the object at this path changes.
      */
-    object(location: string): ReactiveObject;
+    object(path: string): ReactiveObject;
     /**
      * Create a reactive watch that auto-updates when matching objects change.
      */
     watch(options: WatchOptions): ReactiveWatch;
 }
-export declare function wrapChannel(channel: RoolChannel): ReactiveChannel;
+export declare function wrapChannel(channel: RoolChannel, fileTree: ReactiveFileTree): ReactiveChannel;
 export type ReactiveChannel = ReactiveChannelImpl;
 /**
  * A reactive list of channels for a space that auto-updates via SSE events.

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

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