@aexhq/sdk 0.76.0 → 0.78.0

package/README.md

@@ -6,8 +6,8 @@ require an account credential. Configure `maxCostMicroUsd` on a prepaid workload
 per-operation ceiling. Attachment uploads also accept `downloadBudgetBytes` and an optional
 operation-specific `maxCostMicroUsd`. See [billing](../../docs/billing.md) for units and recovery.
 
-`session.submit()` returns the committed turn-start receipt immediately. Hosted Tools keep running
-after client close; host Tools require their process online. Follow Events from the receipt and read
+`session.submit()` returns the saved turn's event sequence immediately. Hosted Tools keep running
+after client close; host Tools require their process online. Follow Events from that sequence and read
 the transcript when the turn terminates. Put structured correction policy in the hosted Agentloop
 when submitting from a short-lived Server Action.
 
@@ -21,8 +21,8 @@ console.log(await aex.account.get());
 ```
 
 `Aex` extends the pinned Brain client. Its sessions, registration, Events, Components and
-extension builders are Brain's implementations. SDK 0.76 uses Brain SDK 0.25 and Pi/Codex
-6.2. Images and PDFs use HTTPS URLs; Aex owns attachment publication and expiry. Deploy the matching
+extension builders are Brain's implementations. SDK 0.78 uses Brain SDK 0.28 and Pi/Codex
+7.0. Images and PDFs use HTTPS URLs; Aex owns attachment publication and expiry. Deploy the matching
 runtime and extensions together. Retained sessions require a compatibility check before upgrading.
 See https://aex.dev/docs
 for a complete session example.
@@ -39,7 +39,16 @@ and transforms before the handler. Ordinary objects strip extra properties and s
 reject them. Pi dispatches in parallel; coordinate shared resources in their owning Tool or
 Environment. The official loops explain unanswered calls after interruption without replaying them.
 
-Host Tools return ordinary successful output or a Brain `Outcome` directly. Structured errors retain
+Tool return and completion are separate. `return ctx.finish(value)` emits an optional result
+and finishes an ordinary Tool. Returning a value alone emits it and releases the synchronous
+caller; the Tool remains open for `ctx.emitResult(value)` and `ctx.finish()` afterward.
+Background observations wake the Agentloop, which chooses whether to call the model and what
+to put in its transcript. Results and finish always enter the journal. Keep the host client
+connected until all its Tools finish. Interrupt cancels unfinished Tools even while idle.
+A forgotten finish stays open until the original deadline, cancellation or Environment loss;
+without a deadline it can remain open indefinitely.
+
+Host Tools accept ordinary successful output or a Brain `Outcome` directly. Structured errors retain
 code, message, retryable and details. The top-level statuses `ok`, `error`, `timeout`, `cancelled`
 and `unknown` declare outcomes; malformed envelopes fail validation, and only successful values
 pass through the output schema. Tool deadlines produce `timeout`, explicit cancellation produces
@@ -54,8 +63,8 @@ standalone Brain and require operator deployment. See [official extensions](http
 Place uploaded Wasm Agentloops and Tools in `brainEnv` for hosted execution. `hostEnv`
 executes application functions in your process. Native hosted Components receive no server
 secrets, filesystem or network grants. `await aex.environments.list()` lists your account's
-published profiles. `await aex.environments.modal({name, profile, lifetimeMs})` selects one for
-your Tools; [managed execution](../../docs/environments.md) reserves credits when creating the session.
+published configurations. Import `modal` from `@aexhq/env-modal` and pass the catalog URL and
+granted profile name; [managed execution](../../docs/environments.md) reserves credits at creation.
 Customer-selected HTTP endpoints are denied. Hosted `brainEnv` configuration must be empty; resource access
 is configured by each Environment, not declared through extension `needs`. Prepare dependencies
 for `hostEnv` Tools in your application before registering them. Supply your model key per session.

package/dist/generated.d.ts

@@ -259,17 +259,8 @@ export interface Refund {
  * via the `definition` "EnvironmentProfile".
  */
 export interface EnvironmentProfile {
-    commands: {
-        [k: string]: string[];
-    };
-    cpu: number;
-    image: string;
     maxLifetimeMs: number;
-    maxOutputBytes: number;
-    memoryMiB: number;
-    outboundDomains: string[];
-    region: string;
-    workdir: string;
+    [k: string]: unknown;
 }
 /**
  * This interface was referenced by `AexContracts`'s JSON-Schema

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from "@aexhq/brain";
 export type * from "./generated.js";
-import { Brain, type BrainOptions, type Environment } from "@aexhq/brain";
-import type { EnvironmentCatalog, EnvironmentSelection } from "./generated.js";
+import { Brain, type BrainOptions } from "@aexhq/brain";
+import type { EnvironmentCatalog } from "./generated.js";
 import type { Attachment, Account, Usage, ApiKey, IssuedKey, KeyInput, LoginGrantInput, LoginGrant, LoginExchange, AccountSession, Wallet, BillingSettings, LedgerPage, Topup, TopupInput, Refund, RefundInput, SyncPayment } from "./generated.js";
 export type AexConnection = Omit<BrainOptions, "token" | "baseUrl"> & {
     baseUrl?: string;
@@ -50,10 +50,6 @@ export declare class Aex extends Brain {
     };
     readonly environments: {
         list: () => Promise<EnvironmentCatalog>;
-        /** Select a published profile. Compute is reserved at session creation and allocated on its first Tool invocation. */
-        modal: ({ name, profile, lifetimeMs }: EnvironmentSelection & {
-            name: string;
-        }) => Promise<Environment>;
     };
     /** Key management requires an account session; workload API keys cannot create credentials. */
     readonly keys: {

package/dist/index.js

@@ -1,5 +1,5 @@
 export * from "@aexhq/brain";
-import { Brain, environment } from "@aexhq/brain";
+import { Brain } from "@aexhq/brain";
 function nonnegativeInteger(value, name) {
     if (!Number.isSafeInteger(value) || value < 0)
         throw new TypeError(`${name} must be a nonnegative safe integer`);
@@ -65,15 +65,6 @@ export class Aex extends Brain {
     };
     environments = {
         list: () => this.request("GET", "/v1/environments"),
-        /** Select a published profile. Compute is reserved at session creation and allocated on its first Tool invocation. */
-        modal: async ({ name, profile, lifetimeMs }) => {
-            nonnegativeInteger(lifetimeMs, "lifetimeMs");
-            const catalog = await this.environments.list();
-            const selected = catalog.profiles[profile];
-            if (!selected || lifetimeMs < 1000 || lifetimeMs > selected.maxLifetimeMs)
-                throw new TypeError("profile or lifetime is not available in this account's catalog");
-            return environment({ url: () => catalog.driver_url, configure: () => ({ profile, lifetimeMs }) })({ name });
-        },
     };
     /** Key management requires an account session; workload API keys cannot create credentials. */
     keys = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.76.0",
+  "version": "0.78.0",
   "description": "Aex accounts and hosted sessions using the Brain SDK",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "tag": "next"
   },
   "dependencies": {
-    "@aexhq/brain": "0.25.1"
+    "@aexhq/brain": "0.28.0"
   },
   "scripts": {
     "gen": "node ../../tools/sdk-contracts.mjs",