@aephia/atlas-kit 0.6.0-next.9 → 0.6.0-next.91

package/dist/internal/planning/fleet-dock-funding-guard.js

@@ -0,0 +1,225 @@
+import { isAddress, isSignerRole, isWritableRole, } from '@solana/kit';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { IDLE_TO_DOCKED_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+import { rentMinimumBalance } from './rent.js';
+export const MAXIMUM_DOCK_GROWTH_BYTES = 40;
+const REASONS = [
+    '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 function dockGrowthDebit(rate, threshold, length) {
+    return (rentMinimumBalance(rate, threshold, length + MAXIMUM_DOCK_GROWTH_BYTES) -
+        rentMinimumBalance(rate, threshold, length));
+}
+export function normalizeFleetDockFundingGuard(value, wire = false) {
+    const bad = () => {
+        throw new InvalidActionInputError('fleet-dock-funding', value, 'the exact current docking intent, Rent quote and gross storage ceiling', 'Recreate the docking Plan; do not alter its saved qualification or debit fields.');
+    };
+    const row = { ...value };
+    const addresses = [
+        'address',
+        'game',
+        'profile',
+        'authority',
+        'certificate',
+        'character',
+        'system',
+        'starbasePlayer',
+    ];
+    const quote = [
+        'maximumProfileDebit',
+        'fleetDataLengthBytes',
+        'rentLamportsPerByteYear',
+        'rentExemptionThreshold',
+        'shipSequenceId',
+        'cargoSequenceId',
+        'starbaseSequenceId',
+    ];
+    const keys = [
+        'kind',
+        ...addresses,
+        'keyIndex',
+        'status',
+        'describes',
+        ...(row.status === 'available' ? quote : ['reason']),
+    ];
+    if (keys.some((k) => !Object.hasOwn(row, k)) ||
+        Object.keys(row).some((k) => !keys.includes(k)))
+        bad();
+    for (const k of addresses)
+        if (typeof row[k] !== 'string' || !isAddress(row[k]))
+            bad();
+    if (row.kind !== 'fleet-dock-funding' ||
+        typeof row.describes !== 'string' ||
+        !row.describes.trim() ||
+        !Number.isInteger(row.keyIndex) ||
+        row.keyIndex < 0 ||
+        row.keyIndex > 65535)
+        bad();
+    if (row.status === 'available') {
+        for (const k of [
+            'maximumProfileDebit',
+            'rentLamportsPerByteYear',
+            'starbaseSequenceId',
+        ]) {
+            if (wire) {
+                if (typeof row[k] !== 'string' || !/^(0|[1-9][0-9]*)$/.test(row[k]))
+                    bad();
+                row[k] = BigInt(row[k]);
+            }
+            if (typeof row[k] !== 'bigint' ||
+                row[k] < 0n ||
+                row[k] > 0xffffffffffffffffn)
+                bad();
+        }
+        for (const k of [
+            'fleetDataLengthBytes',
+            'shipSequenceId',
+            'cargoSequenceId',
+        ])
+            if (!Number.isInteger(row[k]) ||
+                row[k] < 0 ||
+                row[k] > 0xffffffff)
+                bad();
+        if (row.fleetDataLengthBytes < 685 ||
+            typeof row.rentExemptionThreshold !== 'number' ||
+            !Number.isFinite(row.rentExemptionThreshold) ||
+            row.rentExemptionThreshold < 0)
+            bad();
+        try {
+            if (row.maximumProfileDebit !==
+                dockGrowthDebit(row.rentLamportsPerByteYear, row.rentExemptionThreshold, row.fleetDataLengthBytes))
+                bad();
+        }
+        catch {
+            bad();
+        }
+    }
+    else if (row.status !== 'unavailable' ||
+        !REASONS.includes(row.reason))
+        bad();
+    return Object.freeze(row);
+}
+export function dockFundingGuardToJSON(guard) {
+    return Object.fromEntries(Object.entries(guard).map(([key, value]) => [
+        key,
+        typeof value === 'bigint' ? String(value) : value,
+    ]));
+}
+/** Pinned IdleToDocked account order (qualification #825), for diagnostics. */
+const DOCK_ACCOUNT_LABELS = [
+    'authority',
+    'Profile',
+    'key certificate',
+    'Profile program',
+    'Fleet',
+    'Star System',
+    'StarbasePlayer',
+    'Game',
+    'faction relation tracker',
+    'faction standing slot',
+    'faction config slot',
+    'System ownership',
+    'owner faction slot',
+];
+const SEQUENCE_REMEDY = 'Run the steps as separate confirmed transactions, for example with createPlanSequence and executePlanSequence, and refresh the docking Plan after the other step confirms.';
+const PROFILE_REMEDY = 'Refresh funding and recreate a qualified docking Plan, or run the steps as separate confirmed transactions with createPlanSequence and executePlanSequence.';
+/** Requires one exact funding assertion for each current docking instruction. */
+export function validateFleetDockFundingGuards(steps, guards) {
+    const selected = guards.filter((g) => g.kind === 'fleet-dock-funding');
+    const docks = steps.flatMap((step, index) => step.instruction.programAddress === SAGE_PROGRAM_ADDRESS &&
+        IDLE_TO_DOCKED_DISCRIMINATOR.every((v, n) => step.instruction.data?.[n] === v)
+        ? [{ step, index }]
+        : []);
+    const fail = () => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Docking requires its exact instruction-bound Profile storage safeguard. Refresh the Fleet and recreate the docking Plan before signing.');
+    };
+    if (selected.length !== docks.length)
+        fail();
+    for (const { step, index: requiringStepIndex } of docks) {
+        const a = step.instruction.accounts;
+        const matches = selected.filter((g) => g.address === a[4].address);
+        if (matches.length !== 1)
+            fail();
+        const g = matches[0];
+        const data = step.instruction.data;
+        if (g.profile !== a[1].address ||
+            g.authority !== a[0].address ||
+            g.certificate !== a[2].address ||
+            g.system !== a[5].address ||
+            g.starbasePlayer !== a[6].address ||
+            g.game !== a[7].address ||
+            g.keyIndex !== (data[8] | (data[9] << 8)) ||
+            step.signers.length !== 1 ||
+            step.signers[0] !== g.authority)
+            fail();
+        for (const address of [g.address, g.character, g.system, g.starbasePlayer])
+            if (!guards.some((v) => v.kind === 'account-state' && v.address === address))
+                fail();
+        // Transaction compilation merges privileges across instructions, so the
+        // qualified quote holds only if no other step can change what docking
+        // reads or writes. Protection follows the dock's own account roles: its
+        // writable accounts admit no other reference, and its readonly inputs admit
+        // no other writer. The signing authority is not a qualification input, and
+        // an available quote shares its Profile through the per-Profile funding
+        // check, so only an unavailable quote isolates the Profile.
+        a.forEach((meta, position) => {
+            if (isSignerRole(meta.role))
+                return;
+            const profile = position === 1;
+            if (profile && g.status === 'available')
+                return;
+            const exclusive = isWritableRole(meta.role);
+            const conflictingStepIndex = steps.findIndex((other, index) => index !== requiringStepIndex &&
+                other.instruction.accounts?.some((candidate) => candidate.address === meta.address &&
+                    (exclusive || isWritableRole(candidate.role))));
+            if (conflictingStepIndex < 0)
+                return;
+            throw new DockAccountReferenceConflictError({
+                resource: meta.address,
+                // validateFleetDockingGuards pins the 13-account layout.
+                accountLabel: DOCK_ACCOUNT_LABELS[position],
+                verb: exclusive ? 'referencing' : 'writing',
+                condition: profile
+                    ? ' while docking storage bounds are unavailable'
+                    : '',
+                remedy: profile ? PROFILE_REMEDY : SEQUENCE_REMEDY,
+                requiringStepIndex,
+                conflictingStepIndex,
+                requiringStepDescription: step.describes,
+                conflictingStepDescription: steps[conflictingStepIndex].describes,
+            });
+        });
+    }
+}
+/** Account-reference conflicts do not assert a declared semantic invalidation. */
+class DockAccountReferenceConflictError extends SageSdkError {
+    conflictKind = 'references';
+    resource;
+    accountLabel;
+    requiringStepIndex;
+    conflictingStepIndex;
+    requiringStepDescription;
+    conflictingStepDescription;
+    remedy;
+    constructor(options) {
+        const { resource, accountLabel, requiringStepIndex, conflictingStepIndex, requiringStepDescription, conflictingStepDescription, remedy, condition, verb, } = options;
+        super('INCOMPATIBLE_PLAN_COMPOSITION', `Plan step ${String(requiringStepIndex)} ("${requiringStepDescription}") cannot share a transaction with step ${String(conflictingStepIndex)} ("${conflictingStepDescription}") ${verb} the same ${accountLabel} (${resource})${condition}. ${remedy}`);
+        this.resource = resource;
+        this.accountLabel = accountLabel;
+        this.requiringStepIndex = requiringStepIndex;
+        this.conflictingStepIndex = conflictingStepIndex;
+        this.requiringStepDescription = requiringStepDescription;
+        this.conflictingStepDescription = conflictingStepDescription;
+        this.remedy = remedy;
+    }
+}
+//# sourceMappingURL=fleet-dock-funding-guard.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { Address, RawAccount, SageContext } from '../../client/contracts.js';
+import { type DockingSequences } from '../../registry/docking.js';
+import { type DockFundingAmounts, type DockFundingIntent, type FleetDockFundingGuard } from './fleet-dock-funding-guard.js';
+export declare function resolveDockFunding(ctx: SageContext, intent: DockFundingIntent, raw: readonly RawAccount[]): Promise<DockFundingAmounts>;
+export declare function revalidateDockFunding(guard: FleetDockFundingGuard, accounts: ReadonlyMap<Address, RawAccount | undefined>, sequences: DockingSequences | undefined): {
+    profileDebit: bigint;
+    profileReserve: bigint;
+} | undefined;
+//# sourceMappingURL=fleet-dock-funding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-dock-funding.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-dock-funding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AA+IvC,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,SAAS,UAAU,EAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAqC7B;AACD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,SAAS,EAAE,gBAAgB,GAAG,SAAS,GACtC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAoB9D"}

package/dist/internal/planning/fleet-dock-funding.js

@@ -0,0 +1,154 @@
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { fleetAccountDefinition } from '../c4/fleet.js';
+import { starbasePlayerAccountDefinition } from '../c4/starbase.js';
+import { starSystemAccountDefinition } from '../c4/world.js';
+import { validateProfileAccountShape } from '../c4/identity.js';
+import { hasCanonicalDockingEncoding } from '../c4/docking-funding.js';
+import { decodeDockingSequences, } from '../../registry/docking.js';
+import { RENT_ADDRESS, readRent, RentCalculationError } from './rent.js';
+import { dockGrowthDebit, } from './fleet-dock-funding-guard.js';
+function unavailable(reason) {
+    return { status: 'unavailable', reason };
+}
+/** Restrict optional estimates to validated account-format and Rent-value errors. */
+function estimateFailure(error) {
+    if (!(error instanceof SageSdkError) ||
+        !(error.code === 'ACCOUNT_DECODE_FAILED' ||
+            error.code === 'INVALID_ACCOUNT_OWNER' ||
+            error.code === 'INVALID_DISCRIMINATOR' ||
+            error instanceof RentCalculationError))
+        throw error;
+    return unavailable(error.code === 'ACCOUNT_DECODE_FAILED'
+        ? 'unsupported-account-layout'
+        : 'funding-state-unavailable');
+}
+function requiredFundingAccount(raw, address, label) {
+    if (!raw)
+        throw new SageSdkError('ACCOUNT_NOT_FOUND', `The ${label} account (${address}) was not returned while checking docking funding. Verify the deployment and provider, refresh the account, and recreate the Plan.`, { address });
+    return raw;
+}
+function qualifyDockAccounts(intent, accounts) {
+    const fleetRaw = accounts.get(intent.address), playerRaw = accounts.get(intent.starbasePlayer), systemRaw = accounts.get(intent.system);
+    if (!fleetRaw || !playerRaw || !systemRaw)
+        return unavailable('funding-state-unavailable');
+    const fleet = fleetAccountDefinition.decode(fleetRaw), player = starbasePlayerAccountDefinition.decode(playerRaw), system = starSystemAccountDefinition.decode(systemRaw);
+    if (fleetRaw.executable ||
+        playerRaw.executable ||
+        systemRaw.executable ||
+        fleet.game !== intent.game ||
+        fleet.ownerProfile !== intent.profile ||
+        player.playerProfile !== intent.profile ||
+        player.character !== intent.character ||
+        player.system !== intent.system ||
+        system.game !== intent.game)
+        return unavailable('funding-state-unavailable');
+    if (fleet.version !== 0 || player.version !== 0)
+        return unavailable('unsupported-account-layout');
+    if (fleet.state.kind !== 'idle')
+        return unavailable('unsupported-fleet-state');
+    if (!hasCanonicalDockingEncoding(fleetRaw, playerRaw))
+        return unavailable('noncanonical-account-encoding');
+    if (fleet.activeStimulants.length)
+        return unavailable('active-stimulants');
+    if (fleet.pendingHp !== 0 ||
+        fleet.respawningCargo.amounts.length ||
+        fleet.respawningCargo.storageCost !== 0n ||
+        player.respawning.cargo.amounts.length ||
+        player.respawning.cargo.usedStorageUnitsRaw !== 0n ||
+        player.respawning.ships.length ||
+        player.respawning.claimStakes.length ||
+        player.respawning.craftingHabs.length ||
+        player.respawning.crew.quantityRaw !== 0n ||
+        player.respawning.crew.completesAtUnixSeconds !== 0n ||
+        player.cargoRespawnEndsAtUnixSeconds !== 0n)
+        return unavailable('pending-recovery');
+    if (!system.starbase || player.sequenceId !== system.sequenceId)
+        return unavailable('stale-starbase-sequence');
+    return { status: 'qualified', fleetRaw, playerRaw, fleet, player };
+}
+function calculateDockFunding(intent, accounts, sequences, qualified = qualifyDockAccounts(intent, accounts)) {
+    if (qualified.status === 'unavailable')
+        return qualified;
+    const { fleetRaw, playerRaw, fleet, player } = qualified;
+    if (!sequences)
+        return unavailable('funding-state-unavailable');
+    if (fleet.shipDefinitionsSeqId !== sequences.shipSequenceId ||
+        [
+            fleet.cargoHold.seqId,
+            fleet.components.seqId,
+            fleet.respawningCargo.seqId,
+            player.cargo.sequenceId,
+            player.respawning.cargo.sequenceId,
+        ].some((seq) => seq !== sequences.cargoSequenceId))
+        return unavailable('stale-definition-sequences');
+    const profile = requiredFundingAccount(accounts.get(intent.profile), intent.profile, 'Profile'), rentRaw = requiredFundingAccount(accounts.get(RENT_ADDRESS), RENT_ADDRESS, 'Rent sysvar');
+    if (profile.executable)
+        return unavailable('funding-state-unavailable');
+    validateProfileAccountShape(profile);
+    const rent = readRent(rentRaw);
+    if ([fleetRaw, playerRaw].some((a) => a.lamports < rent(a.data.length)))
+        return unavailable('accounts-below-rent-reserve');
+    const { rentLamportsPerByteYear, rentExemptionThreshold } = rent;
+    const maximumProfileDebit = dockGrowthDebit(rentLamportsPerByteYear, rentExemptionThreshold, fleetRaw.data.length);
+    const profileReserve = rent(profile.data.length);
+    if (profile.lamports < profileReserve + maximumProfileDebit)
+        return unavailable('profile-below-storage-ceiling');
+    return {
+        status: 'available',
+        profileReserve,
+        maximumProfileDebit,
+        fleetDataLengthBytes: fleetRaw.data.length,
+        rentLamportsPerByteYear,
+        rentExemptionThreshold,
+        shipSequenceId: sequences.shipSequenceId,
+        cargoSequenceId: sequences.cargoSequenceId,
+        starbaseSequenceId: player.sequenceId,
+    };
+}
+export async function resolveDockFunding(ctx, intent, raw) {
+    const accounts = new Map(raw.map((a) => [a.address, a]));
+    // Core account decoding remains strict; only optional estimate inputs below
+    // may turn an otherwise supported dock into an unavailable quote.
+    const qualified = qualifyDockAccounts(intent, accounts);
+    if (qualified.status === 'unavailable')
+        return qualified;
+    // One fresh batch, as at execution. Transport, lifecycle and programming
+    // errors reject, and so does any missing required estimate account.
+    const inputs = [
+        [intent.game, 'Game'],
+        [intent.profile, 'Profile'],
+        [RENT_ADDRESS, 'Rent sysvar'],
+    ];
+    const rows = await readContextRawAccounts(ctx, inputs.map(([address]) => address));
+    inputs.forEach(([address, label], index) => accounts.set(address, requiredFundingAccount(rows[index], address, label)));
+    try {
+        // The Game is decoded behind the registry boundary; only typed
+        // account-format and Rent-value failures become an unavailable quote.
+        const current = calculateDockFunding(intent, accounts, decodeDockingSequences(accounts.get(intent.game)), qualified);
+        if (current.status === 'unavailable')
+            return current;
+        const { profileReserve: _profileReserve, ...amounts } = current;
+        return amounts;
+    }
+    catch (error) {
+        return estimateFailure(error);
+    }
+}
+export function revalidateDockFunding(guard, accounts, sequences) {
+    if (guard.status === 'unavailable')
+        return undefined;
+    const current = calculateDockFunding(guard, accounts, sequences);
+    if (current.status !== 'available' ||
+        current.maximumProfileDebit > guard.maximumProfileDebit ||
+        current.shipSequenceId !== guard.shipSequenceId ||
+        current.cargoSequenceId !== guard.cargoSequenceId ||
+        current.starbaseSequenceId !== guard.starbaseSequenceId ||
+        current.fleetDataLengthBytes !== guard.fleetDataLengthBytes)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Docking no longer has qualified storage funding within its approved Profile ceiling. Refresh the Fleet, Starbase Player, definitions and Rent; fund the Profile explicitly if needed, then recreate and inspect the Plan before signing.', { address: guard.profile });
+    return {
+        profileDebit: guard.maximumProfileDebit,
+        profileReserve: current.profileReserve,
+    };
+}
+//# sourceMappingURL=fleet-dock-funding.js.map

package/dist/internal/planning/fleet-dock-funding.js.map

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

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

@@ -0,0 +1,4 @@
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Binds the qualified current docking route to its mandatory faction policy safeguard. */
+export declare function validateFleetDockingGuards(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=fleet-docking-guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-docking-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-docking-guard.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE1E,2FAA2F;AAC3F,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAgDN"}

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

@@ -0,0 +1,42 @@
+import { AccountRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { IDLE_TO_DOCKED_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, PLAYER_PROFILE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+/** Binds the qualified current docking route to its mandatory faction policy safeguard. */
+export function validateFleetDockingGuards(steps, guards) {
+    for (const { instruction } of steps) {
+        if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS ||
+            !IDLE_TO_DOCKED_DISCRIMINATOR.every((byte, index) => instruction.data?.[index] === byte))
+            continue;
+        const a = instruction.accounts;
+        const r = AccountRole.READONLY;
+        const w = AccountRole.WRITABLE;
+        const roles = [
+            AccountRole.READONLY_SIGNER,
+            w,
+            r,
+            r,
+            w,
+            r,
+            w,
+            r,
+            r,
+            r,
+            r,
+            r,
+            r,
+        ];
+        if (instruction.data?.length !== 10 ||
+            a?.length !== 13 ||
+            roles.some((role, i) => a[i].role !== role) ||
+            a[3].address !== PLAYER_PROFILE_PROGRAM_ADDRESS ||
+            [9, 10, 12].some((i) => a[i].address !== SAGE_PROGRAM_ADDRESS) ||
+            !guards.some((g) => g.kind === 'fleet-docking-policy' &&
+                g.address === a[8].address &&
+                g.game === a[7].address &&
+                g.system === a[5].address &&
+                g.ownership === a[11].address)) {
+            throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Docking requires the current thirteen-account instruction and its matching default faction-policy safeguard. Refresh the Fleet and recreate its docking Plan before signing.');
+        }
+    }
+}
+//# sourceMappingURL=fleet-docking-guard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-docking-guard.js","sourceRoot":"","sources":["../../../src/internal/planning/fleet-docking-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAGnC,2FAA2F;AAC3F,MAAM,UAAU,0BAA0B,CACxC,KAA0B,EAC1B,MAAmC;IAEnC,KAAK,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QACpC,IACE,WAAW,CAAC,cAAc,KAAK,oBAAoB;YACnD,CAAC,4BAA4B,CAAC,KAAK,CACjC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CACpD;YAED,SAAS;QACX,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC;QAC/B,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC;QAC/B,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC;QAC/B,MAAM,KAAK,GAAG;YACZ,WAAW,CAAC,eAAe;YAC3B,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;YACD,CAAC;SACF,CAAC;QACF,IACE,WAAW,CAAC,IAAI,EAAE,MAAM,KAAK,EAAE;YAC/B,CAAC,EAAE,MAAM,KAAK,EAAE;YAChB,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,IAAI,CAAC;YAC5C,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,KAAK,8BAA8B;YAChD,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,KAAK,oBAAoB,CAAC;YAC/D,CAAC,MAAM,CAAC,IAAI,CACV,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,sBAAsB;gBACjC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO;gBAC3B,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO;gBACxB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO;gBAC1B,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,EAAE,CAAE,CAAC,OAAO,CACjC,EACD,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,8KAA8K,CAC/K,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+import { type Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+/** Validates only the measured legacy-controller/default-gating docking route. */
+export declare function validateFleetDockingPolicy(tracker: RawAccount | undefined, ownership: RawAccount | undefined, scope: {
+    readonly game: Address;
+    readonly system: Address;
+    readonly address: Address;
+    readonly ownership: Address;
+}): Promise<void>;
+//# sourceMappingURL=fleet-docking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-docking.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/fleet-docking.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AASrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAoB5D,kFAAkF;AAClF,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,SAAS,EAAE,UAAU,GAAG,SAAS,EACjC,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,GACA,OAAO,CAAC,IAAI,CAAC,CAuGf"}

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

@@ -0,0 +1,85 @@
+import { getAddressEncoder, getProgramDerivedAddress, } from '@solana/kit';
+import { SAGE_PROGRAM_ADDRESS, FACTION_OWNERSHIP_DISCRIMINATOR, FACTION_RELATION_TRACKER_DISCRIMINATOR, getFactionOwnershipDecoder, getFactionRelationTrackerDecoder, } from '../c4/runtime-bindings.js';
+import { adapter } from '../c4/faction-adapter.js';
+import { SageSdkError } from '../../client/errors.js';
+// Reuse the exact generated codecs and shared raw-account validation without
+// bringing unrelated faction gameplay projections into the Plan execution bundle.
+const trackerDefinition = /* @__PURE__ */ adapter({
+    type: 'factionRelationTracker',
+    discriminator: FACTION_RELATION_TRACKER_DISCRIMINATOR,
+    minimumDataLength: 78,
+    decoder: /* @__PURE__ */ getFactionRelationTrackerDecoder(),
+    translate: (value) => value,
+});
+const ownershipDefinition = /* @__PURE__ */ adapter({
+    type: 'factionOwnership',
+    discriminator: FACTION_OWNERSHIP_DISCRIMINATOR,
+    minimumDataLength: 145,
+    exact: true,
+    decoder: /* @__PURE__ */ getFactionOwnershipDecoder(),
+    translate: (value) => value,
+});
+/** Validates only the measured legacy-controller/default-gating docking route. */
+export async function validateFleetDockingPolicy(tracker, ownership, scope) {
+    const invalid = (address, cause) => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Docking at Star System ${scope.system}: ${cause}. Refresh the indicated faction account for the configured Game and System, verify its current binding version, and recreate the docking Plan.`, { address });
+    };
+    if (!tracker)
+        invalid(scope.address, `missing Game faction relation tracker ${scope.address}`);
+    if (!ownership)
+        invalid(scope.ownership, `missing System ownership ${scope.ownership}`);
+    if (tracker.executable)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} is executable`);
+    if (ownership.executable)
+        invalid(scope.ownership, `System ownership ${scope.ownership} is executable`);
+    if (tracker.address !== scope.address)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} returned account ${tracker.address}`);
+    if (ownership.address !== scope.ownership)
+        invalid(scope.ownership, `System ownership ${scope.ownership} returned account ${ownership.address}`);
+    const [trackerPda, ownershipPda] = await Promise.all([
+        getProgramDerivedAddress({
+            programAddress: SAGE_PROGRAM_ADDRESS,
+            seeds: [
+                new TextEncoder().encode('FactionRelations'),
+                getAddressEncoder().encode(scope.game),
+            ],
+        }),
+        getProgramDerivedAddress({
+            programAddress: SAGE_PROGRAM_ADDRESS,
+            seeds: [
+                new TextEncoder().encode('FactionOwnership'),
+                getAddressEncoder().encode(scope.game),
+                new Uint8Array([0]),
+                getAddressEncoder().encode(scope.system),
+            ],
+        }),
+    ]);
+    const relation = trackerDefinition.decode(tracker);
+    const owner = ownershipDefinition.decode(ownership);
+    if (relation.version !== 0)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} has unsupported account version ${String(relation.version)}`);
+    if (owner.version !== 0)
+        invalid(scope.ownership, `System ownership ${scope.ownership} has unsupported account version ${String(owner.version)}`);
+    if (trackerPda[0] !== scope.address ||
+        relation.bump !== trackerPda[1] ||
+        relation.gameId !== scope.game)
+        invalid(scope.address, `Game faction relation tracker ${scope.address} does not match its canonical Game identity or PDA`);
+    if (ownershipPda[0] !== scope.ownership ||
+        owner.bump !== ownershipPda[1] ||
+        owner.gameId !== scope.game ||
+        owner.assetKind !== 0 ||
+        !getAddressEncoder()
+            .encode(scope.system)
+            .every((byte, index) => owner.assetKey[index] === byte))
+        invalid(scope.ownership, `System ownership ${scope.ownership} does not match its canonical Game/System identity or PDA`);
+    const unsupported = (address, cause) => {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Docking at Star System ${scope.system}: ${cause}; this policy is unsupported by the qualified docking route. Choose a System with controller 0–3 and disabled territory/economic gates, or use independently qualified SDK support for this policy. Refresh the faction accounts and recreate the Plan after the policy changes.`, { address });
+    };
+    if (relation.territoryAccessEnabled !== 0)
+        unsupported(scope.address, 'territory access gating is enabled');
+    if (relation.crossFactionEconomicsEnabled !== 0)
+        unsupported(scope.address, 'cross-faction economic gating is enabled');
+    if (owner.controllingFaction > 3)
+        unsupported(scope.ownership, `controller ${String(owner.controllingFaction)} governs this System`);
+}
+//# sourceMappingURL=fleet-docking.js.map

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

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

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").AccountLookupMeta<string, string> | import("@solana/kit").AccountMeta<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":"AAAA,OAAO,EAAqB,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAuCzE,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;;;;;;;;;;GAqOrC"}