@arnilo/prism-coding-agent 0.0.3

package/dist/write.js

@@ -0,0 +1,97 @@
+/**
+ * Write tool: create or overwrite a file on the host filesystem.
+ *
+ * Behavioral port of pi's core/tools/write for @arnilo/prism-coding-agent, adapted to Prism's
+ * `ToolDefinition` contract. Faithfully ports the create-parent-dirs → write → serialize-per-path
+ * flow. Drops pi's TUI (`renderCall`/`renderResult`, the incremental syntax-highlight cache, key hints).
+ *
+ * Deviations from pi (documented):
+ *  - **Confirmation message carries the absolute path + real byte count + line count** (pi returns the
+ *    caller-supplied path and `content.length`, which is a UTF-16 *code-unit* count mislabeled "bytes").
+ *    The plan's acceptance criteria call for absolute path + byte/line counts; this is strictly more
+ *    informative and the byte count is now UTF-8-correct.
+ *  - Abort + all fs failures return a Prism `error` result (pi throws/rejects). Abort is checked before
+ *    each filesystem operation (mkdir, writeFile); if the write completes it is reported as success
+ *    (pi would throw "Operation aborted" even after a successful write — misleading, so dropped).
+ */
+import { Buffer } from "node:buffer";
+import { mkdir as fsMkdir, writeFile as fsWriteFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { resolveToCwd } from "./path-utils.js";
+import { withFileMutationQueue } from "./file-mutation-queue.js";
+const defaultWriteOperations = {
+    writeFile: (path, content) => fsWriteFile(path, content, "utf-8"),
+    mkdir: (dir) => fsMkdir(dir, { recursive: true }).then(() => { }),
+};
+function errorResult(toolCallId, message) {
+    return {
+        toolCallId,
+        name: "write",
+        content: [{ type: "text", text: message }],
+        error: { message },
+    };
+}
+function countLines(content) {
+    if (content.length === 0)
+        return 0;
+    return content.split("\n").length;
+}
+export function createWriteTool(cwd, options) {
+    const ops = options?.operations ?? defaultWriteOperations;
+    return {
+        name: "write",
+        description: "Write content to a file. Creates the file if it doesn't exist, overwrites if it does. Automatically creates parent directories.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Path to the file to write (relative or absolute)" },
+                content: { type: "string", description: "Content to write to the file" },
+            },
+            required: ["path", "content"],
+            additionalProperties: false,
+        },
+        async execute(args, context) {
+            const toolCallId = context.toolCallId;
+            const path = typeof args.path === "string" ? args.path : "";
+            const content = typeof args.content === "string" ? args.content : undefined;
+            if (path.length === 0) {
+                return errorResult(toolCallId, "path is required and must be a non-empty string.");
+            }
+            if (content === undefined) {
+                return errorResult(toolCallId, "content is required and must be a string.");
+            }
+            try {
+                const absolutePath = resolveToCwd(path, cwd);
+                const dir = dirname(absolutePath);
+                return await withFileMutationQueue(absolutePath, async () => {
+                    // Check abort before each fs op — do not start a new operation once aborted. We intentionally
+                    // do NOT throw from an abort listener: that could release the mutation queue mid-operation.
+                    if (context.signal?.aborted)
+                        return errorResult(toolCallId, "Operation aborted");
+                    await ops.mkdir(dir);
+                    if (context.signal?.aborted)
+                        return errorResult(toolCallId, "Operation aborted");
+                    await ops.writeFile(absolutePath, content);
+                    const bytes = Buffer.byteLength(content, "utf-8");
+                    const lines = countLines(content);
+                    return {
+                        toolCallId,
+                        name: "write",
+                        content: [
+                            {
+                                type: "text",
+                                text: `Successfully wrote ${bytes} bytes (${lines} lines) to ${absolutePath}`,
+                            },
+                        ],
+                        metadata: { bytes, lines, path: absolutePath },
+                    };
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return errorResult(toolCallId, message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=write.js.map

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@arnilo/prism-coding-agent",
+  "version": "0.0.3",
+  "description": "Optional coding-agent tools (shell, read, write, edit) package for Prism.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__",
+    "!dist/**/*.map",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test dist/__tests__/*.test.js",
+    "pack:dry-run": "npm pack --dry-run"
+  },
+  "dependencies": {
+    "diff": "^8.0.4"
+  },
+  "peerDependencies": {
+    "@arnilo/prism": "0.0.3"
+  },
+  "devDependencies": {
+    "@arnilo/prism": "file:../.."
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ashiqrniloy/prism.git",
+    "directory": "packages/coding-agent"
+  },
+  "bugs": {
+    "url": "https://github.com/ashiqrniloy/prism/issues"
+  },
+  "homepage": "https://github.com/ashiqrniloy/prism/tree/main/packages/coding-agent#readme",
+  "keywords": [
+    "prism",
+    "coding",
+    "tools",
+    "shell",
+    "agent",
+    "llm"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}