@bastani/atomic 0.9.11-alpha.4 → 0.9.11-alpha.6

package/dist/builtin/cursor/README.md

@@ -1,24 +0,0 @@
-# @bastani/cursor
-
-First-party Atomic provider for Cursor subscription models.
-
-## Status
-
-This package registers `cursor` via Atomic's bundled extension provider API. `/login` shows **Cursor (Experimental)** and stores credentials through Atomic OAuth storage (`~/.atomic/agent/auth.json`). The login URL and PKCE polling behavior intentionally match the MIT-licensed [`ndraiman/pi-cursor-provider`](https://github.com/ndraiman/pi-cursor-provider) reference: `callbacks.onAuth({ url: loginUrl })`, no extra login warning/instruction copy, and polling `api2.cursor.sh/auth/poll` until Cursor returns tokens.
-
-The runtime protocol is also aligned to `ndraiman/pi-cursor-provider` at commit `82fc4e73f9ae820d87b34ac36713b18989910a36`: Atomic vendors the reference `cursor-models-raw.json` and generated `proto/agent_pb.ts`, and builds Cursor request/control messages through `@bufbuild/protobuf` descriptors instead of hand-maintained protobuf bytes. HTTP/2 itself is handled by the generated `@bastani/atomic-natives` Rust/N-API package rather than a separate local proxy.
-
-The unavoidable Atomic-specific integration difference is the provider surface: Atomic exposes a native `cursor-agent` `streamSimple` provider instead of the reference package's localhost OpenAI-compatible proxy. The Cursor auth/model/protocol bytes should otherwise stay reference-derived.
-
-## Limitations
-
-- Image input is supported only for known multimodal Cursor Claude, Composer, Gemini, GPT, and Kimi model families (IDs beginning `claude-`, `composer-`, `gemini-`, `gpt-`, or `kimi-`), plus `grok-4.3`; text-only Cursor models still reject images.
-- User images and mixed text/image MCP tool results are serialized for image-capable Cursor models. Image payloads must be non-empty standard base64; MIME-style line wrapping whitespace is accepted and stripped before serialization.
-- Cursor's private API may change without notice.
-- HTTP/2 transport requires the bundled `@bastani/atomic-natives` Rust/N-API native client for the current platform.
-- Credentials are OAuth-only. Do not pass Cursor tokens via command-line args, environment variables, logs, or local proxy processes.
-- Cursor's private `GetUsableModels` response omits context-window and output-token limits. Atomic preserves positive limits when present and otherwise resolves them from Atomic's bundled `@earendil-works/pi-ai` model catalog by matching the Cursor model ID's family/version, falling back to a conservative 200k context / 64k output estimate for Cursor-only models without a pi-ai match. Cursor IDs or labels that explicitly say `1M` keep a 1,000,000-token context floor even when the nearest reference match advertises a smaller base window. Limit resolution never adds or removes models from the list.
-
-## Attribution
-
-Cursor auth, model fallback, and generated protobuf behavior are derived from the MIT-licensed `ndraiman/pi-cursor-provider` project.

package/dist/builtin/cursor/index.ts

@@ -1,9 +0,0 @@
-export { default } from "./src/provider.js";
-export { registerCursorProvider, type CursorProviderConfig, type CursorProviderHost, type CursorProviderRegistrationOptions, type CursorProviderRuntime } from "./src/provider.js";
-export { CursorAuthError, CursorAuthService, CursorToken, createPkcePair, deriveCursorTokenExpiry, fromOAuthCredentials, redactOAuthCredentials, toOAuthCredentials } from "./src/auth.js";
-export { CursorModelDiscoveryError, CursorModelDiscoveryService } from "./src/models.js";
-export { FileCursorCatalogCache, getDefaultCursorCatalogCachePath, parseCursorCatalogCacheRecord, toCursorCatalogCacheRecord, type CursorCatalogCache } from "./src/catalog-cache.js";
-export { createEstimatedCursorCatalog, insertEffortBeforeCursorSuffix, mapCursorCatalogToProviderModels, parseCursorVariant, resolveCursorModelVariant } from "./src/model-mapper.js";
-export { CursorConversationStateStore } from "./src/conversation-state.js";
-export { CursorStreamAdapter, createCursorStreamAdapter } from "./src/stream.js";
-export { Http2CursorAgentTransport } from "./src/transport.js";

package/dist/builtin/cursor/package.json

@@ -1,47 +0,0 @@
-{
-  "name": "@bastani/cursor",
-  "version": "0.9.11-alpha.4",
-  "private": true,
-  "description": "Experimental first-party Atomic extension for Cursor OAuth, model discovery, and streaming provider registration.",
-  "contributors": [
-    "Norin Lavaee",
-    "Alex Lavaee"
-  ],
-  "license": "MIT",
-  "type": "module",
-  "engines": {
-    "bun": ">=1.3.14"
-  },
-  "main": "./index.ts",
-  "types": "./index.ts",
-  "exports": {
-    ".": "./index.ts"
-  },
-  "files": [
-    "index.ts",
-    "src/**/*.ts",
-    "src/**/*.json",
-    "src/proto/README.md",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
-  "peerDependencies": {
-    "@bastani/atomic": "*"
-  },
-  "peerDependenciesMeta": {
-    "@bastani/atomic": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "@bastani/atomic-natives": "0.9.11-alpha.4",
-    "@bufbuild/protobuf": "^2.12.1",
-    "@earendil-works/pi-ai": "^0.81.1"
-  }
-}

package/dist/builtin/cursor/src/auth.ts

@@ -1,352 +0,0 @@
-import type { OAuthCredentials, OAuthLoginCallbacks } from "@earendil-works/pi-ai/compat";
-import { createHash, randomBytes as nodeRandomBytes, randomUUID } from "node:crypto";
-import {
-	CURSOR_API_BASE_URL,
-	CURSOR_AUTH_POLL_PATH,
-	CURSOR_DEFAULT_TOKEN_TTL_MS,
-	CURSOR_OAUTH_EXPIRY_SKEW_MS,
-	CURSOR_REFRESH_PATH,
-	CURSOR_WEB_BASE_URL,
-	CURSOR_LOGIN_PATH,
-	parseJsonObject,
-	readStringField,
-	readNumberField,
-	sanitizeDiagnosticText,
-} from "./config.js";
-
-export type CursorAuthErrorCode =
-	| "LoginCancelled"
-	| "PollTimedOut"
-	| "PollRejected"
-	| "RefreshTokenExpired"
-	| "CursorApiRejected"
-	| "NetworkError";
-
-export class CursorAuthError extends Error {
-	constructor(
-		readonly code: CursorAuthErrorCode,
-		message: string,
-		readonly status?: number,
-	) {
-		super(message);
-		this.name = "CursorAuthError";
-	}
-}
-
-export class CursorToken {
-	readonly kind: "access" | "refresh";
-	readonly #value: string;
-
-	constructor(kind: "access" | "refresh", value: string) {
-		this.kind = kind;
-		this.#value = value;
-	}
-
-	unwrap(): string {
-		return this.#value;
-	}
-
-	toString(): string {
-		return `[redacted cursor ${this.kind} token]`;
-	}
-
-	toJSON(): string {
-		return this.toString();
-	}
-}
-
-export interface CursorCredentialBundle {
-	readonly access: CursorToken;
-	readonly refresh: CursorToken;
-	readonly expires: number;
-}
-
-export interface CursorPkcePair {
-	readonly verifier: string;
-	readonly challenge: string;
-}
-
-export type CursorFetch = (url: string, init?: RequestInit) => Promise<Response>;
-export type CursorSleep = (milliseconds: number, signal?: AbortSignal) => Promise<void>;
-export type CursorUuid = () => string;
-export type CursorRandomBytes = (length: number) => Uint8Array;
-export type CursorNow = () => number;
-
-export interface CursorAuthServiceOptions {
-	readonly fetch?: CursorFetch;
-	readonly sleep?: CursorSleep;
-	readonly uuid?: CursorUuid;
-	readonly randomBytes?: CursorRandomBytes;
-	readonly now?: CursorNow;
-	readonly maxPollAttempts?: number;
-	readonly initialPollDelayMs?: number;
-	readonly maxPollDelayMs?: number;
-	readonly pollBackoffMultiplier?: number;
-	readonly fetchTimeoutMs?: number;
-	readonly apiBaseUrl?: string;
-	readonly webBaseUrl?: string;
-}
-
-interface CursorTokenResponse {
-	readonly accessToken: string;
-	readonly refreshToken: string;
-}
-
-const DEFAULT_MAX_POLL_ATTEMPTS = 150;
-const DEFAULT_INITIAL_POLL_DELAY_MS = 1000;
-const DEFAULT_MAX_POLL_DELAY_MS = 10000;
-const DEFAULT_POLL_BACKOFF_MULTIPLIER = 1.2;
-const DEFAULT_FETCH_TIMEOUT_MS = 30_000;
-
-export function base64Url(bytes: Uint8Array): string {
-	return Buffer.from(bytes).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/u, "");
-}
-
-export function createPkcePair(randomBytes: CursorRandomBytes = defaultRandomBytes): CursorPkcePair {
-	const verifier = base64Url(randomBytes(96));
-	const challenge = createHash("sha256").update(verifier).digest("base64url");
-	return { verifier, challenge };
-}
-
-export function toOAuthCredentials(bundle: CursorCredentialBundle): OAuthCredentials {
-	return {
-		access: bundle.access.unwrap(),
-		refresh: bundle.refresh.unwrap(),
-		expires: bundle.expires,
-	};
-}
-
-export function fromOAuthCredentials(credentials: OAuthCredentials): CursorCredentialBundle {
-	return {
-		access: new CursorToken("access", credentials.access),
-		refresh: new CursorToken("refresh", credentials.refresh),
-		expires: credentials.expires,
-	};
-}
-
-export function redactOAuthCredentials(credentials: OAuthCredentials): OAuthCredentials {
-	return {
-		access: "[redacted]",
-		refresh: "[redacted]",
-		expires: credentials.expires,
-	};
-}
-
-export function deriveCursorTokenExpiry(accessToken: string, now: CursorNow = Date.now): number {
-	const parts = accessToken.split(".");
-	if (parts.length < 2 || !parts[1]) {
-		return now() + CURSOR_DEFAULT_TOKEN_TTL_MS;
-	}
-
-	try {
-		const payload = Buffer.from(parts[1], "base64url").toString("utf8");
-		const parsed = parseJsonObject(payload);
-		if (!parsed) {
-			return now() + CURSOR_DEFAULT_TOKEN_TTL_MS;
-		}
-		const exp = readNumberField(parsed, "exp");
-		return exp ? exp * 1000 - CURSOR_OAUTH_EXPIRY_SKEW_MS : now() + CURSOR_DEFAULT_TOKEN_TTL_MS;
-	} catch {
-		return now() + CURSOR_DEFAULT_TOKEN_TTL_MS;
-	}
-}
-
-export class CursorAuthService {
-	readonly #fetch: CursorFetch;
-	readonly #sleep: CursorSleep;
-	readonly #uuid: CursorUuid;
-	readonly #randomBytes: CursorRandomBytes;
-	readonly #now: CursorNow;
-	readonly #maxPollAttempts: number;
-	readonly #initialPollDelayMs: number;
-	readonly #maxPollDelayMs: number;
-	readonly #pollBackoffMultiplier: number;
-	readonly #fetchTimeoutMs: number;
-	readonly #apiBaseUrl: string;
-	readonly #webBaseUrl: string;
-
-	constructor(options: CursorAuthServiceOptions = {}) {
-		this.#fetch = options.fetch ?? fetch;
-		this.#sleep = options.sleep ?? sleep;
-		this.#uuid = options.uuid ?? randomUUID;
-		this.#randomBytes = options.randomBytes ?? defaultRandomBytes;
-		this.#now = options.now ?? Date.now;
-		this.#maxPollAttempts = options.maxPollAttempts ?? DEFAULT_MAX_POLL_ATTEMPTS;
-		this.#initialPollDelayMs = options.initialPollDelayMs ?? DEFAULT_INITIAL_POLL_DELAY_MS;
-		this.#maxPollDelayMs = options.maxPollDelayMs ?? DEFAULT_MAX_POLL_DELAY_MS;
-		this.#pollBackoffMultiplier = options.pollBackoffMultiplier ?? DEFAULT_POLL_BACKOFF_MULTIPLIER;
-		this.#fetchTimeoutMs = options.fetchTimeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;
-		this.#apiBaseUrl = options.apiBaseUrl ?? CURSOR_API_BASE_URL;
-		this.#webBaseUrl = options.webBaseUrl ?? CURSOR_WEB_BASE_URL;
-	}
-
-	async login(callbacks: OAuthLoginCallbacks): Promise<OAuthCredentials> {
-		const bundle = await this.loginCursor(callbacks);
-		return toOAuthCredentials(bundle);
-	}
-
-	async loginCursor(callbacks: OAuthLoginCallbacks): Promise<CursorCredentialBundle> {
-		const { verifier, challenge } = createPkcePair(this.#randomBytes);
-		const uuid = this.#uuid();
-		const loginUrl = new URL(CURSOR_LOGIN_PATH, this.#webBaseUrl);
-		loginUrl.searchParams.set("challenge", challenge);
-		loginUrl.searchParams.set("uuid", uuid);
-		loginUrl.searchParams.set("mode", "login");
-		loginUrl.searchParams.set("redirectTarget", "cli");
-		callbacks.onAuth({ url: loginUrl.toString() });
-
-		let delayMs = this.#initialPollDelayMs;
-		let consecutiveErrors = 0;
-		for (let attempt = 0; attempt < this.#maxPollAttempts; attempt += 1) {
-			await this.#sleep(delayMs, callbacks.signal);
-			if (callbacks.signal?.aborted) {
-				throw new CursorAuthError("LoginCancelled", "Cursor login was cancelled.");
-			}
-
-			const pollUrl = new URL(CURSOR_AUTH_POLL_PATH, this.#apiBaseUrl);
-			pollUrl.searchParams.set("uuid", uuid);
-			pollUrl.searchParams.set("verifier", verifier);
-
-			let response: Response;
-			try {
-				response = await this.fetchWithDeadline(pollUrl.toString(), { method: "GET" }, callbacks.signal);
-			} catch {
-				if (callbacks.signal?.aborted) throw new CursorAuthError("LoginCancelled", "Cursor login was cancelled.");
-				consecutiveErrors += 1;
-				if (consecutiveErrors >= 3) {
-					throw new CursorAuthError("NetworkError", "Cursor login polling failed after repeated network errors.");
-				}
-				delayMs = Math.min(this.#maxPollDelayMs, Math.ceil(delayMs * this.#pollBackoffMultiplier));
-				continue;
-			}
-
-			if (response.status === 404) {
-				consecutiveErrors = 0;
-				delayMs = Math.min(this.#maxPollDelayMs, Math.ceil(delayMs * this.#pollBackoffMultiplier));
-				continue;
-			}
-
-			if (!response.ok) {
-				consecutiveErrors += 1;
-				if (consecutiveErrors >= 3) {
-					const responseText = await response.text();
-					throw new CursorAuthError(
-						"PollRejected",
-						`Cursor login polling was rejected (${response.status}): ${sanitizeDiagnosticText(responseText, [verifier, uuid, pollUrl.toString()])}`,
-						response.status,
-					);
-				}
-				delayMs = Math.min(this.#maxPollDelayMs, Math.ceil(delayMs * this.#pollBackoffMultiplier));
-				continue;
-			}
-
-			const tokenResponse = parseTokenResponse(await response.text());
-			if (!tokenResponse || tokenResponse.refreshToken.length === 0) {
-				throw new CursorAuthError("PollRejected", "Cursor login response did not include usable tokens.", response.status);
-			}
-
-			return {
-				access: new CursorToken("access", tokenResponse.accessToken),
-				refresh: new CursorToken("refresh", tokenResponse.refreshToken),
-				expires: deriveCursorTokenExpiry(tokenResponse.accessToken, this.#now),
-			};
-		}
-
-		throw new CursorAuthError("PollTimedOut", "Cursor login timed out before authorization completed.");
-	}
-
-	async refreshToken(credentials: OAuthCredentials): Promise<OAuthCredentials> {
-		const bundle = await this.refreshCursorCredentials(fromOAuthCredentials(credentials));
-		return toOAuthCredentials(bundle);
-	}
-
-	async refreshCursorCredentials(credentials: CursorCredentialBundle): Promise<CursorCredentialBundle> {
-		const refresh = credentials.refresh.unwrap();
-		let response: Response;
-		try {
-			response = await this.fetchWithDeadline(new URL(CURSOR_REFRESH_PATH, this.#apiBaseUrl).toString(), {
-				method: "POST",
-				headers: {
-					Authorization: `Bearer ${refresh}`,
-					"Content-Type": "application/json",
-				},
-				body: "{}",
-			});
-		} catch {
-			throw new CursorAuthError("NetworkError", "Cursor token refresh failed because the network request failed.");
-		}
-
-		if (response.status === 401 || response.status === 403) {
-			throw new CursorAuthError("RefreshTokenExpired", "Cursor refresh token expired or was rejected; run /login again.", response.status);
-		}
-		if (!response.ok) {
-			const responseText = await response.text();
-			throw new CursorAuthError(
-				"CursorApiRejected",
-				`Cursor token refresh failed (${response.status}): ${sanitizeDiagnosticText(responseText, [refresh])}`,
-				response.status,
-			);
-		}
-
-		const tokenResponse = parseTokenResponse(await response.text());
-		if (!tokenResponse) {
-			throw new CursorAuthError("CursorApiRejected", "Cursor token refresh response did not include an access token.", response.status);
-		}
-		return {
-			access: new CursorToken("access", tokenResponse.accessToken),
-			refresh: new CursorToken("refresh", tokenResponse.refreshToken || refresh),
-			expires: deriveCursorTokenExpiry(tokenResponse.accessToken, this.#now),
-		};
-	}
-
-	private async fetchWithDeadline(url: string, init: RequestInit, parentSignal?: AbortSignal): Promise<Response> {
-		const controller = new AbortController();
-		let timeout: ReturnType<typeof setTimeout> | undefined;
-		const timeoutPromise = new Promise<never>((_, reject) => {
-			timeout = setTimeout(() => {
-				controller.abort();
-				reject(new CursorAuthError("NetworkError", "Cursor authentication request timed out."));
-			}, this.#fetchTimeoutMs);
-			timeout.unref?.();
-		});
-		const onAbort = (): void => controller.abort();
-		parentSignal?.addEventListener("abort", onAbort, { once: true });
-		try {
-			return await Promise.race([this.#fetch(url, { ...init, signal: controller.signal }), timeoutPromise]);
-		} finally {
-			if (timeout) clearTimeout(timeout);
-			parentSignal?.removeEventListener("abort", onAbort);
-		}
-	}
-}
-
-function parseTokenResponse(text: string): CursorTokenResponse | undefined {
-	const parsed = parseJsonObject(text);
-	if (!parsed) return undefined;
-	const accessToken = readStringField(parsed, "accessToken") ?? readStringField(parsed, "access_token");
-	const refreshToken = readStringField(parsed, "refreshToken") ?? readStringField(parsed, "refresh_token") ?? "";
-	if (!accessToken) return undefined;
-	return { accessToken, refreshToken };
-}
-
-function defaultRandomBytes(length: number): Uint8Array {
-	return nodeRandomBytes(length);
-}
-
-function sleep(milliseconds: number, signal?: AbortSignal): Promise<void> {
-	if (signal?.aborted) {
-		return Promise.reject(new CursorAuthError("LoginCancelled", "Cursor login was cancelled."));
-	}
-	return new Promise((resolve, reject) => {
-		const abort = (): void => {
-			clearTimeout(timer);
-			signal?.removeEventListener("abort", abort);
-			reject(new CursorAuthError("LoginCancelled", "Cursor login was cancelled."));
-		};
-		const timer = setTimeout(() => {
-			signal?.removeEventListener("abort", abort);
-			resolve();
-		}, milliseconds);
-		signal?.addEventListener("abort", abort, { once: true });
-	});
-}

package/dist/builtin/cursor/src/catalog-cache.ts

@@ -1,155 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import type { CursorModelCatalog, CursorUsableModel } from "./model-mapper.js";
-
-export const CURSOR_CATALOG_CACHE_VERSION = 1;
-export const CURSOR_CATALOG_CACHE_FILENAME = "cursor-model-catalog.json";
-
-export interface CursorCatalogCacheRecord {
-	readonly version: typeof CURSOR_CATALOG_CACHE_VERSION;
-	readonly fetchedAt: number;
-	readonly models: readonly CursorUsableModel[];
-}
-
-export interface CursorCatalogCache {
-	load(): CursorModelCatalog | null;
-	save(catalog: CursorModelCatalog): void;
-}
-
-export class FileCursorCatalogCache implements CursorCatalogCache {
-	readonly #path: string;
-
-	constructor(path = getDefaultCursorCatalogCachePath()) {
-		this.#path = path;
-	}
-
-	get path(): string {
-		return this.#path;
-	}
-
-	load(): CursorModelCatalog | null {
-		if (!existsSync(this.#path)) return null;
-		try {
-			return parseCursorCatalogCacheRecord(JSON.parse(readFileSync(this.#path, "utf8")));
-		} catch {
-			return null;
-		}
-	}
-
-	save(catalog: CursorModelCatalog): void {
-		const record = toCursorCatalogCacheRecord(catalog);
-		if (!record) return;
-		mkdirSync(dirname(this.#path), { recursive: true });
-		const tmpPath = `${this.#path}.${process.pid}.${randomUUID()}.tmp`;
-		try {
-			writeFileSync(tmpPath, `${JSON.stringify(record, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
-			renameSync(tmpPath, this.#path);
-		} catch (error) {
-			try {
-				rmSync(tmpPath, { force: true });
-			} catch {
-				// Ignore cleanup errors; preserve the original write/rename failure.
-			}
-			throw error;
-		}
-	}
-}
-
-export function getDefaultCursorCatalogCachePath(): string {
-	return join(getDefaultAtomicAgentDir(), CURSOR_CATALOG_CACHE_FILENAME);
-}
-
-export function parseCursorCatalogCacheRecord(value: unknown): CursorModelCatalog | null {
-	if (!isRecord(value)) return null;
-	if (value.version !== CURSOR_CATALOG_CACHE_VERSION) return null;
-	if (typeof value.fetchedAt !== "number" || !Number.isFinite(value.fetchedAt) || value.fetchedAt < 0) return null;
-	if (!Array.isArray(value.models)) return null;
-	const models = value.models.map(parseCachedCursorModel).filter((model): model is CursorUsableModel => model !== null);
-	if (models.length === 0) return null;
-	return { source: "live", fetchedAt: value.fetchedAt, models };
-}
-
-export function toCursorCatalogCacheRecord(catalog: CursorModelCatalog): CursorCatalogCacheRecord | null {
-	if (catalog.source !== "live") return null;
-	if (typeof catalog.fetchedAt !== "number" || !Number.isFinite(catalog.fetchedAt) || catalog.fetchedAt < 0) return null;
-	const models = catalog.models.map(parseCachedCursorModel).filter((model): model is CursorUsableModel => model !== null);
-	if (models.length === 0) return null;
-	return { version: CURSOR_CATALOG_CACHE_VERSION, fetchedAt: catalog.fetchedAt, models };
-}
-
-function parseCachedCursorModel(value: unknown): CursorUsableModel | null {
-	if (!isRecord(value)) return null;
-	const id = readRequiredString(value, "id");
-	if (!id) return null;
-	const name = readOptionalString(value, "name");
-	const displayName = readOptionalString(value, "displayName");
-	const contextWindow = readOptionalPositiveNumber(value, "contextWindow");
-	const maxTokens = readOptionalPositiveNumber(value, "maxTokens");
-	const supportsReasoning = readOptionalBoolean(value, "supportsReasoning");
-	const supportsThinking = readOptionalBoolean(value, "supportsThinking");
-	if (
-		name === false ||
-		displayName === false ||
-		contextWindow === false ||
-		maxTokens === false ||
-		supportsReasoning === false ||
-		supportsThinking === false
-	) {
-		return null;
-	}
-	return {
-		id,
-		...(name !== undefined ? { name } : {}),
-		...(displayName !== undefined ? { displayName } : {}),
-		...(contextWindow !== undefined ? { contextWindow } : {}),
-		...(maxTokens !== undefined ? { maxTokens } : {}),
-		...(supportsReasoning !== undefined ? { supportsReasoning } : {}),
-		...(supportsThinking !== undefined ? { supportsThinking } : {}),
-	};
-}
-
-function getDefaultAtomicAgentDir(): string {
-	const configured = readEnv("ATOMIC_CODING_AGENT_DIR") ?? readEnv("PI_CODING_AGENT_DIR");
-	if (configured) return expandTilde(configured);
-	return join(homedir(), ".atomic", "agent");
-}
-
-function readEnv(name: string): string | undefined {
-	const value = process.env[name]?.trim();
-	return value ? value : undefined;
-}
-
-function expandTilde(path: string): string {
-	if (path === "~") return homedir();
-	if (path.startsWith("~/")) return resolve(homedir(), path.slice(2));
-	return resolve(path);
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function readRequiredString(value: Record<string, unknown>, key: string): string | undefined {
-	const field = value[key];
-	return typeof field === "string" && field.length > 0 ? field : undefined;
-}
-
-function readOptionalString(value: Record<string, unknown>, key: string): string | undefined | false {
-	const field = value[key];
-	if (field === undefined) return undefined;
-	return typeof field === "string" ? field : false;
-}
-
-function readOptionalPositiveNumber(value: Record<string, unknown>, key: string): number | undefined | false {
-	const field = value[key];
-	if (field === undefined) return undefined;
-	return typeof field === "number" && Number.isFinite(field) && field > 0 ? field : false;
-}
-
-function readOptionalBoolean(value: Record<string, unknown>, key: string): boolean | undefined | false {
-	const field = value[key];
-	if (field === undefined) return undefined;
-	return typeof field === "boolean" ? field : false;
-}