@v12-engine/engine 0.1.0 → 0.4.0

package/dist/ai/rules.js

@@ -0,0 +1,416 @@
+import { defineModule } from "./module.js";
+//#region src/ai/rules.ts
+var inRange = (value, range, least = 1) => range.min === void 0 && range.max === void 0 ? value >= least : (range.min === void 0 || value >= range.min) && (range.max === void 0 || value <= range.max);
+/** A value at a path of dots in plain data (`'waves.next'`): the value itself for no path */
+function at(value, path) {
+	if (!path) return value;
+	let here = value;
+	for (const key of path.split(".")) {
+		if (!here || typeof here !== "object") return void 0;
+		here = here[key];
+	}
+	return here;
+}
+/** Whether a value is as asked: equal to `equals`, or a number within the range */
+var matches = (value, asked) => "equals" in asked ? value === asked.equals : typeof value === "number" && inRange(value, asked, -Infinity);
+/** Whose units: the brain's sets of them */
+function whose(ai, of, known) {
+	const { view } = ai;
+	if (of === "enemy") return known ? view.enemies.known() : view.enemies;
+	if (of === "ally") return view.allies;
+	return view.mine;
+}
+/** Narrowed to a type, a role, a tag */
+function kind(units, asked) {
+	let set = units;
+	if (asked.type !== void 0) set = set.ofType(asked.type);
+	if (asked.role !== void 0) set = set.withRole(asked.role);
+	if (asked.tag !== void 0) set = set.withTag(asked.tag);
+	return set;
+}
+/** Where a condition means: a named entity the player knows of, or a point; nothing for a name it does not know */
+function place(ai, near) {
+	if (typeof near !== "string") return near;
+	const named = ai.view.named(near);
+	if (named) return {
+		x: named.x,
+		z: named.z
+	};
+}
+/** Whether a point is near a place: a region by name, a named entity or a point within `reach` */
+function nearPlace(ai, point, near, reach) {
+	if (typeof near === "string" && ai.view.region(near)) return ai.view.inRegion(near, point);
+	const to = place(ai, near);
+	if (!to) return false;
+	const dx = point.x - to.x;
+	const dz = point.z - to.z;
+	return dx * dx + dz * dz <= reach * reach;
+}
+/**
+* Whether a condition holds for the brain now: a function is asked, data is read as its form says. A form the kit
+* does not know (a game's own not defined) is no, and the log says so once
+*
+* @beta
+*/
+function evaluate(condition, ai) {
+	if (typeof condition === "function") return !!condition(ai);
+	if (!condition || typeof condition !== "object") return false;
+	const { view } = ai;
+	if ("all" in condition) return condition.all.every((each) => evaluate(each, ai));
+	if ("any" in condition) return condition.any.some((each) => evaluate(each, ai));
+	if ("not" in condition) return !evaluate(condition.not, ai);
+	if ("resource" in condition) return inRange(view.me.resources[condition.resource.id] ?? 0, condition.resource, -Infinity);
+	if ("units" in condition) {
+		const asked = condition.units;
+		let set = kind(whose(ai, asked.of, asked.known), asked);
+		if (asked.finished) set = set.finished();
+		if (asked.near !== void 0) {
+			const near = asked.near;
+			const reach = asked.within ?? 16;
+			set = set.where((unit) => nearPlace(ai, unit, near, reach));
+		}
+		return inRange(set.length, asked);
+	}
+	if ("supply" in condition) {
+		const { me } = view;
+		const asked = condition.supply;
+		return (!asked.free || inRange(me.supplyCap - me.supplyUsed, asked.free, -Infinity)) && (!asked.used || inRange(me.supplyUsed, asked.used, -Infinity)) && (!asked.cap || inRange(me.supplyCap, asked.cap, -Infinity));
+	}
+	if ("time" in condition) {
+		const { after, before } = condition.time;
+		return (after === void 0 || ai.time >= after) && (before === void 0 || ai.time < before);
+	}
+	if ("underAttack" in condition) {
+		const asked = condition.underAttack === true ? {} : condition.underAttack;
+		const hits = ai.knowledge.events.damage(asked.seconds ?? 5).filter((hit) => hit.owner === ai.playerId);
+		if (asked.near === void 0) return hits.length > 0;
+		const near = asked.near;
+		return hits.some((hit) => nearPlace(ai, hit.at, near, asked.reach ?? 16));
+	}
+	if ("seen" in condition) {
+		const asked = condition.seen;
+		const since = asked.within === void 0 ? -Infinity : ai.tick - asked.within * ai.session.tickRate;
+		for (const [type, seen] of Object.entries(ai.knowledge.enemy.typesSeen())) {
+			if (seen.last < since) continue;
+			if (asked.type !== void 0 && type !== asked.type) continue;
+			if (asked.role !== void 0 && !view.hasRole(type, asked.role)) continue;
+			return true;
+		}
+		return false;
+	}
+	if ("difficulty" in condition) {
+		const playing = ai.profile.difficulty ?? "normal";
+		return Array.isArray(condition.difficulty) ? condition.difficulty.includes(playing) : condition.difficulty === playing;
+	}
+	if ("told" in condition) return ai.told(condition.told).length > 0;
+	if ("chance" in condition) return ai.rng.next() < condition.chance;
+	if ("hero" in condition) {
+		const asked = condition.hero;
+		return view.me.heroes.some((hero) => (asked.type === void 0 || hero.type === asked.type) && (asked.alive === void 0 || hero.alive === asked.alive) && (!asked.level || inRange(hero.level, asked.level, -Infinity)));
+	}
+	if ("wave" in condition) {
+		const waves = ai.made("waves");
+		return inRange(waves?.given ? waves.index : ai.knowledge.own.attacks().length, condition.wave, -Infinity);
+	}
+	if ("objective" in condition) {
+		const { id, status } = condition.objective;
+		const objective = view.me.objectives.find((each) => each.id === id);
+		return !!objective && (Array.isArray(status) ? status.includes(objective.status) : objective.status === status);
+	}
+	if ("report" in condition) return matches(at(view.report, condition.report.path), condition.report);
+	if ("component" in condition) {
+		const asked = condition.component;
+		const entity = asked.entity !== void 0 ? view.named(asked.entity) : asked.type !== void 0 ? view.mine.ofType(asked.type).first() : void 0;
+		return !!entity && matches(at(entity.components?.[asked.id], asked.path), asked);
+	}
+	if ("region" in condition) {
+		const asked = condition.region;
+		if (!view.region(asked.name)) return false;
+		return inRange(kind(whose(ai, asked.of), asked).where((unit) => view.inRegion(asked.name, unit)).length, asked);
+	}
+	if ("is" in condition) {
+		const { is, args = {} } = condition;
+		const own = ai.def.conditions?.[is] ?? ai.registry.module?.ai?.conditions?.[is];
+		if (!own) {
+			warnOnce(ai, `a condition names "${is}", which neither the game nor the brain has (GameAi.conditions, BrainDef.conditions): it is no`);
+			return false;
+		}
+		return !!own(ai, args);
+	}
+	warnOnce(ai, `a condition of no form the kit knows (${Object.keys(condition).join(", ")}): it is no`);
+	return false;
+}
+var warned = /* @__PURE__ */ new WeakMap();
+function warnOnce(ai, line) {
+	let said = warned.get(ai);
+	if (!said) warned.set(ai, said = /* @__PURE__ */ new Set());
+	if (said.has(line)) return;
+	said.add(line);
+	ai.log.warn("ai", line);
+}
+function builder(rule) {
+	return {
+		once: () => builder({
+			...rule,
+			once: true
+		}),
+		every: (seconds) => builder({
+			...rule,
+			every: seconds
+		}),
+		priority: (n) => builder({
+			...rule,
+			priority: n
+		}),
+		named: (id) => builder({
+			...rule,
+			id
+		}),
+		do: (action) => ({
+			...rule,
+			action
+		})
+	};
+}
+/**
+* A rule: `when(condition).do(action)`, with `once()`, `every(seconds)`, `priority(n)`, `named(id)` between. The
+* condition is a function of the brain or plain data (`AiCondition`). `when.told(word)` fires once for each time the
+* word is told, taking it, its action given the word's data
+*
+* @beta
+*/
+var when = Object.assign((condition) => builder({ when: condition }), { 
+/** A rule that fires for each time the game tells the brain this word (`world.computers.tell`), and takes it */
+told: (word) => builder({ when: { word } }) });
+var isWord = (when) => typeof when === "object" && when !== null && "word" in when && typeof when.word === "string" && Object.keys(when).length === 1;
+/** Does a rule's action */
+function act(ai, action, data) {
+	if (typeof action === "function") action(ai, data);
+	else ai.tell(action.say, action.data, ai.tick);
+}
+/**
+* The rules module: checks its rules each think, in their order (by `priority`, then as given), and does each one's
+* action as its condition turns true. Ahead of the modules that act on units, where a brain lists it: what a rule
+* takes is then not given orders by them first. Its id is `rules` (give `id` for a second one)
+*
+* @beta
+*/
+var rules = (list, options = {}) => defineModule({
+	id: options.id ?? "rules",
+	make: (ai) => {
+		const named = list.map((rule, i) => ({
+			...rule,
+			id: rule.id ?? `rule ${i + 1}`
+		}));
+		const seen = /* @__PURE__ */ new Set();
+		for (const rule of named) {
+			if (seen.has(rule.id)) throw new Error(`The brain "${ai.def.id}" has two rules called "${rule.id}"`);
+			seen.add(rule.id);
+		}
+		const ordered = named.map((rule, i) => ({
+			rule,
+			i
+		})).sort((a, b) => (b.rule.priority ?? 0) - (a.rule.priority ?? 0) || a.i - b.i);
+		let memory = {};
+		const of = (id) => memory[id] ??= { count: 0 };
+		const fire = (rule, data, word) => {
+			const kept = of(rule.id);
+			kept.fired = ai.tick;
+			kept.count++;
+			ai.decide(`rule "${rule.id}" fires${word ? `: told "${word.word}"` : ""}`, { kind: "rule" });
+			act(ai, rule.action, data);
+		};
+		return {
+			id: options.id ?? "rules",
+			phase: "hear",
+			version: 1,
+			think: () => {
+				for (const { rule } of ordered) {
+					const kept = of(rule.id);
+					if (rule.once && kept.count > 0) continue;
+					if (isWord(rule.when)) {
+						const words = ai.takeTold(rule.when.word, rule.once ? 1 : Infinity);
+						for (const word of words) fire(rule, word.data, word);
+						kept.was = words.length > 0;
+						continue;
+					}
+					const holds = evaluate(rule.when, ai);
+					const turned = holds && !kept.was;
+					kept.was = holds;
+					if (!holds) continue;
+					const again = rule.every !== void 0 && kept.fired !== void 0 && ai.tick - kept.fired >= Math.round(rule.every * ai.session.tickRate);
+					if (turned || again) fire(rule);
+				}
+			},
+			save: () => structuredClone(memory),
+			restore: (data) => {
+				memory = data && typeof data === "object" ? structuredClone(data) : {};
+			},
+			inspect: () => ({
+				rules: ordered.map(({ rule }) => {
+					const kept = of(rule.id);
+					return {
+						id: rule.id,
+						priority: rule.priority ?? 0,
+						once: !!rule.once,
+						holds: !!kept.was,
+						count: kept.count,
+						...kept.fired !== void 0 && { fired: kept.fired }
+					};
+				}),
+				...Object.keys(ai.goals.taken()).length && { taken: Object.fromEntries(Object.entries(ai.goals.taken()).map(([id, hold]) => [id, {
+					units: hold.units.length,
+					until: hold.until
+				}])) }
+			})
+		};
+	}
+});
+/** The squad the words put the army in, owned by the word's hold (`word:attack`) */
+var WORD_SQUAD = "word";
+/** The seconds each word holds the army for, where its data says none */
+var WORD_SECONDS = {
+	attack: 60,
+	defend: 30,
+	retreat: 15,
+	hold: 30
+};
+/**
+* The words module: answers the words any brain may be told (`world.computers.tell(player, word, data)`), taking them:
+*
+* - `attack` `{ at?, seconds? }`: the army (its fighters) attacks there, fighting what it meets on the way; where no
+*   place is given, at the nearest building of a rival's it knows of, else at the first rival's base the seat was told
+*   (`AiOptions.enemyBases`).
+* - `defend` `{ at?, seconds? }`: the army goes to fight there, home when left out.
+* - `retreat` `{ seconds? }`: the army comes home, fighting nothing on the way.
+* - `hold` `{ seconds? }`: the army stands where it is, fighting what comes in reach.
+* - `pause`: the brain sits still until told `resume` (or `world.computers.resume`); `resume` the brain answers itself.
+*
+* The army goes as one squad on the kit's task of the word (`attack`, `defend`, `retreat`, `hold`, in the squad
+* `word`), so that where the brain has the `squads()` module it regroups, focuses, kites and falls back on the odds as
+* any squad does. The army is the word's for `seconds` (attack 60, defend 30, retreat 15, hold 30): no goal claims it
+* meanwhile, then the squad goes and the goals have it again. Its id is `words`; put it after `rules`, so that a rule's `{ say }` is answered that think
+*
+* @beta
+*/
+var words = () => defineModule({
+	id: "words",
+	make: (ai) => {
+		const army = () => ai.view.mine.fighters().alive();
+		const point = (at) => {
+			if (at === void 0) return void 0;
+			if (typeof at !== "string") return at;
+			const named = ai.view.named(at);
+			if (named) return {
+				x: named.x,
+				z: named.z
+			};
+			const region = ai.view.region(at);
+			if (region) return {
+				x: region.shape.x,
+				z: region.shape.z
+			};
+		};
+		/**
+		* The army on the word's task: `plan` says what it does (`undefined`: nothing to do), and puts the squad on it.
+		* The army is a squad of the word's hold (`word:<word>`), so the squads module regroups, focuses, kites and falls
+		* back for it; when the hold lapses, the squad goes and the goals have the army again
+		*/
+		const order = (word, data, plan) => {
+			const units = army();
+			if (!units.length) {
+				ai.decide(`told "${word}", with no army to do it`, { kind: "word" });
+				return;
+			}
+			const ids = units.map((unit) => unit.id);
+			const planned = plan(ids);
+			if (planned === void 0) return;
+			const owner = `word:${word}`;
+			ai.goals.take(ids, "told", {
+				id: owner,
+				seconds: data.seconds ?? WORD_SECONDS[word]
+			});
+			for (const other of Object.keys(WORD_SECONDS)) if (other !== word) ai.goals.release(`word:${other}`);
+			planned.give(ai.squads.make(WORD_SQUAD, ids, { owner }));
+			ai.decide(`told "${word}": ${planned.what}`, { kind: "word" });
+		};
+		return {
+			id: "words",
+			phase: "hear",
+			after: ["rules"],
+			think: () => {
+				for (const told of [...ai.told()]) {
+					const data = told.data && typeof told.data === "object" ? told.data : {};
+					switch (told.word) {
+						case "attack":
+							ai.takeTold("attack");
+							order("attack", data, (ids) => {
+								const centre = ai.view.mine.where((unit) => ids.includes(unit.id)).centre();
+								const target = point(data.at) ?? (centre && ai.view.enemies.known().buildings().nearest(centre)) ?? ai.options.enemyBases?.[0];
+								if (!target) {
+									ai.decide("told \"attack\", and knows of nowhere to attack", { kind: "word" });
+									return;
+								}
+								const at = {
+									x: target.x,
+									z: target.z
+								};
+								return {
+									what: `the army of ${ids.length} attacks at (${Math.round(target.x)}, ${Math.round(target.z)})`,
+									give: (squad) => squad.attack(at)
+								};
+							});
+							break;
+						case "defend":
+							ai.takeTold("defend");
+							order("defend", data, (ids) => {
+								const home = ai.view.home();
+								const target = point(data.at) ?? (home && {
+									x: home.x,
+									z: home.z
+								});
+								if (!target) return void 0;
+								return {
+									what: `the army of ${ids.length} goes to fight at (${Math.round(target.x)}, ${Math.round(target.z)})`,
+									give: (squad) => squad.defend(target)
+								};
+							});
+							break;
+						case "retreat":
+							ai.takeTold("retreat");
+							order("retreat", data, (ids) => {
+								const home = ai.view.home();
+								if (!home) return void 0;
+								const at = {
+									x: home.x,
+									z: home.z
+								};
+								return {
+									what: `the army of ${ids.length} comes home`,
+									give: (squad) => squad.retreat(at, "told to")
+								};
+							});
+							break;
+						case "hold":
+							ai.takeTold("hold");
+							order("hold", data, (ids) => {
+								return {
+									what: `the army of ${ids.length} holds where it stands`,
+									give: (squad) => squad.task("hold", {})
+								};
+							});
+							break;
+						case "pause":
+							ai.takeTold("pause");
+							ai.paused = true;
+							ai.decide("told \"pause\": sits still until told \"resume\"", { kind: "word" });
+					}
+				}
+			}
+		};
+	}
+});
+//#endregion
+export { evaluate, rules, when, words };
+
+//# sourceMappingURL=rules.js.map

package/dist/ai/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","names":[],"sources":["../../src/ai/rules.ts"],"sourcesContent":["import type { Vec2 } from '#engine/math'\nimport type { Waves } from './waves'\nimport type { ObjectiveStatus } from '#engine/objectives'\nimport type { EntityState } from '#engine/session/protocol'\nimport { type Brain, type Told } from './brain'\nimport { type AiModule, type AiModuleDef, defineModule } from './module'\nimport type { AiRole } from './roles'\nimport type { UnitSet } from './view'\nimport type { Squad } from './squads'\n\n/*\n * Rules and words from the game (AI plan, B2): what a mission scripts for its computer player, in the computer's own\n * terms. Before this, a mission that wanted \"when the hero crosses the river, the camp attacks\" wrote a system that\n * reached into the world and gave orders to the computer's units beside the computer that thought on its own, and the\n * two fought over them. Now it is a rule of the brain's:\n *\n *   when({ units: { role: 'hero', of: 'enemy', near: 'the ford' } }).once().do((ai) => ai.tell('attack', { at: ford }))\n *\n * - **A condition** (`AiCondition`) is a question with a yes or no: a function of the brain, or plain data (`{ time: {\n *   after: 300 } }`, `{ all: [...] }`) that a map's file, a mission's JSON, and later the editor can hold. The data\n *   forms are listed in `docs/ai/scripting.md`, each with what it asks; a game adds its own (`GameAi.conditions`, a brain's `BrainDef.conditions`) and names it\n *   (`{ is: 'mygame.bridgeDown', args: { name: 'north' } }`). Waves, build orders and target priorities (B3, C2, D2) take the same conditions.\n * - **A rule** (`when(condition).do(action)`) does its action when its condition becomes true: on the think it turns\n *   from no to yes, not on every think it stays yes (a trigger, as a map editor's are). `once()` fires it the first\n *   time only, ever; `every(seconds)` fires it again while the condition holds, at most so often; `priority(n)` checks\n *   it before rules of less. Rules are a module (`rules([...])`), checked each think in order: put it ahead of the\n *   modules that act, so that what a rule takes is not given orders by them first.\n * - **Words** are what the game tells a computer (`world.computers.tell(player, 'attack', { at })`): kept in the brain\n *   until taken (a save keeps a word not yet heard), read with `ai.told(word)`, taken by a told rule (`when.told(word)`,\n *   whose action gets the word's data) or by the `words()` module, which answers the words every brain may be told:\n *   `attack`, `defend`, `retreat`, `hold`, `pause` (and `resume`, which the brain answers itself, paused as it is).\n * - **Who may move a unit.** A rule that orders units takes them first (`ai.goals.take(ids, 'told', { id, seconds })`):\n *   no goal claims them while the rule holds them, and the melee player's focus fire leaves them be. What a rule took\n *   is let go of when its time is up, and the goals have them again.\n *\n * What the rules remember (which fired, when, and whether each held at the last check) is plain data in the brain's\n * memory, so a loaded game does not fire a `once` rule twice.\n */\n\n/**\n * At least `min` and at most `max`, each left out for no bound: a count, an amount, a level\n *\n * @beta\n */\nexport interface AiRange {\n\t/** The lowest it may be; no lower bound when left out */\n\tmin?: number\n\t/** The highest it may be; no upper bound when left out */\n\tmax?: number\n}\n\n/**\n * Whose units a condition counts: the player’s own (the default), its rivals’ in sight, its allies’\n *\n * @beta\n */\nexport type AiWhose = 'mine' | 'enemy' | 'ally'\n\n/**\n * A condition as plain data: what a map's file, a mission's JSON or the editor holds. Each form is one question; the\n * table in `docs/ai/scripting.md` says what each asks\n *\n * @beta\n */\nexport type AiConditionData =\n\t/** Every one of them */\n\t| { all: AiCondition[] }\n\t/** One of them at least */\n\t| { any: AiCondition[] }\n\t/** The other way round */\n\t| { not: AiCondition }\n\t/** How much it has of a resource */\n\t| { resource: { id: string } & AiRange }\n\t/**\n\t * How many units there are, of a type, a role or a tag, whose (`of`), near a named entity, point or region (`near`,\n\t * `within`), finished only (`finished`); and for `of: 'enemy'`, those remembered out of sight too (`known`). At\n\t * least one where neither `min` nor `max` is given\n\t */\n\t| {\n\t\t\tunits: {\n\t\t\t\ttype?: string\n\t\t\t\trole?: AiRole\n\t\t\t\ttag?: string\n\t\t\t\tof?: AiWhose\n\t\t\t\tnear?: string | Vec2\n\t\t\t\twithin?: number\n\t\t\t\tfinished?: boolean\n\t\t\t\tknown?: boolean\n\t\t\t} & AiRange\n\t  }\n\t/** Its supply: free (cap less used), used, cap */\n\t| { supply: { free?: AiRange; used?: AiRange; cap?: AiRange } }\n\t/** Seconds into the game: from `after`, before `before` */\n\t| { time: { after?: number; before?: number } }\n\t/**\n\t * Whether its own are being hit: damage seen to its entities within so many seconds (5 when left out), anywhere, or\n\t * near a named entity, a point or a region (`near`, `within` the reach: 16)\n\t */\n\t| { underAttack: true | { seconds?: number; near?: string | Vec2; reach?: number } }\n\t/** Whether a rival's unit of a type or a role was seen, within so many seconds where given (ever, when left out) */\n\t| { seen: { type?: string; role?: AiRole; within?: number } }\n\t/** The difficulty it plays on (its profile's: `AiOptions.difficulty`, normal when left out), one or any of a list */\n\t| { difficulty: string | string[] }\n\t/** Whether the game told it this word and nothing took it yet */\n\t| { told: string }\n\t/** Yes so often, by the brain's own numbers (`ai.rng`): `0.3` is three times in ten. The same game says the same */\n\t| { chance: number }\n\t/** Its heroes: one at least of this type (any where left out), alive where `alive` says, of a level */\n\t| { hero: { type?: string; alive?: boolean; level?: AiRange } }\n\t/** The index of the wave whose turn it is (`ai.waves.index`, the waves sent and skipped before it); where it has no waves, the attacks it sent (its knowledge's `own.attacks`) */\n\t| { wave: AiRange }\n\t/** One of its own objectives, by id, in this status (or any of these) */\n\t| { objective: { id: string; status: ObjectiveStatus | ObjectiveStatus[] } }\n\t/** A value of the game's report to this player (`Rules.report`), by its path (`'waves.next'`): equal to, or within */\n\t| { report: { path: string; equals?: unknown } & AiRange }\n\t/**\n\t * A value of a component the game replicates to this player (`Component.replicate`) on an entity: one the map or\n\t * the rules named (`entity`), or the first of its own of a type (`type`). By path in it, where it is an object\n\t */\n\t| { component: { id: string; entity?: string; type?: string; path?: string; equals?: unknown } & AiRange }\n\t/** How many units are in a region of the map, whose (`of`: its own when left out), of a type or a role */\n\t| { region: { name: string; of?: AiWhose; type?: string; role?: AiRole } & AiRange }\n\t/** A condition of the game's own or the brain's (`GameAi.conditions`, `BrainDef.conditions`), by id, with its arguments (`{ is: 'mygame.bridge', args: { name: 'north' } }`) */\n\t| { is: string; args?: Record<string, unknown> }\n\n/**\n * A condition: a question with a yes or no, as a function of the brain, or as plain data (`AiConditionData`)\n *\n * @beta\n */\nexport type AiCondition = ((ai: Brain) => boolean) | AiConditionData\n\n/**\n * A condition of a game's own or a brain's, for the data form (`{ is: id, args }`): a map's file names it, the game\n * (`GameAi.conditions`) or the brain (`BrainDef.conditions`) gives the code, by an id prefixed as components are\n * (`mygame.bridgeDown`)\n *\n * @beta\n */\nexport type AiConditionTest = (ai: Brain, args: Record<string, unknown>) => boolean\n\nconst inRange = (value: number, range: AiRange, least = 1) =>\n\trange.min === undefined && range.max === undefined\n\t\t? value >= least\n\t\t: (range.min === undefined || value >= range.min) && (range.max === undefined || value <= range.max)\n\n/** A value at a path of dots in plain data (`'waves.next'`): the value itself for no path */\nfunction at(value: unknown, path: string | undefined): unknown {\n\tif (!path) return value\n\tlet here = value\n\tfor (const key of path.split('.')) {\n\t\tif (!here || typeof here !== 'object') return undefined\n\t\there = (here as Record<string, unknown>)[key]\n\t}\n\treturn here\n}\n\n/** Whether a value is as asked: equal to `equals`, or a number within the range */\nconst matches = (value: unknown, asked: { equals?: unknown } & AiRange) =>\n\t'equals' in asked ? value === asked.equals : typeof value === 'number' && inRange(value, asked, -Infinity)\n\n/** Whose units: the brain's sets of them */\nfunction whose(ai: Brain, of: AiWhose | undefined, known?: boolean): UnitSet {\n\tconst { view } = ai\n\tif (of === 'enemy') return known ? view.enemies.known() : view.enemies\n\tif (of === 'ally') return view.allies\n\treturn view.mine\n}\n\n/** Narrowed to a type, a role, a tag */\nfunction kind(units: UnitSet, asked: { type?: string; role?: AiRole; tag?: string }): UnitSet {\n\tlet set = units\n\tif (asked.type !== undefined) set = set.ofType(asked.type)\n\tif (asked.role !== undefined) set = set.withRole(asked.role)\n\tif (asked.tag !== undefined) set = set.withTag(asked.tag)\n\treturn set\n}\n\n/** Where a condition means: a named entity the player knows of, or a point; nothing for a name it does not know */\nfunction place(ai: Brain, near: string | Vec2): Vec2 | undefined {\n\tif (typeof near !== 'string') return near\n\tconst named = ai.view.named(near)\n\tif (named) return { x: named.x, z: named.z }\n\treturn undefined\n}\n\n/** Whether a point is near a place: a region by name, a named entity or a point within `reach` */\nfunction nearPlace(ai: Brain, point: Vec2, near: string | Vec2, reach: number): boolean {\n\tif (typeof near === 'string' && ai.view.region(near)) return ai.view.inRegion(near, point)\n\tconst to = place(ai, near)\n\tif (!to) return false\n\tconst dx = point.x - to.x\n\tconst dz = point.z - to.z\n\treturn dx * dx + dz * dz <= reach * reach\n}\n\n/**\n * Whether a condition holds for the brain now: a function is asked, data is read as its form says. A form the kit\n * does not know (a game's own not defined) is no, and the log says so once\n *\n * @beta\n */\nexport function evaluate(condition: AiCondition, ai: Brain): boolean {\n\tif (typeof condition === 'function') return !!condition(ai)\n\tif (!condition || typeof condition !== 'object') return false\n\tconst { view } = ai\n\tif ('all' in condition) return condition.all.every((each) => evaluate(each, ai))\n\tif ('any' in condition) return condition.any.some((each) => evaluate(each, ai))\n\tif ('not' in condition) return !evaluate(condition.not, ai)\n\tif ('resource' in condition) return inRange(view.me.resources[condition.resource.id] ?? 0, condition.resource, -Infinity)\n\tif ('units' in condition) {\n\t\tconst asked = condition.units\n\t\tlet set = kind(whose(ai, asked.of, asked.known), asked)\n\t\tif (asked.finished) set = set.finished()\n\t\tif (asked.near !== undefined) {\n\t\t\tconst near = asked.near\n\t\t\tconst reach = asked.within ?? 16\n\t\t\tset = set.where((unit) => nearPlace(ai, unit, near, reach))\n\t\t}\n\t\treturn inRange(set.length, asked)\n\t}\n\tif ('supply' in condition) {\n\t\tconst { me } = view\n\t\tconst asked = condition.supply\n\t\treturn (\n\t\t\t(!asked.free || inRange(me.supplyCap - me.supplyUsed, asked.free, -Infinity)) &&\n\t\t\t(!asked.used || inRange(me.supplyUsed, asked.used, -Infinity)) &&\n\t\t\t(!asked.cap || inRange(me.supplyCap, asked.cap, -Infinity))\n\t\t)\n\t}\n\tif ('time' in condition) {\n\t\tconst { after, before } = condition.time\n\t\treturn (after === undefined || ai.time >= after) && (before === undefined || ai.time < before)\n\t}\n\tif ('underAttack' in condition) {\n\t\tconst asked = condition.underAttack === true ? {} : condition.underAttack\n\t\tconst hits = ai.knowledge.events.damage(asked.seconds ?? 5).filter((hit) => hit.owner === ai.playerId)\n\t\tif (asked.near === undefined) return hits.length > 0\n\t\tconst near = asked.near\n\t\treturn hits.some((hit) => nearPlace(ai, hit.at, near, asked.reach ?? 16))\n\t}\n\tif ('seen' in condition) {\n\t\tconst asked = condition.seen\n\t\tconst since = asked.within === undefined ? -Infinity : ai.tick - asked.within * ai.session.tickRate\n\t\tfor (const [type, seen] of Object.entries(ai.knowledge.enemy.typesSeen())) {\n\t\t\tif (seen.last < since) continue\n\t\t\tif (asked.type !== undefined && type !== asked.type) continue\n\t\t\tif (asked.role !== undefined && !view.hasRole(type, asked.role)) continue\n\t\t\treturn true\n\t\t}\n\t\treturn false\n\t}\n\tif ('difficulty' in condition) {\n\t\tconst playing = ai.profile.difficulty ?? 'normal'\n\t\treturn Array.isArray(condition.difficulty) ? condition.difficulty.includes(playing) : condition.difficulty === playing\n\t}\n\tif ('told' in condition) return ai.told(condition.told).length > 0\n\tif ('chance' in condition) return ai.rng.next() < condition.chance\n\tif ('hero' in condition) {\n\t\tconst asked = condition.hero\n\t\treturn view.me.heroes.some(\n\t\t\t(hero) =>\n\t\t\t\t(asked.type === undefined || hero.type === asked.type) &&\n\t\t\t\t(asked.alive === undefined || hero.alive === asked.alive) &&\n\t\t\t\t(!asked.level || inRange(hero.level, asked.level, -Infinity))\n\t\t)\n\t}\n\t// the index of the wave whose turn it is, where the brain has waves (D2); else the attacks it sent\n\tif ('wave' in condition) {\n\t\t// the waves it was given, where it has any, else the attacks it made\n\t\tconst waves = ai.made<Waves>('waves')\n\t\treturn inRange(waves?.given ? waves.index : ai.knowledge.own.attacks().length, condition.wave, -Infinity)\n\t}\n\tif ('objective' in condition) {\n\t\tconst { id, status } = condition.objective\n\t\tconst objective = view.me.objectives.find((each) => each.id === id)\n\t\treturn !!objective && (Array.isArray(status) ? status.includes(objective.status) : objective.status === status)\n\t}\n\tif ('report' in condition) return matches(at(view.report, condition.report.path), condition.report)\n\tif ('component' in condition) {\n\t\tconst asked = condition.component\n\t\tconst entity: EntityState | undefined =\n\t\t\tasked.entity !== undefined ? view.named(asked.entity) : asked.type !== undefined ? view.mine.ofType(asked.type).first() : undefined\n\t\treturn !!entity && matches(at(entity.components?.[asked.id], asked.path), asked)\n\t}\n\tif ('region' in condition) {\n\t\tconst asked = condition.region\n\t\tif (!view.region(asked.name)) return false\n\t\tconst set = kind(whose(ai, asked.of), asked).where((unit) => view.inRegion(asked.name, unit))\n\t\treturn inRange(set.length, asked)\n\t}\n\tif ('is' in condition) {\n\t\tconst { is, args = {} } = condition\n\t\tconst own = ai.def.conditions?.[is] ?? ai.registry.module?.ai?.conditions?.[is]\n\t\tif (!own) {\n\t\t\twarnOnce(ai, `a condition names \"${is}\", which neither the game nor the brain has (GameAi.conditions, BrainDef.conditions): it is no`)\n\t\t\treturn false\n\t\t}\n\t\treturn !!own(ai, args)\n\t}\n\twarnOnce(ai, `a condition of no form the kit knows (${Object.keys(condition).join(', ')}): it is no`)\n\treturn false\n}\n\nconst warned = new WeakMap<Brain, Set<string>>()\nfunction warnOnce(ai: Brain, line: string): void {\n\tlet said = warned.get(ai)\n\tif (!said) warned.set(ai, (said = new Set()))\n\tif (said.has(line)) return\n\tsaid.add(line)\n\tai.log.warn('ai', line)\n}\n\n/**\n * What a rule does, as plain data: a word the brain tells itself (`{ say: 'attack', data: { at } }`), answered by the\n * `words()` module or a told rule of its own, the same think where they come after the rules\n *\n * @beta\n */\nexport interface AiActionData {\n\t/** The word the brain tells itself, which the `words()` module or a rule of its own answers */\n\tsay: string\n\t/** What goes with the word, for whoever answers it; nothing when left out */\n\tdata?: unknown\n}\n\n/**\n * What a rule does: a function of the brain and, for a told rule, what came with the word; or plain data\n * (`AiActionData`)\n *\n * @beta\n */\nexport type AiAction = ((ai: Brain, data?: unknown) => void) | AiActionData\n\n/**\n * A rule of a brain (`when(condition).do(action)`): checked each think by the `rules()` module, its action done as\n * its condition becomes true. Code: given again by the brain's definition, as goals are; what it remembers is data\n *\n * @beta\n */\nexport interface AiRule {\n\t/** Its name: what the memory, the report and the log know it by. `rule 1`, `rule 2`… in the module's list when left out */\n\treadonly id?: string\n\t/** When it fires: a condition, or a word told (`when.told`) */\n\treadonly when: AiCondition | { word: string }\n\t/** What it does */\n\treadonly action: AiAction\n\t/** Whether it fires the first time only, ever */\n\treadonly once?: boolean\n\t/** Seconds: fired again while its condition holds, at most so often. Left out, it fires as it turns true */\n\treadonly every?: number\n\t/** Checked before rules of less: 0 when left out */\n\treadonly priority?: number\n}\n\n/**\n * A rule being written: `when(...)`, then any of `once`, `every`, `priority`, `named`, then `do`\n *\n * @beta\n */\nexport interface RuleBuilder {\n\t/** Fires the first time only, ever */\n\tonce(): RuleBuilder\n\t/** Fires again while the condition holds, at most every so many seconds */\n\tevery(seconds: number): RuleBuilder\n\t/** Checked before rules of less */\n\tpriority(n: number): RuleBuilder\n\t/** Its name, for the memory, the report and the log */\n\tnamed(id: string): RuleBuilder\n\t/** What it does: the rule */\n\tdo(action: AiAction): AiRule\n}\n\nfunction builder(rule: Omit<AiRule, 'action'>): RuleBuilder {\n\treturn {\n\t\tonce: () => builder({ ...rule, once: true }),\n\t\tevery: (seconds) => builder({ ...rule, every: seconds }),\n\t\tpriority: (n) => builder({ ...rule, priority: n }),\n\t\tnamed: (id) => builder({ ...rule, id }),\n\t\tdo: (action) => ({ ...rule, action })\n\t}\n}\n\n/**\n * A rule: `when(condition).do(action)`, with `once()`, `every(seconds)`, `priority(n)`, `named(id)` between. The\n * condition is a function of the brain or plain data (`AiCondition`). `when.told(word)` fires once for each time the\n * word is told, taking it, its action given the word's data\n *\n * @beta\n */\nexport const when = Object.assign((condition: AiCondition): RuleBuilder => builder({ when: condition }), {\n\t/** A rule that fires for each time the game tells the brain this word (`world.computers.tell`), and takes it */\n\ttold: (word: string): RuleBuilder => builder({ when: { word } })\n})\n\n/** What the rules remember of one rule */\ninterface RuleMemory {\n\t/** Whether its condition held at the last check: a rule fires as it turns true */\n\twas?: boolean\n\t/** The tick it last fired at */\n\tfired?: number\n\t/** How many times it fired */\n\tcount: number\n}\n\n/**\n * What a rule is now, for the report: whether it held at the last check, how often and when it last fired\n *\n * @internal\n */\nexport interface RuleReport {\n\t/** The rule's id */\n\tid: string\n\t/** How important the rule is, which orders the rules */\n\tpriority: number\n\t/** Whether the rule fires at most once */\n\tonce: boolean\n\t/** Whether its condition held at the last check */\n\tholds: boolean\n\t/** How many times it fired */\n\tcount: number\n\t/** The tick it last fired at; nothing if never */\n\tfired?: number\n}\n\nconst isWord = (when: AiRule['when']): when is { word: string } =>\n\ttypeof when === 'object' &&\n\twhen !== null &&\n\t'word' in when &&\n\ttypeof (when as { word: unknown }).word === 'string' &&\n\tObject.keys(when).length === 1\n\n/** Does a rule's action */\nfunction act(ai: Brain, action: AiAction, data?: unknown): void {\n\tif (typeof action === 'function') action(ai, data)\n\telse ai.tell(action.say, action.data, ai.tick)\n}\n\n/**\n * The rules module: checks its rules each think, in their order (by `priority`, then as given), and does each one's\n * action as its condition turns true. Ahead of the modules that act on units, where a brain lists it: what a rule\n * takes is then not given orders by them first. Its id is `rules` (give `id` for a second one)\n *\n * @beta\n */\nexport const rules = (list: AiRule[], options: { id?: string } = {}): AiModuleDef =>\n\tdefineModule({ id: options.id ?? 'rules', make: (ai: Brain): AiModule => {\n\t\tconst named = list.map((rule, i) => ({ ...rule, id: rule.id ?? `rule ${i + 1}` }))\n\t\tconst seen = new Set<string>()\n\t\tfor (const rule of named) {\n\t\t\tif (seen.has(rule.id)) throw new Error(`The brain \"${ai.def.id}\" has two rules called \"${rule.id}\"`)\n\t\t\tseen.add(rule.id)\n\t\t}\n\t\tconst ordered = named.map((rule, i) => ({ rule, i })).sort((a, b) => (b.rule.priority ?? 0) - (a.rule.priority ?? 0) || a.i - b.i)\n\t\tlet memory: Record<string, RuleMemory> = {}\n\t\tconst of = (id: string) => (memory[id] ??= { count: 0 })\n\t\tconst fire = (rule: AiRule & { id: string }, data?: unknown, word?: Told) => {\n\t\t\tconst kept = of(rule.id)\n\t\t\tkept.fired = ai.tick\n\t\t\tkept.count++\n\t\t\tai.decide(`rule \"${rule.id}\" fires${word ? `: told \"${word.word}\"` : ''}`, { kind: 'rule' })\n\t\t\tact(ai, rule.action, data)\n\t\t}\n\t\treturn {\n\t\t\tid: options.id ?? 'rules',\n\t\t\tphase: 'hear',\n\t\t\tversion: 1,\n\t\t\tthink: () => {\n\t\t\t\tfor (const { rule } of ordered) {\n\t\t\t\t\tconst kept = of(rule.id)\n\t\t\t\t\tif (rule.once && kept.count > 0) continue\n\t\t\t\t\tif (isWord(rule.when)) {\n\t\t\t\t\t\t// each time the word was told, once; a `once` rule takes the first and leaves the rest\n\t\t\t\t\t\tconst words = ai.takeTold(rule.when.word, rule.once ? 1 : Infinity)\n\t\t\t\t\t\tfor (const word of words) fire(rule, word.data, word)\n\t\t\t\t\t\tkept.was = words.length > 0\n\t\t\t\t\t\tcontinue\n\t\t\t\t\t}\n\t\t\t\t\tconst holds = evaluate(rule.when, ai)\n\t\t\t\t\tconst turned = holds && !kept.was\n\t\t\t\t\tkept.was = holds\n\t\t\t\t\tif (!holds) continue\n\t\t\t\t\tconst again = rule.every !== undefined && kept.fired !== undefined && ai.tick - kept.fired >= Math.round(rule.every * ai.session.tickRate)\n\t\t\t\t\tif (turned || again) fire(rule)\n\t\t\t\t}\n\t\t\t},\n\t\t\tsave: () => structuredClone(memory),\n\t\t\trestore: (data) => {\n\t\t\t\tmemory = data && typeof data === 'object' ? structuredClone(data as Record<string, RuleMemory>) : {}\n\t\t\t},\n\t\t\tinspect: () => ({\n\t\t\t\trules: ordered.map(({ rule }): RuleReport => {\n\t\t\t\t\tconst kept = of(rule.id)\n\t\t\t\t\treturn {\n\t\t\t\t\t\tid: rule.id,\n\t\t\t\t\t\tpriority: rule.priority ?? 0,\n\t\t\t\t\t\tonce: !!rule.once,\n\t\t\t\t\t\tholds: !!kept.was,\n\t\t\t\t\t\tcount: kept.count,\n\t\t\t\t\t\t...(kept.fired !== undefined && { fired: kept.fired })\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t\t...(Object.keys(ai.goals.taken()).length && {\n\t\t\t\t\ttaken: Object.fromEntries(Object.entries(ai.goals.taken()).map(([id, hold]) => [id, { units: hold.units.length, until: hold.until }]))\n\t\t\t\t})\n\t\t\t})\n\t\t}\n\t} })\n\n/**\n * What the words a brain may be told (`words()`) come with: where (`at`, a point, or a name the map or rules gave an\n * entity or region), and for how many seconds the army is the word's, not the goals' (`seconds`)\n *\n * @beta\n */\nexport interface WordData {\n\t/** Where: a point, or the name an entity or region was given by the map or the rules */\n\tat?: Vec2 | string\n\t/** For how many seconds the army is the word's rather than the goals' */\n\tseconds?: number\n}\n\n/** The squad the words put the army in, owned by the word's hold (`word:attack`) */\nconst WORD_SQUAD = 'word'\n\n/** The seconds each word holds the army for, where its data says none */\nconst WORD_SECONDS: Record<string, number> = { attack: 60, defend: 30, retreat: 15, hold: 30 }\n\n/**\n * The words module: answers the words any brain may be told (`world.computers.tell(player, word, data)`), taking them:\n *\n * - `attack` `{ at?, seconds? }`: the army (its fighters) attacks there, fighting what it meets on the way; where no\n *   place is given, at the nearest building of a rival's it knows of, else at the first rival's base the seat was told\n *   (`AiOptions.enemyBases`).\n * - `defend` `{ at?, seconds? }`: the army goes to fight there, home when left out.\n * - `retreat` `{ seconds? }`: the army comes home, fighting nothing on the way.\n * - `hold` `{ seconds? }`: the army stands where it is, fighting what comes in reach.\n * - `pause`: the brain sits still until told `resume` (or `world.computers.resume`); `resume` the brain answers itself.\n *\n * The army goes as one squad on the kit's task of the word (`attack`, `defend`, `retreat`, `hold`, in the squad\n * `word`), so that where the brain has the `squads()` module it regroups, focuses, kites and falls back on the odds as\n * any squad does. The army is the word's for `seconds` (attack 60, defend 30, retreat 15, hold 30): no goal claims it\n * meanwhile, then the squad goes and the goals have it again. Its id is `words`; put it after `rules`, so that a rule's `{ say }` is answered that think\n *\n * @beta\n */\nexport const words = (): AiModuleDef =>\n\tdefineModule({ id: 'words', make: (ai: Brain): AiModule => {\n\t\tconst army = () => ai.view.mine.fighters().alive()\n\t\tconst point = (at: Vec2 | string | undefined): Vec2 | undefined => {\n\t\t\tif (at === undefined) return undefined\n\t\t\tif (typeof at !== 'string') return at\n\t\t\tconst named = ai.view.named(at)\n\t\t\tif (named) return { x: named.x, z: named.z }\n\t\t\tconst region = ai.view.region(at)\n\t\t\t// a circle or a rectangle, both about their middle\n\t\t\tif (region) return { x: region.shape.x, z: region.shape.z }\n\t\t\treturn undefined\n\t\t}\n\t\t/**\n\t\t * The army on the word's task: `plan` says what it does (`undefined`: nothing to do), and puts the squad on it.\n\t\t * The army is a squad of the word's hold (`word:<word>`), so the squads module regroups, focuses, kites and falls\n\t\t * back for it; when the hold lapses, the squad goes and the goals have the army again\n\t\t */\n\t\tconst order = (word: string, data: WordData, plan: (ids: number[]) => { what: string; give: (squad: Squad) => void } | undefined) => {\n\t\t\tconst units = army()\n\t\t\tif (!units.length) {\n\t\t\t\tai.decide(`told \"${word}\", with no army to do it`, { kind: 'word' })\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst ids = units.map((unit) => unit.id)\n\t\t\tconst planned = plan(ids)\n\t\t\tif (planned === undefined) return\n\t\t\tconst owner = `word:${word}`\n\t\t\tai.goals.take(ids, 'told', { id: owner, seconds: data.seconds ?? WORD_SECONDS[word] })\n\t\t\tfor (const other of Object.keys(WORD_SECONDS)) if (other !== word) ai.goals.release(`word:${other}`)\n\t\t\tplanned.give(ai.squads.make(WORD_SQUAD, ids, { owner }))\n\t\t\tai.decide(`told \"${word}\": ${planned.what}`, { kind: 'word' })\n\t\t}\n\t\treturn {\n\t\t\tid: 'words',\n\t\t\tphase: 'hear',\n\t\t\tafter: ['rules'],\n\t\t\tthink: () => {\n\t\t\t\tfor (const told of [...ai.told()]) {\n\t\t\t\t\tconst data = (told.data && typeof told.data === 'object' ? told.data : {}) as WordData\n\t\t\t\t\tswitch (told.word) {\n\t\t\t\t\t\tcase 'attack':\n\t\t\t\t\t\t\tai.takeTold('attack')\n\t\t\t\t\t\t\torder('attack', data, (ids) => {\n\t\t\t\t\t\t\t\tconst centre = ai.view.mine.where((unit) => ids.includes(unit.id)).centre()\n\t\t\t\t\t\t\t\tconst target = point(data.at) ?? (centre && ai.view.enemies.known().buildings().nearest(centre)) ?? ai.options.enemyBases?.[0]\n\t\t\t\t\t\t\t\tif (!target) {\n\t\t\t\t\t\t\t\t\tai.decide('told \"attack\", and knows of nowhere to attack', { kind: 'word' })\n\t\t\t\t\t\t\t\t\treturn undefined\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tconst at = { x: target.x, z: target.z }\n\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\twhat: `the army of ${ids.length} attacks at (${Math.round(target.x)}, ${Math.round(target.z)})`,\n\t\t\t\t\t\t\t\t\tgive: (squad) => squad.attack(at)\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\tbreak\n\t\t\t\t\t\tcase 'defend':\n\t\t\t\t\t\t\tai.takeTold('defend')\n\t\t\t\t\t\t\torder('defend', data, (ids) => {\n\t\t\t\t\t\t\t\tconst home = ai.view.home()\n\t\t\t\t\t\t\t\tconst target = point(data.at) ?? (home && { x: home.x, z: home.z })\n\t\t\t\t\t\t\t\tif (!target) return undefined\n\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\twhat: `the army of ${ids.length} goes to fight at (${Math.round(target.x)}, ${Math.round(target.z)})`,\n\t\t\t\t\t\t\t\t\tgive: (squad) => squad.defend(target)\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\tbreak\n\t\t\t\t\t\tcase 'retreat':\n\t\t\t\t\t\t\tai.takeTold('retreat')\n\t\t\t\t\t\t\torder('retreat', data, (ids) => {\n\t\t\t\t\t\t\t\tconst home = ai.view.home()\n\t\t\t\t\t\t\t\tif (!home) return undefined\n\t\t\t\t\t\t\t\tconst at = { x: home.x, z: home.z }\n\t\t\t\t\t\t\t\treturn { what: `the army of ${ids.length} comes home`, give: (squad) => squad.retreat(at, 'told to') }\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\tbreak\n\t\t\t\t\t\tcase 'hold':\n\t\t\t\t\t\t\tai.takeTold('hold')\n\t\t\t\t\t\t\torder('hold', data, (ids) => {\n\t\t\t\t\t\t\t\treturn { what: `the army of ${ids.length} holds where it stands`, give: (squad) => squad.task('hold', {}) }\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\tbreak\n\t\t\t\t\t\tcase 'pause':\n\t\t\t\t\t\t\tai.takeTold('pause')\n\t\t\t\t\t\t\tai.paused = true\n\t\t\t\t\t\t\tai.decide('told \"pause\": sits still until told \"resume\"', { kind: 'word' })\n\t\t\t\t\t\t\tbreak\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t} })\n"],"mappings":"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"}

package/dist/ai/scouting.d.ts

@@ -30,6 +30,7 @@ export interface ScoutingOptions {
  * @beta
  */
 export interface ScoutingMemory {
+    /** The version of the memory's format: 1 so far */
     v: 1;
     /** The unit that scouts, while it lives: the same one goes on to the next round */
     scout?: number;
@@ -52,6 +53,7 @@ export interface ScoutingMemory {
  * @beta
  */
 export interface Look {
+    /** Where the place is, in cells */
     at: Vec2;
     /** Their start not seen yet, their base, a mine they would expand to, where their army was, or a place the game names */
     kind: 'start' | 'base' | 'expansion' | 'army' | 'game';
@@ -67,14 +69,18 @@ export interface Look {
  * @beta
  */
 export interface ScoutingReport {
+    /** The plan of looks, each with where, its kind, how many seconds ago it was seen and whether it is due */
     looks: {
         at: [number, number];
         kind: Look['kind'];
         seen?: number;
         due: boolean;
     }[];
+    /** The entity id of the unit that scouts; nothing when there is none */
     scout?: number;
+    /** The places the scout is going to, in order, in cells */
     going?: [number, number][];
+    /** How many rounds of looks were sent */
     rounds: number;
 }
 /**