@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.
- package/.env.example +171 -0
- package/LICENSE +202 -0
- package/README.md +169 -2
- package/agent-version.json +1 -0
- package/dist/ai/HEARTBEAT.md +56 -0
- package/dist/ai/IDENTITY.md +54 -0
- package/dist/ai/MEMORY.md +40 -0
- package/dist/ai/TOOLS.md +538 -0
- package/dist/ai/USER.md +32 -0
- package/dist/cli/args.js +62 -0
- package/dist/cli/env-catalog.js +131 -0
- package/dist/cli/preflight.js +89 -0
- package/dist/cli.js +175 -0
- package/dist/config/cors.js +16 -0
- package/dist/config/env.js +392 -0
- package/dist/config/features.js +16 -0
- package/dist/config/index.js +3 -0
- package/dist/config/listener-security.js +38 -0
- package/dist/config/version.js +31 -0
- package/dist/db/client.js +44 -0
- package/dist/db/generated/prisma/browser.js +18 -0
- package/dist/db/generated/prisma/client.js +35 -0
- package/dist/db/generated/prisma/commonInputTypes.js +11 -0
- package/dist/db/generated/prisma/enums.js +42 -0
- package/dist/db/generated/prisma/internal/class.js +50 -0
- package/dist/db/generated/prisma/internal/prismaNamespace.js +1598 -0
- package/dist/db/generated/prisma/internal/prismaNamespaceBrowser.js +1569 -0
- package/dist/db/generated/prisma/models/A2ATask.js +2 -0
- package/dist/db/generated/prisma/models/AdmissionFence.js +2 -0
- package/dist/db/generated/prisma/models/Agent.js +2 -0
- package/dist/db/generated/prisma/models/AiConversation.js +2 -0
- package/dist/db/generated/prisma/models/AiDashboard.js +2 -0
- package/dist/db/generated/prisma/models/AiMemory.js +2 -0
- package/dist/db/generated/prisma/models/AiMessage.js +2 -0
- package/dist/db/generated/prisma/models/AiScheduledOp.js +2 -0
- package/dist/db/generated/prisma/models/AlertConditionState.js +2 -0
- package/dist/db/generated/prisma/models/AlertRule.js +2 -0
- package/dist/db/generated/prisma/models/AlertViolation.js +2 -0
- package/dist/db/generated/prisma/models/AnomalyEvent.js +2 -0
- package/dist/db/generated/prisma/models/ApplicationObservation.js +2 -0
- package/dist/db/generated/prisma/models/ArdentInstallation.js +2 -0
- package/dist/db/generated/prisma/models/ArdentProfile.js +2 -0
- package/dist/db/generated/prisma/models/ArdentScopeEnrollment.js +2 -0
- package/dist/db/generated/prisma/models/CommandResourceFence.js +2 -0
- package/dist/db/generated/prisma/models/CommandResourceLease.js +2 -0
- package/dist/db/generated/prisma/models/CommandResult.js +2 -0
- package/dist/db/generated/prisma/models/CronJob.js +2 -0
- package/dist/db/generated/prisma/models/CronJobExecution.js +2 -0
- package/dist/db/generated/prisma/models/DeployJob.js +2 -0
- package/dist/db/generated/prisma/models/DriftScan.js +2 -0
- package/dist/db/generated/prisma/models/EngineeringMetricSample.js +2 -0
- package/dist/db/generated/prisma/models/EngineeringRecoveryExercise.js +2 -0
- package/dist/db/generated/prisma/models/ExecutionRun.js +2 -0
- package/dist/db/generated/prisma/models/FilePatchTask.js +2 -0
- package/dist/db/generated/prisma/models/GpuSnapshot.js +2 -0
- package/dist/db/generated/prisma/models/HealthSnapshot.js +2 -0
- package/dist/db/generated/prisma/models/HermesCoreRollout.js +2 -0
- package/dist/db/generated/prisma/models/HermesCoreRolloutHost.js +2 -0
- package/dist/db/generated/prisma/models/HermesCredentialPool.js +2 -0
- package/dist/db/generated/prisma/models/HermesCredentialPoolAttachment.js +2 -0
- package/dist/db/generated/prisma/models/HermesCronJob.js +2 -0
- package/dist/db/generated/prisma/models/HermesHook.js +2 -0
- package/dist/db/generated/prisma/models/HermesInstallation.js +2 -0
- package/dist/db/generated/prisma/models/HermesMcpServer.js +2 -0
- package/dist/db/generated/prisma/models/HermesMcpServerAttachment.js +2 -0
- package/dist/db/generated/prisma/models/HermesMessagingBinding.js +2 -0
- package/dist/db/generated/prisma/models/HermesOperationJob.js +2 -0
- package/dist/db/generated/prisma/models/HermesPluginInstall.js +2 -0
- package/dist/db/generated/prisma/models/HermesProfile.js +2 -0
- package/dist/db/generated/prisma/models/HermesProviderConfig.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryClient.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryInventory.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryReceipt.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryRevision.js +2 -0
- package/dist/db/generated/prisma/models/HermesRegistryTarget.js +2 -0
- package/dist/db/generated/prisma/models/HermesRole.js +2 -0
- package/dist/db/generated/prisma/models/HermesRoleApplication.js +2 -0
- package/dist/db/generated/prisma/models/HermesSkillAssignment.js +2 -0
- package/dist/db/generated/prisma/models/HermesToolsetPolicy.js +2 -0
- package/dist/db/generated/prisma/models/IncidentLesson.js +2 -0
- package/dist/db/generated/prisma/models/LibraryCategory.js +2 -0
- package/dist/db/generated/prisma/models/LibraryFile.js +2 -0
- package/dist/db/generated/prisma/models/LogEntry.js +2 -0
- package/dist/db/generated/prisma/models/MagnusReleaseCanary.js +2 -0
- package/dist/db/generated/prisma/models/MaintenanceWindow.js +2 -0
- package/dist/db/generated/prisma/models/ManagedCronDefinition.js +2 -0
- package/dist/db/generated/prisma/models/ManagedCronOccurrence.js +2 -0
- package/dist/db/generated/prisma/models/Node.js +2 -0
- package/dist/db/generated/prisma/models/Notification.js +2 -0
- package/dist/db/generated/prisma/models/NotificationPreference.js +2 -0
- package/dist/db/generated/prisma/models/RemediationExecution.js +2 -0
- package/dist/db/generated/prisma/models/RemediationRule.js +2 -0
- package/dist/db/generated/prisma/models/RemoteCommand.js +2 -0
- package/dist/db/generated/prisma/models/ResourceDrainParticipant.js +2 -0
- package/dist/db/generated/prisma/models/ResourceEnrollment.js +2 -0
- package/dist/db/generated/prisma/models/ResourceParticipantWork.js +2 -0
- package/dist/db/generated/prisma/models/Role.js +2 -0
- package/dist/db/generated/prisma/models/RoleApplication.js +2 -0
- package/dist/db/generated/prisma/models/RolloutTarget.js +2 -0
- package/dist/db/generated/prisma/models/SecurityExportOutbox.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionAction.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionActionApproval.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCase.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCaseActivity.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCaseEntity.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCaseEvent.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCaseRelationship.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCollector.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionCommandOutbox.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionDeletionReceipt.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionDelivery.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEntity.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEntityAlias.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEvent.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEventEntity.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionEvidence.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionInvestigation.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionNonce.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionReceiptChainHead.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionRuleVersion.js +2 -0
- package/dist/db/generated/prisma/models/SecurityFusionSourceState.js +2 -0
- package/dist/db/generated/prisma/models/SecurityServiceState.js +2 -0
- package/dist/db/generated/prisma/models/SharedResourceFence.js +2 -0
- package/dist/db/generated/prisma/models/SharedResourceLease.js +2 -0
- package/dist/db/generated/prisma/models/SharedResourceLeaseResource.js +2 -0
- package/dist/db/generated/prisma/models/SkillInstallation.js +2 -0
- package/dist/db/generated/prisma/models/SkillRegistryEntry.js +2 -0
- package/dist/db/generated/prisma/models/SkillTag.js +2 -0
- package/dist/db/generated/prisma/models/SkillVersion.js +2 -0
- package/dist/db/generated/prisma/models/TeamApprovalDecision.js +2 -0
- package/dist/db/generated/prisma/models/User.js +2 -0
- package/dist/db/generated/prisma/models/WebhookDelivery.js +2 -0
- package/dist/db/generated/prisma/models/WebhookEndpoint.js +2 -0
- package/dist/db/generated/prisma/models.js +2 -0
- package/dist/db/index.js +3 -0
- package/dist/db/read-retry.js +35 -0
- package/dist/db/seed.js +348 -0
- package/dist/index.js +162 -0
- package/dist/middleware/auth.js +361 -0
- package/dist/middleware/body-limit.js +14 -0
- package/dist/middleware/correlation-id.js +13 -0
- package/dist/middleware/error-handler.js +28 -0
- package/dist/middleware/iam-token.js +21 -0
- package/dist/middleware/rate-limit.js +78 -0
- package/dist/middleware/request-logger.js +85 -0
- package/dist/middleware/security-headers.js +23 -0
- package/dist/middleware/tracing.js +120 -0
- package/dist/middleware/user-status.js +33 -0
- package/dist/openapi/spec.js +2656 -0
- package/dist/queue/redis.js +20 -0
- package/dist/queue/requeue.js +27 -0
- package/dist/queue/workers.js +342 -0
- package/dist/routes/ai-schedule.js +73 -0
- package/dist/routes/alerts.js +79 -0
- package/dist/routes/anomalies.js +101 -0
- package/dist/routes/ardent.js +82 -0
- package/dist/routes/assistant.js +417 -0
- package/dist/routes/audit.js +138 -0
- package/dist/routes/codex.js +65 -0
- package/dist/routes/commands.js +226 -0
- package/dist/routes/credentials.js +58 -0
- package/dist/routes/cron.js +292 -0
- package/dist/routes/dependencies.js +49 -0
- package/dist/routes/deploy.js +18 -0
- package/dist/routes/discovery.js +168 -0
- package/dist/routes/docs.js +24 -0
- package/dist/routes/drift.js +126 -0
- package/dist/routes/events-stream.js +87 -0
- package/dist/routes/files.js +214 -0
- package/dist/routes/fleet-checks.js +21 -0
- package/dist/routes/health.js +133 -0
- package/dist/routes/heartbeat.js +545 -0
- package/dist/routes/hermes-registry.js +278 -0
- package/dist/routes/hermes.js +61 -0
- package/dist/routes/library.js +402 -0
- package/dist/routes/logs.js +172 -0
- package/dist/routes/managed-cron.js +23 -0
- package/dist/routes/mcp.js +39 -0
- package/dist/routes/metrics.js +187 -0
- package/dist/routes/nodes.js +951 -0
- package/dist/routes/notifications.js +130 -0
- package/dist/routes/ops.js +258 -0
- package/dist/routes/orchestra.js +430 -0
- package/dist/routes/predictions.js +23 -0
- package/dist/routes/profiling.js +68 -0
- package/dist/routes/quick-command.js +72 -0
- package/dist/routes/remediation.js +111 -0
- package/dist/routes/resource-leases.js +297 -0
- package/dist/routes/roles.js +370 -0
- package/dist/routes/rollout.js +124 -0
- package/dist/routes/scan.js +116 -0
- package/dist/routes/security-backup.js +58 -0
- package/dist/routes/security-fusion.js +605 -0
- package/dist/routes/security-integration.js +71 -0
- package/dist/routes/self-update.js +129 -0
- package/dist/routes/shared-resource-leases.js +78 -0
- package/dist/routes/skills.js +485 -0
- package/dist/routes/stats.js +96 -0
- package/dist/routes/team-approvals.js +23 -0
- package/dist/routes/terminal-ticket.js +15 -0
- package/dist/routes/terminal.js +17 -0
- package/dist/routes/topology.js +37 -0
- package/dist/routes/users.js +219 -0
- package/dist/routes/webhooks.js +137 -0
- package/dist/schemas/command-reconciliation.js +14 -0
- package/dist/schemas/commands.js +51 -0
- package/dist/schemas/cron.js +33 -0
- package/dist/schemas/deploy.js +20 -0
- package/dist/schemas/files.js +14 -0
- package/dist/schemas/hermes.js +69 -0
- package/dist/schemas/index.js +11 -0
- package/dist/schemas/library.js +48 -0
- package/dist/schemas/logs.js +35 -0
- package/dist/schemas/managed-cron.js +127 -0
- package/dist/schemas/node-responses.js +87 -0
- package/dist/schemas/node-session-receipt.js +84 -0
- package/dist/schemas/nodes.js +36 -0
- package/dist/schemas/orchestra.js +118 -0
- package/dist/schemas/resource-participant-reconciliation.js +99 -0
- package/dist/schemas/roles.js +54 -0
- package/dist/schemas/shared-resource-lease.js +132 -0
- package/dist/schemas/skills.js +44 -0
- package/dist/schemas/users.js +28 -0
- package/dist/scripts/run-disposable-recovery-exercise.js +39 -0
- package/dist/sdk/index.js +2 -0
- package/dist/sdk/node-api-client.js +474 -0
- package/dist/security/approval-assertion.js +66 -0
- package/dist/security/command-completion-registry.js +35 -0
- package/dist/security/command-request.js +12 -0
- package/dist/security/command-result-signature.js +34 -0
- package/dist/security/managed-http.js +45 -0
- package/dist/security/native-completion-registry.js +44 -0
- package/dist/server.js +178 -0
- package/dist/services/admission-fence.js +71 -0
- package/dist/services/ai-assistant-service.js +2523 -0
- package/dist/services/ai-correlation-service.js +225 -0
- package/dist/services/ai-export-service.js +141 -0
- package/dist/services/ai-insights-service.js +219 -0
- package/dist/services/ai-schedule-service.js +145 -0
- package/dist/services/ai-scratchpad-service.js +222 -0
- package/dist/services/ai-tools.js +1343 -0
- package/dist/services/alert-service.js +313 -0
- package/dist/services/anomaly-detector.js +419 -0
- package/dist/services/api-local-work.js +79 -0
- package/dist/services/application-probes.js +309 -0
- package/dist/services/ardent-scope-enrollment.js +123 -0
- package/dist/services/ardent-service.js +86 -0
- package/dist/services/audit-service.js +308 -0
- package/dist/services/codex-service.js +209 -0
- package/dist/services/command-lifecycle.js +60 -0
- package/dist/services/command-resource-leases.js +305 -0
- package/dist/services/control-host-node.js +242 -0
- package/dist/services/credential-rotation-service.js +294 -0
- package/dist/services/dependency-service.js +145 -0
- package/dist/services/disposable-recovery-runner.js +595 -0
- package/dist/services/docker-group-health.js +121 -0
- package/dist/services/engineering-assurance.js +492 -0
- package/dist/services/engineering-evidence-ledger.js +94 -0
- package/dist/services/engineering-metric-evidence.js +26 -0
- package/dist/services/event-bus.js +227 -0
- package/dist/services/fleet-check-log.js +102 -0
- package/dist/services/forecast-service.js +154 -0
- package/dist/services/health-retention.js +175 -0
- package/dist/services/heartbeat-stream.js +63 -0
- package/dist/services/hermes-catalog-import.js +62 -0
- package/dist/services/hermes-cli-parser.js +671 -0
- package/dist/services/hermes-core-rollout.js +90 -0
- package/dist/services/hermes-dashboard-endpoint.js +13 -0
- package/dist/services/hermes-plugin-source.js +149 -0
- package/dist/services/hermes-registry-service.js +258 -0
- package/dist/services/hermes-service.js +566 -0
- package/dist/services/hivemem-client.js +85 -0
- package/dist/services/host-local-writer.js +82 -0
- package/dist/services/incident-evidence.js +110 -0
- package/dist/services/incident-lessons.js +186 -0
- package/dist/services/llm-providers/anthropic.js +143 -0
- package/dist/services/llm-providers/index.js +7 -0
- package/dist/services/llm-providers/llama-cpp.js +237 -0
- package/dist/services/llm-providers/ollama.js +292 -0
- package/dist/services/llm-providers/openai-compatible.js +200 -0
- package/dist/services/llm-providers/provider-error.js +36 -0
- package/dist/services/llm-providers/registry.js +45 -0
- package/dist/services/llm-providers/types.js +2 -0
- package/dist/services/log-emitter.js +19 -0
- package/dist/services/log-retention.js +66 -0
- package/dist/services/maintenance-service.js +29 -0
- package/dist/services/managed-cron.js +493 -0
- package/dist/services/managed-ssh-admission.js +68 -0
- package/dist/services/monitor-pulse.js +10 -0
- package/dist/services/node-issue-monitor.js +71 -0
- package/dist/services/node-service.js +35 -0
- package/dist/services/notification-retention.js +51 -0
- package/dist/services/notification-service.js +94 -0
- package/dist/services/operational-observations.js +112 -0
- package/dist/services/operations-config.js +67 -0
- package/dist/services/ops-service.js +491 -0
- package/dist/services/orchestra-extras-service.js +370 -0
- package/dist/services/orchestra-resources-service.js +530 -0
- package/dist/services/os-scheduler-writer.js +73 -0
- package/dist/services/password-service.js +22 -0
- package/dist/services/prediction-service.js +284 -0
- package/dist/services/recovery-exercises.js +682 -0
- package/dist/services/remediation-service.js +325 -0
- package/dist/services/resource-enrollment.js +433 -0
- package/dist/services/resource-node-lock.js +18 -0
- package/dist/services/resource-participant-work.js +302 -0
- package/dist/services/role-service.js +388 -0
- package/dist/services/rollout-service.js +440 -0
- package/dist/services/security-export.js +185 -0
- package/dist/services/security-fusion-actions.js +22 -0
- package/dist/services/security-fusion-approvals.js +83 -0
- package/dist/services/security-fusion-evidence-integrity.js +144 -0
- package/dist/services/security-fusion-ingest.js +101 -0
- package/dist/services/security-fusion-outbox.js +185 -0
- package/dist/services/security-fusion-receipt-chain.js +134 -0
- package/dist/services/security-fusion-service.js +751 -0
- package/dist/services/security-fusion-verification.js +50 -0
- package/dist/services/self-update-service.js +200 -0
- package/dist/services/shared-resource-leases.js +413 -0
- package/dist/services/skill-publication-bundle.js +90 -0
- package/dist/services/skill-publication-settlement.js +36 -0
- package/dist/services/skill-publication-state.js +40 -0
- package/dist/services/skill-registry-service.js +327 -0
- package/dist/services/skill-service.js +148 -0
- package/dist/services/ssh-exec-service.js +139 -0
- package/dist/services/ssh-host-verification.js +27 -0
- package/dist/services/tailscale-node-key-service.js +75 -0
- package/dist/services/team-approvals.js +118 -0
- package/dist/services/topology-service.js +138 -0
- package/dist/services/transfer-authority-snapshot.js +151 -0
- package/dist/services/webhook-credential-migration.js +97 -0
- package/dist/services/webhook-security.js +242 -0
- package/dist/services/webhook-service.js +494 -0
- package/dist/types/auth.js +3 -0
- package/dist/types/index.js +3 -0
- package/dist/types/library.js +3 -0
- package/dist/types/notifications.js +3 -0
- package/dist/types/roles.js +3 -0
- package/dist/types/shared-contracts.js +3 -0
- package/dist/utils/env.js +141 -0
- package/dist/utils/heartbeat-peer.js +19 -0
- package/dist/utils/idempotency.js +45 -0
- package/dist/utils/ip.js +25 -0
- package/dist/utils/json-fields.js +94 -0
- package/dist/utils/local-tls.js +39 -0
- package/dist/utils/magnus-home.js +15 -0
- package/dist/utils/node-url.js +59 -0
- package/dist/utils/redact.js +26 -0
- package/dist/utils/safe-equal.js +13 -0
- package/dist/utils/sentinel-nodes.js +16 -0
- package/dist/utils/validate.js +41 -0
- package/package.json +119 -4
- package/prisma/migrations/20261031000000_baseline/migration.sql +2935 -0
- package/prisma/migrations/migration_lock.toml +3 -0
- package/prisma/schema.prisma +2185 -0
- package/prisma.config.ts +14 -0
|
@@ -0,0 +1,485 @@
|
|
|
1
|
+
import { Hono } from 'hono';
|
|
2
|
+
import { getDb } from '../db/index.js';
|
|
3
|
+
import { authMiddleware, getUser, requireRole } from '../middleware/auth.js';
|
|
4
|
+
import { logAuditEvent } from '../services/audit-service.js';
|
|
5
|
+
import { HttpError } from '../middleware/error-handler.js';
|
|
6
|
+
import * as skillService from '../services/skill-service.js';
|
|
7
|
+
import * as registryService from '../services/skill-registry-service.js';
|
|
8
|
+
import { parseBody } from '../utils/validate.js';
|
|
9
|
+
import { createSkillSchema, updateSkillSchema, updateSkillFileSchema, pushSkillSchema, publishVersionSchema, setTagSchema, } from '../schemas/skills.js';
|
|
10
|
+
import { enforceIdempotencyFromHeader } from '../utils/idempotency.js';
|
|
11
|
+
import { NodeApiClient } from '../sdk/index.js';
|
|
12
|
+
import { getNodeBaseUrl } from '../utils/node-url.js';
|
|
13
|
+
import { getNodeManagerSecret } from '../utils/env.js';
|
|
14
|
+
import { buildSkillPublicationBundle } from '../services/skill-publication-bundle.js';
|
|
15
|
+
import { isExactInstalledPublication, isSameSkillPublication, nextSkillPublicationCommandId, skillPublicationCommandId } from '../services/skill-publication-state.js';
|
|
16
|
+
import { httpIdentity } from '../security/managed-http.js';
|
|
17
|
+
import { commandRequestDigest } from '../security/command-request.js';
|
|
18
|
+
import { commandFenceSchema } from '../schemas/node-responses.js';
|
|
19
|
+
import { retainUnknownResourceCommand } from '../services/command-resource-leases.js';
|
|
20
|
+
import { isSkillPublicationNoEffectSettlement } from '../services/skill-publication-settlement.js';
|
|
21
|
+
export const skillsRouter = new Hono();
|
|
22
|
+
skillsRouter.use('*', authMiddleware);
|
|
23
|
+
// ── List all skills (filesystem, merged with install counts from DB) ──
|
|
24
|
+
skillsRouter.get('/', async (c) => {
|
|
25
|
+
const db = getDb();
|
|
26
|
+
const skills = await skillService.listSkills();
|
|
27
|
+
// Gather install counts from DB
|
|
28
|
+
const installations = await db.skillInstallation.findMany({
|
|
29
|
+
select: { skillName: true, nodeId: true, status: true, version: true },
|
|
30
|
+
});
|
|
31
|
+
const installMap = new Map();
|
|
32
|
+
for (const inst of installations) {
|
|
33
|
+
const list = installMap.get(inst.skillName) ?? [];
|
|
34
|
+
list.push({ nodeId: inst.nodeId, status: inst.status, version: inst.version });
|
|
35
|
+
installMap.set(inst.skillName, list);
|
|
36
|
+
}
|
|
37
|
+
const data = skills.map((s) => ({
|
|
38
|
+
...s,
|
|
39
|
+
installations: installMap.get(s.name) ?? [],
|
|
40
|
+
}));
|
|
41
|
+
return c.json({ success: true, data });
|
|
42
|
+
});
|
|
43
|
+
// ── Get a single skill ──
|
|
44
|
+
skillsRouter.get('/:name{[a-zA-Z0-9_-]+}', async (c) => {
|
|
45
|
+
const name = c.req.param('name');
|
|
46
|
+
const skill = await skillService.getSkill(name);
|
|
47
|
+
if (!skill)
|
|
48
|
+
throw new HttpError(404, 'NOT_FOUND', 'Skill not found');
|
|
49
|
+
return c.json({ success: true, data: skill });
|
|
50
|
+
});
|
|
51
|
+
// ── Read a file from a skill directory ──
|
|
52
|
+
skillsRouter.get('/:name{[a-zA-Z0-9_-]+}/files/:fileName', async (c) => {
|
|
53
|
+
const name = c.req.param('name');
|
|
54
|
+
const fileName = c.req.param('fileName');
|
|
55
|
+
const content = await skillService.getSkillFile(name, fileName);
|
|
56
|
+
if (content === null)
|
|
57
|
+
throw new HttpError(404, 'NOT_FOUND', 'File not found');
|
|
58
|
+
return c.json({ success: true, data: { fileName, content } });
|
|
59
|
+
});
|
|
60
|
+
// ── Update (or create) a file within a skill directory ──
|
|
61
|
+
skillsRouter.put('/:name{[a-zA-Z0-9_-]+}/files/:fileName', requireRole('ADMIN', 'OPERATOR'), async (c) => {
|
|
62
|
+
const user = getUser(c);
|
|
63
|
+
const name = c.req.param('name');
|
|
64
|
+
const fileName = c.req.param('fileName');
|
|
65
|
+
const body = await parseBody(c, updateSkillFileSchema);
|
|
66
|
+
const skill = await skillService.getSkill(name);
|
|
67
|
+
if (!skill)
|
|
68
|
+
throw new HttpError(404, 'NOT_FOUND', 'Skill not found');
|
|
69
|
+
await skillService.updateSkillFile(name, fileName, body.content);
|
|
70
|
+
await logAuditEvent({
|
|
71
|
+
action: 'skill.file.update',
|
|
72
|
+
actorId: user.userId,
|
|
73
|
+
targetType: 'skill',
|
|
74
|
+
targetId: name,
|
|
75
|
+
details: { fileName },
|
|
76
|
+
});
|
|
77
|
+
return c.json({ success: true, data: { fileName } });
|
|
78
|
+
});
|
|
79
|
+
// ── Create a new skill ──
|
|
80
|
+
skillsRouter.post('/', requireRole('ADMIN', 'OPERATOR'), async (c) => {
|
|
81
|
+
const user = getUser(c);
|
|
82
|
+
const body = await parseBody(c, createSkillSchema);
|
|
83
|
+
try {
|
|
84
|
+
const skill = await skillService.createSkill({
|
|
85
|
+
name: body.name,
|
|
86
|
+
version: body.version,
|
|
87
|
+
description: body.description,
|
|
88
|
+
author: user.email,
|
|
89
|
+
entryPoint: body.entryPoint,
|
|
90
|
+
dependencies: body.dependencies,
|
|
91
|
+
tags: body.tags,
|
|
92
|
+
});
|
|
93
|
+
await logAuditEvent({
|
|
94
|
+
action: 'skill.create',
|
|
95
|
+
actorId: user.userId,
|
|
96
|
+
targetType: 'skill',
|
|
97
|
+
targetId: skill.name,
|
|
98
|
+
details: { name: body.name, version: body.version },
|
|
99
|
+
});
|
|
100
|
+
return c.json({ success: true, data: skill }, 201);
|
|
101
|
+
}
|
|
102
|
+
catch (err) {
|
|
103
|
+
if (err instanceof Error && err.message.includes('already exists')) {
|
|
104
|
+
throw new HttpError(409, 'CONFLICT', err.message);
|
|
105
|
+
}
|
|
106
|
+
throw err;
|
|
107
|
+
}
|
|
108
|
+
});
|
|
109
|
+
// ── Push skill to nodes ──
|
|
110
|
+
skillsRouter.post('/push', requireRole('ADMIN', 'OPERATOR'), async (c) => {
|
|
111
|
+
const db = getDb();
|
|
112
|
+
const user = getUser(c);
|
|
113
|
+
const body = await parseBody(c, pushSkillSchema);
|
|
114
|
+
const nodeIds = body.nodeIds;
|
|
115
|
+
const skillName = body.skillName;
|
|
116
|
+
const skill = await skillService.getSkill(skillName);
|
|
117
|
+
if (!skill)
|
|
118
|
+
throw new HttpError(404, 'NOT_FOUND', 'Skill not found');
|
|
119
|
+
// Look up registry entry for provenance linking
|
|
120
|
+
const version = body.version ?? skill.version;
|
|
121
|
+
const registryEntry = await db.skillRegistryEntry.findUnique({
|
|
122
|
+
where: { slug: skillName },
|
|
123
|
+
include: { versions: { where: { version }, take: 1 } },
|
|
124
|
+
});
|
|
125
|
+
const publishedVersion = registryEntry?.versions[0];
|
|
126
|
+
if (!registryEntry || !publishedVersion)
|
|
127
|
+
throw new HttpError(409, 'SKILL_VERSION_UNPUBLISHED', 'The exact skill version must be published before it can be installed');
|
|
128
|
+
const publication = await buildSkillPublicationBundle({ skillName, version,
|
|
129
|
+
registryContentSha256: publishedVersion.contentHash, registryFilesJson: publishedVersion.files });
|
|
130
|
+
// Fetch node connection details for all target nodes
|
|
131
|
+
const nodes = await db.node.findMany({
|
|
132
|
+
where: { id: { in: nodeIds } },
|
|
133
|
+
select: { id: true, hostname: true, ipAddress: true, port: true, status: true },
|
|
134
|
+
});
|
|
135
|
+
const nodeMap = new Map(nodes.map((n) => [n.id, n]));
|
|
136
|
+
const missing = nodeIds.find((nodeId) => !nodeMap.has(nodeId));
|
|
137
|
+
if (missing)
|
|
138
|
+
throw new HttpError(404, 'NODE_NOT_FOUND', `Node ${missing} is not in inventory`);
|
|
139
|
+
// Claim after validation/preview/preflight so a rejected retry is not a duplicate.
|
|
140
|
+
await enforceIdempotencyFromHeader(c);
|
|
141
|
+
const installations = await Promise.all(nodeIds.map(async (nodeId) => {
|
|
142
|
+
const node = nodeMap.get(nodeId);
|
|
143
|
+
if (!node)
|
|
144
|
+
throw new HttpError(404, 'NODE_NOT_FOUND', `Node ${nodeId} is not in inventory`);
|
|
145
|
+
const identity = { nodeId, skillName, version,
|
|
146
|
+
versionHash: publishedVersion.contentHash, bundleSha256: publication.bundleSha256,
|
|
147
|
+
treeSha256: publication.treeSha256 };
|
|
148
|
+
const prepared = await db.$transaction(async (tx) => {
|
|
149
|
+
await tx.$executeRaw `SELECT pg_advisory_xact_lock(hashtextextended(${`skill-publication:${nodeId}:${skillName}`}, 0))`;
|
|
150
|
+
const existing = await tx.skillInstallation.findUnique({ where: { skillName_nodeId: { skillName, nodeId } } });
|
|
151
|
+
const same = !!existing && isSameSkillPublication(existing, identity);
|
|
152
|
+
if (existing && isExactInstalledPublication(existing, identity))
|
|
153
|
+
return { kind: 'installed', install: existing };
|
|
154
|
+
if (existing?.status === 'installing' && !same)
|
|
155
|
+
throw new HttpError(409, 'SKILL_PUBLICATION_BUSY', 'A different skill publication still owns this installation workflow');
|
|
156
|
+
// A released/no-dispatch lease cannot be reused for admission. Walk a
|
|
157
|
+
// deterministic, evidence-bound retry chain until its exact current
|
|
158
|
+
// generation is either unused or still requires recovery.
|
|
159
|
+
let workflowCommandId = skillPublicationCommandId(identity);
|
|
160
|
+
for (let generation = 0; generation < 64; generation += 1) {
|
|
161
|
+
const lease = await tx.commandResourceLease.findUnique({ where: { commandId: workflowCommandId },
|
|
162
|
+
select: { state: true, settlement: true } });
|
|
163
|
+
if (!lease) {
|
|
164
|
+
if (await tx.remoteCommand.findUnique({ where: { id: workflowCommandId }, select: { id: true } }))
|
|
165
|
+
throw new HttpError(409, 'SKILL_PUBLICATION_BUSY', 'The exact publication command lost its durable authority record and cannot be replayed');
|
|
166
|
+
break;
|
|
167
|
+
}
|
|
168
|
+
if (lease.state !== 'released'
|
|
169
|
+
|| (lease.settlement !== 'not-dispatched' && !isSkillPublicationNoEffectSettlement(lease.settlement)))
|
|
170
|
+
break;
|
|
171
|
+
workflowCommandId = nextSkillPublicationCommandId(identity, workflowCommandId);
|
|
172
|
+
if (generation === 63)
|
|
173
|
+
throw new HttpError(409, 'SKILL_PUBLICATION_BUSY', 'Skill publication exceeded its bounded no-effect retry generations');
|
|
174
|
+
}
|
|
175
|
+
// A prior successor may be bypassed only with durable proof that its
|
|
176
|
+
// dispatch barrier was never crossed. Command status alone cannot prove
|
|
177
|
+
// no effect: failed/cancelled commands can still retain unknown ownership.
|
|
178
|
+
if (existing?.status === 'installed') {
|
|
179
|
+
const latest = await tx.remoteCommand.findFirst({ where: {
|
|
180
|
+
createdBy: `skill-installation:${existing.id}`,
|
|
181
|
+
}, orderBy: { createdAt: 'desc' }, select: { id: true } });
|
|
182
|
+
if (latest && latest.id !== existing.workflowCommandId && latest.id !== workflowCommandId) {
|
|
183
|
+
const latestLease = await tx.commandResourceLease.findUnique({ where: { commandId: latest.id },
|
|
184
|
+
select: { state: true, settlement: true } });
|
|
185
|
+
const provedNoEffect = !!latestLease && latestLease.state === 'released'
|
|
186
|
+
&& (latestLease.settlement === 'not-dispatched'
|
|
187
|
+
|| isSkillPublicationNoEffectSettlement(latestLease.settlement));
|
|
188
|
+
if (!provedNoEffect)
|
|
189
|
+
throw new HttpError(409, 'SKILL_PUBLICATION_BUSY', 'A prior successor has unresolved or effect evidence that must be correlated before another publication');
|
|
190
|
+
}
|
|
191
|
+
return { kind: 'successor', install: existing, workflowCommandId };
|
|
192
|
+
}
|
|
193
|
+
const install = await tx.skillInstallation.upsert({
|
|
194
|
+
where: { skillName_nodeId: { skillName, nodeId } },
|
|
195
|
+
update: { status: 'installing', version, registryEntryId: registryEntry.id,
|
|
196
|
+
versionHash: publishedVersion.contentHash, bundleSha256: publication.bundleSha256,
|
|
197
|
+
treeSha256: publication.treeSha256, workflowCommandId,
|
|
198
|
+
workflowRequestSha256: null, workflowReceiptSha256: null, installedAt: null, error: null },
|
|
199
|
+
create: { skillName, nodeId, version, status: 'installing', registryEntryId: registryEntry.id,
|
|
200
|
+
versionHash: publishedVersion.contentHash, bundleSha256: publication.bundleSha256,
|
|
201
|
+
treeSha256: publication.treeSha256, workflowCommandId },
|
|
202
|
+
});
|
|
203
|
+
return { kind: 'attempt', install, workflowCommandId };
|
|
204
|
+
});
|
|
205
|
+
const install = prepared.install;
|
|
206
|
+
if (prepared.kind === 'installed')
|
|
207
|
+
return { nodeId, status: install.status, installationId: install.id };
|
|
208
|
+
const candidateCommandId = prepared.workflowCommandId;
|
|
209
|
+
try {
|
|
210
|
+
const client = new NodeApiClient({ baseUrl: getNodeBaseUrl(node.ipAddress, node.port),
|
|
211
|
+
resourceNodeId: node.id, resourceActorId: `skill-installation:${install.id}`, nodeToken: getNodeManagerSecret() });
|
|
212
|
+
const payload = { skillName, version, bundleSha256: publication.bundleSha256, bundle: publication.bundle };
|
|
213
|
+
const priorLease = await db.commandResourceLease.findUnique({ where: { commandId: candidateCommandId } });
|
|
214
|
+
let evidence;
|
|
215
|
+
let publishedAt;
|
|
216
|
+
if (priorLease) {
|
|
217
|
+
const command = await db.remoteCommand.findUnique({ where: { id: candidateCommandId } });
|
|
218
|
+
const coordination = commandFenceSchema.parse(JSON.parse(priorLease.coordinationJson));
|
|
219
|
+
const commandIdentity = { ...httpIdentity(candidateCommandId, 'POST', '/skills/install', JSON.stringify(payload), command?.timeoutSeconds ?? 0), coordination };
|
|
220
|
+
if (!command || command.nodeId !== node.id || priorLease.nodeId !== node.id
|
|
221
|
+
|| priorLease.ownerActor !== `skill-installation:${install.id}`
|
|
222
|
+
|| command.command !== commandIdentity.command || command.args !== JSON.stringify(commandIdentity.args)
|
|
223
|
+
|| commandRequestDigest(commandIdentity) !== priorLease.requestSha256)
|
|
224
|
+
throw new Error('Retained skill workflow identity differs from the requested publication');
|
|
225
|
+
if (priorLease.state === 'reserved') {
|
|
226
|
+
await retainUnknownResourceCommand(candidateCommandId);
|
|
227
|
+
throw new Error('Skill publication ended before dispatch and committed no effect');
|
|
228
|
+
}
|
|
229
|
+
if (['running', 'unknown', 'released'].includes(priorLease.state)) {
|
|
230
|
+
const recovered = await client.recoverSkillBundle(payload, { leaseId: priorLease.id,
|
|
231
|
+
commandId: candidateCommandId, nodeId: node.id, nodeFqdn: node.hostname,
|
|
232
|
+
requestSha256: priorLease.requestSha256, timeoutSeconds: command.timeoutSeconds, coordination });
|
|
233
|
+
const installed = recovered.response.data;
|
|
234
|
+
if (!recovered.response.success || installed.skillName !== skillName || installed.version !== version
|
|
235
|
+
|| installed.nodeId !== node.id || installed.status !== 'installed'
|
|
236
|
+
|| installed.bundleSha256 !== publication.bundleSha256 || installed.treeSha256 !== publication.treeSha256
|
|
237
|
+
|| installed.commandId !== recovered.evidence.commandId
|
|
238
|
+
|| installed.requestSha256 !== recovered.evidence.commandSha256)
|
|
239
|
+
throw new Error('Recovered skill publication differs from the exact workflow and bundle');
|
|
240
|
+
evidence = recovered.evidence;
|
|
241
|
+
publishedAt = new Date(installed.publishedAt);
|
|
242
|
+
}
|
|
243
|
+
else
|
|
244
|
+
throw new Error('Skill publication owner state is not recoverable');
|
|
245
|
+
}
|
|
246
|
+
else {
|
|
247
|
+
const result = await client.publishSkillBundle(payload, candidateCommandId);
|
|
248
|
+
const installed = result.response.data;
|
|
249
|
+
if (!result.response.success || installed.skillName !== skillName || installed.version !== version
|
|
250
|
+
|| installed.nodeId !== node.id || installed.status !== 'installed'
|
|
251
|
+
|| installed.bundleSha256 !== publication.bundleSha256 || installed.treeSha256 !== publication.treeSha256
|
|
252
|
+
|| installed.commandId !== result.evidence.commandId || installed.requestSha256 !== result.evidence.commandSha256)
|
|
253
|
+
throw new Error('Skill publication result differs from the exact workflow, bundle or signed receipt');
|
|
254
|
+
evidence = result.evidence;
|
|
255
|
+
publishedAt = new Date(installed.publishedAt);
|
|
256
|
+
}
|
|
257
|
+
const successorWhere = prepared.kind === 'successor' ? { id: install.id, status: 'installed',
|
|
258
|
+
version: install.version, registryEntryId: install.registryEntryId, versionHash: install.versionHash,
|
|
259
|
+
bundleSha256: install.bundleSha256,
|
|
260
|
+
treeSha256: install.treeSha256, workflowCommandId: install.workflowCommandId,
|
|
261
|
+
workflowRequestSha256: install.workflowRequestSha256,
|
|
262
|
+
workflowReceiptSha256: install.workflowReceiptSha256, installedAt: install.installedAt, error: install.error }
|
|
263
|
+
: { id: install.id, workflowCommandId: evidence.commandId, status: 'installing',
|
|
264
|
+
version, registryEntryId: registryEntry.id, versionHash: publishedVersion.contentHash,
|
|
265
|
+
bundleSha256: publication.bundleSha256, treeSha256: publication.treeSha256,
|
|
266
|
+
workflowReceiptSha256: null };
|
|
267
|
+
const changed = await db.skillInstallation.updateMany({ where: successorWhere,
|
|
268
|
+
data: { status: 'installed', version, registryEntryId: registryEntry.id,
|
|
269
|
+
versionHash: publishedVersion.contentHash, bundleSha256: publication.bundleSha256,
|
|
270
|
+
treeSha256: publication.treeSha256, workflowCommandId: evidence.commandId,
|
|
271
|
+
installedAt: publishedAt, workflowRequestSha256: evidence.commandSha256,
|
|
272
|
+
workflowReceiptSha256: evidence.receiptSha256, error: null } });
|
|
273
|
+
if (changed.count !== 1) {
|
|
274
|
+
const settled = await db.skillInstallation.findUnique({ where: { id: install.id } });
|
|
275
|
+
if (!settled || !isExactInstalledPublication(settled, identity, evidence))
|
|
276
|
+
throw new Error('Skill publication workflow changed before receipt correlation');
|
|
277
|
+
}
|
|
278
|
+
await logAuditEvent({ action: 'skill.install.receipt', actorId: user.userId,
|
|
279
|
+
targetType: 'skill-installation', targetId: install.id, details: { nodeId, skillName, version,
|
|
280
|
+
bundleSha256: publication.bundleSha256, treeSha256: publication.treeSha256,
|
|
281
|
+
commandId: evidence.commandId, commandSha256: evidence.commandSha256,
|
|
282
|
+
receiptSha256: evidence.receiptSha256 } }).catch(() => {
|
|
283
|
+
console.warn(`[skills] Installed receipt for "${skillName}" was persisted but its audit append failed`);
|
|
284
|
+
});
|
|
285
|
+
return { nodeId, status: 'installed', installationId: install.id };
|
|
286
|
+
}
|
|
287
|
+
catch (error) {
|
|
288
|
+
const lease = await db.commandResourceLease.findUnique({ where: { commandId: candidateCommandId } });
|
|
289
|
+
const uncertain = lease && ['reserved', 'running', 'unknown'].includes(lease.state);
|
|
290
|
+
if (prepared.kind === 'attempt')
|
|
291
|
+
await db.skillInstallation.updateMany({ where: { id: install.id,
|
|
292
|
+
workflowCommandId: candidateCommandId, status: 'installing', version,
|
|
293
|
+
versionHash: publishedVersion.contentHash, bundleSha256: publication.bundleSha256,
|
|
294
|
+
treeSha256: publication.treeSha256, workflowReceiptSha256: null },
|
|
295
|
+
data: { status: uncertain ? 'installing' : 'failed',
|
|
296
|
+
error: uncertain ? 'Publication outcome is unresolved; inspect the exact workflow receipt before retrying'
|
|
297
|
+
: 'Publication failed before a verified installed receipt' } });
|
|
298
|
+
console.warn(`[skills] Failed to publish "${skillName}" on node ${nodeId}`);
|
|
299
|
+
return { nodeId, status: uncertain ? 'installing' : 'failed', installationId: install.id };
|
|
300
|
+
}
|
|
301
|
+
}));
|
|
302
|
+
await logAuditEvent({
|
|
303
|
+
action: 'skill.push',
|
|
304
|
+
actorId: user.userId,
|
|
305
|
+
targetType: 'skill',
|
|
306
|
+
targetId: skillName,
|
|
307
|
+
details: { nodeIds, version, bundleSha256: publication.bundleSha256, treeSha256: publication.treeSha256 },
|
|
308
|
+
});
|
|
309
|
+
return c.json({ success: true, data: { installations } }, 201);
|
|
310
|
+
});
|
|
311
|
+
// ── Get installations for a node ──
|
|
312
|
+
skillsRouter.get('/installations/:nodeId', async (c) => {
|
|
313
|
+
const db = getDb();
|
|
314
|
+
const nodeId = c.req.param('nodeId');
|
|
315
|
+
const installations = await db.skillInstallation.findMany({
|
|
316
|
+
where: { nodeId },
|
|
317
|
+
});
|
|
318
|
+
return c.json({ success: true, data: installations });
|
|
319
|
+
});
|
|
320
|
+
// ── Update skill manifest ──
|
|
321
|
+
skillsRouter.patch('/:name{[a-zA-Z0-9_-]+}', requireRole('ADMIN', 'OPERATOR'), async (c) => {
|
|
322
|
+
const user = getUser(c);
|
|
323
|
+
const name = c.req.param('name');
|
|
324
|
+
const body = await parseBody(c, updateSkillSchema);
|
|
325
|
+
const existing = await skillService.getSkill(name);
|
|
326
|
+
if (!existing)
|
|
327
|
+
throw new HttpError(404, 'NOT_FOUND', 'Skill not found');
|
|
328
|
+
const skill = await skillService.updateSkill(name, {
|
|
329
|
+
version: body.version,
|
|
330
|
+
description: body.description,
|
|
331
|
+
entryPoint: body.entryPoint,
|
|
332
|
+
tags: body.tags,
|
|
333
|
+
dependencies: body.dependencies,
|
|
334
|
+
});
|
|
335
|
+
await logAuditEvent({
|
|
336
|
+
action: 'skill.update',
|
|
337
|
+
actorId: user.userId,
|
|
338
|
+
targetType: 'skill',
|
|
339
|
+
targetId: name,
|
|
340
|
+
details: { name, version: body.version, description: body.description, entryPoint: body.entryPoint },
|
|
341
|
+
});
|
|
342
|
+
return c.json({ success: true, data: skill });
|
|
343
|
+
});
|
|
344
|
+
// ── Delete skill ──
|
|
345
|
+
skillsRouter.delete('/:name{[a-zA-Z0-9_-]+}', requireRole('ADMIN'), async (c) => {
|
|
346
|
+
const db = getDb();
|
|
347
|
+
const user = getUser(c);
|
|
348
|
+
const name = c.req.param('name');
|
|
349
|
+
const existing = await skillService.getSkill(name);
|
|
350
|
+
if (!existing)
|
|
351
|
+
throw new HttpError(404, 'NOT_FOUND', 'Skill not found');
|
|
352
|
+
// Remove DB installations, then delete skill directory
|
|
353
|
+
await db.skillInstallation.deleteMany({ where: { skillName: name } });
|
|
354
|
+
await skillService.deleteSkill(name);
|
|
355
|
+
await logAuditEvent({
|
|
356
|
+
action: 'skill.delete',
|
|
357
|
+
actorId: user.userId,
|
|
358
|
+
targetType: 'skill',
|
|
359
|
+
targetId: name,
|
|
360
|
+
details: { name: existing.name, version: existing.version },
|
|
361
|
+
});
|
|
362
|
+
return c.json({ success: true, data: { deleted: true } });
|
|
363
|
+
});
|
|
364
|
+
// ════════════════════════════════════════════════
|
|
365
|
+
// Registry — versioned skill lifecycle
|
|
366
|
+
// ════════════════════════════════════════════════
|
|
367
|
+
// ── List all registry entries ──
|
|
368
|
+
skillsRouter.get('/registry', async (c) => {
|
|
369
|
+
const data = await registryService.listRegistryEntries();
|
|
370
|
+
return c.json({ success: true, data });
|
|
371
|
+
});
|
|
372
|
+
// ── Sync filesystem skills into registry ──
|
|
373
|
+
skillsRouter.post('/registry/sync', requireRole('ADMIN', 'OPERATOR'), async (c) => {
|
|
374
|
+
const user = getUser(c);
|
|
375
|
+
const result = await registryService.syncFromFilesystem(user.userId);
|
|
376
|
+
await logAuditEvent({
|
|
377
|
+
action: 'skill.registry.sync',
|
|
378
|
+
actorId: user.userId,
|
|
379
|
+
targetType: 'skill_registry',
|
|
380
|
+
targetId: 'all',
|
|
381
|
+
details: { created: result.created.length, updated: result.updated.length, skipped: result.skipped.length },
|
|
382
|
+
});
|
|
383
|
+
return c.json({ success: true, data: result });
|
|
384
|
+
});
|
|
385
|
+
// ── Get single registry entry ──
|
|
386
|
+
skillsRouter.get('/registry/:slug', async (c) => {
|
|
387
|
+
const slug = c.req.param('slug');
|
|
388
|
+
const data = await registryService.getRegistryEntry(slug);
|
|
389
|
+
if (!data)
|
|
390
|
+
throw new HttpError(404, 'NOT_FOUND', 'Skill not found in registry');
|
|
391
|
+
return c.json({ success: true, data });
|
|
392
|
+
});
|
|
393
|
+
// ── Publish a new version ──
|
|
394
|
+
skillsRouter.post('/registry/:slug/publish', requireRole('ADMIN', 'OPERATOR'), async (c) => {
|
|
395
|
+
const user = getUser(c);
|
|
396
|
+
const slug = c.req.param('slug');
|
|
397
|
+
const body = await parseBody(c, publishVersionSchema);
|
|
398
|
+
try {
|
|
399
|
+
const result = await registryService.publishVersion({
|
|
400
|
+
slug,
|
|
401
|
+
version: body.version,
|
|
402
|
+
changelog: body.changelog,
|
|
403
|
+
tagNames: body.tags,
|
|
404
|
+
publishedBy: user.userId,
|
|
405
|
+
});
|
|
406
|
+
await logAuditEvent({
|
|
407
|
+
action: 'skill.registry.publish',
|
|
408
|
+
actorId: user.userId,
|
|
409
|
+
targetType: 'skill_registry',
|
|
410
|
+
targetId: slug,
|
|
411
|
+
details: { version: body.version },
|
|
412
|
+
});
|
|
413
|
+
return c.json({ success: true, data: result }, 201);
|
|
414
|
+
}
|
|
415
|
+
catch (err) {
|
|
416
|
+
if (err instanceof Error && err.message.includes('already exists')) {
|
|
417
|
+
throw new HttpError(409, 'CONFLICT', err.message);
|
|
418
|
+
}
|
|
419
|
+
if (err instanceof Error && err.message.includes('not found')) {
|
|
420
|
+
throw new HttpError(404, 'NOT_FOUND', err.message);
|
|
421
|
+
}
|
|
422
|
+
throw err;
|
|
423
|
+
}
|
|
424
|
+
});
|
|
425
|
+
// ── Get version history for a skill ──
|
|
426
|
+
skillsRouter.get('/registry/:slug/versions', async (c) => {
|
|
427
|
+
const slug = c.req.param('slug');
|
|
428
|
+
const data = await registryService.getVersions(slug);
|
|
429
|
+
return c.json({ success: true, data });
|
|
430
|
+
});
|
|
431
|
+
// ── Get version detail ──
|
|
432
|
+
skillsRouter.get('/registry/:slug/versions/:version', async (c) => {
|
|
433
|
+
const slug = c.req.param('slug');
|
|
434
|
+
const version = c.req.param('version');
|
|
435
|
+
const data = await registryService.getVersionDetail(slug, version);
|
|
436
|
+
if (!data)
|
|
437
|
+
throw new HttpError(404, 'NOT_FOUND', 'Version not found');
|
|
438
|
+
return c.json({ success: true, data });
|
|
439
|
+
});
|
|
440
|
+
// ── Set/move a tag ──
|
|
441
|
+
skillsRouter.post('/registry/:slug/tags', requireRole('ADMIN', 'OPERATOR'), async (c) => {
|
|
442
|
+
const user = getUser(c);
|
|
443
|
+
const slug = c.req.param('slug');
|
|
444
|
+
const body = await parseBody(c, setTagSchema);
|
|
445
|
+
try {
|
|
446
|
+
const data = await registryService.setTag(slug, body.tag, body.versionId);
|
|
447
|
+
await logAuditEvent({
|
|
448
|
+
action: 'skill.registry.tag',
|
|
449
|
+
actorId: user.userId,
|
|
450
|
+
targetType: 'skill_registry',
|
|
451
|
+
targetId: slug,
|
|
452
|
+
details: { tag: body.tag, versionId: body.versionId },
|
|
453
|
+
});
|
|
454
|
+
return c.json({ success: true, data });
|
|
455
|
+
}
|
|
456
|
+
catch (err) {
|
|
457
|
+
if (err instanceof Error && err.message.includes('not found')) {
|
|
458
|
+
throw new HttpError(404, 'NOT_FOUND', err.message);
|
|
459
|
+
}
|
|
460
|
+
throw err;
|
|
461
|
+
}
|
|
462
|
+
});
|
|
463
|
+
// ── Delete registry entry ──
|
|
464
|
+
skillsRouter.delete('/registry/:slug', requireRole('ADMIN'), async (c) => {
|
|
465
|
+
const user = getUser(c);
|
|
466
|
+
const slug = c.req.param('slug');
|
|
467
|
+
try {
|
|
468
|
+
await registryService.deleteRegistryEntry(slug);
|
|
469
|
+
await logAuditEvent({
|
|
470
|
+
action: 'skill.registry.delete',
|
|
471
|
+
actorId: user.userId,
|
|
472
|
+
targetType: 'skill_registry',
|
|
473
|
+
targetId: slug,
|
|
474
|
+
details: {},
|
|
475
|
+
});
|
|
476
|
+
return c.json({ success: true, data: { deleted: true } });
|
|
477
|
+
}
|
|
478
|
+
catch (err) {
|
|
479
|
+
if (err instanceof Error && err.message.includes('not found')) {
|
|
480
|
+
throw new HttpError(404, 'NOT_FOUND', err.message);
|
|
481
|
+
}
|
|
482
|
+
throw err;
|
|
483
|
+
}
|
|
484
|
+
});
|
|
485
|
+
//# sourceMappingURL=skills.js.map
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { Hono } from 'hono';
|
|
2
|
+
import { getDb } from '../db/index.js';
|
|
3
|
+
import { authMiddleware } from '../middleware/auth.js';
|
|
4
|
+
import { queryAuditEvents } from '../services/audit-service.js';
|
|
5
|
+
import { getCodexFleetPosture } from '../services/codex-service.js';
|
|
6
|
+
export const statsRouter = new Hono();
|
|
7
|
+
statsRouter.use('*', authMiddleware);
|
|
8
|
+
/**
|
|
9
|
+
* GET /stats/overview
|
|
10
|
+
* Aggregated fleet statistics for the dashboard overview page.
|
|
11
|
+
*/
|
|
12
|
+
statsRouter.get('/overview', async (c) => {
|
|
13
|
+
const db = getDb();
|
|
14
|
+
const [totalNodes, onlineNodeRecords, offlineNodes, degradedNodes, provisioningNodes, totalCommands, runningCommands, pendingCommands, totalCronJobs, activeCronJobs, recentCommands, auditResult,] = await Promise.all([
|
|
15
|
+
db.node.count(),
|
|
16
|
+
db.node.findMany({ where: { status: 'ONLINE' }, select: { id: true } }),
|
|
17
|
+
db.node.count({ where: { status: 'OFFLINE' } }),
|
|
18
|
+
db.node.count({ where: { status: 'DEGRADED' } }),
|
|
19
|
+
db.node.count({ where: { status: 'PROVISIONING' } }),
|
|
20
|
+
db.remoteCommand.count(),
|
|
21
|
+
db.remoteCommand.count({ where: { status: 'RUNNING' } }),
|
|
22
|
+
db.remoteCommand.count({ where: { status: 'PENDING' } }),
|
|
23
|
+
db.cronJob.count(),
|
|
24
|
+
db.cronJob.count({ where: { status: 'ACTIVE' } }),
|
|
25
|
+
db.remoteCommand.findMany({
|
|
26
|
+
orderBy: { createdAt: 'desc' },
|
|
27
|
+
take: 5,
|
|
28
|
+
select: {
|
|
29
|
+
id: true,
|
|
30
|
+
command: true,
|
|
31
|
+
status: true,
|
|
32
|
+
createdAt: true,
|
|
33
|
+
node: { select: { name: true } },
|
|
34
|
+
},
|
|
35
|
+
}),
|
|
36
|
+
queryAuditEvents({ pageSize: 5 }),
|
|
37
|
+
]);
|
|
38
|
+
const recentAudit = auditResult.events.map((e) => ({
|
|
39
|
+
id: e.id,
|
|
40
|
+
action: e.action,
|
|
41
|
+
timestamp: e.timestamp,
|
|
42
|
+
targetType: e.targetType,
|
|
43
|
+
targetId: e.targetId,
|
|
44
|
+
}));
|
|
45
|
+
const onlineNodes = onlineNodeRecords.length;
|
|
46
|
+
// One statement with an indexed latest-row lookup per online node keeps API
|
|
47
|
+
// query count constant without scanning the full retained snapshot history.
|
|
48
|
+
const latestHealth = await db.$queryRaw `
|
|
49
|
+
SELECT hs."cpuUsagePercent", hs."memoryPercent"
|
|
50
|
+
FROM "nodes" n
|
|
51
|
+
INNER JOIN "health_snapshots" hs ON hs."id" = (
|
|
52
|
+
SELECT latest."id"
|
|
53
|
+
FROM "health_snapshots" latest
|
|
54
|
+
WHERE latest."nodeId" = n."id"
|
|
55
|
+
ORDER BY latest."timestamp" DESC
|
|
56
|
+
LIMIT 1
|
|
57
|
+
)
|
|
58
|
+
WHERE n."status" = 'ONLINE'
|
|
59
|
+
`;
|
|
60
|
+
const avgCpu = latestHealth.length > 0
|
|
61
|
+
? latestHealth.reduce((sum, h) => sum + h.cpuUsagePercent, 0) / latestHealth.length
|
|
62
|
+
: null;
|
|
63
|
+
const avgMemory = latestHealth.length > 0
|
|
64
|
+
? latestHealth.reduce((sum, h) => sum + h.memoryPercent, 0) / latestHealth.length
|
|
65
|
+
: null;
|
|
66
|
+
return c.json({
|
|
67
|
+
success: true,
|
|
68
|
+
data: {
|
|
69
|
+
nodes: {
|
|
70
|
+
total: totalNodes,
|
|
71
|
+
online: onlineNodes,
|
|
72
|
+
offline: offlineNodes,
|
|
73
|
+
degraded: degradedNodes,
|
|
74
|
+
provisioning: provisioningNodes,
|
|
75
|
+
},
|
|
76
|
+
commands: {
|
|
77
|
+
total: totalCommands,
|
|
78
|
+
running: runningCommands,
|
|
79
|
+
pending: pendingCommands,
|
|
80
|
+
},
|
|
81
|
+
cron: {
|
|
82
|
+
total: totalCronJobs,
|
|
83
|
+
active: activeCronJobs,
|
|
84
|
+
},
|
|
85
|
+
health: {
|
|
86
|
+
avgCpuPercent: avgCpu !== null ? Math.round(avgCpu * 10) / 10 : null,
|
|
87
|
+
avgMemoryPercent: avgMemory !== null ? Math.round(avgMemory * 10) / 10 : null,
|
|
88
|
+
reportingNodes: latestHealth.length,
|
|
89
|
+
},
|
|
90
|
+
codex: getCodexFleetPosture(),
|
|
91
|
+
recentCommands,
|
|
92
|
+
recentAudit,
|
|
93
|
+
},
|
|
94
|
+
});
|
|
95
|
+
});
|
|
96
|
+
//# sourceMappingURL=stats.js.map
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { Hono } from 'hono';
|
|
2
|
+
import { authMiddleware, getUser } from '../middleware/auth.js';
|
|
3
|
+
import { HttpError } from '../middleware/error-handler.js';
|
|
4
|
+
import { parseBody } from '../utils/validate.js';
|
|
5
|
+
import { MAGNUS_APPROVAL_BRIDGE_CONSUMER, MAGNUS_PLUGIN_API_ENABLED } from '../utils/env.js';
|
|
6
|
+
import { approvalAssertionSchema } from '../security/approval-assertion.js';
|
|
7
|
+
import { getTeamApprovalPlan, listTeamApprovalPlans, recordTeamApproval } from '../services/team-approvals.js';
|
|
8
|
+
export const teamApprovalRouter = new Hono();
|
|
9
|
+
teamApprovalRouter.use('*', authMiddleware);
|
|
10
|
+
teamApprovalRouter.use('*', async (c, next) => {
|
|
11
|
+
// Only the configured approval-bridge plugin consumer may list plans or relay decisions.
|
|
12
|
+
const consumer = MAGNUS_APPROVAL_BRIDGE_CONSUMER;
|
|
13
|
+
if (!MAGNUS_PLUGIN_API_ENABLED || !consumer || getUser(c).userId !== `service:magnus-plugin-read:${consumer}`)
|
|
14
|
+
throw new HttpError(403, 'FORBIDDEN', 'This endpoint is restricted to the configured approval decision bridge');
|
|
15
|
+
await next();
|
|
16
|
+
});
|
|
17
|
+
teamApprovalRouter.get('/plans', async (c) => c.json({ success: true, data: await listTeamApprovalPlans() }));
|
|
18
|
+
teamApprovalRouter.get('/plans/:id', async (c) => c.json({ success: true, data: await getTeamApprovalPlan(c.req.param('id')) }));
|
|
19
|
+
teamApprovalRouter.post('/decisions', async (c) => {
|
|
20
|
+
const body = await parseBody(c, approvalAssertionSchema);
|
|
21
|
+
return c.json({ success: true, data: await recordTeamApproval(body) });
|
|
22
|
+
});
|
|
23
|
+
//# sourceMappingURL=team-approvals.js.map
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { Hono } from 'hono';
|
|
2
|
+
import { authMiddleware, requireRole } from '../middleware/auth.js';
|
|
3
|
+
export const terminalTicketRouter = new Hono();
|
|
4
|
+
terminalTicketRouter.use('*', authMiddleware);
|
|
5
|
+
terminalTicketRouter.use('*', requireRole('ADMIN', 'OPERATOR'));
|
|
6
|
+
/** The password-backed Control API terminal is retired; use the dashboard's
|
|
7
|
+
* dedicated restricted key and inventory-pinned terminal transport. */
|
|
8
|
+
terminalTicketRouter.post('/ticket', (c) => c.json({
|
|
9
|
+
success: false,
|
|
10
|
+
error: {
|
|
11
|
+
code: 'TERMINAL_RETIRED',
|
|
12
|
+
message: 'Control API terminal tickets are retired; use the dashboard terminal.',
|
|
13
|
+
},
|
|
14
|
+
}, 410));
|
|
15
|
+
//# sourceMappingURL=terminal-ticket.js.map
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { WebSocketServer } from 'ws';
|
|
2
|
+
/**
|
|
3
|
+
* The former Control API terminal used retired reusable SSH passwords. Keep a
|
|
4
|
+
* deterministic upgrade rejection so old clients fail closed while the
|
|
5
|
+
* dashboard's separately scoped, host-key-pinned terminal remains available.
|
|
6
|
+
*/
|
|
7
|
+
export function setupTerminalWebSocket(server) {
|
|
8
|
+
const wss = new WebSocketServer({ noServer: true });
|
|
9
|
+
server.on('upgrade', (request, socket) => {
|
|
10
|
+
const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);
|
|
11
|
+
if (!url.pathname.startsWith('/api/v1/terminal'))
|
|
12
|
+
return;
|
|
13
|
+
socket.end('HTTP/1.1 410 Gone\r\nConnection: close\r\nContent-Type: text/plain\r\nContent-Length: 33\r\n\r\nControl API terminal is retired.\n');
|
|
14
|
+
});
|
|
15
|
+
return wss;
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=terminal.js.map
|