@rool-dev/svelte 0.1.0-dev.9257360

package/README.md

@@ -0,0 +1,233 @@
+# Rool Svelte
+
+Svelte 5 runes for Rool Spaces. Transforms the event-based SDK into reactive state using `$state`.
+
+**Requires Svelte 5.**
+
+## Installation
+
+```bash
+npm install @rool-dev/svelte
+```
+
+## Quick Start
+
+```svelte
+<script>
+  import { createRool } from '@rool-dev/svelte';
+
+  const rool = createRool();
+  rool.init();
+</script>
+
+{#if !rool.authenticated}
+  <button onclick={() => rool.login('My App')}>Login</button>
+{:else}
+  <h1>My Spaces</h1>
+  {#each rool.spaces ?? [] as space}
+    <button onclick={() => rool.openSpace(space.id)}>
+      {space.name}
+    </button>
+  {/each}
+{/if}
+```
+
+## API
+
+### Lifecycle
+
+```typescript
+const rool = createRool();
+
+rool.init();              // Process auth callbacks (call on app startup)
+rool.login('My App');     // Redirect to login page
+rool.logout();            // Clear auth state
+rool.destroy();           // Clean up all resources
+```
+
+### Client State (Always Available)
+
+```svelte
+<script>
+  // Direct property access - automatically reactive
+  // rool.authenticated    → boolean
+  // rool.spaces           → RoolSpaceInfo[] | undefined
+  // rool.spacesLoading    → boolean
+  // rool.spacesError      → Error | null
+  // rool.connectionState  → 'connected' | 'disconnected' | 'reconnecting'
+</script>
+
+{#if rool.spacesLoading}
+  <p>Loading spaces...</p>
+{:else if rool.spacesError}
+  <p>Error: {rool.spacesError.message}</p>
+{:else}
+  {#each rool.spaces ?? [] as space}
+    <div>{space.name}</div>
+  {/each}
+{/if}
+```
+
+### Space Lifecycle
+
+Opening a space returns a `SpaceHandle` with reactive state and methods:
+
+```typescript
+const space = await rool.openSpace('space-id');
+const space = await rool.openSpace('space-id', { conversationId: 'my-convo' });
+const space = await rool.createSpace('My New Space');
+
+// Multiple spaces can be open at once
+const spaceA = await rool.openSpace('space-a');
+const spaceB = await rool.openSpace('space-b');
+
+// Clean up
+space.close();
+```
+
+### Space State
+
+```svelte
+<script>
+  // space.info              → { id, name, role }
+  // space.conversationId    → string
+  // space.conversations     → ConversationInfo[] | undefined
+  // space.conversationsLoading → boolean
+  // space.interactions      → Interaction[]
+  // space.systemInstruction → string | undefined
+</script>
+
+<h1>{space.info.name}</h1>
+<p>Role: {space.info.role}</p>
+
+<!-- Conversation picker -->
+<select onchange={(e) => space.setConversationId(e.target.value)}>
+  {#each space.conversations ?? [] as conv}
+    <option value={conv.id} selected={conv.id === space.conversationId}>
+      {conv.name ?? 'Untitled'}
+    </option>
+  {/each}
+</select>
+
+<!-- Chat messages -->
+{#each space.interactions as interaction}
+  <div class="message">
+    <strong>{interaction.operation}</strong>
+    <p>{interaction.output}</p>
+  </div>
+{/each}
+```
+
+### Object Factories
+
+Object state is created via factory functions and cached by arguments. Each returns an `AsyncValue` with reactive `value`, `loading`, and `error` properties.
+
+```svelte
+<script>
+  // Single object
+  const sun = space.object('sun-id');
+  // sun.value   → RoolObject | undefined
+  // sun.loading → boolean
+  // sun.error   → Error | null
+
+  // Children (objects this object links TO)
+  const planets = space.children('sun-id', 'hasPlanet');
+
+  // Parents (objects that link TO this object)
+  const stars = space.parents('earth-id', 'orbits');
+
+  // Query (manual refresh only)
+  const articles = space.query({ where: { type: 'article' } });
+</script>
+
+{#if sun.loading}
+  <p>Loading...</p>
+{:else if sun.error}
+  <p>Error: {sun.error.message}</p>
+{:else if sun.value}
+  <h1>{sun.value.name}</h1>
+{/if}
+
+<!-- Manual refresh -->
+<button onclick={() => articles.refresh()}>Refresh</button>
+```
+
+### Mutations
+
+All mutations are async and pass through to the underlying SDK.
+
+```typescript
+// Create objects
+const { object, message } = await space.createObject({
+  data: { type: 'article', title: 'Hello World' }
+});
+
+// Update objects
+await space.updateObject(object.id, {
+  data: { status: 'published' }
+});
+
+// Delete objects
+await space.deleteObjects([object.id]);
+
+// Links
+await space.link(sourceId, 'references', targetId);
+await space.unlink(sourceId, 'references', targetId);
+
+// AI prompt
+const { message, objects } = await space.prompt(
+  'Create a summary of all articles'
+);
+
+// Undo/Redo
+await space.checkpoint('Before edit');
+await space.updateObject(id, { data: { title: 'New title' } });
+await space.undo();  // Reverts the update
+await space.redo();  // Reapplies the update
+```
+
+### Conversation Management
+
+```typescript
+space.setConversationId('new-convo-id');
+await space.setSystemInstruction('You are a helpful assistant');
+await space.renameConversation('convo-id', 'Research Thread');
+await space.deleteConversation('convo-id');
+```
+
+## Auto-Refresh Behavior
+
+| State | Auto-refreshes on |
+|-------|-------------------|
+| `object(id)` | `objectUpdated`/`objectDeleted` for that ID |
+| `children(id, rel)` | `linked`/`unlinked` events + member object updates |
+| `parents(id, rel)` | `linked`/`unlinked` events + member object updates |
+| `query(options)` | Never (call `refresh()` manually) |
+| `rool.spaces` | `spaceCreated`/`spaceDeleted`/`spaceRenamed` |
+| `space.conversations` | `conversationsChanged` |
+| `space.interactions` | `conversationUpdated` + `conversationIdChanged` |
+
+## AsyncValue Interface
+
+Object factories return `AsyncValue` instances:
+
+```typescript
+class AsyncValue<T> {
+  value: T | undefined;      // The data (reactive)
+  loading: boolean;          // Loading state (reactive)
+  error: Error | null;       // Last error (reactive)
+  refresh(): Promise<void>;  // Manually refresh
+}
+```
+
+## Design Principles
+
+1. **Svelte 5 runes** — Uses `$state` for reactivity, no legacy stores
+2. **Direct property access** — No `$` prefix needed, just access properties
+3. **Go through the API** — Never exposes raw space data, all access via SDK methods
+4. **Auto-refresh where safe** — Object/relation state auto-refreshes; queries are manual
+5. **Caching** — Factory functions return cached instances by arguments
+
+## License
+
+MIT - see [LICENSE](../../LICENSE) for details.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createRool, generateId } from './rool.svelte.js';
+export type { Rool, SpaceHandle, SpaceInfo, AsyncValue, CreateObjectOptions, UpdateObjectOptions, RoolSpaceInfo, RoolObject, RoolUserRole, ConnectionState, ConversationInfo, Interaction, FindObjectsOptions, PromptOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,YAAY,EAEV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EAEnB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+// Main export
+export { createRool, generateId } from './rool.svelte.js';

package/dist/rool.svelte.d.ts

@@ -0,0 +1,36 @@
+import { type RoolSpaceInfo, type ConnectionState } from '@rool-dev/sdk';
+import { type SpaceHandle } from './space.svelte.js';
+/**
+ * Rool client with reactive state using Svelte 5 runes.
+ */
+declare class RoolImpl {
+    #private;
+    authenticated: boolean;
+    spaces: RoolSpaceInfo[] | undefined;
+    spacesLoading: boolean;
+    spacesError: Error | null;
+    connectionState: ConnectionState;
+    constructor();
+    init(): boolean;
+    login(appName: string): void;
+    logout(): void;
+    openSpace(id: string, options?: {
+        conversationId?: string;
+    }): Promise<SpaceHandle>;
+    createSpace(name?: string, options?: {
+        conversationId?: string;
+    }): Promise<SpaceHandle>;
+    refreshSpaces(): Promise<void>;
+    destroy(): void;
+}
+/**
+ * Create a new Rool instance.
+ */
+export declare function createRool(): RoolImpl;
+/**
+ * Generate a unique 6-character alphanumeric ID.
+ */
+export declare function generateId(): string;
+export type Rool = RoolImpl;
+export {};
+//# sourceMappingURL=rool.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rool.svelte.d.ts","sourceRoot":"","sources":["../src/rool.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE;;GAEG;AACH,cAAM,QAAQ;;IAMZ,aAAa,UAAiB;IAC9B,MAAM,8BAAkD;IACxD,aAAa,UAAiB;IAC9B,WAAW,eAA8B;IACzC,eAAe,kBAA2C;;IAsD1D,IAAI,IAAI,OAAO;IAIf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,MAAM,IAAI,IAAI;IAYR,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAelF,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAmB7F,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,OAAO,IAAI,IAAI;CAahB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,QAAQ,CAErC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC"}

package/dist/rool.svelte.js

@@ -0,0 +1,135 @@
+import { RoolClient } from '@rool-dev/sdk';
+import { createSpaceHandle } from './space.svelte.js';
+/**
+ * Rool client with reactive state using Svelte 5 runes.
+ */
+class RoolImpl {
+    #client;
+    #unsubscribers = [];
+    #openSpaces = new Set();
+    // Reactive state
+    authenticated = $state(false);
+    spaces = $state(undefined);
+    spacesLoading = $state(false);
+    spacesError = $state(null);
+    connectionState = $state('disconnected');
+    constructor() {
+        this.#client = new RoolClient();
+        this.#setupEventListeners();
+    }
+    #setupEventListeners() {
+        const onAuthStateChanged = (auth) => {
+            this.authenticated = auth;
+            if (auth) {
+                this.#refreshSpaces();
+            }
+            else {
+                this.spaces = undefined;
+            }
+        };
+        this.#client.on('authStateChanged', onAuthStateChanged);
+        this.#unsubscribers.push(() => this.#client.off('authStateChanged', onAuthStateChanged));
+        const onConnectionStateChanged = (state) => {
+            this.connectionState = state;
+        };
+        this.#client.on('connectionStateChanged', onConnectionStateChanged);
+        this.#unsubscribers.push(() => this.#client.off('connectionStateChanged', onConnectionStateChanged));
+        const onSpaceCreated = () => this.#refreshSpaces();
+        this.#client.on('spaceCreated', onSpaceCreated);
+        this.#unsubscribers.push(() => this.#client.off('spaceCreated', onSpaceCreated));
+        const onSpaceDeleted = () => this.#refreshSpaces();
+        this.#client.on('spaceDeleted', onSpaceDeleted);
+        this.#unsubscribers.push(() => this.#client.off('spaceDeleted', onSpaceDeleted));
+        const onSpaceRenamed = () => this.#refreshSpaces();
+        this.#client.on('spaceRenamed', onSpaceRenamed);
+        this.#unsubscribers.push(() => this.#client.off('spaceRenamed', onSpaceRenamed));
+    }
+    async #refreshSpaces() {
+        this.spacesLoading = true;
+        this.spacesError = null;
+        try {
+            this.spaces = await this.#client.listSpaces();
+        }
+        catch (e) {
+            this.spacesError = e;
+        }
+        finally {
+            this.spacesLoading = false;
+        }
+    }
+    // ===========================================================================
+    // Lifecycle
+    // ===========================================================================
+    init() {
+        return this.#client.initialize();
+    }
+    login(appName) {
+        this.#client.login(appName);
+    }
+    logout() {
+        for (const space of this.#openSpaces) {
+            space.close();
+        }
+        this.#openSpaces.clear();
+        this.#client.logout();
+    }
+    // ===========================================================================
+    // Space Lifecycle
+    // ===========================================================================
+    async openSpace(id, options) {
+        const sdkSpace = await this.#client.openSpace(id, options);
+        const handle = createSpaceHandle(sdkSpace);
+        this.#openSpaces.add(handle);
+        // Track when closed
+        const originalClose = handle.close.bind(handle);
+        handle.close = () => {
+            this.#openSpaces.delete(handle);
+            originalClose();
+        };
+        return handle;
+    }
+    async createSpace(name, options) {
+        const sdkSpace = await this.#client.createSpace(name, options);
+        const handle = createSpaceHandle(sdkSpace);
+        this.#openSpaces.add(handle);
+        // Track when closed
+        const originalClose = handle.close.bind(handle);
+        handle.close = () => {
+            this.#openSpaces.delete(handle);
+            originalClose();
+        };
+        return handle;
+    }
+    // ===========================================================================
+    // Spaces management
+    // ===========================================================================
+    refreshSpaces() {
+        return this.#refreshSpaces();
+    }
+    // ===========================================================================
+    // Cleanup
+    // ===========================================================================
+    destroy() {
+        for (const space of this.#openSpaces) {
+            space.close();
+        }
+        this.#openSpaces.clear();
+        for (const unsub of this.#unsubscribers) {
+            unsub();
+        }
+        this.#unsubscribers.length = 0;
+        this.#client.destroy();
+    }
+}
+/**
+ * Create a new Rool instance.
+ */
+export function createRool() {
+    return new RoolImpl();
+}
+/**
+ * Generate a unique 6-character alphanumeric ID.
+ */
+export function generateId() {
+    return RoolClient.generateId();
+}

package/dist/space.svelte.d.ts

@@ -0,0 +1,72 @@
+import type { RoolSpace, RoolObject, ConversationInfo, Interaction, FindObjectsOptions, PromptOptions, RoolUserRole } from '@rool-dev/sdk';
+export interface SpaceInfo {
+    id: string;
+    name: string;
+    role: RoolUserRole;
+}
+export interface CreateObjectOptions {
+    data: Record<string, unknown>;
+    prompt?: string;
+    ephemeral?: boolean;
+}
+export interface UpdateObjectOptions {
+    data?: Record<string, unknown>;
+    prompt?: string;
+    ephemeral?: boolean;
+}
+export declare class AsyncValue<T> {
+    #private;
+    value: T | undefined;
+    loading: boolean;
+    error: Error | null;
+    constructor(fetcher: () => Promise<T>, fetchOnCreate?: boolean);
+    refresh(): Promise<void>;
+    set(value: T | undefined): void;
+    clear(): void;
+}
+declare class SpaceHandleImpl {
+    #private;
+    info: SpaceInfo;
+    conversationId: string;
+    conversations: ConversationInfo[] | undefined;
+    conversationsLoading: boolean;
+    conversationsError: Error | null;
+    interactions: Interaction[];
+    systemInstruction: string | undefined;
+    constructor(space: RoolSpace);
+    setConversationId(id: string): void;
+    setSystemInstruction(instruction: string | null): Promise<void>;
+    refreshConversations(): Promise<void>;
+    object(id: string): AsyncValue<RoolObject>;
+    children(id: string, relation: string): AsyncValue<RoolObject[]>;
+    parents(id: string, relation: string): AsyncValue<RoolObject[]>;
+    query(options: FindObjectsOptions): AsyncValue<RoolObject[]>;
+    createObject(options: CreateObjectOptions): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    updateObject(objectId: string, options: UpdateObjectOptions): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    deleteObjects(objectIds: string[]): Promise<void>;
+    link(sourceId: string, relation: string, targetId: string): Promise<void>;
+    unlink(sourceId: string, relation?: string, targetId?: string): Promise<boolean>;
+    prompt(text: string, options?: PromptOptions): Promise<{
+        message: string;
+        objects: RoolObject[];
+    }>;
+    checkpoint(label?: string): Promise<string>;
+    undo(): Promise<boolean>;
+    redo(): Promise<boolean>;
+    deleteConversation(conversationId?: string): Promise<void>;
+    renameConversation(conversationId: string, name: string): Promise<void>;
+    close(): void;
+}
+/**
+ * Create a SpaceHandle from a RoolSpace instance.
+ */
+export declare function createSpaceHandle(space: RoolSpace): SpaceHandle;
+export type SpaceHandle = SpaceHandleImpl;
+export {};
+//# sourceMappingURL=space.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"space.svelte.d.ts","sourceRoot":"","sources":["../src/space.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,YAAY,EACb,MAAM,eAAe,CAAC;AAMvB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,qBAAa,UAAU,CAAC,CAAC;;IACvB,KAAK,gBAAoC;IACzC,OAAO,UAAiB;IACxB,KAAK,eAA8B;gBAIvB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,aAAa,UAAO;IAOrD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI;IAK/B,KAAK,IAAI,IAAI;CAKd;AAMD,cAAM,eAAe;;IAWnB,IAAI,YAA2D;IAC/D,cAAc,SAAc;IAC5B,aAAa,iCAAqD;IAClE,oBAAoB,UAAiB;IACrC,kBAAkB,eAA8B;IAChD,YAAY,gBAA6B;IACzC,iBAAiB,qBAAyC;gBAE9C,KAAK,EAAE,SAAS;IAiJ5B,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO7B,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC;IAc1C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;IAWhE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;IAW/D,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;IAkB5D,YAAY,CAAC,OAAO,EAAE,mBAAmB;;;;IAIzC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB;;;;IAI3D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE;IAIjC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAIzD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAI7D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;;;;IAI5C,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM;IAIzB,IAAI;IAIJ,IAAI;IAQJ,kBAAkB,CAAC,cAAc,CAAC,EAAE,MAAM;IAI1C,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAQvD,KAAK,IAAI,IAAI;CA4Bd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,CAE/D;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC"}

package/dist/space.svelte.js

@@ -0,0 +1,318 @@
+// ===========================================================================
+// AsyncValue - reactive async data wrapper
+// ===========================================================================
+export class AsyncValue {
+    value = $state(undefined);
+    loading = $state(false);
+    error = $state(null);
+    #fetcher;
+    constructor(fetcher, fetchOnCreate = true) {
+        this.#fetcher = fetcher;
+        if (fetchOnCreate) {
+            this.refresh();
+        }
+    }
+    async refresh() {
+        this.loading = true;
+        this.error = null;
+        try {
+            this.value = await this.#fetcher();
+        }
+        catch (e) {
+            this.error = e;
+        }
+        finally {
+            this.loading = false;
+        }
+    }
+    set(value) {
+        this.value = value;
+        this.error = null;
+    }
+    clear() {
+        this.value = undefined;
+        this.loading = false;
+        this.error = null;
+    }
+}
+// ===========================================================================
+// SpaceHandle - reactive space wrapper
+// ===========================================================================
+class SpaceHandleImpl {
+    #space;
+    #unsubscribers = [];
+    // Store caches
+    #objectCache = new Map();
+    #childrenCache = new Map();
+    #parentsCache = new Map();
+    #queryCache = new Map();
+    // Reactive state
+    info = $state({ id: '', name: '', role: 'viewer' });
+    conversationId = $state('');
+    conversations = $state(undefined);
+    conversationsLoading = $state(false);
+    conversationsError = $state(null);
+    interactions = $state([]);
+    systemInstruction = $state(undefined);
+    constructor(space) {
+        this.#space = space;
+        // Initialize state
+        this.info = {
+            id: space.id,
+            name: space.name,
+            role: space.role,
+        };
+        this.conversationId = space.conversationId;
+        this.interactions = space.getInteractions();
+        this.systemInstruction = space.getSystemInstruction();
+        // Initial fetches
+        this.#refreshConversations();
+        // Setup event listeners
+        this.#setupEventListeners();
+    }
+    #setupEventListeners() {
+        // Object events
+        const onObjectCreated = (event) => {
+            const store = this.#objectCache.get(event.objectId);
+            if (store) {
+                store.set(event.object);
+            }
+        };
+        this.#space.on('objectCreated', onObjectCreated);
+        this.#unsubscribers.push(() => this.#space.off('objectCreated', onObjectCreated));
+        const onObjectUpdated = (event) => {
+            const store = this.#objectCache.get(event.objectId);
+            if (store) {
+                store.set(event.object);
+            }
+            this.#refreshRelationStoresForObject(event.objectId);
+        };
+        this.#space.on('objectUpdated', onObjectUpdated);
+        this.#unsubscribers.push(() => this.#space.off('objectUpdated', onObjectUpdated));
+        const onObjectDeleted = (event) => {
+            const store = this.#objectCache.get(event.objectId);
+            if (store) {
+                store.set(undefined);
+            }
+            this.#refreshRelationStoresForObject(event.objectId);
+        };
+        this.#space.on('objectDeleted', onObjectDeleted);
+        this.#unsubscribers.push(() => this.#space.off('objectDeleted', onObjectDeleted));
+        // Link events
+        const onLinked = (event) => {
+            const childrenKey = JSON.stringify([event.sourceId, event.relation]);
+            this.#childrenCache.get(childrenKey)?.refresh();
+            const parentsKey = JSON.stringify([event.targetId, event.relation]);
+            this.#parentsCache.get(parentsKey)?.refresh();
+        };
+        this.#space.on('linked', onLinked);
+        this.#unsubscribers.push(() => this.#space.off('linked', onLinked));
+        const onUnlinked = (event) => {
+            const childrenKey = JSON.stringify([event.sourceId, event.relation]);
+            this.#childrenCache.get(childrenKey)?.refresh();
+            const parentsKey = JSON.stringify([event.targetId, event.relation]);
+            this.#parentsCache.get(parentsKey)?.refresh();
+        };
+        this.#space.on('unlinked', onUnlinked);
+        this.#unsubscribers.push(() => this.#space.off('unlinked', onUnlinked));
+        // Conversation events
+        const onConversationUpdated = (event) => {
+            if (event.conversationId === this.conversationId) {
+                this.interactions = this.#space.getInteractions();
+                this.systemInstruction = this.#space.getSystemInstruction();
+            }
+        };
+        this.#space.on('conversationUpdated', onConversationUpdated);
+        this.#unsubscribers.push(() => this.#space.off('conversationUpdated', onConversationUpdated));
+        const onConversationsChanged = () => {
+            this.#refreshConversations();
+        };
+        this.#space.on('conversationsChanged', onConversationsChanged);
+        this.#unsubscribers.push(() => this.#space.off('conversationsChanged', onConversationsChanged));
+        const onConversationIdChanged = (event) => {
+            this.conversationId = event.newConversationId;
+            this.interactions = this.#space.getInteractions();
+            this.systemInstruction = this.#space.getSystemInstruction();
+        };
+        this.#space.on('conversationIdChanged', onConversationIdChanged);
+        this.#unsubscribers.push(() => this.#space.off('conversationIdChanged', onConversationIdChanged));
+        // Reset event (undo/redo, resync)
+        const onReset = () => {
+            for (const store of this.#objectCache.values()) {
+                store.refresh();
+            }
+            for (const store of this.#childrenCache.values()) {
+                store.refresh();
+            }
+            for (const store of this.#parentsCache.values()) {
+                store.refresh();
+            }
+            for (const store of this.#queryCache.values()) {
+                store.refresh();
+            }
+            this.#refreshConversations();
+            this.interactions = this.#space.getInteractions();
+            this.systemInstruction = this.#space.getSystemInstruction();
+        };
+        this.#space.on('reset', onReset);
+        this.#unsubscribers.push(() => this.#space.off('reset', onReset));
+    }
+    async #refreshConversations() {
+        this.conversationsLoading = true;
+        this.conversationsError = null;
+        try {
+            this.conversations = await this.#space.listConversations();
+        }
+        catch (e) {
+            this.conversationsError = e;
+        }
+        finally {
+            this.conversationsLoading = false;
+        }
+    }
+    #refreshRelationStoresForObject(objectId) {
+        for (const store of this.#childrenCache.values()) {
+            if (store.value?.some((obj) => obj.id === objectId)) {
+                store.refresh();
+            }
+        }
+        for (const store of this.#parentsCache.values()) {
+            if (store.value?.some((obj) => obj.id === objectId)) {
+                store.refresh();
+            }
+        }
+    }
+    // ===========================================================================
+    // Conversation management
+    // ===========================================================================
+    setConversationId(id) {
+        if (id !== this.conversationId) {
+            this.#space.conversationId = id;
+            // Note: conversationIdChanged event will update our state
+        }
+    }
+    async setSystemInstruction(instruction) {
+        await this.#space.setSystemInstruction(instruction);
+        this.systemInstruction = instruction ?? undefined;
+    }
+    refreshConversations() {
+        return this.#refreshConversations();
+    }
+    // ===========================================================================
+    // Object store factories
+    // ===========================================================================
+    object(id) {
+        const cached = this.#objectCache.get(id);
+        if (cached)
+            return cached;
+        const store = new AsyncValue(async () => {
+            const obj = await this.#space.getObject(id);
+            if (!obj)
+                throw new Error(`Object not found: ${id}`);
+            return obj;
+        });
+        this.#objectCache.set(id, store);
+        return store;
+    }
+    children(id, relation) {
+        const key = JSON.stringify([id, relation]);
+        const cached = this.#childrenCache.get(key);
+        if (cached)
+            return cached;
+        const store = new AsyncValue(() => this.#space.getChildren(id, relation));
+        this.#childrenCache.set(key, store);
+        return store;
+    }
+    parents(id, relation) {
+        const key = JSON.stringify([id, relation]);
+        const cached = this.#parentsCache.get(key);
+        if (cached)
+            return cached;
+        const store = new AsyncValue(() => this.#space.getParents(id, relation));
+        this.#parentsCache.set(key, store);
+        return store;
+    }
+    query(options) {
+        const key = JSON.stringify(options);
+        const cached = this.#queryCache.get(key);
+        if (cached)
+            return cached;
+        const store = new AsyncValue(async () => {
+            const result = await this.#space.findObjects(options);
+            return result.objects;
+        });
+        this.#queryCache.set(key, store);
+        return store;
+    }
+    // ===========================================================================
+    // Mutations (passthrough to SDK)
+    // ===========================================================================
+    createObject(options) {
+        return this.#space.createObject(options);
+    }
+    updateObject(objectId, options) {
+        return this.#space.updateObject(objectId, options);
+    }
+    deleteObjects(objectIds) {
+        return this.#space.deleteObjects(objectIds);
+    }
+    link(sourceId, relation, targetId) {
+        return this.#space.link(sourceId, relation, targetId);
+    }
+    unlink(sourceId, relation, targetId) {
+        return this.#space.unlink(sourceId, relation, targetId);
+    }
+    prompt(text, options) {
+        return this.#space.prompt(text, options);
+    }
+    checkpoint(label) {
+        return this.#space.checkpoint(label);
+    }
+    undo() {
+        return this.#space.undo();
+    }
+    redo() {
+        return this.#space.redo();
+    }
+    // ===========================================================================
+    // Conversation management (passthrough)
+    // ===========================================================================
+    deleteConversation(conversationId) {
+        return this.#space.deleteConversation(conversationId);
+    }
+    renameConversation(conversationId, name) {
+        return this.#space.renameConversation(conversationId, name);
+    }
+    // ===========================================================================
+    // Cleanup
+    // ===========================================================================
+    close() {
+        for (const unsub of this.#unsubscribers) {
+            unsub();
+        }
+        this.#unsubscribers.length = 0;
+        for (const store of this.#objectCache.values()) {
+            store.clear();
+        }
+        this.#objectCache.clear();
+        for (const store of this.#childrenCache.values()) {
+            store.clear();
+        }
+        this.#childrenCache.clear();
+        for (const store of this.#parentsCache.values()) {
+            store.clear();
+        }
+        this.#parentsCache.clear();
+        for (const store of this.#queryCache.values()) {
+            store.clear();
+        }
+        this.#queryCache.clear();
+        this.#space.close();
+    }
+}
+/**
+ * Create a SpaceHandle from a RoolSpace instance.
+ */
+export function createSpaceHandle(space) {
+    return new SpaceHandleImpl(space);
+}

package/dist/types.d.ts

@@ -0,0 +1,4 @@
+export type { RoolSpaceInfo, RoolObject, RoolUserRole, ConnectionState, ConversationInfo, Interaction, FindObjectsOptions, PromptOptions, } from '@rool-dev/sdk';
+export type { Rool } from './rool.svelte.js';
+export type { SpaceHandle, SpaceInfo, AsyncValue, CreateObjectOptions, UpdateObjectOptions } from './space.svelte.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,aAAa,GACd,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@rool-dev/svelte",
+  "version": "0.1.0-dev.9257360",
+  "description": "Svelte 5 runes for Rool Spaces",
+  "packageManager": "pnpm@10.17.1",
+  "type": "module",
+  "svelte": "./dist/index.js",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "svelte-package -i src -o dist",
+    "dev": "svelte-package -i src -o dist --watch",
+    "typecheck": "svelte-check --tsconfig ./tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://docs.rool.dev/svelte",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rool-dev/rool-js.git",
+    "directory": "packages/svelte"
+  },
+  "keywords": [
+    "rool",
+    "svelte",
+    "svelte5",
+    "runes",
+    "reactive",
+    "real-time"
+  ],
+  "author": {
+    "name": "Rool Limited",
+    "email": "info@rool.dev",
+    "url": "https://rool.dev"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@rool-dev/sdk": "workspace:*"
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "devDependencies": {
+    "@sveltejs/package": "^2.0.0",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.0.0",
+    "typescript": "^5.9.3"
+  }
+}