@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
131 lines (117 loc) • 4.85 kB
text/typescript
export const spillCounters = {
writes: 0, writeFailures: 0, readFailures: 0,
aclRetryReturnedTimeouts: 0, aclTimeoutMemoRefusals: 0,
capacityRefusals: 0, headroomEvictions: 0,
};
/** Test-only: zero every spill counter, including ones added later. */
export function resetSpillCountersForTests(): void {
for (const key of Object.keys(spillCounters) as Array<keyof typeof spillCounters>) spillCounters[key] = 0;
}
export type ResponseSpillWriteFailureCode =
| "EACLRETRYEXHAUSTED"
| "ETIMEDOUT"
| "EACCES"
| "ENOSPC"
| "EFBIG"
| "EIO"
| "ECAPACITY"
| "ELOOP"
| "EUNKNOWN";
export type ResponseSpillWriteStatus = "initial" | "healthy" | "degraded";
export type ResponseSpillWriteFailureOrigin =
| "retry_returned_timeout"
| "timeout_memo_refusal";
interface ResponseSpillWriteHealth {
consecutiveFailures: number;
lastFailureCode: ResponseSpillWriteFailureCode | null;
lastFailureOrigin: ResponseSpillWriteFailureOrigin | null;
lastFailureAt: number | null;
lastSuccessAt: number | null;
}
export const spillWriteHealth: ResponseSpillWriteHealth = {
consecutiveFailures: 0,
lastFailureCode: null,
lastFailureOrigin: null,
lastFailureAt: null,
lastSuccessAt: null,
};
/**
* Collapse filesystem/runtime errors into a fixed privacy-safe diagnostic union.
* Messages and paths are deliberately ignored: this projection is returned by the
* authenticated memory endpoint, and a nested `cause` can contain a username or
* workspace path even when the public wrapper does not.
*/
function classifySpillWriteFailure(error: unknown): ResponseSpillWriteFailureCode {
let cursor = error;
for (let depth = 0; depth < 4 && cursor && typeof cursor === "object"; depth += 1) {
const record = cursor as { code?: unknown; cause?: unknown };
const code = typeof record.code === "string" ? record.code.toUpperCase() : "";
switch (code) {
case "EACLRETRYEXHAUSTED": return "EACLRETRYEXHAUSTED";
case "ETIMEDOUT": return "ETIMEDOUT";
case "EACCES":
case "EPERM": return "EACCES";
case "ENOSPC":
case "EDQUOT": return "ENOSPC";
case "EFBIG": return "EFBIG";
case "EIO": return "EIO";
case "ECAPACITY": return "ECAPACITY";
case "ELOOP": return "ELOOP";
}
cursor = record.cause;
}
return "EUNKNOWN";
}
/** The spill writer preserves ACL errors in cause; only a fixed memo marker is diagnostic. */
export function spillAclMemoRefusalOrigin(error: unknown): "timeout_memo_refusal" | null {
let cursor = error;
for (let depth = 0; depth < 4 && cursor && typeof cursor === "object"; depth += 1) {
const record = cursor as { code?: unknown; aclFailureOrigin?: unknown; cause?: unknown };
if ((record.code === "ETIMEDOUT" || record.code === "EACLRETRYEXHAUSTED")
&& record.aclFailureOrigin === "timeout_memo_refusal") {
return "timeout_memo_refusal";
}
cursor = record.cause;
}
return null;
}
export function noteSpillWriteSuccess(): void {
spillCounters.writes += 1;
spillWriteHealth.consecutiveFailures = 0;
spillWriteHealth.lastSuccessAt = Date.now();
}
export function noteSpillWriteFailure(
error: unknown,
override?: ResponseSpillWriteFailureCode,
retryOrigin: ResponseSpillWriteFailureOrigin | null = null,
): void {
const code = override ?? classifySpillWriteFailure(error);
const origin = code === "ETIMEDOUT" || code === "EACLRETRYEXHAUSTED"
? spillAclMemoRefusalOrigin(error) ?? retryOrigin
: null;
spillCounters.writeFailures += 1;
spillWriteHealth.consecutiveFailures += 1;
spillWriteHealth.lastFailureCode = code;
spillWriteHealth.lastFailureOrigin = origin;
spillWriteHealth.lastFailureAt = Date.now();
// Count terminal publications, not ACL calls or a transient first attempt.
if (origin === "retry_returned_timeout") spillCounters.aclRetryReturnedTimeouts += 1;
else if (origin === "timeout_memo_refusal") spillCounters.aclTimeoutMemoRefusals += 1;
}
/** A publication refused because the durable spill cap could not make room for it (#6747). */
export function noteSpillCapacityRefusal(): void {
spillCounters.capacityRefusals += 1;
noteSpillWriteFailure(null, "ECAPACITY");
}
/**
* Admission-boundary observability (test-visible). directSpills: oversized
* candidates routed straight to durable spill without a resident stay or
* unrelated demotion. oversizedDrops: candidates above the single-spill
* payload ceiling, tombstoned instead of retained. snapshotOversizedRefusals:
* snapshot files refused before parse.
*/
export const admissionCounters = { directSpills: 0, oversizedDrops: 0, snapshotOversizedRefusals: 0 };
/** Test-only: admission-boundary counters (proves the new paths fire). */
export function responseAdmissionCountersForTests(): Readonly<typeof admissionCounters> {
return admissionCounters;
}