rax-flow-core 0.1.0

package/dist/memory/local-vector-store.js

@@ -0,0 +1,125 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+/**
+ * A lightweight, local vector store using Cosine Similarity.
+ * Suitable for small-to-medium datasets (thousands of records).
+ * Persists data to a simple JSON structure.
+ */
+export class LocalVectorStore {
+    persistPath;
+    documents = [];
+    vectors = [];
+    metadata = new Map();
+    constructor(persistPath) {
+        this.persistPath = persistPath;
+    }
+    async add(documents, vectors) {
+        if (documents.length !== vectors.length) {
+            throw new Error("Mismatched documents and vectors count.");
+        }
+        this.documents.push(...documents);
+        this.vectors.push(...vectors);
+        if (this.persistPath)
+            await this.save();
+    }
+    async search(queryVector, limit = 5) {
+        if (this.vectors.length === 0)
+            return [];
+        const results = this.vectors.map((vec, i) => {
+            const score = this.cosineSimilarity(queryVector, vec);
+            return { ...this.documents[i], score };
+        });
+        return results
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit);
+    }
+    async clear() {
+        this.documents = [];
+        this.vectors = [];
+        this.metadata.clear();
+        if (this.persistPath)
+            await this.save();
+    }
+    async delete(docIds) {
+        for (const id of docIds) {
+            const idx = this.documents.findIndex(d => d.id === id);
+            if (idx >= 0) {
+                this.documents.splice(idx, 1);
+                this.vectors.splice(idx, 1);
+                this.metadata.delete(id);
+            }
+        }
+        if (this.persistPath)
+            await this.save();
+    }
+    async searchByMetadata(metadata) {
+        return this.documents.filter(doc => {
+            const docMeta = this.metadata.get(doc.id) || {};
+            return Object.entries(metadata).every(([key, value]) => docMeta[key] === value);
+        }).map(doc => ({ ...doc, score: 1.0 }));
+    }
+    count() {
+        return this.documents.length;
+    }
+    getMetrics() {
+        return {
+            documentCount: this.documents.length,
+            vectorDimensions: this.vectors[0]?.length || 0
+        };
+    }
+    /**
+     * Calculates cosine similarity between two numeric vectors.
+     */
+    cosineSimilarity(vecA, vecB) {
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        // Using common length. Error check in a production environment.
+        const len = Math.min(vecA.length, vecB.length);
+        for (let i = 0; i < len; i++) {
+            dotProduct += vecA[i] * vecB[i];
+            normA += vecA[i] * vecA[i];
+            normB += vecB[i] * vecB[i];
+        }
+        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+        if (denominator === 0)
+            return 0;
+        return dotProduct / denominator;
+    }
+    /**
+     * Manually triggers a load from the persistence file.
+     */
+    async load() {
+        if (!this.persistPath)
+            return;
+        try {
+            const raw = await readFile(this.persistPath, "utf8");
+            const data = JSON.parse(raw);
+            this.documents = data.documents || [];
+            this.vectors = data.vectors || [];
+        }
+        catch {
+            // File might not exist yet, ignore
+            this.documents = [];
+            this.vectors = [];
+        }
+    }
+    /**
+     * Internal save to disk.
+     */
+    async save() {
+        if (!this.persistPath)
+            return;
+        try {
+            await mkdir(path.dirname(this.persistPath), { recursive: true });
+            await writeFile(this.persistPath, JSON.stringify({
+                documents: this.documents,
+                vectors: this.vectors
+            }));
+        }
+        catch (err) {
+            console.error("Failed to persist vector store:", err);
+        }
+    }
+}
+//# sourceMappingURL=local-vector-store.js.map

package/dist/memory/local-vector-store.js.map

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

package/dist/memory/memory-manager.d.ts

@@ -0,0 +1,42 @@
+import { IVectorStore, MemoryDocument, SearchResult } from "../types/contracts.js";
+import { GraphMemory } from "./graph-memory.js";
+export interface MemoryQuery {
+    text?: string;
+    vector?: number[];
+    metadata?: Record<string, unknown>;
+    limit?: number;
+}
+export interface MemoryStatistics {
+    totalDocuments: number;
+    totalNodes: number;
+    totalEdges: number;
+    lastUpdated: string;
+}
+/**
+ * MemoryManager coordinates Vector search and Graph traversal.
+ * This is the heart of QSGM, allowing for "logical navigation" of context.
+ */
+export declare class MemoryManager {
+    private vectorStore;
+    private graphMemory;
+    private stats;
+    constructor(vectorStore: IVectorStore, graphMemory: GraphMemory);
+    /**
+     * Retrieves context using a hybrid approach:
+     * 1. Find the most semantically relevant node via Vector Search.
+     * 2. Traverse the Graph from that node to find related concepts/actions/artifacts.
+     */
+    getQuantumContext(queryVector: number[], limit?: number): Promise<string>;
+    /**
+     * Records a new interaction in both stores.
+     */
+    remember(doc: MemoryDocument, vector: number[], relatedToId?: string): Promise<void>;
+    search(query: MemoryQuery): Promise<SearchResult[]>;
+    forget(docId: string): Promise<void>;
+    clear(): Promise<void>;
+    getGraphData(): any;
+    getStatistics(): MemoryStatistics;
+    batchRemember(docs: MemoryDocument[], vectors: number[][]): Promise<void>;
+    export(): Promise<any>;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAwB,MAAM,mBAAmB,CAAC;AAEtE,MAAM,WAAW,WAAW;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,aAAa;IASlB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IATvB,OAAO,CAAC,KAAK,CAKX;gBAGU,WAAW,EAAE,YAAY,EACzB,WAAW,EAAE,WAAW;IAGpC;;;;OAIG;IACU,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAazF;;OAEG;IACU,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BpF,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKnD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,YAAY,IAAI,GAAG;IAInB,aAAa,IAAI,gBAAgB;IAI3B,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;CAOtC"}

package/dist/memory/memory-manager.js

@@ -0,0 +1,98 @@
+/**
+ * MemoryManager coordinates Vector search and Graph traversal.
+ * This is the heart of QSGM, allowing for "logical navigation" of context.
+ */
+export class MemoryManager {
+    vectorStore;
+    graphMemory;
+    stats = {
+        totalDocuments: 0,
+        totalNodes: 0,
+        totalEdges: 0,
+        lastUpdated: new Date().toISOString()
+    };
+    constructor(vectorStore, graphMemory) {
+        this.vectorStore = vectorStore;
+        this.graphMemory = graphMemory;
+    }
+    /**
+     * Retrieves context using a hybrid approach:
+     * 1. Find the most semantically relevant node via Vector Search.
+     * 2. Traverse the Graph from that node to find related concepts/actions/artifacts.
+     */
+    async getQuantumContext(queryVector, limit = 3) {
+        const vectorResults = await this.vectorStore.search(queryVector, 1);
+        if (vectorResults.length === 0)
+            return "";
+        const seedNodeId = vectorResults[0].id;
+        const relatedNodes = this.graphMemory.traverse(seedNodeId, 2);
+        return relatedNodes
+            .map(node => `[QSGM_KNOWLEDGE] (${node.type.toUpperCase()})\n${node.content}`)
+            .join("\n\n");
+    }
+    /**
+     * Records a new interaction in both stores.
+     */
+    async remember(doc, vector, relatedToId) {
+        // 1. Add to Vector Store for semantic search
+        await this.vectorStore.add([doc], [vector]);
+        // 2. Add to Graph Memory for logical navigation
+        this.graphMemory.addNode({
+            id: doc.id,
+            type: "artifact",
+            content: doc.text,
+            metadata: doc.metadata,
+            timestamp: doc.timestamp
+        });
+        if (relatedToId) {
+            this.graphMemory.addEdge({
+                from: relatedToId,
+                to: doc.id,
+                type: "produced"
+            });
+        }
+        await this.graphMemory.save();
+        this.stats.totalDocuments++;
+        this.stats.totalNodes++;
+        this.stats.lastUpdated = new Date().toISOString();
+    }
+    async search(query) {
+        if (!query.vector)
+            return [];
+        return this.vectorStore.search(query.vector, query.limit || 5);
+    }
+    async forget(docId) {
+        if (this.vectorStore.delete) {
+            await this.vectorStore.delete([docId]);
+        }
+        this.graphMemory.removeNode(docId);
+        this.stats.totalDocuments = Math.max(0, this.stats.totalDocuments - 1);
+    }
+    async clear() {
+        this.stats = {
+            totalDocuments: 0,
+            totalNodes: 0,
+            totalEdges: 0,
+            lastUpdated: new Date().toISOString()
+        };
+    }
+    getGraphData() {
+        return this.graphMemory.getGraphData();
+    }
+    getStatistics() {
+        return { ...this.stats };
+    }
+    async batchRemember(docs, vectors) {
+        for (let i = 0; i < docs.length; i++) {
+            await this.remember(docs[i], vectors[i]);
+        }
+    }
+    async export() {
+        return {
+            graphs: this.getGraphData(),
+            timestamp: new Date().toISOString(),
+            stats: this.stats
+        };
+    }
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/memory/memory-manager.js.map

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

package/dist/metrics/metrics-engine.d.ts

@@ -0,0 +1,13 @@
+import { ExecutionMetrics } from "../types/contracts.js";
+export declare class MetricsEngine {
+    private readonly runs;
+    push(metrics: ExecutionMetrics): void;
+    summary(): {
+        totalRuns: number;
+        avgConfidence: number;
+        avgLatencyMs: number;
+        totalCostUsd: number;
+        interventionRate: number;
+    };
+}
+//# sourceMappingURL=metrics-engine.d.ts.map

package/dist/metrics/metrics-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-engine.d.ts","sourceRoot":"","sources":["../../src/metrics/metrics-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAE/C,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAIrC,OAAO,IAAI;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;CAuBF"}

package/dist/metrics/metrics-engine.js

@@ -0,0 +1,27 @@
+export class MetricsEngine {
+    runs = [];
+    push(metrics) {
+        this.runs.push(metrics);
+    }
+    summary() {
+        if (this.runs.length === 0) {
+            return { totalRuns: 0, avgConfidence: 0, avgLatencyMs: 0, totalCostUsd: 0, interventionRate: 0 };
+        }
+        const total = this.runs.length;
+        const sums = this.runs.reduce((acc, run) => {
+            acc.conf += run.confidence;
+            acc.lat += run.totalLatencyMs;
+            acc.cost += run.totalCostUsd;
+            acc.human += run.humanInterventionRequired ? 1 : 0;
+            return acc;
+        }, { conf: 0, lat: 0, cost: 0, human: 0 });
+        return {
+            totalRuns: total,
+            avgConfidence: sums.conf / total,
+            avgLatencyMs: sums.lat / total,
+            totalCostUsd: Number(sums.cost.toFixed(4)),
+            interventionRate: sums.human / total
+        };
+    }
+}
+//# sourceMappingURL=metrics-engine.js.map

package/dist/metrics/metrics-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-engine.js","sourceRoot":"","sources":["../../src/metrics/metrics-engine.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACP,IAAI,GAAuB,EAAE,CAAC;IAE/C,IAAI,CAAC,OAAyB;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QAOL,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;QACnG,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAC3B,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACX,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC;YAC3B,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC;YAC9B,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,YAAY,CAAC;YAC7B,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CACvC,CAAC;QACF,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,IAAI,CAAC,IAAI,GAAG,KAAK;YAChC,YAAY,EAAE,IAAI,CAAC,GAAG,GAAG,KAAK;YAC9B,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1C,gBAAgB,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK;SACrC,CAAC;IACJ,CAAC;CACF"}

package/dist/orchestrator/blueprint-committer.d.ts

@@ -0,0 +1,69 @@
+import { WorkflowGraph } from "../types/contracts.js";
+export interface BlueprintCommitOptions {
+    version?: string;
+    tags?: string[];
+    description?: string;
+}
+export interface Blueprint {
+    id: string;
+    version: string;
+    createdAt: string;
+    fitnessScore: number;
+    mutationType: string;
+    graph?: WorkflowGraph;
+    metadata?: Record<string, unknown>;
+    plan?: any;
+    status?: string;
+    approvals?: number;
+}
+export declare class BlueprintCommitter {
+    static readonly BASE_DIR: string;
+    private blueprints;
+    private history;
+    private approvalCount;
+    private templates;
+    createBlueprint(plan: any): Promise<Blueprint>;
+    validate(plan: any): Promise<{
+        isValid: boolean;
+        errors: string[];
+    }>;
+    save(blueprint: Blueprint, filePath?: string): Promise<void>;
+    retrieve(id: string): Promise<Blueprint | undefined>;
+    update(id: string, updates: Partial<Blueprint>): Promise<Blueprint | null>;
+    delete(id: string): Promise<boolean>;
+    submitForReview(blueprint: Blueprint | string): Promise<Blueprint | null>;
+    approve(idOrBlueprint: string | Blueprint, options?: Record<string, unknown>): Promise<Blueprint | null>;
+    reject(idOrBlueprint: string | Blueprint, feedback?: string): Promise<Blueprint | null>;
+    getApprovalCount(id: string): number;
+    commit(blueprintOrWorkflow: Blueprint | WorkflowGraph, message?: string): Promise<Blueprint | null>;
+    getHistory(id?: string): Promise<Blueprint[]>;
+    getRecent(count?: number): Promise<Blueprint[]>;
+    revert(id: string, steps?: number): Promise<Blueprint | null>;
+    rollback(id: string, toVersion?: string): Promise<Blueprint | null>;
+    diff(id1: string, id2: string): Promise<any>;
+    dryRun(blueprint: Blueprint): Promise<{
+        success: boolean;
+        results: any;
+        wouldCreate?: any[];
+        isValid?: boolean;
+        errors?: string[];
+    }>;
+    batchCommit(blueprintsOrWorkflows: Blueprint[] | WorkflowGraph[], messages?: string[]): Promise<Blueprint[] | {
+        committed: number;
+        failed: number;
+    }>;
+    batchValidate(blueprints: Blueprint[]): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    search(query: string): Promise<Blueprint[]>;
+    searchByStatus(status: string): Promise<Blueprint[]>;
+    getStatus(id: string): Promise<string | null>;
+    getMetrics(id: string): Promise<any>;
+    createTemplate(blueprint: Blueprint, options?: any): Promise<any>;
+    instantiateFromTemplate(templateId: string): Promise<Blueprint | null>;
+    analyzeExecution(blueprint: Blueprint, results: any): Promise<any>;
+    js(code: string): Promise<any>;
+    private incrementVersion;
+}
+//# sourceMappingURL=blueprint-committer.d.ts.map

package/dist/orchestrator/blueprint-committer.d.ts.map

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