@pillar-ai/sdk 0.1.21 → 0.1.22

package/dist/store/chat.d.ts

@@ -44,6 +44,8 @@ export declare const historyInvalidationCounter: import("@preact/signals-core").
 export declare const optimisticConversations: import("@preact/signals-core").Signal<ConversationSummary[]>;
 /**
  * Read the persisted conversation ID from localStorage (e.g. for restore on refresh).
+ * Returns null if no conversation is stored or if it's older than 3 minutes,
+ * so stale conversations are discarded and users get a fresh chat.
  */
 export declare function getStoredConversationId(): string | null;
 export declare const isLoading: import("@preact/signals-core").Signal<boolean>;

package/dist/store/tooltips.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tooltips Store
+ * Signal-based state for tooltip visibility and data
+ */
+import type { TooltipData } from '../api/client';
+export interface TooltipInstance {
+    id: string;
+    data: TooltipData;
+    anchor: HTMLElement;
+    isVisible: boolean;
+}
+export declare const tooltips: import("@preact/signals-core").Signal<Map<string, TooltipInstance>>;
+export declare const visibleTooltipId: import("@preact/signals-core").Signal<string | null>;
+export declare const visibleTooltip: import("@preact/signals-core").ReadonlySignal<TooltipInstance | null>;
+export declare const tooltipCount: import("@preact/signals-core").ReadonlySignal<number>;
+export declare const registerTooltip: (id: string, data: TooltipData, anchor: HTMLElement) => void;
+export declare const unregisterTooltip: (id: string) => void;
+export declare const showTooltip: (id: string) => void;
+export declare const hideTooltip: (id: string) => void;
+export declare const hideAllTooltips: () => void;
+export declare const resetTooltips: () => void;

package/dist/tools/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tools Module - Code-first tool definitions for Pillar SDK.
+ *
+ * This module enables developers to define tools in their application code
+ * rather than in the admin UI. Tool metadata is synced to the server during
+ * CI/CD builds via the `pillar-sync` CLI.
+ *
+ * @example
+ * ```ts
+ * // 1. Define tools in your app (e.g., hooks/usePillarTools.ts)
+ * import { usePillarTool } from '@pillar-ai/react';
+ *
+ * usePillarTool({
+ *   name: 'open_settings',
+ *   description: 'Navigate to settings page',
+ *   type: 'navigate',
+ *   execute: () => router.push('/settings'),
+ * });
+ *
+ * // 2. Sync tools via CI/CD
+ * // npx pillar-sync --scan ./src
+ * ```
+ *
+ * @module tools
+ */
+export type { ToolType, ToolDataSchema, ToolDataSchemaProperty, ToolDefinition, ToolDefinitions, ToolManifest, ToolManifestEntry, ClientInfo, Platform, SyncToolDefinition, SyncToolDefinitions, ToolTypeDataMap, NavigateToolData, TriggerToolData, InlineUIData, ExternalLinkData, CopyTextData, QueryToolData, ToolDataType, ToolNames, TypedTaskHandler, TypedOnTask, TypedPillarMethods, ToolExecuteResult, ToolSchema, ActionType, ActionDataSchema, ActionDataSchemaProperty, ActionDefinition, ActionDefinitions, ActionManifest, ActionManifestEntry, SyncActionDefinition, SyncActionDefinitions, NavigateActionData, TriggerActionData, QueryActionData, ActionTypeDataMap, ActionDataType, ActionNames, ActionResult, ActionSchema, } from './types';
+export { setClientInfo, getClientInfo, getHandler, getToolDefinition, hasTool, getToolNames, getManifest, clearRegistry, getToolCount, getActionDefinition, hasAction, getActionNames, getActionCount, } from './registry';

package/dist/tools/registry.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Tool Registry - Manages code-defined tool handlers.
+ *
+ * This module provides the registration and lookup mechanism for
+ * tools defined in code. Tools are registered at runtime via
+ * `pillar.onTask()` and can be looked up by name using `getHandler()`.
+ *
+ * Tool metadata is synced to the server during CI/CD builds using
+ * the `pillar-sync` CLI with a scan pattern:
+ *
+ * @example
+ * ```ts
+ * // lib/pillar/tools/index.ts
+ * import type { SyncToolDefinitions } from '@pillar-ai/sdk';
+ *
+ * export const tools = {
+ *   open_settings: {
+ *     description: 'Navigate to the settings page',
+ *     type: 'navigate' as const,
+ *     path: '/settings',
+ *     autoRun: true,
+ *   },
+ * } as const satisfies SyncToolDefinitions;
+ *
+ * export default tools;
+ *
+ * // Sync via CI/CD:
+ * // npx pillar-sync --scan ./src
+ * ```
+ */
+import type { ToolDefinition, ToolManifest, 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 tool handler by name.
+ *
+ * @param name - Tool name (e.g., "open_settings")
+ * @returns Handler function or undefined if not found
+ */
+export declare function getHandler(name: string): ToolDefinition['handler'] | undefined;
+/**
+ * Get a registered tool definition by name.
+ *
+ * @param name - Tool name
+ * @returns Tool definition or undefined if not found
+ */
+export declare function getToolDefinition(name: string): ToolDefinition | undefined;
+/**
+ * Check if a tool is registered.
+ *
+ * @param name - Tool name
+ * @returns True if registered
+ */
+export declare function hasTool(name: string): boolean;
+/**
+ * Get all registered tool names.
+ *
+ * @returns Array of tool names
+ */
+export declare function getToolNames(): string[];
+/**
+ * Get the tool manifest for syncing to the server.
+ *
+ * Extracts metadata from all registered tools (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 Tool manifest object
+ */
+export declare function getManifest(platform: Platform, version: string, gitSha?: string): ToolManifest;
+/**
+ * Clear all registered tools.
+ *
+ * Primarily for testing purposes.
+ */
+export declare function clearRegistry(): void;
+/**
+ * Get the count of registered tools.
+ *
+ * @returns Number of registered tools
+ */
+export declare function getToolCount(): number;
+/** @deprecated Use getToolDefinition instead */
+export declare const getActionDefinition: typeof getToolDefinition;
+/** @deprecated Use hasTool instead */
+export declare const hasAction: typeof hasTool;
+/** @deprecated Use getToolNames instead */
+export declare const getActionNames: typeof getToolNames;
+/** @deprecated Use getToolCount instead */
+export declare const getActionCount: typeof getToolCount;