novyx 2.10.0 → 2.12.0

package/dist/index.mjs

@@ -76,6 +76,8 @@ var Novyx = class {
     this.apiUrl = (config.apiUrl ?? "https://novyx-ram-api.fly.dev").replace(/\/+$/, "");
     this.timeout = config.timeout ?? 30;
     this.agentId = config.agentId;
+    this.controlUrl = config.controlUrl?.replace(/\/+$/, "");
+    this.controlApiKey = config.controlApiKey;
     this._validateKey();
   }
   _validateKey() {
@@ -513,6 +515,364 @@ var Novyx = class {
       params: { limit: opts?.limit ?? 20, offset: opts?.offset ?? 0 }
     });
   }
+  // ========================================================================
+  // Drafts & Branches
+  // ========================================================================
+  async draftMemory(observation, opts) {
+    const body = { observation };
+    if (opts?.tags) body.tags = opts.tags;
+    if (opts?.context) body.context = opts.context;
+    if (opts?.importance !== void 0) body.importance = opts.importance;
+    if (opts?.confidence !== void 0) body.confidence = opts.confidence;
+    if (opts?.agent_id) body.agent_id = opts.agent_id;
+    if (opts?.space_id) body.space_id = opts.space_id;
+    if (opts?.branch_name) body.branch_name = opts.branch_name;
+    return this._request("POST", "/v1/memory-drafts", { body });
+  }
+  async memoryDrafts(opts) {
+    const params = {
+      limit: opts?.limit ?? 50,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.status) params.status = opts.status;
+    if (opts?.branch_name) params.branch_name = opts.branch_name;
+    return this._request("GET", "/v1/memory-drafts", { params });
+  }
+  async memoryDraft(draftId) {
+    return this._request("GET", `/v1/memory-drafts/${draftId}`);
+  }
+  async draftDiff(draftId) {
+    return this._request("GET", `/v1/memory-drafts/${draftId}/diff`);
+  }
+  async mergeDraft(draftId) {
+    return this._request("POST", `/v1/memory-drafts/${draftId}/merge`);
+  }
+  async rejectDraft(draftId, reason) {
+    const body = {};
+    if (reason) body.reason = reason;
+    return this._request("POST", `/v1/memory-drafts/${draftId}/reject`, { body });
+  }
+  async memoryBranches() {
+    return this._request("GET", "/v1/memory-drafts/branches");
+  }
+  async mergeBranch(branchName) {
+    return this._request("POST", `/v1/memory-drafts/branches/${branchName}/merge`);
+  }
+  async rejectBranch(branchName, reason) {
+    const body = {};
+    if (reason) body.reason = reason;
+    return this._request("POST", `/v1/memory-drafts/branches/${branchName}/reject`, { body });
+  }
+  // ========================================================================
+  // Context Spaces
+  // ========================================================================
+  async createSpace(name, opts) {
+    const body = { name };
+    if (opts?.description) body.description = opts.description;
+    if (opts?.allowed_agent_ids) body.allowed_agent_ids = opts.allowed_agent_ids;
+    if (opts?.allowed_tenant_ids) body.allowed_tenant_ids = opts.allowed_tenant_ids;
+    if (opts?.tags) body.tags = opts.tags;
+    return this._request("POST", "/v1/context-spaces", { body });
+  }
+  async listSpaces(opts) {
+    return this._request("GET", "/v1/context-spaces", {
+      params: { limit: opts?.limit ?? 50, offset: opts?.offset ?? 0 }
+    });
+  }
+  async getSpace(spaceId) {
+    return this._request("GET", `/v1/context-spaces/${spaceId}`);
+  }
+  async updateSpace(spaceId, updates) {
+    return this._request("PUT", `/v1/context-spaces/${spaceId}`, { body: updates });
+  }
+  async deleteSpace(spaceId) {
+    return this._request("DELETE", `/v1/context-spaces/${spaceId}`);
+  }
+  async spaceMemories(spaceId, opts) {
+    const result = await this._request("GET", `/v1/context-spaces/${spaceId}/memories`, {
+      params: { limit: opts?.limit ?? 100, offset: opts?.offset ?? 0 }
+    });
+    return result.memories ?? result;
+  }
+  // ========================================================================
+  // Eval
+  // ========================================================================
+  async evalRun(opts) {
+    const body = {};
+    if (opts?.min_score !== void 0) body.min_score = opts.min_score;
+    return this._request("POST", "/v1/eval/run", { body });
+  }
+  async evalGate(minScore) {
+    return this._request("POST", "/v1/eval/gate", {
+      body: { min_score: minScore }
+    });
+  }
+  async evalHistory(opts) {
+    return this._request("GET", "/v1/eval/history", {
+      params: { limit: opts?.limit ?? 50, offset: opts?.offset ?? 0 }
+    });
+  }
+  async evalDrift(days = 7) {
+    return this._request("GET", "/v1/eval/drift", { params: { days } });
+  }
+  async evalBaselineCreate(query, expectedObservation) {
+    return this._request("POST", "/v1/eval/baselines", {
+      body: { query, expected_observation: expectedObservation }
+    });
+  }
+  async evalBaselines() {
+    return this._request("GET", "/v1/eval/baselines");
+  }
+  async evalBaselineDelete(baselineId) {
+    return this._request("DELETE", `/v1/eval/baselines/${baselineId}`);
+  }
+  // ========================================================================
+  // Approvals
+  // ========================================================================
+  async listApprovals(opts) {
+    const params = { limit: opts?.limit ?? 50 };
+    if (opts?.status_filter) params.status_filter = opts.status_filter;
+    return this._request("GET", "/v1/approvals", { params });
+  }
+  async approveAction(approvalId, opts) {
+    const params = { decision: opts?.decision ?? "approve" };
+    if (opts?.reason) params.reason = opts.reason;
+    if (opts?.approver_id) params.approver_id = opts.approver_id;
+    return this._request("POST", `/v1/approvals/${approvalId}/decision`, { params });
+  }
+  async listPolicies() {
+    return this._request("GET", "/v1/control/policies");
+  }
+  // ========================================================================
+  // Explain Action
+  // ========================================================================
+  async explainAction(actionId) {
+    return this._request("GET", `/v1/actions/${actionId}/explain`);
+  }
+  // ========================================================================
+  // Streams
+  // ========================================================================
+  async streamStatus() {
+    return this._request("GET", "/v1/streams/status");
+  }
+  // ========================================================================
+  // Memory Health
+  // ========================================================================
+  async memoryHealth() {
+    return this._request("GET", "/v1/memories/stats");
+  }
+  // =========================================================================
+  // Control — Governed agent actions (requires controlUrl)
+  // =========================================================================
+  async _controlRequest(method, endpoint, opts) {
+    if (!this.controlUrl) {
+      throw new NovyxError("Control not configured. Pass controlUrl to Novyx().");
+    }
+    const url = new URL(`${this.controlUrl}${endpoint}`);
+    if (opts?.params) {
+      for (const [k, v] of Object.entries(opts.params)) {
+        if (v !== void 0 && v !== null) url.searchParams.set(k, String(v));
+      }
+    }
+    const headers = {
+      "Authorization": `Bearer ${this.controlApiKey || ""}`
+    };
+    if (opts?.body) headers["Content-Type"] = "application/json";
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout * 1e3);
+    try {
+      const res = await fetch(url.toString(), {
+        method,
+        headers,
+        body: opts?.body ? JSON.stringify(opts.body) : void 0,
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new NovyxError(`Control API error ${res.status}: ${text}`);
+      }
+      return await res.json();
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  /** Submit an action to Novyx Control for governed execution. */
+  async actionSubmit(connector, operation, payload) {
+    return this._controlRequest("POST", `/v1/actions/${connector}/${operation}`, { body: payload });
+  }
+  /** Get the status of a Control action. */
+  async actionStatus(actionId) {
+    return this._controlRequest("GET", `/v1/actions/${actionId}`);
+  }
+  /** List recent Control actions. */
+  async actionList(opts) {
+    return this._controlRequest("GET", "/v1/actions", { params: opts });
+  }
+  /** Check the current Control policy profile. */
+  async policyCheck() {
+    return this._controlRequest("GET", "/v1/control/policies");
+  }
+  // ========================================================================
+  // Agents (Runtime v2)
+  // ========================================================================
+  async createAgent(params) {
+    const body = {
+      name: params.name,
+      model: params.model ?? "gpt-4o-mini",
+      provider: params.provider ?? "openai"
+    };
+    if (params.agent_id) body.agent_id = params.agent_id;
+    if (params.description) body.description = params.description;
+    if (params.instructions) body.instructions = params.instructions;
+    if (params.capabilities) body.capabilities = params.capabilities;
+    if (params.memory_scope) body.memory_scope = params.memory_scope;
+    if (params.policy_profile) body.policy_profile = params.policy_profile;
+    if (params.config) body.config = params.config;
+    return this._request("POST", "/v1/agents", { body });
+  }
+  async getAgent(agentId) {
+    return this._request("GET", `/v1/agents/${agentId}`);
+  }
+  async listAgents(opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.status) params.status = opts.status;
+    return this._request("GET", "/v1/agents", { params });
+  }
+  async updateAgent(agentId, updates) {
+    return this._request("PATCH", `/v1/agents/${agentId}`, { body: updates });
+  }
+  async deleteAgent(agentId) {
+    return this._request("DELETE", `/v1/agents/${agentId}`);
+  }
+  // ========================================================================
+  // Missions (Runtime v2)
+  // ========================================================================
+  async createMission(params) {
+    const body = {
+      agent_id: params.agent_id,
+      goal: params.goal
+    };
+    if (params.constraints !== void 0) body.constraints = params.constraints;
+    if (params.success_criteria !== void 0) body.success_criteria = params.success_criteria;
+    if (params.allowed_capabilities !== void 0) body.allowed_capabilities = params.allowed_capabilities;
+    if (params.escalation_rules !== void 0) body.escalation_rules = params.escalation_rules;
+    if (params.stop_conditions !== void 0) body.stop_conditions = params.stop_conditions;
+    if (params.config !== void 0) body.config = params.config;
+    return this._request("POST", "/v1/missions", { body });
+  }
+  async getMission(missionId) {
+    return this._request("GET", `/v1/missions/${missionId}`);
+  }
+  async listMissions(opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.agent_id) params.agent_id = opts.agent_id;
+    if (opts?.status) params.status = opts.status;
+    return this._request("GET", "/v1/missions", { params });
+  }
+  async updateMission(missionId, updates) {
+    return this._request("PATCH", `/v1/missions/${missionId}`, { body: updates });
+  }
+  async deleteMission(missionId) {
+    return this._request("DELETE", `/v1/missions/${missionId}`);
+  }
+  async pauseMission(missionId) {
+    return this._request("POST", `/v1/missions/${missionId}/pause`);
+  }
+  async resumeMission(missionId) {
+    return this._request("POST", `/v1/missions/${missionId}/resume`);
+  }
+  async cancelMission(missionId) {
+    return this._request("POST", `/v1/missions/${missionId}/cancel`);
+  }
+  // ========================================================================
+  // Capabilities (Runtime v2)
+  // ========================================================================
+  async createCapability(params) {
+    const body = { name: params.name };
+    if (params.capability_id !== void 0) body.capability_id = params.capability_id;
+    if (params.description !== void 0) body.description = params.description;
+    if (params.tools !== void 0) body.tools = params.tools;
+    if (params.risk_levels !== void 0) body.risk_levels = params.risk_levels;
+    if (params.approval_requirements !== void 0) body.approval_requirements = params.approval_requirements;
+    if (params.memory_behavior !== void 0) body.memory_behavior = params.memory_behavior;
+    if (params.eval_rules !== void 0) body.eval_rules = params.eval_rules;
+    if (params.config !== void 0) body.config = params.config;
+    return this._request("POST", "/v1/capabilities", { body });
+  }
+  async getCapability(capabilityId) {
+    return this._request("GET", `/v1/capabilities/${capabilityId}`);
+  }
+  async listCapabilities(opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.status) params.status = opts.status;
+    return this._request("GET", "/v1/capabilities", { params });
+  }
+  async updateCapability(capabilityId, updates) {
+    return this._request("PATCH", `/v1/capabilities/${capabilityId}`, { body: updates });
+  }
+  async deleteCapability(capabilityId) {
+    return this._request("DELETE", `/v1/capabilities/${capabilityId}`);
+  }
+  // ========================================================================
+  // Checkpoints (Runtime v2)
+  // ========================================================================
+  async createCheckpoint(missionId, opts) {
+    const body = {};
+    if (opts?.label !== void 0) body.label = opts.label;
+    if (opts?.metadata !== void 0) body.metadata = opts.metadata;
+    return this._request("POST", `/v1/missions/${missionId}/checkpoints`, { body });
+  }
+  async getCheckpoint(checkpointId) {
+    return this._request("GET", `/v1/checkpoints/${checkpointId}`);
+  }
+  async listCheckpoints(missionId, opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    return this._request("GET", `/v1/missions/${missionId}/checkpoints`, { params });
+  }
+  async rollbackToCheckpoint(missionId, checkpointId, opts) {
+    const body = { checkpoint_id: checkpointId };
+    if (opts?.reason !== void 0) body.reason = opts.reason;
+    return this._request("POST", `/v1/missions/${missionId}/rollback`, { body });
+  }
+  // ========================================================================
+  // Interventions (Runtime v2)
+  // ========================================================================
+  async createIntervention(params) {
+    const body = {
+      intervention_type: params.intervention_type
+    };
+    if (params.mission_id !== void 0) body.mission_id = params.mission_id;
+    if (params.action_id !== void 0) body.action_id = params.action_id;
+    if (params.agent_id !== void 0) body.agent_id = params.agent_id;
+    if (params.rationale !== void 0) body.rationale = params.rationale;
+    if (params.metadata !== void 0) body.metadata = params.metadata;
+    return this._request("POST", "/v1/interventions", { body });
+  }
+  async getIntervention(interventionId) {
+    return this._request("GET", `/v1/interventions/${interventionId}`);
+  }
+  async listInterventions(opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.mission_id) params.mission_id = opts.mission_id;
+    if (opts?.agent_id) params.agent_id = opts.agent_id;
+    if (opts?.intervention_type) params.type = opts.intervention_type;
+    return this._request("GET", "/v1/interventions", { params });
+  }
 };
 export {
   Novyx,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novyx",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "description": "Novyx SDK - Persistent memory, rollback, and audit trail for AI agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -28,6 +28,7 @@
     "typescript": "^5.3.0",
     "vitest": "^1.0.0"
   },
+  "homepage": "https://novyxlabs.com",
   "license": "MIT",
   "author": "Novyx Labs"
 }