@aexhq/sdk 0.63.0 → 0.64.0

package/README.md

@@ -1,24 +1,29 @@
 # @aexhq/sdk
 
-The hosted Aex client wraps the neutral `@aexhq/brain` HTTP SDK with an Aex API key and the
-`https://api.aex.dev` base URL.
+The hosted Aex client uses the neutral Brain composition API with the `https://api.aex.dev` base
+URL and an Aex API key.
 
 ```ts
 import { Aex } from "@aexhq/sdk";
+import { awsMicroVm } from "@aexhq/env-aws-microvm";
+import { pi } from "@aexhq/loop-pi";
+import { bash, read } from "@aexhq/tools";
 
 const aex = new Aex({ apiKey: process.env.AEX_API_KEY! });
-const session = await aex.sessions.create({
-  agentloop_digest,
-  model: { binding_id: "vercel-ai-gateway", model: "openai/gpt-5.4" },
-  presentation,
-  environments,
-  tool_bindings,
+const workspace = awsMicroVm({ region: "eu-west-2" });
+const session = await aex.createSession({
+  model: {
+    provider: "vercel-ai-gateway",
+    name: "openai/gpt-5-mini",
+    apiKey: process.env.VERCEL_AI_GATEWAY_API_KEY!,
+  },
+  agentLoop: pi(),
+  tools: [read().runIn(workspace), bash().runIn(workspace)],
 });
 
 await session.send("Inspect the workspace.");
 for await (const event of session.events()) console.log(event);
 ```
 
-Admit Agentloop packages through `aex.brain.admitAgentloop(...)`. Tool implementations remain in
-their bound remote Environment; the SDK sends definitions and binding requests, not implementation
-code.
+Aex supplies hosted authentication and policy. Agentloop admission, Tool placement, Environment
+requirements, operation keys, and event cursors are handled by the shared Brain SDK.

package/dist/index.d.ts

@@ -1,18 +1,12 @@
-import { BrainClient, BrainError, type BrainOptions } from "@aexhq/brain";
-import { Sessions } from "./session.js";
+import { Brain, type BrainOptions } from "@aexhq/brain";
 export { BrainError as AexError } from "@aexhq/brain";
-export { Session, Sessions } from "./session.js";
-export type { RequestOptions } from "./session.js";
-export type { AgentloopAdmission, CreateSessionRequest, EnvironmentRequirement, EventPage, SessionEvent, SessionList, ToolBinding, ToolDefinition, } from "@aexhq/brain";
+export type { AgentLoop, BoundTool, CreateSessionOptions, Environment, EnvironmentLifecycle, OperationOptions, SessionEvent, SessionState, Tool, ToolBindingOptions, ToolDefinition, VercelAiGatewayModel, } from "@aexhq/brain";
 export interface AexOptions {
     apiKey: string;
     baseUrl?: string;
     fetch?: BrainOptions["fetch"];
     timeoutMs?: number;
 }
-export declare class Aex {
-    readonly brain: BrainClient;
-    readonly sessions: Sessions;
+export declare class Aex extends Brain {
     constructor(options: AexOptions);
 }
-export { BrainError };

package/dist/index.js

@@ -1,21 +1,15 @@
-import { BrainClient, BrainError } from "@aexhq/brain";
-import { Sessions } from "./session.js";
+import { Brain } from "@aexhq/brain";
 export { BrainError as AexError } from "@aexhq/brain";
-export { Session, Sessions } from "./session.js";
 const DEFAULT_API_URL = "https://api.aex.dev";
-export class Aex {
-    brain;
-    sessions;
+export class Aex extends Brain {
     constructor(options) {
         if (options.apiKey.trim() === "")
             throw new TypeError("Aex apiKey cannot be empty");
-        this.brain = new BrainClient({
+        super({
             baseUrl: options.baseUrl ?? DEFAULT_API_URL,
-            apiKey: options.apiKey,
+            token: options.apiKey,
             ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
             ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),
         });
-        this.sessions = new Sessions(this.brain);
     }
 }
-export { BrainError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.63.0",
+  "version": "0.64.0",
   "description": "TypeScript SDK for Aex sessions",
   "license": "Apache-2.0",
   "homepage": "https://aex.dev",
@@ -34,7 +34,7 @@
     "test": "tsc -p tsconfig.json && node --test"
   },
   "dependencies": {
-    "@aexhq/brain": "0.6.0"
+    "@aexhq/brain": "0.7.0"
   },
   "devDependencies": {
     "typescript": "^5.9.2"

package/dist/session.d.ts

@@ -1,22 +0,0 @@
-import { BrainClient, SessionHandle, type CreateSessionRequest, type Session as SessionState, type SessionEvent } from "@aexhq/brain";
-export interface RequestOptions {
-    idempotencyKey?: string;
-}
-export declare class Sessions {
-    private readonly brain;
-    constructor(brain: BrainClient);
-    create(request: CreateSessionRequest, options?: RequestOptions): Promise<Session>;
-    list(): Promise<Session[]>;
-    get(sessionId: string): Promise<Session>;
-}
-export declare class Session {
-    private readonly handle;
-    constructor(handle: SessionHandle);
-    get state(): SessionState;
-    get id(): string;
-    send(content: unknown, options?: RequestOptions): Promise<SessionState>;
-    events(after?: number): AsyncIterable<SessionEvent>;
-    cancel(options?: RequestOptions): Promise<void>;
-    end(options?: RequestOptions): Promise<SessionState>;
-    delete(options?: RequestOptions): Promise<void>;
-}

package/dist/session.js

@@ -1,42 +0,0 @@
-export class Sessions {
-    brain;
-    constructor(brain) {
-        this.brain = brain;
-    }
-    async create(request, options = {}) {
-        return new Session(await this.brain.createSession(request, key(options)));
-    }
-    async list() {
-        const { sessions } = await this.brain.listSessions();
-        return Promise.all(sessions.map(async (state) => new Session(await this.brain.getSession(state.session_id))));
-    }
-    async get(sessionId) {
-        return new Session(await this.brain.getSession(sessionId));
-    }
-}
-export class Session {
-    handle;
-    constructor(handle) {
-        this.handle = handle;
-    }
-    get state() { return this.handle.state; }
-    get id() { return this.handle.id; }
-    async send(content, options = {}) {
-        return this.handle.send(content, key(options));
-    }
-    events(after = 0) {
-        return this.handle.events(after);
-    }
-    async cancel(options = {}) {
-        await this.handle.cancel(key(options));
-    }
-    async end(options = {}) {
-        return this.handle.end(key(options));
-    }
-    async delete(options = {}) {
-        await this.handle.delete(key(options));
-    }
-}
-function key(options) {
-    return options.idempotencyKey ?? crypto.randomUUID();
-}