@nathapp/nax-agent 0.1.0

package/dist/tools/write.js

@@ -0,0 +1,45 @@
+/**
+ * Write a file whose path the policy already resolved and approved.
+ *
+ * No production op declares this tool: everything that writes also needs to run
+ * tests, which needs Bash, which C1 excludes. It exists so #374's gate has a
+ * concrete subject (design section 3.5) and is exercised by tests alone.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+export const writeTool = {
+    name: "Write",
+    description: "Write UTF-8 text to a repository file, creating it and any missing parent directories.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Path relative to the repository root" },
+            content: { type: "string", description: "Full file contents to write" },
+        },
+        required: ["path", "content"],
+    },
+    scope: { pathFields: ["path"] },
+    async run(input, ctx) {
+        const [target] = ctx.resolvedPaths;
+        if (target === undefined)
+            return { content: "no path supplied", isError: true };
+        const content = input.content;
+        if (typeof content !== "string")
+            return { content: "content must be a string", isError: true };
+        const size = Buffer.byteLength(content, "utf8");
+        if (size > ctx.maxFileBytes) {
+            return {
+                content: `content is ${size} bytes, which exceeds the ${ctx.maxFileBytes}-byte file ceiling`,
+                isError: true,
+            };
+        }
+        try {
+            await mkdir(dirname(target), { recursive: true });
+            await writeFile(target, content, "utf8");
+            return { content: `wrote ${Buffer.byteLength(content, "utf8")} bytes` };
+        }
+        catch (err) {
+            return { content: err instanceof Error ? err.message : String(err), isError: true };
+        }
+    },
+};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@nathapp/nax-agent",
+  "version": "0.1.0",
+  "description": "nax's native coding agent: session contract, native loop, tools, permissions, sandbox, command-safety.",
+  "license": "MIT",
+  "author": "William Khoo",
+  "homepage": "https://github.com/nathapp-io/nax/tree/main/packages/nax-agent",
+  "bugs": {
+    "url": "https://github.com/nathapp-io/nax/issues"
+  },
+  "keywords": [
+    "agent",
+    "coding-agent",
+    "llm",
+    "sandbox",
+    "tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nathapp-io/nax.git",
+    "directory": "packages/nax-agent"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
+    }
+  },
+  "imports": {
+    "#src/*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sandbox-runtime": "0.0.77",
+    "@nathapp/nax-ai": "0.1.16",
+    "zod": "^4.3.6"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": false,
+    "tag": "latest"
+  }
+}