Back to home

henryZhouLikeStudy

dsh-lattice-runtime

DSH Lattice V1 runtime: event store, mailbox, session engine, state machines and security

Stars
0
Language
TypeScript
Created
Aug 14, 2026
Updated
Aug 14, 2026

Introduction

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.