laohuang 0.4.1 → 0.5.0

package/README.md

@@ -90,10 +90,9 @@ laohuang
 输入任务，使用 `/help` 查看命令，使用 `/exit` 或 `Ctrl+D` 退出。通过 `/model`
 切换供应商或模型时会保留当前对话上下文。
 
-交互终端使用简洁的上下边框标识输入区域，不显示常驻状态或快捷键底栏。输入 `/` 会
-立即显示命令、说明和参数补全；`Tab`/`Enter` 可接受当前补全，`/model` 会按
-“供应商 → 模型”分层补全。终端还支持多行
-编辑和当前会话输入历史：
+当前交互终端使用简洁的上下边框标识输入区域。输入 `/` 会立即显示命令、说明和参数
+补全；`Tab`/`Enter` 可接受当前补全，`/model` 会按“供应商 → 模型”分层补全。
+终端还支持多行编辑和当前会话输入历史：
 
 - `Enter`：发送任务。
 - `Alt+Enter`：插入换行。
@@ -107,6 +106,12 @@ laohuang
 通过 Web 日志面板查看。输出被重定向或由程序调用 CLI 时，会自动回退到稳定的纯文本
 格式。
 
+### TUI 设计方向
+
+后续 TUI 会继续增强为完整 Agent 控制台：固定外框、`laoHuang` 标题栏、欢迎语、
+状态栏、工具输出折叠、可配置快捷键、模型选择器，以及更清晰的事件回流与渲染边界。
+未实现功能不会出现在当前快捷键说明中。
+
 ### 验证交互终端
 
 1. 在真实 TTY 中运行 `laohuang`。
@@ -145,8 +150,7 @@ npm test
 Bash。但 `bash` **没有操作系统级沙箱**，执行后仍能访问项目外文件、网络和其他
 系统资源。公开使用前请阅读 [安全模型](docs/security.md)。
 
-架构说明见 [docs/architecture.md](docs/architecture.md)；设计文档归档在
-[docs/superpowers/specs/](docs/superpowers/specs/)。
+架构说明见 [docs/architecture.md](docs/architecture.md)。
 
 ## License
 

package/dist/agent.d.ts

@@ -14,9 +14,10 @@
 import { CancelToken } from "./cancellation.ts";
 import { EventKind, EventSource, type EventBus } from "./events.ts";
 import { type ChatClientLike } from "./model-adapter.ts";
-import type { ToolDefinition, ToolExecutionContextLike, ToolExecutionMode, ToolResult, ToolSpec } from "./tools.ts";
+import type { ToolExecutionContextLike, ToolExecutionMode, ToolRegistryLike, ToolResult } from "./tools.ts";
 import { ProjectInstructionState } from "./project-instructions.ts";
-export declare const FORCED_FINAL_PROMPT = "Tool use has been stopped by the runtime safety guard.\nDo not call any tools. Give the user the best concise answer possible from the\ninformation already available. Clearly state any limitation caused by stopping\ntool use, but do not mention internal implementation details unless useful.";
+import { FORCED_FINAL_PROMPT, type AgentStepRunnerContext } from "./runtime/agent-step-runner.ts";
+export { FORCED_FINAL_PROMPT };
 /** Raised when the model response cannot drive the agent loop. */
 export declare class AgentError extends Error {
     constructor(message: string, options?: {
@@ -33,12 +34,7 @@ export type AgentEventCallback = (eventType: string, payload: Record<string, unk
 export type ToolEventCallback = (name: string, args: Record<string, unknown>, result: ToolResult) => void;
 export type { ChatClientLike } from "./model-adapter.ts";
 /** Structural minimum of ToolRegistry (tools.ts) the agent relies on. */
-export interface AgentToolRegistry {
-    readonly definitions: readonly ToolDefinition[];
-    readonly orderedSpecs: readonly ToolSpec[];
-    executionMode(name: string): ToolExecutionMode | undefined;
-    execute(name: string, args: Record<string, unknown>, context?: ToolExecutionContextLike): Promise<ToolResult> | ToolResult;
-}
+export type AgentToolRegistry = ToolRegistryLike;
 /** Pending user input handed over at a session safe point. */
 export interface PendingInputBatchLike {
     content?: string | undefined;
@@ -55,23 +51,12 @@ export interface AgentEventPublishOptions {
  * Every member is optional; without a context the agent runs standalone and
  * manages its own history commits and cancellation checks.
  */
-export interface AgentContext {
+export interface AgentContext extends AgentStepRunnerContext {
     readonly sessionId?: string | null;
     readonly taskId?: string | null;
     readonly cancelToken?: CancelToken | null;
     readonly eventBus?: EventBus | null;
     publish?(kind: EventKind, options: AgentEventPublishOptions): unknown;
-    /** Return false to cancel before the model request is sent. */
-    modelStarted?(): boolean | void;
-    /** Called once the SDK acknowledged the streaming request. */
-    modelRequestOpened?(): boolean | void;
-    toolsStarted?(): void;
-    safePoint?(): PendingInputBatchLike | null | undefined;
-    /** Atomically commit the user message; rollback undoes a failed commit. */
-    commitInput?(append: () => void, rollback: () => void): boolean;
-    commitPending?(batch: PendingInputBatchLike, append: () => void, rollback: () => void): boolean;
-    /** Atomically reject history commits once cancellation has won. */
-    commitIfActive?(callback: () => void): boolean;
 }
 export interface RunOptions {
     cancelToken?: CancelToken | null;
@@ -110,6 +95,8 @@ export declare class CodingAgent {
     provider: string | null;
     /** Provider-neutral model access; resolved from `provider`. */
     private adapter;
+    private modelRuntime;
+    private readonly toolRuntime;
     readonly tools: AgentToolRegistry;
     readonly maxTotalTokens: number;
     readonly maxElapsedSeconds: number;
@@ -137,12 +124,6 @@ export declare class CodingAgent {
     }): void;
     /** Run one user turn, committing only fully validated model attempts. */
     run(userInput: string, context?: AgentContext | null, options?: RunOptions): Promise<string>;
-    private budgetGuardReason;
-    private guardPayload;
-    private recordRepeatedToolCalls;
-    private executeToolBatch;
-    private executeTool;
-    private finishToolEvent;
     /**
      * Append the rendered baseline project instructions once per session,
      * right after the first direct user message and before the first model
@@ -159,7 +140,6 @@ export declare class CodingAgent {
      * instruction loading is not configured.
      */
     private discoverForTouchedPaths;
-    private commitContextMessage;
     private emit;
     private emitLegacy;
     private publishRuntimeEvent;