@aephia/atlas-kit 0.0.0

package/dist/mining/index.js

@@ -0,0 +1,236 @@
+import { AccountDecodeError, InvalidDerivationInputError, entityRef, } from '../client/index.js';
+import { celestialBodyAccountDefinition, deriveCelestialBodyAddress, } from '../internal/c4/world.js';
+import { assertCanonicalFleetAddress, discoverFleetAccounts, fleetAccountDefinition, } from '../internal/c4/fleet.js';
+import { requireGameAddress } from '../internal/game-context.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { attachReadMeta, readMeta } from '../internal/read-meta.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+import { resolveCargo, } from '../registry/index.js';
+const DEPOSIT_SNAPSHOTS = new WeakMap();
+const MINING_SNAPSHOTS = new WeakMap();
+function directMetadata(envelope) {
+    return {
+        commitment: envelope.commitment,
+        slot: envelope.slot,
+        source: envelope.source,
+        strategy: 'direct',
+    };
+}
+function assertConfiguredGame(context, accountType, envelope) {
+    const game = requireGameAddress(context);
+    if (envelope.data.game === game)
+        return;
+    throw new AccountDecodeError(accountType, envelope.address, new RangeError(`The decoded ${accountType} references a different Game.`), `The ${accountType} at ${envelope.address} belongs to Game ${envelope.data.game}, not configured Game ${game}. Verify the address, cluster, and pinned binding version before retrying.`);
+}
+async function createResourceDepositSnapshot(context, envelope) {
+    assertConfiguredGame(context, 'celestialBody', envelope);
+    if (envelope.data.kind !== 'asteroid') {
+        throw new AccountDecodeError('celestialBody', envelope.address, new RangeError('The decoded CelestialBody is not an Asteroid.'), `CelestialBody ${envelope.address} is not an Asteroid and has no Fleet-mining resource deposit. Supply an Asteroid address before retrying.`);
+    }
+    const asteroid = envelope.data;
+    const canonicalAddress = await deriveCelestialBodyAddress(asteroid.game, asteroid.id);
+    if (envelope.address !== canonicalAddress) {
+        throw new AccountDecodeError('celestialBody', envelope.address, new RangeError('The decoded Asteroid is stored at a noncanonical CelestialBody address.'), `CelestialBody ${envelope.address} decoded id ${asteroid.id}, whose canonical CelestialBody address is ${canonicalAddress}. Refresh the Asteroid pointer and verify the configured cluster and pinned binding version before retrying.`);
+    }
+    const resources = await Promise.all(asteroid.details.resources.map(async (resource) => ({
+        activeMinerCountRaw: resource.miners,
+        amountMinedUnitsRaw: resource.amountMined,
+        cargo: await resolveCargo(context, resource.cargoId),
+        richness: resource.richness,
+    })));
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+        address: envelope.address,
+        bodyId: asteroid.id,
+        game: asteroid.game,
+        kind: 'resourceDeposit',
+        lastSyncedAtUnixSeconds: asteroid.lastSyncAtUnixSeconds,
+        name: asteroid.name,
+        resources,
+        system: entityRef('starSystem', asteroid.system),
+        systemSequenceId: asteroid.systemSequenceId,
+    }), directMetadata(envelope)));
+}
+function toResourceDepositSnapshot(context, envelope) {
+    const existing = DEPOSIT_SNAPSHOTS.get(envelope);
+    if (existing !== undefined)
+        return existing;
+    const pending = createResourceDepositSnapshot(context, envelope);
+    DEPOSIT_SNAPSHOTS.set(envelope, pending);
+    void pending.catch(() => DEPOSIT_SNAPSHOTS.delete(envelope));
+    return pending;
+}
+/** Reads a required Asteroid resource deposit by CelestialBody address.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const asteroid: Address;
+ * const deposit = await getResourceDeposit(ctx, asteroid);
+ * ```
+ */
+export async function getResourceDeposit(context, asteroid, options) {
+    requireGameAddress(context);
+    return toResourceDepositSnapshot(context, await context.data.read(celestialBodyAccountDefinition, asteroid, options));
+}
+/** Reads an optional Asteroid resource deposit by CelestialBody address.
+ *
+ * Returns `undefined` only when the account does not exist. A present
+ * non-Asteroid CelestialBody throws {@link AccountDecodeError} because it is
+ * not a resource deposit.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const asteroid: Address;
+ * const deposit = await maybeGetResourceDeposit(ctx, asteroid);
+ * ```
+ */
+export async function maybeGetResourceDeposit(context, asteroid, options) {
+    requireGameAddress(context);
+    const [envelope] = await context.data.readMany(celestialBodyAccountDefinition, [asteroid], options);
+    return envelope === undefined
+        ? undefined
+        : toResourceDepositSnapshot(context, envelope);
+}
+/** Derives mining-state age in whole seconds and clamps future timestamps.
+ * @example
+ * ```ts
+ * const age = deriveMiningStateAgeSeconds(100n, 112n); // 12
+ * ```
+ */
+export function deriveMiningStateAgeSeconds(lastUpdatedAtUnixSeconds, atUnixSeconds) {
+    const elapsed = atUnixSeconds - lastUpdatedAtUnixSeconds;
+    return elapsed > 0n ? Number(elapsed) : 0;
+}
+const MINING_DERIVATION_REMEDY = 'Mining derivations require a finite, nonnegative value. Supply a finite value greater than or equal to zero before deriving mining output.';
+/** Derives each selected output rate as Fleet units/second times deposit richness.
+ * @example
+ * ```ts
+ * const rates = deriveMiningOutputRates(2, [{ cargoId: 8, richness: 1.5 }]);
+ * ```
+ */
+export function deriveMiningOutputRates(fleetUnitsPerSecond, outputs) {
+    if (!Number.isFinite(fleetUnitsPerSecond) || fleetUnitsPerSecond < 0) {
+        throw new InvalidDerivationInputError('Fleet mining units per second', fleetUnitsPerSecond, MINING_DERIVATION_REMEDY);
+    }
+    return Object.freeze(outputs.map(({ cargoId, richness }) => {
+        if (!Number.isFinite(richness) || richness < 0) {
+            throw new InvalidDerivationInputError(`Asteroid resource richness for cargo id ${String(cargoId)}`, richness, MINING_DERIVATION_REMEDY);
+        }
+        return Object.freeze({
+            cargoId,
+            unitsPerSecond: fleetUnitsPerSecond * richness,
+        });
+    }));
+}
+/** Projects nominal output units from a rate and elapsed seconds.
+ * @example
+ * ```ts
+ * const units = projectMiningOutputUnits(4.5, 20); // 90
+ * ```
+ */
+export function projectMiningOutputUnits(unitsPerSecond, elapsedSeconds) {
+    if (!Number.isFinite(unitsPerSecond) ||
+        unitsPerSecond < 0 ||
+        !Number.isFinite(elapsedSeconds) ||
+        elapsedSeconds < 0) {
+        const [field, value] = !Number.isFinite(unitsPerSecond) || unitsPerSecond < 0
+            ? ['Mining units per second', unitsPerSecond]
+            : ['Mining elapsed seconds', elapsedSeconds];
+        throw new InvalidDerivationInputError(field, value, MINING_DERIVATION_REMEDY);
+    }
+    return unitsPerSecond * elapsedSeconds;
+}
+function activeMiningState(fleet) {
+    return fleet.state.kind === 'mining' ? fleet.state : undefined;
+}
+function validateSelectedCargoIds(fleetAddress, resourceIds) {
+    for (let index = 1; index < resourceIds.length; index += 1) {
+        if (resourceIds[index - 1] < resourceIds[index])
+            continue;
+        throw new AccountDecodeError('fleet', fleetAddress, new RangeError('Selected mining cargo ids are not canonical.'), `Fleet ${fleetAddress} stores duplicate or unsorted mining cargo ids. Refresh the Fleet and verify the pinned binding version before retrying.`);
+    }
+}
+async function createFleetMiningSnapshot(context, envelope, options) {
+    assertConfiguredGame(context, 'fleet', envelope);
+    const state = activeMiningState(envelope.data);
+    if (state === undefined)
+        return undefined;
+    validateSelectedCargoIds(envelope.address, state.resourceIds);
+    const deposit = await getResourceDeposit(context, state.asteroid, options);
+    const depositByCargoId = new Map(deposit.resources.map((resource) => [resource.cargo.id, resource]));
+    const selected = state.resourceIds.map((cargoId) => {
+        const resource = depositByCargoId.get(cargoId);
+        if (resource !== undefined)
+            return resource;
+        throw new AccountDecodeError('fleet', envelope.address, new RangeError(`Selected cargo id ${cargoId} is absent from the Asteroid.`), `Fleet ${envelope.address} selected cargo id ${cargoId} for mining, but Asteroid ${deposit.address} does not expose that resource. Refresh both accounts and verify the pinned binding version before retrying.`);
+    });
+    const rates = deriveMiningOutputRates(envelope.data.stats.cargo.miningRate.value, selected.map((resource) => ({
+        cargoId: resource.cargo.id,
+        richness: resource.richness.value,
+    })));
+    const outputs = selected.map((resource, index) => ({
+        ...resource,
+        unitsPerSecond: rates[index].unitsPerSecond,
+    }));
+    const depositMeta = readMeta(deposit);
+    const metadata = directMetadata(envelope);
+    return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
+        asteroid: entityRef('celestialBody', state.asteroid),
+        fleet: entityRef('fleet', envelope.address),
+        kind: 'fleetMining',
+        lastUpdatedAtUnixSeconds: envelope.data.lastUpdateAt,
+        miningRate: {
+            raw: envelope.data.stats.cargo.miningRate.raw,
+            unitsPerSecond: envelope.data.stats.cargo.miningRate.value,
+        },
+        outputs,
+        ownerProfile: entityRef('profile', envelope.data.ownerProfile),
+        regionXpModifier: {
+            raw: state.regionXpModifierRaw,
+            value: state.regionXpModifier,
+        },
+    }), {
+        ...metadata,
+        slot: depositMeta.slot < metadata.slot ? depositMeta.slot : metadata.slot,
+    }));
+}
+function toFleetMiningSnapshot(context, envelope, options) {
+    const existing = MINING_SNAPSHOTS.get(envelope);
+    if (existing !== undefined)
+        return existing;
+    const pending = createFleetMiningSnapshot(context, envelope, options);
+    MINING_SNAPSHOTS.set(envelope, pending);
+    void pending.catch(() => MINING_SNAPSHOTS.delete(envelope));
+    return pending;
+}
+/** Reads a Fleet and returns its active extraction relationship, if mining.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleet: Address;
+ * const mining = await getFleetMiningState(ctx, fleet);
+ * ```
+ */
+export async function getFleetMiningState(context, fleet, options) {
+    requireGameAddress(context);
+    const envelope = await context.data.read(fleetAccountDefinition, fleet, options);
+    assertConfiguredGame(context, 'fleet', envelope);
+    await assertCanonicalFleetAddress(envelope);
+    return toFleetMiningSnapshot(context, envelope, options);
+}
+/** Finds active mining Fleets for one owner through stable Fleet filters.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const owner: Address;
+ * const mining = await getFleetMiningStatesByOwner(ctx, owner);
+ * ```
+ */
+export async function getFleetMiningStatesByOwner(context, owner, options) {
+    requireGameAddress(context);
+    const envelopes = await discoverFleetAccounts(context, owner, options);
+    const metadata = readMeta(envelopes);
+    const states = (await Promise.all(envelopes.map((envelope) => toFleetMiningSnapshot(context, envelope, options)))).filter((state) => state !== undefined);
+    return Object.freeze(attachReadMeta(states, metadata));
+}
+//# sourceMappingURL=index.js.map

package/dist/mining/index.js.map

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

package/dist/planning/assembly.d.ts

@@ -0,0 +1,42 @@
+import { type Address, type Commitment, type Transaction, type TransactionWithBlockhashLifetime } from '@solana/kit';
+import type { SageContext, SageWriteRpc } from '../client/contracts.js';
+import type { Plan } from './index.js';
+/** Policy for assembling an unsigned transaction from one Plan.
+ *
+ * @example
+ * ```ts
+ * declare const feePayer: Address;
+ * const policy: AssemblyPolicy = { feePayer, computeUnitLimit: 400_000 };
+ * ```
+ */
+export interface AssemblyPolicy {
+    readonly feePayer: Address;
+    readonly computeUnitLimit?: number;
+    readonly priorityFeeMicroLamports?: bigint;
+    readonly commitment?: Commitment;
+}
+export interface ValidatedAssemblyPolicy {
+    readonly feePayer: Address;
+    readonly computeUnitLimit: number | undefined;
+    readonly priorityFeeMicroLamports: bigint | undefined;
+    readonly commitment: Commitment;
+}
+export declare function requireWriteRpc(context: SageContext): SageWriteRpc;
+export declare function validateAssemblyPolicy(policy: AssemblyPolicy, mapInvalidValue?: (value: unknown) => unknown): ValidatedAssemblyPolicy;
+export declare function validatePlan(plan: unknown): asserts plan is Plan;
+/** Assembles one Plan into an unsigned blockhash-lifetime transaction.
+ *
+ * Assembly validates compute and priority-fee policy before RPC, fetches one
+ * latest blockhash, and never signs, simulates, or submits the transaction.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const plan: Plan;
+ * declare const feePayer: Address;
+ * const transaction = await assemblePlan(ctx, plan, { feePayer });
+ * ```
+ */
+export declare function assemblePlan(context: SageContext, plan: Plan, policy: AssemblyPolicy): Promise<Transaction & TransactionWithBlockhashLifetime>;
+export declare function assembleValidatedPlan(writeRpc: SageWriteRpc, plan: Plan, validatedPolicy: ValidatedAssemblyPolicy): Promise<Transaction & TransactionWithBlockhashLifetime>;
+//# sourceMappingURL=assembly.d.ts.map

package/dist/planning/assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../src/planning/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,EAgBL,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gCAAgC,EACtC,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAevC;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAgCD,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAIlE;AAaD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,eAAe,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAA4B,GAChE,uBAAuB,CAmFzB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAwBhE;AASD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,GAAG,gCAAgC,CAAC,CAIzD;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,uBAAuB,GACvC,OAAO,CAAC,WAAW,GAAG,gCAAgC,CAAC,CAoCzD"}

package/dist/planning/assembly.js

@@ -0,0 +1,141 @@
+import { appendTransactionMessageInstructions, compileTransaction, createTransactionMessage, getTransactionSize, getTransactionSizeLimit, isAddress, isSolanaError, setTransactionMessageComputeUnitLimit, setTransactionMessageComputeUnitPrice, setTransactionMessageFeePayer, setTransactionMessageLifetimeUsingBlockhash, SOLANA_ERROR__TRANSACTION__TOO_MANY_ACCOUNT_ADDRESSES, SOLANA_ERROR__TRANSACTION__TOO_MANY_ACCOUNTS_IN_INSTRUCTION, SOLANA_ERROR__TRANSACTION__TOO_MANY_INSTRUCTIONS, SOLANA_ERROR__TRANSACTION__TOO_MANY_SIGNER_ADDRESSES, } from '@solana/kit';
+import { InvalidActionInputError, SageSdkError } from '../client/errors.js';
+import { validatePlanComposition } from './composition.js';
+import { isPlanInstance } from './plan-instances.js';
+const MAX_COMPUTE_UNIT_LIMIT = 1_400_000;
+const MAX_PRIORITY_FEE_MICRO_LAMPORTS = 18446744073709551615n;
+const DEFAULT_COMMITMENT = 'confirmed';
+const COMPUTE_BUDGET_PROGRAM_ADDRESS = 'ComputeBudget111111111111111111111111111111';
+const TRANSACTION_COMPILE_LIMIT_ERROR_CODES = new Set([
+    SOLANA_ERROR__TRANSACTION__TOO_MANY_ACCOUNT_ADDRESSES,
+    SOLANA_ERROR__TRANSACTION__TOO_MANY_ACCOUNTS_IN_INSTRUCTION,
+    SOLANA_ERROR__TRANSACTION__TOO_MANY_INSTRUCTIONS,
+    SOLANA_ERROR__TRANSACTION__TOO_MANY_SIGNER_ADDRESSES,
+]);
+class MissingWriteTransportError extends SageSdkError {
+    constructor() {
+        super('MISSING_WRITE_TRANSPORT', 'This SAGE context has no writeRpc transport, so it cannot assemble a Plan. Pass the optional writeRpc transport when creating the context, then retry.');
+    }
+}
+class TransactionTooLargeError extends SageSdkError {
+    actualSize;
+    limit;
+    constructor(details) {
+        super('TRANSACTION_TOO_LARGE', details === undefined
+            ? 'The Plan exceeds a z.ink/Solana transaction account, signer, or instruction capacity limit and cannot fit one transaction; split the combined Plan into separately assembled and confirmed Plans before retrying.'
+            : `The assembled transaction is ${String(details.actualSize)} bytes, exceeding the ${String(details.limit)}-byte single-transaction limit; split the combined Plan into separately assembled and confirmed Plans before retrying.`);
+        if (details !== undefined) {
+            this.actualSize = details.actualSize;
+            this.limit = details.limit;
+        }
+    }
+}
+export function requireWriteRpc(context) {
+    const writeRpc = context.writeRpc;
+    if (writeRpc === undefined)
+        throw new MissingWriteTransportError();
+    return writeRpc;
+}
+function invalid(field, value, acceptedRange, remedy) {
+    throw new InvalidActionInputError(field, value, acceptedRange, remedy);
+}
+const retainInvalidValue = (value) => value;
+export function validateAssemblyPolicy(policy, mapInvalidValue = retainInvalidValue) {
+    if (policy === null || typeof policy !== 'object' || Array.isArray(policy)) {
+        invalid('policy', mapInvalidValue(policy), 'an AssemblyPolicy object', 'Pass the fee payer and optional assembly policy fields in one object before retrying.');
+    }
+    const feePayer = policy.feePayer;
+    if (!isAddress(feePayer)) {
+        invalid('feePayer', mapInvalidValue(feePayer), 'a valid base58 z.ink/Solana address', 'Pass the address of the account that will pay the transaction fee before retrying.');
+    }
+    const commitment = policy.commitment ?? DEFAULT_COMMITMENT;
+    if (commitment !== 'processed' &&
+        commitment !== 'confirmed' &&
+        commitment !== 'finalized') {
+        invalid('commitment', mapInvalidValue(commitment), 'processed, confirmed, or finalized', 'Choose a supported z.ink/Solana commitment before retrying.');
+    }
+    const computeUnitLimit = policy.computeUnitLimit;
+    if (computeUnitLimit !== undefined &&
+        (!Number.isInteger(computeUnitLimit) ||
+            computeUnitLimit < 1 ||
+            computeUnitLimit > MAX_COMPUTE_UNIT_LIMIT)) {
+        invalid('computeUnitLimit', mapInvalidValue(computeUnitLimit), 'an integer from 1 through 1400000 compute units', 'Set computeUnitLimit within the finite z.ink/Solana transaction limit before retrying.');
+    }
+    const priorityFeeMicroLamports = policy.priorityFeeMicroLamports;
+    if (priorityFeeMicroLamports !== undefined &&
+        (typeof priorityFeeMicroLamports !== 'bigint' ||
+            priorityFeeMicroLamports < 0n ||
+            priorityFeeMicroLamports > MAX_PRIORITY_FEE_MICRO_LAMPORTS)) {
+        invalid('priorityFeeMicroLamports', mapInvalidValue(priorityFeeMicroLamports), 'a bigint from 0n through 18446744073709551615n micro-lamports per compute unit', 'Set priorityFeeMicroLamports within the unsigned 64-bit range before retrying.');
+    }
+    if (priorityFeeMicroLamports !== undefined &&
+        priorityFeeMicroLamports > 0n &&
+        computeUnitLimit === undefined) {
+        invalid('priorityFeeMicroLamports', mapInvalidValue(priorityFeeMicroLamports), '0n micro-lamports or a non-zero value paired with an explicit computeUnitLimit', 'Set computeUnitLimit so the maximum priority fee is bounded before retrying.');
+    }
+    return {
+        commitment,
+        computeUnitLimit,
+        feePayer,
+        priorityFeeMicroLamports,
+    };
+}
+export function validatePlan(plan) {
+    if (!isPlanInstance(plan)) {
+        invalid('plan', plan, 'a Plan created by createPlan, planFromJSON, or combinePlans', 'Recreate or hydrate the Plan through an approved planning factory before retrying.');
+    }
+    const validatedPlan = plan;
+    validatePlanComposition(validatedPlan.steps);
+    for (let index = 0; index < validatedPlan.steps.length; index += 1) {
+        if (validatedPlan.steps[index]?.instruction.programAddress ===
+            COMPUTE_BUDGET_PROGRAM_ADDRESS) {
+            invalid(`plan.steps[${String(index)}].instruction.programAddress`, COMPUTE_BUDGET_PROGRAM_ADDRESS, 'a non-Compute Budget program address', 'Remove the Plan-carried Compute Budget instruction and express compute limits and priority fees only through the assembly policy before retrying.');
+        }
+    }
+}
+function isTransactionCompileLimitError(cause) {
+    return (isSolanaError(cause) &&
+        TRANSACTION_COMPILE_LIMIT_ERROR_CODES.has(cause.context.__code));
+}
+/** Assembles one Plan into an unsigned blockhash-lifetime transaction.
+ *
+ * Assembly validates compute and priority-fee policy before RPC, fetches one
+ * latest blockhash, and never signs, simulates, or submits the transaction.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const plan: Plan;
+ * declare const feePayer: Address;
+ * const transaction = await assemblePlan(ctx, plan, { feePayer });
+ * ```
+ */
+export async function assemblePlan(context, plan, policy) {
+    validatePlan(plan);
+    const validatedPolicy = validateAssemblyPolicy(policy);
+    return assembleValidatedPlan(requireWriteRpc(context), plan, validatedPolicy);
+}
+export async function assembleValidatedPlan(writeRpc, plan, validatedPolicy) {
+    const { value: lifetime } = await writeRpc
+        .getLatestBlockhash({ commitment: validatedPolicy.commitment })
+        .send();
+    const policyMessage = setTransactionMessageComputeUnitPrice(validatedPolicy.priorityFeeMicroLamports, setTransactionMessageComputeUnitLimit(validatedPolicy.computeUnitLimit, createTransactionMessage({ version: 0 })));
+    const message = setTransactionMessageLifetimeUsingBlockhash(lifetime, setTransactionMessageFeePayer(validatedPolicy.feePayer, appendTransactionMessageInstructions(plan.steps.map((step) => step.instruction), policyMessage)));
+    let transaction;
+    try {
+        transaction = compileTransaction(message);
+    }
+    catch (cause) {
+        if (isTransactionCompileLimitError(cause)) {
+            throw new TransactionTooLargeError();
+        }
+        throw cause;
+    }
+    const actualSize = getTransactionSize(transaction);
+    const limit = getTransactionSizeLimit(transaction);
+    if (actualSize > limit) {
+        throw new TransactionTooLargeError({ actualSize, limit });
+    }
+    return transaction;
+}
+//# sourceMappingURL=assembly.js.map

package/dist/planning/assembly.js.map

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

package/dist/planning/composition.d.ts

@@ -0,0 +1,4 @@
+import type { PlanStep } from './index.js';
+/** Validates the exact opaque semantic facts on one flattened Plan step list. */
+export declare function validatePlanComposition(steps: readonly PlanStep[]): void;
+//# sourceMappingURL=composition.d.ts.map

package/dist/planning/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/planning/composition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,QAAQ,EAAE,MAAM,YAAY,CAAC;AA6E7D,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,CAyCxE"}

package/dist/planning/composition.js

@@ -0,0 +1,76 @@
+import { SageSdkError } from '../client/errors.js';
+const REMEDY = 'Use separate confirmed transactions for these Plans, or use the future W4 sequence API when it becomes available.';
+function describeEffect(fact) {
+    return fact.kind === 'invalidates'
+        ? `invalidation of "${fact.fact}"`
+        : `transition from "${fact.from}" to "${fact.to}"`;
+}
+class IncompatiblePlanCompositionError extends SageSdkError {
+    conflictingFact;
+    conflictingStepDescription;
+    conflictingStepIndex;
+    remedy = REMEDY;
+    requirement;
+    requiringStepDescription;
+    requiringStepIndex;
+    resource;
+    constructor(requirement, requiringStep, requiringStepIndex, conflict) {
+        super('INCOMPATIBLE_PLAN_COMPOSITION', `Plan step ${String(requiringStepIndex)} ("${requiringStep.describes}") requires "${requirement.fact}" for resource "${requirement.resource}", but step ${String(conflict.stepIndex)} ("${conflict.stepDescription}") made it unavailable with its ${describeEffect(conflict.fact)}. ${REMEDY}`);
+        this.conflictingFact = Object.freeze({ ...conflict.fact });
+        this.conflictingStepDescription = conflict.stepDescription;
+        this.conflictingStepIndex = conflict.stepIndex;
+        this.requirement = Object.freeze({ ...requirement });
+        this.requiringStepDescription = requiringStep.describes;
+        this.requiringStepIndex = requiringStepIndex;
+        this.resource = requirement.resource;
+    }
+}
+function getFactState(states, resource, fact) {
+    return states.get(resource)?.get(fact);
+}
+function setFactState(states, resource, fact, state) {
+    let resourceStates = states.get(resource);
+    if (resourceStates === undefined) {
+        resourceStates = new Map();
+        states.set(resource, resourceStates);
+    }
+    resourceStates.set(fact, state);
+}
+/** Validates the exact opaque semantic facts on one flattened Plan step list. */
+export function validatePlanComposition(steps) {
+    const states = new Map();
+    for (let stepIndex = 0; stepIndex < steps.length; stepIndex += 1) {
+        const step = steps[stepIndex];
+        const semantics = step.semantics ?? [];
+        for (const semantic of semantics) {
+            if (semantic.kind !== 'requires')
+                continue;
+            const state = getFactState(states, semantic.resource, semantic.fact);
+            if (state?.available === false) {
+                throw new IncompatiblePlanCompositionError(semantic, step, stepIndex, state.conflict);
+            }
+        }
+        for (const semantic of semantics) {
+            if (semantic.kind === 'requires')
+                continue;
+            const conflict = {
+                fact: semantic,
+                stepDescription: step.describes,
+                stepIndex,
+            };
+            if (semantic.kind === 'invalidates') {
+                setFactState(states, semantic.resource, semantic.fact, {
+                    available: false,
+                    conflict,
+                });
+                continue;
+            }
+            setFactState(states, semantic.resource, semantic.from, {
+                available: false,
+                conflict,
+            });
+            setFactState(states, semantic.resource, semantic.to, { available: true });
+        }
+    }
+}
+//# sourceMappingURL=composition.js.map

package/dist/planning/composition.js.map

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

package/dist/planning/execution.d.ts

@@ -0,0 +1,93 @@
+import { type Commitment, type Signature, type TransactionSigner } from '@solana/kit';
+import type { SageContext } from '../client/contracts.js';
+import type { Plan } from './index.js';
+/** Options for signing, submitting, confirming, and reconciling one Plan.
+ *
+ * @example
+ * ```ts
+ * import type { TransactionSigner } from '@solana/kit';
+ *
+ * declare const feePayer: TransactionSigner;
+ * const options: ExecutePlanOptions = { feePayer };
+ * ```
+ */
+export interface ExecutePlanOptions {
+    readonly feePayer: TransactionSigner;
+    readonly signers?: readonly TransactionSigner[];
+    readonly computeUnitLimit?: number;
+    readonly priorityFeeMicroLamports?: bigint;
+    readonly commitment?: Commitment;
+    readonly timeoutMs?: number;
+    readonly pollIntervalMs?: number;
+}
+/** A transaction confirmed at the requested commitment.
+ *
+ * @example
+ * ```ts
+ * declare const result: ConfirmedPlanExecution;
+ * console.log(result.signature, result.slot);
+ * ```
+ */
+export interface ConfirmedPlanExecution {
+    readonly status: 'confirmed';
+    readonly signature: Signature;
+    readonly slot: bigint;
+    readonly commitment: Commitment;
+}
+/** A submitted transaction whose terminal state remains unknown.
+ *
+ * @example
+ * ```ts
+ * declare const result: UnknownPlanExecution;
+ * console.log(result.signature, result.lastValidBlockHeight);
+ * ```
+ */
+export type UnknownPlanExecution = Readonly<{
+    status: 'unknown';
+    signature: Signature;
+    reason: 'timeout';
+    lastCheckedBlockHeight: bigint;
+    lastValidBlockHeight: bigint | null;
+}> | Readonly<{
+    status: 'unknown';
+    signature: Signature;
+    reason: 'transport-error';
+    operation: 'submission' | 'signature-status' | 'block-height';
+    lastCheckedBlockHeight: bigint | null;
+    lastValidBlockHeight: bigint | null;
+}>;
+/** Every non-throwing terminal outcome from `executePlan`.
+ *
+ * @example
+ * ```ts
+ * declare const result: PlanExecutionResult;
+ * if (result.status === 'unknown') console.log(result.signature);
+ * ```
+ */
+export type PlanExecutionResult = ConfirmedPlanExecution | UnknownPlanExecution;
+/** @internal Lifecycle seam shared only by Plan execution coordinators. */
+export interface PlanExecutionLifecycle {
+    onPrepared(signerMode: 'observable' | 'opaque'): Promise<void>;
+    onBeforeSign(): Promise<void>;
+    onBeforeOpaqueInvoke(): Promise<void>;
+    onSigned(signature: Signature): Promise<void>;
+    onBeforeSubmit(): Promise<void>;
+}
+/** Executes one Plan through local signer matching, freshness re-check, one
+ * submission, terminal confirmation, and confirmed-only cache invalidation.
+ *
+ * @example
+ * ```ts
+ * import type { TransactionSigner } from '@solana/kit';
+ *
+ * declare const ctx: SageContext;
+ * declare const plan: Plan;
+ * declare const feePayer: TransactionSigner;
+ * const result = await executePlan(ctx, plan, { feePayer });
+ * console.log(result.status, result.signature);
+ * ```
+ */
+export declare function executePlan(context: SageContext, plan: Plan, options: ExecutePlanOptions): Promise<PlanExecutionResult>;
+/** @internal Executes one Plan with sequence-owned write-ahead lifecycle hooks. */
+export declare function executePlanWithLifecycle(context: SageContext, plan: Plan, options: ExecutePlanOptions, lifecycle?: PlanExecutionLifecycle): Promise<PlanExecutionResult>;
+//# sourceMappingURL=execution.d.ts.map

package/dist/planning/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/planning/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAYL,KAAK,UAAU,EACf,KAAK,SAAS,EAOd,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,wBAAwB,CAAC;AAMxE,OAAO,KAAK,EAAE,IAAI,EAAoB,MAAM,YAAY,CAAC;AAezD;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,CAAC;IACP,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC,GACF,QAAQ,CAAC;IACP,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,YAAY,GAAG,kBAAkB,GAAG,cAAc,CAAC;IAC9D,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC,CAAC;AAEP;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAYhF,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,UAAU,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAyuBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED,mFAAmF;AACnF,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,kBAAkB,EAC3B,SAAS,CAAC,EAAE,sBAAsB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAgD9B"}