@jingyi0605/codingns 0.2.0 → 0.3.0

package/dist/server/modules/tailscale/tailscale-service.d.ts

@@ -0,0 +1,43 @@
+import type Database from "better-sqlite3";
+import type { InstanceTailscaleRepository } from "../../storage/repositories/instance-tailscale-repository.js";
+import type { TailscalePhase } from "../../types/domain.js";
+import type { TailscaleManager } from "./tailscale-manager.js";
+export interface TailscaleConfigUpdateInput {
+    controlServerUrl?: string | null;
+    hostname?: string | null;
+}
+export interface InstanceTailscaleStatusDto {
+    enabled: boolean;
+    controlServerUrl: string | null;
+    hostname: string | null;
+    phase: TailscalePhase;
+    connected: boolean;
+    loginUrl: string | null;
+    accountName: string | null;
+    tailnetFqdn: string | null;
+    tailnetIpv4: string | null;
+    tailnetIpv6: string | null;
+    reachableBaseUrl: string | null;
+    lastError: string | null;
+    observedAt: string | null;
+    updatedAt: string | null;
+}
+export declare class TailscaleService {
+    private readonly db;
+    private readonly repository;
+    private readonly manager;
+    private readonly defaultStateDir;
+    constructor(db: Database.Database, repository: InstanceTailscaleRepository, manager: TailscaleManager, options: {
+        defaultStateDir?: string;
+        databasePath: string;
+    });
+    restoreOnStartup(): Promise<void>;
+    getStatus(): Promise<InstanceTailscaleStatusDto>;
+    updateConfig(input: TailscaleConfigUpdateInput): Promise<InstanceTailscaleStatusDto>;
+    enable(): Promise<InstanceTailscaleStatusDto>;
+    disable(): Promise<InstanceTailscaleStatusDto>;
+    login(): Promise<InstanceTailscaleStatusDto>;
+    logout(): Promise<InstanceTailscaleStatusDto>;
+    private readStateSnapshot;
+    private buildStatusDto;
+}

package/dist/server/modules/tailscale/tailscale-service.js

@@ -0,0 +1,201 @@
+import path from "node:path";
+import { AppError } from "../../shared/errors/app-error.js";
+import { nowIso } from "../../shared/utils/time.js";
+export class TailscaleService {
+    db;
+    repository;
+    manager;
+    defaultStateDir;
+    constructor(db, repository, manager, options) {
+        this.db = db;
+        this.repository = repository;
+        this.manager = manager;
+        this.defaultStateDir = options.defaultStateDir
+            ?? path.join(path.dirname(options.databasePath), "tailscale-state");
+    }
+    async restoreOnStartup() {
+        const snapshot = this.readStateSnapshot();
+        if (!snapshot.hasPersistedConfig) {
+            return;
+        }
+        if (!snapshot.config.enabled) {
+            this.manager.getStatusSync(snapshot.config);
+            return;
+        }
+        await this.manager.restore(snapshot.config);
+    }
+    async getStatus() {
+        const snapshot = this.readStateSnapshot();
+        return this.buildStatusDto(snapshot, await this.manager.getStatus(snapshot.config));
+    }
+    async updateConfig(input) {
+        const snapshot = this.readStateSnapshot();
+        const timestamp = nowIso();
+        const nextConfig = {
+            ...snapshot.config,
+            controlServerUrl: input.controlServerUrl !== undefined
+                ? normalizeControlServerUrl(input.controlServerUrl)
+                : snapshot.config.controlServerUrl,
+            hostname: input.hostname !== undefined
+                ? normalizeHostname(input.hostname)
+                : snapshot.config.hostname,
+            updatedAt: timestamp
+        };
+        const transaction = this.db.transaction(() => {
+            this.repository.upsertConfig(nextConfig);
+            if (nextConfig.enabled) {
+                // 这里只同步状态镜像，不主动发起新的登录动作。
+            }
+        });
+        transaction();
+        if (nextConfig.enabled) {
+            await this.manager.syncConfig(nextConfig);
+        }
+        return await this.getStatus();
+    }
+    async enable() {
+        const snapshot = this.readStateSnapshot();
+        const timestamp = nowIso();
+        const nextConfig = {
+            ...snapshot.config,
+            enabled: true,
+            updatedAt: timestamp
+        };
+        this.repository.upsertConfig(nextConfig);
+        const status = await this.manager.enable(nextConfig);
+        return this.buildStatusDto({
+            config: nextConfig,
+            hasPersistedConfig: true
+        }, status);
+    }
+    async disable() {
+        const snapshot = this.readStateSnapshot();
+        const timestamp = nowIso();
+        const nextConfig = {
+            ...snapshot.config,
+            enabled: false,
+            updatedAt: timestamp
+        };
+        this.repository.upsertConfig(nextConfig);
+        const status = await this.manager.disable(nextConfig);
+        return this.buildStatusDto({
+            config: nextConfig,
+            hasPersistedConfig: true
+        }, status);
+    }
+    async login() {
+        const snapshot = this.readStateSnapshot();
+        if (!snapshot.config.enabled) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "TAILSCALE_NOT_ENABLED",
+                detail: "当前实例尚未启用 Tailscale"
+            });
+        }
+        const status = await this.manager.requestLogin(snapshot.config);
+        return this.buildStatusDto(snapshot, status);
+    }
+    async logout() {
+        const snapshot = this.readStateSnapshot();
+        const status = await this.manager.logout(snapshot.config);
+        return this.buildStatusDto(snapshot, status);
+    }
+    readStateSnapshot() {
+        const persistedConfig = this.repository.findConfig();
+        return {
+            config: persistedConfig
+                ?? {
+                    enabled: false,
+                    controlServerUrl: null,
+                    hostname: null,
+                    stateDir: this.defaultStateDir,
+                    updatedAt: nowIso()
+                },
+            hasPersistedConfig: persistedConfig !== null
+        };
+    }
+    buildStatusDto(snapshot, effectiveStatus) {
+        return {
+            enabled: snapshot.config.enabled,
+            controlServerUrl: snapshot.config.controlServerUrl,
+            hostname: snapshot.config.hostname,
+            phase: effectiveStatus.phase,
+            connected: effectiveStatus.connected,
+            loginUrl: effectiveStatus.loginUrl,
+            accountName: effectiveStatus.accountName,
+            tailnetFqdn: effectiveStatus.tailnetFqdn,
+            tailnetIpv4: effectiveStatus.tailnetIpv4,
+            tailnetIpv6: effectiveStatus.tailnetIpv6,
+            reachableBaseUrl: effectiveStatus.reachableBaseUrl,
+            lastError: effectiveStatus.lastError,
+            observedAt: effectiveStatus.observedAt,
+            updatedAt: snapshot.hasPersistedConfig ? snapshot.config.updatedAt : null
+        };
+    }
+}
+function normalizeControlServerUrl(value) {
+    if (value === null) {
+        return null;
+    }
+    const normalized = value.trim();
+    if (normalized.length === 0) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = new URL(normalized);
+    }
+    catch {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "controlServerUrl 必须是合法的 http 或 https 地址",
+            field: "controlServerUrl"
+        });
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "controlServerUrl 只允许使用 http 或 https 协议",
+            field: "controlServerUrl"
+        });
+    }
+    if (parsed.username || parsed.password || parsed.search || parsed.hash) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "controlServerUrl 不能包含账号、查询参数或 hash",
+            field: "controlServerUrl"
+        });
+    }
+    const pathname = parsed.pathname === "/" ? "" : parsed.pathname.replace(/\/+$/, "");
+    return `${parsed.protocol}//${parsed.host}${pathname}`;
+}
+function normalizeHostname(value) {
+    if (value === null) {
+        return null;
+    }
+    const normalized = value.trim();
+    if (normalized.length === 0) {
+        return null;
+    }
+    if (normalized.length > 63) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "hostname 最长不能超过 63 个字符",
+            field: "hostname"
+        });
+    }
+    if (!/^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(normalized)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "hostname 只允许字母、数字和连字符，且不能以连字符开头或结尾",
+            field: "hostname"
+        });
+    }
+    return normalized;
+}
+//# sourceMappingURL=tailscale-service.js.map

package/dist/server/modules/tailscale/tailscale-service.js.map

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

package/dist/server/modules/tasks/event-loop-monitor.d.ts

@@ -0,0 +1,21 @@
+export interface EventLoopDelaySnapshot {
+    readonly enabled: boolean;
+    readonly resolutionMs: number;
+    readonly minMs: number;
+    readonly maxMs: number;
+    readonly meanMs: number;
+    readonly stddevMs: number;
+    readonly p50Ms: number;
+    readonly p95Ms: number;
+    readonly p99Ms: number;
+}
+export declare class EventLoopMonitor {
+    private readonly resolutionMs;
+    private histogram;
+    constructor(resolutionMs?: number);
+    observe(): EventLoopDelaySnapshot;
+    start(): void;
+    stop(): void;
+    reset(): void;
+    dispose(): void;
+}

package/dist/server/modules/tasks/event-loop-monitor.js

@@ -0,0 +1,64 @@
+import { monitorEventLoopDelay } from "node:perf_hooks";
+export class EventLoopMonitor {
+    resolutionMs;
+    histogram = null;
+    constructor(resolutionMs = 20) {
+        this.resolutionMs = resolutionMs;
+        // 默认不启动采样，只有显式打开调试观测时才开始收集。
+    }
+    observe() {
+        if (!this.histogram) {
+            return {
+                enabled: false,
+                resolutionMs: this.resolutionMs,
+                minMs: 0,
+                maxMs: 0,
+                meanMs: 0,
+                stddevMs: 0,
+                p50Ms: 0,
+                p95Ms: 0,
+                p99Ms: 0
+            };
+        }
+        return {
+            enabled: true,
+            resolutionMs: this.resolutionMs,
+            minMs: toMilliseconds(this.histogram.min),
+            maxMs: toMilliseconds(this.histogram.max),
+            meanMs: toMilliseconds(this.histogram.mean),
+            stddevMs: toMilliseconds(this.histogram.stddev),
+            p50Ms: toMilliseconds(this.histogram.percentile(50)),
+            p95Ms: toMilliseconds(this.histogram.percentile(95)),
+            p99Ms: toMilliseconds(this.histogram.percentile(99))
+        };
+    }
+    start() {
+        if (this.histogram) {
+            return;
+        }
+        this.histogram = monitorEventLoopDelay({
+            resolution: this.resolutionMs
+        });
+        this.histogram.enable();
+    }
+    stop() {
+        if (!this.histogram) {
+            return;
+        }
+        this.histogram.disable();
+        this.histogram = null;
+    }
+    reset() {
+        this.histogram?.reset();
+    }
+    dispose() {
+        this.stop();
+    }
+}
+function toMilliseconds(value) {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return value / 1_000_000;
+}
+//# sourceMappingURL=event-loop-monitor.js.map

package/dist/server/modules/tasks/event-loop-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-loop-monitor.js","sourceRoot":"","sources":["../../../../src/modules/tasks/event-loop-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAcxD,MAAM,OAAO,gBAAgB;IAGE;IAFrB,SAAS,GAAoD,IAAI,CAAC;IAE1E,YAA6B,eAAe,EAAE;QAAjB,iBAAY,GAAZ,YAAY,CAAK;QAC5C,4BAA4B;IAC9B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,CAAC;gBACT,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;aACT,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;YACzC,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;YACzC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC3C,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAC/C,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACpD,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACpD,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;SACrD,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,qBAAqB,CAAC;YACrC,UAAU,EAAE,IAAI,CAAC,YAAY;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;CACF;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,KAAK,GAAG,SAAS,CAAC;AAC3B,CAAC"}

package/dist/server/modules/tasks/observability-controller.d.ts

@@ -0,0 +1,30 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { RuntimeObservabilityService } from "./observability-service.js";
+interface RuntimeObservabilityQuery {
+    sessionId?: string;
+    activityLimit?: string;
+}
+interface RuntimeObservabilitySessionBody {
+    ttlMs?: number;
+}
+interface RuntimeObservabilitySessionParams {
+    sessionId: string;
+}
+export declare class ObservabilityController {
+    private readonly runtimeObservabilityService;
+    constructor(runtimeObservabilityService: RuntimeObservabilityService);
+    readonly createRuntimeSession: (request: FastifyRequest<{
+        Body: RuntimeObservabilitySessionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly heartbeatRuntimeSession: (request: FastifyRequest<{
+        Params: RuntimeObservabilitySessionParams;
+        Body: RuntimeObservabilitySessionBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly closeRuntimeSession: (request: FastifyRequest<{
+        Params: RuntimeObservabilitySessionParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly getRuntimeSnapshot: (request: FastifyRequest<{
+        Querystring: RuntimeObservabilityQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+}
+export {};

package/dist/server/modules/tasks/observability-controller.js

@@ -0,0 +1,44 @@
+import { AppError } from "../../shared/errors/app-error.js";
+export class ObservabilityController {
+    runtimeObservabilityService;
+    constructor(runtimeObservabilityService) {
+        this.runtimeObservabilityService = runtimeObservabilityService;
+    }
+    createRuntimeSession = async (request, reply) => {
+        assertAuthenticated(request);
+        reply.send(this.runtimeObservabilityService.openSession(request.body?.ttlMs));
+    };
+    heartbeatRuntimeSession = async (request, reply) => {
+        assertAuthenticated(request);
+        reply.send(this.runtimeObservabilityService.touchSession(request.params.sessionId, request.body?.ttlMs));
+    };
+    closeRuntimeSession = async (request, reply) => {
+        assertAuthenticated(request);
+        this.runtimeObservabilityService.closeSession(request.params.sessionId);
+        reply.code(204).send();
+    };
+    getRuntimeSnapshot = async (request, reply) => {
+        assertAuthenticated(request);
+        const sessionId = request.query.sessionId?.trim();
+        if (!sessionId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "缺少观测会话 sessionId",
+                field: "sessionId"
+            });
+        }
+        const activityLimit = Number.parseInt(request.query.activityLimit ?? "100", 10);
+        reply.send(this.runtimeObservabilityService.observe(sessionId, activityLimit));
+    };
+}
+function assertAuthenticated(request) {
+    if (!request.auth?.user.userId) {
+        throw new AppError({
+            statusCode: 401,
+            errorCode: "UNAUTHORIZED",
+            detail: "当前请求缺少有效登录态"
+        });
+    }
+}
+//# sourceMappingURL=observability-controller.js.map

package/dist/server/modules/tasks/observability-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-controller.js","sourceRoot":"","sources":["../../../../src/modules/tasks/observability-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAgB5D,MAAM,OAAO,uBAAuB;IACL;IAA7B,YAA6B,2BAAwD;QAAxD,gCAA2B,GAA3B,2BAA2B,CAA6B;IAAG,CAAC;IAEhF,oBAAoB,GAAG,KAAK,EACnC,OAAkE,EAClE,KAAmB,EACJ,EAAE;QACjB,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC;IAEO,uBAAuB,GAAG,KAAK,EACtC,OAGE,EACF,KAAmB,EACJ,EAAE;QACjB,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,2BAA2B,CAAC,YAAY,CAC3C,OAAO,CAAC,MAAM,CAAC,SAAS,EACxB,OAAO,CAAC,IAAI,EAAE,KAAK,CACpB,CACF,CAAC;IACJ,CAAC,CAAC;IAEO,mBAAmB,GAAG,KAAK,EAClC,OAAsE,EACtE,KAAmB,EACJ,EAAE;QACjB,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,2BAA2B,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC,CAAC;IAEO,kBAAkB,GAAG,KAAK,EACjC,OAAmE,EACnE,KAAmB,EACJ,EAAE;QACjB,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAE7B,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;QAElD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,eAAe;gBAC1B,MAAM,EAAE,kBAAkB;gBAC1B,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IACjF,CAAC,CAAC;CACH;AAED,SAAS,mBAAmB,CAAC,OAAuB;IAClD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,QAAQ,CAAC;YACjB,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/server/modules/tasks/observability-service.d.ts

@@ -0,0 +1,32 @@
+import type { TaskMetricsSnapshot } from "./task-types.js";
+import type { SchedulerMetricsSnapshot } from "./scheduler-metrics.js";
+import type { EventLoopDelaySnapshot, EventLoopMonitor } from "./event-loop-monitor.js";
+import type { TaskActivityLog, TaskActivityRecord } from "./task-activity-log.js";
+export interface RuntimeObservabilitySessionLease {
+    readonly sessionId: string;
+    readonly expiresAt: string;
+    readonly ttlMs: number;
+}
+export interface RuntimeObservabilitySnapshot {
+    readonly observedAt: string;
+    readonly session: RuntimeObservabilitySessionLease;
+    readonly backgroundTasks: TaskMetricsSnapshot;
+    readonly recentTaskActivities: TaskActivityRecord[];
+    readonly schedulers: SchedulerMetricsSnapshot;
+    readonly eventLoop: EventLoopDelaySnapshot;
+}
+export declare class RuntimeObservabilityService {
+    private readonly getTaskMetrics;
+    private readonly getSchedulerMetrics;
+    private readonly eventLoopMonitor;
+    private readonly taskActivityLog;
+    private readonly sessions;
+    constructor(getTaskMetrics: () => TaskMetricsSnapshot, getSchedulerMetrics: () => SchedulerMetricsSnapshot, eventLoopMonitor: EventLoopMonitor, taskActivityLog: TaskActivityLog);
+    hasActiveSession(): boolean;
+    openSession(ttlMs?: number): RuntimeObservabilitySessionLease;
+    touchSession(sessionId: string, ttlMs?: number): RuntimeObservabilitySessionLease;
+    closeSession(sessionId: string): void;
+    observe(sessionId: string, activityLimit?: number): RuntimeObservabilitySnapshot;
+    private pruneExpiredSessions;
+    private syncCollectors;
+}

package/dist/server/modules/tasks/observability-service.js

@@ -0,0 +1,104 @@
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+import { AppError } from "../../shared/errors/app-error.js";
+const DEFAULT_SESSION_TTL_MS = 20_000;
+const MIN_SESSION_TTL_MS = 5_000;
+const MAX_SESSION_TTL_MS = 120_000;
+export class RuntimeObservabilityService {
+    getTaskMetrics;
+    getSchedulerMetrics;
+    eventLoopMonitor;
+    taskActivityLog;
+    sessions = new Map();
+    constructor(getTaskMetrics, getSchedulerMetrics, eventLoopMonitor, taskActivityLog) {
+        this.getTaskMetrics = getTaskMetrics;
+        this.getSchedulerMetrics = getSchedulerMetrics;
+        this.eventLoopMonitor = eventLoopMonitor;
+        this.taskActivityLog = taskActivityLog;
+    }
+    hasActiveSession() {
+        this.pruneExpiredSessions();
+        return this.sessions.size > 0;
+    }
+    openSession(ttlMs) {
+        this.pruneExpiredSessions();
+        const normalizedTtlMs = normalizeSessionTtlMs(ttlMs);
+        const sessionId = createId();
+        const expiresAtMs = Date.now() + normalizedTtlMs;
+        this.sessions.set(sessionId, {
+            expiresAtMs,
+            ttlMs: normalizedTtlMs
+        });
+        this.syncCollectors();
+        return buildLease(sessionId, expiresAtMs, normalizedTtlMs);
+    }
+    touchSession(sessionId, ttlMs) {
+        this.pruneExpiredSessions();
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "OBSERVABILITY_SESSION_NOT_FOUND",
+                detail: "观测会话不存在或已过期"
+            });
+        }
+        const normalizedTtlMs = normalizeSessionTtlMs(ttlMs ?? session.ttlMs);
+        session.ttlMs = normalizedTtlMs;
+        session.expiresAtMs = Date.now() + normalizedTtlMs;
+        this.sessions.set(sessionId, session);
+        this.syncCollectors();
+        return buildLease(sessionId, session.expiresAtMs, normalizedTtlMs);
+    }
+    closeSession(sessionId) {
+        this.pruneExpiredSessions();
+        this.sessions.delete(sessionId);
+        this.syncCollectors();
+    }
+    observe(sessionId, activityLimit = 100) {
+        const session = this.touchSession(sessionId);
+        return {
+            observedAt: nowIso(),
+            session,
+            backgroundTasks: this.getTaskMetrics(),
+            recentTaskActivities: this.taskActivityLog.list(activityLimit),
+            schedulers: this.getSchedulerMetrics(),
+            eventLoop: this.eventLoopMonitor.observe()
+        };
+    }
+    pruneExpiredSessions() {
+        const now = Date.now();
+        let changed = false;
+        for (const [sessionId, session] of this.sessions.entries()) {
+            if (session.expiresAtMs > now) {
+                continue;
+            }
+            this.sessions.delete(sessionId);
+            changed = true;
+        }
+        if (changed) {
+            this.syncCollectors();
+        }
+    }
+    syncCollectors() {
+        if (this.sessions.size > 0) {
+            this.eventLoopMonitor.start();
+            return;
+        }
+        this.taskActivityLog.clear();
+        this.eventLoopMonitor.stop();
+    }
+}
+function normalizeSessionTtlMs(value) {
+    if (!value || !Number.isFinite(value)) {
+        return DEFAULT_SESSION_TTL_MS;
+    }
+    return Math.min(MAX_SESSION_TTL_MS, Math.max(MIN_SESSION_TTL_MS, Math.floor(value)));
+}
+function buildLease(sessionId, expiresAtMs, ttlMs) {
+    return {
+        sessionId,
+        expiresAt: new Date(expiresAtMs).toISOString(),
+        ttlMs
+    };
+}
+//# sourceMappingURL=observability-service.js.map

package/dist/server/modules/tasks/observability-service.js.map

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

package/dist/server/modules/tasks/scheduler-metrics.d.ts

@@ -0,0 +1,41 @@
+export interface SchedulerDurationStatsSnapshot {
+    readonly count: number;
+    readonly total: number;
+    readonly max: number;
+    readonly min: number | null;
+    readonly avg: number;
+}
+export interface SchedulerMetricSnapshot {
+    readonly tickTotal: number;
+    readonly idleTickTotal: number;
+    readonly errorTotal: number;
+    readonly taskCountTotal: number;
+    readonly durationMs: SchedulerDurationStatsSnapshot;
+    readonly lastTickAt: string | null;
+    readonly lastDurationMs: number | null;
+    readonly lastTaskCount: number;
+    readonly lastIdle: boolean;
+    readonly lastErrorCount: number;
+    readonly nextDelayMs: number | null;
+    readonly idleStreak: number;
+}
+export interface SchedulerMetricsSnapshot {
+    readonly schedulers: Readonly<Record<string, SchedulerMetricSnapshot>>;
+}
+export interface SchedulerTickObservation {
+    readonly schedulerName: string;
+    readonly referenceAt: string;
+    readonly durationMs: number;
+    readonly taskCount: number;
+    readonly idle: boolean;
+    readonly errorCount?: number;
+    readonly nextDelayMs?: number | null;
+    readonly idleStreak?: number;
+}
+export declare class SchedulerMetrics {
+    private readonly schedulers;
+    recordTick(observation: SchedulerTickObservation): void;
+    observe(): SchedulerMetricsSnapshot;
+    private getState;
+}
+export declare function resolveAdaptiveSchedulerDelayMs(baseIntervalMs: number, maxIntervalMs: number, idleStreak: number): number;