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

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

@@ -0,0 +1,42 @@
+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 key with AUTH, or with the SAGE manage-crew
+ * permission scoped to SAGE or this Fleet; 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-key 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,EAAa,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAK7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpD;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAiFD;;;;;;;;;;;;GAYG;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,95 @@
+import { isAddress } 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 { buildPlannerPlan } from '../../planning/plan-construction.js';
+import { readDirectOptions } from '../../internal/planning/direct-options.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.');
+    };
+    const { authorization, value } = readDirectOptions(input, ['authorization', 'count'], bad);
+    if (typeof value.count !== 'number' ||
+        !Number.isInteger(value.count) ||
+        value.count < 1 ||
+        value.count > 65535)
+        bad();
+    return {
+        authorization,
+        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 buildPlannerPlan({
+        kind: `fleets.${direction}-crew`,
+        summary,
+        preconditions: [
+            {
+                kind: 'fleet-crew-transfer',
+                direction,
+                address: intent.address,
+                game: intent.game,
+                profile: intent.profile,
+                authority: intent.authority,
+                system: resolved.system,
+                starbasePlayer: resolved.starbasePlayer,
+                count: intent.count,
+                keyIndex: intent.keyIndex,
+                systemSequenceId: resolved.systemSequenceId,
+                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 key with AUTH, or with the SAGE manage-crew
+ * permission scoped to SAGE or this Fleet; 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-key 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/disband.d.ts

@@ -0,0 +1,42 @@
+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 authorization for disbanding an owned Docked Fleet.
+ * @example
+ * ```ts
+ * declare const profile: Address, authority: Address;
+ * const options: PlanFleetDisbandOptions = { authorization: { profile, authority, keyIndex: 0 } };
+ * ```
+ */
+export interface PlanFleetDisbandOptions {
+    readonly authorization: PlanAuthorization;
+}
+/** Plans disbanding an owned Docked Fleet, the game's only way to take a Fleet
+ * apart. Verified against the program's behaviour: the Fleet's ships return to
+ * the StarbasePlayer's hangar where it is Docked, its crew to that
+ * StarbasePlayer, and its fuel, ammo, cargo hold and components merge into the
+ * StarbasePlayer's cargo. The Character's Fleet slot is freed and the Fleet
+ * closes, refunding its rent to the Profile. To replace a composition, disband,
+ * confirm, then plan `planCreateFleet` and `planAddShipToFleet` from fresh
+ * state; disband and creation for the same Character cannot be combined.
+ *
+ * The Fleet must be a canonical owned player Fleet, not rented, Docked at a
+ * Starbase where the Character has a current StarbasePlayer of its faction,
+ * fully repaired, with no warp or scan cooldown running. The program also
+ * needs full AP and SP, which recover on timers and stay chain-authoritative.
+ * Uses a direct Profile AUTH key or a manageFleet key scoped to SAGE or the
+ * Fleet. New hangar entries and cargo lines grow the StarbasePlayer, and the
+ * program funds that growth from the Profile vault; that debit is bounded and
+ * rechecked before signing, but it is not an atomic on-chain spending cap.
+ * Any change to the Fleet after planning refuses the Plan. Simulate before
+ * signing, then read the StarbasePlayer back after confirmation.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, profile: Address, authority: Address;
+ * const plan = await planFleetDisband(ctx, fleet, { authorization: { profile, authority, keyIndex: 0 } });
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planFleetDisband(ctx: SageContext, fleet: Address, input: PlanFleetDisbandOptions): Promise<Plan>;
+//# sourceMappingURL=disband.d.ts.map

package/dist/fleets/actions/disband.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disband.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/disband.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAO7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAS1F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpD;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiFf"}

package/dist/fleets/actions/disband.js

@@ -0,0 +1,107 @@
+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 { disbandFleetInstruction } from '../../internal/c4/fleet-disband.js';
+import { accountStatePrecondition } from '../../internal/planning/account-state.js';
+import { readDirectOptions } from '../../internal/planning/direct-options.js';
+import { readDisbandStorageAction } from '../../internal/planning/disband-storage-actions.js';
+import { disbandSemantics } from '../../internal/planning/fleet-disband-guard.js';
+import { resolveFleetDisband, validateFleetDisband, } from '../../internal/planning/fleet-disband.js';
+import { planStorageFunding } from '../../internal/planning/storage-actions.js';
+import { buildPlannerPlan } from '../../planning/plan-construction.js';
+function options(input) {
+    const { authorization } = readDirectOptions(input, ['authorization'], () => {
+        throw new InvalidActionInputError('options', input, 'authorization only; direct authority, Profile and u16 keyIndex', 'Pass address-only disband options. Certificates are unsupported; use a direct Profile key.');
+    });
+    return { authorization };
+}
+/** Plans disbanding an owned Docked Fleet, the game's only way to take a Fleet
+ * apart. Verified against the program's behaviour: the Fleet's ships return to
+ * the StarbasePlayer's hangar where it is Docked, its crew to that
+ * StarbasePlayer, and its fuel, ammo, cargo hold and components merge into the
+ * StarbasePlayer's cargo. The Character's Fleet slot is freed and the Fleet
+ * closes, refunding its rent to the Profile. To replace a composition, disband,
+ * confirm, then plan `planCreateFleet` and `planAddShipToFleet` from fresh
+ * state; disband and creation for the same Character cannot be combined.
+ *
+ * The Fleet must be a canonical owned player Fleet, not rented, Docked at a
+ * Starbase where the Character has a current StarbasePlayer of its faction,
+ * fully repaired, with no warp or scan cooldown running. The program also
+ * needs full AP and SP, which recover on timers and stay chain-authoritative.
+ * Uses a direct Profile AUTH key or a manageFleet key scoped to SAGE or the
+ * Fleet. New hangar entries and cargo lines grow the StarbasePlayer, and the
+ * program funds that growth from the Profile vault; that debit is bounded and
+ * rechecked before signing, but it is not an atomic on-chain spending cap.
+ * Any change to the Fleet after planning refuses the Plan. Simulate before
+ * signing, then read the StarbasePlayer back after confirmation.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, profile: Address, authority: Address;
+ * const plan = await planFleetDisband(ctx, fleet, { authorization: { profile, authority, keyIndex: 0 } });
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planFleetDisband(ctx, fleet, input) {
+    const { authorization } = options(input);
+    const game = requireGameAddress(ctx);
+    const [fleetRaw] = await readContextRawAccounts(ctx, [fleet]);
+    if (!fleetRaw || fleetRaw.executable)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'The selected Fleet is missing or executable. Refresh a valid owned Fleet and replan the disband.', { address: fleet });
+    const docked = fleetAccountDefinition.decode(fleetRaw).state;
+    if (docked.kind !== 'docked')
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Only a Docked Fleet can disband. Dock it at a Starbase where the Character has a current StarbasePlayer and replan.', { address: fleet });
+    const intent = {
+        game,
+        profile: authorization.profile,
+        authority: authorization.authority,
+        keyIndex: authorization.keyIndex,
+        fleet,
+        system: docked.system,
+    };
+    const resolved = await resolveFleetDisband(intent);
+    const addresses = [
+        resolved.profile,
+        resolved.character,
+        resolved.profileFaction,
+        resolved.system,
+        resolved.starbasePlayer,
+        resolved.rent,
+        resolved.clock,
+    ];
+    const raw = await readContextRawAccounts(ctx, addresses);
+    const accounts = new Map(addresses.map((address, index) => [address, raw[index]]));
+    accounts.set(fleet, fleetRaw);
+    const { fleet: data } = await validateFleetDisband(intent, resolved, accounts);
+    const instruction = disbandFleetInstruction({
+        ...intent,
+        character: resolved.character,
+        starbasePlayer: resolved.starbasePlayer,
+    });
+    const storage = planStorageFunding({
+        action: readDisbandStorageAction(instruction, accounts),
+        accounts,
+        label: 'Fleet disband',
+    });
+    const ships = data.fleetShips
+        .map(({ shipId, quantity }) => `${String(quantity)} of configuration ${String(shipId)}`)
+        .join(', ');
+    const summary = `Disband Fleet ${data.name} (${fleet}) at StarbasePlayer ${resolved.starbasePlayer}: ${ships || 'no ships'} return to its hangar, ${String(data.crewCount)} crew return to it, and the Fleet's fuel, ammo, cargo hold and components merge into its cargo. The Character's Fleet slot is freed, and the Fleet closes, refunding its ${String(fleetRaw.lamports)}-lamport balance to Profile ${intent.profile}. ${storage.disclosure} The program also needs full AP and SP when the instruction runs. Transaction fees are separate. Simulate before signing; the chain stays authoritative.`;
+    return buildPlannerPlan({
+        kind: 'fleets.disband',
+        summary,
+        preconditions: [
+            await accountStatePrecondition(fleetRaw, `Fleet ${data.name} keeps its ships, crew, cargo, Docked state, repair and cooldowns as planned.`),
+            storage.guard,
+        ],
+        steps: [
+            {
+                describes: summary,
+                instruction,
+                signers: [intent.authority],
+                semantics: disbandSemantics(instruction),
+            },
+        ],
+    });
+}
+//# sourceMappingURL=disband.js.map

package/dist/fleets/actions/disband.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disband.js","sourceRoot":"","sources":["../../../src/fleets/actions/disband.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

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

@@ -0,0 +1 @@
+{"version":3,"file":"dock-bounds.js","sourceRoot":"","sources":["../../../src/fleets/actions/dock-bounds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EACL,yBAAyB,GAE1B,MAAM,qDAAqD,CAAC;AAgC7D;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAU;IAChD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QACvB,MAAM,IAAI,uBAAuB,CAC/B,MAAM,EACN,IAAI,EACJ,wCAAwC,EACxC,8EAA8E,CAC/E,CAAC;IACJ,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CACvC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QACrB,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,sBAAsB;SAC/D,CAAC,CACZ,CAAC;IACJ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,eAAe;SACf,CAAC,CACZ,CAAC;IACJ,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACzB,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa;QAChC,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,KAAK,CAAC,MAAM;SACZ,CAAC,CACZ,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;QACtB,MAAM,EAAE,WAAW;QACnB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,UAAU;QACvB,uBAAuB,EAAE,yBAAyB;QAClD,eAAe,EAAE,UAAU;KACnB,CAAC,CACZ,CAAC;AACJ,CAAC"}

package/dist/fleets/actions/index.d.ts

@@ -1,7 +1,7 @@
 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';
+import type { Plan } from '../../planning/index.js';
 import type { FleetSnapshot } from '../index.js';
 export type { PlanAuthorization };
 /** Inputs for planning one docked-to-idle Fleet transition.
@@ -27,20 +27,39 @@ export interface PlanFleetDockOptions {
     readonly authorization: PlanAuthorization;
 }
 /** Inputs for planning one explicit coordinate-destination Fleet movement.
+ *
+ * Choose exactly one representation. `destination` accepts display numbers and
+ * applies the generated I8F56 codec's rounding. `destinationRaw` preserves an
+ * exact signed-I8F56 value, such as a Star System's `coordinatesRaw`.
  *
  * @example
  * ```ts
  * declare const authorization: PlanAuthorization;
- * const options: PlanFleetCoordinateMovementOptions = {
+ * declare const destinationSystem: {
+ *   readonly coordinatesRaw: { readonly x: bigint; readonly y: bigint };
+ * };
+ * const displayOptions: PlanFleetCoordinateMovementOptions = {
  *   authorization,
  *   destination: { x: 12, y: -7 },
  * };
+ * const exactOptions: PlanFleetCoordinateMovementOptions = {
+ *   authorization,
+ *   destinationRaw: destinationSystem.coordinatesRaw,
+ * };
  * ```
  */
-export interface PlanFleetCoordinateMovementOptions {
+export type PlanFleetCoordinateMovementOptions = {
     readonly authorization: PlanAuthorization;
     readonly destination: FleetSnapshot['location'];
-}
+    readonly destinationRaw?: never;
+} | {
+    readonly authorization: PlanAuthorization;
+    readonly destination?: never;
+    readonly destinationRaw: {
+        readonly x: bigint;
+        readonly y: bigint;
+    };
+};
 /** Inputs for planning one explicit connected-system Fleet warp.
  *
  * @example
@@ -57,19 +76,19 @@ export interface PlanFleetWarpLaneOptions {
     readonly authorization: PlanAuthorization;
     readonly destinationSystem: Address;
 }
-/** Address-only input for settling one Fleet movement arrival.
+/** Explicit authority for a completed Fleet journey, separate from the fee payer.
  *
- * The funder is the sole required signer. Reusing the later assembly fee payer
- * is convenient, but the planner does not require the two addresses to match.
+ * Requires direct Profile authorization for current Game subwarp.
+ * Certificates are not supported for arrival.
  *
  * @example
  * ```ts
- * declare const funder: Address;
- * const options: PlanFleetSettleArrivalOptions = { funder };
+ * declare const authorization: PlanAuthorization;
+ * const options: PlanFleetSettleArrivalOptions = { authorization };
  * ```
  */
 export interface PlanFleetSettleArrivalOptions {
-    readonly funder: Address;
+    readonly authorization: PlanAuthorization;
 }
 /** Inputs for stopping one Fleet subwarp early.
  *
@@ -86,7 +105,17 @@ export interface PlanFleetStopSubwarpOptions {
  *
  * The planner resolves the source Star System from the Fleet's action coordinate,
  * proves connectivity from that System's decoded connections, and resolves all
- * generated instruction accounts internally.
+ * generated instruction accounts internally. CurrencyCache shared accounting may
+ * change; canonical identity/layout and the existing toll-input guards remain
+ * checked before signing. The Regions containing the destination keep their
+ * owner, safety status and risk zone, which decide destination access; other
+ * Regions may change. Refresh and recreate older Plans to use these guards.
+ *
+ * Connectivity does not guarantee eligibility. The program remains authoritative
+ * for faction-relationship and destination-risk checks and any ATLAS toll.
+ * Tested current PTR routes succeed with empty Fuel tanks. This planner does
+ * not estimate lane costs or treat enabled cross-faction economics as blanket
+ * permission.
  *
  * @example
  * ```ts
@@ -101,7 +130,13 @@ export interface PlanFleetStopSubwarpOptions {
  * ```
  */
 export declare function planFleetWarpLane(ctx: SageContext, fleet: FleetSnapshot, options: PlanFleetWarpLaneOptions): Promise<Plan>;
-/** Plans one explicit Fleet subwarp to a coordinate without movement estimates.
+/** Plans one explicit Fleet subwarp to a display or exact raw coordinate without movement estimates.
+ *
+ * A coordinate outside every Region is deep space and carries no Region hint.
+ * A player Fleet may cross deep space, but stopping there needs the Character's
+ * High Risk zone access; NPC Fleets need none. The Plan guards only the
+ * Regions whose bounding boxes overlap the straight path's, plus the Region
+ * count, so a Starbase capture or upgrade elsewhere leaves it valid.
  *
  * @example
  * ```ts
@@ -110,12 +145,18 @@ export declare function planFleetWarpLane(ctx: SageContext, fleet: FleetSnapshot
  * declare const authorization: PlanAuthorization;
  * const plan = await planFleetSubwarp(ctx, fleet, {
  *   authorization,
- *   destination: { x: 12, y: -7 },
+ *   destinationRaw: { x: 12n << 56n, y: -(7n << 56n) },
  * });
  * ```
  */
 export declare function planFleetSubwarp(ctx: SageContext, fleet: FleetSnapshot, options: PlanFleetCoordinateMovementOptions): Promise<Plan>;
-/** Plans one explicit Fleet coordinate warp without movement estimates.
+/** Plans one explicit Fleet coordinate warp to a display or exact raw coordinate without movement estimates.
+ *
+ * A coordinate outside every Region is deep space and carries no Region hint.
+ * A player Fleet may cross deep space, but stopping there needs the Character's
+ * High Risk zone access; NPC Fleets need none. The Plan guards only the
+ * Regions whose bounding boxes overlap the straight path's, plus the Region
+ * count, so a Starbase capture or upgrade elsewhere leaves it valid.
  *
  * @example
  * ```ts
@@ -124,25 +165,33 @@ export declare function planFleetSubwarp(ctx: SageContext, fleet: FleetSnapshot,
  * declare const authorization: PlanAuthorization;
  * const plan = await planFleetWarpToCoordinate(ctx, fleet, {
  *   authorization,
- *   destination: { x: 12, y: -7 },
+ *   destinationRaw: { x: 12n << 56n, y: -(7n << 56n) },
  * });
  * ```
  */
 export declare function planFleetWarpToCoordinate(ctx: SageContext, fleet: FleetSnapshot, options: PlanFleetCoordinateMovementOptions): Promise<Plan>;
-/** Plans settlement of one Fleet warp or subwarp arrival.
+/** Plans settlement after chain time confirms the scheduled Fleet journey duration has elapsed.
+ *
+ * Game version 2 subwarp requires explicit direct Profile authorization and
+ * existing reconciled Career XP accounts. Warp settlement is unsupported.
+ * Journeys whose scheduled duration has not elapsed and Idle Fleets fail locally.
+ * Planning and execution read fresh accounts; no host clock is used.
  *
- * Settlement is distinct from stopping subwarp early: the program completes an
- * elapsed movement, while an in-transit call is a measured safe no-op. Subwarp
- * settlement charges the fuel recorded when movement started; warp fuel was
- * already charged up front. Settlement does not clear the independent warp
- * cooldown, so an arrived Fleet can be idle but still unable to warp again.
+ * Settlement does not guarantee reaching the destination: insufficient Fuel can
+ * leave the Fleet Idle short of it. Low Fuel produces a planning-time warning,
+ * not a rejection. Inspect refreshed state and location after confirmation.
+ * Subwarp settles fuel and XP and may refund released storage rent to the
+ * Profile. Warp cooldown remains independent. Fresh checks cannot prevent a
+ * concurrent transaction from starting another journey before execution; the
+ * authorized instruction could stop that new journey. Intentional early
+ * stopping remains the separate {@link planFleetStopSubwarp} operation.
  *
  * @example
  * ```ts
  * declare const ctx: SageContext;
  * declare const fleet: FleetSnapshot;
- * declare const funder: Address;
- * const plan = await planFleetSettleArrival(ctx, fleet, { funder });
+ * declare const authorization: PlanAuthorization;
+ * const plan = await planFleetSettleArrival(ctx, fleet, { authorization });
  * console.log(plan.describe());
  * ```
  */
@@ -183,10 +232,18 @@ export declare function planFleetStopSubwarp(ctx: SageContext, fleet: FleetSnaps
 export declare function planFleetUndock(ctx: SageContext, fleet: FleetSnapshot, options: PlanFleetUndockOptions): Promise<Plan>;
 /** Plans one explicit Fleet dock without signing, simulation, or write RPC.
  *
- * The planner accepts a loaded idle or refreshable movement Fleet snapshot,
+ * The planner accepts a loaded idle or refreshable warp Fleet snapshot,
  * resolves the only canonical Character, Star System at its action coordinate,
  * and Starbase Player internally, and returns one inspectable idle-to-docked
- * Plan.
+ * Plan. A subwarp snapshot is refused: the dock step refreshes the Fleet
+ * without its Character and cannot settle a subwarp journey, so settle the
+ * arrival or stop the subwarp first.
+ *
+ * Docking is admitted when the Starbase Player belongs to the Starbase's
+ * controlling faction, whatever the territory and economics settings. A
+ * foreign Starbase Player is refused while territory access is off; foreign
+ * docking under territory access and dynamic-faction Starbases are refused as
+ * unsupported.
  *
  * @example
  * ```ts
@@ -199,4 +256,11 @@ export declare function planFleetUndock(ctx: SageContext, fleet: FleetSnapshot,
  */
 export declare function planFleetDock(ctx: SageContext, fleet: FleetSnapshot, options: PlanFleetDockOptions): Promise<Plan>;
 export { planDepositShipsToGame, type PlanDepositShipsToGameOptions, } from './ship-import.js';
+export { planCreateFleet, type PlanCreateFleetOptions, } from './create-fleet.js';
+export { planAddShipToFleet, type PlanAddShipToFleetOptions, } from './add-ship.js';
+export { planFleetDisband, type PlanFleetDisbandOptions } from './disband.js';
+export { planSyncFleetWithGame } from './sync.js';
+export { planFleetStartRespawn, planFleetCompleteRespawn, type PlanFleetRespawnOptions, } from './respawn.js';
+export { planLoadFleetCrew, planUnloadFleetCrew, type PlanFleetCrewTransferOptions, } from './crew-transfer.js';
+export { getFleetDockDebitBounds, type FleetDockDebitBounds, } from './dock-bounds.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/fleets/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAqCzE,OAAO,EASL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAEL,KAAK,IAAI,EAGV,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAqBlC;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AA++BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAgEf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Gf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA4Jf;AAED,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/index.ts"],"names":[],"mappings":"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"}