@aexhq/tool-bash 7.0.1 → 8.0.1

package/README.md

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,9 +1,2 @@
-import { tool } from "@aexhq/brain";
-import { inputSchema, outputSchema } from "./schema.js";
-export const bash = tool({
-    name: "bash",
-    description: "Run a Bash command in the session Environment workspace.",
-    input: inputSchema,
-    output: outputSchema,
-    implementation: Object.freeze({ type: "aex_official_tool", version: 1, name: "bash" }),
-});
+import { bindTool } from "@aexhq/brain";
+export const bash = bindTool({"definition":{"name":"bash","description":"Run a Bash command in the session Environment workspace.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"command":{"type":"string","minLength":1}},"required":["command"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"exit_code":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"stdout":{"type":"string"},"stderr":{"type":"string"}},"required":["exit_code","stdout","stderr"],"additionalProperties":false}}}, {"type":"node_package","package":"@aexhq/tool-bash","version":"8.0.1","entry":"./runtime","export":"bash"}, { url: new URL("./packages/tool-bash/src/index.js", import.meta.url), export: "bash" });

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

@@ -0,0 +1,8 @@
+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<{
+    exit_code: number;
+    stdout: string;
+    stderr: string;
+}>;

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

@@ -0,0 +1,19 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+export async function run(input, context) {
+    try {
+        const { stdout, stderr } = await promisify(execFile)("bash", ["-lc", input.command], {
+            signal: context.signal,
+            cwd: context.workspace,
+            maxBuffer: 16 * 1024 * 1024,
+        });
+        return { exit_code: 0, stdout, stderr };
+    }
+    catch (error) {
+        const failure = error;
+        if (typeof failure.code === "number") {
+            return { exit_code: failure.code, stdout: failure.stdout ?? "", stderr: failure.stderr ?? "" };
+        }
+        throw new Error(failure.stderr?.trim() || failure.message || "bash failed");
+    }
+}

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

@@ -0,0 +1,7 @@
+export declare const bash: import("@aexhq/brain").ToolFactory<undefined, {
+    command: string;
+}, {
+    exit_code: number;
+    stdout: string;
+    stderr: string;
+}>;

package/dist/packages/tool-bash/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 bash = tool({
+    name: "bash",
+    description: "Run a Bash command in the session Environment workspace.",
+    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-bash",
-  "version": "7.0.1",
+  "version": "8.0.1",
   "description": "Run a Bash command in the session Environment workspace.",
   "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-bash/src/index.d.ts",
+      "import": "./dist/packages/tool-bash/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.31.0",
     "zod": "4.4.3"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
     "typescript": "^5.9.2"
+  },
+  "brain": {
+    "tools": {
+      ".": {
+        "runtime": "./runtime",
+        "exports": [
+          "bash"
+        ]
+      }
+    }
   }
 }