arrow949/dsh-turn-approval

dsh-turn-approval · Task-Scoped Approval

中文 | English

Some high-risk actions deserve your explicit approval. Repeating that approval for the same task should not be necessary.

dsh-turn-approval adds an Allow for this task action to the DeepSeek Harness (DSH) Web approval card. When an agent requests danger-full-access, you can allow matching escalations for the rest of the current task only. The grant disappears when the task ends.

What it does

The default DSH permission remains workspace-write + ask; this plugin never changes it into a global high-permission mode.

For a danger-full-access request, the approval card offers:

[Reject] [Allow once] [Allow for this task]

• Reject declines the current action.
• Allow once permits only the current action.
• Allow for this task automatically permits later matching danger-full-access requests in the current turn, then expires immediately at turn/end.

Install

Install from GitHub

Pin a commit SHA so later repository updates cannot silently change the code running on your machine:

dsh plugin --profile web add github:arrow949/dsh-turn-approval#<commit-sha>

The repository ships built, pure ESM JavaScript. A GitHub install needs neither a prepare script nor pnpm allowBuilds permission.

Install from a local directory

dsh plugin --profile web add ./dsh-turn-approval

Restart DSH Web and hard-refresh the browser (Ctrl+Shift+R). The third button confirms that the plugin has loaded.

Use

1. Use DSH normally; the default remains workspace-write + ask.
2. When the agent requests danger-full-access, review the approval reason and command.
3. To allow matching escalations for the remainder of the current task, select Allow for this task.
4. The next user message starts a new task and prompts again as usual.

Verify and uninstall

Verify that the profile contains the bundle layer:

dsh --profile web --dump-config

Uninstall:

dsh plugin --profile web remove dsh-turn-approval

Uninstalling removes both the Node and client halves. The approval card automatically returns to the two-button DSH default, with no changes left in official DSH files.

Security boundaries

• Memory only: grants are never written to disk. They expire when the DSH process restarts, the plugin unloads, or the session/agent is disposed (fail closed).
• Task scoped: a grant is bound to session + turn; it never turns an entire session into full access.
• No cross-session grants: a grant in one session cannot affect another. Subagents use distinct sessions and do not inherit it.
• Type isolated: only matching danger-full-access escalations are automatically allowed. workspace-write and other approvals still prompt individually.
• User initiated: only the approval-card action can create a grant; the model has no self-service task-grant route.
• Auditable: automatically allowed requests retain their approval event records.

After Allow for this task is selected, the plugin first asks the host to create the task grant. If that endpoint returns a non-2xx response or the request fails, the card clearly reports the failure and remains retryable. It does not pretend the grant succeeded or silently downgrade to Allow once.

Implementation and compatibility

This is an official DSH bundle: package.json declares dsh.bundle.patch, and cordis.patch.yml adds the plugin to a profile. Its client half renders through the official conversation.composer chain slot at higher priority; it does not modify any official DSH bundle file, and uninstalling restores the standard UI.

The current appearance reuses internal CSS class names from DSH's ApprovalPanel. If DSH changes that component structure or its CSS-module class names, this plugin may need a compatibility release. This is adaptation to DSH internals, not modification of official files.

Web only: headless profiles have no UI entry point, so the task-grant endpoint is not registered there.

Instructions for AI agents

After the user explicitly asks to install this plugin, run:

dsh plugin --profile web add github:arrow949/dsh-turn-approval#<commit-sha>
dsh --profile web --dump-config

Then ask the user to restart DSH Web and hard-refresh the browser. Do not modify official DSH bundle files. To uninstall:

dsh plugin --profile web remove dsh-turn-approval

Development and tests

pnpm install
pnpm test

The current suite covers turn and session isolation, type isolation, endpoint anti-forgery, restart fail-closed behavior, and the Cordis integration path.

License

MIT