@aui.io/aui-client 3.0.0 → 3.1.1

package/README.md

@@ -80,7 +80,6 @@ import { ApolloEnvironment } from '@aui.io/aui-client';
 ApolloEnvironment.Gcp = {
     base: 'https://api-v3.aui.io/apollo-api-v2',        // REST
     production: 'wss://api-v3.aui.io/apollo-api-v2',    // WebSocket
-    local: 'ws://localhost:8000',                       // WebSocket (local)
 };
 ```
 
@@ -145,8 +144,9 @@ socket.on('message', (msg) => {
 socket.on('error', (err) => console.error('WS error:', err));
 socket.on('close', (event) => console.log('Closed:', event.code));
 
-// Send a turn
+// Send a turn (type is required on the WS submit frame)
 socket.sendSubmitMessage({
+    type: 'message',
     agent_id: agentId,
     user_id: 'end-user-123',
     text: 'Hello over WebSocket',
@@ -156,6 +156,14 @@ socket.sendSubmitMessage({
 socket.close();
 ```
 
+> **Notes**
+> - `socket.on(event, handler)` registers a **single** handler per event — calling it
+>   again for the same event replaces the previous handler rather than adding one.
+> - The socket type is exported as `SessionSocket` (`import { SessionSocket } from '@aui.io/aui-client'`).
+> - Request timeouts are **per call** via `timeoutInSeconds` on a request's options; there
+>   is no client-wide default timeout. Pass it on slow calls, e.g.
+>   `client.threads.listThreads({ filters: {} }, { timeoutInSeconds: 120 })`.
+
 ## Key Context Helpers
 
 After the first request (or an explicit `getContext()`), scope resolved from the key is available:
@@ -172,13 +180,17 @@ client.organizationId;
 
 ## Error Handling
 
+`ApolloError` (the base API error) and `ApolloTimeoutError` are exported at the top
+level. The per-status errors (e.g. `UnprocessableEntityError`) live under the `Apollo`
+namespace.
+
 ```typescript
-import { ApolloError, UnprocessableEntityError } from '@aui.io/aui-client';
+import { ApolloError, Apollo } from '@aui.io/aui-client';
 
 try {
     await client.agents.getAgent('missing-id');
 } catch (error) {
-    if (error instanceof UnprocessableEntityError) {
+    if (error instanceof Apollo.UnprocessableEntityError) {
         console.error('Validation failed:', error.body);
     } else if (error instanceof ApolloError) {
         console.error('API error:', error.statusCode, error.body);
@@ -196,6 +208,7 @@ The SDK ships full type definitions. Models are namespaced under `Apollo`:
 import { ApolloClient, Apollo } from '@aui.io/aui-client';
 
 const req: Apollo.SubmitMessageRequest = {
+    type: 'message',
     agent_id: 'agent-123',
     user_id: 'end-user-123',
     text: 'Typed request',

package/dist/cjs/ApolloClientWrapper.js

@@ -58,6 +58,16 @@ const SESSION_WS_PATH = "/messaging/v1/session";
 // The v2 messaging server negotiates this subprotocol on the WS upgrade; the
 // connection is rejected without it. Fern emits protocols: [], so we set it here.
 const WS_SUBPROTOCOL = "aui-websocket";
+// Fern injects SDK-telemetry headers (X-Fern-*) on every request. The API doesn't need
+// them, and in the browser each custom header triggers a CORS preflight that fails unless
+// the gateway allow-lists it. Passing null strips them (mergeHeaders deletes null values).
+const STRIPPED_SDK_HEADERS = {
+    "X-Fern-Language": null,
+    "X-Fern-SDK-Name": null,
+    "X-Fern-SDK-Version": null,
+    "X-Fern-Runtime": null,
+    "X-Fern-Runtime-Version": null,
+};
 // Publishable-key exchange + token caching. Kept as a standalone object so the header
 // suppliers can close over it — a subclass may not touch `this` before super() runs.
 class Auth {
@@ -144,7 +154,7 @@ class ApolloClient extends Client_js_1.ApolloClient {
         const auth = new Auth(env.base, options.publishableKey, options.organizationApiKey);
         super({
             environment: env,
-            headers: Object.assign({}, (auth.hasCredential ? { Authorization: () => __awaiter(this, void 0, void 0, function* () { return `Bearer ${yield auth.getToken()}`; }) } : {})),
+            headers: Object.assign(Object.assign({}, STRIPPED_SDK_HEADERS), (auth.hasCredential ? { Authorization: () => __awaiter(this, void 0, void 0, function* () { return `Bearer ${yield auth.getToken()}`; }) } : {})),
         });
         this._tokenAuth = auth;
         this._env = env;

package/dist/cjs/Client.d.ts

@@ -5,7 +5,6 @@ import { Channels } from "./api/resources/channels/client/Client.js";
 import { Messaging } from "./api/resources/messaging/client/Client.js";
 import { Projects } from "./api/resources/projects/client/Client.js";
 import { Session } from "./api/resources/session/client/Client.js";
-import { SimulatorSession } from "./api/resources/simulatorSession/client/Client.js";
 import { Threads } from "./api/resources/threads/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 import * as core from "./core/index.js";
@@ -25,7 +24,6 @@ export declare class ApolloClient {
     protected _channels: Channels | undefined;
     protected _auth: Auth | undefined;
     protected _session: Session | undefined;
-    protected _simulatorSession: SimulatorSession | undefined;
     constructor(_options?: ApolloClient.Options);
     get agents(): Agents;
     get agentVersions(): AgentVersions;
@@ -35,7 +33,6 @@ export declare class ApolloClient {
     get channels(): Channels;
     get auth(): Auth;
     get session(): Session;
-    get simulatorSession(): SimulatorSession;
     /**
      * @param {ApolloClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/Client.js

@@ -51,8 +51,7 @@ const Client_js_4 = require("./api/resources/channels/client/Client.js");
 const Client_js_5 = require("./api/resources/messaging/client/Client.js");
 const Client_js_6 = require("./api/resources/projects/client/Client.js");
 const Client_js_7 = require("./api/resources/session/client/Client.js");
-const Client_js_8 = require("./api/resources/simulatorSession/client/Client.js");
-const Client_js_9 = require("./api/resources/threads/client/Client.js");
+const Client_js_8 = require("./api/resources/threads/client/Client.js");
 const headers_js_1 = require("./core/headers.js");
 const core = __importStar(require("./core/index.js"));
 const environments = __importStar(require("./environments.js"));
@@ -62,8 +61,8 @@ class ApolloClient {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@aui.io/aui-client",
-                "X-Fern-SDK-Version": "3.0.0",
-                "User-Agent": "@aui.io/aui-client/3.0.0",
+                "X-Fern-SDK-Version": "3.1.1",
+                "User-Agent": "@aui.io/aui-client/3.1.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -82,7 +81,7 @@ class ApolloClient {
     }
     get threads() {
         var _a;
-        return ((_a = this._threads) !== null && _a !== void 0 ? _a : (this._threads = new Client_js_9.Threads(this._options)));
+        return ((_a = this._threads) !== null && _a !== void 0 ? _a : (this._threads = new Client_js_8.Threads(this._options)));
     }
     get messaging() {
         var _a;
@@ -100,10 +99,6 @@ class ApolloClient {
         var _a;
         return ((_a = this._session) !== null && _a !== void 0 ? _a : (this._session = new Client_js_7.Session(this._options)));
     }
-    get simulatorSession() {
-        var _a;
-        return ((_a = this._simulatorSession) !== null && _a !== void 0 ? _a : (this._simulatorSession = new Client_js_8.SimulatorSession(this._options)));
-    }
     /**
      * @param {ApolloClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/index.d.ts

@@ -14,7 +14,6 @@ export * from "./projects/client/requests/index.js";
 export * as projects from "./projects/index.js";
 export * from "./projects/types/index.js";
 export * as session from "./session/index.js";
-export * as simulatorSession from "./simulatorSession/index.js";
 export * from "./threads/client/requests/index.js";
 export * as threads from "./threads/index.js";
 export * from "./threads/types/index.js";

package/dist/cjs/api/resources/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.threads = exports.simulatorSession = exports.session = exports.projects = exports.messaging = exports.channels = exports.auth = exports.agentVersions = exports.agents = void 0;
+exports.threads = exports.session = exports.projects = exports.messaging = exports.channels = exports.auth = exports.agentVersions = exports.agents = void 0;
 __exportStar(require("./agents/client/requests/index.js"), exports);
 exports.agents = __importStar(require("./agents/index.js"));
 __exportStar(require("./agents/types/index.js"), exports);
@@ -53,7 +53,6 @@ __exportStar(require("./projects/client/requests/index.js"), exports);
 exports.projects = __importStar(require("./projects/index.js"));
 __exportStar(require("./projects/types/index.js"), exports);
 exports.session = __importStar(require("./session/index.js"));
-exports.simulatorSession = __importStar(require("./simulatorSession/index.js"));
 __exportStar(require("./threads/client/requests/index.js"), exports);
 exports.threads = __importStar(require("./threads/index.js"));
 __exportStar(require("./threads/types/index.js"), exports);

package/dist/cjs/api/types/ErrorEnvelope.d.ts

@@ -1,5 +1,5 @@
 /**
- * type=error — either a locally-generated error (seq -1) or a forwarded IA error.
+ * type=error — either a session-level error (seq -1) or an error raised while processing the turn.
  */
 export interface ErrorEnvelope {
     type?: "error";
@@ -10,13 +10,13 @@ export interface ErrorEnvelope {
 export declare namespace ErrorEnvelope {
     type Data = 
     /**
-     * Locally generated (bad frame, wallet-gate denial, relay loss). */
+     * Session-level error (invalid frame, insufficient balance, connection loss). */
     {
         error: string;
         code?: number | undefined;
     }
     /**
-     * Forwarded IA error payload. */
+     * Error raised while processing the turn. */
      | {
         message?: string | undefined;
         status_code?: number | undefined;

package/dist/cjs/api/types/EventEnvelope.d.ts

@@ -1,10 +1,10 @@
 import type * as Apollo from "../index.js";
 /**
- * type=event — a raw IA event forwarded per the allow-list.
+ * type=event — a streaming event emitted while the agent works.
  */
 export interface EventEnvelope {
     type?: "event";
-    data?: Apollo.IaEvent;
+    data?: Apollo.StreamEvent;
     /** Monotonic sequence for gap detection / replay. Locally-generated errors use -1. */
     seq: number;
 }

package/dist/cjs/api/types/Message.d.ts

@@ -1,6 +1,6 @@
 import type * as Apollo from "../index.js";
 /**
- * One message in a thread transcript (the published, scrubbed shape).
+ * One message in a thread transcript.
  */
 export interface Message {
     /** Interaction id (or message id for interaction-less messages). */

package/dist/cjs/api/types/MessageEnvelope.d.ts

@@ -1,6 +1,6 @@
 import type * as Apollo from "../index.js";
 /**
- * type=message — the terminal agent reply (external Message + optional trace_info).
+ * type=message — the completed agent reply (Message + optional trace_info).
  */
 export interface MessageEnvelope {
     type?: "message";

package/dist/cjs/api/types/StreamEvent.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Streaming event. Which event types are delivered depends on the `events` query parameter chosen when opening the session.
+ */
+export interface StreamEvent {
+    channel?: StreamEvent.Channel;
+    scope?: Record<string, unknown>;
+    /** Event-specific payload. Token deltas carry `data.text`. */
+    data?: unknown;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}
+export declare namespace StreamEvent {
+    interface Channel {
+        /** Default stream: thread-message-text-content-updated (token delta), thread-message-text-content-completed (stream end). ?events=all|verbose adds the full workflow/lifecycle set. */
+        event_name?: string;
+    }
+}

package/dist/cjs/api/types/SubmitMessageRequest.d.ts

@@ -10,12 +10,8 @@ export interface SubmitMessageRequest {
     /** Signed image URL for vision input. */
     image_url?: string;
     context?: SubmitMessageRequest.Context;
-    /** Arbitrary variables forwarded to IA. */
+    /** Arbitrary runtime variables for the turn. */
     agent_variables?: Record<string, unknown>;
-    /** Per-turn agent override (version pin / inline settings). See the REST agent override model. */
-    agent?: Record<string, unknown>;
-    /** Optional agent-settings bundle forwarded to IA under external_context.agent_settings_bundle. */
-    agent_settings_bundle?: Record<string, unknown>;
 }
 export declare namespace SubmitMessageRequest {
     interface Context {

package/dist/cjs/api/types/Trace.d.ts

@@ -1,6 +1,6 @@
 import type * as Apollo from "../index.js";
 /**
- * Scrubbed reasoning trace for the interaction, embedded only when include_trace=true. Same shape as the REST `Trace` model (GET /messaging/v1/threads/{threadId}/trace); summarized here.
+ * Reasoning trace for the interaction, embedded only when include_trace=true. Same shape as the REST `Trace` model (GET /messaging/v1/threads/{threadId}/trace); summarized here.
  */
 export interface Trace {
     input?: Apollo.TraceInput;

package/dist/cjs/api/types/index.d.ts

@@ -23,9 +23,7 @@ export * from "./ExternalPageLinks.js";
 export * from "./ExternalPageMeta.js";
 export * from "./ExternalPageProject.js";
 export * from "./ExternalPageThreadListItem.js";
-export * from "./GatewayHeaders.js";
 export * from "./HttpValidationError.js";
-export * from "./IaEvent.js";
 export * from "./InitiateThreadResponse.js";
 export * from "./Message.js";
 export * from "./MessageCard.js";
@@ -36,7 +34,7 @@ export * from "./Project.js";
 export * from "./ResumeRequest.js";
 export * from "./SendMessageRequest.js";
 export * from "./SendMessageResponse.js";
-export * from "./SimulatorCommand.js";
+export * from "./StreamEvent.js";
 export * from "./SubmitMessageRequest.js";
 export * from "./Thread.js";
 export * from "./ThreadEnvelope.js";

package/dist/cjs/api/types/index.js

@@ -39,9 +39,7 @@ __exportStar(require("./ExternalPageLinks.js"), exports);
 __exportStar(require("./ExternalPageMeta.js"), exports);
 __exportStar(require("./ExternalPageProject.js"), exports);
 __exportStar(require("./ExternalPageThreadListItem.js"), exports);
-__exportStar(require("./GatewayHeaders.js"), exports);
 __exportStar(require("./HttpValidationError.js"), exports);
-__exportStar(require("./IaEvent.js"), exports);
 __exportStar(require("./InitiateThreadResponse.js"), exports);
 __exportStar(require("./Message.js"), exports);
 __exportStar(require("./MessageCard.js"), exports);
@@ -52,7 +50,7 @@ __exportStar(require("./Project.js"), exports);
 __exportStar(require("./ResumeRequest.js"), exports);
 __exportStar(require("./SendMessageRequest.js"), exports);
 __exportStar(require("./SendMessageResponse.js"), exports);
-__exportStar(require("./SimulatorCommand.js"), exports);
+__exportStar(require("./StreamEvent.js"), exports);
 __exportStar(require("./SubmitMessageRequest.js"), exports);
 __exportStar(require("./Thread.js"), exports);
 __exportStar(require("./ThreadEnvelope.js"), exports);

package/dist/cjs/environments.d.ts

@@ -1,13 +1,11 @@
 export interface ApolloEnvironmentUrls {
     base: string;
     production: string;
-    local: string;
 }
 export declare const ApolloEnvironment: {
     readonly Gcp: {
         readonly base: "https://api-v3.aui.io/apollo-api-v2";
         readonly production: "wss://api-v3.aui.io/apollo-api-v2";
-        readonly local: "ws://localhost:8000";
     };
 };
 export type ApolloEnvironment = typeof ApolloEnvironment.Gcp;

package/dist/cjs/environments.js

@@ -6,6 +6,5 @@ exports.ApolloEnvironment = {
     Gcp: {
         base: "https://api-v3.aui.io/apollo-api-v2",
         production: "wss://api-v3.aui.io/apollo-api-v2",
-        local: "ws://localhost:8000",
     },
 };

package/dist/cjs/exports.d.ts

@@ -6,3 +6,4 @@
  * `export * from "./exports.js"`.
  */
 export * from "./core/exports.js";
+export { SessionSocket } from "./api/resources/session/client/Socket.js";

package/dist/cjs/exports.js

@@ -21,4 +21,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionSocket = void 0;
 __exportStar(require("./core/exports.js"), exports);
+// The generated session resource doesn't re-export its socket class, so consumers
+// couldn't name the type returned by `client.connect()`. Surface it at the package root.
+var Socket_js_1 = require("./api/resources/session/client/Socket.js");
+Object.defineProperty(exports, "SessionSocket", { enumerable: true, get: function () { return Socket_js_1.SessionSocket; } });

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.0.0";
+export declare const SDK_VERSION = "3.1.1";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "3.0.0";
+exports.SDK_VERSION = "3.1.1";

package/dist/esm/ApolloClientWrapper.mjs

@@ -22,6 +22,16 @@ const SESSION_WS_PATH = "/messaging/v1/session";
 // The v2 messaging server negotiates this subprotocol on the WS upgrade; the
 // connection is rejected without it. Fern emits protocols: [], so we set it here.
 const WS_SUBPROTOCOL = "aui-websocket";
+// Fern injects SDK-telemetry headers (X-Fern-*) on every request. The API doesn't need
+// them, and in the browser each custom header triggers a CORS preflight that fails unless
+// the gateway allow-lists it. Passing null strips them (mergeHeaders deletes null values).
+const STRIPPED_SDK_HEADERS = {
+    "X-Fern-Language": null,
+    "X-Fern-SDK-Name": null,
+    "X-Fern-SDK-Version": null,
+    "X-Fern-Runtime": null,
+    "X-Fern-Runtime-Version": null,
+};
 // Publishable-key exchange + token caching. Kept as a standalone object so the header
 // suppliers can close over it — a subclass may not touch `this` before super() runs.
 class Auth {
@@ -108,7 +118,7 @@ export class ApolloClient extends _GeneratedClient {
         const auth = new Auth(env.base, options.publishableKey, options.organizationApiKey);
         super({
             environment: env,
-            headers: Object.assign({}, (auth.hasCredential ? { Authorization: () => __awaiter(this, void 0, void 0, function* () { return `Bearer ${yield auth.getToken()}`; }) } : {})),
+            headers: Object.assign(Object.assign({}, STRIPPED_SDK_HEADERS), (auth.hasCredential ? { Authorization: () => __awaiter(this, void 0, void 0, function* () { return `Bearer ${yield auth.getToken()}`; }) } : {})),
         });
         this._tokenAuth = auth;
         this._env = env;

package/dist/esm/Client.d.mts

@@ -5,7 +5,6 @@ import { Channels } from "./api/resources/channels/client/Client.mjs";
 import { Messaging } from "./api/resources/messaging/client/Client.mjs";
 import { Projects } from "./api/resources/projects/client/Client.mjs";
 import { Session } from "./api/resources/session/client/Client.mjs";
-import { SimulatorSession } from "./api/resources/simulatorSession/client/Client.mjs";
 import { Threads } from "./api/resources/threads/client/Client.mjs";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.mjs";
 import * as core from "./core/index.mjs";
@@ -25,7 +24,6 @@ export declare class ApolloClient {
     protected _channels: Channels | undefined;
     protected _auth: Auth | undefined;
     protected _session: Session | undefined;
-    protected _simulatorSession: SimulatorSession | undefined;
     constructor(_options?: ApolloClient.Options);
     get agents(): Agents;
     get agentVersions(): AgentVersions;
@@ -35,7 +33,6 @@ export declare class ApolloClient {
     get channels(): Channels;
     get auth(): Auth;
     get session(): Session;
-    get simulatorSession(): SimulatorSession;
     /**
      * @param {ApolloClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/esm/Client.mjs

@@ -15,7 +15,6 @@ import { Channels } from "./api/resources/channels/client/Client.mjs";
 import { Messaging } from "./api/resources/messaging/client/Client.mjs";
 import { Projects } from "./api/resources/projects/client/Client.mjs";
 import { Session } from "./api/resources/session/client/Client.mjs";
-import { SimulatorSession } from "./api/resources/simulatorSession/client/Client.mjs";
 import { Threads } from "./api/resources/threads/client/Client.mjs";
 import { mergeHeaders } from "./core/headers.mjs";
 import * as core from "./core/index.mjs";
@@ -26,8 +25,8 @@ export class ApolloClient {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@aui.io/aui-client",
-                "X-Fern-SDK-Version": "3.0.0",
-                "User-Agent": "@aui.io/aui-client/3.0.0",
+                "X-Fern-SDK-Version": "3.1.1",
+                "User-Agent": "@aui.io/aui-client/3.1.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -64,10 +63,6 @@ export class ApolloClient {
         var _a;
         return ((_a = this._session) !== null && _a !== void 0 ? _a : (this._session = new Session(this._options)));
     }
-    get simulatorSession() {
-        var _a;
-        return ((_a = this._simulatorSession) !== null && _a !== void 0 ? _a : (this._simulatorSession = new SimulatorSession(this._options)));
-    }
     /**
      * @param {ApolloClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/esm/api/resources/index.d.mts

@@ -14,7 +14,6 @@ export * from "./projects/client/requests/index.mjs";
 export * as projects from "./projects/index.mjs";
 export * from "./projects/types/index.mjs";
 export * as session from "./session/index.mjs";
-export * as simulatorSession from "./simulatorSession/index.mjs";
 export * from "./threads/client/requests/index.mjs";
 export * as threads from "./threads/index.mjs";
 export * from "./threads/types/index.mjs";

package/dist/esm/api/resources/index.mjs

@@ -14,7 +14,6 @@ export * from "./projects/client/requests/index.mjs";
 export * as projects from "./projects/index.mjs";
 export * from "./projects/types/index.mjs";
 export * as session from "./session/index.mjs";
-export * as simulatorSession from "./simulatorSession/index.mjs";
 export * from "./threads/client/requests/index.mjs";
 export * as threads from "./threads/index.mjs";
 export * from "./threads/types/index.mjs";

package/dist/esm/api/types/ErrorEnvelope.d.mts

@@ -1,5 +1,5 @@
 /**
- * type=error — either a locally-generated error (seq -1) or a forwarded IA error.
+ * type=error — either a session-level error (seq -1) or an error raised while processing the turn.
  */
 export interface ErrorEnvelope {
     type?: "error";
@@ -10,13 +10,13 @@ export interface ErrorEnvelope {
 export declare namespace ErrorEnvelope {
     type Data = 
     /**
-     * Locally generated (bad frame, wallet-gate denial, relay loss). */
+     * Session-level error (invalid frame, insufficient balance, connection loss). */
     {
         error: string;
         code?: number | undefined;
     }
     /**
-     * Forwarded IA error payload. */
+     * Error raised while processing the turn. */
      | {
         message?: string | undefined;
         status_code?: number | undefined;

package/dist/esm/api/types/EventEnvelope.d.mts

@@ -1,10 +1,10 @@
 import type * as Apollo from "../index.mjs";
 /**
- * type=event — a raw IA event forwarded per the allow-list.
+ * type=event — a streaming event emitted while the agent works.
  */
 export interface EventEnvelope {
     type?: "event";
-    data?: Apollo.IaEvent;
+    data?: Apollo.StreamEvent;
     /** Monotonic sequence for gap detection / replay. Locally-generated errors use -1. */
     seq: number;
 }

package/dist/esm/api/types/Message.d.mts

@@ -1,6 +1,6 @@
 import type * as Apollo from "../index.mjs";
 /**
- * One message in a thread transcript (the published, scrubbed shape).
+ * One message in a thread transcript.
  */
 export interface Message {
     /** Interaction id (or message id for interaction-less messages). */

package/dist/esm/api/types/MessageEnvelope.d.mts

@@ -1,6 +1,6 @@
 import type * as Apollo from "../index.mjs";
 /**
- * type=message — the terminal agent reply (external Message + optional trace_info).
+ * type=message — the completed agent reply (Message + optional trace_info).
  */
 export interface MessageEnvelope {
     type?: "message";

package/dist/esm/api/types/StreamEvent.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Streaming event. Which event types are delivered depends on the `events` query parameter chosen when opening the session.
+ */
+export interface StreamEvent {
+    channel?: StreamEvent.Channel;
+    scope?: Record<string, unknown>;
+    /** Event-specific payload. Token deltas carry `data.text`. */
+    data?: unknown;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}
+export declare namespace StreamEvent {
+    interface Channel {
+        /** Default stream: thread-message-text-content-updated (token delta), thread-message-text-content-completed (stream end). ?events=all|verbose adds the full workflow/lifecycle set. */
+        event_name?: string;
+    }
+}

package/dist/esm/api/types/SubmitMessageRequest.d.mts

@@ -10,12 +10,8 @@ export interface SubmitMessageRequest {
     /** Signed image URL for vision input. */
     image_url?: string;
     context?: SubmitMessageRequest.Context;
-    /** Arbitrary variables forwarded to IA. */
+    /** Arbitrary runtime variables for the turn. */
     agent_variables?: Record<string, unknown>;
-    /** Per-turn agent override (version pin / inline settings). See the REST agent override model. */
-    agent?: Record<string, unknown>;
-    /** Optional agent-settings bundle forwarded to IA under external_context.agent_settings_bundle. */
-    agent_settings_bundle?: Record<string, unknown>;
 }
 export declare namespace SubmitMessageRequest {
     interface Context {

package/dist/esm/api/types/Trace.d.mts

@@ -1,6 +1,6 @@
 import type * as Apollo from "../index.mjs";
 /**
- * Scrubbed reasoning trace for the interaction, embedded only when include_trace=true. Same shape as the REST `Trace` model (GET /messaging/v1/threads/{threadId}/trace); summarized here.
+ * Reasoning trace for the interaction, embedded only when include_trace=true. Same shape as the REST `Trace` model (GET /messaging/v1/threads/{threadId}/trace); summarized here.
  */
 export interface Trace {
     input?: Apollo.TraceInput;

package/dist/esm/api/types/index.d.mts

@@ -23,9 +23,7 @@ export * from "./ExternalPageLinks.mjs";
 export * from "./ExternalPageMeta.mjs";
 export * from "./ExternalPageProject.mjs";
 export * from "./ExternalPageThreadListItem.mjs";
-export * from "./GatewayHeaders.mjs";
 export * from "./HttpValidationError.mjs";
-export * from "./IaEvent.mjs";
 export * from "./InitiateThreadResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageCard.mjs";
@@ -36,7 +34,7 @@ export * from "./Project.mjs";
 export * from "./ResumeRequest.mjs";
 export * from "./SendMessageRequest.mjs";
 export * from "./SendMessageResponse.mjs";
-export * from "./SimulatorCommand.mjs";
+export * from "./StreamEvent.mjs";
 export * from "./SubmitMessageRequest.mjs";
 export * from "./Thread.mjs";
 export * from "./ThreadEnvelope.mjs";

package/dist/esm/api/types/index.mjs

@@ -23,9 +23,7 @@ export * from "./ExternalPageLinks.mjs";
 export * from "./ExternalPageMeta.mjs";
 export * from "./ExternalPageProject.mjs";
 export * from "./ExternalPageThreadListItem.mjs";
-export * from "./GatewayHeaders.mjs";
 export * from "./HttpValidationError.mjs";
-export * from "./IaEvent.mjs";
 export * from "./InitiateThreadResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageCard.mjs";
@@ -36,7 +34,7 @@ export * from "./Project.mjs";
 export * from "./ResumeRequest.mjs";
 export * from "./SendMessageRequest.mjs";
 export * from "./SendMessageResponse.mjs";
-export * from "./SimulatorCommand.mjs";
+export * from "./StreamEvent.mjs";
 export * from "./SubmitMessageRequest.mjs";
 export * from "./Thread.mjs";
 export * from "./ThreadEnvelope.mjs";

package/dist/esm/environments.d.mts

@@ -1,13 +1,11 @@
 export interface ApolloEnvironmentUrls {
     base: string;
     production: string;
-    local: string;
 }
 export declare const ApolloEnvironment: {
     readonly Gcp: {
         readonly base: "https://api-v3.aui.io/apollo-api-v2";
         readonly production: "wss://api-v3.aui.io/apollo-api-v2";
-        readonly local: "ws://localhost:8000";
     };
 };
 export type ApolloEnvironment = typeof ApolloEnvironment.Gcp;

package/dist/esm/environments.mjs

@@ -3,6 +3,5 @@ export const ApolloEnvironment = {
     Gcp: {
         base: "https://api-v3.aui.io/apollo-api-v2",
         production: "wss://api-v3.aui.io/apollo-api-v2",
-        local: "ws://localhost:8000",
     },
 };