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

package/dist/engine/engine.d.ts

@@ -6,14 +6,17 @@ import { ToolRegistry } from "../tool-system/registry.js";
 import { type BuiltinToolFn } from "../tool-system/builtin/index.js";
 import { HookRegistry } from "../hooks/registry.js";
 import { type GoalConfig, type GoalExtension } from "./goal.js";
+import { type CompactStrategy } from "../context/manager.js";
 import { SessionManager } from "../session/session-manager.js";
 import type { AskUserFn } from "../tool-system/builtin/ask-user.js";
 import type { CapabilityOverride } from "../settings/schema.js";
 import { type FeatureFlagName } from "../settings/feature-flags.js";
 import type { ToolContext } from "../tool-system/context.js";
+import { type SandboxBackend } from "../tool-system/sandbox/index.js";
 import { ModelPool, type ModelEntry } from "../llm/model-pool.js";
 import { AgentDefinitionRegistry } from "../agent/agent-definition-registry.js";
 import { EngineRuntime } from "./runtime.js";
+import type { InputAttachmentMeta } from "../protocol/types.js";
 /**
  * Build ScanOptions.compatFileNames from the user's instruction compat toggles.
  * Primary file name stays hard-wired to CODESHELL.md (not exposed). Turning a
@@ -27,6 +30,10 @@ export declare function compatFileNamesFrom(instructions?: {
 }): string[];
 export type { EngineConfig, EngineHookConfig, EngineResult } from "./types.js";
 import type { EngineConfig, EngineResult } from "./types.js";
+export interface EnqueueSteerResult {
+    accepted: boolean;
+    id: string;
+}
 export { diskDefaultsFrom, type DiskDefaultPatch } from "../settings/disk-defaults.js";
 /**
  * Resolve the LLM config for a spawned child Engine.
@@ -48,7 +55,7 @@ export declare function resolveChildLlm(modelKey: string | undefined, pool: Mode
  * Names in `disabledAgents` are filtered out so the LLM never sees them.
  */
 /**
- * Resolve the working directory for a run. Precedence:
+ * Resolve the working directory for a run. Precedence for legacy sessions:
  *   options.cwd  >  resumed session's state.cwd  >  config.cwd  >  process.cwd()
  *
  * The session-cwd tier is what stops a project-bound session from being
@@ -256,20 +263,22 @@ export declare class Engine {
      * clear "no browser panel" error.
      */
     setBrowserBridge(bridge: import("../tool-system/browser-bridge.js").BrowserBridge | undefined): void;
+    /** Inject the host-backed workspace bridge after construction. */
+    setWorkspaceBridge(bridge: import("../tool-system/workspace-bridge.js").WorkspaceBridge | undefined): void;
     /**
      * Queue a user message to be spliced into the in-flight run for `sessionId`
      * at the next turn-loop step boundary — the 不打断 steering path (vs cancel +
      * resend). General-purpose: any host path (UI 引导, future agent coordination,
-     * external triggers) can call it. If no run is active for the session the
-     * message simply waits in the queue and is consumed when that session next
-     * runs (rare race; host normally only steers while busy). No-op on blank text.
+     * external triggers) can call it. If no run is active for this session, reject
+     * without queueing so the host can downgrade to a normal run immediately.
+     * No-op on blank text.
      *
      * `id` is the host's stable queue-entry id. It rides through to the
      * `steer_injected` event (so the host can match the injected bubble back to
      * the queued draft) and is the handle `unsteer` uses to revoke a still-pending
      * entry. A blank id is tolerated but means the entry can't be revoked.
      */
-    enqueueSteer(sessionId: string, text: string, id?: string): void;
+    enqueueSteer(sessionId: string, text: string, id?: string, clientMessageId?: string): EnqueueSteerResult;
     /**
      * Revoke a still-pending steer entry (the 撤回 path). Returns true if it was
      * removed, false if it was already consumed by the turn loop (can't take it
@@ -318,6 +327,10 @@ export declare class Engine {
          * on replay (matching the live UI, which shows only the assistant reply).
          */
         injected?: boolean;
+        /** Stable id for this user-intent, used to make duplicate submits idempotent. */
+        clientMessageId?: string;
+        /** Structured input attachments. Legacy `<codeshell-image>` blocks remain supported. */
+        attachments?: InputAttachmentMeta[];
     }): Promise<EngineResult>;
     /**
      * Run the end-of-session memory pipeline as a fire-and-forget background
@@ -332,6 +345,11 @@ export declare class Engine {
      * active run's client) when unset, unknown, or on any build failure — aux
      * work is best-effort and must never break a run.
      */
+    /**
+     * Build the SummarizeFn used for context compaction. Extracted so both the
+     * run path and forceCompact share one definition of the summarization call.
+     */
+    private buildSummarizeFn;
     private resolveAuxClient;
     private runMemoryPipeline;
     /**
@@ -363,10 +381,8 @@ export declare class Engine {
      */
     switchModel(key: string): ModelEntry;
     /**
-     * Zero a session's cumulative token/cache usage on disk. Called on a model
-     * switch: a different model has its own prompt cache, so the accumulated
-     * cache-hit stats from the prior model are no longer meaningful. The next
-     * run's baseline (snapshotted from state.tokenUsage) then starts from zero.
+     * Zero the legacy/model-scoped token/cache usage window on disk. The
+     * whole-session cumulative counters are intentionally left alone.
      */
     resetSessionUsage(sessionId: string): void;
     /**
@@ -450,16 +466,22 @@ export declare class Engine {
      * session with no active goal is a no-op returning false.
      */
     clearGoal(sessionId: string): boolean;
+    /**
+     * Reset a session's workspace pointer back to its main root. If the session is
+     * actively running, mutate that live SessionBundle first so the run's next
+     * saveState cannot resurrect a stale worktree pointer.
+     */
+    releaseSessionWorkspace(sessionId: string): import("../types.js").SessionWorkspace | null;
     injectContext(sessionId: string, content: string): void;
     /**
      * Force context compaction on a session.
      * Returns token stats before/after.
      */
-    forceCompact(sessionId?: string): {
+    forceCompact(sessionId?: string): Promise<{
         before: number;
         after: number;
-        strategy: string;
-    };
+        strategy: "none (no active session)" | "no compaction needed" | "compacted" | CompactStrategy;
+    }>;
     private stripUserContextMessage;
     private getSettingsManager;
     /**
@@ -560,6 +582,7 @@ export declare class Engine {
      * by tests that want a ToolContext without a full run() cycle.
      */
     private resolveSandboxWithoutRuntime;
+    private resolveSandboxConfigForCwd;
     /**
      * Build the shell env layered onto the Bash tool / background shells (see
      * mergeShellEnv). Three user-configured sources, merged lowest → highest:
@@ -612,6 +635,9 @@ export declare class Engine {
         linux?: string;
         windows?: string;
     } | undefined;
+    readWorktreeBranchPrefix(cwd?: string): string | undefined;
+    resolveWorktreeSetupSandbox(cwd: string): Promise<SandboxBackend | undefined>;
+    readWorktreeSetupShellEnv(cwd?: string): Record<string, string> | undefined;
     buildToolContext(): ToolContext;
     /**
      * Read settings.disabledSkills + settings.disabledPlugins in a single