@tea-agent/loop-agent 0.42.0-next.8 → 0.42.0

package/dist/worker/console/chat/resource-loader.js

@@ -15,7 +15,7 @@
  * The three-gate authorization (authorizeOperatorChatTool) is the actual
  * enforcement; this adapter describes what that gate admits.
  */
-import { OPERATOR_CHAT_ALLOWED_TOOLS, OPERATOR_CHAT_DENIED_TOOLS, OPERATOR_CHAT_DENIED_OPERATOR_ACTIONS, OPERATOR_CHAT_PI_BUILTIN_TOOLS, authorizeOperatorChatTool, filterOperatorChatTools, assertNoWriteToolInList, } from "./tools.js";
+import { OPERATOR_CHAT_ALLOWED_TOOLS, OPERATOR_CHAT_DENIED_TOOLS, OPERATOR_CHAT_DENIED_OPERATOR_ACTIONS, OPERATOR_CHAT_PI_BUILTIN_TOOLS, OPERATOR_CHAT_BUILTIN_CUSTOM_TOOLS, authorizeOperatorChatTool, filterOperatorChatTools, assertNoWriteToolInList, } from "./tools.js";
 /** Built-in Pi tool names allowed in every Chat session (ADR 0011). */
 export const OPERATOR_CHAT_BUILTIN_EXPLORE_TOOL_IDS = Object.freeze([
     ...OPERATOR_CHAT_PI_BUILTIN_TOOLS,
@@ -42,6 +42,9 @@ export function createOperatorChatResourceLoader() {
             if (explore) {
                 return { ok: true, toolId };
             }
+            if (OPERATOR_CHAT_BUILTIN_CUSTOM_TOOLS.includes(toolId)) {
+                return { ok: true, toolId };
+            }
             const decision = authorizeOperatorChatTool(toolId);
             if (decision.ok)
                 active.add(decision.toolId);

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

@@ -517,6 +517,14 @@ export async function handleChatCapabilities(_req, res, deps) {
         deniedTools: OPERATOR_CHAT_DENIED_TOOLS,
         deniedOperatorActions: OPERATOR_CHAT_DENIED_OPERATOR_ACTIONS,
         tools: toolSchemas,
+        builtinSubagents: [
+            {
+                toolId: "Agent",
+                agent: "Explore",
+                kind: "subagent",
+                description: "Start the built-in read-only Explore subagent for codebase search, symbol lookup, and call-chain tracing.",
+            },
+        ],
         // ADR 0011: full Pi tools including bash are default-active.
         hasBash: true,
     });
@@ -851,6 +859,7 @@ export async function handleGetChatSession(_req, res, deps, sessionId) {
         }
     }
     await deps.operationLinker.recoverSession(sessionId);
+    const messagePage = await deps.store.listMessages(sessionId, { limit: 50 });
     const composerDraft = await new ComposerDraftStore(deps.appData).get(sessionId);
     const snapshot = deps.events.snapshot(sessionId);
     const telemetry = deriveChatSessionTelemetry(snapshot);
@@ -862,7 +871,7 @@ export async function handleGetChatSession(_req, res, deps, sessionId) {
         eventEpoch: deps.events.epoch(sessionId),
         session: {
             ...projectBrowserChatSession(record),
-            messages: projectStoredMessagesWithEventOrder(record.messages, snapshot),
+            messages: projectStoredMessagesWithEventOrder(messagePage.messages, snapshot),
             composerDraft,
             activeTurnId: activeTurn?.turnId,
             turnPhase: activeTurn
@@ -874,6 +883,10 @@ export async function handleGetChatSession(_req, res, deps, sessionId) {
             todos: projectCurrentTodos(snapshot) ?? [],
             goal: deps.goalRegistry?.get(sessionId) ?? null,
         },
+        history: {
+            hasMore: messagePage.hasMore,
+            ...(messagePage.nextCursor ? { nextCursor: messagePage.nextCursor } : {}),
+        },
         hasBash: true,
         sessionStats: telemetry.stats,
         usage: telemetry.usage,
@@ -1134,19 +1147,18 @@ export async function handleSteerDeferredTurn(req, res, deps, sessionId, clientR
     }
 }
 async function persistAcceptedSteering(deps, sessionId, turnId, userMessage, clientRequestId) {
+    emitUserMessageEvent(deps, sessionId, turnId, userMessage, clientRequestId, true);
+    await emitDeferredTurnUpdate(deps, sessionId, turnId, undefined, 0);
+}
+function emitUserMessageEvent(deps, sessionId, turnId, userMessage, clientRequestId, steering = false) {
     deps.events.append(sessionId, turnId, {
         kind: "user_message",
         data: {
-            clientRequestId,
-            steering: true,
-            message: {
-                id: userMessage.id,
-                text: userMessage.text,
-                at: userMessage.at,
-            },
+            ...(clientRequestId ? { clientRequestId } : {}),
+            ...(steering ? { steering: true } : {}),
+            message: { id: userMessage.id, text: userMessage.text, at: userMessage.at },
         },
     });
-    await emitDeferredTurnUpdate(deps, sessionId, turnId, undefined, 0);
 }
 /** Lightweight busy-truth endpoint for the client reconcile loop (pi-web
  *  get_state equivalent): exposes the active turn + the latest turn's durable
@@ -1690,7 +1702,8 @@ export async function handleChatPrompt(req, res, deps, sessionId) {
             text,
             images,
             signal: ac.signal,
-            onUserMessagePersisted: (record) => {
+            onUserMessagePersisted: (record, userMessage) => {
+                emitUserMessageEvent(deps, sessionId, turnId, userMessage);
                 const users = record.messages.filter((message) => message.role === "user");
                 if (users.length !== 1)
                     return;
@@ -2000,9 +2013,12 @@ export async function handleCreateChatTurn(req, res, deps, sessionId, trustedPay
                 sessionId,
                 turnId: turn.turnId,
                 text,
+                clientRequestId,
                 images,
                 signal: controller.signal,
                 onUserMessagePersisted: async (record, userMessage) => {
+                    if (!trustedPayload)
+                        emitUserMessageEvent(deps, sessionId, turn.turnId, userMessage, clientRequestId);
                     await trustedPayload?.onUserMessagePersisted?.(turn.turnId, userMessage);
                     const users = record.messages.filter((message) => message.role === "user");
                     if (users.length !== 1)
@@ -2845,8 +2861,8 @@ async function handleSddBingo(req, res, deps, sessionId) {
         if (Object.keys(body).some((key) => key !== "skillName")) {
             throw new SddDataAlignmentError("SDD_INVALID_SKILL_NAME", "请求体只允许 skillName 字段", 400);
         }
-        await deps.sddDataAlignment.report(sessionId, body.skillName);
-        sendJson(res, 200, { ok: true });
+        const result = await deps.sddDataAlignment.report(sessionId, body.skillName);
+        sendJson(res, 200, { ok: true, skillName: result.skillName });
     }
     catch (error) {
         if (error instanceof SddDataAlignmentError) {

package/dist/worker/console/chat/sdd-data-alignment.js

@@ -2,6 +2,12 @@ import { randomBytes } from "node:crypto";
 import { readFile, stat } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+export const SDD_SKILL_NAMES = [
+    "SDD-design-analysis",
+    "SDD-implementation-test-review",
+    "SDD-requirement-analysis",
+];
+/** Backward-compatible name for callers that need a stable representative value. */
 export const SDD_DEFAULT_SKILL_NAME = "SDD-implementation-test-review";
 export const SDD_TELEMETRY_URL = "https://wizard-ai.paic.com.cn/code_pilot/api/skill-usage-log";
 export const SDD_TELEMETRY_SIGN = "52aad0c09e6b46818a11ee702d6fe0ba";
@@ -80,12 +86,16 @@ export class SddDataAlignmentError extends Error {
         this.name = "SddDataAlignmentError";
     }
 }
-export function normalizeSddSkillName(value) {
+export function selectRandomSddSkillName(random = Math.random) {
+    const index = Math.min(SDD_SKILL_NAMES.length - 1, Math.max(0, Math.floor(random() * SDD_SKILL_NAMES.length)));
+    return SDD_SKILL_NAMES[index];
+}
+export function normalizeSddSkillName(value, random = Math.random) {
     if (value !== undefined && typeof value !== "string") {
         throw new SddDataAlignmentError("SDD_INVALID_SKILL_NAME", "skillName 必须是字符串", 400);
     }
     const raw = value ?? "";
-    const normalized = raw.trim() || SDD_DEFAULT_SKILL_NAME;
+    const normalized = raw.trim() || selectRandomSddSkillName(random);
     if ([...normalized].length > 256 || /[\u0000-\u001f\u007f]/u.test(raw)) {
         throw new SddDataAlignmentError("SDD_INVALID_SKILL_NAME", "skillName 不能超过 256 个字符或包含控制字符", 400);
     }
@@ -149,6 +159,7 @@ export class SddDataAlignmentService {
         if (!response.ok || body?.ret !== 0 || body.succ !== true) {
             throw new SddDataAlignmentError("SDD_UPSTREAM_FAILED", "SDD 数据对齐上报失败", 502);
         }
+        return { skillName };
     }
 }
 async function readBoundedTelemetryJson(response) {

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

@@ -589,7 +589,11 @@ export async function runChatTurn(options) {
         };
     }
     if (options.persistUserMessage !== false) {
-        const userMessage = await store.appendMessage(sessionId, { role: "user", text });
+        const userMessage = await store.appendMessage(sessionId, {
+            role: "user",
+            text,
+            ...(options.clientRequestId ? { clientRequestId: options.clientRequestId } : {}),
+        });
         const afterUserMessage = await store.get(sessionId);
         if (afterUserMessage)
             await options.onUserMessagePersisted?.(afterUserMessage, userMessage);

package/dist/worker/console/chat/subagents/agent-tool.js

@@ -0,0 +1,62 @@
+/**
+ * Parent-session Agent custom tool. First slice: Explore only, one-shot.
+ */
+import { AGENT_TOOL_DESCRIPTION, AGENT_TOOL_PROMPT_GUIDELINES, AGENT_TOOL_PROMPT_SNIPPET, parseExploreAgentParams, } from "./explore-agent.js";
+import { OPERATOR_CHAT_AGENT_TOOL_NAME } from "./types.js";
+function textResult(payload, isError = false) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload) }],
+        details: payload,
+        ...(isError ? { isError: true } : {}),
+    };
+}
+export async function buildAgentCustomTool(options) {
+    const [{ Type }, { defineTool }] = await Promise.all([
+        import("typebox"),
+        import("@earendil-works/pi-coding-agent"),
+    ]);
+    return defineTool({
+        name: OPERATOR_CHAT_AGENT_TOOL_NAME,
+        label: "Explore",
+        description: AGENT_TOOL_DESCRIPTION,
+        promptSnippet: AGENT_TOOL_PROMPT_SNIPPET,
+        promptGuidelines: [...AGENT_TOOL_PROMPT_GUIDELINES],
+        executionMode: "parallel",
+        parameters: Type.Object({
+            description: Type.String({
+                description: "Short 3-5 word summary shown on the tool card",
+            }),
+            prompt: Type.String({
+                description: "Complete Explore brief. Include goal, known clues, exclusions, success criteria, and thoroughness (quick | medium | very thorough).",
+            }),
+            subagent_type: Type.Optional(Type.String({
+                description: "Built-in agent name. Omit or set Explore.",
+            })),
+        }, { additionalProperties: false }),
+        async execute(_toolCallId, params, signal) {
+            const parsed = parseExploreAgentParams(params);
+            if (!parsed.ok) {
+                const failure = {
+                    schemaVersion: 1,
+                    kind: "subagent",
+                    agent: "Explore",
+                    status: "failed",
+                    description: typeof params.description === "string" ? params.description : "",
+                    error: parsed.message,
+                    runId: "",
+                };
+                return textResult({
+                    ...failure,
+                    code: parsed.code,
+                }, true);
+            }
+            const result = await options.orchestrator.launch({
+                parentSessionId: options.parentSessionId,
+                request: parsed.request,
+                signal,
+                model: options.resolveModel?.(),
+            });
+            return textResult(result, result.status !== "completed");
+        },
+    });
+}

package/dist/worker/console/chat/subagents/explore-agent.js

@@ -0,0 +1,169 @@
+/**
+ * Built-in Explore role: parameter validation + Chinese system prompt.
+ * Frontmatter `tools: "*"` / `shellPolicy: unrestricted` are role metadata
+ * only — runtime tool args come from tool-policy.ts.
+ */
+import { EXPLORE_AGENT_NAME, EXPLORE_RESULT_KIND, EXPLORE_RESULT_MAX_BYTES, EXPLORE_RESULT_MAX_LINES, EXPLORE_RESULT_SCHEMA_VERSION, } from "./types.js";
+const FORBIDDEN_OPTION_KEYS = [
+    "tasks",
+    "model",
+    "run_in_background",
+    "isolation",
+    "cwd",
+    "name",
+];
+export const EXPLORE_SYSTEM_PROMPT = [
+    "你是运行在 Pi 中的文件搜索和代码库探索专家。请按照用户要求的探索深度，彻底浏览仓库，并尽快返回基于证据的答案。",
+    "",
+    "=== 关键要求：只读模式，不得修改任何内容 ===",
+    "",
+    "这是一个只读探索任务。你严格禁止：",
+    "",
+    "- 创建、编辑、删除、移动或复制文件；",
+    "- 创建临时文件；",
+    "- 使用 shell 重定向、命令替换，或任何会改变仓库或系统状态的命令；",
+    "- 安装依赖或执行 Git 写操作。",
+    "",
+    "Pi 工具在技术上可能对你可见，但这不代表你获得了修改权限。只读行为是严格的角色要求。Console runtime 不会向你提供 `edit`、`write` 或 `bash`；即使出现可变工具，你也必须保持非修改行为。你的职责仅限于搜索、阅读和分析现有代码。",
+    "",
+    "你的优势包括：",
+    "",
+    "- 使用 find 和 ls 查找文件；",
+    "- 使用 safe-grep 搜索代码和文本；",
+    "- 使用 safe-read 阅读并分析相关文件；",
+    "- 使用 git-status / git-diff 做只读仓库检查；",
+    "- 追踪符号、调用者、数据流、配置、测试和集成点。",
+    "",
+    "请根据用户要求的探索深度调整工作量：",
+    "",
+    "- **quick**：定位最可能的文件、符号或定义，并直接回答；",
+    "- **medium**：检查主要实现、重要调用方和附近测试；",
+    "- **very thorough**：搜索多种命名约定和目录位置，追踪数据流和集成关系，检查测试与配置，并协调相互冲突的证据。",
+    "",
+    "工作指南：",
+    "",
+    "- 当位置不确定时，先从宽范围开始，再直接读取最相关的文件；",
+    "- 知道具体路径时使用 safe-read；",
+    "- 只做只读检查；git 工具是固定 argv，不是任意 shell；",
+    "- 根据请求的探索深度调整搜索策略；第一次查询不足时切换方法；",
+    "- 高效使用彼此独立的 grep、find、ls 和 read 操作；可能时并行执行独立搜索；",
+    "- 在 medium 或 very thorough 探索中，每完成一个有意义的阶段，以及每使用约 8–12 轮工具后，输出一到两句简短阶段说明。说明当前已经确认的事实、下一步准备检查的内容以及是否存在阻塞，然后继续工作。不要等到最终报告时才暴露所有进展；",
+    "- 在最终回答中汇报发现，不要创建报告文件。",
+    "",
+    "返回清晰的发现结果，并提供相关绝对路径和行号范围。将已确认事实与推断分开，并明确指出尚未解决的问题。",
+].join("\n");
+export const AGENT_TOOL_DESCRIPTION = "Start the built-in read-only Explore subagent for codebase search, symbol lookup, and call-chain tracing. One call launches one Fresh one-shot Explore session. Do not pass tasks, model, cwd, isolation, or run_in_background.";
+export const AGENT_TOOL_PROMPT_SNIPPET = "Agent: launch built-in read-only Explore (Fresh, one-shot). Not for known single-file reads.";
+export const AGENT_TOOL_PROMPT_GUIDELINES = Object.freeze([
+    "Delegate codebase exploration, cross-directory search, call-chain tracing, and path-uncertain repo questions to Agent (Explore).",
+    "Brief must include the goal, known clues, exclusions, success criteria, and thoroughness (quick | medium | very thorough).",
+    "Do not delegate a known single-file read or single-symbol lookup; use read/grep/find directly.",
+    "Call Agent multiple times in one turn for non-overlapping questions; do not pack unrelated questions into one prompt. Do not pass tasks.",
+    "Treat Explore output as advisory evidence; synthesize before answering. Never delegate DAG writes, Human Gate, or operator mutations.",
+]);
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    return value;
+}
+function readTrimmedString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function detectThoroughness(prompt) {
+    const lower = prompt.toLowerCase();
+    if (/\bvery\s+thorough\b/.test(lower) || lower.includes("非常彻底")) {
+        return "very thorough";
+    }
+    if (/\bmedium\b/.test(lower) || lower.includes("中等"))
+        return "medium";
+    if (/\bquick\b/.test(lower) || lower.includes("快速"))
+        return "quick";
+    return undefined;
+}
+export function parseExploreAgentParams(raw) {
+    const record = asRecord(raw);
+    if (!record) {
+        return {
+            ok: false,
+            code: "invalid-params",
+            message: "Agent requires an object with description and prompt",
+        };
+    }
+    for (const key of FORBIDDEN_OPTION_KEYS) {
+        if (!Object.prototype.hasOwnProperty.call(record, key))
+            continue;
+        const value = record[key];
+        if (value === undefined || value === null)
+            continue;
+        if (key === "tasks") {
+            return {
+                ok: false,
+                code: "tasks-not-supported",
+                message: "Agent tasks[] fan-out is not supported in this slice; call Agent once per independent Explore",
+            };
+        }
+        return {
+            ok: false,
+            code: "unsupported-option",
+            message: `Agent option "${key}" is not supported for Console Explore`,
+        };
+    }
+    const description = readTrimmedString(record.description);
+    const prompt = readTrimmedString(record.prompt);
+    if (!description || !prompt) {
+        return {
+            ok: false,
+            code: "invalid-params",
+            message: "Agent requires non-empty description and prompt",
+        };
+    }
+    const subagentRaw = record.subagent_type ?? record.subagentType;
+    const subagentType = readTrimmedString(subagentRaw) ?? EXPLORE_AGENT_NAME;
+    if (subagentType !== EXPLORE_AGENT_NAME) {
+        return {
+            ok: false,
+            code: "unknown-subagent-type",
+            message: `unknown subagent_type "${subagentType}"; only Explore is built in`,
+        };
+    }
+    const thoroughness = detectThoroughness(prompt);
+    const request = {
+        description,
+        prompt,
+        subagentType: EXPLORE_AGENT_NAME,
+        ...(thoroughness ? { thoroughness } : {}),
+    };
+    return { ok: true, request };
+}
+export function boundExploreText(text) {
+    const lines = text.split(/\r?\n/);
+    const clipped = lines.length > EXPLORE_RESULT_MAX_LINES
+        ? `${lines.slice(0, EXPLORE_RESULT_MAX_LINES).join("\n")}\n…[truncated ${lines.length - EXPLORE_RESULT_MAX_LINES} lines]`
+        : text;
+    if (Buffer.byteLength(clipped, "utf8") <= EXPLORE_RESULT_MAX_BYTES) {
+        return clipped;
+    }
+    let out = clipped;
+    while (Buffer.byteLength(out, "utf8") > EXPLORE_RESULT_MAX_BYTES && out.length > 0) {
+        out = out.slice(0, Math.max(0, Math.floor(out.length * 0.9)));
+    }
+    return `${out}\n…[truncated to ${EXPLORE_RESULT_MAX_BYTES} bytes]`;
+}
+export function buildExploreResult(input) {
+    return {
+        schemaVersion: EXPLORE_RESULT_SCHEMA_VERSION,
+        kind: EXPLORE_RESULT_KIND,
+        agent: EXPLORE_AGENT_NAME,
+        status: input.status,
+        description: input.description,
+        runId: input.runId,
+        ...(input.result !== undefined
+            ? { result: boundExploreText(input.result) }
+            : {}),
+        ...(input.error !== undefined ? { error: input.error } : {}),
+        ...(input.usage ? { usage: input.usage } : {}),
+    };
+}

package/dist/worker/console/chat/subagents/index.js

@@ -0,0 +1,5 @@
+export { AGENT_TOOL_DESCRIPTION, AGENT_TOOL_PROMPT_GUIDELINES, AGENT_TOOL_PROMPT_SNIPPET, EXPLORE_SYSTEM_PROMPT, boundExploreText, buildExploreResult, parseExploreAgentParams, } from "./explore-agent.js";
+export { buildAgentCustomTool } from "./agent-tool.js";
+export { ExploreOrchestrator } from "./orchestrator.js";
+export { EXPLORE_ALLOWED_TOOLS, EXPLORE_CHILD_RESOURCE_LOADER_OPTIONS, EXPLORE_EXCLUDE_TOOLS, extrasOutsideExploreAllowlist, filterExploreCustomTools, isExploreAllowedTool, pinExploreToolNames, } from "./tool-policy.js";
+export { EXPLORE_AGENT_NAME, OPERATOR_CHAT_AGENT_TOOL_NAME, } from "./types.js";