@novalabai/adk 2.6.0 → 2.8.1

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/dist/types/voice.d.ts

@@ -0,0 +1,16 @@
+/** Types for Nova's voice API (V1 — speech-to-text). */
+export interface TranscribeResponse {
+    /** Transcribed text. Empty when error is non-null. */
+    text: string;
+    /** Server-side transcription duration in ms */
+    duration_ms: number;
+    /** Whisper model that handled the request, e.g. 'whisper-1' */
+    model_used: string;
+    /**
+     * Set when transcription failed: 'no_api_key', 'audio_empty',
+     * 'audio_too_large', 'http_<status>', or an exception class name.
+     * When error is set, text is empty — surface this to the user.
+     */
+    error: string | null;
+}
+//# sourceMappingURL=voice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/types/voice.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}

package/dist/types/voice.js

@@ -0,0 +1,4 @@
+"use strict";
+/** Types for Nova's voice API (V1 — speech-to-text). */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=voice.js.map

package/dist/types/voice.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novalabai/adk",
-  "version": "2.6.0",
+  "version": "2.8.1",
   "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",