jules-orchestrator-kit 0.32.7 → 0.32.8

package/README.md

@@ -120,7 +120,7 @@ Autonomous coding agents can write software at 100× human speed—but unconstra
 
 * **🚀 Zero-Test Bootstrapping (`agentctl bootstrap`):** Synthesizes deterministic syntax-check and smoke-test verification oracles for untested legacy repositories so agents always operate against a falsifiable feedback loop.
 
-* **📈 Proven Scale & Reliability:** Empirically tested with **458 unit tests across 66 suites passing in < 10.0s**, supporting 300+ daily agent sessions per repository. An adversarial red-team suite (`test/adversarial-claims.test.mjs`) continuously attempts to falsify the safety guarantees documented above — including cross-platform probes for the case-insensitive filesystems on macOS and Windows — and a documentation-sync gate (`scripts/doc-sync-check.mjs`) blocks any release whose docs have drifted from the code.
+* **📈 Proven Scale & Reliability:** Empirically tested with **461 unit tests across 66 suites passing in < 10.0s**, supporting 300+ daily agent sessions per repository. An adversarial red-team suite (`test/adversarial-claims.test.mjs`) continuously attempts to falsify the safety guarantees documented above — including cross-platform probes for the case-insensitive filesystems on macOS and Windows — and a documentation-sync gate (`scripts/doc-sync-check.mjs`) blocks any release whose docs have drifted from the code.
 
 <br/>
 

package/bin/agentctl.mjs

@@ -12,11 +12,11 @@ import { reapOrphanedIntents, reapStaleMutexDirs } from "../src/journal.mjs";
 const args = process.argv.slice(2);
 const command = args[0];
 
-export const VERSION = "0.32.7";
+export const VERSION = "0.32.8";
 
 export function printHelp() {
   console.log(`
-🚀 agentctl v0.32.7 — Universal Agent Orchestrator & Safety Gatekeeper
+🚀 agentctl v0.32.8 — Universal Agent Orchestrator & Safety Gatekeeper
 
 Usage: agentctl <command> [options]
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jules-orchestrator-kit",
-  "version": "0.32.7",
+  "version": "0.32.8",
   "description": "Orchestration kit for running Google Jules autonomous agents.",
   "repository": {
     "type": "git",

package/scripts/utils.mjs

@@ -135,9 +135,15 @@ export function checkDailyBudget(arg1 = resolveRoot(), arg2 = 300) {
   return res;
 }
 
-export function reserveDailyBudget(maxSessions = 300, taskKey = "") {
-  appendLedger({ event: "budget_reserved", key: taskKey });
-  const check = checkDailyBudget(maxSessions);
+/**
+ * @param {number} [maxSessions=300]
+ * @param {string} [taskKey=""]
+ * @param {string} [root] - Ledger root. Defaults to the git toplevel. Pass an
+ *   explicit root to keep callers (notably tests) off the operator's real ledger.
+ */
+export function reserveDailyBudget(maxSessions = 300, taskKey = "", root = resolveRoot()) {
+  appendLedger({ event: "budget_reserved", key: taskKey }, root);
+  const check = checkDailyBudget(root, maxSessions);
   return { ok: check.ok, used: check.used, budget: maxSessions };
 }
 

package/src/engine.mjs

@@ -695,7 +695,12 @@ export async function dispatch(task = {}, opts = {}) {
   }
   const root = opts.config?._root || opts.root || process.cwd();
   const config = opts.config || loadConfig(root);
-  const { provider, routed, classification } = resolveRoutedProvider(task, config);
+  // opts.provider mirrors gate()'s existing injection point, so a caller can
+  // exercise dispatch without reaching a live provider.
+  const resolved = resolveRoutedProvider(task, config);
+  const provider = opts.provider || resolved.provider;
+  const routed = opts.provider ? false : resolved.routed;
+  const classification = opts.provider ? null : resolved.classification;
   if (routed && classification) {
     appendTelemetry(root, "router_decision", {
       tier: classification.tier,
@@ -739,12 +744,16 @@ export async function dispatch(task = {}, opts = {}) {
 
   const cleanTask = { ...task, prompt: envelopedPrompt };
 
+  const runDispatch = () => provider.dispatch(cleanTask, { root, dryRun: opts.dryRun });
+
   try {
-    const session = await withBudget(
-      () => provider.dispatch(cleanTask, { root, dryRun: opts.dryRun }),
-      root,
-      config.limits.dailyTasks
-    );
+    // A dry run performs no provider call and produces no work, so it must not
+    // consume one of the operator's finite daily task slots. Reserving here also
+    // made every `npm test` burn real budget, which eventually exhausted the
+    // ledger and turned the suite red for reasons unrelated to any code change.
+    const session = opts.dryRun
+      ? await runDispatch()
+      : await withBudget(runDispatch, root, config.limits.dailyTasks);
     return classification ? { ...session, _routeTier: classification.tier, _routeReason: classification.reason } : session;
   } catch (err) {
     if (err instanceof ProviderRateLimitError || err instanceof ProviderUnavailableError) {