@aephia/atlas-kit 0.6.0-next.14 → 0.6.0-next.140

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

@@ -0,0 +1,107 @@
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { decodeFleetArrival, } from '../c4/fleet-arrival.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { findCharacterPda, characterAccountDefinition, } from '../c4/character.js';
+import { deriveRegionTrackerAddress, regionTrackerAccountDefinition, } from '../c4/factions.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { requireGameAddress } from '../game-context.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { resolveXpRuntime } from './xp-runtime.js';
+import { directProfileKey, grantsPermission, profileKeyExpired, } from './profile-key.js';
+function fail(address, reason) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Arrival settlement ${reason}. Refresh the Fleet and prepare a new arrival Plan after the scheduled travel duration has elapsed.`, { address });
+}
+function required(raw, address) {
+    if (!raw || raw.executable)
+        fail(address, `requires the existing non-executable account ${address}`);
+    return raw;
+}
+/** Read fresh movement, chain time and direct authority without retaining signer data. */
+export async function resolveFleetArrival(ctx, fleetAddress, options, freshGameVersions) {
+    const game = requireGameAddress(ctx);
+    const [fleetRaw, clockRaw] = await readContextRawAccounts(ctx, [
+        fleetAddress,
+        CLOCK_ADDRESS,
+    ]);
+    const fleet = await decodeFleetArrival(required(fleetRaw, fleetAddress));
+    if (fleet.game !== game || fleet.canonical !== fleetAddress)
+        fail(fleetAddress, 'requires the canonical Fleet for the configured Game');
+    const journey = fleet.journey;
+    if (!journey)
+        fail(fleetAddress, 'requires a travelling Fleet; Idle and other non-travel states have no arrival to settle');
+    if (journey.kind === 'warp')
+        fail(fleetAddress, 'for the current Game runtime does not support warp; wait for a separately supported warp settlement route');
+    const now = readClock(required(clockRaw, CLOCK_ADDRESS));
+    if (journey.duration < 0n)
+        fail(fleetAddress, 'found invalid journey timing');
+    if (now < journey.departure ||
+        (now - journey.departure) * (1n << 56n) < journey.duration)
+        fail(fleetAddress, 'cannot settle an unfinished journey; wait for its scheduled duration to elapse on the chain clock or choose the separate intentional early-stop action');
+    const character = await findCharacterPda(fleet.profile, game);
+    const xp = await resolveXpRuntime(ctx, { game, character }, freshGameVersions);
+    const regionTracker = await deriveRegionTrackerAddress(game);
+    const addresses = [character, fleet.profile, regionTracker];
+    const accounts = await readContextRawAccounts(ctx, addresses);
+    const characterData = characterAccountDefinition.decode(required(accounts[0], character));
+    if (characterData.game !== game ||
+        characterData.playerProfile !== fleet.profile)
+        fail(character, 'requires the canonical Character for this Game and owning Profile');
+    const authorization = options.authorization;
+    if (authorization.certificate !== undefined ||
+        authorization.profile !== fleet.profile ||
+        // Fleet absence uses the zero/System address, not a Profile key scope.
+        fleet.subProfile !== '11111111111111111111111111111111')
+        fail(fleetAddress, 'supports only the owning Profile and its direct key, without a certificate or delegated sub-Profile');
+    // Both callers validate the index first: the planner through
+    // validatePlanAuthorization, execution through the frozen normalized guard.
+    // A malformed index would still miss every key below and fail closed.
+    const profile = profileAccountDefinition.decode(required(accounts[1], fleet.profile));
+    const key = directProfileKey(profile.keys, authorization.keyIndex, authorization.authority);
+    if (!key)
+        fail(fleet.profile, 'requires the current direct key index for the selected authority');
+    if (profileKeyExpired(key, now))
+        fail(fleet.profile, 'cannot use an expired Profile key; renew it or select an unexpired direct key');
+    if (!grantsPermission(key, PROFILE_SCOPE, 0n) &&
+        !grantsPermission(key, SAGE_SCOPE, 10n))
+        fail(fleet.profile, 'requires direct Profile AUTH or SAGE moveFleet permission; select an appropriately scoped key');
+    const tracker = regionTrackerAccountDefinition.decode(required(accounts[2], regionTracker));
+    if (tracker.game !== game)
+        fail(regionTracker, 'requires the canonical RegionTracker bound to this Game');
+    const intent = {
+        fleet: fleetAddress,
+        game,
+        profile: fleet.profile,
+        journey,
+        authorization: {
+            authority: authorization.authority,
+            profile: authorization.profile,
+            keyIndex: authorization.keyIndex,
+        },
+    };
+    return {
+        intent,
+        character,
+        regionTracker,
+        xp,
+        lowFuel: fleet.lowFuel,
+    };
+}
+/** Recheck only the selected journey/authority, permitting unrelated Fleet and XP changes. */
+export async function validateFleetArrivalIntent(ctx, intent, freshGameVersions) {
+    const current = await resolveFleetArrival(ctx, intent.fleet, {
+        authorization: intent.authorization,
+    }, freshGameVersions);
+    const a = intent.journey, b = current.intent.journey;
+    if (current.intent.game !== intent.game ||
+        current.intent.profile !== intent.profile ||
+        a.departure !== b.departure ||
+        a.from.x !== b.from.x ||
+        a.from.y !== b.from.y ||
+        a.to.x !== b.to.x ||
+        a.to.y !== b.to.y ||
+        a.duration !== b.duration)
+        fail(intent.fleet, 'journey or ownership changed after planning');
+    return current;
+}
+//# sourceMappingURL=fleet-arrival.js.map

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

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

package/dist/internal/planning/fleet-attack-xp.d.ts

@@ -0,0 +1,20 @@
+import type { Address, SageContext } from '../../client/contracts.js';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Finite actor identity and exact instruction intent; mutable XP is not hashed. */
+export interface FleetAttackGuard {
+    readonly kind: 'fleet-attack';
+    readonly address: Address;
+    readonly defender: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly defenderProfile: Address;
+    readonly instructionKey: string;
+    readonly describes: string;
+    readonly dataHash?: never;
+}
+export declare function fleetAttackInstructionKey(instruction: PlanStep['instruction']): string;
+/** Fully validate each unique operator once per fresh pass. NPCs use their operator, not Fleet-derived Characters. */
+export declare function validateFleetAttackActors(ctx: SageContext, guard: Omit<FleetAttackGuard, 'kind' | 'instructionKey' | 'describes'>): Promise<Map<Address, Address>>;
+/** Bind the whole attack instruction, its two actor identities and required XP guards. */
+export declare function validateFleetAttackInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=fleet-attack-xp.d.ts.map

package/dist/internal/planning/fleet-attack-xp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-attack-xp.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-attack-xp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAY1E,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B;AASD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC,GACnC,MAAM,CAMR;AAED,sHAAsH;AACtH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,gBAAgB,GAAG,WAAW,CAAC,kCAkCvE;AAED,0FAA0F;AAC1F,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAqEN"}

package/dist/internal/planning/fleet-attack-xp.js

@@ -0,0 +1,104 @@
+import { AccountRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { characterAccountDefinition, deriveCharacterPda, } from '../c4/character.js';
+import { fleetAccountDefinition, deriveFleetAddress } from '../c4/fleet.js';
+import { SAGE_PROGRAM_ADDRESS, getAttackFleetInstructionDataDecoder, } from '../c4/runtime-bindings.js';
+import { ATTACK_FLEET_DISCRIMINATOR } from '../c4/discriminators.js';
+function fail() {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Fleet attack no longer matches its canonical operators, Characters, XP accounts or exact instruction intent. Refresh both Fleets and repair missing state, then recreate the Plan before signing.');
+}
+export function fleetAttackInstructionKey(instruction) {
+    return JSON.stringify([
+        instruction.programAddress,
+        instruction.accounts?.map((a) => [a.address, a.role]),
+        Array.from(instruction.data ?? []),
+    ]);
+}
+/** Fully validate each unique operator once per fresh pass. NPCs use their operator, not Fleet-derived Characters. */
+export async function validateFleetAttackActors(ctx, guard) {
+    const actors = new Map();
+    for (const profile of [guard.profile, guard.defenderProfile]) {
+        if (actors.has(profile))
+            continue;
+        const [character, bump] = await deriveCharacterPda(profile, guard.game);
+        const [raw] = await readContextRawAccounts(ctx, [character]);
+        if (!raw || raw.executable)
+            fail();
+        const value = characterAccountDefinition.decode(raw);
+        if (value.version !== 3 ||
+            value.bump !== bump ||
+            value.game !== guard.game ||
+            value.playerProfile !== profile)
+            fail();
+        actors.set(profile, character);
+    }
+    const fleets = await readContextRawAccounts(ctx, [
+        guard.address,
+        guard.defender,
+    ]);
+    for (const [i, profile] of [guard.profile, guard.defenderProfile].entries()) {
+        const raw = fleets[i];
+        if (!raw || raw.executable)
+            fail();
+        const value = fleetAccountDefinition.decode(raw);
+        if (value.game !== guard.game ||
+            value.ownerProfile !== profile ||
+            (await deriveFleetAddress(value)) !== raw.address)
+            fail();
+    }
+    return actors;
+}
+/** Bind the whole attack instruction, its two actor identities and required XP guards. */
+export function validateFleetAttackInstructions(steps, guards) {
+    for (const { instruction } of steps) {
+        if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS ||
+            !ATTACK_FLEET_DISCRIMINATOR.every((b, i) => instruction.data?.[i] === b))
+            continue;
+        const { accounts, data } = instruction;
+        if (!accounts || accounts.length !== 31 || !data)
+            fail();
+        try {
+            if (getAttackFleetInstructionDataDecoder().read(data, 0)[1] !== data.length)
+                fail();
+        }
+        catch {
+            fail();
+        }
+        const guard = guards.find((g) => g.kind === 'fleet-attack' &&
+            g.address === accounts[5].address &&
+            g.defender === accounts[6].address);
+        if (!guard ||
+            guard.instructionKey !== fleetAttackInstructionKey(instruction) ||
+            guard.game !== accounts[10].address ||
+            guard.profile !== accounts[1].address)
+            fail();
+        for (const [profile, characterIndex, budgetIndex] of [
+            [guard.profile, 4, 28],
+            [guard.defenderProfile, 7, 29],
+        ]) {
+            const xp = guards.find((g) => g.kind === 'xp-runtime' &&
+                g.intent.game === guard.game &&
+                g.intent.profile === profile &&
+                g.intent.character === accounts[characterIndex].address &&
+                g.intent.structure === undefined);
+            if (!xp ||
+                xp.kind !== 'xp-runtime' ||
+                accounts[characterIndex].role !== AccountRole.WRITABLE ||
+                accounts[budgetIndex].role !== AccountRole.WRITABLE ||
+                accounts[budgetIndex].address !== xp.accounts.xpBudget ||
+                accounts[30].role !== AccountRole.READONLY ||
+                accounts[30].address !== xp.accounts.xpBudgetConfig)
+                fail();
+        }
+        for (const fleet of [guard.address, guard.defender])
+            if (!guards.some((g) => g.kind === 'account-state' && g.address === fleet))
+                fail();
+    }
+    for (const guard of guards) {
+        if (guard.kind === 'fleet-attack' &&
+            !steps.some((s) => fleetAttackInstructionKey(s.instruction) === guard.instructionKey))
+            fail();
+    }
+}
+//# sourceMappingURL=fleet-attack-xp.js.map

package/dist/internal/planning/fleet-attack-xp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-attack-xp.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-attack-xp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,oBAAoB,EACpB,oCAAoC,GACrC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAerE,SAAS,IAAI;IACX,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,mMAAmM,CACpM,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAAoC;IAEpC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,WAAW,CAAC,cAAc;QAC1B,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;KACnC,CAAC,CAAC;AACL,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAgB,EAChB,KAAsE;IAEtE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7D,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAClC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU;YAAE,IAAI,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,0BAA0B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrD,IACE,KAAK,CAAC,OAAO,KAAK,CAAC;YACnB,KAAK,CAAC,IAAI,KAAK,IAAI;YACnB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;YACzB,KAAK,CAAC,aAAa,KAAK,OAAO;YAE/B,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE;QAC/C,KAAK,CAAC,OAAO;QACb,KAAK,CAAC,QAAQ;KACf,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5E,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU;YAAE,IAAI,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjD,IACE,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;YACzB,KAAK,CAAC,YAAY,KAAK,OAAO;YAC9B,CAAC,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO;YAEjD,IAAI,EAAE,CAAC;IACX,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,+BAA+B,CAC7C,KAA0B,EAC1B,MAAmC;IAEnC,KAAK,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QACpC,IACE,WAAW,CAAC,cAAc,KAAK,oBAAoB;YACnD,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAExE,SAAS;QACX,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC;QACvC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,IAAI;YAAE,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,IACE,oCAAoC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM;gBAEvE,IAAI,EAAE,CAAC;QACX,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC;QACT,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CACvB,CAAC,CAAC,EAAyB,EAAE,CAC3B,CAAC,CAAC,IAAI,KAAK,cAAc;YACzB,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO;YAClC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO,CACtC,CAAC;QACF,IACE,CAAC,KAAK;YACN,KAAK,CAAC,cAAc,KAAK,yBAAyB,CAAC,WAAW,CAAC;YAC/D,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAE,CAAC,OAAO;YACpC,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO;YAEtC,IAAI,EAAE,CAAC;QACT,KAAK,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,CAAC,IAAI;YACnD,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;YACtB,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;SACtB,EAAE,CAAC;YACX,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,YAAY;gBACvB,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;gBAC5B,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,OAAO;gBAC5B,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,cAAc,CAAE,CAAC,OAAO;gBACxD,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CACnC,CAAC;YACF,IACE,CAAC,EAAE;gBACH,EAAE,CAAC,IAAI,KAAK,YAAY;gBACxB,QAAQ,CAAC,cAAc,CAAE,CAAC,IAAI,KAAK,WAAW,CAAC,QAAQ;gBACvD,QAAQ,CAAC,WAAW,CAAE,CAAC,IAAI,KAAK,WAAW,CAAC,QAAQ;gBACpD,QAAQ,CAAC,WAAW,CAAE,CAAC,OAAO,KAAK,EAAE,CAAC,QAAQ,CAAC,QAAQ;gBACvD,QAAQ,CAAC,EAAE,CAAE,CAAC,IAAI,KAAK,WAAW,CAAC,QAAQ;gBAC3C,QAAQ,CAAC,EAAE,CAAE,CAAC,OAAO,KAAK,EAAE,CAAC,QAAQ,CAAC,cAAc;gBAEpD,IAAI,EAAE,CAAC;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC;YACjD,IACE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC;gBAEtE,IAAI,EAAE,CAAC;IACb,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IACE,KAAK,CAAC,IAAI,KAAK,cAAc;YAC7B,CAAC,KAAK,CAAC,IAAI,CACT,CAAC,CAAC,EAAE,EAAE,CACJ,yBAAyB,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,cAAc,CACpE;YAED,IAAI,EAAE,CAAC;IACX,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+export interface FleetCreationIntent {
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly system: Address;
+    readonly keyIndex: number;
+    readonly label: string;
+}
+export interface FleetCreationAccounts {
+    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 validateFleetCreationLabel(label: unknown): asserts label is string;
+export declare function resolveFleetCreation(input: FleetCreationIntent): Promise<FleetCreationAccounts>;
+export declare function validateFleetCreation(input: FleetCreationIntent, resolved: FleetCreationAccounts, accounts: ReadonlyMap<Address, RawAccount | undefined>, maximumProfileDebit?: bigint): Promise<{
+    profileDebit: bigint;
+    profileReserve: bigint;
+    fleetRent: bigint;
+}>;
+//# sourceMappingURL=fleet-creation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-creation.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAmB5D,MAAM,WAAW,mBAAmB;IAClC,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,KAAK,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,qBAAqB;IACpC,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,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,MAAM,CAgBzB;AACD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAoBhC;AAID,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAkFD"}

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

@@ -0,0 +1,89 @@
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { deriveFleetCreationAddress, emptyDockedFleetSize, } from '../c4/fleet-creation.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 function validateFleetCreationLabel(label) {
+    if (typeof label !== 'string' ||
+        label.trim().length === 0 ||
+        label.includes('\0') ||
+        new TextDecoder('utf-8', { ignoreBOM: true }).decode(new TextEncoder().encode(label)) !== label ||
+        new TextEncoder().encode(label).length > 64)
+        throw new InvalidActionInputError('options.label', label, 'a nonblank, valid UTF-8 Fleet label of at most 64 bytes without NUL', 'Choose a valid Fleet label. Accepted whitespace is preserved in the canonical Fleet address.');
+}
+export async function resolveFleetCreation(input) {
+    const intent = { ...input };
+    validateFleetCreationLabel(intent.label);
+    const [character, profileFaction, fleet] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveProfileFactionAddress(intent.profile),
+        deriveFleetCreationAddress(intent.game, intent.profile, intent.label),
+    ]);
+    return {
+        game: intent.game,
+        profile: intent.profile,
+        authority: intent.authority,
+        system: intent.system,
+        character,
+        profileFaction,
+        fleet,
+        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 validateFleetCreation(input, resolved, accounts, maximumProfileDebit) {
+    const intent = { ...input };
+    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 Fleet creation.`);
+        if (raw.executable)
+            fail(address, `${name} ${address} is executable. Refresh valid account state before creating a Fleet.`);
+        return raw;
+    };
+    const { profileRaw, profile, character } = await readOwnStarbaseFacts(intent, resolved, required, {
+        replan: 'replan Fleet creation',
+        before: 'before creating a Fleet',
+    });
+    if (character.counts.fleets >= character.modifiers.values.fleetConcurrency)
+        fail(resolved.character, 'The Character has no available Fleet slots in its current stored capacity. Free a Fleet slot or refresh changed Character modifiers, then replan.');
+    const target = accounts.get(resolved.fleet);
+    if (target &&
+        (target.address !== resolved.fleet ||
+            target.executable ||
+            target.owner !== '11111111111111111111111111111111' ||
+            target.data.length !== 0))
+        fail(resolved.fleet, 'The canonical Fleet target already contains state or has a conflicting owner. Reuse the existing Fleet or choose a different label and replan.');
+    const rent = readRent(required(resolved.rent, 'Rent sysvar'));
+    const now = readClock(required(resolved.clock, 'Clock sysvar'));
+    const fleetRent = rent(emptyDockedFleetSize());
+    const balance = target?.lamports ?? 0n;
+    const profileDebit = balance < fleetRent ? fleetRent - balance : 0n;
+    if (maximumProfileDebit !== undefined && profileDebit > maximumProfileDebit)
+        fail(resolved.profile, 'Fleet creation 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 Fleet creation.');
+    const auth = grantsPermission(key, PROFILE_SCOPE, 0n);
+    const manages = grantsPermission(key, SAGE_SCOPE, 18n);
+    if (!auth && !manages)
+        fail(resolved.profile, 'The selected key cannot manage Fleets. Use a direct Profile AUTH key or a SAGE manageFleet key 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 };
+}
+//# sourceMappingURL=fleet-creation.js.map

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

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

package/dist/internal/planning/fleet-crew-guard.d.ts

@@ -0,0 +1,28 @@
+import { AccountRole, type Address } from '@solana/kit';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+export interface FleetCrewGuard {
+    readonly kind: 'fleet-crew-transfer';
+    readonly direction: 'load' | 'unload';
+    readonly address: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly system: Address;
+    readonly starbasePlayer: Address;
+    readonly keyIndex: number;
+    readonly count: number;
+    readonly systemSequenceId: bigint;
+    readonly describes: string;
+    readonly dataHash?: never;
+}
+export declare function crewTransferInstruction(g: Omit<FleetCrewGuard, 'kind' | 'systemSequenceId' | 'describes'>): {
+    programAddress: Address<"C4SAgeKLgb3pTLWhVr6NRwWyYFuTR7ZeSXFrzoLwfMzF">;
+    accounts: {
+        address: Address;
+        role: AccountRole;
+    }[];
+    data: Uint8Array<ArrayBuffer>;
+};
+/** Ordinary crew transfers stand alone: later instructions cannot bypass fresh balance checks. */
+export declare function validateCrewTransferInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=fleet-crew-guard.d.ts.map

package/dist/internal/planning/fleet-crew-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-crew-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-crew-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAMxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAK1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;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,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B;AACD,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,kBAAkB,GAAG,WAAW,CAAC;;;;;;;EAyBnE;AACD,kGAAkG;AAClG,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAqCN"}

package/dist/internal/planning/fleet-crew-guard.js

@@ -0,0 +1,48 @@
+import { AccountRole } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, PLAYER_PROFILE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { LOAD_FLEET_CREW_DISCRIMINATOR, UNLOAD_FLEET_CREW_DISCRIMINATOR, } from '../c4/discriminators.js';
+export function crewTransferInstruction(g) {
+    return {
+        programAddress: SAGE_PROGRAM_ADDRESS,
+        accounts: [
+            { address: g.authority, role: AccountRole.READONLY_SIGNER },
+            { address: g.profile, role: AccountRole.WRITABLE },
+            { address: SAGE_PROGRAM_ADDRESS, role: AccountRole.READONLY },
+            { address: PLAYER_PROFILE_PROGRAM_ADDRESS, role: AccountRole.READONLY },
+            { address: g.address, role: AccountRole.WRITABLE },
+            { address: g.game, role: AccountRole.READONLY },
+            { address: g.system, role: AccountRole.READONLY },
+            { address: g.starbasePlayer, role: AccountRole.WRITABLE },
+        ],
+        // Pinned ordinary crew payload: discriminator, u16 count, u16 key index.
+        data: Uint8Array.of(...(g.direction === 'load'
+            ? LOAD_FLEET_CREW_DISCRIMINATOR
+            : UNLOAD_FLEET_CREW_DISCRIMINATOR), g.count & 255, g.count >>> 8, g.keyIndex & 255, g.keyIndex >>> 8),
+    };
+}
+/** Ordinary crew transfers stand alone: later instructions cannot bypass fresh balance checks. */
+export function validateCrewTransferInstructions(steps, guards) {
+    const selected = guards.filter((g) => g.kind === 'fleet-crew-transfer');
+    const transfers = steps.filter(({ instruction: i }) => i.programAddress === SAGE_PROGRAM_ADDRESS &&
+        [LOAD_FLEET_CREW_DISCRIMINATOR, UNLOAD_FLEET_CREW_DISCRIMINATOR].some((d) => d.every((v, n) => i.data?.[n] === v)));
+    if (!selected.length && !transfers.length)
+        return;
+    const bad = () => {
+        throw new InvalidActionInputError('crewTransfer', undefined, 'one standalone ordinary crew transfer and its exact matching safeguard', 'Recreate the crew transfer Plan; execute each transfer separately and refresh crew balances before preparing another action.');
+    };
+    if (steps.length !== 1 || selected.length !== 1 || transfers.length !== 1)
+        bad();
+    const g = selected[0];
+    const step = transfers[0];
+    const expected = crewTransferInstruction(g), actual = step.instruction;
+    if (step.signers.length !== 1 ||
+        step.signers[0] !== g.authority ||
+        actual.accounts?.length !== expected.accounts.length ||
+        expected.accounts.some((a, n) => actual.accounts?.[n]?.address !== a.address ||
+            actual.accounts[n]?.role !== a.role) ||
+        actual.data?.length !== expected.data.length ||
+        expected.data.some((v, n) => actual.data?.[n] !== v))
+        bad();
+}
+//# sourceMappingURL=fleet-crew-guard.js.map

package/dist/internal/planning/fleet-crew-guard.js.map

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

package/dist/internal/planning/fleet-crew-transfer.d.ts

@@ -0,0 +1,7 @@
+import { type Commitment } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import type { FleetCrewGuard } from './fleet-crew-guard.js';
+export type FleetCrewIntent = Pick<FleetCrewGuard, 'address' | 'game' | 'profile' | 'authority' | 'keyIndex' | 'direction' | 'count'>;
+/** Fresh count predicates and canonical relationships, shared by planning and execution. */
+export declare function resolveFleetCrewTransfer(ctx: SageContext, intent: FleetCrewIntent, expected?: FleetCrewGuard, commitment?: Commitment): Promise<Pick<FleetCrewGuard, 'system' | 'starbasePlayer' | 'systemSequenceId'>>;
+//# sourceMappingURL=fleet-crew-transfer.d.ts.map

package/dist/internal/planning/fleet-crew-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-crew-transfer.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-crew-transfer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAyBnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,cAAc,EACZ,SAAS,GACT,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,OAAO,CACV,CAAC;AASF,4FAA4F;AAC5F,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,cAAc,EACzB,UAAU,GAAE,UAAwB,GACnC,OAAO,CACR,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,gBAAgB,GAAG,kBAAkB,CAAC,CACvE,CAyJA"}

package/dist/internal/planning/fleet-crew-transfer.js

@@ -0,0 +1,129 @@
+import { isOffCurveAddress } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { requireGameAddress } from '../game-context.js';
+import { readFreshGameShipDefinitionSequence } from '../../registry/ships.js';
+import { fleetAccountDefinition, deriveFleetAddress } from '../c4/fleet.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { findCharacterPda, characterAccountDefinition, } from '../c4/character.js';
+import { deriveStarbasePlayerAddress, starbasePlayerAccountDefinition, } from '../c4/starbase.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../c4/world.js';
+import { deriveFleetCrewBindingAddress, fleetCrewBindingAccountDefinition, } from '../c4/fleet-crew-binding.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { directProfileKey, grantsPermission, profileKeyExpired, } from './profile-key.js';
+import { deriveCrewRosterAddress } from '../c4/pda.js';
+/** SAGE manage-crew permission bit. */
+const MANAGE_CREW = 27n;
+function fail(message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${message} Refresh the owned Docked Fleet and Starbase crew, then recreate the crew transfer Plan.`);
+}
+/** Fresh count predicates and canonical relationships, shared by planning and execution. */
+export async function resolveFleetCrewTransfer(ctx, intent, expected, commitment = 'confirmed') {
+    if (requireGameAddress(ctx) !== intent.game ||
+        isOffCurveAddress(intent.authority))
+        fail('Crew transfer requires this deployment and an on-curve direct Profile authority.');
+    const [fleetRaw] = await readContextRawAccounts(ctx, [intent.address], {
+        commitment,
+    });
+    if (!fleetRaw || fleetRaw.executable)
+        fail('The selected Fleet is missing or executable.');
+    const fleet = fleetAccountDefinition.decode(fleetRaw);
+    if (fleet.game !== intent.game ||
+        fleet.ownerProfile !== intent.profile ||
+        (await deriveFleetAddress(fleet)) !== intent.address ||
+        fleet.npcFactionId !== 0 ||
+        fleet.subProfile !== '11111111111111111111111111111111')
+        fail('Crew transfer supports only a canonical directly owned player Fleet without a subprofile.');
+    if (fleet.state.kind !== 'docked')
+        fail('Crew can be transferred only while the Fleet is Docked.');
+    if (fleet.rentedCrew !== 0)
+        fail('Rented crew transfers are not supported by this ordinary-crew route. Manage the rental through a supported game client first.');
+    const systemAddress = fleet.state.system;
+    const [characterAddress, bindingAddress] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveFleetCrewBindingAddress(intent.address),
+    ]);
+    const [playerAddress, [rosterAddress]] = await Promise.all([
+        deriveStarbasePlayerAddress(systemAddress, characterAddress),
+        deriveCrewRosterAddress(characterAddress, 0),
+    ]);
+    const addresses = [
+        intent.profile,
+        characterAddress,
+        systemAddress,
+        playerAddress,
+        bindingAddress,
+        rosterAddress,
+        CLOCK_ADDRESS,
+    ];
+    const [rows, shipSequence] = await Promise.all([
+        readContextRawAccounts(ctx, addresses, { commitment }),
+        readFreshGameShipDefinitionSequence(ctx, { commitment }),
+    ]);
+    if (rows.some((raw) => raw?.executable))
+        fail('Crew transfer reads contain an executable account.');
+    const accounts = new Map(addresses.map((a, i) => [a, rows[i]]));
+    const required = (a) => accounts.get(a) ?? fail(`Required crew transfer account ${a} is missing.`);
+    const profile = profileAccountDefinition.decode(required(intent.profile));
+    const character = characterAccountDefinition.decode(required(characterAddress));
+    const system = starSystemAccountDefinition.decode(required(systemAddress));
+    const player = starbasePlayerAccountDefinition.decode(required(playerAddress));
+    if (character.game !== intent.game ||
+        character.playerProfile !== intent.profile ||
+        system.game !== intent.game ||
+        (await deriveStarSystemAddress(system.game, system.systemId)) !==
+            systemAddress ||
+        !system.starbase ||
+        player.playerProfile !== intent.profile ||
+        player.character !== characterAddress ||
+        player.system !== systemAddress ||
+        player.faction !== fleet.faction)
+        fail('The Character, System or StarbasePlayer does not match the canonical Game and Profile relationships.');
+    if (fleet.state.systemSeqId !== system.sequenceId ||
+        player.sequenceId !== system.sequenceId ||
+        (expected &&
+            (expected.system !== systemAddress ||
+                expected.starbasePlayer !== playerAddress ||
+                expected.systemSequenceId !== system.sequenceId)))
+        fail('The docking System or Starbase generation changed. Reconcile docking through the game before transferring crew.');
+    if (fleet.shipDefinitionsSeqId !== shipSequence)
+        fail('Fleet stats use stale ship definitions. Refresh the Fleet through a supported game client before checking crew capacity.');
+    if (accounts.get(rosterAddress))
+        fail('This Character has an individual-crew roster. This planner supports only ordinary crew with no page-0 roster; use the supported game client for roster-aware transfers.');
+    const binding = accounts.get(bindingAddress);
+    if (binding && !fleetCrewBindingAccountDefinition.decode(binding).isNeutral)
+        fail('The Fleet has a populated or unsupported crew binding. Use roster-aware transfer through a supported game client.');
+    const now = readClock(required(CLOCK_ADDRESS));
+    const key = directProfileKey(profile.keys, intent.keyIndex, intent.authority);
+    // The program accepts AUTH, or the SAGE manage-crew permission scoped to
+    // SAGE or to this Fleet.
+    if (!key ||
+        profileKeyExpired(key, now) ||
+        !(grantsPermission(key, PROFILE_SCOPE, 0n) ||
+            grantsPermission(key, SAGE_SCOPE, MANAGE_CREW) ||
+            grantsPermission(key, intent.address, MANAGE_CREW)))
+        fail('Crew transfer requires a current direct Profile key with AUTH, or the SAGE manage-crew permission scoped to SAGE or this Fleet. Select the correct key index; delegated permissions are not qualified.');
+    const capacity = fleet.stats.misc.requiredCrew + fleet.stats.misc.passengerCapacity;
+    if (player.busyCrew > player.totalCrew)
+        fail('Starbase busy crew exceeds its total crew; reconcile the Starbase state before transferring.');
+    if (intent.direction === 'load') {
+        if (player.totalCrew - player.busyCrew < intent.count)
+            fail('The Starbase has too few available crew; finish their current assignments or reduce the requested count.');
+        if (fleet.crewCount + intent.count > capacity ||
+            fleet.crewCount + intent.count > 65535)
+            fail('The requested crew exceed the Fleet required-crew plus passenger capacity; reduce the count.');
+    }
+    else {
+        if (fleet.crewCount < intent.count)
+            fail('The Fleet has fewer crew aboard than requested; reduce the unload count.');
+        if (player.totalCrew + intent.count > 4294967295)
+            fail('The Starbase total crew would exceed its stored limit; select a smaller count.');
+    }
+    return {
+        system: systemAddress,
+        starbasePlayer: playerAddress,
+        systemSequenceId: system.sequenceId,
+    };
+}
+//# sourceMappingURL=fleet-crew-transfer.js.map