@pillar-ai/sdk 0.1.0

package/dist/store/chat.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Chat Store
+ * Signal-based state for chat messages and interaction
+ */
+import type { ArticleSummary, ChatMessage } from '../api/client';
+import type { ChatImage } from '../api/mcp-client';
+import type { TaskButtonData } from '../components/Panel/TaskButton';
+import type { UserContextItem } from '../types/user-context';
+export type { ChatImage } from '../api/mcp-client';
+export interface ActionStatus {
+    status: 'pending' | 'success' | 'failed';
+    completedAt?: number;
+    errorMessage?: string;
+}
+export interface StoredChatMessage extends ChatMessage {
+    id?: string;
+    feedback?: 'up' | 'down' | null;
+    actions?: TaskButtonData[];
+    sources?: ArticleSummary[];
+    actionStatus?: Record<string, ActionStatus>;
+    userContext?: UserContextItem[];
+    images?: ChatImage[];
+}
+export declare const messages: import("@preact/signals-core").Signal<StoredChatMessage[]>;
+export declare const conversationId: import("@preact/signals-core").Signal<string | null>;
+export declare const isLoading: import("@preact/signals-core").Signal<boolean>;
+export interface ProgressStatus {
+    kind: 'search' | 'search_complete' | 'generating' | 'thinking' | null;
+    message?: string;
+}
+export declare const progressStatus: import("@preact/signals-core").Signal<ProgressStatus>;
+export declare const isExpanded: import("@preact/signals-core").Signal<boolean>;
+export declare const currentSources: import("@preact/signals-core").Signal<ArticleSummary[]>;
+export declare const currentActions: import("@preact/signals-core").Signal<TaskButtonData[]>;
+export declare const prefillText: import("@preact/signals-core").Signal<string>;
+export declare const pendingMessage: import("@preact/signals-core").Signal<string | null>;
+export declare const focusInputTrigger: import("@preact/signals-core").Signal<number>;
+export declare const userContext: import("@preact/signals-core").Signal<import("../types").HighlightedTextContext[]>;
+export declare const pendingUserContext: import("@preact/signals-core").Signal<import("../types").HighlightedTextContext[]>;
+export type ImageUploadStatus = 'uploading' | 'ready' | 'error';
+export interface PendingImage {
+    id: string;
+    file: File;
+    preview: string;
+    status: ImageUploadStatus;
+    url?: string;
+    error?: 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 removePendingImage: (id: string) => void;
+export declare const clearPendingImages: () => void;
+export declare const hasMessages: import("@preact/signals-core").ReadonlySignal<boolean>;
+export declare const addUserMessage: (content: string, userContext?: UserContextItem[], images?: ChatImage[]) => void;
+export declare const addAssistantMessage: (content: string, messageId?: string) => void;
+export declare const updateLastAssistantMessage: (content: string, messageId?: string, actions?: TaskButtonData[], sources?: ArticleSummary[]) => void;
+export declare const setActionPending: (messageIndex: number, actionName: string) => void;
+export declare const setActionComplete: (actionName: string, success: boolean, errorMessage?: string) => void;
+export declare const updateMessageContent: (messageIndex: number, content: string) => void;
+export declare const updateActionMessageContent: (actionName: string, content: string) => void;
+export declare const setConversationId: (id: string) => void;
+export declare const clearConversationId: () => void;
+export declare const setMessageFeedback: (messageId: string, feedback: "up" | "down") => void;
+export declare const setSources: (sources: ArticleSummary[]) => void;
+export declare const setActions: (actions: TaskButtonData[]) => void;
+export declare const clearActions: () => void;
+export declare const setLoading: (loading: boolean) => void;
+export declare const setProgressStatus: (status: ProgressStatus) => void;
+export declare const clearProgressStatus: () => void;
+export declare const expandChat: () => void;
+export declare const collapseChat: () => void;
+export declare const setPrefillText: (text: string) => void;
+export declare const clearPrefillText: () => void;
+export declare const setPendingMessage: (message: string) => void;
+export declare const clearPendingMessage: () => void;
+export declare const triggerInputFocus: () => void;
+export declare const addUserContext: (item: Omit<UserContextItem, "id">) => void;
+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 resetChat: () => void;

package/dist/store/context.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Context Store
+ * Signal-based state for product context and user profile
+ *
+ * Phase 3: Product Integration - Context-aware assistance
+ */
+import type { ProductContext, UserProfile } from '../core/context';
+export declare const productContext: import("@preact/signals-core").Signal<ProductContext>;
+export declare const userProfile: import("@preact/signals-core").Signal<UserProfile>;
+export declare const hasContext: import("@preact/signals-core").ReadonlySignal<boolean>;
+export declare const hasError: import("@preact/signals-core").ReadonlySignal<boolean>;
+/**
+ * Set the complete product context.
+ */
+export declare const setProductContext: (context: ProductContext) => void;
+/**
+ * Update specific product context fields.
+ */
+export declare const updateContext: (updates: Partial<ProductContext>) => void;
+/**
+ * Set user profile.
+ */
+export declare const setUserProfile: (profile: UserProfile) => void;
+/**
+ * Report a user action.
+ */
+export declare const reportAction: (action: string) => void;
+/**
+ * Set error state.
+ */
+export declare const setErrorState: (code: string, message: string) => void;
+/**
+ * Clear error state.
+ */
+export declare const clearErrorState: () => void;
+/**
+ * Get the full assistant context for API calls.
+ */
+export declare const getAssistantContext: () => {
+    product: ProductContext;
+    user_profile: UserProfile;
+};
+/**
+ * Reset all context state.
+ */
+export declare const resetContext: () => void;

package/dist/store/developer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Developer Store
+ * Signal-based state for developer mode features
+ */
+export declare const selectedAction: import("@preact/signals-core").Signal<string | null>;
+export declare const actionData: import("@preact/signals-core").Signal<string>;
+export declare const executionResult: import("@preact/signals-core").Signal<{
+    type: "success" | "error";
+    message: string;
+} | null>;
+export declare const isExecuting: import("@preact/signals-core").Signal<boolean>;
+export declare const setSelectedAction: (actionName: string | null) => void;
+export declare const setActionData: (data: string) => void;
+export declare const setExecutionResult: (result: {
+    type: "success" | "error";
+    message: string;
+} | null) => void;
+export declare const setIsExecuting: (executing: boolean) => void;
+export declare const resetDeveloperStore: () => void;

package/dist/store/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Store Index
+ * Re-exports all signal stores
+ */
+export * as panelStore from './panel';
+export * as routerStore from './router';
+export * as chatStore from './chat';
+export * as tooltipsStore from './tooltips';
+export * as contextStore from './context';
+export * as workflowStore from './workflow';

package/dist/store/panel.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Panel Store
+ * Signal-based state for panel open/close and configuration
+ */
+import type { PanelPosition, PanelMode } from '../core/config';
+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>;
+export declare const mode: import("@preact/signals-core").Signal<PanelMode>;
+export declare const width: import("@preact/signals-core").Signal<number>;
+export declare const hoverBreakpoint: import("@preact/signals-core").Signal<number | false>;
+export declare const hoverBackdrop: import("@preact/signals-core").Signal<boolean>;
+export declare const viewportWidth: import("@preact/signals-core").Signal<number>;
+/**
+ * Whether the panel is currently in hover mode based on viewport width
+ * Returns true when viewport is below hoverBreakpoint (and breakpoint is not disabled)
+ */
+export declare const isHoverMode: import("@preact/signals-core").ReadonlySignal<boolean>;
+/**
+ * The effective panel mode based on responsive breakpoint
+ * Returns 'overlay' when in hover mode (below breakpoint), otherwise returns configured mode
+ */
+export declare const effectiveMode: import("@preact/signals-core").ReadonlySignal<PanelMode>;
+export declare const panelClass: import("@preact/signals-core").ReadonlySignal<string>;
+export declare const openPanel: () => void;
+export declare const closePanel: () => void;
+export declare const togglePanel: () => void;
+export declare const setPosition: (pos: PanelPosition) => void;
+export declare const setMode: (m: PanelMode) => void;
+export declare const setWidth: (w: number) => void;
+export declare const setHoverBreakpoint: (bp: number | false) => void;
+export declare const setHoverBackdrop: (show: boolean) => void;
+export declare const setActiveTab: (tabId: string) => void;
+/**
+ * Initialize the viewport resize listener for responsive behavior
+ * Should be called once during SDK initialization
+ */
+export declare const initViewportListener: () => void;
+/**
+ * Clean up the viewport resize listener
+ */
+export declare const destroyViewportListener: () => void;
+export declare const resetPanel: () => void;

package/dist/store/plan-persistence.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Plan Persistence Module
+ *
+ * Handles localStorage persistence for active execution plans.
+ * Enables plan recovery when the page is refreshed or the user
+ * navigates away and returns.
+ */
+import type { ExecutionPlan } from '../core/plan';
+/**
+ * Save the active plan to localStorage.
+ *
+ * @param plan - The plan to persist
+ * @param siteId - The site ID for scoping
+ */
+export declare function savePlan(plan: ExecutionPlan, siteId: string): void;
+/**
+ * Load a saved plan from localStorage.
+ *
+ * @param siteId - The site ID for scoping
+ * @returns The saved plan or null if not found/invalid
+ */
+export declare function loadSavedPlan(siteId: string): ExecutionPlan | null;
+/**
+ * Clear any saved plan from localStorage.
+ *
+ * @param siteId - The site ID for scoping
+ */
+export declare function clearSavedPlan(siteId: string): void;
+/**
+ * Check if there's a saved plan without loading it.
+ *
+ * @param siteId - The site ID for scoping
+ * @returns true if a plan exists
+ */
+export declare function hasSavedPlan(siteId: string): boolean;
+/**
+ * Get metadata about the saved plan without full deserialization.
+ *
+ * @param siteId - The site ID for scoping
+ * @returns Plan metadata or null
+ */
+export declare function getSavedPlanMetadata(siteId: string): {
+    planId: string;
+    goal: string;
+    storedAt: string;
+    status: string;
+} | null;

package/dist/store/plan.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Plan Store
+ * Signal-based state management for multi-step execution plans.
+ */
+import type { ExecutionPlan, ExecutionStep } from '../core/plan';
+/** Active execution plan (only one at a time) */
+export declare const activePlan: import("@preact/signals-core").Signal<ExecutionPlan | null>;
+/** Completed/cancelled plans for the session (for analytics/history) */
+export declare const planHistory: import("@preact/signals-core").Signal<ExecutionPlan[]>;
+/** Whether there's an active plan */
+export declare const hasActivePlan: import("@preact/signals-core").ReadonlySignal<boolean>;
+/** Current step of the active plan (first ready or executing step) */
+export declare const currentPlanStep: import("@preact/signals-core").ReadonlySignal<ExecutionStep | null>;
+/** Number of completed or skipped steps */
+export declare const completedPlanStepsCount: import("@preact/signals-core").ReadonlySignal<number>;
+/** Progress as a fraction (0-1) */
+export declare const planProgress: import("@preact/signals-core").ReadonlySignal<number>;
+/** Whether the plan is awaiting user to start it */
+export declare const isPlanAwaitingStart: import("@preact/signals-core").ReadonlySignal<boolean>;
+/**
+ * Set a new active plan.
+ * Replaces any existing active plan.
+ */
+export declare function setPlan(plan: ExecutionPlan): void;
+/**
+ * Update the active plan with new data from server.
+ */
+export declare function updatePlan(plan: ExecutionPlan): void;
+/**
+ * Update a specific step in the active plan.
+ */
+export declare function updatePlanStep(stepId: string, updates: Partial<ExecutionStep>): void;
+/**
+ * Clear the active plan.
+ * Optionally moves it to history.
+ */
+export declare function clearPlan(addToHistory?: boolean): void;
+/**
+ * Get a step by ID from the active plan.
+ */
+export declare function getPlanStep(stepId: string): ExecutionStep | undefined;
+/**
+ * Reset all plan state.
+ */
+export declare function resetPlanStore(): void;

package/dist/store/router.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Router Store
+ * Signal-based state for panel navigation
+ */
+export type ViewType = 'home' | 'chat';
+export interface ViewState {
+    type: ViewType;
+    params?: Record<string, string>;
+}
+export declare const viewStack: import("@preact/signals-core").Signal<ViewState[]>;
+export declare const currentView: import("@preact/signals-core").Signal<ViewState>;
+export declare const canGoBack: import("@preact/signals-core").ReadonlySignal<boolean>;
+export declare const isAtHome: import("@preact/signals-core").ReadonlySignal<boolean>;
+export declare const navigate: (view: ViewType, params?: Record<string, string>) => void;
+export declare const goBack: () => void;
+export declare const goHome: () => void;
+export declare const resetRouter: () => void;
+export declare const navigateToChat: () => void;

package/dist/store/tooltips.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tooltips Store
+ * Signal-based state for tooltip visibility and data
+ */
+import type { TooltipData } from '../api/client';
+export interface TooltipInstance {
+    id: string;
+    data: TooltipData;
+    anchor: HTMLElement;
+    isVisible: boolean;
+}
+export declare const tooltips: import("@preact/signals-core").Signal<Map<string, TooltipInstance>>;
+export declare const visibleTooltipId: import("@preact/signals-core").Signal<string | null>;
+export declare const visibleTooltip: import("@preact/signals-core").ReadonlySignal<TooltipInstance | null>;
+export declare const tooltipCount: import("@preact/signals-core").ReadonlySignal<number>;
+export declare const registerTooltip: (id: string, data: TooltipData, anchor: HTMLElement) => void;
+export declare const unregisterTooltip: (id: string) => void;
+export declare const showTooltip: (id: string) => void;
+export declare const hideTooltip: (id: string) => void;
+export declare const hideAllTooltips: () => void;
+export declare const resetTooltips: () => void;

package/dist/store/workflow.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Workflow Store
+ * Signal-based state management for multi-step workflows
+ */
+import type { Workflow, WorkflowStep, WorkflowStepStatus } from '../core/workflow';
+/** Active workflow (only one at a time) */
+export declare const activeWorkflow: import("@preact/signals-core").Signal<Workflow | null>;
+/** Completed/cancelled workflows for the session (for analytics/history) */
+export declare const workflowHistory: import("@preact/signals-core").Signal<Workflow[]>;
+/** Whether there's an active workflow */
+export declare const hasActiveWorkflow: import("@preact/signals-core").ReadonlySignal<boolean>;
+/** Current step of the active workflow */
+export declare const currentStep: import("@preact/signals-core").ReadonlySignal<WorkflowStep | null>;
+/** Number of completed steps */
+export declare const completedStepsCount: import("@preact/signals-core").ReadonlySignal<number>;
+/** Progress as a fraction (0-1) */
+export declare const workflowProgress: import("@preact/signals-core").ReadonlySignal<number>;
+/**
+ * Start a new workflow.
+ * Sets the first step to either 'active' or 'awaiting_initiation' based on auto_run.
+ */
+export declare function startWorkflow(workflow: Workflow): void;
+/**
+ * Update a step's status.
+ */
+export declare function updateStepStatus(stepIndex: number, status: WorkflowStepStatus): void;
+/**
+ * Advance to the next step in the workflow.
+ * Returns the next step, or null if workflow is complete.
+ */
+export declare function advanceToNextStep(): WorkflowStep | null;
+/**
+ * Complete the current workflow.
+ * Moves it to history and clears active workflow.
+ */
+export declare function completeWorkflow(): Workflow | null;
+/**
+ * Cancel the active workflow.
+ */
+export declare function cancelWorkflow(): Workflow | null;
+/**
+ * Get the current active step.
+ */
+export declare function getCurrentStep(): WorkflowStep | null;
+/**
+ * Reset all workflow state.
+ */
+export declare function resetWorkflow(): void;

package/dist/tooltips/Tooltip.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Individual Tooltip Component
+ * Handles rendering and positioning of a single tooltip
+ */
+import type { TooltipData } from '../api/client';
+import type { TooltipTrigger, TooltipPosition } from '../core/config';
+export interface TooltipOptions {
+    trigger: TooltipTrigger;
+    position: TooltipPosition;
+    onLearnMore?: (articleSlug: string) => void;
+    onShow?: () => void;
+    onHide?: () => void;
+}
+export declare class Tooltip {
+    private id;
+    private data;
+    private anchor;
+    private options;
+    private element;
+    private arrow;
+    private iconElement;
+    private isVisible;
+    private hideTimeout;
+    constructor(data: TooltipData, anchor: HTMLElement, options: TooltipOptions);
+    /**
+     * Initialize the tooltip
+     */
+    init(): void;
+    /**
+     * Show the tooltip
+     */
+    show(): void;
+    /**
+     * Hide the tooltip
+     */
+    hide(): void;
+    /**
+     * Toggle tooltip visibility
+     */
+    toggle(): void;
+    /**
+     * Update tooltip position
+     */
+    updatePosition(): void;
+    /**
+     * Destroy the tooltip
+     */
+    destroy(): void;
+    private createElement;
+    private createIcon;
+    private bindEvents;
+    private unbindEvents;
+    private handleMouseEnter;
+    private handleTooltipMouseEnter;
+    private handleMouseLeave;
+    private handleClick;
+    private handleDocumentClick;
+    private handleFocus;
+    private handleBlur;
+    private handleKeyDown;
+    private handleScroll;
+    private handleResize;
+}

package/dist/tooltips/TooltipManager.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tooltip Manager
+ * Scans DOM for tooltip elements and manages their lifecycle
+ */
+import type { EventEmitter } from '../core/events';
+import type { ResolvedConfig } from '../core/config';
+import type { APIClient } from '../api/client';
+export declare class TooltipManager {
+    private config;
+    private api;
+    private events;
+    private tooltips;
+    private tooltipData;
+    private observer;
+    private stylesInjected;
+    constructor(config: ResolvedConfig, api: APIClient, events: EventEmitter);
+    /**
+     * Initialize the tooltip manager
+     */
+    init(): Promise<void>;
+    /**
+     * Scan DOM for tooltip elements and initialize them
+     */
+    scan(): Promise<void>;
+    /**
+     * Show a specific tooltip
+     */
+    show(tooltipId: string): void;
+    /**
+     * Hide a specific tooltip
+     */
+    hide(tooltipId: string): void;
+    /**
+     * Destroy the tooltip manager
+     */
+    destroy(): void;
+    private createTooltip;
+    private setupObserver;
+    private handleRemovedElement;
+    private getElementKey;
+    private getTooltipDataForElement;
+}

package/dist/tooltips/styles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tooltip CSS Styles
+ * Injected into the document head
+ */
+export declare const TOOLTIP_STYLES = "\n/* Pillar Tooltip Styles */\n.pillar-tooltip {\n  position: absolute;\n  z-index: 99999;\n  max-width: 320px;\n  padding: 12px 16px;\n  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;\n  font-size: 14px;\n  line-height: 1.5;\n  color: #1a1a1a;\n  background: #ffffff;\n  border-radius: 8px;\n  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.15), 0 0 0 1px rgba(0, 0, 0, 0.05);\n  pointer-events: auto;\n  opacity: 0;\n  transform: scale(0.95);\n  transition: opacity 0.15s ease, transform 0.15s ease;\n}\n\n.pillar-tooltip.pillar-tooltip--visible {\n  opacity: 1;\n  transform: scale(1);\n}\n\n.pillar-tooltip__content {\n  margin: 0;\n}\n\n.pillar-tooltip__content p {\n  margin: 0 0 8px;\n}\n\n.pillar-tooltip__content p:last-child {\n  margin-bottom: 0;\n}\n\n.pillar-tooltip__content a {\n  color: #2563eb;\n  text-decoration: none;\n}\n\n.pillar-tooltip__content a:hover {\n  text-decoration: underline;\n}\n\n.pillar-tooltip__learn-more {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  margin-top: 12px;\n  padding: 6px 12px;\n  font-size: 13px;\n  font-weight: 500;\n  color: #2563eb;\n  background: #eff6ff;\n  border: none;\n  border-radius: 6px;\n  cursor: pointer;\n  transition: background 0.15s ease;\n}\n\n.pillar-tooltip__learn-more:hover {\n  background: #dbeafe;\n}\n\n.pillar-tooltip__learn-more svg {\n  width: 14px;\n  height: 14px;\n}\n\n/* Arrow */\n.pillar-tooltip__arrow {\n  position: absolute;\n  width: 12px;\n  height: 12px;\n  background: #ffffff;\n  transform: rotate(45deg);\n  box-shadow: -1px -1px 0 0 rgba(0, 0, 0, 0.05);\n}\n\n.pillar-tooltip--top .pillar-tooltip__arrow {\n  bottom: -6px;\n  box-shadow: 1px 1px 0 0 rgba(0, 0, 0, 0.05);\n}\n\n.pillar-tooltip--bottom .pillar-tooltip__arrow {\n  top: -6px;\n}\n\n.pillar-tooltip--left .pillar-tooltip__arrow {\n  right: -6px;\n  box-shadow: 1px -1px 0 0 rgba(0, 0, 0, 0.05);\n}\n\n.pillar-tooltip--right .pillar-tooltip__arrow {\n  left: -6px;\n  box-shadow: -1px 1px 0 0 rgba(0, 0, 0, 0.05);\n}\n\n/* Tooltip Icon (for icon trigger) */\n.pillar-tooltip-icon {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 16px;\n  height: 16px;\n  margin-left: 4px;\n  vertical-align: middle;\n  color: #6b7280;\n  cursor: help;\n  transition: color 0.15s ease;\n}\n\n.pillar-tooltip-icon:hover {\n  color: #2563eb;\n}\n\n.pillar-tooltip-icon svg {\n  width: 100%;\n  height: 100%;\n}\n\n/* Close button */\n.pillar-tooltip__close {\n  position: absolute;\n  top: 8px;\n  right: 8px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 20px;\n  height: 20px;\n  padding: 0;\n  color: #9ca3af;\n  background: none;\n  border: none;\n  border-radius: 4px;\n  cursor: pointer;\n  transition: color 0.15s ease, background 0.15s ease;\n}\n\n.pillar-tooltip__close:hover {\n  color: #1a1a1a;\n  background: #f3f4f6;\n}\n\n.pillar-tooltip__close svg {\n  width: 12px;\n  height: 12px;\n}\n";

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Type exports for Pillar SDK
+ */
+export * from './user-context';

package/dist/types/user-context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * User Context Types
+ * Discriminated union for different types of context items
+ * that can be attached to chat messages.
+ */
+/** Base interface for all user context items */
+interface BaseUserContext {
+    /** Unique identifier for this context item (for removal) */
+    id: string;
+    /** Discriminator field */
+    type: string;
+}
+/** Highlighted text context from text selection feature */
+export interface HighlightedTextContext extends BaseUserContext {
+    type: 'highlighted_text';
+    /** The URL where the text was selected */
+    url_origin: string;
+    /** The selected text content */
+    text_content: string;
+}
+/** Union of all possible user context item types */
+export type UserContextItem = HighlightedTextContext;
+/** Generate a unique ID for a context item */
+export declare function generateContextId(): string;
+/** Type guard for highlighted text context */
+export declare function isHighlightedTextContext(item: UserContextItem): item is HighlightedTextContext;
+/** Get display label for a context item */
+export declare function getContextDisplayLabel(item: UserContextItem): string;
+export {};

package/dist/utils/dom.d.ts

@@ -0,0 +1,46 @@
+/**
+ * DOM Utilities for Pillar SDK
+ */
+/**
+ * Creates an HTML element with the given tag name and attributes
+ */
+export declare function createElement<K extends keyof HTMLElementTagNameMap>(tag: K, attributes?: Record<string, string>, children?: (Node | string)[]): HTMLElementTagNameMap[K];
+/**
+ * Safely inserts CSS into a Shadow DOM or document
+ */
+export declare function injectStyles(container: ShadowRoot | Document, css: string, id?: string): HTMLStyleElement;
+/**
+ * Gets the scrollable parent of an element
+ */
+export declare function getScrollParent(element: Element): Element | null;
+/**
+ * Gets the viewport dimensions
+ */
+export declare function getViewportDimensions(): {
+    width: number;
+    height: number;
+};
+/**
+ * Checks if an element is visible in the viewport
+ */
+export declare function isElementInViewport(element: Element): boolean;
+/**
+ * Waits for the DOM to be ready
+ */
+export declare function domReady(): Promise<void>;
+/**
+ * Escapes HTML special characters
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Debounces a function
+ */
+export declare function debounce<T extends unknown[]>(fn: (...args: T) => void, delay: number): (...args: T) => void;
+/**
+ * Throttles a function
+ */
+export declare function throttle<T extends unknown[]>(fn: (...args: T) => void, limit: number): (...args: T) => void;
+/**
+ * Generates a unique ID
+ */
+export declare function uniqueId(prefix?: string): string;

package/dist/utils/markdown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Markdown Renderer
+ * Uses marked library for parsing markdown to HTML
+ */
+/**
+ * Render markdown content to HTML
+ * Used for AI chat responses
+ */
+export declare function renderMarkdown(content: string): string;

package/dist/utils/positioning.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Positioning utilities for tooltips and floating elements
+ */
+export type Position = 'top' | 'bottom' | 'left' | 'right' | 'auto';
+export type Alignment = 'start' | 'center' | 'end';
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PositionResult {
+    x: number;
+    y: number;
+    position: Position;
+    arrowX?: number;
+    arrowY?: number;
+}
+interface PositionOptions {
+    position: Position;
+    alignment?: Alignment;
+    offset?: number;
+    padding?: number;
+    arrowSize?: number;
+}
+/**
+ * Gets the bounding rect of an element
+ */
+export declare function getElementRect(element: Element): Rect;
+/**
+ * Gets the viewport rect
+ */
+export declare function getViewportRect(): Rect;
+/**
+ * Calculates available space in each direction from an element
+ */
+export declare function getAvailableSpace(anchor: Rect, viewport: Rect, padding?: number): Record<Position, number>;
+/**
+ * Determines the best position for a floating element
+ */
+export declare function getBestPosition(anchor: Rect, floating: {
+    width: number;
+    height: number;
+}, options: PositionOptions): Position;
+/**
+ * Calculates the position of a floating element relative to an anchor
+ */
+export declare function calculatePosition(anchor: Rect, floating: {
+    width: number;
+    height: number;
+}, options: PositionOptions): PositionResult;
+export {};