@pillar-ai/sdk 0.1.22 → 0.1.23

package/dist/cli/sync.js

@@ -259,6 +259,7 @@ async function scanTools(scanDir) {
               tools.push({
                 name: obj.name,
                 description: obj.description,
+                guidance: typeof obj.guidance === "string" ? obj.guidance : void 0,
                 type: toolType,
                 inputSchema: obj.inputSchema,
                 examples: obj.examples,
@@ -313,13 +314,27 @@ async function scanTools(scanDir) {
   }
   return tools;
 }
+function findAgentGuidance(scanDir) {
+  const absoluteDir = path.resolve(process.cwd(), scanDir);
+  const candidate = path.join(absoluteDir, "AGENT_GUIDANCE.md");
+  if (fs.existsSync(candidate)) {
+    const content = fs.readFileSync(candidate, "utf-8").trim();
+    if (content) {
+      console.log(
+        `[pillar-sync] Found agent guidance: ${path.relative(process.cwd(), candidate)} (${content.length} chars)`
+      );
+      return content;
+    }
+  }
+  return void 0;
+}
 function normalizeTypeForBackend(type) {
   if (type === "trigger_tool") {
     return "trigger_action";
   }
   return type || "trigger_action";
 }
-function buildManifestFromScan(tools, platform, version, gitSha) {
+function buildManifestFromScan(tools, platform, version, gitSha, agentGuidance) {
   const entries = [];
   for (const tool of tools) {
     const entry = {
@@ -328,6 +343,8 @@ function buildManifestFromScan(tools, platform, version, gitSha) {
       // Normalize trigger_tool → trigger_action for backend API compatibility
       type: normalizeTypeForBackend(tool.type)
     };
+    if (tool.guidance)
+      entry.guidance = tool.guidance;
     if (tool.examples?.length)
       entry.examples = tool.examples;
     if (tool.autoRun)
@@ -339,7 +356,7 @@ function buildManifestFromScan(tools, platform, version, gitSha) {
       entry.data_schema = tool.inputSchema;
     entries.push(entry);
   }
-  return {
+  const manifest = {
     platform,
     version,
     gitSha,
@@ -347,6 +364,10 @@ function buildManifestFromScan(tools, platform, version, gitSha) {
     actions: entries
     // Keep 'actions' key for backend API compatibility
   };
+  if (agentGuidance) {
+    manifest.agentGuidance = agentGuidance;
+  }
+  return manifest;
 }
 async function main() {
   const args = parseArgs(process.argv.slice(2));
@@ -391,11 +412,12 @@ async function main() {
   }
   const toolCount = scannedTools.length;
   console.log(`[pillar-sync] Found ${toolCount} tools`);
+  const agentGuidance = findAgentGuidance(scanDir);
   if (toolCount === 0) {
     console.warn("[pillar-sync] No tools found. Nothing to sync.");
     process.exit(0);
   }
-  const manifest = buildManifestFromScan(scannedTools, platform, version, gitSha);
+  const manifest = buildManifestFromScan(scannedTools, platform, version, gitSha, agentGuidance);
   console.log(`[pillar-sync] Platform: ${platform}`);
   console.log(`[pillar-sync] Version: ${version}`);
   console.log(`[pillar-sync] Git SHA: ${gitSha || "not available"}`);
@@ -411,6 +433,9 @@ async function main() {
     git_sha: gitSha,
     actions: manifest.actions
   };
+  if (manifest.agentGuidance) {
+    requestBody.agent_guidance = manifest.agentGuidance;
+  }
   const syncUrl = `${apiUrl}/api/admin/configs/${slug}/actions/sync/?async=true`;
   console.log(`[pillar-sync] POST ${syncUrl}`);
   try {

package/dist/core/Pillar.d.ts

@@ -202,19 +202,13 @@ export declare class Pillar {
     setTextSelectionEnabled(enabled: boolean): void;
     /**
      * Enable or disable DOM scanning at runtime.
-     *
-     * @param enabled - Whether to enable DOM scanning
-     *
-     * @example
-     * // Enable DOM scanning
-     * pillar.setDOMScanningEnabled(true);
-     *
-     * // Disable DOM scanning
-     * pillar.setDOMScanningEnabled(false);
+     * @deprecated DOM scanning is currently disabled and this method has no effect.
+     * @param _enabled - Ignored, DOM scanning cannot be enabled
      */
-    setDOMScanningEnabled(enabled: boolean): void;
+    setDOMScanningEnabled(_enabled: boolean): void;
     /**
      * Whether DOM scanning is currently enabled.
+     * @returns Always returns false - DOM scanning is disabled
      */
     get isDOMScanningEnabled(): boolean;
     /** Currently highlighted element (for cleanup) */

package/dist/core/config.d.ts

@@ -186,41 +186,24 @@ export interface InteractionHighlightConfig {
      */
     scrollBehavior?: ScrollBehavior;
 }
+/**
+ * DOM scanning configuration.
+ * @internal DOM scanning is currently disabled and not available for configuration.
+ */
 export interface DOMScanningConfig {
-    /**
-     * Whether DOM scanning is enabled.
-     * When enabled, page structure is captured and sent with messages.
-     * @default false
-     */
+    /** @internal DOM scanning is disabled */
     enabled?: boolean;
-    /**
-     * Whether to include text content in the scan.
-     * @default true
-     */
+    /** @internal */
     includeText?: boolean;
-    /**
-     * Maximum depth to traverse the DOM tree.
-     * @default 20
-     */
+    /** @internal */
     maxDepth?: number;
-    /**
-     * Whether to only include visible elements.
-     * @default true
-     */
+    /** @internal */
     visibleOnly?: boolean;
-    /**
-     * CSS selector for elements to exclude from scanning.
-     * @example '.sidebar, .footer, [data-no-scan]'
-     */
+    /** @internal */
     excludeSelector?: string;
-    /**
-     * Maximum text length before truncation.
-     * @default 500
-     */
+    /** @internal */
     maxTextLength?: number;
-    /**
-     * Configuration for highlighting elements during AI interactions.
-     */
+    /** Configuration for highlighting elements during AI interactions. */
     interactionHighlight?: InteractionHighlightConfig;
 }
 export interface SuggestionsConfig {
@@ -356,7 +339,11 @@ export interface PillarConfig {
     urlParams?: UrlParamsConfig;
     /** Text selection "Ask AI" popover. */
     textSelection?: TextSelectionConfig;
-    /** DOM scanning for page context. */
+    /**
+     * DOM scanning for page context.
+     * @internal DOM scanning is currently disabled.
+     * @deprecated This feature is not available.
+     */
     domScanning?: DOMScanningConfig;
     /** Page-aware suggestions. */
     suggestions?: SuggestionsConfig;