@bitkyc08/opencodex 2.5.6 → 2.6.0

package/src/usage-debug.ts

@@ -0,0 +1,65 @@
+import { appendFileSync, chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { getConfigDir } from "./config";
+import type { OcxUsage } from "./types";
+
+export const USAGE_DEBUG_ENV = "OPENCODEX_USAGE_DEBUG";
+export const USAGE_DEBUG_BODY_SAMPLE_BYTES = 2048;
+export const USAGE_DEBUG_MAX_LINES = 200;
+export const USAGE_DEBUG_KEEP_LINES = 100;
+
+export type UsageDebugBodyKind = "sse" | "json" | "other" | "none";
+
+export interface UsageDebugRecord {
+  ts: number;
+  requestId: string;
+  provider: string;
+  model: string;
+  upstreamContentType: string | null;
+  upstreamStatus: number;
+  bodyKind: UsageDebugBodyKind;
+  bodySample: string;
+  extractedUsage: OcxUsage | null;
+}
+
+export function isUsageDebugEnabled(): boolean {
+  return process.env[USAGE_DEBUG_ENV] === "1";
+}
+
+export function usageDebugPath(): string {
+  return join(getConfigDir(), "usage-debug.jsonl");
+}
+
+export function truncateForDebug(text: string, max = USAGE_DEBUG_BODY_SAMPLE_BYTES): string {
+  if (text.length <= max) return text;
+  const cut = text.slice(0, max);
+  const remaining = text.length - max;
+  return `${cut}... [+${remaining} more]`;
+}
+
+function ensureUsageDebugDir(): void {
+  const dir = getConfigDir();
+  mkdirSync(dir, { recursive: true, mode: 0o700 });
+  try { chmodSync(dir, 0o700); } catch { /* best-effort */ }
+}
+
+function trimRollingFile(path: string): void {
+  const text = readFileSync(path, "utf-8");
+  const lines = text.split(/\r?\n/).filter(line => line.length > 0);
+  if (lines.length <= USAGE_DEBUG_MAX_LINES) return;
+  const kept = lines.slice(-USAGE_DEBUG_KEEP_LINES).join("\n") + "\n";
+  writeFileSync(path, kept, { encoding: "utf-8", mode: 0o600 });
+  try { chmodSync(path, 0o600); } catch { /* best-effort */ }
+}
+
+export function appendUsageDebug(record: UsageDebugRecord): void {
+  try {
+    ensureUsageDebugDir();
+    const path = usageDebugPath();
+    appendFileSync(path, `${JSON.stringify(record)}\n`, { encoding: "utf-8", mode: 0o600 });
+    try { chmodSync(path, 0o600); } catch { /* best-effort */ }
+    if (existsSync(path)) trimRollingFile(path);
+  } catch {
+    /* debug capture must never break the proxy */
+  }
+}

package/src/usage-log.ts

@@ -0,0 +1,62 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+import { getConfigDir } from "./config";
+import type { OcxUsage } from "./types";
+
+export type UsageStatus = "reported" | "unreported" | "unsupported" | "estimated";
+
+export interface PersistedUsageEntry {
+  requestId: string;
+  timestamp: number;
+  provider: string;
+  model: string;
+  resolvedModel?: string;
+  status: number;
+  durationMs: number;
+  usageStatus: UsageStatus;
+  usage?: OcxUsage;
+  totalTokens?: number;
+}
+
+export function usageLogPath(): string {
+  return join(getConfigDir(), "usage.jsonl");
+}
+
+export function usageTotalTokens(usage: OcxUsage | undefined): number | undefined {
+  if (!usage) return undefined;
+  return usage.inputTokens + usage.outputTokens;
+}
+
+export function usageStatusForFinalLog(usage: OcxUsage | undefined): UsageStatus {
+  return usage ? "reported" : "unreported";
+}
+
+function ensureUsageLogDir(): void {
+  const dir = getConfigDir();
+  mkdirSync(dir, { recursive: true, mode: 0o700 });
+  try { chmodSync(dir, 0o700); } catch { /* best-effort on platforms that ignore chmod */ }
+}
+
+export function appendUsageEntry(entry: PersistedUsageEntry): void {
+  ensureUsageLogDir();
+  const path = usageLogPath();
+  appendFileSync(path, `${JSON.stringify(entry)}\n`, { encoding: "utf-8", mode: 0o600 });
+  try { chmodSync(path, 0o600); } catch { /* best-effort on platforms that ignore chmod */ }
+}
+
+export function readUsageEntries(): PersistedUsageEntry[] {
+  const path = usageLogPath();
+  if (!existsSync(path)) return [];
+  const lines = readFileSync(path, "utf-8").split(/\r?\n/);
+  const entries: PersistedUsageEntry[] = [];
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    try {
+      const parsed = JSON.parse(line) as PersistedUsageEntry;
+      if (parsed && typeof parsed === "object" && typeof parsed.requestId === "string") entries.push(parsed);
+    } catch {
+      /* keep reading after a partially written or hand-edited line */
+    }
+  }
+  return entries;
+}

package/src/ws-bridge.ts

@@ -17,8 +17,8 @@ const SAFE_RESPONSE_HEADER_EXACT = new Set([
 ]);
 
 export interface WsData {
-  headers?: Headers; // selected inbound upgrade headers only; never store full cookies/handshake internals
-  authContext?: CodexAuthContext; // immutable account decision made at upgrade time
+  headers?: Headers; // base inbound forward headers only; per-turn auth refresh injects current pool tokens
+  authContext?: CodexAuthContext; // last resolved account decision for observability/registry cleanup
   cancel?: () => void; // cancels the in-flight stream reader/fetch
   turnId?: number; // monotonically increasing per socket; prevents stale frames after replacement turns
 }

package/gui/README.md

@@ -1,73 +0,0 @@
-# React + TypeScript + Vite
-
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
-
-Currently, two official plugins are available:
-
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
-
-## React Compiler
-
-The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
-
-## Expanding the ESLint configuration
-
-If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
-
-```js
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-
-      // Remove tseslint.configs.recommended and replace with this
-      tseslint.configs.recommendedTypeChecked,
-      // Alternatively, use this for stricter rules
-      tseslint.configs.strictTypeChecked,
-      // Optionally, add this for stylistic rules
-      tseslint.configs.stylisticTypeChecked,
-
-      // Other configs...
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
-```
-
-You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
-
-```js
-// eslint.config.js
-import reactX from 'eslint-plugin-react-x'
-import reactDom from 'eslint-plugin-react-dom'
-
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-      // Enable lint rules for React
-      reactX.configs['recommended-typescript'],
-      // Enable lint rules for React DOM
-      reactDom.configs.recommended,
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
-```