@aexhq/sdk 0.88.1 → 0.89.0

package/README.md

@@ -8,7 +8,7 @@ tools, send messages, and read saved conversations without operating a Brain ser
 Create a key in the [dashboard](https://aex.dev/dashboard). With Node.js 22 or newer, install:
 
 ```sh
-npm install @aexhq/sdk@0.88.1 @aexhq/agentloop-pi@9.0.1 zod@4.4.3
+npm install @aexhq/sdk@0.89.0 @aexhq/agentloop-pi@11.0.0 zod@4.4.3
 ```
 
 Set `AEX_API_KEY` and `OPENAI_API_KEY` in your server environment. Save as `order.mjs` and
@@ -51,12 +51,12 @@ explains setup and where other tools run.
 
 ## Sessions and tools
 
-The SDK uses Brain's session API and extension helpers. You can import `tool`, `agentloop`,
+The SDK uses Brain's session API and extension helpers. You can import `tool`,
 `brainEnv`, `hostEnv`, `component`, `program` and `environment` from `@aexhq/sdk`.
 
 - [Sessions](https://aex.dev/brain/docs/concepts/sessions): send, submit, stream, reconnect and stop.
 - [Tools](https://aex.dev/brain/docs/guides/write-a-tool): application functions and packaged tools.
-- [Custom Agentloops](https://aex.dev/brain/docs/reference/agentloop-contract): one scoped `ctx`, KV state and automatic completion on successful return. Rebuild custom loops with Brain SDK 0.39.0 and use matching Pi/Codex 9.0.1 for new sessions.
+- [Agentloops](https://aex.dev/brain/docs/reference/agentloop-contract): operators register installed runtimes at startup. Hosted sessions select a runtime offered by Aex; custom executables require your own Brain deployment.
 - [Structured output](#structured-output): validated JSON answers.
 - [Managed environments](https://github.com/aexhq/aex/blob/main/docs/environments.md): hosted tools and workspaces.
 - [Attachments](https://github.com/aexhq/aex/blob/main/docs/attachments.md): upload images and PDFs.
@@ -113,17 +113,19 @@ The initial turn uses the supplied `idempotencyKey`; corrections use distinct de
 Re-entry reuses completed turns when prompts and validation feedback are identical. This
 is not an atomic server operation; nondeterministic validation can conflict on replay.
 
-For work submitted by a short-lived caller, configure the official Agentloop with
-`output: { schema: z.toJSONSchema(answerType), maxCorrections: 2 }` and use `submit()`.
-That separate extension policy validates inside the hosted turn and prohibits Tools during
-correction. It supports JSON Schema, not arbitrary local Zod refinements or transforms.
+Typed answers require a caller that stays connected through `send()`. A short-lived caller
+can use `submit()`, read the completed transcript later and validate it in application code.
+The installed Agentloops do not run Aex's validation or correction policy.
 
 ### Migrating from Brain SDK typed sends
 
 Brain SDK 0.34 removes typed sends and the corresponding types and errors. Aex SDK 0.84
 owns them. Existing Aex `send(..., { output })` calls keep the same syntax and behavior.
 Import `StructuredSendOptions` and `StructuredOutputError` from `@aexhq/sdk`.
-Use Pi 9.0.1, Codex 9.0.1 and extension packages pinned to Brain 0.39.0 with this SDK.
+Use Pi 11.0.0, Codex 11.0.0 or OpenCode 1.0.0 with this SDK and Brain 0.41.0.
+Agentloops are registered at server startup. Replace `prepare(pi())` or a placed Agentloop
+with `pi()`. Session creation accepts a registered name and settings; Agentloop uploads and
+`admitAgentloop()` are no longer supported. Hosted Tools still support `prepare()`.
 Mixing exact Brain dependency versions creates different TypeScript extension brands.
 
 An existing standalone Brain handle can use Aex's policy without changing servers:
@@ -136,8 +138,8 @@ const session = new AexSessionHandle(await brain.sessions.get(sessionId));
 `Aex` and `AexSessionHandle` use composition, so they are not instances of the upstream
 `Brain` and `SessionHandle` classes. Use `AexSessionHandle` for explicit product-handle
 annotations. Neutral Brain classes and extension helpers are still re-exported with their
-original identities; `withToken()` still returns a raw Brain client. Stored sessions,
-server contracts, native model formats and Tool schemas are unchanged.
+original identities; `withToken()` still returns a raw Brain client. Upgrading an older server
+requires a planned migration: Brain 0.41 uses a new session contract and `brain-data/3` storage.
 
 ## Account and usage
 
@@ -170,6 +172,7 @@ without receiving an account credential.
 
 Choose [clientBrowser](https://aex.dev/docs/client-browser) for the user's connected tab, or [Application](https://aex.dev/docs/application) for a deployed backend. Both use `aex.sessions.create()` and ordinary Tool declarations.
 
-The SDK prepares hosted code during session setup. To do that earlier and reuse it across
-sessions, call `const loop = await aex.prepare(pi())` during startup, then use `agentloop: loop`.
-See [Environment preparation](https://github.com/aexhq/aex/blob/main/docs/environments.md#prepare-hosted-code).
+Aex runs Pi, Codex and OpenCode on the server. Their factories select an installed runtime
+and pass session settings; they do not upload or start executables. Use `pi()`, `codex()` or
+`opencode()` from the corresponding `@aexhq/agentloop-*` package.
+See [Environment preparation](https://github.com/aexhq/aex/blob/main/docs/environments.md#prepare-hosted-code) for hosted Tools.

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { AexSessionHandle } from "./session.js";
 export { StructuredOutputError } from "./structured-output.js";
 export type { StructuredSendOptions } from "./structured-output.js";
 import { application } from "@aexhq/env-http";
-import { Brain, type PlacedAgentloop, type PlacedTool, type BrainOptions, type CreateSessionOptions, type OperationOptions, type ModelSelection } from "@aexhq/brain";
+import { Brain, type PlacedTool, type BrainOptions, type CreateSessionOptions, type OperationOptions, type ModelSelection } from "@aexhq/brain";
 import { AexSessionHandle } from "./session.js";
 import type { ClientAccess, EnvironmentCatalog, TokenUsage } 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";
@@ -49,11 +49,9 @@ export declare class Aex {
     models(...args: Parameters<Brain["models"]>): ReturnType<Brain["models"]>;
     stream(...args: Parameters<Brain["stream"]>): ReturnType<Brain["stream"]>;
     streamPath(...args: Parameters<Brain["streamPath"]>): ReturnType<Brain["streamPath"]>;
-    prepare<T extends PlacedAgentloop | PlacedTool>(extension: T): Promise<T>;
+    prepare<T extends PlacedTool>(extension: T): Promise<T>;
     prepareEnvironment(...args: Parameters<Brain["prepareEnvironment"]>): ReturnType<Brain["prepareEnvironment"]>;
     admitProgram(...args: Parameters<Brain["admitProgram"]>): ReturnType<Brain["admitProgram"]>;
-    admit(...args: Parameters<Brain["admit"]>): ReturnType<Brain["admit"]>;
-    admitAgentloop(...args: Parameters<Brain["admitAgentloop"]>): ReturnType<Brain["admitAgentloop"]>;
     admitTool(...args: Parameters<Brain["admitTool"]>): ReturnType<Brain["admitTool"]>;
     register(): ReturnType<Brain["register"]>;
     credentials(): ReturnType<Brain["credentials"]>;

package/dist/index.js

@@ -3,7 +3,7 @@ export { AexSessionHandle } from "./session.js";
 export { StructuredOutputError } from "./structured-output.js";
 import { application } from "@aexhq/env-http";
 import { composeApplication } from "./application.js";
-import { Brain, inspectAgentloop, inspectTool, inspectEnvironment } from "@aexhq/brain";
+import { Brain, inspectTool, inspectEnvironment } from "@aexhq/brain";
 import { AexSessionHandle } from "./session.js";
 function nonnegativeInteger(value, name) {
     if (!Number.isSafeInteger(value) || value < 0)
@@ -45,14 +45,12 @@ export class Aex {
     }
     async preparedComposition(options) {
         const composition = this.composition(options);
-        const agentloop = inspectEnvironment(inspectAgentloop(composition.agentloop).environment).driver.driver === "brain"
-            ? await this.client.prepare(composition.agentloop) : composition.agentloop;
         const tools = [];
         for (const tool of composition.tools ?? []) {
             tools.push(inspectEnvironment(inspectTool(tool).environment).driver.driver === "brain"
                 ? await this.client.prepare(tool) : tool);
         }
-        return { ...composition, agentloop, tools };
+        return { ...composition, tools };
     }
     get baseUrl() { return this.client.baseUrl; }
     sessions = Object.freeze({
@@ -69,8 +67,6 @@ export class Aex {
     prepare(extension) { return this.client.prepare(extension); }
     prepareEnvironment(...args) { return this.client.prepareEnvironment(...args); }
     admitProgram(...args) { return this.client.admitProgram(...args); }
-    admit(...args) { return this.client.admit(...args); }
-    admitAgentloop(...args) { return this.client.admitAgentloop(...args); }
     admitTool(...args) { return this.client.admitTool(...args); }
     register() { return this.client.register(); }
     credentials() { return this.client.credentials(); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.88.1",
+  "version": "0.89.0",
   "description": "Aex accounts and hosted sessions using the Brain SDK",
   "license": "MIT",
   "type": "module",
@@ -28,9 +28,9 @@
     "tag": "next"
   },
   "dependencies": {
-    "@aexhq/brain": "0.39.0",
+    "@aexhq/brain": "0.41.0",
     "zod": "4.4.3",
-    "@aexhq/env-http": "0.3.4"
+    "@aexhq/env-http": "0.3.6"
   },
   "scripts": {
     "gen": "node ../../tools/sdk-contracts.mjs",