@tickernelz/paperclip-pro-adapter-codex-local 2026.925.0

package/dist/server/process-activity-monitor.test.js

@@ -0,0 +1,82 @@
+import { describe, expect, it, vi } from "vitest";
+import { createCodexProcessActivityMonitor, } from "./process-activity-monitor.js";
+class PollHarness {
+    callback = null;
+    setTimer = (callback) => {
+        this.callback = callback;
+        return callback;
+    };
+    clearTimer = () => {
+        this.callback = null;
+    };
+    async poll() {
+        await vi.waitFor(() => expect(this.callback).not.toBeNull());
+        const callback = this.callback;
+        this.callback = null;
+        callback?.();
+    }
+}
+function snapshot(cpuTicks, ioBytes, processIds = "100") {
+    return { cpuTicks, ioBytes, processIds };
+}
+describe("createCodexProcessActivityMonitor", () => {
+    it("requires a baseline and ignores sub-threshold CPU changes", async () => {
+        const samples = [snapshot(100, 1_000), snapshot(114, 1_000)];
+        const harness = new PollHarness();
+        const onActivity = vi.fn();
+        const monitor = createCodexProcessActivityMonitor({
+            pid: 100,
+            processGroupId: 100,
+            intervalMs: 15_000,
+            sample: async () => samples.shift() ?? null,
+            setTimer: harness.setTimer,
+            clearTimer: harness.clearTimer,
+            onActivity,
+        });
+        await harness.poll();
+        await vi.waitFor(() => expect(onActivity).not.toHaveBeenCalled());
+        monitor.stop();
+    });
+    it.each([
+        ["CPU growth", snapshot(115, 1_000)],
+        ["I/O growth", snapshot(100, 1_001)],
+        ["process-group churn", snapshot(100, 1_000, "100,101")],
+    ])("reports %s as process activity", async (_label, activeSnapshot) => {
+        const samples = [snapshot(100, 1_000), activeSnapshot];
+        const harness = new PollHarness();
+        const onActivity = vi.fn();
+        const monitor = createCodexProcessActivityMonitor({
+            pid: 100,
+            processGroupId: 100,
+            intervalMs: 15_000,
+            sample: async () => samples.shift() ?? null,
+            setTimer: harness.setTimer,
+            clearTimer: harness.clearTimer,
+            onActivity,
+        });
+        await harness.poll();
+        await vi.waitFor(() => expect(onActivity).toHaveBeenCalledTimes(1));
+        monitor.stop();
+    });
+    it("resets its comparison baseline after an unavailable sample", async () => {
+        const samples = [snapshot(100, 1_000), null, snapshot(200, 2_000), snapshot(215, 2_000)];
+        const harness = new PollHarness();
+        const onActivity = vi.fn();
+        const monitor = createCodexProcessActivityMonitor({
+            pid: 100,
+            processGroupId: 100,
+            intervalMs: 15_000,
+            sample: async () => samples.shift() ?? null,
+            setTimer: harness.setTimer,
+            clearTimer: harness.clearTimer,
+            onActivity,
+        });
+        await harness.poll();
+        await harness.poll();
+        await vi.waitFor(() => expect(onActivity).not.toHaveBeenCalled());
+        await harness.poll();
+        await vi.waitFor(() => expect(onActivity).toHaveBeenCalledTimes(1));
+        monitor.stop();
+    });
+});
+//# sourceMappingURL=process-activity-monitor.test.js.map

package/dist/server/process-activity-monitor.test.js.map

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

package/dist/server/quota-spawn-error.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=quota-spawn-error.test.d.ts.map

package/dist/server/quota-spawn-error.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-spawn-error.test.d.ts","sourceRoot":"","sources":["../../src/server/quota-spawn-error.test.ts"],"names":[],"mappings":""}

package/dist/server/quota-spawn-error.test.js

@@ -0,0 +1,174 @@
+import { EventEmitter } from "node:events";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
+const { mockSpawn } = vi.hoisted(() => ({
+    mockSpawn: vi.fn(),
+}));
+vi.mock("node:child_process", async (importOriginal) => {
+    const cp = await importOriginal();
+    return {
+        ...cp,
+        spawn: (...args) => mockSpawn(...args),
+    };
+});
+import { fetchCodexQuota, getQuotaWindows } from "./quota.js";
+function createChildThatErrorsOnMicrotask(err) {
+    const child = new EventEmitter();
+    const stream = Object.assign(new EventEmitter(), {
+        setEncoding: () => { },
+    });
+    Object.assign(child, {
+        stdout: stream,
+        stderr: Object.assign(new EventEmitter(), { setEncoding: () => { } }),
+        stdin: { write: vi.fn(), end: vi.fn() },
+        kill: vi.fn(),
+    });
+    queueMicrotask(() => {
+        child.emit("error", err);
+    });
+    return child;
+}
+describe("CodexRpcClient spawn failures", () => {
+    let previousCodexHome;
+    let isolatedCodexHome;
+    beforeEach(() => {
+        mockSpawn.mockReset();
+        // After the RPC path fails, getQuotaWindows() calls readCodexToken() which
+        // reads $CODEX_HOME/auth.json (default ~/.codex). Point CODEX_HOME at an
+        // empty temp directory so we never hit real host auth or the WHAM network.
+        previousCodexHome = process.env.CODEX_HOME;
+        isolatedCodexHome = fs.mkdtempSync(path.join(os.tmpdir(), "paperclip-codex-spawn-test-"));
+        process.env.CODEX_HOME = isolatedCodexHome;
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        if (isolatedCodexHome) {
+            try {
+                fs.rmSync(isolatedCodexHome, { recursive: true, force: true });
+            }
+            catch {
+                /* ignore */
+            }
+            isolatedCodexHome = undefined;
+        }
+        if (previousCodexHome === undefined) {
+            delete process.env.CODEX_HOME;
+        }
+        else {
+            process.env.CODEX_HOME = previousCodexHome;
+        }
+    });
+    it("classifies app-server refresh-token failures as quota probe auth errors", async () => {
+        mockSpawn.mockImplementation(() => createChildThatErrorsOnMicrotask(new Error("OAuth failed: refresh token has expired")));
+        const result = await getQuotaWindows();
+        expect(result.ok).toBe(false);
+        expect(result.source).toBe("codex-rpc");
+        expect(result.errorFamily).toBe("refresh_token_expired");
+        expect(result.error).toContain("Codex app-server");
+    });
+    it("falls back to WHAM after an app-server refresh-token failure", async () => {
+        fs.writeFileSync(path.join(isolatedCodexHome, "auth.json"), JSON.stringify({
+            tokens: {
+                access_token: "access-token-fixture-secret",
+                refresh_token: "refresh-token-fixture-secret",
+            },
+        }), "utf8");
+        mockSpawn.mockImplementation(() => createChildThatErrorsOnMicrotask(new Error("OAuth failed: refresh token has expired")));
+        vi.stubGlobal("fetch", vi.fn(async () => new Response(JSON.stringify({
+            rate_limit: {
+                primary_window: { used_percent: 0.5, reset_at: 1_711_111_111 },
+            },
+        }), { status: 200, headers: { "content-type": "application/json" } })));
+        const result = await getQuotaWindows();
+        expect(result.ok).toBe(true);
+        expect(result.source).toBe("codex-wham");
+        expect(result.errorFamily).toBeUndefined();
+        expect(result.windows).toEqual([
+            expect.objectContaining({
+                label: "5h limit",
+                usedPercent: 50,
+                resetsAt: "2024-03-22T12:38:31.000Z",
+            }),
+        ]);
+    });
+    it("classifies WHAM refresh-token response bodies without returning the body text", async () => {
+        fs.writeFileSync(path.join(isolatedCodexHome, "auth.json"), JSON.stringify({
+            tokens: {
+                access_token: "access-token-fixture-secret",
+                refresh_token: "refresh-token-fixture-secret",
+            },
+        }), "utf8");
+        mockSpawn.mockImplementation(() => createChildThatErrorsOnMicrotask(new Error("spawn codex ENOENT")));
+        vi.stubGlobal("fetch", vi.fn(async () => new Response("OAuth failed: invalid_grant", { status: 401 })));
+        const result = await getQuotaWindows();
+        expect(result.ok).toBe(false);
+        expect(result.source).toBe("codex-wham");
+        expect(result.errorFamily).toBe("refresh_token_invalidated");
+        expect(result.error).toContain("chatgpt wham api returned 401");
+        expect(result.error).not.toContain("invalid_grant");
+        expect(JSON.stringify(result)).not.toContain("access-token-fixture-secret");
+        expect(JSON.stringify(result)).not.toContain("refresh-token-fixture-secret");
+    });
+    it("limits WHAM error response buffering before classifying auth failures", async () => {
+        const encoder = new TextEncoder();
+        const totalChunks = 20;
+        let pullCount = 0;
+        let cancelled = false;
+        const body = new ReadableStream({
+            pull(controller) {
+                pullCount += 1;
+                if (pullCount > totalChunks) {
+                    controller.close();
+                    return;
+                }
+                const text = pullCount === 1
+                    ? `OAuth failed: invalid_grant ${"x".repeat(1_024)}`
+                    : "x".repeat(1_024);
+                controller.enqueue(encoder.encode(text));
+            },
+            cancel() {
+                cancelled = true;
+            },
+        });
+        vi.stubGlobal("fetch", vi.fn(async () => new Response(body, { status: 401 })));
+        await expect(fetchCodexQuota("access-token-fixture-secret", null)).rejects.toMatchObject({
+            name: "CodexQuotaAuthError",
+            errorFamily: "refresh_token_invalidated",
+        });
+        expect(pullCount).toBeLessThan(totalChunks);
+        expect(cancelled).toBe(true);
+    });
+    it("does not classify bare WHAM 401 quota probe failures or expose token material", async () => {
+        fs.writeFileSync(path.join(isolatedCodexHome, "auth.json"), JSON.stringify({
+            tokens: {
+                access_token: "access-token-fixture-secret",
+                refresh_token: "refresh-token-fixture-secret",
+            },
+        }), "utf8");
+        mockSpawn.mockImplementation(() => createChildThatErrorsOnMicrotask(new Error("spawn codex ENOENT")));
+        vi.stubGlobal("fetch", vi.fn(async () => new Response("unauthorized", { status: 401 })));
+        const result = await getQuotaWindows();
+        expect(result.ok).toBe(false);
+        expect(result.errorFamily).toBeUndefined();
+        expect(result.error).toContain("chatgpt wham api returned 401");
+        expect(JSON.stringify(result)).not.toContain("access-token-fixture-secret");
+        expect(JSON.stringify(result)).not.toContain("refresh-token-fixture-secret");
+    });
+    it("does not crash the process when codex is missing; getQuotaWindows returns ok: false", async () => {
+        const enoent = Object.assign(new Error("spawn codex ENOENT"), {
+            code: "ENOENT",
+            errno: -2,
+            syscall: "spawn codex",
+            path: "codex",
+        });
+        mockSpawn.mockImplementation(() => createChildThatErrorsOnMicrotask(enoent));
+        const result = await getQuotaWindows();
+        expect(result.ok).toBe(false);
+        expect(result.windows).toEqual([]);
+        expect(result.error).toContain("Codex app-server");
+        expect(result.error).toContain("spawn codex ENOENT");
+    });
+});
+//# sourceMappingURL=quota-spawn-error.test.js.map

package/dist/server/quota-spawn-error.test.js.map

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

package/dist/server/quota.d.ts

@@ -0,0 +1,66 @@
+import type { ProviderQuotaResult, QuotaWindow } from "@tickernelz/paperclip-pro-adapter-utils";
+import { type CodexAuthRefreshFailureClass } from "./parse.js";
+export declare function codexHomeDir(): string;
+export interface CodexAuthInfo {
+    accessToken: string;
+    accountId: string | null;
+    refreshToken: string | null;
+    idToken: string | null;
+    email: string | null;
+    planType: string | null;
+    lastRefresh: string | null;
+}
+export declare function readCodexAuthInfo(codexHome?: string): Promise<CodexAuthInfo | null>;
+export declare function readCodexToken(): Promise<{
+    token: string;
+    accountId: string | null;
+} | null>;
+/**
+ * Map a window duration in seconds to a human-readable label.
+ * Falls back to the provided fallback string when seconds is null/undefined.
+ */
+export declare function secondsToWindowLabel(seconds: number | null | undefined, fallback: string): string;
+/** fetch with an abort-based timeout so a hanging provider api doesn't block the response indefinitely */
+export declare function fetchWithTimeout(url: string, init: RequestInit, ms?: number): Promise<Response>;
+export declare function fetchCodexQuota(token: string, accountId: string | null): Promise<QuotaWindow[]>;
+interface CodexRpcWindow {
+    usedPercent?: number | null;
+    windowDurationMins?: number | null;
+    resetsAt?: number | null;
+}
+interface CodexRpcCredits {
+    hasCredits?: boolean | null;
+    unlimited?: boolean | null;
+    balance?: string | number | null;
+}
+interface CodexRpcLimit {
+    limitId?: string | null;
+    limitName?: string | null;
+    primary?: CodexRpcWindow | null;
+    secondary?: CodexRpcWindow | null;
+    credits?: CodexRpcCredits | null;
+    planType?: string | null;
+}
+interface CodexRpcRateLimitsResult {
+    rateLimits?: CodexRpcLimit | null;
+    rateLimitsByLimitId?: Record<string, CodexRpcLimit> | null;
+}
+interface CodexRpcAccountResult {
+    account?: {
+        type?: string | null;
+        email?: string | null;
+        planType?: string | null;
+    } | null;
+    requiresOpenaiAuth?: boolean | null;
+}
+export interface CodexRpcQuotaSnapshot {
+    windows: QuotaWindow[];
+    email: string | null;
+    planType: string | null;
+}
+export declare function mapCodexRpcQuota(result: CodexRpcRateLimitsResult, account?: CodexRpcAccountResult | null): CodexRpcQuotaSnapshot;
+export declare function fetchCodexRpcQuota(): Promise<CodexRpcQuotaSnapshot>;
+export declare function readCodexQuotaErrorFamily(error: unknown): CodexAuthRefreshFailureClass | null;
+export declare function getQuotaWindows(): Promise<ProviderQuotaResult>;
+export {};
+//# sourceMappingURL=quota.d.ts.map

package/dist/server/quota.d.ts.map

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