@downcity/agent 1.1.1 → 1.1.5

package/bin/service/core/ServiceActionRunner.js

@@ -0,0 +1,211 @@
+/**
+ * ServiceActionRunner：service action/command 执行模块。
+ *
+ * 关键点（中文）
+ * - 这里只关心 action 命令解析、调度落盘、lifecycle.command 调用。
+ * - service 状态变更交给 ServiceStateController。
+ * - HTTP route 层不会直接实现业务分发，只调用这里的统一入口。
+ */
+import { ServiceScheduleStore } from "../schedule/Store.js";
+import { normalizeRunAtMsOrThrow } from "../schedule/Time.js";
+import { controlServiceState, ensureServiceStateRecord, markServiceState, markServiceCommand, resolveServiceByName, toServiceStateSnapshot, } from "./ServiceStateController.js";
+/**
+ * 按名称解析 service action。
+ */
+export function resolveServiceAction(service, actionName) {
+    const key = String(actionName || "").trim();
+    if (!key)
+        return null;
+    return service.actions[key] || null;
+}
+/**
+ * 执行一个 service action。
+ */
+export async function invokeServiceAction(params) {
+    const action = resolveServiceAction(params.service, params.actionName);
+    if (!action) {
+        return {
+            success: false,
+            error: `Service "${params.service.name}" does not implement action "${params.actionName}"`,
+        };
+    }
+    try {
+        return await action.execute({
+            context: params.context,
+            payload: (params.payload ?? {}),
+            serviceName: params.service.name,
+            actionName: params.actionName,
+        });
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: String(error),
+        };
+    }
+}
+function toControlCommandAction(command) {
+    if (command === "status" ||
+        command === "start" ||
+        command === "stop" ||
+        command === "restart") {
+        return command;
+    }
+    return null;
+}
+async function scheduleServiceAction(params) {
+    try {
+        const scheduleInput = params.schedule;
+        const runAtMs = normalizeRunAtMsOrThrow(scheduleInput.runAtMs, "schedule.runAtMs");
+        const store = new ServiceScheduleStore(params.context.rootPath);
+        try {
+            const job = store.createJob({
+                serviceName: params.service.name,
+                actionName: params.command,
+                payload: params.payload ?? null,
+                runAtMs,
+            });
+            return {
+                success: true,
+                service: params.recordSnapshot,
+                data: {
+                    scheduled: true,
+                    jobId: job.id,
+                    runAtMs: job.runAtMs,
+                    status: job.status,
+                },
+            };
+        }
+        finally {
+            store.close();
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            service: params.recordSnapshot,
+            message: String(error),
+        };
+    }
+}
+/**
+ * 统一执行 service command。
+ *
+ * 关键点（中文）
+ * - action 命令、状态控制命令、lifecycle.command 都走这里。
+ * - 调度能力也是在这里统一处理，而不是散落到 route/CLI 层。
+ */
+export async function runServiceCommand(params) {
+    const service = resolveServiceByName(params.serviceName);
+    if (!service) {
+        return {
+            success: false,
+            message: `Unknown service: ${params.serviceName}`,
+        };
+    }
+    const record = ensureServiceStateRecord(service);
+    const command = String(params.command || "")
+        .trim()
+        .toLowerCase();
+    if (!command) {
+        return {
+            success: false,
+            service: toServiceStateSnapshot(record, service),
+            message: "command is required",
+        };
+    }
+    markServiceCommand(record, command);
+    const action = resolveServiceAction(service, command);
+    if (params.schedule !== undefined && params.schedule !== null) {
+        if (!action) {
+            return {
+                success: false,
+                service: toServiceStateSnapshot(record, service),
+                message: `Scheduling only supports service actions. "${service.name}.${command}" is not a schedulable action.`,
+            };
+        }
+        return await scheduleServiceAction({
+            service,
+            command,
+            payload: params.payload,
+            schedule: params.schedule,
+            recordSnapshot: toServiceStateSnapshot(record, service),
+            context: params.context,
+        });
+    }
+    if (action) {
+        if (record.state !== "running") {
+            return {
+                success: false,
+                service: toServiceStateSnapshot(record, service),
+                message: `Service "${service.name}" is not running`,
+            };
+        }
+        const result = await invokeServiceAction({
+            service,
+            actionName: command,
+            payload: params.payload,
+            context: params.context,
+        });
+        if (!result.success) {
+            return {
+                success: false,
+                service: toServiceStateSnapshot(record, service),
+                message: result.error || "service action failed",
+            };
+        }
+        return {
+            success: true,
+            service: toServiceStateSnapshot(record, service),
+            ...(result.data !== undefined ? { data: result.data } : {}),
+        };
+    }
+    const controlAction = toControlCommandAction(command);
+    if (controlAction) {
+        const result = await controlServiceState({
+            serviceName: service.name,
+            action: controlAction,
+            context: params.context,
+        });
+        return {
+            success: result.success,
+            ...(result.service ? { service: result.service } : {}),
+            ...(result.error ? { message: result.error } : {}),
+        };
+    }
+    if (record.state !== "running") {
+        return {
+            success: false,
+            service: toServiceStateSnapshot(record, service),
+            message: `Service "${service.name}" is not running`,
+        };
+    }
+    const handler = service.lifecycle?.command;
+    if (handler) {
+        try {
+            const result = await handler({
+                context: params.context,
+                command,
+                payload: params.payload,
+            });
+            return {
+                ...result,
+                service: toServiceStateSnapshot(record, service),
+            };
+        }
+        catch (error) {
+            markServiceState(record, "error", String(error));
+            return {
+                success: false,
+                service: toServiceStateSnapshot(record, service),
+                message: String(error),
+            };
+        }
+    }
+    return {
+        success: false,
+        service: toServiceStateSnapshot(record, service),
+        message: `Service "${service.name}" does not implement action "${command}"`,
+    };
+}
+//# sourceMappingURL=ServiceActionRunner.js.map

package/bin/service/core/ServiceActionRunner.js.map

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

package/bin/service/core/ServiceClassRegistry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ServiceClassRegistry：service 类注册表。
+ *
+ * 关键点（中文）
+ * - main 侧维护“service class 如何创建”的静态事实源。
+ * - agent 启动时据此创建 per-agent service instances。
+ * - CLI / 只读场景也复用这里构造无宿主实例，避免维护第二套静态 definition。
+ */
+import type { AgentRuntime } from "../../agent/AgentRuntimeTypes.js";
+import { BaseService } from "../../service/builtins/BaseService.js";
+import type { Service } from "../../shared/types/Service.js";
+/**
+ * 返回全部已注册 service 名称。
+ */
+export declare function listRegisteredServiceNames(): string[];
+/**
+ * 返回全部已注册 service 定义视图。
+ *
+ * 关键点（中文）
+ * - 这里返回的是无宿主实例，适用于 CLI 注册、静态说明等只读场景。
+ * - 不应承载长期运行状态。
+ */
+export declare function listRegisteredServices(): Service[];
+/**
+ * 返回无宿主静态 service 实例集合。
+ *
+ * 关键点（中文）
+ * - 主要用于未初始化 AgentRuntime 的测试/只读场景。
+ * - 需要保持实例稳定，避免 start/status/command 分别拿到不同 null-agent 实例。
+ */
+export declare function getRegisteredStaticServiceInstances(): Map<string, BaseService>;
+/**
+ * 为当前 agent 创建一组 per-agent service instances。
+ *
+ * 关键点（中文）
+ * - 返回 Map，便于 agent 以名称直接索引。
+ * - 允许传入 null，仅用于无需真实 agent 的测试/只读装配场景。
+ */
+export declare function createRegisteredServiceInstances(agent: AgentRuntime | null): Map<string, BaseService>;
+//# sourceMappingURL=ServiceClassRegistry.d.ts.map

package/bin/service/core/ServiceClassRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceClassRegistry.d.ts","sourceRoot":"","sources":["../../../src/service/core/ServiceClassRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAWzD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,EAAE,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAI9E;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,YAAY,GAAG,IAAI,GACzB,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAa1B"}

package/bin/service/core/ServiceClassRegistry.js

@@ -0,0 +1,64 @@
+/**
+ * ServiceClassRegistry：service 类注册表。
+ *
+ * 关键点（中文）
+ * - main 侧维护“service class 如何创建”的静态事实源。
+ * - agent 启动时据此创建 per-agent service instances。
+ * - CLI / 只读场景也复用这里构造无宿主实例，避免维护第二套静态 definition。
+ */
+import { SERVICE_CLASSES } from "../../service/core/Services.js";
+let staticServiceInstances = null;
+function createServiceInstance(ServiceClass, agent) {
+    return new ServiceClass(agent);
+}
+/**
+ * 返回全部已注册 service 名称。
+ */
+export function listRegisteredServiceNames() {
+    return SERVICE_CLASSES.map((ServiceClass) => new ServiceClass(null).name);
+}
+/**
+ * 返回全部已注册 service 定义视图。
+ *
+ * 关键点（中文）
+ * - 这里返回的是无宿主实例，适用于 CLI 注册、静态说明等只读场景。
+ * - 不应承载长期运行状态。
+ */
+export function listRegisteredServices() {
+    return SERVICE_CLASSES.map((ServiceClass) => new ServiceClass(null));
+}
+/**
+ * 返回无宿主静态 service 实例集合。
+ *
+ * 关键点（中文）
+ * - 主要用于未初始化 AgentRuntime 的测试/只读场景。
+ * - 需要保持实例稳定，避免 start/status/command 分别拿到不同 null-agent 实例。
+ */
+export function getRegisteredStaticServiceInstances() {
+    if (staticServiceInstances)
+        return staticServiceInstances;
+    staticServiceInstances = createRegisteredServiceInstances(null);
+    return staticServiceInstances;
+}
+/**
+ * 为当前 agent 创建一组 per-agent service instances。
+ *
+ * 关键点（中文）
+ * - 返回 Map，便于 agent 以名称直接索引。
+ * - 允许传入 null，仅用于无需真实 agent 的测试/只读装配场景。
+ */
+export function createRegisteredServiceInstances(agent) {
+    if (agent === null && staticServiceInstances) {
+        return staticServiceInstances;
+    }
+    const services = new Map();
+    for (const ServiceClass of SERVICE_CLASSES) {
+        const service = createServiceInstance(ServiceClass, agent);
+        services.set(service.name, service);
+    }
+    if (agent === null) {
+        staticServiceInstances = services;
+    }
+    return services;
+}
+//# sourceMappingURL=ServiceClassRegistry.js.map

package/bin/service/core/ServiceClassRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceClassRegistry.js","sourceRoot":"","sources":["../../../src/service/core/ServiceClassRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D,IAAI,sBAAsB,GAAoC,IAAI,CAAC;AAEnE,SAAS,qBAAqB,CAC5B,YAA6D,EAC7D,KAA0B;IAE1B,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC;IACjD,IAAI,sBAAsB;QAAE,OAAO,sBAAsB,CAAC;IAC1D,sBAAsB,GAAG,gCAAgC,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAA0B;IAE1B,IAAI,KAAK,KAAK,IAAI,IAAI,sBAAsB,EAAE,CAAC;QAC7C,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,KAAK,MAAM,YAAY,IAAI,eAAe,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,qBAAqB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC3D,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,sBAAsB,GAAG,QAAQ,CAAC;IACpC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/bin/service/core/ServiceManager.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ServiceManager 类型门面。
+ *
+ * 关键点（中文）
+ * - service 共享契约已经提升到 `src/types/Service.ts`。
+ * - 这里保留旧入口，仅做 re-export，避免 main/service 内部路径继续持有类型定义。
+ */
+export type { Service, ServiceAction, ServiceActionApi, ServiceActionCommand, ServiceActionCommandInput, ServiceActionResult, ServiceActions, ServiceCommandResult, ServiceLifecycle, ServiceState, } from "../../shared/types/Service.js";
+//# sourceMappingURL=ServiceManager.d.ts.map

package/bin/service/core/ServiceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceManager.d.ts","sourceRoot":"","sources":["../../../src/service/core/ServiceManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,GACb,MAAM,2BAA2B,CAAC"}

package/bin/service/core/ServiceManager.js.map

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

package/bin/service/core/ServiceStateController.d.ts

@@ -0,0 +1,79 @@
+/**
+ * ServiceStateController：service 状态控制与状态记录模块。
+ *
+ * 关键点（中文）
+ * - 专门负责 service 状态记录、生命周期控制、状态快照。
+ * - 不处理 action payload，也不处理 HTTP route 注册。
+ * - Manager.ts 只作为门面导出，真正逻辑在这里分层实现。
+ */
+import type { AgentContext } from "../../agent/AgentContextTypes.js";
+import type { ServiceStateControlAction, ServiceStateControlResult, ServiceStateRecord, ServiceStateSnapshot } from "../../shared/types/ServiceState.js";
+import type { BaseService } from "../../service/builtins/BaseService.js";
+import type { Service, ServiceState } from "../../shared/types/Service.js";
+/**
+ * 列出当前进程内可见的 service 实例。
+ *
+ * 关键点（中文）
+ * - 若 agent 已就绪，则返回 per-agent service instances。
+ * - 若 agent 尚未初始化，则退回静态装配实例，方便测试与只读场景。
+ */
+export declare function listServiceInstances(): BaseService[];
+/**
+ * 按名称解析 service 实例。
+ */
+export declare function resolveServiceByName(name: string): BaseService | null;
+/**
+ * 确保 service 对应的状态记录存在。
+ */
+export declare function ensureServiceStateRecord(service: BaseService): ServiceStateRecord;
+/**
+ * 把内部 record 映射为对外快照。
+ */
+export declare function toServiceStateSnapshot(record: ServiceStateRecord, service: BaseService): ServiceStateSnapshot;
+/**
+ * 标记 service 当前状态。
+ */
+export declare function markServiceState(record: ServiceStateRecord, state: ServiceState, error?: string): void;
+/**
+ * 标记最近一次 service command。
+ */
+export declare function markServiceCommand(record: ServiceStateRecord, command: string): void;
+/**
+ * 返回静态 service 定义清单。
+ */
+export declare function getStaticServices(): Service[];
+/**
+ * 返回 service 根命令名清单。
+ */
+export declare function getServiceRootCommandNames(): string[];
+/**
+ * 列出全部 service 状态快照。
+ */
+export declare function listServiceStates(): ServiceStateSnapshot[];
+/**
+ * 判断指定 service 是否处于运行中。
+ */
+export declare function isServiceRunning(serviceName: string): boolean;
+/**
+ * 执行单个 service 状态控制动作。
+ */
+export declare function controlServiceState(params: {
+    serviceName: string;
+    action: ServiceStateControlAction;
+    context: AgentContext;
+}): Promise<ServiceStateControlResult>;
+/**
+ * 启动全部 service。
+ */
+export declare function startAllServices(context: AgentContext): Promise<{
+    success: boolean;
+    results: ServiceStateControlResult[];
+}>;
+/**
+ * 停止全部 service。
+ */
+export declare function stopAllServices(context: AgentContext): Promise<{
+    success: boolean;
+    results: ServiceStateControlResult[];
+}>;
+//# sourceMappingURL=ServiceStateController.d.ts.map

package/bin/service/core/ServiceStateController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceStateController.d.ts","sourceRoot":"","sources":["../../../src/service/core/ServiceStateController.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAOxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAMvE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,EAAE,CAUpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,IAAI,CAIpB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,GACnB,kBAAkB,CAEpB;AAQD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,WAAW,GACnB,oBAAoB,CAetB;AAcD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,GACd,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,oBAAoB,EAAE,CAM1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAI7D;AA8DD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA4BrC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC,CAAC,CAeD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC,CAAC,CAeD"}

package/bin/service/core/ServiceStateController.js

@@ -0,0 +1,245 @@
+/**
+ * ServiceStateController：service 状态控制与状态记录模块。
+ *
+ * 关键点（中文）
+ * - 专门负责 service 状态记录、生命周期控制、状态快照。
+ * - 不处理 action payload，也不处理 HTTP route 注册。
+ * - Manager.ts 只作为门面导出，真正逻辑在这里分层实现。
+ */
+import { getAgentRuntime } from "../../agent/AgentRuntimeState.js";
+import { getRegisteredStaticServiceInstances, listRegisteredServices, listRegisteredServiceNames, } from "../../service/core/ServiceClassRegistry.js";
+function nowMs() {
+    return Date.now();
+}
+/**
+ * 列出当前进程内可见的 service 实例。
+ *
+ * 关键点（中文）
+ * - 若 agent 已就绪，则返回 per-agent service instances。
+ * - 若 agent 尚未初始化，则退回静态装配实例，方便测试与只读场景。
+ */
+export function listServiceInstances() {
+    try {
+        const agent = getAgentRuntime();
+        if (agent.services.size > 0) {
+            return [...agent.services.values()];
+        }
+    }
+    catch {
+        // ignore and fallback
+    }
+    return [...getRegisteredStaticServiceInstances().values()];
+}
+/**
+ * 按名称解析 service 实例。
+ */
+export function resolveServiceByName(name) {
+    const key = String(name || "").trim();
+    if (!key)
+        return null;
+    return listServiceInstances().find((service) => service.name === key) || null;
+}
+/**
+ * 确保 service 对应的状态记录存在。
+ */
+export function ensureServiceStateRecord(service) {
+    return service.serviceStateRecord;
+}
+function hasCommandActions(service) {
+    return Object.values(service.actions).some((action) => Boolean(action.command));
+}
+/**
+ * 把内部 record 映射为对外快照。
+ */
+export function toServiceStateSnapshot(record, service) {
+    const lifecycle = service.lifecycle;
+    return {
+        name: service.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(service),
+    };
+}
+async function runSerialByService(record, step) {
+    const next = record.chain.then(() => Promise.resolve(step()));
+    record.chain = next.then(() => undefined, () => undefined);
+    await next;
+}
+/**
+ * 标记 service 当前状态。
+ */
+export function markServiceState(record, state, error) {
+    record.state = state;
+    record.updatedAt = nowMs();
+    if (error) {
+        record.lastError = error;
+    }
+    else {
+        delete record.lastError;
+    }
+}
+/**
+ * 标记最近一次 service command。
+ */
+export function markServiceCommand(record, command) {
+    record.lastCommand = command;
+    record.lastCommandAt = nowMs();
+    record.updatedAt = nowMs();
+}
+/**
+ * 返回静态 service 定义清单。
+ */
+export function getStaticServices() {
+    return listRegisteredServices();
+}
+/**
+ * 返回 service 根命令名清单。
+ */
+export function getServiceRootCommandNames() {
+    return listRegisteredServiceNames();
+}
+/**
+ * 列出全部 service 状态快照。
+ */
+export function listServiceStates() {
+    return listServiceInstances()
+        .map((service) => toServiceStateSnapshot(ensureServiceStateRecord(service), service))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * 判断指定 service 是否处于运行中。
+ */
+export function isServiceRunning(serviceName) {
+    const service = resolveServiceByName(serviceName);
+    if (!service)
+        return false;
+    return ensureServiceStateRecord(service).state === "running";
+}
+async function startServiceInternal(service, context) {
+    const record = ensureServiceStateRecord(service);
+    try {
+        await runSerialByService(record, async () => {
+            if (record.state === "running")
+                return;
+            markServiceState(record, "starting");
+            try {
+                await service.lifecycle?.start?.(context);
+                markServiceState(record, "running");
+            }
+            catch (error) {
+                markServiceState(record, "error", String(error));
+                throw error;
+            }
+        });
+        return {
+            success: true,
+            service: toServiceStateSnapshot(record, service),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            service: toServiceStateSnapshot(record, service),
+            error: String(error),
+        };
+    }
+}
+async function stopServiceInternal(service, context) {
+    const record = ensureServiceStateRecord(service);
+    try {
+        await runSerialByService(record, async () => {
+            if (record.state === "stopped")
+                return;
+            markServiceState(record, "stopping");
+            try {
+                await service.lifecycle?.stop?.(context);
+                markServiceState(record, "stopped");
+            }
+            catch (error) {
+                markServiceState(record, "error", String(error));
+                throw error;
+            }
+        });
+        return {
+            success: true,
+            service: toServiceStateSnapshot(record, service),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            service: toServiceStateSnapshot(record, service),
+            error: String(error),
+        };
+    }
+}
+/**
+ * 执行单个 service 状态控制动作。
+ */
+export async function controlServiceState(params) {
+    const service = resolveServiceByName(params.serviceName);
+    if (!service) {
+        return {
+            success: false,
+            error: `Unknown service: ${params.serviceName}`,
+        };
+    }
+    if (params.action === "status") {
+        const record = ensureServiceStateRecord(service);
+        return {
+            success: true,
+            service: toServiceStateSnapshot(record, service),
+        };
+    }
+    if (params.action === "start") {
+        return startServiceInternal(service, params.context);
+    }
+    if (params.action === "stop") {
+        return stopServiceInternal(service, params.context);
+    }
+    const stopped = await stopServiceInternal(service, params.context);
+    if (!stopped.success)
+        return stopped;
+    return startServiceInternal(service, params.context);
+}
+/**
+ * 启动全部 service。
+ */
+export async function startAllServices(context) {
+    const results = [];
+    for (const service of listServiceInstances()) {
+        results.push(await controlServiceState({
+            serviceName: service.name,
+            action: "start",
+            context,
+        }));
+    }
+    return {
+        success: results.every((item) => item.success),
+        results,
+    };
+}
+/**
+ * 停止全部 service。
+ */
+export async function stopAllServices(context) {
+    const results = [];
+    for (const service of listServiceInstances()) {
+        results.push(await controlServiceState({
+            serviceName: service.name,
+            action: "stop",
+            context,
+        }));
+    }
+    return {
+        success: results.every((item) => item.success),
+        results,
+    };
+}
+//# sourceMappingURL=ServiceStateController.js.map