@pillar-ai/sdk 0.1.25 → 0.1.27

package/dist/cli/sync.js

@@ -27,14 +27,19 @@ function printUsage() {
   console.log(`
 Pillar Tool Sync CLI
 
-Scans for usePillarTool/defineTool calls and syncs to the Pillar backend.
-Also supports legacy usePillarAction/defineAction calls.
+Scans for tool definitions and syncs to the Pillar backend.
+
+Supported patterns:
+  - React/Vue: usePillarTool()
+  - Angular: injectPillarTool()
+  - Vanilla JS: pillar.defineTool()
+  - Legacy: usePillarAction(), defineAction(), injectPillarAction()
 
 Usage:
   npx pillar-sync --scan <dir> [--local]
 
 Arguments:
-  --scan <dir>       Directory to scan for usePillarTool/defineTool calls
+  --scan <dir>       Directory to scan for tool definitions
   --local            Use localhost:8003 as the API URL (for local development)
   --force            Force sync even if manifest hash matches an existing deployment
   --help             Show this help message
@@ -230,7 +235,14 @@ async function scanTools(scanDir) {
   }
   const files = globFiles(absoluteDir, [".ts", ".tsx", ".js", ".jsx", ".mjs"]);
   console.log(`[pillar-sync] Scanning ${files.length} files in ${scanDir}`);
-  const PATTERNS = ["defineTool", "usePillarTool", "defineAction", "usePillarAction"];
+  const PATTERNS = [
+    "defineTool",
+    "usePillarTool",
+    "injectPillarTool",
+    "defineAction",
+    "usePillarAction",
+    "injectPillarAction"
+  ];
   const candidateFiles = files.filter((file) => {
     const content = fs.readFileSync(file, "utf-8");
     return PATTERNS.some((p) => content.includes(p));
@@ -313,7 +325,27 @@ async function scanTools(scanDir) {
     );
     visit2(sourceFile);
   }
-  return tools;
+  const toolsByName = /* @__PURE__ */ new Map();
+  for (const tool of tools) {
+    const existing = toolsByName.get(tool.name);
+    if (existing) {
+      existing.push(tool);
+    } else {
+      toolsByName.set(tool.name, [tool]);
+    }
+  }
+  const deduplicatedTools = [];
+  for (const [name, instances] of toolsByName) {
+    if (instances.length > 1) {
+      const locations = instances.map((t) => `${t.sourceFile}:${t.line}`).join(", ");
+      console.warn(
+        `[pillar-sync] \u26A0 Duplicate tool "${name}" found in ${instances.length} locations: ${locations}`
+      );
+      console.warn(`[pillar-sync]   Using first definition from ${instances[0].sourceFile}:${instances[0].line}`);
+    }
+    deduplicatedTools.push(instances[0]);
+  }
+  return deduplicatedTools;
 }
 function findAgentGuidance(scanDir) {
   const absoluteDir = path.resolve(process.cwd(), scanDir);

package/dist/components/Button/EdgeTrigger.d.ts

@@ -36,6 +36,7 @@ export declare class EdgeTrigger {
     /**
      * Handle tab click - sets active tab and opens panel
      * For non-assistant tabs, emits event for customer's code to handle (e.g., Intercom, Zendesk)
+     * Tools tab (debug only) opens the panel with tool debugger
      */
     private handleTabClick;
     /**

package/dist/components/ToolDebugPanel/ToolDebugPanel.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tool Debug Panel Component
+ *
+ * Shows registered tools and allows testing execution.
+ * Only rendered when debug: true is passed to Pillar.init()
+ *
+ * Features:
+ * - Searchable list of all registered tools
+ * - Tool details with input schema
+ * - JSON editor for testing tool execution
+ * - Execute button with result display
+ */
+interface ToolDebugPanelProps {
+    /** Called when user wants to close the panel */
+    onClose?: () => void;
+}
+/**
+ * Tool Debug Panel Component
+ */
+export declare function ToolDebugPanel({ onClose }: ToolDebugPanelProps): import("preact").JSX.Element;
+export default ToolDebugPanel;

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

@@ -0,0 +1 @@
+export { ToolDebugPanel, default } from "./ToolDebugPanel";

package/dist/core/Pillar.d.ts

@@ -2,7 +2,7 @@
  * Main Pillar SDK Class
  * Entry point for all SDK functionality
  */
-import { type ToolSchema } from "../tools";
+import { type ToolSchema, type ToolType } from "../tools";
 import { type PillarConfig, type ResolvedConfig, type ThemeConfig } from "./config";
 import { type Context, type Suggestion, type UserProfile } from "./context";
 import { type CardRenderer, type PillarEvents, type TaskExecutePayload } from "./events";
@@ -20,7 +20,29 @@ export interface ChatContext {
         content: string;
     }>;
 }
+/**
+ * Tool information for the debug panel.
+ */
+export interface ToolInfo {
+    /** Tool name (unique identifier) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Tool type (navigate, query, trigger_tool, etc.) */
+    type?: ToolType;
+    /** JSON Schema for input parameters */
+    inputSchema?: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    /** Where this tool was registered from */
+    source: "defined" | "registered" | "registry";
+    /** Whether the tool has an execute handler */
+    hasHandler: boolean;
+}
 export declare class Pillar {
+    static readonly version: string;
     private static instance;
     private _state;
     private _config;
@@ -54,16 +76,16 @@ export declare class Pillar {
     /**
      * Create or get the shared root container for all Pillar UI elements.
      * Uses isolation: isolate to create a new stacking context.
-     * Z-index varies by panel mode:
-     *   - Push mode: 1000 (above typical navbars but not extreme)
-     *   - Hover/overlay mode: 9999 (floats above host app content)
+     * Z-index varies by panel mode (configurable via zIndex option):
+     *   - Push mode: config.zIndex.push (default: 1)
+     *   - Hover/overlay mode: config.zIndex.hover (default: 9999)
      */
     private _createRootContainer;
     /**
      * Subscribe to hover mode changes and update root container z-index.
-     * Push mode uses a moderate z-index (1000) so the panel sits alongside content
-     * without dominating the stacking order. Hover/overlay mode uses a high z-index
-     * (9999) so the panel floats above the host app.
+     * Push mode uses a low z-index so the panel sits alongside content without
+     * dominating the stacking order. Hover/overlay mode uses a high z-index
+     * so the panel floats above the host app.
      */
     private _subscribeToHoverModeForRoot;
     /**
@@ -112,6 +134,28 @@ export declare class Pillar {
      * Clear debug log entries.
      */
     clearDebugLog(): void;
+    /**
+     * Get all registered tools for debugging.
+     * Returns tools from all sources: defineTool(), registerTool(), and onTask() handlers.
+     *
+     * Only available when debug mode is enabled.
+     *
+     * @returns Array of tool information objects
+     */
+    getTools(): ToolInfo[];
+    /**
+     * Execute a tool by name for debugging purposes.
+     * Only available when debug mode is enabled.
+     *
+     * @param toolName - Name of the tool to execute
+     * @param input - Input parameters to pass to the tool
+     * @returns Promise resolving to the tool's result or error
+     */
+    executeToolForDebug(toolName: string, input: Record<string, unknown>): Promise<{
+        success: boolean;
+        result?: unknown;
+        error?: string;
+    }>;
     /**
      * Subscribe to SDK events
      */

package/dist/core/config.d.ts

@@ -17,7 +17,7 @@ export interface SidebarTabConfig {
     enabled: boolean;
     order: number;
     /** Preset icon for this tab */
-    icon?: 'help' | 'support' | 'settings' | 'feedback' | 'chat' | 'calendar' | 'mail';
+    icon?: 'help' | 'support' | 'settings' | 'feedback' | 'chat' | 'calendar' | 'mail' | 'tools';
 }
 export declare const DEFAULT_SIDEBAR_TABS: SidebarTabConfig[];
 /**
@@ -302,6 +302,25 @@ export interface MobileTriggerConfig {
      */
     offset?: number;
 }
+/**
+ * Z-index configuration for the SDK root container.
+ * Controls stacking order relative to host app content.
+ */
+export interface ZIndexConfig {
+    /**
+     * Z-index when panel is in push mode (shifts content aside).
+     * Use a low value so the panel sits alongside content without
+     * dominating the stacking order.
+     * @default 1
+     */
+    push?: number;
+    /**
+     * Z-index when panel is in hover/overlay mode (floats over content).
+     * Use a high value so the panel floats above host app content.
+     * @default 9999
+     */
+    hover?: number;
+}
 export interface PillarConfig {
     /**
      * Your product key from the Pillar app.
@@ -370,6 +389,11 @@ export interface PillarConfig {
      * ```
      */
     customCSS?: string;
+    /**
+     * Z-index configuration for the SDK root container.
+     * Controls stacking order relative to host app content.
+     */
+    zIndex?: ZIndexConfig;
     /** Called when the SDK is initialized and ready. */
     onReady?: () => void;
     /** Called when the SDK encounters an error. */
@@ -457,6 +481,7 @@ export interface ResolvedConfig {
     sidebarTabs: SidebarTabConfig[];
     theme: ResolvedThemeConfig;
     customCSS?: string;
+    zIndex: Required<ZIndexConfig>;
     onReady?: () => void;
     onError?: (error: Error) => void;
 }

package/dist/core/events.d.ts

@@ -27,7 +27,11 @@ export interface TaskExecutePayload {
  * Callbacks provided to custom card renderers.
  */
 export interface CardCallbacks {
-    /** Called when user confirms the action. Pass modified data if needed. */
+    /**
+     * Called when user confirms the action. Pass modified data if needed.
+     * WARNING: Data passed here flows through the SDK pipeline (telemetry,
+     * agent context, logs). Never include secrets, tokens, or PII.
+     */
     onConfirm: (modifiedData?: Record<string, unknown>) => void;
     /** Called when user cancels the action */
     onCancel: () => void;
@@ -234,6 +238,11 @@ export interface PillarEvents {
         tabId: string;
         label: string;
     };
+    /** A tool was registered or unregistered. */
+    "tools:change": {
+        action: "add" | "remove";
+        name: string;
+    };
     /** @deprecated Use 'sidebar:click' instead. Will be removed in next major version. */
     "support:request": {
         tabId: string;

package/dist/index.d.ts

@@ -19,8 +19,8 @@
  * });
  */
 export { EventEmitter, type CardCallbacks, type CardRenderer, type PillarEvents, type TaskExecutePayload, } from "./core/events";
-export { Pillar, type ChatContext, type PillarState } from "./core/Pillar";
-export { DEFAULT_SIDEBAR_TABS, type DOMScanningConfig, type EdgeTriggerConfig, type InteractionHighlightConfig, type MobileTriggerConfig, type MobileTriggerIcon, type MobileTriggerPosition, type MobileTriggerSize, type PanelConfig, type PanelMode, type PanelPosition, type PillarConfig, type ResolvedConfig, type ResolvedDOMScanningConfig, type ResolvedInteractionHighlightConfig, type ResolvedMobileTriggerConfig, type ResolvedPanelConfig, type ResolvedSuggestionsConfig, type ResolvedThemeConfig, type SidebarTabConfig, type SuggestionsConfig, type TextSelectionConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type UrlParamsConfig, } from "./core/config";
+export { Pillar, type ChatContext, type PillarState, type ToolInfo } from "./core/Pillar";
+export { DEFAULT_SIDEBAR_TABS, type DOMScanningConfig, type EdgeTriggerConfig, type InteractionHighlightConfig, type MobileTriggerConfig, type MobileTriggerIcon, type MobileTriggerPosition, type MobileTriggerSize, type PanelConfig, type PanelMode, type PanelPosition, type PillarConfig, type ResolvedConfig, type ResolvedDOMScanningConfig, type ResolvedInteractionHighlightConfig, type ResolvedMobileTriggerConfig, type ResolvedPanelConfig, type ResolvedSuggestionsConfig, type ResolvedThemeConfig, type SidebarTabConfig, type SuggestionsConfig, type TextSelectionConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type UrlParamsConfig, type ZIndexConfig, } from "./core/config";
 export { type AssistantContext, type Context, type Suggestion, type UserProfile, } from "./core/context";
 export { clearRegistry, getToolCount, getToolDefinition, getToolNames, getClientInfo, getHandler, getManifest, hasTool, setClientInfo, type ToolDataSchema, type ToolDataSchemaProperty, type ToolDataType, type ToolDefinition, type ToolDefinitions, type ToolManifest, type ToolManifestEntry, type ToolNames, type ToolType, type ToolTypeDataMap, type ToolExecuteResult, type ToolSchema, type ClientInfo, type CopyTextData, type ExternalLinkData, type InlineUIData, type NavigateToolData, type TriggerToolData, type QueryToolData, type Platform, type SyncToolDefinition, type SyncToolDefinitions, type TypedOnTask, type TypedPillarMethods, type TypedTaskHandler, getActionCount, getActionDefinition, getActionNames, hasAction, type ActionDataSchema, type ActionDataSchemaProperty, type ActionDataType, type ActionDefinition, type ActionDefinitions, type ActionManifest, type ActionManifestEntry, type ActionNames, type ActionType, type ActionTypeDataMap, type ActionResult, type ActionSchema, type NavigateActionData, type TriggerActionData, type QueryActionData, type SyncActionDefinition, type SyncActionDefinitions, } from "./tools";
 export { APIClient, type ArticleSummary, type ChatMessage, type ChatResponse, type ProgressEvent, } from "./api/client";