@pillar-ai/sdk 0.1.8 → 0.1.14

package/dist/utils/route-observer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Route Observer
+ * Detects SPA navigation and notifies when the route changes.
+ *
+ * Supports:
+ * - pushState/replaceState (React Router, Vue Router, etc.)
+ * - popstate (browser back/forward)
+ * - hashchange (hash-based routing)
+ */
+export interface RouteInfo {
+    pathname: string;
+    search: string;
+    hash: string;
+    url: string;
+    title: string;
+}
+export type RouteChangeCallback = (route: RouteInfo) => void;
+export interface RouteObserverOptions {
+    /** Debounce rapid route changes (ms). Default: 100 */
+    debounceMs?: number;
+}
+export declare class RouteObserver {
+    private _callback;
+    private _debounceMs;
+    private _debounceTimer;
+    private _lastRoute;
+    private _running;
+    private _originalPushState;
+    private _originalReplaceState;
+    constructor(options?: RouteObserverOptions);
+    /**
+     * Whether the observer is currently running.
+     */
+    get running(): boolean;
+    /**
+     * Register a callback for route changes.
+     */
+    onRouteChange(callback: RouteChangeCallback): void;
+    /**
+     * Start observing route changes.
+     */
+    start(): void;
+    /**
+     * Stop observing route changes.
+     */
+    stop(): void;
+    /**
+     * Get the current route info.
+     */
+    getCurrentRoute(): RouteInfo;
+    /**
+     * Patch history.pushState and history.replaceState to detect navigation.
+     */
+    private _patchHistory;
+    /**
+     * Restore original history methods.
+     */
+    private _restoreHistory;
+    /**
+     * Handle route change (with debouncing).
+     */
+    private _handleRouteChange;
+    /**
+     * Get current URL for comparison.
+     */
+    private _getCurrentUrl;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pillar-ai/sdk",
-  "version": "0.1.8",
+  "version": "0.1.14",
   "description": "Pillar Embedded Help SDK - Add contextual help and AI chat to your application",
   "type": "module",
   "main": "./dist/pillar.esm.js",

package/src/actions/types.ts

@@ -6,16 +6,22 @@
  *
  * @example
  * ```ts
- * import { defineActions } from '@pillar-ai/sdk/actions';
+ * // lib/pillar/actions/index.ts
+ * import type { SyncActionDefinitions } from '@pillar-ai/sdk';
  *
- * const actions = defineActions({
+ * export const actions = {
  *   open_settings: {
  *     description: 'Navigate to the settings page',
- *     type: 'navigate',
+ *     type: 'navigate' as const,
  *     path: '/settings',
- *     handler: () => router.push('/settings'),
+ *     autoRun: true,
  *   },
- * });
+ * } as const satisfies SyncActionDefinitions;
+ *
+ * export default actions;
+ *
+ * // Sync via CI/CD: npx pillar-sync --actions ./lib/pillar/actions/index.ts
+ * // Register handlers at runtime: pillar.onTask('open_settings', () => router.push('/settings'));
  * ```
  */
 
@@ -26,6 +32,7 @@
  * - open_modal: Open a modal or dialog
  * - fill_form: Fill form fields with data
  * - trigger_action: Trigger a custom action
+ * - query: Fetch data from the client and return to the agent (implies returns: true)
  * - copy_text: Copy text to clipboard
  * - external_link: Open an external URL
  * - start_tutorial: Start a tutorial/walkthrough
@@ -36,6 +43,7 @@ export type ActionType =
   | 'open_modal'
   | 'fill_form'
   | 'trigger_action'
+  | 'query'
   | 'copy_text'
   | 'external_link'
   | 'start_tutorial'
@@ -188,7 +196,7 @@ export interface ActionDefinition<TData = Record<string, unknown>> {
  *
  * Action names should be snake_case identifiers.
  */
-export type ActionDefinitions = Record<string, ActionDefinition<any>>;
+export type ActionDefinitions = Record<string, ActionDefinition<unknown>>;
 
 /**
  * Metadata for a single action in the manifest (no handler).
@@ -313,7 +321,7 @@ export interface SyncActionDefinition<TData = Record<string, unknown>> {
  *
  * Use this type for your actions file that gets synced via CI/CD.
  */
-export type SyncActionDefinitions = Record<string, SyncActionDefinition<any>>;
+export type SyncActionDefinitions = Record<string, SyncActionDefinition<unknown>>;
 
 // ============================================================================
 // Type Utilities for Type-Safe onTask
@@ -354,6 +362,11 @@ export interface CopyTextData {
   text?: string;
 }
 
+export interface QueryActionData {
+  /** Query parameters passed to the handler */
+  [key: string]: unknown;
+}
+
 /**
  * Maps action types to their default data shapes.
  * Used for automatic type inference in onTask handlers.
@@ -361,6 +374,7 @@ export interface CopyTextData {
 export interface ActionTypeDataMap {
   navigate: NavigateActionData;
   trigger_action: TriggerActionData;
+  query: QueryActionData;
   inline_ui: InlineUIData;
   external_link: ExternalLinkData;
   copy_text: CopyTextData;

package/dist/utils/markdown.d.ts

@@ -1,9 +0,0 @@
-/**
- * Markdown Renderer
- * Uses marked library for parsing markdown to HTML
- */
-/**
- * Render markdown content to HTML
- * Used for AI chat responses
- */
-export declare function renderMarkdown(content: string): string;