@cjhyy/code-shell-core 0.6.0-rc.8 → 0.7.0-beta.1

package/dist/engine/turn-loop.d.ts

@@ -4,13 +4,14 @@
  * Following Claude Code's po_() pattern:
  * pre_check → model_call → post_check → tool_exec → context_mgmt → hook_notify → next turn
  */
-import type { Message, StreamCallback, TerminalReason, ContentBlock, ToolResult } from "../types.js";
+import type { Message, StreamCallback, TerminalReason, ContentBlock, ToolResult, TokenUsage, ContextUsageAnchor } from "../types.js";
 import type { SteerItem } from "./steer-queue.js";
 import { ModelFacade } from "./model-facade.js";
 import { ToolExecutor } from "../tool-system/executor.js";
 import { ContextManager } from "../context/manager.js";
 import { HookRegistry } from "../hooks/registry.js";
 import { Transcript } from "../session/transcript.js";
+import { type CumulativeUsageCounters } from "./session-usage.js";
 import { type GoalConfig, type GoalExtension } from "./goal.js";
 export interface TurnLoopConfig {
     maxTurns: number;
@@ -18,6 +19,12 @@ export interface TurnLoopConfig {
     tokenBudget?: number;
     onStream?: StreamCallback;
     signal?: AbortSignal;
+    /**
+     * Image-bearing messages added for the current request and not yet consumed
+     * by the model. TurnLoop preserves their base64 for one successful model
+     * response, then downgrades them to placeholders in the working history.
+     */
+    freshImageMessages?: Iterable<Message>;
     /**
      * Fired after each turn boundary is recorded. Lets the engine flush an
      * up-to-date snapshot to state.json mid-run, so a long run doesn't leave
@@ -76,6 +83,13 @@ export interface TurnLoopDeps {
         before: number;
         after: number;
     } | null;
+    /**
+     * Records one LLM response into the session-monotonic cumulative counters.
+     * Returns the updated counters so usage_update can carry both metric scopes.
+     */
+    recordCumulativeUsage?: (usage: TokenUsage) => CumulativeUsageCounters;
+    /** Persist the latest context-estimation anchor derived from provider usage. */
+    recordContextUsageAnchor?: (anchor: ContextUsageAnchor) => void;
     /**
      * Reads/clears any user messages queued for THIS session via the steering
      * channel (Engine.enqueueSteer) while a run is in flight. Consumed at the top
@@ -84,7 +98,13 @@ export interface TurnLoopDeps {
      * Returns [] when nothing is queued. Wired by Engine; absent in standalone
      * tests (turn loop tolerates undefined).
      */
-    consumeSteer?: () => SteerItem[];
+    consumeSteer?: (source?: "normal_step" | "finalize_backfill") => SteerItem[];
+    /**
+     * Execution-level idempotency guard for host-supplied user/steer intents.
+     * Returns false only when a present clientMessageId has already entered this
+     * run or the persisted transcript. Messages without an id bypass this guard.
+     */
+    claimClientMessageId?: (clientMessageId: string, source: "steer") => boolean;
     /**
      * Clear this session's PERSISTED goal (state.activeGoal) and drop the
      * in-flight goal-stop hook, so a user-initiated cancel_goal both stops the
@@ -121,6 +141,10 @@ export declare class TurnLoop {
     private currentTurnLog;
     /** Last emitted ctx token estimate; used to skip no-op usage_update events. */
     private lastCtxEmit;
+    private currentTurnUsage;
+    private currentCumulativeUsage;
+    private readonly sensitiveToolResultRedactions;
+    private readonly pendingImageMessages;
     /**
      * Consecutive on_stop blocks (Goal mode kept the agent going). Reset to 0
      * on any unblocked completion. When it reaches config.maxStopBlocks the
@@ -178,6 +202,11 @@ export declare class TurnLoop {
      * for one Stop still writes a single marker.
      */
     private markStopped;
+    private prepareMessagesForModel;
+    private markPendingImagesConsumed;
+    private redactConsumedSensitiveToolResults;
+    private modelCallRecordingOptions;
+    private trackFreshImageMessage;
     private emitHook;
     /**
      * Emit a usage_update so the UI ctx bar reflects current message-array
@@ -187,17 +216,20 @@ export declare class TurnLoop {
      * promptTokens to override our estimate).
      */
     private emitCtxFromMessages;
+    private recordResponseUsage;
     private emitCtxFromUsage;
     /**
      * Run the multi-turn agent loop until completion.
      */
     run(initialMessages: Message[]): Promise<TurnLoopResult>;
+    private runUnredacted;
     /**
      * Call model with streaming fallback.
      * If streaming fails, emit tombstone and retry non-streaming.
      */
     private callModelWithFallback;
     get currentTurn(): number;
+    private consumeQueuedSteer;
     /**
      * Generate synthetic error tool_results for any dangling tool_use blocks
      * that never received results (e.g. because the API call failed).