@hmharness/kernel 0.6.8 → 0.7.0

package/dist/loop.d.ts

@@ -24,6 +24,9 @@ export interface LoopResult {
         promptTokens: number;
         completionTokens: number;
     };
+    /** Why the loop stopped: final answer, idle detection, a safety valve, or
+     *  user interrupt - trajectory outcomes (M1) and UI labels consume it. */
+    reason: 'final' | 'idle' | 'turn-valve' | 'token-valve' | 'interrupted';
 }
 export declare function runLoop(opts: {
     provider: ProviderConfig;

package/dist/loop.js

@@ -90,7 +90,7 @@ export async function runLoop(opts) {
         if (calls.length === 0) {
             const text = message.content ?? '';
             events?.onFinal?.(text, turn);
-            return { text, turns: turn, toolUses, messages: working, usage };
+            return { text, turns: turn, toolUses, messages: working, usage, reason: 'final' };
         }
         working.push({ role: 'assistant', content: message.content ?? null, tool_calls: calls });
         const planned = [];
@@ -180,5 +180,5 @@ export async function runLoop(opts) {
                 ? `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 };
+    return { text, turns: executedTurns, toolUses, messages: working, usage, reason };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/kernel",
-  "version": "0.6.8",
+  "version": "0.7.0",
   "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",