@aui.io/aui-client 3.1.0 → 3.1.2

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.d.ts

@@ -39,11 +39,12 @@ export declare class ApolloClient extends _GeneratedClient {
         keyType: PublishableKeyType;
     }>;
     /**
-     * Open a messaging WebSocket session. The bearer token is resolved and sent as
-     * Authorization on the upgrade, and the required `aui-websocket` subprotocol is
-     * negotiated. Built here (rather than via the generated session resource) so the
-     * generated code stays vanilla — Fern emits protocols: [] and forwards only
-     * per-call headers, neither of which the v2 server accepts.
+     * Open a messaging WebSocket session. The bearer token is passed as the first
+     * subprotocol (with `aui-websocket` second) — the gateway reads auth from
+     * Sec-WebSocket-Protocol, the only upgrade header a browser can set. The token is
+     * also sent as an Authorization header for Node. Built here (rather than via the
+     * generated session resource) so the generated code stays vanilla — Fern emits
+     * protocols: [] and forwards only per-call headers, neither of which the server accepts.
      */
     connect(args?: ApolloClient.ConnectArgs): Promise<SessionSocket>;
 }

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;
@@ -166,11 +176,12 @@ class ApolloClient extends Client_js_1.ApolloClient {
         return this._tokenAuth.getContext();
     }
     /**
-     * Open a messaging WebSocket session. The bearer token is resolved and sent as
-     * Authorization on the upgrade, and the required `aui-websocket` subprotocol is
-     * negotiated. Built here (rather than via the generated session resource) so the
-     * generated code stays vanilla — Fern emits protocols: [] and forwards only
-     * per-call headers, neither of which the v2 server accepts.
+     * Open a messaging WebSocket session. The bearer token is passed as the first
+     * subprotocol (with `aui-websocket` second) — the gateway reads auth from
+     * Sec-WebSocket-Protocol, the only upgrade header a browser can set. The token is
+     * also sent as an Authorization header for Node. Built here (rather than via the
+     * generated session resource) so the generated code stays vanilla — Fern emits
+     * protocols: [] and forwards only per-call headers, neither of which the server accepts.
      */
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
@@ -179,7 +190,9 @@ class ApolloClient extends Client_js_1.ApolloClient {
             const headers = Object.assign(Object.assign({}, (token ? { Authorization: `Bearer ${token}` } : {})), args.headers);
             const socket = new core.ReconnectingWebSocket({
                 url: core.url.join(this._env.production, SESSION_WS_PATH),
-                protocols: [WS_SUBPROTOCOL],
+                // Order matters: the gateway treats the FIRST subprotocol as the token and
+                // requires `aui-websocket` to follow. This is what makes browser WS auth work.
+                protocols: token ? [token, WS_SUBPROTOCOL] : [WS_SUBPROTOCOL],
                 queryParameters: {},
                 headers,
                 options: {

package/dist/cjs/Client.js

@@ -61,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.1.0",
-                "User-Agent": "@aui.io/aui-client/3.1.0",
+                "X-Fern-SDK-Version": "3.1.2",
+                "User-Agent": "@aui.io/aui-client/3.1.2",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/session/client/Socket.d.ts

@@ -4,7 +4,7 @@ export declare namespace SessionSocket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Apollo.SubmitMessageRequest | Apollo.ResumeRequest;
+    type Response = Apollo.ThreadEnvelope | Apollo.MessageEnvelope | Apollo.EventEnvelope | Apollo.ErrorEnvelope;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;
@@ -33,10 +33,8 @@ export declare class SessionSocket {
      * ```
      */
     on<T extends keyof SessionSocket.EventHandlers>(event: T, callback: SessionSocket.EventHandlers[T]): void;
-    sendThreadAnnouncement(message: Apollo.ThreadEnvelope): void;
-    sendAgentMessage(message: Apollo.MessageEnvelope): void;
-    sendForwardedEvent(message: Apollo.EventEnvelope): void;
-    sendErrorFrame(message: Apollo.ErrorEnvelope): void;
+    sendSubmitMessage(message: Apollo.SubmitMessageRequest): void;
+    sendResume(message: Apollo.ResumeRequest): void;
     /** Connect to the websocket and register event handlers. */
     connect(): SessionSocket;
     /** Close the websocket and unregister event handlers. */
@@ -48,5 +46,5 @@ export declare class SessionSocket {
     /** Send a binary payload to the websocket. */
     protected sendBinary(payload: ArrayBufferLike | Blob | ArrayBufferView): void;
     /** Send a JSON payload to the websocket. */
-    protected sendJson(payload: Apollo.ThreadEnvelope | Apollo.MessageEnvelope | Apollo.EventEnvelope | Apollo.ErrorEnvelope): void;
+    protected sendJson(payload: Apollo.SubmitMessageRequest | Apollo.ResumeRequest): void;
 }

package/dist/cjs/api/resources/session/client/Socket.js

@@ -90,19 +90,11 @@ class SessionSocket {
     on(event, callback) {
         this.eventHandlers[event] = callback;
     }
-    sendThreadAnnouncement(message) {
+    sendSubmitMessage(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }
-    sendAgentMessage(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
-    sendForwardedEvent(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
-    sendErrorFrame(message) {
+    sendResume(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }

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.1.0";
+export declare const SDK_VERSION = "3.1.2";

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.1.0";
+exports.SDK_VERSION = "3.1.2";

package/dist/esm/ApolloClientWrapper.d.mts

@@ -39,11 +39,12 @@ export declare class ApolloClient extends _GeneratedClient {
         keyType: PublishableKeyType;
     }>;
     /**
-     * Open a messaging WebSocket session. The bearer token is resolved and sent as
-     * Authorization on the upgrade, and the required `aui-websocket` subprotocol is
-     * negotiated. Built here (rather than via the generated session resource) so the
-     * generated code stays vanilla — Fern emits protocols: [] and forwards only
-     * per-call headers, neither of which the v2 server accepts.
+     * Open a messaging WebSocket session. The bearer token is passed as the first
+     * subprotocol (with `aui-websocket` second) — the gateway reads auth from
+     * Sec-WebSocket-Protocol, the only upgrade header a browser can set. The token is
+     * also sent as an Authorization header for Node. Built here (rather than via the
+     * generated session resource) so the generated code stays vanilla — Fern emits
+     * protocols: [] and forwards only per-call headers, neither of which the server accepts.
      */
     connect(args?: ApolloClient.ConnectArgs): Promise<SessionSocket>;
 }

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;
@@ -130,11 +140,12 @@ export class ApolloClient extends _GeneratedClient {
         return this._tokenAuth.getContext();
     }
     /**
-     * Open a messaging WebSocket session. The bearer token is resolved and sent as
-     * Authorization on the upgrade, and the required `aui-websocket` subprotocol is
-     * negotiated. Built here (rather than via the generated session resource) so the
-     * generated code stays vanilla — Fern emits protocols: [] and forwards only
-     * per-call headers, neither of which the v2 server accepts.
+     * Open a messaging WebSocket session. The bearer token is passed as the first
+     * subprotocol (with `aui-websocket` second) — the gateway reads auth from
+     * Sec-WebSocket-Protocol, the only upgrade header a browser can set. The token is
+     * also sent as an Authorization header for Node. Built here (rather than via the
+     * generated session resource) so the generated code stays vanilla — Fern emits
+     * protocols: [] and forwards only per-call headers, neither of which the server accepts.
      */
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
@@ -143,7 +154,9 @@ export class ApolloClient extends _GeneratedClient {
             const headers = Object.assign(Object.assign({}, (token ? { Authorization: `Bearer ${token}` } : {})), args.headers);
             const socket = new core.ReconnectingWebSocket({
                 url: core.url.join(this._env.production, SESSION_WS_PATH),
-                protocols: [WS_SUBPROTOCOL],
+                // Order matters: the gateway treats the FIRST subprotocol as the token and
+                // requires `aui-websocket` to follow. This is what makes browser WS auth work.
+                protocols: token ? [token, WS_SUBPROTOCOL] : [WS_SUBPROTOCOL],
                 queryParameters: {},
                 headers,
                 options: {

package/dist/esm/Client.mjs

@@ -25,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.1.0",
-                "User-Agent": "@aui.io/aui-client/3.1.0",
+                "X-Fern-SDK-Version": "3.1.2",
+                "User-Agent": "@aui.io/aui-client/3.1.2",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/session/client/Socket.d.mts

@@ -4,7 +4,7 @@ export declare namespace SessionSocket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Apollo.SubmitMessageRequest | Apollo.ResumeRequest;
+    type Response = Apollo.ThreadEnvelope | Apollo.MessageEnvelope | Apollo.EventEnvelope | Apollo.ErrorEnvelope;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;
@@ -33,10 +33,8 @@ export declare class SessionSocket {
      * ```
      */
     on<T extends keyof SessionSocket.EventHandlers>(event: T, callback: SessionSocket.EventHandlers[T]): void;
-    sendThreadAnnouncement(message: Apollo.ThreadEnvelope): void;
-    sendAgentMessage(message: Apollo.MessageEnvelope): void;
-    sendForwardedEvent(message: Apollo.EventEnvelope): void;
-    sendErrorFrame(message: Apollo.ErrorEnvelope): void;
+    sendSubmitMessage(message: Apollo.SubmitMessageRequest): void;
+    sendResume(message: Apollo.ResumeRequest): void;
     /** Connect to the websocket and register event handlers. */
     connect(): SessionSocket;
     /** Close the websocket and unregister event handlers. */
@@ -48,5 +46,5 @@ export declare class SessionSocket {
     /** Send a binary payload to the websocket. */
     protected sendBinary(payload: ArrayBufferLike | Blob | ArrayBufferView): void;
     /** Send a JSON payload to the websocket. */
-    protected sendJson(payload: Apollo.ThreadEnvelope | Apollo.MessageEnvelope | Apollo.EventEnvelope | Apollo.ErrorEnvelope): void;
+    protected sendJson(payload: Apollo.SubmitMessageRequest | Apollo.ResumeRequest): void;
 }

package/dist/esm/api/resources/session/client/Socket.mjs

@@ -54,19 +54,11 @@ export class SessionSocket {
     on(event, callback) {
         this.eventHandlers[event] = callback;
     }
-    sendThreadAnnouncement(message) {
+    sendSubmitMessage(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }
-    sendAgentMessage(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
-    sendForwardedEvent(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
-    sendErrorFrame(message) {
+    sendResume(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }

package/dist/esm/exports.d.mts

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

package/dist/esm/exports.mjs

@@ -6,3 +6,6 @@
  * `export * from "./exports.mjs"`.
  */
 export * from "./core/exports.mjs";
+// 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.
+export { SessionSocket } from "./api/resources/session/client/Socket.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.1.0";
+export declare const SDK_VERSION = "3.1.2";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "3.1.0";
+export const SDK_VERSION = "3.1.2";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@aui.io/aui-client",
-    "version": "3.1.0",
+    "version": "3.1.2",
     "private": false,
     "repository": "github:aui-io/aui-client-typescript",
     "type": "commonjs",