@hmharness/agent 0.8.0 → 0.8.2

package/dist/i18n.d.ts

@@ -74,6 +74,22 @@ export interface Strings {
     cmdResumeNone: string;
     cmdResumeNotFound: (p: string) => string;
     cmdResumeLoaded: (n: number) => string;
+    /** Codex-style resume picker (v0.8.2 transplant) */
+    pickerTitle: string;
+    pickerHint1: string;
+    pickerHint2: string;
+    pickerEmpty: string;
+    pickerNoMatch: string;
+    pickerLoading: string;
+    pickerMore: string;
+    pickerPreviewNone: string;
+    pickerLabelFilter: string;
+    pickerLabelSort: string;
+    pickerValCwd: string;
+    pickerValAll: string;
+    pickerValUpdated: string;
+    pickerValCreated: string;
+    pickerPos: (pos: number, total: number, pct: string) => string;
     tuiRadarScanning: string;
     tuiEvolveDone: (proposals: number, insights: number, notes: number) => string;
     tuiPassRate: (pct: string) => string;

package/dist/i18n.js

@@ -56,10 +56,25 @@ const zh = {
     tuiScrolled: '↑ 已上滚 · PgDn/End/滚轮 回底',
     tuiWebHint: '浏览器界面: 在另一个终端运行 hmh web --port=7788',
     updateHint: (latest) => `新版本 ${latest} 可用: npm i -g @hmharness/cli 更新`,
-    cmdResume: '恢复历史会话(/resume 打开选择器,↑↓ 选择,Enter 载入;输入 id 前缀过滤)',
+    cmdResume: '恢复历史会话(/resume 打开选择器,↑↓ 选择,Enter 载入;输入即过滤)',
     cmdResumeNone: '还没有历史会话',
     cmdResumeNotFound: (p) => `没有匹配 "${p}" 的会话`,
     cmdResumeLoaded: (n) => `已恢复会话(${n} 条消息),直接输入内容继续对话`,
+    pickerTitle: '恢复会话',
+    pickerHint1: 'Enter 恢复 · ↑↓ 浏览 · Tab 切筛选/排序 · ←→ 调整',
+    pickerHint2: 'Esc 关闭 · 输入即过滤(标题/id/目录/分支)',
+    pickerEmpty: '还没有会话',
+    pickerNoMatch: '没有匹配的会话',
+    pickerLoading: '正在加载会话…',
+    pickerMore: '↓ 加载更多…',
+    pickerPreviewNone: '(无消息)',
+    pickerLabelFilter: '筛选',
+    pickerLabelSort: '排序',
+    pickerValCwd: '当前目录',
+    pickerValAll: '全部',
+    pickerValUpdated: '最近更新',
+    pickerValCreated: '创建时间',
+    pickerPos: (pos, total, pct) => ` ${pos} / ${total} · ${pct}% `,
     tuiRadarScanning: '雷达扫描中…',
     tuiEvolveDone: (p, i, n) => `evolve 完成: ${p} 提案 · 洞察 ${i} · 记忆 ${n}`,
     tuiPassRate: (pct) => `pass rate: ${pct}`,
@@ -151,10 +166,25 @@ const en = {
     tuiScrolled: '↑ scrolled up · PgDn/End/wheel back to bottom',
     tuiWebHint: 'web UI: run hmh web --port=7788 in another terminal',
     updateHint: (latest) => `version ${latest} available - update with: npm i -g @hmharness/cli`,
-    cmdResume: 'resume a past session (/resume opens the picker; arrows + Enter, type an id prefix to filter)',
+    cmdResume: 'resume a past session (/resume opens the picker; arrows + Enter, type to filter)',
     cmdResumeNone: 'no past sessions yet',
     cmdResumeNotFound: (p) => `no session matches "${p}"`,
     cmdResumeLoaded: (n) => `session resumed (${n} messages) - just type to continue`,
+    pickerTitle: 'Resume session',
+    pickerHint1: 'Enter resume · ↑↓ browse · Tab filter/sort · ←→ change',
+    pickerHint2: 'Esc close · type to filter (title/id/dir/branch)',
+    pickerEmpty: 'no sessions yet',
+    pickerNoMatch: 'no results for your search',
+    pickerLoading: 'Loading sessions…',
+    pickerMore: '↓ loading more…',
+    pickerPreviewNone: '(no message yet)',
+    pickerLabelFilter: 'Filter',
+    pickerLabelSort: 'Sort',
+    pickerValCwd: 'Cwd',
+    pickerValAll: 'All',
+    pickerValUpdated: 'Updated',
+    pickerValCreated: 'Created',
+    pickerPos: (pos, total, pct) => ` ${pos} / ${total} · ${pct}% `,
     tuiRadarScanning: 'scanning radar…',
     tuiEvolveDone: (p, i, n) => `evolve done: ${p} proposals · ${i} insights · ${n} notes`,
     tuiPassRate: (pct) => `pass rate: ${pct}`,

package/dist/roles.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @hmharness/agent - team roles (V2 blueprint M7).
+ *
+ * spawn_agent already accepts a free-text role label with a success-rate
+ * leaderboard; this adds the canonical engineering-team CHARTERS. When a
+ * spawn names a canonical role, the child's system prompt carries that
+ * role's discipline text (what it always does / never does), turning
+ * "role: a word" into "role: a contract".
+ */
+export interface TeamRole {
+    name: string;
+    charter: string;
+    /** typical delegation phrasing hints, for docs only */
+    goodFor: string;
+}
+export declare const TEAM_ROLES: Record<string, TeamRole>;
+/** Resolve a role label to its charter (canonical names only); '' when free-form. */
+export declare function roleCharter(role: string): string;
+/** The known-role list for tool descriptions. */
+export declare const TEAM_ROLE_NAMES: string[];

package/dist/roles.js

@@ -0,0 +1,39 @@
+export const TEAM_ROLES = {
+    planner: {
+        name: 'planner',
+        charter: 'PLANNER duty: decompose the goal into ordered, verifiable steps. Output a numbered plan where every step names its verification (command/check). Never execute the steps yourself - plan only. Flag risks and unknowns explicitly.',
+        goodFor: 'task decomposition before implementation',
+    },
+    coder: {
+        name: 'coder',
+        charter: 'CODER duty: implement exactly the agreed step. Prefer surgical edits (edit_file) inside the workspace. Keep changes minimal and consistent with surrounding code. Run the cheapest verification that proves the change (build/lint/test) before answering.',
+        goodFor: 'focused implementation steps',
+    },
+    tester: {
+        name: 'tester',
+        charter: 'TESTER duty: try to BREAK the thing under test. Probe edge cases, empty inputs, wrong types, boundary values. Report each probe as input -> actual vs expected. A run with zero failures must say what WAS covered, never "all good".',
+        goodFor: 'adversarial verification',
+    },
+    reviewer: {
+        name: 'reviewer',
+        charter: 'REVIEWER duty: findings first, ordered by severity, each with file:line evidence. Prioritize bugs, regressions, and missing tests over style. No fixes - report only. If nothing significant, say so explicitly rather than inventing nits.',
+        goodFor: 'code review passes',
+    },
+    judge: {
+        name: 'judge',
+        charter: 'JUDGE duty: verdict from EVIDENCE, not from the executor\'s self-report. Cite what you actually observed (command outputs, file contents). Hard evidence (exit codes, tests) outranks your opinion; label opinion as opinion. End with VERDICT: PASS or VERDICT: FAIL plus one line why.',
+        goodFor: 'independent evaluation of a finished step',
+    },
+    repairer: {
+        name: 'repairer',
+        charter: 'REPAIRER duty: reproduce the failure first, state the root cause in one sentence, then apply the smallest fix that removes it, then re-run the reproduction to prove it is gone. Report before/after outputs.',
+        goodFor: 'fixing broken builds/tests',
+    },
+};
+/** Resolve a role label to its charter (canonical names only); '' when free-form. */
+export function roleCharter(role) {
+    const r = TEAM_ROLES[String(role ?? '').trim().toLowerCase()];
+    return r ? r.charter : '';
+}
+/** The known-role list for tool descriptions. */
+export const TEAM_ROLE_NAMES = Object.keys(TEAM_ROLES);

package/dist/runner.d.ts

@@ -93,6 +93,9 @@ export interface AgentTaskOptions {
     /** Overrides the terminal gate (web supplies a remote one). */
     approvalAsk?: LoopApproval['ask'];
     resumeMessages?: ChatMessage[];
+    /** Continue THIS session's rollout (append) instead of starting a new one -
+     *  codex Resume semantics: one thread, one JSONL, appended across turns. */
+    sessionId?: string;
     events?: RunnerEvents;
     /** AbortSignal: cancels the agent loop at the next turn boundary. */
     signal?: AbortSignal;

package/dist/runner.js

@@ -229,7 +229,10 @@ export async function runAgentTask(opts) {
     const cfg = opts.cfg ?? (await loadConfig());
     const ctx = opts.ctx ?? { cwd: process.cwd(), home: homeDir() };
     const events = opts.events ?? {};
-    const session = new Session(ctx.home, ctx.cwd, cfg.provider.model);
+    // 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);
     // 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.

package/dist/spawn.js

@@ -16,6 +16,7 @@
 import { appendFile, mkdir, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { runLoop } from '@hmharness/kernel';
+import { roleCharter } from "./roles.js";
 export const MAX_SPAWN_DEPTH = 2;
 export async function recordRole(home, role, ok) {
     try {
@@ -62,7 +63,7 @@ export function makeSpawnTool(deps) {
             type: 'object',
             properties: {
                 task: { type: 'string', description: 'complete, self-contained instructions for the sub-agent' },
-                role: { type: 'string', description: 'optional label for this delegation, e.g. "explorer", "reviewer", "build-fixer" - roles accumulate success rates you will see next time' },
+                role: { type: 'string', description: 'optional role label; canonical roles carry a duty charter: planner / coder / tester / reviewer / judge / repairer (plus any custom label - roles accumulate success rates you will see next time)' },
                 max_turns: { type: 'number', description: 'turn budget for the sub-agent (default 8, max 12)' },
             },
             required: ['task'],
@@ -92,7 +93,7 @@ export function makeSpawnTool(deps) {
             }
             const system = [
                 `You are a hmh sub-agent (depth ${childDepth}${role ? `, role: ${role}` : ''}). You have no conversation history beyond this task.`,
-                role ? `Perform the ${role} duty with that specialty's discipline.` : '',
+                role ? roleCharter(role) || `Perform the ${role} duty with that specialty's discipline.` : '',
                 'Do exactly what the task asks, use tools as needed, verify before answering, and reply with a concise result (the caller only sees your final answer).',
             ].filter(Boolean).join('\n');
             base.onLine?.(`[${tag}] start: ${task.slice(0, 80)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/agent",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "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",
@@ -15,9 +15,9 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@hmharness/kernel": "0.8.0",
+    "@hmharness/kernel": "0.8.2",
     "@hmharness/observability": "0.7.0",
-    "@hmharness/evolution": "0.8.0",
+    "@hmharness/evolution": "0.8.3",
     "@hmharness/domain-harmony": "0.8.0",
     "@hmharness/domain-ops": "0.8.0"
   },