twinclaw 1.1.0 → 1.1.2

package/{src/api/handlers/health.ts → dist/api/handlers/status.js}

@@ -1,144 +1,149 @@
-import type { Request, Response } from 'express';
-import type { HealthData } from '../../types/api.js';
-import type { SkillRegistry } from '../../services/skill-registry.js';
-import type { McpServerManager } from '../../services/mcp-server-manager.js';
-import type { HeartbeatService } from '../../core/heartbeat.js';
-import type { RuntimeBudgetGovernor } from '../../services/runtime-budget-governor.js';
-import type { LocalStateBackupService } from '../../services/local-state-backup.js';
-import type { ModelRouter } from '../../services/model-router.js';
-import { getSecretVaultService } from '../../services/secret-vault.js';
-import { sendOk } from '../shared.js';
-
-const startTime = Date.now();
-
-export interface HealthDeps {
-    heartbeat: HeartbeatService;
-    skillRegistry: SkillRegistry;
-    mcpManager: McpServerManager;
-    budgetGovernor?: RuntimeBudgetGovernor;
-    localStateBackup?: LocalStateBackupService;
-    modelRouter?: ModelRouter;
-}
-
-/** GET /health — Returns system health status and subsystem summaries. */
-export function handleHealth(deps: HealthDeps) {
-    return async (_req: Request, res: Response): Promise<void> => {
-        const summary = deps.skillRegistry.summary();
-        const servers = deps.mcpManager.listServers();
-        const packageDiagnostics = await deps.mcpManager.getSkillPackageDiagnostics();
-        const secretDiagnostics = getSecretVaultService().getDiagnostics(['API_SECRET']);
-        const budgetSnapshot = deps.budgetGovernor?.getSnapshot('health');
-        const routingSnapshot = deps.modelRouter?.getHealthSnapshot();
-        const backupDiagnostics = deps.localStateBackup
-            ? await deps.localStateBackup.getDiagnostics(5)
-            : null;
-        const heartbeatRunning = deps.heartbeat.scheduler
-            .listJobs()
-            .some((j) => j.status === 'running');
-
-        const data: HealthData = {
-            status:
-                servers.some((s) => s.state === 'error') ||
-                    packageDiagnostics.blockedPackageCount > 0 ||
-                    secretDiagnostics.health.hasIssues ||
-                    budgetSnapshot?.directive.severity === 'hard_limit' ||
-                    (routingSnapshot?.consecutiveFailures ?? 0) >= 3 ||
-                    backupDiagnostics?.status === 'degraded'
-                    ? 'degraded'
-                    : 'ok',
-            uptimeSec: Math.floor((Date.now() - startTime) / 1000),
-            memoryUsageMb: Math.round(process.memoryUsage().rss / 1024 / 1024),
-            heartbeat: { running: heartbeatRunning },
-            skills: {
-                builtin: summary.builtin ?? 0,
-                mcp: summary.mcp ?? 0,
-                total: deps.skillRegistry.size,
-            },
-            skillPackages: {
-                installed: packageDiagnostics.installed.length,
-                active: packageDiagnostics.activePackageCount,
-                blocked: packageDiagnostics.blockedPackageCount,
-                warnings: packageDiagnostics.warnings,
-                violations: packageDiagnostics.violations.map((violation) => ({
-                    packageName: violation.packageName,
-                    version: violation.version,
-                    code: violation.code,
-                    message: violation.message,
-                    remediation: violation.remediation,
-                })),
-            },
-            secrets: {
-                status: secretDiagnostics.health.hasIssues ? 'degraded' : 'ok',
-                missingRequired: secretDiagnostics.health.missingRequired,
-                expired: secretDiagnostics.health.expired,
-                warnings: secretDiagnostics.health.warnings,
-                total: secretDiagnostics.total,
-                active: secretDiagnostics.active,
-                dueForRotation: secretDiagnostics.dueForRotation,
-            },
-            budget: budgetSnapshot
-                ? {
-                    severity: budgetSnapshot.directive.severity,
-                    profile: budgetSnapshot.directive.profile,
-                    pacingDelayMs: budgetSnapshot.directive.pacingDelayMs,
-                    manualProfile: budgetSnapshot.manualProfile,
-                    daily: budgetSnapshot.daily,
-                    session: budgetSnapshot.session,
-                    providers: budgetSnapshot.providers,
-                }
-                : undefined,
-            routing: routingSnapshot,
-            backups: backupDiagnostics
-                ? {
-                    status: backupDiagnostics.status,
-                    lastSnapshotAt: backupDiagnostics.lastSnapshotAt,
-                    lastRestoreAt: backupDiagnostics.lastRestoreAt,
-                    validationFailureCount: backupDiagnostics.validationFailureCount,
-                    recommendationCount: backupDiagnostics.recommendations.length,
-                }
-                : undefined,
-            mcpServers: servers.map((s) => ({
-                id: s.id,
-                name: s.name,
-                state: s.state,
-                toolCount: s.toolCount,
-                health: {
-                    circuit: s.health.state,
-                    failureCount: s.health.metrics.failureCount,
-                    remainingCooldownMs: s.health.remainingCooldownMs,
-                },
-            })),
-        };
-
-        sendOk(res, data);
-    };
-}
-
-/** GET /health/live — Fast liveness probe for orchestrators (e.g. k8s) */
-export function handleLiveness() {
-    return (_req: Request, res: Response): void => {
-        sendOk(res, { status: 'alive', uptimeSec: Math.floor((Date.now() - startTime) / 1000) });
-    };
-}
-
-/** GET /health/ready — Readiness probe for load balancers */
-export function handleReadiness(deps: HealthDeps) {
-    return (_req: Request, res: Response): void => {
-        const heartbeatRunning = deps.heartbeat.scheduler
-            .listJobs()
-            .some((j) => j.status === 'running');
-
-        if (!heartbeatRunning) {
-            res.status(503).json({ status: 'not_ready', reason: 'Heartbeat scheduler offline' });
-            return;
-        }
-
-        const secretDiagnostics = getSecretVaultService().getDiagnostics(['API_SECRET']);
-        if (secretDiagnostics.health.missingRequired.length > 0) {
-            res.status(503).json({ status: 'not_ready', reason: 'Missing critical secrets' });
-            return;
-        }
-
-        sendOk(res, { status: 'ready' });
-    };
-}
+import { getSecretVaultService } from '../../services/secret-vault.js';
+import { sendOk } from '../shared.js';
+const startTime = Date.now();
+function getVersion() {
+    try {
+        const pkg = JSON.parse(require.resolve('../../package.json').replace('file://', ''));
+        return pkg.version ?? '1.0.0';
+    }
+    catch {
+        return '1.0.0';
+    }
+}
+/** GET /status — Unified diagnostics view combining health + budget + routing + jobs + agents + devices */
+export function handleStatus(deps) {
+    return async (_req, res) => {
+        const summary = deps.skillRegistry.summary();
+        const servers = deps.mcpManager.listServers();
+        const packageDiagnostics = await deps.mcpManager.getSkillPackageDiagnostics();
+        const secretDiagnostics = getSecretVaultService().getDiagnostics(['API_SECRET']);
+        const budgetSnapshot = deps.budgetGovernor?.getSnapshot('health');
+        const routingSnapshot = deps.modelRouter?.getHealthSnapshot();
+        const backupDiagnostics = deps.localStateBackup
+            ? await deps.localStateBackup.getDiagnostics(5)
+            : null;
+        const heartbeatRunning = deps.heartbeat.scheduler
+            .listJobs()
+            .some((j) => j.status === 'running');
+        const healthData = {
+            status: servers.some((s) => s.state === 'error') ||
+                packageDiagnostics.blockedPackageCount > 0 ||
+                secretDiagnostics.health.hasIssues ||
+                budgetSnapshot?.directive.severity === 'hard_limit' ||
+                (routingSnapshot?.consecutiveFailures ?? 0) >= 3 ||
+                backupDiagnostics?.status === 'degraded'
+                ? 'degraded'
+                : 'ok',
+            uptimeSec: Math.floor((Date.now() - startTime) / 1000),
+            memoryUsageMb: Math.round(process.memoryUsage().rss / 1024 / 1024),
+            heartbeat: { running: heartbeatRunning },
+            skills: {
+                builtin: summary.builtin ?? 0,
+                mcp: summary.mcp ?? 0,
+                total: deps.skillRegistry.size,
+            },
+            skillPackages: {
+                installed: packageDiagnostics.installed.length,
+                active: packageDiagnostics.activePackageCount,
+                blocked: packageDiagnostics.blockedPackageCount,
+                warnings: packageDiagnostics.warnings,
+                violations: packageDiagnostics.violations.map((violation) => ({
+                    packageName: violation.packageName,
+                    version: violation.version,
+                    code: violation.code,
+                    message: violation.message,
+                    remediation: violation.remediation,
+                })),
+            },
+            secrets: {
+                status: secretDiagnostics.health.hasIssues ? 'degraded' : 'ok',
+                missingRequired: secretDiagnostics.health.missingRequired,
+                expired: secretDiagnostics.health.expired,
+                warnings: secretDiagnostics.health.warnings,
+                total: secretDiagnostics.total,
+                active: secretDiagnostics.active,
+                dueForRotation: secretDiagnostics.dueForRotation,
+            },
+            budget: budgetSnapshot
+                ? {
+                    severity: budgetSnapshot.directive.severity,
+                    profile: budgetSnapshot.directive.profile,
+                    pacingDelayMs: budgetSnapshot.directive.pacingDelayMs,
+                    manualProfile: budgetSnapshot.manualProfile,
+                    daily: budgetSnapshot.daily,
+                    session: budgetSnapshot.session,
+                    providers: budgetSnapshot.providers,
+                }
+                : undefined,
+            routing: routingSnapshot,
+            backups: backupDiagnostics
+                ? {
+                    status: backupDiagnostics.status,
+                    lastSnapshotAt: backupDiagnostics.lastSnapshotAt,
+                    lastRestoreAt: backupDiagnostics.lastRestoreAt,
+                    validationFailureCount: backupDiagnostics.validationFailureCount,
+                    recommendationCount: backupDiagnostics.recommendations.length,
+                }
+                : undefined,
+            mcpServers: servers.map((s) => ({
+                id: s.id,
+                name: s.name,
+                state: s.state,
+                toolCount: s.toolCount,
+                health: {
+                    circuit: s.health.state,
+                    failureCount: s.health.metrics.failureCount,
+                    remainingCooldownMs: s.health.remainingCooldownMs,
+                },
+            })),
+        };
+        const jobList = deps.jobScheduler?.listJobs() ?? [];
+        const agentList = deps.subAgentService?.list() ?? [];
+        const deviceList = deps.devicePairingService?.list() ?? [];
+        const currentIncidents = deps.incidentManager?.getCurrentIncidents() ?? [];
+        const data = {
+            status: healthData.status,
+            uptimeSec: healthData.uptimeSec,
+            memoryUsageMb: healthData.memoryUsageMb,
+            version: getVersion(),
+            health: healthData,
+            jobs: {
+                count: jobList.length,
+                list: jobList.map((j) => ({
+                    id: j.id,
+                    cronExpression: j.cronExpression,
+                    description: j.description,
+                    status: j.status,
+                    lastRunAt: j.lastRunAt?.toISOString() ?? null,
+                    lastError: j.lastError,
+                })),
+            },
+            agents: {
+                count: agentList.length,
+                list: agentList.map((a) => ({
+                    id: a.id,
+                    name: a.name,
+                    status: a.status,
+                    createdAt: a.createdAt.toISOString(),
+                    startedAt: a.startedAt?.toISOString(),
+                    completedAt: a.completedAt?.toISOString(),
+                })),
+            },
+            devices: {
+                count: deviceList.length,
+                list: deviceList.map((d) => ({
+                    deviceId: d.deviceId,
+                    displayName: d.displayName,
+                    platform: d.platform,
+                    status: d.status,
+                    lastSeenAt: d.lastSeenAt,
+                })),
+            },
+            incidents: {
+                safeMode: deps.incidentManager?.isSafeModeEnabled() ?? false,
+                count: currentIncidents.length,
+            },
+        };
+        sendOk(res, data);
+    };
+}