novyx 2.4.0 → 2.6.0

package/dist/index.d.mts

@@ -12,6 +12,8 @@ interface Memory {
     vector_clock?: Record<string, number>;
     conflict_metadata?: Record<string, any>;
     expires_at?: string;
+    superseded_by?: string;
+    match_confidence?: number;
 }
 interface SearchResult {
     query: string;
@@ -43,6 +45,51 @@ interface LinksResult {
     edges: Edge[];
     total: number;
 }
+interface EdgesListResult {
+    edges: Edge[];
+    total: number;
+}
+interface ContextNowResult {
+    server_time_utc: string;
+    recent_memories: Memory[];
+    recent_count: number;
+    upcoming: Memory[];
+    upcoming_count: number;
+    last_session_at?: string;
+    seconds_since_last_session?: number;
+}
+interface KGEntity {
+    entity_id: string;
+    name: string;
+    entity_type?: string;
+    metadata: Record<string, any>;
+    created_at: string;
+    triple_count: number;
+}
+interface KGTriple {
+    triple_id: string;
+    subject: KGEntity;
+    predicate: string;
+    object: KGEntity;
+    confidence: number;
+    source_memory_id?: string;
+    metadata: Record<string, any>;
+    created_at: string;
+}
+interface TripleListResult {
+    triples: KGTriple[];
+    total: number;
+}
+interface EntityListResult {
+    entities: KGEntity[];
+    total: number;
+}
+interface EntityTraversalResult {
+    entity: KGEntity;
+    as_subject: KGTriple[];
+    as_object: KGTriple[];
+    total_connections: number;
+}
 
 declare class NovyxSession {
     private client;
@@ -113,7 +160,11 @@ declare class Novyx {
         agents?: string[];
         include_shared?: boolean;
         space_id?: string;
+        recency_weight?: number;
+        include_superseded?: boolean;
     }): Promise<SearchResult>;
+    supersede(oldMemoryId: string, newMemoryId: string): Promise<Record<string, any>>;
+    contextNow(): Promise<ContextNowResult>;
     memories(opts?: {
         limit?: number;
         offset?: number;
@@ -163,7 +214,6 @@ declare class Novyx {
     usage(): Promise<Record<string, any>>;
     plans(): Promise<Record<string, any>[]>;
     health(): Promise<Record<string, any>>;
-    contextNow(): Promise<Record<string, any>>;
     session(sessionId: string): NovyxSession;
     link(sourceId: string, targetId: string, opts?: {
         relation?: string;
@@ -172,6 +222,35 @@ declare class Novyx {
     }): Promise<Record<string, any>>;
     unlink(sourceId: string, targetId: string, relation?: string): Promise<Record<string, any>>;
     links(memoryId: string, relation?: string): Promise<LinksResult>;
+    edges(opts?: {
+        relation?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<EdgesListResult>;
+    triple(subject: string, predicate: string, object: string, opts?: {
+        confidence?: number;
+        source_memory_id?: string;
+        subject_type?: string;
+        object_type?: string;
+        metadata?: Record<string, any>;
+    }): Promise<KGTriple>;
+    triples(opts?: {
+        subject?: string;
+        predicate?: string;
+        object?: string;
+        source_memory_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<TripleListResult>;
+    deleteTriple(tripleId: string): Promise<Record<string, any>>;
+    entities(opts?: {
+        entity_type?: string;
+        q?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<EntityListResult>;
+    entity(entityId: string): Promise<EntityTraversalResult>;
+    deleteEntity(entityId: string): Promise<Record<string, any>>;
 }
 
 declare class NovyxError extends Error {
@@ -202,4 +281,4 @@ declare class NovyxSecurityError extends NovyxError {
     constructor(message?: string);
 }
 
-export { type Edge, type LinksResult, type ListResult, type Memory, Novyx, NovyxAuthError, type NovyxConfig, NovyxError, NovyxForbiddenError, NovyxNotFoundError, NovyxRateLimitError, NovyxSecurityError, NovyxSession, type SearchResult };
+export { type ContextNowResult, type Edge, type EdgesListResult, type EntityListResult, type EntityTraversalResult, type KGEntity, type KGTriple, type LinksResult, type ListResult, type Memory, Novyx, NovyxAuthError, type NovyxConfig, NovyxError, NovyxForbiddenError, NovyxNotFoundError, NovyxRateLimitError, NovyxSecurityError, NovyxSession, type SearchResult, type TripleListResult };

package/dist/index.d.ts

@@ -12,6 +12,8 @@ interface Memory {
     vector_clock?: Record<string, number>;
     conflict_metadata?: Record<string, any>;
     expires_at?: string;
+    superseded_by?: string;
+    match_confidence?: number;
 }
 interface SearchResult {
     query: string;
@@ -43,6 +45,51 @@ interface LinksResult {
     edges: Edge[];
     total: number;
 }
+interface EdgesListResult {
+    edges: Edge[];
+    total: number;
+}
+interface ContextNowResult {
+    server_time_utc: string;
+    recent_memories: Memory[];
+    recent_count: number;
+    upcoming: Memory[];
+    upcoming_count: number;
+    last_session_at?: string;
+    seconds_since_last_session?: number;
+}
+interface KGEntity {
+    entity_id: string;
+    name: string;
+    entity_type?: string;
+    metadata: Record<string, any>;
+    created_at: string;
+    triple_count: number;
+}
+interface KGTriple {
+    triple_id: string;
+    subject: KGEntity;
+    predicate: string;
+    object: KGEntity;
+    confidence: number;
+    source_memory_id?: string;
+    metadata: Record<string, any>;
+    created_at: string;
+}
+interface TripleListResult {
+    triples: KGTriple[];
+    total: number;
+}
+interface EntityListResult {
+    entities: KGEntity[];
+    total: number;
+}
+interface EntityTraversalResult {
+    entity: KGEntity;
+    as_subject: KGTriple[];
+    as_object: KGTriple[];
+    total_connections: number;
+}
 
 declare class NovyxSession {
     private client;
@@ -113,7 +160,11 @@ declare class Novyx {
         agents?: string[];
         include_shared?: boolean;
         space_id?: string;
+        recency_weight?: number;
+        include_superseded?: boolean;
     }): Promise<SearchResult>;
+    supersede(oldMemoryId: string, newMemoryId: string): Promise<Record<string, any>>;
+    contextNow(): Promise<ContextNowResult>;
     memories(opts?: {
         limit?: number;
         offset?: number;
@@ -163,7 +214,6 @@ declare class Novyx {
     usage(): Promise<Record<string, any>>;
     plans(): Promise<Record<string, any>[]>;
     health(): Promise<Record<string, any>>;
-    contextNow(): Promise<Record<string, any>>;
     session(sessionId: string): NovyxSession;
     link(sourceId: string, targetId: string, opts?: {
         relation?: string;
@@ -172,6 +222,35 @@ declare class Novyx {
     }): Promise<Record<string, any>>;
     unlink(sourceId: string, targetId: string, relation?: string): Promise<Record<string, any>>;
     links(memoryId: string, relation?: string): Promise<LinksResult>;
+    edges(opts?: {
+        relation?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<EdgesListResult>;
+    triple(subject: string, predicate: string, object: string, opts?: {
+        confidence?: number;
+        source_memory_id?: string;
+        subject_type?: string;
+        object_type?: string;
+        metadata?: Record<string, any>;
+    }): Promise<KGTriple>;
+    triples(opts?: {
+        subject?: string;
+        predicate?: string;
+        object?: string;
+        source_memory_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<TripleListResult>;
+    deleteTriple(tripleId: string): Promise<Record<string, any>>;
+    entities(opts?: {
+        entity_type?: string;
+        q?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<EntityListResult>;
+    entity(entityId: string): Promise<EntityTraversalResult>;
+    deleteEntity(entityId: string): Promise<Record<string, any>>;
 }
 
 declare class NovyxError extends Error {
@@ -202,4 +281,4 @@ declare class NovyxSecurityError extends NovyxError {
     constructor(message?: string);
 }
 
-export { type Edge, type LinksResult, type ListResult, type Memory, Novyx, NovyxAuthError, type NovyxConfig, NovyxError, NovyxForbiddenError, NovyxNotFoundError, NovyxRateLimitError, NovyxSecurityError, NovyxSession, type SearchResult };
+export { type ContextNowResult, type Edge, type EdgesListResult, type EntityListResult, type EntityTraversalResult, type KGEntity, type KGTriple, type LinksResult, type ListResult, type Memory, Novyx, NovyxAuthError, type NovyxConfig, NovyxError, NovyxForbiddenError, NovyxNotFoundError, NovyxRateLimitError, NovyxSecurityError, NovyxSession, type SearchResult, type TripleListResult };

package/dist/index.js

@@ -230,6 +230,8 @@ var Novyx = class {
     if (opts?.tags) params.tags = opts.tags.join(",");
     if (opts?.agents) params.agents = opts.agents.join(",");
     if (opts?.space_id) params.space_id = opts.space_id;
+    if (opts?.recency_weight !== void 0 && opts.recency_weight > 0) params.recency_weight = opts.recency_weight;
+    if (opts?.include_superseded) params.include_superseded = "true";
     const result = await this._request("GET", "/v1/memories/search", { params });
     const raw = Array.isArray(result) ? result : result.memories ?? [];
     return {
@@ -238,6 +240,14 @@ var Novyx = class {
       memories: raw
     };
   }
+  async supersede(oldMemoryId, newMemoryId) {
+    return this._request("PATCH", `/v1/memories/${oldMemoryId}`, {
+      body: { superseded_by: newMemoryId }
+    });
+  }
+  async contextNow() {
+    return this._request("GET", "/v1/context/now");
+  }
   async memories(opts) {
     const params = {
       limit: opts?.limit ?? 100,
@@ -401,12 +411,6 @@ var Novyx = class {
     }
   }
   // ========================================================================
-  // Context
-  // ========================================================================
-  async contextNow() {
-    return this._request("GET", "/v1/context/now");
-  }
-  // ========================================================================
   // Sessions
   // ========================================================================
   session(sessionId) {
@@ -438,6 +442,55 @@ var Novyx = class {
     if (relation) params.relation = relation;
     return this._request("GET", `/v1/memories/${memoryId}/links`, { params });
   }
+  async edges(opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.relation) params.relation = opts.relation;
+    return this._request("GET", "/v1/memories/edges", { params });
+  }
+  // ========================================================================
+  // Knowledge Graph (Pro+)
+  // ========================================================================
+  async triple(subject, predicate, object, opts) {
+    const body = { subject, predicate, object };
+    if (opts?.confidence !== void 0) body.confidence = opts.confidence;
+    if (opts?.source_memory_id) body.source_memory_id = opts.source_memory_id;
+    if (opts?.subject_type) body.subject_type = opts.subject_type;
+    if (opts?.object_type) body.object_type = opts.object_type;
+    if (opts?.metadata) body.metadata = opts.metadata;
+    return this._request("POST", "/v1/knowledge/triples", { body });
+  }
+  async triples(opts) {
+    const params = {
+      limit: opts?.limit ?? 50,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.subject) params.subject = opts.subject;
+    if (opts?.predicate) params.predicate = opts.predicate;
+    if (opts?.object) params.object = opts.object;
+    if (opts?.source_memory_id) params.source_memory_id = opts.source_memory_id;
+    return this._request("GET", "/v1/knowledge/triples", { params });
+  }
+  async deleteTriple(tripleId) {
+    return this._request("DELETE", `/v1/knowledge/triples/${tripleId}`);
+  }
+  async entities(opts) {
+    const params = {
+      limit: opts?.limit ?? 50,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.entity_type) params.entity_type = opts.entity_type;
+    if (opts?.q) params.q = opts.q;
+    return this._request("GET", "/v1/knowledge/entities", { params });
+  }
+  async entity(entityId) {
+    return this._request("GET", `/v1/knowledge/entities/${entityId}`);
+  }
+  async deleteEntity(entityId) {
+    return this._request("DELETE", `/v1/knowledge/entities/${entityId}`);
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -197,6 +197,8 @@ var Novyx = class {
     if (opts?.tags) params.tags = opts.tags.join(",");
     if (opts?.agents) params.agents = opts.agents.join(",");
     if (opts?.space_id) params.space_id = opts.space_id;
+    if (opts?.recency_weight !== void 0 && opts.recency_weight > 0) params.recency_weight = opts.recency_weight;
+    if (opts?.include_superseded) params.include_superseded = "true";
     const result = await this._request("GET", "/v1/memories/search", { params });
     const raw = Array.isArray(result) ? result : result.memories ?? [];
     return {
@@ -205,6 +207,14 @@ var Novyx = class {
       memories: raw
     };
   }
+  async supersede(oldMemoryId, newMemoryId) {
+    return this._request("PATCH", `/v1/memories/${oldMemoryId}`, {
+      body: { superseded_by: newMemoryId }
+    });
+  }
+  async contextNow() {
+    return this._request("GET", "/v1/context/now");
+  }
   async memories(opts) {
     const params = {
       limit: opts?.limit ?? 100,
@@ -368,12 +378,6 @@ var Novyx = class {
     }
   }
   // ========================================================================
-  // Context
-  // ========================================================================
-  async contextNow() {
-    return this._request("GET", "/v1/context/now");
-  }
-  // ========================================================================
   // Sessions
   // ========================================================================
   session(sessionId) {
@@ -405,6 +409,55 @@ var Novyx = class {
     if (relation) params.relation = relation;
     return this._request("GET", `/v1/memories/${memoryId}/links`, { params });
   }
+  async edges(opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.relation) params.relation = opts.relation;
+    return this._request("GET", "/v1/memories/edges", { params });
+  }
+  // ========================================================================
+  // Knowledge Graph (Pro+)
+  // ========================================================================
+  async triple(subject, predicate, object, opts) {
+    const body = { subject, predicate, object };
+    if (opts?.confidence !== void 0) body.confidence = opts.confidence;
+    if (opts?.source_memory_id) body.source_memory_id = opts.source_memory_id;
+    if (opts?.subject_type) body.subject_type = opts.subject_type;
+    if (opts?.object_type) body.object_type = opts.object_type;
+    if (opts?.metadata) body.metadata = opts.metadata;
+    return this._request("POST", "/v1/knowledge/triples", { body });
+  }
+  async triples(opts) {
+    const params = {
+      limit: opts?.limit ?? 50,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.subject) params.subject = opts.subject;
+    if (opts?.predicate) params.predicate = opts.predicate;
+    if (opts?.object) params.object = opts.object;
+    if (opts?.source_memory_id) params.source_memory_id = opts.source_memory_id;
+    return this._request("GET", "/v1/knowledge/triples", { params });
+  }
+  async deleteTriple(tripleId) {
+    return this._request("DELETE", `/v1/knowledge/triples/${tripleId}`);
+  }
+  async entities(opts) {
+    const params = {
+      limit: opts?.limit ?? 50,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.entity_type) params.entity_type = opts.entity_type;
+    if (opts?.q) params.q = opts.q;
+    return this._request("GET", "/v1/knowledge/entities", { params });
+  }
+  async entity(entityId) {
+    return this._request("GET", `/v1/knowledge/entities/${entityId}`);
+  }
+  async deleteEntity(entityId) {
+    return this._request("DELETE", `/v1/knowledge/entities/${entityId}`);
+  }
 };
 export {
   Novyx,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novyx",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Novyx SDK - Persistent memory, rollback, and audit trail for AI agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",