@nanhara/hara 0.124.3 → 0.124.4

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to `@nanhara/hara`.
 > Versioning (pre-1.0, SemVer-style): the **minor** (middle) number bumps for a **new feature**; the
 > **patch** (last) number bumps for **optimizations/fixes of existing features**.
 
+## 0.124.4 — 2026-07-18 — deadline-aware task checkpoints
+
+- **The 80% run-budget warning now reaches the Agent, not only the user.** Before the next model turn,
+  Hara injects a hidden checkpoint instruction to finish the current atomic step, persist artifacts,
+  update the checklist, and defer a new multi-minute stage to `/continue`. A video/image batch, full
+  validation, preview, render, install, or deployment should no longer begin with too little turn budget
+  and then appear to stop mysteriously at the 30-minute safety pause.
+
 ## 0.124.3 — 2026-07-17 — project-aware resume and runtime hardening
 
 - **Saved sessions now resume in the project they belong to.** `hara resume <id>` validates the persisted

package/dist/agent/loop.js

@@ -149,6 +149,13 @@ function composeSystem(cwd, projectContext, override, memory, continuationSessio
 }
 const RUN_STOPPED = Symbol("agent-run-stopped");
 const REPEATED_FAILURE_LIMIT = 3;
+export function deadlineCheckpointReminder(timeoutMs) {
+    return (`Turn budget checkpoint: about 20% remains before the ${formatAgentDuration(timeoutMs)} safety pause. ` +
+        "Stop expanding scope. Finish only the current atomic step, persist any usable artifact, update todo_write, " +
+        "and reply with the completed checkpoint plus the next exact step. Do not start another generation batch, " +
+        "install, full validation suite, preview, render, deployment, or other multi-minute stage in this turn. " +
+        "The user can run /continue to start that next stage with a fresh bounded budget.");
+}
 function showRunNotice(opts, message, critical = false) {
     if (opts.quiet)
         return;
@@ -164,6 +171,13 @@ function showRunNotice(opts, message, critical = false) {
         }
     }
 }
+function requestRunCheckpoint(opts, life) {
+    if (life.disposed || life.checkpointDue || life.signal.aborted)
+        return;
+    life.checkpointDue = true;
+    const remainingMs = Math.max(0, life.timeoutMs - (Date.now() - life.startedAt));
+    showRunNotice(opts, `⚠ agent turn nearing its safety pause: ${formatAgentDuration(remainingMs)} remains. The agent will be told to finish the current atomic step and checkpoint; use \`/continue\` for the next expensive stage.`);
+}
 function warnRun(opts, life) {
     if (life.disposed || life.warned || life.signal.aborted)
         return;
@@ -191,6 +205,9 @@ function createRunLifecycle(opts) {
     const warningDelay = Math.min(5 * 60_000, Math.max(250, Math.floor(timeoutMs * 0.8)));
     const warningTimer = setTimeout(() => warnRun(opts, life), warningDelay);
     warningTimer.unref?.();
+    const checkpointDelay = Math.max(250, Math.floor(timeoutMs * 0.8));
+    const checkpointTimer = setTimeout(() => requestRunCheckpoint(opts, life), checkpointDelay);
+    checkpointTimer.unref?.();
     let removeStopListener = () => { };
     const stopPromise = new Promise((resolveStopped) => {
         const stopped = () => resolveStopped(RUN_STOPPED);
@@ -205,6 +222,7 @@ function createRunLifecycle(opts) {
         timeoutController,
         timeoutTimer,
         warningTimer,
+        checkpointTimer,
         stopPromise,
         removeStopListener,
         startedAt,
@@ -213,6 +231,8 @@ function createRunLifecycle(opts) {
         rounds: 0,
         timedOut: false,
         warned: false,
+        checkpointDue: false,
+        checkpointInjected: false,
         limitAnnounced: false,
         disposed: false,
         failedCalls: new Map(),
@@ -223,6 +243,7 @@ function disposeRunLifecycle(life) {
     life.disposed = true;
     clearTimeout(life.timeoutTimer);
     clearTimeout(life.warningTimer);
+    clearTimeout(life.checkpointTimer);
     life.removeStopListener();
 }
 function hardStop(opts, life, kind, detail) {
@@ -325,6 +346,15 @@ async function runAgentInner(history, opts, life) {
         life.rounds += 1;
         if (life.rounds >= Math.ceil(life.maxRounds * 0.75))
             warnRun(opts, life);
+        if (Date.now() - life.startedAt >= Math.floor(life.timeoutMs * 0.8))
+            requestRunCheckpoint(opts, life);
+        if (!opts.quiet && life.checkpointDue && !life.checkpointInjected) {
+            life.checkpointInjected = true;
+            history.push({
+                role: "user",
+                content: wrapReminders([deadlineCheckpointReminder(life.timeoutMs)]),
+            });
+        }
         // Type-ahead steering: fold in anything the user submitted while the previous step ran, so it
         // reaches the model on this next call (drained after the last tool round; empty on the 1st pass).
         if (opts.pendingInput && !runSignal.aborted) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanhara/hara",
-  "version": "0.124.3",
+  "version": "0.124.4",
   "description": "hara — a coding agent CLI that runs like an engineering org.",
   "bin": {
     "hara": "runtime-bootstrap.cjs"