novyx 2.9.2 → 2.11.0

package/dist/index.d.mts

@@ -30,6 +30,8 @@ interface NovyxConfig {
     apiUrl?: string;
     timeout?: number;
     agentId?: string;
+    controlUrl?: string;
+    controlApiKey?: string;
 }
 interface Edge {
     edge_id: string;
@@ -217,6 +219,88 @@ interface CortexInsightsResult {
     insights: CortexInsight[];
     total: number;
 }
+interface EvalScoreBreakdown {
+    recall_consistency: number;
+    drift_score: number;
+    conflict_score: number;
+    staleness_score: number;
+}
+interface EvalRunResult {
+    eval_id: string;
+    health_score: number;
+    passed?: boolean;
+    breakdown: EvalScoreBreakdown;
+    total_memories: number;
+    created_at: string;
+}
+interface EvalHistoryResult {
+    entries: EvalRunResult[];
+    total_count: number;
+    has_more: boolean;
+}
+interface EvalBaseline {
+    baseline_id: string;
+    query: string;
+    expected_observation: string;
+    created_at: string;
+}
+interface EvalBaselineListResult {
+    baselines: EvalBaseline[];
+    total_count: number;
+}
+interface MemoryDraft {
+    draft_id: string;
+    observation: string;
+    context?: string;
+    tags: string[];
+    importance: number;
+    status: string;
+    created_at: string;
+    parent_id?: string;
+    branch_name?: string;
+}
+interface DraftDiffResult {
+    draft_id: string;
+    changes: Record<string, any>;
+}
+interface ContextSpace {
+    space_id: string;
+    name: string;
+    description?: string;
+    owner_tenant_id: string;
+    allowed_agent_ids: string[];
+    allowed_tenant_ids: string[];
+    tags: string[];
+    created_at: string;
+}
+interface Approval {
+    approval_id: string;
+    action: string;
+    connector?: string;
+    agent_id?: string;
+    status: string;
+    submitted_at?: string;
+    risk_score?: number;
+}
+interface ApprovalListResult {
+    approvals: Approval[];
+    total: number;
+}
+interface PolicyInfo {
+    name: string;
+    enabled: boolean;
+    description: string;
+}
+interface PoliciesResult {
+    policies: PolicyInfo[];
+    mode: string;
+    connectors: string[];
+    approval_modes: string[];
+}
+interface StreamStatusResult {
+    connections: number;
+    event_bus: Record<string, any>;
+}
 
 declare class NovyxSession {
     private client;
@@ -266,6 +350,8 @@ declare class Novyx {
     private apiUrl;
     private timeout;
     private agentId?;
+    private controlUrl?;
+    private controlApiKey?;
     constructor(config: NovyxConfig);
     private _validateKey;
     private _request;
@@ -273,6 +359,7 @@ declare class Novyx {
         tags?: string[];
         context?: string;
         importance?: number;
+        confidence?: number;
         agent_id?: string;
         space_id?: string;
         metadata?: Record<string, any>;
@@ -340,6 +427,7 @@ declare class Novyx {
     traceComplete(traceId: string): Promise<Record<string, any>>;
     traceVerify(traceId: string): Promise<Record<string, any>>;
     usage(): Promise<Record<string, any>>;
+    dashboard(): Promise<Record<string, any>>;
     plans(): Promise<Record<string, any>[]>;
     health(): Promise<Record<string, any>>;
     session(sessionId: string): NovyxSession;
@@ -405,6 +493,89 @@ declare class Novyx {
         limit?: number;
         offset?: number;
     }): Promise<CortexInsightsResult>;
+    draftMemory(observation: string, opts?: {
+        tags?: string[];
+        context?: string;
+        importance?: number;
+        confidence?: number;
+        agent_id?: string;
+        space_id?: string;
+        branch_name?: string;
+    }): Promise<MemoryDraft>;
+    memoryDrafts(opts?: {
+        status?: string;
+        branch_name?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        drafts: MemoryDraft[];
+        total: number;
+    }>;
+    memoryDraft(draftId: string): Promise<MemoryDraft>;
+    draftDiff(draftId: string): Promise<DraftDiffResult>;
+    mergeDraft(draftId: string): Promise<Record<string, any>>;
+    rejectDraft(draftId: string, reason?: string): Promise<Record<string, any>>;
+    memoryBranches(): Promise<{
+        branches: string[];
+    }>;
+    mergeBranch(branchName: string): Promise<Record<string, any>>;
+    rejectBranch(branchName: string, reason?: string): Promise<Record<string, any>>;
+    createSpace(name: string, opts?: {
+        description?: string;
+        allowed_agent_ids?: string[];
+        allowed_tenant_ids?: string[];
+        tags?: string[];
+    }): Promise<ContextSpace>;
+    listSpaces(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        spaces: ContextSpace[];
+        total: number;
+    }>;
+    getSpace(spaceId: string): Promise<ContextSpace>;
+    updateSpace(spaceId: string, updates: Record<string, any>): Promise<ContextSpace>;
+    deleteSpace(spaceId: string): Promise<Record<string, any>>;
+    spaceMemories(spaceId: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Memory[]>;
+    evalRun(opts?: {
+        min_score?: number;
+    }): Promise<EvalRunResult>;
+    evalGate(minScore: number): Promise<EvalRunResult>;
+    evalHistory(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<EvalHistoryResult>;
+    evalDrift(days?: number): Promise<Record<string, any>>;
+    evalBaselineCreate(query: string, expectedObservation: string): Promise<EvalBaseline>;
+    evalBaselines(): Promise<EvalBaselineListResult>;
+    evalBaselineDelete(baselineId: string): Promise<Record<string, any>>;
+    listApprovals(opts?: {
+        limit?: number;
+        status_filter?: string;
+    }): Promise<ApprovalListResult>;
+    approveAction(approvalId: string, opts?: {
+        decision?: string;
+        reason?: string;
+        approver_id?: string;
+    }): Promise<Record<string, any>>;
+    listPolicies(): Promise<PoliciesResult>;
+    explainAction(actionId: string): Promise<Record<string, any>>;
+    streamStatus(): Promise<StreamStatusResult>;
+    memoryHealth(): Promise<Record<string, any>>;
+    private _controlRequest;
+    /** Submit an action to Novyx Control for governed execution. */
+    actionSubmit(connector: string, operation: string, payload: Record<string, any>): Promise<any>;
+    /** Get the status of a Control action. */
+    actionStatus(actionId: string): Promise<any>;
+    /** List recent Control actions. */
+    actionList(opts?: {
+        status?: string;
+    }): Promise<any>;
+    /** Check the current Control policy profile. */
+    policyCheck(): Promise<any>;
 }
 
 declare class NovyxError extends Error {

package/dist/index.d.ts

@@ -30,6 +30,8 @@ interface NovyxConfig {
     apiUrl?: string;
     timeout?: number;
     agentId?: string;
+    controlUrl?: string;
+    controlApiKey?: string;
 }
 interface Edge {
     edge_id: string;
@@ -217,6 +219,88 @@ interface CortexInsightsResult {
     insights: CortexInsight[];
     total: number;
 }
+interface EvalScoreBreakdown {
+    recall_consistency: number;
+    drift_score: number;
+    conflict_score: number;
+    staleness_score: number;
+}
+interface EvalRunResult {
+    eval_id: string;
+    health_score: number;
+    passed?: boolean;
+    breakdown: EvalScoreBreakdown;
+    total_memories: number;
+    created_at: string;
+}
+interface EvalHistoryResult {
+    entries: EvalRunResult[];
+    total_count: number;
+    has_more: boolean;
+}
+interface EvalBaseline {
+    baseline_id: string;
+    query: string;
+    expected_observation: string;
+    created_at: string;
+}
+interface EvalBaselineListResult {
+    baselines: EvalBaseline[];
+    total_count: number;
+}
+interface MemoryDraft {
+    draft_id: string;
+    observation: string;
+    context?: string;
+    tags: string[];
+    importance: number;
+    status: string;
+    created_at: string;
+    parent_id?: string;
+    branch_name?: string;
+}
+interface DraftDiffResult {
+    draft_id: string;
+    changes: Record<string, any>;
+}
+interface ContextSpace {
+    space_id: string;
+    name: string;
+    description?: string;
+    owner_tenant_id: string;
+    allowed_agent_ids: string[];
+    allowed_tenant_ids: string[];
+    tags: string[];
+    created_at: string;
+}
+interface Approval {
+    approval_id: string;
+    action: string;
+    connector?: string;
+    agent_id?: string;
+    status: string;
+    submitted_at?: string;
+    risk_score?: number;
+}
+interface ApprovalListResult {
+    approvals: Approval[];
+    total: number;
+}
+interface PolicyInfo {
+    name: string;
+    enabled: boolean;
+    description: string;
+}
+interface PoliciesResult {
+    policies: PolicyInfo[];
+    mode: string;
+    connectors: string[];
+    approval_modes: string[];
+}
+interface StreamStatusResult {
+    connections: number;
+    event_bus: Record<string, any>;
+}
 
 declare class NovyxSession {
     private client;
@@ -266,6 +350,8 @@ declare class Novyx {
     private apiUrl;
     private timeout;
     private agentId?;
+    private controlUrl?;
+    private controlApiKey?;
     constructor(config: NovyxConfig);
     private _validateKey;
     private _request;
@@ -273,6 +359,7 @@ declare class Novyx {
         tags?: string[];
         context?: string;
         importance?: number;
+        confidence?: number;
         agent_id?: string;
         space_id?: string;
         metadata?: Record<string, any>;
@@ -340,6 +427,7 @@ declare class Novyx {
     traceComplete(traceId: string): Promise<Record<string, any>>;
     traceVerify(traceId: string): Promise<Record<string, any>>;
     usage(): Promise<Record<string, any>>;
+    dashboard(): Promise<Record<string, any>>;
     plans(): Promise<Record<string, any>[]>;
     health(): Promise<Record<string, any>>;
     session(sessionId: string): NovyxSession;
@@ -405,6 +493,89 @@ declare class Novyx {
         limit?: number;
         offset?: number;
     }): Promise<CortexInsightsResult>;
+    draftMemory(observation: string, opts?: {
+        tags?: string[];
+        context?: string;
+        importance?: number;
+        confidence?: number;
+        agent_id?: string;
+        space_id?: string;
+        branch_name?: string;
+    }): Promise<MemoryDraft>;
+    memoryDrafts(opts?: {
+        status?: string;
+        branch_name?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        drafts: MemoryDraft[];
+        total: number;
+    }>;
+    memoryDraft(draftId: string): Promise<MemoryDraft>;
+    draftDiff(draftId: string): Promise<DraftDiffResult>;
+    mergeDraft(draftId: string): Promise<Record<string, any>>;
+    rejectDraft(draftId: string, reason?: string): Promise<Record<string, any>>;
+    memoryBranches(): Promise<{
+        branches: string[];
+    }>;
+    mergeBranch(branchName: string): Promise<Record<string, any>>;
+    rejectBranch(branchName: string, reason?: string): Promise<Record<string, any>>;
+    createSpace(name: string, opts?: {
+        description?: string;
+        allowed_agent_ids?: string[];
+        allowed_tenant_ids?: string[];
+        tags?: string[];
+    }): Promise<ContextSpace>;
+    listSpaces(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        spaces: ContextSpace[];
+        total: number;
+    }>;
+    getSpace(spaceId: string): Promise<ContextSpace>;
+    updateSpace(spaceId: string, updates: Record<string, any>): Promise<ContextSpace>;
+    deleteSpace(spaceId: string): Promise<Record<string, any>>;
+    spaceMemories(spaceId: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Memory[]>;
+    evalRun(opts?: {
+        min_score?: number;
+    }): Promise<EvalRunResult>;
+    evalGate(minScore: number): Promise<EvalRunResult>;
+    evalHistory(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<EvalHistoryResult>;
+    evalDrift(days?: number): Promise<Record<string, any>>;
+    evalBaselineCreate(query: string, expectedObservation: string): Promise<EvalBaseline>;
+    evalBaselines(): Promise<EvalBaselineListResult>;
+    evalBaselineDelete(baselineId: string): Promise<Record<string, any>>;
+    listApprovals(opts?: {
+        limit?: number;
+        status_filter?: string;
+    }): Promise<ApprovalListResult>;
+    approveAction(approvalId: string, opts?: {
+        decision?: string;
+        reason?: string;
+        approver_id?: string;
+    }): Promise<Record<string, any>>;
+    listPolicies(): Promise<PoliciesResult>;
+    explainAction(actionId: string): Promise<Record<string, any>>;
+    streamStatus(): Promise<StreamStatusResult>;
+    memoryHealth(): Promise<Record<string, any>>;
+    private _controlRequest;
+    /** Submit an action to Novyx Control for governed execution. */
+    actionSubmit(connector: string, operation: string, payload: Record<string, any>): Promise<any>;
+    /** Get the status of a Control action. */
+    actionStatus(actionId: string): Promise<any>;
+    /** List recent Control actions. */
+    actionList(opts?: {
+        status?: string;
+    }): Promise<any>;
+    /** Check the current Control policy profile. */
+    policyCheck(): Promise<any>;
 }
 
 declare class NovyxError extends Error {

package/dist/index.js

@@ -109,6 +109,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() {
@@ -210,6 +212,7 @@ var Novyx = class {
       tags: opts?.tags ?? [],
       importance: opts?.importance ?? 5
     };
+    if (opts?.confidence !== void 0) body.confidence = opts.confidence;
     if (resolvedAgentId) body.agent_id = resolvedAgentId;
     if (opts?.space_id) body.space_id = opts.space_id;
     if (opts?.ttl_seconds !== void 0) body.ttl_seconds = opts.ttl_seconds;
@@ -391,6 +394,9 @@ var Novyx = class {
   async usage() {
     return this._request("GET", "/v1/usage");
   }
+  async dashboard() {
+    return this._request("GET", "/v1/dashboard");
+  }
   async plans() {
     return this._request("GET", "/v1/plans");
   }
@@ -542,6 +548,203 @@ 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");
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

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() {
@@ -177,6 +179,7 @@ var Novyx = class {
       tags: opts?.tags ?? [],
       importance: opts?.importance ?? 5
     };
+    if (opts?.confidence !== void 0) body.confidence = opts.confidence;
     if (resolvedAgentId) body.agent_id = resolvedAgentId;
     if (opts?.space_id) body.space_id = opts.space_id;
     if (opts?.ttl_seconds !== void 0) body.ttl_seconds = opts.ttl_seconds;
@@ -358,6 +361,9 @@ var Novyx = class {
   async usage() {
     return this._request("GET", "/v1/usage");
   }
+  async dashboard() {
+    return this._request("GET", "/v1/dashboard");
+  }
   async plans() {
     return this._request("GET", "/v1/plans");
   }
@@ -509,6 +515,203 @@ 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");
+  }
 };
 export {
   Novyx,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novyx",
-  "version": "2.9.2",
+  "version": "2.11.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"
 }