@sleep2agi/commhub-server 0.9.0-preview.21 → 0.9.0-preview.211
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/README.md +130 -10
- package/bin/commhub.ts +99 -11
- package/package.json +7 -7
- package/src/ack-create-request-transport.test.ts +182 -0
- package/src/ack-create-request.test.ts +50 -7
- package/src/admin-delete-network-http.test.ts +228 -0
- package/src/admin-networks-http.test.ts +88 -0
- package/src/adoption-candidates-http.test.ts +137 -0
- package/src/adoption-candidates.ts +158 -0
- package/src/agent-access-batch.test.ts +210 -0
- package/src/agent-access.ts +487 -0
- package/src/agent-acl-groups-http.test.ts +247 -0
- package/src/agent-acl-http.test.ts +659 -0
- package/src/agent-acl-slice3-http.test.ts +267 -0
- package/src/agent-department-http.test.ts +215 -0
- package/src/agent-groups-perf.test.ts +223 -0
- package/src/agent-notice.ts +48 -0
- package/src/agent-team-whoami-http.test.ts +98 -0
- package/src/agent-teams-http.test.ts +330 -0
- package/src/agent-teams.ts +244 -0
- package/src/alias-baseline-2571.test.ts +162 -0
- package/src/alias-baseline.ts +113 -0
- package/src/alias-filter.test.ts +72 -0
- package/src/alias-filter.ts +42 -0
- package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
- package/src/api-host-supervisors-fallback.test.ts +21 -12
- package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
- package/src/api-nodes-shape.test.ts +120 -13
- package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
- package/src/auth-sessions-http.test.ts +250 -0
- package/src/auth-validate.test.ts +5 -1
- package/src/auth-weak-password-login.test.ts +176 -0
- package/src/auth.ts +609 -51
- package/src/avatar-validate.test.ts +163 -0
- package/src/avatar-validate.ts +103 -0
- package/src/backfill-node-ids-2664.test.ts +128 -0
- package/src/binding-generation-http.test.ts +121 -0
- package/src/blocked-exit-on-reply.test.ts +122 -0
- package/src/boot-side-effect.test.ts +124 -0
- package/src/broadcast-fanout-2721.test.ts +118 -0
- package/src/broadcast-fanout.ts +98 -0
- package/src/chain-attempt-dedup.test.ts +447 -0
- package/src/clone-node.test.ts +248 -0
- package/src/clone-node.ts +289 -0
- package/src/codex-config-flags.ts +77 -0
- package/src/codex-fork-contract.ts +23 -0
- package/src/codex-fork-migration.test.ts +38 -0
- package/src/commhub-bin-args.test.ts +85 -0
- package/src/config-apply-validate.test.ts +42 -1
- package/src/config-apply-validate.ts +30 -2
- package/src/create-node-blocked-gate.test.ts +356 -0
- package/src/create-node-network-id.test.ts +79 -0
- package/src/create-node-tool-schema.test.ts +49 -0
- package/src/create-node-unicode-name.test.ts +120 -0
- package/src/create-node-validate.test.ts +199 -7
- package/src/create-node-validate.ts +232 -15
- package/src/create-node-workdir.test.ts +289 -0
- package/src/create-node.ts +88 -23
- package/src/daemon-provider-snapshots.test.ts +421 -0
- package/src/daemon-provider-snapshots.ts +327 -0
- package/src/daemon-token-owner-http.test.ts +236 -0
- package/src/dashboard-slash-routing-http.test.ts +109 -0
- package/src/db-adapter-guard.test.ts +148 -0
- package/src/db-adapter-translate.test.ts +128 -0
- package/src/db-adapter.ts +377 -91
- package/src/db-timestamp.test.ts +38 -0
- package/src/db-timestamp.ts +15 -0
- package/src/db.ts +1306 -153
- package/src/delivered-without-push.test.ts +140 -0
- package/src/department-groups-http.test.ts +209 -0
- package/src/department-groups-sync-http.test.ts +328 -0
- package/src/department-groups.ts +434 -0
- package/src/department-heads-http.test.ts +330 -0
- package/src/department-heads.ts +226 -0
- package/src/departments-agent-count.test.ts +129 -0
- package/src/departments-http.test.ts +185 -0
- package/src/departments-mcp.test.ts +128 -0
- package/src/departments.ts +318 -0
- package/src/desktop-message-seam.test.ts +150 -0
- package/src/desktop-message.test.ts +368 -0
- package/src/dm-file-scope-http.test.ts +178 -0
- package/src/empty-node-sweeper.test.ts +104 -0
- package/src/empty-node-sweeper.ts +88 -0
- package/src/env-transport-gate-http.test.ts +240 -0
- package/src/env-transport-gate.ts +80 -0
- package/src/env-transport-policy.ts +56 -0
- package/src/event-loop-lag.test.ts +180 -0
- package/src/event-loop-lag.ts +181 -0
- package/src/ext-token-shared.test.ts +60 -0
- package/src/ext-validation-regression.test.ts +131 -0
- package/src/external-schedule-edits-http.test.ts +321 -0
- package/src/external-schedule-edits-timestamps.test.ts +64 -0
- package/src/external-schedule-edits.ts +327 -0
- package/src/file-download-authz-dev-open.test.ts +135 -0
- package/src/file-download-authz.test.ts +404 -0
- package/src/file-download-date-bucket.test.ts +436 -0
- package/src/file-network-scope-dev-open.test.ts +97 -0
- package/src/file-network-scope.test.ts +732 -0
- package/src/group-membership-events-http.test.ts +264 -0
- package/src/group-messages-http.test.ts +482 -0
- package/src/group-messages.ts +297 -0
- package/src/health-host-disk-2756.test.ts +49 -0
- package/src/health-redaction.test.ts +685 -0
- package/src/host-supervisor-identity-http.test.ts +152 -0
- package/src/host-supervisor-identity.ts +92 -0
- package/src/host-supervisors-daemon-version.test.ts +137 -0
- package/src/http-gzip.test.ts +94 -0
- package/src/http-gzip.ts +112 -0
- package/src/hub-catalog-read-http.test.ts +187 -0
- package/src/hub-provider-config.test.ts +139 -0
- package/src/hub-provider-config.ts +105 -0
- package/src/hub-timestamp.test.ts +38 -0
- package/src/hub-timestamp.ts +27 -0
- package/src/human-dm.ts +215 -0
- package/src/human-inbox.ts +42 -0
- package/src/inbox-caller.ts +49 -0
- package/src/inbox-count-sse.test.ts +310 -0
- package/src/inbox-count.ts +29 -0
- package/src/index.ts +15 -2385
- package/src/list-host-supervisors.test.ts +5 -4
- package/src/mcp-context-cost-http.test.ts +127 -0
- package/src/mcp-inflight.test.ts +92 -0
- package/src/mcp-inflight.ts +38 -0
- package/src/mcp-projects-events-http.test.ts +162 -0
- package/src/mcp-route-label-http.test.ts +120 -0
- package/src/mcp-write-network-resolution.test.ts +432 -0
- package/src/member-audit-network-id-http.test.ts +93 -0
- package/src/member-presence-http.test.ts +210 -0
- package/src/messages-ack-by-agent-http.test.ts +142 -0
- package/src/migrate-sqlite-to-pg.test.ts +47 -0
- package/src/migrate-sqlite-to-pg.ts +263 -0
- package/src/model-auth-notify-http.test.ts +181 -0
- package/src/model-auth-notify.ts +116 -0
- package/src/network-name-http.test.ts +75 -0
- package/src/network-rules-http.test.ts +169 -0
- package/src/network-rules.ts +129 -0
- package/src/network-scope.ts +276 -0
- package/src/network-token-membership-http.test.ts +139 -0
- package/src/node-alias-control.ts +12 -0
- package/src/node-attrs-validate.ts +88 -0
- package/src/node-attrs.test.ts +258 -0
- package/src/node-caller-identity-http.test.ts +1083 -0
- package/src/node-create-request-status-http.test.ts +105 -0
- package/src/node-daemon-bindings.test.ts +132 -0
- package/src/node-daemon-bindings.ts +135 -0
- package/src/node-failure-alert.test.ts +150 -0
- package/src/node-failure-alert.ts +177 -0
- package/src/node-files-transport.test.ts +344 -0
- package/src/node-health-codex-login.test.ts +120 -0
- package/src/node-health-dispatch-http.test.ts +279 -0
- package/src/node-health-guard.ts +105 -0
- package/src/node-health-passthrough.test.ts +115 -0
- package/src/node-health-store.ts +101 -0
- package/src/node-id-alias.test.ts +190 -0
- package/src/node-identity-conflict-http.test.ts +269 -0
- package/src/node-identity-conflict.ts +142 -0
- package/src/node-identity-mismatch.test.ts +74 -0
- package/src/node-in-flight-tasks.ts +31 -0
- package/src/node-lifecycle-controllable.test.ts +64 -0
- package/src/node-lifecycle-controllable.ts +53 -0
- package/src/node-lifecycle-read-http.test.ts +250 -0
- package/src/node-lifecycle-read.ts +124 -0
- package/src/node-logs-transport.test.ts +263 -0
- package/src/node-peer-allowlist.test.ts +114 -0
- package/src/node-permissions-http.test.ts +648 -0
- package/src/node-permissions.ts +494 -0
- package/src/node-request-retention.test.ts +281 -0
- package/src/node-request-retention.ts +120 -0
- package/src/node-secret-rest-http.test.ts +190 -0
- package/src/node-serviceability.test.ts +86 -0
- package/src/node-serviceability.ts +124 -0
- package/src/node-session-control-http.test.ts +310 -0
- package/src/node-session-control.ts +258 -0
- package/src/node-skills-transport.test.ts +209 -0
- package/src/node-token-identity.ts +35 -0
- package/src/node-token-ownership.ts +51 -0
- package/src/node-token-privilege-http.test.ts +158 -0
- package/src/not-found-api-http.test.ts +67 -0
- package/src/observer-avatar-http.test.ts +442 -0
- package/src/observer-push.test.ts +252 -0
- package/src/opencode-catalog-report-http.test.ts +139 -0
- package/src/opencode-v2-catalog.test.ts +268 -0
- package/src/opencode-v2-catalog.ts +352 -0
- package/src/package-version-consistency.test.ts +25 -0
- package/src/parent-source-marker.test.ts +50 -0
- package/src/password-network-tokens.ts +25 -0
- package/src/peer-reply-atomic.test.ts +455 -0
- package/src/peer-reply-capability.test.ts +70 -0
- package/src/pg-worker.ts +87 -0
- package/src/project-dir-warn-clear-http.test.ts +132 -0
- package/src/project-viewer-can-http.test.ts +116 -0
- package/src/push.test.ts +20 -10
- package/src/push.ts +466 -13
- package/src/redact-tokens.test.ts +65 -0
- package/src/redact-tokens.ts +40 -0
- package/src/rename.ts +38 -10
- package/src/reply-target-derivation.test.ts +96 -0
- package/src/report-status-handover-capabilities-http.test.ts +124 -0
- package/src/report-status-host-schema.test.ts +235 -0
- package/src/report-status-resume-id-handover.test.ts +184 -0
- package/src/report-status-secret-keys.test.ts +140 -0
- package/src/require-explicit-test-db.ts +9 -0
- package/src/requirement-due-reminders-http.test.ts +620 -0
- package/src/requirement-due-reminders.ts +416 -0
- package/src/requirement-events-http.test.ts +268 -0
- package/src/requirement-events.test.ts +45 -0
- package/src/requirement-events.ts +144 -0
- package/src/requirement-notify.ts +165 -0
- package/src/requirement-participant-notify-http.test.ts +309 -0
- package/src/requirement-tag-ops-http.test.ts +425 -0
- package/src/requirement-tag-tree-http.test.ts +275 -0
- package/src/requirement-tag-tree.ts +127 -0
- package/src/requirement-tags.ts +102 -0
- package/src/requirements-abandoned-http.test.ts +236 -0
- package/src/requirements-comment-http.test.ts +167 -0
- package/src/requirements-completed-at-migration.test.ts +70 -0
- package/src/requirements-errors-mcp-http.test.ts +164 -0
- package/src/requirements-errors.ts +158 -0
- package/src/requirements-etag-http.test.ts +91 -0
- package/src/requirements-http.test.ts +709 -0
- package/src/requirements-last-event-http.test.ts +349 -0
- package/src/requirements-list-mcp-slim-http.test.ts +155 -0
- package/src/requirements-list-slim-http.test.ts +324 -0
- package/src/requirements-mcp.test.ts +163 -0
- package/src/requirements-migrate.ts +283 -0
- package/src/requirements-owner-strict-mcp-http.test.ts +145 -0
- package/src/requirements-people-http.test.ts +114 -0
- package/src/requirements-people-mcp-http.test.ts +231 -0
- package/src/requirements-people.ts +196 -0
- package/src/requirements-priority-lowest.test.ts +114 -0
- package/src/requirements-projects-parent-http.test.ts +123 -0
- package/src/requirements-search-http.test.ts +182 -0
- package/src/requirements-search.test.ts +32 -0
- package/src/requirements-search.ts +145 -0
- package/src/requirements-seq-http.test.ts +193 -0
- package/src/requirements-seq-migration.test.ts +63 -0
- package/src/requirements-start-date.test.ts +125 -0
- package/src/requirements-stats-http.test.ts +357 -0
- package/src/requirements-stats.ts +195 -0
- package/src/requirements-status-participants-http.test.ts +222 -0
- package/src/requirements-upgrade-e2e.test.ts +126 -0
- package/src/requirements-upgrade-migration.test.ts +98 -0
- package/src/requirements.ts +2027 -0
- package/src/resolve-port.test.ts +57 -0
- package/src/resolve-port.ts +44 -0
- package/src/response-charset.test.ts +130 -0
- package/src/rest-alias-network-fallback-http.test.ts +123 -0
- package/src/rest-alias-network-fallback.test.ts +60 -0
- package/src/rest-alias-network-fallback.ts +65 -0
- package/src/rest-explicit-columns-http.test.ts +266 -0
- package/src/rest-identity.test.ts +130 -0
- package/src/rest-identity.ts +141 -0
- package/src/rest-projections.ts +72 -0
- package/src/rest-read-network-real-chain.test.ts +97 -0
- package/src/rest-write-network-resolution.test.ts +133 -0
- package/src/restart-readiness-http.test.ts +121 -0
- package/src/restricted-files.ts +76 -0
- package/src/retention-first-sweep-quiet.test.ts +31 -0
- package/src/retention.test.ts +100 -40
- package/src/retention.ts +423 -104
- package/src/route-callers-http.test.ts +120 -0
- package/src/route-timing.test.ts +218 -0
- package/src/route-timing.ts +262 -0
- package/src/rules-file-duplicate-alias.test.ts +234 -0
- package/src/rules-file-session-target.test.ts +207 -0
- package/src/rules-file-transport.test.ts +237 -0
- package/src/runtime-label.test.ts +22 -0
- package/src/runtime-label.ts +21 -0
- package/src/runtime-readiness.ts +90 -0
- package/src/schedule-agent-mcp-http.test.ts +432 -0
- package/src/schedule-agent.ts +252 -0
- package/src/schedule-starved.test.ts +92 -0
- package/src/schedule-starved.ts +114 -0
- package/src/scheduled-backoff-http.test.ts +193 -0
- package/src/scheduled-backoff.ts +64 -0
- package/src/scheduled-doorbell-nodeless-session.test.ts +134 -0
- package/src/scheduled-failure-backoff-2622.test.ts +145 -0
- package/src/scheduled-failure-code.test.ts +73 -0
- package/src/scheduled-failure-code.ts +105 -0
- package/src/scheduled-failures-http.test.ts +279 -0
- package/src/scheduled-failures.ts +425 -0
- package/src/scheduled-noprogress-backoff-2622.test.ts +163 -0
- package/src/scheduled-offline-backoff-probe.test.ts +56 -0
- package/src/scheduled-offline.test.ts +131 -0
- package/src/scheduled-offline.ts +66 -0
- package/src/scheduled-outcome-guidance-http.test.ts +139 -0
- package/src/scheduled-outcome-guidance.ts +9 -0
- package/src/scheduled-reply-unread-http.test.ts +212 -0
- package/src/scheduled-requirement-wake-http.test.ts +279 -0
- package/src/scheduled-requirement-wake.ts +125 -0
- package/src/scheduled-run-terminal.test.ts +268 -0
- package/src/scheduled-skip-blocking-task.test.ts +120 -0
- package/src/scheduled-skip-path-backoff-2622.test.ts +98 -0
- package/src/scheduled-stuck-http.test.ts +312 -0
- package/src/scheduled-stuck-notice-cap.test.ts +80 -0
- package/src/scheduled-stuck.ts +219 -0
- package/src/scheduled-tasks-http.test.ts +679 -0
- package/src/scheduled-tasks.ts +959 -0
- package/src/scheduled-work-outcome-http.test.ts +154 -0
- package/src/scheduled-work-outcome.ts +50 -0
- package/src/scoped-secrets.ts +141 -0
- package/src/send-dedup-request-id.test.ts +229 -0
- package/src/send-reply-agent-warning.test.ts +202 -0
- package/src/send-reply-alias-optional.test.ts +131 -0
- package/src/send-reply-attachments.test.ts +458 -0
- package/src/send_dedup.test.ts +54 -0
- package/src/send_dedup.ts +52 -6
- package/src/serve-error.test.ts +38 -0
- package/src/serve-error.ts +27 -0
- package/src/server.ts +6220 -0
- package/src/session-task-on-dispatch.ts +14 -0
- package/src/session-token-ownership-http.test.ts +122 -0
- package/src/shared/codex-inventory.ts +41 -0
- package/src/shared/daemon-provider-login.ts +31 -0
- package/src/shared/daemon-provider-snapshot.ts +52 -0
- package/src/shared/external-schedule-contract.ts +60 -0
- package/src/shared/node-name.test.ts +62 -0
- package/src/shared/node-name.ts +161 -0
- package/src/shared/provider-application.ts +29 -0
- package/src/shared/provider-collection.ts +14 -0
- package/src/shared/provider-initialization.ts +8 -0
- package/src/shared/reserved-env-drift.test.ts +10 -0
- package/src/shared/scoped-secret-contract.ts +5 -0
- package/src/shared/task-content-limit-drift.test.ts +28 -0
- package/src/shared/task-content-limit.ts +25 -0
- package/src/side-thread-command-transport.test.ts +312 -0
- package/src/side-thread-command-transport.ts +318 -0
- package/src/side-thread-http-integration.test.ts +233 -0
- package/src/side-thread-http.ts +504 -0
- package/src/side-thread-production.test.ts +72 -0
- package/src/side-thread-production.ts +118 -0
- package/src/side-thread.test.ts +1067 -0
- package/src/side-thread.ts +2499 -0
- package/src/skillhub-http.test.ts +108 -0
- package/src/sqlite-close-checkpoint.test.ts +78 -0
- package/src/start-node.test.ts +264 -0
- package/src/status-alias-filter-http.test.ts +106 -0
- package/src/status-alias-resolver-http.test.ts +163 -0
- package/src/status-alias-resolver.ts +19 -0
- package/src/status-node-id-filter-http.test.ts +161 -0
- package/src/status-read-cache-http.test.ts +229 -0
- package/src/status-read-cache.ts +122 -0
- package/src/stop-delete-node.test.ts +567 -1
- package/src/task-access-http.test.ts +402 -0
- package/src/task-access.ts +420 -0
- package/src/task-activity.ts +60 -0
- package/src/task-auth-origin-http.test.ts +93 -0
- package/src/task-auth-origin.test.ts +24 -0
- package/src/task-auth-origin.ts +7 -0
- package/src/task-consumption.test.ts +490 -0
- package/src/task-diagnostic-http.test.ts +149 -0
- package/src/task-diagnostic.test.ts +115 -0
- package/src/task-diagnostic.ts +118 -0
- package/src/task-expiry-notice-http.test.ts +287 -0
- package/src/task-expiry-notice.ts +315 -0
- package/src/task-idempotency-mcp.test.ts +142 -0
- package/src/task-idempotency.test.ts +76 -0
- package/src/task-idempotency.ts +81 -0
- package/src/task-late-replies.ts +54 -0
- package/src/task-late-reply-http.test.ts +152 -0
- package/src/task-lifecycle-watcher-busy.test.ts +114 -0
- package/src/task-lifecycle-watcher.test.ts +204 -0
- package/src/task-lifecycle-watcher.ts +109 -0
- package/src/task-network-resolution-http.test.ts +140 -0
- package/src/task-offline-delivery-2668.test.ts +119 -0
- package/src/task-offline-delivery.ts +81 -0
- package/src/task-orphan-http.test.ts +287 -0
- package/src/task-orphan.ts +119 -0
- package/src/task-queue-ahead-http.test.ts +309 -0
- package/src/task-queue-ahead-scale.test.ts +236 -0
- package/src/task-queue-ahead.ts +186 -0
- package/src/task-rejection-log-http.test.ts +160 -0
- package/src/task-rejection-log.ts +49 -0
- package/src/task-sender-http.test.ts +143 -0
- package/src/task-stale-open-http.test.ts +290 -0
- package/src/task-stale-open.ts +103 -0
- package/src/tasks-pagination-http.test.ts +141 -0
- package/src/team-rules-status-http.test.ts +90 -0
- package/src/team-rules-status.test.ts +59 -0
- package/src/team-rules-status.ts +72 -0
- package/src/tool-audience-http.test.ts +230 -0
- package/src/tool-audience.ts +120 -0
- package/src/tools-list-json-schema.test.ts +94 -0
- package/src/tools.ts +4130 -391
- package/src/upload-early-reject-guard.test.ts +155 -0
- package/src/uploads-http.test.ts +97 -15
- package/src/uploads.ts +103 -6
- package/src/user-avatar-http.test.ts +74 -0
- package/src/user-avatar-image.ts +160 -0
- package/src/user-avatar-migration.test.ts +25 -0
- package/src/user-avatar-upload-http.test.ts +348 -0
- package/src/user-inbox-by-agent-http.test.ts +161 -0
- package/src/user-inbox-netid-notnull.test.ts +122 -0
- package/src/user-inbox-read-http.test.ts +223 -0
- package/src/user-inbox-schema.test.ts +54 -0
- package/src/version-stats.test.ts +66 -0
- package/src/version-stats.ts +109 -0
|
@@ -0,0 +1,648 @@
|
|
|
1
|
+
// RFC-041 第一阶段(#487)—— 节点自己的权限:先记录、后执行。全部经真实 HTTP 入口(bootServer + fetch REST / /mcp / SSE)。
|
|
2
|
+
//
|
|
3
|
+
// 钉住:
|
|
4
|
+
// 1. log(默认):正常模式的节点「本来会被拒」的写照常放行,只按 (节点, 路由, 原因, 小时) 合并记一行。
|
|
5
|
+
// 2. 显式模式不看开关、立刻生效:只读写什么都拒、回复 / 心跳照常;受限只看只改派给它的卡,广播 / 订阅别人的推送都拒。
|
|
6
|
+
// 3. enforce:同一组请求按规则拒(node_permission_denied + reason + hint),含只有人能做的事(human_only)。
|
|
7
|
+
// 4. off:不判也不记(显式模式仍生效)。
|
|
8
|
+
// 5. 改模式:节点主人 / 网络 owner、admin 能;别的成员 403、节点令牌 403、不在网络里 404。
|
|
9
|
+
// 6. 报表:owner/admin 看到过去 7 天每个节点「本来会拦」的计数;成员 / 节点令牌 403。
|
|
10
|
+
// 7. 每个注册的 MCP 工具都归了类(新工具忘了归类会红)。8. 记录有上限、会清理。
|
|
11
|
+
//
|
|
12
|
+
// 跑法:cd server && COMMHUB_DB=/tmp/x.db bun test src/node-permissions-http.test.ts
|
|
13
|
+
// PG:COMMHUB_TEST_PG_URL=… COMMHUB_PG_EXPERIMENTAL=1(tests/test2123-hub-postgres-ladder 里注册)
|
|
14
|
+
import { afterAll, afterEach, beforeAll, describe, expect, test } from "bun:test";
|
|
15
|
+
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
|
|
16
|
+
import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
|
|
17
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
18
|
+
import { addNetworkMember, createNetworkTokenForNode, register } from "./auth.js";
|
|
19
|
+
import { replaceTaskGrants } from "./task-access.js";
|
|
20
|
+
import { db } from "./db.js";
|
|
21
|
+
import { NODE_TOOL_CLASS, pruneNodePermissionLog, __resetNodePermissionLogStateForTest } from "./node-permissions.js";
|
|
22
|
+
import { registerTools } from "./tools.js";
|
|
23
|
+
|
|
24
|
+
const activeDbPath = process.env.COMMHUB_DB ?? (process.env.COMMHUB_TEST_PG_URL ? "postgres" : undefined);
|
|
25
|
+
if (!activeDbPath) throw new Error("node-permissions requires COMMHUB_DB (or COMMHUB_TEST_PG_URL) before module import");
|
|
26
|
+
|
|
27
|
+
const stamp = Date.now();
|
|
28
|
+
const PW = "NodePerm123!";
|
|
29
|
+
let server: any, base = "", net = "";
|
|
30
|
+
const user: Record<string, { id: string; token: string }> = {};
|
|
31
|
+
const node: Record<string, { id: string; alias: string; token: string; tokenId: string }> = {};
|
|
32
|
+
const card: Record<string, string> = {};
|
|
33
|
+
|
|
34
|
+
async function call(token: string, method: string, path: string, body?: unknown) {
|
|
35
|
+
const r = await fetch(`${base}${path}`, {
|
|
36
|
+
method, headers: { Authorization: `Bearer ${token}`, ...(body === undefined ? {} : { "Content-Type": "application/json" }) },
|
|
37
|
+
body: body === undefined ? undefined : JSON.stringify(body),
|
|
38
|
+
});
|
|
39
|
+
const text = await r.text();
|
|
40
|
+
let json: any = null; try { json = JSON.parse(text); } catch {}
|
|
41
|
+
return { status: r.status, body: json, text };
|
|
42
|
+
}
|
|
43
|
+
async function mcp(token: string, name: string, args: Record<string, unknown>): Promise<any> {
|
|
44
|
+
const r = await fetch(`${base}/mcp`, {
|
|
45
|
+
method: "POST",
|
|
46
|
+
headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream" },
|
|
47
|
+
body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
|
|
48
|
+
});
|
|
49
|
+
const text = await r.text();
|
|
50
|
+
const data = text.split("\n").find((l) => l.startsWith("data: "));
|
|
51
|
+
const msg = JSON.parse(data ? data.slice(6) : text);
|
|
52
|
+
const inner = msg.result?.content?.[0]?.text;
|
|
53
|
+
try { return JSON.parse(inner); } catch { return { raw: inner ?? msg }; }
|
|
54
|
+
}
|
|
55
|
+
const sse = async (token: string, path: string) => {
|
|
56
|
+
const ac = new AbortController();
|
|
57
|
+
const r = await fetch(`${base}${path}`, { headers: { Authorization: `Bearer ${token}` }, signal: ac.signal });
|
|
58
|
+
const status = r.status;
|
|
59
|
+
const body = status === 200 ? null : await r.json().catch(() => null);
|
|
60
|
+
ac.abort();
|
|
61
|
+
return { status, body };
|
|
62
|
+
};
|
|
63
|
+
const logRows = (nodeId: string) => db.all<{ route: string; reason: string; hits: number | string }>(
|
|
64
|
+
"SELECT route, reason, hits FROM node_permission_log WHERE network_id = ?1 AND node_id = ?2 ORDER BY route, reason", net, nodeId);
|
|
65
|
+
const hitsOf = (nodeId: string, route: string, reason: string) =>
|
|
66
|
+
Number(logRows(nodeId).find((r) => r.route === route && r.reason === reason)?.hits ?? 0);
|
|
67
|
+
const attrsRev = (nodeId: string) => Number(db.get<{ r: number | string | null }>("SELECT attrs_revision AS r FROM nodes WHERE node_id = ?1", nodeId)?.r ?? 0);
|
|
68
|
+
const setMode = (nodeKey: string, mode: string) => db.run("UPDATE nodes SET permission_mode = ?1 WHERE node_id = ?2", [mode, node[nodeKey].id]);
|
|
69
|
+
const newCard = async (name: string, extra: Record<string, unknown> = {}) => {
|
|
70
|
+
const r = await call(user.boss.token, "POST", "/api/requirements", { name, network_id: net, ...extra });
|
|
71
|
+
expect(r.status).toBe(201);
|
|
72
|
+
return r.body.requirement.id as string;
|
|
73
|
+
};
|
|
74
|
+
|
|
75
|
+
beforeAll(async () => {
|
|
76
|
+
const boss = register(`np_boss_${stamp}`, PW); net = boss.network_id!; user.boss = { id: boss.user!.user_id, token: boss.token! };
|
|
77
|
+
for (const k of ["sco", "mem", "out"]) {
|
|
78
|
+
const u = register(`np_${k}_${stamp}`, PW); user[k] = { id: u.user!.user_id, token: u.token! };
|
|
79
|
+
if (k !== "out") expect(addNetworkMember(net, user[k].id, "member", user.boss.id, { agentAccess: "all" }).ok).toBe(true);
|
|
80
|
+
}
|
|
81
|
+
// sco:只看相关任务的成员(task_access=scoped)—— 他的节点在正常模式下会碰到「主人看不见」的卡。
|
|
82
|
+
expect(replaceTaskGrants({ networkId: net, userId: user.sco.id, taskAccess: "scoped", actorUserId: user.boss.id }).ok).toBe(true);
|
|
83
|
+
for (const [key, owner] of [["nN", "boss"], ["nR", "boss"], ["nRO", "boss"], ["nS", "sco"], ["other", "boss"]] as const) {
|
|
84
|
+
const alias = `${key.toLowerCase()}-${stamp}`, id = `n_np_${key.toLowerCase()}_${stamp}`;
|
|
85
|
+
const t = createNetworkTokenForNode(user[owner].id, net, alias, id);
|
|
86
|
+
expect(t.ok).toBe(true);
|
|
87
|
+
node[key] = { id, alias, token: t.token!, tokenId: t.token_id! };
|
|
88
|
+
db.run("INSERT INTO sessions (resume_id, alias, status, node_id, network_id) VALUES (?1, ?2, 'idle', ?3, ?4)", [`r_${id}`, alias, id, net]);
|
|
89
|
+
}
|
|
90
|
+
const mod: any = await import("./server.js");
|
|
91
|
+
server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
|
|
92
|
+
base = `http://127.0.0.1:${server.port}`;
|
|
93
|
+
card.assigned = await newCard("assigned to nR", { agent_owner: { kind: "node", id: node.nR.id } });
|
|
94
|
+
card.child = await newCard("child of assigned", { parent_id: card.assigned });
|
|
95
|
+
card.boss = await newCard("boss only");
|
|
96
|
+
card.scoPart = await newCard("sco participates", { participants: [{ kind: "user", id: user.sco.id }] });
|
|
97
|
+
setMode("nR", "restricted");
|
|
98
|
+
setMode("nRO", "readonly");
|
|
99
|
+
}, 60_000);
|
|
100
|
+
afterEach(() => { delete process.env.COMMHUB_NODE_PERMISSIONS; });
|
|
101
|
+
afterAll(() => { server?.stop?.(true); });
|
|
102
|
+
|
|
103
|
+
describe("log (default): never blocks a normal node, records would-be denials", () => {
|
|
104
|
+
test("a write beyond the owner's visibility goes through and is logged once per hour, hits merged", async () => {
|
|
105
|
+
const route = "PATCH /api/requirements/:id";
|
|
106
|
+
const before = hitsOf(node.nS.id, route, "beyond_owner_visibility");
|
|
107
|
+
expect((await call(node.nS.token, "PATCH", `/api/requirements/${card.boss}`, { description: "via scoped owner's node" })).status).toBe(200);
|
|
108
|
+
expect((await call(node.nS.token, "PATCH", `/api/requirements/${card.boss}`, { description: "again" })).status).toBe(200);
|
|
109
|
+
expect(hitsOf(node.nS.id, route, "beyond_owner_visibility")).toBe(before + 2);
|
|
110
|
+
expect(logRows(node.nS.id).filter((r) => r.route === route).length).toBe(1);
|
|
111
|
+
});
|
|
112
|
+
|
|
113
|
+
test("a list read that includes cards the owner cannot see is returned in full and logged", async () => {
|
|
114
|
+
const r = await call(node.nS.token, "GET", `/api/requirements?network_id=${net}`);
|
|
115
|
+
expect(r.status).toBe(200);
|
|
116
|
+
expect(r.body.requirements.map((x: any) => x.id)).toContain(card.boss);
|
|
117
|
+
expect(hitsOf(node.nS.id, "GET /api/requirements", "beyond_owner_visibility")).toBeGreaterThan(0);
|
|
118
|
+
});
|
|
119
|
+
|
|
120
|
+
test("human-only actions are logged, not blocked by this layer", async () => {
|
|
121
|
+
const r = await call(node.nN.token, "PUT", `/api/nodes/${node.other.id}/attrs`, { display_name: "renamed by a node", base_attrs_revision: attrsRev(node.other.id) });
|
|
122
|
+
expect(r.status).toBe(200);
|
|
123
|
+
expect(hitsOf(node.nN.id, "PUT /api/nodes/:id/attrs", "human_only")).toBe(1);
|
|
124
|
+
const p = await mcp(node.nN.token, "projects_create", { network_id: net, name: `p-${stamp}` });
|
|
125
|
+
expect(p.error).not.toBe("node_permission_denied");
|
|
126
|
+
expect(hitsOf(node.nN.id, "mcp:projects_create", "human_only")).toBe(1);
|
|
127
|
+
});
|
|
128
|
+
|
|
129
|
+
test("an all-access owner's normal node does its usual work with zero log rows", async () => {
|
|
130
|
+
expect((await mcp(node.nN.token, "send_task", { alias: node.other.alias, task: "hello" })).ok).toBe(true);
|
|
131
|
+
expect((await call(node.nN.token, "PATCH", `/api/requirements/${card.boss}`, { column: "doing" })).status).toBe(200);
|
|
132
|
+
expect(logRows(node.nN.id).filter((r) => r.reason !== "human_only")).toEqual([]);
|
|
133
|
+
});
|
|
134
|
+
});
|
|
135
|
+
|
|
136
|
+
describe("explicit modes are enforced immediately (even under log)", () => {
|
|
137
|
+
test("read-only: writes and dispatch refused with a hint; heartbeat, replies and reads still work", async () => {
|
|
138
|
+
const w = await call(node.nRO.token, "PATCH", `/api/requirements/${card.boss}`, { description: "nope" });
|
|
139
|
+
expect(w.status).toBe(403);
|
|
140
|
+
expect(w.body).toMatchObject({ error: "node_permission_denied", reason: "mode_readonly" });
|
|
141
|
+
expect(w.body.hint).toContain("read-only");
|
|
142
|
+
expect((await mcp(node.nRO.token, "send_task", { alias: node.other.alias, task: "x" })).reason).toBe("mode_readonly");
|
|
143
|
+
expect((await call(node.nRO.token, "POST", "/api/task", { alias: node.other.alias, task: "x", network_id: net })).body.reason).toBe("mode_readonly");
|
|
144
|
+
expect((await mcp(node.nRO.token, "report_status", { resume_id: `r_${node.nRO.id}`, alias: node.nRO.alias, status: "idle" })).ok).toBe(true);
|
|
145
|
+
const t = await mcp(node.nN.token, "send_task", { alias: node.nRO.alias, task: "please answer" });
|
|
146
|
+
const reply = await mcp(node.nRO.token, "send_reply", { in_reply_to: t.task_id ?? t.message_id, text: "done", status: "replied" });
|
|
147
|
+
expect(reply.ok).not.toBe(false);
|
|
148
|
+
expect((await call(node.nRO.token, "GET", `/api/requirements?network_id=${net}`)).status).toBe(200);
|
|
149
|
+
});
|
|
150
|
+
|
|
151
|
+
test("restricted: sees and edits only cards assigned to it (and their subtasks)", async () => {
|
|
152
|
+
const list = await call(node.nR.token, "GET", `/api/requirements?network_id=${net}`);
|
|
153
|
+
expect(list.body.requirements.map((x: any) => x.id).sort()).toEqual([card.assigned, card.child].sort());
|
|
154
|
+
expect((await call(node.nR.token, "GET", `/api/requirements/${card.boss}`)).status).toBe(404);
|
|
155
|
+
expect((await call(node.nR.token, "PATCH", `/api/requirements/${card.assigned}`, { column: "doing" })).status).toBe(200);
|
|
156
|
+
expect((await call(node.nR.token, "PATCH", `/api/requirements/${card.child}`, { column: "doing" })).status).toBe(200);
|
|
157
|
+
expect((await call(node.nR.token, "POST", `/api/requirements/${card.assigned}/comments`, { text: "progress" })).status).toBe(201);
|
|
158
|
+
const mine = await call(node.nR.token, "POST", "/api/requirements", { name: "mine", network_id: net, agent_owner: { kind: "node", id: node.nR.id } });
|
|
159
|
+
expect(mine.status).toBe(201);
|
|
160
|
+
const notMine = await call(node.nR.token, "POST", "/api/requirements", { name: "not mine", network_id: net });
|
|
161
|
+
expect(notMine.status).toBe(403);
|
|
162
|
+
expect(notMine.body.reason).toBe("mode_restricted_not_assigned");
|
|
163
|
+
const viaMcp = await mcp(node.nR.token, "requirements_list", { network_id: net });
|
|
164
|
+
expect((viaMcp.requirements ?? []).map((x: any) => x.id)).not.toContain(card.boss);
|
|
165
|
+
});
|
|
166
|
+
|
|
167
|
+
test("restricted: no broadcast, no network stream, no other session's stream; its own stream works", async () => {
|
|
168
|
+
expect((await mcp(node.nR.token, "broadcast", { message: "hi all" })).reason).toBe("mode_restricted_not_assigned");
|
|
169
|
+
expect((await call(node.nR.token, "POST", "/api/broadcast", { message: "hi", network_id: net })).body.reason).toBe("mode_restricted_not_assigned");
|
|
170
|
+
expect((await sse(node.nR.token, `/events/network/${net}`)).status).toBe(403);
|
|
171
|
+
expect((await sse(node.nR.token, `/events/${encodeURIComponent(node.other.alias)}?network_id=${net}`)).status).toBe(403);
|
|
172
|
+
expect((await sse(node.nR.token, `/events/${encodeURIComponent(node.nR.alias)}?network_id=${net}`)).status).toBe(200);
|
|
173
|
+
});
|
|
174
|
+
});
|
|
175
|
+
|
|
176
|
+
describe("enforce", () => {
|
|
177
|
+
test("the same requests that were only logged are refused with node_permission_denied", async () => {
|
|
178
|
+
process.env.COMMHUB_NODE_PERMISSIONS = "enforce";
|
|
179
|
+
// 主人看不见的卡:与不存在同一个 404(按主人的可见范围读)。
|
|
180
|
+
expect((await call(node.nS.token, "PATCH", `/api/requirements/${card.boss}`, { description: "now refused" })).status).toBe(404);
|
|
181
|
+
// 主人看得见(他是参与人)但改不了的卡:node_permission_denied。
|
|
182
|
+
const w = await call(node.nS.token, "PATCH", `/api/requirements/${card.scoPart}`, { description: "now refused" });
|
|
183
|
+
expect(w.status).toBe(403);
|
|
184
|
+
expect(w.body).toMatchObject({ error: "node_permission_denied", reason: "beyond_owner_visibility" });
|
|
185
|
+
const list = await call(node.nS.token, "GET", `/api/requirements?network_id=${net}`);
|
|
186
|
+
expect(list.body.requirements.map((x: any) => x.id)).not.toContain(card.boss);
|
|
187
|
+
});
|
|
188
|
+
|
|
189
|
+
test("human-only actions are denied (REST and MCP); a node can still write its own attrs", async () => {
|
|
190
|
+
process.env.COMMHUB_NODE_PERMISSIONS = "enforce";
|
|
191
|
+
const r = await call(node.nN.token, "PUT", `/api/nodes/${node.other.id}/attrs`, { display_name: "nope", base_attrs_revision: attrsRev(node.other.id) });
|
|
192
|
+
expect(r.status).toBe(403);
|
|
193
|
+
expect(r.body.reason).toBe("human_only");
|
|
194
|
+
expect((await mcp(node.nN.token, "projects_create", { network_id: net, name: `q-${stamp}` })).reason).toBe("human_only");
|
|
195
|
+
expect((await call(node.nN.token, "PUT", `/api/nodes/${node.nN.id}/attrs`, { display_name: "me", base_attrs_revision: attrsRev(node.nN.id) })).status).toBe(200);
|
|
196
|
+
expect((await mcp(node.nN.token, "send_task", { alias: node.other.alias, task: "still fine" })).ok).toBe(true);
|
|
197
|
+
});
|
|
198
|
+
|
|
199
|
+
test("off: nothing is evaluated or logged for normal nodes; explicit modes still apply", async () => {
|
|
200
|
+
process.env.COMMHUB_NODE_PERMISSIONS = "off";
|
|
201
|
+
const before = JSON.stringify(logRows(node.nS.id));
|
|
202
|
+
expect((await call(node.nS.token, "PATCH", `/api/requirements/${card.boss}`, { description: "off" })).status).toBe(200);
|
|
203
|
+
expect(JSON.stringify(logRows(node.nS.id))).toBe(before);
|
|
204
|
+
expect((await call(node.nRO.token, "PATCH", `/api/requirements/${card.boss}`, { description: "still read-only" })).status).toBe(403);
|
|
205
|
+
});
|
|
206
|
+
});
|
|
207
|
+
|
|
208
|
+
describe("PUT /api/nodes/:id/permission-mode", () => {
|
|
209
|
+
test("owner and network owner/admin can set it and it applies on the next request; others cannot", async () => {
|
|
210
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.nN.id}/permission-mode`, { mode: "readonly" })).body).toMatchObject({ ok: true, permission_mode: "readonly", previous: "normal" });
|
|
211
|
+
expect((await call(node.nN.token, "PATCH", `/api/requirements/${card.boss}`, { description: "mode flip" })).body.reason).toBe("mode_readonly");
|
|
212
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.nN.id}/permission-mode`, { mode: "normal" })).status).toBe(200);
|
|
213
|
+
expect((await call(node.nN.token, "PATCH", `/api/requirements/${card.boss}`, { description: "mode flip" })).status).toBe(200);
|
|
214
|
+
expect((await call(user.sco.token, "PUT", `/api/nodes/${node.nS.id}/permission-mode`, { mode: "restricted" })).status).toBe(200); // sco 是 nS 的主人
|
|
215
|
+
expect((await call(user.sco.token, "PUT", `/api/nodes/${node.nS.id}/permission-mode`, { mode: "normal" })).status).toBe(200);
|
|
216
|
+
expect((await call(user.mem.token, "PUT", `/api/nodes/${node.nN.id}/permission-mode`, { mode: "readonly" })).status).toBe(403);
|
|
217
|
+
expect((await call(node.nN.token, "PUT", `/api/nodes/${node.nN.id}/permission-mode`, { mode: "normal" })).body.error).toBe("user_token_required");
|
|
218
|
+
expect((await call(user.out.token, "PUT", `/api/nodes/${node.nN.id}/permission-mode`, { mode: "readonly" })).status).toBe(404);
|
|
219
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.nN.id}/permission-mode`, { mode: "admin" })).status).toBe(400);
|
|
220
|
+
expect(db.get<{ n: number | string }>("SELECT COUNT(*) AS n FROM audit_log WHERE action = 'node_permission_mode_changed' AND target_id = ?1", node.nN.id)!.n).toBeTruthy();
|
|
221
|
+
});
|
|
222
|
+
});
|
|
223
|
+
|
|
224
|
+
describe("GET /api/nodes viewer_can.permission_mode (#489)", () => {
|
|
225
|
+
test("true exactly for the callers PUT …/permission-mode accepts; node tokens get false; /health advertises it", async () => {
|
|
226
|
+
const canFor = async (token: string, nodeKey: string) =>
|
|
227
|
+
(await call(token, "GET", `/api/nodes?node_id=${node[nodeKey].id}&network_id=${net}`)).body.nodes?.[0]?.viewer_can?.permission_mode;
|
|
228
|
+
expect(await canFor(user.boss.token, "nN")).toBe(true); // 网络 owner
|
|
229
|
+
expect(await canFor(user.sco.token, "nS")).toBe(true); // 节点主人(普通成员)
|
|
230
|
+
expect(await canFor(user.sco.token, "nN")).toBe(false); // 成员,不是主人
|
|
231
|
+
expect(await canFor(user.mem.token, "nN")).toBe(false);
|
|
232
|
+
expect(await canFor(node.nN.token, "nN")).toBe(false); // 节点令牌永远不能改
|
|
233
|
+
const list = await call(user.boss.token, "GET", `/api/nodes?network_id=${net}`);
|
|
234
|
+
expect(list.body.nodes.every((n: any) => !("owner_user_id" in n))).toBe(true);
|
|
235
|
+
const health = await fetch(`${base}/health`).then((r) => r.json()) as any;
|
|
236
|
+
expect(health.capabilities).toContain("node_permission_mode");
|
|
237
|
+
// 与写接口一致:viewer_can=false 的人 PUT 得到 403
|
|
238
|
+
expect((await call(user.mem.token, "PUT", `/api/nodes/${node.nN.id}/permission-mode`, { mode: "normal" })).status).toBe(403);
|
|
239
|
+
});
|
|
240
|
+
});
|
|
241
|
+
|
|
242
|
+
describe("GET /api/networks/:id/node-permission-report", () => {
|
|
243
|
+
test("owner sees would-have-blocked counts per node; members and node tokens are refused", async () => {
|
|
244
|
+
const r = await call(user.boss.token, "GET", `/api/networks/${net}/node-permission-report`);
|
|
245
|
+
expect(r.status).toBe(200);
|
|
246
|
+
const nS = r.body.nodes.find((n: any) => n.node_id === node.nS.id);
|
|
247
|
+
expect(nS.by_reason.beyond_owner_visibility).toBeGreaterThanOrEqual(2);
|
|
248
|
+
expect(nS.alias).toBe(node.nS.alias);
|
|
249
|
+
expect(r.body.total).toBe(r.body.nodes.reduce((n: number, e: any) => n + e.total, 0));
|
|
250
|
+
expect((await call(user.mem.token, "GET", `/api/networks/${net}/node-permission-report`)).status).toBe(403);
|
|
251
|
+
expect((await call(node.nN.token, "GET", `/api/networks/${net}/node-permission-report`)).status).toBe(403);
|
|
252
|
+
expect((await call(user.boss.token, "GET", `/api/networks/${net}/node-permission-report?since=${encodeURIComponent(new Date(Date.now() + 3_600_000).toISOString())}`)).body.total).toBe(0);
|
|
253
|
+
});
|
|
254
|
+
|
|
255
|
+
// #2969 —— 设白名单之前,管理员要能看「这台节点实际用过哪些工具」,
|
|
256
|
+
// 否则白名单只能凭想象写,第一次上线就拦掉在用的东西。
|
|
257
|
+
//
|
|
258
|
+
// 关键的第二条:一台**从不越界**但天天在用的节点,过去在报表里根本不存在
|
|
259
|
+
// (nodes 只从「被拒过的行」聚合)。它恰恰是最该出现在名单里的那台。
|
|
260
|
+
test("按节点的工具调用明细:从不越界的节点也要出现", async () => {
|
|
261
|
+
await mcp(node.nN.token, "list_tasks", { network_id: net, limit: 1 });
|
|
262
|
+
await mcp(node.nN.token, "list_tasks", { network_id: net, limit: 1 });
|
|
263
|
+
const r = await call(user.boss.token, "GET", `/api/networks/${net}/node-permission-report`);
|
|
264
|
+
expect(r.status).toBe(200);
|
|
265
|
+
const nN = r.body.nodes.find((n: any) => n.node_id === node.nN.id);
|
|
266
|
+
expect(nN).toBeTruthy();
|
|
267
|
+
expect(nN.tool_calls_total).toBeGreaterThanOrEqual(2);
|
|
268
|
+
const listTasks = nN.tool_calls.find((t: any) => t.tool === "mcp:list_tasks");
|
|
269
|
+
expect(listTasks.hits).toBeGreaterThanOrEqual(2);
|
|
270
|
+
// 排序也变了:按调用量降序,让「用得最多」的排在最前
|
|
271
|
+
expect(r.body.nodes[0].tool_calls_total).toBeGreaterThanOrEqual(nN.tool_calls_total);
|
|
272
|
+
// 网络级合计保持不变(旧口径不能因为这次改动而变)
|
|
273
|
+
expect(r.body.tool_calls.total).toBeGreaterThanOrEqual(nN.tool_calls_total);
|
|
274
|
+
});
|
|
275
|
+
});
|
|
276
|
+
|
|
277
|
+
// #2823 —— 调用面计数:拒绝日志给不了分母。
|
|
278
|
+
// 生产 30 天 `node_permission_log` 0 行,分不清「没人越界」和「没人碰过这些工具」,
|
|
279
|
+
// 而 #525 要切 enforce,恰恰需要一个分母。
|
|
280
|
+
describe("#2823 计数表的上限必须覆盖整个保留期", () => {
|
|
281
|
+
// 撞上限的后果是**静默归零**(callLogFull 只给已有行加次数、不插新行),
|
|
282
|
+
// 而这正是 #525 用来判「要不要切 enforce」的判据 —— 读到归零会把「没人调用」当结论。
|
|
283
|
+
// 生产实测 75 行/小时(.184 上线首小时);这里按 100 行/小时留余量。
|
|
284
|
+
test("TOOL_CALL_MAX_ROWS 覆盖 LOG_RETENTION_DAYS × 100 行/小时,否则会在保留期内静默停表", async () => {
|
|
285
|
+
const { TOOL_CALL_MAX_ROWS, LOG_RETENTION_DAYS } = await import("./node-permissions.js");
|
|
286
|
+
const worstCasePerHour = 100;
|
|
287
|
+
expect(TOOL_CALL_MAX_ROWS).toBeGreaterThanOrEqual(LOG_RETENTION_DAYS * 24 * worstCasePerHour);
|
|
288
|
+
// 反向验证这条测试有判别力:旧的 20 000 必须不满足
|
|
289
|
+
expect(20_000).toBeLessThan(LOG_RETENTION_DAYS * 24 * worstCasePerHour);
|
|
290
|
+
});
|
|
291
|
+
});
|
|
292
|
+
|
|
293
|
+
describe("#2823 调用面计数(node_tool_calls)", () => {
|
|
294
|
+
const callHits = (nodeId: string, tool: string) => Number(
|
|
295
|
+
db.get<{ h: number | string | null }>(
|
|
296
|
+
"SELECT SUM(hits) AS h FROM node_tool_calls WHERE network_id = ?1 AND node_id = ?2 AND tool = ?3",
|
|
297
|
+
net, nodeId, tool,
|
|
298
|
+
)?.h ?? 0);
|
|
299
|
+
const denyRows = (nodeId: string) => logRows(nodeId).length;
|
|
300
|
+
const toolCallTotal = (nodeId: string) => Number(
|
|
301
|
+
db.get<{ h: number | string | null }>(
|
|
302
|
+
"SELECT SUM(hits) AS h FROM node_tool_calls WHERE network_id = ?1 AND node_id = ?2",
|
|
303
|
+
net, nodeId,
|
|
304
|
+
)?.h ?? 0);
|
|
305
|
+
|
|
306
|
+
test("放行的调用也计数,但**不进**拒绝日志(两张表分开)", async () => {
|
|
307
|
+
const before = { calls: toolCallTotal(node.nN.id), denials: denyRows(node.nN.id) };
|
|
308
|
+
expect((await mcp(node.nN.token, "send_task", { alias: node.other.alias, task: "counted" })).ok).toBe(true);
|
|
309
|
+
expect((await mcp(node.nN.token, "send_task", { alias: node.other.alias, task: "counted again" })).ok).toBe(true);
|
|
310
|
+
expect(toolCallTotal(node.nN.id)).toBe(before.calls + 2);
|
|
311
|
+
expect(callHits(node.nN.id, "mcp:send_task")).toBeGreaterThanOrEqual(2);
|
|
312
|
+
// 关键:分母涨了,分子(拒绝)没动 —— 这才叫「命中率」可算。
|
|
313
|
+
expect(denyRows(node.nN.id)).toBe(before.denials);
|
|
314
|
+
});
|
|
315
|
+
|
|
316
|
+
// #2971 —— 读类 / 需求类 / 排程类原来根本不到闸里,账本因此完全看不到它们。
|
|
317
|
+
// 而敏感读恰恰在这一类里(list_network_secrets / list_providers / tail_node_logs)。
|
|
318
|
+
// 修法只有一个方向:**记账,但不判定** —— 拦截语义必须零变化。
|
|
319
|
+
test("#2971 读类工具会被计数,且行为不变(不被拦、不进拒绝日志)", async () => {
|
|
320
|
+
const before = { calls: callHits(node.nN.id, "mcp:list_providers"), denials: denyRows(node.nN.id) };
|
|
321
|
+
const r = await mcp(node.nN.token, "list_providers", { network_id: net });
|
|
322
|
+
expect(r.error).not.toBe("node_permission_denied");
|
|
323
|
+
expect(callHits(node.nN.id, "mcp:list_providers")).toBe(before.calls + 1);
|
|
324
|
+
expect(denyRows(node.nN.id)).toBe(before.denials);
|
|
325
|
+
});
|
|
326
|
+
|
|
327
|
+
test("#2971 always 类不进账本(心跳会把账本淹掉)", async () => {
|
|
328
|
+
const before = toolCallTotal(node.nN.id);
|
|
329
|
+
await mcp(node.nN.token, "get_inbox", { alias: node.nN.alias });
|
|
330
|
+
expect(toolCallTotal(node.nN.id)).toBe(before);
|
|
331
|
+
});
|
|
332
|
+
|
|
333
|
+
test("本来会被拒的调用两个表都记(分子与分母同源)", async () => {
|
|
334
|
+
const beforeCalls = callHits(node.nN.id, "mcp:projects_create");
|
|
335
|
+
const beforeDeny = hitsOf(node.nN.id, "mcp:projects_create", "human_only");
|
|
336
|
+
const p = await mcp(node.nN.token, "projects_create", { network_id: net, name: `p-count-${stamp}` });
|
|
337
|
+
expect(p.error).not.toBe("node_permission_denied");
|
|
338
|
+
expect(callHits(node.nN.id, "mcp:projects_create")).toBe(beforeCalls + 1);
|
|
339
|
+
expect(hitsOf(node.nN.id, "mcp:projects_create", "human_only")).toBe(beforeDeny + 1);
|
|
340
|
+
});
|
|
341
|
+
|
|
342
|
+
test("报表同时给分母与分子,且拒绝口径 total 不被放行调用污染", async () => {
|
|
343
|
+
const before = await call(user.boss.token, "GET", `/api/networks/${net}/node-permission-report`);
|
|
344
|
+
expect(before.status).toBe(200);
|
|
345
|
+
const beforeDenied = Number(before.body.total);
|
|
346
|
+
const beforeCalls = Number(before.body.tool_calls.total);
|
|
347
|
+
|
|
348
|
+
expect((await mcp(node.nN.token, "send_task", { alias: node.other.alias, task: "report bump" })).ok).toBe(true);
|
|
349
|
+
|
|
350
|
+
const after = await call(user.boss.token, "GET", `/api/networks/${net}/node-permission-report`);
|
|
351
|
+
expect(after.status).toBe(200);
|
|
352
|
+
expect(Number(after.body.tool_calls.total)).toBe(beforeCalls + 1);
|
|
353
|
+
expect(Number(after.body.total)).toBe(beforeDenied);
|
|
354
|
+
expect(Array.isArray(after.body.tool_calls.by_tool)).toBe(true);
|
|
355
|
+
expect(after.body.tool_calls.by_tool.every((r: any) => typeof r.tool === "string" && typeof r.hits === "number")).toBe(true);
|
|
356
|
+
});
|
|
357
|
+
|
|
358
|
+
test("节点令牌读不到报表(分母同样只给人看)", async () => {
|
|
359
|
+
expect((await call(node.nN.token, "GET", `/api/networks/${net}/node-permission-report`)).status).toBe(403);
|
|
360
|
+
});
|
|
361
|
+
});
|
|
362
|
+
|
|
363
|
+
describe("bookkeeping", () => {
|
|
364
|
+
test("every MCP tool a node can call has a permission class", async () => {
|
|
365
|
+
const s = new McpServer({ name: "np", version: "1" });
|
|
366
|
+
registerTools(s, undefined, net, user.boss.id, node.nN.alias, true, node.nN.tokenId);
|
|
367
|
+
const client = new Client({ name: "np-client", version: "1" });
|
|
368
|
+
const [ct, st] = InMemoryTransport.createLinkedPair();
|
|
369
|
+
await s.connect(st); await client.connect(ct);
|
|
370
|
+
const names = (await client.listTools()).tools.map((t) => t.name);
|
|
371
|
+
await client.close(); await s.close();
|
|
372
|
+
expect(names.length).toBeGreaterThan(50);
|
|
373
|
+
expect(names.filter((n) => !NODE_TOOL_CLASS[n])).toEqual([]);
|
|
374
|
+
});
|
|
375
|
+
|
|
376
|
+
test("log rows older than the retention window are pruned", () => {
|
|
377
|
+
const old = new Date(Date.now() - 40 * 86_400_000).toISOString().slice(0, 13);
|
|
378
|
+
db.run("INSERT INTO node_permission_log (network_id, node_id, route, reason, hour, hits) VALUES (?1, ?2, 'old', 'human_only', ?3, 5)", [net, node.nN.id, old]);
|
|
379
|
+
pruneNodePermissionLog();
|
|
380
|
+
__resetNodePermissionLogStateForTest();
|
|
381
|
+
expect(db.get("SELECT 1 AS hit FROM node_permission_log WHERE route = 'old'")).toBeFalsy();
|
|
382
|
+
});
|
|
383
|
+
});
|
|
384
|
+
|
|
385
|
+
// #2969 / #1510 —— 「能设」之外还差一半:「能看到当前设的是什么」。
|
|
386
|
+
//
|
|
387
|
+
// 两张白名单原先只有 PUT,`GET /api/nodes` 里一个字都没有,客户端因此做不出
|
|
388
|
+
// 「当前设置」这一屏 —— 能写不能读,等于逼用户凭记忆操作。
|
|
389
|
+
// 同一处还给 #1510 的严格模式留了眼睛:管理员要能看出谁的 transport 未知。
|
|
390
|
+
describe("GET /api/nodes 读回白名单与 transport", () => {
|
|
391
|
+
const rowOf = async (nodeId: string) => {
|
|
392
|
+
const r = await call(user.boss.token, "GET", `/api/nodes?network_id=${net}&node_id=${nodeId}`);
|
|
393
|
+
expect(r.status).toBe(200);
|
|
394
|
+
expect(r.body.nodes).toHaveLength(1);
|
|
395
|
+
return r.body.nodes[0];
|
|
396
|
+
};
|
|
397
|
+
|
|
398
|
+
test("默认是 null(= 不限制),不是空数组", async () => {
|
|
399
|
+
const row = await rowOf(node.other.id);
|
|
400
|
+
expect(row.peer_allowlist).toBeNull();
|
|
401
|
+
expect(row.tool_allowlist).toBeNull();
|
|
402
|
+
});
|
|
403
|
+
|
|
404
|
+
test("写进去什么,读出来就是什么", async () => {
|
|
405
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/peer-allowlist`, { peers: ["boss", node.nR.id] })).status).toBe(200);
|
|
406
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/tool-allowlist`, { tools: ["send_task", "get_inbox"] })).status).toBe(200);
|
|
407
|
+
const row = await rowOf(node.other.id);
|
|
408
|
+
expect(row.peer_allowlist).toEqual(["boss", node.nR.id]);
|
|
409
|
+
expect(row.tool_allowlist).toEqual(["send_task", "get_inbox"]);
|
|
410
|
+
});
|
|
411
|
+
|
|
412
|
+
test("清空后回到 null,而不是 []", async () => {
|
|
413
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/peer-allowlist`, { peers: null })).status).toBe(200);
|
|
414
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/tool-allowlist`, { tools: null })).status).toBe(200);
|
|
415
|
+
const row = await rowOf(node.other.id);
|
|
416
|
+
expect(row.peer_allowlist).toBeNull();
|
|
417
|
+
expect(row.tool_allowlist).toBeNull();
|
|
418
|
+
});
|
|
419
|
+
|
|
420
|
+
test("env_transport 取该节点最新一次上报(老上报不能盖掉新的)", async () => {
|
|
421
|
+
// 两行同 node_id、不同时间:取 updated_at 更大的那条。
|
|
422
|
+
db.run("DELETE FROM sessions WHERE node_id = ?1", [node.nR.id]);
|
|
423
|
+
db.run("INSERT INTO sessions (resume_id, alias, status, node_id, network_id, env_transport, updated_at) VALUES (?1, ?2, 'idle', ?3, ?4, 'plain', datetime('now','-2 hour'))",
|
|
424
|
+
[`r_old_${node.nR.id}`, "r-old-alias", node.nR.id, net]);
|
|
425
|
+
db.run("INSERT INTO sessions (resume_id, alias, status, node_id, network_id, env_transport, updated_at) VALUES (?1, ?2, 'idle', ?3, ?4, 'https', datetime('now','-1 minute'))",
|
|
426
|
+
[`r_new_${node.nR.id}`, "r-new-alias", node.nR.id, net]);
|
|
427
|
+
expect((await rowOf(node.nR.id)).env_transport).toBe("https");
|
|
428
|
+
});
|
|
429
|
+
|
|
430
|
+
test("从没上报过的节点是 null(不是猜一个值填上)", async () => {
|
|
431
|
+
db.run("UPDATE sessions SET env_transport = NULL WHERE node_id = ?1", [node.nR.id]);
|
|
432
|
+
expect((await rowOf(node.nR.id)).env_transport).toBeNull();
|
|
433
|
+
});
|
|
434
|
+
|
|
435
|
+
test("别的网络里的同名字段不会串到这一格(alias 兜底必须带网络约束)", async () => {
|
|
436
|
+
// 场景:本网络有一台节点,它的 sessions 行只用 alias 命中(node_id 为空,
|
|
437
|
+
// alias 就等于节点 id —— 老注册路径就是这样)。
|
|
438
|
+
// 另一个网络里**恰好也有一个 alias 相同的 sessions 行**,而且是明文公网、时间更新。
|
|
439
|
+
//
|
|
440
|
+
// 如果兜底查询不按网络约束,这一格会把 B 网的 'plain' 显示成 A 网这台节点的 transport。
|
|
441
|
+
// 这一格是给人做安全决策用的(决定要不要打开 strict)——
|
|
442
|
+
// 显示错的 'plain' 会让人以为挡住了,其实挡的是别人;显示 null 至少会让人去查。
|
|
443
|
+
const shadowId = `n_np_shadow_${stamp}`;
|
|
444
|
+
db.run("INSERT INTO nodes (node_id, node_name, alias, network_id, lifecycle_state) VALUES (?1, ?1, ?2, ?3, 'active')",
|
|
445
|
+
[shadowId, `shadow-${stamp}`, net]);
|
|
446
|
+
db.run("INSERT INTO sessions (resume_id, alias, status, node_id, network_id, env_transport, updated_at) VALUES (?1, ?2, 'idle', NULL, ?3, 'https', datetime('now','-1 hour'))",
|
|
447
|
+
[`s_shadow_${stamp}`, shadowId, net]);
|
|
448
|
+
const otherOwner = register(`np_othernet_${stamp}_${Date.now()}`, PW);
|
|
449
|
+
db.run("INSERT INTO sessions (resume_id, alias, status, node_id, network_id, env_transport, updated_at) VALUES (?1, ?2, 'idle', NULL, ?3, 'plain', datetime('now','+1 hour'))",
|
|
450
|
+
[`s_shadow_other_${stamp}`, shadowId, otherOwner.network_id!]);
|
|
451
|
+
|
|
452
|
+
// 本网络这台的 'https' 必须赢;时间更新的 'plain' 不能跨网络串进来。
|
|
453
|
+
expect((await rowOf(shadowId)).env_transport).toBe("https");
|
|
454
|
+
});
|
|
455
|
+
});
|
|
456
|
+
|
|
457
|
+
// #2969 —— 空数组是歧义的,Hub 直接拒,不猜。
|
|
458
|
+
//
|
|
459
|
+
// 客户端(PR #1165)把「[] = 不允许任何」做进了界面,而 Hub 的 `length ? … : null`
|
|
460
|
+
// 会把 [] 规范化成 null = 不限制。两边语义相反:用户以为收紧了,系统其实放开了。
|
|
461
|
+
// 三种做法里选了最不含糊的一种 —— 拒收,让调用方当场看到 400 和「清空请传 null」。
|
|
462
|
+
describe("空数组不猜:拒收,清空请传 null", () => {
|
|
463
|
+
test("PUT tool-allowlist [] → 400 empty_allowlist_ambiguous,且没改动库里已有值", async () => {
|
|
464
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/tool-allowlist`, { tools: ["send_task"] })).status).toBe(200);
|
|
465
|
+
const r = await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/tool-allowlist`, { tools: [] });
|
|
466
|
+
expect(r.status).toBe(400);
|
|
467
|
+
expect(r.body.error).toBe("empty_allowlist_ambiguous");
|
|
468
|
+
// 关键:拒收不能顺手把它清掉 —— 那等于「报错了,但行为已经变了」。
|
|
469
|
+
const row = await call(user.boss.token, "GET", `/api/nodes?network_id=${net}&node_id=${node.other.id}`);
|
|
470
|
+
expect(row.body.nodes[0].tool_allowlist).toEqual(["send_task"]);
|
|
471
|
+
});
|
|
472
|
+
|
|
473
|
+
test("PUT peer-allowlist [] → 400,库里也没变", async () => {
|
|
474
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/peer-allowlist`, { peers: ["boss"] })).status).toBe(200);
|
|
475
|
+
const r = await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/peer-allowlist`, { peers: [] });
|
|
476
|
+
expect(r.status).toBe(400);
|
|
477
|
+
expect(r.body.error).toBe("empty_allowlist_ambiguous");
|
|
478
|
+
const row = await call(user.boss.token, "GET", `/api/nodes?network_id=${net}&node_id=${node.other.id}`);
|
|
479
|
+
expect(row.body.nodes[0].peer_allowlist).toEqual(["boss"]);
|
|
480
|
+
});
|
|
481
|
+
|
|
482
|
+
test("清空走 null:200,读回来是 null(不是 [])", async () => {
|
|
483
|
+
expect((await call(user.boss.token, "PUT", `/api/nodes/${node.other.id}/tool-allowlist`, { tools: null })).status).toBe(200);
|
|
484
|
+
const row = await call(user.boss.token, "GET", `/api/nodes?network_id=${net}&node_id=${node.other.id}`);
|
|
485
|
+
expect(row.body.nodes[0].tool_allowlist).toBeNull();
|
|
486
|
+
});
|
|
487
|
+
});
|
|
488
|
+
|
|
489
|
+
// #2969 / #2971 —— 未绑定节点的令牌是权限体系的一个真实盲点:
|
|
490
|
+
// 账本用 `token:<token_id>` 当键,它们没有 nodes 行 ⇒ 两张白名单都管不到(toolAllowlist 为 null)。
|
|
491
|
+
// 报表必须把它们标出来,否则管理员会以为「名单之外没有别人在派活」。
|
|
492
|
+
describe("未绑定节点的令牌在报表里必须可见", () => {
|
|
493
|
+
test("token: 键的条目带 unbound_token=true,真实节点不带", async () => {
|
|
494
|
+
db.run(`INSERT INTO node_tool_calls (network_id, node_id, tool, hour, hits) VALUES (?1, ?2, 'mcp:send_task', ?3, 4)
|
|
495
|
+
ON CONFLICT(network_id, node_id, tool, hour) DO UPDATE SET hits = node_tool_calls.hits + 4`,
|
|
496
|
+
[net, "token:tok_unbound_test", new Date().toISOString().slice(0, 13)]);
|
|
497
|
+
const r = await call(user.boss.token, "GET", `/api/networks/${net}/node-permission-report`);
|
|
498
|
+
expect(r.status).toBe(200);
|
|
499
|
+
const unbound = r.body.nodes.find((n: any) => n.node_id === "token:tok_unbound_test");
|
|
500
|
+
expect(unbound).toBeTruthy();
|
|
501
|
+
expect(unbound.unbound_token).toBe(true);
|
|
502
|
+
expect(unbound.tool_calls_total).toBeGreaterThanOrEqual(4);
|
|
503
|
+
const real = r.body.nodes.find((n: any) => n.node_id === node.nN.id);
|
|
504
|
+
expect(real.unbound_token).toBeUndefined();
|
|
505
|
+
// 令牌名要带出来 —— 只看 `token:tok_xxx` 无法处理;名字才是「该改哪个令牌」的答案。
|
|
506
|
+
const tokRow = db.get<{ token_id: string }>("SELECT token_id FROM api_tokens LIMIT 1");
|
|
507
|
+
db.run(`INSERT INTO node_tool_calls (network_id, node_id, tool, hour, hits) VALUES (?1, ?2, 'mcp:send_task', ?3, 1)
|
|
508
|
+
ON CONFLICT(network_id, node_id, tool, hour) DO UPDATE SET hits = node_tool_calls.hits + 1`,
|
|
509
|
+
[net, `token:${tokRow.token_id}`, new Date().toISOString().slice(0, 13)]);
|
|
510
|
+
const r2 = await call(user.boss.token, "GET", `/api/networks/${net}/node-permission-report`);
|
|
511
|
+
const withName = r2.body.nodes.find((n: any) => n.node_id === `token:${tokRow.token_id}`);
|
|
512
|
+
expect(withName.unbound_token_name).toBeTruthy();
|
|
513
|
+
});
|
|
514
|
+
});
|
|
515
|
+
|
|
516
|
+
// #2969 续 —— 令牌解析不到节点行时,两张白名单都管不到它。
|
|
517
|
+
// 先按「记录」跑:`unbound_token` 不在 MODE_REASONS 里 ⇒ 默认 log 模式只记账、不改变行为。
|
|
518
|
+
// 这样「要不要强制要求绑定令牌」这个决定,将来自有数据可依据(而不是靠猜会不会炸)。
|
|
519
|
+
describe("未绑定令牌的写调用:默认只记录,不拦", () => {
|
|
520
|
+
// 造一个**解析不到节点**的令牌:名字里的 alias 在本网络没有对应 nodes 行。
|
|
521
|
+
// 这就是线上那 4 个令牌的真实形状(节点改名、令牌名没跟着改)。
|
|
522
|
+
const unboundKey = () => {
|
|
523
|
+
const alias = `ghost-alias-${stamp}`;
|
|
524
|
+
const tokenId = `tok_ghost_${stamp}`;
|
|
525
|
+
// 🔴 不能用 `INSERT OR IGNORE`:那是 SQLite 专有语法,PostgreSQL 会直接
|
|
526
|
+
// `syntax error at or near "OR"`(test2123-hub-postgres-ladder 实测)。
|
|
527
|
+
// 两边都认的写法是 ON CONFLICT ... DO NOTHING。
|
|
528
|
+
db.run("INSERT INTO api_tokens (token_id, token_hash, user_id, network_id, name, scope) VALUES (?1, ?2, ?3, ?4, ?5, 'network') ON CONFLICT (token_id) DO NOTHING",
|
|
529
|
+
[tokenId, `hash_${tokenId}`, user.boss.id, net, `node:${alias}`]);
|
|
530
|
+
return tokenId;
|
|
531
|
+
};
|
|
532
|
+
|
|
533
|
+
test("log 模式:写调用照常成功,但进 node_permission_log(reason=unbound_token)", async () => {
|
|
534
|
+
const tokenId = unboundKey();
|
|
535
|
+
const key = `token:${tokenId}`;
|
|
536
|
+
const before = Number(db.get<{ h: number | string | null }>(
|
|
537
|
+
"SELECT SUM(hits) AS h FROM node_permission_log WHERE network_id = ?1 AND node_id = ?2 AND reason = 'unbound_token'",
|
|
538
|
+
net, key)?.h ?? 0);
|
|
539
|
+
// 用一个「解析不到节点」的身份直接走判定,绕开 HTTP 令牌构造(这里验的是判据与记账)
|
|
540
|
+
const { nodeIdentity, nodeDecide } = await import("./node-permissions.js");
|
|
541
|
+
const id = nodeIdentity(tokenId, net)!;
|
|
542
|
+
expect(id.nodeId).toBeNull();
|
|
543
|
+
const allowed = nodeDecide(id, "mcp:send_task", { reason: "unbound_token", sample: "send_task" });
|
|
544
|
+
expect(allowed).toBe(false); // log 模式:不拦
|
|
545
|
+
const after = Number(db.get<{ h: number | string | null }>(
|
|
546
|
+
"SELECT SUM(hits) AS h FROM node_permission_log WHERE network_id = ?1 AND node_id = ?2 AND reason = 'unbound_token'",
|
|
547
|
+
net, key)?.h ?? 0);
|
|
548
|
+
expect(after).toBe(before + 1); // 但记了一笔
|
|
549
|
+
});
|
|
550
|
+
|
|
551
|
+
test("enforce 模式:同一个调用被拒,原因是 unbound_token", async () => {
|
|
552
|
+
process.env.COMMHUB_NODE_PERMISSIONS = "enforce";
|
|
553
|
+
const { nodeIdentity, nodeDecide } = await import("./node-permissions.js");
|
|
554
|
+
const id = nodeIdentity(unboundKey(), net)!;
|
|
555
|
+
expect(nodeDecide(id, "mcp:send_task", { reason: "unbound_token", sample: "send_task" })).toBe(true);
|
|
556
|
+
});
|
|
557
|
+
});
|
|
558
|
+
|
|
559
|
+
// #2969 续 —— REST 写接口白名单:唯一 choke point。
|
|
560
|
+
//
|
|
561
|
+
// 为什么必须在中央判一次:节点令牌的 REST 写面分散在两套判据里
|
|
562
|
+
// (server.ts 的 restNodeDenied + requirements.ts 的 nodeTaskGate)。
|
|
563
|
+
// 逐站点加会变成第三套规则,且漏掉任一处就是「装了一半的安全开关」——
|
|
564
|
+
// 那比没有更危险,因为它会被当成已经收紧了。
|
|
565
|
+
describe("#2969 REST 写白名单", () => {
|
|
566
|
+
test("路径归一化:11 条节点路由的标签逐字一致", async () => {
|
|
567
|
+
const { restRouteLabel } = await import("./node-permissions.js");
|
|
568
|
+
const cases: Array<[string, string, string]> = [
|
|
569
|
+
["POST", "/api/task", "POST /api/task"],
|
|
570
|
+
["POST", "/api/broadcast", "POST /api/broadcast"],
|
|
571
|
+
["DELETE", "/api/nodes/n_abc123", "DELETE /api/nodes/:id"],
|
|
572
|
+
["PUT", "/api/nodes/n_abc123/attrs", "PUT /api/nodes/:id/attrs"],
|
|
573
|
+
["PUT", "/api/nodes/node_9f8e7d/avatar", "PUT /api/nodes/:id/avatar"],
|
|
574
|
+
["PATCH", "/api/requirements/req_123", "PATCH /api/requirements/:id"],
|
|
575
|
+
["PATCH", "/api/requirements/req_123/checklist/it_9", "PATCH /api/requirements/:id/checklist/:id"],
|
|
576
|
+
["POST", "/api/requirements", "POST /api/requirements"],
|
|
577
|
+
["POST", "/api/requirements/req_123/comments", "POST /api/requirements/:id/comments"],
|
|
578
|
+
["PUT", "/api/nodes/tmwork_4ff6a3ee-f0b1-492c-abf6-132eea7b5e09/attrs", "PUT /api/nodes/:id/attrs"],
|
|
579
|
+
];
|
|
580
|
+
for (const [m, p, want] of cases) expect(restRouteLabel(m, p)).toBe(want);
|
|
581
|
+
});
|
|
582
|
+
|
|
583
|
+
test("未设置清单 ⇒ 不判(不限制),行为与现在一致", async () => {
|
|
584
|
+
const { nodeIdentity, restAllowlistVerdict } = await import("./node-permissions.js");
|
|
585
|
+
const id = nodeIdentity(node.nN.tokenId, net)!;
|
|
586
|
+
expect(id.restAllowlist).toBeNull();
|
|
587
|
+
expect(restAllowlistVerdict(id, "POST /api/broadcast")).toBeNull();
|
|
588
|
+
});
|
|
589
|
+
|
|
590
|
+
test("设置了清单 ⇒ 清单外的写路由被拒,清单内的放行", async () => {
|
|
591
|
+
const { nodeIdentity, restAllowlistVerdict } = await import("./node-permissions.js");
|
|
592
|
+
db.run("UPDATE nodes SET rest_allowlist = ?1 WHERE node_id = ?2", [JSON.stringify(["POST /api/task"]), node.nN.id]);
|
|
593
|
+
const id = nodeIdentity(node.nN.tokenId, net)!;
|
|
594
|
+
expect(restAllowlistVerdict(id, "POST /api/task")).toBeNull();
|
|
595
|
+
expect(restAllowlistVerdict(id, "POST /api/broadcast")).toMatchObject({ reason: "rest_not_allowed" });
|
|
596
|
+
db.run("UPDATE nodes SET rest_allowlist = NULL WHERE node_id = ?1", [node.nN.id]);
|
|
597
|
+
});
|
|
598
|
+
|
|
599
|
+
test("HTTP:节点只有 POST /api/task 时,广播返回 403 rest_not_allowed", async () => {
|
|
600
|
+
db.run("UPDATE nodes SET rest_allowlist = ?1 WHERE node_id = ?2", [JSON.stringify(["POST /api/task"]), node.nN.id]);
|
|
601
|
+
const r = await call(node.nN.token, "POST", "/api/broadcast", { message: "should be blocked" });
|
|
602
|
+
expect(r.status).toBe(403);
|
|
603
|
+
expect(r.body.reason).toBe("rest_not_allowed");
|
|
604
|
+
db.run("UPDATE nodes SET rest_allowlist = NULL WHERE node_id = ?1", [node.nN.id]);
|
|
605
|
+
});
|
|
606
|
+
|
|
607
|
+
test("HTTP:用户令牌不受 REST 白名单影响(只对节点令牌生效)", async () => {
|
|
608
|
+
db.run("UPDATE nodes SET rest_allowlist = ?1 WHERE node_id = ?2", [JSON.stringify(["POST /api/task"]), node.nN.id]);
|
|
609
|
+
const r = await call(user.boss.token, "POST", `/api/requirements`, { name: `rest-allow-user-${stamp}`, network_id: net });
|
|
610
|
+
expect(r.status).toBe(201);
|
|
611
|
+
db.run("UPDATE nodes SET rest_allowlist = NULL WHERE node_id = ?1", [node.nN.id]);
|
|
612
|
+
});
|
|
613
|
+
|
|
614
|
+
test("GET 读回 rest_allowlist(null = 不限制)", async () => {
|
|
615
|
+
db.run("UPDATE nodes SET rest_allowlist = ?1 WHERE node_id = ?2", [JSON.stringify(["POST /api/task", "PATCH /api/requirements/:id"]), node.nN.id]);
|
|
616
|
+
const r = await call(user.boss.token, "GET", `/api/nodes?network_id=${net}&node_id=${node.nN.id}`);
|
|
617
|
+
expect(r.body.nodes[0].rest_allowlist).toEqual(["POST /api/task", "PATCH /api/requirements/:id"]);
|
|
618
|
+
db.run("UPDATE nodes SET rest_allowlist = NULL WHERE node_id = ?1", [node.nN.id]);
|
|
619
|
+
});
|
|
620
|
+
});
|
|
621
|
+
|
|
622
|
+
// #2970 判据④ —— 演练发现的口径问题:
|
|
623
|
+
// `node_permission_log` 的行数**不等于**「打开 enforce 行为会变」的次数。
|
|
624
|
+
// 演练现场:log 模式下 projects_create 已被处理函数拒(user_token_required),
|
|
625
|
+
// 但仍记了一行 human_only —— 计入影响面就会高估。
|
|
626
|
+
describe("#2970 enforce 影响面分层", () => {
|
|
627
|
+
test("原因码分三类:显式永久拒 / 多数已在下游被拦 / 只有 enforce 才改变行为", async () => {
|
|
628
|
+
const { enforceImpactOf } = await import("./node-permissions.js");
|
|
629
|
+
// 显式原因:与开关无关,永远拒 ⇒ 不是增量
|
|
630
|
+
for (const r of ["mode_readonly", "mode_restricted_not_assigned", "peer_not_allowed", "tool_not_allowed", "rest_not_allowed"]) {
|
|
631
|
+
expect(enforceImpactOf(r as any)).toBe("explicit");
|
|
632
|
+
}
|
|
633
|
+
// human_only:多数写路由自带「只有人能操作」检查,log 下调用方本来就被拒
|
|
634
|
+
expect(enforceImpactOf("human_only")).toBe("likely_already_blocked");
|
|
635
|
+
// 只有这三类 + unbound_token 是 enforce 的真增量
|
|
636
|
+
for (const r of ["beyond_owner_visibility", "agent_not_granted_to_owner", "owner_unknown", "unbound_token"]) {
|
|
637
|
+
expect(enforceImpactOf(r as any)).toBe("changes_behavior");
|
|
638
|
+
}
|
|
639
|
+
});
|
|
640
|
+
|
|
641
|
+
test("报表带 enforce_impact 分层汇总", async () => {
|
|
642
|
+
const r = await call(user.boss.token, "GET", `/api/networks/${net}/node-permission-report`);
|
|
643
|
+
expect(r.status).toBe(200);
|
|
644
|
+
expect(r.body.enforce_impact).toBeTruthy();
|
|
645
|
+
// 每个节点也带同名结构
|
|
646
|
+
for (const n of r.body.nodes) expect(n.enforce_impact).toBeTruthy();
|
|
647
|
+
});
|
|
648
|
+
});
|