hob-bot 1.0.3 → 1.1.0

package/shared/types.ts

@@ -126,6 +126,28 @@ export interface ModelThinkingView {
   custom: boolean; // 存过自定义档位（可以恢复默认）
 }
 
+export interface ClaudeCodeSettings {
+  enabled: boolean;
+  plan: "pro" | "max";
+  executable: string;
+}
+
+export interface ClaudeCodeView {
+  settings: SettingsFile;
+  status: ClaudeCodeStatus;
+}
+
+/** 本机 Claude Code 状态，不包含凭据或程序原始输出。 */
+export interface ClaudeCodeStatus {
+  found: boolean;
+  executable?: string;
+  version?: string;
+  loggedIn: boolean;
+  email?: string;
+  plan?: string;
+  error?: string;
+}
+
 /** GET /api/providers：已配的服务商、引擎自带的服务商目录、跟着一起回的整份设置（前端要新 revision）。 */
 export interface ProvidersView {
   providers: ProviderView[];
@@ -214,6 +236,8 @@ export interface Assistant {
   };
   /** 派出去的活能用的能力；缺省全开（读总是有） */
   abilities?: { exec: boolean; write: boolean; image: boolean };
+  /** 知识库二期：绑定的用户知识库 id。缺省 = 没绑定：不自动查，也没有 search_knowledge */
+  knowledge?: string[];
   createdAt: Iso;
   splitFrom?: { from: string; at: Iso; conversations: number };
 }
@@ -245,6 +269,9 @@ export interface RoutineRun {
   jobId: string;
   at: Iso;
   status: JobStatus;
+  durationMs?: number; // 技能二期：这次用时
+  tools?: number; // 技能二期：工具调用次数
+  tokens?: number; // 技能二期：输入加输出 token
 }
 
 export interface Routine {
@@ -256,6 +283,7 @@ export interface Routine {
   active: boolean;
   createdAt: Iso;
   runs: RoutineRun[]; // 最近 20 次，新的在前
+  skill?: string; // 绑定这个助手自己的技能（AssistantSkill.name）：每次执行按它做
 }
 
 export interface Delegation {
@@ -264,7 +292,7 @@ export interface Delegation {
   to: string;
   text: string;
   createdAt: Iso;
-  status: "running" | "waiting" | "done" | "stuck" | "interrupted" | "returned";
+  status: "running" | "waiting" | "done" | "stuck" | "interrupted" | "returned" | "takenOver";
   jobIds: string[];
   reply?: string;
   returnedText?: string; // 退回时补充的用户要求
@@ -323,6 +351,8 @@ export interface JobStep {
   durationMs?: number;
   /** tool：还在跑 */
   running?: boolean;
+  /** 你补的那句已经交给任务，但任务还在做当前这一步，做完才会读到 */
+  queued?: boolean;
 }
 
 /** GET /api/jobs/:id/transcript */
@@ -340,7 +370,7 @@ export interface JobsPage {
 export interface Job {
   id: string; // "t-" + 4 位以上
   assistantId: string;
-  assistantName?: string; // 建任务时的助手名：助手并回 Hob 后，任务详情里照样显示
+  assistantName?: string; // 建任务时的助手名：助手归档后，任务详情里照样显示
   title: string; // 如 "查页面卡顿"
   instruction: string;
   status: JobStatus;
@@ -351,7 +381,7 @@ export interface Job {
   usage?: JobUsage; // 输入/输出 token 和花费
   durationMs?: number; // 用时（结束时间 − 开始时间）
   stats: { reads: number; commands: number; edits: number };
-  summary?: string; // report 的摘要（≤600 字）
+  summary?: string; // report 的完整结果
   reportPath?: string; // 完整报告
   files?: string[]; // 产出文件（绝对路径）
   cwd?: string; // 工作目录（缺省为 HOB_HOME/jobs/<id>/work）
@@ -360,10 +390,26 @@ export interface Job {
   modelReason?: string; // 换了模型的原因，如「需要看图，换成了 X」
   inputs?: string[]; // 交给任务的附件（绝对路径）
   routineId?: string; // 由定时触发
+  skillsUsed?: string[]; // 这次读过的本助手技能（AssistantSkill.name）
   delegationId?: string; // 转交回合创建的任务
+  /** 续做前每一轮结束时的样子（第 0 轮起）。对话里前面几张任务卡照它显示，最后一张跟着任务实时变 */
+  rounds?: JobRound[];
   activity: ActivityLine[]; // 最近 200 行
 }
 
+export interface JobRound {
+  summary?: string;
+  files?: string[];
+  usage?: JobUsage;
+  reportPath?: string;
+  followUp?: string;
+  status: JobStatus;
+  statusReason?: string;
+  startedAt?: Iso;
+  endedAt?: Iso;
+  durationMs?: number;
+}
+
 export interface ApprovalOption {
   key: "A" | "B" | "C";
   label: string; // 如 "以后同类内容直接发布，无需确认"
@@ -406,16 +452,17 @@ export interface Draft {
   createdAt: Iso;
 }
 
-export type NoteIcon = "memory" | "rule" | "routine" | "split" | "info";
+export type NoteIcon = "memory" | "rule" | "routine" | "split" | "info" | "skill";
 
 export type Item = (
   | { kind: "user"; id: string; at: Iso; text: string; quote?: { itemId: string; text: string }; files?: string[]; from?: { assistantId: string; name: string; delegationId: string } }
-  | { kind: "assistant"; id: string; at: Iso; text: string; streaming?: boolean; routine?: { id: string; name: string } }
-  | { kind: "note"; id: string; at: Iso; icon: NoteIcon; text: string; handbackId?: string } // 居中灰色一行，如 "记忆已更新 · 不看融资新闻"
+  | { kind: "assistant"; id: string; at: Iso; text: string; streaming?: boolean; routine?: { id: string; name: string; jobId?: string } }
+  | { kind: "note"; id: string; at: Iso; icon: NoteIcon; text: string; handbackId?: string; path?: string } // path：点了预览这个文件（如技能的 SKILL.md） // 居中灰色一行，如 "记忆已更新 · 不看融资新闻"
   | { kind: "question"; id: string; at: Iso; approvalId: string }
-  | { kind: "job"; id: string; at: Iso; jobId: string }
+  | { kind: "job"; id: string; at: Iso; jobId: string; round?: number } // 第几轮（续做一次 +1），缺省是第 0 轮
   | { kind: "delegation"; id: string; at: Iso; delegationId: string }
   | { kind: "draft"; id: string; at: Iso; draftId: string }
+  | { kind: "image"; id: string; at: Iso; prompt: string; size?: string; startedAt: Iso; status: "pending" | "done" | "failed"; path?: string; error?: string }
   | { kind: "file"; id: string; at: Iso; path: string; name: string; meta?: string } // meta 如 "3200 字 · 4 张图"
 ) & {
   /** 这条开启新的一组，前端在它上面拉开间距：事件触发的新一轮回复，或任务直接发进对话的图片、提问卡 */
@@ -466,6 +513,7 @@ export interface MemoryConfig {
   provider: MemoryProvider;
   providerExplicit: boolean; // 用户在设置里明确选过（没选过就是按有没有配好 Lore 推出的）
   lore: LoreConnectionInfo;
+  lorePlugin: string; // Hob 自带的 Lore 插件版本（Lore 正式版的版本号）
 }
 
 /** POST /api/memory/lore-test：测试失败也是 200，原因在这里。 */
@@ -506,13 +554,47 @@ export interface Settings {
   models: ModelSettings;
   image: ImageSettings;
   search: SearchSettings;
+  /** 云桌面令牌保存在 secrets.json，不包含在设置中。 */
+  desktop?: { url: string; enabled: boolean; publicAssistants?: string[] };
+  claude?: ClaudeCodeSettings;
   /** 停用的技能，键为来源和技能名。 */
   skills?: { disabled: string[] };
   work: WorkSettings;
   push: PushSettings;
+  /** 知识库二期：向量模型（Key 在 secrets.json 的 embedding）；缺省 = 关闭，只按关键词查 */
+  knowledge?: { embedding: EmbeddingSettings };
 }
 
+/** 设置 → 知识库：向量模型，照图像生成的做法（兼容接口的地址 + 模型，Key 单独存）。 */
+export type EmbeddingSettings = { source: "off" } | { source: "openai"; baseUrl: string; model: string };
+
+/** GET /api/knowledge/embedding：Key 配没配（永不回显）。 */
+export interface EmbeddingKeyView {
+  keyConfigured: boolean;
+}
+
+/** PUT /api/knowledge/embedding 的返回：整份设置和 Key 状态。 */
+export interface EmbeddingSettingsSaved {
+  settings: SettingsFile;
+  keyConfigured: boolean;
+}
+
+/** POST /api/knowledge/embedding/test：失败也是 200，原因在这里。 */
+export type EmbeddingTestResult = { ok: true; dims: number } | { ok: false; error: string };
+
 /** HOB_HOME/settings.json：界面可改的设置，写入走 revision 比对（CAS）。 */
+export interface DesktopView {
+  revision: number;
+  url: string;
+  enabled: boolean;
+  deployed: boolean;
+  tokenConfigured: boolean;
+  publicAssistants: string[];
+}
+
+export interface DesktopScreen { id: string; running: boolean; browserRunning: boolean; viewers: number; lastActiveAt: string | null }
+export type DesktopTestResult = { ok: true; health: { version: string; display: { width: number; height: number }; screens: DesktopScreen[] } } | { ok: false; error: string };
+
 export interface SettingsFile {
   revision: number;
   settings: Settings;
@@ -581,20 +663,18 @@ export interface FileMeta {
   page?: boolean; // 展示页面目录中的渲染产物
 }
 
-/** GET /api/jobs/:id/files：任务工作目录里的一个文件。 */
-export interface JobFileEntry {
-  path: string; // 绝对路径
-  rel: string; // 相对任务工作目录，如 "src/index.ts"
-  name: string;
-  size: number;
-  modifiedAt: Iso;
-  kind: FileKind;
-}
+/** 工作目录中的一项，目录的 count 是其下一层可见项数。 */
+export type JobFileEntry = { path: string; rel: string; name: string } & (
+  | { type: "file"; size: number; modifiedAt: Iso; kind: FileKind }
+  | { type: "directory"; count: number }
+);
 
-/** GET /api/jobs/:id/files：任务工作目录（HOB_HOME/jobs/<id>/work）里的文件，最多 200 个。 */
+/** 一层最多返回 200 项，total 为截断前的总数。 */
 export interface JobFilesView {
-  files: JobFileEntry[]; // 修改时间倒序
-  hasMore: boolean;
+  files: JobFileEntry[];
+  total: number;
+  fileCount: number;
+  directoryCount: number;
 }
 
 export interface Bootstrap {
@@ -607,12 +687,15 @@ export interface Bootstrap {
 }
 
 export type HobEvent =
+  | { type: "desktop-control"; screen: string; taken: boolean }
+  | { type: "desktop-screens"; screens: DesktopScreen[] }
   | ({ type: "page-live" } & PageLive)
   | { type: "assistant"; assistant: AssistantSummary } // 新建或变化
   | { type: "assistant_removed"; id: string }
   | { type: "item"; assistantId: string; item: Item } // 新条目，或按 id 替换
   | { type: "delta"; assistantId: string; itemId: string; text: string } // 流式追加到 assistant 条目
   | { type: "job"; job: Job }
+  | { type: "sediment-finished"; jobId: string }
   | { type: "delegation"; delegation: Delegation }
   | { type: "job_step"; jobId: string; step: JobStep } // 新的一步，或按 id 替换（输出流式更新、跑完补结果）
   | { type: "router-activity"; assistantId: string; activity: RouterActivity | null }
@@ -621,7 +704,9 @@ export type HobEvent =
   | { type: "draft"; draft: Draft }
   | { type: "routine"; routine: Routine }
   | { type: "routine_removed"; id: string }
-  | { type: "profile"; assistantId: string }; // rules/memories/worklog 变了，前端重拉 profile
+  | { type: "profile"; assistantId: string } // rules/memories/worklog 变了，前端重拉 profile
+  | { type: "knowledge" } // 知识库有变化，打开着的知识库页面重拉
+  | { type: "skills"; assistantId: string }; // 这个助手的技能有变化，打开着的技能列表重拉
 
 /** POST /api/assistants/:id/messages 的请求体 */
 export interface SendMessageBody {

package/vendor/claude-bridge/HOB-PATCH.md

@@ -0,0 +1,10 @@
+# Hob 补丁
+
+来源：`pi-claude-bridge@0.9.3`，MIT，原许可证见 `LICENSE`。
+
+- 只读取 Hob 引擎目录的 `claude-bridge.json`，不合并任务工作目录的配置。
+- Claude Code 普通请求和摘要请求都传 `--safe-mode`；摘要请求不再传空的 `settingSources`，因为当前 Claude Code 登录在该参数下不可用。
+- 不通过全局环境设置安全模式，避免影响用户在任务中启动的 Claude Code。
+- Hob 在模型目录初始化时预注册模型，所有会话复用同一个扩展模块；生命周期清理仅影响当前会话，避免并行对话和任务互相清除状态。
+- 不修改 Hob 进程的 Claude Code 环境变量；启用桥调试日志时记录实际追加的系统提示词，供隔离验收。
+- 移除桥直接读取、重建和删除 Claude Code 会话文件的路径。无法直接续接时，以 SDK 消息重放 Hob 自己的历史（包含图片）；正常续接仍由 Claude Code 处理。这可能增加重启或上下文改写后的 token 用量。

package/vendor/claude-bridge/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eli Dickinson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/claude-bridge/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "pi-claude-bridge",
+  "version": "0.9.3",
+  "private": false,
+  "description": "Pi extension that uses Claude Code (via Agent SDK) as a model provider and adds an AskClaude tool.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "extension",
+    "claude-code",
+    "claude-agent-sdk"
+  ],
+  "author": "Eli Dickinson",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elidickinson/pi-claude-bridge.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE",
+    "assets"
+  ],
+  "scripts": {
+    "test:unit": "node --import tsx --import ./tests/lib/setup.mjs --test tests/unit-*.mjs",
+    "test": "set -a && [ -f .env.test ] && . .env.test; set +a; CLAUDE_BRIDGE_TEST_LOG_DIR=$(mktemp -d); export CLAUDE_BRIDGE_TEST_LOG_DIR; npm run test:unit && tests/int-smoke.sh && tests/int-multi-turn.sh && tests/int-cache.sh && node --import tsx --test tests/int-*.mjs && node tests/lib/check-deadlock-logs.mjs \"$CLAUDE_BRIDGE_TEST_LOG_DIR\"",
+    "test:usage": "tests/usage-test.sh",
+    "typecheck": "tsc --noEmit"
+  },
+  "type": "module",
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.293",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cc-session-io": "^0.4.0",
+    "change-case": "^5.4.4"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": ">=0.86.1",
+    "@earendil-works/pi-coding-agent": ">=0.86.1",
+    "@earendil-works/pi-tui": ">=0.86.1",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.124.0",
+    "@earendil-works/pi-ai": "^1.2.0",
+    "@earendil-works/pi-coding-agent": "^1.2.0",
+    "@earendil-works/pi-tui": "^1.2.0",
+    "@types/node": "^24.13.2",
+    "tsx": "^4.22.4",
+    "typebox": "^1.3.7",
+    "typescript": "^6.0.3"
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  }
+}

package/vendor/claude-bridge/src/agents-md.ts

@@ -0,0 +1,14 @@
+// Pi owns context-file discovery; the bridge only formats the list Pi loaded so
+// Claude receives the same instructions, in the same order, that Pi applies.
+
+type ContextFile = { path: string; content: string };
+
+export function formatProjectContext(contextFiles: ContextFile[]): string | undefined {
+	if (contextFiles.length === 0) return undefined;
+
+	let prompt = "<project_context>\n\nProject-specific instructions and guidelines:\n\n";
+	for (const { path, content } of contextFiles) {
+		prompt += `<project_instructions path="${path}">\n${content}\n</project_instructions>\n\n`;
+	}
+	return `${prompt}</project_context>`;
+}

package/vendor/claude-bridge/src/askclaude-schema.ts

@@ -0,0 +1,92 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+import type { Config } from "./config.js";
+
+export type AskClaudeMode = "full" | "read" | "none";
+
+export interface AskClaudeDefaults {
+	mode: AskClaudeMode;
+	isolated: boolean;
+	allowFull: boolean;
+}
+
+const PACKAGE_DEFAULT_MODE: AskClaudeMode = "read";
+const PACKAGE_DEFAULT_ISOLATED = false;
+
+export function resolveAskClaudeDefaults(conf: Config["askClaude"]): AskClaudeDefaults {
+	const rawAllowFull: unknown = conf?.allowFullMode;
+	const allowFull = rawAllowFull == null ? true : rawAllowFull === true;
+	const configuredMode: unknown = conf?.defaultMode;
+	const mode = configuredMode == null
+		? PACKAGE_DEFAULT_MODE
+		: configuredMode === "full" || configuredMode === "read" || configuredMode === "none"
+			? configuredMode
+			// Unrecognized value: the most restrictive mode, not the package default.
+			: "none";
+	return { mode: !allowFull && mode === "full" ? PACKAGE_DEFAULT_MODE : mode, isolated: conf?.defaultIsolated ?? PACKAGE_DEFAULT_ISOLATED, allowFull };
+}
+
+export function resolveAskClaudeMode(mode: unknown, defaults: AskClaudeDefaults): AskClaudeMode {
+	const resolved = mode === undefined ? defaults.mode : mode;
+	if (resolved !== "full" && resolved !== "read" && resolved !== "none") throw new Error(`Invalid AskClaude mode: ${String(resolved)}`);
+	if (resolved === "full" && !defaults.allowFull) throw new Error("AskClaude full mode is disabled.");
+	return resolved;
+}
+
+function modeDescription(defaults: AskClaudeDefaults): string {
+	const mark = (mode: AskClaudeMode) => (mode === defaults.mode ? " (default)" : "");
+	const parts = [
+		`"read"${mark("read")}: questions about the codebase — review, analysis, explain.`,
+		`"none"${mark("none")}: general knowledge only (no file access).`,
+	];
+	if (defaults.allowFull) {
+		parts.push(`"full"${mark("full")}: allows writing and bash execution (careful: runs without feedback to pi).`);
+	}
+	return parts.join(" ");
+}
+
+export function buildAskClaudeParams(defaults: AskClaudeDefaults) {
+	const visibility = defaults.isolated
+		? "By default Claude sees only this prompt (isolated session)."
+		: "By default Claude sees the full conversation history.";
+	const trueDefault = defaults.isolated ? " (default)" : "";
+	const falseDefault = defaults.isolated ? "" : " (default)";
+	const modeValues: readonly AskClaudeMode[] = defaults.allowFull ? ["read", "full", "none"] : ["read", "none"];
+	return Type.Object({
+		prompt: Type.String({ description: `The question or task for Claude Code. ${visibility} Don't research up front, let Claude explore.` }),
+		mode: Type.Optional(StringEnum(modeValues, { description: modeDescription(defaults) })),
+		model: Type.Optional(Type.String({ description: 'Claude model (e.g. "opus", "sonnet", "haiku", or full ID). Defaults to "opus".' })),
+		thinking: Type.Optional(StringEnum(["off", "minimal", "low", "medium", "high", "xhigh"] as const, { description: "Thinking effort level. Omit to use Claude Code's default." })),
+		isolated: Type.Optional(Type.Boolean({ description: `When true${trueDefault}, Claude sees only this prompt (clean session). When false${falseDefault}, Claude sees the full conversation history.` })),
+	});
+}
+
+export function askClaudeToolDescription(defaults: AskClaudeDefaults, override?: string | null): string {
+	if (override != null) return override;
+	const suffix = " Prefer to handle straightforward tasks yourself.";
+	if (!defaults.allowFull) {
+		const middle = defaults.mode === "none"
+			? 'Defaults to no file access — pass mode "read" to let Claude Code explore the codebase; it can never make changes.'
+			: "Read-only — Claude Code can explore the codebase but not make changes.";
+		return `Delegate to Claude Code for a second opinion or analysis (code review, architecture questions, debugging theories). ${middle}${suffix}`;
+	}
+	const middle = defaults.mode === "full"
+		? 'Defaults to full mode — Claude Code writes files and runs bash without feedback to pi; pass mode "read" to keep it to exploration.'
+		: defaults.mode === "none"
+			? 'Defaults to no file access — pass mode "read" to let Claude Code explore the codebase, or "full" for a task that requires changes.'
+			: "Defaults to read-only mode — use full mode when the user wants to delegate a task that requires changes.";
+	return `Delegate to Claude Code for a second opinion or analysis (code review, architecture questions, debugging theories), or to autonomously handle a task. ${middle}${suffix}`;
+}
+
+export function askClaudeCallTags(
+	args: { mode?: AskClaudeMode; model?: string; thinking?: string; isolated?: boolean },
+	defaults: AskClaudeDefaults,
+): string[] {
+	const tags: string[] = [];
+	const mode = args.mode ?? defaults.mode;
+	if (mode !== PACKAGE_DEFAULT_MODE || (args.mode !== undefined && args.mode !== defaults.mode)) tags.push(`mode=${mode}`);
+	if (args.model) tags.push(`model=${args.model}`);
+	if (args.thinking) tags.push(`thinking=${args.thinking}`);
+	if ((args.isolated ?? defaults.isolated) !== PACKAGE_DEFAULT_ISOLATED) tags.push("isolated");
+	return tags;
+}

package/vendor/claude-bridge/src/askclaude-ui.ts

@@ -0,0 +1,90 @@
+// Status-line rendering helpers for the AskClaude tool.
+//
+// While Claude Code runs inside an AskClaude call, the pi TUI can't surface
+// each tool_use individually — there's only one status row for the whole
+// delegation. These helpers shape a tool_use record into a short, path-aware
+// label (e.g. "Read(src/foo.ts)", "Bash(git log --oneline…)") and collapse
+// runs of the same tool so the line doesn't flicker. Used only by
+// promptAndWait; the provider path exposes tools directly through pi's TUI
+// and doesn't need this.
+
+export interface ToolCallState {
+	name: string;
+	status: string;
+	rawInput?: unknown;
+}
+
+export function extractPath(rawInput: unknown): string | undefined {
+	if (!rawInput || typeof rawInput !== "object") return undefined;
+	const input = rawInput as Record<string, unknown>;
+	if (typeof input.file_path === "string") return input.file_path;
+	if (typeof input.path === "string") return input.path;
+	if (typeof input.command === "string") return input.command.substring(0, 80);
+	return undefined;
+}
+
+export function shortPath(p: string): string {
+	const cwd = process.cwd();
+	if (p.startsWith(cwd + "/")) return p.slice(cwd.length + 1);
+	if (p.startsWith("/")) {
+		const parts = p.split("/");
+		if (parts.length > 3) return parts.slice(-2).join("/");
+	}
+	return p;
+}
+
+export function formatToolAction(tc: ToolCallState): string | undefined {
+	const path = extractPath(tc.rawInput);
+	const verb = tc.name.toLowerCase().split(/\s/)[0];
+	if (verb === "read" || verb === "readfile") {
+		return path ? `Read(${shortPath(path)})` : "Read";
+	} else if (verb === "glob") {
+		const input = tc.rawInput as Record<string, unknown> | undefined;
+		const pat = typeof input?.pattern === "string" ? input.pattern.slice(0, 40) : "";
+		return pat ? `Glob(${pat})` : "Glob";
+	} else if (verb === "edit" || verb === "write" || verb === "writefile" || verb === "multiedit") {
+		return path ? `Edit(${shortPath(path)})` : "Edit";
+	} else if (verb === "bashoutput") {
+		return undefined; // redundant with preceding Bash call
+	} else if (verb === "bash" || verb === "terminal") {
+		return path ? `Bash(${path})` : "Bash";
+	} else if (verb === "agent") {
+		const input = tc.rawInput as Record<string, unknown> | undefined;
+		return `Agent(${String(input?.description ?? "").slice(0, 40)})`;
+	} else if (verb === "grep") {
+		const input = tc.rawInput as Record<string, unknown> | undefined;
+		const pat = typeof input?.pattern === "string" ? input.pattern.slice(0, 40) : "";
+		return pat ? `Grep(${pat})` : "Grep";
+	} else if (verb === "skill") {
+		const input = tc.rawInput as Record<string, unknown> | undefined;
+		const name = typeof input?.skill === "string" ? input.skill.slice(0, 40) : "";
+		return name ? `Skill(${name})` : "Skill";
+	} else if (verb === "todowrite" || verb === "taskcreate" || verb === "taskupdate") {
+		const todos = Array.isArray((tc.rawInput as any)?.todos) ? (tc.rawInput as any).todos : [];
+		const current = todos.find((t: any) => t.status === "in_progress") ?? todos.find((t: any) => t.status === "pending");
+		const label = current ? String(current.content ?? "").slice(0, 40) : "";
+		return label || undefined;
+	} else if (verb === "askclaude") {
+		// Recursive — don't show AskClaude in its own action summary
+		return undefined;
+	}
+	return tc.name;
+}
+
+export function buildActionSummary(calls: Map<string, ToolCallState>): string {
+	const parts: string[] = [];
+	let prevVerb = "";
+	for (const [, tc] of calls) {
+		const action = formatToolAction(tc);
+		if (!action) continue;
+		const verb = tc.name.toLowerCase().split(/\s/)[0];
+		// Collapse consecutive calls to the same tool — keep only the latest
+		if (verb === prevVerb) {
+			parts[parts.length - 1] = action;
+		} else {
+			parts.push(action);
+		}
+		prevVerb = verb;
+	}
+	return parts.join("; ");
+}