relay-dsh-plugin-events

Relay Events for DeepSeek Harness

Now supports DSH 0.1.2-rc.1 while retaining 0.1.2-alpha.3 compatibility. Plugin 0.2.3 is verified on both releases and safely upgrades existing Relay databases. Install it from npm · Compatibility evidence.

Release channels: latest → 0.2.3; next → 0.2.3-rc.2.

npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-events@0.2.3
npx @deepseek-ai/dsh@0.1.2-rc.1 web

English | 中文

relay-dsh-plugin-events is the durable, provider-neutral Wait/Event/Delivery core for official DeepSeek Harness. It adds Agent tools, generic JSON ingress, delivery to the owning existing Session, recovery, and a Waiting Events settings surface without adding an execution backend.

The older internal npm channel remains available for integration testing and does not carry this compatibility guarantee. Use the exact 0.2.3 version in the latest-DSH command above; do not substitute @internal.

dsh plugin --profile web add --save-exact relay-dsh-plugin-events@internal
dsh web

Semantic routing and Monitor execution are separate plugins. Without a Router, Events uses exact event-type matching. Without Monitors, Wait-only registration and external ingress remain fully usable.

Database lifecycle

The Relay database is persistent and is not removed when the plugin is uninstalled. On startup, the plugin initializes a missing or empty database at the current schema. A recognized older schema is integrity-checked, backed up to <database>.backup-v<old>-to-v<current>.sqlite, and upgraded in one transaction before dependent indexes are created. The backup is verified and reused on a retry. Migration failure rolls back all schema changes and reports the backup path. An unknown non-empty schema, a corrupt database, foreign-key violations, or a schema newer than the plugin supports is rejected rather than guessed or silently modified.

See SPEC.md and delivery scenarios.

Set DSH_ROOT to the prepared immutable official DSH checkout, then run npm ci --ignore-scripts && npm run verify && npm pack. The npm package and locally packed tarball include built runtime files. A raw GitHub checkout intentionally does not track lib/; do not install #main as if it were a built release.

Tested official DSH references: 0.1.1-rc.2 at b150a551b8d465e31e418e1b2eaf5e79bbb7d28e, 0.1.2-alpha.2 at 0a53fb55bea101816fa226bb964ae2bed71c343b, and 0.1.2-alpha.3 at dd6322d604e00eec1ba5e0c8541159906a21094a.