@nervekit/orchestrator 0.1.0

package/dist/domains/transcription/transcription.service.js

@@ -0,0 +1,128 @@
+import { randomUUID } from "node:crypto";
+import { AUDIO_TRANSCRIPTION_MAX_DURATION_MS, audioTranscriptionResponseSchema, } from "@nervekit/shared";
+import { HttpError } from "../../http/errors.js";
+const CHATGPT_TRANSCRIBE_URL = "https://chatgpt.com/backend-api/transcribe";
+const OPENAI_CODEX_PROVIDER = "openai-codex";
+const DEFAULT_TRANSCRIBE_MODEL = "gpt-4o-transcribe";
+const MAX_AUDIO_BYTES = 25 * 1024 * 1024;
+const USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
+export function normalizeAudioMimeType(mimeType) {
+    const normalized = (mimeType ?? "").split(";")[0]?.trim().toLowerCase();
+    switch (normalized) {
+        case "audio/webm":
+            return { mimeType: "audio/webm", extension: "webm" };
+        case "audio/mp4":
+        case "audio/m4a":
+        case "audio/x-m4a":
+            return { mimeType: "audio/mp4", extension: "mp4" };
+        case "audio/wav":
+        case "audio/wave":
+        case "audio/x-wav":
+            return { mimeType: "audio/wav", extension: "wav" };
+        case "audio/mpeg":
+        case "audio/x-mpeg":
+            return { mimeType: "audio/mpeg", extension: "mp3" };
+        case "audio/mp3":
+            return { mimeType: "audio/mp3", extension: "mp3" };
+        case "audio/mpga":
+            return { mimeType: "audio/mpga", extension: "mpga" };
+        case "audio/ogg":
+        case "audio/oga":
+            return { mimeType: "audio/ogg", extension: "ogg" };
+        case "audio/flac":
+        case "audio/x-flac":
+            return { mimeType: "audio/flac", extension: "flac" };
+        default:
+            return undefined;
+    }
+}
+export function chatGptAccountIdFromAccessToken(accessToken) {
+    const payload = accessToken.split(".")[1];
+    if (!payload)
+        return undefined;
+    try {
+        const json = Buffer.from(payload, "base64url").toString("utf8");
+        const claims = JSON.parse(json);
+        const accountId = claims["https://api.openai.com/auth"]?.chatgpt_account_id;
+        return typeof accountId === "string" && accountId ? accountId : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function estimateDurationMs(sizeBytes) {
+    return Math.max(1, Math.round((sizeBytes * 1000) / 50_000));
+}
+export async function transcribeAudioWithChatGptSubscription(auth, input) {
+    if (input.data.byteLength === 0) {
+        throw new HttpError(400, "EMPTY_AUDIO", "Audio upload is empty.");
+    }
+    if (input.data.byteLength > MAX_AUDIO_BYTES) {
+        throw new HttpError(413, "AUDIO_TOO_LARGE", "Audio upload is larger than the 25 MB transcription limit.");
+    }
+    const normalized = normalizeAudioMimeType(input.mimeType);
+    if (!normalized) {
+        throw new HttpError(400, "UNSUPPORTED_AUDIO_TYPE", `Unsupported audio MIME type: ${input.mimeType || "unknown"}.`);
+    }
+    const credential = await auth.getCredential(OPENAI_CODEX_PROVIDER);
+    if (credential?.type !== "oauth") {
+        throw new HttpError(401, "CHATGPT_SUBSCRIPTION_AUTH_REQUIRED", "ChatGPT audio input is not configured. Connect the OpenAI Codex OAuth provider first.");
+    }
+    const accessToken = await auth.getApiKey(OPENAI_CODEX_PROVIDER);
+    if (!accessToken) {
+        throw new HttpError(401, "CHATGPT_SUBSCRIPTION_AUTH_REQUIRED", "ChatGPT audio input is not configured. Connect the OpenAI Codex OAuth provider first.");
+    }
+    const accountId = chatGptAccountIdFromAccessToken(accessToken);
+    if (!accountId) {
+        throw new HttpError(401, "CHATGPT_ACCOUNT_ID_MISSING", "Could not determine the ChatGPT account id from the stored OAuth access token. Reconnect OpenAI Codex auth.");
+    }
+    const durationMs = input.durationMs ?? estimateDurationMs(input.data.byteLength);
+    if (durationMs > AUDIO_TRANSCRIPTION_MAX_DURATION_MS) {
+        throw new HttpError(413, "AUDIO_DURATION_TOO_LONG", "Audio recordings are limited to 8 minutes.");
+    }
+    const audioBuffer = new ArrayBuffer(input.data.byteLength);
+    new Uint8Array(audioBuffer).set(input.data);
+    const file = new Blob([audioBuffer], { type: normalized.mimeType });
+    const form = new FormData();
+    form.append("file", file, `whisper.${normalized.extension}`);
+    form.append("duration_ms", String(Math.max(1, Math.round(durationMs))));
+    form.append("model", DEFAULT_TRANSCRIBE_MODEL);
+    const response = await fetch(CHATGPT_TRANSCRIBE_URL, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            "User-Agent": USER_AGENT,
+            Accept: "*/*",
+            "Accept-Language": "en-US,en;q=0.9",
+            Origin: "https://chatgpt.com",
+            Referer: "https://chatgpt.com/",
+            "oai-language": "en-US",
+            "oai-device-id": randomUUID(),
+            "chatgpt-account-id": accountId,
+            "sec-ch-ua": '"Chromium";v="131", "Not(A:Brand";v="24"',
+            "sec-ch-ua-mobile": "?0",
+            "sec-ch-ua-platform": '"Linux"',
+            "sec-fetch-dest": "empty",
+            "sec-fetch-mode": "cors",
+            "sec-fetch-site": "same-origin",
+        },
+        body: form,
+    });
+    if (response.status === 401) {
+        throw new HttpError(401, "CHATGPT_SUBSCRIPTION_AUTH_REJECTED", "ChatGPT rejected the stored OAuth token. Reconnect OpenAI Codex auth.");
+    }
+    if (response.status === 429) {
+        throw new HttpError(429, "TRANSCRIPTION_RATE_LIMITED", "ChatGPT transcription is rate limited. Try again shortly.");
+    }
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new HttpError(response.status, "TRANSCRIPTION_FAILED", `ChatGPT transcription failed (${response.status}): ${body || response.statusText}`);
+    }
+    const parsed = audioTranscriptionResponseSchema.parse(await response.json());
+    const text = parsed.text.trim();
+    if (!text) {
+        throw new HttpError(502, "EMPTY_TRANSCRIPTION", "ChatGPT returned an empty transcription.");
+    }
+    return { text };
+}
+//# sourceMappingURL=transcription.service.js.map

package/dist/domains/transcription/transcription.service.js.map

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

package/dist/domains/usage/anthropic-client.d.ts

@@ -0,0 +1,9 @@
+import type { SubscriptionUsage } from "@nervekit/shared";
+export declare function parseAnthropicUsageResponse(raw: string): SubscriptionUsage | null;
+/**
+ * Fetch Anthropic subscription usage (5h session + 7d weekly) using an OAuth
+ * bearer token. Memoized for {@link CACHE_MAX_AGE_MS} with rate-limit backoff;
+ * the last good snapshot is served on transient failures.
+ */
+export declare function fetchAnthropicUsage(token: string, cacheDir: string): Promise<SubscriptionUsage | null>;
+//# sourceMappingURL=anthropic-client.d.ts.map

package/dist/domains/usage/anthropic-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-client.d.ts","sourceRoot":"","sources":["../../../src/domains/usage/anthropic-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,kBAAkB,CAAC;AA4H9E,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GACV,iBAAiB,GAAG,IAAI,CAqB1B;AAqCD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAiEnC"}

package/dist/domains/usage/anthropic-client.js

@@ -0,0 +1,207 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const API_HOST = "api.anthropic.com";
+const API_PATH = "/api/oauth/usage";
+const API_URL = `https://${API_HOST}${API_PATH}`;
+const API_TIMEOUT_MS = 5000;
+const CACHE_MAX_AGE_MS = 30_000;
+const LOCK_MAX_AGE_MS = 10_000;
+const DEFAULT_RATE_LIMIT_BACKOFF_MS = 30_000;
+let cache = null;
+function cacheFile(cacheDir) {
+    return join(cacheDir, "anthropic-usage.json");
+}
+async function readCacheFile(cacheDir) {
+    const path = cacheFile(cacheDir);
+    try {
+        const raw = await readFile(path, "utf8");
+        return {
+            data: JSON.parse(raw),
+            time: (await stat(path)).mtimeMs,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCacheFile(cacheDir, data) {
+    try {
+        await mkdir(cacheDir, { recursive: true });
+        await writeFile(cacheFile(cacheDir), JSON.stringify(data), "utf8");
+    }
+    catch {
+        // best-effort cache
+    }
+}
+function lockFile(cacheDir) {
+    return join(cacheDir, "anthropic-usage.lock");
+}
+async function readLock(cacheDir, nowMs) {
+    const path = lockFile(cacheDir);
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        const blockedUntil = Number(parsed.blockedUntil);
+        return Number.isFinite(blockedUntil) && blockedUntil > nowMs
+            ? blockedUntil
+            : null;
+    }
+    catch {
+        try {
+            const blockedUntil = (await stat(path)).mtimeMs + LOCK_MAX_AGE_MS;
+            return blockedUntil > nowMs ? blockedUntil : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function writeLock(cacheDir, blockedUntil) {
+    try {
+        await mkdir(cacheDir, { recursive: true });
+        await writeFile(lockFile(cacheDir), JSON.stringify({ blockedUntil }), "utf8");
+    }
+    catch {
+        // best-effort cross-process backoff
+    }
+}
+function parseRetryAfterMs(header, nowMs) {
+    const trimmed = header?.trim();
+    if (!trimmed)
+        return null;
+    if (/^\d+$/.test(trimmed)) {
+        const s = Number.parseInt(trimmed, 10);
+        return s > 0 ? s * 1000 : null;
+    }
+    const ms = Date.parse(trimmed);
+    if (Number.isNaN(ms))
+        return null;
+    return ms > nowMs ? ms - nowMs : null;
+}
+function toWindow(raw) {
+    if (!raw)
+        return null;
+    const usedPercent = raw.utilization != null ? Number(raw.utilization) : null;
+    const resetsAt = typeof raw.resets_at === "string" ? raw.resets_at : null;
+    if (usedPercent == null && resetsAt == null)
+        return null;
+    return {
+        usedPercent: usedPercent != null && Number.isFinite(usedPercent) ? usedPercent : null,
+        resetsAt,
+        resetAfterSeconds: null,
+        windowMinutes: null,
+    };
+}
+export function parseAnthropicUsageResponse(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const obj = parsed;
+    const session = toWindow(obj.five_hour);
+    const weekly = toWindow(obj.seven_day);
+    if (!session && !weekly)
+        return null;
+    return {
+        provider: "anthropic",
+        session,
+        weekly,
+        planType: null,
+        updatedAt: new Date().toISOString(),
+    };
+}
+async function fetchApi(token) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+    try {
+        const res = await fetch(API_URL, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "anthropic-beta": "oauth-2025-04-20",
+            },
+            signal: controller.signal,
+        });
+        if (res.ok)
+            return { kind: "success", body: await res.text() };
+        if (res.status === 429) {
+            return {
+                kind: "rate-limited",
+                retryAfterMs: parseRetryAfterMs(res.headers.get("retry-after"), Date.now()) ??
+                    DEFAULT_RATE_LIMIT_BACKOFF_MS,
+            };
+        }
+        return { kind: "error" };
+    }
+    catch {
+        return { kind: "error" };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Fetch Anthropic subscription usage (5h session + 7d weekly) using an OAuth
+ * bearer token. Memoized for {@link CACHE_MAX_AGE_MS} with rate-limit backoff;
+ * the last good snapshot is served on transient failures.
+ */
+export async function fetchAnthropicUsage(token, cacheDir) {
+    const now = Date.now();
+    if (cache &&
+        now - cache.time < CACHE_MAX_AGE_MS &&
+        cache.blockedUntil <= now) {
+        return cache.data;
+    }
+    const fileCache = await readCacheFile(cacheDir);
+    if (fileCache?.data && now - fileCache.time < CACHE_MAX_AGE_MS) {
+        cache = { data: fileCache.data, time: fileCache.time, blockedUntil: 0 };
+        return fileCache.data;
+    }
+    const lastKnown = cache?.data ?? fileCache?.data ?? null;
+    if (cache && cache.blockedUntil > now) {
+        return lastKnown;
+    }
+    const lockedUntil = await readLock(cacheDir, now);
+    if (lockedUntil) {
+        cache = { data: lastKnown, time: now, blockedUntil: lockedUntil };
+        return lastKnown;
+    }
+    await writeLock(cacheDir, now + LOCK_MAX_AGE_MS);
+    const resp = await fetchApi(token);
+    if (resp.kind === "rate-limited") {
+        await writeLock(cacheDir, now + resp.retryAfterMs);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + resp.retryAfterMs,
+        };
+        return lastKnown;
+    }
+    if (resp.kind === "error") {
+        await writeLock(cacheDir, now + DEFAULT_RATE_LIMIT_BACKOFF_MS);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + DEFAULT_RATE_LIMIT_BACKOFF_MS,
+        };
+        return lastKnown;
+    }
+    const data = parseAnthropicUsageResponse(resp.body);
+    if (!data) {
+        await writeLock(cacheDir, now + DEFAULT_RATE_LIMIT_BACKOFF_MS);
+        cache = {
+            data: lastKnown,
+            time: now,
+            blockedUntil: now + DEFAULT_RATE_LIMIT_BACKOFF_MS,
+        };
+        return lastKnown;
+    }
+    cache = { data, time: now, blockedUntil: 0 };
+    await writeCacheFile(cacheDir, data);
+    return data;
+}
+//# sourceMappingURL=anthropic-client.js.map

package/dist/domains/usage/anthropic-client.js.map

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

package/dist/domains/usage/codex-client.d.ts

@@ -0,0 +1,18 @@
+import type { SubscriptionUsage } from "@nervekit/shared";
+type HeaderLike = Record<string, string | number | boolean | null | undefined>;
+/** Parse a Codex usage JSON payload into a normalized snapshot. */
+export declare function parseCodexUsageResponse(payload: unknown, nowMs?: number): SubscriptionUsage | null;
+/** Parse Codex rate-limit usage from provider response headers. */
+export declare function parseCodexUsageHeaders(headers: HeaderLike, nowMs?: number): SubscriptionUsage | null;
+/** Merge a newer snapshot over a base, preferring defined fields. */
+export declare function mergeCodexUsage(base: SubscriptionUsage | null, update: SubscriptionUsage): SubscriptionUsage;
+/**
+ * Fetch Codex subscription usage from the backend endpoint using an OAuth
+ * bearer token. Memoized for {@link CACHE_MAX_AGE_MS} with rate-limit backoff;
+ * live updates also arrive via {@link parseCodexUsageHeaders}.
+ */
+export declare function fetchCodexUsage(token: string, cacheDir: string): Promise<SubscriptionUsage | null>;
+/** Persist a header-derived snapshot into the cache. */
+export declare function writeCodexUsageCache(cacheDir: string, data: SubscriptionUsage): Promise<void>;
+export {};
+//# sourceMappingURL=codex-client.d.ts.map

package/dist/domains/usage/codex-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-client.d.ts","sourceRoot":"","sources":["../../../src/domains/usage/codex-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,kBAAkB,CAAC;AAe9E,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAuI/E,mEAAmE;AACnE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,KAAK,SAAa,GACjB,iBAAiB,GAAG,IAAI,CAkC1B;AAwCD,mEAAmE;AACnE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EACnB,KAAK,SAAa,GACjB,iBAAiB,GAAG,IAAI,CAW1B;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAC7B,IAAI,EAAE,iBAAiB,GAAG,IAAI,EAC9B,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CASnB;AAwFD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAiEnC;AAED,wDAAwD;AACxD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAGf"}