@aephia/atlas-kit 0.6.0-next.15 → 0.6.0-next.150

package/dist/internal/planning/fleet-respawn.d.ts

@@ -0,0 +1,28 @@
+import { type Address, type Commitment } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+export interface FleetRespawnIntent {
+    readonly phase: 'start' | 'complete';
+    readonly fleet: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly system: Address;
+}
+/** Fresh bounded eligibility and debit checks shared by planning and pre-sign validation. */
+export declare function resolveFleetRespawn(ctx: SageContext, input: FleetRespawnIntent, expected?: {
+    readonly fleetHash: string;
+    readonly maximumRecoveryFee: bigint;
+    readonly maximumProfileDebit: bigint;
+}, commitment?: Commitment): Promise<{
+    instruction: import("@solana/kit").Instruction<string, readonly (import("@solana/kit").AccountMeta<string> | import("@solana/kit").AccountLookupMeta<string, string>)[]>;
+    recoveryFee: bigint;
+    profileDebit: bigint;
+    fleetHash: string;
+    inventory: {
+        cargo: readonly import("../c4/fleet.js").FleetCargoAmountData[];
+        ammunition: import("../c4/fleet.js").FleetCargoAmountData;
+        fuel: import("../c4/fleet.js").FleetCargoAmountData;
+    };
+}>;
+//# sourceMappingURL=fleet-respawn.d.ts.map

package/dist/internal/planning/fleet-respawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-respawn.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-respawn.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA2CzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAOD,6FAA6F;AAC7F,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,CAAC,EAAE;IACT,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,EACD,UAAU,GAAE,UAAwB;;;;;;;;;;GAuNrC"}

package/dist/internal/planning/fleet-respawn.js

@@ -0,0 +1,164 @@
+import { deriveCurrencyCache, validateCurrencyCache, } from '../c4/currency-cache.js';
+import { isOffCurveAddress } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { requireGameAddress } from '../game-context.js';
+import { readFreshGameShipAssemblyCatalog } from '../../registry/ships.js';
+import { readFreshGameRuntimeVersion } from '../../registry/xp-runtime.js';
+import { fleetAccountDefinition, deriveFleetAddress } from '../c4/fleet.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { characterAccountDefinition, findCharacterPda, } from '../c4/character.js';
+import { starSystemAccountDefinition, deriveStarSystemAddress, } from '../c4/world.js';
+import { starbasePlayerAccountDefinition, deriveStarbasePlayerAddress, } from '../c4/starbase.js';
+import { deriveRegionTrackerAddress, regionTrackerAccountDefinition, } from '../c4/factions.js';
+import { deriveFleetCrewBindingAddress, fleetCrewBindingAccountDefinition, matchesFleetCrewBindingIdentity, } from '../c4/fleet-crew-binding.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { fleetRespawnSize, fleetRespawnInstruction, } from '../c4/fleet-respawn.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+import { hashAccountState } from './account-state.js';
+import { directProfileKey, grantsPermission, hasPermissionBit, profileKeyExpired, } from './profile-key.js';
+function fail(message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${message} Refresh the Fleet and required recovery accounts, then recreate and inspect the recovery Plan before signing.`);
+}
+/** Fresh bounded eligibility and debit checks shared by planning and pre-sign validation. */
+export async function resolveFleetRespawn(ctx, input, expected, commitment = 'confirmed') {
+    const intent = { ...input };
+    if (requireGameAddress(ctx) !== intent.game ||
+        !['start', 'complete'].includes(intent.phase) ||
+        !Number.isInteger(intent.keyIndex) ||
+        intent.keyIndex < 0 ||
+        intent.keyIndex > 65535 ||
+        isOffCurveAddress(intent.authority))
+        fail('Recovery requires this deployment’s Game and an on-curve direct Profile key with a valid key index.');
+    const [character, regionTracker, crewBinding, [currencyCache]] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveRegionTrackerAddress(intent.game),
+        deriveFleetCrewBindingAddress(intent.fleet),
+        deriveCurrencyCache(intent.game),
+    ]);
+    const starbasePlayer = await deriveStarbasePlayerAddress(intent.system, character);
+    const addresses = [
+        intent.fleet,
+        intent.profile,
+        intent.system,
+        CLOCK_ADDRESS,
+        RENT_ADDRESS,
+        ...(intent.phase === 'start'
+            ? [character, regionTracker, crewBinding, currencyCache]
+            : [starbasePlayer]),
+    ];
+    const rows = await readContextRawAccounts(ctx, addresses, {
+        commitment,
+    });
+    if (rows.some((raw) => raw?.executable))
+        fail('Recovery account reads contain an executable account.');
+    const accounts = new Map(addresses.map((address, i) => [address, rows[i]]));
+    const required = (address) => accounts.get(address) ?? fail(`Recovery account ${address} is missing.`);
+    const fleetRaw = required(intent.fleet), profileRaw = required(intent.profile);
+    const fleet = fleetAccountDefinition.decode(fleetRaw), profile = profileAccountDefinition.decode(profileRaw), system = starSystemAccountDefinition.decode(required(intent.system));
+    if (fleet.game !== intent.game ||
+        fleet.ownerProfile !== intent.profile ||
+        fleet.npcFactionId !== 0 ||
+        fleet.faction === 'unaligned' ||
+        (await deriveFleetAddress(fleet)) !== intent.fleet ||
+        fleet.subProfile !== '11111111111111111111111111111111')
+        fail('Recovery requires a canonical owned player Fleet without a SubProfile route.');
+    if (system.game !== intent.game ||
+        (await deriveStarSystemAddress(intent.game, system.systemId)) !==
+            intent.system ||
+        system.starbase?.level !== 'css' ||
+        system.starbase.owner !== fleet.faction)
+        fail('Recovery destination must be the canonical same-Game CSS matching the Fleet faction.');
+    const now = readClock(required(CLOCK_ADDRESS)), rent = readRent(required(RENT_ADDRESS));
+    if (fleet.hp <= 0)
+        fail('This recovery route requires a Fleet with positive hull health; use a separately supported destroyed-Fleet recovery route.');
+    if (intent.phase === 'start'
+        ? fleet.state.kind !== 'idle'
+        : fleet.state.kind !== 'respawn' ||
+            now < fleet.state.recoversAtUnixSeconds)
+        fail(intent.phase === 'start'
+            ? 'Recovery start requires a non-destroyed Idle Fleet.'
+            : 'Timed recovery completion requires a Respawn Fleet whose timer has elapsed according to chain time.');
+    const fleetHash = await hashAccountState(fleetRaw.owner, fleetRaw.data);
+    if (expected && fleetHash !== expected.fleetHash)
+        fail('The Fleet changed after this recovery Plan was prepared; its assets or recovery state may differ.');
+    let recoveryFee = 0n;
+    let selectedCrew;
+    if (intent.phase === 'start') {
+        const owner = characterAccountDefinition.decode(required(character));
+        if (owner.playerProfile !== intent.profile || owner.game !== intent.game)
+            fail('Recovery Character does not belong to the selected Profile and Game.');
+        const tracker = regionTrackerAccountDefinition.decode(required(regionTracker));
+        if (tracker.game !== intent.game)
+            fail('Recovery RegionTracker belongs to a different Game.');
+        await validateCurrencyCache(required(currencyCache), intent.game, 'Fleet recovery');
+        const binding = accounts.get(crewBinding);
+        if (binding) {
+            if (!matchesFleetCrewBindingIdentity(fleetCrewBindingAccountDefinition.decode(binding), intent.fleet, intent.profile))
+                fail('Recovery CrewBinding belongs to a different Fleet or Profile.');
+            selectedCrew = crewBinding;
+        }
+        const { catalog, rawAccount } = await readFreshGameShipAssemblyCatalog(ctx, { commitment });
+        if (rawAccount.address !== intent.game ||
+            rawAccount.executable ||
+            rawAccount.slot < fleetRaw.slot)
+            fail('Recovery ship definitions are older than the selected Fleet or belong to a different Game.');
+        if (rawAccount.data[8] !== 2)
+            fail('Recovery start requires the supported current Game runtime.');
+        for (const held of fleet.fleetShips) {
+            const ship = catalog.rows.find((row) => row.id === held.shipId);
+            if (!ship)
+                fail(`Recovery hull definition ${held.shipId} is missing from the current Game.`);
+            recoveryFee += ship.stats.miscStats.recoveryFee * held.quantity;
+        }
+        if (owner.atlasRaw < recoveryFee)
+            fail(`The Character ATLAS vault cannot cover the ${recoveryFee} Floyd recovery fee. Deposit sufficient ATLAS explicitly before preparing recovery.`);
+    }
+    else {
+        if ((await readFreshGameRuntimeVersion(ctx, intent.game, {
+            commitment,
+        })) !== 2)
+            fail('Recovery completion requires the supported current Game runtime.');
+        const player = starbasePlayerAccountDefinition.decode(required(starbasePlayer));
+        if (player.character !== character ||
+            player.playerProfile !== intent.profile ||
+            player.system !== intent.system ||
+            player.faction !== fleet.faction)
+            fail('Recovery CSS StarbasePlayer has a different Profile, Character, System or faction.');
+    }
+    const targetRent = rent(fleetRespawnSize(fleetRaw, intent.phase, intent.system));
+    const profileDebit = targetRent > fleetRaw.lamports ? targetRent - fleetRaw.lamports : 0n;
+    if (expected &&
+        (profileDebit > expected.maximumProfileDebit ||
+            recoveryFee > expected.maximumRecoveryFee))
+        fail('Recovery fees or Profile rent debit now exceed the amounts approved by this Plan.');
+    if (profileRaw.lamports < rent(profileRaw.data.length) + profileDebit)
+        fail('The Profile cannot fund Fleet storage growth while preserving its own rent reserve. Fund the Profile or Fleet explicitly.');
+    const key = directProfileKey(profile.keys, intent.keyIndex, intent.authority);
+    if (!key || profileKeyExpired(key, now))
+        fail('Recovery authority is not the selected current unexpired direct Profile key.');
+    const auth = grantsPermission(key, PROFILE_SCOPE, 0n);
+    if (!auth && !grantsPermission(key, SAGE_SCOPE, 21n))
+        fail('Recovery requires a direct Profile AUTH key or SAGE respawn permission.');
+    if (profileDebit > 0n && !auth && !hasPermissionBit(key, 63n))
+        fail('Recovery storage growth requires Profile vault funding authority. Explicitly prefund the Fleet or choose an authorized drainSolVault key.');
+    return {
+        instruction: fleetRespawnInstruction(intent, {
+            character,
+            regionTracker,
+            currencyCache,
+            starbasePlayer,
+            ...(selectedCrew ? { crewBinding: selectedCrew } : {}),
+        }),
+        recoveryFee,
+        profileDebit,
+        fleetHash,
+        inventory: {
+            cargo: fleet.cargoHold.amounts,
+            ammunition: fleet.ammoBank,
+            fuel: fleet.fuelTank,
+        },
+    };
+}
+//# sourceMappingURL=fleet-respawn.js.map

package/dist/internal/planning/fleet-respawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-respawn.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-respawn.ts"],"names":[],"mappings":"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"}

package/dist/internal/planning/fleet-ship-assembly.d.ts

@@ -0,0 +1,36 @@
+import { type ShipAssemblyCatalog } from '../../registry/ships.js';
+import { type Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+export interface FleetShipAssemblyIntent {
+    readonly address: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly system: Address;
+    readonly keyIndex: number;
+    readonly shipId: number;
+    readonly amount: bigint;
+}
+export interface FleetShipAssemblyAccounts {
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly system: Address;
+    readonly character: Address;
+    readonly profileFaction: Address;
+    readonly starbasePlayer: Address;
+    readonly fleet: Address;
+    readonly rent: Address;
+    readonly clock: Address;
+}
+export declare function resolveFleetShipAssembly(input: FleetShipAssemblyIntent): Promise<FleetShipAssemblyAccounts>;
+export declare function validateFleetShipAssembly(input: FleetShipAssemblyIntent, resolved: FleetShipAssemblyAccounts, accounts: ReadonlyMap<Address, RawAccount | undefined>, expected?: {
+    readonly configHash: string;
+    readonly maximumProfileDebit: bigint;
+}, catalog?: ShipAssemblyCatalog): Promise<{
+    profileDebit: bigint;
+    profileReserve: bigint;
+    fleetRent: bigint;
+    configHash: string;
+}>;
+//# sourceMappingURL=fleet-ship-assembly.d.ts.map

package/dist/internal/planning/fleet-ship-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-ship-assembly.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-ship-assembly.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAgB5D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AACD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CAkBpC;AAID,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,EAAE,yBAAyB,EACnC,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,QAAQ,CAAC,EAAE;IACT,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,EACD,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA+ND"}

package/dist/internal/planning/fleet-ship-assembly.js

@@ -0,0 +1,158 @@
+import { SYSTEM_PROGRAM } from '../system-program.js';
+import { fleetAccountDefinition, deriveFleetAddress } from '../c4/fleet.js';
+import { MAX_COMMANDERS_AND_TITANS_PER_FLEET, MAX_TITANS_PER_FLEET, fleetCapacityPoints, fleetShipAssemblySize, prospectiveShipCounts, shipSizeName, shipSizeRank, starbasePlayerEscrowGrowth, } from '../c4/fleet-ship-assembly.js';
+import { decodeGameShipAssemblyCatalog, hashShipAssemblyConfiguration, } from '../../registry/ships.js';
+import { isOffCurveAddress } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { findCharacterPda } from '../c4/character.js';
+import { deriveProfileFactionAddress } from '../c4/profile-faction.js';
+import { deriveStarbasePlayerAddress } from '../c4/starbase.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+import { directProfileKey, grantsPermission, hasPermissionBit, profileKeyExpired, } from './profile-key.js';
+import { readOwnStarbaseFacts } from './own-starbase-facts.js';
+export async function resolveFleetShipAssembly(input) {
+    const intent = { ...input };
+    const [character, profileFaction] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveProfileFactionAddress(intent.profile),
+    ]);
+    return {
+        game: intent.game,
+        profile: intent.profile,
+        authority: intent.authority,
+        system: intent.system,
+        character,
+        profileFaction,
+        fleet: intent.address,
+        starbasePlayer: await deriveStarbasePlayerAddress(intent.system, character),
+        rent: RENT_ADDRESS,
+        clock: CLOCK_ADDRESS,
+    };
+}
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+export async function validateFleetShipAssembly(input, resolved, accounts, expected, catalog) {
+    const intent = { ...input };
+    if (isOffCurveAddress(intent.authority))
+        fail(intent.profile, 'Ship assembly requires an on-curve direct Profile authority. Select a current direct key and replan.');
+    const required = (address, name) => {
+        const raw = accounts.get(address);
+        if (!raw)
+            fail(address, `${name} ${address} is missing. Create or select the required account, then replan ship assembly.`);
+        if (raw.executable)
+            fail(address, `${name} ${address} is executable. Refresh valid account state before assembling ships.`);
+        return raw;
+    };
+    // The program assembles at any Starbase where the Character has a current
+    // StarbasePlayer of the Fleet's faction, whoever owns the Starbase.
+    const { profileRaw, profile, character, faction, system, player } = await readOwnStarbaseFacts(intent, resolved, required, {
+        replan: 'replan ship assembly',
+        before: 'before assembling ships',
+    }, { anyStarbase: true });
+    if (player.sequenceId !== system.sequenceId)
+        fail(resolved.starbasePlayer, `The StarbasePlayer belongs to Starbase generation ${String(player.sequenceId)}, but the Starbase is at generation ${String(system.sequenceId)}; the program treats it as destroyed. Register a current StarbasePlayer at this Starbase and replan ship assembly.`);
+    const fleetRaw = required(resolved.fleet, 'Fleet');
+    const fleet = fleetAccountDefinition.decode(fleetRaw);
+    if ((await deriveFleetAddress(fleet)) !== intent.address ||
+        fleet.game !== intent.game ||
+        fleet.ownerProfile !== intent.profile ||
+        fleet.faction !== faction.faction ||
+        fleet.npcFactionId !== 0)
+        fail(resolved.fleet, 'The Fleet has a noncanonical address or different Game, Profile, faction or NPC affiliation. Select a canonical owned player Fleet and replan ship assembly.');
+    if (fleet.state.kind !== 'docked' || fleet.state.system !== intent.system)
+        fail(resolved.fleet, 'Ship assembly requires the Fleet to remain Docked at the selected System. Dock at a Starbase where the Character has a current StarbasePlayer and replan.');
+    // A Fleet with a sub-profile is rented (or a rental was invalidated), and
+    // the program never adds ships to it.
+    if (fleet.subProfile !== SYSTEM_PROGRAM)
+        fail(resolved.fleet, `The Fleet is rented out to sub-profile ${fleet.subProfile}, and ships cannot be added to a rented Fleet. End the rental, refresh the Fleet, and replan ship assembly.`);
+    // The program needs full AP, SP and HP. HP can only recover from the
+    // pending repair reservoir, so a Fleet whose HP plus reservoir is below its
+    // maximum can never qualify; AP and SP recover on timers and stay
+    // chain-authoritative.
+    if (fleet.hp + fleet.pendingHp < fleet.stats.combat.hp)
+        fail(resolved.fleet, `The Fleet has ${String(fleet.hp)} HP and ${String(fleet.pendingHp)} pending repair, below its ${String(fleet.stats.combat.hp)} maximum, and ships can only be added to a fully repaired Fleet. Repair the Fleet, refresh it, and replan ship assembly.`);
+    const gameRaw = required(resolved.game, 'Game');
+    const definitions = catalog ?? decodeGameShipAssemblyCatalog(gameRaw);
+    if (fleet.shipDefinitionsSeqId !== definitions.sequenceId)
+        fail(resolved.fleet, 'The Fleet was built under older ship definitions. The program resynchronizes it inside the assembly, which can change its stats, and this SDK plans current Fleets only. Plan planSyncFleetWithGame, confirm it, then replan.');
+    const selected = definitions.rows.find((row) => row.id === intent.shipId);
+    if (!selected)
+        fail(resolved.game, `Ship configuration ${String(intent.shipId)} is not in the current Game ship definitions. Select a defined configuration and replan.`);
+    // Components move from the StarbasePlayer into the Fleet's components pod;
+    // that route and its storage are not planned yet.
+    if (selected.componentRequirements.size > 0)
+        fail(resolved.game, `Ship configuration ${String(intent.shipId)} needs ship components, which this SDK does not plan yet. Select a configuration without component requirements, or use the game client.`);
+    const size = shipSizeName(selected.sizeClass);
+    const maxSize = character.modifiers.values.maxShipSize;
+    if (selected.sizeClass > shipSizeRank(maxSize))
+        fail(resolved.character, `Ship configuration ${String(intent.shipId)} is ${size}, above the Character's maximum ship size ${maxSize}. Unlock research that raises the maximum ship size, then replan.`);
+    const tags = character.modifiers.values.researchTags;
+    const missing = selected.researchRequirements.filter((tag) => !tags.includes(tag));
+    if (missing.length > 0)
+        fail(resolved.character, `Ship configuration ${String(intent.shipId)} requires every research tag in [${selected.researchRequirements.join(', ')}]; the Character lacks [${missing.join(', ')}]. Unlock the research nodes that grant them, then replan.`);
+    const current = fleet.fleetShips.find((entry) => entry.shipId === intent.shipId)
+        ?.quantity ?? 0n;
+    if (current + intent.amount > 18446744073709551615n)
+        fail(resolved.fleet, 'The resulting Fleet ship quantity exceeds the stored u64 limit. Select a smaller valid quantity and replan.');
+    // The program checks the Fleet's stored ship counts plus the added ships,
+    // never the requirements of ships already aboard.
+    const classes = prospectiveShipCounts(fleet.shipCounts, selected.sizeClass, Number(intent.amount));
+    const points = fleetCapacityPoints(classes);
+    if (points > character.modifiers.values.fleetSize)
+        fail(resolved.character, `The resulting Fleet uses ${String(points)} Fleet points, above the Character's Fleet size ${String(character.modifiers.values.fleetSize)}. Reduce the amount or unlock Fleet-size research, then replan.`);
+    if (points > definitions.maxFleetSize)
+        fail(resolved.game, `The resulting Fleet uses ${String(points)} Fleet points, above the Game's ${String(definitions.maxFleetSize)}-point Fleet limit. Reduce the resulting Fleet composition, then replan; a larger Character allowance does not override it.`);
+    const [commanders, titans] = [classes[6], classes[7]];
+    if (titans > MAX_TITANS_PER_FLEET)
+        fail(resolved.fleet, `The resulting Fleet would hold ${String(titans)} Titans; a Fleet holds at most ${String(MAX_TITANS_PER_FLEET)}. Add the Titan to another Fleet and replan.`);
+    if (commanders + titans > MAX_COMMANDERS_AND_TITANS_PER_FLEET)
+        fail(resolved.fleet, `The resulting Fleet would hold ${String(commanders + titans)} Commander and Titan ships; a Fleet holds at most ${String(MAX_COMMANDERS_AND_TITANS_PER_FLEET)} together. Add the ship to another Fleet and replan.`);
+    // Escrowed hulls of any configuration of the same ship count: the program
+    // re-tags them to the selected configuration.
+    const siblings = new Set(definitions.rows
+        .filter((row) => row.mint === selected.mint)
+        .map((row) => row.id));
+    const entitlement = player.shipsInEscrow
+        .filter((entry) => siblings.has(entry.shipId))
+        .reduce((total, entry) => total + entry.quantityRaw, 0n);
+    if (entitlement < intent.amount)
+        fail(resolved.starbasePlayer, `The StarbasePlayer holds ${String(entitlement)} escrowed hulls of this ship across its configurations, fewer than the ${String(intent.amount)} requested. Explicitly import more of this ship or reduce the amount, then replan.`);
+    const configHash = await hashShipAssemblyConfiguration(definitions, selected);
+    if (expected && expected.configHash !== configHash)
+        fail(resolved.game, 'The selected ship configuration has changed. Replan and inspect its current configuration before signing.');
+    const rent = readRent(required(resolved.rent, 'Rent sysvar'));
+    const now = readClock(required(resolved.clock, 'Clock sysvar'));
+    const fleetRent = rent(fleetShipAssemblySize(fleetRaw, intent.shipId, intent.amount));
+    const shortfall = (raw, minimum) => raw.lamports < minimum ? minimum - raw.lamports : 0n;
+    // The program funds the Fleet, StarbasePlayer and Character as one group.
+    // Re-tagging adds an escrow entry when the configuration has none, and its
+    // cost is counted in full. A StarbasePlayer already below its rent minimum
+    // is left out, as a combined ship import funds that shortfall first.
+    const playerRaw = required(resolved.starbasePlayer, 'StarbasePlayer');
+    const profileDebit = shortfall(fleetRaw, fleetRent) +
+        rent(playerRaw.data.length +
+            starbasePlayerEscrowGrowth(playerRaw, intent.shipId)) -
+        rent(playerRaw.data.length);
+    if (expected !== undefined && profileDebit > expected.maximumProfileDebit)
+        fail(resolved.profile, 'Ship assembly now requires a larger Profile debit than this Plan approved. Replan and inspect the updated rent shortfall before signing.');
+    const profileReserve = rent(profileRaw.data.length);
+    if (profileRaw.lamports < profileReserve + profileDebit)
+        fail(resolved.profile, 'The Profile lacks the Fleet rent shortfall while preserving its own rent reserve. Fund the Profile or Fleet target explicitly, then replan.');
+    const key = directProfileKey(profile.keys, intent.keyIndex, intent.authority);
+    if (!key)
+        fail(resolved.profile, 'The selected direct Profile key is absent or belongs to another authority. Select the current key index for this authority and replan.');
+    if (profileKeyExpired(key, now))
+        fail(resolved.profile, 'The selected Profile key has expired. Renew it or select a current direct key and replan ship assembly.');
+    const auth = grantsPermission(key, PROFILE_SCOPE, 0n);
+    const manages = grantsPermission(key, SAGE_SCOPE, 18n) ||
+        grantsPermission(key, intent.address, 18n);
+    if (!auth && !manages)
+        fail(resolved.profile, 'The selected key cannot manage Fleets. Use a direct Profile AUTH key or a manageFleet key scoped to SAGE or this Fleet, and replan.');
+    if (profileDebit > 0n && !auth && !hasPermissionBit(key, 63n))
+        fail(resolved.profile, 'The selected manageFleet key cannot fund the Fleet from the Profile vault. Explicitly prefund the target or choose an authorized vault-funding key, then replan; drainSolVault grants vault withdrawal authority.');
+    return { profileDebit, profileReserve, fleetRent, configHash };
+}
+//# sourceMappingURL=fleet-ship-assembly.js.map

package/dist/internal/planning/fleet-ship-assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-ship-assembly.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-ship-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,mCAAmC,EACnC,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAE9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAuB/D,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA8B;IAE9B,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC5B,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;QAC7C,2BAA2B,CAAC,MAAM,CAAC,OAAO,CAAC;KAC5C,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS;QACT,cAAc;QACd,KAAK,EAAE,MAAM,CAAC,OAAO;QACrB,cAAc,EAAE,MAAM,2BAA2B,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3E,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,aAAa;KACrB,CAAC;AACJ,CAAC;AACD,SAAS,IAAI,CAAC,OAAgB,EAAE,OAAe;IAC7C,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAA8B,EAC9B,QAAmC,EACnC,QAAsD,EACtD,QAGC,EACD,OAA6B;IAO7B,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC5B,IAAI,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC;QACrC,IAAI,CACF,MAAM,CAAC,OAAO,EACd,sGAAsG,CACvG,CAAC;IACJ,MAAM,QAAQ,GAAG,CAAC,OAAgB,EAAE,IAAY,EAAc,EAAE;QAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YACN,IAAI,CACF,OAAO,EACP,GAAG,IAAI,IAAI,OAAO,gFAAgF,CACnG,CAAC;QACJ,IAAI,GAAG,CAAC,UAAU;YAChB,IAAI,CACF,OAAO,EACP,GAAG,IAAI,IAAI,OAAO,sEAAsE,CACzF,CAAC;QACJ,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,0EAA0E;IAC1E,oEAAoE;IACpE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAC/D,MAAM,oBAAoB,CACxB,MAAM,EACN,QAAQ,EACR,QAAQ,EACR;QACE,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,yBAAyB;KAClC,EACD,EAAE,WAAW,EAAE,IAAI,EAAE,CACtB,CAAC;IACJ,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;QACzC,IAAI,CACF,QAAQ,CAAC,cAAc,EACvB,qDAAqD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,uCAAuC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,oHAAoH,CACnQ,CAAC;IACJ,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtD,IACE,CAAC,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO;QACpD,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC1B,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,OAAO;QACrC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;QACjC,KAAK,CAAC,YAAY,KAAK,CAAC;QAExB,IAAI,CACF,QAAQ,CAAC,KAAK,EACd,8JAA8J,CAC/J,CAAC;IACJ,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QACvE,IAAI,CACF,QAAQ,CAAC,KAAK,EACd,2JAA2J,CAC5J,CAAC;IACJ,0EAA0E;IAC1E,sCAAsC;IACtC,IAAI,KAAK,CAAC,UAAU,KAAK,cAAc;QACrC,IAAI,CACF,QAAQ,CAAC,KAAK,EACd,0CAA0C,KAAK,CAAC,UAAU,6GAA6G,CACxK,CAAC;IACJ,qEAAqE;IACrE,4EAA4E;IAC5E,kEAAkE;IAClE,uBAAuB;IACvB,IAAI,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QACpD,IAAI,CACF,QAAQ,CAAC,KAAK,EACd,iBAAiB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,8BAA8B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,0HAA0H,CACzP,CAAC;IACJ,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,IAAI,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,oBAAoB,KAAK,WAAW,CAAC,UAAU;QACvD,IAAI,CACF,QAAQ,CAAC,KAAK,EACd,+NAA+N,CAChO,CAAC;IACJ,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1E,IAAI,CAAC,QAAQ;QACX,IAAI,CACF,QAAQ,CAAC,IAAI,EACb,sBAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,0FAA0F,CACtI,CAAC;IACJ,2EAA2E;IAC3E,kDAAkD;IAClD,IAAI,QAAQ,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC;QACzC,IAAI,CACF,QAAQ,CAAC,IAAI,EACb,sBAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,0IAA0I,CACtL,CAAC;IACJ,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC;IACvD,IAAI,QAAQ,CAAC,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QAC5C,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,sBAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,6CAA6C,OAAO,mEAAmE,CAC9K,CAAC;IACJ,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAClD,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC7B,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACpB,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,sBAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,oCAAoC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,4DAA4D,CACjO,CAAC;IACJ,MAAM,OAAO,GACX,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC;QAC9D,EAAE,QAAQ,IAAI,EAAE,CAAC;IACrB,IAAI,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,qBAAqB;QACjD,IAAI,CACF,QAAQ,CAAC,KAAK,EACd,6GAA6G,CAC9G,CAAC;IACJ,0EAA0E;IAC1E,kDAAkD;IAClD,MAAM,OAAO,GAAG,qBAAqB,CACnC,KAAK,CAAC,UAAU,EAChB,QAAQ,CAAC,SAAS,EAClB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CACtB,CAAC;IACF,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS;QAC/C,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,4BAA4B,MAAM,CAAC,MAAM,CAAC,mDAAmD,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,iEAAiE,CAC3M,CAAC;IACJ,IAAI,MAAM,GAAG,WAAW,CAAC,YAAY;QACnC,IAAI,CACF,QAAQ,CAAC,IAAI,EACb,4BAA4B,MAAM,CAAC,MAAM,CAAC,mCAAmC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,6HAA6H,CAC3O,CAAC;IACJ,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;IACxD,IAAI,MAAM,GAAG,oBAAoB;QAC/B,IAAI,CACF,QAAQ,CAAC,KAAK,EACd,kCAAkC,MAAM,CAAC,MAAM,CAAC,kCAAkC,MAAM,CAAC,oBAAoB,CAAC,8CAA8C,CAC7J,CAAC;IACJ,IAAI,UAAU,GAAG,MAAM,GAAG,mCAAmC;QAC3D,IAAI,CACF,QAAQ,CAAC,KAAK,EACd,kCAAkC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,qDAAqD,MAAM,CAAC,mCAAmC,CAAC,sDAAsD,CACpN,CAAC;IACJ,0EAA0E;IAC1E,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,WAAW,CAAC,IAAI;SACb,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC;SAC3C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CACxB,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa;SACrC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;SAC7C,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3D,IAAI,WAAW,GAAG,MAAM,CAAC,MAAM;QAC7B,IAAI,CACF,QAAQ,CAAC,cAAc,EACvB,4BAA4B,MAAM,CAAC,WAAW,CAAC,0EAA0E,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,oFAAoF,CACnO,CAAC;IACJ,MAAM,UAAU,GAAG,MAAM,6BAA6B,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9E,IAAI,QAAQ,IAAI,QAAQ,CAAC,UAAU,KAAK,UAAU;QAChD,IAAI,CACF,QAAQ,CAAC,IAAI,EACb,2GAA2G,CAC5G,CAAC;IACJ,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,CACpB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAC9D,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,GAAe,EAAE,OAAe,EAAE,EAAE,CACrD,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,qEAAqE;IACrE,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACtE,MAAM,YAAY,GAChB,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC9B,IAAI,CACF,SAAS,CAAC,IAAI,CAAC,MAAM;YACnB,0BAA0B,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CACvD;QACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,QAAQ,KAAK,SAAS,IAAI,YAAY,GAAG,QAAQ,CAAC,mBAAmB;QACvE,IAAI,CACF,QAAQ,CAAC,OAAO,EAChB,0IAA0I,CAC3I,CAAC;IACJ,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,QAAQ,GAAG,cAAc,GAAG,YAAY;QACrD,IAAI,CACF,QAAQ,CAAC,OAAO,EAChB,6IAA6I,CAC9I,CAAC;IACJ,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG;QACN,IAAI,CACF,QAAQ,CAAC,OAAO,EAChB,wIAAwI,CACzI,CAAC;IACJ,IAAI,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC;QAC7B,IAAI,CACF,QAAQ,CAAC,OAAO,EAChB,yGAAyG,CAC1G,CAAC;IACJ,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GACX,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC;QACtC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO;QACnB,IAAI,CACF,QAAQ,CAAC,OAAO,EAChB,qIAAqI,CACtI,CAAC;IACJ,IAAI,YAAY,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC;QAC3D,IAAI,CACF,QAAQ,CAAC,OAAO,EAChB,mNAAmN,CACpN,CAAC;IACJ,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACjE,CAAC"}

package/dist/internal/planning/fleet-state.d.ts

@@ -0,0 +1,25 @@
+import type { Address } from '@solana/kit';
+import type { FleetStateData } from '../c4/fleet.js';
+import type { WorldCoordinates } from '../c4/world.js';
+type LeavableFleetState = Exclude<FleetStateData['kind'], 'idle'>;
+interface NamedFleet {
+    readonly address: Address;
+    readonly name: string;
+}
+/** Rejects a Fleet whose `state` cannot start `action`, stating the
+ * `requirement` and the first step out of that state. */
+export declare function failFleetState(fleet: NamedFleet, state: LeavableFleetState, action: string, requirement: string): never;
+/** The coordinate an idle or moving Fleet acts from: its location when idle,
+ * else its warp or subwarp destination. Other states fail with `action` and
+ * `requirement`. */
+export declare function requireActionCoordinate(fleet: NamedFleet & {
+    readonly location: WorldCoordinates;
+    readonly state: {
+        readonly kind: 'warp' | 'subwarp';
+        readonly to: WorldCoordinates;
+    } | {
+        readonly kind: Exclude<FleetStateData['kind'], 'warp' | 'subwarp'>;
+    };
+}, action: string, requirement: string): WorldCoordinates;
+export {};
+//# sourceMappingURL=fleet-state.d.ts.map

package/dist/internal/planning/fleet-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-state.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,KAAK,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAalE,UAAU,UAAU;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;yDACyD;AACzD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,KAAK,CAMP;AAED;;oBAEoB;AACpB,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,GAAG;IAClB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EACV;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAA;KAAE,GACpE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;KAAE,CAAC;CAC5E,EACD,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAKlB"}

package/dist/internal/planning/fleet-state.js

@@ -0,0 +1,28 @@
+import { SageSdkError } from '../../client/errors.js';
+/** The first step out of each Fleet state an action may not start from. */
+const LEAVE_STATE = {
+    claimStakeTransfer: 'Finish the Claim Stake transfer',
+    destroyed: 'Respawn the Fleet',
+    docked: 'Undock the Fleet',
+    mining: 'Stop mining',
+    respawn: 'Wait for the Fleet to finish respawning',
+    subwarp: 'Finish or stop the subwarp',
+    warp: 'Finish the warp and settle its arrival',
+};
+/** Rejects a Fleet whose `state` cannot start `action`, stating the
+ * `requirement` and the first step out of that state. */
+export function failFleetState(fleet, state, action, requirement) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Fleet ${fleet.name} is ${state} and cannot ${action}; ${requirement}. ${LEAVE_STATE[state]}, refresh it, and retry.`, { address: fleet.address });
+}
+/** The coordinate an idle or moving Fleet acts from: its location when idle,
+ * else its warp or subwarp destination. Other states fail with `action` and
+ * `requirement`. */
+export function requireActionCoordinate(fleet, action, requirement) {
+    const { state } = fleet;
+    if (state.kind === 'idle')
+        return fleet.location;
+    if (state.kind === 'warp' || state.kind === 'subwarp')
+        return state.to;
+    return failFleetState(fleet, state.kind, action, requirement);
+}
+//# sourceMappingURL=fleet-state.js.map

package/dist/internal/planning/fleet-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-state.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMtD,2EAA2E;AAC3E,MAAM,WAAW,GAAiD;IAChE,kBAAkB,EAAE,iCAAiC;IACrD,SAAS,EAAE,mBAAmB;IAC9B,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,yCAAyC;IAClD,OAAO,EAAE,4BAA4B;IACrC,IAAI,EAAE,wCAAwC;CAC/C,CAAC;AAOF;yDACyD;AACzD,MAAM,UAAU,cAAc,CAC5B,KAAiB,EACjB,KAAyB,EACzB,MAAc,EACd,WAAmB;IAEnB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,SAAS,KAAK,CAAC,IAAI,OAAO,KAAK,eAAe,MAAM,KAAK,WAAW,KAAK,WAAW,CAAC,KAAK,CAAC,0BAA0B,EACrH,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAC3B,CAAC;AACJ,CAAC;AAED;;oBAEoB;AACpB,MAAM,UAAU,uBAAuB,CACrC,KAKC,EACD,MAAc,EACd,WAAmB;IAEnB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,EAAE,CAAC;IACvE,OAAO,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAChE,CAAC"}

package/dist/internal/planning/governance-fees.d.ts

@@ -0,0 +1,64 @@
+import type { Address, SageContext } from '../../client/contracts.js';
+import { type CraftingProcessAccountData } from '../c4/crafting.js';
+import type { ResolvedDemocracyHistory } from './democracy-history.js';
+export interface FeeRequest {
+    readonly game: Address;
+    readonly system: Address;
+    readonly starbaseSeqId: bigint;
+    readonly mode: 'market' | 'crafting-start' | 'crafting-complete';
+    readonly hasHab?: boolean;
+    readonly process?: Address;
+}
+export interface FeeParams {
+    readonly craftingFeeBps: number;
+    readonly localMarketFeeBps: number;
+    readonly localTreasuryShareBps: number;
+    readonly treasuryDistributionBps?: number;
+}
+export interface FeeIntent {
+    readonly request: FeeRequest;
+    readonly governance?: {
+        readonly address: Address;
+        readonly state: 'absent' | 'initialized';
+        readonly version?: number;
+        readonly enabled?: number;
+        readonly controllerFaction?: number;
+        readonly starbaseSeqId?: bigint;
+        readonly activeParams?: FeeParams;
+    };
+    readonly currencyCache?: {
+        readonly address: Address;
+        readonly version: number;
+    };
+    readonly treasury?: {
+        readonly address: Address;
+        readonly state: 'absent' | 'initialized';
+        readonly version?: number;
+        readonly governance?: Address;
+    };
+    readonly process?: {
+        readonly address: Address;
+        readonly version: number;
+        readonly feeRecipient?: 'atlas' | 'dao-atlas';
+        readonly feeGovernance?: Address;
+        readonly feeSnapshot?: CraftingProcessAccountData['feeSnapshot'];
+    };
+    readonly quote: {
+        readonly source: 'default' | 'governance' | 'history-policy' | 'history-generation' | 'history-disabled' | 'process-snapshot' | 'legacy-process';
+        readonly params?: FeeParams;
+    };
+}
+export interface ResolvedGovernanceFees {
+    readonly intent: FeeIntent;
+    readonly accounts: {
+        readonly starbaseGovernance?: Address;
+        readonly currencyCache?: Address;
+        readonly starbaseTreasury?: Address;
+    };
+    readonly description: string;
+}
+/** Resolve current fee accounts and a finite quote without creating or funding anything. */
+export declare function resolveGovernanceFees(ctx: SageContext, request: FeeRequest, history: ResolvedDemocracyHistory): Promise<ResolvedGovernanceFees>;
+/** Compare finite serialized fields; mutable shared balances are deliberately absent. */
+export declare function matchGovernanceFeesIntent(expected: FeeIntent, actual: FeeIntent): boolean;
+//# sourceMappingURL=governance-fees.d.ts.map

package/dist/internal/planning/governance-fees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-fees.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/governance-fees.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EAEP,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAcnC,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAYvE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AACD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C;AACD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC;QACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;KACnC,CAAC;IACF,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC;QACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;QAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;QACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,0BAA0B,CAAC,aAAa,CAAC,CAAC;KAClE,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,MAAM,EACX,SAAS,GACT,YAAY,GACZ,gBAAgB,GAChB,oBAAoB,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,CAAC;QACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;KAC7B,CAAC;CACH;AACD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;QACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;QACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAuDD,4FAA4F;AAC5F,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAgPjC;AACD,yFAAyF;AACzF,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,SAAS,GAChB,OAAO,CAcT"}