@downcity/agent 1.1.13 → 1.1.14

package/src/runtime/AgentRuntimeState.ts

@@ -1,213 +0,0 @@
-/**
- * AgentRuntime 进程级状态读写模块。
- *
- * 关键点（中文）
- * - 这里统一维护当前进程中的 base / ready 两阶段状态。
- * - `AgentRuntimeBase` 只表示启动早期已经可用的基础配置；`AgentRuntime` 才表示完整运行态。
- * - 该模块只负责状态持有与读写，不负责装配具体依赖对象。
- */
-
-import type { LanguageModel } from "ai";
-import type {
-  AgentRuntime,
-  AgentRuntimeBase,
-} from "@/runtime/AgentRuntimeTypes.js";
-import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
-import type {
-  AgentPathRuntime,
-  AgentPlatformRuntime,
-  AgentPluginConfigRuntime,
-} from "@/types/host/AgentHost.js";
-import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
-export type { AgentRuntime, AgentRuntimeBase } from "@/runtime/AgentRuntimeTypes.js";
-
-let baseState: AgentRuntimeBase | null = null;
-let readyState: AgentRuntime | null = null;
-
-const EMPTY_PATHS: AgentPathRuntime = {
-  projectRoot: ".",
-  getDowncityDirPath: () => ".downcity",
-  getCacheDirPath: () => ".downcity/.cache",
-  getDowncityChannelDirPath: () => ".downcity/channel",
-  getDowncityChannelMetaPath: () => ".downcity/channel/meta.json",
-  getDowncityChatHistoryPath: (sessionId) => `.downcity/chat/${sessionId}/history.jsonl`,
-  getDowncityMemoryLongTermPath: () => ".downcity/memory/MEMORY.md",
-  getDowncityMemoryDailyDirPath: () => ".downcity/memory/daily",
-  getDowncityMemoryDailyPath: (date) => `.downcity/memory/daily/${date}.md`,
-  getDowncitySessionRootDirPath: () => ".downcity/session",
-  getDowncitySessionDirPath: (sessionId) => `.downcity/session/${sessionId}`,
-};
-
-const EMPTY_PLUGIN_CONFIG: AgentPluginConfigRuntime = {
-  async persistProjectPlugins() {
-    return "";
-  },
-};
-
-const EMPTY_PLATFORM: AgentPlatformRuntime = {
-  getGlobalEnv: () => ({}),
-  getAgentEnv: () => ({}),
-  listModels: () => [],
-  listProviders: async () => [],
-  getModel: () => null,
-  getChannelAccount: () => null,
-  listChannelAccounts: async () => [],
-  probeChannelAccount: async () => {
-    throw new Error("Channel account probing is not available in this runtime");
-  },
-  createChannelAccount: async () => {
-    throw new Error("Channel account creation is not available in this runtime");
-  },
-  updateChannelAccount: async () => {
-    throw new Error("Channel account update is not available in this runtime");
-  },
-  removeChannelAccount: async () => {
-    throw new Error("Channel account removal is not available in this runtime");
-  },
-  resolveChannelAccount: (_params: {
-    projectRoot: string;
-    channel: ChatChannelName;
-    channelAccountId?: string;
-  }) => null,
-  readChatAuthorizationConfig: () => ({
-    roles: {},
-    channels: {},
-  }),
-  writeChatAuthorizationConfig: async (_projectRoot, nextConfig) => nextConfig,
-  setChatAuthorizationUserRole: async () => ({
-    roles: {},
-    channels: {},
-  }),
-  isPluginEnabled: (pluginName) => pluginName === "auth",
-  setPluginEnabled: () => {
-    throw new Error("Plugin lifecycle management is not available in this runtime");
-  },
-  listPlatformModelChoices: async () => [],
-  initializeAgentProject: async () => {
-    throw new Error("Agent project initialization is not available in this runtime");
-  },
-  ensureRuntimeExecutionBindingReady: () => {
-    throw new Error("Execution binding validation is not available in this runtime");
-  },
-};
-
-function normalizeReadyState(input: AgentRuntime): AgentRuntime {
-  if (typeof input.getSession !== "function") {
-    throw new Error("AgentRuntime requires getSession");
-  }
-
-  return {
-    cwd: input.cwd,
-    rootPath: input.rootPath,
-    logger: input.logger,
-    config: input.config,
-    env: input.env,
-    globalEnv: input.globalEnv,
-    systems: input.systems,
-    paths: input.paths || EMPTY_PATHS,
-    pluginConfig: input.pluginConfig || EMPTY_PLUGIN_CONFIG,
-    platform: input.platform || EMPTY_PLATFORM,
-    model: input.model,
-    getSession: input.getSession,
-    listExecutingSessionIds:
-      input.listExecutingSessionIds || (() => []),
-    getExecutingSessionCount:
-      input.getExecutingSessionCount || (() => 0),
-    services: input.services || new Map(),
-  };
-}
-
-function normalizeBaseState(input: AgentRuntimeBase): AgentRuntimeBase {
-  return {
-    cwd: input.cwd,
-    rootPath: input.rootPath,
-    logger: input.logger,
-    config: input.config,
-    env: input.env,
-    globalEnv: input.globalEnv,
-    systems: input.systems,
-    paths: input.paths || EMPTY_PATHS,
-    pluginConfig: input.pluginConfig || EMPTY_PLUGIN_CONFIG,
-    platform: input.platform || EMPTY_PLATFORM,
-  };
-}
-
-/**
- * 设置 agent 基础状态。
- */
-export function setAgentRuntimeBase(next: AgentRuntimeBase): void {
-  baseState = normalizeBaseState(next);
-  readyState = null;
-}
-
-/**
- * 设置完整 agent 状态。
- */
-export function setAgentRuntime(next: AgentRuntime): void {
-  const normalized = normalizeReadyState(next);
-  baseState = normalized;
-  readyState = normalized;
-}
-
-/**
- * 仅更新当前 agent 的项目配置快照。
- *
- * 关键点（中文）
- * - 运行中 agent 可能在不重启进程的情况下收到 downcity.json 变更。
- * - 这里仅替换 `config`，不重建 model / service / session 等长期对象。
- * - 目标是让 plugin 启用态、system 注入等直接依赖配置快照的能力及时生效。
- */
-export function updateAgentRuntimeConfig(nextConfig: DowncityConfig): void {
-  if (!baseState) {
-    throw new Error(
-      "Agent state is not initialized. Call initAgentRuntime() during startup.",
-    );
-  }
-
-  baseState = {
-    ...baseState,
-    config: nextConfig,
-  };
-
-  if (readyState) {
-    readyState = {
-      ...readyState,
-      config: nextConfig,
-    };
-  }
-}
-
-/**
- * 获取 agent 基础状态。
- */
-export function getAgentRuntimeBase(): AgentRuntimeBase {
-  if (baseState) return baseState;
-  throw new Error(
-    "Agent state (base) is not initialized. Call initAgentRuntime() during startup.",
-  );
-}
-
-/**
- * 获取完整 agent 状态。
- */
-export function getAgentRuntime(): AgentRuntime {
-  if (readyState) return readyState;
-  if (!baseState) {
-    throw new Error(
-      "Agent state is not initialized. Call initAgentRuntime() during startup.",
-    );
-  }
-  throw new Error(
-    "Agent state is not ready yet. Ensure session is initialized before access.",
-  );
-}
-
-/**
- * 读取当前 agent 模型实例（必填）。
- */
-export function requireAgentModel(): LanguageModel {
-  if (readyState?.model) return readyState.model;
-  throw new Error(
-    "Agent model is not initialized. Ensure initAgentRuntime() completed successfully.",
-  );
-}

package/src/service/core/ServiceActionApi.ts

@@ -1,304 +0,0 @@
-/**
- * ServiceActionApi：service action 的 HTTP route 注册模块。
- *
- * 关键点（中文）
- * - 专门负责 `/service/<service>/<action>` 路由注册。
- * - 调度字段抽取、payload 清洗、mapInput 桥接都收敛在这里。
- * - 真正执行仍然走 `runServiceCommand` / `invokeServiceAction`。
- */
-
-import type { Context as HonoContext, Hono } from "hono";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
-import type { ServiceCommandScheduleInput } from "@/service/types/ServiceSchedule.js";
-import type { BaseService } from "@/service/builtins/BaseService.js";
-import { parseScheduledRunAtMsOrThrow } from "../schedule/Time.js";
-import { normalizeRunAtMsOrThrow } from "../schedule/Time.js";
-import type { ServiceAction } from "@/service/types/Service.js";
-import {
-  ensureServiceStateRecord,
-  isServiceRunning,
-  listServiceInstances,
-} from "./ServiceStateController.js";
-import {
-  invokeServiceAction,
-  runServiceCommand,
-} from "./ServiceActionRunner.js";
-
-function wrapServiceRouteHandler(
-  serviceName: string,
-  handler: (ctx: HonoContext) => Promise<Response> | Response,
-): (ctx: HonoContext) => Promise<Response> | Response {
-  return async (c) => {
-    if (!isServiceRunning(serviceName)) {
-      return c.json(
-        {
-          success: false,
-          error: `Service "${serviceName}" is stopped`,
-          serviceName,
-        },
-        503,
-      );
-    }
-    return await handler(c);
-  };
-}
-
-function resolveServiceActionApiPath(params: {
-  serviceName: string;
-  actionName: string;
-  action: ServiceAction<JsonValue, JsonValue>;
-}): string {
-  const customPath = String(params.action.api?.path || "").trim();
-  if (customPath) {
-    return customPath.startsWith("/") ? customPath : `/${customPath}`;
-  }
-  return `/service/${params.serviceName}/${params.actionName}`;
-}
-
-function resolveServiceActionApiMethod(
-  action: ServiceAction<JsonValue, JsonValue>,
-): "GET" | "POST" | "PUT" | "DELETE" {
-  return action.api?.method || "POST";
-}
-
-function toQueryPayload(c: HonoContext): JsonObject {
-  const query = c.req.query();
-  const payload: JsonObject = {};
-  for (const [key, value] of Object.entries(query)) {
-    if (typeof value !== "string") continue;
-    payload[key] = value;
-  }
-  return payload;
-}
-
-/**
- * 识别 API 层的通用调度参数。
- *
- * 关键点（中文）
- * - 专用 action API 与统一 `/api/services/command` 共用同一套 delay/time 语义。
- * - 一旦识别为调度参数，就会在传给 action.mapInput 前剥离，避免二次调度。
- */
-function extractApiScheduleInputFromRawPayload(
-  rawPayload: JsonValue,
-): ServiceCommandScheduleInput | undefined {
-  if (!rawPayload || typeof rawPayload !== "object" || Array.isArray(rawPayload)) {
-    return undefined;
-  }
-  const record = rawPayload as Record<string, unknown>;
-  const nestedSchedule =
-    record.schedule && typeof record.schedule === "object" && !Array.isArray(record.schedule)
-      ? (record.schedule as Record<string, unknown>)
-      : undefined;
-  const nestedRunAtMs = nestedSchedule?.runAtMs;
-  const topLevelDelay = record.delayMs ?? record.delay;
-  const topLevelTime = record.sendAtMs ?? record.sendAt ?? record.time;
-
-  if (nestedRunAtMs !== undefined && (topLevelDelay !== undefined || topLevelTime !== undefined)) {
-    throw new Error("`schedule.runAtMs` cannot be used together with `delay/time`.");
-  }
-
-  if (nestedRunAtMs !== undefined) {
-    return {
-      runAtMs: normalizeRunAtMsOrThrow(
-        nestedRunAtMs as string | number | undefined,
-        "schedule.runAtMs",
-      ),
-    };
-  }
-
-  const runAtMs = parseScheduledRunAtMsOrThrow({
-    delay: topLevelDelay as string | number | undefined,
-    time: topLevelTime as string | number | undefined,
-  });
-  if (typeof runAtMs !== "number") return undefined;
-  return { runAtMs };
-}
-
-/**
- * 从原始 payload 中移除 API 层保留的通用调度字段。
- */
-function stripApiScheduleFields(rawPayload: JsonValue): JsonValue {
-  if (!rawPayload || typeof rawPayload !== "object" || Array.isArray(rawPayload)) {
-    return rawPayload;
-  }
-  const record = rawPayload as Record<string, unknown>;
-  const next: Record<string, unknown> = {};
-  for (const [key, value] of Object.entries(record)) {
-    if (
-      key === "schedule" ||
-      key === "delay" ||
-      key === "delayMs" ||
-      key === "time" ||
-      key === "sendAt" ||
-      key === "sendAtMs"
-    ) {
-      continue;
-    }
-    next[key] = value;
-  }
-  return next as JsonValue;
-}
-
-/**
- * 用预读取后的原始 payload 构造 mapInput 专用上下文。
- *
- * 关键点（中文）
- * - 让 route 层可以先统一处理调度参数，再把“净化后的请求体/查询”交给 action 自己解析。
- */
-function createApiMapInputContext(params: {
-  context: HonoContext;
-  rawPayload: JsonValue;
-}): HonoContext {
-  const sanitizedPayload = stripApiScheduleFields(params.rawPayload);
-  const originalReq = params.context.req;
-  const sanitizedQuery =
-    sanitizedPayload && typeof sanitizedPayload === "object" && !Array.isArray(sanitizedPayload)
-      ? (sanitizedPayload as Record<string, string>)
-      : {};
-  const requestShim = {
-    ...originalReq,
-    async json() {
-      return sanitizedPayload;
-    },
-    query(key?: string) {
-      if (typeof key === "string") {
-        return sanitizedQuery[key];
-      }
-      return sanitizedQuery;
-    },
-  };
-  return {
-    ...params.context,
-    req: requestShim as typeof params.context.req,
-  } as HonoContext;
-}
-
-async function mapServiceActionApiPayload(params: {
-  action: ServiceAction<JsonValue, JsonValue>;
-  method: "GET" | "POST" | "PUT" | "DELETE";
-  context: HonoContext;
-}): Promise<{
-  payload: JsonValue;
-  schedule?: ServiceCommandScheduleInput;
-}> {
-  let rawPayload: JsonValue;
-  if (params.method === "GET") {
-    rawPayload = toQueryPayload(params.context);
-  } else {
-    try {
-      rawPayload = (await params.context.req.json()) as JsonValue;
-    } catch {
-      throw new Error("Invalid JSON body");
-    }
-  }
-
-  const schedule = extractApiScheduleInputFromRawPayload(rawPayload);
-  const mapInputContext = createApiMapInputContext({
-    context: params.context,
-    rawPayload,
-  });
-
-  if (params.action.api?.mapInput) {
-    return {
-      payload: await params.action.api.mapInput(mapInputContext),
-      ...(schedule ? { schedule } : {}),
-    };
-  }
-
-  return {
-    payload: stripApiScheduleFields(rawPayload),
-    ...(schedule ? { schedule } : {}),
-  };
-}
-
-function registerServiceActionApiRoute(params: {
-  app: Hono;
-  service: BaseService;
-  actionName: string;
-  action: ServiceAction<JsonValue, JsonValue>;
-  context: AgentContext;
-}): void {
-  const api = params.action.api;
-  if (!api) return;
-
-  const method = resolveServiceActionApiMethod(params.action);
-  const routePath = resolveServiceActionApiPath({
-    serviceName: params.service.name,
-    actionName: params.actionName,
-    action: params.action,
-  });
-
-  const handler = wrapServiceRouteHandler(params.service.name, async (c) => {
-    let payload: JsonValue;
-    let schedule: ServiceCommandScheduleInput | undefined;
-    try {
-      const mapped = await mapServiceActionApiPayload({
-        action: params.action,
-        method,
-        context: c,
-      });
-      payload = mapped.payload;
-      schedule = mapped.schedule;
-    } catch (error) {
-      return c.json(
-        {
-          success: false,
-          error: String(error),
-        },
-        400,
-      );
-    }
-
-    const result = schedule
-      ? await runServiceCommand({
-          serviceName: params.service.name,
-          command: params.actionName,
-          payload,
-          schedule,
-          context: params.context,
-        })
-      : await invokeServiceAction({
-          service: params.service,
-          actionName: params.actionName,
-          payload,
-          context: params.context,
-        });
-    return c.json(result, result.success ? 200 : 400);
-  });
-
-  if (method === "GET") {
-    params.app.get(routePath, handler);
-    return;
-  }
-  if (method === "POST") {
-    params.app.post(routePath, handler);
-    return;
-  }
-  if (method === "PUT") {
-    params.app.put(routePath, handler);
-    return;
-  }
-  params.app.delete(routePath, handler);
-}
-
-/**
- * 为服务端注册全部 service action API。
- */
-export function registerAllServicesForServer(
-  app: Hono,
-  context: AgentContext,
-): void {
-  for (const service of listServiceInstances()) {
-    ensureServiceStateRecord(service);
-    for (const [actionName, action] of Object.entries(service.actions)) {
-      registerServiceActionApiRoute({
-        app,
-        service,
-        actionName,
-        action,
-        context,
-      });
-    }
-  }
-}

package/src/service/schedule/Runtime.ts

@@ -1,78 +0,0 @@
-/**
- * Service Schedule runtime。
- *
- * 关键点（中文）
- * - 使用轻量轮询驱动到点执行，避免为 MVP 引入复杂定时器注册与恢复逻辑。
- * - runtime 重启时会把遗留 `running` 任务回退成 `pending`，然后继续补执行。
- */
-
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
-import { ServiceScheduleStore } from "./Store.js";
-import { runDueScheduledJobs } from "./Executor.js";
-
-const SCHEDULE_POLL_INTERVAL_MS = 200;
-
-type ServiceScheduleRuntimeState = {
-  timer: NodeJS.Timeout | null;
-  ticking: boolean;
-  store: ServiceScheduleStore;
-  context: AgentContext;
-};
-
-let runtimeState: ServiceScheduleRuntimeState | null = null;
-
-/**
- * 启动持久化调度 runtime。
- */
-export async function startServiceScheduleRuntime(
-  context: AgentContext,
-): Promise<void> {
-  if (runtimeState) return;
-
-  const store = new ServiceScheduleStore(context.rootPath);
-  const recovered = store.resetRunningJobsToPending();
-  if (recovered > 0) {
-    context.logger.warn("[schedule] recovered interrupted running jobs", {
-      recovered,
-    });
-  }
-
-  runtimeState = {
-    timer: null,
-    ticking: false,
-    store,
-    context,
-  };
-
-  const tick = async () => {
-    if (!runtimeState || runtimeState.ticking) return;
-    runtimeState.ticking = true;
-    try {
-      await runDueScheduledJobs({
-        context: runtimeState.context,
-        store: runtimeState.store,
-      });
-    } finally {
-      if (runtimeState) {
-        runtimeState.ticking = false;
-      }
-    }
-  };
-
-  await tick();
-  runtimeState.timer = setInterval(() => {
-    void tick();
-  }, SCHEDULE_POLL_INTERVAL_MS);
-}
-
-/**
- * 停止持久化调度 runtime。
- */
-export async function stopServiceScheduleRuntime(): Promise<void> {
-  if (!runtimeState) return;
-  if (runtimeState.timer) {
-    clearInterval(runtimeState.timer);
-  }
-  runtimeState.store.close();
-  runtimeState = null;
-}