@personize/sdk 0.6.5 → 0.6.6

package/README.md

@@ -109,6 +109,27 @@ const ctx = await client.ai.smartGuidelines({
 console.log(ctx.data.compiledContext);
 ```
 
+#### Content Budget
+
+Control how much guideline content is delivered:
+
+```typescript
+const result = await client.ai.smartGuidelines({
+  message: "write a cold email",
+  maxContentTokens: 5000, // deliver ~2-3 full guidelines, rest as summaries
+});
+
+// Demoted guidelines (over budget) returned with id + description for follow-up
+if (result.data.budgetMetadata?.demotedGuidelines) {
+  for (const g of result.data.budgetMetadata.demotedGuidelines) {
+    // Fetch specific section: client.guidelines.getSection(g.id, { header: "Cold Email" })
+    console.log(`${g.name}: ${g.description} — sections: ${g.sections.join(', ')}`);
+  }
+}
+```
+
+Default: 10,000 tokens. Guidelines too large for the budget are automatically trimmed to relevant sections. Remaining guidelines are returned as summaries with `id`, `description`, and `sections[]` for follow-up via `client.guidelines.getSection()`.
+
 ### Prompt Execution
 
 ```typescript

package/dist/client.js

@@ -153,7 +153,13 @@ class Personize {
              * POST /api/v1/ai/smart-guidelines — Smart guidelines routing. Selects relevant organizational guidelines for a task.
              */
             smartGuidelines: async (options) => {
-                const response = await this.client.post('/api/v1/ai/smart-guidelines', options);
+                // Normalize snake_case alias → camelCase
+                const { max_content_tokens, ...rest } = options;
+                const normalized = {
+                    ...rest,
+                    maxContentTokens: rest.maxContentTokens ?? max_content_tokens,
+                };
+                const response = await this.client.post('/api/v1/ai/smart-guidelines', normalized);
                 return response.data;
             },
             /**

package/dist/types.d.ts

@@ -292,6 +292,10 @@ export interface SmartGuidelinesOptions {
     minScore?: number;
     /** Session ID for conversation continuity. */
     sessionId?: string;
+    /** Maximum tokens of guideline content to deliver. The system selects the most relevant guidelines and trims to fit. Default: 10000. */
+    maxContentTokens?: number;
+    /** @deprecated Use maxContentTokens instead. */
+    max_content_tokens?: number;
 }
 /** @deprecated Use SmartGuidelinesOptions instead. */
 export type SmartContextOptions = SmartGuidelinesOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@personize/sdk",
-    "version": "0.6.5",
+    "version": "0.6.6",
     "description": "Official Personize SDK",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",