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

package/dist/internal/planning/plan-guards.js

@@ -0,0 +1,184 @@
+import { normalizeArrivalGuard } from './arrival-guards.js';
+import { FLEET_DOCK_FUNDING_SCHEMA } from './fleet-dock-funding-guard.js';
+import { LOCAL_MARKET_ORDER_SCHEMA } from './local-market-order.js';
+import { PROFILE_STORAGE_FUNDING_SCHEMA } from './profile-storage-funding-guard.js';
+import { MAX_U64, invalid, normalizeSchemaGuard, readRecord, } from './plan-fields.js';
+import { isRuntimeGuard, normalizeRuntimeGuard } from './runtime-guards.js';
+import { scanCompletionDiscriminators } from './scan-completion-guard.js';
+const U8 = {
+    min: 0,
+    max: 255,
+    accepted: 'an unsigned u8 integer',
+};
+const U16 = {
+    min: 0,
+    max: 65535,
+    accepted: 'an unsigned u16 integer',
+};
+const U32 = {
+    min: 0,
+    max: 4294967295,
+    accepted: 'an unsigned u32 integer',
+};
+const KEY_INDEX = { ...U16, accepted: 'a u16 Profile key index' };
+const SHIP_ID = {
+    ...U16,
+    accepted: 'a u16 ship configuration ID',
+};
+const CARGO_ID = { ...U16, accepted: 'a u16 cargo ID' };
+const U64 = {
+    min: 0n,
+    max: MAX_U64,
+    accepted: 'an unsigned u64 bigint',
+};
+const I64_COORDINATE = {
+    min: -(2n ** 63n),
+    max: 2n ** 63n - 1n,
+    accepted: 'a signed raw I8F56 coordinate',
+};
+const SEQUENCE = { ...U64, accepted: 'an unsigned u64 sequence' };
+const STARBASE_SEQUENCE = {
+    ...U64,
+    accepted: 'an unsigned u64 Starbase sequence',
+};
+const SYSTEM_GENERATION = {
+    ...U64,
+    accepted: 'an unsigned u64 System generation',
+};
+const CEILING = {
+    ...U64,
+    accepted: 'a nonnegative u64 funding ceiling',
+};
+const LAMPORTS = {
+    ...U64,
+    accepted: 'a nonnegative u64 lamport amount',
+};
+const address = (key) => [key, 'address'];
+const DESCRIBES = ['describes', 'string'];
+const AUTHORIZED = [
+    address('address'),
+    address('game'),
+    address('profile'),
+    address('authority'),
+    address('system'),
+    ['keyIndex', KEY_INDEX],
+];
+const FACTION_TRADE = [
+    address('address'),
+    address('game'),
+    ['factionId', U16],
+    ['schemaVersion', U8],
+    DESCRIBES,
+];
+const schema = (...fields) => ({
+    fields,
+});
+/** Every flat Plan guard kind; nested arrival and runtime guards keep their own readers. */
+const GUARD_SCHEMAS = {
+    'character-registration': schema(address('address'), address('game'), address('profile'), ['profileDataHash', 'hash'], address('funder'), address('xpBudget'), address('xpBudgetConfig'), ['maximumFunderDebit', CEILING], ['characterLamports', LAMPORTS], ['budgetLamports', LAMPORTS], [
+        'characterSize',
+        {
+            min: 423,
+            max: Number.MAX_SAFE_INTEGER,
+            accepted: 'a qualified Character allocation of at least 423 bytes',
+        },
+    ], ['initializationHash', 'hash'], DESCRIBES),
+    'ship-import-funding': schema(address('address'), address('game'), address('profile'), address('system'), ['shipId', SHIP_ID], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'fleet-attack': schema(address('address'), address('defender'), address('game'), address('profile'), address('defenderProfile'), ['instructionKey', 'string'], DESCRIBES),
+    'currency-cache': schema(address('address'), address('game'), DESCRIBES),
+    'region-access': schema(address('address'), address('game'), address('system'), ['accessHash', 'hash'], DESCRIBES),
+    'region-path': schema(address('address'), address('game'), address('fleet'), ['fromX', I64_COORDINATE], ['fromY', I64_COORDINATE], ['toX', I64_COORDINATE], ['toY', I64_COORDINATE], ['pathHash', 'hash'], DESCRIBES),
+    'character-access': schema(address('address'), address('game'), address('profile'), ['stateHash', 'hash'], DESCRIBES),
+    'fleet-docking-policy': schema(address('address'), address('game'), address('system'), address('ownership'), address('starbasePlayer'), DESCRIBES),
+    'starbase-system': schema(address('address'), address('game'), ['starbaseSequenceId', STARBASE_SEQUENCE], [
+        'requireCss',
+        {
+            values: [true],
+            accepted: 'true when CSS access is required, otherwise omitted',
+        },
+        true,
+    ], DESCRIBES),
+    'fleet-mining': schema(address('address'), address('game'), address('profile'), address('asteroid'), DESCRIBES),
+    'faction-treasury-buy-versioned': schema(...FACTION_TRADE, ['cargoId', CARGO_ID], ['floorRaw', U64]),
+    'faction-treasury-sell-versioned': schema(...FACTION_TRADE, ['atlasOutCapPerEpochRaw', U64], [
+        'epochLengthSeconds',
+        { min: -(1n << 63n), max: (1n << 63n) - 1n, accepted: 'an i64 bigint' },
+    ]),
+    'faction-epoch-meter-versioned': schema(...FACTION_TRADE),
+    'fleet-add-ship': schema(...AUTHORIZED, ['shipId', SHIP_ID], [
+        'amount',
+        {
+            min: 1n,
+            max: 255n,
+            accepted: 'a whole ship quantity from 1n through 255n',
+        },
+    ], ['maximumProfileDebit', CEILING], ['configHash', 'hash'], DESCRIBES),
+    'research-unlock': schema(...AUTHORIZED, address('starbasePlayer'), address('currencyCache'), ['nodeId', { ...U16, accepted: 'a u16 research node ID' }], [
+        'level',
+        { ...U32, min: 1, accepted: 'a u32 research node level of at least 1' },
+    ], [
+        'researchSequenceId',
+        { ...U32, accepted: 'a u32 research definition sequence' },
+    ], ['xpSequenceId', { ...U32, accepted: 'a u32 XP definition sequence' }], ['maximumAtlasDebit', CEILING], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'scan-completion': schema([
+        'operation',
+        {
+            values: Object.keys(scanCompletionDiscriminators),
+            accepted: 'a supported scan lifecycle operation',
+        },
+    ], ...[
+        'address',
+        'game',
+        'signal',
+        'profile',
+        'character',
+        'authority',
+        'policy',
+        'loot',
+        'xpBudget',
+        'xpConfig',
+    ].map(address), ['keyIndex', KEY_INDEX], ['status', { min: 1, max: 6, accepted: 'a current nonempty signal state' }], ['expectedSequence', SEQUENCE], ['configHash', 'hash'], DESCRIBES),
+    'scan-detect': schema(...[
+        'address',
+        'game',
+        'profile',
+        'authority',
+        'character',
+        'signal',
+        'pattern',
+        'policy',
+        'loot',
+        'tracker',
+    ].map(address), ['keyIndex', KEY_INDEX], ['patternId', U16], ['focus', { min: 0, max: 4, accepted: 'a scan focus from 0 through 4' }], ['policyRevision', U32], ['profileRevision', U32], ['expectedSequence', SEQUENCE], ['configHash', 'hash'], DESCRIBES),
+    'fleet-crew-transfer': schema(['direction', { values: ['load', 'unload'], accepted: 'load or unload' }], ...AUTHORIZED.slice(0, 5), address('starbasePlayer'), ['count', { min: 1, max: 65535, accepted: 'a positive u16 crew count' }], ['keyIndex', KEY_INDEX], ['systemSequenceId', SYSTEM_GENERATION], DESCRIBES),
+    'fleet-respawn': schema(...AUTHORIZED, ['phase', { values: ['start', 'complete'], accepted: 'start or complete' }], ['fleetHash', 'hash'], ['maximumRecoveryFee', CEILING], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'scan-signal-open': schema(['authorityHash', 'hash'], ...['address', 'game', 'fleet', 'profile', 'authority', 'character'].map(address), ['keyIndex', KEY_INDEX], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'fleet-create': schema(...AUTHORIZED, ['label', 'label'], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'system-account-or-absent': schema(address('address'), DESCRIBES),
+    'recipe-state': schema(address('address'), ['configHash', 'hash'], ['requiredUses', U64], DESCRIBES),
+    'token-mint': schema(address('address'), ['decimals', { ...U8, accepted: 'an unsigned u8 mint decimals value' }], DESCRIBES),
+    'game-ship-config': schema(address('address'), ['shipId', SHIP_ID], ['configHash', 'hash'], DESCRIBES),
+    'game-account': schema(address('address'), DESCRIBES),
+    'token-account': schema(address('address'), address('mint'), address('owner'), ['minimumBalance', U64], DESCRIBES),
+    'game-cargo-bytes-config': schema(address('address'), ['cargoId', CARGO_ID], ['configHash', 'hash'], DESCRIBES),
+    'cargo-cache': schema(address('address'), address('game'), ['bump', { ...U8, accepted: 'a u8 PDA bump' }], DESCRIBES),
+    'token-account-or-absent': schema(address('address'), address('mint'), address('owner'), DESCRIBES),
+    'account-absent': schema(address('address'), DESCRIBES),
+    'account-state': schema(address('address'), ['dataHash', 'hash'], DESCRIBES),
+    'fleet-dock-funding': FLEET_DOCK_FUNDING_SCHEMA,
+    'local-market-order': LOCAL_MARKET_ORDER_SCHEMA,
+    'profile-storage-funding': PROFILE_STORAGE_FUNDING_SCHEMA,
+};
+/** Validates one Plan guard; `wire` decodes its Plan JSON form. */
+export function normalizePrecondition(value, field, wire = false) {
+    const guard = readRecord(value, field);
+    if (guard.kind === 'fleet-arrival')
+        return normalizeArrivalGuard(guard, field, wire);
+    if (isRuntimeGuard(guard))
+        return normalizeRuntimeGuard(guard, field, wire);
+    const kind = guard.kind;
+    if (typeof kind !== 'string' || !Object.hasOwn(GUARD_SCHEMAS, kind))
+        return invalid(`${field}.kind`, kind, 'a supported current Plan guard; recreate the Plan using the current capability planner');
+    return normalizeSchemaGuard(guard, field, GUARD_SCHEMAS[kind], wire);
+}
+//# sourceMappingURL=plan-guards.js.map

package/dist/internal/planning/plan-guards.js.map

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

package/dist/internal/planning/profile-key.d.ts

@@ -0,0 +1,13 @@
+import type { Address } from '@solana/kit';
+import type { ProfileKeyData } from '../c4/identity.js';
+/** The Profile key at `keyIndex` when it belongs to `authority`. Each planner
+ * keeps its own permission predicate and remedy; these helpers share only the
+ * key identity, expiry and scope mechanics. */
+export declare function directProfileKey(keys: readonly ProfileKeyData[], keyIndex: number, authority: Address): ProfileKeyData | undefined;
+/** Whether the key expired before `now`; a negative expiry never expires. */
+export declare function profileKeyExpired(key: ProfileKeyData, now: bigint): boolean;
+/** Whether the key's permission mask holds `bit`, whatever its scope. */
+export declare function hasPermissionBit(key: ProfileKeyData, bit: bigint): boolean;
+/** Whether the key is scoped to `scope` and holds permission `bit` there. */
+export declare function grantsPermission(key: ProfileKeyData, scope: Address, bit: bigint): boolean;
+//# sourceMappingURL=profile-key.d.ts.map

package/dist/internal/planning/profile-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-key.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/profile-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;+CAE+C;AAC/C,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,GACjB,cAAc,GAAG,SAAS,CAG5B;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAET"}

package/dist/internal/planning/profile-key.js

@@ -0,0 +1,20 @@
+/** The Profile key at `keyIndex` when it belongs to `authority`. Each planner
+ * keeps its own permission predicate and remedy; these helpers share only the
+ * key identity, expiry and scope mechanics. */
+export function directProfileKey(keys, keyIndex, authority) {
+    const key = keys[keyIndex];
+    return key?.address === authority ? key : undefined;
+}
+/** Whether the key expired before `now`; a negative expiry never expires. */
+export function profileKeyExpired(key, now) {
+    return key.expiresAtRaw >= 0n && key.expiresAtRaw < now;
+}
+/** Whether the key's permission mask holds `bit`, whatever its scope. */
+export function hasPermissionBit(key, bit) {
+    return (key.permissionsRaw & (1n << bit)) !== 0n;
+}
+/** Whether the key is scoped to `scope` and holds permission `bit` there. */
+export function grantsPermission(key, scope, bit) {
+    return key.scope === scope && hasPermissionBit(key, bit);
+}
+//# sourceMappingURL=profile-key.js.map

package/dist/internal/planning/profile-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-key.js","sourceRoot":"","sources":["../../../src/internal/planning/profile-key.ts"],"names":[],"mappings":"AAIA;;+CAE+C;AAC/C,MAAM,UAAU,gBAAgB,CAC9B,IAA+B,EAC/B,QAAgB,EAChB,SAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,GAAmB,EAAE,GAAW;IAChE,OAAO,GAAG,CAAC,YAAY,IAAI,EAAE,IAAI,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;AAC1D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,GAAmB,EAAE,GAAW;IAC/D,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;AACnD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,GAAmB,EACnB,KAAc,EACd,GAAW;IAEX,OAAO,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC"}

package/dist/internal/planning/profile-storage-funding-guard.d.ts

@@ -0,0 +1,29 @@
+import type { Instruction } from '@solana/kit';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+import { type GuardSchema } from './plan-fields.js';
+/** Bytes one new cargo line (u16 cargo id, u64 amount) adds to a cargo pod. */
+export declare const CARGO_LINE_BYTES = 10;
+/** Instructions whose account storage the Profile funds. Each is evaluated in
+ * Plan order; all but a subwarp stop also carry a funding guard. */
+export type StorageInstruction = 'deposit' | 'starbase-transfer' | 'within-fleet-transfer' | 'start-mining' | 'stop-mining' | 'stop-subwarp' | 'cancel-market-orders' | 'faction-trade' | 'start-subwarp' | 'warp-to-coordinate' | 'warp-lane' | 'start-crafting' | 'cancel-crafting' | 'apply-stimulant' | 'retrieve-loot' | 'recover-signal' | 'place-claim-stake' | 'claim-stake-building-changes' | 'start-claim-stake-transfer' | 'disband';
+/** Which Profile-funded instruction this is, if any, the index of the account
+ * its guard names, whether it carries a guard, and its signing key's index. */
+export declare function storageInstruction(instruction: Instruction): {
+    readonly kind: StorageInstruction;
+    readonly primary: number;
+    readonly guarded: boolean;
+    readonly signer: number;
+} | undefined;
+/** Persisted Profile storage funding of one action: the Profile, signer and
+ * first resized account that bind it to its instruction, and the planned
+ * debit ceiling. Everything else is rederived from the instruction. */
+export type ProfileStorageFundingGuard = Extract<PlanPrecondition, {
+    readonly kind: 'profile-storage-funding';
+}>;
+export declare const PROFILE_STORAGE_FUNDING_SCHEMA: GuardSchema;
+/** Binds every guarded Profile-funded instruction to exactly one storage funding guard
+ * for its Profile, signer and first resized account, so a saved Plan cannot
+ * drop or retarget its funding check; a guard without its instruction is
+ * refused too. */
+export declare function validateProfileStorageFundingGuards(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=profile-storage-funding-guard.d.ts.map

package/dist/internal/planning/profile-storage-funding-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-storage-funding-guard.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/profile-storage-funding-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAwB1E,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;oEACoE;AACpE,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,mBAAmB,GACnB,uBAAuB,GACvB,cAAc,GACd,aAAa,GACb,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,8BAA8B,GAC9B,4BAA4B,GAC5B,SAAS,CAAC;AA6Dd;+EAC+E;AAC/E,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GACvD;IACE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD,SAAS,CAaZ;AAED;;uEAEuE;AACvE,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,gBAAgB,EAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAA;CAAE,CAC7C,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,WAe5C,CAAC;AAEF;;;kBAGkB;AAClB,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CA2BN"}

package/dist/internal/planning/profile-storage-funding-guard.js

@@ -0,0 +1,115 @@
+import { SageSdkError } from '../../client/errors.js';
+import { APPLY_COMBAT_STIMULANT_DISCRIMINATOR, CANCEL_CRAFTING_PROCESS_DISCRIMINATOR, CANCEL_LOCAL_MARKET_ORDERS_DISCRIMINATOR, DEPOSIT_CARGO_TO_GAME_DISCRIMINATOR, DISBAND_FLEET_DISCRIMINATOR, PLACE_CLAIM_STAKE_BUILDINGS_DISCRIMINATOR, PLACE_CLAIM_STAKE_INSTANCE_WITH_HUB_DISCRIMINATOR, RECOVER_SIGNAL_DISCRIMINATOR, RETRIEVE_LOOT_DISCRIMINATOR, START_CLAIM_STAKES_FLEET_TRANSFER_DISCRIMINATOR, START_CRAFTING_PROCESS_DISCRIMINATOR, START_MINING_ASTEROID_DISCRIMINATOR, START_SUBWARP_DISCRIMINATOR, STOP_MINING_ASTEROID_DISCRIMINATOR, STOP_SUBWARP_DISCRIMINATOR, TRADE_FACTION_MARKET_DISCRIMINATOR, TRANSFER_CARGO_TO_FLEET_DISCRIMINATOR, TRANSFER_CARGO_WITHIN_FLEET_DISCRIMINATOR, WARP_LANE_DISCRIMINATOR, WARP_TO_COORDINATE_DISCRIMINATOR, } from '../c4/discriminators.js';
+import { SAGE_PROGRAM_ADDRESS } from '../c4/runtime-bindings.js';
+import { MAX_U64, } from './plan-fields.js';
+/** Bytes one new cargo line (u16 cargo id, u64 amount) adds to a cargo pod. */
+export const CARGO_LINE_BYTES = 10;
+/** Each kind's discriminator, the instruction account index of the first
+ * account it resizes, which names the guard, whether it carries one, and the
+ * index of its signing key, with the Profile at the next account. A subwarp
+ * stop only returns the Fleet to Idle, which releases storage and refunds the
+ * Profile, so it has no guard; it is evaluated so later actions see the
+ * settled Fleet. */
+const STORAGE_INSTRUCTIONS = [
+    ['deposit', DEPOSIT_CARGO_TO_GAME_DISCRIMINATOR, 5, true, 0],
+    ['starbase-transfer', TRANSFER_CARGO_TO_FLEET_DISCRIMINATOR, 4, true, 0],
+    [
+        'within-fleet-transfer',
+        TRANSFER_CARGO_WITHIN_FLEET_DISCRIMINATOR,
+        4,
+        true,
+        0,
+    ],
+    ['start-mining', START_MINING_ASTEROID_DISCRIMINATOR, 4, true, 0],
+    ['stop-mining', STOP_MINING_ASTEROID_DISCRIMINATOR, 5, true, 0],
+    ['stop-subwarp', STOP_SUBWARP_DISCRIMINATOR, 5, false, 0],
+    [
+        'cancel-market-orders',
+        CANCEL_LOCAL_MARKET_ORDERS_DISCRIMINATOR,
+        8,
+        true,
+        0,
+    ],
+    ['faction-trade', TRADE_FACTION_MARKET_DISCRIMINATOR, 8, true, 0],
+    ['start-subwarp', START_SUBWARP_DISCRIMINATOR, 5, true, 0],
+    ['warp-to-coordinate', WARP_TO_COORDINATE_DISCRIMINATOR, 5, true, 0],
+    ['warp-lane', WARP_LANE_DISCRIMINATOR, 5, true, 0],
+    ['start-crafting', START_CRAFTING_PROCESS_DISCRIMINATOR, 9, true, 0],
+    ['cancel-crafting', CANCEL_CRAFTING_PROCESS_DISCRIMINATOR, 7, true, 0],
+    ['apply-stimulant', APPLY_COMBAT_STIMULANT_DISCRIMINATOR, 4, true, 0],
+    ['retrieve-loot', RETRIEVE_LOOT_DISCRIMINATOR, 4, true, 0],
+    ['recover-signal', RECOVER_SIGNAL_DISCRIMINATOR, 5, true, 0],
+    [
+        'place-claim-stake',
+        PLACE_CLAIM_STAKE_INSTANCE_WITH_HUB_DISCRIMINATOR,
+        6,
+        true,
+        1,
+    ],
+    [
+        'claim-stake-building-changes',
+        PLACE_CLAIM_STAKE_BUILDINGS_DISCRIMINATOR,
+        6,
+        true,
+        1,
+    ],
+    [
+        'start-claim-stake-transfer',
+        START_CLAIM_STAKES_FLEET_TRANSFER_DISCRIMINATOR,
+        4,
+        true,
+        0,
+    ],
+    ['disband', DISBAND_FLEET_DISCRIMINATOR, 8, true, 0],
+];
+/** Which Profile-funded instruction this is, if any, the index of the account
+ * its guard names, whether it carries a guard, and its signing key's index. */
+export function storageInstruction(instruction) {
+    if (instruction.programAddress !== SAGE_PROGRAM_ADDRESS)
+        return undefined;
+    const entry = STORAGE_INSTRUCTIONS.find(([, discriminator]) => discriminator.every((byte, index) => instruction.data?.[index] === byte));
+    return (entry && {
+        kind: entry[0],
+        primary: entry[2],
+        guarded: entry[3],
+        signer: entry[4],
+    });
+}
+export const PROFILE_STORAGE_FUNDING_SCHEMA = {
+    fields: [
+        ['address', 'address'],
+        ['profile', 'address'],
+        ['authority', 'address'],
+        [
+            'maximumProfileDebit',
+            {
+                min: 0n,
+                max: MAX_U64,
+                accepted: 'a nonnegative u64 funding ceiling',
+            },
+        ],
+        ['describes', 'string'],
+    ],
+};
+/** Binds every guarded Profile-funded instruction to exactly one storage funding guard
+ * for its Profile, signer and first resized account, so a saved Plan cannot
+ * drop or retarget its funding check; a guard without its instruction is
+ * refused too. */
+export function validateProfileStorageFundingGuards(steps, guards) {
+    const remaining = guards.filter((guard) => guard.kind === 'profile-storage-funding');
+    for (const { instruction } of steps) {
+        const known = storageInstruction(instruction);
+        if (!known?.guarded)
+            continue;
+        const metas = instruction.accounts;
+        const index = remaining.findIndex((guard) => guard.authority === metas?.[known.signer]?.address &&
+            guard.profile === metas[known.signer + 1]?.address &&
+            guard.address === metas[known.primary]?.address);
+        if (index < 0)
+            throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'An instruction that resizes Profile-funded storage has no matching Profile storage funding guard for its Profile, signer and account. Recreate the Plan with its planner.');
+        remaining.splice(index, 1);
+    }
+    if (remaining.length > 0)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'A Profile storage funding guard has no matching instruction. Recreate the Plan with its planner.');
+}
+//# sourceMappingURL=profile-storage-funding-guard.js.map

package/dist/internal/planning/profile-storage-funding-guard.js.map

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

package/dist/internal/planning/profile-storage-funding.d.ts

@@ -0,0 +1,46 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import type { ProfileStorageFundingGuard } from './profile-storage-funding-guard.js';
+export interface ProfileStorageFunding {
+    readonly profileDebit: bigint;
+    readonly profileReserve: bigint;
+}
+/** Refuses a direct Profile key that can fund none of an action's positive
+ * storage debit: the program withdraws it from the Profile vault with the
+ * signing key, which must be Profile AUTH or also hold `drainSolVault` (any
+ * scope). A delegated or certificate key is left to the program. Returns
+ * whether the key is a direct Profile key. */
+export declare function requireStorageFundingKey(input: {
+    readonly profileRaw: RawAccount;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly profileDebit: bigint;
+    readonly action: string;
+}): boolean;
+/** Checks that the signing key and the Profile can fund one action's storage
+ * debit. A zero debit withdraws nothing, so it needs neither `drainSolVault`
+ * nor Profile excess lamports. */
+export declare function checkProfileStorageFunding(input: {
+    readonly profileRaw: RawAccount;
+    readonly rentRaw: RawAccount;
+    readonly authority: Address;
+    readonly keyIndex: number;
+    readonly profileDebit: bigint;
+    readonly action: string;
+    readonly maximumProfileDebit?: bigint;
+}): ProfileStorageFunding & {
+    readonly direct: boolean;
+};
+/** Builds the guard and the summary sentence for one action's storage funding. */
+export declare function profileStorageFundingGuard(input: {
+    readonly address: Address;
+    readonly profile: Address;
+    readonly authority: Address;
+    readonly funding: ProfileStorageFunding & {
+        readonly direct: boolean;
+    };
+}): {
+    readonly guard: ProfileStorageFundingGuard;
+    readonly disclosure: string;
+};
+//# sourceMappingURL=profile-storage-funding.d.ts.map

package/dist/internal/planning/profile-storage-funding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-storage-funding.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/profile-storage-funding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAS5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAMrF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAMD;;;;8CAI8C;AAC9C,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAiBV;AAED;;kCAEkC;AAClC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC,GAAG,qBAAqB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAmBvD;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CACxE,GAAG;IACF,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAiBA"}

package/dist/internal/planning/profile-storage-funding.js

@@ -0,0 +1,58 @@
+import { SageSdkError } from '../../client/errors.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { PROFILE_SCOPE } from '../c4/profile-permissions.js';
+import { directProfileKey, grantsPermission, hasPermissionBit, } from './profile-key.js';
+import { readRent } from './rent.js';
+// Profile drainSolVault permission bit, any scope.
+const DRAIN_SOL_VAULT = 63n;
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+/** Refuses a direct Profile key that can fund none of an action's positive
+ * storage debit: the program withdraws it from the Profile vault with the
+ * signing key, which must be Profile AUTH or also hold `drainSolVault` (any
+ * scope). A delegated or certificate key is left to the program. Returns
+ * whether the key is a direct Profile key. */
+export function requireStorageFundingKey(input) {
+    const key = directProfileKey(profileAccountDefinition.decode(input.profileRaw).keys, input.keyIndex, input.authority);
+    if (input.profileDebit > 0n &&
+        key &&
+        !grantsPermission(key, PROFILE_SCOPE, 0n) &&
+        !hasPermissionBit(key, DRAIN_SOL_VAULT))
+        fail(input.profileRaw.address, `The ${input.action} needs ${input.profileDebit} Profile lamports for account storage, which the program withdraws from the Profile vault with the signing key; this key lacks drainSolVault. Use a direct Profile AUTH key or a key that also holds drainSolVault, then replan.`);
+    return key !== undefined;
+}
+/** Checks that the signing key and the Profile can fund one action's storage
+ * debit. A zero debit withdraws nothing, so it needs neither `drainSolVault`
+ * nor Profile excess lamports. */
+export function checkProfileStorageFunding(input) {
+    const { profileRaw, action, profileDebit } = input;
+    const rent = readRent(input.rentRaw);
+    if (input.maximumProfileDebit !== undefined &&
+        profileDebit > input.maximumProfileDebit)
+        fail(profileRaw.address, `The ${action} now needs ${profileDebit} Profile lamports for account storage, above the ${input.maximumProfileDebit} this Plan approved. An earlier action in the same Plan may use storage it was planned against: execute the actions as separate Plans, or refresh the accounts and replan, then review the storage funding before signing.`);
+    const profileReserve = rent(profileRaw.data.length);
+    const direct = requireStorageFundingKey(input);
+    if (profileDebit > 0n && profileRaw.lamports < profileReserve + profileDebit)
+        fail(profileRaw.address, `The ${action} needs ${profileDebit} Profile lamports for account storage above the Profile's own ${profileReserve}-lamport rent reserve; the Profile holds ${profileRaw.lamports}. Add ${profileReserve + profileDebit - profileRaw.lamports} lamports to the Profile, then replan.`);
+    return { profileDebit, profileReserve, direct };
+}
+/** Builds the guard and the summary sentence for one action's storage funding. */
+export function profileStorageFundingGuard(input) {
+    const { profileDebit } = input.funding;
+    const disclosure = profileDebit > 0n
+        ? `The program funds ${profileDebit} lamports of account storage from Profile ${input.profile}'s vault with the signing key (a locked rent deposit, separate from transaction fees).${input.funding.direct ? '' : ' The selected key is not a direct Profile key, so its drainSolVault permission is checked by the program, not locally.'}`
+        : `This action needs no Profile storage funding at the observed account sizes and balances.`;
+    return {
+        disclosure,
+        guard: {
+            kind: 'profile-storage-funding',
+            address: input.address,
+            profile: input.profile,
+            authority: input.authority,
+            maximumProfileDebit: profileDebit,
+            describes: `Account storage funding from the Profile vault stays at most ${profileDebit} lamports, and the signing key and Profile balance can fund it.`,
+        },
+    };
+}
+//# sourceMappingURL=profile-storage-funding.js.map

package/dist/internal/planning/profile-storage-funding.js.map

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

package/dist/internal/planning/recipe-state.d.ts

@@ -0,0 +1,9 @@
+import type { RawAccount } from '../../client/contracts.js';
+/** Preserve the complete pinned Recipe encoding except its shared usage counter. */
+export declare function hashRecipeConfiguration(account: RawAccount): Promise<string>;
+/** Each Crafting Process start consumes exactly one Recipe use, whatever its
+ * quantity; completing or cancelling an existing job reserves none. A Recipe is
+ * usable only while its usage count is below its limit, so a stored limit of
+ * `0` is never usable. */
+export declare function validateRecipeUsage(account: RawAccount, requiredUses: bigint): void;
+//# sourceMappingURL=recipe-state.d.ts.map

package/dist/internal/planning/recipe-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-state.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/recipe-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAS5D,oFAAoF;AACpF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;0BAG0B;AAC1B,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GACnB,IAAI,CAWN"}

package/dist/internal/planning/recipe-state.js

@@ -0,0 +1,23 @@
+import { SageSdkError } from '../../client/errors.js';
+import { readRecipeName, readRecipeUsage, RECIPE_USAGE_COUNT_OFFSET, } from '../c4/crafting.js';
+import { hashAccountState } from './account-state.js';
+/** Preserve the complete pinned Recipe encoding except its shared usage counter. */
+export async function hashRecipeConfiguration(account) {
+    readRecipeUsage(account);
+    const data = new Uint8Array(account.data);
+    data.fill(0, RECIPE_USAGE_COUNT_OFFSET, RECIPE_USAGE_COUNT_OFFSET + 8);
+    return hashAccountState(account.owner, data);
+}
+/** Each Crafting Process start consumes exactly one Recipe use, whatever its
+ * quantity; completing or cancelling an existing job reserves none. A Recipe is
+ * usable only while its usage count is below its limit, so a stored limit of
+ * `0` is never usable. */
+export function validateRecipeUsage(account, requiredUses) {
+    if (requiredUses === 0n)
+        return;
+    const recipe = readRecipeUsage(account);
+    const remaining = recipe.limit > recipe.count ? recipe.limit - recipe.count : 0n;
+    if (requiredUses > remaining)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Recipe ${readRecipeName(account) || account.address} usage limit has remaining ${remaining}, but a Crafting Process start requested ${requiredUses}. The Recipe's uses are exhausted; choose another active Recipe, then recreate the Plan before retrying.`, { address: account.address });
+}
+//# sourceMappingURL=recipe-state.js.map

package/dist/internal/planning/recipe-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-state.js","sourceRoot":"","sources":["../../../src/internal/planning/recipe-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,cAAc,EACd,eAAe,EACf,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAmB;IAEnB,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,yBAAyB,EAAE,yBAAyB,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;0BAG0B;AAC1B,MAAM,UAAU,mBAAmB,CACjC,OAAmB,EACnB,YAAoB;IAEpB,IAAI,YAAY,KAAK,EAAE;QAAE,OAAO;IAChC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GACb,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,IAAI,YAAY,GAAG,SAAS;QAC1B,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,UAAU,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,8BAA8B,SAAS,4CAA4C,YAAY,0GAA0G,EAC7P,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;AACN,CAAC"}

package/dist/internal/planning/region-access.d.ts

@@ -0,0 +1,30 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import { type RegionTracker } from '../c4/runtime-bindings.js';
+type ExactCoordinate = {
+    readonly x: bigint;
+    readonly y: bigint;
+};
+/** The Regions containing a Star System's coordinate, in tracker order; an
+ * empty list is deep space. The tracker must be the canonical version 0
+ * account. */
+export declare function regionsContainingSystem(tracker: RawAccount, system: RawAccount | undefined, game: Address): Promise<RegionTracker['regions']['unsizedList']>;
+/** Digest of the access data of every Region containing a Star System's
+ * coordinate: id, owner, safety status and risk zone, in tracker order. An
+ * empty list is deep space. Other Regions and their systems may change.
+ */
+export declare function hashRegionAccess(tracker: RawAccount, system: RawAccount | undefined, game: Address): Promise<string>;
+/** A Fleet's exact action coordinate in `game`: its Idle location, or the end
+ * of the warp or subwarp a movement start settles first; `undefined` for any
+ * other state, another Game or a missing Fleet.
+ */
+export declare function fleetActionCoordinate(fleet: RawAccount | undefined, game: Address): ExactCoordinate | undefined;
+/** Digest of the Regions a straight path can touch: the Region count, then the
+ * id, border, bounding box, owner, safety status and risk zone of every Region
+ * whose bounding box overlaps the path's, in tracker order. The tracker must
+ * be the canonical version 0 account; Regions away from the path, and every
+ * Region's systems, may change.
+ */
+export declare function hashRegionPath(tracker: RawAccount, game: Address, from: ExactCoordinate, to: ExactCoordinate): Promise<string>;
+export {};
+//# sourceMappingURL=region-access.d.ts.map

package/dist/internal/planning/region-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-access.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/region-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAQ5D,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAInC,KAAK,eAAe,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAgClE;;cAEc;AACd,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC,CAalD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,IAAI,EAAE,OAAO,GACZ,eAAe,GAAG,SAAS,CAa7B;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,eAAe,GAClB,OAAO,CAAC,MAAM,CAAC,CA+BjB"}