mcard-js 2.1.41 → 2.1.43

package/dist/ptr/SandboxWorker.js

@@ -1,298 +0,0 @@
-/**
- * SandboxWorker - Execute code in isolated Web Worker
- *
- * Provides safe execution environment for PCard logic.
- * Supports multiple runtimes:
- * - JavaScript: Native execution via Function()
- * - Python: Execution via Pyodide (WebAssembly Python)
- *
- * @see https://pyodide.org/en/stable/
- */
-/**
- * Worker code as inline string (will be converted to Blob URL)
- * Supports both JavaScript and Python (via Pyodide) execution
- */
-const WORKER_CODE = `
-// Multi-runtime sandboxed execution environment
-let pyodide = null;
-let pyodideLoading = null;
-
-// Pyodide CDN URL - can be overridden via message
-const PYODIDE_CDN = 'https://cdn.jsdelivr.net/pyodide/v0.24.1/full/';
-
-// Load Pyodide on demand (lazy loading)
-async function loadPyodide() {
-  if (pyodide) return pyodide;
-  if (pyodideLoading) return pyodideLoading;
-  
-  pyodideLoading = (async () => {
-    // Import Pyodide from CDN
-    importScripts(PYODIDE_CDN + 'pyodide.js');
-    pyodide = await self.loadPyodide({
-      indexURL: PYODIDE_CDN,
-    });
-    console.log('[SandboxWorker] Pyodide loaded successfully');
-    return pyodide;
-  })();
-  
-  return pyodideLoading;
-}
-
-self.onmessage = async function(e) {
-  const request = e.data;
-  
-  try {
-    if (request.method === 'pcard.execute') {
-      const { pcard, context } = request.params;
-      const runtime = pcard.runtime || 'javascript';
-      
-      let result;
-      if (runtime === 'python' || runtime === 'py') {
-        result = await executePython(pcard.code, pcard.input, context);
-      } else {
-        result = await executeJavaScript(pcard.code, pcard.input, context);
-      }
-      
-      self.postMessage({
-        jsonrpc: '2.0',
-        id: request.id,
-        result
-      });
-    } else if (request.method === 'pcard.verify') {
-      const { expectedOutput, actualOutput } = request.params;
-      const matches = JSON.stringify(expectedOutput) === JSON.stringify(actualOutput);
-      self.postMessage({
-        jsonrpc: '2.0',
-        id: request.id,
-        result: { verified: matches }
-      });
-    } else if (request.method === 'runtime.preload') {
-      // Preload Pyodide for faster first execution
-      const runtime = request.params?.runtime || 'python';
-      if (runtime === 'python' || runtime === 'py') {
-        await loadPyodide();
-        self.postMessage({
-          jsonrpc: '2.0',
-          id: request.id,
-          result: { loaded: true, runtime: 'python' }
-        });
-      } else {
-        self.postMessage({
-          jsonrpc: '2.0',
-          id: request.id,
-          result: { loaded: true, runtime: 'javascript' }
-        });
-      }
-    } else {
-      throw new Error('Method not found: ' + request.method);
-    }
-  } catch (error) {
-    self.postMessage({
-      jsonrpc: '2.0',
-      id: request.id,
-      error: {
-        code: -32000,
-        message: error.message || 'Execution error'
-      }
-    });
-  }
-};
-
-// Execute JavaScript code in sandbox
-async function executeJavaScript(code, input, context) {
-  const fn = new Function('input', 'context', code);
-  return fn(input, context || {});
-}
-
-// Execute Python code via Pyodide
-async function executePython(code, input, context) {
-  const py = await loadPyodide();
-  
-  // Convert input to Python dict
-  py.globals.set('input', py.toPy(input || {}));
-  py.globals.set('context', py.toPy(context || {}));
-  
-  // Wrap code to capture result
-  const wrappedCode = \`
-import json
-
-# Make input accessible as variables
-_input = input.to_py() if hasattr(input, 'to_py') else input
-_context = context.to_py() if hasattr(context, 'to_py') else context
-
-# Standard variable names for CLM
-a = _input.get('a') if isinstance(_input, dict) else None
-b = _input.get('b') if isinstance(_input, dict) else None
-values = _input.get('values') if isinstance(_input, dict) else None
-
-result = None
-
-\${code}
-
-# Return result
-result
-\`;
-  
-  try {
-    const pyResult = await py.runPythonAsync(wrappedCode);
-    // Convert Python result to JavaScript
-    return pyResult?.toJs ? pyResult.toJs({ dict_converter: Object.fromEntries }) : pyResult;
-  } finally {
-    // Clean up globals
-    py.globals.delete('input');
-    py.globals.delete('context');
-  }
-}
-`;
-/**
- * SandboxWorker - Manages Web Worker for isolated execution
- *
- * Supports multiple runtimes:
- * - javascript/js: Native JS execution
- * - python/py: Python via Pyodide (WebAssembly)
- */
-export class SandboxWorker {
-    worker = null;
-    pythonLoaded = false;
-    pendingRequests = new Map();
-    defaultTimeout = 5000; // 5 seconds
-    /**
-     * Initialize the sandbox worker
-     */
-    async init() {
-        const blob = new Blob([WORKER_CODE], { type: 'application/javascript' });
-        const workerUrl = URL.createObjectURL(blob);
-        this.worker = new Worker(workerUrl);
-        this.worker.onmessage = this.handleMessage.bind(this);
-        this.worker.onerror = this.handleError.bind(this);
-        // Clean up blob URL
-        URL.revokeObjectURL(workerUrl);
-    }
-    requestCounter = 0;
-    /**
-     * Execute code in sandbox
-     * @param code - Code to execute
-     * @param input - Input data for the code
-     * @param context - Optional execution context
-     * @param runtime - Runtime to use: 'javascript' (default) or 'python'
-     */
-    async execute(code, input, context, runtime = 'javascript') {
-        if (!this.worker) {
-            throw new Error('Worker not initialized. Call init() first.');
-        }
-        const request = {
-            jsonrpc: '2.0',
-            id: ++this.requestCounter,
-            method: 'pcard.execute',
-            params: { pcard: { code, input, runtime }, context }
-        };
-        return this.sendRequest(request);
-    }
-    /**
-     * Preload a runtime for faster first execution
-     * Useful for Python which requires loading Pyodide (~10MB)
-     * @param runtime - Runtime to preload: 'python' or 'javascript'
-     */
-    async preloadRuntime(runtime = 'python') {
-        if (!this.worker) {
-            throw new Error('Worker not initialized. Call init() first.');
-        }
-        const request = {
-            jsonrpc: '2.0',
-            id: ++this.requestCounter,
-            method: 'runtime.preload',
-            params: { runtime }
-        };
-        const result = await this.sendRequest(request);
-        if (runtime === 'python' || runtime === 'py') {
-            this.pythonLoaded = true;
-        }
-        return result;
-    }
-    /**
-     * Check if Python runtime is loaded
-     */
-    isPythonLoaded() {
-        return this.pythonLoaded;
-    }
-    /**
-     * Verify output matches expected
-     * Note: Uses internal JSON-RPC format with direct values
-     */
-    async verify(hash, expectedOutput, actualOutput) {
-        if (!this.worker) {
-            throw new Error('Worker not initialized. Call init() first.');
-        }
-        const request = {
-            jsonrpc: '2.0',
-            id: ++this.requestCounter,
-            method: 'pcard.verify',
-            params: { hash, expectedOutput, actualOutput }
-        };
-        return this.sendRequest(request);
-    }
-    /**
-     * Send request and wait for response
-     */
-    sendRequest(request) {
-        return new Promise((resolve, reject) => {
-            const timeout = setTimeout(() => {
-                this.pendingRequests.delete(request.id);
-                reject(new Error(`Request ${request.id} timed out`));
-            }, this.defaultTimeout);
-            this.pendingRequests.set(request.id, { resolve, reject, timeout });
-            this.worker.postMessage(request);
-        });
-    }
-    /**
-     * Handle worker message
-     */
-    handleMessage(event) {
-        const response = event.data;
-        const pending = this.pendingRequests.get(response.id);
-        if (pending) {
-            clearTimeout(pending.timeout);
-            this.pendingRequests.delete(response.id);
-            if (response.error) {
-                pending.reject(new Error(`Error ${response.error.code}: ${response.error.message}`));
-            }
-            else {
-                pending.resolve(response.result);
-            }
-        }
-    }
-    /**
-     * Handle worker error
-     */
-    handleError(event) {
-        console.error('Worker error:', event.message);
-        // Reject all pending requests
-        for (const [id, pending] of this.pendingRequests) {
-            clearTimeout(pending.timeout);
-            pending.reject(new Error(`Worker error: ${event.message}`));
-        }
-        this.pendingRequests.clear();
-    }
-    /**
-     * Terminate the worker
-     */
-    terminate() {
-        if (this.worker) {
-            // Reject pending requests
-            for (const [id, pending] of this.pendingRequests) {
-                clearTimeout(pending.timeout);
-                pending.reject(new Error('Worker terminated'));
-            }
-            this.pendingRequests.clear();
-            this.worker.terminate();
-            this.worker = null;
-        }
-    }
-    /**
-     * Set timeout for requests
-     */
-    setTimeout(ms) {
-        this.defaultTimeout = ms;
-    }
-}
-//# sourceMappingURL=SandboxWorker.js.map

package/dist/ptr/SandboxWorker.js.map

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

package/dist/ptr/common_types.d.ts

@@ -1,39 +0,0 @@
-/**
- * Common types for PTR system
- * Matches python mcard.ptr.core.common_types
- */
-export type PrimeHash = string;
-export interface PolynomialTerm {
-    coefficient: PrimeHash;
-    exponent: PrimeHash;
-    weight: number;
-}
-export interface SafetyViolation {
-    property: string;
-    violation_type: string;
-    details: string;
-    timestamp: string;
-}
-export interface LivenessMetric {
-    goal: string;
-    progress: number;
-    timestamp: string;
-}
-export declare enum VerificationStatus {
-    PENDING = "pending",
-    VERIFIED = "verified",
-    FAILED = "failed",
-    SKIPPED = "skipped"
-}
-export interface ExecutionResult {
-    success: boolean;
-    output: unknown;
-    verification_vcard: string | null;
-    execution_time_ms: number;
-    alignment_score?: number;
-    invariants_preserved: boolean;
-    safety_violations: SafetyViolation[];
-    liveness_metrics: LivenessMetric[];
-    error_message?: string;
-}
-//# sourceMappingURL=common_types.d.ts.map

package/dist/ptr/common_types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"common_types.d.ts","sourceRoot":"","sources":["../../src/ptr/common_types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC3B,WAAW,EAAE,SAAS,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,oBAAY,kBAAkB;IAC1B,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,OAAO,YAAY;CACtB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAG1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAG9B,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAEnC,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/ptr/common_types.js

@@ -1,12 +0,0 @@
-/**
- * Common types for PTR system
- * Matches python mcard.ptr.core.common_types
- */
-export var VerificationStatus;
-(function (VerificationStatus) {
-    VerificationStatus["PENDING"] = "pending";
-    VerificationStatus["VERIFIED"] = "verified";
-    VerificationStatus["FAILED"] = "failed";
-    VerificationStatus["SKIPPED"] = "skipped";
-})(VerificationStatus || (VerificationStatus = {}));
-//# sourceMappingURL=common_types.js.map

package/dist/ptr/common_types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"common_types.js","sourceRoot":"","sources":["../../src/ptr/common_types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC1B,yCAAmB,CAAA;IACnB,2CAAqB,CAAA;IACrB,uCAAiB,CAAA;IACjB,yCAAmB,CAAA;AACvB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/dist/rag/GraphRAGEngine.d.ts

@@ -1,26 +0,0 @@
-import { GraphStore } from './graph/store';
-import { GraphExtractor } from './graph/extractor';
-import { MCardVectorStore } from '../storage/VectorStore';
-import { MCard } from '../model/MCard';
-export interface GraphRAGResponse {
-    answer: string;
-    sources: string[];
-    entities: any[];
-    relationships: any[];
-    graphContext: string;
-    vectorContext: string;
-    confidence: number;
-    metadata?: any;
-}
-export declare class GraphRAGEngine {
-    vectorStore: MCardVectorStore;
-    graphStore: GraphStore;
-    extractor: GraphExtractor;
-    llmModel: string;
-    config: any;
-    constructor(vectorDbPath: string, graphDbPath?: string | null, llmModel?: string, config?: any);
-    index(mcard: MCard, extractGraph?: boolean, force?: boolean): Promise<any>;
-    query(question: string, k?: number, useGraph?: boolean): Promise<GraphRAGResponse>;
-    private _getGraphContext;
-}
-//# sourceMappingURL=GraphRAGEngine.d.ts.map

package/dist/rag/GraphRAGEngine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphRAGEngine.d.ts","sourceRoot":"","sources":["../../src/rag/GraphRAGEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAA2D,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAsB,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AA6BvC,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,aAAa,EAAE,GAAG,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAClB;AAED,qBAAa,cAAc;IACvB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC;gBAGR,YAAY,EAAE,MAAM,EACpB,WAAW,GAAE,MAAM,GAAG,IAAW,EACjC,QAAQ,GAAE,MAAwB,EAClC,MAAM,GAAE,GAAQ;IAoBd,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,GAAE,OAAc,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,GAAG,CAAC;IAqBvF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAE,MAAU,EAAE,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;YA0EnF,gBAAgB;CAiDjC"}

package/dist/rag/GraphRAGEngine.js

@@ -1,166 +0,0 @@
-import { GraphStore, storeExtractionResult } from './graph/store';
-import { GraphExtractor } from './graph/extractor';
-import { MCardVectorStore } from '../storage/VectorStore';
-import { chatMonad } from '../ptr/llm/LLMRuntime';
-const GRAPHRAG_SYSTEM_PROMPT = `You are a helpful assistant that answers questions using both document context and a knowledge graph.
-
-You have access to:
-1. DOCUMENT CONTEXT: Relevant text passages from the knowledge base
-2. GRAPH CONTEXT: Entities and their relationships from the knowledge graph
-
-Use both sources to provide comprehensive, accurate answers.
-- Cite sources [1], [2], etc. for document context
-- Reference entities by name when using graph information
-- If the graph shows relationships that help answer the question, describe them
-
-Be thorough but concise. Acknowledge if information is incomplete.`;
-const GRAPH_QUERY_PROMPT = `Question: {question}
-
-=== DOCUMENT CONTEXT ===
-{vector_context}
-
-=== KNOWLEDGE GRAPH ===
-Entities: {entities}
-Relationships: {relationships}
-
-Please provide a comprehensive answer using both the document context and knowledge graph information.`;
-export class GraphRAGEngine {
-    vectorStore;
-    graphStore;
-    extractor;
-    llmModel;
-    config;
-    constructor(vectorDbPath, graphDbPath = null, llmModel = 'gemma3:latest', config = {}) {
-        this.config = config;
-        this.llmModel = llmModel;
-        // Init vector store
-        this.vectorStore = new MCardVectorStore(vectorDbPath, config);
-        // Init graph store
-        const gPath = graphDbPath || vectorDbPath;
-        this.graphStore = new GraphStore(gPath);
-        // Init extractor
-        // GraphExtractor constructor expects config object
-        this.extractor = new GraphExtractor({ model: llmModel, ...config });
-    }
-    async index(mcard, extractGraph = true, force = false) {
-        const stats = { vectors: 0, entities: 0, relationships: 0 };
-        let content = mcard.getContentAsText();
-        // Vector index
-        // We always index (INSERT OR REPLACE)
-        stats.vectors = await this.vectorStore.index(mcard.hash, content);
-        // Graph extract
-        if (extractGraph && (force || !(await this.graphStore.isExtracted(mcard.hash)))) {
-            const result = await this.extractor.extract(content);
-            if (result.success) {
-                const [entCount, relCount] = storeExtractionResult(this.graphStore, result, mcard.hash);
-                stats.entities = entCount;
-                stats.relationships = relCount;
-            }
-        }
-        return stats;
-    }
-    async query(question, k = 5, useGraph = true) {
-        // Vector Search
-        const results = await this.vectorStore.search(question, k);
-        const contextParts = [];
-        const sources = [];
-        results.forEach((r, i) => {
-            const chunk = r.content || `[Content from ${r.hash.substring(0, 8)}]`;
-            contextParts.push(`[${i + 1}] ${chunk}`);
-            sources.push(r.hash);
-        });
-        const vectorContext = contextParts.join('\n\n');
-        // Graph Search
-        let entities = [];
-        let relationships = [];
-        let graphContext = "";
-        if (useGraph) {
-            const graphData = await this._getGraphContext(question, sources);
-            entities = graphData.entities;
-            relationships = graphData.relationships;
-            if (entities.length > 0) {
-                const entStr = entities.slice(0, 10).map(e => `${e.name} (${e.type})`).join(', ');
-                const relStr = relationships.slice(0, 15).map(r => `${r.source} --${r.relationship}-> ${r.target}`).join('\n');
-                graphContext = `Entities: ${entStr}\nRelationships:\n${relStr}`;
-            }
-        }
-        // LLM Generation
-        let answer = "";
-        if (!vectorContext && entities.length === 0) {
-            answer = "I couldn't find relevant information.";
-        }
-        else {
-            const entStr = entities.length ? entities.map(e => `${e.name} (${e.type})`).join(', ') : "None found";
-            const relStr = relationships.length ? relationships.map(r => `  - ${r.source} --${r.relationship}-> ${r.target}`).join('\n') : "None found";
-            const prompt = GRAPH_QUERY_PROMPT
-                .replace('{question}', question)
-                .replace('{vector_context}', vectorContext || "No document context available.")
-                .replace('{entities}', entStr)
-                .replace('{relationships}', relStr);
-            const monad = chatMonad(null, // messages null
-            prompt, GRAPHRAG_SYSTEM_PROMPT, { model: this.llmModel, temperature: 0.3 });
-            const result = await monad.run();
-            if (result.isRight) {
-                const val = result.right;
-                answer = typeof val === 'object' ? val.content : val;
-            }
-            else {
-                answer = `Error: ${result.left}`;
-            }
-        }
-        return {
-            answer,
-            sources,
-            entities,
-            relationships,
-            graphContext,
-            vectorContext,
-            confidence: 0.8 // placeholder
-        };
-    }
-    async _getGraphContext(query, sourceHashes) {
-        const entities = [];
-        const seenIds = new Set();
-        // Word search
-        const words = query.split(/\s+/).filter(w => w.length > 3);
-        const uniqueWords = [...new Set(words)]; // dedupe words
-        for (const word of uniqueWords) {
-            // Check if searchEntities exists on GraphStore
-            const found = await this.graphStore.searchEntities(word, undefined, 5);
-            for (const ent of found) {
-                if (!seenIds.has(ent.id)) {
-                    seenIds.add(ent.id);
-                    entities.push(ent);
-                }
-            }
-        }
-        // Source search
-        const uniquesources = [...new Set(sourceHashes)].slice(0, 3);
-        for (const hash of uniquesources) {
-            const found = await this.graphStore.getEntitiesBySource(hash);
-            for (const ent of found) {
-                if (!seenIds.has(ent.id)) {
-                    seenIds.add(ent.id);
-                    entities.push(ent);
-                }
-            }
-        }
-        // Get Relationships
-        const relationships = [];
-        for (const ent of entities) {
-            const outRels = await this.graphStore.getRelationshipsFrom(ent.id);
-            for (const r of outRels) {
-                relationships.push({
-                    source: ent.name,
-                    relationship: r.relationship,
-                    target: r.targetName
-                });
-            }
-            // Limit per entity to avoid explosion
-            if (relationships.length > 50)
-                break;
-        }
-        return { entities, relationships };
-    }
-}
-//# sourceMappingURL=GraphRAGEngine.js.map

package/dist/rag/GraphRAGEngine.js.map

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