@downcity/agent 1.1.74 → 1.1.81

package/src/runtime/control/MessageTimeline.ts

@@ -1,269 +0,0 @@
-/**
- * Control 消息时间线 helper。
- *
- * 关键点（中文）
- * - 负责把上下文消息映射成 control UI 可视时间线。
- * - 同时提供消息文件读取能力。
- */
-
-import fs from "fs-extra";
-import {
-  getToolName,
-  isTextUIPart,
-  isToolUIPart,
-  type UIMessagePart,
-} from "ai";
-import type {
-  SessionMessageV1,
-  SessionMetadataV1,
-} from "@/executor/types/SessionMessages.js";
-import { pickLastSuccessfulChatSendText } from "@/executor/messages/UserVisibleText.js";
-import { extractToolCallsFromUiMessage } from "@/executor/messages/UIMessageTransformer.js";
-import type { ControlTimelineEvent, ControlTimelineRole } from "@/runtime/control/types/ControlViewData.js";
-import { truncateText } from "./CommonHelpers.js";
-
-type AnyUiPart = UIMessagePart<Record<string, never>, Record<string, never>>;
-
-type ToolPartCompatShape = {
-  type?: unknown;
-  state?: unknown;
-  input?: unknown;
-  output?: unknown;
-  errorText?: unknown;
-  error?: unknown;
-  approval?: { reason?: unknown } | null;
-};
-
-function stringifyForDisplay(input: unknown, maxChars = 2400): string {
-  if (input === undefined) return "";
-  if (input === null) return "null";
-  if (typeof input === "string") {
-    const value = input.trim();
-    if (!value) return "";
-    try {
-      const parsed = JSON.parse(value);
-      return truncateText(JSON.stringify(parsed, null, 2), maxChars);
-    } catch {
-      return truncateText(value, maxChars);
-    }
-  }
-  if (typeof input === "number" || typeof input === "boolean") {
-    return truncateText(String(input), maxChars);
-  }
-  try {
-    return truncateText(JSON.stringify(input, null, 2), maxChars);
-  } catch {
-    return truncateText(String(input), maxChars);
-  }
-}
-
-function extractMessageText(parts: unknown): string {
-  if (!Array.isArray(parts)) return "";
-  const texts: string[] = [];
-  for (const part of parts) {
-    if (!part || typeof part !== "object") continue;
-    const p = part as { type?: unknown; text?: unknown };
-    if (p.type !== "text") continue;
-    if (typeof p.text !== "string") continue;
-    const value = p.text.trim();
-    if (!value) continue;
-    texts.push(value);
-  }
-  return texts.join("\n").trim();
-}
-
-function extractAssistantToolSummary(message: SessionMessageV1): string {
-  const toolCalls = extractToolCallsFromUiMessage(message);
-  if (!Array.isArray(toolCalls) || toolCalls.length === 0) return "";
-  const toolNames = Array.from(
-    new Set(toolCalls.map((item) => String(item.tool || "").trim()).filter(Boolean)),
-  );
-  if (toolNames.length === 0) return "";
-  return `[tool] ${toolNames.join(", ")}`;
-}
-
-function resolveToolName(part: ToolPartCompatShape, aiToolName?: string): string {
-  const fromAi = String(aiToolName || "").trim();
-  if (fromAi) return fromAi;
-
-  const rawType = typeof part.type === "string" ? part.type.trim() : "";
-  if (rawType.startsWith("tool-")) return rawType.slice("tool-".length);
-  return "unknown_tool";
-}
-
-function extractToolCallInput(part: ToolPartCompatShape): unknown {
-  return part.input ?? undefined;
-}
-
-function extractToolResultOutput(part: ToolPartCompatShape): unknown {
-  const state = typeof part.state === "string" ? part.state.trim() : "";
-  if (state === "output-available") return part.output;
-  if (state === "output-error") {
-    return { error: part.errorText ?? part.error ?? "tool_error" };
-  }
-  if (state === "output-denied") {
-    return {
-      error: "tool_denied",
-      reason: part.approval?.reason ?? "",
-    };
-  }
-  if (
-    state === "input-available" ||
-    state === "input-streaming" ||
-    state === "output-streaming"
-  ) {
-    return undefined;
-  }
-  return undefined;
-}
-
-function toUiMessageEvent(params: {
-  message: SessionMessageV1;
-  role: ControlTimelineRole;
-  text: string;
-  sequence: number;
-  toolName?: string;
-}): ControlTimelineEvent {
-  const { message, role, text, sequence, toolName } = params;
-  const metadata = (message.metadata || null) as SessionMetadataV1 | null;
-
-  return {
-    id: `${String(message.id || "")}:${sequence}`,
-    role,
-    ...(typeof metadata?.ts === "number" ? { ts: metadata.ts } : {}),
-    ...(typeof metadata?.kind === "string" ? { kind: metadata.kind } : {}),
-    ...(typeof metadata?.source === "string" ? { source: metadata.source } : {}),
-    text,
-    ...(toolName ? { toolName } : {}),
-  };
-}
-
-function resolveUiMessageText(message: SessionMessageV1): string {
-  const plainText = extractMessageText(message.parts);
-  if (plainText) return plainText;
-
-  if (message.role !== "assistant") return "";
-
-  const userVisible = pickLastSuccessfulChatSendText(message).trim();
-  if (userVisible) return userVisible;
-
-  return extractAssistantToolSummary(message);
-}
-
-/**
- * 转成 control 时间线。
- */
-export function toUiMessageTimeline(
-  message: SessionMessageV1,
-): ControlTimelineEvent[] {
-  if (message.role !== "assistant") {
-    return [
-      toUiMessageEvent({
-        message,
-        role: message.role,
-        text: resolveUiMessageText(message),
-        sequence: 0,
-      }),
-    ];
-  }
-
-  const parts = Array.isArray(message.parts)
-    ? (message.parts as AnyUiPart[])
-    : [];
-  const events: ControlTimelineEvent[] = [];
-  let sequence = 0;
-
-  for (const part of parts) {
-    if (!part || typeof part !== "object") continue;
-    const partObject = part as ToolPartCompatShape;
-
-    if (isTextUIPart(part)) {
-      const text = String(part.text || "").trim();
-      if (!text) continue;
-      events.push(
-        toUiMessageEvent({
-          message,
-          role: "assistant",
-          text,
-          sequence,
-        }),
-      );
-      sequence += 1;
-      continue;
-    }
-
-    if (isToolUIPart(part)) {
-      const toolName = resolveToolName(partObject, String(getToolName(part) || ""));
-      const inputText = stringifyForDisplay(extractToolCallInput(partObject));
-      events.push(
-        toUiMessageEvent({
-          message,
-          role: "tool-call",
-          text: inputText || "(empty)",
-          sequence,
-          toolName,
-        }),
-      );
-      sequence += 1;
-
-      const output = extractToolResultOutput(partObject);
-      if (output !== undefined) {
-        events.push(
-          toUiMessageEvent({
-            message,
-            role: "tool-result",
-            text: stringifyForDisplay(output) || "(empty)",
-            sequence,
-            toolName,
-          }),
-        );
-        sequence += 1;
-      }
-      continue;
-    }
-  }
-
-  // 关键点（中文）：assistant 若没有文本 part，也要保留一条可见事件，避免 control UI 空白。
-  if (events.length === 0) {
-    events.push(
-      toUiMessageEvent({
-        message,
-        role: "assistant",
-        text: resolveUiMessageText(message),
-        sequence: 0,
-      }),
-    );
-  }
-
-  return events;
-}
-
-/**
- * 读取 session 消息文件。
- */
-export async function loadSessionMessagesFromFile(
-  filePath: string,
-): Promise<SessionMessageV1[]> {
-  if (!(await fs.pathExists(filePath))) return [];
-  const raw = await fs.readFile(filePath, "utf-8");
-  const lines = raw.split("\n").filter(Boolean);
-  const out: SessionMessageV1[] = [];
-  for (const line of lines) {
-    try {
-      const item = JSON.parse(line) as SessionMessageV1;
-      if (!item || typeof item !== "object") continue;
-      if (item.role !== "user" && item.role !== "assistant") continue;
-      out.push(item);
-    } catch {
-      // 关键点（中文）：单行损坏不应影响整体可读性。
-    }
-  }
-  return out;
-}
-
-/**
- * 读取适合摘要展示的消息预览文本。
- */
-export function resolveUiMessagePreview(message: SessionMessageV1): string {
-  return resolveUiMessageText(message);
-}

package/src/runtime/control/SessionSummaryStore.ts

@@ -1,72 +0,0 @@
-/**
- * Control 会话摘要读取 helper。
- *
- * 关键点（中文）
- * - 负责会话列表聚合。
- * - 只返回控制面视图需要的摘要字段。
- */
-
-import fs from "fs-extra";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-import {
-  getDowncitySessionMessagesPath,
-  getDowncitySessionRootDirPath,
-} from "@/config/Paths.js";
-import type { ControlSessionSummary } from "@/runtime/control/types/ControlViewData.js";
-import { decodeMaybe, truncateText } from "./CommonHelpers.js";
-import { loadSessionMessagesFromFile, resolveUiMessagePreview } from "./MessageTimeline.js";
-
-/**
- * 枚举控制面所需的 session 摘要。
- */
-export async function listControlSessionSummaries(params: {
-  projectRoot: string;
-  agentId: string;
-  executionContext?: AgentContext;
-  limit: number;
-  executingSessionIds?: Set<string>;
-}): Promise<ControlSessionSummary[]> {
-  const rootDir = getDowncitySessionRootDirPath(
-    params.projectRoot,
-    params.agentId,
-  );
-  if (!(await fs.pathExists(rootDir))) return [];
-
-  const entries = await fs.readdir(rootDir, { withFileTypes: true });
-  const items: ControlSessionSummary[] = [];
-
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const sessionId = decodeMaybe(entry.name);
-    if (!sessionId) continue;
-
-    const filePath = getDowncitySessionMessagesPath(
-      params.projectRoot,
-      params.agentId,
-      sessionId,
-    );
-    const messages = await loadSessionMessagesFromFile(filePath);
-    const last = messages.at(-1);
-    const lastTs =
-      typeof last?.metadata?.ts === "number" ? last.metadata.ts : undefined;
-    const stat = await fs
-      .stat(filePath)
-      .then((s) => s)
-      .catch(() => null);
-    const updatedAt = lastTs || (stat ? stat.mtimeMs : undefined);
-
-    items.push({
-      sessionId,
-      messageCount: messages.length,
-      ...(typeof updatedAt === "number" ? { updatedAt } : {}),
-      ...(last?.role ? { lastRole: last.role } : {}),
-      ...(last
-        ? { lastText: truncateText(resolveUiMessagePreview(last), 180) }
-        : {}),
-      ...(params.executingSessionIds?.has(sessionId) ? { executing: true } : {}),
-    });
-  }
-
-  items.sort((a, b) => (b.updatedAt || 0) - (a.updatedAt || 0));
-  return items.slice(0, params.limit);
-}

package/src/runtime/control/TaskStore.ts

@@ -1,242 +0,0 @@
-/**
- * Control 任务与日志数据 helper。
- *
- * 关键点（中文）
- * - 聚合 logs 与 task runs 读取逻辑。
- * - 仅负责磁盘侧读取与 control UI 视图映射。
- */
-
-import fs from "fs-extra";
-import path from "node:path";
-import { getLogsDirPath, getDowncityTasksDirPath } from "@/config/Paths.js";
-import type {
-  ControlLogEntry,
-  ControlTaskRunDetail,
-  ControlTaskRunSummary,
-} from "@/runtime/control/types/ControlViewData.js";
-import { truncateText } from "./CommonHelpers.js";
-import { loadSessionMessagesFromFile, toUiMessageTimeline } from "./MessageTimeline.js";
-
-export const TASK_RUN_DIR_REGEX = /^\d{8}-\d{6}-\d{3}$/;
-const TASK_ID_REGEXP = /^[\p{L}\p{N}][\p{L}\p{N}_\-\s]{0,63}$/u;
-
-function normalizeTaskId(input: string): string {
-  const id = String(input || "").trim();
-  if (!TASK_ID_REGEXP.test(id)) {
-    throw new Error(`Invalid taskId: "${id}"`);
-  }
-  return id;
-}
-
-function deriveTaskIdFromTitle(title: string): string {
-  const normalized = String(title || "")
-    .normalize("NFKC")
-    .replace(/[\\/:\u0000]/g, " ")
-    .replace(/[^\p{L}\p{N}_\-\s]/gu, " ")
-    .replace(/\s+/g, " ")
-    .trim()
-    .slice(0, 64)
-    .trim();
-  return normalizeTaskId(normalized);
-}
-
-/**
- * 读取近期日志。
- */
-export async function readRecentLogs(params: {
-  projectRoot: string;
-  limit: number;
-}): Promise<ControlLogEntry[]> {
-  const logsDir = getLogsDirPath(params.projectRoot);
-  if (!(await fs.pathExists(logsDir))) return [];
-
-  const files = (await fs.readdir(logsDir, { withFileTypes: true }))
-    .filter((x) => x.isFile() && x.name.endsWith(".jsonl"))
-    .map((x) => x.name)
-    .sort()
-    .reverse();
-
-  const out: ControlLogEntry[] = [];
-
-  for (const fileName of files) {
-    if (out.length >= params.limit) break;
-    const abs = path.join(logsDir, fileName);
-    const raw = await fs.readFile(abs, "utf-8").catch(() => "");
-    const lines = raw.split("\n").filter(Boolean);
-
-    for (let index = lines.length - 1; index >= 0; index -= 1) {
-      if (out.length >= params.limit) break;
-      try {
-        const parsed = JSON.parse(lines[index]) as ControlLogEntry;
-        if (!parsed || typeof parsed !== "object") continue;
-        out.push({
-          ...(typeof parsed.timestamp === "string" ? { timestamp: parsed.timestamp } : {}),
-          ...(typeof parsed.type === "string" ? { type: parsed.type } : {}),
-          ...(typeof parsed.level === "string" ? { level: parsed.level } : {}),
-          ...(typeof parsed.message === "string" ? { message: parsed.message } : {}),
-          ...(parsed.details && typeof parsed.details === "object"
-            ? { details: parsed.details }
-            : {}),
-        });
-      } catch {
-        // ignore
-      }
-    }
-  }
-
-  return out;
-}
-
-async function resolveTaskDir(projectRoot: string, title: string): Promise<string> {
-  const taskId = deriveTaskIdFromTitle(title);
-  return path.join(getDowncityTasksDirPath(projectRoot), taskId);
-}
-
-/**
- * 枚举任务运行摘要。
- */
-export async function listTaskRuns(params: {
-  projectRoot: string;
-  title: string;
-  limit: number;
-}): Promise<ControlTaskRunSummary[]> {
-  const taskDir = await resolveTaskDir(params.projectRoot, params.title);
-  if (!(await fs.pathExists(taskDir))) return [];
-
-  const entries = await fs.readdir(taskDir, { withFileTypes: true });
-  const timestamps = entries
-    .filter((x) => x.isDirectory() && TASK_RUN_DIR_REGEX.test(x.name))
-    .map((x) => x.name)
-    .sort()
-    .reverse()
-    .slice(0, params.limit);
-
-  const out: ControlTaskRunSummary[] = [];
-
-  for (const timestamp of timestamps) {
-    const runDir = path.join(taskDir, timestamp);
-    const metaPath = path.join(runDir, "run.json");
-    const progressPath = path.join(runDir, "run-progress.json");
-    const runDirRel = path.relative(params.projectRoot, runDir).split(path.sep).join("/");
-    const meta = (await fs.readJson(metaPath).catch(() => null)) as {
-      status?: string;
-      executionStatus?: string;
-      resultStatus?: string;
-      startedAt?: number;
-      endedAt?: number;
-      dialogueRounds?: number;
-      userSimulatorSatisfied?: boolean;
-      error?: string;
-    } | null;
-    const progress = (await fs.readJson(progressPath).catch(() => null)) as {
-      status?: string;
-      phase?: string;
-      message?: string;
-      updatedAt?: number;
-      round?: number;
-      maxRounds?: number;
-    } | null;
-
-    const progressStatus =
-      typeof progress?.status === "string" ? progress.status : undefined;
-    const inProgress =
-      progressStatus === "running" ||
-      (!meta && (await fs.pathExists(progressPath)));
-    const displayStatus =
-      inProgress
-        ? "running"
-        : typeof meta?.status === "string"
-          ? meta.status
-          : progressStatus;
-
-    out.push({
-      timestamp,
-      ...(typeof displayStatus === "string" ? { status: displayStatus } : {}),
-      ...(typeof meta?.executionStatus === "string" ? { executionStatus: meta.executionStatus } : {}),
-      ...(typeof meta?.resultStatus === "string" ? { resultStatus: meta.resultStatus } : {}),
-      ...(inProgress ? { inProgress: true } : {}),
-      ...(typeof progress?.phase === "string" ? { progressPhase: progress.phase } : {}),
-      ...(typeof progress?.message === "string" ? { progressMessage: progress.message } : {}),
-      ...(typeof progress?.updatedAt === "number" ? { progressUpdatedAt: progress.updatedAt } : {}),
-      ...(typeof progress?.round === "number" ? { progressRound: progress.round } : {}),
-      ...(typeof progress?.maxRounds === "number" ? { progressMaxRounds: progress.maxRounds } : {}),
-      ...(typeof meta?.startedAt === "number" ? { startedAt: meta.startedAt } : {}),
-      ...(typeof meta?.endedAt === "number" ? { endedAt: meta.endedAt } : {}),
-      ...(typeof meta?.dialogueRounds === "number" ? { dialogueRounds: meta.dialogueRounds } : {}),
-      ...(typeof meta?.userSimulatorSatisfied === "boolean"
-        ? { userSimulatorSatisfied: meta.userSimulatorSatisfied }
-        : {}),
-      ...(typeof meta?.error === "string" ? { error: meta.error } : {}),
-      runDirRel,
-    });
-  }
-
-  return out;
-}
-
-/**
- * 读取任务运行详情。
- */
-export async function readTaskRunDetail(params: {
-  projectRoot: string;
-  title: string;
-  timestamp: string;
-}): Promise<ControlTaskRunDetail | null> {
-  const taskDir = await resolveTaskDir(params.projectRoot, params.title);
-  const runDir = path.join(taskDir, params.timestamp);
-  if (!(await fs.pathExists(runDir))) return null;
-
-  const readText = async (name: string, maxChars = 80_000): Promise<string | undefined> => {
-    const abs = path.join(runDir, name);
-    if (!(await fs.pathExists(abs))) return undefined;
-    const raw = await fs.readFile(abs, "utf-8").catch(() => "");
-    return truncateText(raw, maxChars);
-  };
-
-  const readJson = async <T>(name: string): Promise<T | undefined> => {
-    const abs = path.join(runDir, name);
-    if (!(await fs.pathExists(abs))) return undefined;
-    return (await fs.readJson(abs).catch(() => undefined)) as T | undefined;
-  };
-
-  const messagesPath = path.join(runDir, "messages.jsonl");
-  const messages = await loadSessionMessagesFromFile(messagesPath);
-  const progress = await readJson<{
-    status?: string;
-    phase?: string;
-    message?: string;
-    startedAt?: number;
-    updatedAt?: number;
-    endedAt?: number;
-    round?: number;
-    maxRounds?: number;
-    runStatus?: string;
-    executionStatus?: string;
-    resultStatus?: string;
-    events?: Array<{
-      at?: number;
-      phase?: string;
-      message?: string;
-      round?: number;
-      maxRounds?: number;
-    }>;
-  }>("run-progress.json");
-  const outputText = (await readText("output.md")) || (await readText("result.md"));
-
-  return {
-    title: params.title,
-    timestamp: params.timestamp,
-    runDirRel: path.relative(params.projectRoot, runDir).split(path.sep).join("/"),
-    meta: await readJson<Record<string, unknown>>("run.json"),
-    ...(progress ? { progress } : {}),
-    dialogue: await readJson<Record<string, unknown>>("dialogue.json"),
-    artifacts: {
-      input: await readText("input.md"),
-      output: outputText,
-      result: await readText("result.md"),
-      dialogue: await readText("dialogue.md"),
-      error: await readText("error.md"),
-    },
-    messages: messages.slice(-120).flatMap((message) => toUiMessageTimeline(message)),
-  };
-}

package/src/runtime/control/types/AuthControl.ts

@@ -1,34 +0,0 @@
-/**
- * Auth Control 类型定义。
- *
- * 关键点（中文）
- * - 统一承载控制面 authorization 页面需要的返回结构。
- * - 这是控制面 UI 数据类型，不属于 auth plugin 内核协议。
- */
-
-import type { JsonObject } from "@/types/common/Json.js";
-
-/**
- * authorization 页面完整载荷。
- */
-export interface AuthControlPayload {
-  /**
-   * 后端提供的授权目录定义。
-   */
-  catalog: JsonObject;
-
-  /**
-   * 当前静态授权配置。
-   */
-  config: JsonObject;
-
-  /**
-   * 已观测用户列表。
-   */
-  users: JsonObject[];
-
-  /**
-   * 已观测会话列表。
-   */
-  chats: JsonObject[];
-}