@pillar-ai/sdk 0.1.13 → 0.1.15

package/dist/api/mcp-client.d.ts

@@ -6,8 +6,8 @@
  */
 import type { TaskButtonData } from '../components/Panel/TaskButton';
 import type { ResolvedConfig } from '../core/config';
-import type { ExecutionPlan } from '../core/plan';
 import type { UserContextItem } from '../types/user-context';
+import { type LogEntry } from '../utils/debug';
 import type { ArticleSummary } from './client';
 /** MCP Tool result content */
 interface ToolResultContent {
@@ -23,7 +23,8 @@ export interface ToolResult {
     structuredContent?: {
         sources?: ArticleSummary[];
         actions?: ActionData[];
-        plan?: ExecutionPlan;
+        /** Registered actions for dynamic action tools (persisted across turns) */
+        registered_actions?: Record<string, unknown>[];
     };
     _meta?: {
         conversation_id?: string;
@@ -45,6 +46,38 @@ export interface ActionData {
     score: number;
     data: Record<string, unknown>;
 }
+/** Action request from agent (unified for all action execution) */
+export interface ActionRequest {
+    /** Action name to execute */
+    action_name: string;
+    /** Parameters for the action */
+    parameters: Record<string, unknown>;
+    /** Full action definition (optional, for handler lookup) */
+    action?: ActionData;
+    /** Unique ID for this specific tool invocation (for result correlation) */
+    tool_call_id?: string;
+}
+/** Token usage data from the agentic loop (sent after each LLM iteration) */
+export interface TokenUsage {
+    /** Input tokens for this iteration */
+    prompt_tokens: number;
+    /** Output tokens for this iteration */
+    completion_tokens: number;
+    /** Cumulative prompt tokens across all iterations */
+    total_prompt_tokens: number;
+    /** Cumulative completion tokens across all iterations */
+    total_completion_tokens: number;
+    /** Current total tokens in context */
+    total_used: number;
+    /** Maximum context window for the model */
+    context_window: number;
+    /** Current context occupancy percentage (0-100) */
+    occupancy_pct: number;
+    /** Name of the model in use */
+    model_name: string;
+    /** Current iteration number (0-indexed) */
+    iteration: number;
+}
 /** Streaming callbacks for tool calls */
 export interface StreamCallbacks {
     /** Called for each text token */
@@ -53,29 +86,36 @@ export interface StreamCallbacks {
     onSources?: (sources: ArticleSummary[]) => void;
     /** Called when actions are available */
     onActions?: (actions: ActionData[]) => void;
-    /** Called when a plan is created (from plan.created event) */
-    onPlan?: (plan: ExecutionPlan) => void;
+    /** Called when registered actions are received (for dynamic action tools) */
+    onRegisteredActions?: (actions: Record<string, unknown>[]) => void;
     /** Called on error */
     onError?: (error: string) => void;
+    /** Called when conversation_started event is received (confirms conversation tracking) */
+    onConversationStarted?: (conversationId: string, assistantMessageId?: string) => void;
     /** Called when stream is complete */
     onComplete?: (conversationId?: string, queryLogId?: string) => void;
-    /** Called for progress updates (search, query, generating, etc.) */
+    /** Called for progress updates (search, query, generating, thinking, etc.) */
     onProgress?: (progress: {
         kind: string;
-        message?: string;
+        id?: string;
+        label?: string;
+        status?: 'active' | 'done' | 'error';
+        text?: string;
+        children?: Array<{
+            id: string;
+            label: string;
+            url?: string;
+        }>;
+        metadata?: Record<string, unknown>;
         progress_id?: string;
-        metadata?: {
-            sources?: Array<{
-                title: string;
-                url: string;
-                score?: number;
-            }>;
-            result_count?: number;
-            query?: string;
-            action_name?: string;
-            no_sources_used?: boolean;
-        };
+        message?: string;
     }) => void;
+    /** Called immediately with the request ID (for cancellation support) */
+    onRequestId?: (requestId: number) => void;
+    /** Called when agent requests action execution (unified handler) */
+    onActionRequest?: (request: ActionRequest) => Promise<void>;
+    /** Called when token usage is updated (after each LLM iteration) */
+    onTokenUsage?: (usage: TokenUsage) => void;
 }
 /** Image for chat requests (from upload-image endpoint) */
 export interface ChatImage {
@@ -92,7 +132,27 @@ export interface ImageUploadResponse {
 export declare class MCPClient {
     private config;
     private requestId;
+    private _externalUserId;
     constructor(config: ResolvedConfig);
+    /**
+     * Set the external user ID for authenticated users.
+     * Enables cross-device conversation history.
+     */
+    setExternalUserId(userId: string): void;
+    /**
+     * Get or create a persistent visitor ID.
+     * Stored in localStorage to persist across sessions.
+     */
+    private getVisitorId;
+    /**
+     * Get or create a session ID for MCP request correlation.
+     * Stored in sessionStorage to persist only for the current browser session.
+     */
+    private getSessionId;
+    /**
+     * Get the current page URL for analytics tracking.
+     */
+    private getPageUrl;
     private get baseUrl();
     private get headers();
     private nextId;
@@ -132,104 +192,94 @@ export declare class MCPClient {
         articleSlug?: string;
         userContext?: UserContextItem[];
         images?: ChatImage[];
+        history?: Array<{
+            role: 'user' | 'assistant';
+            content: string;
+        }>;
+        /** Registered actions from previous turns (for dynamic action tools) */
+        registeredActions?: Record<string, unknown>[];
         signal?: AbortSignal;
+        /** Conversation ID - generated client-side, always provided */
+        conversationId?: string;
     }): Promise<ToolResult>;
     /**
-     * Continue plan execution after receiving step result.
+     * Cancel an active streaming request.
      *
-     * Called by the SDK after executing a step that has
-     * requires_result_feedback=true. The server analyzes the result
-     * and updates subsequent steps if needed.
+     * Sends a notifications/cancel JSON-RPC request to the backend, which
+     * signals the StreamRegistry to stop the LLM stream and cease billing.
      *
-     * @param planId - UUID of the plan
-     * @param stepId - UUID of the completed step
-     * @param result - Step execution result
-     * @returns Updated plan with all steps
+     * @param requestId - The JSON-RPC request ID of the stream to cancel
      */
-    continuePlan(planId: string, stepId: string, result: unknown): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    cancelStream(requestId: number | string): Promise<void>;
     /**
-     * Cancel an in-progress plan.
+     * Send action result back to the agent.
      *
-     * Marks the plan as cancelled and skips any pending steps.
+     * Called after executing a query action (returns_data=true).
+     * The result is sent to the agent for further reasoning in the ReAct loop.
      *
-     * @param planId - UUID of the plan to cancel
-     * @returns Updated plan with cancelled status
+     * @param actionName - The name of the action that was executed
+     * @param result - The result data to send back to the agent
+     * @param toolCallId - Unique ID for this specific tool invocation (for result correlation)
+     * @returns Promise that resolves when the result is delivered, or rejects on error
      */
-    cancelPlan(planId: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    sendActionResult(actionName: string, result: unknown, toolCallId?: string): Promise<void>;
     /**
-     * Get current state of a plan.
+     * Send a client-side log to the server for debugging.
      *
-     * Returns the plan and all its steps with current statuses.
+     * Logs are correlated with agent sessions via the MCP session ID.
+     * Use this to forward important SDK events to server logs.
      *
-     * @param planId - UUID of the plan
-     * @returns Plan with all steps
+     * @param level - Log level: 'log', 'warn', or 'error'
+     * @param message - The log message
+     * @param data - Optional additional data to include
      */
-    getPlan(planId: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    sendLog(level: 'log' | 'warn' | 'error', message: string, data?: unknown): Promise<void>;
     /**
-     * Start a plan that was waiting for user confirmation.
+     * Send a batch of client-side logs to the server.
      *
-     * For plans with auto_execute=false, the user must explicitly
-     * start execution by calling this method.
+     * Logs are buffered and sent periodically (every 5 seconds by default)
+     * to reduce network requests. This method is called by the debug module.
      *
-     * @param planId - UUID of the plan to start
-     * @returns Updated plan with executing status
+     * @param logs - Array of log entries to send
      */
-    startPlan(planId: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    sendLogBatch(logs: LogEntry[]): void;
     /**
-     * Retry a failed step.
-     *
-     * Increments the retry count and resets the step to ready status.
-     * Only works if the step is retriable and hasn't exceeded max_retries.
+     * Check if a conversation has a resumable interrupted session.
      *
-     * @param planId - UUID of the plan
-     * @param stepId - UUID of the step to retry
-     * @returns Updated plan with step reset to ready
+     * @param conversationId - The conversation UUID to check
+     * @returns Session status with resumption details, or null if not resumable
      */
-    retryStep(planId: string, stepId: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    getConversationStatus(conversationId: string): Promise<ConversationStatus | null>;
     /**
-     * Mark a step as failed.
+     * Resume an interrupted conversation.
      *
-     * Records the error and determines if the plan should also fail
-     * (if step is not retriable or out of retries).
+     * Returns a streaming response that continues the conversation
+     * from where it was interrupted.
      *
-     * @param planId - UUID of the plan
-     * @param stepId - UUID of the failed step
-     * @param errorMessage - Optional error message
-     * @returns Updated plan with failed step
+     * @param conversationId - The conversation to resume
+     * @param userContext - Optional current page context (highlighted text, DOM snapshot, etc.)
+     * @param callbacks - Streaming callbacks
      */
-    failStep(planId: string, stepId: string, errorMessage?: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    resumeConversation(conversationId: string, userContext: UserContextItem[] | undefined, callbacks: StreamCallbacks): Promise<void>;
     /**
-     * Skip a step and advance to the next one.
-     *
-     * @param planId - UUID of the plan
-     * @param stepId - UUID of the step to skip
-     * @returns Updated plan with skipped step and next step ready
+     * Handle events from the resume stream.
      */
-    skipStep(planId: string, stepId: string): Promise<{
-        plan: ExecutionPlan;
+    private handleResumeStreamEvent;
+}
+/**
+ * Conversation status for session resumption.
+ */
+export interface ConversationStatus {
+    resumable: boolean;
+    message_id?: string;
+    elapsed_ms?: number;
+    user_message?: string;
+    partial_response?: string;
+    summary?: string;
+    accomplished?: Array<{
+        action: string;
+        result_summary: string;
     }>;
-    /**
-     * Send action result back to the agent.
-     *
-     * Called after executing a query action (returns_data=true).
-     * The result is sent to the agent for further reasoning in the ReAct loop.
-     *
-     * @param actionName - The name of the action that was executed
-     * @param result - The result data to send back to the agent
-     */
-    sendActionResult(actionName: string, result: unknown): void;
 }
 /**
  * Convert ActionData from MCP response to TaskButtonData for UI rendering.

package/dist/cli/sync.js

@@ -64,9 +64,32 @@ async function loadActions(actionsPath) {
       const tempDir = path.dirname(absolutePath);
       const tempFile = path.join(tempDir, `.pillar-sync-temp-${Date.now()}.mjs`);
       const importPath = absolutePath.replace(/\\/g, "/");
-      const extractScript = `import actions from '${importPath}';
-const result = actions.default || actions;
-console.log(JSON.stringify(result));`;
+      const extractScript = `import * as module from '${importPath}';
+
+// Resolve actions - tsx may wrap all exports in module.default
+function resolveActions(mod) {
+  // Direct named export
+  if (mod.actions && typeof mod.actions === 'object' && !mod.actions.default) {
+    return mod.actions;
+  }
+  // Default export is the actions object directly
+  if (mod.default && typeof mod.default === 'object') {
+    // Check if default is a module namespace (has nested default or actions)
+    if (mod.default.default && typeof mod.default.default === 'object') {
+      return mod.default.default;
+    }
+    if (mod.default.actions && typeof mod.default.actions === 'object') {
+      return mod.default.actions;
+    }
+    // default is the actions object itself
+    return mod.default;
+  }
+  return null;
+}
+
+const actions = resolveActions(module);
+const agentGuidance = module.agentGuidance || module.default?.agentGuidance;
+console.log(JSON.stringify({ actions, agentGuidance }));`;
       fs.writeFileSync(tempFile, extractScript, "utf-8");
       try {
         const result = execSync(`npx tsx "${tempFile}"`, {
@@ -74,13 +97,15 @@ console.log(JSON.stringify(result));`;
           cwd: process.cwd(),
           stdio: ["pipe", "pipe", "pipe"]
         });
-        const actions = JSON.parse(result.trim());
+        const parsed = JSON.parse(result.trim());
+        const actions = parsed.actions;
+        const agentGuidance = parsed.agentGuidance;
         if (!actions || typeof actions !== "object") {
           throw new Error(
             'Actions file must export an actions object as default or named export "actions"'
           );
         }
-        return actions;
+        return { actions, agentGuidance };
       } finally {
         if (fs.existsSync(tempFile)) {
           fs.unlinkSync(tempFile);
@@ -97,19 +122,37 @@ console.log(JSON.stringify(result));`;
   }
   const fileUrl = pathToFileURL(absolutePath).href;
   try {
+    let resolveActions2 = function(mod) {
+      if (mod.actions && typeof mod.actions === "object" && !mod.actions.default) {
+        return mod.actions;
+      }
+      if (mod.default && typeof mod.default === "object") {
+        const defaultExport = mod.default;
+        if (defaultExport.default && typeof defaultExport.default === "object") {
+          return defaultExport.default;
+        }
+        if (defaultExport.actions && typeof defaultExport.actions === "object") {
+          return defaultExport.actions;
+        }
+        return defaultExport;
+      }
+      return null;
+    };
+    var resolveActions = resolveActions2;
     const module = await import(fileUrl);
-    const actions = module.default || module.actions;
+    const actions = resolveActions2(module);
+    const agentGuidance = module.agentGuidance || module.default?.agentGuidance;
     if (!actions || typeof actions !== "object") {
       throw new Error(
         'Actions file must export an actions object as default or named export "actions"'
       );
     }
-    return actions;
+    return { actions, agentGuidance };
   } catch (error) {
     throw error;
   }
 }
-function buildManifest(actions, platform, version, gitSha) {
+function buildManifest(actions, platform, version, gitSha, agentGuidance) {
   const entries = [];
   for (const [name, definition] of Object.entries(actions)) {
     const entry = {
@@ -127,23 +170,32 @@ function buildManifest(actions, platform, version, gitSha) {
       entry.auto_run = definition.autoRun;
     if (definition.autoComplete)
       entry.auto_complete = definition.autoComplete;
-    if (definition.returns)
+    if (definition.returns !== void 0) {
       entry.returns_data = definition.returns;
+    } else if (definition.type === "query") {
+      entry.returns_data = true;
+    }
     if (definition.dataSchema)
       entry.data_schema = definition.dataSchema;
     if (definition.defaultData)
       entry.default_data = definition.defaultData;
     if (definition.requiredContext)
       entry.required_context = definition.requiredContext;
+    if (definition.parameterExamples?.length)
+      entry.parameter_examples = definition.parameterExamples;
     entries.push(entry);
   }
-  return {
+  const manifest = {
     platform,
     version,
     gitSha,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     actions: entries
   };
+  if (agentGuidance) {
+    manifest.agentGuidance = agentGuidance;
+  }
+  return manifest;
 }
 async function pollStatus(statusUrl, secret, maxWaitSeconds = 300) {
   const startTime = Date.now();
@@ -241,15 +293,19 @@ async function main() {
     process.exit(1);
   }
   console.log(`[pillar-sync] Loading actions from: ${actionsPath}`);
-  let actions;
+  let loadedModule;
   try {
-    actions = await loadActions(actionsPath);
+    loadedModule = await loadActions(actionsPath);
   } catch (error) {
     console.error(`[pillar-sync] Failed to load actions:`, error);
     process.exit(1);
   }
+  const { actions, agentGuidance } = loadedModule;
   const actionCount = Object.keys(actions).length;
   console.log(`[pillar-sync] Found ${actionCount} actions`);
+  if (agentGuidance) {
+    console.log(`[pillar-sync] Found agent guidance (${agentGuidance.length} chars)`);
+  }
   if (actionCount === 0) {
     console.warn("[pillar-sync] No actions found. Nothing to sync.");
     process.exit(0);
@@ -260,7 +316,7 @@ async function main() {
   console.log(`[pillar-sync] Platform: ${platform}`);
   console.log(`[pillar-sync] Version: ${version}`);
   console.log(`[pillar-sync] Git SHA: ${gitSha || "not available"}`);
-  const manifest = buildManifest(actions, platform, version, gitSha);
+  const manifest = buildManifest(actions, platform, version, gitSha, agentGuidance);
   if (process.env.PILLAR_DEBUG) {
     const manifestPath = path.join(process.cwd(), "actions-manifest.json");
     fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
@@ -273,6 +329,9 @@ async function main() {
     git_sha: gitSha,
     actions: manifest.actions
   };
+  if (agentGuidance) {
+    requestBody.agent_guidance = agentGuidance;
+  }
   const syncUrl = `${apiUrl}/api/admin/configs/${slug}/actions/sync/?async=true`;
   console.log(`[pillar-sync] POST ${syncUrl}`);
   try {

package/dist/components/DebugPanel/DebugPanel.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Debug Panel Component
+ *
+ * Shows real-time SDK event timeline for debugging.
+ * Only rendered when debug: true is passed to Pillar.init()
+ *
+ * Features:
+ * - Source filtering (sdk, handler, network, server)
+ * - Text search filter
+ * - Color-coded log levels
+ * - Export to JSON
+ * - Drag to resize height
+ * - Auto-scroll to bottom on new logs
+ */
+interface DebugPanelProps {
+    /** Whether the panel is expanded */
+    expanded?: boolean;
+    /** Callback when panel is toggled */
+    onToggle?: () => void;
+}
+/**
+ * Debug Panel Component
+ */
+export declare function DebugPanel({ expanded, onToggle }: DebugPanelProps): import("preact").JSX.Element;
+export default DebugPanel;

package/dist/components/DebugPanel/index.d.ts

@@ -0,0 +1,2 @@
+export { DebugPanel } from './DebugPanel';
+export { default } from './DebugPanel';

package/dist/components/DevTools/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * DevTools Components
+ * Development tools for debugging and previewing Pillar SDK features
+ */
+export { DEVTOOLS_STYLES } from './styles';

package/dist/components/DevTools/styles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * DevTools CSS Styles
+ * Styles for the DOM Scanner preview panel
+ */
+export declare const DEVTOOLS_STYLES = "\n/* Pillar DevTools Styles */\n.pillar-devtools-overlay {\n  position: fixed;\n  top: 0;\n  left: 0;\n  right: 0;\n  bottom: 0;\n  background: rgba(0, 0, 0, 0.5);\n  z-index: 99998;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 20px;\n  box-sizing: border-box;\n}\n\n.pillar-devtools-panel {\n  background: #1e1e2e;\n  border-radius: 12px;\n  box-shadow: 0 20px 50px rgba(0, 0, 0, 0.4);\n  max-width: 800px;\n  width: 100%;\n  max-height: 80vh;\n  display: flex;\n  flex-direction: column;\n  overflow: hidden;\n  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;\n  color: #e0e0e0;\n}\n\n.pillar-devtools-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 16px 20px;\n  border-bottom: 1px solid #2d2d3d;\n  background: #252535;\n}\n\n.pillar-devtools-title {\n  display: flex;\n  align-items: center;\n  gap: 10px;\n  margin: 0;\n  font-size: 15px;\n  font-weight: 600;\n  color: #ffffff;\n}\n\n.pillar-devtools-badge {\n  padding: 3px 8px;\n  background: #6366f1;\n  border-radius: 4px;\n  font-size: 11px;\n  font-weight: 500;\n  text-transform: uppercase;\n  letter-spacing: 0.5px;\n}\n\n.pillar-devtools-close {\n  padding: 6px;\n  background: transparent;\n  border: none;\n  border-radius: 6px;\n  color: #9090a0;\n  cursor: pointer;\n  transition: background 0.15s, color 0.15s;\n}\n\n.pillar-devtools-close:hover {\n  background: #3d3d4d;\n  color: #ffffff;\n}\n\n.pillar-devtools-stats {\n  display: flex;\n  gap: 16px;\n  padding: 12px 20px;\n  border-bottom: 1px solid #2d2d3d;\n  background: #1a1a2a;\n  flex-wrap: wrap;\n}\n\n.pillar-devtools-stat {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  font-size: 13px;\n}\n\n.pillar-devtools-stat-value {\n  font-weight: 600;\n  color: #8b5cf6;\n}\n\n.pillar-devtools-stat-label {\n  color: #9090a0;\n}\n\n.pillar-devtools-content {\n  flex: 1;\n  overflow-y: auto;\n  padding: 16px 20px;\n}\n\n.pillar-devtools-tree {\n  font-family: 'SF Mono', Monaco, 'Inconsolata', 'Fira Code', monospace;\n  font-size: 12px;\n  line-height: 1.6;\n}\n\n.pillar-devtools-node {\n  margin-left: 16px;\n  position: relative;\n}\n\n.pillar-devtools-node::before {\n  content: '';\n  position: absolute;\n  left: -12px;\n  top: 0;\n  bottom: 0;\n  width: 1px;\n  background: #3d3d4d;\n}\n\n.pillar-devtools-node-root {\n  margin-left: 0;\n}\n\n.pillar-devtools-node-root::before {\n  display: none;\n}\n\n.pillar-devtools-node-header {\n  display: flex;\n  align-items: flex-start;\n  gap: 6px;\n  padding: 3px 0;\n  cursor: pointer;\n  border-radius: 4px;\n  transition: background 0.1s;\n}\n\n.pillar-devtools-node-header:hover {\n  background: rgba(139, 92, 246, 0.1);\n}\n\n.pillar-devtools-toggle {\n  width: 16px;\n  height: 16px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  color: #6d6d7d;\n  flex-shrink: 0;\n  margin-top: 2px;\n}\n\n.pillar-devtools-toggle svg {\n  transition: transform 0.15s;\n}\n\n.pillar-devtools-toggle--expanded svg {\n  transform: rotate(90deg);\n}\n\n.pillar-devtools-tag {\n  color: #f472b6;\n}\n\n.pillar-devtools-attr-name {\n  color: #a78bfa;\n}\n\n.pillar-devtools-attr-value {\n  color: #34d399;\n}\n\n.pillar-devtools-interactable {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  padding: 2px 6px;\n  background: #6366f1;\n  border-radius: 3px;\n  font-size: 10px;\n  font-weight: 500;\n  color: #ffffff;\n  margin-left: 6px;\n}\n\n.pillar-devtools-text {\n  color: #94a3b8;\n  font-style: italic;\n  max-width: 400px;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.pillar-devtools-children {\n  display: none;\n}\n\n.pillar-devtools-children--expanded {\n  display: block;\n}\n\n.pillar-devtools-footer {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 12px;\n  padding: 16px 20px;\n  border-top: 1px solid #2d2d3d;\n  background: #252535;\n}\n\n.pillar-devtools-footer-info {\n  font-size: 12px;\n  color: #9090a0;\n}\n\n.pillar-devtools-actions {\n  display: flex;\n  gap: 10px;\n}\n\n.pillar-devtools-btn {\n  padding: 8px 16px;\n  border-radius: 6px;\n  font-size: 13px;\n  font-weight: 500;\n  cursor: pointer;\n  transition: background 0.15s, transform 0.1s;\n  border: none;\n}\n\n.pillar-devtools-btn:active {\n  transform: scale(0.98);\n}\n\n.pillar-devtools-btn--secondary {\n  background: #3d3d4d;\n  color: #e0e0e0;\n}\n\n.pillar-devtools-btn--secondary:hover {\n  background: #4d4d5d;\n}\n\n.pillar-devtools-btn--primary {\n  background: #6366f1;\n  color: #ffffff;\n}\n\n.pillar-devtools-btn--primary:hover {\n  background: #4f46e5;\n}\n";

package/dist/components/PagePilot/PagePilotBanner.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Page Pilot Banner Component
+ * Shows "Page being piloted by Agent" with stop button during interact_with_page actions.
+ * When a destructive action is detected, shows a confirmation variant with Allow/Deny buttons.
+ */
+import { h } from 'preact';
+export declare function PagePilotBanner(): h.JSX.Element | null;

package/dist/components/PagePilot/PagePilotManager.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Page Pilot Manager
+ * Manages the "Page being piloted by Agent" banner, rendering it outside Shadow DOM
+ * so it appears above all other content on the page.
+ */
+export declare class PagePilotManager {
+    private container;
+    private stylesInjected;
+    private unsubscribe;
+    private themeObserver;
+    private primaryColor;
+    /**
+     * Detect the current theme from the document
+     * Checks for .dark class (next-themes) or data-theme attribute
+     */
+    private detectThemeFromDOM;
+    /**
+     * Apply theme mode to container element
+     */
+    private applyTheme;
+    /**
+     * Set up observer to watch for theme changes on documentElement
+     */
+    private setupThemeObserver;
+    /**
+     * Initialize the page pilot manager
+     * @param primaryColor - Optional primary color from theme config to override the default
+     */
+    init(primaryColor?: string): void;
+    /**
+     * Update the primary color used by the banner
+     */
+    setPrimaryColor(color: string): void;
+    /**
+     * Destroy the page pilot manager
+     */
+    destroy(): void;
+    /**
+     * Render the banner component
+     */
+    private render;
+}

package/dist/components/PagePilot/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Page Pilot Components
+ * Banner and manager for displaying "Page being piloted by Agent" indicator
+ */
+export { PagePilotBanner } from './PagePilotBanner';
+export { PagePilotManager } from './PagePilotManager';
+export { PAGE_PILOT_STYLES } from './styles';

package/dist/components/PagePilot/styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Page Pilot Banner CSS Styles
+ * Injected into the document head (outside Shadow DOM)
+ * Uses the same CSS variables as the Pillar panel for consistent theming
+ */
+export declare const PAGE_PILOT_STYLES = "\n/* Pillar Page Pilot Banner Styles */\n\n/* Define CSS variables at the container level (same as panel) */\n#pillar-page-pilot-container {\n  /* Core colors - Light mode (default) */\n  --pillar-primary: #2563eb;\n  --pillar-primary-hover: #1d4ed8;\n  --pillar-bg: #ffffff;\n  --pillar-bg-secondary: #f9fafb;\n  --pillar-text: #1a1a1a;\n  --pillar-text-secondary: #374151;\n  --pillar-border: #e5e7eb;\n  --pillar-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1);\n  --pillar-font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;\n  --pillar-radius-lg: 8px;\n  --pillar-radius-md: 6px;\n  --pillar-transition-fast: 0.15s ease;\n}\n\n/* Dark mode - Auto-detect from system preference */\n@media (prefers-color-scheme: dark) {\n  #pillar-page-pilot-container:not([data-theme=\"light\"]) {\n    --pillar-primary: #3b82f6;\n    --pillar-primary-hover: #60a5fa;\n    --pillar-bg: #1a1a1a;\n    --pillar-bg-secondary: #262626;\n    --pillar-text: #f5f5f5;\n    --pillar-text-secondary: #e5e5e5;\n    --pillar-border: #404040;\n    --pillar-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.4);\n  }\n}\n\n/* Dark mode - Manual override via html class or data attribute */\nhtml.dark #pillar-page-pilot-container,\n[data-theme=\"dark\"] #pillar-page-pilot-container,\n#pillar-page-pilot-container[data-theme=\"dark\"] {\n  --pillar-primary: #3b82f6;\n  --pillar-primary-hover: #60a5fa;\n  --pillar-bg: #1a1a1a;\n  --pillar-bg-secondary: #262626;\n  --pillar-text: #f5f5f5;\n  --pillar-text-secondary: #e5e5e5;\n  --pillar-border: #404040;\n  --pillar-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.4);\n}\n\n@keyframes pillar-pulse {\n  0%, 100% {\n    opacity: 1;\n    transform: scale(1);\n  }\n  50% {\n    opacity: 0.6;\n    transform: scale(1.1);\n  }\n}\n\n@keyframes pillar-banner-fade-in {\n  from {\n    opacity: 0;\n    transform: translateY(-100%);\n  }\n  to {\n    opacity: 1;\n    transform: translateY(0);\n  }\n}\n\n._pillar-page-pilot-banner {\n  position: fixed;\n  top: 0;\n  left: 0;\n  right: 0;\n  z-index: 99999;\n  font-family: var(--pillar-font-family);\n  display: flex;\n  justify-content: center;\n  pointer-events: none;\n  animation: pillar-banner-fade-in 0.2s ease-out;\n}\n\n/* Viewport outline \u2014 3px border on left, right, bottom; top handled by tab shape */\n._pillar-page-pilot-banner::before {\n  content: '';\n  position: fixed;\n  inset: 0;\n  border: 3px solid var(--pillar-primary);\n  border-top: none;\n  pointer-events: none;\n  z-index: 99998;\n}\n\n/* Top border segments on either side of the tab */\n._pillar-page-pilot-banner::after {\n  content: '';\n  position: fixed;\n  top: 0;\n  left: 0;\n  right: 0;\n  height: 3px;\n  background: var(--pillar-primary);\n  pointer-events: none;\n  z-index: 99997;\n}\n\n._pillar-page-pilot-banner__content {\n  position: relative;\n  z-index: 99999;\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 6px 20px;\n  background: var(--pillar-primary);\n  color: #ffffff;\n  border-bottom-left-radius: var(--pillar-radius-lg);\n  border-bottom-right-radius: var(--pillar-radius-lg);\n  pointer-events: auto;\n}\n\n._pillar-page-pilot-banner__indicator {\n  width: 8px;\n  height: 8px;\n  background: #ffffff;\n  border-radius: 50%;\n  animation: pillar-pulse 1.5s ease-in-out infinite;\n  flex-shrink: 0;\n}\n\n._pillar-page-pilot-banner__text {\n  font-size: 13px;\n  font-weight: 500;\n  color: #ffffff;\n  white-space: nowrap;\n}\n\n._pillar-page-pilot-banner__stop {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n  padding: 5px 10px;\n  margin-left: 4px;\n  font-family: inherit;\n  font-size: 12px;\n  font-weight: 500;\n  color: #ffffff;\n  background: rgba(255, 255, 255, 0.15);\n  border: 1px solid rgba(255, 255, 255, 0.3);\n  border-radius: var(--pillar-radius-md);\n  cursor: pointer;\n  transition: all var(--pillar-transition-fast);\n}\n\n._pillar-page-pilot-banner__stop:hover {\n  background: rgba(255, 255, 255, 0.25);\n  border-color: rgba(255, 255, 255, 0.5);\n}\n\n._pillar-page-pilot-banner__stop:active {\n  transform: scale(0.97);\n}\n\n._pillar-page-pilot-banner__stop-icon {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 14px;\n  height: 14px;\n}\n\n._pillar-page-pilot-banner__stop-icon svg {\n  width: 100%;\n  height: 100%;\n}\n\n/* Confirmation variant \u2014 amber/warning theme */\n._pillar-page-pilot-banner--confirm ._pillar-page-pilot-banner__content {\n  background: #d97706;\n}\n\n._pillar-page-pilot-banner--confirm::before {\n  border-color: #d97706;\n}\n\n._pillar-page-pilot-banner--confirm::after {\n  background: #d97706;\n}\n\n._pillar-page-pilot-banner__warning-icon {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 14px;\n  height: 14px;\n  flex-shrink: 0;\n}\n\n._pillar-page-pilot-banner__warning-icon svg {\n  width: 100%;\n  height: 100%;\n}\n\n._pillar-page-pilot-banner__deny {\n  display: flex;\n  align-items: center;\n  padding: 5px 12px;\n  margin-left: 4px;\n  font-family: inherit;\n  font-size: 12px;\n  font-weight: 500;\n  color: #ffffff;\n  background: rgba(255, 255, 255, 0.15);\n  border: 1px solid rgba(255, 255, 255, 0.3);\n  border-radius: var(--pillar-radius-md);\n  cursor: pointer;\n  transition: all var(--pillar-transition-fast);\n}\n\n._pillar-page-pilot-banner__deny:hover {\n  background: rgba(255, 255, 255, 0.25);\n  border-color: rgba(255, 255, 255, 0.5);\n}\n\n._pillar-page-pilot-banner__deny:active {\n  transform: scale(0.97);\n}\n\n._pillar-page-pilot-banner__allow {\n  display: flex;\n  align-items: center;\n  padding: 5px 12px;\n  font-family: inherit;\n  font-size: 12px;\n  font-weight: 600;\n  color: #d97706;\n  background: #ffffff;\n  border: 1px solid rgba(255, 255, 255, 0.8);\n  border-radius: var(--pillar-radius-md);\n  cursor: pointer;\n  transition: all var(--pillar-transition-fast);\n}\n\n._pillar-page-pilot-banner__allow:hover {\n  background: #fef3c7;\n}\n\n._pillar-page-pilot-banner__allow:active {\n  transform: scale(0.97);\n}\n";

package/dist/components/Panel/Header.d.ts

@@ -1,14 +1,12 @@
 /**
  * Panel Header Component
- * Navigation header with back, home, and close buttons
+ * Navigation header with back, home, history, and close buttons
  */
-import { h } from 'preact';
-import { type ViewType } from '../../store/router';
+import { type ViewType } from "../../store/router";
 interface HeaderProps {
     currentView: ViewType;
-    customTitle?: string;
     /** Hide back and home navigation buttons */
     hideNavigation?: boolean;
 }
-export declare function Header({ currentView, customTitle, hideNavigation }: HeaderProps): h.JSX.Element;
+export declare function Header({ currentView, hideNavigation }: HeaderProps): import("preact").JSX.Element;
 export {};

package/dist/components/Panel/HistoryDropdown.d.ts

@@ -0,0 +1,10 @@
+/**
+ * History Dropdown Component
+ * Shows a list of past conversations grouped by day (like Cursor).
+ */
+import { h } from 'preact';
+interface HistoryDropdownProps {
+    onSelectConversation: (conversationId: string) => void;
+}
+export declare function HistoryDropdown({ onSelectConversation }: HistoryDropdownProps): h.JSX.Element;
+export {};

package/dist/components/Panel/PanelContent.d.ts

@@ -2,5 +2,4 @@
  * Panel Content Component
  * Main panel layout with header, content, and chat input
  */
-import { h } from 'preact';
-export declare function PanelContent(): h.JSX.Element;
+export declare function PanelContent(): import("preact").JSX.Element;