@aephia/atlas-kit 0.6.0-next.98 → 0.6.0

package/dist/crafting/actions/index.d.ts

@@ -2,7 +2,7 @@ import { type Address } from '@solana/kit';
 import type { SageContext } from '../../client/contracts.js';
 import type { EntityRef } from '../../client/refs.js';
 import { type PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
-import { type Plan } from '../../planning/index.js';
+import type { Plan } from '../../planning/index.js';
 import type { CraftingHabSnapshot, CraftingProcessSnapshot, RecipeSnapshot } from '../index.js';
 export type { PlanAuthorization };
 interface StarbaseCargoItem {
@@ -24,9 +24,13 @@ interface StarbasePlayerSnapshot {
 /** Inputs for starting one exact Crafting Process.
  *
  * `quantity` is a positive raw unsigned-u64 integer. `numCrew` is the exact
- * unsigned-u32 crew count committed by the instruction. `craftingProcess` is
+ * crew count requested by the instruction, at least 1 and within unsigned u32.
+ * With a Crafting Hab the job reserves `numCrew` scaled by the Hab's
+ * crew-count modifier, rounded up, from the Starbase Player's available crew. `craftingProcess` is
  * the address of a new caller-created signer; planning retains only its address.
  * Supply `craftingHab` when the Recipe requires or should use Hab production.
+ * Recipe inputs are always taken from the Starbase Player's Starbase cargo,
+ * with or without a Hab; the Hab contributes production and modifiers only.
  *
  * @example
  * ```ts
@@ -66,42 +70,34 @@ export interface PlanCompleteCraftingProcessOptions {
     readonly authorization: PlanAuthorization;
     readonly atUnixSeconds: bigint;
 }
-/** Inputs for cancelling one unfinished Crafting Process.
+/** Inputs for cancelling one Crafting Process.
  *
- * `atUnixSeconds` is an explicit non-negative Unix timestamp used only for the
- * deterministic local lifecycle check. Final inventory capacity, permissions,
- * input and crew returns, and account closure remain chain-authoritative.
+ * Cancellation has no timing rule, so it takes no timestamp. Final inventory
+ * capacity, permissions, input and crew returns, and account closure remain
+ * chain-authoritative.
  *
  * @example
  * ```ts
  * declare const authorization: PlanAuthorization;
- * const options: PlanCancelCraftingProcessOptions = {
- *   authorization,
- *   atUnixSeconds: 1_700_001_000n,
- * };
+ * const options: PlanCancelCraftingProcessOptions = { authorization };
  * ```
  */
 export interface PlanCancelCraftingProcessOptions {
     readonly authorization: PlanAuthorization;
-    readonly atUnixSeconds: bigint;
 }
 /** Plans one Crafting Process start without signing, simulation, or writes.
  *
  * The planner validates the loaded Recipe and Starbase Player, optional Hab,
- * known ingredient balances, available crew, and exact whole-account state. It
- * returns one inert Plan whose two required signer roles are bound only during
- * execution.
+ * known ingredient balances, the crew the job reserves, the Hab job limit
+ * including the Character's research concurrency bonus, and exact
+ * whole-account state. The ATLAS fee and any crew-roster bonuses remain
+ * chain-authoritative. It returns one inert Plan whose two required signer
+ * roles are bound only during execution.
  *
- * A Recipe whose stored `usageLimitRaw` is `0n` is treated as unlimited: the
- * local usage-limit precondition is skipped regardless of `usageCountRaw`.
- * This is pinned SDK behavior, not a verified game rule. The pinned generated
- * Recipe documents `usageLimit` only as "The maximum number of times that
- * this recipe can be used", and every Recipe observed on z.ink PTR stores
- * `9007199254740991` (2^53 - 1) as its limit, so no zero-limit Recipe has been
- * simulated or executed. If the program enforces a limit the SDK did not,
- * simulation or execution surfaces its `UsageLimitExceeded` error
- * (`1367932950`) instead of a local precondition failure. See
- * `docs/evidence/crafting-zero-usage-limit.md`.
+ * Each start consumes exactly one Recipe use, whatever its quantity, and needs
+ * the Recipe's fresh `usageCountRaw` to be below `usageLimitRaw`. A stored
+ * limit of `0n` is therefore never usable. Cancelling or destroying a process
+ * returns its use. See `docs/evidence/crafting-zero-usage-limit.md`.
  *
  * @example
  * ```ts
@@ -131,12 +127,15 @@ export declare function planStartCraftingProcess(ctx: SageContext, recipe: Recip
  * ```
  */
 export declare function planCompleteCraftingProcess(ctx: SageContext, process: CraftingProcessSnapshot, input: PlanCompleteCraftingProcessOptions): Promise<Plan>;
-/** Plans cancellation of one unfinished Crafting Process without signing or writes.
+/** Plans cancellation of one Crafting Process without signing or writes.
  *
  * The planner resolves and validates the Process account graph, requires Profile
- * ownership, and rejects completed or destroyed-Starbase Process snapshots.
- * Final inventory capacity, permissions, returned inputs and crew, and account
- * closure remain chain-authoritative.
+ * ownership, and rejects a Process whose Starbase was destroyed. Cancellation
+ * has no timing rule: a finished Process can still be cancelled, which returns
+ * its inputs and crew instead of producing outputs. A Process Hab is passed by
+ * its stored address in whatever state it is in, or even if it no longer
+ * exists. Final inventory capacity, permissions, returned inputs and crew, and
+ * account closure remain chain-authoritative.
  *
  * @example
  * ```ts
@@ -148,4 +147,5 @@ export declare function planCompleteCraftingProcess(ctx: SageContext, process: C
  * ```
  */
 export declare function planCancelCraftingProcess(ctx: SageContext, process: CraftingProcessSnapshot, input: PlanCancelCraftingProcessOptions): Promise<Plan>;
+export { getCraftingFeeRate, type CraftingFeeRate } from './fee-rate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/crafting/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/crafting/actions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAkBtD,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAK1D,OAAO,EAEL,KAAK,IAAI,EAEV,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACf,MAAM,aAAa,CAAC;AAMrB,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;KAC9C,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;CAC5C;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAsbD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,IAAI,CAAC,CAgLf;AAyPD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,IAAI,CAAC,CAyFf;AA+KD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,IAAI,CAAC,CAkFf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/crafting/actions/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAkBtD,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAE1D,OAAO,KAAK,EAAE,IAAI,EAAoB,MAAM,yBAAyB,CAAC;AAEtE,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACf,MAAM,aAAa,CAAC;AAWrB,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;KAC9C,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;CAC5C;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAuXD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,IAAI,CAAC,CA8Lf;AAqSD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,IAAI,CAAC,CA8Ef;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,IAAI,CAAC,CAiFf;AACD,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}