# @private.me/xcontinuity — LLM Context

> Cryptographic state continuity for AI agents — Reverse-XorIDA with trust substrate, provenance, and enforcement

## Overview

xcontinuity v2.0.0 provides cryptographic state continuity with a trust substrate for AI agents. Core primitive: Reverse-XorIDA exploits GF(2) linearity for O(delta) incremental state updates. Trust substrate adds Ed25519 provenance, trust tiers with TTL decay, conflict adjudication, mission-anchored enforcement, and ratification.

## Key APIs

- `SessionManager.create(config)` — Create session (optional trust substrate integration)
- `session.updateState(patch)` — Merge patch (routes through enforcement + trust store if configured)
- `session.snapshot(description?, tags?)` — Persist state as XorIDA shares
- `session.restore(stateId)` — Reconstruct state from shares
- `session.suspend()` / `session.resume()` — Pause and resume sessions
- `TrustStore` — Trust-annotated entries with write/ratify/restore/hypothesisMode
- `generateSigningKeyPair()` / `signEntry()` / `verifyEntry()` — Ed25519 provenance
- `MissionGuard` — Human-anchored constraint evaluation
- `EnforcementLoop` — Reject/rewrite/escalate with violation tracking
- `PolicyAdjudicator` / `ConsensusAdjudicator` — Deterministic conflict resolution
- `undoDelta` / `branchState` / `squashDeltas` — Algebraic extensions over GF(2)
- `blindUpdateShare` / `refreshShares` / `blindEqual` — Zero-knowledge share operations
- `Chronicle` — Ordered state history with contradiction detection

## Trust Tiers

ratified (signed + verified) → inherited (unsigned or decayed) → quarantined (invalid signature)
TTL decay: ratified entries auto-downgrade to inherited after configurable maxAge (default 30 days)

## Dependencies

- @private.me/shared (Result<T,E>, ok(), err())
- @private.me/crypto (XorIDA, HMAC, padding, UUID, base64)
- Web Crypto API (Ed25519 — zero external crypto dependencies)

## Error Handling

All fallible functions return `Result<T, ContinuityError>`. Check `result.ok` before accessing `result.value`. 23 structured error codes across 7 families.

## Resources

- npm: https://npmjs.com/package/@private.me/xcontinuity
- GitHub: https://github.com/xail-io/xail/tree/main/packages/xcontinuity
