@downcity/agent 1.1.7 → 1.1.10

package/src/plugin/builtins/auth/runtime/AuthorizationStore.ts

@@ -0,0 +1,219 @@
+/**
+ * Auth 授权运行时状态存储。
+ *
+ * 关键点（中文）
+ * - 所有动态状态（观测用户 / 会话）统一落盘到 `.downcity/chat/authorization/state.json`。
+ * - 静态授权配置保存在 console `downcity.db`，不和运行时观测数据混写。
+ */
+
+import fs from "fs-extra";
+import path from "node:path";
+import type {
+  ChatAuthorizationObservedChat,
+  ChatAuthorizationObservedUser,
+  ChatAuthorizationSnapshot,
+  ChatAuthorizationStateFile,
+} from "@/plugin/builtins/auth/types/AuthPlugin.js";
+import type { AgentContext } from "@/agent/AgentContextTypes.js";
+import type { ChatDispatchChannel } from "@/service/builtins/chat/types/ChatDispatcher.js";
+
+function getAuthorizationStatePath(rootPath: string): string {
+  return path.join(rootPath, ".downcity", "chat", "authorization", "state.json");
+}
+
+function normalizeText(value: unknown): string | undefined {
+  const text = String(value || "").trim();
+  return text ? text : undefined;
+}
+
+function buildUserKey(channel: ChatDispatchChannel, userId: string): string {
+  return `${channel}:${userId}`;
+}
+
+function buildChatKey(channel: ChatDispatchChannel, chatId: string): string {
+  return `${channel}:${chatId}`;
+}
+
+function createEmptyState(): ChatAuthorizationStateFile {
+  return {
+    v: 1,
+    updatedAt: Date.now(),
+    usersByKey: {},
+    chatsByKey: {},
+  };
+}
+
+function normalizeObservedUser(
+  input: Partial<ChatAuthorizationObservedUser> | null | undefined,
+): ChatAuthorizationObservedUser | null {
+  if (!input || typeof input !== "object") return null;
+  const channel = normalizeText(input.channel) as ChatDispatchChannel | undefined;
+  const userId = normalizeText(input.userId);
+  if (!channel || !userId) return null;
+  return {
+    v: 1,
+    channel,
+    userId,
+    ...(normalizeText(input.username) ? { username: normalizeText(input.username) } : {}),
+    ...(normalizeText(input.lastChatId) ? { lastChatId: normalizeText(input.lastChatId) } : {}),
+    ...(normalizeText(input.lastChatTitle)
+      ? { lastChatTitle: normalizeText(input.lastChatTitle) }
+      : {}),
+    ...(normalizeText(input.lastChatType)
+      ? { lastChatType: normalizeText(input.lastChatType) }
+      : {}),
+    firstSeenAt:
+      typeof input.firstSeenAt === "number" && Number.isFinite(input.firstSeenAt)
+        ? input.firstSeenAt
+        : Date.now(),
+    lastSeenAt:
+      typeof input.lastSeenAt === "number" && Number.isFinite(input.lastSeenAt)
+        ? input.lastSeenAt
+        : Date.now(),
+  };
+}
+
+function normalizeObservedChat(
+  input: Partial<ChatAuthorizationObservedChat> | null | undefined,
+): ChatAuthorizationObservedChat | null {
+  if (!input || typeof input !== "object") return null;
+  const channel = normalizeText(input.channel) as ChatDispatchChannel | undefined;
+  const chatId = normalizeText(input.chatId);
+  if (!channel || !chatId) return null;
+  return {
+    v: 1,
+    channel,
+    chatId,
+    ...(normalizeText(input.chatTitle) ? { chatTitle: normalizeText(input.chatTitle) } : {}),
+    ...(normalizeText(input.chatType) ? { chatType: normalizeText(input.chatType) } : {}),
+    ...(normalizeText(input.lastActorId)
+      ? { lastActorId: normalizeText(input.lastActorId) }
+      : {}),
+    ...(normalizeText(input.lastActorName)
+      ? { lastActorName: normalizeText(input.lastActorName) }
+      : {}),
+    firstSeenAt:
+      typeof input.firstSeenAt === "number" && Number.isFinite(input.firstSeenAt)
+        ? input.firstSeenAt
+        : Date.now(),
+    lastSeenAt:
+      typeof input.lastSeenAt === "number" && Number.isFinite(input.lastSeenAt)
+        ? input.lastSeenAt
+        : Date.now(),
+  };
+}
+
+function normalizeStateFile(
+  input: Partial<ChatAuthorizationStateFile> | null | undefined,
+): ChatAuthorizationStateFile {
+  const out = createEmptyState();
+  out.updatedAt =
+    typeof input?.updatedAt === "number" && Number.isFinite(input.updatedAt)
+      ? input.updatedAt
+      : Date.now();
+
+  const users = input?.usersByKey;
+  if (users && typeof users === "object") {
+    for (const [key, value] of Object.entries(users)) {
+      const normalized = normalizeObservedUser(value);
+      if (!normalized) continue;
+      out.usersByKey[key] = normalized;
+    }
+  }
+
+  const chats = input?.chatsByKey;
+  if (chats && typeof chats === "object") {
+    for (const [key, value] of Object.entries(chats)) {
+      const normalized = normalizeObservedChat(value);
+      if (!normalized) continue;
+      out.chatsByKey[key] = normalized;
+    }
+  }
+  return out;
+}
+
+async function readState(rootPath: string): Promise<ChatAuthorizationStateFile> {
+  const file = getAuthorizationStatePath(rootPath);
+  const raw = (await fs.readJson(file).catch(() => null)) as Partial<ChatAuthorizationStateFile> | null;
+  return normalizeStateFile(raw);
+}
+
+async function writeState(rootPath: string, state: ChatAuthorizationStateFile): Promise<void> {
+  const file = getAuthorizationStatePath(rootPath);
+  await fs.ensureDir(path.dirname(file));
+  await fs.writeJson(file, state, { spaces: 2 });
+}
+
+function readAuthorizationConfig(
+  context: Pick<AgentContext, "rootPath" | "platform">,
+): ChatAuthorizationSnapshot["config"] {
+  return context.platform.readChatAuthorizationConfig(context.rootPath);
+}
+
+/**
+ * 记录观测到的用户 / 会话。
+ */
+export async function recordObservedAuthorizationPrincipal(params: {
+  context: Pick<AgentContext, "rootPath">;
+  channel: ChatDispatchChannel;
+  chatId: string;
+  chatType?: string;
+  chatTitle?: string;
+  userId?: string;
+  username?: string;
+}): Promise<void> {
+  const chatId = normalizeText(params.chatId);
+  if (!chatId) return;
+  const now = Date.now();
+  const state = await readState(params.context.rootPath);
+
+  const chatKey = buildChatKey(params.channel, chatId);
+  const prevChat = state.chatsByKey[chatKey];
+  state.chatsByKey[chatKey] = {
+    v: 1,
+    channel: params.channel,
+    chatId,
+    ...(normalizeText(params.chatTitle) ? { chatTitle: normalizeText(params.chatTitle) } : {}),
+    ...(normalizeText(params.chatType) ? { chatType: normalizeText(params.chatType) } : {}),
+    ...(normalizeText(params.userId) ? { lastActorId: normalizeText(params.userId) } : {}),
+    ...(normalizeText(params.username) ? { lastActorName: normalizeText(params.username) } : {}),
+    firstSeenAt: prevChat?.firstSeenAt ?? now,
+    lastSeenAt: now,
+  };
+
+  const userId = normalizeText(params.userId);
+  if (userId) {
+    const userKey = buildUserKey(params.channel, userId);
+    const prevUser = state.usersByKey[userKey];
+    state.usersByKey[userKey] = {
+      v: 1,
+      channel: params.channel,
+      userId,
+      ...(normalizeText(params.username) ? { username: normalizeText(params.username) } : {}),
+      lastChatId: chatId,
+      ...(normalizeText(params.chatTitle)
+        ? { lastChatTitle: normalizeText(params.chatTitle) }
+        : {}),
+      ...(normalizeText(params.chatType) ? { lastChatType: normalizeText(params.chatType) } : {}),
+      firstSeenAt: prevUser?.firstSeenAt ?? now,
+      lastSeenAt: now,
+    };
+  }
+
+  state.updatedAt = now;
+  await writeState(params.context.rootPath, state);
+}
+
+/**
+ * 读取授权快照（配置 + 动态状态）。
+ */
+export async function readAuthorizationSnapshot(params: {
+  context: Pick<AgentContext, "rootPath" | "platform">;
+}): Promise<ChatAuthorizationSnapshot> {
+  const state = await readState(params.context.rootPath);
+  return {
+    config: readAuthorizationConfig(params.context),
+    users: Object.values(state.usersByKey).sort((a, b) => b.lastSeenAt - a.lastSeenAt),
+    chats: Object.values(state.chatsByKey).sort((a, b) => b.lastSeenAt - a.lastSeenAt),
+  };
+}

package/src/plugin/builtins/skill/Action.ts

@@ -0,0 +1,159 @@
+/**
+ * skill plugin action helper。
+ *
+ * 关键点（中文）
+ * - 与 runtime tool 解耦：CLI / plugin action / server 都可统一复用。
+ * - `lookup` 采用无状态实现：直接返回 `SKILL.md` 内容，不做 pin 持久化。
+ */
+
+import fs from "fs-extra";
+import path from "node:path";
+import { discoverClaudeSkillsSync } from "@/plugin/builtins/skill/runtime/Discovery.js";
+import { loadDowncityConfig } from "@/config/Config.js";
+import type { ClaudeSkill } from "@/plugin/builtins/skill/types/ClaudeSkill.js";
+import type { JsonValue } from "@/utils/types/Json.js";
+import type {
+  SkillListResponse,
+  SkillLookupRequest,
+  SkillLookupResponse,
+  SkillSummary,
+} from "@/plugin/builtins/skill/types/SkillCommand.js";
+
+function normalizeAllowedTools(input: JsonValue | undefined): string[] {
+  if (!Array.isArray(input)) return [];
+  const values: string[] = [];
+  for (const item of input) {
+    const value = typeof item === "string" ? item.trim() : "";
+    if (!value) continue;
+    values.push(value);
+  }
+  return Array.from(new Set(values));
+}
+
+function toSkillSummary(skill: ClaudeSkill): SkillSummary {
+  return {
+    id: skill.id,
+    name: skill.name,
+    description: skill.description || "",
+    source: skill.source,
+    skillMdPath: skill.skillMdPath,
+    allowedTools: normalizeAllowedTools(skill.allowedTools),
+  };
+}
+
+function findSkillExact(skills: ClaudeSkill[], name: string): ClaudeSkill | null {
+  const q = String(name || "").trim().toLowerCase();
+  if (!q) return null;
+
+  return (
+    skills.find((item) => item.id.toLowerCase() === q) ||
+    skills.find((item) => item.name.toLowerCase() === q) ||
+    null
+  );
+}
+
+function findSkill(skills: ClaudeSkill[], name: string): ClaudeSkill | null {
+  const q = String(name || "").trim().toLowerCase();
+  if (!q) return null;
+
+  return (
+    skills.find((item) => item.id.toLowerCase() === q) ||
+    skills.find((item) => item.name.toLowerCase() === q) ||
+    skills.find((item) => item.name.toLowerCase().includes(q)) ||
+    null
+  );
+}
+
+function getSkills(projectRoot: string): ClaudeSkill[] {
+  const root = path.resolve(projectRoot);
+  const config = loadDowncityConfig(root);
+  return discoverClaudeSkillsSync(root, config);
+}
+
+/**
+ * 在“已学会（本地可发现）”技能里做精确匹配。
+ */
+export function findLearnedSkillExact(
+  projectRoot: string,
+  query: string,
+): SkillSummary | null {
+  const skills = getSkills(projectRoot);
+  const target = findSkillExact(skills, query);
+  return target ? toSkillSummary(target) : null;
+}
+
+/**
+ * 在“已学会（本地可发现）”技能里做模糊搜索。
+ */
+export function searchLearnedSkills(
+  projectRoot: string,
+  query: string,
+  limit: number = 10,
+): SkillSummary[] {
+  const q = String(query || "").trim().toLowerCase();
+  if (!q) return [];
+
+  const skills = getSkills(projectRoot);
+  const matched = skills.filter((item) => {
+    const id = item.id.toLowerCase();
+    const name = item.name.toLowerCase();
+    const description = String(item.description || "").toLowerCase();
+    return id.includes(q) || name.includes(q) || description.includes(q);
+  });
+
+  return matched.slice(0, Math.max(1, limit)).map(toSkillSummary);
+}
+
+/**
+ * 列出当前项目下可发现的全部 skill。
+ */
+export function listSkills(projectRoot: string): SkillListResponse {
+  const skills = getSkills(projectRoot).map(toSkillSummary);
+  return {
+    success: true,
+    skills,
+  };
+}
+
+/**
+ * 读取指定 skill 的正文内容。
+ */
+export async function lookupSkill(params: {
+  /**
+   * 项目根目录。
+   */
+  projectRoot: string;
+  /**
+   * skill lookup 请求。
+   */
+  request: SkillLookupRequest;
+}): Promise<SkillLookupResponse> {
+  const root = path.resolve(params.projectRoot);
+  const skills = getSkills(root);
+  const target = findSkill(skills, params.request.name);
+  if (!target) {
+    return {
+      success: false,
+      error: `Skill not found: ${params.request.name}`,
+    };
+  }
+
+  let content = "";
+  try {
+    content = String(await fs.readFile(target.skillMdPath, "utf-8")).trim();
+  } catch {
+    content = "";
+  }
+  if (!content) {
+    return {
+      success: false,
+      error: `Skill content is empty: ${target.id}`,
+    };
+  }
+
+  return {
+    success: true,
+    skill: toSkillSummary(target),
+    content,
+  };
+}

package/src/plugin/builtins/skill/Command.ts

@@ -0,0 +1,98 @@
+/**
+ * `city skill` 命令 helper。
+ *
+ * 设计目标（中文）
+ * - 尽量不自建 registry：直接复用社区的 `npx skills` 生态（find/install）。
+ * - 同时提供本地视角的 `list`：列出 Downcity 当前能发现的 skills（含 project/home）。
+ */
+
+import path from "node:path";
+import fs from "fs-extra";
+import { execa } from "execa";
+import { discoverClaudeSkillsSync } from "@/plugin/builtins/skill/runtime/Discovery.js";
+import { getClaudeSkillSearchRoots } from "@/plugin/builtins/skill/runtime/Paths.js";
+import { loadDowncityConfig } from "@/config/Config.js";
+
+async function runNpxSkills(args: string[], opts?: { yes?: boolean }): Promise<number> {
+  const yes = opts?.yes !== false;
+  const result = await execa("npx", [yes ? "-y" : "", "skills", ...args].filter(Boolean), {
+    stdio: "inherit",
+  });
+  return result.exitCode ?? 0;
+}
+
+/**
+ * 执行远程 skill 查找。
+ */
+export async function skillFindCommand(query: string): Promise<void> {
+  const q = String(query || "").trim();
+  if (!q) throw new Error("Missing query");
+  await runNpxSkills(["find", q], { yes: true });
+}
+
+/**
+ * skill 安装选项。
+ */
+export interface SkillInstallOptions {
+  /**
+   * 是否执行全局安装。
+   */
+  global?: boolean;
+  /**
+   * 是否跳过交互确认。
+   */
+  yes?: boolean;
+  /**
+   * 安装目标 agent 名称。
+   */
+  agent?: string;
+}
+
+/**
+ * 安装指定 skill。
+ */
+export async function skillInstallCommand(
+  spec: string,
+  options: SkillInstallOptions = {},
+): Promise<void> {
+  const s = String(spec || "").trim();
+  if (!s) throw new Error("Missing spec");
+
+  const args: string[] = ["add", s];
+  const agent = String(options.agent || "claude-code").trim();
+  if (agent) args.push("--agent", agent);
+
+  const yes = options.yes !== false;
+  if (yes) args.push("-y");
+
+  const globalInstall = options.global !== false;
+  if (globalInstall) args.push("-g");
+
+  await runNpxSkills(args, { yes });
+}
+
+/**
+ * 输出当前项目的本地 skill 列表。
+ */
+export async function skillListCommand(cwd: string = "."): Promise<void> {
+  const projectRoot = path.resolve(String(cwd || "."));
+  const shipJson = path.join(projectRoot, "downcity.json");
+  if (!fs.existsSync(shipJson)) {
+    throw new Error(
+      `downcity.json not found at ${shipJson}. Run "city agent create" first or pass the correct path.`,
+    );
+  }
+
+  const config = loadDowncityConfig(projectRoot);
+  const roots = getClaudeSkillSearchRoots(projectRoot, config);
+  const skills = discoverClaudeSkillsSync(projectRoot, config);
+
+  console.log("Skill roots:");
+  for (const root of roots) console.log(`- [${root.source}] ${root.display}`);
+
+  console.log(`\nFound: ${skills.length}`);
+  for (const skill of skills) {
+    const desc = skill.description ? ` — ${skill.description}` : "";
+    console.log(`- [${skill.source}] ${skill.id}: ${skill.name}${desc}`);
+  }
+}

package/src/plugin/builtins/skill/Config.ts

@@ -0,0 +1,51 @@
+/**
+ * skill plugin 配置读取工具。
+ *
+ * 关键点（中文）
+ * - skill 已迁到 plugin 体系，因此发现路径等配置统一从 `plugins.skill` 读取。
+ * - 这里负责把原始 JSON 配置归一化成 runtime 可直接消费的稳定结构。
+ */
+
+import type { DowncityConfig } from "@/config/types/DowncityConfig.js";
+import type {
+  ResolvedSkillPluginConfig,
+  SkillPluginConfig,
+} from "@/plugin/builtins/skill/types/SkillPlugin.js";
+
+/**
+ * skill plugin 默认配置。
+ */
+export const DEFAULT_SKILL_PLUGIN_CONFIG: ResolvedSkillPluginConfig = {
+  paths: [".agents/skills"],
+  allowExternalPaths: false,
+};
+
+/**
+ * 读取并归一化 skill plugin 配置。
+ */
+export function readSkillPluginConfig(
+  config?: DowncityConfig | null,
+): ResolvedSkillPluginConfig {
+  const raw = config?.plugins?.skill;
+  const skillConfig =
+    raw && typeof raw === "object" && !Array.isArray(raw)
+      ? (raw as SkillPluginConfig)
+      : null;
+
+  const normalizedPaths = Array.isArray(skillConfig?.paths)
+    ? skillConfig.paths
+        .map((item) => String(item || "").trim())
+        .filter(Boolean)
+    : [];
+
+  return {
+    paths:
+      normalizedPaths.length > 0
+        ? normalizedPaths
+        : [...DEFAULT_SKILL_PLUGIN_CONFIG.paths],
+    allowExternalPaths:
+      typeof skillConfig?.allowExternalPaths === "boolean"
+        ? skillConfig.allowExternalPaths
+        : DEFAULT_SKILL_PLUGIN_CONFIG.allowExternalPaths,
+  };
+}

package/src/plugin/builtins/skill/PROMPT.ts

@@ -0,0 +1,9 @@
+/**
+ * 自动生成文件，请勿手改。
+ * 源文件：由同路径 `*.ts.txt` 生成。
+ */
+
+// Source: src/plugin/builtins/skill/PROMPT.ts.txt
+const TEXT_MODULE_CONTENT = "# Skill Plugin\n\nskill 是你拥有的技能。用户的提出的需求和任务，你都需要先考虑利用相关的skill来高质量的完成。\n\n\n## 使用\n\n使用技能时需要首先通过 `city skill lookup <name>` 命令载入对应的技能内容。\n\n你也可以使用 `city skill --help` 命令对skill进行其他操作。比如 `list`, `find`, `install`等等。\n";
+
+export default TEXT_MODULE_CONTENT;