@moxxy/mode-goal 0.27.0 → 0.28.0

package/dist/constants.d.ts

@@ -4,36 +4,14 @@ export declare const GOAL_PLUGIN_ID: import("@moxxy/sdk").PluginId;
 export declare const GOAL_COMPLETE_TOOL = "goal_complete";
 /** Tool the model calls to give up gracefully (blocked, needs the user). */
 export declare const GOAL_ABANDON_TOOL = "goal_abandon";
-/**
- * Hard cap on autonomous iterations. Goal mode keeps re-prompting the model to
- * continue until it calls {@link GOAL_COMPLETE_TOOL}; this is the backstop that
- * guarantees the loop terminates even if the model never declares done. High
- * enough for a substantial multi-step task, low enough to bound a runaway.
- */
-export declare const GOAL_MAX_ITERATIONS = 150;
 /**
  * Consecutive iterations where the model emits NO tool calls and hasn't
- * completed. After this many we stop (a stall) rather than spin forever
- * nudging a model that has decided it's done without saying so.
+ * completed. After this many we treat the run as done-in-spirit (the model has
+ * clearly decided it's finished without saying so) and end the turn cleanly
+ * rather than spin forever nudging — this is goal mode's natural-termination
+ * mechanism, not a guardrail: the model is always nudged back to work first.
  */
 export declare const GOAL_MAX_NOOP_ITERATIONS = 3;
-/**
- * Cumulative token ceiling (full prompt — input + cacheRead + cacheCreation +
- * output — across the whole goal run). A second backstop alongside the
- * iteration cap: a few long-context iterations can burn a lot of tokens even
- * under the iteration limit. Generous; the iteration cap is usually the binding
- * guard.
- */
-export declare const GOAL_TOKEN_BUDGET = 4000000;
-/**
- * Max consecutive retryable provider errors before goal mode bails with a fatal
- * error. Goal mode runs unattended with auto-approval, so a sustained retryable
- * condition (429 / overloaded / transient 5xx / ECONNRESET) must NOT busy-loop
- * the provider — back off exponentially and give up after this many in a row.
- * The counter resets on any clean provider call, so a long run can still
- * recover from transient blips.
- */
-export declare const MAX_CONSECUTIVE_RETRIES = 6;
 /**
  * Layered on top of any user system prompt for the whole goal run. The framing
  * is the inverse of normal chat: stopping is NOT the signal to end — the model
@@ -47,4 +25,8 @@ export declare const GOAL_SYSTEM_PROMPT = "You are operating in GOAL MODE. The u
 export declare const CONTINUE_NUDGE: string;
 /** Sharper nudge once the model has idled repeatedly. */
 export declare const STALL_NUDGE: string;
+/** Volatile steer when the stuck-loop detector notices a repetitive pattern.
+ *  Goal mode never aborts on repetition (unattended runs must not be killed by
+ *  a heuristic) — it steers instead. */
+export declare const STUCK_NUDGE_SUFFIX: string;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,cAAc,+BAAiC,CAAC;AAE7D,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,8zDAYuE,CAAC;AAEvG;0EAC0E;AAC1E,eAAO,MAAM,cAAc,QAE8D,CAAC;AAE1F,yDAAyD;AACzD,eAAO,MAAM,WAAW,QAEmG,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,cAAc,+BAAiC,CAAC;AAE7D,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,8zDAYuE,CAAC;AAEvG;0EAC0E;AAC1E,eAAO,MAAM,cAAc,QAE8D,CAAC;AAE1F,yDAAyD;AACzD,eAAO,MAAM,WAAW,QAEmG,CAAC;AAE5H;;wCAEwC;AACxC,eAAO,MAAM,kBAAkB,QAES,CAAC"}

package/dist/constants.js

@@ -5,36 +5,14 @@ export const GOAL_PLUGIN_ID = asPluginId('@moxxy/mode-goal');
 export const GOAL_COMPLETE_TOOL = 'goal_complete';
 /** Tool the model calls to give up gracefully (blocked, needs the user). */
 export const GOAL_ABANDON_TOOL = 'goal_abandon';
-/**
- * Hard cap on autonomous iterations. Goal mode keeps re-prompting the model to
- * continue until it calls {@link GOAL_COMPLETE_TOOL}; this is the backstop that
- * guarantees the loop terminates even if the model never declares done. High
- * enough for a substantial multi-step task, low enough to bound a runaway.
- */
-export const GOAL_MAX_ITERATIONS = 150;
 /**
  * Consecutive iterations where the model emits NO tool calls and hasn't
- * completed. After this many we stop (a stall) rather than spin forever
- * nudging a model that has decided it's done without saying so.
+ * completed. After this many we treat the run as done-in-spirit (the model has
+ * clearly decided it's finished without saying so) and end the turn cleanly
+ * rather than spin forever nudging — this is goal mode's natural-termination
+ * mechanism, not a guardrail: the model is always nudged back to work first.
  */
 export const GOAL_MAX_NOOP_ITERATIONS = 3;
-/**
- * Cumulative token ceiling (full prompt — input + cacheRead + cacheCreation +
- * output — across the whole goal run). A second backstop alongside the
- * iteration cap: a few long-context iterations can burn a lot of tokens even
- * under the iteration limit. Generous; the iteration cap is usually the binding
- * guard.
- */
-export const GOAL_TOKEN_BUDGET = 4_000_000;
-/**
- * Max consecutive retryable provider errors before goal mode bails with a fatal
- * error. Goal mode runs unattended with auto-approval, so a sustained retryable
- * condition (429 / overloaded / transient 5xx / ECONNRESET) must NOT busy-loop
- * the provider — back off exponentially and give up after this many in a row.
- * The counter resets on any clean provider call, so a long run can still
- * recover from transient blips.
- */
-export const MAX_CONSECUTIVE_RETRIES = 6;
 /**
  * Layered on top of any user system prompt for the whole goal run. The framing
  * is the inverse of normal chat: stopping is NOT the signal to end — the model
@@ -62,4 +40,9 @@ export const CONTINUE_NUDGE = `You stopped without calling \`${GOAL_COMPLETE_TOO
 /** Sharper nudge once the model has idled repeatedly. */
 export const STALL_NUDGE = `You have produced no tool calls for several turns. Either take a concrete next action toward the goal, ` +
     `or call \`${GOAL_COMPLETE_TOOL}\` (if done) / \`${GOAL_ABANDON_TOOL}\` (if blocked). Do not reply with only text again.`;
+/** Volatile steer when the stuck-loop detector notices a repetitive pattern.
+ *  Goal mode never aborts on repetition (unattended runs must not be killed by
+ *  a heuristic) — it steers instead. */
+export const STUCK_NUDGE_SUFFIX = `If you are genuinely blocked and no different approach exists, call \`${GOAL_ABANDON_TOOL}\` ` +
+    `with the reason instead of retrying.`;
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAE7D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAClD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;kFAGgD,kBAAkB;qFACf,kBAAkB;sKAC+D,iBAAiB;;;;;6LAKM,iBAAiB;;sGAExG,CAAC;AAEvG;0EAC0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GACzB,iCAAiC,kBAAkB,kDAAkD;IACrG,UAAU,kBAAkB,2DAA2D,CAAC;AAE1F,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GACtB,yGAAyG;IACzG,aAAa,kBAAkB,oBAAoB,iBAAiB,qDAAqD,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAE7D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAClD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;kFAGgD,kBAAkB;qFACf,kBAAkB;sKAC+D,iBAAiB;;;;;6LAKM,iBAAiB;;sGAExG,CAAC;AAEvG;0EAC0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GACzB,iCAAiC,kBAAkB,kDAAkD;IACrG,UAAU,kBAAkB,2DAA2D,CAAC;AAE1F,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GACtB,yGAAyG;IACzG,aAAa,kBAAkB,oBAAoB,iBAAiB,qDAAqD,CAAC;AAE5H;;wCAEwC;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAC7B,yEAAyE,iBAAiB,KAAK;IAC/F,sCAAsC,CAAC"}

package/dist/goal-loop.d.ts

@@ -1,25 +1,35 @@
 import { type ModeContext, type MoxxyEvent } from '@moxxy/sdk';
-/**
- * Override the retry back-off sleep (test seam). Returns a restore fn that
- * callers MUST invoke (in a `finally`) — `sleepImpl` is a module-scoped
- * singleton shared process-wide, so a leaked override bleeds the fake sleep
- * into every other turn/test running in the same worker. Test-only.
- */
-export declare function __setRetrySleepForTests(fn: (ms: number, signal: AbortSignal) => Promise<void>): () => void;
+export { __setRetrySleepForTests } from '@moxxy/sdk';
 /**
  * Goal mode driver.
  *
- * Unlike tool-use (which returns the instant the model stops emitting tools),
- * goal mode treats "stopped emitting tools" as a cue to re-prompt: it keeps
- * the model working autonomously across iterations until the model explicitly
- * calls `goal_complete` (success) or `goal_abandon` (blocked). Every iteration
- * is guarded so the loop always terminates:
+ * Unlike the default mode (which returns the instant the model stops emitting
+ * tools), goal mode treats "stopped emitting tools" as a cue to re-prompt: it
+ * keeps the model working autonomously across iterations until the model
+ * explicitly calls `goal_complete` (success) or `goal_abandon` (blocked).
+ *
+ * Goal mode is deliberately GUARDRAIL-FREE: the user asked for an outcome and
+ * opted into full autonomy, so nothing heuristic may kill the run mid-delivery.
+ * There is no iteration cap (unless the embedder set an explicit
+ * `ctx.maxIterations`), no token budget, and a stuck-loop trip steers the model
+ * instead of aborting. The ONLY ways a run ends:
+ *
+ *   - the model calls `goal_complete` (verified success) or `goal_abandon`
+ *     (blocked, needs the user),
+ *   - the model goes idle {@link GOAL_MAX_NOOP_ITERATIONS} rounds in a row
+ *     despite nudges — it has decided it's done without saying so, so the run
+ *     ends cleanly as a soft completion,
+ *   - the user aborts (Esc / stop), or
+ *   - a genuinely fatal condition (un-compactable context overflow, provider
+ *     giving up after bounded retries).
  *
- *   - hard iteration cap (`maxIterations`)
- *   - cumulative token budget
- *   - stuck-loop detector (same identical-call detection as tool-use)
- *   - no-progress detection (repeated idle iterations → stall stop)
- *   - `ctx.signal.aborted` checked every iteration and mid tool batch
+ * Goal mode is also ONE-SHOT (`transient: true` on the ModeDef): it arms for a
+ * single objective. When the run concludes as DONE — `goal_complete` or the
+ * idle soft-completion — the session hands back to the mode that was active
+ * before goal mode (via `ctx.requestModeSwitch`), so the user's next message is
+ * normal chat again. While the goal is UNFINISHED — `goal_abandon` (the model
+ * needs an answer to continue), a fatal error, or a user abort — the mode stays
+ * armed so the user's reply resumes the autonomous run.
  *
  * Tool calls are auto-approved for the whole run (the user opted into full
  * autonomy) by swapping in a resolver that replaces only the PROMPT path:

package/dist/goal-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"goal-loop.d.ts","sourceRoot":"","sources":["../src/goal-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAaL,KAAK,WAAW,EAChB,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAC;AA2BpB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GACrD,MAAM,IAAI,CAMZ;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAuB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,CAkb9E"}
+{"version":3,"file":"goal-loop.d.ts","sourceRoot":"","sources":["../src/goal-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AAiBpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAuB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,CAiO9E"}