cuelo 0.10.49 → 0.10.50

package/.next/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":77684283,"timestamp":619091,"id":14,"parentId":1,"tags":{},"startTime":1792536213341,"traceId":"10062087fa58dc8a"},{"name":"run-typescript","duration":13674772,"timestamp":78682976,"id":10997,"parentId":1,"tags":{},"startTime":1792536291406,"traceId":"10062087fa58dc8a"},{"name":"static-check","duration":4262935,"timestamp":92449601,"id":11000,"parentId":1,"tags":{},"startTime":1792536305173,"traceId":"10062087fa58dc8a"},{"name":"static-generation","duration":7399136,"timestamp":96788483,"id":11172,"parentId":1,"tags":{},"startTime":1792536309512,"traceId":"10062087fa58dc8a"},{"name":"collect-build-traces","duration":15441300,"timestamp":96772023,"id":11169,"parentId":1,"tags":{},"startTime":1792536309495,"traceId":"10062087fa58dc8a"},{"name":"telemetry-flush","duration":46,"timestamp":112216686,"id":11181,"parentId":1,"tags":{},"startTime":1792536324940,"traceId":"10062087fa58dc8a"},{"name":"next-build","duration":111682196,"timestamp":534554,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1792536213256,"traceId":"10062087fa58dc8a"}]
+[{"name":"run-webpack","duration":111128781,"timestamp":842435,"id":14,"parentId":1,"tags":{},"startTime":1792539390956,"traceId":"5549c2f2c6ebad40"},{"name":"run-typescript","duration":20400885,"timestamp":112327456,"id":10997,"parentId":1,"tags":{},"startTime":1792539502442,"traceId":"5549c2f2c6ebad40"},{"name":"static-check","duration":4411852,"timestamp":132826944,"id":11000,"parentId":1,"tags":{},"startTime":1792539522941,"traceId":"5549c2f2c6ebad40"},{"name":"static-generation","duration":14142279,"timestamp":137350537,"id":11172,"parentId":1,"tags":{},"startTime":1792539527465,"traceId":"5549c2f2c6ebad40"},{"name":"collect-build-traces","duration":23147676,"timestamp":137312713,"id":11169,"parentId":1,"tags":{},"startTime":1792539527427,"traceId":"5549c2f2c6ebad40"},{"name":"telemetry-flush","duration":141,"timestamp":160465027,"id":11181,"parentId":1,"tags":{},"startTime":1792539550579,"traceId":"5549c2f2c6ebad40"},{"name":"next-build","duration":159745637,"timestamp":719553,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1792539390834,"traceId":"5549c2f2c6ebad40"}]

package/Tools/CUELO_Setup/files/native-runtime-patch.js

@@ -9,7 +9,7 @@ const MEMORY_RE = /(const phase1Model = await resolveMemoryModel\(\{[^}]*?fallba
 const MEMORY_DONE = /const phase1Model = await resolveMemoryModel\(\{[^}]*?fallbackRole: "smol"/;
 const EXPECTED = {
     name: 'cuelo',
-    version: '0.10.49',
+    version: '0.10.50',
     distribution: 'cuelo',
     coreVersion: '18.12.3',
 };

package/Tools/OMP_Global_Config/agent/agents/maker.md

@@ -3,10 +3,10 @@ name: maker
 description: Delegated end-to-end implementation agent that investigates, edits, repairs, validates its own slice, and verifies the actual surface it changed.
 model: "@implSonnet"
 thinking-level: auto
-tools: [read, bash, edit, write, grep, glob, skim, draft, lsp, eval, generate_image, ast_grep, ast_edit, debug, todo, web_search, windows_build, checkpoint]
+tools: [read, bash, edit, write, grep, glob, skim, draft, lsp, eval, generate_image, ast_grep, ast_edit, debug, todo, web_search, windows_build, windows_control, checkpoint]
 ---
 
-<!-- omp-global-config:generated source-hash=3357fab21461
+<!-- omp-global-config:generated source-hash=cf0f7c8e6905
   이 파일은 patches/build-agents.mjs 가 만든 빌드 산출물이다. 직접 수정하지 마라.
   고칠 곳: agent/sop/maker.md · agent/sop/_writer.md · agent/sop/_common.md
   재생성: node patches/build-agents.mjs   검사: node patches/build-agents.mjs --check

package/Tools/OMP_Global_Config/agent/rules/harness-policy.json

@@ -851,7 +851,7 @@
       "codeAndPolicyReviewOwner": "main",
       "designJudgment": "main-or-the-owning-maker-reads-the-design-rules-and-skills-there-is-no-separate-design-role",
       "repositoryAccess": "owner-writable-inside-its-brief-boundary-only",
-      "tools": ["read", "bash", "edit", "write", "grep", "glob", "skim", "draft", "lsp", "eval", "generate_image", "ast_grep", "ast_edit", "debug", "todo", "web_search", "windows_build", "checkpoint"],
+      "tools": ["read", "bash", "edit", "write", "grep", "glob", "skim", "draft", "lsp", "eval", "generate_image", "ast_grep", "ast_edit", "debug", "todo", "web_search", "windows_build", "windows_control", "checkpoint"],
       "runtimeAutoPair": "checkpoint-in-frontmatter-causes-core-createTools-to-add-rewind-to-the-restricted-session-tool-surface-rewind-is-intentionally-absent-from-frontmatter",
       "execution": "async",
       "broadValidation": "the-owner-runs-the-ordinary-project-checks-its-slice-needs-and-skips-unrelated-project-wide-suites",

package/Tools/OMP_Global_Config/agent/rules/meta-harness.md

@@ -14,7 +14,7 @@ globs: ["Tools/OMP_Global_Config/**"]
   발주 때 Main이 고른 `tasks[].model`의 `:auto` selector가 child auto를 켜고, 실제 단계는 그 모델의 전체 범위에서 child가 고른다.
   모델·fallback은 `modelRoles`, 모델 분류·추론은 `routing.modelSelection`·`routing.effortSelection`이 정한다.
 - frontmatter 도구는 `read, bash, edit, write, grep, glob, skim, draft, lsp, eval,
-  generate_image, ast_grep, ast_edit, debug, todo, web_search, windows_build, checkpoint`다. core 18.3.0에는 `hub`가
+  generate_image, ast_grep, ast_edit, debug, todo, web_search, windows_build, windows_control, checkpoint`다. core 18.3.0에는 `hub`가
   없고(목록에 남겨도 조용히 버려진다) `wait`는 top-level 전용이라 Maker(depth 1)에 넣어도 생기지 않으므로 둘 다 적지 않는다.
   restricted session에서 `checkpoint`를 명시하면 core `createTools`가 `rewind`를 안전 쌍으로
   자동 추가하므로 frontmatter에는 `rewind`를 중복하지 않지만 실제 runtime에는 둘 다 노출된다.

package/Tools/OMP_Global_Config/agent/sop/maker.md

@@ -2,7 +2,7 @@
 name: maker
 description: Delegated end-to-end implementation agent that investigates, edits, repairs, validates its own slice, and verifies the actual surface it changed.
 model: "@implSonnet"
-tools: [read, bash, edit, write, grep, glob, skim, draft, lsp, eval, generate_image, ast_grep, ast_edit, debug, todo, web_search, windows_build, checkpoint]
+tools: [read, bash, edit, write, grep, glob, skim, draft, lsp, eval, generate_image, ast_grep, ast_edit, debug, todo, web_search, windows_build, windows_control, checkpoint]
 ---
 
 You are the delegated implementation Maker on the default `modelRoles.implSonnet` slot. A delegated slice

package/Tools/OMP_Global_Config/agent/tools/windows-control/control.ps1

@@ -0,0 +1,200 @@
+param([Parameter(Mandatory = $true)][string]$Request)
+# windows_control 도구의 Windows 쪽 본체. 요청은 base64(UTF-8 JSON) 한 인자로 받는다(WSL 인자 따옴표 문제를 피한다).
+# 클래식 Win32 컨트롤(WinForms·VB6·MFC)의 자식 창에 SendMessageTimeout으로 WM_SETTEXT·BM_CLICK을 보낸다.
+# 전면 창·포커스는 바꾸지 않는다(SetForegroundWindow·SetFocus·SendInput을 쓰지 않는다).
+[Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)
+$ErrorActionPreference = 'Stop'
+
+Add-Type -TypeDefinition @"
+using System;
+using System.Text;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+
+public class CueloChild {
+    public long Hwnd;
+    public string ClassName;
+    public string Text;
+    public int ControlId;
+    public bool Visible;
+    public bool Enabled;
+    public int Check;
+}
+
+public static class CueloWin {
+    private delegate bool EnumProc(IntPtr h, IntPtr l);
+    [DllImport("user32.dll")] private static extern bool EnumChildWindows(IntPtr p, EnumProc f, IntPtr l);
+    [DllImport("user32.dll", CharSet = CharSet.Unicode)] private static extern int GetClassName(IntPtr h, StringBuilder s, int n);
+    [DllImport("user32.dll")] private static extern int GetDlgCtrlID(IntPtr h);
+    [DllImport("user32.dll")] private static extern bool IsWindowVisible(IntPtr h);
+    [DllImport("user32.dll")] private static extern bool IsWindowEnabled(IntPtr h);
+    [DllImport("user32.dll")] private static extern bool IsWindow(IntPtr h);
+    [DllImport("user32.dll")] private static extern int GetWindowLong(IntPtr h, int index);
+    [DllImport("user32.dll")] public static extern IntPtr GetForegroundWindow();
+    [DllImport("user32.dll", SetLastError = true)]
+    private static extern IntPtr SendMessageTimeout(IntPtr h, uint m, IntPtr w, IntPtr l, uint flags, uint timeout, out IntPtr result);
+    [DllImport("user32.dll", SetLastError = true, CharSet = CharSet.Unicode, EntryPoint = "SendMessageTimeoutW")]
+    private static extern IntPtr SendMessageTimeoutText(IntPtr h, uint m, IntPtr w, StringBuilder l, uint flags, uint timeout, out IntPtr result);
+    [DllImport("user32.dll", SetLastError = true, CharSet = CharSet.Unicode, EntryPoint = "SendMessageTimeoutW")]
+    private static extern IntPtr SendMessageTimeoutString(IntPtr h, uint m, IntPtr w, string l, uint flags, uint timeout, out IntPtr result);
+
+    private const uint SMTO_ABORTIFHUNG = 2;
+    private const uint WM_SETTEXT = 0x000C, WM_GETTEXT = 0x000D, WM_GETTEXTLENGTH = 0x000E;
+    private const uint BM_GETCHECK = 0x00F0, BM_CLICK = 0x00F5;
+    private const int GWL_STYLE = -16;
+
+    public static bool Exists(long hwnd) { return IsWindow(new IntPtr(hwnd)); }
+
+    public static string ReadText(IntPtr h) {
+        IntPtr length;
+        if (SendMessageTimeout(h, WM_GETTEXTLENGTH, IntPtr.Zero, IntPtr.Zero, SMTO_ABORTIFHUNG, 1000, out length) == IntPtr.Zero) return null;
+        int n = (int)length.ToInt64();
+        if (n < 0) n = 0;
+        if (n > 65535) n = 65535;
+        StringBuilder buffer = new StringBuilder(n + 1);
+        IntPtr copied;
+        if (SendMessageTimeoutText(h, WM_GETTEXT, new IntPtr(n + 1), buffer, SMTO_ABORTIFHUNG, 1000, out copied) == IntPtr.Zero) return null;
+        return buffer.ToString();
+    }
+
+    // Check state only for check-box and radio-button styles; push buttons report -1.
+    private static int CheckState(IntPtr h, string className) {
+        if (className.IndexOf("BUTTON", StringComparison.OrdinalIgnoreCase) < 0) return -1;
+        int kind = GetWindowLong(h, GWL_STYLE) & 0xF;
+        if (kind != 2 && kind != 3 && kind != 4 && kind != 5 && kind != 6 && kind != 9) return -1;
+        IntPtr state;
+        if (SendMessageTimeout(h, BM_GETCHECK, IntPtr.Zero, IntPtr.Zero, SMTO_ABORTIFHUNG, 1000, out state) == IntPtr.Zero) return -1;
+        return (int)state.ToInt64();
+    }
+
+    public static CueloChild Describe(IntPtr h) {
+        StringBuilder cls = new StringBuilder(256);
+        GetClassName(h, cls, 256);
+        CueloChild child = new CueloChild();
+        child.Hwnd = h.ToInt64();
+        child.ClassName = cls.ToString();
+        child.Text = ReadText(h);
+        child.ControlId = GetDlgCtrlID(h);
+        child.Visible = IsWindowVisible(h);
+        child.Enabled = IsWindowEnabled(h);
+        child.Check = CheckState(h, child.ClassName);
+        return child;
+    }
+
+    public static List<CueloChild> Children(long top) {
+        List<CueloChild> list = new List<CueloChild>();
+        EnumChildWindows(new IntPtr(top), delegate (IntPtr h, IntPtr l) { list.Add(Describe(h)); return true; }, IntPtr.Zero);
+        return list;
+    }
+
+    // Returns 0 when delivered; otherwise the Win32 error (1460 = timeout, e.g. a modal dialog is still open; 5 = elevated target).
+    public static int SetText(long hwnd, string value) {
+        IntPtr result;
+        if (SendMessageTimeoutString(new IntPtr(hwnd), WM_SETTEXT, IntPtr.Zero, value, SMTO_ABORTIFHUNG, 2000, out result) != IntPtr.Zero) return 0;
+        int error = Marshal.GetLastWin32Error();
+        return error == 0 ? -1 : error;
+    }
+
+    public static int Click(long hwnd, uint timeoutMs) {
+        IntPtr result;
+        if (SendMessageTimeout(new IntPtr(hwnd), BM_CLICK, IntPtr.Zero, IntPtr.Zero, SMTO_ABORTIFHUNG, timeoutMs, out result) != IntPtr.Zero) return 0;
+        int error = Marshal.GetLastWin32Error();
+        return error == 0 ? -1 : error;
+    }
+}
+"@
+
+function Write-Result($value) { $value | ConvertTo-Json -Depth 5 -Compress }
+
+function Get-Changes($before, $after) {
+    $old = @{}
+    foreach ($child in $before) { $old[$child.Hwnd] = $child }
+    $changes = @()
+    foreach ($child in $after) {
+        $prev = $old[$child.Hwnd]
+        if ($null -eq $prev) {
+            $changes += [ordered]@{ hwnd = $child.Hwnd; className = $child.ClassName; added = $true; text = $child.Text }
+            continue
+        }
+        if ($prev.Text -ne $child.Text -or $prev.Check -ne $child.Check -or $prev.Enabled -ne $child.Enabled -or $prev.Visible -ne $child.Visible) {
+            $changes += [ordered]@{
+                hwnd = $child.Hwnd; className = $child.ClassName
+                textBefore = $prev.Text; textAfter = $child.Text
+                checkBefore = $prev.Check; checkAfter = $child.Check
+                enabledAfter = $child.Enabled; visibleAfter = $child.Visible
+            }
+        }
+    }
+    # 사라진 컨트롤도 변화다(창은 남았는데 버튼이 자식을 없앤 경우).
+    $now = @{}
+    foreach ($child in $after) { $now[$child.Hwnd] = $true }
+    foreach ($child in $before) {
+        if (-not $now.ContainsKey($child.Hwnd)) {
+            $changes += [ordered]@{ hwnd = $child.Hwnd; className = $child.ClassName; removed = $true; text = $child.Text }
+        }
+    }
+    , $changes
+}
+
+try {
+    $req = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($Request)) | ConvertFrom-Json
+    $window = [long]$req.window
+    $foregroundBefore = [CueloWin]::GetForegroundWindow().ToInt64()
+    if (-not [CueloWin]::Exists($window)) {
+        Write-Result ([ordered]@{ ok = $false; error = 'window-not-found'; window = $window }); exit 0
+    }
+    $before = [CueloWin]::Children($window)
+    if ($req.action -eq 'list') {
+        $foregroundAfter = [CueloWin]::GetForegroundWindow().ToInt64()
+        Write-Result ([ordered]@{ ok = $true; action = 'list'; window = $window; foregroundUnchanged = ($foregroundBefore -eq $foregroundAfter); controls = $before }); exit 0
+    }
+
+    $found = @($before | Where-Object {
+        ($null -eq $req.text -or $_.Text -ceq [string]$req.text) -and
+        ($null -eq $req.className -or $_.ClassName.IndexOf([string]$req.className, [StringComparison]::OrdinalIgnoreCase) -ge 0)
+    })
+    if ($found.Count -eq 0) {
+        Write-Result ([ordered]@{ ok = $false; error = 'control-not-found'; window = $window; controls = $before }); exit 0
+    }
+    if ($null -ne $req.index) {
+        $index = [int]$req.index
+        if ($index -lt 0 -or $index -ge $found.Count) {
+            Write-Result ([ordered]@{ ok = $false; error = 'index-out-of-range'; window = $window; matches = $found }); exit 0
+        }
+        $target = $found[$index]
+    } elseif ($found.Count -gt 1) {
+        Write-Result ([ordered]@{ ok = $false; error = 'ambiguous'; window = $window; matches = $found }); exit 0
+    } else {
+        $target = $found[0]
+    }
+
+    # 바꾸는 동작은 비활성 컨트롤에 보내지 않는다(사용자가 막아 둔 입력칸·버튼이다).
+    if ($req.action -ne 'read' -and -not $target.Enabled) {
+        Write-Result ([ordered]@{ ok = $false; error = 'control-disabled'; window = $window; target = $target }); exit 0
+    }
+    $code = 0
+    $started = [Diagnostics.Stopwatch]::StartNew()
+    switch ($req.action) {
+        'setText' { $code = [CueloWin]::SetText($target.Hwnd, [string]$req.value) }
+        'click' { $code = [CueloWin]::Click($target.Hwnd, [uint32]$req.timeoutMs) }
+        'read' { }
+        default { throw "unknown action $($req.action)" }
+    }
+    $started.Stop()
+    $after = if ([CueloWin]::Exists($window)) { [CueloWin]::Children($window) } else { @() }
+    $foregroundAfter = [CueloWin]::GetForegroundWindow().ToInt64()
+    Write-Result ([ordered]@{
+        ok = ($code -eq 0)
+        action = $req.action
+        window = $window
+        windowClosed = -not [CueloWin]::Exists($window)
+        target = $target
+        targetAfter = ($after | Where-Object { $_.Hwnd -eq $target.Hwnd } | Select-Object -First 1)
+        win32Error = $code
+        elapsedMs = $started.ElapsedMilliseconds
+        foregroundUnchanged = ($foregroundBefore -eq $foregroundAfter)
+        changes = (Get-Changes $before $after)
+    })
+} catch {
+    Write-Result ([ordered]@{ ok = $false; error = 'script-error'; message = $_.Exception.Message })
+}

package/Tools/OMP_Global_Config/agent/tools/windows-control/index.ts

@@ -0,0 +1,255 @@
+import type { CustomToolFactory } from "@oh-my-pi/pi-coding-agent";
+import { posix } from "node:path";
+
+// 2026-10-21 사무실 실측(doc/history/2026/10/21-computer-background): WinForms에서 computer의 UIA press·setValue는
+// 효과는 있지만 사용자 전면 창을 가져가고, 게시된 win.click은 오류 없이 무시됐다. 같은 컨트롤 HWND에
+// SendMessage WM_SETTEXT·BM_CLICK을 보내면 전면 창을 지키며 25~45ms에 동작했다. 이 도구가 그 경로다.
+
+export type ControlAction = "list" | "read" | "setText" | "click";
+
+export interface WindowsControlParams {
+  window: string | number;
+  action: ControlAction;
+  text?: string;
+  className?: string;
+  index?: number;
+  value?: string;
+  timeoutMs?: number;
+}
+
+export interface ExecResult { code: number; stdout: string; stderr?: string }
+export type Exec = (command: string, args: string[], options: { cwd: string; timeout?: number }) => Promise<ExecResult>;
+
+export interface ControlDeps {
+  exec: Exec;
+  cwd: string;
+  /** WSL이면 스크립트 경로를 wslpath -w로 바꾼다. */
+  wsl: boolean;
+  scriptPath: string;
+}
+
+export interface ChildControl {
+  Hwnd: number;
+  ClassName: string;
+  Text: string | null;
+  ControlId: number;
+  Visible: boolean;
+  Enabled: boolean;
+  /** -1: 상태를 읽을 수 없음(일반 버튼, WinForms처럼 직접 그리는 체크박스), 0: 해제, 1: 체크, 2: 불확정 */
+  Check: number;
+}
+
+export interface ControlChange {
+  hwnd: number;
+  className: string;
+  added?: boolean;
+  removed?: boolean;
+  text?: string | null;
+  textBefore?: string | null;
+  textAfter?: string | null;
+  checkBefore?: number;
+  checkAfter?: number;
+  enabledAfter?: boolean;
+  visibleAfter?: boolean;
+}
+
+export interface ControlResult {
+  ok: boolean;
+  error?: string;
+  message?: string;
+  action?: ControlAction;
+  window?: number;
+  windowClosed?: boolean;
+  target?: ChildControl;
+  targetAfter?: ChildControl | null;
+  win32Error?: number;
+  elapsedMs?: number;
+  foregroundUnchanged?: boolean;
+  changes?: ControlChange[] | ControlChange | null;
+  controls?: ChildControl[] | ChildControl | null;
+  matches?: ChildControl[] | ChildControl | null;
+  shell?: string;
+}
+
+const DEFAULT_CLICK_TIMEOUT_MS = 2000;
+const MAX_LISTED = 40;
+const WIN32_TIMEOUT = 1460;
+const WIN32_ACCESS_DENIED = 5;
+
+/** 요청을 검증해 스크립트로 넘길 JSON으로 만든다. 잘못된 요청은 Windows를 부르기 전에 거절한다. */
+export function buildRequest(params: WindowsControlParams): Record<string, unknown> {
+  const window = Number(params.window);
+  if (!Number.isSafeInteger(window) || window <= 0) {
+    throw new Error(`windows_control: window는 computer.window()의 id(양의 정수 HWND)여야 한다: ${String(params.window)}`);
+  }
+  const needsTarget = params.action !== "list";
+  if (needsTarget && params.text === undefined && params.className === undefined) {
+    throw new Error("windows_control: list 말고는 text 또는 className으로 대상 컨트롤을 지정해야 한다");
+  }
+  if (params.action === "setText" && params.value === undefined) {
+    throw new Error("windows_control: setText에는 value가 필요하다");
+  }
+  if (params.index !== undefined && (!Number.isInteger(params.index) || params.index < 0)) {
+    throw new Error(`windows_control: index는 0 이상의 정수여야 한다: ${params.index}`);
+  }
+  const timeoutMs = Math.max(100, Math.min(30_000, Math.trunc(params.timeoutMs ?? DEFAULT_CLICK_TIMEOUT_MS)));
+  return {
+    window,
+    action: params.action,
+    ...(params.text !== undefined ? { text: params.text } : {}),
+    ...(params.className !== undefined ? { className: params.className } : {}),
+    ...(params.index !== undefined ? { index: params.index } : {}),
+    ...(params.value !== undefined ? { value: params.value } : {}),
+    timeoutMs,
+  };
+}
+
+export async function runWindowsControl(params: WindowsControlParams, deps: ControlDeps): Promise<ControlResult> {
+  const request = buildRequest(params);
+  let script = deps.scriptPath;
+  if (deps.wsl) {
+    const converted = await deps.exec("wslpath", ["-w", deps.scriptPath], { cwd: deps.cwd });
+    script = converted.stdout.trim();
+    if (converted.code !== 0 || !script) throw new Error(`windows_control: wslpath 변환 실패: ${converted.stderr ?? ""}`.trim());
+  }
+  const encoded = Buffer.from(JSON.stringify(request), "utf8").toString("base64");
+  const args = ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", script, "-Request", encoded];
+  // 사용자 결정(10-09): Windows PowerShell 7(pwsh)을 먼저 쓰고, 없을 때만 5.1로 간다.
+  // "없음"은 pi.exec가 실행 파일을 찾지 못해 code ENOENT로 throw한 경우뿐이다. pwsh가 실행돼서 실패한 경우
+  // (어떤 종료 코드든)는 같은 요청을 다른 셸로 다시 보내지 않는다. 버튼을 두 번 누를 수 있어서다.
+  let shell = "pwsh.exe";
+  let result: ExecResult;
+  try {
+    result = await deps.exec(shell, args, { cwd: deps.cwd, timeout: 60_000 });
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException | undefined)?.code !== "ENOENT") throw error;
+    shell = "powershell.exe";
+    result = await deps.exec(shell, args, { cwd: deps.cwd, timeout: 60_000 });
+  }
+  const line = result.stdout.split(/\r?\n/).map((text) => text.trim()).filter((text) => text.startsWith("{")).pop();
+  if (!line) {
+    const detail = [result.stderr, result.stdout].filter(Boolean).join("\n").trim().slice(0, 600);
+    throw new Error(`windows_control: ${shell} exit ${result.code}, 결과 JSON 없음${detail ? `: ${detail}` : ""}`);
+  }
+  return { ...(JSON.parse(line) as ControlResult), shell };
+}
+
+/** ConvertTo-Json은 원소가 하나인 배열을 객체로 내보낸다. */
+function asList<T>(value: T[] | T | null | undefined): T[] {
+  if (value === null || value === undefined) return [];
+  return Array.isArray(value) ? value : [value];
+}
+
+function quote(text: string | null | undefined): string {
+  if (text === null || text === undefined) return "(읽기 실패)";
+  const flat = text.replace(/\r?\n/g, "⏎");
+  return JSON.stringify(flat.length > 80 ? `${flat.slice(0, 80)}…` : flat);
+}
+
+function describe(child: ChildControl): string {
+  const flags = [child.Visible ? "" : "숨김", child.Enabled ? "" : "비활성", child.Check >= 0 ? `check=${child.Check}` : ""].filter(Boolean);
+  return `${child.ClassName} ${quote(child.Text)} hwnd=${child.Hwnd}${child.ControlId ? ` id=${child.ControlId}` : ""}${flags.length ? ` (${flags.join(", ")})` : ""}`;
+}
+
+function describeChange(change: ControlChange): string {
+  if (change.added) return `  + ${change.className} hwnd=${change.hwnd} 새로 생김 ${quote(change.text)}`;
+  if (change.removed) return `  - ${change.className} hwnd=${change.hwnd} 사라짐 ${quote(change.text)}`;
+  const parts: string[] = [];
+  if (change.textBefore !== change.textAfter) parts.push(`${quote(change.textBefore)} → ${quote(change.textAfter)}`);
+  if (change.checkBefore !== change.checkAfter) parts.push(`check ${change.checkBefore} → ${change.checkAfter}`);
+  if (parts.length === 0) parts.push(`enabled=${change.enabledAfter} visible=${change.visibleAfter}`);
+  return `  ${change.className} hwnd=${change.hwnd}: ${parts.join(", ")}`;
+}
+
+function listBlock(title: string, children: ChildControl[]): string[] {
+  const shown = children.slice(0, MAX_LISTED).map((child) => `  ${describe(child)}`);
+  const more = children.length > MAX_LISTED ? [`  … ${children.length - MAX_LISTED}개 더`] : [];
+  return [`${title} (${children.length}개):`, ...shown, ...more];
+}
+
+export function formatControlResult(result: ControlResult): string {
+  const lines: string[] = [];
+  if (!result.ok && result.error) {
+    switch (result.error) {
+      case "window-not-found":
+        return `windows_control: 창 hwnd=${result.window}가 없다. computer.window()로 id를 다시 확인한다.`;
+      case "control-not-found":
+        return [`windows_control: 조건에 맞는 컨트롤이 없다. 아무것도 보내지 않았다.`, ...listBlock("창의 컨트롤", asList(result.controls))].join("\n");
+      case "ambiguous":
+        return [`windows_control: 조건에 맞는 컨트롤이 여러 개다. index로 하나를 고른다. 아무것도 보내지 않았다.`, ...listBlock("후보(index 순서)", asList(result.matches))].join("\n");
+      case "index-out-of-range":
+        return [`windows_control: index가 후보 수를 넘는다. 아무것도 보내지 않았다.`, ...listBlock("후보(index 순서)", asList(result.matches))].join("\n");
+      case "control-disabled":
+        return `windows_control: 대상이 비활성이라 아무것도 보내지 않았다: ${result.target ? describe(result.target) : ""}`;
+      case "script-error":
+        return `windows_control: Windows 스크립트 오류: ${result.message ?? ""}`;
+    }
+  }
+  const foreground = result.foregroundUnchanged
+    ? "전면 창 유지."
+    : "주의: 호출 사이 전면 창이 바뀌었다(이 호출 때문인지 사용자 조작인지 이 결과로는 구분할 수 없다).";
+  if (result.action === "list") {
+    lines.push(...listBlock(`창 hwnd=${result.window}의 자식 컨트롤`, asList(result.controls)), foreground);
+    return lines.join("\n");
+  }
+  const target = result.target ? describe(result.target) : "(대상 미상)";
+  const verb = result.action === "click" ? "BM_CLICK" : result.action === "setText" ? "WM_SETTEXT" : "읽기";
+  if (result.ok) {
+    lines.push(`${verb} ${result.action === "read" ? "완료" : "전달"}: ${target}${result.elapsedMs !== undefined && result.action !== "read" ? ` (${result.elapsedMs}ms)` : ""}`);
+  } else if (result.win32Error === WIN32_TIMEOUT) {
+    lines.push(`${verb} 전달됐지만 처리기가 ${result.action === "click" ? "timeoutMs" : "2초"} 안에 끝나지 않았다(모달 창이 열렸을 수 있다): ${target}`);
+  } else if (result.win32Error === WIN32_ACCESS_DENIED) {
+    lines.push(`${verb} 거부됨(Win32 5): 대상 프로그램이 관리자 권한으로 실행 중이다. 아무 효과도 없다고 본다: ${target}`);
+  } else {
+    lines.push(`${verb} 실패(Win32 ${result.win32Error}): ${target}`);
+  }
+  if (result.action !== "read" && !result.windowClosed) {
+    lines.push(result.targetAfter ? `대상 지금: ${describe(result.targetAfter)}` : "대상 컨트롤이 사라졌다.");
+  }
+  if (result.windowClosed) lines.push("창이 닫혔다.");
+  const changes = asList(result.changes);
+  if (result.action !== "read" && !result.windowClosed) {
+    if (changes.length > 0) lines.push("창 안 컨트롤 변화:", ...changes.map(describeChange));
+    else lines.push("창 안 컨트롤의 텍스트·체크·활성 변화 없음. 효과는 AX나 화면으로 확인한다(새 창이 열렸으면 computer.windows()).");
+  }
+  lines.push(foreground);
+  return lines.join("\n");
+}
+
+const factory: CustomToolFactory = (pi) => ({
+  name: "windows_control",
+  label: "Windows Control",
+  loadMode: "essential",
+  description:
+    "Drive classic Win32 controls (WinForms, VB6, MFC: buttons, check boxes, text boxes) in a Windows window WITHOUT taking the user's foreground or focus. "
+    + "Sends `WM_SETTEXT` / `BM_CLICK` with SendMessageTimeout to the control's own child window, then reads every child control again and reports what changed (text, check state, enabled) and whether the foreground window stayed the same. "
+    + "Use it instead of computer `el.press()`/`el.setValue()` (which bring the window to the front on Windows) or `win.click` (silently ignored by WinForms buttons). "
+    + "`window` is the id from `computer.window()` (the top-level HWND). `list` shows the child controls; other actions pick one control by exact `text` and/or `className` substring, with `index` when several match (ambiguous picks are refused, nothing sent). "
+    + "Not for WPF, WinUI, UWP, web/Chromium or custom-drawn controls (they have no child window per control). "
+    + "Same authorization as computer input: only windows the user asked you to operate; confirm before consequential buttons (save, delete, send, start a machine).",
+  parameters: pi.zod.object({
+    window: pi.zod.union([pi.zod.string(), pi.zod.number()]).describe("Top-level window id from computer.window() (HWND)"),
+    action: pi.zod.enum(["list", "read", "setText", "click"]).describe("list child controls, read one, set its text, or click it"),
+    text: pi.zod.string().optional().describe("Exact current text/caption of the control, e.g. a button label"),
+    className: pi.zod.string().optional().describe("Case-insensitive substring of the Win32 class, e.g. EDIT, BUTTON, STATIC"),
+    index: pi.zod.number().optional().describe("0-based pick among several matches, in list order"),
+    value: pi.zod.string().optional().describe("New text for setText"),
+    timeoutMs: pi.zod.number().optional().describe("How long click waits for the button handler (default 2000; a modal dialog keeps it running)"),
+  }),
+
+  async execute(_toolCallId, params, _onUpdate, _ctx, signal) {
+    const exec: Exec = (command, args, options) => pi.exec(command, args, { ...options, signal });
+    const result = await runWindowsControl(params as WindowsControlParams, {
+      exec,
+      cwd: pi.cwd,
+      wsl: process.platform === "linux" && Boolean(process.env.WSL_DISTRO_NAME),
+      scriptPath: posix.join(import.meta.dir, "control.ps1"),
+    });
+    return {
+      content: [{ type: "text", text: formatControlResult(result) }],
+      details: result,
+    };
+  },
+});
+
+export default factory;

package/Tools/OMP_Global_Config/patches/apply-core-patch.mjs

@@ -2295,6 +2295,15 @@ function createRunPageScope(page: Page, restoreInterception: () => Promise<void>
 		legacyPatched: "- Per-call `takeover: true` after `BackgroundUnavailable` needs no confirmation; use it instead of `computer.control.acquire`. Acquired control requires live human confirmation; acquire only on user request and release it when finished.",
 		patched: "- After `BackgroundUnavailable`, follow the setting the error names. Under `takeover`, a per-call `takeover: true` needs no confirmation; use it instead of `computer.control.acquire`. Under `refuse` nothing was sent, and `takeover: true`, `raise()` and `control.acquire` are refused too: drive web pages through `browser` (relay) and controls through AX, or hand that step to the user. Acquired control requires live human confirmation; acquire only on user request and release it when finished.\n- Check the outcome in the same eval cell as the action: `wait()` for exact AX/DOM text or properties first. Only when the wording varies, pass the relevant AX text (not a screenshot) to `judge(state, {outcome: {type: \"choice\", instructions, criteria: {done, not_done, unknown}}})` instead of spending a model turn; treat `unknown` or low confidence as not done. Never let `judge()` decide focus, window or process identity, permissions, or whether input may be sent; those come from the OS and tool results.",
 	},
+	{
+		// 2026-10-21 사무실 실측(doc/history/2026/10/21-computer-background): WinForms에서 AX press·setValue는 refuse에서도
+		// 창을 앞으로 가져왔고, 게시된 win.click은 오류 없이 무시됐다(status unverified). 한 동작이 0.1~0.4초인데
+		// 체감 지연은 동작 사이 모델 턴(p50 6.5~8.5초)이라, 한 셀 묶음과 windows_control 도구를 안내한다.
+		file: "src/prompts/system/computer-use.md",
+		marker: "Classic Win32 windows (WinForms, VB6, MFC)",
+		anchor: "- Use AX for exposed semantic controls; use window screenshots and pixels for canvas/custom-drawn surfaces. Group predictable actions with verification in `computer.run`.",
+		patched: "- Use AX for exposed semantic controls; use window screenshots and pixels for canvas/custom-drawn surfaces. Group predictable actions with verification in `computer.run`: one cell per act-wait-check sequence, not one model turn per click; each action takes well under a second, the turns between them are what the user waits for.\n- Classic Win32 windows (WinForms, VB6, MFC) on Windows: AX `press()`/`setValue()` on a window that is not in front either bring it to the foreground (even under `refuse`) or, on newer cores, fail with `BackgroundUnavailable`; a posted `win.click` on their buttons is silently ignored (`unverified`, no error). When the `windows_control` tool is available, use it for their buttons, check boxes and text boxes: it keeps the user's foreground and works while the window is covered. Treat any `unverified` action as not done until AX or the tool's readback shows the change.",
+	},
 	{
 		// 빚의 정체(어느 steer 메시지인가)를 표현하는 최소 타입.
 		file: "src/session/irc-bridge.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cuelo",
-  "version": "0.10.49",
+  "version": "0.10.50",
   "description": "CUELO — open-source AI coding agent workspace and harness for omp (oh-my-pi)",
   "homepage": "https://github.com/gim47656-ship-it/CUELO#readme",
   "repository": {