@sleep2agi/commhub-server 0.9.0-preview.2 → 0.9.0-preview.200
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 +374 -0
- 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 +271 -0
- package/src/api-host-supervisors-runtime-readiness.test.ts +195 -0
- package/src/api-nodes-shape.test.ts +279 -0
- 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 +611 -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-sec1.test.ts +107 -0
- package/src/config-apply-validate.test.ts +134 -1
- package/src/config-apply-validate.ts +111 -5
- 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 +379 -0
- package/src/create-node-validate.ts +423 -0
- package/src/create-node-workdir.test.ts +289 -0
- package/src/create-node.test.ts +354 -0
- package/src/create-node.ts +411 -0
- 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 +1501 -152
- 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 +177 -0
- package/src/env-transport-gate.ts +74 -0
- package/src/env-transport-policy.ts +21 -0
- package/src/event-loop-lag.test.ts +139 -0
- package/src/event-loop-lag.ts +150 -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 -2172
- package/src/lifecycle-guard.ts +50 -0
- package/src/list-host-supervisors.test.ts +315 -0
- 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 +79 -0
- package/src/node-permissions-http.test.ts +345 -0
- package/src/node-permissions.ts +393 -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/probe-validate.test.ts +221 -0
- package/src/probe-validate.ts +104 -0
- package/src/probe.test.ts +80 -0
- package/src/probe.ts +200 -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 +211 -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 +391 -0
- package/src/schedule-agent.ts +192 -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 +377 -0
- package/src/scheduled-noprogress-backoff-2622.test.ts +133 -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 +139 -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 +5997 -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/probe-host-allowlist-drift.test.ts +54 -0
- package/src/shared/probe-host-allowlist.ts +128 -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 +53 -0
- package/src/shared/reserved-env.test.ts +35 -0
- package/src/shared/reserved-env.ts +31 -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 +1286 -0
- 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 +482 -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 +5815 -348
- package/src/update-provider.test.ts +234 -0
- package/src/upload-early-reject-guard.test.ts +155 -0
- package/src/uploads-http.test.ts +97 -15
- package/src/uploads.test.ts +66 -0
- package/src/uploads.ts +138 -5
- 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/vault.test.ts +200 -0
- package/src/vault.ts +156 -0
- package/src/version-stats.test.ts +66 -0
- package/src/version-stats.ts +109 -0
|
@@ -0,0 +1,423 @@
|
|
|
1
|
+
// RFC-026 v4 §4.2.2 (F2 structured) + §4.4.7 (C1+B1 env_refs) + §4.2.6
|
|
2
|
+
// (B2 fork wrapper) — pure validators + arg builder. No DB access. Used
|
|
3
|
+
// by hub create_node MCP tool (RPC entry) AND by daemon get_create_request
|
|
4
|
+
// (re-check, defense in depth).
|
|
5
|
+
//
|
|
6
|
+
// All validation errors throw ValidationError with a stable `code` field
|
|
7
|
+
// that the MCP tool surface maps to a JSON {ok:false, error: <code>}
|
|
8
|
+
// payload (RFC §4.6).
|
|
9
|
+
|
|
10
|
+
import { isReservedEnvKey } from "./shared/reserved-env.js";
|
|
11
|
+
import { checkNodeName } from "./shared/node-name.js";
|
|
12
|
+
import { CODEX_CONFIG_ONLY_FLAG_KEYS, validateCodexConfigFlag } from "./codex-config-flags.js";
|
|
13
|
+
import { validProviderInitialization } from './shared/provider-initialization.js';
|
|
14
|
+
|
|
15
|
+
export class ValidationError extends Error {
|
|
16
|
+
constructor(public code: string, public detail?: Record<string, unknown>) {
|
|
17
|
+
super(`${code}${detail ? ` ${JSON.stringify(detail)}` : ""}`);
|
|
18
|
+
this.name = "ValidationError";
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
// §4.2.2 — structural enums.
|
|
23
|
+
// #1298 —— daemon 远程创建允许的 runtime。2026-08-28 从 3 个放开到 7 个。
|
|
24
|
+
//
|
|
25
|
+
// 放开之前挡着的问题是「daemon 建出来的是**无人值守**的后台进程,而三个共存 runtime
|
|
26
|
+
// 的本质是人和 agent 共用一个 TUI 会话 —— 建出来给谁用?」
|
|
27
|
+
//
|
|
28
|
+
// Vincent 2026-08-28 定,理由是**兜底排错**:
|
|
29
|
+
// 「某个节点突然不动了,人可以进去看。在 daemon 还没那么靠谱的情况下,
|
|
30
|
+
// 这非常重要 —— 至少可以跟 Codex 和 Claude Code 对话。」
|
|
31
|
+
// 🔴 关键在于 **attach 是「建好之后」的动作,不是「建的时候」的前提**。
|
|
32
|
+
//
|
|
33
|
+
// 支撑读数(2026-08-28 实测舰队):`通信牛` 跑 codex-app-server(共存 runtime),
|
|
34
|
+
// **764 次成功完成任务**,当天仍在跑 —— 比两个普通 runtime 的节点(61 次 / 3 次)
|
|
35
|
+
// 都多一个量级。⇒ 任务链路不需要人坐在屏幕前。
|
|
36
|
+
//
|
|
37
|
+
// 🔴 这七个名字与 `agent-network/src/normalize-runtime.ts` 的 `RuntimeName` 一致。
|
|
38
|
+
// 那边是 CLI 侧的全集;两边分叉过一次(daemon 侧的 VALID_RUNTIMES 早就是 7 个,
|
|
39
|
+
// 只有这里还是 3 个,而记录此事的 #1298 正文写的是「三道闸都关着」——
|
|
40
|
+
// **一份快照式的盘点,只在写下的那一刻是真的**)。
|
|
41
|
+
export const RUNTIMES = [
|
|
42
|
+
"claude-agent-sdk",
|
|
43
|
+
"claude-code-cli",
|
|
44
|
+
"codex-sdk",
|
|
45
|
+
"codex-app-server",
|
|
46
|
+
"grok-build-acp",
|
|
47
|
+
"grok-build-cli",
|
|
48
|
+
"opencode-cli",
|
|
49
|
+
] as const;
|
|
50
|
+
export type Runtime = typeof RUNTIMES[number];
|
|
51
|
+
|
|
52
|
+
// #584 —— `copresence` 是**建节点时**的开关,不是 agent 的运行参数:为 true 时 daemon 把它写成子节点
|
|
53
|
+
// config 的 `codexCopresence: true`,之后一条 `anet node start` 就起共享 TUI(app 向导的「Codex(TUI 共存)」)。
|
|
54
|
+
// 🔴 故意放在 flags 里而不是 node_spec 顶层:老 hub 的 zod 会静默丢弃未知顶层字段、老 daemon 也静默忽略
|
|
55
|
+
// —— 那正是 #584 的形状(用户选了共存,拿到无头节点,没有任何报错)。flags 的未知键在老 hub(这份
|
|
56
|
+
// FLAG_KEYS)和老 daemon(buildAnetArgsDaemon)都**拒绝**,新 app 撞到老组件得到的是一条报错。
|
|
57
|
+
export const FLAG_KEYS = [
|
|
58
|
+
"permissionMode", "dangerouslySkipPermissions", "maxTurns", "budget", "timeout",
|
|
59
|
+
"copresence", "opencodeGeneration", "opencodeUnsafeTools", "opencodeNewServer",
|
|
60
|
+
"approvalPolicy", "sandboxMode", "skipGitRepoCheck", "copresenceFullAccess", "modelReasoningEffort",
|
|
61
|
+
"daemonProvider",
|
|
62
|
+
] as const;
|
|
63
|
+
|
|
64
|
+
/** #584 —— 只有这些 runtime 认 `flags.copresence`。目前只有 codex-app-server 的共存靠 config 字段
|
|
65
|
+
* (`codexCopresence`)决定;grok-build-cli / opencode-cli 各有自己的字段,接进来之前一律拒,不静默吞。 */
|
|
66
|
+
export const COPRESENCE_FLAG_RUNTIMES = ["codex-app-server"] as const;
|
|
67
|
+
export type FlagKey = typeof FLAG_KEYS[number];
|
|
68
|
+
|
|
69
|
+
export const PERMISSION_MODES = ["default", "acceptEdits", "plan", "bypassPermissions"] as const;
|
|
70
|
+
|
|
71
|
+
// §4.4.7 — env_refs limits.
|
|
72
|
+
export const MAX_ENV_KEYS_PER_NODE = 32;
|
|
73
|
+
export const MAX_ENV_VALUE_BYTES = 16 * 1024;
|
|
74
|
+
const ENV_KEY_RE = /^[A-Z][A-Z0-9_]{0,63}$/;
|
|
75
|
+
|
|
76
|
+
// §4.2.2 name + model.
|
|
77
|
+
// Board #652 — the name rule lives in ./shared/node-name.ts (byte-identical copy in
|
|
78
|
+
// agent-node/src/shared/, drift-tested). It used to be /^[a-z][a-z0-9_-]{0,63}$/ here.
|
|
79
|
+
// OpenCode 共存的模型带 provider 前缀(`opencode/mimo-v2.5-free`,agent-node parseModelRef 按第一个 `/` 切),
|
|
80
|
+
// 桌面向导 0.2.61 起就发这种形状 —— 允许**恰好一个**斜杠分隔的两段;每段仍是原字符集,且不能是纯点(`..`/`.`)。
|
|
81
|
+
const MODEL_SEGMENT = "[a-zA-Z0-9._:\\-]+";
|
|
82
|
+
const MODEL_RE = new RegExp(`^${MODEL_SEGMENT}(?:/${MODEL_SEGMENT})?$`);
|
|
83
|
+
const MODEL_DOT_ONLY_SEGMENT = /(^|\/)\.+(\/|$)/;
|
|
84
|
+
|
|
85
|
+
/** Board #652 — returns the normalized (trimmed) name the caller must store and forward. */
|
|
86
|
+
export function validateName(s: unknown): string {
|
|
87
|
+
const r = checkNodeName(s);
|
|
88
|
+
if (!r.ok) {
|
|
89
|
+
throw new ValidationError("node_name_invalid", {
|
|
90
|
+
value: typeof s === "string" ? s.slice(0, 80) : typeof s,
|
|
91
|
+
reason: r.error,
|
|
92
|
+
...(r.char !== undefined ? { char: r.char } : {}),
|
|
93
|
+
message: r.message,
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
return r.name;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export function validateRuntime(s: unknown): asserts s is Runtime {
|
|
100
|
+
if (typeof s !== "string" || !(RUNTIMES as readonly string[]).includes(s)) {
|
|
101
|
+
// 🔴 原来只回一个 `runtime_invalid` + 用户传进来的那个值 —— **不说允许哪些,
|
|
102
|
+
// 也不说还有没有别的路**。2026-08-28 实测:从 Dashboard 建一个
|
|
103
|
+
// `codex-app-server` 节点,用户拿到的就是
|
|
104
|
+
// {"ok":false,"error":"runtime_invalid","value":"codex-app-server"}
|
|
105
|
+
// 而目标机器的 daemon 日志里一行都没有(请求根本没到)。
|
|
106
|
+
// 用户无从知道:①哪些是允许的 ②这个名字是不是打错了 ③有没有别的办法。
|
|
107
|
+
//
|
|
108
|
+
// `allowed` 直接由 RUNTIMES 展开,不是手写的第二份清单 ——
|
|
109
|
+
// 🔴 手写一份会漂移,而漂移之后报错会**理直气壮地告诉用户一组错的名字**。
|
|
110
|
+
throw new ValidationError("runtime_invalid", {
|
|
111
|
+
value: typeof s === "string" ? s.slice(0, 80) : typeof s,
|
|
112
|
+
allowed: [...RUNTIMES],
|
|
113
|
+
// 这句提示的前提是查过的:`agent-network/src/normalize-runtime.ts` 的
|
|
114
|
+
// `RuntimeName` / `SUPPORTED_RUNTIME_NAMES` 是 7 个,包含此处不放行的那几个,
|
|
115
|
+
// 所以「在目标机器上直接建」确实是一条真实存在的路,不是安慰话。
|
|
116
|
+
hint: "daemon 远程创建目前只放行以上 runtime;其余 runtime 可以在目标机器上直接 `anet node create --runtime <name>` 创建。",
|
|
117
|
+
});
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
export function validateModel(s: unknown): asserts s is string | undefined | null {
|
|
122
|
+
if (s === undefined || s === null) return;
|
|
123
|
+
if (typeof s !== "string" || s.length === 0 || s.length > 100 || !MODEL_RE.test(s) || MODEL_DOT_ONLY_SEGMENT.test(s)) {
|
|
124
|
+
throw new ValidationError("model_invalid", { value: typeof s === "string" ? s.slice(0, 80) : typeof s });
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* #605 —— `flags.timeout` 的单位是**毫秒**:agent-node 就是这么读的(cli.ts currentClaudeTimeoutMs /
|
|
130
|
+
* currentCodexTimeoutMs → util/timeout.ts resolveTimeoutMs、runtime/opencode-timeout.ts,默认 300000)。
|
|
131
|
+
* 这里曾按「秒」收 1..86400:填 600 想要 10 分钟的人拿到 0.6 秒、每个任务都超时;真正的毫秒值被拒。
|
|
132
|
+
*
|
|
133
|
+
* 范围与 update_node_config(config-apply-validate.ts)/ agent-node config-apply 同一把尺子:
|
|
134
|
+
* 0(不设上限)或 TIMEOUT_MS_MIN..TIMEOUT_MS_MAX。1..999 拒绝 —— 旧客户端按秒发的小值分辨不出意图,
|
|
135
|
+
* 不偷偷乘 1000,但也不再让任何人悄悄拿到一个亚秒超时。
|
|
136
|
+
*/
|
|
137
|
+
export const TIMEOUT_MS_MIN = 1000;
|
|
138
|
+
export const TIMEOUT_MS_MAX = 3_600_000;
|
|
139
|
+
export const TIMEOUT_MS_REASON =
|
|
140
|
+
`timeout is in milliseconds: 0 (no limit) or an integer ${TIMEOUT_MS_MIN}..${TIMEOUT_MS_MAX} (e.g. 600000 = 10 min)`;
|
|
141
|
+
export function isValidTimeoutMs(v: unknown): v is number {
|
|
142
|
+
return typeof v === "number" && Number.isInteger(v) && (v === 0 || (v >= TIMEOUT_MS_MIN && v <= TIMEOUT_MS_MAX));
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
export function validateFlagValue(k: string, v: unknown): void {
|
|
146
|
+
switch (k) {
|
|
147
|
+
case 'daemonProvider':
|
|
148
|
+
if (!validProviderInitialization(v)) throw new ValidationError('flag_value_invalid', { field: k });
|
|
149
|
+
return;
|
|
150
|
+
case "opencodeGeneration":
|
|
151
|
+
if (v !== "v1" && v !== "v2") throw new ValidationError("flag_value_invalid", { field: k, reason: "must be v1 or v2" });
|
|
152
|
+
return;
|
|
153
|
+
case "opencodeUnsafeTools":
|
|
154
|
+
case "opencodeNewServer":
|
|
155
|
+
if (typeof v !== "boolean") throw new ValidationError("flag_value_invalid", { field: k, reason: "must be boolean" });
|
|
156
|
+
return;
|
|
157
|
+
case "permissionMode":
|
|
158
|
+
if (typeof v !== "string" || !(PERMISSION_MODES as readonly string[]).includes(v)) {
|
|
159
|
+
throw new ValidationError("flag_value_invalid", { field: k, reason: "must be one of default/acceptEdits/plan/bypassPermissions" });
|
|
160
|
+
}
|
|
161
|
+
return;
|
|
162
|
+
case "dangerouslySkipPermissions":
|
|
163
|
+
if (typeof v !== "boolean") throw new ValidationError("flag_value_invalid", { field: k, reason: "must be boolean" });
|
|
164
|
+
return;
|
|
165
|
+
case "maxTurns":
|
|
166
|
+
if (!Number.isInteger(v) || (v as number) < 1 || (v as number) > 9999) {
|
|
167
|
+
throw new ValidationError("flag_value_invalid", { field: k, reason: "must be integer 1..9999" });
|
|
168
|
+
}
|
|
169
|
+
return;
|
|
170
|
+
case "budget":
|
|
171
|
+
if (typeof v !== "number" || !Number.isFinite(v) || (v as number) < 0 || (v as number) > 1000) {
|
|
172
|
+
throw new ValidationError("flag_value_invalid", { field: k, reason: "must be number 0..1000 (decimals OK)" });
|
|
173
|
+
}
|
|
174
|
+
return;
|
|
175
|
+
case "timeout":
|
|
176
|
+
if (!isValidTimeoutMs(v)) {
|
|
177
|
+
throw new ValidationError("flag_value_invalid", { field: k, reason: TIMEOUT_MS_REASON });
|
|
178
|
+
}
|
|
179
|
+
return;
|
|
180
|
+
case "copresence":
|
|
181
|
+
if (typeof v !== "boolean") throw new ValidationError("flag_value_invalid", { field: k, reason: "must be boolean" });
|
|
182
|
+
return;
|
|
183
|
+
default:
|
|
184
|
+
if (CODEX_CONFIG_ONLY_FLAG_KEYS.has(k)) {
|
|
185
|
+
const fail = validateCodexConfigFlag(k, v, null);
|
|
186
|
+
if (fail) throw new ValidationError("flag_value_invalid", { field: k, reason: fail.reason });
|
|
187
|
+
return;
|
|
188
|
+
}
|
|
189
|
+
throw new ValidationError("flag_key_unknown", { field: k });
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/** #584 —— 逐键校验之外的跨字段一条:`copresence` 只对 COPRESENCE_FLAG_RUNTIMES 有意义。
|
|
194
|
+
* 在别的 runtime 上收下它而什么都不做,就是又一个「选了共存、拿到无头」。 */
|
|
195
|
+
export function validateFlagsForRuntime(runtime: string, flags: Record<string, unknown> | undefined | null): void {
|
|
196
|
+
if (!flags) return;
|
|
197
|
+
if (flags.daemonProvider !== undefined && (runtime !== 'codex-app-server' || flags.copresence !== true)) {
|
|
198
|
+
throw new ValidationError('flag_not_applicable_to_runtime', { field: 'daemonProvider', runtime, applicable: ['codex-app-server copresence'] });
|
|
199
|
+
}
|
|
200
|
+
// Strict flags envelope: old Hub/daemon reject these keys rather than dropping
|
|
201
|
+
// unknown node_spec fields. Opt-in must be explicit on this create request.
|
|
202
|
+
for (const field of ["opencodeGeneration", "opencodeUnsafeTools", "opencodeNewServer"]) {
|
|
203
|
+
if (!Object.prototype.hasOwnProperty.call(flags, field)) continue;
|
|
204
|
+
validateFlagValue(field, flags[field]);
|
|
205
|
+
if (runtime !== "opencode-cli") throw new ValidationError("flag_not_applicable_to_runtime", { field, runtime, applicable: ["opencode-cli"] });
|
|
206
|
+
}
|
|
207
|
+
if (Object.prototype.hasOwnProperty.call(flags, "opencodeUnsafeTools") && flags.opencodeGeneration !== "v2") {
|
|
208
|
+
throw new ValidationError("opencode_unsafe_requires_v2", { reason: "opencodeUnsafeTools requires explicit opencodeGeneration=v2" });
|
|
209
|
+
}
|
|
210
|
+
if (flags.opencodeGeneration === "v2" && flags.opencodeUnsafeTools !== true) {
|
|
211
|
+
throw new ValidationError("opencode_v2_requires_unsafe_opt_in", { reason: "V2 preview enables every local tool; trusted tasks only. Explicit opencodeUnsafeTools=true required." });
|
|
212
|
+
}
|
|
213
|
+
if (Object.prototype.hasOwnProperty.call(flags, "opencodeNewServer") && flags.opencodeGeneration !== "v2") {
|
|
214
|
+
throw new ValidationError("opencode_new_server_requires_v2", { reason: "opencodeNewServer requires explicit opencodeGeneration=v2" });
|
|
215
|
+
}
|
|
216
|
+
if (Object.prototype.hasOwnProperty.call(flags, "copresence") && !(COPRESENCE_FLAG_RUNTIMES as readonly string[]).includes(runtime)) {
|
|
217
|
+
throw new ValidationError("flag_not_applicable_to_runtime", {
|
|
218
|
+
field: "copresence", runtime, applicable: [...COPRESENCE_FLAG_RUNTIMES],
|
|
219
|
+
});
|
|
220
|
+
}
|
|
221
|
+
for (const [k, v] of Object.entries(flags)) {
|
|
222
|
+
if (!CODEX_CONFIG_ONLY_FLAG_KEYS.has(k)) continue;
|
|
223
|
+
const fail = validateCodexConfigFlag(k, v, runtime);
|
|
224
|
+
if (fail) throw new ValidationError("flag_value_invalid", { field: k, reason: fail.reason });
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* V2 co-presence start requires OpenCode's own `provider/model`.
|
|
230
|
+
* Call only after the unsafe-opt-in check: a missing opt-in stays
|
|
231
|
+
* `opencode_v2_requires_unsafe_opt_in`. This API does not take an anet
|
|
232
|
+
* provider preset or a vault key (#2565 owns presets).
|
|
233
|
+
*/
|
|
234
|
+
export function validateOpenCodeV2ProviderModel(
|
|
235
|
+
runtime: string,
|
|
236
|
+
model: unknown,
|
|
237
|
+
flags: Record<string, unknown> | undefined | null,
|
|
238
|
+
): void {
|
|
239
|
+
if (runtime !== "opencode-cli" || !flags || typeof flags !== "object") return;
|
|
240
|
+
if (flags.opencodeGeneration !== "v2" || flags.opencodeUnsafeTools !== true) return;
|
|
241
|
+
const native = typeof model === "string"
|
|
242
|
+
&& model.length > 0
|
|
243
|
+
&& model.length <= 100
|
|
244
|
+
&& MODEL_RE.test(model)
|
|
245
|
+
&& !MODEL_DOT_ONLY_SEGMENT.test(model)
|
|
246
|
+
&& model.includes("/")
|
|
247
|
+
&& model.indexOf("/") === model.lastIndexOf("/");
|
|
248
|
+
if (!native) {
|
|
249
|
+
throw new ValidationError("opencode_v2_requires_provider_model", {
|
|
250
|
+
reason: "OpenCode V2 uses the installed OpenCode provider/model (exactly one slash, for example provider/model). This API does not take an anet provider preset.",
|
|
251
|
+
});
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
// §4.4.7 — env_refs 7-step gate. networkSecretsGet is injected so
|
|
256
|
+
// callers can supply either a real DB lookup (hub) or a fixture (tests).
|
|
257
|
+
// The 6th step also reports the resolved value size; we return the
|
|
258
|
+
// resolved-but-not-yet-used map keyed by env-key so the caller can build
|
|
259
|
+
// env_blob without re-querying.
|
|
260
|
+
export interface EnvRefsContext {
|
|
261
|
+
callerNetworkId: string;
|
|
262
|
+
daemonAllowList: ReadonlySet<string>;
|
|
263
|
+
networkSecretsGet: (networkId: string, key: string) => string | undefined;
|
|
264
|
+
}
|
|
265
|
+
export function validateEnvRefs(
|
|
266
|
+
refs: unknown,
|
|
267
|
+
ctx: EnvRefsContext,
|
|
268
|
+
): Record<string, string> {
|
|
269
|
+
if (!Array.isArray(refs)) {
|
|
270
|
+
if (refs === undefined || refs === null) return {};
|
|
271
|
+
throw new ValidationError("env_refs_invalid", { reason: "must be array" });
|
|
272
|
+
}
|
|
273
|
+
// ① regex
|
|
274
|
+
for (const k of refs) {
|
|
275
|
+
if (typeof k !== "string" || !ENV_KEY_RE.test(k)) {
|
|
276
|
+
throw new ValidationError("env_key_invalid", { key: typeof k === "string" ? k.slice(0, 64) : typeof k });
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
// ② reserved denylist (v4 B1)
|
|
280
|
+
for (const k of refs) {
|
|
281
|
+
if (isReservedEnvKey(k)) {
|
|
282
|
+
throw new ValidationError("env_key_reserved", { key: k });
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
// ③ duplicate detection (must come before ④ count gate to give a
|
|
286
|
+
// truthful error code rather than "too many" for dup-spam).
|
|
287
|
+
const seen = new Set<string>();
|
|
288
|
+
for (const k of refs as string[]) {
|
|
289
|
+
if (seen.has(k)) throw new ValidationError("env_key_duplicate", { key: k });
|
|
290
|
+
seen.add(k);
|
|
291
|
+
}
|
|
292
|
+
// ④ count cap
|
|
293
|
+
if (seen.size > MAX_ENV_KEYS_PER_NODE) {
|
|
294
|
+
throw new ValidationError("env_key_too_many", { count: seen.size, max: MAX_ENV_KEYS_PER_NODE });
|
|
295
|
+
}
|
|
296
|
+
const out: Record<string, string> = {};
|
|
297
|
+
// ⑤ vault presence + ⑥ value size cap
|
|
298
|
+
for (const k of seen) {
|
|
299
|
+
const v = ctx.networkSecretsGet(ctx.callerNetworkId, k);
|
|
300
|
+
if (v === undefined) throw new ValidationError("secret_not_in_vault", { key: k });
|
|
301
|
+
if (Buffer.byteLength(v, "utf8") > MAX_ENV_VALUE_BYTES) {
|
|
302
|
+
throw new ValidationError("secret_too_large", { key: k, max: MAX_ENV_VALUE_BYTES });
|
|
303
|
+
}
|
|
304
|
+
out[k] = v;
|
|
305
|
+
}
|
|
306
|
+
// ⑦ daemon allowlist (per-host whitelist of which secrets this
|
|
307
|
+
// machine is allowed to receive; declared in daemon config by the
|
|
308
|
+
// host operator)
|
|
309
|
+
for (const k of seen) {
|
|
310
|
+
if (!ctx.daemonAllowList.has(k)) {
|
|
311
|
+
throw new ValidationError("secret_not_in_daemon_allowlist", { key: k });
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
return out;
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
// §4.4.7 — safe serializer for the node secrets.env file. Dotenv-quoted with escape
|
|
318
|
+
// for backslash / double-quote / newline / carriage-return so that a
|
|
319
|
+
// value containing `\n"evil=KEY2"` cannot pollute the next line.
|
|
320
|
+
export function serializeEnvLocal(env: Record<string, string>): string {
|
|
321
|
+
return Object.entries(env).map(([k, v]) => {
|
|
322
|
+
const esc = String(v)
|
|
323
|
+
.replace(/\\/g, "\\\\") // 1) backslashes first (or later escapes get un-escaped)
|
|
324
|
+
.replace(/"/g, '\\"') // 2) double-quotes
|
|
325
|
+
.replace(/\n/g, "\\n") // 3) newline → literal \n
|
|
326
|
+
.replace(/\r/g, "\\r"); // 4) carriage return → literal \r
|
|
327
|
+
return `${k}="${esc}"`;
|
|
328
|
+
}).join("\n") + "\n";
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
// app「新建节点」工作目录 —— hub 只判**形状**(daemon 才知道那台机器的 $HOME、系统目录、
|
|
332
|
+
// 目录里住没住别的节点,那几条在 agent-node/src/runtime/child-workdir.ts)。
|
|
333
|
+
// 这里挡的是「根本不像一条路径」的输入,让它在派发前就失败,而不是占一个请求行再被 daemon 拒。
|
|
334
|
+
export const MAX_WORKDIR_LEN = 1024;
|
|
335
|
+
export function validateWorkdir(s: unknown): asserts s is string | undefined | null {
|
|
336
|
+
if (s === undefined || s === null) return;
|
|
337
|
+
if (typeof s !== "string") throw new ValidationError("workdir_invalid", { reason: "must be string" });
|
|
338
|
+
const v = s.trim();
|
|
339
|
+
if (v.length === 0 || v.length > MAX_WORKDIR_LEN) {
|
|
340
|
+
throw new ValidationError("workdir_invalid", { reason: `length 1..${MAX_WORKDIR_LEN}` });
|
|
341
|
+
}
|
|
342
|
+
if (/[\u0000-\u001f\u007f]/.test(v)) throw new ValidationError("workdir_invalid", { reason: "control character" });
|
|
343
|
+
const shapeOk = v.startsWith("/") || v === "~" || v.startsWith("~/") || /^[A-Za-z]:[\\/]/.test(v);
|
|
344
|
+
if (!shapeOk) {
|
|
345
|
+
throw new ValidationError("workdir_invalid", { reason: "must be absolute (/…, ~/…, or C:\\…)", value: v.slice(0, 80) });
|
|
346
|
+
}
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/** daemon 自报的默认工作目录根(`daemon_capabilities.default_workdir_root`),消毒后返回;
|
|
350
|
+
* 没报 / 形状不对 = null。**非 null 即表示该 daemon 认 `node_spec.workdir`** ——
|
|
351
|
+
* create_node 的「老 daemon 不收 workdir」门和 /api/host-supervisors 的透出共用这一个判据。 */
|
|
352
|
+
export function daemonDefaultWorkdirRoot(configSnapshot: unknown): string | null {
|
|
353
|
+
try {
|
|
354
|
+
const snap = typeof configSnapshot === "string" ? JSON.parse(configSnapshot) : configSnapshot;
|
|
355
|
+
const v = (snap as any)?.daemon_capabilities?.default_workdir_root;
|
|
356
|
+
if (typeof v !== "string" || v.length === 0 || v.length > MAX_WORKDIR_LEN) return null;
|
|
357
|
+
if (/[\u0000-\u001f\u007f]/.test(v)) return null;
|
|
358
|
+
if (!(v.startsWith("/") || /^[A-Za-z]:[\\/]/.test(v))) return null;
|
|
359
|
+
return v;
|
|
360
|
+
} catch {
|
|
361
|
+
return null;
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
// §4.2.5 — channels fail-closed in P1.
|
|
366
|
+
export function validateChannelsP1(channels: unknown): void {
|
|
367
|
+
if (channels === undefined || channels === null) return;
|
|
368
|
+
if (!Array.isArray(channels)) {
|
|
369
|
+
throw new ValidationError("channels_not_supported_in_p1", { reason: "expected array or omitted" });
|
|
370
|
+
}
|
|
371
|
+
if (channels.length > 0) {
|
|
372
|
+
throw new ValidationError("channels_not_supported_in_p1", { received: channels.length, p3_tracker: "RFC-026 §5 P3" });
|
|
373
|
+
}
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
// §4.2.2 — fully validated NodeSpec, ready to feed into buildAnetArgs.
|
|
377
|
+
export interface NodeSpec {
|
|
378
|
+
name: string;
|
|
379
|
+
runtime: Runtime;
|
|
380
|
+
model?: string | null;
|
|
381
|
+
flags?: Record<string, unknown>;
|
|
382
|
+
channels?: unknown;
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
// kebab-case helper for flag names. permissionMode → permission-mode.
|
|
386
|
+
function kebab(k: string): string {
|
|
387
|
+
return k.replace(/([A-Z])/g, "-$1").toLowerCase();
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
// §4.2.2 — build the argv that gets fed verbatim to execFile (no
|
|
391
|
+
// shell, no string concat). Each value has already passed type/enum
|
|
392
|
+
// validation, so String() coercion is safe.
|
|
393
|
+
export function buildAnetArgs(spec: NodeSpec): string[] {
|
|
394
|
+
for (const field of ["opencodeGeneration", "opencodeUnsafeTools"]) {
|
|
395
|
+
if (Object.prototype.hasOwnProperty.call(spec, field)) throw new ValidationError("flag_location_invalid", { field, reason: "use node_spec.flags" });
|
|
396
|
+
}
|
|
397
|
+
validateName(spec.name);
|
|
398
|
+
validateRuntime(spec.runtime);
|
|
399
|
+
validateModel(spec.model);
|
|
400
|
+
validateChannelsP1(spec.channels);
|
|
401
|
+
if (spec.flags?.daemonProvider !== undefined && (!validProviderInitialization(spec.flags.daemonProvider)
|
|
402
|
+
|| spec.model !== spec.flags.daemonProvider.model)) throw new ValidationError('provider_create_model_mismatch');
|
|
403
|
+
|
|
404
|
+
const args: string[] = ["node", "create", spec.name, "--runtime", spec.runtime];
|
|
405
|
+
if (spec.model) args.push("--model", spec.model);
|
|
406
|
+
if (spec.flags && typeof spec.flags === "object") {
|
|
407
|
+
for (const [k, v] of Object.entries(spec.flags)) {
|
|
408
|
+
if (!(FLAG_KEYS as readonly string[]).includes(k)) {
|
|
409
|
+
throw new ValidationError("flag_key_unknown", { field: k });
|
|
410
|
+
}
|
|
411
|
+
validateFlagValue(k, v);
|
|
412
|
+
// `anet node create --copresence` 是布尔开关,不吃值。
|
|
413
|
+
if (k === "copresence") { if (v === true) args.push("--copresence"); continue; }
|
|
414
|
+
if (k === "opencodeUnsafeTools") { if (v === true) args.push("--opencode-unsafe-tools"); continue; }
|
|
415
|
+
if (k === "opencodeNewServer") { if (v === true) args.push("--opencode-new-server"); continue; }
|
|
416
|
+
if (CODEX_CONFIG_ONLY_FLAG_KEYS.has(k) || k === 'daemonProvider') continue;
|
|
417
|
+
args.push(`--${kebab(k)}`, String(v));
|
|
418
|
+
}
|
|
419
|
+
validateFlagsForRuntime(spec.runtime, spec.flags);
|
|
420
|
+
}
|
|
421
|
+
validateOpenCodeV2ProviderModel(spec.runtime, spec.model, spec.flags);
|
|
422
|
+
return args;
|
|
423
|
+
}
|