@novalabai/adk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NovaLab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# @novalabai/adk
+
+The official **TypeScript Agent Development Kit** for the [NovaLab](https://novalab.build) AI orchestration platform.
+
+Build, test, and deploy autonomous AI agents with smart model routing, enterprise-grade trust scoring, confidence layers, and full auditability.
+
+## Installation
+
+```bash
+npm install @novalabai/adk
+```
+
+## Quick Start
+
+```typescript
+import { NovaClient } from '@novalabai/adk';
+
+const nova = new NovaClient({
+  apiKey: process.env.NOVA_API_KEY!,
+  region: 'eu-west-1',           // optional, defaults to eu-west-1
+  baseUrl: 'http://localhost:4300/v1', // optional, for local dev
+});
+
+// Create an agent
+const agent = await nova.agents.create({
+  name: 'my-assistant',
+  description: 'A helpful coding assistant',
+  model: 'auto',
+  systemPrompt: 'You are a helpful assistant.',
+  temperature: 0.7,
+  maxTokens: 2048,
+});
+
+// Deploy it
+await nova.agents.deploy(agent.agentId);
+
+// Run a task
+const result = await nova.agents.run(agent.agentId, {
+  task: 'Explain the security risks of storing JWT tokens in localStorage',
+});
+
+console.log(result.output);         // AI response
+console.log(result.confidence);     // 0-100 confidence score
+console.log(result.trust);          // Trust evaluation (accuracy, safety, relevance, completeness)
+console.log(result.autonomyLevel);  // AUTONOMOUS | NOTIFY | APPROVAL_REQUIRED | BLOCKED
+```
+
+## Features
+
+- **Smart Model Routing** — Auto-routes tasks to the best model (Claude for analytical, Gemini for creative)
+- **Trust Layer** — Claude evaluates any model's output for accuracy, safety, relevance, and completeness
+- **Confidence Scoring** — Blended pipeline + trust scores with autonomy level determination
+- **Agent Lifecycle** — Create, deploy, run, pause, and manage AI agents
+- **Workflow Pipelines** — Multi-step agent workflows with confidence gates
+- **Signal Monitoring** — Real-time telemetry ingestion with anomaly detection
+- **Automations** — Rule-based triggers and scheduled actions
+- **Connections Hub** — Third-party integrations (Slack, GitHub, Jira, etc.)
+- **Audit History** — Full decision trail with trust data and explanations
+- **Webhook Verification** — HMAC-SHA256 payload signing and verification
+- **Streaming** — Server-Sent Events for real-time agent output
+- **Full TypeScript** — Complete type definitions with strict mode
+
+## API Resources
+
+```typescript
+const nova = new NovaClient({ apiKey: '...' });
+
+nova.agents          // Create, deploy, run, and manage AI agents
+nova.trust           // Evaluate any AI output for trust and safety
+nova.workflows       // Build and execute multi-step pipelines
+nova.signals         // Ingest and stream real-time telemetry
+nova.automations     // Manage rule-based automations
+nova.connections     // Third-party integrations
+nova.data            // Upload and query datasets
+nova.history         // Audit trail and decision replay
+nova.webhooks        // Event subscriptions
+```
+
+## Trust Evaluation
+
+Evaluate any AI output independently:
+
+```typescript
+const result = await nova.trust.evaluate({
+  input: 'What is the capital of France?',
+  output: 'The capital of France is Paris.',
+  model: 'gpt-4',
+});
+
+console.log(result.trust.overallScore);    // 97
+console.log(result.trust.trustLevel);      // "high"
+console.log(result.trust.accuracyScore);   // 100
+console.log(result.trust.safetyScore);     // 95
+console.log(result.trust.concerns);        // []
+```
+
+## Webhook Verification
+
+```typescript
+import { verifyWebhookSignature } from '@novalabai/adk';
+
+const isValid = await verifyWebhookSignature(
+  rawBody,
+  signatureHeader,
+  webhookSecret,
+);
+```
+
+## Streaming
+
+```typescript
+const stream = await nova.agents.run(agentId, {
+  task: 'Write a story',
+  stream: true,
+});
+
+for await (const chunk of stream) {
+  process.stdout.write(chunk.text);
+}
+```
+
+## Requirements
+
+- Node.js >= 18
+- A NovaLab API key ([get one at novalab.build](https://novalab.build))
+
+## License
+
+[MIT](./LICENSE)

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import { AgentsResource } from './resources/agents.js';
+import { WorkflowsResource } from './resources/workflows.js';
+import { SignalsResource } from './resources/signals.js';
+import { AutomationsResource } from './resources/automations.js';
+import { ConnectionsResource } from './resources/connections.js';
+import { DataResource } from './resources/data.js';
+import { HistoryResource } from './resources/history.js';
+import { TrustResource } from './resources/trust.js';
+import { WebhooksResource } from './resources/webhooks.js';
+export interface NovaClientOptions {
+    apiKey: string;
+    region?: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+export declare class NovaClient {
+    readonly agents: AgentsResource;
+    readonly workflows: WorkflowsResource;
+    readonly signals: SignalsResource;
+    readonly automations: AutomationsResource;
+    readonly connections: ConnectionsResource;
+    readonly data: DataResource;
+    readonly history: HistoryResource;
+    readonly trust: TrustResource;
+    readonly webhooks: WebhooksResource;
+    private readonly http;
+    constructor(options: NovaClientOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,UAAU;IACrB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,OAAO,EAAE,iBAAiB;CAqBvC"}

package/dist/client.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NovaClient = void 0;
+const http_js_1 = require("./core/http.js");
+const agents_js_1 = require("./resources/agents.js");
+const workflows_js_1 = require("./resources/workflows.js");
+const signals_js_1 = require("./resources/signals.js");
+const automations_js_1 = require("./resources/automations.js");
+const connections_js_1 = require("./resources/connections.js");
+const data_js_1 = require("./resources/data.js");
+const history_js_1 = require("./resources/history.js");
+const trust_js_1 = require("./resources/trust.js");
+const webhooks_js_1 = require("./resources/webhooks.js");
+const DEFAULT_REGION = 'eu-west-1';
+class NovaClient {
+    agents;
+    workflows;
+    signals;
+    automations;
+    connections;
+    data;
+    history;
+    trust;
+    webhooks;
+    http;
+    constructor(options) {
+        const region = options.region ?? DEFAULT_REGION;
+        const baseURL = options.baseUrl ?? `https://${region}.api.novalab.build/v1`;
+        this.http = new http_js_1.HttpClient({
+            baseURL,
+            apiKey: options.apiKey,
+            region,
+            timeout: options.timeout,
+        });
+        this.agents = new agents_js_1.AgentsResource(this.http);
+        this.workflows = new workflows_js_1.WorkflowsResource(this.http);
+        this.signals = new signals_js_1.SignalsResource(this.http);
+        this.automations = new automations_js_1.AutomationsResource(this.http);
+        this.connections = new connections_js_1.ConnectionsResource(this.http);
+        this.data = new data_js_1.DataResource(this.http);
+        this.history = new history_js_1.HistoryResource(this.http);
+        this.trust = new trust_js_1.TrustResource(this.http);
+        this.webhooks = new webhooks_js_1.WebhooksResource(this.http);
+    }
+}
+exports.NovaClient = NovaClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,4CAA4C;AAC5C,qDAAuD;AACvD,2DAA6D;AAC7D,uDAAyD;AACzD,+DAAiE;AACjE,+DAAiE;AACjE,iDAAmD;AACnD,uDAAyD;AACzD,mDAAqD;AACrD,yDAA2D;AAS3D,MAAM,cAAc,GAAG,WAAW,CAAC;AAEnC,MAAa,UAAU;IACZ,MAAM,CAAiB;IACvB,SAAS,CAAoB;IAC7B,OAAO,CAAkB;IACzB,WAAW,CAAsB;IACjC,WAAW,CAAsB;IACjC,IAAI,CAAe;IACnB,OAAO,CAAkB;IACzB,KAAK,CAAgB;IACrB,QAAQ,CAAmB;IAEnB,IAAI,CAAa;IAElC,YAAY,OAA0B;QACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;QAChD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,WAAW,MAAM,uBAAuB,CAAC;QAE5E,IAAI,CAAC,IAAI,GAAG,IAAI,oBAAU,CAAC;YACzB,OAAO;YACP,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,IAAI,0BAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,gCAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,GAAG,IAAI,4BAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,IAAI,oCAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,GAAG,IAAI,oCAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,IAAI,sBAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,4BAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,wBAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,8BAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;CACF;AAlCD,gCAkCC"}

package/dist/core/confidence.d.ts

@@ -0,0 +1,32 @@
+export declare enum ConfidenceLevel {
+    AUTONOMOUS = "AUTONOMOUS",
+    NOTIFY = "NOTIFY",
+    APPROVAL_REQUIRED = "APPROVAL_REQUIRED",
+    BLOCKED = "BLOCKED"
+}
+export interface ConfidenceThresholds {
+    autonomous: number;
+    notify: number;
+    approvalRequired: number;
+}
+/** Evaluate a confidence score (0-100) against thresholds and return the corresponding level. */
+export declare function evaluateConfidence(score: number, thresholds?: ConfidenceThresholds): ConfidenceLevel;
+export declare class ConfidenceGate {
+    private readonly thresholds;
+    private readonly blockBelowApproval;
+    constructor(options?: {
+        thresholds?: Partial<ConfidenceThresholds>;
+        blockBelowApproval?: boolean;
+    });
+    /** Evaluate and return the confidence level. */
+    evaluate(score: number): ConfidenceLevel;
+    /** Check if the score passes the gate. Throws NovaConfidenceError if blocked. */
+    enforce(score: number): ConfidenceLevel;
+    /** Return true if the score allows autonomous execution. */
+    isAutonomous(score: number): boolean;
+    /** Return true if the score requires human approval. */
+    requiresApproval(score: number): boolean;
+    /** Return the current thresholds. */
+    getThresholds(): Readonly<ConfidenceThresholds>;
+}
+//# sourceMappingURL=confidence.d.ts.map

package/dist/core/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../src/core/confidence.ts"],"names":[],"mappings":"AAEA,oBAAY,eAAe;IACzB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,iBAAiB,sBAAsB;IACvC,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAQD,iGAAiG;AACjG,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,oBAAyC,GACpD,eAAe,CASjB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;gBAEjC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE;IAKlG,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAIxC,iFAAiF;IACjF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAavC,4DAA4D;IAC5D,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIpC,wDAAwD;IACxD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKxC,qCAAqC;IACrC,aAAa,IAAI,QAAQ,CAAC,oBAAoB,CAAC;CAGhD"}

package/dist/core/confidence.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfidenceGate = exports.ConfidenceLevel = void 0;
+exports.evaluateConfidence = evaluateConfidence;
+const errors_js_1 = require("./errors.js");
+var ConfidenceLevel;
+(function (ConfidenceLevel) {
+    ConfidenceLevel["AUTONOMOUS"] = "AUTONOMOUS";
+    ConfidenceLevel["NOTIFY"] = "NOTIFY";
+    ConfidenceLevel["APPROVAL_REQUIRED"] = "APPROVAL_REQUIRED";
+    ConfidenceLevel["BLOCKED"] = "BLOCKED";
+})(ConfidenceLevel || (exports.ConfidenceLevel = ConfidenceLevel = {}));
+const DEFAULT_THRESHOLDS = {
+    autonomous: 90,
+    notify: 70,
+    approvalRequired: 50,
+};
+/** Evaluate a confidence score (0-100) against thresholds and return the corresponding level. */
+function evaluateConfidence(score, thresholds = DEFAULT_THRESHOLDS) {
+    if (score < 0 || score > 100) {
+        throw new errors_js_1.NovaConfidenceError(score, 'Confidence score must be between 0 and 100');
+    }
+    if (score >= thresholds.autonomous)
+        return ConfidenceLevel.AUTONOMOUS;
+    if (score >= thresholds.notify)
+        return ConfidenceLevel.NOTIFY;
+    if (score >= thresholds.approvalRequired)
+        return ConfidenceLevel.APPROVAL_REQUIRED;
+    return ConfidenceLevel.BLOCKED;
+}
+class ConfidenceGate {
+    thresholds;
+    blockBelowApproval;
+    constructor(options) {
+        this.thresholds = { ...DEFAULT_THRESHOLDS, ...options?.thresholds };
+        this.blockBelowApproval = options?.blockBelowApproval ?? true;
+    }
+    /** Evaluate and return the confidence level. */
+    evaluate(score) {
+        return evaluateConfidence(score, this.thresholds);
+    }
+    /** Check if the score passes the gate. Throws NovaConfidenceError if blocked. */
+    enforce(score) {
+        const level = this.evaluate(score);
+        if (level === ConfidenceLevel.BLOCKED && this.blockBelowApproval) {
+            throw new errors_js_1.NovaConfidenceError(score, `Confidence score ${score} is blocked (below ${this.thresholds.approvalRequired})`);
+        }
+        return level;
+    }
+    /** Return true if the score allows autonomous execution. */
+    isAutonomous(score) {
+        return this.evaluate(score) === ConfidenceLevel.AUTONOMOUS;
+    }
+    /** Return true if the score requires human approval. */
+    requiresApproval(score) {
+        const level = this.evaluate(score);
+        return level === ConfidenceLevel.APPROVAL_REQUIRED || level === ConfidenceLevel.BLOCKED;
+    }
+    /** Return the current thresholds. */
+    getThresholds() {
+        return { ...this.thresholds };
+    }
+}
+exports.ConfidenceGate = ConfidenceGate;
+//# sourceMappingURL=confidence.js.map

package/dist/core/confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../src/core/confidence.ts"],"names":[],"mappings":";;;AAsBA,gDAYC;AAlCD,2CAAkD;AAElD,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,4CAAyB,CAAA;IACzB,oCAAiB,CAAA;IACjB,0DAAuC,CAAA;IACvC,sCAAmB,CAAA;AACrB,CAAC,EALW,eAAe,+BAAf,eAAe,QAK1B;AAQD,MAAM,kBAAkB,GAAyB;IAC/C,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,gBAAgB,EAAE,EAAE;CACrB,CAAC;AAEF,iGAAiG;AACjG,SAAgB,kBAAkB,CAChC,KAAa,EACb,aAAmC,kBAAkB;IAErD,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAC7B,MAAM,IAAI,+BAAmB,CAAC,KAAK,EAAE,4CAA4C,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,KAAK,IAAI,UAAU,CAAC,UAAU;QAAE,OAAO,eAAe,CAAC,UAAU,CAAC;IACtE,IAAI,KAAK,IAAI,UAAU,CAAC,MAAM;QAAE,OAAO,eAAe,CAAC,MAAM,CAAC;IAC9D,IAAI,KAAK,IAAI,UAAU,CAAC,gBAAgB;QAAE,OAAO,eAAe,CAAC,iBAAiB,CAAC;IACnF,OAAO,eAAe,CAAC,OAAO,CAAC;AACjC,CAAC;AAED,MAAa,cAAc;IACR,UAAU,CAAuB;IACjC,kBAAkB,CAAU;IAE7C,YAAY,OAAsF;QAChG,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,kBAAkB,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAC;QACpE,IAAI,CAAC,kBAAkB,GAAG,OAAO,EAAE,kBAAkB,IAAI,IAAI,CAAC;IAChE,CAAC;IAED,gDAAgD;IAChD,QAAQ,CAAC,KAAa;QACpB,OAAO,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,iFAAiF;IACjF,OAAO,CAAC,KAAa;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,KAAK,KAAK,eAAe,CAAC,OAAO,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACjE,MAAM,IAAI,+BAAmB,CAC3B,KAAK,EACL,oBAAoB,KAAK,sBAAsB,IAAI,CAAC,UAAU,CAAC,gBAAgB,GAAG,CACnF,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4DAA4D;IAC5D,YAAY,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,eAAe,CAAC,UAAU,CAAC;IAC7D,CAAC;IAED,wDAAwD;IACxD,gBAAgB,CAAC,KAAa;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,KAAK,KAAK,eAAe,CAAC,iBAAiB,IAAI,KAAK,KAAK,eAAe,CAAC,OAAO,CAAC;IAC1F,CAAC;IAED,qCAAqC;IACrC,aAAa;QACX,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;CACF;AA3CD,wCA2CC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,27 @@
+export declare class NovaError extends Error {
+    constructor(message: string);
+}
+export declare class NovaAPIError extends NovaError {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId: string | undefined;
+    constructor(status: number, code: string, message: string, requestId?: string);
+}
+export declare class NovaAuthError extends NovaAPIError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class NovaRateLimitError extends NovaAPIError {
+    readonly retryAfter: number;
+    constructor(retryAfter: number, message?: string, requestId?: string);
+}
+export declare class NovaValidationError extends NovaError {
+    constructor(message: string);
+}
+export declare class NovaTimeoutError extends NovaError {
+    constructor(message?: string);
+}
+export declare class NovaConfidenceError extends NovaError {
+    readonly confidence: number;
+    constructor(confidence: number, message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAO9E;AAED,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,GAAE,MAAgC,EAAE,SAAS,CAAC,EAAE,MAAM;CAI1E;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,MAA8B,EAAE,SAAS,CAAC,EAAE,MAAM;CAK5F;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,OAAO,GAAE,MAA4B;CAIlD;AAED,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAKjD"}

package/dist/core/errors.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NovaConfidenceError = exports.NovaTimeoutError = exports.NovaValidationError = exports.NovaRateLimitError = exports.NovaAuthError = exports.NovaAPIError = exports.NovaError = void 0;
+class NovaError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NovaError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.NovaError = NovaError;
+class NovaAPIError extends NovaError {
+    status;
+    code;
+    requestId;
+    constructor(status, code, message, requestId) {
+        super(message);
+        this.name = 'NovaAPIError';
+        this.status = status;
+        this.code = code;
+        this.requestId = requestId;
+    }
+}
+exports.NovaAPIError = NovaAPIError;
+class NovaAuthError extends NovaAPIError {
+    constructor(message = 'Authentication failed', requestId) {
+        super(401, 'auth_error', message, requestId);
+        this.name = 'NovaAuthError';
+    }
+}
+exports.NovaAuthError = NovaAuthError;
+class NovaRateLimitError extends NovaAPIError {
+    retryAfter;
+    constructor(retryAfter, message = 'Rate limit exceeded', requestId) {
+        super(429, 'rate_limit_exceeded', message, requestId);
+        this.name = 'NovaRateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+exports.NovaRateLimitError = NovaRateLimitError;
+class NovaValidationError extends NovaError {
+    constructor(message) {
+        super(message);
+        this.name = 'NovaValidationError';
+    }
+}
+exports.NovaValidationError = NovaValidationError;
+class NovaTimeoutError extends NovaError {
+    constructor(message = 'Request timed out') {
+        super(message);
+        this.name = 'NovaTimeoutError';
+    }
+}
+exports.NovaTimeoutError = NovaTimeoutError;
+class NovaConfidenceError extends NovaError {
+    confidence;
+    constructor(confidence, message) {
+        super(message ?? `Confidence score ${confidence} is below the required threshold`);
+        this.name = 'NovaConfidenceError';
+        this.confidence = confidence;
+    }
+}
+exports.NovaConfidenceError = NovaConfidenceError;
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,8BAMC;AAED,MAAa,YAAa,SAAQ,SAAS;IAChC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,SAAS,CAAqB;IAEvC,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe,EAAE,SAAkB;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAZD,oCAYC;AAED,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,UAAkB,uBAAuB,EAAE,SAAkB;QACvE,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,MAAa,kBAAmB,SAAQ,YAAY;IACzC,UAAU,CAAS;IAE5B,YAAY,UAAkB,EAAE,UAAkB,qBAAqB,EAAE,SAAkB;QACzF,KAAK,CAAC,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AARD,gDAQC;AAED,MAAa,mBAAoB,SAAQ,SAAS;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,MAAa,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,UAAkB,mBAAmB;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED,MAAa,mBAAoB,SAAQ,SAAS;IACvC,UAAU,CAAS;IAE5B,YAAY,UAAkB,EAAE,OAAgB;QAC9C,KAAK,CAAC,OAAO,IAAI,oBAAoB,UAAU,kCAAkC,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AARD,kDAQC"}

package/dist/core/http.d.ts

@@ -0,0 +1,45 @@
+export type RequestInterceptor = (config: RequestConfig) => RequestConfig | Promise<RequestConfig>;
+export type ResponseInterceptor = (response: HttpResponse<unknown>) => HttpResponse<unknown> | Promise<HttpResponse<unknown>>;
+export interface HttpClientOptions {
+    baseURL: string;
+    apiKey: string;
+    region: string;
+    timeout?: number;
+}
+export interface RequestConfig {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: string | Buffer;
+    timeout: number;
+}
+export interface HttpResponse<T> {
+    status: number;
+    headers: Record<string, string>;
+    data: T;
+    requestId: string;
+}
+export declare class HttpClient {
+    private readonly baseURL;
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly requestInterceptors;
+    private readonly responseInterceptors;
+    constructor(options: HttpClientOptions);
+    /** Register a request interceptor. */
+    onRequest(interceptor: RequestInterceptor): void;
+    /** Register a response interceptor. */
+    onResponse(interceptor: ResponseInterceptor): void;
+    get<T>(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    delete<T = void>(path: string): Promise<T>;
+    /** Return the raw fetch Response (used for SSE streaming). */
+    stream(path: string, body?: unknown): Promise<Response>;
+    private buildURL;
+    private request;
+    private handleErrorResponse;
+    private buildErrorFromResponse;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/core/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AACnG,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAE9H,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;gBAEtD,OAAO,EAAE,iBAAiB;IAMtC,sCAAsC;IACtC,SAAS,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAIhD,uCAAuC;IACvC,UAAU,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAI5C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/F,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAKlD,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhD,8DAA8D;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IA+C7D,OAAO,CAAC,QAAQ;YAgBF,OAAO;YAqFP,mBAAmB;YAInB,sBAAsB;CAsBrC"}