@v12-engine/engine 0.1.0 → 0.4.0

package/dist/ai/team.js

@@ -0,0 +1,492 @@
+import { distSq } from "../math.js";
+import { defineModule } from "./module.js";
+import { consider, curve, defineGoal } from "./goals.js";
+import { pair, point, where } from "./geometry.js";
+import { Defence } from "./defence.js";
+//#region src/ai/team.ts
+/** How near the place of a request the enemies seen there are counted in its strength */
+var SEEN_NEAR = 16;
+/** The most units sent to a call with no enemy seen there: enough to look and to hold a little */
+var HELP_UNSEEN = 3;
+/** Seconds a plan waits past its time for the waves of those that joined, before it is over */
+var PLAN_OVER = 30;
+/**
+* The id of the help goal
+*
+* @beta
+*/
+var HELP = "help";
+/**
+* The id of the goal that does what an ally's ping asks (`push`, `hold`): `pinged`
+*
+* @beta
+*/
+var PINGED = "pinged";
+/** What is sent at a ping, by what it asks: the squad's name */
+var PING_SQUADS = {
+	attack: "push",
+	defend: "hold"
+};
+/**
+* An empty board
+*
+* @internal
+*/
+var emptyTeam = () => ({
+	v: 1,
+	requests: [],
+	known: {},
+	next: 1
+});
+/**
+* A brain's team play (`ai.team`): the team's board (`board`: requests, the plan of an attack together, what each
+* computer knows), the `help` goal, and what it says. The board is the world's (`core.ai.teams`) where the seat hands
+* it over (`BrainContext.team`), else its own: a brain made by hand plays alone
+*
+* @internal
+*/
+var Team = class Team {
+	ai;
+	shared;
+	/** What finds it on a brain (`ai.area(Team)`): made the first time a module asks for it */
+	static id = "team";
+	/** Makes the team play of a brain; what `ai.area(Team)` calls the first time a module asks for it */
+	static make(ai) {
+		return new Team(ai, ai.teamBoard);
+	}
+	/** Its id among the brain's areas: what its memory and its report are kept under */
+	id = "team";
+	/** What the log says where a save's memory of it is of a shape it does not read */
+	afresh = "the save remembers the computer player’s team play in a shape this brain does not read: it starts afresh";
+	/** Whether a `team()` module is in the brain */
+	enabled = false;
+	memory = {
+		v: 1,
+		heard: -1,
+		said: {}
+	};
+	moduleOptions = {};
+	own = emptyTeam();
+	/** The help goal: added to the brain's picker by the module, where it defends users */
+	goal;
+	/** The goal that does what an ally's ping asks (`answerPings`): added with the help goal */
+	pingGoal;
+	constructor(ai, shared) {
+		this.ai = ai;
+		this.shared = shared;
+		this.goal = this.makeGoal();
+		this.pingGoal = this.makePingGoal();
+	}
+	/** Puts the `team()` module's options under the brain's settings, and the help goal on the picker */
+	configure(options) {
+		this.moduleOptions = options;
+		if (!this.enabled && (this.options.defendUsers ?? true)) this.ai.goals.add(this.goal);
+		if (!this.enabled && (this.options.answerPings ?? true)) this.ai.goals.add(this.pingGoal);
+		this.enabled = true;
+	}
+	/** How it plays with its team: the module's options, the brain's settings over them (`ai.settings.team`) */
+	get options() {
+		return this.ai.cache("team.options", () => ({
+			...this.moduleOptions,
+			...this.ai.settings.team
+		}));
+	}
+	/** Whether its waves wait for the team's plan (`together`) */
+	get together() {
+		return this.enabled && !!this.options.together;
+	}
+	/** The team's board: the world's, shared by the team's computers, or its own where the seat gave none */
+	get board() {
+		return this.shared?.() ?? this.own;
+	}
+	/** Its team's number */
+	get team() {
+		return this.ai.view.me.team;
+	}
+	/** The computers of its team, as seen on the board lately (each writes itself as it thinks), itself among them */
+	computers() {
+		const { board, ai } = this;
+		const recent = ai.tick - 10 * ai.session.tickRate;
+		return Object.entries(board.known).filter(([, known]) => known.tick >= recent).map(([id]) => Number(id)).sort((a, b) => a - b);
+	}
+	/** The requests on the board, those of a kind where given: those still standing */
+	requests(kind) {
+		const { tick } = this.ai;
+		return this.board.requests.filter((each) => each.until > tick && (kind === void 0 || each.kind === kind));
+	}
+	/**
+	* Asks the team for something at a place: a request on the board, or the one of the same asker, kind and place made
+	* to stand longer, with the strength seen now. Gives back the request
+	*/
+	request(kind, at, strength, by, from = this.ai.playerId, seconds) {
+		const { ai, board } = this;
+		const until = ai.tick + Math.round((seconds ?? this.options.requestFor ?? 30) * ai.session.tickRate);
+		const same = board.requests.find((each) => each.from === from && each.kind === kind && each.until > ai.tick && distSq(each.at, at) <= 256);
+		if (same) {
+			same.until = Math.max(same.until, until);
+			same.strength = Math.max(same.strength, strength);
+			return same;
+		}
+		const request = {
+			id: board.next++,
+			kind,
+			from,
+			at: point(at),
+			strength,
+			until,
+			by,
+			answered: []
+		};
+		board.requests.push(request);
+		ai.decide(`asks for ${kind} at ${where(at)}${from === ai.playerId ? "" : ` for player ${from}`} (${by}, strength ${Math.round(strength)})`, { kind: "team" });
+		return request;
+	}
+	/** The enemy's bases the team knows, every computer's put together: one a place, the latest seen */
+	enemyBases() {
+		const merged = [];
+		const known = this.board.known;
+		for (const id of Object.keys(known).sort((a, b) => Number(a) - Number(b))) for (const base of known[id].bases) {
+			const same = merged.find((each) => each.owner === base.owner && distSq(each.at, base.at) < 256);
+			if (same) same.last = Math.max(same.last, base.last);
+			else merged.push({
+				...base,
+				at: point(base.at)
+			});
+		}
+		return merged;
+	}
+	/** The plan of an attack together, while it stands */
+	get plan() {
+		const plan = this.board.plan;
+		return plan && this.ai.tick <= plan.at + PLAN_OVER * this.ai.session.tickRate ? plan : void 0;
+	}
+	/** Proposes an attack together: a target, the waves to go `gatherFor` seconds from now. Joined by the proposer */
+	propose(target) {
+		const { ai } = this;
+		const plan = {
+			target: point(target),
+			at: ai.tick + Math.round((this.options.gatherFor ?? 20) * ai.session.tickRate),
+			by: ai.playerId,
+			joined: [ai.playerId],
+			declined: [],
+			since: ai.tick
+		};
+		this.board.plan = plan;
+		ai.decide(`proposes an attack together on ${where(target)} in ${this.options.gatherFor ?? 20} s`, { kind: "team" });
+		return plan;
+	}
+	/** Joins the plan standing: its wave goes with the others' */
+	join() {
+		const plan = this.plan;
+		if (!plan || plan.joined.includes(this.ai.playerId)) return;
+		plan.joined.push(this.ai.playerId);
+		plan.declined = plan.declined.filter((each) => each !== this.ai.playerId);
+		this.ai.decide(`joins player ${plan.by}'s attack on ${where(plan.target)}`, { kind: "team" });
+	}
+	/** Says no to the plan standing: its wave goes on its own time */
+	decline() {
+		const plan = this.plan;
+		if (!plan || plan.declined.includes(this.ai.playerId) || plan.joined.includes(this.ai.playerId)) return;
+		plan.declined.push(this.ai.playerId);
+		this.ai.decide(`declines player ${plan.by}'s attack on ${where(plan.target)}: its wave is not ready`, { kind: "team" });
+	}
+	/** Says a line of the game's to its side (`say`, `lines`), no more than once in ten seconds a line */
+	say(line) {
+		const { ai } = this;
+		const options = this.options;
+		const text = options.lines?.[line];
+		if (!this.enabled || !options.say || !text) return;
+		const last = this.memory.said[line];
+		if (last !== void 0 && ai.tick - last < 10 * ai.session.tickRate) return;
+		this.memory.said[line] = ai.tick;
+		ai.send({
+			type: "chat",
+			text,
+			to: "allies"
+		});
+	}
+	/**
+	* The think, once a think: the board brought up to date (what is over dropped, itself and what it knows written),
+	* the people heard (pings, damage to allies), its own raids asked help for, the plan answered
+	*/
+	think() {
+		const { ai, board } = this;
+		const tick = ai.tick;
+		board.requests = board.requests.filter((each) => each.until > tick);
+		if (board.plan && tick > board.plan.at + PLAN_OVER * ai.session.tickRate) delete board.plan;
+		if (ai.def.knowledge !== false) board.known[ai.playerId] = {
+			tick,
+			bases: ai.knowledge.enemy.bases().filter((base) => !base.gone).map((base) => ({
+				owner: base.owner,
+				at: point(base.at),
+				last: base.last
+			}))
+		};
+		else board.known[ai.playerId] = {
+			tick,
+			bases: []
+		};
+		const heardFrom = this.memory.heard;
+		this.memory.heard = tick;
+		if (ai.def.knowledge !== false && heardFrom >= 0) this.hear(heardFrom);
+		if (this.options.answerPings ?? true) this.fallBack();
+		if ((this.options.askForHelp ?? true) && ai.area(Defence).enabled) for (const raid of ai.area(Defence).raids()) {
+			if (raid.strength * ai.area(Defence).margin <= this.homeStrength()) continue;
+			this.request("help", raid.base.at, raid.strength, "raid");
+		}
+		const plan = this.plan;
+		if (plan && plan.by !== ai.playerId && !plan.joined.includes(ai.playerId) && plan.since < heardFrom) this.decline();
+	}
+	/**
+	* An ally's ping to fall back (`rally`), not answered yet: its squads out (waves, raids, harassers, a push; not what
+	* defends, helps or looks) come home, and it says so. What that ally pinged to push or hold before is not done any
+	* more (`pinged`): the latest ping of a person's is what it asks
+	*/
+	fallBack() {
+		const { ai } = this;
+		const home = ai.view.home();
+		if (!home) return;
+		for (const request of this.requests("rally")) {
+			if (request.by !== "ping" || request.from === ai.playerId || request.answered.includes(ai.playerId)) continue;
+			request.answered.push(ai.playerId);
+			const out = ai.squads.all().squads.filter((squad) => squad.alive && squad.length && (![
+				"defend",
+				"help",
+				"pinged",
+				"scout"
+			].includes(squad.owner ?? "") || squad.name === PING_SQUADS.attack) && squad.current?.kind !== "retreat");
+			for (const squad of out) squad.retreat(home, `player ${request.from} asks to fall back`);
+			ai.decide(`falls back home at player ${request.from}'s ping: ${out.length ? out.map((squad) => squad.name).join(", ") : "nothing out"}`, { kind: "team" });
+			if (out.length) this.say("retreating");
+		}
+	}
+	/**
+	* The ping of an ally's it does now: the latest standing `attack` or `defend` of another's, in reach of home, and
+	* not before a `rally` of theirs since (a retreat asked after a push is what they want now)
+	*/
+	pinged() {
+		const { ai } = this;
+		return ai.cache("team.pinged", () => {
+			const home = ai.view.home();
+			if (!home) return void 0;
+			const rallies = this.requests("rally").filter((each) => each.by === "ping");
+			const candidates = [...this.requests("attack"), ...this.requests("defend")].filter((each) => each.by === "ping" && each.from !== ai.playerId && distSq(each.at, home) <= 6400 && !rallies.some((rally) => rally.from === each.from && rally.id > each.id));
+			candidates.sort((a, b) => b.id - a.id);
+			return candidates[0];
+		});
+	}
+	/**
+	* The goal that does what an ally's ping asks: a squad to fight there (`push`), or to hold the place (`hold`). One at
+	* a time: a later ping takes the units of the one before
+	*/
+	makePingGoal() {
+		const sent = (available, request) => this.helpers(available, {
+			at: request.at,
+			strength: this.seenAt(request.at)
+		});
+		return defineGoal({
+			id: PINGED,
+			weight: .75,
+			considerations: [consider("an ally pings to push or hold", () => this.pinged() ? 1 : 0, curve.step(1)), consider("enough to send", (ai) => {
+				const request = this.pinged();
+				return request ? sent(ai.goals.pool(), request).length : 0;
+			}, curve.step(1))],
+			claims: { units: (_ai, available) => {
+				const request = this.pinged();
+				return request ? sent(available, request) : [];
+			} },
+			commitment: 10,
+			run: (ai, claimed) => {
+				const request = this.pinged();
+				if (!request || request.kind !== "attack" && request.kind !== "defend") return;
+				const name = PING_SQUADS[request.kind];
+				const there = ai.squads.named(name);
+				const at = there?.current?.data.at;
+				if (there && at && distSq(at, request.at) <= 256 && there.done === void 0) return;
+				const squad = claimed.squad(name, claimed.units);
+				if (request.kind === "attack") squad.attack(request.at);
+				else squad.defend(request.at, SEEN_NEAR);
+				if (!request.answered.includes(ai.playerId)) request.answered.push(ai.playerId);
+				ai.decide(`${request.kind === "attack" ? "pushes" : "holds"} at ${where(request.at)} with ${claimed.units.length}, at player ${request.from}'s ping`, {
+					kind: "team",
+					goal: PINGED
+				});
+				if (request.kind === "attack") this.say("attacking");
+			}
+		});
+	}
+	/** Its fighters at home nothing holds: what it meets a raid with before it asks */
+	homeStrength() {
+		const { ai } = this;
+		return ai.goals.pool().fighters().strength();
+	}
+	/** What was heard since the last think: the people's pings at a place, damage done to an ally where it was seen */
+	hear(since) {
+		const { ai } = this;
+		const { view } = ai;
+		const ally = (player) => player !== ai.playerId && view.player(player)?.relation === "ally";
+		for (const ping of ai.knowledge.events.pings()) {
+			if (ping.tick <= since || !ally(ping.player)) continue;
+			const meaning = ai.session.registry.settings.talk.pings.meanings?.[ping.kind];
+			if (meaning && meaning !== "ignore") this.request(meaning, ping.at, meaning === "help" ? this.seenAt(ping.at) : 0, "ping", ping.player);
+			else ai.decide(`hears player ${ping.player}'s ${ping.kind} at ${where(ping.at)}`, { kind: "team" });
+		}
+		for (const hit of ai.knowledge.events.damage()) {
+			if (hit.tick <= since || !ally(hit.owner)) continue;
+			const strength = this.seenAt(hit.at);
+			if (strength > 0) this.request("help", hit.at, strength, "damage", hit.owner);
+		}
+	}
+	/** The strength of the enemies in sight near a place */
+	seenAt(at) {
+		return this.ai.view.enemies.units().alive().near(at, SEEN_NEAR).strength();
+	}
+	/** The request it would answer now: the strongest standing of another, in reach of home, it can send enough to */
+	calling() {
+		const { ai } = this;
+		return ai.cache("team.calling", () => {
+			const home = ai.view.home();
+			if (!home) return void 0;
+			const candidates = this.requests("help").filter((each) => each.from !== ai.playerId && distSq(each.at, home) <= 6400);
+			candidates.sort((a, b) => b.strength - a.strength || a.id - b.id);
+			return candidates[0];
+		});
+	}
+	/** How much stronger than a call what is sent to it is: from the odds asked, by the square law (one in two: as strong) */
+	get margin() {
+		const odds = Math.min(.95, Math.max(.05, this.options.helpOdds ?? .5));
+		return Math.sqrt(odds / (1 - odds));
+	}
+	/** Who it sends to a call: its idle fighters nothing holds, the nearest first, as many as make the odds asked */
+	helpers(available, request) {
+		const { ai } = this;
+		const need = request.strength * this.margin;
+		const idle = available.fighters().idle().items.slice().sort((a, b) => distSq(a, request.at) - distSq(b, request.at) || a.id - b.id);
+		const chosen = [];
+		let got = 0;
+		for (const unit of idle) {
+			if (request.strength > 0 ? got >= need : chosen.length >= HELP_UNSEEN) break;
+			chosen.push(unit);
+			got += ai.view.strength.of(unit);
+		}
+		if (request.strength > 0 && got < need) return available.where(() => false);
+		return available.where((unit) => chosen.includes(unit));
+	}
+	/** The help goal: a call of an ally's standing, and enough to send to it */
+	makeGoal() {
+		return defineGoal({
+			id: HELP,
+			weight: .7,
+			considerations: [consider("an ally calls for help", () => this.calling() ? 1 : 0, curve.step(1)), consider("enough to send", (ai) => {
+				const request = this.calling();
+				return request ? this.helpers(ai.goals.pool(), request).length : 0;
+			}, curve.step(1))],
+			claims: { units: (_ai, available) => {
+				const request = this.calling();
+				return request ? this.helpers(available, request) : [];
+			} },
+			commitment: 10,
+			run: (ai, claimed) => {
+				const request = this.calling();
+				if (!request) return;
+				const squad = ai.squads.named("help");
+				const at = squad?.current?.data.at;
+				if (squad && at && distSq(at, request.at) <= 256 && squad.done === void 0) {
+					const more = this.helpers(ai.goals.pool(), {
+						...request,
+						strength: Math.max(0, request.strength * this.margin - squad.strength()) / this.margin
+					});
+					if (request.strength > 0 && more.length) squad.add(more, "more seen there");
+					return;
+				}
+				claimed.squad("help", claimed.units).defend(request.at, SEEN_NEAR);
+				if (!request.answered.includes(ai.playerId)) request.answered.push(ai.playerId);
+				ai.decide(`answers player ${request.from}'s call for help at ${where(request.at)} with ${claimed.units.length}`, {
+					kind: "team",
+					goal: HELP
+				});
+				this.say("helping");
+			}
+		});
+	}
+	/** Team play as the report shows it */
+	report() {
+		const { ai } = this;
+		const tickRate = ai.session.tickRate;
+		const plan = this.plan;
+		return {
+			team: this.team,
+			computers: this.computers(),
+			requests: this.requests().map((each) => ({
+				id: each.id,
+				kind: each.kind,
+				from: each.from,
+				at: pair(each.at),
+				strength: Math.round(each.strength),
+				by: each.by,
+				answered: [...each.answered],
+				left: Math.max(0, Math.round((each.until - ai.tick) / tickRate))
+			})),
+			...plan && { plan: {
+				target: pair(plan.target),
+				in: Math.round((plan.at - ai.tick) / tickRate),
+				by: plan.by,
+				joined: [...plan.joined],
+				declined: [...plan.declined]
+			} },
+			enemyBases: this.enemyBases().length
+		};
+	}
+	/** What it remembers, for a save: a copy (the board is the world's, saved with it) */
+	/** Whether it has anything to remember now: one that does not is left out of a save */
+	remembers() {
+		return this.enabled;
+	}
+	/** Its part of the brain's report */
+	reportTo(report) {
+		if (this.enabled) report.team = this.report();
+	}
+	/** Gives a copy of the team play's memory, for a save of the brain */
+	save() {
+		return {
+			v: 1,
+			heard: this.memory.heard,
+			said: { ...this.memory.said }
+		};
+	}
+	/** Takes back what `save` gave: whether it was read */
+	restore(memory) {
+		const given = memory;
+		if (!given || typeof given !== "object" || given.v !== 1) return false;
+		this.memory = {
+			v: 1,
+			heard: given.heard ?? -1,
+			said: { ...given.said ?? {} }
+		};
+		return true;
+	}
+};
+/**
+* The team module: the team's board brought up to date each think (`ai.team.think`: itself and what it knows written,
+* pings and an ally's damage heard as calls for help, its own raids asked help for, the plan of an attack together
+* answered), and the `help` goal on the picker. With how it plays where the brain's definition and the seat's options
+* say nothing (`TeamOptions`)
+*
+* @beta
+*/
+var team = (options = {}) => defineModule({
+	id: "team",
+	make: (ai) => {
+		ai.area(Team).configure(options);
+		return {
+			id: "team",
+			phase: "sense",
+			after: ["defence"],
+			think: () => ai.area(Team).think()
+		};
+	}
+});
+//#endregion
+export { HELP, PINGED, Team, emptyTeam, team };
+
+//# sourceMappingURL=team.js.map

package/dist/ai/team.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.js","names":[],"sources":["../../src/ai/team.ts"],"sourcesContent":["import type { PlayerId } from '#engine/entity'\nimport { DEFEND, Defence } from './defence'\nimport type { AiArea } from './area'\nimport type { AiReport } from './report'\nimport { distSq, type Vec2 } from '#engine/math'\nimport type { EntityState } from '#engine/session/protocol'\nimport { type Brain } from './brain'\nimport { type AiModule, type AiModuleDef, defineModule } from './module'\nimport { consider, curve, defineGoal, type GoalDef } from './goals'\nimport type { UnitSet } from './view'\nimport { pair, point, where } from './geometry'\n\n/*\n * Team play (AI plan, C5): computers that play on one side as one side. Before this, a computer ally neither helped\n * nor answered: a person's ping went unheard, an ally's hall burned in plain sight, two computers of a team sent their\n * waves a minute apart and lost them one after the other. This is the word between them, and with the people on\n * their side:\n *\n * - **The team's board** (`TeamBoard`): one per team, shared by the team's computers, kept in the world as a state\n *   of its own (`core.ai.teams`) so that a save keeps it. It is never replicated: no player, human or computer, gets\n *   it in a snapshot, and only the debug panel's AI tab shows it (through the report). Pooling what the computers of a\n *   team know is fair by construction: sight is per team already, so the board holds nothing a human ally could not\n *   see. Each computer writes to it through its brain (`ai.team`) as it thinks, in the seats' order, which is the same\n *   every game.\n * - **Requests** (`request`): `help` at a place, with the strength seen there, for so long. A computer posts one when a\n *   raid on it is more than it can meet at home; it hears a person's ping as one (`danger` and `assist` at a place: help\n *   there; `look` and `onMyWay` noted); and damage it sees done to an ally's units or buildings is one, sized by the\n *   enemies seen there. The `help` goal (`defendUsers`, the classic Defend Users) weighs a request against what it can\n *   send (`helpOdds`): it sends a squad of its idle fighters, as many as make the odds, and never its last defence.\n * - **Attacking together** (`together`): the first computer of the team whose wave is ready proposes a target and a\n *   time a little ahead (`gatherFor`); the others join by their next think if their wave is ready, or decline; at the\n *   time every computer that joined sends its wave to the target. Who proposes first follows the seats' think offsets,\n *   the same every game: the lowest seat often leads, which is fine.\n * - **What they know of the enemy, pooled** (`enemyBases`): each computer puts the bases it remembers on the board;\n *   any computer of the team reads them all.\n * - **Saying things** (`say`, off by default): a line of chat to its side as it sends a wave, comes to help, falls\n *   back. The lines are the game's (`lines`): the kit never puts words in a game.\n */\n\n/**\n * Something one computer of a team asks of the others, on the team's board: help at a place\n *\n * @beta\n */\nexport interface TeamRequest {\n\t/** Its number on the board */\n\tid: number\n\t/** What is asked: help, an attack, a defence or a rally */\n\tkind: 'help' | 'attack' | 'defend' | 'rally'\n\t/** Who asks: a computer of the team, or a person whose ping or plight it is */\n\tfrom: PlayerId\n\t/** Where the help is asked, in cells */\n\tat: Vec2\n\t/** The enemy strength seen there as it was asked (0 for none seen: a ping on a place) */\n\tstrength: number\n\t/** The tick it is asked until */\n\tuntil: number\n\t/** What it came of: a raid on a computer, a person's ping, damage seen done to an ally, a word of the game's */\n\tby: 'raid' | 'ping' | 'damage' | 'word'\n\t/** The computers that answered it */\n\tanswered: PlayerId[]\n}\n\n/**\n * An attack the computers of a team agree on (`together`): where, when, who proposed it, who joined and who did not\n *\n * @beta\n */\nexport interface AttackPlan {\n\t/** Where the attack goes, in cells */\n\ttarget: Vec2\n\t/** The tick the waves go at */\n\tat: number\n\t/** The player who proposed the attack */\n\tby: PlayerId\n\t/** The computers that joined the attack */\n\tjoined: PlayerId[]\n\t/** The computers that declined it */\n\tdeclined: PlayerId[]\n\t/** The tick it was proposed at */\n\tsince: number\n}\n\n/**\n * A team's board as the world keeps it (`core.ai.teams`, by team): plain data, kept in a save, never replicated\n *\n * @beta\n */\nexport interface TeamBoard {\n\t/** The version of the board's format: 1 so far */\n\tv: 1\n\t/** The requests on the board */\n\trequests: TeamRequest[]\n\t/** The attack the computers agreed on; nothing when there is none */\n\tplan?: AttackPlan\n\t/** What each computer of the team remembers of the enemy's bases, and when it last thought */\n\tknown: Record<string, { tick: number; bases: { owner: PlayerId; at: Vec2; last: number }[] }>\n\t/** The next request's number */\n\tnext: number\n}\n\n/**\n * How a brain plays with its team (`BrainDef.team`, the seat's `AiOptions.team` over it, the `team()` module's own\n * under both). Data\n *\n * @beta\n */\nexport interface TeamOptions {\n\t/** Whether it helps its allies, people and computers, where asked (the classic Defend Users): yes when left out */\n\tdefendUsers?: boolean\n\t/**\n\t * Whether it does what an ally's ping asks besides help (`RuleSettings.talk.pings.meanings`): a squad sent to fight at\n\t * an `attack` (a push), one to hold a place at a `defend` (a hold), its squads out brought home at a `rally` (a\n\t * retreat). Yes when left out\n\t */\n\tanswerPings?: boolean\n\t/** The odds of the fight (`Strength.odds`) what it sends to help is to have: one in two when left out */\n\thelpOdds?: number\n\t/** Whether it asks its team for help with a raid more than it can meet: yes when left out */\n\taskForHelp?: boolean\n\t/** Whether its waves wait for the team's plan and go together: no when left out */\n\ttogether?: boolean\n\t/** Seconds ahead of the proposal the waves of a plan go: 20 when left out */\n\tgatherFor?: number\n\t/** Seconds a request stands: 30 when left out */\n\trequestFor?: number\n\t/** Whether it says a line to its side as it sends a wave, comes to help, falls back: no when left out */\n\tsay?: boolean\n\t/** Its lines, the game's words: `{ attacking, helping, retreating }`. Nothing is said for a line not given */\n\tlines?: Partial<Record<'attacking' | 'helping' | 'retreating', string>>\n}\n\n/**\n * What a brain remembers of its team play between thinks (`BrainMemory.team`): up to when it heard, when it last said\n * each line\n *\n * @beta\n */\nexport interface TeamPlayMemory {\n\t/** The version of the memory's format: 1 so far */\n\tv: 1\n\t/** Up to which board request, by number, it heard */\n\theard: number\n\t/** When it last said each line, by line */\n\tsaid: Record<string, number>\n}\n\n/**\n * Team play as the report shows it (`AiReport.team`): the team, its computers, the requests on its board, the plan of\n * an attack together, how many enemy bases the team knows\n *\n * @beta\n */\nexport interface TeamReport {\n\t/** The team's number */\n\tteam: number\n\t/** The computer players of the team */\n\tcomputers: PlayerId[]\n\t/** The requests on the board, each with its number, kind, who asked, where, strength, source, who answered and how long is left */\n\trequests: {\n\t\tid: number\n\t\tkind: TeamRequest['kind']\n\t\tfrom: PlayerId\n\t\tat: [number, number]\n\t\tstrength: number\n\t\tby: TeamRequest['by']\n\t\tanswered: PlayerId[]\n\t\tleft: number\n\t}[]\n\t/** The attack together, with its target, how many seconds off it is, who proposed it, who joined and who declined */\n\tplan?: { target: [number, number]; in: number; by: PlayerId; joined: PlayerId[]; declined: PlayerId[] }\n\t/** How many enemy bases the team knows */\n\tenemyBases: number\n}\n\n/** How near two requests of one asker are to be one */\nconst SAME_PLACE = 16\n/** How near the place of a request the enemies seen there are counted in its strength */\nconst SEEN_NEAR = 16\n/** How far a computer's fighters go to help: further is across the map */\nconst HELP_REACH = 80\n/** The most units sent to a call with no enemy seen there: enough to look and to hold a little */\nconst HELP_UNSEEN = 3\n/** Seconds a plan waits past its time for the waves of those that joined, before it is over */\nconst PLAN_OVER = 30\n/**\n * The id of the help goal\n *\n * @beta\n */\nexport const HELP = 'help'\n\n/**\n * The id of the goal that does what an ally's ping asks (`push`, `hold`): `pinged`\n *\n * @beta\n */\nexport const PINGED = 'pinged'\n/** What is sent at a ping, by what it asks: the squad's name */\nconst PING_SQUADS = { attack: 'push', defend: 'hold' } as const\n\n/**\n * An empty board\n *\n * @internal\n */\nexport const emptyTeam = (): TeamBoard => ({ v: 1, requests: [], known: {}, next: 1 })\n\n/**\n * A brain's team play (`ai.team`): the team's board (`board`: requests, the plan of an attack together, what each\n * computer knows), the `help` goal, and what it says. The board is the world's (`core.ai.teams`) where the seat hands\n * it over (`BrainContext.team`), else its own: a brain made by hand plays alone\n *\n * @internal\n */\nexport class Team implements AiArea {\n\t/** What finds it on a brain (`ai.area(Team)`): made the first time a module asks for it */\n\tstatic readonly id = 'team'\n\t/** Makes the team play of a brain; what `ai.area(Team)` calls the first time a module asks for it */\n\tstatic make(ai: Brain): Team {\n\t\treturn new Team(ai, ai.teamBoard)\n\t}\n\t/** Its id among the brain's areas: what its memory and its report are kept under */\n\treadonly id = 'team'\n\t/** What the log says where a save's memory of it is of a shape it does not read */\n\treadonly afresh = 'the save remembers the computer player’s team play in a shape this brain does not read: it starts afresh'\n\n\t/** Whether a `team()` module is in the brain */\n\tenabled = false\n\tprivate memory: TeamPlayMemory = { v: 1, heard: -1, said: {} }\n\tprivate moduleOptions: TeamOptions = {}\n\tprivate own: TeamBoard = emptyTeam()\n\t/** The help goal: added to the brain's picker by the module, where it defends users */\n\treadonly goal: GoalDef\n\t/** The goal that does what an ally's ping asks (`answerPings`): added with the help goal */\n\treadonly pingGoal: GoalDef\n\n\tconstructor(\n\t\t/** The brain it plays for */\n\t\treadonly ai: Brain,\n\t\t/** The team's board, as the seat hands it over: the world's, read anew each time (a load replaces it) */\n\t\tprivate readonly shared?: () => TeamBoard\n\t) {\n\t\tthis.goal = this.makeGoal()\n\t\tthis.pingGoal = this.makePingGoal()\n\t}\n\n\t/** Puts the `team()` module's options under the brain's settings, and the help goal on the picker */\n\tconfigure(options: TeamOptions): void {\n\t\tthis.moduleOptions = options\n\t\tif (!this.enabled && (this.options.defendUsers ?? true)) this.ai.goals.add(this.goal)\n\t\tif (!this.enabled && (this.options.answerPings ?? true)) this.ai.goals.add(this.pingGoal)\n\t\tthis.enabled = true\n\t}\n\n\t/** How it plays with its team: the module's options, the brain's settings over them (`ai.settings.team`) */\n\tget options(): TeamOptions {\n\t\treturn this.ai.cache('team.options', () => ({ ...this.moduleOptions, ...this.ai.settings.team }))\n\t}\n\n\t/** Whether its waves wait for the team's plan (`together`) */\n\tget together(): boolean {\n\t\treturn this.enabled && !!this.options.together\n\t}\n\n\t/** The team's board: the world's, shared by the team's computers, or its own where the seat gave none */\n\tget board(): TeamBoard {\n\t\treturn this.shared?.() ?? this.own\n\t}\n\n\t/** Its team's number */\n\tget team(): number {\n\t\treturn this.ai.view.me.team\n\t}\n\n\t/** The computers of its team, as seen on the board lately (each writes itself as it thinks), itself among them */\n\tcomputers(): PlayerId[] {\n\t\tconst { board, ai } = this\n\t\tconst recent = ai.tick - 10 * ai.session.tickRate\n\t\treturn Object.entries(board.known)\n\t\t\t.filter(([, known]) => known.tick >= recent)\n\t\t\t.map(([id]) => Number(id))\n\t\t\t.sort((a, b) => a - b)\n\t}\n\n\t/** The requests on the board, those of a kind where given: those still standing */\n\trequests(kind?: TeamRequest['kind']): TeamRequest[] {\n\t\tconst { tick } = this.ai\n\t\treturn this.board.requests.filter((each) => each.until > tick && (kind === undefined || each.kind === kind))\n\t}\n\n\t/**\n\t * Asks the team for something at a place: a request on the board, or the one of the same asker, kind and place made\n\t * to stand longer, with the strength seen now. Gives back the request\n\t */\n\trequest(\n\t\tkind: TeamRequest['kind'],\n\t\tat: Vec2,\n\t\tstrength: number,\n\t\tby: TeamRequest['by'],\n\t\tfrom: PlayerId = this.ai.playerId,\n\t\tseconds?: number\n\t): TeamRequest {\n\t\tconst { ai, board } = this\n\t\tconst until = ai.tick + Math.round((seconds ?? this.options.requestFor ?? 30) * ai.session.tickRate)\n\t\tconst same = board.requests.find(\n\t\t\t(each) => each.from === from && each.kind === kind && each.until > ai.tick && distSq(each.at, at) <= SAME_PLACE * SAME_PLACE\n\t\t)\n\t\tif (same) {\n\t\t\tsame.until = Math.max(same.until, until)\n\t\t\tsame.strength = Math.max(same.strength, strength)\n\t\t\treturn same\n\t\t}\n\t\tconst request: TeamRequest = { id: board.next++, kind, from, at: point(at), strength, until, by, answered: [] }\n\t\tboard.requests.push(request)\n\t\tai.decide(`asks for ${kind} at ${where(at)}${from === ai.playerId ? '' : ` for player ${from}`} (${by}, strength ${Math.round(strength)})`, {\n\t\t\tkind: 'team'\n\t\t})\n\t\treturn request\n\t}\n\n\t/** The enemy's bases the team knows, every computer's put together: one a place, the latest seen */\n\tenemyBases(): { owner: PlayerId; at: Vec2; last: number }[] {\n\t\tconst merged: { owner: PlayerId; at: Vec2; last: number }[] = []\n\t\tconst known = this.board.known\n\t\tfor (const id of Object.keys(known).sort((a, b) => Number(a) - Number(b))) {\n\t\t\tfor (const base of known[id].bases) {\n\t\t\t\tconst same = merged.find((each) => each.owner === base.owner && distSq(each.at, base.at) < SAME_PLACE * SAME_PLACE)\n\t\t\t\tif (same) same.last = Math.max(same.last, base.last)\n\t\t\t\telse merged.push({ ...base, at: point(base.at) })\n\t\t\t}\n\t\t}\n\t\treturn merged\n\t}\n\n\t/** The plan of an attack together, while it stands */\n\tget plan(): AttackPlan | undefined {\n\t\tconst plan = this.board.plan\n\t\treturn plan && this.ai.tick <= plan.at + PLAN_OVER * this.ai.session.tickRate ? plan : undefined\n\t}\n\n\t/** Proposes an attack together: a target, the waves to go `gatherFor` seconds from now. Joined by the proposer */\n\tpropose(target: Vec2): AttackPlan {\n\t\tconst { ai } = this\n\t\tconst plan: AttackPlan = {\n\t\t\ttarget: point(target),\n\t\t\tat: ai.tick + Math.round((this.options.gatherFor ?? 20) * ai.session.tickRate),\n\t\t\tby: ai.playerId,\n\t\t\tjoined: [ai.playerId],\n\t\t\tdeclined: [],\n\t\t\tsince: ai.tick\n\t\t}\n\t\tthis.board.plan = plan\n\t\tai.decide(`proposes an attack together on ${where(target)} in ${this.options.gatherFor ?? 20} s`, { kind: 'team' })\n\t\treturn plan\n\t}\n\n\t/** Joins the plan standing: its wave goes with the others' */\n\tjoin(): void {\n\t\tconst plan = this.plan\n\t\tif (!plan || plan.joined.includes(this.ai.playerId)) return\n\t\tplan.joined.push(this.ai.playerId)\n\t\tplan.declined = plan.declined.filter((each) => each !== this.ai.playerId)\n\t\tthis.ai.decide(`joins player ${plan.by}'s attack on ${where(plan.target)}`, { kind: 'team' })\n\t}\n\n\t/** Says no to the plan standing: its wave goes on its own time */\n\tdecline(): void {\n\t\tconst plan = this.plan\n\t\tif (!plan || plan.declined.includes(this.ai.playerId) || plan.joined.includes(this.ai.playerId)) return\n\t\tplan.declined.push(this.ai.playerId)\n\t\tthis.ai.decide(`declines player ${plan.by}'s attack on ${where(plan.target)}: its wave is not ready`, { kind: 'team' })\n\t}\n\n\t/** Says a line of the game's to its side (`say`, `lines`), no more than once in ten seconds a line */\n\tsay(line: 'attacking' | 'helping' | 'retreating'): void {\n\t\tconst { ai } = this\n\t\tconst options = this.options\n\t\tconst text = options.lines?.[line]\n\t\tif (!this.enabled || !options.say || !text) return\n\t\tconst last = this.memory.said[line]\n\t\tif (last !== undefined && ai.tick - last < 10 * ai.session.tickRate) return\n\t\tthis.memory.said[line] = ai.tick\n\t\tai.send({ type: 'chat', text, to: 'allies' })\n\t}\n\n\t/**\n\t * The think, once a think: the board brought up to date (what is over dropped, itself and what it knows written),\n\t * the people heard (pings, damage to allies), its own raids asked help for, the plan answered\n\t */\n\tthink(): void {\n\t\tconst { ai, board } = this\n\t\tconst tick = ai.tick\n\t\tboard.requests = board.requests.filter((each) => each.until > tick)\n\t\tif (board.plan && tick > board.plan.at + PLAN_OVER * ai.session.tickRate) delete board.plan\n\t\tif (ai.def.knowledge !== false) {\n\t\t\tboard.known[ai.playerId] = {\n\t\t\t\ttick,\n\t\t\t\tbases: ai.knowledge.enemy\n\t\t\t\t\t.bases()\n\t\t\t\t\t.filter((base) => !base.gone)\n\t\t\t\t\t.map((base) => ({ owner: base.owner, at: point(base.at), last: base.last }))\n\t\t\t}\n\t\t} else board.known[ai.playerId] = { tick, bases: [] }\n\t\tconst heardFrom = this.memory.heard\n\t\tthis.memory.heard = tick\n\t\tif (ai.def.knowledge !== false && heardFrom >= 0) this.hear(heardFrom)\n\t\tif (this.options.answerPings ?? true) this.fallBack()\n\t\tif ((this.options.askForHelp ?? true) && ai.area(Defence).enabled) {\n\t\t\tfor (const raid of ai.area(Defence).raids()) {\n\t\t\t\tif (raid.strength * ai.area(Defence).margin <= this.homeStrength()) continue\n\t\t\t\tthis.request('help', raid.base.at, raid.strength, 'raid')\n\t\t\t}\n\t\t}\n\t\t// a plan of another's not joined by the think after it was proposed: declined\n\t\tconst plan = this.plan\n\t\tif (plan && plan.by !== ai.playerId && !plan.joined.includes(ai.playerId) && plan.since < heardFrom) this.decline()\n\t}\n\n\t/**\n\t * An ally's ping to fall back (`rally`), not answered yet: its squads out (waves, raids, harassers, a push; not what\n\t * defends, helps or looks) come home, and it says so. What that ally pinged to push or hold before is not done any\n\t * more (`pinged`): the latest ping of a person's is what it asks\n\t */\n\tprivate fallBack(): void {\n\t\tconst { ai } = this\n\t\tconst home = ai.view.home()\n\t\tif (!home) return\n\t\tfor (const request of this.requests('rally')) {\n\t\t\tif (request.by !== 'ping' || request.from === ai.playerId || request.answered.includes(ai.playerId)) continue\n\t\t\trequest.answered.push(ai.playerId)\n\t\t\tconst out = ai.squads\n\t\t\t\t.all()\n\t\t\t\t.squads.filter(\n\t\t\t\t\t(squad) =>\n\t\t\t\t\t\tsquad.alive &&\n\t\t\t\t\t\tsquad.length &&\n\t\t\t\t\t\t(![DEFEND, HELP, PINGED, 'scout'].includes(squad.owner ?? '') || squad.name === PING_SQUADS.attack) &&\n\t\t\t\t\t\tsquad.current?.kind !== 'retreat'\n\t\t\t\t)\n\t\t\tfor (const squad of out) squad.retreat(home, `player ${request.from} asks to fall back`)\n\t\t\tai.decide(`falls back home at player ${request.from}'s ping: ${out.length ? out.map((squad) => squad.name).join(', ') : 'nothing out'}`, {\n\t\t\t\tkind: 'team'\n\t\t\t})\n\t\t\tif (out.length) this.say('retreating')\n\t\t}\n\t}\n\n\t/**\n\t * The ping of an ally's it does now: the latest standing `attack` or `defend` of another's, in reach of home, and\n\t * not before a `rally` of theirs since (a retreat asked after a push is what they want now)\n\t */\n\tprivate pinged(): TeamRequest | undefined {\n\t\tconst { ai } = this\n\t\treturn ai.cache('team.pinged', () => {\n\t\t\tconst home = ai.view.home()\n\t\t\tif (!home) return undefined\n\t\t\tconst rallies = this.requests('rally').filter((each) => each.by === 'ping')\n\t\t\tconst candidates = [...this.requests('attack'), ...this.requests('defend')].filter(\n\t\t\t\t(each) =>\n\t\t\t\t\teach.by === 'ping' &&\n\t\t\t\t\teach.from !== ai.playerId &&\n\t\t\t\t\tdistSq(each.at, home) <= HELP_REACH * HELP_REACH &&\n\t\t\t\t\t!rallies.some((rally) => rally.from === each.from && rally.id > each.id)\n\t\t\t)\n\t\t\tcandidates.sort((a, b) => b.id - a.id)\n\t\t\treturn candidates[0]\n\t\t})\n\t}\n\n\t/**\n\t * The goal that does what an ally's ping asks: a squad to fight there (`push`), or to hold the place (`hold`). One at\n\t * a time: a later ping takes the units of the one before\n\t */\n\tprivate makePingGoal(): GoalDef {\n\t\tconst sent = (available: UnitSet, request: TeamRequest) => this.helpers(available, { at: request.at, strength: this.seenAt(request.at) })\n\t\treturn defineGoal({\n\t\t\tid: PINGED,\n\t\t\tweight: 0.75,\n\t\t\tconsiderations: [\n\t\t\t\tconsider('an ally pings to push or hold', () => (this.pinged() ? 1 : 0), curve.step(1)),\n\t\t\t\tconsider(\n\t\t\t\t\t'enough to send',\n\t\t\t\t\t(ai) => {\n\t\t\t\t\t\tconst request = this.pinged()\n\t\t\t\t\t\treturn request ? sent(ai.goals.pool(), request).length : 0\n\t\t\t\t\t},\n\t\t\t\t\tcurve.step(1)\n\t\t\t\t)\n\t\t\t],\n\t\t\tclaims: {\n\t\t\t\tunits: (_ai, available) => {\n\t\t\t\t\tconst request = this.pinged()\n\t\t\t\t\treturn request ? sent(available, request) : []\n\t\t\t\t}\n\t\t\t},\n\t\t\tcommitment: 10,\n\t\t\trun: (ai, claimed) => {\n\t\t\t\tconst request = this.pinged()\n\t\t\t\tif (!request || (request.kind !== 'attack' && request.kind !== 'defend')) return\n\t\t\t\tconst name = PING_SQUADS[request.kind]\n\t\t\t\t// sent there already: it goes on while the ping stands\n\t\t\t\tconst there = ai.squads.named(name)\n\t\t\t\tconst at = there?.current?.data.at as Vec2 | undefined\n\t\t\t\tif (there && at && distSq(at, request.at) <= SAME_PLACE * SAME_PLACE && there.done === undefined) return\n\t\t\t\tconst squad = claimed.squad(name, claimed.units)\n\t\t\t\tif (request.kind === 'attack') squad.attack(request.at)\n\t\t\t\telse squad.defend(request.at, SEEN_NEAR)\n\t\t\t\tif (!request.answered.includes(ai.playerId)) request.answered.push(ai.playerId)\n\t\t\t\tai.decide(\n\t\t\t\t\t`${request.kind === 'attack' ? 'pushes' : 'holds'} at ${where(request.at)} with ${claimed.units.length}, at player ${request.from}'s ping`,\n\t\t\t\t\t{ kind: 'team', goal: PINGED }\n\t\t\t\t)\n\t\t\t\tif (request.kind === 'attack') this.say('attacking')\n\t\t\t}\n\t\t})\n\t}\n\n\t/** Its fighters at home nothing holds: what it meets a raid with before it asks */\n\tprivate homeStrength(): number {\n\t\tconst { ai } = this\n\t\treturn ai.goals.pool().fighters().strength()\n\t}\n\n\t/** What was heard since the last think: the people's pings at a place, damage done to an ally where it was seen */\n\tprivate hear(since: number): void {\n\t\tconst { ai } = this\n\t\tconst { view } = ai\n\t\tconst ally = (player: PlayerId) => player !== ai.playerId && view.player(player)?.relation === 'ally'\n\t\tfor (const ping of ai.knowledge.events.pings()) {\n\t\t\tif (ping.tick <= since || !ally(ping.player)) continue\n\t\t\t// what the kind asks, as the game's rules say (`RuleSettings.talk.pings.meanings`)\n\t\t\tconst meaning = ai.session.registry.settings.talk.pings.meanings?.[ping.kind]\n\t\t\tif (meaning && meaning !== 'ignore') this.request(meaning, ping.at, meaning === 'help' ? this.seenAt(ping.at) : 0, 'ping', ping.player)\n\t\t\telse ai.decide(`hears player ${ping.player}'s ${ping.kind} at ${where(ping.at)}`, { kind: 'team' })\n\t\t}\n\t\tfor (const hit of ai.knowledge.events.damage()) {\n\t\t\tif (hit.tick <= since || !ally(hit.owner)) continue\n\t\t\tconst strength = this.seenAt(hit.at)\n\t\t\tif (strength > 0) this.request('help', hit.at, strength, 'damage', hit.owner)\n\t\t}\n\t}\n\n\t/** The strength of the enemies in sight near a place */\n\tprivate seenAt(at: Vec2): number {\n\t\treturn this.ai.view.enemies.units().alive().near(at, SEEN_NEAR).strength()\n\t}\n\n\t/** The request it would answer now: the strongest standing of another, in reach of home, it can send enough to */\n\tprivate calling(): TeamRequest | undefined {\n\t\tconst { ai } = this\n\t\treturn ai.cache('team.calling', () => {\n\t\t\tconst home = ai.view.home()\n\t\t\tif (!home) return undefined\n\t\t\tconst candidates = this.requests('help').filter((each) => each.from !== ai.playerId && distSq(each.at, home) <= HELP_REACH * HELP_REACH)\n\t\t\tcandidates.sort((a, b) => b.strength - a.strength || a.id - b.id)\n\t\t\treturn candidates[0]\n\t\t})\n\t}\n\n\t/** How much stronger than a call what is sent to it is: from the odds asked, by the square law (one in two: as strong) */\n\tget margin(): number {\n\t\tconst odds = Math.min(0.95, Math.max(0.05, this.options.helpOdds ?? 0.5))\n\t\treturn Math.sqrt(odds / (1 - odds))\n\t}\n\n\t/** Who it sends to a call: its idle fighters nothing holds, the nearest first, as many as make the odds asked */\n\tprivate helpers(available: UnitSet, request: Pick<TeamRequest, 'strength' | 'at'>): UnitSet {\n\t\tconst { ai } = this\n\t\tconst need = request.strength * this.margin\n\t\tconst idle = available\n\t\t\t.fighters()\n\t\t\t.idle()\n\t\t\t.items.slice()\n\t\t\t.sort((a, b) => distSq(a, request.at) - distSq(b, request.at) || a.id - b.id)\n\t\tconst chosen: EntityState[] = []\n\t\tlet got = 0\n\t\tfor (const unit of idle) {\n\t\t\tif (request.strength > 0 ? got >= need : chosen.length >= HELP_UNSEEN) break\n\t\t\tchosen.push(unit)\n\t\t\tgot += ai.view.strength.of(unit)\n\t\t}\n\t\t// not enough to make the odds: none sent, rather than a few to their deaths\n\t\tif (request.strength > 0 && got < need) return available.where(() => false)\n\t\treturn available.where((unit) => chosen.includes(unit))\n\t}\n\n\t/** The help goal: a call of an ally's standing, and enough to send to it */\n\tprivate makeGoal(): GoalDef {\n\t\treturn defineGoal({\n\t\t\tid: HELP,\n\t\t\tweight: 0.7,\n\t\t\tconsiderations: [\n\t\t\t\tconsider('an ally calls for help', () => (this.calling() ? 1 : 0), curve.step(1)),\n\t\t\t\tconsider(\n\t\t\t\t\t'enough to send',\n\t\t\t\t\t(ai) => {\n\t\t\t\t\t\tconst request = this.calling()\n\t\t\t\t\t\treturn request ? this.helpers(ai.goals.pool(), request).length : 0\n\t\t\t\t\t},\n\t\t\t\t\tcurve.step(1)\n\t\t\t\t)\n\t\t\t],\n\t\t\tclaims: {\n\t\t\t\tunits: (_ai, available) => {\n\t\t\t\t\tconst request = this.calling()\n\t\t\t\t\treturn request ? this.helpers(available, request) : []\n\t\t\t\t}\n\t\t\t},\n\t\t\tcommitment: 10,\n\t\t\trun: (ai, claimed) => {\n\t\t\t\tconst request = this.calling()\n\t\t\t\tif (!request) return\n\t\t\t\tconst squad = ai.squads.named('help')\n\t\t\t\tconst at = squad?.current?.data.at as Vec2 | undefined\n\t\t\t\tif (squad && at && distSq(at, request.at) <= SAME_PLACE * SAME_PLACE && squad.done === undefined) {\n\t\t\t\t\t// there already: made up to what the call is now (more of them seen there), from what nothing holds\n\t\t\t\t\tconst more = this.helpers(ai.goals.pool(), {\n\t\t\t\t\t\t...request,\n\t\t\t\t\t\tstrength: Math.max(0, request.strength * this.margin - squad.strength()) / this.margin\n\t\t\t\t\t})\n\t\t\t\t\tif (request.strength > 0 && more.length) squad.add(more, 'more seen there')\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t\tclaimed.squad('help', claimed.units).defend(request.at, SEEN_NEAR)\n\t\t\t\tif (!request.answered.includes(ai.playerId)) request.answered.push(ai.playerId)\n\t\t\t\tai.decide(`answers player ${request.from}'s call for help at ${where(request.at)} with ${claimed.units.length}`, { kind: 'team', goal: HELP })\n\t\t\t\tthis.say('helping')\n\t\t\t}\n\t\t})\n\t}\n\n\t/** Team play as the report shows it */\n\treport(): TeamReport {\n\t\tconst { ai } = this\n\t\tconst tickRate = ai.session.tickRate\n\t\tconst plan = this.plan\n\t\treturn {\n\t\t\tteam: this.team,\n\t\t\tcomputers: this.computers(),\n\t\t\trequests: this.requests().map((each) => ({\n\t\t\t\tid: each.id,\n\t\t\t\tkind: each.kind,\n\t\t\t\tfrom: each.from,\n\t\t\t\tat: pair(each.at),\n\t\t\t\tstrength: Math.round(each.strength),\n\t\t\t\tby: each.by,\n\t\t\t\tanswered: [...each.answered],\n\t\t\t\tleft: Math.max(0, Math.round((each.until - ai.tick) / tickRate))\n\t\t\t})),\n\t\t\t...(plan && {\n\t\t\t\tplan: {\n\t\t\t\t\ttarget: pair(plan.target),\n\t\t\t\t\tin: Math.round((plan.at - ai.tick) / tickRate),\n\t\t\t\t\tby: plan.by,\n\t\t\t\t\tjoined: [...plan.joined],\n\t\t\t\t\tdeclined: [...plan.declined]\n\t\t\t\t}\n\t\t\t}),\n\t\t\tenemyBases: this.enemyBases().length\n\t\t}\n\t}\n\n\t/** What it remembers, for a save: a copy (the board is the world's, saved with it) */\n\t/** Whether it has anything to remember now: one that does not is left out of a save */\n\tremembers(): boolean {\n\t\treturn this.enabled\n\t}\n\n\t/** Its part of the brain's report */\n\treportTo(report: AiReport): void {\n\t\tif (this.enabled) report.team = this.report()\n\t}\n\n\t/** Gives a copy of the team play's memory, for a save of the brain */\n\tsave(): TeamPlayMemory {\n\t\treturn { v: 1, heard: this.memory.heard, said: { ...this.memory.said } }\n\t}\n\n\t/** Takes back what `save` gave: whether it was read */\n\trestore(memory: unknown): boolean {\n\t\tconst given = memory as TeamPlayMemory | undefined\n\t\tif (!given || typeof given !== 'object' || given.v !== 1) return false\n\t\tthis.memory = { v: 1, heard: given.heard ?? -1, said: { ...(given.said ?? {}) } }\n\t\treturn true\n\t}\n}\n\n/**\n * The team module: the team's board brought up to date each think (`ai.team.think`: itself and what it knows written,\n * pings and an ally's damage heard as calls for help, its own raids asked help for, the plan of an attack together\n * answered), and the `help` goal on the picker. With how it plays where the brain's definition and the seat's options\n * say nothing (`TeamOptions`)\n *\n * @beta\n */\nexport const team = (options: TeamOptions = {}): AiModuleDef =>\n\tdefineModule({ id: 'team', make: (ai: Brain): AiModule => {\n\t\tai.area(Team).configure(options)\n\t\treturn {\n\t\t\tid: 'team',\n\t\t\tphase: 'sense',\n\t\t\tafter: ['defence'],\n\t\t\tthink: () => ai.area(Team).think()\n\t\t}\n\t} })\n\ndeclare module './area' {\n\tinterface AreaMemories {\n\t\tteam?: TeamPlayMemory\n\t}\n}\n"],"mappings":"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"}

package/dist/ai/threat.d.ts

@@ -23,7 +23,9 @@ export interface Threat {
 export interface ThreatCell extends Threat {
     /** The middle of the cell */
     at: Vec2;
+    /** The cell's column on the grid, counted from 0 */
     col: number;
+    /** The cell's row on the grid, counted from 0 */
     row: number;
 }
 /**
@@ -33,7 +35,9 @@ export interface ThreatCell extends Threat {
  * @beta
  */
 export interface ThreatQuery {
+    /** The layer the thing asked about is on; `ground` when left out */
     layer?: Layer;
+    /** Whether enemy structures remembered but out of sight count too */
     remembered?: boolean;
 }
 /**
@@ -50,7 +54,9 @@ export declare class ThreatMap {
     readonly view: AiView;
     /** Cells across and down, and the side of one */
     readonly cols: number;
+    /** How many cells down the grid has */
     readonly rows: number;
+    /** The side of a cell in cells of the map */
     readonly cell = 8;
     private seen;
     private withRemembered;