@downcity/agent 1.1.13 → 1.1.14

package/src/service/builtins/task/runtime/Runner.ts

@@ -8,7 +8,7 @@
  * - 把最终产物写入 run 目录的具体格式委托给 `TaskRunArtifacts.ts`。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type {
   DialogueRoundRecord,
   UserSimulatorDecision,

package/src/service/builtins/task/runtime/TaskActionExecution.ts

@@ -6,7 +6,7 @@
  * - task 定义变更后的 scheduler reload 通过回调注入，避免执行层依赖具体 service 实现。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type {
   TaskCronRegisterResult,
   TaskListActionPayload,

package/src/service/builtins/task/runtime/TaskActionInput.ts

@@ -1,13 +1,13 @@
 /**
- * TaskActionInput：task service 的 CLI/API 输入映射模块。
+ * TaskActionInput：task service 的 CLI 输入映射模块。
  *
  * 关键点（中文）
- * - 统一处理命令行与 HTTP 请求到 task action payload 的转换。
+ * - 统一处理命令行到 task action payload 的转换。
  * - 参数校验尽量前置到输入层，避免进入执行层后才发现字段非法。
  */
 
 import { resolveSessionId } from "@session/ids/resolveSessionId.js";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
+import type { JsonValue } from "@/types/common/Json.js";
 import type { ServiceActionCommandInput } from "@/service/types/Service.js";
 import type { ShipTaskKind, ShipTaskStatus } from "@/service/builtins/task/types/Task.js";
 import type {
@@ -19,30 +19,6 @@ import type {
 } from "@/service/builtins/task/types/TaskCommand.js";
 import type { TaskListActionPayload } from "@/service/builtins/task/types/TaskService.js";
 
-function parseJsonBodyObject(rawBody: JsonValue): JsonObject {
-  if (rawBody && typeof rawBody === "object" && !Array.isArray(rawBody)) {
-    return rawBody as JsonObject;
-  }
-  return {};
-}
-
-function getStringField(body: JsonObject, key: string): string {
-  const value = body[key];
-  return typeof value === "string" ? value : "";
-}
-
-function getOptionalStringField(
-  body: JsonObject,
-  key: string,
-): string | undefined {
-  const value = body[key];
-  return typeof value === "string" ? value : undefined;
-}
-
-function getBooleanField(body: JsonObject, key: string): boolean {
-  return body[key] === true;
-}
-
 function parseBooleanLike(value: JsonValue | undefined): boolean | undefined {
   if (typeof value === "boolean") return value;
   if (typeof value !== "string") return undefined;
@@ -53,28 +29,6 @@ function parseBooleanLike(value: JsonValue | undefined): boolean | undefined {
   return undefined;
 }
 
-function getOptionalTaskStatusField(
-  body: JsonObject,
-  key: string,
-): ShipTaskStatus | undefined {
-  const value = body[key];
-  if (value === "enabled" || value === "paused" || value === "disabled") {
-    return value;
-  }
-  return undefined;
-}
-
-function getOptionalTaskKindField(
-  body: JsonObject,
-  key: string,
-): ShipTaskKind | undefined {
-  const value = body[key];
-  if (value === "agent" || value === "script") {
-    return value;
-  }
-  return undefined;
-}
-
 function getStringOpt(
   opts: Record<string, JsonValue>,
   key: string,
@@ -253,101 +207,6 @@ function mapTaskDeleteCommandInput(titleInput: string): TaskDeleteRequest {
   return { title };
 }
 
-function mapTaskListApiInput(query: { status?: string }): TaskListActionPayload {
-  const status = readTaskStatusOrThrow(
-    typeof query.status === "string" ? query.status.trim() : undefined,
-  );
-  return status ? { status } : {};
-}
-
-function mapTaskCreateApiInput(body: JsonObject): TaskCreateRequest {
-  const status = getOptionalTaskStatusField(body, "status");
-  const activate = getBooleanField(body, "activate");
-  if (activate && status && status !== "enabled") {
-    throw new Error("`activate` conflicts with `status` unless status=enabled");
-  }
-  const resolvedStatus = activate ? "enabled" : status;
-
-  return {
-    title: getStringField(body, "title"),
-    when: getStringField(body, "when"),
-    description: getStringField(body, "description"),
-    sessionId: getStringField(body, "sessionId"),
-    kind: getOptionalTaskKindField(body, "kind"),
-    ...(typeof parseBooleanLike(body.review) === "boolean"
-      ? { review: parseBooleanLike(body.review) }
-      : {}),
-    status: resolvedStatus,
-    body: getOptionalStringField(body, "body"),
-    overwrite: getBooleanField(body, "overwrite"),
-  };
-}
-
-function mapTaskRunApiInput(body: JsonObject): TaskRunRequest {
-  return {
-    title: getStringField(body, "title"),
-    ...(getOptionalStringField(body, "reason")
-      ? { reason: getOptionalStringField(body, "reason") }
-      : {}),
-  };
-}
-
-function mapTaskUpdateApiInput(body: JsonObject): TaskUpdateRequest {
-  const status = getOptionalTaskStatusField(body, "status");
-  const activate = getBooleanField(body, "activate");
-  if (activate && status && status !== "enabled") {
-    throw new Error("`activate` conflicts with `status` unless status=enabled");
-  }
-  const resolvedStatus = activate ? "enabled" : status;
-
-  return {
-    title: getStringField(body, "title"),
-    ...(getOptionalStringField(body, "titleNext")
-      ? { titleNext: getOptionalStringField(body, "titleNext") }
-      : {}),
-    ...(getOptionalStringField(body, "description")
-      ? { description: getOptionalStringField(body, "description") }
-      : {}),
-    ...(getOptionalStringField(body, "when")
-      ? { when: getOptionalStringField(body, "when") }
-      : {}),
-    ...(getOptionalStringField(body, "sessionId")
-      ? { sessionId: getOptionalStringField(body, "sessionId") }
-      : {}),
-    ...(getOptionalTaskKindField(body, "kind")
-      ? { kind: getOptionalTaskKindField(body, "kind") }
-      : {}),
-    ...(typeof parseBooleanLike(body.review) === "boolean"
-      ? { review: parseBooleanLike(body.review) }
-      : {}),
-    ...(getBooleanField(body, "clearWhen") ? { clearWhen: true } : {}),
-    ...(resolvedStatus ? { status: resolvedStatus } : {}),
-    ...(getOptionalStringField(body, "body")
-      ? { body: getOptionalStringField(body, "body") }
-      : {}),
-    ...(getBooleanField(body, "clearBody") ? { clearBody: true } : {}),
-  };
-}
-
-function mapTaskStatusApiInput(body: JsonObject): TaskSetStatusRequest {
-  const status = getOptionalTaskStatusField(body, "status");
-  if (!status) {
-    throw new Error("Missing or invalid status");
-  }
-  return {
-    title: getStringField(body, "title"),
-    status,
-  };
-}
-
-function mapTaskDeleteApiInput(body: JsonObject): TaskDeleteRequest {
-  const title = getStringField(body, "title");
-  if (!String(title || "").trim()) {
-    throw new Error("Missing title");
-  }
-  return { title };
-}
-
 export function mapTaskListCommandPayload(
   input: ServiceActionCommandInput,
 ): TaskListActionPayload {
@@ -420,44 +279,3 @@ export function mapTaskDisableCommandPayload(
     status: "disabled",
   });
 }
-
-export function mapTaskListApiPayload(query: {
-  status?: string;
-}): TaskListActionPayload {
-  return mapTaskListApiInput(query);
-}
-
-export async function mapTaskCreateApiPayload(c: {
-  req: { json: () => Promise<JsonValue> };
-}): Promise<TaskCreateRequest> {
-  const body = parseJsonBodyObject(await c.req.json());
-  return mapTaskCreateApiInput(body);
-}
-
-export async function mapTaskRunApiPayload(c: {
-  req: { json: () => Promise<JsonValue> };
-}): Promise<TaskRunRequest> {
-  const body = parseJsonBodyObject(await c.req.json());
-  return mapTaskRunApiInput(body);
-}
-
-export async function mapTaskUpdateApiPayload(c: {
-  req: { json: () => Promise<JsonValue> };
-}): Promise<TaskUpdateRequest> {
-  const body = parseJsonBodyObject(await c.req.json());
-  return mapTaskUpdateApiInput(body);
-}
-
-export async function mapTaskStatusApiPayload(c: {
-  req: { json: () => Promise<JsonValue> };
-}): Promise<TaskSetStatusRequest> {
-  const body = parseJsonBodyObject(await c.req.json());
-  return mapTaskStatusApiInput(body);
-}
-
-export async function mapTaskDeleteApiPayload(c: {
-  req: { json: () => Promise<JsonValue> };
-}): Promise<TaskDeleteRequest> {
-  const body = parseJsonBodyObject(await c.req.json());
-  return mapTaskDeleteApiInput(body);
-}

package/src/service/builtins/task/runtime/TaskRunChatDispatch.ts

@@ -7,7 +7,7 @@
  * - 回发失败只记录日志，不影响 task run 自身状态。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { ShipTaskDefinitionV1 } from "@/service/builtins/task/types/Task.js";
 
 function resolveTaskFinalText(params: {

package/src/service/builtins/task/runtime/TaskRunnerRound.ts

@@ -9,7 +9,7 @@
 import path from "node:path";
 import fs from "fs-extra";
 import { stripInvocationAuthEnv } from "@/server/http/auth/AuthEnv.js";
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import { runSandboxCommand } from "@/sandbox/SandboxRunner.js";
 import type { SessionRunResult } from "@/session/types/SessionRun.js";
 import type { JsonObject } from "@/types/common/Json.js";

package/src/service/builtins/task/runtime/TaskRunnerScript.ts

@@ -6,7 +6,7 @@
  * - 这里集中处理 script 执行、结果校验与进度更新，Runner 主链只消费归一化结果。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type {
   ShipTaskRunExecutionStatusV1,
   ShipTaskRunResultStatusV1,

package/src/service/builtins/task/runtime/TaskRunnerSession.ts

@@ -9,7 +9,7 @@
  */
 
 import path from "node:path";
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { SessionRunResult } from "@/session/types/SessionRun.js";
 import type { TaskSessionRuntimePort } from "@/service/builtins/task/runtime/TaskRunnerTypes.js";
 import { Runner } from "@session/executors/local/Runner.js";

package/src/service/builtins/task/runtime/TaskServiceActions.ts

@@ -2,7 +2,7 @@
  * TaskServiceActions：task service 的 action 注册表模块。
  *
  * 关键点（中文）
- * - 这里专门负责把 task 的 CLI/API/execute 定义装配成 `ServiceActions`。
+ * - 这里专门负责把 task 的 CLI/execute 定义装配成 `ServiceActions`。
  * - TaskService 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
  */
 
@@ -26,19 +26,13 @@ import {
   type TaskSchedulerReloadPort,
 } from "./TaskActionExecution.js";
 import {
-  mapTaskCreateApiPayload,
   mapTaskCreateCommandPayload,
-  mapTaskDeleteApiPayload,
   mapTaskDeleteCommandPayload,
   mapTaskDisableCommandPayload,
   mapTaskEnableCommandPayload,
-  mapTaskListApiPayload,
   mapTaskListCommandPayload,
-  mapTaskRunApiPayload,
   mapTaskRunCommandPayload,
-  mapTaskStatusApiPayload,
   mapTaskStatusCommandPayload,
-  mapTaskUpdateApiPayload,
   mapTaskUpdateCommandPayload,
 } from "./TaskActionInput.js";
 
@@ -60,14 +54,6 @@ export function createTaskServiceActions(params: {
         },
         mapInput: mapTaskListCommandPayload,
       },
-      api: {
-        method: "GET",
-        mapInput(c) {
-          return mapTaskListApiPayload({
-            status: c.req.query("status"),
-          });
-        },
-      },
       execute: async (actionParams) => {
         return executeTaskListAction({
           context: actionParams.context,
@@ -103,10 +89,6 @@ export function createTaskServiceActions(params: {
         },
         mapInput: mapTaskCreateCommandPayload,
       },
-      api: {
-        method: "POST",
-        mapInput: mapTaskCreateApiPayload,
-      },
       execute: async (actionParams) => {
         return executeTaskCreateAction({
           context: actionParams.context,
@@ -125,10 +107,6 @@ export function createTaskServiceActions(params: {
         },
         mapInput: mapTaskRunCommandPayload,
       },
-      api: {
-        method: "POST",
-        mapInput: mapTaskRunApiPayload,
-      },
       execute: async (actionParams) => {
         return executeTaskRunAction({
           context: actionParams.context,
@@ -144,10 +122,6 @@ export function createTaskServiceActions(params: {
         },
         mapInput: mapTaskDeleteCommandPayload,
       },
-      api: {
-        method: "DELETE",
-        mapInput: mapTaskDeleteApiPayload,
-      },
       execute: async (actionParams) => {
         return executeTaskDeleteAction({
           context: actionParams.context,
@@ -180,10 +154,6 @@ export function createTaskServiceActions(params: {
         },
         mapInput: mapTaskUpdateCommandPayload,
       },
-      api: {
-        method: "PUT",
-        mapInput: mapTaskUpdateApiPayload,
-      },
       execute: async (actionParams) => {
         return executeTaskUpdateAction({
           context: actionParams.context,
@@ -200,10 +170,6 @@ export function createTaskServiceActions(params: {
         },
         mapInput: mapTaskStatusCommandPayload,
       },
-      api: {
-        method: "PUT",
-        mapInput: mapTaskStatusApiPayload,
-      },
       execute: async (actionParams) => {
         return executeTaskStatusAction({
           context: actionParams.context,

package/src/service/core/Manager.ts

@@ -22,4 +22,3 @@ export {
   stopAllServices,
 } from "./ServiceStateController.js";
 export { runServiceCommand } from "./ServiceActionRunner.js";
-export { registerAllServicesForServer } from "./ServiceActionApi.js";

package/src/service/core/ServiceActionRunner.ts

@@ -8,7 +8,7 @@
  */
 
 import type { JsonValue } from "@/types/common/Json.js";
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { ServiceCommandScheduleInput } from "@/service/types/ServiceSchedule.js";
 import type {
   ServiceStateControlAction,
@@ -147,7 +147,9 @@ export async function runServiceCommand(params: {
   schedule?: JsonValue | ServiceCommandScheduleInput;
   context: AgentContext;
 }): Promise<ServiceCommandResult & { service?: ServiceStateSnapshot }> {
-  const service = resolveServiceByName(params.serviceName);
+  const service = resolveServiceByName(params.serviceName, {
+    context: params.context,
+  });
   if (!service) {
     return {
       success: false,

package/src/service/core/ServiceClassRegistry.ts

@@ -7,7 +7,7 @@
  * - CLI / 只读场景也复用这里构造无宿主实例，避免维护第二套静态 definition。
  */
 
-import type { AgentRuntime } from "@/runtime/AgentRuntimeTypes.js";
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import { SERVICE_CLASSES } from "@/service/core/Services.js";
 import { BaseService } from "@/service/builtins/BaseService.js";
 import type { Service } from "@/service/types/Service.js";

package/src/service/core/ServiceCommandRequest.ts

@@ -0,0 +1,93 @@
+/**
+ * ServiceCommandRequest：统一 service command 请求解析模块。
+ *
+ * 关键点（中文）
+ * - 统一收口 HTTP / RPC 两种入口的请求体解析。
+ * - service 远程调用只保留 `/api/services/command` 一种协议，不再让 action 自带 HTTP route。
+ * - 通用调度参数（`schedule` / `delay` / `time`）也在这里一次性归一化。
+ */
+
+import type { JsonValue } from "@/types/common/Json.js";
+import type { ServiceCommandScheduleInput } from "@/service/types/ServiceSchedule.js";
+import {
+  normalizeRunAtMsOrThrow,
+  parseScheduledRunAtMsOrThrow,
+} from "@/service/schedule/Time.js";
+
+type JsonRecord = Record<string, unknown>;
+
+/**
+ * 统一 service command 请求体。
+ */
+export type ServiceCommandRequestBody = {
+  /**
+   * 目标 service 名称。
+   */
+  serviceName: string;
+  /**
+   * 目标 command / action 名称。
+   */
+  command: string;
+  /**
+   * 结构化 payload。
+   */
+  payload?: JsonValue;
+  /**
+   * 可选调度信息。
+   */
+  schedule?: ServiceCommandScheduleInput;
+};
+
+function isJsonRecord(value: unknown): value is JsonRecord {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+
+/**
+ * 从统一请求体中提取调度输入。
+ */
+function readScheduleInput(
+  body: JsonRecord,
+): ServiceCommandScheduleInput | undefined {
+  const nestedSchedule = isJsonRecord(body.schedule) ? body.schedule : undefined;
+  const nestedRunAtMs = nestedSchedule?.runAtMs;
+  const topLevelDelay = body.delayMs ?? body.delay;
+  const topLevelTime = body.sendAtMs ?? body.sendAt ?? body.time;
+
+  if (body.schedule !== undefined && !nestedSchedule) {
+    throw new Error("schedule must be an object");
+  }
+  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 };
+}
+
+/**
+ * 解析统一 service command 请求体。
+ */
+export function parseServiceCommandRequestBody(
+  rawBody: JsonValue | undefined,
+): ServiceCommandRequestBody {
+  const body = isJsonRecord(rawBody) ? rawBody : {};
+  const schedule = readScheduleInput(body);
+  return {
+    serviceName: String(body.serviceName || "").trim(),
+    command: String(body.command || "").trim(),
+    ...(body.payload !== undefined ? { payload: body.payload as JsonValue } : {}),
+    ...(schedule ? { schedule } : {}),
+  };
+}

package/src/service/core/ServiceManager.ts

@@ -9,7 +9,6 @@
 export type {
   Service,
   ServiceAction,
-  ServiceActionApi,
   ServiceActionCommand,
   ServiceActionCommandInput,
   ServiceActionResult,

package/src/service/core/ServiceStateController.ts

@@ -7,14 +7,14 @@
  * - Manager.ts 只作为门面导出，真正逻辑在这里分层实现。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import type {
   ServiceStateControlAction,
   ServiceStateControlResult,
   ServiceStateRecord,
   ServiceStateSnapshot,
 } from "@/service/types/ServiceState.js";
-import { getAgentRuntime } from "@/runtime/AgentRuntimeState.js";
 import {
   getRegisteredStaticServiceInstances,
   listRegisteredServices,
@@ -31,17 +31,27 @@ function nowMs(): number {
  * 列出当前进程内可见的 service 实例。
  *
  * 关键点（中文）
- * - 若 agent 已就绪，则返回 per-agent service instances。
- * - 若 agent 尚未初始化，则退回静态装配实例，方便测试与只读场景。
+ * - 优先读取显式传入的实例级 context/runtime。
+ * - 若调用方未传入实例上下文，则只退回静态装配实例，方便测试与只读场景。
  */
-export function listServiceInstances(): BaseService[] {
-  try {
-    const agent = getAgentRuntime();
-    if (agent.services.size > 0) {
-      return [...agent.services.values()];
-    }
-  } catch {
-    // ignore and fallback
+export function listServiceInstances(input?: {
+  context?: AgentContext;
+  runtime?: AgentRuntime;
+}): BaseService[] {
+  return listServiceInstancesFor(input);
+}
+
+function listServiceInstancesFor(input?: {
+  context?: AgentContext;
+  runtime?: AgentRuntime;
+}): BaseService[] {
+  const contextServices = input?.context?.agent?.services;
+  if (contextServices instanceof Map && contextServices.size > 0) {
+    return [...contextServices.values()];
+  }
+  const runtimeServices = input?.runtime?.services;
+  if (runtimeServices instanceof Map && runtimeServices.size > 0) {
+    return [...runtimeServices.values()];
   }
   return [...getRegisteredStaticServiceInstances().values()];
 }
@@ -51,10 +61,14 @@ export function listServiceInstances(): BaseService[] {
  */
 export function resolveServiceByName(
   name: string,
+  input?: {
+    context?: AgentContext;
+    runtime?: AgentRuntime;
+  },
 ): BaseService | null {
   const key = String(name || "").trim();
   if (!key) return null;
-  return listServiceInstances().find((service) => service.name === key) || null;
+  return listServiceInstancesFor(input).find((service) => service.name === key) || null;
 }
 
 /**
@@ -153,8 +167,11 @@ export function getServiceRootCommandNames(): string[] {
 /**
  * 列出全部 service 状态快照。
  */
-export function listServiceStates(): ServiceStateSnapshot[] {
-  return listServiceInstances()
+export function listServiceStates(input?: {
+  context?: AgentContext;
+  runtime?: AgentRuntime;
+}): ServiceStateSnapshot[] {
+  return listServiceInstancesFor(input)
     .map((service) =>
       toServiceStateSnapshot(ensureServiceStateRecord(service), service),
     )
@@ -164,8 +181,14 @@ export function listServiceStates(): ServiceStateSnapshot[] {
 /**
  * 判断指定 service 是否处于运行中。
  */
-export function isServiceRunning(serviceName: string): boolean {
-  const service = resolveServiceByName(serviceName);
+export function isServiceRunning(
+  serviceName: string,
+  input?: {
+    context?: AgentContext;
+    runtime?: AgentRuntime;
+  },
+): boolean {
+  const service = resolveServiceByName(serviceName, input);
   if (!service) return false;
   return ensureServiceStateRecord(service).state === "running";
 }
@@ -238,7 +261,9 @@ export async function controlServiceState(params: {
   action: ServiceStateControlAction;
   context: AgentContext;
 }): Promise<ServiceStateControlResult> {
-  const service = resolveServiceByName(params.serviceName);
+  const service = resolveServiceByName(params.serviceName, {
+    context: params.context,
+  });
   if (!service) {
     return {
       success: false,
@@ -277,7 +302,7 @@ export async function startAllServices(
   results: ServiceStateControlResult[];
 }> {
   const results: ServiceStateControlResult[] = [];
-  for (const service of listServiceInstances()) {
+  for (const service of listServiceInstancesFor({ context })) {
     results.push(
       await controlServiceState({
         serviceName: service.name,
@@ -300,7 +325,7 @@ export async function stopAllServices(context: AgentContext): Promise<{
   results: ServiceStateControlResult[];
 }> {
   const results: ServiceStateControlResult[] = [];
-  for (const service of listServiceInstances()) {
+  for (const service of listServiceInstancesFor({ context })) {
     results.push(
       await controlServiceState({
         serviceName: service.name,

package/src/service/core/ServiceSystemProviders.ts

@@ -7,7 +7,7 @@
  * - 这样也能避开 `task -> runner -> prompt system -> service class registry` 的循环依赖。
  */
 
-import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { AgentContext } from "@/core/AgentContextTypes.js";
 import { buildChatServiceSystem } from "@/service/builtins/chat/runtime/ChatServiceSystem.js";
 import { buildContactServiceSystemText } from "@/service/builtins/contact/runtime/SystemProvider.js";
 import { buildMemoryServiceSystemText } from "@/service/builtins/memory/runtime/SystemProvider.js";

package/src/service/core/Services.ts

@@ -6,13 +6,14 @@
  * - 这里只声明“有哪些 service class”，不承载运行态逻辑。
  */
 
-import type { AgentRuntime } from "@/runtime/AgentRuntimeTypes.js";
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import type { BaseService } from "@/service/builtins/BaseService.js";
 import { ChatService } from "@/service/builtins/chat/ChatService.js";
 import { TaskService } from "@/service/builtins/task/TaskService.js";
 import { MemoryService } from "@/service/builtins/memory/MemoryService.js";
 import { ShellService } from "@/service/builtins/shell/ShellService.js";
 import { ContactService } from "@/service/builtins/contact/ContactService.js";
+import { ScheduleService } from "@/service/builtins/schedule/ScheduleService.js";
 
 /**
  * 单个 service class 构造器。
@@ -27,6 +28,7 @@ export type ServiceClass<T extends BaseService = BaseService> = new (
 export const SERVICE_CLASSES: ServiceClass[] = [
   ChatService,
   ContactService,
+  ScheduleService,
   TaskService,
   MemoryService,
   ShellService,