@lingya-ai/agents-sdk 0.5.0 → 0.7.1

package/dist/esm/models/index.js

@@ -2,6 +2,11 @@
 /* eslint-disable */
 export * from './AgentAsyncTaskSync';
 export * from './AgentFile';
+export * from './AgentGoal';
+export * from './AgentGoalConfig';
+export * from './AgentGoalHistory';
+export * from './AgentGoalRefInput';
+export * from './AgentGoalView';
 export * from './AgentsConfig';
 export * from './AiChatAwaitingInputBriefEvent';
 export * from './AiChatBriefEvent';
@@ -19,8 +24,6 @@ export * from './AiChatInput';
 export * from './AiChatManualInterruptBriefEvent';
 export * from './AiChatMessageBriefEvent';
 export * from './AiChatMessageEvent';
-export * from './AiChatRequestBriefEvent';
-export * from './AiChatResponseBriefEvent';
 export * from './AiChatStartBriefEvent';
 export * from './AiChatStreamInput';
 export * from './AiChatSubAgentCallBriefEvent';
@@ -32,7 +35,6 @@ export * from './ArtifactInfo';
 export * from './AskUserQuestionExtensionContent';
 export * from './AskUserQuestionExtensionToolExtension';
 export * from './AskUserQuestionOption';
-export * from './AssistantChatMessage';
 export * from './AsyncTask';
 export * from './AsyncTaskPage';
 export * from './AttachmentExtension';
@@ -43,10 +45,8 @@ export * from './ChartQualitySummary';
 export * from './ChartSeries';
 export * from './ChartSpec';
 export * from './ChartTimeContext';
-export * from './ChatMessage';
 export * from './ChatModelConfig';
 export * from './ChatModelSpec';
-export * from './ChatOptions';
 export * from './ChatStreamProbeEvent';
 export * from './ChatStreamProbeInput';
 export * from './CitationMetadata';
@@ -58,16 +58,17 @@ export * from './ConversationActivityBatchInput';
 export * from './ConversationActivityList';
 export * from './ConversationConfig';
 export * from './ConversationContextUsage';
+export * from './ConversationGroup';
+export * from './ConversationGroupDeleted';
+export * from './ConversationGroupList';
+export * from './ConversationGroupNameInput';
 export * from './ConversationIds';
 export * from './ConversationMessage';
 export * from './ConversationMessagePage';
+export * from './ConversationMessageSync';
+export * from './ConversationMetadata';
 export * from './ConversationReadReceipt';
 export * from './ConversationReadReceiptInput';
-export * from './ConversationShareCreated';
-export * from './ConversationShareInput';
-export * from './ConversationShareList';
-export * from './ConversationShareRecord';
-export * from './ConversationShareRevoked';
 export * from './ConversationStats';
 export * from './ConversationStatusInput';
 export * from './ConversationSummary';
@@ -79,6 +80,7 @@ export * from './CreateFileInput';
 export * from './DecimalChartColumn';
 export * from './DefaultModel';
 export * from './DoubleChartColumn';
+export * from './EditAgentGoalInput';
 export * from './FieldError';
 export * from './FileExists';
 export * from './GeneratePreSignedUrlInput';
@@ -103,6 +105,7 @@ export * from './MediaAttachment';
 export * from './ModelConfig';
 export * from './ModelKeyGroup';
 export * from './MultimodalMediaAttachment';
+export * from './OpenApiToken';
 export * from './OperationResult';
 export * from './PageInfo';
 export * from './PlanApprovalExtensionContent';
@@ -129,18 +132,14 @@ export * from './SubagentTaskArtifact';
 export * from './SubagentTaskPage';
 export * from './SubagentTaskResult';
 export * from './SubagentTaskSync';
-export * from './SystemChatMessage';
 export * from './TaskProgressExtensionContent';
 export * from './TaskProgressExtensionToolExtension';
 export * from './TaskSummary';
-export * from './ToolCall';
 export * from './ToolExtension';
-export * from './ToolResponse';
-export * from './ToolResponseChatMessage';
 export * from './UnknownAiChatBriefEvent';
 export * from './UnknownToolExtension';
+export * from './UpdateConversationGroupInput';
 export * from './Usage';
-export * from './UserChatMessage';
 export * from './UserInputAnswerInput';
 export * from './UserInputStatus';
 export * from './ValidationError';

package/dist/esm/runtime.d.ts

@@ -1,3 +1,4 @@
+import { ApiError } from './lifecycle';
 /**
  * Lingya Agents OpenAPI
  * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
@@ -69,12 +70,12 @@ export declare class BaseAPI {
      */
     private clone;
 }
-export declare class ResponseError extends Error {
+export declare class ResponseError extends ApiError {
     response: Response;
     name: "ResponseError";
     constructor(response: Response, msg?: string);
 }
-export declare class FetchError extends Error {
+export declare class FetchError extends ApiError {
     cause: Error;
     name: "FetchError";
     constructor(cause: Error, msg?: string);

package/dist/esm/runtime.js

@@ -1,3 +1,13 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { ApiError } from './lifecycle';
 /* tslint:disable */
 /* eslint-disable */
 /**
@@ -11,15 +21,6 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 export const BASE_PATH = "https://tenant.example.com".replace(/\/+$/, "");
 export class Configuration {
     constructor(configuration = {}) {
@@ -151,12 +152,18 @@ export class BaseAPI {
     }
     request(context, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             const { url, init } = yield this.createFetchParams(context, initOverrides);
             const response = yield this.fetchApi(url, init);
             if (response && (response.status >= 200 && response.status < 300)) {
                 return response;
             }
-            throw new ResponseError(response, 'Response returned an error code');
+            const error = new ResponseError(response, 'Response returned an error code');
+            const decoded = new ApiError(context.method, context.path, response.status, (yield response.clone().text()).slice(0, 65536), { requestId: (_a = response.headers.get('X-Request-ID')) !== null && _a !== void 0 ? _a : undefined });
+            Object.assign(error, decoded);
+            error.name = 'ResponseError';
+            error.message = decoded.message;
+            throw error;
         });
     }
     createFetchParams(context, initOverrides) {
@@ -218,9 +225,10 @@ function isBlob(value) {
 function isFormData(value) {
     return typeof FormData !== "undefined" && value instanceof FormData;
 }
-export class ResponseError extends Error {
+export class ResponseError extends ApiError {
     constructor(response, msg) {
-        super(msg);
+        var _a;
+        super('', '', response.status, '', { kind: 'http', requestId: (_a = response.headers.get('X-Request-ID')) !== null && _a !== void 0 ? _a : undefined });
         this.response = response;
         this.name = "ResponseError";
         // restore prototype chain
@@ -230,11 +238,13 @@ export class ResponseError extends Error {
         }
     }
 }
-export class FetchError extends Error {
+export class FetchError extends ApiError {
     constructor(cause, msg) {
-        super(msg);
+        super('', '', undefined, '', { kind: cause instanceof ApiError ? cause.kind : 'network', cause });
         this.cause = cause;
         this.name = "FetchError";
+        if (cause instanceof ApiError)
+            this.message = cause.message;
         // restore prototype chain
         const actualProto = new.target.prototype;
         if (Object.setPrototypeOf) {

package/dist/esm/sse.d.ts

@@ -1,8 +1,2 @@
-/**
- * 按 SSE 规范解码分片、多行 data 与心跳。 / Decodes chunked, multiline SSE data while ignoring heartbeats.
- *
- * @param response - Content-Type 为 `text/event-stream` 且 body 未被读取的成功响应。
- * @returns 每个完整事件合并后的 data 字符串；关闭迭代器会取消后续读取。
- * @throws Error 当响应没有可读 body。
- */
-export declare function decodeSse(response: Response): AsyncGenerator<string>;
+/** Incremental SSE decoding compatible with Chromium 102. */
+export declare function decodeSse(response: Response, signal?: AbortSignal, onComment?: (comment: string) => void): AsyncGenerator<string>;

package/dist/esm/sse.js

@@ -11,47 +11,58 @@ var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _ar
     function reject(value) { resume("throw", value); }
     function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
 };
-/**
- * 按 SSE 规范解码分片、多行 data 与心跳。 / Decodes chunked, multiline SSE data while ignoring heartbeats.
- *
- * @param response - Content-Type 为 `text/event-stream` 且 body 未被读取的成功响应。
- * @returns 每个完整事件合并后的 data 字符串；关闭迭代器会取消后续读取。
- * @throws Error 当响应没有可读 body。
- */
-export function decodeSse(response) {
+import { ApiError, abortable, checkSignal } from './lifecycle';
+/** Incremental SSE decoding compatible with Chromium 102. */
+export function decodeSse(response, signal, onComment) {
     return __asyncGenerator(this, arguments, function* decodeSse_1() {
         var _a, _b;
-        if (response.body === null)
-            throw new Error('SSE response has no body');
-        const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
-        let buffer = '';
-        let data = [];
+        if (!/^text\/event-stream(?:\s*;|\s*$)/i.test((_a = response.headers.get('Content-Type')) !== null && _a !== void 0 ? _a : '') || !response.body) {
+            yield __await(((_b = response.body) === null || _b === void 0 ? void 0 : _b.cancel()));
+            throw new ApiError('', '', response.status, '', { kind: 'protocol' });
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder('utf-8', { fatal: true });
+        let buffer = '', data = [];
+        const cancel = () => { void reader.cancel().catch(() => undefined); };
+        signal === null || signal === void 0 ? void 0 : signal.addEventListener('abort', cancel, { once: true });
         try {
             for (;;) {
-                const chunk = yield __await(reader.read());
-                buffer += (_a = chunk.value) !== null && _a !== void 0 ? _a : '';
-                const lines = buffer.split(/\r?\n/);
-                buffer = (_b = lines.pop()) !== null && _b !== void 0 ? _b : '';
-                for (const line of lines) {
+                checkSignal(signal);
+                const chunk = yield __await(abortable(reader.read(), signal));
+                buffer += chunk.done ? decoder.decode() : decoder.decode(chunk.value, { stream: true });
+                let match;
+                while ((match = /\r\n|\r|\n/.exec(buffer)) !== null) {
+                    if (!chunk.done && match[0] === '\r' && match.index === buffer.length - 1)
+                        break;
+                    const line = buffer.slice(0, match.index);
+                    buffer = buffer.slice(match.index + match[0].length);
                     if (line === '') {
-                        if (data.length > 0)
+                        if (data.length)
                             yield yield __await(data.join('\n'));
                         data = [];
                     }
-                    else if (line.startsWith('data:')) {
+                    else if (line.startsWith(':'))
+                        onComment === null || onComment === void 0 ? void 0 : onComment(line.slice(1).trim());
+                    else if (line === 'data' || line.startsWith('data:'))
                         data.push(line.slice(5).replace(/^ /, ''));
-                    }
                 }
                 if (chunk.done)
                     break;
             }
-            if (buffer.startsWith('data:'))
-                data.push(buffer.slice(5).replace(/^ /, ''));
-            if (data.length > 0)
-                yield yield __await(data.join('\n'));
+        }
+        catch (error) {
+            if (error instanceof TypeError && !(signal === null || signal === void 0 ? void 0 : signal.aborted))
+                throw new ApiError('', '', undefined, '', { kind: 'protocol' });
+            throw error;
         }
         finally {
-            reader.releaseLock();
+            signal === null || signal === void 0 ? void 0 : signal.removeEventListener('abort', cancel);
+            try {
+                yield __await(reader.cancel());
+            }
+            finally {
+                reader.releaseLock();
+            }
         }
     });
 }

package/dist/esm/subscription.d.ts

@@ -0,0 +1,72 @@
+import { ApiError, RequestOptions } from './lifecycle';
+import { type AiChatBriefEvent } from './events';
+export interface ConnectionEvent {
+    connectionId?: string;
+    type: 'opened' | 'ready' | 'heartbeat' | 'closed';
+    transport: 'sse' | 'websocket';
+    requestId?: string;
+    reason?: string;
+    closeCode?: number;
+}
+export interface StreamOptions extends RequestOptions {
+    xRequestID?: string;
+    transport?: 'sse' | 'websocket';
+    idleTimeoutMs?: number;
+    onConnectionEvent?: (event: ConnectionEvent) => void;
+}
+export interface StreamCloseInfo {
+    reason: 'end' | 'complete' | 'normal' | 'closed' | 'cancelled' | 'timeout' | 'error';
+    error?: ApiError;
+    closeCode?: number;
+}
+export interface WebSocketLike {
+    serverRequestId?: string;
+    handshakeError?: ApiError;
+    onopen: ((event: any) => void) | null;
+    onmessage: ((event: {
+        data: any;
+    }) => void) | null;
+    onerror: ((event: any) => void) | null;
+    onclose: ((event: {
+        code: number;
+        reason: string;
+    }) => void) | null;
+    close(code?: number, reason?: string): void;
+}
+export type WebSocketFactory = (url: string, options: {
+    protocols: string[];
+    headers?: Record<string, string>;
+}) => WebSocketLike;
+export type WebSocketConnector = (url: string, signal: AbortSignal, requestId?: string) => Promise<WebSocketLike>;
+export type StreamRequest = (signal: AbortSignal) => Promise<Response>;
+/** One connection, no replay, retry, UI merging or recovery policy. */
+export declare class ChatSubscription implements AsyncIterable<AiChatBriefEvent> {
+    private readonly request;
+    private readonly url;
+    private readonly messageId;
+    private readonly options;
+    private readonly connect?;
+    readonly events: AsyncIterable<AiChatBriefEvent>;
+    readonly closed: Promise<StreamCloseInfo>;
+    private readonly scope;
+    private readonly queue;
+    private wake?;
+    private done;
+    private failure?;
+    private finish;
+    private idleTimer?;
+    private reason;
+    private serverRequestId?;
+    private closeCode?;
+    private readonly connectionId;
+    constructor(request: StreamRequest, url: string, messageId: string, options?: StreamOptions, connect?: WebSocketConnector);
+    close(): void;
+    private diagnostic;
+    private activity;
+    private push;
+    private run;
+    private websocket;
+    [Symbol.asyncIterator](): AsyncGenerator<AiChatBriefEvent>;
+}
+/** Finite SSE endpoints permit EOF, while sharing cancellation and idle semantics. */
+export declare function finiteSse(request: StreamRequest, options?: StreamOptions): AsyncGenerator<string>;

package/dist/esm/subscription.js

@@ -0,0 +1,282 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+import { ApiError, RequestScope, abortable, normalizeError } from './lifecycle';
+import { decodeAiChatBriefEvent } from './events';
+import { decodeSse } from './sse';
+let nextConnectionId = 0;
+/** One connection, no replay, retry, UI merging or recovery policy. */
+export class ChatSubscription {
+    constructor(request, url, messageId, options = {}, connect) {
+        this.request = request;
+        this.url = url;
+        this.messageId = messageId;
+        this.options = options;
+        this.connect = connect;
+        this.events = this;
+        this.queue = [];
+        this.done = false;
+        this.reason = 'closed';
+        this.connectionId = `connection-${++nextConnectionId}`;
+        if (options.idleTimeoutMs !== undefined && (!Number.isFinite(options.idleTimeoutMs) || options.idleTimeoutMs <= 0))
+            throw new RangeError('idleTimeoutMs must be positive');
+        this.scope = new RequestScope(options);
+        this.closed = new Promise(resolve => { this.finish = resolve; });
+        void this.run();
+    }
+    close() { this.reason = 'closed'; this.scope.controller.abort(); }
+    diagnostic(type, requestId = this.serverRequestId) {
+        var _a, _b, _c;
+        try {
+            (_b = (_a = this.options).onConnectionEvent) === null || _b === void 0 ? void 0 : _b.call(_a, { type, connectionId: this.connectionId, transport: (_c = this.options.transport) !== null && _c !== void 0 ? _c : 'sse', requestId, reason: type === 'closed' ? this.reason : undefined, closeCode: this.closeCode });
+        }
+        catch ( /* Observers do not own connection state. */_d) { /* Observers do not own connection state. */ }
+    }
+    activity() {
+        clearTimeout(this.idleTimer);
+        if (this.options.idleTimeoutMs !== undefined)
+            this.idleTimer = setTimeout(() => this.scope.controller.abort(new ApiError('', '', undefined, '', { kind: 'timeout' })), this.options.idleTimeoutMs);
+    }
+    push(data) {
+        var _a;
+        const event = decodeAiChatBriefEvent(data);
+        if (this.queue.length >= 1024)
+            throw new ApiError('', '', undefined, '', { kind: 'protocol' });
+        this.queue.push(event);
+        (_a = this.wake) === null || _a === void 0 ? void 0 : _a.call(this);
+        if (event.type === 'end') {
+            this.reason = 'end';
+            return true;
+        }
+        return false;
+    }
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, e_1, _b, _c;
+            var _d, _e, _f;
+            let requestId;
+            try {
+                if (this.options.transport === 'websocket')
+                    yield this.websocket();
+                else {
+                    const response = yield abortable(this.request(this.scope.signal), this.scope.signal);
+                    requestId = (_d = response.headers.get('X-Request-ID')) !== null && _d !== void 0 ? _d : undefined;
+                    this.diagnostic('opened', requestId);
+                    this.activity();
+                    try {
+                        for (var _g = true, _h = __asyncValues(decodeSse(response, this.scope.signal, comment => {
+                            this.activity();
+                            this.diagnostic(comment === 'ready' ? 'ready' : 'heartbeat', requestId);
+                        })), _j; _j = yield _h.next(), _a = _j.done, !_a; _g = true) {
+                            _c = _j.value;
+                            _g = false;
+                            const data = _c;
+                            this.activity();
+                            if (this.push(data))
+                                break;
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (!_g && !_a && (_b = _h.return)) yield _b.call(_h);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                    if (this.reason !== 'end')
+                        throw new ApiError('', '', undefined, '', { kind: 'unexpected_eof', requestId });
+                }
+            }
+            catch (error) {
+                if (!this.scope.signal.aborted || ((_e = this.options.signal) === null || _e === void 0 ? void 0 : _e.aborted) || this.scope.signal.reason instanceof ApiError) {
+                    this.failure = yield normalizeError(error, this.scope.signal);
+                    this.reason = this.failure.kind === 'timeout' ? 'timeout' : this.failure.kind === 'cancelled' ? 'cancelled' : 'error';
+                }
+            }
+            finally {
+                this.scope.controller.abort();
+                this.scope.dispose();
+                clearTimeout(this.idleTimer);
+                this.done = true;
+                (_f = this.wake) === null || _f === void 0 ? void 0 : _f.call(this);
+                this.diagnostic('closed', requestId);
+                this.finish({ reason: this.reason, error: this.failure, closeCode: this.closeCode });
+            }
+        });
+    }
+    websocket() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.connect)
+                throw new ApiError('', '', undefined, '', { kind: 'protocol' });
+            const socket = yield abortable(this.connect(this.url, this.scope.signal, this.options.xRequestID), this.scope.signal);
+            yield new Promise((resolve, reject) => {
+                let settled = false, ready = false;
+                const settle = (error) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    this.scope.signal.removeEventListener('abort', abort);
+                    socket.onopen = socket.onmessage = socket.onerror = socket.onclose = null;
+                    try {
+                        socket.close(1000, 'client-close');
+                    }
+                    catch ( /* Already closed. */_a) { /* Already closed. */ }
+                    error ? reject(error) : resolve();
+                };
+                const abort = () => settle(new ApiError('', '', undefined, '', { kind: 'cancelled' }));
+                this.scope.signal.addEventListener('abort', abort, { once: true });
+                if (this.scope.signal.aborted) {
+                    abort();
+                    return;
+                }
+                socket.onopen = () => { this.serverRequestId = socket.serverRequestId; this.diagnostic('opened'); this.activity(); };
+                socket.onmessage = frame => {
+                    try {
+                        this.activity();
+                        if (typeof frame.data !== 'string')
+                            throw new Error('Expected text frame');
+                        const value = JSON.parse(frame.data);
+                        if (value.id !== this.messageId || typeof value.event !== 'string')
+                            throw new Error('Invalid envelope');
+                        if (value.event === 'ready') {
+                            ready = true;
+                            this.diagnostic('ready');
+                        }
+                        else if (value.event === 'complete') {
+                            this.reason = 'complete';
+                            settle();
+                        }
+                        else if (value.event === 'transport-error')
+                            throw new ApiError('', '', undefined, JSON.stringify(value.data), { kind: 'protocol' });
+                        else {
+                            if (!ready || !value.data || typeof value.data.type !== 'string')
+                                throw new Error('Invalid business frame');
+                            if (this.push(JSON.stringify(value.data)))
+                                settle();
+                        }
+                    }
+                    catch (error) {
+                        settle(error instanceof ApiError ? error : new ApiError('', '', undefined, '', { kind: 'protocol' }));
+                    }
+                };
+                socket.onerror = () => { var _a; return settle((_a = socket.handshakeError) !== null && _a !== void 0 ? _a : new ApiError('', '', undefined, '', { kind: 'network' })); };
+                socket.onclose = event => { this.closeCode = event.code; if (event.code === 1000) {
+                    this.reason = 'normal';
+                    settle();
+                }
+                else
+                    settle(new ApiError('', '', undefined, '', { kind: 'unexpected_eof' })); };
+            });
+        });
+    }
+    [Symbol.asyncIterator]() {
+        return __asyncGenerator(this, arguments, function* _a() {
+            try {
+                for (;;) {
+                    if (this.queue.length) {
+                        yield yield __await(this.queue.shift());
+                        continue;
+                    }
+                    if (this.done) {
+                        if (this.failure)
+                            throw this.failure;
+                        return yield __await(void 0);
+                    }
+                    yield __await(new Promise(resolve => { this.wake = resolve; }));
+                }
+            }
+            finally {
+                this.close();
+                yield __await(this.closed);
+            }
+        });
+    }
+}
+/** Finite SSE endpoints permit EOF, while sharing cancellation and idle semantics. */
+export function finiteSse(request_1) {
+    return __asyncGenerator(this, arguments, function* finiteSse_1(request, options = {}) {
+        var _a, e_2, _b, _c;
+        var _d;
+        if (options.idleTimeoutMs !== undefined && (!Number.isFinite(options.idleTimeoutMs) || options.idleTimeoutMs <= 0))
+            throw new RangeError('idleTimeoutMs must be positive');
+        const scope = new RequestScope(options);
+        let timer;
+        let reason = 'closed', requestId;
+        const connectionId = `connection-${++nextConnectionId}`;
+        const diagnostic = (type) => {
+            var _a;
+            try {
+                (_a = options.onConnectionEvent) === null || _a === void 0 ? void 0 : _a.call(options, { type, transport: 'sse', connectionId, requestId, reason: type === 'closed' ? reason : undefined });
+            }
+            catch ( /* Observer only. */_b) { /* Observer only. */ }
+        };
+        const activity = () => {
+            clearTimeout(timer);
+            if (options.idleTimeoutMs !== undefined)
+                timer = setTimeout(() => scope.controller.abort(new ApiError('', '', undefined, '', { kind: 'timeout' })), options.idleTimeoutMs);
+        };
+        try {
+            if (options.transport === 'websocket')
+                throw new ApiError('', '', undefined, '', { kind: 'protocol' });
+            const response = yield __await(abortable(request(scope.signal), scope.signal));
+            requestId = (_d = response.headers.get('X-Request-ID')) !== null && _d !== void 0 ? _d : undefined;
+            diagnostic('opened');
+            activity();
+            try {
+                for (var _e = true, _f = __asyncValues(decodeSse(response, scope.signal, comment => { activity(); diagnostic(comment === 'ready' ? 'ready' : 'heartbeat'); })), _g; _g = yield __await(_f.next()), _a = _g.done, !_a; _e = true) {
+                    _c = _g.value;
+                    _e = false;
+                    const data = _c;
+                    activity();
+                    yield yield __await(data);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (!_e && !_a && (_b = _f.return)) yield __await(_b.call(_f));
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            reason = 'normal';
+        }
+        catch (error) {
+            const normalized = yield __await(normalizeError(error, scope.signal));
+            requestId !== null && requestId !== void 0 ? requestId : (requestId = normalized.requestId);
+            reason = normalized.kind === 'timeout' ? 'timeout' : normalized.kind === 'cancelled' ? 'cancelled' : 'error';
+            throw normalized;
+        }
+        finally {
+            scope.controller.abort();
+            scope.dispose();
+            clearTimeout(timer);
+            diagnostic('closed');
+        }
+    });
+}