@pillar-ai/sdk 0.1.19 → 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/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>;
+}

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

@@ -0,0 +1,49 @@
+/**
+ * AG-UI Bridge
+ *
+ * Temporary bridge that converts Phase 1's JSON-RPC wrapped AG-UI events
+ * to native AG-UI events. This allows the SDK to use AG-UI patterns while
+ * the backend still uses JSON-RPC transport.
+ *
+ * Will be removed after Phase 3 (pure AG-UI transport).
+ */
+import type { AGUIEvent } from '@ag-ui/core';
+/**
+ * Unwrap an AG-UI event from a JSON-RPC notification.
+ *
+ * Phase 1 backend wraps AG-UI events like this:
+ * {
+ *   "jsonrpc": "2.0",
+ *   "method": "notifications/progress",
+ *   "params": {
+ *     "ag_ui_event": { "type": "RUN_STARTED", ... }
+ *   }
+ * }
+ *
+ * @param jsonRpcEvent - The JSON-RPC notification from the backend
+ * @returns The unwrapped AG-UI event, or null if not an AG-UI event
+ */
+export declare function unwrapAGUIEvent(jsonRpcEvent: unknown): AGUIEvent | null;
+/**
+ * Check if a JSON-RPC event contains an AG-UI event.
+ */
+export declare function isAGUIWrappedEvent(jsonRpcEvent: unknown): boolean;
+/**
+ * Convert legacy MCP progress events to AG-UI events.
+ *
+ * This is for backwards compatibility during the transition.
+ * Converts old-style progress events to AG-UI events.
+ *
+ * @param legacyEvent - The legacy MCP progress event
+ * @returns An array of AG-UI events (may be multiple for some conversions)
+ */
+export declare function convertLegacyProgressToAGUI(legacyEvent: Record<string, unknown>): AGUIEvent[];
+/**
+ * Process a raw SSE event and extract AG-UI events.
+ *
+ * Handles both new AG-UI wrapped events and legacy progress events.
+ *
+ * @param rawEvent - The parsed JSON from an SSE data line
+ * @returns An array of AG-UI events
+ */
+export declare function processSSEEvent(rawEvent: unknown): AGUIEvent[];