@rool-dev/extension 0.3.7 → 0.3.8-dev.368b058

package/dist/host.d.ts

@@ -6,6 +6,7 @@
  *
  * Used by both the console's ExtensionHost component and the local dev shell.
  */
+import type { BridgeUser, ColorScheme } from './protocol.js';
 /**
  * Minimal channel interface accepted by the bridge host.
  * Works with both BridgeableChannel (SDK) and ReactiveChannel (@rool-dev/svelte).
@@ -28,16 +29,24 @@ export interface BridgeHostOptions {
     channel: BridgeableChannel;
     /** The iframe element hosting the extension */
     iframe: HTMLIFrameElement;
+    /** Current user info to expose to the extension */
+    user: BridgeUser;
+    /** Resolved color scheme to send to the extension. Defaults to 'light'. */
+    colorScheme?: ColorScheme;
 }
 export declare class BridgeHost {
     private channel;
     private iframe;
+    private user;
+    private _colorScheme;
     private eventCleanups;
     private _destroyed;
     constructor(options: BridgeHostOptions);
     private _sendInit;
     private _onMessage;
     private _handleRequest;
+    /** Update the color scheme and push to the extension iframe. */
+    setColorScheme(colorScheme: ColorScheme): void;
     private _postToApp;
     destroy(): void;
 }

package/dist/host.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAA6B,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGxF;;;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;AAgFD,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mDAAmD;IACnD,IAAI,EAAE,UAAU,CAAC;IACjB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,iBAAiB;IA4BtC,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,UAAU,CAchB;YAEY,cAAc;IAqD5B,gEAAgE;IAChE,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAS9C,OAAO,CAAC,UAAU;IASlB,OAAO,IAAI,IAAI;CAQhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE"}

package/dist/host.js

@@ -34,6 +34,9 @@ const ALLOWED_METHODS = new Set([
     'alterCollection',
     'dropCollection',
     'getInteractions',
+    'getTree',
+    'setActiveLeaf',
+    'getActiveLeafId',
     'getConversations',
     'getSystemInstruction',
     'setSystemInstruction',
@@ -53,6 +56,9 @@ const ALLOWED_METHODS = new Set([
 // Methods that can be dispatched to a ConversationHandle when conversationId is present
 const CONVERSATION_METHODS = new Set([
     'getInteractions',
+    'getTree',
+    'setActiveLeaf',
+    'getActiveLeafId',
     'getSystemInstruction',
     'setSystemInstruction',
     'renameConversation',
@@ -70,14 +76,22 @@ const CONVERSATION_METHODS = new Set([
 const CONVERSATION_METHOD_MAP = {
     'renameConversation': 'rename',
 };
+// Wire method names that map to getters (not callable methods)
+const GETTER_MAP = {
+    'getActiveLeafId': 'activeLeafId',
+};
 export class BridgeHost {
     channel;
     iframe;
+    user;
+    _colorScheme;
     eventCleanups = [];
     _destroyed = false;
     constructor(options) {
         this.channel = options.channel;
         this.iframe = options.iframe;
+        this.user = options.user;
+        this._colorScheme = options.colorScheme ?? 'light';
         window.addEventListener('message', this._onMessage);
         // Forward channel events to the extension iframe
         for (const eventName of FORWARDED_EVENTS) {
@@ -106,6 +120,8 @@ export class BridgeHost {
             role: this.channel.role,
             linkAccess: this.channel.linkAccess,
             userId: this.channel.userId,
+            user: this.user,
+            colorScheme: this._colorScheme,
             schema: this.channel.getSchema(),
             metadata: this.channel.getAllMetadata(),
         };
@@ -147,6 +163,10 @@ export class BridgeHost {
                 target = this.channel.conversation(conversationId);
                 methodName = CONVERSATION_METHOD_MAP[method] ?? method;
             }
+            // Resolve getter aliases (e.g. getActiveLeafId → activeLeafId)
+            if (GETTER_MAP[methodName]) {
+                methodName = GETTER_MAP[methodName];
+            }
             // Get the method from the target (cast for dynamic dispatch)
             const fn = target[methodName];
             let result;
@@ -169,6 +189,14 @@ export class BridgeHost {
         }
     }
     // ---------------------------------------------------------------------------
+    // Color scheme
+    // ---------------------------------------------------------------------------
+    /** Update the color scheme and push to the extension iframe. */
+    setColorScheme(colorScheme) {
+        this._colorScheme = colorScheme;
+        this._postToApp({ type: 'rool:event', name: 'colorSchemeChanged', data: { colorScheme } });
+    }
+    // ---------------------------------------------------------------------------
     // Helpers
     // ---------------------------------------------------------------------------
     _postToApp(message) {

package/dist/index.d.ts

@@ -6,5 +6,6 @@
  */
 export { initExtension } from './reactive.svelte.js';
 export type { ReactiveChannel, ReactiveConversationHandle, ReactiveObject, ReactiveWatch, WatchOptions } from './reactive.svelte.js';
+export type { BridgeUser, ColorScheme } from './protocol.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

@@ -1 +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"}
+{"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,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG7D,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/protocol.d.ts

@@ -30,6 +30,14 @@ export interface BridgeEvent {
 export interface BridgeReady {
     type: 'rool:ready';
 }
+/** Current user info sent to extensions during handshake */
+export interface BridgeUser {
+    id: string;
+    name: string | null;
+    email: string;
+}
+/** Resolved color scheme sent to extensions */
+export type ColorScheme = 'light' | 'dark';
 /** Host → Extension: handshake response with channel metadata */
 export interface BridgeInit {
     type: 'rool:init';
@@ -39,6 +47,8 @@ export interface BridgeInit {
     role: string;
     linkAccess: string;
     userId: string;
+    user: BridgeUser;
+    colorScheme: ColorScheme;
     schema: Record<string, unknown>;
     metadata: Record<string, unknown>;
 }

package/dist/protocol.d.ts.map

@@ -1 +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"}
+{"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,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+CAA+C;AAC/C,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,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,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,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/reactive.svelte.d.ts

@@ -1,12 +1,12 @@
 /**
- * Reactive Svelte wrapper around Channel (bridge client).
+ * Extension channel — bridge client with Svelte 5 reactivity.
  *
- * 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.
+ * Handles the postMessage bridge to the host and provides reactive $state
+ * properties, matching the @rool-dev/svelte ReactiveChannel API.
  */
-import { Channel } from './client.js';
-import type { RoolObject, FieldDef, Interaction, ConversationInfo, PromptOptions, FindObjectsOptions, CreateObjectOptions, UpdateObjectOptions } from './types.js';
+import type { BridgeInit, BridgeUser, ColorScheme } from './protocol.js';
+import type { RoolObject, RoolObjectStat, SpaceSchema, CollectionDef, FieldDef, Interaction, ConversationInfo, PromptOptions, FindObjectsOptions, CreateObjectOptions, UpdateObjectOptions, RoolUserRole, LinkAccess, ChannelEvents } from './types.js';
+type EventName = keyof ChannelEvents;
 export interface WatchOptions {
     where?: Record<string, unknown>;
     collection?: string;
@@ -17,7 +17,7 @@ declare class ReactiveWatchImpl {
     #private;
     objects: RoolObject[];
     loading: boolean;
-    constructor(channel: Channel, options: WatchOptions);
+    constructor(channel: ReactiveChannelImpl, options: WatchOptions);
     refresh(): Promise<void>;
     close(): void;
 }
@@ -26,27 +26,44 @@ declare class ReactiveObjectImpl {
     #private;
     data: RoolObject | undefined;
     loading: boolean;
-    constructor(channel: Channel, objectId: string);
+    constructor(channel: ReactiveChannelImpl, objectId: string);
     refresh(): Promise<void>;
     close(): void;
 }
 export type ReactiveObject = ReactiveObjectImpl;
 declare class ReactiveChannelImpl {
     #private;
+    private _pending;
+    private _listeners;
+    private _schema;
+    private _metadata;
+    readonly channelId: string;
+    readonly spaceId: string;
+    readonly spaceName: string;
+    readonly role: RoolUserRole;
+    readonly linkAccess: LinkAccess;
+    readonly userId: string;
+    /** Current user info (id, name, email). */
+    readonly user: BridgeUser;
     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;
+    colorScheme: ColorScheme;
+    constructor(init: BridgeInit);
     get isReadOnly(): boolean;
+    on<E extends EventName>(event: E, callback: (data: ChannelEvents[E]) => void): void;
+    off<E extends EventName>(event: E, callback: (data: ChannelEvents[E]) => void): void;
+    private _emit;
+    private _call;
+    /**
+     * Send a bridge request, optionally scoped to a conversation.
+     * @internal
+     */
+    _callScoped(method: string, args: unknown[], conversationId?: string): Promise<unknown>;
+    private _onMessage;
     getObject(objectId: string): Promise<RoolObject | undefined>;
-    stat(objectId: string): Promise<import("./types.js").RoolObjectStat | undefined>;
+    stat(objectId: string): Promise<RoolObjectStat | undefined>;
     findObjects(options: FindObjectsOptions): Promise<{
         objects: RoolObject[];
         message: string;
@@ -64,6 +81,28 @@ declare class ReactiveChannelImpl {
         message: string;
     }>;
     deleteObjects(objectIds: string[]): Promise<void>;
+    getSchema(): SpaceSchema;
+    createCollection(name: string, fields: FieldDef[]): Promise<CollectionDef>;
+    alterCollection(name: string, fields: FieldDef[]): Promise<CollectionDef>;
+    dropCollection(name: string): Promise<void>;
+    getInteractions(): Promise<Interaction[]>;
+    getTree(): Promise<Record<string, Interaction>>;
+    getActiveLeafId(): Promise<string | undefined>;
+    setActiveLeaf(interactionId: string): Promise<void>;
+    getSystemInstruction(): Promise<string | undefined>;
+    setSystemInstruction(instruction: string | null): Promise<void>;
+    getConversations(): Promise<ConversationInfo[]>;
+    deleteConversation(conversationId: string): Promise<void>;
+    renameConversation(name: string): Promise<void>;
+    /**
+     * Get a reactive handle for a specific conversation within this channel.
+     * Scopes AI and mutation operations to that conversation's interaction history.
+     * Conversations are auto-created on first interaction.
+     */
+    conversation(conversationId: string): ReactiveConversationHandle;
+    setMetadata(key: string, value: unknown): Promise<void>;
+    getMetadata(key: string): unknown;
+    getAllMetadata(): Record<string, unknown>;
     prompt(text: string, options?: PromptOptions): Promise<{
         message: string;
         objects: RoolObject[];
@@ -74,22 +113,6 @@ declare class ReactiveChannelImpl {
     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;
@@ -97,17 +120,20 @@ declare class ReactiveChannelImpl {
 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.
+ * Scopes AI and mutation operations to a specific conversation's
+ * interaction history, while sharing the channel's bridge connection.
  *
  * Call `close()` when done to stop listening for updates.
  */
 declare class ReactiveConversationHandleImpl {
     #private;
     interactions: Interaction[];
-    constructor(channel: Channel, conversationId: string);
+    constructor(channel: ReactiveChannelImpl, conversationId: string);
     get conversationId(): string;
     getInteractions(): Promise<Interaction[]>;
+    getTree(): Promise<Record<string, Interaction>>;
+    getActiveLeafId(): Promise<string | undefined>;
+    setActiveLeaf(interactionId: string): Promise<void>;
     getSystemInstruction(): Promise<string | undefined>;
     setSystemInstruction(instruction: string | null): Promise<void>;
     rename(name: string): Promise<void>;
@@ -128,8 +154,8 @@ declare class ReactiveConversationHandleImpl {
         message: string;
         objects: RoolObject[];
     }>;
-    createCollection(name: string, fields: FieldDef[]): Promise<import("./types.js").CollectionDef>;
-    alterCollection(name: string, fields: FieldDef[]): Promise<import("./types.js").CollectionDef>;
+    createCollection(name: string, fields: FieldDef[]): Promise<CollectionDef>;
+    alterCollection(name: string, fields: FieldDef[]): Promise<CollectionDef>;
     dropCollection(name: string): Promise<void>;
     setMetadata(key: string, value: unknown): Promise<void>;
     /**
@@ -144,6 +170,11 @@ export type ReactiveConversationHandle = ReactiveConversationHandleImpl;
  * 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()).
+ *
+ * If the extension is opened directly (not in an iframe), redirects to the Rool
+ * console with `?openExtension={extensionId}` so the user can install or navigate to it.
+ *
+ * @param timeout - How long to wait for the handshake (ms). Default: 10000.
  */
 export declare function initExtension(timeout?: number): Promise<ReactiveChannel>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"reactive.svelte.d.ts","sourceRoot":"","sources":["../src/reactive.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reactive.svelte.d.ts","sourceRoot":"","sources":["../src/reactive.svelte.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA+B,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEtG,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,aAAa,EACd,MAAM,YAAY,CAAC;AAWpB,KAAK,SAAS,GAAG,MAAM,aAAa,CAAC;AAOrC,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAMD,cAAM,iBAAiB;;IAMrB,OAAO,eAA4B;IACnC,OAAO,UAAgB;gBAEX,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY;IAiEzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B,KAAK,IAAI,IAAI;CAId;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAM9C,cAAM,kBAAkB;;IAKtB,IAAI,yBAA6C;IACjD,OAAO,UAAgB;gBAEX,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM;IAgCpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,KAAK,IAAI,IAAI;CAId;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAchD,cAAM,mBAAmB;;IACvB,OAAO,CAAC,QAAQ,CAAoF;IACpG,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,SAAS,CAA0B;IAK3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAG1B,YAAY,gBAA6B;IACzC,SAAS,WAAwB;IACjC,WAAW,WAAwB;IACnC,aAAa,qBAAkC;IAC/C,WAAW,cAAgC;gBAE/B,IAAI,EAAE,UAAU;IA8D5B,IAAI,UAAU,IAAI,OAAO,CAExB;IAMD,EAAE,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IASnF,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAIpF,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,KAAK;IAIb;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvF,OAAO,CAAC,UAAU,CA6ChB;IAMI,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAI5D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI3D,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI7F,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIrF,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5F,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9G,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD,SAAS,IAAI,WAAW;IAIlB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAM1E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAMzE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3C,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIzC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAI/C,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI9C,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAInD,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI/C,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD;;;;OAIG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,0BAA0B;IAS1D,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjC,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAQlG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;IAKxC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IAS3C,OAAO,IAAI,IAAI;CAWhB;AAED,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAMlD;;;;;;GAMG;AACH,cAAM,8BAA8B;;IAMlC,YAAY,gBAA6B;gBAE7B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM;IAwBhE,IAAI,cAAc,IAAI,MAAM,CAAiC;IAIvD,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIzC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAI/C,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI9C,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAInD,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI7F,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5F,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9G,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAMlG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,CAAC;AAMxE;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,CAkCvE"}