@aexhq/tool-write 7.0.1 → 8.0.0

package/README.md

@@ -11,8 +11,7 @@ const tools = [write({ env: workspace })];
 ```
 
 Requires a writable workspace. The chosen Environment prepares and executes the
-packaged Node 22 runtime in `dist/runtime/write.mjs`; `dist/runtime/registry.json`
-contains its manifest and contract digest. The Environment owns isolation and resource grants.
-The factory requires an explicit `env` and accepts no other options.
+exact published package through its `./runtime` export. The Environment owns isolation and resource grants.
+Omit `env` to run in the registering Node application; pass `{ env: workspace }` for an isolated prepared Environment. The factory accepts no configuration options.
 
 Run `npm test --workspace @aexhq/tool-write` from the repository root.

package/dist/index.d.ts

@@ -1,9 +1 @@
-export declare const write: (placement: {
-    readonly env: import("@aexhq/brain").Environment;
-} & Record<never, never>) => import("@aexhq/brain").PlacedTool<{
-    path: string;
-    content: string;
-}, {
-    path: string;
-    bytes: number;
-}>;
+export declare const write: typeof import("./packages/tool-write/src/index.js")["write"];

package/dist/index.js

@@ -1,9 +1,2 @@
-import { tool } from "@aexhq/brain";
-import { inputSchema, outputSchema } from "./schema.js";
-export const write = tool({
-    name: "write",
-    description: "Write UTF-8 text to a file in the Environment workspace, creating parent directories.",
-    input: inputSchema,
-    output: outputSchema,
-    implementation: Object.freeze({ type: "aex_official_tool", version: 1, name: "write" }),
-});
+import { bindTool } from "@aexhq/brain";
+export const write = bindTool({"definition":{"name":"write","description":"Write UTF-8 text to a file in the Environment workspace, creating parent directories.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"path":{"type":"string","minLength":1},"content":{"type":"string"}},"required":["path","content"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"path":{"type":"string"},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["path","bytes"],"additionalProperties":false}}}, {"type":"node_package","package":"@aexhq/tool-write","version":"8.0.0","entry":"./runtime","export":"write"}, { url: new URL("./packages/tool-write/src/index.js", import.meta.url), export: "write" });

package/dist/packages/tool-write/runtime/run.d.ts

@@ -0,0 +1,7 @@
+import type { z } from "zod";
+import type { inputSchema } from "../src/schema.js";
+import { type RuntimeContext } from "../../../shared/tool-runtime.js";
+export declare function run(input: z.output<typeof inputSchema>, context: RuntimeContext): Promise<{
+    path: string;
+    bytes: number;
+}>;

package/dist/packages/tool-write/runtime/run.js

@@ -0,0 +1,9 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { workspacePath } from "../../../shared/tool-runtime.js";
+export async function run(input, context) {
+    const target = workspacePath(context.workspace, input.path);
+    await mkdir(dirname(target), { recursive: true });
+    await writeFile(target, input.content);
+    return { path: input.path, bytes: new TextEncoder().encode(input.content).byteLength };
+}

package/dist/packages/tool-write/src/index.d.ts

@@ -0,0 +1,7 @@
+export declare const write: import("@aexhq/brain").ToolFactory<undefined, {
+    path: string;
+    content: string;
+}, {
+    path: string;
+    bytes: number;
+}>;

package/dist/packages/tool-write/src/index.js

@@ -0,0 +1,10 @@
+import { tool } from "@aexhq/brain";
+import { run } from "../runtime/run.js";
+import { inputSchema, outputSchema } from "./schema.js";
+export const write = tool({
+    name: "write",
+    description: "Write UTF-8 text to a file in the Environment workspace, creating parent directories.",
+    input: inputSchema,
+    output: outputSchema,
+    run: async (input, context) => context.finish(await run(input, { workspace: process.cwd(), signal: context.signal })),
+});

package/dist/shared/tool-runtime.d.ts

@@ -0,0 +1,5 @@
+export interface RuntimeContext {
+    readonly signal: AbortSignal;
+    readonly workspace: string;
+}
+export declare function workspacePath(workspace: string, requested: string): string;

package/dist/shared/tool-runtime.js

@@ -0,0 +1,10 @@
+import { isAbsolute, relative, resolve } from "node:path";
+export function workspacePath(workspace, requested) {
+    const root = resolve(workspace);
+    const target = resolve(root, requested);
+    const within = relative(root, target);
+    if (within === ".." || within.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) || isAbsolute(within)) {
+        throw new Error(`${requested} is outside the Environment workspace`);
+    }
+    return target;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/tool-write",
-  "version": "7.0.1",
+  "version": "8.0.0",
   "description": "Write UTF-8 text to a file in the Environment workspace, creating parent directories.",
   "license": "MIT",
   "homepage": "https://aex.dev",
@@ -23,23 +23,37 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./runtime": {
+      "types": "./dist/packages/tool-write/src/index.d.ts",
+      "import": "./dist/packages/tool-write/src/index.js"
+    }
   },
   "files": [
     "dist",
     "README.md"
   ],
   "scripts": {
-    "build": "node ../../tools/clean-dist.mjs && tsc -p tsconfig.json && tsc -p tsconfig.runtime.json && node ../../tools/build-tool-runtime.mjs",
+    "build": "node ../../tools/clean-dist.mjs && tsc -p tsconfig.json && node ../../tools/build-tool-runtime.mjs",
     "test": "npm run build && node --test test/*.test.mjs",
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@aexhq/brain": "0.29.0",
+    "@aexhq/brain": "0.30.0",
     "zod": "4.4.3"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
     "typescript": "^5.9.2"
+  },
+  "brain": {
+    "tools": {
+      ".": {
+        "runtime": "./runtime",
+        "exports": [
+          "write"
+        ]
+      }
+    }
   }
 }