@aephia/atlas-kit 0.7.0-next.2 → 0.7.0-next.3

package/dist/fleets/actions/disband.js

@@ -48,7 +48,7 @@ export async function planFleetDisband(ctx, fleet, input) {
     const [fleetRaw] = await readContextRawAccounts(ctx, [fleet]);
     if (!fleetRaw || fleetRaw.executable)
         throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'The selected Fleet is missing or executable. Refresh a valid owned Fleet and replan the disband.', { address: fleet });
-    const docked = fleetAccountDefinition.decode(fleetRaw).state;
+    const docked = fleetAccountDefinition.decode(fleetRaw, ctx.programs).state;
     if (docked.kind !== 'docked')
         throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'Only a Docked Fleet can disband. Dock it at a Starbase where the Character has a current StarbasePlayer and replan.', { address: fleet });
     const intent = {
@@ -59,7 +59,7 @@ export async function planFleetDisband(ctx, fleet, input) {
         fleet,
         system: docked.system,
     };
-    const resolved = await resolveFleetDisband(intent);
+    const resolved = await resolveFleetDisband(ctx.programs, intent);
     const addresses = [
         resolved.profile,
         resolved.character,
@@ -72,13 +72,13 @@ export async function planFleetDisband(ctx, fleet, input) {
     const raw = await readContextRawAccounts(ctx, addresses);
     const accounts = new Map(addresses.map((address, index) => [address, raw[index]]));
     accounts.set(fleet, fleetRaw);
-    const { fleet: data } = await validateFleetDisband(intent, resolved, accounts);
-    const instruction = disbandFleetInstruction({
+    const { fleet: data } = await validateFleetDisband(ctx.programs, intent, resolved, accounts);
+    const instruction = disbandFleetInstruction(ctx.programs, {
         ...intent,
         character: resolved.character,
         starbasePlayer: resolved.starbasePlayer,
     });
-    const storage = planStorageFunding({
+    const storage = planStorageFunding(ctx.programs, {
         action: readDisbandStorageAction(instruction, accounts),
         accounts,
         label: 'Fleet disband',
@@ -87,7 +87,7 @@ export async function planFleetDisband(ctx, fleet, input) {
         .map(({ shipId, quantity }) => `${String(quantity)} of configuration ${String(shipId)}`)
         .join(', ');
     const summary = `Disband Fleet ${data.name} (${fleet}) at StarbasePlayer ${resolved.starbasePlayer}: ${ships || 'no ships'} return to its hangar, ${String(data.crewCount)} crew return to it, and the Fleet's fuel, ammo, cargo hold and components merge into its cargo. The Character's Fleet slot is freed, and the Fleet closes, refunding its ${String(fleetRaw.lamports)}-lamport balance to Profile ${intent.profile}. ${storage.disclosure} The program also needs full AP and SP when the instruction runs. Transaction fees are separate. Simulate before signing; the chain stays authoritative.`;
-    return buildPlannerPlan({
+    return buildPlannerPlan(ctx.programs, {
         kind: 'fleets.disband',
         summary,
         preconditions: [

package/dist/fleets/actions/disband.js.map

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

package/dist/fleets/actions/dock-bounds.d.ts

@@ -11,7 +11,7 @@ import { type DockBoundsUnavailableReason } from '../../internal/planning/fleet-
  */
 export type FleetDockDebitBounds = {
     readonly status: 'unavailable';
-    readonly reason: DockBoundsUnavailableReason | 'not-fleet-dock' | 'multiple-fleet-docks' | 'combined-plan';
+    readonly reason: DockBoundsUnavailableReason | 'not-fleet-dock' | 'multiple-fleet-docks' | 'combined-plan' | 'unqualified-deployment';
     toJSON(): unknown;
 } | {
     readonly status: 'available';
@@ -25,7 +25,8 @@ export type FleetDockDebitBounds = {
     toJSON(): unknown;
 };
 /** Inspects the persisted docking ceiling without network I/O. Inspect individual
- * Plans before combining distinct Fleets. Fresh pre-sign checks are not an atomic
+ * Plans before combining distinct Fleets. The ceiling is qualified for the
+ * z.ink PTR deployment only; any other deployment is `unqualified-deployment`. Fresh pre-sign checks are not an atomic
  * on-chain spending cap; state can change before landing.
  * @example
  * ```ts

package/dist/fleets/actions/dock-bounds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dock-bounds.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/dock-bounds.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,qDAAqD,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EACX,2BAA2B,GAC3B,gBAAgB,GAChB,sBAAsB,GACtB,eAAe,CAAC;IACpB,MAAM,IAAI,OAAO,CAAC;CACnB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,uBAAuB,EAAE,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IACrC,MAAM,IAAI,OAAO,CAAC;CACnB,CAAC;AAEN;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,oBAAoB,CA6CxE"}
+{"version":3,"file":"dock-bounds.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/dock-bounds.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,qDAAqD,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EACX,2BAA2B,GAC3B,gBAAgB,GAChB,sBAAsB,GACtB,eAAe,GACf,wBAAwB,CAAC;IAC7B,MAAM,IAAI,OAAO,CAAC;CACnB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,uBAAuB,EAAE,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IACrC,MAAM,IAAI,OAAO,CAAC;CACnB,CAAC;AAEN;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,oBAAoB,CAoDxE"}

package/dist/fleets/actions/dock-bounds.js

@@ -1,9 +1,11 @@
 import { attachJsonSerialization } from '../../internal/json.js';
 import { InvalidActionInputError } from '../../client/errors.js';
 import { isPlanInstance } from '../../planning/plan-instances.js';
+import { isDebitQualifiedDeployment } from '../../internal/planning/qualified-deployment.js';
 import { MAXIMUM_DOCK_GROWTH_BYTES, } from '../../internal/planning/fleet-dock-funding-guard.js';
 /** Inspects the persisted docking ceiling without network I/O. Inspect individual
- * Plans before combining distinct Fleets. Fresh pre-sign checks are not an atomic
+ * Plans before combining distinct Fleets. The ceiling is qualified for the
+ * z.ink PTR deployment only; any other deployment is `unqualified-deployment`. Fresh pre-sign checks are not an atomic
  * on-chain spending cap; state can change before landing.
  * @example
  * ```ts
@@ -26,6 +28,11 @@ export function getFleetDockDebitBounds(plan) {
             status: 'unavailable',
             reason: 'combined-plan',
         }));
+    if (!isDebitQualifiedDeployment(plan.programs))
+        return Object.freeze(attachJsonSerialization({
+            status: 'unavailable',
+            reason: 'unqualified-deployment',
+        }));
     const guard = guards[0];
     if (guard.status === 'unavailable')
         return Object.freeze(attachJsonSerialization({

package/dist/fleets/actions/dock-bounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"dock-bounds.js","sourceRoot":"","sources":["../../../src/fleets/actions/dock-bounds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EACL,yBAAyB,GAE1B,MAAM,qDAAqD,CAAC;AAgC7D;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAU;IAChD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QACvB,MAAM,IAAI,uBAAuB,CAC/B,MAAM,EACN,IAAI,EACJ,wCAAwC,EACxC,8EAA8E,CAC/E,CAAC;IACJ,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CACvC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QACrB,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,sBAAsB;SAC/D,CAAC,CACZ,CAAC;IACJ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,eAAe;SACf,CAAC,CACZ,CAAC;IACJ,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACzB,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa;QAChC,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,KAAK,CAAC,MAAM;SACZ,CAAC,CACZ,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;QACtB,MAAM,EAAE,WAAW;QACnB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,UAAU;QACvB,uBAAuB,EAAE,yBAAyB;QAClD,eAAe,EAAE,UAAU;KACnB,CAAC,CACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"dock-bounds.js","sourceRoot":"","sources":["../../../src/fleets/actions/dock-bounds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EACL,yBAAyB,GAE1B,MAAM,qDAAqD,CAAC;AAiC7D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAU;IAChD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QACvB,MAAM,IAAI,uBAAuB,CAC/B,MAAM,EACN,IAAI,EACJ,wCAAwC,EACxC,8EAA8E,CAC/E,CAAC;IACJ,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CACvC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QACrB,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,sBAAsB;SAC/D,CAAC,CACZ,CAAC;IACJ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,eAAe;SACf,CAAC,CACZ,CAAC;IACJ,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC5C,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,wBAAwB;SACxB,CAAC,CACZ,CAAC;IACJ,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACzB,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa;QAChC,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;YACtB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,KAAK,CAAC,MAAM;SACZ,CAAC,CACZ,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;QACtB,MAAM,EAAE,WAAW;QACnB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,UAAU;QACvB,uBAAuB,EAAE,yBAAyB;QAClD,eAAe,EAAE,UAAU;KACnB,CAAC,CACZ,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fleets/actions/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAa,KAAK,OAAO,EAAoB,MAAM,aAAa,CAAC;AAExE,OAAO,KAAK,EAEV,WAAW,EAEZ,MAAM,2BAA2B,CAAC;AA8CnC,OAAO,EAQL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,KAAK,EACV,IAAI,EAGL,MAAM,yBAAyB,CAAC;AAOjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAqBlC;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,kCAAkC,GAC1C;IACE,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEN;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AA6gCD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAsGf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAiEf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiHf;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA6Lf;AAED,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,4BAA4B,GAClC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC"}

package/dist/fleets/actions/index.js

@@ -112,8 +112,8 @@ function requireNormalizedCrew(data, fleet, action, requireShips = false) {
     if (requireShips && data.fleetShips.length === 0)
         fail(`Fleet ${fleet.name} has no ships and cannot ${action}. Add ships while docked, refresh the Fleet, and retry.`, fleet.address);
 }
-function validateFleetRead(account, fleet, game, system, systemSequenceId) {
-    const data = fleetAccountDefinition.decode(account);
+function validateFleetRead(programs, account, fleet, game, system, systemSequenceId) {
+    const data = fleetAccountDefinition.decode(account, programs);
     if (account.address !== fleet.address ||
         data.game !== game ||
         data.ownerProfile !== fleet.ownerProfile.address ||
@@ -127,17 +127,18 @@ function validateFleetRead(account, fleet, game, system, systemSequenceId) {
 }
 /** Requires a Star System of the configured Game at its canonical PDA and,
  * for a docked Fleet, at the docked sequence. */
-async function validateFleetSystemRead(account, fleet, game, action, label = 'Star System', sequenceId) {
-    const data = starSystemAccountDefinition.decode(account);
+async function validateFleetSystemRead(programs, account, fleet, game, action, label = 'Star System', sequenceId) {
+    const data = starSystemAccountDefinition.decode(account, programs);
     if (data.game !== game ||
-        (await deriveStarSystemAddress(game, data.systemId)) !== account.address ||
+        (await deriveStarSystemAddress(programs, game, data.systemId)) !==
+            account.address ||
         (sequenceId !== undefined && data.sequenceId !== sequenceId)) {
         fail(`Fleet ${fleet.name} cannot ${action} because ${label} ${account.address} does not match the configured Game${sequenceId === undefined ? ' or its canonical PDA' : ', its canonical PDA or the docked sequence'}. Refresh the Fleet and galaxy, then retry.`, account.address);
     }
     return data;
 }
-function validateStarbasePlayerRead(account, fleet, profile, character, system, canonicalAddress, action = 'undock') {
-    const data = starbasePlayerAccountDefinition.decode(account);
+function validateStarbasePlayerRead(programs, account, fleet, profile, character, system, canonicalAddress, action = 'undock') {
+    const data = starbasePlayerAccountDefinition.decode(account, programs);
     if (account.address !== canonicalAddress ||
         data.playerProfile !== profile ||
         data.character !== character ||
@@ -215,9 +216,9 @@ function resolveCoordinateDestination(fleet, actionLocation, options) {
 }
 /** Requires the authorization Profile's canonical Character in the
  * configured Game. */
-function requireFleetCharacter(account, fleet, profile, game, address, action) {
+function requireFleetCharacter(programs, account, fleet, profile, game, address, action) {
     const character = requireRawAccount(account, `Fleet ${fleet.name} cannot ${action} because its Profile has no canonical Character at ${address}. Create the Character for Profile ${profile} in the configured Game, refresh the Fleet, and retry.`, address);
-    const data = characterAccountDefinition.decode(character);
+    const data = characterAccountDefinition.decode(character, programs);
     if (character.address !== address ||
         data.playerProfile !== profile ||
         data.game !== game) {
@@ -225,9 +226,9 @@ function requireFleetCharacter(account, fleet, profile, game, address, action) {
     }
     return character;
 }
-async function validateIdleFleetRead(account, fleet, game, actionLocation, planName = 'coordinate movement') {
-    const data = fleetAccountDefinition.decode(account);
-    const canonicalAddress = await deriveFleetAddress(data);
+async function validateIdleFleetRead(programs, account, fleet, game, actionLocation, planName = 'coordinate movement') {
+    const data = fleetAccountDefinition.decode(account, programs);
+    const canonicalAddress = await deriveFleetAddress(programs, data);
     const stateLocation = data.state.kind === 'idle'
         ? data.location
         : data.state.kind === 'warp' || data.state.kind === 'subwarp'
@@ -261,15 +262,15 @@ async function validateIdleFleetRead(account, fleet, game, actionLocation, planN
         npc: data.npcFactionId !== 0,
     };
 }
-function validateRegionTrackerRead(account, fleet, game, canonicalAddress, action = 'move') {
-    const data = regionTrackerAccountDefinition.decode(account);
+function validateRegionTrackerRead(programs, account, fleet, game, canonicalAddress, action = 'move') {
+    const data = regionTrackerAccountDefinition.decode(account, programs);
     if (account.address !== canonicalAddress || data.game !== game) {
         fail(`Fleet ${fleet.name} cannot ${action} because RegionTracker does not match the configured Game or canonical PDA: ${account.address}; refresh the world region data for the configured Game and retry.`, account.address);
     }
     return getRegionTrackerDecoder().decode(account.data);
 }
-function validateCrewBindingRead(account, fleet, canonicalAddress) {
-    const data = fleetCrewBindingAccountDefinition.decode(account);
+function validateCrewBindingRead(programs, account, fleet, canonicalAddress) {
+    const data = fleetCrewBindingAccountDefinition.decode(account, programs);
     if (account.address !== canonicalAddress ||
         !matchesFleetCrewBindingIdentity(data, fleet.address, fleet.ownerProfile.address)) {
         fail(`FleetCrewBinding does not match Fleet ${fleet.address}, its owner Profile, or its canonical PDA: ${account.address}. Refresh the Fleet crew registration or remove the invalid binding before retrying.`, account.address);
@@ -290,9 +291,9 @@ function exactCoordinate(coordinate) {
 async function resolveCoordinateMovement(mode, ctx, fleet, authorization, actionLocation, destination) {
     const game = requireGameAddress(ctx);
     const [character, regionTracker, crewBinding] = await Promise.all([
-        findCharacterPda(authorization.profile, game),
-        deriveRegionTrackerAddress(game),
-        deriveFleetCrewBindingAddress(fleet.address),
+        findCharacterPda(ctx.programs, authorization.profile, game),
+        deriveRegionTrackerAddress(ctx.programs, game),
+        deriveFleetCrewBindingAddress(ctx.programs, fleet.address),
     ]);
     const [fleetCandidate, characterCandidate, regionCandidate, crewCandidate] = await readContextRawAccounts(ctx, [
         fleet.address,
@@ -301,9 +302,9 @@ async function resolveCoordinateMovement(mode, ctx, fleet, authorization, action
         crewBinding,
     ]);
     const fleetAccount = requireRawAccount(fleetCandidate, `Fleet ${fleet.name} is no longer available at ${fleet.address}. Refresh the Fleet and retry planning coordinate movement.`, fleet.address);
-    const characterAccount = requireFleetCharacter(characterCandidate, fleet, authorization.profile, game, character, 'move');
+    const characterAccount = requireFleetCharacter(ctx.programs, characterCandidate, fleet, authorization.profile, game, character, 'move');
     const regionTrackerAccount = requireRawAccount(regionCandidate, `Fleet ${fleet.name} cannot move because the canonical RegionTracker ${regionTracker} is missing. Verify the configured Game and cluster, refresh the world region data, and retry.`, regionTracker);
-    const validatedFleet = await validateIdleFleetRead(fleetAccount, fleet, game, actionLocation);
+    const validatedFleet = await validateIdleFleetRead(ctx.programs, fleetAccount, fleet, game, actionLocation);
     requireNormalizedCrew(validatedFleet.data, fleet, mode);
     if (destination.exact.x === validatedFleet.location.x &&
         destination.exact.y === validatedFleet.location.y) {
@@ -313,17 +314,17 @@ async function resolveCoordinateMovement(mode, ctx, fleet, authorization, action
         isSubPrecisionRoute(validatedFleet.location, destination.exact)) {
         fail(`Fleet ${fleet.name} ${destination.field} ${destination.description} is closer to its action coordinate than the program can measure, so this subwarp would be refused. Choose a destination farther away and retry.`, fleet.address);
     }
-    const tracker = validateRegionTrackerRead(regionTrackerAccount, fleet, game, regionTracker);
+    const tracker = validateRegionTrackerRead(ctx.programs, regionTrackerAccount, fleet, game, regionTracker);
     if (crewCandidate !== undefined) {
-        validateCrewBindingRead(crewCandidate, fleet, crewBinding);
+        validateCrewBindingRead(ctx.programs, crewCandidate, fleet, crewBinding);
     }
     const destinationRegionId = resolveRegionId(tracker, destination.exact);
     // A player Fleet may cross deep space, but stopping there needs High Risk
     // zone access.
     if (destinationRegionId === null &&
         !validatedFleet.npc &&
-        characterAccountDefinition.decode(characterAccount).modifiers.values
-            .securityZoneAccess !== 'high') {
+        characterAccountDefinition.decode(characterAccount, ctx.programs).modifiers
+            .values.securityZoneAccess !== 'high') {
         fail(`Fleet ${fleet.name} ${destination.field} ${destination.field === 'destinationRaw' ? `(${String(destination.exact.x)}, ${String(destination.exact.y)}) raw I8F56` : destination.description} is in deep space, outside every Region, and its Character lacks the High Risk zone access needed to stop there. Research High Risk zone access or choose a destination inside a Region, then retry.`, character);
     }
     return {
@@ -352,8 +353,8 @@ async function planMovementStorage(ctx, instruction, fleetAccount, profile) {
         [profile, profileAccount],
         [RENT_ADDRESS, rentAccount],
     ]);
-    return planStorageFunding({
-        action: readMovementStorageAction(instruction, accounts),
+    return planStorageFunding(ctx.programs, {
+        action: readMovementStorageAction(ctx.programs, instruction, accounts),
         accounts,
         label: 'movement start',
     });
@@ -384,11 +385,11 @@ async function planCoordinateMovement(mode, ctx, fleet, options) {
         startRegionId: resolved.startRegionId,
     };
     const instruction = mode === 'subwarp'
-        ? adaptStartSubwarpInstruction({
+        ? adaptStartSubwarpInstruction(ctx.programs, {
             ...common,
             toCoordinate: [destination.exact.x, destination.exact.y],
         })
-        : adaptWarpToCoordinateInstruction({
+        : adaptWarpToCoordinateInstruction(ctx.programs, {
             ...common,
             destination: [destination.exact.x, destination.exact.y],
         });
@@ -406,7 +407,7 @@ async function planCoordinateMovement(mode, ctx, fleet, options) {
         await accountStatePrecondition(resolved.fleetAccount, fleet.state.kind === 'idle'
             ? `Fleet ${fleet.name} remains idle at coordinate (${String(actionLocation.x)}, ${String(actionLocation.y)}).`
             : `Fleet ${fleet.name} remains ${fleet.state.kind} with action coordinate (${String(actionLocation.x)}, ${String(actionLocation.y)}).`),
-        await characterAccessPrecondition(resolved.characterAccount, { game, profile: options.authorization.profile }, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game with the research modifiers that set its movement and Region access; its ATLAS, XP and asset counts may change.`),
+        await characterAccessPrecondition(ctx.programs, resolved.characterAccount, { game, profile: options.authorization.profile }, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game with the research modifiers that set its movement and Region access; its ATLAS, XP and asset counts may change.`),
         {
             kind: 'region-path',
             address: resolved.regionTracker,
@@ -416,7 +417,7 @@ async function planCoordinateMovement(mode, ctx, fleet, options) {
             fromY: resolved.from.y,
             toX: destination.exact.x,
             toY: destination.exact.y,
-            pathHash: await hashRegionPath(resolved.regionTrackerAccount, game, resolved.from, destination.exact),
+            pathHash: await hashRegionPath(ctx.programs, resolved.regionTrackerAccount, game, resolved.from, destination.exact),
             describes: `The Regions Fleet ${fleet.name}'s straight path to ${destination.description} can cross keep their borders, owner, safety status and risk zone, and no Region is added or removed; other Regions may change.`,
         },
         ...(resolved.crewBindingAccount === undefined
@@ -426,7 +427,7 @@ async function planCoordinateMovement(mode, ctx, fleet, options) {
             ]),
         storage.guard,
     ];
-    return buildPlannerPlan({
+    return buildPlannerPlan(ctx.programs, {
         kind: mode === 'subwarp' ? 'fleet.subwarp' : 'fleet.warp-to-coordinate',
         preconditions: accounts,
         steps: [
@@ -440,8 +441,8 @@ async function planCoordinateMovement(mode, ctx, fleet, options) {
         summary: description,
     });
 }
-function hasExactSystemLocation(account, location) {
-    starSystemAccountDefinition.decode(account);
+function hasExactSystemLocation(programs, account, location) {
+    starSystemAccountDefinition.decode(account, programs);
     const exact = getStarSystemDecoder().decode(account.data);
     return (exact.coordinates[0].raw === location.x &&
         exact.coordinates[1].raw === location.y);
@@ -458,19 +459,19 @@ async function discoverSystemsAt(ctx, game, location) {
         .map(({ address }) => address);
 }
 /** Selects the one fresh candidate whose exact coordinate is the Fleet's. */
-function selectSystemAt(fleet, location, exact, candidates, accounts) {
-    const matches = accounts.filter((account) => account !== undefined && hasExactSystemLocation(account, exact));
+function selectSystemAt(programs, fleet, location, exact, candidates, accounts) {
+    const matches = accounts.filter((account) => account !== undefined && hasExactSystemLocation(programs, account, exact));
     if (matches.length === 1)
         return matches[0];
     const coordinate = `Fleet ${fleet.name} action coordinate (${String(location.x)}, ${String(location.y)})`;
     if (candidates.length === 1) {
         const [only] = accounts;
-        fail(`${coordinate} no longer matches Star System ${only === undefined ? candidates[0] : starSystemAccountDefinition.decode(only).name}. Refresh the Fleet and galaxy, then retry.`, candidates[0]);
+        fail(`${coordinate} no longer matches Star System ${only === undefined ? candidates[0] : starSystemAccountDefinition.decode(only, programs).name}. Refresh the Fleet and galaxy, then retry.`, candidates[0]);
     }
     return fail(`${coordinate} matches multiple Star Systems in the configured Game. Refresh the galaxy and repair the contradictory System data before retrying.`, fleet.address);
 }
-function validateFactionRelationTrackerRead(account, fleet, game, canonicalAddress) {
-    const data = factionRelationTrackerAccountDefinition.decode(account);
+function validateFactionRelationTrackerRead(programs, account, fleet, game, canonicalAddress) {
+    const data = factionRelationTrackerAccountDefinition.decode(account, programs);
     if (account.address !== canonicalAddress || data.game !== game) {
         fail(`Fleet ${fleet.name} cannot use a warp lane because FactionRelationTracker ${account.address} does not match the configured Game or canonical PDA. Refresh the faction relation data and retry.`, account.address);
     }
@@ -482,10 +483,10 @@ async function resolveWarpLane(ctx, fleet, actionLocation, options) {
         fail(`Fleet ${fleet.name} action coordinate (${String(actionLocation.x)}, ${String(actionLocation.y)}) does not match a Star System in the configured Game. Refresh the galaxy or move the Fleet to a Star System before retrying.`, fleet.address);
     }
     const [character, currencyCache, factionRelationTracker, regionTracker] = await Promise.all([
-        findCharacterPda(options.authorization.profile, game),
-        deriveCurrencyCache(game).then(([address]) => address),
-        deriveFactionRelationTrackerAddress(game),
-        deriveRegionTrackerAddress(game),
+        findCharacterPda(ctx.programs, options.authorization.profile, game),
+        deriveCurrencyCache(ctx.programs, game).then(([address]) => address),
+        deriveFactionRelationTrackerAddress(ctx.programs, game),
+        deriveRegionTrackerAddress(ctx.programs, game),
     ]);
     const sourceOffset = 2;
     const destinationOffset = sourceOffset + sourceCandidates.length;
@@ -505,20 +506,20 @@ async function resolveWarpLane(ctx, fleet, actionLocation, options) {
     const factionCandidate = reads[destinationOffset + 2];
     const regionCandidate = reads[destinationOffset + 3];
     const fleetAccount = requireRawAccount(fleetCandidate, `Fleet ${fleet.name} is no longer available at ${fleet.address}. Refresh the Fleet and retry planning the warp lane.`, fleet.address);
-    const validatedFleet = await validateIdleFleetRead(fleetAccount, fleet, game, actionLocation, 'warp lane');
+    const validatedFleet = await validateIdleFleetRead(ctx.programs, fleetAccount, fleet, game, actionLocation, 'warp lane');
     requireNormalizedCrew(validatedFleet.data, fleet, 'use a warp lane');
-    const sourceAccount = selectSystemAt(fleet, actionLocation, validatedFleet.location, sourceCandidates, reads.slice(sourceOffset, destinationOffset));
+    const sourceAccount = selectSystemAt(ctx.programs, fleet, actionLocation, validatedFleet.location, sourceCandidates, reads.slice(sourceOffset, destinationOffset));
     const sourceSystem = sourceAccount.address;
-    const characterAccount = requireFleetCharacter(characterCandidate, fleet, options.authorization.profile, game, character, 'use a warp lane');
+    const characterAccount = requireFleetCharacter(ctx.programs, characterCandidate, fleet, options.authorization.profile, game, character, 'use a warp lane');
     const destinationAccount = requireRawAccount(destinationCandidate, `Fleet ${fleet.name} cannot use a warp lane because destination Star System ${options.destinationSystem} is missing. Choose a Star System in the configured Game, refresh the galaxy, and retry.`, options.destinationSystem);
     const currencyCacheAccount = requireRawAccount(currencyCandidate, `Fleet ${fleet.name} cannot use a warp lane because canonical CurrencyCache ${currencyCache} is missing. Verify the configured Game and cluster, refresh the Game currency configuration, and retry.`, currencyCache);
     const factionRelationTrackerAccount = requireRawAccount(factionCandidate, `Fleet ${fleet.name} cannot use a warp lane because canonical FactionRelationTracker ${factionRelationTracker} is missing. Verify the configured Game and cluster, refresh the faction relation data, and retry.`, factionRelationTracker);
     const regionTrackerAccount = requireRawAccount(regionCandidate, `Fleet ${fleet.name} cannot use a warp lane because canonical RegionTracker ${regionTracker} is missing. Verify the configured Game and cluster, refresh the world region data, and retry.`, regionTracker);
-    const source = await validateFleetSystemRead(sourceAccount, fleet, game, 'use a warp lane', 'source Star System');
-    const destination = await validateFleetSystemRead(destinationAccount, fleet, game, 'use a warp lane', 'destination Star System');
-    await validateCurrencyCache(currencyCacheAccount, game, 'warp lane');
-    validateFactionRelationTrackerRead(factionRelationTrackerAccount, fleet, game, factionRelationTracker);
-    validateRegionTrackerRead(regionTrackerAccount, fleet, game, regionTracker);
+    const source = await validateFleetSystemRead(ctx.programs, sourceAccount, fleet, game, 'use a warp lane', 'source Star System');
+    const destination = await validateFleetSystemRead(ctx.programs, destinationAccount, fleet, game, 'use a warp lane', 'destination Star System');
+    await validateCurrencyCache(ctx.programs, currencyCacheAccount, game, 'warp lane');
+    validateFactionRelationTrackerRead(ctx.programs, factionRelationTrackerAccount, fleet, game, factionRelationTracker);
+    validateRegionTrackerRead(ctx.programs, regionTrackerAccount, fleet, game, regionTracker);
     if (sourceSystem === options.destinationSystem) {
         fail(`Fleet ${fleet.name} destination Star System ${source.name} is its current Star System. Choose a different connected Star System and retry.`, options.destinationSystem);
     }
@@ -581,7 +582,7 @@ export async function planFleetWarpLane(ctx, fleet, options) {
         character: resolved.character,
         profile: options.authorization.profile,
     });
-    const instruction = adaptWarpLaneInstruction({
+    const instruction = adaptWarpLaneInstruction(ctx.programs, {
         ...xp.accounts,
         authorization: options.authorization,
         character: resolved.character,
@@ -595,7 +596,7 @@ export async function planFleetWarpLane(ctx, fleet, options) {
     });
     const storage = await planMovementStorage(ctx, instruction, resolved.fleetAccount, options.authorization.profile);
     const description = `Warp fleet ${fleet.name} from Star System ${resolved.source.name} to Star System ${resolved.destination.name} via warp lane. ${storage.disclosure}`;
-    return buildPlannerPlan({
+    return buildPlannerPlan(ctx.programs, {
         kind: 'fleet.warp-lane',
         preconditions: [
             {
@@ -609,7 +610,7 @@ export async function planFleetWarpLane(ctx, fleet, options) {
                 accountStatePrecondition(resolved.fleetAccount, fleet.state.kind === 'idle'
                     ? `Fleet ${fleet.name} remains idle at Star System ${resolved.source.name}.`
                     : `Fleet ${fleet.name} remains ${fleet.state.kind} at action source Star System ${resolved.source.name}.`),
-                characterAccessPrecondition(resolved.characterAccount, { game, profile: options.authorization.profile }, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game with the research modifiers that set its movement and Region access; its ATLAS, XP and asset counts may change.`),
+                characterAccessPrecondition(ctx.programs, resolved.characterAccount, { game, profile: options.authorization.profile }, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game with the research modifiers that set its movement and Region access; its ATLAS, XP and asset counts may change.`),
                 accountStatePrecondition(resolved.sourceAccount, `Source Star System ${resolved.source.name} remains at Fleet ${fleet.name}'s action coordinate with a connection to system id ${String(resolved.destination.systemId)}.`),
                 accountStatePrecondition(resolved.destinationAccount, `Destination Star System ${resolved.destination.name} remains system id ${String(resolved.destination.systemId)} in the configured Game.`),
                 Promise.resolve({
@@ -619,7 +620,7 @@ export async function planFleetWarpLane(ctx, fleet, options) {
                     describes: 'The canonical CurrencyCache retains its supported Game identity and layout; shared accounting may change.',
                 }),
                 accountStatePrecondition(resolved.factionRelationTrackerAccount, 'The canonical FactionRelationTracker remains assigned to the configured Game.'),
-                hashRegionAccess(resolved.regionTrackerAccount, resolved.destinationAccount, game).then((accessHash) => ({
+                hashRegionAccess(ctx.programs, resolved.regionTrackerAccount, resolved.destinationAccount, game).then((accessHash) => ({
                     kind: 'region-access',
                     address: resolved.regionTracker,
                     game,
@@ -717,7 +718,7 @@ export async function planFleetSettleArrival(ctx, fleet, input) {
         ? ' Fuel is below the recorded journey budget (at planning); may stop short with no Fuel.'
         : '';
     const description = `Settle subwarp: fuel and Career XP; possible rent refund to Profile ${intent.profile}. Settlement does not guarantee reaching the destination.${fuelWarning} Read confirmed state/location. A race could stop a new journey.`;
-    const instruction = adaptStopSubwarpInstruction({
+    const instruction = adaptStopSubwarpInstruction(ctx.programs, {
         authorization: intent.authorization,
         character,
         fleet: intent.fleet,
@@ -725,7 +726,7 @@ export async function planFleetSettleArrival(ctx, fleet, input) {
         regionTracker,
         ...xp.accounts,
     });
-    return buildPlannerPlan({
+    return buildPlannerPlan(ctx.programs, {
         kind: 'fleet.settle-arrival',
         preconditions: [
             {
@@ -777,18 +778,18 @@ export async function planFleetStopSubwarp(ctx, fleet, options) {
     if (fleet.state.kind !== 'subwarp' && fleet.state.kind !== 'idle')
         failFleetState(fleet, fleet.state.kind, 'stop subwarp', 'it must be subwarping or idle');
     const game = requireGameAddress(ctx);
-    const character = await findCharacterPda(options.authorization.profile, game);
-    const regionTracker = await deriveRegionTrackerAddress(game);
+    const character = await findCharacterPda(ctx.programs, options.authorization.profile, game);
+    const regionTracker = await deriveRegionTrackerAddress(ctx.programs, game);
     const [regionCandidate] = await readContextRawAccounts(ctx, [regionTracker]);
     const regionTrackerAccount = requireRawAccount(regionCandidate, `Canonical RegionTracker ${regionTracker} is missing. Verify the configured Game and cluster, refresh world region data, and retry stopping Fleet ${fleet.name}.`, regionTracker);
-    validateRegionTrackerRead(regionTrackerAccount, fleet, game, regionTracker, 'stop subwarp');
+    validateRegionTrackerRead(ctx.programs, regionTrackerAccount, fleet, game, regionTracker, 'stop subwarp');
     const xp = await resolveXpRuntime(ctx, {
         game,
         character,
         profile: options.authorization.profile,
     });
     const description = `Stop subwarp early for fleet ${fleet.name}; leave it idle if the trip already completed.`;
-    return buildPlannerPlan({
+    return buildPlannerPlan(ctx.programs, {
         kind: 'fleet.stop-subwarp',
         preconditions: [
             {
@@ -802,7 +803,7 @@ export async function planFleetStopSubwarp(ctx, fleet, options) {
         steps: [
             {
                 describes: description,
-                instruction: adaptStopSubwarpInstruction({
+                instruction: adaptStopSubwarpInstruction(ctx.programs, {
                     ...xp.accounts,
                     authorization: options.authorization,
                     character,
@@ -836,8 +837,8 @@ export async function planFleetUndock(ctx, fleet, options) {
     assertFleetOwner(fleet, options.authorization);
     const docked = requireDockedState(fleet);
     const game = requireGameAddress(ctx);
-    const characterAddress = await findCharacterPda(options.authorization.profile, game);
-    const starbasePlayerAddress = await deriveStarbasePlayerAddress(docked.system.address, characterAddress);
+    const characterAddress = await findCharacterPda(ctx.programs, options.authorization.profile, game);
+    const starbasePlayerAddress = await deriveStarbasePlayerAddress(ctx.programs, docked.system.address, characterAddress);
     const [fleetCandidate, characterCandidate, systemCandidate, playerCandidate] = await readContextRawAccounts(ctx, [
         fleet.address,
         characterAddress,
@@ -845,13 +846,13 @@ export async function planFleetUndock(ctx, fleet, options) {
         starbasePlayerAddress,
     ]);
     const fleetAccount = requireRawAccount(fleetCandidate, `Fleet ${fleet.name} is no longer available at ${fleet.address}. Refresh the Fleet and retry planning the undock action.`, fleet.address);
-    const characterAccount = requireFleetCharacter(characterCandidate, fleet, options.authorization.profile, game, characterAddress, 'undock');
+    const characterAccount = requireFleetCharacter(ctx.programs, characterCandidate, fleet, options.authorization.profile, game, characterAddress, 'undock');
     const systemAccount = requireRawAccount(systemCandidate, `Fleet ${fleet.name} is docked at Star System ${docked.system.address}, but that System account is missing. Verify the configured Game and cluster, refresh the Fleet, and retry.`, docked.system.address);
     const playerAccount = requireRawAccount(playerCandidate, `Fleet ${fleet.name} cannot undock because its Starbase Player registration is missing at ${starbasePlayerAddress}. Register the Character at this Starbase, refresh the Fleet, and retry.`, starbasePlayerAddress);
-    validateFleetRead(fleetAccount, fleet, game, docked.system.address, docked.systemSeqId);
-    const system = await validateFleetSystemRead(systemAccount, fleet, game, 'undock', 'Star System', docked.systemSeqId);
-    validateStarbasePlayerRead(playerAccount, fleet, options.authorization.profile, characterAddress, docked.system.address, starbasePlayerAddress);
-    const instruction = adaptDockedToIdleInstruction({
+    validateFleetRead(ctx.programs, fleetAccount, fleet, game, docked.system.address, docked.systemSeqId);
+    const system = await validateFleetSystemRead(ctx.programs, systemAccount, fleet, game, 'undock', 'Star System', docked.systemSeqId);
+    validateStarbasePlayerRead(ctx.programs, playerAccount, fleet, options.authorization.profile, characterAddress, docked.system.address, starbasePlayerAddress);
+    const instruction = adaptDockedToIdleInstruction(ctx.programs, {
         authorization: options.authorization,
         fleet: fleet.address,
         game,
@@ -859,11 +860,11 @@ export async function planFleetUndock(ctx, fleet, options) {
         systemAndStarbasePlayerSystem: docked.system.address,
     });
     const description = `Undock fleet ${fleet.name} from the Starbase in Star System ${system.name}.`;
-    return buildPlannerPlan({
+    return buildPlannerPlan(ctx.programs, {
         kind: 'fleet.undock',
         preconditions: await Promise.all([
             accountStatePrecondition(fleetAccount, `Fleet ${fleet.name} remains docked at Star System ${system.name}.`),
-            characterAccessPrecondition(characterAccount, { game, profile: options.authorization.profile }, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game with its research modifiers; its ATLAS, XP and asset counts may change.`),
+            characterAccessPrecondition(ctx.programs, characterAccount, { game, profile: options.authorization.profile }, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game with its research modifiers; its ATLAS, XP and asset counts may change.`),
             accountStatePrecondition(systemAccount, `Star System ${system.name} remains the docked System for Fleet ${fleet.name}.`),
             accountStatePrecondition(playerAccount, `The Starbase Player remains registered for Fleet ${fleet.name} at Star System ${system.name}.`),
         ]),
@@ -908,29 +909,29 @@ export async function planFleetDock(ctx, fleet, options) {
     const game = requireGameAddress(ctx);
     const [fleetCandidate] = await readContextRawAccounts(ctx, [fleet.address]);
     const fleetAccount = requireRawAccount(fleetCandidate, `Fleet ${fleet.name} is no longer available at ${fleet.address}. Refresh the Fleet and retry planning the dock action.`, fleet.address);
-    const validatedFleet = await validateIdleFleetRead(fleetAccount, fleet, game, actionLocation, 'dock');
-    const characterAddress = await findCharacterPda(options.authorization.profile, game);
+    const validatedFleet = await validateIdleFleetRead(ctx.programs, fleetAccount, fleet, game, actionLocation, 'dock');
+    const characterAddress = await findCharacterPda(ctx.programs, options.authorization.profile, game);
     const [characterCandidate] = await readContextRawAccounts(ctx, [
         characterAddress,
     ]);
-    const characterAccount = requireFleetCharacter(characterCandidate, fleet, options.authorization.profile, game, characterAddress, 'dock');
+    const characterAccount = requireFleetCharacter(ctx.programs, characterCandidate, fleet, options.authorization.profile, game, characterAddress, 'dock');
     const candidates = await discoverSystemsAt(ctx, game, actionLocation);
     if (candidates.length === 0)
         failNoDockableStarbase(fleet, actionLocation);
-    const systemAccount = selectSystemAt(fleet, actionLocation, validatedFleet.location, candidates, await readContextRawAccounts(ctx, candidates));
+    const systemAccount = selectSystemAt(ctx.programs, fleet, actionLocation, validatedFleet.location, candidates, await readContextRawAccounts(ctx, candidates));
     const systemAddress = systemAccount.address;
-    const system = await validateFleetSystemRead(systemAccount, fleet, game, 'dock');
+    const system = await validateFleetSystemRead(ctx.programs, systemAccount, fleet, game, 'dock');
     if (system.starbase === undefined)
         failNoDockableStarbase(fleet, actionLocation);
-    const starbasePlayerAddress = await deriveStarbasePlayerAddress(systemAddress, characterAddress);
+    const starbasePlayerAddress = await deriveStarbasePlayerAddress(ctx.programs, systemAddress, characterAddress);
     const [playerCandidate] = await readContextRawAccounts(ctx, [
         starbasePlayerAddress,
     ]);
     const playerAccount = requireRawAccount(playerCandidate, `Fleet ${fleet.name} cannot dock because Character ${characterAddress} is not registered at Starbase ${system.name} in Star System ${systemAddress}. Register the Character at this Starbase before docking, refresh the Fleet, and retry.`, starbasePlayerAddress);
-    const playerData = validateStarbasePlayerRead(playerAccount, fleet, options.authorization.profile, characterAddress, systemAddress, starbasePlayerAddress, 'dock');
+    const playerData = validateStarbasePlayerRead(ctx.programs, playerAccount, fleet, options.authorization.profile, characterAddress, systemAddress, starbasePlayerAddress, 'dock');
     const [tracker, ownership] = await Promise.all([
-        deriveFactionRelationTrackerAddress(game),
-        deriveFactionOwnershipAddress(game, 'starbase', systemAddress),
+        deriveFactionRelationTrackerAddress(ctx.programs, game),
+        deriveFactionOwnershipAddress(ctx.programs, game, 'starbase', systemAddress),
     ]);
     const policy = {
         kind: 'fleet-docking-policy',
@@ -945,13 +946,13 @@ export async function planFleetDock(ctx, fleet, options) {
         tracker,
         ownership,
     ]);
-    await validateFleetDockingPolicy({
+    await validateFleetDockingPolicy(ctx.programs, {
         tracker: trackerAccount,
         ownership: ownershipAccount,
         system: systemAccount,
         starbasePlayer: playerAccount,
     }, policy);
-    const instruction = adaptIdleToDockedInstruction({
+    const instruction = adaptIdleToDockedInstruction(ctx.programs, {
         factionRelationTracker: tracker,
         factionOwnership: ownership,
         authorization: options.authorization,
@@ -985,7 +986,7 @@ export async function planFleetDock(ctx, fleet, options) {
             : `Docking storage debit bounds are unavailable (${amounts.reason}); this does not imply zero Profile debit. Inspect simulation and fund the Profile explicitly if needed; transaction fees are separate.`,
     };
     const description = `Dock fleet ${fleet.name} at the Starbase in Star System ${system.name}.`;
-    return buildPlannerPlan({
+    return buildPlannerPlan(ctx.programs, {
         kind: 'fleet.dock',
         preconditions: [
             policy,
@@ -993,7 +994,7 @@ export async function planFleetDock(ctx, fleet, options) {
                 accountStatePrecondition(fleetAccount, fleet.state.kind === 'idle'
                     ? `Fleet ${fleet.name} remains idle at Starbase System ${system.name} coordinate (${String(actionLocation.x)}, ${String(actionLocation.y)}).`
                     : `Fleet ${fleet.name} remains ${fleet.state.kind} at Starbase System ${system.name} action coordinate (${String(actionLocation.x)}, ${String(actionLocation.y)}).`),
-                characterAccessPrecondition(characterAccount, { game, profile: options.authorization.profile }, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game with its research modifiers; its ATLAS, XP and asset counts may change.`),
+                characterAccessPrecondition(ctx.programs, characterAccount, { game, profile: options.authorization.profile }, `The canonical Character remains assigned to Profile ${options.authorization.profile} in the configured Game with its research modifiers; its ATLAS, XP and asset counts may change.`),
                 accountStatePrecondition(systemAccount, `Star System ${system.name} remains the Starbase System at Fleet ${fleet.name} coordinate (${String(actionLocation.x)}, ${String(actionLocation.y)}).`),
                 accountStatePrecondition(playerAccount, `The Starbase Player remains registered for Fleet ${fleet.name} at Starbase ${system.name}.`),
             ])),