@deepseek-ai/dsh-tool-str-replace-editor 0.0.1-rc.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DeepSeek
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/fs/tool-str-replace-editor/README.md
+README.md: 8b4772cc4eb40e23a5d6ea8e409188b5033318ba
+README.zh.md: b9ccf285870f2d02a2195b70dcd24fd37794976e

package/README.md

@@ -0,0 +1,52 @@
+# @deepseek-ai/dsh-tool-str-replace-editor
+
+English | [中文](README.zh.md)
+
+Standalone model-facing `str_replace_editor` over `ctx.fs`. It can be composed with persistent Bash, one-shot Bash, sandboxed Bash, or another terminal surface.
+
+## Config
+
+| Key | Default | Meaning |
+|---|---:|---|
+| `maxOutputChars` | `16000` | Prefix characters retained for file and directory views. |
+| `description` | Editor command guide | Model-facing tool description. |
+
+## Tool
+
+The schema provides `view`, `create`, `str_replace`, and `insert` over absolute paths. File views use one-based line numbers and preserve content tabs, so displayed text remains valid literal replacement input; directory views omit hidden, dependency, and Python-cache entries and descend two levels. A metadata miss from `view`, `str_replace`, or `insert` records confirmed absence before returning `FS_NOT_FOUND`, so a later `create` can recover an externally deleted path through the mounted policy's guarded-create flow; absence never authorizes `str_replace` or `insert`. Replacement requires one unique literal match and reports errors only in the public `old_str` vocabulary. Insert follows the selected zero-based insertion boundary without adding an implicit trailing newline. Mutations preserve tabs outside the requested edit.
+
+## Model Experience
+
+### Tool schema
+
+#### What the model sees
+
+The generated [`str_replace_editor` schema](../../../docs/tool-catalog.md#deepseek-aidsh-tool-str-replace-editor), including the configured `description`. The plugin contributes no standalone system-prompt section.
+
+#### Token effect
+
+Fixed schema cost while `str_replace_editor` is visible.
+
+#### KV Cache effect
+
+Prefix-stable while the configured description and schema remain unchanged.
+
+### Tool results
+
+#### What the model sees
+
+Views return numbered text or a shallow directory listing. Calls expose file locations, and create/replace calls expose diff cards to presentation surfaces. Mutations return concise confirmations. Long views keep their prefix and append a clipping notice.
+
+#### Token effect
+
+Data-dependent and bounded by `maxOutputChars` plus the fixed clipping notice.
+
+#### KV Cache effect
+
+Append-only tool results follow the reusable request prefix.
+
+## Known Limitations and Deferred Work
+
+- Operations target UTF-8 text; binary files are unsupported.
+- `str_replace` intentionally rejects zero or multiple matches and has no `replace_all` argument.
+- Every mutation goes through `fs/write-intent` or `fs/edit-intent`, resolves the current session sandbox policy, and delegates enforcement to the mounted filesystem and policy plugins.

package/README.zh.md

@@ -0,0 +1,52 @@
+# @deepseek-ai/dsh-tool-str-replace-editor
+
+[English](README.md) | 中文
+
+基于 `ctx.fs` 的独立模型可见 `str_replace_editor`。它可与持久 Bash、一次性 Bash、沙箱 Bash 或其他终端接口组合。
+
+## 配置
+
+| 键 | 默认值 | 含义 |
+|---|---:|---|
+| `maxOutputChars` | `16000` | 文件和目录查看结果保留的前缀字符数。 |
+| `description` | 编辑器命令指南 | 面向模型的工具描述。 |
+
+## 工具
+
+schema 提供针对绝对路径的 `view`、`create`、`str_replace` 与 `insert`。文件查看使用从 1 开始的行号，并保留内容中的制表符，因此显示的文本仍可作为有效的字面量替换输入；目录查看忽略隐藏、依赖与 Python 缓存条目并下探两层。`view`、`str_replace` 或 `insert` 发生元数据未命中时，工具会在返回 `FS_NOT_FOUND` 前记录确认缺失，因此后续 `create` 可以通过已挂载策略的防护创建流程恢复外部删除的路径；缺失状态绝不会授权 `str_replace` 或 `insert`。替换要求字面量唯一匹配，错误只使用公开的 `old_str` 词汇。插入遵循所选的零基插入边界，不会隐式补尾换行。修改操作会保留请求编辑范围之外的制表符。
+
+## 模型体验
+
+### 工具 schema
+
+#### 模型看到的内容
+
+生成的 [`str_replace_editor` schema](../../../docs/tool-catalog.md#deepseek-aidsh-tool-str-replace-editor)，其中包含配置的 `description`。本插件不贡献独立系统提示词段。
+
+#### Token 影响
+
+`str_replace_editor` 可见时产生固定的 schema 成本。
+
+#### KV Cache 影响
+
+配置的描述与 schema 不变时前缀稳定。
+
+### 工具结果
+
+#### 模型看到的内容
+
+查看操作返回带行号文本或浅层目录列表。调用会向展示层提供文件位置，创建/替换还会提供 diff 卡片。修改操作返回简洁确认。长查看结果保留前缀并追加截断提示。
+
+#### Token 影响
+
+随数据变化，并受 `maxOutputChars` 与固定截断提示约束。
+
+#### KV Cache 影响
+
+工具结果以追加方式位于可复用请求前缀之后。
+
+## 已知限制与延后工作
+
+- 操作面向 UTF-8 文本，不支持二进制文件。
+- `str_replace` 刻意拒绝零匹配或多匹配，且没有 `replace_all` 参数。
+- 每个修改操作都会经过 `fs/write-intent` 或 `fs/edit-intent`，解析当前会话的沙箱策略，并交由挂载的文件系统与策略插件执行。

package/lib/index.js

@@ -0,0 +1,341 @@
+import { isAbsolute } from "node:path";
+import z from "@deepseek-ai/schemastery";
+import { FsError } from "@deepseek-ai/dsh-fs";
+import { sandboxDenialMarker } from "@deepseek-ai/dsh-sandbox";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+//#region lib/types/index.js
+/**
+* Model-facing `str_replace_editor` over the Harness filesystem seam.
+* @module @deepseek-ai/dsh-tool-str-replace-editor
+*/
+const TRUNCATED_MESSAGE = "<response clipped><NOTE>To save on context only part of this file has been shown to you. You should retry this tool after you have searched inside the file with `grep -n` in order to find the line numbers of what you are looking for.</NOTE>";
+const DEFAULT_DESCRIPTION = `
+Custom editing tool for viewing, creating and editing files
+* State is persistent across command calls and discussions with the user
+* If \`path\` is a file, \`view\` displays the result of applying \`cat -n\`. If \`path\` is a directory, \`view\` lists non-hidden files and directories up to 2 levels deep
+* The \`create\` command cannot be used if the specified \`path\` already exists as a file
+* If a \`command\` generates a long output, it will be truncated and marked with \`<response clipped>\`
+
+Notes for using the \`str_replace\` command:
+* The \`old_str\` parameter should match EXACTLY one or more consecutive lines from the original file. Be mindful of whitespaces!
+* If the \`old_str\` parameter is not unique in the file, the replacement will not be performed. Make sure to include enough context in \`old_str\` to make it unique
+* The \`new_str\` parameter should contain the edited lines that should replace the \`old_str\`
+`.trim();
+function maybeTruncate(content, maxOutputChars) {
+	return content.length <= maxOutputChars ? content : content.slice(0, maxOutputChars) + TRUNCATED_MESSAGE;
+}
+function codepointCompare(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+function matchOffsets(content, search) {
+	const offsets = [];
+	let offset = 0;
+	while (true) {
+		const match = content.indexOf(search, offset);
+		if (match < 0) return offsets;
+		offsets.push(match);
+		offset = match + search.length;
+	}
+}
+function lineNumbersAt(content, offsets) {
+	let line = 1;
+	let cursor = 0;
+	return offsets.map((offset) => {
+		while (cursor < offset) {
+			if (content[cursor] === "\n") line += 1;
+			cursor += 1;
+		}
+		return line;
+	});
+}
+var MutationPolicy = class {
+	policy;
+	constructor(ctx) {
+		this.policy = ctx.fs.sandboxMode === void 0 ? void 0 : ctx.get("sandboxPolicy");
+		if (ctx.fs.sandboxMode !== void 0 && this.policy === void 0) throw new Error("tool-str-replace-editor: the mounted filesystem confines but ctx.sandboxPolicy is missing");
+	}
+	resolve(exec) {
+		return this.policy?.resolve({ ...exec.agent === void 0 ? {} : { session: exec.agent.session } });
+	}
+	mapError(error, policy) {
+		if (!(error instanceof FsError) || error.code !== "FS_SANDBOX_DENIED") return error;
+		const mode = policy.mode;
+		return new FsError(sandboxDenialMarker(mode), "FS_SANDBOX_DENIED", { cause: error });
+	}
+};
+async function resolveTarget(ctx, path, signal) {
+	if (path.trim().length === 0) throw new Error("path must be a non-empty string");
+	if (!isAbsolute(path)) throw new Error(`The path ${path} is not an absolute path, it should start with \`/\`. Maybe you meant /${path}?`);
+	return ctx.fs.resolve(path, { signal });
+}
+async function statExisting(ctx, target, command, exec) {
+	const info = await ctx.fs.stat(target, exec.signal);
+	if (info === void 0) {
+		ctx.emit("fs/observed", target, { kind: "absent" }, exec);
+		throw new FsError(`The path ${target.displayPath} does not exist. Please provide a valid path.`, "FS_NOT_FOUND");
+	}
+	if (info.type === "directory" && command !== "view") throw new FsError(`The path ${target.displayPath} is a directory and only the \`view\` command can be used on directories`, "FS_NOT_REGULAR_FILE");
+	return info;
+}
+function requiredForCommand(value, parameter, command, allowEmpty = true) {
+	if (value === void 0) throw new Error(`Parameter \`${parameter}\` is required for command: ${command}`);
+	if (!allowEmpty && value.length === 0) throw new Error(`Parameter \`${parameter}\` is empty for command: ${command}`);
+	return value;
+}
+function formatFileView(path, content, maxOutputChars, viewRange) {
+	const allLines = content.split("\n");
+	let lines = allLines;
+	let initialLine = 1;
+	let finalLine;
+	let prompt = `Here's the content of ${path} with line numbers (which has a total of ${allLines.length} lines)`;
+	if (viewRange !== void 0) {
+		const [requestedInitialLine, requestedFinalLine] = viewRange;
+		if (viewRange.length !== 2 || requestedInitialLine === void 0 || requestedFinalLine === void 0 || !viewRange.every(Number.isInteger)) throw new Error("Invalid `view_range`. It should be a list of two integers.");
+		initialLine = requestedInitialLine;
+		finalLine = requestedFinalLine;
+		if (initialLine < 1 || initialLine > allLines.length) throw new Error(`Invalid \`view_range\`: [${viewRange.join(", ")}]. Its first element \`${initialLine}\` should be within the range of lines of the file: [1, ${allLines.length}]`);
+		if (finalLine > allLines.length) throw new Error(`Invalid \`view_range\`: [${viewRange.join(", ")}]. Its second element \`${finalLine}\` should be smaller than the number of lines in the file: \`${allLines.length}\``);
+		if (finalLine !== -1 && finalLine < initialLine) throw new Error(`Invalid \`view_range\`: [${viewRange.join(", ")}]. Its second element \`${finalLine}\` should be larger or equal than its first \`${initialLine}\``);
+		lines = finalLine === -1 ? allLines.slice(initialLine - 1) : allLines.slice(initialLine - 1, finalLine);
+		prompt += ` with view_range=[${initialLine}, ${finalLine}]`;
+	}
+	const numbered = lines.map((line, index) => `${String(initialLine + index).padStart(6, " ")}  ${line}`).join("\n");
+	return maybeTruncate(`${prompt}:\n${numbered}\n`, maxOutputChars);
+}
+async function listDirectory(ctx, target, maxOutputChars, exec) {
+	async function visit(dir, depth) {
+		const entries = await ctx.fs.listDir(dir, exec.signal);
+		const rows = [];
+		for (const entry of entries.filter((candidate) => !candidate.name.startsWith(".") && candidate.name !== "node_modules" && candidate.name !== "__pycache__")) {
+			const type = entry.type === "directory" ? "d" : entry.type === "file" ? "f" : "?";
+			rows.push(`${type}\t${entry.target.displayPath}`);
+			if (entry.type === "directory" && depth < 2) rows.push(...await visit(entry.target, depth + 1));
+		}
+		return rows;
+	}
+	const rows = [`d\t${target.displayPath}`, ...await visit(target, 1)];
+	rows.sort((left, right) => {
+		return codepointCompare(left.slice(left.indexOf("	") + 1), right.slice(right.indexOf("	") + 1));
+	});
+	const listing = maybeTruncate(rows.join("\n") + "\n", maxOutputChars);
+	return `Here're the files and directories up to 2 levels deep in ${target.displayPath}, excluding hidden items, node_modules, and Python cache directories:\n${listing}\n`;
+}
+async function viewPath(ctx, path, viewRange, maxOutputChars, exec) {
+	const target = await resolveTarget(ctx, path, exec.signal);
+	const info = await statExisting(ctx, target, "view", exec);
+	if (info.type === "directory") {
+		if (viewRange !== void 0) throw new Error("The `view_range` parameter is not allowed when `path` points to a directory.");
+		return listDirectory(ctx, target, maxOutputChars, exec);
+	}
+	if (info.type !== "file") throw new FsError(`cannot view "${target.displayPath}": not a regular file or directory`, "FS_NOT_REGULAR_FILE");
+	const content = await ctx.fs.readText(target, exec.signal);
+	ctx.emit("fs/observed", target, {
+		kind: "present",
+		version: info.version
+	}, exec);
+	return formatFileView(target.displayPath, content, maxOutputChars, viewRange);
+}
+async function createFile(ctx, policy, path, fileText, exec) {
+	const content = requiredForCommand(fileText, "file_text", "create");
+	const sandboxPolicy = policy.resolve(exec);
+	const target = await resolveTarget(ctx, path, exec.signal);
+	if (await ctx.fs.stat(target, exec.signal) !== void 0) throw new Error(`File already exists at: ${target.displayPath}. Cannot overwrite files using command \`create\`.`);
+	const intent = await ctx.waterfall("fs/write-intent", target, exec, () => ({ kind: "createIfAbsent" }));
+	let outcome;
+	try {
+		outcome = await ctx.fs.writeText(target, content, intent, exec.signal, sandboxPolicy);
+	} catch (error) {
+		throw policy.mapError(error, sandboxPolicy);
+	}
+	ctx.emit("fs/observed", target, {
+		kind: "present",
+		version: outcome.version
+	}, exec);
+	return `New file created successfully at: ${target.displayPath}`;
+}
+async function replaceInFile(ctx, policy, path, oldStr, newStr, exec) {
+	const sandboxPolicy = policy.resolve(exec);
+	const target = await resolveTarget(ctx, path, exec.signal);
+	const intent = await ctx.waterfall("fs/edit-intent", target, exec, () => void 0);
+	const oldValue = requiredForCommand(oldStr, "old_str", "str_replace", false);
+	const newValue = newStr ?? "";
+	const info = await statExisting(ctx, target, "str_replace", exec);
+	if (info.type !== "file") throw new FsError(`cannot edit "${target.displayPath}": not a regular file`, "FS_NOT_REGULAR_FILE");
+	const before = await ctx.fs.readText(target, exec.signal);
+	const offsets = matchOffsets(before, oldValue);
+	const offset = offsets[0];
+	if (offset === void 0) throw new FsError(`No replacement was performed, old_str \`${oldValue}\` did not appear verbatim in ${target.displayPath}.`, "FS_EDIT_NOT_FOUND");
+	if (offsets.length > 1) throw new FsError(`No replacement was performed. Multiple occurrences of old_str \`${oldValue}\` in lines [${lineNumbersAt(before, offsets).join(", ")}]. Please ensure it is unique`, "FS_AMBIGUOUS_EDIT");
+	let outcome;
+	try {
+		outcome = await ctx.fs.writeText(target, before.slice(0, offset) + newValue + before.slice(offset + oldValue.length), intent === void 0 ? {
+			kind: "replaceIfVersion",
+			version: info.version
+		} : {
+			kind: "replaceIfVersion",
+			version: intent.version
+		}, exec.signal, sandboxPolicy);
+	} catch (error) {
+		throw policy.mapError(error, sandboxPolicy);
+	}
+	ctx.emit("fs/observed", target, {
+		kind: "present",
+		version: outcome.version
+	}, exec);
+	return `The file ${target.displayPath} has been edited successfully.`;
+}
+async function insertInFile(ctx, policy, path, insertLine, newStr, exec) {
+	if (insertLine === void 0) throw new Error("Parameter `insert_line` is required for command: insert");
+	const value = requiredForCommand(newStr, "new_str", "insert");
+	const sandboxPolicy = policy.resolve(exec);
+	const target = await resolveTarget(ctx, path, exec.signal);
+	const intent = await ctx.waterfall("fs/edit-intent", target, exec, () => void 0);
+	const info = await statExisting(ctx, target, "insert", exec);
+	if (info.type !== "file") throw new FsError(`cannot insert into "${target.displayPath}": not a regular file`, "FS_NOT_REGULAR_FILE");
+	const lines = (await ctx.fs.readText(target, exec.signal)).split("\n");
+	if (!Number.isInteger(insertLine) || insertLine < 0 || insertLine > lines.length) throw new Error(`Invalid \`insert_line\` parameter: ${insertLine}. It should be within the range of lines of the file: [0, ${lines.length}]`);
+	const after = [
+		...lines.slice(0, insertLine),
+		...value.split("\n"),
+		...lines.slice(insertLine)
+	].join("\n");
+	const expected = intent === void 0 ? {
+		kind: "replaceIfVersion",
+		version: info.version
+	} : {
+		kind: "replaceIfVersion",
+		version: intent.version
+	};
+	let outcome;
+	try {
+		outcome = await ctx.fs.writeText(target, after, expected, exec.signal, sandboxPolicy);
+	} catch (error) {
+		throw policy.mapError(error, sandboxPolicy);
+	}
+	ctx.emit("fs/observed", target, {
+		kind: "present",
+		version: outcome.version
+	}, exec);
+	return `The file ${target.displayPath} has been edited successfully.`;
+}
+function presentEditorCall(args) {
+	switch (args.command) {
+		case "view": return {
+			card: "generic",
+			title: `view ${args.path}`,
+			kind: "read",
+			locations: [{ path: args.path }]
+		};
+		case "create": return {
+			card: "diff",
+			title: `create ${args.path}`,
+			diffs: [{
+				path: args.path,
+				oldText: null,
+				newText: args.file_text ?? ""
+			}],
+			locations: [{ path: args.path }]
+		};
+		case "str_replace": return {
+			card: "diff",
+			title: `str_replace ${args.path}`,
+			diffs: [{
+				path: args.path,
+				oldText: args.old_str ?? null,
+				newText: args.new_str ?? ""
+			}],
+			locations: [{ path: args.path }]
+		};
+		case "insert": return {
+			card: "generic",
+			title: `insert ${args.path}`,
+			kind: "edit",
+			locations: [{
+				path: args.path,
+				...args.insert_line === void 0 ? {} : { line: Math.max(1, args.insert_line + 1) }
+			}]
+		};
+	}
+}
+/** Register the model-facing `str_replace_editor` tool. */
+function registerStrReplaceEditor(ctx, config) {
+	const policy = new MutationPolicy(ctx);
+	ctx.tools.register(defineTool({
+		name: "str_replace_editor",
+		description: config.description,
+		parameters: {
+			command: {
+				type: "string",
+				required: true,
+				enum: [
+					"view",
+					"create",
+					"str_replace",
+					"insert"
+				],
+				description: "The commands to run. Allowed options are: `view`, `create`, `str_replace`, `insert`."
+			},
+			path: {
+				type: "string",
+				required: true,
+				description: "Absolute path to file or directory, e.g. `/repo/file.py` or `/repo`."
+			},
+			file_text: {
+				type: "string",
+				description: "Required parameter of `create` command, with the content of the file to be created."
+			},
+			insert_line: {
+				type: "integer",
+				description: "Required parameter of `insert` command. The `new_str` will be inserted AFTER the line `insert_line` of `path`."
+			},
+			new_str: {
+				type: "string",
+				description: "Optional parameter of `str_replace` command containing the new string (if not given, no string will be added). Required parameter of `insert` command containing the string to insert."
+			},
+			old_str: {
+				type: "string",
+				description: "Required parameter of `str_replace` command containing the string in `path` to replace."
+			},
+			view_range: {
+				type: "array",
+				items: { type: "integer" },
+				description: "Optional parameter of `view` command when `path` points to a file. If none is given, the full file is shown. If provided, the file will be shown in the indicated line number range, e.g. [11, 12] will show lines 11 and 12. Indexing at 1 to start. Setting `[start_line, -1]` shows all lines from `start_line` to the end of the file."
+			}
+		},
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: value
+			}]
+		},
+		async execute(args, exec) {
+			switch (args.command) {
+				case "view": return viewPath(ctx, args.path, args.view_range, config.maxOutputChars, exec);
+				case "create": return createFile(ctx, policy, args.path, args.file_text, exec);
+				case "str_replace": return replaceInFile(ctx, policy, args.path, args.old_str, args.new_str, exec);
+				case "insert": return insertInFile(ctx, policy, args.path, args.insert_line, args.new_str, exec);
+			}
+		},
+		presentCall: presentEditorCall
+	}));
+}
+const name = "tool-str-replace-editor";
+const inject = ["tools", "fs"];
+/** Runtime configuration schema for the string-replacement editor tool. */
+const Config = z.object({
+	maxOutputChars: z.number().default(16e3),
+	description: z.string().default(DEFAULT_DESCRIPTION)
+});
+/** Register one `str_replace_editor` tool over `ctx.fs`. */
+function apply(ctx, config) {
+	const resolved = {
+		maxOutputChars: config.maxOutputChars ?? 16e3,
+		description: config.description ?? DEFAULT_DESCRIPTION
+	};
+	if (!Number.isSafeInteger(resolved.maxOutputChars) || resolved.maxOutputChars <= 0) throw new Error("tool-str-replace-editor: maxOutputChars must be a positive safe integer");
+	if (resolved.description.trim().length === 0) throw new Error("tool-str-replace-editor: description must be non-empty");
+	registerStrReplaceEditor(ctx, resolved);
+}
+//#endregion
+export { Config, apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-tool-str-replace-editor`.
+* @module @deepseek-ai/dsh-tool-str-replace-editor/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-tool-str-replace-editor";
+/** Cordis companion plugin name. */
+const name = "tool-str-replace-editor-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the tool adapter owns no independent durable state;
+* filesystem mutation relations stay with the provider and policy plugins.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Model-facing `str_replace_editor` over the Harness filesystem seam.
+ * @module @deepseek-ai/dsh-tool-str-replace-editor
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export declare const name = "tool-str-replace-editor";
+export declare const inject: string[];
+/** Configuration for the string-replacement editor tool. */
+export interface Config {
+    /** Maximum returned view characters before clipping (default 16000). */
+    maxOutputChars?: number;
+    /** Model-facing tool description. */
+    description?: string;
+}
+/** Runtime configuration schema for the string-replacement editor tool. */
+export declare const Config: z<Config>;
+/** Register one `str_replace_editor` tool over `ctx.fs`. */
+export declare function apply(ctx: Context, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-tool-str-replace-editor`.
+ * @module @deepseek-ai/dsh-tool-str-replace-editor/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "tool-str-replace-editor-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@deepseek-ai/dsh-tool-str-replace-editor",
+  "description": "Model-facing view, create, literal replace, and line insert tool over the Harness filesystem service",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/fs/tool-str-replace-editor"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "BSD-3-Clause",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-fs-local": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-fs-policy": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-fs-sandbox": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.1"
+  }
+}