DeepSeek Harness (DSH) persists action facts into session logs. These facts are raw data, and developers need a way to reconstruct them into a human-readable timeline. AgentFuse handles authorization for tool calls, while mkaliezz/dsh-action-ledger handles projection of the action lifecycle.

It is a plugin maintained by MkaliezZ that projects tool calls, approval lifecycles, and results into a bounded ledger through the /action-ledger command.

Core Features

The plugin works by reading persisted DSH facts. When the corresponding native DSH facts exist, it projects the following lifecycles:

  1. requested -> approval-requested -> approved | denied -> completed | failed

It guarantees deterministic sequence ordering and provides bounded /action-ledger output. It does not duplicate raw tool arguments and remains a read-only projection (no tool dispatch or source mutation).

Usage

In a DSH session, use the /action-ledger command. This command parses existing persisted facts (tool calls, approval facts, and results) and reconstructs a readable ledger. It does not create custom event types, so it does not require patching DSH’s generated event catalog.

Notes

  • Not a persistence replacement: It does not replace DSH session persistence.
  • Not an authorization system: It is not an authorization system.
  • No data fabrication: It does not fabricate missing lifecycle facts.
  • Physical side effects: It does not prove that physical side effects (such as disk writes) occurred; it only proves that DSH recorded the relevant facts.
  • Compatibility: DSH is still in developer preview, so compatibility must be revalidated against a pinned DSH version.

The tool helps debug and audit agent behavior by providing a bounded, readable view of what DSH recorded.