@downcity/agent 1.1.32 → 1.1.35

package/bin/plugin/builtins/shell/runtime/ShellActionRuntimeSupport.d.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 统一承载 ShellActionRuntime 的内部共享逻辑：环境组装、持久化、waiter 协调、session 查找。
- * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 service action 编排。
+ * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 plugin action 编排。
  */
 import type { AgentContext } from "../../../../core/AgentContextTypes.js";
 import type { ShellPluginState, ShellSessionRuntimeState } from "../../../../plugin/builtins/shell/ShellRuntimeTypes.js";
@@ -23,7 +23,7 @@ export declare const DEFAULT_WAIT_TIMEOUT_MS = 10000;
  */
 export declare const DEFAULT_EXEC_TIMEOUT_MS = 60000;
 /**
- * 创建 shell service 初始状态。
+ * 创建 shell plugin runtime 初始状态。
  */
 export declare function createShellPluginState(): ShellPluginState;
 /**

package/bin/plugin/builtins/shell/runtime/ShellActionRuntimeSupport.js

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 统一承载 ShellActionRuntime 的内部共享逻辑：环境组装、持久化、waiter 协调、session 查找。
- * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 service action 编排。
+ * - 对外暴露给 ShellActionRuntime 的只有纯运行时辅助函数，不直接承担 plugin action 编排。
  */
 import path from "node:path";
 import fs from "fs-extra";
@@ -30,7 +30,7 @@ export const DEFAULT_WAIT_TIMEOUT_MS = 10_000;
  */
 export const DEFAULT_EXEC_TIMEOUT_MS = 60_000;
 /**
- * 创建 shell service 初始状态。
+ * 创建 shell plugin runtime 初始状态。
  */
 export function createShellPluginState() {
     return {

package/bin/plugin/builtins/shell/runtime/ShellProcessEvents.d.ts

@@ -11,7 +11,7 @@ import type { ShellPluginState, ShellSessionRuntimeState } from "../../../../plu
  */
 export declare function attachShellProcessEventHandlers(params: {
     /**
-     * 当前 shell service 状态。
+     * 当前 shell plugin runtime 状态。
      */
     state: ShellPluginState;
     /**

package/bin/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.js

@@ -7,7 +7,7 @@
  */
 import path from "node:path";
 import { stripInvocationAuthEnv } from "../../../../runtime/server/http/auth/AuthEnv.js";
-import { getSessionRunScope } from "../../../../session/SessionRunScope.js";
+import { getSessionRunScope } from "../../../../executor/SessionRunScope.js";
 /**
  * 构造 shell 子进程环境变量。
  */

package/bin/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"ShellRuntimeEnvironment.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ShellRuntimeEnvironment.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/shell/runtime/ShellRuntimeEnvironment.ts"],"names":[],"mappings":"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"}

package/bin/plugin/builtins/shell/types/ShellPlugin.d.ts

@@ -1,9 +1,9 @@
 /**
- * Shell service 类型定义。
+ * Shell plugin runtime 类型定义。
  *
  * 关键点（中文）
  * - `shell_id` 是 shell 会话的唯一标识，与 chat `sessionId` 严格区分。
- * - 这些类型同时服务于 service 层状态管理与 agent tool 协议。
+ * - 这些类型同时服务于 shell runtime 状态管理与 agent tool 协议。
  */
 export type ShellSessionStatus = "starting" | "running" | "completed" | "failed" | "killed" | "expired";
 /**
@@ -25,7 +25,7 @@ export type ShellExternalRef = {
  * shell 会话快照。
  *
  * 说明（中文）
- * - 该对象是 shell service 对外暴露的统一状态视图。
+ * - 该对象是 shell plugin runtime 对外暴露的统一状态视图。
  * - 内部运行态（child process / waiter 集合）不会暴露给上层。
  */
 export type ShellSessionSnapshot = {
@@ -203,7 +203,7 @@ export type ShellOutputChunk = {
     hasMoreOutput: boolean;
 };
 /**
- * shell service 对 agent tool 返回的统一数据结构。
+ * shell plugin runtime 对 agent tool 返回的统一数据结构。
  */
 export type ShellActionResponse = {
     /** shell 当前快照。 */

package/bin/plugin/builtins/shell/types/ShellPlugin.js

@@ -1,9 +1,9 @@
 /**
- * Shell service 类型定义。
+ * Shell plugin runtime 类型定义。
  *
  * 关键点（中文）
  * - `shell_id` 是 shell 会话的唯一标识，与 chat `sessionId` 严格区分。
- * - 这些类型同时服务于 service 层状态管理与 agent tool 协议。
+ * - 这些类型同时服务于 shell runtime 状态管理与 agent tool 协议。
  */
 export {};
 //# sourceMappingURL=ShellPlugin.js.map

package/bin/plugin/builtins/skill/Plugin.d.ts

@@ -4,11 +4,15 @@
  * 关键点（中文）
  * - skill 不再作为 service 存在，而是作为显式 action + system 提供者接入 plugin 体系。
  * - `find/install/list/lookup` 全部通过 plugin actions 暴露。
- * - skills overview 文本通过 `plugin.system` 注入，不再依赖 service.system。
+ * - skills overview 文本通过 `plugin.system` 注入，不再依赖 plugin.system。
  */
-import type { Plugin } from "../../../plugin/types/Plugin.js";
+import type { AgentRuntime } from "../../../core/AgentCoreTypes.js";
+import { BasePlugin } from "../../../plugin/core/BasePlugin.js";
 /**
- * skillPlugin：技能发现、安装、读取与 system 注入。
+ * SkillPlugin：技能发现、安装、读取与 system 注入。
  */
-export declare const skillPlugin: Plugin;
+export declare class SkillPlugin extends BasePlugin {
+    readonly name = "skill";
+    constructor(agent?: AgentRuntime | null);
+}
 //# sourceMappingURL=Plugin.d.ts.map

package/bin/plugin/builtins/skill/Plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAmFvD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MA8OzB,CAAC"}
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/skill/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAsUzD;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,QAAQ,CAAC,IAAI,WAAW;gBAEZ,KAAK,GAAE,YAAY,GAAG,IAAW;CAI9C"}

package/bin/plugin/builtins/skill/Plugin.js

@@ -4,8 +4,9 @@
  * 关键点（中文）
  * - skill 不再作为 service 存在，而是作为显式 action + system 提供者接入 plugin 体系。
  * - `find/install/list/lookup` 全部通过 plugin actions 暴露。
- * - skills overview 文本通过 `plugin.system` 注入，不再依赖 service.system。
+ * - skills overview 文本通过 `plugin.system` 注入，不再依赖 plugin.system。
  */
+import { BasePlugin } from "../../../plugin/core/BasePlugin.js";
 import { isPluginEnabled } from "../../../plugin/core/Activation.js";
 import { SKILL_PLUGIN_ACTIONS } from "../../../plugin/builtins/skill/types/SkillPlugin.js";
 import { DEFAULT_SKILL_PLUGIN_CONFIG, } from "../../../plugin/builtins/skill/Config.js";
@@ -62,240 +63,249 @@ function inferSkillQueryFromSpec(spec) {
         return normalized;
     return "";
 }
-/**
- * skillPlugin：技能发现、安装、读取与 system 注入。
- */
-export const skillPlugin = {
-    name: "skill",
-    title: "Skill Catalog And Loader",
-    description: "Finds, installs, lists, and reads local skills, and injects the current skill overview into system prompts so the agent knows what capabilities are available.",
-    config: {
-        plugin: "skill",
-        scope: "project",
-        defaultValue: {
-            ...DEFAULT_SKILL_PLUGIN_CONFIG,
+function createSkillPluginDefinition(plugin) {
+    return {
+        name: "skill",
+        title: "Skill Catalog And Loader",
+        description: "Finds, installs, lists, and reads local skills, and injects the current skill overview into system prompts so the agent knows what capabilities are available.",
+        config: {
+            plugin: "skill",
+            scope: "project",
+            defaultValue: {
+                ...DEFAULT_SKILL_PLUGIN_CONFIG,
+            },
         },
-    },
-    availability(context) {
-        if (!isPluginEnabled({ plugin: skillPlugin, context })) {
+        availability(context) {
+            if (!isPluginEnabled({ plugin, context })) {
+                return {
+                    enabled: false,
+                    available: false,
+                    reasons: ["skill plugin disabled in city config"],
+                };
+            }
             return {
-                enabled: false,
-                available: false,
-                reasons: ["skill plugin disabled in city config"],
+                enabled: true,
+                available: true,
+                reasons: [],
             };
-        }
-        return {
-            enabled: true,
-            available: true,
-            reasons: [],
-        };
-    },
-    async system(context) {
-        const dynamicText = String(await buildSkillsSystemText(context)).trim();
-        return [SKILL_PLUGIN_PROMPT, dynamicText].filter(Boolean).join("\n\n");
-    },
-    actions: {
-        [SKILL_PLUGIN_ACTIONS.find]: {
-            command: {
-                description: "查找 `list` 中不存在的未学会 skills（缺失时再 install）",
-                configure(command) {
-                    command.argument("<query>");
-                },
-                mapInput({ args }) {
-                    const query = String(args[0] || "").trim();
-                    if (!query)
-                        throw new Error("Missing query");
-                    return { query };
+        },
+        async system(context) {
+            const dynamicText = String(await buildSkillsSystemText(context)).trim();
+            return [SKILL_PLUGIN_PROMPT, dynamicText].filter(Boolean).join("\n\n");
+        },
+        actions: {
+            [SKILL_PLUGIN_ACTIONS.find]: {
+                command: {
+                    description: "查找 `list` 中不存在的未学会 skills（缺失时再 install）",
+                    configure(command) {
+                        command.argument("<query>");
+                    },
+                    mapInput({ args }) {
+                        const query = String(args[0] || "").trim();
+                        if (!query)
+                            throw new Error("Missing query");
+                        return { query };
+                    },
                 },
-            },
-            async execute(params) {
-                const payload = params.payload;
-                const rootPath = params.context.rootPath;
-                const exactLearned = findLearnedSkillExact(rootPath, payload.query);
-                if (exactLearned) {
+                async execute(params) {
+                    const payload = params.payload;
+                    const rootPath = params.context.rootPath;
+                    const exactLearned = findLearnedSkillExact(rootPath, payload.query);
+                    if (exactLearned) {
+                        return {
+                            success: true,
+                            data: {
+                                query: payload.query,
+                                message: "该技能已在 list 中，无需 install。使用前请先执行 lookup。",
+                                workflow: ["list", "lookup"],
+                                nextAction: "lookup",
+                                learnedSkill: exactLearned,
+                                learnedHints: [],
+                            },
+                        };
+                    }
+                    const learnedHints = searchLearnedSkills(rootPath, payload.query, 5);
+                    await skillFindCommand(payload.query);
                     return {
                         success: true,
                         data: {
                             query: payload.query,
-                            message: "该技能已在 list 中，无需 install。使用前请先执行 lookup。",
-                            workflow: ["list", "lookup"],
-                            nextAction: "lookup",
-                            learnedSkill: exactLearned,
-                            learnedHints: [],
+                            message: "已执行缺失技能检索；若目标不在 list 中，可 install 后再 lookup。",
+                            workflow: ["find", "install", "lookup"],
+                            nextAction: "install",
+                            learnedSkill: null,
+                            learnedHints,
                         },
                     };
-                }
-                const learnedHints = searchLearnedSkills(rootPath, payload.query, 5);
-                await skillFindCommand(payload.query);
-                return {
-                    success: true,
-                    data: {
-                        query: payload.query,
-                        message: "已执行缺失技能检索；若目标不在 list 中，可 install 后再 lookup。",
-                        workflow: ["find", "install", "lookup"],
-                        nextAction: "install",
-                        learnedSkill: null,
-                        learnedHints,
-                    },
-                };
-            },
-        },
-        [SKILL_PLUGIN_ACTIONS.install]: {
-            command: {
-                description: "安装 `list` 中不存在的 skill（完成后请先 lookup）",
-                configure(command) {
-                    command
-                        .argument("<spec>")
-                        .option("-g, --global", "全局安装（默认 true）", true)
-                        .option("-y, --yes", "跳过确认（默认 true）", true)
-                        .option("--agent <agent>", "指定 agent", "claude-code");
-                },
-                mapInput({ args, opts }) {
-                    const spec = String(args[0] || "").trim();
-                    if (!spec)
-                        throw new Error("Missing spec");
-                    return {
-                        spec,
-                        global: getBooleanOpt(opts, "global"),
-                        yes: getBooleanOpt(opts, "yes"),
-                        agent: getStringOpt(opts, "agent"),
-                    };
                 },
             },
-            async execute(params) {
-                const payload = params.payload;
-                const rootPath = params.context.rootPath;
-                const queryFromSpec = inferSkillQueryFromSpec(payload.spec);
-                const beforeList = listSkills(rootPath).skills;
-                const beforeIds = new Set(beforeList.map((item) => item.id));
-                const learnedBefore = findLearnedSkillExact(rootPath, queryFromSpec) ||
-                    findLearnedSkillExact(rootPath, payload.spec);
-                if (learnedBefore) {
+            [SKILL_PLUGIN_ACTIONS.install]: {
+                command: {
+                    description: "安装 `list` 中不存在的 skill（完成后请先 lookup）",
+                    configure(command) {
+                        command
+                            .argument("<spec>")
+                            .option("-g, --global", "全局安装（默认 true）", true)
+                            .option("-y, --yes", "跳过确认（默认 true）", true)
+                            .option("--agent <agent>", "指定 agent", "claude-code");
+                    },
+                    mapInput({ args, opts }) {
+                        const spec = String(args[0] || "").trim();
+                        if (!spec)
+                            throw new Error("Missing spec");
+                        return {
+                            spec,
+                            global: getBooleanOpt(opts, "global"),
+                            yes: getBooleanOpt(opts, "yes"),
+                            agent: getStringOpt(opts, "agent"),
+                        };
+                    },
+                },
+                async execute(params) {
+                    const payload = params.payload;
+                    const rootPath = params.context.rootPath;
+                    const queryFromSpec = inferSkillQueryFromSpec(payload.spec);
+                    const beforeList = listSkills(rootPath).skills;
+                    const beforeIds = new Set(beforeList.map((item) => item.id));
+                    const learnedBefore = findLearnedSkillExact(rootPath, queryFromSpec) ||
+                        findLearnedSkillExact(rootPath, payload.spec);
+                    if (learnedBefore) {
+                        return {
+                            success: true,
+                            data: {
+                                spec: payload.spec,
+                                skipped: true,
+                                message: "技能已在 list 中，无需 install。使用前请先执行 lookup。",
+                                workflow: ["list", "lookup"],
+                                nextAction: "lookup",
+                                queryFromSpec,
+                                addedSkills: [],
+                                learnedSkill: learnedBefore,
+                            },
+                        };
+                    }
+                    await skillInstallCommand(payload.spec, {
+                        global: payload.global,
+                        yes: payload.yes,
+                        agent: payload.agent,
+                    });
+                    const afterList = listSkills(rootPath).skills;
+                    const addedSkills = afterList.filter((item) => !beforeIds.has(item.id));
+                    const learnedAfter = findLearnedSkillExact(rootPath, queryFromSpec) ||
+                        findLearnedSkillExact(rootPath, payload.spec) ||
+                        (addedSkills.length === 1 ? addedSkills[0] : undefined);
                     return {
                         success: true,
                         data: {
                             spec: payload.spec,
-                            skipped: true,
-                            message: "技能已在 list 中，无需 install。使用前请先执行 lookup。",
-                            workflow: ["list", "lookup"],
+                            message: "技能学习完成。使用技能前请先执行 lookup 读取该技能的 SKILL.md 内容。",
+                            workflow: ["find", "install", "lookup"],
                             nextAction: "lookup",
+                            skipped: false,
                             queryFromSpec,
-                            addedSkills: [],
-                            learnedSkill: learnedBefore,
+                            addedSkills,
+                            learnedSkill: learnedAfter || null,
                         },
                     };
-                }
-                await skillInstallCommand(payload.spec, {
-                    global: payload.global,
-                    yes: payload.yes,
-                    agent: payload.agent,
-                });
-                const afterList = listSkills(rootPath).skills;
-                const addedSkills = afterList.filter((item) => !beforeIds.has(item.id));
-                const learnedAfter = findLearnedSkillExact(rootPath, queryFromSpec) ||
-                    findLearnedSkillExact(rootPath, payload.spec) ||
-                    (addedSkills.length === 1 ? addedSkills[0] : undefined);
-                return {
-                    success: true,
-                    data: {
-                        spec: payload.spec,
-                        message: "技能学习完成。使用技能前请先执行 lookup 读取该技能的 SKILL.md 内容。",
-                        workflow: ["find", "install", "lookup"],
-                        nextAction: "lookup",
-                        skipped: false,
-                        queryFromSpec,
-                        addedSkills,
-                        learnedSkill: learnedAfter || null,
-                    },
-                };
-            },
-        },
-        [SKILL_PLUGIN_ACTIONS.list]: {
-            command: {
-                description: "列出当前已学会（本地可发现）的 skills",
-                mapInput() {
-                    return {};
                 },
             },
-            api: {
-                method: "GET",
-            },
-            execute(params) {
-                return {
-                    success: true,
-                    data: listSkills(params.context.rootPath),
-                };
-            },
-        },
-        [SKILL_PLUGIN_ACTIONS.lookup]: {
-            command: {
-                description: "读取已学会 skill 内容（SKILL.md）",
-                configure(command) {
-                    command.argument("<name>");
+            [SKILL_PLUGIN_ACTIONS.list]: {
+                command: {
+                    description: "列出当前已学会（本地可发现）的 skills",
+                    mapInput() {
+                        return {};
+                    },
                 },
-                mapInput({ args }) {
-                    const name = String(args[0] || "").trim();
-                    if (!name)
-                        throw new Error("Missing name");
-                    return { name };
+                api: {
+                    method: "GET",
                 },
-            },
-            api: {
-                method: "POST",
-                async mapInput(c) {
-                    const body = readJsonObject(await c.req.json());
-                    const name = String(body.name || "").trim();
-                    if (!name)
-                        throw new Error("Missing name");
-                    return { name };
+                execute(params) {
+                    return {
+                        success: true,
+                        data: listSkills(params.context.rootPath),
+                    };
                 },
             },
-            async execute(params) {
-                const payload = params.payload;
-                const result = await lookupSkill({
-                    projectRoot: params.context.rootPath,
-                    request: {
-                        name: payload.name,
+            [SKILL_PLUGIN_ACTIONS.lookup]: {
+                command: {
+                    description: "读取已学会 skill 内容（SKILL.md）",
+                    configure(command) {
+                        command.argument("<name>");
+                    },
+                    mapInput({ args }) {
+                        const name = String(args[0] || "").trim();
+                        if (!name)
+                            throw new Error("Missing name");
+                        return { name };
                     },
-                });
-                if (!result.success) {
+                },
+                api: {
+                    method: "POST",
+                    async mapInput(c) {
+                        const body = readJsonObject(await c.req.json());
+                        const name = String(body.name || "").trim();
+                        if (!name)
+                            throw new Error("Missing name");
+                        return { name };
+                    },
+                },
+                async execute(params) {
+                    const payload = params.payload;
+                    const result = await lookupSkill({
+                        projectRoot: params.context.rootPath,
+                        request: {
+                            name: payload.name,
+                        },
+                    });
+                    if (!result.success) {
+                        return {
+                            success: false,
+                            error: result.error || "skill lookup failed",
+                        };
+                    }
+                    const skillName = String(result.skill?.name || result.skill?.id || "").trim();
+                    const openingTag = skillName
+                        ? `<skill name="${sanitizeXmlAttr(skillName)}">`
+                        : "<skill>";
+                    const skillUserMessage = [
+                        openingTag,
+                        String(result.content || "").trim(),
+                        "</skill>",
+                    ]
+                        .filter(Boolean)
+                        .join("\n")
+                        .trim();
                     return {
-                        success: false,
-                        error: result.error || "skill lookup failed",
-                    };
-                }
-                const skillName = String(result.skill?.name || result.skill?.id || "").trim();
-                const openingTag = skillName
-                    ? `<skill name="${sanitizeXmlAttr(skillName)}">`
-                    : "<skill>";
-                const skillUserMessage = [
-                    openingTag,
-                    String(result.content || "").trim(),
-                    "</skill>",
-                ]
-                    .filter(Boolean)
-                    .join("\n")
-                    .trim();
-                return {
-                    success: true,
-                    data: {
                         success: true,
-                        ...(result.skill ? { skill: result.skill } : {}),
-                        message: "技能内容已准备，下一步将以 `<skill>...</skill>` user message 注入。",
-                        __ship: {
-                            injectUserMessages: [
-                                {
-                                    text: skillUserMessage,
-                                    note: "skill_lookup",
-                                },
-                            ],
-                            suppressToolOutput: true,
-                            toolOutputMessage: "skill lookup success; content injected as <skill> user message.",
+                        data: {
+                            success: true,
+                            ...(result.skill ? { skill: result.skill } : {}),
+                            message: "技能内容已准备，下一步将以 `<skill>...</skill>` user message 注入。",
+                            __ship: {
+                                injectUserMessages: [
+                                    {
+                                        text: skillUserMessage,
+                                        note: "skill_lookup",
+                                    },
+                                ],
+                                suppressToolOutput: true,
+                                toolOutputMessage: "skill lookup success; content injected as <skill> user message.",
+                            },
                         },
-                    },
-                };
+                    };
+                },
             },
         },
-    },
-};
+    };
+}
+/**
+ * SkillPlugin：技能发现、安装、读取与 system 注入。
+ */
+export class SkillPlugin extends BasePlugin {
+    name = "skill";
+    constructor(agent = null) {
+        super(agent);
+        Object.assign(this, createSkillPluginDefinition(this));
+    }
+}
 //# sourceMappingURL=Plugin.js.map