@rool-dev/extension 0.3.5

package/dist/dev/vite-env.d.ts

@@ -0,0 +1,4 @@
+declare module '*.css?inline' {
+  const css: string;
+  export default css;
+}

package/dist/host.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @rool-dev/extension/host — Host-side bridge for iframe-sandboxed extensions.
+ *
+ * The host creates a `BridgeHost` with a real `BridgeableChannel` and an iframe.
+ * It handles the handshake, proxies method calls, and forwards events.
+ *
+ * Used by both the console's ExtensionHost component and the local dev shell.
+ */
+/**
+ * Minimal channel interface accepted by the bridge host.
+ * Works with both BridgeableChannel (SDK) and ReactiveChannel (@rool-dev/svelte).
+ */
+export interface BridgeableChannel {
+    id: string;
+    name: string;
+    role: string;
+    linkAccess: string;
+    userId: string;
+    channelId: string;
+    getSchema(): Record<string, unknown>;
+    getAllMetadata(): Record<string, unknown>;
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    conversation(conversationId: string): unknown;
+}
+export interface BridgeHostOptions {
+    /** The real channel to proxy calls to */
+    channel: BridgeableChannel;
+    /** The iframe element hosting the extension */
+    iframe: HTMLIFrameElement;
+}
+export declare class BridgeHost {
+    private channel;
+    private iframe;
+    private eventCleanups;
+    private _destroyed;
+    constructor(options: BridgeHostOptions);
+    private _sendInit;
+    private _onMessage;
+    private _handleRequest;
+    private _postToApp;
+    destroy(): void;
+}
+/**
+ * Create a bridge host that proxies a BridgeableChannel to an iframe.
+ *
+ * @example
+ * ```typescript
+ * const host = createBridgeHost({ channel, iframe });
+ * // ... later
+ * host.destroy();
+ * ```
+ */
+export declare function createBridgeHost(options: BridgeHostOptions): BridgeHost;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAChE,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/C;AAqED,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,iBAAiB;IA0BtC,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,UAAU,CAchB;YAEY,cAAc;IAgD5B,OAAO,CAAC,UAAU;IASlB,OAAO,IAAI,IAAI;CAQhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE"}

package/dist/host.js

@@ -0,0 +1,203 @@
+/**
+ * @rool-dev/extension/host — Host-side bridge for iframe-sandboxed extensions.
+ *
+ * The host creates a `BridgeHost` with a real `BridgeableChannel` and an iframe.
+ * It handles the handshake, proxies method calls, and forwards events.
+ *
+ * Used by both the console's ExtensionHost component and the local dev shell.
+ */
+import { isBridgeMessage } from './protocol.js';
+// Channel events to forward to the extension
+const FORWARDED_EVENTS = [
+    'objectCreated',
+    'objectUpdated',
+    'objectDeleted',
+    'metadataUpdated',
+    'schemaUpdated',
+    'channelUpdated',
+    'conversationUpdated',
+    'reset',
+    'syncError',
+];
+// Channel methods the extension can call.
+// Sync methods (getObjectIds, getSchema, etc.) are wrapped as async on the host side.
+const ALLOWED_METHODS = new Set([
+    'getObject',
+    'stat',
+    'findObjects',
+    'getObjectIds',
+    'createObject',
+    'updateObject',
+    'deleteObjects',
+    'getSchema',
+    'createCollection',
+    'alterCollection',
+    'dropCollection',
+    'getInteractions',
+    'getConversations',
+    'getSystemInstruction',
+    'setSystemInstruction',
+    'deleteConversation',
+    'renameConversation',
+    'setMetadata',
+    'getMetadata',
+    'getAllMetadata',
+    'prompt',
+    'checkpoint',
+    'canUndo',
+    'canRedo',
+    'undo',
+    'redo',
+    'clearHistory',
+]);
+// Methods that can be dispatched to a ConversationHandle when conversationId is present
+const CONVERSATION_METHODS = new Set([
+    'getInteractions',
+    'getSystemInstruction',
+    'setSystemInstruction',
+    'renameConversation',
+    'findObjects',
+    'createObject',
+    'updateObject',
+    'deleteObjects',
+    'prompt',
+    'createCollection',
+    'alterCollection',
+    'dropCollection',
+    'setMetadata',
+]);
+// Wire method names that differ on ConversationHandle
+const CONVERSATION_METHOD_MAP = {
+    'renameConversation': 'rename',
+};
+export class BridgeHost {
+    channel;
+    iframe;
+    eventCleanups = [];
+    _destroyed = false;
+    constructor(options) {
+        this.channel = options.channel;
+        this.iframe = options.iframe;
+        window.addEventListener('message', this._onMessage);
+        // Forward channel events to the extension iframe
+        for (const eventName of FORWARDED_EVENTS) {
+            const handler = (data) => {
+                this._postToApp({
+                    type: 'rool:event',
+                    name: eventName,
+                    data,
+                });
+            };
+            this.channel.on(eventName, handler);
+            this.eventCleanups.push(() => {
+                this.channel.off(eventName, handler);
+            });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Handshake
+    // ---------------------------------------------------------------------------
+    _sendInit() {
+        const init = {
+            type: 'rool:init',
+            channelId: this.channel.channelId,
+            spaceId: this.channel.id,
+            spaceName: this.channel.name,
+            role: this.channel.role,
+            linkAccess: this.channel.linkAccess,
+            userId: this.channel.userId,
+            schema: this.channel.getSchema(),
+            metadata: this.channel.getAllMetadata(),
+        };
+        this._postToApp(init);
+    }
+    // ---------------------------------------------------------------------------
+    // Message handling
+    // ---------------------------------------------------------------------------
+    _onMessage = async (event) => {
+        // Only accept messages from our iframe
+        if (event.source !== this.iframe.contentWindow)
+            return;
+        if (!isBridgeMessage(event.data))
+            return;
+        if (event.data.type === 'rool:ready') {
+            this._sendInit();
+            return;
+        }
+        if (event.data.type === 'rool:request') {
+            await this._handleRequest(event.data);
+            return;
+        }
+    };
+    async _handleRequest(req) {
+        const { id, method, args, conversationId } = req;
+        if (!ALLOWED_METHODS.has(method)) {
+            this._postToApp({
+                type: 'rool:response',
+                id,
+                error: `Method "${method}" is not available to extensions`,
+            });
+            return;
+        }
+        try {
+            // Determine the target: conversation handle or channel
+            let target = this.channel;
+            let methodName = method;
+            if (conversationId !== undefined && CONVERSATION_METHODS.has(method)) {
+                target = this.channel.conversation(conversationId);
+                methodName = CONVERSATION_METHOD_MAP[method] ?? method;
+            }
+            // Get the method from the target (cast for dynamic dispatch)
+            const fn = target[methodName];
+            let result;
+            if (typeof fn === 'function') {
+                result = fn.apply(target, args);
+                // Await if it returns a promise
+                if (result instanceof Promise) {
+                    result = await result;
+                }
+            }
+            else {
+                // Property access (shouldn't happen with current ALLOWED_METHODS, but just in case)
+                result = fn;
+            }
+            this._postToApp({ type: 'rool:response', id, result });
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            this._postToApp({ type: 'rool:response', id, error: message });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    _postToApp(message) {
+        if (this._destroyed)
+            return;
+        this.iframe.contentWindow?.postMessage(message, '*');
+    }
+    // ---------------------------------------------------------------------------
+    // Cleanup
+    // ---------------------------------------------------------------------------
+    destroy() {
+        this._destroyed = true;
+        window.removeEventListener('message', this._onMessage);
+        for (const cleanup of this.eventCleanups) {
+            cleanup();
+        }
+        this.eventCleanups = [];
+    }
+}
+/**
+ * Create a bridge host that proxies a BridgeableChannel to an iframe.
+ *
+ * @example
+ * ```typescript
+ * const host = createBridgeHost({ channel, iframe });
+ * // ... later
+ * host.destroy();
+ * ```
+ */
+export function createBridgeHost(options) {
+    return new BridgeHost(options);
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @rool-dev/extension — Svelte-first extension SDK for Rool.
+ *
+ * `initExtension()` connects to the host via the iframe bridge and returns
+ * a reactive channel with $state properties, matching the @rool-dev/svelte API.
+ */
+export { initExtension } from './reactive.svelte.js';
+export type { ReactiveChannel, ReactiveConversationHandle, ReactiveObject, ReactiveWatch, WatchOptions } from './reactive.svelte.js';
+export type { RoolObject, RoolObjectStat, SpaceSchema, CollectionDef, FieldDef, FieldType, Interaction, InteractionStatus, ConversationInfo, ToolCall, PromptOptions, PromptEffort, FindObjectsOptions, CreateObjectOptions, UpdateObjectOptions, ChangeSource, RoolUserRole, LinkAccess, ChannelEvents, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,0BAA0B,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGrI,YAAY,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @rool-dev/extension — Svelte-first extension SDK for Rool.
+ *
+ * `initExtension()` connects to the host via the iframe bridge and returns
+ * a reactive channel with $state properties, matching the @rool-dev/svelte API.
+ */
+// Public API — reactive channel
+export { initExtension } from './reactive.svelte.js';

package/dist/manifest.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared manifest types and environment config.
+ *
+ * Browser-safe — no Node.js imports. Used by CLI code, the dev host shell,
+ * and the publish command.
+ */
+export interface ManifestFieldDef {
+    name: string;
+    type: Record<string, unknown>;
+}
+export interface ManifestCollections {
+    write?: Record<string, ManifestFieldDef[]> | '*';
+    read?: Record<string, ManifestFieldDef[]> | '*';
+}
+export interface Manifest {
+    id: string;
+    name: string;
+    public: boolean;
+    icon?: string;
+    collections: ManifestCollections;
+    description?: string;
+    systemInstruction?: string | null;
+    [key: string]: unknown;
+}
+export type ManifestResult = {
+    manifest: Manifest;
+    error: null;
+} | {
+    manifest: null;
+    error: string;
+};
+export type Environment = 'local' | 'dev' | 'prod';
+export interface EnvironmentConfig {
+    baseUrl: string;
+    authUrl: string;
+    label: string;
+    appsDomain: string;
+}
+export declare const ENV_URLS: Record<Environment, EnvironmentConfig>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,GAAG,GAAG,CAAC;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,GAAG,GAAG,CAAC;CACjD;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,mBAAmB,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACnC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAMtC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAI3D,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,11 @@
+/**
+ * Shared manifest types and environment config.
+ *
+ * Browser-safe — no Node.js imports. Used by CLI code, the dev host shell,
+ * and the publish command.
+ */
+export const ENV_URLS = {
+    local: { baseUrl: 'http://localhost:1357', authUrl: 'https://api.dev.rool.dev/auth', label: 'localhost:1357', appsDomain: 'dev.rool.app' },
+    dev: { baseUrl: 'https://api.dev.rool.dev', authUrl: 'https://api.dev.rool.dev/auth', label: 'api.dev.rool.dev', appsDomain: 'dev.rool.app' },
+    prod: { baseUrl: 'https://api.rool.dev', authUrl: 'https://api.rool.dev/auth', label: 'api.rool.dev', appsDomain: 'rool.app' },
+};

package/dist/protocol.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Bridge protocol types shared between extension (client) and host.
+ *
+ * All communication between the sandboxed iframe and the host happens
+ * via window.postMessage using these message shapes.
+ */
+/** Extension → Host: invoke a channel method */
+export interface BridgeRequest {
+    type: 'rool:request';
+    id: string;
+    method: string;
+    args: unknown[];
+    /** When present, the host dispatches to channel.conversation(conversationId) */
+    conversationId?: string;
+}
+/** Host → Extension: result of a channel method call */
+export interface BridgeResponse {
+    type: 'rool:response';
+    id: string;
+    result?: unknown;
+    error?: string;
+}
+/** Host → Extension: channel event pushed in real-time */
+export interface BridgeEvent {
+    type: 'rool:event';
+    name: string;
+    data: unknown;
+}
+/** Extension → Host: extension is loaded and ready for handshake */
+export interface BridgeReady {
+    type: 'rool:ready';
+}
+/** Host → Extension: handshake response with channel metadata */
+export interface BridgeInit {
+    type: 'rool:init';
+    channelId: string;
+    spaceId: string;
+    spaceName: string;
+    role: string;
+    linkAccess: string;
+    userId: string;
+    schema: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+}
+export type BridgeMessage = BridgeRequest | BridgeResponse | BridgeEvent | BridgeReady | BridgeInit;
+/** Type guard for bridge messages */
+export declare function isBridgeMessage(data: unknown): data is BridgeMessage;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,cAAc,GACd,WAAW,GACX,WAAW,GACX,UAAU,CAAC;AAEf,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAQpE"}

package/dist/protocol.js

@@ -0,0 +1,14 @@
+/**
+ * Bridge protocol types shared between extension (client) and host.
+ *
+ * All communication between the sandboxed iframe and the host happens
+ * via window.postMessage using these message shapes.
+ */
+/** Type guard for bridge messages */
+export function isBridgeMessage(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        'type' in data &&
+        typeof data.type === 'string' &&
+        data.type.startsWith('rool:'));
+}

package/dist/reactive.svelte.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Reactive Svelte wrapper around Channel (bridge client).
+ *
+ * Mirrors the @rool-dev/svelte ReactiveChannel API: same $state properties,
+ * same methods, same reactive primitives (object(), watch()).
+ * The underlying transport is the postMessage bridge, not the SDK.
+ */
+import { Channel } from './client.js';
+import type { RoolObject, FieldDef, Interaction, ConversationInfo, PromptOptions, FindObjectsOptions, CreateObjectOptions, UpdateObjectOptions } from './types.js';
+export interface WatchOptions {
+    where?: Record<string, unknown>;
+    collection?: string;
+    limit?: number;
+    order?: 'asc' | 'desc';
+}
+declare class ReactiveWatchImpl {
+    #private;
+    objects: RoolObject[];
+    loading: boolean;
+    constructor(channel: Channel, options: WatchOptions);
+    refresh(): Promise<void>;
+    close(): void;
+}
+export type ReactiveWatch = ReactiveWatchImpl;
+declare class ReactiveObjectImpl {
+    #private;
+    data: RoolObject | undefined;
+    loading: boolean;
+    constructor(channel: Channel, objectId: string);
+    refresh(): Promise<void>;
+    close(): void;
+}
+export type ReactiveObject = ReactiveObjectImpl;
+declare class ReactiveChannelImpl {
+    #private;
+    interactions: Interaction[];
+    objectIds: string[];
+    collections: string[];
+    conversations: ConversationInfo[];
+    constructor(channel: Channel);
+    get channelId(): string;
+    get spaceId(): string;
+    get spaceName(): string;
+    get role(): import("./types.js").RoolUserRole;
+    get linkAccess(): import("./types.js").LinkAccess;
+    get userId(): string;
+    get isReadOnly(): boolean;
+    getObject(objectId: string): Promise<RoolObject | undefined>;
+    stat(objectId: string): Promise<import("./types.js").RoolObjectStat | undefined>;
+    findObjects(options: FindObjectsOptions): Promise<{
+        objects: RoolObject[];
+        message: string;
+    }>;
+    getObjectIds(options?: {
+        limit?: number;
+        order?: 'asc' | 'desc';
+    }): Promise<string[]>;
+    createObject(options: CreateObjectOptions): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    updateObject(objectId: string, options: UpdateObjectOptions): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    deleteObjects(objectIds: string[]): Promise<void>;
+    prompt(text: string, options?: PromptOptions): Promise<{
+        message: string;
+        objects: RoolObject[];
+    }>;
+    checkpoint(label?: string): Promise<string>;
+    canUndo(): Promise<boolean>;
+    canRedo(): Promise<boolean>;
+    undo(): Promise<boolean>;
+    redo(): Promise<boolean>;
+    clearHistory(): Promise<void>;
+    setMetadata(key: string, value: unknown): Promise<void>;
+    getMetadata(key: string): unknown;
+    getAllMetadata(): Record<string, unknown>;
+    getInteractions(): Promise<Interaction[]>;
+    getSystemInstruction(): Promise<string | undefined>;
+    setSystemInstruction(instruction: string | null): Promise<void>;
+    getConversations(): Promise<ConversationInfo[]>;
+    deleteConversation(conversationId: string): Promise<void>;
+    renameConversation(name: string): Promise<void>;
+    getSchema(): import("./types.js").SpaceSchema;
+    createCollection(name: string, fields: FieldDef[]): Promise<import("./types.js").CollectionDef>;
+    alterCollection(name: string, fields: FieldDef[]): Promise<import("./types.js").CollectionDef>;
+    dropCollection(name: string): Promise<void>;
+    conversation(conversationId: string): ReactiveConversationHandle;
+    on(...args: Parameters<Channel['on']>): void;
+    off(...args: Parameters<Channel['off']>): void;
+    object(objectId: string): ReactiveObject;
+    watch(options: WatchOptions): ReactiveWatch;
+    destroy(): void;
+}
+export type ReactiveChannel = ReactiveChannelImpl;
+/**
+ * A reactive conversation handle for the extension bridge.
+ * Wraps ConversationHandle with $state interactions that auto-update
+ * when the conversation changes via SSE events.
+ *
+ * Call `close()` when done to stop listening for updates.
+ */
+declare class ReactiveConversationHandleImpl {
+    #private;
+    interactions: Interaction[];
+    constructor(channel: Channel, conversationId: string);
+    get conversationId(): string;
+    getInteractions(): Promise<Interaction[]>;
+    getSystemInstruction(): Promise<string | undefined>;
+    setSystemInstruction(instruction: string | null): Promise<void>;
+    rename(name: string): Promise<void>;
+    findObjects(options: FindObjectsOptions): Promise<{
+        objects: RoolObject[];
+        message: string;
+    }>;
+    createObject(options: CreateObjectOptions): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    updateObject(objectId: string, options: UpdateObjectOptions): Promise<{
+        object: RoolObject;
+        message: string;
+    }>;
+    deleteObjects(objectIds: string[]): Promise<void>;
+    prompt(text: string, options?: PromptOptions): Promise<{
+        message: string;
+        objects: RoolObject[];
+    }>;
+    createCollection(name: string, fields: FieldDef[]): Promise<import("./types.js").CollectionDef>;
+    alterCollection(name: string, fields: FieldDef[]): Promise<import("./types.js").CollectionDef>;
+    dropCollection(name: string): Promise<void>;
+    setMetadata(key: string, value: unknown): Promise<void>;
+    /**
+     * Stop listening for updates and clean up.
+     */
+    close(): void;
+}
+export type ReactiveConversationHandle = ReactiveConversationHandleImpl;
+/**
+ * Initialize the extension and return a reactive channel.
+ *
+ * Sends `rool:ready` to the host, waits for the handshake, and returns
+ * a reactive channel with $state properties (interactions, objectIds)
+ * and reactive primitives (object(), watch()).
+ */
+export declare function initExtension(timeout?: number): Promise<ReactiveChannel>;
+export {};
+//# sourceMappingURL=reactive.svelte.d.ts.map

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

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