[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_271":-5,"_274":275,"_276":277},"routes/shell",{"_40":41,"_270":-5,"_271":-5,"_272":273},"routes/repo",{"_33":-7,"_34":35,"_36":37,"_38":39,"_40":41,"_42":31,"_43":31,"_44":31,"_45":31,"_46":31,"_47":31,"_48":49,"_50":49,"_51":31,"_52":-7,"_53":-7,"_54":55,"_56":57,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68},"routes/repo.blob",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":14,"_22":23,"_24":-5,"_25":26,"_27":28,"_28":29,"_30":31,"_32":14},"ref","cf89a0f2bb59cd56f584b4df17c24cdc406cc99e","path","apps/desktop/src/helper.ts","oid","717105b691c0846078f696c4e4d4083167a439ea","size",5672,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","import { existsSync, rmSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nimport { Utils } from \"electrobun/bun\";\n\nimport { token } from \"@ace/host/auth\";\nimport { config } from \"@ace/host/config\";\nimport { GatewayClient } from \"@ace/host/gateway-client\";\nimport { health } from \"@ace/host/health\";\n\nimport type { HelperAction, HelperState } from \"./protocol\";\nimport { service } from \"./service\";\n\nasync function wait(check: () => Promise, message: string): Promise {\n\tconst deadline = Date.now() + 30_000;\n\twhile (Date.now() < deadline) {\n\t\tif (await check()) return;\n\t\tawait Bun.sleep(100);\n\t}\n\tthrow new Error(message);\n}\n\nasync function exited(pid: number): Promise {\n\tawait wait(async () => {\n\t\ttry {\n\t\t\tprocess.kill(pid, 0);\n\t\t\treturn false;\n\t\t} catch (error) {\n\t\t\tif ((error as NodeJS.ErrnoException).code === \"ESRCH\") return true;\n\t\t\tthrow error;\n\t\t}\n\t}, \"Ace Helper is still shutting down. Check its log before trying again.\");\n}\n\nexport function helper(identifier: string, lane: boolean) {\n\tconst agent = service(identifier);\n\tconst receipt = join(config.home, \"desktop-update.json\");\n\t// A checkout's build uses its own source host; a registered service would outlive that code.\n\tconst isolated =\n\t\t`This development build only uses the Ace host started by bun run dev from its checkout, on port ${config.port}.`;\n\tlet changing = false;\n\n\tasync function info() {\n\t\tconst found = await health(config.port);\n\t\tif (found && found.home !== config.home) {\n\t\t\tthrow new Error(\n\t\t\t\t`Port ${config.port} belongs to an Ace host using a different data directory`,\n\t\t\t);\n\t\t}\n\t\treturn found;\n\t}\n\n\tasync function status(): Promise {\n\t\tconst found = await info();\n\t\treturn {\n\t\t\tservice: lane ? \"unregistered\" as const : agent.status(),\n\t\t\trunning: !!found,\n\t\t\tmanaged: !!found?.helper,\n\t\t};\n\t}\n\n\tasync function start(): Promise {\n\t\tif (lane) throw new Error(isolated);\n\t\tif (agent.status() === \"unregistered\") agent.register();\n\t\tif (agent.status() === \"approval\") {\n\t\t\tagent.settings();\n\t\t\tthrow new Error(\"Allow Ace in macOS Login Items, then start Ace Helper again.\");\n\t\t}\n\t\tconst child = Bun.spawn([\n\t\t\t\"/bin/launchctl\",\n\t\t\t\"kickstart\",\n\t\t\t`gui/${process.getuid!()}/${identifier}.helper`,\n\t\t], { stdout: \"ignore\", stderr: \"ignore\" });\n\t\tif (await child.exited !== 0) {\n\t\t\tthrow new Error(\"Could not start Ace Helper. Check macOS Login Items.\");\n\t\t}\n\t\tawait wait(async () => {\n\t\t\tconst found = await info();\n\t\t\tif (found && !found.helper) throw new Error(\"This port is in use by a command-line host.\");\n\t\t\treturn !!found;\n\t\t}, `Ace Helper did not start. See ${join(config.home, \"helper.log\")}`);\n\t}\n\n\tasync function request(op: \"update-prepare\" | \"update-cancel\") {\n\t\tconst client = new GatewayClient(`ws://127.0.0.1:${config.port}/ws`, token());\n\t\tlet timer: ReturnType | undefined;\n\t\ttry {\n\t\t\treturn await Promise.race([\n\t\t\t\t(async () => {\n\t\t\t\t\tawait wait(async () => client.status === \"open\", \"Could not connect to Ace Helper\");\n\t\t\t\t\treturn client.request<{ ready: boolean } | null>({ op });\n\t\t\t\t})(),\n\t\t\t\tnew Promise((_, reject) => {\n\t\t\t\t\ttimer = setTimeout(\n\t\t\t\t\t\t() => reject(new Error(\"Ace Helper did not finish preparing the update\")),\n\t\t\t\t\t\t30_000,\n\t\t\t\t\t);\n\t\t\t\t}),\n\t\t\t]);\n\t\t} finally {\n\t\t\tclearTimeout(timer);\n\t\t\tclient.close();\n\t\t}\n\t}\n\n\tasync function prepare(): Promise {\n\t\tif (changing) throw new Error(\"Ace Helper is already changing state\");\n\t\tchanging = true;\n\t\ttry {\n\t\t\tconst found = await info();\n\t\t\tif (!found?.helper || agent.status() !== \"enabled\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"Start Ace Helper before installing an update. Command-line hosts cannot be updated from the app.\",\n\t\t\t\t);\n\t\t\t}\n\t\t\t// Recovery is needed even if the desktop exits between pausing and unregistering.\n\t\t\twriteFileSync(receipt, JSON.stringify({ helper: true }), { mode: 0o600 });\n\t\t\tif (!(await request(\"update-prepare\"))?.ready) {\n\t\t\t\tthrow new Error(\"This Ace Helper cannot prepare an update. Restart it and try again.\");\n\t\t\t}\n\t\t\tagent.unregister();\n\t\t\tawait exited(found.pid);\n\t\t} finally {\n\t\t\tchanging = false;\n\t\t}\n\t}\n\n\tasync function recover(): Promise {\n\t\tif (!existsSync(receipt)) return;\n\t\tconst found = await info();\n\t\tif (found && !found.helper) throw new Error(\"Stop the command-line host to resume Ace Helper\");\n\t\tif (found) await request(\"update-cancel\");\n\t\telse await start();\n\t\trmSync(receipt);\n\t}\n\n\tasync function act(action: HelperAction): Promise {\n\t\tif (action === \"status\") return status();\n\t\tif (action === \"settings\") {\n\t\t\tagent.settings();\n\t\t\treturn status();\n\t\t}\n\t\tif (action === \"log\") {\n\t\t\tUtils.showItemInFolder(join(config.home, \"helper.log\"));\n\t\t\treturn status();\n\t\t}\n\t\tif (lane) throw new Error(isolated);\n\t\tif (changing) throw new Error(\"Ace Helper is already changing state. Wait for it to finish.\");\n\t\tchanging = true;\n\t\ttry {\n\t\t\tconst found = await info();\n\t\t\tif (found && !found.helper) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"Ace is connected to a command-line host. Stop ace serve before managing Ace Helper.\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (action === \"stop\") {\n\t\t\t\tif (agent.status() !== \"unregistered\") agent.unregister();\n\t\t\t\tif (found) await exited(found.pid);\n\t\t\t} else if (action === \"restart\") {\n\t\t\t\tif (!found) throw new Error(\"Start Ace Helper before restarting it.\");\n\t\t\t\tprocess.kill(found.pid, \"SIGTERM\");\n\t\t\t\tawait exited(found.pid);\n\t\t\t\tawait start();\n\t\t\t} else if (action === \"start\") {\n\t\t\t\tif (!found) await start();\n\t\t\t} else {\n\t\t\t\tthrow new Error(\"Unknown Ace Helper action\");\n\t\t\t}\n\t\t\treturn await status();\n\t\t} finally {\n\t\t\tchanging = false;\n\t\t}\n\t}\n\n\treturn { status, act, prepare, recover, pending: () => existsSync(receipt) };\n}\n","editable",false,"branch","documentNavigation","repo","githubnext/ace2","repoId","938fe4cd-5320-4e4f-ac7c-87d4dad8490c","ownerId","org:89615882","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers","watching","pinned","notify","views",[226,227,228,229,230,231,232,233,234,235,236,237,238],"navigation",{"_54":55,"_182":183,"_184":185,"_186":187,"_188":189,"_190":191,"_192":193},"sources",[],"viewer","meta",{"_174":175,"_176":177,"_178":179,"_42":31,"_180":166,"_181":31,"_48":49,"_50":49},"branches",[81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173],"tags",[69,70,71,72,73,74,75,76,77,78,79,80],"cloneUrl","https://git.nexthub.sh/githubnext/ace2.git","desktop-canary-v0.0.10","desktop-canary-v0.0.11","desktop-canary-v0.0.12","desktop-canary-v0.0.13","desktop-canary-v0.0.14","desktop-canary-v0.0.15","desktop-canary-v0.0.16","desktop-canary-v0.0.18","desktop-canary-v0.0.21","desktop-canary-v0.0.7","desktop-canary-v0.0.8","desktop-canary-v0.0.9","amber-beacon/composer-effort","brisk-ember/github-avatars","brisk-grove/image-paste-91","calm-anchor/fix-streaming-draft-overlap","calm-grove/composer-agent-mode","cloud-pilot-ops/canary-0-0-17","cloud-pilot-ops/cloud-move","cloud-pilot-ops/cloud-pilot","codex/agentation-shortcut","codex/annotation-polish","codex/browser-pages","codex/canary-0-0-21","codex/canary-0.0.11","codex/channel-delete-close","codex/channel-watch-recovery","codex/clipboard-files-write","codex/composer-coordinate-check","codex/computer-use-validation","codex/desktop-actions","codex/desktop-app-search","codex/desktop-app-state","codex/desktop-availability","codex/desktop-click-variants","codex/desktop-clipboard","codex/desktop-clipboard-files","codex/desktop-clipboard-image","codex/desktop-clipboard-image-write","codex/desktop-clipboard-text","codex/desktop-drag","codex/desktop-keyboard","codex/desktop-launch","codex/desktop-locked-feedback","codex/desktop-menu-command","codex/desktop-menu-inventory","codex/desktop-minimize","codex/desktop-open","codex/desktop-pointer","codex/desktop-quit","codex/desktop-selection-keys","codex/desktop-tool-guidance","codex/desktop-tools-extraction","codex/desktop-window-close","codex/desktop-window-geometry","codex/desktop-windows","codex/dev-permission-identity","codex/durable-composer-drafts","codex/fix-message-clipping","codex/lane-base-96","codex/native-patch-prefix","codex/peekaboo","codex/peer-channel-messaging","codex/pixel-snapshot-authority","codex/publish-canary-0-0-21","codex/readme-security","codex/settings-refresh","codex/stale-click-refusal","codex/tab-renaming-api","codex/team-agent-access","codex/team-channel-sections","codex/team-dogfood-integration","codex/webkit-coordinate-window","codex/webkit-desktop-focus","deft-beacon/helper-isolation","deft-grove/align-avatar-byline","deft-grove/build-canary-0-0-18","deft-grove/canary-github-releases","deft-grove/ship-canary-0-0-18","deft-meadow/details-sidebar","fair-ember/canary-0-0-13","fair-ember/canary-0-0-14","fair-fjord/all-projects","feat/github-cache","feat/rebuild","fix/channel-credentials","glad-anchor/restore-message-queue","glad-ember/archive-inactive-channels","glad-fjord/project-identity","glad-orbit/channel-progress","glad-ridge/terminal-replay-input","hazy-anchor/github-row-actions","hazy-ember/channel-access-toggles","hazy-grove/all-projects-add-channel","local-project-setup/build-canary-0-0-20","local-project-setup/canary-0-0-20","local-project-setup/local-project-setup","main","mellow-ridge/canary-0-0-16","mellow-ridge/top-bar-drag-area","nimble-cedar/modal-top-offset","nimble-meadow/canary-0-0-15","remote-channel-load/build-canary-0-0-19","remote-channel-load/canary-0-0-19","remote-channel-load/fix-remote-channel-load","description","Ace: a collaborative coding environment on the team's own machines","owner","githubnext","section","","head","empty","pins",[208,209,210],"documents",{"_203":204,"_205":206},"code",{"_199":200,"_201":202},"automations",{"_196":197,"_198":-5},"delivery",{"_194":49,"_195":-5},"tag","9Rn62lcgXCFfpmCuooTjLxGyUf8","releases","applications","workflows",2,"deployments","commits",215,"changes",1,"counts",{"_207":206},"total",86,"issue",{"_211":201,"_213":224,"_15":201,"_215":225,"_52":217,"_218":31,"_219":217,"_220":202},{"_211":221,"_213":222,"_15":221,"_215":223,"_52":217,"_218":31,"_219":217,"_220":49},{"_211":212,"_213":214,"_15":212,"_215":216,"_52":217,"_218":31,"_219":217,"_220":206},"id","issues","name","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_211":201,"_213":224,"_15":201,"_215":269,"_52":217,"_218":31,"_219":217},{"_211":221,"_213":222,"_15":221,"_215":268,"_52":217,"_218":31,"_219":217},{"_211":212,"_213":214,"_15":212,"_215":267,"_52":217,"_218":31,"_219":217},{"_211":264,"_213":265,"_15":264,"_215":266,"_52":31,"_218":31,"_219":217},{"_211":261,"_213":262,"_15":261,"_215":263,"_52":31,"_218":31,"_219":217},{"_211":196,"_213":259,"_15":188,"_215":260,"_52":31,"_218":31,"_219":217},{"_211":198,"_213":256,"_15":257,"_215":258,"_52":31,"_218":31,"_219":217},{"_211":194,"_213":254,"_15":194,"_215":255,"_52":31,"_218":31,"_219":217},{"_211":250,"_213":251,"_15":252,"_215":253,"_52":31,"_218":31,"_219":217},{"_211":184,"_213":248,"_15":184,"_215":249,"_52":31,"_218":31,"_219":31},{"_211":245,"_213":246,"_15":245,"_215":247,"_52":31,"_218":31,"_219":31},{"_211":242,"_213":243,"_15":242,"_215":244,"_52":31,"_218":31,"_219":31},{"_211":239,"_213":240,"_15":239,"_215":241,"_52":31,"_218":31,"_219":31},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794439195227,"sidebar","expanded"]