@rool-dev/sdk 0.8.2-dev.02b70e5 → 0.8.2-dev.d82ea25

package/dist/channel.js

@@ -1,10 +1,13 @@
 import { EventEmitter } from './event-emitter.js';
-// 6-character alphanumeric ID (62^6 = 56.8 billion possible values)
-const ID_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+import { WebDAVError } from './webdav.js';
+import { isObjectPath, machinePath, machineUri } from './path.js';
+// 6-character alphanumeric ID — used for object names, interactionIds, conversationIds, etc.
+const ENTITY_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+const GET_OBJECTS_CHUNK_SIZE = 500;
 export function generateEntityId() {
     let result = '';
     for (let i = 0; i < 6; i++) {
-        result += ID_CHARS[Math.floor(Math.random() * ID_CHARS.length)];
+        result += ENTITY_CHARS[Math.floor(Math.random() * ENTITY_CHARS.length)];
     }
     return result;
 }
@@ -40,8 +43,118 @@ function findDefaultLeaf(interactions) {
     }
     return best?.id;
 }
-// Default timeout for waiting on SSE object events (30 seconds)
-const OBJECT_COLLECT_TIMEOUT = 30000;
+function objectPath(input) {
+    const path = machinePath(input);
+    if (!isObjectPath(path)) {
+        throw new Error(`Object path must be /space/<collection>/<name>.json without dotfiles: ${input}`);
+    }
+    return path;
+}
+function collectionPath(name) {
+    return machinePath(`/space/${name}`);
+}
+function schemaPath(name) {
+    return `${collectionPath(name)}/.schema.json`;
+}
+function objectFromBody(path, body) {
+    return { path, body };
+}
+function jsonObject(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be a JSON object`);
+    }
+    return value;
+}
+function patchBody(current, patch) {
+    const next = { ...current };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null || value === undefined)
+            delete next[key];
+        else
+            next[key] = value;
+    }
+    return next;
+}
+function collectionDef(input, options) {
+    const base = Array.isArray(input)
+        ? { fields: input }
+        : { fields: input.fields, schemaOrgType: input.schemaOrgType };
+    const schemaOrgType = options?.schemaOrgType ?? base.schemaOrgType;
+    return schemaOrgType ? { fields: base.fields, schemaOrgType } : { fields: base.fields };
+}
+function attachmentBody(file) {
+    if (isFile(file)) {
+        return {
+            filename: safeAttachmentFilename(file.name, file.type),
+            contentType: file.type || 'application/octet-stream',
+            body: file,
+        };
+    }
+    if (isBlob(file)) {
+        const contentType = file.type || 'application/octet-stream';
+        return {
+            filename: safeAttachmentFilename('attachment', contentType),
+            contentType,
+            body: file,
+        };
+    }
+    return {
+        filename: safeAttachmentFilename(file.filename ?? 'attachment', file.contentType),
+        contentType: file.contentType,
+        body: base64Body(file.data),
+    };
+}
+function isFile(value) {
+    return typeof File !== 'undefined' && value instanceof File;
+}
+function isBlob(value) {
+    return typeof Blob !== 'undefined' && value instanceof Blob;
+}
+function safeAttachmentFilename(name, contentType) {
+    const fallback = `attachment.${extensionForContentType(contentType)}`;
+    const leaf = name.split(/[/\\]/).pop() || fallback;
+    const cleaned = leaf.replace(/[\x00-\x1f\x7f]/g, '').replace(/\s+/g, '_');
+    return cleaned.replace(/[^A-Za-z0-9._-]/g, '_').replace(/^\.+$/, '') || fallback;
+}
+function extensionForContentType(contentType) {
+    if (contentType === 'image/png')
+        return 'png';
+    if (contentType === 'image/jpeg')
+        return 'jpg';
+    if (contentType === 'image/gif')
+        return 'gif';
+    if (contentType === 'image/webp')
+        return 'webp';
+    if (contentType === 'image/svg+xml')
+        return 'svg';
+    if (contentType === 'application/pdf')
+        return 'pdf';
+    if (contentType === 'text/markdown')
+        return 'md';
+    if (contentType === 'text/plain')
+        return 'txt';
+    if (contentType === 'text/csv')
+        return 'csv';
+    if (contentType === 'text/html')
+        return 'html';
+    if (contentType === 'application/json')
+        return 'json';
+    if (contentType === 'application/xml')
+        return 'xml';
+    return 'bin';
+}
+function base64Body(data) {
+    const clean = data.includes(',') ? data.slice(data.indexOf(',') + 1) : data;
+    if (typeof Buffer !== 'undefined') {
+        const buffer = Buffer.from(clean, 'base64');
+        return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    }
+    const binary = atob(clean);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes.buffer;
+}
 /**
  * A channel is a space + channelId pair.
  *
@@ -49,16 +162,10 @@ const OBJECT_COLLECT_TIMEOUT = 30000;
  * at open time and cannot be changed. To use a different channel,
  * open a second one.
  *
- * Objects are fetched on demand from the server; only schema, metadata,
- * and the channel's own history are cached locally. Object changes
- * arrive via SSE semantic events and are emitted as SDK events.
- *
- * 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
+ * Objects are addressed by machine path (`/space/.../*.json`).
+ * Only schema, metadata, object stats, and the channel's own history are cached
+ * locally. Object bodies are fetched on demand. Object/file reactivity is
+ * exposed at the space level via WebDAV sync notifications.
  */
 export class RoolChannel extends EventEmitter {
     _id;
@@ -70,24 +177,17 @@ export class RoolChannel extends EventEmitter {
     _conversationId;
     _closed = false;
     graphqlClient;
-    mediaClient;
+    restClient;
+    webdav;
     onCloseCallback;
     logger;
-    // Local cache for bounded data (schema, metadata, own channel, object IDs, stats)
+    // Local cache for bounded data (schema, metadata, own channel, object stats)
     _meta;
     _schema;
     _channel;
-    _objectIds;
     _objectStats;
     // Active leaf per conversation (client-side tree cursor)
     _activeLeaves = new Map();
-    // Object collection: tracks pending local mutations for dedup
-    // Maps objectId → optimistic object data (for create/update) or null (for delete)
-    _pendingMutations = new Map();
-    // Resolvers waiting for object data from SSE events
-    _objectResolvers = new Map();
-    // Buffer for object data that arrived before a collector was registered
-    _objectBuffer = new Map();
     constructor(config) {
         super();
         this._id = config.id;
@@ -99,14 +199,14 @@ export class RoolChannel extends EventEmitter {
         this._channelId = config.channelId;
         this._conversationId = 'default';
         this.graphqlClient = config.graphqlClient;
-        this.mediaClient = config.mediaClient;
+        this.restClient = config.restClient;
+        this.webdav = config.webdav;
         this.logger = config.logger;
         this.onCloseCallback = config.onClose;
         // Initialize local cache from server data
         this._meta = config.meta;
         this._schema = config.schema;
-        this._channel = config.channel;
-        this._objectIds = config.objectIds;
+        this._channel = config.channel ?? undefined;
         this._objectStats = new Map(Object.entries(config.objectStats));
     }
     /**
@@ -127,16 +227,12 @@ export class RoolChannel extends EventEmitter {
             return;
         this._meta = data.meta;
         this._schema = data.schema;
-        this._objectIds = data.objectIds;
         this._objectStats = new Map(Object.entries(data.objectStats));
         if (data.channel)
             this._channel = data.channel;
         this._activeLeaves.clear();
         this.emit('reset', { source: 'system' });
     }
-    // ===========================================================================
-    // Properties
-    // ===========================================================================
     get id() {
         return this._id;
     }
@@ -176,27 +272,6 @@ export class RoolChannel extends EventEmitter {
     get isReadOnly() {
         return this._role === 'viewer';
     }
-    /**
-     * Get the extension URL if this channel was created via installExtension, or null.
-     */
-    get extensionUrl() {
-        return this._channel?.extensionUrl ?? null;
-    }
-    /**
-     * Get the extension ID if this channel has an installed extension, or null.
-     */
-    get extensionId() {
-        return this._channel?.extensionId ?? null;
-    }
-    /**
-     * Get the extension manifest if this channel has an installed extension, or null.
-     */
-    get manifest() {
-        return this._channel?.manifest ?? null;
-    }
-    // ===========================================================================
-    // Channel History Access
-    // ===========================================================================
     /**
      * Get the active branch of the current conversation as a flat array (root → leaf).
      * Walks from the active leaf up through parentId pointers.
@@ -298,22 +373,12 @@ export class RoolChannel extends EventEmitter {
             });
         }
     }
-    // ===========================================================================
-    // Conversations
-    // ===========================================================================
     /**
      * Get a handle for a specific conversation within this channel.
-     * The handle scopes AI and mutation operations to that conversation's
-     * interaction history, while sharing the channel's single SSE connection.
-     *
-     * Conversations are auto-created on first interaction — no explicit create needed.
      */
     conversation(conversationId) {
         return new ConversationHandle(this, conversationId);
     }
-    // ===========================================================================
-    // Channel Lifecycle
-    // ===========================================================================
     /**
      * Close this channel and clean up resources.
      * Stops real-time subscription and unregisters from client.
@@ -321,267 +386,225 @@ export class RoolChannel extends EventEmitter {
     close() {
         this._closed = true;
         this.onCloseCallback();
-        // Clean up pending object collectors
-        this._objectResolvers.clear();
-        this._objectBuffer.clear();
-        this._pendingMutations.clear();
         this.removeAllListeners();
     }
-    // ===========================================================================
-    // Undo / Redo (Server-managed checkpoints)
-    // ===========================================================================
     /**
      * Create a checkpoint of the current space state.
-     * Checkpoints are space-wide and shared across channels and users.
-     * @returns The checkpoint ID
      */
     async checkpoint(label = 'Change') {
         const result = await this.graphqlClient.checkpoint(this._id, label, this._channelId);
         return result.checkpointId;
     }
-    /**
-     * Check if undo is available for this space.
-     */
+    /** Check if undo is available for this space. */
     async canUndo() {
         const status = await this.graphqlClient.checkpointStatus(this._id, this._channelId);
         return status.canUndo;
     }
-    /**
-     * Check if redo is available for this space.
-     */
+    /** Check if redo is available for this space. */
     async canRedo() {
         const status = await this.graphqlClient.checkpointStatus(this._id, this._channelId);
         return status.canRedo;
     }
-    /**
-     * Restore the space to the most recent checkpoint.
-     * @returns true if undo was performed
-     */
+    /** Restore the space to the most recent checkpoint. */
     async undo() {
         const result = await this.graphqlClient.undo(this._id, this._channelId);
         return result.success;
     }
-    /**
-     * Reapply the most recently undone checkpoint.
-     * Affects the entire space.
-     * @returns true if redo was performed
-     */
+    /** Reapply the most recently undone checkpoint. */
     async redo() {
         const result = await this.graphqlClient.redo(this._id, this._channelId);
         return result.success;
     }
-    /**
-     * Clear the space's checkpoint history.
-     */
+    /** Clear the space's checkpoint history. */
     async clearHistory() {
         await this.graphqlClient.clearCheckpointHistory(this._id, this._channelId);
     }
-    // ===========================================================================
-    // Object Operations
-    // ===========================================================================
-    /**
-     * Get an object's data by ID.
-     * Fetches from the server on each call.
-     */
-    async getObject(objectId) {
-        return this.graphqlClient.getObject(this._id, objectId);
-    }
-    /**
-     * Get an object's stat (audit information).
-     * Returns modification timestamp and author, or undefined if object not found.
-     */
-    stat(objectId) {
-        return this._objectStats.get(objectId);
-    }
-    /**
-     * 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 interaction history.
-     * @returns The matching objects and a descriptive message.
-     */
-    async findObjects(options) {
-        return this._findObjectsImpl(options, this._conversationId);
+    davHeaders(conversationId, interactionId) {
+        const headers = new Headers({
+            'X-Rool-Channel-Id': this._channelId,
+            'X-Rool-Conversation-Id': conversationId,
+        });
+        if (interactionId)
+            headers.set('X-Rool-Interaction-Id', interactionId);
+        return headers;
     }
-    /** @internal */
-    _findObjectsImpl(options, conversationId) {
-        return this.graphqlClient.findObjects(this._id, options, this._channelId, conversationId);
+    async readObject(path) {
+        const canonical = objectPath(path);
+        try {
+            const response = await this.webdav.get(canonical);
+            const body = jsonObject(await response.json(), `Object ${canonical}`);
+            return { object: objectFromBody(canonical, body), etag: response.headers.get('ETag') };
+        }
+        catch (error) {
+            if (error instanceof WebDAVError && error.status === 404)
+                return undefined;
+            if (error instanceof SyntaxError)
+                throw new Error(`Object ${canonical} did not contain valid JSON`);
+            throw error;
+        }
     }
-    /**
-     * Get all object IDs (sync, from local cache).
-     * The list is loaded on open and kept current via SSE events.
-     * @param options.limit - Maximum number of IDs to return
-     * @param options.order - Sort order by modifiedAt ('asc' or 'desc', default: 'desc')
-     */
-    getObjectIds(options) {
-        let ids = this._objectIds;
-        if (options?.order === 'asc') {
-            ids = [...ids].reverse();
+    /** Get an object JSON file by machine path. Fetches from the server on each call. */
+    async getObject(path) {
+        return (await this.readObject(path))?.object;
+    }
+    /** Get object JSON files by machine path in bulk. Duplicate paths are fetched once. */
+    async getObjects(paths) {
+        const canonical = [];
+        const seen = new Set();
+        for (const path of paths) {
+            const normalized = objectPath(path);
+            if (seen.has(normalized))
+                continue;
+            seen.add(normalized);
+            canonical.push(normalized);
         }
-        if (options?.limit !== undefined) {
-            ids = ids.slice(0, options.limit);
+        const result = { objects: [], missing: [] };
+        for (let i = 0; i < canonical.length; i += GET_OBJECTS_CHUNK_SIZE) {
+            const chunk = canonical.slice(i, i + GET_OBJECTS_CHUNK_SIZE);
+            const partial = await this.restClient.getObjects(this._id, chunk);
+            result.objects.push(...partial.objects);
+            result.missing.push(...partial.missing);
         }
-        return ids;
+        return result;
     }
-    /**
-     * 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 interaction history.
-     * @returns The created object (with AI-filled content) and message
-     */
-    async createObject(options) {
-        return this._createObjectImpl(options, this._conversationId);
+    /** Get an object's cached audit information. */
+    stat(path) {
+        return this._objectStats.get(objectPath(path));
+    }
+    /** Create or replace an object JSON file at an exact machine path. */
+    async putObject(path, body) {
+        return this._putObjectImpl(path, body, this._conversationId);
     }
     /** @internal */
-    async _createObjectImpl(options, conversationId) {
-        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.`);
-        }
-        const dataWithId = { ...data, id: objectId };
-        // Emit optimistic event and track for dedup
-        this._pendingMutations.set(objectId, dataWithId);
-        this.emit('objectCreated', { objectId, object: dataWithId, source: 'local_user' });
+    async _putObjectImpl(path, body, conversationId) {
+        const canonical = objectPath(path);
+        const optimistic = objectFromBody(canonical, body);
         try {
-            // Await mutation — server processes AI placeholders before responding.
-            // SSE events arrive during the await and are buffered via _deliverObject.
             const interactionId = generateEntityId();
-            const { message } = await this.graphqlClient.createObject(this.id, dataWithId, this._channelId, conversationId, interactionId, ephemeral);
-            // Collect resolved object from buffer (or wait if not yet arrived)
-            const object = await this._collectObject(objectId);
-            return { object, message };
+            await this.webdav.put(canonical, JSON.stringify(body), {
+                contentType: 'application/json',
+                headers: this.davHeaders(conversationId, interactionId),
+            });
+            const fresh = await this.getObject(canonical) ?? optimistic;
+            return { object: fresh, message: `Put ${canonical}` };
         }
         catch (error) {
-            this.logger.error('[RoolChannel] Failed to create object:', error);
-            this._pendingMutations.delete(objectId);
-            this._cancelCollector(objectId);
-            // Emit reset so UI can recover from the optimistic event
+            this.logger.error('[RoolChannel] Failed to put object:', error);
             this.emit('syncError', error instanceof Error ? error : new Error(String(error)));
-            this.emit('reset', { source: 'system' });
             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 interaction history.
-     * @returns The updated object (with AI-filled content) and message
-     */
-    async updateObject(objectId, options) {
-        return this._updateObjectImpl(objectId, options, this._conversationId);
+    /** Patch an existing object. Null or undefined deletes a field. */
+    async patchObject(path, options) {
+        return this._patchObjectImpl(path, options, this._conversationId);
     }
     /** @internal */
-    async _updateObjectImpl(objectId, options, conversationId) {
-        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;
-            }
+    async _patchObjectImpl(path, options, conversationId) {
+        const canonical = objectPath(path);
+        const data = options.data ?? {};
+        const current = await this.readObject(canonical);
+        if (!current)
+            throw new Error(`Object ${canonical} not found`);
+        const body = patchBody(current.object.body, data);
+        const optimistic = objectFromBody(canonical, body);
+        try {
+            const interactionId = generateEntityId();
+            await this.webdav.put(canonical, JSON.stringify(body), {
+                contentType: 'application/json',
+                ifMatch: current.etag ?? undefined,
+                headers: this.davHeaders(conversationId, interactionId),
+            });
+            const fresh = await this.getObject(canonical) ?? optimistic;
+            return { object: fresh, message: `Patched ${canonical}` };
         }
-        // Emit optimistic event if we have data changes
-        if (data) {
-            // Build optimistic object (best effort — we may not have the current state)
-            const optimistic = { id: objectId, ...data };
-            this._pendingMutations.set(objectId, optimistic);
-            this.emit('objectUpdated', { objectId, object: optimistic, source: 'local_user' });
+        catch (error) {
+            this.logger.error('[RoolChannel] Failed to patch object:', error);
+            this.emit('syncError', error instanceof Error ? error : new Error(String(error)));
+            throw error;
         }
+    }
+    /** Move an object JSON file to a new machine path, optionally replacing its body. */
+    async moveObject(from, to, options) {
+        return this._moveObjectImpl(from, to, options, this._conversationId);
+    }
+    /** @internal */
+    async _moveObjectImpl(from, to, options, conversationId) {
+        const fromPath = objectPath(from);
+        const toPath = objectPath(to);
+        const optimistic = objectFromBody(toPath, options?.body ?? {});
         try {
             const interactionId = generateEntityId();
-            const { message } = await this.graphqlClient.updateObject(this.id, objectId, this._channelId, conversationId, interactionId, serverData, options.prompt, ephemeral);
-            const object = await this._collectObject(objectId);
-            return { object, message };
+            await this.webdav.move(fromPath, toPath, {
+                headers: this.davHeaders(conversationId, interactionId),
+            });
+            if (options?.body) {
+                await this.webdav.put(toPath, JSON.stringify(options.body), {
+                    contentType: 'application/json',
+                    headers: this.davHeaders(conversationId, interactionId),
+                });
+            }
+            this._objectStats.delete(fromPath);
+            const fresh = await this.getObject(toPath) ?? optimistic;
+            return { object: fresh, message: `Moved ${fromPath} to ${toPath}` };
         }
         catch (error) {
-            this.logger.error('[RoolChannel] Failed to update object:', error);
-            this._pendingMutations.delete(objectId);
-            this._cancelCollector(objectId);
+            this.logger.error('[RoolChannel] Failed to move object:', error);
             this.emit('syncError', error instanceof Error ? error : new Error(String(error)));
-            this.emit('reset', { source: 'system' });
             throw error;
         }
     }
-    /**
-     * Delete objects by IDs.
-     * Other objects that reference deleted objects via data fields will retain stale ref values.
-     */
-    async deleteObjects(objectIds) {
-        return this._deleteObjectsImpl(objectIds, this._conversationId);
+    /** Delete object JSON files by machine path. */
+    async deleteObjects(paths) {
+        return this._deleteObjectsImpl(paths, this._conversationId);
+    }
+    /** @deprecated Use deleteObjects instead. */
+    async deletePaths(paths) {
+        return this.deleteObjects(paths);
     }
     /** @internal */
-    async _deleteObjectsImpl(objectIds, conversationId) {
-        if (objectIds.length === 0)
+    async _deleteObjectsImpl(paths, conversationId) {
+        if (paths.length === 0)
             return;
-        // Track for dedup and emit optimistic events
-        for (const objectId of objectIds) {
-            this._pendingMutations.set(objectId, null);
-            this.emit('objectDeleted', { objectId, source: 'local_user' });
-        }
+        const canonical = paths.map(objectPath);
         try {
-            await this.graphqlClient.deleteObjects(this.id, objectIds, this._channelId, conversationId);
+            const interactionId = generateEntityId();
+            for (const path of canonical) {
+                await this.webdav.delete(path, {
+                    headers: this.davHeaders(conversationId, interactionId),
+                });
+                this._objectStats.delete(path);
+            }
         }
         catch (error) {
-            this.logger.error('[RoolChannel] Failed to delete objects:', error);
-            for (const objectId of objectIds) {
-                this._pendingMutations.delete(objectId);
-            }
+            this.logger.error('[RoolChannel] Failed to delete paths:', error);
             this.emit('syncError', error instanceof Error ? error : new Error(String(error)));
-            this.emit('reset', { source: 'system' });
             throw error;
         }
     }
-    // ===========================================================================
-    // Collection Schema Operations
-    // ===========================================================================
-    /**
-     * Get the current schema for this space.
-     * Returns a map of collection names to their definitions.
-     */
+    /** Get the current schema for this space. */
     getSchema() {
         return this._schema;
     }
-    /**
-     * Create a new collection schema.
-     * @param name - Collection name (must start with a letter, alphanumeric/hyphens/underscores only)
-     * @param fields - Field definitions for the collection
-     * @returns The created CollectionDef
-     */
-    async createCollection(name, fields) {
-        return this._createCollectionImpl(name, fields, this._conversationId);
+    /** Create a new collection schema. */
+    async createCollection(name, fields, options) {
+        return this._createCollectionImpl(name, fields, options, this._conversationId);
     }
     /** @internal */
-    async _createCollectionImpl(name, fields, conversationId) {
+    async _createCollectionImpl(name, fields, options, conversationId) {
         if (this._schema[name]) {
             throw new Error(`Collection "${name}" already exists`);
         }
         // Optimistic local update
-        const optimisticDef = { fields: fields.map(f => ({ name: f.name, type: f.type })) };
+        const optimisticDef = collectionDef(fields, options);
         this._schema[name] = optimisticDef;
         try {
-            return await this.graphqlClient.createCollection(this._id, name, fields, this._channelId, conversationId);
+            await this.webdav.mkcol(collectionPath(name), { headers: this.davHeaders(conversationId, generateEntityId()) });
+            await this.webdav.put(schemaPath(name), JSON.stringify(optimisticDef), {
+                contentType: 'application/json',
+                headers: this.davHeaders(conversationId, generateEntityId()),
+            });
+            this.emit('schemaUpdated', { schema: this._schema, source: 'local_user' });
+            return optimisticDef;
         }
         catch (error) {
             this.logger.error('[RoolChannel] Failed to create collection:', error);
@@ -589,25 +612,25 @@ export class RoolChannel extends EventEmitter {
             throw error;
         }
     }
-    /**
-     * Alter an existing collection schema, replacing its field definitions.
-     * @param name - Name of the collection to alter
-     * @param fields - New field definitions (replaces all existing fields)
-     * @returns The updated CollectionDef
-     */
-    async alterCollection(name, fields) {
-        return this._alterCollectionImpl(name, fields, this._conversationId);
+    /** Alter an existing collection schema, replacing its field definitions. */
+    async alterCollection(name, fields, options) {
+        return this._alterCollectionImpl(name, fields, options, this._conversationId);
     }
     /** @internal */
-    async _alterCollectionImpl(name, fields, conversationId) {
+    async _alterCollectionImpl(name, fields, options, conversationId) {
         if (!this._schema[name]) {
             throw new Error(`Collection "${name}" not found`);
         }
         const previous = this._schema[name];
-        // Optimistic local update
-        this._schema[name] = { fields: fields.map(f => ({ name: f.name, type: f.type })) };
+        this._schema[name] = collectionDef(fields, options);
         try {
-            return await this.graphqlClient.alterCollection(this._id, name, fields, this._channelId, conversationId);
+            const updated = this._schema[name];
+            await this.webdav.put(schemaPath(name), JSON.stringify(updated), {
+                contentType: 'application/json',
+                headers: this.davHeaders(conversationId, generateEntityId()),
+            });
+            this.emit('schemaUpdated', { schema: this._schema, source: 'local_user' });
+            return updated;
         }
         catch (error) {
             this.logger.error('[RoolChannel] Failed to alter collection:', error);
@@ -615,10 +638,7 @@ export class RoolChannel extends EventEmitter {
             throw error;
         }
     }
-    /**
-     * Drop a collection schema.
-     * @param name - Name of the collection to drop
-     */
+    /** Drop a collection schema. */
     async dropCollection(name) {
         return this._dropCollectionImpl(name, this._conversationId);
     }
@@ -628,10 +648,10 @@ export class RoolChannel extends EventEmitter {
             throw new Error(`Collection "${name}" not found`);
         }
         const previous = this._schema[name];
-        // Optimistic local update
         delete this._schema[name];
         try {
-            await this.graphqlClient.dropCollection(this._id, name, this._channelId, conversationId);
+            await this.webdav.delete(collectionPath(name), { collection: true, headers: this.davHeaders(conversationId, generateEntityId()) });
+            this.emit('schemaUpdated', { schema: this._schema, source: 'local_user' });
         }
         catch (error) {
             this.logger.error('[RoolChannel] Failed to drop collection:', error);
@@ -639,12 +659,8 @@ export class RoolChannel extends EventEmitter {
             throw error;
         }
     }
-    // ===========================================================================
-    // System Instructions
-    // ===========================================================================
     /**
      * Get the system instruction for the current conversation.
-     * Returns undefined if no system instruction is set.
      */
     getSystemInstruction() {
         return this._getSystemInstructionImpl(this._conversationId);
@@ -653,16 +669,12 @@ export class RoolChannel extends EventEmitter {
     _getSystemInstructionImpl(conversationId) {
         return this._channel?.conversations[conversationId]?.systemInstruction;
     }
-    /**
-     * Set the system instruction for the current conversation.
-     * Pass null to clear the instruction.
-     */
+    /** Set the system instruction for the current conversation. */
     async setSystemInstruction(instruction) {
         return this._setSystemInstructionImpl(instruction, this._conversationId);
     }
     /** @internal */
     async _setSystemInstructionImpl(instruction, conversationId) {
-        // Optimistic local update
         this._ensureConversationImpl(conversationId);
         const conv = this._channel.conversations[conversationId];
         const previousInstruction = conv.systemInstruction;
@@ -672,7 +684,6 @@ export class RoolChannel extends EventEmitter {
         else {
             conv.systemInstruction = instruction;
         }
-        // Emit events for backward compat and new API
         this.emit('conversationUpdated', {
             conversationId,
             channelId: this._channelId,
@@ -684,13 +695,11 @@ export class RoolChannel extends EventEmitter {
                 source: 'local_user',
             });
         }
-        // Call server
         try {
             await this.graphqlClient.updateConversation(this._id, this._channelId, conversationId, { systemInstruction: instruction });
         }
         catch (error) {
             this.logger.error('[RoolChannel] Failed to set system instruction:', error);
-            // Rollback
             if (previousInstruction === undefined) {
                 delete conv.systemInstruction;
             }
@@ -700,15 +709,12 @@ export class RoolChannel extends EventEmitter {
             throw error;
         }
     }
-    /**
-     * Rename the current conversation.
-     */
+    /** Rename the current conversation. */
     async renameConversation(name) {
         return this._renameConversationImpl(name, this._conversationId);
     }
     /** @internal */
     async _renameConversationImpl(name, conversationId) {
-        // Optimistic local update
         this._ensureConversationImpl(conversationId);
         const conv = this._channel.conversations[conversationId];
         const previousName = conv.name;
@@ -724,21 +730,16 @@ export class RoolChannel extends EventEmitter {
                 source: 'local_user',
             });
         }
-        // Call server
         try {
             await this.graphqlClient.updateConversation(this._id, this._channelId, conversationId, { name });
         }
         catch (error) {
             this.logger.error('[RoolChannel] Failed to rename conversation:', error);
-            // Rollback
             conv.name = previousName;
             throw error;
         }
     }
-    /**
-     * Ensure a conversation exists in the local channel cache.
-     * @internal
-     */
+    /** @internal */
     _ensureConversationImpl(conversationId) {
         if (!this._channel) {
             this._channel = {
@@ -755,13 +756,7 @@ export class RoolChannel extends EventEmitter {
             };
         }
     }
-    // ===========================================================================
-    // Metadata Operations
-    // ===========================================================================
-    /**
-     * Set a space-level metadata value.
-     * Metadata is stored in meta and hidden from AI operations.
-     */
+    /** Set a space-level metadata value. */
     setMetadata(key, value) {
         this._setMetadataImpl(key, value, this._conversationId);
     }
@@ -770,212 +765,156 @@ export class RoolChannel extends EventEmitter {
         this._meta[key] = value;
         this.emit('metadataUpdated', { metadata: this._meta, source: 'local_user' });
         // Fire-and-forget server call
-        this.graphqlClient.setSpaceMeta(this.id, this._meta, this._channelId, conversationId)
+        this.graphqlClient.setSpaceMeta(this._id, this._meta, this._channelId, conversationId)
             .catch((error) => {
             this.logger.error('[RoolChannel] Failed to set meta:', error);
         });
     }
-    /**
-     * Get a space-level metadata value.
-     */
+    /** Get a space-level metadata value. */
     getMetadata(key) {
         return this._meta[key];
     }
-    /**
-     * Get all space-level metadata.
-     */
+    /** Get all space-level metadata. */
     getAllMetadata() {
         return this._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
+     * @returns The message from the AI and the list of objects that were created or modified.
      */
     async prompt(prompt, options) {
         return this._promptImpl(prompt, options, this._conversationId);
     }
     /** @internal */
     async _promptImpl(prompt, options, conversationId) {
-        // Upload attachments via media endpoint, then send URLs to the server
-        const { attachments, parentInteractionId: explicitParent, ...rest } = options ?? {};
-        let attachmentUrls;
+        const { attachments, parentInteractionId: explicitParent, signal, ...rest } = options ?? {};
+        const interactionId = generateEntityId();
+        let attachmentRefs;
         if (attachments?.length) {
-            attachmentUrls = await Promise.all(attachments.map(file => this.mediaClient.upload(this._id, file)));
+            attachmentRefs = await Promise.all(attachments.map(async (attachment) => {
+                const path = typeof attachment === 'string' ? machinePath(attachment) : await this.uploadAttachment(attachment, conversationId);
+                return machineUri(path);
+            }));
         }
         // Auto-continue from active leaf if no explicit parent provided
         const parentInteractionId = explicitParent !== undefined
             ? explicitParent
             : (this._getActiveLeafImpl(conversationId) ?? null);
-        const interactionId = generateEntityId();
         // Optimistically set active leaf before the server call.
         this._activeLeaves.set(conversationId, interactionId);
-        const result = await this.graphqlClient.prompt(this._id, prompt, this._channelId, conversationId, { ...rest, attachmentUrls, interactionId, parentInteractionId });
-        // Collect modified objects — they arrive via SSE events during/after the mutation.
-        // Try collecting from buffer first, then fetch any missing from server.
-        const objects = [];
-        const missing = [];
-        for (const id of result.modifiedObjectIds) {
-            const buffered = this._objectBuffer.get(id);
-            if (buffered) {
-                this._objectBuffer.delete(id);
-                objects.push(buffered);
+        let onAbort;
+        if (signal) {
+            if (signal.aborted) {
+                this.stopInteraction(interactionId).catch(() => { });
             }
             else {
-                missing.push(id);
+                onAbort = () => {
+                    this.stopInteraction(interactionId).catch(() => { });
+                };
+                signal.addEventListener('abort', onAbort, { once: true });
             }
         }
-        // Fetch any objects not yet received via SSE
-        if (missing.length > 0) {
-            const fetched = await Promise.all(missing.map(id => this.graphqlClient.getObject(this._id, id)));
-            for (const obj of fetched) {
-                if (obj)
-                    objects.push(obj);
-            }
+        let result;
+        try {
+            result = await this.graphqlClient.prompt(this._id, prompt, this._channelId, conversationId, {
+                ...rest,
+                attachmentRefs,
+                interactionId,
+                parentInteractionId,
+            });
+        }
+        finally {
+            if (onAbort)
+                signal.removeEventListener('abort', onAbort);
+        }
+        const objects = [];
+        const fetched = await Promise.all(result.modifiedObjectPaths.map((path) => this.getObject(path)));
+        for (const object of fetched) {
+            if (object)
+                objects.push(object);
         }
         return {
             message: result.message,
             objects,
         };
     }
-    // ===========================================================================
-    // Channel Admin
-    // ===========================================================================
     /**
-     * Rename this channel.
+     * Stop the in-flight interaction on the default conversation, if any.
+     *
+     * No-op returning `false` when the active leaf is already finished or the
+     * conversation has no interactions. Stopping is best-effort: the server
+     * halts the agent loop and closes the stream, but an LLM turn already in
+     * flight keeps generating server-side and is billed.
      */
+    async stop() {
+        return this._stopImpl(this._conversationId);
+    }
+    /**
+     * Request that the server stop a specific in-flight interaction by ID.
+     *
+     * Returns whether the server stopped an interaction (`false` if it had
+     * already finished). Stopping is best-effort — see {@link stop}.
+     */
+    async stopInteraction(interactionId) {
+        return this.graphqlClient.stopInteraction(this._id, interactionId);
+    }
+    /** @internal */
+    async _stopImpl(conversationId) {
+        const leafId = this._getActiveLeafImpl(conversationId);
+        if (!leafId)
+            return false;
+        const interactions = this._channel?.conversations[conversationId]?.interactions;
+        const interaction = interactions && !Array.isArray(interactions) ? interactions[leafId] : undefined;
+        // Skip the round trip when we already know the interaction has settled.
+        if (interaction && (interaction.status === 'done' || interaction.status === 'error')) {
+            return false;
+        }
+        return this.stopInteraction(leafId);
+    }
+    /** Rename this channel. */
     async rename(newName) {
-        // Optimistic local update
         const previousName = this._channel?.name;
         if (this._channel) {
             this._channel.name = newName;
         }
         this.emit('channelUpdated', { channelId: this._channelId, source: 'local_user' });
-        // Call server
         try {
             await this.graphqlClient.renameChannel(this._id, this._channelId, newName);
         }
         catch (error) {
             this.logger.error('[RoolChannel] Failed to rename channel:', error);
-            // Rollback
             if (this._channel) {
                 this._channel.name = previousName;
             }
             throw error;
         }
     }
-    // ===========================================================================
-    // Media Operations
-    // ===========================================================================
-    /**
-     * 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.
-     * Pass `{ forceProxy: true }` to skip the direct fetch and go straight through the server proxy.
-     */
-    async fetchMedia(url, options) {
-        return this.mediaClient.fetch(this._id, url, options);
-    }
-    /**
-     * Delete a media file by URL.
-     */
-    async deleteMedia(url) {
-        return this.mediaClient.delete(this._id, url);
-    }
-    // ===========================================================================
-    // Proxied Fetch
-    // ===========================================================================
     /**
      * Fetch an external URL via the server proxy, bypassing CORS restrictions.
-     * Requires editor role or above. Blocked for private/internal IP ranges (SSRF protection).
-     *
-     * @param url - The URL to fetch
-     * @param init - Optional method, headers, and body
-     * @returns The proxied Response
      */
     async fetch(url, init) {
-        return this.mediaClient.proxyFetch(this._id, url, init);
-    }
-    // ===========================================================================
-    // Object Collection (internal)
-    // ===========================================================================
-    /**
-     * Register a collector that resolves when the object arrives via SSE.
-     * If the object is already in the buffer (arrived before collector), resolves immediately.
-     * @internal
-     */
-    _collectObject(objectId) {
-        return new Promise((resolve, reject) => {
-            // Check buffer first — SSE event may have arrived before the HTTP response
-            const buffered = this._objectBuffer.get(objectId);
-            if (buffered) {
-                this._objectBuffer.delete(objectId);
-                resolve(buffered);
-                return;
-            }
-            const timer = setTimeout(() => {
-                this._objectResolvers.delete(objectId);
-                // Fallback: try to fetch from server
-                this.graphqlClient.getObject(this._id, objectId).then(obj => {
-                    if (obj) {
-                        resolve(obj);
-                    }
-                    else {
-                        reject(new Error(`Timeout waiting for object ${objectId} from SSE`));
-                    }
-                }).catch(reject);
-            }, OBJECT_COLLECT_TIMEOUT);
-            this._objectResolvers.set(objectId, (obj) => {
-                clearTimeout(timer);
-                resolve(obj);
-            });
-        });
-    }
-    /**
-     * Cancel a pending object collector (e.g., on mutation error).
-     * @internal
-     */
-    _cancelCollector(objectId) {
-        this._objectResolvers.delete(objectId);
-        this._objectBuffer.delete(objectId);
-    }
-    /**
-     * Deliver an object to a pending collector, or buffer it for later collection.
-     * @internal
-     */
-    _deliverObject(objectId, object) {
-        const resolver = this._objectResolvers.get(objectId);
-        if (resolver) {
-            resolver(object);
-            this._objectResolvers.delete(objectId);
-        }
-        else {
-            // Buffer for prompt() or late collectors
-            this._objectBuffer.set(objectId, object);
-        }
+        return this.restClient.proxyFetch(this._id, url, init);
+    }
+    async uploadAttachment(file, conversationId) {
+        await this.ensureCollection('/rool-drive/attachments');
+        const directory = `/rool-drive/attachments/${conversationId}`;
+        await this.ensureCollection(directory);
+        const attachment = attachmentBody(file);
+        const path = `${directory}/${attachment.filename}`;
+        await this.webdav.put(path, attachment.body, { contentType: attachment.contentType });
+        return path;
+    }
+    async ensureCollection(path) {
+        const response = await this.webdav.request('MKCOL', path, { collection: true });
+        if (response.status === 201 || response.status === 405)
+            return;
+        throw new Error(`Failed to create collection ${path}: ${response.status} ${await response.text()}`);
     }
-    // ===========================================================================
-    // Event Handlers (internal - handles space subscription events)
-    // ===========================================================================
     /**
      * Handle a channel event from the subscription.
      * @internal
      */
     handleChannelEvent(event) {
-        // Ignore events after close - the channel is being torn down
         if (this._closed)
             return;
         const changeSource = event.source === 'agent' ? 'remote_agent' : 'remote_user';
@@ -983,26 +922,6 @@ export class RoolChannel extends EventEmitter {
             case 'connected':
                 // Resync is handled by the client via _applyResyncData.
                 break;
-            case 'object_created':
-                if (event.objectId && event.object) {
-                    if (event.objectStat)
-                        this._objectStats.set(event.objectId, event.objectStat);
-                    this._handleObjectCreated(event.objectId, event.object, changeSource);
-                }
-                break;
-            case 'object_updated':
-                if (event.objectId && event.object) {
-                    if (event.objectStat)
-                        this._objectStats.set(event.objectId, event.objectStat);
-                    this._handleObjectUpdated(event.objectId, event.object, changeSource);
-                }
-                break;
-            case 'object_deleted':
-                if (event.objectId) {
-                    this._objectStats.delete(event.objectId);
-                    this._handleObjectDeleted(event.objectId, changeSource);
-                }
-                break;
             case 'schema_updated':
                 if (event.schema) {
                     this._schema = event.schema;
@@ -1016,7 +935,6 @@ export class RoolChannel extends EventEmitter {
                 }
                 break;
             case 'channel_updated':
-                // Only update if it's our channel — channel_updated is now metadata-only (name, extensionUrl)
                 if (event.channelId === this._channelId && event.channel) {
                     const changed = JSON.stringify(this._channel) !== JSON.stringify(event.channel);
                     this._channel = event.channel;
@@ -1025,8 +943,14 @@ export class RoolChannel extends EventEmitter {
                     }
                 }
                 break;
+            case 'channel_deleted':
+                if (event.channelId === this._channelId) {
+                    this._channel = undefined;
+                    this._activeLeaves.clear();
+                    this.emit('reset', { source: changeSource });
+                }
+                break;
             case 'conversation_updated':
-                // Only update if it's our channel
                 if (event.channelId === this._channelId && event.conversationId) {
                     if (!this._channel) {
                         this._channel = {
@@ -1037,17 +961,13 @@ export class RoolChannel extends EventEmitter {
                     }
                     const prev = this._channel.conversations[event.conversationId];
                     if (event.conversation) {
-                        // Update or create conversation in local cache
                         this._channel.conversations[event.conversationId] = event.conversation;
                     }
                     else {
-                        // Conversation was deleted
                         delete this._channel.conversations[event.conversationId];
                     }
-                    // Skip emit if data is unchanged (e.g. echo of our own optimistic update)
                     if (JSON.stringify(prev) === JSON.stringify(event.conversation))
                         break;
-                    // Auto-advance active leaf if someone continued our current branch
                     if (event.conversation && !Array.isArray(event.conversation.interactions)) {
                         const currentLeaf = this._getActiveLeafImpl(event.conversationId);
                         if (currentLeaf) {
@@ -1059,13 +979,11 @@ export class RoolChannel extends EventEmitter {
                             }
                         }
                     }
-                    // Emit the new conversationUpdated event
                     this.emit('conversationUpdated', {
                         conversationId: event.conversationId,
                         channelId: event.channelId,
                         source: changeSource,
                     });
-                    // Backward compat: also emit channelUpdated when the active conversation updates
                     if (event.conversationId === this._conversationId) {
                         this.emit('channelUpdated', { channelId: event.channelId, source: changeSource });
                     }
@@ -1076,90 +994,9 @@ export class RoolChannel extends EventEmitter {
                 break;
         }
     }
-    /**
-     * Handle an object_created SSE event.
-     * Deduplicates against optimistic local creates.
-     * @internal
-     */
-    _handleObjectCreated(objectId, object, source) {
-        // Deliver to any pending collector (for mutation return values)
-        this._deliverObject(objectId, object);
-        // Maintain local ID list — prepend (most recently modified first)
-        this._objectIds = [objectId, ...this._objectIds.filter(id => id !== objectId)];
-        const pending = this._pendingMutations.get(objectId);
-        if (pending !== undefined) {
-            // This is our own mutation echoed back
-            this._pendingMutations.delete(objectId);
-            if (pending !== null) {
-                // It was a create — already emitted objectCreated optimistically.
-                // Emit objectUpdated only if AI resolved placeholders (data changed).
-                if (JSON.stringify(pending) !== JSON.stringify(object)) {
-                    this.emit('objectUpdated', { objectId, object, source });
-                }
-            }
-        }
-        else {
-            // Remote event — emit normally
-            this.emit('objectCreated', { objectId, object, source });
-        }
-    }
-    /**
-     * Handle an object_updated SSE event.
-     * Deduplicates against optimistic local updates.
-     * @internal
-     */
-    _handleObjectUpdated(objectId, object, source) {
-        // Deliver to any pending collector
-        this._deliverObject(objectId, object);
-        // Maintain local ID list — move to front (most recently modified)
-        this._objectIds = [objectId, ...this._objectIds.filter(id => id !== objectId)];
-        const pending = this._pendingMutations.get(objectId);
-        if (pending !== undefined) {
-            // This is our own mutation echoed back
-            this._pendingMutations.delete(objectId);
-            if (pending !== null) {
-                // Already emitted objectUpdated optimistically.
-                // Emit again only if data changed (AI resolved placeholders).
-                if (JSON.stringify(pending) !== JSON.stringify(object)) {
-                    this.emit('objectUpdated', { objectId, object, source });
-                }
-            }
-        }
-        else {
-            // Remote event
-            this.emit('objectUpdated', { objectId, object, source });
-        }
-    }
-    /**
-     * Handle an object_deleted SSE event.
-     * Deduplicates against optimistic local deletes.
-     * @internal
-     */
-    _handleObjectDeleted(objectId, source) {
-        // Remove from local ID list
-        this._objectIds = this._objectIds.filter(id => id !== objectId);
-        const pending = this._pendingMutations.get(objectId);
-        if (pending !== undefined) {
-            // This is our own delete echoed back — already emitted
-            this._pendingMutations.delete(objectId);
-        }
-        else {
-            // Remote event
-            this.emit('objectDeleted', { objectId, source });
-        }
-    }
 }
-// =============================================================================
-// ConversationHandle — Scoped proxy for a specific conversation
-// =============================================================================
 /**
  * A lightweight handle for a specific conversation within a channel.
- *
- * Scopes AI and mutation operations to a particular conversation's interaction
- * history, while sharing the channel's single SSE connection and object state.
- *
- * Obtain via `channel.conversation('thread-id')`.
- * Conversations are auto-created on first interaction.
  */
 export class ConversationHandle {
     /** @internal */
@@ -1172,9 +1009,6 @@ export class ConversationHandle {
     }
     /** The conversation ID this handle is scoped to. */
     get conversationId() { return this._conversationId; }
-    // ---------------------------------------------------------------------------
-    // Conversation History
-    // ---------------------------------------------------------------------------
     /** Get the active branch of this conversation as a flat array (root → leaf). */
     getInteractions() {
         return this._channel._getInteractionsImpl(this._conversationId);
@@ -1203,51 +1037,50 @@ export class ConversationHandle {
     async rename(name) {
         return this._channel._renameConversationImpl(name, this._conversationId);
     }
-    // ---------------------------------------------------------------------------
-    // Object Operations (scoped to this conversation's interaction history)
-    // ---------------------------------------------------------------------------
-    /** Find objects using structured filters and/or natural language. */
-    async findObjects(options) {
-        return this._channel._findObjectsImpl(options, this._conversationId);
+    /** Create or replace an object JSON file. */
+    async putObject(path, body) {
+        return this._channel._putObjectImpl(path, body, this._conversationId);
+    }
+    /** Patch an existing object JSON file. */
+    async patchObject(path, options) {
+        return this._channel._patchObjectImpl(path, options, this._conversationId);
     }
-    /** Create a new object. */
-    async createObject(options) {
-        return this._channel._createObjectImpl(options, this._conversationId);
+    /** Move (rename/relocate) an object. */
+    async moveObject(from, to, options) {
+        return this._channel._moveObjectImpl(from, to, options, this._conversationId);
     }
-    /** Update an existing object. */
-    async updateObject(objectId, options) {
-        return this._channel._updateObjectImpl(objectId, options, this._conversationId);
+    /** Delete object JSON files by path. */
+    async deleteObjects(paths) {
+        return this._channel._deleteObjectsImpl(paths, this._conversationId);
     }
-    /** Delete objects by IDs. */
-    async deleteObjects(objectIds) {
-        return this._channel._deleteObjectsImpl(objectIds, this._conversationId);
+    /** @deprecated Use deleteObjects instead. */
+    async deletePaths(paths) {
+        return this.deleteObjects(paths);
     }
-    // ---------------------------------------------------------------------------
-    // AI
-    // ---------------------------------------------------------------------------
     /** Send a prompt to the AI agent, scoped to this conversation's history. */
     async prompt(text, options) {
         return this._channel._promptImpl(text, options, this._conversationId);
     }
-    // ---------------------------------------------------------------------------
-    // Schema (scoped to this conversation's interaction history)
-    // ---------------------------------------------------------------------------
+    /**
+     * Stop this conversation's in-flight interaction, if any. No-op returning
+     * `false` when nothing is running. Stopping is best-effort — see
+     * {@link RoolChannel.stop}.
+     */
+    async stop() {
+        return this._channel._stopImpl(this._conversationId);
+    }
     /** Create a new collection schema. */
-    async createCollection(name, fields) {
-        return this._channel._createCollectionImpl(name, fields, this._conversationId);
+    async createCollection(name, fields, options) {
+        return this._channel._createCollectionImpl(name, fields, options, this._conversationId);
     }
     /** Alter an existing collection schema. */
-    async alterCollection(name, fields) {
-        return this._channel._alterCollectionImpl(name, fields, this._conversationId);
+    async alterCollection(name, fields, options) {
+        return this._channel._alterCollectionImpl(name, fields, options, this._conversationId);
     }
     /** Drop a collection schema. */
     async dropCollection(name) {
         return this._channel._dropCollectionImpl(name, this._conversationId);
     }
-    // ---------------------------------------------------------------------------
-    // Metadata (scoped to this conversation's interaction history)
-    // ---------------------------------------------------------------------------
-    /** Set a space-level metadata value. */
     setMetadata(key, value) {
         return this._channel._setMetadataImpl(key, value, this._conversationId);
     }