dsh-lattice-runtime

dsh-lattice-runtime

Runtime engine for DSH Lattice V1.

Scope

This package implements the runtime side of the DSH Lattice contract:

• In-memory and durable JSONL append-only event stores with replay and atomic append semantics.
• Task and Assignment state machines.
• Central durable mailbox with direct/group/broadcast routing, offline outbox, dead-letter queue, TTL, ack, at-least-once delivery, and deterministic idempotent deduplication.
• Adapter registry and required-vs-observed capability negotiation.
• Session decision engine (auto/reuse/fork/new) with compatibility fingerprint, fail-loud forced reuse, and deterministic handoff bundles.
• LatticeRuntime with utoRun, agentMessage, status, cancel, and recover.
• Event projections and secret-safe structured errors.

All external side effects are kept behind adapter interfaces; tests use fake adapters.

Usage

import { LatticeRuntime, InMemoryEventStore } from "dsh-lattice-runtime";

const runtime = new LatticeRuntime({ stores, adapters });
const result = await runtime.utoRun(request);

License

Apache-2.0. See LICENSE and NOTICE.