@memberjunction/ng-conversations 6.2.0-edge.6 → 6.2.0-edge.7

package/dist/lib/components/conversation/conversation-mode-picker.component.js

@@ -1,6 +1,6 @@
 import { ChangeDetectionStrategy, ChangeDetectorRef, Component, EventEmitter, HostListener, Input, Output, inject, } from '@angular/core';
 import { LogError } from '@memberjunction/core';
-import { AIEngineBase } from '@memberjunction/ai-engine-base';
+import { AIEngineBase, AgentModeSettingKey } from '@memberjunction/ai-engine-base';
 import { UserInfoEngine } from '@memberjunction/core-entities';
 import { UUIDsEqual } from '@memberjunction/global';
 import * as i0 from "@angular/core";
@@ -183,7 +183,7 @@ export class ConversationModePickerComponent {
         return this.Presets.find(p => p.IsDefault) ?? this.Presets[0];
     }
     storageKey(agentID) {
-        return `mj.agentMode.${agentID.toLowerCase()}`;
+        return AgentModeSettingKey(agentID);
     }
     OnDocumentClick(_event) {
         if (this.IsOpen) {

package/dist/lib/components/conversation/conversation-mode-picker.component.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-mode-picker.component.js","sourceRoot":"","sources":["../../../../src/lib/components/conversation/conversation-mode-picker.component.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    ChangeDetectionStrategy,\n    ChangeDetectorRef,\n    Component,\n    EventEmitter,\n    HostListener,\n    Input,\n    OnInit,\n    Output,\n    inject,\n} from '@angular/core';\nimport { LogError } from '@memberjunction/core';\nimport { AIEngineBase } from '@memberjunction/ai-engine-base';\nimport type { MJAIAgentConfigurationEntity } from '@memberjunction/core-entities';\nimport { UserInfoEngine } from '@memberjunction/core-entities';\nimport { UUIDsEqual } from '@memberjunction/global';\n\n/**\n * Per-agent quality/speed mode picker. Sits next to the agent picker in\n * the chat-area header. Lists the **active agent's** configured\n * presets (e.g. Draft / Standard / High) from\n * `AIEngineBase.Instance.GetAgentConfigurationPresets(agentId)` and lets\n * the user pick the one applied to all SUBSEQUENT requests in this\n * conversation. Past messages are not retroactively re-routed.\n *\n * Choice persists per-user, per-agent via `UserInfoEngine` (key\n * `mj.agentMode.<agentId>` = preset name). Cross-device, cross-browser\n * — same model the form-variant preference uses. No DB schema changes.\n *\n * Auto-hides when the active agent has fewer than 2 presets — a\n * single-mode agent doesn't need a switcher.\n */\n@Component({\n    standalone: false,\n    selector: 'mj-conversation-mode-picker',\n    changeDetection: ChangeDetectionStrategy.OnPush,\n    template: `\n        @if (Presets.length >= 2) {\n            <div class=\"mj-cv-mode-picker\" [class.mj-cv-mode-picker--open]=\"IsOpen\">\n                <button\n                    type=\"button\"\n                    class=\"mj-cv-mode-picker__trigger\"\n                    [title]=\"ButtonTitle\"\n                    [disabled]=\"Disabled\"\n                    (click)=\"Toggle($event)\">\n                    <span class=\"mj-cv-mode-picker__label\">{{ CurrentLabel }}</span>\n                    <i class=\"fa-solid fa-caret-down mj-cv-mode-picker__caret\"></i>\n                </button>\n                @if (IsOpen) {\n                    <div class=\"mj-cv-mode-picker__menu\" (click)=\"$event.stopPropagation()\">\n                        <div class=\"mj-cv-mode-picker__menu-header\">Mode for the next message</div>\n                        @for (p of Presets; track p.ID) {\n                            <button\n                                type=\"button\"\n                                class=\"mj-cv-mode-picker__item\"\n                                [class.mj-cv-mode-picker__item--selected]=\"IsSelected(p)\"\n                                [title]=\"p.Description || p.Name\"\n                                (click)=\"PickPreset(p)\">\n                                <div class=\"mj-cv-mode-picker__item-text\">\n                                    <span class=\"mj-cv-mode-picker__item-name\">{{ p.DisplayName || p.Name }}</span>\n                                    @if (p.Description) {\n                                        <span class=\"mj-cv-mode-picker__item-desc\">{{ p.Description }}</span>\n                                    }\n                                </div>\n                            </button>\n                        }\n                    </div>\n                }\n            </div>\n        }\n    `,\n    styles: [`\n        .mj-cv-mode-picker { position: relative; display: inline-flex; align-items: center; }\n        .mj-cv-mode-picker__trigger {\n            display: inline-flex; align-items: center; gap: 6px;\n            padding: 6px 12px; min-height: 32px; box-sizing: border-box;\n            background: var(--mj-bg-surface-card); border: 1px solid var(--mj-border-default);\n            border-radius: 4px; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 0.8125rem; line-height: 1.5;\n            transition: background 120ms, border-color 120ms;\n        }\n        .mj-cv-mode-picker__trigger:hover:not(:disabled) {\n            background: var(--mj-bg-surface-hover); border-color: var(--mj-border-strong);\n        }\n        .mj-cv-mode-picker__trigger:disabled { opacity: 0.5; cursor: not-allowed; }\n        .mj-cv-mode-picker--open .mj-cv-mode-picker__trigger { border-color: var(--mj-border-focus); }\n        .mj-cv-mode-picker__label { max-width: 110px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n        .mj-cv-mode-picker__caret { font-size: 10px; opacity: 0.7; }\n        .mj-cv-mode-picker__menu {\n            position: absolute; top: calc(100% + 4px); right: 0; z-index: 50;\n            min-width: 280px; max-height: 360px; overflow-y: auto;\n            background: var(--mj-bg-surface-elevated); border: 1px solid var(--mj-border-default);\n            border-radius: 6px; box-shadow: 0 4px 16px rgba(0,0,0,0.12);\n            padding: 4px 0;\n        }\n        .mj-cv-mode-picker__menu-header {\n            padding: 6px 12px 4px; font-size: 11px; text-transform: uppercase;\n            letter-spacing: 0.04em; color: var(--mj-text-muted);\n        }\n        .mj-cv-mode-picker__item {\n            display: flex; align-items: flex-start; gap: 10px; width: 100%;\n            padding: 8px 12px; background: transparent; border: none; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 13px; text-align: left;\n        }\n        .mj-cv-mode-picker__item:hover { background: var(--mj-bg-surface-hover); }\n        .mj-cv-mode-picker__item--selected { background: color-mix(in srgb, var(--mj-brand-primary) 10%, transparent); }\n        .mj-cv-mode-picker__item-text { flex: 1; display: flex; flex-direction: column; gap: 2px; }\n        .mj-cv-mode-picker__item-name { font-weight: 600; }\n        .mj-cv-mode-picker__item-desc { font-size: 11px; color: var(--mj-text-muted); }\n    `]\n})\nexport class ConversationModePickerComponent implements OnInit {\n    /**\n     * The agent the picker should show presets for. When this changes,\n     * the picker re-resolves the available presets and the user's saved\n     * choice for that agent. Null hides the picker entirely.\n     */\n    @Input()\n    public set AgentID(value: string | null) {\n        if (value === this._agentID) return;\n        this._agentID = value;\n        this.refresh();\n    }\n    public get AgentID(): string | null { return this._agentID; }\n\n    /** Disable interactions (e.g. during agent execution). */\n    @Input() Disabled: boolean = false;\n\n    /**\n     * Emitted whenever the user picks a preset. Payload is the\n     * `MJ: AI Agent Configurations.ID` — exactly what\n     * `MessageInputComponent` forwards as `agentConfigurationPresetId`\n     * on the next message route. Null when the picker is cleared or\n     * the active agent has no presets.\n     */\n    @Output() PresetChanged = new EventEmitter<string | null>();\n\n    public Presets: MJAIAgentConfigurationEntity[] = [];\n    public CurrentPreset: MJAIAgentConfigurationEntity | null = null;\n    public IsOpen = false;\n\n    private _agentID: string | null = null;\n    private readonly cdr = inject(ChangeDetectorRef);\n\n    public async ngOnInit(): Promise<void> {\n        await this.refresh();\n    }\n\n    public get CurrentLabel(): string {\n        return this.CurrentPreset?.DisplayName ?? this.CurrentPreset?.Name ?? 'Mode';\n    }\n\n    public get ButtonTitle(): string {\n        if (!this.CurrentPreset) return 'Pick a mode';\n        const base = `Mode: ${this.CurrentLabel}`;\n        const desc = this.CurrentPreset.Description ?? '';\n        return desc ? `${base} — ${desc}\\n\\nClick to change. Applies to the NEXT message.` : `${base} — click to change`;\n    }\n\n    public IsSelected(p: MJAIAgentConfigurationEntity): boolean {\n        return !!this.CurrentPreset && UUIDsEqual(p.ID, this.CurrentPreset.ID);\n    }\n\n    public Toggle(event: MouseEvent): void {\n        event.stopPropagation();\n        if (this.Disabled || this.Presets.length < 2) return;\n        this.IsOpen = !this.IsOpen;\n        this.cdr.markForCheck();\n    }\n\n    public PickPreset(p: MJAIAgentConfigurationEntity): void {\n        this.IsOpen = false;\n        if (this.CurrentPreset && UUIDsEqual(p.ID, this.CurrentPreset.ID)) {\n            this.cdr.markForCheck();\n            return;\n        }\n        this.CurrentPreset = p;\n        // Persist by NAME (not ID) so the preference survives a\n        // metadata refresh that re-stamps preset IDs. Resolution back to\n        // the actual config row on read happens via\n        // GetAgentConfigurationPresetByName at refresh time.\n        if (this._agentID) {\n            UserInfoEngine.Instance.SetSettingDebounced(this.storageKey(this._agentID), p.Name);\n        }\n        this.PresetChanged.emit(p.ID);\n        this.cdr.markForCheck();\n    }\n\n    /** Re-load presets for the active agent and apply the saved choice. */\n    private async refresh(): Promise<void> {\n        if (!this._agentID) {\n            this.Presets = [];\n            this.CurrentPreset = null;\n            this.PresetChanged.emit(null);\n            this.cdr.markForCheck();\n            return;\n        }\n        try {\n            await AIEngineBase.Instance.Config(false);\n            this.Presets = AIEngineBase.Instance.GetAgentConfigurationPresets(this._agentID, true) ?? [];\n            this.CurrentPreset = this.resolveSavedOrDefault();\n            this.PresetChanged.emit(this.CurrentPreset?.ID ?? null);\n            this.cdr.markForCheck();\n        } catch (err) {\n            LogError(`ConversationModePicker.refresh: ${err instanceof Error ? err.message : String(err)}`);\n        }\n    }\n\n    /** User's saved pick (by Name) → preset, or the agent's IsDefault row. */\n    private resolveSavedOrDefault(): MJAIAgentConfigurationEntity | null {\n        if (!this._agentID || this.Presets.length === 0) return null;\n        const savedName = UserInfoEngine.Instance.GetSetting(this.storageKey(this._agentID));\n        if (savedName) {\n            const match = AIEngineBase.Instance.GetAgentConfigurationPresetByName(this._agentID, savedName);\n            if (match) return match;\n        }\n        return this.Presets.find(p => p.IsDefault) ?? this.Presets[0];\n    }\n\n    private storageKey(agentID: string): string {\n        return `mj.agentMode.${agentID.toLowerCase()}`;\n    }\n\n    @HostListener('document:click', ['$event'])\n    public OnDocumentClick(_event: MouseEvent): void {\n        if (this.IsOpen) {\n            this.IsOpen = false;\n            this.cdr.markForCheck();\n        }\n    }\n}\n"]}
+{"version":3,"file":"conversation-mode-picker.component.js","sourceRoot":"","sources":["../../../../src/lib/components/conversation/conversation-mode-picker.component.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    ChangeDetectionStrategy,\n    ChangeDetectorRef,\n    Component,\n    EventEmitter,\n    HostListener,\n    Input,\n    OnInit,\n    Output,\n    inject,\n} from '@angular/core';\nimport { LogError } from '@memberjunction/core';\nimport { AIEngineBase, AgentModeSettingKey } from '@memberjunction/ai-engine-base';\nimport type { MJAIAgentConfigurationEntity } from '@memberjunction/core-entities';\nimport { UserInfoEngine } from '@memberjunction/core-entities';\nimport { UUIDsEqual } from '@memberjunction/global';\n\n/**\n * Per-agent quality/speed mode picker. Sits next to the agent picker in\n * the chat-area header. Lists the **active agent's** configured\n * presets (e.g. Draft / Standard / High) from\n * `AIEngineBase.Instance.GetAgentConfigurationPresets(agentId)` and lets\n * the user pick the one applied to all SUBSEQUENT requests in this\n * conversation. Past messages are not retroactively re-routed.\n *\n * Choice persists per-user, per-agent via `UserInfoEngine` (key\n * `mj.agentMode.<agentId>` = preset name). Cross-device, cross-browser\n * — same model the form-variant preference uses. No DB schema changes.\n *\n * Auto-hides when the active agent has fewer than 2 presets — a\n * single-mode agent doesn't need a switcher.\n */\n@Component({\n    standalone: false,\n    selector: 'mj-conversation-mode-picker',\n    changeDetection: ChangeDetectionStrategy.OnPush,\n    template: `\n        @if (Presets.length >= 2) {\n            <div class=\"mj-cv-mode-picker\" [class.mj-cv-mode-picker--open]=\"IsOpen\">\n                <button\n                    type=\"button\"\n                    class=\"mj-cv-mode-picker__trigger\"\n                    [title]=\"ButtonTitle\"\n                    [disabled]=\"Disabled\"\n                    (click)=\"Toggle($event)\">\n                    <span class=\"mj-cv-mode-picker__label\">{{ CurrentLabel }}</span>\n                    <i class=\"fa-solid fa-caret-down mj-cv-mode-picker__caret\"></i>\n                </button>\n                @if (IsOpen) {\n                    <div class=\"mj-cv-mode-picker__menu\" (click)=\"$event.stopPropagation()\">\n                        <div class=\"mj-cv-mode-picker__menu-header\">Mode for the next message</div>\n                        @for (p of Presets; track p.ID) {\n                            <button\n                                type=\"button\"\n                                class=\"mj-cv-mode-picker__item\"\n                                [class.mj-cv-mode-picker__item--selected]=\"IsSelected(p)\"\n                                [title]=\"p.Description || p.Name\"\n                                (click)=\"PickPreset(p)\">\n                                <div class=\"mj-cv-mode-picker__item-text\">\n                                    <span class=\"mj-cv-mode-picker__item-name\">{{ p.DisplayName || p.Name }}</span>\n                                    @if (p.Description) {\n                                        <span class=\"mj-cv-mode-picker__item-desc\">{{ p.Description }}</span>\n                                    }\n                                </div>\n                            </button>\n                        }\n                    </div>\n                }\n            </div>\n        }\n    `,\n    styles: [`\n        .mj-cv-mode-picker { position: relative; display: inline-flex; align-items: center; }\n        .mj-cv-mode-picker__trigger {\n            display: inline-flex; align-items: center; gap: 6px;\n            padding: 6px 12px; min-height: 32px; box-sizing: border-box;\n            background: var(--mj-bg-surface-card); border: 1px solid var(--mj-border-default);\n            border-radius: 4px; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 0.8125rem; line-height: 1.5;\n            transition: background 120ms, border-color 120ms;\n        }\n        .mj-cv-mode-picker__trigger:hover:not(:disabled) {\n            background: var(--mj-bg-surface-hover); border-color: var(--mj-border-strong);\n        }\n        .mj-cv-mode-picker__trigger:disabled { opacity: 0.5; cursor: not-allowed; }\n        .mj-cv-mode-picker--open .mj-cv-mode-picker__trigger { border-color: var(--mj-border-focus); }\n        .mj-cv-mode-picker__label { max-width: 110px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n        .mj-cv-mode-picker__caret { font-size: 10px; opacity: 0.7; }\n        .mj-cv-mode-picker__menu {\n            position: absolute; top: calc(100% + 4px); right: 0; z-index: 50;\n            min-width: 280px; max-height: 360px; overflow-y: auto;\n            background: var(--mj-bg-surface-elevated); border: 1px solid var(--mj-border-default);\n            border-radius: 6px; box-shadow: 0 4px 16px rgba(0,0,0,0.12);\n            padding: 4px 0;\n        }\n        .mj-cv-mode-picker__menu-header {\n            padding: 6px 12px 4px; font-size: 11px; text-transform: uppercase;\n            letter-spacing: 0.04em; color: var(--mj-text-muted);\n        }\n        .mj-cv-mode-picker__item {\n            display: flex; align-items: flex-start; gap: 10px; width: 100%;\n            padding: 8px 12px; background: transparent; border: none; cursor: pointer;\n            color: var(--mj-text-primary); font-size: 13px; text-align: left;\n        }\n        .mj-cv-mode-picker__item:hover { background: var(--mj-bg-surface-hover); }\n        .mj-cv-mode-picker__item--selected { background: color-mix(in srgb, var(--mj-brand-primary) 10%, transparent); }\n        .mj-cv-mode-picker__item-text { flex: 1; display: flex; flex-direction: column; gap: 2px; }\n        .mj-cv-mode-picker__item-name { font-weight: 600; }\n        .mj-cv-mode-picker__item-desc { font-size: 11px; color: var(--mj-text-muted); }\n    `]\n})\nexport class ConversationModePickerComponent implements OnInit {\n    /**\n     * The agent the picker should show presets for. When this changes,\n     * the picker re-resolves the available presets and the user's saved\n     * choice for that agent. Null hides the picker entirely.\n     */\n    @Input()\n    public set AgentID(value: string | null) {\n        if (value === this._agentID) return;\n        this._agentID = value;\n        this.refresh();\n    }\n    public get AgentID(): string | null { return this._agentID; }\n\n    /** Disable interactions (e.g. during agent execution). */\n    @Input() Disabled: boolean = false;\n\n    /**\n     * Emitted whenever the user picks a preset. Payload is the\n     * `MJ: AI Agent Configurations.ID` — exactly what\n     * `MessageInputComponent` forwards as `agentConfigurationPresetId`\n     * on the next message route. Null when the picker is cleared or\n     * the active agent has no presets.\n     */\n    @Output() PresetChanged = new EventEmitter<string | null>();\n\n    public Presets: MJAIAgentConfigurationEntity[] = [];\n    public CurrentPreset: MJAIAgentConfigurationEntity | null = null;\n    public IsOpen = false;\n\n    private _agentID: string | null = null;\n    private readonly cdr = inject(ChangeDetectorRef);\n\n    public async ngOnInit(): Promise<void> {\n        await this.refresh();\n    }\n\n    public get CurrentLabel(): string {\n        return this.CurrentPreset?.DisplayName ?? this.CurrentPreset?.Name ?? 'Mode';\n    }\n\n    public get ButtonTitle(): string {\n        if (!this.CurrentPreset) return 'Pick a mode';\n        const base = `Mode: ${this.CurrentLabel}`;\n        const desc = this.CurrentPreset.Description ?? '';\n        return desc ? `${base} — ${desc}\\n\\nClick to change. Applies to the NEXT message.` : `${base} — click to change`;\n    }\n\n    public IsSelected(p: MJAIAgentConfigurationEntity): boolean {\n        return !!this.CurrentPreset && UUIDsEqual(p.ID, this.CurrentPreset.ID);\n    }\n\n    public Toggle(event: MouseEvent): void {\n        event.stopPropagation();\n        if (this.Disabled || this.Presets.length < 2) return;\n        this.IsOpen = !this.IsOpen;\n        this.cdr.markForCheck();\n    }\n\n    public PickPreset(p: MJAIAgentConfigurationEntity): void {\n        this.IsOpen = false;\n        if (this.CurrentPreset && UUIDsEqual(p.ID, this.CurrentPreset.ID)) {\n            this.cdr.markForCheck();\n            return;\n        }\n        this.CurrentPreset = p;\n        // Persist by NAME (not ID) so the preference survives a\n        // metadata refresh that re-stamps preset IDs. Resolution back to\n        // the actual config row on read happens via\n        // GetAgentConfigurationPresetByName at refresh time.\n        if (this._agentID) {\n            UserInfoEngine.Instance.SetSettingDebounced(this.storageKey(this._agentID), p.Name);\n        }\n        this.PresetChanged.emit(p.ID);\n        this.cdr.markForCheck();\n    }\n\n    /** Re-load presets for the active agent and apply the saved choice. */\n    private async refresh(): Promise<void> {\n        if (!this._agentID) {\n            this.Presets = [];\n            this.CurrentPreset = null;\n            this.PresetChanged.emit(null);\n            this.cdr.markForCheck();\n            return;\n        }\n        try {\n            await AIEngineBase.Instance.Config(false);\n            this.Presets = AIEngineBase.Instance.GetAgentConfigurationPresets(this._agentID, true) ?? [];\n            this.CurrentPreset = this.resolveSavedOrDefault();\n            this.PresetChanged.emit(this.CurrentPreset?.ID ?? null);\n            this.cdr.markForCheck();\n        } catch (err) {\n            LogError(`ConversationModePicker.refresh: ${err instanceof Error ? err.message : String(err)}`);\n        }\n    }\n\n    /** User's saved pick (by Name) → preset, or the agent's IsDefault row. */\n    private resolveSavedOrDefault(): MJAIAgentConfigurationEntity | null {\n        if (!this._agentID || this.Presets.length === 0) return null;\n        const savedName = UserInfoEngine.Instance.GetSetting(this.storageKey(this._agentID));\n        if (savedName) {\n            const match = AIEngineBase.Instance.GetAgentConfigurationPresetByName(this._agentID, savedName);\n            if (match) return match;\n        }\n        return this.Presets.find(p => p.IsDefault) ?? this.Presets[0];\n    }\n\n    private storageKey(agentID: string): string {\n        return AgentModeSettingKey(agentID);\n    }\n\n    @HostListener('document:click', ['$event'])\n    public OnDocumentClick(_event: MouseEvent): void {\n        if (this.IsOpen) {\n            this.IsOpen = false;\n            this.cdr.markForCheck();\n        }\n    }\n}\n"]}

package/dist/lib/components/conversation/conversation-remote-browser-controller.d.ts

@@ -0,0 +1,109 @@
+import { JSONValue } from '@memberjunction/ai';
+import { GraphQLDataProvider } from '@memberjunction/graphql-dataprovider';
+import { AgentClientService } from '@memberjunction/ng-agent-client';
+import { RemoteBrowserSurfaceComponent } from '../realtime/remote-browser/remote-browser-surface.component';
+/** What a text agent is told about the conversation's browser, as `appContext.AdditionalContext.RemoteBrowser`. */
+export interface ConversationRemoteBrowserContextSnapshot {
+    Open: boolean;
+    CurrentUrl: string | null;
+}
+/**
+ * Options for constructing a {@link ConversationRemoteBrowserController}.
+ */
+export interface ConversationRemoteBrowserControllerOptions {
+    /** Invoked when an agent's `browser_*` tool runs, so the UI can show the browser drawer. */
+    OnAutoOpenSurface?: () => void;
+    /** Invoked when the browser opens or closes, or its URL changes. */
+    OnStateChange?: () => void;
+    /**
+     * Invoked once when the server refuses this conversation a browser (not enabled, not the caller's, over
+     * the cap). The controller has already closed it, which stops the live view's polling.
+     */
+    OnSessionRefused?: (message: string) => void;
+    /** Optional custom GraphQL executor (used by unit tests; defaults to the provider's `ExecuteGQL`). */
+    ExecuteServerAction?: <T>(query: string, variables: Record<string, JSONValue>) => Promise<T | null>;
+}
+/**
+ * Gives one text conversation (`MJ: Conversations`) a live Remote Browser its agents can drive.
+ *
+ * The browser belongs to the conversation that opened it ({@link Open}); the controller captures that
+ * ID, so a later conversation switch still stops and ends the right browser ({@link Close}).
+ *
+ * Agents reach the browser through the `browser_*` client tools. Their handlers live in
+ * `AgentClientService`, whose registry is app-wide, so they are registered only while this
+ * controller's browser is open, and removed on close only if this controller still owns them (a chat
+ * area that opened a browser later takes them over). The tools are advertised to this conversation's
+ * agent runs alone, through `appContext.Capabilities.Tools` ({@link WithBrowserContext}).
+ */
+export declare class ConversationRemoteBrowserController {
+    private readonly channel;
+    private readonly options;
+    private readonly handlers;
+    private agentClient;
+    private provider;
+    private pushSub;
+    private conversationId;
+    private currentUrl;
+    private stateVersion;
+    private disposed;
+    constructor(options?: ConversationRemoteBrowserControllerOptions);
+    /** The conversation whose browser is open, or `null` when none is. */
+    get ConversationId(): string | null;
+    /** The browser's last known URL. */
+    get CurrentUrl(): string | null;
+    /** Bumps on every open, close and URL change, so a host can cache what it derives from the state. */
+    get StateVersion(): number;
+    /** Whether the app-wide registry holds THIS controller's `browser_*` handlers. */
+    get OwnsTools(): boolean;
+    /** Connects the controller to the agent client (tool dispatch) and the provider (server calls, pushed frames). */
+    Initialize(agentClient: AgentClientService, provider: GraphQLDataProvider | null): void;
+    /**
+     * Opens the browser for `conversationId` and claims the `browser_*` tools. A browser this controller
+     * held for a different conversation is ended first.
+     */
+    Open(conversationId: string): void;
+    /**
+     * Ends the conversation's browser: stops its streams, gives up the tools this controller still owns,
+     * and ends the server browser so no Chromium process (or billed hosted browser) is left running.
+     */
+    Close(): Promise<void>;
+    /** Binds the drawer's live surface (starts the screencast, audio and human takeover). */
+    BindSurface(surface: RemoteBrowserSurfaceComponent): void;
+    /** Unbinds the surface when the drawer is hidden; the browser itself stays open. */
+    UnbindSurface(): void;
+    /** Navigates the browser, e.g. from the drawer's URL bar; a refusal or failure comes back in `ErrorMessage`. */
+    Navigate(url: string): Promise<{
+        Success: boolean;
+        ErrorMessage?: string;
+    }>;
+    /** Runs one `browser_*` tool against this conversation's browser. */
+    ExecuteBrowserTool(toolName: string, params: Record<string, unknown>): Promise<{
+        Success: boolean;
+        Data?: JSONValue;
+        ErrorMessage?: string;
+    }>;
+    /** What the agent is told about the browser. */
+    GetAppContextSnapshot(): ConversationRemoteBrowserContextSnapshot;
+    /**
+     * Adds the browser to an app context while it is open: its state under
+     * `AdditionalContext.RemoteBrowser`, and, while this controller owns them, the `browser_*` tools
+     * under `Capabilities.Tools`, the tier an agent run reads a surface's tools from. Returns `base`
+     * unchanged while no browser is open.
+     */
+    WithBrowserContext(base: Record<string, unknown> | null): Record<string, unknown> | null;
+    /** Ends the browser and releases the tools, push subscription and channel. */
+    Dispose(): void;
+    /**
+     * Routes a pushed `RemoteBrowserScreencastFrame` or `RemoteBrowserAudioChunk` to the channel when it
+     * belongs to this controller's browser.
+     */
+    HandlePushMessage(rawMessage: string): void;
+    /** Records a new URL; frames repeat the same one, so only a real change notifies the host. */
+    private setUrl;
+    private changed;
+    private registerBrowserTools;
+    private unregisterBrowserTools;
+    private executeServerAction;
+    private createChannelContext;
+}
+//# sourceMappingURL=conversation-remote-browser-controller.d.ts.map

package/dist/lib/components/conversation/conversation-remote-browser-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-remote-browser-controller.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/conversation/conversation-remote-browser-controller.ts"],"names":[],"mappings":"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"}

package/dist/lib/components/conversation/conversation-remote-browser-controller.js

@@ -0,0 +1,298 @@
+import { UUIDsEqual } from '@memberjunction/global';
+import { SafeGraphQLError } from '@memberjunction/graphql-dataprovider';
+import { RemoteBrowserChannel } from '../realtime/remote-browser/remote-browser-channel';
+import { REMOTE_BROWSER_TOOL_DEFINITIONS, REMOTE_BROWSER_TOOL_NAMES } from '../realtime/remote-browser/remote-browser-tools';
+/**
+ * The `extensions.code` the server sets on a refusal that asking again cannot change (browsers not enabled,
+ * not the caller's, over a cap): MJServer's `RemoteBrowserRefusedError`.
+ */
+const REMOTE_BROWSER_REFUSED = 'REMOTE_BROWSER_REFUSED';
+const END_REMOTE_BROWSER_SESSION_MUTATION = `
+  mutation EndRemoteBrowserSession($agentSessionID: String!) {
+    EndRemoteBrowserSession(agentSessionID: $agentSessionID)
+  }
+`;
+/**
+ * The `browser_*` tools a text conversation's agents get: all but AchieveGoal, whose goal loop clicks
+ * and navigates on its own, past the click guard (the server refuses goal runs for a conversation too).
+ */
+const TEXT_BROWSER_TOOLS = REMOTE_BROWSER_TOOL_DEFINITIONS.filter((def) => def.Name !== REMOTE_BROWSER_TOOL_NAMES.AchieveGoal);
+/** The text browser tools in the shape an agent run reads from `appContext.Capabilities.Tools`. */
+const BROWSER_TOOL_METADATA = TEXT_BROWSER_TOOLS.map((def) => ({
+    Name: def.Name,
+    Description: def.Description,
+    InputSchema: (def.ParametersSchema ?? {}),
+}));
+/**
+ * Gives one text conversation (`MJ: Conversations`) a live Remote Browser its agents can drive.
+ *
+ * The browser belongs to the conversation that opened it ({@link Open}); the controller captures that
+ * ID, so a later conversation switch still stops and ends the right browser ({@link Close}).
+ *
+ * Agents reach the browser through the `browser_*` client tools. Their handlers live in
+ * `AgentClientService`, whose registry is app-wide, so they are registered only while this
+ * controller's browser is open, and removed on close only if this controller still owns them (a chat
+ * area that opened a browser later takes them over). The tools are advertised to this conversation's
+ * agent runs alone, through `appContext.Capabilities.Tools` ({@link WithBrowserContext}).
+ */
+export class ConversationRemoteBrowserController {
+    channel = new RemoteBrowserChannel();
+    options;
+    handlers = new Map();
+    agentClient = null;
+    provider = null;
+    pushSub = null;
+    conversationId = null;
+    currentUrl = null;
+    stateVersion = 0;
+    disposed = false;
+    constructor(options = {}) {
+        this.options = options;
+        this.channel.Initialize(this.createChannelContext());
+    }
+    /** The conversation whose browser is open, or `null` when none is. */
+    get ConversationId() {
+        return this.conversationId;
+    }
+    /** The browser's last known URL. */
+    get CurrentUrl() {
+        return this.currentUrl;
+    }
+    /** Bumps on every open, close and URL change, so a host can cache what it derives from the state. */
+    get StateVersion() {
+        return this.stateVersion;
+    }
+    /** Whether the app-wide registry holds THIS controller's `browser_*` handlers. */
+    get OwnsTools() {
+        const registered = this.agentClient?.GetRegisteredTools() ?? [];
+        return this.handlers.size > 0 && Array.from(this.handlers).every(([name, handler]) => registered.find((t) => t.Name === name)?.Handler === handler);
+    }
+    /** Connects the controller to the agent client (tool dispatch) and the provider (server calls, pushed frames). */
+    Initialize(agentClient, provider) {
+        this.agentClient = agentClient;
+        this.provider = provider;
+        this.pushSub?.unsubscribe();
+        this.pushSub = provider?.PushStatusUpdates().subscribe((raw) => this.HandlePushMessage(raw)) ?? null;
+    }
+    /**
+     * Opens the browser for `conversationId` and claims the `browser_*` tools. A browser this controller
+     * held for a different conversation is ended first.
+     */
+    Open(conversationId) {
+        if (this.conversationId && UUIDsEqual(this.conversationId, conversationId)) {
+            this.registerBrowserTools();
+            return;
+        }
+        void this.Close();
+        this.conversationId = conversationId;
+        this.registerBrowserTools();
+        this.changed();
+    }
+    /**
+     * Ends the conversation's browser: stops its streams, gives up the tools this controller still owns,
+     * and ends the server browser so no Chromium process (or billed hosted browser) is left running.
+     */
+    async Close() {
+        const conversationId = this.conversationId;
+        if (!conversationId) {
+            return;
+        }
+        // Unbinding reads the session ID synchronously, so it must run before the ID is cleared.
+        this.channel.UnbindSurface();
+        this.unregisterBrowserTools();
+        this.conversationId = null;
+        this.currentUrl = null;
+        this.changed();
+        await this.executeServerAction(END_REMOTE_BROWSER_SESSION_MUTATION, { agentSessionID: conversationId });
+    }
+    /** Binds the drawer's live surface (starts the screencast, audio and human takeover). */
+    BindSurface(surface) {
+        this.channel.BindSurface(surface);
+        if (this.currentUrl) {
+            surface.SetCurrentUrl(this.currentUrl);
+        }
+    }
+    /** Unbinds the surface when the drawer is hidden; the browser itself stays open. */
+    UnbindSurface() {
+        this.channel.UnbindSurface();
+    }
+    /** Navigates the browser, e.g. from the drawer's URL bar; a refusal or failure comes back in `ErrorMessage`. */
+    async Navigate(url) {
+        const result = await this.ExecuteBrowserTool(REMOTE_BROWSER_TOOL_NAMES.OpenUrl, { url });
+        return { Success: result.Success, ErrorMessage: result.ErrorMessage };
+    }
+    /** Runs one `browser_*` tool against this conversation's browser. */
+    async ExecuteBrowserTool(toolName, params) {
+        if (!this.conversationId) {
+            return { Success: false, ErrorMessage: 'No browser is open for this conversation.' };
+        }
+        this.options.OnAutoOpenSurface?.();
+        const raw = await this.channel.ApplyAgentTool(toolName, JSON.stringify(params ?? {}));
+        let result;
+        try {
+            result = JSON.parse(raw);
+        }
+        catch {
+            return { Success: true, Data: { raw } };
+        }
+        this.setUrl(result.currentUrl);
+        return result.success === false
+            ? { Success: false, Data: result, ErrorMessage: result.error ?? result.detail ?? 'Browser tool execution failed.' }
+            : { Success: true, Data: result };
+    }
+    /** What the agent is told about the browser. */
+    GetAppContextSnapshot() {
+        return { Open: this.conversationId !== null, CurrentUrl: this.currentUrl };
+    }
+    /**
+     * Adds the browser to an app context while it is open: its state under
+     * `AdditionalContext.RemoteBrowser`, and, while this controller owns them, the `browser_*` tools
+     * under `Capabilities.Tools`, the tier an agent run reads a surface's tools from. Returns `base`
+     * unchanged while no browser is open.
+     */
+    WithBrowserContext(base) {
+        if (!this.conversationId) {
+            return base;
+        }
+        const context = base ?? {};
+        const additional = asRecord(context['AdditionalContext']);
+        const capabilities = asRecord(context['Capabilities']);
+        const tools = Array.isArray(capabilities['Tools']) ? capabilities['Tools'] : [];
+        return {
+            ...context,
+            AdditionalContext: { ...additional, RemoteBrowser: this.GetAppContextSnapshot() },
+            ...(this.OwnsTools ? { Capabilities: { ...capabilities, Tools: [...tools, ...BROWSER_TOOL_METADATA] } } : {}),
+        };
+    }
+    /** Ends the browser and releases the tools, push subscription and channel. */
+    Dispose() {
+        this.disposed = true;
+        void this.Close();
+        this.pushSub?.unsubscribe();
+        this.pushSub = null;
+        this.channel.Dispose();
+    }
+    /**
+     * Routes a pushed `RemoteBrowserScreencastFrame` or `RemoteBrowserAudioChunk` to the channel when it
+     * belongs to this controller's browser.
+     */
+    HandlePushMessage(rawMessage) {
+        if (!this.conversationId || !rawMessage) {
+            return;
+        }
+        let message;
+        try {
+            const outer = JSON.parse(rawMessage);
+            message = typeof outer['message'] === 'string' ? JSON.parse(outer['message']) : outer;
+        }
+        catch {
+            return; // Not JSON: an unrelated status update.
+        }
+        if (message.resolver !== 'RemoteBrowserActionResolver' || !message.agentSessionID || !UUIDsEqual(message.agentSessionID, this.conversationId)) {
+            return;
+        }
+        if (typeof message.dataBase64 !== 'string') {
+            return;
+        }
+        if (message.type === 'RemoteBrowserScreencastFrame') {
+            this.channel.OnScreencastFrame(message.dataBase64, message.currentUrl ?? null);
+            this.setUrl(message.currentUrl);
+        }
+        else if (message.type === 'RemoteBrowserAudioChunk') {
+            this.channel.OnAudioChunk({
+                dataBase64: message.dataBase64,
+                codec: 'webm-opus',
+                sampleRate: message.sampleRate ?? 48000,
+                channels: message.channels ?? 2,
+                seq: message.seq ?? 0,
+            });
+        }
+    }
+    /** Records a new URL; frames repeat the same one, so only a real change notifies the host. */
+    setUrl(url) {
+        const next = url?.trim();
+        if (next && next !== this.currentUrl) {
+            this.currentUrl = next;
+            this.changed();
+        }
+    }
+    changed() {
+        this.stateVersion++;
+        if (!this.disposed) {
+            this.options.OnStateChange?.();
+        }
+    }
+    registerBrowserTools() {
+        const agentClient = this.agentClient;
+        if (!agentClient) {
+            return;
+        }
+        for (const def of TEXT_BROWSER_TOOLS) {
+            let handler = this.handlers.get(def.Name);
+            if (!handler) {
+                handler = (params) => this.ExecuteBrowserTool(def.Name, params);
+                this.handlers.set(def.Name, handler);
+            }
+            agentClient.RegisterTool({ Name: def.Name, Description: def.Description, ParameterSchema: (def.ParametersSchema ?? {}), Handler: handler });
+        }
+        const sessionId = this.provider?.sessionId;
+        if (sessionId && (!agentClient.IsActive || agentClient.SessionId !== sessionId)) {
+            agentClient.StartSession(sessionId);
+        }
+    }
+    unregisterBrowserTools() {
+        const registered = this.agentClient?.GetRegisteredTools() ?? [];
+        for (const [name, handler] of this.handlers) {
+            if (registered.find((t) => t.Name === name)?.Handler === handler) {
+                this.agentClient?.UnregisterTool(name);
+            }
+        }
+    }
+    async executeServerAction(query, variables) {
+        try {
+            if (this.options.ExecuteServerAction) {
+                return await this.options.ExecuteServerAction(query, variables);
+            }
+            return this.provider ? ((await this.provider.ExecuteGQL(query, variables)) ?? null) : null;
+        }
+        catch (err) {
+            if (err instanceof SafeGraphQLError && err.Code === REMOTE_BROWSER_REFUSED) {
+                // Asking again gets the same answer: close, so the live view stops polling, and say why once. Only
+                // for the browser still open: a refusal for one already left (its End, after a switch) changes nothing.
+                if (UUIDsEqual(variables['agentSessionID'], this.conversationId)) {
+                    void this.Close();
+                    this.options.OnSessionRefused?.(err.message);
+                }
+            }
+            else {
+                console.warn('[ConversationRemoteBrowserController] GraphQL execution failed:', err);
+            }
+            return null;
+        }
+    }
+    createChannelContext() {
+        const self = this;
+        return {
+            AgentName: 'ConversationAgent',
+            get Provider() {
+                return self.provider;
+            },
+            get AgentSessionID() {
+                return self.conversationId;
+            },
+            // The channel narrates page changes as notes; a text conversation only needs the URL out of them.
+            SendContextNote: (text) => {
+                const match = /^\[browser\] (?:current page|the page changed to): (\S+)/.exec(text);
+                self.setUrl(match?.[1]);
+            },
+            RequestSave: () => undefined,
+            SetFocusMode: () => undefined,
+            SaveAsArtifact: async () => null,
+            ExecuteServerAction: (query, variables) => self.executeServerAction(query, variables),
+        };
+    }
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+//# sourceMappingURL=conversation-remote-browser-controller.js.map

package/dist/lib/components/conversation/conversation-remote-browser-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-remote-browser-controller.js","sourceRoot":"","sources":["../../../../src/lib/components/conversation/conversation-remote-browser-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { Subscription } from 'rxjs';\nimport { JSONObject, JSONValue } from '@memberjunction/ai';\nimport { ClientToolMetadata } from '@memberjunction/ai-core-plus';\nimport { UUIDsEqual } from '@memberjunction/global';\nimport { GraphQLDataProvider, SafeGraphQLError } from '@memberjunction/graphql-dataprovider';\nimport { AgentClientService } from '@memberjunction/ng-agent-client';\nimport { RealtimeChannelContext } from '@memberjunction/realtime-runtime';\nimport { RemoteBrowserChannel } from '../realtime/remote-browser/remote-browser-channel';\nimport { RemoteBrowserSurfaceComponent } from '../realtime/remote-browser/remote-browser-surface.component';\nimport { REMOTE_BROWSER_TOOL_DEFINITIONS, REMOTE_BROWSER_TOOL_NAMES } from '../realtime/remote-browser/remote-browser-tools';\n\n/** What a text agent is told about the conversation's browser, as `appContext.AdditionalContext.RemoteBrowser`. */\nexport interface ConversationRemoteBrowserContextSnapshot {\n  Open: boolean;\n  CurrentUrl: string | null;\n}\n\n/**\n * Options for constructing a {@link ConversationRemoteBrowserController}.\n */\nexport interface ConversationRemoteBrowserControllerOptions {\n  /** Invoked when an agent's `browser_*` tool runs, so the UI can show the browser drawer. */\n  OnAutoOpenSurface?: () => void;\n  /** Invoked when the browser opens or closes, or its URL changes. */\n  OnStateChange?: () => void;\n  /**\n   * Invoked once when the server refuses this conversation a browser (not enabled, not the caller's, over\n   * the cap). The controller has already closed it, which stops the live view's polling.\n   */\n  OnSessionRefused?: (message: string) => void;\n  /** Optional custom GraphQL executor (used by unit tests; defaults to the provider's `ExecuteGQL`). */\n  ExecuteServerAction?: <T>(query: string, variables: Record<string, JSONValue>) => Promise<T | null>;\n}\n\n/**\n * The `extensions.code` the server sets on a refusal that asking again cannot change (browsers not enabled,\n * not the caller's, over a cap): MJServer's `RemoteBrowserRefusedError`.\n */\nconst REMOTE_BROWSER_REFUSED = 'REMOTE_BROWSER_REFUSED';\n\nconst END_REMOTE_BROWSER_SESSION_MUTATION = `\n  mutation EndRemoteBrowserSession($agentSessionID: String!) {\n    EndRemoteBrowserSession(agentSessionID: $agentSessionID)\n  }\n`;\n\n/**\n * The `browser_*` tools a text conversation's agents get: all but AchieveGoal, whose goal loop clicks\n * and navigates on its own, past the click guard (the server refuses goal runs for a conversation too).\n */\nconst TEXT_BROWSER_TOOLS = REMOTE_BROWSER_TOOL_DEFINITIONS.filter((def) => def.Name !== REMOTE_BROWSER_TOOL_NAMES.AchieveGoal);\n\n/** The text browser tools in the shape an agent run reads from `appContext.Capabilities.Tools`. */\nconst BROWSER_TOOL_METADATA: ClientToolMetadata[] = TEXT_BROWSER_TOOLS.map((def) => ({\n  Name: def.Name,\n  Description: def.Description,\n  InputSchema: (def.ParametersSchema ?? {}) as Record<string, unknown>,\n}));\n\ntype ClientToolHandler = ReturnType<AgentClientService['GetRegisteredTools']>[number]['Handler'];\n\n/**\n * Gives one text conversation (`MJ: Conversations`) a live Remote Browser its agents can drive.\n *\n * The browser belongs to the conversation that opened it ({@link Open}); the controller captures that\n * ID, so a later conversation switch still stops and ends the right browser ({@link Close}).\n *\n * Agents reach the browser through the `browser_*` client tools. Their handlers live in\n * `AgentClientService`, whose registry is app-wide, so they are registered only while this\n * controller's browser is open, and removed on close only if this controller still owns them (a chat\n * area that opened a browser later takes them over). The tools are advertised to this conversation's\n * agent runs alone, through `appContext.Capabilities.Tools` ({@link WithBrowserContext}).\n */\nexport class ConversationRemoteBrowserController {\n  private readonly channel = new RemoteBrowserChannel();\n  private readonly options: ConversationRemoteBrowserControllerOptions;\n  private readonly handlers = new Map<string, ClientToolHandler>();\n  private agentClient: AgentClientService | null = null;\n  private provider: GraphQLDataProvider | null = null;\n  private pushSub: Subscription | null = null;\n  private conversationId: string | null = null;\n  private currentUrl: string | null = null;\n  private stateVersion = 0;\n  private disposed = false;\n\n  constructor(options: ConversationRemoteBrowserControllerOptions = {}) {\n    this.options = options;\n    this.channel.Initialize(this.createChannelContext());\n  }\n\n  /** The conversation whose browser is open, or `null` when none is. */\n  public get ConversationId(): string | null {\n    return this.conversationId;\n  }\n\n  /** The browser's last known URL. */\n  public get CurrentUrl(): string | null {\n    return this.currentUrl;\n  }\n\n  /** Bumps on every open, close and URL change, so a host can cache what it derives from the state. */\n  public get StateVersion(): number {\n    return this.stateVersion;\n  }\n\n  /** Whether the app-wide registry holds THIS controller's `browser_*` handlers. */\n  public get OwnsTools(): boolean {\n    const registered = this.agentClient?.GetRegisteredTools() ?? [];\n    return this.handlers.size > 0 && Array.from(this.handlers).every(([name, handler]) => registered.find((t) => t.Name === name)?.Handler === handler);\n  }\n\n  /** Connects the controller to the agent client (tool dispatch) and the provider (server calls, pushed frames). */\n  public Initialize(agentClient: AgentClientService, provider: GraphQLDataProvider | null): void {\n    this.agentClient = agentClient;\n    this.provider = provider;\n    this.pushSub?.unsubscribe();\n    this.pushSub = provider?.PushStatusUpdates().subscribe((raw: string) => this.HandlePushMessage(raw)) ?? null;\n  }\n\n  /**\n   * Opens the browser for `conversationId` and claims the `browser_*` tools. A browser this controller\n   * held for a different conversation is ended first.\n   */\n  public Open(conversationId: string): void {\n    if (this.conversationId && UUIDsEqual(this.conversationId, conversationId)) {\n      this.registerBrowserTools();\n      return;\n    }\n    void this.Close();\n    this.conversationId = conversationId;\n    this.registerBrowserTools();\n    this.changed();\n  }\n\n  /**\n   * Ends the conversation's browser: stops its streams, gives up the tools this controller still owns,\n   * and ends the server browser so no Chromium process (or billed hosted browser) is left running.\n   */\n  public async Close(): Promise<void> {\n    const conversationId = this.conversationId;\n    if (!conversationId) {\n      return;\n    }\n    // Unbinding reads the session ID synchronously, so it must run before the ID is cleared.\n    this.channel.UnbindSurface();\n    this.unregisterBrowserTools();\n    this.conversationId = null;\n    this.currentUrl = null;\n    this.changed();\n    await this.executeServerAction(END_REMOTE_BROWSER_SESSION_MUTATION, { agentSessionID: conversationId });\n  }\n\n  /** Binds the drawer's live surface (starts the screencast, audio and human takeover). */\n  public BindSurface(surface: RemoteBrowserSurfaceComponent): void {\n    this.channel.BindSurface(surface);\n    if (this.currentUrl) {\n      surface.SetCurrentUrl(this.currentUrl);\n    }\n  }\n\n  /** Unbinds the surface when the drawer is hidden; the browser itself stays open. */\n  public UnbindSurface(): void {\n    this.channel.UnbindSurface();\n  }\n\n  /** Navigates the browser, e.g. from the drawer's URL bar; a refusal or failure comes back in `ErrorMessage`. */\n  public async Navigate(url: string): Promise<{ Success: boolean; ErrorMessage?: string }> {\n    const result = await this.ExecuteBrowserTool(REMOTE_BROWSER_TOOL_NAMES.OpenUrl, { url });\n    return { Success: result.Success, ErrorMessage: result.ErrorMessage };\n  }\n\n  /** Runs one `browser_*` tool against this conversation's browser. */\n  public async ExecuteBrowserTool(toolName: string, params: Record<string, unknown>): Promise<{ Success: boolean; Data?: JSONValue; ErrorMessage?: string }> {\n    if (!this.conversationId) {\n      return { Success: false, ErrorMessage: 'No browser is open for this conversation.' };\n    }\n    this.options.OnAutoOpenSurface?.();\n    const raw = await this.channel.ApplyAgentTool(toolName, JSON.stringify(params ?? {}));\n    let result: { success?: boolean; currentUrl?: string; detail?: string; error?: string };\n    try {\n      result = JSON.parse(raw);\n    } catch {\n      return { Success: true, Data: { raw } };\n    }\n    this.setUrl(result.currentUrl);\n    return result.success === false\n      ? { Success: false, Data: result as JSONObject, ErrorMessage: result.error ?? result.detail ?? 'Browser tool execution failed.' }\n      : { Success: true, Data: result as JSONObject };\n  }\n\n  /** What the agent is told about the browser. */\n  public GetAppContextSnapshot(): ConversationRemoteBrowserContextSnapshot {\n    return { Open: this.conversationId !== null, CurrentUrl: this.currentUrl };\n  }\n\n  /**\n   * Adds the browser to an app context while it is open: its state under\n   * `AdditionalContext.RemoteBrowser`, and, while this controller owns them, the `browser_*` tools\n   * under `Capabilities.Tools`, the tier an agent run reads a surface's tools from. Returns `base`\n   * unchanged while no browser is open.\n   */\n  public WithBrowserContext(base: Record<string, unknown> | null): Record<string, unknown> | null {\n    if (!this.conversationId) {\n      return base;\n    }\n    const context = base ?? {};\n    const additional = asRecord(context['AdditionalContext']);\n    const capabilities = asRecord(context['Capabilities']);\n    const tools = Array.isArray(capabilities['Tools']) ? (capabilities['Tools'] as ClientToolMetadata[]) : [];\n    return {\n      ...context,\n      AdditionalContext: { ...additional, RemoteBrowser: this.GetAppContextSnapshot() },\n      ...(this.OwnsTools ? { Capabilities: { ...capabilities, Tools: [...tools, ...BROWSER_TOOL_METADATA] } } : {}),\n    };\n  }\n\n  /** Ends the browser and releases the tools, push subscription and channel. */\n  public Dispose(): void {\n    this.disposed = true;\n    void this.Close();\n    this.pushSub?.unsubscribe();\n    this.pushSub = null;\n    this.channel.Dispose();\n  }\n\n  /**\n   * Routes a pushed `RemoteBrowserScreencastFrame` or `RemoteBrowserAudioChunk` to the channel when it\n   * belongs to this controller's browser.\n   */\n  public HandlePushMessage(rawMessage: string): void {\n    if (!this.conversationId || !rawMessage) {\n      return;\n    }\n    let message: {\n      resolver?: string;\n      type?: string;\n      agentSessionID?: string;\n      currentUrl?: string | null;\n      dataBase64?: string;\n      sampleRate?: number;\n      channels?: number;\n      seq?: number;\n    };\n    try {\n      const outer = JSON.parse(rawMessage) as Record<string, unknown>;\n      message = typeof outer['message'] === 'string' ? JSON.parse(outer['message']) : outer;\n    } catch {\n      return; // Not JSON: an unrelated status update.\n    }\n    if (message.resolver !== 'RemoteBrowserActionResolver' || !message.agentSessionID || !UUIDsEqual(message.agentSessionID, this.conversationId)) {\n      return;\n    }\n    if (typeof message.dataBase64 !== 'string') {\n      return;\n    }\n    if (message.type === 'RemoteBrowserScreencastFrame') {\n      this.channel.OnScreencastFrame(message.dataBase64, message.currentUrl ?? null);\n      this.setUrl(message.currentUrl);\n    } else if (message.type === 'RemoteBrowserAudioChunk') {\n      this.channel.OnAudioChunk({\n        dataBase64: message.dataBase64,\n        codec: 'webm-opus',\n        sampleRate: message.sampleRate ?? 48000,\n        channels: message.channels ?? 2,\n        seq: message.seq ?? 0,\n      });\n    }\n  }\n\n  /** Records a new URL; frames repeat the same one, so only a real change notifies the host. */\n  private setUrl(url: string | null | undefined): void {\n    const next = url?.trim();\n    if (next && next !== this.currentUrl) {\n      this.currentUrl = next;\n      this.changed();\n    }\n  }\n\n  private changed(): void {\n    this.stateVersion++;\n    if (!this.disposed) {\n      this.options.OnStateChange?.();\n    }\n  }\n\n  private registerBrowserTools(): void {\n    const agentClient = this.agentClient;\n    if (!agentClient) {\n      return;\n    }\n    for (const def of TEXT_BROWSER_TOOLS) {\n      let handler = this.handlers.get(def.Name);\n      if (!handler) {\n        handler = (params: Record<string, unknown>) => this.ExecuteBrowserTool(def.Name, params);\n        this.handlers.set(def.Name, handler);\n      }\n      agentClient.RegisterTool({ Name: def.Name, Description: def.Description, ParameterSchema: (def.ParametersSchema ?? {}) as JSONObject, Handler: handler });\n    }\n    const sessionId = this.provider?.sessionId;\n    if (sessionId && (!agentClient.IsActive || agentClient.SessionId !== sessionId)) {\n      agentClient.StartSession(sessionId);\n    }\n  }\n\n  private unregisterBrowserTools(): void {\n    const registered = this.agentClient?.GetRegisteredTools() ?? [];\n    for (const [name, handler] of this.handlers) {\n      if (registered.find((t) => t.Name === name)?.Handler === handler) {\n        this.agentClient?.UnregisterTool(name);\n      }\n    }\n  }\n\n  private async executeServerAction<T>(query: string, variables: Record<string, JSONValue>): Promise<T | null> {\n    try {\n      if (this.options.ExecuteServerAction) {\n        return await this.options.ExecuteServerAction<T>(query, variables);\n      }\n      return this.provider ? (((await this.provider.ExecuteGQL(query, variables)) as T) ?? null) : null;\n    } catch (err) {\n      if (err instanceof SafeGraphQLError && err.Code === REMOTE_BROWSER_REFUSED) {\n        // Asking again gets the same answer: close, so the live view stops polling, and say why once. Only\n        // for the browser still open: a refusal for one already left (its End, after a switch) changes nothing.\n        if (UUIDsEqual(variables['agentSessionID'] as string | null, this.conversationId)) {\n          void this.Close();\n          this.options.OnSessionRefused?.(err.message);\n        }\n      } else {\n        console.warn('[ConversationRemoteBrowserController] GraphQL execution failed:', err);\n      }\n      return null;\n    }\n  }\n\n  private createChannelContext(): RealtimeChannelContext {\n    const self = this;\n    return {\n      AgentName: 'ConversationAgent',\n      get Provider(): GraphQLDataProvider | null {\n        return self.provider;\n      },\n      get AgentSessionID(): string | null {\n        return self.conversationId;\n      },\n      // The channel narrates page changes as notes; a text conversation only needs the URL out of them.\n      SendContextNote: (text: string) => {\n        const match = /^\\[browser\\] (?:current page|the page changed to): (\\S+)/.exec(text);\n        self.setUrl(match?.[1]);\n      },\n      RequestSave: () => undefined,\n      SetFocusMode: () => undefined,\n      SaveAsArtifact: async () => null,\n      ExecuteServerAction: <T>(query: string, variables: Record<string, JSONValue>) => self.executeServerAction<T>(query, variables),\n    };\n  }\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};\n}\n"]}