cursor-agent-bridge 0.1.2 → 0.1.3

package/README.md

@@ -1,16 +1,19 @@
 # cursor-agent-bridge
 
-Responses-compatible API bridge for the Cursor Agent CLI.
+OpenAI-compatible HTTP bridge for the Cursor Agent CLI.
 
-`cursor-agent-bridge` lets Codex and OpenAI-compatible clients use your local Cursor Agent CLI session through a localhost API. It is designed around Codex's current custom-provider requirement for the Responses API while still exposing Chat Completions for simpler clients.
+`cursor-agent-bridge` lets Codex and other OpenAI-compatible clients talk to a
+local Cursor Agent session at `http://127.0.0.1:4646/v1`. It supports the
+Responses API used by Codex custom providers, plus Chat Completions for simpler
+clients.
 
 ## Requirements
 
-- Node.js 20+
+- Node.js 22.13+
 - pnpm 11+
 - Cursor Agent CLI installed and authenticated
 
-Install Cursor Agent and verify it first:
+Check Cursor Agent first:
 
 ```bash
 agent login
@@ -19,11 +22,14 @@ agent --list-models
 
 ## Install
 
+Install the package globally, then confirm the command is on your `PATH`:
+
 ```bash
 pnpm add -g cursor-agent-bridge
+cursor-agent-bridge --version
 ```
 
-During local development:
+For local development:
 
 ```bash
 pnpm install
@@ -31,23 +37,89 @@ pnpm build
 pnpm exec cursor-agent-bridge serve
 ```
 
+## Upgrade
+
+Check for updates:
+
+```bash
+cursor-agent-bridge upgrade --check
+```
+
+Install the latest published version:
+
+```bash
+cursor-agent-bridge upgrade
+```
+
+Options:
+
+```bash
+cursor-agent-bridge upgrade --target 0.1.3
+cursor-agent-bridge upgrade --manager npm
+```
+
+`--check` compares your installed version with npm and exits `1` when a newer
+version is available. The default command installs through pnpm when it manages
+the global package, otherwise npm.
+
+If you use the optional macOS LaunchAgent, reinstall it after upgrading so the
+service picks up the new binary:
+
+```bash
+cursor-agent-bridge launch-agent install
+```
+
+For local development from this repository, use `git pull`, `pnpm install`, and
+`pnpm build` instead of `upgrade`.
+
 ## Run
 
+Run the bridge in the foreground:
+
 ```bash
 cursor-agent-bridge serve --host 127.0.0.1 --port 4646
 ```
 
-Environment variables:
+Configuration:
 
 ```bash
 HOST=127.0.0.1
 PORT=4646
 CURSOR_AGENT_PATH=agent
+CURSOR_AGENT_MAX_CONCURRENT=1
+CURSOR_AGENT_YOLO=1
 ```
 
+By default, the bridge runs Cursor Agent with `--yolo` so Codex can use it as a
+non-interactive provider. Set `CURSOR_AGENT_YOLO=0` to keep Cursor Agent's
+normal confirmation behavior.
+
+`CURSOR_AGENT_MAX_CONCURRENT` limits concurrent Cursor Agent subprocesses. The
+default is `1`.
+
+## macOS Background Service
+
+Codex connects to the configured `base_url`; it does not start provider
+processes. On macOS, you can install the optional LaunchAgent to start the
+bridge at login and restart it after crashes:
+
+```bash
+cursor-agent-bridge launch-agent install
+```
+
+Manage the service:
+
+```bash
+cursor-agent-bridge launch-agent status
+cursor-agent-bridge launch-agent uninstall
+```
+
+The LaunchAgent listens on `127.0.0.1:4646` by default. Skip it if you prefer to
+run `cursor-agent-bridge serve` yourself before starting Codex.
+
 ## Codex Config
 
-Add a Codex profile such as `~/.codex/cursor.config.toml`:
+Create `~/.codex/cursor.config.toml`:
 
 ```toml
 model_provider = "cursor"
@@ -59,13 +131,14 @@ base_url = "http://127.0.0.1:4646/v1"
 wire_api = "responses"
 ```
 
-Start Codex:
+Start Codex with the profile:
 
 ```bash
 codex --profile cursor
 ```
 
-Use `/model` to select a Cursor model. The model catalog is generated from `agent --list-models`.
+Use `/model` in Codex to pick a Cursor model. The model catalog comes from
+`agent --list-models`.
 
 ## API
 
@@ -76,7 +149,17 @@ POST /v1/responses
 POST /v1/chat/completions
 ```
 
-`GET /v1/models` returns the OpenAI-compatible list by default. When Codex calls it with `client_version`, it returns the Codex model catalog shape expected by `/model`.
+`GET /v1/models` returns an OpenAI-style model list by default. When Codex calls
+the same endpoint with `client_version`, the bridge returns the catalog shape
+Codex expects for `/model`.
+
+Model lists are cached briefly so the bridge does not spawn
+`agent --list-models` for every request. Pass `refresh=1` to force a refresh.
+
+The bridge accepts sampling and token limit fields such as `temperature`,
+`top_p`, `max_tokens`, and `max_output_tokens` for OpenAI client compatibility.
+Cursor Agent CLI does not expose stable equivalents for those fields, so the
+bridge does not rewrite prompts or add local truncation.
 
 ## Examples
 
@@ -96,11 +179,13 @@ curl -sS http://127.0.0.1:4646/v1/chat/completions \
   -d '{"model":"auto","messages":[{"role":"user","content":"Reply OK"}],"stream":false}'
 ```
 
-## Security Notes
+## Security
 
-This server is intended for local use. Bind to `127.0.0.1` unless you are deliberately exposing it on a trusted network.
+Bind the bridge to `127.0.0.1` unless you intentionally expose it on a trusted
+network.
 
-Client `Authorization` headers are not forwarded to Cursor Agent. Use Cursor Agent login or `CURSOR_API_KEY` in the bridge process environment.
+The bridge does not forward client `Authorization` headers to Cursor Agent.
+Cursor Agent uses local `agent login` state.
 
 ## Development
 
@@ -109,6 +194,4 @@ pnpm install
 pnpm run ci
 ```
 
-Release publishing is handled by GitHub Actions on tags named `v*`.
-The publish workflow uses npm Trusted Publishing with GitHub OIDC, so it does
-not require an `NPM_TOKEN` repository secret.
+GitHub Actions publishes releases from `v*` tags.

package/dist/cli.mjs

@@ -1,9 +1,287 @@
 #!/usr/bin/env node
-import { t as startServer } from "./server-CuHDT_fJ.mjs";
+import { n as version, t as startServer } from "./server-BFgBwbF5.mjs";
+import { execFile, execFileSync, spawn } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { promisify } from "node:util";
+//#region src/launch-agent.ts
+const defaultLabel = "com.xwartz.cursor-agent-bridge";
+const defaultLogDir = join(homedir(), ".codex", "logs");
+function getLaunchAgentPaths(label = defaultLabel) {
+	return {
+		label,
+		plistPath: join(homedir(), "Library", "LaunchAgents", `${label}.plist`),
+		stdoutPath: join(defaultLogDir, "cursor-agent-bridge.log"),
+		stderrPath: join(defaultLogDir, "cursor-agent-bridge.err.log")
+	};
+}
+function createLaunchAgentPlist(options) {
+	const label = options.label ?? defaultLabel;
+	const host = options.host ?? "127.0.0.1";
+	const port = options.port ?? 4646;
+	const paths = getLaunchAgentPaths(label);
+	const args = [
+		resolve(options.cliPath),
+		"serve",
+		"--host",
+		host,
+		"--port",
+		String(port)
+	];
+	const env = { PATH: [
+		dirname(resolve(options.cliPath)),
+		join(homedir(), ".local", "bin"),
+		"/usr/local/bin",
+		"/opt/homebrew/bin",
+		"/usr/bin",
+		"/bin",
+		"/usr/sbin",
+		"/sbin"
+	].join(":") };
+	if (options.agentPath) env.CURSOR_AGENT_PATH = options.agentPath;
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${escapePlist(label)}</string>
+
+  <key>ProgramArguments</key>
+  <array>
+${args.map((arg) => `    <string>${escapePlist(arg)}</string>`).join("\n")}
+  </array>
+
+  <key>EnvironmentVariables</key>
+  <dict>
+${Object.entries(env).map(([key, value]) => `    <key>${escapePlist(key)}</key>\n    <string>${escapePlist(value)}</string>`).join("\n")}
+  </dict>
+
+  <key>RunAtLoad</key>
+  <true/>
+
+  <key>KeepAlive</key>
+  <true/>
+
+  <key>StandardOutPath</key>
+  <string>${escapePlist(paths.stdoutPath)}</string>
+
+  <key>StandardErrorPath</key>
+  <string>${escapePlist(paths.stderrPath)}</string>
+</dict>
+</plist>
+`;
+}
+function installLaunchAgent(options) {
+	ensureMacOS();
+	const paths = getLaunchAgentPaths(options.label ?? defaultLabel);
+	mkdirSync(dirname(paths.plistPath), { recursive: true });
+	mkdirSync(defaultLogDir, { recursive: true });
+	if (existsSync(paths.plistPath)) bootout(paths.plistPath);
+	writeFileSync(paths.plistPath, createLaunchAgentPlist(options));
+	chmodSync(paths.plistPath, 420);
+	execFileSync("launchctl", [
+		"bootstrap",
+		launchctlDomain(),
+		paths.plistPath
+	], { stdio: "pipe" });
+	return paths;
+}
+function uninstallLaunchAgent(label = defaultLabel) {
+	ensureMacOS();
+	const paths = getLaunchAgentPaths(label);
+	bootout(paths.plistPath);
+	rmSync(paths.plistPath, { force: true });
+	return paths;
+}
+function printLaunchAgentStatus(label = defaultLabel) {
+	ensureMacOS();
+	return execFileSync("launchctl", ["print", `${launchctlDomain()}/${label}`], { encoding: "utf8" });
+}
+function bootout(plistPath) {
+	try {
+		execFileSync("launchctl", [
+			"bootout",
+			launchctlDomain(),
+			plistPath
+		], { stdio: "pipe" });
+	} catch {}
+}
+function launchctlDomain() {
+	return `gui/${process.getuid?.() ?? execFileSync("id", ["-u"], { encoding: "utf8" }).trim()}`;
+}
+function ensureMacOS() {
+	if (process.platform !== "darwin") throw new Error("LaunchAgent management is only available on macOS.");
+}
+function escapePlist(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+}
+//#endregion
+//#region src/upgrade.ts
+const execFileAsync = promisify(execFile);
+const PACKAGE_NAME = "cursor-agent-bridge";
+const DEFAULT_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+const REGISTRY_TIMEOUT_MS = 1e4;
+function compareSemver(left, right) {
+	const toParts = (value) => {
+		const [major = 0, minor = 0, patch = 0] = value.split(".").map((part) => Number.parseInt(part, 10) || 0);
+		return [
+			major,
+			minor,
+			patch
+		];
+	};
+	const [leftMajor, leftMinor, leftPatch] = toParts(left);
+	const [rightMajor, rightMinor, rightPatch] = toParts(right);
+	if (leftMajor !== rightMajor) return leftMajor < rightMajor ? -1 : 1;
+	if (leftMinor !== rightMinor) return leftMinor < rightMinor ? -1 : 1;
+	if (leftPatch !== rightPatch) return leftPatch < rightPatch ? -1 : 1;
+	return 0;
+}
+async function fetchLatestVersion(options) {
+	const registryUrl = options?.registryUrl ?? DEFAULT_REGISTRY_URL;
+	const fetchFn = options?.fetchFn ?? fetch;
+	const timeoutMs = options?.timeoutMs ?? REGISTRY_TIMEOUT_MS;
+	const controller = new AbortController();
+	const timeout = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		const response = await fetchFn(registryUrl, { signal: controller.signal });
+		if (!response.ok) throw new Error(`Registry returned ${response.status}`);
+		const payload = await response.json();
+		if (!payload.version) throw new Error("Registry response missing version");
+		return payload.version;
+	} finally {
+		clearTimeout(timeout);
+	}
+}
+async function commandExists(command, execFileFn) {
+	try {
+		await execFileFn("which", [command]);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function detectPackageManager(preference, execFileFn = execFileAsync) {
+	if (preference === "npm") return "npm";
+	if (preference === "pnpm") return "pnpm";
+	if (!await commandExists("pnpm", execFileFn)) return "npm";
+	try {
+		await execFileFn("pnpm", [
+			"list",
+			"-g",
+			PACKAGE_NAME,
+			"--json"
+		], { env: process.env });
+		return "pnpm";
+	} catch {
+		return "npm";
+	}
+}
+function buildInstallCommand(manager, target) {
+	const packageSpec = `${PACKAGE_NAME}${target === "latest" ? "@latest" : `@${target.replace(/^@/, "")}`}`;
+	if (manager === "pnpm") return {
+		command: "pnpm",
+		args: [
+			"add",
+			"-g",
+			packageSpec
+		]
+	};
+	return {
+		command: "npm",
+		args: [
+			"install",
+			"-g",
+			packageSpec
+		]
+	};
+}
+function printManualUpgradeHint(errorLog) {
+	errorLog("Upgrade manually:");
+	errorLog(`  pnpm add -g ${PACKAGE_NAME}@latest`);
+	errorLog(`  npm install -g ${PACKAGE_NAME}@latest`);
+}
+async function resolveTargetVersion(target, registryUrl, fetchFn) {
+	if (target === "latest") return fetchLatestVersion({
+		registryUrl,
+		fetchFn
+	});
+	return target.replace(/^@/, "");
+}
+async function runInstall(manager, target, spawnFn) {
+	const { command, args } = buildInstallCommand(manager, target);
+	return new Promise((resolve, reject) => {
+		const child = spawnFn(command, args, {
+			stdio: "inherit",
+			env: process.env
+		});
+		child.on("error", reject);
+		child.on("close", (code) => resolve(code ?? 1));
+	});
+}
+async function runUpgrade(options) {
+	const log = options.log ?? console.log;
+	const errorLog = options.errorLog ?? console.error;
+	const checkOnly = options.checkOnly ?? false;
+	const target = options.target ?? "latest";
+	const managerPreference = options.manager ?? "auto";
+	const registryUrl = options.registryUrl ?? DEFAULT_REGISTRY_URL;
+	const fetchFn = options.fetchFn ?? fetch;
+	const spawnFn = options.spawnFn ?? ((command, args, spawnOptions) => spawn(command, args, spawnOptions));
+	const execFileFn = options.execFileFn ?? execFileAsync;
+	const existsFn = options.existsFn ?? existsSync;
+	let targetVersion;
+	try {
+		targetVersion = await resolveTargetVersion(target, registryUrl, fetchFn);
+	} catch (error) {
+		errorLog(`Failed to check for updates: ${error instanceof Error ? error.message : String(error)}`);
+		printManualUpgradeHint(errorLog);
+		return 1;
+	}
+	if (compareSemver(options.currentVersion, targetVersion) >= 0) {
+		log(`${PACKAGE_NAME} is up to date (${options.currentVersion})`);
+		return 0;
+	}
+	if (checkOnly) {
+		log(`Update available: ${options.currentVersion} -> ${targetVersion}`);
+		return 1;
+	}
+	let manager;
+	manager = await detectPackageManager(managerPreference, execFileFn);
+	log(`Installing ${PACKAGE_NAME}@${targetVersion} via ${manager}...`);
+	try {
+		const exitCode = await runInstall(manager, target, spawnFn);
+		if (exitCode !== 0) {
+			errorLog(`${manager} install failed with exit code ${exitCode}`);
+			printManualUpgradeHint(errorLog);
+			return exitCode;
+		}
+	} catch (error) {
+		errorLog(`Install failed: ${error instanceof Error ? error.message : String(error)}`);
+		printManualUpgradeHint(errorLog);
+		return 1;
+	}
+	log(`Installed ${PACKAGE_NAME}@${targetVersion}`);
+	log("Run `cursor-agent-bridge --version` to verify the upgrade.");
+	const launchAgentPlist = getLaunchAgentPaths().plistPath;
+	if (existsFn(launchAgentPlist)) log("LaunchAgent detected. Run `cursor-agent-bridge launch-agent install` to refresh the service.");
+	return 0;
+}
+//#endregion
 //#region src/cli.ts
 function readArg(name, fallback) {
 	const index = process.argv.indexOf(name);
-	return index >= 0 ? process.argv[index + 1] : fallback;
+	if (index < 0) return fallback;
+	const value = process.argv[index + 1];
+	if (!value || value.startsWith("-")) throw new Error(`Missing value for ${name}`);
+	return value;
+}
+function parsePort(value, fallback) {
+	if (value === void 0) return fallback;
+	const port = Number(value);
+	if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error(`Invalid port: ${value}`);
+	return port;
 }
 const command = process.argv[2] && !process.argv[2]?.startsWith("-") ? process.argv[2] : "serve";
 if (command === "help" || process.argv.includes("--help") || process.argv.includes("-h")) {
@@ -11,6 +289,10 @@ if (command === "help" || process.argv.includes("--help") || process.argv.includ
 
 Usage:
   cursor-agent-bridge serve [--host 127.0.0.1] [--port 4646]
+  cursor-agent-bridge launch-agent install [--host 127.0.0.1] [--port 4646] [--agent-path agent]
+  cursor-agent-bridge launch-agent uninstall
+  cursor-agent-bridge launch-agent status
+  cursor-agent-bridge upgrade [--check] [--target latest] [--manager auto|npm|pnpm]
 
 Environment:
   HOST                Listen host, default 127.0.0.1
@@ -19,12 +301,72 @@ Environment:
 `);
 	process.exit(0);
 }
+if (command === "version" || process.argv.includes("--version")) {
+	console.log(version);
+	process.exit(0);
+}
+if (command === "upgrade") {
+	const checkOnly = process.argv.includes("--check");
+	const target = readArg("--target", "latest") ?? "latest";
+	const manager = readArg("--manager", "auto") ?? "auto";
+	if (manager !== "auto" && manager !== "npm" && manager !== "pnpm") {
+		console.error("Invalid --manager value. Use auto, npm, or pnpm.");
+		process.exit(1);
+	}
+	const exitCode = await runUpgrade({
+		currentVersion: version,
+		checkOnly,
+		target,
+		manager
+	});
+	process.exit(exitCode);
+}
+if (command === "launch-agent") {
+	const action = process.argv[3] ?? "status";
+	try {
+		if (action === "install") {
+			const host = readArg("--host", process.env.HOST) ?? "127.0.0.1";
+			const port = parsePort(readArg("--port", process.env.PORT), 4646);
+			const agentPath = readArg("--agent-path", process.env.CURSOR_AGENT_PATH);
+			const paths = installLaunchAgent({
+				cliPath: process.argv[1] ?? "cursor-agent-bridge",
+				host,
+				port,
+				...agentPath ? { agentPath } : {}
+			});
+			console.log(`Installed ${paths.label}`);
+			console.log(paths.plistPath);
+			process.exit(0);
+		}
+		if (action === "uninstall") {
+			const paths = uninstallLaunchAgent();
+			console.log(`Uninstalled ${paths.label}`);
+			process.exit(0);
+		}
+		if (action === "status") {
+			process.stdout.write(printLaunchAgentStatus());
+			process.exit(0);
+		}
+	} catch (error) {
+		console.error(error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+	console.error(`Unknown launch-agent action: ${action}`);
+	process.exit(1);
+}
 if (command !== "serve") {
 	console.error(`Unknown command: ${command}`);
 	process.exit(1);
 }
-const host = readArg("--host", process.env.HOST) ?? "127.0.0.1";
-const port = Number(readArg("--port", process.env.PORT) ?? 4646);
+let host;
+let port;
+try {
+	host = readArg("--host", process.env.HOST) ?? "127.0.0.1";
+	port = parsePort(readArg("--port", process.env.PORT), 4646);
+} catch (error) {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exit(1);
+}
 const server = await startServer({
 	host,
 	port,

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { startServer } from \"./server.js\";\n\nfunction readArg(name: string, fallback: string | undefined) {\n  const index = process.argv.indexOf(name);\n  return index >= 0 ? process.argv[index + 1] : fallback;\n}\n\nconst command =\n  process.argv[2] && !process.argv[2]?.startsWith(\"-\")\n    ? process.argv[2]\n    : \"serve\";\n\nif (\n  command === \"help\" ||\n  process.argv.includes(\"--help\") ||\n  process.argv.includes(\"-h\")\n) {\n  console.log(`cursor-agent-bridge\n\nUsage:\n  cursor-agent-bridge serve [--host 127.0.0.1] [--port 4646]\n\nEnvironment:\n  HOST                Listen host, default 127.0.0.1\n  PORT                Listen port, default 4646\n  CURSOR_AGENT_PATH   Cursor Agent CLI path, default agent\n`);\n  process.exit(0);\n}\n\nif (command !== \"serve\") {\n  console.error(`Unknown command: ${command}`);\n  process.exit(1);\n}\n\nconst host = readArg(\"--host\", process.env.HOST) ?? \"127.0.0.1\";\nconst port = Number(readArg(\"--port\", process.env.PORT) ?? 4646);\n\nconst server = await startServer({\n  host,\n  port,\n  ...(process.env.CURSOR_AGENT_PATH\n    ? { agentPath: process.env.CURSOR_AGENT_PATH }\n    : {}),\n});\nconsole.log(`cursor-agent-bridge listening on http://${host}:${port}`);\n\nfunction shutdown() {\n  server.close(() => process.exit(0));\n}\n\nprocess.on(\"SIGINT\", shutdown);\nprocess.on(\"SIGTERM\", shutdown);\n"],"mappings":";;;AAIA,SAAS,QAAQ,MAAc,UAA8B;CAC3D,MAAM,QAAQ,QAAQ,KAAK,QAAQ,IAAI;CACvC,OAAO,SAAS,IAAI,QAAQ,KAAK,QAAQ,KAAK;AAChD;AAEA,MAAM,UACJ,QAAQ,KAAK,MAAM,CAAC,QAAQ,KAAK,EAAE,EAAE,WAAW,GAAG,IAC/C,QAAQ,KAAK,KACb;AAEN,IACE,YAAY,UACZ,QAAQ,KAAK,SAAS,QAAQ,KAC9B,QAAQ,KAAK,SAAS,IAAI,GAC1B;CACA,QAAQ,IAAI;;;;;;;;;CASb;CACC,QAAQ,KAAK,CAAC;AAChB;AAEA,IAAI,YAAY,SAAS;CACvB,QAAQ,MAAM,oBAAoB,SAAS;CAC3C,QAAQ,KAAK,CAAC;AAChB;AAEA,MAAM,OAAO,QAAQ,UAAU,QAAQ,IAAI,IAAI,KAAK;AACpD,MAAM,OAAO,OAAO,QAAQ,UAAU,QAAQ,IAAI,IAAI,KAAK,IAAI;AAE/D,MAAM,SAAS,MAAM,YAAY;CAC/B;CACA;CACA,GAAI,QAAQ,IAAI,oBACZ,EAAE,WAAW,QAAQ,IAAI,kBAAkB,IAC3C,CAAC;AACP,CAAC;AACD,QAAQ,IAAI,2CAA2C,KAAK,GAAG,MAAM;AAErE,SAAS,WAAW;CAClB,OAAO,YAAY,QAAQ,KAAK,CAAC,CAAC;AACpC;AAEA,QAAQ,GAAG,UAAU,QAAQ;AAC7B,QAAQ,GAAG,WAAW,QAAQ"}
+{"version":3,"file":"cli.mjs","names":["packageJson.version"],"sources":["../src/launch-agent.ts","../src/upgrade.ts","../src/cli.ts"],"sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport {\n  chmodSync,\n  existsSync,\n  mkdirSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join, resolve } from \"node:path\";\n\nconst defaultLabel = \"com.xwartz.cursor-agent-bridge\";\nconst defaultLogDir = join(homedir(), \".codex\", \"logs\");\n\nexport type LaunchAgentOptions = {\n  cliPath: string;\n  host?: string;\n  port?: number;\n  agentPath?: string;\n  label?: string;\n};\n\nexport type LaunchAgentPaths = {\n  label: string;\n  plistPath: string;\n  stdoutPath: string;\n  stderrPath: string;\n};\n\nexport function getLaunchAgentPaths(label = defaultLabel): LaunchAgentPaths {\n  return {\n    label,\n    plistPath: join(homedir(), \"Library\", \"LaunchAgents\", `${label}.plist`),\n    stdoutPath: join(defaultLogDir, \"cursor-agent-bridge.log\"),\n    stderrPath: join(defaultLogDir, \"cursor-agent-bridge.err.log\"),\n  };\n}\n\nexport function createLaunchAgentPlist(options: LaunchAgentOptions) {\n  const label = options.label ?? defaultLabel;\n  const host = options.host ?? \"127.0.0.1\";\n  const port = options.port ?? 4646;\n  const paths = getLaunchAgentPaths(label);\n  const args = [\n    resolve(options.cliPath),\n    \"serve\",\n    \"--host\",\n    host,\n    \"--port\",\n    String(port),\n  ];\n  const env: Record<string, string> = {\n    PATH: [\n      dirname(resolve(options.cliPath)),\n      join(homedir(), \".local\", \"bin\"),\n      \"/usr/local/bin\",\n      \"/opt/homebrew/bin\",\n      \"/usr/bin\",\n      \"/bin\",\n      \"/usr/sbin\",\n      \"/sbin\",\n    ].join(\":\"),\n  };\n\n  if (options.agentPath) {\n    env.CURSOR_AGENT_PATH = options.agentPath;\n  }\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n  <key>Label</key>\n  <string>${escapePlist(label)}</string>\n\n  <key>ProgramArguments</key>\n  <array>\n${args.map((arg) => `    <string>${escapePlist(arg)}</string>`).join(\"\\n\")}\n  </array>\n\n  <key>EnvironmentVariables</key>\n  <dict>\n${Object.entries(env)\n  .map(\n    ([key, value]) =>\n      `    <key>${escapePlist(key)}</key>\\n    <string>${escapePlist(value)}</string>`,\n  )\n  .join(\"\\n\")}\n  </dict>\n\n  <key>RunAtLoad</key>\n  <true/>\n\n  <key>KeepAlive</key>\n  <true/>\n\n  <key>StandardOutPath</key>\n  <string>${escapePlist(paths.stdoutPath)}</string>\n\n  <key>StandardErrorPath</key>\n  <string>${escapePlist(paths.stderrPath)}</string>\n</dict>\n</plist>\n`;\n}\n\nexport function installLaunchAgent(options: LaunchAgentOptions) {\n  ensureMacOS();\n  const label = options.label ?? defaultLabel;\n  const paths = getLaunchAgentPaths(label);\n  mkdirSync(dirname(paths.plistPath), { recursive: true });\n  mkdirSync(defaultLogDir, { recursive: true });\n\n  if (existsSync(paths.plistPath)) {\n    bootout(paths.plistPath);\n  }\n\n  writeFileSync(paths.plistPath, createLaunchAgentPlist(options));\n  chmodSync(paths.plistPath, 0o644);\n  execFileSync(\"launchctl\", [\"bootstrap\", launchctlDomain(), paths.plistPath], {\n    stdio: \"pipe\",\n  });\n  return paths;\n}\n\nexport function uninstallLaunchAgent(label = defaultLabel) {\n  ensureMacOS();\n  const paths = getLaunchAgentPaths(label);\n  bootout(paths.plistPath);\n  rmSync(paths.plistPath, { force: true });\n  return paths;\n}\n\nexport function printLaunchAgentStatus(label = defaultLabel) {\n  ensureMacOS();\n  return execFileSync(\"launchctl\", [\"print\", `${launchctlDomain()}/${label}`], {\n    encoding: \"utf8\",\n  });\n}\n\nfunction bootout(plistPath: string) {\n  try {\n    execFileSync(\"launchctl\", [\"bootout\", launchctlDomain(), plistPath], {\n      stdio: \"pipe\",\n    });\n  } catch {\n    // It is fine if the service is not loaded yet.\n  }\n}\n\nfunction launchctlDomain() {\n  return `gui/${process.getuid?.() ?? execFileSync(\"id\", [\"-u\"], { encoding: \"utf8\" }).trim()}`;\n}\n\nfunction ensureMacOS() {\n  if (process.platform !== \"darwin\") {\n    throw new Error(\"LaunchAgent management is only available on macOS.\");\n  }\n}\n\nfunction escapePlist(value: string) {\n  return value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&apos;\");\n}\n","import { execFile, spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { promisify } from \"node:util\";\nimport { getLaunchAgentPaths } from \"./launch-agent.js\";\n\nconst execFileAsync = promisify(execFile);\n\nexport const PACKAGE_NAME = \"cursor-agent-bridge\";\nexport const DEFAULT_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;\nconst REGISTRY_TIMEOUT_MS = 10_000;\n\nexport type PackageManager = \"npm\" | \"pnpm\";\nexport type PackageManagerPreference = PackageManager | \"auto\";\n\nexport type ExecFileFn = (\n  file: string,\n  args?: readonly string[] | null,\n  options?: { env?: NodeJS.ProcessEnv },\n) => Promise<unknown>;\n\nexport type SpawnFn = (\n  command: string,\n  args: readonly string[],\n  options: { stdio: \"inherit\"; env?: NodeJS.ProcessEnv },\n) => {\n  on(event: \"error\", listener: (error: Error) => void): unknown;\n  on(event: \"close\", listener: (code: number | null) => void): unknown;\n};\n\nexport type UpgradeOptions = {\n  currentVersion: string;\n  checkOnly?: boolean;\n  target?: string;\n  manager?: PackageManagerPreference;\n  registryUrl?: string;\n  fetchFn?: typeof fetch;\n  spawnFn?: SpawnFn;\n  execFileFn?: ExecFileFn;\n  existsFn?: typeof existsSync;\n  log?: (...args: unknown[]) => void;\n  errorLog?: (...args: unknown[]) => void;\n};\n\nexport function compareSemver(left: string, right: string): -1 | 0 | 1 {\n  const toParts = (value: string) => {\n    const [major = 0, minor = 0, patch = 0] = value\n      .split(\".\")\n      .map((part) => Number.parseInt(part, 10) || 0);\n    return [major, minor, patch] as const;\n  };\n  const [leftMajor, leftMinor, leftPatch] = toParts(left);\n  const [rightMajor, rightMinor, rightPatch] = toParts(right);\n\n  if (leftMajor !== rightMajor) {\n    return leftMajor < rightMajor ? -1 : 1;\n  }\n  if (leftMinor !== rightMinor) {\n    return leftMinor < rightMinor ? -1 : 1;\n  }\n  if (leftPatch !== rightPatch) {\n    return leftPatch < rightPatch ? -1 : 1;\n  }\n  return 0;\n}\n\nexport async function fetchLatestVersion(options?: {\n  registryUrl?: string;\n  fetchFn?: typeof fetch;\n  timeoutMs?: number;\n}): Promise<string> {\n  const registryUrl = options?.registryUrl ?? DEFAULT_REGISTRY_URL;\n  const fetchFn = options?.fetchFn ?? fetch;\n  const timeoutMs = options?.timeoutMs ?? REGISTRY_TIMEOUT_MS;\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const response = await fetchFn(registryUrl, { signal: controller.signal });\n    if (!response.ok) {\n      throw new Error(`Registry returned ${response.status}`);\n    }\n\n    const payload = (await response.json()) as { version?: string };\n    if (!payload.version) {\n      throw new Error(\"Registry response missing version\");\n    }\n    return payload.version;\n  } finally {\n    clearTimeout(timeout);\n  }\n}\n\nasync function commandExists(\n  command: string,\n  execFileFn: ExecFileFn,\n): Promise<boolean> {\n  try {\n    await execFileFn(\"which\", [command]);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport async function detectPackageManager(\n  preference: PackageManagerPreference,\n  execFileFn: ExecFileFn = execFileAsync,\n): Promise<PackageManager> {\n  if (preference === \"npm\") return \"npm\";\n  if (preference === \"pnpm\") return \"pnpm\";\n\n  if (!(await commandExists(\"pnpm\", execFileFn))) {\n    return \"npm\";\n  }\n\n  try {\n    await execFileFn(\"pnpm\", [\"list\", \"-g\", PACKAGE_NAME, \"--json\"], {\n      env: process.env,\n    });\n    return \"pnpm\";\n  } catch {\n    return \"npm\";\n  }\n}\n\nexport function buildInstallCommand(\n  manager: PackageManager,\n  target: string,\n): { command: string; args: string[] } {\n  const versionSpec =\n    target === \"latest\" ? \"@latest\" : `@${target.replace(/^@/, \"\")}`;\n  const packageSpec = `${PACKAGE_NAME}${versionSpec}`;\n\n  if (manager === \"pnpm\") {\n    return { command: \"pnpm\", args: [\"add\", \"-g\", packageSpec] };\n  }\n\n  return { command: \"npm\", args: [\"install\", \"-g\", packageSpec] };\n}\n\nfunction printManualUpgradeHint(errorLog: (...args: unknown[]) => void) {\n  errorLog(\"Upgrade manually:\");\n  errorLog(`  pnpm add -g ${PACKAGE_NAME}@latest`);\n  errorLog(`  npm install -g ${PACKAGE_NAME}@latest`);\n}\n\nasync function resolveTargetVersion(\n  target: string,\n  registryUrl: string,\n  fetchFn: typeof fetch,\n): Promise<string> {\n  if (target === \"latest\") {\n    return fetchLatestVersion({ registryUrl, fetchFn });\n  }\n  return target.replace(/^@/, \"\");\n}\n\nasync function runInstall(\n  manager: PackageManager,\n  target: string,\n  spawnFn: SpawnFn,\n): Promise<number> {\n  const { command, args } = buildInstallCommand(manager, target);\n  return new Promise((resolve, reject) => {\n    const child = spawnFn(command, args, {\n      stdio: \"inherit\",\n      env: process.env,\n    });\n\n    child.on(\"error\", reject);\n    child.on(\"close\", (code) => resolve(code ?? 1));\n  });\n}\n\nexport async function runUpgrade(options: UpgradeOptions): Promise<number> {\n  const log = options.log ?? console.log;\n  const errorLog = options.errorLog ?? console.error;\n  const checkOnly = options.checkOnly ?? false;\n  const target = options.target ?? \"latest\";\n  const managerPreference = options.manager ?? \"auto\";\n  const registryUrl = options.registryUrl ?? DEFAULT_REGISTRY_URL;\n  const fetchFn = options.fetchFn ?? fetch;\n  const spawnFn: SpawnFn =\n    options.spawnFn ??\n    ((command, args, spawnOptions) => spawn(command, args, spawnOptions));\n  const execFileFn = options.execFileFn ?? execFileAsync;\n  const existsFn = options.existsFn ?? existsSync;\n\n  let targetVersion: string;\n  try {\n    targetVersion = await resolveTargetVersion(target, registryUrl, fetchFn);\n  } catch (error) {\n    errorLog(\n      `Failed to check for updates: ${error instanceof Error ? error.message : String(error)}`,\n    );\n    printManualUpgradeHint(errorLog);\n    return 1;\n  }\n\n  const comparison = compareSemver(options.currentVersion, targetVersion);\n  if (comparison >= 0) {\n    log(`${PACKAGE_NAME} is up to date (${options.currentVersion})`);\n    return 0;\n  }\n\n  if (checkOnly) {\n    log(`Update available: ${options.currentVersion} -> ${targetVersion}`);\n    return 1;\n  }\n\n  let manager: PackageManager;\n  manager = await detectPackageManager(managerPreference, execFileFn);\n\n  log(`Installing ${PACKAGE_NAME}@${targetVersion} via ${manager}...`);\n  try {\n    const exitCode = await runInstall(manager, target, spawnFn);\n    if (exitCode !== 0) {\n      errorLog(`${manager} install failed with exit code ${exitCode}`);\n      printManualUpgradeHint(errorLog);\n      return exitCode;\n    }\n  } catch (error) {\n    errorLog(\n      `Install failed: ${error instanceof Error ? error.message : String(error)}`,\n    );\n    printManualUpgradeHint(errorLog);\n    return 1;\n  }\n\n  log(`Installed ${PACKAGE_NAME}@${targetVersion}`);\n  log(\"Run `cursor-agent-bridge --version` to verify the upgrade.\");\n\n  const launchAgentPlist = getLaunchAgentPaths().plistPath;\n  if (existsFn(launchAgentPlist)) {\n    log(\n      \"LaunchAgent detected. Run `cursor-agent-bridge launch-agent install` to refresh the service.\",\n    );\n  }\n\n  return 0;\n}\n","#!/usr/bin/env node\n\nimport packageJson from \"../package.json\" with { type: \"json\" };\nimport {\n  installLaunchAgent,\n  printLaunchAgentStatus,\n  uninstallLaunchAgent,\n} from \"./launch-agent.js\";\nimport { startServer } from \"./server.js\";\nimport { runUpgrade } from \"./upgrade.js\";\n\nfunction readArg(name: string, fallback: string | undefined) {\n  const index = process.argv.indexOf(name);\n  if (index < 0) return fallback;\n  const value = process.argv[index + 1];\n  if (!value || value.startsWith(\"-\"))\n    throw new Error(`Missing value for ${name}`);\n  return value;\n}\n\nfunction parsePort(value: string | undefined, fallback: number) {\n  if (value === undefined) return fallback;\n  const port = Number(value);\n  if (!Number.isInteger(port) || port < 1 || port > 65_535) {\n    throw new Error(`Invalid port: ${value}`);\n  }\n  return port;\n}\n\nconst command =\n  process.argv[2] && !process.argv[2]?.startsWith(\"-\")\n    ? process.argv[2]\n    : \"serve\";\n\nif (\n  command === \"help\" ||\n  process.argv.includes(\"--help\") ||\n  process.argv.includes(\"-h\")\n) {\n  console.log(`cursor-agent-bridge\n\nUsage:\n  cursor-agent-bridge serve [--host 127.0.0.1] [--port 4646]\n  cursor-agent-bridge launch-agent install [--host 127.0.0.1] [--port 4646] [--agent-path agent]\n  cursor-agent-bridge launch-agent uninstall\n  cursor-agent-bridge launch-agent status\n  cursor-agent-bridge upgrade [--check] [--target latest] [--manager auto|npm|pnpm]\n\nEnvironment:\n  HOST                Listen host, default 127.0.0.1\n  PORT                Listen port, default 4646\n  CURSOR_AGENT_PATH   Cursor Agent CLI path, default agent\n`);\n  process.exit(0);\n}\n\nif (command === \"version\" || process.argv.includes(\"--version\")) {\n  console.log(packageJson.version);\n  process.exit(0);\n}\n\nif (command === \"upgrade\") {\n  const checkOnly = process.argv.includes(\"--check\");\n  const target = readArg(\"--target\", \"latest\") ?? \"latest\";\n  const manager = readArg(\"--manager\", \"auto\") ?? \"auto\";\n\n  if (manager !== \"auto\" && manager !== \"npm\" && manager !== \"pnpm\") {\n    console.error(\"Invalid --manager value. Use auto, npm, or pnpm.\");\n    process.exit(1);\n  }\n\n  const exitCode = await runUpgrade({\n    currentVersion: packageJson.version,\n    checkOnly,\n    target,\n    manager,\n  });\n  process.exit(exitCode);\n}\n\nif (command === \"launch-agent\") {\n  const action = process.argv[3] ?? \"status\";\n  try {\n    if (action === \"install\") {\n      const host = readArg(\"--host\", process.env.HOST) ?? \"127.0.0.1\";\n      const port = parsePort(readArg(\"--port\", process.env.PORT), 4646);\n      const agentPath = readArg(\"--agent-path\", process.env.CURSOR_AGENT_PATH);\n      const paths = installLaunchAgent({\n        cliPath: process.argv[1] ?? \"cursor-agent-bridge\",\n        host,\n        port,\n        ...(agentPath ? { agentPath } : {}),\n      });\n      console.log(`Installed ${paths.label}`);\n      console.log(paths.plistPath);\n      process.exit(0);\n    }\n\n    if (action === \"uninstall\") {\n      const paths = uninstallLaunchAgent();\n      console.log(`Uninstalled ${paths.label}`);\n      process.exit(0);\n    }\n\n    if (action === \"status\") {\n      process.stdout.write(printLaunchAgentStatus());\n      process.exit(0);\n    }\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    process.exit(1);\n  }\n\n  console.error(`Unknown launch-agent action: ${action}`);\n  process.exit(1);\n}\n\nif (command !== \"serve\") {\n  console.error(`Unknown command: ${command}`);\n  process.exit(1);\n}\n\nlet host: string;\nlet port: number;\ntry {\n  host = readArg(\"--host\", process.env.HOST) ?? \"127.0.0.1\";\n  port = parsePort(readArg(\"--port\", process.env.PORT), 4646);\n} catch (error) {\n  console.error(error instanceof Error ? error.message : String(error));\n  process.exit(1);\n}\n\nconst server = await startServer({\n  host,\n  port,\n  ...(process.env.CURSOR_AGENT_PATH\n    ? { agentPath: process.env.CURSOR_AGENT_PATH }\n    : {}),\n});\nconsole.log(`cursor-agent-bridge listening on http://${host}:${port}`);\n\nfunction shutdown() {\n  server.close(() => process.exit(0));\n}\n\nprocess.on(\"SIGINT\", shutdown);\nprocess.on(\"SIGTERM\", shutdown);\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,4 +1,3 @@
-import { EventEmitter } from "node:events";
 import http from "node:http";
 
 //#region src/types.d.ts
@@ -52,6 +51,7 @@ interface ServerConfig {
   host?: string;
   agentPath?: string;
   defaultCwd?: string;
+  maxBodyBytes?: number;
 }
 //#endregion
 //#region src/adapter/messages.d.ts
@@ -115,14 +115,29 @@ interface CursorRunnerOptions {
   agentPath?: string;
   defaultCwd?: string;
   timeoutMs?: number;
+  modelListCacheMs?: number;
+  maxConcurrentRuns?: number;
+  yolo?: boolean;
 }
-declare class CursorRunner extends EventEmitter {
+declare class CursorRunner {
   readonly agentPath: string;
   readonly defaultCwd: string;
   readonly timeoutMs: number;
+  readonly modelListCacheMs: number;
+  readonly maxConcurrentRuns: number;
+  readonly yolo: boolean;
+  private modelCache?;
+  private activeRuns;
+  private readonly runQueue;
+  private readonly activeChildren;
   constructor(options?: CursorRunnerOptions);
-  listModels(): Promise<BridgeModel[]>;
+  listModels(options?: {
+    refresh?: boolean;
+  }): Promise<BridgeModel[]>;
   run(options: CursorRunOptions, events?: CursorRunEvents): Promise<CursorRunResult>;
+  abortAll(): void;
+  private acquireRunPermit;
+  private runWithPermit;
 }
 //#endregion
 //#region src/server.d.ts

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/adapter/messages.ts","../src/adapter/models.ts","../src/cursor/runner.ts","../src/server.ts"],"mappings":";;;;KAAY,QAAA;AAAA,UAEK,WAAA;EACf,IAAA,EAAM,QAAA;EACN,OAAA,WAEI,KAAK;IACH,IAAA;IACA,IAAA;IACA,UAAA;IACA,WAAA;EAAA;AAAA;AAAA,UAIS,qBAAA;EACf,KAAA;EACA,QAAA,EAAU,WAAW;EACrB,MAAA;EACA,WAAA;EACA,KAAA;EACA,UAAA;AAAA;AAAA,UAGe,gBAAA;EACf,KAAA;EACA,KAAA;EACA,YAAA;EACA,MAAA;EACA,WAAA;EACA,KAAA;EACA,iBAAA;AAAA;AAAA,UAGe,WAAA;EACf,EAAA;EACA,IAAI;AAAA;AAAA,UAGW,gBAAA;EACf,KAAA;EACA,MAAA;EACA,GAAA;EACA,MAAA,GAAS,WAAW;AAAA;AAAA,UAGL,eAAA;EACf,IAAA;EACA,KAAK;AAAA;AAAA,UAGU,eAAA;EACf,OAAA,IAAW,IAAA;EACX,OAAA,IAAW,KAAA;AAAA;AAAA,UAGI,YAAA;EACf,IAAA;EACA,IAAA;EACA,SAAA;EACA,UAAA;AAAA;;;iBChDc,gBAAA,CAAiB,QAAuB,EAAb,WAAW;AAAA,iBAuCtC,mBAAA,CAAoB,OAAA,EAAS,gBAAA,GAAmB,WAAW;AAAA,iBAyC3D,cAAA,CAAe,KAAyB;;;iBCzFxC,mBAAA,CAAoB,MAAA,WAAiB,WAAW;AAAA,iBAWhD,iBAAA,CAAkB,MAAA,EAAQ,WAAW;;;;;;;;;iBAarC,mBAAA,CAAoB,MAAA,EAAQ,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UChBtC,mBAAA;EACf,SAAA;EACA,UAAA;EACA,SAAA;AAAA;AAAA,cAGW,YAAA,SAAqB,YAAA;EAAA,SACvB,SAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;cAEG,OAAA,GAAS,mBAAA;EAQrB,UAAA,IAAc,OAAA,CAAQ,WAAA;EAiBtB,GAAA,CACE,OAAA,EAAS,gBAAA,EACT,MAAA,GAAQ,eAAA,GACP,OAAA,CAAQ,eAAA;AAAA;;;iBCzBS,WAAA,CAAY,MAAA,GAAQ,YAAA,GAAiB,OAAA,CAAA,IAAA,CAAA,MAAA,QAAA,IAAA,CAAA,eAAA,SAAA,IAAA,CAAA,cAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/adapter/messages.ts","../src/adapter/models.ts","../src/cursor/runner.ts","../src/server.ts"],"mappings":";;;KAAY,QAAA;AAAA,UAEK,WAAA;EACf,IAAA,EAAM,QAAA;EACN,OAAA,WAEI,KAAK;IACH,IAAA;IACA,IAAA;IACA,UAAA;IACA,WAAA;EAAA;AAAA;AAAA,UAIS,qBAAA;EACf,KAAA;EACA,QAAA,EAAU,WAAW;EACrB,MAAA;EACA,WAAA;EACA,KAAA;EACA,UAAA;AAAA;AAAA,UAGe,gBAAA;EACf,KAAA;EACA,KAAA;EACA,YAAA;EACA,MAAA;EACA,WAAA;EACA,KAAA;EACA,iBAAA;AAAA;AAAA,UAGe,WAAA;EACf,EAAA;EACA,IAAI;AAAA;AAAA,UAGW,gBAAA;EACf,KAAA;EACA,MAAA;EACA,GAAA;EACA,MAAA,GAAS,WAAW;AAAA;AAAA,UAGL,eAAA;EACf,IAAA;EACA,KAAK;AAAA;AAAA,UAGU,eAAA;EACf,OAAA,IAAW,IAAA;EACX,OAAA,IAAW,KAAA;AAAA;AAAA,UAGI,YAAA;EACf,IAAA;EACA,IAAA;EACA,SAAA;EACA,UAAA;EACA,YAAA;AAAA;;;iBCjDc,gBAAA,CAAiB,QAAuB,EAAb,WAAW;AAAA,iBAuCtC,mBAAA,CAAoB,OAAA,EAAS,gBAAA,GAAmB,WAAW;AAAA,iBAyC3D,cAAA,CAAe,KAAyB;;;iBCzFxC,mBAAA,CAAoB,MAAA,WAAiB,WAAW;AAAA,iBAWhD,iBAAA,CAAkB,MAAA,EAAQ,WAAW;;;;;;;;;iBAarC,mBAAA,CAAoB,MAAA,EAAQ,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UCjBtC,mBAAA;EACf,SAAA;EACA,UAAA;EACA,SAAA;EACA,gBAAA;EACA,iBAAA;EACA,IAAA;AAAA;AAAA,cAOW,YAAA;EAAA,SACF,SAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;EAAA,SACA,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,IAAA;EAAA,QACD,UAAA;EAAA,QACA,UAAA;EAAA,iBACS,QAAA;EAAA,iBACA,cAAA;cAEL,OAAA,GAAS,mBAAA;EAgBf,UAAA,CACJ,OAAA;IAAW,OAAA;EAAA,IACV,OAAA,CAAQ,WAAA;EA4BL,GAAA,CACJ,OAAA,EAAS,gBAAA,EACT,MAAA,GAAQ,eAAA,GACP,OAAA,CAAQ,eAAA;EAUX,QAAA;EAAA,QAIQ,gBAAA;EAAA,QAmCA,aAAA;AAAA;;;iBC7FY,WAAA,CAAY,MAAA,GAAQ,YAAA,GAAiB,OAAA,CAAA,IAAA,CAAA,MAAA,QAAA,IAAA,CAAA,eAAA,SAAA,IAAA,CAAA,cAAA"}