@aexhq/tool-bash 0.0.0 → 6.1.4

package/README.md

@@ -0,0 +1,18 @@
+# @aexhq/tool-bash
+
+Run a Bash command in the session Environment workspace.
+
+```js
+import { environment } from "@aexhq/brain";
+import { bash } from "@aexhq/tool-bash";
+
+const workspace = environment({ url: () => process.env.ENVIRONMENT_URL })({ name: "workspace" });
+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.
+
+Run `npm test --workspace @aexhq/tool-bash` from the repository root.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+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;
+}>;

package/dist/index.js

@@ -0,0 +1,9 @@
+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" }),
+});