[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_1410":-5,"_1646":1647,"_1648":1649},"routes/shell",{"_1426":1427,"_1644":-5,"_1410":-5,"_27":1645},"routes/repo",{"_1420":-7,"_1421":1422,"_1423":18,"_1424":1425,"_1426":1427,"_1428":22,"_1429":22,"_1430":22,"_21":22,"_1431":22,"_1432":22,"_1433":852,"_1434":852,"_1435":22,"_1436":-7,"_1437":-7,"_1438":1439,"_1440":1441,"_1442":1443,"_34":-5,"_1444":1445,"_1446":1447,"_1448":1449,"_1450":1451},"routes/repo.changes.$number.files",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28,"_29":22,"_30":31,"_32":33,"_34":-5},"actorNames",{"_1411":1419},"selections",{},"repositoryId","938fe4cd-5320-4e4f-ac7c-87d4dad8490c","change",{"_1377":1378,"_53":19,"_1379":18,"_1380":1381,"_1382":1383,"_1384":1385,"_1386":1387,"_1388":1389,"_1390":1391,"_1392":1393,"_1394":1395,"_1396":1397,"_1398":1399,"_1400":1401,"_1402":1403,"_1404":22,"_1405":22,"_1406":1407},"maintainer",false,"commits",5,"diff",{"_35":36,"_37":38,"_39":40,"_41":22},"agents",[],"computing","comments",[],"reactions",{},"viewer","old","eee1a39b98bb63fea09290a5fb9dc65107615fc7","new","5c0dfb16283cd6382a2146ded36f3f6f17f3848d","files",[42,43,44,45,46,47,48],"truncated",{"_49":1223,"_35":1224,"_37":1225,"_53":54,"_55":183,"_57":442,"_59":1226},{"_49":873,"_35":-5,"_37":874,"_53":54,"_55":875,"_57":852,"_59":876},{"_49":849,"_35":850,"_37":851,"_53":54,"_55":384,"_57":852,"_59":853},{"_49":438,"_35":439,"_37":440,"_53":54,"_55":441,"_57":442,"_59":443},{"_49":401,"_35":402,"_37":403,"_53":54,"_55":24,"_57":384,"_59":404},{"_49":270,"_35":271,"_37":272,"_53":54,"_55":273,"_57":24,"_59":274},{"_49":50,"_35":51,"_37":52,"_53":54,"_55":56,"_57":58,"_59":60},"path","packages/channel/src/desktop.ts",{"_265":269,"_267":268},{"_265":266,"_267":268},"kind","text","add",64,"del",2,"hunks",[61,62,63,64,65],{"_66":225,"_68":181,"_70":225,"_72":137,"_74":226},{"_66":206,"_68":181,"_70":207,"_72":181,"_74":208},{"_66":180,"_68":181,"_70":182,"_72":183,"_74":184},{"_66":135,"_68":69,"_70":136,"_72":137,"_74":138},{"_66":67,"_68":69,"_70":71,"_72":73,"_74":75},"aStart",173,"aLen",6,"bStart",206,"bLen",35,"ops",[76,77,78,79,80,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":134},{"_111":112,"_113":133},{"_111":112,"_113":117},{"_111":55,"_113":116},{"_111":55,"_113":132},{"_111":55,"_113":114},{"_111":55,"_113":131},{"_111":55,"_113":130},{"_111":55,"_113":129},{"_111":55,"_113":128},{"_111":55,"_113":120},{"_111":55,"_113":119},{"_111":55,"_113":127},{"_111":55,"_113":117},{"_111":55,"_113":116},{"_111":55,"_113":126},{"_111":55,"_113":114},{"_111":55,"_113":125},{"_111":55,"_113":121},{"_111":55,"_113":120},{"_111":55,"_113":119},{"_111":55,"_113":124},{"_111":55,"_113":117},{"_111":55,"_113":116},{"_111":55,"_113":123},{"_111":55,"_113":114},{"_111":55,"_113":122},{"_111":55,"_113":121},{"_111":55,"_113":120},{"_111":55,"_113":119},{"_111":55,"_113":118},{"_111":55,"_113":117},{"_111":112,"_113":116},{"_111":112,"_113":115},{"_111":112,"_113":114},"tag","eq","line","\t\t\t\tdescription:","\t\t\t\tname: \"desktop_inspect\",","\t\t\tdefineTool({","\t\t\t}),","\t\t\t\texecute: async ({ target }, api, context) => act({ op: \"restore\", target }, api, context),","\t\t\t\texecutionMode: \"sequential\",","\t\t\t\treplay: \"unsafe\",","\t\t\t\tparameters: Type.Object({ target: windowTarget }),","\t\t\t\t\t\"Unminimize one exact native window using background Accessibility delivery. Pass its target object from desktop_windows unchanged. This does not promise foreground focus. Native checks bind restore to the observed process generation, window ID and bounds; no inspection snapshot is required. Use refreshed inventory and inspect again before input. Never blindly repeat an interrupted restore.\",","\t\t\t\tname: \"desktop_restore\",","\t\t\t\texecute: async ({ target }, api, context) => act({ op: \"focus\", target }, api, context),","\t\t\t\t\t\"Bring one exact native window to the foreground, activating its application and switching Spaces when needed. Pass its target object from desktop_windows unchanged. This explicitly changes the user's desktop; it is never an automatic inspection fallback. Native checks bind it to the observed process generation, window ID and bounds. Restore a minimized window explicitly first, then use its refreshed target. Inspect again before input; never blindly repeat interrupted focus.\",","\t\t\t\tname: \"desktop_focus\",","\t\t\t\texecute: async ({ target }, api, context) => act({ op: \"activate\", target }, api, context),","\t\t\t\t}),","\t\t\t\t\ttarget: Type.Object(appTarget, { additionalProperties: false }),","\t\t\t\tparameters: Type.Object({","\t\t\t\t\t\"Bring one running application to the foreground on this channel's execution host. Pass its target object from desktop_apps unchanged. This explicitly changes the user's active app and can change the visible Space. It does not launch an app or choose a window. Native checks bind activation to the observed process generation. The result refreshes application/window inventory; inspect a selected window before input. Never blindly repeat an interrupted activation.\",","\t\t\t\tname: \"desktop_activate\",","\t\t\t\t\tresult(await execute({ op: \"windows\", pid }, context)),","\t\t\t\texecute: async ({ pid }, _api, context) =>",146,164,21,[139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159],{"_111":112,"_113":174},{"_111":112,"_113":179},{"_111":112,"_113":178},{"_111":55,"_113":177},{"_111":55,"_113":176},{"_111":55,"_113":175},{"_111":55,"_113":174},{"_111":55,"_113":173},{"_111":55,"_113":172},{"_111":55,"_113":171},{"_111":55,"_113":170},{"_111":55,"_113":169},{"_111":55,"_113":168},{"_111":55,"_113":167},{"_111":55,"_113":166},{"_111":55,"_113":165},{"_111":55,"_113":164},{"_111":55,"_113":163},{"_111":112,"_113":162},{"_111":112,"_113":161},{"_111":112,"_113":160},"\t\ty: Type.Number({ minimum: 0, exclusiveMaximum: 1 }),","\t\tx: Type.Number({ minimum: 0, exclusiveMaximum: 1 }),","\tconst point = Type.Object({","\t}, { additionalProperties: false });","\t\tis_minimized: Type.Boolean(),","\t\t}, { additionalProperties: false }),","\t\t\theight: Type.Number({ exclusiveMinimum: 0 }),","\t\t\twidth: Type.Number({ exclusiveMinimum: 0 }),","\t\t\ty: Type.Number(),","\t\t\tx: Type.Number(),","\t\tbounds: Type.Object({","\t\twindow_id: Type.Integer({ minimum: 1, maximum: 4_294_967_295 }),","\t\t...appTarget,","\tconst windowTarget = Type.Object({","\t};","\t\tprocess_start_identity_decimal: Type.String({ pattern: \"^[1-9][0-9]{0,19}$\" }),","\t\tpid: Type.Integer({ minimum: 1, maximum: 2_147_483_647 }),","\tconst appTarget = {","\tconst element = Type.String({ minLength: 1, maxLength: 256 });","\tconst snapshot = Type.String({ minLength: 1, maxLength: 256 });",121,7,135,11,[185,186,187,188,189,190,191,192,193,194,195,196],{"_111":112,"_113":198},{"_111":112,"_113":205},{"_111":112,"_113":204},{"_111":57,"_113":203},{"_111":55,"_113":202},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":201},{"_111":55,"_113":200},{"_111":112,"_113":199},{"_111":112,"_113":198},{"_111":112,"_113":197},"function result(value: DesktopResult): ToolExecutionResult {","","}","\treturn request.op === \"activate\" || request.op === \"focus\" || request.op === \"restore\";","export function isDesktopManagement(request: DesktopRequest): request is DesktopManagement {","\t\t|| request.op === \"select\" || isDesktopManagement(request);","\t\t|| request.op === \"select\";","\treturn request.op === \"click\" || request.op === \"type\" || request.op === \"key\"","export function isDesktopAction(request: DesktopRequest): request is DesktopAction {",108,122,[209,210,211,212,213,214,215,216],{"_111":112,"_113":224},{"_111":112,"_113":223},{"_111":112,"_113":222},{"_111":57,"_113":221},{"_111":55,"_113":220},{"_111":112,"_113":219},{"_111":112,"_113":218},{"_111":112,"_113":217},"export type DesktopResult = {","export type DesktopOutcome = \"completed\" | \"refused\" | \"unknown\";",">;","\t{ op: \"click\" | \"type\" | \"key\" | \"select\" | \"activate\" | \"focus\" | \"restore\" }","\t{ op: \"click\" | \"type\" | \"key\" | \"select\" }","\tDesktopRequest,","export type DesktopAction = Extract<","export type DesktopSelection = (typeof DESKTOP_SELECTIONS)[number];",10,[227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247],{"_111":112,"_113":198},{"_111":112,"_113":264},{"_111":112,"_113":198},{"_111":55,"_113":263},{"_111":55,"_113":262},{"_111":55,"_113":261},{"_111":55,"_113":256},{"_111":55,"_113":260},{"_111":55,"_113":259},{"_111":55,"_113":258},{"_111":55,"_113":257},{"_111":55,"_113":256},{"_111":55,"_113":255},{"_111":55,"_113":254},{"_111":55,"_113":253},{"_111":55,"_113":198},{"_111":112,"_113":252},{"_111":55,"_113":251},{"_111":112,"_113":250},{"_111":112,"_113":249},{"_111":112,"_113":248},"\t| { op: \"inspect\"; pid: number; window: number; mode?: \"accessibility\" | \"pixels\" }","\t| { op: \"windows\"; pid: number }","\t| { op: \"apps\"; query?: string }","\t| DesktopManagement","export type DesktopRequest =","\t| { op: \"focus\" | \"restore\"; target: DesktopWindowTarget };","\t| { op: \"activate\"; target: DesktopAppTarget }","export type DesktopManagement =","};","\tis_minimized: boolean;","\tbounds: { x: number; y: number; width: number; height: number };","\twindow_id: number;","export type DesktopWindowTarget = DesktopAppTarget & {","\tprocess_start_identity_decimal: string;","\tpid: number;","export type DesktopAppTarget = {","import type { Image } from \"./protocol\";","oid","01686c4","mode","100644","cfff958","docs/desktop-tools.md",{"_265":400,"_267":268},{"_265":399,"_267":268},20,[275,276,277,278],{"_66":384,"_68":69,"_70":384,"_72":69,"_74":385},{"_66":355,"_68":69,"_70":355,"_72":356,"_74":357},{"_66":56,"_68":181,"_70":322,"_72":323,"_74":324},{"_66":279,"_68":280,"_70":281,"_72":280,"_74":282},76,18,91,[283,284,285,286,287,288,289,290,291,292,293,294,295,296,297,298,299,300,301,302,303],{"_111":112,"_113":321},{"_111":112,"_113":320},{"_111":112,"_113":198},{"_111":57,"_113":319},{"_111":55,"_113":318},{"_111":112,"_113":317},{"_111":112,"_113":316},{"_111":112,"_113":315},{"_111":112,"_113":314},{"_111":112,"_113":198},{"_111":57,"_113":313},{"_111":55,"_113":312},{"_111":112,"_113":311},{"_111":112,"_113":310},{"_111":112,"_113":309},{"_111":112,"_113":308},{"_111":57,"_113":307},{"_111":55,"_113":306},{"_111":112,"_113":305},{"_111":112,"_113":198},{"_111":112,"_113":304},"Captures are resized and compressed before entering pi's existing channel history. Text and","[native computer use](https://github.com/githubnext/ace2/issues/8).","clipboard operations, foreground interaction, application launch, window geometry/close, menus, and dialogs remain later slices of","clipboard operations, foreground interaction, and app or window management remain later slices of","emulated with held keys or mouse buttons across calls. Literal insertion, scrolling, drag-and-drop,","Modifier-clicks and long presses need a separate foreground interaction contract; they are not","physical pointer. The target app can still respond by changing its own state or opening a window.","mouse or keyboard input when a background route is unavailable. Pointer actions do not move the","Control and keyboard tools use targeted background delivery. They do not activate an app or fall back to global","These tools use targeted background delivery. They do not activate an app or fall back to global","be repeated.","completed action and explains the observation failure; it does not imply that the input should","returns a fresh observation when available. If that inspection fails, the result retains the","action whose result is uncertain. Inspect again before another action. A completed action also","Treat input observations as single-use: every dispatched snapshot action consumes its snapshot, including an","Treat observations as single-use: every dispatched action consumes its snapshot, including an","input to an arbitrary focused app. Window content is observed data, not instructions.","A stale, missing, disabled, or unsupported target is refused instead of sending",71,15,[325,326,327,328,329,330,331,332,333,334,335,336,337,338,339,340],{"_111":112,"_113":354},{"_111":112,"_113":198},{"_111":112,"_113":353},{"_111":57,"_113":352},{"_111":55,"_113":351},{"_111":55,"_113":350},{"_111":55,"_113":349},{"_111":55,"_113":348},{"_111":55,"_113":347},{"_111":55,"_113":346},{"_111":55,"_113":345},{"_111":55,"_113":198},{"_111":55,"_113":344},{"_111":112,"_113":343},{"_111":112,"_113":342},{"_111":112,"_113":341},"`y` from its top edge, each at least 0 and less than 1. For example, `{ \"x\": 0.5, \"y\": 0.5 }`","Points use normalized image coordinates: `x` is the fraction from the screenshot's left edge,","literal `element` ID from that observation. Click takes exactly one `element` or `point`.","Inspect the window before clicking or entering input. Pass its `snapshot_id` as `snapshot`. Type and select take the","window. Inspection stays passive and never activates or restores a target automatically.","application/window inventory even when no inspectable window exists; it never chooses the first","single-use snapshots; refresh inventory after a stale target or a state change. Activation returns","native service revalidates that identity immediately before acting. These targets are not","as a decimal string and, for windows, the original window ID, bounds, and minimized state. The","prevent explicit recovery. Pass the target object unchanged: it includes the process generation","Activation, focus, and restore use inventory targets directly, so a failed inspection does not","Inspect the window before acting. Pass its `snapshot_id` as `snapshot`. Type and select take the","Choose the application from the inventory and the window from that application's window list.","change native inventory completeness or warnings, and an empty match is not proof an app stopped.",31,13,[358,359,360,361,362,363,364,365,366,367,368,369,370],{"_111":112,"_113":383},{"_111":112,"_113":382},{"_111":112,"_113":381},{"_111":55,"_113":380},{"_111":55,"_113":379},{"_111":55,"_113":378},{"_111":55,"_113":377},{"_111":55,"_113":376},{"_111":55,"_113":375},{"_111":55,"_113":374},{"_111":112,"_113":373},{"_111":112,"_113":372},{"_111":112,"_113":371}," Set `mode` to `pixels` for an explicit read-only screenshot when Accessibility is unavailable."," a screenshot without activating the window or changing keyboard focus.","- `desktop_inspect` reads one explicit process and window ID, returning accessibility text and"," before focusing it, using the refreshed target for the later action."," Accessibility delivery. It does not promise foreground focus. Restore a minimized window","- `desktop_restore` unminimizes one exact window using its inventory `target` and background"," `desktop_windows`, activating its app and switching Spaces when needed.","- `desktop_focus` brings one exact window to the foreground using its `target` from"," `desktop_apps`. It can change the visible Space; it does not launch an app or select a window.","- `desktop_activate` brings a running application to the foreground using its `target` from","- `desktop_windows` lists windows for an application process ID."," the result. Use a nonblank query of at most 256 characters to find apps omitted from a large list."," Optional `query` searches application names and bundle IDs case-insensitively before Ace bounds",1,[386,387,388,389,390,391,392],{"_111":112,"_113":398},{"_111":112,"_113":198},{"_111":57,"_113":397},{"_111":55,"_113":396},{"_111":112,"_113":395},{"_111":112,"_113":394},{"_111":112,"_113":393},"targeted input. The model receives the accessibility text, screenshot, and action outcome. The","[Peekaboo](https://github.com/openclaw/Peekaboo) for macOS Accessibility, screen capture, and","field values, select text, and send keys or shortcuts on the machine running the channel's tools. It uses","Ace's pi harness can inspect applications and windows, activate apps, focus or restore windows, click observed controls, replace editable","Ace's pi harness can inspect applications and windows, click observed controls, replace editable","# Native desktop tools","92887b6","0cb482f","docs/architecture.md",{"_265":437,"_267":268},{"_265":436,"_267":268},[405],{"_66":406,"_68":407,"_70":406,"_72":408,"_74":409},179,8,12,[410,411,412,413,414,415,416,417,418,419,420,421,422],{"_111":112,"_113":435},{"_111":112,"_113":434},{"_111":112,"_113":433},{"_111":57,"_113":432},{"_111":55,"_113":431},{"_111":112,"_113":430},{"_111":55,"_113":429},{"_111":55,"_113":428},{"_111":55,"_113":427},{"_111":55,"_113":426},{"_111":112,"_113":425},{"_111":112,"_113":424},{"_111":112,"_113":423},"accessibility text and resizes screenshots before returning them. Explicit pixel inspection preserves","completed operations, refusals before dispatch, and uncertain delivery. The host bounds","Pi records their intent and never automatically replays an interrupted action. Results distinguish","implicitly. App-only action receipts refresh inventories without inventing a selected window.","activation and focus explicitly change the foreground desktop. Inspection never activates a target","window bounds where applicable. The native service revalidates those receipts before dispatch;","Separate activation, focus, and restore tools accept generation-bound inventory targets, with exact","snapshot's exact process, window, and controls; every dispatched action requires a new observation.","points are normalized and mapped through the snapshot's native capture geometry. Control input uses background delivery bound to a","points are normalized and mapped through the snapshot's native capture geometry. Actions use background delivery bound to a","clicks, replacement of editable field values, text selection, and keys or shortcuts. Screenshot","signing team. Tools expose application and window inventories, observation, element or screenshot","accepts only the client's exact identifier signed by Ace's team; the client verifies the host's","94910b6","e625140","apps/host/src/desktop.ts",{"_265":848,"_267":268},{"_265":847,"_267":268},156,4,[444,445,446,447,448,449,450],{"_66":408,"_68":225,"_70":408,"_72":408,"_74":823},{"_66":807,"_68":181,"_70":355,"_72":181,"_74":808},{"_66":793,"_68":69,"_70":794,"_72":181,"_74":795},{"_66":728,"_68":69,"_70":729,"_72":730,"_74":731},{"_66":710,"_68":181,"_70":711,"_72":181,"_74":712},{"_66":687,"_68":225,"_70":688,"_72":183,"_74":689},{"_66":451,"_68":225,"_70":452,"_72":453,"_74":454},442,478,126,[455,456,457,458,459,460,461,462,463,464,465,466,467,468,469,470,471,472,473,474,475,476,477,478,479,480,481,482,483,484,485,486,487,488,489,490,491,492,493,494,495,496,497,498,499,500,501,502,503,504,505,506,507,508,509,510,511,512,513,514,515,516,517,518,519,520,521,522,523,524,525,526,527,528,529,530,531,532,533,534,535,536,537,538,539,540,541,542,543,544,545,546,547,548,549,550,551,552,553,554,555,556,557,558,559,560,561,562,563,564,565,566,567,568,569,570,571,572,573,574,575,576,577,578,579,580,581],{"_111":112,"_113":601},{"_111":112,"_113":199},{"_111":112,"_113":198},{"_111":55,"_113":686},{"_111":55,"_113":685},{"_111":55,"_113":616},{"_111":55,"_113":684},{"_111":55,"_113":683},{"_111":55,"_113":682},{"_111":55,"_113":681},{"_111":55,"_113":599},{"_111":55,"_113":680},{"_111":55,"_113":679},{"_111":55,"_113":678},{"_111":55,"_113":677},{"_111":55,"_113":676},{"_111":55,"_113":582},{"_111":55,"_113":607},{"_111":55,"_113":606},{"_111":55,"_113":675},{"_111":55,"_113":674},{"_111":55,"_113":673},{"_111":55,"_113":672},{"_111":55,"_113":601},{"_111":55,"_113":614},{"_111":55,"_113":671},{"_111":55,"_113":670},{"_111":55,"_113":669},{"_111":55,"_113":668},{"_111":55,"_113":667},{"_111":55,"_113":666},{"_111":55,"_113":665},{"_111":55,"_113":664},{"_111":55,"_113":663},{"_111":55,"_113":610},{"_111":55,"_113":662},{"_111":55,"_113":661},{"_111":55,"_113":660},{"_111":55,"_113":659},{"_111":55,"_113":658},{"_111":55,"_113":657},{"_111":55,"_113":656},{"_111":55,"_113":655},{"_111":55,"_113":654},{"_111":55,"_113":653},{"_111":55,"_113":652},{"_111":55,"_113":651},{"_111":55,"_113":650},{"_111":55,"_113":610},{"_111":55,"_113":649},{"_111":55,"_113":636},{"_111":55,"_113":610},{"_111":55,"_113":648},{"_111":55,"_113":647},{"_111":55,"_113":610},{"_111":55,"_113":646},{"_111":55,"_113":645},{"_111":55,"_113":644},{"_111":55,"_113":643},{"_111":55,"_113":642},{"_111":55,"_113":641},{"_111":55,"_113":640},{"_111":55,"_113":639},{"_111":55,"_113":638},{"_111":55,"_113":637},{"_111":55,"_113":636},{"_111":55,"_113":610},{"_111":55,"_113":635},{"_111":55,"_113":634},{"_111":55,"_113":633},{"_111":55,"_113":610},{"_111":55,"_113":632},{"_111":55,"_113":631},{"_111":55,"_113":630},{"_111":55,"_113":629},{"_111":55,"_113":628},{"_111":55,"_113":627},{"_111":55,"_113":626},{"_111":55,"_113":625},{"_111":55,"_113":624},{"_111":55,"_113":623},{"_111":55,"_113":622},{"_111":55,"_113":621},{"_111":55,"_113":620},{"_111":55,"_113":619},{"_111":55,"_113":601},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":618},{"_111":55,"_113":617},{"_111":55,"_113":616},{"_111":55,"_113":615},{"_111":55,"_113":614},{"_111":55,"_113":613},{"_111":55,"_113":612},{"_111":55,"_113":611},{"_111":55,"_113":610},{"_111":55,"_113":609},{"_111":55,"_113":608},{"_111":55,"_113":607},{"_111":55,"_113":606},{"_111":55,"_113":605},{"_111":55,"_113":604},{"_111":55,"_113":603},{"_111":55,"_113":602},{"_111":55,"_113":601},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":112,"_113":600},{"_111":112,"_113":599},{"_111":112,"_113":598},{"_111":57,"_113":597},{"_111":55,"_113":596},{"_111":55,"_113":595},{"_111":55,"_113":594},{"_111":55,"_113":593},{"_111":55,"_113":592},{"_111":55,"_113":591},{"_111":55,"_113":590},{"_111":55,"_113":589},{"_111":55,"_113":588},{"_111":55,"_113":587},{"_111":55,"_113":586},{"_111":55,"_113":585},{"_111":112,"_113":584},{"_111":112,"_113":583},{"_111":112,"_113":582},"\t) {","\t\t)","\t\t\trequest.op,","\t\t].includes(","\t\t\t\"restore\",","\t\t\t\"focus\",","\t\t\t\"activate\",","\t\t\t\"select\",","\t\t\t\"key\",","\t\t\t\"type\",","\t\t\t\"click\",","\t\t\t\"inspect\",","\t\t\t\"windows\",","\t\t\t\"apps\",","\t\t|| ![","\t\t|| ![\"apps\", \"windows\", \"inspect\", \"click\", \"type\", \"key\", \"select\"].includes(","\t\t!request","\tif (","export const desktop: Desktop = async (request, context) => {","\t}","\t\t}, \"completed\");","\t\t\t\t\"The native action completed. Later inventory was omitted to fit the result limit; refresh the target without blindly repeating the action.\",","\t\t\tmessage:","\t\t\tobservation_error: data.observation_error || \"The later inventory exceeds the result limit.\",","\t\t\t...action,","\t\treturn actionResult({","\t} catch {","\t\treturn { text, outcome: \"completed\", isError: false };","\t\t}","\t\t\tthrow new Error(\"The later inventory exceeds the result limit.\");","\t\tif (Buffer.byteLength(text) > MAX_TEXT) {","\t\tconst text = Array.isArray(data.windows) ? bounded(data, \"windows\") : JSON.stringify(data);","\ttry {","): DesktopResult {","\taction: Record,","\tdata: Record,","function managementResult(","\t\treturn managementResult(data, action);","\t\t\t\"The native action completed. Later inventory or inspection was unavailable; refresh the target before any further action, without repeating the completed action blindly.\";","\t\tdata.message =","\t\t);","\t\t\t2000,","\t\t\t0,","\t\tdata.observation_error = (error instanceof Error ? error.message : String(error)).slice(","\t} catch (error) {","\t\t};","\t\t\tisError: false,","\t\t\toutcome: \"completed\",","\t\t\timage: observation.image,","\t\t\ttext: bounded({ ...data, ...fresh }, \"ui_elements\"),","\t\treturn {","\t\t\tthrow new Error(\"The application changed process generation before the later inspection.\");","\t\tif (current?.process_start_identity_decimal !== receipt.process_start_identity_decimal) {","\t\tconst current = fresh.target_receipt as Reply[\"target_receipt\"];","\t\t\treturn managementResult(data, action);","\t\t\t\t\"The native action completed. Later inventory or inspection was unavailable; refresh the target before any further action, without repeating the completed action blindly.\";","\t\t\tdata.message =","\t\t\tdata.observation_error = fresh;","\t\tif (observation.isError) {","\t\tconst fresh = JSON.parse(observation.text) as Record;","\t\t}, signal);","\t\t\twindow: receipt.window_id!,","\t\t\tpid: receipt.pid,","\t\t\top: \"inspect\",","\t\tconst observation = await inspect({","\t\t\tthrow new Error(\"The exact window was not returned by the later inventory.\");","\t\tif (!windows.windows.some((window) => window.window_id === receipt.window_id)) {","\t\tif (request.op === \"activate\") {","\t\t\t);","\t\t\t\t\"Later window inventory could not be bound to the original application generation.\",","\t\t\tthrow new Error(","\t\t) {","\t\t\t)","\t\t\t\twindow.process_start_identity_decimal !== receipt.process_start_identity_decimal","\t\t\twindows.windows.some((window) =>","\t\tif (","\t\tdata.windows = windows.windows;","\t\tdata.window_inventory_warnings = windows.inventory_warnings;","\t\tdata.window_inventory_completeness = windows.inventory_completeness;","\t\tif (!Array.isArray(windows.windows)) throw new Error(\"Native window inventory is unavailable.\");","\t\tconst windows = await native([\"windows\", String(receipt.pid)], signal);","\t\t\tthrow new Error(\"The application changed process generation after the action.\");","\t\tif (app.process_start_identity_decimal !== receipt.process_start_identity_decimal) {","\t\tif (!app) throw new Error(\"The target application was not returned by the later inventory.\");","\t\tdata.application = app || null;","\t\tconst app = apps.apps.find((app) => app.pid === receipt.pid);","\t\tdata.application_inventory_warnings = apps.inventory_warnings;","\t\tdata.application_inventory_completeness = apps.inventory_completeness;","\t\tif (!Array.isArray(apps.apps)) throw new Error(\"Native application inventory is unavailable.\");","\t\tconst apps = await native([\"apps\"], signal);","\t\t}, \"unknown\");","\t\t\t\t\"The native action returned a different target receipt. Refresh the target before any retry.\",","\t\t\treason:","\t\t\toutcome: \"unknown\",","\t\t\t: receipt.window_id !== request.target.window_id)","\t\t\t? receipt.window_id !== undefined","\t\t|| (request.op === \"activate\"","\t\t|| receipt.process_start_identity_decimal !== request.target.process_start_identity_decimal","\t\t!receipt || receipt.pid !== request.target.pid","\tconst receipt = action.target_receipt as Reply[\"target_receipt\"];","\tconst data: Record = { action };","): Promise {","\tsignal: AbortSignal,","\trequest: DesktopManagement,","async function observeManagement(",402,437,[690,691,692,693,694,695,696,697,698,699,700,701],{"_111":112,"_113":601},{"_111":112,"_113":709},{"_111":112,"_113":708},{"_111":55,"_113":707},{"_111":112,"_113":706},{"_111":112,"_113":614},{"_111":112,"_113":705},{"_111":57,"_113":704},{"_111":55,"_113":703},{"_111":112,"_113":702},{"_111":112,"_113":610},{"_111":112,"_113":646},"\t\t\tthrow new Error(\"No exact-window action receipt.\");","\t\tif (!receipt?.process_start_identity_decimal || !receipt.window_id) {","\t\tif (!receipt?.process_start_identity_decimal) {","\t\tconst receipt = data.target_receipt as Reply[\"target_receipt\"];","\t// Observation is separate from delivery: its failure must not turn completed input into a retry.","\tif (isDesktopManagement(request)) return await observeManagement(request, data, signal);","\tif (outcome !== \"completed\") return actionResult(data, outcome);","\tconst outcome = data.outcome as DesktopOutcome;",381,416,[713,714,715,716,717,718,719,720],{"_111":112,"_113":727},{"_111":112,"_113":614},{"_111":112,"_113":726},{"_111":57,"_113":725},{"_111":55,"_113":724},{"_111":112,"_113":723},{"_111":112,"_113":722},{"_111":112,"_113":721},"\t\t\t\tdispatched = true;","\t\t\tonDispatch() {","\t\t\tinput: JSON.stringify(request),","\t\tdata = await native([isDesktopManagement(request) ? \"management\" : \"action\"], signal, {","\t\tdata = await native([\"action\"], signal, {","\t\tvalidateAction(request);","\tlet data: Record;",365,368,38,[732,733,734,735,736,737,738,739,740,741,742,743,744,745,746,747,748,749,750,751,752,753,754,755,756,757,758,759,760,761,762,763,764,765,766,767,768,769],{"_111":112,"_113":601},{"_111":112,"_113":199},{"_111":112,"_113":198},{"_111":55,"_113":792},{"_111":55,"_113":791},{"_111":55,"_113":599},{"_111":55,"_113":790},{"_111":55,"_113":789},{"_111":55,"_113":788},{"_111":55,"_113":787},{"_111":55,"_113":786},{"_111":55,"_113":785},{"_111":55,"_113":784},{"_111":55,"_113":657},{"_111":55,"_113":783},{"_111":55,"_113":653},{"_111":55,"_113":782},{"_111":55,"_113":610},{"_111":55,"_113":781},{"_111":55,"_113":601},{"_111":55,"_113":780},{"_111":55,"_113":599},{"_111":55,"_113":779},{"_111":55,"_113":778},{"_111":55,"_113":777},{"_111":55,"_113":776},{"_111":55,"_113":583},{"_111":55,"_113":775},{"_111":55,"_113":582},{"_111":55,"_113":774},{"_111":55,"_113":773},{"_111":55,"_113":622},{"_111":55,"_113":601},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":112,"_113":772},{"_111":112,"_113":771},{"_111":112,"_113":770},"\tif (Buffer.byteLength(text) > MAX_TEXT) {","\tlet text = JSON.stringify({ action: data });","function actionResult(data: Record, outcome: DesktopOutcome): DesktopResult {","\t\t\t\"Pass the window's target object, including its original bounds, from desktop_windows unchanged.\",","\t\tthrow new Error(","\t\t|| window.bounds.width <= 0 || window.bounds.height <= 0","\t\t\tNumber.isFinite,","\t\t|| ![window.bounds.x, window.bounds.y, window.bounds.width, window.bounds.height].every(","\t\t|| typeof window.is_minimized !== \"boolean\" || !window.bounds","\t\t!Number.isInteger(window.window_id) || window.window_id < 1 || window.window_id > 4_294_967_295","\tconst window = request.target;","\t\treturn;","\t\t\tthrow new Error(\"Activation takes an application target from desktop_apps.\");","\t\t\tObject.keys(target).some((key) => ![\"pid\", \"process_start_identity_decimal\"].includes(key))","\tif (request.op === \"activate\") {","\t) throw new Error(\"Pass the application's target object from fresh desktop inventory unchanged.\");","\t\t|| BigInt(target.process_start_identity_decimal) > 18_446_744_073_709_551_615n","\t\t|| !/^[1-9][0-9]{0,19}$/.test(target.process_start_identity_decimal)","\t\t|| typeof target.process_start_identity_decimal !== \"string\"","\t\t|| target.pid < 1 || target.pid > 2_147_483_647","\t\t!target || typeof target !== \"object\" || !Number.isInteger(target.pid)","\tconst target = request.target;","function validateManagement(request: DesktopManagement) {",312,314,[796,797,798,799,800,801,802],{"_111":112,"_113":199},{"_111":112,"_113":198},{"_111":112,"_113":806},{"_111":55,"_113":805},{"_111":112,"_113":804},{"_111":112,"_113":803},{"_111":112,"_113":601},"\t\tthrow new Error(\"Use the snapshot_id from a fresh desktop_inspect result.\");","\tif (typeof request.snapshot !== \"string\" || !request.snapshot || request.snapshot.length > 256) {","\tif (isDesktopManagement(request)) return validateManagement(request);","function validateAction(request: DesktopAction) {",29,[809,810,811,812,813,814,815,816],{"_111":112,"_113":822},{"_111":112,"_113":821},{"_111":112,"_113":820},{"_111":57,"_113":819},{"_111":55,"_113":818},{"_111":112,"_113":256},{"_111":112,"_113":198},{"_111":112,"_113":817},"class NativeError extends Error {","\ttarget_receipt?: { pid: number; window_id?: number; process_start_identity_decimal?: string };","\ttarget_receipt?: { pid: number; window_id: number; process_start_identity_decimal?: string };","\terror?: { code: string; message: string; details?: string };","\tdata: Record | null;","\tsuccess: boolean;",[824,825,826,827,828,829,830,831,832,833,834,835],{"_111":112,"_113":846},{"_111":112,"_113":845},{"_111":112,"_113":844},{"_111":55,"_113":843},{"_111":112,"_113":842},{"_111":112,"_113":841},{"_111":112,"_113":840},{"_111":112,"_113":839},{"_111":55,"_113":838},{"_111":112,"_113":837},{"_111":112,"_113":198},{"_111":112,"_113":836},"import { config } from \"./config\";","} from \"@ace/channel/desktop\";","\tisDesktopManagement,","\tisDesktopAction,","\ttype DesktopResult,","\ttype DesktopRequest,","\ttype DesktopOutcome,","\ttype DesktopManagement,","\ttype DesktopAction,","\tDESKTOP_SELECTIONS,","\tDESKTOP_MODIFIERS,","b18dfeb","24b9c2a","apps/desktop/native/sources/desktop/desktop.swift",{"_265":872,"_267":268},{"_265":871,"_267":268},0,[854],{"_66":855,"_68":69,"_70":855,"_72":181,"_74":856},68,[857,858,859,860,861,862,863],{"_111":112,"_113":870},{"_111":112,"_113":869},{"_111":112,"_113":868},{"_111":55,"_113":867},{"_111":112,"_113":866},{"_111":112,"_113":865},{"_111":112,"_113":864},"\t\t\t\t\trequestTimeoutSeconds: 25","\t\t\t\t\thostKind: .gui,","\t\t\t\t\t],","\t\t\t\t\t\t.activateApplication, .focusWindow, .restoreWindow,","\t\t\t\t\t\t.selectText,","\t\t\t\t\t\t.targetedClick, .exactWindowTargetedClick, .setValue, .exactWindowTargetedHotkey,","\t\t\t\t\t\t.ownsSnapshot, .getDetectionResult, .beginSnapshotMutation, .finishSnapshotMutation,","51e949e","d10e397","apps/desktop/native/sources/client/management.swift",{"_265":1222,"_267":268},192,[877],{"_66":852,"_68":852,"_70":384,"_72":875,"_74":878},[879,880,881,882,883,884,885,886,887,888,889,890,891,892,893,894,895,896,897,898,899,900,901,902,903,904,905,906,907,908,909,910,911,912,913,914,915,916,917,918,919,920,921,922,923,924,925,926,927,928,929,930,931,932,933,934,935,936,937,938,939,940,941,942,943,944,945,946,947,948,949,950,951,952,953,954,955,956,957,958,959,960,961,962,963,964,965,966,967,968,969,970,971,972,973,974,975,976,977,978,979,980,981,982,983,984,985,986,987,988,989,990,991,992,993,994,995,996,997,998,999,1000,1001,1002,1003,1004,1005,1006,1007,1008,1009,1010,1011,1012,1013,1014,1015,1016,1017,1018,1019,1020,1021,1022,1023,1024,1025,1026,1027,1028,1029,1030,1031,1032,1033,1034,1035,1036,1037,1038,1039,1040,1041,1042,1043,1044,1045,1046,1047,1048,1049,1050,1051,1052,1053,1054,1055,1056,1057,1058,1059,1060,1061,1062,1063,1064,1065,1066,1067,1068,1069,1070],{"_111":55,"_113":1221},{"_111":55,"_113":1220},{"_111":55,"_113":1219},{"_111":55,"_113":1218},{"_111":55,"_113":1217},{"_111":55,"_113":198},{"_111":55,"_113":1216},{"_111":55,"_113":1215},{"_111":55,"_113":1214},{"_111":55,"_113":1213},{"_111":55,"_113":1212},{"_111":55,"_113":1211},{"_111":55,"_113":198},{"_111":55,"_113":1210},{"_111":55,"_113":1209},{"_111":55,"_113":1208},{"_111":55,"_113":1207},{"_111":55,"_113":1206},{"_111":55,"_113":1205},{"_111":55,"_113":601},{"_111":55,"_113":198},{"_111":55,"_113":1204},{"_111":55,"_113":1203},{"_111":55,"_113":1202},{"_111":55,"_113":1201},{"_111":55,"_113":1200},{"_111":55,"_113":1199},{"_111":55,"_113":1198},{"_111":55,"_113":1197},{"_111":55,"_113":1196},{"_111":55,"_113":1195},{"_111":55,"_113":1194},{"_111":55,"_113":601},{"_111":55,"_113":198},{"_111":55,"_113":1193},{"_111":55,"_113":1192},{"_111":55,"_113":1191},{"_111":55,"_113":1190},{"_111":55,"_113":1189},{"_111":55,"_113":601},{"_111":55,"_113":198},{"_111":55,"_113":1188},{"_111":55,"_113":1187},{"_111":55,"_113":1186},{"_111":55,"_113":1185},{"_111":55,"_113":1184},{"_111":55,"_113":1183},{"_111":55,"_113":1182},{"_111":55,"_113":1181},{"_111":55,"_113":1180},{"_111":55,"_113":1179},{"_111":55,"_113":1178},{"_111":55,"_113":1177},{"_111":55,"_113":1176},{"_111":55,"_113":583},{"_111":55,"_113":601},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":1175},{"_111":55,"_113":1174},{"_111":55,"_113":1173},{"_111":55,"_113":601},{"_111":55,"_113":1172},{"_111":55,"_113":1171},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":1170},{"_111":55,"_113":1165},{"_111":55,"_113":1169},{"_111":55,"_113":1168},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":1167},{"_111":55,"_113":1166},{"_111":55,"_113":1165},{"_111":55,"_113":1164},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":1163},{"_111":55,"_113":1162},{"_111":55,"_113":1161},{"_111":55,"_113":1160},{"_111":55,"_113":1159},{"_111":55,"_113":1158},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":1157},{"_111":55,"_113":1156},{"_111":55,"_113":1155},{"_111":55,"_113":1154},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":1153},{"_111":55,"_113":1152},{"_111":55,"_113":1151},{"_111":55,"_113":1150},{"_111":55,"_113":1149},{"_111":55,"_113":1148},{"_111":55,"_113":1147},{"_111":55,"_113":1146},{"_111":55,"_113":1145},{"_111":55,"_113":1144},{"_111":55,"_113":1143},{"_111":55,"_113":1142},{"_111":55,"_113":1112},{"_111":55,"_113":1141},{"_111":55,"_113":1140},{"_111":55,"_113":1139},{"_111":55,"_113":610},{"_111":55,"_113":1138},{"_111":55,"_113":1137},{"_111":55,"_113":1136},{"_111":55,"_113":1135},{"_111":55,"_113":610},{"_111":55,"_113":1134},{"_111":55,"_113":1133},{"_111":55,"_113":1132},{"_111":55,"_113":1131},{"_111":55,"_113":1130},{"_111":55,"_113":1129},{"_111":55,"_113":1128},{"_111":55,"_113":1127},{"_111":55,"_113":1126},{"_111":55,"_113":1125},{"_111":55,"_113":1124},{"_111":55,"_113":1123},{"_111":55,"_113":1122},{"_111":55,"_113":1121},{"_111":55,"_113":1115},{"_111":55,"_113":1120},{"_111":55,"_113":1119},{"_111":55,"_113":1112},{"_111":55,"_113":1111},{"_111":55,"_113":1118},{"_111":55,"_113":1117},{"_111":55,"_113":1116},{"_111":55,"_113":1115},{"_111":55,"_113":1114},{"_111":55,"_113":1113},{"_111":55,"_113":1112},{"_111":55,"_113":1111},{"_111":55,"_113":1110},{"_111":55,"_113":1109},{"_111":55,"_113":1108},{"_111":55,"_113":610},{"_111":55,"_113":1107},{"_111":55,"_113":1106},{"_111":55,"_113":1105},{"_111":55,"_113":1104},{"_111":55,"_113":1103},{"_111":55,"_113":1102},{"_111":55,"_113":1101},{"_111":55,"_113":1100},{"_111":55,"_113":1099},{"_111":55,"_113":1098},{"_111":55,"_113":1090},{"_111":55,"_113":1097},{"_111":55,"_113":610},{"_111":55,"_113":1096},{"_111":55,"_113":1095},{"_111":55,"_113":1094},{"_111":55,"_113":1093},{"_111":55,"_113":1092},{"_111":55,"_113":1091},{"_111":55,"_113":1090},{"_111":55,"_113":1089},{"_111":55,"_113":610},{"_111":55,"_113":1088},{"_111":55,"_113":1087},{"_111":55,"_113":1086},{"_111":55,"_113":1085},{"_111":55,"_113":1084},{"_111":55,"_113":608},{"_111":55,"_113":1083},{"_111":55,"_113":1082},{"_111":55,"_113":1081},{"_111":55,"_113":1080},{"_111":55,"_113":1079},{"_111":55,"_113":1078},{"_111":55,"_113":583},{"_111":55,"_113":601},{"_111":55,"_113":1077},{"_111":55,"_113":199},{"_111":55,"_113":198},{"_111":55,"_113":1076},{"_111":55,"_113":1075},{"_111":55,"_113":1074},{"_111":55,"_113":1073},{"_111":55,"_113":1072},{"_111":55,"_113":601},{"_111":55,"_113":1071},{"_111":55,"_113":199},"\treturn try JSONDecoder().decode(ManagementRequest.self, from: data)","\t\tguard data.count <= 16_384 else { throw ManagementError(\"The desktop management request exceeds 16 KiB.\") }","\t\tdata.append(chunk)","\twhile let chunk = try FileHandle.standardInput.read(upToCount: 4096), !chunk.isEmpty {","\tvar data = Data()","private func readManagement() throws -> ManagementRequest {","\treturn try JSONEncoder().encode(ManagementReply(data: result, target_receipt: receipt))","\t\t\thint: invoked ? \"Refresh the target before any retry; the action may already have happened.\" : nil","\t\t\tmessage: error.localizedDescription,","\t\t\tcode: (error as? PeekabooBridgeErrorEnvelope)?.code.rawValue ?? \"DESKTOP_ACTION_FAILED\",","\t\tresult.error = ManagementMessage(","\t\tresult.requires_fresh_observation = invoked","\t\tresult.outcome = invoked ? \"unknown\" : \"refused\"","\t\tresult.error = ManagementMessage(code: failure.standardErrorCode?.rawValue ?? \"DESKTOP_ACTION_FAILED\", message: failure.message, hint: failure.hint)","\t\tresult.requires_fresh_observation = failure.outcome.dispatchState.mutationDispatched || failure.outcome.escalation == .refreshTarget","\t\tresult.native_outcome = failure.outcome","\t\tresult.outcome = failure.outcome.dispatchState.mutationDispatched ? \"unknown\" : \"refused\"","\t} catch let failure as DesktopActionFailure {","\t\t\tresult.outcome = outcome.evidence == .operationStillRunning ? \"unknown\" : \"completed\"","\t\tdefault:","\t\t\tresult.outcome = \"unknown\"","\t\tcase .indeterminate, .partial:","\t\t\tresult.outcome = \"refused\"","\t\tcase .refused:","\t\tswitch outcome.state {","\t\tresult.requires_fresh_observation = outcome.dispatchState.mutationDispatched","\t\t\tthrow ManagementError(\"The management action's signed target did not match the original inventory target.\")","\t\t\treceipt = Receipt(pid: identity.ownerProcessIdentifier, window_id: identity.windowID, process_start_identity_decimal: String(identity.ownerProcessStartIdentity))","\t\tcase let .window(identity) where window.map({ identity.hasSameStableReceipt(as: $0) }) == true:","\t\t\treceipt = Receipt(pid: identity.processIdentifier, window_id: nil, process_start_identity_decimal: String(identity.processStartIdentity))","\t\tcase let .process(identity) where window == nil && identity == process:","\t\tswitch signed.payload.target {","\t\telse { throw ManagementError(\"The management action returned without its matching verified operation receipt and outcome.\") }","\t\t\tlet outcome, signed.payload.outcome?.outcome == outcome","\t\tguard let signed = await client.lastOperationReceipt(), signed.payload.operation == operation,","\t\t// Restore's convenience result omits targetIdentity; the client's accepted signed receipt retains it.","\t\tresult.native_outcome = outcome","\t\t\toutcome = try await client.restoreWindowResult(target: .windowId(window!.windowID), expectedIdentity: window!).outcome","\t\t\toperation = .restoreWindow","\t\tcase .restore:","\t\t\toutcome = action.outcome","\t\t\t}","\t\t\t\tthrow ManagementError(\"Focus returned no matching exact-window receipt.\")","\t\t\tguard action.targetIdentity?.exactWindow?.identity.hasSameStableReceipt(as: window!) == true else {","\t\t\tresult.native_outcome = action.outcome","\t\t\tlet action = try await client.focusWindowResult(target: .windowId(window!.windowID), expectedIdentity: window!)","\t\t\toperation = .focusWindow","\t\tcase .focus:","\t\t\t\tthrow ManagementError(\"Activation returned no matching application-only receipt.\")","\t\t\tguard action.targetIdentity?.processIdentity == process, action.targetIdentity?.exactWindow == nil else {","\t\t\t))","\t\t\t\tidentifier: \"PID:\\(process.processIdentifier)\", expectedIdentity: process","\t\t\tlet action = try await client.activateApplicationTargetedResult(request: .init(","\t\t\toperation = .activateApplication","\t\tcase .activate:","\t\tswitch request.op {","\t\tinvoked = true","\t\tlet operation: PeekabooBridgeOperation","\t\tlet outcome: DesktopActionOutcome?","\t\ttry Task.checkCancellation()","\t\telse { throw ManagementError(\"The observed application generation could not be verified. Refresh desktop_apps before acting.\") }","\t\t\tapplication.processIdentity == process","\t\tguard let application = inventory.items.first(where: { $0.processIdentifier == process.processIdentifier }),","\t\t// A failed read-only preflight cannot have dispatched this management action. Native revalidation still owns races.","\t\t\tthrow ManagementError(\"The native runtime cannot attest exact management targets. Update the desktop runtime before acting.\")","\t\tguard let preflight = await client.lastOperationReceipt(), preflight.payload.operation == PeekabooBridgeRequest.listApplicationMutationInventory.operation else {","\t\tlet inventory = try await client.listApplicationMutationInventory()","\t\t// The inventory receipt proves signed transport; optional source-build metadata is not required.","\t\t\twindow = try request.target.windowIdentity()","\t\t} else {","\t\t\twindow = nil","\t\t\t\tthrow ManagementError(\"Activation takes an application target from desktop_apps.\")","\t\t\tguard request.target.window_id == nil, request.target.bounds == nil, request.target.is_minimized == nil else {","\t\tif request.op == .activate {","\t\tlet window: WindowMutationIdentity?","\t\tlet process = try request.target.processIdentity()","\t\tresult.action = request.op.rawValue","\t\tlet request = try readManagement()","\tdo {","\tvar invoked = false","\tvar receipt: Receipt?","\tvar result = ManagementResult()","func nativeManagement(_ client: PeekabooBridgeClient) async throws -> Data {","\tlet target_receipt: Receipt?","\tlet data: ManagementResult","\tlet success = true","private struct ManagementReply: Encodable {","\tvar error: ManagementMessage?","\tvar requires_fresh_observation = false","\tvar native_outcome: DesktopActionOutcome?","\tvar action = \"management\"","\tvar outcome = \"refused\"","private struct ManagementResult: Encodable {","\tlet hint: String?","\tlet message: String","\tlet code: String","private struct ManagementMessage: Encodable {","\tvar errorDescription: String? { message }","\tinit(_ message: String) { self.message = message }","private struct ManagementError: LocalizedError {","\tlet target: ManagementTarget","\tlet op: Operation","\t\tcase activate, focus, restore","\tenum Operation: String, Decodable {","private struct ManagementRequest: Decodable {","\t\t\tisMinimized: is_minimized","\t\t\tcapturedBounds: CGRect(x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height),","\t\t\townerProcessStartIdentity: process.processStartIdentity,","\t\t\townerProcessIdentifier: process.processIdentifier,","\t\t\twindowID: window_id,","\t\treturn WindowMutationIdentity(","\t\telse { throw ManagementError(\"Use the exact window target and original bounds from desktop_windows.\") }","\t\t\tbounds.width > 0, bounds.height > 0","\t\t\t[bounds.x, bounds.y, bounds.width, bounds.height].allSatisfy(\\.isFinite),","\t\t\tlet bounds, let is_minimized,","\t\tguard let window_id, let id = UInt32(exactly: window_id), id > 0,","\t\tlet process = try processIdentity()","\tfunc windowIdentity() throws -> WindowMutationIdentity {","\t\treturn ApplicationProcessIdentity(processIdentifier: pid, processStartIdentity: generation)","\t\telse { throw ManagementError(\"Use the exact application target from desktop inventory.\") }","\t\t\tString(generation) == process_start_identity_decimal","\t\tguard pid > 0, let generation = UInt64(process_start_identity_decimal), generation > 0,","\tfunc processIdentity() throws -> ApplicationProcessIdentity {","\t\tis_minimized = window.isMinimized","\t\tbounds = Bounds(window.bounds)","\t\twindow_id = identity.windowID","\t\tprocess_start_identity_decimal = String(identity.ownerProcessStartIdentity)","\t\tself.pid = pid","\t\telse { return nil }","\t\t\tidentity.capturedBounds == window.bounds","\t\t\tidentity.windowID == window.windowID,","\t\t\tidentity.ownerProcessIdentifier == pid,","\t\tguard let identity = window.mutationIdentity,","\tinit?(window: ServiceWindowInfo, pid: Int32) {","\t\tis_minimized = nil","\t\tbounds = nil","\t\twindow_id = nil","\t\tprocess_start_identity_decimal = String(identity.processStartIdentity)","\t\tpid = identity.processIdentifier","\tinit(_ identity: ApplicationProcessIdentity) {","\tlet is_minimized: Bool?","\tlet bounds: Bounds?","\tlet window_id: Int?","\tlet process_start_identity_decimal: String","\tlet pid: Int32","struct ManagementTarget: Codable {","import PeekabooFoundation","import PeekabooBridge","import PeekabooAutomationKit","import Foundation","import CoreGraphics","629e74e","apps/desktop/native/sources/client/client.swift",{"_265":1376,"_267":268},{"_265":1375,"_267":268},[1227,1228,1229,1230,1231,1232,1233,1234],{"_66":1359,"_68":69,"_70":1359,"_72":181,"_74":1360},{"_66":1340,"_68":69,"_70":1341,"_72":407,"_74":1342},{"_66":1322,"_68":181,"_70":1323,"_72":181,"_74":1324},{"_66":1309,"_68":181,"_70":1310,"_72":181,"_74":1311},{"_66":1295,"_68":69,"_70":1296,"_72":181,"_74":1297},{"_66":1281,"_68":69,"_70":1282,"_72":181,"_74":1283},{"_66":1259,"_68":407,"_70":1260,"_72":1261,"_74":1262},{"_66":1235,"_68":225,"_70":1236,"_72":183,"_74":1237},245,251,[1238,1239,1240,1241,1242,1243,1244,1245,1246,1247,1248,1249],{"_111":112,"_113":1258},{"_111":112,"_113":1257},{"_111":112,"_113":1256},{"_111":55,"_113":1255},{"_111":112,"_113":601},{"_111":112,"_113":199},{"_111":112,"_113":198},{"_111":57,"_113":1254},{"_111":55,"_113":1253},{"_111":112,"_113":1252},{"_111":112,"_113":1251},{"_111":112,"_113":1250},"\tlet width: Double","\tlet y: Double","\tlet x: Double","struct Bounds: Codable {","private struct Bounds: Encodable {","\t\ttarget = ManagementTarget(window: window, pid: pid)","\t\tprocess_start_identity_decimal = window.mutationIdentity.map { String($0.processIdentity.processStartIdentity) }","\t\tobservation_reason = window.observationCapability?.reason?.rawValue","\t\tobservation_capability = window.observationCapability?.mode.rawValue",234,239,9,[1263,1264,1265,1266,1267,1268,1269,1270,1271,1272],{"_111":112,"_113":1280},{"_111":112,"_113":1279},{"_111":112,"_113":1278},{"_111":55,"_113":1277},{"_111":112,"_113":198},{"_111":57,"_113":1276},{"_111":55,"_113":1275},{"_111":112,"_113":1274},{"_111":112,"_113":1273},{"_111":112,"_113":1195},"\t\twindow_title = window.title","\t\twindow_id = window.windowID","\tinit(_ window: ServiceWindowInfo, pid: Int32) {","\tinit(_ window: ServiceWindowInfo) {","\tlet target: ManagementTarget?","\tlet process_start_identity_decimal: String?","\tlet observation_reason: String?","\tlet observation_capability: String?",214,218,[1284,1285,1286,1287,1288,1289,1290],{"_111":112,"_113":1294},{"_111":112,"_113":1293},{"_111":112,"_113":1292},{"_111":55,"_113":1291},{"_111":112,"_113":601},{"_111":112,"_113":199},{"_111":112,"_113":198},"\t\ttarget = app.processIdentity.map(ManagementTarget.init)","\t\twarnings = combined.isEmpty ? nil : Array(Set(combined)).sorted()","\t\tlet combined = (app.metadataWarnings ?? []) + (metadata?.metadataWarnings ?? [])","\t\tprocess_start_identity_decimal = app.processStartIdentity.map(String.init)",201,204,[1298,1299,1300,1301,1302,1303,1304],{"_111":112,"_113":1308},{"_111":112,"_113":1278},{"_111":112,"_113":1307},{"_111":55,"_113":1277},{"_111":112,"_113":198},{"_111":112,"_113":1306},{"_111":112,"_113":1305},"\t\tname = app.name","\tinit(_ app: ServiceApplicationInfo, metadata: ServiceApplicationInfo?, activityKnown: Bool) {","\tlet warnings: [String]?","\tlet is_hidden_known: Bool",180,183,[1312,1313,1314,1315,1316,1317,1318,1319],{"_111":112,"_113":198},{"_111":112,"_113":1321},{"_111":112,"_113":1215},{"_111":57,"_113":1320},{"_111":55,"_113":1213},{"_111":112,"_113":1214},{"_111":112,"_113":199},{"_111":112,"_113":198},"\tlet window_id: Int","struct Receipt: Encodable {",85,88,[1325,1326,1327,1328,1329,1330,1331,1332],{"_111":112,"_113":1339},{"_111":112,"_113":1338},{"_111":112,"_113":1337},{"_111":57,"_113":1336},{"_111":55,"_113":1335},{"_111":112,"_113":1334},{"_111":112,"_113":1333},{"_111":112,"_113":1121},"\t\t\t\tinventory_warnings: inventory.warnings","\t\t\t\tinventory_completeness: inventory.completeness.rawValue,","\t\t\t\twindows: inventory.items.map { Window($0, pid: pid) },","\t\t\t\twindows: inventory.items.map(Window.init),","\t\t\t\tpid: pid,","\t\t\treturn try encode(Windows(","\t\t\tlet inventory = try await client.listWindowMutationInventory(target: .application(\"PID:\\(pid)\"))",47,48,[1343,1344,1345,1346,1347,1348,1349,1350],{"_111":112,"_113":1358},{"_111":112,"_113":1357},{"_111":112,"_113":1356},{"_111":55,"_113":1355},{"_111":55,"_113":1354},{"_111":112,"_113":1353},{"_111":112,"_113":1352},{"_111":112,"_113":1351},"\t\t\tvar metadata: [ServiceApplicationInfo] = []","\t\t\tlet inventory = try await client.listApplicationMutationInventory()","\t\tcase \"apps\":","\t\t\treturn try await nativeManagement(client)","\t\tcase \"management\":","\t\t\treturn try await nativeAction(client)","\t\tcase \"action\":","\t\tswitch operation {",27,[1361,1362,1363,1364,1365,1366,1367],{"_111":112,"_113":1374},{"_111":112,"_113":1373},{"_111":112,"_113":1372},{"_111":55,"_113":1371},{"_111":112,"_113":1370},{"_111":112,"_113":1369},{"_111":112,"_113":1368},"\t\tlet client = PeekabooBridgeClient(","\t\tlet identity = try SigningIdentity.current()","\t\telse { throw ClientError.usage }","\t\t\t|| (operation == \"management\" && args.count == 2)","\t\t\t|| (operation == \"action\" && args.count == 2)","\t\t\t|| (operation == \"inspect\" && (args.count == 5 || args.count == 6))","\t\t\t|| (operation == \"windows\" && args.count == 3)","040259c","8ac1a72","id","01M452RT68JF08F99DS60P1C4J","project","number",74,"title","Activate apps and recover exact windows","description",{"_1416":1417,"_54":1418},"state","merged","base",{"_1379":18,"_1412":1415,"_1414":36},"head",{"_1379":18,"_1412":1413,"_1414":38},"mergeRevision","7cb6f87766c5bd12466c2e53cddc1531d6216a57","implements",[],"addresses",[],"createdBy",{"_1408":1409},"createdAt","2026-10-05T03:47:25.000Z","updatedAt","2026-10-05T12:47:36.000Z","locked","fork","headAvailable",true,"actor",{"_53":1410,"_1377":1411},"user","import:github:1714999","branch","refs/pull/74/head","revision","refs/heads/feat/github-cache","format","markdown","Agents can now explicitly activate a running app, focus an exact window, and restore a minimized window with `desktop_activate`, `desktop_focus`, and `desktop_restore`. Targets retain the process generation and observed window bounds. The client verifies signed inventory before dispatch and signed target/outcome receipts afterward. Inspection stays passive; later observation failures preserve completed actions and their original diagnostics.\n\nImplements the focused recovery tools in #73, part of #8. Based on `feat/github-cache` with merged inspection diagnostics (#71) and click variants (#82), independently of literal insertion (#67).\n\nFinal head `5c0dfb16283cd6382a2146ded36f3f6f17f3848d` integrates merged application search (#84). The only conflict combined the management request union with the optional application query. Types, formatting/lint, Ace diff review, and independent integration review passed again; native sources are unchanged from the runtime-validated build below.\n\nValidation on `ffb47ccc071cbdd2e974ec1478d0cf3ff33d3c0a`:\n\n- Types, formatting/lint, signed development build, strict app/client signatures, and independent source review passed.\n- Real AppKit callbacks and Save evidence verified activation, already-active no-op, exact focus, actual minimize/restore, already-restored no-op, hidden-app activation, and stale-generation/bounds refusals. Document text remained unchanged. Recorded repeated focus also matched its exact receipt and verified resulting state; focus does not promise an already-key no-op.\n- A real pi/Anthropic run executed activate → restore → focus. Exact tool text/images and outcomes survived reopening the same pi store with unchanged usage and no repeated native calls.\n\nThe management-specific delayed-response/target-closure check remains unverified: its temporary wrapper had an invalid executable signature and failed before its start marker. Generic completed-action preservation after a failed follow-up was validated in #71. Management-specific Stop/crash recovery and hosted forwarding have not been rerun for this slice.\n\n### Built in Ace\n\nGit/GitHub work, builds, checks, diff review, and native/model validation runs used Ace's terminal and channel APIs. Codex provided source editing, coordination, and candidate/fixture launch because Ace's external-harness integration (#9) and file editor (#22) are not yet available. Actual AppKit callbacks, Save files, signed native results, and real pi/provider history supplied the validation evidence.\n","iamnbutler","documentNavigation","repo","githubnext/ace2","repoId","ownerId","org:89615882","site","nexthub","private","admin","settings","triage","starred","stars","watchers","watching","pinned","notify","views",[1600,1601,1602,1603,1604,1605,1606,1607,1608,1609,1610,1611,1612],"navigation",{"_1438":1439,"_1562":1563,"_1564":1565,"_1566":1567,"_1568":1569,"_1570":1571,"_111":1572},"sources",[],"meta",{"_1384":1557,"_1558":1559,"_1560":198,"_1428":22,"_1390":1549,"_1561":22,"_1433":852,"_1434":852},"branches",[1464,1465,1466,1467,1468,1469,1470,1471,1472,1473,1474,1475,1476,1477,1478,1479,1480,1481,1482,1483,1484,1485,1486,1487,1488,1489,1490,1491,1492,1493,1494,1495,1496,1497,1498,1499,1500,1501,1502,1503,1504,1505,1506,1507,1508,1509,1510,1511,1512,1513,1514,1515,1516,1517,1518,1519,1520,1521,1522,1523,1524,1525,1526,1527,1528,1529,1530,1531,1532,1533,1534,1535,1536,1537,1538,1539,1540,1541,1542,1543,1544,1545,1546,1547,1548,1549,1550,1551,1552,1553,1554,1555,1556],"tags",[1452,1453,1454,1455,1456,1457,1458,1459,1460,1461,1462,1463],"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","Ace: a collaborative coding environment on the team's own machines","owner","githubnext","section","empty","pins",[1584,1585,1586],"documents",{"_1579":1580,"_1581":1582},"code",{"_23":1577,"_1578":384},"automations",{"_1575":58,"_1576":-5},"delivery",{"_1573":852,"_1574":-5},"9Rn62lcgXCFfpmCuooTjLxGyUf8","releases","applications","workflows","deployments",215,"changes","counts",{"_1583":1582},"total",86,"issue",{"_1377":1578,"_1588":1598,"_49":1578,"_1590":1599,"_1436":1407,"_1592":22,"_1593":1407,"_1594":384},{"_1377":1595,"_1588":1596,"_49":1595,"_1590":1597,"_1436":1407,"_1592":22,"_1593":1407,"_1594":852},{"_1377":1587,"_1588":1589,"_49":1587,"_1590":1591,"_1436":1407,"_1592":22,"_1593":1407,"_1594":1582},"issues","name","Issues","filters",{},"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_1377":1578,"_1588":1598,"_49":1578,"_1590":1643,"_1436":1407,"_1592":22,"_1593":1407},{"_1377":1595,"_1588":1596,"_49":1595,"_1590":1642,"_1436":1407,"_1592":22,"_1593":1407},{"_1377":1587,"_1588":1589,"_49":1587,"_1590":1641,"_1436":1407,"_1592":22,"_1593":1407},{"_1377":1638,"_1588":1639,"_49":1638,"_1590":1640,"_1436":22,"_1592":22,"_1593":1407},{"_1377":1635,"_1588":1636,"_49":1635,"_1590":1637,"_1436":22,"_1592":22,"_1593":1407},{"_1377":1575,"_1588":1633,"_49":1568,"_1590":1634,"_1436":22,"_1592":22,"_1593":1407},{"_1377":1576,"_1588":1630,"_49":1631,"_1590":1632,"_1436":22,"_1592":22,"_1593":1407},{"_1377":1573,"_1588":1628,"_49":1573,"_1590":1629,"_1436":22,"_1592":22,"_1593":1407},{"_1377":1624,"_1588":1625,"_49":1626,"_1590":1627,"_1436":22,"_1592":22,"_1593":1407},{"_1377":1564,"_1588":1622,"_49":1564,"_1590":1623,"_1436":22,"_1592":22,"_1593":22},{"_1377":1619,"_1588":1620,"_49":1619,"_1590":1621,"_1436":22,"_1592":22,"_1593":22},{"_1377":1616,"_1588":1617,"_49":1616,"_1590":1618,"_1436":22,"_1592":22,"_1593":22},{"_1377":1613,"_1588":1614,"_49":1613,"_1590":1615,"_1436":22,"_1592":22,"_1593":22},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups",[],"now",1794435416453,"sidebar","expanded"]