@glexir/sdk 0.0.0-stage → 0.2.0

package/dist/core/streaming.js

@@ -0,0 +1,238 @@
+import { APIError, GlexirError } from './errors.js';
+/**
+ * Splits a byte stream into lines, handling `\n`, `\r` and `\r\n` endings even when
+ * a line ending is split across chunks.
+ */
+export class LineDecoder {
+    buffer = '';
+    trailingCR = false;
+    decoder = new TextDecoder();
+    decode(chunk) {
+        let text = typeof chunk === 'string' ? chunk : this.decoder.decode(chunk, { stream: true });
+        if (this.trailingCR) {
+            // A `\r` ended the previous chunk; a leading `\n` here belongs to it.
+            if (text.startsWith('\n'))
+                text = text.slice(1);
+            this.trailingCR = false;
+        }
+        if (text.endsWith('\r')) {
+            this.trailingCR = true;
+        }
+        this.buffer += text;
+        const lines = [];
+        let match;
+        const pattern = /\r\n|\r|\n/g;
+        let start = 0;
+        while ((match = pattern.exec(this.buffer)) !== null) {
+            lines.push(this.buffer.slice(start, match.index));
+            start = match.index + match[0].length;
+        }
+        this.buffer = this.buffer.slice(start);
+        return lines;
+    }
+    flush() {
+        const rest = this.buffer + this.decoder.decode();
+        this.buffer = '';
+        this.trailingCR = false;
+        return rest ? [rest] : [];
+    }
+}
+/** Assembles SSE lines into events per the WHATWG EventSource parsing rules (only `event` and `data` are used). */
+export class SSEDecoder {
+    data = [];
+    event = null;
+    chunks = [];
+    decode(line) {
+        if (line === '') {
+            if (!this.event && this.data.length === 0)
+                return null;
+            const sse = { event: this.event, data: this.data.join('\n'), raw: this.chunks };
+            this.event = null;
+            this.data = [];
+            this.chunks = [];
+            return sse;
+        }
+        this.chunks.push(line);
+        if (line.startsWith(':'))
+            return null;
+        const colon = line.indexOf(':');
+        const field = colon === -1 ? line : line.slice(0, colon);
+        let value = colon === -1 ? '' : line.slice(colon + 1);
+        if (value.startsWith(' '))
+            value = value.slice(1);
+        if (field === 'event')
+            this.event = value;
+        else if (field === 'data')
+            this.data.push(value);
+        return null;
+    }
+}
+async function* iterBytes(body) {
+    const reader = body.getReader();
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                return;
+            if (value)
+                yield value;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+export async function* iterSSEMessages(body) {
+    const lines = new LineDecoder();
+    const sse = new SSEDecoder();
+    for await (const chunk of iterBytes(body)) {
+        for (const line of lines.decode(chunk)) {
+            const event = sse.decode(line);
+            if (event)
+                yield event;
+        }
+    }
+    for (const line of lines.flush()) {
+        const event = sse.decode(line);
+        if (event)
+            yield event;
+    }
+    // An event with no terminating blank line is still delivered at EOF.
+    const last = sse.decode('');
+    if (last)
+        yield last;
+}
+function parseEventData(sse) {
+    try {
+        return JSON.parse(sse.data);
+    }
+    catch {
+        throw new GlexirError(`Could not parse server-sent event data as JSON: ${sse.data.slice(0, 200)}`);
+    }
+}
+/** An async-iterable stream of parsed events. Breaking out of the loop aborts the HTTP request. */
+export class Stream {
+    iterator;
+    controller;
+    response;
+    consumed = false;
+    constructor(iterator, controller, 
+    /** The underlying HTTP response, if this stream came from one. */
+    response) {
+        this.iterator = iterator;
+        this.controller = controller;
+        this.response = response;
+    }
+    static fromSSEResponse(response, controller) {
+        async function* iterator() {
+            if (!response.body) {
+                controller.abort();
+                throw new GlexirError('Attempted to iterate over a response with no body');
+            }
+            let done = false;
+            try {
+                for await (const sse of iterSSEMessages(response.body)) {
+                    if (done)
+                        continue;
+                    if (sse.data.startsWith('[DONE]')) {
+                        done = true;
+                        continue;
+                    }
+                    if (sse.event === 'error') {
+                        const data = parseEventData(sse);
+                        throw new APIError(undefined, data?.error ?? data, undefined, response.headers);
+                    }
+                    if (sse.data === '')
+                        continue;
+                    const data = parseEventData(sse);
+                    // Errors can also arrive as a data payload: nested `{ error: {...} }` or flat `{ type: "error", ... }`.
+                    if (data && typeof data === 'object' && (data.error || data.type === 'error')) {
+                        throw new APIError(undefined, data.error ?? data, undefined, response.headers);
+                    }
+                    yield data;
+                }
+                done = true;
+            }
+            catch (err) {
+                if (isAbortError(err))
+                    return;
+                throw err;
+            }
+            finally {
+                if (!done)
+                    controller.abort();
+            }
+        }
+        return new Stream(() => iterator()[Symbol.asyncIterator](), controller, response);
+    }
+    /** Re-hydrates a stream produced by {@link Stream.toReadableStream} (newline-delimited JSON). */
+    static fromReadableStream(readable, controller = new AbortController()) {
+        async function* iterator() {
+            const lines = new LineDecoder();
+            for await (const chunk of iterBytes(readable)) {
+                for (const line of lines.decode(chunk))
+                    if (line)
+                        yield JSON.parse(line);
+            }
+            for (const line of lines.flush())
+                if (line)
+                    yield JSON.parse(line);
+        }
+        return new Stream(() => iterator()[Symbol.asyncIterator](), controller);
+    }
+    [Symbol.asyncIterator]() {
+        if (this.consumed)
+            throw new GlexirError('Cannot iterate over a consumed stream; use `.tee()` to split it.');
+        this.consumed = true;
+        return this.iterator();
+    }
+    /** Splits the stream into two independent streams that each see every event. */
+    tee() {
+        const queues = [[], []];
+        let source;
+        const makeIterator = (own) => () => ({
+            next: () => {
+                const queue = queues[own];
+                if (queue.length === 0) {
+                    source ??= this[Symbol.asyncIterator]();
+                    const result = source.next();
+                    queues[0].push(result);
+                    queues[1].push(result);
+                }
+                return queue.shift();
+            },
+        });
+        return [new Stream(makeIterator(0), this.controller, this.response), new Stream(makeIterator(1), this.controller, this.response)];
+    }
+    /** Converts to a byte stream of newline-delimited JSON, e.g. to relay to a browser. */
+    toReadableStream() {
+        const encoder = new TextEncoder();
+        let iter;
+        return new ReadableStream({
+            start: () => {
+                iter = this[Symbol.asyncIterator]();
+            },
+            pull: async (ctrl) => {
+                try {
+                    const { value, done } = await iter.next();
+                    if (done)
+                        return ctrl.close();
+                    ctrl.enqueue(encoder.encode(JSON.stringify(value) + '\n'));
+                }
+                catch (err) {
+                    ctrl.error(err);
+                }
+            },
+            cancel: async () => {
+                await iter.return?.();
+            },
+        });
+    }
+}
+export function isAbortError(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        (('name' in err && err.name === 'AbortError') ||
+            ('message' in err && String(err.message).includes('FetchRequestCanceledException'))));
+}
+//# sourceMappingURL=streaming.js.map

package/dist/core/streaming.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { Glexir, Glexir as default, DEFAULT_BASE_URL, type ClientOptions } from './client.js';
+export { VERSION } from './version.js';
+export { APIPromise, type WithRawResponse } from './core/api-promise.js';
+export { GlexirError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, AuthenticationError, BadRequestError, ConflictError, ContentFilterFinishReasonError, InternalServerError, LengthFinishReasonError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, type APIErrorBody, } from './core/errors.js';
+export { toFile, type Uploadable } from './core/multipart.js';
+export { CursorPage, PagePromise, type CursorPageParams } from './core/pagination.js';
+export type { RequestOptions } from './core/request-options.js';
+export { Stream, type ServerSentEvent } from './core/streaming.js';
+export { ChatCompletionStream } from './lib/chat-completion-stream.js';
+export { ResponseStream } from './lib/response-stream.js';
+export { StrictSchemaError, toStrictJsonSchema } from './lib/strict-schema.js';
+export type { ParsedChatCompletion, ParsedChatCompletionMessage, ParsedFunctionToolCall } from './resources/chat.js';
+export type { ParseOptions, ParsedResponse, ResponseStreamParams, ResponseStreamResumeParams } from './resources/responses.js';
+export { toBatchJSONL } from './resources/batches.js';
+export type * from './types/shared.js';
+export type * from './types/responses.js';
+export type * from './types/conversations.js';
+export type * from './types/chat.js';
+export type * from './types/audio.js';
+export type * from './types/platform.js';

package/dist/index.js

@@ -0,0 +1,12 @@
+export { Glexir, Glexir as default, DEFAULT_BASE_URL } from './client.js';
+export { VERSION } from './version.js';
+export { APIPromise } from './core/api-promise.js';
+export { GlexirError, APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, AuthenticationError, BadRequestError, ConflictError, ContentFilterFinishReasonError, InternalServerError, LengthFinishReasonError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, } from './core/errors.js';
+export { toFile } from './core/multipart.js';
+export { CursorPage, PagePromise } from './core/pagination.js';
+export { Stream } from './core/streaming.js';
+export { ChatCompletionStream } from './lib/chat-completion-stream.js';
+export { ResponseStream } from './lib/response-stream.js';
+export { StrictSchemaError, toStrictJsonSchema } from './lib/strict-schema.js';
+export { toBatchJSONL } from './resources/batches.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAwB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,8BAA8B,EAC9B,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,wBAAwB,GAEzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAmB,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAyB,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAE,MAAM,EAAwB,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAI/E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/chat-completion-stream.d.ts

@@ -0,0 +1,26 @@
+import type { Stream } from '../core/streaming.js';
+import type { ChatCompletion, ChatCompletionChunk } from '../types/chat.js';
+/**
+ * Wraps a Chat Completions SSE stream and accumulates chunks into a `ChatCompletion`,
+ * merging tool-call fragments by `index` (ids and names only arrive on the first fragment).
+ */
+export declare class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {
+    private readonly streamPromise;
+    private base;
+    private readonly choices;
+    private usage;
+    private started;
+    private readonly done;
+    private resolveDone;
+    private rejectDone;
+    private stream;
+    constructor(streamPromise: PromiseLike<Stream<ChatCompletionChunk>>);
+    abort(): void;
+    [Symbol.asyncIterator](): AsyncGenerator<ChatCompletionChunk>;
+    finalChatCompletion(): Promise<ChatCompletion>;
+    /** Content of the first choice once the stream finishes. */
+    finalContent(): Promise<string | null>;
+    /** The completion assembled from the chunks received so far. */
+    snapshot(): ChatCompletion;
+    private accumulate;
+}

package/dist/lib/chat-completion-stream.js

@@ -0,0 +1,161 @@
+import { GlexirError } from '../core/errors.js';
+const MAX_CHOICES = 128;
+const MAX_TOOL_CALLS = 128;
+/**
+ * Wraps a Chat Completions SSE stream and accumulates chunks into a `ChatCompletion`,
+ * merging tool-call fragments by `index` (ids and names only arrive on the first fragment).
+ */
+export class ChatCompletionStream {
+    streamPromise;
+    base;
+    choices = [];
+    usage;
+    started = false;
+    done;
+    resolveDone;
+    rejectDone;
+    stream;
+    constructor(streamPromise) {
+        this.streamPromise = streamPromise;
+        this.done = new Promise((resolve, reject) => {
+            this.resolveDone = resolve;
+            this.rejectDone = reject;
+        });
+        this.done.catch(() => { });
+    }
+    abort() {
+        this.stream?.controller.abort();
+    }
+    async *[Symbol.asyncIterator]() {
+        if (this.started)
+            throw new GlexirError('A ChatCompletionStream can only be iterated once.');
+        this.started = true;
+        try {
+            this.stream = await this.streamPromise;
+            for await (const chunk of this.stream) {
+                this.accumulate(chunk);
+                yield chunk;
+            }
+            this.resolveDone(this.snapshot());
+        }
+        catch (err) {
+            this.rejectDone(err);
+            throw err;
+        }
+    }
+    async finalChatCompletion() {
+        if (!this.started) {
+            for await (const _ of this) {
+                // drain
+            }
+        }
+        return this.done;
+    }
+    /** Content of the first choice once the stream finishes. */
+    async finalContent() {
+        return (await this.finalChatCompletion()).choices[0]?.message.content ?? null;
+    }
+    /** The completion assembled from the chunks received so far. */
+    snapshot() {
+        if (!this.base)
+            throw new GlexirError('No chunks received yet.');
+        return {
+            id: this.base.id,
+            object: 'chat.completion',
+            created: this.base.created,
+            model: this.base.model,
+            ...(this.base.service_tier !== undefined && { service_tier: this.base.service_tier }),
+            ...(this.base.system_fingerprint !== undefined && { system_fingerprint: this.base.system_fingerprint }),
+            ...(this.usage && { usage: this.usage }),
+            choices: this.choices.filter(Boolean).map((choice) => ({
+                index: choice.index,
+                finish_reason: choice.finish_reason ?? 'stop',
+                logprobs: choice.logprobs,
+                message: {
+                    role: 'assistant',
+                    content: choice.content,
+                    refusal: choice.refusal,
+                    ...(choice.tool_calls.length > 0 && {
+                        tool_calls: choice.tool_calls.filter(Boolean).map((tc) => finalizeToolCall(tc, choice.index)),
+                    }),
+                },
+            })),
+        };
+    }
+    accumulate(chunk) {
+        this.base ??= { id: chunk.id, created: chunk.created, model: chunk.model };
+        if (chunk.service_tier !== undefined)
+            this.base.service_tier = chunk.service_tier;
+        if (chunk.system_fingerprint !== undefined)
+            this.base.system_fingerprint = chunk.system_fingerprint;
+        if (chunk.usage)
+            this.usage = chunk.usage;
+        for (const delta of chunk.choices ?? []) {
+            if (!Number.isInteger(delta.index) || delta.index < 0 || delta.index >= MAX_CHOICES) {
+                throw new GlexirError(`Invalid choice index ${delta.index} in stream chunk.`);
+            }
+            const choice = (this.choices[delta.index] ??= {
+                index: delta.index,
+                content: null,
+                refusal: null,
+                tool_calls: [],
+                finish_reason: null,
+                logprobs: null,
+            });
+            // The API may omit finish_reason; treat it as null until a value arrives.
+            if (delta.finish_reason)
+                choice.finish_reason = delta.finish_reason;
+            if (delta.delta?.role)
+                choice.role = delta.delta.role;
+            if (delta.delta?.content)
+                choice.content = (choice.content ?? '') + delta.delta.content;
+            if (delta.delta?.refusal)
+                choice.refusal = (choice.refusal ?? '') + delta.delta.refusal;
+            if (delta.logprobs) {
+                choice.logprobs ??= { content: null, refusal: null };
+                if (delta.logprobs.content)
+                    choice.logprobs.content = [...(choice.logprobs.content ?? []), ...delta.logprobs.content];
+                if (delta.logprobs.refusal)
+                    choice.logprobs.refusal = [...(choice.logprobs.refusal ?? []), ...delta.logprobs.refusal];
+            }
+            for (const fragment of delta.delta?.tool_calls ?? []) {
+                if (!Number.isInteger(fragment.index) || fragment.index < 0 || fragment.index >= MAX_TOOL_CALLS) {
+                    throw new GlexirError(`Invalid tool call index ${fragment.index} in stream chunk.`);
+                }
+                const call = (choice.tool_calls[fragment.index] ??= {});
+                if (fragment.id)
+                    call.id = fragment.id;
+                if (fragment.type)
+                    call.type = fragment.type;
+                if (fragment.function) {
+                    call.type ??= 'function';
+                    const fn = (call.function ??= { name: '', arguments: '' });
+                    if (fragment.function.name)
+                        fn.name = fragment.function.name;
+                    if (fragment.function.arguments)
+                        fn.arguments += fragment.function.arguments;
+                }
+                if (fragment.custom) {
+                    call.type ??= 'custom';
+                    const custom = (call.custom ??= { name: '', input: '' });
+                    if (fragment.custom.name)
+                        custom.name = fragment.custom.name;
+                    if (fragment.custom.input)
+                        custom.input += fragment.custom.input;
+                }
+            }
+        }
+    }
+}
+function finalizeToolCall(call, choiceIndex) {
+    if (!call.id)
+        throw new GlexirError(`Missing id for a tool call in choice ${choiceIndex}.`);
+    if (call.type === 'custom' && call.custom) {
+        return { id: call.id, type: 'custom', custom: { ...call.custom } };
+    }
+    if (call.function) {
+        return { id: call.id, type: 'function', function: { ...call.function } };
+    }
+    throw new GlexirError(`Incomplete tool call ${call.id} in choice ${choiceIndex}.`);
+}
+//# sourceMappingURL=chat-completion-stream.js.map

package/dist/lib/chat-completion-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-completion-stream.js","sourceRoot":"","sources":["../../src/lib/chat-completion-stream.ts"],"names":[],"mappings":"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"}

package/dist/lib/output-text.d.ts

@@ -0,0 +1,4 @@
+import type { Response } from '../types/responses.js';
+/** Concatenates every `output_text` part across assistant messages (the API does not send this field). */
+export declare function computeOutputText(output: Response['output'] | undefined): string;
+export declare function addOutputText<T extends Response>(response: T): T;

package/dist/lib/output-text.js

@@ -0,0 +1,22 @@
+/** Concatenates every `output_text` part across assistant messages (the API does not send this field). */
+export function computeOutputText(output) {
+    const texts = [];
+    for (const item of output ?? []) {
+        if (item.type !== 'message')
+            continue;
+        for (const part of item.content)
+            if (part.type === 'output_text')
+                texts.push(part.text);
+    }
+    return texts.join('');
+}
+export function addOutputText(response) {
+    Object.defineProperty(response, 'output_text', {
+        value: computeOutputText(response.output),
+        enumerable: true,
+        configurable: true,
+        writable: true,
+    });
+    return response;
+}
+//# sourceMappingURL=output-text.js.map

package/dist/lib/output-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-text.js","sourceRoot":"","sources":["../../src/lib/output-text.ts"],"names":[],"mappings":"AAEA,0GAA0G;AAC1G,MAAM,UAAU,iBAAiB,CAAC,MAAsC;IACtE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS;QACtC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,aAAa,CAAqB,QAAW;IAC3D,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE;QAC7C,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzC,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lib/response-stream.d.ts

@@ -0,0 +1,30 @@
+import type { Stream } from '../core/streaming.js';
+import type { Response, ResponseStreamEvent } from '../types/responses.js';
+/**
+ * Wraps a Responses SSE stream. Iterate it for typed events while it accumulates a
+ * snapshot, or just `await stream.finalResponse()`.
+ */
+export declare class ResponseStream implements AsyncIterable<ResponseStreamEvent> {
+    private readonly streamPromise;
+    private snapshot;
+    private final;
+    private text;
+    private started;
+    private readonly done;
+    private resolveDone;
+    private rejectDone;
+    private stream;
+    constructor(streamPromise: PromiseLike<Stream<ResponseStreamEvent>>);
+    /** Text accumulated from `response.output_text.delta` events so far. */
+    get outputText(): string;
+    /** The latest accumulated response snapshot (undefined before `response.created`). */
+    currentResponse(): Response | undefined;
+    /** Stops the stream and cancels the HTTP request. */
+    abort(): void;
+    [Symbol.asyncIterator](): AsyncGenerator<ResponseStreamEvent>;
+    /** Waits for the stream to finish and returns the final response (consuming it if nobody else is). */
+    finalResponse(): Promise<Response>;
+    /** Waits for the stream to finish and returns the concatenated output text. */
+    finalText(): Promise<string>;
+    private accumulate;
+}