helixmind 0.5.4

package/dist/storage/nodes.js

@@ -0,0 +1,161 @@
+import { randomUUID } from 'node:crypto';
+import { estimateTokens } from '../utils/tokens.js';
+function safeParseJson(raw, fallback = {}) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+function rowToNode(row) {
+    return {
+        id: row.id,
+        type: row.type,
+        content: row.content,
+        summary: row.summary,
+        level: row.level,
+        relevance_score: row.relevance_score,
+        token_count: row.token_count,
+        metadata: safeParseJson(row.metadata),
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+        accessed_at: row.accessed_at,
+    };
+}
+export class NodeStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(input) {
+        const id = randomUUID();
+        const now = Date.now();
+        const tokenCount = estimateTokens(input.content);
+        this.db.raw.prepare(`
+      INSERT INTO nodes (id, type, content, content_hash, summary, level, relevance_score, token_count, metadata, created_at, updated_at, accessed_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(id, input.type, input.content, input.content_hash ?? null, input.summary ?? null, input.level ?? 1, input.relevance_score ?? 1.0, tokenCount, JSON.stringify(input.metadata), now, now, now);
+        return {
+            id,
+            type: input.type,
+            content: input.content,
+            summary: input.summary ?? null,
+            level: (input.level ?? 1),
+            relevance_score: input.relevance_score ?? 1.0,
+            token_count: tokenCount,
+            metadata: input.metadata,
+            created_at: now,
+            updated_at: now,
+            accessed_at: now,
+        };
+    }
+    /**
+     * Find a node by its content hash (for deduplication).
+     * Returns null if no matching node exists.
+     */
+    findByContentHash(hash) {
+        const row = this.db.raw.prepare('SELECT * FROM nodes WHERE content_hash = ? LIMIT 1').get(hash);
+        return row ? rowToNode(row) : null;
+    }
+    /**
+     * Update an existing node's content, metadata, and access time (for dedup refresh).
+     */
+    refreshNode(id, content, metadata, contentHash) {
+        const now = Date.now();
+        const tokenCount = estimateTokens(content);
+        this.db.raw.prepare(`
+      UPDATE nodes SET content = ?, content_hash = ?, token_count = ?, metadata = ?, updated_at = ?, accessed_at = ?
+      WHERE id = ?
+    `).run(content, contentHash, tokenCount, JSON.stringify(metadata), now, now, id);
+    }
+    /** Check if a node exists without updating accessed_at (for internal lookups) */
+    exists(id) {
+        const row = this.db.raw.prepare('SELECT 1 FROM nodes WHERE id = ? LIMIT 1').get(id);
+        return !!row;
+    }
+    getById(id) {
+        const row = this.db.raw.prepare('SELECT * FROM nodes WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        // Update accessed_at
+        const now = Date.now();
+        this.db.raw.prepare('UPDATE nodes SET accessed_at = ? WHERE id = ?').run(now, id);
+        return rowToNode({ ...row, accessed_at: now });
+    }
+    getByLevel(level) {
+        const rows = this.db.raw.prepare('SELECT * FROM nodes WHERE level = ? ORDER BY relevance_score DESC').all(level);
+        return rows.map(rowToNode);
+    }
+    getAll() {
+        const rows = this.db.raw.prepare('SELECT * FROM nodes ORDER BY relevance_score DESC').all();
+        return rows.map(rowToNode);
+    }
+    /** Return IDs of the most recently accessed nodes (bounded). */
+    getRecentIds(limit) {
+        const rows = this.db.raw.prepare('SELECT id FROM nodes ORDER BY accessed_at DESC LIMIT ?').all(limit);
+        return rows.map(r => r.id);
+    }
+    getByIds(ids) {
+        if (ids.length === 0)
+            return [];
+        const placeholders = ids.map(() => '?').join(',');
+        const rows = this.db.raw.prepare(`SELECT * FROM nodes WHERE id IN (${placeholders})`).all(...ids);
+        return rows.map(rowToNode);
+    }
+    updateLevel(id, level) {
+        this.db.raw.prepare('UPDATE nodes SET level = ?, updated_at = ? WHERE id = ?').run(level, Date.now(), id);
+    }
+    updateRelevance(id, score) {
+        this.db.raw.prepare('UPDATE nodes SET relevance_score = ?, updated_at = ? WHERE id = ?').run(score, Date.now(), id);
+    }
+    updateSummary(id, summary) {
+        this.db.raw.prepare('UPDATE nodes SET summary = ?, updated_at = ? WHERE id = ?').run(summary, Date.now(), id);
+    }
+    count() {
+        const row = this.db.raw.prepare('SELECT COUNT(*) as cnt FROM nodes').get();
+        return row.cnt;
+    }
+    countByLevel() {
+        const rows = this.db.raw.prepare('SELECT level, COUNT(*) as cnt FROM nodes GROUP BY level').all();
+        const result = { 1: 0, 2: 0, 3: 0, 4: 0, 5: 0 };
+        for (const row of rows) {
+            result[row.level] = row.cnt;
+        }
+        return result;
+    }
+    /** Count web knowledge nodes (L2 nodes with [Web Knowledge: prefix) */
+    countWebKnowledge() {
+        const row = this.db.raw.prepare("SELECT COUNT(*) as cnt FROM nodes WHERE content LIKE '[Web Knowledge:%'").get();
+        return row.cnt;
+    }
+    getOldestAndNewest() {
+        const row = this.db.raw.prepare('SELECT MIN(created_at) as oldest, MAX(created_at) as newest FROM nodes').get();
+        return { oldest: row.oldest, newest: row.newest };
+    }
+    delete(id) {
+        this.db.raw.prepare('DELETE FROM nodes WHERE id = ?').run(id);
+    }
+    /**
+     * Get nodes that need decay (accessed more than `hours` ago).
+     */
+    getStaleNodes(hoursThreshold) {
+        const cutoff = Date.now() - hoursThreshold * 60 * 60 * 1000;
+        const rows = this.db.raw.prepare('SELECT * FROM nodes WHERE accessed_at < ? AND level < 5 ORDER BY accessed_at ASC').all(cutoff);
+        return rows.map(rowToNode);
+    }
+    /**
+     * Bulk update relevance scores. Used by decay function.
+     */
+    bulkUpdateRelevance(updates) {
+        const stmt = this.db.raw.prepare('UPDATE nodes SET relevance_score = ?, level = ?, updated_at = ? WHERE id = ?');
+        const now = Date.now();
+        const transaction = this.db.raw.transaction((items) => {
+            for (const item of items) {
+                stmt.run(item.score, item.level, now, item.id);
+            }
+        });
+        transaction(updates);
+    }
+}
+//# sourceMappingURL=nodes.js.map

package/dist/storage/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/storage/nodes.ts"],"names":[],"mappings":"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"}

package/dist/storage/vectors.d.ts

@@ -0,0 +1,25 @@
+import type { Database } from './database.js';
+import type { VectorSearchResult } from '../types.js';
+/**
+ * Handles vector storage and similarity search.
+ * Uses sqlite-vec extension when available, falls back to JS-based cosine similarity.
+ */
+export declare class VectorStore {
+    private db;
+    private dimensions;
+    private useVec;
+    constructor(db: Database, dimensions: number);
+    private initialize;
+    private createFallbackTable;
+    store(nodeId: string, embedding: Float32Array): void;
+    search(queryEmbedding: Float32Array, limit: number): VectorSearchResult[];
+    private searchVec;
+    private searchFallback;
+    delete(nodeId: string): void;
+    /**
+     * Computes cosine similarity between two vectors.
+     * Returns value in range [-1, 1] where 1 = identical.
+     */
+    static cosineSimilarity(a: Float32Array, b: Float32Array): number;
+}
+//# sourceMappingURL=vectors.d.ts.map

package/dist/storage/vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../../src/storage/vectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAU;gBAEZ,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM;IAQ5C,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,mBAAmB;IAS3B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI;IAUpD,MAAM,CAAC,cAAc,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE;IASzE,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,cAAc;IAmBtB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM;CAalE"}

package/dist/storage/vectors.js

@@ -0,0 +1,110 @@
+import { logger } from '../utils/logger.js';
+/**
+ * Handles vector storage and similarity search.
+ * Uses sqlite-vec extension when available, falls back to JS-based cosine similarity.
+ */
+export class VectorStore {
+    db;
+    dimensions;
+    useVec;
+    constructor(db, dimensions) {
+        this.db = db;
+        this.dimensions = dimensions;
+        this.useVec = db.hasVecExtension;
+        this.initialize();
+    }
+    initialize() {
+        if (this.useVec) {
+            try {
+                this.db.raw.exec(`
+          CREATE VIRTUAL TABLE IF NOT EXISTS vec_nodes USING vec0(
+            node_id TEXT PRIMARY KEY,
+            embedding float[${this.dimensions}] distance_metric=cosine
+          );
+        `);
+                logger.debug('vec_nodes virtual table created');
+            }
+            catch (err) {
+                logger.warn(`Failed to create vec0 table, using fallback: ${err}`);
+                this.useVec = false;
+                this.createFallbackTable();
+            }
+        }
+        else {
+            this.createFallbackTable();
+        }
+    }
+    createFallbackTable() {
+        this.db.raw.exec(`
+      CREATE TABLE IF NOT EXISTS embeddings (
+        node_id TEXT PRIMARY KEY,
+        embedding BLOB NOT NULL
+      );
+    `);
+    }
+    store(nodeId, embedding) {
+        const buffer = Buffer.from(embedding.buffer, embedding.byteOffset, embedding.byteLength);
+        if (this.useVec) {
+            this.db.raw.prepare('INSERT OR REPLACE INTO vec_nodes (node_id, embedding) VALUES (?, ?)').run(nodeId, buffer);
+        }
+        else {
+            this.db.raw.prepare('INSERT OR REPLACE INTO embeddings (node_id, embedding) VALUES (?, ?)').run(nodeId, buffer);
+        }
+    }
+    search(queryEmbedding, limit) {
+        const buffer = Buffer.from(queryEmbedding.buffer, queryEmbedding.byteOffset, queryEmbedding.byteLength);
+        if (this.useVec) {
+            return this.searchVec(buffer, limit);
+        }
+        return this.searchFallback(queryEmbedding, limit);
+    }
+    searchVec(queryBuffer, limit) {
+        const rows = this.db.raw.prepare(`
+      SELECT node_id, distance
+      FROM vec_nodes
+      WHERE embedding MATCH ?
+        AND k = ?
+      ORDER BY distance
+    `).all(queryBuffer, limit);
+        return rows.map(r => ({ node_id: r.node_id, distance: r.distance }));
+    }
+    searchFallback(queryEmbedding, limit) {
+        const rows = this.db.raw.prepare('SELECT node_id, embedding FROM embeddings').all();
+        const results = rows.map(row => {
+            const stored = new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.byteLength / 4);
+            const similarity = VectorStore.cosineSimilarity(queryEmbedding, stored);
+            // Convert similarity (1=identical) to distance (0=identical) for consistent API
+            return { node_id: row.node_id, distance: 1 - similarity };
+        });
+        return results
+            .sort((a, b) => a.distance - b.distance)
+            .slice(0, limit);
+    }
+    delete(nodeId) {
+        if (this.useVec) {
+            this.db.raw.prepare('DELETE FROM vec_nodes WHERE node_id = ?').run(nodeId);
+        }
+        else {
+            this.db.raw.prepare('DELETE FROM embeddings WHERE node_id = ?').run(nodeId);
+        }
+    }
+    /**
+     * Computes cosine similarity between two vectors.
+     * Returns value in range [-1, 1] where 1 = identical.
+     */
+    static cosineSimilarity(a, b) {
+        let dot = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dot += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+        if (denominator === 0)
+            return 0;
+        return dot / denominator;
+    }
+}
+//# sourceMappingURL=vectors.js.map

package/dist/storage/vectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.js","sourceRoot":"","sources":["../../src/storage/vectors.ts"],"names":[],"mappings":"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"}

package/dist/tools/spiral-compact.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { SpiralEngine } from '../spiral/engine.js';
+export declare const spiralCompactSchema: {
+    aggressive: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function handleSpiralCompact(engine: SpiralEngine, args: {
+    aggressive?: boolean;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=spiral-compact.d.ts.map

package/dist/tools/spiral-compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-compact.d.ts","sourceRoot":"","sources":["../../src/tools/spiral-compact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,mBAAmB;;CAE/B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;GAU/B"}

package/dist/tools/spiral-compact.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const spiralCompactSchema = {
+    aggressive: z.boolean().optional().describe('If true, more aggressive compaction thresholds'),
+};
+export async function handleSpiralCompact(engine, args) {
+    const result = engine.compact(args.aggressive ?? false);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-compact.js.map

package/dist/tools/spiral-compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-compact.js","sourceRoot":"","sources":["../../src/tools/spiral-compact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAC9F,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAoB,EACpB,IAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC;IAExD,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/spiral-query.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { SpiralEngine } from '../spiral/engine.js';
+export declare const spiralQuerySchema: {
+    query: z.ZodString;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+    levels: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+};
+export declare function handleSpiralQuery(engine: SpiralEngine, args: {
+    query: string;
+    max_tokens?: number;
+    levels?: number[];
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=spiral-query.d.ts.map

package/dist/tools/spiral-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-query.d.ts","sourceRoot":"","sources":["../../src/tools/spiral-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;;;;;GAUhE"}

package/dist/tools/spiral-query.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export const spiralQuerySchema = {
+    query: z.string().describe('What context to search for'),
+    max_tokens: z.number().optional().describe('Maximum tokens to return (default: 4000)'),
+    levels: z.array(z.number().min(1).max(5)).optional().describe('Which levels to include (default: [1,2,3,4,5])'),
+};
+export async function handleSpiralQuery(engine, args) {
+    const result = await engine.query(args.query, args.max_tokens, args.levels);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-query.js.map

package/dist/tools/spiral-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-query.js","sourceRoot":"","sources":["../../src/tools/spiral-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACxD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACtF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAChH,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,IAA+D;IAE/D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5E,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/spiral-relate.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { SpiralEngine } from '../spiral/engine.js';
+import type { RelationType } from '../types.js';
+export declare const spiralRelateSchema: {
+    source_id: z.ZodString;
+    target_id: z.ZodString;
+    type: z.ZodEnum<["depends_on", "related_to", "caused_by", "fixes", "supersedes", "part_of"]>;
+    weight: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handleSpiralRelate(engine: SpiralEngine, args: {
+    source_id: string;
+    target_id: string;
+    type: RelationType;
+    weight?: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=spiral-relate.d.ts.map

package/dist/tools/spiral-relate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-relate.d.ts","sourceRoot":"","sources":["../../src/tools/spiral-relate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IACJ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;;;;;GAcF"}

package/dist/tools/spiral-relate.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export const spiralRelateSchema = {
+    source_id: z.string().describe('Source node ID'),
+    target_id: z.string().describe('Target node ID'),
+    type: z.enum(['depends_on', 'related_to', 'caused_by', 'fixes', 'supersedes', 'part_of']).describe('Relation type'),
+    weight: z.number().min(0).max(1).optional().describe('Relation strength (0.0–1.0, default: 1.0)'),
+};
+export async function handleSpiralRelate(engine, args) {
+    const edge = engine.relate(args.source_id, args.target_id, args.type, args.weight);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    edge_id: edge.id,
+                    source_id: edge.source_id,
+                    target_id: edge.target_id,
+                }, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-relate.js.map

package/dist/tools/spiral-relate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-relate.js","sourceRoot":"","sources":["../../src/tools/spiral-relate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;IACnH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAClG,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,IAKC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnF,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,IAAI,CAAC,EAAE;oBAChB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,EAAE,IAAI,EAAE,CAAC,CAAC;aACZ,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/spiral-status.d.ts

@@ -0,0 +1,8 @@
+import type { SpiralEngine } from '../spiral/engine.js';
+export declare function handleSpiralStatus(engine: SpiralEngine): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=spiral-status.d.ts.map

package/dist/tools/spiral-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-status.d.ts","sourceRoot":"","sources":["../../src/tools/spiral-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY;;;;;GAS5D"}

package/dist/tools/spiral-status.js

@@ -0,0 +1,10 @@
+export async function handleSpiralStatus(engine) {
+    const result = engine.status();
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-status.js.map

package/dist/tools/spiral-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-status.js","sourceRoot":"","sources":["../../src/tools/spiral-status.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAoB;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;IAE/B,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/spiral-store.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import type { SpiralEngine } from '../spiral/engine.js';
+import type { ContextType } from '../types.js';
+export declare const spiralStoreSchema: {
+    content: z.ZodString;
+    type: z.ZodEnum<["code", "decision", "error", "pattern", "architecture"]>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        function: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        function?: string | undefined;
+        file?: string | undefined;
+        language?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        function?: string | undefined;
+        file?: string | undefined;
+        language?: string | undefined;
+        tags?: string[] | undefined;
+    }>>;
+    relations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare function handleSpiralStore(engine: SpiralEngine, args: {
+    content: string;
+    type: ContextType;
+    metadata?: {
+        file?: string;
+        function?: string;
+        language?: string;
+        tags?: string[];
+    };
+    relations?: string[];
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=spiral-store.d.ts.map

package/dist/tools/spiral-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-store.d.ts","sourceRoot":"","sources":["../../src/tools/spiral-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;CAU7B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;;;;;GAUF"}

package/dist/tools/spiral-store.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export const spiralStoreSchema = {
+    content: z.string().describe('The context content to store'),
+    type: z.enum(['code', 'decision', 'error', 'pattern', 'architecture']).describe('Type of context'),
+    metadata: z.object({
+        file: z.string().optional(),
+        function: z.string().optional(),
+        language: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+    }).optional().describe('Optional metadata'),
+    relations: z.array(z.string()).optional().describe('IDs of related context nodes'),
+};
+export async function handleSpiralStore(engine, args) {
+    const result = await engine.store(args.content, args.type, args.metadata, args.relations);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-store.js.map

package/dist/tools/spiral-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-store.js","sourceRoot":"","sources":["../../src/tools/spiral-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAClG,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACrC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CACnF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,IAKC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAE1F,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;KACH,CAAC;AACJ,CAAC"}