@dsh-lattice/adapter-dsh

DSH Lattice V1 provider adapter for the DeepSeek Harness public seam.

This package is an independent community adapter, part of the DSH Lattice facade project. It is not affiliated with, endorsed by, or sponsored by DeepSeek AI, and it does not import the upstream @deepseek-ai/dsh-root package.

What it provides

Module	Responsibility
capabilities	Capability detection: required-vs-observed comparison that fails loud (ECC-V1.0 §12, §22.2)
session-mapping	Canonical agentId ↔ session mapping, identity kinds, explicit SessionLink lineage, compatibility fingerprints (§10, §16.3)
events	Lattice/audit events with REQUIRED tenantId, secret redaction ``, leak scan (§19.3, §19.4)
manifest	Adapter manifest validation; credentialRef references only — values are never inlined (§12, §19.3)
adapter	DshAdapter implementing the Lattice adapter contract over a minimal SubagentsSeam

Quick start

import { createDshAdapter } from "@dsh-lattice/adapter-dsh";

const adapter = createDshAdapter({
  id: "dsh-sdk",
  descriptor: {
    name: "dsh-sdk",
    package: "@dsh-lattice/adapter-dsh",
    adapterVersion: "1.0.0",
    requiredCapabilities: ["continuation", "directMessage", "structuredOutput", "progress"],
    observedCapabilities: ["continuation", "directMessage", "structuredOutput", "progress", "oneShot"],
    credentialRef: { kind: "env", name: "DSH_SDK_TOKEN" },
  },
  seam: harnessCtx.subagents, // the live ctx.subagents object
});

// Fail-loud gate before a run starts:
const preflight = adapter.preflight(["continuation", "artifacts"]);
if (!preflight.ok) {
  // capability_mismatch: missing [artifacts]
}

const envelope = await adapter.runOneShot({
  prompt: "review this diff",
  tenantId: "tenant_1",
  runId: "run_1",
  taskId: "tsk_1",
  assignmentId: "asn_1",
  idempotencyKey: "idem_...",
});

Capability detection

requiredCapabilities come from the project config; observedCapabilities come from the adapter manifest plus a runtime probe refreshed on every startup. If observed ⊉ required the adapter emits and the run is rejected — never silently degraded.