@aephia/atlas-kit 0.6.0-next.11 → 0.6.0-next.110

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

@@ -0,0 +1,168 @@
+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 { 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 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),
+    'movement-character': schema(address('address'), address('game'), address('profile'), ['stateHash', 'hash'], DESCRIBES),
+    'fleet-docking-policy': schema(address('address'), address('game'), address('system'), address('ownership'), 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),
+    '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,
+};
+/** 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/recipe-state.d.ts

@@ -0,0 +1,6 @@
+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>;
+/** Start consumes new uses; completing/cancelling an existing job does not. */
+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,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GACnB,IAAI,CAWN"}

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

@@ -0,0 +1,20 @@
+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);
+}
+/** Start consumes new uses; completing/cancelling an existing job does not. */
+export function validateRecipeUsage(account, requiredUses) {
+    const recipe = readRecipeUsage(account);
+    if (requiredUses === 0n || recipe.limit === 0n)
+        return;
+    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 requested ${requiredUses}. Reduce quantity or 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,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CACjC,OAAmB,EACnB,YAAoB;IAEpB,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,YAAY,KAAK,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE;QAAE,OAAO;IACvD,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,mBAAmB,YAAY,4FAA4F,EACtN,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;AACN,CAAC"}

package/dist/internal/planning/rent.d.ts

@@ -0,0 +1,19 @@
+import type { Address } from '@solana/kit';
+import type { RawAccount } from '../../client/contracts.js';
+import { SageSdkError } from '../../client/errors.js';
+/** Shared exact-range Rent calculation, including the account overhead. */
+export declare function rentMinimumBalance(rate: bigint, threshold: number, length: number, address?: Address): bigint;
+export declare const SYSVAR_OWNER: Address;
+export declare const RENT_ADDRESS: Address;
+/** Validated Rent inputs and the existing minimum-balance callable. */
+export interface RentCalculation {
+    (length: number): bigint;
+    readonly rentLamportsPerByteYear: bigint;
+    readonly rentExemptionThreshold: number;
+}
+export declare function readRent(account: RawAccount): RentCalculation;
+/** Internal estimate-data failure; never used for transport or lifecycle errors. */
+export declare class RentCalculationError extends SageSdkError {
+    constructor(message: string, address: Address);
+}
+//# sourceMappingURL=rent.d.ts.map

package/dist/internal/planning/rent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rent.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/rent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAsB,GAC9B,MAAM,CAcR;AAED,eAAO,MAAM,YAAY,EAC0B,OAAO,CAAC;AAE3D,eAAO,MAAM,YAAY,EAC0B,OAAO,CAAC;AAE3D,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CA6B7D;AAMD,oFAAoF;AACpF,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;CAG9C"}

package/dist/internal/planning/rent.js

@@ -0,0 +1,35 @@
+import { SageSdkError } from '../../client/errors.js';
+/** Shared exact-range Rent calculation, including the account overhead. */
+export function rentMinimumBalance(rate, threshold, length, address = RENT_ADDRESS) {
+    const base = (BigInt(length) + 128n) * rate;
+    const result = Number(base) * threshold;
+    if (base > BigInt(Number.MAX_SAFE_INTEGER) ||
+        !Number.isFinite(result) ||
+        result < 0 ||
+        result > Number.MAX_SAFE_INTEGER)
+        throw new RentCalculationError('Account storage funding exceeds the supported exact calculation range. Use a supported Rent configuration before planning this action.', address);
+    return BigInt(Math.trunc(result));
+}
+export const SYSVAR_OWNER = 'Sysvar1111111111111111111111111111111111111';
+export const RENT_ADDRESS = 'SysvarRent111111111111111111111111111111111';
+export function readRent(account) {
+    if (account.owner !== SYSVAR_OWNER ||
+        account.executable ||
+        account.data.length !== 17)
+        rentFailure('The Rent sysvar has an unexpected owner or layout. Refresh the configured deployment before calculating storage funding.', account.address);
+    const view = new DataView(account.data.buffer, account.data.byteOffset, account.data.byteLength);
+    const rate = view.getBigUint64(0, true), threshold = view.getFloat64(8, true);
+    if (!Number.isFinite(threshold) || threshold < 0 || view.getUint8(16) > 100)
+        rentFailure('The Rent sysvar contains unsupported values. Refresh the deployment or use a supported configuration before planning this action.', account.address);
+    return Object.freeze(Object.assign((length) => rentMinimumBalance(rate, threshold, length, account.address), { rentLamportsPerByteYear: rate, rentExemptionThreshold: threshold }));
+}
+function rentFailure(message, address) {
+    throw new RentCalculationError(message, address);
+}
+/** Internal estimate-data failure; never used for transport or lifecycle errors. */
+export class RentCalculationError extends SageSdkError {
+    constructor(message, address) {
+        super('ACTION_PRECONDITION_FAILED', message, { address });
+    }
+}
+//# sourceMappingURL=rent.js.map

package/dist/internal/planning/rent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rent.js","sourceRoot":"","sources":["../../../src/internal/planning/rent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,SAAiB,EACjB,MAAc,EACd,UAAmB,YAAY;IAE/B,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IACxC,IACE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACtC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxB,MAAM,GAAG,CAAC;QACV,MAAM,GAAG,MAAM,CAAC,gBAAgB;QAEhC,MAAM,IAAI,oBAAoB,CAC5B,wIAAwI,EACxI,OAAO,CACR,CAAC;IACJ,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GACvB,6CAAwD,CAAC;AAE3D,MAAM,CAAC,MAAM,YAAY,GACvB,6CAAwD,CAAC;AAS3D,MAAM,UAAU,QAAQ,CAAC,OAAmB;IAC1C,IACE,OAAO,CAAC,KAAK,KAAK,YAAY;QAC9B,OAAO,CAAC,UAAU;QAClB,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE;QAE1B,WAAW,CACT,0HAA0H,EAC1H,OAAO,CAAC,OAAO,CAChB,CAAC;IACJ,MAAM,IAAI,GAAG,IAAI,QAAQ,CACvB,OAAO,CAAC,IAAI,CAAC,MAAM,EACnB,OAAO,CAAC,IAAI,CAAC,UAAU,EACvB,OAAO,CAAC,IAAI,CAAC,UAAU,CACxB,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,EACrC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,GAAG;QACzE,WAAW,CACT,mIAAmI,EACnI,OAAO,CAAC,OAAO,CAChB,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,MAAM,CACX,CAAC,MAAc,EAAE,EAAE,CACjB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EAC9D,EAAE,uBAAuB,EAAE,IAAI,EAAE,sBAAsB,EAAE,SAAS,EAAE,CACrE,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,OAAgB;IACpD,MAAM,IAAI,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,oFAAoF;AACpF,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YAAY,OAAe,EAAE,OAAgB;QAC3C,KAAK,CAAC,4BAA4B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/internal/planning/respawn-guards.d.ts

@@ -0,0 +1,3 @@
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+export declare function validateRespawnInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=respawn-guards.d.ts.map

package/dist/internal/planning/respawn-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respawn-guards.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/respawn-guards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAO1E,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,IAAI,CA8CN"}

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

@@ -0,0 +1,41 @@
+import { AccountRole } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { IDLE_TO_RESPAWN_DISCRIMINATOR, RESPAWN_TO_DOCKED_DISCRIMINATOR, SAGE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+export function validateRespawnInstructions(steps, guards) {
+    const selected = guards.filter((g) => g.kind === 'fleet-respawn');
+    const recovery = steps.filter(({ instruction: i }) => i.programAddress === SAGE_PROGRAM_ADDRESS &&
+        [IDLE_TO_RESPAWN_DISCRIMINATOR, RESPAWN_TO_DOCKED_DISCRIMINATOR].some((d) => d.every((v, n) => i.data?.[n] === v)));
+    if (!selected.length && !recovery.length)
+        return;
+    const bad = () => {
+        throw new InvalidActionInputError('respawn', undefined, 'one standalone recovery instruction with its matching safeguard', 'Recreate the recovery Plan. Start and timed completion are separate transactions; do not combine recovery with other actions.');
+    };
+    if (steps.length !== 1 || recovery.length !== 1 || selected.length !== 1)
+        bad();
+    const guard = selected[0];
+    const step = recovery[0];
+    const i = step.instruction;
+    const start = guard.phase === 'start';
+    const d = start
+        ? IDLE_TO_RESPAWN_DISCRIMINATOR
+        : RESPAWN_TO_DOCKED_DISCRIMINATOR;
+    const accounts = i.accounts;
+    if (!i.data ||
+        i.data.length !== 10 ||
+        !d.every((v, n) => i.data[n] === v) ||
+        i.data[8] + i.data[9] * 256 !== guard.keyIndex ||
+        accounts?.length !== (start ? 11 : 8) ||
+        step.signers.length !== 1 ||
+        step.signers[0] !== guard.authority)
+        bad();
+    for (const [n, address, role] of [
+        [0, guard.authority, AccountRole.READONLY_SIGNER],
+        [1, guard.profile, AccountRole.WRITABLE],
+        [start ? 5 : 4, guard.address, AccountRole.WRITABLE],
+        [start ? 8 : 5, guard.game, AccountRole.READONLY],
+        [6, guard.system, AccountRole.READONLY],
+    ])
+        if (accounts[n]?.address !== address || accounts[n]?.role !== role)
+            bad();
+}
+//# sourceMappingURL=respawn-guards.js.map

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

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

package/dist/internal/planning/runtime-guards.d.ts

@@ -0,0 +1,41 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+import { type HistoryIntent, type ResolvedDemocracyHistory } from './democracy-history.js';
+import { type XpRuntimeIntent, type XpRuntimeAccounts } from './xp-runtime.js';
+import { resolveGovernanceFees, type FeeIntent } from './governance-fees.js';
+type FeeAccounts = Awaited<ReturnType<typeof resolveGovernanceFees>>['accounts'];
+type BaseGuard = {
+    readonly address: Address;
+    readonly describes: string;
+    readonly dataHash?: never;
+};
+/** Finite runtime eligibility and consumed fee routes, excluding changing balances. */
+export type RuntimeGuard = BaseGuard & ({
+    readonly kind: 'democracy-history';
+    readonly intent: HistoryIntent;
+    readonly accounts: ResolvedDemocracyHistory['accounts'];
+} | {
+    readonly kind: 'xp-runtime';
+    readonly intent: XpRuntimeIntent;
+    readonly accounts: XpRuntimeAccounts;
+} | {
+    readonly kind: 'governance-fees';
+    readonly intent: FeeIntent;
+    readonly accounts: FeeAccounts;
+});
+export type RuntimeWire<T> = T extends bigint ? string : T extends Address ? string : T extends object ? {
+    readonly [K in keyof T]: RuntimeWire<T[K]>;
+} : T;
+export type RuntimeGuardJson = RuntimeWire<RuntimeGuard>;
+export declare function isRuntimeGuard(value: {
+    readonly kind?: unknown;
+}): value is RuntimeGuard;
+/** Strict nested runtime parsing applies both to factory values and persisted JSON. */
+export declare function normalizeRuntimeGuard(value: unknown, field: string, wire?: boolean): RuntimeGuard;
+/** Resolve canonical accounts again; shared balances and XP counters are not compared. */
+export declare function revalidateRuntimeGuards(ctx: SageContext, guards: readonly RuntimeGuard[], freshGameVersions?: Map<Address, number>): Promise<void>;
+/** Old layouts and unguarded persisted instructions fail before assembly or signing. */
+export declare function validateRuntimeInstructions(steps: readonly PlanStep[], preconditions: readonly PlanPrecondition[]): void;
+export {};
+//# sourceMappingURL=runtime-guards.d.ts.map

package/dist/internal/planning/runtime-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-guards.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/runtime-guards.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,OAAO,EAGb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAwB7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAGL,KAAK,aAAa,EAElB,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EAErB,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAE9B,KAAK,WAAW,GAAG,OAAO,CACxB,UAAU,CAAC,OAAO,qBAAqB,CAAC,CACzC,CAAC,UAAU,CAAC,CAAC;AACd,KAAK,SAAS,GAAG;IACf,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AACF,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,SAAS,GAClC,CACI;IACE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC,UAAU,CAAC,CAAC;CACzD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC,CACJ,CAAC;AACJ,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACzC,MAAM,GACN,CAAC,SAAS,OAAO,GACf,MAAM,GACN,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC9C,CAAC,CAAC;AACV,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,KAAK,IAAI,YAAY,CAMxB;AAsLD,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,UAAQ,GACX,YAAY,CAqDd;AAkBD,0FAA0F;AAC1F,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,iBAAiB,uBAA6B,GAC7C,OAAO,CAAC,IAAI,CAAC,CA2Cf;AA8YD,wFAAwF;AACxF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,aAAa,EAAE,SAAS,gBAAgB,EAAE,GACzC,IAAI,CA6IN"}