hoi4-agent-tools 2.8.10 → 3.0.0

package/dist/hoi4_agent_tools/gui/scenario-generator.js

@@ -1,6 +1,16 @@
 import { sha256Bytes } from '../core/canonical.js';
 import { parsePreviewScenario } from './scenario.js';
 const countryNames = ['Germany', 'France', 'Poland', 'Italy', 'Brazil', 'India', 'Canada'];
+const countryTags = ['GER', 'FRA', 'POL', 'ITA', 'BRA', 'RAJ', 'CAN'];
+const countryIdeologies = [
+    'fascism',
+    'democratic',
+    'democratic',
+    'fascism',
+    'democratic',
+    'neutrality',
+    'democratic',
+];
 const countryAdjectives = [
     'German',
     'French',
@@ -447,6 +457,8 @@ function generatedRows(count, random, options) {
     return Array.from({ length: count }, (_unused, index) => {
         const countryIndex = (countryOffset + index) % countryNames.length;
         const name = countryNames[countryIndex];
+        const tag = countryTags[countryIndex];
+        const ideology = countryIdeologies[countryIndex];
         const value = generatedNumber(options, random);
         return {
             index: index + 1,
@@ -455,6 +467,12 @@ function generatedRows(count, random, options) {
             name,
             GetName: name,
             GetAdjective: countryAdjectives[countryIndex],
+            GetTag: tag,
+            tag,
+            countryTag: tag,
+            ideology,
+            countryIdeology: ideology,
+            countryScope: true,
             value,
             amount: value,
             percentage: Math.max(0, Math.min(100, value)),
@@ -532,6 +550,8 @@ export function generateGuiPreviewScenarios(graph, windowName, base, options) {
         const visibility = generatedVisibility(graph, scripted, options, random, base.visibility);
         const elementStates = { ...base.elementStates };
         const scopedCountries = new Map();
+        const generatedCountryIndex = random.integer(0, countryNames.length - 1);
+        const generatedCountryTag = countryTags[generatedCountryIndex];
         for (const key of tokens.numeric)
             setIfMissing(values, key, generatedNumberForKey(key, options, random, numericConstraints.ranges.get(key)));
         for (const [elementName, { minimum, maximum }] of progressRanges) {
@@ -580,6 +600,10 @@ export function generateGuiPreviewScenarios(graph, windowName, base, options) {
             for (const [key, template] of scriptedTextTemplates)
                 values[key] = materializeDynamicText(template, values);
         for (const key of imageTokens) {
+            if (/(?:^|\.)GetFlag$/u.test(key)) {
+                setIfMissing(values, key, generatedCountryTag);
+                continue;
+            }
             const sprite = scriptedLocalisationValue(graph, key, base.language, random, 'image', values);
             if (sprite !== undefined)
                 setIfMissing(values, key, sprite);
@@ -603,6 +627,18 @@ export function generateGuiPreviewScenarios(graph, windowName, base, options) {
             id: `${base.id}-${options.idPrefix}-${scenarioIndex + 1}`,
             description: `Generated source-aware scenario ${scenarioIndex + 1} (seed ${sourceSeed})`,
             values,
+            country: [...imageTokens].some((key) => /(?:^|\.)GetFlag$/u.test(key))
+                ? {
+                    GetName: countryNames[generatedCountryIndex],
+                    GetAdjective: countryAdjectives[generatedCountryIndex],
+                    GetTag: generatedCountryTag,
+                    tag: generatedCountryTag,
+                    countryTag: generatedCountryTag,
+                    ideology: countryIdeologies[generatedCountryIndex],
+                    countryIdeology: countryIdeologies[generatedCountryIndex],
+                    ...base.country,
+                }
+                : base.country,
             lists,
             visibility,
             elementStates,

package/dist/hoi4_agent_tools/gui/studio.js

@@ -241,7 +241,7 @@ function basenameFallbackPatterns(exactPaths, exactFiles) {
         .map(({ relativePath }) => relativePath.replaceAll('\\', '/').toLowerCase()));
     return [
         ...new Set(exactPaths
-            .filter((candidate) => !resolved.has(candidate.toLowerCase()))
+            .filter((candidate) => !/[*?[\]{}!]/u.test(candidate) && !resolved.has(candidate.toLowerCase()))
             .map((candidate) => `**/${path.posix.basename(candidate)}`)),
     ].sort((left, right) => compareCodeUnits(left, right));
 }
@@ -341,6 +341,22 @@ export function referencedAssetPatternsForWindow(graph, windowName, additionalSp
         if (textValues.has(localisation.key))
             textValues.add(localisation.value);
     }
+    const dynamicTextNames = new Set();
+    for (const value of textValues) {
+        for (const match of value.matchAll(/\[(?:\?[^\]]*\.)?([A-Za-z_][A-Za-z0-9_.:-]*)[^\]]*\]/gu)) {
+            const token = match[1];
+            if (token === undefined)
+                continue;
+            dynamicTextNames.add(token);
+            dynamicTextNames.add(token.slice(token.lastIndexOf('.') + 1));
+        }
+    }
+    const dynamicTextLocalisationKeys = new Set(graph.scriptedLocalisation
+        .filter(({ name }) => dynamicTextNames.has(name))
+        .flatMap(({ localisationKeys }) => localisationKeys));
+    for (const localisation of graph.localisation)
+        if (dynamicTextLocalisationKeys.has(localisation.key))
+            textValues.add(localisation.value);
     for (const value of textValues) {
         for (const token of localisationIconTokens(value)) {
             for (const candidate of localisationIconSpriteCandidates(token))
@@ -372,6 +388,12 @@ export function referencedAssetPatternsForWindow(graph, windowName, additionalSp
         const match = /^\[([^\]]+)\]$/u.exec(image);
         return match?.[1] === undefined ? [] : [match[1]];
     }));
+    const usesCountryFlags = graph.scriptedGuis
+        .filter(({ name }) => relatedScriptedGuiNames.has(name))
+        .flatMap(({ propertyDefinitions }) => propertyDefinitions)
+        .some(({ attributes }) => Object.entries(attributes).some(([key, value]) => key.toLocaleLowerCase('en-US') === 'image' &&
+        typeof value === 'string' &&
+        /(?:^|\.)GetFlag\]$/u.test(value)));
     for (const definition of graph.scriptedLocalisation) {
         if (!dynamicImageTokens.has(definition.name))
             continue;
@@ -417,17 +439,41 @@ export function referencedAssetPatternsForWindow(graph, windowName, additionalSp
             ...manifest.sourceFrames.map(({ path: framePath }) => framePath),
         ]),
     ];
-    return [...new Set(references.flatMap(referenceVariants))].sort((left, right) => compareCodeUnits(left, right));
-}
-function scenarioSpriteNames(scenarios) {
     return [
-        ...new Set(scenarios.flatMap(({ values, scriptedGui }) => Object.entries({ ...scriptedGui, ...values })
-            .filter(([key, value]) => typeof value === 'string' &&
-            value.startsWith('GFX_') &&
-            (key.endsWith('.image') || !key.includes('.')))
-            .map(([, value]) => value))),
+        ...new Set([
+            ...references.flatMap(referenceVariants),
+            ...(usesCountryFlags
+                ? [
+                    'gfx/flags/*.{bmp,dds,png,tga}',
+                    'gfx/flags/medium/*.{bmp,dds,png,tga}',
+                    'gfx/flags/small/*.{bmp,dds,png,tga}',
+                ]
+                : []),
+        ]),
     ].sort((left, right) => compareCodeUnits(left, right));
 }
+function scenarioSpriteNames(scenarios, additionalText = []) {
+    const sprites = new Set();
+    const pending = [...scenarios, ...additionalText];
+    while (pending.length > 0) {
+        const value = pending.pop();
+        if (typeof value === 'string') {
+            if (/^GFX_[A-Za-z0-9_.:+-]+$/u.test(value))
+                sprites.add(value);
+            for (const token of localisationIconTokens(value))
+                for (const candidate of localisationIconSpriteCandidates(token))
+                    sprites.add(candidate);
+            continue;
+        }
+        if (value === null || typeof value !== 'object')
+            continue;
+        if (Array.isArray(value))
+            pending.push(...value);
+        else
+            pending.push(...Object.values(value));
+    }
+    return [...sprites].sort((left, right) => compareCodeUnits(left, right));
+}
 function bmFontPagePatterns(files) {
     const references = files.flatMap((file) => {
         if (!file.relativePath.toLowerCase().endsWith('.fnt') || file.shadowedBy !== undefined)
@@ -570,6 +616,14 @@ function fullImage(render) {
         throw new Error('GUI render did not produce an image.');
     return image;
 }
+function visualSceneKey(scene) {
+    const { id: _id, description: _description, ...scenario } = scene.scenario;
+    return hashCanonical({
+        windowName: scene.windowName,
+        sourceRevision: scene.sourceRevision,
+        scenario,
+    });
+}
 export function guiArtifactProvenance(graph, kind, primaryScene, scenarioScenes = [primaryScene], metadata = {}) {
     const { scenario } = primaryScene;
     const sourceEvidence = boundedSourceHashEvidence(graph.sourceHashes);
@@ -657,7 +711,7 @@ export class ScriptedGuiStudio {
             graph: buildGuiSourceGraph(retainedFiles, this.engine.indexFiles(retainedFiles)),
         };
         this.#graphCache.set(key, scanned);
-        while (this.#graphCache.size > 8) {
+        while (this.#graphCache.size > 1) {
             const oldest = this.#graphCache.keys().next().value;
             if (oldest === undefined)
                 break;
@@ -665,6 +719,10 @@ export class ScriptedGuiStudio {
         }
         return scanned;
     }
+    /** Release parsed GUI graphs after a bounded batch job has finished using the studio. */
+    clearCaches() {
+        this.#graphCache.clear();
+    }
     async scan(workspaceId, principal, signal, languages = ['l_english']) {
         signal?.throwIfAborted();
         const workspace = this.resolver.get(workspaceId, principal);
@@ -746,10 +804,10 @@ export class ScriptedGuiStudio {
         input.signal?.throwIfAborted();
         const placeholderScenario = parsePreviewScenario(input.scenario);
         const explicitRelatedScenarios = (input.relatedScenarios ?? []).map(parsePreviewScenario);
-        const scanned = await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [placeholderScenario.language, ...explicitRelatedScenarios.map(({ language }) => language)], scenarioSpriteNames([placeholderScenario, ...explicitRelatedScenarios]));
         const generatedOptions = input.generatedScenarios === undefined
             ? undefined
             : parseGeneratedScenarioOptions(input.generatedScenarios);
+        const scanned = await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [placeholderScenario.language, ...explicitRelatedScenarios.map(({ language }) => language)], scenarioSpriteNames([placeholderScenario, ...explicitRelatedScenarios], generatedOptions?.textSamples));
         const generatedScenarios = generatedOptions === undefined
             ? []
             : generateGuiPreviewScenarios(scanned.graph, input.windowName, placeholderScenario, generatedOptions);
@@ -817,6 +875,9 @@ export class ScriptedGuiStudio {
         const requestedBaselineScenario = input.comparisonScenario === undefined
             ? undefined
             : parsePreviewScenario(input.comparisonScenario);
+        const generatedOptions = input.generatedScenarios === undefined
+            ? undefined
+            : parseGeneratedScenarioOptions(input.generatedScenarios);
         const scanned = await this.scanWindow(input.workspaceId, input.windowName, input.principal, input.signal, [
             placeholderScenario.language,
             ...(requestedBaselineScenario === undefined ? [] : [requestedBaselineScenario.language]),
@@ -825,10 +886,7 @@ export class ScriptedGuiStudio {
             placeholderScenario,
             ...(requestedBaselineScenario === undefined ? [] : [requestedBaselineScenario]),
             ...explicitRelatedScenarios,
-        ]));
-        const generatedOptions = input.generatedScenarios === undefined
-            ? undefined
-            : parseGeneratedScenarioOptions(input.generatedScenarios);
+        ], generatedOptions?.textSamples));
         const generatedScenarios = generatedOptions === undefined
             ? []
             : generateGuiPreviewScenarios(scanned.graph, input.windowName, placeholderScenario, generatedOptions);
@@ -846,6 +904,18 @@ export class ScriptedGuiStudio {
         const catalog = new GuiAssetCatalog(scanned.graph, scanned.files, budget, scenario.language);
         const scene = await buildGuiScene(scanned.graph, scanned.files, input.windowName, scenario, catalog);
         const render = await renderGuiScene(scene, undefined, input.signal, budget);
+        const fullRenderCache = new Map([
+            [visualSceneKey(scene), fullImage(render)],
+        ]);
+        const renderFull = async (target) => {
+            const key = visualSceneKey(target);
+            const cached = fullRenderCache.get(key);
+            if (cached !== undefined)
+                return cached;
+            const image = fullImage(await renderGuiScene(target, ['full'], input.signal, budget));
+            fullRenderCache.set(key, image);
+            return image;
+        };
         const scenarioScenes = [scene];
         const scenarioItems = [];
         for (const variantScenario of [scenario, ...relatedScenarios]) {
@@ -855,10 +925,7 @@ export class ScriptedGuiStudio {
                 : await buildGuiScene(scanned.graph, scanned.files, input.windowName, variantScenario, catalog);
             if (variantScene !== scene)
                 scenarioScenes.push(variantScene);
-            const variantRender = variantScene === scene
-                ? render
-                : await renderGuiScene(variantScene, ['full'], input.signal, new RenderBudget());
-            const image = fullImage(variantRender);
+            const image = variantScene === scene ? fullImage(render) : await renderFull(variantScene);
             scenarioItems.push({
                 label: variantScenario.description ?? variantScenario.id,
                 png: image.png,
@@ -873,8 +940,7 @@ export class ScriptedGuiStudio {
             const stateScenario = scenarioWith(scenario, { id: `${scenario.id}-${state}`, state });
             const stateScene = await buildGuiScene(scanned.graph, scanned.files, input.windowName, stateScenario, catalog);
             stateScenes.push(stateScene);
-            const stateRender = await renderGuiScene(stateScene, ['full'], input.signal, budget);
-            const image = fullImage(stateRender);
+            const image = await renderFull(stateScene);
             stateItems.push({ label: state, png: image.png, width: image.width, height: image.height });
         }
         const resolutionScenes = [];
@@ -895,8 +961,7 @@ export class ScriptedGuiStudio {
             });
             const resolutionScene = await buildGuiScene(scanned.graph, scanned.files, input.windowName, resolutionScenario, catalog);
             resolutionScenes.push(resolutionScene);
-            const resolutionRender = await renderGuiScene(resolutionScene, ['full'], input.signal, budget);
-            const image = fullImage(resolutionRender);
+            const image = await renderFull(resolutionScene);
             resolutionItems.push({
                 label: `${resolution.width}×${resolution.height} · UI ${uiScale}`,
                 png: image.png,
@@ -905,8 +970,8 @@ export class ScriptedGuiStudio {
             });
         }
         const baselineScene = await buildGuiScene(scanned.graph, scanned.files, input.windowName, baselineScenario, catalog);
-        const baselineRender = await renderGuiScene(baselineScene, ['full'], input.signal, budget);
-        const comparison = await compareGuiImages(fullImage(baselineRender).png, fullImage(render).png, budget, input.signal);
+        const baselineImage = await renderFull(baselineScene);
+        const comparison = await compareGuiImages(baselineImage.png, fullImage(render).png, budget, input.signal);
         const renderedSourceIds = [
             ...scenarioScenes,
             ...stateScenes,

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

@@ -391,7 +391,7 @@ export function registerGuiTools(server, engine, context) {
     });
     server.registerTool('hoi4.gui_render', {
         title: 'Render scripted GUI artifacts',
-        description: 'Render GUI states, resolutions, generated or explicit scenarios, hierarchy, comparisons, and diagnostics.',
+        description: 'Render GUI states, resolutions, generated or explicit scenarios, dynamic flags and text icons, hierarchy, comparisons, and diagnostics.',
         inputSchema: renderInput,
         outputSchema: guiRenderOutputSchema,
         annotations: artifactProducing,

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

@@ -19,7 +19,6 @@ const outputs = z.array(probabilityOutputSchema).max(10).optional();
 const commonShape = {
     workspaceId: workspaceIdSchema,
     adapter: probabilityAdapterIdSchema,
-    source: nestedSource,
     scenarioSet: nestedScenarios,
     candidatePool,
     horizonDays: z.number().positive().max(1_000_000).optional(),
@@ -34,21 +33,55 @@ const inspectInput = z
     workspaceId: workspaceIdSchema,
     adapter: probabilityAdapterIdSchema.optional(),
     source: nestedSource.optional(),
+    customPoolManifest: nestedManifest.optional(),
     candidatePool,
     refresh: z.boolean().optional(),
 })
     .strict()
     .superRefine((value, context) => {
-    if (value.adapter !== undefined && value.source === undefined)
+    if (value.source !== undefined && value.customPoolManifest !== undefined)
+        context.addIssue({
+            code: 'custom',
+            message: 'Provide either source or customPoolManifest',
+        });
+    if (value.adapter !== undefined &&
+        value.source === undefined &&
+        value.customPoolManifest === undefined)
         context.addIssue({
             code: 'custom',
             message: 'An adapter requires a source; provide a source alone to discover compatible adapters',
         });
+    if (value.customPoolManifest !== undefined && value.adapter !== 'custom_weighted_pool')
+        context.addIssue({
+            code: 'custom',
+            path: ['adapter'],
+            message: 'customPoolManifest requires adapter custom_weighted_pool',
+        });
+});
+const evaluateInput = z
+    .object({
+    ...commonShape,
+    source: nestedSource.optional(),
+    customPoolManifest: nestedManifest.optional(),
+})
+    .strict()
+    .superRefine((value, context) => {
+    if ((value.source === undefined) === (value.customPoolManifest === undefined))
+        context.addIssue({
+            code: 'custom',
+            message: 'Provide exactly one source or customPoolManifest',
+        });
+    if (value.customPoolManifest !== undefined && value.adapter !== 'custom_weighted_pool')
+        context.addIssue({
+            code: 'custom',
+            path: ['adapter'],
+            message: 'customPoolManifest requires adapter custom_weighted_pool',
+        });
 });
-const evaluateInput = z.object(commonShape).strict();
 const sweepInput = z
     .object({
     ...commonShape,
+    source: nestedSource,
     sweep: z
         .object({
         paths: z.array(z.string().min(1).max(1024)).min(1).max(32),
@@ -62,6 +95,7 @@ const sweepInput = z
 const simulateInput = z
     .object({
     ...commonShape,
+    source: nestedSource,
     samples: z.number().int().min(100).max(10_000_000).default(100_000),
     seed: z.number().int().min(-2_147_483_648).max(2_147_483_647).default(1),
     confidenceLevel: z.number().min(0.5).max(0.9999).default(0.95),
@@ -87,8 +121,10 @@ const compareInput = z
     .object({
     workspaceId: workspaceIdSchema,
     adapter: probabilityAdapterIdSchema,
-    before: nestedSource,
-    after: nestedSource,
+    before: nestedSource.optional(),
+    after: nestedSource.optional(),
+    beforeManifest: nestedManifest.optional(),
+    afterManifest: nestedManifest.optional(),
     scenarioSet: nestedScenarios,
     candidatePool,
     horizonDays: z.number().positive().max(1_000_000).optional(),
@@ -97,7 +133,29 @@ const compareInput = z
     outputs,
     refresh: z.boolean().optional(),
 })
-    .strict();
+    .strict()
+    .superRefine((value, context) => {
+    const sourceMode = value.before !== undefined || value.after !== undefined;
+    const manifestMode = value.beforeManifest !== undefined || value.afterManifest !== undefined;
+    if (sourceMode === manifestMode)
+        context.addIssue({
+            code: 'custom',
+            message: 'Compare either before/after sources or beforeManifest/afterManifest',
+        });
+    if (sourceMode && (value.before === undefined || value.after === undefined))
+        context.addIssue({ code: 'custom', message: 'Source comparison requires before and after' });
+    if (manifestMode && (value.beforeManifest === undefined || value.afterManifest === undefined))
+        context.addIssue({
+            code: 'custom',
+            message: 'Custom-pool comparison requires beforeManifest and afterManifest',
+        });
+    if (manifestMode && value.adapter !== 'custom_weighted_pool')
+        context.addIssue({
+            code: 'custom',
+            path: ['adapter'],
+            message: 'Manifest comparison requires adapter custom_weighted_pool',
+        });
+});
 const renderInput = z
     .object({
     workspaceId: workspaceIdSchema,
@@ -243,7 +301,7 @@ export function registerProbabilityTools(server, engine, context) {
     const analyzer = new ProbabilityAnalyzer(engine);
     server.registerTool('hoi4.probability_inspect', {
         title: 'Inspect AI and MTTH weighted logic',
-        description: 'List versioned adapters, or provide a source alone to discover compatible weighted adapters, candidate pools, capabilities, provenance, and unsupported constructs before narrowing the request.',
+        description: 'Discover weighted adapters, candidates, provenance, and required inputs.',
         inputSchema: inspectInput,
         outputSchema: inspectOutput,
         annotations: readOnly,
@@ -252,7 +310,7 @@ export function registerProbabilityTools(server, engine, context) {
         const base = await requestContext(engine, context, input.workspaceId, input.refresh, progress.signal);
         try {
             await progress.report(0, 2, 'Inspecting weighted source');
-            const inspected = await analyzer.inspect(base, input.adapter, input.source, input.candidatePool);
+            const inspected = await analyzer.inspect(base, input.adapter, input.source, input.candidatePool, input.customPoolManifest);
             const result = emptyServiceResult(base.workspaceId, {
                 adapters: inspected.adapters.length,
                 ...(inspected.surface === undefined
@@ -305,7 +363,7 @@ export function registerProbabilityTools(server, engine, context) {
     });
     server.registerTool('hoi4.probability_evaluate', {
         title: 'Evaluate AI and MTTH scenarios',
-        description: 'Evaluate eligibility, modifier traces, exact values, proven probabilities, MTTH timing, bounds, and unresolved inputs.',
+        description: 'Evaluate weights and probabilities under explicit scenarios.',
         inputSchema: evaluateInput,
         outputSchema: analysisOutput,
         annotations: readOnly,
@@ -329,7 +387,7 @@ export function registerProbabilityTools(server, engine, context) {
     });
     server.registerTool('hoi4.probability_sweep', {
         title: 'Sweep AI and MTTH parameters',
-        description: 'Evaluate declared ranges, sensitivity, breakpoints, and rank reversals without inventing world state.',
+        description: 'Evaluate declared ranges, breakpoints, and rank reversals.',
         inputSchema: sweepInput,
         outputSchema: analysisOutput,
         annotations: readOnly,
@@ -353,7 +411,7 @@ export function registerProbabilityTools(server, engine, context) {
     });
     server.registerTool('hoi4.probability_simulate', {
         title: 'Simulate uncertain weighted scenarios',
-        description: 'Run reproducible seeded Monte Carlo analysis with distributions, supported correlations, and confidence intervals.',
+        description: 'Run seeded simulations with distributions and confidence intervals.',
         inputSchema: simulateInput,
         outputSchema: analysisOutput,
         annotations: readOnly,
@@ -377,7 +435,7 @@ export function registerProbabilityTools(server, engine, context) {
     });
     server.registerTool('hoi4.probability_sequence', {
         title: 'Analyze a declared weighted sequence',
-        description: 'Analyze only manifest-declared recovery, caps, cooldowns, removals, resets, timers, and terminal states.',
+        description: 'Analyze a manifest-declared dynamic weighted sequence.',
         inputSchema: sequenceInput,
         outputSchema: analysisOutput,
         annotations: readOnly,
@@ -401,7 +459,7 @@ export function registerProbabilityTools(server, engine, context) {
     });
     server.registerTool('hoi4.probability_compare', {
         title: 'Compare weighted source patches',
-        description: 'Compare real or proposed source under identical scenarios with modifier, score, probability, timing, and rank attribution.',
+        description: 'Compare sources or declared pools under identical scenarios.',
         inputSchema: compareInput,
         outputSchema: analysisOutput,
         annotations: readOnly,
@@ -425,7 +483,7 @@ export function registerProbabilityTools(server, engine, context) {
     });
     server.registerTool('hoi4.probability_render', {
         title: 'Render AI and MTTH analysis',
-        description: 'Render cached analysis data as deterministic ranking, matrix, waterfall, timing, sensitivity, sequence, comparison, or unresolved resources.',
+        description: 'Render cached probability analysis as deterministic resources.',
         inputSchema: renderInput,
         outputSchema: analysisOutput,
         annotations: readOnly,

package/dist/hoi4_agent_tools/probability/sequence.js

@@ -465,22 +465,32 @@ function advance(state, manifest, selectedCandidates, unresolved) {
 }
 function initialState(manifest, scenario) {
     const candidateIds = new Set();
+    const state = {
+        day: 0,
+        step: 0,
+        values: { ...(manifest.state ?? {}), ...scenario.state },
+        candidates: [],
+        timerMinDays: manifest.selection.timerMinDays ?? 0,
+        timerMaxDays: manifest.selection.timerMaxDays ?? manifest.selection.timerMinDays ?? 0,
+        terminal: false,
+        selectedIds: [],
+        selectionDays: {},
+    };
     const candidates = manifest.candidates.map((candidate) => {
         if (candidateIds.has(candidate.id))
             throw new ServiceError('SEQUENCE_CANDIDATE_DUPLICATE', 'Custom pool candidate IDs must be unique', { id: candidate.id });
         candidateIds.add(candidate.id);
-        const weight = typeof candidate.weight === 'number' ? candidate.weight : Number(candidate.weight);
-        const cap = candidate.cap === undefined
-            ? undefined
-            : typeof candidate.cap === 'number'
-                ? candidate.cap
-                : Number(candidate.cap);
-        if (!Number.isFinite(weight) || (cap !== undefined && !Number.isFinite(cap)))
-            throw new ServiceError('SEQUENCE_INITIAL_VALUE_INVALID', 'Initial custom pool weights and caps must resolve numerically', { id: candidate.id });
+        const weight = numberExpression(candidate.weight, state);
+        const cap = candidate.cap === undefined ? undefined : numberExpression(candidate.cap, state);
+        if (weight === undefined ||
+            !Number.isFinite(weight) ||
+            (cap !== undefined && !Number.isFinite(cap)))
+            throw new ServiceError('SEQUENCE_INITIAL_VALUE_INVALID', 'Initial custom pool weights and caps must resolve from manifest or scenario state', { id: candidate.id });
+        const boundedWeight = cap === undefined ? weight : Math.min(weight, cap);
         return {
             id: candidate.id,
             ...(candidate.category === undefined ? {} : { category: candidate.category }),
-            weight: rounded(weight, manifest.selection.rounding),
+            weight: rounded(boundedWeight, manifest.selection.rounding),
             ...(cap === undefined ? {} : { cap: rounded(cap, manifest.selection.rounding) }),
             active: true,
             oneTime: candidate.oneTime ?? false,
@@ -488,16 +498,31 @@ function initialState(manifest, scenario) {
             cooldownUntil: 0,
         };
     });
+    state.candidates = candidates;
+    return state;
+}
+/** Evaluate one declared dynamic pool at the supplied scenario state before transitions run. */
+export function evaluateCustomPoolPoint(manifest, scenario) {
+    const state = initialState(manifest, scenario);
+    const unresolved = [];
+    const eligible = eligibleCandidates(state, manifest, unresolved);
+    const eligibleIds = new Set(eligible.map(({ id }) => id));
+    const poolTotal = eligible.reduce((sum, candidate) => sum + candidate.weight, 0);
     return {
-        day: 0,
-        step: 0,
-        values: { ...(manifest.state ?? {}), ...scenario.state },
-        candidates,
-        timerMinDays: manifest.selection.timerMinDays ?? 0,
-        timerMaxDays: manifest.selection.timerMaxDays ?? manifest.selection.timerMinDays ?? 0,
-        terminal: false,
-        selectedIds: [],
-        selectionDays: {},
+        candidates: state.candidates.map((candidate) => ({
+            id: candidate.id,
+            weight: candidate.weight,
+            eligible: eligibleIds.has(candidate.id),
+            probability: !eligibleIds.has(candidate.id)
+                ? 0
+                : manifest.selection.mode === 'categorical_weighted'
+                    ? poolTotal <= 0
+                        ? 0
+                        : candidate.weight / poolTotal
+                    : Math.max(0, Math.min(1, candidate.weight / 100)),
+        })),
+        poolTotal,
+        unresolved,
     };
 }
 function stateKey(state) {