@pillar-ai/sdk 0.1.8 → 0.1.14

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,17 @@ 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;
+}
 /** Streaming callbacks for tool calls */
 export interface StreamCallbacks {
     /** Called for each text token */
@@ -53,17 +65,32 @@ 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 (early conversation_id) */
+    onConversationStarted?: (conversationId: string, messageId?: string) => void;
     /** Called when stream is complete */
     onComplete?: (conversationId?: string, queryLogId?: string) => void;
-    /** Called for progress updates */
+    /** Called for progress updates (search, query, generating, thinking, etc.) */
     onProgress?: (progress: {
         kind: 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;
         message?: string;
     }) => void;
+    /** Called when agent requests action execution (unified handler) */
+    onActionRequest?: (request: ActionRequest) => Promise<void>;
 }
 /** Image for chat requests (from upload-image endpoint) */
 export interface ChatImage {
@@ -80,7 +107,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;
@@ -120,104 +167,83 @@ 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;
     }): Promise<ToolResult>;
     /**
-     * Continue plan execution after receiving step result.
+     * Send action result back to the agent.
      *
-     * 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.
+     * 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
-     * @param stepId - UUID of the completed step
-     * @param result - Step execution result
-     * @returns Updated plan with all steps
+     * @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
      */
-    continuePlan(planId: string, stepId: string, result: unknown): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    sendActionResult(actionName: string, result: unknown, toolCallId?: string): Promise<void>;
     /**
-     * Cancel an in-progress plan.
+     * Send a client-side log to the server for debugging.
      *
-     * Marks the plan as cancelled and skips any pending steps.
+     * 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 to cancel
-     * @returns Updated plan with cancelled status
+     * @param level - Log level: 'log', 'warn', or 'error'
+     * @param message - The log message
+     * @param data - Optional additional data to include
      */
-    cancelPlan(planId: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    sendLog(level: 'log' | 'warn' | 'error', message: string, data?: unknown): Promise<void>;
     /**
-     * Get current state of a plan.
+     * Send a batch of client-side logs to the server.
      *
-     * Returns the plan and all its steps with current statuses.
+     * 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
-     * @returns Plan with all steps
+     * @param logs - Array of log entries to send
      */
-    getPlan(planId: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    sendLogBatch(logs: LogEntry[]): void;
     /**
-     * Start a plan that was waiting for user confirmation.
-     *
-     * For plans with auto_execute=false, the user must explicitly
-     * start execution by calling this method.
+     * Check if a conversation has a resumable interrupted session.
      *
-     * @param planId - UUID of the plan to start
-     * @returns Updated plan with executing status
+     * @param conversationId - The conversation UUID to check
+     * @returns Session status with resumption details, or null if not resumable
      */
-    startPlan(planId: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    getConversationStatus(conversationId: string): Promise<ConversationStatus | null>;
     /**
-     * Retry a failed step.
+     * Resume an interrupted conversation.
      *
-     * Increments the retry count and resets the step to ready status.
-     * Only works if the step is retriable and hasn't exceeded max_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 step to retry
-     * @returns Updated plan with step reset to ready
-     */
-    retryStep(planId: string, stepId: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
-    /**
-     * Mark a step as failed.
-     *
-     * Records the error and determines if the plan should also fail
-     * (if step is not retriable or out of retries).
-     *
-     * @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
+     * @param callbacks - Streaming callbacks
      */
-    failStep(planId: string, stepId: string, errorMessage?: string): Promise<{
-        plan: ExecutionPlan;
-    }>;
+    resumeConversation(conversationId: string, userContext: Record<string, unknown> | 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.d.ts

@@ -1,2 +1 @@
-#!/usr/bin/env node
 export {};

package/dist/cli/sync.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-#!/usr/bin/env node
 
 // src/cli/sync.ts
 import * as fs from "fs";
@@ -59,26 +58,101 @@ async function loadActions(actionsPath) {
   if (!fs.existsSync(absolutePath)) {
     throw new Error(`Actions file not found: ${absolutePath}`);
   }
+  const isTypeScript = absolutePath.endsWith(".ts") || absolutePath.endsWith(".tsx");
+  if (isTypeScript) {
+    try {
+      const tempDir = path.dirname(absolutePath);
+      const tempFile = path.join(tempDir, `.pillar-sync-temp-${Date.now()}.mjs`);
+      const importPath = absolutePath.replace(/\\/g, "/");
+      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}"`, {
+          encoding: "utf-8",
+          cwd: process.cwd(),
+          stdio: ["pipe", "pipe", "pipe"]
+        });
+        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, agentGuidance };
+      } finally {
+        if (fs.existsSync(tempFile)) {
+          fs.unlinkSync(tempFile);
+        }
+      }
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("tsx")) {
+        console.error("[pillar-sync] TypeScript files require tsx.");
+        console.error("[pillar-sync] Make sure tsx is installed: npm install -D tsx");
+        console.error("[pillar-sync] Then run: npx pillar-sync --actions ./actions.ts");
+      }
+      throw error;
+    }
+  }
   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) {
-    if (error instanceof Error && error.message.includes("Unknown file extension")) {
-      console.error("[pillar-sync] TypeScript files require tsx.");
-      console.error("[pillar-sync] Make sure tsx is installed: npm install -D tsx");
-      console.error("[pillar-sync] Then run: npx pillar-sync --actions ./actions.ts");
-    }
     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 = {
@@ -96,8 +170,11 @@ 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)
@@ -106,13 +183,17 @@ function buildManifest(actions, platform, version, gitSha) {
       entry.required_context = definition.requiredContext;
     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();
@@ -210,15 +291,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);
@@ -229,7 +314,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));
@@ -242,6 +327,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/Panel/Header.d.ts

@@ -1,6 +1,6 @@
 /**
  * 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';

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/Panel.d.ts

@@ -38,6 +38,7 @@ export declare class Panel {
      */
     open(options?: {
         view?: string;
+        search?: string;
         focusInput?: boolean;
     }): void;
     /**

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

@@ -3,6 +3,7 @@
  *
  * Renders a task action button in chat responses.
  * When clicked, triggers the task execution via the Pillar SDK.
+ * For inline_ui actions, clicking toggles a confirmation card below the button.
  *
  * Presentation (label, icon) is derived from task name and type.
  * The server only sends: name, task_type, data.
@@ -25,16 +26,6 @@ export interface TaskButtonData {
     autoRun?: boolean;
     /** If true, action completes without waiting for host confirmation */
     autoComplete?: boolean;
-    /** @deprecated SDK now derives label from name */
-    label?: string;
-    /** @deprecated SDK now derives icon from taskType */
-    icon?: string;
-    /** @deprecated Use default variant */
-    buttonVariant?: 'default' | 'primary' | 'secondary' | 'outline' | 'ghost';
-    /** @deprecated Included in data.path */
-    path?: string;
-    /** @deprecated Included in data.url */
-    externalUrl?: string;
 }
 interface TaskButtonProps {
     task: TaskButtonData;
@@ -43,9 +34,8 @@ interface TaskButtonProps {
 /**
  * Create a TaskButton element.
  *
- * Presentation is derived:
- * - Label: from task.label (legacy) or derived from task.name
- * - Icon: from task.icon (legacy) or derived from task.taskType
+ * Presentation is derived from task.name and task.taskType.
+ * For inline_ui actions, clicking toggles a confirmation card below the button.
  */
 export declare function createTaskButton(props: TaskButtonProps): HTMLButtonElement;
 /**
@@ -55,5 +45,5 @@ export declare function createTaskButtonGroup(tasks: TaskButtonData[]): HTMLDivE
 /**
  * CSS styles for TaskButton (to be added to PANEL_STYLES).
  */
-export declare const TASK_BUTTON_STYLES = "\n/* Task Button Component */\n.pillar-task-btn {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  padding: 8px 14px;\n  font-size: 13px;\n  font-weight: 500;\n  font-family: inherit;\n  border-radius: 8px;\n  cursor: pointer;\n  transition: all 0.15s ease;\n  border: 1px solid transparent;\n  text-decoration: none;\n}\n\n.pillar-task-btn__icon {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  flex-shrink: 0;\n}\n\n.pillar-task-btn__icon svg {\n  width: 16px;\n  height: 16px;\n}\n\n.pillar-task-btn__label {\n  white-space: nowrap;\n}\n\n/* Primary variant (default) */\n.pillar-task-btn--primary {\n  background: #2563eb;\n  color: #ffffff;\n  border-color: #2563eb;\n}\n\n.pillar-task-btn--primary:hover {\n  background: #1d4ed8;\n  border-color: #1d4ed8;\n}\n\n/* Default variant */\n.pillar-task-btn--default {\n  background: #f3f4f6;\n  color: #1a1a1a;\n  border-color: #e5e7eb;\n}\n\n.pillar-task-btn--default:hover {\n  background: #e5e7eb;\n}\n\n/* Secondary variant */\n.pillar-task-btn--secondary {\n  background: #eff6ff;\n  color: #2563eb;\n  border-color: #dbeafe;\n}\n\n.pillar-task-btn--secondary:hover {\n  background: #dbeafe;\n}\n\n/* Outline variant */\n.pillar-task-btn--outline {\n  background: transparent;\n  color: #2563eb;\n  border-color: #2563eb;\n}\n\n.pillar-task-btn--outline:hover {\n  background: #eff6ff;\n}\n\n/* Ghost variant */\n.pillar-task-btn--ghost {\n  background: transparent;\n  color: #6b7280;\n  border-color: transparent;\n}\n\n.pillar-task-btn--ghost:hover {\n  background: #f3f4f6;\n  color: #1a1a1a;\n}\n\n/* Task button group */\n.pillar-task-btn-group {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 8px;\n  margin-top: 12px;\n}\n\n/* Task suggestion card in chat */\n.pillar-task-suggestion {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 12px;\n  background: #f9fafb;\n  border: 1px solid #e5e7eb;\n  border-radius: 12px;\n  margin-top: 12px;\n}\n\n.pillar-task-suggestion__header {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  font-size: 11px;\n  font-weight: 600;\n  text-transform: uppercase;\n  letter-spacing: 0.5px;\n  color: #6b7280;\n}\n\n.pillar-task-suggestion__header svg {\n  width: 14px;\n  height: 14px;\n}\n\n.pillar-task-suggestion__description {\n  font-size: 13px;\n  color: #374151;\n}\n";
+export declare const TASK_BUTTON_STYLES = "\n/* Task Button Component */\n.pillar-task-btn {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  padding: 8px 14px;\n  font-size: 13px;\n  font-weight: 500;\n  font-family: inherit;\n  border-radius: 8px;\n  cursor: pointer;\n  transition: all 0.15s ease;\n  border: 1px solid transparent;\n  text-decoration: none;\n}\n\n.pillar-task-btn__icon {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  flex-shrink: 0;\n}\n\n.pillar-task-btn__icon svg {\n  width: 16px;\n  height: 16px;\n}\n\n.pillar-task-btn__label {\n  white-space: nowrap;\n}\n\n/* Primary variant (default) */\n.pillar-task-btn--primary {\n  background: #2563eb;\n  color: #ffffff;\n  border-color: #2563eb;\n}\n\n.pillar-task-btn--primary:hover {\n  background: #1d4ed8;\n  border-color: #1d4ed8;\n}\n\n/* Default variant */\n.pillar-task-btn--default {\n  background: #f3f4f6;\n  color: #1a1a1a;\n  border-color: #e5e7eb;\n}\n\n.pillar-task-btn--default:hover {\n  background: #e5e7eb;\n}\n\n/* Secondary variant */\n.pillar-task-btn--secondary {\n  background: #eff6ff;\n  color: #2563eb;\n  border-color: #dbeafe;\n}\n\n.pillar-task-btn--secondary:hover {\n  background: #dbeafe;\n}\n\n/* Outline variant */\n.pillar-task-btn--outline {\n  background: transparent;\n  color: #2563eb;\n  border-color: #2563eb;\n}\n\n.pillar-task-btn--outline:hover {\n  background: #eff6ff;\n}\n\n/* Ghost variant */\n.pillar-task-btn--ghost {\n  background: transparent;\n  color: #6b7280;\n  border-color: transparent;\n}\n\n.pillar-task-btn--ghost:hover {\n  background: #f3f4f6;\n  color: #1a1a1a;\n}\n\n/* Active state for inline_ui buttons with expanded card */\n.pillar-task-btn--active {\n  background: #1d4ed8;\n  border-color: #1d4ed8;\n}\n\n/* Task button group */\n.pillar-task-btn-group {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 8px;\n  margin-top: 12px;\n}\n\n/* Inline card container for inline_ui actions */\n.pillar-task-btn-inline-card {\n  margin-top: 12px;\n  animation: pillar-slide-down 0.15s ease-out;\n}\n\n@keyframes pillar-slide-down {\n  from {\n    opacity: 0;\n    transform: translateY(-8px);\n  }\n  to {\n    opacity: 1;\n    transform: translateY(0);\n  }\n}\n\n/* Task suggestion card in chat */\n.pillar-task-suggestion {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 12px;\n  background: #f9fafb;\n  border: 1px solid #e5e7eb;\n  border-radius: 12px;\n  margin-top: 12px;\n}\n\n.pillar-task-suggestion__header {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  font-size: 11px;\n  font-weight: 600;\n  text-transform: uppercase;\n  letter-spacing: 0.5px;\n  color: #6b7280;\n}\n\n.pillar-task-suggestion__header svg {\n  width: 14px;\n  height: 14px;\n}\n\n.pillar-task-suggestion__description {\n  font-size: 13px;\n  color: #374151;\n}\n";
 export {};