@forgezero/agent 0.1.114 → 0.1.116

package/dist/platform-fleet-verification.js

@@ -1415,6 +1415,7 @@ function validateCapacityCalibrationOptions(options) {
   const endpoint = localCalibrationEndpoint(options.endpoint);
   const maxConcurrency = options.maxConcurrency ?? 256;
   const requestsPerWorker = options.requestsPerWorker ?? 8;
+  const maximumRequestsPerWorker = options.maximumRequestsPerWorker ?? 100;
   const maxP95Ms = options.maxP95Ms ?? 250;
   const maxErrorRate = options.maxErrorRate ?? 0.01;
   const safetyRatio = options.safetyRatio ?? 0.8;
@@ -1422,13 +1423,14 @@ function validateCapacityCalibrationOptions(options) {
   const minimumStageDurationMs = options.minimumStageDurationMs ?? 5000;
   const maxCpuUtilizationPercent = options.maxCpuUtilizationPercent ?? 90;
   const maxMemoryUtilizationPercent = options.maxMemoryUtilizationPercent ?? 90;
-  if (!Number.isSafeInteger(maxConcurrency) || maxConcurrency < 1 || maxConcurrency > 4096 || !Number.isSafeInteger(requestsPerWorker) || requestsPerWorker < 2 || requestsPerWorker > 100 || !Number.isFinite(maxP95Ms) || maxP95Ms < 1 || !Number.isFinite(maxErrorRate) || maxErrorRate < 0 || maxErrorRate > 0.2 || !Number.isFinite(safetyRatio) || safetyRatio < 0.25 || safetyRatio > 0.95 || !Number.isSafeInteger(requestTimeoutMs) || requestTimeoutMs < 100 || requestTimeoutMs > 30000 || !Number.isSafeInteger(minimumStageDurationMs) || minimumStageDurationMs < 100 || minimumStageDurationMs > 60000 || !Number.isFinite(maxCpuUtilizationPercent) || maxCpuUtilizationPercent < 25 || maxCpuUtilizationPercent > 100 || !Number.isFinite(maxMemoryUtilizationPercent) || maxMemoryUtilizationPercent < 25 || maxMemoryUtilizationPercent > 100) {
+  if (!Number.isSafeInteger(maxConcurrency) || maxConcurrency < 1 || maxConcurrency > 4096 || !Number.isSafeInteger(requestsPerWorker) || requestsPerWorker < 2 || requestsPerWorker > 100 || !Number.isSafeInteger(maximumRequestsPerWorker) || maximumRequestsPerWorker < requestsPerWorker || maximumRequestsPerWorker > 100 || !Number.isFinite(maxP95Ms) || maxP95Ms < 1 || !Number.isFinite(maxErrorRate) || maxErrorRate < 0 || maxErrorRate > 0.2 || !Number.isFinite(safetyRatio) || safetyRatio < 0.25 || safetyRatio > 0.95 || !Number.isSafeInteger(requestTimeoutMs) || requestTimeoutMs < 100 || requestTimeoutMs > 30000 || !Number.isSafeInteger(minimumStageDurationMs) || minimumStageDurationMs < 100 || minimumStageDurationMs > 60000 || !Number.isFinite(maxCpuUtilizationPercent) || maxCpuUtilizationPercent < 25 || maxCpuUtilizationPercent > 100 || !Number.isFinite(maxMemoryUtilizationPercent) || maxMemoryUtilizationPercent < 25 || maxMemoryUtilizationPercent > 100) {
     throw new Error("Capacity calibration bounds are invalid.");
   }
   return {
     endpoint,
     maxConcurrency,
     requestsPerWorker,
+    maximumRequestsPerWorker,
     maxP95Ms,
     maxErrorRate,
     safetyRatio,
@@ -1438,7 +1440,7 @@ function validateCapacityCalibrationOptions(options) {
     maxMemoryUtilizationPercent
   };
 }
-async function stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimumDurationMs, fetcher, sampler) {
+async function stage(endpoint, concurrency, requestsPerWorker, maximumRequestsPerWorker, timeoutMs, minimumDurationMs, fetcher, sampler) {
   const latencies = [];
   let succeeded = 0;
   let failed = 0;
@@ -1447,7 +1449,7 @@ async function stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimu
   const started = performance.now();
   await Promise.all(Array.from({ length: concurrency }, async () => {
     let request = 0;
-    while (request < requestsPerWorker || performance.now() - started < minimumDurationMs) {
+    while (request < maximumRequestsPerWorker && (request < requestsPerWorker || performance.now() - started < minimumDurationMs)) {
       request += 1;
       const requestStarted = performance.now();
       try {
@@ -1506,6 +1508,7 @@ async function calibrateHttpConcurrency(options, fetcher = fetch, sampler = host
     safetyRatio,
     requestTimeoutMs: timeoutMs,
     minimumStageDurationMs,
+    maximumRequestsPerWorker,
     maxCpuUtilizationPercent,
     maxMemoryUtilizationPercent
   } = validateCapacityCalibrationOptions(options);
@@ -1513,7 +1516,7 @@ async function calibrateHttpConcurrency(options, fetcher = fetch, sampler = host
   let lastSafe;
   let stopReason = "maximum-tested";
   for (let concurrency = 1;; concurrency = Math.min(maxConcurrency, concurrency * 2)) {
-    const measured = await stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimumStageDurationMs, fetcher, sampler);
+    const measured = await stage(endpoint, concurrency, requestsPerWorker, maximumRequestsPerWorker, timeoutMs, minimumStageDurationMs, fetcher, sampler);
     stages.push(measured);
     const previous = stages.at(-2);
     const throughputRegressed = Boolean(previous && concurrency > 1 && measured.successfulRequestsPerSecond < previous.successfulRequestsPerSecond * 0.9);
@@ -1614,6 +1617,7 @@ function capacityCalibration(value, where) {
     "endpoint",
     "maxConcurrency",
     "requestsPerWorker",
+    "maximumRequestsPerWorker",
     "maxP95Ms",
     "maxErrorRate",
     "safetyRatio",
@@ -1642,6 +1646,7 @@ function capacityCalibration(value, where) {
     ...Object.fromEntries([
       "maxConcurrency",
       "requestsPerWorker",
+      "maximumRequestsPerWorker",
       "maxP95Ms",
       "maxErrorRate",
       "safetyRatio",
@@ -3004,7 +3009,7 @@ function requestSoftware(requirements, socketPath = DEFAULT_SOFTWARE_HELPER_SOCK
 }
 
 // src/version.ts
-var VERSION3 = "0.1.114";
+var VERSION3 = "0.1.116";
 
 // src/egress-policy.ts
 import { realpathSync as realpathSync3 } from "node:fs";
@@ -4180,6 +4185,9 @@ function platformGenesisClaims(guests, sshPublicKeys) {
     throw new Error("platform genesis requires at least one operator SSH public key");
   return reviewed.map((guest) => claimFor(guest, keys, "create"));
 }
+function platformGenesisDeletionClaims(guests) {
+  return validatePlatformGenesisGuests(guests).map((guest) => claimFor(guest, [], "delete"));
+}
 function platformCommunityRehearsalClaims(seedGuests, rehearsalGuest, sshPublicKeys) {
   const reviewed = validatePlatformGenesisGuests([...seedGuests, rehearsalGuest], 4);
   const keys = [...new Set(sshPublicKeys.map(publicKey))];

package/dist/platform-genesis.d.ts

@@ -21,6 +21,8 @@ export interface PlatformGenesisGuest {
 export declare function validatePlatformGenesisGuests(guests: readonly PlatformGenesisGuest[], expectedCount?: number): readonly PlatformGenesisGuest[];
 /** Convert reviewed desired state into the ordinary Metal provisioning claim. */
 export declare function platformGenesisClaims(guests: readonly PlatformGenesisGuest[], sshPublicKeys: readonly string[]): readonly RemoteProvisionClaim[];
+/** Exact inverse of the reviewed three-node platform seed. */
+export declare function platformGenesisDeletionClaims(guests: readonly PlatformGenesisGuest[]): readonly RemoteProvisionClaim[];
 /** Add one explicitly reviewed disposable node to the same three guest requests. */
 export declare function platformCommunityRehearsalClaims(seedGuests: readonly PlatformGenesisGuest[], rehearsalGuest: PlatformGenesisGuest, sshPublicKeys: readonly string[]): readonly RemoteProvisionClaim[];
 /** Exact inverse of the reviewed disposable four-host request. */

package/dist/platform-genesis.js

@@ -669,6 +669,9 @@ function platformGenesisClaims(guests, sshPublicKeys) {
     throw new Error("platform genesis requires at least one operator SSH public key");
   return reviewed.map((guest) => claimFor(guest, keys, "create"));
 }
+function platformGenesisDeletionClaims(guests) {
+  return validatePlatformGenesisGuests(guests).map((guest) => claimFor(guest, [], "delete"));
+}
 function platformCommunityRehearsalClaims(seedGuests, rehearsalGuest, sshPublicKeys) {
   const reviewed = validatePlatformGenesisGuests([...seedGuests, rehearsalGuest], 4);
   const keys = [...new Set(sshPublicKeys.map(publicKey))];
@@ -681,6 +684,7 @@ function platformCommunityRehearsalDeletionClaims(seedGuests, rehearsalGuest) {
 }
 export {
   validatePlatformGenesisGuests,
+  platformGenesisDeletionClaims,
   platformGenesisClaims,
   platformCommunityRehearsalDeletionClaims,
   platformCommunityRehearsalClaims

package/dist/provision.js

@@ -1415,6 +1415,7 @@ function validateCapacityCalibrationOptions(options) {
   const endpoint = localCalibrationEndpoint(options.endpoint);
   const maxConcurrency = options.maxConcurrency ?? 256;
   const requestsPerWorker = options.requestsPerWorker ?? 8;
+  const maximumRequestsPerWorker = options.maximumRequestsPerWorker ?? 100;
   const maxP95Ms = options.maxP95Ms ?? 250;
   const maxErrorRate = options.maxErrorRate ?? 0.01;
   const safetyRatio = options.safetyRatio ?? 0.8;
@@ -1422,13 +1423,14 @@ function validateCapacityCalibrationOptions(options) {
   const minimumStageDurationMs = options.minimumStageDurationMs ?? 5000;
   const maxCpuUtilizationPercent = options.maxCpuUtilizationPercent ?? 90;
   const maxMemoryUtilizationPercent = options.maxMemoryUtilizationPercent ?? 90;
-  if (!Number.isSafeInteger(maxConcurrency) || maxConcurrency < 1 || maxConcurrency > 4096 || !Number.isSafeInteger(requestsPerWorker) || requestsPerWorker < 2 || requestsPerWorker > 100 || !Number.isFinite(maxP95Ms) || maxP95Ms < 1 || !Number.isFinite(maxErrorRate) || maxErrorRate < 0 || maxErrorRate > 0.2 || !Number.isFinite(safetyRatio) || safetyRatio < 0.25 || safetyRatio > 0.95 || !Number.isSafeInteger(requestTimeoutMs) || requestTimeoutMs < 100 || requestTimeoutMs > 30000 || !Number.isSafeInteger(minimumStageDurationMs) || minimumStageDurationMs < 100 || minimumStageDurationMs > 60000 || !Number.isFinite(maxCpuUtilizationPercent) || maxCpuUtilizationPercent < 25 || maxCpuUtilizationPercent > 100 || !Number.isFinite(maxMemoryUtilizationPercent) || maxMemoryUtilizationPercent < 25 || maxMemoryUtilizationPercent > 100) {
+  if (!Number.isSafeInteger(maxConcurrency) || maxConcurrency < 1 || maxConcurrency > 4096 || !Number.isSafeInteger(requestsPerWorker) || requestsPerWorker < 2 || requestsPerWorker > 100 || !Number.isSafeInteger(maximumRequestsPerWorker) || maximumRequestsPerWorker < requestsPerWorker || maximumRequestsPerWorker > 100 || !Number.isFinite(maxP95Ms) || maxP95Ms < 1 || !Number.isFinite(maxErrorRate) || maxErrorRate < 0 || maxErrorRate > 0.2 || !Number.isFinite(safetyRatio) || safetyRatio < 0.25 || safetyRatio > 0.95 || !Number.isSafeInteger(requestTimeoutMs) || requestTimeoutMs < 100 || requestTimeoutMs > 30000 || !Number.isSafeInteger(minimumStageDurationMs) || minimumStageDurationMs < 100 || minimumStageDurationMs > 60000 || !Number.isFinite(maxCpuUtilizationPercent) || maxCpuUtilizationPercent < 25 || maxCpuUtilizationPercent > 100 || !Number.isFinite(maxMemoryUtilizationPercent) || maxMemoryUtilizationPercent < 25 || maxMemoryUtilizationPercent > 100) {
     throw new Error("Capacity calibration bounds are invalid.");
   }
   return {
     endpoint,
     maxConcurrency,
     requestsPerWorker,
+    maximumRequestsPerWorker,
     maxP95Ms,
     maxErrorRate,
     safetyRatio,
@@ -1438,7 +1440,7 @@ function validateCapacityCalibrationOptions(options) {
     maxMemoryUtilizationPercent
   };
 }
-async function stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimumDurationMs, fetcher, sampler) {
+async function stage(endpoint, concurrency, requestsPerWorker, maximumRequestsPerWorker, timeoutMs, minimumDurationMs, fetcher, sampler) {
   const latencies = [];
   let succeeded = 0;
   let failed = 0;
@@ -1447,7 +1449,7 @@ async function stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimu
   const started = performance.now();
   await Promise.all(Array.from({ length: concurrency }, async () => {
     let request = 0;
-    while (request < requestsPerWorker || performance.now() - started < minimumDurationMs) {
+    while (request < maximumRequestsPerWorker && (request < requestsPerWorker || performance.now() - started < minimumDurationMs)) {
       request += 1;
       const requestStarted = performance.now();
       try {
@@ -1506,6 +1508,7 @@ async function calibrateHttpConcurrency(options, fetcher = fetch, sampler = host
     safetyRatio,
     requestTimeoutMs: timeoutMs,
     minimumStageDurationMs,
+    maximumRequestsPerWorker,
     maxCpuUtilizationPercent,
     maxMemoryUtilizationPercent
   } = validateCapacityCalibrationOptions(options);
@@ -1513,7 +1516,7 @@ async function calibrateHttpConcurrency(options, fetcher = fetch, sampler = host
   let lastSafe;
   let stopReason = "maximum-tested";
   for (let concurrency = 1;; concurrency = Math.min(maxConcurrency, concurrency * 2)) {
-    const measured = await stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimumStageDurationMs, fetcher, sampler);
+    const measured = await stage(endpoint, concurrency, requestsPerWorker, maximumRequestsPerWorker, timeoutMs, minimumStageDurationMs, fetcher, sampler);
     stages.push(measured);
     const previous = stages.at(-2);
     const throughputRegressed = Boolean(previous && concurrency > 1 && measured.successfulRequestsPerSecond < previous.successfulRequestsPerSecond * 0.9);
@@ -1614,6 +1617,7 @@ function capacityCalibration(value, where) {
     "endpoint",
     "maxConcurrency",
     "requestsPerWorker",
+    "maximumRequestsPerWorker",
     "maxP95Ms",
     "maxErrorRate",
     "safetyRatio",
@@ -1642,6 +1646,7 @@ function capacityCalibration(value, where) {
     ...Object.fromEntries([
       "maxConcurrency",
       "requestsPerWorker",
+      "maximumRequestsPerWorker",
       "maxP95Ms",
       "maxErrorRate",
       "safetyRatio",
@@ -3004,7 +3009,7 @@ function requestSoftware(requirements, socketPath = DEFAULT_SOFTWARE_HELPER_SOCK
 }
 
 // src/version.ts
-var VERSION3 = "0.1.114";
+var VERSION3 = "0.1.116";
 
 // src/egress-policy.ts
 import { realpathSync as realpathSync3 } from "node:fs";

package/dist/software-helper.js

@@ -572,6 +572,7 @@ function validateCapacityCalibrationOptions(options) {
   const endpoint = localCalibrationEndpoint(options.endpoint);
   const maxConcurrency = options.maxConcurrency ?? 256;
   const requestsPerWorker = options.requestsPerWorker ?? 8;
+  const maximumRequestsPerWorker = options.maximumRequestsPerWorker ?? 100;
   const maxP95Ms = options.maxP95Ms ?? 250;
   const maxErrorRate = options.maxErrorRate ?? 0.01;
   const safetyRatio = options.safetyRatio ?? 0.8;
@@ -579,13 +580,14 @@ function validateCapacityCalibrationOptions(options) {
   const minimumStageDurationMs = options.minimumStageDurationMs ?? 5000;
   const maxCpuUtilizationPercent = options.maxCpuUtilizationPercent ?? 90;
   const maxMemoryUtilizationPercent = options.maxMemoryUtilizationPercent ?? 90;
-  if (!Number.isSafeInteger(maxConcurrency) || maxConcurrency < 1 || maxConcurrency > 4096 || !Number.isSafeInteger(requestsPerWorker) || requestsPerWorker < 2 || requestsPerWorker > 100 || !Number.isFinite(maxP95Ms) || maxP95Ms < 1 || !Number.isFinite(maxErrorRate) || maxErrorRate < 0 || maxErrorRate > 0.2 || !Number.isFinite(safetyRatio) || safetyRatio < 0.25 || safetyRatio > 0.95 || !Number.isSafeInteger(requestTimeoutMs) || requestTimeoutMs < 100 || requestTimeoutMs > 30000 || !Number.isSafeInteger(minimumStageDurationMs) || minimumStageDurationMs < 100 || minimumStageDurationMs > 60000 || !Number.isFinite(maxCpuUtilizationPercent) || maxCpuUtilizationPercent < 25 || maxCpuUtilizationPercent > 100 || !Number.isFinite(maxMemoryUtilizationPercent) || maxMemoryUtilizationPercent < 25 || maxMemoryUtilizationPercent > 100) {
+  if (!Number.isSafeInteger(maxConcurrency) || maxConcurrency < 1 || maxConcurrency > 4096 || !Number.isSafeInteger(requestsPerWorker) || requestsPerWorker < 2 || requestsPerWorker > 100 || !Number.isSafeInteger(maximumRequestsPerWorker) || maximumRequestsPerWorker < requestsPerWorker || maximumRequestsPerWorker > 100 || !Number.isFinite(maxP95Ms) || maxP95Ms < 1 || !Number.isFinite(maxErrorRate) || maxErrorRate < 0 || maxErrorRate > 0.2 || !Number.isFinite(safetyRatio) || safetyRatio < 0.25 || safetyRatio > 0.95 || !Number.isSafeInteger(requestTimeoutMs) || requestTimeoutMs < 100 || requestTimeoutMs > 30000 || !Number.isSafeInteger(minimumStageDurationMs) || minimumStageDurationMs < 100 || minimumStageDurationMs > 60000 || !Number.isFinite(maxCpuUtilizationPercent) || maxCpuUtilizationPercent < 25 || maxCpuUtilizationPercent > 100 || !Number.isFinite(maxMemoryUtilizationPercent) || maxMemoryUtilizationPercent < 25 || maxMemoryUtilizationPercent > 100) {
     throw new Error("Capacity calibration bounds are invalid.");
   }
   return {
     endpoint,
     maxConcurrency,
     requestsPerWorker,
+    maximumRequestsPerWorker,
     maxP95Ms,
     maxErrorRate,
     safetyRatio,
@@ -595,7 +597,7 @@ function validateCapacityCalibrationOptions(options) {
     maxMemoryUtilizationPercent
   };
 }
-async function stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimumDurationMs, fetcher, sampler) {
+async function stage(endpoint, concurrency, requestsPerWorker, maximumRequestsPerWorker, timeoutMs, minimumDurationMs, fetcher, sampler) {
   const latencies = [];
   let succeeded = 0;
   let failed = 0;
@@ -604,7 +606,7 @@ async function stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimu
   const started = performance.now();
   await Promise.all(Array.from({ length: concurrency }, async () => {
     let request = 0;
-    while (request < requestsPerWorker || performance.now() - started < minimumDurationMs) {
+    while (request < maximumRequestsPerWorker && (request < requestsPerWorker || performance.now() - started < minimumDurationMs)) {
       request += 1;
       const requestStarted = performance.now();
       try {
@@ -663,6 +665,7 @@ async function calibrateHttpConcurrency(options, fetcher = fetch, sampler = host
     safetyRatio,
     requestTimeoutMs: timeoutMs,
     minimumStageDurationMs,
+    maximumRequestsPerWorker,
     maxCpuUtilizationPercent,
     maxMemoryUtilizationPercent
   } = validateCapacityCalibrationOptions(options);
@@ -670,7 +673,7 @@ async function calibrateHttpConcurrency(options, fetcher = fetch, sampler = host
   let lastSafe;
   let stopReason = "maximum-tested";
   for (let concurrency = 1;; concurrency = Math.min(maxConcurrency, concurrency * 2)) {
-    const measured = await stage(endpoint, concurrency, requestsPerWorker, timeoutMs, minimumStageDurationMs, fetcher, sampler);
+    const measured = await stage(endpoint, concurrency, requestsPerWorker, maximumRequestsPerWorker, timeoutMs, minimumStageDurationMs, fetcher, sampler);
     stages.push(measured);
     const previous = stages.at(-2);
     const throughputRegressed = Boolean(previous && concurrency > 1 && measured.successfulRequestsPerSecond < previous.successfulRequestsPerSecond * 0.9);
@@ -771,6 +774,7 @@ function capacityCalibration(value, where) {
     "endpoint",
     "maxConcurrency",
     "requestsPerWorker",
+    "maximumRequestsPerWorker",
     "maxP95Ms",
     "maxErrorRate",
     "safetyRatio",
@@ -799,6 +803,7 @@ function capacityCalibration(value, where) {
     ...Object.fromEntries([
       "maxConcurrency",
       "requestsPerWorker",
+      "maximumRequestsPerWorker",
       "maxP95Ms",
       "maxErrorRate",
       "safetyRatio",

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** One package version shared by both public binaries. Pinned to package.json by tests. */
-export declare const VERSION = "0.1.114";
+export declare const VERSION = "0.1.116";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgezero/agent",
-  "version": "0.1.114",
+  "version": "0.1.116",
   "type": "module",
   "scripts": {
     "check": "tsc --noEmit",