@unbrained/pm-cli 2026.9.6 → 2026.9.8
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/.agents/skills/pm-developer/SKILL.md +12 -4
- package/.agents/skills/pm-developer/references/MULTI_AGENT_MERGE.md +19 -10
- package/.agents/skills/pm-extensions/SKILL.md +6 -0
- package/.agents/skills/pm-sdk/SKILL.md +11 -2
- package/.agents/skills/pm-user/SKILL.md +5 -0
- package/.agents/skills/pm-user/references/ECOSYSTEM_PLANNING.md +95 -0
- package/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +218 -182
- package/dist/cli/after-command-context-usage.js +1 -48
- package/dist/cli/argv-utils.js +1 -40
- package/dist/cli/bootstrap-args.js +1 -9
- package/dist/cli/bundle-integrity.js +2 -110
- package/dist/cli/commander-usage.js +11 -771
- package/dist/cli/commands/activity.js +1 -9
- package/dist/cli/commands/aggregate.js +1 -5
- package/dist/cli/commands/append.js +1 -5
- package/dist/cli/commands/claim.js +1 -5
- package/dist/cli/commands/close-many.js +1 -5
- package/dist/cli/commands/close.js +1 -9
- package/dist/cli/commands/comments.js +1 -5
- package/dist/cli/commands/config.js +1 -9
- package/dist/cli/commands/context.js +1 -9
- package/dist/cli/commands/contracts.js +1 -5
- package/dist/cli/commands/copy.js +1 -9
- package/dist/cli/commands/create.js +1 -9
- package/dist/cli/commands/delete.js +1 -9
- package/dist/cli/commands/deps.js +1 -9
- package/dist/cli/commands/docs.js +1 -9
- package/dist/cli/commands/duplicates.js +1 -9
- package/dist/cli/commands/eval.js +1 -9
- package/dist/cli/commands/extension/describe.js +1 -5
- package/dist/cli/commands/extension/scaffold.js +1 -5
- package/dist/cli/commands/extension/shared.js +1 -5
- package/dist/cli/commands/extension.js +1 -9
- package/dist/cli/commands/files.js +1 -9
- package/dist/cli/commands/focus.js +1 -9
- package/dist/cli/commands/gc.js +1 -9
- package/dist/cli/commands/get.js +1 -9
- package/dist/cli/commands/graph.js +1 -10
- package/dist/cli/commands/health.js +1 -9
- package/dist/cli/commands/history-compact.js +1 -10
- package/dist/cli/commands/history-redact.js +1 -11
- package/dist/cli/commands/history-repair.js +1 -10
- package/dist/cli/commands/history.js +1 -5
- package/dist/cli/commands/index.js +1 -58
- package/dist/cli/commands/init-agent-guidance.js +1 -9
- package/dist/cli/commands/init.js +1 -9
- package/dist/cli/commands/learnings.js +1 -5
- package/dist/cli/commands/lifecycle-transitions.js +1 -5
- package/dist/cli/commands/list.js +1 -9
- package/dist/cli/commands/merge.js +1 -11
- package/dist/cli/commands/next.js +1 -9
- package/dist/cli/commands/notes.js +1 -5
- package/dist/cli/commands/plan.js +1 -9
- package/dist/cli/commands/profile.js +1 -9
- package/dist/cli/commands/restore.js +1 -9
- package/dist/cli/commands/scheduling-shortcuts.js +1 -9
- package/dist/cli/commands/schema.js +1 -10
- package/dist/cli/commands/search.js +1 -9
- package/dist/cli/commands/stats.js +1 -9
- package/dist/cli/commands/telemetry.js +1 -9
- package/dist/cli/commands/test-all.js +1 -9
- package/dist/cli/commands/test-runs.js +1 -9
- package/dist/cli/commands/test.js +1 -9
- package/dist/cli/commands/update-many.js +1 -5
- package/dist/cli/commands/update.js +1 -9
- package/dist/cli/commands/upgrade.js +1 -5
- package/dist/cli/commands/validate.js +1 -15
- package/dist/cli/context-intent-invocation.js +1 -20
- package/dist/cli/description-stdin.js +1 -17
- package/dist/cli/error-guidance.js +1 -1353
- package/dist/cli/extension-command-help.js +5 -636
- package/dist/cli/extension-command-options.js +1 -427
- package/dist/cli/extension-recovery.js +1 -126
- package/dist/cli/help-content.js +2 -1001
- package/dist/cli/help-json-payload.js +4 -570
- package/dist/cli/main.d.ts +4 -0
- package/dist/cli/main.js +5 -2573
- package/dist/cli/migration-gates.js +1 -289
- package/dist/cli/public.js +1 -20
- package/dist/cli/register-annotations.js +1 -270
- package/dist/cli/register-assurance.js +1 -62
- package/dist/cli/register-files-lookup.js +1 -56
- package/dist/cli/register-history-activity.d.ts +8 -0
- package/dist/cli/register-history-activity.js +2 -0
- package/dist/cli/register-history-author.js +1 -38
- package/dist/cli/register-history-maintenance.d.ts +9 -0
- package/dist/cli/register-history-maintenance.js +2 -0
- package/dist/cli/register-list-query.js +10 -943
- package/dist/cli/register-mutation-options.js +1 -9
- package/dist/cli/register-mutation.js +19 -1893
- package/dist/cli/register-operations.js +1 -920
- package/dist/cli/register-setup.js +1 -716
- package/dist/cli/register-structured-mutation.js +1 -196
- package/dist/cli/registration-helpers.js +1 -5
- package/dist/cli/runtime-compatibility-boundary.js +4 -42
- package/dist/cli/schema-registration-helpers.js +1 -73
- package/dist/cli/search-refresh.js +1 -13
- package/dist/cli/stats-analytics-json.js +1 -68
- package/dist/cli/telemetry-flush.js +1 -10
- package/dist/cli-bundle/bundle-manifest.json +164 -156
- package/dist/cli-bundle/chunks/chunk-3BZZA6A3.js +5 -0
- package/dist/cli-bundle/chunks/chunk-AMRDVX36.js +235 -0
- package/dist/cli-bundle/chunks/chunk-DAM4CBBR.js +2202 -0
- package/dist/cli-bundle/chunks/{chunk-WYRZZ5ZE.js → chunk-DEZPZOQ7.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-FLDWYEND.js +77 -0
- package/dist/cli-bundle/chunks/{chunk-NPN5I67J.js → chunk-G5ADGQ2D.js} +3 -3
- package/dist/cli-bundle/chunks/chunk-JAAEYHUA.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-JX4DH4WC.js → chunk-KR3RP4FH.js} +3 -3
- package/dist/cli-bundle/chunks/chunk-LEZOUXG6.js +2 -0
- package/dist/cli-bundle/chunks/chunk-NSAPNEYH.js +2 -0
- package/dist/cli-bundle/chunks/chunk-QOEKOECV.js +29 -0
- package/dist/cli-bundle/chunks/chunk-RHSFOMHU.js +2 -0
- package/dist/cli-bundle/chunks/chunk-XOD2PCB6.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-JT6XF6GE.js → chunk-YVEQ2AMO.js} +4 -4
- package/dist/cli-bundle/chunks/register-list-query-KSK3R63M.js +11 -0
- package/dist/cli-bundle/chunks/register-mutation-IQ5C7U6O.js +20 -0
- package/dist/cli-bundle/chunks/{register-operations-I5W3KMGB.js → register-operations-DWVHR2NC.js} +2 -2
- package/dist/cli-bundle/chunks/register-setup-BQ5SVD4B.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-3WRPWLA7.js +3 -0
- package/dist/cli-bundle/focused-chunks/chunk-7MBUII7U.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-COPBO5HW.js +8 -0
- package/dist/cli-bundle/focused-chunks/chunk-DUN4IXYN.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-LIJIA4TY.js → chunk-EE5QSM4Z.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-HJVARYM3.js +6 -0
- package/dist/cli-bundle/focused-chunks/chunk-IAUOUGVR.js +177 -0
- package/dist/cli-bundle/focused-chunks/chunk-KOOMJ54F.js +2 -0
- package/dist/cli-bundle/focused-chunks/chunk-MZDXX7JY.js +56 -0
- package/dist/cli-bundle/focused-chunks/{chunk-M6PBRFSH.js → chunk-OPFHFGDD.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-QHNETP77.js +9 -0
- package/dist/cli-bundle/focused-chunks/{chunk-3BZEOXLT.js → chunk-RMWES4M6.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-RXT4P5QH.js +10 -0
- package/dist/cli-bundle/focused-chunks/chunk-SDOL6FM2.js +12 -0
- package/dist/cli-bundle/focused-chunks/chunk-SQV4AAUC.js +2 -0
- package/dist/cli-bundle/focused-chunks/{chunk-PEFABF7E.js → chunk-WE3IUNIW.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-YALOUBWJ.js +2 -0
- package/dist/cli-bundle/main.js +20 -20
- package/dist/cli-bundle/sdk-authoring.js +1 -1
- package/dist/cli-bundle/sdk-contracts.js +2 -2
- package/dist/cli-bundle/sdk-core.js +29 -29
- package/dist/cli-bundle/sdk-governance.js +1 -1
- package/dist/cli-bundle/sdk-graph.js +1 -1
- package/dist/cli-bundle/sdk-merge.js +42 -42
- package/dist/cli-bundle/sdk-query.js +1 -1
- package/dist/cli-bundle/sdk-runtime.js +1 -1
- package/dist/cli-bundle/sdk-testing.js +1 -1
- package/dist/cli-bundle/sdk.js +11 -11
- package/dist/cli.js +1 -104
- package/dist/core/checkpoint/checkpoint-gc.js +1 -169
- package/dist/core/checkpoint/mutation-checkpoint.js +2 -133
- package/dist/core/config/nested-settings.js +1 -534
- package/dist/core/config/positional-value.js +1 -109
- package/dist/core/diagnostics/remediation.js +1 -506
- package/dist/core/extensions/activation-summary-markdown.js +2 -145
- package/dist/core/extensions/activation-summary.js +1 -92
- package/dist/core/extensions/activation-transaction.js +1 -46
- package/dist/core/extensions/capability-usage.js +1 -173
- package/dist/core/extensions/command-hook-context.js +1 -13
- package/dist/core/extensions/command-metadata-contract.js +1 -22
- package/dist/core/extensions/command-visibility-tier.js +1 -29
- package/dist/core/extensions/contribution-inventory.js +1 -173
- package/dist/core/extensions/exporter-output-contract.js +1 -66
- package/dist/core/extensions/extension-candidate.js +1 -18
- package/dist/core/extensions/extension-capability-aliases.js +1 -158
- package/dist/core/extensions/extension-hook-runtime.js +1 -699
- package/dist/core/extensions/extension-policy.js +1 -599
- package/dist/core/extensions/extension-registries.js +1 -62
- package/dist/core/extensions/extension-runtime-helpers.js +1 -33
- package/dist/core/extensions/extension-types.js +1 -102
- package/dist/core/extensions/flag-definition-validation.js +1 -52
- package/dist/core/extensions/flag-value-types.js +1 -64
- package/dist/core/extensions/index.js +1 -526
- package/dist/core/extensions/item-field-types.js +1 -39
- package/dist/core/extensions/item-fields.js +1 -261
- package/dist/core/extensions/loader.js +1 -2223
- package/dist/core/extensions/manifest-schema.js +1 -69
- package/dist/core/extensions/module-graph-snapshot.js +1 -33
- package/dist/core/extensions/preflight-ownership.js +1 -41
- package/dist/core/extensions/registration-validation.js +1 -82
- package/dist/core/extensions/registration-values.js +1 -209
- package/dist/core/extensions/reserved-host-flags.js +1 -36
- package/dist/core/extensions/runtime-registrations.js +1 -67
- package/dist/core/extensions/service-ownership.js +1 -19
- package/dist/core/extensions/version-compat.js +1 -216
- package/dist/core/fs/fs-utils.js +2 -158
- package/dist/core/fs/host-environment-errors.js +1 -141
- package/dist/core/fs/index.js +1 -9
- package/dist/core/fs/path-utils.js +1 -17
- package/dist/core/governance/content-fields.js +1 -160
- package/dist/core/governance/issue-codes.js +1 -151
- package/dist/core/governance/metadata-coverage.js +1 -358
- package/dist/core/history/drift-cache.js +3 -72
- package/dist/core/history/drift-scan.js +1 -342
- package/dist/core/history/event-classification.js +1 -109
- package/dist/core/history/event-index.js +8 -784
- package/dist/core/history/history-compact-bulk.js +1 -104
- package/dist/core/history/history-diff.js +1 -158
- package/dist/core/history/history-rewrite.d.ts +6 -1
- package/dist/core/history/history-rewrite.js +1 -107
- package/dist/core/history/history-storage-stats.js +1 -102
- package/dist/core/history/history-stream-policy.js +1 -62
- package/dist/core/history/history.js +2 -617
- package/dist/core/history/identity.js +1 -30
- package/dist/core/history/index.js +1 -9
- package/dist/core/history/projection.js +1 -196
- package/dist/core/history/read.d.ts +9 -0
- package/dist/core/history/read.js +1 -57
- package/dist/core/history/replay.js +2 -439
- package/dist/core/history/version-address.js +1 -32
- package/dist/core/history/workspace-history.js +2 -433
- package/dist/core/io/body-file.js +1 -62
- package/dist/core/io/bulk-ids-input.js +1 -112
- package/dist/core/item/actionability.js +1 -327
- package/dist/core/item/dependency-reference.js +1 -20
- package/dist/core/item/id.js +1 -112
- package/dist/core/item/index.js +1 -12
- package/dist/core/item/item-format-version.js +1 -78
- package/dist/core/item/item-format.js +5 -1473
- package/dist/core/item/item-record.js +1 -23
- package/dist/core/item/item-type-definition.js +1 -133
- package/dist/core/item/parent-reference-policy.js +1 -57
- package/dist/core/item/parse.js +2 -603
- package/dist/core/item/plan-lifecycle.js +1 -19
- package/dist/core/item/priority.js +1 -61
- package/dist/core/item/sprint-release-format.js +1 -38
- package/dist/core/item/status-filter.js +1 -115
- package/dist/core/item/status.js +1 -43
- package/dist/core/item/toon-decode.js +1 -29
- package/dist/core/item/type-registry.js +1 -715
- package/dist/core/item/type-synonyms.js +1 -38
- package/dist/core/lock/index.js +1 -9
- package/dist/core/lock/lock-gc.js +1 -240
- package/dist/core/lock/lock.js +3 -590
- package/dist/core/output/mutation-projection.js +1 -217
- package/dist/core/output/output-control.js +1 -25
- package/dist/core/output/output.js +11 -494
- package/dist/core/output/query-summary.js +1 -58
- package/dist/core/output/tabular.js +1 -77
- package/dist/core/packages/manifest.js +1 -244
- package/dist/core/packages/root.js +1 -84
- package/dist/core/profile/profile-describe.js +1 -83
- package/dist/core/profile/profile-lint.js +1 -415
- package/dist/core/profile/profile-plan.js +0 -0
- package/dist/core/profile/profile-presets.js +1 -370
- package/dist/core/reproducibility/context.js +1 -82
- package/dist/core/schema/fields-file.js +2 -288
- package/dist/core/schema/item-types-file.js +2 -296
- package/dist/core/schema/runtime-field-filters.js +1 -49
- package/dist/core/schema/runtime-field-values.js +1 -313
- package/dist/core/schema/runtime-schema.js +2 -826
- package/dist/core/schema/status-defs-file.js +2 -227
- package/dist/core/schema/status-token.js +1 -31
- package/dist/core/schema/type-inference.js +1 -95
- package/dist/core/schema/type-presets.js +1 -87
- package/dist/core/schema/type-workflows.js +1 -104
- package/dist/core/search/background-refresh.js +2 -286
- package/dist/core/search/bm25.js +1 -146
- package/dist/core/search/cache.js +2 -534
- package/dist/core/search/corpus.js +1 -311
- package/dist/core/search/embedding-batches.js +1 -163
- package/dist/core/search/eval.js +1 -225
- package/dist/core/search/http-client.js +1 -75
- package/dist/core/search/providers.js +1 -242
- package/dist/core/search/relevance.js +1 -244
- package/dist/core/search/semantic-defaults.js +1 -199
- package/dist/core/search/staleness.js +1 -30
- package/dist/core/search/vector-stores.js +2 -664
- package/dist/core/search/vectorization-metadata.js +1 -81
- package/dist/core/sentry/helpers.js +1 -272
- package/dist/core/sentry/instrument.js +1 -387
- package/dist/core/session/session-state.js +1 -260
- package/dist/core/shared/agent-session-context.js +1 -133
- package/dist/core/shared/author.js +1 -1172
- package/dist/core/shared/command-types.js +1 -4
- package/dist/core/shared/conflict-markers.js +1 -31
- package/dist/core/shared/constants.js +1 -405
- package/dist/core/shared/errors.js +1 -20
- package/dist/core/shared/html-entity-decode.js +1 -131
- package/dist/core/shared/index.js +1 -12
- package/dist/core/shared/item-metadata-contract.js +1 -89
- package/dist/core/shared/lazy-module.js +1 -16
- package/dist/core/shared/levenshtein.js +1 -61
- package/dist/core/shared/memo.js +1 -19
- package/dist/core/shared/numeric-parsers.js +1 -20
- package/dist/core/shared/option-alias-visibility.js +1 -67
- package/dist/core/shared/primitives.js +1 -127
- package/dist/core/shared/serial-queue.js +1 -79
- package/dist/core/shared/serialization.js +1 -210
- package/dist/core/shared/split-comma-list.js +1 -30
- package/dist/core/shared/text-normalization.js +1 -38
- package/dist/core/shared/time.js +1 -306
- package/dist/core/store/index.js +1 -12
- package/dist/core/store/item-format-migration.js +1 -125
- package/dist/core/store/item-metadata-cache.js +1 -1116
- package/dist/core/store/item-metadata-query-index.js +9 -394
- package/dist/core/store/item-metadata-read-work.js +1 -43
- package/dist/core/store/item-store.js +1 -693
- package/dist/core/store/paths.d.ts +1 -1
- package/dist/core/store/paths.js +1 -214
- package/dist/core/store/settings-read-cache.js +1 -85
- package/dist/core/store/settings-validator.js +1 -421
- package/dist/core/store/settings.js +3 -1309
- package/dist/core/store/tracker-preflight.js +1 -141
- package/dist/core/telemetry/consent.js +5 -108
- package/dist/core/telemetry/observability.js +1 -246
- package/dist/core/telemetry/runtime.js +4 -1988
- package/dist/core/test/background-runs.js +4 -945
- package/dist/core/test/item-test-run-tracking.js +1 -63
- package/dist/core/test/run-selectors.js +1 -120
- package/dist/core/validate/estimate-defaults.js +1 -89
- package/dist/core/validate/fix-planning.js +1 -189
- package/dist/core/validate/linked-artifact-reference.js +1 -36
- package/dist/core/validate/missing-by-type.js +1 -34
- package/dist/core/validate/missing-link-owners.js +1 -95
- package/dist/core/validate/stale-file-classification.js +1 -82
- package/dist/mcp/http-server.js +5 -448
- package/dist/mcp/legacy-adapter.js +1 -77
- package/dist/mcp/runtime-capabilities.js +1 -200
- package/dist/mcp/server.js +4 -1233
- package/dist/mcp/tool-definitions.js +1 -804
- package/dist/sdk/actionability.js +1 -13
- package/dist/sdk/agent/closed-domain-contracts.js +1 -161
- package/dist/sdk/agent/command-recovery.js +1 -59
- package/dist/sdk/agent/command-suggestions.js +1 -66
- package/dist/sdk/agent/create-option-policy.js +1 -31
- package/dist/sdk/agent/identity-config.js +1 -106
- package/dist/sdk/agent/item-addressing.js +1 -207
- package/dist/sdk/agent/refusal-closure-census.js +1 -151
- package/dist/sdk/agent/refusal-closure.js +1 -133
- package/dist/sdk/agent/refusal-corpus-contracts.js +1 -193
- package/dist/sdk/agent/refusal-reachability.js +1 -593
- package/dist/sdk/agent/subcommand-recovery.js +1 -83
- package/dist/sdk/agent/task-transcript-contracts.js +1 -197
- package/dist/sdk/agent/tracker-preflight-contracts.js +1 -126
- package/dist/sdk/agent-capability-contracts.js +1 -428
- package/dist/sdk/agent-session-context.js +1 -9
- package/dist/sdk/annotations.js +1 -448
- package/dist/sdk/author-attribution.js +1 -468
- package/dist/sdk/authoring.js +1 -20
- package/dist/sdk/cli-bootstrap.js +1 -838
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts/agent-output-contracts.js +4 -476
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.js +1 -79
- package/dist/sdk/cli-contracts/command-aliases.d.ts +4 -0
- package/dist/sdk/cli-contracts/command-aliases.js +1 -107
- package/dist/sdk/cli-contracts/command-exit-contracts.js +1 -151
- package/dist/sdk/cli-contracts/commander-mutation-options.js +1 -1081
- package/dist/sdk/cli-contracts/commander-types.js +1 -159
- package/dist/sdk/cli-contracts/completeness.js +1 -393
- package/dist/sdk/cli-contracts/enum-contracts.js +1 -222
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1947
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -347
- package/dist/sdk/cli-contracts/grammar-contracts.js +1 -986
- package/dist/sdk/cli-contracts/registration-helpers.js +7 -990
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +5 -0
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -2090
- package/dist/sdk/cli-contracts/schemas/assurance-definition.js +1 -324
- package/dist/sdk/cli-contracts/string-lists.js +1 -16
- package/dist/sdk/cli-contracts/tool-option-contracts.js +1 -461
- package/dist/sdk/cli-contracts/tool-parameter-tables.js +1 -2167
- package/dist/sdk/cli-contracts/tool-schema.d.ts +3 -1
- package/dist/sdk/cli-contracts/tool-schema.js +1 -1664
- package/dist/sdk/cli-contracts/typed-action-inputs.js +1 -4
- package/dist/sdk/cli-contracts.d.ts +1 -1
- package/dist/sdk/cli-contracts.js +1 -17
- package/dist/sdk/cli-program.js +1 -49
- package/dist/sdk/command-line.d.ts +2 -5
- package/dist/sdk/command-line.js +1 -78
- package/dist/sdk/comments.js +1 -133
- package/dist/sdk/compile-cache.js +1 -73
- package/dist/sdk/completion.js +157 -837
- package/dist/sdk/compose.js +1 -1090
- package/dist/sdk/config.js +1 -1204
- package/dist/sdk/context/recency.js +1 -33
- package/dist/sdk/context/semantic-session-attribution.js +1 -82
- package/dist/sdk/context/usage-egress.js +1 -29
- package/dist/sdk/context/usage-ledger.js +3 -185
- package/dist/sdk/context-intent-contracts.js +1 -709
- package/dist/sdk/context-intent-runtime.js +1 -115
- package/dist/sdk/context-packing.js +1 -218
- package/dist/sdk/context-relevance.js +1 -503
- package/dist/sdk/context-signal-store.js +2 -426
- package/dist/sdk/context-usage.js +1 -367
- package/dist/sdk/contracts.js +1 -23
- package/dist/sdk/core-governance.js +1 -14
- package/dist/sdk/core.js +1 -14
- package/dist/sdk/corpus-shape.js +1 -401
- package/dist/sdk/define.js +1 -220
- package/dist/sdk/dependencies.js +1 -718
- package/dist/sdk/dependency-flag-validation.js +1 -156
- package/dist/sdk/dependency-provenance.js +1 -135
- package/dist/sdk/docs.js +1 -14
- package/dist/sdk/duplicates.js +1 -40
- package/dist/sdk/environment/agent-environment.js +1 -466
- package/dist/sdk/environment/host-environment-errors.js +1 -8
- package/dist/sdk/environment/project-runtime-compatibility.js +1 -481
- package/dist/sdk/environment/source-context.js +1 -28
- package/dist/sdk/environment/tracker-preflight.js +1 -9
- package/dist/sdk/error-code-catalog.js +1 -153
- package/dist/sdk/error-runtime.js +1 -58
- package/dist/sdk/errors.js +1 -58
- package/dist/sdk/eval.js +1 -190
- package/dist/sdk/extension/author-manifest.js +1 -92
- package/dist/sdk/extension/bundled-catalog.js +1 -332
- package/dist/sdk/extension/concurrency.js +1 -25
- package/dist/sdk/extension/copy-scope.d.ts +2 -0
- package/dist/sdk/extension/copy-scope.js +2 -0
- package/dist/sdk/extension/custom-field-collisions.js +1 -30
- package/dist/sdk/extension/describe.js +3 -189
- package/dist/sdk/extension/doctor.js +1 -606
- package/dist/sdk/extension/install-plan.d.ts +69 -0
- package/dist/sdk/extension/install-plan.js +2 -0
- package/dist/sdk/extension/install-receipts.d.ts +7 -0
- package/dist/sdk/extension/install-receipts.js +2 -0
- package/dist/sdk/extension/install-runtime.js +3 -313
- package/dist/sdk/extension/install-snapshot.js +1 -66
- package/dist/sdk/extension/install-sources.js +5 -1057
- package/dist/sdk/extension/managed-state.js +2 -252
- package/dist/sdk/extension/migrations.js +2 -174
- package/dist/sdk/extension/output-ownership.js +1 -25
- package/dist/sdk/extension/runtime-summary.js +1 -18
- package/dist/sdk/extension/scaffold.js +4 -2308
- package/dist/sdk/extension/shared.js +1 -147
- package/dist/sdk/extension/source-resolution.js +1 -65
- package/dist/sdk/extension/update-check.js +1 -67
- package/dist/sdk/extension-command-context.js +1 -44
- package/dist/sdk/extension-contracts.js +1 -73
- package/dist/sdk/extension.d.ts +7 -2
- package/dist/sdk/extension.js +1 -2196
- package/dist/sdk/files.js +1 -535
- package/dist/sdk/flag-invocation-contracts.d.ts +0 -5
- package/dist/sdk/flag-invocation-contracts.js +1 -344
- package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -2224
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -2236
- package/dist/sdk/generated-error-code-catalog.js +1 -16
- package/dist/sdk/governance/assurance-action-contracts.js +1 -4
- package/dist/sdk/governance/assurance-action.js +1 -411
- package/dist/sdk/governance/assurance-limits.js +1 -10
- package/dist/sdk/governance/assurance-mutation-error.js +1 -81
- package/dist/sdk/governance/assurance-presets.js +1 -135
- package/dist/sdk/governance/assurance-runtime.js +1 -238
- package/dist/sdk/governance/assurance.js +4 -1182
- package/dist/sdk/governance/boundary-fixtures.js +1 -200
- package/dist/sdk/governance/coverage-assurance.js +1 -60
- package/dist/sdk/governance/defect-recurrence-coverage.js +1 -188
- package/dist/sdk/governance/defect-recurrence-graph.js +1 -120
- package/dist/sdk/governance/defect-recurrence-signals.js +1 -24
- package/dist/sdk/governance/defect-recurrence.js +1 -623
- package/dist/sdk/governance/extension-host-version.js +1 -115
- package/dist/sdk/governance/gc.js +1 -368
- package/dist/sdk/governance/health.js +1 -2367
- package/dist/sdk/governance/hierarchy-validation.js +1 -108
- package/dist/sdk/governance/linked-file-report.js +1 -71
- package/dist/sdk/governance/merge-receipt-history.js +1 -206
- package/dist/sdk/governance/provenance-health.js +1 -282
- package/dist/sdk/governance/reindex.js +4 -761
- package/dist/sdk/governance/stale-work.js +1 -82
- package/dist/sdk/governance/status-role-diagnostics.js +1 -35
- package/dist/sdk/governance/storage-integrity.js +1 -280
- package/dist/sdk/governance/tracked-runtime-cache.js +1 -106
- package/dist/sdk/governance/upgrade.js +2 -327
- package/dist/sdk/governance/validate-history-drift.js +1 -81
- package/dist/sdk/governance/validate-item-reader.js +1 -17
- package/dist/sdk/governance/validate-normalization.js +1 -36
- package/dist/sdk/governance/validate.js +1 -2261
- package/dist/sdk/governance/workspace-position.js +1 -163
- package/dist/sdk/governance.d.ts +1 -0
- package/dist/sdk/governance.js +1 -31
- package/dist/sdk/graph/adapter.js +1 -181
- package/dist/sdk/graph/analytics.js +1 -474
- package/dist/sdk/graph/assembly.js +1 -377
- package/dist/sdk/graph/cache.js +1 -160
- package/dist/sdk/graph/centrality.js +1 -258
- package/dist/sdk/graph/conformance.js +1 -130
- package/dist/sdk/graph/deadline-scheduling.d.ts +90 -0
- package/dist/sdk/graph/deadline-scheduling.js +2 -0
- package/dist/sdk/graph/durable-cache.d.ts +1 -1
- package/dist/sdk/graph/durable-cache.js +1 -361
- package/dist/sdk/graph/governance-contracts.js +1 -34
- package/dist/sdk/graph/governance.d.ts +13 -1
- package/dist/sdk/graph/governance.js +1 -735
- package/dist/sdk/graph/hierarchy-integrity.js +1 -310
- package/dist/sdk/graph/index.d.ts +3 -2
- package/dist/sdk/graph/index.js +1 -26
- package/dist/sdk/graph/lifecycle-coverage.d.ts +32 -0
- package/dist/sdk/graph/lifecycle-coverage.js +2 -0
- package/dist/sdk/graph/mutation-advisory.js +1 -176
- package/dist/sdk/graph/remediation.js +1 -197
- package/dist/sdk/graph/run.d.ts +15 -1
- package/dist/sdk/graph/run.js +1 -768
- package/dist/sdk/graph/scheduling.js +1 -124
- package/dist/sdk/graph/traversal.js +1 -284
- package/dist/sdk/graph/workspace-relationship-kind-registry.js +1 -27
- package/dist/sdk/graph.js +1 -15
- package/dist/sdk/guide-topics.js +1 -707
- package/dist/sdk/guide.js +1 -279
- package/dist/sdk/history/maintenance.d.ts +71 -0
- package/dist/sdk/history/maintenance.js +2 -0
- package/dist/sdk/history/salvage.js +2 -247
- package/dist/sdk/history/subject.d.ts +19 -0
- package/dist/sdk/history/subject.js +2 -0
- package/dist/sdk/history-analytics.js +1 -282
- package/dist/sdk/history-compact.js +1 -527
- package/dist/sdk/history-mcp.js +1 -68
- package/dist/sdk/history-provenance.js +1 -182
- package/dist/sdk/history-read.js +1 -96
- package/dist/sdk/history-redact.d.ts +1 -14
- package/dist/sdk/history-redact.js +1 -643
- package/dist/sdk/history-repair.d.ts +5 -0
- package/dist/sdk/history-repair.js +1 -657
- package/dist/sdk/improvement-ledger-validation.js +1 -62
- package/dist/sdk/improvement-ledger.js +2 -257
- package/dist/sdk/index.d.ts +4 -0
- package/dist/sdk/index.js +1 -183
- package/dist/sdk/init-agent-guidance.js +2 -496
- package/dist/sdk/init.js +2 -820
- package/dist/sdk/invocation-author.js +1 -39
- package/dist/sdk/item-children.js +1 -90
- package/dist/sdk/item-metadata-index.js +1 -15
- package/dist/sdk/item-schedule.js +1 -27
- package/dist/sdk/item-transaction.js +1 -396
- package/dist/sdk/learnings.js +1 -29
- package/dist/sdk/lifecycle/append.js +2 -53
- package/dist/sdk/lifecycle/claim.d.ts +2 -0
- package/dist/sdk/lifecycle/claim.js +1 -242
- package/dist/sdk/lifecycle/close-many.js +1 -438
- package/dist/sdk/lifecycle/close.js +1 -468
- package/dist/sdk/lifecycle/copy.js +1 -212
- package/dist/sdk/lifecycle/create.js +1 -1949
- package/dist/sdk/lifecycle/delete.js +1 -45
- package/dist/sdk/lifecycle/event-validation-messages.js +1 -91
- package/dist/sdk/lifecycle/focus.js +1 -91
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.js +1 -24
- package/dist/sdk/lifecycle/legacy-none-tokens.js +1 -149
- package/dist/sdk/lifecycle/lifecycle-transitions.js +1 -40
- package/dist/sdk/lifecycle/mcp-actions.d.ts +2 -0
- package/dist/sdk/lifecycle/mcp-actions.js +1 -51
- package/dist/sdk/lifecycle/metadata-normalizers.js +1 -46
- package/dist/sdk/lifecycle/mutation-command-options.js +1 -9
- package/dist/sdk/lifecycle/plan.js +1 -1606
- package/dist/sdk/lifecycle/recurrence-parsers.js +1 -147
- package/dist/sdk/lifecycle/reopen.js +1 -68
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.js +1 -143
- package/dist/sdk/lifecycle/restore.d.ts +1 -0
- package/dist/sdk/lifecycle/restore.js +1 -330
- package/dist/sdk/lifecycle/shared-unset-fields.js +1 -295
- package/dist/sdk/lifecycle/update-many.js +1 -861
- package/dist/sdk/lifecycle/update.js +1 -2136
- package/dist/sdk/lifecycle-completion.js +1 -92
- package/dist/sdk/lifecycle-policy.js +1 -120
- package/dist/sdk/linked-artifacts.js +1 -530
- package/dist/sdk/mcp/apps.js +4 -133
- package/dist/sdk/mcp/authorization.js +1 -404
- package/dist/sdk/mcp/discovery.js +1 -494
- package/dist/sdk/mcp/interactions.js +1 -336
- package/dist/sdk/mcp/protocol.d.ts +7 -0
- package/dist/sdk/mcp/protocol.js +1 -184
- package/dist/sdk/mcp/skills.js +1 -389
- package/dist/sdk/mcp/subscriptions.js +1 -211
- package/dist/sdk/mcp/tasks.js +2 -430
- package/dist/sdk/mcp/transport.js +1 -260
- package/dist/sdk/merge/abandoned-receipts.js +1 -46
- package/dist/sdk/merge/driver.js +1 -212
- package/dist/sdk/merge/index.js +1 -16
- package/dist/sdk/merge/install.js +3 -561
- package/dist/sdk/merge/receipt-file-boundary.js +1 -46
- package/dist/sdk/merge/receipt-operation.js +1 -96
- package/dist/sdk/merge/receipt-schema.js +1 -397
- package/dist/sdk/merge/receipts.js +4 -525
- package/dist/sdk/merge/reconcile.js +1 -352
- package/dist/sdk/merge/three-way.js +3 -775
- package/dist/sdk/merge.js +1 -10
- package/dist/sdk/mutation-events.js +1 -292
- package/dist/sdk/mutation-guard.js +1 -216
- package/dist/sdk/notes.js +1 -139
- package/dist/sdk/output-contracts.js +1 -172
- package/dist/sdk/output-projection.js +1 -430
- package/dist/sdk/output-token-accounting.js +1 -140
- package/dist/sdk/output.js +1 -64
- package/dist/sdk/ownership-source.js +1 -21
- package/dist/sdk/package-import-adapters.js +1 -442
- package/dist/sdk/package-migrations.js +1 -20
- package/dist/sdk/package-runtime-options.js +1 -80
- package/dist/sdk/pagination.js +1 -162
- package/dist/sdk/profile.js +1 -454
- package/dist/sdk/provenance.js +1 -258
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.js +1 -401
- package/dist/sdk/query/aggregate.d.ts +16 -0
- package/dist/sdk/query/aggregate.js +1 -390
- package/dist/sdk/query/calendar.js +1 -964
- package/dist/sdk/query/complete-list.js +1 -215
- package/dist/sdk/query/context.js +1 -1702
- package/dist/sdk/query/duplicate-candidates.js +1 -70
- package/dist/sdk/query/get.js +1 -450
- package/dist/sdk/query/history.js +1 -186
- package/dist/sdk/query/item-filter-options.js +1 -9
- package/dist/sdk/query/light-metadata.js +1 -18
- package/dist/sdk/query/list-filter-shared.js +1 -81
- package/dist/sdk/query/list.js +1 -1304
- package/dist/sdk/query/multi-value-filters.js +1 -78
- package/dist/sdk/query/next.js +1 -513
- package/dist/sdk/query/parsers.js +1 -44
- package/dist/sdk/query/projection-contracts.js +1 -184
- package/dist/sdk/query/search-contracts.js +1 -230
- package/dist/sdk/query/search-pagination.js +1 -35
- package/dist/sdk/query/search-rendering.js +1 -105
- package/dist/sdk/query/search.js +2 -1987
- package/dist/sdk/query.js +1 -35
- package/dist/sdk/read-output/continuation.js +1 -194
- package/dist/sdk/read-output-budget.js +1 -135
- package/dist/sdk/read-output-contracts.js +1 -1225
- package/dist/sdk/read-output-rows.js +1 -186
- package/dist/sdk/read-output-session.js +1 -208
- package/dist/sdk/relationship-analytics.js +1 -410
- package/dist/sdk/relationship-context.js +1 -284
- package/dist/sdk/relationship-history.js +4 -519
- package/dist/sdk/relationship-kinds/contract.js +1 -22
- package/dist/sdk/relationship-migration.js +1 -77
- package/dist/sdk/relationships.js +1 -579
- package/dist/sdk/reproducibility/process.js +1 -87
- package/dist/sdk/runtime-action-aliases.js +1 -59
- package/dist/sdk/runtime-extended-actions.js +1 -177
- package/dist/sdk/runtime-input.js +1 -614
- package/dist/sdk/runtime-primitives.js +1 -84
- package/dist/sdk/runtime-public-contracts.js +1 -4
- package/dist/sdk/runtime-stats-options.js +1 -38
- package/dist/sdk/runtime.js +1 -1928
- package/dist/sdk/scheduling-shortcuts.js +1 -63
- package/dist/sdk/schema-migration.js +3 -856
- package/dist/sdk/schema.js +1 -1376
- package/dist/sdk/search-refresh-worker.js +1 -18
- package/dist/sdk/similarity-scoring.js +1 -53
- package/dist/sdk/similarity.js +1 -326
- package/dist/sdk/start-task-status.js +1 -14
- package/dist/sdk/stats.js +1 -270
- package/dist/sdk/structured-mutations.js +1 -580
- package/dist/sdk/telemetry-flush.js +1 -13
- package/dist/sdk/telemetry.js +1 -405
- package/dist/sdk/templates.js +2 -292
- package/dist/sdk/test/batch.js +2 -509
- package/dist/sdk/test/entry.js +1 -70
- package/dist/sdk/test/execution.js +6 -2211
- package/dist/sdk/test/linked-command-detection.js +1 -546
- package/dist/sdk/test/measurements.js +1 -91
- package/dist/sdk/test/parsers.js +1 -545
- package/dist/sdk/test/runs.js +1 -193
- package/dist/sdk/test/trust.js +2 -206
- package/dist/sdk/testing.js +4 -1391
- package/dist/sdk/traceability/runtime-files-lookup.js +1 -32
- package/dist/sdk/traceability/source-traceability.js +1 -292
- package/dist/sdk/tracker-root-discovery.js +1 -9
- package/dist/sdk/workspace-contracts-cache.js +1 -28
- package/dist/sdk/workspace-contracts.js +1 -33
- package/dist/sdk/workspace-memory.js +2 -318
- package/dist/sdk/workspace-recipe.js +1 -71
- package/dist/sdk/workspace-snapshot.js +4 -613
- package/dist/sdk/workspace-transaction-gc.js +1 -149
- package/dist/sdk/workspace-transaction.js +2 -363
- package/dist/sdk/workspace.js +3 -127
- package/dist/types/index.js +1 -9
- package/dist/types.js +1 -245
- package/docs/AGENT_GUIDE.md +1 -1
- package/docs/CONTEXT_ALGORITHM_PORTFOLIO.md +167 -0
- package/docs/DIAGNOSTIC_OUTPUT_CONTRACTS.md +9 -3
- package/docs/EXTENSIONS.md +1 -0
- package/docs/HISTORY_MAINTENANCE.md +125 -0
- package/docs/MCP_2026_07_28_CONFORMANCE.md +20 -10
- package/docs/PACKAGE_EVIDENCE.md +92 -0
- package/docs/PLANNING_MEASUREMENTS.md +183 -0
- package/docs/README.md +3 -0
- package/docs/RELEASING.md +1 -0
- package/docs/SCRIPTING.md +21 -0
- package/docs/TESTING.md +23 -0
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +5 -5
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +2 -2
- package/marketplace.json +2 -2
- package/package.json +1 -1
- package/packages/pm-beads/package.json +1 -1
- package/packages/pm-calendar/package.json +1 -1
- package/packages/pm-command-kit/package.json +1 -1
- package/packages/pm-digital-twin/package.json +1 -1
- package/packages/pm-governance-audit/package.json +1 -1
- package/packages/pm-guide-shell/package.json +1 -1
- package/packages/pm-kanban/package.json +1 -1
- package/packages/pm-lifecycle-hooks/package.json +1 -1
- package/packages/pm-linked-test-adapters/package.json +1 -1
- package/packages/pm-search-advanced/package.json +1 -1
- package/packages/pm-templates/package.json +1 -1
- package/packages/pm-todos/package.json +1 -1
- package/packages/pm-vcs/package.json +1 -1
- package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/scripts/finalize-build.mjs +45 -3
- package/dist/cli-bundle/chunks/chunk-AZDFJGH6.js +0 -9
- package/dist/cli-bundle/chunks/chunk-BAX2BYUW.js +0 -2111
- package/dist/cli-bundle/chunks/chunk-CKOL5U7J.js +0 -77
- package/dist/cli-bundle/chunks/chunk-OF76PSDQ.js +0 -5
- package/dist/cli-bundle/chunks/chunk-QUWFABDM.js +0 -232
- package/dist/cli-bundle/chunks/chunk-QWRRFYK3.js +0 -2
- package/dist/cli-bundle/chunks/chunk-RWWBOWJ5.js +0 -2
- package/dist/cli-bundle/chunks/chunk-WGAOYSYH.js +0 -40
- package/dist/cli-bundle/chunks/chunk-WI2AYPA7.js +0 -2
- package/dist/cli-bundle/chunks/register-list-query-5JL52D33.js +0 -11
- package/dist/cli-bundle/chunks/register-mutation-ZPG7KMVP.js +0 -20
- package/dist/cli-bundle/chunks/register-setup-H4SVAVX7.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-AL5ON6K6.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-CHC2IDXA.js +0 -6
- package/dist/cli-bundle/focused-chunks/chunk-CK6QFAPZ.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-EZR3GHFE.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-H2WJWK7L.js +0 -56
- package/dist/cli-bundle/focused-chunks/chunk-NTPY5GSO.js +0 -3
- package/dist/cli-bundle/focused-chunks/chunk-P5O7MP5Y.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDMW2E36.js +0 -177
- package/dist/cli-bundle/focused-chunks/chunk-QTVCLMSZ.js +0 -6
- package/dist/cli-bundle/focused-chunks/chunk-QTZRBUYA.js +0 -8
- package/dist/cli-bundle/focused-chunks/chunk-SGQST3PQ.js +0 -12
- package/dist/cli-bundle/focused-chunks/chunk-UKHASMMP.js +0 -10
- package/dist/cli-bundle/focused-chunks/chunk-ZPEKQHOC.js +0 -2
package/dist/sdk/mcp/apps.js
CHANGED
|
@@ -1,131 +1,4 @@
|
|
|
1
|
-
|
|
2
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e6c49c89-781e-59a3-9c19-6a1c40424587")}catch(e){}}();
|
|
3
|
-
import { PM_MCP_ERROR_CODES, PmMcpProtocolError, isMcpRecord, } from "./protocol.js";
|
|
4
|
-
/** Stable MCP Apps extension identifier. */
|
|
5
|
-
export const PM_MCP_APPS_EXTENSION = "io.modelcontextprotocol/ui";
|
|
6
|
-
/** Stable MCP Apps specification revision implemented by pm. */
|
|
7
|
-
export const PM_MCP_APPS_SPEC_VERSION = "2026-01-26";
|
|
8
|
-
/** Official MIME type for MCP App HTML resources. */
|
|
9
|
-
export const PM_MCP_APP_MIME_TYPE = "text/html;profile=mcp-app";
|
|
10
|
-
/** Server-side MCP Apps capability advertised through discovery. */
|
|
11
|
-
export const PM_MCP_APPS_SERVER_CAPABILITY = Object.freeze({
|
|
12
|
-
specVersion: PM_MCP_APPS_SPEC_VERSION,
|
|
13
|
-
mimeTypes: [PM_MCP_APP_MIME_TYPE],
|
|
14
|
-
});
|
|
15
|
-
/**
|
|
16
|
-
* Resolve whether a request negotiated MCP Apps, rejecting malformed explicit
|
|
17
|
-
* declarations instead of silently serving a different extension revision.
|
|
18
|
-
*/
|
|
19
|
-
export function hasPmMcpAppsCapability(context) {
|
|
20
|
-
const extensions = context.clientCapabilities.extensions;
|
|
21
|
-
if (!isMcpRecord(extensions))
|
|
22
|
-
return false;
|
|
23
|
-
const declaration = extensions[PM_MCP_APPS_EXTENSION];
|
|
24
|
-
if (declaration === undefined)
|
|
25
|
-
return false;
|
|
26
|
-
if (!isMcpRecord(declaration)) {
|
|
27
|
-
throw new PmMcpProtocolError("Invalid MCP Apps client capability", PM_MCP_ERROR_CODES.missingRequiredClientCapability, { requiredCapabilities: { extensions: { [PM_MCP_APPS_EXTENSION]: PM_MCP_APPS_SERVER_CAPABILITY } } });
|
|
28
|
-
}
|
|
29
|
-
const mimeTypes = declaration.mimeTypes;
|
|
30
|
-
const specVersion = declaration.specVersion;
|
|
31
|
-
if (!Array.isArray(mimeTypes) ||
|
|
32
|
-
!mimeTypes.includes(PM_MCP_APP_MIME_TYPE) ||
|
|
33
|
-
(specVersion !== undefined && specVersion !== PM_MCP_APPS_SPEC_VERSION)) {
|
|
34
|
-
throw new PmMcpProtocolError("Unsupported MCP Apps client capability", PM_MCP_ERROR_CODES.missingRequiredClientCapability, { requiredCapabilities: { extensions: { [PM_MCP_APPS_EXTENSION]: PM_MCP_APPS_SERVER_CAPABILITY } } });
|
|
35
|
-
}
|
|
36
|
-
return true;
|
|
37
|
-
}
|
|
38
|
-
const PRIVATE_APP_RESOURCE_META = {
|
|
39
|
-
csp: { connectDomains: [], resourceDomains: [], frameDomains: [] },
|
|
40
|
-
permissions: {},
|
|
41
|
-
prefersBorder: true,
|
|
42
|
-
};
|
|
43
|
-
/** Canonical optional pm MCP Apps. */
|
|
44
|
-
export const PM_MCP_APP_CONTRACTS = Object.freeze([
|
|
45
|
-
{
|
|
46
|
-
id: "context",
|
|
47
|
-
name: "Context explorer",
|
|
48
|
-
description: "Inspect bounded project context, provenance, omissions, and token accounting.",
|
|
49
|
-
toolName: "pm_context",
|
|
50
|
-
uri: "ui://pm/context.html",
|
|
51
|
-
},
|
|
52
|
-
{
|
|
53
|
-
id: "graph",
|
|
54
|
-
name: "Relationship graph",
|
|
55
|
-
description: "Explore typed relationships, explaining paths, and graph-governance evidence.",
|
|
56
|
-
toolName: "pm_graph",
|
|
57
|
-
uri: "ui://pm/graph.html",
|
|
58
|
-
},
|
|
59
|
-
{
|
|
60
|
-
id: "plan",
|
|
61
|
-
name: "Plan and milestone view",
|
|
62
|
-
description: "Review durable plan steps, dependencies, decisions, discoveries, and validation state.",
|
|
63
|
-
toolName: "pm_plan",
|
|
64
|
-
uri: "ui://pm/plan.html",
|
|
65
|
-
},
|
|
66
|
-
{
|
|
67
|
-
id: "assurance",
|
|
68
|
-
name: "Assurance dashboard",
|
|
69
|
-
description: "Inspect validation verdicts, evidence, omissions, and actionable recovery paths.",
|
|
70
|
-
toolName: "pm_validate",
|
|
71
|
-
uri: "ui://pm/assurance.html",
|
|
72
|
-
},
|
|
73
|
-
{
|
|
74
|
-
id: "operations",
|
|
75
|
-
name: "Long-operation view",
|
|
76
|
-
description: "Inspect durable test and operation results without creating a second task store.",
|
|
77
|
-
toolName: "pm_test",
|
|
78
|
-
uri: "ui://pm/operations.html",
|
|
79
|
-
},
|
|
80
|
-
].map((contract) => ({
|
|
81
|
-
...contract,
|
|
82
|
-
toolMeta: {
|
|
83
|
-
resourceUri: contract.uri,
|
|
84
|
-
visibility: ["model", "app"],
|
|
85
|
-
},
|
|
86
|
-
resourceMeta: PRIVATE_APP_RESOURCE_META,
|
|
87
|
-
})));
|
|
88
|
-
/** Return the app contract for a resource URI. */
|
|
89
|
-
export function findPmMcpAppByUri(uri) {
|
|
90
|
-
return PM_MCP_APP_CONTRACTS.find((contract) => contract.uri === uri);
|
|
91
|
-
}
|
|
92
|
-
/** Attach negotiated MCP App metadata to matching tool definitions. */
|
|
93
|
-
export function decoratePmMcpToolsWithApps(tools) {
|
|
94
|
-
const appsByTool = new Map(PM_MCP_APP_CONTRACTS.map((contract) => [contract.toolName, contract]));
|
|
95
|
-
return tools.map((tool) => {
|
|
96
|
-
const app = appsByTool.get(tool.name);
|
|
97
|
-
return app
|
|
98
|
-
? {
|
|
99
|
-
...tool,
|
|
100
|
-
_meta: { ...tool._meta, ui: app.toolMeta },
|
|
101
|
-
}
|
|
102
|
-
: { ...tool };
|
|
103
|
-
});
|
|
104
|
-
}
|
|
105
|
-
function escapeHtml(value) {
|
|
106
|
-
return value
|
|
107
|
-
.replaceAll("&", "&")
|
|
108
|
-
.replaceAll("<", "<")
|
|
109
|
-
.replaceAll(">", ">")
|
|
110
|
-
.replaceAll('"', """)
|
|
111
|
-
.replaceAll("'", "'");
|
|
112
|
-
}
|
|
113
|
-
/**
|
|
114
|
-
* Render a self-contained, sandbox-compatible MCP App document.
|
|
115
|
-
*
|
|
116
|
-
* The view keeps no durable state and exposes no mutation control. It receives
|
|
117
|
-
* the authoritative tool input/result from the host, bounds large rendering,
|
|
118
|
-
* and presents the text fallback when structured content is unavailable.
|
|
119
|
-
*/
|
|
120
|
-
export function renderPmMcpAppHtml(contract) {
|
|
121
|
-
const title = escapeHtml(contract.name);
|
|
122
|
-
const description = escapeHtml(contract.description);
|
|
123
|
-
const appInfo = JSON.stringify({
|
|
124
|
-
name: `pm-${contract.id}-view`,
|
|
125
|
-
version: PM_MCP_APPS_SPEC_VERSION,
|
|
126
|
-
});
|
|
127
|
-
const protocolVersion = JSON.stringify(PM_MCP_APPS_SPEC_VERSION);
|
|
128
|
-
return `<!doctype html>
|
|
1
|
+
!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4f17095e-2dba-530c-935c-1803ed359510")}catch(e2){}})();import{PM_MCP_ERROR_CODES,PmMcpProtocolError,isMcpRecord}from"./protocol.js";const PM_MCP_APPS_EXTENSION="io.modelcontextprotocol/ui";const PM_MCP_APPS_SPEC_VERSION="2026-01-26";const PM_MCP_APP_MIME_TYPE="text/html;profile=mcp-app";const PM_MCP_APPS_SERVER_CAPABILITY=Object.freeze({specVersion:PM_MCP_APPS_SPEC_VERSION,mimeTypes:[PM_MCP_APP_MIME_TYPE]});function hasPmMcpAppsCapability(context){const extensions=context.clientCapabilities.extensions;if(!isMcpRecord(extensions))return false;const declaration=extensions[PM_MCP_APPS_EXTENSION];if(declaration===void 0)return false;if(!isMcpRecord(declaration)){throw new PmMcpProtocolError("Invalid MCP Apps client capability",PM_MCP_ERROR_CODES.missingRequiredClientCapability,{requiredCapabilities:{extensions:{[PM_MCP_APPS_EXTENSION]:PM_MCP_APPS_SERVER_CAPABILITY}}})}const mimeTypes=declaration.mimeTypes;const specVersion=declaration.specVersion;if(!Array.isArray(mimeTypes)||!mimeTypes.includes(PM_MCP_APP_MIME_TYPE)||specVersion!==void 0&&specVersion!==PM_MCP_APPS_SPEC_VERSION){throw new PmMcpProtocolError("Unsupported MCP Apps client capability",PM_MCP_ERROR_CODES.missingRequiredClientCapability,{requiredCapabilities:{extensions:{[PM_MCP_APPS_EXTENSION]:PM_MCP_APPS_SERVER_CAPABILITY}}})}return true}const PRIVATE_APP_RESOURCE_META={csp:{connectDomains:[],resourceDomains:[],frameDomains:[]},permissions:{},prefersBorder:true};const PM_MCP_APP_CONTRACTS=Object.freeze([{id:"context",name:"Context explorer",description:"Inspect bounded project context, provenance, omissions, and token accounting.",toolName:"pm_context",uri:"ui://pm/context.html"},{id:"graph",name:"Relationship graph",description:"Explore typed relationships, explaining paths, and graph-governance evidence.",toolName:"pm_graph",uri:"ui://pm/graph.html"},{id:"plan",name:"Plan and milestone view",description:"Review durable plan steps, dependencies, decisions, discoveries, and validation state.",toolName:"pm_plan",uri:"ui://pm/plan.html"},{id:"assurance",name:"Assurance dashboard",description:"Inspect validation verdicts, evidence, omissions, and actionable recovery paths.",toolName:"pm_validate",uri:"ui://pm/assurance.html"},{id:"operations",name:"Long-operation view",description:"Inspect durable test and operation results without creating a second task store.",toolName:"pm_test",uri:"ui://pm/operations.html"}].map(contract=>({...contract,toolMeta:{resourceUri:contract.uri,visibility:["model","app"]},resourceMeta:PRIVATE_APP_RESOURCE_META})));function findPmMcpAppByUri(uri){return PM_MCP_APP_CONTRACTS.find(contract=>contract.uri===uri)}function decoratePmMcpToolsWithApps(tools){const appsByTool=new Map(PM_MCP_APP_CONTRACTS.map(contract=>[contract.toolName,contract]));return tools.map(tool=>{const app=appsByTool.get(tool.name);return app?{...tool,_meta:{...tool._meta,ui:app.toolMeta}}:{...tool}})}function escapeHtml(value){return value.replaceAll("&","&").replaceAll("<","<").replaceAll(">",">").replaceAll('"',""").replaceAll("'","'")}function renderPmMcpAppHtml(contract){const title=escapeHtml(contract.name);const description=escapeHtml(contract.description);const appInfo=JSON.stringify({name:`pm-${contract.id}-view`,version:PM_MCP_APPS_SPEC_VERSION});const protocolVersion=JSON.stringify(PM_MCP_APPS_SPEC_VERSION);return`<!doctype html>
|
|
129
2
|
<html lang="en">
|
|
130
3
|
<head>
|
|
131
4
|
<meta charset="utf-8">
|
|
@@ -140,15 +13,13 @@ export function renderPmMcpAppHtml(contract) {
|
|
|
140
13
|
<body>
|
|
141
14
|
<main>
|
|
142
15
|
<header><div class="status" id="status" role="status" aria-live="polite">Connecting to host</div><h1>${title}</h1><p>${description}</p></header>
|
|
143
|
-
<section aria-labelledby="summary-title"><h2 id="summary-title">Authoritative result</h2><pre id="result" tabindex="0">Waiting for the host tool result
|
|
16
|
+
<section aria-labelledby="summary-title"><h2 id="summary-title">Authoritative result</h2><pre id="result" tabindex="0">Waiting for the host tool result\u2026</pre></section>
|
|
144
17
|
<section aria-labelledby="input-title"><h2 id="input-title">Invocation context</h2><pre id="input" tabindex="0">No tool input received.</pre></section>
|
|
145
18
|
<button type="button" id="copy">Copy visible evidence</button>
|
|
146
19
|
</main>
|
|
147
20
|
<script>
|
|
148
|
-
(()=>{"use strict";const MAX=24000,status=document.querySelector("#status"),result=document.querySelector("#result"),input=document.querySelector("#input"),pending=new Map();let nextId=1;const render=(node,value)=>{let text;try{text=typeof value==="string"?value:JSON.stringify(value,null,2)}catch{text="Result could not be serialized."}if(text.length>MAX)text=text.slice(0,MAX)+"\\n\\n[View truncated at "+MAX+" characters; use the authoritative pm tool with a cursor or narrower projection.]";node.textContent=text};const send=(message)=>window.parent.postMessage(message,"*");window.addEventListener("message",event=>{if(event.source!==window.parent||!event.data||event.data.jsonrpc!=="2.0")return;const message=event.data;if(message.id!==undefined&&pending.has(message.id)){pending.get(message.id)(message);pending.delete(message.id);return}if(message.method==="ui/notifications/tool-input"||message.method==="ui/notifications/tool-input-partial"){render(input,message.params?.arguments??message.params);status.textContent="Input received"}else if(message.method==="ui/notifications/tool-result"){render(result,message.params);status.textContent="Current tool result"}else if(message.method==="ui/notifications/tool-cancelled"){status.textContent="Tool call cancelled";status.classList.add("notice")}else if(message.method==="ui/notifications/host-context-changed"&&message.params?.theme){document.documentElement.style.colorScheme=message.params.theme}});const request=(method,params)=>new Promise(resolve=>{const id=nextId++;pending.set(id,resolve);send({jsonrpc:"2.0",id,method,params})});document.querySelector("#copy").addEventListener("click",async()=>{const text=result.textContent+"\\n\\n"+input.textContent;try{await navigator.clipboard.writeText(text);status.textContent="Visible evidence copied"}catch{status.textContent="Clipboard permission unavailable";status.classList.add("notice")}});request("ui/initialize",{appInfo:${appInfo},appCapabilities:{},protocolVersion:${protocolVersion}}).then(message=>{if(message.error){status.textContent="Host rejected MCP App initialization";status.classList.add("notice");return}send({jsonrpc:"2.0",method:"ui/notifications/initialized"});status.textContent="Connected
|
|
21
|
+
(()=>{"use strict";const MAX=24000,status=document.querySelector("#status"),result=document.querySelector("#result"),input=document.querySelector("#input"),pending=new Map();let nextId=1;const render=(node,value)=>{let text;try{text=typeof value==="string"?value:JSON.stringify(value,null,2)}catch{text="Result could not be serialized."}if(text.length>MAX)text=text.slice(0,MAX)+"\\n\\n[View truncated at "+MAX+" characters; use the authoritative pm tool with a cursor or narrower projection.]";node.textContent=text};const send=(message)=>window.parent.postMessage(message,"*");window.addEventListener("message",event=>{if(event.source!==window.parent||!event.data||event.data.jsonrpc!=="2.0")return;const message=event.data;if(message.id!==undefined&&pending.has(message.id)){pending.get(message.id)(message);pending.delete(message.id);return}if(message.method==="ui/notifications/tool-input"||message.method==="ui/notifications/tool-input-partial"){render(input,message.params?.arguments??message.params);status.textContent="Input received"}else if(message.method==="ui/notifications/tool-result"){render(result,message.params);status.textContent="Current tool result"}else if(message.method==="ui/notifications/tool-cancelled"){status.textContent="Tool call cancelled";status.classList.add("notice")}else if(message.method==="ui/notifications/host-context-changed"&&message.params?.theme){document.documentElement.style.colorScheme=message.params.theme}});const request=(method,params)=>new Promise(resolve=>{const id=nextId++;pending.set(id,resolve);send({jsonrpc:"2.0",id,method,params})});document.querySelector("#copy").addEventListener("click",async()=>{const text=result.textContent+"\\n\\n"+input.textContent;try{await navigator.clipboard.writeText(text);status.textContent="Visible evidence copied"}catch{status.textContent="Clipboard permission unavailable";status.classList.add("notice")}});request("ui/initialize",{appInfo:${appInfo},appCapabilities:{},protocolVersion:${protocolVersion}}).then(message=>{if(message.error){status.textContent="Host rejected MCP App initialization";status.classList.add("notice");return}send({jsonrpc:"2.0",method:"ui/notifications/initialized"});status.textContent="Connected \u2014 awaiting authoritative result"})})();
|
|
149
22
|
</script>
|
|
150
23
|
</body>
|
|
151
|
-
</html
|
|
152
|
-
}
|
|
24
|
+
</html>`}export{PM_MCP_APPS_EXTENSION,PM_MCP_APPS_SERVER_CAPABILITY,PM_MCP_APPS_SPEC_VERSION,PM_MCP_APP_CONTRACTS,PM_MCP_APP_MIME_TYPE,decoratePmMcpToolsWithApps,findPmMcpAppByUri,hasPmMcpAppsCapability,renderPmMcpAppHtml};
|
|
153
25
|
//# sourceMappingURL=apps.js.map
|
|
154
|
-
//# debugId=e6c49c89-781e-59a3-9c19-6a1c40424587
|
|
@@ -1,405 +1,2 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module sdk/mcp/authorization
|
|
3
|
-
*
|
|
4
|
-
* Defines issuer-bound OAuth resource-server, client-registration, credential,
|
|
5
|
-
* and privacy-bounded trace propagation primitives for remote MCP transports.
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a9aefc86-a8ce-5ecf-bb54-e5fa3ea277c7")}catch(e){}}();
|
|
9
|
-
import { AsyncLocalStorage } from "node:async_hooks";
|
|
10
|
-
import { createHash, timingSafeEqual } from "node:crypto";
|
|
11
|
-
import { isMcpRecord } from "./protocol.js";
|
|
12
|
-
/** Authorization failure with an HTTP status and disclosure-safe context. */
|
|
13
|
-
export class PmMcpAuthorizationError extends Error {
|
|
14
|
-
/** HTTP status required at the remote MCP boundary. */
|
|
15
|
-
httpStatus;
|
|
16
|
-
/** Optional RFC 6750 challenge safe to send to an unauthenticated client. */
|
|
17
|
-
challenge;
|
|
18
|
-
/** Create one remote authorization refusal. */
|
|
19
|
-
constructor(message, httpStatus, challenge) {
|
|
20
|
-
super(message);
|
|
21
|
-
this.name = "PmMcpAuthorizationError";
|
|
22
|
-
this.httpStatus = httpStatus;
|
|
23
|
-
this.challenge = challenge;
|
|
24
|
-
}
|
|
25
|
-
}
|
|
26
|
-
const TRACE_PARENT_PATTERN = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/u;
|
|
27
|
-
const TRACE_STATE_SIMPLE_KEY_PATTERN = /^[a-z][a-z0-9_*/-]{0,255}$/u;
|
|
28
|
-
const TRACE_STATE_TENANT_KEY_PATTERN = /^(?:[a-z0-9][a-z0-9_*/-]{0,240})@[a-z][a-z0-9_*/-]{0,13}$/u;
|
|
29
|
-
const TRACE_STATE_VALUE_PATTERN = /^[\x20-\x2B\x2D-\x3C\x3E-\x7E]{0,255}[\x21-\x2B\x2D-\x3C\x3E-\x7E]$/u;
|
|
30
|
-
const SCOPE_PATTERN = /^[\x21\x23-\x5B\x5D-\x7E]+$/u;
|
|
31
|
-
const BAGGAGE_KEY_PATTERN = /^[A-Za-z0-9!#$%&'*+.^_`|~-]+$/u;
|
|
32
|
-
const BAGGAGE_VALUE_PATTERN = /^[\x21\x23-\x2B\x2D-\x3A\x3C-\x5B\x5D-\x7E]*$/u;
|
|
33
|
-
const INVALID_PERCENT_ENCODING_PATTERN = /%(?![0-9A-Fa-f]{2})/u;
|
|
34
|
-
const MAX_TRACE_STATE_BYTES = 512;
|
|
35
|
-
const MAX_TRACE_STATE_MEMBERS = 32;
|
|
36
|
-
const MAX_BAGGAGE_MEMBERS = 180;
|
|
37
|
-
const MAX_BAGGAGE_BYTES = 8_192;
|
|
38
|
-
const MAX_BEARER_TOKEN_BYTES = 8_192;
|
|
39
|
-
const MCP_TRACE_CONTEXT_STORAGE = new AsyncLocalStorage();
|
|
40
|
-
function requireAbsoluteAuthorizationUrl(value, field, allowLocalHttp = false) {
|
|
41
|
-
if (/\p{Cc}/u.test(value)) {
|
|
42
|
-
throw new PmMcpAuthorizationError(`Invalid ${field}`, 401);
|
|
43
|
-
}
|
|
44
|
-
let parsed;
|
|
45
|
-
try {
|
|
46
|
-
parsed = new URL(value);
|
|
47
|
-
}
|
|
48
|
-
catch {
|
|
49
|
-
throw new PmMcpAuthorizationError(`Invalid ${field}`, 401);
|
|
50
|
-
}
|
|
51
|
-
const local = parsed.hostname === "127.0.0.1" || parsed.hostname === "localhost";
|
|
52
|
-
if (parsed.hash.length > 0 ||
|
|
53
|
-
(parsed.protocol !== "https:" &&
|
|
54
|
-
!(allowLocalHttp && local && parsed.protocol === "http:"))) {
|
|
55
|
-
throw new PmMcpAuthorizationError(`Invalid ${field}`, 401);
|
|
56
|
-
}
|
|
57
|
-
return parsed;
|
|
58
|
-
}
|
|
59
|
-
function readHeader(headers, name) {
|
|
60
|
-
const expected = name.toLowerCase();
|
|
61
|
-
for (const [candidate, value] of Object.entries(headers)) {
|
|
62
|
-
if (candidate.toLowerCase() !== expected || value === undefined)
|
|
63
|
-
continue;
|
|
64
|
-
return typeof value === "string" ? value : value.join(", ");
|
|
65
|
-
}
|
|
66
|
-
return undefined;
|
|
67
|
-
}
|
|
68
|
-
/** Build and validate protected-resource metadata for a remote pm endpoint. */
|
|
69
|
-
export function buildMcpProtectedResourceMetadata(input) {
|
|
70
|
-
const resource = requireAbsoluteAuthorizationUrl(input.resource, "protected resource URI", true).href.replace(/\/$/u, "");
|
|
71
|
-
if (input.authorizationServers.length === 0) {
|
|
72
|
-
throw new PmMcpAuthorizationError("Protected resource metadata requires an authorization server", 401);
|
|
73
|
-
}
|
|
74
|
-
const authorizationServers = input.authorizationServers.map((issuer) => requireAbsoluteAuthorizationUrl(issuer, "authorization server issuer").href.replace(/\/$/u, ""));
|
|
75
|
-
const scopes = [...new Set(input.scopes ?? [])];
|
|
76
|
-
if (scopes.some((scope) => !SCOPE_PATTERN.test(scope))) {
|
|
77
|
-
throw new PmMcpAuthorizationError("Invalid authorization scope", 401);
|
|
78
|
-
}
|
|
79
|
-
return {
|
|
80
|
-
resource,
|
|
81
|
-
authorization_servers: authorizationServers,
|
|
82
|
-
...(scopes.length > 0 ? { scopes_supported: scopes.sort() } : {}),
|
|
83
|
-
};
|
|
84
|
-
}
|
|
85
|
-
/** Construct OAuth and OIDC discovery URLs in the MCP-required order. */
|
|
86
|
-
export function buildMcpAuthorizationDiscoveryUrls(issuer) {
|
|
87
|
-
const parsed = requireAbsoluteAuthorizationUrl(issuer, "authorization server issuer");
|
|
88
|
-
const suffix = parsed.pathname.replace(/^\/+|\/+$/gu, "");
|
|
89
|
-
const origin = parsed.origin;
|
|
90
|
-
return suffix
|
|
91
|
-
? [
|
|
92
|
-
`${origin}/.well-known/oauth-authorization-server/${suffix}`,
|
|
93
|
-
`${origin}/.well-known/openid-configuration/${suffix}`,
|
|
94
|
-
`${origin}/${suffix}/.well-known/openid-configuration`,
|
|
95
|
-
]
|
|
96
|
-
: [
|
|
97
|
-
`${origin}/.well-known/oauth-authorization-server`,
|
|
98
|
-
`${origin}/.well-known/openid-configuration`,
|
|
99
|
-
];
|
|
100
|
-
}
|
|
101
|
-
/** Validate authorization-server metadata, exact issuer binding, and S256 PKCE. */
|
|
102
|
-
export function validateMcpAuthorizationServerMetadata(value, expectedIssuer) {
|
|
103
|
-
if (!isMcpRecord(value) || typeof value.issuer !== "string") {
|
|
104
|
-
throw new PmMcpAuthorizationError("Invalid authorization server metadata", 401);
|
|
105
|
-
}
|
|
106
|
-
const expected = requireAbsoluteAuthorizationUrl(expectedIssuer, "expected issuer").href.replace(/\/$/u, "");
|
|
107
|
-
const observed = requireAbsoluteAuthorizationUrl(value.issuer, "metadata issuer").href.replace(/\/$/u, "");
|
|
108
|
-
if (observed !== expected) {
|
|
109
|
-
throw new PmMcpAuthorizationError("Authorization server issuer mismatch", 401);
|
|
110
|
-
}
|
|
111
|
-
if (!Array.isArray(value.code_challenge_methods_supported) ||
|
|
112
|
-
!value.code_challenge_methods_supported.includes("S256")) {
|
|
113
|
-
throw new PmMcpAuthorizationError("Authorization server does not support required S256 PKCE", 401);
|
|
114
|
-
}
|
|
115
|
-
const requiredUrl = (field) => {
|
|
116
|
-
const candidate = value[field];
|
|
117
|
-
if (typeof candidate !== "string") {
|
|
118
|
-
throw new PmMcpAuthorizationError(`Authorization server metadata requires ${field}`, 401);
|
|
119
|
-
}
|
|
120
|
-
return requireAbsoluteAuthorizationUrl(candidate, field).href;
|
|
121
|
-
};
|
|
122
|
-
const optionalUrl = (field) => {
|
|
123
|
-
const candidate = value[field];
|
|
124
|
-
return typeof candidate === "string"
|
|
125
|
-
? requireAbsoluteAuthorizationUrl(candidate, field).href
|
|
126
|
-
: undefined;
|
|
127
|
-
};
|
|
128
|
-
const authorizationEndpoint = requiredUrl("authorization_endpoint");
|
|
129
|
-
const tokenEndpoint = requiredUrl("token_endpoint");
|
|
130
|
-
const registrationEndpoint = optionalUrl("registration_endpoint");
|
|
131
|
-
return {
|
|
132
|
-
issuer: expected,
|
|
133
|
-
authorization_endpoint: authorizationEndpoint,
|
|
134
|
-
token_endpoint: tokenEndpoint,
|
|
135
|
-
code_challenge_methods_supported: [
|
|
136
|
-
...new Set(value.code_challenge_methods_supported.filter((entry) => typeof entry === "string")),
|
|
137
|
-
],
|
|
138
|
-
...(value.client_id_metadata_document_supported === true
|
|
139
|
-
? { client_id_metadata_document_supported: true }
|
|
140
|
-
: {}),
|
|
141
|
-
...(registrationEndpoint
|
|
142
|
-
? { registration_endpoint: registrationEndpoint }
|
|
143
|
-
: {}),
|
|
144
|
-
};
|
|
145
|
-
}
|
|
146
|
-
/** Apply the current pre-registration, metadata-document, dynamic, prompt order. */
|
|
147
|
-
export function selectMcpClientRegistrationMode(input) {
|
|
148
|
-
if (input.hasPreRegisteredClient)
|
|
149
|
-
return "pre_registered";
|
|
150
|
-
if (input.metadata.client_id_metadata_document_supported)
|
|
151
|
-
return "client_id_metadata_document";
|
|
152
|
-
if (input.metadata.registration_endpoint)
|
|
153
|
-
return "dynamic";
|
|
154
|
-
return "user_supplied";
|
|
155
|
-
}
|
|
156
|
-
/** Validate a present authorization-response issuer before code redemption. */
|
|
157
|
-
export function validateMcpAuthorizationResponseIssuer(input) {
|
|
158
|
-
if (input.responseIssuer === undefined) {
|
|
159
|
-
if (input.issuerParameterSupported) {
|
|
160
|
-
throw new PmMcpAuthorizationError("Authorization response omitted the advertised issuer", 401);
|
|
161
|
-
}
|
|
162
|
-
return;
|
|
163
|
-
}
|
|
164
|
-
if (input.responseIssuer !== input.expectedIssuer) {
|
|
165
|
-
throw new PmMcpAuthorizationError("Authorization response issuer mismatch", 401);
|
|
166
|
-
}
|
|
167
|
-
}
|
|
168
|
-
/** Validate a self-hosted Client ID Metadata Document and exact redirect set. */
|
|
169
|
-
export function validateMcpClientMetadataDocument(value, documentUrl) {
|
|
170
|
-
const expected = requireAbsoluteAuthorizationUrl(documentUrl, "client metadata document URL");
|
|
171
|
-
if (expected.pathname === "/" ||
|
|
172
|
-
!isMcpRecord(value) ||
|
|
173
|
-
value.client_id !== expected.href ||
|
|
174
|
-
typeof value.client_name !== "string" ||
|
|
175
|
-
value.client_name.trim().length === 0 ||
|
|
176
|
-
!Array.isArray(value.redirect_uris) ||
|
|
177
|
-
value.redirect_uris.length === 0) {
|
|
178
|
-
throw new PmMcpAuthorizationError("Invalid Client ID Metadata Document", 401);
|
|
179
|
-
}
|
|
180
|
-
for (const redirect of value.redirect_uris) {
|
|
181
|
-
if (typeof redirect !== "string") {
|
|
182
|
-
throw new PmMcpAuthorizationError("Invalid client redirect URI", 401);
|
|
183
|
-
}
|
|
184
|
-
requireAbsoluteAuthorizationUrl(redirect, "client redirect URI", true);
|
|
185
|
-
}
|
|
186
|
-
return structuredClone(value);
|
|
187
|
-
}
|
|
188
|
-
/** Build bounded dynamic-registration metadata for explicit legacy fallback. */
|
|
189
|
-
export function buildMcpDynamicRegistrationMetadata(input) {
|
|
190
|
-
if (input.redirectUris.length === 0 || input.clientName.trim().length === 0) {
|
|
191
|
-
throw new PmMcpAuthorizationError("Invalid dynamic client registration metadata", 401);
|
|
192
|
-
}
|
|
193
|
-
const redirectUris = input.redirectUris.map((redirect) => requireAbsoluteAuthorizationUrl(redirect, "redirect URI", true).href);
|
|
194
|
-
return {
|
|
195
|
-
application_type: input.applicationType,
|
|
196
|
-
client_name: input.clientName.trim().slice(0, 128),
|
|
197
|
-
redirect_uris: redirectUris,
|
|
198
|
-
grant_types: ["authorization_code", "refresh_token"],
|
|
199
|
-
response_types: ["code"],
|
|
200
|
-
token_endpoint_auth_method: "none",
|
|
201
|
-
};
|
|
202
|
-
}
|
|
203
|
-
/** In-memory issuer-keyed credential primitive that never reuses cross-issuer state. */
|
|
204
|
-
export class PmMcpIssuerCredentialStore {
|
|
205
|
-
#credentials = new Map();
|
|
206
|
-
/** Persist a cloned credential under the exact validated issuer. */
|
|
207
|
-
set(issuer, credential) {
|
|
208
|
-
const key = requireAbsoluteAuthorizationUrl(issuer, "credential issuer").href;
|
|
209
|
-
this.#credentials.set(key, structuredClone(credential));
|
|
210
|
-
}
|
|
211
|
-
/** Read a cloned credential only for the exact issuer. */
|
|
212
|
-
get(issuer) {
|
|
213
|
-
const key = requireAbsoluteAuthorizationUrl(issuer, "credential issuer").href;
|
|
214
|
-
const credential = this.#credentials.get(key);
|
|
215
|
-
return credential ? structuredClone(credential) : undefined;
|
|
216
|
-
}
|
|
217
|
-
/** Remove credentials for one issuer during revocation or re-registration. */
|
|
218
|
-
delete(issuer) {
|
|
219
|
-
const key = requireAbsoluteAuthorizationUrl(issuer, "credential issuer").href;
|
|
220
|
-
return this.#credentials.delete(key);
|
|
221
|
-
}
|
|
222
|
-
}
|
|
223
|
-
function validateMcpTraceFields(meta) {
|
|
224
|
-
const traceparent = meta.traceparent;
|
|
225
|
-
const tracestate = meta.tracestate;
|
|
226
|
-
if (traceparent !== undefined) {
|
|
227
|
-
const match = typeof traceparent === "string"
|
|
228
|
-
? TRACE_PARENT_PATTERN.exec(traceparent)
|
|
229
|
-
: null;
|
|
230
|
-
if (!match) {
|
|
231
|
-
throw new PmMcpAuthorizationError("Invalid MCP traceparent", 403);
|
|
232
|
-
}
|
|
233
|
-
const traceId = match[1];
|
|
234
|
-
const parentId = match[2];
|
|
235
|
-
if (/^0+$/u.test(traceId) || /^0+$/u.test(parentId)) {
|
|
236
|
-
throw new PmMcpAuthorizationError("Invalid MCP traceparent", 403);
|
|
237
|
-
}
|
|
238
|
-
}
|
|
239
|
-
if (tracestate !== undefined &&
|
|
240
|
-
(typeof tracestate !== "string" || !isValidMcpTraceState(tracestate))) {
|
|
241
|
-
throw new PmMcpAuthorizationError("Invalid MCP tracestate", 403);
|
|
242
|
-
}
|
|
243
|
-
return {
|
|
244
|
-
...(typeof traceparent === "string" ? { traceparent } : {}),
|
|
245
|
-
...(typeof tracestate === "string" ? { tracestate } : {}),
|
|
246
|
-
};
|
|
247
|
-
}
|
|
248
|
-
function trimOptionalWhitespace(value) {
|
|
249
|
-
return value.replace(/^[ \t]*|[ \t]*$/gu, "");
|
|
250
|
-
}
|
|
251
|
-
function isValidMcpTraceStateKey(key) {
|
|
252
|
-
return (TRACE_STATE_SIMPLE_KEY_PATTERN.test(key) ||
|
|
253
|
-
TRACE_STATE_TENANT_KEY_PATTERN.test(key));
|
|
254
|
-
}
|
|
255
|
-
function isValidMcpTraceState(value) {
|
|
256
|
-
if (Buffer.byteLength(value, "utf8") > MAX_TRACE_STATE_BYTES)
|
|
257
|
-
return false;
|
|
258
|
-
const members = value.split(",");
|
|
259
|
-
if (members.length > MAX_TRACE_STATE_MEMBERS)
|
|
260
|
-
return false;
|
|
261
|
-
const keys = new Set();
|
|
262
|
-
for (const source of members) {
|
|
263
|
-
const member = trimOptionalWhitespace(source);
|
|
264
|
-
if (member.length === 0)
|
|
265
|
-
continue;
|
|
266
|
-
const separator = member.indexOf("=");
|
|
267
|
-
const key = separator > 0 ? member.slice(0, separator) : "";
|
|
268
|
-
const memberValue = separator > 0 ? member.slice(separator + 1) : "";
|
|
269
|
-
if (!isValidMcpTraceStateKey(key) ||
|
|
270
|
-
!TRACE_STATE_VALUE_PATTERN.test(memberValue) ||
|
|
271
|
-
keys.has(key)) {
|
|
272
|
-
return false;
|
|
273
|
-
}
|
|
274
|
-
keys.add(key);
|
|
275
|
-
}
|
|
276
|
-
return true;
|
|
277
|
-
}
|
|
278
|
-
function isValidMcpBaggageValue(value) {
|
|
279
|
-
return (BAGGAGE_VALUE_PATTERN.test(value) &&
|
|
280
|
-
!INVALID_PERCENT_ENCODING_PATTERN.test(value));
|
|
281
|
-
}
|
|
282
|
-
function isValidMcpBaggageProperty(source) {
|
|
283
|
-
const property = trimOptionalWhitespace(source);
|
|
284
|
-
const separator = property.indexOf("=");
|
|
285
|
-
const key = trimOptionalWhitespace(separator >= 0 ? property.slice(0, separator) : property);
|
|
286
|
-
const value = separator >= 0
|
|
287
|
-
? trimOptionalWhitespace(property.slice(separator + 1))
|
|
288
|
-
: undefined;
|
|
289
|
-
return (BAGGAGE_KEY_PATTERN.test(key) &&
|
|
290
|
-
(value === undefined || isValidMcpBaggageValue(value)));
|
|
291
|
-
}
|
|
292
|
-
function parseMcpBaggageMember(source) {
|
|
293
|
-
const serialized = trimOptionalWhitespace(source);
|
|
294
|
-
const segments = serialized.split(";");
|
|
295
|
-
const pair = segments[0];
|
|
296
|
-
const properties = segments.slice(1);
|
|
297
|
-
const separator = pair.indexOf("=");
|
|
298
|
-
const key = trimOptionalWhitespace(separator > 0 ? pair.slice(0, separator) : "");
|
|
299
|
-
const value = separator > 0 ? trimOptionalWhitespace(pair.slice(separator + 1)) : "";
|
|
300
|
-
if (!BAGGAGE_KEY_PATTERN.test(key) ||
|
|
301
|
-
!isValidMcpBaggageValue(value) ||
|
|
302
|
-
!properties.every(isValidMcpBaggageProperty)) {
|
|
303
|
-
return undefined;
|
|
304
|
-
}
|
|
305
|
-
return { key, serialized };
|
|
306
|
-
}
|
|
307
|
-
function filterMcpBaggage(baggage, allowlistEntries) {
|
|
308
|
-
if (baggage === undefined)
|
|
309
|
-
return undefined;
|
|
310
|
-
if (typeof baggage !== "string" ||
|
|
311
|
-
Buffer.byteLength(baggage, "utf8") > MAX_BAGGAGE_BYTES) {
|
|
312
|
-
throw new PmMcpAuthorizationError("Invalid MCP baggage", 403);
|
|
313
|
-
}
|
|
314
|
-
const allowlist = new Set(allowlistEntries);
|
|
315
|
-
const sources = baggage.split(",");
|
|
316
|
-
if (sources.length > MAX_BAGGAGE_MEMBERS) {
|
|
317
|
-
throw new PmMcpAuthorizationError("Invalid MCP baggage", 403);
|
|
318
|
-
}
|
|
319
|
-
const entries = [];
|
|
320
|
-
for (const source of sources) {
|
|
321
|
-
const entry = parseMcpBaggageMember(source);
|
|
322
|
-
if (!entry) {
|
|
323
|
-
throw new PmMcpAuthorizationError("Invalid MCP baggage", 403);
|
|
324
|
-
}
|
|
325
|
-
if (allowlist.has(entry.key))
|
|
326
|
-
entries.push(entry.serialized);
|
|
327
|
-
}
|
|
328
|
-
return entries.length > 0 ? entries.join(",") : undefined;
|
|
329
|
-
}
|
|
330
|
-
/** Extract W3C trace context with strict syntax, size, and baggage allowlists. */
|
|
331
|
-
export function extractMcpTraceContext(params, options = {}) {
|
|
332
|
-
const meta = isMcpRecord(params) && isMcpRecord(params._meta) ? params._meta : {};
|
|
333
|
-
const allowedBaggage = filterMcpBaggage(meta.baggage, options.baggageAllowlist ?? []);
|
|
334
|
-
return {
|
|
335
|
-
...validateMcpTraceFields(meta),
|
|
336
|
-
...(allowedBaggage ? { baggage: allowedBaggage } : {}),
|
|
337
|
-
};
|
|
338
|
-
}
|
|
339
|
-
/** Run one request with trace context isolated from every concurrent request. */
|
|
340
|
-
export function runWithMcpTraceContext(context, callback) {
|
|
341
|
-
return MCP_TRACE_CONTEXT_STORAGE.run(structuredClone(context), callback);
|
|
342
|
-
}
|
|
343
|
-
/** Read a defensive copy of the current request's trace context. */
|
|
344
|
-
export function getActiveMcpTraceContext() {
|
|
345
|
-
const context = MCP_TRACE_CONTEXT_STORAGE.getStore();
|
|
346
|
-
return context ? { ...context } : undefined;
|
|
347
|
-
}
|
|
348
|
-
/** Enforce bearer location, issuer, audience, and least-privilege scopes. */
|
|
349
|
-
export async function authorizeMcpHttpRequest(input) {
|
|
350
|
-
const resourceMetadataUrl = requireAbsoluteAuthorizationUrl(input.policy.resourceMetadataUrl, "protected resource metadata URL", true).href;
|
|
351
|
-
const requiredScopes = [...new Set(input.policy.requiredScopes ?? [])];
|
|
352
|
-
if (requiredScopes.some((scope) => !SCOPE_PATTERN.test(scope))) {
|
|
353
|
-
throw new PmMcpAuthorizationError("Invalid authorization scope", 401);
|
|
354
|
-
}
|
|
355
|
-
const challenge = `Bearer resource_metadata="${resourceMetadataUrl}"`;
|
|
356
|
-
const parsedUrl = new URL(input.requestUrl, input.policy.resource);
|
|
357
|
-
if (parsedUrl.searchParams.has("access_token")) {
|
|
358
|
-
throw new PmMcpAuthorizationError("Access tokens must not appear in URI query parameters", 401, challenge);
|
|
359
|
-
}
|
|
360
|
-
const authorization = readHeader(input.headers, "authorization");
|
|
361
|
-
const match = authorization?.match(/^Bearer ([^\s]+)$/iu);
|
|
362
|
-
if (!match) {
|
|
363
|
-
throw new PmMcpAuthorizationError("Missing or malformed bearer token", 401, challenge);
|
|
364
|
-
}
|
|
365
|
-
const token = match[1];
|
|
366
|
-
if (Buffer.byteLength(token, "utf8") > MAX_BEARER_TOKEN_BYTES) {
|
|
367
|
-
throw new PmMcpAuthorizationError("Missing or malformed bearer token", 401, challenge);
|
|
368
|
-
}
|
|
369
|
-
let claims;
|
|
370
|
-
try {
|
|
371
|
-
claims = await input.policy.verifyAccessToken(token);
|
|
372
|
-
}
|
|
373
|
-
catch {
|
|
374
|
-
throw new PmMcpAuthorizationError("Invalid bearer token", 401, challenge);
|
|
375
|
-
}
|
|
376
|
-
const audiences = Array.isArray(claims.audience)
|
|
377
|
-
? claims.audience
|
|
378
|
-
: [claims.audience];
|
|
379
|
-
if (claims.issuer !== input.policy.issuer ||
|
|
380
|
-
!audiences.includes(input.policy.resource)) {
|
|
381
|
-
throw new PmMcpAuthorizationError("Bearer token issuer or audience mismatch", 401, challenge);
|
|
382
|
-
}
|
|
383
|
-
const missingScopes = requiredScopes.filter((scope) => !claims.scopes.includes(scope));
|
|
384
|
-
if (missingScopes.length > 0) {
|
|
385
|
-
throw new PmMcpAuthorizationError("Bearer token has insufficient scope", 403, `${challenge}, scope="${missingScopes.join(" ")}"`);
|
|
386
|
-
}
|
|
387
|
-
return {
|
|
388
|
-
...claims,
|
|
389
|
-
audience: [...audiences],
|
|
390
|
-
scopes: [...claims.scopes],
|
|
391
|
-
};
|
|
392
|
-
}
|
|
393
|
-
/** Create an exact opaque-token verifier without exposing token values in results. */
|
|
394
|
-
export function createMcpStaticBearerVerifier(input) {
|
|
395
|
-
const expected = createHash("sha256").update(input.token).digest();
|
|
396
|
-
return (token) => {
|
|
397
|
-
const observed = createHash("sha256").update(token).digest();
|
|
398
|
-
if (!timingSafeEqual(expected, observed)) {
|
|
399
|
-
throw new PmMcpAuthorizationError("Invalid bearer token", 401);
|
|
400
|
-
}
|
|
401
|
-
return structuredClone(input.claims);
|
|
402
|
-
};
|
|
403
|
-
}
|
|
1
|
+
!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6a5310f6-3add-5108-b39f-61607918dc9f")}catch(e2){}})();import{AsyncLocalStorage}from"node:async_hooks";import{createHash,timingSafeEqual}from"node:crypto";import{isMcpRecord}from"./protocol.js";class PmMcpAuthorizationError extends Error{httpStatus;challenge;constructor(message,httpStatus,challenge){super(message);this.name="PmMcpAuthorizationError";this.httpStatus=httpStatus;this.challenge=challenge}}const TRACE_PARENT_PATTERN=/^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/u;const TRACE_STATE_SIMPLE_KEY_PATTERN=/^[a-z][a-z0-9_*/-]{0,255}$/u;const TRACE_STATE_TENANT_KEY_PATTERN=/^(?:[a-z0-9][a-z0-9_*/-]{0,240})@[a-z][a-z0-9_*/-]{0,13}$/u;const TRACE_STATE_VALUE_PATTERN=/^[\x20-\x2B\x2D-\x3C\x3E-\x7E]{0,255}[\x21-\x2B\x2D-\x3C\x3E-\x7E]$/u;const SCOPE_PATTERN=/^[\x21\x23-\x5B\x5D-\x7E]+$/u;const BAGGAGE_KEY_PATTERN=/^[A-Za-z0-9!#$%&'*+.^_`|~-]+$/u;const BAGGAGE_VALUE_PATTERN=/^[\x21\x23-\x2B\x2D-\x3A\x3C-\x5B\x5D-\x7E]*$/u;const INVALID_PERCENT_ENCODING_PATTERN=/%(?![0-9A-Fa-f]{2})/u;const MAX_TRACE_STATE_BYTES=512;const MAX_TRACE_STATE_MEMBERS=32;const MAX_BAGGAGE_MEMBERS=180;const MAX_BAGGAGE_BYTES=8192;const MAX_BEARER_TOKEN_BYTES=8192;const MCP_TRACE_CONTEXT_STORAGE=new AsyncLocalStorage;function requireAbsoluteAuthorizationUrl(value,field,allowLocalHttp=false){if(new RegExp("\\p{Cc}","u").test(value)){throw new PmMcpAuthorizationError(`Invalid ${field}`,401)}let parsed;try{parsed=new URL(value)}catch{throw new PmMcpAuthorizationError(`Invalid ${field}`,401)}const local=parsed.hostname==="127.0.0.1"||parsed.hostname==="localhost";if(parsed.hash.length>0||parsed.protocol!=="https:"&&!(allowLocalHttp&&local&&parsed.protocol==="http:")){throw new PmMcpAuthorizationError(`Invalid ${field}`,401)}return parsed}function readHeader(headers,name){const expected=name.toLowerCase();for(const[candidate,value]of Object.entries(headers)){if(candidate.toLowerCase()!==expected||value===void 0)continue;return typeof value==="string"?value:value.join(", ")}return void 0}function buildMcpProtectedResourceMetadata(input){const resource=requireAbsoluteAuthorizationUrl(input.resource,"protected resource URI",true).href.replace(/\/$/u,"");if(input.authorizationServers.length===0){throw new PmMcpAuthorizationError("Protected resource metadata requires an authorization server",401)}const authorizationServers=input.authorizationServers.map(issuer=>requireAbsoluteAuthorizationUrl(issuer,"authorization server issuer").href.replace(/\/$/u,""));const scopes=[...new Set(input.scopes??[])];if(scopes.some(scope=>!SCOPE_PATTERN.test(scope))){throw new PmMcpAuthorizationError("Invalid authorization scope",401)}return{resource,authorization_servers:authorizationServers,...scopes.length>0?{scopes_supported:scopes.sort()}:{}}}function buildMcpAuthorizationDiscoveryUrls(issuer){const parsed=requireAbsoluteAuthorizationUrl(issuer,"authorization server issuer");const suffix=parsed.pathname.replace(/^\/+|\/+$/gu,"");const origin=parsed.origin;return suffix?[`${origin}/.well-known/oauth-authorization-server/${suffix}`,`${origin}/.well-known/openid-configuration/${suffix}`,`${origin}/${suffix}/.well-known/openid-configuration`]:[`${origin}/.well-known/oauth-authorization-server`,`${origin}/.well-known/openid-configuration`]}function validateMcpAuthorizationServerMetadata(value,expectedIssuer){if(!isMcpRecord(value)||typeof value.issuer!=="string"){throw new PmMcpAuthorizationError("Invalid authorization server metadata",401)}const expected=requireAbsoluteAuthorizationUrl(expectedIssuer,"expected issuer").href.replace(/\/$/u,"");const observed=requireAbsoluteAuthorizationUrl(value.issuer,"metadata issuer").href.replace(/\/$/u,"");if(observed!==expected){throw new PmMcpAuthorizationError("Authorization server issuer mismatch",401)}if(!Array.isArray(value.code_challenge_methods_supported)||!value.code_challenge_methods_supported.includes("S256")){throw new PmMcpAuthorizationError("Authorization server does not support required S256 PKCE",401)}const requiredUrl=field=>{const candidate=value[field];if(typeof candidate!=="string"){throw new PmMcpAuthorizationError(`Authorization server metadata requires ${field}`,401)}return requireAbsoluteAuthorizationUrl(candidate,field).href};const optionalUrl=field=>{const candidate=value[field];return typeof candidate==="string"?requireAbsoluteAuthorizationUrl(candidate,field).href:void 0};const authorizationEndpoint=requiredUrl("authorization_endpoint");const tokenEndpoint=requiredUrl("token_endpoint");const registrationEndpoint=optionalUrl("registration_endpoint");return{issuer:expected,authorization_endpoint:authorizationEndpoint,token_endpoint:tokenEndpoint,code_challenge_methods_supported:[...new Set(value.code_challenge_methods_supported.filter(entry=>typeof entry==="string"))],...value.client_id_metadata_document_supported===true?{client_id_metadata_document_supported:true}:{},...registrationEndpoint?{registration_endpoint:registrationEndpoint}:{}}}function selectMcpClientRegistrationMode(input){if(input.hasPreRegisteredClient)return"pre_registered";if(input.metadata.client_id_metadata_document_supported)return"client_id_metadata_document";if(input.metadata.registration_endpoint)return"dynamic";return"user_supplied"}function validateMcpAuthorizationResponseIssuer(input){if(input.responseIssuer===void 0){if(input.issuerParameterSupported){throw new PmMcpAuthorizationError("Authorization response omitted the advertised issuer",401)}return}if(input.responseIssuer!==input.expectedIssuer){throw new PmMcpAuthorizationError("Authorization response issuer mismatch",401)}}function validateMcpClientMetadataDocument(value,documentUrl){const expected=requireAbsoluteAuthorizationUrl(documentUrl,"client metadata document URL");if(expected.pathname==="/"||!isMcpRecord(value)||value.client_id!==expected.href||typeof value.client_name!=="string"||value.client_name.trim().length===0||!Array.isArray(value.redirect_uris)||value.redirect_uris.length===0){throw new PmMcpAuthorizationError("Invalid Client ID Metadata Document",401)}for(const redirect of value.redirect_uris){if(typeof redirect!=="string"){throw new PmMcpAuthorizationError("Invalid client redirect URI",401)}requireAbsoluteAuthorizationUrl(redirect,"client redirect URI",true)}return structuredClone(value)}function buildMcpDynamicRegistrationMetadata(input){if(input.redirectUris.length===0||input.clientName.trim().length===0){throw new PmMcpAuthorizationError("Invalid dynamic client registration metadata",401)}const redirectUris=input.redirectUris.map(redirect=>requireAbsoluteAuthorizationUrl(redirect,"redirect URI",true).href);return{application_type:input.applicationType,client_name:input.clientName.trim().slice(0,128),redirect_uris:redirectUris,grant_types:["authorization_code","refresh_token"],response_types:["code"],token_endpoint_auth_method:"none"}}class PmMcpIssuerCredentialStore{#credentials=new Map;set(issuer,credential){const key=requireAbsoluteAuthorizationUrl(issuer,"credential issuer").href;this.#credentials.set(key,structuredClone(credential))}get(issuer){const key=requireAbsoluteAuthorizationUrl(issuer,"credential issuer").href;const credential=this.#credentials.get(key);return credential?structuredClone(credential):void 0}delete(issuer){const key=requireAbsoluteAuthorizationUrl(issuer,"credential issuer").href;return this.#credentials.delete(key)}}function validateMcpTraceFields(meta){const traceparent=meta.traceparent;const tracestate=meta.tracestate;if(traceparent!==void 0){const match=typeof traceparent==="string"?TRACE_PARENT_PATTERN.exec(traceparent):null;if(!match){throw new PmMcpAuthorizationError("Invalid MCP traceparent",403)}const traceId=match[1];const parentId=match[2];if(/^0+$/u.test(traceId)||/^0+$/u.test(parentId)){throw new PmMcpAuthorizationError("Invalid MCP traceparent",403)}}if(tracestate!==void 0&&(typeof tracestate!=="string"||!isValidMcpTraceState(tracestate))){throw new PmMcpAuthorizationError("Invalid MCP tracestate",403)}return{...typeof traceparent==="string"?{traceparent}:{},...typeof tracestate==="string"?{tracestate}:{}}}function trimOptionalWhitespace(value){return value.replace(/^[ \t]*|[ \t]*$/gu,"")}function isValidMcpTraceStateKey(key){return TRACE_STATE_SIMPLE_KEY_PATTERN.test(key)||TRACE_STATE_TENANT_KEY_PATTERN.test(key)}function isValidMcpTraceState(value){if(Buffer.byteLength(value,"utf8")>MAX_TRACE_STATE_BYTES)return false;const members=value.split(",");if(members.length>MAX_TRACE_STATE_MEMBERS)return false;const keys=new Set;for(const source of members){const member=trimOptionalWhitespace(source);if(member.length===0)continue;const separator=member.indexOf("=");const key=separator>0?member.slice(0,separator):"";const memberValue=separator>0?member.slice(separator+1):"";if(!isValidMcpTraceStateKey(key)||!TRACE_STATE_VALUE_PATTERN.test(memberValue)||keys.has(key)){return false}keys.add(key)}return true}function isValidMcpBaggageValue(value){return BAGGAGE_VALUE_PATTERN.test(value)&&!INVALID_PERCENT_ENCODING_PATTERN.test(value)}function isValidMcpBaggageProperty(source){const property=trimOptionalWhitespace(source);const separator=property.indexOf("=");const key=trimOptionalWhitespace(separator>=0?property.slice(0,separator):property);const value=separator>=0?trimOptionalWhitespace(property.slice(separator+1)):void 0;return BAGGAGE_KEY_PATTERN.test(key)&&(value===void 0||isValidMcpBaggageValue(value))}function parseMcpBaggageMember(source){const serialized=trimOptionalWhitespace(source);const segments=serialized.split(";");const pair=segments[0];const properties=segments.slice(1);const separator=pair.indexOf("=");const key=trimOptionalWhitespace(separator>0?pair.slice(0,separator):"");const value=separator>0?trimOptionalWhitespace(pair.slice(separator+1)):"";if(!BAGGAGE_KEY_PATTERN.test(key)||!isValidMcpBaggageValue(value)||!properties.every(isValidMcpBaggageProperty)){return void 0}return{key,serialized}}function filterMcpBaggage(baggage,allowlistEntries){if(baggage===void 0)return void 0;if(typeof baggage!=="string"||Buffer.byteLength(baggage,"utf8")>MAX_BAGGAGE_BYTES){throw new PmMcpAuthorizationError("Invalid MCP baggage",403)}const allowlist=new Set(allowlistEntries);const sources=baggage.split(",");if(sources.length>MAX_BAGGAGE_MEMBERS){throw new PmMcpAuthorizationError("Invalid MCP baggage",403)}const entries=[];for(const source of sources){const entry=parseMcpBaggageMember(source);if(!entry){throw new PmMcpAuthorizationError("Invalid MCP baggage",403)}if(allowlist.has(entry.key))entries.push(entry.serialized)}return entries.length>0?entries.join(","):void 0}function extractMcpTraceContext(params,options={}){const meta=isMcpRecord(params)&&isMcpRecord(params._meta)?params._meta:{};const allowedBaggage=filterMcpBaggage(meta.baggage,options.baggageAllowlist??[]);return{...validateMcpTraceFields(meta),...allowedBaggage?{baggage:allowedBaggage}:{}}}function runWithMcpTraceContext(context,callback){return MCP_TRACE_CONTEXT_STORAGE.run(structuredClone(context),callback)}function getActiveMcpTraceContext(){const context=MCP_TRACE_CONTEXT_STORAGE.getStore();return context?{...context}:void 0}async function authorizeMcpHttpRequest(input){const resourceMetadataUrl=requireAbsoluteAuthorizationUrl(input.policy.resourceMetadataUrl,"protected resource metadata URL",true).href;const requiredScopes=[...new Set(input.policy.requiredScopes??[])];if(requiredScopes.some(scope=>!SCOPE_PATTERN.test(scope))){throw new PmMcpAuthorizationError("Invalid authorization scope",401)}const challenge=`Bearer resource_metadata="${resourceMetadataUrl}"`;const parsedUrl=new URL(input.requestUrl,input.policy.resource);if(parsedUrl.searchParams.has("access_token")){throw new PmMcpAuthorizationError("Access tokens must not appear in URI query parameters",401,challenge)}const authorization=readHeader(input.headers,"authorization");const match=authorization?.match(/^Bearer ([^\s]+)$/iu);if(!match){throw new PmMcpAuthorizationError("Missing or malformed bearer token",401,challenge)}const token=match[1];if(Buffer.byteLength(token,"utf8")>MAX_BEARER_TOKEN_BYTES){throw new PmMcpAuthorizationError("Missing or malformed bearer token",401,challenge)}let claims;try{claims=await input.policy.verifyAccessToken(token)}catch{throw new PmMcpAuthorizationError("Invalid bearer token",401,challenge)}const audiences=Array.isArray(claims.audience)?claims.audience:[claims.audience];if(claims.issuer!==input.policy.issuer||!audiences.includes(input.policy.resource)){throw new PmMcpAuthorizationError("Bearer token issuer or audience mismatch",401,challenge)}const missingScopes=requiredScopes.filter(scope=>!claims.scopes.includes(scope));if(missingScopes.length>0){throw new PmMcpAuthorizationError("Bearer token has insufficient scope",403,`${challenge}, scope="${missingScopes.join(" ")}"`)}return{...claims,audience:[...audiences],scopes:[...claims.scopes]}}function createMcpStaticBearerVerifier(input){const expected=createHash("sha256").update(input.token).digest();return token=>{const observed=createHash("sha256").update(token).digest();if(!timingSafeEqual(expected,observed)){throw new PmMcpAuthorizationError("Invalid bearer token",401)}return structuredClone(input.claims)}}export{PmMcpAuthorizationError,PmMcpIssuerCredentialStore,authorizeMcpHttpRequest,buildMcpAuthorizationDiscoveryUrls,buildMcpDynamicRegistrationMetadata,buildMcpProtectedResourceMetadata,createMcpStaticBearerVerifier,extractMcpTraceContext,getActiveMcpTraceContext,runWithMcpTraceContext,selectMcpClientRegistrationMode,validateMcpAuthorizationResponseIssuer,validateMcpAuthorizationServerMetadata,validateMcpClientMetadataDocument};
|
|
404
2
|
//# sourceMappingURL=authorization.js.map
|
|
405
|
-
//# debugId=a9aefc86-a8ce-5ecf-bb54-e5fa3ea277c7
|