@aephia/atlas-kit 0.6.0-next.7 → 0.6.0-next.70

package/dist/mining/actions/index.js

@@ -0,0 +1,328 @@
+import { resolveXpRuntime } from '../../internal/planning/xp-runtime.js';
+import { matchesFleetMiningState } from '../../internal/planning/mining-stop.js';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { sage } from '../../internal/c4/bindings.js';
+import { deriveFleetAddress, fleetAccountDefinition, } from '../../internal/c4/fleet.js';
+import { characterAccountDefinition, findCharacterPda, } from '../../internal/c4/identity.js';
+import { deriveRegionTrackerAddress, regionTrackerAccountDefinition, } from '../../internal/c4/factions.js';
+import { celestialBodyAccountDefinition, deriveCelestialBodyAddress, deriveStarSystemAddress, starSystemAccountDefinition, } from '../../internal/c4/world.js';
+import { deriveFleetCrewBindingAddress, fleetCrewBindingAccountDefinition, matchesFleetCrewBindingIdentity, } from '../../internal/c4/fleet-crew-binding.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { adaptStartMiningAsteroidInstruction, adaptStopMiningAsteroidInstruction, validatePlanAuthorization, } from '../../internal/planning/authorization-adapter.js';
+import { createPlan } from '../../planning/index.js';
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+const remedies = {
+    docked: 'Undock the Fleet',
+    mining: 'Stop mining with planFleetStopMining',
+    respawn: 'Wait for the Fleet to recover',
+    destroyed: 'Respawn the Fleet through an appropriate game client',
+    claimStakeTransfer: 'Finish the Claim Stake transfer',
+};
+function actionCoordinate(fleet) {
+    if (fleet.state.kind === 'idle')
+        return fleet.location;
+    if (fleet.state.kind === 'warp' || fleet.state.kind === 'subwarp')
+        return fleet.state.to;
+    return fail(fleet.address, `Fleet ${fleet.name} is ${fleet.state.kind} and cannot start mining. ${remedies[fleet.state.kind]}, refresh the Fleet, and retry from idle or a warp/subwarp arrival at the Asteroid's Star System.`);
+}
+function validateOptionsObject(value, field) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new InvalidActionInputError(field, value, 'an object containing the mining action options or Profile authorization', `Supply ${field} with the documented mining action fields before retrying.`);
+    }
+}
+function validateResources(ids, available) {
+    if (!Array.isArray(ids) || ids.length === 0) {
+        throw new InvalidActionInputError('resourceIds', ids, 'a dense non-empty ascending list of deposit cargo ids', 'Supply at least one resource cargo id from the Asteroid deposit before retrying.');
+    }
+    for (let i = 0; i < ids.length; i += 1) {
+        const id = ids[i];
+        if (!Object.hasOwn(ids, i) ||
+            !Number.isInteger(id) ||
+            id < 0 ||
+            id > 65535 ||
+            (i > 0 && ids[i - 1] >= id) ||
+            !available.includes(id)) {
+            throw new InvalidActionInputError('resourceIds', ids, 'unique ascending u16 cargo ids selected from the deposit', 'Select resource cargo ids present in the Asteroid deposit, remove holes and duplicates, and sort them in ascending order before retrying.');
+        }
+    }
+}
+function required(account, address, label) {
+    if (account === undefined) {
+        return fail(address, `${label} is missing or returned at a different address. Refresh the Fleet and Asteroid dependencies in the configured Game and retry.`);
+    }
+    return account;
+}
+/** Plans one inert Fleet mining start at an Asteroid, without signing or simulation.
+ *
+ * Idle Fleets use their current coordinate; warp/subwarp Fleets use their arrival
+ * coordinate, never a local clock. This planner emits only the mining instruction.
+ * Direct mining needs Idle. Settle travel through a supported game route, then
+ * refresh an Idle Fleet before planning mining. planFleetSettleArrival supports
+ * completed current-runtime subwarp with direct Profile authorization; it does
+ * not support warp. Current-runtime settlement-plus-mining composition has not
+ * been qualified. Idle Fleets do not need the settlement step.
+ * Simulate the complete Plan before execution; arrival, permissions, range, fuel,
+ * and mining eligibility remain program-authoritative. This planner neither
+ * estimates mining output nor stops mining. No FleetCrewBinding account exists
+ * in the pinned ten-account instruction.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleet: FleetSnapshot;
+ * declare const authorization: PlanAuthorization;
+ * declare const asteroid: ResourceDepositSnapshot;
+ * const plan = await planFleetStartMining(ctx, fleet, { authorization, asteroid, resourceIds: [8] });
+ * ```
+ */
+export async function planFleetStartMining(ctx, fleet, options) {
+    const game = requireGameAddress(ctx);
+    validateOptionsObject(options, 'options');
+    validateOptionsObject(options.authorization, 'authorization');
+    const { asteroid } = options;
+    const authorization = {
+        profile: options.authorization.profile,
+        authority: options.authorization.authority,
+        keyIndex: options.authorization.keyIndex,
+        ...(options.authorization.certificate === undefined
+            ? {}
+            : { certificate: options.authorization.certificate }),
+    };
+    validatePlanAuthorization(authorization);
+    const coordinate = actionCoordinate(fleet);
+    const movingSnapshot = fleet.state.kind !== 'idle';
+    if (fleet.game !== game ||
+        asteroid.game !== game ||
+        fleet.ownerProfile.address !== authorization.profile) {
+        fail(fleet.address, `Fleet ${fleet.name} and Asteroid ${asteroid.name} must belong to configured Game ${game}, and the Fleet must belong to authorized Profile ${authorization.profile}. Choose the owning Profile and matching Game, refresh both snapshots, and retry.`);
+    }
+    validateResources(options.resourceIds, asteroid.resources.map((r) => r.cargo.id));
+    // Copy before any asynchronous reads so caller mutation cannot change selection.
+    const resourceIds = [...options.resourceIds];
+    const character = await findCharacterPda(authorization.profile, game);
+    const regionTracker = await deriveRegionTrackerAddress(game);
+    const addresses = [
+        fleet.address,
+        asteroid.address,
+        asteroid.system.address,
+        character,
+        regionTracker,
+    ];
+    const values = await readContextRawAccounts(ctx, addresses);
+    const labels = [
+        'Fleet',
+        'Asteroid',
+        'Star System',
+        'Character',
+        'RegionTracker',
+    ];
+    const accounts = addresses.map((address, index) => required(values[index], address, labels[index]));
+    const [fleetAccount, asteroidAccount, systemAccount, characterAccount, trackerAccount,] = accounts;
+    const current = fleetAccountDefinition.decode(fleetAccount);
+    const currentCoordinate = current.state.kind === 'idle'
+        ? current.location
+        : current.state.kind === 'warp' || current.state.kind === 'subwarp'
+            ? current.state.to
+            : undefined;
+    if (current.game !== game ||
+        current.ownerProfile !== authorization.profile ||
+        (await deriveFleetAddress(current)) !== fleet.address ||
+        (current.state.kind !== fleet.state.kind &&
+            !(current.state.kind === 'idle' &&
+                (fleet.state.kind === 'warp' || fleet.state.kind === 'subwarp'))) ||
+        currentCoordinate?.x !== coordinate.x ||
+        currentCoordinate?.y !== coordinate.y) {
+        fail(fleet.address, `Fleet ${fleet.name} no longer matches its Game, Profile, canonical address, state, or mining coordinate. Refresh the Fleet and create a new mining Plan before retrying.`);
+    }
+    const deposit = celestialBodyAccountDefinition.decode(asteroidAccount);
+    if (deposit.kind !== 'asteroid' ||
+        deposit.game !== game ||
+        deposit.id !== asteroid.bodyId ||
+        (await deriveCelestialBodyAddress(game, deposit.id)) !== asteroid.address ||
+        deposit.system !== asteroid.system.address) {
+        fail(asteroid.address, `Asteroid ${asteroid.name} no longer matches its Game, canonical address, or Star System. Refresh the resource deposit and choose an Asteroid in the Fleet's current or arrival Star System before retrying.`);
+    }
+    validateResources(resourceIds, deposit.details.resources.map((r) => r.cargoId));
+    const system = starSystemAccountDefinition.decode(systemAccount);
+    if (system.game !== game ||
+        (await deriveStarSystemAddress(game, system.systemId)) !==
+            systemAccount.address) {
+        fail(systemAccount.address, 'Star System does not match its Game or canonical address. Refresh the Asteroid and Star System in the configured Game before retrying.');
+    }
+    // Compare stored fixed-point coordinates, not rounded display numbers.
+    const exactFleet = sage.getFleetDecoder().decode(fleetAccount.data);
+    const exactCoordinate = exactFleet.state.__kind === 'MoveWarp'
+        ? exactFleet.state.fields[0].to
+        : exactFleet.state.__kind === 'MoveSubwarp'
+            ? exactFleet.state.fields[0].journey.to
+            : exactFleet.location;
+    const exactSystem = sage.getStarSystemDecoder().decode(systemAccount.data);
+    if (exactCoordinate[0].raw !== exactSystem.coordinates[0].raw ||
+        exactCoordinate[1].raw !== exactSystem.coordinates[1].raw) {
+        fail(asteroid.address, `Asteroid ${asteroid.name} is not in Fleet ${fleet.name}'s current or arrival Star System. Choose a deposit at the Fleet's mining coordinate or move the Fleet there, refresh, and retry.`);
+    }
+    const characterData = characterAccountDefinition.decode(characterAccount);
+    if (characterData.game !== game ||
+        characterData.playerProfile !== authorization.profile) {
+        fail(character, 'Character does not match the owning Profile and configured Game. Refresh or repair the canonical Character registration before retrying.');
+    }
+    const tracker = regionTrackerAccountDefinition.decode(trackerAccount);
+    if (tracker.game !== game) {
+        fail(regionTracker, 'RegionTracker does not match the configured Game. Refresh world region data for this Game before retrying.');
+    }
+    const resources = resourceIds
+        .map((id) => {
+        const resource = asteroid.resources.find((r) => r.cargo.id === id);
+        return `${resource.cargo.name} (cargo ${id})`;
+    })
+        .join(', ');
+    const describes = `Start mining with Fleet ${fleet.name} at Asteroid ${asteroid.name}: ${resources}.`;
+    const settlementWarning = movingSnapshot
+        ? ' Direct mining needs Idle. Settle travel through a supported game route, then refresh an Idle Fleet before planning mining. planFleetSettleArrival supports completed current-runtime subwarp with direct Profile authorization, not warp. Current-runtime settlement-plus-mining composition has not been qualified.'
+        : '';
+    return createPlan({
+        kind: 'fleet.start-mining',
+        summary: describes,
+        steps: [
+            {
+                describes: `${describes}${settlementWarning} Simulate before execution; arrival, permissions, range, fuel, and mining eligibility remain chain-authoritative.`,
+                signers: [authorization.authority],
+                instruction: adaptStartMiningAsteroidInstruction({
+                    authorization,
+                    fleet: fleet.address,
+                    character,
+                    starSystem: systemAccount.address,
+                    regionTracker,
+                    asteroid: asteroid.address,
+                    game,
+                    resources: resourceIds,
+                }),
+            },
+        ],
+        preconditions: [],
+    });
+}
+/** Plans one inert stop-mining instruction using the Asteroid in Fleet state.
+ *
+ * The snapshot and a fresh canonical Fleet must be mining the same Asteroid.
+ * A finite persisted guard rechecks this state before signing; old unguarded
+ * stop Plans must be recreated. Exit fuel was observed on PTR even for Idle,
+ * so Idle is not a free no-op. The read-to-chain race remains: simulate before
+ * execution; a later state change can still consume fuel or fail upkeep checks.
+ * No yield, cargo amount, or execution success is promised. DO_MINING
+ * permission remains chain-authoritative. Only validated canonical optional
+ * accounts are included, including the chain-created neutral CrewBinding at
+ * its canonical PDA; proven absence uses the generated omitted-account sentinel.
+ * Planning does not sign, simulate, or submit a transaction.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleet: FleetSnapshot;
+ * declare const authorization: PlanAuthorization;
+ * const plan = await planFleetStopMining(ctx, fleet, { authorization });
+ * ```
+ */
+export async function planFleetStopMining(ctx, fleet, options) {
+    const game = requireGameAddress(ctx);
+    validateOptionsObject(options, 'options');
+    validateOptionsObject(options.authorization, 'authorization');
+    const authorization = {
+        profile: options.authorization.profile,
+        authority: options.authorization.authority,
+        keyIndex: options.authorization.keyIndex,
+        ...(options.authorization.certificate === undefined
+            ? {}
+            : { certificate: options.authorization.certificate }),
+    };
+    validatePlanAuthorization(authorization);
+    if (fleet.state.kind !== 'mining') {
+        fail(fleet.address, `Fleet ${fleet.name} is ${fleet.state.kind} and cannot stop mining. Refresh the Fleet and retry only with a mining snapshot; an idle Fleet has already stopped.`);
+    }
+    if (fleet.game !== game ||
+        fleet.ownerProfile.address !== authorization.profile) {
+        fail(fleet.address, `Fleet ${fleet.name} must belong to configured Game ${game} and authorized Profile ${authorization.profile}. Choose the owning Profile and matching Game, refresh the Fleet, and retry.`);
+    }
+    const asteroid = fleet.state.asteroid.address;
+    const intent = {
+        address: fleet.address,
+        game,
+        profile: authorization.profile,
+        asteroid,
+    };
+    const [character, crewBinding, regionTracker] = await Promise.all([
+        findCharacterPda(authorization.profile, game),
+        deriveFleetCrewBindingAddress(fleet.address),
+        deriveRegionTrackerAddress(game),
+    ]);
+    const [currentFleet, crewAccount, regionAccount] = await readContextRawAccounts(ctx, [
+        intent.address,
+        crewBinding,
+        regionTracker,
+    ]);
+    let matches = false;
+    try {
+        matches = await matchesFleetMiningState(currentFleet, intent);
+    }
+    catch {
+        // Adapter errors must not hide the action-level remedy for a saved snapshot.
+    }
+    if (!matches)
+        fail(intent.address, 'The fresh Fleet is unavailable, invalid, or no longer owned by this Profile and mining the selected Asteroid in this Game. Refresh the Fleet and recreate the stop Plan only while it is mining; an idle stop can still consume exit fuel.');
+    if (crewAccount !== undefined) {
+        const crew = fleetCrewBindingAccountDefinition.decode(crewAccount);
+        if (crewAccount.address !== crewBinding ||
+            !matchesFleetCrewBindingIdentity(crew, fleet.address, authorization.profile)) {
+            fail(crewBinding, 'FleetCrewBinding does not match its canonical address, Fleet, or owning Profile. Refresh the Fleet crew registration and retry.');
+        }
+    }
+    if (regionAccount !== undefined) {
+        const region = regionTrackerAccountDefinition.decode(regionAccount);
+        if (regionAccount.address !== regionTracker || region.game !== game) {
+            fail(regionTracker, 'RegionTracker does not match its canonical address or configured Game. Refresh world region data for this Game and retry.');
+        }
+    }
+    const xp = await resolveXpRuntime(ctx, {
+        game,
+        character,
+        profile: options.authorization.profile,
+    });
+    return createPlan({
+        kind: 'fleet.stop-mining',
+        summary: `Stop mining for Fleet ${fleet.name}.`,
+        steps: [
+            {
+                describes: `Stop mining for Fleet ${fleet.name} at Asteroid ${asteroid}, returning it to idle. Fresh mining state is checked before signing; exit fuel can still be consumed, including if the Fleet becomes idle in the read-to-chain race. Simulate before execution; permission and mining results remain chain-authoritative.`,
+                signers: [authorization.authority],
+                instruction: adaptStopMiningAsteroidInstruction({
+                    ...xp.accounts,
+                    authorization,
+                    character,
+                    fleet: intent.address,
+                    game,
+                    asteroid,
+                    ...(crewAccount === undefined ? {} : { crewBinding }),
+                    ...(regionAccount === undefined ? {} : { regionTracker }),
+                }),
+            },
+        ],
+        preconditions: [
+            {
+                kind: 'xp-runtime',
+                address: game,
+                intent: xp.intent,
+                accounts: xp.accounts,
+                describes: 'The configured Game and canonical Character XP accounts remain eligible for mining settlement.',
+            },
+            {
+                kind: 'fleet-mining',
+                ...intent,
+                describes: 'The canonical Fleet remains owned by the authorized Profile and mining the planned Asteroid in the configured Game.',
+            },
+        ],
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/mining/actions/index.js.map

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

package/dist/mining/estimate.d.ts

@@ -0,0 +1,114 @@
+/** One selected Asteroid resource, using translated storage units rather than encoded fixed point.
+ * `runtimeMultiplier` is the caller's effective multiplier, including any applicable
+ * crew/research effects. No modifier composition or eligibility is inferred.
+ * @example
+ * ```ts
+ * const resource: MiningEstimateResourceInput = {
+ *   cargoId: 300, richness: 2, storageCost: 2, runtimeMultiplier: 1.5,
+ * };
+ * ```
+ */
+export interface MiningEstimateResourceInput {
+    readonly cargoId: number;
+    readonly richness: number;
+    readonly storageCost: number;
+    readonly runtimeMultiplier: number;
+}
+/** Explicit constant-rate Asteroid scenario. Balances and rates use cargo units;
+ * capacity, occupancy and storage costs use translated storage units. Occupancy
+ * includes all available Food; Ammo is held separately and frees no cargo space.
+ * Supply all 1–8 selected resources, including zero-yield rows. Fleet rate already
+ * includes ship/component effects: do not apply those again in the multipliers.
+ * @example
+ * ```ts
+ * const input: MiningEstimateInput = {
+ *   fleetUnitsPerSecond: 2, durationSeconds: 60,
+ *   resources: [{ cargoId: 300, richness: 1, storageCost: 1, runtimeMultiplier: 1 }],
+ *   cargo: { occupiedSpace: 10, capacity: 100 },
+ *   food: { availableUnits: 10, burnUnitsPerSecond: 0.1, storageCost: 1 },
+ *   ammo: { availableUnits: 10, burnUnitsPerSecond: 0.1 },
+ * };
+ * ```
+ */
+export interface MiningEstimateInput {
+    readonly fleetUnitsPerSecond: number;
+    /** Requested duration; the result reports the clipped duration. */
+    readonly durationSeconds: number;
+    readonly resources: readonly MiningEstimateResourceInput[];
+    readonly cargo: {
+        readonly occupiedSpace: number;
+        readonly capacity: number;
+    };
+    readonly food: {
+        readonly availableUnits: number;
+        readonly burnUnitsPerSecond: number;
+        readonly storageCost: number;
+    };
+    readonly ammo: {
+        readonly availableUnits: number;
+        readonly burnUnitsPerSecond: number;
+    };
+}
+/** Constraints reached at the end of an estimate; simultaneous limits are retained.
+ * @example
+ * ```ts
+ * const reason: MiningEstimateLimit = 'food';
+ * ```
+ */
+export type MiningEstimateLimit = 'duration' | 'food' | 'ammo' | 'cargo' | 'no-output';
+/** Immutable, JSON-safe constant-rate estimate, not a settlement guarantee.
+ * Projected quantities are fractional numbers; chain rounding, changing state,
+ * eligibility and tick ordering are excluded. A null limit means unbounded by
+ * that constraint, never an unknown balance. No-output scenarios run for zero time
+ * and project no upkeep. An initially full hold conservatively permits no mining,
+ * even when Food outflow could offset output: tick ordering is not established.
+ * @example
+ * ```ts
+ * declare const estimate: MiningEstimate;
+ * console.log(estimate.durationSeconds, estimate.limitingFactors);
+ * ```
+ */
+export interface MiningEstimate {
+    readonly basis: 'official-model-estimate';
+    /** Requested duration clipped to the modeled limits, in seconds. */
+    readonly durationSeconds: number;
+    readonly outputs: readonly {
+        readonly cargoId: number;
+        readonly unitsPerSecond: number;
+        readonly projectedUnits: number;
+    }[];
+    readonly resourceVolumeInflowPerSecond: number;
+    readonly foodVolumeOutflowPerSecond: number;
+    /** May be negative when Food consumption frees more space than mining uses. */
+    readonly netCargoGrowthPerSecond: number;
+    readonly limitsSeconds: {
+        readonly food: number | null;
+        readonly ammo: number | null;
+        readonly cargo: number | null;
+    };
+    readonly limitingFactors: readonly MiningEstimateLimit[];
+    readonly consumedFoodUnits: number;
+    readonly consumedAmmoUnits: number;
+    readonly finalOccupiedSpace: number;
+}
+/** Estimates constant-rate Asteroid output, clipping duration to Food, Ammo and
+ * cargo capacity. Each rate is Fleet rate / selected count × richness × explicit
+ * effective runtime multiplier. Food consumption offsets volume growth while
+ * mining; Ammo does not. Hardness is absent from the official current C4 model.
+ * This is pure: it neither reads accounts nor validates resource eligibility.
+ * @throws InvalidDerivationInputError for invalid selections, inconsistent cargo
+ * occupancy, negative/nonfinite values or arithmetic overflow.
+ * @example
+ * ```ts
+ * const estimate = deriveMiningEstimate({
+ *   fleetUnitsPerSecond: 2, durationSeconds: 60,
+ *   resources: [{ cargoId: 300, richness: 1, storageCost: 1, runtimeMultiplier: 1 }],
+ *   cargo: { occupiedSpace: 10, capacity: 100 },
+ *   food: { availableUnits: 10, burnUnitsPerSecond: 0.1, storageCost: 1 },
+ *   ammo: { availableUnits: 10, burnUnitsPerSecond: 0.1 },
+ * });
+ * console.log(estimate.outputs, estimate.limitingFactors);
+ * ```
+ */
+export declare function deriveMiningEstimate(input: MiningEstimateInput): MiningEstimate;
+//# sourceMappingURL=estimate.d.ts.map

package/dist/mining/estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/mining/estimate.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;KACrC,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC7B,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;KACjC,EAAE,CAAC;IACJ,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAC;IAC/C,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,+EAA+E;IAC/E,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAiBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,GACzB,cAAc,CAmLhB"}

package/dist/mining/estimate.js

@@ -0,0 +1,127 @@
+import { InvalidDerivationInputError } from '../client/errors.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+function checked(field, value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new InvalidDerivationInputError(field, value, 'Supply finite, nonnegative mining inputs whose calculated rates, quantities and time limits remain finite.');
+    }
+    return value;
+}
+function invalid(field, value, remedy) {
+    throw new InvalidDerivationInputError(field, value, remedy);
+}
+/** Estimates constant-rate Asteroid output, clipping duration to Food, Ammo and
+ * cargo capacity. Each rate is Fleet rate / selected count × richness × explicit
+ * effective runtime multiplier. Food consumption offsets volume growth while
+ * mining; Ammo does not. Hardness is absent from the official current C4 model.
+ * This is pure: it neither reads accounts nor validates resource eligibility.
+ * @throws InvalidDerivationInputError for invalid selections, inconsistent cargo
+ * occupancy, negative/nonfinite values or arithmetic overflow.
+ * @example
+ * ```ts
+ * const estimate = deriveMiningEstimate({
+ *   fleetUnitsPerSecond: 2, durationSeconds: 60,
+ *   resources: [{ cargoId: 300, richness: 1, storageCost: 1, runtimeMultiplier: 1 }],
+ *   cargo: { occupiedSpace: 10, capacity: 100 },
+ *   food: { availableUnits: 10, burnUnitsPerSecond: 0.1, storageCost: 1 },
+ *   ammo: { availableUnits: 10, burnUnitsPerSecond: 0.1 },
+ * });
+ * console.log(estimate.outputs, estimate.limitingFactors);
+ * ```
+ */
+export function deriveMiningEstimate(input) {
+    const base = checked('Fleet mining units per second', input.fleetUnitsPerSecond);
+    const requested = checked('Mining duration seconds', input.durationSeconds);
+    const count = input.resources.length;
+    if (count < 1 || count > 8)
+        invalid('Selected resource count', count, 'Select between one and eight distinct Asteroid resources.');
+    const seen = new Set();
+    const rates = Array.from(input.resources, (resource, index) => {
+        if (resource === null || typeof resource !== 'object') {
+            invalid('Selected resource index', index, 'Supply a dense list of resource objects with explicit numeric inputs.');
+        }
+        const id = resource.cargoId;
+        if (!Number.isInteger(id) || id < 0 || id > 65535 || seen.has(id)) {
+            invalid('Selected cargo id', id, 'Supply distinct integer cargo ids between 0 and 65535 from the Asteroid deposit.');
+        }
+        seen.add(id);
+        const richness = checked('Resource richness', resource.richness);
+        const multiplier = checked('Resource runtime multiplier', resource.runtimeMultiplier);
+        const storageCost = checked('Resource storage cost', resource.storageCost);
+        const unitsPerSecond = checked('Resource output rate', checked('Richness-adjusted output rate', (base / count) * richness) *
+            multiplier);
+        return {
+            cargoId: id,
+            unitsPerSecond,
+            volume: checked('Resource volume inflow', unitsPerSecond * storageCost),
+        };
+    });
+    const capacity = checked('Cargo capacity', input.cargo.capacity);
+    const occupied = checked('Occupied cargo space', input.cargo.occupiedSpace);
+    if (occupied > capacity)
+        invalid('Occupied cargo space', occupied, 'Supply occupancy no greater than cargo capacity.');
+    const foodAvailable = checked('Available Food units', input.food.availableUnits);
+    const foodBurn = checked('Food burn units per second', input.food.burnUnitsPerSecond);
+    const foodStorage = checked('Food storage cost', input.food.storageCost);
+    if (checked('Available Food volume', foodAvailable * foodStorage) > occupied) {
+        invalid('Occupied cargo space', occupied, 'Include the volume of all available Food in occupied cargo space.');
+    }
+    const ammoAvailable = checked('Available Ammo units', input.ammo.availableUnits);
+    const ammoBurn = checked('Ammo burn units per second', input.ammo.burnUnitsPerSecond);
+    const resourceVolumeInflowPerSecond = rates.reduce((sum, row) => checked('Total resource volume inflow', sum + row.volume), 0);
+    const foodVolumeOutflowPerSecond = checked('Food volume outflow', foodBurn * foodStorage);
+    const netCargoGrowthPerSecond = resourceVolumeInflowPerSecond - foodVolumeOutflowPerSecond;
+    const limitsSeconds = {
+        food: foodBurn === 0
+            ? null
+            : checked('Food time limit', foodAvailable / foodBurn),
+        ammo: ammoBurn === 0
+            ? null
+            : checked('Ammo time limit', ammoAvailable / ammoBurn),
+        cargo: occupied === capacity
+            ? 0
+            : netCargoGrowthPerSecond > 0
+                ? checked('Cargo time limit', (capacity - occupied) / netCargoGrowthPerSecond)
+                : null,
+    };
+    const constraints = [
+        ['duration', requested],
+        ['food', limitsSeconds.food],
+        ['ammo', limitsSeconds.ammo],
+        ['cargo', limitsSeconds.cargo],
+    ];
+    const noOutput = rates.every((row) => row.unitsPerSecond === 0);
+    const durationSeconds = noOutput
+        ? 0
+        : Math.min(...constraints.flatMap(([, seconds]) => seconds === null ? [] : [seconds]));
+    const tolerance = Math.max(1e-9, durationSeconds * 1e-9);
+    const limitingFactors = noOutput
+        ? ['no-output']
+        : constraints
+            .filter(([, seconds]) => seconds !== null &&
+            Math.abs(seconds - durationSeconds) <= tolerance)
+            .map(([reason]) => reason);
+    const consumedFoodUnits = checked('Consumed Food units', foodBurn * durationSeconds);
+    const consumedAmmoUnits = checked('Consumed Ammo units', ammoBurn * durationSeconds);
+    const inflow = checked('Projected cargo inflow', resourceVolumeInflowPerSecond * durationSeconds);
+    const outflow = checked('Projected Food outflow', foodVolumeOutflowPerSecond * durationSeconds);
+    // Subtract Food first to avoid overflowing a temporary sum near Number.MAX_VALUE.
+    const finalOccupiedSpace = Math.min(capacity, checked('Projected occupied cargo space', Math.max(0, occupied - outflow) + inflow));
+    return freezeResolvedSnapshot({
+        basis: 'official-model-estimate',
+        durationSeconds,
+        outputs: rates.map(({ cargoId, unitsPerSecond }) => ({
+            cargoId,
+            unitsPerSecond,
+            projectedUnits: checked('Projected resource units', unitsPerSecond * durationSeconds),
+        })),
+        resourceVolumeInflowPerSecond,
+        foodVolumeOutflowPerSecond,
+        netCargoGrowthPerSecond,
+        limitsSeconds,
+        limitingFactors,
+        consumedFoodUnits,
+        consumedAmmoUnits,
+        finalOccupiedSpace,
+    });
+}
+//# sourceMappingURL=estimate.js.map

package/dist/mining/estimate.js.map

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

package/dist/mining/index.d.ts

@@ -43,7 +43,7 @@ export interface MiningOutputRateInput {
     readonly cargoId: number;
     readonly richness: number;
 }
-/** One richness-adjusted resource output in cargo units per second.
+/** One nominal resource output after sharing Fleet capacity and applying richness.
  * @example
  * ```ts
  * const rate: MiningOutputRate = { cargoId: 8, unitsPerSecond: 4.5 };
@@ -61,6 +61,7 @@ export interface MiningOutputRate {
  * ```
  */
 export interface FleetMiningOutput extends ResourceDepositItem {
+    /** Nominal cargo units per second, with Fleet capacity shared among selected resources. */
     readonly unitsPerSecond: number;
 }
 /** Immutable current extraction relationship for one active mining Fleet.
@@ -77,6 +78,7 @@ export interface FleetMiningSnapshot {
     readonly asteroid: EntityRef<'celestialBody'>;
     readonly lastUpdatedAtUnixSeconds: bigint;
     readonly regionXpModifier: WorldFixedValue;
+    /** Fleet base rate before sharing among selected resources and applying richness. */
     readonly miningRate: {
         readonly raw: bigint;
         readonly unitsPerSecond: number;
@@ -121,7 +123,10 @@ export declare function maybeGetResourceDeposit(context: SageContext, asteroid:
  * ```
  */
 export declare function deriveMiningStateAgeSeconds(lastUpdatedAtUnixSeconds: bigint, atUnixSeconds: bigint): number;
-/** Derives each selected output rate as Fleet units/second times deposit richness.
+/** Shares Fleet units/second equally among selected resources, then applies richness.
+ * Supply the complete selected resource list, including zero-richness selections.
+ * An empty selection returns no rates. Results are nominal estimates; cargo
+ * limits, upkeep and whole-unit settlement remain chain-authoritative.
  * @example
  * ```ts
  * const rates = deriveMiningOutputRates(2, [{ cargoId: 8, richness: 1.5 }]);
@@ -153,4 +158,5 @@ export declare function getFleetMiningState(context: SageContext, fleet: Address
  * ```
  */
 export declare function getFleetMiningStatesByOwner(context: SageContext, owner: Address, options?: MiningDiscoveryOptions): Promise<readonly FleetMiningSnapshot[]>;
+export { deriveMiningEstimate, type MiningEstimate, type MiningEstimateInput, type MiningEstimateLimit, type MiningEstimateResourceInput, } from './estimate.js';
 //# sourceMappingURL=index.d.ts.map