@aephia/atlas-kit 0.6.0-next.16 → 0.6.0-next.161

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":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAgBjC,MAAM,UAAU,uBAAuB,CACrC,CAAkE;IAElE,OAAO;QACL,cAAc,EAAE,oBAAoB;QACpC,QAAQ,EAAE;YACR,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,eAAe,EAAE;YAC3D,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAClD,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC7D,EAAE,OAAO,EAAE,8BAA8B,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YACvE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAClD,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC/C,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YACjD,EAAE,OAAO,EAAE,CAAC,CAAC,cAAc,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;SAC1D;QACD,yEAAyE;QACzE,IAAI,EAAE,UAAU,CAAC,EAAE,CACjB,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM;YACxB,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,+BAA+B,CAAC,EACpC,CAAC,CAAC,KAAK,GAAG,GAAG,EACb,CAAC,CAAC,KAAK,KAAK,CAAC,EACb,CAAC,CAAC,QAAQ,GAAG,GAAG,EAChB,CAAC,CAAC,QAAQ,KAAK,CAAC,CACjB;KACF,CAAC;AACJ,CAAC;AACD,kGAAkG;AAClG,MAAM,UAAU,gCAAgC,CAC9C,KAA0B,EAC1B,MAAmC;IAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAC5B,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CACrB,CAAC,CAAC,cAAc,KAAK,oBAAoB;QACzC,CAAC,6BAA6B,EAAE,+BAA+B,CAAC,CAAC,IAAI,CACnE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAC5C,CACJ,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO;IAClD,MAAM,GAAG,GAAG,GAAU,EAAE;QACtB,MAAM,IAAI,uBAAuB,CAC/B,cAAc,EACd,SAAS,EACT,wEAAwE,EACxE,8HAA8H,CAC/H,CAAC;IACJ,CAAC,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QACvE,GAAG,EAAE,CAAC;IACR,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IACvB,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,CAAC,CAAC,EACzC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5B,IACE,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS;QAC/B,MAAM,CAAC,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,QAAQ,CAAC,MAAM;QACpD,QAAQ,CAAC,QAAQ,CAAC,IAAI,CACpB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,OAAO;YAC3C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC,IAAI,CACtC;QACD,MAAM,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,MAAM;QAC5C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAEpD,GAAG,EAAE,CAAC;AACV,CAAC"}

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('The Fleet was built under older ship definitions, so its crew capacity is stale. Plan planSyncFleetWithGame, confirm it, then replan the crew transfer.');
+    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

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

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

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

@@ -0,0 +1,12 @@
+import type { Instruction } from '@solana/kit';
+import type { PlanPrecondition, PlanSemanticFact, PlanStep } from '../../planning/index.js';
+/** The step semantics every disband carries: it closes the Fleet and frees a
+ * Character Fleet slot, so it must be the only instruction in its transaction
+ * and no later step may rely on the Fleet or the Character's capacity. */
+export declare function disbandSemantics(instruction: Instruction): readonly PlanSemanticFact[];
+/** Binds every Fleet disband to the safety it was planned with, whatever a
+ * saved or custom Plan carries: the disband stands alone in its Plan, keeps
+ * its exact step semantics, and has an account-state guard for the Fleet it
+ * closes, so a changed Fleet refuses the Plan. */
+export declare function validateFleetDisbandInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=fleet-disband-guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-disband-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-disband-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACT,MAAM,yBAAyB,CAAC;AAiBjC;;0EAE0E;AAC1E,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,GACvB,SAAS,gBAAgB,EAAE,CAe7B;AAmBD;;;kDAGkD;AAClD,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAuBN"}

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

@@ -0,0 +1,54 @@
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { DISBAND_FLEET_DISCRIMINATOR } from '../c4/discriminators.js';
+import { DISBAND_CHARACTER_INDEX, DISBAND_FLEET_INDEX, } from '../c4/fleet-disband-layout.js';
+import { SAGE_PROGRAM_ADDRESS } from '../c4/runtime-bindings.js';
+function isDisband(instruction) {
+    return (instruction.programAddress === SAGE_PROGRAM_ADDRESS &&
+        DISBAND_FLEET_DISCRIMINATOR.every((byte, index) => instruction.data?.[index] === byte));
+}
+/** The step semantics every disband carries: it closes the Fleet and frees a
+ * Character Fleet slot, so it must be the only instruction in its transaction
+ * and no later step may rely on the Fleet or the Character's capacity. */
+export function disbandSemantics(instruction) {
+    const metas = instruction.accounts;
+    return [
+        { kind: 'exclusive', scope: 'transaction' },
+        {
+            kind: 'invalidates',
+            resource: `fleet:${metas[DISBAND_FLEET_INDEX].address}`,
+            fact: 'exists',
+        },
+        {
+            kind: 'invalidates',
+            resource: `character:${metas[DISBAND_CHARACTER_INDEX].address}`,
+            fact: 'fleet-creation-capacity',
+        },
+    ];
+}
+function sameSemantics(actual, expected) {
+    return (actual?.length === expected.length &&
+        expected.every((fact, index) => {
+            const other = actual[index];
+            return (other !== undefined &&
+                Object.keys(other).length === Object.keys(fact).length &&
+                Object.entries(fact).every(([key, value]) => other[key] === value));
+        }));
+}
+/** Binds every Fleet disband to the safety it was planned with, whatever a
+ * saved or custom Plan carries: the disband stands alone in its Plan, keeps
+ * its exact step semantics, and has an account-state guard for the Fleet it
+ * closes, so a changed Fleet refuses the Plan. */
+export function validateFleetDisbandInstructions(steps, guards) {
+    const disbands = steps.filter(({ instruction }) => isDisband(instruction));
+    if (disbands.length === 0)
+        return;
+    if (steps.length !== 1)
+        throw new SageSdkError('INCOMPATIBLE_PLAN_COMPOSITION', 'A Fleet disband must be the only instruction in its transaction. Execute the disband as its own Plan, confirm it, then prepare the next action from fresh state, or use a PlanSequence.');
+    const step = disbands[0];
+    const fleet = step.instruction.accounts?.[DISBAND_FLEET_INDEX]?.address;
+    if (step.instruction.accounts?.length !== 11 ||
+        !sameSemantics(step.semantics, disbandSemantics(step.instruction)) ||
+        guards.filter((guard) => guard.kind === 'account-state' && guard.address === fleet).length !== 1)
+        throw new InvalidActionInputError('fleetDisband', undefined, 'one standalone disband with its exact step semantics and one account-state guard for its Fleet', 'Recreate the disband Plan with planFleetDisband; a saved Plan cannot drop its Fleet check or transaction exclusivity.');
+}
+//# sourceMappingURL=fleet-disband-guard.js.map

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

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

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

@@ -0,0 +1,36 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import { type FleetAccountData } from '../c4/fleet.js';
+/** A player's request to disband one Docked Fleet. */
+export interface FleetDisbandIntent {
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly fleet: Address;
+    readonly system: Address;
+}
+/** The accounts disband validation reads, derived from the intent. */
+export interface FleetDisbandAccounts {
+    readonly profile: Address;
+    readonly character: Address;
+    readonly profileFaction: Address;
+    readonly system: Address;
+    readonly starbasePlayer: Address;
+    readonly fleet: Address;
+    readonly rent: Address;
+    readonly clock: Address;
+}
+export declare function resolveFleetDisband(intent: FleetDisbandIntent): Promise<FleetDisbandAccounts>;
+/** Checks the program's disband rules that fresh accounts can show, verified
+ * against the program's behaviour: a canonical owned player Fleet, not rented,
+ * Docked (the caller selects its System from that state) at a Starbase where the Character has a current StarbasePlayer of the
+ * Fleet's faction, repairable to full HP, with no warp or scan cooldown
+ * running, and a current direct Profile AUTH key or a manageFleet key scoped
+ * to SAGE or the Fleet. AP and SP recover on timers and must be full when the
+ * instruction runs; they stay chain-authoritative. */
+export declare function validateFleetDisband(intent: FleetDisbandIntent, resolved: FleetDisbandAccounts, accounts: ReadonlyMap<Address, RawAccount | undefined>): Promise<{
+    readonly fleet: FleetAccountData;
+    readonly now: bigint;
+}>;
+//# sourceMappingURL=fleet-disband.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-disband.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-disband.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAexB,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,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,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,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;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAMD;;;;;;sDAMsD;AACtD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAoFrE"}

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

@@ -0,0 +1,82 @@
+import { SageSdkError } from '../../client/errors.js';
+import { findCharacterPda } from '../c4/character.js';
+import { deriveFleetAddress, fleetAccountDefinition, } from '../c4/fleet.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { deriveProfileFactionAddress } from '../c4/profile-faction.js';
+import { deriveStarbasePlayerAddress } from '../c4/starbase.js';
+import { SYSTEM_PROGRAM } from '../system-program.js';
+import { describeFleetRental } from './fleet-rental.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { readOwnStarbaseFacts } from './own-starbase-facts.js';
+import { directProfileKey, grantsPermission, profileKeyExpired, } from './profile-key.js';
+import { RENT_ADDRESS } from './rent.js';
+export async function resolveFleetDisband(intent) {
+    const [character, profileFaction] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveProfileFactionAddress(intent.profile),
+    ]);
+    return {
+        profile: intent.profile,
+        character,
+        profileFaction,
+        system: intent.system,
+        starbasePlayer: await deriveStarbasePlayerAddress(intent.system, character),
+        fleet: intent.fleet,
+        rent: RENT_ADDRESS,
+        clock: CLOCK_ADDRESS,
+    };
+}
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+/** Checks the program's disband rules that fresh accounts can show, verified
+ * against the program's behaviour: a canonical owned player Fleet, not rented,
+ * Docked (the caller selects its System from that state) at a Starbase where the Character has a current StarbasePlayer of the
+ * Fleet's faction, repairable to full HP, with no warp or scan cooldown
+ * running, and a current direct Profile AUTH key or a manageFleet key scoped
+ * to SAGE or the Fleet. AP and SP recover on timers and must be full when the
+ * instruction runs; they stay chain-authoritative. */
+export async function validateFleetDisband(intent, resolved, accounts) {
+    const required = (address, name) => {
+        const raw = accounts.get(address);
+        if (!raw)
+            fail(address, `${name} ${address} is missing. Refresh the account, or register what the Fleet needs, before disbanding it.`);
+        if (raw.executable)
+            fail(address, `${name} ${address} is executable. Refresh valid account state before disbanding the Fleet.`);
+        return raw;
+    };
+    const { profile, faction, system, player } = await readOwnStarbaseFacts(intent, resolved, required, { replan: 'replan the Fleet disband', before: 'before disbanding a Fleet' }, { 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 the disband.`);
+    const fleet = fleetAccountDefinition.decode(required(resolved.fleet, 'Fleet'));
+    if ((await deriveFleetAddress(fleet)) !== intent.fleet ||
+        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 a different Game, Profile, faction or NPC affiliation. Select a canonical owned player Fleet and replan the disband.');
+    if (fleet.subProfile !== SYSTEM_PROGRAM)
+        fail(resolved.fleet, `The Fleet is ${describeFleetRental(fleet.subProfile)}, so it cannot disband. End the rental, refresh the Fleet and replan.`);
+    // HP can only recover from the pending repair reservoir, so a Fleet whose HP
+    // plus reservoir is below its maximum can never qualify.
+    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 only a fully repaired Fleet can disband. Repair the Fleet, refresh it and replan.`);
+    const now = readClock(required(resolved.clock, 'Clock sysvar'));
+    for (const [name, expiresAt] of [
+        ['warp', fleet.warpCooldownExpiresAt],
+        ['scan', fleet.scanCooldownExpiresAt],
+    ])
+        if (now < expiresAt)
+            fail(resolved.fleet, `The Fleet's ${name} cooldown runs until ${String(expiresAt)} Unix seconds (chain time is ${String(now)}), and a Fleet cannot disband while it runs. Wait for the cooldown, refresh the Fleet and 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 the disband.');
+    if (profileKeyExpired(key, now))
+        fail(resolved.profile, 'The selected Profile key has expired. Renew it or select a current direct key and replan the disband.');
+    if (!grantsPermission(key, PROFILE_SCOPE, 0n) &&
+        !grantsPermission(key, SAGE_SCOPE, 18n) &&
+        !grantsPermission(key, intent.fleet, 18n))
+        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 the disband.');
+    return { fleet, now };
+}
+//# sourceMappingURL=fleet-disband.js.map

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

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

package/dist/internal/planning/fleet-dock-funding-guard.d.ts

@@ -0,0 +1,42 @@
+import { type Address } from '@solana/kit';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+import { type GuardSchema } from './plan-fields.js';
+export declare const MAXIMUM_DOCK_GROWTH_BYTES = 40;
+declare const REASONS: readonly ["unsupported-account-layout", "unsupported-fleet-state", "noncanonical-account-encoding", "stale-definition-sequences", "stale-starbase-sequence", "pending-recovery", "active-stimulants", "funding-state-unavailable", "accounts-below-rent-reserve", "profile-below-storage-ceiling"];
+export type DockBoundsUnavailableReason = (typeof REASONS)[number];
+export type DockFundingAmounts = {
+    readonly status: 'unavailable';
+    readonly reason: DockBoundsUnavailableReason;
+} | {
+    readonly status: 'available';
+    readonly maximumProfileDebit: bigint;
+    readonly fleetDataLengthBytes: number;
+    readonly rentLamportsPerByteYear: bigint;
+    readonly rentExemptionThreshold: number;
+    readonly shipSequenceId: number;
+    readonly cargoSequenceId: number;
+    readonly starbaseSequenceId: bigint;
+};
+export interface DockFundingIntent {
+    readonly address: Address;
+    readonly game: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly certificate: Address;
+    readonly keyIndex: number;
+    readonly character: Address;
+    readonly system: Address;
+    readonly starbasePlayer: Address;
+}
+export type FleetDockFundingGuard = DockFundingIntent & DockFundingAmounts & {
+    readonly kind: 'fleet-dock-funding';
+    readonly describes: string;
+    readonly dataHash?: never;
+};
+export declare function dockGrowthDebit(rate: bigint, threshold: number, length: number): bigint;
+/** Plan guard schema: exact docking intent, Rent quote and gross storage ceiling. */
+export declare const FLEET_DOCK_FUNDING_SCHEMA: GuardSchema;
+/** Requires one exact funding assertion for each current docking instruction. */
+export declare function validateFleetDockFundingGuards(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+export {};
+//# sourceMappingURL=fleet-dock-funding-guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-dock-funding-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-dock-funding-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAIL,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,QAAA,MAAM,OAAO,oSAWH,CAAC;AACX,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC,CAAC;AACN,MAAM,WAAW,iBAAiB;IAChC,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,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AACD,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GACnD,kBAAkB,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AACJ,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAKR;AAWD,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,EAAE,WAuEvC,CAAC;AAqBF,iFAAiF;AACjF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CA0FN"}