@llmist/cli 15.17.0 → 15.18.1

package/dist/cli.js

@@ -23,6 +23,7 @@ var OPTION_FLAGS = {
   temperature: "-t, --temperature <value>",
   maxTokens: "--max-tokens <count>",
   maxIterations: "-i, --max-iterations <count>",
+  budget: "-b, --budget <amount>",
   gadgetModule: "-g, --gadget <module>",
   logLevel: "--log-level <level>",
   logLlmRequests: "--log-llm-requests",
@@ -65,6 +66,7 @@ var OPTION_DESCRIPTIONS = {
   temperature: "Sampling temperature between 0 and 2.",
   maxTokens: "Maximum number of output tokens requested from the model.",
   maxIterations: "Maximum number of agent loop iterations before exiting.",
+  budget: "Maximum spend in USD before the agent loop exits.",
   gadgetModule: "Path or module specifier for a gadget export. Repeat to register multiple gadgets.",
   logLevel: "Log level: silly, trace, debug, info, warn, error, fatal.",
   logLlmRequests: "Save LLM requests/responses to the session log directory.",
@@ -108,7 +110,7 @@ import { Command, InvalidArgumentError as InvalidArgumentError2 } from "commande
 // package.json
 var package_default = {
   name: "@llmist/cli",
-  version: "15.17.0",
+  version: "15.18.1",
   description: "CLI for llmist - run LLM agents from the command line",
   type: "module",
   main: "dist/cli.js",
@@ -164,7 +166,7 @@ var package_default = {
     node: ">=22.0.0"
   },
   dependencies: {
-    llmist: "^15.17.0",
+    llmist: "^15.18.1",
     "@unblessed/node": "^1.0.0-alpha.23",
     chalk: "^5.6.2",
     commander: "^12.1.0",
@@ -178,7 +180,7 @@ var package_default = {
     zod: "^4.1.12"
   },
   devDependencies: {
-    "@llmist/testing": "^15.17.0",
+    "@llmist/testing": "^15.18.1",
     "@types/diff": "^8.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/marked-terminal": "^6.1.1",
@@ -439,6 +441,7 @@ var AGENT_CONFIG_KEYS = /* @__PURE__ */ new Set([
   "system",
   "temperature",
   "max-iterations",
+  "budget",
   "gadgets",
   // Full replacement (preferred)
   "gadget-add",
@@ -561,6 +564,11 @@ function validateSingleSubagentConfig(value, subagentName, section) {
         );
       }
       result.maxIterations = val;
+    } else if (key === "budget") {
+      if (typeof val !== "number" || val < 0) {
+        throw new ConfigError(`[${section}].${subagentName}.budget must be a non-negative number`);
+      }
+      result.budget = val;
     } else if (key === "timeoutMs") {
       if (typeof val !== "number" || !Number.isInteger(val) || val < 0) {
         throw new ConfigError(
@@ -920,6 +928,9 @@ function validateAgentConfig(raw, section) {
       min: 1
     });
   }
+  if ("budget" in rawObj) {
+    result.budget = validateNumber(rawObj.budget, "budget", section, { min: 0 });
+  }
   if ("gadgets" in rawObj) {
     result.gadgets = validateStringArray(rawObj.gadgets, "gadgets", section);
   }
@@ -1100,6 +1111,9 @@ function validateCustomConfig(raw, section) {
       min: 1
     });
   }
+  if ("budget" in rawObj) {
+    result.budget = validateNumber(rawObj.budget, "budget", section, { min: 0 });
+  }
   if ("gadgets" in rawObj) {
     result.gadgets = validateStringArray(rawObj.gadgets, "gadgets", section);
   }
@@ -4045,6 +4059,11 @@ function addAgentOptions(cmd, defaults) {
     OPTION_DESCRIPTIONS.maxIterations,
     createNumericParser({ label: "Max iterations", integer: true, min: 1 }),
     defaults?.["max-iterations"]
+  ).option(
+    OPTION_FLAGS.budget,
+    OPTION_DESCRIPTIONS.budget,
+    createNumericParser({ label: "Budget", min: 0 }),
+    defaults?.budget
   ).option(OPTION_FLAGS.gadgetModule, OPTION_DESCRIPTIONS.gadgetModule, gadgetAccumulator, [
     ...defaultGadgets
   ]).option(OPTION_FLAGS.noBuiltins, OPTION_DESCRIPTIONS.noBuiltins, defaults?.builtins !== false).option(
@@ -4130,6 +4149,7 @@ function configToAgentOptions(config) {
   if (config.system !== void 0) result.system = config.system;
   if (config.temperature !== void 0) result.temperature = config.temperature;
   if (config["max-iterations"] !== void 0) result.maxIterations = config["max-iterations"];
+  if (config.budget !== void 0) result.budget = config.budget;
   const gadgets = config.gadgets ?? config.gadget;
   if (gadgets !== void 0) result.gadget = gadgets;
   if (config.builtins !== void 0) result.builtins = config.builtins;
@@ -8900,6 +8920,9 @@ ${ctx.gadgetName} requires interactive approval. Run in a terminal to approve.`
   if (options.maxIterations !== void 0) {
     builder.withMaxIterations(options.maxIterations);
   }
+  if (options.budget !== void 0) {
+    builder.withBudget(options.budget);
+  }
   if (options.temperature !== void 0) {
     builder.withTemperature(options.temperature);
   }
@@ -8973,7 +8996,7 @@ ${ctx.gadgetName} requires interactive approval. Run in a terminal to approve.`
   });
   builder.withTrailingMessage(
     (ctx) => [
-      `[Iteration ${ctx.iteration + 1}/${ctx.maxIterations}]`,
+      `[Iteration ${ctx.iteration + 1}/${ctx.maxIterations}${ctx.budget ? ` | Budget: $${ctx.totalCost.toFixed(4)}/$${ctx.budget}` : ""}]`,
       "Think carefully in two steps: 1. what gadget invocations we should be making next? 2. how do they depend on one another so we can run all of them in the right order? Then respond with all the gadget invocations you are able to do now."
     ].join(" ")
   );
@@ -9328,6 +9351,10 @@ Profile: ${name}
 `);
   env.stdout.write(`  Max Iterations:  ${section["max-iterations"] ?? "(default)"}
 `);
+  env.stdout.write(
+    `  Budget:          ${section.budget !== void 0 ? `$${section.budget}` : "(none)"}
+`
+  );
   env.stdout.write(
     `  Temperature:     ${section.temperature !== void 0 ? section.temperature : "(default)"}
 `
@@ -9357,6 +9384,8 @@ Profile: ${name}
 `);
       if (subConfig.maxIterations)
         env.stdout.write(`    maxIterations: ${subConfig.maxIterations}
+`);
+      if (subConfig.budget) env.stdout.write(`    budget: $${subConfig.budget}
 `);
       if (subConfig.timeoutMs) env.stdout.write(`    timeoutMs: ${subConfig.timeoutMs}
 `);
@@ -10050,6 +10079,7 @@ var STARTER_CONFIG = `# ~/.llmist/cli.toml
 [agent]
 # model = "anthropic:claude-sonnet-4-5"
 # max-iterations = 15             # Max tool-use loops before stopping
+# budget = 0.50                  # Max USD spend per agent run
 # gadgets = [                     # Tools the agent can use
 #   "ListDirectory",
 #   "ReadFile",