saros-proxy 0.1.0

package/dist/constants.js

@@ -0,0 +1,162 @@
+/**
+ * constants.ts — Shared configuration constants for the proxy.
+ *
+ * All magic numbers and default values used across the codebase
+ * are centralized here to avoid duplication and improve maintainability.
+ */
+export const DEFAULT_PORT = 3000;
+export const DEFAULT_HOST = '127.0.0.1';
+export const DEFAULT_CIRCUIT_BREAKER_COOLDOWN_MS = 60_000;
+export const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+export const DEFAULT_SCRAPE_INTERVAL_MS = 90_000;
+export const MIN_SCRAPE_INTERVAL_MS = 10_000;
+export const MAX_SCRAPE_INTERVAL_MS = 3_600_000;
+export const MIN_KEY_LENGTH = 20;
+export const API_KEY_PREFIX = 'sk-';
+export const DEFAULT_UPSTREAM_URL = 'https://opencode.ai';
+export const MAX_BODY_SIZE = 10 * 1024 * 1024;
+export const MAX_RETRIES = 2;
+export const RATE_LIMIT_WINDOW_MS = 60_000;
+export const RATE_LIMIT_MAX = 100;
+export const FORCE_SHUTDOWN_TIMEOUT_MS = 5_000;
+export const MAX_STREAMING_BUFFER = 10_000;
+export const DEFAULT_USAGE_THRESHOLD = 50;
+export const WORKSPACE_ID_REGEX = /^wrk_[A-Za-z0-9]+$/;
+// OpenCode client model definitions for proxy provider configuration
+// Source: https://opencode.ai/zen/go/v1/models (18 models as of 2026-06-06)
+export const OPENCODE_MODELS = {
+    // GLM series (~200K context)
+    'glm-5': {
+        id: 'glm-5',
+        name: 'GLM-5',
+        tool_call: true,
+        limit: { context: 200000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'glm-5.1': {
+        id: 'glm-5.1',
+        name: 'GLM-5.1',
+        tool_call: true,
+        limit: { context: 200000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    // Kimi series (~256K context)
+    'kimi-k2.5': {
+        id: 'kimi-k2.5',
+        name: 'Kimi K2.5',
+        tool_call: true,
+        limit: { context: 256000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'kimi-k2.6': {
+        id: 'kimi-k2.6',
+        name: 'Kimi K2.6',
+        tool_call: true,
+        limit: { context: 256000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    // DeepSeek V4 series
+    'deepseek-v4-pro': {
+        id: 'deepseek-v4-pro',
+        name: 'DeepSeek V4 Pro',
+        tool_call: true,
+        limit: { context: 128000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'deepseek-v4-flash': {
+        id: 'deepseek-v4-flash',
+        name: 'DeepSeek V4 Flash',
+        tool_call: true,
+        limit: { context: 128000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    // MiMo series (200K context for v2)
+    'mimo-v2.5': {
+        id: 'mimo-v2.5',
+        name: 'MiMo V2.5',
+        tool_call: true,
+        limit: { context: 128000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'mimo-v2.5-pro': {
+        id: 'mimo-v2.5-pro',
+        name: 'MiMo V2.5 Pro',
+        tool_call: true,
+        limit: { context: 128000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'mimo-v2-pro': {
+        id: 'mimo-v2-pro',
+        name: 'MiMo V2 Pro',
+        tool_call: true,
+        limit: { context: 200000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'mimo-v2-omni': {
+        id: 'mimo-v2-omni',
+        name: 'MiMo V2 Omni',
+        tool_call: true,
+        limit: { context: 200000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    // MiniMax series (Anthropic-compatible API)
+    'minimax-m3': {
+        id: 'minimax-m3',
+        name: 'MiniMax M3',
+        tool_call: true,
+        limit: { context: 128000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'minimax-m2.7': {
+        id: 'minimax-m2.7',
+        name: 'MiniMax M2.7',
+        tool_call: true,
+        limit: { context: 128000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'minimax-m2.5': {
+        id: 'minimax-m2.5',
+        name: 'MiniMax M2.5',
+        tool_call: true,
+        limit: { context: 128000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    // Qwen series (1M context for 3.6/3.5 Plus)
+    'qwen3.7-max': {
+        id: 'qwen3.7-max',
+        name: 'Qwen 3.7 Max',
+        tool_call: true,
+        limit: { context: 256000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'qwen3.7-plus': {
+        id: 'qwen3.7-plus',
+        name: 'Qwen 3.7 Plus',
+        tool_call: true,
+        limit: { context: 256000, output: 8192 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'qwen3.6-plus': {
+        id: 'qwen3.6-plus',
+        name: 'Qwen 3.6 Plus',
+        tool_call: true,
+        limit: { context: 1000000, output: 65536 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    'qwen3.5-plus': {
+        id: 'qwen3.5-plus',
+        name: 'Qwen 3.5 Plus',
+        tool_call: true,
+        limit: { context: 1000000, output: 65536 },
+        modalities: { input: ['text', 'image'], output: ['text'] },
+    },
+    // HY3 Preview
+    'hy3-preview': {
+        id: 'hy3-preview',
+        name: 'HY3 Preview',
+        tool_call: false,
+        limit: { context: 128000, output: 8192 },
+        modalities: { input: ['text'], output: ['text'] },
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/dashboard-parser.d.ts

@@ -0,0 +1,47 @@
+/**
+ * dashboard-parser.ts — Parse usage percentages from the OpenCode-Go dashboard HTML.
+ *
+ * The dashboard returns SolidJS SSR hydration data with usage percentages
+ * for three time windows: rolling (~5h), weekly, and monthly.
+ *
+ * Example hydration data:
+ * ```
+ * rollingUsage:$R[3]={usagePercent:45.2,resetInSec:18000}
+ * weeklyUsage:$R[4]={usagePercent:60.5,resetInSec:604800}
+ * monthlyUsage:$R[5]={usagePercent:30.0,resetInSec:2592000}
+ * ```
+ *
+ * Field order (usagePercent vs resetInSec) can vary between responses.
+ * These functions handle both orderings by trying two regex patterns per window.
+ */
+export interface UsageData {
+    rolling: number | null;
+    weekly: number | null;
+    monthly: number | null;
+}
+/**
+ * Parse all three usage windows (rolling, weekly, monthly) from dashboard HTML.
+ * Returns null for any window that couldn't be parsed.
+ *
+ * @param html — Raw HTML from the OpenCode-Go dashboard page.
+ * @returns An object with `rolling`, `weekly`, and `monthly` usage percentages,
+ *          or null for windows that could not be parsed.
+ */
+export declare function parseAllUsage(html: string): UsageData;
+/**
+ * Parse a single usage window from dashboard HTML.
+ *
+ * Tries two regex patterns to handle field order variance
+ * (usagePercent before or after resetInSec).
+ *
+ * Returns null if:
+ * - The window data is not found in the HTML
+ * - The extracted value is not a finite number
+ * - The HTML is malformed or from a non-dashboard page
+ *
+ * @param html  — Raw HTML from the OpenCode-Go dashboard page.
+ * @param window — The time window to parse: `'rolling'`, `'weekly'`, or `'monthly'`.
+ * @returns The usage percentage as a number (may be negative or exceed 100),
+ *          or null if the value could not be extracted.
+ */
+export declare function parseUsagePercent(html: string, window: 'rolling' | 'weekly' | 'monthly'): number | null;

package/dist/dashboard-parser.js

@@ -0,0 +1,88 @@
+/**
+ * dashboard-parser.ts — Parse usage percentages from the OpenCode-Go dashboard HTML.
+ *
+ * The dashboard returns SolidJS SSR hydration data with usage percentages
+ * for three time windows: rolling (~5h), weekly, and monthly.
+ *
+ * Example hydration data:
+ * ```
+ * rollingUsage:$R[3]={usagePercent:45.2,resetInSec:18000}
+ * weeklyUsage:$R[4]={usagePercent:60.5,resetInSec:604800}
+ * monthlyUsage:$R[5]={usagePercent:30.0,resetInSec:2592000}
+ * ```
+ *
+ * Field order (usagePercent vs resetInSec) can vary between responses.
+ * These functions handle both orderings by trying two regex patterns per window.
+ */
+// ---------------------------------------------------------------------------
+// Regex patterns
+// ---------------------------------------------------------------------------
+const SCRAPED_NUMBER_PATTERN = String.raw `(-?\d+(?:\.\d+)?)`;
+const RE_ROLLING_PCT_FIRST = new RegExp(String.raw `rollingUsage:\$R\[\d+\]=\{[^}]*usagePercent:${SCRAPED_NUMBER_PATTERN}[^}]*resetInSec:${SCRAPED_NUMBER_PATTERN}[^}]*\}`);
+const RE_ROLLING_RESET_FIRST = new RegExp(String.raw `rollingUsage:\$R\[\d+\]=\{[^}]*resetInSec:${SCRAPED_NUMBER_PATTERN}[^}]*usagePercent:${SCRAPED_NUMBER_PATTERN}[^}]*\}`);
+const RE_WEEKLY_PCT_FIRST = new RegExp(String.raw `weeklyUsage:\$R\[\d+\]=\{[^}]*usagePercent:${SCRAPED_NUMBER_PATTERN}[^}]*resetInSec:${SCRAPED_NUMBER_PATTERN}[^}]*\}`);
+const RE_WEEKLY_RESET_FIRST = new RegExp(String.raw `weeklyUsage:\$R\[\d+\]=\{[^}]*resetInSec:${SCRAPED_NUMBER_PATTERN}[^}]*usagePercent:${SCRAPED_NUMBER_PATTERN}[^}]*\}`);
+const RE_MONTHLY_PCT_FIRST = new RegExp(String.raw `monthlyUsage:\$R\[\d+\]=\{[^}]*usagePercent:${SCRAPED_NUMBER_PATTERN}[^}]*resetInSec:${SCRAPED_NUMBER_PATTERN}[^}]*\}`);
+const RE_MONTHLY_RESET_FIRST = new RegExp(String.raw `monthlyUsage:\$R\[\d+\]=\{[^}]*resetInSec:${SCRAPED_NUMBER_PATTERN}[^}]*usagePercent:${SCRAPED_NUMBER_PATTERN}[^}]*\}`);
+// Map from window name to its two regex alternatives
+const PATTERNS = {
+    rolling: [RE_ROLLING_PCT_FIRST, RE_ROLLING_RESET_FIRST],
+    weekly: [RE_WEEKLY_PCT_FIRST, RE_WEEKLY_RESET_FIRST],
+    monthly: [RE_MONTHLY_PCT_FIRST, RE_MONTHLY_RESET_FIRST],
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse all three usage windows (rolling, weekly, monthly) from dashboard HTML.
+ * Returns null for any window that couldn't be parsed.
+ *
+ * @param html — Raw HTML from the OpenCode-Go dashboard page.
+ * @returns An object with `rolling`, `weekly`, and `monthly` usage percentages,
+ *          or null for windows that could not be parsed.
+ */
+export function parseAllUsage(html) {
+    return {
+        rolling: parseUsagePercent(html, 'rolling'),
+        weekly: parseUsagePercent(html, 'weekly'),
+        monthly: parseUsagePercent(html, 'monthly'),
+    };
+}
+/**
+ * Parse a single usage window from dashboard HTML.
+ *
+ * Tries two regex patterns to handle field order variance
+ * (usagePercent before or after resetInSec).
+ *
+ * Returns null if:
+ * - The window data is not found in the HTML
+ * - The extracted value is not a finite number
+ * - The HTML is malformed or from a non-dashboard page
+ *
+ * @param html  — Raw HTML from the OpenCode-Go dashboard page.
+ * @param window — The time window to parse: `'rolling'`, `'weekly'`, or `'monthly'`.
+ * @returns The usage percentage as a number (may be negative or exceed 100),
+ *          or null if the value could not be extracted.
+ */
+export function parseUsagePercent(html, window) {
+    const patterns = PATTERNS[window];
+    if (!patterns)
+        return null;
+    const [rePctFirst, reResetFirst] = patterns;
+    // Try usagePercent-first pattern
+    const pctMatch = rePctFirst.exec(html);
+    if (pctMatch) {
+        // pct-first: usagePercent:$1,resetInSec:$2
+        const val = Number(pctMatch[1]);
+        return Number.isFinite(val) ? val : null;
+    }
+    // Try resetInSec-first pattern
+    const resetMatch = reResetFirst.exec(html);
+    if (resetMatch) {
+        // reset-first: resetInSec:$1,usagePercent:$2
+        const val = Number(resetMatch[2]);
+        return Number.isFinite(val) ? val : null;
+    }
+    return null;
+}
+//# sourceMappingURL=dashboard-parser.js.map

package/dist/dashboard-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-parser.js","sourceRoot":"","sources":["../src/dashboard-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAA,mBAAmB,CAAC;AAE7D,MAAM,oBAAoB,GAAG,IAAI,MAAM,CACrC,MAAM,CAAC,GAAG,CAAA,+CAA+C,sBAAsB,mBAAmB,sBAAsB,SAAS,CAClI,CAAC;AACF,MAAM,sBAAsB,GAAG,IAAI,MAAM,CACvC,MAAM,CAAC,GAAG,CAAA,6CAA6C,sBAAsB,qBAAqB,sBAAsB,SAAS,CAClI,CAAC;AACF,MAAM,mBAAmB,GAAG,IAAI,MAAM,CACpC,MAAM,CAAC,GAAG,CAAA,8CAA8C,sBAAsB,mBAAmB,sBAAsB,SAAS,CACjI,CAAC;AACF,MAAM,qBAAqB,GAAG,IAAI,MAAM,CACtC,MAAM,CAAC,GAAG,CAAA,4CAA4C,sBAAsB,qBAAqB,sBAAsB,SAAS,CACjI,CAAC;AACF,MAAM,oBAAoB,GAAG,IAAI,MAAM,CACrC,MAAM,CAAC,GAAG,CAAA,+CAA+C,sBAAsB,mBAAmB,sBAAsB,SAAS,CAClI,CAAC;AACF,MAAM,sBAAsB,GAAG,IAAI,MAAM,CACvC,MAAM,CAAC,GAAG,CAAA,6CAA6C,sBAAsB,qBAAqB,sBAAsB,SAAS,CAClI,CAAC;AAEF,qDAAqD;AACrD,MAAM,QAAQ,GAAqC;IACjD,OAAO,EAAE,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;IACvD,MAAM,EAAE,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;IACpD,OAAO,EAAE,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;CACxD,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO;QACL,OAAO,EAAE,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC;QAC3C,MAAM,EAAE,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC;QACzC,OAAO,EAAE,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAwC;IACtF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC;IAE5C,iCAAiC;IACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,QAAQ,EAAE,CAAC;QACb,2CAA2C;QAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED,+BAA+B;IAC/B,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,UAAU,EAAE,CAAC;QACf,6CAA6C;QAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/firefox-cookies.d.ts

@@ -0,0 +1,42 @@
+/**
+ * firefox-cookies.ts — Firefox cookie and history extraction.
+ *
+ * Reads cookies.sqlite and places.sqlite from the default Firefox profile.
+ * Uses Node.js built-in node:sqlite (requires Node >= 22).
+ */
+/**
+ * Find the default Firefox profile directory on this system.
+ *
+ * Scans the platform-specific Firefox profiles directory and prefers the
+ * `default-release` profile if it exists, otherwise returns the first
+ * profile directory found.
+ *
+ * @returns The path to the Firefox profile directory, or `null` if not found.
+ */
+export declare function findFirefoxProfileDir(): string | null;
+/**
+ * Extract the `auth` cookie value for `opencode.ai` from Firefox's cookies.sqlite.
+ *
+ * Makes a temporary copy of the database (including WAL/SHM sidecars) to avoid
+ * locking conflicts with Firefox. The temp copy is cleaned up after extraction.
+ *
+ * @returns An object with `cookie` (the auth cookie value, or `null` if not found)
+ *          and an optional `error` message describing what went wrong.
+ */
+export declare function extractFirefoxAuthCookie(): {
+    cookie: string | null;
+    error?: string;
+};
+/**
+ * Extract OpenCode workspace IDs from Firefox's places.sqlite (browser history).
+ *
+ * Searches `moz_places` for URLs containing `opencode.ai/workspace/` and
+ * returns unique workspace IDs (wrk_...) from the most recently visited pages.
+ *
+ * A temporary copy of the database (including WAL/SHM sidecars) is used to
+ * avoid locking conflicts with Firefox, then cleaned up after extraction.
+ *
+ * @returns An array of unique workspace ID strings (e.g. `["wrk_abc123"]`).
+ *          Returns an empty array if none are found or if an error occurs.
+ */
+export declare function extractFirefoxWorkspaceIds(): string[];

package/dist/firefox-cookies.js

@@ -0,0 +1,170 @@
+/**
+ * firefox-cookies.ts — Firefox cookie and history extraction.
+ *
+ * Reads cookies.sqlite and places.sqlite from the default Firefox profile.
+ * Uses Node.js built-in node:sqlite (requires Node >= 22).
+ */
+import { existsSync, copyFileSync, mkdirSync, rmSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, tmpdir } from 'node:os';
+import { DatabaseSync } from 'node:sqlite';
+import { logger } from './logger.js';
+/**
+ * Find the default Firefox profile directory on this system.
+ *
+ * Scans the platform-specific Firefox profiles directory and prefers the
+ * `default-release` profile if it exists, otherwise returns the first
+ * profile directory found.
+ *
+ * @returns The path to the Firefox profile directory, or `null` if not found.
+ */
+export function findFirefoxProfileDir() {
+    const platform = process.platform;
+    let root;
+    if (platform === 'win32') {
+        const appData = process.env.APPDATA;
+        if (!appData)
+            return null;
+        root = join(appData, 'Mozilla', 'Firefox', 'Profiles');
+    }
+    else if (platform === 'darwin') {
+        root = join(homedir(), 'Library', 'Application Support', 'Firefox', 'Profiles');
+    }
+    else if (platform === 'linux') {
+        root = join(homedir(), '.mozilla', 'firefox');
+    }
+    else {
+        return null;
+    }
+    if (!existsSync(root))
+        return null;
+    try {
+        const profiles = readdirSync(root, { withFileTypes: true })
+            .filter(e => e.isDirectory())
+            .map(e => e.name);
+        if (profiles.length === 0)
+            return null;
+        const preferred = profiles.find(p => p.includes('default-release')) ?? profiles[0];
+        return join(root, preferred);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract the `auth` cookie value for `opencode.ai` from Firefox's cookies.sqlite.
+ *
+ * Makes a temporary copy of the database (including WAL/SHM sidecars) to avoid
+ * locking conflicts with Firefox. The temp copy is cleaned up after extraction.
+ *
+ * @returns An object with `cookie` (the auth cookie value, or `null` if not found)
+ *          and an optional `error` message describing what went wrong.
+ */
+export function extractFirefoxAuthCookie() {
+    const profileDir = findFirefoxProfileDir();
+    if (!profileDir)
+        return { cookie: null, error: 'Firefox profile not found' };
+    const cookiesDb = join(profileDir, 'cookies.sqlite');
+    if (!existsSync(cookiesDb))
+        return { cookie: null, error: 'cookies.sqlite not found' };
+    const tempDir = mkdirSync(join(tmpdir(), 'proto-setup-' + Date.now()), { recursive: true });
+    const tempDb = join(tempDir, 'cookies.sqlite');
+    try {
+        copyFileSync(cookiesDb, tempDb);
+        for (const ext of ['-wal', '-shm']) {
+            const sidecar = cookiesDb + ext;
+            if (existsSync(sidecar)) {
+                copyFileSync(sidecar, tempDb + ext);
+            }
+        }
+        const db = new DatabaseSync(tempDb, { readOnly: true });
+        try {
+            const stmt = db.prepare(`
+        SELECT name, value, host
+        FROM moz_cookies
+        WHERE (host = 'opencode.ai' OR host = '.opencode.ai')
+          AND name = 'auth'
+        ORDER BY expiry DESC
+        LIMIT 1
+      `);
+            const rows = stmt.all();
+            return rows.length > 0
+                ? { cookie: rows[0].value }
+                : { cookie: null, error: 'No auth cookie found for opencode.ai' };
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('EBUSY') || msg.includes('EPERM') || msg.includes('locked')) {
+            return { cookie: null, error: 'Firefox has the database locked. Close Firefox and try again.' };
+        }
+        return { cookie: null, error: msg };
+    }
+    finally {
+        rmSync(tempDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Extract OpenCode workspace IDs from Firefox's places.sqlite (browser history).
+ *
+ * Searches `moz_places` for URLs containing `opencode.ai/workspace/` and
+ * returns unique workspace IDs (wrk_...) from the most recently visited pages.
+ *
+ * A temporary copy of the database (including WAL/SHM sidecars) is used to
+ * avoid locking conflicts with Firefox, then cleaned up after extraction.
+ *
+ * @returns An array of unique workspace ID strings (e.g. `["wrk_abc123"]`).
+ *          Returns an empty array if none are found or if an error occurs.
+ */
+export function extractFirefoxWorkspaceIds() {
+    const profileDir = findFirefoxProfileDir();
+    if (!profileDir)
+        return [];
+    const placesDb = join(profileDir, 'places.sqlite');
+    if (!existsSync(placesDb))
+        return [];
+    const tempDir = mkdirSync(join(tmpdir(), 'proto-setup-history-' + Date.now()), { recursive: true });
+    const tempDb = join(tempDir, 'places.sqlite');
+    try {
+        copyFileSync(placesDb, tempDb);
+        for (const ext of ['-wal', '-shm']) {
+            const sidecar = placesDb + ext;
+            if (existsSync(sidecar)) {
+                copyFileSync(sidecar, tempDb + ext);
+            }
+        }
+        const db = new DatabaseSync(tempDb, { readOnly: true });
+        try {
+            const stmt = db.prepare(`
+        SELECT url
+        FROM moz_places
+        WHERE url LIKE '%opencode.ai/workspace/%'
+        ORDER BY last_visit_date DESC
+        LIMIT 50
+      `);
+            const rows = stmt.all();
+            const workspaceIds = new Set();
+            for (const row of rows) {
+                const match = row.url.match(/\/workspace\/(wrk_[A-Za-z0-9]+)/);
+                if (match) {
+                    workspaceIds.add(match[1]);
+                }
+            }
+            return Array.from(workspaceIds);
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (err) {
+        logger.warn({ err }, 'Failed to extract Firefox workspace IDs');
+        return [];
+    }
+    finally {
+        rmSync(tempDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=firefox-cookies.js.map

package/dist/firefox-cookies.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * index.ts — Entry point for Saros.
+ *
+ * Usage:
+ *   tsx src/index.ts
+ *   tsx src/index.ts --config my-config.yaml
+ *   tsx src/index.ts --port 4000 --host 0.0.0.0
+ *   tsx src/index.ts setup                     # Run the interactive setup wizard
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * index.ts — Entry point for Saros.
+ *
+ * Usage:
+ *   tsx src/index.ts
+ *   tsx src/index.ts --config my-config.yaml
+ *   tsx src/index.ts --port 4000 --host 0.0.0.0
+ *   tsx src/index.ts setup                     # Run the interactive setup wizard
+ */
+import { serve } from '@hono/node-server';
+import { dirname } from 'node:path';
+import { loadConfig } from './config.js';
+import { createProxyApp } from './proxy.js';
+import { logger, maskKey } from './logger.js';
+import { startScraper, stopScraper } from './scraper.js';
+import { FORCE_SHUTDOWN_TIMEOUT_MS } from './constants.js';
+// ---------------------------------------------------------------------------
+// Subcommand: 'setup' — delegate to the interactive setup wizard
+// ---------------------------------------------------------------------------
+if (process.argv[2] === 'setup') {
+    const { setup } = await import('./cli/setup.js');
+    const { getDefaultConfigPath } = await import('./config.js');
+    await setup(dirname(getDefaultConfigPath()));
+    process.exit(0);
+}
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+let config;
+try {
+    config = loadConfig();
+}
+catch (err) {
+    logger.error({ err }, 'Failed to load configuration');
+    process.exit(1);
+}
+logger.info('Loaded %d API key(s):', config.keys.length);
+for (const k of config.keys) {
+    logger.info('  - %s: %s', k.label, maskKey(k.key));
+}
+// ---------------------------------------------------------------------------
+// Security startup banner
+// ---------------------------------------------------------------------------
+function logSecurityWarnings(cfg) {
+    // Not binding to localhost — warn about exposure
+    if (cfg.host !== '127.0.0.1' && cfg.host !== 'localhost') {
+        logger.warn('Proxy binding to "%s" — not localhost. Ensure firewall rules are set.', cfg.host);
+    }
+    // Unusually long request timeout
+    if (cfg.requestTimeoutMs > 60_000) {
+        logger.warn('Request timeout is %dms (>60s) — may cause resource exhaustion', cfg.requestTimeoutMs);
+    }
+    // CORS allowing all origins (empty allowedOrigins means all are allowed)
+    if (cfg.allowedOrigins.length === 0) {
+        logger.warn('CORS allows all origins — restrict in production');
+    }
+    logger.info('Security: %d API keys loaded (all masked in logs)', cfg.keys.length);
+}
+logSecurityWarnings(config);
+// ---------------------------------------------------------------------------
+// Server
+// ---------------------------------------------------------------------------
+const app = createProxyApp(config);
+const server = serve({ fetch: app.fetch, port: config.port, hostname: config.host }, (info) => {
+    logger.info('Proxy listening on http://%s:%d', info.address, info.port);
+    logger.info('Upstream: %s', config.upstreamBaseUrl);
+    logger.info('API keys loaded: %d', config.keys.length);
+    // Start usage-based scraper if configured
+    if (config.scraping?.enabled && config.scraping.accounts.length > 0) {
+        startScraper(config.scraping.accounts, config.scraping.intervalMs);
+    }
+    else {
+        logger.info('Usage-based scraping disabled (not configured or no accounts)');
+    }
+});
+// ---------------------------------------------------------------------------
+// Graceful shutdown
+// ---------------------------------------------------------------------------
+let isShuttingDown = false;
+function gracefulShutdown(signal) {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    logger.info('Received %s, starting graceful shutdown...', signal);
+    // Stop background scraper
+    stopScraper();
+    // Stop accepting new connections
+    server.close(() => {
+        logger.info('Server closed');
+        process.exit(0);
+    });
+    // Force exit after forced shutdown timeout
+    setTimeout(() => {
+        logger.error('Forced shutdown after timeout');
+        process.exit(1);
+    }, FORCE_SHUTDOWN_TIMEOUT_MS);
+}
+process.on('SIGINT', () => gracefulShutdown('SIGINT'));
+process.on('SIGTERM', () => gracefulShutdown('SIGTERM'));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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