novyx 2.6.0 → 2.7.0

package/dist/index.d.mts

@@ -90,6 +90,98 @@ interface EntityTraversalResult {
     as_object: KGTriple[];
     total_connections: number;
 }
+interface ReplayTimelineEntry {
+    timestamp: string;
+    operation: string;
+    memory_id?: string;
+    observation_preview?: string;
+    agent_id?: string;
+    importance?: number;
+    content_hash?: string;
+    metadata?: Record<string, any>;
+}
+interface ReplayTimelineResult {
+    entries: ReplayTimelineEntry[];
+    total_count: number;
+    has_more: boolean;
+    period_start?: string;
+    period_end?: string;
+}
+interface ReplaySnapshotResult {
+    snapshot_at: string;
+    total_memories: number;
+    memories: Memory[];
+    edges: Edge[];
+    total_edges: number;
+}
+interface MemoryLifecycleEvent {
+    timestamp: string;
+    event_type: string;
+    detail?: Record<string, any>;
+}
+interface MemoryLifecycleResult {
+    memory_id: string;
+    observation: string;
+    created_at: string;
+    current_state?: string;
+    events: MemoryLifecycleEvent[];
+    versions: Record<string, any>[];
+    links: Edge[];
+    recall_count: number;
+    last_recalled_at?: string;
+}
+interface CounterfactualRecallResult {
+    query: string;
+    snapshot_at: string;
+    total_results: number;
+    results: {
+        uuid: string;
+        observation: string;
+        similarity: number;
+        score: number;
+        importance: number;
+        confidence: number;
+        created_at: string;
+    }[];
+}
+interface ReplayDiffResult {
+    from_timestamp: string;
+    to_timestamp: string;
+    added: ReplayDiffEntry[];
+    removed: ReplayDiffEntry[];
+    modified: ReplayDiffEntry[];
+    summary: {
+        added: number;
+        removed: number;
+        modified: number;
+    };
+}
+interface ReplayDiffEntry {
+    memory_id: string;
+    change_type: string;
+    observation_preview?: string;
+    importance?: number;
+}
+interface DriftAnalysisResult {
+    from_timestamp: string;
+    to_timestamp: string;
+    memory_count_from: number;
+    memory_count_to: number;
+    memory_count_delta: number;
+    avg_importance_from: number;
+    avg_importance_to: number;
+    avg_importance_delta: number;
+    tag_shifts: {
+        tag: string;
+        count_from: number;
+        count_to: number;
+        delta: number;
+    }[];
+    importance_distribution_from: Record<string, number>;
+    importance_distribution_to: Record<string, number>;
+    top_new_topics: string[];
+    top_lost_topics: string[];
+}
 
 declare class NovyxSession {
     private client;
@@ -208,7 +300,7 @@ declare class Novyx {
     auditExport(format?: string): Promise<Response>;
     auditVerify(): Promise<Record<string, any>>;
     traceCreate(agentId: string, sessionId?: string, metadata?: Record<string, any>): Promise<Record<string, any>>;
-    traceStep(traceId: string, stepType: string, name: string, content?: string, attributes?: Record<string, any>): Promise<Record<string, any>>;
+    traceStep(traceId: string, stepType: string, content: string, metadata?: Record<string, any>): Promise<Record<string, any>>;
     traceComplete(traceId: string): Promise<Record<string, any>>;
     traceVerify(traceId: string): Promise<Record<string, any>>;
     usage(): Promise<Record<string, any>>;
@@ -251,6 +343,24 @@ declare class Novyx {
     }): Promise<EntityListResult>;
     entity(entityId: string): Promise<EntityTraversalResult>;
     deleteEntity(entityId: string): Promise<Record<string, any>>;
+    replayTimeline(opts?: {
+        since?: string;
+        until?: string;
+        operations?: string[];
+        agent_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ReplayTimelineResult>;
+    replaySnapshot(at: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ReplaySnapshotResult>;
+    replayMemory(memoryId: string): Promise<MemoryLifecycleResult>;
+    replayRecall(query: string, at: string, opts?: {
+        limit?: number;
+    }): Promise<CounterfactualRecallResult>;
+    replayDiff(from: string, to: string): Promise<ReplayDiffResult>;
+    replayDrift(from: string, to: string): Promise<DriftAnalysisResult>;
 }
 
 declare class NovyxError extends Error {
@@ -281,4 +391,4 @@ declare class NovyxSecurityError extends NovyxError {
     constructor(message?: string);
 }
 
-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 };
+export { type ContextNowResult, type CounterfactualRecallResult, type DriftAnalysisResult, type Edge, type EdgesListResult, type EntityListResult, type EntityTraversalResult, type KGEntity, type KGTriple, type LinksResult, type ListResult, type Memory, type MemoryLifecycleEvent, type MemoryLifecycleResult, Novyx, NovyxAuthError, type NovyxConfig, NovyxError, NovyxForbiddenError, NovyxNotFoundError, NovyxRateLimitError, NovyxSecurityError, NovyxSession, type ReplayDiffEntry, type ReplayDiffResult, type ReplaySnapshotResult, type ReplayTimelineEntry, type ReplayTimelineResult, type SearchResult, type TripleListResult };

package/dist/index.d.ts

@@ -90,6 +90,98 @@ interface EntityTraversalResult {
     as_object: KGTriple[];
     total_connections: number;
 }
+interface ReplayTimelineEntry {
+    timestamp: string;
+    operation: string;
+    memory_id?: string;
+    observation_preview?: string;
+    agent_id?: string;
+    importance?: number;
+    content_hash?: string;
+    metadata?: Record<string, any>;
+}
+interface ReplayTimelineResult {
+    entries: ReplayTimelineEntry[];
+    total_count: number;
+    has_more: boolean;
+    period_start?: string;
+    period_end?: string;
+}
+interface ReplaySnapshotResult {
+    snapshot_at: string;
+    total_memories: number;
+    memories: Memory[];
+    edges: Edge[];
+    total_edges: number;
+}
+interface MemoryLifecycleEvent {
+    timestamp: string;
+    event_type: string;
+    detail?: Record<string, any>;
+}
+interface MemoryLifecycleResult {
+    memory_id: string;
+    observation: string;
+    created_at: string;
+    current_state?: string;
+    events: MemoryLifecycleEvent[];
+    versions: Record<string, any>[];
+    links: Edge[];
+    recall_count: number;
+    last_recalled_at?: string;
+}
+interface CounterfactualRecallResult {
+    query: string;
+    snapshot_at: string;
+    total_results: number;
+    results: {
+        uuid: string;
+        observation: string;
+        similarity: number;
+        score: number;
+        importance: number;
+        confidence: number;
+        created_at: string;
+    }[];
+}
+interface ReplayDiffResult {
+    from_timestamp: string;
+    to_timestamp: string;
+    added: ReplayDiffEntry[];
+    removed: ReplayDiffEntry[];
+    modified: ReplayDiffEntry[];
+    summary: {
+        added: number;
+        removed: number;
+        modified: number;
+    };
+}
+interface ReplayDiffEntry {
+    memory_id: string;
+    change_type: string;
+    observation_preview?: string;
+    importance?: number;
+}
+interface DriftAnalysisResult {
+    from_timestamp: string;
+    to_timestamp: string;
+    memory_count_from: number;
+    memory_count_to: number;
+    memory_count_delta: number;
+    avg_importance_from: number;
+    avg_importance_to: number;
+    avg_importance_delta: number;
+    tag_shifts: {
+        tag: string;
+        count_from: number;
+        count_to: number;
+        delta: number;
+    }[];
+    importance_distribution_from: Record<string, number>;
+    importance_distribution_to: Record<string, number>;
+    top_new_topics: string[];
+    top_lost_topics: string[];
+}
 
 declare class NovyxSession {
     private client;
@@ -208,7 +300,7 @@ declare class Novyx {
     auditExport(format?: string): Promise<Response>;
     auditVerify(): Promise<Record<string, any>>;
     traceCreate(agentId: string, sessionId?: string, metadata?: Record<string, any>): Promise<Record<string, any>>;
-    traceStep(traceId: string, stepType: string, name: string, content?: string, attributes?: Record<string, any>): Promise<Record<string, any>>;
+    traceStep(traceId: string, stepType: string, content: string, metadata?: Record<string, any>): Promise<Record<string, any>>;
     traceComplete(traceId: string): Promise<Record<string, any>>;
     traceVerify(traceId: string): Promise<Record<string, any>>;
     usage(): Promise<Record<string, any>>;
@@ -251,6 +343,24 @@ declare class Novyx {
     }): Promise<EntityListResult>;
     entity(entityId: string): Promise<EntityTraversalResult>;
     deleteEntity(entityId: string): Promise<Record<string, any>>;
+    replayTimeline(opts?: {
+        since?: string;
+        until?: string;
+        operations?: string[];
+        agent_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ReplayTimelineResult>;
+    replaySnapshot(at: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ReplaySnapshotResult>;
+    replayMemory(memoryId: string): Promise<MemoryLifecycleResult>;
+    replayRecall(query: string, at: string, opts?: {
+        limit?: number;
+    }): Promise<CounterfactualRecallResult>;
+    replayDiff(from: string, to: string): Promise<ReplayDiffResult>;
+    replayDrift(from: string, to: string): Promise<DriftAnalysisResult>;
 }
 
 declare class NovyxError extends Error {
@@ -281,4 +391,4 @@ declare class NovyxSecurityError extends NovyxError {
     constructor(message?: string);
 }
 
-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 };
+export { type ContextNowResult, type CounterfactualRecallResult, type DriftAnalysisResult, type Edge, type EdgesListResult, type EntityListResult, type EntityTraversalResult, type KGEntity, type KGTriple, type LinksResult, type ListResult, type Memory, type MemoryLifecycleEvent, type MemoryLifecycleResult, Novyx, NovyxAuthError, type NovyxConfig, NovyxError, NovyxForbiddenError, NovyxNotFoundError, NovyxRateLimitError, NovyxSecurityError, NovyxSession, type ReplayDiffEntry, type ReplayDiffResult, type ReplaySnapshotResult, type ReplayTimelineEntry, type ReplayTimelineResult, type SearchResult, type TripleListResult };

package/dist/index.js

@@ -369,21 +369,19 @@ var Novyx = class {
       }
     });
   }
-  async traceStep(traceId, stepType, name, content, attributes) {
-    return this._request("POST", `/v1/traces/${traceId}/steps`, {
-      body: {
-        step_type: stepType,
-        name,
-        content,
-        attributes: attributes ?? {}
-      }
-    });
+  async traceStep(traceId, stepType, content, metadata) {
+    const body = {
+      type: stepType,
+      content
+    };
+    if (metadata) body.metadata = metadata;
+    return this._request("POST", `/v1/traces/${traceId}/steps`, { body });
   }
   async traceComplete(traceId) {
     return this._request("POST", `/v1/traces/${traceId}/complete`);
   }
   async traceVerify(traceId) {
-    return this._request("GET", `/v1/traces/${traceId}/verify`);
+    return this._request("POST", `/v1/traces/${traceId}/verify`);
   }
   // ========================================================================
   // Usage & Plans
@@ -491,6 +489,39 @@ var Novyx = class {
   async deleteEntity(entityId) {
     return this._request("DELETE", `/v1/knowledge/entities/${entityId}`);
   }
+  // ========================================================================
+  // Replay (Pro+)
+  // ========================================================================
+  async replayTimeline(opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.since) params.since = opts.since;
+    if (opts?.until) params.until = opts.until;
+    if (opts?.operations) params.operations = opts.operations.join(",");
+    if (opts?.agent_id) params.agent_id = opts.agent_id;
+    return this._request("GET", "/v1/replay/timeline", { params });
+  }
+  async replaySnapshot(at, opts) {
+    return this._request("GET", "/v1/replay/snapshot", {
+      params: { at, limit: opts?.limit ?? 500, offset: opts?.offset ?? 0 }
+    });
+  }
+  async replayMemory(memoryId) {
+    return this._request("GET", `/v1/replay/memory/${memoryId}`);
+  }
+  async replayRecall(query, at, opts) {
+    return this._request("POST", "/v1/replay/recall", {
+      body: { query, at, limit: opts?.limit ?? 5 }
+    });
+  }
+  async replayDiff(from, to) {
+    return this._request("GET", "/v1/replay/diff", { params: { from, to } });
+  }
+  async replayDrift(from, to) {
+    return this._request("GET", "/v1/replay/drift", { params: { from, to } });
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -336,21 +336,19 @@ var Novyx = class {
       }
     });
   }
-  async traceStep(traceId, stepType, name, content, attributes) {
-    return this._request("POST", `/v1/traces/${traceId}/steps`, {
-      body: {
-        step_type: stepType,
-        name,
-        content,
-        attributes: attributes ?? {}
-      }
-    });
+  async traceStep(traceId, stepType, content, metadata) {
+    const body = {
+      type: stepType,
+      content
+    };
+    if (metadata) body.metadata = metadata;
+    return this._request("POST", `/v1/traces/${traceId}/steps`, { body });
   }
   async traceComplete(traceId) {
     return this._request("POST", `/v1/traces/${traceId}/complete`);
   }
   async traceVerify(traceId) {
-    return this._request("GET", `/v1/traces/${traceId}/verify`);
+    return this._request("POST", `/v1/traces/${traceId}/verify`);
   }
   // ========================================================================
   // Usage & Plans
@@ -458,6 +456,39 @@ var Novyx = class {
   async deleteEntity(entityId) {
     return this._request("DELETE", `/v1/knowledge/entities/${entityId}`);
   }
+  // ========================================================================
+  // Replay (Pro+)
+  // ========================================================================
+  async replayTimeline(opts) {
+    const params = {
+      limit: opts?.limit ?? 100,
+      offset: opts?.offset ?? 0
+    };
+    if (opts?.since) params.since = opts.since;
+    if (opts?.until) params.until = opts.until;
+    if (opts?.operations) params.operations = opts.operations.join(",");
+    if (opts?.agent_id) params.agent_id = opts.agent_id;
+    return this._request("GET", "/v1/replay/timeline", { params });
+  }
+  async replaySnapshot(at, opts) {
+    return this._request("GET", "/v1/replay/snapshot", {
+      params: { at, limit: opts?.limit ?? 500, offset: opts?.offset ?? 0 }
+    });
+  }
+  async replayMemory(memoryId) {
+    return this._request("GET", `/v1/replay/memory/${memoryId}`);
+  }
+  async replayRecall(query, at, opts) {
+    return this._request("POST", "/v1/replay/recall", {
+      body: { query, at, limit: opts?.limit ?? 5 }
+    });
+  }
+  async replayDiff(from, to) {
+    return this._request("GET", "/v1/replay/diff", { params: { from, to } });
+  }
+  async replayDrift(from, to) {
+    return this._request("GET", "/v1/replay/drift", { params: { from, to } });
+  }
 };
 export {
   Novyx,

package/package.json

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