@aexhq/tool-edit 7.0.0 → 8.0.0

package/README.md

@@ -11,8 +11,7 @@ const tools = [edit({ env: workspace })];
 ```
 
 Requires a writable workspace. The chosen Environment prepares and executes the
-packaged Node 22 runtime in `dist/runtime/edit.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-edit` from the repository root.

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,9 +1,2 @@
-import { tool } from "@aexhq/brain";
-import { inputSchema, outputSchema } from "./schema.js";
-export const edit = tool({
-    name: "edit",
-    description: "Replace one exact occurrence of text in an Environment workspace file.",
-    input: inputSchema,
-    output: outputSchema,
-    implementation: Object.freeze({ type: "aex_official_tool", version: 1, name: "edit" }),
-});
+import { bindTool } from "@aexhq/brain";
+export const edit = bindTool({"definition":{"name":"edit","description":"Replace one exact occurrence of text in an Environment workspace file.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"path":{"type":"string","minLength":1},"old_text":{"type":"string","minLength":1},"new_text":{"type":"string"}},"required":["path","old_text","new_text"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"path":{"type":"string"},"replacements":{"type":"number","const":1}},"required":["path","replacements"],"additionalProperties":false}}}, {"type":"node_package","package":"@aexhq/tool-edit","version":"8.0.0","entry":"./runtime","export":"edit"}, { url: new URL("./packages/tool-edit/src/index.js", import.meta.url), export: "edit" });

package/dist/packages/tool-edit/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;
+    replacements: 1;
+}>;

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

@@ -0,0 +1,14 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { workspacePath } from "../../../shared/tool-runtime.js";
+export async function run(input, context) {
+    const target = workspacePath(context.workspace, input.path);
+    const content = await readFile(target, "utf8");
+    const first = content.indexOf(input.old_text);
+    if (first < 0)
+        throw new Error("old_text was not found");
+    if (content.indexOf(input.old_text, first + input.old_text.length) >= 0) {
+        throw new Error("old_text occurs more than once; provide a more specific match");
+    }
+    await writeFile(target, `${content.slice(0, first)}${input.new_text}${content.slice(first + input.old_text.length)}`);
+    return { path: input.path, replacements: 1 };
+}

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

@@ -0,0 +1,8 @@
+export declare const edit: import("@aexhq/brain").ToolFactory<undefined, {
+    path: string;
+    old_text: string;
+    new_text: string;
+}, {
+    path: string;
+    replacements: 1;
+}>;

package/dist/packages/tool-edit/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 edit = tool({
+    name: "edit",
+    description: "Replace one exact occurrence of text in an Environment workspace file.",
+    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-edit",
-  "version": "7.0.0",
+  "version": "8.0.0",
   "description": "Replace one exact occurrence of text in an Environment workspace file.",
   "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-edit/src/index.d.ts",
+      "import": "./dist/packages/tool-edit/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.28.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": [
+          "edit"
+        ]
+      }
+    }
   }
 }