@downcity/agent 1.1.23 → 1.1.32

package/bin/plugin/core/PluginStateController.d.ts

@@ -0,0 +1,82 @@
+/**
+ * PluginStateController：主动型 plugin 状态控制与状态记录模块。
+ */
+import type { AgentContext } from "../../core/AgentContextTypes.js";
+import type { AgentRuntime } from "../../core/AgentCoreTypes.js";
+import type { Plugin, PluginState, PluginStateControlAction, PluginStateControlResult, PluginStateRecord, PluginStateSnapshot } from "../../plugin/types/Plugin.js";
+import type { BasePlugin } from "../../plugin/core/BasePlugin.js";
+/**
+ * 列出当前进程内可见的主动型 plugin 实例。
+ */
+export declare function listPluginInstances(input?: {
+    context?: AgentContext;
+    runtime?: AgentRuntime;
+}): BasePlugin[];
+/**
+ * 按名称解析主动型 plugin 实例。
+ */
+export declare function resolvePluginByName(name: string, input?: {
+    context?: AgentContext;
+    runtime?: AgentRuntime;
+}): BasePlugin | null;
+/**
+ * 确保 plugin 对应的状态记录存在。
+ */
+export declare function ensurePluginStateRecord(plugin: BasePlugin): PluginStateRecord;
+/**
+ * 把内部 record 映射为对外快照。
+ */
+export declare function toPluginStateSnapshot(record: PluginStateRecord, plugin: BasePlugin): PluginStateSnapshot;
+/**
+ * 标记 plugin 当前状态。
+ */
+export declare function markPluginState(record: PluginStateRecord, state: PluginState, error?: string): void;
+/**
+ * 标记最近一次 plugin command。
+ */
+export declare function markPluginCommand(record: PluginStateRecord, command: string): void;
+/**
+ * 返回静态主动型 plugin 定义清单。
+ */
+export declare function getStaticPlugins(): Plugin[];
+/**
+ * 返回主动型 plugin 根命令名清单。
+ */
+export declare function getPluginRootCommandNames(): string[];
+/**
+ * 列出全部主动型 plugin 状态快照。
+ */
+export declare function listPluginStates(input?: {
+    context?: AgentContext;
+    runtime?: AgentRuntime;
+}): PluginStateSnapshot[];
+/**
+ * 判断指定主动型 plugin 是否处于运行中。
+ */
+export declare function isPluginRunning(pluginName: string, input?: {
+    context?: AgentContext;
+    runtime?: AgentRuntime;
+}): boolean;
+/**
+ * 执行单个主动型 plugin 状态控制动作。
+ */
+export declare function controlPluginState(params: {
+    pluginName: string;
+    action: PluginStateControlAction;
+    context: AgentContext;
+}): Promise<PluginStateControlResult>;
+/**
+ * 启动当前上下文中全部主动型 plugin。
+ */
+export declare function startAllPlugins(context: AgentContext): Promise<{
+    success: boolean;
+    results: PluginStateControlResult[];
+}>;
+/**
+ * 停止当前上下文中全部主动型 plugin。
+ */
+export declare function stopAllPlugins(context: AgentContext): Promise<{
+    success: boolean;
+    results: PluginStateControlResult[];
+}>;
+//# sourceMappingURL=PluginStateController.d.ts.map

package/bin/plugin/core/PluginStateController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginStateController.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginStateController.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,MAAM,EAEN,WAAW,EACX,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAU9D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE;IAC1C,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,GAAG,UAAU,EAAE,CAUf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE;IACN,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,GACA,UAAU,GAAG,IAAI,CAInB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,UAAU,GACjB,iBAAiB,CAEnB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,UAAU,GACjB,mBAAmB,CAcrB;AAcD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,GACd,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE;IACvC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,GAAG,mBAAmB,EAAE,CAMxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE;IACN,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,GACA,OAAO,CAIT;AAgED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA8BpC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC,CAAC,CAeD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC,CAAC,CAeD"}

package/bin/plugin/core/PluginStateController.js

@@ -0,0 +1,240 @@
+/**
+ * PluginStateController：主动型 plugin 状态控制与状态记录模块。
+ */
+import { getRegisteredStaticPluginInstances, listRegisteredPluginNames, listRegisteredPlugins, } from "../../plugin/core/PluginClassRegistry.js";
+function nowMs() {
+    return Date.now();
+}
+function resolveLifecycle(plugin) {
+    return plugin.lifecycle;
+}
+/**
+ * 列出当前进程内可见的主动型 plugin 实例。
+ */
+export function listPluginInstances(input) {
+    const contextPlugins = input?.context?.agent?.runtimePlugins;
+    if (contextPlugins instanceof Map && contextPlugins.size > 0) {
+        return [...contextPlugins.values()];
+    }
+    const runtimePlugins = input?.runtime?.runtimePlugins;
+    if (runtimePlugins instanceof Map && runtimePlugins.size > 0) {
+        return [...runtimePlugins.values()];
+    }
+    return [...getRegisteredStaticPluginInstances().values()];
+}
+/**
+ * 按名称解析主动型 plugin 实例。
+ */
+export function resolvePluginByName(name, input) {
+    const key = String(name || "").trim();
+    if (!key)
+        return null;
+    return listPluginInstances(input).find((plugin) => plugin.name === key) || null;
+}
+/**
+ * 确保 plugin 对应的状态记录存在。
+ */
+export function ensurePluginStateRecord(plugin) {
+    return plugin.pluginStateRecord;
+}
+function hasCommandActions(plugin) {
+    return Object.values(plugin.actions).some((action) => Boolean(action.command));
+}
+/**
+ * 把内部 record 映射为对外快照。
+ */
+export function toPluginStateSnapshot(record, plugin) {
+    const lifecycle = resolveLifecycle(plugin);
+    return {
+        name: plugin.name,
+        state: record.state,
+        updatedAt: record.updatedAt,
+        ...(record.lastError ? { lastError: record.lastError } : {}),
+        ...(record.lastCommand ? { lastCommand: record.lastCommand } : {}),
+        ...(typeof record.lastCommandAt === "number"
+            ? { lastCommandAt: record.lastCommandAt }
+            : {}),
+        supportsLifecycle: Boolean(lifecycle?.start || lifecycle?.stop),
+        supportsCommand: Boolean(lifecycle?.command) || hasCommandActions(plugin),
+    };
+}
+async function runSerialByPlugin(record, step) {
+    const next = record.chain.then(() => Promise.resolve(step()));
+    record.chain = next.then(() => undefined, () => undefined);
+    await next;
+}
+/**
+ * 标记 plugin 当前状态。
+ */
+export function markPluginState(record, state, error) {
+    record.state = state;
+    record.updatedAt = nowMs();
+    if (error) {
+        record.lastError = error;
+        return;
+    }
+    delete record.lastError;
+}
+/**
+ * 标记最近一次 plugin command。
+ */
+export function markPluginCommand(record, command) {
+    record.lastCommand = command;
+    record.lastCommandAt = nowMs();
+    record.updatedAt = nowMs();
+}
+/**
+ * 返回静态主动型 plugin 定义清单。
+ */
+export function getStaticPlugins() {
+    return listRegisteredPlugins();
+}
+/**
+ * 返回主动型 plugin 根命令名清单。
+ */
+export function getPluginRootCommandNames() {
+    return listRegisteredPluginNames();
+}
+/**
+ * 列出全部主动型 plugin 状态快照。
+ */
+export function listPluginStates(input) {
+    return listPluginInstances(input)
+        .map((plugin) => toPluginStateSnapshot(ensurePluginStateRecord(plugin), plugin))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * 判断指定主动型 plugin 是否处于运行中。
+ */
+export function isPluginRunning(pluginName, input) {
+    const plugin = resolvePluginByName(pluginName, input);
+    if (!plugin)
+        return false;
+    return ensurePluginStateRecord(plugin).state === "running";
+}
+async function startPluginInternal(plugin, context) {
+    const record = ensurePluginStateRecord(plugin);
+    const lifecycle = resolveLifecycle(plugin);
+    try {
+        await runSerialByPlugin(record, async () => {
+            if (record.state === "running")
+                return;
+            markPluginState(record, "starting");
+            try {
+                await lifecycle?.start?.(context);
+                markPluginState(record, "running");
+            }
+            catch (error) {
+                markPluginState(record, "error", String(error));
+                throw error;
+            }
+        });
+        return {
+            success: true,
+            plugin: toPluginStateSnapshot(record, plugin),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            plugin: toPluginStateSnapshot(record, plugin),
+            error: String(error),
+        };
+    }
+}
+async function stopPluginInternal(plugin, context) {
+    const record = ensurePluginStateRecord(plugin);
+    const lifecycle = resolveLifecycle(plugin);
+    try {
+        await runSerialByPlugin(record, async () => {
+            if (record.state === "stopped")
+                return;
+            markPluginState(record, "stopping");
+            try {
+                await lifecycle?.stop?.(context);
+                markPluginState(record, "stopped");
+            }
+            catch (error) {
+                markPluginState(record, "error", String(error));
+                throw error;
+            }
+        });
+        return {
+            success: true,
+            plugin: toPluginStateSnapshot(record, plugin),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            plugin: toPluginStateSnapshot(record, plugin),
+            error: String(error),
+        };
+    }
+}
+/**
+ * 执行单个主动型 plugin 状态控制动作。
+ */
+export async function controlPluginState(params) {
+    const plugin = resolvePluginByName(params.pluginName, {
+        context: params.context,
+    });
+    if (!plugin) {
+        return {
+            success: false,
+            error: `Unknown plugin: ${params.pluginName}`,
+        };
+    }
+    if (params.action === "status") {
+        const record = ensurePluginStateRecord(plugin);
+        return {
+            success: true,
+            plugin: toPluginStateSnapshot(record, plugin),
+        };
+    }
+    if (params.action === "start") {
+        return await startPluginInternal(plugin, params.context);
+    }
+    if (params.action === "stop") {
+        return await stopPluginInternal(plugin, params.context);
+    }
+    const stopResult = await stopPluginInternal(plugin, params.context);
+    if (!stopResult.success)
+        return stopResult;
+    return await startPluginInternal(plugin, params.context);
+}
+/**
+ * 启动当前上下文中全部主动型 plugin。
+ */
+export async function startAllPlugins(context) {
+    const results = [];
+    for (const plugin of listPluginInstances({ context })) {
+        results.push(await controlPluginState({
+            pluginName: plugin.name,
+            action: "start",
+            context,
+        }));
+    }
+    return {
+        success: results.every((item) => item.success),
+        results,
+    };
+}
+/**
+ * 停止当前上下文中全部主动型 plugin。
+ */
+export async function stopAllPlugins(context) {
+    const results = [];
+    for (const plugin of listPluginInstances({ context })) {
+        results.push(await controlPluginState({
+            pluginName: plugin.name,
+            action: "stop",
+            context,
+        }));
+    }
+    return {
+        success: results.every((item) => item.success),
+        results,
+    };
+}
+//# sourceMappingURL=PluginStateController.js.map

package/bin/plugin/core/PluginStateController.js.map

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

package/bin/plugin/core/PluginSystemProviders.d.ts

@@ -0,0 +1,27 @@
+/**
+ * PluginSystemProviders：plugin system prompt 的静态提供器清单。
+ *
+ * 关键点（中文）
+ * - 这里仅负责收集各 plugin 的 system 文本提供器。
+ * - 不依赖完整 plugin instance，避免把 system 域与 plugin 运行态耦合在一起。
+ * - 这样也能避开 `task -> runner -> prompt system -> plugin class registry` 的循环依赖。
+ */
+import type { AgentContext } from "../../core/AgentContextTypes.js";
+/**
+ * 单个 plugin 的 system provider。
+ */
+export type PluginSystemProvider = {
+    /**
+     * 对应的 plugin 名称。
+     */
+    name: string;
+    /**
+     * 生成该 plugin system 文本的函数。
+     */
+    system: (context: AgentContext) => Promise<string> | string;
+};
+/**
+ * 全部静态 plugin system providers。
+ */
+export declare const PLUGIN_SYSTEM_PROVIDERS: PluginSystemProvider[];
+//# sourceMappingURL=PluginSystemProviders.d.ts.map

package/bin/plugin/core/PluginSystemProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSystemProviders.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginSystemProviders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAC7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,oBAAoB,EAiBzD,CAAC"}

package/bin/plugin/core/PluginSystemProviders.js

@@ -0,0 +1,34 @@
+/**
+ * PluginSystemProviders：plugin system prompt 的静态提供器清单。
+ *
+ * 关键点（中文）
+ * - 这里仅负责收集各 plugin 的 system 文本提供器。
+ * - 不依赖完整 plugin instance，避免把 system 域与 plugin 运行态耦合在一起。
+ * - 这样也能避开 `task -> runner -> prompt system -> plugin class registry` 的循环依赖。
+ */
+import { buildChatPluginSystem } from "../../plugin/builtins/chat/runtime/ChatPluginSystem.js";
+import { buildContactPluginSystemText } from "../../plugin/builtins/contact/runtime/SystemProvider.js";
+import { buildMemoryPluginSystemText } from "../../plugin/builtins/memory/runtime/SystemProvider.js";
+import { TASK_PLUGIN_PROMPT } from "../../plugin/builtins/task/runtime/TaskPluginSystem.js";
+/**
+ * 全部静态 plugin system providers。
+ */
+export const PLUGIN_SYSTEM_PROVIDERS = [
+    {
+        name: "chat",
+        system: buildChatPluginSystem,
+    },
+    {
+        name: "contact",
+        system: buildContactPluginSystemText,
+    },
+    {
+        name: "task",
+        system: () => TASK_PLUGIN_PROMPT,
+    },
+    {
+        name: "memory",
+        system: buildMemoryPluginSystemText,
+    },
+];
+//# sourceMappingURL=PluginSystemProviders.js.map

package/bin/plugin/core/PluginSystemProviders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSystemProviders.js","sourceRoot":"","sources":["../../../src/plugin/core/PluginSystemProviders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,EAAE,4BAA4B,EAAE,MAAM,qDAAqD,CAAC;AACnG,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAgBxF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D;QACE,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,qBAAqB;KAC9B;IACD;QACE,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,4BAA4B;KACrC;IACD;QACE,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,kBAAkB;KACjC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,2BAA2B;KACpC;CACF,CAAC"}

package/bin/plugin/core/schedule/Executor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Runtime plugin Schedule 执行器。
+ *
+ * 关键点（中文）
+ * - 只负责“把到点任务执行掉并更新状态”。
+ * - 不负责调度入口和轮询生命周期管理。
+ */
+import type { AgentContext } from "../../../core/AgentContextTypes.js";
+import type { PluginScheduleStore } from "../../../plugin/core/schedule/Store.js";
+/**
+ * 执行当前已到点的 pending 任务。
+ */
+export declare function runDueScheduledJobs(params: {
+    context: AgentContext;
+    store: PluginScheduleStore;
+}): Promise<void>;
+//# sourceMappingURL=Executor.d.ts.map

package/bin/plugin/core/schedule/Executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Executor.d.ts","sourceRoot":"","sources":["../../../../src/plugin/core/schedule/Executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB"}

package/bin/plugin/core/schedule/Executor.js

@@ -0,0 +1,48 @@
+/**
+ * Runtime plugin Schedule 执行器。
+ *
+ * 关键点（中文）
+ * - 只负责“把到点任务执行掉并更新状态”。
+ * - 不负责调度入口和轮询生命周期管理。
+ */
+import { runPluginCommand } from "../../../plugin/core/Manager.js";
+/**
+ * 执行当前已到点的 pending 任务。
+ */
+export async function runDueScheduledJobs(params) {
+    const dueJobs = params.store.listDuePendingJobs(Date.now());
+    for (const job of dueJobs) {
+        const claimed = params.store.markJobRunning(job.id);
+        if (!claimed)
+            continue;
+        try {
+            const result = await runPluginCommand({
+                pluginName: job.pluginName,
+                command: job.actionName,
+                payload: job.payload,
+                context: params.context,
+            });
+            if (!result.success) {
+                params.store.markJobFailed(job.id, result.message || "scheduled job failed");
+                params.context.logger.warn("[schedule] job failed", {
+                    jobId: job.id,
+                    pluginName: job.pluginName,
+                    actionName: job.actionName,
+                    error: result.message || "scheduled job failed",
+                });
+                continue;
+            }
+            params.store.markJobSucceeded(job.id);
+        }
+        catch (error) {
+            params.store.markJobFailed(job.id, String(error));
+            params.context.logger.warn("[schedule] job failed", {
+                jobId: job.id,
+                pluginName: job.pluginName,
+                actionName: job.actionName,
+                error: String(error),
+            });
+        }
+    }
+}
+//# sourceMappingURL=Executor.js.map

package/bin/plugin/core/schedule/Executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Executor.js","sourceRoot":"","sources":["../../../../src/plugin/core/schedule/Executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAGzC;IACC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;gBACpC,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,OAAO,EAAE,GAAG,CAAC,UAAU;gBACvB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;gBAC7E,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;oBAClD,KAAK,EAAE,GAAG,CAAC,EAAE;oBACb,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,sBAAsB;iBAChD,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBAClD,KAAK,EAAE,GAAG,CAAC,EAAE;gBACb,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/bin/plugin/core/schedule/Store.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Service Schedule 持久化存储。
+ *
+ * 关键点（中文）
+ * - 调度任务改为使用项目内 `jsonl` 事件流持久化，不再依赖 SQLite。
+ * - 这里采用“全量重放 + 内存归并”的最简实现，保持职责清晰且易于迁移。
+ * - 文件只记录状态事件；对外仍暴露稳定的调度任务查询与状态更新接口。
+ */
+import type { CreateScheduledJobInput, ScheduledJobRecord, ScheduledJobStatus } from "../../../plugin/types/PluginSchedule.js";
+/**
+ * Service Schedule Store。
+ */
+export declare class PluginScheduleStore {
+    private readonly filePath;
+    constructor(projectRoot: string);
+    /**
+     * 关闭存储。
+     *
+     * 说明（中文）
+     * - jsonl 版本无需保持长连接，因此 close 为 no-op。
+     */
+    close(): void;
+    /**
+     * 创建调度任务。
+     */
+    createJob(input: CreateScheduledJobInput): ScheduledJobRecord;
+    /**
+     * 获取单个任务。
+     */
+    getJobById(jobId: string): ScheduledJobRecord | null;
+    /**
+     * 列出指定状态的任务。
+     */
+    listJobsByStatus(statuses: ScheduledJobStatus[]): ScheduledJobRecord[];
+    /**
+     * 列出任务。
+     */
+    listJobs(params?: {
+        status?: ScheduledJobStatus;
+        limit?: number;
+    }): ScheduledJobRecord[];
+    /**
+     * 列出已到点且待执行的任务。
+     */
+    listDuePendingJobs(nowMs: number): ScheduledJobRecord[];
+    /**
+     * 启动恢复时，把历史 `running` 回退到 `pending`。
+     */
+    resetRunningJobsToPending(): number;
+    /**
+     * 将任务标记为执行中。
+     */
+    markJobRunning(jobId: string): boolean;
+    /**
+     * 将任务标记为成功。
+     */
+    markJobSucceeded(jobId: string): boolean;
+    /**
+     * 将任务标记为失败。
+     */
+    markJobFailed(jobId: string, error: string): boolean;
+    /**
+     * 将任务标记为取消。
+     */
+    markJobCancelled(jobId: string): boolean;
+    /**
+     * 取消待执行任务。
+     */
+    cancelPendingJob(jobId: string): boolean;
+    /**
+     * 仅读取当前任务快照。
+     */
+    private readJobs;
+    /**
+     * 重放事件流，构造当前任务快照。
+     */
+    private readJobMap;
+    /**
+     * 追加单条事件。
+     */
+    private appendEvent;
+    /**
+     * 执行 pending -> target 的状态迁移。
+     */
+    private transitionPendingJob;
+    /**
+     * 统一写入终态。
+     */
+    private updateTerminalStatus;
+}
+//# sourceMappingURL=Store.d.ts.map

package/bin/plugin/core/schedule/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../../../src/plugin/core/schedule/Store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AA0G1C;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,WAAW,EAAE,MAAM;IAQ/B;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAEb;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB;IAoB7D;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAMpD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE;IAQtE;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,kBAAkB,EAAE;IAWxB;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAMvD;;OAEG;IACH,yBAAyB,IAAI,MAAM;IAenC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOxC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAQpD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOxC;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,UAAU;IAwBlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAiB7B"}