@aexhq/sdk 0.80.0 → 0.81.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.80.0 @aexhq/agentloop-pi@7.1.0 zod@4
+npm install @aexhq/sdk@0.81.0 @aexhq/agentloop-pi@7.1.1 zod@4
 ```
 
 Set `AEX_API_KEY` and `OPENAI_API_KEY` in your server environment. Save as `order.mjs` and
@@ -85,3 +85,9 @@ bindings and the selected Environment's prepared runtime. `ctx.finish(value, { c
 retains the structured result while offering concise model text. `ctx.model({ messages })` runs an
 independent request within the invocation's lifetime and the session's model authority; hosted
 usage and spending controls include those requests. The Agentloop owns the shared conversation.
+
+Connect short application functions through an authenticated HTTP route with
+[HTTP tools](https://github.com/aexhq/aex/blob/main/docs/http-tools.md). Submit a turn, close the
+request and read its committed outcome later. Desktop apps can use
+[upload-only grants](https://github.com/aexhq/aex/blob/main/docs/attachments.md#upload-from-a-desktop-without-an-account-key)
+without receiving an account credential.

package/dist/generated.d.ts

@@ -29,6 +29,58 @@ export type SyncPayment = {
 };
 export interface AexContracts {
 }
+/**
+ * This interface was referenced by `AexContracts`'s JSON-Schema
+ * via the `definition` "HttpCatalog".
+ */
+export interface HttpCatalog {
+    bindings: {
+        [k: string]: number;
+    };
+    driver_url: string;
+}
+/**
+ * This interface was referenced by `AexContracts`'s JSON-Schema
+ * via the `definition` "HttpSelection".
+ */
+export interface HttpSelection {
+    binding: string;
+}
+/**
+ * This interface was referenced by `AexContracts`'s JSON-Schema
+ * via the `definition` "UploadGrantInput".
+ */
+export interface UploadGrantInput {
+    bytes: number;
+    content_type: string;
+    expires_at?: number | null;
+}
+/**
+ * This interface was referenced by `AexContracts`'s JSON-Schema
+ * via the `definition` "UploadGrant".
+ */
+export interface UploadGrant {
+    attachment_expires_at: number;
+    bytes: number;
+    content_type: string;
+    expires_at: number;
+    id: string;
+    token: string;
+    upload_url: string;
+}
+/**
+ * This interface was referenced by `AexContracts`'s JSON-Schema
+ * via the `definition` "AttachmentLimits".
+ */
+export interface AttachmentLimits {
+    bytes_per_account: number;
+    count_per_account: number;
+    max_bytes: number;
+    region: string;
+    session_retention_secs: number;
+    ttl_secs: number;
+    upload_grant_secs: number;
+}
 /**
  * This interface was referenced by `AexContracts`'s JSON-Schema
  * via the `definition` "Attachment".

package/dist/index.d.ts

@@ -22,6 +22,13 @@ export declare class Aex extends Brain {
     request<T>(method: string, path: string, body?: unknown, idempotencyKey?: string, contentType?: string, signal?: AbortSignal, extraHeaders?: HeadersInit): Promise<T>;
     static exchangeLogin(input: LoginExchange, options?: AexConnection): Promise<AccountSession>;
     readonly attachments: {
+        limits: () => Promise<import("./generated.js").AttachmentLimits>;
+        grant: (sessionId: string, input: import("./generated.js").UploadGrantInput, options: {
+            idempotencyKey: string;
+            downloadBudgetBytes?: number;
+            maxCostMicroUsd?: number;
+        }) => Promise<import("./generated.js").UploadGrant>;
+        get: (sessionId: string, id: string) => Promise<Attachment>;
         upload: (sessionId: string, bytes: Uint8Array, options: {
             contentType: string;
             expiresAt?: number;
@@ -50,6 +57,7 @@ export declare class Aex extends Brain {
         sync: (input: SyncPayment) => Promise<Wallet>;
     };
     readonly environments: {
+        http: () => Promise<import("./generated.js").HttpCatalog>;
         list: () => Promise<EnvironmentCatalog>;
     };
     /** Key management requires an account session; workload API keys cannot create credentials. */

package/dist/index.js

@@ -25,6 +25,20 @@ export class Aex extends Brain {
         return new Brain({ baseUrl: "https://api.aex.dev", ...options }).request("POST", "/v1/auth/exchange", input);
     }
     attachments = {
+        limits: () => this.request("GET", "/v1/attachments/limits"),
+        grant: (sessionId, input, options) => {
+            const headers = new Headers();
+            if (options.downloadBudgetBytes !== undefined) {
+                nonnegativeInteger(options.downloadBudgetBytes, "downloadBudgetBytes");
+                headers.set("x-aex-download-budget-bytes", String(options.downloadBudgetBytes));
+            }
+            if (options.maxCostMicroUsd !== undefined) {
+                nonnegativeInteger(options.maxCostMicroUsd, "maxCostMicroUsd");
+                headers.set("x-aex-max-cost-micro-usd", String(options.maxCostMicroUsd));
+            }
+            return this.request("POST", `/v1/sessions/${encodeURIComponent(sessionId)}/attachment-grants`, input, options.idempotencyKey, "application/json", undefined, headers);
+        },
+        get: (sessionId, id) => this.request("GET", `/v1/sessions/${encodeURIComponent(sessionId)}/attachments/${encodeURIComponent(id)}`),
         upload: (sessionId, bytes, options) => {
             if (options.expiresAt !== undefined && (!Number.isSafeInteger(options.expiresAt) || options.expiresAt <= 0))
                 throw new TypeError("expiresAt must be positive Unix seconds");
@@ -65,6 +79,7 @@ export class Aex extends Brain {
         sync: (input) => this.request("POST", "/v1/billing/sync", input),
     };
     environments = {
+        http: () => this.request("GET", "/v1/environments/http"),
         list: () => this.request("GET", "/v1/environments"),
     };
     /** Key management requires an account session; workload API keys cannot create credentials. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.80.0",
+  "version": "0.81.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.30.0"
+    "@aexhq/brain": "0.31.0"
   },
   "scripts": {
     "gen": "node ../../tools/sdk-contracts.mjs",