@prestyj/cli 5.11.0 → 5.12.0

package/dist/core/mcp/content.js

@@ -0,0 +1,172 @@
+import { log } from "../logger.js";
+import { shrinkToFit } from "../../utils/image.js";
+/** Media types a provider will accept as an image part. */
+const SUPPORTED_IMAGE_MEDIA_TYPES = new Set(["image/png", "image/jpeg", "image/gif", "image/webp"]);
+/**
+ * Cap on image parts forwarded from a single tool call. An MCP server is
+ * third-party code and can return an unbounded array; each image costs real
+ * tokens, so keep the rest as a counted note rather than silently blowing up
+ * the turn.
+ */
+const MAX_IMAGES_PER_RESULT = 4;
+function record(item) {
+    if (item == null || typeof item !== "object")
+        return null;
+    return item;
+}
+function str(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+/**
+ * An MCP image part, per spec: `{ type: "image", data: <base64>, mimeType }`.
+ * Validated structurally because the payload crosses a trust boundary — a
+ * server can send anything, including a `type` that lies about the shape.
+ */
+function asImagePart(item) {
+    const part = record(item);
+    if (!part || part.type !== "image")
+        return null;
+    const data = str(part.data);
+    if (!data)
+        return null;
+    return { data, mimeType: str(part.mimeType) ?? "image/png" };
+}
+/**
+ * An image delivered as an embedded resource rather than an `image` block:
+ * `{ type: "resource", resource: { uri, mimeType: "image/png", blob } }`. Servers
+ * use this shape when the image also has a URI, and it is just as viewable, so
+ * it must not be reduced to a note.
+ */
+function asEmbeddedImage(item) {
+    const part = record(item);
+    if (!part || part.type !== "resource")
+        return null;
+    const resource = record(part.resource);
+    if (!resource)
+        return null;
+    const mimeType = str(resource.mimeType);
+    const blob = str(resource.blob);
+    if (!blob || !mimeType?.startsWith("image/"))
+        return null;
+    return { data: blob, mimeType };
+}
+/**
+ * Render a non-image block as text.
+ *
+ * Every branch returns *something*: a block this function drops is a block the
+ * model never learns existed, which is the defect this module exists to fix.
+ * `null` means "carries no information" (an empty text block), not "unsupported".
+ */
+function asText(item, toolName) {
+    const part = record(item);
+    if (!part)
+        return null;
+    switch (part.type) {
+        case "text":
+            return typeof part.text === "string" ? part.text : null;
+        // Audio is not viewable by any provider we target; name it so the model can
+        // say what it received rather than behaving as though nothing came back.
+        case "audio":
+            return `[${toolName} returned audio (${str(part.mimeType) ?? "unknown format"})]`;
+        // A link is a reference, not content: pass the address through so the model
+        // can fetch or cite it.
+        case "resource_link": {
+            const label = str(part.title) ?? str(part.name);
+            const uri = str(part.uri) ?? "(no uri)";
+            return label ? `[resource link: ${label}] ${uri}` : `[resource link] ${uri}`;
+        }
+        case "resource": {
+            const resource = record(part.resource);
+            if (!resource)
+                return null;
+            const uri = str(resource.uri) ?? "(no uri)";
+            // An embedded text resource carries its content inline — this is usually
+            // the substantive answer (a file, a query result), so surface it in full
+            // under a header rather than describing it.
+            const text = typeof resource.text === "string" ? resource.text : undefined;
+            if (text !== undefined)
+                return `[resource ${uri}]\n${text}`;
+            const blob = str(resource.blob);
+            if (blob) {
+                // Non-image binary: unusable by the model, but its existence and size
+                // are what let it reason about what the server actually returned.
+                const kind = str(resource.mimeType) ?? "binary";
+                return `[resource ${uri} (${kind}, ${Buffer.byteLength(blob, "base64")} bytes) omitted]`;
+            }
+            return `[resource ${uri}]`;
+        }
+        default:
+            // Unknown block type: a future spec addition. Prefer a fallback over
+            // silence, but only when it actually carries text.
+            return typeof part.text === "string" ? part.text : null;
+    }
+}
+/**
+ * Convert an MCP tool's content array into a result the model can actually
+ * consume, covering the whole `ContentBlock` union rather than text alone.
+ *
+ * Text-only results stay plain strings so the overwhelmingly common path keeps
+ * its existing shape (and the agent loop's string budgeting still applies).
+ * Images are re-encoded through {@link shrinkToFit}, the same helper the `read`
+ * tool uses: an unbounded screenshot from a third-party server would otherwise
+ * exceed provider size limits and fail the whole turn. A media type the buffer
+ * contradicts is corrected there too, since providers reject mismatches.
+ *
+ * Anything not viewable — audio, a resource link, a binary blob, an unreadable
+ * image — becomes a text note instead of vanishing. A block silently dropped is
+ * one the model never learns existed, so it answers as though the server
+ * returned nothing; a note lets it say what it actually got.
+ */
+export async function toToolResult(content, toolName) {
+    const texts = [];
+    const rawImages = [];
+    for (const item of content) {
+        const image = asImagePart(item) ?? asEmbeddedImage(item);
+        if (image) {
+            rawImages.push(image);
+            continue;
+        }
+        const text = asText(item, toolName);
+        if (text !== null)
+            texts.push(text);
+    }
+    if (rawImages.length === 0) {
+        return texts.join("\n") || "(empty response)";
+    }
+    const dropped = rawImages.length - MAX_IMAGES_PER_RESULT;
+    const kept = dropped > 0 ? rawImages.slice(0, MAX_IMAGES_PER_RESULT) : rawImages;
+    const parts = [];
+    for (const image of kept) {
+        try {
+            const raw = Buffer.from(image.data, "base64");
+            if (raw.length === 0) {
+                parts.push({ type: "text", text: `[${toolName} returned an empty image]` });
+                continue;
+            }
+            const { buffer, mediaType } = await shrinkToFit(raw, image.mimeType);
+            if (!SUPPORTED_IMAGE_MEDIA_TYPES.has(mediaType)) {
+                parts.push({
+                    type: "text",
+                    text: `[${toolName} returned an image in unsupported format ${mediaType}]`,
+                });
+                continue;
+            }
+            parts.push({ type: "image", mediaType, data: buffer.toString("base64") });
+        }
+        catch (err) {
+            // A malformed or undecodable image must not fail the tool call: the text
+            // parts of the same response are often the substantive answer.
+            const reason = err instanceof Error ? err.message : String(err);
+            log("WARN", "mcp", "Dropping unreadable MCP image part", { tool: toolName, reason });
+            parts.push({ type: "text", text: `[${toolName} returned an unreadable image]` });
+        }
+    }
+    const notes = [...texts];
+    if (dropped > 0) {
+        notes.push(`[${dropped} further image${dropped === 1 ? "" : "s"} omitted]`);
+    }
+    // Text first: it frames the images for the model, and matches `read`'s order.
+    const leading = notes.join("\n");
+    return { content: leading ? [{ type: "text", text: leading }, ...parts] : parts };
+}
+//# sourceMappingURL=content.js.map

package/dist/core/mcp/content.js.map

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

package/dist/core/mcp/content.test.d.ts

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

package/dist/core/mcp/content.test.d.ts.map

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

package/dist/core/mcp/content.test.js

@@ -0,0 +1,135 @@
+import { describe, expect, it } from "vitest";
+import sharp from "sharp";
+import { toToolResult } from "./content.js";
+import { boundedSize } from "../../utils/image.js";
+/** Mirrors the private cap in utils/image.ts — kept local rather than widening that module's API. */
+const MAX_IMAGE_BYTES = 5 * 1024 * 1024;
+async function pngBase64(width, height) {
+    const buffer = await sharp({
+        create: { width, height, channels: 3, background: { r: 10, g: 120, b: 200 } },
+    })
+        .png()
+        .toBuffer();
+    return buffer.toString("base64");
+}
+describe("toToolResult", () => {
+    it("keeps a text-only response a plain string", async () => {
+        const result = await toToolResult([{ type: "text", text: "hello" }], "mcp__x__y");
+        expect(result).toBe("hello");
+    });
+    it("reports an empty response only when there is genuinely nothing", async () => {
+        expect(await toToolResult([], "mcp__x__y")).toBe("(empty response)");
+    });
+    // Every one of these used to return "(empty response)" — the same defect as the
+    // image case, one block type over.
+    describe("non-image blocks reach the model instead of vanishing", () => {
+        it("surfaces an embedded text resource in full", async () => {
+            const result = await toToolResult([
+                {
+                    type: "resource",
+                    resource: { uri: "file:///notes.md", mimeType: "text/markdown", text: "THE ANSWER" },
+                },
+            ], "mcp__s__t");
+            expect(result).toContain("THE ANSWER");
+            expect(result).toContain("file:///notes.md");
+        });
+        it("passes a resource link's address through", async () => {
+            const result = await toToolResult([{ type: "resource_link", uri: "https://example.com/a", name: "report" }], "mcp__s__t");
+            expect(result).toContain("https://example.com/a");
+            expect(result).toContain("report");
+        });
+        it("names audio rather than returning nothing", async () => {
+            const result = await toToolResult([{ type: "audio", data: "aGk=", mimeType: "audio/wav" }], "mcp__s__t");
+            expect(result).toContain("audio");
+            expect(result).not.toBe("(empty response)");
+        });
+        it("notes a non-image binary blob with its size", async () => {
+            const result = await toToolResult([
+                {
+                    type: "resource",
+                    resource: { uri: "file:///a.zip", mimeType: "application/zip", blob: "AAAA" },
+                },
+            ], "mcp__s__t");
+            expect(result).toContain("file:///a.zip");
+            expect(result).toContain("application/zip");
+            expect(result).toContain("3 bytes");
+        });
+        it("falls back to text on an unknown future block type", async () => {
+            const result = await toToolResult([{ type: "video", text: "a clip" }], "mcp__s__t");
+            expect(result).toBe("a clip");
+        });
+    });
+    // Servers use this shape when the image also has a URI; it is just as viewable.
+    it("forwards an image delivered as an embedded resource blob", async () => {
+        const data = await pngBase64(8, 8);
+        const result = await toToolResult([
+            {
+                type: "resource",
+                resource: { uri: "file:///shot.png", mimeType: "image/png", blob: data },
+            },
+        ], "mcp__s__t");
+        const parts = result.content;
+        expect(parts.some((p) => p.type === "image")).toBe(true);
+    });
+    it("forwards an image-only response instead of dropping it", async () => {
+        const data = await pngBase64(8, 8);
+        const result = await toToolResult([{ type: "image", data, mimeType: "image/png" }], "mcp__s__t");
+        expect(typeof result).not.toBe("string");
+        const parts = result.content;
+        expect(parts).toHaveLength(1);
+        expect(parts[0]).toMatchObject({ type: "image", mediaType: "image/png" });
+    });
+    it("puts text before images so it frames them", async () => {
+        const data = await pngBase64(8, 8);
+        const result = await toToolResult([
+            { type: "text", text: "here is the chart" },
+            { type: "image", data, mimeType: "image/png" },
+        ], "mcp__s__t");
+        const parts = result.content;
+        expect(parts.map((p) => p.type)).toEqual(["text", "image"]);
+        expect(parts[0]?.text).toBe("here is the chart");
+    });
+    // A third-party server can return a screenshot far larger than any provider
+    // accepts; forwarding it verbatim would fail the whole turn.
+    it("shrinks an oversized image to fit provider limits", async () => {
+        const huge = boundedSize(8000, 8000);
+        const data = await pngBase64(8000, 8000);
+        expect(Buffer.from(data, "base64").length).toBeGreaterThan(0);
+        const result = await toToolResult([{ type: "image", data, mimeType: "image/png" }], "mcp__s__t");
+        const parts = result.content;
+        const image = parts.find((p) => p.type === "image");
+        const bytes = Buffer.from(image?.data ?? "", "base64");
+        expect(bytes.length).toBeLessThanOrEqual(MAX_IMAGE_BYTES);
+        const meta = await sharp(bytes).metadata();
+        expect(meta.width).toBeLessThanOrEqual(huge.width);
+    });
+    // Providers reject a media type the bytes contradict.
+    it("corrects a media type the payload disagrees with", async () => {
+        const data = await pngBase64(8, 8);
+        const result = await toToolResult([{ type: "image", data, mimeType: "image/jpeg" }], "mcp__s__t");
+        const parts = result.content;
+        expect(parts.find((p) => p.type === "image")?.mediaType).toBe("image/png");
+    });
+    it("degrades an unreadable image to a note and keeps the text", async () => {
+        const result = await toToolResult([
+            { type: "text", text: "rendered" },
+            { type: "image", data: "bm90LWFuLWltYWdl", mimeType: "image/png" },
+        ], "mcp__s__t");
+        const parts = result.content;
+        expect(parts[0]?.text).toBe("rendered");
+        expect(parts[1]?.text).toContain("unreadable image");
+    });
+    it("caps how many images one call can forward", async () => {
+        const data = await pngBase64(8, 8);
+        const many = Array.from({ length: 7 }, () => ({
+            type: "image",
+            data,
+            mimeType: "image/png",
+        }));
+        const result = await toToolResult(many, "mcp__s__t");
+        const parts = result.content;
+        expect(parts.filter((p) => p.type === "image")).toHaveLength(4);
+        expect(parts[0]?.text).toContain("3 further images omitted");
+    });
+});
+//# sourceMappingURL=content.test.js.map

package/dist/core/mcp/content.test.js.map

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

package/dist/core/mcp/deferred-catalog.d.ts

@@ -3,7 +3,7 @@ import type { AgentTool } from "@prestyj/agent";
  * Holds MCP tools OUT of the per-turn request payload until the model asks
  * for them via `tool_search`.
  *
- * Benchmarked (bench/RESULTS.md, bench A): injecting every MCP tool schema
+ * Measured: injecting every MCP tool schema
  * eagerly cost ~33KB (~8.3k tokens) per cache-miss turn with just two MCP
  * servers connected — 56% of all billed input tokens in a 6-turn session.
  * Deferring keeps the tool prefix small and byte-stable; promotion is a

package/dist/core/mcp/deferred-catalog.js

@@ -2,7 +2,7 @@
  * Holds MCP tools OUT of the per-turn request payload until the model asks
  * for them via `tool_search`.
  *
- * Benchmarked (bench/RESULTS.md, bench A): injecting every MCP tool schema
+ * Measured: injecting every MCP tool schema
  * eagerly cost ~33KB (~8.3k tokens) per cache-miss turn with just two MCP
  * servers connected — 56% of all billed input tokens in a 6-turn session.
  * Deferring keeps the tool prefix small and byte-stable; promotion is a

package/dist/core/mcp/elicitation.test.js

@@ -36,7 +36,7 @@ async function callTool(tools, suffix) {
     return typeof result === "string" ? result : JSON.stringify(result);
 }
 beforeEach(async () => {
-    dir = await fs.mkdtemp(path.join(os.tmpdir(), "gg-mcp-elicit-"));
+    dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-mcp-elicit-"));
 });
 afterEach(async () => {
     await Promise.all(managers.splice(0).map((instance) => instance.dispose()));

package/dist/core/mcp/legacy-negotiation.test.js

@@ -28,7 +28,7 @@ function legacyServer(overrides = {}) {
     };
 }
 beforeEach(async () => {
-    dir = await fs.mkdtemp(path.join(os.tmpdir(), "gg-mcp-legacy-"));
+    dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-mcp-legacy-"));
     cachePath = path.join(dir, "mcp-catalog.json");
 });
 afterEach(async () => {
@@ -55,7 +55,7 @@ describe("2025-only stdio server under version negotiation", () => {
     it("connects a server that stays silent on the discovery probe", async () => {
         const config = legacyServer({
             name: "silent-legacy-fixture",
-            env: { GG_FIXTURE_SILENT_ON_UNKNOWN: "1" },
+            env: { EZ_FIXTURE_SILENT_ON_UNKNOWN: "1" },
             // Generous connect budget: the point is that the PROBE does not consume
             // it. Without a stdio-specific probe timeout the probe inherits this
             // value, so a silent server would burn the full 30s before falling back.

package/dist/core/mcp/oauth-store.test.js

@@ -8,7 +8,7 @@ describe("McpOAuthStore", () => {
     let dir;
     let file;
     beforeEach(async () => {
-        dir = await fs.mkdtemp(path.join(os.tmpdir(), "gg-mcp-auth-"));
+        dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-mcp-auth-"));
         file = path.join(dir, "mcp-auth.json");
     });
     afterEach(async () => {
@@ -46,7 +46,7 @@ describe("McpOAuthProvider", () => {
     let dir;
     let store;
     beforeEach(async () => {
-        dir = await fs.mkdtemp(path.join(os.tmpdir(), "gg-mcp-prov-"));
+        dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-mcp-prov-"));
         store = new McpOAuthStore(path.join(dir, "mcp-auth.json"));
     });
     afterEach(async () => {

package/dist/core/mcp/resolve-stdio.test.js

@@ -92,7 +92,7 @@ describe("resolveStdioCommand npx-cache fallback (covers user-added MCPs)", () =
         tmp = undefined;
     });
     it("rewrites a non-bundled but npx-cached server to `node <binScript>`", () => {
-        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "gg-npx-cache-"));
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "ez-npx-cache-"));
         seedNpxCache(tmp, "hash1", "@vendor/cool-mcp", "1.0.0");
         process.env.npm_config_cache = tmp;
         const out = resolveStdioCommand("npx", ["-y", "@vendor/cool-mcp"]);
@@ -100,7 +100,7 @@ describe("resolveStdioCommand npx-cache fallback (covers user-added MCPs)", () =
         expect(out.args[0]).toMatch(/cool-mcp[/\\]build[/\\]index\.js$/);
     });
     it("honours a version pin: a mismatched cached version falls through to npx", () => {
-        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "gg-npx-cache-"));
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "ez-npx-cache-"));
         seedNpxCache(tmp, "hash1", "@vendor/cool-mcp", "1.0.0");
         process.env.npm_config_cache = tmp;
         // Requested @2.0.0, only 1.0.0 cached → do NOT rewrite to the wrong version.
@@ -111,7 +111,7 @@ describe("resolveStdioCommand npx-cache fallback (covers user-added MCPs)", () =
             expect(out.command).toBe("npx");
     });
     it("uses a cached copy whose version matches the pin exactly", () => {
-        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "gg-npx-cache-"));
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "ez-npx-cache-"));
         seedNpxCache(tmp, "hash1", "@vendor/cool-mcp", "2.0.0");
         process.env.npm_config_cache = tmp;
         const out = resolveStdioCommand("npx", ["-y", "@vendor/cool-mcp@2.0.0"]);
@@ -119,7 +119,7 @@ describe("resolveStdioCommand npx-cache fallback (covers user-added MCPs)", () =
         expect(out.args[0]).toMatch(/cool-mcp[/\\]build[/\\]index\.js$/);
     });
     it("picks the highest cached version when the spec is unpinned", () => {
-        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "gg-npx-cache-"));
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "ez-npx-cache-"));
         seedNpxCache(tmp, "old", "@vendor/cool-mcp", "1.2.0", "build/old.js");
         seedNpxCache(tmp, "new", "@vendor/cool-mcp", "1.10.0", "build/new.js");
         process.env.npm_config_cache = tmp;
@@ -131,7 +131,7 @@ describe("resolveStdioCommand npx-cache fallback (covers user-added MCPs)", () =
     it("resolves a sole bin whose key differs from the package name (e.g. zai)", () => {
         // @z_ai/mcp-server exposes bin `zai-mcp-server`, NOT `mcp-server`. A sole
         // bin must be used regardless of its key, or the rewrite silently misses.
-        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "gg-npx-cache-"));
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "ez-npx-cache-"));
         const pkgDir = path.join(tmp, "_npx", "h", "node_modules", "@z_ai", "mcp-server");
         fs.mkdirSync(path.join(pkgDir, "build"), { recursive: true });
         fs.writeFileSync(path.join(pkgDir, "build", "index.js"), "#!/usr/bin/env node\n");

package/dist/core/mcp/shared-pool.test.js

@@ -20,7 +20,7 @@ let cachePath;
 const managers = [];
 const pools = [];
 beforeEach(async () => {
-    dir = await fs.mkdtemp(path.join(os.tmpdir(), "gg-mcp-shared-"));
+    dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-mcp-shared-"));
     cachePath = path.join(dir, "mcp-catalog.json");
 });
 afterEach(async () => {
@@ -51,14 +51,14 @@ function sharedFixture(overrides = {}) {
     return {
         name: "shared-fixture",
         command: process.execPath,
-        args: [FIXTURE, `--gg-marker=${crypto.randomUUID()}`],
+        args: [FIXTURE, `--ez-marker=${crypto.randomUUID()}`],
         timeout: 10_000,
         ...overrides,
     };
 }
 /** Live child processes carrying this config's marker argument. */
 function processCount(config) {
-    const marker = config.args?.find((arg) => arg.startsWith("--gg-marker="));
+    const marker = config.args?.find((arg) => arg.startsWith("--ez-marker="));
     if (!marker)
         throw new Error("fixture config has no marker argument");
     const out = execFileSync("ps", ["-eo", "command"], { encoding: "utf8" });
@@ -351,7 +351,7 @@ describe.skipIf(process.platform === "win32")("shared servers across two session
         // Kill the child out from under the pool, exactly like a crash. Located
         // with `ps` rather than `pgrep`, whose BSD build reads this fixture's
         // leading `--` marker as an illegal option.
-        const marker = config.args.find((arg) => arg.startsWith("--gg-marker="));
+        const marker = config.args.find((arg) => arg.startsWith("--ez-marker="));
         const row = execFileSync("ps", ["-eo", "pid,command"], { encoding: "utf8" })
             .split("\n")
             .find((line) => line.includes(marker));
@@ -381,7 +381,7 @@ describe.skipIf(process.platform === "win32")("shared servers across two session
         const config = {
             name: "elicit-fixture",
             command: process.execPath,
-            args: [ELICIT_FIXTURE, `--gg-marker=${crypto.randomUUID()}`],
+            args: [ELICIT_FIXTURE, `--ez-marker=${crypto.randomUUID()}`],
             timeout: 10_000,
         };
         const pool = newPool();

package/dist/core/mcp/store.test.js

@@ -11,20 +11,20 @@ vi.mock("../../config.js", async () => {
         ...actual,
         getAppPaths: () => ({
             ...actual.getAppPaths(),
-            mcpFile: path.join(process.env.GG_TEST_HOME, ".ezcoder", "mcp.json"),
+            mcpFile: path.join(process.env.EZ_TEST_HOME, ".ezcoder", "mcp.json"),
         }),
     };
 });
 import { addServer, loadServers, removeServer, getServer, fromStoredEntry, globalMcpPath, projectMcpPath, } from "./store.js";
 beforeEach(async () => {
-    tmpHome = await fs.mkdtemp(path.join(os.tmpdir(), "gg-mcp-home-"));
-    tmpProject = await fs.mkdtemp(path.join(os.tmpdir(), "gg-mcp-proj-"));
-    process.env.GG_TEST_HOME = tmpHome;
+    tmpHome = await fs.mkdtemp(path.join(os.tmpdir(), "ez-mcp-home-"));
+    tmpProject = await fs.mkdtemp(path.join(os.tmpdir(), "ez-mcp-proj-"));
+    process.env.EZ_TEST_HOME = tmpHome;
 });
 afterEach(async () => {
     await fs.rm(tmpHome, { recursive: true, force: true });
     await fs.rm(tmpProject, { recursive: true, force: true });
-    delete process.env.GG_TEST_HOME;
+    delete process.env.EZ_TEST_HOME;
 });
 describe("mcp store", () => {
     it("round-trips an http server in global scope", async () => {

package/dist/core/mcp/when-connected.test.js

@@ -7,7 +7,7 @@ import { McpCatalogCache } from "./catalog-cache.js";
 let dir;
 let manager;
 beforeEach(async () => {
-    dir = await fs.mkdtemp(path.join(os.tmpdir(), "gg-mcp-when-connected-"));
+    dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-mcp-when-connected-"));
     manager = new MCPClientManager({
         catalogCache: new McpCatalogCache(path.join(dir, "mcp-catalog.json")),
     });
@@ -19,7 +19,7 @@ afterEach(async () => {
 /** A stdio command that cannot possibly start, so the connect fails fast. */
 const BROKEN = {
     name: "broken",
-    command: "gg-nonexistent-mcp-binary",
+    command: "ez-nonexistent-mcp-binary",
     args: [],
     timeout: 2_000,
 };

package/dist/core/nolan-model.test.js

@@ -40,7 +40,7 @@ describe("effectiveNolanModel", () => {
             nolanModelOverride: true,
         });
     });
-    it("pin identical to the build model still reports override=true (it survives GG switches)", () => {
+    it("pin identical to the build model still reports override=true (it survives EZ switches)", () => {
         expect(effectiveNolanModel({ provider: "anthropic", model: "claude-opus-5" }, build)).toEqual({
             nolanProvider: "anthropic",
             nolanModel: "claude-opus-5",

package/dist/core/nolan-prompt.js

@@ -44,7 +44,7 @@ export async function buildNolanSystemPrompt(cwd) {
     return [
         renderIdentity(),
         renderEdge(),
-        renderGGCoderCapabilities(),
+        renderEZCoderCapabilities(),
         renderSkeptical(),
         renderTaste(),
         renderMethod(),
@@ -73,7 +73,7 @@ export async function buildNolanSystemPrompt(cwd) {
 export async function buildNolanAutopilotSystemPrompt(cwd) {
     return [
         renderIdentity(),
-        renderGGCoderCapabilities(),
+        renderEZCoderCapabilities(),
         renderSkeptical(),
         renderTaste(),
         renderMethod(),
@@ -123,7 +123,7 @@ function renderEdge() {
         `directly for the same result, you added nothing. Be the strategy, the ` +
         `skeptic, or the better-shaped ask.`);
 }
-function renderGGCoderCapabilities() {
+function renderEZCoderCapabilities() {
     return (`## What EZ Coder can do\n\n` +
         `You direct EZ Coder, so you have to know its reach. It is a full coding agent ` +
         `with these tools, and your prompts should assume them instead of making the ` +
@@ -195,7 +195,7 @@ function renderTaste() {
 }
 function renderMethod() {
     return (`## Method\n\n` +
-        `Modular and sequential. One thing at a time, each step small enough that GG ` +
+        `Modular and sequential. One thing at a time, each step small enough that EZ ` +
         `Coder can nail it and you can both confirm it works before the next.\n\n` +
         `Kill the "one prompt that does everything" mega-request on sight. For a whole ` +
         `feature, break it into a sequence and hand over the first step only, then the ` +
@@ -324,7 +324,7 @@ function renderContextNote() {
     return (`## Your context\n\n` +
         `Each turn you get a digest: what they're building, the story so far, and the ` +
         `recent EZ Coder and user activity. Read it, then answer the actual question. If ` +
-        `the digest misses something, use your read-only tools to go look. You see GG ` +
+        `the digest misses something, use your read-only tools to go look. You see EZ ` +
         `Coder's conversation; it never sees yours. You steer, it builds.`);
 }
 //# sourceMappingURL=nolan-prompt.js.map

package/dist/core/oauth/xai.d.ts

@@ -0,0 +1,2 @@
+export { loginXai, refreshXaiToken, grokCliBaseUrl, grokCliHeaders, isGrokCliEndpoint, } from "@prestyj/core";
+//# sourceMappingURL=xai.d.ts.map

package/dist/core/oauth/xai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xai.d.ts","sourceRoot":"","sources":["../../../src/core/oauth/xai.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/core/oauth/xai.js

@@ -0,0 +1,4 @@
+// Lives in @prestyj/core — re-exported here so ezcoder call sites import
+// Grok OAuth the same way they import the other providers.
+export { loginXai, refreshXaiToken, grokCliBaseUrl, grokCliHeaders, isGrokCliEndpoint, } from "@prestyj/core";
+//# sourceMappingURL=xai.js.map

package/dist/core/oauth/xai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xai.js","sourceRoot":"","sources":["../../../src/core/oauth/xai.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2DAA2D;AAC3D,OAAO,EACL,QAAQ,EACR,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/core/persistent-shell.js

@@ -76,7 +76,7 @@ export class PersistentShell {
         }
         this.busy = true;
         const child = this.ensureChild();
-        const sentinel = `__GG_PSH_${randomUUID()}__`;
+        const sentinel = `__EZ_PSH_${randomUUID()}__`;
         // `</dev/null` keeps stdin-reading commands (cat, read) from eating the
         // next sentinel line instead of hanging the session.
         const wrapped = `{ ${command}\n} </dev/null; echo "${sentinel}$?"\n`;