@pillar-ai/sdk 0.2.1 → 0.2.2

package/README.md

@@ -122,6 +122,9 @@ For production, define tools in code and sync them via the `pillar-sync` CLI dur
 const pillar = await Pillar.init({
   agentSlug: "your-agent-slug",
 
+  // Forward an existing auth token to API tool sources (optional)
+  // userApiToken: accessToken,
+
   panel: {
     position: "right", // 'left' | 'right'
     mode: "push", // 'overlay' | 'push'
@@ -150,6 +153,9 @@ const pillar = await Pillar.init({
 | `pillar.close()`             | Close the co-pilot panel                 |
 | `pillar.toggle()`            | Toggle the co-pilot panel                |
 | `pillar.setContext(context)` | Update the user/product context          |
+| `pillar.identify(userId, profile?)` | Associate a user with the session. Profile: `name`, `email`, `apiToken` |
+| `pillar.setUserApiToken(token)` | Forward a Bearer token to API tool sources |
+| `pillar.logout(options?)`    | Clear user identity and API token        |
 | `pillar.on(event, callback)` | Subscribe to SDK events                  |
 
 > **Note:** `Pillar.init()` and `Pillar.getInstance()` are static methods on the class. All other methods (lowercase `pillar`) are instance methods - call them on the instance returned from `init()` or `getInstance()`.

package/dist/api/mcp-client.d.ts

@@ -148,12 +148,19 @@ export declare class MCPClient {
     private config;
     private requestId;
     private _externalUserId;
+    private _userApiToken;
     constructor(config: ResolvedConfig);
     /**
      * Set the external user ID for authenticated users.
      * Enables cross-device conversation history.
      */
     setExternalUserId(userId: string): void;
+    /**
+     * Set a user API token for passthrough to OpenAPI tool sources.
+     * When set, this token is forwarded as-is to customer APIs,
+     * bypassing the per-user OAuth linking flow.
+     */
+    setUserApiToken(token: string): void;
     /**
      * Get or create a persistent visitor ID.
      * Stored in localStorage to persist across sessions.

package/dist/cli/sync.js

@@ -241,7 +241,7 @@ async function scanTools(scanDir) {
   }
   const files = globFiles(absoluteDir, [".ts", ".tsx", ".js", ".jsx", ".mjs"]);
   console.log(`[pillar-sync] Scanning ${files.length} files in ${scanDir}`);
-  const PATTERNS = [
+  const TOOL_PATTERNS = [
     "defineTool",
     "usePillarTool",
     "injectPillarTool",
@@ -249,23 +249,55 @@ async function scanTools(scanDir) {
     "usePillarAction",
     "injectPillarAction"
   ];
+  const SKILL_PATTERN = "defineSkill";
+  const ALL_PATTERNS = [...TOOL_PATTERNS, SKILL_PATTERN];
   const candidateFiles = files.filter((file) => {
     const content = fs.readFileSync(file, "utf-8");
-    return PATTERNS.some((p) => content.includes(p));
+    return ALL_PATTERNS.some((p) => content.includes(p));
   });
-  console.log(`[pillar-sync] Found ${candidateFiles.length} files with tool definitions`);
+  console.log(`[pillar-sync] Found ${candidateFiles.length} files with tool/skill definitions`);
   const tools = [];
+  const skills = [];
   for (const filePath of candidateFiles) {
     let visit2 = function(node) {
       if (ts.isCallExpression(node)) {
         const callee = node.expression;
-        let isTargetCall = false;
+        let isToolCall = false;
+        let isSkillCall = false;
         if (ts.isIdentifier(callee)) {
-          isTargetCall = PATTERNS.includes(callee.text);
+          isToolCall = TOOL_PATTERNS.includes(callee.text);
+          isSkillCall = callee.text === SKILL_PATTERN;
         } else if (ts.isPropertyAccessExpression(callee)) {
-          isTargetCall = callee.name.text === "defineTool" || callee.name.text === "defineAction";
+          isToolCall = callee.name.text === "defineTool" || callee.name.text === "defineAction";
+          isSkillCall = callee.name.text === "defineSkill";
         }
-        if (isTargetCall && node.arguments.length > 0) {
+        if (isSkillCall && node.arguments.length > 0) {
+          const arg = node.arguments[0];
+          const lineNumber = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
+          const relativePath = path.relative(process.cwd(), filePath);
+          if (ts.isObjectLiteralExpression(arg)) {
+            const obj = evaluateNode(arg, ts, fileScope);
+            if (obj && typeof obj.name === "string" && typeof obj.description === "string" && typeof obj.content === "string") {
+              skills.push({
+                name: obj.name,
+                description: obj.description,
+                content: obj.content,
+                sourceFile: relativePath,
+                line: lineNumber
+              });
+              console.log(`[pillar-sync]   skill: ${obj.name} (${relativePath}:${lineNumber})`);
+            } else if (obj) {
+              console.warn(
+                `[pillar-sync] \u26A0 Skipping skill at ${relativePath}:${lineNumber} \u2014 missing name, description, or content`
+              );
+            }
+          } else {
+            console.warn(
+              `[pillar-sync] \u26A0 Skipping skill at ${relativePath}:${lineNumber} \u2014 argument is not an inline object literal`
+            );
+          }
+        }
+        if (isToolCall && node.arguments.length > 0) {
           const arg = node.arguments[0];
           const lineNumber = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
           const relativePath = path.relative(process.cwd(), filePath);
@@ -375,7 +407,27 @@ async function scanTools(scanDir) {
     }
     deduplicatedTools.push(instances[0]);
   }
-  return deduplicatedTools;
+  const skillsByName = /* @__PURE__ */ new Map();
+  for (const skill of skills) {
+    const existing = skillsByName.get(skill.name);
+    if (existing) {
+      existing.push(skill);
+    } else {
+      skillsByName.set(skill.name, [skill]);
+    }
+  }
+  const deduplicatedSkills = [];
+  for (const [name, instances] of skillsByName) {
+    if (instances.length > 1) {
+      const locations = instances.map((s) => `${s.sourceFile}:${s.line}`).join(", ");
+      console.warn(
+        `[pillar-sync] \u26A0 Duplicate skill "${name}" found in ${instances.length} locations: ${locations}`
+      );
+      console.warn(`[pillar-sync]   Using first definition from ${instances[0].sourceFile}:${instances[0].line}`);
+    }
+    deduplicatedSkills.push(instances[0]);
+  }
+  return { tools: deduplicatedTools, skills: deduplicatedSkills };
 }
 function findAgentGuidance(scanDir) {
   const absoluteDir = path.resolve(process.cwd(), scanDir);
@@ -472,19 +524,23 @@ async function main() {
   const platform = process.env.PILLAR_PLATFORM || "web";
   const version = process.env.PILLAR_VERSION || getPackageVersion();
   const gitSha = process.env.GIT_SHA || getGitSha();
-  console.log(`[pillar-sync] Scanning for tools in: ${scanDir}`);
+  console.log(`[pillar-sync] Scanning for tools and skills in: ${scanDir}`);
   let scannedTools;
+  let scannedSkills;
   try {
-    scannedTools = await scanTools(scanDir);
+    const scanResult = await scanTools(scanDir);
+    scannedTools = scanResult.tools;
+    scannedSkills = scanResult.skills;
   } catch (error) {
-    console.error(`[pillar-sync] Failed to scan tools:`, error);
+    console.error(`[pillar-sync] Failed to scan:`, error);
     process.exit(1);
   }
   const toolCount = scannedTools.length;
-  console.log(`[pillar-sync] Found ${toolCount} tools`);
+  const skillCount = scannedSkills.length;
+  console.log(`[pillar-sync] Found ${toolCount} tools and ${skillCount} skills`);
   const agentGuidance = findAgentGuidance(scanDir);
-  if (toolCount === 0) {
-    console.warn("[pillar-sync] No tools found. Nothing to sync.");
+  if (toolCount === 0 && skillCount === 0) {
+    console.warn("[pillar-sync] No tools or skills found. Nothing to sync.");
     process.exit(0);
   }
   const manifest = buildManifestFromScan(scannedTools, platform, version, gitSha, agentGuidance);
@@ -506,6 +562,13 @@ async function main() {
   if (manifest.agentGuidance) {
     requestBody.agent_guidance = manifest.agentGuidance;
   }
+  if (scannedSkills.length > 0) {
+    requestBody.skills = scannedSkills.map((s) => ({
+      name: s.name,
+      description: s.description,
+      content: s.content
+    }));
+  }
   const forceSync = args.force === true;
   const syncUrl = `${apiUrl}/api/admin/configs/${slug}/actions/sync/?async=true${forceSync ? "&force=true" : ""}`;
   console.log(`[pillar-sync] POST ${syncUrl}`);

package/dist/core/Pillar.d.ts

@@ -399,6 +399,8 @@ export declare class Pillar {
         name?: string;
         email?: string;
         metadata?: Record<string, unknown>;
+        /** API token to forward as Bearer to OpenAPI tool sources, bypassing OAuth linking. */
+        apiToken?: string;
     }, options?: {
         preserveConversation?: boolean;
     }): Promise<void>;
@@ -434,6 +436,25 @@ export declare class Pillar {
      * Whether the current user is identified (logged in).
      */
     get isIdentified(): boolean;
+    /**
+     * Pass the user's existing API token for direct forwarding to OpenAPI tool sources.
+     *
+     * When set, Pillar uses this token as a Bearer token for API calls made
+     * on behalf of the user, bypassing the per-user OAuth linking flow.
+     * Useful when the user is already authenticated in your app.
+     *
+     * @param token - The user's API/OAuth token, or empty string to clear
+     *
+     * @example
+     * ```typescript
+     * // After user logs in to your app
+     * pillar.setUserApiToken(accessToken);
+     *
+     * // Clear on logout
+     * pillar.setUserApiToken('');
+     * ```
+     */
+    setUserApiToken(token: string): void;
     /**
      * Report a user action for context building.
      * Recent actions are tracked and sent with chat requests for better context.

package/dist/core/config.d.ts

@@ -435,6 +435,13 @@ export interface PillarConfig {
      * @example ['/login', '/signup', '/onboarding']
      */
     excludeRoutes?: string[];
+    /**
+     * User's API token for OpenAPI tool passthrough.
+     * When set, Pillar forwards this as a Bearer token to API tool sources,
+     * bypassing per-user OAuth linking. Useful when the user is already
+     * authenticated in your app.
+     */
+    userApiToken?: string;
     /** Called when the SDK is initialized and ready. */
     onReady?: () => void;
     /** Called when the SDK encounters an error. */

package/dist/index.d.ts

@@ -23,7 +23,7 @@ export { Pillar, getApiClient, type ChatContext, type PillarState, type ToolInfo
 export { getPillarInstance } from "./core/instance";
 export { DEFAULT_SIDEBAR_TABS, type DOMScanningConfig, type EdgeTriggerConfig, type InteractionHighlightConfig, type MobileTriggerConfig, type MobileTriggerIcon, type MobileTriggerPosition, type MobileTriggerSize, type PanelConfig, type PanelMode, type PanelPosition, type PillarConfig, type ResolvedConfig, type ResolvedDOMScanningConfig, type ResolvedInteractionHighlightConfig, type ResolvedMobileTriggerConfig, type ResolvedPanelConfig, type ResolvedSuggestionsConfig, type ResolvedThemeConfig, type SidebarTabConfig, type SuggestionsConfig, type TextSelectionConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type UrlParamsConfig, type ZIndexConfig, } from "./core/config";
 export { type AssistantContext, type Context, type Suggestion, type UserProfile, } from "./core/context";
-export { clearRegistry, getToolCount, getToolDefinition, getToolNames, getClientInfo, getHandler, getManifest, hasTool, setClientInfo, type ToolDataSchema, type ToolDataSchemaProperty, type ToolDataType, type ToolDefinition, type ToolDefinitions, type ToolManifest, type ToolManifestEntry, type ToolNames, type ToolType, type ToolTypeDataMap, type ToolExecuteResult, type ToolSchemaBase, type InlineUIToolSchema, type ExecutableToolSchema, type ToolSchema, type ClientInfo, type CopyTextData, type ExternalLinkData, type InlineUIData, type NavigateToolData, type TriggerToolData, type QueryToolData, type Platform, type SyncToolDefinition, type SyncToolDefinitions, type TypedOnTask, type TypedPillarMethods, type TypedTaskHandler, getActionCount, getActionDefinition, getActionNames, hasAction, type ActionDataSchema, type ActionDataSchemaProperty, type ActionDataType, type ActionDefinition, type ActionDefinitions, type ActionManifest, type ActionManifestEntry, type ActionNames, type ActionType, type ActionTypeDataMap, type ActionResult, type ActionSchema, type NavigateActionData, type TriggerActionData, type QueryActionData, type SyncActionDefinition, type SyncActionDefinitions, } from "./tools";
+export { clearRegistry, getToolCount, getToolDefinition, getToolNames, getClientInfo, getHandler, getManifest, hasTool, setClientInfo, type ToolDataSchema, type ToolDataSchemaProperty, type ToolDataType, type ToolDefinition, type ToolDefinitions, type ToolManifest, type ToolManifestEntry, type ToolNames, type ToolType, type ToolTypeDataMap, type ToolExecuteResult, type ToolSchemaBase, type InlineUIToolSchema, type ExecutableToolSchema, type ToolSchema, type ClientInfo, type CopyTextData, type ExternalLinkData, type InlineUIData, type NavigateToolData, type TriggerToolData, type QueryToolData, type Platform, type SyncToolDefinition, type SyncToolDefinitions, type TypedOnTask, type TypedPillarMethods, type TypedTaskHandler, defineSkill, type SkillDefinition, getActionCount, getActionDefinition, getActionNames, hasAction, type ActionDataSchema, type ActionDataSchemaProperty, type ActionDataType, type ActionDefinition, type ActionDefinitions, type ActionManifest, type ActionManifestEntry, type ActionNames, type ActionType, type ActionTypeDataMap, type ActionResult, type ActionSchema, type NavigateActionData, type TriggerActionData, type QueryActionData, type SyncActionDefinition, type SyncActionDefinitions, } from "./tools";
 export { APIClient, type ArticleSummary, type ChatMessage, type ChatResponse, type ProgressEvent, } from "./api/client";
 export { type ToolRequest, type ToolData, type ChatImage, type ImageUploadResponse, type TokenUsage, toolToTaskButton, type ActionRequest, type ActionData, actionToTaskButton, } from "./api/mcp-client";
 export { normalizeToolResult } from "./utils/normalize-tool-result";