@rool-dev/extension 0.3.7 → 0.3.8-dev.8872f4d

package/README.md

@@ -183,6 +183,7 @@ These are Svelte 5 `$state` properties — use them directly in templates or `$e
 | `role` | `RoolUserRole` | User's role (`owner`, `admin`, `editor`, `viewer`) |
 | `linkAccess` | `LinkAccess` | URL sharing level |
 | `userId` | `string` | Current user's ID |
+| `user` | `BridgeUser` | Current user info (`{ id, name, email }`) |
 | `isReadOnly` | `boolean` | True if viewer role |
 
 ### Object Operations
@@ -409,10 +410,20 @@ Extensions run in a sandboxed iframe (`allow-scripts allow-same-origin`). The ho
 
 The bridge protocol:
 1. Extension sends `rool:ready`
-2. Host responds with `rool:init` (channel metadata, schema, space info)
+2. Host responds with `rool:init` (channel metadata, schema, space info, user identity)
 3. Extension calls channel methods → `rool:request` → host executes → `rool:response`
 4. Host pushes real-time events → `rool:event` → extension updates reactive state
 
+When creating a bridge host, pass `user` so the extension can display the current user's name:
+
+```typescript
+const host = createBridgeHost({
+  channel,
+  iframe,
+  user: { id: currentUser.id, name: currentUser.name, email: currentUser.email },
+});
+```
+
 ## CLI Commands
 
 | Command | Description |
@@ -431,6 +442,7 @@ import type {
   ReactiveObject,
   ReactiveWatch,
   WatchOptions,
+  BridgeUser,
   RoolObject,
   RoolObjectStat,
   SpaceSchema,

package/dist/dev/DevHostController.d.ts

@@ -71,6 +71,7 @@ export declare class DevHostController {
     registerIframe(tabId: string, el: HTMLIFrameElement): void;
     unregisterIframe(tabId: string): void;
     logout(): void;
+    private get _bridgeUser();
     private _bindBridge;
     private _bindAllBridges;
     private _destroyTab;

package/dist/dev/DevHostController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DevHostController.d.ts","sourceRoot":"","sources":["../../src/dev/DevHostController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAe,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAExF,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO5D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC;AAqBnD,qBAAa,iBAAiB;IAE5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtC,MAAM,EAAG,UAAU,CAAC;IAGpB,MAAM,EAAE,aAAa,EAAE,CAAM;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IACrC,UAAU,EAAE,MAAM,CAAqB;IACvC,WAAW,EAAE,WAAW,CAAS;IACjC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAuB;IACrD,GAAG,EAAE,WAAW,CAAC;IACjB,mBAAmB,EAAE,sBAAsB,EAAE,CAAM;IACnD,qBAAqB,EAAE,MAAM,EAAE,CAAM;IACrC,gBAAgB,EAAE,OAAO,CAAS;IAClC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAU;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IACrC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGjC,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,WAAW,CAAkC;IAGrD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,KAAK,CAAsB;IAGnC,OAAO,CAAC,SAAS,CAAS;gBAGxB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,EACD,QAAQ,EAAE,MAAM,IAAI,EACpB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,IAAI,IAAI,YAAY,EAAE,CAoBzB;IAMK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+DrB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0DjD;;;;;;OAMG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB1D;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAiBpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkExB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnD,aAAa,IAAI,IAAI;IAUrB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAK1D,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQrC,MAAM,IAAI,IAAI;IASd,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,6BAA6B;IAYrC;;;OAGG;YACW,aAAa;IA4B3B,OAAO,CAAC,YAAY;CAKrB"}
+{"version":3,"file":"DevHostController.d.ts","sourceRoot":"","sources":["../../src/dev/DevHostController.ts"],"names":[],"mappings":"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"}

package/dist/dev/DevHostController.js

@@ -358,11 +358,15 @@ export class DevHostController {
     // ---------------------------------------------------------------------------
     // Private helpers
     // ---------------------------------------------------------------------------
+    get _bridgeUser() {
+        const cu = this.client.currentUser; // Always available after boot() authenticates
+        return { id: cu.id, name: cu.name, email: cu.email };
+    }
     _bindBridge(tabId) {
         const el = this.iframeEls[tabId];
         const ch = this.channels[tabId];
         if (el && ch && !this.bridgeHosts[tabId]) {
-            this.bridgeHosts[tabId] = createBridgeHost({ channel: ch, iframe: el });
+            this.bridgeHosts[tabId] = createBridgeHost({ channel: ch, iframe: el, user: this._bridgeUser });
         }
     }
     _bindAllBridges() {

package/dist/dev/HostShell.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { onMount, tick } from 'svelte';
+  import { getContext, onMount, tick } from 'svelte';
   import { DevHostController } from './DevHostController.js';
   import type { ExtensionTab } from './DevHostController.js';
   import type { Manifest } from '../manifest.js';
@@ -8,15 +8,15 @@
   import Sidebar from './Sidebar.svelte';
   import AppGrid from './AppGrid.svelte';
 
-  // Props injected from the mount entry
-  interface Props {
+  // Static config injected via mount() context — not reactive, never changes
+  interface HostConfig {
     channelId: string;
     extensionUrl: string;
     manifest: Manifest | null;
     manifestError: string | null;
   }
 
-  const props: Props = $props();
+  const { channelId, extensionUrl, manifest, manifestError } = getContext<HostConfig>('hostConfig');
 
   // ---------------------------------------------------------------------------
   // Controller + reactive state mirror
@@ -40,7 +40,7 @@
   let dropdownOpen: boolean = $state(false);
 
   const controller = new DevHostController(
-    props,
+    { channelId, extensionUrl, manifest, manifestError },
     syncState,
     tick,
   );
@@ -63,7 +63,7 @@
 
   // Derived: published apps not yet installed (excluding the local dev app)
   let uninstalledExtensions = $derived(
-    publishedExtensions.filter((ext) => ext.extensionId !== props.channelId && !installedExtensionIds.includes(ext.extensionId)),
+    publishedExtensions.filter((ext) => ext.extensionId !== channelId && !installedExtensionIds.includes(ext.extensionId)),
   );
 
   // Initial sync
@@ -89,8 +89,8 @@
 <!-- Sidebar -->
 <Sidebar
   {controller}
-  manifest={props.manifest}
-  manifestError={props.manifestError}
+  {manifest}
+  {manifestError}
   {spaces}
   {currentSpaceId}
   {env}

package/dist/dev/HostShell.svelte.d.ts

@@ -1,11 +1,4 @@
-import type { Manifest } from '../manifest.js';
-interface Props {
-    channelId: string;
-    extensionUrl: string;
-    manifest: Manifest | null;
-    manifestError: string | null;
-}
-declare const HostShell: import("svelte").Component<Props, {}, "">;
+declare const HostShell: import("svelte").Component<Record<string, never>, {}, "">;
 type HostShell = ReturnType<typeof HostShell>;
 export default HostShell;
 //# sourceMappingURL=HostShell.svelte.d.ts.map

package/dist/dev/HostShell.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostShell.svelte.d.ts","sourceRoot":"","sources":["../../src/dev/HostShell.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAQ7C,UAAU,KAAK;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAgGH,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"HostShell.svelte.d.ts","sourceRoot":"","sources":["../../src/dev/HostShell.svelte.ts"],"names":[],"mappings":"AAkHA,QAAA,MAAM,SAAS,2DAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/dev/host-shell.js

@@ -313,6 +313,19 @@ function set_component_context(context) {
 	component_context = context;
 }
 /**
+* Retrieves the context that belongs to the closest parent component with the specified `key`.
+* Must be called during component initialisation.
+*
+* [`createContext`](https://svelte.dev/docs/svelte/svelte#createContext) is a type-safe alternative.
+*
+* @template T
+* @param {any} key
+* @returns {T}
+*/
+function getContext(key) {
+	return get_or_init_context_map("getContext").get(key);
+}
+/**
 * @param {Record<string, unknown>} props
 * @param {any} runes
 * @param {Function} [fn]
@@ -355,6 +368,27 @@ function pop(component) {
 function is_runes() {
 	return !legacy_mode_flag || component_context !== null && component_context.l === null;
 }
+/**
+* @param {string} name
+* @returns {Map<unknown, unknown>}
+*/
+function get_or_init_context_map(name) {
+	if (component_context === null) lifecycle_outside_component(name);
+	return component_context.c ??= new Map(get_parent_context(component_context) || void 0);
+}
+/**
+* @param {ComponentContext} component_context
+* @returns {Map<unknown, unknown> | null}
+*/
+function get_parent_context(component_context) {
+	let parent = component_context.p;
+	while (parent !== null) {
+		const context_map = parent.c;
+		if (context_map !== null) return context_map;
+		parent = parent.p;
+	}
+	return null;
+}
 //#endregion
 //#region ../../node_modules/.pnpm/svelte@5.54.0/node_modules/svelte/src/internal/client/dom/task.js
 /** @type {Array<() => void>} */
@@ -4119,48 +4153,6 @@ function bind_this(element_or_component = {}, update, get_value, get_parts) {
 //#region ../../node_modules/.pnpm/svelte@5.54.0/node_modules/svelte/src/internal/client/reactivity/props.js
 /** @import { Effect, Source } from './types.js' */
 /**
-* The proxy handler for rest props (i.e. `const { x, ...rest } = $props()`).
-* Is passed the full `$$props` object and excludes the named props.
-* @type {ProxyHandler<{ props: Record<string | symbol, unknown>, exclude: Array<string | symbol>, name?: string }>}}
-*/
-var rest_props_handler = {
-	get(target, key) {
-		if (target.exclude.includes(key)) return;
-		return target.props[key];
-	},
-	set(target, key) {
-		return false;
-	},
-	getOwnPropertyDescriptor(target, key) {
-		if (target.exclude.includes(key)) return;
-		if (key in target.props) return {
-			enumerable: true,
-			configurable: true,
-			value: target.props[key]
-		};
-	},
-	has(target, key) {
-		if (target.exclude.includes(key)) return false;
-		return key in target.props;
-	},
-	ownKeys(target) {
-		return Reflect.ownKeys(target.props).filter((key) => !target.exclude.includes(key));
-	}
-};
-/**
-* @param {Record<string, unknown>} props
-* @param {string[]} exclude
-* @param {string} [name]
-* @returns {Record<string, unknown>}
-*/
-/* @__NO_SIDE_EFFECTS__ */
-function rest_props(props, exclude, name) {
-	return new Proxy({
-		props,
-		exclude
-	}, rest_props_handler);
-}
-/**
 * This function is responsible for synchronizing a possibly bound prop with the inner component state.
 * It is used whenever the compiler sees that the component writes to the prop, or when it has a default prop_value.
 * @template V
@@ -5638,8 +5630,8 @@ var GraphQLClient = class {
 	}
 	async prompt(spaceId, prompt, channelId, conversationId, options) {
 		return (await this.request(`
-      mutation Prompt($spaceId: String!, $prompt: String!, $objectIds: [String!], $responseSchema: JSON, $channelId: String!, $conversationId: String!, $effort: PromptEffort, $ephemeral: Boolean, $readOnly: Boolean, $attachments: [String!], $interactionId: String!) {
-        prompt(spaceId: $spaceId, prompt: $prompt, objectIds: $objectIds, responseSchema: $responseSchema, channelId: $channelId, conversationId: $conversationId, effort: $effort, ephemeral: $ephemeral, readOnly: $readOnly, attachments: $attachments, interactionId: $interactionId) {
+      mutation Prompt($spaceId: String!, $prompt: String!, $objectIds: [String!], $responseSchema: JSON, $channelId: String!, $conversationId: String!, $effort: PromptEffort, $ephemeral: Boolean, $readOnly: Boolean, $attachments: [String!], $interactionId: String!, $parentInteractionId: String) {
+        prompt(spaceId: $spaceId, prompt: $prompt, objectIds: $objectIds, responseSchema: $responseSchema, channelId: $channelId, conversationId: $conversationId, effort: $effort, ephemeral: $ephemeral, readOnly: $readOnly, attachments: $attachments, interactionId: $interactionId, parentInteractionId: $parentInteractionId) {
           message
           modifiedObjectIds
         }
@@ -5655,7 +5647,8 @@ var GraphQLClient = class {
 			ephemeral: options.ephemeral,
 			readOnly: options.readOnly,
 			attachments: options.attachmentUrls,
-			interactionId: options.interactionId
+			interactionId: options.interactionId,
+			parentInteractionId: options.parentInteractionId
 		})).prompt;
 	}
 	async getAccount() {
@@ -7220,6 +7213,29 @@ function generateEntityId() {
 	for (let i = 0; i < 6; i++) result += ID_CHARS[Math.floor(Math.random() * 62)];
 	return result;
 }
+/** Walk from a leaf interaction up through parentId to root, return in root→leaf order. */
+function walkBranch(interactions, leafId) {
+	const path = [];
+	let currentId = leafId;
+	while (currentId) {
+		const ix = interactions[currentId];
+		if (!ix) break;
+		path.push(ix);
+		currentId = ix.parentId;
+	}
+	return path.reverse();
+}
+/** Find the default leaf: the most recent interaction by timestamp that has no children. */
+function findDefaultLeaf(interactions) {
+	if (!interactions || Array.isArray(interactions)) return void 0;
+	const childSet = /* @__PURE__ */ new Set();
+	for (const ix of Object.values(interactions)) if (ix.parentId) childSet.add(ix.parentId);
+	let best;
+	for (const ix of Object.values(interactions)) if (!childSet.has(ix.id)) {
+		if (!best || ix.timestamp > best.timestamp) best = ix;
+	}
+	return best?.id;
+}
 var OBJECT_COLLECT_TIMEOUT = 3e4;
 /**
 * A channel is a space + channelId pair.
@@ -7260,6 +7276,7 @@ var RoolChannel = class extends EventEmitter {
 	_objectIds;
 	_objectStats;
 	_hasConnected = false;
+	_activeLeaves = /* @__PURE__ */ new Map();
 	_pendingMutations = /* @__PURE__ */ new Map();
 	_objectResolvers = /* @__PURE__ */ new Map();
 	_objectBuffer = /* @__PURE__ */ new Map();
@@ -7350,14 +7367,62 @@ var RoolChannel = class extends EventEmitter {
 		return this._channel?.extensionUrl ?? null;
 	}
 	/**
-	* Get interactions for the current conversation.
+	* Get the active branch of the current conversation as a flat array (root → leaf).
+	* Walks from the active leaf up through parentId pointers.
 	*/
 	getInteractions() {
 		return this._getInteractionsImpl(this._conversationId);
 	}
 	/** @internal */
 	_getInteractionsImpl(conversationId) {
-		return this._channel?.conversations[conversationId]?.interactions ?? [];
+		const interactions = this._channel?.conversations[conversationId]?.interactions;
+		if (!interactions) return [];
+		if (Array.isArray(interactions)) return interactions;
+		const leafId = this._getActiveLeafImpl(conversationId);
+		if (!leafId) return [];
+		return walkBranch(interactions, leafId);
+	}
+	/**
+	* Get the full interaction tree for a conversation as a record.
+	* For clients that need to render branch navigation UI.
+	*/
+	getTree() {
+		return this._getTreeImpl(this._conversationId);
+	}
+	/** @internal */
+	_getTreeImpl(conversationId) {
+		const interactions = this._channel?.conversations[conversationId]?.interactions;
+		if (!interactions || Array.isArray(interactions)) return {};
+		return interactions;
+	}
+	/**
+	* Get the active leaf interaction ID for a conversation.
+	* Returns undefined if the conversation has no interactions.
+	*/
+	get activeLeafId() {
+		return this._getActiveLeafImpl(this._conversationId);
+	}
+	/** @internal */
+	_getActiveLeafImpl(conversationId) {
+		return this._activeLeaves.get(conversationId) ?? findDefaultLeaf(this._channel?.conversations[conversationId]?.interactions);
+	}
+	/**
+	* Set the active leaf for a conversation (switch branches).
+	* Emits a conversationUpdated event so reactive wrappers refresh.
+	*/
+	setActiveLeaf(interactionId) {
+		this._setActiveLeafImpl(interactionId, this._conversationId);
+	}
+	/** @internal */
+	_setActiveLeafImpl(interactionId, conversationId) {
+		const interactions = this._channel?.conversations[conversationId]?.interactions;
+		if (!interactions || Array.isArray(interactions) || !interactions[interactionId]) throw new Error(`Interaction "${interactionId}" not found in conversation "${conversationId}"`);
+		this._activeLeaves.set(conversationId, interactionId);
+		this.emit("conversationUpdated", {
+			conversationId,
+			channelId: this._channelId,
+			source: "local_user"
+		});
 	}
 	/**
 	* Get all conversations in this channel.
@@ -7371,7 +7436,7 @@ var RoolChannel = class extends EventEmitter {
 			systemInstruction: conv.systemInstruction ?? null,
 			createdAt: conv.createdAt,
 			createdBy: conv.createdBy,
-			interactionCount: conv.interactions.length
+			interactionCount: Object.keys(conv.interactions).length
 		}));
 	}
 	/**
@@ -7780,7 +7845,7 @@ var RoolChannel = class extends EventEmitter {
 		if (!this._channel.conversations[conversationId]) this._channel.conversations[conversationId] = {
 			createdAt: Date.now(),
 			createdBy: this._userId,
-			interactions: []
+			interactions: {}
 		};
 	}
 	/**
@@ -7822,14 +7887,17 @@ var RoolChannel = class extends EventEmitter {
 	}
 	/** @internal */
 	async _promptImpl(prompt, options, conversationId) {
-		const { attachments, ...rest } = options ?? {};
+		const { attachments, parentInteractionId: explicitParent, ...rest } = options ?? {};
 		let attachmentUrls;
 		if (attachments?.length) attachmentUrls = await Promise.all(attachments.map((file) => this.mediaClient.upload(this._id, file)));
+		const parentInteractionId = explicitParent !== void 0 ? explicitParent : this._getActiveLeafImpl(conversationId) ?? null;
 		const interactionId = generateEntityId();
+		this._activeLeaves.set(conversationId, interactionId);
 		const result = await this.graphqlClient.prompt(this._id, prompt, this._channelId, conversationId, {
 			...rest,
 			attachmentUrls,
-			interactionId
+			interactionId,
+			parentInteractionId
 		});
 		const objects = [];
 		const missing = [];
@@ -8015,6 +8083,15 @@ var RoolChannel = class extends EventEmitter {
 					if (event.conversation) this._channel.conversations[event.conversationId] = event.conversation;
 					else delete this._channel.conversations[event.conversationId];
 					if (JSON.stringify(prev) === JSON.stringify(event.conversation)) break;
+					if (event.conversation && !Array.isArray(event.conversation.interactions)) {
+						const currentLeaf = this._getActiveLeafImpl(event.conversationId);
+						if (currentLeaf) {
+							for (const ix of Object.values(event.conversation.interactions)) if (ix.parentId === currentLeaf && ix.id !== currentLeaf) {
+								this._activeLeaves.set(event.conversationId, ix.id);
+								break;
+							}
+						}
+					}
 					this.emit("conversationUpdated", {
 						conversationId: event.conversationId,
 						channelId: event.channelId,
@@ -8123,10 +8200,22 @@ var ConversationHandle = class {
 	get conversationId() {
 		return this._conversationId;
 	}
-	/** Get interactions for this conversation. */
+	/** Get the active branch of this conversation as a flat array (root → leaf). */
 	getInteractions() {
 		return this._channel._getInteractionsImpl(this._conversationId);
 	}
+	/** Get the full interaction tree as a record. */
+	getTree() {
+		return this._channel._getTreeImpl(this._conversationId);
+	}
+	/** Get the active leaf interaction ID, or undefined if empty. */
+	get activeLeafId() {
+		return this._channel._getActiveLeafImpl(this._conversationId);
+	}
+	/** Switch to a different branch by setting the active leaf. */
+	setActiveLeaf(interactionId) {
+		this._channel._setActiveLeafImpl(interactionId, this._conversationId);
+	}
 	/** Get the system instruction for this conversation. */
 	getSystemInstruction() {
 		return this._channel._getSystemInstructionImpl(this._conversationId);
@@ -8871,6 +8960,9 @@ var ALLOWED_METHODS = new Set([
 	"alterCollection",
 	"dropCollection",
 	"getInteractions",
+	"getTree",
+	"setActiveLeaf",
+	"getActiveLeafId",
 	"getConversations",
 	"getSystemInstruction",
 	"setSystemInstruction",
@@ -8889,6 +8981,9 @@ var ALLOWED_METHODS = new Set([
 ]);
 var CONVERSATION_METHODS = new Set([
 	"getInteractions",
+	"getTree",
+	"setActiveLeaf",
+	"getActiveLeafId",
 	"getSystemInstruction",
 	"setSystemInstruction",
 	"renameConversation",
@@ -8903,14 +8998,17 @@ var CONVERSATION_METHODS = new Set([
 	"setMetadata"
 ]);
 var CONVERSATION_METHOD_MAP = { "renameConversation": "rename" };
+var GETTER_MAP = { "getActiveLeafId": "activeLeafId" };
 var BridgeHost = class {
 	channel;
 	iframe;
+	user;
 	eventCleanups = [];
 	_destroyed = false;
 	constructor(options) {
 		this.channel = options.channel;
 		this.iframe = options.iframe;
+		this.user = options.user;
 		window.addEventListener("message", this._onMessage);
 		for (const eventName of FORWARDED_EVENTS) {
 			const handler = (data) => {
@@ -8935,6 +9033,7 @@ var BridgeHost = class {
 			role: this.channel.role,
 			linkAccess: this.channel.linkAccess,
 			userId: this.channel.userId,
+			user: this.user,
 			schema: this.channel.getSchema(),
 			metadata: this.channel.getAllMetadata()
 		};
@@ -8969,6 +9068,7 @@ var BridgeHost = class {
 				target = this.channel.conversation(conversationId);
 				methodName = CONVERSATION_METHOD_MAP[method] ?? method;
 			}
+			if (GETTER_MAP[methodName]) methodName = GETTER_MAP[methodName];
 			const fn = target[methodName];
 			let result;
 			if (typeof fn === "function") {
@@ -9307,12 +9407,21 @@ var DevHostController = class {
 		this.client.logout();
 		window.location.reload();
 	}
+	get _bridgeUser() {
+		const cu = this.client.currentUser;
+		return {
+			id: cu.id,
+			name: cu.name,
+			email: cu.email
+		};
+	}
 	_bindBridge(tabId) {
 		const el = this.iframeEls[tabId];
 		const ch = this.channels[tabId];
 		if (el && ch && !this.bridgeHosts[tabId]) this.bridgeHosts[tabId] = createBridgeHost({
 			channel: ch,
-			iframe: el
+			iframe: el,
+			user: this._bridgeUser
 		});
 	}
 	_bindAllBridges() {
@@ -15127,11 +15236,7 @@ var root_1 = /* @__PURE__ */ from_html(`<div class="flex items-center justify-ce
 var root$1 = /* @__PURE__ */ from_html(`<!> <div class="flex-1 min-w-0 flex flex-col"><!></div>`, 1);
 function HostShell($$anchor, $$props) {
 	push($$props, true);
-	const props = /* @__PURE__ */ rest_props($$props, [
-		"$$slots",
-		"$$events",
-		"$$legacy"
-	]);
+	const { channelId, extensionUrl, manifest, manifestError } = getContext("hostConfig");
 	let spaces = /* @__PURE__ */ state(proxy([]));
 	let currentSpaceId = /* @__PURE__ */ state(null);
 	let statusText = /* @__PURE__ */ state("Initializing...");
@@ -15146,7 +15251,12 @@ function HostShell($$anchor, $$props) {
 	let publishMessage = /* @__PURE__ */ state(null);
 	let publishUrl = /* @__PURE__ */ state(null);
 	let dropdownOpen = /* @__PURE__ */ state(false);
-	const controller = new DevHostController(props, syncState, tick);
+	const controller = new DevHostController({
+		channelId,
+		extensionUrl,
+		manifest,
+		manifestError
+	}, syncState, tick);
 	function syncState() {
 		set(spaces, controller.spaces, true);
 		set(currentSpaceId, controller.currentSpaceId, true);
@@ -15162,7 +15272,7 @@ function HostShell($$anchor, $$props) {
 		set(publishMessage, controller.publishMessage, true);
 		set(publishUrl, controller.publishUrl, true);
 	}
-	let uninstalledExtensions = /* @__PURE__ */ user_derived(() => get(publishedExtensions).filter((ext) => ext.extensionId !== $$props.channelId && !get(installedExtensionIds).includes(ext.extensionId)));
+	let uninstalledExtensions = /* @__PURE__ */ user_derived(() => get(publishedExtensions).filter((ext) => ext.extensionId !== channelId && !get(installedExtensionIds).includes(ext.extensionId)));
 	syncState();
 	onMount(() => {
 		controller.boot();
@@ -15179,10 +15289,10 @@ function HostShell($$anchor, $$props) {
 			return controller;
 		},
 		get manifest() {
-			return $$props.manifest;
+			return manifest;
 		},
 		get manifestError() {
-			return $$props.manifestError;
+			return manifestError;
 		},
 		get spaces() {
 			return get(spaces);
@@ -15268,14 +15378,18 @@ var style = document.createElement("style");
 style.textContent = app_default + "\n" + gridstack_default;
 document.head.appendChild(style);
 var root = document.getElementById("rool-host");
+var channelId = root.dataset.channelId ?? "extension-dev";
+var extensionUrl = root.dataset.extensionUrl ?? "/";
+var manifest = root.dataset.manifest ? JSON.parse(root.dataset.manifest) : null;
+var manifestError = root.dataset.manifestError ?? null;
 mount(HostShell, {
 	target: root,
-	props: {
-		channelId: root.dataset.channelId ?? "extension-dev",
-		extensionUrl: root.dataset.extensionUrl ?? "/",
-		manifest: root.dataset.manifest ? JSON.parse(root.dataset.manifest) : null,
-		manifestError: root.dataset.manifestError ?? null
-	}
+	context: new Map([["hostConfig", {
+		channelId,
+		extensionUrl,
+		manifest,
+		manifestError
+	}]])
 });
 //#endregion