hoi4-agent-tools 3.0.0 → 3.0.2

package/CHANGELOG.md

@@ -4,6 +4,18 @@
 
 No unreleased changes.
 
+## 3.0.2 - 2026-08-31
+
+- Render enlarged HOI4 bitmap glyphs as pre-scaled atlas masks so VPS and Linux output stays crisp instead of depending on platform SVG interpolation.
+- Apply bitmap-font face, border, and localisation colours with portable alpha masks instead of SVG colour-matrix filters that could be ignored by remote rasterizers.
+- Clarify that GUI `uiScale` represents the in-game layout scale and is not an artifact zoom control.
+
+## 3.0.1 - 2026-08-31
+
+- Render technology folders with the source GUI's actual small and regular item geometry, infer small items from equipment unlock behavior, and include horizontal or vertical year guides.
+- Restore the opt-in `chaosx.focus_country_assets` and `chaosx.visual_revision` tools with direct and stdio discovery coverage.
+- Infer unambiguous source-backed probability adapters for evaluate, sweep, simulation, and comparison calls, including calls that previously failed with `PROBABILITY_MANIFEST_REQUIRED` or `PROBABILITY_SURFACE_EMPTY` after a mismatched adapter selection.
+
 ## 3.0.0 - 2026-08-31
 
 - Promote the complete focus, GUI, map, event, technology, and probability MCP surface to the stable 3.0 release line after full synthetic, installed-game, external-workspace, transport, package, Inspector, and Registry qualification.

package/README.md

@@ -72,7 +72,7 @@ On non-Windows systems, use `hoi4-agent-tools` as the command. Agentic HOI4 repo
 | `hoi4.event_render`         | Render source-linked event routes, options, timing, state, scope, and unresolved edges.   |
 | `hoi4.event_compare`        | Compare event-chain topology and diagnostics between revisions.                           |
 | `hoi4.tech_inspect`         | Scan, trace, explain, lint, and assess technology and doctrine systems.                   |
-| `hoi4.tech_render`          | Render source layouts, dependency paths, unlocks, grants, metadata, and asset coverage.   |
+| `hoi4.tech_render`          | Render source layouts with real item sizes and year guides, plus dependencies and assets. |
 | `hoi4.tech_compare`         | Compare technology graphs, placements, references, diagnostics, and source overlays.      |
 | `hoi4.probability_inspect`  | Locate weighted logic and discover compatible adapters, candidates, and required inputs.  |
 | `hoi4.probability_evaluate` | Evaluate exact values, probabilities, timing, bounds, and unresolved inputs.              |
@@ -82,6 +82,8 @@ On non-Windows systems, use `hoi4-agent-tools` as the command. Agentic HOI4 repo
 | `hoi4.probability_compare`  | Attribute AI-weight and MTTH changes between real or proposed source.                     |
 | `hoi4.probability_render`   | Render cached rankings, matrices, timing, sensitivity, sequence, and comparisons.         |
 
+Set `HOI4_AGENT_TOOLS_CHAOSX=1` on the server process to expose the optional `chaosx.focus_country_assets` and `chaosx.visual_revision` tools used by ChaosX workflows. They remain absent from the default public tool list.
+
 Large outputs are linked `hoi4-agent://` resources. For resources over 1 MiB, follow the `continuationUri` returned in `_meta` until it is `null`; clients may also request byte ranges with `?offset=<bytes>&length=<bytes>`.
 
 ## Coexistence with agent workflows

package/dist/bin/stdio.js

@@ -8,6 +8,10 @@ async function main() {
     const engine = await createEngine();
     const context = {};
     const server = createMcpServer(engine, context);
+    if (process.env.HOI4_AGENT_TOOLS_CHAOSX === '1') {
+        const { registerChaosxTools } = await import('../hoi4_agent_tools/mcp/tools/chaosx.js');
+        registerChaosxTools(server, engine, context);
+    }
     server.server.onerror = (error) => {
         const fatalInputError = error instanceof StdioFrameLimitError || error instanceof StdioInvalidUtf8Error;
         const rejectedMessage = error instanceof StdioInvalidMessageError;

package/dist/hoi4_agent_tools/core/domain-scan-patterns.js

@@ -58,6 +58,18 @@ export function probabilityDomainScanPatterns(workspace, sourcePaths = []) {
         'events/**/*.txt',
     ]);
 }
+/** Text sources needed to discover country flags and leader portraits. */
+export function countryAssetDiscoveryPatterns(workspace) {
+    const roots = workspace.registration.roots;
+    return uniquePatterns([
+        'history/countries/**/*.txt',
+        'common/characters/**/*.txt',
+        'common/scripted_effects/**/*.txt',
+        'events/**/*.txt',
+        ...under(roots.interface, '**/*.gfx'),
+        ...under(roots.gfx, '**/*.gfx'),
+    ]);
+}
 export function exactChangedFilePatterns(relativePaths) {
     return uniquePatterns(relativePaths.map((relativePath) => relativePath.replaceAll('\\', '/').replace(/^\.\//u, '')));
 }

package/dist/hoi4_agent_tools/gui/assets.js

@@ -664,7 +664,7 @@ export class GuiAssetCatalog {
                 const pageFile = this.resolveBmFontPage(entry, pagePath ?? '', metric.page);
                 const raster = pageFile === undefined
                     ? undefined
-                    : await this.loadBmFontGlyph(entry, pageFile, metric, codePoint);
+                    : await this.loadBmFontGlyph(entry, pageFile, metric, codePoint, scale);
                 if (raster !== undefined && pageFile !== undefined) {
                     pageHashes.add(pageFile.sha256);
                     glyphs.push({
@@ -674,8 +674,8 @@ export class GuiAssetCatalog {
                         ...(raster.borderDataUri === undefined ? {} : { borderDataUri: raster.borderDataUri }),
                         x: penX + metric.xOffset * scale,
                         y: metric.yOffset * scale,
-                        width: raster.width * scale,
-                        height: raster.height * scale,
+                        width: raster.width * (scale > 1 ? 1 : scale),
+                        height: raster.height * (scale > 1 ? 1 : scale),
                     });
                 }
                 else if (metric.width > 0 &&
@@ -782,10 +782,13 @@ export class GuiAssetCatalog {
         this.metrics.set(key, null);
         return undefined;
     }
-    loadBmFontGlyph(entry, pageFile, metric, codePoint) {
+    loadBmFontGlyph(entry, pageFile, metric, codePoint, scale) {
         if (metric.width <= 0 || metric.height <= 0)
             return Promise.resolve(undefined);
-        const key = `${entry.sourceFile.sha256}:${pageFile.sha256}:${codePoint}:${metric.x}:${metric.y}:${metric.width}:${metric.height}`;
+        const rasterScale = scale > 1 ? scale : 1;
+        const targetWidth = Math.max(1, Math.round(metric.width * rasterScale));
+        const targetHeight = Math.max(1, Math.round(metric.height * rasterScale));
+        const key = `${entry.sourceFile.sha256}:${pageFile.sha256}:${codePoint}:${metric.x}:${metric.y}:${metric.width}:${metric.height}:${targetWidth}:${targetHeight}`;
         let promise = this.glyphRasters.get(key);
         if (promise === undefined) {
             promise = (async () => {
@@ -799,7 +802,7 @@ export class GuiAssetCatalog {
                     metric.y + metric.height > raster.height)
                     return undefined;
                 this.budget.reserveRasterOperation(`gui-bmfont-glyph:${key}`, `GUI BMFont glyph rasterization U+${codePoint.toString(16).toUpperCase()}`);
-                this.budget.reserve(metric.width, metric.height, `GUI BMFont glyph U+${codePoint.toString(16).toUpperCase()}`, { maximumPixels: RENDER_MAX_DECODED_PIXELS });
+                this.budget.reserve(targetWidth, targetHeight, `GUI BMFont glyph U+${codePoint.toString(16).toUpperCase()}`, { maximumPixels: RENDER_MAX_DECODED_PIXELS });
                 const extracted = await sharp(raster.data, {
                     raw: { width: raster.width, height: raster.height, channels: 4 },
                     limitInputPixels: RENDER_MAX_DECODED_PIXELS,
@@ -919,12 +922,21 @@ export class GuiAssetCatalog {
                         }
                     }
                 }
-                const encodeMask = (pixels) => sharp(pixels, {
-                    raw: { width: extracted.info.width, height: extracted.info.height, channels: 4 },
-                    limitInputPixels: RENDER_MAX_DECODED_PIXELS,
-                })
-                    .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
-                    .toBuffer();
+                const encodeMask = (pixels) => {
+                    let pipeline = sharp(pixels, {
+                        raw: { width: extracted.info.width, height: extracted.info.height, channels: 4 },
+                        limitInputPixels: RENDER_MAX_DECODED_PIXELS,
+                    });
+                    if (targetWidth !== extracted.info.width || targetHeight !== extracted.info.height) {
+                        pipeline = pipeline.resize(targetWidth, targetHeight, {
+                            fit: 'fill',
+                            kernel: scale >= 1 ? sharp.kernel.nearest : sharp.kernel.lanczos3,
+                        });
+                    }
+                    return pipeline
+                        .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false })
+                        .toBuffer();
+                };
                 const png = await encodeMask(facePixels);
                 const borderPng = borderPixels === undefined ? undefined : await encodeMask(borderPixels);
                 return {
@@ -932,8 +944,8 @@ export class GuiAssetCatalog {
                     ...(borderPng === undefined
                         ? {}
                         : { borderDataUri: `data:image/png;base64,${borderPng.toString('base64')}` }),
-                    width: metric.width,
-                    height: metric.height,
+                    width: targetWidth,
+                    height: targetHeight,
                 };
             })();
             this.glyphRasters.set(key, promise);

package/dist/hoi4_agent_tools/gui/renderer.js

@@ -60,22 +60,15 @@ function sceneGlyphDefinitions(scene) {
             .map(([key, glyphPath]) => `<path id="${outlineDefinitionId(key)}" d="${glyphPath}"/>`),
         ...[...bitmaps.entries()]
             .sort(([left], [right]) => compareCodeUnits(left, right))
-            .map(([key, glyph]) => `<image id="${bitmapDefinitionId(key)}" width="${finite(glyph.width)}" height="${finite(glyph.height)}" href="${glyph.dataUri}" preserveAspectRatio="none" image-rendering="optimizeSpeed"/>${glyph.borderDataUri === undefined ? '' : `<image id="${bitmapDefinitionId(key, 'border')}" width="${finite(glyph.width)}" height="${finite(glyph.height)}" href="${glyph.borderDataUri}" preserveAspectRatio="none" image-rendering="optimizeSpeed"/>`}`),
+            .map(([key, glyph]) => `<image id="${bitmapDefinitionId(key)}" width="${finite(glyph.width)}" height="${finite(glyph.height)}" href="${glyph.dataUri}" preserveAspectRatio="none" image-rendering="optimizeSpeed" style="image-rendering:pixelated"/>${glyph.borderDataUri === undefined ? '' : `<image id="${bitmapDefinitionId(key, 'border')}" width="${finite(glyph.width)}" height="${finite(glyph.height)}" href="${glyph.borderDataUri}" preserveAspectRatio="none" image-rendering="optimizeSpeed" style="image-rendering:pixelated"/>`}`),
     ].join('');
 }
 function bitmapTintMarkup(id, colour, glyphs, rect) {
     const match = /^#([0-9a-f]{6})([0-9a-f]{2})?$/iu.exec(colour);
     const rgb = match?.[1] ?? 'ffffff';
     const alpha = match?.[2] ?? 'ff';
-    const channels = [
-        Number.parseInt(rgb.slice(0, 2), 16) / 255,
-        Number.parseInt(rgb.slice(2, 4), 16) / 255,
-        Number.parseInt(rgb.slice(4, 6), 16) / 255,
-        Number.parseInt(alpha, 16) / 255,
-    ].map(finite);
-    const [red, green, blue, opacity] = channels;
-    const matrix = `${red} 0 0 0 0 0 ${green} 0 0 0 0 0 ${blue} 0 0 0 0 0 ${opacity} 0`;
-    return `<defs><filter id="${id}" filterUnits="userSpaceOnUse" ${rectAttributes(rect)} color-interpolation-filters="sRGB"><feColorMatrix type="matrix" values="${matrix}"/></filter></defs><g filter="url(#${id})">${glyphs}</g>`;
+    const opacity = finite(Number.parseInt(alpha, 16) / 255);
+    return `<defs><mask id="${id}" maskUnits="userSpaceOnUse" maskContentUnits="userSpaceOnUse" ${rectAttributes(rect)} style="mask-type:alpha"><g>${glyphs}</g></mask></defs><rect ${rectAttributes(rect)} fill="#${rgb}"${opacity >= 1 ? '' : ` fill-opacity="${opacity}"`} mask="url(#${id})"/>`;
 }
 function actualGlyphMarkup(glyphLine, originX, baseline, horizontalScale, bitmapLayer = 'face') {
     if (glyphLine.source === 'fontkit-path')
@@ -92,7 +85,7 @@ function actualGlyphMarkup(glyphLine, originX, baseline, horizontalScale, bitmap
                 [glyph.x, glyph.y, glyph.width, glyph.height, glyphLine.baseline].every((value) => Math.abs(value - Math.round(value)) < 0.000_001);
             const x = originX + glyph.x * horizontalScale;
             const y = baseline + glyph.y - glyphLine.baseline;
-            return `<use href="#${bitmapDefinitionId(glyph.key, bitmapLayer)}" transform="translate(${finite(nativePixelGrid ? Math.round(x) : x)} ${finite(nativePixelGrid ? Math.round(y) : y)}) scale(${finite(horizontalScale)} 1)"/>`;
+            return `<use href="#${bitmapDefinitionId(glyph.key, bitmapLayer)}" transform="translate(${finite(nativePixelGrid ? Math.round(x) : x)} ${finite(nativePixelGrid ? Math.round(y) : y)}) scale(${finite(horizontalScale)} 1)" image-rendering="optimizeSpeed" style="image-rendering:pixelated"/>`;
         })
             .join('');
     return '';

package/dist/hoi4_agent_tools/gui/scenario.js

@@ -104,7 +104,13 @@ const GuiPreviewScenarioBodySchema = z
         .regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/u),
     description: z.string().max(500).optional(),
     resolution: GuiPreviewResolutionSchema.default({ width: 1920, height: 1080 }),
-    uiScale: z.number().positive().min(0.25).max(4).default(1),
+    uiScale: z
+        .number()
+        .positive()
+        .min(0.25)
+        .max(4)
+        .default(1)
+        .describe('In-game UI scale. Use 1 for the normal 1920x1080 layout; this changes layout geometry and is not an output-image zoom.'),
     state: previewStateSchema.default('normal'),
     language: z
         .string()