@pillar-ai/sdk 0.1.21 → 0.1.22

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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1,40 @@
+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

@@ -0,0 +1,26 @@
+/**
+ * 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

@@ -0,0 +1,65 @@
+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

@@ -0,0 +1,162 @@
+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

@@ -0,0 +1,44 @@
+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

@@ -0,0 +1,15 @@
+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

@@ -0,0 +1,120 @@
+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

@@ -29,5 +29,5 @@
  *
  * @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 type { ActionType, ActionDataSchema, ActionDefinition, ActionDefinitions, ActionManifest, ActionManifestEntry, ClientInfo, Platform, SyncActionDefinition, SyncActionDefinitions, ActionTypeDataMap, NavigateActionData, TriggerActionData, InlineUIData, ExternalLinkData, CopyTextData, ActionDataType, ActionNames, TypedTaskHandler, TypedOnTask, TypedPillarMethods, } from './types';
 export { setClientInfo, getClientInfo, getHandler, getActionDefinition, hasAction, getActionNames, getManifest, clearRegistry, getActionCount, } from './registry';

package/dist/actions/types.d.ts

@@ -439,92 +439,3 @@ export interface TypedOnTask<TActions extends SyncActionDefinitions | ActionDefi
 export interface TypedPillarMethods<TActions extends SyncActionDefinitions | ActionDefinitions> {
     onTask: TypedOnTask<TActions>;
 }
-/**
- * Result returned from an action's execute function.
- *
- * Follows the MCP tool result format. Plain objects are also accepted
- * by the SDK and normalized to this shape automatically.
- */
-export interface ActionResult {
-    content: Array<{
-        type: 'text';
-        text: string;
-    } | {
-        type: 'image';
-        data: string;
-        mimeType: string;
-    }>;
-    isError?: boolean;
-}
-/**
- * Unified action definition that co-locates metadata and handler.
- *
- * Use with `pillar.defineAction()` or the `usePillarAction()` React hook.
- * The CLI scanner (`npx pillar-sync --scan ./src`) discovers these
- * definitions automatically — no barrel file needed.
- *
- * @template TInput - Type of the input object passed to `execute`
- *
- * @example
- * ```ts
- * pillar.defineAction({
- *   name: 'add_to_cart',
- *   description: 'Add a product to the shopping cart',
- *   inputSchema: {
- *     type: 'object',
- *     properties: {
- *       productId: { type: 'string', description: 'Product ID' },
- *       quantity: { type: 'number', description: 'Quantity to add' },
- *     },
- *     required: ['productId', 'quantity'],
- *   },
- *   execute: async ({ productId, quantity }) => {
- *     await cartApi.add(productId, quantity);
- *     return { content: [{ type: 'text', text: 'Added to cart' }] };
- *   },
- * });
- * ```
- */
-export interface ActionSchema<TInput = Record<string, unknown>> {
-    /** Unique action name (e.g., 'add_to_cart') */
-    name: string;
-    /** Human-readable description for AI matching */
-    description: string;
-    /**
-     * Type of action - determines how the SDK handles it and organizes it in the UI.
-     */
-    type?: ActionType;
-    /**
-     * JSON Schema describing the input parameters.
-     * The AI extracts structured data from the conversation to populate these.
-     */
-    inputSchema?: {
-        type: 'object';
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-    /**
-     * Example user queries that should trigger this action.
-     * Used for semantic matching alongside the description.
-     */
-    examples?: string[];
-    /**
-     * Whether to auto-execute without user confirmation.
-     * @default false
-     */
-    autoRun?: boolean;
-    /**
-     * Whether the action completes immediately after execution.
-     * @default true
-     */
-    autoComplete?: boolean;
-    /**
-     * Handler function executed when the AI invokes this action.
-     *
-     * Can return:
-     * - An `ActionResult` with MCP-style content blocks
-     * - A plain object (SDK normalizes it for the agent)
-     * - `void` if the action has no return value
-     */
-    execute: (input: TInput) => Promise<ActionResult | unknown | void> | ActionResult | unknown | void;
-}

package/dist/api/ag-ui-adapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * AG-UI Client Adapter for Pillar SDK
+ *
+ * Bridges the new AGUIClient to existing chat store patterns.
+ * Allows gradual migration without changing all components at once.
+ *
+ * Copyright (C) 2025 Pillar Team
+ */
+import type { ResolvedConfig } from '../core/config';
+import type { ExecutionPlan } from '../core/plan';
+import type { TaskButtonData } from '../components/Panel/TaskButton';
+import type { UserContextItem } from '../types/user-context';
+import type { ArticleSummary, ChatMessage, ChatResponse, ProgressEvent } from './client';
+import type { QueryRequest, ChatImage } from './mcp-client';
+import { type ClientTool } from './ag-ui-client';
+export interface LegacyStreamCallbacks {
+    /** Called for each text token */
+    onToken?: (token: string) => void;
+    /** Called when sources are available */
+    onSources?: (sources: ArticleSummary[]) => void;
+    /** Called when actions are available */
+    onActions?: (actions: TaskButtonData[]) => void;
+    /** Called when a plan is created */
+    onPlan?: (plan: ExecutionPlan) => void;
+    /** Called for progress updates */
+    onProgress?: (progress: ProgressEvent) => void;
+    /** Called when conversation starts (early conversation_id) */
+    onConversationStarted?: (conversationId: string, messageId?: string) => void;
+    /** Called when agent requests data from host app */
+    onQueryRequest?: (request: QueryRequest) => Promise<void>;
+    /** Called on error */
+    onError?: (error: string) => void;
+    /** Called when stream is complete */
+    onComplete?: (conversationId?: string, queryLogId?: string) => void;
+}
+/**
+ * Wraps AGUIClient to provide the same interface as the legacy MCPClient.
+ * Used during migration to minimize component changes.
+ */
+export declare class AGUIClientAdapter {
+    private client;
+    private currentStep;
+    constructor(config: ResolvedConfig);
+    /**
+     * Register a client-side tool (query action).
+     */
+    registerTool(tool: ClientTool): void;
+    /**
+     * Unregister a client-side tool.
+     */
+    unregisterTool(toolName: string): void;
+    /**
+     * Chat with streaming, using legacy callback patterns.
+     */
+    chat(message: string, callbacks: LegacyStreamCallbacks, options?: {
+        history?: ChatMessage[];
+        userContext?: UserContextItem[];
+        images?: ChatImage[];
+        signal?: AbortSignal;
+    }): Promise<ChatResponse>;
+    /**
+     * Get current thread ID.
+     */
+    get threadId(): string;
+    /**
+     * Start a new conversation.
+     */
+    newThread(): string;
+    /**
+     * Send action result back to the agent (for query actions).
+     *
+     * @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): Promise<void>;
+}