@cryer/star-cli 0.3.4 → 0.3.5

package/README.md

@@ -52,6 +52,11 @@ Config file: `~/.star-cli/config.toml` (project-level override: `.star/config.to
 defaultModel = "gpt"
 permissionMode = "ask"   # ask | auto | readonly | yolo | plan
 contextMaxTokens = 100000
+# Max model round-trips ("steps") per turn between progress checkpoints — one
+# step is a reply plus the tool calls it asked for; retries and auto-continue
+# nudges don't count. Reaching the cap while tools still execute resets it
+# with a notice instead of stopping the turn; 0 disables the cap entirely.
+maxSteps = 100
 # compactThresholdTokens = 80000   # optional auto-compaction trigger in tokens; defaults to the
                                   # context window. /compact always compacts, regardless of this.
 contextCompaction = "summary"   # summary | truncate — how over-budget history is compacted

package/README.zh-CN.md

@@ -52,6 +52,10 @@ star -p "hi"             # non-interactive print mode
 defaultModel = "gpt"
 permissionMode = "ask"   # ask | auto | readonly | yolo | plan
 contextMaxTokens = 100000
+# 每回合在进度检查点之间允许的最大模型往返（"step"）数——一个 step 是
+# 一次回复加上它请求的所有工具调用；重试和 auto-continue nudge 不占 step。
+# 到达上限时若工具仍在执行，会发提示并重置额度而不是终止回合；0 表示完全不限。
+maxSteps = 100
 # compactThresholdTokens = 80000   # optional auto-compaction trigger in tokens; defaults to the
                                   # context window. /compact always compacts, regardless of this.
 contextCompaction = "summary"   # summary | truncate — how over-budget history is compacted

package/dist/{chunk-K3R42LOX.js → chunk-OIDB2E5J.js}

@@ -68,7 +68,13 @@ var ConfigSchema = z.object({
   permissionMode: z.enum(["auto", "ask", "readonly", "yolo", "plan"]).default("ask"),
   providers: z.array(ProviderConfigSchema).default([]),
   models: z.array(ModelConfigSchema).default([]),
-  maxSteps: z.number().int().positive().default(50),
+  // Cap on model round-trips ("steps") per turn between progress checkpoints.
+  // One step is a streamed reply plus every tool call it asked for — stream
+  // retries and auto-continue nudges do not consume steps. Reaching the cap
+  // while tools still execute resets the budget with a notice; the turn stops
+  // only when no tool ran since the last checkpoint (the doom-loop
+  // signature). 0 disables the cap entirely (opencode/codex have none).
+  maxSteps: z.number().int().min(0).default(100),
   contextMaxTokens: z.number().int().positive().default(1e5),
   // Token threshold at which the agent loop auto-compacts the history.
   // Defaults to the effective context window (compact only when full); set a
@@ -2924,7 +2930,7 @@ var MAX_SUBAGENT_DEPTH = 1;
 var MAX_REPORT_CHARS = 2e4;
 var SUBAGENT_PROMPT = "You are a subagent spawned to handle a focused subtask on behalf of the main agent. Work autonomously with the tools available to you, then finish with a concise report of what you found or did. Your final text is returned to the main agent as the tool result \u2014 make it self-contained.";
 async function runSubagent(deps, args, cwd, signal) {
-  const { AgentLoop: AgentLoop2 } = await import("./loop-SDZVEQND.js");
+  const { AgentLoop: AgentLoop2 } = await import("./loop-H5RYTO2O.js");
   const child = new AgentLoop2({
     model: deps.model,
     registry: createDefaultRegistry(),
@@ -3475,7 +3481,27 @@ var AgentLoop = class {
     let lastWasNudge = false;
     let usedToolsThisTurn = false;
     let openTodos = [];
-    for (let step = 0; step < config.maxSteps; step++) {
+    const maxSteps = config.maxSteps;
+    let step = 0;
+    let toolExecutedSinceCheckpoint = false;
+    for (; ; ) {
+      if (maxSteps > 0 && step >= maxSteps) {
+        if (!toolExecutedSinceCheckpoint) {
+          yield {
+            type: "error",
+            error: new Error(
+              `Max steps (${maxSteps}) reached with no tool execution since the last checkpoint, stopping.`
+            )
+          };
+          return;
+        }
+        toolExecutedSinceCheckpoint = false;
+        step = 0;
+        yield {
+          type: "notice",
+          message: `maxSteps (${maxSteps}) reached and the turn is still making progress; continuing. Press Esc to interrupt.`
+        };
+      }
       if ((this.opts.subagentDepth ?? 0) === 0) {
         for (const finished of defaultAgentTasks.drainNotifications()) {
           const label = finished.description ? ` "${finished.description}"` : "";
@@ -3663,6 +3689,8 @@ ${finished.result}`
           const refusal = this.doomLoopRefusal(call);
           if (refusal !== null) {
             yield { type: "notice", message: refusal };
+          } else {
+            toolExecutedSinceCheckpoint = true;
           }
           const result = refusal !== null ? { content: refusal, isError: true } : await this.executeTool(call, signal);
           const toolMessage = {
@@ -3712,11 +3740,8 @@ ${finished.result}`
         }
       }
       if (signal.aborted) return;
+      step++;
     }
-    yield {
-      type: "error",
-      error: new Error(`Max steps (${config.maxSteps}) reached, stopping.`)
-    };
   }
   // The permission mode can change at runtime, so the system message is
   // recomputed at the start of every turn instead of being frozen by the
@@ -3952,4 +3977,4 @@ export {
   PLAN_MODE_PROMPT,
   AgentLoop
 };
-//# sourceMappingURL=chunk-K3R42LOX.js.map
+//# sourceMappingURL=chunk-OIDB2E5J.js.map