@aephia/atlas-kit 0.6.0-next.16 → 0.6.0-next.160

package/dist/internal/planning/claim-stake-storage-actions.js.map

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

package/dist/internal/planning/combat-storage-actions.d.ts

@@ -0,0 +1,9 @@
+import type { Address, Instruction } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import { type StorageAction } from './storage-actions.js';
+/** Reads a combat stimulant application's or Loot retrieval's storage effect
+ * from its bytes and fresh accounts. Both normalize only the Fleet. A planner
+ * that already holds the stimulant's catalogued stats passes them; execution
+ * reads them from the Game's stimulant definitions. */
+export declare function readCombatStorageAction(instruction: Instruction, accounts: ReadonlyMap<Address, RawAccount | undefined>, stimulantStats?: readonly number[]): StorageAction;
+//# sourceMappingURL=combat-storage-actions.d.ts.map

package/dist/internal/planning/combat-storage-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combat-storage-actions.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/combat-storage-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAS5D,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;;uDAGuD;AACvD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,EACtD,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GACjC,aAAa,CA8Cf"}

package/dist/internal/planning/combat-storage-actions.js

@@ -0,0 +1,55 @@
+import { decodeApplyStimulantData, decodeRetrieveLootData, stimulantGrowth, stimulantStatIds, } from '../c4/combat-storage.js';
+import { fleetHoldLines } from '../c4/fleet-storage.js';
+import { storageInstruction } from './profile-storage-funding-guard.js';
+import { NONE, present, totals, } from './storage-actions.js';
+/** Reads a combat stimulant application's or Loot retrieval's storage effect
+ * from its bytes and fresh accounts. Both normalize only the Fleet. A planner
+ * that already holds the stimulant's catalogued stats passes them; execution
+ * reads them from the Game's stimulant definitions. */
+export function readCombatStorageAction(instruction, accounts, stimulantStats) {
+    const { kind } = storageInstruction(instruction);
+    const metas = instruction.accounts;
+    const data = instruction.data;
+    const fleet = present(accounts, metas[4].address);
+    const signer = {
+        profile: metas[1].address,
+        authority: metas[0].address,
+        settlement: 'each',
+    };
+    if (kind === 'apply-stimulant') {
+        const { keyIndex, stimCargoId } = decodeApplyStimulantData(data);
+        // The stimulant gains an entry for each stat it affects that has none, and
+        // consumes one unit, whose line closes when it was the last.
+        const stats = stimulantStats ??
+            stimulantStatIds(present(accounts, metas[5].address), stimCargoId);
+        return {
+            ...signer,
+            keyIndex,
+            accounts: [
+                {
+                    address: fleet.address,
+                    growthBytes: stimulantGrowth(fleet, stats),
+                    held: fleetHoldLines(fleet),
+                    added: NONE,
+                    removed: totals([[stimCargoId, 1n]]),
+                },
+            ],
+        };
+    }
+    // A retrieval can open a hold line for every cargo it asks for that the hold
+    // lacks; the Loot may hold less, so this bounds the debit from above. The
+    // Fleet is funded before the emptied Loot refunds its rent.
+    const { keyIndex, cargoIds } = decodeRetrieveLootData(data);
+    return {
+        ...signer,
+        keyIndex,
+        accounts: [
+            {
+                address: fleet.address,
+                held: fleetHoldLines(fleet),
+                added: totals(cargoIds.map((cargoId) => [cargoId, 1n])),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=combat-storage-actions.js.map

package/dist/internal/planning/combat-storage-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combat-storage-actions.js","sourceRoot":"","sources":["../../../src/internal/planning/combat-storage-actions.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EACL,IAAI,EACJ,OAAO,EACP,MAAM,GAEP,MAAM,sBAAsB,CAAC;AAE9B;;;uDAGuD;AACvD,MAAM,UAAU,uBAAuB,CACrC,WAAwB,EACxB,QAAsD,EACtD,cAAkC;IAElC,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,WAAW,CAAE,CAAC;IAClD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAS,CAAC;IACpC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAK,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO;QAC1B,SAAS,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO;QAC5B,UAAU,EAAE,MAAe;KAC5B,CAAC;IACF,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACjE,2EAA2E;QAC3E,6DAA6D;QAC7D,MAAM,KAAK,GACT,cAAc;YACd,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;QACtE,OAAO;YACL,GAAG,MAAM;YACT,QAAQ;YACR,QAAQ,EAAE;gBACR;oBACE,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,WAAW,EAAE,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC;oBAC1C,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC;oBAC3B,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IACD,6EAA6E;IAC7E,0EAA0E;IAC1E,4DAA4D;IAC5D,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO;QACL,GAAG,MAAM;QACT,QAAQ;QACR,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC;gBAC3B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;aACxD;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/internal/planning/crafting-storage-actions.d.ts

@@ -0,0 +1,7 @@
+import type { Address, Instruction } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import { type StorageAction } from './storage-actions.js';
+/** Reads a Crafting Process start's or cancellation's storage effect from its
+ * bytes and fresh accounts. */
+export declare function readCraftingStorageAction(instruction: Instruction, accounts: ReadonlyMap<Address, RawAccount | undefined>): StorageAction;
+//# sourceMappingURL=crafting-storage-actions.d.ts.map

package/dist/internal/planning/crafting-storage-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crafting-storage-actions.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/crafting-storage-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAU5D,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAUzE;+BAC+B;AAC/B,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,GACrD,aAAa,CAqDf"}

package/dist/internal/planning/crafting-storage-actions.js

@@ -0,0 +1,64 @@
+import { craftingProcessBytes, craftingProcessInputLines, decodeCancelCraftingData, decodeStartCraftingData, recipeInputConsumption, } from '../c4/crafting-storage.js';
+import { starbasePlayerAccountDefinition } from '../c4/starbase.js';
+import { storageInstruction } from './profile-storage-funding-guard.js';
+import { NONE, present } from './storage-actions.js';
+function playerLines(player) {
+    return new Map(starbasePlayerAccountDefinition
+        .decode(player)
+        .cargo.amounts.map(({ cargoId, amount }) => [cargoId, amount]));
+}
+/** Reads a Crafting Process start's or cancellation's storage effect from its
+ * bytes and fresh accounts. */
+export function readCraftingStorageAction(instruction, accounts) {
+    const { kind } = storageInstruction(instruction);
+    const metas = instruction.accounts;
+    const data = instruction.data;
+    const signer = {
+        profile: metas[1].address,
+        authority: metas[0].address,
+        settlement: 'each',
+    };
+    if (kind === 'cancel-crafting') {
+        // Returned inputs can reopen Starbase Player lines, which the program
+        // funds before the closed Process refunds its rent.
+        const player = present(accounts, metas[7].address);
+        return {
+            ...signer,
+            keyIndex: decodeCancelCraftingData(data),
+            accounts: [
+                {
+                    address: player.address,
+                    held: playerLines(player),
+                    added: craftingProcessInputLines(present(accounts, metas[8].address)),
+                },
+            ],
+        };
+    }
+    // A start creates the Crafting Process and consumes the recipe inputs from
+    // the Starbase Player, whose emptied lines close; the program settles both
+    // as one group. Later actions in the Plan see the consumed lines. The Hab's
+    // Building XP ledger is created only when absent, which the XP runtime guard
+    // already refuses, and a Hab's own consumption is not credited.
+    const { keyIndex, quantity } = decodeStartCraftingData(data);
+    const recipe = present(accounts, metas[8].address);
+    const player = present(accounts, metas[7].address);
+    return {
+        ...signer,
+        settlement: 'net',
+        keyIndex,
+        accounts: [
+            {
+                address: metas[9].address,
+                created: true,
+                growthBytes: craftingProcessBytes(recipe),
+            },
+            {
+                address: player.address,
+                held: playerLines(player),
+                added: NONE,
+                removed: recipeInputConsumption(recipe, quantity),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=crafting-storage-actions.js.map

package/dist/internal/planning/crafting-storage-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crafting-storage-actions.js","sourceRoot":"","sources":["../../../src/internal/planning/crafting-storage-actions.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAsB,MAAM,sBAAsB,CAAC;AAEzE,SAAS,WAAW,CAAC,MAAkB;IACrC,OAAO,IAAI,GAAG,CACZ,+BAA+B;SAC5B,MAAM,CAAC,MAAM,CAAC;SACd,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CACjE,CAAC;AACJ,CAAC;AAED;+BAC+B;AAC/B,MAAM,UAAU,yBAAyB,CACvC,WAAwB,EACxB,QAAsD;IAEtD,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,WAAW,CAAE,CAAC;IAClD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAS,CAAC;IACpC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAK,CAAC;IAC/B,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO;QAC1B,SAAS,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO;QAC5B,UAAU,EAAE,MAAe;KAC5B,CAAC;IACF,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,sEAAsE;QACtE,oDAAoD;QACpD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO;YACL,GAAG,MAAM;YACT,QAAQ,EAAE,wBAAwB,CAAC,IAAI,CAAC;YACxC,QAAQ,EAAE;gBACR;oBACE,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;oBACzB,KAAK,EAAE,yBAAyB,CAC9B,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CACrC;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IACD,2EAA2E;IAC3E,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,gEAAgE;IAChE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,KAAK;QACjB,QAAQ;QACR,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO;gBAC1B,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC;aAC1C;YACD;gBACE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;gBACzB,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC;aAClD;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/internal/planning/currency-cache-guard.d.ts

@@ -0,0 +1,6 @@
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Bind the cache guard, the region-access guard of a warp lane's destination
+ * or a Starbase attack's target, and a coordinate movement's region-path
+ * guard to generated instruction metas, independently of Plan kind. */
+export declare function validateCurrencyInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=currency-cache-guard.d.ts.map

package/dist/internal/planning/currency-cache-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-cache-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/currency-cache-guard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAa1E;;uEAEuE;AACvE,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CAuGN"}

package/dist/internal/planning/currency-cache-guard.js

@@ -0,0 +1,77 @@
+import { AccountRole } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { SAGE_PROGRAM_ADDRESS } from '../c4/runtime-bindings.js';
+import { ATTACK_STARBASE_DISCRIMINATOR, CANCEL_CLAIM_STAKE_BUILDING_DESIGN_DISCRIMINATOR, DECONSTRUCT_CLAIM_STAKE_INSTANCE_DISCRIMINATOR, FINALIZE_BUILDING_CHANGES_DISCRIMINATOR, START_CLAIM_STAKES_FLEET_TRANSFER_DISCRIMINATOR, START_SUBWARP_DISCRIMINATOR, WARP_LANE_DISCRIMINATOR, WARP_TO_COORDINATE_DISCRIMINATOR, } from '../c4/discriminators.js';
+/** Bind the cache guard, the region-access guard of a warp lane's destination
+ * or a Starbase attack's target, and a coordinate movement's region-path
+ * guard to generated instruction metas, independently of Plan kind. */
+export function validateCurrencyInstructions(steps, guards) {
+    // Discriminator, Game index, cache index. Full layout validation stays in
+    // the existing runtime validators. Keep generated
+    // decoders out of the network-free Plan factory's dependency graph.
+    const layouts = [
+        [WARP_LANE_DISCRIMINATOR, 6, 9],
+        [CANCEL_CLAIM_STAKE_BUILDING_DESIGN_DISCRIMINATOR, 0, 9],
+        [FINALIZE_BUILDING_CHANGES_DISCRIMINATOR, 0, 10],
+        [START_CLAIM_STAKES_FLEET_TRANSFER_DISCRIMINATOR, 10, 9],
+        [DECONSTRUCT_CLAIM_STAKE_INSTANCE_DISCRIMINATOR, 5, 15],
+    ];
+    for (const [index, { instruction }] of steps.entries()) {
+        if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS)
+            continue;
+        // Discriminator and raw I8F56 destination offset; Fleet, Game and
+        // RegionTracker are accounts 5, 6 and 7.
+        const movement = [
+            [START_SUBWARP_DISCRIMINATOR, 8],
+            [WARP_TO_COORDINATE_DISCRIMINATOR, 10],
+        ].find(([discriminator]) => discriminator.every((byte, i) => instruction.data?.[i] === byte));
+        if (movement) {
+            const [fleet, game, tracker] = [5, 6, 7].map((i) => instruction.accounts?.[i]);
+            const data = new Uint8Array(instruction.data);
+            const offset = movement[1];
+            const view = data.length >= offset + 16
+                ? new DataView(data.buffer, data.byteOffset, data.length)
+                : undefined;
+            const to = [offset, offset + 8].map((at) => view?.getBigInt64(at, true));
+            if (!guards.some((g) => g.address === tracker?.address &&
+                ((g.kind === 'region-path' &&
+                    g.game === game?.address &&
+                    g.fleet === fleet?.address &&
+                    g.toX === to[0] &&
+                    g.toY === to[1]) ||
+                    g.kind === 'account-state')))
+                throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Step ${index}: RegionTracker ${tracker?.address} needs a region-path guard for this coordinate movement's Fleet and destination. Recreate via its planner.`);
+            continue;
+        }
+        // Discriminator, then the Game, Star System and RegionTracker indexes of
+        // a region-access guard.
+        const access = [
+            [WARP_LANE_DISCRIMINATOR, 6, 8, 11],
+            [ATTACK_STARBASE_DISCRIMINATOR, 9, 6, 8],
+        ].find(([discriminator]) => discriminator.every((byte, i) => instruction.data?.[i] === byte));
+        if (access) {
+            const [game, system, tracker] = access
+                .slice(1)
+                .map((i) => instruction.accounts?.[i]);
+            if (!guards.some((g) => g.address === tracker?.address &&
+                ((g.kind === 'region-access' &&
+                    g.game === game?.address &&
+                    g.system === system?.address) ||
+                    g.kind === 'account-state')))
+                throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Step ${index}: RegionTracker ${tracker?.address} needs a region-access guard for Star System ${system?.address}. Recreate via its planner.`);
+        }
+        const layout = layouts.find(([discriminator]) => discriminator.every((byte, index) => instruction.data?.[index] === byte));
+        if (!layout)
+            continue;
+        const [, gameIndex, cacheIndex] = layout;
+        const cache = instruction.accounts?.[cacheIndex];
+        const game = instruction.accounts?.[gameIndex];
+        if (cache?.role !== AccountRole.WRITABLE ||
+            game?.role !== AccountRole.READONLY ||
+            !guards.some((g) => g.address === cache.address &&
+                ((g.kind === 'currency-cache' && g.game === game.address) ||
+                    g.kind === 'account-state')))
+            throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Step ${index}: CurrencyCache ${cache?.address} needs a matching guard and roles. Recreate via its planner.`);
+    }
+}
+//# sourceMappingURL=currency-cache-guard.js.map

package/dist/internal/planning/currency-cache-guard.js.map

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

package/dist/internal/planning/democracy-history.d.ts

@@ -0,0 +1,50 @@
+import type { Address, SageContext } from '../../client/contracts.js';
+export interface HistoryFeeParams {
+    readonly craftingFeeBps: number;
+    readonly localMarketFeeBps: number;
+    readonly localTreasuryShareBps: number;
+    readonly treasuryDistributionBps: number;
+}
+interface HistoryScope {
+    readonly game: Address;
+    readonly system: Address;
+    readonly address: Address;
+}
+export type HistoryIntent = HistoryScope & ({
+    readonly state: 'absent';
+} | {
+    readonly state: 'initialized';
+    readonly openDay: bigint;
+    readonly enabled: 0 | 1;
+    readonly controller: number;
+    readonly generation?: Address;
+    readonly generationNumber: bigint;
+    readonly governance: Address;
+    readonly starbaseSeqId: bigint;
+    readonly policy: Address;
+    readonly policyFlags: {
+        readonly noControllerRevenue: number;
+        readonly zeroPowerRevenue: number;
+        readonly successorBaseline: number;
+        readonly captureIncomingEligibility: number;
+    };
+    readonly effectiveParams: HistoryFeeParams;
+});
+export interface ResolvedDemocracyHistory {
+    readonly intent: HistoryIntent;
+    readonly accounts: {
+        readonly democracyHistoryHistory: Address;
+        readonly democracyHistoryPolicy?: Address;
+        readonly democracyHistoryGeneration?: Address;
+    };
+    readonly slot: bigint;
+}
+/** Resolve a fresh, canonical history context without initializing or repairing it. */
+export declare function resolveDemocracyHistory(ctx: SageContext, scope: {
+    readonly game: Address;
+    readonly system: Address;
+}): Promise<ResolvedDemocracyHistory>;
+/** Compare only eligibility and consumed fee policy, never shared financial counters. */
+export declare function matchDemocracyHistoryIntent(expected: HistoryIntent, actual: HistoryIntent): boolean;
+export {};
+//# sourceMappingURL=democracy-history.d.ts.map

package/dist/internal/planning/democracy-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"democracy-history.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/democracy-history.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,OAAO,EAEP,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAsBnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C;AACD,UAAU,YAAY;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AACD,MAAM,MAAM,aAAa,GAAG,YAAY,GACtC,CACI;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC5B;IACE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;QACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;KAC7C,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;CAC5C,CACJ,CAAC;AACJ,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;QAC1C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;QAC1C,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;KAC/C,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAmED,uFAAuF;AACvF,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1D,OAAO,CAAC,wBAAwB,CAAC,CAqLnC;AACD,yFAAyF;AACzF,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,aAAa,GACpB,OAAO,CA2BT"}

package/dist/internal/planning/democracy-history.js

@@ -0,0 +1,189 @@
+import { SYSTEM_PROGRAM } from '../system-program.js';
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { SAGE_PROGRAM_ADDRESS, getDemocracyGenerationHistoryDecoder, getDemocracyHistoryPolicyDecoder, getDemocracySystemHistoryDecoder, } from '../c4/runtime-bindings.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { DEMOCRACY_GENERATION_HISTORY_DISCRIMINATOR, DEMOCRACY_HISTORY_POLICY_DISCRIMINATOR, DEMOCRACY_SYSTEM_HISTORY_DISCRIMINATOR, } from '../c4/discriminators.js';
+import { deriveDemocracyGenerationHistoryAddress, deriveDemocracyHistoryPolicyAddress, deriveDemocracySystemHistoryAddress, } from '../c4/pda.js';
+const DOMAIN = new TextEncoder().encode('DEMHST01');
+function requireHistory(condition, reason) {
+    if (!condition)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `${reason} Refresh the Starbase's Democracy history before recreating this action; ask its operator to initialize or close pending daily checkpoints when needed.`);
+}
+function decode(raw, address, bump, discriminator, decoder) {
+    requireHistory(raw &&
+        raw.address === address &&
+        raw.owner === SAGE_PROGRAM_ADDRESS &&
+        !raw.executable, 'A required Democracy account is missing or has an unexpected owner or address.');
+    requireHistory(discriminator.every((byte, index) => raw.data[index] === byte), 'A Democracy account has the wrong discriminator.');
+    let value;
+    let consumed;
+    try {
+        [value, consumed] = decoder.read(raw.data, 0);
+    }
+    catch {
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'A Democracy account cannot be decoded. Refresh the deployment and recreate this action with supported account data.');
+    }
+    requireHistory(consumed === raw.data.length, 'A Democracy account has an unexpected data length.');
+    requireHistory(value.version === 1 &&
+        value.bump === bump &&
+        value.domain.length === 8 &&
+        value.domain.every((byte, index) => byte === DOMAIN[index]) &&
+        value.reserved.every((byte) => byte === 0), 'A Democracy account has an unsupported version, domain, bump or reserved field.');
+    return value;
+}
+function equalBytes(a, b) {
+    return a.length === b.length && a.every((byte, index) => byte === b[index]);
+}
+function params(value) {
+    return {
+        craftingFeeBps: value.craftingFeeBps,
+        localMarketFeeBps: value.localMarketFeeBps,
+        localTreasuryShareBps: value.localTreasuryShareBps,
+        treasuryDistributionBps: value.treasuryDistributionBps,
+    };
+}
+/** Resolve a fresh, canonical history context without initializing or repairing it. */
+export async function resolveDemocracyHistory(ctx, scope) {
+    const [historyAddress, historyBump] = await deriveDemocracySystemHistoryAddress(scope.system);
+    const [policyAddress, policyBump] = await deriveDemocracyHistoryPolicyAddress(scope.game);
+    let floor = 0n;
+    const read = async (addresses) => {
+        // Absence has no slot in this transport; Clock supplies batch provenance. We
+        // cannot request minContextSlot, so reject inconsistent/regressing responses.
+        const rows = await readContextRawAccounts(ctx, [...addresses, CLOCK_ADDRESS], { commitment: 'confirmed' });
+        requireHistory(rows.length === addresses.length + 1, 'The Democracy history read was incomplete.');
+        const clock = rows[rows.length - 1];
+        requireHistory(clock?.address === CLOCK_ADDRESS, 'The chain Clock is missing from the Democracy history read.');
+        const now = readClock(clock);
+        requireHistory(clock.slot >= floor &&
+            rows.every((row) => row === undefined || row.slot === clock.slot), 'The Democracy history response has inconsistent or regressing slots.');
+        floor = clock.slot;
+        return { rows, now };
+    };
+    const history = (raw) => {
+        const value = decode(raw, historyAddress, historyBump, DEMOCRACY_SYSTEM_HISTORY_DISCRIMINATOR, getDemocracySystemHistoryDecoder());
+        requireHistory(value.gameId === scope.game &&
+            value.system === scope.system &&
+            value.policy === policyAddress &&
+            value.enabled <= 1 &&
+            value.cutoverDay <= value.openDay &&
+            value.generationStartedDay <= value.openDay, 'The Democracy history scope or calendar is invalid.');
+        return value;
+    };
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const first = (await read([historyAddress])).rows[0];
+        if (!first)
+            return {
+                intent: {
+                    game: scope.game,
+                    system: scope.system,
+                    address: historyAddress,
+                    state: 'absent',
+                },
+                accounts: { democracyHistoryHistory: historyAddress },
+                slot: floor,
+            };
+        const initial = history(first);
+        const generationPda = initial.generation === SYSTEM_PROGRAM
+            ? undefined
+            : await deriveDemocracyGenerationHistoryAddress(scope.system, initial.generationNumber);
+        requireHistory(!generationPda || generationPda[0] === initial.generation, 'The Democracy history references a noncanonical generation.');
+        const batch = await read([
+            historyAddress,
+            policyAddress,
+            ...(generationPda ? [generationPda[0]] : []),
+        ]);
+        const second = batch.rows[0];
+        if (!second || !equalBytes(first.data, second.data))
+            continue;
+        const current = history(second);
+        const policy = decode(batch.rows[1], policyAddress, policyBump, DEMOCRACY_HISTORY_POLICY_DISCRIMINATOR, getDemocracyHistoryPolicyDecoder());
+        requireHistory(policy.gameId === scope.game &&
+            [
+                policy.noControllerRevenue,
+                policy.zeroPowerRevenue,
+                policy.successorBaseline,
+                policy.captureIncomingEligibility,
+            ].every((value) => value === 1 || value === 2), 'The Democracy policy scope or explicit policy flags are invalid.');
+        const generation = generationPda
+            ? decode(batch.rows[2], generationPda[0], generationPda[1], DEMOCRACY_GENERATION_HISTORY_DISCRIMINATOR, getDemocracyGenerationHistoryDecoder())
+            : undefined;
+        if (generation)
+            requireHistory(generation.gameId === scope.game &&
+                generation.system === scope.system &&
+                generation.generation === current.generationNumber &&
+                generation.starbaseSeqId === current.starbaseSeqId &&
+                generation.governance === current.governance &&
+                generation.controller === current.controller &&
+                generation.enabled === current.enabled &&
+                generation.openDay === current.openDay &&
+                generation.retired === 0 &&
+                generation.fundedAtlas >= generation.claimedAtlas &&
+                generation.rewardVault ===
+                    generation.fundedAtlas - generation.claimedAtlas, 'The Democracy generation scope, eligibility or reward funding does not match its history.');
+        requireHistory(current.controller === 0 || generation, 'The current Democracy controller has no initialized generation.');
+        requireHistory(batch.now >= 0n && batch.now / 86400n === current.openDay, 'The Democracy history has pending daily checkpoints or the chain day changed.');
+        const intent = {
+            game: scope.game,
+            system: scope.system,
+            address: historyAddress,
+            state: 'initialized',
+            openDay: current.openDay,
+            enabled: current.enabled,
+            controller: current.controller,
+            ...(generationPda ? { generation: generationPda[0] } : {}),
+            generationNumber: current.generationNumber,
+            governance: current.governance,
+            starbaseSeqId: current.starbaseSeqId,
+            policy: policyAddress,
+            policyFlags: {
+                noControllerRevenue: policy.noControllerRevenue,
+                zeroPowerRevenue: policy.zeroPowerRevenue,
+                successorBaseline: policy.successorBaseline,
+                captureIncomingEligibility: policy.captureIncomingEligibility,
+            },
+            effectiveParams: params(current.enabled === 0
+                ? {
+                    craftingFeeBps: 10000,
+                    localMarketFeeBps: 0,
+                    localTreasuryShareBps: 0,
+                    treasuryDistributionBps: 0,
+                }
+                : (generation?.activeParams ?? policy.defaultParams)),
+        };
+        return {
+            intent,
+            accounts: {
+                democracyHistoryHistory: historyAddress,
+                democracyHistoryPolicy: policyAddress,
+                ...(generationPda
+                    ? { democracyHistoryGeneration: generationPda[0] }
+                    : {}),
+            },
+            slot: floor,
+        };
+    }
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Democracy history changed during both preparation attempts. Refresh the Starbase and recreate this action.');
+}
+/** Compare only eligibility and consumed fee policy, never shared financial counters. */
+export function matchDemocracyHistoryIntent(expected, actual) {
+    if (expected.game !== actual.game ||
+        expected.system !== actual.system ||
+        expected.address !== actual.address ||
+        expected.state !== actual.state)
+        return false;
+    if (expected.state === 'absent' || actual.state === 'absent')
+        return true;
+    return (expected.openDay === actual.openDay &&
+        expected.enabled === actual.enabled &&
+        expected.controller === actual.controller &&
+        expected.generation === actual.generation &&
+        expected.generationNumber === actual.generationNumber &&
+        expected.governance === actual.governance &&
+        expected.starbaseSeqId === actual.starbaseSeqId &&
+        expected.policy === actual.policy &&
+        Object.entries(expected.policyFlags).every(([key, value]) => actual.policyFlags[key] === value) &&
+        Object.entries(expected.effectiveParams).every(([key, value]) => actual.effectiveParams[key] === value));
+}
+//# sourceMappingURL=democracy-history.js.map

package/dist/internal/planning/democracy-history.js.map

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

package/dist/internal/planning/direct-options.d.ts

@@ -0,0 +1,17 @@
+import { type Address } from '@solana/kit';
+/** Direct Profile authorization without a certificate. */
+export interface DirectAuthorization {
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly keyIndex: number;
+}
+/** Reads planner options holding exactly `fields`, one of them a direct
+ * `authorization` of exactly a Profile, an on-curve authority and a u16 key
+ * index. Returns a copy of the authorization and the option values for the
+ * planner's own field checks; `bad` rejects any other shape with the
+ * planner's accepted range and remedy. */
+export declare function readDirectOptions(input: unknown, fields: readonly string[], bad: () => never): {
+    readonly authorization: DirectAuthorization;
+    readonly value: Readonly<Record<string, unknown>>;
+};
+//# sourceMappingURL=direct-options.d.ts.map

package/dist/internal/planning/direct-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-options.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/direct-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAEzE,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;0CAI0C;AAC1C,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,MAAM,KAAK,GACf;IACD,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD,CAyCA"}

package/dist/internal/planning/direct-options.js

@@ -0,0 +1,43 @@
+import { isAddress, isOffCurveAddress } from '@solana/kit';
+/** Reads planner options holding exactly `fields`, one of them a direct
+ * `authorization` of exactly a Profile, an on-curve authority and a u16 key
+ * index. Returns a copy of the authorization and the option values for the
+ * planner's own field checks; `bad` rejects any other shape with the
+ * planner's accepted range and remedy. */
+export function readDirectOptions(input, fields, bad) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input))
+        bad();
+    const value = input;
+    if (Object.keys(value).length !== fields.length ||
+        !fields.every((field) => Object.hasOwn(value, field)))
+        bad();
+    const authorization = value.authorization;
+    if (authorization === null ||
+        typeof authorization !== 'object' ||
+        Array.isArray(authorization))
+        bad();
+    const a = authorization;
+    if (Object.keys(a).length !== 3 ||
+        !Object.hasOwn(a, 'profile') ||
+        !Object.hasOwn(a, 'authority') ||
+        !Object.hasOwn(a, 'keyIndex') ||
+        typeof a.profile !== 'string' ||
+        !isAddress(a.profile) ||
+        typeof a.authority !== 'string' ||
+        !isAddress(a.authority) ||
+        isOffCurveAddress(a.authority) ||
+        typeof a.keyIndex !== 'number' ||
+        !Number.isInteger(a.keyIndex) ||
+        a.keyIndex < 0 ||
+        a.keyIndex > 65535)
+        bad();
+    return {
+        authorization: {
+            profile: a.profile,
+            authority: a.authority,
+            keyIndex: a.keyIndex,
+        },
+        value,
+    };
+}
+//# sourceMappingURL=direct-options.js.map

package/dist/internal/planning/direct-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-options.js","sourceRoot":"","sources":["../../../src/internal/planning/direct-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAC;AASzE;;;;0CAI0C;AAC1C,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,MAAyB,EACzB,GAAgB;IAKhB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrE,GAAG,EAAE,CAAC;IACR,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,IACE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAC3C,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAErD,GAAG,EAAE,CAAC;IACR,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;IAC1C,IACE,aAAa,KAAK,IAAI;QACtB,OAAO,aAAa,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;QAE5B,GAAG,EAAE,CAAC;IACR,MAAM,CAAC,GAAG,aAAwC,CAAC;IACnD,IACE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;QAC3B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC;QAC5B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC;QAC9B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC;QAC7B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QACrB,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACvB,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9B,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7B,CAAC,CAAC,QAAQ,GAAG,CAAC;QACd,CAAC,CAAC,QAAQ,GAAG,KAAK;QAElB,GAAG,EAAE,CAAC;IACR,OAAO;QACL,aAAa,EAAE;YACb,OAAO,EAAE,CAAC,CAAC,OAAkB;YAC7B,SAAS,EAAE,CAAC,CAAC,SAAoB;YACjC,QAAQ,EAAE,CAAC,CAAC,QAAkB;SAC/B;QACD,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/internal/planning/disband-storage-actions.d.ts

@@ -0,0 +1,9 @@
+import type { Address, Instruction } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import { type StorageAction } from './storage-actions.js';
+/** Reads a Fleet disband's storage effect from its bytes and fresh accounts.
+ * The program normalizes only the Starbase Player the Fleet's ships and cargo
+ * merge into, funding its growth from the Profile; the closed Fleet's rent
+ * refund reaches the Profile afterwards and funds none of it. */
+export declare function readDisbandStorageAction(instruction: Instruction, accounts: ReadonlyMap<Address, RawAccount | undefined>): StorageAction;
+//# sourceMappingURL=disband-storage-actions.d.ts.map

package/dist/internal/planning/disband-storage-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disband-storage-actions.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/disband-storage-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAO5D,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;iEAGiE;AACjE,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC,GACrD,aAAa,CAmBf"}