@pillar-ai/sdk 0.1.34 → 0.2.0

package/dist/store/chat.d.ts

@@ -41,6 +41,7 @@ export interface StoredChatMessage extends ChatMessage {
     images?: ChatImage[];
     progressEvents?: ProgressEvent[];
     segments?: MessageSegment[];
+    hidden?: boolean;
 }
 export declare const messages: import("@preact/signals-core").Signal<StoredChatMessage[]>;
 export declare const conversationId: import("@preact/signals-core").Signal<string | null>;
@@ -177,6 +178,7 @@ export declare const currentSources: import("@preact/signals-core").Signal<Artic
 export declare const currentActions: import("@preact/signals-core").Signal<TaskButtonData[]>;
 export declare const prefillText: import("@preact/signals-core").Signal<string>;
 export declare const pendingMessage: import("@preact/signals-core").Signal<string | null>;
+export declare const pendingHiddenMessage: import("@preact/signals-core").Signal<string | null>;
 export declare const submitPendingTrigger: import("@preact/signals-core").Signal<number>;
 export declare const focusInputTrigger: import("@preact/signals-core").Signal<number>;
 export declare const userContext: import("@preact/signals-core").Signal<UserContextItem[]>;
@@ -201,6 +203,7 @@ export declare const removePendingImage: (id: string) => void;
 export declare const clearPendingImages: () => void;
 export declare const hasMessages: import("@preact/signals-core").ReadonlySignal<boolean>;
 export declare const addUserMessage: (content: string, userContext?: UserContextItem[], images?: ChatImage[]) => void;
+export declare const addHiddenUserMessage: (content: string) => void;
 export declare const addAssistantMessage: (content: string, messageId?: string) => void;
 export declare const updateLastAssistantMessage: (content: string | undefined, messageId?: string, actions?: TaskButtonData[], sources?: ArticleSummary[]) => void;
 export declare const setActionPending: (messageIndex: number, actionName: string) => void;
@@ -257,6 +260,8 @@ export declare const setPrefillText: (text: string) => void;
 export declare const clearPrefillText: () => void;
 export declare const setPendingMessage: (message: string) => void;
 export declare const clearPendingMessage: () => void;
+export declare const setPendingHiddenMessage: (message: string) => void;
+export declare const clearPendingHiddenMessage: () => void;
 export declare const triggerSubmitPending: () => void;
 export declare const triggerInputFocus: () => void;
 export declare const addUserContext: <T extends Omit<UserContextItem, "id">>(item: T) => void;

package/dist/tools/types.d.ts

@@ -575,7 +575,7 @@ export interface ToolSchemaBase<TInput = Record<string, unknown>> {
  *   name: 'show_results',
  *   description: 'Display search results inline',
  *   type: 'inline_ui',
- *   render: (container, data, { onConfirm, onCancel }) => {
+ *   render: (container, data) => {
  *     container.innerHTML = `<div>${data.items.length} results</div>`;
  *     return () => { container.innerHTML = ''; };
  *   },
@@ -643,6 +643,13 @@ export interface ExecutableToolSchema<TInput = Record<string, unknown>> extends
     execute: (input: TInput) => Promise<ToolExecuteResult | Record<string, unknown> | void> | ToolExecuteResult | Record<string, unknown> | void;
     /** Not applicable for executable tools. Only `inline_ui` tools use `render`. */
     render?: never;
+    /**
+     * When true, the SDK shows a confirmation UI before calling `execute`.
+     * The user must click Confirm to proceed, or Cancel to dismiss.
+     *
+     * @default false
+     */
+    needsConfirmation?: boolean;
 }
 /**
  * Unified tool definition that co-locates metadata and handler.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pillar-ai/sdk",
-  "version": "0.1.34",
+  "version": "0.2.0",
   "description": "Product copilot SDK for SaaS and web apps — AI assistant that executes tasks, not just answers questions",
   "type": "module",
   "main": "./dist/pillar.esm.js",

package/dist/actions/definitions/analytics.d.ts

@@ -1,18 +0,0 @@
-export declare const analyticsActions: {
-    view_search_analytics: {
-        description: string;
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    view_ai_analytics: {
-        description: string;
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-};

package/dist/actions/definitions/content.d.ts

@@ -1,40 +0,0 @@
-export declare const contentActions: {
-    view_all_articles: {
-        description: string;
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    view_article: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-        };
-        handler: () => void;
-    };
-    filter_stale: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-        };
-        handler: () => void;
-    };
-    view_categories: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-        };
-        handler: () => void;
-    };
-};

package/dist/actions/definitions/index.d.ts

@@ -1,26 +0,0 @@
-/**
- * Action Definitions Index
- *
- * Imports and registers all action definitions for the Pillar Admin app.
- * These are code-first action definitions that get synced to the backend
- * during CI/CD builds.
- *
- * To use in your app:
- * 1. Import this file early in your app initialization
- * 2. Or create your own action definitions using defineActions()
- *
- * The action metadata is extracted via `npm run extract-actions` and
- * synced to the backend via `npm run sync-actions`.
- */
-import './navigation';
-import './settings';
-import './sources';
-import './analytics';
-import './team';
-import './support';
-export { navigationActions } from './navigation';
-export { settingsActions } from './settings';
-export { sourcesActions } from './sources';
-export { analyticsActions } from './analytics';
-export { teamActions } from './team';
-export { supportActions } from './support';

package/dist/actions/definitions/navigation.d.ts

@@ -1,65 +0,0 @@
-export declare const navigationActions: {
-    open_knowledge: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_settings: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_actions: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_analytics: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_ai_tester: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_configure: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    create_new_action: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-};

package/dist/actions/definitions/settings.d.ts

@@ -1,162 +0,0 @@
-export declare const settingsActions: {
-    open_branding_settings: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_layout_settings: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_header_settings: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_footer_settings: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_features_settings: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_ai_settings: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    open_seo_settings: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    enable_ai_assistant: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-            target: string;
-        };
-        handler: () => void;
-    };
-    disable_ai_assistant: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-            target: string;
-        };
-        handler: () => void;
-    };
-    enable_dark_mode: {
-        description: string;
-        examples: string[];
-        type: "trigger_action";
-        autoRun: true;
-        autoComplete: true;
-        defaultData: {
-            action: string;
-            theme: string;
-        };
-        handler: () => void;
-    };
-    disable_dark_mode: {
-        description: string;
-        examples: string[];
-        type: "trigger_action";
-        autoRun: true;
-        autoComplete: true;
-        defaultData: {
-            action: string;
-            theme: string;
-        };
-        handler: () => void;
-    };
-    toggle_dark_mode: {
-        description: string;
-        examples: string[];
-        type: "trigger_action";
-        autoRun: true;
-        autoComplete: true;
-        defaultData: {
-            action: string;
-        };
-        handler: () => void;
-    };
-    change_theme: {
-        description: string;
-        type: "trigger_action";
-        autoRun: true;
-        autoComplete: true;
-        defaultData: {
-            action: string;
-        };
-        handler: () => void;
-    };
-    update_logo: {
-        description: string;
-        type: "trigger_action";
-        autoRun: true;
-        autoComplete: true;
-        defaultData: {
-            action: string;
-        };
-        handler: () => void;
-    };
-    add_footer_link: {
-        description: string;
-        type: "trigger_action";
-        autoRun: true;
-        autoComplete: true;
-        defaultData: {
-            action: string;
-        };
-        handler: () => void;
-    };
-    configure_suggested_questions: {
-        description: string;
-        type: "trigger_action";
-        autoRun: true;
-        autoComplete: true;
-        defaultData: {
-            action: string;
-        };
-        handler: () => void;
-    };
-};

package/dist/actions/definitions/sources.d.ts

@@ -1,44 +0,0 @@
-export declare const sourcesActions: {
-    add_new_source: {
-        description: string;
-        examples: string[];
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        dataSchema: {
-            type: "object";
-            properties: {
-                type: {
-                    type: "string";
-                    description: string;
-                };
-                url: {
-                    type: "string";
-                    description: string;
-                };
-                name: {
-                    type: "string";
-                    description: string;
-                };
-            };
-        };
-        handler: () => void;
-    };
-    crawl_website: {
-        description: string;
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    connect_cloud_storage: {
-        description: string;
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-};

package/dist/actions/definitions/support.d.ts

@@ -1,15 +0,0 @@
-export declare const supportActions: {
-    escalate: {
-        description: string;
-        examples: string[];
-        type: "external_link";
-        externalUrl: string;
-        handler: () => void;
-    };
-    defer: {
-        description: string;
-        examples: string[];
-        type: "trigger_action";
-        handler: () => void;
-    };
-};

package/dist/actions/definitions/team.d.ts

@@ -1,120 +0,0 @@
-export declare const teamActions: {
-    open_team_settings: {
-        description: string;
-        type: "navigate";
-        path: string;
-        autoRun: true;
-        autoComplete: true;
-        handler: () => void;
-    };
-    invite_team_member: {
-        description: string;
-        type: "inline_ui";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            card_type: string;
-            emails: never[];
-            role: string;
-        };
-        dataSchema: {
-            type: "object";
-            properties: {
-                emails: {
-                    type: "array";
-                    description: string;
-                };
-                role: {
-                    type: "string";
-                    description: string;
-                    enum: string[];
-                };
-            };
-            required: string[];
-        };
-        requiredContext: {
-            userRole: string;
-        };
-        handler: () => void;
-    };
-    view_pending_invitations: {
-        description: string;
-        type: "trigger_action";
-        autoRun: true;
-        autoComplete: true;
-        defaultData: {
-            action: string;
-        };
-        requiredContext: {
-            userRole: string;
-        };
-        handler: () => void;
-    };
-    resend_invitation: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-        };
-        requiredContext: {
-            userRole: string;
-        };
-        handler: () => void;
-    };
-    cancel_invitation: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-        };
-        requiredContext: {
-            userRole: string;
-        };
-        handler: () => void;
-    };
-    remove_team_member: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-        };
-        requiredContext: {
-            userRole: string;
-        };
-        handler: () => void;
-    };
-    promote_to_admin: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-            role: string;
-        };
-        requiredContext: {
-            userRole: string;
-        };
-        handler: () => void;
-    };
-    demote_to_member: {
-        description: string;
-        type: "trigger_action";
-        autoRun: false;
-        autoComplete: false;
-        defaultData: {
-            action: string;
-            role: string;
-        };
-        requiredContext: {
-            userRole: string;
-        };
-        handler: () => void;
-    };
-};

package/dist/actions/index.d.ts

@@ -1,33 +0,0 @@
-/**
- * Actions Module - Code-first action definitions for Pillar SDK.
- *
- * This module enables developers to define actions in their application code
- * rather than in the admin UI. Action metadata is synced to the server during
- * CI/CD builds via the `pillar-sync` CLI.
- *
- * @example
- * ```ts
- * // 1. Define actions in your app (e.g., lib/pillar/actions.ts)
- * import type { SyncActionDefinitions } from '@pillar-ai/sdk';
- *
- * export const actions: SyncActionDefinitions = {
- *   open_settings: {
- *     description: 'Navigate to settings page',
- *     type: 'navigate',
- *     path: '/settings',
- *     autoRun: true,
- *   },
- * };
- *
- * // 2. Sync actions via CI/CD
- * // npx pillar-sync --actions ./lib/pillar/actions.ts
- *
- * // 3. Register handlers at runtime
- * pillar.onTask('open_settings', () => router.push('/settings'));
- * pillar.onTask('navigate', ({ path }) => router.push(path));
- * ```
- *
- * @module actions
- */
-export type { ActionType, ActionDataSchema, ActionDefinition, ActionDefinitions, ActionManifest, ActionManifestEntry, ClientInfo, Platform, SyncActionDefinition, SyncActionDefinitions, ActionTypeDataMap, NavigateActionData, TriggerActionData, InlineUIData, ExternalLinkData, CopyTextData, ActionDataType, ActionNames, TypedTaskHandler, TypedOnTask, TypedPillarMethods, ActionResult, ActionSchema, } from './types';
-export { setClientInfo, getClientInfo, getHandler, getActionDefinition, hasAction, getActionNames, getManifest, clearRegistry, getActionCount, } from './registry';

package/dist/actions/registry.d.ts

@@ -1,98 +0,0 @@
-/**
- * Action Registry - Manages code-defined action handlers.
- *
- * This module provides the registration and lookup mechanism for
- * actions defined in code. Actions are registered at runtime via
- * `pillar.onTask()` and can be looked up by name using `getHandler()`.
- *
- * Action metadata is synced to the server during CI/CD builds using
- * the `pillar-sync` CLI with a barrel file export pattern:
- *
- * @example
- * ```ts
- * // lib/pillar/actions/index.ts
- * import type { SyncActionDefinitions } from '@pillar-ai/sdk';
- *
- * export const actions = {
- *   open_settings: {
- *     description: 'Navigate to the settings page',
- *     type: 'navigate' as const,
- *     path: '/settings',
- *     autoRun: true,
- *   },
- * } as const satisfies SyncActionDefinitions;
- *
- * export default actions;
- *
- * // Sync via CI/CD:
- * // npx pillar-sync --actions ./lib/pillar/actions/index.ts
- * ```
- */
-import type { ActionDefinition, ActionManifest, ClientInfo, Platform } from './types';
-/**
- * Set client platform and version info.
- *
- * Called internally by Pillar.init() to set platform/version
- * for API requests.
- *
- * @param platform - Platform identifier (web, ios, android, desktop)
- * @param version - App version (semver or git SHA)
- */
-export declare function setClientInfo(platform: Platform, version: string): void;
-/**
- * Get the current client info.
- *
- * @returns Client info or null if not set
- */
-export declare function getClientInfo(): ClientInfo | null;
-/**
- * Get a registered action handler by name.
- *
- * @param name - Action name (e.g., "open_settings")
- * @returns Handler function or undefined if not found
- */
-export declare function getHandler(name: string): ActionDefinition['handler'] | undefined;
-/**
- * Get a registered action definition by name.
- *
- * @param name - Action name
- * @returns Action definition or undefined if not found
- */
-export declare function getActionDefinition(name: string): ActionDefinition | undefined;
-/**
- * Check if an action is registered.
- *
- * @param name - Action name
- * @returns True if registered
- */
-export declare function hasAction(name: string): boolean;
-/**
- * Get all registered action names.
- *
- * @returns Array of action names
- */
-export declare function getActionNames(): string[];
-/**
- * Get the action manifest for syncing to the server.
- *
- * Extracts metadata from all registered actions (without handlers)
- * for sending to the Pillar server during CI/CD.
- *
- * @param platform - Platform to include in manifest
- * @param version - Version to include in manifest
- * @param gitSha - Optional git commit SHA
- * @returns Action manifest object
- */
-export declare function getManifest(platform: Platform, version: string, gitSha?: string): ActionManifest;
-/**
- * Clear all registered actions.
- *
- * Primarily for testing purposes.
- */
-export declare function clearRegistry(): void;
-/**
- * Get the count of registered actions.
- *
- * @returns Number of registered actions
- */
-export declare function getActionCount(): number;