agentic-qe 2.8.0 → 2.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +105 -0
- package/README.md +1 -1
- package/dist/agents/BaseAgent.d.ts +128 -0
- package/dist/agents/BaseAgent.d.ts.map +1 -1
- package/dist/agents/BaseAgent.js +256 -0
- package/dist/agents/BaseAgent.js.map +1 -1
- package/dist/cli/commands/supabase/index.d.ts +20 -0
- package/dist/cli/commands/supabase/index.d.ts.map +1 -0
- package/dist/cli/commands/supabase/index.js +632 -0
- package/dist/cli/commands/supabase/index.js.map +1 -0
- package/dist/cli/index.js +3 -0
- package/dist/cli/index.js.map +1 -1
- package/dist/core/memory/HNSWVectorMemory.js +1 -1
- package/dist/mcp/handlers/NewDomainToolsHandler.d.ts +8 -8
- package/dist/mcp/handlers/NewDomainToolsHandler.d.ts.map +1 -1
- package/dist/mcp/handlers/NewDomainToolsHandler.js.map +1 -1
- package/dist/mcp/handlers/ruvector/RuVectorHandler.d.ts +54 -0
- package/dist/mcp/handlers/ruvector/RuVectorHandler.d.ts.map +1 -0
- package/dist/mcp/handlers/ruvector/RuVectorHandler.js +325 -0
- package/dist/mcp/handlers/ruvector/RuVectorHandler.js.map +1 -0
- package/dist/mcp/handlers/ruvector/index.d.ts +5 -0
- package/dist/mcp/handlers/ruvector/index.d.ts.map +1 -0
- package/dist/mcp/handlers/ruvector/index.js +9 -0
- package/dist/mcp/handlers/ruvector/index.js.map +1 -0
- package/dist/mcp/server-instructions.d.ts +1 -1
- package/dist/mcp/server-instructions.js +1 -1
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +100 -22
- package/dist/mcp/server.js.map +1 -1
- package/dist/nervous-system/adapters/BTSPAdapter.d.ts +342 -0
- package/dist/nervous-system/adapters/BTSPAdapter.d.ts.map +1 -0
- package/dist/nervous-system/adapters/BTSPAdapter.js +494 -0
- package/dist/nervous-system/adapters/BTSPAdapter.js.map +1 -0
- package/dist/nervous-system/adapters/CircadianController.d.ts +560 -0
- package/dist/nervous-system/adapters/CircadianController.d.ts.map +1 -0
- package/dist/nervous-system/adapters/CircadianController.js +882 -0
- package/dist/nervous-system/adapters/CircadianController.js.map +1 -0
- package/dist/nervous-system/adapters/GlobalWorkspaceAdapter.d.ts +337 -0
- package/dist/nervous-system/adapters/GlobalWorkspaceAdapter.d.ts.map +1 -0
- package/dist/nervous-system/adapters/GlobalWorkspaceAdapter.js +532 -0
- package/dist/nervous-system/adapters/GlobalWorkspaceAdapter.js.map +1 -0
- package/dist/nervous-system/adapters/HdcMemoryAdapter.d.ts +444 -0
- package/dist/nervous-system/adapters/HdcMemoryAdapter.d.ts.map +1 -0
- package/dist/nervous-system/adapters/HdcMemoryAdapter.js +715 -0
- package/dist/nervous-system/adapters/HdcMemoryAdapter.js.map +1 -0
- package/dist/nervous-system/adapters/ReflexLayer.d.ts +231 -0
- package/dist/nervous-system/adapters/ReflexLayer.d.ts.map +1 -0
- package/dist/nervous-system/adapters/ReflexLayer.js +309 -0
- package/dist/nervous-system/adapters/ReflexLayer.js.map +1 -0
- package/dist/nervous-system/index.d.ts +25 -0
- package/dist/nervous-system/index.d.ts.map +1 -0
- package/dist/nervous-system/index.js +80 -0
- package/dist/nervous-system/index.js.map +1 -0
- package/dist/nervous-system/integration/BTSPLearningEngine.d.ts +266 -0
- package/dist/nervous-system/integration/BTSPLearningEngine.d.ts.map +1 -0
- package/dist/nervous-system/integration/BTSPLearningEngine.js +587 -0
- package/dist/nervous-system/integration/BTSPLearningEngine.js.map +1 -0
- package/dist/nervous-system/integration/CircadianAgent.d.ts +389 -0
- package/dist/nervous-system/integration/CircadianAgent.d.ts.map +1 -0
- package/dist/nervous-system/integration/CircadianAgent.js +696 -0
- package/dist/nervous-system/integration/CircadianAgent.js.map +1 -0
- package/dist/nervous-system/integration/HybridPatternStore.d.ts +244 -0
- package/dist/nervous-system/integration/HybridPatternStore.d.ts.map +1 -0
- package/dist/nervous-system/integration/HybridPatternStore.js +622 -0
- package/dist/nervous-system/integration/HybridPatternStore.js.map +1 -0
- package/dist/nervous-system/integration/NervousSystemEnhancement.d.ts +459 -0
- package/dist/nervous-system/integration/NervousSystemEnhancement.d.ts.map +1 -0
- package/dist/nervous-system/integration/NervousSystemEnhancement.js +921 -0
- package/dist/nervous-system/integration/NervousSystemEnhancement.js.map +1 -0
- package/dist/nervous-system/integration/WorkspaceAgent.d.ts +398 -0
- package/dist/nervous-system/integration/WorkspaceAgent.d.ts.map +1 -0
- package/dist/nervous-system/integration/WorkspaceAgent.js +722 -0
- package/dist/nervous-system/integration/WorkspaceAgent.js.map +1 -0
- package/dist/nervous-system/integration/index.d.ts +22 -0
- package/dist/nervous-system/integration/index.d.ts.map +1 -0
- package/dist/nervous-system/integration/index.js +44 -0
- package/dist/nervous-system/integration/index.js.map +1 -0
- package/dist/nervous-system/persistence/BTSPSerializer.d.ts +96 -0
- package/dist/nervous-system/persistence/BTSPSerializer.d.ts.map +1 -0
- package/dist/nervous-system/persistence/BTSPSerializer.js +223 -0
- package/dist/nervous-system/persistence/BTSPSerializer.js.map +1 -0
- package/dist/nervous-system/persistence/CircadianSerializer.d.ts +90 -0
- package/dist/nervous-system/persistence/CircadianSerializer.d.ts.map +1 -0
- package/dist/nervous-system/persistence/CircadianSerializer.js +239 -0
- package/dist/nervous-system/persistence/CircadianSerializer.js.map +1 -0
- package/dist/nervous-system/persistence/HdcSerializer.d.ts +100 -0
- package/dist/nervous-system/persistence/HdcSerializer.d.ts.map +1 -0
- package/dist/nervous-system/persistence/HdcSerializer.js +259 -0
- package/dist/nervous-system/persistence/HdcSerializer.js.map +1 -0
- package/dist/nervous-system/persistence/INervousSystemStore.d.ts +208 -0
- package/dist/nervous-system/persistence/INervousSystemStore.d.ts.map +1 -0
- package/dist/nervous-system/persistence/INervousSystemStore.js +11 -0
- package/dist/nervous-system/persistence/INervousSystemStore.js.map +1 -0
- package/dist/nervous-system/persistence/NervousSystemPersistenceManager.d.ts +187 -0
- package/dist/nervous-system/persistence/NervousSystemPersistenceManager.d.ts.map +1 -0
- package/dist/nervous-system/persistence/NervousSystemPersistenceManager.js +411 -0
- package/dist/nervous-system/persistence/NervousSystemPersistenceManager.js.map +1 -0
- package/dist/nervous-system/persistence/SQLiteNervousSystemStore.d.ts +98 -0
- package/dist/nervous-system/persistence/SQLiteNervousSystemStore.d.ts.map +1 -0
- package/dist/nervous-system/persistence/SQLiteNervousSystemStore.js +510 -0
- package/dist/nervous-system/persistence/SQLiteNervousSystemStore.js.map +1 -0
- package/dist/nervous-system/persistence/index.d.ts +22 -0
- package/dist/nervous-system/persistence/index.d.ts.map +1 -0
- package/dist/nervous-system/persistence/index.js +45 -0
- package/dist/nervous-system/persistence/index.js.map +1 -0
- package/dist/nervous-system/wasm-loader.d.ts +52 -0
- package/dist/nervous-system/wasm-loader.d.ts.map +1 -0
- package/dist/nervous-system/wasm-loader.js +188 -0
- package/dist/nervous-system/wasm-loader.js.map +1 -0
- package/dist/persistence/HybridPersistenceProvider.d.ts +184 -0
- package/dist/persistence/HybridPersistenceProvider.d.ts.map +1 -0
- package/dist/persistence/HybridPersistenceProvider.js +1086 -0
- package/dist/persistence/HybridPersistenceProvider.js.map +1 -0
- package/dist/persistence/IPersistenceProvider.d.ts +657 -0
- package/dist/persistence/IPersistenceProvider.d.ts.map +1 -0
- package/dist/persistence/IPersistenceProvider.js +11 -0
- package/dist/persistence/IPersistenceProvider.js.map +1 -0
- package/dist/persistence/SupabaseConfig.d.ts +176 -0
- package/dist/persistence/SupabaseConfig.d.ts.map +1 -0
- package/dist/persistence/SupabaseConfig.js +277 -0
- package/dist/persistence/SupabaseConfig.js.map +1 -0
- package/dist/persistence/SupabasePersistenceProvider.d.ts +143 -0
- package/dist/persistence/SupabasePersistenceProvider.d.ts.map +1 -0
- package/dist/persistence/SupabasePersistenceProvider.js +955 -0
- package/dist/persistence/SupabasePersistenceProvider.js.map +1 -0
- package/dist/persistence/adapters/CodeIntelligenceSyncAdapter.d.ts +213 -0
- package/dist/persistence/adapters/CodeIntelligenceSyncAdapter.d.ts.map +1 -0
- package/dist/persistence/adapters/CodeIntelligenceSyncAdapter.js +468 -0
- package/dist/persistence/adapters/CodeIntelligenceSyncAdapter.js.map +1 -0
- package/dist/persistence/adapters/MemorySyncAdapter.d.ts +115 -0
- package/dist/persistence/adapters/MemorySyncAdapter.d.ts.map +1 -0
- package/dist/persistence/adapters/MemorySyncAdapter.js +291 -0
- package/dist/persistence/adapters/MemorySyncAdapter.js.map +1 -0
- package/dist/persistence/adapters/index.d.ts +11 -0
- package/dist/persistence/adapters/index.d.ts.map +1 -0
- package/dist/persistence/adapters/index.js +20 -0
- package/dist/persistence/adapters/index.js.map +1 -0
- package/dist/persistence/index.d.ts +14 -0
- package/dist/persistence/index.d.ts.map +1 -1
- package/dist/persistence/index.js +36 -1
- package/dist/persistence/index.js.map +1 -1
- package/package.json +3 -1
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Nervous System State Store Interface
|
|
3
|
+
*
|
|
4
|
+
* Defines the contract for persisting nervous system component state.
|
|
5
|
+
* Implementations can store to SQLite, Supabase, file system, etc.
|
|
6
|
+
*
|
|
7
|
+
* @module nervous-system/persistence/INervousSystemStore
|
|
8
|
+
*/
|
|
9
|
+
import type { CircadianState, CircadianMetrics } from '../adapters/CircadianController.js';
|
|
10
|
+
/**
|
|
11
|
+
* Component types that can be persisted
|
|
12
|
+
*/
|
|
13
|
+
export type NervousSystemComponent = 'hdc' | 'btsp' | 'circadian' | 'workspace';
|
|
14
|
+
/**
|
|
15
|
+
* Serialized HDC state format
|
|
16
|
+
*/
|
|
17
|
+
export interface HdcSerializedState {
|
|
18
|
+
/** Schema version for migration support */
|
|
19
|
+
version: number;
|
|
20
|
+
/** Hypervector dimension (default 10000) */
|
|
21
|
+
dimension: number;
|
|
22
|
+
/** Codebook mappings: type -> hypervector bytes */
|
|
23
|
+
codebooks: {
|
|
24
|
+
type: Array<[string, Uint8Array]>;
|
|
25
|
+
domain: Array<[string, Uint8Array]>;
|
|
26
|
+
framework: Array<[string, Uint8Array]>;
|
|
27
|
+
};
|
|
28
|
+
/** Role vectors for structured encoding */
|
|
29
|
+
roleVectors: {
|
|
30
|
+
type: Uint8Array;
|
|
31
|
+
domain: Uint8Array;
|
|
32
|
+
content: Uint8Array;
|
|
33
|
+
framework: Uint8Array;
|
|
34
|
+
};
|
|
35
|
+
/** Stored patterns: key -> hypervector bytes */
|
|
36
|
+
patterns: Array<{
|
|
37
|
+
key: string;
|
|
38
|
+
vector: Uint8Array;
|
|
39
|
+
metadata?: Record<string, unknown>;
|
|
40
|
+
}>;
|
|
41
|
+
/** Timestamp of serialization */
|
|
42
|
+
serializedAt: number;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Serialized BTSP state format
|
|
46
|
+
*/
|
|
47
|
+
export interface BTSPSerializedState {
|
|
48
|
+
/** Schema version for migration support */
|
|
49
|
+
version: number;
|
|
50
|
+
/** Configuration used to create the adapter */
|
|
51
|
+
config: {
|
|
52
|
+
inputSize: number;
|
|
53
|
+
outputSize: number;
|
|
54
|
+
tau: number;
|
|
55
|
+
plateauThreshold: number;
|
|
56
|
+
ewcLambda: number;
|
|
57
|
+
maxCapacity: number;
|
|
58
|
+
};
|
|
59
|
+
/** BTSP layer weights (Float32Array serialized as base64 or array) */
|
|
60
|
+
weights: number[];
|
|
61
|
+
/** Fisher diagonal for EWC consolidation */
|
|
62
|
+
fisherDiagonal: number[];
|
|
63
|
+
/** Consolidated weight reference point */
|
|
64
|
+
consolidatedWeights: number[];
|
|
65
|
+
/** Number of associations stored */
|
|
66
|
+
associationCount: number;
|
|
67
|
+
/** Stored associations (pattern -> target) */
|
|
68
|
+
associations: Array<{
|
|
69
|
+
pattern: number[];
|
|
70
|
+
target: number[];
|
|
71
|
+
}>;
|
|
72
|
+
/** Timestamp of serialization */
|
|
73
|
+
serializedAt: number;
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Serialized Circadian state format
|
|
77
|
+
*/
|
|
78
|
+
export interface CircadianSerializedState {
|
|
79
|
+
/** Schema version for migration support */
|
|
80
|
+
version: number;
|
|
81
|
+
/** Current state snapshot */
|
|
82
|
+
state: CircadianState;
|
|
83
|
+
/** Accumulated metrics */
|
|
84
|
+
metrics: CircadianMetrics;
|
|
85
|
+
/** Last phase change timestamp */
|
|
86
|
+
lastPhaseChange: number;
|
|
87
|
+
/** Modulation start time (if active) */
|
|
88
|
+
modulationStartTime?: number;
|
|
89
|
+
/** Timestamp of serialization */
|
|
90
|
+
serializedAt: number;
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Metadata about stored state
|
|
94
|
+
*/
|
|
95
|
+
export interface StoredStateMetadata {
|
|
96
|
+
/** Agent ID that owns this state */
|
|
97
|
+
agentId: string;
|
|
98
|
+
/** Component type */
|
|
99
|
+
component: NervousSystemComponent;
|
|
100
|
+
/** Schema version */
|
|
101
|
+
version: number;
|
|
102
|
+
/** When the state was stored */
|
|
103
|
+
storedAt: Date;
|
|
104
|
+
/** When the state was last updated */
|
|
105
|
+
updatedAt: Date;
|
|
106
|
+
/** Size in bytes */
|
|
107
|
+
sizeBytes: number;
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Interface for nervous system state persistence
|
|
111
|
+
*
|
|
112
|
+
* Implementations should handle:
|
|
113
|
+
* - Binary data storage (for HDC/BTSP)
|
|
114
|
+
* - JSON data storage (for Circadian)
|
|
115
|
+
* - Atomic updates
|
|
116
|
+
* - Error recovery
|
|
117
|
+
*/
|
|
118
|
+
export interface INervousSystemStore {
|
|
119
|
+
/**
|
|
120
|
+
* Initialize the store (create tables, connect, etc.)
|
|
121
|
+
*/
|
|
122
|
+
initialize(): Promise<void>;
|
|
123
|
+
/**
|
|
124
|
+
* Shutdown the store gracefully
|
|
125
|
+
*/
|
|
126
|
+
shutdown(): Promise<void>;
|
|
127
|
+
/**
|
|
128
|
+
* Save HDC memory state
|
|
129
|
+
* @param agentId - Agent identifier
|
|
130
|
+
* @param state - Serialized HDC state
|
|
131
|
+
*/
|
|
132
|
+
saveHdcState(agentId: string, state: HdcSerializedState): Promise<void>;
|
|
133
|
+
/**
|
|
134
|
+
* Load HDC memory state
|
|
135
|
+
* @param agentId - Agent identifier
|
|
136
|
+
* @returns Serialized state or null if not found
|
|
137
|
+
*/
|
|
138
|
+
loadHdcState(agentId: string): Promise<HdcSerializedState | null>;
|
|
139
|
+
/**
|
|
140
|
+
* Delete HDC state for an agent
|
|
141
|
+
* @param agentId - Agent identifier
|
|
142
|
+
*/
|
|
143
|
+
deleteHdcState(agentId: string): Promise<void>;
|
|
144
|
+
/**
|
|
145
|
+
* Save BTSP learner state
|
|
146
|
+
* @param agentId - Agent identifier
|
|
147
|
+
* @param state - Serialized BTSP state
|
|
148
|
+
*/
|
|
149
|
+
saveBtspState(agentId: string, state: BTSPSerializedState): Promise<void>;
|
|
150
|
+
/**
|
|
151
|
+
* Load BTSP learner state
|
|
152
|
+
* @param agentId - Agent identifier
|
|
153
|
+
* @returns Serialized state or null if not found
|
|
154
|
+
*/
|
|
155
|
+
loadBtspState(agentId: string): Promise<BTSPSerializedState | null>;
|
|
156
|
+
/**
|
|
157
|
+
* Delete BTSP state for an agent
|
|
158
|
+
* @param agentId - Agent identifier
|
|
159
|
+
*/
|
|
160
|
+
deleteBtspState(agentId: string): Promise<void>;
|
|
161
|
+
/**
|
|
162
|
+
* Save circadian controller state
|
|
163
|
+
* @param agentId - Agent identifier
|
|
164
|
+
* @param state - Serialized circadian state
|
|
165
|
+
*/
|
|
166
|
+
saveCircadianState(agentId: string, state: CircadianSerializedState): Promise<void>;
|
|
167
|
+
/**
|
|
168
|
+
* Load circadian controller state
|
|
169
|
+
* @param agentId - Agent identifier
|
|
170
|
+
* @returns Serialized state or null if not found
|
|
171
|
+
*/
|
|
172
|
+
loadCircadianState(agentId: string): Promise<CircadianSerializedState | null>;
|
|
173
|
+
/**
|
|
174
|
+
* Delete circadian state for an agent
|
|
175
|
+
* @param agentId - Agent identifier
|
|
176
|
+
*/
|
|
177
|
+
deleteCircadianState(agentId: string): Promise<void>;
|
|
178
|
+
/**
|
|
179
|
+
* Delete all state for an agent
|
|
180
|
+
* @param agentId - Agent identifier
|
|
181
|
+
*/
|
|
182
|
+
deleteAllState(agentId: string): Promise<void>;
|
|
183
|
+
/**
|
|
184
|
+
* List all agents with stored state
|
|
185
|
+
* @returns Array of agent IDs
|
|
186
|
+
*/
|
|
187
|
+
listAgents(): Promise<string[]>;
|
|
188
|
+
/**
|
|
189
|
+
* Get metadata about stored state
|
|
190
|
+
* @param agentId - Agent identifier
|
|
191
|
+
* @param component - Optional: specific component
|
|
192
|
+
* @returns Metadata array
|
|
193
|
+
*/
|
|
194
|
+
getStateMetadata(agentId: string, component?: NervousSystemComponent): Promise<StoredStateMetadata[]>;
|
|
195
|
+
/**
|
|
196
|
+
* Get information about the store implementation
|
|
197
|
+
*/
|
|
198
|
+
getStoreInfo(): {
|
|
199
|
+
type: 'sqlite' | 'supabase' | 'file' | 'memory';
|
|
200
|
+
version: string;
|
|
201
|
+
location?: string;
|
|
202
|
+
};
|
|
203
|
+
}
|
|
204
|
+
/**
|
|
205
|
+
* Factory function type for creating stores
|
|
206
|
+
*/
|
|
207
|
+
export type NervousSystemStoreFactory = (config?: Record<string, unknown>) => INervousSystemStore;
|
|
208
|
+
//# sourceMappingURL=INervousSystemStore.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"INervousSystemStore.d.ts","sourceRoot":"","sources":["../../../src/nervous-system/persistence/INervousSystemStore.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Nervous System State Store Interface
|
|
4
|
+
*
|
|
5
|
+
* Defines the contract for persisting nervous system component state.
|
|
6
|
+
* Implementations can store to SQLite, Supabase, file system, etc.
|
|
7
|
+
*
|
|
8
|
+
* @module nervous-system/persistence/INervousSystemStore
|
|
9
|
+
*/
|
|
10
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
11
|
+
//# sourceMappingURL=INervousSystemStore.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"INervousSystemStore.js","sourceRoot":"","sources":["../../../src/nervous-system/persistence/INervousSystemStore.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Nervous System Persistence Manager
|
|
3
|
+
*
|
|
4
|
+
* Coordinates persistence across all nervous system components.
|
|
5
|
+
* Provides a unified API for saving and restoring agent nervous system state.
|
|
6
|
+
*
|
|
7
|
+
* @module nervous-system/persistence/NervousSystemPersistenceManager
|
|
8
|
+
*/
|
|
9
|
+
import { EventEmitter } from 'events';
|
|
10
|
+
import type { INervousSystemStore, NervousSystemComponent, HdcSerializedState, BTSPSerializedState, CircadianSerializedState, StoredStateMetadata } from './INervousSystemStore.js';
|
|
11
|
+
/**
|
|
12
|
+
* Configuration for NervousSystemPersistenceManager
|
|
13
|
+
*/
|
|
14
|
+
export interface NervousSystemPersistenceManagerConfig {
|
|
15
|
+
/** Store implementation to use */
|
|
16
|
+
store?: INervousSystemStore;
|
|
17
|
+
/** Auto-save interval in milliseconds (0 = disabled) */
|
|
18
|
+
autoSaveIntervalMs?: number;
|
|
19
|
+
/** Enable debug logging */
|
|
20
|
+
debug?: boolean;
|
|
21
|
+
/** Database path for default SQLite store */
|
|
22
|
+
dbPath?: string;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Events emitted by the persistence manager
|
|
26
|
+
*/
|
|
27
|
+
export interface PersistenceManagerEvents {
|
|
28
|
+
'state:saved': {
|
|
29
|
+
agentId: string;
|
|
30
|
+
component: NervousSystemComponent;
|
|
31
|
+
sizeBytes: number;
|
|
32
|
+
};
|
|
33
|
+
'state:loaded': {
|
|
34
|
+
agentId: string;
|
|
35
|
+
component: NervousSystemComponent;
|
|
36
|
+
};
|
|
37
|
+
'state:deleted': {
|
|
38
|
+
agentId: string;
|
|
39
|
+
component?: NervousSystemComponent;
|
|
40
|
+
};
|
|
41
|
+
'error': {
|
|
42
|
+
agentId: string;
|
|
43
|
+
operation: string;
|
|
44
|
+
error: Error;
|
|
45
|
+
};
|
|
46
|
+
'auto-save': {
|
|
47
|
+
agentId: string;
|
|
48
|
+
savedComponents: NervousSystemComponent[];
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Manages persistence of nervous system state across agents
|
|
53
|
+
*/
|
|
54
|
+
export declare class NervousSystemPersistenceManager extends EventEmitter {
|
|
55
|
+
private readonly logger;
|
|
56
|
+
private readonly config;
|
|
57
|
+
private store;
|
|
58
|
+
private initialized;
|
|
59
|
+
private autoSaveTimer;
|
|
60
|
+
private pendingStates;
|
|
61
|
+
private registeredAgents;
|
|
62
|
+
constructor(config?: NervousSystemPersistenceManagerConfig);
|
|
63
|
+
/**
|
|
64
|
+
* Initialize the persistence manager
|
|
65
|
+
*/
|
|
66
|
+
initialize(): Promise<void>;
|
|
67
|
+
/**
|
|
68
|
+
* Shutdown the persistence manager
|
|
69
|
+
*/
|
|
70
|
+
shutdown(): Promise<void>;
|
|
71
|
+
/**
|
|
72
|
+
* Ensure manager is initialized
|
|
73
|
+
*/
|
|
74
|
+
private ensureInitialized;
|
|
75
|
+
/**
|
|
76
|
+
* Save HDC memory state
|
|
77
|
+
*/
|
|
78
|
+
saveHdcState(agentId: string, state: HdcSerializedState): Promise<void>;
|
|
79
|
+
/**
|
|
80
|
+
* Load HDC memory state
|
|
81
|
+
*/
|
|
82
|
+
loadHdcState(agentId: string): Promise<HdcSerializedState | null>;
|
|
83
|
+
/**
|
|
84
|
+
* Save BTSP learner state
|
|
85
|
+
*/
|
|
86
|
+
saveBtspState(agentId: string, state: BTSPSerializedState): Promise<void>;
|
|
87
|
+
/**
|
|
88
|
+
* Load BTSP learner state
|
|
89
|
+
*/
|
|
90
|
+
loadBtspState(agentId: string): Promise<BTSPSerializedState | null>;
|
|
91
|
+
/**
|
|
92
|
+
* Save circadian controller state
|
|
93
|
+
*/
|
|
94
|
+
saveCircadianState(agentId: string, state: CircadianSerializedState): Promise<void>;
|
|
95
|
+
/**
|
|
96
|
+
* Load circadian controller state
|
|
97
|
+
*/
|
|
98
|
+
loadCircadianState(agentId: string): Promise<CircadianSerializedState | null>;
|
|
99
|
+
/**
|
|
100
|
+
* Save all nervous system state for an agent
|
|
101
|
+
*/
|
|
102
|
+
saveAllState(agentId: string, state: {
|
|
103
|
+
hdc?: HdcSerializedState;
|
|
104
|
+
btsp?: BTSPSerializedState;
|
|
105
|
+
circadian?: CircadianSerializedState;
|
|
106
|
+
}): Promise<void>;
|
|
107
|
+
/**
|
|
108
|
+
* Load all nervous system state for an agent
|
|
109
|
+
*/
|
|
110
|
+
loadAllState(agentId: string): Promise<{
|
|
111
|
+
hdc: HdcSerializedState | null;
|
|
112
|
+
btsp: BTSPSerializedState | null;
|
|
113
|
+
circadian: CircadianSerializedState | null;
|
|
114
|
+
}>;
|
|
115
|
+
/**
|
|
116
|
+
* Delete all state for an agent
|
|
117
|
+
*/
|
|
118
|
+
deleteAllState(agentId: string): Promise<void>;
|
|
119
|
+
/**
|
|
120
|
+
* List all agents with stored state
|
|
121
|
+
*/
|
|
122
|
+
listAgents(): Promise<string[]>;
|
|
123
|
+
/**
|
|
124
|
+
* Get metadata about stored state
|
|
125
|
+
*/
|
|
126
|
+
getStateMetadata(agentId: string, component?: NervousSystemComponent): Promise<StoredStateMetadata[]>;
|
|
127
|
+
/**
|
|
128
|
+
* Register an agent for auto-save
|
|
129
|
+
*/
|
|
130
|
+
registerForAutoSave(agentId: string): void;
|
|
131
|
+
/**
|
|
132
|
+
* Unregister an agent from auto-save
|
|
133
|
+
*/
|
|
134
|
+
unregisterFromAutoSave(agentId: string): void;
|
|
135
|
+
/**
|
|
136
|
+
* Queue state for auto-save
|
|
137
|
+
*/
|
|
138
|
+
queueStateForAutoSave(agentId: string, state: {
|
|
139
|
+
hdc?: HdcSerializedState;
|
|
140
|
+
btsp?: BTSPSerializedState;
|
|
141
|
+
circadian?: CircadianSerializedState;
|
|
142
|
+
}): void;
|
|
143
|
+
/**
|
|
144
|
+
* Start auto-save timer
|
|
145
|
+
*/
|
|
146
|
+
private startAutoSave;
|
|
147
|
+
/**
|
|
148
|
+
* Stop auto-save timer
|
|
149
|
+
*/
|
|
150
|
+
private stopAutoSave;
|
|
151
|
+
/**
|
|
152
|
+
* Flush all pending state to storage
|
|
153
|
+
*/
|
|
154
|
+
private flushPendingStates;
|
|
155
|
+
/**
|
|
156
|
+
* Get information about the underlying store
|
|
157
|
+
*/
|
|
158
|
+
getStoreInfo(): {
|
|
159
|
+
type: 'sqlite' | 'supabase' | 'file' | 'memory';
|
|
160
|
+
version: string;
|
|
161
|
+
location?: string;
|
|
162
|
+
};
|
|
163
|
+
/**
|
|
164
|
+
* Get statistics about the persistence manager
|
|
165
|
+
*/
|
|
166
|
+
getStats(): {
|
|
167
|
+
initialized: boolean;
|
|
168
|
+
registeredAgents: number;
|
|
169
|
+
pendingStates: number;
|
|
170
|
+
autoSaveEnabled: boolean;
|
|
171
|
+
autoSaveIntervalMs: number;
|
|
172
|
+
storeType: string;
|
|
173
|
+
};
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* Factory function to create persistence manager
|
|
177
|
+
*/
|
|
178
|
+
export declare function createNervousSystemPersistenceManager(config?: NervousSystemPersistenceManagerConfig): NervousSystemPersistenceManager;
|
|
179
|
+
/**
|
|
180
|
+
* Get or create shared persistence manager instance
|
|
181
|
+
*/
|
|
182
|
+
export declare function getSharedPersistenceManager(config?: NervousSystemPersistenceManagerConfig): Promise<NervousSystemPersistenceManager>;
|
|
183
|
+
/**
|
|
184
|
+
* Reset shared instance (for testing)
|
|
185
|
+
*/
|
|
186
|
+
export declare function resetSharedPersistenceManager(): Promise<void>;
|
|
187
|
+
//# sourceMappingURL=NervousSystemPersistenceManager.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"NervousSystemPersistenceManager.d.ts","sourceRoot":"","sources":["../../../src/nervous-system/persistence/NervousSystemPersistenceManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAIlC;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,kCAAkC;IAClC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,sBAAsB,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACzF,cAAc,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,sBAAsB,CAAA;KAAE,CAAC;IACvE,eAAe,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,sBAAsB,CAAA;KAAE,CAAC;IACzE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IAC9D,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,sBAAsB,EAAE,CAAA;KAAE,CAAC;CAC7E;AAWD;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,YAAY;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IACzE,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAA+B;IAGpD,OAAO,CAAC,aAAa,CAAwC;IAG7D,OAAO,CAAC,gBAAgB,CAA0B;gBAEtC,MAAM,GAAE,qCAA0C;IAmB9D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7E;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAqBvE;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/E;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAqBzE;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzF;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAqBnF;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;QACL,GAAG,CAAC,EAAE,kBAAkB,CAAC;QACzB,IAAI,CAAC,EAAE,mBAAmB,CAAC;QAC3B,SAAS,CAAC,EAAE,wBAAwB,CAAC;KACtC,GACA,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3C,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAAC;QAC/B,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;QACjC,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAAC;KAC5C,CAAC;IAYF;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrC;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,sBAAsB,GACjC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IASjC;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO1C;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7C;;OAEG;IACH,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;QACL,GAAG,CAAC,EAAE,kBAAkB,CAAC;QACzB,IAAI,CAAC,EAAE,mBAAmB,CAAC;QAC3B,SAAS,CAAC,EAAE,wBAAwB,CAAC;KACtC,GACA,IAAI;IAcP;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;YACW,kBAAkB;IAyChC;;OAEG;IACH,YAAY,IAAI;QACd,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;QAChD,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAID;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,OAAO,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;KACnB;CAUF;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,CAAC,EAAE,qCAAqC,GAC7C,+BAA+B,CAEjC;AAOD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,CAAC,EAAE,qCAAqC,GAC7C,OAAO,CAAC,+BAA+B,CAAC,CAM1C;AAED;;GAEG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAKnE"}
|