flex-race 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aditya Perswal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# flex-race
+
+flex-race lets your app try OpenAI's flex tier with a set wait for it to start. If flex takes too long or fails before it starts, the wrapper sends the request to the default tier. This gives your app a way to use flex while limiting the wait for flex to accept the work. The [wrapper](src/with-flex.ts) adds start_by to responses.create on an OpenAI client.
+
+## Install
+
+The [package](package.json) needs Node.js 20 or later and openai 6 or later. It exports an ES module. Install it and the OpenAI SDK from npm:
+
+```sh
+npm install flex-race openai
+npm install --save-dev tsx
+```
+
+## Usage
+
+Save this TypeScript example as example.ts. It sets start_by to an ISO string with a timezone. The time is 120 seconds from the call.
+
+```ts
+import OpenAI from "openai";
+import { withFlex } from "flex-race";
+
+async function main() {
+  const client = withFlex(new OpenAI(), {
+    onOutcome(outcome) {
+      console.log(outcome);
+    },
+  });
+
+  const response = await client.responses.create({
+    model: "gpt-6-luna",
+    input: "Reply with the single word: ok",
+    start_by: new Date(Date.now() + 120_000).toISOString(),
+  });
+
+  console.log(response.output_text);
+}
+
+main().catch((error: unknown) => {
+  console.error(error);
+  process.exitCode = 1;
+});
+```
+
+Set OPENAI_API_KEY to your key, then run the example:
+
+```sh
+export OPENAI_API_KEY="your-api-key"
+npx tsx example.ts
+```
+
+For a stream, set stream to true in the request. Use for await to read the returned stream. The wrapper returns the flex events it read while waiting before it returns the rest of the events. Without start_by, the wrapper passes the request to the client and does not call onOutcome. Other client methods stay in place, including responses.retrieve. The [wrapper](src/with-flex.ts) returns a plain Promise from responses.create.
+
+## How the wait works
+
+start_by sets the time by which flex must admit the request. Admission means the wrapper has read an event after response.in_progress without a thrown error or a response.failed event. On gpt-4o, the live check saw response.in_progress followed by invalid_request_error. This is why [the race](src/race.ts) waits for the next event before it counts admission.
+
+The wrapper uses a stream for every flex attempt, even when your app asks for a full response. It counts the time spent opening the stream as part of the wait. Once flex admits the request, the timer stops. For a full response, the wrapper then reads until response.completed or response.incomplete. start_by does not set a time by which the response must finish. The default request can also run past start_by. See [the race](src/race.ts) and [the wrapper](src/with-flex.ts).
+
+The [time parser](src/start-by.ts) requires an ISO 8601 string with seconds and Z or a timezone offset such as +05:00. Bad dates, strings with no timezone, Date objects, and numbers cause StartByError before any request. Passing start_by with a non-null service_tier also causes StartByError.
+
+The wrapper skips flex when less than 5 seconds remain, including when start_by has passed. It caps the wait at 10 minutes when start_by is farther away. These are local code limits set by MIN_LEAD_MS and MAX_WINDOW_MS in [the time parser](src/start-by.ts). The clock defaults to Date.now. The now option lets tests supply a clock.
+
+## Fallback and errors
+
+If the wait ends before admission, the wrapper aborts the flex attempt and starts a default request. It does the same if flex throws an error, sends response.failed, or ends the stream before admission. The wrapper tries any model on flex when enough time remains. It keeps no list of models with a flex tier. A model with no flex tier thus adds a flex attempt before the default request. See [the fallback code](src/with-flex.ts).
+
+After admission, a full response and a stream have different failure rules. For a full response, the wrapper starts a default request if flex sends response.failed or ends without a final response. It also retries thrown errors on the default tier unless the error has type invalid_request_error or the caller has aborted. For a stream, it passes later events and errors to the caller without starting a default request. The [wrapper](src/with-flex.ts) passes errors from the default request to the caller.
+
+Your app supplies the OpenAI client and its credentials. The wrapper adds no access checks or stored records. It removes start_by before sending the body to OpenAI. For flex, it sets service_tier to flex, stream to true, and maxRetries to 0. For fallback, it sets service_tier to default and keeps the caller's stream choice and request options. The caller's abort signal also aborts the flex attempt. An abort during the wait ends the call without fallback. See [the request and abort code](src/with-flex.ts).
+
+## Outcomes
+
+The onOutcome option receives a FlexOutcome with tier, reason, waitedMs, and capped. tier is flex or default. capped is true when the wrapper cut the wait to MAX_WINDOW_MS. waitedMs counts from the call to the report. For a flex stream, the report comes at admission. For a full flex response, it comes after the final response. A report for the default tier comes before that request finishes, so it does not prove that the request passed. See [the outcome code](src/with-flex.ts).
+
+The reason is admitted when the wrapper uses flex. It is deadline_too_near when the wrapper skips flex, or deadline_elapsed when the wait runs out. It is flex_refused when flex fails before admission. It is flex_failed_after_admission when a full response fails after admission and the wrapper starts a default request. Calls without start_by, bad input, and errors that end the call before a tier report do not call onOutcome. The [public exports](src/index.ts) include the outcome types and StartByError.
+
+## Tests and live results
+
+Run the unit tests from this repo:
+
+```sh
+pnpm test
+```
+
+The [time tests](src/start-by.test.ts) check valid times, bad input, and the wait cap. The [wrapper tests](src/with-flex.test.ts) check admission, event order, fallback, errors, and aborts. They use a simulated clock to check that the wrapper aborts a waiting flex attempt when start_by passes. The confirmed run on 2026-09-26 passed 57 unit tests and covered every source line.
+
+The live tests read OPENAI_API_KEY from a local .env file through the [live test config](vitest.live.config.ts). Add your key to that file:
+
+```dotenv
+OPENAI_API_KEY=your-api-key
+```
+
+Then run:
+
+```sh
+pnpm test:live
+```
+
+The [live tests](test/openai.live.test.ts) skip when no key is set. They call the live OpenAI API. They check full responses, streams, fallback for a model with no flex tier, and a start_by too near to try flex. For full responses and streams, they check that the served tier matches onOutcome. The confirmed run on 2026-09-26 passed all 4 live tests.
+
+Separate checks on 2026-09-26 installed the packed tarball in another project and called the live OpenAI API. With start_by 120 seconds ahead, gpt-6-luna returned a full response on flex with reason admitted and waitedMs 990. A gpt-6-sol stream used flex with reason admitted and waitedMs 647. That stream had 9 events. A gpt-4o request used the default tier with reason flex_refused and waitedMs 638.
+
+Those checks also saw deadline_too_near on the default tier with start_by 2 seconds ahead. A call without start_by passed through with no onOutcome call. A start_by with no timezone threw StartByError before any request. responses.retrieve also worked through the wrapper.
+
+The path where start_by passes while flex still waits has not been seen live. Live flex admissions took about one second. The simulated clock tests cover that path. These measured times do not set a speed target or a guarantee. A live check also saw gpt-6-astra served on flex. What OpenAI bills for that request is unknown because its pricing page listed no flex price.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { withFlex } from "./with-flex.js";
+export type { FlexClient, FlexOutcome, FlexReason, FlexResponses, WithFlexOptions, WithStartBy, } from "./with-flex.js";
+export { MAX_WINDOW_MS, MIN_LEAD_MS, StartByError } from "./start-by.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { withFlex } from "./with-flex.js";
+export { MAX_WINDOW_MS, MIN_LEAD_MS, StartByError } from "./start-by.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,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAS1C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/race.d.ts

@@ -0,0 +1,17 @@
+export declare const IN_PROGRESS_EVENT = "response.in_progress";
+export type RaceResult<Event> = {
+    readonly kind: "admitted";
+    readonly buffered: readonly Event[];
+    readonly rest: AsyncIterator<Event>;
+} | {
+    readonly kind: "elapsed";
+} | {
+    readonly kind: "refused";
+    readonly cause: unknown;
+};
+interface TypedEvent {
+    readonly type: string;
+}
+export declare function raceForAdmission<Event extends TypedEvent>(open: () => Promise<AsyncIterable<Event>>, msLeft: number): Promise<RaceResult<Event>>;
+export {};
+//# sourceMappingURL=race.d.ts.map

package/dist/race.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.d.ts","sourceRoot":"","sources":["../src/race.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,MAAM,MAAM,UAAU,CAAC,KAAK,IAGxB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,KAAK,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;CAAE,GAEvG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAI5B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1D,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD,wBAAsB,gBAAgB,CAAC,KAAK,SAAS,UAAU,EAC7D,IAAI,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EACzC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAgC5B"}

package/dist/race.js

@@ -0,0 +1,66 @@
+// Wait for the flex attempt to be admitted, or give up on it.
+//
+// OpenAI streams `response.created` as soon as it accepts a flex request, then `response.in_progress`
+// once flex capacity picks the request up. `response.in_progress` alone is not proof of admission: on a
+// model with no flex tier (gpt-4o, seen live on 2026-09-26) OpenAI sends it and then an
+// `invalid_request_error` straight after. So the request counts as admitted at the first event AFTER
+// `response.in_progress` that is not a failure. On a real admission that event follows at once and
+// still comes before the first output token, so the deadline measures time to admission, not time to
+// first token.
+export const IN_PROGRESS_EVENT = "response.in_progress";
+const ELAPSED = Symbol("elapsed");
+// `open` starts the flex request. It runs inside the deadline, so a slow connection counts against
+// start_by the same way a slow queue does.
+export async function raceForAdmission(open, msLeft) {
+    const timer = deadline(msLeft);
+    try {
+        const opened = open();
+        const stream = await Promise.race([opened, timer.elapsed]);
+        if (stream === ELAPSED) {
+            opened.catch(() => undefined); // the caller aborts it; swallow the rejection that follows
+            return { kind: "elapsed" };
+        }
+        const iterator = stream[Symbol.asyncIterator]();
+        const buffered = [];
+        let inProgress = false;
+        for (;;) {
+            const next = iterator.next();
+            const step = await Promise.race([next, timer.elapsed]);
+            if (step === ELAPSED) {
+                next.catch(() => undefined);
+                return { kind: "elapsed" };
+            }
+            if (step.done === true) {
+                return { kind: "refused", cause: new Error("flex stream ended before admission") };
+            }
+            buffered.push(step.value);
+            if (step.value.type === "response.failed")
+                return { kind: "refused", cause: step.value };
+            if (inProgress)
+                return { kind: "admitted", buffered, rest: iterator };
+            if (step.value.type === IN_PROGRESS_EVENT)
+                inProgress = true;
+        }
+    }
+    catch (cause) {
+        return { kind: "refused", cause };
+    }
+    finally {
+        timer.cancel();
+    }
+}
+function deadline(ms) {
+    let id;
+    const elapsed = new Promise((resolve) => {
+        id = setTimeout(() => {
+            resolve(ELAPSED);
+        }, Math.max(0, ms));
+    });
+    return {
+        elapsed,
+        cancel: () => {
+            clearTimeout(id);
+        },
+    };
+}
+//# sourceMappingURL=race.js.map

package/dist/race.js.map

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

package/dist/start-by.d.ts

@@ -0,0 +1,11 @@
+export interface Deadline {
+    readonly msLeft: number;
+    readonly capped: boolean;
+}
+export declare const MIN_LEAD_MS = 5000;
+export declare const MAX_WINDOW_MS = 600000;
+export declare class StartByError extends Error {
+    readonly name = "StartByError";
+}
+export declare function parseStartBy(value: unknown, nowMs: number): Deadline;
+//# sourceMappingURL=start-by.d.ts.map

package/dist/start-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-by.d.ts","sourceRoot":"","sources":["../src/start-by.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IAGvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAGD,eAAO,MAAM,WAAW,OAAQ,CAAC;AAEjC,eAAO,MAAM,aAAa,SAAU,CAAC;AAErC,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAkB,IAAI,kBAAkB;CACzC;AAOD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAKpE"}

package/dist/start-by.js

@@ -0,0 +1,68 @@
+// `start_by`: the instant by which OpenAI's flex tier must have admitted the request. It is the only
+// input this library adds to a Responses call, and it accepts exactly one shape: an ISO 8601 date-time
+// with seconds and an explicit timezone (`Z` or `+hh:mm` / `-hh:mm`). A string without a timezone means
+// different instants on different servers, and a Date or a bare number invites "30 means 30 seconds",
+// so both are refused rather than guessed at.
+// Less time than this is not worth a flex attempt: the request goes straight to the default tier.
+export const MIN_LEAD_MS = 5_000;
+// The longest a flex attempt waits for admission, however far away start_by is.
+export const MAX_WINDOW_MS = 600_000;
+export class StartByError extends Error {
+    name = "StartByError";
+}
+const ISO_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?(?:(Z)|([+-])(\d{2}):(\d{2}))$/;
+// Parse start_by and measure it against `nowMs`. Throws StartByError on anything that is not a valid,
+// timezone-qualified ISO 8601 date-time.
+export function parseStartBy(value, nowMs) {
+    const targetMs = instantOf(value);
+    const msLeft = targetMs - nowMs;
+    if (msLeft > MAX_WINDOW_MS)
+        return { msLeft: MAX_WINDOW_MS, capped: true };
+    return { msLeft, capped: false };
+}
+function instantOf(value) {
+    if (typeof value !== "string") {
+        throw new StartByError(`start_by must be an ISO 8601 string with a timezone, such as "2026-09-25T18:00:00Z"; got ${describe(value)}`);
+    }
+    const match = ISO_DATE_TIME.exec(value);
+    if (match === null) {
+        throw new StartByError(`start_by must be an ISO 8601 date-time with seconds and a timezone ("Z" or "+hh:mm"), such as ` +
+            `"2026-09-25T18:00:00Z"; got ${JSON.stringify(value)}`);
+    }
+    const [, y, mo, d, h, mi, s, fraction, zulu, sign, offH, offM] = match;
+    const year = Number(y);
+    const month = Number(mo);
+    const day = Number(d);
+    const hour = Number(h);
+    const minute = Number(mi);
+    const second = Number(s);
+    const millis = fraction === undefined ? 0 : Number(fraction.slice(0, 3).padEnd(3, "0"));
+    const utcOfFields = Date.UTC(year, month - 1, day, hour, minute, second, millis);
+    const roundTrip = new Date(utcOfFields);
+    const fieldsValid = hour < 24 &&
+        minute < 60 &&
+        second < 60 &&
+        roundTrip.getUTCFullYear() === year &&
+        roundTrip.getUTCMonth() === month - 1 &&
+        roundTrip.getUTCDate() === day;
+    if (!fieldsValid)
+        throw new StartByError(`start_by is not a real date and time: ${JSON.stringify(value)}`);
+    if (zulu !== undefined)
+        return utcOfFields;
+    const offsetHours = Number(offH);
+    const offsetMinutes = Number(offM);
+    if (offsetHours > 23 || offsetMinutes > 59) {
+        throw new StartByError(`start_by has an impossible timezone offset: ${JSON.stringify(value)}`);
+    }
+    const offsetMs = (offsetHours * 60 + offsetMinutes) * 60_000;
+    // A local time at +05:00 is five hours AHEAD of UTC, so the UTC instant is the fields minus the offset.
+    return sign === "+" ? utcOfFields - offsetMs : utcOfFields + offsetMs;
+}
+function describe(value) {
+    if (value instanceof Date)
+        return "a Date object";
+    if (value === null)
+        return "null";
+    return typeof value;
+}
+//# sourceMappingURL=start-by.js.map

package/dist/start-by.js.map

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

package/dist/with-flex.d.ts

@@ -0,0 +1,28 @@
+import type OpenAI from "openai";
+import { Stream } from "openai/streaming";
+import type { Response, ResponseCreateParamsNonStreaming, ResponseCreateParamsStreaming, ResponseStreamEvent } from "openai/resources/responses/responses";
+export type FlexReason = "admitted" | "deadline_too_near" | "deadline_elapsed" | "flex_refused" | "flex_failed_after_admission";
+export interface FlexOutcome {
+    readonly tier: "flex" | "default";
+    readonly reason: FlexReason;
+    readonly waitedMs: number;
+    readonly capped: boolean;
+}
+export interface WithFlexOptions {
+    readonly onOutcome?: (outcome: FlexOutcome) => void;
+    readonly now?: () => number;
+}
+type RequestOptions = NonNullable<Parameters<OpenAI["responses"]["create"]>[1]>;
+export type WithStartBy<Params> = Params & {
+    readonly start_by?: string;
+};
+export interface FlexResponses {
+    create(body: WithStartBy<ResponseCreateParamsNonStreaming>, options?: RequestOptions): Promise<Response>;
+    create(body: WithStartBy<ResponseCreateParamsStreaming>, options?: RequestOptions): Promise<Stream<ResponseStreamEvent>>;
+}
+export type FlexClient = Omit<OpenAI, "responses"> & {
+    readonly responses: Omit<OpenAI["responses"], "create"> & FlexResponses;
+};
+export declare function withFlex(client: OpenAI, options?: WithFlexOptions): FlexClient;
+export {};
+//# sourceMappingURL=with-flex.d.ts.map

package/dist/with-flex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-flex.d.ts","sourceRoot":"","sources":["../src/with-flex.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,EACV,QAAQ,EACR,gCAAgC,EAChC,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,sCAAsC,CAAC;AAK9C,MAAM,MAAM,UAAU,GAElB,UAAU,GAEV,mBAAmB,GAEnB,kBAAkB,GAGlB,cAAc,GAGd,6BAA6B,CAAC;AAElC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAEpD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,KAAK,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhF,MAAM,MAAM,WAAW,CAAC,MAAM,IAAI,MAAM,GAAG;IAEzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,gCAAgC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzG,MAAM,CACJ,IAAI,EAAE,WAAW,CAAC,6BAA6B,CAAC,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG;IACnD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,GAAG,aAAa,CAAC;CACzE,CAAC;AAMF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,UAAU,CAgBlF"}

package/dist/with-flex.js

@@ -0,0 +1,140 @@
+// withFlex wraps an OpenAI client so `responses.create` accepts one extra field, `start_by`. With it,
+// the request first goes to OpenAI's flex tier (roughly half the price) and waits for flex to admit it.
+// If flex admits it by start_by, the caller gets the flex response. If start_by passes first, or flex
+// refuses or fails before admitting it, the flex attempt is aborted and the request runs on the default
+// tier instead. Without start_by the call passes through untouched.
+//
+// There is no model list: any model is tried on flex, and a model OpenAI will not serve on flex simply
+// falls back. The cost is one extra round trip on such models, and only when start_by is set.
+import { Stream } from "openai/streaming";
+import { raceForAdmission } from "./race.js";
+import { MIN_LEAD_MS, StartByError, parseStartBy } from "./start-by.js";
+export function withFlex(client, options = {}) {
+    const responses = client.responses;
+    const rawCreate = responses.create.bind(responses);
+    const create = makeCreate(rawCreate, options);
+    const flexResponses = new Proxy(responses, {
+        get(target, property, receiver) {
+            if (property === "create")
+                return create;
+            return Reflect.get(target, property, receiver);
+        },
+    });
+    return new Proxy(client, {
+        get(target, property, receiver) {
+            if (property === "responses")
+                return flexResponses;
+            return Reflect.get(target, property, receiver);
+        },
+    });
+}
+function makeCreate(rawCreate, options) {
+    const now = options.now ?? Date.now;
+    const report = (outcome) => options.onOutcome?.(outcome);
+    async function create(body, requestOptions) {
+        const { start_by: startBy, ...params } = body;
+        if (startBy === undefined)
+            return rawCreate(params, requestOptions);
+        if (params.service_tier !== undefined && params.service_tier !== null) {
+            throw new StartByError("start_by chooses the service tier; do not also pass service_tier");
+        }
+        const startedAt = now();
+        const { msLeft, capped } = parseStartBy(startBy, startedAt);
+        const decided = (tier, reason) => {
+            report({ tier, reason, waitedMs: now() - startedAt, capped });
+        };
+        const runDefault = () => rawCreate({ ...params, service_tier: "default" }, requestOptions);
+        if (msLeft < MIN_LEAD_MS) {
+            decided("default", "deadline_too_near");
+            return runDefault();
+        }
+        const callerSignal = requestOptions?.signal ?? undefined;
+        const flex = linkedController(callerSignal);
+        const flexOptions = { ...requestOptions, signal: flex.signal, maxRetries: 0 };
+        const result = await raceForAdmission(() => rawCreate({ ...params, stream: true, service_tier: "flex" }, flexOptions), msLeft);
+        if (result.kind !== "admitted") {
+            flex.abort();
+            if (callerSignal?.aborted === true)
+                throw callerAbort(callerSignal);
+            decided("default", result.kind === "elapsed" ? "deadline_elapsed" : "flex_refused");
+            return runDefault();
+        }
+        if (params.stream === true) {
+            decided("flex", "admitted");
+            return new Stream(() => replay(result.buffered, result.rest), flex);
+        }
+        // The admitting event can itself be the final one, so the buffered head is read too.
+        const final = await finalResponseOf(replay(result.buffered, result.rest), callerSignal);
+        if (final.kind === "response") {
+            decided("flex", "admitted");
+            return final.response;
+        }
+        flex.abort();
+        if (!final.retryable)
+            throw final.cause;
+        decided("default", "flex_failed_after_admission");
+        return runDefault();
+    }
+    return create;
+}
+// Drain an admitted flex stream for a non-streaming caller and keep only the finished response.
+async function finalResponseOf(rest, callerSignal) {
+    try {
+        for (;;) {
+            const step = await rest.next();
+            if (step.done === true) {
+                return {
+                    kind: "failed",
+                    cause: new Error("flex stream ended without a final response"),
+                    retryable: true,
+                };
+            }
+            const event = step.value;
+            if (event.type === "response.completed" || event.type === "response.incomplete") {
+                return { kind: "response", response: event.response };
+            }
+            // A failed flex response after admission is a capacity or server fault on OpenAI's side; the
+            // same request can still succeed on the default tier.
+            if (event.type === "response.failed")
+                return { kind: "failed", cause: event, retryable: true };
+        }
+    }
+    catch (cause) {
+        if (callerSignal?.aborted === true)
+            throw cause;
+        return { kind: "failed", cause, retryable: !isInvalidRequest(cause) };
+    }
+}
+// An invalid request fails the same way on every tier, so it is thrown rather than re-run.
+function isInvalidRequest(error) {
+    if (typeof error !== "object" || error === null)
+        return false;
+    const type = error.type;
+    return type === "invalid_request_error";
+}
+async function* replay(buffered, rest) {
+    yield* buffered;
+    for (;;) {
+        const step = await rest.next();
+        if (step.done === true)
+            return;
+        yield step.value;
+    }
+}
+function linkedController(parent) {
+    const controller = new AbortController();
+    if (parent === undefined)
+        return controller;
+    if (parent.aborted)
+        controller.abort(parent.reason);
+    else {
+        parent.addEventListener("abort", () => {
+            controller.abort(parent.reason);
+        }, { once: true });
+    }
+    return controller;
+}
+function callerAbort(signal) {
+    return signal.reason ?? new Error("request aborted by caller");
+}
+//# sourceMappingURL=with-flex.js.map

package/dist/with-flex.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "flex-race",
+  "version": "0.1.0",
+  "description": "Race OpenAI's flex tier against a deadline on the Responses API, falling back to the default tier.",
+  "license": "MIT",
+  "author": "Aditya Perswal",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aperswal/flex-race.git"
+  },
+  "homepage": "https://github.com/aperswal/flex-race#readme",
+  "bugs": {
+    "url": "https://github.com/aperswal/flex-race/issues"
+  },
+  "keywords": [
+    "openai",
+    "flex",
+    "service_tier",
+    "responses",
+    "deadline"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint --max-warnings=0 .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:live": "vitest run --config vitest.live.config.ts",
+    "verify": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm build",
+    "prepare": "husky"
+  },
+  "peerDependencies": {
+    "openai": ">=6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.6.3",
+    "@vitest/coverage-v8": "^5.0.2",
+    "eslint": "^10.11.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.5.1",
+    "openai": "^7.23.0",
+    "prettier": "^3.9.9",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.70.1",
+    "vitest": "^5.0.2"
+  }
+}