@hmharness/kernel 0.6.0 → 0.6.2

package/dist/loop.d.ts

@@ -31,6 +31,10 @@ export declare function runLoop(opts: {
     messages: ChatMessage[];
     ctx: ToolContext;
     maxTurns?: number;
+    /** AbortSignal: when fired, the loop stops at the next turn boundary and
+     *  returns with reason "interrupted". Use for user-initiated cancellation
+     *  (Esc key, /queue skip, web API interrupt). */
+    signal?: AbortSignal;
     /** Explicit transcript budget override (chars). Default: scales with the
      *  model's context window (window.ts registry / provider.contextWindow). */
     maxContextChars?: number;

package/dist/loop.js

@@ -43,6 +43,10 @@ export async function runLoop(opts) {
             reason = 'token-valve';
             break;
         }
+        if (opts.signal?.aborted) {
+            reason = 'interrupted';
+            break;
+        }
         const compacted = opts.summarizeContext
             ? await compactWithDigest(working, budget, opts.summarizeContext)
             : compactMessages(working, budget);
@@ -156,11 +160,13 @@ export async function runLoop(opts) {
     }
     // Safety valve or idle detection fired
     const executedTurns = reason === 'idle' ? turn : turn - 1;
-    const text = reason === 'idle'
-        ? `Agent appears stuck: ${maxIdle} consecutive turns with no successful tool calls. The session is preserved — review the transcript, adjust the approach, and send a new message to continue.`
-        : reason === 'turn-valve'
-            ? `Turn limit reached (${executedTurns} turns). The session is preserved — send another message to continue.`
-            : `Token budget limit reached (~${usage.promptTokens + usage.completionTokens} tokens). The session is preserved — send another message to continue.`;
+    const text = reason === 'interrupted'
+        ? `Task interrupted by user at turn ${turn}. Partial results preserved — the transcript is resumable.`
+        : reason === 'idle'
+            ? `Agent appears stuck: ${maxIdle} consecutive turns with no successful tool calls. The session is preserved — review the transcript, adjust the approach, and send a new message to continue.`
+            : reason === 'turn-valve'
+                ? `Turn limit reached (${executedTurns} turns). The session is preserved — send another message to continue.`
+                : `Token budget limit reached (~${usage.promptTokens + usage.completionTokens} tokens). The session is preserved — send another message to continue.`;
     events?.onFinal?.(text, executedTurns);
     return { text, turns: executedTurns, toolUses, messages: working, usage };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/kernel",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "hmharness kernel: tool registry, provider adapters, the agent loop, session log, config. Zero runtime dependencies (Node >=22 native fetch).",
   "type": "module",
   "main": "dist/index.js",