opencode-openai-multi-auth 5.0.0

package/dist/lib/types.d.ts

@@ -0,0 +1,167 @@
+import type { Auth, Provider, Model } from "@opencode-ai/sdk";
+/**
+ * Plugin configuration from ~/.opencode/openai-codex-auth-config.json
+ */
+export interface PluginConfig {
+    /**
+     * Enable CODEX_MODE (Codex-OpenCode bridge prompt instead of tool remap)
+     * @default true
+     */
+    codexMode?: boolean;
+}
+/**
+ * User configuration structure from opencode.json
+ */
+export interface UserConfig {
+    global: ConfigOptions;
+    models: {
+        [modelName: string]: {
+            options?: ConfigOptions;
+            variants?: Record<string, (ConfigOptions & {
+                disabled?: boolean;
+            }) | undefined>;
+            [key: string]: unknown;
+        };
+    };
+}
+/**
+ * Configuration options for reasoning and text settings
+ */
+export interface ConfigOptions {
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    reasoningSummary?: "auto" | "concise" | "detailed" | "off" | "on";
+    textVerbosity?: "low" | "medium" | "high";
+    include?: string[];
+}
+/**
+ * Reasoning configuration for requests
+ */
+export interface ReasoningConfig {
+    effort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    summary: "auto" | "concise" | "detailed" | "off" | "on";
+}
+/**
+ * OAuth server information
+ */
+export interface OAuthServerInfo {
+    port: number;
+    ready: boolean;
+    close: () => void;
+    waitForCode: (state: string) => Promise<{
+        code: string;
+    } | null>;
+}
+/**
+ * PKCE challenge and verifier
+ */
+export interface PKCEPair {
+    challenge: string;
+    verifier: string;
+}
+/**
+ * Authorization flow result
+ */
+export interface AuthorizationFlow {
+    pkce: PKCEPair;
+    state: string;
+    url: string;
+}
+/**
+ * Token exchange success result
+ */
+export interface TokenSuccess {
+    type: "success";
+    access: string;
+    refresh: string;
+    expires: number;
+}
+/**
+ * Token exchange failure result
+ */
+export interface TokenFailure {
+    type: "failed";
+}
+/**
+ * Token exchange result
+ */
+export type TokenResult = TokenSuccess | TokenFailure;
+/**
+ * Parsed authorization input
+ */
+export interface ParsedAuthInput {
+    code?: string;
+    state?: string;
+}
+/**
+ * JWT payload with ChatGPT account info
+ */
+export interface JWTPayload {
+    "https://api.openai.com/auth"?: {
+        chatgpt_account_id?: string;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Message input item
+ */
+export interface InputItem {
+    id?: string;
+    type: string;
+    role: string;
+    content?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Request body structure
+ */
+export interface RequestBody {
+    model: string;
+    store?: boolean;
+    stream?: boolean;
+    instructions?: string;
+    input?: InputItem[];
+    tools?: unknown;
+    reasoning?: Partial<ReasoningConfig>;
+    text?: {
+        verbosity?: "low" | "medium" | "high";
+    };
+    include?: string[];
+    providerOptions?: {
+        openai?: Partial<ConfigOptions> & {
+            store?: boolean;
+            include?: string[];
+        };
+        [key: string]: unknown;
+    };
+    /** Stable key to enable prompt-token caching on Codex backend */
+    prompt_cache_key?: string;
+    max_output_tokens?: number;
+    max_completion_tokens?: number;
+    [key: string]: unknown;
+}
+/**
+ * SSE event data structure
+ */
+export interface SSEEventData {
+    type: string;
+    response?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Cache metadata for Codex instructions
+ */
+export interface CacheMetadata {
+    etag: string | null;
+    tag: string;
+    lastChecked: number;
+    url: string;
+}
+/**
+ * GitHub release data
+ */
+export interface GitHubRelease {
+    tag_name: string;
+    [key: string]: unknown;
+}
+export type { Auth, Provider, Model };
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

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

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../lib/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "opencode-openai-multi-auth",
+  "version": "5.0.0",
+  "description": "OpenAI ChatGPT OAuth plugin for opencode with multi-account rotation on rate limits",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "license": "MIT",
+  "author": "Numman Ali",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dkraemerwork/opencode-openai-multi-auth.git"
+  },
+  "keywords": [
+    "opencode",
+    "openai",
+    "codex",
+    "chatgpt",
+    "oauth",
+    "gpt-5",
+    "plugin",
+    "auth",
+    "multi-account",
+    "rate-limit",
+    "rotation"
+  ],
+  "homepage": "https://github.com/dkraemerwork/opencode-openai-multi-auth#readme",
+  "bugs": {
+    "url": "https://github.com/dkraemerwork/opencode-openai-multi-auth/issues"
+  },
+  "scripts": {
+    "build": "tsc && cp lib/oauth-success.html dist/lib/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage"
+  },
+  "bin": {
+    "opencode-openai-multi-auth": "./scripts/install-opencode-codex-auth.js"
+  },
+  "files": [
+    "dist/",
+    "assets/",
+    "config/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.0.150"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.0.150",
+    "@opencode-ai/sdk": "^1.0.150",
+    "@types/node": "^24.6.2",
+    "@vitest/ui": "^3.2.4",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@openauthjs/openauth": "^0.4.3",
+    "hono": "^4.10.4",
+    "jsonc-parser": "^3.3.1"
+  },
+  "overrides": {
+    "hono": "^4.10.4",
+    "vite": "^7.1.12"
+  }
+}

package/scripts/install-opencode-codex-auth.js

@@ -0,0 +1,430 @@
+#!/usr/bin/env node
+
+import { existsSync } from "node:fs";
+import { readFile, writeFile, mkdir, copyFile, rm } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { parse, modify, applyEdits, printParseErrorCode } from "jsonc-parser";
+
+const PLUGIN_NAME = "opencode-openai-multi-auth";
+const args = new Set(process.argv.slice(2));
+
+if (args.has("--help") || args.has("-h")) {
+	console.log(`Usage: ${PLUGIN_NAME} [--modern|--legacy] [--uninstall] [--all] [--dry-run] [--no-cache-clear]\n\n` +
+		"Default behavior:\n" +
+		"  - Installs/updates global config at ~/.config/opencode/opencode.jsonc (falls back to .json)\n" +
+		"  - Uses modern config (variants) by default\n" +
+		"  - Ensures plugin is unpinned (latest)\n" +
+		"  - Clears OpenCode plugin cache\n\n" +
+		"Options:\n" +
+		"  --modern           Force modern config (default)\n" +
+		"  --legacy           Use legacy config (older OpenCode versions)\n" +
+		"  --uninstall        Remove plugin + OpenAI config entries from global config\n" +
+		"  --all              With --uninstall, also remove tokens, logs, and cached instructions\n" +
+		"  --dry-run          Show actions without writing\n" +
+		"  --no-cache-clear   Skip clearing OpenCode cache\n"
+	);
+	process.exit(0);
+}
+
+const useLegacy = args.has("--legacy");
+const useModern = args.has("--modern") || !useLegacy;
+const uninstallRequested = args.has("--uninstall") || args.has("--all");
+const uninstallAll = args.has("--all");
+const dryRun = args.has("--dry-run");
+const skipCacheClear = args.has("--no-cache-clear");
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(scriptDir, "..");
+const templatePath = join(
+	repoRoot,
+	"config",
+	useLegacy ? "opencode-legacy.json" : "opencode-modern.json"
+);
+
+const configDir = join(homedir(), ".config", "opencode");
+const configPathJson = join(configDir, "opencode.json");
+const configPathJsonc = join(configDir, "opencode.jsonc");
+const cacheDir = join(homedir(), ".cache", "opencode");
+const cacheNodeModules = join(cacheDir, "node_modules", PLUGIN_NAME);
+const cacheBunLock = join(cacheDir, "bun.lock");
+const cachePackageJson = join(cacheDir, "package.json");
+const opencodeAuthPath = join(homedir(), ".opencode", "auth", "openai.json");
+const pluginConfigPath = join(
+	homedir(),
+	".opencode",
+	"openai-codex-auth-config.json",
+);
+const pluginLogDir = join(homedir(), ".opencode", "logs", "codex-plugin");
+const opencodeCacheDir = join(homedir(), ".opencode", "cache");
+
+function log(message) {
+	console.log(message);
+}
+
+function normalizePluginList(list) {
+	const entries = Array.isArray(list) ? list.filter(Boolean) : [];
+	const filtered = entries.filter((entry) => {
+		if (typeof entry !== "string") return true;
+		return entry !== PLUGIN_NAME && !entry.startsWith(`${PLUGIN_NAME}@`);
+	});
+	return [...filtered, PLUGIN_NAME];
+}
+
+function removePluginEntries(list) {
+	const entries = Array.isArray(list) ? list.filter(Boolean) : [];
+	return entries.filter((entry) => {
+		if (typeof entry !== "string") return true;
+		if (entry === PLUGIN_NAME || entry.startsWith(`${PLUGIN_NAME}@`)) {
+			return false;
+		}
+		return !entry.includes(PLUGIN_NAME);
+	});
+}
+
+function mergeOpenAIConfig(existingOpenAI, templateOpenAI) {
+	const existing = existingOpenAI && typeof existingOpenAI === "object"
+		? existingOpenAI
+		: {};
+	const template = templateOpenAI && typeof templateOpenAI === "object"
+		? templateOpenAI
+		: {};
+	const existingOptions =
+		existing.options && typeof existing.options === "object"
+			? existing.options
+			: {};
+	const templateOptions =
+		template.options && typeof template.options === "object"
+			? template.options
+			: {};
+	const existingModels =
+		existing.models && typeof existing.models === "object"
+			? existing.models
+			: {};
+	const templateModels =
+		template.models && typeof template.models === "object"
+			? template.models
+			: {};
+
+	return {
+		...existing,
+		...template,
+		options: { ...existingOptions, ...templateOptions },
+		models: { ...existingModels, ...templateModels },
+	};
+}
+
+async function getKnownModelIds() {
+	const legacyTemplate = await readJson(
+		join(repoRoot, "config", "opencode-legacy.json"),
+	);
+	const modernTemplate = await readJson(
+		join(repoRoot, "config", "opencode-modern.json"),
+	);
+	const legacyModels = Object.keys(
+		legacyTemplate?.provider?.openai?.models || {},
+	);
+	const modernModels = Object.keys(
+		modernTemplate?.provider?.openai?.models || {},
+	);
+	return new Set([...legacyModels, ...modernModels]);
+}
+
+function formatJson(obj) {
+	return `${JSON.stringify(obj, null, 2)}\n`;
+}
+
+const JSONC_PARSE_OPTIONS = { allowTrailingComma: true, disallowComments: false };
+const JSONC_FORMAT_OPTIONS = { insertSpaces: true, tabSize: 2, eol: "\n" };
+
+function resolveConfigPath() {
+	if (existsSync(configPathJsonc)) {
+		return configPathJsonc;
+	}
+	if (existsSync(configPathJson)) {
+		return configPathJson;
+	}
+	return configPathJsonc;
+}
+
+async function readJson(filePath) {
+	const content = await readFile(filePath, "utf-8");
+	return JSON.parse(content);
+}
+
+async function readJsonc(filePath) {
+	const content = await readFile(filePath, "utf-8");
+	const errors = [];
+	const data = parse(content, errors, JSONC_PARSE_OPTIONS);
+	if (errors.length) {
+		const formatted = errors
+			.map((error) => printParseErrorCode(error.error))
+			.join(", ");
+		throw new Error(`Invalid JSONC (${formatted})`);
+	}
+	return { content, data: data ?? {} };
+}
+
+function applyJsoncUpdates(content, updates) {
+	let next = content;
+	for (const update of updates) {
+		const edits = modify(next, update.path, update.value, {
+			formattingOptions: JSONC_FORMAT_OPTIONS,
+		});
+		next = applyEdits(next, edits);
+	}
+	return next.endsWith("\n") ? next : `${next}\n`;
+}
+
+async function backupConfig(sourcePath) {
+	const timestamp = new Date()
+		.toISOString()
+		.replace(/[:.]/g, "-")
+		.replace("T", "_")
+		.replace("Z", "");
+	const backupPath = `${sourcePath}.bak-${timestamp}`;
+	if (!dryRun) {
+		await copyFile(sourcePath, backupPath);
+	}
+	return backupPath;
+}
+
+async function removePluginFromCachePackage() {
+	if (!existsSync(cachePackageJson)) {
+		return;
+	}
+
+	let cacheData;
+	try {
+		cacheData = await readJson(cachePackageJson);
+	} catch (error) {
+		log(`Warning: Could not parse ${cachePackageJson} (${error}). Skipping.`);
+		return;
+	}
+
+	const sections = [
+		"dependencies",
+		"devDependencies",
+		"peerDependencies",
+		"optionalDependencies",
+	];
+
+	let changed = false;
+	for (const section of sections) {
+		const deps = cacheData?.[section];
+		if (deps && typeof deps === "object" && PLUGIN_NAME in deps) {
+			delete deps[PLUGIN_NAME];
+			changed = true;
+		}
+	}
+
+	if (!changed) {
+		return;
+	}
+
+	if (dryRun) {
+		log(`[dry-run] Would update ${cachePackageJson} to remove ${PLUGIN_NAME}`);
+		return;
+	}
+
+	await writeFile(cachePackageJson, formatJson(cacheData), "utf-8");
+}
+
+async function clearCache() {
+	if (skipCacheClear) {
+		log("Skipping cache clear (--no-cache-clear).");
+		return;
+	}
+
+	if (dryRun) {
+		log(`[dry-run] Would remove ${cacheNodeModules}`);
+		log(`[dry-run] Would remove ${cacheBunLock}`);
+	} else {
+		await rm(cacheNodeModules, { recursive: true, force: true });
+		await rm(cacheBunLock, { force: true });
+	}
+
+	await removePluginFromCachePackage();
+}
+
+async function clearPluginArtifacts() {
+	if (dryRun) {
+		log(`[dry-run] Would remove ${opencodeAuthPath}`);
+		log(`[dry-run] Would remove ${pluginConfigPath}`);
+		log(`[dry-run] Would remove ${pluginLogDir}`);
+	} else {
+		await rm(opencodeAuthPath, { force: true });
+		await rm(pluginConfigPath, { force: true });
+		await rm(pluginLogDir, { recursive: true, force: true });
+	}
+
+	const cacheFiles = [
+		"codex-instructions.md",
+		"codex-instructions-meta.json",
+		"codex-max-instructions.md",
+		"codex-max-instructions-meta.json",
+		"gpt-5.1-instructions.md",
+		"gpt-5.1-instructions-meta.json",
+		"gpt-5.2-instructions.md",
+		"gpt-5.2-instructions-meta.json",
+		"gpt-5.2-codex-instructions.md",
+		"gpt-5.2-codex-instructions-meta.json",
+		"opencode-codex.txt",
+		"opencode-codex-meta.json",
+	];
+
+	for (const file of cacheFiles) {
+		const target = join(opencodeCacheDir, file);
+		if (dryRun) {
+			log(`[dry-run] Would remove ${target}`);
+		} else {
+			await rm(target, { force: true });
+		}
+	}
+}
+
+async function main() {
+	if (!existsSync(templatePath)) {
+		throw new Error(`Config template not found at ${templatePath}`);
+	}
+
+	const configPath = resolveConfigPath();
+	const configExists = existsSync(configPath);
+
+	if (uninstallRequested) {
+		if (!configExists) {
+			log("No existing config found. Nothing to uninstall.");
+		} else {
+			const backupPath = await backupConfig(configPath);
+			log(`${dryRun ? "[dry-run] Would create backup" : "Backup created"}: ${backupPath}`);
+
+			try {
+				const { content, data } = await readJsonc(configPath);
+				const existing = data ?? {};
+				const pluginList = removePluginEntries(existing.plugin);
+
+				const provider =
+					existing.provider && typeof existing.provider === "object"
+						? { ...existing.provider }
+						: {};
+				const openai =
+					provider.openai && typeof provider.openai === "object"
+						? { ...provider.openai }
+						: {};
+
+				const knownModelIds = await getKnownModelIds();
+				const existingModels =
+					openai.models && typeof openai.models === "object"
+						? { ...openai.models }
+						: {};
+				for (const modelId of knownModelIds) {
+					delete existingModels[modelId];
+				}
+
+				if (Object.keys(existingModels).length > 0) {
+					openai.models = existingModels;
+				} else {
+					delete openai.models;
+				}
+
+				if (Object.keys(openai).length > 0) {
+					provider.openai = openai;
+				} else {
+					delete provider.openai;
+				}
+
+				const updates = [];
+				if (pluginList.length > 0) {
+					updates.push({ path: ["plugin"], value: pluginList });
+				} else {
+					updates.push({ path: ["plugin"], value: undefined });
+				}
+
+				if (Object.keys(provider).length > 0) {
+					updates.push({ path: ["provider"], value: provider });
+				} else {
+					updates.push({ path: ["provider"], value: undefined });
+				}
+
+				if (dryRun) {
+					log(`[dry-run] Would write ${configPath} (uninstall)`);
+				} else {
+					const nextContent = applyJsoncUpdates(content, updates);
+					await writeFile(configPath, nextContent, "utf-8");
+					log(`Updated ${configPath} (plugin removed)`);
+				}
+			} catch (error) {
+				log(`Warning: Could not parse existing config (${error}). Skipping config update.`);
+			}
+		}
+
+		await clearCache();
+		if (uninstallAll) {
+			await clearPluginArtifacts();
+		}
+
+		log("\nDone. Restart OpenCode.");
+		return;
+	}
+
+	const template = await readJson(templatePath);
+	template.plugin = [PLUGIN_NAME];
+
+	let nextConfig = template;
+	let nextContent = null;
+
+	if (configExists) {
+		const backupPath = await backupConfig(configPath);
+		log(`${dryRun ? "[dry-run] Would create backup" : "Backup created"}: ${backupPath}`);
+
+		try {
+			const { content, data } = await readJsonc(configPath);
+			const existing = data ?? {};
+			const merged = { ...existing };
+			merged.plugin = normalizePluginList(existing.plugin);
+			const provider =
+				existing.provider && typeof existing.provider === "object"
+					? { ...existing.provider }
+					: {};
+			provider.openai = mergeOpenAIConfig(provider.openai, template.provider.openai);
+			merged.provider = provider;
+			nextConfig = merged;
+
+			nextContent = applyJsoncUpdates(content, [
+				{ path: ["plugin"], value: merged.plugin },
+				{ path: ["provider", "openai"], value: merged.provider.openai },
+			]);
+		} catch (error) {
+			log(`Warning: Could not parse existing config (${error}). Replacing with template.`);
+			nextConfig = template;
+		}
+	} else {
+		log("No existing config found. Creating new global config.");
+	}
+
+	if (dryRun) {
+		log(`[dry-run] Would write ${configPath} using ${useLegacy ? "legacy" : "modern"} config`);
+	} else {
+		await mkdir(configDir, { recursive: true });
+		if (nextContent && configExists) {
+			await writeFile(configPath, nextContent, "utf-8");
+		} else {
+			await writeFile(configPath, formatJson(nextConfig), "utf-8");
+		}
+		log(`Wrote ${configPath} (${useLegacy ? "legacy" : "modern"} config)`);
+	}
+
+	await clearCache();
+
+	log("\nDone. Restart OpenCode to (re)install the plugin.");
+	log("Example: opencode");
+	if (useLegacy) {
+		log("Note: Legacy config requires OpenCode v1.0.209 or older.");
+	}
+}
+
+main().catch((error) => {
+	console.error(`Installer failed: ${error instanceof Error ? error.message : error}`);
+	process.exit(1);
+});