codex-multi-auth 0.1.0

package/dist/lib/rotation.js

@@ -0,0 +1,321 @@
+/**
+ * Rotation Strategy Module
+ *
+ * Implements health-based account selection with token bucket rate limiting.
+ * Ported from antigravity-auth rotation logic for optimal account rotation
+ * when rate limits are encountered.
+ */
+import { createLogger } from "./logger.js";
+const log = createLogger("rotation");
+export const DEFAULT_HEALTH_SCORE_CONFIG = {
+    successDelta: 1,
+    rateLimitDelta: -10,
+    failureDelta: -20,
+    maxScore: 100,
+    minScore: 0,
+    passiveRecoveryPerHour: 2,
+};
+/**
+ * Tracks health scores for accounts to prioritize healthy accounts.
+ * Accounts with higher health scores are preferred for selection.
+ */
+export class HealthScoreTracker {
+    entries = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_HEALTH_SCORE_CONFIG, ...config };
+    }
+    getKey(accountIndex, quotaKey) {
+        return quotaKey ? `${accountIndex}:${quotaKey}` : `${accountIndex}`;
+    }
+    applyPassiveRecovery(entry) {
+        const now = Date.now();
+        const hoursSinceUpdate = (now - entry.lastUpdated) / (1000 * 60 * 60);
+        const recovery = hoursSinceUpdate * this.config.passiveRecoveryPerHour;
+        return Math.min(entry.score + recovery, this.config.maxScore);
+    }
+    getScore(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.entries.get(key);
+        if (!entry)
+            return this.config.maxScore;
+        return this.applyPassiveRecovery(entry);
+    }
+    getConsecutiveFailures(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.entries.get(key);
+        return entry?.consecutiveFailures ?? 0;
+    }
+    recordSuccess(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.entries.get(key);
+        const baseScore = entry ? this.applyPassiveRecovery(entry) : this.config.maxScore;
+        const newScore = Math.min(baseScore + this.config.successDelta, this.config.maxScore);
+        this.entries.set(key, {
+            score: newScore,
+            lastUpdated: Date.now(),
+            consecutiveFailures: 0,
+        });
+    }
+    recordRateLimit(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.entries.get(key);
+        const baseScore = entry ? this.applyPassiveRecovery(entry) : this.config.maxScore;
+        const newScore = Math.max(baseScore + this.config.rateLimitDelta, this.config.minScore);
+        this.entries.set(key, {
+            score: newScore,
+            lastUpdated: Date.now(),
+            consecutiveFailures: (entry?.consecutiveFailures ?? 0) + 1,
+        });
+    }
+    recordFailure(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.entries.get(key);
+        const baseScore = entry ? this.applyPassiveRecovery(entry) : this.config.maxScore;
+        const newScore = Math.max(baseScore + this.config.failureDelta, this.config.minScore);
+        this.entries.set(key, {
+            score: newScore,
+            lastUpdated: Date.now(),
+            consecutiveFailures: (entry?.consecutiveFailures ?? 0) + 1,
+        });
+    }
+    reset(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        this.entries.delete(key);
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+export const DEFAULT_TOKEN_BUCKET_CONFIG = {
+    maxTokens: 50,
+    tokensPerMinute: 6,
+};
+const TOKEN_REFUND_WINDOW_MS = 30_000;
+/**
+ * Client-side token bucket for rate limiting requests per account.
+ * Prevents sending requests to accounts that are likely to be rate-limited.
+ */
+export class TokenBucketTracker {
+    buckets = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_TOKEN_BUCKET_CONFIG, ...config };
+    }
+    getKey(accountIndex, quotaKey) {
+        return quotaKey ? `${accountIndex}:${quotaKey}` : `${accountIndex}`;
+    }
+    refillTokens(entry) {
+        const now = Date.now();
+        const minutesSinceRefill = (now - entry.lastRefill) / (1000 * 60);
+        const tokensToAdd = minutesSinceRefill * this.config.tokensPerMinute;
+        return Math.min(entry.tokens + tokensToAdd, this.config.maxTokens);
+    }
+    getTokens(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.buckets.get(key);
+        if (!entry)
+            return this.config.maxTokens;
+        return this.refillTokens(entry);
+    }
+    /**
+     * Attempt to consume a token. Returns true if successful, false if bucket is empty.
+     */
+    tryConsume(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.buckets.get(key);
+        const currentTokens = entry ? this.refillTokens(entry) : this.config.maxTokens;
+        if (currentTokens < 1) {
+            return false;
+        }
+        const now = Date.now();
+        const cutoff = now - TOKEN_REFUND_WINDOW_MS;
+        const consumptions = (entry?.consumptions ?? []).filter((timestamp) => timestamp >= cutoff);
+        consumptions.push(now);
+        this.buckets.set(key, {
+            tokens: currentTokens - 1,
+            lastRefill: now,
+            consumptions,
+        });
+        return true;
+    }
+    /**
+     * Attempt to refund a token consumed within the refund window.
+     * Use this when a request fails due to network errors (not rate limits).
+     * @returns true if refund was successful, false if no valid consumption found
+     */
+    refundToken(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.buckets.get(key);
+        if (!entry || entry.consumptions.length === 0)
+            return false;
+        const now = Date.now();
+        const cutoff = now - TOKEN_REFUND_WINDOW_MS;
+        const validIndex = entry.consumptions.findIndex((timestamp) => timestamp >= cutoff);
+        if (validIndex === -1)
+            return false;
+        entry.consumptions.splice(validIndex, 1);
+        const currentTokens = this.refillTokens(entry);
+        this.buckets.set(key, {
+            tokens: Math.min(currentTokens + 1, this.config.maxTokens),
+            lastRefill: now,
+            consumptions: entry.consumptions,
+        });
+        return true;
+    }
+    /**
+     * Drain tokens on rate limit to prevent immediate retries.
+     */
+    drain(accountIndex, quotaKey, drainAmount = 10) {
+        const key = this.getKey(accountIndex, quotaKey);
+        const entry = this.buckets.get(key);
+        const currentTokens = entry ? this.refillTokens(entry) : this.config.maxTokens;
+        this.buckets.set(key, {
+            tokens: Math.max(0, currentTokens - drainAmount),
+            lastRefill: Date.now(),
+            consumptions: entry?.consumptions ?? [],
+        });
+    }
+    reset(accountIndex, quotaKey) {
+        const key = this.getKey(accountIndex, quotaKey);
+        this.buckets.delete(key);
+    }
+    clear() {
+        this.buckets.clear();
+    }
+}
+export const DEFAULT_HYBRID_SELECTION_CONFIG = {
+    healthWeight: 2,
+    tokenWeight: 5,
+    freshnessWeight: 2.0,
+};
+/**
+ * Selects the best account from a set using a weighted hybrid score composed of health, token availability, and freshness.
+ *
+ * @param accounts - Candidate accounts with availability (`isAvailable`) and last-used timestamp (`lastUsed`); when none are available the least-recently-used account is returned.
+ * @param healthTracker - Tracker used to obtain per-account health scores (scoped by `quotaKey` when provided).
+ * @param tokenTracker - Tracker used to obtain per-account token counts (scoped by `quotaKey` when provided). Logged token values are rounded for telemetry and sensitive tokens are not emitted.
+ * @param quotaKey - Optional quota key to scope health and token lookups.
+ * @param config - Partial selection weights that override defaults (healthWeight, tokenWeight, freshnessWeight).
+ * @param options - Selection options. `pidOffsetEnabled` adds a small PID-based deterministic offset to distribute selection across processes. `scoreBoostByAccount` is an optional per-account numeric boost keyed by account index.
+ * @returns The chosen AccountWithMetrics for the next request, or `null` if no accounts exist.
+ *
+ * Concurrency & environment notes:
+ * - Selection is deterministic given the same inputs except when `pidOffsetEnabled` is used to bias selection per-process.
+ * - The function is purely in-memory and performs no filesystem operations (no Windows filesystem considerations).
+ */
+export function selectHybridAccount(accounts, healthTracker, tokenTracker, quotaKey, config = {}, options = {}) {
+    const cfg = { ...DEFAULT_HYBRID_SELECTION_CONFIG, ...config };
+    const available = accounts.filter((a) => a.isAvailable);
+    if (available.length === 0) {
+        if (accounts.length === 0)
+            return null;
+        let leastRecentlyUsed = null;
+        let oldestTime = Infinity;
+        for (const account of accounts) {
+            if (account.lastUsed < oldestTime) {
+                oldestTime = account.lastUsed;
+                leastRecentlyUsed = account;
+            }
+        }
+        return leastRecentlyUsed;
+    }
+    // istanbul ignore next -- defensive: available[0] always exists when length === 1
+    if (available.length === 1)
+        return available[0] ?? null;
+    const now = Date.now();
+    let bestAccount = null;
+    let bestScore = -Infinity;
+    // PID offset: distribute account selection across parallel processes
+    // Each process gets a small deterministic bonus based on its PID
+    const pidBonus = options.pidOffsetEnabled ? (process.pid % 100) * 0.01 : 0;
+    for (const account of available) {
+        const health = healthTracker.getScore(account.index, quotaKey);
+        const tokens = tokenTracker.getTokens(account.index, quotaKey);
+        const hoursSinceUsed = (now - account.lastUsed) / (1000 * 60 * 60);
+        const capabilityBoost = typeof options.scoreBoostByAccount?.[account.index] === "number"
+            ? options.scoreBoostByAccount[account.index] ?? 0
+            : 0;
+        const safeCapabilityBoost = Number.isFinite(capabilityBoost) ? capabilityBoost : 0;
+        let score = health * cfg.healthWeight +
+            tokens * cfg.tokenWeight +
+            hoursSinceUsed * cfg.freshnessWeight +
+            safeCapabilityBoost;
+        // PID-based offset distributes selection across parallel agents
+        if (options.pidOffsetEnabled) {
+            score += ((account.index * 0.131 + pidBonus) % 1) * cfg.freshnessWeight * 0.1;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestAccount = account;
+        }
+    }
+    if (bestAccount && available.length > 1) {
+        const health = healthTracker.getScore(bestAccount.index, quotaKey);
+        const tokens = tokenTracker.getTokens(bestAccount.index, quotaKey);
+        log.debug("Selected account", {
+            index: bestAccount.index,
+            health: Math.round(health),
+            tokens: Math.round(tokens),
+            score: Math.round(bestScore),
+            candidateCount: available.length,
+        });
+    }
+    return bestAccount;
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Adds random jitter to a delay value.
+ * @param baseMs - Base delay in milliseconds
+ * @param jitterFactor - Jitter factor (0-1), default 0.1 (10%)
+ * @returns Delay with jitter applied
+ */
+export function addJitter(baseMs, jitterFactor = 0.1) {
+    const jitter = baseMs * jitterFactor * (Math.random() * 2 - 1);
+    return Math.max(0, Math.floor(baseMs + jitter));
+}
+/**
+ * Returns a random delay within a range.
+ * @param minMs - Minimum delay in milliseconds
+ * @param maxMs - Maximum delay in milliseconds
+ * @returns Random delay within range
+ */
+export function randomDelay(minMs, maxMs) {
+    return Math.floor(minMs + Math.random() * (maxMs - minMs));
+}
+/**
+ * Calculates exponential backoff with jitter.
+ * @param attempt - Attempt number (1-based)
+ * @param baseMs - Base delay in milliseconds
+ * @param maxMs - Maximum delay in milliseconds
+ * @param jitterFactor - Jitter factor (0-1)
+ * @returns Backoff delay with jitter
+ */
+export function exponentialBackoff(attempt, baseMs = 1000, maxMs = 60000, jitterFactor = 0.1) {
+    const delay = Math.min(baseMs * Math.pow(2, attempt - 1), maxMs);
+    return addJitter(delay, jitterFactor);
+}
+// ============================================================================
+// Singleton Instances
+// ============================================================================
+let healthTrackerInstance = null;
+let tokenTrackerInstance = null;
+export function getHealthTracker(config) {
+    if (!healthTrackerInstance) {
+        healthTrackerInstance = new HealthScoreTracker(config);
+    }
+    return healthTrackerInstance;
+}
+export function getTokenTracker(config) {
+    if (!tokenTrackerInstance) {
+        tokenTrackerInstance = new TokenBucketTracker(config);
+    }
+    return tokenTrackerInstance;
+}
+export function resetTrackers() {
+    healthTrackerInstance?.clear();
+    tokenTrackerInstance?.clear();
+}
+//# sourceMappingURL=rotation.js.map

package/dist/lib/rotation.js.map

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

package/dist/lib/runtime-paths.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Resolve the Codex home directory path used by the CLI, honoring an environment override or a sensible default.
+ *
+ * This function is safe to call concurrently and returns a filesystem path string as-is; on Windows the underlying filesystem is case-insensitive so callers should avoid relying on case for equality. The returned path may contain sensitive identifiers; redact or avoid logging it in plaintext.
+ *
+ * @returns The resolved Codex home directory path: the value of `CODEX_HOME` when set and non-empty, otherwise the user's home directory joined with `.codex`.
+ */
+export declare function getCodexHomeDir(): string;
+/**
+ * Determine the directory to use for Codex multi-auth data, preferring an explicit override
+ * or existing storage locations and falling back to the primary Codex location.
+ *
+ * @returns The resolved multi-auth directory path.
+ *
+ * @remarks
+ * Concurrency: safe to call concurrently; the function only inspects filesystem state and does not create or mutate directories.
+ *
+ * Windows: deduplication and existence checks treat paths case-insensitively on Windows; returned paths preserve platform-native casing.
+ *
+ * Security: returned paths may contain user-specific or sensitive data; callers should redact or avoid logging full paths.
+ */
+export declare function getCodexMultiAuthDir(): string;
+/**
+ * Resolves the Codex cache directory used for storing cached multi-auth artifacts.
+ *
+ * The returned path is derived from the resolved multi-auth directory. Callers should avoid concurrent
+ * mutations to the returned directory path (concurrent reads are safe). On Windows, path comparison
+ * is case-insensitive elsewhere in this module; the returned path itself preserves platform casing.
+ *
+ * Token or secret redaction is not performed on the path; do not log paths that may contain secrets.
+ *
+ * @returns The filesystem path to the Codex cache directory.
+ */
+export declare function getCodexCacheDir(): string;
+/**
+ * Resolve the filesystem path for Codex log files.
+ *
+ * Returns the `logs` subdirectory within the resolved multi-auth directory.
+ * Concurrency: safe to call concurrently; this function performs no I/O or directory creation.
+ * Windows: path comparisons elsewhere are case-insensitive on Windows; this function returns a path using the platform separator.
+ * Security: the returned path may contain sensitive artifacts (tokens/credentials); redact before logging or diagnostics.
+ *
+ * @returns The path to the Codex `logs` directory (i.e., `<multi-auth-dir>/logs`)
+ */
+export declare function getCodexLogDir(): string;
+/**
+ * Resolve the legacy OpenCode home directory path.
+ *
+ * The returned path points to the per-user legacy OpenCode folder (typically `<home>/.opencode`).
+ *
+ * Concurrency: no atomicity guarantees — callers must handle concurrent filesystem access.
+ * Windows: path comparisons may be case-insensitive on Windows filesystems.
+ * Security: do not embed or log secrets/tokens in this path; redact any tokens before logging or telemetry.
+ *
+ * @returns The filesystem path for the legacy OpenCode directory (e.g. `/home/alice/.opencode`).
+ */
+export declare function getLegacyOpenCodeDir(): string;
+//# sourceMappingURL=runtime-paths.d.ts.map

package/dist/lib/runtime-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-paths.d.ts","sourceRoot":"","sources":["../../lib/runtime-paths.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AA4ED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAwB7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/lib/runtime-paths.js

@@ -0,0 +1,164 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+/**
+ * Resolve the Codex home directory path used by the CLI, honoring an environment override or a sensible default.
+ *
+ * This function is safe to call concurrently and returns a filesystem path string as-is; on Windows the underlying filesystem is case-insensitive so callers should avoid relying on case for equality. The returned path may contain sensitive identifiers; redact or avoid logging it in plaintext.
+ *
+ * @returns The resolved Codex home directory path: the value of `CODEX_HOME` when set and non-empty, otherwise the user's home directory joined with `.codex`.
+ */
+export function getCodexHomeDir() {
+    const fromEnv = (process.env.CODEX_HOME ?? "").trim();
+    return fromEnv.length > 0 ? fromEnv : join(homedir(), ".codex");
+}
+/**
+ * Returns a deduplicated list of path strings preserving the first occurrence order.
+ *
+ * Trims each input entry and ignores empty results; comparison for uniqueness is
+ * case-insensitive on Windows and case-sensitive on other platforms. This function
+ * performs no I/O and is safe to call concurrently.
+ *
+ * Note: entries are preserved as trimmed strings and are not modified for token
+ * redaction or normalization beyond trimming and optional lowercasing on Windows.
+ *
+ * @param paths - Array of path strings to deduplicate
+ * @returns An array of unique, trimmed path strings in their original first-seen order
+ */
+function deduplicatePaths(paths) {
+    const seen = new Set();
+    const result = [];
+    for (const candidate of paths) {
+        const trimmed = candidate.trim();
+        if (trimmed.length === 0)
+            continue;
+        const key = process.platform === "win32" ? trimmed.toLowerCase() : trimmed;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(trimmed);
+    }
+    return result;
+}
+/**
+ * Detects whether a directory contains known Codex storage indicators.
+ *
+ * Checks for the presence of known signal files (for example: openai-codex-accounts.json, settings.json, config.json, dashboard-settings.json)
+ * or a "projects" subdirectory to determine if the directory appears to hold Codex data.
+ *
+ * Notes:
+ * - The check only tests filesystem existence; it does not read file contents (no token or secret inspection/redaction is performed).
+ * - Results can change if other processes modify the filesystem concurrently; callers should tolerate races.
+ * - On Windows, filesystem case-insensitivity affects existence checks.
+ *
+ * @param dir - Filesystem path of the directory to probe
+ * @returns `true` if any known signal file or a "projects" subdirectory exists, `false` otherwise.
+ */
+function hasStorageSignals(dir) {
+    const signals = [
+        "openai-codex-accounts.json",
+        "settings.json",
+        "config.json",
+        "dashboard-settings.json",
+    ];
+    for (const signal of signals) {
+        if (existsSync(join(dir, signal))) {
+            return true;
+        }
+    }
+    return existsSync(join(dir, "projects"));
+}
+/**
+ * Builds a deduplicated list of fallback candidate directories that may contain Codex runtime data.
+ *
+ * The returned list preserves evaluation order (primary Codex home first, then DevTools config, then legacy ~/.codex).
+ * Comparison is normalized for case-insensitive filesystems (Windows) during deduplication. Callers should treat
+ * these paths as suggestions only; concurrent callers may observe different filesystem states and should handle
+ * races. Paths may contain sensitive tokens; callers must redact or avoid logging them.
+ *
+ * @returns An array of unique, trimmed directory paths to probe for Codex home data, in prioritized order.
+ */
+function getFallbackCodexHomeDirs() {
+    return deduplicatePaths([
+        getCodexHomeDir(),
+        join(homedir(), "DevTools", "config", "codex"),
+        join(homedir(), ".codex"),
+    ]);
+}
+/**
+ * Determine the directory to use for Codex multi-auth data, preferring an explicit override
+ * or existing storage locations and falling back to the primary Codex location.
+ *
+ * @returns The resolved multi-auth directory path.
+ *
+ * @remarks
+ * Concurrency: safe to call concurrently; the function only inspects filesystem state and does not create or mutate directories.
+ *
+ * Windows: deduplication and existence checks treat paths case-insensitively on Windows; returned paths preserve platform-native casing.
+ *
+ * Security: returned paths may contain user-specific or sensitive data; callers should redact or avoid logging full paths.
+ */
+export function getCodexMultiAuthDir() {
+    const fromEnv = (process.env.CODEX_MULTI_AUTH_DIR ?? "").trim();
+    if (fromEnv.length > 0) {
+        return fromEnv;
+    }
+    const primary = join(getCodexHomeDir(), "multi-auth");
+    if (hasStorageSignals(primary)) {
+        return primary;
+    }
+    const fallbackCandidates = deduplicatePaths([
+        ...getFallbackCodexHomeDirs().map((dir) => join(dir, "multi-auth")),
+        getLegacyOpenCodeDir(),
+    ]);
+    for (const candidate of fallbackCandidates) {
+        if (candidate === primary)
+            continue;
+        if (hasStorageSignals(candidate)) {
+            return candidate;
+        }
+    }
+    return primary;
+}
+/**
+ * Resolves the Codex cache directory used for storing cached multi-auth artifacts.
+ *
+ * The returned path is derived from the resolved multi-auth directory. Callers should avoid concurrent
+ * mutations to the returned directory path (concurrent reads are safe). On Windows, path comparison
+ * is case-insensitive elsewhere in this module; the returned path itself preserves platform casing.
+ *
+ * Token or secret redaction is not performed on the path; do not log paths that may contain secrets.
+ *
+ * @returns The filesystem path to the Codex cache directory.
+ */
+export function getCodexCacheDir() {
+    return join(getCodexMultiAuthDir(), "cache");
+}
+/**
+ * Resolve the filesystem path for Codex log files.
+ *
+ * Returns the `logs` subdirectory within the resolved multi-auth directory.
+ * Concurrency: safe to call concurrently; this function performs no I/O or directory creation.
+ * Windows: path comparisons elsewhere are case-insensitive on Windows; this function returns a path using the platform separator.
+ * Security: the returned path may contain sensitive artifacts (tokens/credentials); redact before logging or diagnostics.
+ *
+ * @returns The path to the Codex `logs` directory (i.e., `<multi-auth-dir>/logs`)
+ */
+export function getCodexLogDir() {
+    return join(getCodexMultiAuthDir(), "logs");
+}
+/**
+ * Resolve the legacy OpenCode home directory path.
+ *
+ * The returned path points to the per-user legacy OpenCode folder (typically `<home>/.opencode`).
+ *
+ * Concurrency: no atomicity guarantees — callers must handle concurrent filesystem access.
+ * Windows: path comparisons may be case-insensitive on Windows filesystems.
+ * Security: do not embed or log secrets/tokens in this path; redact any tokens before logging or telemetry.
+ *
+ * @returns The filesystem path for the legacy OpenCode directory (e.g. `/home/alice/.opencode`).
+ */
+export function getLegacyOpenCodeDir() {
+    return join(homedir(), ".opencode");
+}
+//# sourceMappingURL=runtime-paths.js.map

package/dist/lib/runtime-paths.js.map

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