@novalabai/adk 2.6.0 → 2.8.1

package/dist/resources/auto-agent.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoAgentResource = void 0;
+/**
+ * Synthesize-and-run a specialist for off-the-beaten-path requests.
+ *
+ * The Auto-Agent invents a fit-for-purpose specialist on demand. When a
+ * user's request doesn't match any registered specialist (intent router
+ * returns `unknown` or low-confidence), call `run()` and Nova will
+ * synthesize a one-shot agent + execute it for the turn.
+ *
+ * @example
+ * ```typescript
+ * const nova = new NovaClient({ apiKey: 'nova_xxx' });
+ *
+ * // Synth + run in one call
+ * const result = await nova.autoAgent.run({
+ *   message: 'help me plan a wedding seating chart for 80 guests',
+ * });
+ * console.log(result.spec.display_name);  // "Wedding Seating Planner"
+ * console.log(result.response);           // domain-quality reply
+ *
+ * // Or just see the spec without running it (e.g. "save this agent?" UX)
+ * const synth = await nova.autoAgent.synthesize({
+ *   message: 'help me plan a wedding seating chart',
+ * });
+ * if (synth.spec.confidence > 0.7) {
+ *   // save into custom agents for re-use
+ * }
+ * ```
+ */
+class AutoAgentResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Generate a specialist spec for the request without executing it.
+     *
+     * Costs one Haiku call (~$0.0001). The returned `spec` includes a
+     * `confidence` value — values below 0.45 mean the synthesizer
+     * couldn't pin down a clear specialty and you should fall back to
+     * plain chat.
+     */
+    async synthesize(params) {
+        return this.http.post('/auto-agent/synthesize', params);
+    }
+    /**
+     * Synthesize a specialist and run it against the user's message.
+     *
+     * Costs two Haiku calls — one for synthesis, one for execution. Always
+     * returns a usable response: when the LLM path fails, both `used_llm`
+     * values flip to `false` and `response` carries a graceful stub
+     * message instead of throwing.
+     */
+    async run(params) {
+        return this.http.post('/auto-agent/run', params);
+    }
+}
+exports.AutoAgentResource = AutoAgentResource;
+//# sourceMappingURL=auto-agent.js.map

package/dist/resources/auto-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-agent.js","sourceRoot":"","sources":["../../src/resources/auto-agent.ts"],"names":[],"mappings":";;;AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAa,iBAAiB;IACX,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,wBAAwB,EACxB,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,CAAC,MAAwB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAuB,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;CACF;AAjCD,8CAiCC"}

package/dist/resources/billing.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../core/http.js';
-import type { Plan, BillingSummary, UsageInfo, Invoice, CheckoutSessionParams, CheckoutSessionResult, PortalSessionResult, VolumeDiscountTier, AuditEntry, EnterpriseContract, EnterpriseContractParams, SSOConfig } from '../types/billing.js';
+import type { Plan, GroupedPlans, BillingSummary, UsageInfo, Invoice, CheckoutSessionParams, CheckoutSessionResult, PortalSessionResult, VolumeDiscountTier, AuditEntry, EnterpriseContract, EnterpriseContractParams, SSOConfig } from '../types/billing.js';
 /**
  * Billing resource — manage subscriptions, usage, Stripe checkout, invoices, and enterprise features.
  *
@@ -23,8 +23,20 @@ import type { Plan, BillingSummary, UsageInfo, Invoice, CheckoutSessionParams, C
 export declare class BillingResource {
     private readonly http;
     constructor(http: HttpClient);
-    /** List available plans with pricing. */
+    /** List available plans with pricing (flat list). */
     plans(): Promise<Plan[]>;
+    /**
+     * List plans grouped by product line (api / app / all-access).
+     *
+     * Returns three lists:
+     *   - api_plans:        pure API access (developers, SDK)
+     *   - app_plans:        Workspace dashboard plans (end-users)
+     *   - all_access_plans: legacy combined plans (back-compat)
+     *
+     * Each plan includes the new dual-pricing fields: product, tagline,
+     * billing_unit. Use this when rendering a tabbed pricing page.
+     */
+    plansGrouped(): Promise<GroupedPlans>;
     /** Full billing summary — plan, usage, limits, cycle, enterprise contract. */
     subscription(): Promise<BillingSummary>;
     /** Current month usage breakdown. */

package/dist/resources/billing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/resources/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,IAAI,EACJ,cAAc,EACd,SAAS,EACT,OAAO,EACP,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EACxB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B,yCAAyC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAK9B,8EAA8E;IACxE,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAI7C,qCAAqC;IAC/B,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;IAIjC,6EAA6E;IACvE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI7E,iEAAiE;IAC3D,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAM9D,0BAA0B;IACpB,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKpC,oDAAoD;IAC9C,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKvC,iCAAiC;IAC3B,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOtD,uDAAuD;IACjD,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI7F,uCAAuC;IACjC,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI1D,sDAAsD;IAChD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAGzE"}
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/resources/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,SAAS,EACT,OAAO,EACP,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EACxB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B,qDAAqD;IAC/C,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAK9B;;;;;;;;;;OAUG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAI3C,8EAA8E;IACxE,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAI7C,qCAAqC;IAC/B,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;IAIjC,6EAA6E;IACvE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI7E,iEAAiE;IAC3D,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAM9D,0BAA0B;IACpB,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKpC,oDAAoD;IAC9C,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKvC,iCAAiC;IAC3B,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOtD,uDAAuD;IACjD,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI7F,uCAAuC;IACjC,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI1D,sDAAsD;IAChD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAGzE"}

package/dist/resources/billing.js

@@ -26,11 +26,25 @@ class BillingResource {
     constructor(http) {
         this.http = http;
     }
-    /** List available plans with pricing. */
+    /** List available plans with pricing (flat list). */
     async plans() {
         const result = await this.http.get('/billing/plans');
         return result.plans;
     }
+    /**
+     * List plans grouped by product line (api / app / all-access).
+     *
+     * Returns three lists:
+     *   - api_plans:        pure API access (developers, SDK)
+     *   - app_plans:        Workspace dashboard plans (end-users)
+     *   - all_access_plans: legacy combined plans (back-compat)
+     *
+     * Each plan includes the new dual-pricing fields: product, tagline,
+     * billing_unit. Use this when rendering a tabbed pricing page.
+     */
+    async plansGrouped() {
+        return this.http.get('/billing/plans?grouped=true');
+    }
     /** Full billing summary — plan, usage, limits, cycle, enterprise contract. */
     async subscription() {
         return this.http.get('/billing/subscription');

package/dist/resources/billing.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../src/resources/billing.ts"],"names":[],"mappings":";;;AAgBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,eAAe;IACT,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAoB,gBAAgB,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,uBAAuB,CAAC,CAAC;IAChE,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAY,gBAAgB,CAAC,CAAC;IACpD,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,QAAQ,CAAC,MAA6B;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAwB,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,MAAM,CAAC,SAAkB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAsB,iBAAiB,EAAE;YAC5D,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAA0B,mBAAmB,CAAC,CAAC;QACjF,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAA4B,gBAAgB,CAAC,CAAC;QAChF,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,eAAe;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkC,2BAA2B,CAAC,CAAC;QACjG,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,mBAAmB;IAEnB,uDAAuD;IACvD,KAAK,CAAC,wBAAwB,CAAC,MAAgC;QAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAqB,8BAA8B,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,qBAAqB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAqB,8BAA8B,CAAC,CAAC;IAC3E,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,MAAc;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAY,yBAAyB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;CACF;AArED,0CAqEC"}
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../src/resources/billing.ts"],"names":[],"mappings":";;;AAiBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,eAAe;IACT,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAoB,gBAAgB,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,6BAA6B,CAAC,CAAC;IACpE,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,uBAAuB,CAAC,CAAC;IAChE,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAY,gBAAgB,CAAC,CAAC;IACpD,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,QAAQ,CAAC,MAA6B;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAwB,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,MAAM,CAAC,SAAkB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAsB,iBAAiB,EAAE;YAC5D,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAA0B,mBAAmB,CAAC,CAAC;QACjF,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAA4B,gBAAgB,CAAC,CAAC;QAChF,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,eAAe;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkC,2BAA2B,CAAC,CAAC;QACjG,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,mBAAmB;IAEnB,uDAAuD;IACvD,KAAK,CAAC,wBAAwB,CAAC,MAAgC;QAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAqB,8BAA8B,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,qBAAqB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAqB,8BAA8B,CAAC,CAAC;IAC3E,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,MAAc;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAY,yBAAyB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;CACF;AApFD,0CAoFC"}

package/dist/resources/chat.d.ts

@@ -1,5 +1,6 @@
 import type { HttpClient } from '../core/http.js';
 import type { ChatMessageParams, ChatResponse, ChatSessionList, ChatHistory } from '../types/chat.js';
+import type { ChatStreamEvent, ChatStreamParams } from '../types/chat-stream.js';
 /**
  * Conversational chat powered by Nova's full AI pipeline.
  *
@@ -52,5 +53,31 @@ export declare class ChatResource {
     history(sessionId: string): Promise<ChatHistory>;
     /** Delete a chat session and its conversation history. */
     deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Stream chat events from /v1/chat/stream as they arrive.
+     *
+     * Yields a discriminated-union of events: `token` (per-token text),
+     * `pipeline` (per-step status), `design` / `document` / `pdf` /
+     * `pptx` / `pptx_visual` / `image` / `audio` (artifacts),
+     * `guardian` (credential redaction), and a final `done`.
+     *
+     * @example
+     * ```typescript
+     * let full = '';
+     * for await (const ev of nova.chat.stream({ message: 'create a 10-slide deck for Acme AI' })) {
+     *   switch (ev.type) {
+     *     case 'token': full += ev.content; process.stdout.write(ev.content); break;
+     *     case 'pdf':   await fs.writeFile('deck.pdf', Buffer.from(ev.pdf_base64, 'base64')); break;
+     *     case 'pptx':  if (ev.variant === 'editable') {
+     *                     await fs.writeFile(ev.filename, Buffer.from(ev.pptx_base64, 'base64'));
+     *                   } break;
+     *     case 'pptx_visual':
+     *                   await fs.writeFile(ev.filename, Buffer.from(ev.pptx_base64, 'base64')); break;
+     *     case 'done':  console.log(`\\nDone — ${ev.model_used}, ${ev.agents_used} agents`); break;
+     *   }
+     * }
+     * ```
+     */
+    stream(params: ChatStreamParams): AsyncIterableIterator<ChatStreamEvent>;
 }
 //# sourceMappingURL=chat.d.ts.map

package/dist/resources/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EAEZ,eAAe,EACf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5D;;;;;;;;;;OAUG;IACG,gBAAgB,CACpB,MAAM,EAAE,iBAAiB,EACzB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,YAAY,CAAC;IAYxB,qCAAqC;IAC/B,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;IAI1C,8CAA8C;IACxC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAItD,0DAA0D;IACpD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtD"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EAEZ,eAAe,EACf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIjF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5D;;;;;;;;;;OAUG;IACG,gBAAgB,CACpB,MAAM,EAAE,iBAAiB,EACzB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,YAAY,CAAC;IAYxB,qCAAqC;IAC/B,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;IAI1C,8CAA8C;IACxC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAItD,0DAA0D;IACpD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACI,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,qBAAqB,CAAC,eAAe,CAAC;CAKhF"}

package/dist/resources/chat.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChatResource = void 0;
+const chat_stream_js_1 = require("../types/chat-stream.js");
 const fallback_js_1 = require("../core/fallback.js");
 /**
  * Conversational chat powered by Nova's full AI pipeline.
@@ -68,6 +69,36 @@ class ChatResource {
     async deleteSession(sessionId) {
         return this.http.delete(`/chat/sessions/${sessionId}`);
     }
+    /**
+     * Stream chat events from /v1/chat/stream as they arrive.
+     *
+     * Yields a discriminated-union of events: `token` (per-token text),
+     * `pipeline` (per-step status), `design` / `document` / `pdf` /
+     * `pptx` / `pptx_visual` / `image` / `audio` (artifacts),
+     * `guardian` (credential redaction), and a final `done`.
+     *
+     * @example
+     * ```typescript
+     * let full = '';
+     * for await (const ev of nova.chat.stream({ message: 'create a 10-slide deck for Acme AI' })) {
+     *   switch (ev.type) {
+     *     case 'token': full += ev.content; process.stdout.write(ev.content); break;
+     *     case 'pdf':   await fs.writeFile('deck.pdf', Buffer.from(ev.pdf_base64, 'base64')); break;
+     *     case 'pptx':  if (ev.variant === 'editable') {
+     *                     await fs.writeFile(ev.filename, Buffer.from(ev.pptx_base64, 'base64'));
+     *                   } break;
+     *     case 'pptx_visual':
+     *                   await fs.writeFile(ev.filename, Buffer.from(ev.pptx_base64, 'base64')); break;
+     *     case 'done':  console.log(`\\nDone — ${ev.model_used}, ${ev.agents_used} agents`); break;
+     *   }
+     * }
+     * ```
+     */
+    async *stream(params) {
+        for await (const raw of this.http.postStream('/chat/stream', params)) {
+            yield (0, chat_stream_js_1.parseChatEvent)(raw);
+        }
+    }
 }
 exports.ChatResource = ChatResource;
 //# sourceMappingURL=chat.js.map

package/dist/resources/chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":";;;AAQA,qDAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,YAAY;IACN,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,MAAyB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,gBAAgB,CACpB,MAAyB,EACzB,cAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;QACvC,MAAM,KAAK,GAAG,cAAc,IAAI,CAAC,GAAG,oCAAsB,CAAC,CAAC;QAE5D,OAAO,IAAA,+BAAiB,EACtB,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EACtE,OAAO,EACP,KAAK,EACL,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAC9B,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAc,kBAAkB,SAAS,UAAU,CAAC,CAAC;IAC3E,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;CACF;AAzDD,oCAyDC"}
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":";;;AASA,4DAAyD;AACzD,qDAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,YAAY;IACN,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,MAAyB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,gBAAgB,CACpB,MAAyB,EACzB,cAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;QACvC,MAAM,KAAK,GAAG,cAAc,IAAI,CAAC,GAAG,oCAAsB,CAAC,CAAC;QAE5D,OAAO,IAAA,+BAAiB,EACtB,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EACtE,OAAO,EACP,KAAK,EACL,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAC9B,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAc,kBAAkB,SAAS,UAAU,CAAC,CAAC;IAC3E,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,MAAwB;QACpC,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC;YACrE,MAAM,IAAA,+BAAc,EAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF;AAxFD,oCAwFC"}

package/dist/resources/files.d.ts

@@ -0,0 +1,59 @@
+import type { HttpClient } from '../core/http.js';
+import type { FileUploadResponse } from '../types/files.js';
+export interface FileUploadParams {
+    /** The file blob to upload (Browser File or a Buffer/Uint8Array on Node) */
+    content: Blob | Uint8Array;
+    /** Filename — used for extension-based type detection on the server */
+    filename: string;
+    /** Optional MIME type override */
+    contentType?: string;
+    /**
+     * Existing chat session id. When omitted, the backend bootstraps a
+     * fresh session and returns its id — pass that id to subsequent
+     * chat calls to keep the conversation tied to the upload.
+     */
+    sessionId?: string;
+}
+/**
+ * Upload + manage chat attachments (.pptx, .pdf, .docx, images).
+ *
+ * Once uploaded, every chat / planner step in the same session sees the
+ * file's extracted text automatically. The deck_builder specialist edits
+ * .pptx files natively (preserving every untouched slide), the vision
+ * agent reads images, etc.
+ *
+ * @example
+ * ```typescript
+ * import { readFile } from 'node:fs/promises';
+ *
+ * const nova = new NovaClient({ apiKey: 'nova_xxx' });
+ *
+ * // Node: read the file from disk
+ * const bytes = await readFile('./my-deck.pptx');
+ * const result = await nova.files.upload({
+ *   content: bytes,
+ *   filename: 'my-deck.pptx',
+ * });
+ *
+ * // Now reference it in a chat turn — backend pulls extracted text
+ * // into the prompt automatically
+ * const reply = await nova.chat.send({
+ *   message: "add a slide titled 'Why Choose Us' with three bullets",
+ *   session_id: result.session_id,
+ * });
+ * ```
+ */
+export declare class FilesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Upload a file as an attachment on a chat session.
+     *
+     * Allowed types (server-enforced): .pptx, .pdf, .docx, .txt, .md,
+     * .csv, .html, .htm, .png, .jpg, .jpeg, .webp, .gif. Cap is 25MB.
+     */
+    upload(params: FileUploadParams): Promise<FileUploadResponse>;
+    /** Detach + delete a file from its session and from backend storage. */
+    delete(fileId: string): Promise<void>;
+}
+//# sourceMappingURL=files.d.ts.map

package/dist/resources/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,OAAO,EAAE,IAAI,GAAG,UAAU,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUnE,wEAAwE;IAClE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5C"}

package/dist/resources/files.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilesResource = void 0;
+/**
+ * Upload + manage chat attachments (.pptx, .pdf, .docx, images).
+ *
+ * Once uploaded, every chat / planner step in the same session sees the
+ * file's extracted text automatically. The deck_builder specialist edits
+ * .pptx files natively (preserving every untouched slide), the vision
+ * agent reads images, etc.
+ *
+ * @example
+ * ```typescript
+ * import { readFile } from 'node:fs/promises';
+ *
+ * const nova = new NovaClient({ apiKey: 'nova_xxx' });
+ *
+ * // Node: read the file from disk
+ * const bytes = await readFile('./my-deck.pptx');
+ * const result = await nova.files.upload({
+ *   content: bytes,
+ *   filename: 'my-deck.pptx',
+ * });
+ *
+ * // Now reference it in a chat turn — backend pulls extracted text
+ * // into the prompt automatically
+ * const reply = await nova.chat.send({
+ *   message: "add a slide titled 'Why Choose Us' with three bullets",
+ *   session_id: result.session_id,
+ * });
+ * ```
+ */
+class FilesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Upload a file as an attachment on a chat session.
+     *
+     * Allowed types (server-enforced): .pptx, .pdf, .docx, .txt, .md,
+     * .csv, .html, .htm, .png, .jpg, .jpeg, .webp, .gif. Cap is 25MB.
+     */
+    async upload(params) {
+        const form = new FormData();
+        const blob = params.content instanceof Blob
+            ? params.content
+            : new Blob([params.content], { type: params.contentType ?? 'application/octet-stream' });
+        form.append('file', blob, params.filename);
+        form.append('session_id', params.sessionId ?? '');
+        return this.http.postMultipart('/files/upload', form);
+    }
+    /** Detach + delete a file from its session and from backend storage. */
+    async delete(fileId) {
+        await this.http.delete(`/files/${fileId}`);
+    }
+}
+exports.FilesResource = FilesResource;
+//# sourceMappingURL=files.js.map

package/dist/resources/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/resources/files.ts"],"names":[],"mappings":";;;AAkBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAa,aAAa;IACP,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,MAAwB;QACnC,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,YAAY,IAAI;YACzC,CAAC,CAAC,MAAM,CAAC,OAAO;YAChB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,OAAqB,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,IAAI,0BAA0B,EAAE,CAAC,CAAC;QACzG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAqB,eAAe,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AA3BD,sCA2BC"}

package/dist/resources/history.d.ts

@@ -4,7 +4,14 @@ import type { AgentRunResult } from '../types/agents.js';
 export declare class HistoryResource {
     private readonly http;
     constructor(http: HttpClient);
-    /** List history entries with optional filters. */
+    /** List history entries with optional filters.
+     *
+     * The server returns a paginated envelope `{total, page, per_page, entries}`,
+     * not a bare array. Older versions of this SDK declared the return type as
+     * `HistoryEntry[]` and downstream code that did `for (const e of data)`
+     * iterated nothing useful. Now we unwrap `entries` if present and still
+     * tolerate a bare-array response from older API builds.
+     */
     list(params?: HistoryQueryParams): Promise<HistoryEntry[]>;
     /** Get a single history entry by ID. */
     get(id: string): Promise<HistoryEntry>;
@@ -14,6 +21,31 @@ export declare class HistoryResource {
     replay(id: string): Promise<AgentRunResult>;
     /** Get aggregated history statistics. */
     stats(): Promise<HistoryStats>;
+    /** Approve the action linked to a history entry (status='approval_needed').
+     *
+     * Returns the executed approval result. Throws NovaAPIError 404 with
+     * code='no_approval' when the entry doesn't have a paired pending
+     * approval (already decided, or never required one).
+     */
+    approve(entryId: string, opts?: {
+        note?: string;
+    }): Promise<unknown>;
+    /** Reject the action linked to a history entry. Same shape as approve(). */
+    reject(entryId: string, opts?: {
+        note?: string;
+    }): Promise<unknown>;
+    /** Get the approval state for a history entry.
+     *
+     * Returns `{status, approval, history_id}`. `status` is one of:
+     *   'pending' | 'approved' | 'rejected' | 'expired' | 'not_required'
+     * `not_required` means the entry never had a paired approval —
+     * useful to disambiguate from a missing entry (which would be 404).
+     */
+    approvalStatus(entryId: string): Promise<{
+        status: 'pending' | 'approved' | 'rejected' | 'expired' | 'not_required';
+        approval: Record<string, unknown> | null;
+        history_id: string;
+    }>;
     /** Export history entries (same filters as list, returns raw array). */
     export(params?: HistoryExportParams): Promise<HistoryEntry[]>;
 }

package/dist/resources/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/resources/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B,kDAAkD;IAC5C,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIhE,wCAAwC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5C,2DAA2D;IACrD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIvD,mCAAmC;IAC7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjD,yCAAyC;IACnC,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAIpC,wEAAwE;IAClE,MAAM,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAGpE"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/resources/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;;;OAOG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAShE,wCAAwC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5C,2DAA2D;IACrD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIvD,mCAAmC;IAC7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjD,yCAAyC;IACnC,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAIpC;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAM1E,4EAA4E;IACtE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAMzE;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;QACzE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACzC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAIF,wEAAwE;IAClE,MAAM,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAQpE"}

package/dist/resources/history.js

@@ -6,9 +6,19 @@ class HistoryResource {
     constructor(http) {
         this.http = http;
     }
-    /** List history entries with optional filters. */
+    /** List history entries with optional filters.
+     *
+     * The server returns a paginated envelope `{total, page, per_page, entries}`,
+     * not a bare array. Older versions of this SDK declared the return type as
+     * `HistoryEntry[]` and downstream code that did `for (const e of data)`
+     * iterated nothing useful. Now we unwrap `entries` if present and still
+     * tolerate a bare-array response from older API builds.
+     */
     async list(params) {
-        return this.http.get('/history', params);
+        const data = await this.http.get('/history', params);
+        if (Array.isArray(data))
+            return data;
+        return data?.entries ?? [];
     }
     /** Get a single history entry by ID. */
     async get(id) {
@@ -26,9 +36,39 @@ class HistoryResource {
     async stats() {
         return this.http.get('/history/stats');
     }
+    /** Approve the action linked to a history entry (status='approval_needed').
+     *
+     * Returns the executed approval result. Throws NovaAPIError 404 with
+     * code='no_approval' when the entry doesn't have a paired pending
+     * approval (already decided, or never required one).
+     */
+    async approve(entryId, opts) {
+        return this.http.post(`/history/${encodeURIComponent(entryId)}/approve`, {
+            note: opts?.note ?? null,
+        });
+    }
+    /** Reject the action linked to a history entry. Same shape as approve(). */
+    async reject(entryId, opts) {
+        return this.http.post(`/history/${encodeURIComponent(entryId)}/reject`, {
+            note: opts?.note ?? null,
+        });
+    }
+    /** Get the approval state for a history entry.
+     *
+     * Returns `{status, approval, history_id}`. `status` is one of:
+     *   'pending' | 'approved' | 'rejected' | 'expired' | 'not_required'
+     * `not_required` means the entry never had a paired approval —
+     * useful to disambiguate from a missing entry (which would be 404).
+     */
+    async approvalStatus(entryId) {
+        return this.http.get(`/history/${encodeURIComponent(entryId)}/approval-status`);
+    }
     /** Export history entries (same filters as list, returns raw array). */
     async export(params) {
-        return this.http.get('/history/export', params);
+        const data = await this.http.get('/history/export', params);
+        if (Array.isArray(data))
+            return data;
+        return data?.entries ?? [];
     }
 }
 exports.HistoryResource = HistoryResource;

package/dist/resources/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/resources/history.ts"],"names":[],"mappings":";;;AAUA,MAAa,eAAe;IACT,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,IAAI,CAAC,MAA2B;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,UAAU,EAAE,MAA+D,CAAC,CAAC;IACpH,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,YAAY,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,YAAY,EAAE,UAAU,CAAC,CAAC;IACtE,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,YAAY,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,gBAAgB,CAAC,CAAC;IACvD,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,MAAM,CAAC,MAA4B;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,iBAAiB,EAAE,MAA+D,CAAC,CAAC;IAC3H,CAAC;CACF;AApCD,0CAoCC"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/resources/history.ts"],"names":[],"mappings":";;;AAUA,MAAa,eAAe;IACT,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,MAA2B;QACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,UAAU,EACV,MAA+D,CAChE,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,YAAY,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,YAAY,EAAE,UAAU,CAAC,CAAC;IACtE,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,YAAY,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,gBAAgB,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,IAAwB;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE;YACvE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,IAAwB;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE;YACtE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe;QAKlC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClF,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,MAAM,CAAC,MAA4B;QACvC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,iBAAiB,EACjB,MAA+D,CAChE,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;IAC7B,CAAC;CACF;AAvFD,0CAuFC"}

package/dist/resources/planner.d.ts

@@ -0,0 +1,66 @@
+import type { HttpClient } from '../core/http.js';
+import type { AgentList, Plan, PlanCreateRequest, PlanList } from '../types/planner.js';
+/**
+ * Decompose a goal into a DAG and run each step against the right specialist.
+ *
+ * Take a plain-English goal, decompose it into a DAG of specialist steps,
+ * execute. Each step's full artifact (deck HTML, document body, image URL)
+ * is returned in `result_full` so callers can render or download.
+ *
+ * @example
+ * ```typescript
+ * const nova = new NovaClient({ apiKey: 'nova_xxx' });
+ *
+ * // Decompose a goal into a plan
+ * const plan = await nova.planner.create({
+ *   goal: 'Build a marketing plan for Acme AI and a 10-slide deck for the seed pitch',
+ * });
+ * for (const step of plan.steps) {
+ *   console.log(`${step.agent}: ${step.action}`);
+ * }
+ *
+ * // Kick off execution
+ * await nova.planner.execute(plan.id);
+ *
+ * // Poll until done
+ * let current: Plan;
+ * while (true) {
+ *   current = await nova.planner.get(plan.id);
+ *   if (['done', 'failed', 'cancelled'].includes(current.status)) break;
+ *   await new Promise((r) => setTimeout(r, 2000));
+ * }
+ *
+ * // Read each step's full output
+ * for (const step of current.steps) {
+ *   if (step.result_full) {
+ *     // e.g. deck HTML — render or persist
+ *   }
+ * }
+ * ```
+ */
+export declare class PlannerResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Every specialist the planner can call (registry-backed). */
+    listAgents(): Promise<AgentList>;
+    /**
+     * Decompose a goal into a plan. Doesn't execute — call `execute()` next.
+     *
+     * When `use_memory` is true (default), the planner pulls relevant memory
+     * snippets to inform decomposition (e.g. user's tone, prior product names).
+     */
+    create(params: PlanCreateRequest): Promise<Plan>;
+    /** List the caller's plans (newest first). */
+    listPlans(): Promise<PlanList>;
+    /**
+     * Read a plan by id, including current step statuses + result_full bodies.
+     * Use this to poll while a plan is executing.
+     */
+    get(planId: string): Promise<Plan>;
+    /**
+     * Kick off execution. Returns immediately with status flipped to "running";
+     * steps execute in the background. Poll `get(planId)` for progress.
+     */
+    execute(planId: string): Promise<Plan>;
+}
+//# sourceMappingURL=planner.d.ts.map

package/dist/resources/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/resources/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,SAAS,EACT,IAAI,EACJ,iBAAiB,EACjB,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B,+DAA+D;IACzD,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IAItC;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,8CAA8C;IACxC,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIpC;;;OAGG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/resources/planner.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlannerResource = void 0;
+/**
+ * Decompose a goal into a DAG and run each step against the right specialist.
+ *
+ * Take a plain-English goal, decompose it into a DAG of specialist steps,
+ * execute. Each step's full artifact (deck HTML, document body, image URL)
+ * is returned in `result_full` so callers can render or download.
+ *
+ * @example
+ * ```typescript
+ * const nova = new NovaClient({ apiKey: 'nova_xxx' });
+ *
+ * // Decompose a goal into a plan
+ * const plan = await nova.planner.create({
+ *   goal: 'Build a marketing plan for Acme AI and a 10-slide deck for the seed pitch',
+ * });
+ * for (const step of plan.steps) {
+ *   console.log(`${step.agent}: ${step.action}`);
+ * }
+ *
+ * // Kick off execution
+ * await nova.planner.execute(plan.id);
+ *
+ * // Poll until done
+ * let current: Plan;
+ * while (true) {
+ *   current = await nova.planner.get(plan.id);
+ *   if (['done', 'failed', 'cancelled'].includes(current.status)) break;
+ *   await new Promise((r) => setTimeout(r, 2000));
+ * }
+ *
+ * // Read each step's full output
+ * for (const step of current.steps) {
+ *   if (step.result_full) {
+ *     // e.g. deck HTML — render or persist
+ *   }
+ * }
+ * ```
+ */
+class PlannerResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Every specialist the planner can call (registry-backed). */
+    async listAgents() {
+        return this.http.get('/planner/agents');
+    }
+    /**
+     * Decompose a goal into a plan. Doesn't execute — call `execute()` next.
+     *
+     * When `use_memory` is true (default), the planner pulls relevant memory
+     * snippets to inform decomposition (e.g. user's tone, prior product names).
+     */
+    async create(params) {
+        return this.http.post('/planner/plan', params);
+    }
+    /** List the caller's plans (newest first). */
+    async listPlans() {
+        return this.http.get('/planner/plans');
+    }
+    /**
+     * Read a plan by id, including current step statuses + result_full bodies.
+     * Use this to poll while a plan is executing.
+     */
+    async get(planId) {
+        return this.http.get(`/planner/plans/${planId}`);
+    }
+    /**
+     * Kick off execution. Returns immediately with status flipped to "running";
+     * steps execute in the background. Poll `get(planId)` for progress.
+     */
+    async execute(planId) {
+        return this.http.post(`/planner/plans/${planId}/execute`, {});
+    }
+}
+exports.PlannerResource = PlannerResource;
+//# sourceMappingURL=planner.js.map