novyx 2.10.0 → 2.12.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,150 @@ 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>;
+}
+interface Agent {
+    agent_id: string;
+    name: string;
+    model: string;
+    provider: string;
+    description?: string;
+    instructions?: string;
+    memory_scope?: string;
+    capabilities: string[];
+    policy_profile?: Record<string, any>;
+    config?: Record<string, any>;
+    status: string;
+    created_at: string;
+    updated_at?: string;
+}
+interface Mission {
+    mission_id: string;
+    agent_id: string;
+    goal: string;
+    constraints?: string[];
+    success_criteria?: string[];
+    allowed_capabilities?: string[];
+    escalation_rules?: Record<string, any>[];
+    stop_conditions?: string[];
+    config?: Record<string, any>;
+    status: string;
+    created_at: string;
+    updated_at?: string;
+}
+interface Capability {
+    capability_id: string;
+    name: string;
+    description?: string;
+    tools?: Record<string, any>[];
+    risk_levels?: Record<string, any>;
+    approval_requirements?: Record<string, any>;
+    memory_behavior?: Record<string, any>;
+    eval_rules?: Record<string, any>;
+    config?: Record<string, any>;
+    status: string;
+    created_at: string;
+    updated_at?: string;
+}
+interface Checkpoint {
+    checkpoint_id: string;
+    mission_id: string;
+    label?: string;
+    metadata?: Record<string, any>;
+    mission_status?: string;
+    created_at: string;
+}
+interface Intervention {
+    intervention_id: string;
+    intervention_type: string;
+    mission_id?: string;
+    action_id?: string;
+    agent_id?: string;
+    rationale?: string;
+    metadata?: Record<string, any>;
+    actor?: string;
+    created_at: string;
+}
 
 declare class NovyxSession {
     private client;
@@ -266,6 +412,8 @@ declare class Novyx {
     private apiUrl;
     private timeout;
     private agentId?;
+    private controlUrl?;
+    private controlApiKey?;
     constructor(config: NovyxConfig);
     private _validateKey;
     private _request;
@@ -407,6 +555,178 @@ 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>;
+    createAgent(params: {
+        name: string;
+        agent_id?: string;
+        description?: string;
+        model?: string;
+        provider?: string;
+        instructions?: string;
+        capabilities?: string[];
+        memory_scope?: string;
+        policy_profile?: Record<string, any>;
+        config?: Record<string, any>;
+    }): Promise<Agent>;
+    getAgent(agentId: string): Promise<Agent>;
+    listAgents(opts?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
+    updateAgent(agentId: string, updates: Record<string, any>): Promise<Agent>;
+    deleteAgent(agentId: string): Promise<Record<string, any>>;
+    createMission(params: {
+        agent_id: string;
+        goal: string;
+        constraints?: string[];
+        success_criteria?: string[];
+        allowed_capabilities?: string[];
+        escalation_rules?: Record<string, any>[];
+        stop_conditions?: string[];
+        config?: Record<string, any>;
+    }): Promise<Mission>;
+    getMission(missionId: string): Promise<Mission>;
+    listMissions(opts?: {
+        agent_id?: string;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
+    updateMission(missionId: string, updates: Record<string, any>): Promise<Mission>;
+    deleteMission(missionId: string): Promise<Record<string, any>>;
+    pauseMission(missionId: string): Promise<Mission>;
+    resumeMission(missionId: string): Promise<Mission>;
+    cancelMission(missionId: string): Promise<Mission>;
+    createCapability(params: {
+        name: string;
+        capability_id?: string;
+        description?: string;
+        tools?: Record<string, any>[];
+        risk_levels?: Record<string, any>;
+        approval_requirements?: Record<string, any>;
+        memory_behavior?: Record<string, any>;
+        eval_rules?: Record<string, any>;
+        config?: Record<string, any>;
+    }): Promise<Capability>;
+    getCapability(capabilityId: string): Promise<Capability>;
+    listCapabilities(opts?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
+    updateCapability(capabilityId: string, updates: Record<string, any>): Promise<Capability>;
+    deleteCapability(capabilityId: string): Promise<Record<string, any>>;
+    createCheckpoint(missionId: string, opts?: {
+        label?: string;
+        metadata?: Record<string, any>;
+    }): Promise<Checkpoint>;
+    getCheckpoint(checkpointId: string): Promise<Checkpoint>;
+    listCheckpoints(missionId: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
+    rollbackToCheckpoint(missionId: string, checkpointId: string, opts?: {
+        reason?: string;
+    }): Promise<Record<string, any>>;
+    createIntervention(params: {
+        intervention_type: string;
+        mission_id?: string;
+        action_id?: string;
+        agent_id?: string;
+        rationale?: string;
+        metadata?: Record<string, any>;
+    }): Promise<Intervention>;
+    getIntervention(interventionId: string): Promise<Intervention>;
+    listInterventions(opts?: {
+        mission_id?: string;
+        agent_id?: string;
+        intervention_type?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, 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,150 @@ 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>;
+}
+interface Agent {
+    agent_id: string;
+    name: string;
+    model: string;
+    provider: string;
+    description?: string;
+    instructions?: string;
+    memory_scope?: string;
+    capabilities: string[];
+    policy_profile?: Record<string, any>;
+    config?: Record<string, any>;
+    status: string;
+    created_at: string;
+    updated_at?: string;
+}
+interface Mission {
+    mission_id: string;
+    agent_id: string;
+    goal: string;
+    constraints?: string[];
+    success_criteria?: string[];
+    allowed_capabilities?: string[];
+    escalation_rules?: Record<string, any>[];
+    stop_conditions?: string[];
+    config?: Record<string, any>;
+    status: string;
+    created_at: string;
+    updated_at?: string;
+}
+interface Capability {
+    capability_id: string;
+    name: string;
+    description?: string;
+    tools?: Record<string, any>[];
+    risk_levels?: Record<string, any>;
+    approval_requirements?: Record<string, any>;
+    memory_behavior?: Record<string, any>;
+    eval_rules?: Record<string, any>;
+    config?: Record<string, any>;
+    status: string;
+    created_at: string;
+    updated_at?: string;
+}
+interface Checkpoint {
+    checkpoint_id: string;
+    mission_id: string;
+    label?: string;
+    metadata?: Record<string, any>;
+    mission_status?: string;
+    created_at: string;
+}
+interface Intervention {
+    intervention_id: string;
+    intervention_type: string;
+    mission_id?: string;
+    action_id?: string;
+    agent_id?: string;
+    rationale?: string;
+    metadata?: Record<string, any>;
+    actor?: string;
+    created_at: string;
+}
 
 declare class NovyxSession {
     private client;
@@ -266,6 +412,8 @@ declare class Novyx {
     private apiUrl;
     private timeout;
     private agentId?;
+    private controlUrl?;
+    private controlApiKey?;
     constructor(config: NovyxConfig);
     private _validateKey;
     private _request;
@@ -407,6 +555,178 @@ 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>;
+    createAgent(params: {
+        name: string;
+        agent_id?: string;
+        description?: string;
+        model?: string;
+        provider?: string;
+        instructions?: string;
+        capabilities?: string[];
+        memory_scope?: string;
+        policy_profile?: Record<string, any>;
+        config?: Record<string, any>;
+    }): Promise<Agent>;
+    getAgent(agentId: string): Promise<Agent>;
+    listAgents(opts?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
+    updateAgent(agentId: string, updates: Record<string, any>): Promise<Agent>;
+    deleteAgent(agentId: string): Promise<Record<string, any>>;
+    createMission(params: {
+        agent_id: string;
+        goal: string;
+        constraints?: string[];
+        success_criteria?: string[];
+        allowed_capabilities?: string[];
+        escalation_rules?: Record<string, any>[];
+        stop_conditions?: string[];
+        config?: Record<string, any>;
+    }): Promise<Mission>;
+    getMission(missionId: string): Promise<Mission>;
+    listMissions(opts?: {
+        agent_id?: string;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
+    updateMission(missionId: string, updates: Record<string, any>): Promise<Mission>;
+    deleteMission(missionId: string): Promise<Record<string, any>>;
+    pauseMission(missionId: string): Promise<Mission>;
+    resumeMission(missionId: string): Promise<Mission>;
+    cancelMission(missionId: string): Promise<Mission>;
+    createCapability(params: {
+        name: string;
+        capability_id?: string;
+        description?: string;
+        tools?: Record<string, any>[];
+        risk_levels?: Record<string, any>;
+        approval_requirements?: Record<string, any>;
+        memory_behavior?: Record<string, any>;
+        eval_rules?: Record<string, any>;
+        config?: Record<string, any>;
+    }): Promise<Capability>;
+    getCapability(capabilityId: string): Promise<Capability>;
+    listCapabilities(opts?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
+    updateCapability(capabilityId: string, updates: Record<string, any>): Promise<Capability>;
+    deleteCapability(capabilityId: string): Promise<Record<string, any>>;
+    createCheckpoint(missionId: string, opts?: {
+        label?: string;
+        metadata?: Record<string, any>;
+    }): Promise<Checkpoint>;
+    getCheckpoint(checkpointId: string): Promise<Checkpoint>;
+    listCheckpoints(missionId: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
+    rollbackToCheckpoint(missionId: string, checkpointId: string, opts?: {
+        reason?: string;
+    }): Promise<Record<string, any>>;
+    createIntervention(params: {
+        intervention_type: string;
+        mission_id?: string;
+        action_id?: string;
+        agent_id?: string;
+        rationale?: string;
+        metadata?: Record<string, any>;
+    }): Promise<Intervention>;
+    getIntervention(interventionId: string): Promise<Intervention>;
+    listInterventions(opts?: {
+        mission_id?: string;
+        agent_id?: string;
+        intervention_type?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, any>>;
 }
 
 declare class NovyxError extends Error {