@prestyj/cli 5.9.0 → 5.11.0

package/dist/utils/image.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=image.test.d.ts.map

package/dist/utils/image.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.test.d.ts","sourceRoot":"","sources":["../../src/utils/image.test.ts"],"names":[],"mappings":""}

package/dist/utils/image.test.js

@@ -0,0 +1,139 @@
+import { describe, expect, it } from "vitest";
+import sharp from "sharp";
+import { boundedSize, fitsVisualBudget, shrinkToFit } from "./image.js";
+const PATCH = 28;
+const MAX_PATCHES = 1568;
+const MAX_EDGE = 1568;
+function patchArea(width, height) {
+    return (width * height) / (PATCH * PATCH);
+}
+/** Solid-colour PNG of exact dimensions — cheap to encode, real bytes for sharp. */
+function makePng(width, height) {
+    return sharp({
+        create: { width, height, channels: 4, background: { r: 32, g: 64, b: 128, alpha: 1 } },
+    })
+        .png()
+        .toBuffer();
+}
+describe("boundedSize", () => {
+    const cases = [
+        {
+            name: "1280x800 laptop screenshot is already inside the budget",
+            input: [1280, 800],
+            expected: [1280, 800],
+        },
+        {
+            name: "2000x2000 square shrinks to the patch budget",
+            input: [2000, 2000],
+            expected: [1108, 1108],
+        },
+        { name: "1x1 survives", input: [1, 1], expected: [1, 1] },
+        { name: "1568x1 is exactly at the edge cap", input: [1568, 1], expected: [1568, 1] },
+    ];
+    for (const { name, input, expected } of cases) {
+        it(name, () => {
+            expect(boundedSize(input[0], input[1])).toEqual({ width: expected[0], height: expected[1] });
+        });
+    }
+    it("2560x1600 stays within 1568 patches", () => {
+        const { width, height } = boundedSize(2560, 1600);
+        expect(patchArea(width, height)).toBeLessThanOrEqual(MAX_PATCHES);
+        expect(Math.max(width, height)).toBeLessThanOrEqual(MAX_EDGE);
+        // aspect preserved within a pixel of rounding
+        expect(Math.abs(width / height - 2560 / 1600)).toBeLessThan(0.01);
+    });
+    it("caps a 3000x400 panorama at 1568 on the long edge", () => {
+        // Well inside the patch budget (1.2 MP) — only the per-side cap binds here.
+        expect(patchArea(3000, 400)).toBeLessThanOrEqual(MAX_PATCHES);
+        expect(boundedSize(3000, 400)).toEqual({ width: 1568, height: 209 });
+    });
+    it("returns the largest fitting size, not merely a fitting one", () => {
+        for (const [w, h] of [
+            [2000, 2000],
+            [2560, 1600],
+            [4000, 3000],
+            [800, 5000],
+        ]) {
+            const { width, height } = boundedSize(w, h);
+            expect(fitsVisualBudget(width, height)).toBe(true);
+            // One pixel more on the long edge must break the budget or hit the cap.
+            const landscape = w >= h;
+            const long = landscape ? width : height;
+            expect(long).toBeGreaterThan(0);
+            if (long < MAX_EDGE) {
+                const nextLong = long + 1;
+                const ratio = landscape ? h / w : w / h;
+                const nextShort = Math.max(1, Math.round(nextLong * ratio));
+                const next = landscape
+                    ? { width: nextLong, height: nextShort }
+                    : { width: nextShort, height: nextLong };
+                expect(fitsVisualBudget(next.width, next.height)).toBe(false);
+            }
+        }
+    });
+    it("leaves non-finite or sub-pixel input alone", () => {
+        expect(boundedSize(0, 0)).toEqual({ width: 0, height: 0 });
+        expect(boundedSize(Number.NaN, 10)).toEqual({ width: Number.NaN, height: 10 });
+    });
+});
+describe("fitsVisualBudget", () => {
+    it("rejects anything past the per-side cap even at tiny area", () => {
+        expect(fitsVisualBudget(1569, 1)).toBe(false);
+        expect(fitsVisualBudget(1568, 1)).toBe(true);
+    });
+    it("rejects anything past the patch budget", () => {
+        expect(fitsVisualBudget(1108, 1108)).toBe(true);
+        expect(fitsVisualBudget(1109, 1109)).toBe(false);
+    });
+});
+describe("shrinkToFit", () => {
+    it("returns a 1280x800 PNG byte-identical to the input", async () => {
+        const original = await makePng(1280, 800);
+        const { buffer, mediaType } = await shrinkToFit(original, "image/png");
+        expect(mediaType).toBe("image/png");
+        expect(buffer.equals(original)).toBe(true);
+    });
+    it("downscales a 2000x2000 PNG to 1108x1108 and keeps it a PNG", async () => {
+        const { buffer, mediaType } = await shrinkToFit(await makePng(2000, 2000), "image/png");
+        expect(mediaType).toBe("image/png");
+        const meta = await sharp(buffer).metadata();
+        expect({ width: meta.width, height: meta.height }).toEqual({ width: 1108, height: 1108 });
+        expect(meta.format).toBe("png");
+    });
+    it("brings a 2560x1600 screenshot inside the patch budget", async () => {
+        const { buffer } = await shrinkToFit(await makePng(2560, 1600), "image/png");
+        const meta = await sharp(buffer).metadata();
+        expect(patchArea(meta.width ?? 0, meta.height ?? 0)).toBeLessThanOrEqual(MAX_PATCHES);
+    });
+    it("caps a 3000x400 panorama at the long-edge limit", async () => {
+        const { buffer } = await shrinkToFit(await makePng(3000, 400), "image/png");
+        const meta = await sharp(buffer).metadata();
+        // sharp's fit: "inside" preserves the exact source aspect, so the long edge
+        // can land a pixel under the target — it must never land over it.
+        expect(meta.width).toBeLessThanOrEqual(MAX_EDGE);
+        expect(meta.width).toBeGreaterThan(MAX_EDGE - 4);
+        expect(patchArea(meta.width ?? 0, meta.height ?? 0)).toBeLessThanOrEqual(MAX_PATCHES);
+    });
+    it("leaves a 1x1 image untouched", async () => {
+        const original = await makePng(1, 1);
+        const { buffer } = await shrinkToFit(original, "image/png");
+        expect(buffer.equals(original)).toBe(true);
+    });
+    it("preserves the alpha channel rather than flattening to JPEG", async () => {
+        const transparent = await sharp({
+            create: {
+                width: 2000,
+                height: 2000,
+                channels: 4,
+                background: { r: 0, g: 0, b: 0, alpha: 0 },
+            },
+        })
+            .png()
+            .toBuffer();
+        const { buffer, mediaType } = await shrinkToFit(transparent, "image/png");
+        expect(mediaType).toBe("image/png");
+        const meta = await sharp(buffer).metadata();
+        expect(meta.hasAlpha).toBe(true);
+    });
+});
+//# sourceMappingURL=image.test.js.map

package/dist/utils/image.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.test.js","sourceRoot":"","sources":["../../src/utils/image.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/process.d.ts

@@ -1,6 +1,29 @@
+import { spawnSync } from "node:child_process";
+export interface ProcessTreeKillOptions {
+    platform?: NodeJS.Platform;
+    kill?: typeof process.kill;
+    spawnSync?: typeof spawnSync;
+    env?: NodeJS.ProcessEnv;
+    taskkillTimeoutMs?: number;
+}
 /**
- * Kill a process and all its children by sending SIGKILL to the process group.
- * Falls back to killing just the process if process group kill fails.
+ * Absolute path to `taskkill.exe`.
+ *
+ * Bare `"taskkill"` depends on `System32` being on PATH — not guaranteed for a
+ * GUI-launched app whose PATH we also mutate — and is spoofable by a
+ * `taskkill.exe` sitting in the project cwd. Resolve it from `SystemRoot`
+ * (falling back to `WINDIR`, then `C:\Windows`), rejecting anything that isn't
+ * a plain drive-rooted path.
  */
-export declare function killProcessTree(pid: number): void;
+export declare function resolveWindowsTaskkillPath(env?: NodeJS.ProcessEnv): string;
+/**
+ * Kill a process and every descendant.
+ *
+ * POSIX: SIGKILL the process group (negative pid), falling back to the single
+ * pid. Windows has no process groups and negative pids are invalid there — the
+ * POSIX path silently left the whole child tree running, so a timed-out or
+ * cancelled `bash` command kept its `npm`/`node`/`pnpm` descendants alive
+ * forever. Use `taskkill /T /F` instead, falling back to the direct pid.
+ */
+export declare function killProcessTree(pid: number, options?: ProcessTreeKillOptions): void;
 //# sourceMappingURL=process.d.ts.map

package/dist/utils/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAWjD"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,OAAO,CAAC,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AASD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAavF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,IAAI,CA0BvF"}

package/dist/utils/process.js

@@ -1,19 +1,77 @@
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+const DEFAULT_TASKKILL_TIMEOUT_MS = 5_000;
+function getEnvCaseInsensitive(env, name) {
+    const wanted = name.toLowerCase();
+    return Object.entries(env).find(([key]) => key.toLowerCase() === wanted)?.[1];
+}
 /**
- * Kill a process and all its children by sending SIGKILL to the process group.
- * Falls back to killing just the process if process group kill fails.
+ * Absolute path to `taskkill.exe`.
+ *
+ * Bare `"taskkill"` depends on `System32` being on PATH — not guaranteed for a
+ * GUI-launched app whose PATH we also mutate — and is spoofable by a
+ * `taskkill.exe` sitting in the project cwd. Resolve it from `SystemRoot`
+ * (falling back to `WINDIR`, then `C:\Windows`), rejecting anything that isn't
+ * a plain drive-rooted path.
  */
-export function killProcessTree(pid) {
-    try {
-        // Kill the entire process group (negative pid)
-        process.kill(-pid, "SIGKILL");
-    }
-    catch {
+export function resolveWindowsTaskkillPath(env = process.env) {
+    const normalize = (value) => {
+        if (value === undefined)
+            return undefined;
+        const root = value.trim();
+        const unsafe = [...root].some((ch) => ch === ";" || ch.charCodeAt(0) <= 31);
+        if (!/^[A-Za-z]:[\\/]/.test(root) || unsafe)
+            return undefined;
+        return path.win32.normalize(root);
+    };
+    const systemRoot = normalize(getEnvCaseInsensitive(env, "SystemRoot")) ??
+        normalize(getEnvCaseInsensitive(env, "WINDIR")) ??
+        "C:\\Windows";
+    return path.win32.join(systemRoot, "System32", "taskkill.exe");
+}
+/**
+ * Kill a process and every descendant.
+ *
+ * POSIX: SIGKILL the process group (negative pid), falling back to the single
+ * pid. Windows has no process groups and negative pids are invalid there — the
+ * POSIX path silently left the whole child tree running, so a timed-out or
+ * cancelled `bash` command kept its `npm`/`node`/`pnpm` descendants alive
+ * forever. Use `taskkill /T /F` instead, falling back to the direct pid.
+ */
+export function killProcessTree(pid, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const kill = options.kill ?? process.kill;
+    if (platform !== "win32") {
         try {
-            process.kill(pid, "SIGKILL");
+            kill(-pid, "SIGKILL");
+            return;
         }
         catch {
-            // Process already exited
+            killSingleProcess(pid, kill);
+            return;
         }
     }
+    const executable = resolveWindowsTaskkillPath(options.env);
+    try {
+        const result = (options.spawnSync ?? spawnSync)(executable, ["/PID", String(pid), "/T", "/F"], {
+            stdio: "ignore",
+            windowsHide: true,
+            timeout: options.taskkillTimeoutMs ?? DEFAULT_TASKKILL_TIMEOUT_MS,
+        });
+        if (result.status === 0 && result.error === undefined)
+            return;
+    }
+    catch {
+        // Fall through to the direct-pid fallback below.
+    }
+    killSingleProcess(pid, kill);
+}
+function killSingleProcess(pid, kill) {
+    try {
+        kill(pid, "SIGKILL");
+    }
+    catch {
+        // Process already exited.
+    }
 }
 //# sourceMappingURL=process.js.map

package/dist/utils/process.js.map

@@ -1 +1 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,+CAA+C;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"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"}

package/dist/utils/process.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=process.test.d.ts.map

package/dist/utils/process.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.test.d.ts","sourceRoot":"","sources":["../../src/utils/process.test.ts"],"names":[],"mappings":""}

package/dist/utils/process.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, it, vi } from "vitest";
+import { killProcessTree, resolveWindowsTaskkillPath } from "./process.js";
+describe("resolveWindowsTaskkillPath", () => {
+    it("resolves taskkill from SystemRoot", () => {
+        expect(resolveWindowsTaskkillPath({ SystemRoot: "C:\\Windows" })).toBe("C:\\Windows\\System32\\taskkill.exe");
+    });
+    it("is case-insensitive about the env var name and falls back to WINDIR", () => {
+        expect(resolveWindowsTaskkillPath({ systemroot: "D:/Win" })).toBe("D:\\Win\\System32\\taskkill.exe");
+        expect(resolveWindowsTaskkillPath({ WINDIR: "E:\\W" })).toBe("E:\\W\\System32\\taskkill.exe");
+    });
+    it("rejects relative or injected roots and falls back to C:\\Windows", () => {
+        expect(resolveWindowsTaskkillPath({ SystemRoot: "windows" })).toBe("C:\\Windows\\System32\\taskkill.exe");
+        expect(resolveWindowsTaskkillPath({ SystemRoot: "C:\\Win;C:\\evil" })).toBe("C:\\Windows\\System32\\taskkill.exe");
+        expect(resolveWindowsTaskkillPath({})).toBe("C:\\Windows\\System32\\taskkill.exe");
+    });
+});
+describe("killProcessTree", () => {
+    it("kills the whole tree with taskkill on Windows (never a negative pid)", () => {
+        const spawnSync = vi.fn().mockReturnValue({ status: 0 });
+        const kill = vi.fn();
+        killProcessTree(4242, {
+            platform: "win32",
+            kill,
+            spawnSync: spawnSync,
+            env: { SystemRoot: "C:\\Windows" },
+        });
+        expect(spawnSync).toHaveBeenCalledWith("C:\\Windows\\System32\\taskkill.exe", ["/PID", "4242", "/T", "/F"], expect.objectContaining({ windowsHide: true }));
+        expect(kill).not.toHaveBeenCalled();
+    });
+    it("falls back to the direct pid when taskkill fails", () => {
+        const spawnSync = vi.fn().mockReturnValue({ status: 1 });
+        const kill = vi.fn();
+        killProcessTree(7, { platform: "win32", kill, spawnSync: spawnSync, env: {} });
+        expect(kill).toHaveBeenCalledWith(7, "SIGKILL");
+    });
+    it("signals the process group on POSIX", () => {
+        const kill = vi.fn();
+        killProcessTree(99, { platform: "darwin", kill });
+        expect(kill).toHaveBeenCalledWith(-99, "SIGKILL");
+    });
+});
+//# sourceMappingURL=process.test.js.map

package/dist/utils/process.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.test.js","sourceRoot":"","sources":["../../src/utils/process.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prestyj/cli",
-  "version": "5.9.0",
+  "version": "5.11.0",
   "type": "module",
   "description": "CLI coding agent with OAuth authentication for Anthropic, OpenAI, and Gemini",
   "license": "MIT",
@@ -91,10 +91,11 @@
     "assets"
   ],
   "dependencies": {
+    "@anthropic-ai/sandbox-runtime": "0.0.67",
     "@jridgewell/trace-mapping": "^0.3.25",
     "@kenkaiiii/agent-home-sdk": "^0.3.8",
     "@kenkaiiii/kencode-search": "^0.1.17",
-    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@modelcontextprotocol/client": "^2.0.0",
     "ansi-regex": "^6.2.2",
     "chalk": "^5.6.2",
     "cli-highlight": "^2.1.11",
@@ -114,9 +115,9 @@
     "typescript-language-server": "^5.3.0",
     "wrap-ansi": "^10.0.0",
     "zod": "^4.4.3",
-    "@prestyj/ai": "5.9.0",
-    "@prestyj/core": "5.9.0",
-    "@prestyj/agent": "5.9.0",
+    "@prestyj/ai": "5.11.0",
+    "@prestyj/core": "5.11.0",
+    "@prestyj/agent": "5.11.0",
     "@prestyj/pixel": "4.3.101"
   },
   "optionalDependencies": {