@downcity/plugins 1.0.60 → 1.0.61

package/bin/task/TaskPlugin.js

@@ -12,6 +12,7 @@ import { registerTaskCronJobs } from "../task/Scheduler.js";
 import { createTaskPluginActions, } from "../task/runtime/TaskPluginActions.js";
 import { reloadTaskSchedulerAfterMutation, } from "../task/runtime/TaskActionExecution.js";
 import { TASK_PLUGIN_PROMPT } from "../task/runtime/TaskPluginSystem.js";
+import { resolveRuntimeTimezone } from "@downcity/agent/internal/utils/Time.js";
 const TASK_LOG_PREFIX = "[TASK]";
 function formatTaskLogMessage(message) {
     return `${TASK_LOG_PREFIX} ${message}`;
@@ -32,6 +33,10 @@ export class TaskPlugin extends BasePlugin {
      * task plugin 的 action 定义表。
      */
     actions;
+    /**
+     * 当前实例持有的显式配置。
+     */
+    options;
     /**
      * 当前实例持有的 cron engine。
      *
@@ -40,8 +45,17 @@ export class TaskPlugin extends BasePlugin {
      * - 不再复用 module-global 单例。
      */
     cronEngine = null;
-    constructor() {
+    /**
+     * 当前实例持有的运行中 task 锁。
+     *
+     * 关键点（中文）
+     * - scheduler reload 会替换 cron engine。
+     * - 锁必须挂在 plugin 实例上，避免 reload 后同一 task 被新旧调度器并发触发。
+     */
+    runningTaskIds = new Set();
+    constructor(options) {
         super();
+        this.options = options || {};
         this.actions = createTaskPluginActions({
             reloadSchedulerAfterMutation: async (params) => this.reloadSchedulerAfterMutation(params),
         });
@@ -84,6 +98,8 @@ export class TaskPlugin extends BasePlugin {
         const registerResult = await registerTaskCronJobs({
             context,
             engine,
+            timezone: this.resolveTimezone(),
+            runningTaskIds: this.runningTaskIds,
         });
         await engine.start();
         this.cronEngine = engine;
@@ -122,5 +138,11 @@ export class TaskPlugin extends BasePlugin {
             reloadScheduler: async (context) => this.restartCronRuntime(context),
         });
     }
+    /**
+     * 解析当前 task cron 使用的时区。
+     */
+    resolveTimezone() {
+        return String(this.options.timezone || "").trim() || resolveRuntimeTimezone();
+    }
 }
 //# sourceMappingURL=TaskPlugin.js.map

package/bin/task/TaskPlugin.js.map

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

package/bin/task/types/TaskPluginOptions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TaskPluginOptions：TaskPlugin 构造参数。
+ *
+ * 关键点（中文）
+ * - TaskPlugin 本身就是定时任务 runtime，不提供 enabled 开关。
+ * - 只暴露用户能直接理解的时区配置，内部调度实现细节不进入 constructor。
+ */
+/**
+ * TaskPlugin 构造参数。
+ */
+export interface TaskPluginOptions {
+    /**
+     * cron task 使用的 IANA 时区。
+     *
+     * 说明（中文）
+     * - 例如 `Asia/Shanghai`、`America/Los_Angeles`。
+     * - 省略时使用当前运行机器的本机时区。
+     * - `time:<ISO8601-with-timezone>` 一次性任务以 ISO 字符串自身的 offset 为准，这里的时区主要影响 cron 表达式。
+     */
+    timezone?: string;
+}
+//# sourceMappingURL=TaskPluginOptions.d.ts.map

package/bin/task/types/TaskPluginOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskPluginOptions.d.ts","sourceRoot":"","sources":["../../../src/task/types/TaskPluginOptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/bin/task/types/TaskPluginOptions.js

@@ -0,0 +1,9 @@
+/**
+ * TaskPluginOptions：TaskPlugin 构造参数。
+ *
+ * 关键点（中文）
+ * - TaskPlugin 本身就是定时任务 runtime，不提供 enabled 开关。
+ * - 只暴露用户能直接理解的时区配置，内部调度实现细节不进入 constructor。
+ */
+export {};
+//# sourceMappingURL=TaskPluginOptions.js.map

package/bin/task/types/TaskPluginOptions.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/plugins",
-  "version": "1.0.60",
+  "version": "1.0.61",
   "type": "module",
   "description": "Downcity 内建 plugin 集合包",
   "main": "./bin/index.js",
@@ -22,7 +22,7 @@
     "node-cron": "^4.2.1",
     "ws": "^8.21.0",
     "zod": "^4.4.3",
-    "@downcity/agent": "^1.1.106"
+    "@downcity/agent": "^1.1.107"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",

package/src/BuiltinPlugins.ts

@@ -22,6 +22,9 @@ import { TtsPlugin } from "@/tts/Plugin.js";
 import type { ImagePluginOptions } from "@/image/types/ImagePlugin.js";
 import type { AsrPluginOptions } from "@/asr/types/AsrPlugin.js";
 import type { TtsPluginOptions } from "@/tts/types/TtsPlugin.js";
+import type { TaskPluginOptions } from "@/task/types/TaskPluginOptions.js";
+import type { MemoryPluginOptions } from "@/memory/types/Memory.js";
+import type { ShellPluginOptions } from "@/shell/types/ShellPluginOptions.js";
 
 /**
  * 内建 plugin class 构造器。
@@ -62,13 +65,36 @@ export interface BuiltinPluginOptions {
    * 文本转语音 plugin 的 City AI 能力注入。
    */
   tts?: TtsPluginOptions;
+
+  /**
+   * task plugin 的定时任务运行参数。
+   */
+  task?: TaskPluginOptions;
+
+  /**
+   * memory plugin 的 LLM Wiki 能力注入。
+   */
+  memory?: MemoryPluginOptions;
+
+  /**
+   * shell plugin 的可选 runtime 参数。
+   */
+  shell?: ShellPluginOptions;
 }
 
 /**
  * 创建完整内建 plugin 实例集合。
  */
 export function createBuiltinPlugins(options: BuiltinPluginOptions = {}): BasePlugin[] {
-  const plugins = BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass());
+  const plugins = BUILTIN_PLUGIN_CLASSES.map((PluginClass) =>
+    PluginClass === TaskPlugin
+      ? new TaskPlugin(options.task)
+      : PluginClass === MemoryPlugin
+        ? new MemoryPlugin(options.memory)
+        : PluginClass === ShellPlugin
+          ? new ShellPlugin(options.shell)
+      : new PluginClass(),
+  );
   if (options.image?.image_create && options.image?.image_result) {
     plugins.push(new ImagePlugin(options.image));
   }

package/src/index.ts

@@ -29,6 +29,9 @@ export { WebPlugin } from "./web/Plugin.js";
 export { AsrPlugin } from "./asr/Plugin.js";
 export { TtsPlugin } from "./tts/Plugin.js";
 export { WorkboardPlugin } from "./workboard/Plugin.js";
+export { TaskPlugin } from "./task/TaskPlugin.js";
+export { MemoryPlugin } from "./memory/MemoryPlugin.js";
+export { ShellPlugin } from "./shell/ShellPlugin.js";
 export {
   listChatAuthorizationRoles,
   readChatAuthorizationConfigSync,
@@ -59,6 +62,38 @@ export type {
   ChatPluginOptions,
 } from "./chat/types/ChatPluginOptions.js";
 export type { ContactPluginOptions } from "./contact/types/ContactPluginOptions.js";
+export type { TaskPluginOptions } from "./task/types/TaskPluginOptions.js";
+export type {
+  ResolvedShellPluginOptions,
+  ShellPluginOptions,
+} from "./shell/types/ShellPluginOptions.js";
+export type {
+  MemoryActionPayload,
+  MemoryDefaults,
+  MemoryDigestHandler,
+  MemoryDigestHandlerInput,
+  MemoryDigestHandlerOutput,
+  MemoryDigestPayload,
+  MemoryDigestResponse,
+  MemoryPluginOptions,
+  MemoryReadPayload,
+  MemoryReadResponse,
+  MemoryRememberPayload,
+  MemoryRememberResponse,
+  MemoryReviseHandler,
+  MemoryReviseHandlerInput,
+  MemoryReviseHandlerOutput,
+  MemoryRevisePayload,
+  MemoryReviseResponse,
+  MemorySearchMode,
+  MemorySearchPayload,
+  MemorySearchResponse,
+  MemorySearchResultItem,
+  MemorySourceStat,
+  MemorySourceType,
+  MemoryStatusResponse,
+  MemoryWikiPageDraft,
+} from "./memory/types/Memory.js";
 export type {
   AsrPluginInput,
   AsrPluginOptions,

package/src/memory/Action.ts

@@ -1,21 +1,28 @@
 /**
- * Memory Service Action 逻辑。
+ * Memory Plugin action 逻辑。
  *
  * 关键点（中文）
- * - 只处理业务动作，不包含 CLI/API 参数映射细节。
- * - 所有动作统一返回结构化结果，失败不抛给上层。
+ * - action 面向 agent 的记忆语义：search/read/remember/digest/revise。
+ * - 原始证据先进入 sources，长期知识进入 wiki。
+ * - LLM digest/revise 能力由 MemoryPlugin constructor 注入。
  */
 
+import type { UIDataTypes, UIMessagePart, UITools } from "ai";
+import { isTextUIPart } from "ai";
 import type { PluginActionResult } from "@downcity/agent/internal/plugin/types/Plugin.js";
 import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
 import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
 import type {
-  MemoryFlushPayload,
-  MemoryGetPayload,
+  MemoryDigestPayload,
+  MemoryDigestResponse,
+  MemoryPluginOptions,
+  MemoryReadPayload,
+  MemoryRememberPayload,
+  MemoryRememberResponse,
+  MemoryRevisePayload,
+  MemoryReviseResponse,
   MemorySearchPayload,
-  MemoryStorePayload,
 } from "@/memory/types/Memory.js";
-import { flushMemory } from "./runtime/Flush.js";
 import {
   collectMemoryStatus,
   searchMemory,
@@ -24,7 +31,93 @@ import {
   MEMORY_DEFAULTS,
   type MemoryRuntimeState,
 } from "./runtime/Store.js";
-import { getMemory, storeMemory } from "./runtime/Writer.js";
+import {
+  appendManualSource,
+  appendMemoryRevision,
+  appendWikiPage,
+  readMemory,
+  readWikiIndex,
+  writeSessionSource,
+  writeWikiPage,
+} from "./runtime/Writer.js";
+
+type AnyUiMessagePart = UIMessagePart<UIDataTypes, UITools>;
+
+function toUiParts(message: { parts?: AnyUiMessagePart[] } | null | undefined): AnyUiMessagePart[] {
+  return Array.isArray(message?.parts) ? message.parts : [];
+}
+
+function extractReadableLine(message: {
+  role?: string;
+  parts?: AnyUiMessagePart[];
+}): string {
+  const role = String(message.role || "").toLowerCase() === "user" ? "User" : "Assistant";
+  const text = toUiParts(message)
+    .filter(isTextUIPart)
+    .map((part) => String(part.text || "").trim())
+    .filter(Boolean)
+    .join("\n")
+    .trim();
+  if (!text) {
+    return "";
+  }
+  return `${role}: ${text}`;
+}
+
+function readDigestPages(result: Awaited<ReturnType<NonNullable<MemoryPluginOptions["digest"]>>>): {
+  pages: Array<{ path?: string; title?: string; content: string; tags?: string[] }>;
+  summary?: string;
+} {
+  if (typeof result === "string") {
+    return {
+      pages: [{ title: "Memory Digest", content: result, tags: ["memory", "digest"] }],
+    };
+  }
+  return {
+    pages: result.pages,
+    summary: result.summary,
+  };
+}
+
+function readReviseResult(
+  result: Awaited<ReturnType<NonNullable<MemoryPluginOptions["revise"]>>>,
+  fallbackPath: string,
+): { path: string; content: string; summary?: string } {
+  if (typeof result === "string") {
+    return {
+      path: fallbackPath,
+      content: result,
+    };
+  }
+  return {
+    path: result.path || fallbackPath,
+    content: result.content,
+    summary: result.summary,
+  };
+}
+
+function slugify(value: string): string {
+  const text = String(value || "")
+    .trim()
+    .toLowerCase()
+    .replace(/[^\p{L}\p{N}]+/gu, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 80);
+  return text || "inbox";
+}
+
+function toWikiMemoryPath(value: string): string {
+  const clean = String(value || "").replace(/\\/g, "/").replace(/^\/+/, "").trim();
+  if (!clean) return ".downcity/memory/wiki/inbox.md";
+  if (clean.startsWith(".downcity/memory/wiki/")) {
+    return clean.toLowerCase().endsWith(".md") ? clean : `${clean}.md`;
+  }
+  const withoutPrefix = clean.replace(/^wiki\//, "");
+  const withExt = withoutPrefix.toLowerCase().endsWith(".md")
+    ? withoutPrefix
+    : `${withoutPrefix}.md`;
+  return `.downcity/memory/wiki/${withExt}`;
+}
 
 /**
  * status action。
@@ -70,14 +163,14 @@ export async function searchMemoryAction(
 }
 
 /**
- * get action。
+ * read action。
  */
-export async function getMemoryAction(
+export async function readMemoryAction(
   context: AgentContext,
-  payload: MemoryGetPayload,
+  payload: MemoryReadPayload,
 ): Promise<PluginActionResult<JsonValue>> {
   try {
-    const data = await getMemory(context, payload);
+    const data = await readMemory(context, payload);
     return { success: true, data: data as unknown as JsonValue };
   } catch (error) {
     return {
@@ -88,16 +181,65 @@ export async function getMemoryAction(
 }
 
 /**
- * store action。
+ * remember action。
  */
-export async function storeMemoryAction(
+export async function rememberMemoryAction(
   context: AgentContext,
-  state: MemoryRuntimeState,
-  payload: MemoryStorePayload,
+  options: MemoryPluginOptions,
+  payload: MemoryRememberPayload,
 ): Promise<PluginActionResult<JsonValue>> {
   try {
-    const data = await storeMemory(context, state, payload);
-    return { success: true, data: data as unknown as JsonValue };
+    const content = String(payload.content || "").trim();
+    if (!content) {
+      throw new Error("content is required");
+    }
+    const source = await appendManualSource(context, content, payload.source);
+    const targetPath = toWikiMemoryPath(payload.path || slugify(payload.topic || "inbox"));
+
+    if (options.revise) {
+      const current = await readMemory(context, { path: targetPath }).catch(() => ({
+        path: targetPath,
+        text: "",
+      }));
+      const revised = readReviseResult(
+        await options.revise({
+          rootPath: context.rootPath,
+          path: targetPath,
+          currentContent: current.text,
+          instruction: "Integrate this new memory into the wiki page. Deduplicate and keep it concise.",
+          evidence: `${content}\n\nSource: ${source.path}`,
+        }),
+        targetPath,
+      );
+      const written = await writeWikiPage(context, {
+        path: revised.path,
+        title: payload.topic,
+        content: revised.content,
+        tags: ["memory"],
+      });
+      const response: MemoryRememberResponse = {
+        sourcePath: source.path,
+        wikiPath: written.path,
+        mode: "revised",
+        writtenChars: written.writtenChars,
+        summary: revised.summary,
+      };
+      return { success: true, data: response as unknown as JsonValue };
+    }
+
+    const written = await appendWikiPage(context, {
+      path: targetPath,
+      title: payload.topic || "Memory Inbox",
+      content,
+      sourcePath: source.path,
+    });
+    const response: MemoryRememberResponse = {
+      sourcePath: source.path,
+      wikiPath: written.path,
+      mode: "appended",
+      writtenChars: written.writtenChars,
+    };
+    return { success: true, data: response as unknown as JsonValue };
   } catch (error) {
     return {
       success: false,
@@ -107,16 +249,135 @@ export async function storeMemoryAction(
 }
 
 /**
- * flush action。
+ * digest action。
  */
-export async function flushMemoryAction(
+export async function digestMemoryAction(
   context: AgentContext,
-  state: MemoryRuntimeState,
-  payload: MemoryFlushPayload,
-): Promise<PluginActionResult> {
+  options: MemoryPluginOptions,
+  payload: MemoryDigestPayload,
+): Promise<PluginActionResult<JsonValue>> {
   try {
-    const data = await flushMemory(context, state, payload);
-    return { success: true, data: data as unknown as JsonValue };
+    const sessionId = String(payload.sessionId || "").trim();
+    if (!sessionId) {
+      throw new Error("sessionId is required");
+    }
+    const maxMessages = Number.isFinite(payload.maxMessages)
+      ? Math.max(1, Math.floor(payload.maxMessages as number))
+      : 30;
+    const historyStore = context.session.get(sessionId).getHistoryStore();
+    const total = await historyStore.size();
+    const start = Math.max(0, total - maxMessages);
+    const messages = await historyStore.slice(start, total);
+    const lines = messages
+      .map((msg) => extractReadableLine(msg))
+      .filter((line) => line.length > 0);
+    const transcript =
+      lines.length > 0
+        ? lines.join("\n\n")
+        : "本次 digest 未找到可写入的用户/助手文本内容。";
+    const sourceText = [
+      `Window: ${start}-${Math.max(start, total - 1)}`,
+      "",
+      transcript,
+    ].join("\n");
+    const source = await writeSessionSource(context, sessionId, sourceText);
+
+    if (options.digest) {
+      const wikiIndex = await readWikiIndex(context);
+      const digested = readDigestPages(
+        await options.digest({
+          rootPath: context.rootPath,
+          sourceText,
+          sourcePath: source.path,
+          sessionId,
+          wikiIndex,
+        }),
+      );
+      const wikiPaths: string[] = [];
+      for (const page of digested.pages) {
+        const written = await writeWikiPage(context, page);
+        wikiPaths.push(written.path);
+      }
+      const response: MemoryDigestResponse = {
+        sourcePath: source.path,
+        wikiPaths,
+        messageCount: lines.length,
+        mode: "digested",
+        summary: digested.summary,
+      };
+      return { success: true, data: response as unknown as JsonValue };
+    }
+
+    const written = await appendWikiPage(context, {
+      path: "session-digests",
+      title: "Session Digests",
+      content: sourceText,
+      sourcePath: source.path,
+    });
+    const response: MemoryDigestResponse = {
+      sourcePath: source.path,
+      wikiPaths: [written.path],
+      messageCount: lines.length,
+      mode: "archived",
+    };
+    return { success: true, data: response as unknown as JsonValue };
+  } catch (error) {
+    return {
+      success: false,
+      error: String(error),
+    };
+  }
+}
+
+/**
+ * revise action。
+ */
+export async function reviseMemoryAction(
+  context: AgentContext,
+  options: MemoryPluginOptions,
+  payload: MemoryRevisePayload,
+): Promise<PluginActionResult<JsonValue>> {
+  try {
+    const targetPath = toWikiMemoryPath(String(payload.path || "").trim());
+    if (!targetPath) {
+      throw new Error("path is required");
+    }
+    const instruction = String(payload.instruction || "").trim();
+    if (!instruction) {
+      throw new Error("instruction is required");
+    }
+
+    if (options.revise) {
+      const current = await readMemory(context, { path: targetPath }).catch(() => ({
+        path: targetPath,
+        text: "",
+      }));
+      const revised = readReviseResult(
+        await options.revise({
+          rootPath: context.rootPath,
+          path: targetPath,
+          currentContent: current.text,
+          instruction,
+          evidence: String(payload.evidence || ""),
+        }),
+        targetPath,
+      );
+      const written = await writeWikiPage(context, {
+        path: revised.path,
+        content: revised.content,
+        tags: ["memory"],
+      });
+      const response: MemoryReviseResponse = {
+        path: written.path,
+        mode: "revised",
+        writtenChars: written.writtenChars,
+        summary: revised.summary,
+      };
+      return { success: true, data: response as unknown as JsonValue };
+    }
+
+    const response = await appendMemoryRevision(context, payload);
+    return { success: true, data: response as unknown as JsonValue };
   } catch (error) {
     return {
       success: false,
@@ -143,5 +404,11 @@ export function toSearchPayload(input: Record<string, unknown>): MemorySearchPay
         : typeof input.minScore === "string"
           ? Number(input.minScore)
           : MEMORY_DEFAULTS.minScore,
+    includeSources:
+      typeof input.includeSources === "boolean"
+        ? input.includeSources
+        : typeof input.includeSources === "string"
+          ? input.includeSources === "true"
+          : undefined,
   };
 }