novyx 2.5.0 → 2.6.0

package/dist/index.d.mts

@@ -45,6 +45,10 @@ interface LinksResult {
     edges: Edge[];
     total: number;
 }
+interface EdgesListResult {
+    edges: Edge[];
+    total: number;
+}
 interface ContextNowResult {
     server_time_utc: string;
     recent_memories: Memory[];
@@ -54,6 +58,38 @@ interface ContextNowResult {
     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;
@@ -186,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 {
@@ -216,4 +281,4 @@ declare class NovyxSecurityError extends NovyxError {
     constructor(message?: string);
 }
 
-export { type ContextNowResult, 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

@@ -45,6 +45,10 @@ interface LinksResult {
     edges: Edge[];
     total: number;
 }
+interface EdgesListResult {
+    edges: Edge[];
+    total: number;
+}
 interface ContextNowResult {
     server_time_utc: string;
     recent_memories: Memory[];
@@ -54,6 +58,38 @@ interface ContextNowResult {
     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;
@@ -186,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 {
@@ -216,4 +281,4 @@ declare class NovyxSecurityError extends NovyxError {
     constructor(message?: string);
 }
 
-export { type ContextNowResult, 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

@@ -442,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

@@ -409,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.5.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",