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

package/dist/registry/onboarding.d.ts

@@ -1,6 +1,14 @@
 import type { RawAccount, SageContext } from '../client/contracts.js';
+import { readContextRawAccounts } from '../client/reconciliation.js';
+import { type GameDecodeScope } from '../internal/c4/game.js';
 /** Fresh Game validation for Character creation, without loading retained catalogs. */
-export declare function readFreshGameForCharacterRegistration(ctx: SageContext): Promise<RawAccount>;
+export declare function readFreshGameForCharacterRegistration(ctx: SageContext, options?: Parameters<typeof readContextRawAccounts>[2]): Promise<RawAccount>;
 /** Validates fresh Game identity and the full pinned layout without retaining catalogs or hashing definitions. */
-export declare function validateGameForCharacterRegistration(account: RawAccount): void;
+export declare function validateGameForCharacterRegistration(account: RawAccount, scope?: GameDecodeScope): void;
+export interface CharacterInitialization {
+    readonly characterSize: number;
+    readonly initializationHash: string;
+}
+/** Fresh, finite initialization shape for the qualified current registration. */
+export declare function readCharacterInitialization(ctx: SageContext, options?: Parameters<typeof readContextRawAccounts>[2]): Promise<CharacterInitialization>;
 //# sourceMappingURL=onboarding.d.ts.map

package/dist/registry/onboarding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/registry/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMtE,uFAAuF;AACvF,wBAAsB,qCAAqC,CACzD,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED,kHAAkH;AAClH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,UAAU,GAClB,IAAI,CAYN"}
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/registry/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAKhC,uFAAuF;AACvF,wBAAsB,qCAAqC,CACzD,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,GACrD,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED,kHAAkH;AAClH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,UAAU,EACnB,KAAK,CAAC,EAAE,eAAe,GACtB,IAAI,CAYN;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AACD,iFAAiF;AACjF,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,GACrD,OAAO,CAAC,uBAAuB,CAAC,CAclC"}

package/dist/registry/onboarding.js

@@ -1,24 +1,37 @@
 import { SageSdkError } from '../client/errors.js';
 import { readContextRawAccounts } from '../client/reconciliation.js';
-import { validateGameAccountLayout } from '../internal/c4/game.js';
+import { decodeCharacterInitialization, validateGameAccountLayout, } from '../internal/c4/game.js';
+import { hashAccountState } from '../internal/planning/account-state.js';
+import { characterAccountDefinition } from '../internal/c4/identity.js';
 import { requireGameAddress } from '../internal/game-context.js';
 /** Fresh Game validation for Character creation, without loading retained catalogs. */
-export async function readFreshGameForCharacterRegistration(ctx) {
+export async function readFreshGameForCharacterRegistration(ctx, options) {
     const game = requireGameAddress(ctx);
-    const [account] = await readContextRawAccounts(ctx, [game]);
+    const [account] = await readContextRawAccounts(ctx, [game], options);
     if (!account)
-        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `The configured Game ${game} is missing. Select an existing C4 Game before registering this Profile's Character.`, { address: game });
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `The configured Game ${game} is missing. Select an existing C4 Game before planning this action.`, { address: game });
     validateGameForCharacterRegistration(account);
     return account;
 }
 /** Validates fresh Game identity and the full pinned layout without retaining catalogs or hashing definitions. */
-export function validateGameForCharacterRegistration(account) {
+export function validateGameForCharacterRegistration(account, scope) {
     const game = account.address;
     if (account.executable)
-        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `The configured Game ${game} is executable instead of Game state. Select a valid C4 Game account and retry registration.`, { address: game });
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `The configured Game ${game} is executable instead of Game state. Select a valid C4 Game account and plan again.`, { address: game });
     // Prefix validation alone cannot detect truncated variable-length Game data.
     // The registry's pinned exact codec validates the whole account transiently;
     // the validation-only entry retains no catalog translation dispatcher.
-    validateGameAccountLayout(account);
+    validateGameAccountLayout(account, scope);
+}
+/** Fresh, finite initialization shape for the qualified current registration. */
+export async function readCharacterInitialization(ctx, options) {
+    const raw = await readFreshGameForCharacterRegistration(ctx, options);
+    const value = decodeCharacterInitialization(raw);
+    if (value.version !== 2)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Character registration requires current Game 2; migration-sealed or unsupported Games require a supported deployment.', { address: raw.address });
+    return {
+        characterSize: characterAccountDefinition.minimumDataLength + value.characterGrowth,
+        initializationHash: await hashAccountState(raw.owner, value.bytes),
+    };
 }
 //# sourceMappingURL=onboarding.js.map

package/dist/registry/onboarding.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/registry/onboarding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,GAAgB;IAEhB,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,uBAAuB,IAAI,sFAAsF,EACjH,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACJ,oCAAoC,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,oCAAoC,CAClD,OAAmB;IAEnB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU;QACpB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,uBAAuB,IAAI,8FAA8F,EACzH,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACJ,6EAA6E;IAC7E,6EAA6E;IAC7E,uEAAuE;IACvE,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/registry/onboarding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,GAE1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,GAAgB,EAChB,OAAsD;IAEtD,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,uBAAuB,IAAI,sEAAsE,EACjG,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACJ,oCAAoC,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,oCAAoC,CAClD,OAAmB,EACnB,KAAuB;IAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU;QACpB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,uBAAuB,IAAI,sFAAsF,EACjH,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACJ,6EAA6E;IAC7E,6EAA6E;IAC7E,uEAAuE;IACvE,yBAAyB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAMD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAgB,EAChB,OAAsD;IAEtD,MAAM,GAAG,GAAG,MAAM,qCAAqC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC;QACrB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,uHAAuH,EACvH,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CACzB,CAAC;IACJ,OAAO;QACL,aAAa,EACX,0BAA0B,CAAC,iBAAiB,GAAG,KAAK,CAAC,eAAe;QACtE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/registry/scanning.d.ts

@@ -0,0 +1,7 @@
+import type { SageContext, ReadAccountOptions } from '../client/contracts.js';
+/** Fresh scanning configuration without retaining a Game snapshot or resolving unrelated definitions. */
+export declare function readFreshGameScanningConfiguration(ctx: SageContext, options?: ReadAccountOptions): Promise<{
+    shipSequenceId: number;
+    cargo: import("../internal/c4/game.js").GameCargoDefinitionsSectionData;
+}>;
+//# sourceMappingURL=scanning.d.ts.map

package/dist/registry/scanning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanning.d.ts","sourceRoot":"","sources":["../../src/registry/scanning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAK9E,yGAAyG;AACzG,wBAAsB,kCAAkC,CACtD,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,kBAAkB;;;GAU7B"}

package/dist/registry/scanning.js

@@ -0,0 +1,13 @@
+import { SageSdkError } from '../client/errors.js';
+import { readContextRawAccounts } from '../client/reconciliation.js';
+import { requireGameAddress } from '../internal/game-context.js';
+import { decodeGameScanningConfiguration } from '../internal/c4/game.js';
+/** Fresh scanning configuration without retaining a Game snapshot or resolving unrelated definitions. */
+export async function readFreshGameScanningConfiguration(ctx, options) {
+    const game = requireGameAddress(ctx);
+    const [raw] = await readContextRawAccounts(ctx, [game], options);
+    if (!raw)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Scanning requires the configured Game. Restore the correct deployment context and refresh before detection.');
+    return decodeGameScanningConfiguration(raw);
+}
+//# sourceMappingURL=scanning.js.map

package/dist/registry/scanning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanning.js","sourceRoot":"","sources":["../../src/registry/scanning.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,GAAgB,EAChB,OAA4B;IAE5B,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,IAAI,CAAC,GAAG;QACN,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,6GAA6G,CAC9G,CAAC;IACJ,OAAO,+BAA+B,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/dist/registry/ship-stats-snapshot.js

@@ -75,21 +75,21 @@ const rules = {
         shieldBreakDelaySeconds: U16,
         warpSpoolTimeSeconds: U16,
         damageKinetic: U32,
-        damageKineticVariance: U32,
+        damageKineticVariance: U26F6,
         damageEnergy: U32,
-        damageEnergyVariance: U32,
+        damageEnergyVariance: U26F6,
         damageEmp: U32,
-        damageEmpVariance: U32,
+        damageEmpVariance: U26F6,
         damageSuperchill: U32,
-        damageSuperchillVariance: U32,
+        damageSuperchillVariance: U26F6,
         damageShockwave: U32,
-        damageShockwaveVariance: U32,
+        damageShockwaveVariance: U26F6,
         damageGraygoo: U32,
-        damageGraygooVariance: U32,
+        damageGraygooVariance: U26F6,
         damageHeat: U32,
-        damageHeatVariance: U32,
+        damageHeatVariance: U26F6,
         damageBomb: U32,
-        damageBombVariance: U32,
+        damageBombVariance: U26F6,
         counterDecoy: U32,
         counterEnergyCapacitor: U32,
         counterFireSuppressor: U32,
@@ -99,14 +99,14 @@ const rules = {
         counterNegativeRemPlating: U32,
         counterWarmingPlates: U32,
         counterFaradayShielding: U32,
-        stealthPower: U32,
-        hitChance: U32,
-        aimAbility: U32,
-        critChance: U32,
-        critMultiplier: U32,
-        fuelConsumptionRate: U32,
-        missileDamage: U32,
-        missileFireRate: U32,
+        stealthPower: U26F6,
+        hitChance: U26F6,
+        aimAbility: U26F6,
+        critChance: U26F6,
+        critMultiplier: U26F6,
+        fuelConsumptionRate: U26F6,
+        missileDamage: U26F6,
+        missileFireRate: U26F6,
     },
     misc: {
         requiredCrew: U16,
@@ -114,13 +114,13 @@ const rules = {
         respawnTimeWithoutFeeSeconds: U16,
         respawnTimeWithFeeSeconds: U16,
         respawnFeeRaw: U64,
-        scanCoolDownSeconds: U32,
-        scanPower: U32,
+        scanCoolDownSeconds: U16F16,
+        scanPower: U26F6,
         scanCost: U32,
         scanBonus: I32,
         lpValue: U32,
         medallionValue: U32,
-        xpValue: U32,
+        xpValue: U16F16,
         respawnFeeAtlas: (value) => typeof value === 'number' && Number.isFinite(value) && value >= 0
             ? value
             : undefined,

package/dist/registry/ship-stats-snapshot.js.map

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

package/dist/registry/ships.d.ts

@@ -1,4 +1,6 @@
-import type { RawAccount, SageContext } from '../client/contracts.js';
+import type { Address } from '@solana/kit';
+import type { RawAccount, ReadAccountOptions, SageContext } from '../client/contracts.js';
+import { type GameDecodeScope, type GameShipConfigurationRow } from '../internal/c4/game.js';
 /** Resolves one explicit ship configuration from a fresh, registry-owned Game read. */
 export declare function readFreshGameShipConfiguration(context: SageContext, shipId: number): Promise<Readonly<{
     rawAccount: RawAccount;
@@ -6,5 +8,23 @@ export declare function readFreshGameShipConfiguration(context: SageContext, shi
     configHash: string;
 }>>;
 /** Decodes one fresh Game once and hashes each requested ship; missing IDs have no hash. */
-export declare function hashGameShipConfigurations(account: RawAccount, shipIds: readonly number[]): Promise<ReadonlyMap<number, string>>;
+export declare function hashGameShipConfigurations(account: RawAccount, shipIds: readonly number[], catalog?: ShipAssemblyCatalog, scope?: GameDecodeScope): Promise<ReadonlyMap<number, string>>;
+/** Invocation-local validated raw ship catalog; never retained by a context. */
+export interface ShipAssemblyCatalog {
+    readonly owner: Address;
+    readonly sequenceId: number;
+    readonly maxFleetSize: number;
+    readonly rows: readonly GameShipConfigurationRow[];
+}
+/** Validates and decodes the Game exactly once behind the registry boundary. */
+export declare function decodeGameShipAssemblyCatalog(account: RawAccount, scope?: GameDecodeScope): ShipAssemblyCatalog;
+/** Reads fresh assembly configuration without loading public registry sections. */
+export declare function readFreshGameShipAssemblyCatalog(ctx: SageContext, options?: ReadAccountOptions): Promise<{
+    rawAccount: RawAccount;
+    catalog: ShipAssemblyCatalog;
+}>;
+/** Hashes only the selected pinned configuration, allowing unrelated Game updates. */
+export declare function hashShipAssemblyConfiguration(catalog: ShipAssemblyCatalog, ship: GameShipConfigurationRow): Promise<string>;
+/** Reads fresh ship-definition generation, without retaining a catalog or validating every ship index. */
+export declare function readFreshGameShipDefinitionSequence(ctx: SageContext, options?: ReadAccountOptions): Promise<number>;
 //# sourceMappingURL=ships.d.ts.map

package/dist/registry/ships.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ships.d.ts","sourceRoot":"","sources":["../../src/registry/ships.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAkBtE,uFAAuF;AACvF,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM;;;;IA0Bf;AAED,4FAA4F;AAC5F,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQtC"}
+{"version":3,"file":"ships.d.ts","sourceRoot":"","sources":["../../src/registry/ships.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAYhC,uFAAuF;AACvF,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM;;;;IA0Bf;AAED,4FAA4F;AAC5F,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,mBAAmB,EAC7B,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQtC;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACpD;AACD,gFAAgF;AAChF,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,UAAU,EACnB,KAAK,CAAC,EAAE,eAAe,GACtB,mBAAmB,CAKrB;AACD,mFAAmF;AACnF,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAWnE;AACD,sFAAsF;AACtF,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,0GAA0G;AAC1G,wBAAsB,mCAAmC,CACvD,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/dist/registry/ships.js

@@ -1,6 +1,6 @@
-import { InvalidActionInputError } from '../client/errors.js';
+import { InvalidActionInputError, SageSdkError } from '../client/errors.js';
 import { readContextRawAccounts } from '../client/reconciliation.js';
-import { decodeGameShipConfigurations, encodeGameShipConfiguration, } from '../internal/c4/game.js';
+import { decodeGameShipConfigurations, decodeGameShipDefinitionSequence, decodeGameShipConfigurationRows, encodeGameShipConfiguration, } from '../internal/c4/game.js';
 import { requireGameAddress } from '../internal/game-context.js';
 import { hashAccountState } from '../internal/planning/account-state.js';
 /** Hashes the complete pinned Ship encoding, including its ID, mint and requirements. */
@@ -23,8 +23,8 @@ export async function readFreshGameShipConfiguration(context, shipId) {
     });
 }
 /** Decodes one fresh Game once and hashes each requested ship; missing IDs have no hash. */
-export async function hashGameShipConfigurations(account, shipIds) {
-    const ships = decodeGameShipConfigurations(account);
+export async function hashGameShipConfigurations(account, shipIds, catalog, scope) {
+    const ships = catalog?.rows ?? decodeGameShipConfigurations(account, scope);
     const selected = new Set(shipIds);
     const hashes = new Map();
     for (const ship of ships)
@@ -32,4 +32,31 @@ export async function hashGameShipConfigurations(account, shipIds) {
             hashes.set(ship.id, await hashShip(account, ship));
     return hashes;
 }
+/** Validates and decodes the Game exactly once behind the registry boundary. */
+export function decodeGameShipAssemblyCatalog(account, scope) {
+    return {
+        owner: account.owner,
+        ...decodeGameShipConfigurationRows(account, scope),
+    };
+}
+/** Reads fresh assembly configuration without loading public registry sections. */
+export async function readFreshGameShipAssemblyCatalog(ctx, options) {
+    const game = requireGameAddress(ctx);
+    const [rawAccount] = await readContextRawAccounts(ctx, [game], options);
+    if (!rawAccount)
+        throw new InvalidActionInputError('game', game, 'an existing Game', 'Refresh the configured Game before assembling ships.');
+    return { rawAccount, catalog: decodeGameShipAssemblyCatalog(rawAccount) };
+}
+/** Hashes only the selected pinned configuration, allowing unrelated Game updates. */
+export function hashShipAssemblyConfiguration(catalog, ship) {
+    return hashAccountState(catalog.owner, encodeGameShipConfiguration(ship));
+}
+/** Reads fresh ship-definition generation, without retaining a catalog or validating every ship index. */
+export async function readFreshGameShipDefinitionSequence(ctx, options) {
+    const game = requireGameAddress(ctx);
+    const [account] = await readContextRawAccounts(ctx, [game], options);
+    if (!account || account.executable)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'The configured Game must exist and contain non-executable Game state. Refresh the deployment Game before transferring crew.');
+    return decodeGameShipDefinitionSequence(account);
+}
 //# sourceMappingURL=ships.js.map

package/dist/registry/ships.js.map

@@ -1 +1 @@
-{"version":3,"file":"ships.js","sourceRoot":"","sources":["../../src/registry/ships.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,yFAAyF;AACzF,SAAS,QAAQ,CACf,OAAmB,EACnB,IAA6D;IAE7D,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAAoB,EACpB,MAAc;IAEd,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,UAAU;QACb,MAAM,IAAI,uBAAuB,CAC/B,MAAM,EACN,IAAI,EACJ,+CAA+C,EAC/C,sDAAsD,CACvD,CAAC;IACJ,MAAM,IAAI,GAAG,4BAA4B,CAAC,UAAU,CAAC,CAAC,IAAI,CACxD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAC3B,CAAC;IACF,IAAI,CAAC,IAAI;QACP,MAAM,IAAI,uBAAuB,CAC/B,QAAQ,EACR,MAAM,EACN,8CAA8C,EAC9C,oEAAoE,CACrE,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU;QACV,IAAI;QACJ,UAAU,EAAE,MAAM,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAmB,EACnB,OAA0B;IAE1B,MAAM,KAAK,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK;QACtB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"ships.js","sourceRoot":"","sources":["../../src/registry/ships.ts"],"names":[],"mappings":"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"}

package/dist/registry/xp-runtime.d.ts

@@ -0,0 +1,4 @@
+import type { Address, ReadAccountOptions, SageContext } from '../client/contracts.js';
+/** Fresh runtime eligibility uses full Game validation, without retaining catalogs. */
+export declare function readFreshGameRuntimeVersion(ctx: SageContext, game: Address, options?: ReadAccountOptions): Promise<number>;
+//# sourceMappingURL=xp-runtime.d.ts.map

package/dist/registry/xp-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xp-runtime.d.ts","sourceRoot":"","sources":["../../src/registry/xp-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAMhC,uFAAuF;AACvF,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/registry/xp-runtime.js

@@ -0,0 +1,14 @@
+import { SageSdkError } from '../client/errors.js';
+import { readContextRawAccounts } from '../client/reconciliation.js';
+import { decodeGameRuntimeVersion } from '../internal/c4/game.js';
+import { requireGameAddress } from '../internal/game-context.js';
+/** Fresh runtime eligibility uses full Game validation, without retaining catalogs. */
+export async function readFreshGameRuntimeVersion(ctx, game, options) {
+    if (requireGameAddress(ctx) !== game)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `XP runtime Game ${game} differs from the configured Game. Use this deployment's Game and prepare a new Plan.`, { address: game });
+    const [account] = await readContextRawAccounts(ctx, [game], options);
+    if (!account || account.address !== game || account.executable)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Game ${game} must be an existing, non-executable Game account. Refresh the configured Game and prepare a new Plan.`, { address: game });
+    return decodeGameRuntimeVersion(account);
+}
+//# sourceMappingURL=xp-runtime.js.map

package/dist/registry/xp-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xp-runtime.js","sourceRoot":"","sources":["../../src/registry/xp-runtime.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAgB,EAChB,IAAa,EACb,OAA4B;IAE5B,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,IAAI;QAClC,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,mBAAmB,IAAI,uFAAuF,EAC9G,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACJ,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU;QAC5D,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,QAAQ,IAAI,wGAAwG,EACpH,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACJ,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}

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

@@ -0,0 +1,116 @@
+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';
+export type { PlanAuthorization };
+/** Explicit address-only direct Profile authorization for signal setup. Certificates are unsupported.
+ * @example
+ * ```ts
+ * declare const authorization: PlanAuthorization;
+ * const options: PlanOpenScanSignalOptions = { authorization };
+ * ```
+ */
+export interface PlanOpenScanSignalOptions {
+    readonly authorization: PlanAuthorization;
+}
+/** Plans one absent canonical signal for a directly owned Fleet, including Docked Fleets.
+ * Planning reads fresh state but never signs, submits, deposits funds or detects a signal.
+ * The Profile funds signal rent while retaining its own reserve; transaction fees are separate.
+ * Restricted-key least privilege is unqualified: instruction permission acceptance remains
+ * chain-authoritative, and legacy SCAN bit 38 is not established as sufficient. Simulate before signing.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, authorization: PlanAuthorization;
+ * const plan = await planOpenScanSignal(ctx, fleet, { authorization });
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planOpenScanSignal(ctx: SageContext, fleet: Address, options: PlanOpenScanSignalOptions): Promise<Plan>;
+import { type DetectOptions } from '../../internal/planning/scan-detect.js';
+/** Explicit choices for one Idle Fleet's detection; setup and funding are separate.
+ * @example
+ * ```ts
+ * declare const profile: Address, authority: Address;
+ * const authorization = { profile, authority, keyIndex: 0 };
+ * const options: PlanDetectSignalOptions = { authorization, patternId: 0, focus: 'any' };
+ * ```
+ */
+export interface PlanDetectSignalOptions extends DetectOptions {
+}
+/** Plans one signal detection for an existing Empty signal and directly owned Idle Fleet.
+ * Reads fresh prerequisites without signing. Restricted-key sufficiency, cooldown
+ * rejection and final gameplay outcomes remain chain-authoritative; use simulatePlan.
+ * No automatic opening, deposits, loading, undocking or resolution occurs.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, options: PlanDetectSignalOptions;
+ * const plan = await planDetectSignal(ctx, fleet, options);
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planDetectSignal(ctx: SageContext, fleet: Address, options: PlanDetectSignalOptions): Promise<Plan>;
+import { type ScanCompletionOptions } from '../../internal/planning/scan-completion.js';
+/** Direct address-only authority for recovery, abandonment and receipt acknowledgement.
+ * @example
+ * ```ts
+ * declare const authorization: PlanAuthorization;
+ * const options: PlanScanCompletionOptions = { authorization };
+ * ```
+ */
+export interface PlanScanCompletionOptions extends ScanCompletionOptions {
+}
+/** Resolve one PendingEntropy signal using its committed policy and regional loot configuration. Requires current Character XP accounts; no gameplay authority is needed.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address;
+ * const plan = await planResolveSignal(ctx, fleet);
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planResolveSignal(ctx: SageContext, fleet: Address): Promise<Plan>;
+/** Recover one unexpired Contact with an Idle Fleet inside its stored radius. Cargo acceptance, clipping and XP remain chain-authoritative.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, options: PlanScanCompletionOptions;
+ * const plan = await planRecoverSignal(ctx, fleet, options);
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planRecoverSignal(ctx: SageContext, fleet: Address, options: PlanScanCompletionOptions): Promise<Plan>;
+/** Clear one terminal receipt to Empty while retaining the funded signal. Explicitly includes the Fleet for current abandoned-receipt cooldown handling.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, options: PlanScanCompletionOptions;
+ * const plan = await planAcknowledgeScanResult(ctx, fleet, options);
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planAcknowledgeScanResult(ctx: SageContext, fleet: Address, options: PlanScanCompletionOptions): Promise<Plan>;
+/** Abandon one unexpired Contact without attempting recovery. Acknowledgement remains a separate explicit action.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address, options: PlanScanCompletionOptions;
+ * const plan = await planAbandonSignal(ctx, fleet, options);
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planAbandonSignal(ctx: SageContext, fleet: Address, options: PlanScanCompletionOptions): Promise<Plan>;
+/** Expire one Contact after its deadline. No gameplay authority is needed; acknowledgement remains separate.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address;
+ * const plan = await planExpireSignal(ctx, fleet);
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planExpireSignal(ctx: SageContext, fleet: Address): Promise<Plan>;
+/** Forfeit one PendingEntropy attempt after the supported reveal deadline. No gameplay authority is needed; acknowledgement remains separate.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address;
+ * const plan = await planForfeitScanSignalEntropy(ctx, fleet);
+ * console.log(plan.describe());
+ * ```
+ */
+export declare function planForfeitScanSignalEntropy(ctx: SageContext, fleet: Address): Promise<Plan>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scanning/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAa1F,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAClC;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AACD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAiDf;AAED,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,wCAAwC,CAAC;AAChD;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAwB,SAAQ,aAAa;CAAG;AACjE;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,4CAA4C,CAAC;AAKpD;;;;;;GAMG;AACH,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;CAAG;AAyC3E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAEf;AACD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf;AACD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf;AACD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf;AACD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAEf;AACD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAEf"}