ruvector 0.2.21 → 0.2.23

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.
Files changed (123) hide show
  1. package/README.md +2 -2
  2. package/bin/cli.js +160 -0
  3. package/package.json +9 -5
  4. package/src/decompiler/api-prober.js +302 -0
  5. package/src/decompiler/model-decompiler.js +423 -0
  6. package/dist/analysis/complexity.d.ts +0 -52
  7. package/dist/analysis/complexity.d.ts.map +0 -1
  8. package/dist/analysis/complexity.js +0 -146
  9. package/dist/analysis/index.d.ts +0 -15
  10. package/dist/analysis/index.d.ts.map +0 -1
  11. package/dist/analysis/index.js +0 -38
  12. package/dist/analysis/patterns.d.ts +0 -71
  13. package/dist/analysis/patterns.d.ts.map +0 -1
  14. package/dist/analysis/patterns.js +0 -243
  15. package/dist/analysis/security.d.ts +0 -51
  16. package/dist/analysis/security.d.ts.map +0 -1
  17. package/dist/analysis/security.js +0 -139
  18. package/dist/core/adaptive-embedder.d.ts +0 -156
  19. package/dist/core/adaptive-embedder.d.ts.map +0 -1
  20. package/dist/core/adaptive-embedder.js +0 -838
  21. package/dist/core/agentdb-fast.d.ts +0 -149
  22. package/dist/core/agentdb-fast.d.ts.map +0 -1
  23. package/dist/core/agentdb-fast.js +0 -301
  24. package/dist/core/ast-parser.d.ts +0 -108
  25. package/dist/core/ast-parser.d.ts.map +0 -1
  26. package/dist/core/ast-parser.js +0 -602
  27. package/dist/core/attention-fallbacks.d.ts +0 -321
  28. package/dist/core/attention-fallbacks.d.ts.map +0 -1
  29. package/dist/core/attention-fallbacks.js +0 -552
  30. package/dist/core/cluster-wrapper.d.ts +0 -148
  31. package/dist/core/cluster-wrapper.d.ts.map +0 -1
  32. package/dist/core/cluster-wrapper.js +0 -271
  33. package/dist/core/coverage-router.d.ts +0 -88
  34. package/dist/core/coverage-router.d.ts.map +0 -1
  35. package/dist/core/coverage-router.js +0 -315
  36. package/dist/core/diff-embeddings.d.ts +0 -93
  37. package/dist/core/diff-embeddings.d.ts.map +0 -1
  38. package/dist/core/diff-embeddings.js +0 -334
  39. package/dist/core/gnn-wrapper.d.ts +0 -143
  40. package/dist/core/gnn-wrapper.d.ts.map +0 -1
  41. package/dist/core/gnn-wrapper.js +0 -213
  42. package/dist/core/graph-algorithms.d.ts +0 -83
  43. package/dist/core/graph-algorithms.d.ts.map +0 -1
  44. package/dist/core/graph-algorithms.js +0 -514
  45. package/dist/core/graph-wrapper.d.ts +0 -147
  46. package/dist/core/graph-wrapper.d.ts.map +0 -1
  47. package/dist/core/graph-wrapper.js +0 -299
  48. package/dist/core/index.d.ts +0 -48
  49. package/dist/core/index.d.ts.map +0 -1
  50. package/dist/core/index.js +0 -89
  51. package/dist/core/intelligence-engine.d.ts +0 -258
  52. package/dist/core/intelligence-engine.d.ts.map +0 -1
  53. package/dist/core/intelligence-engine.js +0 -1030
  54. package/dist/core/learning-engine.d.ts +0 -160
  55. package/dist/core/learning-engine.d.ts.map +0 -1
  56. package/dist/core/learning-engine.js +0 -589
  57. package/dist/core/neural-embeddings.d.ts +0 -393
  58. package/dist/core/neural-embeddings.d.ts.map +0 -1
  59. package/dist/core/neural-embeddings.js +0 -1091
  60. package/dist/core/neural-perf.d.ts +0 -331
  61. package/dist/core/neural-perf.d.ts.map +0 -1
  62. package/dist/core/neural-perf.js +0 -704
  63. package/dist/core/onnx/loader.js +0 -348
  64. package/dist/core/onnx/pkg/LICENSE +0 -21
  65. package/dist/core/onnx/pkg/loader.js +0 -348
  66. package/dist/core/onnx/pkg/package.json +0 -3
  67. package/dist/core/onnx/pkg/ruvector_onnx_embeddings_wasm.d.ts +0 -112
  68. package/dist/core/onnx/pkg/ruvector_onnx_embeddings_wasm.js +0 -5
  69. package/dist/core/onnx/pkg/ruvector_onnx_embeddings_wasm_bg.js +0 -638
  70. package/dist/core/onnx/pkg/ruvector_onnx_embeddings_wasm_bg.wasm +0 -0
  71. package/dist/core/onnx/pkg/ruvector_onnx_embeddings_wasm_bg.wasm.d.ts +0 -29
  72. package/dist/core/onnx/pkg/ruvector_onnx_embeddings_wasm_cjs.js +0 -127
  73. package/dist/core/onnx-embedder.d.ts +0 -105
  74. package/dist/core/onnx-embedder.d.ts.map +0 -1
  75. package/dist/core/onnx-embedder.js +0 -410
  76. package/dist/core/onnx-llm.d.ts +0 -206
  77. package/dist/core/onnx-llm.d.ts.map +0 -1
  78. package/dist/core/onnx-llm.js +0 -430
  79. package/dist/core/onnx-optimized.d.ts +0 -109
  80. package/dist/core/onnx-optimized.d.ts.map +0 -1
  81. package/dist/core/onnx-optimized.js +0 -419
  82. package/dist/core/parallel-intelligence.d.ts +0 -109
  83. package/dist/core/parallel-intelligence.d.ts.map +0 -1
  84. package/dist/core/parallel-intelligence.js +0 -340
  85. package/dist/core/parallel-workers.d.ts +0 -177
  86. package/dist/core/parallel-workers.d.ts.map +0 -1
  87. package/dist/core/parallel-workers.js +0 -671
  88. package/dist/core/router-wrapper.d.ts +0 -62
  89. package/dist/core/router-wrapper.d.ts.map +0 -1
  90. package/dist/core/router-wrapper.js +0 -209
  91. package/dist/core/rvf-wrapper.d.ts +0 -86
  92. package/dist/core/rvf-wrapper.d.ts.map +0 -1
  93. package/dist/core/rvf-wrapper.js +0 -102
  94. package/dist/core/sona-wrapper.d.ts +0 -226
  95. package/dist/core/sona-wrapper.d.ts.map +0 -1
  96. package/dist/core/sona-wrapper.js +0 -282
  97. package/dist/core/tensor-compress.d.ts +0 -134
  98. package/dist/core/tensor-compress.d.ts.map +0 -1
  99. package/dist/core/tensor-compress.js +0 -432
  100. package/dist/index.d.ts +0 -105
  101. package/dist/index.d.ts.map +0 -1
  102. package/dist/index.js +0 -221
  103. package/dist/services/embedding-service.d.ts +0 -136
  104. package/dist/services/embedding-service.d.ts.map +0 -1
  105. package/dist/services/embedding-service.js +0 -294
  106. package/dist/services/index.d.ts +0 -6
  107. package/dist/services/index.d.ts.map +0 -1
  108. package/dist/services/index.js +0 -26
  109. package/dist/types.d.ts +0 -145
  110. package/dist/types.d.ts.map +0 -1
  111. package/dist/types.js +0 -2
  112. package/dist/workers/benchmark.d.ts +0 -44
  113. package/dist/workers/benchmark.d.ts.map +0 -1
  114. package/dist/workers/benchmark.js +0 -230
  115. package/dist/workers/index.d.ts +0 -10
  116. package/dist/workers/index.d.ts.map +0 -1
  117. package/dist/workers/index.js +0 -25
  118. package/dist/workers/native-worker.d.ts +0 -76
  119. package/dist/workers/native-worker.d.ts.map +0 -1
  120. package/dist/workers/native-worker.js +0 -490
  121. package/dist/workers/types.d.ts +0 -69
  122. package/dist/workers/types.d.ts.map +0 -1
  123. package/dist/workers/types.js +0 -7
@@ -1,62 +0,0 @@
1
- /**
2
- * Router Wrapper - Semantic router for AI agent intent matching
3
- *
4
- * Wraps @ruvector/router for vector-based intent classification.
5
- * Perfect for hooks to route tasks to the right agent.
6
- */
7
- export declare function isRouterAvailable(): boolean;
8
- export interface Route {
9
- name: string;
10
- utterances: string[];
11
- metadata?: Record<string, any>;
12
- }
13
- export interface RouteMatch {
14
- route: string;
15
- score: number;
16
- metadata?: Record<string, any>;
17
- }
18
- /**
19
- * Semantic Router for agent task routing
20
- */
21
- export declare class SemanticRouter {
22
- private inner;
23
- private routes;
24
- constructor(options?: {
25
- dimensions?: number;
26
- threshold?: number;
27
- });
28
- /**
29
- * Add a route with example utterances
30
- */
31
- addRoute(name: string, utterances: string[], metadata?: Record<string, any>): void;
32
- /**
33
- * Add multiple routes at once
34
- */
35
- addRoutes(routes: Route[]): void;
36
- /**
37
- * Match input to best route
38
- */
39
- match(input: string): RouteMatch | null;
40
- /**
41
- * Get top-k route matches
42
- */
43
- matchTopK(input: string, k?: number): RouteMatch[];
44
- /**
45
- * Get all registered routes
46
- */
47
- getRoutes(): Route[];
48
- /**
49
- * Remove a route
50
- */
51
- removeRoute(name: string): boolean;
52
- /**
53
- * Clear all routes
54
- */
55
- clear(): void;
56
- }
57
- /**
58
- * Create a pre-configured agent router for hooks
59
- */
60
- export declare function createAgentRouter(): SemanticRouter;
61
- export default SemanticRouter;
62
- //# sourceMappingURL=router-wrapper.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"router-wrapper.d.ts","sourceRoot":"","sources":["../../src/core/router-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,MAAM,CAAiC;gBAEnC,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAQrE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKlF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAMhC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAWvC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,GAAG,UAAU,EAAE;IASrD;;OAEG;IACH,SAAS,IAAI,KAAK,EAAE;IAIpB;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMlC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CA8FlD;AAED,eAAe,cAAc,CAAC"}
@@ -1,209 +0,0 @@
1
- "use strict";
2
- /**
3
- * Router Wrapper - Semantic router for AI agent intent matching
4
- *
5
- * Wraps @ruvector/router for vector-based intent classification.
6
- * Perfect for hooks to route tasks to the right agent.
7
- */
8
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.SemanticRouter = void 0;
10
- exports.isRouterAvailable = isRouterAvailable;
11
- exports.createAgentRouter = createAgentRouter;
12
- let routerModule = null;
13
- let loadError = null;
14
- function getRouterModule() {
15
- if (routerModule)
16
- return routerModule;
17
- if (loadError)
18
- throw loadError;
19
- try {
20
- routerModule = require('@ruvector/router');
21
- return routerModule;
22
- }
23
- catch (e) {
24
- loadError = new Error(`@ruvector/router not installed: ${e.message}\n` +
25
- `Install with: npm install @ruvector/router`);
26
- throw loadError;
27
- }
28
- }
29
- function isRouterAvailable() {
30
- try {
31
- getRouterModule();
32
- return true;
33
- }
34
- catch {
35
- return false;
36
- }
37
- }
38
- /**
39
- * Semantic Router for agent task routing
40
- */
41
- class SemanticRouter {
42
- constructor(options = {}) {
43
- this.routes = new Map();
44
- const router = getRouterModule();
45
- this.inner = new router.SemanticRouter({
46
- dimensions: options.dimensions ?? 384,
47
- threshold: options.threshold ?? 0.7,
48
- });
49
- }
50
- /**
51
- * Add a route with example utterances
52
- */
53
- addRoute(name, utterances, metadata) {
54
- this.routes.set(name, { name, utterances, metadata });
55
- this.inner.addRoute(name, utterances, metadata ? JSON.stringify(metadata) : undefined);
56
- }
57
- /**
58
- * Add multiple routes at once
59
- */
60
- addRoutes(routes) {
61
- for (const route of routes) {
62
- this.addRoute(route.name, route.utterances, route.metadata);
63
- }
64
- }
65
- /**
66
- * Match input to best route
67
- */
68
- match(input) {
69
- const result = this.inner.match(input);
70
- if (!result)
71
- return null;
72
- return {
73
- route: result.route,
74
- score: result.score,
75
- metadata: result.metadata ? JSON.parse(result.metadata) : undefined,
76
- };
77
- }
78
- /**
79
- * Get top-k route matches
80
- */
81
- matchTopK(input, k = 3) {
82
- const results = this.inner.matchTopK(input, k);
83
- return results.map((r) => ({
84
- route: r.route,
85
- score: r.score,
86
- metadata: r.metadata ? JSON.parse(r.metadata) : undefined,
87
- }));
88
- }
89
- /**
90
- * Get all registered routes
91
- */
92
- getRoutes() {
93
- return Array.from(this.routes.values());
94
- }
95
- /**
96
- * Remove a route
97
- */
98
- removeRoute(name) {
99
- if (!this.routes.has(name))
100
- return false;
101
- this.routes.delete(name);
102
- return this.inner.removeRoute(name);
103
- }
104
- /**
105
- * Clear all routes
106
- */
107
- clear() {
108
- this.routes.clear();
109
- this.inner.clear();
110
- }
111
- }
112
- exports.SemanticRouter = SemanticRouter;
113
- /**
114
- * Create a pre-configured agent router for hooks
115
- */
116
- function createAgentRouter() {
117
- const router = new SemanticRouter({ threshold: 0.6 });
118
- // Add common agent routes
119
- router.addRoutes([
120
- {
121
- name: 'coder',
122
- utterances: [
123
- 'implement feature',
124
- 'write code',
125
- 'create function',
126
- 'add method',
127
- 'build component',
128
- 'fix bug',
129
- 'update implementation',
130
- ],
131
- metadata: { type: 'development' },
132
- },
133
- {
134
- name: 'reviewer',
135
- utterances: [
136
- 'review code',
137
- 'check quality',
138
- 'find issues',
139
- 'suggest improvements',
140
- 'analyze code',
141
- 'code review',
142
- ],
143
- metadata: { type: 'review' },
144
- },
145
- {
146
- name: 'tester',
147
- utterances: [
148
- 'write tests',
149
- 'add test cases',
150
- 'create unit tests',
151
- 'test coverage',
152
- 'integration tests',
153
- 'verify functionality',
154
- ],
155
- metadata: { type: 'testing' },
156
- },
157
- {
158
- name: 'researcher',
159
- utterances: [
160
- 'research topic',
161
- 'find information',
162
- 'explore options',
163
- 'investigate',
164
- 'analyze requirements',
165
- 'understand codebase',
166
- ],
167
- metadata: { type: 'research' },
168
- },
169
- {
170
- name: 'architect',
171
- utterances: [
172
- 'design system',
173
- 'architecture',
174
- 'structure project',
175
- 'plan implementation',
176
- 'design patterns',
177
- 'system design',
178
- ],
179
- metadata: { type: 'architecture' },
180
- },
181
- {
182
- name: 'devops',
183
- utterances: [
184
- 'deploy',
185
- 'ci/cd',
186
- 'docker',
187
- 'kubernetes',
188
- 'infrastructure',
189
- 'build pipeline',
190
- 'github actions',
191
- ],
192
- metadata: { type: 'devops' },
193
- },
194
- {
195
- name: 'security',
196
- utterances: [
197
- 'security audit',
198
- 'vulnerability',
199
- 'authentication',
200
- 'authorization',
201
- 'secure code',
202
- 'penetration test',
203
- ],
204
- metadata: { type: 'security' },
205
- },
206
- ]);
207
- return router;
208
- }
209
- exports.default = SemanticRouter;
@@ -1,86 +0,0 @@
1
- /**
2
- * RVF Wrapper - Persistent vector store via @ruvector/rvf
3
- *
4
- * Wraps @ruvector/rvf RvfDatabase through thin convenience functions.
5
- * Falls back to clear error messages when the package is not installed.
6
- */
7
- export declare function isRvfAvailable(): boolean;
8
- export interface RvfStoreOptions {
9
- dimensions: number;
10
- metric?: 'l2' | 'cosine' | 'dotproduct';
11
- compression?: 'none' | 'scalar' | 'product';
12
- m?: number;
13
- efConstruction?: number;
14
- }
15
- export interface RvfEntry {
16
- id: string;
17
- vector: Float32Array | number[];
18
- metadata?: Record<string, any>;
19
- }
20
- export interface RvfResult {
21
- id: string;
22
- distance: number;
23
- }
24
- export interface RvfStoreStatus {
25
- totalVectors: number;
26
- totalSegments: number;
27
- fileSizeBytes: number;
28
- epoch: number;
29
- compactionState: string;
30
- deadSpaceRatio: number;
31
- readOnly: boolean;
32
- }
33
- export interface RvfQueryOpts {
34
- efSearch?: number;
35
- filter?: any;
36
- timeoutMs?: number;
37
- }
38
- export type RvfStore = any;
39
- /**
40
- * Create a new RVF store at the given path.
41
- */
42
- export declare function createRvfStore(path: string, options: RvfStoreOptions): Promise<RvfStore>;
43
- /**
44
- * Open an existing RVF store for read-write access.
45
- */
46
- export declare function openRvfStore(path: string): Promise<RvfStore>;
47
- /**
48
- * Ingest a batch of vectors into an open store.
49
- */
50
- export declare function rvfIngest(store: RvfStore, entries: RvfEntry[]): Promise<{
51
- accepted: number;
52
- rejected: number;
53
- epoch: number;
54
- }>;
55
- /**
56
- * Query for the k nearest neighbors.
57
- */
58
- export declare function rvfQuery(store: RvfStore, vector: Float32Array | number[], k: number, options?: RvfQueryOpts): Promise<RvfResult[]>;
59
- /**
60
- * Soft-delete vectors by their IDs.
61
- */
62
- export declare function rvfDelete(store: RvfStore, ids: string[]): Promise<{
63
- deleted: number;
64
- epoch: number;
65
- }>;
66
- /**
67
- * Get the current store status.
68
- */
69
- export declare function rvfStatus(store: RvfStore): Promise<RvfStoreStatus>;
70
- /**
71
- * Run compaction to reclaim dead space.
72
- */
73
- export declare function rvfCompact(store: RvfStore): Promise<{
74
- segmentsCompacted: number;
75
- bytesReclaimed: number;
76
- epoch: number;
77
- }>;
78
- /**
79
- * Derive a child store from a parent for lineage tracking.
80
- */
81
- export declare function rvfDerive(store: RvfStore, childPath: string): Promise<RvfStore>;
82
- /**
83
- * Close the store, releasing the writer lock and flushing data.
84
- */
85
- export declare function rvfClose(store: RvfStore): Promise<void>;
86
- //# sourceMappingURL=rvf-wrapper.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"rvf-wrapper.d.ts","sourceRoot":"","sources":["../../src/core/rvf-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,wBAAgB,cAAc,IAAI,OAAO,CAOxC;AAMD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,YAAY,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC;AAM3B;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC,CAGnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,EAC/B,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,SAAS,EAAE,CAAC,CAEtB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAE7C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAExE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAE/E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D"}
@@ -1,102 +0,0 @@
1
- "use strict";
2
- /**
3
- * RVF Wrapper - Persistent vector store via @ruvector/rvf
4
- *
5
- * Wraps @ruvector/rvf RvfDatabase through thin convenience functions.
6
- * Falls back to clear error messages when the package is not installed.
7
- */
8
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.isRvfAvailable = isRvfAvailable;
10
- exports.createRvfStore = createRvfStore;
11
- exports.openRvfStore = openRvfStore;
12
- exports.rvfIngest = rvfIngest;
13
- exports.rvfQuery = rvfQuery;
14
- exports.rvfDelete = rvfDelete;
15
- exports.rvfStatus = rvfStatus;
16
- exports.rvfCompact = rvfCompact;
17
- exports.rvfDerive = rvfDerive;
18
- exports.rvfClose = rvfClose;
19
- let rvfModule = null;
20
- let loadError = null;
21
- function getRvfModule() {
22
- if (rvfModule)
23
- return rvfModule;
24
- if (loadError)
25
- throw loadError;
26
- try {
27
- rvfModule = require('@ruvector/rvf');
28
- return rvfModule;
29
- }
30
- catch (e) {
31
- loadError = new Error('@ruvector/rvf is not installed. Run: npm install @ruvector/rvf');
32
- throw loadError;
33
- }
34
- }
35
- function isRvfAvailable() {
36
- try {
37
- getRvfModule();
38
- return true;
39
- }
40
- catch {
41
- return false;
42
- }
43
- }
44
- // ---------------------------------------------------------------------------
45
- // Wrapper functions
46
- // ---------------------------------------------------------------------------
47
- /**
48
- * Create a new RVF store at the given path.
49
- */
50
- async function createRvfStore(path, options) {
51
- const mod = getRvfModule();
52
- return mod.RvfDatabase.create(path, options);
53
- }
54
- /**
55
- * Open an existing RVF store for read-write access.
56
- */
57
- async function openRvfStore(path) {
58
- const mod = getRvfModule();
59
- return mod.RvfDatabase.open(path);
60
- }
61
- /**
62
- * Ingest a batch of vectors into an open store.
63
- */
64
- async function rvfIngest(store, entries) {
65
- return store.ingestBatch(entries);
66
- }
67
- /**
68
- * Query for the k nearest neighbors.
69
- */
70
- async function rvfQuery(store, vector, k, options) {
71
- return store.query(vector, k, options);
72
- }
73
- /**
74
- * Soft-delete vectors by their IDs.
75
- */
76
- async function rvfDelete(store, ids) {
77
- return store.delete(ids);
78
- }
79
- /**
80
- * Get the current store status.
81
- */
82
- async function rvfStatus(store) {
83
- return store.status();
84
- }
85
- /**
86
- * Run compaction to reclaim dead space.
87
- */
88
- async function rvfCompact(store) {
89
- return store.compact();
90
- }
91
- /**
92
- * Derive a child store from a parent for lineage tracking.
93
- */
94
- async function rvfDerive(store, childPath) {
95
- return store.derive(childPath);
96
- }
97
- /**
98
- * Close the store, releasing the writer lock and flushing data.
99
- */
100
- async function rvfClose(store) {
101
- return store.close();
102
- }
@@ -1,226 +0,0 @@
1
- /**
2
- * SONA Wrapper - Self-Optimizing Neural Architecture
3
- *
4
- * Provides a safe, flexible interface to @ruvector/sona with:
5
- * - Automatic array type conversion (Array <-> Float64Array)
6
- * - Graceful handling when sona is not installed
7
- * - TypeScript types for all APIs
8
- *
9
- * SONA Features:
10
- * - Micro-LoRA: Ultra-fast rank-1/2 adaptations (~0.1ms)
11
- * - Base-LoRA: Deeper adaptations for complex patterns
12
- * - EWC++: Elastic Weight Consolidation to prevent catastrophic forgetting
13
- * - ReasoningBank: Pattern storage and retrieval
14
- * - Trajectory tracking: Record and learn from execution paths
15
- */
16
- /** Array input type - accepts both regular arrays and typed arrays */
17
- export type ArrayInput = number[] | Float32Array | Float64Array;
18
- /** SONA configuration options */
19
- export interface SonaConfig {
20
- /** Hidden dimension size (required) */
21
- hiddenDim: number;
22
- /** Embedding dimension (defaults to hiddenDim) */
23
- embeddingDim?: number;
24
- /** Micro-LoRA rank (1-2, default: 1) */
25
- microLoraRank?: number;
26
- /** Base LoRA rank (default: 8) */
27
- baseLoraRank?: number;
28
- /** Micro-LoRA learning rate (default: 0.001) */
29
- microLoraLr?: number;
30
- /** Base LoRA learning rate (default: 0.0001) */
31
- baseLoraLr?: number;
32
- /** EWC lambda regularization (default: 1000.0) */
33
- ewcLambda?: number;
34
- /** Number of pattern clusters (default: 50) */
35
- patternClusters?: number;
36
- /** Trajectory buffer capacity (default: 10000) */
37
- trajectoryCapacity?: number;
38
- /** Background learning interval in ms (default: 3600000 = 1 hour) */
39
- backgroundIntervalMs?: number;
40
- /** Quality threshold for learning (default: 0.5) */
41
- qualityThreshold?: number;
42
- /** Enable SIMD optimizations (default: true) */
43
- enableSimd?: boolean;
44
- }
45
- /** Learned pattern from ReasoningBank */
46
- export interface LearnedPattern {
47
- /** Pattern identifier */
48
- id: string;
49
- /** Cluster centroid embedding */
50
- centroid: number[];
51
- /** Number of trajectories in cluster */
52
- clusterSize: number;
53
- /** Total weight of trajectories */
54
- totalWeight: number;
55
- /** Average quality of member trajectories */
56
- avgQuality: number;
57
- /** Creation timestamp */
58
- createdAt: string;
59
- /** Last access timestamp */
60
- lastAccessed: string;
61
- /** Total access count */
62
- accessCount: number;
63
- /** Pattern type */
64
- patternType: string;
65
- }
66
- /** SONA engine statistics */
67
- export interface SonaStats {
68
- trajectoriesRecorded: number;
69
- patternsLearned: number;
70
- microLoraUpdates: number;
71
- baseLoraUpdates: number;
72
- ewcConsolidations: number;
73
- avgLearningTimeMs: number;
74
- }
75
- /** Check if sona is available */
76
- export declare function isSonaAvailable(): boolean;
77
- /**
78
- * SONA Engine - Self-Optimizing Neural Architecture
79
- *
80
- * Provides runtime-adaptive learning with:
81
- * - Micro-LoRA for instant adaptations
82
- * - Base-LoRA for deeper learning
83
- * - EWC++ for preventing forgetting
84
- * - ReasoningBank for pattern storage
85
- *
86
- * @example
87
- * ```typescript
88
- * import { Sona } from 'ruvector';
89
- *
90
- * // Create engine with hidden dimension
91
- * const engine = new Sona.Engine(256);
92
- *
93
- * // Or with custom config
94
- * const engine = Sona.Engine.withConfig({
95
- * hiddenDim: 256,
96
- * microLoraRank: 2,
97
- * patternClusters: 100
98
- * });
99
- *
100
- * // Record a trajectory
101
- * const trajId = engine.beginTrajectory([0.1, 0.2, ...]);
102
- * engine.addStep(trajId, activations, attentionWeights, 0.8);
103
- * engine.endTrajectory(trajId, 0.9);
104
- *
105
- * // Apply learned adaptations
106
- * const adapted = engine.applyMicroLora(input);
107
- * ```
108
- */
109
- export declare class SonaEngine {
110
- private _native;
111
- /**
112
- * Create a new SONA engine
113
- * @param hiddenDim Hidden dimension size (e.g., 256, 512, 768)
114
- */
115
- constructor(hiddenDim: number);
116
- /**
117
- * Create engine with custom configuration
118
- * @param config SONA configuration options
119
- */
120
- static withConfig(config: SonaConfig): SonaEngine;
121
- /**
122
- * Begin recording a new trajectory
123
- * @param queryEmbedding Initial query embedding
124
- * @returns Trajectory ID for subsequent operations
125
- */
126
- beginTrajectory(queryEmbedding: ArrayInput): number;
127
- /**
128
- * Add a step to an active trajectory
129
- * @param trajectoryId Trajectory ID from beginTrajectory
130
- * @param activations Layer activations
131
- * @param attentionWeights Attention weights
132
- * @param reward Reward signal for this step (0.0 - 1.0)
133
- */
134
- addStep(trajectoryId: number, activations: ArrayInput, attentionWeights: ArrayInput, reward: number): void;
135
- /**
136
- * Alias for addStep for API compatibility
137
- */
138
- addTrajectoryStep(trajectoryId: number, activations: ArrayInput, attentionWeights: ArrayInput, reward: number): void;
139
- /**
140
- * Set the model route for a trajectory
141
- * @param trajectoryId Trajectory ID
142
- * @param route Model route identifier (e.g., "gpt-4", "claude-3")
143
- */
144
- setRoute(trajectoryId: number, route: string): void;
145
- /**
146
- * Add context to a trajectory
147
- * @param trajectoryId Trajectory ID
148
- * @param contextId Context identifier
149
- */
150
- addContext(trajectoryId: number, contextId: string): void;
151
- /**
152
- * Complete a trajectory and submit for learning
153
- * @param trajectoryId Trajectory ID
154
- * @param quality Final quality score (0.0 - 1.0)
155
- */
156
- endTrajectory(trajectoryId: number, quality: number): void;
157
- /**
158
- * Apply micro-LoRA transformation (ultra-fast, ~0.1ms)
159
- * @param input Input vector
160
- * @returns Transformed output vector
161
- */
162
- applyMicroLora(input: ArrayInput): number[];
163
- /**
164
- * Apply base-LoRA transformation to a specific layer
165
- * @param layerIdx Layer index
166
- * @param input Input vector
167
- * @returns Transformed output vector
168
- */
169
- applyBaseLora(layerIdx: number, input: ArrayInput): number[];
170
- /**
171
- * Run background learning cycle if due
172
- * Call this periodically (e.g., every few seconds)
173
- * @returns Status message if learning occurred, null otherwise
174
- */
175
- tick(): string | null;
176
- /**
177
- * Force immediate background learning cycle
178
- * @returns Status message with learning results
179
- */
180
- forceLearn(): string;
181
- /**
182
- * Flush pending instant loop updates
183
- */
184
- flush(): void;
185
- /**
186
- * Find similar learned patterns to a query
187
- * @param queryEmbedding Query embedding
188
- * @param k Number of patterns to return
189
- * @returns Array of similar patterns
190
- */
191
- findPatterns(queryEmbedding: ArrayInput, k: number): LearnedPattern[];
192
- /**
193
- * Get engine statistics
194
- * @returns Statistics object
195
- */
196
- getStats(): SonaStats;
197
- /**
198
- * Save engine state to JSON string for persistence across restarts (fixes #274)
199
- * @returns State JSON that can be stored to disk/database
200
- */
201
- saveState(): string;
202
- /**
203
- * Restore engine state from JSON saved by saveState() (fixes #274)
204
- * @param stateJson - JSON string from a previous saveState() call
205
- * @returns Number of patterns restored
206
- */
207
- loadState(stateJson: string): number;
208
- /**
209
- * Enable or disable the engine
210
- * @param enabled Whether to enable
211
- */
212
- setEnabled(enabled: boolean): void;
213
- /**
214
- * Check if engine is enabled
215
- */
216
- isEnabled(): boolean;
217
- }
218
- /**
219
- * SONA namespace with all exports
220
- */
221
- export declare const Sona: {
222
- Engine: typeof SonaEngine;
223
- isAvailable: typeof isSonaAvailable;
224
- };
225
- export default Sona;
226
- //# sourceMappingURL=sona-wrapper.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sona-wrapper.d.ts","sourceRoot":"","sources":["../../src/core/sona-wrapper.ts"],"names":[],"mappings":"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"}