@leanandmean/coding-agent 0.74.1-scramjet.72 → 0.74.1-scramjet.74

package/README.md

@@ -146,7 +146,7 @@ Interactive mode retains the current transcript in an application-managed viewpo
 
 While content remains below the viewport, the existing gap above the dock shows `Session: N lines below · Ctrl+End: latest`; the row stays blank at the tail. This counts rendered session rows, not unread messages or hidden draft text, and does not add another editor border. Narrow terminals shorten the hint and finally show `Session ↓…` if the labelled exact count cannot fit. The indicator is decorative and excluded from application copying.
 
-Drag without modifiers to select displayed text, including across scrolling; double-click selects a word and triple-click selects one displayed line. Right-click the selection or press Ctrl+C to copy it; built-in text rendering omits known layout padding and rejoins soft wraps while preserving genuine indentation and hard breaks. Selection stays live as output changes, and Copy captures the last displayed highlight immediately. Dragging can cross between transcript and editor; a downward transcript drag reaches the transcript bottom before entering the dock. Editor copying also rejoins soft wraps. Without selection, Ctrl+C retains its normal editor/quit behavior, and right-clicking the transcript, blank space, or editor pastes local clipboard text into the visible, focused editor without submitting it. Selectors and overlays do not paste. Terminal-native Copy menus cannot see application selection.
+Drag without modifiers to select displayed text, including across scrolling; double-click selects a word and triple-click selects one displayed line. Right-click the selection or press Ctrl+C to copy it; built-in text rendering omits known layout padding and rejoins soft wraps while preserving genuine indentation and hard breaks. Selection stays live as output changes, and Copy captures the last displayed highlight immediately. Dragging can cross between transcript and editor; a downward transcript drag reaches the transcript bottom before entering the dock. Editor copying also rejoins soft wraps. Without selection, Ctrl+C retains its normal editor/quit behavior, and right-clicking the transcript, blank space, or editor pastes local clipboard text into the visible, focused editor without submitting it. Selectors and overlays do not paste. Command+V uses ordinary terminal paste into the editor without submission. Command+C and terminal-native Copy menus remain terminal-owned and cannot copy Scramjet’s application selection. iTerm2 requires explicitly enabling `ReportRightClick=true` for right-click Copy/Paste; this affects other mouse-reporting applications too, and Scramjet never changes it automatically. See [configuration requirements and evidence limits](docs/terminal-setup.md#transcript-browsing-and-copying).
 
 Home/End always retain editor line-start/end behavior. Ctrl+Home/Ctrl+End navigate to the transcript beginning/bottom, with Ctrl+End resuming following. Submitting nonempty editor input resumes following immediately, including `!`/`!!` commands, slash commands and queued messages. A new user message appearing in the transcript also resumes following. While scrolled away, PageUp/PageDown browse and Escape returns to the live tail; Alt+PageUp/Alt+PageDown enter browsing from the tail. Docked editing and presentation toggles preserve the reading position; undocked editing reveals its cursor. At the tail, ordinary editor/list bindings apply. Hidden approval controls must first be revealed before a subsequent activation can approve.
 
@@ -198,6 +198,9 @@ See `/hotkeys` for the full list. Customize via `~/.scramjet/agent/keybindings.j
 
 | Key | Action |
 |-----|--------|
+| Right-click | Copy application selection; without selection, paste into the eligible focused editor |
+| Command+C (macOS) | Terminal-owned Copy, not Scramjet application-selection Copy |
+| Command+V (macOS) | Paste text at the editor caret without submitting |
 | Ctrl+C | Copy transcript selection; otherwise clear editor |
 | Ctrl+C twice | Quit |
 | Escape | Return from transcript browsing; otherwise cancel/abort |
@@ -217,6 +220,10 @@ Submit messages while the agent is working:
 - **Escape** aborts and restores queued messages to editor
 - **Alt+Up** retrieves queued messages back to editor
 
+Failed requests are displayed as **attempts**, not final outcomes. Automatic recovery stays within the configured [retry limits](docs/settings.md#retry), including applicable automatic compaction. During non-streaming recovery/settlement, Enter and Alt+Enter retain your text with a wait/cancel explanation rather than silently dropping or replaying it. Escape cancels the originating execution and restores explicitly queued messages. A rejected submission restores its text only if no newer draft was typed. Cancellation and final failure give a safe next action; recovered execution does not mean the entire task completed.
+
+Text print mode (`--print`) uses the final prompt invocation's captured provider result, not earlier answers or later harness artifacts. Failed/cancelled execution reports to stderr and exits nonzero; a handled command that starts no immediate run prints no borrowed answer. JSON and RPC event framing remain unchanged.
+
 On Windows Terminal, `Alt+Enter` is fullscreen by default. Remap it in [docs/terminal-setup.md](docs/terminal-setup.md) so scramjet can receive the follow-up shortcut.
 
 Configure delivery in [settings](docs/settings.md): `steeringMode` defaults to `"all"` (delivers all queued at once), while `followUpMode` defaults to `"one-at-a-time"` (waits for a response). Both settings accept either value. `transport` selects provider transport preference (`"sse"`, `"websocket"`, or `"auto"`) for providers that support multiple transports.

package/dist/core/agent-session.d.ts

@@ -13,7 +13,7 @@
  * Modes use this class and add their own I/O layer on top.
  */
 import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLevel } from "@leanandmean/agent";
-import type { ImageContent, Model, TextContent } from "@leanandmean/ai";
+import type { AssistantMessage, ImageContent, Model, TextContent } from "@leanandmean/ai";
 import { type BashResult } from "./bash-executor.js";
 import { type CompactionResult } from "./compaction/index.js";
 import { type ContextUsage, type DeliverAs, type DispatchUserInputOptions, type ExtensionCommandContextActions, type ExtensionErrorListener, ExtensionRunner, type ExtensionUIContext, type InputSource, type InvokeHarnessToolOptions, type ReplacedSessionContext, type SendMessageDeliverAs, type SessionStartEvent, type ShutdownHandler, type ToolDefinition, type ToolInfo } from "./extensions/index.js";
@@ -115,6 +115,17 @@ export interface ExtensionBindings {
     shutdownHandler?: ShutdownHandler;
     onError?: ExtensionErrorListener;
 }
+export type RunSettlement = {
+    status: "completed";
+    assistantMessage?: AssistantMessage;
+} | {
+    status: "failed";
+    assistantMessage?: AssistantMessage;
+    errorMessage: string;
+} | {
+    status: "cancelled";
+    assistantMessage?: AssistantMessage;
+};
 /** Options for AgentSession.prompt() */
 export interface PromptOptions {
     /** Whether to expand file-based prompt templates (default: true) */
@@ -133,6 +144,8 @@ export interface PromptOptions {
     source?: InputSource;
     /** Internal hook used by RPC mode to observe prompt preflight acceptance or rejection. */
     preflightResult?: (success: boolean) => void;
+    /** Synchronous capture after immediate-run reservation, before launch; never await from a gating hook. */
+    onRunSettlement?: (settlement: Promise<RunSettlement>) => void;
 }
 /** Result from cycleModel() */
 export interface ModelCycleResult {
@@ -249,6 +262,7 @@ export declare class AgentSession {
     private _captureAgentRunSettlement;
     private _settleAgentRun;
     private _settleRetryChain;
+    private _trySettleRetryChain;
     private _completeAgentRun;
     private _reserveAgentRunStart;
     private _rejectAgentRunStart;
@@ -544,6 +558,7 @@ export declare class AgentSession {
     abortBranchSummary(): void;
     private _checkCompaction;
     private _runAutoCompaction;
+    private _scheduleCompactionContinuation;
     /**
      * Toggle auto-compaction setting.
      */
@@ -574,6 +589,7 @@ export declare class AgentSession {
     private _releaseRetryForFailedRun;
     private _reportRetryFailure;
     private _handleRetryableError;
+    private _resumeRetry;
     private _finishCancelledRetry;
     /**
      * Cancel in-progress retry.
@@ -582,6 +598,8 @@ export declare class AgentSession {
     /** Agent's own `activeRun` guard is false during backoff; the retry phase owns the idle Agent then. */
     private _assertRetryNotOwningIdleAgent;
     private _runAgentPrompt;
+    private _continueAgentRun;
+    private _cancelRunSettlements;
     private waitForRetry;
     /** Whether auto-retry is currently in progress */
     get isRetrying(): boolean;