@downcity/agent 1.1.7 → 1.1.10

package/src/plugins/web/runtime/Source.ts

@@ -1,263 +0,0 @@
-/**
- * Web Plugin 来源信息与兼容安装动作。
- *
- * 关键点（中文）
- * - 这里不自建联网实现，只检查外部 provider 是否就绪，并记录少量配置。
- */
-
-import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-import fsp from "node:fs/promises";
-import { execa } from "execa";
-import fse from "fs-extra";
-import type { JsonObject } from "@/shared/types/Json.js";
-import type { PluginCommandContext } from "@/shared/types/Plugin.js";
-import type {
-  WebPluginDependencyCheckResult,
-  WebPluginInstallInput,
-} from "@/shared/types/WebPlugin.js";
-import { readWebPluginConfig, writeWebPluginConfig } from "@/plugins/web/runtime/Config.js";
-import { readFileSync } from "node:fs";
-
-const AGENT_BROWSER_PROMPT_FILE_URL = new URL("../PROMPT.agent-browser.txt", import.meta.url);
-
-function toJsonObject(input: Record<string, unknown> | null | undefined): JsonObject {
-  const out: JsonObject = {};
-  if (!input) return out;
-  for (const [key, value] of Object.entries(input)) {
-    if (
-      value === null ||
-      typeof value === "string" ||
-      typeof value === "number" ||
-      typeof value === "boolean"
-    ) {
-      out[key] = value;
-    }
-  }
-  return out;
-}
-
-function resolveWebAccessSkillCandidates(projectRoot: string): string[] {
-  const home = process.env.HOME || "";
-  return [
-    path.join(projectRoot, ".agents", "skills", "web-access", "SKILL.md"),
-    path.join(home, ".agents", "skills", "web-access", "SKILL.md"),
-    path.join(projectRoot, ".claude", "skills", "web-access", "SKILL.md"),
-    path.join(home, ".claude", "skills", "web-access", "SKILL.md"),
-  ].filter(Boolean);
-}
-
-function resolveManagedSkillRoot(projectRoot: string, scope: "user" | "project"): string {
-  if (scope === "project") {
-    return path.join(projectRoot, ".agents", "skills");
-  }
-  return path.join(process.env.HOME || os.homedir(), ".agents", "skills");
-}
-
-function resolveManagedSkillDir(params: {
-  projectRoot: string;
-  scope: "user" | "project";
-  provider: "web-access" | "agent-browser";
-}): string {
-  return path.join(resolveManagedSkillRoot(params.projectRoot, params.scope), params.provider);
-}
-
-function loadBundledAgentBrowserSkillText(): string {
-  try {
-    return readFileSync(AGENT_BROWSER_PROMPT_FILE_URL, "utf-8").trim();
-  } catch {
-    return "# agent-browser\n";
-  }
-}
-
-async function ensureAgentBrowserSkillInstalled(params: {
-  projectRoot: string;
-  scope: "user" | "project";
-}): Promise<string> {
-  const targetDir = resolveManagedSkillDir({
-    projectRoot: params.projectRoot,
-    scope: params.scope,
-    provider: "agent-browser",
-  });
-  const skillPath = path.join(targetDir, "SKILL.md");
-  if (fs.existsSync(skillPath)) {
-    return skillPath;
-  }
-  await fsp.mkdir(targetDir, { recursive: true });
-  await fsp.writeFile(`${skillPath}`, `${loadBundledAgentBrowserSkillText()}\n`, "utf-8");
-  return skillPath;
-}
-
-async function ensureWebAccessSkillInstalled(params: {
-  projectRoot: string;
-  scope: "user" | "project";
-  source?: string;
-}): Promise<string> {
-  const targetDir = resolveManagedSkillDir({
-    projectRoot: params.projectRoot,
-    scope: params.scope,
-    provider: "web-access",
-  });
-  const skillPath = path.join(targetDir, "SKILL.md");
-  if (fs.existsSync(skillPath)) {
-    return skillPath;
-  }
-
-  const source = String(params.source || "").trim();
-  if (source && fs.existsSync(source)) {
-    await fse.copy(path.resolve(source), targetDir, {
-      overwrite: true,
-      errorOnExist: false,
-    });
-    return skillPath;
-  }
-
-  await fsp.mkdir(path.dirname(targetDir), { recursive: true });
-  await execa("git", ["clone", "--depth=1", "https://github.com/eze-is/web-access", targetDir], {
-    reject: true,
-  });
-  return skillPath;
-}
-
-async function checkAgentBrowserCommand(command: string): Promise<boolean> {
-  try {
-    await execa(command, ["--help"], {
-      reject: false,
-      timeout: 15_000,
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * 返回当前来源快照。
- */
-export async function inspectWebPluginDependency(
-  context: PluginCommandContext,
-): Promise<WebPluginDependencyCheckResult> {
-  const config = readWebPluginConfig(context);
-  if (config.provider === "agent-browser") {
-    const available = await checkAgentBrowserCommand(config.browserCommand);
-    return {
-      available,
-      installed: available,
-      reasons: available
-        ? []
-        : [
-            `agent-browser command is not available: ${config.browserCommand}`,
-            "Install or expose the agent-browser CLI before using this provider.",
-          ],
-      details: {
-        provider: config.provider,
-        browserCommand: config.browserCommand,
-        source: "external-project",
-        installScope: config.installScope,
-      },
-    };
-  }
-
-  const candidates = resolveWebAccessSkillCandidates(context.rootPath);
-  const skillPath = candidates.find((item) => fs.existsSync(item));
-  const available = Boolean(skillPath);
-  return {
-    available,
-    installed: available,
-    reasons: available
-      ? []
-      : [
-          "web-access skill is not found.",
-          "Install https://github.com/eze-is/web-access into ~/.agents/skills/web-access or project .agents/skills/web-access.",
-        ],
-    details: {
-      provider: config.provider,
-      source: "external-project",
-      repositoryUrl: config.repositoryUrl,
-      installScope: config.installScope,
-      ...(config.sourceVersion ? { sourceVersion: config.sourceVersion } : {}),
-      ...(skillPath ? { skillPath } : { checkedPaths: candidates }),
-    },
-  };
-}
-
-/**
- * 兼容 install 动作。
- */
-export async function installWebPluginDependency(params: {
-  context: PluginCommandContext;
-  input?: WebPluginInstallInput;
-}): Promise<{
-  success: boolean;
-  message?: string;
-  details?: JsonObject;
-}> {
-  const currentConfig = readWebPluginConfig(params.context);
-  const installScope =
-    params.input?.installScope === "project" || params.input?.installScope === "user"
-      ? params.input.installScope
-      : currentConfig.installScope;
-  const provider =
-    params.input?.provider === "agent-browser" || params.input?.provider === "web-access"
-      ? params.input.provider
-      : currentConfig.provider;
-
-  const installedSkillPath =
-    provider === "agent-browser"
-      ? await ensureAgentBrowserSkillInstalled({
-          projectRoot: params.context.rootPath,
-          scope: installScope,
-        })
-      : await ensureWebAccessSkillInstalled({
-          projectRoot: params.context.rootPath,
-          scope: installScope,
-          source: params.input?.repositoryUrl,
-        });
-
-  const nextConfig = await writeWebPluginConfig({
-    context: params.context,
-    value: {
-      provider,
-      injectPrompt:
-        typeof params.input?.injectPrompt === "boolean"
-          ? params.input.injectPrompt
-          : true,
-      ...(typeof params.input?.repositoryUrl === "string" &&
-      params.input.repositoryUrl.trim()
-        ? { repositoryUrl: params.input.repositoryUrl.trim() }
-        : {}),
-      ...(typeof params.input?.sourceVersion === "string" &&
-      params.input.sourceVersion.trim()
-        ? { sourceVersion: params.input.sourceVersion.trim() }
-        : {}),
-      ...(typeof params.input?.browserCommand === "string" &&
-      params.input.browserCommand.trim()
-        ? { browserCommand: params.input.browserCommand.trim() }
-        : {}),
-      installScope,
-    },
-  });
-  return {
-    success: true,
-    message: "web provider installed and configured",
-    details: toJsonObject({
-      provider: nextConfig.provider,
-      injectPrompt: nextConfig.injectPrompt,
-      repositoryUrl: nextConfig.repositoryUrl,
-      sourceVersion: nextConfig.sourceVersion || "",
-      browserCommand: nextConfig.browserCommand,
-      installScope: nextConfig.installScope,
-      skillPath: installedSkillPath,
-    }),
-  };
-}
-
-/**
- * doctor 结果与 inspect 一致。
- */
-export async function doctorWebPluginDependency(
-  context: PluginCommandContext,
-): Promise<WebPluginDependencyCheckResult> {
-  return inspectWebPluginDependency(context);
-}

package/src/plugins/workboard/Plugin.ts

@@ -1,81 +0,0 @@
-/**
- * Workboard Plugin。
- *
- * 关键点（中文）
- * - workboard 是一个 runtime 观测面板插件，负责提供结构化工作快照。
- * - 当前通过 plugin HTTP 注入暴露 `/api/workboard/snapshot`，供 console 代理与 UI 消费。
- */
-
-import type { Plugin } from "@/shared/types/Plugin.js";
-import { isPluginEnabled } from "@/plugin/Activation.js";
-import { getWorkboardSnapshotStore } from "@/plugins/workboard/runtime/Store.js";
-import type { WorkboardSnapshotResponse } from "@/plugins/workboard/types/Workboard.js";
-
-/**
- * Workboard 插件定义。
- */
-export const workboardPlugin: Plugin = {
-  name: "workboard",
-  title: "Workboard Snapshot",
-  description:
-    "Collects structured runtime activity snapshots so console surfaces can show what the current agent is doing now and what it recently worked on.",
-  availability() {
-    if (!isPluginEnabled({ plugin: workboardPlugin })) {
-      return {
-        enabled: false,
-        available: false,
-        reasons: ["workboard plugin disabled in city config"],
-      };
-    }
-    return {
-      enabled: true,
-      available: true,
-      reasons: [],
-    };
-  },
-  http: {
-    runtime: {
-      authPolicies: [
-        {
-          path: "/api/workboard/*",
-          method: "GET",
-          requireAuth: true,
-          anyPermissions: ["agent.read"],
-        },
-      ],
-      register({ app, getContext }) {
-        app.get("/api/workboard/snapshot", async (c) => {
-          try {
-            const availability = await workboardPlugin.availability?.(getContext());
-            if (availability && availability.available !== true) {
-              return c.json(
-                {
-                  success: false,
-                  error: availability.reasons.join("; ") || "workboard unavailable",
-                },
-                503,
-              );
-            }
-
-            const snapshot = await getWorkboardSnapshotStore({
-              contextResolver: getContext,
-            }).readSnapshot();
-            const payload: WorkboardSnapshotResponse = {
-              success: true,
-              snapshot,
-            };
-            return c.json(payload);
-          } catch (error) {
-            return c.json(
-              {
-                success: false,
-                error: error instanceof Error ? error.message : String(error),
-              },
-              500,
-            );
-          }
-        });
-      },
-    },
-  },
-};

package/src/plugins/workboard/runtime/Collector.ts

@@ -1,78 +0,0 @@
-/**
- * Workboard 快照采集器。
- *
- * 关键点（中文）
- * - 这里只做确定性采集，不引入 LLM 推理。
- * - 内部仍聚合 session、task、service 三类运行事实，但最终只输出对外安全的模糊状态。
- */
-
-import { listTaskDefinitions } from "@/service/builtins/task/Action.js";
-import { listServiceStates } from "@/service/core/Manager.js";
-import { listControlSessionSummaries } from "@/http/control/SessionSummaryStore.js";
-import type { AgentContext } from "@/agent/AgentContextTypes.js";
-import type { WorkboardSnapshot } from "@/plugins/workboard/types/Workboard.js";
-import {
-  buildIdleActivity,
-  toRecentActivity,
-  toRunningActivity,
-  toWorkboardAgentSummary,
-  toWorkboardSignals,
-  toWorkboardSummary,
-} from "@/plugins/workboard/runtime/Normalizer.js";
-
-const WORKBOARD_RECENT_LIMIT = 8;
-
-/**
- * 采集当前 workboard 快照。
- */
-export async function collectWorkboardSnapshot(
-  context: AgentContext,
-): Promise<WorkboardSnapshot> {
-  const collectedAt = new Date().toISOString();
-  const executingSessionIds = new Set(context.session.listExecutingSessionIds());
-  const sessions = await listControlSessionSummaries({
-    projectRoot: context.rootPath,
-    executionContext: context,
-    limit: WORKBOARD_RECENT_LIMIT + Math.max(executingSessionIds.size, 1),
-    executingSessionIds,
-  });
-  const services = listServiceStates();
-  const taskResult = await listTaskDefinitions({ projectRoot: context.rootPath });
-  const degradedCount = services.filter((item) => item.state !== "running").length;
-
-  const current = sessions
-    .filter((item) => item.executing === true)
-    .slice(0, 4)
-    .map((item, index) => toRunningActivity({ item, index }));
-  const recent = sessions
-    .filter((item) => item.executing !== true)
-    .slice(0, WORKBOARD_RECENT_LIMIT)
-    .map((item, index) => toRecentActivity({ item, index }));
-
-  const safeCurrent = current.length > 0
-    ? current
-    : [buildIdleActivity({ updatedAt: collectedAt, recentCount: recent.length })];
-
-  return {
-    agent: toWorkboardAgentSummary({
-      context,
-      collectedAt,
-      currentCount: current.length,
-      recentCount: recent.length,
-      degradedCount,
-    }),
-    summary: toWorkboardSummary({
-      currentCount: current.length,
-      recentCount: recent.length,
-      degradedCount,
-    }),
-    current: safeCurrent,
-    recent,
-    signals: toWorkboardSignals({
-      currentCount: current.length,
-      recentCount: recent.length,
-      services,
-      taskResult,
-    }),
-  };
-}

package/src/plugins/workboard/runtime/Normalizer.ts

@@ -1,213 +0,0 @@
-/**
- * Workboard 结构化归一化工具。
- *
- * 关键点（中文）
- * - 这里负责把内部运行事实投影成“对外模糊公开态”。
- * - 所有会泄漏上下文的字段都必须在这里截断或抽象。
- */
-
-import type { ControlSessionSummary } from "@/shared/types/ControlViewData.js";
-import type { ServiceStateSnapshot } from "@/shared/types/ServiceState.js";
-import type { TaskListResponse } from "@/service/builtins/task/types/TaskCommand.js";
-import type {
-  WorkboardActivityItem,
-  WorkboardAgentSummary,
-  WorkboardSignalItem,
-  WorkboardSummary,
-} from "@/plugins/workboard/types/Workboard.js";
-import type { AgentContext } from "@/agent/AgentContextTypes.js";
-
-function toIsoString(timestamp?: number): string {
-  if (!timestamp || !Number.isFinite(timestamp)) {
-    return new Date().toISOString();
-  }
-  return new Date(timestamp).toISOString();
-}
-
-function buildHeadline(params: {
-  currentCount: number;
-  recentCount: number;
-  degradedCount: number;
-}): string {
-  if (params.currentCount > 0 && params.degradedCount > 0) {
-    return "当前仍在展开，但节奏出现了一些波动";
-  }
-  if (params.currentCount > 1) {
-    return "当前呈现多线展开的状态";
-  }
-  if (params.currentCount === 1) {
-    return "当前呈现稳定展开的状态";
-  }
-  if (params.recentCount > 0) {
-    return "刚刚有过新的进展，现在进入短暂停留";
-  }
-  return "当前处于安静待命的状态";
-}
-
-function buildPosture(params: { currentCount: number; recentCount: number }): string {
-  if (params.currentCount > 1) return "多线展开";
-  if (params.currentCount === 1) return "单线聚焦";
-  if (params.recentCount > 0) return "短暂停留";
-  return "静候下一步";
-}
-
-function buildMomentum(params: { currentCount: number; recentCount: number }): string {
-  if (params.currentCount > 1) return "活跃展开";
-  if (params.currentCount === 1) return "平稳延续";
-  if (params.recentCount > 2) return "轻微起伏";
-  if (params.recentCount > 0) return "余温未散";
-  return "安静";
-}
-
-function buildRunningSummary(item: ControlSessionSummary): string {
-  const messageCount = typeof item.messageCount === "number" ? item.messageCount : 0;
-  if (messageCount >= 24) return "正在延展一段较长的工作脉络，并持续生成新的内容。";
-  if (messageCount >= 8) return "正在承接连续输入，逐步形成新的阶段结果。";
-  if (messageCount > 0) return "正在回应当前输入，并把工作继续向前展开。";
-  return "当前处于活跃展开之中。";
-}
-
-function buildRecentSummary(item: ControlSessionSummary, index: number): string {
-  const messageCount = typeof item.messageCount === "number" ? item.messageCount : 0;
-  if (index === 0 && messageCount > 0) return "刚刚完成一段新的展开，正在短暂停留。";
-  if (messageCount >= 12) return "近期完成了一次较长的内容延展。";
-  if (messageCount > 0) return "近期完成了一次常规更新。";
-  return "近期出现了一次轻微变化。";
-}
-
-/**
- * 构建 agent 顶部公开摘要。
- */
-export function toWorkboardAgentSummary(params: {
-  context: AgentContext;
-  collectedAt: string;
-  currentCount: number;
-  recentCount: number;
-  degradedCount: number;
-}): WorkboardAgentSummary {
-  const statusText = buildHeadline({
-    currentCount: params.currentCount,
-    recentCount: params.recentCount,
-    degradedCount: params.degradedCount,
-  });
-
-  return {
-    name: String(params.context.config.name || "").trim() || "agent",
-    running: true,
-    statusText,
-    collectedAt: params.collectedAt,
-  };
-}
-
-/**
- * 将运行中的 session 映射为对外安全活动项。
- */
-export function toRunningActivity(params: {
-  item: ControlSessionSummary;
-  index: number;
-}): WorkboardActivityItem {
-  const title = params.index === 0 ? "当前主线" : `当前并行线 ${params.index + 1}`;
-
-  return {
-    id: `current:${params.index + 1}`,
-    kind: "focus",
-    title,
-    summary: buildRunningSummary(params.item),
-    status: "active",
-    updatedAt: toIsoString(params.item.updatedAt),
-    tags: ["public", "active"],
-  };
-}
-
-/**
- * 将近期 session 映射为对外安全活动项。
- */
-export function toRecentActivity(params: {
-  item: ControlSessionSummary;
-  index: number;
-}): WorkboardActivityItem {
-  const title = params.index === 0 ? "最近一次更新" : `近期片段 ${params.index + 1}`;
-
-  return {
-    id: `recent:${params.index + 1}`,
-    kind: "progress",
-    title,
-    summary: buildRecentSummary(params.item, params.index),
-    status: params.index === 0 ? "steady" : "waiting",
-    updatedAt: toIsoString(params.item.updatedAt),
-    tags: ["public", "recent"],
-  };
-}
-
-/**
- * 构建空闲占位项。
- */
-export function buildIdleActivity(params: {
-  updatedAt: string;
-  recentCount: number;
-}): WorkboardActivityItem {
-  return {
-    id: "idle:standby",
-    kind: "idle",
-    title: "当前处于安静待命",
-    summary: params.recentCount > 0
-      ? "刚刚有过新的更新，现在等待下一次输入。"
-      : "当前没有明显变化，等待新的触发。",
-    status: "waiting",
-    updatedAt: params.updatedAt,
-    tags: ["public", "idle"],
-  };
-}
-
-/**
- * 构建公开摘要。
- */
-export function toWorkboardSummary(params: {
-  currentCount: number;
-  recentCount: number;
-  degradedCount: number;
-}): WorkboardSummary {
-  return {
-    headline: buildHeadline(params),
-    posture: buildPosture(params),
-    momentum: buildMomentum(params),
-    visibilityNote: "这里展示的是面向外部的概览状态，不包含内部上下文细节。",
-  };
-}
-
-/**
- * 构建对外模糊信号。
- */
-export function toWorkboardSignals(params: {
-  currentCount: number;
-  recentCount: number;
-  services: ServiceStateSnapshot[];
-  taskResult: TaskListResponse;
-}): WorkboardSignalItem[] {
-  const degradedCount = params.services.filter((item) => item.state !== "running").length;
-  const taskCount = Array.isArray(params.taskResult.tasks) ? params.taskResult.tasks.length : 0;
-
-  return [
-    {
-      label: "状态节奏",
-      value: params.currentCount > 1
-        ? "多线展开"
-        : params.currentCount === 1
-          ? "稳定展开"
-          : params.recentCount > 0
-            ? "轻微流动"
-            : "安静待命",
-      tone: params.currentCount > 0 ? "accent" : "neutral",
-    },
-    {
-      label: "现场感受",
-      value: degradedCount > 0 ? "有些波动" : "整体平稳",
-      tone: degradedCount > 0 ? "warning" : "neutral",
-    },
-    {
-      label: "活跃温度",
-      value: taskCount > 0 || params.recentCount > 0 ? "仍有余温" : "较为安静",
-      tone: params.recentCount > 0 ? "accent" : "neutral",
-    },
-  ];
-}