@intelliweave/embedded 2.1.78 → 2.2.80

package/AGENTS.md

@@ -0,0 +1,12 @@
+# IntelliWeave SDK
+IntelliWeave (formerly Web Weaver) is an AI management platform and SDK that allows users to set up AI in their apps and websites. The SDK (this project) is written in
+TypeScript and uses Web Components for the built-in UI. Users of this SDK can choose to use the built-in UI or create their own custom UI by using the `IntelliWeave` class directly.
+
+The `WebWeaverEmbed` class is the entry point for the built-in Web Component-based UI.
+
+## Guidelines
+- Do not use a linter, it has not been set up yet.
+- Run `npm test` for testing code changes. The tests only cover logic, not UI. Due to the nature of older LLMs, sometimes the tests fail when the AI decides to behave differently. If you encounter this, run the test a second time to make sure.
+- Follow existing code styling
+- Make sure to include comments, even if they are redundant
+- Prefer inline code instead of small functions where possible, unless the code will be extensively reused or is complex enough to warrant abstraction

package/dist/component/component.d.ts

@@ -1105,6 +1105,8 @@ interface BuiltInActionFlags {
     allowChangeRoute?: boolean;
     /** Allows the AI to craft an email and use mailto: link */
     allowSendEmail?: boolean;
+    /** Allows the AI to trigger hidden embedded emoji effects in the built-in UI */
+    allowEmojiActions?: boolean;
     /** Makes the AI only use information from knowledge bases, not general knowledge */
     onlyUseKnowledgeBase?: boolean;
 }
@@ -1144,6 +1146,8 @@ interface WebWeaverGPTConfig {
     offsetX?: number;
     /** Vertical offset from edge in pixels (default: 20) - only used when positioningMode is 'fixed' */
     offsetY?: number;
+    /** Custom brand name displayed in the panel header kicker (replaces "IntelliWeave"). */
+    brandName?: string;
     /** Identifier of an external app or service which manages this persona, if any. (eg. "chatterly") */
     managedBy?: string;
     /** Voice information */
@@ -1366,6 +1370,16 @@ declare class WebWeaverEmbed extends BaseComponent {
     private _previousOpenState;
     /** Session start time for tracking UI session duration */
     private _uiSessionStartTime?;
+    /** Embedded action blocks already handled for each streamed message section */
+    private _handledEmbeddedActionBlocks;
+    /** If opened by mobile swipe from the collapsed tab, swipe-close should return to collapsed tab */
+    private _returnToCollapsedOnSwipeClose;
+    /** Suppress the next container click event (used after a swipe-close to prevent re-opening) */
+    private _suppressNextContainerClick;
+    /** Mobile swipe start point */
+    private _swipeStart?;
+    /** Previous fullscreen state for refreshing mobile scroll containment */
+    private _previousFullscreenState;
     /** Constructor */
     constructor();
     /** Content */
@@ -1385,10 +1399,14 @@ declare class WebWeaverEmbed extends BaseComponent {
     private _lastPositionY?;
     private _lastOffsetX?;
     private _lastOffsetY?;
+    private _lastBrandName?;
     /** Apply persona-based color variants as CSS variables */
     private applyPersonaColorVariants;
     /** Parse a color string to RGB (supports hex and rgb/rgba) */
     private parseColorToRGB;
+    /** Compute a complementary kicker color via hue-shift (+120°) from a given background color.
+     *  Returns null if the color cannot be parsed (so the CSS default is used). */
+    private computeKickerColor;
     /** Adjust inner container spacing based on logo aspect ratio */
     private adjustLogoPadding;
     /** Apply UI styles from config and attributes, prioritizing attributes */
@@ -1399,6 +1417,48 @@ declare class WebWeaverEmbed extends BaseComponent {
     onDestroy(): void;
     /** Called when the container is clicked */
     onContainerClick(e: Event): void;
+    /** Open from the floating dock button */
+    onDockOpenClick(e: Event): void;
+    /** Collapse the floating dock into a side tab */
+    onDockCollapseClick(e: Event): void;
+    /** Open from the collapsed side tab — show the dock/circle view first, not the full chat */
+    onCollapsedOpenClick(e: Event): void;
+    /** Collapse from the panel header */
+    onPanelCollapseClick(e: Event): void;
+    /** Toggle fullscreen state for widget layout */
+    onPanelFullscreenClick(e: Event): void;
+    /** Close the panel */
+    onPanelCloseClick(e: Event): void;
+    /** True if the UI cannot be manually closed/collapsed */
+    private isForcedOpen;
+    /** Open the normal panel from the dock button */
+    private openFromDock;
+    /** Refresh the chat scroller after fullscreen transitions, especially for iOS momentum scroll. */
+    private refreshContentScrollability;
+    /** Show the dock/circle view from the collapsed tab (without opening chat) */
+    private showDockFromCollapsed;
+    /** Open the panel from the collapsed tab */
+    private openFromCollapsed;
+    /** Close the panel, returning to the side tab when opened from the tab by swipe */
+    private closePanel;
+    /** Collapse the whole dock into the side tab */
+    private collapseDock;
+    /** Track pointer start for mobile horizontal swipe gestures */
+    onSwipePointerDown(e: PointerEvent): void;
+    /** Reset swipe tracking */
+    onSwipePointerCancel(): void;
+    /** Direction that moves into the viewport from the dock side. */
+    private inwardSwipeDirection;
+    /** Direction that moves back out toward the dock side. */
+    private outwardSwipeDirection;
+    /** True when a pointer release was a horizontal swipe in the requested direction */
+    private didSwipe;
+    /** Open the collapsed tab on mobile inward-swipe */
+    onCollapsedSwipePointerUp(e: PointerEvent): void;
+    /** Open the dock on mobile inward-swipe */
+    onDockSwipePointerUp(e: PointerEvent): void;
+    /** Close the panel on mobile outward-swipe */
+    onPanelSwipePointerUp(e: PointerEvent): void;
     /** Called when the logo is clicked */
     onLogoClick(e: Event): void;
     /** Open the interaction panel */
@@ -1416,7 +1476,17 @@ declare class WebWeaverEmbed extends BaseComponent {
     /** Called when the AI responds with some text */
     onAIMessage(messages: TokenWindowGroupItemParams<unknown>[], isPartial: boolean): Promise<void>;
     /** Updates a text element */
-    updateTextElement(elementID: string, text: string): void;
+    updateTextElement(elementID: string, text: string): boolean;
+    /** Execute supported hidden embedded actions from assistant text. */
+    private runEmbeddedAction;
+    /** Clamp unknown AI-provided numeric values before using them in the DOM. */
+    private clampNumber;
+    /** Keep AI-provided emoji text short enough to render safely as a visual effect. */
+    private normalizeEmojiActionValue;
+    /** Keep AI-provided suggestion text short enough to render safely as a button. */
+    private normalizeSuggestionActionValue;
+    /** Render a bounded burst of emoji particles in the embed overlay. */
+    private showEmojiBurst;
     /** Updates an info block element */
     updateInfoElement(elementID: string, text: string, iconType: string): void;
     /** Called when a suggestion button is clicked */
@@ -1427,6 +1497,7 @@ declare class WebWeaverEmbed extends BaseComponent {
     onContentScroll(e: Event): void;
     /** Displays whitelabeled branding for known apps */
     private updateBrandingFor;
+    private updateBrandingText;
 }
 
 /**