@tea-agent/loop-agent 0.34.4 → 0.35.0-beta.1

package/AGENTS.md

@@ -38,7 +38,7 @@
 4. 涉及测试纪律/验证声明/调试时继续读：`docs/governance/harness-methodology-*.md`。
 5. 查看最近提交、相关 plan/progress/report；`git status --short --branch`；跑最小基线验证。
 6. 后端/接口/pytest → `taskKind: "backend-test"`（不是 `--profile`）；知识回写 `knowledge-sync`；图谱开荒 `knowledge-graph-bootstrap`。`--profile` 仅 `auto|minimal|standard|reviewed|supervised`。
-7. 看板/observe → `agent-worker console`（默认 repo=当前目录、port=8790；兼容入口 `agent-worker console serve --repo . --port 8790`）（`/inspect/` 只读）；`observe serve` 已下线（`OBSERVE_SERVE_REMOVED` + exit 2）；`observe snapshot` 仍可用。
+7. 看板/observe → `agent-worker console`（默认 repo=当前目录、port=8790；listen 成功后默认打开系统浏览器，`--no-open` 禁止）（`/inspect/` 只读）；`observe serve` 已下线（`OBSERVE_SERVE_REMOVED` + exit 2）；`observe snapshot` 仍可用。
 8. 分支合并 → 先读 `docs/operations/branch-merge-guideline.md`。
 
 ## 会话协议

package/CHANGELOG.md

@@ -2,10 +2,25 @@
 
 ## [Unreleased]
 
+## [0.34.5] - 2026-08-13
+
+### 重点更新
+
+- 优化 Operator Chat 对话页体验，包括隐藏重复标题、升级 Markdown 渲染、改进工具调用展示，并合并了 `/` 命令面板
+- 控制台启动后默认自动打开系统浏览器看板
+
+### 改进
+
+- 优化 Operator Chat 对话页（UI-01 至 UI-11）：隐藏重复标题、补齐品牌空态与真实注入上下文侧栏、改进工具调用摘要与结果展示、修复遮罩 hover 形变、为截断会话标题提供 tooltip、升级 Markdown/GFM 渲染，并增加用户主动打开的调用记录入口与合并后的 `/` 命令面板
+- 会话列表操作改为按需显示 Remix Icon，同时保留键盘 focus 与触屏可访问路径
+- 输入区将图片上传收敛为图标按钮，并避免“全部工具 · N · 状态”歧义
+- 控制台在服务监听成功后默认打开系统浏览器
+
 ## [0.34.4] - 2026-08-12
 
 ### 重点更新
 
+- 裸 `agent-worker console` 收敛为唯一看板入口，监听成功后默认打开系统浏览器，并删除 `console serve`
 - 本地连续交付改为按精确 Git tree 复用验证结果，避免提交、推送和分支合并之间机械重复全量测试，同时保持不同 tree、不同环境和远程 CI 的独立质量门槛
 - 全面加固 Operator Chat 的 Turn 所有权、停止与异常恢复流程，解决浏览器与服务端状态错位时的重复提交、停止失效和错误提示问题
 - Operator Chat 新增按仓库保存的 Skills 自动使用偏好，用户可控制技能是否进入模型自动发现范围，同时保留手动调用能力
@@ -20,6 +35,7 @@
 
 ### 改进
 
+- 裸 `agent-worker console` 成为唯一 Console 启动入口：本地图形交互环境在服务监听成功后默认打开系统浏览器，`--no-open` 可明确禁止；删除 `console serve` 兼容子命令
 - source→target 连续交付统一选择一个本地全量验证权威；默认 commit/push 不增加步骤，远程 CI 与发布环境不复用本地 receipt
 - pre-push receipt 诊断和执行日志改用有界命令摘要，并严格校验 tree、环境、命令合同、有效期及 receipt 内容一致性
 - Skills 运行时快照改为使用服务端资源标识和独立的自动调用状态，资源变更仅接受当前 inventory 中的合法条目

package/README.md

@@ -104,8 +104,8 @@ loop-agent dag report --run-id <run-id>
 
 ```bash
 # 终端 A：Console（任务/运行操作面；canonical mutation 只经 sibling loop-agent）
-agent-worker console                              # 默认 repo=当前目录、port=8790
-agent-worker console serve --repo .               # 兼容入口，等价于裸入口
+agent-worker console                              # 默认 repo=当前目录、port=8790；本地图形环境默认打开浏览器
+agent-worker console --no-open                    # 只启动服务，不打开浏览器
 agent-worker console doctor --repo .
 
 ```

package/dist/shared/operator/capabilities.js

@@ -2299,13 +2299,6 @@ export const OPERATOR_COMMAND_COVERAGE = Object.freeze([
         source: "agent-worker",
         exclusionReason: "Not exposed to Operator Chat in M5.",
     },
-    {
-        command: "agent-worker console serve",
-        coverage: "excluded",
-        action: null,
-        source: "agent-worker",
-        exclusionReason: "Not exposed to Operator Chat in M5.",
-    },
     {
         command: "agent-worker console doctor",
         coverage: "excluded",

package/dist/worker/cli.js

@@ -712,37 +712,22 @@ export function buildAgentWorkerProgram() {
         process.stdout.write(`${JSON.stringify(snapshot)}\n`);
     });
     consoleCmd
-        .description("Loop Operator Console (local); bare `agent-worker console` starts it directly (repo defaults to current working directory, port defaults to 8790)")
-        .enablePositionalOptions()
-        .passThroughOptions()
+        .description("Loop Operator Console (local); bare `agent-worker console` starts it directly (repo defaults to current working directory, port defaults to 8790). Opens the system browser after listen unless --no-open or a non-graphical environment.")
         .option("--repo <repo-root>", "Target repo root (default: current working directory)", process.cwd())
         .option("--port <port>", "HTTP port", "8790")
         .option("--host <host>", "Bind host (default 127.0.0.1; use 0.0.0.0 for LAN, no network auth)", "127.0.0.1")
         .option("--debug", "Log request source/method/path/status to stderr")
         .option("--app-data <path>", "Override Console application-data root (Draft/Operation/confirmation)")
         .option("--default-timeout-ms <ms>", "LoopAgentClient hard timeout for Console operations (ms; default 14400000 / 4h; 0 disables)")
-        .action(async (options) => {
-        await runConsoleServe({
-            repoRoot: path.resolve(options.repo),
-            host: options.host,
-            port: Number.parseInt(options.port, 10),
-            debug: options.debug === true,
-            appDataRoot: options.appData
-                ? path.resolve(options.appData)
-                : undefined,
-            defaultTimeoutMsRaw: options.defaultTimeoutMs,
-        });
-    });
-    consoleCmd
-        .command("serve")
-        .option("--repo <repo-root>", "Target repo root (default: current working directory)", process.cwd())
-        .option("--port <port>", "HTTP port", "8790")
-        .option("--host <host>", "Bind host (default 127.0.0.1; use 0.0.0.0 for LAN, no network auth)", "127.0.0.1")
-        .option("--debug", "Log request source/method/path/status to stderr")
-        .option("--app-data <path>", "Override Console application-data root (Draft/Operation/confirmation)")
-        .option("--default-timeout-ms <ms>", "LoopAgentClient hard timeout for Console operations (ms; default 14400000 / 4h; 0 disables)")
-        .description("Start Loop Operator Console HTTP server (compat entry; equivalent to bare `agent-worker console`)")
-        .action(async (options) => {
+        .option("--no-open", "Do not open the system browser after the Console listens")
+        .action(async (options, command) => {
+        // Reject unknown tokens such as legacy `console serve` instead of starting HTTP.
+        const extras = command.args.filter((arg) => arg.length > 0);
+        if (extras.length > 0) {
+            process.stderr.write(`error: unknown command '${extras[0]}' for agent-worker console\n`);
+            process.exitCode = 1;
+            return;
+        }
         await runConsoleServe({
             repoRoot: path.resolve(options.repo),
             host: options.host,
@@ -752,6 +737,8 @@ export function buildAgentWorkerProgram() {
                 ? path.resolve(options.appData)
                 : undefined,
             defaultTimeoutMsRaw: options.defaultTimeoutMs,
+            // Commander maps --no-open to open:false; default remains open:true.
+            noOpen: options.open === false,
         });
     });
     consoleCmd
@@ -850,9 +837,10 @@ function parseOptionalTimeoutMs(raw) {
     }
     return value;
 }
-/** Shared console serve entry used by both bare `console` and `console serve`. */
+/** Console HTTP entry for bare `agent-worker console` (listen first, then optional browser open). */
 async function runConsoleServe(options) {
     const { createConsoleServer } = await import("./console/server.js");
+    const { maybeOpenConsoleBrowser } = await import("./console/open-browser.js");
     try {
         const server = await createConsoleServer({
             repoRoot: options.repoRoot,
@@ -862,7 +850,13 @@ async function runConsoleServe(options) {
             appDataRoot: options.appDataRoot,
             defaultTimeoutMs: parseOptionalTimeoutMs(options.defaultTimeoutMsRaw),
         });
-        process.stdout.write(`${server.url}\n`);
+        // Keep stdout bind URL contract (may include 0.0.0.0 / ::); browser URL is normalized separately.
+        process.stdout.write(`${server.url}
+`);
+        await maybeOpenConsoleBrowser({
+            noOpen: options.noOpen === true,
+            serverUrl: server.url,
+        });
         await new Promise((resolve) => {
             const shutdown = () => resolve();
             process.once("SIGINT", shutdown);

package/dist/worker/console/chat/chat-event-store.js

@@ -129,9 +129,56 @@ function boundedRedactedJson(value) {
         previewHash: createHash("sha256").update(preview).digest("hex"),
     };
 }
+/** Prefer readable Pi ToolResult text content; fall back to JSON shell. */
+function projectToolResultPreview(value) {
+    if (typeof value === "string") {
+        const preview = boundedRedactedText(value) ?? "";
+        return {
+            preview,
+            previewHash: createHash("sha256").update(preview).digest("hex"),
+        };
+    }
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        const record = value;
+        const content = record.content;
+        if (Array.isArray(content)) {
+            const texts = [];
+            for (const block of content) {
+                if (!block || typeof block !== "object")
+                    continue;
+                const item = block;
+                if (typeof item.text === "string")
+                    texts.push(item.text);
+            }
+            if (texts.length > 0) {
+                const joined = texts.join("\n");
+                const preview = boundedRedactedText(joined) ?? "";
+                return {
+                    preview,
+                    previewHash: createHash("sha256").update(preview).digest("hex"),
+                };
+            }
+        }
+        if (typeof record.text === "string") {
+            const preview = boundedRedactedText(record.text) ?? "";
+            return {
+                preview,
+                previewHash: createHash("sha256").update(preview).digest("hex"),
+            };
+        }
+        if (typeof record.output === "string") {
+            const preview = boundedRedactedText(record.output) ?? "";
+            return {
+                preview,
+                previewHash: createHash("sha256").update(preview).digest("hex"),
+            };
+        }
+    }
+    return boundedRedactedJson(value);
+}
 export function projectChatToolEventPayload(input) {
-    const { preview, previewHash } = boundedRedactedJson(input.value);
     if (input.kind === "tool_call") {
+        const { preview, previewHash } = boundedRedactedJson(input.value);
         return {
             toolCallId: input.toolCallId,
             toolName: input.toolName,
@@ -139,6 +186,7 @@ export function projectChatToolEventPayload(input) {
             previewHash,
         };
     }
+    const { preview, previewHash } = projectToolResultPreview(input.value);
     return {
         toolCallId: input.toolCallId,
         toolName: input.toolName,

package/dist/worker/console/chat/pi-runtime.js

@@ -1279,6 +1279,83 @@ export class ConsolePiRuntime {
      * list, and the session ResourceLoader inventories. Undefined when the
      * session is not active — callers fail closed instead of fabricating data.
      */
+    /**
+     * Browser-safe slash command projection for UI-11.
+     * Sources: current Session extension commands, prompt templates, skills.
+     * Never returns prompt/skill file bodies.
+     */
+    async listSlashCommands(sessionId) {
+        const scrub = (value) => {
+            const raw = String(value ?? "");
+            return raw
+                .replace(/\/Users\/[^\s]+/gi, "~")
+                .replace(/[A-Za-z]:\\Users\\[^\s]+/gi, "~")
+                .slice(0, 240);
+        };
+        try {
+            await this.ensureSessionReady(sessionId);
+        }
+        catch {
+            return [];
+        }
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return [];
+        const out = [];
+        const seen = new Set();
+        const push = (command, label, description, source) => {
+            const name = command.startsWith("/") ? command : `/${command}`;
+            const key = name.toLowerCase();
+            if (!key || key === "/" || seen.has(key))
+                return;
+            seen.add(key);
+            out.push({
+                command: name,
+                label: (label || name).slice(0, 80),
+                description: scrub(description),
+                source,
+            });
+        };
+        try {
+            const cmds = session.extensionRunner?.getRegisteredCommands?.() ?? [];
+            for (const cmd of cmds) {
+                const name = cmd.invocationName || cmd.name;
+                if (!name)
+                    continue;
+                push(String(name), String(cmd.name || name), String(cmd.description || ""), "extension");
+            }
+        }
+        catch {
+            // non-blocking
+        }
+        try {
+            for (const tpl of session.promptTemplates ?? []) {
+                if (!tpl?.name)
+                    continue;
+                push(String(tpl.name), String(tpl.name), String(tpl.description || ""), "prompt");
+            }
+        }
+        catch {
+            // non-blocking
+        }
+        try {
+            const services = this.serviceScopes.get(sessionId);
+            const resourceLoader = services?.resourceLoader;
+            const skills = resourceLoader?.getSkills?.()?.skills ?? [];
+            for (const skill of skills) {
+                if (!skill?.name)
+                    continue;
+                const command = skill.name.startsWith("skill:")
+                    ? `/${skill.name}`
+                    : `/skill:${skill.name}`;
+                push(command, skill.name, String(skill.description || ""), "skill");
+            }
+        }
+        catch {
+            // non-blocking
+        }
+        return out;
+    }
     async getRuntimeSnapshot(sessionId, options) {
         try {
             await this.ensureSessionReady(sessionId);
@@ -1340,7 +1417,7 @@ export class ConsolePiRuntime {
         const skills = [];
         const extensions = [];
         const diagnostics = [];
-        let resolvedResources = [];
+        const resolvedResources = [];
         const resourceFailure = (subface, error) => {
             diagnostics.push({
                 type: "error",

package/dist/worker/console/chat/routes.js

@@ -1643,6 +1643,25 @@ async function handleChatFiles(res, deps, sessionId, query) {
         .map((path) => ({ path }));
     sendJson(res, 200, { ok: true, files });
 }
+export async function handleChatCommands(res, deps, sessionId) {
+    try {
+        const commands = typeof deps.runtime.listSlashCommands === "function"
+            ? await deps.runtime.listSlashCommands(sessionId)
+            : [];
+        res.statusCode = 200;
+        res.setHeader("content-type", "application/json; charset=utf-8");
+        res.end(JSON.stringify({ ok: true, commands }));
+    }
+    catch (error) {
+        res.statusCode = 200;
+        res.setHeader("content-type", "application/json; charset=utf-8");
+        res.end(JSON.stringify({
+            ok: true,
+            commands: [],
+            warning: error instanceof Error ? error.message : "commands unavailable",
+        }));
+    }
+}
 export async function handleRuntimeContext(res, deps, sessionId) {
     const ensured = await ensureActiveSession(deps, sessionId);
     if (!ensured.ok) {
@@ -2929,7 +2948,7 @@ export async function handleChatRequest(req, res, deps, pathname) {
         await handleSkillAutoInvocation(req, res, deps, decodeURIComponent(skillAutoInvocation[1]), decodeURIComponent(skillAutoInvocation[2]));
         return true;
     }
-    const m4Route = pathname.match(/^\/api\/operator\/v1\/chat\/sessions\/([^/]+)\/(draft|files|runtime-context|runtime-snapshot|models|model|reload)$/);
+    const m4Route = pathname.match(/^\/api\/operator\/v1\/chat\/sessions\/([^/]+)\/(draft|files|runtime-context|runtime-snapshot|models|model|reload|commands)$/);
     if (m4Route) {
         const id = decodeURIComponent(m4Route[1]);
         const route = m4Route[2];
@@ -2961,6 +2980,10 @@ export async function handleChatRequest(req, res, deps, pathname) {
             await handleReloadSession(req, res, deps, id);
             return true;
         }
+        if (route === "commands" && method === "GET") {
+            await handleChatCommands(res, deps, id);
+            return true;
+        }
     }
     const sessionMainline = pathname.match(/^\/api\/operator\/v1\/chat\/sessions\/([^/]+)\/branch\/mainline$/);
     if (method === "POST" && sessionMainline) {

package/dist/worker/console/chat/shortcuts.js

@@ -1,16 +1,215 @@
+/**
+ * Operator Chat slash command catalog (UI-11).
+ *
+ * Local Operator + Pi Web commands are always available. Dynamic extension /
+ * prompt / skill commands are merged via mergeSlashCommands with conflict
+ * priority: operator/web > extension > skill > prompt.
+ */
 export const SHORTCUTS = [
-    { command: "/task", label: "Task context", description: "查看当前任务、Draft 与 assessment", action: "focus-panel:task" },
-    { command: "/contract", label: "Contract", description: "查看 contract diff 与 apply gate", action: "focus-panel:contract" },
-    { command: "/dag", label: "DAG", description: "查看 DAG spine、确认与运行状态", action: "focus-panel:dag" },
-    { command: "/interview", label: "Interview", description: "打开 Requirement Interview", action: "focus:interview" },
-    { command: "/reload", label: "Reload session", description: "重新加载当前 Pi 会话的设置、扩展、技能、提示词、主题与上下文文件（不产生消息）", action: "reload" },
-    { command: "/help", label: "Shortcuts", description: "显示可用 shortcut", action: "show-help" },
+    {
+        command: "/task",
+        label: "Task context",
+        description: "查看当前任务、Draft 与 assessment",
+        action: "focus-panel:task",
+        source: "operator",
+    },
+    {
+        command: "/contract",
+        label: "Contract",
+        description: "查看 contract diff 与 apply gate",
+        action: "focus-panel:contract",
+        source: "operator",
+    },
+    {
+        command: "/dag",
+        label: "DAG",
+        description: "查看 DAG spine、确认与运行状态",
+        action: "focus-panel:dag",
+        source: "operator",
+    },
+    {
+        command: "/interview",
+        label: "Interview",
+        description: "打开 Requirement Interview",
+        action: "focus:interview",
+        source: "operator",
+    },
+    {
+        command: "/reload",
+        label: "Reload session",
+        description: "重新加载当前 Pi 会话的设置、扩展、技能、提示词、主题与上下文文件（不产生消息）",
+        action: "reload",
+        source: "operator",
+    },
+    {
+        command: "/help",
+        label: "Shortcuts",
+        description: "显示可用 shortcut",
+        action: "show-help",
+        source: "operator",
+    },
 ];
-/** Pure navigation/display resolver. It deliberately has no mutation decisions. */
+/** Pi Web commands with real browser-equivalent behavior (UI-11). */
+export const WEB_SLASH_COMMANDS = [
+    {
+        command: "/compact",
+        label: "压缩上下文",
+        description: "压缩当前会话上下文，释放 token",
+        action: "compact",
+        source: "web",
+    },
+    {
+        command: "/name",
+        label: "重命名会话",
+        description: "设置当前会话标题",
+        action: "name",
+        source: "web",
+    },
+    {
+        command: "/session",
+        label: "会话信息",
+        description: "显示当前会话元信息",
+        action: "session",
+        source: "web",
+    },
+    {
+        command: "/copy",
+        label: "复制回复",
+        description: "复制最后一条助手消息原文",
+        action: "copy",
+        source: "web",
+    },
+];
+const SOURCE_PRIORITY = {
+    operator: 0,
+    web: 1,
+    extension: 2,
+    skill: 3,
+    prompt: 4,
+};
+function normalizeCommandName(raw) {
+    const token = raw.trim().split(/\s+/, 1)[0] ?? "";
+    if (!token)
+        return "";
+    return token.startsWith("/") ? token.toLowerCase() : `/${token.toLowerCase()}`;
+}
+/** Pure navigation/display resolver for local Operator + Web commands. */
 export function resolveShortcut(input) {
     const token = input.trim().split(/\s+/, 1)[0]?.toLowerCase();
     if (!token?.startsWith("/"))
         return undefined;
-    const found = SHORTCUTS.find((shortcut) => shortcut.command === token);
-    return found ? { command: found.command, action: found.action } : { command: token, action: "unknown" };
+    const local = [...SHORTCUTS, ...WEB_SLASH_COMMANDS].find((shortcut) => shortcut.command === token);
+    if (local)
+        return { command: local.command, action: local.action };
+    return { command: token, action: "unknown" };
+}
+/**
+ * Merge Operator, Web, and dynamic Session commands with conflict dedupe.
+ * Priority: operator/web > extension > skill > prompt. /reload is single-card.
+ */
+export function mergeSlashCommands(dynamic = []) {
+    const byName = new Map();
+    const upsert = (item) => {
+        const key = normalizeCommandName(item.command);
+        if (!key)
+            return;
+        const existing = byName.get(key);
+        if (!existing) {
+            byName.set(key, { ...item, command: key });
+            return;
+        }
+        if (SOURCE_PRIORITY[item.source] < SOURCE_PRIORITY[existing.source]) {
+            byName.set(key, { ...item, command: key });
+        }
+    };
+    for (const item of SHORTCUTS) {
+        upsert({
+            command: item.command,
+            label: item.label,
+            description: item.description,
+            source: item.source,
+            action: item.action,
+        });
+    }
+    for (const item of WEB_SLASH_COMMANDS) {
+        upsert({
+            command: item.command,
+            label: item.label,
+            description: item.description,
+            source: item.source,
+            action: item.action,
+        });
+    }
+    for (const item of dynamic) {
+        const command = normalizeCommandName(item.command);
+        if (!command)
+            continue;
+        upsert({
+            command,
+            label: item.label || command,
+            description: item.description || "",
+            source: item.source,
+            action: "pi-prompt",
+        });
+    }
+    return [...byName.values()].sort((a, b) => {
+        const src = SOURCE_PRIORITY[a.source] - SOURCE_PRIORITY[b.source];
+        if (src !== 0)
+            return src;
+        return a.command.localeCompare(b.command);
+    });
+}
+/** Filter + rank slash candidates by name/description. */
+export function filterSlashCommands(commands, rawQuery) {
+    const token = (rawQuery.trim().split(/\s+/, 1)[0] ?? "").toLowerCase();
+    // After a space (args), hide the palette.
+    if (/\s/.test(rawQuery.trimStart().slice(1)) || rawQuery.includes(" ")) {
+        // Only hide when user has typed past the command token.
+        const after = rawQuery.trimStart();
+        if (after.includes(" "))
+            return [];
+    }
+    const q = token.startsWith("/") ? token : token ? `/${token}` : "/";
+    const needle = q === "/" ? "" : q.slice(1);
+    const scored = [];
+    for (const item of commands) {
+        const name = item.command.toLowerCase();
+        const bare = name.startsWith("/") ? name.slice(1) : name;
+        const desc = item.description.toLowerCase();
+        let score = 100;
+        if (!needle) {
+            score = 10 + SOURCE_PRIORITY[item.source];
+        }
+        else if (name === q || bare === needle) {
+            score = 0;
+        }
+        else if (name.startsWith(q) || bare.startsWith(needle)) {
+            score = 1;
+        }
+        else if (bare.includes(needle) || name.includes(needle)) {
+            score = 2;
+        }
+        else if (desc.includes(needle)) {
+            score = 3;
+        }
+        else {
+            continue;
+        }
+        scored.push({ ...item, score });
+    }
+    return scored.sort((a, b) => {
+        if (a.score !== b.score)
+            return a.score - b.score;
+        const src = SOURCE_PRIORITY[a.source] - SOURCE_PRIORITY[b.source];
+        if (src !== 0)
+            return src;
+        return a.command.localeCompare(b.command);
+    });
 }
+export const SLASH_SOURCE_LABEL = {
+    operator: "Operator",
+    web: "Pi Web",
+    extension: "Extensions",
+    prompt: "Prompts",
+    skill: "Skills",
+};