@aexhq/env 0.0.0 → 0.1.1

package/README.md

@@ -0,0 +1,25 @@
+# env
+
+Give a Brain model controlled access to its environments. This is an ordinary Tool over
+`ctx.environments`, with the same interface available to any third-party Tool.
+
+```ts
+import { env } from "@aexhq/env";
+
+const debug = env({
+  environments: [{ environment: "workspace", permissions: ["read", "call"], methods: ["inspect"] }],
+});
+// Include debug in your session's tools; lifecycle defaults to automatic.
+```
+
+It defaults to your application's host. Place it in a prepared Node Environment to run it
+remotely. Keep that placement independent of any environment it may delete or replace.
+
+The input operations are `list`, `get`, `create`, `update`, `setup`, `delete` and `call`.
+Use the current `{ name, sequence }` reference returned by `list` or `get`. `get` reads
+recorded state; `call` invokes a method declared by the Env. There is no universal inspect
+or restart method. Resources such as tabs and jobs use the Env's own methods and schemas.
+
+Creation requires an application-authorized template and a `create` grant. Setup defaults to
+automatic; override it with `environment.lifecycle`. Adding this Tool never changes it. See Brain's
+[environment control guide](https://aex.dev/brain/docs/guides/environment-control).

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare const env: typeof import("./packages/env/src/index.js")["env"];

package/dist/index.js

@@ -0,0 +1,2 @@
+import { bindTool } from "@aexhq/brain";
+export const env = bindTool({"definition":{"name":"env","description":"Read or manage authorized Environments. List first for current references, recorded state and supported methods. Get reads cached state; call invokes an Environment-defined method such as inspect or restart. Never assume an uncertain operation did not run.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"operation":{"type":"string","enum":["list","get","create","update","setup","delete","call"]},"environment":{"type":"object","properties":{"name":{"type":"string","minLength":1},"sequence":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["name","sequence"],"additionalProperties":false},"template":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"configuration":{"$ref":"#/$defs/__schema0"},"method":{"type":"string","minLength":1},"input":{"$ref":"#/$defs/__schema1"}},"required":["operation"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema1"}}]}}}}}, {"type":"node_package","package":"@aexhq/env","version":"0.1.1","entry":"./runtime","export":"env"}, { url: new URL("./packages/env/src/index.js", import.meta.url), export: "env" });

package/dist/packages/env/src/index.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export declare const env: import("@aexhq/brain").ToolFactory<undefined, {
+    operation: "update" | "create" | "setup" | "delete" | "call" | "list" | "get";
+    environment?: {
+        name: string;
+        sequence: number;
+    } | undefined;
+    template?: string | undefined;
+    name?: string | undefined;
+    configuration?: z.core.util.JSONType | undefined;
+    method?: string | undefined;
+    input?: z.core.util.JSONType | undefined;
+}, unknown>;

package/dist/packages/env/src/index.js

@@ -0,0 +1,34 @@
+import { tool } from "@aexhq/brain";
+import { z } from "zod";
+const reference = z.strictObject({ name: z.string().min(1), sequence: z.number().int().positive().safe() });
+const request = z.discriminatedUnion("operation", [
+    z.strictObject({ operation: z.literal("list") }),
+    z.strictObject({ operation: z.literal("get"), environment: reference }),
+    z.strictObject({ operation: z.literal("create"), template: z.string().min(1), name: z.string().min(1), configuration: z.json() }),
+    z.strictObject({ operation: z.literal("update"), environment: reference, configuration: z.json() }),
+    z.strictObject({ operation: z.literal("setup"), environment: reference }),
+    z.strictObject({ operation: z.literal("delete"), environment: reference }),
+    z.strictObject({ operation: z.literal("call"), environment: reference, method: z.string().min(1), input: z.json() }),
+]);
+const input = z.strictObject({
+    operation: z.enum(["list", "get", "create", "update", "setup", "delete", "call"]),
+    environment: reference.optional(), template: z.string().min(1).optional(), name: z.string().min(1).optional(),
+    configuration: z.json().optional(), method: z.string().min(1).optional(), input: z.json().optional(),
+}).pipe(request);
+export const env = tool({
+    name: "env",
+    description: "Read or manage authorized Environments. List first for current references, recorded state and supported methods. Get reads cached state; call invokes an Environment-defined method such as inspect or restart. Never assume an uncertain operation did not run.",
+    input,
+    async run(request, context) {
+        const environments = context.environments;
+        switch (request.operation) {
+            case "list": return context.finish(await environments.list());
+            case "get": return context.finish(await environments.get(request.environment));
+            case "create": return context.finish(await environments.create(request.template, request.name, request.configuration));
+            case "update": return context.finish(await environments.update(request.environment, request.configuration));
+            case "setup": return context.finish(await environments.setup(request.environment));
+            case "delete": return context.finish(await environments.delete(request.environment));
+            case "call": return context.finish(await environments.call(request.environment, request.method, request.input));
+        }
+    },
+});

package/package.json

@@ -1,19 +1,55 @@
 {
   "name": "@aexhq/env",
-  "version": "0.0.0",
-  "description": "Reserved package name; no stable release is available.",
-  "license": "Apache-2.0",
+  "version": "0.1.1",
+  "description": "An ordinary Brain Tool for scoped Environment control.",
+  "license": "MIT",
   "type": "module",
-  "exports": "./index.js",
-  "files": [
-    "index.js"
-  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/aexhq/extensions.git"
+    "url": "git+https://github.com/aexhq/extensions.git",
+    "directory": "packages/env"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "tag": "next"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/packages/env/src/index.d.ts",
+      "import": "./dist/packages/env/src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node ../../tools/clean-dist.mjs && tsc -p tsconfig.json && brain-tools",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@aexhq/brain": "0.33.0",
+    "zod": "4.4.3"
   },
-  "aexHoldPlaceholder": {
-    "stagedVersion": "0.1.0",
-    "source": "bf0e1f196e13bb4c6ca001e105f2d8d9e0c68bc5"
+  "brain": {
+    "tools": {
+      ".": {
+        "runtime": "./runtime",
+        "exports": [
+          "env"
+        ]
+      }
+    }
   }
 }

package/index.js

@@ -1 +0,0 @@
-throw new Error("@aexhq/env has no stable release; install @aexhq/env@next or an exact version");