@rool-dev/sdk 0.2.0 → 0.3.0

package/dist/space.js

@@ -1,615 +1,69 @@
-import { immutableJSONPatch } from 'immutable-json-patch';
-import { EventEmitter } from './event-emitter.js';
-import { SpaceSubscriptionManager } from './subscription.js';
-// 6-character alphanumeric ID (62^6 = 56.8 billion possible values)
-const ID_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
-export function generateEntityId() {
-    let result = '';
-    for (let i = 0; i < 6; i++) {
-        result += ID_CHARS[Math.floor(Math.random() * ID_CHARS.length)];
-    }
-    return result;
-}
+// =============================================================================
+// RoolSpace — Lightweight handle for space-level admin operations
+// =============================================================================
 /**
- * First-class Space object.
+ * A space is a container for objects, schema, metadata, and channels.
  *
- * Features:
- * - High-level object operations
- * - Built-in undo/redo with checkpoints
- * - Metadata management
- * - Event emission for state changes
- * - Real-time updates via space-specific subscription
+ * RoolSpace is a lightweight handle for space-level admin operations:
+ * user management, link access, channel management, and export.
+ * It does not have a real-time subscription — use channels for live data.
+ *
+ * To work with objects and AI, open a channel on the space.
  */
-export class RoolSpace extends EventEmitter {
+export class RoolSpace {
     _id;
     _name;
     _role;
     _linkAccess;
-    _userId;
-    _conversationId;
-    _data;
-    _closed = false;
+    _channels;
     graphqlClient;
     mediaClient;
-    subscriptionManager;
-    onCloseCallback;
-    _subscriptionReady;
-    logger;
+    _openChannelFn;
     constructor(config) {
-        super();
         this._id = config.id;
         this._name = config.name;
         this._role = config.role;
         this._linkAccess = config.linkAccess;
-        this._userId = config.userId;
-        this._emitterLogger = config.logger;
-        this._conversationId = config.conversationId ?? generateEntityId();
-        this._data = config.initialData;
+        this._channels = config.channels;
         this.graphqlClient = config.graphqlClient;
         this.mediaClient = config.mediaClient;
-        this.logger = config.logger;
-        this.onCloseCallback = config.onClose;
-        // Create space-level subscription
-        this.subscriptionManager = new SpaceSubscriptionManager({
-            graphqlUrl: config.graphqlUrl,
-            authManager: config.authManager,
-            logger: this.logger,
-            spaceId: this._id,
-            conversationId: this._conversationId,
-            onEvent: (event) => this.handleSpaceEvent(event),
-            onConnectionStateChanged: () => {
-                // Space-level connection state (could emit events if needed)
-            },
-            onError: (error) => {
-                this.logger.error(`[RoolSpace ${this._id}] Subscription error:`, error);
-            },
-        });
-        // Start subscription - store promise for openSpace/createSpace to await
-        this._subscriptionReady = this.subscriptionManager.subscribe();
-    }
-    /**
-     * Wait for the real-time subscription to be established.
-     * Called internally by openSpace/createSpace before returning the space.
-     * @internal
-     */
-    _waitForSubscription() {
-        return this._subscriptionReady;
+        this._openChannelFn = config.openChannelFn;
     }
     // ===========================================================================
     // Properties
     // ===========================================================================
-    get id() {
-        return this._id;
-    }
-    get name() {
-        return this._name;
-    }
-    get role() {
-        return this._role;
-    }
-    get linkAccess() {
-        return this._linkAccess;
-    }
-    /** Current user's ID (for identifying own interactions) */
-    get userId() {
-        return this._userId;
-    }
-    /**
-     * Get the conversation ID for this space instance.
-     * Used for AI context tracking and echo suppression.
-     */
-    get conversationId() {
-        return this._conversationId;
-    }
-    /**
-     * Set the conversation ID for AI context tracking.
-     * Emits 'conversationIdChanged' event.
-     */
-    set conversationId(value) {
-        if (value === this._conversationId)
-            return;
-        const previous = this._conversationId;
-        this._conversationId = value;
-        this.emit('conversationIdChanged', {
-            previousConversationId: previous,
-            newConversationId: value,
-        });
-    }
-    get isReadOnly() {
-        return this._role === 'viewer';
-    }
+    get id() { return this._id; }
+    get name() { return this._name; }
+    get role() { return this._role; }
+    get linkAccess() { return this._linkAccess; }
     // ===========================================================================
-    // Conversation Access
+    // Channel Lifecycle
     // ===========================================================================
     /**
-     * Get interactions for this space's current conversationId.
-     * Returns the interactions array.
-     */
-    getInteractions() {
-        return this._data.conversations?.[this._conversationId]?.interactions ?? [];
-    }
-    /**
-     * Get interactions for a specific conversation ID.
-     * Useful for viewing other conversations in the space.
-     */
-    getInteractionsById(conversationId) {
-        return this._data.conversations?.[conversationId]?.interactions ?? [];
-    }
-    /**
-     * Get all conversation IDs that have conversations in this space.
+     * Open a channel on this space.
+     * If the channel doesn't exist, the server creates it.
      */
-    getConversationIds() {
-        return Object.keys(this._data.conversations ?? {});
+    async openChannel(channelId) {
+        return this._openChannelFn(this._id, channelId);
     }
     // ===========================================================================
-    // Space Lifecycle
+    // Space Admin
     // ===========================================================================
     /**
      * Rename this space.
      */
     async rename(newName) {
-        const oldName = this._name;
+        await this.graphqlClient.renameSpace(this._id, newName);
         this._name = newName;
-        try {
-            await this.graphqlClient.renameSpace(this._id, newName);
-        }
-        catch (error) {
-            this._name = oldName;
-            throw error;
-        }
-    }
-    /**
-     * Close this space and clean up resources.
-     * Stops real-time subscription and unregisters from client.
-     */
-    close() {
-        this._closed = true;
-        this.subscriptionManager.destroy();
-        this.onCloseCallback(this._id);
-        this.removeAllListeners();
-    }
-    // ===========================================================================
-    // Undo / Redo (Server-managed checkpoints)
-    // ===========================================================================
-    /**
-     * Create a checkpoint (seal current batch of changes).
-     * Patches accumulate automatically - this seals them with a label.
-     * @returns The checkpoint ID
-     */
-    async checkpoint(label = 'Change') {
-        const result = await this.graphqlClient.checkpoint(this._id, label, this._conversationId);
-        return result.checkpointId;
-    }
-    /**
-     * Check if undo is available.
-     */
-    async canUndo() {
-        const status = await this.graphqlClient.checkpointStatus(this._id, this._conversationId);
-        return status.canUndo;
-    }
-    /**
-     * Check if redo is available.
-     */
-    async canRedo() {
-        const status = await this.graphqlClient.checkpointStatus(this._id, this._conversationId);
-        return status.canRedo;
-    }
-    /**
-     * Undo the most recent batch of changes.
-     * Reverses your most recent batch (sealed or open).
-     * Conflicting patches (modified by others) are silently skipped.
-     * @returns true if undo was performed
-     */
-    async undo() {
-        const result = await this.graphqlClient.undo(this._id, this._conversationId);
-        // Server broadcasts space_patched if successful, which updates local state
-        return result.success;
-    }
-    /**
-     * Redo a previously undone batch of changes.
-     * @returns true if redo was performed
-     */
-    async redo() {
-        const result = await this.graphqlClient.redo(this._id, this._conversationId);
-        // Server broadcasts space_patched if successful, which updates local state
-        return result.success;
     }
     /**
-     * Clear checkpoint history for this conversation.
+     * Delete this space permanently. Cannot be undone.
      */
-    async clearHistory() {
-        await this.graphqlClient.clearCheckpointHistory(this._id, this._conversationId);
+    async delete() {
+        await this.graphqlClient.deleteSpace(this._id);
     }
     // ===========================================================================
-    // Object Operations
-    // ===========================================================================
-    /**
-     * Get an object's data by ID.
-     * Returns just the data portion (RoolObject), not the full entry with meta/links.
-     */
-    async getObject(objectId) {
-        return this._data.objects[objectId]?.data;
-    }
-    /**
-     * Get an object's stat (audit information).
-     * Returns modification timestamp and author, or undefined if object not found.
-     */
-    async stat(objectId) {
-        const entry = this._data.objects[objectId];
-        if (!entry)
-            return undefined;
-        return {
-            modifiedAt: entry.modifiedAt,
-            modifiedBy: entry.modifiedBy,
-            modifiedByName: entry.modifiedByName,
-        };
-    }
-    /**
-     * Find objects using structured filters and/or natural language.
-     *
-     * `where` provides exact-match filtering — values must match literally (no placeholders or operators).
-     * `prompt` enables AI-powered semantic queries. When both are provided, `where` and `objectIds`
-     * constrain the data set before the AI sees it.
-     *
-     * @param options.where - Exact-match field filter (e.g. `{ type: 'article' }`). Constrains which objects the AI can see when combined with `prompt`.
-     * @param options.prompt - Natural language query. Triggers AI evaluation (uses credits).
-     * @param options.limit - Maximum number of results to return (applies to structured filtering only; the AI controls its own result size).
-     * @param options.objectIds - Scope search to specific object IDs. Constrains the candidate set in both structured and AI queries.
-     * @param options.order - Sort order by modifiedAt: `'asc'` or `'desc'` (default: `'desc'`). Only applies to structured filtering (no `prompt`).
-     * @param options.ephemeral - If true, the query won't be recorded in conversation history.
-     * @returns The matching objects and a descriptive message.
-     *
-     * @example
-     * // Exact match (no AI, no credits)
-     * const { objects } = await space.findObjects({ where: { type: 'article' } });
-     *
-     * @example
-     * // Natural language (AI query)
-     * const { objects, message } = await space.findObjects({
-     *   prompt: 'articles about space exploration'
-     * });
-     *
-     * @example
-     * // Combined — where narrows the data, prompt queries within it
-     * const { objects } = await space.findObjects({
-     *   where: { type: 'article' },
-     *   prompt: 'that discuss climate solutions positively',
-     *   limit: 10
-     * });
-     */
-    async findObjects(options) {
-        return this.graphqlClient.findObjects(this._id, options, this._conversationId);
-    }
-    /**
-     * Get all object IDs.
-     * @param options.limit - Maximum number of IDs to return
-     * @param options.order - Sort order by modifiedAt ('asc' or 'desc', default: 'desc')
-     */
-    getObjectIds(options) {
-        const order = options?.order ?? 'desc';
-        let entries = Object.entries(this._data.objects);
-        // Sort by modifiedAt
-        entries.sort((a, b) => {
-            const aTime = a[1].modifiedAt ?? 0;
-            const bTime = b[1].modifiedAt ?? 0;
-            return order === 'desc' ? bTime - aTime : aTime - bTime;
-        });
-        let ids = entries.map(([id]) => id);
-        if (options?.limit) {
-            ids = ids.slice(0, options.limit);
-        }
-        return ids;
-    }
-    /**
-     * Create a new object with optional AI generation.
-     * @param options.data - Object data fields (any key-value pairs). Optionally include `id` to use a custom ID. Use {{placeholder}} for AI-generated content. Fields prefixed with _ are hidden from AI.
-     * @param options.ephemeral - If true, the operation won't be recorded in conversation history.
-     * @returns The created object (with AI-filled content) and message
-     */
-    async createObject(options) {
-        const { data, ephemeral } = options;
-        // Use data.id if provided (string), otherwise generate
-        const objectId = typeof data.id === 'string' ? data.id : generateEntityId();
-        // Validate ID format: alphanumeric, hyphens, underscores only
-        if (!/^[a-zA-Z0-9_-]+$/.test(objectId)) {
-            throw new Error(`Invalid object ID "${objectId}". IDs must contain only alphanumeric characters, hyphens, and underscores.`);
-        }
-        // Fail if object already exists
-        if (this._data.objects[objectId]) {
-            throw new Error(`Object "${objectId}" already exists`);
-        }
-        const dataWithId = { ...data, id: objectId };
-        // Build the entry for local state (optimistic - server will overwrite audit fields)
-        const entry = {
-            data: dataWithId,
-            modifiedAt: Date.now(),
-            modifiedBy: this._userId,
-            modifiedByName: null,
-        };
-        // Update local state immediately (optimistic)
-        this._data.objects[objectId] = entry;
-        this.emit('objectCreated', { objectId, object: entry.data, source: 'local_user' });
-        // Await server call (may trigger AI processing that updates local state via patches)
-        try {
-            const message = await this.graphqlClient.createObject(this.id, dataWithId, this._conversationId, ephemeral);
-            // Return current state (may have been updated by AI patches)
-            return { object: this._data.objects[objectId].data, message };
-        }
-        catch (error) {
-            this.logger.error('[RoolSpace] Failed to create object:', error);
-            this.resyncFromServer(error instanceof Error ? error : new Error(String(error)));
-            throw error;
-        }
-    }
-    /**
-     * Update an existing object.
-     * @param objectId - The ID of the object to update
-     * @param options.data - Fields to add or update. Pass null or undefined to delete a field. Use {{placeholder}} for AI-generated content. Fields prefixed with _ are hidden from AI.
-     * @param options.prompt - AI prompt for content editing (optional).
-     * @param options.ephemeral - If true, the operation won't be recorded in conversation history.
-     * @returns The updated object (with AI-filled content) and message
-     */
-    async updateObject(objectId, options) {
-        const entry = this._data.objects[objectId];
-        if (!entry) {
-            throw new Error(`Object ${objectId} not found for update`);
-        }
-        const { data, ephemeral } = options;
-        // id is immutable after creation (but null/undefined means delete attempt, which we also reject)
-        if (data?.id !== undefined && data.id !== null) {
-            throw new Error('Cannot change id in updateObject. The id field is immutable after creation.');
-        }
-        if (data && ('id' in data)) {
-            throw new Error('Cannot delete id field. The id field is immutable after creation.');
-        }
-        // Normalize undefined to null (for JSON serialization) and build server data
-        let serverData;
-        if (data) {
-            serverData = {};
-            for (const [key, value] of Object.entries(data)) {
-                // Convert undefined to null for wire protocol
-                serverData[key] = value === undefined ? null : value;
-            }
-        }
-        // Build local updates (apply deletions and updates)
-        if (data) {
-            for (const [key, value] of Object.entries(data)) {
-                if (value === null || value === undefined) {
-                    delete entry.data[key];
-                }
-                else {
-                    entry.data[key] = value;
-                }
-            }
-        }
-        // Emit semantic event with updated object
-        if (data) {
-            this.emit('objectUpdated', { objectId, object: entry.data, source: 'local_user' });
-        }
-        // Await server call (may trigger AI processing that updates local state via patches)
-        try {
-            const message = await this.graphqlClient.updateObject(this.id, objectId, this._conversationId, serverData, options.prompt, ephemeral);
-            // Return current state (may have been updated by AI patches)
-            return { object: this._data.objects[objectId].data, message };
-        }
-        catch (error) {
-            this.logger.error('[RoolSpace] Failed to update object:', error);
-            this.resyncFromServer(error instanceof Error ? error : new Error(String(error)));
-            throw error;
-        }
-    }
-    /**
-     * Delete objects by IDs.
-     * Other objects that reference deleted objects via data fields will retain stale ref values.
-     */
-    async deleteObjects(objectIds) {
-        if (objectIds.length === 0)
-            return;
-        const deletedObjectIds = [];
-        // Remove objects (local state)
-        for (const objectId of objectIds) {
-            if (this._data.objects[objectId]) {
-                delete this._data.objects[objectId];
-                deletedObjectIds.push(objectId);
-            }
-        }
-        // Emit semantic events
-        for (const objectId of deletedObjectIds) {
-            this.emit('objectDeleted', { objectId, source: 'local_user' });
-        }
-        // Await server call
-        try {
-            await this.graphqlClient.deleteObjects(this.id, objectIds, this._conversationId);
-        }
-        catch (error) {
-            this.logger.error('[RoolSpace] Failed to delete objects:', error);
-            this.resyncFromServer(error instanceof Error ? error : new Error(String(error)));
-            throw error;
-        }
-    }
-    // ===========================================================================
-    // Conversation Management
-    // ===========================================================================
-    /**
-     * Delete a conversation and its interaction history.
-     * Defaults to the current conversation if no conversationId is provided.
-     */
-    async deleteConversation(conversationId) {
-        const targetConversationId = conversationId ?? this._conversationId;
-        // Optimistic local update
-        if (this._data.conversations?.[targetConversationId]) {
-            delete this._data.conversations[targetConversationId];
-        }
-        // Emit events
-        this.emit('conversationUpdated', {
-            conversationId: targetConversationId,
-            source: 'local_user',
-        });
-        this.emit('conversationsChanged', {
-            action: 'deleted',
-            conversationId: targetConversationId,
-            source: 'local_user',
-        });
-        // Call server
-        try {
-            await this.graphqlClient.deleteConversation(this.id, targetConversationId);
-        }
-        catch (error) {
-            this.logger.error('[RoolSpace] Failed to delete conversation:', error);
-            this.resyncFromServer(error instanceof Error ? error : new Error(String(error)));
-            throw error;
-        }
-    }
-    /**
-     * Rename a conversation.
-     * If the conversation doesn't exist, it will be created with the given name.
-     */
-    async renameConversation(conversationId, name) {
-        // Optimistic local update - auto-create if needed
-        if (!this._data.conversations) {
-            this._data.conversations = {};
-        }
-        const isNew = !this._data.conversations[conversationId];
-        if (isNew) {
-            this._data.conversations[conversationId] = {
-                name,
-                createdAt: Date.now(),
-                createdBy: this._userId,
-                interactions: [],
-            };
-        }
-        else {
-            this._data.conversations[conversationId].name = name;
-        }
-        // Emit events
-        this.emit('conversationUpdated', {
-            conversationId,
-            source: 'local_user',
-        });
-        this.emit('conversationsChanged', {
-            action: isNew ? 'created' : 'renamed',
-            conversationId,
-            name,
-            source: 'local_user',
-        });
-        // Call server
-        try {
-            await this.graphqlClient.renameConversation(this.id, conversationId, name);
-        }
-        catch (error) {
-            this.logger.error('[RoolSpace] Failed to rename conversation:', error);
-            this.resyncFromServer(error instanceof Error ? error : new Error(String(error)));
-            throw error;
-        }
-    }
-    /**
-     * List all conversations in this space with summary info.
-     */
-    async listConversations() {
-        return this.graphqlClient.listConversations(this.id);
-    }
-    /**
-     * Get the system instruction for the current conversation.
-     * Returns undefined if no system instruction is set.
-     */
-    getSystemInstruction() {
-        return this._data.conversations?.[this._conversationId]?.systemInstruction;
-    }
-    /**
-     * Set the system instruction for the current conversation.
-     * Pass null to clear the instruction.
-     */
-    async setSystemInstruction(instruction) {
-        // Optimistic local update
-        if (!this._data.conversations) {
-            this._data.conversations = {};
-        }
-        if (!this._data.conversations[this._conversationId]) {
-            this._data.conversations[this._conversationId] = {
-                createdAt: Date.now(),
-                createdBy: this._userId,
-                interactions: [],
-            };
-        }
-        if (instruction === null) {
-            delete this._data.conversations[this._conversationId].systemInstruction;
-        }
-        else {
-            this._data.conversations[this._conversationId].systemInstruction = instruction;
-        }
-        // Emit event
-        this.emit('conversationUpdated', {
-            conversationId: this._conversationId,
-            source: 'local_user',
-        });
-        // Call server
-        try {
-            await this.graphqlClient.setSystemInstruction(this.id, this._conversationId, instruction);
-        }
-        catch (error) {
-            this.logger.error('[RoolSpace] Failed to set system instruction:', error);
-            this.resyncFromServer(error instanceof Error ? error : new Error(String(error)));
-            throw error;
-        }
-    }
-    // ===========================================================================
-    // Metadata Operations
-    // ===========================================================================
-    /**
-     * Set a space-level metadata value.
-     * Metadata is stored in meta and hidden from AI operations.
-     */
-    setMetadata(key, value) {
-        if (!this._data.meta) {
-            this._data.meta = {};
-        }
-        this._data.meta[key] = value;
-        this.emit('metadataUpdated', { metadata: this._data.meta, source: 'local_user' });
-        // Fire-and-forget server call - errors trigger resync
-        this.graphqlClient.setSpaceMeta(this.id, this._data.meta, this._conversationId)
-            .catch((error) => {
-            this.logger.error('[RoolSpace] Failed to set meta:', error);
-            this.resyncFromServer(error instanceof Error ? error : new Error(String(error)));
-        });
-    }
-    /**
-     * Get a space-level metadata value.
-     */
-    getMetadata(key) {
-        return this._data.meta?.[key];
-    }
-    /**
-     * Get all space-level metadata.
-     */
-    getAllMetadata() {
-        return this._data.meta ?? {};
-    }
-    // ===========================================================================
-    // AI Operations
-    // ===========================================================================
-    /**
-     * Send a prompt to the AI agent for space manipulation.
-     * @returns The message from the AI and the list of objects that were created or modified
-     */
-    async prompt(prompt, options) {
-        // Upload attachments via media endpoint, then send URLs to the server
-        const { attachments, ...rest } = options ?? {};
-        let attachmentUrls;
-        if (attachments?.length) {
-            attachmentUrls = await Promise.all(attachments.map(file => this.mediaClient.upload(this._id, file)));
-        }
-        const result = await this.graphqlClient.prompt(this._id, prompt, this._conversationId, { ...rest, attachmentUrls });
-        // Hydrate modified object IDs to actual objects (filter out deleted ones)
-        const objects = result.modifiedObjectIds
-            .map(id => this._data.objects[id]?.data)
-            .filter((obj) => obj !== undefined);
-        return {
-            message: result.message,
-            objects,
-        };
-    }
-    // ===========================================================================
-    // Collaboration
+    // User Management
     // ===========================================================================
     /**
      * List users with access to this space.
@@ -632,7 +86,6 @@ export class RoolSpace extends EventEmitter {
     /**
      * Set the link sharing level for this space.
      * Requires owner or admin role.
-     * @param linkAccess - 'none' (no link access), 'viewer' (read-only), or 'editor' (full edit)
      */
     async setLinkAccess(linkAccess) {
         const previous = this._linkAccess;
@@ -646,248 +99,45 @@ export class RoolSpace extends EventEmitter {
         }
     }
     // ===========================================================================
-    // Media Operations
+    // Channel Management
     // ===========================================================================
     /**
-     * List all media files for this space.
-     */
-    async listMedia() {
-        return this.mediaClient.list(this._id);
-    }
-    /**
-     * Upload a file to this space. Returns the URL.
-     */
-    async uploadMedia(file) {
-        return this.mediaClient.upload(this._id, file);
-    }
-    /**
-     * Fetch any URL, returning headers and a blob() method (like fetch Response).
-     * Adds auth headers for backend media URLs, fetches external URLs via server proxy if CORS blocks.
-     */
-    async fetchMedia(url) {
-        return this.mediaClient.fetch(this._id, url);
-    }
-    /**
-     * Delete a media file by URL.
+     * List channels in this space.
+     * Returns from cached snapshot (populated at open time).
+     * Call refresh() to update from server.
      */
-    async deleteMedia(url) {
-        return this.mediaClient.delete(this._id, url);
+    getChannels() {
+        return this._channels;
     }
-    // ===========================================================================
-    // Low-level Operations
-    // ===========================================================================
     /**
-     * Get the full space data.
-     * Use sparingly - prefer specific operations.
+     * Delete a channel from this space.
      */
-    getData() {
-        return this._data;
+    async deleteChannel(channelId) {
+        await this.graphqlClient.deleteChannel(this._id, channelId);
+        this._channels = this._channels.filter(c => c.id !== channelId);
     }
     // ===========================================================================
-    // Import/Export
+    // Export
     // ===========================================================================
     /**
      * Export space data and media as a zip archive.
-     * The archive contains a data.json file with objects, relations, metadata,
-     * and conversations, plus a media/ folder with all media files.
-     * @returns A Blob containing the zip archive
      */
     async exportArchive() {
         return this.mediaClient.exportArchive(this._id);
     }
     // ===========================================================================
-    // Event Handlers (internal - handles space subscription events)
+    // Refresh
     // ===========================================================================
     /**
-     * Handle a space event from the subscription.
-     * @internal
-     */
-    handleSpaceEvent(event) {
-        // Ignore events after close - the space is being torn down
-        if (this._closed)
-            return;
-        switch (event.type) {
-            case 'space_patched':
-                if (event.patch) {
-                    this.handleRemotePatch(event.patch, event.source);
-                }
-                break;
-            case 'space_changed':
-                // Full reload needed
-                void this.graphqlClient.getSpace(this._id).then(({ data }) => {
-                    this._data = data;
-                    this.emit('reset', { source: 'remote_user' });
-                });
-                break;
-        }
-    }
-    /**
-     * Check if a patch would actually change the current data.
-     * Used to deduplicate events when patches don't change anything (e.g., optimistic updates).
-     * @internal
-     */
-    didPatchChangeAnything(patch) {
-        for (const op of patch) {
-            const pathParts = op.path.split('/').filter(p => p);
-            let current = this._data;
-            for (const part of pathParts) {
-                current = current?.[part];
-            }
-            if (op.op === 'remove' && current !== undefined)
-                return true;
-            if ((op.op === 'add' || op.op === 'replace') &&
-                JSON.stringify(current) !== JSON.stringify(op.value))
-                return true;
-        }
-        return false;
-    }
-    /**
-     * Handle a patch event from another client.
-     * Checks for version gaps to detect missed patches.
-     * @internal
-     */
-    handleRemotePatch(patch, source) {
-        // Extract the new version from the patch
-        const versionOp = patch.find(op => op.path === '/version' && (op.op === 'add' || op.op === 'replace'));
-        if (versionOp) {
-            const incomingVersion = versionOp.value;
-            const currentVersion = this._data.version ?? 0;
-            const expectedVersion = currentVersion + 1;
-            // Check for version gap (missed patches)
-            if (incomingVersion > expectedVersion) {
-                this.logger.warn(`[RoolSpace] Version gap detected: expected ${expectedVersion}, got ${incomingVersion}. Resyncing.`);
-                this.resyncFromServer(new Error(`Version gap: expected ${expectedVersion}, got ${incomingVersion}`))
-                    .catch(() => { });
-                return;
-            }
-            // Skip stale patches (version <= current, already applied)
-            if (incomingVersion <= currentVersion) {
-                return;
-            }
-        }
-        // Check if patch would change anything BEFORE applying
-        const willChange = this.didPatchChangeAnything(patch);
-        try {
-            this._data = immutableJSONPatch(this._data, patch);
-        }
-        catch (error) {
-            this.logger.error('[RoolSpace] Failed to apply remote patch:', error);
-            // Force resync on patch error
-            this.resyncFromServer(error instanceof Error ? error : new Error(String(error))).catch(() => { });
-            return;
-        }
-        // Only emit events if something actually changed
-        if (willChange) {
-            const changeSource = source === 'agent' ? 'remote_agent' : 'remote_user';
-            this.emitSemanticEventsFromPatch(patch, changeSource);
-        }
-    }
-    /**
-     * Parse JSON patch operations and emit semantic events.
-     * @internal
+     * Refresh space data from the server.
+     * Updates name, role, linkAccess, and channel list.
      */
-    emitSemanticEventsFromPatch(patch, source) {
-        // Track which objects have been updated (to avoid duplicate events)
-        const updatedObjects = new Set();
-        for (const op of patch) {
-            const { path } = op;
-            // Object operations: /objects/{objectId}/...
-            if (path.startsWith('/objects/')) {
-                const parts = path.split('/');
-                const objectId = parts[2];
-                if (parts.length === 3) {
-                    // /objects/{objectId} - full object add or remove
-                    if (op.op === 'add') {
-                        const entry = this._data.objects[objectId];
-                        if (entry) {
-                            this.emit('objectCreated', { objectId, object: entry.data, source });
-                        }
-                    }
-                    else if (op.op === 'remove') {
-                        this.emit('objectDeleted', { objectId, source });
-                    }
-                }
-                else if (parts[3] === 'data') {
-                    // /objects/{objectId}/data/... - data field update
-                    if (!updatedObjects.has(objectId)) {
-                        const entry = this._data.objects[objectId];
-                        if (entry) {
-                            this.emit('objectUpdated', { objectId, object: entry.data, source });
-                            updatedObjects.add(objectId);
-                        }
-                    }
-                }
-            }
-            else if (path === '/meta' || path.startsWith('/meta/')) {
-                this.emit('metadataUpdated', { metadata: this._data.meta, source });
-            }
-            // Conversation operations: /conversations/{conversationId} or /conversations/{conversationId}/...
-            else if (path.startsWith('/conversations/')) {
-                const parts = path.split('/');
-                const conversationId = parts[2];
-                if (conversationId) {
-                    this.emit('conversationUpdated', { conversationId, source });
-                    // Emit conversationsChanged for list-level changes
-                    if (parts.length === 3) {
-                        // /conversations/{conversationId} - full conversation add or remove
-                        if (op.op === 'add') {
-                            const conv = this._data.conversations?.[conversationId];
-                            this.emit('conversationsChanged', {
-                                action: 'created',
-                                conversationId,
-                                name: conv?.name,
-                                source,
-                            });
-                        }
-                        else if (op.op === 'remove') {
-                            this.emit('conversationsChanged', {
-                                action: 'deleted',
-                                conversationId,
-                                source,
-                            });
-                        }
-                    }
-                    else if (parts[3] === 'name') {
-                        // /conversations/{conversationId}/name - rename
-                        const conv = this._data.conversations?.[conversationId];
-                        this.emit('conversationsChanged', {
-                            action: 'renamed',
-                            conversationId,
-                            name: conv?.name,
-                            source,
-                        });
-                    }
-                }
-            }
-        }
-    }
-    // ===========================================================================
-    // Private Methods
-    // ===========================================================================
-    async resyncFromServer(originalError) {
-        this.logger.warn('[RoolSpace] Resyncing from server after sync failure');
-        try {
-            const { data } = await this.graphqlClient.getSpace(this._id);
-            // Check again after await - space might have been closed during fetch
-            if (this._closed)
-                return;
-            this._data = data;
-            // Clear history is now async but we don't need to wait for it during resync
-            // (it's a server-side cleanup that can happen in background)
-            this.clearHistory().catch((err) => {
-                this.logger.warn('[RoolSpace] Failed to clear history during resync:', err);
-            });
-            this.emit('syncError', originalError ?? new Error('Sync failed'));
-            this.emit('reset', { source: 'system' });
-        }
-        catch (error) {
-            // If space was closed during fetch, don't log error - expected during teardown
-            if (this._closed)
-                return;
-            this.logger.error('[RoolSpace] Failed to resync from server:', error);
-            // Still emit syncError with the original error
-            this.emit('syncError', originalError ?? new Error('Sync failed'));
-        }
+    async refresh() {
+        const { name, role, linkAccess, channels } = await this.graphqlClient.openSpace(this._id);
+        this._name = name;
+        this._role = role;
+        this._linkAccess = linkAccess;
+        this._channels = channels;
     }
 }
 //# sourceMappingURL=space.js.map