@pikiloom/kernel 0.2.20 → 0.2.21

package/dist/drivers/claude.d.ts

@@ -40,6 +40,9 @@ export declare function claudeBgSettleQuietMs(): number;
 export declare function claudeModelStallMs(): number;
 export declare const CLAUDE_TRUNCATED_RECOVERY_PROMPT: string;
 export declare function claudeTruncatedRecoveryEnabled(): boolean;
+export declare function isClaudeSyntheticResumeNoise(text: string): boolean;
+export declare function claudeProducedRealOutput(s: any): boolean;
+export declare function claudeResumeNoopRetryLimit(): number;
 export declare function claudeUserEventHasToolResult(ev: any): boolean;
 export declare function isTerminalTaskStatus(status: unknown): boolean;
 export declare function trackClaudeBackgroundTask(ev: any, s: any): void;

package/dist/drivers/claude.js

@@ -79,6 +79,10 @@ export class ClaudeDriver {
             let settled = false;
             // One-shot guard for the truncated-turn recovery injection (see the result handler).
             let truncatedRecoveryAttempted = false;
+            // Bounded counter for the no-op-resume recovery re-injection (see the result handler): a
+            // resume of a session left incomplete by a prior turn can no-op several times before the
+            // CLI's repair clears and it runs our prompt for real.
+            let noopResumeRetries = 0;
             // holdCap: hard backstop while a background task is still running (never-completing daemon).
             // quiet: fires once all known background tasks finished AND Claude has gone quiet, so trailing
             // wake-up turns can still land before we close (see claudeBgSettleQuietMs).
@@ -278,6 +282,29 @@ export class ClaudeDriver {
                                 settleResult({ stopReason: 'truncated', kill: false });
                                 return;
                             }
+                            // No-op resume repair: resuming a session whose previous turn was left incomplete (a
+                            // background hold that reclaimed its sub-agents/workflow — the ultra "no response"
+                            // report — an interrupt, a stall) makes the CLI answer with a synthetic "No response
+                            // requested." no-op that ran NONE of our prompt (no model turn at all), instead of
+                            // processing the message. Settling here delivers a silent "(no textual response)" and
+                            // drops the user's send. stdin is still open: re-issue the prompt so the CLI drives
+                            // through its repair to a real answer within this one turn. Bounded (the repair can
+                            // no-op more than once); the post-tool stall watchdog is the backstop if the CLI never
+                            // engages. Scoped to resumes (input.sessionId) — a fresh session has no dangling turn.
+                            if (!hasError && !!input.sessionId && !claudeProducedRealOutput(state)
+                                && noopResumeRetries < claudeResumeNoopRetryLimit()) {
+                                noopResumeRetries++;
+                                let injected = false;
+                                try {
+                                    child.stdin.write(claudeUserMessage(input.prompt, input.attachments) + '\n');
+                                    injected = true;
+                                }
+                                catch { /* fall through to settle */ }
+                                if (injected) {
+                                    armModelStall();
+                                    continue;
+                                }
+                            }
                             // kill=false: the CLI persists the turn into the session jsonl AFTER emitting
                             // `result`, and on a large session that flush (a whole-file rewrite) takes long
                             // enough that an immediate SIGTERM kills the process mid-write — the reply was
@@ -523,6 +550,13 @@ export function handleClaudeEvent(ev, s, emit) {
         return;
     }
     if (t === 'assistant') {
+        // Synthetic resume-repair no-op: resuming a session whose previous turn was left incomplete
+        // makes the CLI emit an assistant message with model '<synthetic>' whose only text is
+        // "No response requested." (paired with an isMeta "Continue from where you left off." user
+        // record). It is NOT model output — mirror the legacy driver and drop it, so it neither shows
+        // as the reply nor counts as real output (the no-op-resume recovery keys off that emptiness).
+        if (ev.message?.model === '<synthetic>' && isClaudeSyntheticResumeNoise(claudeContentText(ev.message?.content)))
+            return;
         const contents = ev.message?.content || [];
         for (const b of contents) {
             if (b?.type !== 'tool_use')
@@ -791,6 +825,31 @@ export function claudeTruncatedRecoveryEnabled() {
     const v = String(process.env.PIKILOOM_CLAUDE_TRUNCATED_RECOVERY ?? '').trim().toLowerCase();
     return v !== '0' && v !== 'false' && v !== 'off';
 }
+// The CLI's resume-repair placeholder for a turn that never concluded: an assistant message with
+// model '<synthetic>' whose only text is "No response requested." (paired with an isMeta "Continue
+// from where you left off." user record). It is NOT model output. Mirrors the legacy driver.
+export function isClaudeSyntheticResumeNoise(text) {
+    const t = (text || '').trim().toLowerCase();
+    return t === 'no response requested.' || t === 'no response requested';
+}
+// True once the turn produced ANY real model output — streamed or whole-message text/reasoning, a
+// tool use, or a spawned sub-agent. False for a pure no-op (a synthetic resume-repair result that
+// ran none of the prompt), which is exactly what the no-op-resume recovery keys off. Pure +
+// exported for hermetic testing.
+export function claudeProducedRealOutput(s) {
+    return !!(s?.streamedText || s?.streamedReasoning
+        || (s?.tools?.size ?? 0) > 0 || (s?.subAgents?.size ?? 0) > 0
+        || (typeof s?.text === 'string' && s.text.trim().length > 0)
+        || (typeof s?.reasoning === 'string' && s.reasoning.trim().length > 0));
+}
+// How many times to re-issue the prompt when a resume comes back a pure no-op before giving up and
+// settling (see the result handler). Bounded so a genuinely dead session can't loop forever; 0
+// disables the recovery. Override with PIKILOOM_CLAUDE_RESUME_NOOP_RETRIES.
+const CLAUDE_RESUME_NOOP_RETRY_DEFAULT = 3;
+export function claudeResumeNoopRetryLimit() {
+    const raw = Number(process.env.PIKILOOM_CLAUDE_RESUME_NOOP_RETRIES);
+    return Number.isFinite(raw) && raw >= 0 ? raw : CLAUDE_RESUME_NOOP_RETRY_DEFAULT;
+}
 // True when a claude `type:'user'` stream event carries at least one tool_result block — i.e. the
 // tool loop just handed control back to the model. Pure + exported for hermetic testing.
 export function claudeUserEventHasToolResult(ev) {

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export type { SessionStore, CoreSessionRecord, ModelResolver, ModelInjection, To
 export type { LoomIO, PromptInput, Surface, SurfaceCapabilities, Plugin, SpawnContribution, } from './contracts/surface.js';
 export { FsSessionStore, NullModelResolver, NoopToolProvider, PassthroughSystemPromptBuilder, AutoCancelInteractionHandler, DeferToTerminalInteractionHandler, NoopCatalog, defaultBaseDir, } from './ports/defaults.js';
 export { EchoDriver } from './drivers/echo.js';
-export { ClaudeDriver, isTerminalTaskStatus, trackClaudeBackgroundTask, pendingClaudeBackgroundTasks, markClaudeTaskNotificationTerminal, decideClaudeResultSettle, claudeBgHoldCapMs, claudeBgAgentHoldCapMs, claudeTurnHasAgentBackground, claudeBgHoldRecheckMs, claudeBgSettleQuietMs, type ClaudeResultSettleDecision, claudeModelStallMs, claudeUserEventHasToolResult, handleClaudeEvent, claudeTurnEndedDangling, claudeTruncatedRecoveryEnabled, CLAUDE_TRUNCATED_RECOVERY_PROMPT, } from './drivers/claude.js';
+export { ClaudeDriver, isTerminalTaskStatus, trackClaudeBackgroundTask, pendingClaudeBackgroundTasks, markClaudeTaskNotificationTerminal, decideClaudeResultSettle, claudeBgHoldCapMs, claudeBgAgentHoldCapMs, claudeTurnHasAgentBackground, claudeBgHoldRecheckMs, claudeBgSettleQuietMs, type ClaudeResultSettleDecision, claudeModelStallMs, claudeUserEventHasToolResult, handleClaudeEvent, claudeTurnEndedDangling, claudeTruncatedRecoveryEnabled, CLAUDE_TRUNCATED_RECOVERY_PROMPT, isClaudeSyntheticResumeNoise, claudeProducedRealOutput, claudeResumeNoopRetryLimit, } from './drivers/claude.js';
 export { CodexDriver } from './drivers/codex.js';
 export { GeminiDriver } from './drivers/gemini.js';
 export { AcpDriver, type AcpDriverConfig } from './drivers/acp.js';

package/dist/index.js

@@ -19,7 +19,7 @@ export { attachTui } from './runtime/tui.js';
 export { FsSessionStore, NullModelResolver, NoopToolProvider, PassthroughSystemPromptBuilder, AutoCancelInteractionHandler, DeferToTerminalInteractionHandler, NoopCatalog, defaultBaseDir, } from './ports/defaults.js';
 // Drivers & surfaces (also available via subpath exports)
 export { EchoDriver } from './drivers/echo.js';
-export { ClaudeDriver, isTerminalTaskStatus, trackClaudeBackgroundTask, pendingClaudeBackgroundTasks, markClaudeTaskNotificationTerminal, decideClaudeResultSettle, claudeBgHoldCapMs, claudeBgAgentHoldCapMs, claudeTurnHasAgentBackground, claudeBgHoldRecheckMs, claudeBgSettleQuietMs, claudeModelStallMs, claudeUserEventHasToolResult, handleClaudeEvent, claudeTurnEndedDangling, claudeTruncatedRecoveryEnabled, CLAUDE_TRUNCATED_RECOVERY_PROMPT, } from './drivers/claude.js';
+export { ClaudeDriver, isTerminalTaskStatus, trackClaudeBackgroundTask, pendingClaudeBackgroundTasks, markClaudeTaskNotificationTerminal, decideClaudeResultSettle, claudeBgHoldCapMs, claudeBgAgentHoldCapMs, claudeTurnHasAgentBackground, claudeBgHoldRecheckMs, claudeBgSettleQuietMs, claudeModelStallMs, claudeUserEventHasToolResult, handleClaudeEvent, claudeTurnEndedDangling, claudeTruncatedRecoveryEnabled, CLAUDE_TRUNCATED_RECOVERY_PROMPT, isClaudeSyntheticResumeNoise, claudeProducedRealOutput, claudeResumeNoopRetryLimit, } from './drivers/claude.js';
 export { CodexDriver } from './drivers/codex.js';
 export { GeminiDriver } from './drivers/gemini.js';
 export { AcpDriver } from './drivers/acp.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikiloom/kernel",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "Heterogeneous coding agents (Claude / Codex / Gemini / ACP) -> an interaction-friendly, accumulating session snapshot + control handle, over pluggable surfaces (IM, Web, tunnel, TUI). The reusable core pikiloom itself is built on.",
   "type": "module",
   "license": "MIT",