@aephia/atlas-kit 0.6.0-next.14 → 0.6.0-next.141

package/dist/internal/planning/research-unlock.js

@@ -0,0 +1,287 @@
+import { AccountRole, isOffCurveAddress } from '@solana/kit';
+import { SageSdkError } from '../../client/errors.js';
+import { characterAccountDefinition, findCharacterPda, } from '../c4/character.js';
+import { deriveCurrencyCache, validateCurrencyCache, } from '../c4/currency-cache.js';
+import { UNLOCK_RESEARCH_NODE_DISCRIMINATOR } from '../c4/discriminators.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { PROFILE_SCOPE, SAGE_SCOPE } from '../c4/profile-permissions.js';
+import { PLAYER_PROFILE_PROGRAM_ADDRESS, SAGE_PROGRAM_ADDRESS, } from '../c4/runtime-bindings.js';
+import { deriveStarbasePlayerAddress, starbasePlayerAccountDefinition, } from '../c4/starbase.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../c4/world.js';
+import { CLOCK_ADDRESS, readClock } from './faction-enrollment.js';
+import { directProfileKey, grantsPermission, hasPermissionBit, profileKeyExpired, } from './profile-key.js';
+import { RENT_ADDRESS, readRent } from './rent.js';
+const BASIS_POINTS = 10000n;
+// SAGE doResearch permission bit (SAGE_FLAGS.DO_RESEARCH).
+const DO_RESEARCH = 40n;
+// Profile drainSolVault permission bit, any scope.
+const DRAIN_SOL_VAULT = 63n;
+// Encoded entry sizes of the Character's research sets and maps: a u16 node,
+// tag, cargo category or cargo ID, a u32 node level and a u64 multiplier.
+const NODE_BYTES = 2;
+const NODE_LEVEL_BYTES = 6;
+const TAG_BYTES = 2;
+const CARGO_CATEGORY_BYTES = 2;
+const RARE_MINERAL_BYTES = 10;
+// Pending node levels the program resynchronizes inside an ordinary action.
+const MAX_INLINE_SYNC_NODE_LEVELS = 8;
+const U64_MAX = (1n << 64n) - 1n;
+const CAREERS = {
+    'council-rank': 'councilRank',
+    pilot: 'pilot',
+    'data-runner': 'dataRunner',
+    mining: 'mining',
+    building: 'building',
+    crafting: 'crafting',
+    combat: 'combat',
+};
+const LABELS = {
+    pilot: 'Pilot',
+    'data-runner': 'Data Runner',
+    mining: 'Mining',
+    building: 'Building',
+    crafting: 'Crafting',
+    combat: 'Combat',
+};
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+/** Derives the canonical Character, Starbase Player and Currency Cache. */
+export async function resolveResearchUnlock(intent) {
+    const [character, [currencyCache]] = await Promise.all([
+        findCharacterPda(intent.profile, intent.game),
+        deriveCurrencyCache(intent.game),
+    ]);
+    return {
+        character,
+        starbasePlayer: await deriveStarbasePlayerAddress(intent.system, character),
+        currencyCache,
+        clock: CLOCK_ADDRESS,
+        rent: RENT_ADDRESS,
+    };
+}
+/** Validates one next-level unlock against fresh accounts and Game rules and
+ * returns its exact costs. Planning and execution share every check; an
+ * intent carrying observed sequences and a debit also requires them to hold. */
+export async function validateResearchUnlock(intent, resolved, accounts, rules) {
+    const node = `Research node ${intent.nodeId}`;
+    if (isOffCurveAddress(intent.authority))
+        fail(intent.profile, 'Research requires an on-curve direct Profile authority. Select a current direct key and replan.');
+    const required = (address, name) => {
+        const raw = accounts.get(address);
+        if (!raw || raw.executable)
+            fail(address, `${name} ${address} is missing or executable. Select an existing Character, Star System and Starbase Player, then replan the research unlock.`);
+        return raw;
+    };
+    const profileRaw = required(intent.profile, 'Profile');
+    const characterRaw = required(resolved.character, 'Character');
+    const playerRaw = required(resolved.starbasePlayer, 'Starbase Player');
+    const profile = profileAccountDefinition.decode(profileRaw);
+    const character = characterAccountDefinition.decode(characterRaw);
+    const system = starSystemAccountDefinition.decode(required(intent.system, 'Star System'));
+    const player = starbasePlayerAccountDefinition.decode(playerRaw);
+    await validateCurrencyCache(required(resolved.currencyCache, 'Currency Cache'), intent.game, 'research unlock');
+    const now = readClock(required(resolved.clock, 'Clock sysvar'));
+    const rent = readRent(required(resolved.rent, 'Rent sysvar'));
+    if (character.game !== intent.game ||
+        character.playerProfile !== intent.profile)
+        fail(resolved.character, 'The Character belongs to a different Game or Profile. Refresh the canonical Character and replan the research unlock.');
+    if (system.game !== intent.game ||
+        (await deriveStarSystemAddress(system.game, system.systemId)) !==
+            intent.system ||
+        !system.starbase)
+        fail(intent.system, 'The selected System is not canonical for this Game or has no Starbase. Choose a Starbase System where the Character has a Starbase Player and replan.');
+    if (player.playerProfile !== intent.profile ||
+        player.character !== resolved.character ||
+        player.system !== intent.system)
+        fail(resolved.starbasePlayer, 'The Starbase Player has a different Profile, Character or System. Refresh the canonical Starbase Player and replan.');
+    if (player.sequenceId !== system.sequenceId)
+        fail(resolved.starbasePlayer, `The Starbase Player belongs to Starbase generation ${player.sequenceId}, but the Starbase at System ${intent.system} is at generation ${system.sequenceId}; the program rejects it as destroyed. Choose a System where the Character's Starbase Player is current and replan.`);
+    if ((intent.researchSequenceId !== undefined &&
+        rules.sequenceId !== intent.researchSequenceId) ||
+        (intent.xpSequenceId !== undefined &&
+            rules.xpSequenceId !== intent.xpSequenceId))
+        fail(intent.game, 'The Game research or XP definitions changed after planning. Replan to review the current requirements and costs before signing.');
+    if (character.modifiers.seqId !== rules.sequenceId) {
+        // The program replays every pending unlocked node, each at its stored
+        // level and at least once; with nothing staged, every unlocked node.
+        const { unlockedNodes, nodeLevels, unupdatedCount } = character.modifiers;
+        const pending = unlockedNodes
+            .slice(unupdatedCount === 0
+            ? 0
+            : Math.max(0, unlockedNodes.length - unupdatedCount))
+            .reduce((sum, id) => sum +
+            Math.max(nodeLevels.find(({ nodeId }) => nodeId === id)?.level ?? 1, 1), 0);
+        const state = `The Character's research modifiers predate the current research definitions (sequence ${character.modifiers.seqId} of ${rules.sequenceId}, ${pending} pending node levels)`;
+        fail(resolved.character, pending > MAX_INLINE_SYNC_NODE_LEVELS
+            ? `${state}, more than the ${MAX_INLINE_SYNC_NODE_LEVELS} the program resynchronizes inside an action, so the unlock would fail with characterSyncRequired. Run the permissionless syncCharacter instruction until it reports no remaining nodes, then replan.`
+            : `${state}. The program resynchronizes them at the start of the unlock, but the resulting tags and modifiers decide eligibility, which this SDK does not project. Run any SAGE action that validates the Character, or the permissionless syncCharacter instruction, then replan.`);
+    }
+    if (character.xp.seqId !== rules.xpSequenceId)
+        fail(resolved.character, `The Character's XP levels predate the current XP definitions (sequence ${character.xp.seqId} of ${rules.xpSequenceId}). The program recomputes them from earned XP at the start of the unlock, but the resulting levels decide eligibility, which this SDK does not project. Run any SAGE action that validates the Character, or the permissionless syncCharacter instruction, then replan.`);
+    const rule = rules.rules.find(({ id }) => id === intent.nodeId);
+    if (!rule)
+        fail(intent.game, `${node} is not in the current Game research catalog. Choose a node from getResearchCatalog and replan.`);
+    const unlocked = character.modifiers.unlockedNodes.includes(intent.nodeId);
+    const stored = character.modifiers.nodeLevels.find(({ nodeId }) => nodeId === intent.nodeId)?.level;
+    if (unlocked ? stored === 0 : stored !== undefined)
+        fail(resolved.character, `${node} has an inconsistent stored level on this Character, so its next level is undefined and this SDK does not plan it. Choose another node.`);
+    const current = unlocked ? (stored ?? 1) : 0;
+    if (rule.maxLevel !== 0 && current >= rule.maxLevel)
+        fail(resolved.character, `${node} "${rule.name}" is already at its maximum level ${rule.maxLevel}. Choose another node.`);
+    if (intent.level !== current + 1)
+        fail(resolved.character, `${node} "${rule.name}" is at level ${current}, so an unlock reaches level ${current + 1}, not ${intent.level}. Replan with level ${current + 1}.`);
+    const tags = character.modifiers.values.researchTags;
+    const missing = rule.requiredTagIds.filter((tag) => !tags.includes(tag));
+    if (missing.length > 0)
+        fail(resolved.character, `${node} "${rule.name}" requires every research tag in [${rule.requiredTagIds.join(', ')}]; the Character lacks [${missing.join(', ')}]. Unlock the nodes that grant them first, then replan.`);
+    for (const cost of rule.xpCosts) {
+        const field = CAREERS[cost.category];
+        if (field === undefined)
+            fail(intent.game, `${node} "${rule.name}" costs Daily XP, which this SDK has not qualified for research. Use the game client for this node.`);
+        const xp = character.xp[field];
+        const council = field === 'councilRank';
+        const label = LABELS[cost.category] ?? 'Council Rank';
+        const earn = council ? 'career levels toward Renown' : `${label} XP`;
+        if (xp.level < cost.minimumLevel)
+            fail(resolved.character, `${node} "${rule.name}" requires ${label} level ${cost.minimumLevel}; the Character is at level ${xp.level}. Earn ${earn}, then replan.`);
+        const earned = council ? xp.earned : BigInt(xp.level);
+        const available = earned > xp.spent ? earned - xp.spent : 0n;
+        const unit = council
+            ? 'Renown'
+            : `${label} research point${cost.costRaw === 1n ? '' : 's'}`;
+        if (available < cost.costRaw)
+            fail(resolved.character, `${node} "${rule.name}" costs ${cost.costRaw} ${unit}; the Character has ${available} available. Earn ${earn}, then replan.`);
+    }
+    // The program grows ATLAS and cargo costs linearly with the current level
+    // and rounds down; research point costs do not grow.
+    const growth = BASIS_POINTS + BigInt(rule.costGrowthBasisPoints) * BigInt(current);
+    const grown = (cost, what) => {
+        const scaled = (cost * growth) / BASIS_POINTS;
+        if (scaled > U64_MAX)
+            fail(intent.game, `${node} "${rule.name}" at level ${current} grows its ${what} cost beyond a u64, which the program refuses as numericOverflow. Choose another node.`);
+        return scaled;
+    };
+    const atlasDebit = grown(rule.atlasCostRaw, 'ATLAS');
+    const cargo = rule.cargoCosts.map(({ cargoId, quantityRaw }) => ({
+        cargoId,
+        quantityRaw: grown(quantityRaw, `cargo ${cargoId}`),
+    }));
+    if (intent.maximumAtlasDebit !== undefined &&
+        atlasDebit > intent.maximumAtlasDebit)
+        fail(intent.game, `${node} "${rule.name}" now costs ${atlasDebit} ATLAS Floyds, above the ${intent.maximumAtlasDebit} this Plan approved. Replan and review the cost before signing.`);
+    if (character.atlasRaw < atlasDebit)
+        fail(resolved.character, `${node} "${rule.name}" costs ${atlasDebit} ATLAS Floyds; the Character holds ${character.atlasRaw}. Add ATLAS to the Character, then replan.`);
+    for (const { cargoId, quantityRaw } of cargo) {
+        const held = player.cargo.amounts.find((amount) => amount.cargoId === cargoId)
+            ?.amount ?? 0n;
+        if (held < quantityRaw)
+            fail(resolved.starbasePlayer, `${node} "${rule.name}" consumes ${quantityRaw} of cargo ${cargoId} from the Starbase Player; it holds ${held}. Move that cargo to the Starbase Player at System ${intent.system}, then replan.`);
+    }
+    const values = character.modifiers.values;
+    const fresh = (granted, held) => granted.filter((id) => !held.includes(id)).length;
+    const characterGrowthBytes = (unlocked ? 0 : NODE_BYTES) +
+        (stored === undefined ? NODE_LEVEL_BYTES : 0) +
+        fresh(rule.grants.tagIds, values.researchTags) * TAG_BYTES +
+        fresh(rule.grants.cargoCategoryIds, values.cargoCategories) *
+            CARGO_CATEGORY_BYTES +
+        fresh(rule.grants.rareMineralCargoIds, values.rareMineralDiscovery.map(({ cargoId }) => cargoId)) *
+            RARE_MINERAL_BYTES;
+    const key = directProfileKey(profile.keys, intent.keyIndex, intent.authority);
+    if (!key)
+        fail(intent.profile, 'The selected direct Profile key is absent or belongs to another authority. Select the current key index for this authority and replan.');
+    if (profileKeyExpired(key, now))
+        fail(intent.profile, 'The selected Profile key has expired. Renew it or select a current direct key and replan the research unlock.');
+    const auth = grantsPermission(key, PROFILE_SCOPE, 0n);
+    if (!auth &&
+        !grantsPermission(key, SAGE_SCOPE, DO_RESEARCH) &&
+        !grantsPermission(key, intent.game, DO_RESEARCH))
+        fail(intent.profile, 'The selected key cannot do research. Use a direct Profile AUTH key or a doResearch key scoped to SAGE or this Game, and replan.');
+    const shortfall = (raw, length) => {
+        const minimum = rent(length);
+        return raw.lamports < minimum ? minimum - raw.lamports : 0n;
+    };
+    // The program resizes the Character and funds any shortfall from the
+    // Profile vault, then does the same for the Starbase Player, whose cargo
+    // consumption can only shrink it. Refunds of surplus are not credited.
+    const characterDebit = shortfall(characterRaw, characterRaw.data.length + characterGrowthBytes);
+    const playerDebit = shortfall(playerRaw, playerRaw.data.length);
+    const profileDebit = characterDebit + playerDebit;
+    if (intent.maximumProfileDebit !== undefined &&
+        profileDebit > intent.maximumProfileDebit)
+        fail(intent.profile, `${node} "${rule.name}" now needs ${profileDebit} Profile lamports for Character and Starbase Player storage, above the ${intent.maximumProfileDebit} this Plan approved. Replan and review the storage funding before signing.`);
+    const profileReserve = rent(profileRaw.data.length);
+    if (profileDebit > 0n) {
+        const shortAccounts = [
+            characterDebit > 0n ? `Character ${resolved.character}` : undefined,
+            playerDebit > 0n
+                ? `Starbase Player ${resolved.starbasePlayer}`
+                : undefined,
+        ]
+            .filter((account) => account !== undefined)
+            .join(' and ');
+        if (!auth && !hasPermissionBit(key, DRAIN_SOL_VAULT))
+            fail(intent.profile, `${node} "${rule.name}" needs ${profileDebit} Profile lamports for the storage of ${shortAccounts}, which the program withdraws from the Profile vault with the signing key; this doResearch key lacks drainSolVault. Use a direct Profile AUTH key or a key that also holds drainSolVault, or fund ${shortAccounts} to its rent minimum, then replan.`);
+        if (profileRaw.lamports < profileReserve + profileDebit)
+            fail(intent.profile, `${node} "${rule.name}" needs ${profileDebit} Profile lamports for 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 {
+        rule,
+        level: current + 1,
+        atlasDebit,
+        cargo,
+        points: rule.xpCosts.map(({ category, costRaw }) => ({
+            category,
+            costRaw,
+        })),
+        characterGrowthBytes,
+        profileDebit,
+        profileReserve,
+    };
+}
+function isUnlock(step) {
+    const { instruction } = step;
+    return (instruction.programAddress === SAGE_PROGRAM_ADDRESS &&
+        UNLOCK_RESEARCH_NODE_DISCRIMINATOR.every((byte, index) => instruction.data?.[index] === byte));
+}
+function u16(data, offset) {
+    return data[offset] | (data[offset + 1] << 8);
+}
+/** Binds every research unlock instruction to exactly one persisted guard:
+ * direct key, accounts, roles, key index and node must all match. */
+export function validateResearchUnlockInstructions(steps, preconditions) {
+    const guards = preconditions.filter((guard) => guard.kind === 'research-unlock');
+    const unlocks = steps.filter(isUnlock);
+    const characters = new Set(guards.map(({ address }) => address));
+    if (unlocks.length !== guards.length || characters.size !== guards.length)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Every research unlock instruction requires exactly one matching research-unlock guard, with at most one unlock per Character. Recreate the Plan with planUnlockResearchNode.');
+    const remaining = [...guards];
+    for (const { instruction, signers } of unlocks) {
+        const data = instruction.data;
+        const metas = instruction.accounts;
+        const index = remaining.findIndex((guard) => {
+            const expected = [
+                [guard.authority, AccountRole.READONLY_SIGNER],
+                [guard.profile, AccountRole.WRITABLE],
+                [SAGE_PROGRAM_ADDRESS, AccountRole.READONLY],
+                [PLAYER_PROFILE_PROGRAM_ADDRESS, AccountRole.READONLY],
+                [guard.address, AccountRole.WRITABLE],
+                [guard.game, AccountRole.READONLY],
+                [guard.starbasePlayer, AccountRole.WRITABLE],
+                [guard.system, AccountRole.READONLY],
+                [guard.currencyCache, AccountRole.WRITABLE],
+            ];
+            return (data?.length === 12 &&
+                u16(data, 8) === guard.keyIndex &&
+                u16(data, 10) === guard.nodeId &&
+                metas?.length === expected.length &&
+                expected.every(([address, role], at) => metas[at].address === address && metas[at].role === role) &&
+                signers.length === 1 &&
+                signers[0] === guard.authority);
+        });
+        if (index < 0)
+            throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'A research unlock instruction does not match its persisted Profile key, Character, Starbase Player, System, Currency Cache or node. Recreate the Plan with planUnlockResearchNode.');
+        remaining.splice(index, 1);
+    }
+}
+//# sourceMappingURL=research-unlock.js.map

package/dist/internal/planning/research-unlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-unlock.js","sourceRoot":"","sources":["../../../src/internal/planning/research-unlock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAsDnD,MAAM,YAAY,GAAG,MAAO,CAAC;AAC7B,2DAA2D;AAC3D,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,mDAAmD;AACnD,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,6EAA6E;AAC7E,0EAA0E;AAC1E,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,4EAA4E;AAC5E,MAAM,2BAA2B,GAAG,CAAC,CAAC;AACtC,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AACjC,MAAM,OAAO,GAOT;IACF,cAAc,EAAE,aAAa;IAC7B,KAAK,EAAE,OAAO;IACd,aAAa,EAAE,YAAY;IAC3B,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;CACjB,CAAC;AACF,MAAM,MAAM,GAAsD;IAChE,KAAK,EAAE,OAAO;IACd,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,SAAS,IAAI,CAAC,OAAgB,EAAE,OAAe;IAC7C,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAI3C;IACC,MAAM,CAAC,SAAS,EAAE,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrD,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;QAC7C,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;KACjC,CAAC,CAAC;IACH,OAAO;QACL,SAAS;QACT,cAAc,EAAE,MAAM,2BAA2B,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3E,aAAa;QACb,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,YAAY;KACnB,CAAC;AACJ,CAAC;AAED;;gFAEgF;AAChF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAA4B,EAC5B,QAAgC,EAChC,QAAsD,EACtD,KAIC;IAED,MAAM,IAAI,GAAG,iBAAiB,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9C,IAAI,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC;QACrC,IAAI,CACF,MAAM,CAAC,OAAO,EACd,iGAAiG,CAClG,CAAC;IACJ,MAAM,QAAQ,GAAG,CAAC,OAAgB,EAAE,IAAY,EAAc,EAAE;QAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU;YACxB,IAAI,CACF,OAAO,EACP,GAAG,IAAI,IAAI,OAAO,4HAA4H,CAC/I,CAAC;QACJ,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAC/C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CACvC,CAAC;IACF,MAAM,MAAM,GAAG,+BAA+B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,qBAAqB,CACzB,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC,EAClD,MAAM,CAAC,IAAI,EACX,iBAAiB,CAClB,CAAC;IACF,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9D,IACE,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC9B,SAAS,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO;QAE1C,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,uHAAuH,CACxH,CAAC;IACJ,IACE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC3B,CAAC,MAAM,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3D,MAAM,CAAC,MAAM;QACf,CAAC,MAAM,CAAC,QAAQ;QAEhB,IAAI,CACF,MAAM,CAAC,MAAM,EACb,uJAAuJ,CACxJ,CAAC;IACJ,IACE,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO;QACvC,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS;QACvC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAE/B,IAAI,CACF,QAAQ,CAAC,cAAc,EACvB,qHAAqH,CACtH,CAAC;IACJ,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;QACzC,IAAI,CACF,QAAQ,CAAC,cAAc,EACvB,sDAAsD,MAAM,CAAC,UAAU,gCAAgC,MAAM,CAAC,MAAM,qBAAqB,MAAM,CAAC,UAAU,qHAAqH,CAChR,CAAC;IACJ,IACE,CAAC,MAAM,CAAC,kBAAkB,KAAK,SAAS;QACtC,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,kBAAkB,CAAC;QACjD,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS;YAChC,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY,CAAC;QAE7C,IAAI,CACF,MAAM,CAAC,IAAI,EACX,iIAAiI,CAClI,CAAC;IACJ,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;QACnD,sEAAsE;QACtE,qEAAqE;QACrE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC;QAC1E,MAAM,OAAO,GAAG,aAAa;aAC1B,KAAK,CACJ,cAAc,KAAK,CAAC;YAClB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,cAAc,CAAC,CACvD;aACA,MAAM,CACL,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CACV,GAAG;YACH,IAAI,CAAC,GAAG,CACN,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC,EAC1D,CAAC,CACF,EACH,CAAC,CACF,CAAC;QACJ,MAAM,KAAK,GAAG,yFAAyF,SAAS,CAAC,SAAS,CAAC,KAAK,OAAO,KAAK,CAAC,UAAU,KAAK,OAAO,uBAAuB,CAAC;QAC3L,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,OAAO,GAAG,2BAA2B;YACnC,CAAC,CAAC,GAAG,KAAK,mBAAmB,2BAA2B,uMAAuM;YAC/P,CAAC,CAAC,GAAG,KAAK,yQAAyQ,CACtR,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,YAAY;QAC3C,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,0EAA0E,SAAS,CAAC,EAAE,CAAC,KAAK,OAAO,KAAK,CAAC,YAAY,yQAAyQ,CAC/X,CAAC;IACJ,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC,IAAI;QACP,IAAI,CACF,MAAM,CAAC,IAAI,EACX,GAAG,IAAI,iGAAiG,CACzG,CAAC;IACJ,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAChD,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CACzC,EAAE,KAAK,CAAC;IACT,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS;QAChD,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,GAAG,IAAI,yIAAyI,CACjJ,CAAC;IACJ,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ;QACjD,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,qCAAqC,IAAI,CAAC,QAAQ,wBAAwB,CAChG,CAAC;IACJ,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,GAAG,CAAC;QAC9B,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,iBAAiB,OAAO,gCAAgC,OAAO,GAAG,CAAC,SAAS,MAAM,CAAC,KAAK,uBAAuB,OAAO,GAAG,CAAC,GAAG,CACnJ,CAAC;IACJ,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACpB,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,qCAAqC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,yDAAyD,CAC/L,CAAC;IACJ,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS;YACrB,IAAI,CACF,MAAM,CAAC,IAAI,EACX,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,qGAAqG,CAC3H,CAAC;QACJ,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,KAAK,KAAK,aAAa,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC;QACrE,IAAI,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY;YAC9B,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,cAAc,KAAK,UAAU,IAAI,CAAC,YAAY,+BAA+B,EAAE,CAAC,KAAK,UAAU,IAAI,gBAAgB,CACzI,CAAC;QACJ,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,GAAG,KAAK,kBAAkB,IAAI,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/D,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO;YAC1B,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,OAAO,IAAI,IAAI,uBAAuB,SAAS,oBAAoB,IAAI,gBAAgB,CAC7H,CAAC;IACN,CAAC;IACD,0EAA0E;IAC1E,qDAAqD;IACrD,MAAM,MAAM,GACV,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,YAAY,CAAC;QAC9C,IAAI,MAAM,GAAG,OAAO;YAClB,IAAI,CACF,MAAM,CAAC,IAAI,EACX,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,cAAc,OAAO,cAAc,IAAI,wFAAwF,CACrJ,CAAC;QACJ,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/D,OAAO;QACP,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,OAAO,EAAE,CAAC;KACpD,CAAC,CAAC,CAAC;IACJ,IACE,MAAM,CAAC,iBAAiB,KAAK,SAAS;QACtC,UAAU,GAAG,MAAM,CAAC,iBAAiB;QAErC,IAAI,CACF,MAAM,CAAC,IAAI,EACX,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,eAAe,UAAU,4BAA4B,MAAM,CAAC,iBAAiB,iEAAiE,CACpK,CAAC;IACJ,IAAI,SAAS,CAAC,QAAQ,GAAG,UAAU;QACjC,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,WAAW,UAAU,sCAAsC,SAAS,CAAC,QAAQ,4CAA4C,CAC/I,CAAC;IACJ,KAAK,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;QAC7C,MAAM,IAAI,GACR,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC;YAC/D,EAAE,MAAM,IAAI,EAAE,CAAC;QACnB,IAAI,IAAI,GAAG,WAAW;YACpB,IAAI,CACF,QAAQ,CAAC,cAAc,EACvB,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,cAAc,WAAW,aAAa,OAAO,uCAAuC,IAAI,sDAAsD,MAAM,CAAC,MAAM,gBAAgB,CACjM,CAAC;IACN,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,OAA0B,EAAE,IAAuB,EAAE,EAAE,CACpE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACpD,MAAM,oBAAoB,GACxB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAC3B,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS;QAC1D,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,eAAe,CAAC;YACzD,oBAAoB;QACtB,KAAK,CACH,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAC/B,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAC1D;YACC,kBAAkB,CAAC;IACvB,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG;QACN,IAAI,CACF,MAAM,CAAC,OAAO,EACd,wIAAwI,CACzI,CAAC;IACJ,IAAI,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC;QAC7B,IAAI,CACF,MAAM,CAAC,OAAO,EACd,+GAA+G,CAChH,CAAC;IACJ,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;IACtD,IACE,CAAC,IAAI;QACL,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC;QAC/C,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC;QAEhD,IAAI,CACF,MAAM,CAAC,OAAO,EACd,iIAAiI,CAClI,CAAC;IACJ,MAAM,SAAS,GAAG,CAAC,GAAe,EAAE,MAAc,EAAE,EAAE;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC,CAAC;IACF,qEAAqE;IACrE,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,cAAc,GAAG,SAAS,CAC9B,YAAY,EACZ,YAAY,CAAC,IAAI,CAAC,MAAM,GAAG,oBAAoB,CAChD,CAAC;IACF,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,cAAc,GAAG,WAAW,CAAC;IAClD,IACE,MAAM,CAAC,mBAAmB,KAAK,SAAS;QACxC,YAAY,GAAG,MAAM,CAAC,mBAAmB;QAEzC,IAAI,CACF,MAAM,CAAC,OAAO,EACd,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,eAAe,YAAY,0EAA0E,MAAM,CAAC,mBAAmB,4EAA4E,CACjO,CAAC;IACJ,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,aAAa,GAAG;YACpB,cAAc,GAAG,EAAE,CAAC,CAAC,CAAC,aAAa,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;YACnE,WAAW,GAAG,EAAE;gBACd,CAAC,CAAC,mBAAmB,QAAQ,CAAC,cAAc,EAAE;gBAC9C,CAAC,CAAC,SAAS;SACd;aACE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC;aAC1C,IAAI,CAAC,OAAO,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,eAAe,CAAC;YAClD,IAAI,CACF,MAAM,CAAC,OAAO,EACd,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,WAAW,YAAY,wCAAwC,aAAa,qMAAqM,aAAa,oCAAoC,CACxV,CAAC;QACJ,IAAI,UAAU,CAAC,QAAQ,GAAG,cAAc,GAAG,YAAY;YACrD,IAAI,CACF,MAAM,CAAC,OAAO,EACd,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,WAAW,YAAY,yDAAyD,cAAc,4CAA4C,UAAU,CAAC,QAAQ,SAAS,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC,QAAQ,wCAAwC,CACvR,CAAC;IACN,CAAC;IACD,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,OAAO,GAAG,CAAC;QAClB,UAAU;QACV,KAAK;QACL,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,QAAQ;YACR,OAAO;SACR,CAAC,CAAC;QACH,oBAAoB;QACpB,YAAY;QACZ,cAAc;KACf,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAc;IAC9B,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC7B,OAAO,CACL,WAAW,CAAC,cAAc,KAAK,oBAAoB;QACnD,kCAAkC,CAAC,KAAK,CACtC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CACpD,CACF,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,IAAuB,EAAE,MAAc;IAClD,OAAO,IAAI,CAAC,MAAM,CAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;qEACqE;AACrE,MAAM,UAAU,kCAAkC,CAChD,KAA0B,EAC1B,aAA0C;IAE1C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CACjC,CAAC,KAAK,EAAgC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAC1E,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QACvE,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,8KAA8K,CAC/K,CAAC;IACJ,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC9B,KAAK,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;QAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC;QACnC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1C,MAAM,QAAQ,GAAG;gBACf,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC;gBAC9C,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;gBACrC,CAAC,oBAAoB,EAAE,WAAW,CAAC,QAAQ,CAAC;gBAC5C,CAAC,8BAA8B,EAAE,WAAW,CAAC,QAAQ,CAAC;gBACtD,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;gBACrC,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC;gBAClC,CAAC,KAAK,CAAC,cAAc,EAAE,WAAW,CAAC,QAAQ,CAAC;gBAC5C,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;gBACpC,CAAC,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC,QAAQ,CAAC;aACnC,CAAC;YACX,OAAO,CACL,IAAI,EAAE,MAAM,KAAK,EAAE;gBACnB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ;gBAC/B,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM;gBAC9B,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC,MAAM;gBACjC,QAAQ,CAAC,KAAK,CACZ,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CACtB,KAAK,CAAC,EAAE,CAAE,CAAC,OAAO,KAAK,OAAO,IAAI,KAAK,CAAC,EAAE,CAAE,CAAC,IAAI,KAAK,IAAI,CAC7D;gBACD,OAAO,CAAC,MAAM,KAAK,CAAC;gBACpB,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,SAAS,CAC/B,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,GAAG,CAAC;YACX,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,oLAAoL,CACrL,CAAC;QACJ,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

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,42 @@
+import { AccountRole } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { SAGE_PROGRAM_ADDRESS } from '../c4/runtime-bindings.js';
+import { IDLE_TO_RESPAWN_DISCRIMINATOR, RESPAWN_TO_DOCKED_DISCRIMINATOR, } from '../c4/discriminators.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":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,2BAA2B,CACzC,KAA0B,EAC1B,MAAmC;IAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAC3B,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CACrB,CAAC,CAAC,cAAc,KAAK,oBAAoB;QACzC,CAAC,6BAA6B,EAAE,+BAA+B,CAAC,CAAC,IAAI,CACnE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAC5C,CACJ,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO;IACjD,MAAM,GAAG,GAAG,GAAU,EAAE;QACtB,MAAM,IAAI,uBAAuB,CAC/B,SAAS,EACT,SAAS,EACT,iEAAiE,EACjE,+HAA+H,CAChI,CAAC;IACJ,CAAC,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QACtE,GAAG,EAAE,CAAC;IACR,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;IAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC;IACtC,MAAM,CAAC,GAAG,KAAK;QACb,CAAC,CAAC,6BAA6B;QAC/B,CAAC,CAAC,+BAA+B,CAAC;IACpC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC5B,IACE,CAAC,CAAC,CAAC,IAAI;QACP,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE;QACpB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,GAAG,KAAK,KAAK,CAAC,QAAQ;QAChD,QAAQ,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,SAAS;QAEnC,GAAG,EAAE,CAAC;IACR,KAAK,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI;QAC/B,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,eAAe,CAAC;QACjD,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;QACxC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;QACpD,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC;QACjD,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;KAC/B;QACR,IAAI,QAAS,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,IAAI,QAAS,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,IAAI;YAAE,GAAG,EAAE,CAAC;AAChF,CAAC"}

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;AAgB7D,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;AAc9B,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;AAmbD,wFAAwF;AACxF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,aAAa,EAAE,SAAS,gBAAgB,EAAE,GACzC,IAAI,CA6IN"}