@pillar-ai/sdk 0.1.15 → 0.1.16

package/dist/store/chat.d.ts

@@ -2,7 +2,7 @@
  * Chat Store
  * Signal-based state for chat messages and interaction
  */
-import type { ArticleSummary, ChatMessage, ConversationSummary, HistoryMessage } from "../api/client";
+import type { ArticleSummary, ChatMessage, ConversationSummary, HistoryMessage, DisplayStep } from "../api/client";
 import type { ChatImage } from "../api/mcp-client";
 import type { TaskButtonData } from "../components/Panel/TaskButton";
 import type { UserContextItem } from "../types/user-context";
@@ -54,7 +54,7 @@ export interface InterruptedSession {
     conversationId: string;
     userMessage: string;
     partialResponse: string;
-    summary: string;
+    displayTrace: DisplayStep[];
     elapsedMs: number;
 }
 export declare const interruptedSession: import("@preact/signals-core").Signal<InterruptedSession | null>;
@@ -157,6 +157,7 @@ export declare const submitPendingTrigger: import("@preact/signals-core").Signal
 export declare const focusInputTrigger: import("@preact/signals-core").Signal<number>;
 export declare const userContext: import("@preact/signals-core").Signal<UserContextItem[]>;
 export declare const pendingUserContext: import("@preact/signals-core").Signal<UserContextItem[]>;
+export declare const pendingImagesForNavigation: import("@preact/signals-core").Signal<ChatImage[]>;
 export type ImageUploadStatus = "uploading" | "ready" | "error";
 export interface PendingImage {
     id: string;
@@ -165,12 +166,13 @@ export interface PendingImage {
     status: ImageUploadStatus;
     url?: string;
     error?: string;
+    path?: string;
 }
 export declare const pendingImages: import("@preact/signals-core").Signal<PendingImage[]>;
 export declare const isUploadingImages: import("@preact/signals-core").ReadonlySignal<boolean>;
 export declare const getReadyImages: () => ChatImage[];
 export declare const addPendingImage: (image: PendingImage) => void;
-export declare const updateImageStatus: (id: string, status: ImageUploadStatus, url?: string, error?: string) => void;
+export declare const updateImageStatus: (id: string, status: ImageUploadStatus, url?: string, error?: string, path?: string) => void;
 export declare const removePendingImage: (id: string) => void;
 export declare const clearPendingImages: () => void;
 export declare const hasMessages: import("@preact/signals-core").ReadonlySignal<boolean>;
@@ -238,6 +240,8 @@ export declare const removeUserContext: (id: string) => void;
 export declare const clearUserContext: () => void;
 export declare const setPendingUserContext: (items: UserContextItem[]) => void;
 export declare const clearPendingUserContext: () => void;
+export declare const setPendingImagesForNavigation: (images: ChatImage[]) => void;
+export declare const clearPendingImagesForNavigation: () => void;
 export declare const resetChat: () => void;
 /**
  * Start loading a conversation from history.

package/dist/store/panel.d.ts

@@ -3,6 +3,15 @@
  * Signal-based state for panel open/close and configuration
  */
 import type { PanelPosition, PanelMode } from '../core/config';
+/**
+ * Load panel width from localStorage.
+ * Returns null if not set or on error.
+ */
+export declare function loadPanelWidth(): number | null;
+/**
+ * Save panel width to localStorage.
+ */
+export declare function savePanelWidth(w: number): void;
 export declare const isOpen: import("@preact/signals-core").Signal<boolean>;
 export declare const activeTab: import("@preact/signals-core").Signal<string>;
 export declare const position: import("@preact/signals-core").Signal<PanelPosition>;

package/dist/styles/panel-styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Panel Styles Aggregator
+ * Imports all CSS files that are injected into the Panel (Shadow DOM or head)
+ * and exports them as a single concatenated string.
+ */
+export declare const ALL_PANEL_STYLES: string;

package/dist/styles/theme.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Theme CSS Generation
+ * Runtime functions for generating CSS variable overrides from theme config.
+ */
+import type { ResolvedThemeConfig, ThemeColors } from "../core/config";
+/**
+ * Generate CSS variable overrides from theme colors
+ */
+export declare function generateThemeVariables(colors: ThemeColors, prefix?: string): string;
+/**
+ * Generate custom theme CSS from config
+ */
+export declare function generateThemeCSS(theme: ResolvedThemeConfig): string;

package/dist/types/dom-scanner.d.ts

@@ -42,6 +42,25 @@ export interface CompactScanResult {
     /** Title of the page */
     title: string;
 }
+/** Result of a delta scan showing only changes since the last scan */
+export interface DeltaScanResult {
+    /** Formatted delta string for LLM context, or null if no changes */
+    content: string | null;
+    /** Ref IDs of elements no longer on the page */
+    removedRefs: string[];
+    /** Number of new interactable elements found */
+    newInteractableCount: number;
+    /** Total interactable elements currently on the page */
+    totalInteractableCount: number;
+    /** Whether any changes were detected */
+    hasChanges: boolean;
+    /** Timestamp when scan was performed */
+    timestamp: number;
+    /** URL of the page that was scanned */
+    url: string;
+    /** Title of the page */
+    title: string;
+}
 /** HTML tags that are inherently interactable */
 export declare const INTERACTABLE_TAGS: Set<string>;
 /** ARIA roles that indicate interactability */

package/dist/utils/dom-scanner.d.ts

@@ -2,10 +2,10 @@
  * DOM Scanner Utilities
  * Scans the DOM and outputs compact text representation for LLM context
  */
-import { type CompactScanResult, type InteractionType, type ScanOptions } from "../types/dom-scanner";
+import { type CompactScanResult, type DeltaScanResult, type InteractionType, type ScanOptions } from "../types/dom-scanner";
 /**
  * Clear all pillar refs from the DOM.
- * Called before scanning to remove stale refs.
+ * Called before full scans to remove stale refs and reset counter.
  */
 export declare function clearPillarRefs(): void;
 /**
@@ -68,3 +68,16 @@ export declare function buildSelectorFromRef(shortRef: string): string;
  * ```
  */
 export declare function scanPageDirect(options?: ScanOptions): CompactScanResult;
+/**
+ * Delta DOM scanner that only returns changes since the last scan.
+ * Reuses existing refs on elements, assigns new refs only to new elements.
+ * Compares output lines against the previous scan to find new content.
+ *
+ * Must be called after an initial `scanPageDirect()` which establishes
+ * the baseline. If called without a prior scan, behaves like a full scan
+ * but without the header/footer framing.
+ *
+ * @param options - Scan options
+ * @returns Delta scan result with only new lines and removed ref IDs
+ */
+export declare function scanPageDelta(options?: ScanOptions): DeltaScanResult;

package/dist/utils/markdown-components.d.ts

@@ -50,4 +50,3 @@ export interface ProgressIndicatorProps {
     isActive?: boolean;
 }
 export declare function ProgressIndicator({ message, isActive, }: ProgressIndicatorProps): VNode;
-export declare const MARKDOWN_COMPONENT_STYLES = "\n/* Collapsible Section */\n._pillar-collapsible {\n  margin: 2px 0;\n}\n\n._pillar-collapsible-header {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 4px 0;\n  background: transparent;\n  border: none;\n  border-radius: 4px;\n  cursor: pointer;\n  font-size: 13px;\n  font-weight: 500;\n  color: var(--pillar-text-secondary, #6b7280);\n  font-family: inherit;\n  width: 100%;\n  text-align: left;\n  transition: background-color 0.15s ease;\n}\n\n._pillar-collapsible-header:hover {\n  background: var(--pillar-bg-hover, rgba(0, 0, 0, 0.05));\n}\n\n._pillar-collapsible-icon {\n  font-size: 10px;\n  color: var(--pillar-text-muted, #9ca3af);\n}\n\n._pillar-collapsible-title {\n  flex: 1;\n}\n\n._pillar-collapsible-content-wrapper {\n  display: grid;\n  grid-template-rows: 0fr;\n  transition: grid-template-rows 0.2s ease;\n}\n\n._pillar-collapsible-content-wrapper--expanded {\n  grid-template-rows: 1fr;\n}\n\n._pillar-collapsible-content {\n  overflow: hidden;\n  padding-left: 18px;\n  font-size: 13px;\n  color: var(--pillar-text-secondary, #6b7280);\n  line-height: 1.4;\n}\n\n._pillar-collapsible-content-wrapper--expanded ._pillar-collapsible-content {\n  padding-top: 2px;\n  padding-bottom: 4px;\n}\n\n/* Source List */\n._pillar-source-list {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  margin: 4px 0;\n}\n\n._pillar-source-item {\n  display: block;\n  padding: 4px 8px;\n  font-size: 12px;\n  color: var(--pillar-primary, #2563eb);\n  text-decoration: none;\n  border-radius: 4px;\n  transition: background-color 0.15s ease;\n}\n\n._pillar-source-item:hover {\n  background: var(--pillar-bg-hover, rgba(0, 0, 0, 0.05));\n  text-decoration: underline;\n}\n\n/* Task List */\n._pillar-task-list {\n  list-style: none;\n  padding: 0;\n  margin: 8px 0;\n}\n\n._pillar-task-item {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  padding: 4px 0;\n  font-size: 13px;\n}\n\n._pillar-task-item--completed ._pillar-task-text {\n  text-decoration: line-through;\n  color: var(--pillar-text-placeholder, #9ca3af);\n}\n\n._pillar-task-checkbox {\n  width: 16px;\n  height: 16px;\n  cursor: pointer;\n}\n\n/* Code Block */\n._pillar-code-block {\n  margin: 8px 0;\n  border-radius: 8px;\n  overflow: hidden;\n  background: var(--pillar-bg-code, #1e1e1e);\n}\n\n._pillar-code-header {\n  display: flex;\n  justify-content: space-between;\n  align-items: center;\n  padding: 8px 12px;\n  background: var(--pillar-bg-code-header, #2d2d2d);\n  border-bottom: 1px solid var(--pillar-border-code, #404040);\n}\n\n._pillar-code-language {\n  font-size: 11px;\n  font-weight: 500;\n  color: var(--pillar-text-code-header, #a0a0a0);\n  text-transform: uppercase;\n}\n\n._pillar-code-copy {\n  padding: 4px 8px;\n  font-size: 11px;\n  font-family: inherit;\n  background: transparent;\n  border: 1px solid var(--pillar-border-code, #404040);\n  border-radius: 4px;\n  color: var(--pillar-text-code-header, #a0a0a0);\n  cursor: pointer;\n  transition: all 0.15s ease;\n}\n\n._pillar-code-copy:hover {\n  background: var(--pillar-bg-code-hover, #404040);\n  color: #fff;\n}\n\n._pillar-code-pre {\n  margin: 0;\n  padding: 12px;\n  overflow-x: auto;\n  font-family: 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, monospace;\n  font-size: 13px;\n  line-height: 1.5;\n}\n\n._pillar-code-content {\n  color: var(--pillar-text-code, #e0e0e0);\n}\n\n/* Action Buttons */\n._pillar-action-buttons {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 8px;\n  margin: 8px 0;\n}\n\n._pillar-action-button {\n  padding: 8px 16px;\n  font-size: 13px;\n  font-weight: 500;\n  font-family: inherit;\n  background: var(--pillar-primary, #2563eb);\n  color: #fff;\n  border: none;\n  border-radius: 6px;\n  cursor: pointer;\n  transition: all 0.15s ease;\n}\n\n._pillar-action-button:hover {\n  background: var(--pillar-primary-hover, #1d4ed8);\n}\n\n/* Progress Indicator */\n._pillar-progress-indicator {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 4px 0;\n  font-size: 13px;\n  color: var(--pillar-text-secondary, #6b7280);\n}\n\n._pillar-progress-indicator--active ._pillar-loading-spinner {\n  display: inline-block;\n}\n\n/* Streaming Thinking Content */\n._pillar-progress-row--streaming {\n  margin: 2px 0;\n}\n\n._pillar-thinking-header {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 4px 0;\n  font-size: 13px;\n  font-weight: 500;\n  color: var(--pillar-text-secondary, #6b7280);\n}\n\n._pillar-thinking-icon {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 16px;\n  height: 16px;\n}\n\n._pillar-spinner {\n  width: 12px;\n  height: 12px;\n  border: 2px solid var(--pillar-border, #e5e7eb);\n  border-top-color: var(--pillar-primary, #2563eb);\n  border-radius: 50%;\n  animation: pillar-spin 0.8s linear infinite;\n}\n\n@keyframes pillar-spin {\n  to { transform: rotate(360deg); }\n}\n\n._pillar-thinking-label {\n  flex: 1;\n}\n\n._pillar-thinking-content {\n  padding: 6px 10px;\n  font-size: 13px;\n  line-height: 1.4;\n  color: var(--pillar-text-secondary, #6b7280);\n  background: var(--pillar-bg-tertiary, #f9fafb);\n  border-radius: 4px;\n  margin-top: 2px;\n  max-height: 150px;\n  overflow-y: auto;\n}\n";

package/dist/utils/preact-markdown.d.ts

@@ -14,4 +14,3 @@ export interface PreactMarkdownProps {
  * Supports custom component markers in code blocks and HTML-like syntax.
  */
 export declare function PreactMarkdown({ content, class: className }: PreactMarkdownProps): VNode;
-export declare const PREACT_MARKDOWN_STYLES = "\n/* Base markdown container */\n._pillar-markdown {\n  font-size: 14px;\n  line-height: 1.6;\n  color: var(--pillar-text, #1a1a1a);\n}\n\n/* Headings */\n._pillar-md-heading {\n  margin: 16px 0 8px 0;\n  font-weight: 600;\n  line-height: 1.3;\n}\n\n._pillar-md-h1 { font-size: 1.5em; }\n._pillar-md-h2 { font-size: 1.3em; }\n._pillar-md-h3 { font-size: 1.15em; }\n._pillar-md-h4 { font-size: 1em; }\n._pillar-md-h5 { font-size: 0.95em; }\n._pillar-md-h6 { font-size: 0.9em; }\n\n/* Paragraphs */\n._pillar-md-paragraph {\n  margin: 8px 0;\n}\n\n/* Links */\n._pillar-md-link {\n  color: var(--pillar-primary, #2563eb);\n  text-decoration: none;\n}\n\n._pillar-md-link:hover {\n  text-decoration: underline;\n}\n\n/* Inline code */\n._pillar-md-code-inline {\n  padding: 2px 6px;\n  font-family: 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, monospace;\n  font-size: 0.9em;\n  background: var(--pillar-bg-code-inline, #f3f4f6);\n  border-radius: 4px;\n}\n\n/* Lists */\n._pillar-md-list {\n  margin: 8px 0;\n  padding-left: 24px;\n}\n\n._pillar-md-list-item {\n  margin: 4px 0;\n}\n\n/* Task list items */\n._pillar-md-task-item {\n  display: flex;\n  align-items: flex-start;\n  gap: 8px;\n  list-style: none;\n  margin-left: -24px;\n}\n\n._pillar-md-task-checkbox {\n  margin-top: 4px;\n}\n\n._pillar-md-task-text--checked {\n  text-decoration: line-through;\n  color: var(--pillar-text-placeholder, #9ca3af);\n}\n\n/* Blockquote */\n._pillar-md-blockquote {\n  margin: 8px 0;\n  padding: 8px 16px;\n  border-left: 3px solid var(--pillar-border, #e5e7eb);\n  color: var(--pillar-text-muted, #6b7280);\n  background: var(--pillar-bg-secondary, #f9fafb);\n}\n\n/* Horizontal rule */\n._pillar-md-hr {\n  margin: 16px 0;\n  border: none;\n  border-top: 1px solid var(--pillar-border, #e5e7eb);\n}\n\n/* Tables */\n._pillar-md-table-wrapper {\n  overflow-x: auto;\n  margin: 8px 0;\n}\n\n._pillar-md-table {\n  width: 100%;\n  border-collapse: collapse;\n  font-size: 13px;\n}\n\n._pillar-md-th,\n._pillar-md-td {\n  padding: 8px 12px;\n  border: 1px solid var(--pillar-border, #e5e7eb);\n  text-align: left;\n}\n\n._pillar-md-th {\n  background: var(--pillar-bg-secondary, #f9fafb);\n  font-weight: 600;\n}\n\n/* Images */\n._pillar-md-image {\n  max-width: 100%;\n  height: auto;\n  border-radius: 8px;\n  margin: 8px 0;\n}\n";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pillar-ai/sdk",
-  "version": "0.1.15",
-  "description": "Pillar Embedded Help SDK - Add contextual help and AI chat to your application",
+  "version": "0.1.16",
+  "description": "Product copilot SDK for SaaS and web apps — AI assistant that executes tasks, not just answers questions",
   "type": "module",
   "main": "./dist/pillar.esm.js",
   "module": "./dist/pillar.esm.js",
@@ -32,12 +32,15 @@
     "prepublishOnly": "npm run build"
   },
   "keywords": [
-    "help",
-    "documentation",
-    "support",
-    "chat",
+    "copilot",
+    "assistant",
     "ai",
-    "embedded"
+    "sdk",
+    "saas",
+    "embedded",
+    "agent",
+    "support",
+    "chat"
   ],
   "author": "Pillar Team",
   "license": "MIT",