qca-sdk 0.4.0 → 0.6.0

package/dist/forward/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forward/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACjF,YAAY,EAAE,QAAQ,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACxF,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forward/index.ts"],"names":[],"mappings":"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"}

package/dist/forward/index.js

@@ -14,7 +14,7 @@ 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.Usage = exports.ServiceAccountCredential = exports.PATCredential = exports.toFile = exports.ResumableSessionEventStream = exports.Stream = exports.PagePromise = exports.Page = exports.APIPromise = exports.Models = exports.MemoryStoreMemoryVersions = exports.MemoryStoreMemories = exports.MemoryStores = exports.VaultCredentials = exports.Vaults = exports.SkillVersions = exports.Skills = exports.Files = exports.Environments = exports.ChannelPairings = exports.ChannelQRSessions = exports.Channels = exports.BatchTasks = exports.Batches = exports.ScheduleRuns = exports.Schedules = exports.SessionThreadEvents = exports.SessionThreads = exports.SessionResources = exports.SessionEvents = exports.Sessions = exports.IdentityMemoryStores = exports.IdentityConfigs = exports.Identities = exports.Templates = exports.default = exports.ForwardClient = void 0;
+exports.Drives = exports.IdentityServiceAccountTokens = exports.ServiceAccountTokens = exports.decodeRealtimeAudio = exports.RealtimeServerError = exports.RealtimeConnectionClosedError = exports.RealtimeProtocolError = exports.RealtimeConnection = exports.RealtimeHistoryPage = exports.RealtimeConversations = exports.Realtime = exports.Usage = exports.ServiceAccountCredential = exports.PATCredential = exports.toFile = exports.ResumableSessionEventStream = exports.Stream = exports.PagePromise = exports.Page = exports.APIPromise = exports.Models = exports.MemoryStoreMemoryVersions = exports.MemoryStoreMemories = exports.MemoryStores = exports.VaultCredentials = exports.Vaults = exports.SkillVersions = exports.Skills = exports.Files = exports.Environments = exports.ChannelPairings = exports.ChannelQRSessions = exports.Channels = exports.BatchTasks = exports.Batches = exports.ScheduleRuns = exports.Schedules = exports.SessionThreadEvents = exports.SessionThreads = exports.SessionResources = exports.SessionEvents = exports.Sessions = exports.IdentityMemoryStores = exports.IdentityConfigs = exports.Identities = exports.Templates = exports.default = exports.ForwardClient = void 0;
 var forwardClient_js_1 = require("./forwardClient.js");
 Object.defineProperty(exports, "ForwardClient", { enumerable: true, get: function () { return forwardClient_js_1.ForwardClient; } });
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return forwardClient_js_1.ForwardClient; } });
@@ -88,4 +88,22 @@ Object.defineProperty(exports, "ServiceAccountCredential", { enumerable: true, g
 __exportStar(require("../core/error.js"), exports);
 var usage_js_1 = require("./usage.js");
 Object.defineProperty(exports, "Usage", { enumerable: true, get: function () { return usage_js_1.Usage; } });
+var realtime_js_1 = require("./realtime/realtime.js");
+Object.defineProperty(exports, "Realtime", { enumerable: true, get: function () { return realtime_js_1.Realtime; } });
+var conversation_js_1 = require("./realtime/conversation.js");
+Object.defineProperty(exports, "RealtimeConversations", { enumerable: true, get: function () { return conversation_js_1.RealtimeConversations; } });
+Object.defineProperty(exports, "RealtimeHistoryPage", { enumerable: true, get: function () { return conversation_js_1.RealtimeHistoryPage; } });
+var connection_js_1 = require("./realtime/connection.js");
+Object.defineProperty(exports, "RealtimeConnection", { enumerable: true, get: function () { return connection_js_1.RealtimeConnection; } });
+Object.defineProperty(exports, "RealtimeProtocolError", { enumerable: true, get: function () { return connection_js_1.RealtimeProtocolError; } });
+Object.defineProperty(exports, "RealtimeConnectionClosedError", { enumerable: true, get: function () { return connection_js_1.RealtimeConnectionClosedError; } });
+Object.defineProperty(exports, "RealtimeServerError", { enumerable: true, get: function () { return connection_js_1.RealtimeServerError; } });
+Object.defineProperty(exports, "decodeRealtimeAudio", { enumerable: true, get: function () { return connection_js_1.decodeRealtimeAudio; } });
+__exportStar(require("./realtime/types.js"), exports);
+var service_account_token_js_1 = require("./service-account-token.js");
+Object.defineProperty(exports, "ServiceAccountTokens", { enumerable: true, get: function () { return service_account_token_js_1.ServiceAccountTokens; } });
+var identity_service_account_token_js_1 = require("./identity-service-account-token.js");
+Object.defineProperty(exports, "IdentityServiceAccountTokens", { enumerable: true, get: function () { return identity_service_account_token_js_1.IdentityServiceAccountTokens; } });
+var drive_js_1 = require("./drive.js");
+Object.defineProperty(exports, "Drives", { enumerable: true, get: function () { return drive_js_1.Drives; } });
 //# sourceMappingURL=index.js.map

package/dist/forward/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/forward/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAA6E;AAApE,iHAAA,aAAa,OAAA;AAAE,2GAAA,aAAa,OAAW;AAEhD,6CAA2B;AAC3B,6CAA0C;AAAjC,wGAAA,SAAS,OAAA;AAClB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AACxB,uEAAkE;AAAzD,gIAAA,oBAAoB,OAAA;AAC7B,2CAAwC;AAA/B,sGAAA,QAAQ,OAAA;AACjB,uDAAmD;AAA1C,iHAAA,aAAa,OAAA;AACtB,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AACvB,qEAAgE;AAAvD,8HAAA,mBAAmB,OAAA;AAC5B,6CAA0C;AAAjC,wGAAA,SAAS,OAAA;AAClB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAChB,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,2CAAwC;AAA/B,sGAAA,QAAQ,OAAA;AACjB,iEAA4D;AAAnD,0HAAA,iBAAiB,OAAA;AAC1B,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AACxB,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,qCAAkC;AAAzB,gGAAA,KAAK,OAAA;AACd,uCAAoC;AAA3B,kGAAA,MAAM,OAAA;AACf,uDAAmD;AAA1C,iHAAA,aAAa,OAAA;AACtB,uCAAoC;AAA3B,kGAAA,MAAM,OAAA;AACf,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAC5B,mFAA6E;AAApE,2IAAA,yBAAyB,OAAA;AAClC,uCAAoC;AAA3B,kGAAA,MAAM,OAAA;AAEf,yDAAoD;AAA3C,4GAAA,UAAU,OAAA;AACnB,uDAA0D;AAAjD,qGAAA,IAAI,OAAA;AAAE,4GAAA,WAAW,OAAA;AAC1B,qDAA8C;AAArC,sGAAA,MAAM,OAAA;AACf,+FAAwF;AAA/E,gJAAA,2BAA2B,OAAA;AACpC,iDAA4C;AAAnC,oGAAA,MAAM,OAAA;AAEf,yDAAiF;AAAxE,+GAAA,aAAa,OAAA;AAAE,0HAAA,wBAAwB,OAAA;AAGhD,mDAAiC;AACjC,uCAAmC;AAA1B,iGAAA,KAAK,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/forward/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,uDAA6E;AAApE,iHAAA,aAAa,OAAA;AAAE,2GAAA,aAAa,OAAW;AAEhD,6CAA2B;AAC3B,6CAA0C;AAAjC,wGAAA,SAAS,OAAA;AAClB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AACxB,uEAAkE;AAAzD,gIAAA,oBAAoB,OAAA;AAC7B,2CAAwC;AAA/B,sGAAA,QAAQ,OAAA;AACjB,uDAAmD;AAA1C,iHAAA,aAAa,OAAA;AACtB,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AACvB,qEAAgE;AAAvD,8HAAA,mBAAmB,OAAA;AAC5B,6CAA0C;AAAjC,wGAAA,SAAS,OAAA;AAClB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAChB,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,2CAAwC;AAA/B,sGAAA,QAAQ,OAAA;AACjB,iEAA4D;AAAnD,0HAAA,iBAAiB,OAAA;AAC1B,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AACxB,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,qCAAkC;AAAzB,gGAAA,KAAK,OAAA;AACd,uCAAoC;AAA3B,kGAAA,MAAM,OAAA;AACf,uDAAmD;AAA1C,iHAAA,aAAa,OAAA;AACtB,uCAAoC;AAA3B,kGAAA,MAAM,OAAA;AACf,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAC5B,mFAA6E;AAApE,2IAAA,yBAAyB,OAAA;AAClC,uCAAoC;AAA3B,kGAAA,MAAM,OAAA;AAEf,yDAAoD;AAA3C,4GAAA,UAAU,OAAA;AACnB,uDAA0D;AAAjD,qGAAA,IAAI,OAAA;AAAE,4GAAA,WAAW,OAAA;AAC1B,qDAA8C;AAArC,sGAAA,MAAM,OAAA;AACf,+FAAwF;AAA/E,gJAAA,2BAA2B,OAAA;AACpC,iDAA4C;AAAnC,oGAAA,MAAM,OAAA;AAEf,yDAAiF;AAAxE,+GAAA,aAAa,OAAA;AAAE,0HAAA,wBAAwB,OAAA;AAGhD,mDAAiC;AACjC,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AAEd,sDAAkD;AAAzC,uGAAA,QAAQ,OAAA;AACjB,8DAAwF;AAA/E,wHAAA,qBAAqB,OAAA;AAAE,sHAAA,mBAAmB,OAAA;AACnD,0DAA8J;AAArJ,mHAAA,kBAAkB,OAAA;AAAE,sHAAA,qBAAqB,OAAA;AAAE,8HAAA,6BAA6B,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAE3H,sDAAoC;AAEpC,uEAAkE;AAAzD,gIAAA,oBAAoB,OAAA;AAC7B,yFAAmF;AAA1E,iJAAA,4BAA4B,OAAA;AAErC,uCAAoC;AAA3B,kGAAA,MAAM,OAAA"}

package/dist/forward/realtime/connection.d.ts

@@ -0,0 +1,106 @@
+import type { APIClient, HeadersLike } from '../../core/client.js';
+import { APIConnectionError } from '../../core/error.js';
+import { type RealtimeClientEvent, type RealtimeClosed, type RealtimePlaybackReceipt, type RealtimeReady, type RealtimeServerEvent } from './types.js';
+export interface RealtimeConnectOptions {
+    conversationId: string;
+    headers?: HeadersLike;
+    /** Cancelling this signal releases the entire connection, including ready waits. */
+    signal?: AbortSignal | null;
+    handshakeTimeout?: number;
+    readyTimeout?: number;
+    sendTimeout?: number;
+    closeTimeout?: number;
+    maxQueuedEvents?: number;
+    maxQueueBytes?: number;
+    maxReceiveBytes?: number;
+    /** Node agent (including proxy agents) and TLS settings; fetch/middleware do not apply to WS. */
+    transport?: {
+        agent?: object;
+        ca?: string | Uint8Array | Array<string | Uint8Array>;
+        cert?: string | Uint8Array;
+        key?: string | Uint8Array;
+        servername?: string;
+        rejectUnauthorized?: boolean;
+    };
+}
+export interface RealtimeWaitOptions {
+    signal?: AbortSignal | null;
+    timeout?: number;
+}
+export interface RealtimeCloseOptions extends RealtimeWaitOptions {
+    requestId?: string;
+}
+export declare class RealtimeProtocolError extends APIConnectionError {
+    readonly conversationId: string;
+    readonly code: string;
+    constructor(message: string, conversationId: string, code?: string);
+}
+export declare class RealtimeConnectionClosedError extends APIConnectionError {
+    readonly conversationId: string;
+    readonly closeCode: number;
+    readonly closeReason: string;
+    constructor(conversationId: string, closeCode: number, closeReason: string);
+}
+export declare class RealtimeServerError extends APIConnectionError {
+    readonly event: RealtimeServerEvent;
+    readonly code: string;
+    readonly retryable?: boolean;
+    readonly retry_after_ms?: number;
+    constructor(event: RealtimeServerEvent);
+}
+/** Decode an audio.delta payload into raw 24 kHz PCM16 bytes; this does not play it. */
+export declare function decodeRealtimeAudio(event: RealtimeServerEvent): Uint8Array;
+/** A Node-only connection with one receiver and bounded input/output queues. No reconnect or replay. */
+export declare class RealtimeConnection implements AsyncIterable<RealtimeServerEvent> {
+    private readonly socket;
+    private readonly options;
+    readonly conversationId: string;
+    ready: RealtimeReady;
+    request_id: string | null;
+    private readonly queue;
+    private queueBytes;
+    private lastSequence;
+    private readonly maxQueuedEvents;
+    private readonly maxQueueBytes;
+    private readonly sendTimeout;
+    private readonly closeTimeout;
+    private readonly readyPromise;
+    private readyResolve;
+    private readyReject;
+    private receiver?;
+    private terminal?;
+    private ended;
+    private closing;
+    private sendTail;
+    private sendCount;
+    private sendBytes;
+    private graceful?;
+    private closeAck?;
+    private handshakeTimer?;
+    private readyTimer?;
+    private readonly abort;
+    private constructor();
+    /** @internal */
+    static connect(client: APIClient, options: RealtimeConnectOptions): Promise<RealtimeConnection>;
+    private onMessage;
+    private finish;
+    private fail;
+    /** Read one event. Concurrent consumers are rejected instead of stealing each other's events. */
+    receive(options?: RealtimeWaitOptions): Promise<IteratorResult<RealtimeServerEvent>>;
+    [Symbol.asyncIterator](): AsyncGenerator<RealtimeServerEvent>;
+    /** Serialize sends in call order; no input is automatically replayed. */
+    sendEvent(event: RealtimeClientEvent, options?: RealtimeWaitOptions): Promise<void>;
+    sendText(text: string, options?: RealtimeWaitOptions): Promise<void>;
+    appendAudio(pcm: Uint8Array, options?: RealtimeWaitOptions): Promise<void>;
+    interrupt(options?: RealtimeWaitOptions): Promise<void>;
+    ping(options?: RealtimeWaitOptions): Promise<void>;
+    playbackStarted(receipt?: RealtimePlaybackReceipt, options?: RealtimeWaitOptions): Promise<void>;
+    playbackEnded(receipt?: RealtimePlaybackReceipt, options?: RealtimeWaitOptions): Promise<void>;
+    playbackCancelled(receipt?: RealtimePlaybackReceipt, options?: RealtimeWaitOptions): Promise<void>;
+    private playback;
+    /** Send connection.close, require its matching persistence acknowledgement, then release transport. */
+    closeGracefully(options?: RealtimeCloseOptions): Promise<RealtimeClosed>;
+    /** Transport close does not promise history persistence or cancel background Work. */
+    close(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/forward/realtime/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/forward/realtime/connection.ts"],"names":[],"mappings":"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"}

package/dist/forward/realtime/connection.js

@@ -0,0 +1,473 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeConnection = exports.RealtimeServerError = exports.RealtimeConnectionClosedError = exports.RealtimeProtocolError = void 0;
+exports.decodeRealtimeAudio = decodeRealtimeAudio;
+const error_js_1 = require("../../core/error.js");
+const types_js_1 = require("./types.js");
+class RealtimeProtocolError extends error_js_1.APIConnectionError {
+    conversationId;
+    code;
+    constructor(message, conversationId, code = 'invalid_event') {
+        super(message);
+        this.conversationId = conversationId;
+        this.code = code;
+    }
+}
+exports.RealtimeProtocolError = RealtimeProtocolError;
+class RealtimeConnectionClosedError extends error_js_1.APIConnectionError {
+    conversationId;
+    closeCode;
+    closeReason;
+    constructor(conversationId, closeCode, closeReason) {
+        super(`Realtime connection closed (${closeCode})`);
+        this.conversationId = conversationId;
+        this.closeCode = closeCode;
+        this.closeReason = closeReason;
+    }
+}
+exports.RealtimeConnectionClosedError = RealtimeConnectionClosedError;
+class RealtimeServerError extends error_js_1.APIConnectionError {
+    event;
+    code;
+    retryable;
+    retry_after_ms;
+    constructor(event) {
+        const payload = event.payload;
+        super(typeof payload.message === 'string' ? payload.message : 'Realtime server error');
+        this.event = event;
+        this.code = String(payload.code);
+        this.retryable = typeof payload.retryable === 'boolean' ? payload.retryable : undefined;
+        this.retry_after_ms = typeof payload.retry_after_ms === 'number' ? payload.retry_after_ms : undefined;
+    }
+}
+exports.RealtimeServerError = RealtimeServerError;
+const importWS = () => import('ws');
+const CLIENT_MESSAGE_BYTES = 256 * 1024;
+const terminalErrors = new Set(['provider_initialization_failed', 'context_restore_failed', 'provider_unavailable', 'service_restarting', 'event_persistence_failed']);
+const base64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+function validTimestamp(value) {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}:\d{2})$/.test(value) || !Number.isFinite(Date.parse(value)))
+        return false;
+    const year = Number(value.slice(0, 4)), month = Number(value.slice(5, 7)), day = Number(value.slice(8, 10));
+    const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+    return day > 0 && day <= [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
+}
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+function positive(value, fallback, name) {
+    const result = value ?? fallback;
+    if (!Number.isSafeInteger(result) || result <= 0 || result > 2 ** 31 - 1)
+        throw new error_js_1.QoderError(`${name} must be a positive integer within the timer/size limit`);
+    return result;
+}
+function wait(value, timeout, signal, label) {
+    return new Promise((resolve, reject) => {
+        const abort = () => finish(new error_js_1.APIUserAbortError(`${label} was aborted`));
+        const timer = setTimeout(() => finish(new error_js_1.APIConnectionTimeoutError(`${label} timed out`)), timeout);
+        let settled = false;
+        function finish(error, result) {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', abort);
+            if (error)
+                reject(error);
+            else
+                resolve(result);
+        }
+        if (signal?.aborted)
+            abort();
+        else
+            signal?.addEventListener('abort', abort, { once: true });
+        value.then(result => finish(undefined, result), error => finish(error instanceof Error ? error : new error_js_1.APIConnectionError(label)));
+    });
+}
+function validateEvent(value, conversationId) {
+    const invalid = () => new RealtimeProtocolError('Invalid Realtime event envelope or payload', conversationId);
+    if (!isObject(value) || value.version !== types_js_1.REALTIME_VERSION || typeof value.type !== 'string' || !value.type
+        || !isObject(value.payload) || typeof value.event_id !== 'string' || !value.event_id
+        || !Number.isSafeInteger(value.sequence) || value.sequence < 0 || value.conversation_id !== conversationId
+        || !validTimestamp(value.timestamp)
+        || (value.work_id !== undefined && typeof value.work_id !== 'string')
+        || (value.announcement_id !== undefined && typeof value.announcement_id !== 'string'))
+        throw invalid();
+    const p = value.payload;
+    const required = {
+        'voice.state': ['state'], 'voice.replaced': ['reason'], 'transcript.delta': ['role', 'text'], 'transcript.final': ['role', 'text'],
+        'audio.delta': ['audio'], 'playback.interrupt': ['reason'], 'work.accepted': ['status', 'objective'], 'work.running': ['status'],
+        'work.progress': ['kind', 'detail'], 'work.milestone': ['announcement_id', 'milestone_type', 'summary'],
+        'work.completed': ['status', 'result'], 'work.failed': ['status'], 'connection.closed': ['request_id', 'outcome'], error: ['code', 'message'],
+    };
+    if ((required[value.type] ?? []).some(key => typeof p[key] !== 'string'))
+        throw invalid();
+    const optionalStrings = {
+        'transcript.delta': ['item_id', 'response_id'], 'transcript.final': ['item_id', 'response_id'],
+        'work.progress': ['title', 'event_id'], 'work.completed': ['event_id'], 'work.failed': ['event_id'],
+    };
+    if ((optionalStrings[value.type] ?? []).some(key => p[key] !== undefined && typeof p[key] !== 'string'))
+        throw invalid();
+    if (value.type === 'work.progress' && p.is_error !== undefined && typeof p.is_error !== 'boolean')
+        throw invalid();
+    if (value.type === 'error' && ((p.retryable !== undefined && typeof p.retryable !== 'boolean') || (p.retry_after_ms !== undefined && (!Number.isSafeInteger(p.retry_after_ms) || p.retry_after_ms < 0))))
+        throw invalid();
+    const statuses = { 'work.accepted': 'accepted', 'work.running': 'running', 'work.completed': 'completed', 'work.failed': 'failed' };
+    if (statuses[value.type] && p.status !== statuses[value.type])
+        throw invalid();
+    if (value.type === 'audio.delta' && (typeof p.audio !== 'string' || !p.audio || !base64.test(p.audio) || globalThis.atob(p.audio).length % 2))
+        throw invalid();
+    if (value.type === 'voice.ready') {
+        if (!isObject(p.config) || typeof p.provider !== 'string' || !isObject(p.input_audio) || !isObject(p.output_audio)
+            || p.input_audio.format !== 'pcm16' || p.input_audio.sample_rate !== 16000 || p.input_audio.channels !== 1
+            || p.output_audio.format !== 'pcm16' || p.output_audio.sample_rate !== 24000 || p.output_audio.channels !== 1
+            || !isObject(p.capabilities) || typeof p.capabilities.graceful_close !== 'boolean')
+            throw invalid();
+    }
+    if (value.type === 'work.failed' && (!isObject(p.error) || typeof p.error.code !== 'string'))
+        throw invalid();
+    if (value.type === 'connection.closed' && !['no_active_response', 'no_content', 'saved', 'saved_interrupted'].includes(p.outcome))
+        throw invalid();
+    return value;
+}
+/** Decode an audio.delta payload into raw 24 kHz PCM16 bytes; this does not play it. */
+function decodeRealtimeAudio(event) {
+    if (event.type !== 'audio.delta' || typeof event.payload.audio !== 'string' || !event.payload.audio || !base64.test(event.payload.audio))
+        throw new error_js_1.QoderError('Expected a valid audio.delta Base64 payload');
+    const binary = globalThis.atob(event.payload.audio);
+    if (binary.length % 2)
+        throw new error_js_1.QoderError('PCM16 output must contain complete samples');
+    return Uint8Array.from(binary, char => char.charCodeAt(0));
+}
+/** A Node-only connection with one receiver and bounded input/output queues. No reconnect or replay. */
+class RealtimeConnection {
+    socket;
+    options;
+    conversationId;
+    ready;
+    request_id = null;
+    queue = [];
+    queueBytes = 0;
+    lastSequence = -1;
+    maxQueuedEvents;
+    maxQueueBytes;
+    sendTimeout;
+    closeTimeout;
+    readyPromise;
+    readyResolve;
+    readyReject;
+    receiver;
+    terminal;
+    ended = false;
+    closing = false;
+    sendTail = Promise.resolve();
+    sendCount = 0;
+    sendBytes = 0;
+    graceful;
+    closeAck;
+    handshakeTimer;
+    readyTimer;
+    abort;
+    constructor(socket, options) {
+        this.socket = socket;
+        this.options = options;
+        this.conversationId = options.conversationId;
+        this.maxQueuedEvents = positive(options.maxQueuedEvents, 256, 'maxQueuedEvents');
+        this.maxQueueBytes = positive(options.maxQueueBytes, 4 * 1024 * 1024, 'maxQueueBytes');
+        this.sendTimeout = positive(options.sendTimeout, 30000, 'sendTimeout');
+        this.closeTimeout = positive(options.closeTimeout, 10000, 'closeTimeout');
+        this.readyPromise = new Promise((resolve, reject) => { this.readyResolve = resolve; this.readyReject = reject; });
+        void this.readyPromise.catch(() => { });
+        this.abort = () => this.fail(new error_js_1.APIUserAbortError('Realtime connection was aborted'));
+        options.signal?.addEventListener('abort', this.abort, { once: true });
+        socket.on('upgrade', response => { this.request_id = String(response.headers['x-request-id'] ?? response.headers['request-id'] ?? '') || null; });
+        socket.on('open', () => {
+            clearTimeout(this.handshakeTimer);
+            this.readyTimer = setTimeout(() => this.fail(new error_js_1.APIConnectionTimeoutError('Realtime ready timed out')), positive(options.readyTimeout, 60000, 'readyTimeout'));
+        });
+        socket.on('message', (data, binary) => this.onMessage(data, binary));
+        socket.on('error', error => this.fail(error.message === 'Opening handshake has timed out'
+            ? new error_js_1.APIConnectionTimeoutError('Realtime handshake timed out') : new error_js_1.APIConnectionError('Realtime WebSocket transport failed')));
+        socket.on('close', (code, reason) => this.finish(code === 1000 || code === 1001 ? undefined : new RealtimeConnectionClosedError(this.conversationId, code, reason.toString())));
+        socket.on('unexpected-response', (_request, response) => {
+            let raw = '';
+            let bytes = 0;
+            response.on('data', chunk => {
+                bytes += chunk.length;
+                if (bytes > 64 * 1024) {
+                    response.destroy();
+                    this.fail(new error_js_1.APIConnectionError('Realtime handshake error body exceeded its limit'));
+                }
+                else
+                    raw += chunk.toString();
+            });
+            response.on('error', () => this.fail(new error_js_1.APIConnectionError('Realtime handshake response failed')));
+            response.on('end', () => {
+                let body = raw;
+                try {
+                    body = JSON.parse(raw);
+                }
+                catch { /* Retain bounded gateway text. */ }
+                const headers = new Headers();
+                for (const [key, value] of Object.entries(response.headers))
+                    if (value !== undefined)
+                        headers.set(key, Array.isArray(value) ? value.join(', ') : value);
+                this.fail(error_js_1.APIError.generate(response.statusCode ?? 502, body, undefined, headers));
+            });
+        });
+        this.handshakeTimer = setTimeout(() => this.fail(new error_js_1.APIConnectionTimeoutError('Realtime handshake timed out')), positive(options.handshakeTimeout, 30000, 'handshakeTimeout'));
+        if (options.signal?.aborted)
+            this.abort();
+    }
+    /** @internal */
+    static async connect(client, options) {
+        if (typeof process === 'undefined' || !process.versions?.node)
+            throw new error_js_1.QoderError('Forward Realtime requires Node.js; browsers cannot provide Authorization headers');
+        if (typeof options.conversationId !== 'string' || !options.conversationId || options.conversationId.trim() !== options.conversationId || /[\x00-\x1f\x7f]/.test(options.conversationId))
+            throw new error_js_1.QoderError('conversationId must be nonempty without surrounding whitespace or control characters');
+        for (const [key, fallback] of Object.entries({ handshakeTimeout: 30000, readyTimeout: 60000, sendTimeout: 30000, closeTimeout: 10000, maxQueuedEvents: 256, maxQueueBytes: 4 * 1024 * 1024, maxReceiveBytes: 1024 * 1024 }))
+            positive(options[key], fallback, key);
+        const handshakeDeadline = Date.now() + (options.handshakeTimeout ?? 30000);
+        const preparationController = new AbortController();
+        const cancelPreparation = () => preparationController.abort();
+        options.signal?.addEventListener('abort', cancelPreparation, { once: true });
+        let preparation;
+        try {
+            preparation = await wait(Promise.all([client._prepareRealtimeRequest({ ...options, signal: preparationController.signal }), importWS()]), options.handshakeTimeout ?? 30000, options.signal, 'Realtime authentication');
+        }
+        finally {
+            options.signal?.removeEventListener('abort', cancelPreparation);
+            preparationController.abort();
+        }
+        if (options.signal?.aborted)
+            throw new error_js_1.APIUserAbortError('Realtime connection was aborted');
+        const [{ url, headers }, module] = preparation;
+        const handshakeRemaining = handshakeDeadline - Date.now();
+        if (handshakeRemaining <= 0)
+            throw new error_js_1.APIConnectionTimeoutError('Realtime handshake timed out');
+        const Socket = module.default;
+        const transport = options.transport ?? {};
+        const socket = new Socket(url, {
+            ...transport,
+            headers: Object.fromEntries(headers.entries()),
+            followRedirects: false,
+            perMessageDeflate: false,
+            handshakeTimeout: handshakeRemaining,
+            maxPayload: options.maxReceiveBytes ?? 1024 * 1024,
+        });
+        const connection = new RealtimeConnection(socket, { ...options, handshakeTimeout: handshakeRemaining });
+        await connection.readyPromise;
+        return connection;
+    }
+    onMessage(data, binary) {
+        if (this.ended)
+            return;
+        try {
+            if (binary)
+                throw new RealtimeProtocolError('Realtime expects UTF-8 JSON text frames', this.conversationId);
+            const buffer = Array.isArray(data) ? Buffer.concat(data) : data instanceof ArrayBuffer ? Buffer.from(data) : data;
+            let value;
+            try {
+                value = JSON.parse(buffer.toString());
+            }
+            catch {
+                throw new RealtimeProtocolError('Invalid Realtime JSON', this.conversationId);
+            }
+            const event = validateEvent(value, this.conversationId);
+            if (event.sequence <= this.lastSequence)
+                throw new RealtimeProtocolError('Realtime sequence did not increase', this.conversationId);
+            this.lastSequence = event.sequence;
+            const size = buffer.byteLength;
+            if (this.receiver) {
+                const receiver = this.receiver;
+                this.receiver = undefined;
+                receiver.resolve({ done: false, value: event });
+            }
+            else {
+                if (this.queue.length >= this.maxQueuedEvents || this.queueBytes + size > this.maxQueueBytes)
+                    throw new RealtimeProtocolError('Realtime receive queue capacity exceeded', this.conversationId, 'queue_overflow');
+                this.queue.push({ event, bytes: size });
+                this.queueBytes += size;
+            }
+            if (event.type === 'voice.ready' && !this.ready) {
+                this.ready = event.payload;
+                clearTimeout(this.readyTimer);
+                this.readyResolve();
+            }
+            if (event.type === 'connection.closed' && event.payload.request_id === this.closeAck?.requestId)
+                this.closeAck?.resolve(event.payload);
+            if (event.type === 'voice.replaced')
+                this.fail(new RealtimeProtocolError('Realtime connection was replaced', this.conversationId, 'voice.replaced'));
+            if (event.type === 'error' && (!this.ready || terminalErrors.has(String(event.payload.code))))
+                this.fail(new RealtimeServerError(event));
+        }
+        catch (error) {
+            this.fail(error instanceof Error ? error : new error_js_1.APIConnectionError('Realtime receive failed'));
+        }
+    }
+    finish(error) {
+        if (this.ended)
+            return;
+        this.ended = true;
+        this.terminal = error;
+        clearTimeout(this.handshakeTimer);
+        clearTimeout(this.readyTimer);
+        this.options.signal?.removeEventListener('abort', this.abort);
+        this.readyReject(error ?? new RealtimeConnectionClosedError(this.conversationId, 1000, 'Closed before ready'));
+        this.closeAck?.reject(error ?? new RealtimeConnectionClosedError(this.conversationId, 1000, 'Closed without matching acknowledgement'));
+        if (this.receiver) {
+            const receiver = this.receiver;
+            this.receiver = undefined;
+            if (error)
+                receiver.reject(error);
+            else
+                receiver.resolve({ done: true, value: undefined });
+        }
+    }
+    fail(error) { this.finish(error); this.socket.terminate(); }
+    /** Read one event. Concurrent consumers are rejected instead of stealing each other's events. */
+    async receive(options = {}) {
+        if (this.receiver)
+            throw new error_js_1.QoderError('Only one Realtime event consumer is allowed');
+        if (options.signal?.aborted)
+            throw new error_js_1.APIUserAbortError('Realtime receive was aborted');
+        const queued = this.queue.shift();
+        if (queued) {
+            this.queueBytes -= queued.bytes;
+            return { done: false, value: queued.event };
+        }
+        if (this.ended) {
+            if (this.terminal)
+                throw this.terminal;
+            return { done: true, value: undefined };
+        }
+        let receiver;
+        const pending = new Promise((resolve, reject) => { this.receiver = receiver = { resolve, reject }; });
+        try {
+            return await wait(pending, positive(options.timeout, 2 ** 31 - 1, 'receive timeout'), options.signal, 'Realtime receive');
+        }
+        finally {
+            if (this.receiver === receiver)
+                this.receiver = undefined;
+        }
+    }
+    async *[Symbol.asyncIterator]() {
+        for (;;) {
+            const next = await this.receive();
+            if (next.done)
+                return;
+            yield next.value;
+        }
+    }
+    /** Serialize sends in call order; no input is automatically replayed. */
+    sendEvent(event, options = {}) {
+        const timeout = positive(options.timeout, this.sendTimeout, 'send timeout');
+        if (options.signal?.aborted)
+            return Promise.reject(new error_js_1.APIUserAbortError('Realtime send was aborted'));
+        if (!event || event.version !== types_js_1.REALTIME_VERSION || typeof event.type !== 'string' || !event.type || !isObject(event.payload))
+            throw new error_js_1.QoderError('Client events require version, type and object payload');
+        if (this.ended || this.socket.readyState !== 1)
+            throw this.terminal ?? new error_js_1.QoderError('Realtime connection is closed');
+        if (this.closing && !['connection.close', 'ping'].includes(event.type))
+            throw new error_js_1.QoderError('Realtime connection is closing');
+        if (event.type === 'text.message' && (typeof event.payload.text !== 'string' || !event.payload.text.trim() || new TextEncoder().encode(event.payload.text.trim()).length > 16 * 1024))
+            throw new error_js_1.QoderError('Realtime text must be nonempty and at most 16 KiB UTF-8');
+        if (event.type === 'audio.append' && (typeof event.payload.audio !== 'string' || !event.payload.audio || !base64.test(event.payload.audio) || globalThis.atob(event.payload.audio).length % 2))
+            throw new error_js_1.QoderError('Audio append requires nonempty Base64 PCM16');
+        if (event.type === 'connection.close') {
+            const id = event.payload.request_id;
+            if (typeof id !== 'string' || !id || id.trim() !== id || Buffer.byteLength(id) > 128 || /[\x00-\x1f\x7f]/.test(id))
+                throw new error_js_1.QoderError('Invalid connection.close request_id');
+        }
+        const json = JSON.stringify(event);
+        const bytes = Buffer.byteLength(json);
+        if (bytes > CLIENT_MESSAGE_BYTES)
+            throw new error_js_1.QoderError('Realtime client JSON message exceeds 256 KiB');
+        if (this.sendCount >= this.maxQueuedEvents || this.sendBytes + bytes > this.maxQueueBytes)
+            throw new error_js_1.QoderError('Realtime send queue capacity exceeded');
+        this.sendCount++;
+        this.sendBytes += bytes;
+        const result = this.sendTail.then(async () => {
+            if (this.ended)
+                throw this.terminal ?? new error_js_1.QoderError('Realtime connection is closed');
+            if (options.signal?.aborted)
+                throw new error_js_1.APIUserAbortError('Realtime send was aborted');
+            const written = new Promise((resolve, reject) => this.socket.send(json, { binary: false }, error => error ? reject(new error_js_1.APIConnectionError('Realtime send failed')) : resolve()));
+            try {
+                await wait(written, timeout, options.signal, 'Realtime send');
+            }
+            catch (error) {
+                this.fail(error);
+                throw error;
+            }
+        }).finally(() => { this.sendCount--; this.sendBytes -= bytes; });
+        this.sendTail = result.catch(() => { });
+        const deadline = wait(result, timeout, options.signal, 'Realtime send');
+        return deadline.catch(error => { this.fail(error); throw error; });
+    }
+    sendText(text, options) {
+        if (typeof text !== 'string' || !text.trim() || new TextEncoder().encode(text.trim()).length > 16 * 1024)
+            throw new error_js_1.QoderError('Realtime text must be nonempty and at most 16 KiB UTF-8');
+        return this.sendEvent({ version: types_js_1.REALTIME_VERSION, type: 'text.message', payload: { text: text.trim() } }, options);
+    }
+    appendAudio(pcm, options) {
+        if (!(pcm instanceof Uint8Array) || !pcm.byteLength || pcm.byteLength % 2)
+            throw new error_js_1.QoderError('Audio must contain nonempty, complete PCM16 samples');
+        if (pcm.byteLength > CLIENT_MESSAGE_BYTES * 3 / 4)
+            throw new error_js_1.QoderError('Realtime client JSON message exceeds 256 KiB');
+        return this.sendEvent({ version: types_js_1.REALTIME_VERSION, type: 'audio.append', payload: { audio: Buffer.from(pcm.buffer, pcm.byteOffset, pcm.byteLength).toString('base64') } }, options);
+    }
+    interrupt(options) { return this.sendEvent({ version: types_js_1.REALTIME_VERSION, type: 'interrupt', payload: {} }, options); }
+    ping(options) { return this.sendEvent({ version: types_js_1.REALTIME_VERSION, type: 'ping', payload: {} }, options); }
+    playbackStarted(receipt = {}, options) { return this.playback('playback.started', receipt, options); }
+    playbackEnded(receipt = {}, options) { return this.playback('playback.ended', receipt, options); }
+    playbackCancelled(receipt = {}, options) { return this.playback('playback.cancelled', receipt, options); }
+    playback(type, receipt, options) {
+        for (const value of Object.values(receipt))
+            if (typeof value !== 'string' || !value)
+                throw new error_js_1.QoderError('Playback identifiers must be nonempty strings');
+        return this.sendEvent({ version: types_js_1.REALTIME_VERSION, type, payload: { ...receipt } }, options);
+    }
+    /** Send connection.close, require its matching persistence acknowledgement, then release transport. */
+    closeGracefully(options = {}) {
+        if (this.graceful)
+            return this.graceful;
+        if (this.ended)
+            return Promise.reject(this.terminal ?? new error_js_1.QoderError('Realtime connection is closed'));
+        if (!this.ready.capabilities.graceful_close)
+            return Promise.reject(new error_js_1.QoderError('Server does not support graceful close'));
+        const requestId = options.requestId ?? globalThis.crypto.randomUUID();
+        if (!requestId || requestId.trim() !== requestId || Buffer.byteLength(requestId) > 128 || /[\x00-\x1f\x7f]/.test(requestId))
+            throw new error_js_1.QoderError('Close requestId must be 1–128 UTF-8 bytes without surrounding whitespace or control characters');
+        const timeout = positive(options.timeout, this.closeTimeout, 'close timeout');
+        if (options.signal?.aborted)
+            return Promise.reject(new error_js_1.APIUserAbortError('Realtime graceful close was aborted'));
+        this.closing = true;
+        const acknowledgement = new Promise((resolve, reject) => { this.closeAck = { requestId, resolve, reject }; });
+        void acknowledgement.catch(() => { });
+        this.graceful = (async () => {
+            try {
+                const confirmed = wait(acknowledgement, timeout, options.signal, 'Realtime graceful close');
+                void confirmed.catch(() => { });
+                await this.sendEvent({ version: types_js_1.REALTIME_VERSION, type: 'connection.close', payload: { request_id: requestId } }, options);
+                return await confirmed;
+            }
+            finally {
+                this.close();
+            }
+        })();
+        return this.graceful;
+    }
+    /** Transport close does not promise history persistence or cancel background Work. */
+    close() {
+        this.finish();
+        if (this.socket.readyState === 1) {
+            this.socket.close(1000);
+            const timer = setTimeout(() => this.socket.terminate(), 1000);
+            timer.unref();
+            this.socket.once('close', () => clearTimeout(timer));
+        }
+        else
+            this.socket.terminate();
+    }
+}
+exports.RealtimeConnection = RealtimeConnection;
+//# sourceMappingURL=connection.js.map