@pillar-ai/sdk 0.1.25 → 0.1.26

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;
@@ -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[];
 /**

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,7 +19,7 @@
  * });
  */
 export { EventEmitter, type CardCallbacks, type CardRenderer, type PillarEvents, type TaskExecutePayload, } from "./core/events";
-export { Pillar, type ChatContext, type PillarState } from "./core/Pillar";
+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, } 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";