@hy-sde-org/dsh-tool-fs-internal-urls

The read / write / edit filesystem tool suite for DeepSeek Harness with internal-URL routing built in: when ctx.internalUrls is mounted, these tools resolve conflict://, pr://, issue:// URLs (and :conflicts selectors) through the registry instead of a filesystem path, and scan plain filesystem reads for git conflict blocks — registering them with the session history and appending a resolution notice. This is the hy-sde fork's dsh-tool-fs (with src/internal-routing.ts + the read.ts/write.ts hunks) shipped as an agent-scope shadow so it works on stock DeepSeek Harness releases (dsh-v0.1.2-rc.1 and later).

Mount it in an agent preset (see examples/agent-preset/ in @hy-sde-org/dsh-internal-urls): agent-scope shadowing makes these THE read/write/edit for that session, while plain filesystem behavior is identical to the stock tools. Without a mounted ctx.internalUrls registry the routing branch never triggers and the tools are stock-equivalent.

read — line-numbered windows (caps: readLimit 2000 lines, readMaxLineLength 2000 chars, readMaxBytes 50 KiB, stream threshold 10 MiB), fs/observed emission, internal-URL virtual reads, conflict surfacing + notice.
write — create/overwrite with sandbox-policy escalation (fs/write-intent waterfall, error remediation). Internal-URL writes (conflict:// resolution) dispatch to the handler with the session context and the resolved policy so the backing-file splice stays fenced.
edit — literal single-match (or replace-all) edits over ctx.fs with guard + remediation, unchanged from the harness (this package keeps the trio together).
read_image — registers only while attachments is mounted, unchanged.

Install

As a routing surface this package is useless without @hy-sde-org/dsh-internal-urls; follow that package's README — all three packages install together:

dsh plugin --profile web add @hy-sde-org/dsh-internal-urls \
  @hy-sde-org/dsh-tool-fs-internal-urls \
  @hy-sde-org/dsh-tool-fs-search-internal-urls

Then copy the preset from packages/internal-urls/examples/agent-preset/ in this repo (or the installed package) to ~/.dsh/.agent-presets// — its tool-fs-internal-urls row is this package.

Defaults & caps

Key	Default	Meaning
`readLimit`	`2000`	lines per `read` call
`readMaxLineLength`	`2000`	chars per returned line
`readMaxBytes`	`50 KiB`	bytes of selected output
`readStreamMinSize`	`10 MiB`	stream files at/above this size
`enableEdit`	`true`	set `false` to leave `edit` to another provider

@hy-sde-org/dsh-tool-fs-internal-urls

설치

문서