@pillar-ai/sdk 0.1.22 → 0.1.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -191,6 +191,7 @@ export type ToolDefinitions = Record<string, ToolDefinition<unknown>>;
191
191
  export interface ToolManifestEntry {
192
192
  name: string;
193
193
  description: string;
194
+ guidance?: string;
194
195
  examples?: string[];
195
196
  type: ToolType;
196
197
  path?: string;
@@ -490,6 +491,17 @@ export interface ToolSchema<TInput = Record<string, unknown>> {
490
491
  name: string;
491
492
  /** Human-readable description for AI matching */
492
493
  description: string;
494
+ /**
495
+ * Agent-facing instructions for when/how to use this tool.
496
+ *
497
+ * Appended to the tool description in the LLM's tool list at
498
+ * selection time. Use for disambiguation and prerequisite hints
499
+ * (e.g., "Call get_datasources first to obtain a datasource_uid").
500
+ *
501
+ * Extracted by `pillar-sync --scan` and stored on the backend
502
+ * Action model so the agent sees it without runtime code.
503
+ */
504
+ guidance?: string;
493
505
  /**
494
506
  * Type of tool - determines how the SDK handles it and organizes it in the UI.
495
507
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pillar-ai/sdk",
3
- "version": "0.1.22",
3
+ "version": "0.1.23",
4
4
  "description": "Product copilot SDK for SaaS and web apps — AI assistant that executes tasks, not just answers questions",
5
5
  "type": "module",
6
6
  "main": "./dist/pillar.esm.js",
@@ -68,8 +68,7 @@
68
68
  "@preact/signals": "^1.3.1",
69
69
  "marked": "^17.0.1",
70
70
  "preact": "^10.25.4",
71
- "preact-iso": "^2.9.0",
72
- "user": "^0.0.0"
71
+ "preact-iso": "^2.9.0"
73
72
  },
74
73
  "devDependencies": {
75
74
  "@babel/core": "^7.24.0",