@aephia/atlas-kit 0.5.0 → 0.6.0-next.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/README.md +38 -27
  2. package/dist/cargo/index.d.ts +1 -0
  3. package/dist/cargo/index.d.ts.map +1 -1
  4. package/dist/cargo/index.js +1 -0
  5. package/dist/cargo/index.js.map +1 -1
  6. package/dist/claim-stakes/actions/index.d.ts +393 -0
  7. package/dist/claim-stakes/actions/index.d.ts.map +1 -0
  8. package/dist/claim-stakes/actions/index.js +1747 -0
  9. package/dist/claim-stakes/actions/index.js.map +1 -0
  10. package/dist/claim-stakes/index.d.ts +64 -0
  11. package/dist/claim-stakes/index.d.ts.map +1 -1
  12. package/dist/claim-stakes/index.js +49 -0
  13. package/dist/claim-stakes/index.js.map +1 -1
  14. package/dist/client/context.d.ts.map +1 -1
  15. package/dist/client/context.js +2 -1
  16. package/dist/client/context.js.map +1 -1
  17. package/dist/client/errors.d.ts +12 -3
  18. package/dist/client/errors.d.ts.map +1 -1
  19. package/dist/client/errors.js +11 -0
  20. package/dist/client/errors.js.map +1 -1
  21. package/dist/client/index.d.ts +2 -1
  22. package/dist/client/index.d.ts.map +1 -1
  23. package/dist/client/index.js +1 -0
  24. package/dist/client/index.js.map +1 -1
  25. package/dist/client/lifecycle.d.ts +2 -0
  26. package/dist/client/lifecycle.d.ts.map +1 -1
  27. package/dist/client/lifecycle.js +31 -0
  28. package/dist/client/lifecycle.js.map +1 -1
  29. package/dist/combat/actions/index.d.ts +239 -0
  30. package/dist/combat/actions/index.d.ts.map +1 -0
  31. package/dist/combat/actions/index.js +1146 -0
  32. package/dist/combat/actions/index.js.map +1 -0
  33. package/dist/crafting/actions/index.d.ts +140 -0
  34. package/dist/crafting/actions/index.d.ts.map +1 -0
  35. package/dist/crafting/actions/index.js +728 -0
  36. package/dist/crafting/actions/index.js.map +1 -0
  37. package/dist/crafting/index.d.ts +74 -8
  38. package/dist/crafting/index.d.ts.map +1 -1
  39. package/dist/crafting/index.js +55 -9
  40. package/dist/crafting/index.js.map +1 -1
  41. package/dist/fleets/actions/index.d.ts +5 -4
  42. package/dist/fleets/actions/index.d.ts.map +1 -1
  43. package/dist/fleets/actions/index.js +85 -58
  44. package/dist/fleets/actions/index.js.map +1 -1
  45. package/dist/fleets/index.d.ts +1 -0
  46. package/dist/fleets/index.d.ts.map +1 -1
  47. package/dist/fleets/index.js +1 -0
  48. package/dist/fleets/index.js.map +1 -1
  49. package/dist/index.d.ts +13 -2
  50. package/dist/index.d.ts.map +1 -1
  51. package/dist/index.js +9 -2
  52. package/dist/index.js.map +1 -1
  53. package/dist/internal/c4/claim-stake-building-definitions.d.ts +50 -0
  54. package/dist/internal/c4/claim-stake-building-definitions.d.ts.map +1 -0
  55. package/dist/internal/c4/claim-stake-building-definitions.js +56 -0
  56. package/dist/internal/c4/claim-stake-building-definitions.js.map +1 -0
  57. package/dist/internal/c4/claim-stake-configuration.d.ts +17 -0
  58. package/dist/internal/c4/claim-stake-configuration.d.ts.map +1 -0
  59. package/dist/internal/c4/claim-stake-configuration.js +47 -0
  60. package/dist/internal/c4/claim-stake-configuration.js.map +1 -0
  61. package/dist/internal/c4/claim-stake-definitions.d.ts +37 -0
  62. package/dist/internal/c4/claim-stake-definitions.d.ts.map +1 -0
  63. package/dist/internal/c4/claim-stake-definitions.js +77 -0
  64. package/dist/internal/c4/claim-stake-definitions.js.map +1 -0
  65. package/dist/internal/c4/fleet.d.ts.map +1 -1
  66. package/dist/internal/c4/fleet.js +2 -102
  67. package/dist/internal/c4/fleet.js.map +1 -1
  68. package/dist/internal/c4/game-definition-layout.d.ts +11 -0
  69. package/dist/internal/c4/game-definition-layout.d.ts.map +1 -0
  70. package/dist/internal/c4/game-definition-layout.js +32 -0
  71. package/dist/internal/c4/game-definition-layout.js.map +1 -0
  72. package/dist/internal/c4/game.d.ts +13 -1
  73. package/dist/internal/c4/game.d.ts.map +1 -1
  74. package/dist/internal/c4/game.js +19 -37
  75. package/dist/internal/c4/game.js.map +1 -1
  76. package/dist/internal/c4/profile-faction.d.ts +6 -0
  77. package/dist/internal/c4/profile-faction.d.ts.map +1 -1
  78. package/dist/internal/c4/profile-faction.js +22 -1
  79. package/dist/internal/c4/profile-faction.js.map +1 -1
  80. package/dist/internal/c4/ship-stats.d.ts +5 -0
  81. package/dist/internal/c4/ship-stats.d.ts.map +1 -0
  82. package/dist/internal/c4/ship-stats.js +106 -0
  83. package/dist/internal/c4/ship-stats.js.map +1 -0
  84. package/dist/internal/c4/world.d.ts +23 -1
  85. package/dist/internal/c4/world.d.ts.map +1 -1
  86. package/dist/internal/c4/world.js +53 -1
  87. package/dist/internal/c4/world.js.map +1 -1
  88. package/dist/internal/crafting-process-state.d.ts +15 -0
  89. package/dist/internal/crafting-process-state.d.ts.map +1 -0
  90. package/dist/internal/crafting-process-state.js +12 -0
  91. package/dist/internal/crafting-process-state.js.map +1 -0
  92. package/dist/internal/planning/authorization-adapter.d.ts +74 -0
  93. package/dist/internal/planning/authorization-adapter.d.ts.map +1 -1
  94. package/dist/internal/planning/authorization-adapter.js +382 -0
  95. package/dist/internal/planning/authorization-adapter.js.map +1 -1
  96. package/dist/internal/read-meta.d.ts +39 -3
  97. package/dist/internal/read-meta.d.ts.map +1 -1
  98. package/dist/internal/read-meta.js +0 -10
  99. package/dist/internal/read-meta.js.map +1 -1
  100. package/dist/loyalty/actions/index.d.ts +40 -0
  101. package/dist/loyalty/actions/index.d.ts.map +1 -0
  102. package/dist/loyalty/actions/index.js +159 -0
  103. package/dist/loyalty/actions/index.js.map +1 -0
  104. package/dist/markets/actions/index.d.ts +100 -0
  105. package/dist/markets/actions/index.d.ts.map +1 -0
  106. package/dist/markets/actions/index.js +417 -0
  107. package/dist/markets/actions/index.js.map +1 -0
  108. package/dist/planning/assembly.d.ts +4 -0
  109. package/dist/planning/assembly.d.ts.map +1 -1
  110. package/dist/planning/assembly.js +13 -0
  111. package/dist/planning/assembly.js.map +1 -1
  112. package/dist/planning/composition.d.ts.map +1 -1
  113. package/dist/planning/composition.js +20 -1
  114. package/dist/planning/composition.js.map +1 -1
  115. package/dist/planning/execution.d.ts.map +1 -1
  116. package/dist/planning/execution.js +7 -4
  117. package/dist/planning/execution.js.map +1 -1
  118. package/dist/planning/index.d.ts +27 -8
  119. package/dist/planning/index.d.ts.map +1 -1
  120. package/dist/planning/index.js +57 -13
  121. package/dist/planning/index.js.map +1 -1
  122. package/dist/planning/simulation.d.ts.map +1 -1
  123. package/dist/planning/simulation.js +2 -1
  124. package/dist/planning/simulation.js.map +1 -1
  125. package/dist/registry/cargo.d.ts +10 -0
  126. package/dist/registry/cargo.d.ts.map +1 -0
  127. package/dist/registry/cargo.js +15 -0
  128. package/dist/registry/cargo.js.map +1 -0
  129. package/dist/registry/claim-stakes.d.ts +11 -0
  130. package/dist/registry/claim-stakes.d.ts.map +1 -0
  131. package/dist/registry/claim-stakes.js +15 -0
  132. package/dist/registry/claim-stakes.js.map +1 -0
  133. package/dist/registry/definition-section-snapshot.d.ts +42 -0
  134. package/dist/registry/definition-section-snapshot.d.ts.map +1 -0
  135. package/dist/registry/definition-section-snapshot.js +214 -0
  136. package/dist/registry/definition-section-snapshot.js.map +1 -0
  137. package/dist/registry/index.d.ts +114 -7
  138. package/dist/registry/index.d.ts.map +1 -1
  139. package/dist/registry/index.js +372 -101
  140. package/dist/registry/index.js.map +1 -1
  141. package/dist/registry/publication.d.ts +8 -0
  142. package/dist/registry/publication.d.ts.map +1 -0
  143. package/dist/registry/publication.js +10 -0
  144. package/dist/registry/publication.js.map +1 -0
  145. package/dist/registry/ship-stats-snapshot.d.ts +8 -0
  146. package/dist/registry/ship-stats-snapshot.d.ts.map +1 -0
  147. package/dist/registry/ship-stats-snapshot.js +154 -0
  148. package/dist/registry/ship-stats-snapshot.js.map +1 -0
  149. package/dist/world/index.d.ts +22 -1
  150. package/dist/world/index.d.ts.map +1 -1
  151. package/dist/world/index.js +24 -1
  152. package/dist/world/index.js.map +1 -1
  153. package/package.json +21 -1
package/README.md CHANGED
@@ -58,29 +58,34 @@ const systems = await getStarSystems(ctx);
58
58
 
59
59
  ## Entry points
60
60
 
61
- | Entry point | Purpose |
62
- | ------------------------------------- | -------------------------------------------------------------------- |
63
- | `@aephia/atlas-kit` | Loaded traversal across selected gameplay domains |
64
- | `@aephia/atlas-kit/bindings` | Raw generated C4 clients as an explicit escape hatch |
65
- | `@aephia/atlas-kit/cargo` | Cargo definitions, pods, inventory, and capacity |
66
- | `@aephia/atlas-kit/cargo/actions` | Fleet/Starbase and within-Fleet cargo transfer planning |
67
- | `@aephia/atlas-kit/claim-stakes` | Claim Stake reads, discovery, lifecycle, and production |
68
- | `@aephia/atlas-kit/client` | Context, cache, provenance, subscriptions, and errors |
69
- | `@aephia/atlas-kit/combat` | Combat configuration, Fleet combat state, Loot, and Outlaws |
70
- | `@aephia/atlas-kit/crafting` | Recipes, Crafting Habs, Processes, and production state |
71
- | `@aephia/atlas-kit/factions` | Faction identity, economics, diplomacy, and territory |
72
- | `@aephia/atlas-kit/fleets` | Fleets, composition, movement state, and relationships |
73
- | `@aephia/atlas-kit/fleets/actions` | Inspectable Fleet movement and arrival-settlement planners |
74
- | `@aephia/atlas-kit/identity` | Wallet, Profile, Character, progression, and research reads |
75
- | `@aephia/atlas-kit/loyalty` | Loyalty epochs, contributions, banks, and lifecycle |
76
- | `@aephia/atlas-kit/markets` | Local Market orders, maker state, and discovery |
77
- | `@aephia/atlas-kit/mining` | Deposits, active mining, extraction, and cargo outputs |
78
- | `@aephia/atlas-kit/planning` | Plans/PlanSequences, assembly, signer-free simulation, and execution |
79
- | `@aephia/atlas-kit/scanning` | Scan patterns, cooldowns, stats, and Character state |
80
- | `@aephia/atlas-kit/rewards` | ATLAS reward configuration, treasuries, and commitments |
81
- | `@aephia/atlas-kit/starbases` | Player-local Starbase state, facilities, and upgrades |
82
- | `@aephia/atlas-kit/starbases/actions` | Address-only StarbasePlayer registration planning |
83
- | `@aephia/atlas-kit/world` | Game, regions, systems, bodies, and world projections |
61
+ | Entry point | Purpose |
62
+ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
63
+ | `@aephia/atlas-kit` | Loaded traversal across selected gameplay domains |
64
+ | `@aephia/atlas-kit/bindings` | Raw generated C4 clients as an explicit escape hatch |
65
+ | `@aephia/atlas-kit/cargo` | Cargo definitions, pods, inventory, and capacity |
66
+ | `@aephia/atlas-kit/cargo/actions` | Fleet/Starbase and within-Fleet cargo transfer planning |
67
+ | `@aephia/atlas-kit/claim-stakes` | Claim Stake reads, discovery, lifecycle, and production |
68
+ | `@aephia/atlas-kit/claim-stakes/actions` | Address-only Claim Stake placement, building-design planning, rent top-up, Fleet-transfer start and recovery, finalization, cancellation, and deconstruction |
69
+ | `@aephia/atlas-kit/client` | Context, cache, provenance, subscriptions, and errors |
70
+ | `@aephia/atlas-kit/combat` | Combat configuration, Fleet combat state, Loot, and Outlaws |
71
+ | `@aephia/atlas-kit/combat/actions` | Address-only owned-Fleet combat stimulant, singleton Fleet-attack, and Loot retrieval planning |
72
+ | `@aephia/atlas-kit/crafting` | Recipes, Crafting Habs, Processes, and production state |
73
+ | `@aephia/atlas-kit/crafting/actions` | Address-only Crafting Process lifecycle planning |
74
+ | `@aephia/atlas-kit/factions` | Faction identity, economics, diplomacy, and territory |
75
+ | `@aephia/atlas-kit/fleets` | Fleets, composition, movement state, and relationships |
76
+ | `@aephia/atlas-kit/fleets/actions` | Inspectable Fleet movement and arrival-settlement planners |
77
+ | `@aephia/atlas-kit/identity` | Wallet, Profile, Character, progression, and research reads |
78
+ | `@aephia/atlas-kit/loyalty` | Loyalty epochs, contributions, banks, and lifecycle |
79
+ | `@aephia/atlas-kit/loyalty/actions` | Address-only full-balance Loyalty ATLAS claim planning |
80
+ | `@aephia/atlas-kit/markets` | Local Market orders, maker state, and discovery |
81
+ | `@aephia/atlas-kit/markets/actions` | Address-only Local Market order, cancellation, and filled-escrow withdrawal planning |
82
+ | `@aephia/atlas-kit/mining` | Deposits, active mining, extraction, and cargo outputs |
83
+ | `@aephia/atlas-kit/planning` | Plans/PlanSequences, assembly, signer-free simulation, and execution |
84
+ | `@aephia/atlas-kit/scanning` | Scan patterns, cooldowns, stats, and Character state |
85
+ | `@aephia/atlas-kit/rewards` | ATLAS reward configuration, treasuries, and commitments |
86
+ | `@aephia/atlas-kit/starbases` | Player-local Starbase state, facilities, and upgrades |
87
+ | `@aephia/atlas-kit/starbases/actions` | Address-only StarbasePlayer registration planning |
88
+ | `@aephia/atlas-kit/world` | Game, regions, systems, bodies, and world projections |
84
89
 
85
90
  ## Scope and guarantees
86
91
 
@@ -91,11 +96,17 @@ const systems = await getStarSystems(ctx);
91
96
  a typed outcome, and invalidates affected cache entries only on confirmed
92
97
  success. No signer or key material is retained by the context. The Fleet
93
98
  actions entries plan all five bounded movement transitions, Fleet arrival
94
- settlement, and D048's focused cargo/Starbase transfers without write RPC;
99
+ settlement, focused cargo and Starbase actions, Crafting Process
100
+ start/completion/cancellation, Local Market order
101
+ placement/cancellation/filled-escrow withdrawal, one owned Fleet's combat
102
+ stimulant application, singleton Fleet-on-Fleet and Fleet-on-Starbase attacks,
103
+ Loot retrieval, and full-balance Loyalty ATLAS claims without write RPC;
95
104
  `simulatePlan` accepts only an address-valued assembly policy and never
96
- invokes a signer. Remaining capability planners do not ship yet. Treat every
97
- unknown outcome as possibly submitted and never retry it automatically;
98
- execution can incur fees or move assets.
105
+ invokes a signer. Remaining accepted W3 capability planners do not ship yet.
106
+ Combat permission, range, randomness, rewards, damage, stimulant stacking, and
107
+ final outcomes remain chain-authoritative. Treat every unknown outcome as
108
+ possibly submitted and never retry it automatically; execution can incur fees
109
+ or move assets.
99
110
  - **Fail-closed Plan sequences.** A `PlanSequence` is a non-atomic itinerary of
100
111
  caller-owned lazy steps. Capability callbacks report `waiting` or return one
101
112
  freshly prepared Plan only when reached; every transaction needs fresh
@@ -1,6 +1,7 @@
1
1
  import { type Address, type DiscoveryRequest, type EntityRef, type ReadOptions, type SageContext } from '../client/index.js';
2
2
  import { type ResolvedFleetCargoInventory } from '../internal/cargo.js';
3
3
  import { type CargoDefinitionSummary, type DefinitionLookupOptions } from '../registry/index.js';
4
+ export { listCargoDefinitions } from '../registry/index.js';
4
5
  export type { CargoCapacity, CargoInventoryItem, CargoPodInventory, } from '../internal/cargo.js';
5
6
  /** Stable cargo definition resolved lazily from the configured Game registry.
6
7
  * @example
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,gBAAgB,EAChB,SAAS,GAAG,UAAU,CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CACvD,2BAA2B,EAC3B,cAAc,CACf;IACC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAwED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,CAAC,CAUtC;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAWlD;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAWjD"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,gBAAgB,EAChB,SAAS,GAAG,UAAU,CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CACvD,2BAA2B,EAC3B,cAAc,CACf;IACC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAwED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,CAAC,CAUtC;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAWlD;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAWjD"}
@@ -6,6 +6,7 @@ import { attachJsonSerialization } from '../internal/json.js';
6
6
  import { attachReadMeta, readMeta } from '../internal/read-meta.js';
7
7
  import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
8
8
  import { resolveCargo, } from '../registry/index.js';
9
+ export { listCargoDefinitions } from '../registry/index.js';
9
10
  const FLEET_INVENTORIES = new WeakMap();
10
11
  function directMetadata(envelope) {
11
12
  return {
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,393 @@
1
+ import { type Address } from '@solana/kit';
2
+ import type { SageContext } from '../../client/contracts.js';
3
+ import type { EntityRef } from '../../client/refs.js';
4
+ import { type WorldClaimStakeGroupData, type WorldFixedValue, type WorldPlanetResourceData } from '../../internal/c4/world.js';
5
+ import { type PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
6
+ import { type Plan } from '../../planning/index.js';
7
+ import type { ResolvedFleetAccountData } from '../../internal/fleet.js';
8
+ import type { ClaimStakeSnapshot } from '../index.js';
9
+ export type { PlanAuthorization };
10
+ interface PlanetDetails {
11
+ readonly claimStakePlots: readonly (readonly number[])[];
12
+ readonly baseClaimStakeRentRate: readonly (readonly WorldFixedValue[])[];
13
+ readonly baseClaimStakePlacementFee: readonly (readonly WorldFixedValue[])[];
14
+ readonly resources: readonly WorldPlanetResourceData[];
15
+ readonly providedTags: readonly number[];
16
+ readonly claimedPlotsUnsizedLength: number;
17
+ readonly claimedPlots: readonly WorldClaimStakeGroupData[];
18
+ }
19
+ interface CelestialBodyCommonSnapshot {
20
+ readonly address: Address;
21
+ readonly game: Address;
22
+ readonly id: number;
23
+ readonly name: string;
24
+ readonly system: EntityRef<'starSystem'>;
25
+ readonly systemSequenceId: bigint;
26
+ }
27
+ type CelestialBodySnapshot = CelestialBodyCommonSnapshot & ({
28
+ readonly kind: 'planet';
29
+ readonly details: PlanetDetails;
30
+ } | {
31
+ readonly kind: 'asteroid';
32
+ readonly details: {
33
+ readonly resources: readonly unknown[];
34
+ };
35
+ });
36
+ interface StarbasePlayerSnapshot {
37
+ readonly kind: 'starbasePlayer';
38
+ readonly address: Address;
39
+ readonly playerProfile: EntityRef<'profile'>;
40
+ readonly system: EntityRef<'starSystem'>;
41
+ readonly character: EntityRef<'character'>;
42
+ readonly availableCrew: number;
43
+ readonly cargo: {
44
+ readonly items: readonly {
45
+ readonly id: number;
46
+ readonly name: string;
47
+ readonly quantityRaw: bigint;
48
+ }[];
49
+ };
50
+ }
51
+ /** Exact address-only inputs for placing one Claim Stake and its bundled hub.
52
+ *
53
+ * `initialRentAmount` is a positive raw unsigned-u64 amount. `claimStake` is a
54
+ * new caller-created signer whose public address is retained without key
55
+ * material.
56
+ *
57
+ * @example
58
+ * ```ts
59
+ * declare const authorization: PlanAuthorization;
60
+ * declare const claimStake: Address;
61
+ * const options: PlanPlaceClaimStakeOptions = {
62
+ * authorization,
63
+ * claimStake,
64
+ * claimStakeDefinitionId: 2,
65
+ * hubBuildingId: 21,
66
+ * initialRentAmount: 500_000_000n,
67
+ * };
68
+ * ```
69
+ */
70
+ export interface PlanPlaceClaimStakeOptions {
71
+ readonly authorization: PlanAuthorization;
72
+ readonly claimStake: Address;
73
+ readonly claimStakeDefinitionId: number;
74
+ readonly hubBuildingId: number;
75
+ readonly initialRentAmount: bigint;
76
+ }
77
+ /** One bounded Claim Stake building addition or removal.
78
+ *
79
+ * The positive `quantity` is translated to the generated instruction's signed
80
+ * delta. Each building id may appear only once in a plan.
81
+ *
82
+ * @example
83
+ * ```ts
84
+ * const change: ClaimStakeBuildingChange = {
85
+ * buildingId: 9,
86
+ * kind: 'add',
87
+ * quantity: 2,
88
+ * };
89
+ * ```
90
+ */
91
+ export type ClaimStakeBuildingChange = {
92
+ readonly buildingId: number;
93
+ readonly kind: 'add';
94
+ readonly quantity: number;
95
+ } | {
96
+ readonly buildingId: number;
97
+ readonly kind: 'remove';
98
+ readonly quantity: number;
99
+ };
100
+ /** Exact inputs for changing one owned Claim Stake's building design.
101
+ *
102
+ * `buildingChanges` is a non-empty dense list with one positive add/remove
103
+ * quantity per building id.
104
+ *
105
+ * @example
106
+ * ```ts
107
+ * declare const authorization: PlanAuthorization;
108
+ * const options: PlanClaimStakeBuildingChangesOptions = {
109
+ * authorization,
110
+ * buildingChanges: [{ buildingId: 9, kind: 'add', quantity: 2 }],
111
+ * };
112
+ * ```
113
+ */
114
+ export interface PlanClaimStakeBuildingChangesOptions {
115
+ readonly authorization: PlanAuthorization;
116
+ readonly buildingChanges: readonly ClaimStakeBuildingChange[];
117
+ }
118
+ /** Exact inputs for finalizing one owned Claim Stake building design.
119
+ *
120
+ * @example
121
+ * ```ts
122
+ * declare const authorization: PlanAuthorization;
123
+ * const options: PlanFinalizeClaimStakeBuildingChangesOptions = {
124
+ * authorization,
125
+ * };
126
+ * ```
127
+ */
128
+ export interface PlanFinalizeClaimStakeBuildingChangesOptions {
129
+ readonly authorization: PlanAuthorization;
130
+ }
131
+ /** Exact inputs for cancelling one owned Claim Stake building design.
132
+ *
133
+ * @example
134
+ * ```ts
135
+ * declare const authorization: PlanAuthorization;
136
+ * const options: PlanCancelClaimStakeBuildingChangesOptions = {
137
+ * authorization,
138
+ * };
139
+ * ```
140
+ */
141
+ export interface PlanCancelClaimStakeBuildingChangesOptions {
142
+ readonly authorization: PlanAuthorization;
143
+ }
144
+ /** Exact inputs for deconstructing one owned active Claim Stake.
145
+ *
146
+ * @example
147
+ * ```ts
148
+ * declare const authorization: PlanAuthorization;
149
+ * const options: PlanDeconstructClaimStakeOptions = { authorization };
150
+ * ```
151
+ */
152
+ export interface PlanDeconstructClaimStakeOptions {
153
+ readonly authorization: PlanAuthorization;
154
+ }
155
+ /** Exact inputs for topping up one owned placed Claim Stake's rent.
156
+ *
157
+ * `amount` is a positive raw unsigned-u64 amount, not a display ATLAS value.
158
+ *
159
+ * @example
160
+ * ```ts
161
+ * declare const authorization: PlanAuthorization;
162
+ * const options: PlanTopUpClaimStakeRentOptions = {
163
+ * amount: 500_000_000n,
164
+ * authorization,
165
+ * };
166
+ * ```
167
+ */
168
+ export interface PlanTopUpClaimStakeRentOptions {
169
+ readonly amount: bigint;
170
+ readonly authorization: PlanAuthorization;
171
+ }
172
+ /** One exact raw cargo request for starting a Claim Stake Fleet transfer.
173
+ *
174
+ * @example
175
+ * ```ts
176
+ * const request: ClaimStakeFleetTransferCargoRequest = {
177
+ * cargoId: 3,
178
+ * amount: 25n,
179
+ * };
180
+ * ```
181
+ */
182
+ export interface ClaimStakeFleetTransferCargoRequest {
183
+ readonly cargoId: number;
184
+ readonly amount: bigint;
185
+ }
186
+ /** Exact bidirectional cargo inputs for starting one Claim Stake Fleet transfer.
187
+ *
188
+ * `load` moves cargo from the Claim Stake to the Fleet; `unload` moves cargo
189
+ * from the Fleet to the Claim Stake. At least one list must contain a request,
190
+ * and each cargo id may appear only once across both dense lists.
191
+ *
192
+ * @example
193
+ * ```ts
194
+ * declare const authorization: PlanAuthorization;
195
+ * const options: PlanStartClaimStakeFleetTransferOptions = {
196
+ * authorization,
197
+ * load: [{ cargoId: 3, amount: 25n }],
198
+ * unload: [{ cargoId: 1, amount: 10n }],
199
+ * };
200
+ * ```
201
+ */
202
+ export interface PlanStartClaimStakeFleetTransferOptions {
203
+ readonly authorization: PlanAuthorization;
204
+ readonly load: readonly ClaimStakeFleetTransferCargoRequest[];
205
+ readonly unload: readonly ClaimStakeFleetTransferCargoRequest[];
206
+ }
207
+ /** Exact inputs for recovering one provably stuck Claim Stake Fleet transfer.
208
+ *
209
+ * `atUnixSeconds` is an explicit non-negative Unix timestamp used to prove the
210
+ * transfer lock has elapsed. The planner never reads a local clock.
211
+ *
212
+ * @example
213
+ * ```ts
214
+ * declare const authorization: PlanAuthorization;
215
+ * const options: PlanRecoverClaimStakeFleetTransferOptions = {
216
+ * atUnixSeconds: 1_700_000_100n,
217
+ * authorization,
218
+ * };
219
+ * ```
220
+ */
221
+ export interface PlanRecoverClaimStakeFleetTransferOptions {
222
+ readonly atUnixSeconds: bigint;
223
+ readonly authorization: PlanAuthorization;
224
+ }
225
+ interface FleetSnapshot extends Omit<ResolvedFleetAccountData, 'ownerProfile'> {
226
+ readonly kind: 'fleet';
227
+ readonly address: Address;
228
+ readonly ownerProfile: EntityRef<'profile'>;
229
+ toJSON(): unknown;
230
+ }
231
+ /** Plans placement of one Claim Stake with its exact bundled hub.
232
+ *
233
+ * The planner validates the configured Game/Profile/Character/System/Body
234
+ * graph, current catalog membership, known plot/cargo/crew availability, and
235
+ * absence of the caller-created Claim Stake account. It returns one inert Plan;
236
+ * permissions, placement races, rent arithmetic, and program capacity remain
237
+ * chain-authoritative.
238
+ *
239
+ * @example
240
+ * ```ts
241
+ * declare const ctx: SageContext;
242
+ * declare const body: CelestialBodySnapshot;
243
+ * declare const player: StarbasePlayerSnapshot;
244
+ * declare const options: PlanPlaceClaimStakeOptions;
245
+ * const plan = await planPlaceClaimStake(ctx, body, player, options);
246
+ * console.log(plan.describe());
247
+ * ```
248
+ */
249
+ export declare function planPlaceClaimStake(ctx: SageContext, body: CelestialBodySnapshot, player: StarbasePlayerSnapshot, input: PlanPlaceClaimStakeOptions): Promise<Plan>;
250
+ /** Plans one exact set of additions/removals for an owned active/design Claim Stake.
251
+ *
252
+ * The planner verifies the fresh Claim Stake, definition sequences, canonical
253
+ * Profile/Character/Body/System/Starbase Player graph, optional
254
+ * FactionOwnership sidecar, building quantities, slots, crew, and known
255
+ * construction cargo. Rent synchronization and the final concurrent sequence
256
+ * race remain chain-authoritative.
257
+ *
258
+ * @example
259
+ * ```ts
260
+ * declare const ctx: SageContext;
261
+ * declare const stake: ClaimStakeSnapshot;
262
+ * declare const options: PlanClaimStakeBuildingChangesOptions;
263
+ * const plan = await planClaimStakeBuildingChanges(ctx, stake, options);
264
+ * console.log(plan.describe());
265
+ * ```
266
+ */
267
+ export declare function planClaimStakeBuildingChanges(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanClaimStakeBuildingChangesOptions): Promise<Plan>;
268
+ /** Plans finalization of one owned Claim Stake building design.
269
+ *
270
+ * The planner requires a fresh design state, a coherent configured
271
+ * Game/Character/Planet/System/Starbase Player graph, the canonical
272
+ * CurrencyCache, and a known positive rent balance. Rent timing and the final
273
+ * crew/building validation remain chain-authoritative.
274
+ *
275
+ * @example
276
+ * ```ts
277
+ * declare const ctx: SageContext;
278
+ * declare const stake: ClaimStakeSnapshot;
279
+ * declare const authorization: PlanAuthorization;
280
+ * const plan = await planFinalizeClaimStakeBuildingChanges(ctx, stake, {
281
+ * authorization,
282
+ * });
283
+ * // The program re-synchronizes rent at execution.
284
+ * console.log(plan.describe());
285
+ * ```
286
+ */
287
+ export declare function planFinalizeClaimStakeBuildingChanges(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanFinalizeClaimStakeBuildingChangesOptions): Promise<Plan>;
288
+ /** Plans cancellation of one owned Claim Stake building design.
289
+ *
290
+ * The planner requires a fresh design state and a coherent configured
291
+ * Game/Claim Stake/Planet/System/Starbase Player graph. The program
292
+ * re-synchronizes rent at execution and returns the Claim Stake to active
293
+ * state; rent arithmetic and concurrent state transitions remain
294
+ * chain-authoritative.
295
+ *
296
+ * @example
297
+ * ```ts
298
+ * declare const ctx: SageContext;
299
+ * declare const stake: ClaimStakeSnapshot;
300
+ * declare const authorization: PlanAuthorization;
301
+ * const plan = await planCancelClaimStakeBuildingChanges(ctx, stake, {
302
+ * authorization,
303
+ * });
304
+ * console.log(plan.describe());
305
+ * ```
306
+ */
307
+ export declare function planCancelClaimStakeBuildingChanges(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanCancelClaimStakeBuildingChangesOptions): Promise<Plan>;
308
+ /** Plans deconstruction of one owned active Claim Stake.
309
+ *
310
+ * The planner derives the current Planet chronology index and exact plot bucket
311
+ * from the Claim Stake definition tier and fresh Body plot matrix. The only
312
+ * remaining building must be the definition-compatible zero-cost bundled hub,
313
+ * which deconstruction discards.
314
+ * Rent settlement, cargo return, account closure, and concurrent races remain
315
+ * chain-authoritative; the Plan does not estimate a refund.
316
+ *
317
+ * @example
318
+ * ```ts
319
+ * declare const ctx: SageContext;
320
+ * declare const stake: ClaimStakeSnapshot;
321
+ * declare const authorization: PlanAuthorization;
322
+ * const plan = await planDeconstructClaimStake(ctx, stake, { authorization });
323
+ * console.log(plan.describe());
324
+ * ```
325
+ */
326
+ export declare function planDeconstructClaimStake(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanDeconstructClaimStakeOptions): Promise<Plan>;
327
+ /** Plans one exact raw rent top-up for an owned placed Claim Stake.
328
+ *
329
+ * The planner validates the fresh Claim Stake and its canonical
330
+ * Profile/Character/Planet/System/Starbase Player graph, plus the Character's
331
+ * known raw ATLAS balance. Permission checks, concurrent balance changes, rent
332
+ * arithmetic, and duration purchased remain chain-authoritative.
333
+ *
334
+ * @example
335
+ * ```ts
336
+ * declare const ctx: SageContext;
337
+ * declare const stake: ClaimStakeSnapshot;
338
+ * declare const authorization: PlanAuthorization;
339
+ * const plan = await planTopUpClaimStakeRent(ctx, stake, {
340
+ * amount: 500_000_000n,
341
+ * authorization,
342
+ * });
343
+ * console.log(plan.describe());
344
+ * ```
345
+ */
346
+ export declare function planTopUpClaimStakeRent(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanTopUpClaimStakeRentOptions): Promise<Plan>;
347
+ /** Plans the start of one Fleet transfer to an owned active Claim Stake.
348
+ *
349
+ * The planner validates the shared Profile/Game, idle Fleet with normalized
350
+ * crew, active Claim Stake, canonical Planet/System/Starbase Player graph,
351
+ * exact source balances, exact destination capacities, and an optional present
352
+ * FleetCrewBinding. The chain remains authoritative for range, duration,
353
+ * permission bits, concurrent state changes, and transfer arithmetic.
354
+ *
355
+ * @example
356
+ * ```ts
357
+ * declare const ctx: SageContext;
358
+ * declare const fleet: FleetSnapshot;
359
+ * declare const stake: ClaimStakeSnapshot;
360
+ * declare const authorization: PlanAuthorization;
361
+ * const plan = await planStartClaimStakeFleetTransfer(ctx, fleet, stake, {
362
+ * authorization,
363
+ * load: [{ cargoId: 3, amount: 25n }],
364
+ * unload: [{ cargoId: 1, amount: 10n }],
365
+ * });
366
+ * console.log(plan.describe());
367
+ * ```
368
+ */
369
+ export declare function planStartClaimStakeFleetTransfer(ctx: SageContext, fleet: FleetSnapshot, stake: ClaimStakeSnapshot, input: PlanStartClaimStakeFleetTransferOptions): Promise<Plan>;
370
+ /** Plans owner-authorized recovery of one provably non-executable Claim Stake transfer.
371
+ *
372
+ * Recovery is available only after the explicit transfer lock time and only
373
+ * when fresh Fleet/Claim Stake cargo and Game definition state proves a source
374
+ * shortfall, invalid queued cargo id, or destination overflow. An executable
375
+ * transfer is rejected so callers use the permissionless normal exit instead.
376
+ * Recovery returns the Fleet to idle without moving cargo or changing the
377
+ * Claim Stake.
378
+ *
379
+ * @example
380
+ * ```ts
381
+ * declare const ctx: SageContext;
382
+ * declare const fleet: FleetSnapshot;
383
+ * declare const stake: ClaimStakeSnapshot;
384
+ * declare const authorization: PlanAuthorization;
385
+ * const plan = await planRecoverClaimStakeFleetTransfer(ctx, fleet, stake, {
386
+ * atUnixSeconds: 1_700_000_100n,
387
+ * authorization,
388
+ * });
389
+ * console.log(plan.describe());
390
+ * ```
391
+ */
392
+ export declare function planRecoverClaimStakeFleetTransfer(ctx: SageContext, fleet: FleetSnapshot, stake: ClaimStakeSnapshot, input: PlanRecoverClaimStakeFleetTransferOptions): Promise<Plan>;
393
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/claim-stakes/actions/index.ts"],"names":[],"mappings":"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"}