Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(tools): sync bounded output contracts

Browse Source
This commit is contained in:
Tianyi Cui
2026-07-22 01:11:47 +08:00
parent 932971e546
commit 6250c103b6
2 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/config-catalog.md
View File

@@ -1053,7 +1053,7 @@ export interface Config {
} }
``` ```
Source: [`packages/spill/spill-policy/src/index.ts:50`](../packages/spill/spill-policy/src/index.ts) Source: [`packages/spill/spill-policy/src/index.ts:51`](../packages/spill/spill-policy/src/index.ts)
## `@deepseek-ai/dsh-subagent-acp` ## `@deepseek-ai/dsh-subagent-acp`

6
docs/core-data-structures/filesystem.md
View File

@@ -205,7 +205,7 @@ interface FsPolicyExec {
## Read outcome (consumer / read rendering) ## Read outcome (consumer / read rendering)
A text read is bounded by line window, byte cap, and backend limits. The outcome the model-facing `read` tool renders is purely presentational; there is no `full`/`partial` view — authorization is freshness-based (the tool emits `fs/observed` with the stat's version directly), so any windowed read can authorize a later write/edit when the file is unchanged. Read windowing and this outcome shape live in `dsh-tool-fs` (the executor that owns the read), not in the policy plugin. A text read is bounded by line window, byte cap, and backend limits. After the byte cap is reached, scanning continues without retaining more lines so `totalLines` remains exact. The outcome the model-facing `read` tool renders is purely presentational; there is no `full`/`partial` view — authorization is freshness-based (the tool emits `fs/observed` with the stat's version directly), so any windowed read can authorize a later write/edit when the file is unchanged. Read windowing and this outcome shape live in `dsh-tool-fs` (the executor that owns the read), not in the policy plugin.
```ts type-equiv ```ts type-equiv
/** Outcome of a bounded text read — what {@link formatReadOutput} renders. */ /** Outcome of a bounded text read — what {@link formatReadOutput} renders. */
@@ -214,9 +214,9 @@ interface FileReadOutcome {
offset: number offset: number
/** Returned lines, already numbered. */ /** Returned lines, already numbered. */
lines: FileTextLine[] lines: FileTextLine[]
/** Total line count in the file, unless `truncatedByBytes` stopped scanning early. */ /** Exact total line count in the file. */
totalLines: number totalLines: number
/** Whether selected output hit the byte cap before EOF or the requested limit. */ /** Whether selected output hit the byte cap. */
truncatedByBytes?: true truncatedByBytes?: true
} }
``` ```