@aexhq/sdk 0.60.0 → 0.62.1

package/dist/resources.d.ts

@@ -69,7 +69,9 @@ export declare class SandboxFiles {
 export declare class SessionSandbox {
     #private;
     readonly files: SandboxFiles;
-    constructor(transport: Transport, sessionId: string);
+    constructor(transport: Transport, sessionId: string, environment: string);
+    /** The declared Environment name this sandbox addresses. */
+    get environment(): string;
     status(options?: OperationOptions): Promise<SandboxStatus>;
     create(options?: OperationOptions): Promise<SandboxStatus>;
 }

package/dist/resources.js

@@ -88,10 +88,14 @@ export class SandboxFiles {
 export class SessionSandbox {
     #inner;
     files;
-    constructor(transport, sessionId) {
-        this.#inner = new BrainSandbox(transport, sessionId);
+    constructor(transport, sessionId, environment) {
+        this.#inner = new BrainSandbox(transport, sessionId, environment);
         this.files = new SandboxFiles(this.#inner.files, transport);
     }
+    /** The declared Environment name this sandbox addresses. */
+    get environment() {
+        return this.#inner.environment;
+    }
     async status(options = {}) {
         return sandboxStatus(await this.#inner.status(request(options)));
     }

package/dist/session.d.ts

@@ -93,10 +93,15 @@ export declare class Sessions {
 }
 export declare class Session implements SessionSummary {
     #private;
-    readonly sandbox: SessionSandbox;
     readonly storage: SessionStorage;
     readonly children: SessionChildren;
     constructor(transport: Transport, data: SessionData);
+    /** The Environment names this session sealed. Only these can be addressed. */
+    get environments(): readonly string[];
+    /** One sealed Environment addressed by the name the session declared it under. */
+    environment(name: string): SessionSandbox;
+    /** The session's default sandbox: the one Environment it declared. */
+    get sandbox(): SessionSandbox;
     get id(): string;
     get state(): SessionState;
     get turnState(): SessionData["turn_state"];

package/dist/session.js

@@ -333,16 +333,33 @@ function waitWithSignal(promise, signal) {
 export class Session {
     #transport;
     #data;
-    sandbox;
     storage;
     children;
     constructor(transport, data) {
         this.#transport = transport;
         this.#data = data;
-        this.sandbox = new SessionSandbox(transport, data.id);
         this.storage = new SessionStorage(transport, data.id);
         this.children = new SessionChildren(transport, data.id);
     }
+    /** The Environment names this session sealed. Only these can be addressed. */
+    get environments() {
+        return this.#data.environments;
+    }
+    /** One sealed Environment addressed by the name the session declared it under. */
+    environment(name) {
+        if (!this.#data.environments.includes(name)) {
+            throw new TypeError(`Session ${this.#data.id} did not declare Environment ${JSON.stringify(name)}`);
+        }
+        return new SessionSandbox(this.#transport, this.#data.id, name);
+    }
+    /** The session's default sandbox: the one Environment it declared. */
+    get sandbox() {
+        const [only, ...rest] = this.#data.environments;
+        if (only === undefined || rest.length > 0) {
+            throw new TypeError(`Session ${this.#data.id} has no default sandbox because it declared ${this.#data.environments.length} Environments; use session.environment(name)`);
+        }
+        return this.environment(only);
+    }
     get id() {
         return this.#data.id;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.60.0",
+  "version": "0.62.1",
   "description": "TypeScript SDK for Aex sessions",
   "license": "Apache-2.0",
   "homepage": "https://aex.dev",
@@ -34,8 +34,8 @@
     "test": "tsc -p tsconfig.json && node --test"
   },
   "dependencies": {
-    "@aexhq/brain": "0.4.0",
-    "@aexhq/env-app": "0.2.0"
+    "@aexhq/brain": "0.5.0",
+    "@aexhq/env-app": "0.3.2"
   },
   "peerDependencies": {
     "zod": "4.4.3"