novyx 2.6.1 → 2.8.0

package/dist/index.d.mts

@@ -90,6 +90,133 @@ 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[];
+}
+interface CortexConfigResult {
+    tenant_id: string;
+    enabled: boolean;
+    consolidation_enabled: boolean;
+    consolidation_threshold: number;
+    reinforcement_enabled: boolean;
+    decay_enabled: boolean;
+    decay_age_days: number;
+    insight_generation_enabled: boolean;
+    last_run_at: string | null;
+    run_stats: Record<string, any>;
+}
+interface CortexStatusResult {
+    enabled: boolean;
+    last_run_at: string | null;
+    run_stats: Record<string, any>;
+    config: CortexConfigResult;
+}
+interface CortexRunResult {
+    consolidated: number;
+    boosted: number;
+    decayed: number;
+    insights_generated: number;
+}
+interface CortexInsight {
+    uuid: string;
+    observation: string;
+    tags: string[];
+    importance: number;
+    created_at: string;
+}
+interface CortexInsightsResult {
+    insights: CortexInsight[];
+    total: number;
+}
 
 declare class NovyxSession {
     private client;
@@ -251,6 +378,32 @@ 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>;
+    cortexStatus(): Promise<CortexStatusResult>;
+    cortexConfig(): Promise<CortexConfigResult>;
+    cortexUpdateConfig(updates: Partial<Omit<CortexConfigResult, "tenant_id" | "last_run_at" | "run_stats">>): Promise<CortexConfigResult>;
+    cortexRun(): Promise<CortexRunResult>;
+    cortexInsights(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<CortexInsightsResult>;
 }
 
 declare class NovyxError extends Error {
@@ -281,4 +434,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 CortexConfigResult, type CortexInsight, type CortexInsightsResult, type CortexRunResult, type CortexStatusResult, 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,133 @@ 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[];
+}
+interface CortexConfigResult {
+    tenant_id: string;
+    enabled: boolean;
+    consolidation_enabled: boolean;
+    consolidation_threshold: number;
+    reinforcement_enabled: boolean;
+    decay_enabled: boolean;
+    decay_age_days: number;
+    insight_generation_enabled: boolean;
+    last_run_at: string | null;
+    run_stats: Record<string, any>;
+}
+interface CortexStatusResult {
+    enabled: boolean;
+    last_run_at: string | null;
+    run_stats: Record<string, any>;
+    config: CortexConfigResult;
+}
+interface CortexRunResult {
+    consolidated: number;
+    boosted: number;
+    decayed: number;
+    insights_generated: number;
+}
+interface CortexInsight {
+    uuid: string;
+    observation: string;
+    tags: string[];
+    importance: number;
+    created_at: string;
+}
+interface CortexInsightsResult {
+    insights: CortexInsight[];
+    total: number;
+}
 
 declare class NovyxSession {
     private client;
@@ -251,6 +378,32 @@ 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>;
+    cortexStatus(): Promise<CortexStatusResult>;
+    cortexConfig(): Promise<CortexConfigResult>;
+    cortexUpdateConfig(updates: Partial<Omit<CortexConfigResult, "tenant_id" | "last_run_at" | "run_stats">>): Promise<CortexConfigResult>;
+    cortexRun(): Promise<CortexRunResult>;
+    cortexInsights(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<CortexInsightsResult>;
 }
 
 declare class NovyxError extends Error {
@@ -281,4 +434,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 CortexConfigResult, type CortexInsight, type CortexInsightsResult, type CortexRunResult, type CortexStatusResult, 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

@@ -489,6 +489,57 @@ 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 } });
+  }
+  // Cortex (Pro+)
+  async cortexStatus() {
+    return this._request("GET", "/v1/cortex/status");
+  }
+  async cortexConfig() {
+    return this._request("GET", "/v1/cortex/config");
+  }
+  async cortexUpdateConfig(updates) {
+    return this._request("PATCH", "/v1/cortex/config", { body: updates });
+  }
+  async cortexRun() {
+    return this._request("POST", "/v1/cortex/run");
+  }
+  async cortexInsights(opts) {
+    return this._request("GET", "/v1/cortex/insights", {
+      params: { limit: opts?.limit ?? 20, offset: opts?.offset ?? 0 }
+    });
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -456,6 +456,57 @@ 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 } });
+  }
+  // Cortex (Pro+)
+  async cortexStatus() {
+    return this._request("GET", "/v1/cortex/status");
+  }
+  async cortexConfig() {
+    return this._request("GET", "/v1/cortex/config");
+  }
+  async cortexUpdateConfig(updates) {
+    return this._request("PATCH", "/v1/cortex/config", { body: updates });
+  }
+  async cortexRun() {
+    return this._request("POST", "/v1/cortex/run");
+  }
+  async cortexInsights(opts) {
+    return this._request("GET", "/v1/cortex/insights", {
+      params: { limit: opts?.limit ?? 20, offset: opts?.offset ?? 0 }
+    });
+  }
 };
 export {
   Novyx,

package/package.json

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