dsh-agentfuse-plugin
安全与治理 活跃维护

dsh-agentfuse-plugin

MkaliezZ/dsh-agentfuse-plugin

提供确定性故障关闭的工具调用授权机制,通过允许、阻止、询问策略门控拦截未授权操作,每次决策附带可审计证据,并支持审批链延迟执行,保证所有调用有据可查。

3
Stars 标星
0
Forks 分支
3
Watchers 关注
0
Open Issues
TypeScript
主要语言
Apache-2.0
开源协议
153 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:MkaliezZ/dsh-agentfuse-plugin
git clone https://github.com/MkaliezZ/dsh-agentfuse-plugin.git
git clone git@github.com:MkaliezZ/dsh-agentfuse-plugin.git
README.md main

AgentFuse

Deterministic, fail-closed tool-call authorization for AI agents — with evidence.
Status: ALPHA · seeking the first real (non-self) deployment

AgentFuse is a pre-dispatch policy boundary for side-effect-capable AI agent
tools, ported from the DHMS AgentFuse Python project
(MkaliezZ/dhms-engine).

AGENTFUSE_IS_A_DANGER_CLASSIFIER=false
AGENTFUSE_IS_A_POLICY_AND_AUTHORIZATION_BOUNDARY=true
AGENTFUSE_DECISIONS=allow|block
AGENTFUSE_DEFERRALS=ask
AGENTFUSE_FAILS_CLOSED=true

A blocked call is a completed policy decision with non-execution evidence
never a failed tool execution. Evidence carries reason codes, policy ids, and a
canonical arguments hash, never raw arguments or credentials.

Packages

Package What it is Depends on
packages/core · @dhms-agentfuse/core Framework-agnostic engine: decision/evidence vocabulary, deterministic policy resolution, canonical hashing nothing
packages/dsh-agentfuse · @dhms-agentfuse/dsh-agentfuse DeepSeek Harness guard plugin: tested tools/pre-execute gate, DSH config schema, durable agentfuse/decision session event, and host-owned approval deferral (askTools) @dhms-agentfuse/core, DSH

The core defines the bounded policy vocabulary; the DSH package is one
experimental adapter. Potential future integrations are tracked in the
roadmap, but are not implemented here.

Quickstart (DeepSeek Harness)

# cordis.yml (or a cordis.patch.yml insert)
- id: agentfuse
  name: '@dhms-agentfuse/dsh-agentfuse'
  config:
    defaultAction: block      # fail-closed fall-through
    denyTools: []             # deterministic block, always wins
    askTools: []              # defer to the DSH human-approval chain
    allowTools: []            # non-empty = only these names may run
    logDecisions: false       # durable evidence; needs in-repo catalog

See the adapter README for the policy
order, the approval integration, and the install paths (bundle + PR).

Cross-adapter conformance

The DSH adapter consumes the provider-neutral DHMS AgentFuse v3.6.2 fixture
snapshot with source commit and SHA-256 provenance. Against DeepSeek Harness
commit 99f6f02fecdb7dff40c3fbc9470f5907c29f74ca, the real integrated
tools/pre-execute path records 11 PASS and 3 explicitly justified N/A cases;
it does not claim coverage of unwrapped or future DSH paths.

See the adapter conformance notes
and the checked-in fixture provenance.

Repository layout

packages/
  core/            @dhms-agentfuse/core — zero runtime dependencies
  dsh-agentfuse/   @dhms-agentfuse/dsh-agentfuse — the DSH adapter (bundle)
ROADMAP.md         phases, version line, stop-lines

Relationship to DHMS

AgentFuse is the runtime-execution-control line of DHMS (Digital Hyperthymesia
Memory Systems). The engine is a faithful TypeScript port of
dhms_agentfuse's decision engine and agentfuse-evidence-schema-v0.1;
decision and execution remain separate lifecycle facts.

License

Apache-2.0. See LICENSE.