npm - hoi4-agent-tools - Versions diffs - 2.5.1 → 2.5.3 - Mend

hoi4-agent-tools 2.5.1 → 2.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (44) hide show

package/CHANGELOG.md +18 -0
package/dist/hoi4_agent_tools/core/index.js +22 -6
package/dist/hoi4_agent_tools/focus/compact.js +103 -12
package/dist/hoi4_agent_tools/focus/continuous-render.js +4 -10
package/dist/hoi4_agent_tools/focus/layout.js +15 -7
package/dist/hoi4_agent_tools/focus/render.js +2 -8
package/dist/hoi4_agent_tools/gui/dds.js +5 -2
package/dist/hoi4_agent_tools/gui/layout.js +1 -1
package/dist/hoi4_agent_tools/gui/renderer.js +4 -16
package/dist/hoi4_agent_tools/gui/source-graph.js +9 -8
package/dist/hoi4_agent_tools/gui/studio.js +58 -4
package/dist/hoi4_agent_tools/map/render.js +1 -1
package/dist/hoi4_agent_tools/mcp/transports/http.js +4 -5
package/dist/hoi4_agent_tools/mcp/transports/protocol-gate.js +7 -7
package/dist/hoi4_agent_tools/technology/compare.js +1 -0
package/dist/hoi4_agent_tools/technology/render.js +96 -34
package/dist/hoi4_agent_tools/technology/service.js +67 -3
package/dist/hoi4_agent_tools/technology/source-analysis.js +19 -1
package/dist/hoi4_agent_tools/version.js +1 -1
package/docs/focus.md +1 -1
package/docs/gui.md +2 -0
package/docs/technology.md +1 -1
package/package.json +3 -2
package/schemas/configuration.schema.json +1 -1
package/schemas/continuous-focus-palette.schema.json +1 -1
package/schemas/custom-weighted-pool.schema.json +1 -1
package/schemas/event-feature-manifest.schema.json +1 -1
package/schemas/focus-plan.schema.json +1 -1
package/schemas/focus-planning-sidecar.schema.json +1 -1
package/schemas/gui-animation-source.schema.json +1 -1
package/schemas/gui-helper.schema.json +1 -1
package/schemas/gui-scenario.schema.json +1 -1
package/schemas/map-operation.schema.json +1 -1
package/schemas/operation-result.schema.json +1 -1
package/schemas/probability-analysis-result.schema.json +1 -1
package/schemas/probability-compare-input.schema.json +1 -1
package/schemas/probability-evaluate-input.schema.json +1 -1
package/schemas/probability-inspect-input.schema.json +1 -1
package/schemas/probability-render-input.schema.json +1 -1
package/schemas/probability-scenario-set.schema.json +1 -1
package/schemas/probability-sequence-input.schema.json +1 -1
package/schemas/probability-simulate-input.schema.json +1 -1
package/schemas/probability-sweep-input.schema.json +1 -1
package/server.json +2 -2

package/dist/hoi4_agent_tools/map/render.js CHANGED Viewed

@@ -433,7 +433,7 @@ function htmlDocument(title, png, json) {
         .replaceAll('<', '&lt;')
         .replaceAll('>', '&gt;');
     const escapedJson = json.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
-    return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapedTitle}</title><style>html{background:#10151b;color:#edf2f7;font:14px system-ui}body{margin:20px}.controls{display:flex;gap:8px;align-items:center;margin:12px 0}button{background:#263241;color:#edf2f7;border:1px solid #526173;border-radius:4px;padding:6px 10px}.viewport{height:70vh;overflow:hidden;border:1px solid #48515c;background:#080b0f;position:relative;touch-action:none}.viewport img{image-rendering:pixelated;transform-origin:0 0;position:absolute;max-width:none;cursor:grab;user-select:none}.viewport img.dragging{cursor:grabbing}pre{white-space:pre-wrap;overflow-wrap:anywhere}</style></head><body><h1>${escapedTitle}</h1><p>Offline deterministic map representation; not an in-game screenshot or source editor.</p><div class="controls"><button id="out" type="button">-</button><button id="reset" type="button">Reset</button><button id="in" type="button">+</button><output id="zoom">100%</output></div><div class="viewport" id="viewport"><img id="map" draggable="false" alt="${escapedTitle}" src="data:image/png;base64,${png.toString('base64')}"></div><details><summary>Render metadata</summary><pre>${escapedJson}</pre></details><script>(()=>{const image=document.getElementById('map'),viewport=document.getElementById('viewport'),label=document.getElementById('zoom');let scale=1,x=0,y=0,drag=false,lastX=0,lastY=0;const draw=()=>{image.style.transform='translate('+x+'px,'+y+'px) scale('+scale+')';label.value=Math.round(scale*100)+'%'};const zoom=(factor,cx=viewport.clientWidth/2,cy=viewport.clientHeight/2)=>{const next=Math.min(16,Math.max(.1,scale*factor));x=cx-(cx-x)*(next/scale);y=cy-(cy-y)*(next/scale);scale=next;draw()};document.getElementById('in').onclick=()=>zoom(1.25);document.getElementById('out').onclick=()=>zoom(.8);document.getElementById('reset').onclick=()=>{scale=1;x=0;y=0;draw()};viewport.addEventListener('wheel',event=>{event.preventDefault();const bounds=viewport.getBoundingClientRect();zoom(event.deltaY<0?1.15:.87,event.clientX-bounds.left,event.clientY-bounds.top)},{passive:false});image.addEventListener('pointerdown',event=>{drag=true;lastX=event.clientX;lastY=event.clientY;image.setPointerCapture(event.pointerId);image.classList.add('dragging')});image.addEventListener('pointermove',event=>{if(!drag)return;x+=event.clientX-lastX;y+=event.clientY-lastY;lastX=event.clientX;lastY=event.clientY;draw()});image.addEventListener('pointerup',()=>{drag=false;image.classList.remove('dragging')});draw()})();</script></body></html>`;
+    return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapedTitle}</title><style>html{background:#10151b;color:#edf2f7;font:14px system-ui}body{margin:20px}.controls{display:flex;gap:8px;align-items:center;margin:12px 0}button{background:#263241;color:#edf2f7;border:1px solid #526173;border-radius:4px;padding:6px 10px}.viewport{height:70vh;overflow:hidden;border:1px solid #48515c;background:#080b0f;position:relative;touch-action:none}.viewport img{image-rendering:pixelated;transform-origin:0 0;position:absolute;max-width:none;cursor:grab;user-select:none}.viewport img.dragging{cursor:grabbing}pre{white-space:pre-wrap;overflow-wrap:anywhere}</style></head><body><h1>${escapedTitle}</h1><div class="controls"><button id="out" type="button">-</button><button id="reset" type="button">Reset</button><button id="in" type="button">+</button><output id="zoom">100%</output></div><div class="viewport" id="viewport"><img id="map" draggable="false" alt="${escapedTitle}" src="data:image/png;base64,${png.toString('base64')}"></div><details><summary>Render metadata</summary><pre>${escapedJson}</pre></details><script>(()=>{const image=document.getElementById('map'),viewport=document.getElementById('viewport'),label=document.getElementById('zoom');let scale=1,x=0,y=0,drag=false,lastX=0,lastY=0;const draw=()=>{image.style.transform='translate('+x+'px,'+y+'px) scale('+scale+')';label.value=Math.round(scale*100)+'%'};const zoom=(factor,cx=viewport.clientWidth/2,cy=viewport.clientHeight/2)=>{const next=Math.min(16,Math.max(.1,scale*factor));x=cx-(cx-x)*(next/scale);y=cy-(cy-y)*(next/scale);scale=next;draw()};document.getElementById('in').onclick=()=>zoom(1.25);document.getElementById('out').onclick=()=>zoom(.8);document.getElementById('reset').onclick=()=>{scale=1;x=0;y=0;draw()};viewport.addEventListener('wheel',event=>{event.preventDefault();const bounds=viewport.getBoundingClientRect();zoom(event.deltaY<0?1.15:.87,event.clientX-bounds.left,event.clientY-bounds.top)},{passive:false});image.addEventListener('pointerdown',event=>{drag=true;lastX=event.clientX;lastY=event.clientY;image.setPointerCapture(event.pointerId);image.classList.add('dragging')});image.addEventListener('pointermove',event=>{if(!drag)return;x+=event.clientX-lastX;y+=event.clientY-lastY;lastX=event.clientX;lastY=event.clientY;draw()});image.addEventListener('pointerup',()=>{drag=false;image.classList.remove('dragging')});draw()})();</script></body></html>`;
 }
 async function encodePng(raw, width, height, scale) {
     assertRenderDimensions(width, height, 'map Sharp source raster');

package/dist/hoi4_agent_tools/mcp/transports/http.js CHANGED Viewed

@@ -4,9 +4,8 @@ import { TextDecoder } from 'node:util';
 import express, {} from 'express';
 import { hostHeaderValidation } from '@modelcontextprotocol/sdk/server/middleware/hostHeaderValidation.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { isInitializeRequest, SUPPORTED_PROTOCOL_VERSIONS, } from '@modelcontextprotocol/sdk/types.js';
 import { canonicalJson } from '../../core/canonical.js';
-import { MCP_PROTOCOL_VERSION } from '../../version.js';
 import { authenticate, bearerChallenge, HttpAuthError, protectedResourceMetadata, validateHttpDeployment, } from '../security/auth.js';
 import { BoundedEventStore, SharedEventStoreBudget } from './event-store.js';
 import { FinalProtocolTransport } from './protocol-gate.js';
@@ -296,15 +295,15 @@ function requireParsedMcpJsonBody(request, response, next) {
 }
 function rejectInvalidProtocolHeader(request, response, required) {
     const value = request.headers['mcp-protocol-version'];
-    if (value === MCP_PROTOCOL_VERSION)
+    if (typeof value === 'string' && SUPPORTED_PROTOCOL_VERSIONS.includes(value))
         return false;
     if (value === undefined && !required)
         return false;
     if (value === undefined) {
-        jsonRpcError(response, 400, `Missing MCP-Protocol-Version header; this server requires ${MCP_PROTOCOL_VERSION}`);
+        jsonRpcError(response, 400, `Missing MCP-Protocol-Version header; this server supports ${SUPPORTED_PROTOCOL_VERSIONS.join(', ')}`);
         return true;
     }
-    jsonRpcError(response, 400, `Unsupported MCP protocol version; this server requires ${MCP_PROTOCOL_VERSION}`);
+    jsonRpcError(response, 400, `Unsupported MCP protocol version; this server supports ${SUPPORTED_PROTOCOL_VERSIONS.join(', ')}`);
     return true;
 }
 function sendAuthError(response, configuration, error) {

package/dist/hoi4_agent_tools/mcp/transports/protocol-gate.js CHANGED Viewed

@@ -1,19 +1,19 @@
-import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
-import { MCP_PROTOCOL_VERSION } from '../../version.js';
+import { isInitializeRequest, SUPPORTED_PROTOCOL_VERSIONS, } from '@modelcontextprotocol/sdk/types.js';
 const unsupportedVersionSentinel = 'hoi4-agent-tools-final-only';
 function gateInitializeVersion(message) {
-    if (!isInitializeRequest(message) || message.params.protocolVersion === MCP_PROTOCOL_VERSION) {
+    if (!isInitializeRequest(message) ||
+        SUPPORTED_PROTOCOL_VERSIONS.includes(message.params.protocolVersion)) {
         return message;
     }
-    // SDK v1 negotiates every historical revision it knows. This server uses current-final
-    // resource-link and structured-output semantics, so force the SDK's documented fallback
-    // response to the sole production revision instead of claiming unimplemented feature gates.
+    // Unknown revisions cannot be negotiated. Rewrite them to an unsupported sentinel so the
+    // SDK applies its documented fallback response (the latest supported revision) instead of
+    // claiming unimplemented feature gates.
     return {
         ...message,
         params: { ...message.params, protocolVersion: unsupportedVersionSentinel },
     };
 }
-/** Restrict a concrete product transport to the documented final MCP revision. */
+/** Let the SDK negotiate any revision it supports and fall back to the latest for unknown ones. */
 export class FinalProtocolTransport {
     inner;
     onclose = () => undefined;

package/dist/hoi4_agent_tools/technology/compare.js CHANGED Viewed

@@ -92,6 +92,7 @@ function technologyMetadata(technology) {
         researchCost: technology.researchCost ?? null,
         doctrineName: technology.doctrineName ?? null,
         hidden: technology.hidden,
+        layoutSize: technology.layoutSize,
         folders: technology.folders,
         categories: technology.categories,
         tags: technology.tags,

package/dist/hoi4_agent_tools/technology/render.js CHANGED Viewed

@@ -5,8 +5,10 @@ import { ServiceError } from '../core/result.js';
 import { DeterministicSvgTextRenderer } from '../core/svg-text.js';
 import { traceTechnology } from './queries.js';
 const MAX_RENDER_NODES = 2_000;
-const NODE_WIDTH = 210;
-const NODE_HEIGHT = 76;
+const LARGE_NODE_WIDTH = 183;
+const LARGE_NODE_HEIGHT = 84;
+const SMALL_NODE_WIDTH = 72;
+const SMALL_NODE_HEIGHT = 72;
 const GAP_X = 42;
 const GAP_Y = 42;
 const GENERATED_NODE_WIDTH = 180;
@@ -44,6 +46,8 @@ function technologyNode(graph, technologyId, placement) {
         kind: technology.kind,
         sourcePath: technology.source.path,
         sourceLine: technology.source.location.start.line,
+        layoutSize: technology.layoutSize,
+        iconSprite: technology.icon.sprite,
         ...(placement === undefined ? {} : { placement }),
     };
 }
@@ -149,6 +153,7 @@ function viewSelection(graph, options) {
                 kind: 'doctrine',
                 sourcePath: definition.source.path,
                 sourceLine: definition.source.location.start.line,
+                ...(definition.icon === undefined ? {} : { iconSprite: definition.icon.sprite }),
             });
         for (const definition of graph.doctrineDefinitions) {
             const from = `doctrine:${definition.kind}:${definition.id}`;
@@ -200,6 +205,7 @@ function viewSelection(graph, options) {
                 kind: 'doctrine',
                 sourcePath: doctrine.source.path,
                 sourceLine: doctrine.source.location.start.line,
+                ...(doctrine.icon === undefined ? {} : { iconSprite: doctrine.icon.sprite }),
             });
             for (const targetId of doctrine.exclusiveIds) {
                 const target = graph.doctrineDefinitions.find(({ id }) => id === targetId);
@@ -212,7 +218,11 @@ function viewSelection(graph, options) {
                         kind: target === undefined ? 'unresolved' : 'doctrine',
                         ...(target === undefined
                             ? {}
-                            : { sourcePath: target.source.path, sourceLine: target.source.location.start.line }),
+                            : {
+                                sourcePath: target.source.path,
+                                sourceLine: target.source.location.start.line,
+                                ...(target.icon === undefined ? {} : { iconSprite: target.icon.sprite }),
+                            }),
                     });
                 edges.push({ id: `${from}:xor:${to}`, from, to, kind: 'exclusive' });
             }
@@ -415,17 +425,22 @@ function issueKey(issue) {
     return sha256Bytes(canonicalJson({ code: issue.code, details: issue.details })).slice(0, 20);
 }
 function layoutFolder(nodes) {
+    const dimensions = (node) => node.layoutSize === 'small'
+        ? { width: SMALL_NODE_WIDTH, height: SMALL_NODE_HEIGHT }
+        : { width: LARGE_NODE_WIDTH, height: LARGE_NODE_HEIGHT };
     const sourcePixel = nodes.filter(({ placement }) => placement?.pixelX !== undefined && placement.pixelY !== undefined);
     if (sourcePixel.length === nodes.length && sourcePixel.length > 0) {
         const minimumX = Math.min(...sourcePixel.map(({ placement }) => placement.pixelX));
         const minimumY = Math.min(...sourcePixel.map(({ placement }) => placement.pixelY));
-        return sourcePixel.map((node) => ({
-            ...node,
-            x: PADDING + node.placement.pixelX - minimumX,
-            y: HEADER_HEIGHT + PADDING + node.placement.pixelY - minimumY,
-            width: NODE_WIDTH,
-            height: NODE_HEIGHT,
-        }));
+        return sourcePixel.map((node) => {
+            const size = dimensions(node);
+            return {
+                ...node,
+                x: PADDING + node.placement.pixelX - minimumX,
+                y: HEADER_HEIGHT + PADDING + node.placement.pixelY - minimumY,
+                ...size,
+            };
+        });
     }
     const branchRoots = [
         ...new Set(nodes.map(({ placement }) => placement?.branchRootId ?? '<unresolved>')),
@@ -434,9 +449,12 @@ function layoutFolder(nodes) {
     return nodes.map((node, index) => {
         const placement = node.placement;
         const lane = lanes.get(placement?.branchRootId ?? '<unresolved>') ?? 0;
-        const x = PADDING + lane * 680 + (placement?.x ?? index % 3) * (NODE_WIDTH + GAP_X);
-        const y = HEADER_HEIGHT + PADDING + (placement?.y ?? Math.floor(index / 3)) * (NODE_HEIGHT + GAP_Y);
-        return { ...node, x, y, width: NODE_WIDTH, height: NODE_HEIGHT };
+        const size = dimensions(node);
+        const x = PADDING + lane * 680 + (placement?.x ?? index % 3) * (LARGE_NODE_WIDTH + GAP_X);
+        const y = HEADER_HEIGHT +
+            PADDING +
+            (placement?.y ?? Math.floor(index / 3)) * (LARGE_NODE_HEIGHT + GAP_Y);
+        return { ...node, x, y, ...size };
     });
 }
 function layoutGenerated(nodes, edges) {
@@ -526,9 +544,9 @@ function colours(kind) {
         removed: { fill: '#4a2828', stroke: '#ef7d7d' },
     }[kind];
 }
-function svgFor(titleText, positioned, edges, sourceAccurate) {
-    const maximumX = Math.max(PADDING + NODE_WIDTH, ...positioned.map(({ x, width }) => x + width));
-    const maximumY = Math.max(HEADER_HEIGHT + NODE_HEIGHT, ...positioned.map(({ y, height }) => y + height));
+function svgFor(titleText, positioned, edges, sourceAccurate, iconDataUris) {
+    const maximumX = Math.max(PADDING + LARGE_NODE_WIDTH, ...positioned.map(({ x, width }) => x + width));
+    const maximumY = Math.max(HEADER_HEIGHT + LARGE_NODE_HEIGHT, ...positioned.map(({ y, height }) => y + height));
     const width = Math.ceil(maximumX + PADDING);
     const height = Math.ceil(maximumY + PADDING);
     if (width > 16_384 || height > 16_384 || width * height > RENDER_MAX_PIXELS)
@@ -554,24 +572,46 @@ function svgFor(titleText, positioned, edges, sourceAccurate) {
     });
     const nodeSvg = positioned.map((node) => {
         const colour = colours(node.kind);
-        const label = node.label.length > 34 ? `${node.label.slice(0, 31)}…` : node.label;
+        const small = node.layoutSize === 'small';
+        const iconDataUri = node.iconSprite === undefined ? undefined : iconDataUris[node.iconSprite];
+        const compactIcon = iconDataUri !== undefined && small && node.width <= SMALL_NODE_WIDTH;
+        const iconSize = iconDataUri === undefined
+            ? 0
+            : compactIcon
+                ? Math.max(1, Math.min(node.width - 12, node.height - 12))
+                : Math.max(1, Math.min(64, node.height - 16, Math.floor(node.width * 0.36)));
+        const textInset = iconDataUri === undefined ? (small ? 6 : 12) : iconSize + 18;
+        const availableTextWidth = Math.max(1, node.width - textInset - (small ? 6 : 12));
+        const labelLimit = small ? 12 : 34;
+        const label = node.label.length > labelLimit
+            ? `${node.label.slice(0, Math.max(1, labelLimit - 1))}…`
+            : node.label;
         const subtitle = node.subtitle.length > 48 ? `${node.subtitle.slice(0, 45)}…` : node.subtitle;
-        const labelSvg = text.render(label, {
-            x: node.x + 12,
-            y: node.y + 30,
-            fontSize: 15,
-            fill: '#f1f5f8',
-            weight: 600,
-            targetWidth: Math.min(node.width - 24, Math.max(1, text.measure(label, 15))),
-        });
-        const subtitleSvg = text.render(subtitle, {
-            x: node.x + 12,
-            y: node.y + 56,
-            fontSize: 11,
-            fill: '#b8c4ce',
-            targetWidth: Math.min(node.width - 24, Math.max(1, text.measure(subtitle, 11))),
-        });
-        return `<g data-node-id="${escapeXml(node.id)}"${node.sourcePath === undefined ? '' : ` data-source-path="${escapeXml(node.sourcePath)}" data-source-line="${node.sourceLine ?? 1}"`}><rect x="${node.x}" y="${node.y}" width="${node.width}" height="${node.height}" rx="8" fill="${colour.fill}" stroke="${colour.stroke}" stroke-width="2"/><title>${escapeXml(`${node.id}${node.sourcePath === undefined ? '' : ` · ${node.sourcePath}:${node.sourceLine ?? 1}`}`)}</title>${labelSvg}${subtitleSvg}</g>`;
+        const labelSvg = compactIcon
+            ? ''
+            : text.render(label, {
+                x: node.x + textInset,
+                y: node.y + (small ? 27 : 30),
+                fontSize: small ? 9 : 15,
+                fill: '#f1f5f8',
+                weight: 600,
+                targetWidth: Math.min(availableTextWidth, Math.max(1, text.measure(label, small ? 9 : 15))),
+            });
+        const subtitleSvg = compactIcon
+            ? ''
+            : text.render(small ? 'SMALL' : subtitle, {
+                x: node.x + textInset,
+                y: node.y + (small ? 51 : 58),
+                fontSize: small ? 8 : 11,
+                fill: '#b8c4ce',
+                targetWidth: Math.min(availableTextWidth, Math.max(1, text.measure(small ? 'SMALL' : subtitle, small ? 8 : 11))),
+            });
+        const iconSvg = iconDataUri === undefined
+            ? ''
+            : `<image href="${escapeXml(iconDataUri)}" x="${node.x + (compactIcon ? 6 : 8)}" y="${node.y + (node.height - iconSize) / 2}" width="${iconSize}" height="${iconSize}" preserveAspectRatio="xMidYMid meet"/>`;
+        const layoutAttribute = node.layoutSize === undefined ? '' : ` data-layout-size="${node.layoutSize}"`;
+        const iconAttribute = node.iconSprite === undefined ? '' : ` data-icon-sprite="${escapeXml(node.iconSprite)}"`;
+        return `<g data-node-id="${escapeXml(node.id)}"${layoutAttribute}${iconAttribute}${node.sourcePath === undefined ? '' : ` data-source-path="${escapeXml(node.sourcePath)}" data-source-line="${node.sourceLine ?? 1}"`}><rect x="${node.x}" y="${node.y}" width="${node.width}" height="${node.height}" rx="8" fill="${colour.fill}" stroke="${colour.stroke}" stroke-width="2"/><title>${escapeXml(`${node.id}${node.layoutSize === undefined ? '' : ` · ${node.layoutSize} layout`}${node.sourcePath === undefined ? '' : ` · ${node.sourcePath}:${node.sourceLine ?? 1}`}`)}</title>${iconSvg}${labelSvg}${subtitleSvg}</g>`;
     });
     const title = text.render(titleText, {
         x: PADDING,
@@ -600,7 +640,13 @@ export async function renderTechnologyGraph(graph, options) {
     const positioned = selection.sourceAccurate
         ? layoutFolder(retained)
         : layoutGenerated(retained, edges);
-    const rendered = svgFor(selection.title, positioned, edges, selection.sourceAccurate);
+    const iconDataUris = options.iconDataUris ?? {};
+    const requestedIconSprites = [
+        ...new Set(retained.flatMap(({ iconSprite }) => (iconSprite === undefined ? [] : [iconSprite]))),
+    ].sort(compareCodeUnits);
+    const renderedIconSprites = requestedIconSprites.filter((sprite) => iconDataUris[sprite] !== undefined);
+    const unresolvedIconSprites = requestedIconSprites.filter((sprite) => iconDataUris[sprite] === undefined);
+    const rendered = svgFor(selection.title, positioned, edges, selection.sourceAccurate, iconDataUris);
     const budget = options.budget ?? new RenderBudget();
     budget.reserve(rendered.width, rendered.height, `technology ${options.view} render`);
     budget.reserveRasterOperation(`technology-render:${graph.revision}:${options.view}:${sha256Bytes(rendered.svg)}`, `technology ${options.view} rasterization`);
@@ -615,6 +661,11 @@ export async function renderTechnologyGraph(graph, options) {
         nodes: retained,
         edges,
         omittedNodeCount: Math.max(0, selection.nodes.length - retained.length),
+        iconCoverage: {
+            requested: requestedIconSprites.length,
+            rendered: renderedIconSprites.length,
+            unresolvedSprites: unresolvedIconSprites,
+        },
         render: { width: rendered.width, height: rendered.height },
     })}\n`;
     const html = options.includeHtml === true ? htmlFor(selection.title, rendered.svg, json) : undefined;
@@ -623,6 +674,8 @@ export async function renderTechnologyGraph(graph, options) {
         graphRevision: graph.revision,
         selectedIds: retained.map(({ id }) => id),
         omittedNodeCount: Math.max(0, selection.nodes.length - retained.length),
+        renderedIconCount: renderedIconSprites.length,
+        unresolvedIconSprites,
         sourceAccurate: selection.sourceAccurate,
         generatedAnalysisLayout: !selection.sourceAccurate,
         width: rendered.width,
@@ -639,3 +692,12 @@ export async function renderTechnologyGraph(graph, options) {
         },
     };
 }
+/** Return only the sprite names that the bounded render selection will display. */
+export function technologyRenderIconSprites(graph, options) {
+    const maximum = Math.max(1, Math.min(options.maxNodes ?? 600, MAX_RENDER_NODES));
+    return [
+        ...new Set(viewSelection(graph, options)
+            .nodes.slice(0, maximum)
+            .flatMap(({ iconSprite }) => (iconSprite === undefined ? [] : [iconSprite]))),
+    ].sort(compareCodeUnits);
+}

package/dist/hoi4_agent_tools/technology/service.js CHANGED Viewed

@@ -6,10 +6,12 @@ import { ServiceError } from '../core/result.js';
 import { SOURCE_MAX_BYTES } from '../core/source/index.js';
 import { isPortablePathSegment } from '../core/workspace.js';
 import { PACKAGE_VERSION } from '../version.js';
+import { GuiAssetCatalog } from '../gui/assets.js';
+import { buildGuiSourceGraph } from '../gui/source-graph.js';
 import { compareTechnologyGraphs } from './compare.js';
 import { buildTechnologyGraph, technologyAssetPatterns } from './graph.js';
 import { analyzeTechnologyImpact, discoverTechnologyFolders, explainTechnology, inspectTechnologyUnlocks, lintTechnologyGraph, technologyBonusCoverage, technologyScanReport, traceTechnology, } from './queries.js';
-import { renderTechnologyGraph, } from './render.js';
+import { renderTechnologyGraph, technologyRenderIconSprites, } from './render.js';
 const FRAGMENT_CACHE_ENTRIES = 8_192;
 const FRAGMENT_CACHE_BYTES = 134_217_728;
 const PROPOSED_SOURCE_FILES = 128;
@@ -80,10 +82,54 @@ function technologyScanPatterns(workspace) {
         'history/countries/**/*.txt',
         ...under(roots.focus, '**/*.txt'),
         ...under(roots.interface, '**/*.gui'),
+        ...under(roots.interface, '**/*.gfx'),
+        ...under(roots.gfx, '**/*.gfx'),
         ...under(roots.localisation, 'english/**/*.{yml,yaml}'),
         ...under(roots.localisation, '*.{yml,yaml}'),
     ].sort(compareCodeUnits);
 }
+function activeTechnologySprite(spriteName, spritePath, sprites) {
+    return sprites.find((sprite) => sprite.name === spriteName && (spritePath === undefined || sprite.sourcePath === spritePath));
+}
+async function resolveTechnologyIconDataUris(cached, requestedSprites, budget, signal) {
+    const icons = [
+        ...cached.graph.technologies.map(({ icon }) => icon),
+        ...cached.graph.doctrineDefinitions.flatMap(({ icon }) => icon ?? []),
+    ].filter(({ sprite }) => requestedSprites.has(sprite));
+    const spriteSourcePaths = new Set(icons.flatMap(({ spritePath }) => (spritePath === undefined ? [] : [spritePath])));
+    const spriteFiles = cached.snapshot.files.filter(({ displayPath }) => spriteSourcePaths.has(displayPath));
+    if (spriteFiles.length === 0)
+        return {};
+    const graph = buildGuiSourceGraph(spriteFiles, cached.snapshot.index);
+    const files = new Map();
+    for (const file of [...spriteFiles, ...cached.assetFiles])
+        files.set(file.displayPath, file);
+    const catalog = new GuiAssetCatalog(graph, [...files.values()], budget);
+    const unique = new Map();
+    for (const icon of icons)
+        if (!unique.has(icon.sprite))
+            unique.set(icon.sprite, icon);
+    const entries = [...unique.entries()].sort(([left], [right]) => compareCodeUnits(left, right));
+    const dataUris = {};
+    let cursor = 0;
+    await Promise.all(Array.from({ length: Math.min(8, entries.length) }, async () => {
+        while (cursor < entries.length) {
+            signal?.throwIfAborted();
+            const entry = entries[cursor];
+            cursor += 1;
+            if (entry === undefined)
+                continue;
+            const [spriteName, icon] = entry;
+            const sprite = activeTechnologySprite(spriteName, icon.spritePath, graph.sprites);
+            if (sprite === undefined)
+                continue;
+            const frame = await catalog.loadSpriteFrame(sprite, 0);
+            if (frame?.supported === true && frame.dataUri !== undefined)
+                dataUris[spriteName] = frame.dataUri;
+        }
+    }));
+    return Object.fromEntries(Object.entries(dataUris).sort(([left], [right]) => compareCodeUnits(left, right)));
+}
 function technologyAnalysisMode(workspace, snapshot) {
     return workspace.gameRoot !== undefined || snapshot.files.length > FOCUSED_GRAPH_FILE_THRESHOLD
         ? 'focused'
@@ -462,6 +508,9 @@ export class TechnologyTreeViewer {
             ...(input.signal === undefined ? {} : { signal: input.signal }),
         });
         const budget = new RenderBudget();
+        const cached = this.#state.current.get(input.workspaceId);
+        if (cached?.graph.revision !== graph.revision)
+            throw new ServiceError('TECH_RENDER_SOURCE_MISSING', 'Technology render source inventory is unavailable for the current graph');
         const renderOptions = {
             view: input.view,
             maxNodes: input.maxNodes ?? 1_000,
@@ -473,13 +522,23 @@ export class TechnologyTreeViewer {
             ...(input.targetId === undefined ? {} : { targetId: input.targetId }),
             ...(input.signal === undefined ? {} : { signal: input.signal }),
         };
-        const render = await renderTechnologyGraph(graph, renderOptions);
-        const focused = [];
         const focusedFolders = input.view === 'dependencies' && input.folderId === undefined
             ? graph.folders
                 .filter((folder) => graph.placements.some(({ folderId }) => folderId === folder.id))
                 .slice(0, FOCUSED_RENDER_LIMIT)
             : [];
+        const requestedIconSprites = new Set([
+            ...technologyRenderIconSprites(graph, renderOptions),
+            ...focusedFolders.flatMap(({ id }) => technologyRenderIconSprites(graph, {
+                view: 'folder',
+                folderId: id,
+                maxNodes: 1_000,
+            })),
+        ]);
+        const iconDataUris = await resolveTechnologyIconDataUris(cached, requestedIconSprites, budget, input.signal);
+        renderOptions.iconDataUris = iconDataUris;
+        const render = await renderTechnologyGraph(graph, renderOptions);
+        const focused = [];
         for (const folder of focusedFolders) {
             input.signal?.throwIfAborted();
             focused.push(await renderTechnologyGraph(graph, {
@@ -487,6 +546,7 @@ export class TechnologyTreeViewer {
                 folderId: folder.id,
                 maxNodes: 1_000,
                 includeHtml: false,
+                iconDataUris,
                 budget,
                 ...(input.signal === undefined ? {} : { signal: input.signal }),
             }));
@@ -516,6 +576,8 @@ export class TechnologyTreeViewer {
                 omittedNodeCount: render.omittedNodeCount,
                 sourceAccurate: render.sourceAccurate,
                 generatedAnalysisLayout: render.generatedAnalysisLayout,
+                renderedIconCount: render.renderedIconCount,
+                unresolvedIconSprites: render.unresolvedIconSprites,
                 hashes: render.hashes,
             },
             focusedFolders: focused.map((bundle, index) => ({
@@ -523,6 +585,8 @@ export class TechnologyTreeViewer {
                 folderId: focusedFolders[index]?.id,
                 selectedIds: bundle.selectedIds,
                 omittedNodeCount: bundle.omittedNodeCount,
+                renderedIconCount: bundle.renderedIconCount,
+                unresolvedIconSprites: bundle.unresolvedIconSprites,
                 hashes: bundle.hashes,
             })),
             focusedFolderCoverage: {

package/dist/hoi4_agent_tools/technology/source-analysis.js CHANGED Viewed

@@ -348,6 +348,13 @@ function parseTechnologyDefinitions(file, document, fragment) {
                     .map(({ key }) => key.value)
                     .filter((key) => !technologyStructuralFields.has(key) && !key.startsWith('@'))),
             ].sort(compareCodeUnits);
+            const layoutExpression = firstValue(block, 'force_use_small_tech_layout');
+            const smallLayout = booleanValue(layoutExpression);
+            const layoutSize = layoutExpression === undefined || smallLayout === false
+                ? 'large'
+                : smallLayout === true
+                    ? 'small'
+                    : 'unknown';
             const unsupportedFields = fragment.placements
                 .filter(({ technologyId, xExpression, yExpression }) => technologyId === id && (xExpression !== undefined || yExpression !== undefined))
                 .map((placement) => ({
@@ -355,7 +362,17 @@ function parseTechnologyDefinitions(file, document, fragment) {
                 expression: `${placement.xExpression ?? placement.x ?? '?'}:${placement.yExpression ?? placement.y ?? '?'}`,
                 location: placement.location,
                 reason: 'The source coordinate expression is not a resolvable file-local numeric constant',
-            }));
+            }))
+                .concat(layoutSize === 'unknown'
+                ? [
+                    {
+                        field: 'force_use_small_tech_layout',
+                        expression: layoutExpression,
+                        location: nodeLocation(document, block, id),
+                        reason: 'The technology layout-size expression is not a literal yes or no',
+                    },
+                ]
+                : []);
             const doctrine = booleanValue(firstValue(block, 'doctrine')) === true;
             fragment.technologies.push({
                 id,
@@ -372,6 +389,7 @@ function parseTechnologyDefinitions(file, document, fragment) {
                     ? {}
                     : { doctrineName: firstValue(block, 'doctrine_name') }),
                 hidden: hiddenStatus(block),
+                layoutSize,
                 folders: [...new Set(folders)].sort(compareCodeUnits),
                 categories: [...new Set(categories)].sort(compareCodeUnits),
                 tags: [...new Set(tags)].sort(compareCodeUnits),

package/dist/hoi4_agent_tools/version.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import { LATEST_PROTOCOL_VERSION } from '@modelcontextprotocol/sdk/types.js';
 export const PACKAGE_NAME = 'hoi4-agent-tools';
-export const PACKAGE_VERSION = '2.5.1';
+export const PACKAGE_VERSION = '2.5.3';
 export const MCP_PROTOCOL_VERSION = LATEST_PROTOCOL_VERSION;
 export const CONFIG_VERSION = 1;
 export const TRANSACTION_VERSION = 1;

package/docs/focus.md CHANGED Viewed

@@ -30,7 +30,7 @@ For a layout-only cleanup of an existing national tree, call `hoi4.focus_rewrite
 Compact mode imports the tree, resets authored presentation coordinates and lane bounds, and performs a deterministic reflow in the same rewrite call. It keeps prerequisites, mutual exclusions, availability, bypasses, rewards, icons, localisation, AI behavior, and route/lane membership unchanged.
-The rewrite measures canvas bounds, same-row spacing, the same curved connector paths used by the renderer, connector lengths, connector-node intersections, branch balance, overall centering, and topology-aware fake-complexity patterns. Compact mode evaluates preservation, row repair, linear-chain repair, sibling balancing, and combined compression strategies, then chooses the cleanest valid result. Sparse direct sibling fan-outs are packed around their parent at the minimum readable spacing, with each exclusive descendant branch moving as a unit and shared convergence focuses staying centered. Dense branches remain wider only when their contents need the room. It refuses invalid geometry such as overlapping or cramped focuses, bad parent order, rendered crossings, connectors through unrelated focuses, or an off-center canvas. Long connectors, fake detours, staircase or zigzag chains, and avoidable sibling imbalance are optimization priorities instead of independent rejection budgets.
+The rewrite measures canvas bounds, same-row spacing, the same curved connector paths used by the renderer, connector lengths, connector-node intersections, branch balance, overall centering, and topology-aware fake-complexity patterns. Compact mode evaluates preservation, occupied-row repair, prerequisite-depth reflow, linear-chain repair, sibling balancing, and combined compression strategies, then chooses the cleanest valid result. Equivalent branches are aligned by dependency depth even when their authored rows differ, and connector shape is prioritized before raw canvas dimensions so a shorter canvas cannot win by introducing unnecessary horizontal detours. Sparse direct sibling fan-outs are packed around their parent at the minimum readable spacing, with each exclusive descendant branch moving as a unit and shared convergence focuses staying centered. Dense branches remain wider only when their contents need the room. It refuses invalid geometry such as overlapping or cramped focuses, bad parent order, rendered crossings, connectors through unrelated focuses, or an off-center canvas. Long connectors, fake detours, staircase or zigzag chains, and avoidable sibling imbalance are optimization priorities instead of independent rejection budgets.
 Use the default `layoutMode: "authored"` with a complete plan when deliberately designing coordinates or changing gameplay. Set `layoutMode: "compact"` with a complete plan when creating a large automatically arranged tree. Inspect and render calls remain useful before or after either rewrite mode, but a separate plan is not required for compact cleanup.

package/docs/gui.md CHANGED Viewed

@@ -52,6 +52,8 @@ Selectors accept an element name, instance ID, or source ID. Visibility expectat
 Broad inspection indexes localisation actually referenced by GUI source and returns a connected workspace projection when the complete source graph is very large. The resource records full and returned node and edge counts, so an agent can identify the relevant window without loading unrelated vanilla UI into its prompt. Rendering remains targeted to the selected root, state, and resolution.
+GUI rewrites keep complete validation evidence in a linked JSON resource and retain the highest-priority findings in the transaction result. Large surrounding interface inventories therefore do not turn a small scalar patch into a transaction structure-limit error.
 ## Offline preview limits
 The renderer does not run the game engine. Each render includes a fidelity report that separates fields it models from fields it approximates, ignores, cannot resolve, or does not support. Treat that report as part of the review.

package/docs/technology.md CHANGED Viewed

@@ -51,7 +51,7 @@ Game-backed and otherwise large workspaces automatically use focused analysis mo
 `hoi4.tech_render` returns authoritative JSON with deterministic SVG and PNG resources; set `includeHtml` when a bundled static report is useful. Available views are `summary`, `folder`, `dependencies`, `technology`, `doctrine`, `exclusive`, `memberships`, `bonuses`, `grants`, `unlocks`, `metadata`, `assets`, and `unresolved`.
-Folder renders use the actual folder assignments, gridbox geometry, and technology coordinates found in source. Dependency and other semantic views are explicitly labelled as generated analysis layouts. Missing sprites, textures, or localisation remain identifiable from JSON and vector output even when no icon raster is decoded.
+Folder renders use the actual folder assignments, gridbox geometry, technology coordinates, and HOI4 item size found in source. Technologies with `force_use_small_tech_layout = yes` render as compact icon items; normal technologies render as large items with their icon and label. Sprite declarations and texture files resolve through the active load order across the mod, configured dependencies, and the detected or configured game installation, so vanilla icons used by a mod appear in SVG, PNG, and HTML artifacts. The authoritative JSON and SVG expose `layoutSize`, rendered-icon coverage, and unresolved sprite names without embedding image data in JSON. Dependency and other semantic views are explicitly labelled as generated analysis layouts.
 Example folder render:

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "hoi4-agent-tools",
   "mcpName": "io.github.klimPaskov/hoi4-agent-tools",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "description": "Analyze HOI4 events, tech trees, AI weights, and MTTH; build focus trees, GUIs, and maps.",
   "type": "module",
   "license": "Apache-2.0",
@@ -69,6 +69,7 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "vitest run",
+    "test:all": "vitest run --shard=1/8 && vitest run --shard=2/8 && vitest run --shard=3/8 && vitest run --shard=4/8 && vitest run --shard=5/8 && vitest run --shard=6/8 && vitest run --shard=7/8 && vitest run --shard=8/8",
     "test:unit": "vitest run tests/unit",
     "test:integration": "vitest run tests/integration",
     "test:local": "tsx scripts/run-local-tests.ts",
@@ -91,7 +92,7 @@
     "release:order:verify": "tsx scripts/verify-npm-release-order.ts",
     "pack:check": "tsx scripts/check-package.ts",
     "inspector": "tsx scripts/run-inspector.ts",
-    "check": "npm run format:check && npm run lint && npm run typecheck && npm run test && npm run fixtures:check && npm run schemas:check && npm run build && npm run pack:check && npm run registry:validate",
+    "check": "npm run format:check && npm run lint && npm run typecheck && npm run test:all && npm run fixtures:check && npm run schemas:check && npm run build && npm run pack:check && npm run registry:validate",
     "prepack": "npm run build"
   },
   "dependencies": {

package/schemas/configuration.schema.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/configuration.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.3/schemas/configuration.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/continuous-focus-palette.schema.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/continuous-focus-palette.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.3/schemas/continuous-focus-palette.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/custom-weighted-pool.schema.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/custom-weighted-pool.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.3/schemas/custom-weighted-pool.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/event-feature-manifest.schema.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/event-feature-manifest.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.3/schemas/event-feature-manifest.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/focus-plan.schema.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/focus-plan.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.3/schemas/focus-plan.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/focus-planning-sidecar.schema.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/focus-planning-sidecar.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.3/schemas/focus-planning-sidecar.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/gui-animation-source.schema.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/gui-animation-source.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.3/schemas/gui-animation-source.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/gui-helper.schema.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/gui-helper.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.3/schemas/gui-helper.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {