@hivemagnus/magnus-server 0.0.0-stage → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (356) hide show
  1. package/.env.example +171 -0
  2. package/LICENSE +202 -0
  3. package/README.md +169 -2
  4. package/agent-version.json +1 -0
  5. package/dist/ai/HEARTBEAT.md +56 -0
  6. package/dist/ai/IDENTITY.md +54 -0
  7. package/dist/ai/MEMORY.md +40 -0
  8. package/dist/ai/TOOLS.md +538 -0
  9. package/dist/ai/USER.md +32 -0
  10. package/dist/cli/args.js +62 -0
  11. package/dist/cli/env-catalog.js +131 -0
  12. package/dist/cli/preflight.js +89 -0
  13. package/dist/cli.js +175 -0
  14. package/dist/config/cors.js +16 -0
  15. package/dist/config/env.js +392 -0
  16. package/dist/config/features.js +16 -0
  17. package/dist/config/index.js +3 -0
  18. package/dist/config/listener-security.js +38 -0
  19. package/dist/config/version.js +31 -0
  20. package/dist/db/client.js +44 -0
  21. package/dist/db/generated/prisma/browser.js +18 -0
  22. package/dist/db/generated/prisma/client.js +35 -0
  23. package/dist/db/generated/prisma/commonInputTypes.js +11 -0
  24. package/dist/db/generated/prisma/enums.js +42 -0
  25. package/dist/db/generated/prisma/internal/class.js +50 -0
  26. package/dist/db/generated/prisma/internal/prismaNamespace.js +1598 -0
  27. package/dist/db/generated/prisma/internal/prismaNamespaceBrowser.js +1569 -0
  28. package/dist/db/generated/prisma/models/A2ATask.js +2 -0
  29. package/dist/db/generated/prisma/models/AdmissionFence.js +2 -0
  30. package/dist/db/generated/prisma/models/Agent.js +2 -0
  31. package/dist/db/generated/prisma/models/AiConversation.js +2 -0
  32. package/dist/db/generated/prisma/models/AiDashboard.js +2 -0
  33. package/dist/db/generated/prisma/models/AiMemory.js +2 -0
  34. package/dist/db/generated/prisma/models/AiMessage.js +2 -0
  35. package/dist/db/generated/prisma/models/AiScheduledOp.js +2 -0
  36. package/dist/db/generated/prisma/models/AlertConditionState.js +2 -0
  37. package/dist/db/generated/prisma/models/AlertRule.js +2 -0
  38. package/dist/db/generated/prisma/models/AlertViolation.js +2 -0
  39. package/dist/db/generated/prisma/models/AnomalyEvent.js +2 -0
  40. package/dist/db/generated/prisma/models/ApplicationObservation.js +2 -0
  41. package/dist/db/generated/prisma/models/ArdentInstallation.js +2 -0
  42. package/dist/db/generated/prisma/models/ArdentProfile.js +2 -0
  43. package/dist/db/generated/prisma/models/ArdentScopeEnrollment.js +2 -0
  44. package/dist/db/generated/prisma/models/CommandResourceFence.js +2 -0
  45. package/dist/db/generated/prisma/models/CommandResourceLease.js +2 -0
  46. package/dist/db/generated/prisma/models/CommandResult.js +2 -0
  47. package/dist/db/generated/prisma/models/CronJob.js +2 -0
  48. package/dist/db/generated/prisma/models/CronJobExecution.js +2 -0
  49. package/dist/db/generated/prisma/models/DeployJob.js +2 -0
  50. package/dist/db/generated/prisma/models/DriftScan.js +2 -0
  51. package/dist/db/generated/prisma/models/EngineeringMetricSample.js +2 -0
  52. package/dist/db/generated/prisma/models/EngineeringRecoveryExercise.js +2 -0
  53. package/dist/db/generated/prisma/models/ExecutionRun.js +2 -0
  54. package/dist/db/generated/prisma/models/FilePatchTask.js +2 -0
  55. package/dist/db/generated/prisma/models/GpuSnapshot.js +2 -0
  56. package/dist/db/generated/prisma/models/HealthSnapshot.js +2 -0
  57. package/dist/db/generated/prisma/models/HermesCoreRollout.js +2 -0
  58. package/dist/db/generated/prisma/models/HermesCoreRolloutHost.js +2 -0
  59. package/dist/db/generated/prisma/models/HermesCredentialPool.js +2 -0
  60. package/dist/db/generated/prisma/models/HermesCredentialPoolAttachment.js +2 -0
  61. package/dist/db/generated/prisma/models/HermesCronJob.js +2 -0
  62. package/dist/db/generated/prisma/models/HermesHook.js +2 -0
  63. package/dist/db/generated/prisma/models/HermesInstallation.js +2 -0
  64. package/dist/db/generated/prisma/models/HermesMcpServer.js +2 -0
  65. package/dist/db/generated/prisma/models/HermesMcpServerAttachment.js +2 -0
  66. package/dist/db/generated/prisma/models/HermesMessagingBinding.js +2 -0
  67. package/dist/db/generated/prisma/models/HermesOperationJob.js +2 -0
  68. package/dist/db/generated/prisma/models/HermesPluginInstall.js +2 -0
  69. package/dist/db/generated/prisma/models/HermesProfile.js +2 -0
  70. package/dist/db/generated/prisma/models/HermesProviderConfig.js +2 -0
  71. package/dist/db/generated/prisma/models/HermesRegistryClient.js +2 -0
  72. package/dist/db/generated/prisma/models/HermesRegistryInventory.js +2 -0
  73. package/dist/db/generated/prisma/models/HermesRegistryReceipt.js +2 -0
  74. package/dist/db/generated/prisma/models/HermesRegistryRevision.js +2 -0
  75. package/dist/db/generated/prisma/models/HermesRegistryTarget.js +2 -0
  76. package/dist/db/generated/prisma/models/HermesRole.js +2 -0
  77. package/dist/db/generated/prisma/models/HermesRoleApplication.js +2 -0
  78. package/dist/db/generated/prisma/models/HermesSkillAssignment.js +2 -0
  79. package/dist/db/generated/prisma/models/HermesToolsetPolicy.js +2 -0
  80. package/dist/db/generated/prisma/models/IncidentLesson.js +2 -0
  81. package/dist/db/generated/prisma/models/LibraryCategory.js +2 -0
  82. package/dist/db/generated/prisma/models/LibraryFile.js +2 -0
  83. package/dist/db/generated/prisma/models/LogEntry.js +2 -0
  84. package/dist/db/generated/prisma/models/MagnusReleaseCanary.js +2 -0
  85. package/dist/db/generated/prisma/models/MaintenanceWindow.js +2 -0
  86. package/dist/db/generated/prisma/models/ManagedCronDefinition.js +2 -0
  87. package/dist/db/generated/prisma/models/ManagedCronOccurrence.js +2 -0
  88. package/dist/db/generated/prisma/models/Node.js +2 -0
  89. package/dist/db/generated/prisma/models/Notification.js +2 -0
  90. package/dist/db/generated/prisma/models/NotificationPreference.js +2 -0
  91. package/dist/db/generated/prisma/models/RemediationExecution.js +2 -0
  92. package/dist/db/generated/prisma/models/RemediationRule.js +2 -0
  93. package/dist/db/generated/prisma/models/RemoteCommand.js +2 -0
  94. package/dist/db/generated/prisma/models/ResourceDrainParticipant.js +2 -0
  95. package/dist/db/generated/prisma/models/ResourceEnrollment.js +2 -0
  96. package/dist/db/generated/prisma/models/ResourceParticipantWork.js +2 -0
  97. package/dist/db/generated/prisma/models/Role.js +2 -0
  98. package/dist/db/generated/prisma/models/RoleApplication.js +2 -0
  99. package/dist/db/generated/prisma/models/RolloutTarget.js +2 -0
  100. package/dist/db/generated/prisma/models/SecurityExportOutbox.js +2 -0
  101. package/dist/db/generated/prisma/models/SecurityFusionAction.js +2 -0
  102. package/dist/db/generated/prisma/models/SecurityFusionActionApproval.js +2 -0
  103. package/dist/db/generated/prisma/models/SecurityFusionCase.js +2 -0
  104. package/dist/db/generated/prisma/models/SecurityFusionCaseActivity.js +2 -0
  105. package/dist/db/generated/prisma/models/SecurityFusionCaseEntity.js +2 -0
  106. package/dist/db/generated/prisma/models/SecurityFusionCaseEvent.js +2 -0
  107. package/dist/db/generated/prisma/models/SecurityFusionCaseRelationship.js +2 -0
  108. package/dist/db/generated/prisma/models/SecurityFusionCollector.js +2 -0
  109. package/dist/db/generated/prisma/models/SecurityFusionCommandOutbox.js +2 -0
  110. package/dist/db/generated/prisma/models/SecurityFusionDeletionReceipt.js +2 -0
  111. package/dist/db/generated/prisma/models/SecurityFusionDelivery.js +2 -0
  112. package/dist/db/generated/prisma/models/SecurityFusionEntity.js +2 -0
  113. package/dist/db/generated/prisma/models/SecurityFusionEntityAlias.js +2 -0
  114. package/dist/db/generated/prisma/models/SecurityFusionEvent.js +2 -0
  115. package/dist/db/generated/prisma/models/SecurityFusionEventEntity.js +2 -0
  116. package/dist/db/generated/prisma/models/SecurityFusionEvidence.js +2 -0
  117. package/dist/db/generated/prisma/models/SecurityFusionInvestigation.js +2 -0
  118. package/dist/db/generated/prisma/models/SecurityFusionNonce.js +2 -0
  119. package/dist/db/generated/prisma/models/SecurityFusionReceiptChainHead.js +2 -0
  120. package/dist/db/generated/prisma/models/SecurityFusionRuleVersion.js +2 -0
  121. package/dist/db/generated/prisma/models/SecurityFusionSourceState.js +2 -0
  122. package/dist/db/generated/prisma/models/SecurityServiceState.js +2 -0
  123. package/dist/db/generated/prisma/models/SharedResourceFence.js +2 -0
  124. package/dist/db/generated/prisma/models/SharedResourceLease.js +2 -0
  125. package/dist/db/generated/prisma/models/SharedResourceLeaseResource.js +2 -0
  126. package/dist/db/generated/prisma/models/SkillInstallation.js +2 -0
  127. package/dist/db/generated/prisma/models/SkillRegistryEntry.js +2 -0
  128. package/dist/db/generated/prisma/models/SkillTag.js +2 -0
  129. package/dist/db/generated/prisma/models/SkillVersion.js +2 -0
  130. package/dist/db/generated/prisma/models/TeamApprovalDecision.js +2 -0
  131. package/dist/db/generated/prisma/models/User.js +2 -0
  132. package/dist/db/generated/prisma/models/WebhookDelivery.js +2 -0
  133. package/dist/db/generated/prisma/models/WebhookEndpoint.js +2 -0
  134. package/dist/db/generated/prisma/models.js +2 -0
  135. package/dist/db/index.js +3 -0
  136. package/dist/db/read-retry.js +35 -0
  137. package/dist/db/seed.js +348 -0
  138. package/dist/index.js +162 -0
  139. package/dist/middleware/auth.js +361 -0
  140. package/dist/middleware/body-limit.js +14 -0
  141. package/dist/middleware/correlation-id.js +13 -0
  142. package/dist/middleware/error-handler.js +28 -0
  143. package/dist/middleware/iam-token.js +21 -0
  144. package/dist/middleware/rate-limit.js +78 -0
  145. package/dist/middleware/request-logger.js +85 -0
  146. package/dist/middleware/security-headers.js +23 -0
  147. package/dist/middleware/tracing.js +120 -0
  148. package/dist/middleware/user-status.js +33 -0
  149. package/dist/openapi/spec.js +2656 -0
  150. package/dist/queue/redis.js +20 -0
  151. package/dist/queue/requeue.js +27 -0
  152. package/dist/queue/workers.js +342 -0
  153. package/dist/routes/ai-schedule.js +73 -0
  154. package/dist/routes/alerts.js +79 -0
  155. package/dist/routes/anomalies.js +101 -0
  156. package/dist/routes/ardent.js +82 -0
  157. package/dist/routes/assistant.js +417 -0
  158. package/dist/routes/audit.js +138 -0
  159. package/dist/routes/codex.js +65 -0
  160. package/dist/routes/commands.js +226 -0
  161. package/dist/routes/credentials.js +58 -0
  162. package/dist/routes/cron.js +292 -0
  163. package/dist/routes/dependencies.js +49 -0
  164. package/dist/routes/deploy.js +18 -0
  165. package/dist/routes/discovery.js +168 -0
  166. package/dist/routes/docs.js +24 -0
  167. package/dist/routes/drift.js +126 -0
  168. package/dist/routes/events-stream.js +87 -0
  169. package/dist/routes/files.js +214 -0
  170. package/dist/routes/fleet-checks.js +21 -0
  171. package/dist/routes/health.js +133 -0
  172. package/dist/routes/heartbeat.js +545 -0
  173. package/dist/routes/hermes-registry.js +278 -0
  174. package/dist/routes/hermes.js +61 -0
  175. package/dist/routes/library.js +402 -0
  176. package/dist/routes/logs.js +172 -0
  177. package/dist/routes/managed-cron.js +23 -0
  178. package/dist/routes/mcp.js +39 -0
  179. package/dist/routes/metrics.js +187 -0
  180. package/dist/routes/nodes.js +951 -0
  181. package/dist/routes/notifications.js +130 -0
  182. package/dist/routes/ops.js +258 -0
  183. package/dist/routes/orchestra.js +430 -0
  184. package/dist/routes/predictions.js +23 -0
  185. package/dist/routes/profiling.js +68 -0
  186. package/dist/routes/quick-command.js +72 -0
  187. package/dist/routes/remediation.js +111 -0
  188. package/dist/routes/resource-leases.js +297 -0
  189. package/dist/routes/roles.js +370 -0
  190. package/dist/routes/rollout.js +124 -0
  191. package/dist/routes/scan.js +116 -0
  192. package/dist/routes/security-backup.js +58 -0
  193. package/dist/routes/security-fusion.js +605 -0
  194. package/dist/routes/security-integration.js +71 -0
  195. package/dist/routes/self-update.js +129 -0
  196. package/dist/routes/shared-resource-leases.js +78 -0
  197. package/dist/routes/skills.js +485 -0
  198. package/dist/routes/stats.js +96 -0
  199. package/dist/routes/team-approvals.js +23 -0
  200. package/dist/routes/terminal-ticket.js +15 -0
  201. package/dist/routes/terminal.js +17 -0
  202. package/dist/routes/topology.js +37 -0
  203. package/dist/routes/users.js +219 -0
  204. package/dist/routes/webhooks.js +137 -0
  205. package/dist/schemas/command-reconciliation.js +14 -0
  206. package/dist/schemas/commands.js +51 -0
  207. package/dist/schemas/cron.js +33 -0
  208. package/dist/schemas/deploy.js +20 -0
  209. package/dist/schemas/files.js +14 -0
  210. package/dist/schemas/hermes.js +69 -0
  211. package/dist/schemas/index.js +11 -0
  212. package/dist/schemas/library.js +48 -0
  213. package/dist/schemas/logs.js +35 -0
  214. package/dist/schemas/managed-cron.js +127 -0
  215. package/dist/schemas/node-responses.js +87 -0
  216. package/dist/schemas/node-session-receipt.js +84 -0
  217. package/dist/schemas/nodes.js +36 -0
  218. package/dist/schemas/orchestra.js +118 -0
  219. package/dist/schemas/resource-participant-reconciliation.js +99 -0
  220. package/dist/schemas/roles.js +54 -0
  221. package/dist/schemas/shared-resource-lease.js +132 -0
  222. package/dist/schemas/skills.js +44 -0
  223. package/dist/schemas/users.js +28 -0
  224. package/dist/scripts/run-disposable-recovery-exercise.js +39 -0
  225. package/dist/sdk/index.js +2 -0
  226. package/dist/sdk/node-api-client.js +474 -0
  227. package/dist/security/approval-assertion.js +66 -0
  228. package/dist/security/command-completion-registry.js +35 -0
  229. package/dist/security/command-request.js +12 -0
  230. package/dist/security/command-result-signature.js +34 -0
  231. package/dist/security/managed-http.js +45 -0
  232. package/dist/security/native-completion-registry.js +44 -0
  233. package/dist/server.js +178 -0
  234. package/dist/services/admission-fence.js +71 -0
  235. package/dist/services/ai-assistant-service.js +2523 -0
  236. package/dist/services/ai-correlation-service.js +225 -0
  237. package/dist/services/ai-export-service.js +141 -0
  238. package/dist/services/ai-insights-service.js +219 -0
  239. package/dist/services/ai-schedule-service.js +145 -0
  240. package/dist/services/ai-scratchpad-service.js +222 -0
  241. package/dist/services/ai-tools.js +1343 -0
  242. package/dist/services/alert-service.js +313 -0
  243. package/dist/services/anomaly-detector.js +419 -0
  244. package/dist/services/api-local-work.js +79 -0
  245. package/dist/services/application-probes.js +309 -0
  246. package/dist/services/ardent-scope-enrollment.js +123 -0
  247. package/dist/services/ardent-service.js +86 -0
  248. package/dist/services/audit-service.js +308 -0
  249. package/dist/services/codex-service.js +209 -0
  250. package/dist/services/command-lifecycle.js +60 -0
  251. package/dist/services/command-resource-leases.js +305 -0
  252. package/dist/services/control-host-node.js +242 -0
  253. package/dist/services/credential-rotation-service.js +294 -0
  254. package/dist/services/dependency-service.js +145 -0
  255. package/dist/services/disposable-recovery-runner.js +595 -0
  256. package/dist/services/docker-group-health.js +121 -0
  257. package/dist/services/engineering-assurance.js +492 -0
  258. package/dist/services/engineering-evidence-ledger.js +94 -0
  259. package/dist/services/engineering-metric-evidence.js +26 -0
  260. package/dist/services/event-bus.js +227 -0
  261. package/dist/services/fleet-check-log.js +102 -0
  262. package/dist/services/forecast-service.js +154 -0
  263. package/dist/services/health-retention.js +175 -0
  264. package/dist/services/heartbeat-stream.js +63 -0
  265. package/dist/services/hermes-catalog-import.js +62 -0
  266. package/dist/services/hermes-cli-parser.js +671 -0
  267. package/dist/services/hermes-core-rollout.js +90 -0
  268. package/dist/services/hermes-dashboard-endpoint.js +13 -0
  269. package/dist/services/hermes-plugin-source.js +149 -0
  270. package/dist/services/hermes-registry-service.js +258 -0
  271. package/dist/services/hermes-service.js +566 -0
  272. package/dist/services/hivemem-client.js +85 -0
  273. package/dist/services/host-local-writer.js +82 -0
  274. package/dist/services/incident-evidence.js +110 -0
  275. package/dist/services/incident-lessons.js +186 -0
  276. package/dist/services/llm-providers/anthropic.js +143 -0
  277. package/dist/services/llm-providers/index.js +7 -0
  278. package/dist/services/llm-providers/llama-cpp.js +237 -0
  279. package/dist/services/llm-providers/ollama.js +292 -0
  280. package/dist/services/llm-providers/openai-compatible.js +200 -0
  281. package/dist/services/llm-providers/provider-error.js +36 -0
  282. package/dist/services/llm-providers/registry.js +45 -0
  283. package/dist/services/llm-providers/types.js +2 -0
  284. package/dist/services/log-emitter.js +19 -0
  285. package/dist/services/log-retention.js +66 -0
  286. package/dist/services/maintenance-service.js +29 -0
  287. package/dist/services/managed-cron.js +493 -0
  288. package/dist/services/managed-ssh-admission.js +68 -0
  289. package/dist/services/monitor-pulse.js +10 -0
  290. package/dist/services/node-issue-monitor.js +71 -0
  291. package/dist/services/node-service.js +35 -0
  292. package/dist/services/notification-retention.js +51 -0
  293. package/dist/services/notification-service.js +94 -0
  294. package/dist/services/operational-observations.js +112 -0
  295. package/dist/services/operations-config.js +67 -0
  296. package/dist/services/ops-service.js +491 -0
  297. package/dist/services/orchestra-extras-service.js +370 -0
  298. package/dist/services/orchestra-resources-service.js +530 -0
  299. package/dist/services/os-scheduler-writer.js +73 -0
  300. package/dist/services/password-service.js +22 -0
  301. package/dist/services/prediction-service.js +284 -0
  302. package/dist/services/recovery-exercises.js +682 -0
  303. package/dist/services/remediation-service.js +325 -0
  304. package/dist/services/resource-enrollment.js +433 -0
  305. package/dist/services/resource-node-lock.js +18 -0
  306. package/dist/services/resource-participant-work.js +302 -0
  307. package/dist/services/role-service.js +388 -0
  308. package/dist/services/rollout-service.js +440 -0
  309. package/dist/services/security-export.js +185 -0
  310. package/dist/services/security-fusion-actions.js +22 -0
  311. package/dist/services/security-fusion-approvals.js +83 -0
  312. package/dist/services/security-fusion-evidence-integrity.js +144 -0
  313. package/dist/services/security-fusion-ingest.js +101 -0
  314. package/dist/services/security-fusion-outbox.js +185 -0
  315. package/dist/services/security-fusion-receipt-chain.js +134 -0
  316. package/dist/services/security-fusion-service.js +751 -0
  317. package/dist/services/security-fusion-verification.js +50 -0
  318. package/dist/services/self-update-service.js +200 -0
  319. package/dist/services/shared-resource-leases.js +413 -0
  320. package/dist/services/skill-publication-bundle.js +90 -0
  321. package/dist/services/skill-publication-settlement.js +36 -0
  322. package/dist/services/skill-publication-state.js +40 -0
  323. package/dist/services/skill-registry-service.js +327 -0
  324. package/dist/services/skill-service.js +148 -0
  325. package/dist/services/ssh-exec-service.js +139 -0
  326. package/dist/services/ssh-host-verification.js +27 -0
  327. package/dist/services/tailscale-node-key-service.js +75 -0
  328. package/dist/services/team-approvals.js +118 -0
  329. package/dist/services/topology-service.js +138 -0
  330. package/dist/services/transfer-authority-snapshot.js +151 -0
  331. package/dist/services/webhook-credential-migration.js +97 -0
  332. package/dist/services/webhook-security.js +242 -0
  333. package/dist/services/webhook-service.js +494 -0
  334. package/dist/types/auth.js +3 -0
  335. package/dist/types/index.js +3 -0
  336. package/dist/types/library.js +3 -0
  337. package/dist/types/notifications.js +3 -0
  338. package/dist/types/roles.js +3 -0
  339. package/dist/types/shared-contracts.js +3 -0
  340. package/dist/utils/env.js +141 -0
  341. package/dist/utils/heartbeat-peer.js +19 -0
  342. package/dist/utils/idempotency.js +45 -0
  343. package/dist/utils/ip.js +25 -0
  344. package/dist/utils/json-fields.js +94 -0
  345. package/dist/utils/local-tls.js +39 -0
  346. package/dist/utils/magnus-home.js +15 -0
  347. package/dist/utils/node-url.js +59 -0
  348. package/dist/utils/redact.js +26 -0
  349. package/dist/utils/safe-equal.js +13 -0
  350. package/dist/utils/sentinel-nodes.js +16 -0
  351. package/dist/utils/validate.js +41 -0
  352. package/package.json +119 -4
  353. package/prisma/migrations/20261031000000_baseline/migration.sql +2935 -0
  354. package/prisma/migrations/migration_lock.toml +3 -0
  355. package/prisma/schema.prisma +2185 -0
  356. package/prisma.config.ts +14 -0
@@ -0,0 +1,370 @@
1
+ import { readFile, readdir, stat } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ import { getDb } from '../db/index.js';
4
+ import { getSkillsDir as getPackageSkillsDir } from '@hivemagnus/magnus-skills';
5
+ import { HttpError } from '../middleware/error-handler.js';
6
+ function capabilityState(value) {
7
+ if (value === true)
8
+ return 'supported';
9
+ if (value === false)
10
+ return 'missing';
11
+ return 'unknown';
12
+ }
13
+ function parseJsonObject(value) {
14
+ if (!value)
15
+ return {};
16
+ try {
17
+ const parsed = JSON.parse(value);
18
+ return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
19
+ }
20
+ catch {
21
+ return {};
22
+ }
23
+ }
24
+ function countStates(capabilities) {
25
+ return capabilities.reduce((acc, item) => {
26
+ acc[item.state] += 1;
27
+ return acc;
28
+ }, { supported: 0, missing: 0, unknown: 0 });
29
+ }
30
+ export async function getOrchestraOverview() {
31
+ const db = getDb();
32
+ const [installations, profiles, jobs, recentJobs, skillAssignments, toolsetPolicies, roles, providerConfigs, credentialPools, mcpServers, messagingBindings, cronJobs, plugins, hooks,] = await Promise.all([
33
+ db.hermesInstallation.findMany({ select: { status: true } }),
34
+ db.hermesProfile.count(),
35
+ db.hermesOperationJob.findMany({ select: { status: true } }),
36
+ db.hermesOperationJob.findMany({
37
+ orderBy: { startedAt: 'desc' },
38
+ take: 10,
39
+ select: { id: true, type: true, status: true, startedAt: true, completedAt: true },
40
+ }),
41
+ db.hermesSkillAssignment.count(),
42
+ db.hermesToolsetPolicy.count(),
43
+ db.hermesRole.count(),
44
+ db.hermesProviderConfig.count(),
45
+ db.hermesCredentialPool.count(),
46
+ db.hermesMcpServer.count(),
47
+ db.hermesMessagingBinding.count(),
48
+ db.hermesCronJob.count(),
49
+ db.hermesPluginInstall.count(),
50
+ db.hermesHook.count(),
51
+ ]);
52
+ const installCount = (s) => installations.filter((i) => i.status === s).length;
53
+ const jobCount = (s) => jobs.filter((j) => j.status === s).length;
54
+ return {
55
+ installations: {
56
+ total: installations.length,
57
+ running: installCount('running'),
58
+ degraded: installCount('degraded'),
59
+ error: installCount('error'),
60
+ },
61
+ profiles: { total: profiles },
62
+ jobs: {
63
+ queued: jobCount('queued'),
64
+ running: jobCount('running'),
65
+ completed: jobCount('completed'),
66
+ failed: jobCount('failed'),
67
+ },
68
+ resources: {
69
+ skillAssignments,
70
+ toolsetPolicies,
71
+ roles,
72
+ providerConfigs,
73
+ credentialPools,
74
+ mcpServers,
75
+ messagingBindings,
76
+ cronJobs,
77
+ plugins,
78
+ hooks,
79
+ },
80
+ recentJobs: recentJobs.map((j) => ({
81
+ id: j.id,
82
+ type: j.type,
83
+ status: j.status,
84
+ startedAt: j.startedAt.toISOString(),
85
+ completedAt: j.completedAt ? j.completedAt.toISOString() : null,
86
+ })),
87
+ generatedAt: new Date().toISOString(),
88
+ };
89
+ }
90
+ export async function getOrchestraCapabilityInventory() {
91
+ const db = getDb();
92
+ const [installations, profiles, skillAssignments, toolsetPolicies, mcpServers, messagingBindings, cronJobs, plugins, hooks,] = await Promise.all([
93
+ db.hermesInstallation.findMany({ include: { profiles: true }, orderBy: { hostname: 'asc' } }),
94
+ db.hermesProfile.findMany({ include: { installation: true }, orderBy: [{ installationId: 'asc' }, { name: 'asc' }] }),
95
+ db.hermesSkillAssignment.count(),
96
+ db.hermesToolsetPolicy.count(),
97
+ db.hermesMcpServer.count(),
98
+ db.hermesMessagingBinding.count(),
99
+ db.hermesCronJob.count(),
100
+ db.hermesPluginInstall.count(),
101
+ db.hermesHook.count(),
102
+ ]);
103
+ const capabilities = [];
104
+ for (const installation of installations) {
105
+ const label = installation.displayName ?? installation.hostname;
106
+ const rawStatus = parseJsonObject(installation.rawStatus);
107
+ const metadata = parseJsonObject(installation.metadata);
108
+ const routerConfigured = rawStatus['magnusRouterConfigured'] ?? metadata['magnusRouterConfigured'];
109
+ capabilities.push({
110
+ key: `installation:${installation.id}:runtime`,
111
+ label: `${label} runtime`,
112
+ state: ['running', 'detected'].includes(installation.status) ? 'supported' : installation.status === 'not_installed' ? 'missing' : 'unknown',
113
+ detail: `Hermes ${installation.version ?? 'version unknown'} · ${installation.status}`,
114
+ installationId: installation.id,
115
+ }, {
116
+ key: `installation:${installation.id}:dashboard`,
117
+ label: `${label} dashboard`,
118
+ state: installation.dashboardStatus === 'running' ? 'supported' : ['stopped', 'failed', 'error'].includes(installation.dashboardStatus) ? 'missing' : 'unknown',
119
+ detail: `${installation.dashboardHost}:${installation.dashboardPort} · ${installation.dashboardStatus}`,
120
+ installationId: installation.id,
121
+ }, {
122
+ key: `installation:${installation.id}:api-server`,
123
+ label: `${label} API server`,
124
+ state: installation.apiServerEnabled ? 'supported' : 'missing',
125
+ detail: installation.apiServerEnabled ? `${installation.apiServerHost}:${installation.apiServerPort ?? '?'}` : 'disabled',
126
+ installationId: installation.id,
127
+ }, {
128
+ key: `installation:${installation.id}:router`,
129
+ label: `${label} Magnus Router`,
130
+ state: capabilityState(routerConfigured),
131
+ detail: 'Model router configuration from last sync metadata when available.',
132
+ installationId: installation.id,
133
+ });
134
+ }
135
+ for (const profile of profiles) {
136
+ const profileLabel = `${profile.installation.displayName ?? profile.installation.hostname} / ${profile.name}`;
137
+ const cap = parseJsonObject(profile.capabilities);
138
+ capabilities.push({
139
+ key: `profile:${profile.id}:gateway`,
140
+ label: `${profileLabel} gateway`,
141
+ state: profile.gatewayStatus === 'running' ? 'supported' : ['stopped', 'failed', 'error'].includes(profile.gatewayStatus) ? 'missing' : 'unknown',
142
+ detail: `gateway ${profile.gatewayStatus}`,
143
+ installationId: profile.installationId,
144
+ profileId: profile.id,
145
+ }, {
146
+ key: `profile:${profile.id}:checkpoints`,
147
+ label: `${profileLabel} checkpoints`,
148
+ state: capabilityState(cap['checkpoints'] ?? cap['checkpointing'] ?? cap['checkpointSupport']),
149
+ detail: 'Read from synced profile capabilities.',
150
+ installationId: profile.installationId,
151
+ profileId: profile.id,
152
+ }, {
153
+ key: `profile:${profile.id}:kanban`,
154
+ label: `${profileLabel} Kanban`,
155
+ state: capabilityState(cap['kanban'] ?? cap['multiAgentKanban']),
156
+ detail: 'Read from synced profile capabilities.',
157
+ installationId: profile.installationId,
158
+ profileId: profile.id,
159
+ }, {
160
+ key: `profile:${profile.id}:goal`,
161
+ label: `${profileLabel} /goal`,
162
+ state: capabilityState(cap['goal'] ?? cap['goals'] ?? cap['slashGoal']),
163
+ detail: 'Read from synced profile capabilities.',
164
+ installationId: profile.installationId,
165
+ profileId: profile.id,
166
+ });
167
+ }
168
+ capabilities.push({ key: 'fleet:skills', label: 'Fleet skill assignments', state: skillAssignments > 0 ? 'supported' : 'missing', detail: `${skillAssignments} assignment${skillAssignments === 1 ? '' : 's'}` }, { key: 'fleet:toolsets', label: 'Fleet toolset policies', state: toolsetPolicies > 0 ? 'supported' : 'missing', detail: `${toolsetPolicies} polic${toolsetPolicies === 1 ? 'y' : 'ies'}` }, { key: 'fleet:mcp', label: 'Fleet MCP servers', state: mcpServers > 0 ? 'supported' : 'missing', detail: `${mcpServers} server${mcpServers === 1 ? '' : 's'}` }, { key: 'fleet:messaging', label: 'Fleet messaging bindings', state: messagingBindings > 0 ? 'supported' : 'missing', detail: `${messagingBindings} binding${messagingBindings === 1 ? '' : 's'}` }, { key: 'fleet:cron', label: 'Fleet cron jobs', state: cronJobs > 0 ? 'supported' : 'missing', detail: `${cronJobs} scheduled task${cronJobs === 1 ? '' : 's'}` }, { key: 'fleet:plugins-hooks', label: 'Fleet plugins and hooks', state: plugins + hooks > 0 ? 'supported' : 'missing', detail: `${plugins} plugin${plugins === 1 ? '' : 's'} · ${hooks} hook${hooks === 1 ? '' : 's'}` });
169
+ return {
170
+ summary: countStates(capabilities),
171
+ capabilities,
172
+ generatedAt: new Date().toISOString(),
173
+ };
174
+ }
175
+ function getSkillsRoot() {
176
+ return process.env['SKILLS_DIR'] ?? getPackageSkillsDir();
177
+ }
178
+ export async function getSkillCatalog() {
179
+ const root = getSkillsRoot();
180
+ const indexFile = join(root, 'index.json');
181
+ try {
182
+ const raw = await readFile(indexFile, 'utf-8');
183
+ const parsed = JSON.parse(raw);
184
+ if (parsed.skills && Array.isArray(parsed.skills)) {
185
+ return {
186
+ schema: parsed.schema ?? 'https://agentskills.io/schema/v1',
187
+ generatedAt: parsed.generatedAt ?? new Date().toISOString(),
188
+ count: parsed.count ?? parsed.skills.length,
189
+ source: 'index',
190
+ skills: parsed.skills,
191
+ };
192
+ }
193
+ }
194
+ catch {
195
+ // fall through to walk
196
+ }
197
+ // Walk fallback — read every manifest.json under root/<slug>/manifest.json
198
+ const entries = await readdir(root, { withFileTypes: true }).catch(() => []);
199
+ const skills = [];
200
+ for (const entry of entries) {
201
+ if (!entry.isDirectory())
202
+ continue;
203
+ const manifestPath = join(root, entry.name, 'manifest.json');
204
+ try {
205
+ const s = await stat(manifestPath);
206
+ if (!s.isFile())
207
+ continue;
208
+ const raw = await readFile(manifestPath, 'utf-8');
209
+ const m = JSON.parse(raw);
210
+ skills.push({ ...m, path: entry.name });
211
+ }
212
+ catch {
213
+ continue;
214
+ }
215
+ }
216
+ return {
217
+ schema: 'https://agentskills.io/schema/v1',
218
+ generatedAt: new Date().toISOString(),
219
+ count: skills.length,
220
+ source: 'walk',
221
+ skills,
222
+ };
223
+ }
224
+ function skillRecord(entry) {
225
+ return entry;
226
+ }
227
+ function stringArray(value) {
228
+ return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
229
+ }
230
+ async function findCatalogSkill(slug) {
231
+ const catalog = await getSkillCatalog();
232
+ return catalog.skills.find((skill) => skill.name === slug || skill.path === slug) ?? null;
233
+ }
234
+ export async function auditSkillCatalogEntry(slug) {
235
+ const db = getDb();
236
+ const catalog = await getSkillCatalog();
237
+ const entry = catalog.skills.find((skill) => skill.name === slug || skill.path === slug);
238
+ if (!entry)
239
+ throw new HttpError(404, 'NOT_FOUND', `Skill ${slug} was not found in the catalog`);
240
+ const assignments = await db.hermesSkillAssignment.findMany({ where: { skillSlug: entry.name } });
241
+ const known = new Set(catalog.skills.map((skill) => skill.name));
242
+ const dependencies = entry.dependencies ?? [];
243
+ const metadata = skillRecord(entry)['metadata'];
244
+ const requiredEnv = stringArray(skillRecord(entry)['requiredEnv'] ?? metadata?.['requiredEnv'] ?? metadata?.['env']);
245
+ const requiredToolsets = stringArray(skillRecord(entry)['requiredToolsets'] ?? metadata?.['requiredToolsets'] ?? metadata?.['toolsets']);
246
+ const missingDependencies = dependencies.filter((dep) => !known.has(dep));
247
+ const warnings = [
248
+ ...(missingDependencies.length ? [`Missing catalog dependencies: ${missingDependencies.join(', ')}`] : []),
249
+ ...(requiredEnv.length ? [`Requires env: ${requiredEnv.join(', ')}`] : []),
250
+ ...(assignments.some((assignment) => !assignment.enabled) ? ['One or more assignments are disabled or quarantined'] : []),
251
+ ];
252
+ return {
253
+ slug: entry.name,
254
+ version: entry.version ?? null,
255
+ source: catalog.source,
256
+ installedAssignments: assignments.length,
257
+ dependencies,
258
+ missingDependencies,
259
+ requiredEnv,
260
+ requiredToolsets,
261
+ warnings,
262
+ updateAvailable: assignments.some((assignment) => Boolean(assignment.pinnedVersion) && assignment.pinnedVersion !== entry.version),
263
+ lastUsedAt: null,
264
+ };
265
+ }
266
+ export async function installCatalogSkill(input) {
267
+ const db = getDb();
268
+ const entry = await findCatalogSkill(input.slug);
269
+ if (!entry)
270
+ throw new HttpError(404, 'NOT_FOUND', `Skill ${input.slug} was not found in the catalog`);
271
+ const installation = await db.hermesInstallation.findUnique({ where: { id: input.installationId } });
272
+ if (!installation)
273
+ throw new HttpError(404, 'NOT_FOUND', `Hermes installation ${input.installationId} not found`);
274
+ const profileId = input.profileId ?? '';
275
+ const existing = await db.hermesSkillAssignment.findFirst({ where: { installationId: input.installationId, profileId, skillSlug: entry.name } });
276
+ const metadata = JSON.stringify({ installedFrom: 'skill-catalog', catalogVersion: entry.version, installedAt: new Date().toISOString() });
277
+ if (existing) {
278
+ return db.hermesSkillAssignment.update({
279
+ where: { id: existing.id },
280
+ data: { enabled: true, pinnedVersion: input.pinnedVersion ?? entry.version ?? existing.pinnedVersion, source: input.source ?? 'agentskills.io', metadata },
281
+ });
282
+ }
283
+ return db.hermesSkillAssignment.create({
284
+ data: {
285
+ installationId: input.installationId,
286
+ profileId,
287
+ skillSlug: entry.name,
288
+ pinnedVersion: input.pinnedVersion ?? entry.version ?? null,
289
+ source: input.source ?? 'agentskills.io',
290
+ enabled: true,
291
+ metadata,
292
+ createdBy: input.actorId,
293
+ },
294
+ });
295
+ }
296
+ export async function previewSkillBundle(input) {
297
+ const catalog = await getSkillCatalog();
298
+ const byName = new Map(catalog.skills.map((skill) => [skill.name, skill]));
299
+ const selected = input.slugs.map((slug) => byName.get(slug)).filter((skill) => Boolean(skill));
300
+ const missing = input.slugs.filter((slug) => !byName.has(slug));
301
+ const dependencySet = new Set(selected.flatMap((skill) => skill.dependencies ?? []));
302
+ const missingDependencies = [...dependencySet].filter((dep) => !byName.has(dep));
303
+ return {
304
+ selected,
305
+ missing,
306
+ missingDependencies,
307
+ assignments: selected.map((skill) => ({
308
+ installationId: input.installationId ?? '',
309
+ profileId: input.profileId ?? null,
310
+ skillSlug: skill.name,
311
+ pinnedVersion: skill.version ?? null,
312
+ source: 'agentskills.io',
313
+ enabled: true,
314
+ })),
315
+ };
316
+ }
317
+ export async function applySkillBundle(input) {
318
+ const preview = await previewSkillBundle(input);
319
+ if (preview.missing.length > 0)
320
+ throw new HttpError(400, 'VALIDATION_ERROR', `Missing skills: ${preview.missing.join(', ')}`);
321
+ const rows = [];
322
+ for (const assignment of preview.assignments) {
323
+ rows.push(await installCatalogSkill({
324
+ slug: assignment.skillSlug,
325
+ installationId: input.installationId,
326
+ profileId: input.profileId ?? null,
327
+ pinnedVersion: assignment.pinnedVersion,
328
+ source: assignment.source,
329
+ actorId: input.actorId,
330
+ }));
331
+ }
332
+ return { count: rows.length, assignments: rows };
333
+ }
334
+ export async function quarantineCatalogSkill(slug, actorId) {
335
+ const db = getDb();
336
+ const rows = await db.hermesSkillAssignment.findMany({ where: { skillSlug: slug } });
337
+ for (const row of rows) {
338
+ let metadata = {};
339
+ try {
340
+ metadata = JSON.parse(row.metadata || '{}');
341
+ }
342
+ catch {
343
+ metadata = {};
344
+ }
345
+ await db.hermesSkillAssignment.update({
346
+ where: { id: row.id },
347
+ data: { enabled: false, metadata: JSON.stringify({ ...metadata, quarantinedAt: new Date().toISOString(), quarantinedBy: actorId }) },
348
+ });
349
+ }
350
+ return { updated: rows.length };
351
+ }
352
+ export async function cancelHermesJob(id, actorId) {
353
+ const db = getDb();
354
+ const job = await db.hermesOperationJob.findUnique({ where: { id } });
355
+ if (!job)
356
+ throw new HttpError(404, 'NOT_FOUND', 'Hermes operation job not found');
357
+ if (job.status === 'completed' || job.status === 'failed' || job.status === 'cancelled') {
358
+ return { id: job.id, status: job.status };
359
+ }
360
+ const updated = await db.hermesOperationJob.update({
361
+ where: { id },
362
+ data: {
363
+ status: 'cancelled',
364
+ completedAt: new Date(),
365
+ error: `Cancelled by ${actorId}`,
366
+ },
367
+ });
368
+ return { id: updated.id, status: updated.status };
369
+ }
370
+ //# sourceMappingURL=orchestra-extras-service.js.map