@novalabai/adk 2.6.0 → 2.8.1

package/dist/resources/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/resources/planner.ts"],"names":[],"mappings":";;;AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAa,eAAe;IACT,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAY,iBAAiB,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,MAAyB;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,eAAe,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAW,gBAAgB,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAO,kBAAkB,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,kBAAkB,MAAM,UAAU,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AA1CD,0CA0CC"}

package/dist/resources/repair.d.ts

@@ -0,0 +1,73 @@
+import type { HttpClient } from '../core/http.js';
+import type { ApplyFixResponse, ProposeFixResponse, RepairCase, RepairCaseListResponse } from '../types/repair.js';
+/**
+ * Read + drive the Repair Agent's case queue.
+ *
+ * The Repair Agent self-diagnoses chat-pipeline failures and can open
+ * autonomous draft PRs via the GitHub REST API. Four phases:
+ *
+ *   R1  narrative diagnosis (Sonnet writes 4-section markdown)
+ *   R2  tool-using diagnosis (the agent reads files, greps the codebase)
+ *   R3  propose a unified-diff fix
+ *   R4  apply the fix as a GitHub draft PR
+ *
+ * Most callers only need to *read* cases (list + detail). Triggering R3/R4
+ * is reserved for operators / dashboard UI.
+ *
+ * @example
+ * ```typescript
+ * const nova = new NovaClient({ apiKey: 'nova_xxx' });
+ *
+ * // List recent cases
+ * const list = await nova.repair.listCases(10);
+ * for (const caseDict of list.cases) {
+ *   console.log(caseDict.case_id, caseDict.error_class);
+ * }
+ *
+ * // Drill into one case
+ * const c = await nova.repair.getCase('case_abc');
+ * console.log((c.diagnosis_md ?? '').slice(0, 500));
+ *
+ * // R3 — propose a fix
+ * const proposal = await nova.repair.proposeFix('case_abc');
+ * if (!proposal.no_fix_proposed) console.log(proposal.fix_md);
+ *
+ * // R4 — open autonomous PR (requires GITHUB_AUTOFIX_TOKEN on the API)
+ * const applied = await nova.repair.applyFix('case_abc');
+ * if (applied.ok) console.log('Draft PR:', applied.pr_url);
+ * ```
+ */
+export declare class RepairResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Return the most recent repair cases (newest first). Each entry
+     * includes the failure context, markdown diagnosis, chosen action,
+     * and whether the case was escalated.
+     */
+    listCases(limit?: number): Promise<RepairCaseListResponse>;
+    /**
+     * Full detail for one case.
+     *
+     * Includes the traceback head, attachments summary, pipeline tail,
+     * any R1 diagnosis, and any R3 fix proposal that's been generated.
+     */
+    getCase(caseId: string): Promise<RepairCase>;
+    /**
+     * R3 — re-run the propose_fix Claude tool loop on an already-
+     * diagnosed case. Returns markdown describing the proposed unified
+     * diff (or `no_fix_proposed: true` when the agent isn't confident in
+     * any fix).
+     */
+    proposeFix(caseId: string): Promise<ProposeFixResponse>;
+    /**
+     * R4 — open an autonomous draft PR for the case's proposed fix.
+     *
+     * Requires `GITHUB_AUTOFIX_TOKEN` to be set on the API container (via
+     * Secrets Manager). When the token is missing the call returns 503
+     * with `code: autofix_disabled` — your HttpClient will surface this
+     * as a NovaAPIError.
+     */
+    applyFix(caseId: string): Promise<ApplyFixResponse>;
+}
+//# sourceMappingURL=repair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/resources/repair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;OAIG;IACG,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAMpE;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAmBlD;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAO7D;;;;;;;OAOG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAM1D"}

package/dist/resources/repair.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepairResource = void 0;
+/**
+ * Read + drive the Repair Agent's case queue.
+ *
+ * The Repair Agent self-diagnoses chat-pipeline failures and can open
+ * autonomous draft PRs via the GitHub REST API. Four phases:
+ *
+ *   R1  narrative diagnosis (Sonnet writes 4-section markdown)
+ *   R2  tool-using diagnosis (the agent reads files, greps the codebase)
+ *   R3  propose a unified-diff fix
+ *   R4  apply the fix as a GitHub draft PR
+ *
+ * Most callers only need to *read* cases (list + detail). Triggering R3/R4
+ * is reserved for operators / dashboard UI.
+ *
+ * @example
+ * ```typescript
+ * const nova = new NovaClient({ apiKey: 'nova_xxx' });
+ *
+ * // List recent cases
+ * const list = await nova.repair.listCases(10);
+ * for (const caseDict of list.cases) {
+ *   console.log(caseDict.case_id, caseDict.error_class);
+ * }
+ *
+ * // Drill into one case
+ * const c = await nova.repair.getCase('case_abc');
+ * console.log((c.diagnosis_md ?? '').slice(0, 500));
+ *
+ * // R3 — propose a fix
+ * const proposal = await nova.repair.proposeFix('case_abc');
+ * if (!proposal.no_fix_proposed) console.log(proposal.fix_md);
+ *
+ * // R4 — open autonomous PR (requires GITHUB_AUTOFIX_TOKEN on the API)
+ * const applied = await nova.repair.applyFix('case_abc');
+ * if (applied.ok) console.log('Draft PR:', applied.pr_url);
+ * ```
+ */
+class RepairResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Return the most recent repair cases (newest first). Each entry
+     * includes the failure context, markdown diagnosis, chosen action,
+     * and whether the case was escalated.
+     */
+    async listCases(limit = 50) {
+        return this.http.get(`/repair/cases?limit=${Math.max(1, Math.min(Math.floor(limit), 200))}`);
+    }
+    /**
+     * Full detail for one case.
+     *
+     * Includes the traceback head, attachments summary, pipeline tail,
+     * any R1 diagnosis, and any R3 fix proposal that's been generated.
+     */
+    async getCase(caseId) {
+        const data = await this.http.get(`/repair/cases/${caseId}`);
+        return {
+            case_id: data.case_id ?? caseId,
+            agent_id: data.agent_id ?? null,
+            task_id: data.task_id ?? null,
+            error_class: data.error_class ?? null,
+            error_message: data.error_message ?? null,
+            traceback_head: data.traceback_head ?? null,
+            pipeline_tail: data.pipeline_tail ?? null,
+            diagnosis_md: data.diagnosis_md ?? null,
+            fix_md: data.fix_md ?? null,
+            pr_url: data.pr_url ?? null,
+            status: data.status ?? '',
+            created_at: data.created_at ?? 0,
+            raw: data,
+        };
+    }
+    /**
+     * R3 — re-run the propose_fix Claude tool loop on an already-
+     * diagnosed case. Returns markdown describing the proposed unified
+     * diff (or `no_fix_proposed: true` when the agent isn't confident in
+     * any fix).
+     */
+    async proposeFix(caseId) {
+        return this.http.post(`/repair/cases/${caseId}/propose-fix`, {});
+    }
+    /**
+     * R4 — open an autonomous draft PR for the case's proposed fix.
+     *
+     * Requires `GITHUB_AUTOFIX_TOKEN` to be set on the API container (via
+     * Secrets Manager). When the token is missing the call returns 503
+     * with `code: autofix_disabled` — your HttpClient will surface this
+     * as a NovaAPIError.
+     */
+    async applyFix(caseId) {
+        return this.http.post(`/repair/cases/${caseId}/apply-fix`, {});
+    }
+}
+exports.RepairResource = RepairResource;
+//# sourceMappingURL=repair.js.map

package/dist/resources/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../src/resources/repair.ts"],"names":[],"mappings":";;;AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAa,cAAc;IACR,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,uBAAuB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CACvE,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,iBAAiB,MAAM,EAAE,CAAC,CAAC;QACjF,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;YACrC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;YACzC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;YAC3C,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;YACzC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;YAChC,GAAG,EAAE,IAAI;SACV,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,iBAAiB,MAAM,cAAc,EACrC,EAAE,CACH,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,iBAAiB,MAAM,YAAY,EACnC,EAAE,CACH,CAAC;IACJ,CAAC;CACF;AAtED,wCAsEC"}

package/dist/resources/voice.d.ts

@@ -0,0 +1,47 @@
+import type { HttpClient } from '../core/http.js';
+import type { TranscribeResponse } from '../types/voice.js';
+export interface TranscribeParams {
+    /** The audio blob to transcribe (browser File / Blob / Node Buffer / Uint8Array) */
+    content: Blob | Uint8Array;
+    /** Filename — used for extension-based MIME detection if contentType isn't set */
+    filename: string;
+    /** Optional MIME type override */
+    contentType?: string;
+}
+/**
+ * Speech-to-text via Whisper (V1).
+ *
+ * Audio is NOT persisted server-side — only the transcript text is
+ * retained downstream (typically in chat history when the user submits
+ * the resulting message).
+ *
+ * @example
+ * ```typescript
+ * // Browser
+ * const blob = audioRecorder.stop();
+ * const result = await nova.voice.transcribe({
+ *   content: blob,
+ *   filename: 'recording.webm',
+ *   contentType: 'audio/webm',
+ * });
+ * if (result.error) {
+ *   showToast(`Transcription failed: ${result.error}`);
+ * } else {
+ *   composer.value = result.text;
+ * }
+ *
+ * // Node
+ * import { readFile } from 'node:fs/promises';
+ * const bytes = await readFile('./recording.webm');
+ * const result = await nova.voice.transcribe({
+ *   content: bytes,
+ *   filename: 'recording.webm',
+ * });
+ * ```
+ */
+export declare class VoiceResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    transcribe(params: TranscribeParams): Promise<TranscribeResponse>;
+}
+//# sourceMappingURL=voice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/resources/voice.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,oFAAoF;IACpF,OAAO,EAAE,IAAI,GAAG,UAAU,CAAC;IAC3B,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAItB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CASxE"}

package/dist/resources/voice.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceResource = void 0;
+/**
+ * Speech-to-text via Whisper (V1).
+ *
+ * Audio is NOT persisted server-side — only the transcript text is
+ * retained downstream (typically in chat history when the user submits
+ * the resulting message).
+ *
+ * @example
+ * ```typescript
+ * // Browser
+ * const blob = audioRecorder.stop();
+ * const result = await nova.voice.transcribe({
+ *   content: blob,
+ *   filename: 'recording.webm',
+ *   contentType: 'audio/webm',
+ * });
+ * if (result.error) {
+ *   showToast(`Transcription failed: ${result.error}`);
+ * } else {
+ *   composer.value = result.text;
+ * }
+ *
+ * // Node
+ * import { readFile } from 'node:fs/promises';
+ * const bytes = await readFile('./recording.webm');
+ * const result = await nova.voice.transcribe({
+ *   content: bytes,
+ *   filename: 'recording.webm',
+ * });
+ * ```
+ */
+class VoiceResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async transcribe(params) {
+        const form = new FormData();
+        const ctype = params.contentType ?? guessAudioMime(params.filename);
+        const blob = params.content instanceof Blob
+            ? params.content
+            : new Blob([params.content], { type: ctype });
+        form.append('file', blob, params.filename);
+        return this.http.postMultipart('/voice/transcribe', form);
+    }
+}
+exports.VoiceResource = VoiceResource;
+function guessAudioMime(filename) {
+    const dot = filename.lastIndexOf('.');
+    const ext = dot >= 0 ? filename.slice(dot + 1).toLowerCase() : '';
+    const map = {
+        webm: 'audio/webm',
+        mp4: 'audio/mp4',
+        m4a: 'audio/m4a',
+        mp3: 'audio/mpeg',
+        wav: 'audio/wav',
+        ogg: 'audio/ogg',
+    };
+    return map[ext] ?? 'application/octet-stream';
+}
+//# sourceMappingURL=voice.js.map

package/dist/resources/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/resources/voice.ts"],"names":[],"mappings":";;;AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAa,aAAa;IACP,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpE,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,KAAK,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAqB,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAChF,CAAC;CACF;AAhBD,sCAgBC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,GAAG,GAA2B;QAClC,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,YAAY;QACjB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,WAAW;KACjB,CAAC;IACF,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AAChD,CAAC"}

package/dist/types/auto-agent.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Types for Nova's Auto-Agent API.
+ *
+ * Auto-Agent synthesizes a fit-for-purpose specialist on demand. When
+ * the user's request doesn't fit any registered specialist, Haiku drafts
+ * a fresh system prompt + capabilities for the task and runs it.
+ */
+/**
+ * Request body for /v1/auto-agent/synthesize and /v1/auto-agent/run.
+ */
+export interface AutoAgentRequest {
+    /** The user's request — synthesizer reads this to invent a specialist */
+    message: string;
+    /**
+     * Optional last few chat turns ([{role, content}, ...]) for context.
+     * When provided, the synthesized agent sees them as conversation history.
+     */
+    history?: Array<{
+        role: string;
+        content: string;
+    }>;
+}
+/**
+ * The synthesized specialist spec.
+ *
+ * Save this into nova_custom_agents to make a one-off into a reusable
+ * specialist; otherwise it's ephemeral (lives for one turn).
+ */
+export interface AutoAgentSpec {
+    /** Lowercase slug, max 30 chars */
+    name: string;
+    /** Title-case, max 40 chars */
+    display_name: string;
+    /** One sentence — what this agent does */
+    description: string;
+    /** Full system message used when running the agent */
+    system_prompt: string;
+    /** Verb phrases describing what it can do */
+    capabilities: string[];
+    /** Synth's self-rated fit, 0.0 to 1.0. Below 0.45 = fall back to chat */
+    confidence: number;
+    /** One sentence — why these choices fit */
+    rationale: string;
+    /** False when synthesis fell back to a generic stub (no API key, parse error) */
+    used_llm: boolean;
+}
+/** Response from /v1/auto-agent/synthesize — spec only, no execution. */
+export interface AutoAgentSynthesizeResponse {
+    spec: AutoAgentSpec;
+}
+/** Response from /v1/auto-agent/run — spec + executed reply. */
+export interface AutoAgentRunResponse {
+    spec: AutoAgentSpec;
+    /** The synthesized agent's reply to the user's message */
+    response: string;
+    /** False when run path fell back to a stub reply */
+    used_llm: boolean;
+    /**
+     * Set when the run hit a recoverable error (e.g. 'no_api_key', 'http_429').
+     * The `response` field will still carry a usable stub.
+     */
+    error: string | null;
+}
+//# sourceMappingURL=auto-agent.d.ts.map

package/dist/types/auto-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-agent.d.ts","sourceRoot":"","sources":["../../src/types/auto-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,yEAAyE;AACzE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}

package/dist/types/auto-agent.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Types for Nova's Auto-Agent API.
+ *
+ * Auto-Agent synthesizes a fit-for-purpose specialist on demand. When
+ * the user's request doesn't fit any registered specialist, Haiku drafts
+ * a fresh system prompt + capabilities for the task and runs it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=auto-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-agent.js","sourceRoot":"","sources":["../../src/types/auto-agent.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/types/billing.d.ts

@@ -24,6 +24,23 @@ export interface Plan {
     overage_allowed: boolean;
     overage_per_call_cents: number;
     features: PlanFeatures;
+    /**
+     * Which product line this plan belongs to (PR #91 dual-pricing).
+     * - 'api'  → API-only plans for developers/SDK callers
+     * - 'app'  → Workspace plans for dashboard end-users
+     * - 'all'  → Legacy combined plans (still honored for existing subscribers)
+     */
+    product?: 'api' | 'app' | 'all';
+    /** One-line marketing tagline shown under the plan name */
+    tagline?: string;
+    /** 'account' (flat) or 'seat' (per-user) — affects price-period display */
+    billing_unit?: 'account' | 'seat';
+}
+/** Plans split by product line — returned by /v1/billing/plans?grouped=true */
+export interface GroupedPlans {
+    api_plans: Plan[];
+    app_plans: Plan[];
+    all_access_plans: Plan[];
 }
 export interface SubscriptionInfo {
     plan: string;

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

@@ -1 +1 @@
-{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/types/billing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/types/billing.ts"],"names":[],"mappings":"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"}

package/dist/types/chat-stream.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Types for Nova's streaming chat API (POST /v1/chat/stream).
+ *
+ * Server emits a series of SSE events as the chat pipeline progresses.
+ * Token chunks stream first, then artifacts (design HTML, PDF, PPT,
+ * etc.) land as discrete events, then a terminal `done` event closes
+ * the turn. Each event is a discriminated union member keyed on `type`.
+ */
+/** Body for POST /v1/chat/stream. */
+export interface ChatStreamParams {
+    message: string;
+    /** auto / claude / gpt-4o / gemini / ollama-* / etc. */
+    model?: string;
+    session_id?: string;
+    history?: Array<{
+        role: string;
+        content: string;
+    }>;
+    /** Last design HTML for follow-up modifications */
+    previous_design_html?: string;
+    /** Last tool HTML for follow-up modifications */
+    previous_tool_html?: string;
+    /** 'deck' / 'web' / 'component' — narrows follow-up routing */
+    previous_artifact_type?: string;
+    /** File IDs from /v1/files/upload to reference this turn */
+    attachment_ids?: string[];
+}
+export interface TokenEvent {
+    type: 'token';
+    content: string;
+}
+export interface PipelineEvent {
+    type: 'pipeline';
+    step: Record<string, unknown>;
+}
+export interface MetaEvent {
+    type: 'meta';
+    session_id?: string;
+    turn?: number;
+    model?: string;
+}
+export interface DesignEvent {
+    type: 'design';
+    design: Record<string, unknown>;
+    artifact_type?: string;
+}
+export interface DesignChunkEvent {
+    type: 'design_chunk';
+    chunk: string;
+}
+export interface DocumentEvent {
+    type: 'document';
+    document: Record<string, unknown>;
+}
+export interface ProgressEvent {
+    type: 'progress';
+    progress?: Record<string, unknown>;
+}
+export interface ImageEvent {
+    type: 'image';
+    image: unknown;
+}
+export interface VideoEvent {
+    type: 'video';
+    video: unknown;
+}
+export interface AudioEvent {
+    type: 'audio';
+    /** Usually a `data:audio/mpeg;base64,...` URL playable in <audio> */
+    audio: string;
+    voice?: string;
+    model?: string;
+}
+export interface FilesEvent {
+    type: 'files';
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    stack?: string;
+}
+export interface PdfEvent {
+    type: 'pdf';
+    pdf_base64: string;
+    filename: string;
+}
+export interface PptxEvent {
+    type: 'pptx';
+    pptx_base64: string;
+    filename: string;
+    /** 'editable' = native python-pptx, real text boxes; 'visual' = image-based */
+    variant: 'editable' | 'visual';
+}
+export interface PptxVisualEvent {
+    type: 'pptx_visual';
+    pptx_base64: string;
+    filename: string;
+}
+export interface GuardianEvent {
+    type: 'guardian';
+    severity: 'low' | 'medium' | 'high';
+    kinds: string[];
+    content: string;
+}
+export interface AgentHealthEvent {
+    type: 'agent_health';
+    /** One entry per tracked agent: { agent_id, status, last_event_at, ... } */
+    agents: Array<Record<string, unknown>>;
+    /** Aggregate system state: redis_status, phase, etc. */
+    system: Record<string, unknown>;
+    /** Number of open Repair Agent cases at the moment of emission */
+    open_cases: number;
+}
+export interface A2AEvent {
+    type: 'a2a';
+    /** Calling agent (usually 'chat') */
+    from: string;
+    /** Target specialist agent name */
+    to: string;
+    /** The sub-task that was delegated */
+    request: string;
+    /** The specialist's reply */
+    response: string;
+}
+export interface DoneEvent {
+    type: 'done';
+    full_response: string;
+    model_used?: string;
+    pipeline?: Array<Record<string, unknown>>;
+    agents_used?: number;
+    turn?: number;
+    /** Set when the auto-agent fallback fired this turn */
+    auto_agent_spec?: Record<string, unknown>;
+}
+export interface ErrorEvent {
+    type: 'error';
+    message: string;
+    code?: string;
+}
+/** Per-conversation voice override — fired when the user says
+ *  "switch to my Spanish voice" / "use the alloy voice". The dashboard
+ *  mirrors the choice into local storage so the next Talk-to-Nova
+ *  session uses it. */
+export interface VoiceSetEvent {
+    type: 'voice_set';
+    /** Resolved voice name (stock voice or clone display name) */
+    voice: string;
+    /** Clone identifier when the resolved voice is a user clone */
+    clone_id: string | null;
+}
+/** Server-side keep-alive emitted every ~15s of idle time. No-op for callers
+ *  — its purpose is just to keep the TCP connection alive across iOS Safari /
+ *  cellular NAT / corporate proxies that drop idle SSE streams. */
+export interface HeartbeatEvent {
+    type: 'heartbeat';
+}
+export type ChatStreamEvent = TokenEvent | PipelineEvent | MetaEvent | DesignEvent | DesignChunkEvent | DocumentEvent | ProgressEvent | ImageEvent | VideoEvent | AudioEvent | FilesEvent | PdfEvent | PptxEvent | PptxVisualEvent | GuardianEvent | AgentHealthEvent | A2AEvent | VoiceSetEvent | HeartbeatEvent | DoneEvent | ErrorEvent;
+/** Parse a raw SSE payload object into a typed event.
+ *
+ * Unknown event types fall through to a synthetic MetaEvent so callers
+ * don't crash on new server-emitted variants they haven't pulled the
+ * SDK update for. Callers can always check `event.type` in a
+ * `switch (event.type) { ... default: ... }` to handle the unknown case.
+ */
+export declare function parseChatEvent(raw: Record<string, any>): ChatStreamEvent;
+//# sourceMappingURL=chat-stream.d.ts.map

package/dist/types/chat-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-stream.d.ts","sourceRoot":"","sources":["../../src/types/chat-stream.ts"],"names":[],"mappings":"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"}

package/dist/types/chat-stream.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Types for Nova's streaming chat API (POST /v1/chat/stream).
+ *
+ * Server emits a series of SSE events as the chat pipeline progresses.
+ * Token chunks stream first, then artifacts (design HTML, PDF, PPT,
+ * etc.) land as discrete events, then a terminal `done` event closes
+ * the turn. Each event is a discriminated union member keyed on `type`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseChatEvent = parseChatEvent;
+/** Parse a raw SSE payload object into a typed event.
+ *
+ * Unknown event types fall through to a synthetic MetaEvent so callers
+ * don't crash on new server-emitted variants they haven't pulled the
+ * SDK update for. Callers can always check `event.type` in a
+ * `switch (event.type) { ... default: ... }` to handle the unknown case.
+ */
+function parseChatEvent(raw) {
+    const t = (raw.type ?? '');
+    switch (t) {
+        case 'token':
+        case 'pipeline':
+        case 'meta':
+        case 'design':
+        case 'design_chunk':
+        case 'document':
+        case 'progress':
+        case 'image':
+        case 'video':
+        case 'audio':
+        case 'files':
+        case 'pdf':
+        case 'pptx':
+        case 'pptx_visual':
+        case 'guardian':
+        case 'agent_health':
+        case 'a2a':
+        case 'voice_set':
+        case 'heartbeat':
+        case 'done':
+        case 'error':
+            return raw;
+        default:
+            return { type: 'meta', ...raw };
+    }
+}
+//# sourceMappingURL=chat-stream.js.map

package/dist/types/chat-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-stream.js","sourceRoot":"","sources":["../../src/types/chat-stream.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAoMH,wCA4BC;AAnCD;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,GAAwB;IACrD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IACtD,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,OAAO,CAAC;QACb,KAAK,UAAU,CAAC;QAChB,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,cAAc,CAAC;QACpB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,aAAa,CAAC;QACnB,KAAK,UAAU,CAAC;QAChB,KAAK,cAAc,CAAC;QACpB,KAAK,KAAK,CAAC;QACX,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,GAAsB,CAAC;QAChC;YACE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,EAAe,CAAC;IACjD,CAAC;AACH,CAAC"}