@sleep2agi/commhub-server 0.9.0-preview.24 → 0.9.0-preview.241
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 +129 -9
- package/bin/commhub.ts +93 -9
- 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 +654 -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 +95 -4
- 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 +52 -2
- package/src/avatar-validate.ts +35 -1
- 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/broadcast-fanout-2721.test.ts +149 -0
- package/src/broadcast-fanout.ts +117 -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 +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 +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 +356 -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 +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 +434 -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 +1264 -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 +132 -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/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/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 +1 -1
- package/src/file-download-authz.test.ts +73 -18
- 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-anon-readers.ts +60 -0
- package/src/health-host-disk-2756.test.ts +71 -0
- package/src/health-redaction.test.ts +1443 -3
- 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 +582 -0
- package/src/hub-provider-config.test.ts +156 -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 +310 -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/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 +165 -0
- package/src/mcp-route-label-http.test.ts +120 -0
- package/src/mcp-write-network-resolution.test.ts +435 -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.test.ts +47 -2
- package/src/node-caller-identity-http.test.ts +1091 -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 +335 -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 +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 +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-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 +102 -9
- 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 +457 -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/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 +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 +295 -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 +443 -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 +122 -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-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 +2116 -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 +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 +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/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 +458 -0
- 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 +5025 -435
- 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 +142 -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 +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 +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 +227 -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 +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 +230 -0
- package/src/tool-audience.ts +127 -0
- package/src/tools-list-json-schema.test.ts +94 -0
- package/src/tools.ts +4310 -419
- package/src/upload-early-reject-guard.test.ts +155 -0
- package/src/uploads-http.test.ts +86 -7
- 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,127 @@
|
|
|
1
|
+
// #478 —— tools/list 按调用者给:只列这个令牌真能用的工具。
|
|
2
|
+
//
|
|
3
|
+
// 以前每个调用者拿到同一份 ~71 KB 的 tools/list:Agent 节点看见只有人能用的工具(项目管理、浏览别的节点的文件 / 日志),
|
|
4
|
+
// 人看见只有节点能用的心跳和 agent-node / daemon 之间的协议工具。这些调用本来就会被拒,只是白白占模型的上下文。
|
|
5
|
+
//
|
|
6
|
+
// 🔴 只改「列出来的」,不改「能不能调」:工具照旧全部注册,tools/call 的结果逐字节不变(隐藏的工具照样回它今天回的那个错误)。
|
|
7
|
+
// 🔴 只藏「一定会被拒」的:判据是处理函数里**不看参数**的那道闸 —— 用户令牌调节点工具一律 network_token_required /
|
|
8
|
+
// node_token_required / caller_not_a_daemon;节点令牌调人的工具一律 user_token_required / node_token_cannot_*;
|
|
9
|
+
// #487 的节点权限只在「不看参数就必拒」时才藏(见 nodeHidden)。看参数才决定的(派活给谁、哪个网络)一律照列。
|
|
10
|
+
// 受限成员(只看授权 Agent)的拒绝取决于传的 network_id,所以不按它藏。
|
|
11
|
+
// 🔴 protocol 类(agent-node / anet daemon 和 Hub 之间的拉取 / 确认)节点令牌能调,但没有模型该调它们:默认不列,
|
|
12
|
+
// 客户端带 `X-Anet-Tools: all`(或 /mcp?tools=all)时照列 —— 调用不受影响,agent-node 本来就按名字直接调、从不 list。
|
|
13
|
+
// 新注册的工具必须在 TOOL_AUDIENCE 里归类(tool-audience-http.test.ts 钉住,漏了就红)。
|
|
14
|
+
|
|
15
|
+
import { NODE_TOOL_CLASS, nodeIdentity, nodePermissionsFlag, broadcastVerdict, humanOnlyVerdict, writeVerdict, type Verdict } from "./node-permissions.js";
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* both —— 人和节点都能调(按参数 / 网络再判的,也算这一类)。
|
|
19
|
+
* node —— 只有节点令牌(用户令牌一律 network_token_required):节点自己的心跳,模型会调,照列给节点。
|
|
20
|
+
* protocol —— 只有节点令牌,而且是 agent-node / daemon 和 Hub 之间的协议(拉请求、确认、运行证据):默认不列,opt-in 才列。
|
|
21
|
+
* user —— 只有人(节点令牌一律被拒)。
|
|
22
|
+
*/
|
|
23
|
+
export type ToolAudience = "both" | "node" | "protocol" | "user";
|
|
24
|
+
|
|
25
|
+
export const TOOL_AUDIENCE: Readonly<Record<string, ToolAudience>> = {
|
|
26
|
+
daemon_provider_snapshot: "user",
|
|
27
|
+
pull_daemon_provider_snapshots: "protocol", ack_daemon_provider_snapshot: "protocol",
|
|
28
|
+
request_adopt_node: "user", unadopt_node: "user",
|
|
29
|
+
get_adopt_request: "protocol", ack_adopt_request: "protocol",
|
|
30
|
+
// ── 节点:用户令牌一律 network_token_required ──
|
|
31
|
+
report_status: "node", org_whoami: "node",
|
|
32
|
+
// #733 定时任务:节点工具(用户令牌一律 network_token_required;人走 REST /api/scheduled-tasks)
|
|
33
|
+
schedule_list: "node", schedule_get: "node", schedule_create: "node", schedule_update: "node",
|
|
34
|
+
schedule_cancel: "node", schedule_run_now: "node", schedule_runs: "node", schedule_batch_interval: "node",
|
|
35
|
+
// ── 协议:用户令牌一律 network_token_required / node_token_required / caller_not_a_daemon ──
|
|
36
|
+
mark_tasks_runtime_submitted: "protocol", mark_tasks_consumed: "protocol",
|
|
37
|
+
get_config_update: "protocol", ack_config_update: "protocol",
|
|
38
|
+
get_rules_file_request: "protocol", ack_rules_file_request: "protocol",
|
|
39
|
+
list_my_pending_create_requests: "protocol", list_my_pending_lifecycle_requests: "protocol", list_my_children: "protocol",
|
|
40
|
+
get_create_request: "protocol", ack_create_request: "protocol",
|
|
41
|
+
get_stop_request: "protocol", ack_stop_request: "protocol",
|
|
42
|
+
get_start_request: "protocol", ack_start_request: "protocol",
|
|
43
|
+
get_probe_request: "protocol", ack_probe_request: "protocol",
|
|
44
|
+
get_opencode_catalog_request: "protocol", ack_opencode_catalog: "protocol",
|
|
45
|
+
// ── 人:节点令牌一律 user_token_required(项目管理)/ node_token_cannot_browse_files / node_token_cannot_read_logs ──
|
|
46
|
+
projects_create: "user", projects_update: "user", requirement_tags: "both",
|
|
47
|
+
read_opencode_catalog: "user", get_opencode_catalog: "user",
|
|
48
|
+
list_node_files: "user", read_node_file: "user", tail_node_logs: "user",
|
|
49
|
+
// ── 两边都能调 ──
|
|
50
|
+
submit_skill: "both", list_skills: "both", get_skill: "both", review_skill: "both",
|
|
51
|
+
report_completion: "both", get_inbox: "both", ack_inbox: "both",
|
|
52
|
+
get_all_status: "both", get_session_status: "both",
|
|
53
|
+
send_task: "both", send_message: "both", send_reply: "both", send_peer_reply: "both", send_ack: "both",
|
|
54
|
+
retry_task: "both", get_task: "both", list_tasks: "both", cancel_task: "both", reassign_task: "both",
|
|
55
|
+
send_desktop_message: "both", broadcast: "both", get_completions: "both",
|
|
56
|
+
update_node_config: "both", read_node_rules_file: "both", write_node_rules_file: "both",
|
|
57
|
+
list_node_skills: "both", read_node_skill: "both", get_rules_file_result: "both",
|
|
58
|
+
restart_node: "both", list_host_supervisors: "both", create_node: "both", clone_node: "both", stop_node: "both", delete_node: "both", start_node: "both",
|
|
59
|
+
upsert_network_secret: "both", list_network_secrets: "both", upsert_provider: "both", update_provider: "both",
|
|
60
|
+
list_providers: "both", probe_provider_model: "both", get_probe_results: "both",
|
|
61
|
+
requirements_list: "both", requirements_people: "both", requirements_get: "both", requirements_create: "both",
|
|
62
|
+
// #1894 —— 组织架构:人和 Agent 都能用(Agent 用它归部门,人用它看树)。
|
|
63
|
+
departments: "both",
|
|
64
|
+
requirements_update: "both", requirements_checklist_toggle: "both", requirements_upsert_by_external_ref: "both",
|
|
65
|
+
requirements_events: "both", requirements_comment: "both", projects_list: "both",
|
|
66
|
+
};
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* 调用者:节点令牌(绑定网络)/ 用户令牌 / **没有身份**(旧的全局令牌、未开鉴权)。
|
|
70
|
+
*
|
|
71
|
+
* 2026-10-31 —— 第三种以前叫 `"unknown"`,这是**把「已知」写成了「未知」**:
|
|
72
|
+
* 我们完全知道它是什么(没有身份),只是不知道它**是谁**——
|
|
73
|
+
* 而 `unknown` 会让读者以为「查不清」,进而给它加一个 reason、加一次重试。
|
|
74
|
+
* 名字必须说清是「哪一类缺失」(外部复核 ②:reason 要写成「哪个前提没满足」,不能写成「未知」)。
|
|
75
|
+
*/
|
|
76
|
+
export type ToolCaller =
|
|
77
|
+
| { kind: "node"; tokenId: string | null; networkId: string | null; includeProtocol: boolean }
|
|
78
|
+
| { kind: "user"; includeProtocol: boolean }
|
|
79
|
+
| { kind: "anonymous"; why: "no_identity" };
|
|
80
|
+
|
|
81
|
+
/** #487 的判定里「不看参数就必拒」的那几类;和 nodeDecide 同一规则(显式模式恒拒,其余看开关),只是不记日志。 */
|
|
82
|
+
function nodeHidden(name: string, verdictFor: (cls: string) => Verdict): boolean {
|
|
83
|
+
const cls = NODE_TOOL_CLASS[name];
|
|
84
|
+
if (cls !== "broadcast" && cls !== "node_write" && cls !== "human_only") return false;
|
|
85
|
+
const v = verdictFor(cls);
|
|
86
|
+
if (!v) return false;
|
|
87
|
+
if (v.reason === "mode_readonly" || v.reason === "mode_restricted_not_assigned") return true;
|
|
88
|
+
return nodePermissionsFlag() === "enforce";
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/** 这个调用者的 tools/list 里留哪些。没归类的工具一律留下(宁可多列;测试保证不会有没归类的)。 */
|
|
92
|
+
export function listedToolFilter(caller: ToolCaller): (name: string) => boolean {
|
|
93
|
+
if (caller.kind === "anonymous") return () => true;
|
|
94
|
+
if (caller.kind === "user") return name => { const a = TOOL_AUDIENCE[name]; return a !== "node" && a !== "protocol"; };
|
|
95
|
+
const id = caller.tokenId && caller.networkId ? nodeIdentity(caller.tokenId, caller.networkId) : null;
|
|
96
|
+
const verdictFor = (cls: string): Verdict => {
|
|
97
|
+
if (!id) return null;
|
|
98
|
+
if (cls === "broadcast") return broadcastVerdict(id);
|
|
99
|
+
if (cls === "node_write") return writeVerdict(id);
|
|
100
|
+
return humanOnlyVerdict(id);
|
|
101
|
+
};
|
|
102
|
+
return name => {
|
|
103
|
+
const a = TOOL_AUDIENCE[name];
|
|
104
|
+
if (a === "user") return false;
|
|
105
|
+
if (a === "protocol" && !caller.includeProtocol) return false;
|
|
106
|
+
return !nodeHidden(name, verdictFor);
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* 给一个已经注册完工具的 McpServer 换上按调用者过滤的 tools/list。只包 tools/list 的处理函数(先跑 SDK 原来的、
|
|
112
|
+
* 再滤掉不列的),tools/call 不碰。SDK 的处理函数表是内部字段:取不到就不滤(宁可多列),测试会红。
|
|
113
|
+
*/
|
|
114
|
+
export function scopeToolsList(server: unknown, keep: (name: string) => boolean): void {
|
|
115
|
+
const handlers = (server as { server?: { _requestHandlers?: Map<string, (req: unknown, extra: unknown) => unknown> } }).server?._requestHandlers;
|
|
116
|
+
const inner = handlers?.get("tools/list");
|
|
117
|
+
if (!handlers || !inner) return;
|
|
118
|
+
handlers.set("tools/list", async (req: unknown, extra: unknown) => {
|
|
119
|
+
const result = await inner(req, extra) as { tools?: Array<{ name: string }> };
|
|
120
|
+
return Array.isArray(result?.tools) ? { ...result, tools: result.tools.filter(t => keep(t.name)) } : result;
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** 客户端要不要看协议工具:`X-Anet-Tools: all` 或 /mcp?tools=all。 */
|
|
125
|
+
export function wantsAllTools(req: Request, url: URL): boolean {
|
|
126
|
+
return (req.headers.get("x-anet-tools") ?? "").trim().toLowerCase() === "all" || url.searchParams.get("tools") === "all";
|
|
127
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
// #1756 — 标准 MCP 客户端的 tools/list 必须能成功。
|
|
2
|
+
//
|
|
3
|
+
// 2026-09-02 量到:main 上 client.listTools() 直接抛
|
|
4
|
+
// McpError -32603: undefined is not an object (evaluating 'schema._zod')
|
|
5
|
+
// 逐字段二分,肇事者是四处 `z.record(z.unknown())`(report_status.config_snapshot /
|
|
6
|
+
// send_desktop_message.meta / update_node_config.patch.flags / create_node.node_spec.*):
|
|
7
|
+
// zod v4 的 z.record 要两个参数(key, value),单参数时 value schema 是 undefined,
|
|
8
|
+
// SDK 生成 JSON Schema 时对它取 `_zod` 就炸。修法:z.record(z.string(), z.unknown())。
|
|
9
|
+
//
|
|
10
|
+
// 这条测试守两件事:① listTools 整体成功且条数 == 登记表条数;② 每个工具单独都能
|
|
11
|
+
// toJSONSchema —— 第 ② 条让下一次谁再写单参 record 时,红的是「哪个工具哪个字段」。
|
|
12
|
+
// 跑法:cd server && COMMHUB_DB=/tmp/lt.db bun test src/tools-list-json-schema.test.ts
|
|
13
|
+
import { describe, expect, test } from "bun:test";
|
|
14
|
+
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
|
|
15
|
+
import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
|
|
16
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
17
|
+
import { z } from "zod/v4";
|
|
18
|
+
import { registerTools } from "./tools.js";
|
|
19
|
+
|
|
20
|
+
async function connect() {
|
|
21
|
+
const server = new McpServer({ name: "list-tools-test", version: "1" });
|
|
22
|
+
// 没有用户 / 节点身份的调用者 = tools/list 不按角色过滤(#478),这里要的正是「每个登记的工具」。
|
|
23
|
+
registerTools(server, undefined, "net_list_tools", null, "u_list_tools", false, "tok_list_tools");
|
|
24
|
+
const client = new Client({ name: "list-tools-client", version: "1" });
|
|
25
|
+
const [ct, st] = InMemoryTransport.createLinkedPair();
|
|
26
|
+
await server.connect(st);
|
|
27
|
+
await client.connect(ct);
|
|
28
|
+
return { server, client, close: async () => { await client.close(); await server.close(); } };
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
describe("#1756 tools/list", () => {
|
|
32
|
+
test("every registered tool converts to JSON Schema on its own (names the offender)", async () => {
|
|
33
|
+
const { server, close } = await connect();
|
|
34
|
+
try {
|
|
35
|
+
const reg: Record<string, any> = (server as any)._registeredTools;
|
|
36
|
+
const names = Object.keys(reg);
|
|
37
|
+
expect(names.length).toBeGreaterThan(40);
|
|
38
|
+
const bad: string[] = [];
|
|
39
|
+
for (const n of names) {
|
|
40
|
+
const schema = reg[n]?.inputSchema;
|
|
41
|
+
const shape = schema?.shape ?? schema ?? {};
|
|
42
|
+
for (const [k, v] of Object.entries(shape)) {
|
|
43
|
+
try { z.toJSONSchema(z.object({ [k]: v as any })); } catch (e: any) { bad.push(`${n}.${k}: ${String(e?.message).slice(0, 60)}`); }
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
expect(bad).toEqual([]);
|
|
47
|
+
} finally { await close(); }
|
|
48
|
+
}, 20_000);
|
|
49
|
+
|
|
50
|
+
test("client.listTools() succeeds and returns every registered tool", async () => {
|
|
51
|
+
const { server, client, close } = await connect();
|
|
52
|
+
try {
|
|
53
|
+
const reg: Record<string, any> = (server as any)._registeredTools;
|
|
54
|
+
const listed = (await client.listTools()).tools;
|
|
55
|
+
expect(listed.length).toBe(Object.keys(reg).length);
|
|
56
|
+
const byName = new Set(listed.map(t => t.name));
|
|
57
|
+
for (const n of ["report_status", "send_desktop_message", "update_node_config", "create_node", "read_node_rules_file"]) {
|
|
58
|
+
expect(byName.has(n), n).toBe(true);
|
|
59
|
+
}
|
|
60
|
+
// 修过的四个字段在 JSON Schema 里必须是 object(不是 undefined / 空)
|
|
61
|
+
const schemaOf = (n: string) => listed.find(t => t.name === n)!.inputSchema as any;
|
|
62
|
+
expect(schemaOf("report_status").properties.config_snapshot).toBeDefined();
|
|
63
|
+
expect(schemaOf("send_desktop_message").properties.meta.type).toBe("object");
|
|
64
|
+
expect(schemaOf("update_node_config").properties.patch.properties.flags.type).toBe("object");
|
|
65
|
+
} finally { await close(); }
|
|
66
|
+
}, 20_000);
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
// #1075 / #2662 —— `node_secrets_capable` 是**节点自述**的一格,运行时把它放在
|
|
70
|
+
// `config_snapshot` 里(agent-node/src/cli.ts:1894)。而 zod 对象默认**丢掉未声明
|
|
71
|
+
// 的键**:只要 `config_snapshot` 的形状里没有这一条,节点上报得再好,到 Hub 也被
|
|
72
|
+
// 静默剥掉 → 客户端「保存密钥」永远是灰的,日志里一个字都不会说。
|
|
73
|
+
//
|
|
74
|
+
// 所以钉在这里:`report_status.config_snapshot` 的形状里**必须有**这一格。
|
|
75
|
+
// 剥掉它的方式有很多种(重写对象、加 .strict()、换 z.record),这条断言对它们都红。
|
|
76
|
+
describe("#1075 node_secrets_capable survives report_status", () => {
|
|
77
|
+
test("config_snapshot's shape declares node_secrets_capable", async () => {
|
|
78
|
+
const { server, close } = await connect();
|
|
79
|
+
try {
|
|
80
|
+
const reg: Record<string, any> = (server as any)._registeredTools;
|
|
81
|
+
const shape = reg["report_status"]?.inputSchema?.shape ?? {};
|
|
82
|
+
const snapshotField = shape["config_snapshot"];
|
|
83
|
+
expect(snapshotField).toBeTruthy();
|
|
84
|
+
// config_snapshot 是 ZodOptional 包着 ZodObject:.unwrap() 之后才有 shape。
|
|
85
|
+
const unwrapped = (snapshotField as any)?.unwrap ? (snapshotField as any).unwrap() : snapshotField;
|
|
86
|
+
const inner = (unwrapped as any)?.shape ?? {};
|
|
87
|
+
expect(Object.keys(inner)).toContain("node_secrets_capable");
|
|
88
|
+
// 同族的另一格(daemon 级能力)也在这份形状里,顺手一起钉住。
|
|
89
|
+
expect(Object.keys(inner)).toContain("daemon_capabilities");
|
|
90
|
+
} finally {
|
|
91
|
+
await close();
|
|
92
|
+
}
|
|
93
|
+
});
|
|
94
|
+
});
|