@moxxy/mode-goal 0.27.0 → 0.28.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,eAAO,MAAM,QAAQ,8BAQnB,CAAC;AAEH,eAAO,MAAM,cAAc,6BAOzB,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,eAAO,MAAM,QAAQ,8BAanB,CAAC;AAEH,eAAO,MAAM,cAAc,6BAOzB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -5,11 +5,15 @@ import { runGoalMode } from './goal-loop.js';
 export { GOAL_MODE_NAME } from './constants.js';
 export const goalMode = defineMode({
     name: GOAL_MODE_NAME,
-    description: 'Autonomous goal loop: works across many turns until it calls goal_complete (tools auto-approved)',
+    description: 'Autonomous goal run: works until it calls goal_complete (tools auto-approved), then hands back to your previous mode',
     // Goal mode auto-approves tools and keeps working unattended, so channels
     // surface a persistent accent badge while it's active — the user must always
     // know the agent is driving itself.
     badge: { label: 'GOAL', tone: 'attention' },
+    // One-shot: armed per objective, disarms itself when the goal concludes,
+    // and is never persisted as the boot/category default — `/goal` once must
+    // not make every future session autonomous.
+    transient: true,
     run: runGoalMode,
 });
 export const goalModePlugin = definePlugin({

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,kGAAkG;IAC/G,0EAA0E;IAC1E,6EAA6E;IAC7E,oCAAoC;IACpC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;IAC3C,GAAG,EAAE,WAAW;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;IACzC,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;IAChB,yEAAyE;IACzE,yDAAyD;IACzD,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,KAAK,EAAE,SAAS;CACjB,CAAC,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,sHAAsH;IACxH,0EAA0E;IAC1E,6EAA6E;IAC7E,oCAAoC;IACpC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;IAC3C,yEAAyE;IACzE,0EAA0E;IAC1E,4CAA4C;IAC5C,SAAS,EAAE,IAAI;IACf,GAAG,EAAE,WAAW;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;IACzC,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;IAChB,yEAAyE;IACzE,yDAAyD;IACzD,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,KAAK,EAAE,SAAS;CACjB,CAAC,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moxxy/mode-goal",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Goal mode: state a goal once and the agent works autonomously across many turns until it calls goal_complete (or goal_abandon), guarded by an iteration cap, a token budget, a stuck-loop detector, no-progress detection, and the user's abort.",
   "keywords": [
     "moxxy",
@@ -44,16 +44,16 @@
   },
   "dependencies": {
     "zod": "^3.24.0",
-    "@moxxy/sdk": "0.27.0"
+    "@moxxy/sdk": "0.28.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.7.3",
     "vitest": "^2.1.8",
-    "@moxxy/testing": "0.0.45",
+    "@moxxy/core": "0.28.0",
     "@moxxy/vitest-preset": "0.0.0",
-    "@moxxy/core": "0.27.0",
-    "@moxxy/tsconfig": "0.0.0"
+    "@moxxy/tsconfig": "0.0.0",
+    "@moxxy/testing": "0.0.46"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/constants.ts

@@ -8,40 +8,15 @@ 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
@@ -73,3 +48,10 @@ export const CONTINUE_NUDGE =
 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.`;