@longarc/mdash 3.1.2 → 3.1.3

package/dist/context/fragment.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Caret — Context Fragment Implementation
+ * @module @longarcstudios/caret/fragment
+ *
+ * The atomic unit of structured context.
+ * Immutable, sealed, attributable.
+ */
+import type { ContextFragment, SemanticUnit, SemanticType, TokenCount, Constraint, Attribution, SourceURI, TrustLevel } from './types.js';
+/** Tokenizer function type */
+type Tokenizer = (content: unknown) => TokenCount;
+/**
+ * Set a custom tokenizer function.
+ */
+export declare function setTokenizer(tokenizer: Tokenizer): void;
+/**
+ * Count tokens in content using current tokenizer.
+ */
+export declare function countTokens(content: unknown): TokenCount;
+/**
+ * Create a SemanticUnit from content.
+ */
+export declare function createSemanticUnit<T>(data: T, options?: {
+    type?: SemanticType;
+    compression_ratio?: number;
+}): SemanticUnit<T>;
+/** Options for creating a fragment */
+export interface CreateFragmentOptions<T = unknown> {
+    /** The content to store */
+    content: T;
+    /** Source URI for provenance */
+    source: SourceURI | string;
+    /** Attribution type */
+    attribution: Attribution;
+    /** Trust level (0-100, optional) */
+    trust_level?: number;
+    /** Constraints to apply */
+    constraints?: Constraint[];
+    /** Parent fragment for provenance chain */
+    parent?: ContextFragment;
+    /** Optional signature */
+    signature?: string;
+    /** Semantic type override */
+    semantic_type?: SemanticType;
+    /** Secret key for sealing */
+    seal_key: string;
+}
+/**
+ * Create a new ContextFragment.
+ * This is the primary factory function for fragments.
+ */
+export declare function createFragment<T = unknown>(options: CreateFragmentOptions<T>): Promise<ContextFragment<T>>;
+/**
+ * Verify a fragment's integrity.
+ * Checks both the content hash and the HMAC seal.
+ */
+export declare function verifyFragment(fragment: ContextFragment, seal_key: string): Promise<{
+    valid: boolean;
+    errors: string[];
+}>;
+/**
+ * Derive a new fragment from an existing one.
+ * Creates a new fragment with the parent's provenance extended.
+ */
+export declare function deriveFragment<T, U = T>(parent: ContextFragment<T>, options: {
+    content: U;
+    source: SourceURI | string;
+    attribution?: Attribution;
+    trust_level?: number;
+    constraints?: Constraint[];
+    seal_key: string;
+}): Promise<ContextFragment<U>>;
+/**
+ * Clone a fragment with new constraints.
+ * Creates a new fragment with the same content but different constraints.
+ */
+export declare function withConstraints<T>(fragment: ContextFragment<T>, constraints: Constraint[], seal_key: string): Promise<ContextFragment<T>>;
+/**
+ * Get the age of a fragment in milliseconds.
+ */
+export declare function getFragmentAge(fragment: ContextFragment): number;
+/**
+ * Check if a fragment is expired based on time constraints.
+ */
+export declare function isFragmentExpired(fragment: ContextFragment): boolean;
+/**
+ * Get the trust level of a fragment (minimum in chain).
+ */
+export declare function getFragmentTrust(fragment: ContextFragment): TrustLevel;
+/**
+ * Serialize a fragment to JSON.
+ */
+export declare function serializeFragment(fragment: ContextFragment): string;
+/**
+ * Deserialize a fragment from JSON.
+ * Note: Does NOT verify integrity — call verifyFragment separately.
+ */
+export declare function deserializeFragment<T = unknown>(json: string): ContextFragment<T>;
+export {};
+//# sourceMappingURL=fragment.d.ts.map

package/dist/context/fragment.d.ts.map

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

package/dist/context/fragment.js

@@ -0,0 +1,316 @@
+/**
+ * Caret — Context Fragment Implementation
+ * @module @longarcstudios/caret/fragment
+ *
+ * The atomic unit of structured context.
+ * Immutable, sealed, attributable.
+ */
+import { sha256Object } from './crypto/hash.js';
+import { sealFragment, verifyFragmentSeal } from './crypto/hmac.js';
+import { createProvenanceRecord, createProvenanceChain, extendProvenanceChain, } from './provenance.js';
+// ============================================================================
+// UUID GENERATION
+// ============================================================================
+/**
+ * Generate a UUID v4.
+ * Uses crypto.randomUUID if available, falls back to crypto.getRandomValues.
+ * SECURITY: Never falls back to Math.random — fails instead.
+ */
+function generateUUID() {
+    // Preferred: native randomUUID
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback: manual UUID from getRandomValues (still cryptographically secure)
+    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+        const bytes = new Uint8Array(16);
+        crypto.getRandomValues(bytes);
+        // Set version (4) and variant (RFC4122)
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        const hex = Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
+        return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    }
+    // SECURITY: Do not fall back to Math.random — fail secure
+    throw new Error('Cryptographically secure random number generator not available');
+}
+// ============================================================================
+// TOKEN COUNTING
+// ============================================================================
+/** Default tokenizer: approximate cl100k_base behavior */
+function defaultTokenCount(text) {
+    // Rough approximation: ~4 chars per token for English
+    // More accurate would require actual tokenizer
+    const charCount = text.length;
+    const estimate = Math.ceil(charCount / 4);
+    return estimate;
+}
+/** Current tokenizer (can be replaced) */
+let currentTokenizer = (content) => {
+    const text = typeof content === 'string'
+        ? content
+        : JSON.stringify(content);
+    return defaultTokenCount(text);
+};
+/**
+ * Set a custom tokenizer function.
+ */
+export function setTokenizer(tokenizer) {
+    currentTokenizer = tokenizer;
+}
+/**
+ * Count tokens in content using current tokenizer.
+ */
+export function countTokens(content) {
+    return currentTokenizer(content);
+}
+// ============================================================================
+// SEMANTIC UNIT
+// ============================================================================
+/**
+ * Create a SemanticUnit from content.
+ */
+export function createSemanticUnit(data, options = {}) {
+    const type = options.type ?? inferSemanticType(data);
+    const token_count = countTokens(data);
+    return {
+        type,
+        data,
+        token_count,
+        compression_ratio: options.compression_ratio,
+    };
+}
+/**
+ * Infer semantic type from data.
+ */
+function inferSemanticType(data) {
+    if (typeof data === 'string') {
+        return 'text';
+    }
+    if (typeof data === 'object' && data !== null) {
+        // Check for special object patterns
+        if ('$ref' in data || 'uri' in data || 'url' in data) {
+            return 'reference';
+        }
+        return 'structured';
+    }
+    return 'text';
+}
+/**
+ * Create a new ContextFragment.
+ * This is the primary factory function for fragments.
+ */
+export async function createFragment(options) {
+    const id = generateUUID();
+    const sealed_at = new Date().toISOString();
+    // Create semantic unit
+    const content = createSemanticUnit(options.content, {
+        type: options.semantic_type,
+    });
+    // Create provenance
+    const record = await createProvenanceRecord({
+        source: options.source,
+        attribution: options.attribution,
+        trust_level: options.trust_level,
+        parent_hash: options.parent?.hash ?? null,
+        signature: options.signature,
+    });
+    let provenance;
+    if (options.parent) {
+        provenance = await extendProvenanceChain(options.parent.provenance, record);
+    }
+    else {
+        provenance = await createProvenanceChain(record);
+    }
+    // Compute content hash
+    const hash = await sha256Object({
+        content,
+        provenance,
+        sealed_at,
+    });
+    // Create seal
+    const fragmentData = {
+        id,
+        hash,
+        content,
+        provenance,
+        sealed_at,
+        constraints: options.constraints ?? [],
+    };
+    const seal = await sealFragment(fragmentData, options.seal_key);
+    return {
+        id,
+        hash,
+        content,
+        provenance,
+        sealed_at,
+        seal,
+        constraints: options.constraints ?? [],
+        version: 'v3.1',
+    };
+}
+// ============================================================================
+// FRAGMENT VERIFICATION
+// ============================================================================
+/**
+ * Verify a fragment's integrity.
+ * Checks both the content hash and the HMAC seal.
+ */
+export async function verifyFragment(fragment, seal_key) {
+    const errors = [];
+    // Verify content hash
+    const expectedHash = await sha256Object({
+        content: fragment.content,
+        provenance: fragment.provenance,
+        sealed_at: fragment.sealed_at,
+    });
+    if (expectedHash !== fragment.hash) {
+        errors.push('Content hash mismatch');
+    }
+    // Verify HMAC seal
+    const sealValid = await verifyFragmentSeal({
+        id: fragment.id,
+        hash: fragment.hash,
+        content: fragment.content,
+        provenance: fragment.provenance,
+        sealed_at: fragment.sealed_at,
+        constraints: fragment.constraints,
+        seal: fragment.seal,
+    }, seal_key);
+    if (!sealValid) {
+        errors.push('HMAC seal verification failed');
+    }
+    // Verify version (accept both v3.1 and legacy 1.0)
+    if (fragment.version !== 'v3.1' && fragment.version !== '1.0') {
+        errors.push(`Unknown fragment version: ${fragment.version}`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+// ============================================================================
+// FRAGMENT OPERATIONS
+// ============================================================================
+/**
+ * Derive a new fragment from an existing one.
+ * Creates a new fragment with the parent's provenance extended.
+ */
+export async function deriveFragment(parent, options) {
+    return createFragment({
+        content: options.content,
+        source: options.source,
+        attribution: options.attribution ?? 'derived',
+        trust_level: options.trust_level,
+        constraints: [...(options.constraints ?? parent.constraints)],
+        parent,
+        seal_key: options.seal_key,
+    });
+}
+/**
+ * Clone a fragment with new constraints.
+ * Creates a new fragment with the same content but different constraints.
+ */
+export async function withConstraints(fragment, constraints, seal_key) {
+    return deriveFragment(fragment, {
+        content: fragment.content.data,
+        source: fragment.provenance.head.source,
+        attribution: 'derived',
+        constraints,
+        seal_key,
+    });
+}
+/**
+ * Get the age of a fragment in milliseconds.
+ */
+export function getFragmentAge(fragment) {
+    const sealed = new Date(fragment.sealed_at).getTime();
+    return Date.now() - sealed;
+}
+/**
+ * Check if a fragment is expired based on time constraints.
+ */
+export function isFragmentExpired(fragment) {
+    for (const constraint of fragment.constraints) {
+        if (constraint.kind === 'time') {
+            // Check max_age
+            if (constraint.max_age_ms !== undefined) {
+                const age = getFragmentAge(fragment);
+                if (age > constraint.max_age_ms) {
+                    return true;
+                }
+            }
+            // Check not_after
+            if (constraint.not_after !== undefined) {
+                const deadline = new Date(constraint.not_after).getTime();
+                if (Date.now() > deadline) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Get the trust level of a fragment (minimum in chain).
+ */
+export function getFragmentTrust(fragment) {
+    let min = fragment.provenance.head.trust_level;
+    let current = fragment.provenance.tail;
+    while (current !== null) {
+        if (current.head.trust_level < min) {
+            min = current.head.trust_level;
+        }
+        current = current.tail;
+    }
+    return min;
+}
+// ============================================================================
+// SERIALIZATION
+// ============================================================================
+/**
+ * Serialize a fragment to JSON.
+ */
+export function serializeFragment(fragment) {
+    return JSON.stringify(fragment);
+}
+/**
+ * Sanitize an object to prevent prototype pollution.
+ * Removes __proto__, constructor, and prototype properties recursively.
+ */
+function sanitizeObject(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(sanitizeObject);
+    }
+    const sanitized = Object.create(null);
+    for (const key of Object.keys(obj)) {
+        // Block dangerous properties
+        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
+            continue;
+        }
+        sanitized[key] = sanitizeObject(obj[key]);
+    }
+    return sanitized;
+}
+/**
+ * Deserialize a fragment from JSON.
+ * Note: Does NOT verify integrity — call verifyFragment separately.
+ */
+export function deserializeFragment(json) {
+    const raw = JSON.parse(json);
+    // Sanitize to prevent prototype pollution
+    const parsed = sanitizeObject(raw);
+    // Type validation
+    if (!parsed.id || !parsed.hash || !parsed.content || !parsed.provenance) {
+        throw new Error('Invalid fragment structure');
+    }
+    if (parsed.version !== 'v3.1' && parsed.version !== '1.0') {
+        // SECURITY: Do not leak version value in error message
+        throw new Error('Unsupported fragment version');
+    }
+    return parsed;
+}
+//# sourceMappingURL=fragment.js.map

package/dist/context/fragment.js.map

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

package/dist/context/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * mdash v3.1 — Context Module (formerly Caret)
+ * @module @longarcstudios/mdash/context
+ * @version 3.1.0
+ *
+ * The context primitive runtime, now integrated into mdash.
+ *
+ * Architecture: LLM at the edges, cryptography at the core.
+ *
+ * v3.1.0: Merged into mdash from Caret v0.2.0
+ * - MdashActionCode for standardized action vocabulary
+ * - InfluenceBudget for MCCA-compliant bounds
+ * - InfluenceConstraint for influence-based resolution
+ * - Outcome<T> for Intent-Experience-Utility tracking
+ * - Atomic encoding with coreference resolution
+ * - Utility learning and credit assignment utilities
+ *
+ * @example
+ * ```ts
+ * import { createCaret, requireInfluence } from '@longarcstudios/caret';
+ *
+ * const caret = createCaret({ seal_key: 'your-secret-key' });
+ *
+ * // Seal content into a fragment with MCCA constraints
+ * const fragment = await caret.seal({
+ *   content: { message: 'Hello, world!' },
+ *   source: 'app://example/greeting',
+ *   attribution: 'system',
+ *   constraints: [
+ *     requireInfluence({ system: 0.45, user: 0.30, environment: 0.15, assistant: 0.10 })
+ *   ],
+ *   atomic_encoding: { enabled: true }
+ * });
+ *
+ * // Compose multiple fragments
+ * const manifold = await caret.compose([
+ *   fragment,
+ *   anotherFragment
+ * ], { ceiling: '8k tokens' });
+ *
+ * // Resolve through constraints
+ * const result = await caret.resolve(fragment);
+ * if (result.success) {
+ *   console.log('Fragment is valid:', result.fragment);
+ * }
+ * ```
+ */
+import type { CaretRuntime, FragmentStore } from './types.js';
+/**
+ * Options for creating a Caret instance.
+ */
+export interface CreateCaretOptions {
+    /** Secret key for HMAC sealing (required) */
+    seal_key: string;
+    /** Default trust level for unspecified sources */
+    default_trust?: number;
+    /** Whether to enforce signature requirements */
+    require_signatures?: boolean;
+    /** Token counting strategy */
+    tokenizer?: 'cl100k' | 'p50k' | 'custom';
+    /** Custom tokenizer function */
+    custom_tokenizer?: (text: string) => number;
+    /** Custom store implementation */
+    store?: FragmentStore;
+}
+/**
+ * Create a Caret runtime instance.
+ *
+ * @param options - Configuration options
+ * @returns The Caret runtime
+ *
+ * @example
+ * ```ts
+ * const caret = createCaret({
+ *   seal_key: process.env.CARET_SEAL_KEY!,
+ *   default_trust: 50,
+ * });
+ * ```
+ */
+export declare function createCaret(options: CreateCaretOptions): CaretRuntime;
+export type { ContextFragment, Manifold, FragmentId, Hash, Seal, Timestamp, SourceURI, TokenCount, TrustLevel, Attribution, SemanticUnit, SemanticType, ProvenanceRecord, ProvenanceChain, Constraint, TimeConstraint, ScopeConstraint, TrustConstraint, SignatureConstraint, InfluenceConstraint, MdashActionCode, InfluenceBudget, Outcome, ExecutionStep, ExecutionTrace, UtilityScore, UtilityFeedback, LiabilityShare, StepCredit, CreditAssignment, CoreferenceContext, ComposeOptions, CompositionStrategy, ResolutionResult, ConstraintViolation, CaretRuntime, CaretConfig, SealOptions, FragmentStore, } from './types.js';
+export { maxAge, notBefore, notAfter, allowDomains, requireTrust, requireSignature, requireInfluence, requireMCCA, } from './resolve.js';
+export type { ResolutionContext } from './resolve.js';
+export { MemoryStore, CachedStore, CompositeStore, ExtendedMemoryStore, createStore, } from './store.js';
+export type { EmbeddingFunction } from './store.js';
+export { verifyFragment, serializeFragment, deserializeFragment, getFragmentAge, getFragmentTrust, isFragmentExpired, countTokens, setTokenizer, } from './fragment.js';
+export { verifyManifold, getManifoldStats, fitsInBudget, parseTokenCeiling, } from './compose.js';
+export { createProvenanceRecord, createProvenanceChain, extendProvenanceChain, flattenChain, verifyChain, mergeChains, getMinTrust, getMaxTrust, } from './provenance.js';
+export { sha256, sha256Object, sha256Binary, rollingHash, verifyHash, isValidHash, deterministicStringify, } from './crypto/hash.js';
+export { hmacSeal, hmacVerify, isValidSeal, } from './crypto/hmac.js';
+export { isHash, isFragmentId, isTimestamp, isTrustLevel, isTokenCount, isContextFragment, isValidInfluenceBudget, isMdashActionCode, sumInfluence, } from './types.js';
+export { resolveCoreferences, createDefaultContext, hasUnresolvedCoreferences, extractEntityIds, canonicalEncode, computeCommitmentHash, isValidSubject, isValidTimestamp, } from './utils/atomic.js';
+export { updateUtilityScore, updateOutcomeUtility, createInitialUtility, createUtilityFromHistory, predictSuccess, expectedUtility, compareUtility, selectBestOutcome, } from './utils/utility.js';
+export { assignCredit, validateCreditAssignment, attributeLiability, validateLiabilityShares, createDefaultInfluenceBudget, isMCCACompliant, normalizeInfluenceBudget, addInfluenceBudgets, computeTraceInfluence, } from './utils/credit.js';
+export declare const VERSION = "3.1.0";
+export declare const FORMERLY = "Caret v0.2.0";
+/** Alias for createCaret - use this for new code */
+export declare const createContext: typeof createCaret;
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

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