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

package/dist/factions/index.js

@@ -2,17 +2,9 @@ import { AccountDecodeError, entityRef, } from '../client/index.js';
 import { deriveFactionAccountAddress, deriveFactionConfigAddress, deriveFactionEconomicsConfigAddress, deriveFactionOwnershipAddress, deriveFactionRelationTrackerAddress, deriveFactionStandingAddress, deriveFactionStarSystemAddress, deriveFactionTreasuryAddress, deriveKingSystemTrackerAddress, deriveRegionTrackerAddress, discoverFactionOwnershipAccounts, factionAccountDefinition, factionConfigAccountDefinition, factionEconomicsConfigAccountDefinition, factionOwnershipAccountDefinition, factionRelationTrackerAccountDefinition, factionStandingAccountDefinition, factionTreasuryAccountDefinition, kingSystemTrackerAccountDefinition, regionTrackerAccountDefinition, } from '../internal/c4/factions.js';
 import { requireGameAddress } from '../internal/game-context.js';
 import { attachJsonSerialization } from '../internal/json.js';
-import { attachReadMeta, readMeta } from '../internal/read-meta.js';
+import { attachReadMeta, envelopeMeta, readMeta, } from '../internal/read-meta.js';
 import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
 const SNAPSHOTS = new WeakMap();
-function metadata(envelope, strategy = 'derived') {
-    return {
-        commitment: envelope.commitment,
-        slot: envelope.slot,
-        source: envelope.source,
-        strategy,
-    };
-}
 function assertGame(context, envelope) {
     const game = requireGameAddress(context);
     if (envelope.data.game !== game) {
@@ -28,7 +20,7 @@ function cached(envelope, create) {
     return snapshot;
 }
 function immutable(value, envelope, strategy = 'derived') {
-    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization(value), metadata(envelope, strategy)));
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization(value), envelopeMeta(envelope, strategy)));
 }
 function factionSnapshot(context, envelope) {
     assertGame(context, envelope);
@@ -165,7 +157,7 @@ export async function getFaction(context, factionId, options) {
     const address = await deriveFactionAccountAddress(game, factionId);
     const envelope = await context.data.read(factionAccountDefinition, address, options);
     if (envelope.data.factionId !== factionId) {
-        throw new AccountDecodeError('faction', address, new RangeError('Faction id contradicted its PDA seeds.'));
+        throw new AccountDecodeError('faction', address, new RangeError('Faction id contradicted its PDA seeds.'), `Faction ${address} stores faction id ${String(envelope.data.factionId)}, not derived faction id ${String(factionId)}. Verify the configured cluster and pinned PDA recipe before retrying.`);
     }
     return factionSnapshot(context, envelope);
 }
@@ -222,7 +214,7 @@ export async function maybeGetFactionStanding(context, profile, factionId, optio
         return undefined;
     if (envelope.data.profile !== profile ||
         envelope.data.factionId !== factionId) {
-        throw new AccountDecodeError('factionStanding', address, new RangeError('FactionStanding identity contradicted its PDA seeds.'));
+        throw new AccountDecodeError('factionStanding', address, new RangeError('FactionStanding identity contradicted its PDA seeds.'), `Faction Standing ${address} does not match Profile ${profile} and faction id ${String(factionId)}. Verify the Profile address, faction id, configured cluster, and pinned PDA recipe before retrying.`);
     }
     return standingSnapshot(context, envelope);
 }
@@ -238,7 +230,7 @@ export async function getFactionTreasury(context, factionId, options) {
     const address = await deriveFactionTreasuryAddress(game, factionId);
     const envelope = await context.data.read(factionTreasuryAccountDefinition, address, options);
     if (envelope.data.factionId !== factionId) {
-        throw new AccountDecodeError('factionTreasury', address, new RangeError('FactionTreasury faction id contradicted its PDA seeds.'));
+        throw new AccountDecodeError('factionTreasury', address, new RangeError('FactionTreasury faction id contradicted its PDA seeds.'), `Faction Treasury ${address} stores faction id ${String(envelope.data.factionId)}, not derived faction id ${String(factionId)}. Verify the configured cluster and pinned PDA recipe before retrying.`);
     }
     return treasurySnapshot(context, envelope);
 }
@@ -252,9 +244,15 @@ export async function getFactionTreasury(context, factionId, options) {
  */
 export async function maybeGetFactionOwnership(context, asset, options) {
     const game = requireGameAddress(context);
-    const address = asset.kind === 'region'
-        ? await deriveFactionOwnershipAddress(game, asset.kind, asset.regionId)
-        : await deriveFactionOwnershipAddress(game, asset.kind, asset.address);
+    const [address, requested] = asset.kind === 'region'
+        ? [
+            await deriveFactionOwnershipAddress(game, asset.kind, asset.regionId),
+            `region asset id ${String(asset.regionId)}`,
+        ]
+        : [
+            await deriveFactionOwnershipAddress(game, asset.kind, asset.address),
+            `${asset.kind} asset ${asset.address}`,
+        ];
     const [envelope] = await context.data.readMany(factionOwnershipAccountDefinition, [address], options);
     if (envelope === undefined)
         return undefined;
@@ -269,7 +267,7 @@ export async function maybeGetFactionOwnership(context, asset, options) {
                     envelope.data.asset.kind === 'fleet' &&
                     envelope.data.asset.fleet === asset.address);
     if (!identityMatches) {
-        throw new AccountDecodeError('factionOwnership', address, new RangeError('FactionOwnership asset contradicted its PDA seeds.'));
+        throw new AccountDecodeError('factionOwnership', address, new RangeError('FactionOwnership asset contradicted its PDA seeds.'), `Faction Ownership ${address} does not reference the requested ${requested}. Verify the requested asset, configured cluster, and pinned PDA recipe before retrying.`);
     }
     return ownershipSnapshot(context, envelope, 'derived');
 }
@@ -331,5 +329,5 @@ export async function getTerritoryRegions(context, options) {
         }))),
     }, envelope);
 }
-export { getProfileFactionForProfile, maybeGetProfileFactionForProfile, } from './profile-faction.js';
+export { getFactionForProfile, maybeGetFactionForProfile, } from './profile-faction.js';
 //# sourceMappingURL=index.js.map

package/dist/factions/index.js.map

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

package/dist/factions/profile-faction.d.ts

@@ -23,24 +23,36 @@ export interface ProfileFactionSnapshot {
     readonly version: number;
     toJSON(): unknown;
 }
-/** Derives and reads a Profile's existing faction enrollment without loading Game.
- * @example
+/** Derives and reads a Profile's faction enrollment independently of Game.
+ *
+ * Returns the ProfileFaction enrollment snapshot (unaligned, MUD, ONI, or Ustur).
+ * This does not read a Game or its dynamic FactionAccount; use `getFaction`
+ * with a Game-scoped faction id for that state. Missing enrollment throws
+ * `ACCOUNT_NOT_FOUND`; use `maybeGetFactionForProfile` when absence is expected.
+ *
+ * @example Illustrative: supply a context and an existing Profile address.
  * ```ts
  * declare const ctx: SageContext;
  * declare const profile: Address;
- * const enrollment = await getProfileFactionForProfile(ctx, profile);
+ * const enrollment = await getFactionForProfile(ctx, profile);
  * console.log(enrollment.faction);
  * ```
  */
-export declare function getProfileFactionForProfile(ctx: SageContext, profile: Address, options?: ReadOptions): Promise<ProfileFactionSnapshot>;
-/** Reads optional Profile enrollment; absence is undefined, malformed accounts still fail.
- * @example
+export declare function getFactionForProfile(ctx: SageContext, profile: Address, options?: ReadOptions): Promise<ProfileFactionSnapshot>;
+/** Reads optional Profile faction enrollment independently of Game.
+ *
+ * Returns the ProfileFaction enrollment snapshot, or `undefined` when the
+ * Profile is not enrolled. Malformed accounts still fail validation. This does
+ * not load Game or resolve its dynamic FactionAccount; use `getFaction` with a
+ * Game-scoped faction id for that state.
+ *
+ * @example Illustrative: supply a context and an existing Profile address.
  * ```ts
  * declare const ctx: SageContext;
  * declare const profile: Address;
- * const enrollment = await maybeGetProfileFactionForProfile(ctx, profile);
+ * const enrollment = await maybeGetFactionForProfile(ctx, profile);
  * console.log(enrollment?.faction ?? 'not enrolled');
  * ```
  */
-export declare function maybeGetProfileFactionForProfile(ctx: SageContext, profile: Address, options?: ReadOptions): Promise<ProfileFactionSnapshot | undefined>;
+export declare function maybeGetFactionForProfile(ctx: SageContext, profile: Address, options?: ReadOptions): Promise<ProfileFactionSnapshot | undefined>;
 //# sourceMappingURL=profile-faction.d.ts.map

package/dist/factions/profile-faction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profile-faction.d.ts","sourceRoot":"","sources":["../../src/factions/profile-faction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,WAAW,EAEZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAW9D;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,MAAM,IAAI,OAAO,CAAC;CACnB;AAiCD;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAMjC;AACD;;;;;;;;GAQG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAQ7C"}
+{"version":3,"file":"profile-faction.d.ts","sourceRoot":"","sources":["../../src/factions/profile-faction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,WAAW,EAEZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAW9D;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,MAAM,IAAI,OAAO,CAAC;CACnB;AAiCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAMjC;AACD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAQ7C"}

package/dist/factions/profile-faction.js

@@ -21,29 +21,41 @@ function snapshot(envelope, profile) {
         strategy: 'derived',
     }));
 }
-/** Derives and reads a Profile's existing faction enrollment without loading Game.
- * @example
+/** Derives and reads a Profile's faction enrollment independently of Game.
+ *
+ * Returns the ProfileFaction enrollment snapshot (unaligned, MUD, ONI, or Ustur).
+ * This does not read a Game or its dynamic FactionAccount; use `getFaction`
+ * with a Game-scoped faction id for that state. Missing enrollment throws
+ * `ACCOUNT_NOT_FOUND`; use `maybeGetFactionForProfile` when absence is expected.
+ *
+ * @example Illustrative: supply a context and an existing Profile address.
  * ```ts
  * declare const ctx: SageContext;
  * declare const profile: Address;
- * const enrollment = await getProfileFactionForProfile(ctx, profile);
+ * const enrollment = await getFactionForProfile(ctx, profile);
  * console.log(enrollment.faction);
  * ```
  */
-export async function getProfileFactionForProfile(ctx, profile, options) {
+export async function getFactionForProfile(ctx, profile, options) {
     const address = await deriveProfileFactionAddress(profile);
     return snapshot(await ctx.data.read(profileFactionAccountDefinition, address, options), profile);
 }
-/** Reads optional Profile enrollment; absence is undefined, malformed accounts still fail.
- * @example
+/** Reads optional Profile faction enrollment independently of Game.
+ *
+ * Returns the ProfileFaction enrollment snapshot, or `undefined` when the
+ * Profile is not enrolled. Malformed accounts still fail validation. This does
+ * not load Game or resolve its dynamic FactionAccount; use `getFaction` with a
+ * Game-scoped faction id for that state.
+ *
+ * @example Illustrative: supply a context and an existing Profile address.
  * ```ts
  * declare const ctx: SageContext;
  * declare const profile: Address;
- * const enrollment = await maybeGetProfileFactionForProfile(ctx, profile);
+ * const enrollment = await maybeGetFactionForProfile(ctx, profile);
  * console.log(enrollment?.faction ?? 'not enrolled');
  * ```
  */
-export async function maybeGetProfileFactionForProfile(ctx, profile, options) {
+export async function maybeGetFactionForProfile(ctx, profile, options) {
     const address = await deriveProfileFactionAddress(profile);
     const [value] = await ctx.data.readMany(profileFactionAccountDefinition, [address], options);
     return value === undefined ? undefined : snapshot(value, profile);

package/dist/factions/profile-faction.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile-faction.js","sourceRoot":"","sources":["../../src/factions/profile-faction.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAkB,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAEhC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AA0B1E,SAAS,QAAQ,CACf,QAAqD,EACrD,OAAgB;IAEhB,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO;QACnC,MAAM,IAAI,kBAAkB,CAC1B,gBAAgB,EAChB,QAAQ,CAAC,OAAO,EAChB,IAAI,UAAU,CACZ,2DAA2D,CAC5D,EACD,sBAAsB,QAAQ,CAAC,OAAO,yFAAyF,CAChI,CAAC;IACJ,OAAO,sBAAsB,CAC3B,cAAc,CACZ,uBAAuB,CAAC;QACtB,IAAI,EAAE,gBAAyB;QAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC;QACtC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO;QAC9B,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS;QAClC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO;KAC/B,CAAC,EACF;QACE,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,SAAS;KACpB,CACF,CACF,CAAC;AACJ,CAAC;AACD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAgB,EAChB,OAAgB,EAChB,OAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC3D,OAAO,QAAQ,CACb,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,+BAA+B,EAAE,OAAO,EAAE,OAAO,CAAC,EACtE,OAAO,CACR,CAAC;AACJ,CAAC;AACD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,GAAgB,EAChB,OAAgB,EAChB,OAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CACrC,+BAA+B,EAC/B,CAAC,OAAO,CAAC,EACT,OAAO,CACR,CAAC;IACF,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"profile-faction.js","sourceRoot":"","sources":["../../src/factions/profile-faction.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAkB,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAEhC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AA0B1E,SAAS,QAAQ,CACf,QAAqD,EACrD,OAAgB;IAEhB,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO;QACnC,MAAM,IAAI,kBAAkB,CAC1B,gBAAgB,EAChB,QAAQ,CAAC,OAAO,EAChB,IAAI,UAAU,CACZ,2DAA2D,CAC5D,EACD,sBAAsB,QAAQ,CAAC,OAAO,yFAAyF,CAChI,CAAC;IACJ,OAAO,sBAAsB,CAC3B,cAAc,CACZ,uBAAuB,CAAC;QACtB,IAAI,EAAE,gBAAyB;QAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC;QACtC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO;QAC9B,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS;QAClC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO;KAC/B,CAAC,EACF;QACE,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,SAAS;KACpB,CACF,CACF,CAAC;AACJ,CAAC;AACD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAgB,EAChB,OAAgB,EAChB,OAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC3D,OAAO,QAAQ,CACb,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,+BAA+B,EAAE,OAAO,EAAE,OAAO,CAAC,EACtE,OAAO,CACR,CAAC;AACJ,CAAC;AACD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAgB,EAChB,OAAgB,EAChB,OAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CACrC,+BAA+B,EAC/B,CAAC,OAAO,CAAC,EACT,OAAO,CACR,CAAC;IACF,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,47 @@
+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.
+ * Follows the program's assembly rules for ships of any size: each ship must be
+ * within the Character's maximum ship size and its research tags must all be
+ * held; the resulting Fleet's points (XXS 1, XS 4, Small 9, Medium 16, Large 25,
+ * Capital 36, Commander 49, Titan 128) must fit both the Character's Fleet size
+ * and the Game limit, with at most one Titan and two Commanders and Titans
+ * together. Escrowed hulls of any configuration of the same ship count, as the
+ * program re-tags them. Any Starbase with a current StarbasePlayer of the
+ * Fleet's faction works. Configurations that need ship components, and Fleets
+ * built under older ship definitions, are not planned yet; sync those with
+ * `planSyncFleetWithGame` first.
+ * The explicit ship ID must be a u16 and the whole ship amount must be 1n through 255n. Uses a direct Profile
+ * AUTH key or a manageFleet key scoped to SAGE or the Fleet; a positive Profile
+ * rent shortfall additionally requires vault-funding permission. No token
+ * transfer or onboarding occurs.
+ * A rented Fleet is refused, as is a Fleet whose HP plus pending repair cannot
+ * reach its maximum; the program also needs full AP and SP, which recover on
+ * timers and stay chain-authoritative.
+ * 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,EAAa,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAS1F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpD;;;;;;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;AAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;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,132 @@
+import { isAddress } 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 { 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, 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 are unsupported; use a direct Profile key and the StarbasePlayer where the Fleet is Docked.');
+    };
+    const { authorization, value } = readDirectOptions(input, ['authorization', 'shipId', 'amount'], bad);
+    if (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,
+        shipId: value.shipId,
+        amount: value.amount,
+    };
+}
+/** Plans one singleton transfer of an exact ship configuration from StarbasePlayer entitlement to an owned Docked Fleet.
+ * Follows the program's assembly rules for ships of any size: each ship must be
+ * within the Character's maximum ship size and its research tags must all be
+ * held; the resulting Fleet's points (XXS 1, XS 4, Small 9, Medium 16, Large 25,
+ * Capital 36, Commander 49, Titan 128) must fit both the Character's Fleet size
+ * and the Game limit, with at most one Titan and two Commanders and Titans
+ * together. Escrowed hulls of any configuration of the same ship count, as the
+ * program re-tags them. Any Starbase with a current StarbasePlayer of the
+ * Fleet's faction works. Configurations that need ship components, and Fleets
+ * built under older ship definitions, are not planned yet; sync those with
+ * `planSyncFleetWithGame` first.
+ * The explicit ship ID must be a u16 and the whole ship amount must be 1n through 255n. Uses a direct Profile
+ * AUTH key or a manageFleet key scoped to SAGE or the Fleet; a positive Profile
+ * rent shortfall additionally requires vault-funding permission. No token
+ * transfer or onboarding occurs.
+ * A rented Fleet is refused, as is a Fleet whose HP plus pending repair cannot
+ * reach its maximum; the program also needs full AP and SP, which recover on
+ * timers and stay chain-authoritative.
+ * 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.executable)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'The selected Fleet is missing or executable. 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 requires a Docked Fleet. Dock at a Starbase where the Character has a current StarbasePlayer and replan.');
+    const intent = {
+        address: fleet,
+        game,
+        profile: captured.authorization.profile,
+        authority: captured.authorization.authority,
+        system: decoded.state.system,
+        keyIndex: captured.authorization.keyIndex,
+        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}; escrowed hulls of other configurations of the same ship are re-tagged to this one when needed. 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 buildPlannerPlan({
+        kind: 'fleets.add-ship',
+        summary,
+        preconditions: [
+            {
+                kind: 'fleet-add-ship',
+                ...intent,
+                maximumProfileDebit: profileDebit,
+                configHash,
+                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,EAAa,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAU7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAIpD;;;;;;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;AAuBD;;;;;;;;;;;;;;;;;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,108 @@
+import { isAddress } 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 { buildPlannerPlan } from '../../planning/plan-construction.js';
+import { readFreshGameForCharacterRegistration } from '../../registry/onboarding.js';
+import { readDirectOptions } from '../../internal/planning/direct-options.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.');
+    };
+    const { authorization, value } = readDirectOptions(input, ['authorization', 'system', 'label'], bad);
+    if (typeof value.system !== 'string' || !isAddress(value.system))
+        bad();
+    validateFleetCreationLabel(value.label);
+    return {
+        authorization,
+        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,
+        system: captured.system,
+        keyIndex: captured.authorization.keyIndex,
+        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 buildPlannerPlan({
+        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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"}