open-multi-agent-kit 0.98.2 → 0.98.4

package/dist/core/codex-chatgpt-web-bridge.d.ts

@@ -0,0 +1,99 @@
+/**
+ * codex-chatgpt-web bridge catalog.
+ *
+ * The launcher (https://github.com/miuuyy/codex-chatgpt-web) serves a loopback Responses bridge
+ * whose `/v1/models` document is account-aware: a `chatgpt-web/*` slug advertises a 90K context
+ * window on Plus and 333K on Pro with Bigger Context. This module reads that document and derives
+ * the models.json rows for the provider, so OMK compacts on the bridge's real limits instead of a
+ * hardcoded guess. Network and file I/O stay in the caller.
+ */
+export declare const CODEX_CHATGPT_WEB_MODEL_PREFIX = "chatgpt-web/";
+/**
+ * Codex CLI version the bridge catalog was last verified against (2026-09-07). The Codex backend
+ * gates model visibility by `client_version`; a stale value yields an empty or partial catalog.
+ */
+export declare const CODEX_CHATGPT_WEB_FALLBACK_CLIENT_VERSION = "0.147.0";
+export type ModelInput = "text" | "image";
+export interface BridgeHealth {
+    readonly version: string;
+    readonly mode: string;
+    readonly acceptingTurns: boolean;
+}
+export interface BridgeCatalogRow {
+    readonly id: string;
+    readonly name: string;
+    readonly contextWindow: number;
+    readonly autoCompactTokenLimit: number | undefined;
+    readonly reasoningLevel: string;
+    readonly input: readonly ModelInput[];
+}
+/** One models.json model row. Keys OMK does not derive are carried through untouched. */
+export interface ModelsJsonModel {
+    readonly id: string;
+    readonly name?: string;
+    readonly contextWindow?: number;
+    readonly maxTokens?: number;
+    readonly reasoning?: boolean;
+    readonly input?: readonly ModelInput[];
+    readonly thinkingLevelMap?: Readonly<Record<string, string>>;
+    readonly cost?: Readonly<Record<string, number>>;
+    readonly [extra: string]: unknown;
+}
+export type SyncedField = "name" | "contextWindow" | "reasoning" | "input";
+export interface ModelFieldChange {
+    readonly id: string;
+    readonly field: SyncedField;
+    readonly from: unknown;
+    readonly to: unknown;
+}
+export interface BridgeSyncPlan {
+    readonly models: readonly ModelsJsonModel[];
+    readonly added: readonly string[];
+    readonly removed: readonly string[];
+    readonly changes: readonly ModelFieldChange[];
+}
+/** Where the provider's rows came from, stored on the provider so the numbers stay explainable. */
+export interface BridgeCatalogProvenance {
+    readonly bridgeVersion: string;
+    readonly clientVersion: string;
+    readonly syncedAt: string;
+    /** The bridge's rejection ceiling per row; `contextWindow` follows its compaction budget instead. */
+    readonly contextCeilings: Readonly<Record<string, number>>;
+}
+export interface ProviderSyncUpdate {
+    readonly models: readonly ModelsJsonModel[];
+    readonly bridgeCatalog: BridgeCatalogProvenance;
+}
+export declare function bridgeHealthUrl(baseUrl: string): string;
+export declare function bridgeModelsUrl(baseUrl: string, clientVersion: string): string;
+/** The models.json provider shape this module can sync; other keys pass through untouched. */
+export interface CodexChatGptWebProviderConfig {
+    readonly api: "openai-responses";
+    readonly compat: {
+        readonly sendCodexTurnMetadata: true;
+    };
+    readonly baseUrl?: unknown;
+    readonly models?: unknown;
+    readonly [extra: string]: unknown;
+}
+/** A models.json provider is the bridge when it speaks Responses and opts into Codex turn metadata. */
+export declare function isCodexChatGptWebProvider(provider: unknown): provider is CodexChatGptWebProviderConfig;
+export declare function parseBridgeHealth(value: unknown): BridgeHealth | undefined;
+/** `chatgpt-web/*` rows of a `/v1/models` document; undefined when the document has no models array. */
+export declare function parseBridgeCatalog(value: unknown): readonly BridgeCatalogRow[] | undefined;
+/**
+ * Merge the bridge catalog into the provider's models: derived fields follow the catalog, rows the
+ * bridge no longer serves are dropped, and everything else (user-owned fields, other namespaces,
+ * ordering) is preserved.
+ */
+export declare function planBridgeModelSync(existing: readonly ModelsJsonModel[], rows: readonly BridgeCatalogRow[]): BridgeSyncPlan;
+export declare function bridgeCatalogProvenance(source: Omit<BridgeCatalogProvenance, "contextCeilings">, rows: readonly BridgeCatalogRow[]): BridgeCatalogProvenance;
+/** True when the stored provenance already describes this catalog; `syncedAt` alone never forces a rewrite. */
+export declare function provenanceMatches(stored: unknown, next: BridgeCatalogProvenance): boolean;
+/**
+ * Replace one provider's `models` array and `bridgeCatalog` provenance in a models.json document,
+ * preserving every other key and the file's indentation. Undefined when the text is not a JSON
+ * document with that provider, so a caller never writes a guess.
+ */
+export declare function rewriteProviderModels(modelsJsonText: string, providerId: string, update: ProviderSyncUpdate): string | undefined;
+//# sourceMappingURL=codex-chatgpt-web-bridge.d.ts.map

package/dist/core/codex-chatgpt-web-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-chatgpt-web-bridge.d.ts","sourceRoot":"","sources":["../../src/core/codex-chatgpt-web-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * codex-chatgpt-web bridge catalog.\n *\n * The launcher (https://github.com/miuuyy/codex-chatgpt-web) serves a loopback Responses bridge\n * whose `/v1/models` document is account-aware: a `chatgpt-web/*` slug advertises a 90K context\n * window on Plus and 333K on Pro with Bigger Context. This module reads that document and derives\n * the models.json rows for the provider, so OMK compacts on the bridge's real limits instead of a\n * hardcoded guess. Network and file I/O stay in the caller.\n */\n\nexport const CODEX_CHATGPT_WEB_MODEL_PREFIX = \"chatgpt-web/\";\n/**\n * Codex CLI version the bridge catalog was last verified against (2026-09-07). The Codex backend\n * gates model visibility by `client_version`; a stale value yields an empty or partial catalog.\n */\nexport const CODEX_CHATGPT_WEB_FALLBACK_CLIENT_VERSION = \"0.147.0\";\nconst BRIDGE_SERVICE_NAME = \"codex-chatgpt-web\";\nconst DEFAULT_MAX_TOKENS = 32_768;\nconst ZERO_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } as const;\n\nexport type ModelInput = \"text\" | \"image\";\n\nexport interface BridgeHealth {\n\treadonly version: string;\n\treadonly mode: string;\n\treadonly acceptingTurns: boolean;\n}\n\nexport interface BridgeCatalogRow {\n\treadonly id: string;\n\treadonly name: string;\n\treadonly contextWindow: number;\n\treadonly autoCompactTokenLimit: number | undefined;\n\treadonly reasoningLevel: string;\n\treadonly input: readonly ModelInput[];\n}\n\n/** One models.json model row. Keys OMK does not derive are carried through untouched. */\nexport interface ModelsJsonModel {\n\treadonly id: string;\n\treadonly name?: string;\n\treadonly contextWindow?: number;\n\treadonly maxTokens?: number;\n\treadonly reasoning?: boolean;\n\treadonly input?: readonly ModelInput[];\n\treadonly thinkingLevelMap?: Readonly<Record<string, string>>;\n\treadonly cost?: Readonly<Record<string, number>>;\n\treadonly [extra: string]: unknown;\n}\n\nexport type SyncedField = \"name\" | \"contextWindow\" | \"reasoning\" | \"input\";\n\nexport interface ModelFieldChange {\n\treadonly id: string;\n\treadonly field: SyncedField;\n\treadonly from: unknown;\n\treadonly to: unknown;\n}\n\nexport interface BridgeSyncPlan {\n\treadonly models: readonly ModelsJsonModel[];\n\treadonly added: readonly string[];\n\treadonly removed: readonly string[];\n\treadonly changes: readonly ModelFieldChange[];\n}\n\n/** Where the provider's rows came from, stored on the provider so the numbers stay explainable. */\nexport interface BridgeCatalogProvenance {\n\treadonly bridgeVersion: string;\n\treadonly clientVersion: string;\n\treadonly syncedAt: string;\n\t/** The bridge's rejection ceiling per row; `contextWindow` follows its compaction budget instead. */\n\treadonly contextCeilings: Readonly<Record<string, number>>;\n}\n\nexport interface ProviderSyncUpdate {\n\treadonly models: readonly ModelsJsonModel[];\n\treadonly bridgeCatalog: BridgeCatalogProvenance;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isPositiveInteger(value: unknown): value is number {\n\treturn typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction isModelInput(value: unknown): value is ModelInput {\n\treturn value === \"text\" || value === \"image\";\n}\n\nexport function bridgeHealthUrl(baseUrl: string): string {\n\treturn new URL(\"/healthz\", baseUrl).toString();\n}\n\nexport function bridgeModelsUrl(baseUrl: string, clientVersion: string): string {\n\treturn `${baseUrl.replace(/\\/+$/, \"\")}/models?client_version=${encodeURIComponent(clientVersion)}`;\n}\n\n/** The models.json provider shape this module can sync; other keys pass through untouched. */\nexport interface CodexChatGptWebProviderConfig {\n\treadonly api: \"openai-responses\";\n\treadonly compat: { readonly sendCodexTurnMetadata: true };\n\treadonly baseUrl?: unknown;\n\treadonly models?: unknown;\n\treadonly [extra: string]: unknown;\n}\n\n/** A models.json provider is the bridge when it speaks Responses and opts into Codex turn metadata. */\nexport function isCodexChatGptWebProvider(provider: unknown): provider is CodexChatGptWebProviderConfig {\n\treturn (\n\t\tisRecord(provider) &&\n\t\tprovider.api === \"openai-responses\" &&\n\t\tisRecord(provider.compat) &&\n\t\tprovider.compat.sendCodexTurnMetadata === true\n\t);\n}\n\nexport function parseBridgeHealth(value: unknown): BridgeHealth | undefined {\n\tif (!isRecord(value) || value.service !== BRIDGE_SERVICE_NAME) return undefined;\n\tif (typeof value.version !== \"string\" || typeof value.mode !== \"string\") return undefined;\n\treturn { version: value.version, mode: value.mode, acceptingTurns: value.accepting_turns === true };\n}\n\nfunction parseCatalogRow(value: unknown): BridgeCatalogRow | undefined {\n\tif (!isRecord(value) || typeof value.slug !== \"string\") return undefined;\n\tif (!value.slug.startsWith(CODEX_CHATGPT_WEB_MODEL_PREFIX)) return undefined;\n\tif (!isPositiveInteger(value.context_window)) return undefined;\n\tconst modalities = Array.isArray(value.input_modalities) ? value.input_modalities.filter(isModelInput) : [];\n\treturn {\n\t\tid: value.slug,\n\t\tname: typeof value.display_name === \"string\" && value.display_name.length > 0 ? value.display_name : value.slug,\n\t\tcontextWindow: value.context_window,\n\t\tautoCompactTokenLimit: isPositiveInteger(value.auto_compact_token_limit)\n\t\t\t? value.auto_compact_token_limit\n\t\t\t: undefined,\n\t\treasoningLevel: typeof value.default_reasoning_level === \"string\" ? value.default_reasoning_level : \"low\",\n\t\tinput: modalities.length > 0 ? modalities : [\"text\"],\n\t};\n}\n\n/** `chatgpt-web/*` rows of a `/v1/models` document; undefined when the document has no models array. */\nexport function parseBridgeCatalog(value: unknown): readonly BridgeCatalogRow[] | undefined {\n\tif (!isRecord(value) || !Array.isArray(value.models)) return undefined;\n\treturn value.models.flatMap((entry) => {\n\t\tconst row = parseCatalogRow(entry);\n\t\treturn row ? [row] : [];\n\t});\n}\n\n/** OMK thinking levels the bridge's fixed effort corresponds to; the bridge ignores the request effort. */\nfunction thinkingLevelMap(reasoningLevel: string): Readonly<Record<string, string>> | undefined {\n\tswitch (reasoningLevel) {\n\t\tcase \"xhigh\":\n\t\t\treturn { xhigh: \"xhigh\" };\n\t\tcase \"ultra\":\n\t\t\treturn { max: \"max\" };\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\n/**\n * OMK compacts within `contextWindow` by its own headroom policy, so the row carries the budget the\n * bridge expects a client to compact within (`auto_compact_token_limit`, Codex's effective window)\n * rather than the rejection ceiling. Rows without a budget (Luna) use the ceiling itself.\n */\nfunction derivedFields(row: BridgeCatalogRow): Pick<ModelsJsonModel, SyncedField> {\n\treturn {\n\t\tname: row.name,\n\t\tcontextWindow: row.autoCompactTokenLimit ?? row.contextWindow,\n\t\treasoning: row.reasoningLevel !== \"low\",\n\t\tinput: row.input,\n\t};\n}\n\nfunction newModel(row: BridgeCatalogRow): ModelsJsonModel {\n\tconst levels = thinkingLevelMap(row.reasoningLevel);\n\treturn {\n\t\tid: row.id,\n\t\t...derivedFields(row),\n\t\tmaxTokens: DEFAULT_MAX_TOKENS,\n\t\tcost: ZERO_COST,\n\t\t...(levels ? { thinkingLevelMap: levels } : {}),\n\t};\n}\n\nfunction fieldChanges(existing: ModelsJsonModel, row: BridgeCatalogRow): readonly ModelFieldChange[] {\n\tconst next = derivedFields(row);\n\tconst fields: readonly SyncedField[] = [\"name\", \"contextWindow\", \"reasoning\", \"input\"];\n\treturn fields.flatMap((field) => {\n\t\tconst from = existing[field];\n\t\tconst to = next[field];\n\t\treturn JSON.stringify(from) === JSON.stringify(to) ? [] : [{ id: existing.id, field, from, to }];\n\t});\n}\n\n/**\n * Merge the bridge catalog into the provider's models: derived fields follow the catalog, rows the\n * bridge no longer serves are dropped, and everything else (user-owned fields, other namespaces,\n * ordering) is preserved.\n */\nexport function planBridgeModelSync(\n\texisting: readonly ModelsJsonModel[],\n\trows: readonly BridgeCatalogRow[],\n): BridgeSyncPlan {\n\tconst byId = new Map(rows.map((row) => [row.id, row]));\n\tconst changes: ModelFieldChange[] = [];\n\tconst removed: string[] = [];\n\tconst kept: ModelsJsonModel[] = [];\n\tfor (const model of existing) {\n\t\tif (!model.id.startsWith(CODEX_CHATGPT_WEB_MODEL_PREFIX)) {\n\t\t\tkept.push(model);\n\t\t\tcontinue;\n\t\t}\n\t\tconst row = byId.get(model.id);\n\t\tif (!row) {\n\t\t\tremoved.push(model.id);\n\t\t\tcontinue;\n\t\t}\n\t\tchanges.push(...fieldChanges(model, row));\n\t\tkept.push({ ...model, ...derivedFields(row) });\n\t}\n\tconst seen = new Set(existing.map((model) => model.id));\n\tconst added = rows.filter((row) => !seen.has(row.id));\n\treturn {\n\t\tmodels: [...kept, ...added.map(newModel)],\n\t\tadded: added.map((row) => row.id),\n\t\tremoved,\n\t\tchanges,\n\t};\n}\n\nexport function bridgeCatalogProvenance(\n\tsource: Omit<BridgeCatalogProvenance, \"contextCeilings\">,\n\trows: readonly BridgeCatalogRow[],\n): BridgeCatalogProvenance {\n\treturn { ...source, contextCeilings: Object.fromEntries(rows.map((row) => [row.id, row.contextWindow])) };\n}\n\n/** True when the stored provenance already describes this catalog; `syncedAt` alone never forces a rewrite. */\nexport function provenanceMatches(stored: unknown, next: BridgeCatalogProvenance): boolean {\n\tif (!isRecord(stored)) return false;\n\treturn (\n\t\tstored.bridgeVersion === next.bridgeVersion &&\n\t\tstored.clientVersion === next.clientVersion &&\n\t\tJSON.stringify(stored.contextCeilings) === JSON.stringify(next.contextCeilings)\n\t);\n}\n\nfunction detectIndent(text: string): string {\n\tif (/^\\t+\"/m.test(text)) return \"\\t\";\n\tconst spaces = /^( +)\"/m.exec(text);\n\treturn spaces?.[1] ?? \"  \";\n}\n\n/**\n * Replace one provider's `models` array and `bridgeCatalog` provenance in a models.json document,\n * preserving every other key and the file's indentation. Undefined when the text is not a JSON\n * document with that provider, so a caller never writes a guess.\n */\nexport function rewriteProviderModels(\n\tmodelsJsonText: string,\n\tproviderId: string,\n\tupdate: ProviderSyncUpdate,\n): string | undefined {\n\tlet document: unknown;\n\ttry {\n\t\tdocument = JSON.parse(modelsJsonText);\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError) return undefined;\n\t\tthrow error;\n\t}\n\tif (!isRecord(document) || !isRecord(document.providers)) return undefined;\n\tconst provider = document.providers[providerId];\n\tif (!isRecord(provider)) return undefined;\n\tconst providers = { ...document.providers, [providerId]: { ...provider, ...update } };\n\tconst serialized = JSON.stringify({ ...document, providers }, null, detectIndent(modelsJsonText));\n\treturn modelsJsonText.endsWith(\"\\n\") ? `${serialized}\\n` : serialized;\n}\n"]}

package/dist/core/codex-chatgpt-web-bridge.js

@@ -0,0 +1,192 @@
+/**
+ * codex-chatgpt-web bridge catalog.
+ *
+ * The launcher (https://github.com/miuuyy/codex-chatgpt-web) serves a loopback Responses bridge
+ * whose `/v1/models` document is account-aware: a `chatgpt-web/*` slug advertises a 90K context
+ * window on Plus and 333K on Pro with Bigger Context. This module reads that document and derives
+ * the models.json rows for the provider, so OMK compacts on the bridge's real limits instead of a
+ * hardcoded guess. Network and file I/O stay in the caller.
+ */
+export const CODEX_CHATGPT_WEB_MODEL_PREFIX = "chatgpt-web/";
+/**
+ * Codex CLI version the bridge catalog was last verified against (2026-09-07). The Codex backend
+ * gates model visibility by `client_version`; a stale value yields an empty or partial catalog.
+ */
+export const CODEX_CHATGPT_WEB_FALLBACK_CLIENT_VERSION = "0.147.0";
+const BRIDGE_SERVICE_NAME = "codex-chatgpt-web";
+const DEFAULT_MAX_TOKENS = 32_768;
+const ZERO_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPositiveInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function isModelInput(value) {
+    return value === "text" || value === "image";
+}
+export function bridgeHealthUrl(baseUrl) {
+    return new URL("/healthz", baseUrl).toString();
+}
+export function bridgeModelsUrl(baseUrl, clientVersion) {
+    return `${baseUrl.replace(/\/+$/, "")}/models?client_version=${encodeURIComponent(clientVersion)}`;
+}
+/** A models.json provider is the bridge when it speaks Responses and opts into Codex turn metadata. */
+export function isCodexChatGptWebProvider(provider) {
+    return (isRecord(provider) &&
+        provider.api === "openai-responses" &&
+        isRecord(provider.compat) &&
+        provider.compat.sendCodexTurnMetadata === true);
+}
+export function parseBridgeHealth(value) {
+    if (!isRecord(value) || value.service !== BRIDGE_SERVICE_NAME)
+        return undefined;
+    if (typeof value.version !== "string" || typeof value.mode !== "string")
+        return undefined;
+    return { version: value.version, mode: value.mode, acceptingTurns: value.accepting_turns === true };
+}
+function parseCatalogRow(value) {
+    if (!isRecord(value) || typeof value.slug !== "string")
+        return undefined;
+    if (!value.slug.startsWith(CODEX_CHATGPT_WEB_MODEL_PREFIX))
+        return undefined;
+    if (!isPositiveInteger(value.context_window))
+        return undefined;
+    const modalities = Array.isArray(value.input_modalities) ? value.input_modalities.filter(isModelInput) : [];
+    return {
+        id: value.slug,
+        name: typeof value.display_name === "string" && value.display_name.length > 0 ? value.display_name : value.slug,
+        contextWindow: value.context_window,
+        autoCompactTokenLimit: isPositiveInteger(value.auto_compact_token_limit)
+            ? value.auto_compact_token_limit
+            : undefined,
+        reasoningLevel: typeof value.default_reasoning_level === "string" ? value.default_reasoning_level : "low",
+        input: modalities.length > 0 ? modalities : ["text"],
+    };
+}
+/** `chatgpt-web/*` rows of a `/v1/models` document; undefined when the document has no models array. */
+export function parseBridgeCatalog(value) {
+    if (!isRecord(value) || !Array.isArray(value.models))
+        return undefined;
+    return value.models.flatMap((entry) => {
+        const row = parseCatalogRow(entry);
+        return row ? [row] : [];
+    });
+}
+/** OMK thinking levels the bridge's fixed effort corresponds to; the bridge ignores the request effort. */
+function thinkingLevelMap(reasoningLevel) {
+    switch (reasoningLevel) {
+        case "xhigh":
+            return { xhigh: "xhigh" };
+        case "ultra":
+            return { max: "max" };
+        default:
+            return undefined;
+    }
+}
+/**
+ * OMK compacts within `contextWindow` by its own headroom policy, so the row carries the budget the
+ * bridge expects a client to compact within (`auto_compact_token_limit`, Codex's effective window)
+ * rather than the rejection ceiling. Rows without a budget (Luna) use the ceiling itself.
+ */
+function derivedFields(row) {
+    return {
+        name: row.name,
+        contextWindow: row.autoCompactTokenLimit ?? row.contextWindow,
+        reasoning: row.reasoningLevel !== "low",
+        input: row.input,
+    };
+}
+function newModel(row) {
+    const levels = thinkingLevelMap(row.reasoningLevel);
+    return {
+        id: row.id,
+        ...derivedFields(row),
+        maxTokens: DEFAULT_MAX_TOKENS,
+        cost: ZERO_COST,
+        ...(levels ? { thinkingLevelMap: levels } : {}),
+    };
+}
+function fieldChanges(existing, row) {
+    const next = derivedFields(row);
+    const fields = ["name", "contextWindow", "reasoning", "input"];
+    return fields.flatMap((field) => {
+        const from = existing[field];
+        const to = next[field];
+        return JSON.stringify(from) === JSON.stringify(to) ? [] : [{ id: existing.id, field, from, to }];
+    });
+}
+/**
+ * Merge the bridge catalog into the provider's models: derived fields follow the catalog, rows the
+ * bridge no longer serves are dropped, and everything else (user-owned fields, other namespaces,
+ * ordering) is preserved.
+ */
+export function planBridgeModelSync(existing, rows) {
+    const byId = new Map(rows.map((row) => [row.id, row]));
+    const changes = [];
+    const removed = [];
+    const kept = [];
+    for (const model of existing) {
+        if (!model.id.startsWith(CODEX_CHATGPT_WEB_MODEL_PREFIX)) {
+            kept.push(model);
+            continue;
+        }
+        const row = byId.get(model.id);
+        if (!row) {
+            removed.push(model.id);
+            continue;
+        }
+        changes.push(...fieldChanges(model, row));
+        kept.push({ ...model, ...derivedFields(row) });
+    }
+    const seen = new Set(existing.map((model) => model.id));
+    const added = rows.filter((row) => !seen.has(row.id));
+    return {
+        models: [...kept, ...added.map(newModel)],
+        added: added.map((row) => row.id),
+        removed,
+        changes,
+    };
+}
+export function bridgeCatalogProvenance(source, rows) {
+    return { ...source, contextCeilings: Object.fromEntries(rows.map((row) => [row.id, row.contextWindow])) };
+}
+/** True when the stored provenance already describes this catalog; `syncedAt` alone never forces a rewrite. */
+export function provenanceMatches(stored, next) {
+    if (!isRecord(stored))
+        return false;
+    return (stored.bridgeVersion === next.bridgeVersion &&
+        stored.clientVersion === next.clientVersion &&
+        JSON.stringify(stored.contextCeilings) === JSON.stringify(next.contextCeilings));
+}
+function detectIndent(text) {
+    if (/^\t+"/m.test(text))
+        return "\t";
+    const spaces = /^( +)"/m.exec(text);
+    return spaces?.[1] ?? "  ";
+}
+/**
+ * Replace one provider's `models` array and `bridgeCatalog` provenance in a models.json document,
+ * preserving every other key and the file's indentation. Undefined when the text is not a JSON
+ * document with that provider, so a caller never writes a guess.
+ */
+export function rewriteProviderModels(modelsJsonText, providerId, update) {
+    let document;
+    try {
+        document = JSON.parse(modelsJsonText);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+    if (!isRecord(document) || !isRecord(document.providers))
+        return undefined;
+    const provider = document.providers[providerId];
+    if (!isRecord(provider))
+        return undefined;
+    const providers = { ...document.providers, [providerId]: { ...provider, ...update } };
+    const serialized = JSON.stringify({ ...document, providers }, null, detectIndent(modelsJsonText));
+    return modelsJsonText.endsWith("\n") ? `${serialized}\n` : serialized;
+}
+//# sourceMappingURL=codex-chatgpt-web-bridge.js.map

package/dist/core/codex-chatgpt-web-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-chatgpt-web-bridge.js","sourceRoot":"","sources":["../../src/core/codex-chatgpt-web-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * codex-chatgpt-web bridge catalog.\n *\n * The launcher (https://github.com/miuuyy/codex-chatgpt-web) serves a loopback Responses bridge\n * whose `/v1/models` document is account-aware: a `chatgpt-web/*` slug advertises a 90K context\n * window on Plus and 333K on Pro with Bigger Context. This module reads that document and derives\n * the models.json rows for the provider, so OMK compacts on the bridge's real limits instead of a\n * hardcoded guess. Network and file I/O stay in the caller.\n */\n\nexport const CODEX_CHATGPT_WEB_MODEL_PREFIX = \"chatgpt-web/\";\n/**\n * Codex CLI version the bridge catalog was last verified against (2026-09-07). The Codex backend\n * gates model visibility by `client_version`; a stale value yields an empty or partial catalog.\n */\nexport const CODEX_CHATGPT_WEB_FALLBACK_CLIENT_VERSION = \"0.147.0\";\nconst BRIDGE_SERVICE_NAME = \"codex-chatgpt-web\";\nconst DEFAULT_MAX_TOKENS = 32_768;\nconst ZERO_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } as const;\n\nexport type ModelInput = \"text\" | \"image\";\n\nexport interface BridgeHealth {\n\treadonly version: string;\n\treadonly mode: string;\n\treadonly acceptingTurns: boolean;\n}\n\nexport interface BridgeCatalogRow {\n\treadonly id: string;\n\treadonly name: string;\n\treadonly contextWindow: number;\n\treadonly autoCompactTokenLimit: number | undefined;\n\treadonly reasoningLevel: string;\n\treadonly input: readonly ModelInput[];\n}\n\n/** One models.json model row. Keys OMK does not derive are carried through untouched. */\nexport interface ModelsJsonModel {\n\treadonly id: string;\n\treadonly name?: string;\n\treadonly contextWindow?: number;\n\treadonly maxTokens?: number;\n\treadonly reasoning?: boolean;\n\treadonly input?: readonly ModelInput[];\n\treadonly thinkingLevelMap?: Readonly<Record<string, string>>;\n\treadonly cost?: Readonly<Record<string, number>>;\n\treadonly [extra: string]: unknown;\n}\n\nexport type SyncedField = \"name\" | \"contextWindow\" | \"reasoning\" | \"input\";\n\nexport interface ModelFieldChange {\n\treadonly id: string;\n\treadonly field: SyncedField;\n\treadonly from: unknown;\n\treadonly to: unknown;\n}\n\nexport interface BridgeSyncPlan {\n\treadonly models: readonly ModelsJsonModel[];\n\treadonly added: readonly string[];\n\treadonly removed: readonly string[];\n\treadonly changes: readonly ModelFieldChange[];\n}\n\n/** Where the provider's rows came from, stored on the provider so the numbers stay explainable. */\nexport interface BridgeCatalogProvenance {\n\treadonly bridgeVersion: string;\n\treadonly clientVersion: string;\n\treadonly syncedAt: string;\n\t/** The bridge's rejection ceiling per row; `contextWindow` follows its compaction budget instead. */\n\treadonly contextCeilings: Readonly<Record<string, number>>;\n}\n\nexport interface ProviderSyncUpdate {\n\treadonly models: readonly ModelsJsonModel[];\n\treadonly bridgeCatalog: BridgeCatalogProvenance;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isPositiveInteger(value: unknown): value is number {\n\treturn typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction isModelInput(value: unknown): value is ModelInput {\n\treturn value === \"text\" || value === \"image\";\n}\n\nexport function bridgeHealthUrl(baseUrl: string): string {\n\treturn new URL(\"/healthz\", baseUrl).toString();\n}\n\nexport function bridgeModelsUrl(baseUrl: string, clientVersion: string): string {\n\treturn `${baseUrl.replace(/\\/+$/, \"\")}/models?client_version=${encodeURIComponent(clientVersion)}`;\n}\n\n/** The models.json provider shape this module can sync; other keys pass through untouched. */\nexport interface CodexChatGptWebProviderConfig {\n\treadonly api: \"openai-responses\";\n\treadonly compat: { readonly sendCodexTurnMetadata: true };\n\treadonly baseUrl?: unknown;\n\treadonly models?: unknown;\n\treadonly [extra: string]: unknown;\n}\n\n/** A models.json provider is the bridge when it speaks Responses and opts into Codex turn metadata. */\nexport function isCodexChatGptWebProvider(provider: unknown): provider is CodexChatGptWebProviderConfig {\n\treturn (\n\t\tisRecord(provider) &&\n\t\tprovider.api === \"openai-responses\" &&\n\t\tisRecord(provider.compat) &&\n\t\tprovider.compat.sendCodexTurnMetadata === true\n\t);\n}\n\nexport function parseBridgeHealth(value: unknown): BridgeHealth | undefined {\n\tif (!isRecord(value) || value.service !== BRIDGE_SERVICE_NAME) return undefined;\n\tif (typeof value.version !== \"string\" || typeof value.mode !== \"string\") return undefined;\n\treturn { version: value.version, mode: value.mode, acceptingTurns: value.accepting_turns === true };\n}\n\nfunction parseCatalogRow(value: unknown): BridgeCatalogRow | undefined {\n\tif (!isRecord(value) || typeof value.slug !== \"string\") return undefined;\n\tif (!value.slug.startsWith(CODEX_CHATGPT_WEB_MODEL_PREFIX)) return undefined;\n\tif (!isPositiveInteger(value.context_window)) return undefined;\n\tconst modalities = Array.isArray(value.input_modalities) ? value.input_modalities.filter(isModelInput) : [];\n\treturn {\n\t\tid: value.slug,\n\t\tname: typeof value.display_name === \"string\" && value.display_name.length > 0 ? value.display_name : value.slug,\n\t\tcontextWindow: value.context_window,\n\t\tautoCompactTokenLimit: isPositiveInteger(value.auto_compact_token_limit)\n\t\t\t? value.auto_compact_token_limit\n\t\t\t: undefined,\n\t\treasoningLevel: typeof value.default_reasoning_level === \"string\" ? value.default_reasoning_level : \"low\",\n\t\tinput: modalities.length > 0 ? modalities : [\"text\"],\n\t};\n}\n\n/** `chatgpt-web/*` rows of a `/v1/models` document; undefined when the document has no models array. */\nexport function parseBridgeCatalog(value: unknown): readonly BridgeCatalogRow[] | undefined {\n\tif (!isRecord(value) || !Array.isArray(value.models)) return undefined;\n\treturn value.models.flatMap((entry) => {\n\t\tconst row = parseCatalogRow(entry);\n\t\treturn row ? [row] : [];\n\t});\n}\n\n/** OMK thinking levels the bridge's fixed effort corresponds to; the bridge ignores the request effort. */\nfunction thinkingLevelMap(reasoningLevel: string): Readonly<Record<string, string>> | undefined {\n\tswitch (reasoningLevel) {\n\t\tcase \"xhigh\":\n\t\t\treturn { xhigh: \"xhigh\" };\n\t\tcase \"ultra\":\n\t\t\treturn { max: \"max\" };\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\n/**\n * OMK compacts within `contextWindow` by its own headroom policy, so the row carries the budget the\n * bridge expects a client to compact within (`auto_compact_token_limit`, Codex's effective window)\n * rather than the rejection ceiling. Rows without a budget (Luna) use the ceiling itself.\n */\nfunction derivedFields(row: BridgeCatalogRow): Pick<ModelsJsonModel, SyncedField> {\n\treturn {\n\t\tname: row.name,\n\t\tcontextWindow: row.autoCompactTokenLimit ?? row.contextWindow,\n\t\treasoning: row.reasoningLevel !== \"low\",\n\t\tinput: row.input,\n\t};\n}\n\nfunction newModel(row: BridgeCatalogRow): ModelsJsonModel {\n\tconst levels = thinkingLevelMap(row.reasoningLevel);\n\treturn {\n\t\tid: row.id,\n\t\t...derivedFields(row),\n\t\tmaxTokens: DEFAULT_MAX_TOKENS,\n\t\tcost: ZERO_COST,\n\t\t...(levels ? { thinkingLevelMap: levels } : {}),\n\t};\n}\n\nfunction fieldChanges(existing: ModelsJsonModel, row: BridgeCatalogRow): readonly ModelFieldChange[] {\n\tconst next = derivedFields(row);\n\tconst fields: readonly SyncedField[] = [\"name\", \"contextWindow\", \"reasoning\", \"input\"];\n\treturn fields.flatMap((field) => {\n\t\tconst from = existing[field];\n\t\tconst to = next[field];\n\t\treturn JSON.stringify(from) === JSON.stringify(to) ? [] : [{ id: existing.id, field, from, to }];\n\t});\n}\n\n/**\n * Merge the bridge catalog into the provider's models: derived fields follow the catalog, rows the\n * bridge no longer serves are dropped, and everything else (user-owned fields, other namespaces,\n * ordering) is preserved.\n */\nexport function planBridgeModelSync(\n\texisting: readonly ModelsJsonModel[],\n\trows: readonly BridgeCatalogRow[],\n): BridgeSyncPlan {\n\tconst byId = new Map(rows.map((row) => [row.id, row]));\n\tconst changes: ModelFieldChange[] = [];\n\tconst removed: string[] = [];\n\tconst kept: ModelsJsonModel[] = [];\n\tfor (const model of existing) {\n\t\tif (!model.id.startsWith(CODEX_CHATGPT_WEB_MODEL_PREFIX)) {\n\t\t\tkept.push(model);\n\t\t\tcontinue;\n\t\t}\n\t\tconst row = byId.get(model.id);\n\t\tif (!row) {\n\t\t\tremoved.push(model.id);\n\t\t\tcontinue;\n\t\t}\n\t\tchanges.push(...fieldChanges(model, row));\n\t\tkept.push({ ...model, ...derivedFields(row) });\n\t}\n\tconst seen = new Set(existing.map((model) => model.id));\n\tconst added = rows.filter((row) => !seen.has(row.id));\n\treturn {\n\t\tmodels: [...kept, ...added.map(newModel)],\n\t\tadded: added.map((row) => row.id),\n\t\tremoved,\n\t\tchanges,\n\t};\n}\n\nexport function bridgeCatalogProvenance(\n\tsource: Omit<BridgeCatalogProvenance, \"contextCeilings\">,\n\trows: readonly BridgeCatalogRow[],\n): BridgeCatalogProvenance {\n\treturn { ...source, contextCeilings: Object.fromEntries(rows.map((row) => [row.id, row.contextWindow])) };\n}\n\n/** True when the stored provenance already describes this catalog; `syncedAt` alone never forces a rewrite. */\nexport function provenanceMatches(stored: unknown, next: BridgeCatalogProvenance): boolean {\n\tif (!isRecord(stored)) return false;\n\treturn (\n\t\tstored.bridgeVersion === next.bridgeVersion &&\n\t\tstored.clientVersion === next.clientVersion &&\n\t\tJSON.stringify(stored.contextCeilings) === JSON.stringify(next.contextCeilings)\n\t);\n}\n\nfunction detectIndent(text: string): string {\n\tif (/^\\t+\"/m.test(text)) return \"\\t\";\n\tconst spaces = /^( +)\"/m.exec(text);\n\treturn spaces?.[1] ?? \"  \";\n}\n\n/**\n * Replace one provider's `models` array and `bridgeCatalog` provenance in a models.json document,\n * preserving every other key and the file's indentation. Undefined when the text is not a JSON\n * document with that provider, so a caller never writes a guess.\n */\nexport function rewriteProviderModels(\n\tmodelsJsonText: string,\n\tproviderId: string,\n\tupdate: ProviderSyncUpdate,\n): string | undefined {\n\tlet document: unknown;\n\ttry {\n\t\tdocument = JSON.parse(modelsJsonText);\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError) return undefined;\n\t\tthrow error;\n\t}\n\tif (!isRecord(document) || !isRecord(document.providers)) return undefined;\n\tconst provider = document.providers[providerId];\n\tif (!isRecord(provider)) return undefined;\n\tconst providers = { ...document.providers, [providerId]: { ...provider, ...update } };\n\tconst serialized = JSON.stringify({ ...document, providers }, null, detectIndent(modelsJsonText));\n\treturn modelsJsonText.endsWith(\"\\n\") ? `${serialized}\\n` : serialized;\n}\n"]}

package/dist/core/codex-chatgpt-web-sync.d.ts

@@ -0,0 +1,50 @@
+/**
+ * codex-chatgpt-web provider sync workflow: health check, account-aware catalog fetch, sync plan,
+ * and the models.json rewrite. I/O arrives through `BridgeSyncIo`; expected failures are reported
+ * as `BridgeSyncFailure` with a user-facing message that never carries a credential.
+ */
+import { type BridgeCatalogProvenance, type BridgeHealth, type BridgeSyncPlan } from "./codex-chatgpt-web-bridge.ts";
+interface BridgeSyncResponse {
+    readonly status: number;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+}
+interface BridgeSyncRequestInit {
+    readonly signal: AbortSignal;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+export interface BridgeSyncIo {
+    readonly readFile: (path: string) => string;
+    readonly writeFile: (path: string, text: string) => void;
+    readonly fetch: (url: string, init: BridgeSyncRequestInit) => Promise<BridgeSyncResponse>;
+    readonly getCodexAccessToken: () => Promise<string | undefined>;
+    /** ISO timestamp for `bridgeCatalog.syncedAt`. */
+    readonly now: () => string;
+}
+export interface BridgeSyncRequest {
+    readonly providerId: string;
+    readonly modelsPath: string;
+    readonly timeoutMs: number;
+    readonly clientVersion: string;
+    readonly dryRun: boolean;
+}
+export interface BridgeSyncReport {
+    readonly modelsPath: string;
+    readonly baseUrl: string;
+    readonly health: BridgeHealth;
+    readonly clientVersion: string;
+    readonly plan: BridgeSyncPlan;
+    readonly bridgeCatalog: BridgeCatalogProvenance;
+    readonly written: boolean;
+}
+export declare class BridgeSyncFailure extends Error {
+    constructor(message: string);
+}
+export declare function hasBridgeSyncChanges(plan: BridgeSyncPlan): boolean;
+/**
+ * Run the sync. models.json is rewritten when a row changes or the recorded provenance no longer
+ * describes the bridge (its version, the client version, or a ceiling moved); `dryRun` only reports.
+ */
+export declare function syncCodexChatGptWebProvider(sync: BridgeSyncRequest, io: BridgeSyncIo): Promise<BridgeSyncReport>;
+export {};
+//# sourceMappingURL=codex-chatgpt-web-sync.d.ts.map

package/dist/core/codex-chatgpt-web-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-chatgpt-web-sync.d.ts","sourceRoot":"","sources":["../../src/core/codex-chatgpt-web-sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,cAAc,EAWnB,MAAM,+BAA+B,CAAC;AAMvC,UAAU,kBAAkB;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACxB;AAED,UAAU,qBAAqB;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChE,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAaD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAElE;AA8ED;;;GAGG;AACH,wBAAsB,2BAA2B,CAChD,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,YAAY,GACd,OAAO,CAAC,gBAAgB,CAAC,CAyB3B","sourcesContent":["/**\n * codex-chatgpt-web provider sync workflow: health check, account-aware catalog fetch, sync plan,\n * and the models.json rewrite. I/O arrives through `BridgeSyncIo`; expected failures are reported\n * as `BridgeSyncFailure` with a user-facing message that never carries a credential.\n */\n\nimport {\n\ttype BridgeCatalogProvenance,\n\ttype BridgeHealth,\n\ttype BridgeSyncPlan,\n\tbridgeCatalogProvenance,\n\tbridgeHealthUrl,\n\tbridgeModelsUrl,\n\tisCodexChatGptWebProvider,\n\ttype ModelsJsonModel,\n\tparseBridgeCatalog,\n\tparseBridgeHealth,\n\tplanBridgeModelSync,\n\tprovenanceMatches,\n\trewriteProviderModels,\n} from \"./codex-chatgpt-web-bridge.ts\";\n\nconst LAUNCHER_HINT =\n\t\"Start the Codex Web GPT launcher (it hosts the signed-in ChatGPT Web session and the local bridge), then retry.\";\nconst LOGIN_HINT = \"run /login openai-codex in OMK\";\n\ninterface BridgeSyncResponse {\n\treadonly status: number;\n\tjson(): Promise<unknown>;\n\ttext(): Promise<string>;\n}\n\ninterface BridgeSyncRequestInit {\n\treadonly signal: AbortSignal;\n\treadonly headers?: Readonly<Record<string, string>>;\n}\n\nexport interface BridgeSyncIo {\n\treadonly readFile: (path: string) => string;\n\treadonly writeFile: (path: string, text: string) => void;\n\treadonly fetch: (url: string, init: BridgeSyncRequestInit) => Promise<BridgeSyncResponse>;\n\treadonly getCodexAccessToken: () => Promise<string | undefined>;\n\t/** ISO timestamp for `bridgeCatalog.syncedAt`. */\n\treadonly now: () => string;\n}\n\nexport interface BridgeSyncRequest {\n\treadonly providerId: string;\n\treadonly modelsPath: string;\n\treadonly timeoutMs: number;\n\treadonly clientVersion: string;\n\treadonly dryRun: boolean;\n}\n\nexport interface BridgeSyncReport {\n\treadonly modelsPath: string;\n\treadonly baseUrl: string;\n\treadonly health: BridgeHealth;\n\treadonly clientVersion: string;\n\treadonly plan: BridgeSyncPlan;\n\treadonly bridgeCatalog: BridgeCatalogProvenance;\n\treadonly written: boolean;\n}\n\nexport class BridgeSyncFailure extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"BridgeSyncFailure\";\n\t}\n}\n\ninterface LoadedProvider {\n\treadonly text: string;\n\treadonly baseUrl: string;\n\treadonly models: readonly ModelsJsonModel[];\n\treadonly bridgeCatalog: unknown;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function hasBridgeSyncChanges(plan: BridgeSyncPlan): boolean {\n\treturn plan.changes.length + plan.added.length + plan.removed.length > 0;\n}\n\n/** Parse models.json once and narrow the target provider to the bridge shape this workflow can sync. */\nfunction loadProvider(io: BridgeSyncIo, path: string, providerId: string): LoadedProvider {\n\tconst text = io.readFile(path);\n\tlet document: unknown;\n\ttry {\n\t\tdocument = JSON.parse(text);\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError) throw new BridgeSyncFailure(`Could not read ${path}: ${error.message}`);\n\t\tthrow error;\n\t}\n\tconst provider = isRecord(document) && isRecord(document.providers) ? document.providers[providerId] : undefined;\n\tif (provider === undefined) throw new BridgeSyncFailure(`Provider \"${providerId}\" is not defined in ${path}.`);\n\tif (!isCodexChatGptWebProvider(provider)) {\n\t\tthrow new BridgeSyncFailure(\n\t\t\t`Provider \"${providerId}\" is not a codex-chatgpt-web bridge: provider sync supports openai-responses providers with compat.sendCodexTurnMetadata: true.`,\n\t\t);\n\t}\n\tif (typeof provider.baseUrl !== \"string\") throw new BridgeSyncFailure(`Provider \"${providerId}\" has no baseUrl.`);\n\tconst rows: readonly unknown[] = Array.isArray(provider.models) ? provider.models : [];\n\tconst models = rows.flatMap((model) =>\n\t\tisRecord(model) && typeof model.id === \"string\" ? [{ ...model, id: model.id }] : [],\n\t);\n\treturn { text, baseUrl: provider.baseUrl, models, bridgeCatalog: provider.bridgeCatalog };\n}\n\nasync function request(io: BridgeSyncIo, url: string, init: BridgeSyncRequestInit): Promise<BridgeSyncResponse> {\n\ttry {\n\t\treturn await io.fetch(url, init);\n\t} catch (error) {\n\t\tif (error instanceof Error) {\n\t\t\tthrow new BridgeSyncFailure(`Bridge request to ${url} failed (${error.message}). ${LAUNCHER_HINT}`);\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nasync function checkHealth(io: BridgeSyncIo, baseUrl: string, timeoutMs: number): Promise<BridgeHealth> {\n\tconst url = bridgeHealthUrl(baseUrl);\n\tconst response = await request(io, url, { signal: AbortSignal.timeout(timeoutMs) });\n\tif (response.status !== 200) {\n\t\tthrow new BridgeSyncFailure(`Bridge health check at ${url} returned HTTP ${response.status}. ${LAUNCHER_HINT}`);\n\t}\n\tconst health = parseBridgeHealth(await response.json());\n\tif (!health)\n\t\tthrow new BridgeSyncFailure(`${url} did not answer as codex-chatgpt-web; check the provider's baseUrl.`);\n\treturn health;\n}\n\nasync function fetchCatalog(io: BridgeSyncIo, sync: BridgeSyncRequest, baseUrl: string) {\n\tconst token = await io.getCodexAccessToken();\n\tif (!token) {\n\t\tthrow new BridgeSyncFailure(\n\t\t\t`The bridge forwards /v1/models to the Codex backend with your ChatGPT OAuth; ${LOGIN_HINT} first.`,\n\t\t);\n\t}\n\tconst response = await request(io, bridgeModelsUrl(baseUrl, sync.clientVersion), {\n\t\tsignal: AbortSignal.timeout(sync.timeoutMs),\n\t\theaders: { authorization: `Bearer ${token}` },\n\t});\n\tif (response.status === 401 || response.status === 403) {\n\t\tthrow new BridgeSyncFailure(`The Codex backend rejected OMK's openai-codex OAuth token; ${LOGIN_HINT} again.`);\n\t}\n\tif (response.status !== 200) {\n\t\tconst body = await response.text();\n\t\tthrow new BridgeSyncFailure(`Bridge catalog request returned HTTP ${response.status}: ${body.slice(0, 300)}`);\n\t}\n\tconst rows = parseBridgeCatalog(await response.json());\n\tif (rows === undefined) throw new BridgeSyncFailure(\"Bridge catalog response has no models array.\");\n\tif (rows.length === 0) {\n\t\tthrow new BridgeSyncFailure(\n\t\t\t`Bridge advertised no chatgpt-web/* models for client_version ${sync.clientVersion}; sign in to the launcher and press Install models.`,\n\t\t);\n\t}\n\treturn rows;\n}\n\n/**\n * Run the sync. models.json is rewritten when a row changes or the recorded provenance no longer\n * describes the bridge (its version, the client version, or a ceiling moved); `dryRun` only reports.\n */\nexport async function syncCodexChatGptWebProvider(\n\tsync: BridgeSyncRequest,\n\tio: BridgeSyncIo,\n): Promise<BridgeSyncReport> {\n\tconst provider = loadProvider(io, sync.modelsPath, sync.providerId);\n\tconst health = await checkHealth(io, provider.baseUrl, sync.timeoutMs);\n\tconst rows = await fetchCatalog(io, sync, provider.baseUrl);\n\tconst plan = planBridgeModelSync(provider.models, rows);\n\tconst bridgeCatalog = bridgeCatalogProvenance(\n\t\t{ bridgeVersion: health.version, clientVersion: sync.clientVersion, syncedAt: io.now() },\n\t\trows,\n\t);\n\tconst stale = hasBridgeSyncChanges(plan) || !provenanceMatches(provider.bridgeCatalog, bridgeCatalog);\n\tconst written = stale && !sync.dryRun;\n\tif (written) {\n\t\tconst rewritten = rewriteProviderModels(provider.text, sync.providerId, { models: plan.models, bridgeCatalog });\n\t\tif (rewritten === undefined) throw new BridgeSyncFailure(`Could not rewrite ${sync.modelsPath}.`);\n\t\tio.writeFile(sync.modelsPath, rewritten);\n\t}\n\treturn {\n\t\tmodelsPath: sync.modelsPath,\n\t\tbaseUrl: provider.baseUrl,\n\t\thealth,\n\t\tclientVersion: sync.clientVersion,\n\t\tplan,\n\t\tbridgeCatalog,\n\t\twritten,\n\t};\n}\n"]}

package/dist/core/codex-chatgpt-web-sync.js

@@ -0,0 +1,119 @@
+/**
+ * codex-chatgpt-web provider sync workflow: health check, account-aware catalog fetch, sync plan,
+ * and the models.json rewrite. I/O arrives through `BridgeSyncIo`; expected failures are reported
+ * as `BridgeSyncFailure` with a user-facing message that never carries a credential.
+ */
+import { bridgeCatalogProvenance, bridgeHealthUrl, bridgeModelsUrl, isCodexChatGptWebProvider, parseBridgeCatalog, parseBridgeHealth, planBridgeModelSync, provenanceMatches, rewriteProviderModels, } from "./codex-chatgpt-web-bridge.js";
+const LAUNCHER_HINT = "Start the Codex Web GPT launcher (it hosts the signed-in ChatGPT Web session and the local bridge), then retry.";
+const LOGIN_HINT = "run /login openai-codex in OMK";
+export class BridgeSyncFailure extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BridgeSyncFailure";
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function hasBridgeSyncChanges(plan) {
+    return plan.changes.length + plan.added.length + plan.removed.length > 0;
+}
+/** Parse models.json once and narrow the target provider to the bridge shape this workflow can sync. */
+function loadProvider(io, path, providerId) {
+    const text = io.readFile(path);
+    let document;
+    try {
+        document = JSON.parse(text);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            throw new BridgeSyncFailure(`Could not read ${path}: ${error.message}`);
+        throw error;
+    }
+    const provider = isRecord(document) && isRecord(document.providers) ? document.providers[providerId] : undefined;
+    if (provider === undefined)
+        throw new BridgeSyncFailure(`Provider "${providerId}" is not defined in ${path}.`);
+    if (!isCodexChatGptWebProvider(provider)) {
+        throw new BridgeSyncFailure(`Provider "${providerId}" is not a codex-chatgpt-web bridge: provider sync supports openai-responses providers with compat.sendCodexTurnMetadata: true.`);
+    }
+    if (typeof provider.baseUrl !== "string")
+        throw new BridgeSyncFailure(`Provider "${providerId}" has no baseUrl.`);
+    const rows = Array.isArray(provider.models) ? provider.models : [];
+    const models = rows.flatMap((model) => isRecord(model) && typeof model.id === "string" ? [{ ...model, id: model.id }] : []);
+    return { text, baseUrl: provider.baseUrl, models, bridgeCatalog: provider.bridgeCatalog };
+}
+async function request(io, url, init) {
+    try {
+        return await io.fetch(url, init);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new BridgeSyncFailure(`Bridge request to ${url} failed (${error.message}). ${LAUNCHER_HINT}`);
+        }
+        throw error;
+    }
+}
+async function checkHealth(io, baseUrl, timeoutMs) {
+    const url = bridgeHealthUrl(baseUrl);
+    const response = await request(io, url, { signal: AbortSignal.timeout(timeoutMs) });
+    if (response.status !== 200) {
+        throw new BridgeSyncFailure(`Bridge health check at ${url} returned HTTP ${response.status}. ${LAUNCHER_HINT}`);
+    }
+    const health = parseBridgeHealth(await response.json());
+    if (!health)
+        throw new BridgeSyncFailure(`${url} did not answer as codex-chatgpt-web; check the provider's baseUrl.`);
+    return health;
+}
+async function fetchCatalog(io, sync, baseUrl) {
+    const token = await io.getCodexAccessToken();
+    if (!token) {
+        throw new BridgeSyncFailure(`The bridge forwards /v1/models to the Codex backend with your ChatGPT OAuth; ${LOGIN_HINT} first.`);
+    }
+    const response = await request(io, bridgeModelsUrl(baseUrl, sync.clientVersion), {
+        signal: AbortSignal.timeout(sync.timeoutMs),
+        headers: { authorization: `Bearer ${token}` },
+    });
+    if (response.status === 401 || response.status === 403) {
+        throw new BridgeSyncFailure(`The Codex backend rejected OMK's openai-codex OAuth token; ${LOGIN_HINT} again.`);
+    }
+    if (response.status !== 200) {
+        const body = await response.text();
+        throw new BridgeSyncFailure(`Bridge catalog request returned HTTP ${response.status}: ${body.slice(0, 300)}`);
+    }
+    const rows = parseBridgeCatalog(await response.json());
+    if (rows === undefined)
+        throw new BridgeSyncFailure("Bridge catalog response has no models array.");
+    if (rows.length === 0) {
+        throw new BridgeSyncFailure(`Bridge advertised no chatgpt-web/* models for client_version ${sync.clientVersion}; sign in to the launcher and press Install models.`);
+    }
+    return rows;
+}
+/**
+ * Run the sync. models.json is rewritten when a row changes or the recorded provenance no longer
+ * describes the bridge (its version, the client version, or a ceiling moved); `dryRun` only reports.
+ */
+export async function syncCodexChatGptWebProvider(sync, io) {
+    const provider = loadProvider(io, sync.modelsPath, sync.providerId);
+    const health = await checkHealth(io, provider.baseUrl, sync.timeoutMs);
+    const rows = await fetchCatalog(io, sync, provider.baseUrl);
+    const plan = planBridgeModelSync(provider.models, rows);
+    const bridgeCatalog = bridgeCatalogProvenance({ bridgeVersion: health.version, clientVersion: sync.clientVersion, syncedAt: io.now() }, rows);
+    const stale = hasBridgeSyncChanges(plan) || !provenanceMatches(provider.bridgeCatalog, bridgeCatalog);
+    const written = stale && !sync.dryRun;
+    if (written) {
+        const rewritten = rewriteProviderModels(provider.text, sync.providerId, { models: plan.models, bridgeCatalog });
+        if (rewritten === undefined)
+            throw new BridgeSyncFailure(`Could not rewrite ${sync.modelsPath}.`);
+        io.writeFile(sync.modelsPath, rewritten);
+    }
+    return {
+        modelsPath: sync.modelsPath,
+        baseUrl: provider.baseUrl,
+        health,
+        clientVersion: sync.clientVersion,
+        plan,
+        bridgeCatalog,
+        written,
+    };
+}
+//# sourceMappingURL=codex-chatgpt-web-sync.js.map

package/dist/core/codex-chatgpt-web-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-chatgpt-web-sync.js","sourceRoot":"","sources":["../../src/core/codex-chatgpt-web-sync.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * codex-chatgpt-web provider sync workflow: health check, account-aware catalog fetch, sync plan,\n * and the models.json rewrite. I/O arrives through `BridgeSyncIo`; expected failures are reported\n * as `BridgeSyncFailure` with a user-facing message that never carries a credential.\n */\n\nimport {\n\ttype BridgeCatalogProvenance,\n\ttype BridgeHealth,\n\ttype BridgeSyncPlan,\n\tbridgeCatalogProvenance,\n\tbridgeHealthUrl,\n\tbridgeModelsUrl,\n\tisCodexChatGptWebProvider,\n\ttype ModelsJsonModel,\n\tparseBridgeCatalog,\n\tparseBridgeHealth,\n\tplanBridgeModelSync,\n\tprovenanceMatches,\n\trewriteProviderModels,\n} from \"./codex-chatgpt-web-bridge.ts\";\n\nconst LAUNCHER_HINT =\n\t\"Start the Codex Web GPT launcher (it hosts the signed-in ChatGPT Web session and the local bridge), then retry.\";\nconst LOGIN_HINT = \"run /login openai-codex in OMK\";\n\ninterface BridgeSyncResponse {\n\treadonly status: number;\n\tjson(): Promise<unknown>;\n\ttext(): Promise<string>;\n}\n\ninterface BridgeSyncRequestInit {\n\treadonly signal: AbortSignal;\n\treadonly headers?: Readonly<Record<string, string>>;\n}\n\nexport interface BridgeSyncIo {\n\treadonly readFile: (path: string) => string;\n\treadonly writeFile: (path: string, text: string) => void;\n\treadonly fetch: (url: string, init: BridgeSyncRequestInit) => Promise<BridgeSyncResponse>;\n\treadonly getCodexAccessToken: () => Promise<string | undefined>;\n\t/** ISO timestamp for `bridgeCatalog.syncedAt`. */\n\treadonly now: () => string;\n}\n\nexport interface BridgeSyncRequest {\n\treadonly providerId: string;\n\treadonly modelsPath: string;\n\treadonly timeoutMs: number;\n\treadonly clientVersion: string;\n\treadonly dryRun: boolean;\n}\n\nexport interface BridgeSyncReport {\n\treadonly modelsPath: string;\n\treadonly baseUrl: string;\n\treadonly health: BridgeHealth;\n\treadonly clientVersion: string;\n\treadonly plan: BridgeSyncPlan;\n\treadonly bridgeCatalog: BridgeCatalogProvenance;\n\treadonly written: boolean;\n}\n\nexport class BridgeSyncFailure extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"BridgeSyncFailure\";\n\t}\n}\n\ninterface LoadedProvider {\n\treadonly text: string;\n\treadonly baseUrl: string;\n\treadonly models: readonly ModelsJsonModel[];\n\treadonly bridgeCatalog: unknown;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function hasBridgeSyncChanges(plan: BridgeSyncPlan): boolean {\n\treturn plan.changes.length + plan.added.length + plan.removed.length > 0;\n}\n\n/** Parse models.json once and narrow the target provider to the bridge shape this workflow can sync. */\nfunction loadProvider(io: BridgeSyncIo, path: string, providerId: string): LoadedProvider {\n\tconst text = io.readFile(path);\n\tlet document: unknown;\n\ttry {\n\t\tdocument = JSON.parse(text);\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError) throw new BridgeSyncFailure(`Could not read ${path}: ${error.message}`);\n\t\tthrow error;\n\t}\n\tconst provider = isRecord(document) && isRecord(document.providers) ? document.providers[providerId] : undefined;\n\tif (provider === undefined) throw new BridgeSyncFailure(`Provider \"${providerId}\" is not defined in ${path}.`);\n\tif (!isCodexChatGptWebProvider(provider)) {\n\t\tthrow new BridgeSyncFailure(\n\t\t\t`Provider \"${providerId}\" is not a codex-chatgpt-web bridge: provider sync supports openai-responses providers with compat.sendCodexTurnMetadata: true.`,\n\t\t);\n\t}\n\tif (typeof provider.baseUrl !== \"string\") throw new BridgeSyncFailure(`Provider \"${providerId}\" has no baseUrl.`);\n\tconst rows: readonly unknown[] = Array.isArray(provider.models) ? provider.models : [];\n\tconst models = rows.flatMap((model) =>\n\t\tisRecord(model) && typeof model.id === \"string\" ? [{ ...model, id: model.id }] : [],\n\t);\n\treturn { text, baseUrl: provider.baseUrl, models, bridgeCatalog: provider.bridgeCatalog };\n}\n\nasync function request(io: BridgeSyncIo, url: string, init: BridgeSyncRequestInit): Promise<BridgeSyncResponse> {\n\ttry {\n\t\treturn await io.fetch(url, init);\n\t} catch (error) {\n\t\tif (error instanceof Error) {\n\t\t\tthrow new BridgeSyncFailure(`Bridge request to ${url} failed (${error.message}). ${LAUNCHER_HINT}`);\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nasync function checkHealth(io: BridgeSyncIo, baseUrl: string, timeoutMs: number): Promise<BridgeHealth> {\n\tconst url = bridgeHealthUrl(baseUrl);\n\tconst response = await request(io, url, { signal: AbortSignal.timeout(timeoutMs) });\n\tif (response.status !== 200) {\n\t\tthrow new BridgeSyncFailure(`Bridge health check at ${url} returned HTTP ${response.status}. ${LAUNCHER_HINT}`);\n\t}\n\tconst health = parseBridgeHealth(await response.json());\n\tif (!health)\n\t\tthrow new BridgeSyncFailure(`${url} did not answer as codex-chatgpt-web; check the provider's baseUrl.`);\n\treturn health;\n}\n\nasync function fetchCatalog(io: BridgeSyncIo, sync: BridgeSyncRequest, baseUrl: string) {\n\tconst token = await io.getCodexAccessToken();\n\tif (!token) {\n\t\tthrow new BridgeSyncFailure(\n\t\t\t`The bridge forwards /v1/models to the Codex backend with your ChatGPT OAuth; ${LOGIN_HINT} first.`,\n\t\t);\n\t}\n\tconst response = await request(io, bridgeModelsUrl(baseUrl, sync.clientVersion), {\n\t\tsignal: AbortSignal.timeout(sync.timeoutMs),\n\t\theaders: { authorization: `Bearer ${token}` },\n\t});\n\tif (response.status === 401 || response.status === 403) {\n\t\tthrow new BridgeSyncFailure(`The Codex backend rejected OMK's openai-codex OAuth token; ${LOGIN_HINT} again.`);\n\t}\n\tif (response.status !== 200) {\n\t\tconst body = await response.text();\n\t\tthrow new BridgeSyncFailure(`Bridge catalog request returned HTTP ${response.status}: ${body.slice(0, 300)}`);\n\t}\n\tconst rows = parseBridgeCatalog(await response.json());\n\tif (rows === undefined) throw new BridgeSyncFailure(\"Bridge catalog response has no models array.\");\n\tif (rows.length === 0) {\n\t\tthrow new BridgeSyncFailure(\n\t\t\t`Bridge advertised no chatgpt-web/* models for client_version ${sync.clientVersion}; sign in to the launcher and press Install models.`,\n\t\t);\n\t}\n\treturn rows;\n}\n\n/**\n * Run the sync. models.json is rewritten when a row changes or the recorded provenance no longer\n * describes the bridge (its version, the client version, or a ceiling moved); `dryRun` only reports.\n */\nexport async function syncCodexChatGptWebProvider(\n\tsync: BridgeSyncRequest,\n\tio: BridgeSyncIo,\n): Promise<BridgeSyncReport> {\n\tconst provider = loadProvider(io, sync.modelsPath, sync.providerId);\n\tconst health = await checkHealth(io, provider.baseUrl, sync.timeoutMs);\n\tconst rows = await fetchCatalog(io, sync, provider.baseUrl);\n\tconst plan = planBridgeModelSync(provider.models, rows);\n\tconst bridgeCatalog = bridgeCatalogProvenance(\n\t\t{ bridgeVersion: health.version, clientVersion: sync.clientVersion, syncedAt: io.now() },\n\t\trows,\n\t);\n\tconst stale = hasBridgeSyncChanges(plan) || !provenanceMatches(provider.bridgeCatalog, bridgeCatalog);\n\tconst written = stale && !sync.dryRun;\n\tif (written) {\n\t\tconst rewritten = rewriteProviderModels(provider.text, sync.providerId, { models: plan.models, bridgeCatalog });\n\t\tif (rewritten === undefined) throw new BridgeSyncFailure(`Could not rewrite ${sync.modelsPath}.`);\n\t\tio.writeFile(sync.modelsPath, rewritten);\n\t}\n\treturn {\n\t\tmodelsPath: sync.modelsPath,\n\t\tbaseUrl: provider.baseUrl,\n\t\thealth,\n\t\tclientVersion: sync.clientVersion,\n\t\tplan,\n\t\tbridgeCatalog,\n\t\twritten,\n\t};\n}\n"]}

package/dist/core/compaction/compaction-headroom.d.ts

@@ -0,0 +1,30 @@
+export interface CompactionSettings {
+    enabled: boolean;
+    reserveTokens: number;
+    reservedOutputTokens?: number;
+    reservedToolResultTokens?: number;
+    safetyMarginTokens?: number;
+    imageReserveTokens?: number;
+    keepRecentTokens: number;
+    /** Maximum fraction of the context window to use before compaction. Default: 0.9. */
+    maxUsageRatio?: number;
+    rearmRatio?: number;
+    emergencyRatio?: number;
+}
+export declare const DEFAULT_COMPACTION_MAX_USAGE_RATIO = 0.9;
+export declare const DEFAULT_COMPACTION_SETTINGS: CompactionSettings;
+export type CompactionHeadroomLimit = "max_usage_ratio" | "reserve_tokens";
+export interface CompactionHeadroomThreshold {
+    triggerTokens: number;
+    headroomTokens: number;
+    maxUsageRatioTokens: number;
+    reserveBoundaryTokens: number;
+    limitedBy: CompactionHeadroomLimit;
+}
+/** Return the earliest compaction threshold from ratio-based headroom and absolute reserve. */
+export declare function getCompactionHeadroomThreshold(contextWindow: number, settings: CompactionSettings): CompactionHeadroomThreshold | undefined;
+/**
+ * Check if compaction should trigger based on context usage.
+ */
+export declare function shouldCompact(contextTokens: number, contextWindow: number, settings: CompactionSettings): boolean;
+//# sourceMappingURL=compaction-headroom.d.ts.map

package/dist/core/compaction/compaction-headroom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-headroom.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/compaction-headroom.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,eAAO,MAAM,2BAA2B,EAAE,kBAKzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAE3E,MAAM,WAAW,2BAA2B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,uBAAuB,CAAC;CACnC;AAED,+FAA+F;AAC/F,wBAAgB,8BAA8B,CAC7C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,kBAAkB,GAC1B,2BAA2B,GAAG,SAAS,CAkCzC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAGjH","sourcesContent":["import { computeReservedTokenBudget } from \"../context-budget-reserved-tokens.ts\";\n\nexport interface CompactionSettings {\n\tenabled: boolean;\n\treserveTokens: number;\n\treservedOutputTokens?: number;\n\treservedToolResultTokens?: number;\n\tsafetyMarginTokens?: number;\n\timageReserveTokens?: number;\n\tkeepRecentTokens: number;\n\t/** Maximum fraction of the context window to use before compaction. Default: 0.9. */\n\tmaxUsageRatio?: number;\n\trearmRatio?: number;\n\temergencyRatio?: number;\n}\n\nexport const DEFAULT_COMPACTION_MAX_USAGE_RATIO = 0.9;\n\nexport const DEFAULT_COMPACTION_SETTINGS: CompactionSettings = {\n\tenabled: true,\n\treserveTokens: 16384,\n\tkeepRecentTokens: 20000,\n\tmaxUsageRatio: DEFAULT_COMPACTION_MAX_USAGE_RATIO,\n};\n\nexport type CompactionHeadroomLimit = \"max_usage_ratio\" | \"reserve_tokens\";\n\nexport interface CompactionHeadroomThreshold {\n\ttriggerTokens: number;\n\theadroomTokens: number;\n\tmaxUsageRatioTokens: number;\n\treserveBoundaryTokens: number;\n\tlimitedBy: CompactionHeadroomLimit;\n}\n\n/** Return the earliest compaction threshold from ratio-based headroom and absolute reserve. */\nexport function getCompactionHeadroomThreshold(\n\tcontextWindow: number,\n\tsettings: CompactionSettings,\n): CompactionHeadroomThreshold | undefined {\n\tif (!settings.enabled || !Number.isFinite(contextWindow) || contextWindow <= 0) {\n\t\treturn undefined;\n\t}\n\n\tconst windowTokens = Math.floor(contextWindow);\n\tconst reserveTokens = Number.isFinite(settings.reserveTokens) ? Math.max(0, Math.floor(settings.reserveTokens)) : 0;\n\tconst configuredMaxUsageRatio = settings.maxUsageRatio ?? DEFAULT_COMPACTION_MAX_USAGE_RATIO;\n\tconst maxUsageRatio =\n\t\tNumber.isFinite(configuredMaxUsageRatio) && configuredMaxUsageRatio > 0 && configuredMaxUsageRatio < 1\n\t\t\t? configuredMaxUsageRatio\n\t\t\t: DEFAULT_COMPACTION_MAX_USAGE_RATIO;\n\tconst maxUsageRatioTokens = Math.max(1, Math.floor(windowTokens * maxUsageRatio));\n\tconst reservedBudget = computeReservedTokenBudget({\n\t\tmodelContextWindow: windowTokens,\n\t\tsystemPromptTokens: 0,\n\t\treservedOutputTokens: settings.reservedOutputTokens ?? reserveTokens,\n\t\treservedToolResultTokens: settings.reservedToolResultTokens ?? 0,\n\t\tsafetyMarginTokens: settings.safetyMarginTokens ?? 0,\n\t\timageReserveTokens: settings.imageReserveTokens ?? 0,\n\t});\n\tconst reserveBoundaryTokens =\n\t\treservedBudget.overflow || reservedBudget.effectiveBudget === 0\n\t\t\t? maxUsageRatioTokens\n\t\t\t: Math.max(1, reservedBudget.effectiveBudget);\n\tconst triggerTokens = Math.min(maxUsageRatioTokens, reserveBoundaryTokens);\n\n\treturn {\n\t\ttriggerTokens,\n\t\theadroomTokens: windowTokens - triggerTokens,\n\t\tmaxUsageRatioTokens,\n\t\treserveBoundaryTokens,\n\t\tlimitedBy: reserveBoundaryTokens <= maxUsageRatioTokens ? \"reserve_tokens\" : \"max_usage_ratio\",\n\t};\n}\n\n/**\n * Check if compaction should trigger based on context usage.\n */\nexport function shouldCompact(contextTokens: number, contextWindow: number, settings: CompactionSettings): boolean {\n\tconst threshold = getCompactionHeadroomThreshold(contextWindow, settings);\n\treturn threshold !== undefined && Number.isFinite(contextTokens) && contextTokens >= threshold.triggerTokens;\n}\n"]}