@longarc/mdash 3.0.0

package/dist/context/engine.js

@@ -0,0 +1,392 @@
+/**
+ * mdash v3.0 - Sealed Context Architecture (SCA)
+ *
+ * Incremental Merkle sealing with streaming support.
+ * O(log n) proof verification.
+ *
+ * Target Latency:
+ * - Context chunk seal: <2ms P50, <5ms P99
+ */
+import { generateFragmentId, generateTimestamp, sha256Object, hmacSeal, hmacVerify, deriveKey, deterministicStringify, } from '../core/crypto';
+import { IncrementalMerkleTree } from '../core/commitment';
+// ============================================================================
+// TRUST LEVELS
+// ============================================================================
+export const DEFAULT_TRUST_LEVELS = {
+    system: 100,
+    operator: 90,
+    user: 70,
+    derived: 60,
+    agent: 50,
+    external: 30,
+};
+export class ContextStream {
+    chunks = [];
+    tree;
+    key = null;
+    sourceClass;
+    source;
+    constructor(params) {
+        this.source = params.source;
+        this.sourceClass = params.sourceClass;
+        this.tree = new IncrementalMerkleTree(params.maxDepth || 16);
+    }
+    /**
+     * Initialize with seal key
+     */
+    async initialize(sealKey) {
+        this.key = await deriveKey(sealKey);
+    }
+    /**
+     * Add a chunk to the stream
+     * Target: <2ms P50, <5ms P99
+     */
+    async addChunk(content) {
+        const startTime = performance.now();
+        const index = this.chunks.length;
+        const hash = await sha256Object({ index, content });
+        const chunk = {
+            index,
+            content,
+            hash,
+            sealed: false,
+        };
+        // Add to Merkle tree
+        await this.tree.addLeaf(hash);
+        chunk.sealed = true;
+        this.chunks.push(chunk);
+        const elapsed = performance.now() - startTime;
+        if (elapsed > 5) {
+            console.warn(`Context chunk seal exceeded P99: ${elapsed.toFixed(2)}ms`);
+        }
+        return chunk;
+    }
+    /**
+     * Get the current root hash
+     */
+    async getRoot() {
+        return this.tree.getRoot();
+    }
+    /**
+     * Get proof for a specific chunk
+     */
+    async getProof(index) {
+        if (index < 0 || index >= this.chunks.length) {
+            throw new Error(`Invalid chunk index: ${index}`);
+        }
+        const chunk = this.chunks[index];
+        if (!chunk) {
+            throw new Error(`Chunk not found at index: ${index}`);
+        }
+        const path = await this.tree.getProof(index);
+        const root = await this.tree.getRoot();
+        return { chunk, path, root };
+    }
+    /**
+     * Finalize the stream into a single sealed fragment
+     */
+    async finalize() {
+        if (!this.key) {
+            throw new Error('Stream not initialized. Call initialize() first.');
+        }
+        const id = generateFragmentId();
+        const now = generateTimestamp();
+        const root = await this.tree.getRoot();
+        // Collect all chunk data
+        const data = this.chunks.map(c => c.content);
+        const totalTokens = this.chunks.length * 100; // Approximate
+        const content = {
+            type: 'structured',
+            data,
+            tokens: totalTokens,
+            metadata: {
+                chunks: this.chunks.length,
+                merkle_root: root,
+            },
+        };
+        const provenance = {
+            source: this.source,
+            attribution: this.sourceClass,
+            trust_level: DEFAULT_TRUST_LEVELS[this.sourceClass],
+            timestamp: now,
+            parent_hash: null,
+        };
+        const hash = await sha256Object({
+            content,
+            provenance,
+            sealed_at: now,
+        });
+        const sealData = {
+            _v: 1,
+            id,
+            hash,
+            content,
+            provenance,
+            sealed_at: now,
+            constraints: [],
+        };
+        const seal = await hmacSeal(sealData, this.key);
+        return {
+            id,
+            hash,
+            content,
+            provenance,
+            sealed_at: now,
+            seal,
+            constraints: [],
+            version: 'v3.0',
+        };
+    }
+    /**
+     * Get stream statistics
+     */
+    getStats() {
+        return {
+            chunks: this.chunks.length,
+            treeStats: this.tree.getStats(),
+        };
+    }
+}
+// ============================================================================
+// SEALED CONTEXT ENGINE
+// ============================================================================
+export class SealedContextEngine {
+    key = null;
+    commitmentEngine;
+    fragments = new Map();
+    byHash = new Map();
+    constructor(commitmentEngine) {
+        this.commitmentEngine = commitmentEngine;
+    }
+    /**
+     * Initialize the engine with a seal key
+     */
+    async initialize(sealKey) {
+        this.key = await deriveKey(sealKey);
+    }
+    /**
+     * Create a sealed context fragment
+     */
+    async seal(params) {
+        if (!this.key) {
+            throw new Error('Engine not initialized. Call initialize() first.');
+        }
+        const startTime = performance.now();
+        const id = generateFragmentId();
+        const now = generateTimestamp();
+        const semanticUnit = {
+            type: params.contentType,
+            data: params.content,
+            tokens: params.tokens ?? this.estimateTokens(params.content),
+        };
+        const provenance = {
+            source: params.source,
+            attribution: params.sourceClass,
+            trust_level: DEFAULT_TRUST_LEVELS[params.sourceClass],
+            timestamp: now,
+            parent_hash: params.parentHash || null,
+        };
+        const hash = await sha256Object({
+            content: semanticUnit,
+            provenance,
+            sealed_at: now,
+        });
+        const sealData = {
+            _v: 1,
+            id,
+            hash,
+            content: semanticUnit,
+            provenance,
+            sealed_at: now,
+            constraints: params.constraints || [],
+        };
+        const seal = await hmacSeal(sealData, this.key);
+        const fragment = {
+            id,
+            hash,
+            content: semanticUnit,
+            provenance,
+            sealed_at: now,
+            seal,
+            constraints: params.constraints || [],
+            version: 'v3.0',
+        };
+        // Commit to L1
+        await this.commitmentEngine.commit(fragment, `context:${id}`);
+        // Store
+        this.fragments.set(id, fragment);
+        this.byHash.set(hash, id);
+        const elapsed = performance.now() - startTime;
+        if (elapsed > 5) {
+            console.warn(`Context seal exceeded P99: ${elapsed.toFixed(2)}ms`);
+        }
+        return fragment;
+    }
+    /**
+     * Derive a new fragment from an existing one
+     */
+    async derive(params) {
+        const derived = params.transform(params.parent.content.data);
+        const sealParams = {
+            content: derived,
+            contentType: params.parent.content.type,
+            source: params.source,
+            sourceClass: 'derived',
+            parentHash: params.parent.hash,
+        };
+        if (params.constraints) {
+            sealParams.constraints = params.constraints;
+        }
+        return this.seal(sealParams);
+    }
+    /**
+     * Verify a fragment
+     */
+    async verify(fragment) {
+        if (!this.key) {
+            throw new Error('Engine not initialized. Call initialize() first.');
+        }
+        // Verify hash
+        const expectedHash = await sha256Object({
+            content: fragment.content,
+            provenance: fragment.provenance,
+            sealed_at: fragment.sealed_at,
+        });
+        if (expectedHash !== fragment.hash) {
+            return false;
+        }
+        // Verify seal
+        const sealData = {
+            _v: 1,
+            id: fragment.id,
+            hash: fragment.hash,
+            content: fragment.content,
+            provenance: fragment.provenance,
+            sealed_at: fragment.sealed_at,
+            constraints: fragment.constraints,
+        };
+        return hmacVerify(sealData, fragment.seal, this.key);
+    }
+    /**
+     * Resolve a fragment (check constraints)
+     */
+    async resolve(fragment, context) {
+        const violations = [];
+        const now = context.now || new Date();
+        for (const constraint of fragment.constraints) {
+            switch (constraint.kind) {
+                case 'time': {
+                    if (constraint.type === 'max_age') {
+                        const maxAgeMs = constraint.params.max_age_ms;
+                        const sealedAt = new Date(fragment.sealed_at);
+                        if (now.getTime() - sealedAt.getTime() > maxAgeMs) {
+                            violations.push({
+                                constraint,
+                                reason: `Fragment age exceeds max_age_ms: ${maxAgeMs}`,
+                            });
+                        }
+                    }
+                    break;
+                }
+                case 'trust': {
+                    if (constraint.type === 'minimum') {
+                        const minTrust = constraint.params.minimum_trust;
+                        if (fragment.provenance.trust_level < minTrust) {
+                            violations.push({
+                                constraint,
+                                reason: `Trust ${fragment.provenance.trust_level} < required ${minTrust}`,
+                            });
+                        }
+                    }
+                    break;
+                }
+                case 'scope': {
+                    if (constraint.type === 'domain' && context.domain) {
+                        const allowed = constraint.params.allowed_domains;
+                        if (!allowed.includes(context.domain)) {
+                            violations.push({
+                                constraint,
+                                reason: `Domain ${context.domain} not in allowed list`,
+                            });
+                        }
+                    }
+                    break;
+                }
+            }
+        }
+        return {
+            success: violations.length === 0,
+            violations,
+        };
+    }
+    /**
+     * Get fragment by ID
+     */
+    get(id) {
+        return this.fragments.get(id) || null;
+    }
+    /**
+     * Get fragment by hash
+     */
+    getByHash(hash) {
+        const id = this.byHash.get(hash);
+        if (!id)
+            return null;
+        return this.get(id);
+    }
+    /**
+     * Create a streaming context
+     */
+    createStream(params) {
+        return new ContextStream(params);
+    }
+    /**
+     * Estimate tokens (rough: ~4 chars/token)
+     */
+    estimateTokens(content) {
+        const str = typeof content === 'string'
+            ? content
+            : deterministicStringify(content);
+        return Math.ceil(str.length / 4);
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return {
+            fragments: this.fragments.size,
+        };
+    }
+}
+// ============================================================================
+// CONSTRAINT BUILDERS
+// ============================================================================
+export function maxAge(ms) {
+    return {
+        kind: 'time',
+        type: 'max_age',
+        params: { max_age_ms: ms },
+    };
+}
+export function requireTrust(minimum) {
+    return {
+        kind: 'trust',
+        type: 'minimum',
+        params: { minimum_trust: minimum },
+    };
+}
+export function allowDomains(domains) {
+    return {
+        kind: 'scope',
+        type: 'domain',
+        params: { allowed_domains: domains },
+    };
+}
+export function requireSignature(signers) {
+    return {
+        kind: 'signature',
+        type: 'required',
+        params: { allowed_signers: signers },
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/context/engine.js.map

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

package/dist/core/commitment.d.ts

@@ -0,0 +1,154 @@
+/**
+ * mdash v3.0 - Commitment Layer (L1)
+ *
+ * Sub-millisecond cryptographic commitments.
+ * "The seal races the attack."
+ *
+ * Target Latency:
+ * - Commitment seal: <0.5ms P50, <1ms P99
+ * - Merkle proof: <0.1ms
+ */
+import { Hash, Seal, Timestamp } from './crypto';
+export interface Commitment {
+    /** Unique commitment identifier */
+    id: string;
+    /** Operation ID this commitment is associated with */
+    operationId?: string;
+    /** SHA-256 hash of the committed content */
+    content_hash: Hash;
+    /** Timestamp of commitment creation */
+    committed_at: Timestamp;
+    /** HMAC seal binding id + hash + timestamp */
+    seal: Seal;
+    /** Protocol version for upgrade path */
+    version: 'v3.0';
+}
+export interface CommitmentProof {
+    /** The commitment being proven */
+    commitment: Commitment;
+    /** Merkle path from leaf to root */
+    merkle_path: MerklePathNode[];
+    /** Root hash at time of commitment */
+    root_hash: Hash;
+    /** Position in the tree (leaf index) */
+    leaf_index: number;
+}
+export interface MerklePathNode {
+    /** Hash value */
+    hash: Hash;
+    /** Position: 'left' or 'right' relative to current node */
+    position: 'left' | 'right';
+}
+export declare class IncrementalMerkleTree {
+    private leaves;
+    private levels;
+    private readonly maxDepth;
+    constructor(maxDepth?: number);
+    /**
+     * Add a leaf to the tree
+     * O(log n) operation
+     */
+    addLeaf(hash: Hash): Promise<number>;
+    /**
+     * Update the Merkle path for a new leaf
+     * Incrementally updates only affected nodes
+     */
+    private updatePath;
+    /**
+     * Get the current root hash
+     */
+    getRoot(): Promise<Hash>;
+    /**
+     * Generate Merkle proof for a leaf
+     * O(log n) operation
+     */
+    getProof(leafIndex: number): Promise<MerklePathNode[]>;
+    /**
+     * Verify a Merkle proof
+     * O(log n) operation
+     */
+    static verifyProof(leafHash: Hash, proof: MerklePathNode[], expectedRoot: Hash): Promise<boolean>;
+    /**
+     * Get tree statistics
+     */
+    getStats(): {
+        leaves: number;
+        depth: number;
+        capacity: number;
+    };
+}
+export declare class CommitmentEngine {
+    private key;
+    private tree;
+    private commitments;
+    constructor(maxTreeDepth?: number);
+    /**
+     * Initialize the engine with a seal key
+     */
+    initialize(sealKey: string): Promise<void>;
+    /**
+     * Create a commitment for content
+     * Target: <0.5ms P50, <1ms P99
+     */
+    commit<T>(content: T, id: string): Promise<Commitment>;
+    /**
+     * Get a commitment by ID
+     */
+    getCommitment(id: string): Commitment | undefined;
+    /**
+     * Verify a commitment
+     */
+    verify(commitment: Commitment): Promise<boolean>;
+    /**
+     * Generate a proof for a commitment
+     */
+    generateProof(id: string): Promise<CommitmentProof>;
+    /**
+     * Verify a proof
+     */
+    verifyProof(proof: CommitmentProof): Promise<boolean>;
+    /**
+     * Get the current Merkle root
+     */
+    getRoot(): Promise<Hash>;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        commitments: number;
+        treeStats: {
+            leaves: number;
+            depth: number;
+            capacity: number;
+        };
+    };
+}
+export interface LatencyMetrics {
+    operation: string;
+    p50_ms: number;
+    p99_ms: number;
+    count: number;
+    breaches: number;
+}
+export declare class LatencyMonitor {
+    private metrics;
+    private thresholds;
+    constructor();
+    /**
+     * Record a latency sample
+     */
+    record(operation: string, latencyMs: number): void;
+    /**
+     * Get metrics for an operation
+     */
+    getMetrics(operation: string): LatencyMetrics | null;
+    /**
+     * Check if operation is within SLA
+     */
+    isWithinSLA(operation: string): boolean;
+    /**
+     * Clear metrics
+     */
+    clear(): void;
+}
+//# sourceMappingURL=commitment.d.ts.map

package/dist/core/commitment.d.ts.map

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