@limetech/lime-web-components 6.9.0 → 6.10.0

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [6.10.0](https://github.com/Lundalogik/lime-web-components/compare/v6.9.0...v6.10.0) (2026-02-13)
+
+
+### Features
+
+
+* **ai-context:** add GatheredAIContext and update element registration ([e1ebb1d](https://github.com/Lundalogik/lime-web-components/commit/e1ebb1d51eb89290cbd64a252b1b42145c833d12))
+* **ai-context:** allow getContext() to return null ([35209a4](https://github.com/Lundalogik/lime-web-components/commit/35209a4a6a456d2b3a7254b848d4af46d86cc380))
+
 ## [6.9.0](https://github.com/Lundalogik/lime-web-components/compare/v6.8.0...v6.9.0) (2026-01-28)
 
 

package/dist/ai-context/ai-context-registry.d.ts

@@ -1,3 +1,5 @@
+import { LimeWebComponent } from '../core/lime-web-component';
+import { LimeWebComponentContext } from '../core/context';
 /**
  * A value that can be safely serialized to JSON via JSON.stringify().
  *
@@ -70,6 +72,28 @@ export interface AIContextContribution {
      */
     purpose?: string;
 }
+/**
+ * A fully enriched context contribution ready for the AI.
+ *
+ * This is the "output" of context gathering — includes the provider's
+ * contribution plus UI context information added by the registry.
+ *
+ * @alpha
+ * @group AI Context
+ */
+export interface GatheredAIContext extends AIContextContribution {
+    /**
+     * The component's LimeWebComponentContext at the time of gathering.
+     *
+     * Provides rich information about where this context originates:
+     * - `limetype`: What type of business object the component is working with
+     * - `id`: Which specific record (if any)
+     * - `parent`: Parent context for nested components
+     *
+     * Only present when the provider registered with an element reference.
+     */
+    componentContext?: LimeWebComponentContext;
+}
 /**
  * A provider that contributes context information to the AI chat.
  *
@@ -89,6 +113,9 @@ export interface AIContextContribution {
  * ```typescript
  * @Component({ tag: 'my-custom-panel' })
  * export class MyCustomPanel {
+ *     @Element()
+ *     private host: HTMLElement & LimeWebComponent;
+ *
  *     private unregisterContext: () => void;
  *
  *     connectedCallback() {
@@ -103,7 +130,7 @@ export interface AIContextContribution {
  *                     selectionCount: this.selectedItems.length
  *                 }
  *             })
- *         });
+ *         }, this.host);
  *     }
  *
  *     disconnectedCallback() {
@@ -138,9 +165,10 @@ export interface AIContextProvider {
      * The implementation should be fast and avoid expensive operations
      * since it's called on every message.
      *
-     * @returns The context contribution.
+     * @returns The context contribution, or `null` if no context is available
+     * (e.g., required state hasn't loaded yet).
      */
-    getContext(): AIContextContribution;
+    getContext(): AIContextContribution | null;
 }
 /**
  * Registry for AI context providers.
@@ -171,6 +199,10 @@ export interface AIContextRegistry {
      * gets a unique internal key.
      *
      * @param provider - The provider to register.
+     * @param element - Optional host element of the component registering this
+     * provider. When provided, enables the registry to:
+     * - Read the component's `LimeWebComponentContext` to enrich contributions
+     * - Skip providers whose elements are not currently connected to the DOM
      * @returns A function to unregister the provider. Call this when the
      * component is disconnected or the context is no longer relevant.
      *
@@ -187,13 +219,13 @@ export interface AIContextRegistry {
      *             descriptive: this.deal.descriptive
      *         }
      *     })
-     * });
+     * }, this.host);
      *
      * // Later, when component is disconnected:
      * unregister();
      * ```
      */
-    register(provider: AIContextProvider): () => void;
+    register(provider: AIContextProvider, element?: HTMLElement & LimeWebComponent): () => void;
     /**
      * Get all registered providers.
      *
@@ -206,11 +238,15 @@ export interface AIContextRegistry {
      * Gather context from all registered providers.
      *
      * Calls `getContext()` on each provider and collects the results.
-     * Providers that throw errors are skipped (with a warning logged).
+     * Providers that return `null` (indicating no context available) and
+     * providers that throw errors are skipped (errors log a warning).
+     *
+     * Each contribution is enriched with the component's `LimeWebComponentContext`
+     * if the provider was registered with an element reference.
      *
-     * @returns An array of context contributions, one from each provider
-     * that returned successfully.
+     * @returns An array of enriched context contributions, one from each
+     * provider that returned a non-null contribution.
      */
-    gatherContext(): AIContextContribution[];
+    gatherContext(): GatheredAIContext[];
 }
 //# sourceMappingURL=ai-context-registry.d.ts.map

package/dist/ai-context/ai-context-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-context-registry.d.ts","sourceRoot":"","sources":["../../src/ai-context/ai-context-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GACf,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEjC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;;;;;;;;OAYG;IACH,UAAU,IAAI,qBAAqB,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAAC;IAElD;;;;;;OAMG;IACH,YAAY,IAAI,iBAAiB,EAAE,CAAC;IAEpC;;;;;;;;OAQG;IACH,aAAa,IAAI,qBAAqB,EAAE,CAAC;CAC5C"}
+{"version":3,"file":"ai-context-registry.d.ts","sourceRoot":"","sources":["../../src/ai-context/ai-context-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GACf,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEjC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC5D;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;;;;;;;;;OAaG;IACH,UAAU,IAAI,qBAAqB,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,QAAQ,CACJ,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,WAAW,GAAG,gBAAgB,GACzC,MAAM,IAAI,CAAC;IAEd;;;;;;OAMG;IACH,YAAY,IAAI,iBAAiB,EAAE,CAAC;IAEpC;;;;;;;;;;;;OAYG;IACH,aAAa,IAAI,iBAAiB,EAAE,CAAC;CACxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limetech/lime-web-components",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "description": "Lime Web Components",
   "author": "Lime Technologies",
   "license": "Apache-2.0",
@@ -35,13 +35,13 @@
     "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@commitlint/config-conventional": "^20.3.1",
+    "@commitlint/config-conventional": "^20.4.1",
     "@limetech/eslint-config": "^4.0.0",
-    "@microsoft/api-extractor": "^7.55.2",
+    "@microsoft/api-extractor": "^7.56.3",
     "eslint": "^9.39.2",
     "expect-type": "^1.3.0",
-    "globals": "^17.2.0",
-    "jsdom": "^27.4.0",
+    "globals": "^17.3.0",
+    "jsdom": "^28.0.0",
     "replace-in-file": "^8.4.0",
     "shelljs": "0.10.0",
     "typedoc": "^0.23.24",