hoi4-agent-tools 4.0.5 → 4.1.0

package/dist/hoi4_agent_tools/mcp/tools/map.js

@@ -105,7 +105,7 @@ const mapRenderDataSchema = z
 const mapInspectOutputSchema = strictOperationResultSchema(z.union([mapWorkspaceInspectDataSchema, mapRenderDataSchema]));
 const mapPlanOutputSchema = strictOperationResultSchema(z
     .object({
-    execution: z.enum(['applied', 'blocked', 'unchanged']),
+    execution: z.enum(['applied', 'blocked', 'unchanged', 'preview']),
     allocations: z.array(allocationEvidenceSchema).max(100),
     operationBlockers: z.array(operationBlockerDataSchema).max(100),
     expectedChangedBounds: changedBoundsSchema.nullable(),
@@ -116,6 +116,19 @@ const mapPlanOutputSchema = strictOperationResultSchema(z
     semanticDiffTruncated: z.boolean(),
     fileCount: nonNegativeIntegerSchema,
     artifactCount: nonNegativeIntegerSchema,
+    preview: z
+        .object({
+        offlineRepresentation: z.literal(true),
+        width: nonNegativeIntegerSchema,
+        height: nonNegativeIntegerSchema,
+        provinces: nonNegativeIntegerSchema,
+        states: nonNegativeIntegerSchema,
+        regions: nonNegativeIntegerSchema,
+        countries: nonNegativeIntegerSchema,
+        warningCount: nonNegativeIntegerSchema,
+    })
+        .strict()
+        .optional(),
 })
     .strict());
 const artifactProducing = {
@@ -136,7 +149,7 @@ export const mapTaskTools = [
     {
         name: 'hoi4.map_rewrite',
         title: 'Build a world or edit the map',
-        description: 'Build a world, split or merge states, move or renumber provinces, and update script references. Regenerate building positions and supply networks. Example: {"operations":[{"id":"s1","kind":"create_state","provinceIds":[120,121],"displayName":"New State"}]}. Returns changed IDs, a summary of edits and a render.',
+        description: 'Build a world from a local reference image or edit provinces, states, regions and supply. Example: {"preview":true,"operations":[{"kind":"create_world","reference":{"imagePath":"references/world.png"}}]}. Preview first to check coastlines, terrain and provisional countries; omit preview to write the generated map and starting scenario. Reviewed masks and labels refine ambiguous artwork. Returns counts, diagnostics and linked PNGs. Offline validation does not prove game playability.',
         inputSchema: mapRewriteRequestSchema,
         outputSchema: mapPlanOutputSchema,
         annotations: {

package/dist/hoi4_agent_tools/schemas/map-requests.js

@@ -143,6 +143,10 @@ export const mapRewriteRequestSchema = z
     .object({
     workspaceId: workspaceIdSchema,
     operations: z.array(compactMapOperationSchema).min(1).max(100),
+    preview: z
+        .boolean()
+        .default(false)
+        .describe('Return generated reference, terrain and political previews and counts without changing mod files.'),
     diffScale: z.number().int().min(1).max(16).optional(),
     requestKey: backgroundRequestKeySchema.optional(),
 })

package/dist/hoi4_agent_tools/schemas/map.js

@@ -1,7 +1,15 @@
 import { z } from 'zod/v4';
 import { renderDimensionViolation, RENDER_MAX_DIMENSION } from '../core/render-budget.js';
 import { MAP_MASK_CELL_LIMIT, MAP_SELECTED_PIXEL_LIMIT } from '../map/limits.js';
+import { workspaceRelativePathSchema } from './common.js';
 const identifier = z.string().min(1).max(256);
+// eslint-disable-next-line no-control-regex -- portable JSON Schema pattern rejects grammar-breaking controls.
+const worldNamePattern = /^[^\u0000-\u001f\u007f]+$/u;
+const worldName = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(worldNamePattern, 'World names must not contain control characters');
 const stateId = z.number().int().positive();
 const provinceId = z.number().int().min(0);
 const provinceTypeSchema = z.enum(['land', 'sea', 'lake']);
@@ -18,6 +26,83 @@ const operationBase = {
     id: identifier,
     summary: z.string().max(1000).optional(),
 };
+const referencePointSchema = z
+    .object({ x: z.number().min(0).max(1), y: z.number().min(0).max(1) })
+    .strict();
+const referenceKindSchema = z.enum([
+    'sea',
+    'land',
+    'plains',
+    'forest',
+    'desert',
+    'mountain',
+    'snow',
+    'lake',
+    'volcano',
+    'hills',
+    'marsh',
+    'jungle',
+]);
+const referencePolygonSchema = z.array(referencePointSchema).min(3).max(1_000);
+const referenceImagePathSchema = workspaceRelativePathSchema.refine((value) => !value.includes(':') && /\.(?:png|jpe?g|webp)$/iu.test(value), 'Reference must be a workspace-relative PNG, JPEG or WebP file');
+/** Optional controls refine automatic interpretation; a single imagePath is sufficient. */
+export const worldReferenceSchema = z
+    .object({
+    imagePath: referenceImagePathSchema,
+    politicalImagePath: referenceImagePathSchema.optional(),
+    terrainImagePath: referenceImagePathSchema.optional(),
+    heightImagePath: referenceImagePathSchema.optional(),
+    mode: z
+        .enum(['auto', 'illustrated', 'satellite', 'sketch', 'political', 'grayscale'])
+        .optional(),
+    crop: z
+        .object({
+        x: z.number().int().min(0),
+        y: z.number().int().min(0),
+        width: z.number().int().positive().max(65_536),
+        height: z.number().int().positive().max(65_536),
+    })
+        .strict()
+        .optional(),
+    ignoreMasks: z.array(referencePolygonSchema).max(64).optional(),
+    annotations: z
+        .array(z.object({ kind: referenceKindSchema, polygon: referencePolygonSchema }).strict())
+        .max(128)
+        .optional(),
+    riverAnnotations: z.array(z.array(referencePointSchema).min(2).max(1_000)).max(128).optional(),
+    palette: z
+        .array(z.object({ kind: referenceKindSchema, color: rgbSchema }).strict())
+        .max(64)
+        .optional(),
+    coastDetail: z.number().min(0).max(1).optional(),
+    labels: z
+        .array(z
+        .object({
+        name: worldName,
+        x: z.number().min(0).max(1),
+        y: z.number().min(0).max(1),
+        kind: z.enum(['state', 'country', 'city', 'sea', 'region', 'mountain', 'geography']),
+    })
+        .strict())
+        .max(2_048)
+        .optional(),
+    cities: z
+        .array(z
+        .object({
+        name: worldName,
+        x: z.number().min(0).max(1),
+        y: z.number().min(0).max(1),
+        countryTag: z
+            .string()
+            .regex(/^[A-Z][A-Z0-9]{2}$/u)
+            .optional(),
+    })
+        .strict())
+        .max(200)
+        .optional(),
+})
+    .strict()
+    .describe('Generate from one local reference image. Optional controls use normalized 0..1 source coordinates; crop uses source pixels. Labels and political semantics may need refinement.');
 const moveStateDistributionSchema = z
     .object({
     stateValues: z.enum(['retain-in-current-states', 'proportional-by-land-pixels']),
@@ -473,8 +558,15 @@ export const mapOperationSchema = z.discriminatedUnion('kind', [
         .object({
         ...operationBase,
         kind: z.literal('create_world'),
-        width: z.number().int().min(256).max(8_192).multipleOf(256).default(1_024),
-        height: z.number().int().min(256).max(4_096).multipleOf(256).default(512),
+        worldName: worldName.optional(),
+        startingScenario: z
+            .boolean()
+            .optional()
+            .describe('Include basic starting units and stockpiles and replace old-world startup/AI geography. Defaults on for reference-image worlds.'),
+        id: identifier.default('world'),
+        reference: worldReferenceSchema.optional(),
+        width: z.number().int().min(256).max(8_192).multipleOf(256).optional(),
+        height: z.number().int().min(256).max(4_096).multipleOf(256).optional(),
         seed: z.number().int().min(0).max(2_147_483_647).default(1),
         landCoverage: z.number().min(0.05).max(0.9).default(0.35),
         continents: z.number().int().min(1).max(12).default(3),
@@ -485,28 +577,29 @@ export const mapOperationSchema = z.discriminatedUnion('kind', [
             .describe('Land outlines in top-left pixel coordinates; omit for generated continents.'),
         landProvincePixels: z.number().int().min(60).max(50_000).default(400),
         seaProvincePixels: z.number().int().min(200).max(200_000).default(2_500),
-        provincesPerState: z.number().int().min(1).max(64).default(5),
-        landProvincesPerRegion: z.number().int().min(2).max(400).default(25),
-        seaProvincesPerRegion: z.number().int().min(1).max(200).default(10),
+        provincesPerState: z.number().int().min(1).max(64).optional(),
+        landProvincesPerRegion: z.number().int().min(2).max(400).optional(),
+        seaProvincesPerRegion: z.number().int().min(1).max(200).optional(),
         countries: z
             .array(z
             .object({
             tag: z.string().regex(/^[A-Z][A-Z0-9]{2}$/u),
-            name: z.string().min(1).max(64),
-            adjective: z.string().min(1).max(64).optional(),
+            name: worldName,
+            adjective: worldName.optional(),
             color: rgbSchema.optional(),
             share: z.number().min(0.05).max(100).optional(),
             ideology: z.enum(['democratic', 'communism', 'fascism', 'neutrality']).optional(),
         })
             .strict())
             .min(1)
-            .max(200),
-        continentNames: z.array(z.string().min(1).max(64)).max(12).optional(),
+            .max(200)
+            .optional(),
+        continentNames: z.array(worldName).max(12).optional(),
         startDate: z
             .string()
             .regex(/^\d{3,4}\.\d{1,2}\.\d{1,2}$/u)
             .default('1936.1.1'),
-        rivers: z.number().int().min(0).max(500).default(8),
+        rivers: z.number().int().min(0).max(500).optional(),
         replaceBaseGame: z
             .boolean()
             .default(true)

package/dist/hoi4_agent_tools/schemas/transaction.js

@@ -1,8 +1,15 @@
 import { z } from 'zod/v4';
-import { TRANSACTION_MAX_APPLIED_FILES, TRANSACTION_MAX_ARTIFACTS, TRANSACTION_MAX_DIAGNOSTICS, TRANSACTION_MAX_FILES, TRANSACTION_MAX_OPERATIONS, TRANSACTION_MAX_READ_DEPENDENCIES, TRANSACTION_MAX_VALIDATION_CHECKS, } from '../core/transaction-limits.js';
+import { TRANSACTION_MAX_APPLIED_FILES, TRANSACTION_MAX_ARTIFACTS, TRANSACTION_MAX_DIAGNOSTICS, TRANSACTION_MAX_FILES, TRANSACTION_MAX_OPERATIONS, TRANSACTION_MAX_PENDING_FILES, TRANSACTION_MAX_READ_DEPENDENCIES, TRANSACTION_MAX_VALIDATION_CHECKS, } from '../core/transaction-limits.js';
 import { TRANSACTION_VERSION } from '../version.js';
 import { diagnosticSchema, workspaceIdSchema, workspaceRelativePathSchema } from './common.js';
 const sha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);
+const compatibleTransactionVersion = z.union([z.literal(1), z.literal(TRANSACTION_VERSION)]);
+const fileIdentitySchema = z
+    .object({
+    device: z.string().regex(/^(0|[1-9][0-9]{0,39})$/u),
+    inode: z.string().regex(/^(0|[1-9][0-9]{0,39})$/u),
+})
+    .strict();
 const identifierSchema = z.string().min(1).max(256);
 const summarySchema = z.string().max(4096);
 const mediaTypeSchema = z.string().min(1).max(255);
@@ -55,7 +62,7 @@ const transactionFileSchema = z
     .strict();
 const transactionPlanPayloadSchema = z
     .object({
-    version: z.literal(TRANSACTION_VERSION),
+    version: compatibleTransactionVersion,
     workspaceId: workspaceIdSchema,
     principal: z.string().max(1024).nullable(),
     rootFingerprint: sha256Schema,
@@ -72,7 +79,7 @@ const transactionPlanPayloadSchema = z
     .strict();
 export const transactionManifestSchema = z
     .object({
-    version: z.literal(TRANSACTION_VERSION),
+    version: compatibleTransactionVersion,
     revision: z.number().int().min(1).max(Number.MAX_SAFE_INTEGER),
     transactionId: z.string().regex(/^txn_[0-9a-f-]{36}$/u),
     workspaceId: workspaceIdSchema,
@@ -98,6 +105,16 @@ export const transactionManifestSchema = z
     artifacts: z.array(artifactLinkSchema).max(TRANSACTION_MAX_ARTIFACTS),
     executionArtifacts: z.array(artifactLinkSchema).max(TRANSACTION_MAX_ARTIFACTS).optional(),
     appliedFiles: z.array(workspaceRelativePathSchema).max(TRANSACTION_MAX_APPLIED_FILES),
+    pendingFiles: z
+        .array(z
+        .object({
+        relativePath: workspaceRelativePathSchema,
+        beforeIdentity: fileIdentitySchema.nullable(),
+        stagedIdentity: fileIdentitySchema.nullable(),
+    })
+        .strict())
+        .max(TRANSACTION_MAX_PENDING_FILES)
+        .optional(),
     rollbackStatus: z.enum(['available', 'applied', 'failed']),
     failure: z.object({ code: identifierSchema, message: summarySchema }).strict().optional(),
 })

package/dist/hoi4_agent_tools/version.js

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

package/docs/map.md

@@ -3,6 +3,51 @@
 Generate a new world, split states and reshape provinces. Preview the map and update the scripts that refer to it.
 Use `hoi4.map_inspect` and `hoi4.map_rewrite` for provinces, states, regions, supply, railways, positions, ownership, resources, buildings and localisation.
 
+## Generate a world from one image
+
+Put a PNG, JPEG or WebP reference in your mod workspace, then call `hoi4.map_rewrite`:
+
+```json
+{
+  "operations": [{ "kind": "create_world", "reference": { "imagePath": "references/sketch.png" } }]
+}
+```
+
+For a first run, copy the project-owned [synthetic hand sketch](images/reference-maps/sketch.png) to `references/sketch.png` in your mod. The [synthetic flat political map](images/reference-maps/political.png) is another ready-made input; copy it to `references/political.png` and change `imagePath` accordingly. The examples are intentionally small and contain no third-party artwork.
+
+The server generates the complete map and supporting country/state files in one validated atomic rewrite. No country list, manual masks, coordinates or separate apply call is required. `workspaceId` defaults to the current mod, and the operation ID defaults to `world`. The default reference world is 5632 by 2048 pixels; the artwork retains its aspect ratio within sea padding. Set `width` and `height` to choose other multiples of 256 within the map pixel budget. Reference defaults group 12 provinces per state, 60 land provinces or 30 sea provinces per strategic region, and request 80 rivers; explicit values override these defaults.
+
+Add `"preview": true` at the top level to return offline reference, terrain and political PNGs, a comparison and counts without changing mod files. Repeat the request without `preview` to apply it. Preview uses the same extraction, generation and validation as application, and never launches the game.
+
+Use a cleaned, unlabelled raster for production generation. Handwriting, sheet joins and map frames can become false islands or relief. Keep the original unchanged, remove these marks in a separate reference, compare its coastlines with the original, then inspect the terrain preview before writing. Supply reviewed names through `reference.labels` and `reference.cities`; an explicit label list, including an empty list, prevents OCR from adding unreviewed names. The server does not automatically redraw artwork or promise lossless interpretation of every map.
+
+Reference worlds enable `startingScenario` by default; procedural worlds keep it off unless requested. The starter includes a bookmark, country histories, provisional councils, recruitable infantry templates, two equipped divisions per country, stockpiles, an infantry production line, supply and building positions. `worldName` sets the bookmark title. Demographics, industry and ownership remain provisional. Existing world events, decisions, startup hooks and country-specific AI strategy folders are replaced; shared game systems remain dependencies and can report unused-definition warnings. Generated names use the localisation replacement folder, and explicit country color declarations match the flags. Inherited country tags receive inactive histories. The adjacent launcher `.mod` file must mirror the generated `descriptor.mod` replacement paths. The server cannot enable a launcher playset or test a campaign.
+
+Regeneration records generated paths and hashes in `.hoi4-agent-world.json`. It removes obsolete recorded outputs through the same atomic rewrite and refuses to overwrite recorded files edited since generation. Preserve that inventory. Unrelated authored files are not deleted; validation can block a rebuild if they conflict with the generated world. Large world diffs remain linked evidence so counts and preview images fit within the MCP response budget.
+
+Automatic interpretation recognizes visual land/water and terrain cues, derives relief and drainage, and uses flat political colors when available. Offline English OCR supplies candidate names and city locations; recognized text bounds are masked before terrain classification so ocean labels do not become islands. Masks near a coastline can soften its detail and produce a review warning. Decorative text, handwriting, unknown languages and visually ambiguous borders may be missed or misclassified; diagnostics identify uncertain interpretation and deterministic defaults. Population, resources, buildings and country ownership inferred from artwork are generated assumptions, not historical facts or a balance assessment.
+
+Optional `reference` controls refine the same call:
+
+| Field                                                       | Meaning                                                                                                                                                  |
+| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `politicalImagePath`, `terrainImagePath`, `heightImagePath` | Additional aligned workspace images for political regions, terrain cues or grayscale height.                                                             |
+| `mode`                                                      | `auto`, `illustrated`, `satellite`, `sketch`, `political` or `grayscale`.                                                                                |
+| `crop`                                                      | `{x,y,width,height}` in original source pixels.                                                                                                          |
+| `ignoreMasks`                                               | Polygons that exclude legends, frames or decorative areas.                                                                                               |
+| `annotations`                                               | `{kind,polygon}` semantic polygons: sea, land, plains, lake, forest, desert, mountain, snow, volcano, hills, marsh or jungle.                            |
+| `riverAnnotations`                                          | Paths for known rivers.                                                                                                                                  |
+| `palette`                                                   | `{kind,color:{r,g,b}}` color cues for the same semantic kinds.                                                                                           |
+| `coastDetail`                                               | Detail preservation from 0 to 1.                                                                                                                         |
+| `cities`                                                    | `{name,x,y,countryTag?}` reviewed city and optional capital anchors. `countryTag` must name a generated country.                                         |
+| `labels`                                                    | `{name,x,y,kind}` reviewed names for `state`, `country`, `city`, `sea`, `region`, `mountain` or `geography`; useful for handwritten or ambiguous labels. |
+
+Reviewed geography labels preserve names for lakes, rivers, forests and other features in localisation and generated-world provenance. They do not invent a native HOI4 map entity or turn a geographic label into a city or victory point.
+
+All annotation positions and polygons use normalized 0 to 1 coordinates relative to the original, uncropped reference, with the origin at its top left. Crop uses source pixels instead. Explicit `countries` on the operation supplies reviewed country tags, names, colors and relative shares. If borders or names cannot be inferred reliably, the server generates named defaults and reports the assumptions. Manual controls are optional and never change the original image.
+
+Only relative paths inside the authorized mod workspace are accepted. URLs, absolute paths, traversal, generated storage and symlink escapes are refused. The source is bounded to 1 GiB and 300 million decoded pixels; analysis uses a reduced working PNG up to 3072 pixels per side. The verified source handle is streamed into an exclusive private temporary snapshot, and the same copied bytes are hashed and decoded; the snapshot is removed on completion, failure or cancellation. The original SHA-256 is checked again before writing, using a streaming read, so replacing the source after preparation blocks application. CI image fixtures are synthetic and project-owned. Attributed comparison images may be published separately with permission and remain outside the npm package.
+
 ## Inspect and navigate the complete map
 
 `hoi4.map_inspect` finds map problems and returns a full-map PNG plus a searchable, clickable HTML navigator by default. The navigator supports pan, zoom, fit-to-map, search by numeric ID, localisation key, or localised name, and exact click lookup for province, state, and strategic-region IDs. Hovering reports both top-left bitmap coordinates and bottom-left HOI4 map coordinates.

package/docs/third-party-notices.md

@@ -8,4 +8,10 @@ Copyright 2011 The Roboto Project Authors (<https://github.com/googlefonts/robot
 
 Roboto is licensed under the SIL Open Font License, Version 1.1 (`OFL-1.1`). The complete license text is distributed as `LICENSE` in the installed `@fontsource-variable/roboto` package. The font package is pinned in `package.json` and the published `npm-shrinkwrap.json`; generated SVG/PNG documents may contain derived glyph outlines or pixels as permitted by the OFL.
 
+## Offline reference-image OCR
+
+`tesseract.js` version 7.0.0 and its `tesseract.js-core` dependency provide the local WebAssembly OCR engine under Apache-2.0. English trained data is installed through `@tesseract.js-data/eng` version 1.0.0. That package declares MIT licensing for its packaging; its upstream [tessdata repository](https://github.com/naptha/tessdata) distributes Tesseract language data under [Apache-2.0](https://github.com/naptha/tessdata/blob/gh-pages/LICENSE). The project uses the unmodified `4.0.0_best_int/eng.traineddata.gz` model from the dependency. No reference artwork or language model is copied into project fixtures or source assets.
+
+These dependencies are pinned by `package.json` and `npm-shrinkwrap.json`. OCR uses the installed worker, engine and language bytes without runtime network downloads or external OCR executables. The engine and language data retain their upstream licenses.
+
 The application source remains licensed under Apache-2.0 as stated in the repository [LICENSE](../LICENSE). Third-party components retain their respective licenses.

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "hoi4-agent-tools",
-  "version": "4.0.5",
+  "version": "4.1.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "hoi4-agent-tools",
-      "version": "4.0.5",
+      "version": "4.1.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@fontsource-variable/roboto": "5.3.0",
@@ -14,12 +14,14 @@
         "@modelcontextprotocol/node": "2.1.1",
         "@modelcontextprotocol/sdk": "1.32.1",
         "@modelcontextprotocol/server": "2.3.1",
+        "@tesseract.js-data/eng": "1.0.0",
         "express": "5.2.1",
         "fontkit": "2.0.4",
         "glob": "13.0.6",
         "iconv-lite": "0.7.3",
         "jose": "6.2.8",
         "sharp": "0.35.5",
+        "tesseract.js": "7.0.0",
         "zod": "4.4.3"
       },
       "bin": {
@@ -2369,6 +2371,12 @@
         "tslib": "^2.8.0"
       }
     },
+    "node_modules/@tesseract.js-data/eng": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/@tesseract.js-data/eng/-/eng-1.0.0.tgz",
+      "integrity": "sha512-mbTumm6KQPUHyzTPQaF3ObXYnx0SqqfV2nabqFVQBwD6Kl7PhGSLSzOlfFTWy0P3BjghaSKA2W9GB19Jk+ZcTg==",
+      "license": "MIT"
+    },
     "node_modules/@types/body-parser": {
       "version": "1.19.6",
       "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz",
@@ -3132,6 +3140,12 @@
       ],
       "license": "MIT"
     },
+    "node_modules/bmp-js": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/bmp-js/-/bmp-js-0.1.0.tgz",
+      "integrity": "sha512-vHdS19CnY3hwiNdkaqk93DvjVLfbEcI8mys4UjuWrlX1haDmroo8o4xCzh4wD6DGV6HxRCyauwhHRqMTfERtjw==",
+      "license": "MIT"
+    },
     "node_modules/body-parser": {
       "version": "2.3.0",
       "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.3.0.tgz",
@@ -4431,6 +4445,12 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/idb-keyval": {
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/idb-keyval/-/idb-keyval-6.3.0.tgz",
+      "integrity": "sha512-um+2dgAWmYsu615EXpWVwSmapJhON0G43t3Ka/EVaohzPQXSMqKEqeDK/oIW3Ow+BXaF2PvSc+oBTFp793A5Ow==",
+      "license": "Apache-2.0"
+    },
     "node_modules/ignore": {
       "version": "5.3.2",
       "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
@@ -4743,6 +4763,12 @@
         "tslib": "^2.0.3"
       }
     },
+    "node_modules/is-url": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/is-url/-/is-url-1.2.4.tgz",
+      "integrity": "sha512-ITvGim8FhRiYe4IQ5uHSkj7pVaPDrCTkNd3yq3cV7iZAcJdHTUMPMEHcqSOy9xZ9qFenQCvi+2wjH9a1nXqHww==",
+      "license": "MIT"
+    },
     "node_modules/is-wsl": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz",
@@ -5359,6 +5385,26 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/node-fetch": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz",
+      "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==",
+      "license": "MIT",
+      "dependencies": {
+        "whatwg-url": "^5.0.0"
+      },
+      "engines": {
+        "node": "4.x || >=6.0.0"
+      },
+      "peerDependencies": {
+        "encoding": "^0.1.0"
+      },
+      "peerDependenciesMeta": {
+        "encoding": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/object-assign": {
       "version": "4.1.1",
       "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
@@ -5460,6 +5506,15 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/opencollective-postinstall": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/opencollective-postinstall/-/opencollective-postinstall-2.0.3.tgz",
+      "integrity": "sha512-8AV/sCtuzUeTo8gQK5qDZzARrulB3egtLzFgteqB2tcT4Mw7B8Kt7JcDHmltjz6FOAHsvTevk70gZEbhM4ZS9Q==",
+      "license": "MIT",
+      "bin": {
+        "opencollective-postinstall": "index.js"
+      }
+    },
     "node_modules/optionator": {
       "version": "0.9.4",
       "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
@@ -5888,6 +5943,12 @@
         "node": ">= 12.13.0"
       }
     },
+    "node_modules/regenerator-runtime": {
+      "version": "0.13.11",
+      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.11.tgz",
+      "integrity": "sha512-kY1AZVr2Ra+t+piVaJ4gxaFaReZVH40AKNo7UCX6W+dEwBo/2oZJzqfuN1qLq1oL45o56cPaTXELwrTh8Fpggg==",
+      "license": "MIT"
+    },
     "node_modules/require-from-string": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
@@ -6410,6 +6471,30 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/tesseract.js": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/tesseract.js/-/tesseract.js-7.0.0.tgz",
+      "integrity": "sha512-exPBkd+z+wM1BuMkx/Bjv43OeLBxhL5kKWsz/9JY+DXcXdiBjiAch0V49QR3oAJqCaL5qURE0vx9Eo+G5YE7mA==",
+      "hasInstallScript": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "bmp-js": "^0.1.0",
+        "idb-keyval": "^6.2.0",
+        "is-url": "^1.2.4",
+        "node-fetch": "^2.6.9",
+        "opencollective-postinstall": "^2.0.3",
+        "regenerator-runtime": "^0.13.3",
+        "tesseract.js-core": "^7.0.0",
+        "wasm-feature-detect": "^1.8.0",
+        "zlibjs": "^0.3.1"
+      }
+    },
+    "node_modules/tesseract.js-core": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/tesseract.js-core/-/tesseract.js-core-7.0.0.tgz",
+      "integrity": "sha512-WnNH518NzmbSq9zgTPeoF8c+xmilS8rFIl1YKbk/ptuuc7p6cLNELNuPAzcmsYw450ca6bLa8j3t0VAtq435Vw==",
+      "license": "Apache-2.0"
+    },
     "node_modules/thread-stream": {
       "version": "3.2.0",
       "resolved": "https://registry.npmjs.org/thread-stream/-/thread-stream-3.2.0.tgz",
@@ -6511,6 +6596,12 @@
         "node": ">=0.6"
       }
     },
+    "node_modules/tr46": {
+      "version": "0.0.3",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
+      "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==",
+      "license": "MIT"
+    },
     "node_modules/ts-api-utils": {
       "version": "2.5.0",
       "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",
@@ -6907,6 +6998,28 @@
         "url": "https://github.com/sponsors/jonschlinkert"
       }
     },
+    "node_modules/wasm-feature-detect": {
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/wasm-feature-detect/-/wasm-feature-detect-1.9.0.tgz",
+      "integrity": "sha512-zonE+xlIIYtxPy++L24ow0hAD8CICb4+FgPyROd3buyXIqsJvUEDkBgfCCoXOd1Hu3DUr0GOfnPIdcGV+YpNaA==",
+      "license": "Apache-2.0"
+    },
+    "node_modules/webidl-conversions": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
+      "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==",
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/whatwg-url": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
+      "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==",
+      "license": "MIT",
+      "dependencies": {
+        "tr46": "~0.0.3",
+        "webidl-conversions": "^3.0.0"
+      }
+    },
     "node_modules/when-exit": {
       "version": "2.1.5",
       "resolved": "https://registry.npmjs.org/when-exit/-/when-exit-2.1.5.tgz",
@@ -7077,6 +7190,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/zlibjs": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/zlibjs/-/zlibjs-0.3.1.tgz",
+      "integrity": "sha512-+J9RrgTKOmlxFSDHo0pI1xM6BLVUv+o0ZT9ANtCxGkjIVCCUdx9alUF8Gm+dGLKbkkkidWIHFDZHDMpfITt4+w==",
+      "license": "MIT",
+      "engines": {
+        "node": "*"
+      }
+    },
     "node_modules/zod": {
       "version": "4.4.3",
       "resolved": "https://registry.npmjs.org/zod/-/zod-4.4.3.tgz",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hoi4-agent-tools",
   "mcpName": "io.github.klimPaskov/hoi4-agent-tools",
-  "version": "4.0.5",
+  "version": "4.1.0",
   "description": "Build HOI4 mods: focus trees, events, decisions, worlds, GUI previews, docs and AI balance.",
   "type": "module",
   "license": "Apache-2.0",
@@ -52,6 +52,7 @@
     "docs/focus.md",
     "docs/gui.md",
     "docs/map.md",
+    "docs/images/reference-maps/",
     "docs/reference.md",
     "docs/research/reference-benchmark.md",
     "docs/http.md",
@@ -119,12 +120,14 @@
     "@modelcontextprotocol/node": "2.1.1",
     "@modelcontextprotocol/sdk": "1.32.1",
     "@modelcontextprotocol/server": "2.3.1",
+    "@tesseract.js-data/eng": "1.0.0",
     "express": "5.2.1",
     "fontkit": "2.0.4",
     "glob": "13.0.6",
     "iconv-lite": "0.7.3",
     "jose": "6.2.8",
     "sharp": "0.35.5",
+    "tesseract.js": "7.0.0",
     "zod": "4.4.3"
   },
   "devDependencies": {

package/schemas/configuration.schema.json

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

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

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/continuous-focus-palette.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.1.0/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

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

package/schemas/decision-inspect-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/decision-inspect-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.1.0/schemas/decision-inspect-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/error-log-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.0.5/schemas/error-log-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v4.1.0/schemas/error-log-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {