@sleep2agi/commhub-server 0.9.0-preview.26 → 0.9.0-preview.260
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 +120 -3
- package/bin/commhub.ts +93 -9
- package/build-info.json +7 -0
- package/package.json +10 -8
- package/src/ack-create-request-transport.test.ts +182 -0
- package/src/ack-create-request.test.ts +52 -8
- 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 +140 -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 +680 -0
- package/src/agent-acl-slice3-http.test.ts +885 -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 +6 -7
- package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
- package/src/api-nodes-shape.test.ts +131 -4
- package/src/auth-abuse-counters.test.ts +125 -0
- package/src/auth-abuse-counters.ts +122 -0
- package/src/auth-password-change-cli-tokens-http.test.ts +423 -0
- package/src/auth-sessions-http.test.ts +260 -0
- package/src/auth-validate.test.ts +5 -1
- package/src/auth-weak-password-login.test.ts +176 -0
- package/src/auth.ts +609 -56
- package/src/backfill-node-ids-2664.test.ts +128 -0
- package/src/binding-generation-http.test.ts +141 -0
- package/src/blocked-exit-on-reply.test.ts +122 -0
- package/src/broadcast-fanout-2721.test.ts +149 -0
- package/src/broadcast-fanout.ts +117 -0
- package/src/build-commit-report-http.test.ts +128 -0
- package/src/build-info.test.ts +60 -0
- package/src/build-info.ts +85 -0
- package/src/chain-attempt-dedup.test.ts +447 -0
- package/src/clip.test.ts +36 -0
- package/src/clip.ts +48 -0
- package/src/clone-node.test.ts +269 -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 +188 -1
- package/src/config-apply-validate.ts +222 -3
- package/src/cors-origins.test.ts +73 -0
- package/src/create-node-blocked-gate.test.ts +365 -0
- package/src/create-node-error-domain.test.ts +124 -0
- package/src/create-node-network-id.test.ts +91 -0
- package/src/create-node-tool-schema.test.ts +49 -0
- package/src/create-node-unicode-name.test.ts +126 -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 +298 -0
- package/src/create-node.ts +88 -23
- package/src/daemon-provider-snapshots.test.ts +453 -0
- package/src/daemon-provider-snapshots.ts +327 -0
- package/src/daemon-token-owner-http.test.ts +346 -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 +1269 -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 +350 -0
- package/src/department-heads.ts +226 -0
- package/src/departments-agent-count.test.ts +139 -0
- package/src/departments-http.test.ts +185 -0
- package/src/departments-mcp-error-domain.test.ts +135 -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/etag-of.test.ts +57 -0
- package/src/event-loop-lag.test.ts +180 -0
- package/src/event-loop-lag.ts +201 -0
- package/src/expiry-counters.test.ts +187 -0
- package/src/expiry-counters.ts +227 -0
- package/src/expiry-evidence-db.test.ts +103 -0
- package/src/ext-token-shared.test.ts +60 -0
- package/src/ext-validation-regression.test.ts +10 -17
- 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 +1 -1
- package/src/file-download-authz.test.ts +25 -4
- package/src/file-download-date-bucket.test.ts +1 -1
- package/src/file-network-scope-dev-open.test.ts +1 -1
- package/src/file-network-scope.test.ts +7 -6
- package/src/group-membership-events-http.test.ts +264 -0
- package/src/group-messages-http.test.ts +483 -0
- package/src/group-messages.ts +297 -0
- package/src/health-anon-readers.ts +67 -0
- package/src/health-host-disk-2756.test.ts +71 -0
- package/src/health-redaction.test.ts +1576 -7
- 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 +641 -0
- package/src/hub-provider-config.test.ts +166 -0
- package/src/hub-provider-config.ts +202 -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 +318 -0
- package/src/inbox-count.ts +29 -0
- package/src/index.ts +6 -2
- package/src/license-state.test.ts +56 -0
- package/src/license-state.ts +48 -0
- package/src/lifecycle-error-domain.test.ts +109 -0
- package/src/list-ack-error-domain.test.ts +108 -0
- package/src/list-host-supervisors.test.ts +15 -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 +168 -0
- package/src/mcp-route-label-http.test.ts +120 -0
- package/src/mcp-write-network-resolution.test.ts +21 -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 +222 -3
- package/src/network-token-membership-http.test.ts +186 -0
- package/src/node-alias-control.ts +12 -0
- package/src/node-attrs.test.ts +47 -2
- package/src/node-caller-identity-http.test.ts +1108 -0
- package/src/node-create-request-status-http.test.ts +105 -0
- package/src/node-daemon-bindings.test.ts +142 -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 +350 -0
- package/src/node-health-codex-login.test.ts +120 -0
- package/src/node-health-dispatch-http.test.ts +373 -0
- package/src/node-health-guard.ts +121 -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 +257 -0
- package/src/node-lifecycle-read.ts +124 -0
- package/src/node-logs-transport.test.ts +266 -0
- package/src/node-peer-allowlist.test.ts +114 -0
- package/src/node-permissions-http.test.ts +728 -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-security-write-gate.test.ts +72 -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 +212 -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 +103 -10
- package/src/observer-push.test.ts +76 -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 +356 -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 +462 -0
- package/src/peer-reply-capability.test.ts +70 -0
- package/src/pg-worker.ts +87 -0
- package/src/poll-pacing.test.ts +74 -0
- package/src/poll-pacing.ts +123 -0
- package/src/probe-provider-error-domain.test.ts +141 -0
- package/src/project-dir-warn-clear-http.test.ts +132 -0
- package/src/project-viewer-can-http.test.ts +116 -0
- package/src/provider-skill-error-domain.test.ts +130 -0
- package/src/provider-tools-shape.test.ts +165 -0
- package/src/push.test.ts +20 -10
- package/src/push.ts +373 -9
- package/src/redact-tokens.test.ts +86 -0
- package/src/redact-tokens.ts +43 -0
- package/src/rejection-counters.test.ts +72 -0
- package/src/rejection-counters.ts +173 -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 +318 -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 +313 -0
- package/src/requirement-tag-ops-http.test.ts +454 -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-assignee-drift.test.ts +154 -0
- package/src/requirements-comment-http.test.ts +174 -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 +180 -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-network-echo.test.ts +57 -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 +2205 -0
- package/src/resolve-port.test.ts +57 -0
- package/src/resolve-port.ts +44 -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 +271 -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 +486 -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 +203 -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 +289 -0
- package/src/scheduled-requirement-wake.ts +125 -0
- package/src/scheduled-run-terminal.test.ts +290 -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 +316 -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/secret-echo-negative-control.test.ts +118 -0
- package/src/send-dedup-request-id.test.ts +229 -0
- package/src/send-reply-agent-warning.test.ts +38 -38
- package/src/send-reply-alias-optional.test.ts +131 -0
- package/src/send-reply-attachments.test.ts +28 -7
- package/src/send_dedup.test.ts +54 -0
- package/src/send_dedup.ts +52 -6
- package/src/serve-error.test.ts +73 -0
- package/src/serve-error.ts +56 -0
- package/src/server.ts +4842 -325
- 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/probe-host-allowlist-drift.test.ts +45 -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 +144 -0
- package/src/sqlite-close-checkpoint.test.ts +78 -0
- package/src/start-node.test.ts +265 -0
- package/src/start-request-error-domain.test.ts +182 -0
- package/src/start-skill-error-domain.test.ts +122 -0
- package/src/stats-versions-http.test.ts +65 -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 +129 -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 +508 -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 +298 -0
- package/src/task-expiry-notice.ts +318 -0
- package/src/task-idempotency-mcp.test.ts +148 -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 +227 -0
- package/src/task-lifecycle-watcher-busy.test.ts +114 -0
- package/src/task-lifecycle-watcher.test.ts +209 -0
- package/src/task-lifecycle-watcher.ts +109 -0
- package/src/task-network-resolution-http.test.ts +140 -0
- package/src/task-not-found-error-domain.test.ts +76 -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 +61 -0
- package/src/task-sender-http.test.ts +143 -0
- package/src/task-stale-open-http.test.ts +292 -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/tmux-allowlist.test.ts +48 -0
- package/src/tool-audience-http.test.ts +248 -0
- package/src/tool-audience.ts +127 -0
- package/src/tools-list-json-schema.test.ts +94 -0
- package/src/tools.ts +4215 -397
- package/src/update-node-config-error-domain.test.ts +107 -0
- package/src/uploads-http.test.ts +6 -4
- package/src/uploads.ts +23 -4
- 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 +165 -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,56 @@
|
|
|
1
|
+
// 2026-10-31 —— license 三态契约。
|
|
2
|
+
//
|
|
3
|
+
// 四条断言对应四种输入,第四种(查询失败)在旧实现里会直接 500 掉整个 /health:
|
|
4
|
+
// known : 有行且有 type
|
|
5
|
+
// absent : 查询成功、无行
|
|
6
|
+
// unknown: 有行但 type 空(数据不全)—— 修法与 absent 不同
|
|
7
|
+
// unknown: 查询失败 —— 修法与 absent 不同,且**不许拖垮 /health**
|
|
8
|
+
|
|
9
|
+
import { describe, expect, test } from "bun:test";
|
|
10
|
+
import { legacyLicenseField, licenseStateOf } from "./license-state";
|
|
11
|
+
|
|
12
|
+
describe("licenseStateOf", () => {
|
|
13
|
+
test("known: a row with a non-empty type", () => {
|
|
14
|
+
expect(licenseStateOf({ type: "pro" })).toEqual({ kind: "known", type: "pro" });
|
|
15
|
+
expect(licenseStateOf({ type: " team " })).toEqual({ kind: "known", type: "team" });
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
test("absent: query succeeded and there is no row", () => {
|
|
19
|
+
expect(licenseStateOf(null)).toEqual({ kind: "absent" });
|
|
20
|
+
expect(licenseStateOf(undefined)).toEqual({ kind: "absent" });
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
test("unknown(row_without_type): a row exists but the type is empty — different fix from absent", () => {
|
|
24
|
+
expect(licenseStateOf({ type: "" })).toEqual({ kind: "unknown", reason: "license_row_without_type" });
|
|
25
|
+
expect(licenseStateOf({ type: " " })).toEqual({ kind: "unknown", reason: "license_row_without_type" });
|
|
26
|
+
expect(licenseStateOf({})).toEqual({ kind: "unknown", reason: "license_row_without_type" });
|
|
27
|
+
expect(licenseStateOf({ type: 42 })).toEqual({ kind: "unknown", reason: "license_row_without_type" });
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
test("unknown(query_failed) wins over the row — a failed query tells us nothing about the row", () => {
|
|
31
|
+
expect(licenseStateOf({ type: "pro" }, true)).toEqual({ kind: "unknown", reason: "license_query_failed" });
|
|
32
|
+
expect(licenseStateOf(null, true)).toEqual({ kind: "unknown", reason: "license_query_failed" });
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
test("the three states are mutually exclusive — no input yields two of them", () => {
|
|
36
|
+
const kinds = new Set([
|
|
37
|
+
licenseStateOf({ type: "pro" }).kind,
|
|
38
|
+
licenseStateOf(null).kind,
|
|
39
|
+
licenseStateOf({ type: "" }).kind,
|
|
40
|
+
licenseStateOf(null, true).kind,
|
|
41
|
+
]);
|
|
42
|
+
// known / absent / unknown —— 只有三种 kind,且 unknown 有两条不同 reason
|
|
43
|
+
expect([...kinds].sort()).toEqual(["absent", "known", "unknown"]);
|
|
44
|
+
});
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
describe("legacyLicenseField", () => {
|
|
48
|
+
test("stays byte-identical to the old expression for every input", () => {
|
|
49
|
+
expect(legacyLicenseField({ type: "pro" })).toBe("pro");
|
|
50
|
+
expect(legacyLicenseField({ type: "" })).toBe("none");
|
|
51
|
+
expect(legacyLicenseField({})).toBe("none");
|
|
52
|
+
expect(legacyLicenseField(null)).toBe("none");
|
|
53
|
+
// 非字符串 type 旧实现也回 "none"(`license?.type || "none"` 的真值语义)
|
|
54
|
+
expect(legacyLicenseField({ type: 0 as unknown })).toBe("none");
|
|
55
|
+
});
|
|
56
|
+
});
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
// 2026-10-31 —— `license` 字段的三值化。
|
|
2
|
+
//
|
|
3
|
+
// 现状:`/health` 只给 `license: license?.type || "none"`。
|
|
4
|
+
// 而 "none" 同时覆盖三种不同的事:
|
|
5
|
+
// · 查询成功、确实没有 license 行 → 去授权能修
|
|
6
|
+
// · 查询成功、有行但 type 为空/缺失 → 数据不全,补行能修
|
|
7
|
+
// · 查询失败 → 补一次取数能修
|
|
8
|
+
//
|
|
9
|
+
// ⇒ 三种的**修法不同**,却共用一个字符串。这正是那条:
|
|
10
|
+
// 「空值折叠的方向,总是朝着『让你继续往下走』」—— 这里的方向是「当成没有授权」。
|
|
11
|
+
//
|
|
12
|
+
// 🔴 absent 与 unknown 的区别是**谁能修**:
|
|
13
|
+
// absent = 我们知道它不在(改配置/去授权)
|
|
14
|
+
// unknown = 没人去看 / 看失败了(补一次取数)
|
|
15
|
+
// 混成一个值之后,修法也一起混了。
|
|
16
|
+
//
|
|
17
|
+
// 兼容:`license` 字段保留一个版本(语义不精确,勿用于判据),
|
|
18
|
+
// 判据请用 `license_state`。等外部读者迁移完再下线旧字段。
|
|
19
|
+
|
|
20
|
+
export type LicenseState =
|
|
21
|
+
| { kind: "known"; type: string }
|
|
22
|
+
| { kind: "absent" }
|
|
23
|
+
| { kind: "unknown"; reason: "license_query_failed" | "license_row_without_type" };
|
|
24
|
+
|
|
25
|
+
export interface LicenseRow {
|
|
26
|
+
type?: unknown;
|
|
27
|
+
expires_at?: unknown;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* 纯函数:把「一次查询的结果」映射成三态。
|
|
32
|
+
*
|
|
33
|
+
* @param row 查询到的行;null/undefined 表示查询成功但没有行
|
|
34
|
+
* @param failed 查询是否抛错(抛错时 row 无意义)
|
|
35
|
+
*/
|
|
36
|
+
export function licenseStateOf(row: LicenseRow | null | undefined, failed = false): LicenseState {
|
|
37
|
+
if (failed) return { kind: "unknown", reason: "license_query_failed" };
|
|
38
|
+
if (!row) return { kind: "absent" };
|
|
39
|
+
const type = typeof row.type === "string" ? row.type.trim() : "";
|
|
40
|
+
if (!type) return { kind: "unknown", reason: "license_row_without_type" };
|
|
41
|
+
return { kind: "known", type };
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** 兼容字段的渲染(保持与旧行为逐字相同,便于逐步下线)。 */
|
|
45
|
+
export function legacyLicenseField(row: LicenseRow | null | undefined): string {
|
|
46
|
+
const type = row && typeof row.type === "string" ? row.type : "";
|
|
47
|
+
return type || "none";
|
|
48
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
// #3309 读数覆盖第十批 —— 两条此前在测试里一次都没出现过的 error:
|
|
2
|
+
//
|
|
3
|
+
// restart_node : adopted_restart_requires_daemon
|
|
4
|
+
// start_node : forbidden_cross_tenant
|
|
5
|
+
//
|
|
6
|
+
// 第一条是「adopted 节点不能被 restart」:binding 证明的是 stop/start 授权,
|
|
7
|
+
// 不是 exit-75 supervisor 能力 —— 代码里这段注释写得很清楚,但此前没有任何测试走过它。
|
|
8
|
+
// 这条特别值得钉住,因为它是**「有权限做 A 不等于有权限做 B」**的一个具体实例:
|
|
9
|
+
// 同一个 binding 让 stop/start 可用,却让 restart 必须拒绝。
|
|
10
|
+
//
|
|
11
|
+
// ⚠ 没测 daemon_cross_tenant:那需要「daemon 与 child 分属不同网络」的夹具,
|
|
12
|
+
// 而 resolveTargetNode 本身会在采到那种行之前就按网络拦掉 —— 要造出来只能伪造
|
|
13
|
+
// 一个正常路径不会产生的状态。留在待补清单里,不在这里假装覆盖。
|
|
14
|
+
import { afterAll, beforeEach, describe, expect, test } from "bun:test";
|
|
15
|
+
import { db } from "./db.js";
|
|
16
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
17
|
+
import { registerTools } from "./tools.js";
|
|
18
|
+
|
|
19
|
+
const NET = "net_10th_err";
|
|
20
|
+
const OWNER = "u_10th_owner";
|
|
21
|
+
const DAEMON = "node_10th_daemon";
|
|
22
|
+
const ADOPTED = "node_10th_adopted";
|
|
23
|
+
|
|
24
|
+
type ToolHandler = (args: any) => Promise<{ content: Array<{ type: "text"; text: string }> }>;
|
|
25
|
+
|
|
26
|
+
function handlers(): Record<string, ToolHandler> {
|
|
27
|
+
const server = new McpServer({ name: "t", version: "0" }) as any;
|
|
28
|
+
const out: Record<string, ToolHandler> = {};
|
|
29
|
+
const orig = server.tool.bind(server);
|
|
30
|
+
server.tool = (n: string, d: string, s: any, h: ToolHandler) => { out[n] = h; return orig(n, d, s, h); };
|
|
31
|
+
registerTools(server, undefined, NET, OWNER, null, false, null);
|
|
32
|
+
return out;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
async function call(name: string, args: Record<string, unknown>) {
|
|
36
|
+
const r = await handlers()[name](args);
|
|
37
|
+
return JSON.parse(r.content[0].text) as { ok?: boolean; error?: string; [k: string]: unknown };
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function cleanup() {
|
|
41
|
+
for (const t of ["node_daemon_bindings", "node_create_requests", "nodes", "network_members"]) {
|
|
42
|
+
try { db.run(`DELETE FROM ${t} WHERE network_id = ?1`, [NET]); } catch {}
|
|
43
|
+
}
|
|
44
|
+
try { db.run("DELETE FROM networks WHERE network_id = ?1", [NET]); } catch {}
|
|
45
|
+
try { db.run("DELETE FROM users WHERE user_id = ?1", [OWNER]); } catch {}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
function node(node_id: string, alias: string, snapshot: Record<string, unknown> | null) {
|
|
49
|
+
db.run(
|
|
50
|
+
`INSERT INTO nodes (node_id, node_name, alias, network_id, runtime, model, channels, config_snapshot,
|
|
51
|
+
hostname, created_at, updated_at, lifecycle_state)
|
|
52
|
+
VALUES (?1, ?2, ?2, ?3, 'opencode-cli', 'm', '[]', ?4, 'host-x', datetime('now'), datetime('now'), 'active')`,
|
|
53
|
+
[node_id, alias, NET, snapshot ? JSON.stringify(snapshot) : null],
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function seed() {
|
|
58
|
+
cleanup();
|
|
59
|
+
db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))", [OWNER]);
|
|
60
|
+
db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))", [NET, OWNER]);
|
|
61
|
+
db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))", [OWNER, NET]);
|
|
62
|
+
node(DAEMON, "10th-daemon", { role: "host_supervisor" });
|
|
63
|
+
node(ADOPTED, "10th-adopted", null);
|
|
64
|
+
// adopted 的判据:有 **active** binding,且不是 created(没有 cr_ 记录)
|
|
65
|
+
db.run(
|
|
66
|
+
`INSERT INTO node_daemon_bindings (request_id, network_id, node_id, daemon_node_id, workdir,
|
|
67
|
+
requested_by, status, created_at, updated_at)
|
|
68
|
+
VALUES ('ndb_10th', ?1, ?2, ?3, '/tmp', ?4, 'active', ?5, ?5)`,
|
|
69
|
+
[NET, ADOPTED, DAEMON, OWNER, Date.now()],
|
|
70
|
+
);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
beforeEach(seed);
|
|
74
|
+
afterAll(cleanup);
|
|
75
|
+
|
|
76
|
+
describe("#3309 restart_node / start_node 的两条拒绝", () => {
|
|
77
|
+
test("adopted 节点(binding 证明的是 stop/start 授权)⇒ restart 必须拒", async () => {
|
|
78
|
+
const r = await call("restart_node", { node_id: ADOPTED });
|
|
79
|
+
expect(r.ok).toBe(false);
|
|
80
|
+
expect(r.error).toBe("adopted_restart_requires_daemon");
|
|
81
|
+
// 提示必须给出**替代动作**(Stop → Start),否则读的人只知道被拒。
|
|
82
|
+
expect(String(r.message)).toContain("Stop");
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
test("反向:supervisor 节点(created/role=host_supervisor)不会被这条挡", async () => {
|
|
86
|
+
const r = await call("restart_node", { node_id: DAEMON });
|
|
87
|
+
// 会不会成功取决于后续的生命周期校验,但**不该**是 adopted 这条。
|
|
88
|
+
expect(r.error).not.toBe("adopted_restart_requires_daemon");
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
test("start_node 对不存在的 node ⇒ **第三次值** daemon_not_resolvable(不是我猜的两个)", async () => {
|
|
92
|
+
// 我原本以为这里是 forbidden_cross_tenant 或 node_not_found —— 实测都不是。
|
|
93
|
+
// 这是本组测试里唯一一次「期望值被真实调用纠正」:猜错的那个值(daemon_not_resolvable)
|
|
94
|
+
// 是一个此前没人写过的形状,而它恰好说明 start_node 的**第一道**门是「能不能解析出 daemon」,
|
|
95
|
+
// 而不是「这个 node 存不存在」。
|
|
96
|
+
const r = await call("start_node", { node_id: "node_not_in_my_networks" });
|
|
97
|
+
expect(r.ok).toBe(false);
|
|
98
|
+
expect(r.error).toBe("daemon_not_resolvable");
|
|
99
|
+
expect(r.error).not.toBe("node_not_found");
|
|
100
|
+
});
|
|
101
|
+
|
|
102
|
+
test("两条载荷都没有 code 字段(现状,不是契约)", async () => {
|
|
103
|
+
const replies = [await call("restart_node", { node_id: ADOPTED }), await call("start_node", { node_id: "node_nope" })];
|
|
104
|
+
for (const r of replies) {
|
|
105
|
+
expect(r.ok).toBe(false);
|
|
106
|
+
expect(Object.prototype.hasOwnProperty.call(r, "code")).toBe(false);
|
|
107
|
+
}
|
|
108
|
+
});
|
|
109
|
+
});
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
// #3309 读数覆盖第七批 —— 两个 error 字面量此前在测试里一次都没出现过:
|
|
2
|
+
//
|
|
3
|
+
// list_tasks : durable_cursor_required
|
|
4
|
+
// ack_inbox : message not found or already acknowledged
|
|
5
|
+
//
|
|
6
|
+
// 两条都是「调用协议用错了」,而不是「权限/状态不对」:
|
|
7
|
+
// durable_cursor_required ⇒ 打开了「按序号读终态日志」这个模式,却没给游标
|
|
8
|
+
// (这只在 durable_terminal_cursor=true 时才要求,
|
|
9
|
+
// 所以它是一条**条件性必需参数**的错误)
|
|
10
|
+
// already acknowledged ⇒ 这条消息已经被 ack 过(或 id 根本不在你的待办里)
|
|
11
|
+
//
|
|
12
|
+
// ⚠ 故意没测 `ack_inbox` 的第二个出口 "message not found or not yours":
|
|
13
|
+
// 它只在「SELECT 找到了、UPDATE 影响 0 行」时发生,也就是**并发**下另一个
|
|
14
|
+
// ack 抢先提交的那一刻。本仓没有可注入的并发点,造一个不算真。
|
|
15
|
+
import { afterAll, beforeEach, describe, expect, test } from "bun:test";
|
|
16
|
+
import { db } from "./db.js";
|
|
17
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
18
|
+
import { registerTools } from "./tools.js";
|
|
19
|
+
|
|
20
|
+
const NET = "net_7th_err";
|
|
21
|
+
const USER = "u_7th_user";
|
|
22
|
+
const ALIAS = "7th-node";
|
|
23
|
+
|
|
24
|
+
type ToolHandler = (args: any) => Promise<{ content: Array<{ type: "text"; text: string }> }>;
|
|
25
|
+
|
|
26
|
+
function handlers(): Record<string, ToolHandler> {
|
|
27
|
+
const server = new McpServer({ name: "t", version: "0" }) as any;
|
|
28
|
+
const out: Record<string, ToolHandler> = {};
|
|
29
|
+
const orig = server.tool.bind(server);
|
|
30
|
+
server.tool = (n: string, d: string, s: any, h: ToolHandler) => { out[n] = h; return orig(n, d, s, h); };
|
|
31
|
+
registerTools(server, undefined, NET, USER, ALIAS, false, null);
|
|
32
|
+
return out;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
async function call(name: string, args: Record<string, unknown>) {
|
|
36
|
+
const r = await handlers()[name](args);
|
|
37
|
+
return JSON.parse(r.content[0].text) as { ok?: boolean; error?: string; [k: string]: unknown };
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function cleanup() {
|
|
41
|
+
try { db.run("DELETE FROM inbox WHERE network_id = ?1", [NET]); } catch {}
|
|
42
|
+
try { db.run("DELETE FROM network_members WHERE network_id = ?1", [NET]); } catch {}
|
|
43
|
+
try { db.run("DELETE FROM networks WHERE network_id = ?1", [NET]); } catch {}
|
|
44
|
+
try { db.run("DELETE FROM users WHERE user_id = ?1", [USER]); } catch {}
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function seed() {
|
|
48
|
+
cleanup();
|
|
49
|
+
db.run("INSERT INTO users (user_id, username, password_hash, role, created_at) VALUES (?1, ?1, 'x', 'user', datetime('now'))", [USER]);
|
|
50
|
+
db.run("INSERT INTO networks (network_id, network_name, owner_id, created_at) VALUES (?1, ?1, ?2, datetime('now'))", [NET, USER]);
|
|
51
|
+
db.run("INSERT INTO network_members (user_id, network_id, role, joined_at) VALUES (?1, ?2, 'owner', datetime('now'))", [USER, NET]);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function seedInbox(acked: number) {
|
|
55
|
+
db.run(
|
|
56
|
+
`INSERT INTO inbox (id, session_name, type, content, created_at, acked, network_id)
|
|
57
|
+
VALUES ('inbox_7th_1', ?1, 'message', 'hello', ?2, ?3, ?4)`,
|
|
58
|
+
[ALIAS, Date.now(), acked, NET],
|
|
59
|
+
);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
beforeEach(seed);
|
|
63
|
+
afterAll(cleanup);
|
|
64
|
+
|
|
65
|
+
describe("#3309 list_tasks / ack_inbox 的错误值域", () => {
|
|
66
|
+
test("durable_terminal_cursor=true 但没给 durable_cursor ⇒ durable_cursor_required", async () => {
|
|
67
|
+
const r = await call("list_tasks", { durable_terminal_cursor: true });
|
|
68
|
+
expect(r.ok).toBe(false);
|
|
69
|
+
expect(r.error).toBe("durable_cursor_required");
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
test("不给 durable_terminal_cursor 时不要求游标(条件性必需)", async () => {
|
|
73
|
+
// ⚠ 本 harness 直接调 handler,**绕过了 zod** ⇒ `.default(20)` 不会生效。
|
|
74
|
+
// 第一次没给 limit,SQL 里 `LIMIT ?` 绑到 undefined ⇒ SQLITE_MISMATCH。
|
|
75
|
+
// 那是夹具的事,不是产品的事 —— 所以这里显式补上默认值。
|
|
76
|
+
const r = await call("list_tasks", { limit: 20 });
|
|
77
|
+
// 这条不是为了「成功」,而是为了证明上一条是**条件**触发的:
|
|
78
|
+
// 若改成无条件要求游标,这条会红。
|
|
79
|
+
expect(r.ok).toBe(true);
|
|
80
|
+
});
|
|
81
|
+
|
|
82
|
+
test("ack 一条已 ack 过的消息 ⇒ message not found or already acknowledged", async () => {
|
|
83
|
+
seedInbox(1);
|
|
84
|
+
const r = await call("ack_inbox", { alias: ALIAS, message_id: "inbox_7th_1" });
|
|
85
|
+
expect(r.ok).toBe(false);
|
|
86
|
+
expect(r.error).toBe("message not found or already acknowledged");
|
|
87
|
+
});
|
|
88
|
+
|
|
89
|
+
test("ack 一个根本不存在的 id ⇒ 同一句(两种成因**故意**不区分)", async () => {
|
|
90
|
+
seedInbox(0);
|
|
91
|
+
const r = await call("ack_inbox", { alias: ALIAS, message_id: "inbox_7th_does_not_exist" });
|
|
92
|
+
expect(r.ok).toBe(false);
|
|
93
|
+
// 「没见过这个 id」与「已经 ack 过」对调用方是同一种处置:不要重试。
|
|
94
|
+
// 而服务端**不区分**它们是有意的(避免用错误码探测别人有没有这条消息)。
|
|
95
|
+
expect(r.error).toBe("message not found or already acknowledged");
|
|
96
|
+
});
|
|
97
|
+
|
|
98
|
+
test("两条载荷都没有 code 字段(现状,不是契约)", async () => {
|
|
99
|
+
const replies = [
|
|
100
|
+
await call("list_tasks", { durable_terminal_cursor: true, limit: 20 }),
|
|
101
|
+
await call("ack_inbox", { alias: ALIAS, message_id: "inbox_7th_nope" }),
|
|
102
|
+
];
|
|
103
|
+
for (const r of replies) {
|
|
104
|
+
expect(r.ok).toBe(false);
|
|
105
|
+
expect(Object.prototype.hasOwnProperty.call(r, "code")).toBe(false);
|
|
106
|
+
}
|
|
107
|
+
});
|
|
108
|
+
});
|
|
@@ -40,6 +40,7 @@ function cleanup() {
|
|
|
40
40
|
try { db.run("DELETE FROM users WHERE user_id LIKE 'u_lhs_%'"); } catch {}
|
|
41
41
|
}
|
|
42
42
|
|
|
43
|
+
// Each case starts empty; plain INSERT keeps these fixtures portable to PostgreSQL.
|
|
43
44
|
beforeEach(cleanup);
|
|
44
45
|
afterAll(cleanup);
|
|
45
46
|
|
|
@@ -52,7 +53,7 @@ function seedUser(user_id: string) {
|
|
|
52
53
|
}
|
|
53
54
|
function seedNetwork(net_id: string, owner_id = "u_lhs_owner") {
|
|
54
55
|
db.run(
|
|
55
|
-
`INSERT
|
|
56
|
+
`INSERT INTO networks (network_id, network_name, owner_id, created_at)
|
|
56
57
|
VALUES (?1, ?2, ?3, datetime('now'))`,
|
|
57
58
|
[net_id, net_id, owner_id],
|
|
58
59
|
);
|
|
@@ -81,7 +82,7 @@ function seedDaemon(opts: {
|
|
|
81
82
|
allowed_secret_keys: opts.secrets ?? [],
|
|
82
83
|
});
|
|
83
84
|
db.run(
|
|
84
|
-
`INSERT
|
|
85
|
+
`INSERT INTO nodes (
|
|
85
86
|
node_id, node_name, alias, network_id,
|
|
86
87
|
runtimes_supported, allowed_secret_keys,
|
|
87
88
|
config_snapshot, hostname,
|
|
@@ -95,14 +96,14 @@ function seedDaemon(opts: {
|
|
|
95
96
|
if (opts.sessionAgeMs !== undefined) {
|
|
96
97
|
const ts = new Date(Date.now() - opts.sessionAgeMs).toISOString().replace("T", " ").replace(/\..+/, "");
|
|
97
98
|
db.run(
|
|
98
|
-
`INSERT
|
|
99
|
+
`INSERT INTO sessions (resume_id, alias, network_id, last_seen_at, status, cpu_cores, mem_total_gb, ip)
|
|
99
100
|
VALUES (?1, ?2, ?3, ?4, 'idle', 8, 16, '10.0.0.5')`,
|
|
100
101
|
[`s_${node_id}`, opts.alias, opts.network_id, ts],
|
|
101
102
|
);
|
|
102
103
|
}
|
|
103
104
|
if (opts.mintToken !== false && !opts.tokenDeleted) {
|
|
104
105
|
db.run(
|
|
105
|
-
`INSERT
|
|
106
|
+
`INSERT INTO api_tokens (token_id, user_id, network_id, scope, name, token_hash, expires_at, revoked_at)
|
|
106
107
|
VALUES (?1, ?2, ?3, 'network', ?4, ?5, NULL, ?6)`,
|
|
107
108
|
[`tok_${node_id}`, `u_seed_${node_id}`, opts.network_id, `node:${opts.alias}`,
|
|
108
109
|
`hash_${node_id}`,
|
|
@@ -180,6 +181,16 @@ describe("list_host_supervisors HANDLER tests (RFC-026 §9.2, PR2 v2)", () => {
|
|
|
180
181
|
const handler = buildToolHandler(userA);
|
|
181
182
|
const reply = await callList(handler, { network_id: NET_ALPHA });
|
|
182
183
|
expect(reply.ok).toBe(true);
|
|
184
|
+
// 2026-10-31 —— **精确键集**(#3171):这条响应此前只断言了 daemons[].alias,
|
|
185
|
+
// 于是「多给一个顶层键」不会被发现 —— 而这是个按网络隔离的列表,多给一格就是泄露。
|
|
186
|
+
// 实际三键(我第一版漏了 count —— 断言当场纠正)。
|
|
187
|
+
// ⚠️ 这条预期值来自**实现**(读实际响应),不是来自规格 —— 它是变更探测器,不是契约。
|
|
188
|
+
// 契约来源是 RFC-026 §P2-A 的验收行(`count=2`)与它的示例;
|
|
189
|
+
// 2026-10-31 实测发现**两份不一致**(示例漏了 count),已把示例补上。
|
|
190
|
+
// ⇒ 判据:一条键集断言的依据必须能指到「哪一份规格/哪一次观测」;
|
|
191
|
+
// 指不到,它只能防变化,不能证明正确。
|
|
192
|
+
expect(Object.keys(reply).sort()).toEqual(["count", "daemons", "ok"]);
|
|
193
|
+
expect((reply as any).count).toBe(2); // 与 RFC §P2-A 的验收行同值
|
|
183
194
|
const aliases = (reply.daemons ?? []).map(d => d.alias).sort();
|
|
184
195
|
expect(aliases).toEqual(["alpha-daemon-1", "alpha-daemon-2"]);
|
|
185
196
|
});
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
// #476(#469 MCP 审计的最后一项)—— Hub MCP 面的上下文成本。
|
|
2
|
+
//
|
|
3
|
+
// 钉住:
|
|
4
|
+
// 1. tools/list 的总字节有上限(TOOLS_LIST_MAX_BYTES):描述 / 参数说明不能悄悄长回去。每个工具也有上限,
|
|
5
|
+
// 单条工具描述有上限。要加新工具 / 新说明,改这里的数字 —— 改的时候就会被看见。
|
|
6
|
+
// 2. requirements_events 不带 requirement_id(全网动态)默认 50 条、从新到旧、next_cursor 翻更早的;
|
|
7
|
+
// 带 requirement_id 的单卡调用不变(默认 200);REST /api/requirements/events 不变(默认 200,App 用它)。
|
|
8
|
+
// 3. requirements_events 参数严格:不认识的参数 → -32602,列出能用的参数。
|
|
9
|
+
//
|
|
10
|
+
// 跑法:cd server && COMMHUB_DB=/tmp/x.db bun test src/mcp-context-cost-http.test.ts
|
|
11
|
+
// PG:COMMHUB_TEST_PG_URL=… COMMHUB_PG_EXPERIMENTAL=1(tests/test2123-hub-postgres-ladder 里注册)
|
|
12
|
+
import { afterAll, beforeAll, describe, expect, test } from "bun:test";
|
|
13
|
+
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
|
|
14
|
+
import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
|
|
15
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
16
|
+
import { register } from "./auth.js";
|
|
17
|
+
import { registerTools } from "./tools.js";
|
|
18
|
+
|
|
19
|
+
const activeDbPath = process.env.COMMHUB_DB ?? (process.env.COMMHUB_TEST_PG_URL ? "postgres" : undefined);
|
|
20
|
+
if (!activeDbPath) throw new Error("mcp-context-cost requires COMMHUB_DB (or COMMHUB_TEST_PG_URL) before module import");
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* tools/list 整份 JSON 的字节上限。#476 之前(main,含 #475)74 个工具 76,824 B;修剪后 71,399 B。
|
|
24
|
+
* #478 起 tools/list 按调用者给:这里的调用者是用户令牌,看到 56 个工具 54,780 B(不含节点 / 协议工具)。
|
|
25
|
+
* 上限跟着收到用户这一档(~1.7 KB 余量);节点 / 全部工具的上限在 tool-audience-http.test.ts。
|
|
26
|
+
* 加工具或加说明超过它,就在这里改数字并在 PR 里说为什么。
|
|
27
|
+
*/
|
|
28
|
+
// Board #625: two human adoption tools; measured 58 tools / 56,615 B.
|
|
29
|
+
// Hub #938 clone_node is audience both (60 tools / 58,169 B). OpenCode V2
|
|
30
|
+
// catalog adds read_opencode_catalog and get_opencode_catalog on that user
|
|
31
|
+
// list. Measured together: 62 tools / 59,409 B. Ceiling keeps ~401 B.
|
|
32
|
+
// #1894(2026-10-23):新增 `departments` 一个工具(组织架构的 list/create/update/
|
|
33
|
+
// delete/assign_agent 合并成一个,避免 5 个工具把上下文顶穿)。实测 63 个工具
|
|
34
|
+
// 60,089 B,比原上限高 279 B —— 这是**有意的功能增长**,不是描述悄悄变长,
|
|
35
|
+
// 所以显式抬到 60_500(留 411 B 余量)并在同一行写清理由。
|
|
36
|
+
const TOOLS_LIST_MAX_BYTES = 60_500;
|
|
37
|
+
/** 单个工具(名字 + 描述 + 输入 schema)的上限;最大的是 report_status(节点心跳,~8.4 KB 的遥测结构)。 */
|
|
38
|
+
const TOOL_MAX_BYTES = 9_000;
|
|
39
|
+
/** 单条工具描述的上限(说明写进参数的 describe,或者拆短)。 */
|
|
40
|
+
const DESCRIPTION_MAX_BYTES = 1_000;
|
|
41
|
+
const NETWORK_EVENTS = 80;
|
|
42
|
+
|
|
43
|
+
let server: any;
|
|
44
|
+
let base = "";
|
|
45
|
+
let token = "", netId = "";
|
|
46
|
+
let close: () => Promise<void>;
|
|
47
|
+
let client: Client;
|
|
48
|
+
const call = async (name: string, args: Record<string, unknown>) => {
|
|
49
|
+
const r: any = await client.callTool({ name, arguments: args });
|
|
50
|
+
const text = String(r.content?.[0]?.text ?? "");
|
|
51
|
+
return r.isError ? { mcpError: true, text } : { ...JSON.parse(text), _bytes: Buffer.byteLength(text, "utf8") };
|
|
52
|
+
};
|
|
53
|
+
let busyId = "";
|
|
54
|
+
|
|
55
|
+
beforeAll(async () => {
|
|
56
|
+
const u = register(`ctx_${Date.now()}`, "CtxCost123!", undefined, "seed");
|
|
57
|
+
token = u.token!; netId = u.network_id!;
|
|
58
|
+
const s = new McpServer({ name: "ctx", version: "1" });
|
|
59
|
+
registerTools(s, undefined, null, u.user!.user_id, u.user!.username, false, "tok_user");
|
|
60
|
+
client = new Client({ name: "ctx-client", version: "1" });
|
|
61
|
+
const [ct, st] = InMemoryTransport.createLinkedPair();
|
|
62
|
+
await s.connect(st);
|
|
63
|
+
await client.connect(ct);
|
|
64
|
+
close = async () => { await client.close(); await s.close(); };
|
|
65
|
+
const mod: any = await import("./server.js");
|
|
66
|
+
server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
|
|
67
|
+
base = `http://127.0.0.1:${server.port}`;
|
|
68
|
+
// 一张卡上 60 条评论(单卡调用要能拿到 > 50 条),再加 20 张卡各一条
|
|
69
|
+
const busy = await call("requirements_create", { network_id: netId, name: "busy task" });
|
|
70
|
+
busyId = busy.requirement.id;
|
|
71
|
+
for (let i = 0; i < 60; i++) expect((await call("requirements_comment", { network_id: netId, id: busyId, text: `进展 ${i}:这一步完成了` })).ok).toBe(true);
|
|
72
|
+
for (let i = 0; i < NETWORK_EVENTS - 60; i++) {
|
|
73
|
+
const r = await call("requirements_create", { network_id: netId, name: `task ${i}` });
|
|
74
|
+
await call("requirements_comment", { network_id: netId, id: r.requirement.id, text: "已开始" });
|
|
75
|
+
}
|
|
76
|
+
}, 120_000);
|
|
77
|
+
afterAll(async () => { await close?.(); server?.stop?.(true); });
|
|
78
|
+
|
|
79
|
+
describe("#476 tools/list size", () => {
|
|
80
|
+
test("total, per tool and per description stay under their ceilings", async () => {
|
|
81
|
+
const { tools } = await client.listTools();
|
|
82
|
+
const total = Buffer.byteLength(JSON.stringify({ tools }), "utf8");
|
|
83
|
+
const sizes = tools.map((t: any) => ({ name: t.name, all: Buffer.byteLength(JSON.stringify(t)), desc: Buffer.byteLength(t.description ?? "") }));
|
|
84
|
+
sizes.sort((a, b) => b.all - a.all);
|
|
85
|
+
console.log(`tools/list: ${tools.length} tools, ${total} B; largest ${sizes.slice(0, 3).map(x => `${x.name}=${x.all}`).join(", ")}`);
|
|
86
|
+
expect(total).toBeLessThanOrEqual(TOOLS_LIST_MAX_BYTES);
|
|
87
|
+
for (const x of sizes) {
|
|
88
|
+
expect(x.all, x.name).toBeLessThanOrEqual(TOOL_MAX_BYTES);
|
|
89
|
+
expect(x.desc, x.name).toBeLessThanOrEqual(DESCRIPTION_MAX_BYTES);
|
|
90
|
+
}
|
|
91
|
+
});
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
describe("#476 requirements_events defaults", () => {
|
|
95
|
+
test("network-wide: 50 newest by default, next_cursor pages older events", async () => {
|
|
96
|
+
const p1 = await call("requirements_events", { network_id: netId });
|
|
97
|
+
expect(p1.events.length).toBe(50);
|
|
98
|
+
expect(typeof p1.next_cursor).toBe("string");
|
|
99
|
+
const times = p1.events.map((e: any) => e.at ?? e.created_at);
|
|
100
|
+
expect([...times].sort().reverse()).toEqual(times);
|
|
101
|
+
const p2 = await call("requirements_events", { network_id: netId, cursor: p1.next_cursor });
|
|
102
|
+
const ids = new Set([...p1.events, ...p2.events].map((e: any) => e.id));
|
|
103
|
+
expect(ids.size).toBe(p1.events.length + p2.events.length);
|
|
104
|
+
console.log(`network events page of 50: ${p1._bytes} B`);
|
|
105
|
+
expect(p1._bytes).toBeLessThan(25_000);
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
test("an explicit limit still wins; one task's timeline keeps its old default (200)", async () => {
|
|
109
|
+
expect((await call("requirements_events", { network_id: netId, limit: 70 })).events.length).toBe(70);
|
|
110
|
+
const one = await call("requirements_events", { network_id: netId, requirement_id: busyId });
|
|
111
|
+
expect(one.events.filter((e: any) => e.kind === "comment").length).toBe(60);
|
|
112
|
+
});
|
|
113
|
+
|
|
114
|
+
test("REST GET /api/requirements/events is unchanged (default 200)", async () => {
|
|
115
|
+
const res = await fetch(`${base}/api/requirements/events?network_id=${netId}`, { headers: { Authorization: `Bearer ${token}` } });
|
|
116
|
+
const body = await res.json() as any;
|
|
117
|
+
expect(res.status).toBe(200);
|
|
118
|
+
expect(body.events.length).toBeGreaterThan(50);
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
test("unknown parameters → -32602 listing the valid ones", async () => {
|
|
122
|
+
const r = await call("requirements_events", { network_id: netId, task_id: busyId });
|
|
123
|
+
expect(r.mcpError).toBe(true);
|
|
124
|
+
expect(r.text).toContain("-32602");
|
|
125
|
+
expect(r.text).toContain("unknown parameter(s): task_id; valid parameters: network_id, requirement_id, since, limit, cursor");
|
|
126
|
+
});
|
|
127
|
+
});
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
// #2363 —— MCP 在飞计数的单测 + 源码断言。
|
|
2
|
+
//
|
|
3
|
+
// 计数值本身很小,但它是“RSS 尖峰能不能被解释”的唯一在线指标:`sse_connections`
|
|
4
|
+
// 只反映长连接,看不到同秒打进来的一批短请求。这里钉住三件事:
|
|
5
|
+
// 1. enter/leave 必须配平(含重复 leave 不把计数打成负数);
|
|
6
|
+
// 2. 峰值要能记住高水位,并能被显式重置;
|
|
7
|
+
// 3. server.ts 必须在**任何 await 之前**进入计数,并且在“正常关闭 / 抛异常”
|
|
8
|
+
// 两条路径上都退出计数——少一条就会让指标永远偏高,比没有指标更糟。
|
|
9
|
+
|
|
10
|
+
import { describe, expect, test, beforeEach } from "bun:test";
|
|
11
|
+
import { readFileSync } from "node:fs";
|
|
12
|
+
import { join } from "node:path";
|
|
13
|
+
import {
|
|
14
|
+
enterMcpInflight,
|
|
15
|
+
leaveMcpInflight,
|
|
16
|
+
getMcpInflightStats,
|
|
17
|
+
resetMcpInflightPeak,
|
|
18
|
+
} from "./mcp-inflight.js";
|
|
19
|
+
|
|
20
|
+
beforeEach(() => {
|
|
21
|
+
// 模块级单例:每个用例从 0 开始,避免用例顺序影响。
|
|
22
|
+
while (getMcpInflightStats().inflight > 0) leaveMcpInflight();
|
|
23
|
+
resetMcpInflightPeak();
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
describe("#2363 mcp inflight counter", () => {
|
|
27
|
+
test("enter/leave 配平,peak 记住高水位且不自己回落", () => {
|
|
28
|
+
expect(getMcpInflightStats()).toEqual({ inflight: 0, peak: 0 });
|
|
29
|
+
enterMcpInflight();
|
|
30
|
+
enterMcpInflight();
|
|
31
|
+
enterMcpInflight();
|
|
32
|
+
expect(getMcpInflightStats()).toEqual({ inflight: 3, peak: 3 });
|
|
33
|
+
leaveMcpInflight();
|
|
34
|
+
leaveMcpInflight();
|
|
35
|
+
// 当前只有 1 条在飞,但峰值仍是 3 —— 峰值是“撞过悬崖没有”的证据。
|
|
36
|
+
expect(getMcpInflightStats()).toEqual({ inflight: 1, peak: 3 });
|
|
37
|
+
leaveMcpInflight();
|
|
38
|
+
expect(getMcpInflightStats()).toEqual({ inflight: 0, peak: 3 });
|
|
39
|
+
});
|
|
40
|
+
|
|
41
|
+
test("多余的 leave 不会把计数打成负数", () => {
|
|
42
|
+
leaveMcpInflight();
|
|
43
|
+
leaveMcpInflight();
|
|
44
|
+
expect(getMcpInflightStats().inflight).toBe(0);
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
test("reset 把峰值对齐到当前在飞数(不会把峰值压到低于现况)", () => {
|
|
48
|
+
enterMcpInflight();
|
|
49
|
+
enterMcpInflight();
|
|
50
|
+
expect(getMcpInflightStats().peak).toBe(2);
|
|
51
|
+
leaveMcpInflight();
|
|
52
|
+
resetMcpInflightPeak();
|
|
53
|
+
expect(getMcpInflightStats()).toEqual({ inflight: 1, peak: 1 });
|
|
54
|
+
});
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
describe("#2363 server wiring (source assertions)", () => {
|
|
58
|
+
const src = readFileSync(join(import.meta.dir, "server.ts"), "utf8");
|
|
59
|
+
|
|
60
|
+
test("进入计数发生在创建 transport 之前(请求体解析阶段也要计入)", () => {
|
|
61
|
+
const enterAt = src.indexOf("enterMcpInflight();");
|
|
62
|
+
const transportAt = src.indexOf("new WebStandardStreamableHTTPServerTransport({", enterAt);
|
|
63
|
+
expect(enterAt).toBeGreaterThan(0);
|
|
64
|
+
expect(transportAt).toBeGreaterThan(enterAt);
|
|
65
|
+
});
|
|
66
|
+
|
|
67
|
+
test("两条退出路径都在:handleRequest 抛异常时、以及 MCP server 关闭后", () => {
|
|
68
|
+
// 抛异常路径
|
|
69
|
+
expect(src).toContain("settleMcpInflight();\n throw e;");
|
|
70
|
+
// 正常路径(setImmediate 里 close 完成后结算,且重复调用安全)
|
|
71
|
+
expect(src).toContain("mcpServer.close().catch(() => {}).finally(settleMcpInflight)");
|
|
72
|
+
// 幂等闸门:只允许真正减一次
|
|
73
|
+
expect(src).toContain("if (mcpInflightSettled) return;");
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
test("/health 暴露的是聚合值(匿名也安全),且没有 new 的按会话明细", () => {
|
|
77
|
+
expect(src).toContain("mcp_inflight: getMcpInflightStats().inflight,");
|
|
78
|
+
expect(src).toContain("mcp_inflight_peak: getMcpInflightStats().peak,");
|
|
79
|
+
expect(src).not.toContain("mcp_inflight_sessions");
|
|
80
|
+
});
|
|
81
|
+
|
|
82
|
+
test("这一版只观测:/mcp 入口不得出现 429 / 拒绝分支", () => {
|
|
83
|
+
const mcpStart = src.indexOf('if (url.pathname === "/mcp") {');
|
|
84
|
+
const mcpEnd = src.indexOf("// ── #461 SSE network observer stream ──", mcpStart);
|
|
85
|
+
expect(mcpStart).toBeGreaterThan(0);
|
|
86
|
+
expect(mcpEnd).toBeGreaterThan(mcpStart);
|
|
87
|
+
const block = src.slice(mcpStart, mcpEnd);
|
|
88
|
+
expect(block).not.toContain("429");
|
|
89
|
+
expect(block).not.toContain("hub_busy");
|
|
90
|
+
expect(block).not.toContain("Retry-After");
|
|
91
|
+
});
|
|
92
|
+
});
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
// #2363 —— MCP 在飞计数(先只观测,不拦请求)。
|
|
2
|
+
//
|
|
3
|
+
// 为什么需要它:隔离 Hub 上用**生产库副本**实测,RSS 与“同时在飞的 MCP 请求数”
|
|
4
|
+
// 成正比(≈1.2–1.4 MB/条;`send_message` 与 `get_inbox` 同形),而与吞吐无关——
|
|
5
|
+
// 顺序发 3,255 条/60s(≈54 条/秒)时 RSS 稳定在 151–156 MB,而 50/100/200 并发
|
|
6
|
+
// 的峰值是 249/446/689 MB。`/health` 里的 `sse_connections` 只反映长连接,看不到
|
|
7
|
+
// 这个量,所以生产上“为什么 RSS 突然抬到 450 MB”一直只能事后猜。
|
|
8
|
+
//
|
|
9
|
+
// 本模块只做计数与峰值,**不拒绝、不排队、不改任何响应**——限流(有界队列 + 429)
|
|
10
|
+
// 是另一步,需要先有一天的真实分布再定上限。见 docs/runbooks/hub-memory-and-sse.md。
|
|
11
|
+
|
|
12
|
+
let inflight = 0;
|
|
13
|
+
let peak = 0;
|
|
14
|
+
|
|
15
|
+
/** /mcp 进入时调用(在任何 await 之前,保证计入请求体解析阶段)。 */
|
|
16
|
+
export function enterMcpInflight(): void {
|
|
17
|
+
inflight += 1;
|
|
18
|
+
if (inflight > peak) peak = inflight;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/** /mcp 结束时调用(响应对象产出且 MCP server 已关闭);重复调用安全。 */
|
|
22
|
+
export function leaveMcpInflight(): void {
|
|
23
|
+
if (inflight > 0) inflight -= 1;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* 当前在飞数与**自上次 reset 以来的峰值**。
|
|
28
|
+
* 峰值是“滚动高水位”,不会自己回落——运维看它判断是否撞到过悬崖,
|
|
29
|
+
* 看 `inflight` 判断现在是否还在里面。
|
|
30
|
+
*/
|
|
31
|
+
export function getMcpInflightStats(): { inflight: number; peak: number } {
|
|
32
|
+
return { inflight, peak };
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** 把峰值重置为当前在飞数(运维定位完一次尖峰后调用,或测试用)。 */
|
|
36
|
+
export function resetMcpInflightPeak(): void {
|
|
37
|
+
peak = inflight;
|
|
38
|
+
}
|