@luzmo/analytics-components-kit 1.0.8-beta.2 → 1.0.8-beta.4

package/custom-elements.json

@@ -634,12 +634,23 @@
             },
             {
               "kind": "field",
-              "name": "flagOpendata",
+              "name": "includePublicDatasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "attribute": "include-public-datasets",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "attribute": "flag-opendata"
             },
             {
@@ -699,7 +710,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "description": "When true, a picked agent or at least one selected dataset is required before the prompt can be submitted",
               "attribute": "require-dataset"
             },
             {
@@ -758,7 +769,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Saved Agent id (UUID) to run the prompt as.",
+              "description": "Saved Agent id (UUID) to run the prompt as. An agent picked in the prompt box takes precedence for that prompt.",
               "attribute": "agent-id"
             },
             {
@@ -1495,12 +1506,21 @@
               "fieldName": "appServer"
             },
             {
-              "name": "flag-opendata",
+              "name": "include-public-datasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "fieldName": "includePublicDatasets"
+            },
+            {
+              "name": "flag-opendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "fieldName": "flagOpendata"
             },
             {
@@ -1554,7 +1574,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "description": "When true, a picked agent or at least one selected dataset is required before the prompt can be submitted",
               "fieldName": "requireDataset"
             },
             {
@@ -1598,7 +1618,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Saved Agent id (UUID) to run the prompt as.",
+              "description": "Saved Agent id (UUID) to run the prompt as. An agent picked in the prompt box takes precedence for that prompt.",
               "fieldName": "agentId"
             },
             {
@@ -2349,7 +2369,16 @@
                 "type": {
                   "text": "boolean"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "agentId",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -2387,6 +2416,13 @@
                   "type": {
                     "text": "string[]"
                   }
+                },
+                {
+                  "name": "agentId",
+                  "default": "this._config.agentId",
+                  "type": {
+                    "text": "string | undefined"
+                  }
                 }
               ]
             },
@@ -2402,7 +2438,7 @@
                 {
                   "name": "params",
                   "type": {
-                    "text": "{\n    prompt: string;\n    selectedDatasets: Dataset[];\n    datasetIds: string[];\n    signal?: AbortSignal;\n    attachments?: PromptBoxAttachment[];\n    attachmentUrls?: string[];\n  }"
+                    "text": "{\n    prompt: string;\n    selectedDatasets: Dataset[];\n    datasetIds: string[];\n    signal?: AbortSignal;\n    attachments?: PromptBoxAttachment[];\n    attachmentUrls?: string[];\n    agentId?: string;\n  }"
                   }
                 }
               ],
@@ -3126,12 +3162,23 @@
             },
             {
               "kind": "field",
-              "name": "flagOpendata",
+              "name": "includePublicDatasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "attribute": "include-public-datasets",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "attribute": "flag-opendata"
             },
             {
@@ -3186,6 +3233,15 @@
               "attribute": "max-visible-selected-datasets",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "selectedAgent",
+              "type": {
+                "text": "Agent | null"
+              },
+              "default": "null",
+              "description": "The saved Agent the prompt is scoped to, or null"
+            },
             {
               "kind": "field",
               "name": "disableDatasetModification",
@@ -3264,7 +3320,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "description": "When true, a selected agent or at least one selected dataset is required before the prompt can be submitted",
               "attribute": "require-dataset"
             },
             {
@@ -3504,7 +3560,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "description": "When true, a selected agent or at least one selected dataset is required before the prompt can be submitted",
               "name": "require-dataset",
               "kind": "field"
             },
@@ -3621,12 +3677,21 @@
               "fieldName": "appServer"
             },
             {
-              "name": "flag-opendata",
+              "name": "include-public-datasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "fieldName": "includePublicDatasets"
+            },
+            {
+              "name": "flag-opendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "fieldName": "flagOpendata"
             },
             {
@@ -3743,7 +3808,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "description": "When true, a selected agent or at least one selected dataset is required before the prompt can be submitted",
               "fieldName": "requireDataset"
             },
             {
@@ -5558,12 +5623,23 @@
             },
             {
               "kind": "field",
-              "name": "flagOpendata",
+              "name": "includePublicDatasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "attribute": "include-public-datasets",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "attribute": "flag-opendata"
             },
             {
@@ -5786,12 +5862,21 @@
               "fieldName": "appServer"
             },
             {
-              "name": "flag-opendata",
+              "name": "include-public-datasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "fieldName": "includePublicDatasets"
+            },
+            {
+              "name": "flag-opendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "fieldName": "flagOpendata"
             }
           ],
@@ -5843,10 +5928,22 @@
               "description": "Array of selected datasets",
               "attribute": "selectedDatasets"
             },
+            {
+              "kind": "field",
+              "name": "selectedAgent",
+              "type": {
+                "text": "Agent | null"
+              },
+              "default": "null",
+              "description": "The agent the chat is scoped to, or null"
+            },
             {
               "kind": "field",
               "name": "buttonLabel",
-              "description": "Accessible label and hover tooltip text for the dataset search trigger",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Accessible label and hover tooltip text for the search trigger",
               "attribute": "button-label"
             },
             {
@@ -5891,12 +5988,23 @@
             },
             {
               "kind": "field",
-              "name": "flagOpendata",
+              "name": "includePublicDatasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "attribute": "include-public-datasets",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "attribute": "flag-opendata"
             },
             {
@@ -6023,6 +6131,13 @@
             }
           ],
           "events": [
+            {
+              "name": "luzmo-agent-selected",
+              "type": {
+                "text": "CustomEvent<Agent>"
+              },
+              "description": "Fired when an agent is selected"
+            },
             {
               "name": "dataset-selected",
               "type": {
@@ -6036,6 +6151,13 @@
                 "text": "CustomEvent<Dataset>"
               },
               "description": "Fired when a dataset is removed"
+            },
+            {
+              "name": "luzmo-agent-removed",
+              "type": {
+                "text": "CustomEvent<Agent>"
+              },
+              "description": "Fired when the selected agent is removed"
             }
           ],
           "attributes": [
@@ -6050,7 +6172,10 @@
             },
             {
               "name": "button-label",
-              "description": "Accessible label and hover tooltip text for the dataset search trigger",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Accessible label and hover tooltip text for the search trigger",
               "fieldName": "buttonLabel"
             },
             {
@@ -6090,12 +6215,21 @@
               "fieldName": "appServer"
             },
             {
-              "name": "flag-opendata",
+              "name": "include-public-datasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "fieldName": "includePublicDatasets"
+            },
+            {
+              "name": "flag-opendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "fieldName": "flagOpendata"
             },
             {
@@ -6140,7 +6274,7 @@
           },
           "tagName": "luzmo-dataset-selector-row",
           "customElement": true,
-          "summary": "A row component for selecting and managing datasets with pills and overlay. Theme Lucero primitives (`luzmo-select`, options, popover, tags) with `--luzmo-select-*`, `--luzmo-popover-max-height`, `--luzmo-option-*`, `--luzmo-tag-*` on this host or an ancestor; optional `--luzmo-dataset-selector-row-*` overrides ACK row shell defaults (gap, typography, search max width, scoped popover height)."
+          "summary": "A row component for selecting and managing datasets with pills and overlay. The dropdown lists up to five saved Agents in a labelled section above the datasets, so a chat can be scoped to an agent from the same control. Theme Lucero primitives (`luzmo-select`, options, popover, tags) with `--luzmo-select-*`, `--luzmo-popover-max-height`, `--luzmo-option-*`, `--luzmo-tag-*` on this host or an ancestor; optional `--luzmo-dataset-selector-row-*` overrides ACK row shell defaults (gap, typography, search max width, scoped popover height)."
         }
       ],
       "exports": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luzmo/analytics-components-kit",
-  "version": "1.0.8-beta.2",
+  "version": "1.0.8-beta.4",
   "type": "module",
   "main": "./components/index.js",
   "module": "./components/index.js",
@@ -334,7 +334,7 @@
     "@lit/task": "^1.0.1",
     "@luzmo/embed": "^7.5.0",
     "@luzmo/icons": "^1.0.1-alpha.46",
-    "@luzmo/lucero": "^2.0.1",
+    "@luzmo/lucero": "^2.2.0",
     "colorjs.io": "^0.5.2",
     "lit": "^3.3.2",
     "yjs": "^13.6.29"

package/react/components/dataset-selector-row.component.ts

@@ -1,28 +1,34 @@
 import React from 'react';
 import { createComponent, EventName, ReactWebComponent } from '@lit/react';
-import { LuzmoDatasetSelectorRow as LuzmoDatasetSelectorRowClass, Dataset } from '@luzmo/analytics-components-kit/dataset-selector-row';
+import { LuzmoDatasetSelectorRow as LuzmoDatasetSelectorRowClass, Agent, Dataset } from '@luzmo/analytics-components-kit/dataset-selector-row';
 
 const LuzmoDatasetSelectorRowComponent = createComponent({
   tagName: 'luzmo-dataset-selector-row',
   elementClass: LuzmoDatasetSelectorRowClass,
   react: React,
   events: {
+    onLuzmoAgentSelected: 'luzmo-agent-selected' as EventName<CustomEvent<Agent>>,
     onDatasetSelected: 'dataset-selected' as EventName<CustomEvent<Dataset>>,
-    onDatasetRemoved: 'dataset-removed' as EventName<CustomEvent<Dataset>>
+    onDatasetRemoved: 'dataset-removed' as EventName<CustomEvent<Dataset>>,
+    onLuzmoAgentRemoved: 'luzmo-agent-removed' as EventName<CustomEvent<Agent>>
   }
 });
 
 /**
  * React wrapper for <luzmo-dataset-selector-row>
  *
+ * @event onLuzmoAgentSelected - Fired when an agent is selected
  * @event onDatasetSelected - Fired when a dataset is selected
  * @event onDatasetRemoved - Fired when a dataset is removed
+ * @event onLuzmoAgentRemoved - Fired when the selected agent is removed
  */
 export const LuzmoDatasetSelectorRow = LuzmoDatasetSelectorRowComponent as ReactWebComponent<
   LuzmoDatasetSelectorRowClass,
   {
+    onLuzmoAgentSelected: EventName<CustomEvent<Agent>>;
     onDatasetSelected: EventName<CustomEvent<Dataset>>;
     onDatasetRemoved: EventName<CustomEvent<Dataset>>;
+    onLuzmoAgentRemoved: EventName<CustomEvent<Agent>>;
   }
 >;
 

package/react/esm/components/dataset-selector-row.component.d.ts

@@ -1,14 +1,18 @@
 import { EventName, ReactWebComponent } from '@lit/react';
-import { LuzmoDatasetSelectorRow as LuzmoDatasetSelectorRowClass, Dataset } from '@luzmo/analytics-components-kit/dataset-selector-row';
+import { LuzmoDatasetSelectorRow as LuzmoDatasetSelectorRowClass, Agent, Dataset } from '@luzmo/analytics-components-kit/dataset-selector-row';
 /**
  * React wrapper for <luzmo-dataset-selector-row>
  *
+ * @event onLuzmoAgentSelected - Fired when an agent is selected
  * @event onDatasetSelected - Fired when a dataset is selected
  * @event onDatasetRemoved - Fired when a dataset is removed
+ * @event onLuzmoAgentRemoved - Fired when the selected agent is removed
  */
 export declare const LuzmoDatasetSelectorRow: ReactWebComponent<LuzmoDatasetSelectorRowClass, {
+    onLuzmoAgentSelected: EventName<CustomEvent<Agent>>;
     onDatasetSelected: EventName<CustomEvent<Dataset>>;
     onDatasetRemoved: EventName<CustomEvent<Dataset>>;
+    onLuzmoAgentRemoved: EventName<CustomEvent<Agent>>;
 }>;
 /** The underlying custom element type for LuzmoDatasetSelectorRow */
 export type LuzmoDatasetSelectorRowElement = LuzmoDatasetSelectorRowClass;

package/react/esm/components/dataset-selector-row.component.js

@@ -6,14 +6,18 @@ const LuzmoDatasetSelectorRowComponent = createComponent({
     elementClass: LuzmoDatasetSelectorRowClass,
     react: React,
     events: {
+        onLuzmoAgentSelected: 'luzmo-agent-selected',
         onDatasetSelected: 'dataset-selected',
-        onDatasetRemoved: 'dataset-removed'
+        onDatasetRemoved: 'dataset-removed',
+        onLuzmoAgentRemoved: 'luzmo-agent-removed'
     }
 });
 /**
  * React wrapper for <luzmo-dataset-selector-row>
  *
+ * @event onLuzmoAgentSelected - Fired when an agent is selected
  * @event onDatasetSelected - Fired when a dataset is selected
  * @event onDatasetRemoved - Fired when a dataset is removed
+ * @event onLuzmoAgentRemoved - Fired when the selected agent is removed
  */
 export const LuzmoDatasetSelectorRow = LuzmoDatasetSelectorRowComponent;

package/react/luzmo-stub.d.ts

@@ -56,6 +56,7 @@ declare module '@luzmo/analytics-components-kit/dataset-selector-list' {
 
 declare module '@luzmo/analytics-components-kit/dataset-selector-row' {
   export class LuzmoDatasetSelectorRow extends HTMLElement {}
+  export type Agent = Record<string, unknown>;
   export type Dataset = Record<string, unknown>;
 }
 

package/react/package.json

@@ -29,7 +29,7 @@
   "peerDependencies": {
     "@lit/react": "^1.0.6",
     "react": "^18.0.0 || ^19.0.0",
-    "@luzmo/analytics-components-kit": "^1.0.8-beta.2"
+    "@luzmo/analytics-components-kit": "^1.0.8-beta.4"
   },
-  "version": "1.0.8-beta.2"
+  "version": "1.0.8-beta.4"
 }

package/types/agent.types.d.ts

@@ -0,0 +1,4 @@
+export interface Agent {
+    id: string;
+    name: string | Record<string, string>;
+}

package/types.d.ts

@@ -7,6 +7,7 @@
  */
 export type { Column, ColumnSubtype, ColumnType, GenericSlotContent, GridConfig, ItemFilterGroup, OptionConfig, OptionsConfig, OptionTranslation, Slot, SlotConfig, SlotName, SlotPosition, SlotPositioningConfig, ThemeConfig, TranslationOverrides, TranslationsFile, VizItemSlot, VizItemType } from '@luzmo/dashboard-contents-types';
 export type { ElementSize, Placement } from '@luzmo/lucero';
+export type * from './types/agent.types';
 export type * from './types/ai-chat.types';
 export type * from './types/data-field-events.types';
 export type * from './types/dataset-data-field.types';

package/utils/formatter/get-localized-name.d.ts

@@ -0,0 +1,4 @@
+export declare function getLocalizedName(item: {
+    id: string;
+    name: string | Record<string, string>;
+}): string;

package/utils/formatter/tests/get-localized-name.test.d.ts

@@ -0,0 +1 @@
+export {};