@aexhq/sdk 0.72.0 → 0.74.0

package/README.md

@@ -10,11 +10,24 @@ 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.72 uses Brain SDK 0.21 and official
-extension packages 5.x. Rebuild custom Wasm Components against Brain 0.20's WIT; older
-Components and session configurations are not migrated automatically. See https://aex.dev/docs
+extension builders are Brain's implementations. SDK 0.74 uses Brain SDK 0.23 and Pi/Codex/Tools
+6.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.
 
+Host Tools return 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
+`cancelled`, and missing reliable results after dispatch produce `unknown`. All are failed Tool
+results. Timeout and cancellation do not promise rollback. See
+[the full return contract](https://aex.dev/brain/docs/guides/write-a-tool#return-values-and-outcomes).
+
+`@aexhq/tools-mcp` runs selected MCP Tools in your application host, preserving structured failures
+and original JSON Schema constraints. The official Docker and browser HTTP Environments target
+standalone Brain and require operator deployment. See [official extensions](https://github.com/aexhq/extensions).
+
 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. Customer-selected HTTP Environments are not enabled
@@ -61,3 +74,5 @@ await account.account.logout();
 `Aex.exchangeLogin({code, code_verifier, redirect_uri})` expose the shared HTTP login
 contract for clients. The `@aexhq/cli` package handles opening the browser, PKCE,
 loopback callback and local credential storage.
+
+Image and PDF uploads use the [attachment API](../../docs/attachments.md). `models(provider?)` exposes only the configured hosted model choices, with models.dev metadata when known.

package/dist/generated.d.ts

@@ -1,3 +1,4 @@
+import type { Media } from "@aexhq/brain";
 /**
  * This interface was referenced by `AexContracts`'s JSON-Schema
  * via the `definition` "Billing".
@@ -5,6 +6,15 @@
 export type Billing = "preview_customer_model_keys";
 export interface AexContracts {
 }
+/**
+ * This interface was referenced by `AexContracts`'s JSON-Schema
+ * via the `definition` "Attachment".
+ */
+export interface Attachment {
+    expires_at: number;
+    id: string;
+    media: Media;
+}
 /**
  * This interface was referenced by `AexContracts`'s JSON-Schema
  * via the `definition` "Limits".
@@ -36,6 +46,8 @@ export interface Limits {
  */
 export interface Usage {
     active_turns: number;
+    attachment_bytes: number;
+    attachments: number;
     measured_at?: number | null;
     retained_bytes: number;
     sessions: number;

package/dist/generated.js

@@ -1,2 +1 @@
-/* Generated from aex-server schemas. */
 export {};

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from "@aexhq/brain";
 export type * from "./generated.js";
 import { Brain, type BrainOptions } from "@aexhq/brain";
-import type { Account, Usage, ApiKey, IssuedKey, KeyInput, LoginGrantInput, LoginGrant, LoginExchange, AccountSession } from "./generated.js";
+import type { Attachment, Account, Usage, ApiKey, IssuedKey, KeyInput, LoginGrantInput, LoginGrant, LoginExchange, AccountSession } from "./generated.js";
 export type AexConnection = Omit<BrainOptions, "token" | "baseUrl"> & {
     baseUrl?: string;
 };
@@ -15,6 +15,15 @@ export type AexOptions = AexConnection & ({
 export declare class Aex extends Brain {
     constructor({ apiKey, accountToken, ...options }: AexOptions);
     static exchangeLogin(input: LoginExchange, options?: AexConnection): Promise<AccountSession>;
+    readonly attachments: {
+        upload: (sessionId: string, bytes: Uint8Array, options: {
+            contentType: string;
+            expiresAt?: number;
+            idempotencyKey: string;
+            signal?: AbortSignal;
+        }) => Promise<Attachment>;
+        delete: (sessionId: string, id: string) => Promise<void>;
+    };
     readonly account: {
         get: () => Promise<Account>;
         usage: () => Promise<Usage>;

package/dist/index.js

@@ -9,6 +9,14 @@ export class Aex extends Brain {
     static exchangeLogin(input, options = {}) {
         return new Brain({ baseUrl: "https://api.aex.dev", ...options }).request("POST", "/v1/auth/exchange", input);
     }
+    attachments = {
+        upload: (sessionId, bytes, options) => {
+            if (options.expiresAt !== undefined && (!Number.isSafeInteger(options.expiresAt) || options.expiresAt <= 0))
+                throw new TypeError("expiresAt must be positive Unix seconds");
+            return this.request("POST", `/v1/sessions/${encodeURIComponent(sessionId)}/attachments`, bytes, options.idempotencyKey, options.contentType, options.signal, options.expiresAt === undefined ? undefined : { "x-aex-expires-at": String(options.expiresAt) });
+        },
+        delete: (sessionId, id) => this.request("DELETE", `/v1/sessions/${encodeURIComponent(sessionId)}/attachments/${encodeURIComponent(id)}`),
+    };
     account = {
         get: () => this.request("GET", "/v1/account"),
         usage: () => this.request("GET", "/v1/usage"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.72.0",
+  "version": "0.74.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.21.0"
+    "@aexhq/brain": "0.23.0"
   },
   "scripts": {
     "gen": "node ../../tools/sdk-contracts.mjs",