@clarvis/agent-tools 0.1.0

package/dist/tools/write-file.js

@@ -0,0 +1,61 @@
+import { promises as fs } from "node:fs";
+import { ToolError, fsError } from "../errors.js";
+import { resolvePath, displayPath } from "../lib/paths.js";
+import { writeAtomic, withFileLock } from "../lib/atomic.js";
+export const writeFile = {
+    name: "write_file",
+    description: "Create or completely overwrite a file with `content`, creating missing parent directories. " +
+        "Writes `content` verbatim (no trailing newline added or stripped). Use ONLY to create a new " +
+        "file or fully replace one; to change part of an existing file use edit_file or multi_edit so " +
+        "you do not lose the rest.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Destination file. Relative to workspace root or absolute (~ is not expanded). An " +
+                    "existing file is overwritten; missing parent directories are created.",
+            },
+            content: {
+                type: "string",
+                description: "Full file content. Replaces any existing content in its entirety.",
+            },
+        },
+        required: ["path", "content"],
+        additionalProperties: false,
+    },
+    async handler(args, config) {
+        const relPath = args.path;
+        const target = resolvePath(relPath, config.workspaceRoot, config.confineToWorkspace);
+        const content = args.content;
+        return withFileLock(target, async () => {
+            let existed = false;
+            try {
+                const stat = await fs.stat(target);
+                if (stat.isDirectory()) {
+                    throw new ToolError("not_a_file", `Path is a directory: ${relPath}`, { path: relPath });
+                }
+                existed = true;
+            }
+            catch (err) {
+                if (err instanceof ToolError)
+                    throw err;
+                const e = err;
+                if (e.code !== "ENOENT")
+                    throw fsError(e, relPath);
+            }
+            try {
+                await writeAtomic(target, content);
+            }
+            catch (err) {
+                if (err instanceof ToolError)
+                    throw err;
+                throw fsError(err, relPath);
+            }
+            const bytes = Buffer.byteLength(content, "utf8");
+            const rel = displayPath(target, config.workspaceRoot);
+            return `Wrote ${bytes} bytes to ${rel} (${existed ? "overwritten" : "created"}).`;
+        });
+    },
+};
+//# sourceMappingURL=write-file.js.map

package/dist/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG7D,MAAM,CAAC,MAAM,SAAS,GAAY;IAChC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,6FAA6F;QAC7F,8FAA8F;QAC9F,+FAA+F;QAC/F,2BAA2B;IAC7B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;oBACnF,uEAAuE;aAC1E;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mEAAmE;aACjF;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QAC7B,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAc,CAAC;QACpC,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACrF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;QAEvC,OAAO,YAAY,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YACrC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,MAAM,IAAI,SAAS,CAAC,YAAY,EAAE,wBAAwB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC1F,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,SAAS;oBAAE,MAAM,GAAG,CAAC;gBACxC,MAAM,CAAC,GAAG,GAA4B,CAAC;gBACvC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrD,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,SAAS;oBAAE,MAAM,GAAG,CAAC;gBACxC,MAAM,OAAO,CAAC,GAA4B,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;YACtD,OAAO,SAAS,KAAK,aAAa,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC;QACpF,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@clarvis/agent-tools",
+  "version": "0.1.0",
+  "description": "A minimal, opinionated set of coding tools (read/write/edit/patch/bash/grep/glob) for driving an LLM agent over a workspace — usable as a plain library.",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "SPEC.md",
+    "README.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "CODE_OF_CONDUCT.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "pre-commit": "npm run typecheck && npm run format:check && npm test",
+    "prepublishOnly": "test -f README.md && test -f SPEC.md && npm run build && npm test"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "diff": "^9.0.0",
+    "ignore": "^7.0.5",
+    "tinyglobby": "^0.2.10"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.1.0",
+    "@typescript-eslint/eslint-plugin": "^8.62.1",
+    "@typescript-eslint/parser": "^8.62.1",
+    "eslint": "^10.6.0",
+    "prettier": "^3.9.4",
+    "typescript": "^6.0.3",
+    "vitepress": "^1.6.4",
+    "vitest": "^4.1.9"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getclarvis/agent-tools.git"
+  },
+  "homepage": "https://github.com/getclarvis/agent-tools#readme",
+  "bugs": {
+    "url": "https://github.com/getclarvis/agent-tools/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}