@aexhq/sdk 0.57.4 → 0.57.5

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import type { WebSocketFactory } from "@aexhq/brain";
 export { AbortError, AexError, OutputRefusalError, OutputSchemaError, OutputValidationError, SessionError, } from "./errors.js";
 export type { AexErrorOptions, OutputValidationIssue } from "./errors.js";
 export { Session, Sessions, } from "./session.js";
-export type { CreateSessionOptions, ListSessionsOptions, ModelSummary, ModelOptions, OutputOptions, RequestOptions, SessionInput, SessionList, SessionSummary, } from "./session.js";
+export type { AgentloopBundle, CreateSessionOptions, ListSessionsOptions, ModelSummary, ModelOptions, OutputOptions, RequestOptions, SessionInput, SessionList, SessionSummary, } from "./session.js";
 export { SandboxFiles, SessionChild, SessionChildren, SessionSandbox, SessionStorage, } from "./resources.js";
 export type { BinarySource, ChildSummary, IdempotentOperationOptions, OperationOptions, PageOptions, SandboxFile, SandboxFileOptions, SandboxFilePage, SandboxFilePageOptions, SandboxStatus, StorageObject, StoragePage, StreamingUploadSource, UploadSource, } from "./resources.js";
 export type { EventOptions } from "./transport.js";

package/dist/resources.d.ts

@@ -155,3 +155,4 @@ export declare class SessionChildren {
     }>;
     get(childId: string): SessionChild;
 }
+export declare function encodeBase64(bytes: Uint8Array): string;

package/dist/resources.js

@@ -413,7 +413,7 @@ async function collectDeclared(source, signal) {
     }
     return result;
 }
-function encodeBase64(bytes) {
+export function encodeBase64(bytes) {
     let binary = "";
     for (let offset = 0; offset < bytes.byteLength; offset += 32_768) {
         binary += String.fromCharCode(...bytes.subarray(offset, offset + 32_768));

package/dist/session.d.ts

@@ -17,10 +17,29 @@ export interface ModelOptions {
     temperature?: number;
     reasoningEffort?: "low" | "medium" | "high";
 }
+/**
+ * A built agentloop implementation, as exported by a loop package or produced by
+ * `buildLoopBundle` from `@aexhq/agentloop`. Assignment is by import, never by name:
+ * the sealed identity is the content digest plus the pinned toolchain.
+ */
+export interface AgentloopBundle {
+    /** The complete deterministic ESM source bundle — the exact bytes sealed and uploaded. */
+    source: string;
+    /** SHA-256 hex of the UTF-8 source bytes. */
+    sha256: string;
+    /** The pinned loop-toolchain identity the bundle was built for. */
+    toolchain: string;
+}
 export interface CreateSessionOptions {
     model: ModelOptions;
     /** Omitted or empty grants no tools. A non-empty list is the exact grant. */
     tools?: readonly Tool[];
+    /**
+     * The agentloop driving this session's turns, assigned by importing its implementation.
+     * Sealed at create for the life of the session; children inherit it. Omission seals the
+     * official aex loop.
+     */
+    agentloop?: AgentloopBundle;
     systemPrompt?: string;
     /** Write-only values for environment names declared by managed Tools. */
     secrets?: Record<string, string>;

package/dist/session.js

@@ -3,7 +3,7 @@ import * as z from "zod";
 import { AbortError, OutputRefusalError, OutputSchemaError, OutputValidationError, SessionError, abortError, errorFromApi, } from "./errors.js";
 import { canonicalize, jcsSha256, randomIdempotencyKey } from "./json.js";
 import { compileTools } from "./tools.js";
-import { SessionChildren, SessionSandbox, SessionStorage } from "./resources.js";
+import { encodeBase64, SessionChildren, SessionSandbox, SessionStorage } from "./resources.js";
 export class Sessions {
     #transport;
     #webSocketFactory;
@@ -54,6 +54,15 @@ export class Sessions {
                 items: compiledTools.items,
             },
             ...(compiledTools.bundles.length === 0 ? {} : { tool_bundles: compiledTools.bundles }),
+            ...(options.agentloop === undefined
+                ? {}
+                : {
+                    agentloop: {
+                        source_bundle_sha256: options.agentloop.sha256,
+                        toolchain: options.agentloop.toolchain,
+                        bundle_base64: encodeBase64(new TextEncoder().encode(options.agentloop.source)),
+                    },
+                }),
             ...(options.secrets === undefined ? {} : { secrets: options.secrets }),
             ...(options.systemPrompt === undefined ? {} : { system_prompt: options.systemPrompt }),
             ...(options.metadata === undefined ? {} : { metadata: options.metadata }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.57.4",
+  "version": "0.57.5",
   "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.2.0"
+    "@aexhq/brain": "0.3.0"
   },
   "peerDependencies": {
     "zod": "4.4.3"