@downcity/agent 1.1.35 → 1.1.51

package/src/plugin/core/schedule/Store.ts

@@ -1,358 +0,0 @@
-/**
- * Plugin Schedule 持久化存储。
- *
- * 关键点（中文）
- * - 调度任务改为使用项目内 `jsonl` 事件流持久化，不再依赖 SQLite。
- * - 这里采用“全量重放 + 内存归并”的最简实现，保持职责清晰且易于迁移。
- * - 文件只记录状态事件；对外仍暴露稳定的调度任务查询与状态更新接口。
- */
-
-import fs from "fs-extra";
-import path from "node:path";
-import type {
-  CreateScheduledJobInput,
-  ScheduledJobRecord,
-  ScheduledJobStatus,
-} from "@/plugin/types/PluginSchedule.js";
-import { generateId } from "@/utils/Id.js";
-import { getDowncityScheduleDbPath } from "@/config/Paths.js";
-
-type ScheduledJobEvent =
-  | {
-      /**
-       * 事件版本号。
-       */
-      v: 1;
-      /**
-       * 事件类型：创建任务。
-       */
-      type: "created";
-      /**
-       * 调度任务快照。
-       */
-      job: ScheduledJobRecord;
-    }
-  | {
-      /**
-       * 事件版本号。
-       */
-      v: 1;
-      /**
-       * 事件类型：状态更新。
-       */
-      type: "status";
-      /**
-       * 目标任务 ID。
-       */
-      jobId: string;
-      /**
-       * 新状态。
-       */
-      status: ScheduledJobStatus;
-      /**
-       * 最新更新时间。
-       */
-      updatedAt: number;
-      /**
-       * 可选错误信息。
-       */
-      error?: string;
-    };
-
-function readJsonlLines(filePath: string): string[] {
-  if (!fs.existsSync(filePath)) return [];
-  const raw = fs.readFileSync(filePath, "utf-8");
-  return raw
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter(Boolean);
-}
-
-function normalizeJobRecord(input: ScheduledJobRecord): ScheduledJobRecord {
-  return {
-    id: String(input.id || "").trim(),
-    pluginName: String(input.pluginName || "").trim(),
-    actionName: String(input.actionName || "").trim(),
-    payload: input.payload ?? null,
-    runAtMs: Math.trunc(input.runAtMs),
-    status: input.status,
-    ...(typeof input.error === "string" && input.error ? { error: input.error } : {}),
-    createdAt: Math.trunc(input.createdAt),
-    updatedAt: Math.trunc(input.updatedAt),
-  };
-}
-
-function parseEvent(line: string): ScheduledJobEvent | null {
-  try {
-    const raw = JSON.parse(line) as Partial<ScheduledJobEvent> | null;
-    if (!raw || typeof raw !== "object") return null;
-    if (raw.type === "created" && raw.job) {
-      return {
-        v: 1,
-        type: "created",
-        job: normalizeJobRecord(raw.job as ScheduledJobRecord),
-      };
-    }
-    if (
-      raw.type === "status" &&
-      typeof raw.jobId === "string" &&
-      typeof raw.status === "string" &&
-      typeof raw.updatedAt === "number"
-    ) {
-      return {
-        v: 1,
-        type: "status",
-        jobId: raw.jobId,
-        status: raw.status as ScheduledJobStatus,
-        updatedAt: Math.trunc(raw.updatedAt),
-        ...(typeof raw.error === "string" ? { error: raw.error } : {}),
-      };
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-
-function compareJobs(a: ScheduledJobRecord, b: ScheduledJobRecord): number {
-  if (a.runAtMs !== b.runAtMs) return a.runAtMs - b.runAtMs;
-  return b.createdAt - a.createdAt;
-}
-
-/**
- * Plugin Schedule Store。
- */
-export class PluginScheduleStore {
-  private readonly filePath: string;
-
-  constructor(projectRoot: string) {
-    this.filePath = getDowncityScheduleDbPath(projectRoot);
-    fs.ensureDirSync(path.dirname(this.filePath));
-    if (!fs.existsSync(this.filePath)) {
-      fs.writeFileSync(this.filePath, "", "utf-8");
-    }
-  }
-
-  /**
-   * 关闭存储。
-   *
-   * 说明（中文）
-   * - jsonl 版本无需保持长连接，因此 close 为 no-op。
-   */
-  close(): void {}
-
-  /**
-   * 创建调度任务。
-   */
-  createJob(input: CreateScheduledJobInput): ScheduledJobRecord {
-    const now = Date.now();
-    const job: ScheduledJobRecord = {
-      id: `sched_${generateId()}`,
-      pluginName: String(input.pluginName || "").trim(),
-      actionName: String(input.actionName || "").trim(),
-      payload: input.payload ?? null,
-      runAtMs: Math.trunc(input.runAtMs),
-      status: "pending",
-      createdAt: now,
-      updatedAt: now,
-    };
-    this.appendEvent({
-      v: 1,
-      type: "created",
-      job,
-    });
-    return job;
-  }
-
-  /**
-   * 获取单个任务。
-   */
-  getJobById(jobId: string): ScheduledJobRecord | null {
-    const key = String(jobId || "").trim();
-    if (!key) return null;
-    return this.readJobMap().get(key) || null;
-  }
-
-  /**
-   * 列出指定状态的任务。
-   */
-  listJobsByStatus(statuses: ScheduledJobStatus[]): ScheduledJobRecord[] {
-    if (statuses.length === 0) return [];
-    const allowed = new Set(statuses);
-    return this.readJobs()
-      .filter((job) => allowed.has(job.status))
-      .sort(compareJobs);
-  }
-
-  /**
-   * 列出任务。
-   */
-  listJobs(params?: {
-    status?: ScheduledJobStatus;
-    limit?: number;
-  }): ScheduledJobRecord[] {
-    const limit =
-      typeof params?.limit === "number" && Number.isFinite(params.limit)
-        ? Math.max(1, Math.trunc(params.limit))
-        : 100;
-    const jobs = this.readJobs()
-      .filter((job) => !params?.status || job.status === params.status)
-      .sort(compareJobs);
-    return jobs.slice(0, limit);
-  }
-
-  /**
-   * 列出已到点且待执行的任务。
-   */
-  listDuePendingJobs(nowMs: number): ScheduledJobRecord[] {
-    return this.readJobs()
-      .filter((job) => job.status === "pending" && job.runAtMs <= Math.trunc(nowMs))
-      .sort(compareJobs);
-  }
-
-  /**
-   * 启动恢复时，把历史 `running` 回退到 `pending`。
-   */
-  resetRunningJobsToPending(): number {
-    const runningJobs = this.readJobs().filter((job) => job.status === "running");
-    const now = Date.now();
-    for (const job of runningJobs) {
-      this.appendEvent({
-        v: 1,
-        type: "status",
-        jobId: job.id,
-        status: "pending",
-        updatedAt: now,
-      });
-    }
-    return runningJobs.length;
-  }
-
-  /**
-   * 将任务标记为执行中。
-   */
-  markJobRunning(jobId: string): boolean {
-    return this.transitionPendingJob(jobId, "running");
-  }
-
-  /**
-   * 将任务标记为成功。
-   */
-  markJobSucceeded(jobId: string): boolean {
-    return this.updateTerminalStatus({
-      jobId,
-      status: "succeeded",
-    });
-  }
-
-  /**
-   * 将任务标记为失败。
-   */
-  markJobFailed(jobId: string, error: string): boolean {
-    return this.updateTerminalStatus({
-      jobId,
-      status: "failed",
-      error,
-    });
-  }
-
-  /**
-   * 将任务标记为取消。
-   */
-  markJobCancelled(jobId: string): boolean {
-    return this.updateTerminalStatus({
-      jobId,
-      status: "cancelled",
-    });
-  }
-
-  /**
-   * 取消待执行任务。
-   */
-  cancelPendingJob(jobId: string): boolean {
-    return this.transitionPendingJob(jobId, "cancelled");
-  }
-
-  /**
-   * 仅读取当前任务快照。
-   */
-  private readJobs(): ScheduledJobRecord[] {
-    return [...this.readJobMap().values()];
-  }
-
-  /**
-   * 重放事件流，构造当前任务快照。
-   */
-  private readJobMap(): Map<string, ScheduledJobRecord> {
-    const jobs = new Map<string, ScheduledJobRecord>();
-    for (const line of readJsonlLines(this.filePath)) {
-      const event = parseEvent(line);
-      if (!event) continue;
-      if (event.type === "created") {
-        jobs.set(event.job.id, normalizeJobRecord(event.job));
-        continue;
-      }
-      const current = jobs.get(event.jobId);
-      if (!current) continue;
-      jobs.set(event.jobId, {
-        ...current,
-        status: event.status,
-        updatedAt: event.updatedAt,
-        ...(event.error ? { error: event.error } : {}),
-        ...(event.status === "succeeded" || event.status === "cancelled"
-          ? { error: undefined }
-          : {}),
-      });
-    }
-    return jobs;
-  }
-
-  /**
-   * 追加单条事件。
-   */
-  private appendEvent(event: ScheduledJobEvent): void {
-    fs.appendFileSync(this.filePath, `${JSON.stringify(event)}\n`, "utf-8");
-  }
-
-  /**
-   * 执行 pending -> target 的状态迁移。
-   */
-  private transitionPendingJob(
-    jobId: string,
-    status: "running" | "cancelled",
-  ): boolean {
-    const current = this.getJobById(jobId);
-    if (!current || current.status !== "pending") {
-      return false;
-    }
-    this.appendEvent({
-      v: 1,
-      type: "status",
-      jobId: current.id,
-      status,
-      updatedAt: Date.now(),
-    });
-    return true;
-  }
-
-  /**
-   * 统一写入终态。
-   */
-  private updateTerminalStatus(params: {
-    jobId: string;
-    status: Exclude<ScheduledJobStatus, "pending" | "running">;
-    error?: string;
-  }): boolean {
-    const current = this.getJobById(params.jobId);
-    if (!current) return false;
-    this.appendEvent({
-      v: 1,
-      type: "status",
-      jobId: current.id,
-      status: params.status,
-      updatedAt: Date.now(),
-      ...(params.error ? { error: String(params.error) } : {}),
-    });
-    return true;
-  }
-}

package/src/plugin/core/schedule/Time.ts

@@ -1,131 +0,0 @@
-/**
- * Plugin Schedule 时间解析工具。
- *
- * 关键点（中文）
- * - 统一解析 `--delay` / `--time` 对应的调度时间。
- * - 输出统一毫秒时间戳，供 command 层与持久化层复用。
- */
-
-/**
- * 判断是否为“缺少时区”的 ISO 时间字符串。
- */
-function looksLikeIsoDatetimeWithoutTimezone(value: string): boolean {
-  const text = String(value || "").trim();
-  if (!text) return false;
-  const isoLike = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}/.test(text);
-  if (!isoLike) return false;
-  return !/(?:Z|[+-]\d{2}:\d{2})$/i.test(text);
-}
-
-/**
- * 解析非负整数。
- */
-function parseNonNegativeIntOptionOrThrow(value: string, fieldName: string): number {
-  const text = String(value || "").trim();
-  if (!text) {
-    throw new Error(`${fieldName} is required`);
-  }
-  if (!/^\d+$/.test(text)) {
-    throw new Error(`Invalid ${fieldName}: ${value}`);
-  }
-  const parsed = Number.parseInt(text, 10);
-  if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed < 0) {
-    throw new Error(`Invalid ${fieldName}: ${value}`);
-  }
-  return parsed;
-}
-
-/**
- * 解析绝对执行时间。
- *
- * 支持格式（中文）
- * - Unix 时间戳秒/毫秒
- * - ISO 时间字符串（必须显式带时区）
- */
-export function parseScheduleTimeOptionOrThrow(
-  value: string,
-  fieldName: string,
-): number {
-  const text = String(value || "").trim();
-  if (!text) {
-    throw new Error(`${fieldName} is required`);
-  }
-
-  if (/^\d+$/.test(text)) {
-    const parsed = Number.parseInt(text, 10);
-    if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
-      throw new Error(`Invalid ${fieldName}: ${value}`);
-    }
-    return parsed < 1_000_000_000_000 ? parsed * 1000 : parsed;
-  }
-
-  if (looksLikeIsoDatetimeWithoutTimezone(text)) {
-    throw new Error(
-      `Invalid ${fieldName}: ${value}. ISO datetime must include timezone offset (e.g. +08:00 or Z).`,
-    );
-  }
-
-  const parsed = Date.parse(text);
-  if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
-    throw new Error(
-      `Invalid ${fieldName}: ${value}. Use Unix timestamp (seconds/ms) or ISO datetime.`,
-    );
-  }
-  return parsed;
-}
-
-/**
- * 解析 command 层调度输入并归一化为绝对毫秒时间戳。
- *
- * 说明（中文）
- * - `delayMs` 与 `time` 只能二选一。
- * - 未传时返回 `undefined`，表示立即执行。
- */
-export function parseScheduledRunAtMsOrThrow(params: {
-  delay?: string | number | undefined;
-  time?: string | number | undefined;
-}): number | undefined {
-  const delayText =
-    params.delay === undefined || params.delay === null
-      ? ""
-      : String(params.delay).trim();
-  const timeText =
-    params.time === undefined || params.time === null
-      ? ""
-      : String(params.time).trim();
-
-  if (delayText && timeText) {
-    throw new Error("`--delay` and `--time` cannot be used together.");
-  }
-
-  if (delayText) {
-    return Date.now() + parseNonNegativeIntOptionOrThrow(delayText, "delay");
-  }
-
-  if (timeText) {
-    return parseScheduleTimeOptionOrThrow(timeText, "time");
-  }
-
-  return undefined;
-}
-
-/**
- * 规范化 API/存储层传入的 runAtMs。
- */
-export function normalizeRunAtMsOrThrow(
-  value: string | number | undefined,
-  fieldName: string,
-): number {
-  const text = String(value ?? "").trim();
-  if (!text) {
-    throw new Error(`${fieldName} is required`);
-  }
-  if (!/^\d+$/.test(text)) {
-    throw new Error(`Invalid ${fieldName}: ${String(value)}`);
-  }
-  const parsed = Number.parseInt(text, 10);
-  if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
-    throw new Error(`Invalid ${fieldName}: ${String(value)}`);
-  }
-  return parsed;
-}

package/src/plugin/types/PluginSchedule.ts

@@ -1,89 +0,0 @@
-/**
- * PluginSchedule：plugin action 调度相关共享类型。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-
-/**
- * 调度任务状态。
- */
-export type ScheduledJobStatus =
-  | "pending"
-  | "running"
-  | "succeeded"
-  | "failed"
-  | "cancelled";
-
-/**
- * 调度任务完整记录。
- */
-export interface ScheduledJobRecord {
-  /**
-   * 调度任务唯一 ID。
-   */
-  id: string;
-  /**
-   * 目标 plugin 名称。
-   */
-  pluginName: string;
-  /**
-   * 目标 action 名称。
-   */
-  actionName: string;
-  /**
-   * 原始 action payload。
-   */
-  payload: JsonValue;
-  /**
-   * 计划执行时间（毫秒时间戳）。
-   */
-  runAtMs: number;
-  /**
-   * 当前调度状态。
-   */
-  status: ScheduledJobStatus;
-  /**
-   * 最近一次错误文本。
-   */
-  error?: string;
-  /**
-   * 创建时间（毫秒时间戳）。
-   */
-  createdAt: number;
-  /**
-   * 最近更新时间（毫秒时间戳）。
-   */
-  updatedAt: number;
-}
-
-/**
- * 创建调度任务所需输入。
- */
-export interface CreateScheduledJobInput {
-  /**
-   * 目标 plugin 名称。
-   */
-  pluginName: string;
-  /**
-   * 目标 action 名称。
-   */
-  actionName: string;
-  /**
-   * 目标 action payload。
-   */
-  payload: JsonValue;
-  /**
-   * 计划执行时间（毫秒时间戳）。
-   */
-  runAtMs: number;
-}
-
-/**
- * 统一 plugin command 调度输入。
- */
-export interface PluginCommandScheduleInput {
-  /**
-   * 计划执行时间（毫秒时间戳）。
-   */
-  runAtMs: number;
-}

package/src/runtime/server/http/control/ModelRoutes.ts

@@ -1,101 +0,0 @@
-/**
- * Control 模型路由。
- *
- * 关键点（中文）
- * - 仅承接当前 agent 视角下的模型展示与切换。
- * - 控制面全局模型池管理仍由 `/api/ui/model*` 处理。
- */
-
-import fs from "fs-extra";
-import { getDowncityJsonPath } from "@/config/Paths.js";
-import type { ControlRouteRegistrationParams } from "@/runtime/server/http/control/types/ControlRoutes.js";
-import { buildControlRouteAliases } from "@/runtime/server/http/control/CommonHelpers.js";
-
-/**
- * 注册模型相关路由。
- */
-export function registerControlModelRoutes(
-  params: ControlRouteRegistrationParams,
-): void {
-  const { app } = params;
-
-  for (const routePath of buildControlRouteAliases("/model")) {
-    app.get(routePath, async (c) => {
-      try {
-        const agentState = params.getAgentRuntime();
-        const agentPrimaryModelId = String(agentState.config.execution?.type === "api" ? agentState.config.execution.modelId || "" : "").trim();
-        const models = agentState.platform.listModels();
-        const providers = await agentState.platform.listProviders();
-        const providerMap = new Map(providers.map((x) => [x.id, x] as const));
-        const activeModel = agentPrimaryModelId
-          ? models.find((x) => x.id === agentPrimaryModelId)
-          : undefined;
-        const providerKey = String(activeModel?.providerId || "").trim();
-        const provider = providerKey ? providerMap.get(providerKey) : undefined;
-        const availableModels = models.map((model) => {
-          const providerConfig = providerMap.get(model.providerId);
-          return {
-            id: model.id,
-            name: model.name,
-            providerKey: model.providerId,
-            providerType: String(providerConfig?.type || "").trim(),
-          };
-        });
-        return c.json({
-          success: true,
-          model: {
-            primaryModelId: agentPrimaryModelId,
-            primaryModelName: String(activeModel?.name || "").trim(),
-            providerKey,
-            providerType: String(provider?.type || "").trim(),
-            baseUrl: String(provider?.baseUrl || "").trim(),
-            agentPrimaryModelId,
-            availableModels,
-          },
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-
-  for (const routePath of buildControlRouteAliases("/model/switch")) {
-    app.post(routePath, async (c) => {
-      try {
-        const agentState = params.getAgentRuntime();
-        const body = (await c.req.json().catch(() => ({}))) as {
-          primaryModelId?: string;
-        };
-        const nextPrimaryModelId = String(body.primaryModelId || "").trim();
-        if (!nextPrimaryModelId) {
-          return c.json({ success: false, error: "Missing primaryModelId" }, 400);
-        }
-        const targetModel = agentState.platform.getModel(nextPrimaryModelId);
-        if (!targetModel) {
-          return c.json(
-            { success: false, error: `Model not found: ${nextPrimaryModelId}` },
-            400,
-          );
-        }
-
-        const shipJsonPath = getDowncityJsonPath(agentState.rootPath);
-        const agentShip = (await fs.readJson(shipJsonPath)) as {
-          execution?: { type?: string; modelId?: string };
-        };
-        agentShip.execution = { type: "api", modelId: nextPrimaryModelId };
-        await fs.writeJson(shipJsonPath, agentShip, { spaces: 2 });
-
-        agentState.config.execution = { type: "api", modelId: nextPrimaryModelId };
-
-        return c.json({
-          success: true,
-          primaryModelId: nextPrimaryModelId,
-          restartRequired: true,
-          message: "Agent primary model updated. Restart agent to fully apply the new model instance.",
-        });
-      } catch (error) {
-        return c.json({ success: false, error: String(error) }, 500);
-      }
-    });
-  }
-}