@downcity/plugins 1.0.174 → 1.0.193

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

@@ -6,6 +6,7 @@
  * - 不再读取/写入 pinnedSkillIds，不做会话级技能注入
  * - `lookup` 行为为无状态：由 action 读取 SKILL.md 后通过协议注入 user message
  */
+import type { PluginRunContext } from "@downcity/agent";
 import type { SkillPluginOptions } from "../../skill/types/SkillPlugin.js";
 type SkillSystemRuntime = {
     rootPath: string;
@@ -19,6 +20,6 @@ type SkillSystemRuntime = {
  * 2) 更新 session 的可用技能快照（仅用于观察态）
  * 3) 输出 skills overview 文本
  */
-export declare function buildSkillsSystemText(runtime: SkillSystemRuntime): Promise<string>;
+export declare function buildSkillsSystemText(runtime: SkillSystemRuntime, run_context?: PluginRunContext): Promise<string>;
 export {};
 //# sourceMappingURL=SystemProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SystemProvider.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/SystemProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACrC,CAAC;AAOF;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAgBjB"}
+{"version":3,"file":"SystemProvider.d.ts","sourceRoot":"","sources":["../../../src/skill/runtime/SystemProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,CAAC,EAAE,gBAAgB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/bin/skill/runtime/SystemProvider.js

@@ -6,14 +6,9 @@
  * - 不再读取/写入 pinnedSkillIds，不做会话级技能注入
  * - `lookup` 行为为无状态：由 action 读取 SKILL.md 后通过协议注入 user message
  */
-import { getSessionRunContext } from "@downcity/agent";
 import { discoverSkillsSync } from "./Discovery.js";
-import { renderSkillsPromptSection } from "./Prompt.js";
+import { render_skills_prompt_section } from "./Prompt.js";
 import { setSessionAvailableSkills } from "./Store.js";
-function getCurrentSessionId() {
-    const run_context = getSessionRunContext();
-    return String(run_context?.sessionId || "").trim();
-}
 /**
  * 构建 skill plugin system 文本。
  *
@@ -22,12 +17,12 @@ function getCurrentSessionId() {
  * 2) 更新 session 的可用技能快照（仅用于观察态）
  * 3) 输出 skills overview 文本
  */
-export async function buildSkillsSystemText(runtime) {
-    const sessionId = getCurrentSessionId();
+export async function buildSkillsSystemText(runtime, run_context) {
+    const sessionId = String(run_context?.sessionId || "").trim();
     const discoveredSkills = discoverSkillsSync(runtime.rootPath, runtime.options);
     if (sessionId) {
         setSessionAvailableSkills(sessionId, discoveredSkills);
     }
-    return renderSkillsPromptSection(runtime.rootPath, runtime.options, discoveredSkills).trim();
+    return render_skills_prompt_section(runtime.rootPath, runtime.options, discoveredSkills).trim();
 }
 //# sourceMappingURL=SystemProvider.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"SystemProvider.js","sourceRoot":"","sources":["../../../src/skill/runtime/SystemProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAQvD,SAAS,mBAAmB;IAC1B,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAC3C,OAAO,MAAM,CAAC,WAAW,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA2B;IAE3B,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,MAAM,gBAAgB,GAAG,kBAAkB,CACzC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,CAChB,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,yBAAyB,CAC9B,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,EACf,gBAAgB,CACjB,CAAC,IAAI,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"SystemProvider.js","sourceRoot":"","sources":["../../../src/skill/runtime/SystemProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAQvD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA2B,EAC3B,WAA8B;IAE9B,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,MAAM,gBAAgB,GAAG,kBAAkB,CACzC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,CAChB,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,4BAA4B,CACjC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,EACf,gBAAgB,CACjB,CAAC,IAAI,EAAE,CAAC;AACX,CAAC"}

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

@@ -13,11 +13,11 @@ import type { SkillRootSource } from "../../skill/types/SkillRoot.js";
  */
 export declare const SKILL_PLUGIN_ACTIONS: {
     /**
-     * 查找 skill。
+     * 返回查找 skill 的 Shell 操作提示。
      */
     readonly find: "find";
     /**
-     * 安装 skill。
+     * 返回扫描感知的安装提示。
      */
     readonly install: "install";
     /**
@@ -30,34 +30,22 @@ export declare const SKILL_PLUGIN_ACTIONS: {
     readonly lookup: "lookup";
 };
 /**
- * skill 查找输入。
+ * skill 查找提示 action 输入。
  */
 export type SkillPluginFindPayload = {
     /**
-     * 用户输入的 skill 查询词。
+     * 需要查找的 skill 关键词。
      */
     query: string;
 };
 /**
- * skill 安装输入。
+ * skill 安装提示 action 输入。
  */
 export type SkillPluginInstallPayload = {
     /**
-     * skill 安装 spec。
+     * `skills` CLI 接受的安装来源或 skill spec。
      */
     spec: string;
-    /**
-     * 是否全局安装。
-     */
-    global?: boolean;
-    /**
-     * 是否跳过确认。
-     */
-    yes?: boolean;
-    /**
-     * 安装目标 agent 名称。
-     */
-    agent?: string;
 };
 /**
  * skill 读取输入。

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

@@ -1 +1 @@
-{"version":3,"file":"SkillPlugin.d.ts","sourceRoot":"","sources":["../../../src/skill/types/SkillPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,MAAM,GACN,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IACzD;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC"}
+{"version":3,"file":"SkillPlugin.d.ts","sourceRoot":"","sources":["../../../src/skill/types/SkillPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,MAAM,GACN,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IACzD;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC"}

package/bin/skill/types/SkillPlugin.js

@@ -11,11 +11,11 @@
  */
 export const SKILL_PLUGIN_ACTIONS = {
     /**
-     * 查找 skill。
+     * 返回查找 skill 的 Shell 操作提示。
      */
     find: "find",
     /**
-     * 安装 skill。
+     * 返回扫描感知的安装提示。
      */
     install: "install",
     /**

package/bin/sound/Plugin.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SoundPlugin：统一的语音识别与语音合成插件。
+ *
+ * 关键点（中文）
+ * - 对 Agent 暴露 `models`、`asr`、`tts` 三个 action。
+ * - 模型目录与真实 ASR/TTS 能力全部由 FED/City constructor 回调注入。
+ * - 本地音频只负责读取并转换为 data URL，不加载或运行任何本地语音模型。
+ * - TTS 返回 AI SDK UIMessage，音频 file part 由 agent 统一落盘。
+ */
+import { BasePlugin } from "@downcity/agent";
+import type { AgentContext, JsonObject, JsonValue } from "@downcity/agent";
+import type { SoundPluginOptions } from "../sound/types/SoundPlugin.js";
+/**
+ * Agent 统一语音插件。
+ */
+export declare class SoundPlugin extends BasePlugin {
+    /** 当前 plugin 稳定名称。 */
+    readonly name: string;
+    /** Plugin 展示标题。 */
+    readonly title: string;
+    /** Plugin 用途说明。 */
+    readonly description: string;
+    private readonly asr_handler;
+    private readonly tts_handler;
+    private readonly list_models?;
+    private readonly default_asr_model?;
+    private readonly default_tts_model?;
+    private readonly auto_asr;
+    private readonly language?;
+    private readonly voice?;
+    private readonly format?;
+    constructor(options: SoundPluginOptions);
+    /**
+     * SoundPlugin 给 Agent 的使用说明。
+     */
+    system(_context: AgentContext): string;
+    /**
+     * 执行一次 ASR 转写。
+     */
+    private transcribe;
+    /**
+     * 执行一次 TTS 合成。
+     */
+    private synthesize;
+    /**
+     * 自动转写 chat 入站语音附件。
+     */
+    private auto_transcribe_inbound;
+    /**
+     * chat pipeline 扩展点。
+     */
+    readonly hooks: {
+        pipeline: {
+            "chat.augmentInbound": (({ context, value }: {
+                context: AgentContext;
+                value: JsonValue;
+            }) => Promise<JsonValue>)[];
+        };
+    };
+    /**
+     * 显式 action 集合。
+     */
+    readonly actions: {
+        models: import("@downcity/agent").PluginAction<JsonValue, JsonObject>;
+        asr: import("@downcity/agent").PluginAction<JsonValue, JsonObject>;
+        tts: import("@downcity/agent").PluginAction<JsonValue, JsonObject>;
+    };
+}
+//# sourceMappingURL=Plugin.d.ts.map

package/bin/sound/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/sound/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,UAAU,EAAgB,MAAM,iBAAiB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM3E,OAAO,KAAK,EAOV,kBAAkB,EAGnB,MAAM,8BAA8B,CAAC;AA8XtC;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,mBAAmB;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAoC;IACjE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,OAAO,EAAE,kBAAkB;IA4BvC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IA+BtC;;OAEG;YACW,UAAU;IAaxB;;OAEG;YACW,UAAU;IAYxB;;OAEG;YACW,uBAAuB;IAkCrC;;OAEG;IACH,QAAQ,CAAC,KAAK;;yDAGmB;gBAAE,OAAO,EAAE,YAAY,CAAC;gBAAC,KAAK,EAAE,SAAS,CAAA;aAAE;;MAI1E;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO;;;;MAqHd;CACH"}