@novalabai/adk 2.6.0 → 2.7.0

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

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/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/files.d.ts

@@ -0,0 +1,18 @@
+/** Types for Nova's file-upload API (chat attachments). */
+export interface FileUploadResponse {
+    file_id: string;
+    /** The session this file is bound to (newly created if none was provided) */
+    session_id: string;
+    filename: string;
+    content_type: string;
+    /** Bytes */
+    size: number;
+    /** Backend storage key (null when running on local /tmp fallback) */
+    s3_key?: string | null;
+    /**
+     * First N chars of extracted text — what gets inlined into chat prompts.
+     * Empty for binary types we can't extract from.
+     */
+    extracted_head?: string | null;
+}
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/types/files.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}

package/dist/types/files.js

@@ -0,0 +1,4 @@
+"use strict";
+/** Types for Nova's file-upload API (chat attachments). */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=files.js.map

package/dist/types/files.js.map

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

package/dist/types/planner.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Types for Nova's Planner API.
+ *
+ * The Planner takes a high-level goal, decomposes it into a DAG of agent
+ * steps, and runs each step against the right specialist. Each step's
+ * result lands in `result_summary` (short label) + `result_full` (full
+ * artifact body, e.g. complete deck HTML, document body, image URL).
+ */
+/** Body for POST /v1/planner/plan. */
+export interface PlanCreateRequest {
+    /** Plain-English goal — Nova decomposes it */
+    goal: string;
+    /** When true, the planner pulls user memory snippets to inform decomposition */
+    use_memory?: boolean;
+}
+/** One step in a Plan's DAG. */
+export interface PlanStep {
+    id: string;
+    /** Specialist name — e.g. 'marketing', 'deck_builder' */
+    agent: string;
+    /** The instruction this step runs */
+    action: string;
+    params?: Record<string, unknown>;
+    /** Other step ids that must finish first */
+    depends_on?: string[];
+    requires_approval?: boolean;
+    rationale?: string;
+    /** Status flow: pending → running → succeeded / failed / waiting_approval / skipped */
+    status: string;
+    /**
+     * One-liner label like "Built slide deck (60KB)". Capped at 8000 chars
+     * to keep planner re-prompts small.
+     */
+    result_summary?: string | null;
+    /**
+     * Full artifact body when the step produced one (e.g. complete deck HTML).
+     * Use this to render previews; result_summary stays as the inline label.
+     */
+    result_full?: string | null;
+    model_used?: string | null;
+    duration_ms?: number | null;
+}
+/** A planner-generated DAG plus its execution state. */
+export interface Plan {
+    id: string;
+    goal: string;
+    user_id: string;
+    steps: PlanStep[];
+    created_at: number;
+    /** draft / running / done / failed / cancelled */
+    status: string;
+    version: number;
+    /**
+     * The [ATTACHED FILES] block that was in scope when the plan was created.
+     * Prepended to every step's prompt at execute time so each specialist
+     * sees the uploaded files. Empty when no attachments were in scope.
+     */
+    attachments_context?: string;
+}
+/** Response from GET /v1/planner/plans. */
+export interface PlanList {
+    plans: Plan[];
+}
+/** Response from GET /v1/planner/agents — every specialist the planner can call. */
+export interface AgentList {
+    agents: Array<Record<string, unknown>>;
+}
+//# sourceMappingURL=planner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/types/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,gCAAgC;AAChC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wDAAwD;AACxD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,2CAA2C;AAC3C,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxC"}

package/dist/types/planner.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Types for Nova's Planner API.
+ *
+ * The Planner takes a high-level goal, decomposes it into a DAG of agent
+ * steps, and runs each step against the right specialist. Each step's
+ * result lands in `result_summary` (short label) + `result_full` (full
+ * artifact body, e.g. complete deck HTML, document body, image URL).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=planner.js.map

package/dist/types/planner.js.map

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

package/dist/types/repair.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Types for Nova's Repair Agent API.
+ *
+ * The Repair Agent observes chat-pipeline failures, diagnoses them with
+ * a Sonnet-backed analyzer, proposes unified-diff fixes, and (optionally)
+ * opens an autonomous draft PR via the GitHub REST API.
+ *
+ * Phases:
+ *   R1  narrative diagnosis (Sonnet writes 4-section markdown)
+ *   R2  tool-using diagnosis (read files, grep, recurse)
+ *   R3  unified-diff fix proposal
+ *   R4  autonomous draft PR
+ */
+/** One entry in the recent-cases list. */
+export interface RepairCaseSummary {
+    case_id: string;
+    agent_id?: string | null;
+    task_id?: string | null;
+    error_class?: string | null;
+    error_message?: string | null;
+    created_at: number;
+    status: string;
+    has_diagnosis: boolean;
+    has_fix: boolean;
+}
+/** Response from GET /v1/repair/cases. */
+export interface RepairCaseListResponse {
+    count: number;
+    /** Raw case dicts. Use case.case_id, case.status, case.agent_id, etc. */
+    cases: Array<Record<string, unknown>>;
+}
+/**
+ * Full case detail.
+ *
+ * Backend persists arbitrary fields per phase (R1 adds diagnosis_md,
+ * R3 adds fix_md, R4 adds pr_url, etc.). Common fields surfaced
+ * explicitly; full payload available via `raw`.
+ */
+export interface RepairCase {
+    case_id: string;
+    agent_id?: string | null;
+    task_id?: string | null;
+    error_class?: string | null;
+    error_message?: string | null;
+    traceback_head?: string | null;
+    pipeline_tail?: Array<Record<string, unknown>> | null;
+    diagnosis_md?: string | null;
+    fix_md?: string | null;
+    pr_url?: string | null;
+    status: string;
+    created_at: number;
+    /** Full backend payload (every field the backend persisted). */
+    raw: Record<string, unknown>;
+}
+/** Response from POST /v1/repair/cases/{id}/propose-fix (R3). */
+export interface ProposeFixResponse {
+    case_id: string;
+    /** Markdown-formatted unified diff or fix narrative */
+    fix_md: string;
+    /** True when the agent decided no confident fix exists for this case */
+    no_fix_proposed: boolean;
+}
+/** Response from POST /v1/repair/cases/{id}/apply-fix (R4). */
+export interface ApplyFixResponse {
+    case_id: string;
+    /** True when a draft PR was opened successfully */
+    ok: boolean;
+    /** When ok=false: where the apply path stopped (e.g. 'no_patches', 'gh_failure') */
+    stage?: string | null;
+    /** Human-readable failure reason */
+    reason?: string | null;
+    /** Draft PR URL when ok=true */
+    pr_url?: string | null;
+    /** Branch name the patches landed on */
+    branch?: string | null;
+    /** How many file-level patches landed */
+    patches_applied: number;
+}
+//# sourceMappingURL=repair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/types/repair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,EAAE,EAAE,OAAO,CAAC;IACZ,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/types/repair.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Types for Nova's Repair Agent API.
+ *
+ * The Repair Agent observes chat-pipeline failures, diagnoses them with
+ * a Sonnet-backed analyzer, proposes unified-diff fixes, and (optionally)
+ * opens an autonomous draft PR via the GitHub REST API.
+ *
+ * Phases:
+ *   R1  narrative diagnosis (Sonnet writes 4-section markdown)
+ *   R2  tool-using diagnosis (read files, grep, recurse)
+ *   R3  unified-diff fix proposal
+ *   R4  autonomous draft PR
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=repair.js.map

package/dist/types/repair.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novalabai/adk",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "NovaLab Agent Development Kit — Build, test, and deploy Nova AI agents with multi-agent orchestration, smart model routing, trust layer, and confidence scoring",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",