@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,45 @@
1
+ /** Versioned native HTTP identity. Hashes bind request bytes; bodies stay off receipts. */
2
+ import { createHash } from 'node:crypto';
3
+ import { z } from 'zod';
4
+ import { commandFenceSchema } from '../schemas/node-responses.js';
5
+ export const managedClaimSchema = z.object({
6
+ leaseId: z.string().min(1).max(128), nodeId: z.string().min(1).max(128),
7
+ nodeFqdn: z.string().min(1).max(253),
8
+ }).strict();
9
+ export const managedHttpRequestSchema = z.object({
10
+ claim: managedClaimSchema,
11
+ commandId: z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/),
12
+ method: z.enum(['POST', 'PUT', 'PATCH', 'DELETE']),
13
+ path: z.string().min(1).max(300),
14
+ body: z.string().max(4 * 1024 * 1024),
15
+ timeoutSeconds: z.number().int().min(1).max(3600),
16
+ coordination: commandFenceSchema,
17
+ recoveryOnly: z.literal(true).optional(),
18
+ }).strict().superRefine((value, context) => {
19
+ if (value.recoveryOnly && (value.method !== 'POST' || value.path !== '/skills/install'))
20
+ context.addIssue({ code: z.ZodIssueCode.custom, path: ['recoveryOnly'],
21
+ message: 'Recovery-only execution is limited to atomic skill publication' });
22
+ });
23
+ export const MANAGED_HTTP_COMMAND = '@magnus/native-http/v1';
24
+ export const MANAGED_CLAIM_HEADER = 'x-magnus-resource-claim';
25
+ export function sha256(value) { return createHash('sha256').update(value).digest('hex'); }
26
+ export function httpIdentity(commandId, method, path, body, timeoutSeconds) {
27
+ if (!['POST', 'PUT', 'PATCH', 'DELETE'].includes(method) || !/^\/[a-zA-Z0-9/_%.:-]+$/.test(path)
28
+ || path.includes('..') || path.includes('//'))
29
+ throw new Error('Canonical native mutation path required');
30
+ return { commandId, command: MANAGED_HTTP_COMMAND, args: [method, path, sha256(body)], timeoutSeconds };
31
+ }
32
+ export function httpReceiptBody(method, path, status, body) {
33
+ return JSON.stringify({ version: 1, method, path, status, responseSha256: sha256(body) });
34
+ }
35
+ export const resourceClaimSchema = managedClaimSchema.extend({
36
+ commandId: z.string().min(1).max(128), requestSha256: z.string().regex(/^[a-f0-9]{64}$/),
37
+ coordination: commandFenceSchema,
38
+ }).strict();
39
+ export const legacyAdmissionRequestSchema = z.object({
40
+ nodeFqdn: z.string().min(1).max(253), nonce: z.string().guid(),
41
+ }).strict();
42
+ export const legacyAdmissionResponseSchema = legacyAdmissionRequestSchema.extend({
43
+ nodeId: z.string().min(1).max(128), enrolled: z.boolean(), gateEnabled: z.boolean(), allowedLegacy: z.boolean(),
44
+ }).strict();
45
+ //# sourceMappingURL=managed-http.js.map
@@ -0,0 +1,44 @@
1
+ import { createHash } from 'node:crypto';
2
+ export const NATIVE_COMPLETION_REGISTRY = {
3
+ version: 1,
4
+ descriptors: [
5
+ { id: 'file-write', method: 'POST', pathMatcher: { kind: 'exact', path: '/files/write' },
6
+ completionMode: 'buffered-synchronous-http', timeoutCeilingSeconds: 3600, resourceClassifier: 'node-filesystem' },
7
+ { id: 'skill-install', method: 'POST', pathMatcher: { kind: 'exact', path: '/skills/install' },
8
+ completionMode: 'buffered-synchronous-http', timeoutCeilingSeconds: 3600, resourceClassifier: 'node-skill-catalog' },
9
+ { id: 'skill-delete', method: 'DELETE',
10
+ pathMatcher: { kind: 'single-segment', prefix: '/skills/', segmentPattern: '^[a-zA-Z0-9._-]+$' },
11
+ completionMode: 'buffered-synchronous-http', timeoutCeilingSeconds: 3600, resourceClassifier: 'node-skill-catalog' },
12
+ { id: 'managed-cron-stage', method: 'POST', pathMatcher: { kind: 'exact', path: '/cron/managed-sync' },
13
+ completionMode: 'buffered-synchronous-http', timeoutCeilingSeconds: 3600, resourceClassifier: 'node-scheduler' },
14
+ { id: 'managed-cron-activate', method: 'POST', pathMatcher: { kind: 'exact', path: '/cron/managed-activate' },
15
+ completionMode: 'buffered-synchronous-http', timeoutCeilingSeconds: 3600, resourceClassifier: 'node-scheduler' },
16
+ { id: 'managed-cron-revoke', method: 'POST', pathMatcher: { kind: 'exact', path: '/cron/managed-revoke' },
17
+ completionMode: 'buffered-synchronous-http', timeoutCeilingSeconds: 3600, resourceClassifier: 'node-scheduler' },
18
+ { id: 'cron-delete', method: 'DELETE',
19
+ pathMatcher: { kind: 'single-segment', prefix: '/cron/', segmentPattern: '^[a-zA-Z0-9._-]+$' },
20
+ completionMode: 'buffered-synchronous-http', timeoutCeilingSeconds: 3600, resourceClassifier: 'node-scheduler' },
21
+ { id: 'ardent-action', method: 'POST', pathMatcher: { kind: 'exact', path: '/ardent/action' },
22
+ completionMode: 'buffered-synchronous-http', timeoutCeilingSeconds: 900, resourceClassifier: 'node-ardent' },
23
+ ],
24
+ };
25
+ export const NATIVE_COMPLETION_REGISTRY_SHA256 = createHash('sha256')
26
+ .update(JSON.stringify(NATIVE_COMPLETION_REGISTRY)).digest('hex');
27
+ function matchesPath(descriptor, path) {
28
+ const matcher = descriptor.pathMatcher;
29
+ if (matcher.kind === 'exact')
30
+ return path === matcher.path;
31
+ if (!path.startsWith(matcher.prefix))
32
+ return false;
33
+ const segment = path.slice(matcher.prefix.length);
34
+ return segment.length > 0 && !segment.includes('/') && new RegExp(matcher.segmentPattern).test(segment);
35
+ }
36
+ export function nativeCompletionDescriptor(method, path) {
37
+ return NATIVE_COMPLETION_REGISTRY.descriptors.find(descriptor => descriptor.method === method && matchesPath(descriptor, path));
38
+ }
39
+ export function nativeCompletionResourceKey(descriptor, nodeId) {
40
+ if (!nodeId || !['node-filesystem', 'node-skill-catalog', 'node-scheduler', 'node-ardent'].includes(descriptor.resourceClassifier))
41
+ throw new Error('Native completion resource cannot be classified');
42
+ return descriptor.resourceClassifier === 'node-ardent' ? `node:${nodeId}:ardent` : `node:${nodeId}`;
43
+ }
44
+ //# sourceMappingURL=native-completion-registry.js.map
package/dist/server.js ADDED
@@ -0,0 +1,178 @@
1
+ import { resourceLeasesRouter } from './routes/resource-leases.js';
2
+ import { sharedResourceLeasesRouter } from './routes/shared-resource-leases.js';
3
+ import { securityBackupRouter } from './routes/security-backup.js';
4
+ import { securityIntegrationRouter } from './routes/security-integration.js';
5
+ import { securityConsoleUrl, securityFusionMode } from './services/security-export.js';
6
+ import { Hono } from 'hono';
7
+ import { cors } from 'hono/cors';
8
+ import { logger } from 'hono/logger';
9
+ import { errorHandler } from './middleware/error-handler.js';
10
+ import { requestLogger } from './middleware/request-logger.js';
11
+ import { securityHeaders } from './middleware/security-headers.js';
12
+ import { correlationId } from './middleware/correlation-id.js';
13
+ import { tracing } from './middleware/tracing.js';
14
+ import { rateLimitMiddleware } from './middleware/rate-limit.js';
15
+ import { bodyLimitMiddleware } from './middleware/body-limit.js';
16
+ import { nodesRouter } from './routes/nodes.js';
17
+ import { commandsRouter } from './routes/commands.js';
18
+ import { cronRouter } from './routes/cron.js';
19
+ import { filesRouter } from './routes/files.js';
20
+ import { skillsRouter } from './routes/skills.js';
21
+ import { logsRouter } from './routes/logs.js';
22
+ import { healthRouter } from './routes/health.js';
23
+ import { auditRouter } from './routes/audit.js';
24
+ import { heartbeatRouter } from './routes/heartbeat.js';
25
+ import { deployRouter } from './routes/deploy.js';
26
+ import { discoveryRouter } from './routes/discovery.js';
27
+ import { quickCommandRouter } from './routes/quick-command.js';
28
+ import { statsRouter } from './routes/stats.js';
29
+ import { libraryRouter } from './routes/library.js';
30
+ import { rolesRouter } from './routes/roles.js';
31
+ import { notificationsRouter } from './routes/notifications.js';
32
+ import { selfUpdateRouter } from './routes/self-update.js';
33
+ import { scanRouter } from './routes/scan.js';
34
+ import { terminalTicketRouter } from './routes/terminal-ticket.js';
35
+ import { usersRouter, authRouter } from './routes/users.js';
36
+ import { docsRouter } from './routes/docs.js';
37
+ import { webhooksRouter } from './routes/webhooks.js';
38
+ import { alertsRouter } from './routes/alerts.js';
39
+ import { driftRouter } from './routes/drift.js';
40
+ import { rolloutRouter } from './routes/rollout.js';
41
+ import { anomaliesRouter } from './routes/anomalies.js';
42
+ import { assistantRouter } from './routes/assistant.js';
43
+ import { eventsStreamRouter } from './routes/events-stream.js';
44
+ import { teamApprovalRouter } from './routes/team-approvals.js';
45
+ import { remediationRouter } from './routes/remediation.js';
46
+ import { metricsRouter } from './routes/metrics.js';
47
+ import { credentialsRouter } from './routes/credentials.js';
48
+ import { topologyRouter } from './routes/topology.js';
49
+ import { dependenciesRouter } from './routes/dependencies.js';
50
+ import { aiScheduleRouter } from './routes/ai-schedule.js';
51
+ import { profilingRouter } from './routes/profiling.js';
52
+ import { predictionsRouter } from './routes/predictions.js';
53
+ import { hermesRouter } from './routes/hermes.js';
54
+ import { hermesRegistryRouter } from './routes/hermes-registry.js';
55
+ import { orchestraRouter } from './routes/orchestra.js';
56
+ import { codexRouter } from './routes/codex.js';
57
+ import { ardentRouter } from './routes/ardent.js';
58
+ import { fleetChecksRouter } from './routes/fleet-checks.js';
59
+ import { opsRouter } from './routes/ops.js';
60
+ import { mcpRouter } from './routes/mcp.js';
61
+ import { securityFusionRouter } from './routes/security-fusion.js';
62
+ import { resolveCorsConfiguration } from './config/cors.js';
63
+ export const app = new Hono();
64
+ // ── Global middleware ──
65
+ app.use('*', logger());
66
+ app.use('*', correlationId);
67
+ app.use('*', tracing);
68
+ app.use('*', securityHeaders);
69
+ // Parse CORS origins from env. Production defaults to dashboard origins instead
70
+ // of wildcard unless CORS_ORIGIN='*' is explicit.
71
+ const corsConfiguration = resolveCorsConfiguration(process.env);
72
+ app.use('*', cors({
73
+ origin: corsConfiguration.origin,
74
+ allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
75
+ allowHeaders: ['Content-Type', 'Authorization', 'x-idempotency-key', 'x-node-token', 'x-api-secret'],
76
+ exposeHeaders: ['x-request-id'],
77
+ credentials: corsConfiguration.credentials,
78
+ }));
79
+ app.onError(errorHandler);
80
+ // ── Request logging (after CORS, before routes) ──
81
+ app.use('/api/v1/*', requestLogger);
82
+ // This public route must be bounded before any generic middleware can buffer it.
83
+ app.use('/api/v1/security-fusion/ingest/events', bodyLimitMiddleware(Math.min(Math.max(Number(process.env['SECURITY_FUSION_INGEST_MAX_BYTES']) || 262_144, 1), 262_144)));
84
+ app.use('/api/v1/security-fusion/ingest/source-status', bodyLimitMiddleware(32_768));
85
+ app.route('/api/v1/security-integration/backups', securityBackupRouter);
86
+ app.use('/api/v1/*', async (c, next) => {
87
+ const limit = c.req.path === '/api/v1/hermes-registry/capture' || c.req.path === '/api/v1/hermes-registry/revisions'
88
+ ? 4_500_000 : Number(process.env['API_BODY_LIMIT_BYTES'] ?? 1_048_576);
89
+ await bodyLimitMiddleware(limit)(c, next);
90
+ });
91
+ // ── API routes (v1) ──
92
+ const v1 = new Hono();
93
+ // ── Rate limiting on sensitive endpoints (permissive — Beta) ──
94
+ v1.use('/auth/*', rateLimitMiddleware({ windowMs: 60_000, max: 20, keyPrefix: 'rl:auth', failClosed: true }));
95
+ v1.use('/deploy/*', rateLimitMiddleware({ windowMs: 60_000, max: 10, keyPrefix: 'rl:deploy', failClosed: true }));
96
+ v1.use('/self-update/*', rateLimitMiddleware({ windowMs: 60_000, max: 10, keyPrefix: 'rl:selfupdate', failClosed: true }));
97
+ v1.use('/commands/*', rateLimitMiddleware({ windowMs: 60_000, max: 60, keyPrefix: 'rl:commands' }));
98
+ v1.use('/quick-command/*', rateLimitMiddleware({ windowMs: 60_000, max: 30, keyPrefix: 'rl:quickcmd' }));
99
+ v1.use('/users/*', rateLimitMiddleware({ windowMs: 60_000, max: 30, keyPrefix: 'rl:users' }));
100
+ v1.use('/roles/*', rateLimitMiddleware({ windowMs: 60_000, max: 30, keyPrefix: 'rl:roles' }));
101
+ v1.use('/webhooks/*', rateLimitMiddleware({ windowMs: 60_000, max: 30, keyPrefix: 'rl:webhooks' }));
102
+ v1.use('/terminal/*', rateLimitMiddleware({ windowMs: 60_000, max: 20, keyPrefix: 'rl:terminal', failClosed: true }));
103
+ v1.use('/hermes/*', rateLimitMiddleware({ windowMs: 60_000, max: 20, keyPrefix: 'rl:hermes' }));
104
+ v1.use('/hermes-registry/*', rateLimitMiddleware({ windowMs: 60_000, max: 120, keyPrefix: 'rl:hermes-registry', failClosed: true }));
105
+ v1.use('/orchestra/*', rateLimitMiddleware({ windowMs: 60_000, max: 30, keyPrefix: 'rl:orchestra' }));
106
+ v1.use('/codex/*', rateLimitMiddleware({ windowMs: 60_000, max: 60, keyPrefix: 'rl:codex' }));
107
+ v1.use('/ardent/*', rateLimitMiddleware({ windowMs: 60_000, max: 60, keyPrefix: 'rl:ardent' }));
108
+ v1.use('/security-fusion/*', rateLimitMiddleware({ windowMs: 60_000, max: 120, keyPrefix: 'rl:security-fusion', failClosed: true }));
109
+ v1.route('/nodes', nodesRouter);
110
+ v1.route('/commands', commandsRouter);
111
+ v1.route('/resource-leases', resourceLeasesRouter);
112
+ v1.route('/shared-resource-leases', sharedResourceLeasesRouter);
113
+ v1.route('/cron', cronRouter);
114
+ v1.route('/files', filesRouter);
115
+ v1.route('/skills', skillsRouter);
116
+ v1.route('/logs', logsRouter);
117
+ v1.route('/health', healthRouter);
118
+ v1.route('/audit', auditRouter);
119
+ v1.route('/heartbeat', heartbeatRouter);
120
+ v1.route('/deploy', deployRouter);
121
+ v1.route('/discovery', discoveryRouter);
122
+ v1.route('/quick-command', quickCommandRouter);
123
+ v1.route('/stats', statsRouter);
124
+ v1.route('/library', libraryRouter);
125
+ v1.route('/roles', rolesRouter);
126
+ v1.route('/notifications', notificationsRouter);
127
+ v1.route('/self-update', selfUpdateRouter);
128
+ v1.route('/scan', scanRouter);
129
+ v1.route('/terminal', terminalTicketRouter);
130
+ v1.route('/users', usersRouter);
131
+ v1.route('/auth', authRouter);
132
+ v1.route('/webhooks', webhooksRouter);
133
+ v1.route('/alerts', alertsRouter);
134
+ v1.route('/drift', driftRouter);
135
+ v1.route('/rollouts', rolloutRouter);
136
+ v1.route('/anomalies', anomaliesRouter);
137
+ v1.route('/predictions', predictionsRouter);
138
+ v1.route('/fleet-checks', fleetChecksRouter);
139
+ v1.route('/hermes', hermesRouter);
140
+ v1.route('/hermes-registry', hermesRegistryRouter);
141
+ v1.route('/orchestra', hermesRouter);
142
+ v1.route('/orchestra', orchestraRouter);
143
+ v1.route('/codex', codexRouter);
144
+ v1.route('/ardent', ardentRouter);
145
+ v1.route('/remediation', remediationRouter);
146
+ v1.route('/team-approvals', teamApprovalRouter);
147
+ v1.route('/credentials', credentialsRouter);
148
+ v1.route('/topology', topologyRouter);
149
+ v1.route('/dependencies', dependenciesRouter);
150
+ v1.route('/ai-schedules', aiScheduleRouter);
151
+ v1.route('/profiling', profilingRouter);
152
+ v1.route('/assistant', assistantRouter);
153
+ v1.route('/events/stream', eventsStreamRouter);
154
+ v1.route('/ops', opsRouter);
155
+ v1.route('/mcp', mcpRouter);
156
+ v1.route('/security-integration', securityIntegrationRouter);
157
+ v1.use('/security-fusion/*', async (c, next) => {
158
+ const mode = securityFusionMode();
159
+ if (mode === 'remote') {
160
+ const url = securityConsoleUrl();
161
+ return c.json({ success: false, error: { code: 'SECURITY_FUSION_MOVED',
162
+ message: 'Security Fusion is served by the external security console', ...(url ? { url } : {}) } }, 410);
163
+ }
164
+ if (mode === 'off') {
165
+ return c.json({ success: false, error: { code: 'SECURITY_FUSION_DISABLED',
166
+ message: 'Security Fusion is disabled; set SECURITY_FUSION_MODE=local or remote to enable it' } }, 404);
167
+ }
168
+ await next();
169
+ });
170
+ v1.route('/security-fusion', securityFusionRouter);
171
+ app.route('/api/v1', v1);
172
+ // ── API documentation (Swagger UI + OpenAPI spec) ──
173
+ app.route('/api/docs', docsRouter);
174
+ // ── Prometheus metrics (METRICS_TOKEN bearer required; 503 until configured) ──
175
+ app.route('/metrics', metricsRouter);
176
+ // ── Root health-check ──
177
+ app.get('/', (c) => c.json({ service: 'magnus-control-api', status: 'ok' }));
178
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1,71 @@
1
+ /** Durable node-scoped API reservation barrier. This is not a global writer fence. */
2
+ import { z } from 'zod';
3
+ import { getDb } from '../db/index.js';
4
+ import { HttpError } from '../middleware/error-handler.js';
5
+ import { lockResourceNode } from './resource-node-lock.js';
6
+ export const admissionFenceRequest = z.object({ nodeFqdn: z.string().min(1).max(253), releaseId: z.string().guid() }).strict();
7
+ /** Serialize all Control API shared-resource admissions with admission fence close.
8
+ * Shared leases have no node owner, so any closed admission fence pauses this
9
+ * API's new shared work globally. Independent writers remain outside coverage.
10
+ */
11
+ export async function lockSharedAdmission(tx) {
12
+ await tx.$executeRaw `SELECT pg_advisory_xact_lock(hashtextextended('shared-resource-admission:v1', 0))`;
13
+ }
14
+ export async function assertSharedAdmissionOpen(tx) {
15
+ if (await tx.admissionFence.findFirst({ select: { nodeId: true } }))
16
+ throw new HttpError(409, 'ADMISSION_FENCED', 'release has closed Control API shared-resource admission');
17
+ }
18
+ export async function assertNodeAdmissionOpen(tx, nodeId) {
19
+ if (await tx.admissionFence.findUnique({ where: { nodeId }, select: { nodeId: true } }))
20
+ throw new HttpError(409, 'ADMISSION_FENCED', 'release has closed Control API node admission');
21
+ }
22
+ export async function closeNodeAdmission(nodeId, nodeFqdn, releaseId) {
23
+ admissionFenceRequest.parse({ nodeFqdn, releaseId });
24
+ return getDb().$transaction(async (tx) => {
25
+ await lockSharedAdmission(tx);
26
+ await lockResourceNode(tx, nodeId);
27
+ const node = await tx.node.findUnique({ where: { id: nodeId }, select: { hostname: true } });
28
+ if (!node || node.hostname !== nodeFqdn)
29
+ throw new HttpError(409, 'RESOURCE_TARGET_INVALID', 'admission fence target differs from canonical inventory');
30
+ const prior = await tx.admissionFence.findUnique({ where: { nodeId } });
31
+ if (prior && (prior.releaseId !== releaseId || prior.nodeFqdn !== nodeFqdn))
32
+ throw new HttpError(409, 'RELEASE_FENCE_CONFLICT', 'A different release already owns the node fence');
33
+ const row = prior ?? await tx.admissionFence.create({ data: { nodeId, nodeFqdn, releaseId } });
34
+ return { nodeId, nodeFqdn, releaseId, closedAt: row.closedAt, coverage: 'control-api-node-reservations' };
35
+ });
36
+ }
37
+ export async function inspectNodeAdmission(nodeId) {
38
+ return getDb().$transaction(async (tx) => {
39
+ await lockResourceNode(tx, nodeId);
40
+ const node = await tx.node.findUnique({ where: { id: nodeId }, select: { hostname: true } });
41
+ if (!node)
42
+ throw new HttpError(404, 'RESOURCE_TARGET_INVALID', 'managed node is absent');
43
+ const row = await tx.admissionFence.findUnique({ where: { nodeId } });
44
+ return { nodeId, nodeFqdn: node.hostname, closed: Boolean(row), releaseId: row?.releaseId ?? null,
45
+ closedAt: row?.closedAt ?? null, coverage: 'control-api-node-reservations',
46
+ independentWritersCovered: false };
47
+ });
48
+ }
49
+ /** Reopen only this API's future reservations. Enrollment history remains intact. */
50
+ export async function releaseNodeAdmission(nodeId, nodeFqdn, releaseId) {
51
+ admissionFenceRequest.parse({ nodeFqdn, releaseId });
52
+ return getDb().$transaction(async (tx) => {
53
+ await lockSharedAdmission(tx);
54
+ await lockResourceNode(tx, nodeId);
55
+ const node = await tx.node.findUnique({ where: { id: nodeId }, select: { hostname: true } });
56
+ const row = await tx.admissionFence.findUnique({ where: { nodeId } });
57
+ if (!node || node.hostname !== nodeFqdn || !row || row.nodeFqdn !== nodeFqdn || row.releaseId !== releaseId)
58
+ throw new HttpError(409, 'RELEASE_FENCE_CONFLICT', 'Exact managed node fence and release are required');
59
+ const [commands, participants, cron, shared] = await Promise.all([
60
+ tx.commandResourceLease.count({ where: { nodeId, state: { in: ['reserved', 'running', 'unknown'] } } }),
61
+ tx.resourceParticipantWork.count({ where: { nodeId, state: { in: ['reserved', 'running', 'unknown'] } } }),
62
+ tx.managedCronOccurrence.count({ where: { nodeId, state: { not: 'completed' } } }),
63
+ tx.sharedResourceLease.count({ where: { state: { in: ['reserved', 'running', 'unknown'] } } }),
64
+ ]);
65
+ if (commands || participants || cron || shared)
66
+ throw new HttpError(409, 'ADMISSION_WORK_UNSETTLED', 'Control API node or shared work is active or unknown; retain the admission fence');
67
+ await tx.admissionFence.delete({ where: { nodeId } });
68
+ return { nodeId, nodeFqdn, releaseId, closed: false, coverage: 'control-api-node-reservations' };
69
+ });
70
+ }
71
+ //# sourceMappingURL=admission-fence.js.map