@aephia/atlas-kit 0.6.0-next.10 → 0.6.0-next.101

package/dist/fleets/actions/add-ship.d.ts

@@ -0,0 +1,35 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import type { PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
+import { type Plan } from '../../planning/index.js';
+/** Explicit address-only selection of escrowed ships for an owned Docked Fleet.
+ * @example
+ * ```ts
+ * declare const profile: Address, authority: Address;
+ * const options: PlanAddShipToFleetOptions = {authorization:{profile,authority,keyIndex:0},shipId:1,amount:1n};
+ * ```
+ */
+export interface PlanAddShipToFleetOptions {
+    readonly authorization: PlanAuthorization;
+    readonly shipId: number;
+    readonly amount: bigint;
+}
+/** Plans one singleton transfer of an exact ship configuration from StarbasePlayer entitlement to an owned Docked Fleet.
+ * Supports requirements-free XXS ships at own-faction CSS Starbases, current Fleet
+ * definition sequences and both Character and Game ship-assembly capacity limits.
+ * The explicit ship ID must be a u16 and the whole ship amount must be 1n through 255n. Uses a direct Profile
+ * AUTH or SAGE manageFleet key; a positive Profile rent shortfall additionally
+ * requires vault-funding permission. No token transfer or onboarding occurs.
+ * Final stats, research, refresh and outcomes remain chain-authoritative.
+ * Simulate before signing. The observed debit ceiling is rechecked before
+ * signing and is not an atomic on-chain spending cap. Two assembly Plans for the same Profile
+ * cannot compose because they share funds and assembly state.
+ * @example
+ * ```ts
+ * declare const ctx:SageContext, fleet:Address, profile:Address, authority:Address;
+ * const plan = await planAddShipToFleet(ctx,fleet,{authorization:{profile,authority,keyIndex:0},shipId:1,amount:1n});
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planAddShipToFleet(ctx: SageContext, fleet: Address, input: PlanAddShipToFleetOptions): Promise<Plan>;
+//# sourceMappingURL=add-ship.d.ts.map

package/dist/fleets/actions/add-ship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-ship.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/add-ship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAS1F,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAChE;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA8DD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA4Ff"}

package/dist/fleets/actions/add-ship.js

@@ -0,0 +1,149 @@
+import { isAddress, isOffCurveAddress } from '@solana/kit';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { fleetAccountDefinition } from '../../internal/c4/fleet.js';
+import { addShipToFleetInstruction } from '../../internal/c4/fleet-ship-assembly.js';
+import { resolveFleetShipAssembly, validateFleetShipAssembly, } from '../../internal/planning/fleet-ship-assembly.js';
+import { readFreshGameShipAssemblyCatalog } from '../../registry/ships.js';
+import { createPlan } from '../../planning/index.js';
+function options(input) {
+    const bad = () => {
+        throw new InvalidActionInputError('options', input, 'authorization, shipId and amount only; direct authority, Profile, u16 keyIndex and shipId, and a bigint amount from 1n through 255n', 'Pass address-only ship assembly options. Certificates and other access routes are unsupported; use a direct Profile key and an existing own-faction StarbasePlayer.');
+    };
+    if (input === null || typeof input !== 'object' || Array.isArray(input))
+        bad();
+    const value = input;
+    if (Object.keys(value).length !== 3 ||
+        !Object.hasOwn(value, 'authorization') ||
+        !Object.hasOwn(value, 'shipId') ||
+        !Object.hasOwn(value, 'amount'))
+        bad();
+    const authorization = value.authorization;
+    if (authorization === null ||
+        typeof authorization !== 'object' ||
+        Array.isArray(authorization))
+        bad();
+    const a = authorization;
+    if (Object.keys(a).length !== 3 ||
+        !Object.hasOwn(a, 'profile') ||
+        !Object.hasOwn(a, 'authority') ||
+        !Object.hasOwn(a, 'keyIndex') ||
+        typeof a.profile !== 'string' ||
+        !isAddress(a.profile) ||
+        typeof a.authority !== 'string' ||
+        !isAddress(a.authority) ||
+        isOffCurveAddress(a.authority) ||
+        !Number.isInteger(a.keyIndex) ||
+        typeof a.keyIndex !== 'number' ||
+        a.keyIndex < 0 ||
+        a.keyIndex > 65535 ||
+        typeof value.shipId !== 'number' ||
+        !Number.isInteger(value.shipId) ||
+        value.shipId < 0 ||
+        value.shipId > 65535 ||
+        typeof value.amount !== 'bigint' ||
+        value.amount < 1n ||
+        value.amount > 255n)
+        bad();
+    return {
+        authorization: {
+            profile: a.profile,
+            authority: a.authority,
+            keyIndex: a.keyIndex,
+        },
+        shipId: value.shipId,
+        amount: value.amount,
+    };
+}
+/** Plans one singleton transfer of an exact ship configuration from StarbasePlayer entitlement to an owned Docked Fleet.
+ * Supports requirements-free XXS ships at own-faction CSS Starbases, current Fleet
+ * definition sequences and both Character and Game ship-assembly capacity limits.
+ * The explicit ship ID must be a u16 and the whole ship amount must be 1n through 255n. Uses a direct Profile
+ * AUTH or SAGE manageFleet key; a positive Profile rent shortfall additionally
+ * requires vault-funding permission. No token transfer or onboarding occurs.
+ * Final stats, research, refresh and outcomes remain chain-authoritative.
+ * Simulate before signing. The observed debit ceiling is rechecked before
+ * signing and is not an atomic on-chain spending cap. Two assembly Plans for the same Profile
+ * cannot compose because they share funds and assembly state.
+ * @example
+ * ```ts
+ * declare const ctx:SageContext, fleet:Address, profile:Address, authority:Address;
+ * const plan = await planAddShipToFleet(ctx,fleet,{authorization:{profile,authority,keyIndex:0},shipId:1,amount:1n});
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planAddShipToFleet(ctx, fleet, input) {
+    const captured = options(input);
+    if (typeof fleet !== 'string' || !isAddress(fleet))
+        throw new InvalidActionInputError('fleet', fleet, 'a Fleet address', 'Select an owned Fleet and replan ship assembly.');
+    const game = requireGameAddress(ctx);
+    const [fleetRaw] = await readContextRawAccounts(ctx, [fleet]);
+    if (!fleetRaw || fleetRaw.address !== fleet || fleetRaw.executable)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'The selected Fleet is missing, executable or has a contradictory address. Refresh a valid owned Fleet and replan.');
+    const decoded = fleetAccountDefinition.decode(fleetRaw);
+    if (decoded.state.kind !== 'docked')
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Ship assembly currently requires a Docked Fleet. Dock at an own-faction CSS Starbase and replan.');
+    const intent = {
+        address: fleet,
+        game,
+        profile: captured.authorization.profile,
+        authority: captured.authorization.authority,
+        keyIndex: captured.authorization.keyIndex,
+        system: decoded.state.system,
+        shipId: captured.shipId,
+        amount: captured.amount,
+    };
+    const resolved = await resolveFleetShipAssembly(intent);
+    const addresses = [
+        resolved.profile,
+        resolved.character,
+        resolved.profileFaction,
+        resolved.system,
+        resolved.starbasePlayer,
+        resolved.rent,
+        resolved.clock,
+    ];
+    const [{ rawAccount, catalog }, raw] = await Promise.all([
+        readFreshGameShipAssemblyCatalog(ctx),
+        readContextRawAccounts(ctx, addresses),
+    ]);
+    const accounts = new Map(addresses.map((address, index) => [address, raw[index]]));
+    accounts.set(fleet, fleetRaw);
+    accounts.set(game, rawAccount);
+    const { profileDebit, configHash } = await validateFleetShipAssembly(intent, resolved, accounts, undefined, catalog);
+    const summary = `Add ${intent.amount} of ship configuration ${intent.shipId} from StarbasePlayer ${resolved.starbasePlayer} to Fleet ${fleet}. Observed Profile rent debit: ${profileDebit} lamports from Profile ${intent.profile}. Execution rejects a higher observed debit before signing; this is not an atomic on-chain spending cap. Transaction fees are separate. Final stats, research, refresh and outcomes remain chain-authoritative; simulate before signing.`;
+    return createPlan({
+        kind: 'fleets.add-ship',
+        summary,
+        preconditions: [
+            {
+                kind: 'fleet-add-ship',
+                ...intent,
+                configHash,
+                maximumProfileDebit: profileDebit,
+                describes: 'Ship assembly retains canonical relationships, supported configuration, exact entitlement, capacity, direct-key permission and affordable rent within the observed Profile debit.',
+            },
+        ],
+        steps: [
+            {
+                describes: summary,
+                instruction: addShipToFleetInstruction(intent, resolved),
+                signers: [intent.authority],
+                semantics: [
+                    {
+                        kind: 'requires',
+                        resource: `profile:${intent.profile}`,
+                        fact: 'fleet-ship-assembly',
+                    },
+                    {
+                        kind: 'invalidates',
+                        resource: `profile:${intent.profile}`,
+                        fact: 'fleet-ship-assembly',
+                    },
+                ],
+            },
+        ],
+    });
+}
+//# sourceMappingURL=add-ship.js.map

package/dist/fleets/actions/add-ship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-ship.js","sourceRoot":"","sources":["../../../src/fleets/actions/add-ship.ts"],"names":[],"mappings":"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"}

package/dist/fleets/actions/create-fleet.d.ts

@@ -0,0 +1,36 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import type { PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
+import { type Plan } from '../../planning/index.js';
+/** Address-only options for creating an empty Fleet at an existing own-faction StarbasePlayer.
+ * @example
+ * ```ts
+ * declare const profile:Address, authority:Address, system:Address;
+ * const options:PlanCreateFleetOptions={authorization:{profile,authority,keyIndex:0},system,label:'Scout'};
+ * ```
+ */
+export interface PlanCreateFleetOptions {
+    readonly authorization: PlanAuthorization;
+    readonly system: Address;
+    readonly label: string;
+}
+/** Plans a standalone empty Docked Fleet, without signing or submitting.
+ * Derives all account addresses from the configured Game, Profile, exact label
+ * and System. Accepted label bytes are preserved. Requires an existing own-faction
+ * StarbasePlayer, a direct Profile AUTH or SAGE manageFleet key, and available
+ * stored Character capacity. The Profile pays only the Fleet target's rent
+ * shortfall; a non-AUTH key needs drainSolVault only for a positive debit.
+ * The observed debit is checked again before signing; it is not an atomic
+ * on-chain spending cap. Final rent and funding remain chain-authoritative.
+ * No implicit key grants, registration or funding occurs. Final modifier refresh
+ * and deployed eligibility remain chain-authoritative: simulate before signing.
+ * Creation Plans for the same Character cannot be combined.
+ * @example
+ * ```ts
+ * declare const ctx:SageContext, profile:Address, authority:Address, system:Address;
+ * const plan=await planCreateFleet(ctx,{authorization:{profile,authority,keyIndex:0},system,label:'Scout'});
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planCreateFleet(ctx: SageContext, input: PlanCreateFleetOptions): Promise<Plan>;
+//# sourceMappingURL=create-fleet.d.ts.map

package/dist/fleets/actions/create-fleet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-fleet.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/create-fleet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAU7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAyDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/fleets/actions/create-fleet.js

@@ -0,0 +1,138 @@
+import { isAddress, isOffCurveAddress } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { createFleetInstruction } from '../../internal/c4/fleet-creation.js';
+import { resolveFleetCreation, validateFleetCreation, validateFleetCreationLabel, } from '../../internal/planning/fleet-creation.js';
+import { createPlan } from '../../planning/index.js';
+import { readFreshGameForCharacterRegistration } from '../../registry/onboarding.js';
+function options(input) {
+    const bad = () => {
+        throw new InvalidActionInputError('options', input, 'authorization, system and label only; direct authority, Profile and u16 keyIndex', 'Pass address-only Fleet creation options. Certificates and other access routes are unsupported; use a direct Profile key and an existing own-faction StarbasePlayer.');
+    };
+    if (input === null || typeof input !== 'object' || Array.isArray(input))
+        bad();
+    const value = input;
+    if (Object.keys(value).length !== 3 ||
+        !Object.hasOwn(value, 'authorization') ||
+        !Object.hasOwn(value, 'system') ||
+        !Object.hasOwn(value, 'label'))
+        bad();
+    const authorization = value.authorization;
+    if (authorization === null ||
+        typeof authorization !== 'object' ||
+        Array.isArray(authorization))
+        bad();
+    const a = authorization;
+    if (Object.keys(a).length !== 3 ||
+        !Object.hasOwn(a, 'profile') ||
+        !Object.hasOwn(a, 'authority') ||
+        !Object.hasOwn(a, 'keyIndex') ||
+        typeof a.profile !== 'string' ||
+        !isAddress(a.profile) ||
+        typeof a.authority !== 'string' ||
+        !isAddress(a.authority) ||
+        isOffCurveAddress(a.authority) ||
+        !Number.isInteger(a.keyIndex) ||
+        typeof a.keyIndex !== 'number' ||
+        a.keyIndex < 0 ||
+        a.keyIndex > 65535 ||
+        typeof value.system !== 'string' ||
+        !isAddress(value.system))
+        bad();
+    validateFleetCreationLabel(value.label);
+    return {
+        authorization: {
+            profile: a.profile,
+            authority: a.authority,
+            keyIndex: a.keyIndex,
+        },
+        system: value.system,
+        label: value.label,
+    };
+}
+/** Plans a standalone empty Docked Fleet, without signing or submitting.
+ * Derives all account addresses from the configured Game, Profile, exact label
+ * and System. Accepted label bytes are preserved. Requires an existing own-faction
+ * StarbasePlayer, a direct Profile AUTH or SAGE manageFleet key, and available
+ * stored Character capacity. The Profile pays only the Fleet target's rent
+ * shortfall; a non-AUTH key needs drainSolVault only for a positive debit.
+ * The observed debit is checked again before signing; it is not an atomic
+ * on-chain spending cap. Final rent and funding remain chain-authoritative.
+ * No implicit key grants, registration or funding occurs. Final modifier refresh
+ * and deployed eligibility remain chain-authoritative: simulate before signing.
+ * Creation Plans for the same Character cannot be combined.
+ * @example
+ * ```ts
+ * declare const ctx:SageContext, profile:Address, authority:Address, system:Address;
+ * const plan=await planCreateFleet(ctx,{authorization:{profile,authority,keyIndex:0},system,label:'Scout'});
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planCreateFleet(ctx, input) {
+    const captured = options(input);
+    const game = requireGameAddress(ctx);
+    const intent = {
+        game,
+        profile: captured.authorization.profile,
+        authority: captured.authorization.authority,
+        keyIndex: captured.authorization.keyIndex,
+        system: captured.system,
+        label: captured.label,
+    };
+    const resolved = await resolveFleetCreation(intent);
+    const addresses = [
+        resolved.profile,
+        resolved.character,
+        resolved.profileFaction,
+        resolved.system,
+        resolved.starbasePlayer,
+        resolved.fleet,
+        resolved.rent,
+        resolved.clock,
+    ];
+    const [gameAccount, raw] = await Promise.all([
+        readFreshGameForCharacterRegistration(ctx),
+        readContextRawAccounts(ctx, addresses),
+    ]);
+    const { profileDebit } = await validateFleetCreation(intent, resolved, new Map(addresses.map((address, index) => [address, raw[index]])));
+    const summary = `Create empty Fleet ${intent.label} (${resolved.fleet}), Docked at Starbase ${intent.system}, consuming one Character Fleet slot. Observed Profile rent debit: ${profileDebit} lamports from Profile ${intent.profile}. Execution rejects a higher observed debit before signing; final rent and funding remain chain-authoritative. Transaction fees are separate. Final modifier refresh and deployed eligibility remain chain-authoritative: simulate before signing.`;
+    return createPlan({
+        kind: 'fleets.create-fleet',
+        summary,
+        preconditions: [
+            {
+                kind: 'game-account',
+                address: gameAccount.address,
+                describes: 'The configured Game remains valid; unrelated definitions may change.',
+            },
+            {
+                kind: 'fleet-create',
+                address: resolved.fleet,
+                ...intent,
+                maximumProfileDebit: profileDebit,
+                describes: 'Fleet creation retains canonical relationships, direct-key permission, available capacity and funding within the approved Profile debit.',
+            },
+        ],
+        steps: [
+            {
+                describes: summary,
+                instruction: createFleetInstruction(intent, resolved),
+                signers: [intent.authority],
+                semantics: [
+                    {
+                        kind: 'requires',
+                        resource: `character:${resolved.character}`,
+                        fact: 'fleet-creation-capacity',
+                    },
+                    {
+                        kind: 'invalidates',
+                        resource: `character:${resolved.character}`,
+                        fact: 'fleet-creation-capacity',
+                    },
+                ],
+            },
+        ],
+    });
+}
+//# sourceMappingURL=create-fleet.js.map

package/dist/fleets/actions/create-fleet.js.map

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

package/dist/fleets/actions/crew-transfer.d.ts

@@ -0,0 +1,41 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import type { PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
+import { type Plan } from '../../planning/index.js';
+/** Direct player authorization and the positive count for ordinary Docked Fleet crew transfer.
+ * @example
+ * ```ts
+ * declare const authorization: PlanAuthorization;
+ * const options: PlanFleetCrewTransferOptions = { authorization, count: 1 };
+ * ```
+ */
+export interface PlanFleetCrewTransferOptions {
+    readonly authorization: PlanAuthorization;
+    readonly count: number;
+}
+/** Loads an explicit positive u16 crew count from the canonical StarbasePlayer into a directly owned Docked Fleet.
+ * Requires a direct Profile AUTH key, current ship definitions, no Character roster,
+ * and an absent or exact-neutral Fleet binding. Rented crew are unsupported.
+ * Available Starbase crew exclude busy crew; capacity includes required crew and passengers.
+ * Planning never signs or submits. This transfer must execute alone.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, authorization: PlanAuthorization;
+ * const plan = await planLoadFleetCrew(ctx, fleet, { authorization, count: 1 });
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planLoadFleetCrew(ctx: SageContext, fleet: Address, options: PlanFleetCrewTransferOptions): Promise<Plan>;
+/** Unloads an explicit positive u16 crew count from a directly owned Docked Fleet into its canonical StarbasePlayer.
+ * Unloading every crew member is allowed while Docked; departure requires reloading required crew.
+ * Supports the same ordinary-crew and direct AUTH boundary as loading. Execute separately
+ * and refresh after confirmation before preparing another transfer or movement.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, authorization: PlanAuthorization;
+ * const plan = await planUnloadFleetCrew(ctx, fleet, { authorization, count: 1 });
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planUnloadFleetCrew(ctx: SageContext, fleet: Address, options: PlanFleetCrewTransferOptions): Promise<Plan>;
+//# sourceMappingURL=crew-transfer.d.ts.map

package/dist/fleets/actions/crew-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crew-transfer.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/crew-transfer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAK7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAChE;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAsGD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAEf;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/fleets/actions/crew-transfer.js

@@ -0,0 +1,114 @@
+import { isAddress, isOffCurveAddress } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { resolveFleetCrewTransfer } from '../../internal/planning/fleet-crew-transfer.js';
+import { crewTransferInstruction } from '../../internal/planning/fleet-crew-guard.js';
+import { createPlan } from '../../planning/index.js';
+function options(input) {
+    const bad = () => {
+        throw new InvalidActionInputError('options', input, 'authorization and count only; direct authority, Profile, u16 keyIndex and positive u16 count', 'Pass address-only Fleet crew transfer options. Certificates and other access routes are unsupported; use a direct Profile key and an existing canonical StarbasePlayer.');
+    };
+    if (input === null || typeof input !== 'object' || Array.isArray(input))
+        bad();
+    const value = input;
+    if (Object.keys(value).length !== 2 ||
+        !Object.hasOwn(value, 'authorization') ||
+        !Object.hasOwn(value, 'count'))
+        bad();
+    const authorization = value.authorization;
+    if (authorization === null ||
+        typeof authorization !== 'object' ||
+        Array.isArray(authorization))
+        bad();
+    const a = authorization;
+    if (Object.keys(a).length !== 3 ||
+        !Object.hasOwn(a, 'profile') ||
+        !Object.hasOwn(a, 'authority') ||
+        !Object.hasOwn(a, 'keyIndex') ||
+        typeof a.profile !== 'string' ||
+        !isAddress(a.profile) ||
+        typeof a.authority !== 'string' ||
+        !isAddress(a.authority) ||
+        isOffCurveAddress(a.authority) ||
+        !Number.isInteger(a.keyIndex) ||
+        typeof a.keyIndex !== 'number' ||
+        a.keyIndex < 0 ||
+        a.keyIndex > 65535 ||
+        typeof value.count !== 'number' ||
+        !Number.isInteger(value.count) ||
+        value.count < 1 ||
+        value.count > 65535)
+        bad();
+    return {
+        authorization: {
+            profile: a.profile,
+            authority: a.authority,
+            keyIndex: a.keyIndex,
+        },
+        count: value.count,
+    };
+}
+async function planTransfer(ctx, fleet, input, direction) {
+    const captured = options(input);
+    if (typeof fleet !== 'string' || !isAddress(fleet))
+        throw new InvalidActionInputError('fleet', fleet, 'a Fleet address', 'Select a directly owned Docked Fleet for crew transfer.');
+    const intent = {
+        address: fleet,
+        game: requireGameAddress(ctx),
+        ...captured.authorization,
+        count: captured.count,
+        direction,
+    };
+    const resolved = await resolveFleetCrewTransfer(ctx, intent);
+    const summary = `${direction === 'load' ? 'Load' : 'Unload'} ${intent.count} ordinary crew ${direction === 'load' ? 'from' : 'to'} StarbasePlayer ${resolved.starbasePlayer} ${direction === 'load' ? 'aboard' : 'from'} Fleet ${fleet}. Crew may be unloaded to zero while Docked; reload the required departure crew before undocking. Individual rosters, rented crew and restricted keys are unsupported. Execute this transfer alone; refresh Fleet and Starbase crew after confirmation before planning another action. Simulate before signing.`;
+    return createPlan({
+        kind: `fleets.${direction}-crew`,
+        summary,
+        preconditions: [
+            {
+                kind: 'fleet-crew-transfer',
+                ...intent,
+                ...resolved,
+                describes: 'Direct authority, canonical docking generation, ordinary crew state, current capacity and available source crew remain valid.',
+            },
+        ],
+        steps: [
+            {
+                instruction: crewTransferInstruction({ ...intent, ...resolved }),
+                describes: summary,
+                signers: [intent.authority],
+                semantics: [{ kind: 'exclusive', scope: 'transaction' }],
+            },
+        ],
+    });
+}
+/** Loads an explicit positive u16 crew count from the canonical StarbasePlayer into a directly owned Docked Fleet.
+ * Requires a direct Profile AUTH key, current ship definitions, no Character roster,
+ * and an absent or exact-neutral Fleet binding. Rented crew are unsupported.
+ * Available Starbase crew exclude busy crew; capacity includes required crew and passengers.
+ * Planning never signs or submits. This transfer must execute alone.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, authorization: PlanAuthorization;
+ * const plan = await planLoadFleetCrew(ctx, fleet, { authorization, count: 1 });
+ * console.log(plan.describe());
+ * ```
+ */
+export function planLoadFleetCrew(ctx, fleet, options) {
+    return planTransfer(ctx, fleet, options, 'load');
+}
+/** Unloads an explicit positive u16 crew count from a directly owned Docked Fleet into its canonical StarbasePlayer.
+ * Unloading every crew member is allowed while Docked; departure requires reloading required crew.
+ * Supports the same ordinary-crew and direct AUTH boundary as loading. Execute separately
+ * and refresh after confirmation before preparing another transfer or movement.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, authorization: PlanAuthorization;
+ * const plan = await planUnloadFleetCrew(ctx, fleet, { authorization, count: 1 });
+ * console.log(plan.describe());
+ * ```
+ */
+export function planUnloadFleetCrew(ctx, fleet, options) {
+    return planTransfer(ctx, fleet, options, 'unload');
+}
+//# sourceMappingURL=crew-transfer.js.map

package/dist/fleets/actions/crew-transfer.js.map

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

package/dist/fleets/actions/dock-bounds.d.ts

@@ -0,0 +1,38 @@
+import type { Address } from '../../client/contracts.js';
+import type { Plan } from '../../planning/index.js';
+import { type DockBoundsUnavailableReason } from '../../internal/planning/fleet-dock-funding-guard.js';
+/** Conservative gross Profile storage debit for qualified ordinary docking.
+ * Surplus and refunds are not credited; unavailable never implies zero cost.
+ * @example
+ * ```ts
+ * declare const bounds: FleetDockDebitBounds;
+ * if (bounds.status === 'available') console.log(bounds.maximumProfileDebit);
+ * ```
+ */
+export type FleetDockDebitBounds = {
+    readonly status: 'unavailable';
+    readonly reason: DockBoundsUnavailableReason | 'not-fleet-dock' | 'multiple-fleet-docks' | 'combined-plan';
+    toJSON(): unknown;
+} | {
+    readonly status: 'available';
+    readonly maximumProfileDebit: bigint;
+    readonly profile: Address;
+    readonly fleet: Address;
+    readonly starbasePlayer: Address;
+    readonly profileUnit: 'lamports';
+    readonly maximumFleetGrowthBytes: 40;
+    readonly transactionFees: 'excluded';
+    toJSON(): unknown;
+};
+/** Inspects the persisted docking ceiling without network I/O. Inspect individual
+ * Plans before combining distinct Fleets. Fresh pre-sign checks are not an atomic
+ * on-chain spending cap; state can change before landing.
+ * @example
+ * ```ts
+ * declare const plan: Plan;
+ * const bounds = getFleetDockDebitBounds(plan);
+ * if (bounds.status === 'available') console.log(bounds.maximumProfileDebit);
+ * ```
+ */
+export declare function getFleetDockDebitBounds(plan: Plan): FleetDockDebitBounds;
+//# sourceMappingURL=dock-bounds.d.ts.map

package/dist/fleets/actions/dock-bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dock-bounds.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/dock-bounds.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,qDAAqD,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EACX,2BAA2B,GAC3B,gBAAgB,GAChB,sBAAsB,GACtB,eAAe,CAAC;IACpB,MAAM,IAAI,OAAO,CAAC;CACnB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,uBAAuB,EAAE,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IACrC,MAAM,IAAI,OAAO,CAAC;CACnB,CAAC;AAEN;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,oBAAoB,CA6CxE"}

package/dist/fleets/actions/dock-bounds.js

@@ -0,0 +1,46 @@
+import { attachJsonSerialization } from '../../internal/json.js';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { isPlanInstance } from '../../planning/plan-instances.js';
+import { MAXIMUM_DOCK_GROWTH_BYTES, } from '../../internal/planning/fleet-dock-funding-guard.js';
+/** Inspects the persisted docking ceiling without network I/O. Inspect individual
+ * Plans before combining distinct Fleets. Fresh pre-sign checks are not an atomic
+ * on-chain spending cap; state can change before landing.
+ * @example
+ * ```ts
+ * declare const plan: Plan;
+ * const bounds = getFleetDockDebitBounds(plan);
+ * if (bounds.status === 'available') console.log(bounds.maximumProfileDebit);
+ * ```
+ */
+export function getFleetDockDebitBounds(plan) {
+    if (!isPlanInstance(plan))
+        throw new InvalidActionInputError('plan', plan, 'a genuine Plan from a planning factory', 'Create or hydrate the Plan through this SDK before reading its debit bounds.');
+    const guards = plan.preconditions.filter((g) => g.kind === 'fleet-dock-funding');
+    if (guards.length !== 1)
+        return Object.freeze(attachJsonSerialization({
+            status: 'unavailable',
+            reason: guards.length === 0 ? 'not-fleet-dock' : 'multiple-fleet-docks',
+        }));
+    if (plan.steps.length !== 1)
+        return Object.freeze(attachJsonSerialization({
+            status: 'unavailable',
+            reason: 'combined-plan',
+        }));
+    const guard = guards[0];
+    if (guard.status === 'unavailable')
+        return Object.freeze(attachJsonSerialization({
+            status: 'unavailable',
+            reason: guard.reason,
+        }));
+    return Object.freeze(attachJsonSerialization({
+        status: 'available',
+        maximumProfileDebit: guard.maximumProfileDebit,
+        profile: guard.profile,
+        fleet: guard.address,
+        starbasePlayer: guard.starbasePlayer,
+        profileUnit: 'lamports',
+        maximumFleetGrowthBytes: MAXIMUM_DOCK_GROWTH_BYTES,
+        transactionFees: 'excluded',
+    }));
+}
+//# sourceMappingURL=dock-bounds.js.map