@pillar-ai/sdk 0.1.8 → 0.1.14

package/dist/store/chat.d.ts

@@ -20,23 +20,90 @@ export interface StoredChatMessage extends ChatMessage {
     actionStatus?: Record<string, ActionStatus>;
     userContext?: UserContextItem[];
     images?: ChatImage[];
+    progressEvents?: ProgressEvent[];
 }
 export declare const messages: import("@preact/signals-core").Signal<StoredChatMessage[]>;
 export declare const conversationId: import("@preact/signals-core").Signal<string | null>;
+export declare const registeredActions: import("@preact/signals-core").Signal<Record<string, unknown>[]>;
+export declare const historyInvalidationCounter: import("@preact/signals-core").Signal<number>;
 export declare const isLoading: import("@preact/signals-core").Signal<boolean>;
+export interface InterruptedSession {
+    conversationId: string;
+    userMessage: string;
+    partialResponse: string;
+    summary: string;
+    elapsedMs: number;
+}
+export declare const interruptedSession: import("@preact/signals-core").Signal<InterruptedSession | null>;
 export interface ProgressStatus {
-    kind: 'search' | 'search_complete' | 'generating' | 'thinking' | null;
+    kind: string | null;
     message?: string;
 }
 export declare const progressStatus: import("@preact/signals-core").Signal<ProgressStatus>;
+/**
+ * Child item within a progress event (e.g., search source, plan step).
+ */
+export interface ProgressChild {
+    id: string;
+    label: string;
+    url?: string;
+}
+/**
+ * Progress event for tracking AI response generation steps.
+ * Uses a generic design where the server controls display text via `label`.
+ *
+ * The new schema uses `id` and `status` fields. Legacy fields are kept
+ * for backwards compatibility with older backend versions.
+ */
+export interface ProgressEvent {
+    kind: string;
+    id?: string;
+    label?: string;
+    status?: 'active' | 'done' | 'error';
+    text?: string;
+    children?: ProgressChild[];
+    metadata?: Record<string, unknown>;
+    progress_id?: string;
+    message?: string;
+}
+/**
+ * @deprecated Use `message.progressEvents` instead. Will be removed in v2.0.
+ *
+ * This global signal is kept for backwards compatibility with progressStatus.
+ */
+export declare const progressEvents: import("@preact/signals-core").Signal<ProgressEvent[]>;
+/**
+ * Add a progress event to the last assistant message.
+ * Events are stored directly on the message as they arrive.
+ *
+ * If the event has an id (or legacy progress_id) that matches an existing event,
+ * the existing event is updated:
+ * - Text is appended (delta mode for streaming)
+ * - Status transitions are handled (active → done/error)
+ * - Other fields are merged
+ *
+ * This prevents multiple rows from appearing for the same event.
+ */
+export declare const addProgressEventToLastMessage: (event: ProgressEvent) => void;
 export declare const isExpanded: import("@preact/signals-core").Signal<boolean>;
+/**
+ * @deprecated Sources are now stored per-message on `StoredChatMessage.sources`. Will be removed in v2.0.
+ *
+ * Kept for backwards compatibility with resetChat().
+ */
 export declare const currentSources: import("@preact/signals-core").Signal<ArticleSummary[]>;
+/**
+ * @deprecated Actions are now stored per-message on `StoredChatMessage.actions`. Will be removed in v2.0.
+ *
+ * Kept for backwards compatibility with resetChat().
+ */
 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 submitPendingTrigger: import("@preact/signals-core").Signal<number>;
 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 declare const userContext: import("@preact/signals-core").Signal<UserContextItem[]>;
+export declare const pendingUserContext: import("@preact/signals-core").Signal<UserContextItem[]>;
 export type ImageUploadStatus = 'uploading' | 'ready' | 'error';
 export interface PendingImage {
     id: string;
@@ -62,7 +129,24 @@ export declare const setActionComplete: (actionName: string, success: boolean, e
 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;
+/**
+ * @deprecated Use `setConversationId` instead. Will be removed in v2.0.
+ */
+export declare const setThreadId: (id: string) => void;
 export declare const clearConversationId: () => void;
+/**
+ * Set registered actions from backend response.
+ * These are actions discovered via search that can be called directly by the LLM.
+ */
+export declare const setRegisteredActions: (actions: Record<string, unknown>[]) => void;
+/**
+ * Get registered actions for sending with the next message.
+ */
+export declare const getRegisteredActions: () => Record<string, unknown>[];
+/**
+ * Clear registered actions (e.g., when starting a new conversation).
+ */
+export declare const clearRegisteredActions: () => 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;
@@ -70,16 +154,30 @@ 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 addProgressEvent: (event: ProgressEvent) => void;
+export declare const clearProgressEvents: () => void;
+export declare const setInterruptedSession: (session: InterruptedSession | null) => void;
+export declare const clearInterruptedSession: () => 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 triggerSubmitPending: () => void;
 export declare const triggerInputFocus: () => void;
-export declare const addUserContext: (item: Omit<UserContextItem, "id">) => void;
+export declare const addUserContext: <T extends Omit<UserContextItem, "id">>(item: T) => 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;
+/**
+ * Load a conversation from history.
+ * Populates the chat with messages from a previous conversation.
+ */
+export declare const loadConversation: (id: string, historyMessages: Array<{
+    role: "user" | "assistant";
+    content: string;
+    id?: string;
+}>) => void;

package/dist/store/index.d.ts

@@ -7,3 +7,4 @@ export * as routerStore from './router';
 export * as chatStore from './chat';
 export * as contextStore from './context';
 export * as workflowStore from './workflow';
+export * as suggestionsStore from './suggestions';

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

@@ -0,0 +1,62 @@
+/**
+ * Session Persistence Module
+ *
+ * Handles localStorage persistence for active streaming sessions.
+ * Enables session recovery when the page is refreshed or the user
+ * navigates away and returns.
+ *
+ * This is a lightweight "recovery hint" - the server is the source of truth.
+ * We only store enough to know there might be a resumable session.
+ */
+/**
+ * Stored session data with metadata.
+ * Minimal data - just enough to trigger a server check.
+ */
+interface StoredSessionData {
+    version: number;
+    conversationId: string;
+    siteId: string;
+    streamingStartedAt: string;
+}
+/**
+ * Save an active session hint to localStorage.
+ *
+ * Called when streaming starts to enable recovery on disconnect.
+ *
+ * @param conversationId - The conversation UUID
+ * @param siteId - The site ID for scoping
+ */
+export declare function saveActiveSession(conversationId: string, siteId: string): void;
+/**
+ * Load a saved session hint from localStorage.
+ *
+ * @param siteId - The site ID for scoping
+ * @returns The saved session data or null if not found/invalid
+ */
+export declare function loadActiveSession(siteId: string): StoredSessionData | null;
+/**
+ * Clear any saved session from localStorage.
+ *
+ * Called when streaming completes, user discards, or on successful resume.
+ *
+ * @param siteId - The site ID for scoping
+ */
+export declare function clearActiveSession(siteId: string): void;
+/**
+ * Check if there's a saved session without loading it.
+ *
+ * @param siteId - The site ID for scoping
+ * @returns true if a session exists
+ */
+export declare function hasActiveSession(siteId: string): boolean;
+/**
+ * Get metadata about the saved session.
+ *
+ * @param siteId - The site ID for scoping
+ * @returns Session metadata or null
+ */
+export declare function getActiveSessionMetadata(siteId: string): {
+    conversationId: string;
+    streamingStartedAt: string;
+} | null;
+export {};

package/dist/store/suggestions.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Suggestions Store
+ * Signal-based state for page-aware suggested questions
+ *
+ * The backend generates a pool of 15-20 diverse suggestions.
+ * This store sorts them client-side based on page relevance
+ * for instant page-aware suggestions without additional LLM calls.
+ */
+import type { SuggestedQuestion } from '../api/client';
+/** Base suggestion pool from backend (15-20 suggestions) */
+export declare const suggestionPool: import("@preact/signals-core").Signal<SuggestedQuestion[]>;
+/** Currently displayed suggestions (sorted by page relevance) */
+export declare const suggestions: import("@preact/signals-core").Signal<SuggestedQuestion[]>;
+/** Loading state (only for initial pool fetch) */
+export declare const suggestionsLoading: import("@preact/signals-core").Signal<boolean>;
+/** Error state */
+export declare const suggestionsError: import("@preact/signals-core").Signal<string | null>;
+/** Route when suggestions were last sorted */
+export declare const lastSortedRoute: import("@preact/signals-core").Signal<string | null>;
+/** Whether we have suggestions to display */
+export declare const hasSuggestions: import("@preact/signals-core").ReadonlySignal<boolean>;
+/** Whether we have a pool to sort from */
+export declare const hasPool: import("@preact/signals-core").ReadonlySignal<boolean>;
+/**
+ * Sort suggestions by relevance to the current page.
+ * Uses keyword matching between page context and suggestion text.
+ *
+ * @param pool - Full pool of suggestions from backend
+ * @param pathname - Current page pathname (e.g., '/dashboards/new')
+ * @param title - Current page title
+ * @param limit - Maximum number of suggestions to return
+ * @returns Sorted suggestions, most relevant first
+ */
+export declare function sortByPageRelevance(pool: SuggestedQuestion[], pathname: string, title: string, limit?: number): SuggestedQuestion[];
+/**
+ * Set the base suggestion pool (called once on init).
+ */
+export declare function setSuggestionPool(pool: SuggestedQuestion[]): void;
+/**
+ * Update displayed suggestions (sorted for current page).
+ */
+export declare function setSuggestions(sorted: SuggestedQuestion[], route: string): void;
+/**
+ * Set loading state.
+ */
+export declare function setSuggestionsLoading(loading: boolean): void;
+/**
+ * Set error state.
+ */
+export declare function setSuggestionsError(error: string | null): void;
+/**
+ * Sort pool for current page and update displayed suggestions.
+ */
+export declare function sortForCurrentPage(pathname: string, title: string, limit?: number): SuggestedQuestion[];
+/**
+ * Reset all suggestions state.
+ */
+export declare function resetSuggestions(): void;

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

@@ -0,0 +1,46 @@
+/**
+ * DOM Scanner Types
+ * Types for scanning DOM and creating compact text representation for LLM context
+ */
+/** Types of interactions possible with an element */
+export type InteractionType = "click" | "input" | "select" | "toggle" | "submit" | "focus" | "hover" | string;
+/** Options for controlling DOM scanning behavior */
+export interface ScanOptions {
+    /** Maximum depth to traverse (default: 20) */
+    maxDepth?: number;
+    /** Include text content nodes (default: true) */
+    includeText?: boolean;
+    /** Include only visible elements (default: true) */
+    visibleOnly?: boolean;
+    /** Root element to scan from (default: document.body) */
+    root?: Element;
+    /** Selector for elements to exclude from scanning */
+    excludeSelector?: string;
+    /** Minimum text length to include (default: 1) */
+    minTextLength?: number;
+    /** Maximum text length before truncation (default: 500) */
+    maxTextLength?: number;
+    /** Include element positions/coordinates (default: false) */
+    includePositions?: boolean;
+}
+/** Default scan options */
+export declare const DEFAULT_SCAN_OPTIONS: Required<Omit<ScanOptions, "root" | "excludeSelector">>;
+/** Result of DOM scan with compact text representation for LLM context */
+export interface CompactScanResult {
+    /** Compact text representation for LLM context */
+    content: string;
+    /** Number of interactable elements found */
+    interactableCount: number;
+    /** 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 */
+export declare const INTERACTABLE_ROLES: Set<string>;
+/** Tags to completely skip during scanning */
+export declare const SKIP_TAGS: Set<string>;

package/dist/types/index.d.ts

@@ -2,3 +2,4 @@
  * Type exports for Pillar SDK
  */
 export * from './user-context';
+export * from './dom-scanner';

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

@@ -18,12 +18,43 @@ export interface HighlightedTextContext extends BaseUserContext {
     /** The selected text content */
     text_content: string;
 }
+/** Product context for context-aware chat */
+export interface ProductContext extends BaseUserContext {
+    type: 'product_context';
+    [key: string]: unknown;
+}
+/** User profile context */
+export interface UserProfileContext extends BaseUserContext {
+    type: 'user_profile';
+    [key: string]: unknown;
+}
+/** Generic context for arbitrary data */
+export interface GenericContext extends BaseUserContext {
+    type: string;
+    [key: string]: unknown;
+}
+/** DOM snapshot context from page scanning */
+export interface DOMSnapshotContext extends BaseUserContext {
+    type: 'dom_snapshot';
+    /** URL of the scanned page */
+    url: string;
+    /** Page title */
+    title: string;
+    /** Compact text representation of the page for LLM context */
+    content: string;
+    /** Number of interactable elements found */
+    interactableCount: number;
+    /** Timestamp when scan was performed */
+    timestamp: number;
+}
 /** Union of all possible user context item types */
-export type UserContextItem = HighlightedTextContext;
+export type UserContextItem = HighlightedTextContext | ProductContext | UserProfileContext | DOMSnapshotContext | GenericContext;
 /** 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;
+/** Type guard for DOM snapshot context */
+export declare function isDOMSnapshotContext(item: UserContextItem): item is DOMSnapshotContext;
 /** Get display label for a context item */
 export declare function getContextDisplayLabel(item: UserContextItem): string;
 export {};

package/dist/utils/debug.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Unified Debug Logger Utility
+ *
+ * Single source of truth for all SDK debugging:
+ * - debugLog.add() is the primary API for structured logging
+ * - debug.log/warn/error are convenience wrappers that route through debugLog
+ * - Server forwarding is handled via subscription pattern
+ * - DebugPanel subscribes for UI display
+ *
+ * Sources:
+ * - 'sdk': Core SDK events (init, ready, errors)
+ * - 'handler': Action handler execution
+ * - 'network': API requests/responses
+ * - 'server': Server-side events (via SSE)
+ */
+import type { MCPClient } from '../api/mcp-client';
+/** Debug entry sources */
+export type DebugSource = 'sdk' | 'handler' | 'network' | 'server';
+/** Debug entry severity levels */
+export type DebugLevel = 'info' | 'warn' | 'error';
+/**
+ * Unified debug entry for all logging.
+ * Used by DebugPanel, server forwarding, and console output.
+ */
+export interface DebugEntry {
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+    /** Event name or message (e.g., 'sdk:init:start', 'network:request') */
+    event: string;
+    /** Structured data associated with the event */
+    data?: unknown;
+    /** Source of the log entry */
+    source: DebugSource;
+    /** Severity level */
+    level: DebugLevel;
+    /** Optional prefix for backward compatibility (e.g., '[Pillar]', '[PlanExecutor]') */
+    prefix?: string;
+}
+/**
+ * Log entry structure for server forwarding (backward compatible).
+ */
+export interface LogEntry {
+    level: 'log' | 'warn' | 'error';
+    message: string;
+    data?: unknown;
+    timestamp: string;
+}
+/**
+ * Enable or disable runtime debug mode.
+ * Called by Pillar.init() when debug: true is passed.
+ */
+export declare function setDebugMode(enabled: boolean): void;
+/**
+ * Check if debug mode is enabled (either via environment or runtime flag).
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Central debug log store.
+ * All debug entries flow through here and are distributed to:
+ * - Console (in debug mode)
+ * - DebugPanel UI (via subscription)
+ * - Server (via ServerLogForwarder subscription)
+ */
+declare class DebugLogStore {
+    private entries;
+    private maxEntries;
+    private listeners;
+    private serverForwarder;
+    private forwarderUnsubscribe;
+    /**
+     * Add a debug entry.
+     * This is the primary API for all logging.
+     */
+    add(entry: Omit<DebugEntry, 'timestamp'>): void;
+    private logToConsole;
+    /**
+     * Enable server forwarding of logs.
+     */
+    enableServerForwarding(client: MCPClient, options?: {
+        flushIntervalMs?: number;
+    }): void;
+    /**
+     * Disable server forwarding.
+     */
+    disableServerForwarding(): void;
+    /**
+     * Manually flush logs to server.
+     */
+    flush(): void;
+    /**
+     * Get all entries.
+     */
+    getEntries(): DebugEntry[];
+    /**
+     * Clear all entries.
+     */
+    clear(): void;
+    /**
+     * Subscribe to entry updates.
+     */
+    subscribe(listener: (entries: DebugEntry[]) => void): () => void;
+    /**
+     * Clean up all resources.
+     */
+    destroy(): void;
+}
+/**
+ * Global debug log store instance.
+ */
+export declare const debugLog: DebugLogStore;
+/**
+ * Debug logger convenience API.
+ *
+ * Routes all calls through debugLog for unified handling.
+ * Maintains backward compatibility with existing debug.log/warn/error calls.
+ */
+export declare const debug: {
+    /**
+     * Configure server-side log forwarding.
+     * @deprecated Use debugLog.enableServerForwarding() instead
+     */
+    configure: (client: MCPClient, options?: {
+        forwardToServer?: boolean;
+        flushIntervalMs?: number;
+    }) => void;
+    /**
+     * Manually flush logs to server.
+     */
+    flush: () => void;
+    /**
+     * Log debug information.
+     * Only outputs in development mode or when debug is enabled.
+     */
+    log: (...args: unknown[]) => void;
+    /**
+     * Log warnings.
+     * Only outputs in development mode or when debug is enabled.
+     */
+    warn: (...args: unknown[]) => void;
+    /**
+     * Log errors.
+     * Always outputs regardless of environment.
+     */
+    error: (...args: unknown[]) => void;
+    /**
+     * Clean up resources.
+     */
+    destroy: () => void;
+};
+export {};

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

@@ -0,0 +1,44 @@
+/**
+ * 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";
+/**
+ * Clear all pillar refs from the DOM.
+ * Called before scanning to remove stale refs.
+ */
+export declare function clearPillarRefs(): void;
+/**
+ * Check if an element is interactable
+ */
+export declare function isInteractable(el: Element): boolean;
+/**
+ * Determine the interaction type for an element
+ */
+export declare function getInteractionType(el: Element): InteractionType;
+/**
+ * Build full selector from short ref ID.
+ * Converts "pr-abc" to '[data-pillar-ref="pr-abc"]'
+ *
+ * @param shortRef - Short ref ID (e.g., "pr-abc")
+ * @returns Full CSS selector for querySelector
+ */
+export declare function buildSelectorFromRef(shortRef: string): string;
+/**
+ * Optimized single-pass DOM scanner that outputs compact text directly.
+ * Skips the intermediate AST for better performance.
+ *
+ * @param options - Scan options
+ * @returns Compact scan result with text content ready for LLM
+ *
+ * @example
+ * ```typescript
+ * const result = scanPageDirect();
+ * console.log(result.content);
+ * // === PAGE: My App | /dashboard ===
+ * // Welcome to your dashboard
+ * // CLICK: Create Report [[pr-a1]]
+ * // === 5 interactable elements ===
+ * ```
+ */
+export declare function scanPageDirect(options?: ScanOptions): CompactScanResult;

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

@@ -0,0 +1,53 @@
+/**
+ * Markdown Components
+ *
+ * Preact components that can be substituted for markdown elements.
+ * These enable interactive UI within markdown content.
+ */
+import { ComponentChildren, VNode } from 'preact';
+export interface CollapsibleSectionProps {
+    title: string;
+    defaultOpen?: boolean;
+    children: ComponentChildren;
+}
+export declare function CollapsibleSection({ title, defaultOpen, children, }: CollapsibleSectionProps): VNode;
+export interface Source {
+    title: string;
+    url: string;
+    score?: number;
+}
+export interface SourceListProps {
+    sources: Source[];
+}
+export declare function SourceList({ sources }: SourceListProps): VNode;
+export interface TaskItem {
+    id: string;
+    text: string;
+    completed: boolean;
+}
+export interface TaskListProps {
+    items: TaskItem[];
+    onToggle?: (id: string, completed: boolean) => void;
+}
+export declare function TaskList({ items, onToggle }: TaskListProps): VNode;
+export interface CodeBlockProps {
+    language?: string;
+    children: string;
+}
+export declare function CodeBlock({ language, children }: CodeBlockProps): VNode;
+export interface ActionButton {
+    name: string;
+    label: string;
+    data?: Record<string, unknown>;
+}
+export interface ActionButtonsProps {
+    actions: ActionButton[];
+    onAction?: (name: string, data?: Record<string, unknown>) => void;
+}
+export declare function ActionButtons({ actions, onAction }: ActionButtonsProps): VNode;
+export interface ProgressIndicatorProps {
+    message: string;
+    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

@@ -0,0 +1,17 @@
+/**
+ * Preact Markdown Renderer
+ *
+ * Converts markdown content to Preact vnodes using the marked lexer.
+ * Supports custom component substitution for special patterns.
+ */
+import { VNode } from 'preact';
+export interface PreactMarkdownProps {
+    content: string;
+    class?: string;
+}
+/**
+ * Render markdown content as Preact vnodes.
+ * 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";