@hmharness/agent 0.14.7 → 0.14.9

package/dist/i18n.d.ts

@@ -56,6 +56,34 @@ export interface Strings {
     thought: string;
     /** busy spinner text, shown in the input-box status line (TUI) */
     tuiRunning: string;
+    /** M2: Ctrl+T full-transcript overlay title (B5) */
+    tuiTranscript: string;
+    /** M2: Ctrl+R history-search modal (B4) */
+    histSearchTitle: string;
+    histSearchNone: string;
+    histSearchHint: string;
+    /** M2: @-file palette hint (B2) */
+    atPalHint: string;
+    /** M2: transcript-overlay / pager footer hint (B5/B9) */
+    overlayHint: string;
+    /** M2: Esc-Esc fork-edit armed hint (T13) */
+    forkArmed: string;
+    cmdCompact: string;
+    cmdDiff: string;
+    cmdNew: string;
+    cmdNewDone: string;
+    cmdFork: string;
+    cmdCopy: string;
+    cmdCopied: string;
+    cmdPlan: string;
+    cmdPlanOn: string;
+    cmdPlanOff: string;
+    cmdGoal: string;
+    cmdGoalCleared: string;
+    cmdUsage: string;
+    cmdStatusline: string;
+    cmdKeymap: string;
+    cmdReview: string;
     cmdModelHint: string;
     /** palette footer key hint: how to drive the slash/model picker (TUI) */
     panelHint: string;
@@ -74,6 +102,10 @@ export interface Strings {
     cmdResumeNone: string;
     cmdResumeNotFound: (p: string) => string;
     cmdResumeLoaded: (n: number) => string;
+    /** banner shown when /resume actually loads a transcript into the TUI */
+    cmdResuming: (id: string, total: number, hidden: number) => string;
+    /** why tools-required cases are skipped inside /evolve (TUI runs a lite loop) */
+    cmdEvolveHint: string;
     /** Codex-style resume picker (v0.8.2 transplant) */
     pickerTitle: string;
     pickerHint1: string;

package/dist/i18n.js

@@ -40,11 +40,34 @@ const zh = {
     tuiApprove: '批准',
     tuiDeny: '拒绝',
     tuiApprovalHint: 'enter/y 批准 · esc/n 拒绝',
-    tuiHints: 'enter 发送 · 滚轮/↑↓ 翻页 · ^P/^N 历史 · esc 清空 · 拖选复制 · ^C 退出 · /help',
-    tuiBusyHints: (queued) => `运行中 · 空行回车=停止 · 新输入=排队(${queued}) · esc 清空 · /help`,
+    tuiHints: 'enter 发送 · Esc 中断/清空 · Ctrl+Enter 注入 · Ctrl+R 历史搜索 · Ctrl+T 转录 · ^P/^N 历史 · esc 清空 · ^C 退出 · /help',
+    tuiBusyHints: (queued) => `运行中 · Esc=停止 · 输入=排队(${queued}) · Ctrl+Enter=注入 · /help`,
     thinking: '思考中',
     thought: '已完成思考',
     tuiRunning: '运行中…',
+    tuiTranscript: '完整转录(含工具输出)',
+    histSearchTitle: '历史搜索',
+    histSearchNone: '(无匹配)',
+    histSearchHint: '↑↓ 选择 · Enter 采用 · Esc 取消',
+    atPalHint: '↑↓ 选择 · Enter 插入路径 · Esc 取消',
+    overlayHint: '↑↓/PgUp/PgDn 滚动 · g/G 首尾 · q/Esc 返回',
+    forkArmed: '再按 Esc:编辑上一条并 fork',
+    cmdCompact: '压缩上下文并报告释放量',
+    cmdDiff: '工作区 git diff(含未跟踪文件)的 pager 查看',
+    cmdNew: '新会话(清转录,开新 rollout)',
+    cmdNewDone: '✓ 新会话开始(旧转录可用 Ctrl+T 回看)',
+    cmdFork: 'fork 当前会话为新线程(继承全部上下文)',
+    cmdCopy: '复制最后一条 AI 输出到剪贴板',
+    cmdCopied: '✓ 已复制最后一条 AI 输出',
+    cmdPlan: '计划模式开关(先出计划待确认再执行)',
+    cmdPlanOn: '🔥 计划模式:先出计划,确认后才执行',
+    cmdPlanOff: '计划模式关闭',
+    cmdGoal: '设置/查看/清除会话目标(/goal <text>|clear)',
+    cmdGoalCleared: '目标已清除',
+    cmdUsage: '本次会话 token 用量与上下文占用',
+    cmdStatusline: '自定义底栏字段(/statusline "{model} · {cwd}")',
+    cmdKeymap: '查看/重映射动作键(/keymap <action>=<key>)',
+    cmdReview: '一键发起「审查当前工作树」任务',
     cmdModelHint: '切换 chat 路由: /model <name>',
     panelHint: '↑↓/滚轮/点击 选择 · Enter 确认 · Esc 关闭',
     cmdModelPreset: (name, envVar) => `${name} 尚未配置 — 设置 ${envVar} 后运行 /providers scan 添加`,
@@ -60,6 +83,9 @@ const zh = {
     cmdResumeNone: '还没有历史会话',
     cmdResumeNotFound: (p) => `没有匹配 "${p}" 的会话`,
     cmdResumeLoaded: (n) => `已恢复会话(${n} 条消息),直接输入内容继续对话`,
+    cmdResuming: (id, total, hidden) => '--- 已恢复会话 ' + id + ' · ' + total + ' 条消息'
+        + (hidden > 0 ? '(前 ' + hidden + ' 条保留在上下文中,未显示)' : '') + ' ---',
+    cmdEvolveHint: '(TUI 内跳过;运行 hmh evolve 执行完整循环)',
     pickerTitle: '恢复会话',
     pickerHint1: 'Enter 恢复 · ↑↓ 浏览 · Tab 切筛选/排序 · ←→ 调整',
     pickerHint2: 'Esc 关闭 · 输入即过滤(标题/id/目录/分支)',
@@ -150,11 +176,34 @@ const en = {
     tuiApprove: 'Approve',
     tuiDeny: 'Deny',
     tuiApprovalHint: 'enter/y approve · esc/n deny',
-    tuiHints: 'enter send · wheel/arrows scroll · ^P/^N history · esc clear · drag to copy · ^C quit · /help',
-    tuiBusyHints: (queued) => `running · Enter on empty line = stop · typing queues (${queued}) · esc clear · /help`,
+    tuiHints: 'enter send · Esc interrupt/clear · Ctrl+Enter inject · Ctrl+R history · Ctrl+T transcript · ^P/^N history · esc clear · ^C quit · /help',
+    tuiBusyHints: (queued) => `running · Esc=stop · typing queues (${queued}) · Ctrl+Enter=inject · /help`,
     thinking: 'thinking',
     thought: 'thought (done)',
     tuiRunning: 'running…',
+    tuiTranscript: 'full transcript (incl. tool outputs)',
+    histSearchTitle: 'history search',
+    histSearchNone: '(no match)',
+    histSearchHint: '↑↓ select · Enter adopt · Esc close',
+    atPalHint: '↑↓ select · Enter insert path · Esc close',
+    overlayHint: '↑↓/PgUp/PgDn scroll · g/G top/bottom · q/Esc back',
+    forkArmed: 'Esc again: edit last message and fork',
+    cmdCompact: 'compact the context and report freed space',
+    cmdDiff: 'pager-view the worktree git diff (incl. untracked)',
+    cmdNew: 'new session (clear transcript, fresh rollout)',
+    cmdNewDone: '✓ new session (old transcript: Ctrl+T to replay)',
+    cmdFork: 'fork this session to a new thread (inherits full context)',
+    cmdCopy: 'copy the last AI output to the clipboard',
+    cmdCopied: '✓ copied the last AI output',
+    cmdPlan: 'plan mode toggle (plan first, confirm, then execute)',
+    cmdPlanOn: '🔥 plan mode: present a plan, wait for confirmation before executing',
+    cmdPlanOff: 'plan mode off',
+    cmdGoal: 'set/view/clear the session goal (/goal <text>|clear)',
+    cmdGoalCleared: 'goal cleared',
+    cmdUsage: 'session token usage and context occupancy',
+    cmdStatusline: 'custom bottom-line fields (/statusline "{model} · {cwd}")',
+    cmdKeymap: 'view/remap action keys (/keymap <action>=<key>)',
+    cmdReview: 'one-click "review the current worktree" task',
     cmdModelHint: 'switch chat route: /model <name>',
     panelHint: '↑↓ / wheel / click to select · Enter confirms · Esc closes',
     cmdModelPreset: (name, envVar) => `${name} not configured - set ${envVar}, then run /providers scan`,
@@ -170,6 +219,9 @@ const en = {
     cmdResumeNone: 'no past sessions yet',
     cmdResumeNotFound: (p) => `no session matches "${p}"`,
     cmdResumeLoaded: (n) => `session resumed (${n} messages) - just type to continue`,
+    cmdResuming: (id, total, hidden) => '--- resumed ' + id + ' · ' + total + ' messages'
+        + (hidden > 0 ? ' (' + hidden + ' earlier kept in context, not shown)' : '') + ' ---',
+    cmdEvolveHint: '(skipped in tui; run hmh evolve)',
     pickerTitle: 'Resume session',
     pickerHint1: 'Enter resume · ↑↓ browse · Tab filter/sort · ←→ change',
     pickerHint2: 'Esc close · type to filter (title/id/dir/branch)',

package/dist/prompt.d.ts

@@ -7,4 +7,5 @@ export declare function buildSystemPrompt(opts: {
     model: string;
     locale?: string;
     agentsMd?: string;
+    goal?: string;
 }): string;

package/dist/prompt.js

@@ -14,7 +14,12 @@ export function buildSystemPrompt(opts) {
     // ---- [DeepSeek] 分段执行 + 合理质疑 ----
     '', 'For tasks requiring reasoning across multiple steps, work in phases: search and list the key facts, plan the concrete steps, then execute. Do not skip planning to act directly.', 'If the user\'s requested approach carries risk or there is a clearly better alternative, raise it proactively - state the tradeoffs and let the user choose. Only execute confirmed plans.', 
     // ---- [Codex] 用户反馈 ----
-    '', "When the user gives feedback saying something didn't work, treat it as ground truth. Use available tools to verify the current state, identify the root cause, fix it, and explain what changed.", 
+    '', "When the user gives feedback saying something didn't work, treat it as ground truth. Use available tools to verify the current state, identify the root cause, fix it, and explain what changed.");
+    // ---- 会话目标 ----
+    if (opts.goal) {
+        parts.push('', '## Active goal', 'Work toward this goal across turns until it is complete or explicitly cleared:', opts.goal);
+    }
+    parts.push(
     // ---- 宿主环境 ----
     '', '## Host environment (facts - rely on these, do not guess)', `- OS: ${process.platform} (${process.arch}). The run_command tool executes through ${isWin ? 'cmd.exe (Windows cmd - NOT bash, NOT PowerShell)' : '/bin/sh'}.`, isWin
         ? '- cmd.exe has NO grep/head/tail/ls/cat/$(...) and wmic may be absent. Use: findstr (search), "more" or node -e (head/text ops), dir /b (ls), type (cat), where (which). For anything richer: powershell -NoProfile -Command "..."'

package/dist/runner.d.ts

@@ -73,6 +73,8 @@ export interface RunnerEvents {
     onToolCall?(name: string, args: Record<string, unknown>): void;
     onToolResult?(name: string, output: string, isError: boolean): void;
     onApproval?(name: string, args: Record<string, unknown>, granted: boolean): void;
+    /** A runtime-steering user message entered the running loop's transcript. */
+    onInjected?(message: string): void;
     onFinal?(r: {
         text: string;
         turns: number;
@@ -84,6 +86,22 @@ export interface RunnerEvents {
         };
     }): void;
 }
+/** Live runtime-steering channel (web Ctrl+Enter / TUI Enter-while-running):
+ *  the caller pushes user messages into `queue`; the running loop drains them
+ *  between tool batches. `active` flips to false when the task ends, so the
+ *  caller can route a late push into the next task's queue instead. */
+export interface InjectChannel {
+    queue: string[];
+    active: boolean;
+}
+/** Poll-shaped runtime steering (codex Enter-inject semantics): poll() is
+ *  drained at every turn boundary; each returned entry becomes a user turn
+ *  in the running loop. */
+export interface InjectPoll {
+    poll(): Array<{
+        text: string;
+    }>;
+}
 export interface AgentTaskOptions {
     task: string;
     registry: Registry;
@@ -99,6 +117,17 @@ export interface AgentTaskOptions {
     events?: RunnerEvents;
     /** AbortSignal: cancels the agent loop at the next turn boundary. */
     signal?: AbortSignal;
+    /** Runtime-steering channel (web Ctrl+Enter / TUI Enter-while-running):
+     *  either the push queue (InjectChannel, drained between tool batches) or
+     *  the poll shape (drained at every turn boundary). */
+    inject?: InjectChannel | InjectPoll;
+    /** Fork this run from an existing session: the new rollout records the
+     *  parent session id as `forkedFrom` in its session_meta. */
+    forkFrom?: string;
+    /** Session goal: injected into the system prompt and persisted under
+     *  HMH_HOME/goals.json (when unset or null, the persisted goal for the
+     *  session is used, so the goal survives resumes/forks). */
+    goal?: string | null;
 }
 /** Run one full agent task end-to-end; audit + insight recording included. */
 export declare function runAgentTask(opts: AgentTaskOptions): Promise<LoopResult & {

package/dist/runner.js

@@ -5,7 +5,7 @@
  * Also owns the native registry factory (spawn_agent recursion) and the
  * approval gate construction.
  */
-import { homeDir, loadConfig, resolveProvider, mcpServerTools, Registry, runLoop, Session, } from '@hmharness/kernel';
+import { homeDir, loadConfig, resolveProvider, getGoal, mcpServerTools, Registry, runLoop, Session, } from '@hmharness/kernel';
 import { brief, createTrajectoryRecorder } from '@hmharness/observability';
 import { readFile } from 'node:fs/promises';
 import { readFileSync, writeFileSync } from 'node:fs';
@@ -230,10 +230,18 @@ export async function runAgentTask(opts) {
     const cfg = opts.cfg ?? (await loadConfig());
     const ctx = opts.ctx ?? { cwd: process.cwd(), home: homeDir() };
     const events = opts.events ?? {};
+    // inject accepts either the push channel (legacy) or the poll shape
+    const injectChannel = opts.inject && 'queue' in opts.inject ? opts.inject : undefined;
+    const injectPoll = opts.inject && 'poll' in opts.inject ? opts.inject : undefined;
+    if (injectChannel)
+        injectChannel.active = true; // channel is live for this task
     // resume = append to the same rollout; a missing/unreadable id falls back
     // to a fresh session so a renamed-away file never breaks the conversation
     const session = (opts.sessionId ? await Session.resume(ctx.home, opts.sessionId) : null)
-        ?? Session.create(ctx.home, ctx.cwd, cfg.provider.model);
+        ?? Session.create(ctx.home, ctx.cwd, cfg.provider.model, opts.forkFrom ? { forkedFrom: opts.forkFrom } : {});
+    // session-level goal: explicit opts.goal wins; otherwise the persisted
+    // goal (HMH_HOME/goals.json) carries over into resumed/forked sessions
+    const goal = opts.goal ?? (await getGoal(ctx.home, session.id));
     // V2 M1 flight recorder: every run leaves a typed, replayable trajectory
     // under <home>/runs/<run-id>/. Best-effort by contract - storage failures
     // are swallowed inside the recorder and can never fail the task itself.
@@ -280,6 +288,7 @@ export async function runAgentTask(opts) {
         model: cfg.provider.model,
         locale: cfg.locale,
         agentsMd: agentsMd ?? undefined,
+        ...(goal ? { goal } : {}),
     });
     // system prompt token count: the prompt has been quietly growing (Codex 9
     // instructions + AGENTS.md + memory + skills + insights) while no cost gate
@@ -339,9 +348,22 @@ export async function runAgentTask(opts) {
         maxTurns: cfg.maxTurns,
         maxContextChars: cfg.maxContextChars,
         summarizeContext,
+        // runtime steering: drain the caller's injection channel after each tool
+        // batch; the injected text lands as a user message in the live transcript
+        // (web Ctrl+Enter / TUI Enter-while-running)
+        injectQueue: injectChannel ? () => injectChannel.queue.length ? injectChannel.queue.shift() : null : undefined,
+        // poll-shaped steering: drained at every turn boundary (codex semantics)
+        injections: injectPoll,
         approval: spawnBase.current.approval,
         events: {
             onDelta: (kind, chunk) => events.onDelta?.(kind, chunk),
+            onInjected: (message) => {
+                // keep the rollout complete: an injected user message is part of the
+                // session transcript, not just the working copy
+                void session.user(message);
+                traj.emit('user.injected', 'user', { preview: brief(message, 160) });
+                events.onInjected?.(message);
+            },
             onToolCall: (name, args) => {
                 toolsUsed.push(name);
                 traj.emit('tool.requested', 'tool', { name, args: brief(args, 120) });
@@ -375,6 +397,10 @@ export async function runAgentTask(opts) {
         traj.finish({ success: false, reason: 'error', error: brief(String(err), 200) }, { toolUses: toolsUsed.length });
         throw err;
     });
+    // the task ended (or died): late pushes must queue for the NEXT task instead
+    // of silently vanishing into a channel nothing drains
+    if (injectChannel)
+        injectChannel.active = false;
     traj.finish({ success: result.reason === 'final', reason: result.reason }, { turns: result.turns, toolUses: result.toolUses, promptTokens: result.usage.promptTokens, completionTokens: result.usage.completionTokens });
     // routing.outcome backfill: did the ACTUAL route succeed? (shadow stats)
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/agent",
-  "version": "0.14.7",
+  "version": "0.14.9",
   "description": "hmharness agent execution layer: base tools, system prompt, sub-agent spawn, and the shared task runner that frontends (cli, web) drive.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,8 +17,8 @@
   "dependencies": {
     "@hmharness/domain-harmony": "0.13.5",
     "@hmharness/domain-ops": "0.8.0",
-    "@hmharness/evolution": "0.14.7",
-    "@hmharness/kernel": "0.9.0",
+    "@hmharness/evolution": "0.14.9",
+    "@hmharness/kernel": "0.9.1",
     "@hmharness/observability": "0.7.0",
     "@hmharness/sandbox": "0.8.0"
   },