@memberjunction/ng-dashboards 6.2.0-edge.3 → 6.2.0-edge.4

package/dist/DashboardBrowser/dashboard-browser-agent-context.js

@@ -1,16 +1,3 @@
-/**
- * @fileoverview Pure helpers for the Dashboard Browser's AI-agent integration.
- *
- * These functions are intentionally free of Angular / component dependencies so
- * they can be unit-tested in isolation. The resource component
- * ({@link DashboardBrowserResourceComponent}) supplies a plain snapshot of its
- * current state and these helpers shape it into the flat key-value `AgentContext`
- * object that flows to the async chat agent and the realtime co-agent via
- * `NavigationService.SetAgentContext`.
- *
- * 🔒 SAFETY: this module only *describes* state and validates input. It performs
- * no mutation and has no side effects.
- */
 /** The two record-view modes the browser list supports. */
 const VALID_BROWSER_VIEW_MODES = ['cards', 'list'];
 /**
@@ -21,6 +8,8 @@ const VALID_BROWSER_VIEW_MODES = ['cards', 'list'];
  * used by the Data Explorer's agent context.
  */
 export const AGENT_CONTEXT_NAME_LIST_CAP = 25;
+/** How many recently opened dashboards the context names. */
+export const RECENTLY_OPENED_NAME_CAP = 3;
 /**
  * Cap an array of names to {@link AGENT_CONTEXT_NAME_LIST_CAP} entries.
  * Pure + deterministic so the context shape stays unit-testable.
@@ -47,7 +36,7 @@ export function isValidBrowserViewMode(mode) {
     return IsValidBrowserViewMode(mode);
 }
 /**
- * Build the agent-visible context object for the Dashboard Browser.
+ * Build the agent-visible context object for the Library page.
  *
  * Keeping this a pure function (no `this`) makes the context shape unit-testable
  * and decouples it from change-detection timing.
@@ -58,12 +47,10 @@ export function isValidBrowserViewMode(mode) {
 export function BuildDashboardBrowserAgentContext(input) {
     const hasSearch = input.SearchText.trim().length > 0;
     const context = {
-        Mode: input.Mode,
-        SelectedDashboardId: input.SelectedDashboardId,
-        SelectedDashboardName: input.SelectedDashboardName,
         VisibleDashboards: capNames(input.VisibleDashboardNames),
         TotalDashboardCount: input.TotalDashboardCount,
         FilteredDashboardCount: input.FilteredDashboardCount,
+        LibraryFilter: input.LibraryFilter,
         HasSearch: hasSearch,
         SearchText: input.SearchText,
         AvailableCategories: capNames(input.AvailableCategoryNames),
@@ -71,6 +58,8 @@ export function BuildDashboardBrowserAgentContext(input) {
         SelectedCategoryName: input.SelectedCategoryName,
         ViewMode: input.ViewMode,
         IsLoading: input.IsLoading,
+        LibraryCounts: { ...input.LibraryCounts },
+        RecentlyOpenedNames: input.RecentlyOpenedNames.slice(0, RECENTLY_OPENED_NAME_CAP),
     };
     // When more dashboards/categories are visible than we publish names for, tell
     // the co-agent the true total so it knows the streamed list is truncated.
@@ -80,18 +69,6 @@ export function BuildDashboardBrowserAgentContext(input) {
     if (input.AvailableCategoryNames.length > AGENT_CONTEXT_NAME_LIST_CAP) {
         context['AvailableCategoryCount'] = input.AvailableCategoryNames.length;
     }
-    // Opened-dashboard awareness: only publish these fields when a dashboard is
-    // actually open (view/edit). At the list level we omit them entirely so the
-    // agent's context stays focused on browse/filter state.
-    if (input.Mode !== 'list') {
-        context['OpenedDashboardName'] = input.OpenedDashboardName ?? null;
-        context['OpenedDashboardId'] = input.OpenedDashboardId ?? null;
-        context['OpenedDashboardIsEditing'] = input.OpenedDashboardIsEditing ?? false;
-        context['OpenedDashboardCanEdit'] = input.OpenedDashboardCanEdit ?? false;
-        const panels = input.OpenedDashboardPanels ?? [];
-        context['OpenedDashboardPanelCount'] = panels.length;
-        context['OpenedDashboardPanels'] = panels.slice(0, AGENT_CONTEXT_NAME_LIST_CAP);
-    }
     return context;
 }
 /** @deprecated Use {@link BuildDashboardBrowserAgentContext}. */

package/dist/DashboardBrowser/dashboard-browser-agent-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-browser-agent-context.js","sourceRoot":"","sources":["../../src/DashboardBrowser/dashboard-browser-agent-context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Pure helpers for the Dashboard Browser's AI-agent integration.\n *\n * These functions are intentionally free of Angular / component dependencies so\n * they can be unit-tested in isolation. The resource component\n * ({@link DashboardBrowserResourceComponent}) supplies a plain snapshot of its\n * current state and these helpers shape it into the flat key-value `AgentContext`\n * object that flows to the async chat agent and the realtime co-agent via\n * `NavigationService.SetAgentContext`.\n *\n * 🔒 SAFETY: this module only *describes* state and validates input. It performs\n * no mutation and has no side effects.\n */\n\n/** The two browser-mode levels surfaced to the agent. */\ntype BrowserMode = 'list' | 'view' | 'edit';\n\n/**\n * A single panel/widget on the currently-open dashboard, as surfaced to the\n * agent. Purely descriptive — no entity references, no config payloads, just\n * enough for the agent to reason about (and describe) what's on the dashboard.\n */\nexport interface OpenedDashboardPanelSummary {\n    /** The panel's display title (e.g. \"Active Members\"). */\n    Title: string;\n    /** The part-type name (e.g. \"View\", \"Query\", \"WebURL\", \"Artifact\"). */\n    PartTypeName: string;\n    /** Optional Font Awesome icon class for the panel, when one is set. */\n    Icon?: string;\n}\n\n/** The two record-view modes the browser list supports. */\nconst VALID_BROWSER_VIEW_MODES = ['cards', 'list'] as const;\n\n/** Narrowed union for the browser list's view mode. */\nexport type BrowserViewMode = (typeof VALID_BROWSER_VIEW_MODES)[number];\n\n/**\n * Upper bound on how many names we publish in a name-list context field\n * (VisibleDashboards, AvailableCategories). Keeping the streamed note bounded\n * avoids flooding the co-agent with hundreds of names; when the underlying list\n * is larger we surface a companion total-count field instead. Mirrors the cap\n * used by the Data Explorer's agent context.\n */\nexport const AGENT_CONTEXT_NAME_LIST_CAP = 25;\n\n/**\n * Cap an array of names to {@link AGENT_CONTEXT_NAME_LIST_CAP} entries.\n * Pure + deterministic so the context shape stays unit-testable.\n *\n * @param names - the full list of names (already de-duplicated by the caller)\n * @returns the first N names, where N is the cap\n */\nfunction capNames(names: readonly string[]): string[] {\n    return names.slice(0, AGENT_CONTEXT_NAME_LIST_CAP);\n}\n\n/**\n * Type-guard / validator for a browser view-mode string. Keeps the\n * `SwitchViewMode` client tool tolerant of arbitrary agent input — only the two\n * known modes are accepted.\n *\n * @param mode - candidate mode string (may be anything the agent passes)\n * @returns true when `mode` is one of cards | list\n */\nexport function IsValidBrowserViewMode(mode: unknown): mode is BrowserViewMode {\n    return typeof mode === 'string' && (VALID_BROWSER_VIEW_MODES as readonly string[]).includes(mode);\n}\n\n/** @deprecated Use {@link IsValidBrowserViewMode}. */\nexport function isValidBrowserViewMode(mode: unknown): mode is BrowserViewMode {\n    return IsValidBrowserViewMode(mode);\n}\n\n/**\n * The plain, component-supplied snapshot used to build the agent context.\n * Mirrors the salient slice of {@link DashboardBrowserResourceComponent}'s state.\n */\nexport interface DashboardBrowserAgentContextInput {\n    /** Current browser mode: list / view / edit. */\n    Mode: BrowserMode;\n    /** ID of the currently selected dashboard, or null at the list level. */\n    SelectedDashboardId: string | null;\n    /** Display name of the currently selected dashboard, or null. */\n    SelectedDashboardName: string | null;\n    /**\n     * Names of the dashboards currently visible in the list (after any agent\n     * search narrowing) — the ones the agent can open by name via OpenDashboard.\n     * The component supplies the full visible list; this helper bounds it — see\n     * {@link AGENT_CONTEXT_NAME_LIST_CAP}.\n     */\n    VisibleDashboardNames: string[];\n    /** Total number of dashboards accessible to the user (unfiltered). */\n    TotalDashboardCount: number;\n    /**\n     * Number of dashboards currently visible in the list. Equals\n     * `VisibleDashboardNames.length` before the name-list cap is applied, so the\n     * agent knows the true filtered count even when the published names are\n     * truncated.\n     */\n    FilteredDashboardCount: number;\n    /** The current free-text search applied to the dashboard list, or '' when none. */\n    SearchText: string;\n    /**\n     * Names of the categories accessible to the user (so the agent can pick one\n     * to filter by via SelectCategory). The component supplies the full list;\n     * this helper bounds it — see {@link AGENT_CONTEXT_NAME_LIST_CAP}.\n     */\n    AvailableCategoryNames: string[];\n    /** ID of the currently selected category filter, or null (root). */\n    SelectedCategoryId: string | null;\n    /** Display name of the currently selected category, or null (root). */\n    SelectedCategoryName: string | null;\n    /** Active record-view mode for the list (cards / list). */\n    ViewMode: BrowserViewMode;\n    /** Whether the browser is currently loading data. */\n    IsLoading: boolean;\n\n    // ----------------------------------------------------------------------\n    // Opened-dashboard awareness (present only when Mode is 'view' or 'edit').\n    // When a dashboard is open these describe its contents so the agent isn't\n    // blind to what's on screen. All null/empty at the list level.\n    // ----------------------------------------------------------------------\n\n    /**\n     * Name of the dashboard currently open in the view/edit pane, or null when\n     * at the list level. Distinct from {@link SelectedDashboardName} only in\n     * intent: this field is the explicit \"a dashboard is OPEN\" signal.\n     */\n    OpenedDashboardName?: string | null;\n    /** ID of the dashboard currently open, or null at the list level. */\n    OpenedDashboardId?: string | null;\n    /** Whether the open dashboard is in edit mode (Mode === 'edit'). */\n    OpenedDashboardIsEditing?: boolean;\n    /** Whether the current user may edit the open dashboard (from permissions). */\n    OpenedDashboardCanEdit?: boolean;\n    /**\n     * The panels/widgets on the open dashboard. Empty array when none / not\n     * open. The component supplies the full list; this helper bounds it — see\n     * {@link AGENT_CONTEXT_NAME_LIST_CAP}.\n     */\n    OpenedDashboardPanels?: OpenedDashboardPanelSummary[];\n}\n\n/**\n * Build the agent-visible context object for the Dashboard Browser.\n *\n * Keeping this a pure function (no `this`) makes the context shape unit-testable\n * and decouples it from change-detection timing.\n *\n * @param input - the component's current state snapshot\n * @returns a flat key-value object suitable for `SetAgentContext`\n */\nexport function BuildDashboardBrowserAgentContext(\n    input: DashboardBrowserAgentContextInput,\n): Record<string, unknown> {\n    const hasSearch = input.SearchText.trim().length > 0;\n\n    const context: Record<string, unknown> = {\n        Mode: input.Mode,\n        SelectedDashboardId: input.SelectedDashboardId,\n        SelectedDashboardName: input.SelectedDashboardName,\n        VisibleDashboards: capNames(input.VisibleDashboardNames),\n        TotalDashboardCount: input.TotalDashboardCount,\n        FilteredDashboardCount: input.FilteredDashboardCount,\n        HasSearch: hasSearch,\n        SearchText: input.SearchText,\n        AvailableCategories: capNames(input.AvailableCategoryNames),\n        SelectedCategoryId: input.SelectedCategoryId,\n        SelectedCategoryName: input.SelectedCategoryName,\n        ViewMode: input.ViewMode,\n        IsLoading: input.IsLoading,\n    };\n\n    // When more dashboards/categories are visible than we publish names for, tell\n    // the co-agent the true total so it knows the streamed list is truncated.\n    if (input.VisibleDashboardNames.length > AGENT_CONTEXT_NAME_LIST_CAP) {\n        context['VisibleDashboardCount'] = input.VisibleDashboardNames.length;\n    }\n    if (input.AvailableCategoryNames.length > AGENT_CONTEXT_NAME_LIST_CAP) {\n        context['AvailableCategoryCount'] = input.AvailableCategoryNames.length;\n    }\n\n    // Opened-dashboard awareness: only publish these fields when a dashboard is\n    // actually open (view/edit). At the list level we omit them entirely so the\n    // agent's context stays focused on browse/filter state.\n    if (input.Mode !== 'list') {\n        context['OpenedDashboardName'] = input.OpenedDashboardName ?? null;\n        context['OpenedDashboardId'] = input.OpenedDashboardId ?? null;\n        context['OpenedDashboardIsEditing'] = input.OpenedDashboardIsEditing ?? false;\n        context['OpenedDashboardCanEdit'] = input.OpenedDashboardCanEdit ?? false;\n\n        const panels = input.OpenedDashboardPanels ?? [];\n        context['OpenedDashboardPanelCount'] = panels.length;\n        context['OpenedDashboardPanels'] = panels.slice(0, AGENT_CONTEXT_NAME_LIST_CAP);\n    }\n\n    return context;\n}\n\n/** @deprecated Use {@link BuildDashboardBrowserAgentContext}. */\nexport function buildDashboardBrowserAgentContext(\n    input: DashboardBrowserAgentContextInput,\n): Record<string, unknown> {\n    return BuildDashboardBrowserAgentContext(input);\n}\n"]}
+{"version":3,"file":"dashboard-browser-agent-context.js","sourceRoot":"","sources":["../../src/DashboardBrowser/dashboard-browser-agent-context.ts"],"names":[],"mappings":"AAeA,2DAA2D;AAC3D,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU,CAAC;AAK5D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,KAAwB;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAK,wBAA8C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtG,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAChD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAgDD;;;;;;;;GAQG;AACH,MAAM,UAAU,iCAAiC,CAC7C,KAAwC;IAExC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAErD,MAAM,OAAO,GAA4B;QACrC,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,qBAAqB,CAAC;QACxD,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,mBAAmB,EAAE,QAAQ,CAAC,KAAK,CAAC,sBAAsB,CAAC;QAC3D,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE;QACzC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,CAAC;KACpF,CAAC;IAEF,8EAA8E;IAC9E,0EAA0E;IAC1E,IAAI,KAAK,CAAC,qBAAqB,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;QACnE,OAAO,CAAC,uBAAuB,CAAC,GAAG,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,CAAC,sBAAsB,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;QACpE,OAAO,CAAC,wBAAwB,CAAC,GAAG,KAAK,CAAC,sBAAsB,CAAC,MAAM,CAAC;IAC5E,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,iCAAiC,CAC7C,KAAwC;IAExC,OAAO,iCAAiC,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * @fileoverview Pure helpers for the AI-agent integration of the Dashboards app's Library page.\n *\n * These functions are intentionally free of Angular / component dependencies so\n * they can be unit-tested in isolation. The resource component\n * ({@link DashboardBrowserResourceComponent}) supplies a plain snapshot of its\n * current state and these helpers shape it into the flat key-value `AgentContext`\n * object that flows to the async chat agent and the realtime co-agent via\n * `NavigationService.SetAgentContext`.\n *\n * 🔒 SAFETY: this module only *describes* state and validates input. It performs\n * no mutation and has no side effects.\n */\nimport type { DashboardLibraryFilter } from './dashboard-library-filter';\n\n/** The two record-view modes the browser list supports. */\nconst VALID_BROWSER_VIEW_MODES = ['cards', 'list'] as const;\n\n/** Narrowed union for the browser list's view mode. */\nexport type BrowserViewMode = (typeof VALID_BROWSER_VIEW_MODES)[number];\n\n/**\n * Upper bound on how many names we publish in a name-list context field\n * (VisibleDashboards, AvailableCategories). Keeping the streamed note bounded\n * avoids flooding the co-agent with hundreds of names; when the underlying list\n * is larger we surface a companion total-count field instead. Mirrors the cap\n * used by the Data Explorer's agent context.\n */\nexport const AGENT_CONTEXT_NAME_LIST_CAP = 25;\n\n/** How many recently opened dashboards the context names. */\nexport const RECENTLY_OPENED_NAME_CAP = 3;\n\n/**\n * Cap an array of names to {@link AGENT_CONTEXT_NAME_LIST_CAP} entries.\n * Pure + deterministic so the context shape stays unit-testable.\n *\n * @param names - the full list of names (already de-duplicated by the caller)\n * @returns the first N names, where N is the cap\n */\nfunction capNames(names: readonly string[]): string[] {\n    return names.slice(0, AGENT_CONTEXT_NAME_LIST_CAP);\n}\n\n/**\n * Type-guard / validator for a browser view-mode string. Keeps the\n * `SwitchViewMode` client tool tolerant of arbitrary agent input — only the two\n * known modes are accepted.\n *\n * @param mode - candidate mode string (may be anything the agent passes)\n * @returns true when `mode` is one of cards | list\n */\nexport function IsValidBrowserViewMode(mode: unknown): mode is BrowserViewMode {\n    return typeof mode === 'string' && (VALID_BROWSER_VIEW_MODES as readonly string[]).includes(mode);\n}\n\n/** @deprecated Use {@link IsValidBrowserViewMode}. */\nexport function isValidBrowserViewMode(mode: unknown): mode is BrowserViewMode {\n    return IsValidBrowserViewMode(mode);\n}\n\n/**\n * The plain, component-supplied snapshot used to build the agent context.\n * Mirrors the salient slice of {@link DashboardBrowserResourceComponent}'s state.\n */\nexport interface DashboardBrowserAgentContextInput {\n    /**\n     * Names of the dashboards currently visible in the list (after the Library\n     * filter and any agent search narrowing) — the ones the agent can open by name\n     * via OpenDashboard.\n     * The component supplies the full visible list; this helper bounds it — see\n     * {@link AGENT_CONTEXT_NAME_LIST_CAP}.\n     */\n    VisibleDashboardNames: string[];\n    /** Total number of dashboards accessible to the user (unfiltered). */\n    TotalDashboardCount: number;\n    /**\n     * Number of dashboards currently visible in the list. Equals\n     * `VisibleDashboardNames.length` before the name-list cap is applied, so the\n     * agent knows the true filtered count even when the published names are\n     * truncated.\n     */\n    FilteredDashboardCount: number;\n    /** The active Library filter in the rail (all, mine, shared, favorites, recent). */\n    LibraryFilter: DashboardLibraryFilter;\n    /** How many dashboards each Library filter lists. */\n    LibraryCounts: Record<DashboardLibraryFilter, number>;\n    /** The Config dashboards the user opened last, the most recent first. */\n    RecentlyOpenedNames: string[];\n    /** The current free-text search applied to the dashboard list, or '' when none. */\n    SearchText: string;\n    /**\n     * Names of the categories accessible to the user (so the agent can pick one\n     * to filter by via SelectCategory). The component supplies the full list;\n     * this helper bounds it — see {@link AGENT_CONTEXT_NAME_LIST_CAP}.\n     */\n    AvailableCategoryNames: string[];\n    /** ID of the currently selected category filter, or null (root). */\n    SelectedCategoryId: string | null;\n    /** Display name of the currently selected category, or null (root). */\n    SelectedCategoryName: string | null;\n    /** Active record-view mode for the list (cards / list). */\n    ViewMode: BrowserViewMode;\n    /** Whether the browser is currently loading data. */\n    IsLoading: boolean;\n}\n\n/**\n * Build the agent-visible context object for the Library page.\n *\n * Keeping this a pure function (no `this`) makes the context shape unit-testable\n * and decouples it from change-detection timing.\n *\n * @param input - the component's current state snapshot\n * @returns a flat key-value object suitable for `SetAgentContext`\n */\nexport function BuildDashboardBrowserAgentContext(\n    input: DashboardBrowserAgentContextInput,\n): Record<string, unknown> {\n    const hasSearch = input.SearchText.trim().length > 0;\n\n    const context: Record<string, unknown> = {\n        VisibleDashboards: capNames(input.VisibleDashboardNames),\n        TotalDashboardCount: input.TotalDashboardCount,\n        FilteredDashboardCount: input.FilteredDashboardCount,\n        LibraryFilter: input.LibraryFilter,\n        HasSearch: hasSearch,\n        SearchText: input.SearchText,\n        AvailableCategories: capNames(input.AvailableCategoryNames),\n        SelectedCategoryId: input.SelectedCategoryId,\n        SelectedCategoryName: input.SelectedCategoryName,\n        ViewMode: input.ViewMode,\n        IsLoading: input.IsLoading,\n        LibraryCounts: { ...input.LibraryCounts },\n        RecentlyOpenedNames: input.RecentlyOpenedNames.slice(0, RECENTLY_OPENED_NAME_CAP),\n    };\n\n    // When more dashboards/categories are visible than we publish names for, tell\n    // the co-agent the true total so it knows the streamed list is truncated.\n    if (input.VisibleDashboardNames.length > AGENT_CONTEXT_NAME_LIST_CAP) {\n        context['VisibleDashboardCount'] = input.VisibleDashboardNames.length;\n    }\n    if (input.AvailableCategoryNames.length > AGENT_CONTEXT_NAME_LIST_CAP) {\n        context['AvailableCategoryCount'] = input.AvailableCategoryNames.length;\n    }\n\n    return context;\n}\n\n/** @deprecated Use {@link BuildDashboardBrowserAgentContext}. */\nexport function buildDashboardBrowserAgentContext(\n    input: DashboardBrowserAgentContextInput,\n): Record<string, unknown> {\n    return BuildDashboardBrowserAgentContext(input);\n}\n"]}