Skip to content

Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.

docs(pool): clarify executor-specific memory admission [C7]

Corey Olson7be170100a36
diff --git a/src/resources.js b/src/resources.js
index cf8fb938..6a249a2d 100644
--- a/src/resources.js
+++ b/src/resources.js
@@ -768,8 +768,8 @@ function pause(ms) { return new Promise((resolvePromise) => setTimeout(resolvePr
* Join the queue in its admission class (landing, review, submit, other), aging up over time; FIFO by ticket within a class.
*
* @param {{ name: string, capacity: number, capacityProvider?: () => number, shortCapacityProvider?: () => number, browserCapacityProvider?: () => number, scope?: 'machine'|'repo'|'board', root?: string, agent?: string, repo?: string, landing?: boolean, itemCheck?: boolean, shortEligible?: boolean, diagnostic?: boolean, browser?: boolean, remote?: boolean, timing?: boolean, runnerProvider?: () => Array<{host:string,slots:number,browser:number}>, item?: string, kind?: string, onWait?: (state: object) => any | Promise<any>, allowIdleCapacityUpdate?: boolean, memory?: () => Promise<{ checked: boolean, held: boolean, line: string, warning?: string }>, _resume?: object }} options - Resource identity, queue class, short-slot eligibility, optional remote executor pool and memory check. An awaited wait callback may return {leaseUntil} and then receives a final {admitted:true} callback before work starts.
- * memory, when given, is read before each admission: a held verdict blocks local executors
- * waiting in place, local, remote and short slots alike, and an unchecked one is passed to onWait once
+ * memory, when given, is read before each admission: a held verdict blocks ordinary and short local
+ * executors while compatible remote slots remain eligible; an unchecked one is passed to onWait once
* so the caller can warn.
* @returns {Promise<{ name: string, scope: string, token: string, pool: string, browser: boolean, slotClass: 'gate'|'short', runner?: {host:string,slots:number,browser:number}, waitMs: number, release: () => void, renew: () => void, requeueRunner?: (reason?: string, options?: { local?: boolean }) => Promise<object> }>}
*/