rax-flow-core 0.1.0

package/dist/cache/semantic-cache.d.ts

@@ -0,0 +1,10 @@
+export declare class SemanticCache {
+    private readonly store;
+    get<T>(key: string, ttlMs?: number): T | undefined;
+    set<T>(key: string, value: T): void;
+    makeKey(intent: string, prompt: string): string;
+    loadFromFile(filePath: string): Promise<void>;
+    saveToFile(filePath: string): Promise<void>;
+    clear(): void;
+}
+//# sourceMappingURL=semantic-cache.d.ts.map

package/dist/cache/semantic-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-cache.d.ts","sourceRoot":"","sources":["../../src/cache/semantic-cache.ts"],"names":[],"mappings":"AAcA,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAEhE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAUlD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAInC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAKzC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD,KAAK,IAAI,IAAI;CAGd"}

package/dist/cache/semantic-cache.js

@@ -0,0 +1,50 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export class SemanticCache {
+    store = new Map();
+    get(key, ttlMs) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return undefined;
+        if (ttlMs && Date.now() - entry.createdAt > ttlMs) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(key, value) {
+        this.store.set(key, { key, value, createdAt: Date.now() });
+    }
+    makeKey(intent, prompt) {
+        const compact = prompt.trim().toLowerCase().replace(/\s+/g, " ");
+        return `${intent}:${compact.slice(0, 400)}`;
+    }
+    async loadFromFile(filePath) {
+        try {
+            const raw = await readFile(filePath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (parsed.version !== 1)
+                return;
+            this.store.clear();
+            for (const entry of parsed.entries) {
+                this.store.set(entry.key, entry);
+            }
+        }
+        catch {
+            // no cache yet
+        }
+    }
+    async saveToFile(filePath) {
+        await mkdir(path.dirname(filePath), { recursive: true });
+        const entries = Array.from(this.store.values());
+        const body = {
+            version: 1,
+            entries
+        };
+        await writeFile(filePath, `${JSON.stringify(body, null, 2)}\n`, "utf8");
+    }
+    clear() {
+        this.store.clear();
+    }
+}
+//# sourceMappingURL=semantic-cache.js.map

package/dist/cache/semantic-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-cache.js","sourceRoot":"","sources":["../../src/cache/semantic-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B,MAAM,OAAO,aAAa;IACP,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEhE,GAAG,CAAI,GAAW,EAAE,KAAc;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,MAAc;QACpC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjE,OAAO,GAAG,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;YACtD,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;gBAAE,OAAO;YACjC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,MAAM,IAAI,GAAwB;YAChC,OAAO,EAAE,CAAC;YACV,OAAO;SACR,CAAC;QACF,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/governance/policies/pii-policy.d.ts

@@ -0,0 +1,37 @@
+import { Policy } from "../../plugins/governance-plugin.js";
+import { AgentInput, AgentOutput, PolicyDecision } from "../../types/contracts.js";
+interface PIIPolicyConfig {
+    patterns?: Record<string, RegExp>;
+    detectors?: Record<string, boolean>;
+}
+interface DetectedPII {
+    type: string;
+    value: string;
+    position: number;
+}
+/**
+ * PIIPolicy scans inputs and outputs for sensitive information like emails,
+ * phone numbers, and API keys using regex patterns.
+ */
+export declare class PIIPolicy implements Policy {
+    name: string;
+    private config;
+    private auditLogs;
+    private patterns;
+    constructor(config?: PIIPolicyConfig);
+    scan(text: string): DetectedPII[];
+    redact(text: string): string;
+    redactJSON(obj: any): any;
+    mask(text: string, type: string): string;
+    scanStructured(data: any): DetectedPII[];
+    scanArray(data: string[]): DetectedPII[];
+    generateReport(): {
+        totalDetected: number;
+        categories: Record<string, number>;
+    };
+    getAuditLogs(): string[];
+    validateInput(input: AgentInput): Promise<PolicyDecision>;
+    validateOutput(output: AgentOutput): Promise<PolicyDecision>;
+}
+export {};
+//# sourceMappingURL=pii-policy.d.ts.map

package/dist/governance/policies/pii-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pii-policy.d.ts","sourceRoot":"","sources":["../../../src/governance/policies/pii-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAmB,MAAM,0BAA0B,CAAC;AAEpG,UAAU,eAAe;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,SAAU,YAAW,MAAM;IAC7B,IAAI,SAAoB;IAE/B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAgB;IAEjC,OAAO,CAAC,QAAQ,CAOd;gBAEU,MAAM,GAAE,eAAoB;IAOxC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;IAqBjC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAgB5B,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG;IAoBzB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAcxC,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,WAAW,EAAE;IAoBxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE;IASxC,cAAc;;;;IAgBd,YAAY,IAAI,MAAM,EAAE;IAIlB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAiCzD,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAmBrE"}

package/dist/governance/policies/pii-policy.js

@@ -0,0 +1,177 @@
+/**
+ * PIIPolicy scans inputs and outputs for sensitive information like emails,
+ * phone numbers, and API keys using regex patterns.
+ */
+export class PIIPolicy {
+    name = "PII_Protection";
+    config;
+    auditLogs = [];
+    patterns = {
+        email: /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,
+        apiKey: /(?:sk-(?:proj-)?|key-|auth-|ghp_|glpat-)[a-zA-Z0-9]{16,}/gi,
+        phone: /\+?\d{10,15}|(\d{3}[-.]?\d{3}[-.]?\d{4})/g,
+        ssn: /\d{3}-\d{2}-\d{4}/g,
+        credit_card: /\d{4}[-\s]?\d{4}[-\s]?\d{4}[-\s]?\d{4}/g,
+        ip_address: /\b(?:\d{1,3}\.){3}\d{1,3}\b/g
+    };
+    constructor(config = {}) {
+        this.config = config;
+        if (config.patterns) {
+            this.patterns = { ...this.patterns, ...config.patterns };
+        }
+    }
+    scan(text) {
+        const detected = [];
+        const detectors = this.config.detectors ?? { email: true, phone: true, ssn: true, credit_card: true, ip_address: true, apiKey: true };
+        for (const [type, pattern] of Object.entries(this.patterns)) {
+            if (detectors[type] === false)
+                continue;
+            pattern.lastIndex = 0;
+            let match;
+            while ((match = pattern.exec(text)) !== null) {
+                detected.push({
+                    type,
+                    value: match[0],
+                    position: match.index
+                });
+            }
+        }
+        return detected;
+    }
+    redact(text) {
+        const detected = this.scan(text);
+        let result = text;
+        // Sort by position in reverse to maintain correct positions when replacing
+        detected.sort((a, b) => b.position - a.position);
+        for (const pii of detected) {
+            const before = result.substring(0, pii.position);
+            const after = result.substring(pii.position + pii.value.length);
+            result = before + "[REDACTED]" + after;
+        }
+        return result;
+    }
+    redactJSON(obj) {
+        if (typeof obj !== "object" || obj === null)
+            return obj;
+        if (Array.isArray(obj)) {
+            return obj.map(item => this.redactJSON(item));
+        }
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (typeof value === "string") {
+                result[key] = this.redact(value);
+            }
+            else if (typeof value === "object" && value !== null) {
+                result[key] = this.redactJSON(value);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    mask(text, type) {
+        if (type === "email") {
+            const [local, domain] = text.split("@");
+            return local.substring(0, 1) + "*".repeat(local.length - 2) + "@" + domain;
+        }
+        if (type === "phone") {
+            return "*".repeat(text.length - 4) + text.substring(text.length - 4);
+        }
+        if (type === "credit_card") {
+            return "*".repeat(text.length - 4) + text.substring(text.length - 4);
+        }
+        return text;
+    }
+    scanStructured(data) {
+        const detected = [];
+        const scan = (obj, path = "") => {
+            if (typeof obj === "string") {
+                const matches = this.scan(obj);
+                detected.push(...matches.map(m => ({ ...m, position: path.length + m.position })));
+            }
+            else if (typeof obj === "object" && obj !== null) {
+                if (Array.isArray(obj)) {
+                    obj.forEach((item, idx) => scan(item, `${path}[${idx}]`));
+                }
+                else {
+                    for (const [key, value] of Object.entries(obj)) {
+                        scan(value, `${path}.${key}`);
+                    }
+                }
+            }
+        };
+        scan(data);
+        return detected;
+    }
+    scanArray(data) {
+        const detected = [];
+        data.forEach((item, idx) => {
+            const matches = this.scan(item);
+            detected.push(...matches);
+        });
+        return detected;
+    }
+    generateReport() {
+        const categories = {};
+        let totalDetected = 0;
+        for (const log of this.auditLogs) {
+            const match = log.match(/type:(\w+)/);
+            if (match) {
+                const type = match[1];
+                categories[type] = (categories[type] ?? 0) + 1;
+                totalDetected++;
+            }
+        }
+        return { totalDetected, categories };
+    }
+    getAuditLogs() {
+        return [...this.auditLogs];
+    }
+    async validateInput(input) {
+        const violations = [];
+        const text = input.userPrompt;
+        // Reset regex patterns to avoid issues with global flag state
+        this.patterns.apiKey.lastIndex = 0;
+        this.patterns.email.lastIndex = 0;
+        this.patterns.phone.lastIndex = 0;
+        if (this.patterns.apiKey.test(text)) {
+            violations.push({
+                policy: this.name,
+                severity: "critical",
+                message: "Potential API Key or Secret detected in user prompt. Blocking for security."
+            });
+        }
+        // Email/Phone are often allowed but should be flagged in audit
+        this.patterns.email.lastIndex = 0;
+        if (this.patterns.email.test(text)) {
+            violations.push({
+                policy: this.name,
+                severity: "low",
+                message: "Email pattern detected."
+            });
+        }
+        return {
+            allowed: !violations.some(v => v.severity === "critical"),
+            violations
+        };
+    }
+    async validateOutput(output) {
+        const violations = [];
+        const text = JSON.stringify(output.data);
+        // Reset regex patterns to avoid issues with global flag state
+        this.patterns.apiKey.lastIndex = 0;
+        if (this.patterns.apiKey.test(text)) {
+            violations.push({
+                policy: this.name,
+                severity: "critical",
+                message: "Agent attempted to leak a sensitive API key in its response."
+            });
+        }
+        return {
+            allowed: !violations.some(v => v.severity === "critical"),
+            violations
+        };
+    }
+}
+//# sourceMappingURL=pii-policy.js.map

package/dist/governance/policies/pii-policy.js.map

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

package/dist/graph/workflow-graph.d.ts

@@ -0,0 +1,5 @@
+import { WorkflowGraph, WorkflowNode } from "../types/contracts.js";
+export declare class WorkflowGraphEngine {
+    topologicalLevels(graph: WorkflowGraph): WorkflowNode[][];
+}
+//# sourceMappingURL=workflow-graph.d.ts.map

package/dist/graph/workflow-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-graph.d.ts","sourceRoot":"","sources":["../../src/graph/workflow-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEpE,qBAAa,mBAAmB;IAC9B,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,EAAE,EAAE;CAqC1D"}

package/dist/graph/workflow-graph.js

@@ -0,0 +1,38 @@
+export class WorkflowGraphEngine {
+    topologicalLevels(graph) {
+        const nodes = new Map(graph.nodes.map((n) => [n.id, n]));
+        const indegree = new Map();
+        const reverse = new Map();
+        graph.nodes.forEach((n) => {
+            indegree.set(n.id, n.dependsOn.length);
+            n.dependsOn.forEach((dep) => {
+                if (!reverse.has(dep))
+                    reverse.set(dep, []);
+                reverse.get(dep)?.push(n.id);
+            });
+        });
+        const levels = [];
+        let frontier = graph.nodes.filter((n) => (indegree.get(n.id) ?? 0) === 0);
+        while (frontier.length > 0) {
+            levels.push(frontier);
+            const next = [];
+            for (const node of frontier) {
+                for (const childId of reverse.get(node.id) ?? []) {
+                    indegree.set(childId, (indegree.get(childId) ?? 1) - 1);
+                    if ((indegree.get(childId) ?? 0) === 0) {
+                        const child = nodes.get(childId);
+                        if (child)
+                            next.push(child);
+                    }
+                }
+            }
+            frontier = next;
+        }
+        const flattened = levels.flat().length;
+        if (flattened !== graph.nodes.length) {
+            throw new Error("workflow_cycle_or_missing_dependency");
+        }
+        return levels;
+    }
+}
+//# sourceMappingURL=workflow-graph.js.map

package/dist/graph/workflow-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-graph.js","sourceRoot":"","sources":["../../src/graph/workflow-graph.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAmB;IAC9B,iBAAiB,CAAC,KAAoB;QACpC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;QAE5C,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACxB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACvC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,IAAI,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAE1E,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtB,MAAM,IAAI,GAAmB,EAAE,CAAC;YAChC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;oBACjD,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACxD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;wBACvC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;wBACjC,IAAI,KAAK;4BAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;YACH,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;QACvC,IAAI,SAAS,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export * from "./types/contracts.js";
+export * from "./orchestrator/core-orchestrator.js";
+export * from "./orchestrator/routing.js";
+export * from "./orchestrator/decomposition.js";
+export * from "./orchestrator/default-workflow.js";
+export * from "./orchestrator/verify-fix.js";
+export * from "./orchestrator/kernel-bridge.js";
+export * from "./orchestrator/blueprint-committer.js";
+export * from "./orchestrator/dynamic-planner.js";
+export * from "./orchestrator/mutation-applier.js";
+export * from "./validator/structured-output-validator.js";
+export * from "./recovery/error-recovery.js";
+export * from "./cache/semantic-cache.js";
+export * from "./metrics/metrics-engine.js";
+export * from "./plugins/plugin-system.js";
+export * from "./graph/workflow-graph.js";
+export * from "./runtime/concurrency-scheduler.js";
+export * from "./runtime/runtime-events.js";
+export * from "./memory/local-vector-store.js";
+export * from "./memory/graph-memory.js";
+export * from "./memory/memory-manager.js";
+export * from "./plugins/long-term-memory-plugin.js";
+export * from "./plugins/governance-plugin.js";
+export * from "./governance/policies/pii-policy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AAErD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+export * from "./types/contracts.js";
+export * from "./orchestrator/core-orchestrator.js";
+export * from "./orchestrator/routing.js";
+export * from "./orchestrator/decomposition.js";
+export * from "./orchestrator/default-workflow.js";
+export * from "./orchestrator/verify-fix.js";
+export * from "./orchestrator/kernel-bridge.js";
+export * from "./orchestrator/blueprint-committer.js";
+export * from "./orchestrator/dynamic-planner.js";
+export * from "./orchestrator/mutation-applier.js";
+export * from "./validator/structured-output-validator.js";
+export * from "./recovery/error-recovery.js";
+export * from "./cache/semantic-cache.js";
+export * from "./metrics/metrics-engine.js";
+export * from "./plugins/plugin-system.js";
+export * from "./graph/workflow-graph.js";
+export * from "./runtime/concurrency-scheduler.js";
+export * from "./runtime/runtime-events.js";
+export * from "./memory/local-vector-store.js";
+export * from "./memory/graph-memory.js";
+export * from "./memory/memory-manager.js";
+export * from "./plugins/long-term-memory-plugin.js";
+export * from "./plugins/governance-plugin.js";
+export * from "./governance/policies/pii-policy.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AAErD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC"}

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

@@ -0,0 +1,46 @@
+export interface GraphNode {
+    id: string;
+    type: "action" | "artifact" | "concept" | "agent";
+    content: string;
+    metadata: Record<string, any>;
+    timestamp: number;
+}
+export interface GraphEdge {
+    from: string;
+    to: string;
+    type: "produced" | "triggered_by" | "depends_on" | "relates_to";
+    metadata?: Record<string, any>;
+}
+/**
+ * Quantum Semantic Graph Memory (QSGM) Core.
+ * Manages relationships between actions, artifacts, and concepts.
+ */
+export declare class GraphMemory {
+    private persistPath?;
+    private nodes;
+    private edges;
+    constructor(persistPath?: string | undefined);
+    addNode(node: GraphNode): void;
+    removeNode(nodeId: string): boolean;
+    addEdge(edge: GraphEdge): void;
+    /**
+     * Traverses the graph to find nodes related to a starting point.
+     * Useful for finding "ripple effects" or deep context.
+     */
+    traverse(startNodeId: string, maxDepth?: number): GraphNode[];
+    load(): Promise<void>;
+    save(): Promise<void>;
+    getNodes(): GraphNode[];
+    getGraphData(): {
+        nodes: Record<string, GraphNode>;
+        edges: GraphEdge[];
+    };
+    findByType(type: string): GraphNode[];
+    search(query: string, limit?: number): GraphNode[];
+    getConnections(nodeId: string): {
+        incoming: GraphNode[];
+        outgoing: GraphNode[];
+    };
+    getStats(): any;
+}
+//# sourceMappingURL=graph-memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-memory.d.ts","sourceRoot":"","sources":["../../src/memory/graph-memory.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,CAAC;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,WAAW;IAIR,OAAO,CAAC,WAAW,CAAC;IAHhC,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,KAAK,CAAmB;gBAEZ,WAAW,CAAC,EAAE,MAAM,YAAA;IAEjC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI9B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAOnC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAIrC;;;OAGG;IACI,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,SAAS,EAAE;IA8B1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,QAAQ,IAAI,SAAS,EAAE;IAIvB,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE;IAOxE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAIrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,SAAS,EAAE;IAMrD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QAAC,QAAQ,EAAE,SAAS,EAAE,CAAA;KAAE;IAchF,QAAQ,IAAI,GAAG;CAUzB"}

package/dist/memory/graph-memory.js

@@ -0,0 +1,122 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Quantum Semantic Graph Memory (QSGM) Core.
+ * Manages relationships between actions, artifacts, and concepts.
+ */
+export class GraphMemory {
+    persistPath;
+    nodes = new Map();
+    edges = [];
+    constructor(persistPath) {
+        this.persistPath = persistPath;
+    }
+    addNode(node) {
+        this.nodes.set(node.id, node);
+    }
+    removeNode(nodeId) {
+        if (!this.nodes.has(nodeId))
+            return false;
+        this.nodes.delete(nodeId);
+        this.edges = this.edges.filter(e => e.from !== nodeId && e.to !== nodeId);
+        return true;
+    }
+    addEdge(edge) {
+        this.edges.push(edge);
+    }
+    /**
+     * Traverses the graph to find nodes related to a starting point.
+     * Useful for finding "ripple effects" or deep context.
+     */
+    traverse(startNodeId, maxDepth = 2) {
+        const visited = new Set();
+        const results = [];
+        const queue = [{ id: startNodeId, depth: 0 }];
+        while (queue.length > 0) {
+            const { id, depth } = queue.shift();
+            if (visited.has(id) || depth > maxDepth)
+                continue;
+            visited.add(id);
+            const node = this.nodes.get(id);
+            if (node) {
+                results.push(node);
+            }
+            // Find neighbors
+            const neighbors = this.edges
+                .filter(e => e.from === id)
+                .map(e => ({ id: e.to, depth: depth + 1 }));
+            const reverseNeighbors = this.edges
+                .filter(e => e.to === id)
+                .map(e => ({ id: e.from, depth: depth + 1 }));
+            queue.push(...neighbors, ...reverseNeighbors);
+        }
+        return results;
+    }
+    async load() {
+        if (!this.persistPath)
+            return;
+        try {
+            const raw = await readFile(this.persistPath, "utf8");
+            const data = JSON.parse(raw);
+            this.nodes = new Map(Object.entries(data.nodes || {}));
+            this.edges = data.edges || [];
+        }
+        catch {
+            this.nodes = new Map();
+            this.edges = [];
+        }
+    }
+    async save() {
+        if (!this.persistPath)
+            return;
+        try {
+            await mkdir(path.dirname(this.persistPath), { recursive: true });
+            await writeFile(this.persistPath, JSON.stringify({
+                nodes: Object.fromEntries(this.nodes),
+                edges: this.edges
+            }, null, 2));
+        }
+        catch (err) {
+            console.error("Failed to persist graph memory:", err);
+        }
+    }
+    getNodes() {
+        return Array.from(this.nodes.values());
+    }
+    getGraphData() {
+        return {
+            nodes: Object.fromEntries(this.nodes),
+            edges: this.edges
+        };
+    }
+    findByType(type) {
+        return Array.from(this.nodes.values()).filter(n => n.type === type);
+    }
+    search(query, limit = 5) {
+        return Array.from(this.nodes.values())
+            .filter(n => n.content?.includes(query) || JSON.stringify(n.metadata).includes(query))
+            .slice(0, limit);
+    }
+    getConnections(nodeId) {
+        const incoming = this.edges
+            .filter(e => e.to === nodeId)
+            .map(e => this.nodes.get(e.from))
+            .filter(Boolean);
+        const outgoing = this.edges
+            .filter(e => e.from === nodeId)
+            .map(e => this.nodes.get(e.to))
+            .filter(Boolean);
+        return { incoming, outgoing };
+    }
+    getStats() {
+        return {
+            nodeCount: this.nodes.size,
+            edgeCount: this.edges.length,
+            nodesByType: Array.from(this.nodes.values()).reduce((acc, n) => {
+                acc[n.type] = (acc[n.type] || 0) + 1;
+                return acc;
+            }, {})
+        };
+    }
+}
+//# sourceMappingURL=graph-memory.js.map

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

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

package/dist/memory/local-vector-store.d.ts

@@ -0,0 +1,36 @@
+import { IVectorStore, MemoryDocument, SearchResult } from "../types/contracts.js";
+/**
+ * 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 declare class LocalVectorStore implements IVectorStore {
+    private persistPath?;
+    private documents;
+    private vectors;
+    private metadata;
+    constructor(persistPath?: string | undefined);
+    add(documents: MemoryDocument[], vectors: number[][]): Promise<void>;
+    search(queryVector: number[], limit?: number): Promise<SearchResult[]>;
+    clear(): Promise<void>;
+    delete(docIds: string[]): Promise<void>;
+    searchByMetadata(metadata: Record<string, unknown>): Promise<SearchResult[]>;
+    count(): number;
+    getMetrics(): {
+        documentCount: number;
+        vectorDimensions: number;
+    };
+    /**
+     * Calculates cosine similarity between two numeric vectors.
+     */
+    private cosineSimilarity;
+    /**
+     * Manually triggers a load from the persistence file.
+     */
+    load(): Promise<void>;
+    /**
+     * Internal save to disk.
+     */
+    private save;
+}
+//# sourceMappingURL=local-vector-store.d.ts.map

package/dist/memory/local-vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-vector-store.d.ts","sourceRoot":"","sources":["../../src/memory/local-vector-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAInF;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IAKrC,OAAO,CAAC,WAAW,CAAC;IAJhC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAmD;gBAE/C,WAAW,CAAC,EAAE,MAAM,YAAA;IAElC,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASpE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAazE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO3E,KAAK,IAAI,MAAM;IAIf,UAAU;;;;IAOjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;OAEG;YACW,IAAI;CAYrB"}