cuelo 0.10.49 → 0.10.51

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":120469305,"timestamp":629337,"id":14,"parentId":1,"tags":{},"startTime":1792541415273,"traceId":"919daa10af2300e0"},{"name":"run-typescript","duration":18298348,"timestamp":121494803,"id":10997,"parentId":1,"tags":{},"startTime":1792541536133,"traceId":"919daa10af2300e0"},{"name":"static-check","duration":4164604,"timestamp":139898059,"id":11000,"parentId":1,"tags":{},"startTime":1792541554536,"traceId":"919daa10af2300e0"},{"name":"static-generation","duration":13138046,"timestamp":144184003,"id":11172,"parentId":1,"tags":{},"startTime":1792541558822,"traceId":"919daa10af2300e0"},{"name":"collect-build-traces","duration":22233918,"timestamp":144144315,"id":11169,"parentId":1,"tags":{},"startTime":1792541558782,"traceId":"919daa10af2300e0"},{"name":"telemetry-flush","duration":113,"timestamp":166383698,"id":11181,"parentId":1,"tags":{},"startTime":1792541581020,"traceId":"919daa10af2300e0"},{"name":"next-build","duration":165862435,"timestamp":521419,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1792541415165,"traceId":"919daa10af2300e0"}]

package/README.md

@@ -98,7 +98,7 @@ Anthropic 구독 계정이 모두 주간 한도에 닿으면, 미리 둔 예비
 - 서브에이전트를 발주한 답변 안에 접힌 카드가 붙어, 맡긴 일마다 실행 상태와 Main의 검수 판정을 한 줄로 보여 줍니다. 펼치면 Maker별 시도가 재작업 순서대로 묶여 실행 상태·검사 수·판정과 함께 나오고, 지금 세션에서 실행한 Maker는 「자세히」로 바뀐 파일·검사·판정 사유를 연 뒤 뒤로 돌아올 수 있습니다. 이전 실행의 기록만 남은 Maker는 확인할 수 없다고 표시합니다. 실행이 끝났어도 Main이 판정을 남기지 않았으면 「검수 미기록」으로 표시하며, 끝난 것을 통과로 치지 않습니다. 서브에이전트가 실행 중이거나 판정을 기다리는 동안에는 입력창 위에 한 줄 요약이 고정되고, 누르면 그 카드로 스크롤해 강조합니다.
 - 실행 중인 서브에이전트는 패널 카드와 답변 카드 상세에 지금 단계(조사 › 구현 › 검증 › 보고)와 경과 시간이 몇 초마다 갱신되어 보입니다. 같은 모델의 과거 실행 가운데 지금보다 오래 걸린 실행들을 근거로 남은 시간 범위와 대략의 진행률을 함께 보여 주며, 표본 수도 표시합니다. 할 일 목록을 쓰는 서브에이전트는 그 진행 기준 추정을 따로 덧붙입니다. 과거 기록이 부족하면 남은 시간은 숨기고, 과거 실행 대부분보다 길어지면 그렇다고 알립니다. 추정이지 약속이 아닙니다.
 - 대화가 압축돼도 서브에이전트 카드·진행줄과 할 일 목록은 현재 분기의 기록을 이어서 보여 줍니다. 압축으로 원래 답변이 가려진 카드는 압축 지점에서 다시 열 수 있으며, 새로고침해도 복원됩니다. 이후 실행 상태와 검수 판정은 새 관측에 맞춰 갱신됩니다.
-- 끝난 턴의 마지막 답변 아래에 변경 파일·검사·실패·미확인 요약이 붙습니다. 펼치면 Main과 서브에이전트의 작업, 검사·리뷰와 재수정 흐름을 그래프로 보고 노드에서 관련 기록·변경 파일·문서를 열 수 있습니다. 넓은 카드에서는 단계가 상자로 한 줄에 놓이고, 카드 폭이 740px 이하이면 일어난 순서대로 적는 세로 레일로 바뀝니다. 실제 진행 중에는 지금 단계의 진행 표시만 움직이고, 완료되면 결과만 정지한 상태로 남습니다. 서브에이전트 카드를 펼치면 조사·구현·검증·보고·Main 판정 흐름을 같은 그래프로 봅니다. 업무 종류와 동시 실행은 기록으로 확인된 경우에만 표시합니다. `.omp` 작업 폴더나 시스템 임시 폴더에 쓴 임시 파일은 변경 파일로 세지 않습니다.
+- 끝난 턴의 마지막 답변 아래에 변경 파일·검사·실패·미확인 요약이 붙습니다. 펼치면 Main과 서브에이전트의 작업, 검사·리뷰와 재수정 흐름을 그래프로 보고 노드에서 관련 기록·변경 파일·문서를 열 수 있습니다. 넓은 카드에서는 단계가 상자로 한 줄에 놓이고, 카드 폭이 740px 이하이면 일어난 순서대로 적는 세로 레일로 바뀝니다. 실제 진행 중에는 지금 단계의 진행 표시만 움직이고, 완료되면 결과만 정지한 상태로 남습니다. 끝난 그래프의 「재생」을 누르면 실제로 거친 단계와 서브에이전트 갈래, 되돌아온 재수정, 변경 결과를 차례로 다시 밝힌 뒤 정지한 그래프로 돌아갑니다. 재생은 기록된 순서만 보여 주며 실제 걸린 시간에 비례하지 않습니다. 서브에이전트 카드를 펼치면 조사·구현·검증·보고·Main 판정 흐름을 같은 그래프로 봅니다. 업무 종류와 동시 실행은 기록으로 확인된 경우에만 표시합니다. `.omp` 작업 폴더나 시스템 임시 폴더에 쓴 임시 파일은 변경 파일로 세지 않습니다.
 - 검사 후 다시 수정한 작업은 이전 통과 결과를 현재 검증으로 표시하지 않습니다. 확인되지 않은 검사·복합 명령은 「판정 미확인」으로, 답을 읽지 못한 교차리뷰는 「리뷰 불가」로 구분합니다. 실행 중 끼어든 지시가 같은 작업을 이어 가면 이전 작업 흐름을 함께 보여 줍니다. 비공개 파일만 게시해 공개 CI가 생기지 않은 것으로 확인되면 CI는 「필요 없음」으로 표시하고, CI·배포가 없던 턴은 끝난 뒤 그 단계를 「필요 없음」으로 닫습니다.
 - 실행 중에 보낸 입력은 「지금 지시」와 「완료 후 요청」으로 나뉘어, 접수·전달 대기·대화에 들어감 단계를 따로 보여 줍니다. 전달을 확인하지 못하면 그렇다고 표시합니다. 스크린샷만 보낸 입력도 「이미지 N개」로 표시합니다. 기본 목록에는 최근 4개만 보이고, 「이전 N개 더 보기」로 나머지를 펼칠 수 있습니다. 실제 대기 중인 입력은 목록에서 숨겨져도 유지되며, 펼친 목록에서 거둘 수 있습니다.
 - 자식 에이전트의 발화가 해당 턴 아래 대화 흐름에 끼어들어 누가 무슨 말을 했는지 이어서 읽힙니다.

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.51',
     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.51",
   "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": {