@downcity/plugins 1.0.4

package/bin/skill/runtime/Paths.js

@@ -0,0 +1,111 @@
+/**
+ * Skills roots resolution.
+ *
+ * 关键点（中文）
+ * - roots 分三类：项目内（project）、用户目录（home），以及配置外部路径（config）
+ * - allowExternalPaths 只控制“配置外部路径（config）”是否可扫描；home 默认始终可扫描
+ * - 兼容 `<any>/skills` 这种布局：如果 root basename 不是 `skills` 且其子目录 `skills/` 存在，则优先扫描 `<root>/skills`
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { readSkillPluginConfig } from "../Config.js";
+import { expandHome, uniqStrings } from "./Utils.js";
+function normalizeSkillRootCandidate(candidate) {
+    const normalized = path.normalize(candidate);
+    const base = path.basename(normalized);
+    const skillsChild = path.join(normalized, "skills");
+    if (base !== "skills" && fs.existsSync(skillsChild)) {
+        try {
+            if (fs.statSync(skillsChild).isDirectory())
+                return path.normalize(skillsChild);
+        }
+        catch {
+            // ignore
+        }
+    }
+    return normalized;
+}
+function resolveSkillRootPath(projectRoot, raw) {
+    const expanded = expandHome(raw);
+    return path.isAbsolute(expanded)
+        ? path.normalize(expanded)
+        : path.resolve(projectRoot, expanded);
+}
+export function getClaudeSkillSearchRoots(projectRoot, config) {
+    const skillPluginConfig = readSkillPluginConfig(config);
+    const configured = skillPluginConfig.paths.map((x) => String(x));
+    const defaultsProject = [];
+    const defaultsHome = ["~/.agents/skills"];
+    const rawConfigured = uniqStrings(configured);
+    const rawProject = uniqStrings(defaultsProject);
+    const rawHome = uniqStrings(defaultsHome);
+    const roots = [];
+    // 1) project roots（最高优先级）
+    for (const raw of rawProject) {
+        const resolved = normalizeSkillRootCandidate(resolveSkillRootPath(projectRoot, raw));
+        roots.push({
+            source: "project",
+            raw,
+            resolved,
+            display: raw,
+            priority: 10,
+            trustedWhenExternalDisabled: true,
+        });
+    }
+    // 2) configured roots：如果在项目内，按 project 处理；否则按 config（受 allowExternalPaths 影响）
+    for (const raw of rawConfigured) {
+        const resolved = normalizeSkillRootCandidate(resolveSkillRootPath(projectRoot, raw));
+        const rel = path.relative(projectRoot, resolved);
+        const inside = rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
+        if (inside) {
+            roots.push({
+                source: "project",
+                raw,
+                resolved,
+                display: raw,
+                priority: 12,
+                trustedWhenExternalDisabled: true,
+            });
+        }
+        else {
+            roots.push({
+                source: "config",
+                raw,
+                resolved,
+                display: raw,
+                priority: 40,
+                trustedWhenExternalDisabled: false,
+            });
+        }
+    }
+    // 3) home root（用户目录）
+    for (const raw of rawHome) {
+        const resolved = normalizeSkillRootCandidate(resolveSkillRootPath(projectRoot, raw));
+        roots.push({
+            source: "home",
+            raw,
+            resolved,
+            display: raw,
+            priority: 20,
+            trustedWhenExternalDisabled: true,
+        });
+    }
+    // 去重：同 resolved 只保留优先级更高的那个（display/raw 以优先级更高者为准）
+    const byResolved = new Map();
+    for (const r of roots) {
+        const key = path.normalize(r.resolved);
+        const prev = byResolved.get(key);
+        if (!prev || r.priority < prev.priority)
+            byResolved.set(key, r);
+    }
+    return Array.from(byResolved.values()).sort((a, b) => a.priority - b.priority);
+}
+// Back-compat（内部仅用于 prompt 展示）：保留旧 API 形状，避免外部 import 立刻断裂。
+export function getClaudeSkillSearchPaths(projectRoot, config) {
+    const roots = getClaudeSkillSearchRoots(projectRoot, config);
+    return {
+        raw: roots.map((r) => r.display),
+        resolved: roots.map((r) => r.resolved),
+    };
+}
+//# sourceMappingURL=Paths.js.map

package/bin/skill/runtime/Paths.js.map

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

package/bin/skill/runtime/Prompt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Skill plugin prompt section 渲染器。
+ *
+ * 关键点（中文）
+ * - 仅负责渲染运行时动态清单（已发现 skills + 扫描根目录）。
+ * - 稳定规则放在 `SkillPromptAssets.ts`，避免分散在代码里维护。
+ * - 仅做字符串渲染，不做文件 IO。
+ */
+import type { DowncityConfig } from "@downcity/agent/internal/config/Config.js";
+import type { ClaudeSkill } from "../../skill/types/ClaudeSkill.js";
+/**
+ * 渲染 skills 系统提示片段。
+ *
+ * 约束（中文）
+ * - 为控制 token 成本，最多展示前 40 个 skill。
+ * - roots 会按扫描顺序输出，便于排查冲突覆盖。
+ */
+export declare function renderClaudeSkillsPromptSection(projectRoot: string, config: DowncityConfig, skills: ClaudeSkill[]): string;
+//# sourceMappingURL=Prompt.d.ts.map

package/bin/skill/runtime/Prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prompt.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/Prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,WAAW,EAAE,GACpB,MAAM,CAyCR"}

package/bin/skill/runtime/Prompt.js

@@ -0,0 +1,54 @@
+/**
+ * Skill plugin prompt section 渲染器。
+ *
+ * 关键点（中文）
+ * - 仅负责渲染运行时动态清单（已发现 skills + 扫描根目录）。
+ * - 稳定规则放在 `SkillPromptAssets.ts`，避免分散在代码里维护。
+ * - 仅做字符串渲染，不做文件 IO。
+ */
+import { readSkillPluginConfig } from "../Config.js";
+import { getClaudeSkillSearchRoots } from "./Paths.js";
+/**
+ * 渲染 skills 系统提示片段。
+ *
+ * 约束（中文）
+ * - 为控制 token 成本，最多展示前 40 个 skill。
+ * - roots 会按扫描顺序输出，便于排查冲突覆盖。
+ */
+export function renderClaudeSkillsPromptSection(projectRoot, config, skills) {
+    const roots = getClaudeSkillSearchRoots(projectRoot, config);
+    const allowExternal = readSkillPluginConfig(config).allowExternalPaths;
+    const skillsSection = skills.length > 0
+        ? skills
+            .map((skill) => {
+            const desc = skill.description ? ` - ${skill.description}` : "";
+            return `- **${skill.name}**${desc}`;
+        })
+            .join("\n")
+        : "- (none)";
+    const rootsSection = roots.length > 0
+        ? roots
+            .map((root) => {
+            const externalNote = root.source === "config" && !allowExternal
+                ? " (disabled: allowExternalPaths=false)"
+                : "";
+            return `- [${root.source}] ${root.display}${externalNote}`;
+        })
+            .join("\n")
+        : "- (none)";
+    return [
+        "# Runtime Skills Inventory",
+        "",
+        `Discovered ${skills.length} learned/installed skill(s).`,
+        "All skills in `Available Skills` are already available locally.",
+        "",
+        "## Available Skills",
+        skillsSection,
+        "",
+        "## Skill Roots (scan order, higher wins on conflicts)",
+        rootsSection,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+//# sourceMappingURL=Prompt.js.map

package/bin/skill/runtime/Prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prompt.js","sourceRoot":"","sources":["../../../src/skill/runtime/Prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAGvD;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,WAAmB,EACnB,MAAsB,EACtB,MAAqB;IAErB,MAAM,KAAK,GAAG,yBAAyB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC;IAEvE,MAAM,aAAa,GACjB,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,MAAM;aACH,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACtC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,YAAY,GAChB,KAAK,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,KAAK;aACF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,YAAY,GAChB,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,aAAa;gBACxC,CAAC,CAAC,uCAAuC;gBACzC,CAAC,CAAC,EAAE,CAAC;YACT,OAAO,MAAM,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,GAAG,YAAY,EAAE,CAAC;QAC7D,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,UAAU,CAAC;IAEjB,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,cAAc,MAAM,CAAC,MAAM,8BAA8B;QACzD,iEAAiE;QACjE,EAAE;QACF,qBAAqB;QACrB,aAAa;QACb,EAAE;QACF,uDAAuD;QACvD,YAAY;KACb;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/bin/skill/runtime/Store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Session skills state store（skill plugin 内部状态）。
+ *
+ * 关键点（中文）
+ * - 这是 skill 子系统的运行时状态容器
+ * - core 不负责也不感知 skill/memory 业务状态
+ */
+import type { ClaudeSkill } from "../../skill/types/ClaudeSkill.js";
+import type { SessionSkillStateSnapshot } from "./Types.js";
+/**
+ * 设置会话可用技能集合。
+ *
+ * 算法（中文）
+ * - 以 id 归一化后整体替换，避免残留脏状态。
+ */
+export declare function setSessionAvailableSkills(sessionId: string, skills: ClaudeSkill[]): void;
+/**
+ * 获取会话技能状态快照。
+ */
+export declare function getSessionSkillState(sessionId: string): SessionSkillStateSnapshot;
+/**
+ * 清理会话技能状态。
+ */
+export declare function clearSessionSkillState(sessionId: string): void;
+//# sourceMappingURL=Store.d.ts.map

package/bin/skill/runtime/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/Store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAkCpB;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAYxF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,CAiBjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAG9D"}

package/bin/skill/runtime/Store.js

@@ -0,0 +1,81 @@
+/**
+ * Session skills state store（skill plugin 内部状态）。
+ *
+ * 关键点（中文）
+ * - 这是 skill 子系统的运行时状态容器
+ * - core 不负责也不感知 skill/memory 业务状态
+ */
+const sessionSkillStateStore = new Map();
+/**
+ * 归一化 sessionId。
+ *
+ * 关键点（中文）
+ * - 空 sessionId 视为调用错误，直接抛异常，避免污染全局状态。
+ */
+function normalizeSessionId(sessionId) {
+    const value = String(sessionId || "").trim();
+    if (!value) {
+        throw new Error("sessionId is required for session skills state");
+    }
+    return value;
+}
+/**
+ * 获取或创建 session 技能状态。
+ */
+function getOrCreateState(sessionId) {
+    const key = normalizeSessionId(sessionId);
+    const existing = sessionSkillStateStore.get(key);
+    if (existing)
+        return existing;
+    const created = {
+        allSkillsById: new Map(),
+        updatedAt: Date.now(),
+    };
+    sessionSkillStateStore.set(key, created);
+    return created;
+}
+/**
+ * 设置会话可用技能集合。
+ *
+ * 算法（中文）
+ * - 以 id 归一化后整体替换，避免残留脏状态。
+ */
+export function setSessionAvailableSkills(sessionId, skills) {
+    const state = getOrCreateState(sessionId);
+    const next = new Map();
+    for (const skill of Array.isArray(skills) ? skills : []) {
+        const id = String(skill?.id || "").trim();
+        if (!id)
+            continue;
+        next.set(id, skill);
+    }
+    state.allSkillsById = next;
+    state.updatedAt = Date.now();
+}
+/**
+ * 获取会话技能状态快照。
+ */
+export function getSessionSkillState(sessionId) {
+    const key = normalizeSessionId(sessionId);
+    const state = sessionSkillStateStore.get(key);
+    if (!state) {
+        return {
+            sessionId: key,
+            allSkills: [],
+            updatedAt: 0,
+        };
+    }
+    return {
+        sessionId: key,
+        allSkills: Array.from(state.allSkillsById.values()),
+        updatedAt: state.updatedAt,
+    };
+}
+/**
+ * 清理会话技能状态。
+ */
+export function clearSessionSkillState(sessionId) {
+    const key = normalizeSessionId(sessionId);
+    sessionSkillStateStore.delete(key);
+}
+//# sourceMappingURL=Store.js.map

package/bin/skill/runtime/Store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.js","sourceRoot":"","sources":["../../../src/skill/runtime/Store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAqC,CAAC;AAE5E;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,SAAiB;IACzC,MAAM,GAAG,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,OAAO,GAA8B;QACzC,aAAa,EAAE,IAAI,GAAG,EAAE;QACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IACF,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB,EAAE,MAAqB;IAChF,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACxD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,GAAG,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QACnD,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,MAAM,GAAG,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC1C,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/bin/skill/runtime/SystemProvider.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Skill plugin system 文本构建器。
+ *
+ * 关键点（中文）
+ * - 只负责输出“可用技能概览”提示词
+ * - 不再读取/写入 pinnedSkillIds，不做会话级技能注入
+ * - `lookup` 行为为无状态：由 action 读取 SKILL.md 后通过协议注入 user message
+ */
+import type { DowncityConfig } from "@downcity/agent/internal/types/config/DowncityConfig.js";
+type SkillSystemRuntime = {
+    rootPath: string;
+    config: DowncityConfig;
+};
+/**
+ * 构建 skill plugin system 文本。
+ *
+ * 算法流程（中文）
+ * 1) 扫描可用 skills
+ * 2) 更新 session 的可用技能快照（仅用于观察态）
+ * 3) 输出 skills overview 文本
+ */
+export declare function buildSkillsSystemText(runtime: SkillSystemRuntime): Promise<string>;
+export {};
+//# sourceMappingURL=SystemProvider.d.ts.map

package/bin/skill/runtime/SystemProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemProvider.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/SystemProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AAK9F,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAOF;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/bin/skill/runtime/SystemProvider.js

@@ -0,0 +1,33 @@
+/**
+ * Skill plugin system 文本构建器。
+ *
+ * 关键点（中文）
+ * - 只负责输出“可用技能概览”提示词
+ * - 不再读取/写入 pinnedSkillIds，不做会话级技能注入
+ * - `lookup` 行为为无状态：由 action 读取 SKILL.md 后通过协议注入 user message
+ */
+import { getSessionRunScope } from "@downcity/agent/internal/executor/SessionRunScope.js";
+import { discoverClaudeSkillsSync } from "./Discovery.js";
+import { renderClaudeSkillsPromptSection } from "./Prompt.js";
+import { setSessionAvailableSkills } from "./Store.js";
+function getCurrentSessionId() {
+    const request = getSessionRunScope();
+    return String(request?.sessionId || "").trim();
+}
+/**
+ * 构建 skill plugin system 文本。
+ *
+ * 算法流程（中文）
+ * 1) 扫描可用 skills
+ * 2) 更新 session 的可用技能快照（仅用于观察态）
+ * 3) 输出 skills overview 文本
+ */
+export async function buildSkillsSystemText(runtime) {
+    const sessionId = getCurrentSessionId();
+    const discoveredSkills = discoverClaudeSkillsSync(runtime.rootPath, runtime.config);
+    if (sessionId) {
+        setSessionAvailableSkills(sessionId, discoveredSkills);
+    }
+    return renderClaudeSkillsPromptSection(runtime.rootPath, runtime.config, discoveredSkills).trim();
+}
+//# sourceMappingURL=SystemProvider.js.map

package/bin/skill/runtime/SystemProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemProvider.js","sourceRoot":"","sources":["../../../src/skill/runtime/SystemProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAC;AAE1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAOvD,SAAS,mBAAmB;IAC1B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO,MAAM,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA2B;IAE3B,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,MAAM,gBAAgB,GAAG,wBAAwB,CAC/C,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,MAAM,CACf,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,+BAA+B,CACpC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,MAAM,EACd,gBAAgB,CACjB,CAAC,IAAI,EAAE,CAAC;AACX,CAAC"}

package/bin/skill/runtime/Types.d.ts

@@ -0,0 +1,21 @@
+import type { ClaudeSkill } from "../../skill/types/ClaudeSkill.js";
+/**
+ * Session skills state 对外快照。
+ *
+ * 关键点（中文）
+ * - 这是 service 侧暴露给调试/观察的只读结构
+ * - core 不依赖该结构
+ */
+export type SessionSkillStateSnapshot = {
+    sessionId: string;
+    allSkills: ClaudeSkill[];
+    updatedAt: number;
+};
+/**
+ * Session skills state 内部结构。
+ */
+export type SessionSkillStateInternal = {
+    allSkillsById: Map<string, ClaudeSkill>;
+    updatedAt: number;
+};
+//# sourceMappingURL=Types.d.ts.map

package/bin/skill/runtime/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/Types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/bin/skill/runtime/Types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Types.js.map

package/bin/skill/runtime/Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../../src/skill/runtime/Types.ts"],"names":[],"mappings":""}

package/bin/skill/runtime/Utils.d.ts

@@ -0,0 +1,4 @@
+export declare function uniqStrings(values: string[]): string[];
+export declare function expandHome(p: string): string;
+export declare function isSubpath(parent: string, child: string): boolean;
+//# sourceMappingURL=Utils.d.ts.map

package/bin/skill/runtime/Utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/Utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAWtD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAGhE"}

package/bin/skill/runtime/Utils.js

@@ -0,0 +1,29 @@
+import os from "os";
+import path from "path";
+export function uniqStrings(values) {
+    const out = [];
+    const seen = new Set();
+    for (const v of values) {
+        const s = String(v || "").trim();
+        if (!s)
+            continue;
+        if (seen.has(s))
+            continue;
+        seen.add(s);
+        out.push(s);
+    }
+    return out;
+}
+export function expandHome(p) {
+    const raw = String(p || "");
+    if (raw === "~")
+        return os.homedir();
+    if (raw.startsWith("~/"))
+        return path.join(os.homedir(), raw.slice(2));
+    return raw;
+}
+export function isSubpath(parent, child) {
+    const rel = path.relative(parent, child);
+    return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
+}
+//# sourceMappingURL=Utils.js.map

package/bin/skill/runtime/Utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../../src/skill/runtime/Utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,WAAW,CAAC,MAAgB;IAC1C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5B,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,KAAa;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/bin/skill/types/ClaudeSkill.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Claude Code-compatible skill 模型。
+ *
+ * 关键点（中文）
+ * - skill 最小单元目录为 `<root>/<skill-id>/SKILL.md`。
+ * - 发现逻辑只读取 `SKILL.md` front matter 作为元数据。
+ * - 该类型为 skill plugin、CLI 与内部辅助模块的共享事实源。
+ */
+import type { SkillRootSource } from "../../skill/types/SkillRoot.js";
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+/**
+ * Claude Code-compatible skill。
+ */
+export interface ClaudeSkill {
+    /**
+     * skill 稳定标识。
+     *
+     * 说明（中文）
+     * - 通常等于 skill 目录名。
+     * - 用于 lookup、去重与排序。
+     */
+    id: string;
+    /**
+     * skill 展示名称。
+     *
+     * 说明（中文）
+     * - 优先读取 front matter 中的 `name`。
+     * - 若未声明，则回退为 `id`。
+     */
+    name: string;
+    /**
+     * skill 简要描述。
+     *
+     * 说明（中文）
+     * - 来自 front matter 的 `description`。
+     * - 未声明时为空字符串。
+     */
+    description: string;
+    /**
+     * skill 根目录来源类型。
+     */
+    source: SkillRootSource;
+    /**
+     * skill 所属根目录的绝对路径。
+     */
+    sourceRoot: string;
+    /**
+     * skill 目录的绝对路径。
+     */
+    directoryPath: string;
+    /**
+     * `SKILL.md` 文件的绝对路径。
+     */
+    skillMdPath: string;
+    /**
+     * front matter 中的 `allowed-tools` 原始值。
+     *
+     * 说明（中文）
+     * - 这里保留原始 JSON 结构，归一化工作交给上层调用方。
+     */
+    allowedTools?: JsonValue;
+}
+//# sourceMappingURL=ClaudeSkill.d.ts.map

package/bin/skill/types/ClaudeSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeSkill.d.ts","sourceRoot":"","sources":["../../../src/skill/types/ClaudeSkill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B"}

package/bin/skill/types/ClaudeSkill.js

@@ -0,0 +1,10 @@
+/**
+ * Claude Code-compatible skill 模型。
+ *
+ * 关键点（中文）
+ * - skill 最小单元目录为 `<root>/<skill-id>/SKILL.md`。
+ * - 发现逻辑只读取 `SKILL.md` front matter 作为元数据。
+ * - 该类型为 skill plugin、CLI 与内部辅助模块的共享事实源。
+ */
+export {};
+//# sourceMappingURL=ClaudeSkill.js.map

package/bin/skill/types/ClaudeSkill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeSkill.js","sourceRoot":"","sources":["../../../src/skill/types/ClaudeSkill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/skill/types/SkillCommand.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Skill 命令协议类型。
+ *
+ * 关键点（中文）
+ * - 统一描述 skill list / lookup 相关的 CLI、API 与 plugin action 数据结构。
+ * - 这些类型不绑定具体实现模块，避免再次退回到历史 service 目录。
+ */
+/**
+ * skill 摘要信息。
+ */
+export type SkillSummary = {
+    /**
+     * skill 稳定标识。
+     */
+    id: string;
+    /**
+     * skill 展示名称。
+     */
+    name: string;
+    /**
+     * skill 简要描述。
+     */
+    description: string;
+    /**
+     * skill 根目录来源类型。
+     *
+     * 说明（中文）
+     * - 例如 user/project/builtin 等来源标识。
+     * - 这里只保留稳定字符串，不在类型层强绑定目录实现细节。
+     */
+    source: string;
+    /**
+     * `SKILL.md` 的绝对路径。
+     */
+    skillMdPath: string;
+    /**
+     * 归一化后的允许工具列表。
+     */
+    allowedTools: string[];
+};
+/**
+ * skill 列表响应。
+ */
+export type SkillListResponse = {
+    /**
+     * 本次列表读取是否成功。
+     */
+    success: true;
+    /**
+     * 当前可发现的 skill 摘要集合。
+     */
+    skills: SkillSummary[];
+};
+/**
+ * skill lookup 请求。
+ */
+export type SkillLookupRequest = {
+    /**
+     * 待读取的 skill 名称或标识。
+     */
+    name: string;
+};
+/**
+ * skill lookup 响应。
+ */
+export type SkillLookupResponse = {
+    /**
+     * lookup 是否成功。
+     */
+    success: boolean;
+    /**
+     * 命中的 skill 摘要。
+     */
+    skill?: SkillSummary;
+    /**
+     * `SKILL.md` 正文内容。
+     *
+     * 说明（中文）
+     * - 仅在命中 skill 且成功读取文件时返回。
+     */
+    content?: string;
+    /**
+     * 失败时的错误信息。
+     */
+    error?: string;
+};
+//# sourceMappingURL=SkillCommand.d.ts.map

package/bin/skill/types/SkillCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillCommand.d.ts","sourceRoot":"","sources":["../../../src/skill/types/SkillCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,OAAO,EAAE,IAAI,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/bin/skill/types/SkillCommand.js

@@ -0,0 +1,9 @@
+/**
+ * Skill 命令协议类型。
+ *
+ * 关键点（中文）
+ * - 统一描述 skill list / lookup 相关的 CLI、API 与 plugin action 数据结构。
+ * - 这些类型不绑定具体实现模块，避免再次退回到历史 service 目录。
+ */
+export {};
+//# sourceMappingURL=SkillCommand.js.map

package/bin/skill/types/SkillCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillCommand.js","sourceRoot":"","sources":["../../../src/skill/types/SkillCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}