@unbrained/pm-cli 2026.10.14 → 2026.10.15
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/.claude-plugin/marketplace.json +1 -1
- package/CHANGELOG.md +54 -2
- package/dist/cli/after-command-context-usage.d.ts +7 -7
- package/dist/cli/argv-utils.d.ts +4 -4
- package/dist/cli/bundle-integrity.d.ts +16 -16
- package/dist/cli/command-namespaces.d.ts +1 -1
- package/dist/cli/commander-usage.d.ts +34 -34
- package/dist/cli/commands/governance/validate.d.ts +1 -1
- package/dist/cli/commands/history/history-compact.d.ts +1 -1
- package/dist/cli/commands/history/history-redact.d.ts +1 -1
- package/dist/cli/commands/history/history-repair.d.ts +1 -1
- package/dist/cli/commands/history/restore.d.ts +1 -1
- package/dist/cli/commands/lifecycle/close.d.ts +1 -1
- package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
- package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
- package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
- package/dist/cli/commands/query/get.d.ts +1 -1
- package/dist/cli/commands/workspace/merge.d.ts +1 -1
- package/dist/cli/commands/workspace/schema.d.ts +1 -1
- package/dist/cli/context-intent-invocation.d.ts +1 -1
- package/dist/cli/description-stdin.d.ts +1 -1
- package/dist/cli/error-guidance.d.ts +119 -119
- package/dist/cli/extension-command-help.d.ts +64 -64
- package/dist/cli/extension-command-help.js +2 -2
- package/dist/cli/extension-command-options.d.ts +16 -16
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +2 -2
- package/dist/cli/help-json-payload.d.ts +45 -45
- package/dist/cli/invocation-profile.d.ts +5 -5
- package/dist/cli/main.d.ts +217 -217
- package/dist/cli/migration-gates.d.ts +24 -24
- package/dist/cli/option-values.d.ts +1 -1
- package/dist/cli/public.d.ts +1 -1
- package/dist/cli/register-annotations.d.ts +2 -2
- package/dist/cli/register-assurance.d.ts +1 -1
- package/dist/cli/register-files-lookup.d.ts +1 -1
- package/dist/cli/register-history-activity.d.ts +1 -1
- package/dist/cli/register-history-author.d.ts +1 -1
- package/dist/cli/register-history-maintenance.d.ts +1 -1
- package/dist/cli/register-list-query.d.ts +7 -7
- package/dist/cli/register-list-query.js +3 -3
- package/dist/cli/register-mutation-options.d.ts +1 -1
- package/dist/cli/register-mutation.d.ts +4 -4
- package/dist/cli/register-operations.d.ts +75 -75
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -8
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- package/dist/cli/runtime/projection-retry.d.ts +1 -1
- package/dist/cli/runtime/selection.d.ts +16 -16
- package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
- package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
- package/dist/cli/schema/registration.d.ts +1 -1
- package/dist/cli/schema-registration-helpers.d.ts +2 -2
- package/dist/cli/stats-analytics-json.d.ts +1 -1
- package/dist/cli-bundle/bundle-manifest.json +1 -1
- package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
- package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
- package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
- package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
- package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
- package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
- package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
- package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
- package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
- package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
- package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
- package/dist/cli-bundle/main.js +26 -26
- 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 +22 -22
- 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 +51 -51
- 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 +7 -7
- package/dist/cli.d.ts +9 -9
- package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
- package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
- package/dist/core/config/nested-settings.d.ts +20 -20
- package/dist/core/config/positional-value.d.ts +9 -9
- package/dist/core/diagnostics/remediation.d.ts +7 -7
- package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
- package/dist/core/extensions/activation-summary.d.ts +30 -30
- package/dist/core/extensions/activation-transaction.d.ts +9 -9
- package/dist/core/extensions/capability-usage.d.ts +25 -25
- package/dist/core/extensions/command-hook-context.d.ts +15 -15
- package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
- package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
- package/dist/core/extensions/contribution-inventory.d.ts +24 -24
- package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
- package/dist/core/extensions/extension-candidate.d.ts +14 -14
- package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
- package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
- package/dist/core/extensions/extension-policy.d.ts +62 -62
- package/dist/core/extensions/extension-registries.d.ts +8 -8
- package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
- package/dist/core/extensions/extension-types.d.ts +702 -702
- package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
- package/dist/core/extensions/flag-value-types.d.ts +16 -4
- package/dist/core/extensions/flag-value-types.js +1 -1
- package/dist/core/extensions/index.d.ts +34 -34
- package/dist/core/extensions/item-field-types.d.ts +3 -3
- package/dist/core/extensions/item-fields.d.ts +6 -6
- package/dist/core/extensions/loader.d.ts +66 -66
- package/dist/core/extensions/manifest-parser.d.ts +1 -1
- package/dist/core/extensions/manifest-schema.d.ts +13 -13
- package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
- package/dist/core/extensions/preflight-ownership.d.ts +3 -3
- package/dist/core/extensions/read-output-contract.d.ts +2 -2
- package/dist/core/extensions/registration-contracts.d.ts +12 -12
- package/dist/core/extensions/registration-validation.d.ts +6 -6
- package/dist/core/extensions/registration-values.d.ts +19 -19
- package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
- package/dist/core/extensions/runtime-registrations.d.ts +6 -6
- package/dist/core/extensions/service-ownership.d.ts +1 -1
- package/dist/core/extensions/version-compat.d.ts +9 -9
- package/dist/core/fs/atomic-create.d.ts +1 -1
- package/dist/core/fs/fs-utils.d.ts +12 -12
- package/dist/core/fs/host-environment-errors.d.ts +10 -10
- package/dist/core/fs/path-utils.d.ts +1 -1
- package/dist/core/governance/content-fields.d.ts +25 -25
- package/dist/core/governance/issue-codes.d.ts +16 -16
- package/dist/core/governance/metadata-coverage.d.ts +64 -64
- package/dist/core/history/digest.d.ts +5 -5
- package/dist/core/history/drift-cache.d.ts +2 -2
- package/dist/core/history/drift-scan.d.ts +18 -18
- package/dist/core/history/event-classification.d.ts +4 -4
- package/dist/core/history/event-index.d.ts +33 -33
- package/dist/core/history/history-compact-bulk.d.ts +12 -12
- package/dist/core/history/history-diff.d.ts +15 -15
- package/dist/core/history/history-rewrite.d.ts +43 -43
- package/dist/core/history/history-storage-stats.d.ts +20 -20
- package/dist/core/history/history-stream-policy.d.ts +12 -12
- package/dist/core/history/history.d.ts +45 -45
- package/dist/core/history/identity.d.ts +4 -4
- package/dist/core/history/operation-contract.d.ts +17 -17
- package/dist/core/history/projection.d.ts +16 -16
- package/dist/core/history/read.d.ts +4 -4
- package/dist/core/history/replay.d.ts +47 -47
- package/dist/core/history/tombstone.d.ts +1 -1
- package/dist/core/history/version-address.d.ts +2 -2
- package/dist/core/history/workspace-history.d.ts +72 -72
- package/dist/core/io/body-file.d.ts +2 -2
- package/dist/core/io/bulk-ids-input.d.ts +7 -7
- package/dist/core/item/actionability.d.ts +30 -30
- package/dist/core/item/dependency-reference.d.ts +2 -2
- package/dist/core/item/id.d.ts +9 -9
- package/dist/core/item/item-format-version.d.ts +17 -15
- package/dist/core/item/item-format-version.js +1 -1
- package/dist/core/item/item-format.d.ts +54 -54
- package/dist/core/item/item-record.d.ts +1 -1
- package/dist/core/item/item-type-definition.d.ts +11 -11
- package/dist/core/item/parent-reference-policy.d.ts +6 -6
- package/dist/core/item/parse.d.ts +37 -37
- package/dist/core/item/plan-lifecycle.d.ts +4 -4
- package/dist/core/item/priority.d.ts +3 -3
- package/dist/core/item/sprint-release-format.d.ts +4 -4
- package/dist/core/item/status-filter.d.ts +5 -5
- package/dist/core/item/status.d.ts +3 -3
- package/dist/core/item/toon-decode.d.ts +10 -10
- package/dist/core/item/type-registry.d.ts +35 -35
- package/dist/core/item/type-synonyms.d.ts +2 -2
- package/dist/core/lock/lock-gc.d.ts +28 -28
- package/dist/core/lock/lock.d.ts +53 -53
- package/dist/core/output/mutation-projection.d.ts +4 -4
- package/dist/core/output/output-control.d.ts +4 -4
- package/dist/core/output/output.d.ts +30 -30
- package/dist/core/output/query-summary.d.ts +5 -5
- package/dist/core/output/tabular.d.ts +3 -3
- package/dist/core/packages/manifest.d.ts +30 -30
- package/dist/core/packages/root.d.ts +4 -4
- package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
- package/dist/core/policy/workflow-policy-store.d.ts +15 -15
- package/dist/core/policy/workflow-policy.d.ts +56 -56
- package/dist/core/profile/profile-describe.d.ts +22 -22
- package/dist/core/profile/profile-lint.d.ts +13 -13
- package/dist/core/profile/profile-plan.d.ts +45 -45
- package/dist/core/profile/profile-presets.d.ts +36 -36
- package/dist/core/reproducibility/context.d.ts +9 -9
- package/dist/core/schema/fields-file.d.ts +35 -35
- package/dist/core/schema/item-types-file.d.ts +29 -29
- package/dist/core/schema/runtime-field-filters.d.ts +3 -3
- package/dist/core/schema/runtime-field-values.d.ts +7 -7
- package/dist/core/schema/runtime-schema.d.ts +59 -59
- package/dist/core/schema/status-defs-file.d.ts +29 -29
- package/dist/core/schema/status-token.d.ts +1 -1
- package/dist/core/schema/type-inference.d.ts +10 -10
- package/dist/core/schema/type-presets.d.ts +5 -5
- package/dist/core/schema/type-workflows.d.ts +14 -14
- package/dist/core/search/background-refresh.d.ts +12 -12
- package/dist/core/search/bm25.d.ts +16 -16
- package/dist/core/search/cache.d.ts +34 -34
- package/dist/core/search/corpus.d.ts +17 -17
- package/dist/core/search/embedding-batches.d.ts +25 -25
- package/dist/core/search/eval-thresholds.d.ts +4 -4
- package/dist/core/search/eval.d.ts +40 -40
- package/dist/core/search/http-client.d.ts +24 -24
- package/dist/core/search/providers.d.ts +30 -30
- package/dist/core/search/relevance.d.ts +17 -17
- package/dist/core/search/semantic-defaults.d.ts +5 -5
- package/dist/core/search/staleness.d.ts +3 -3
- package/dist/core/search/vector-stores.d.ts +51 -51
- package/dist/core/search/vectorization-metadata.d.ts +9 -9
- package/dist/core/sentry/helpers.d.ts +27 -27
- package/dist/core/sentry/instrument.d.ts +51 -51
- package/dist/core/sentry/instrument.js +1 -1
- package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
- package/dist/core/sentry/sensitive-assignments.js +2 -0
- package/dist/core/session/session-state.d.ts +37 -37
- package/dist/core/shared/agent-session-context.d.ts +14 -14
- package/dist/core/shared/author.d.ts +89 -89
- package/dist/core/shared/command-line.d.ts +3 -3
- package/dist/core/shared/command-types.d.ts +20 -20
- package/dist/core/shared/conflict-markers.d.ts +5 -5
- package/dist/core/shared/constants.d.ts +30 -30
- package/dist/core/shared/errors.d.ts +100 -100
- package/dist/core/shared/html-entity-decode.d.ts +2 -2
- package/dist/core/shared/item-metadata-contract.d.ts +2 -2
- package/dist/core/shared/lazy-module.d.ts +1 -1
- package/dist/core/shared/levenshtein.d.ts +1 -1
- package/dist/core/shared/memo.d.ts +1 -1
- package/dist/core/shared/numeric-parsers.d.ts +1 -1
- package/dist/core/shared/option-alias-visibility.d.ts +3 -3
- package/dist/core/shared/primitives.d.ts +13 -13
- package/dist/core/shared/secret-rules.d.ts +92 -92
- package/dist/core/shared/serial-queue.d.ts +6 -6
- package/dist/core/shared/serialization.d.ts +4 -4
- package/dist/core/shared/split-comma-list.d.ts +4 -4
- package/dist/core/shared/text-normalization.d.ts +3 -3
- package/dist/core/shared/time.d.ts +27 -27
- package/dist/core/store/item-format-migration.d.ts +7 -7
- package/dist/core/store/item-metadata-cache.d.ts +30 -30
- package/dist/core/store/item-metadata-query-index.d.ts +66 -66
- package/dist/core/store/item-metadata-read-work.d.ts +6 -6
- package/dist/core/store/item-store.d.ts +123 -123
- package/dist/core/store/item-store.js +1 -1
- package/dist/core/store/paths.d.ts +27 -27
- package/dist/core/store/settings-concurrency.d.ts +1 -1
- package/dist/core/store/settings-read-cache.d.ts +11 -11
- package/dist/core/store/settings-validator.d.ts +117 -117
- package/dist/core/store/settings.d.ts +84 -84
- package/dist/core/store/sqlite-runtime.d.ts +2 -2
- package/dist/core/store/tracker-preflight.d.ts +3 -3
- package/dist/core/telemetry/consent.d.ts +1 -1
- package/dist/core/telemetry/observability.d.ts +16 -16
- package/dist/core/telemetry/policy.d.ts +7 -7
- package/dist/core/telemetry/read-sampling.d.ts +1 -1
- package/dist/core/telemetry/runtime.d.ts +275 -275
- package/dist/core/test/background-runs.d.ts +123 -123
- package/dist/core/test/item-test-run-tracking.d.ts +10 -10
- package/dist/core/test/run-selectors.d.ts +12 -12
- package/dist/core/validate/estimate-defaults.d.ts +3 -3
- package/dist/core/validate/fix-planning.d.ts +36 -36
- package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
- package/dist/core/validate/missing-by-type.d.ts +3 -3
- package/dist/core/validate/missing-link-owners.d.ts +17 -17
- package/dist/core/validate/stale-file-classification.d.ts +6 -6
- package/dist/mcp/http-server.d.ts +26 -26
- package/dist/mcp/legacy-adapter.d.ts +18 -18
- package/dist/mcp/runtime-capabilities.d.ts +18 -18
- package/dist/mcp/server.d.ts +73 -73
- package/dist/mcp/tool-definitions.d.ts +27 -27
- package/dist/sdk/actionability.d.ts +1 -1
- package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
- package/dist/sdk/agent/command-recovery.d.ts +5 -5
- package/dist/sdk/agent/command-suggestions.d.ts +4 -4
- package/dist/sdk/agent/create-option-policy.d.ts +2 -2
- package/dist/sdk/agent/identity-config.d.ts +18 -18
- package/dist/sdk/agent/item-addressing.d.ts +6 -6
- package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
- package/dist/sdk/agent/refusal-closure.d.ts +22 -22
- package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
- package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
- package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
- package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
- package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
- package/dist/sdk/agent-capability-contracts.d.ts +41 -41
- package/dist/sdk/agent-session-context.d.ts +1 -1
- package/dist/sdk/annotations.d.ts +74 -74
- package/dist/sdk/author-attribution.d.ts +47 -47
- package/dist/sdk/authoring.d.ts +9 -9
- package/dist/sdk/cli-bootstrap.d.ts +65 -65
- package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
- package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
- package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
- package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
- package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
- package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
- package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
- package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
- package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
- package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
- package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
- package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
- package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
- package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
- package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
- package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
- package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
- package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
- package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
- package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
- package/dist/sdk/cli-contracts.d.ts +15 -15
- package/dist/sdk/cli-program.d.ts +1 -1
- package/dist/sdk/cli-program.js +1 -1
- package/dist/sdk/command-line.d.ts +3 -3
- package/dist/sdk/comments.d.ts +24 -24
- package/dist/sdk/compile-cache.d.ts +4 -4
- package/dist/sdk/completion/bash.d.ts +1 -1
- package/dist/sdk/completion/fish.d.ts +1 -1
- package/dist/sdk/completion/shared.d.ts +74 -74
- package/dist/sdk/completion/zsh.d.ts +1 -1
- package/dist/sdk/completion.d.ts +3 -3
- package/dist/sdk/compose.d.ts +94 -94
- package/dist/sdk/config.d.ts +105 -105
- package/dist/sdk/context/recency.d.ts +1 -1
- package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
- package/dist/sdk/context/usage-egress.d.ts +1 -1
- package/dist/sdk/context/usage-ledger.d.ts +18 -18
- package/dist/sdk/context-intent-contracts.d.ts +37 -37
- package/dist/sdk/context-intent-runtime.d.ts +10 -10
- package/dist/sdk/context-packing.d.ts +44 -44
- package/dist/sdk/context-relevance.d.ts +110 -110
- package/dist/sdk/context-signal-store.d.ts +52 -52
- package/dist/sdk/context-usage.d.ts +78 -78
- package/dist/sdk/contracts.d.ts +2 -1
- package/dist/sdk/contracts.js +1 -1
- package/dist/sdk/core-governance.d.ts +5 -5
- package/dist/sdk/core.d.ts +8 -8
- package/dist/sdk/corpus-shape.d.ts +60 -60
- package/dist/sdk/define.d.ts +36 -36
- package/dist/sdk/dependencies.d.ts +70 -70
- package/dist/sdk/dependency-flag-validation.d.ts +17 -17
- package/dist/sdk/dependency-provenance.d.ts +22 -22
- package/dist/sdk/docs.d.ts +17 -17
- package/dist/sdk/duplicates.d.ts +14 -14
- package/dist/sdk/environment/agent-environment.d.ts +118 -118
- package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
- package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
- package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
- package/dist/sdk/environment/source-context.d.ts +4 -4
- package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
- package/dist/sdk/error-code-catalog.d.ts +33 -33
- package/dist/sdk/error-runtime.d.ts +5 -5
- package/dist/sdk/errors.d.ts +17 -17
- package/dist/sdk/eval.d.ts +27 -27
- package/dist/sdk/extension/author-manifest.d.ts +9 -9
- package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
- package/dist/sdk/extension/concurrency.d.ts +1 -1
- package/dist/sdk/extension/copy-scope.d.ts +1 -1
- package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
- package/dist/sdk/extension/describe.d.ts +21 -21
- package/dist/sdk/extension/doctor.d.ts +46 -46
- package/dist/sdk/extension/install-plan.d.ts +32 -32
- package/dist/sdk/extension/install-receipts.d.ts +4 -4
- package/dist/sdk/extension/install-runtime.d.ts +12 -12
- package/dist/sdk/extension/install-snapshot.d.ts +10 -10
- package/dist/sdk/extension/install-sources.d.ts +106 -106
- package/dist/sdk/extension/managed-state.d.ts +42 -42
- package/dist/sdk/extension/managed-update-status.d.ts +1 -1
- package/dist/sdk/extension/migrations.d.ts +48 -48
- package/dist/sdk/extension/output-ownership.d.ts +19 -19
- package/dist/sdk/extension/runtime-summary.d.ts +7 -7
- package/dist/sdk/extension/scaffold.d.ts +15 -15
- package/dist/sdk/extension/shared.d.ts +16 -16
- package/dist/sdk/extension/source-resolution.d.ts +16 -16
- package/dist/sdk/extension/static-inventory.d.ts +23 -23
- package/dist/sdk/extension/update-check.d.ts +9 -9
- package/dist/sdk/extension-command-context.d.ts +1 -1
- package/dist/sdk/extension-contracts.d.ts +10 -10
- package/dist/sdk/extension.d.ts +221 -221
- package/dist/sdk/files.d.ts +101 -101
- package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
- package/dist/sdk/flag-invocation-contracts.js +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
- package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
- package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
- package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
- package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
- package/dist/sdk/governance/assurance-action.d.ts +46 -46
- package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
- package/dist/sdk/governance/assurance-presets.d.ts +25 -25
- package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
- package/dist/sdk/governance/assurance.d.ts +204 -204
- package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
- package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
- package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
- package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
- package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
- package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
- package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
- package/dist/sdk/governance/extension-host-version.d.ts +9 -9
- package/dist/sdk/governance/gc.d.ts +26 -26
- package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
- package/dist/sdk/governance/health.d.ts +172 -172
- package/dist/sdk/governance/health.js +1 -1
- package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
- package/dist/sdk/governance/linked-file-report.d.ts +15 -15
- package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
- package/dist/sdk/governance/provenance-health.d.ts +35 -35
- package/dist/sdk/governance/reindex.d.ts +102 -102
- package/dist/sdk/governance/reliability.d.ts +29 -29
- package/dist/sdk/governance/stale-work.d.ts +13 -13
- package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
- package/dist/sdk/governance/storage-integrity.d.ts +28 -28
- package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
- package/dist/sdk/governance/upgrade.d.ts +77 -77
- package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
- package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
- package/dist/sdk/governance/validate-normalization.d.ts +4 -4
- package/dist/sdk/governance/validate.d.ts +176 -176
- package/dist/sdk/governance/validate.js +1 -1
- package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
- package/dist/sdk/governance/workflow-policy.d.ts +18 -18
- package/dist/sdk/governance/workspace-position.d.ts +40 -40
- package/dist/sdk/governance.d.ts +2 -2
- package/dist/sdk/graph/adapter.d.ts +45 -45
- package/dist/sdk/graph/analytics.d.ts +36 -36
- package/dist/sdk/graph/assembly.d.ts +51 -51
- package/dist/sdk/graph/cache.d.ts +19 -19
- package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
- package/dist/sdk/graph/centrality.d.ts +20 -20
- package/dist/sdk/graph/conformance.d.ts +21 -21
- package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
- package/dist/sdk/graph/durable-cache.d.ts +22 -22
- package/dist/sdk/graph/governance-contracts.d.ts +1 -1
- package/dist/sdk/graph/governance.d.ts +92 -92
- package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
- package/dist/sdk/graph/index.d.ts +15 -15
- package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
- package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
- package/dist/sdk/graph/query-contracts.d.ts +6 -6
- package/dist/sdk/graph/remediation.d.ts +15 -15
- package/dist/sdk/graph/run.d.ts +203 -203
- package/dist/sdk/graph/scheduling.d.ts +21 -21
- package/dist/sdk/graph/traversal.d.ts +18 -18
- package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
- package/dist/sdk/guide-topics.d.ts +19 -19
- package/dist/sdk/guide.d.ts +43 -43
- package/dist/sdk/history/attestation-command.d.ts +8 -8
- package/dist/sdk/history/attestation-contract.d.ts +43 -43
- package/dist/sdk/history/attestation-scan.d.ts +4 -4
- package/dist/sdk/history/attestation.d.ts +4 -4
- package/dist/sdk/history/maintenance.d.ts +25 -25
- package/dist/sdk/history/salvage.d.ts +19 -19
- package/dist/sdk/history/subject.d.ts +8 -8
- package/dist/sdk/history-analytics.d.ts +64 -64
- package/dist/sdk/history-compact.d.ts +67 -67
- package/dist/sdk/history-mcp.d.ts +7 -7
- package/dist/sdk/history-provenance.d.ts +40 -40
- package/dist/sdk/history-read.d.ts +24 -24
- package/dist/sdk/history-redact.d.ts +68 -68
- package/dist/sdk/history-repair.d.ts +92 -92
- package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
- package/dist/sdk/improvement-ledger.d.ts +62 -62
- package/dist/sdk/index.d.ts +69 -69
- package/dist/sdk/init-agent-guidance.d.ts +68 -68
- package/dist/sdk/init.d.ts +117 -117
- package/dist/sdk/invocation-author.d.ts +1 -1
- package/dist/sdk/item-children.d.ts +15 -15
- package/dist/sdk/item-metadata-index.d.ts +2 -2
- package/dist/sdk/item-schedule.d.ts +9 -9
- package/dist/sdk/item-transaction.d.ts +73 -73
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +38 -38
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -18
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- package/dist/sdk/lifecycle/create.d.ts +88 -88
- package/dist/sdk/lifecycle/delete.d.ts +15 -15
- package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
- package/dist/sdk/lifecycle/focus.d.ts +6 -6
- package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
- package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
- package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
- package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
- package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
- package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
- package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
- package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
- package/dist/sdk/lifecycle/plan.d.ts +127 -127
- package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
- package/dist/sdk/lifecycle/reopen.d.ts +15 -15
- package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
- package/dist/sdk/lifecycle/restore.d.ts +34 -34
- package/dist/sdk/lifecycle/restore.js +1 -1
- package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
- package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +120 -120
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +31 -31
- package/dist/sdk/linked-artifacts.d.ts +58 -58
- package/dist/sdk/mcp/apps.d.ts +28 -28
- package/dist/sdk/mcp/authorization.d.ts +66 -66
- package/dist/sdk/mcp/discovery.d.ts +67 -67
- package/dist/sdk/mcp/interactions.d.ts +49 -49
- package/dist/sdk/mcp/protocol.d.ts +63 -63
- package/dist/sdk/mcp/skills.d.ts +62 -62
- package/dist/sdk/mcp/subscriptions.d.ts +26 -26
- package/dist/sdk/mcp/tasks.d.ts +51 -51
- package/dist/sdk/mcp/transport.d.ts +17 -17
- package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
- package/dist/sdk/merge/driver.d.ts +38 -38
- package/dist/sdk/merge/index.d.ts +5 -5
- package/dist/sdk/merge/install.d.ts +48 -48
- package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
- package/dist/sdk/merge/receipt-operation.d.ts +6 -6
- package/dist/sdk/merge/receipt-schema.d.ts +11 -11
- package/dist/sdk/merge/receipts.d.ts +111 -111
- package/dist/sdk/merge/reconcile.d.ts +20 -20
- package/dist/sdk/merge/three-way.d.ts +50 -50
- package/dist/sdk/merge/three-way.js +2 -2
- package/dist/sdk/merge/worktree-config.d.ts +3 -3
- package/dist/sdk/mutation-events.d.ts +62 -62
- package/dist/sdk/mutation-guard.d.ts +134 -134
- package/dist/sdk/notes.d.ts +28 -28
- package/dist/sdk/output/table-rows.d.ts +6 -6
- package/dist/sdk/output-contracts.d.ts +26 -26
- package/dist/sdk/output-projection.d.ts +108 -108
- package/dist/sdk/output-token-accounting.d.ts +18 -18
- package/dist/sdk/output.d.ts +18 -18
- package/dist/sdk/ownership-source.d.ts +1 -1
- package/dist/sdk/package-import-adapters.d.ts +51 -51
- package/dist/sdk/package-migrations.d.ts +3 -3
- package/dist/sdk/package-runtime-options.d.ts +3 -3
- package/dist/sdk/pagination.d.ts +28 -28
- package/dist/sdk/pagination.js +1 -1
- package/dist/sdk/profile.d.ts +72 -72
- package/dist/sdk/provenance.d.ts +37 -37
- package/dist/sdk/public-surface.json +1 -1
- package/dist/sdk/query/activity.d.ts +84 -84
- package/dist/sdk/query/aggregate.d.ts +109 -109
- package/dist/sdk/query/calendar.d.ts +95 -95
- package/dist/sdk/query/complete-list.d.ts +35 -35
- package/dist/sdk/query/context.d.ts +300 -300
- package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
- package/dist/sdk/query/get.d.ts +54 -54
- package/dist/sdk/query/history.d.ts +38 -38
- package/dist/sdk/query/item-filter-options.d.ts +41 -41
- package/dist/sdk/query/light-metadata.d.ts +1 -1
- package/dist/sdk/query/list-filter-shared.d.ts +4 -4
- package/dist/sdk/query/list.d.ts +167 -167
- package/dist/sdk/query/list.js +1 -1
- package/dist/sdk/query/multi-value-filters.d.ts +6 -6
- package/dist/sdk/query/next-ready-budget.d.ts +8 -8
- package/dist/sdk/query/next.d.ts +94 -94
- package/dist/sdk/query/parsers.d.ts +3 -3
- package/dist/sdk/query/projection-contracts.d.ts +18 -18
- package/dist/sdk/query/search/corpus.d.ts +15 -15
- package/dist/sdk/query/search/filters.d.ts +15 -15
- package/dist/sdk/query/search/input.d.ts +8 -8
- package/dist/sdk/query/search/lexical.d.ts +10 -10
- package/dist/sdk/query/search/response.d.ts +22 -22
- package/dist/sdk/query/search/semantic.d.ts +133 -133
- package/dist/sdk/query/search/types.d.ts +65 -65
- package/dist/sdk/query/search-contracts.d.ts +53 -53
- package/dist/sdk/query/search-pagination.d.ts +21 -21
- package/dist/sdk/query/search-rendering.d.ts +30 -30
- package/dist/sdk/query/search.d.ts +60 -60
- package/dist/sdk/query/workspace-contracts.d.ts +2 -2
- package/dist/sdk/query.d.ts +6 -6
- package/dist/sdk/read-output/continuation.d.ts +11 -11
- package/dist/sdk/read-output/extension.d.ts +3 -3
- package/dist/sdk/read-output/options.d.ts +7 -7
- package/dist/sdk/read-output/provenance.d.ts +6 -6
- package/dist/sdk/read-output-budget.d.ts +11 -11
- package/dist/sdk/read-output-contracts.d.ts +112 -112
- package/dist/sdk/read-output-contracts.js +1 -1
- package/dist/sdk/read-output-rows.d.ts +15 -15
- package/dist/sdk/read-output-session.d.ts +29 -29
- package/dist/sdk/relationship-analytics.d.ts +46 -46
- package/dist/sdk/relationship-context.d.ts +48 -48
- package/dist/sdk/relationship-history.d.ts +59 -59
- package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
- package/dist/sdk/relationship-migration.d.ts +14 -14
- package/dist/sdk/relationships.d.ts +46 -46
- package/dist/sdk/reproducibility/process.d.ts +9 -9
- package/dist/sdk/runtime/actions.d.ts +1 -1
- package/dist/sdk/runtime/context.d.ts +15 -15
- package/dist/sdk/runtime/schema-preview.d.ts +1 -1
- package/dist/sdk/runtime/schema.d.ts +1 -1
- package/dist/sdk/runtime-action-aliases.d.ts +3 -3
- package/dist/sdk/runtime-extended-actions.d.ts +9 -9
- package/dist/sdk/runtime-input.d.ts +29 -29
- package/dist/sdk/runtime-primitives.d.ts +53 -53
- package/dist/sdk/runtime-primitives.js +1 -1
- package/dist/sdk/runtime-public-contracts.d.ts +46 -46
- package/dist/sdk/runtime-stats-options.d.ts +1 -1
- package/dist/sdk/runtime.d.ts +374 -374
- package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
- package/dist/sdk/schema-migration.d.ts +79 -79
- package/dist/sdk/schema.d.ts +224 -224
- package/dist/sdk/search-refresh-worker.d.ts +1 -1
- package/dist/sdk/similarity-scoring.d.ts +10 -10
- package/dist/sdk/similarity.d.ts +73 -73
- package/dist/sdk/start-task-status.d.ts +1 -1
- package/dist/sdk/stats.d.ts +72 -72
- package/dist/sdk/structured-mutations.d.ts +13 -13
- package/dist/sdk/telemetry-flush.d.ts +1 -1
- package/dist/sdk/telemetry.d.ts +32 -32
- package/dist/sdk/templates.d.ts +35 -35
- package/dist/sdk/test/batch.d.ts +50 -50
- package/dist/sdk/test/command-args.d.ts +2 -2
- package/dist/sdk/test/entry.d.ts +4 -4
- package/dist/sdk/test/execution-receipts.d.ts +5 -5
- package/dist/sdk/test/execution.d.ts +247 -247
- package/dist/sdk/test/json-path.d.ts +4 -4
- package/dist/sdk/test/linked-command-detection.d.ts +36 -36
- package/dist/sdk/test/measurements.d.ts +10 -10
- package/dist/sdk/test/parsers.d.ts +18 -18
- package/dist/sdk/test/prerequisites.d.ts +3 -3
- package/dist/sdk/test/runs.d.ts +43 -43
- package/dist/sdk/test/trust.d.ts +15 -15
- package/dist/sdk/test/update.d.ts +23 -23
- package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
- package/dist/sdk/testing.d.ts +248 -248
- package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
- package/dist/sdk/traceability/source-traceability.d.ts +50 -50
- package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
- package/dist/sdk/workspace-contracts.d.ts +20 -20
- package/dist/sdk/workspace-memory.d.ts +42 -42
- package/dist/sdk/workspace-recipe.d.ts +9 -9
- package/dist/sdk/workspace-snapshot.d.ts +60 -60
- package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
- package/dist/sdk/workspace-transaction.d.ts +26 -26
- package/dist/sdk/workspace.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/COMMANDS.md +11 -2
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/RELEASING.md +2 -0
- package/docs/TESTING.md +21 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
- package/marketplace.json +1 -1
- package/package.json +3 -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-claude/package.json +1 -1
- package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/pm-codex/package.json +1 -1
- package/plugins/pm-codex/plugin.json +1 -1
- package/runtime-dependencies.json +1 -1
- package/scripts/finalize-build.mjs +9 -3
- package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
- package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
- package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
- package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
|
@@ -3,137 +3,137 @@ import type { LinkScope } from "../types/index.js";
|
|
|
3
3
|
/** Restricts linked artifact values accepted by command, SDK, and storage contracts. */
|
|
4
4
|
export type LinkedArtifact = {
|
|
5
5
|
/** Filesystem path used for path resolution. */
|
|
6
|
-
path:
|
|
6
|
+
path:string;
|
|
7
7
|
/** Value that configures or reports scope for this contract. */
|
|
8
|
-
scope:
|
|
8
|
+
scope:LinkScope;
|
|
9
9
|
/** Value that configures or reports note for this contract. */
|
|
10
|
-
note?:
|
|
10
|
+
note?:string;
|
|
11
11
|
};
|
|
12
12
|
/** Allowed CSV/markdown keys for each structured linked-artifact option (GH-258). */
|
|
13
|
-
export declare const LINKED_ARTIFACT_ADD_KEYS:
|
|
13
|
+
export declare const LINKED_ARTIFACT_ADD_KEYS:readonly ["path","scope","note"];
|
|
14
14
|
/** Public contract for linked artifact add glob keys, shared by SDK and presentation-layer consumers. */
|
|
15
|
-
export declare const LINKED_ARTIFACT_ADD_GLOB_KEYS:
|
|
15
|
+
export declare const LINKED_ARTIFACT_ADD_GLOB_KEYS:readonly ["pattern","glob","path","scope","note"];
|
|
16
16
|
/** Public contract for linked artifact remove keys, shared by SDK and presentation-layer consumers. */
|
|
17
|
-
export declare const LINKED_ARTIFACT_REMOVE_KEYS:
|
|
17
|
+
export declare const LINKED_ARTIFACT_REMOVE_KEYS:readonly ["path"];
|
|
18
18
|
/** Public contract for linked artifact migrate keys, shared by SDK and presentation-layer consumers. */
|
|
19
|
-
export declare const LINKED_ARTIFACT_MIGRATE_KEYS:
|
|
19
|
+
export declare const LINKED_ARTIFACT_MIGRATE_KEYS:readonly ["from","to"];
|
|
20
20
|
/** Documents the linked artifact command options payload exchanged by command, SDK, and package integrations. */
|
|
21
21
|
export interface LinkedArtifactCommandOptions {
|
|
22
22
|
/** Value that configures or reports add for this contract. */
|
|
23
|
-
add?:
|
|
23
|
+
add?:string[];
|
|
24
24
|
/** Value that configures or reports add glob for this contract. */
|
|
25
|
-
addGlob?:
|
|
25
|
+
addGlob?:string[];
|
|
26
26
|
/** Value that configures or reports remove for this contract. */
|
|
27
|
-
remove?:
|
|
27
|
+
remove?:string[];
|
|
28
28
|
/** Value that configures or reports migrate for this contract. */
|
|
29
|
-
migrate?:
|
|
29
|
+
migrate?:string[];
|
|
30
30
|
/** GH-170 (pm-pfnx): standalone note applied to every link added by --add / --add-glob in the same invocation. A per-entry embedded note (the `path=...,note=...` pair syntax) takes precedence over this flag. Requires at least one --add/--add-glob; rejected otherwise. */
|
|
31
|
-
note?:
|
|
31
|
+
note?:string;
|
|
32
32
|
/** Value that configures or reports list for this contract. */
|
|
33
|
-
list?:
|
|
33
|
+
list?:boolean;
|
|
34
34
|
/** Value that configures or reports append stable for this contract. */
|
|
35
|
-
appendStable?:
|
|
35
|
+
appendStable?:boolean;
|
|
36
36
|
/** Value that configures or reports validate paths for this contract. */
|
|
37
|
-
validatePaths?:
|
|
37
|
+
validatePaths?:boolean;
|
|
38
38
|
/** Value that configures or reports author for this contract. */
|
|
39
|
-
author?:
|
|
39
|
+
author?:string;
|
|
40
40
|
/** Human-readable explanation suitable for logs and agent-facing output. */
|
|
41
|
-
message?:
|
|
41
|
+
message?:string;
|
|
42
42
|
/** Value that configures or reports force for this contract. */
|
|
43
|
-
force?:
|
|
43
|
+
force?:boolean;
|
|
44
44
|
}
|
|
45
45
|
/** Documents the path migration payload exchanged by command, SDK, and package integrations. */
|
|
46
46
|
export interface PathMigration {
|
|
47
47
|
/** Value that configures or reports from for this contract. */
|
|
48
|
-
from:
|
|
48
|
+
from:string;
|
|
49
49
|
/** Value that configures or reports to for this contract. */
|
|
50
|
-
to:
|
|
50
|
+
to:string;
|
|
51
51
|
}
|
|
52
52
|
/** Documents the add glob entry payload exchanged by command, SDK, and package integrations. */
|
|
53
53
|
export interface AddGlobEntry {
|
|
54
54
|
/** Value that configures or reports pattern for this contract. */
|
|
55
|
-
pattern:
|
|
55
|
+
pattern:string;
|
|
56
56
|
/** Value that configures or reports scope for this contract. */
|
|
57
|
-
scope:
|
|
57
|
+
scope:LinkScope;
|
|
58
58
|
/** Value that configures or reports note for this contract. */
|
|
59
|
-
note?:
|
|
59
|
+
note?:string;
|
|
60
60
|
}
|
|
61
61
|
/** Documents the linked path validation payload exchanged by command, SDK, and package integrations. */
|
|
62
62
|
export interface LinkedPathValidation {
|
|
63
63
|
/** Value that configures or reports checked for this contract. */
|
|
64
|
-
checked:
|
|
64
|
+
checked:number;
|
|
65
65
|
/** Value that configures or reports existing files for this contract. */
|
|
66
|
-
existing_files:
|
|
66
|
+
existing_files:string[];
|
|
67
67
|
/** Value that configures or reports missing paths for this contract. */
|
|
68
|
-
missing_paths:
|
|
68
|
+
missing_paths:string[];
|
|
69
69
|
/** Value that configures or reports non file paths for this contract. */
|
|
70
|
-
non_file_paths:
|
|
70
|
+
non_file_paths:string[];
|
|
71
71
|
/** Remote references (https:// URLs and other `scheme://` paths) recorded as links — most often a PR/issue/design-doc URL added via `pm docs --add`. These are not local files, so they bypass the existence probe and are reported here rather than counted as missing. */
|
|
72
|
-
remote_references:
|
|
72
|
+
remote_references:string[];
|
|
73
73
|
}
|
|
74
74
|
/** Documents the linked artifact result payload exchanged by command, SDK, and package integrations. */
|
|
75
75
|
export interface LinkedArtifactResult {
|
|
76
76
|
/** Stable identifier used to reference this record across commands and storage. */
|
|
77
|
-
id:
|
|
77
|
+
id:string;
|
|
78
78
|
/** Value that configures or reports changed for this contract. */
|
|
79
|
-
changed:
|
|
79
|
+
changed:boolean;
|
|
80
80
|
/** Value that configures or reports count for this contract. */
|
|
81
|
-
count:
|
|
81
|
+
count:number;
|
|
82
82
|
/** Value that configures or reports migrations applied for this contract. */
|
|
83
|
-
migrations_applied?:
|
|
83
|
+
migrations_applied?:number;
|
|
84
84
|
/** Value that configures or reports validation for this contract. */
|
|
85
|
-
validation?:
|
|
85
|
+
validation?:LinkedPathValidation;
|
|
86
86
|
/** Value that configures or reports artifacts for this contract. */
|
|
87
|
-
artifacts:
|
|
87
|
+
artifacts:LinkedArtifact[];
|
|
88
88
|
}
|
|
89
89
|
/** Replaces the generic artifacts field with a resource-specific result key while retaining the remaining result contract. */
|
|
90
|
-
export type RenamedLinkedArtifactResult<Result extends LinkedArtifactResult,
|
|
91
|
-
[Field in Key]:
|
|
90
|
+
export type RenamedLinkedArtifactResult<Result extends LinkedArtifactResult,Key extends "files" | "docs"> = Omit<Result,"artifacts"> & {
|
|
91
|
+
[Field in Key]:Result["artifacts"];
|
|
92
92
|
};
|
|
93
93
|
/** Configuration that adapts the shared linked-artifact command core to a specific resource kind (files or docs) while preserving every behavioral detail of the original twin implementations. */
|
|
94
94
|
export interface LinkedArtifactKindConfig {
|
|
95
95
|
/** Metadata key under which the artifacts are stored (e.g. "files" | "docs"). */
|
|
96
|
-
metadataKey:
|
|
96
|
+
metadataKey:"files" | "docs";
|
|
97
97
|
/** Mutation op recorded in history (e.g. "files_add" | "docs_add"). */
|
|
98
|
-
op:
|
|
98
|
+
op:"files_add" | "docs_add";
|
|
99
99
|
/** Noun used in the "bare <noun> path" --add usage error (e.g. "file" | "doc"). */
|
|
100
|
-
bareNoun:
|
|
100
|
+
bareNoun:"file" | "doc";
|
|
101
101
|
/** Whether this kind honors the append-stable option. files supports it; docs always sorts and must never expose append-stable behavior. */
|
|
102
|
-
supportsAppendStable:
|
|
102
|
+
supportsAppendStable:boolean;
|
|
103
103
|
}
|
|
104
104
|
/** Implements ensure scope for the public runtime surface of this module. */
|
|
105
|
-
export declare function ensureScope(raw:
|
|
105
|
+
export declare function ensureScope(raw:string | undefined):LinkScope;
|
|
106
106
|
/** Implements looks like structured path entry for the public runtime surface of this module. */
|
|
107
|
-
export declare function looksLikeStructuredPathEntry(raw:
|
|
107
|
+
export declare function looksLikeStructuredPathEntry(raw:string):boolean;
|
|
108
108
|
/** Implements parse add entries for the public runtime surface of this module. */
|
|
109
|
-
export declare function parseAddEntries(raw:
|
|
109
|
+
export declare function parseAddEntries(raw:string[] | undefined,bareNoun:"file" | "doc"):LinkedArtifact[];
|
|
110
110
|
/** Implements parse add glob entries for the public runtime surface of this module. */
|
|
111
|
-
export declare function parseAddGlobEntries(raw:
|
|
111
|
+
export declare function parseAddGlobEntries(raw:string[] | undefined):AddGlobEntry[];
|
|
112
112
|
/** Implements parse remove entries for the public runtime surface of this module. */
|
|
113
|
-
export declare function parseRemoveEntries(raw:
|
|
113
|
+
export declare function parseRemoveEntries(raw:string[] | undefined):string[];
|
|
114
114
|
/** Implements parse migrate entries for the public runtime surface of this module. */
|
|
115
|
-
export declare function parseMigrateEntries(raw:
|
|
115
|
+
export declare function parseMigrateEntries(raw:string[] | undefined):PathMigration[];
|
|
116
116
|
/** Implements apply path migrations for the public runtime surface of this module. */
|
|
117
|
-
export declare function applyPathMigrations(artifactPath:
|
|
117
|
+
export declare function applyPathMigrations(artifactPath:string,migrations:PathMigration[]):string;
|
|
118
118
|
/** Reject a transaction that resolves the same linked path into both add and remove sets. */
|
|
119
|
-
export declare function assertLinkedArtifactMutationIsUnambiguous(adds:
|
|
119
|
+
export declare function assertLinkedArtifactMutationIsUnambiguous(adds:LinkedArtifact[],removes:string[],migrations?:PathMigration[]):void;
|
|
120
120
|
/** Implements normalize linked path for the public runtime surface of this module. */
|
|
121
|
-
export declare function normalizeLinkedPath(value:
|
|
121
|
+
export declare function normalizeLinkedPath(value:string):string;
|
|
122
122
|
/** Anchor a local linked path to the project workspace while preserving remote references and absolute paths. */
|
|
123
|
-
export declare function anchorLinkedPath(value:
|
|
123
|
+
export declare function anchorLinkedPath(value:string,workspaceRoot:string,invocationRoot?:string):string;
|
|
124
124
|
/** Match files from the invocation directory, then anchor and sort each entry while retaining its scope and note. Literal directories never expand recursively. */
|
|
125
|
-
export declare function expandAddGlobEntries(entries:
|
|
125
|
+
export declare function expandAddGlobEntries(entries:AddGlobEntry[],workspaceRoot?:string,invocationRoot?:string):Promise<LinkedArtifact[]>;
|
|
126
126
|
/** GH-170 (pm-pfnx): apply a standalone --note to the links added in this invocation. Semantics (documented on pm-pfnx): the note is attached to EVERY entry added via --add/--add-glob so a single flag annotates the whole batch predictably; a per-entry embedded `note=` wins over the standalone flag; and --note without any --add/--add-glob flag is a usage error because there is nothing to annotate (it never retro-edits existing links). `hasAddFlags` reflects flag presence, not match count, so a glob that legitimately matches zero files is not an error. */
|
|
127
|
-
export declare function applyStandaloneNote(adds:
|
|
127
|
+
export declare function applyStandaloneNote(adds:LinkedArtifact[],note:string | undefined,hasAddFlags:boolean):LinkedArtifact[];
|
|
128
128
|
/** Implements artifact key for the public runtime surface of this module. */
|
|
129
|
-
export declare function artifactKey(value:
|
|
129
|
+
export declare function artifactKey(value:Pick<LinkedArtifact,"path" | "scope">):string;
|
|
130
130
|
/** Implements sort linked artifacts for the public runtime surface of this module. */
|
|
131
|
-
export declare function sortLinkedArtifacts(artifacts:
|
|
131
|
+
export declare function sortLinkedArtifacts(artifacts:LinkedArtifact[]):LinkedArtifact[];
|
|
132
132
|
/** Implements dedupe linked artifacts for the public runtime surface of this module. */
|
|
133
|
-
export declare function dedupeLinkedArtifacts(artifacts:
|
|
133
|
+
export declare function dedupeLinkedArtifacts(artifacts:LinkedArtifact[]):LinkedArtifact[];
|
|
134
134
|
/** Implements validate linked paths for the public runtime surface of this module. */
|
|
135
|
-
export declare function validateLinkedPaths(paths:
|
|
135
|
+
export declare function validateLinkedPaths(paths:string[],workspaceRoot?:string):Promise<LinkedPathValidation>;
|
|
136
136
|
/** Shared linked-artifact list/mutate command core used by runFiles and runDocs. The kind config selects metadata key, op, bare-path noun, and whether append-stable ordering is honored, preserving each twin's exact semantics. */
|
|
137
|
-
export declare function runLinkedArtifacts(id:
|
|
137
|
+
export declare function runLinkedArtifacts(id:string,options:LinkedArtifactCommandOptions,global:GlobalOptions,config:LinkedArtifactKindConfig):Promise<LinkedArtifactResult>;
|
|
138
138
|
/** Re-key the generic `artifacts` field to the resource-specific name (files/docs) while preserving the original key order and presence so kind-specific result shapes (and their deterministic JSON key ordering) stay byte-identical. */
|
|
139
|
-
export declare function renameArtifactsResultKey<Result extends LinkedArtifactResult,
|
|
139
|
+
export declare function renameArtifactsResultKey<Result extends LinkedArtifactResult,const Key extends "files" | "docs">(result:Result,key:Key):RenamedLinkedArtifactResult<Result,Key>;
|
package/dist/sdk/mcp/apps.d.ts
CHANGED
|
@@ -1,64 +1,64 @@
|
|
|
1
1
|
import { type PmMcpRequestContext } from "./protocol.js";
|
|
2
2
|
interface McpUiToolMeta {
|
|
3
3
|
/** MCP App resource displayed for this tool. */
|
|
4
|
-
resourceUri:
|
|
4
|
+
resourceUri:string;
|
|
5
5
|
/** Principals allowed to discover and invoke the tool. */
|
|
6
|
-
visibility:
|
|
6
|
+
visibility:Array<"model" | "app">;
|
|
7
7
|
}
|
|
8
8
|
interface McpUiResourceMeta {
|
|
9
9
|
/** Explicitly bounded network and embedding policy. */
|
|
10
|
-
csp:
|
|
11
|
-
connectDomains:
|
|
12
|
-
resourceDomains:
|
|
13
|
-
frameDomains:
|
|
10
|
+
csp:{
|
|
11
|
+
connectDomains:string[];
|
|
12
|
+
resourceDomains:string[];
|
|
13
|
+
frameDomains:string[];
|
|
14
14
|
};
|
|
15
15
|
/** Browser permissions requested by the app. */
|
|
16
|
-
permissions:
|
|
16
|
+
permissions:Record<string,never>;
|
|
17
17
|
/** Whether the host should present a visible app boundary. */
|
|
18
|
-
prefersBorder:
|
|
18
|
+
prefersBorder:boolean;
|
|
19
19
|
}
|
|
20
20
|
/** Stable MCP Apps extension identifier. */
|
|
21
|
-
export declare const PM_MCP_APPS_EXTENSION:
|
|
21
|
+
export declare const PM_MCP_APPS_EXTENSION:"io.modelcontextprotocol/ui";
|
|
22
22
|
/** Stable MCP Apps specification revision implemented by pm. */
|
|
23
|
-
export declare const PM_MCP_APPS_SPEC_VERSION:
|
|
23
|
+
export declare const PM_MCP_APPS_SPEC_VERSION:"2026-01-26";
|
|
24
24
|
/** Official MIME type for MCP App HTML resources. */
|
|
25
|
-
export declare const PM_MCP_APP_MIME_TYPE:
|
|
25
|
+
export declare const PM_MCP_APP_MIME_TYPE:"text/html;profile=mcp-app";
|
|
26
26
|
/** Server-side MCP Apps capability advertised through discovery. */
|
|
27
|
-
export declare const PM_MCP_APPS_SERVER_CAPABILITY:
|
|
28
|
-
specVersion:
|
|
29
|
-
mimeTypes:
|
|
27
|
+
export declare const PM_MCP_APPS_SERVER_CAPABILITY:Readonly<{
|
|
28
|
+
specVersion:"2026-01-26";
|
|
29
|
+
mimeTypes:"text/html;profile=mcp-app"[];
|
|
30
30
|
}>;
|
|
31
31
|
/**
|
|
32
32
|
* Resolve whether a request negotiated MCP Apps, rejecting malformed explicit
|
|
33
33
|
* declarations instead of silently serving a different extension revision.
|
|
34
34
|
*/
|
|
35
|
-
export declare function hasPmMcpAppsCapability(context:
|
|
35
|
+
export declare function hasPmMcpAppsCapability(context:PmMcpRequestContext):boolean;
|
|
36
36
|
/** One optional pm view and the authoritative tool that supplies its data. */
|
|
37
37
|
export interface PmMcpAppContract {
|
|
38
38
|
/** Stable view identifier. */
|
|
39
|
-
id:
|
|
39
|
+
id:"context" | "graph" | "plan" | "assurance" | "operations";
|
|
40
40
|
/** Human-readable view name. */
|
|
41
|
-
name:
|
|
41
|
+
name:string;
|
|
42
42
|
/** Concise purpose shown during resource discovery. */
|
|
43
|
-
description:
|
|
43
|
+
description:string;
|
|
44
44
|
/** Existing SDK-backed tool whose result the view renders. */
|
|
45
|
-
toolName:
|
|
45
|
+
toolName:string;
|
|
46
46
|
/** Stable MCP App resource URI. */
|
|
47
|
-
uri:
|
|
47
|
+
uri:string;
|
|
48
48
|
/** Tool metadata validated against the official MCP Apps package types. */
|
|
49
|
-
toolMeta:
|
|
49
|
+
toolMeta:McpUiToolMeta;
|
|
50
50
|
/** Resource sandbox and presentation metadata. */
|
|
51
|
-
resourceMeta:
|
|
51
|
+
resourceMeta:McpUiResourceMeta;
|
|
52
52
|
}
|
|
53
53
|
/** Canonical optional pm MCP Apps. */
|
|
54
|
-
export declare const PM_MCP_APP_CONTRACTS:
|
|
54
|
+
export declare const PM_MCP_APP_CONTRACTS:readonly PmMcpAppContract[];
|
|
55
55
|
/** Return the app contract for a resource URI. */
|
|
56
|
-
export declare function findPmMcpAppByUri(uri:
|
|
56
|
+
export declare function findPmMcpAppByUri(uri:string):PmMcpAppContract | undefined;
|
|
57
57
|
/** Attach negotiated MCP App metadata to matching tool definitions. */
|
|
58
58
|
export declare function decoratePmMcpToolsWithApps<Tool extends {
|
|
59
|
-
name:
|
|
60
|
-
_meta?:
|
|
61
|
-
}>(tools:
|
|
59
|
+
name:string;
|
|
60
|
+
_meta?:Record<string,unknown>;
|
|
61
|
+
}>(tools:readonly Tool[]):Tool[];
|
|
62
62
|
/**
|
|
63
63
|
* Render a self-contained, sandbox-compatible MCP App document.
|
|
64
64
|
*
|
|
@@ -66,5 +66,5 @@ _meta?: Record<string, unknown>;
|
|
|
66
66
|
* the authoritative tool input/result from the host, bounds large rendering,
|
|
67
67
|
* and presents the text fallback when structured content is unavailable.
|
|
68
68
|
*/
|
|
69
|
-
export declare function renderPmMcpAppHtml(contract:
|
|
69
|
+
export declare function renderPmMcpAppHtml(contract:PmMcpAppContract):string;
|
|
70
70
|
export {};
|
|
@@ -2,133 +2,133 @@ import type { PmMcpHttpHeaders } from "./transport.js";
|
|
|
2
2
|
/** Authorization failure with an HTTP status and disclosure-safe context. */
|
|
3
3
|
export declare class PmMcpAuthorizationError extends Error {
|
|
4
4
|
/** HTTP status required at the remote MCP boundary. */
|
|
5
|
-
readonly httpStatus:
|
|
5
|
+
readonly httpStatus:401 | 403;
|
|
6
6
|
/** Optional RFC 6750 challenge safe to send to an unauthenticated client. */
|
|
7
|
-
readonly challenge?:
|
|
7
|
+
readonly challenge?:string;
|
|
8
8
|
/** Create one remote authorization refusal. */
|
|
9
|
-
constructor(message:
|
|
9
|
+
constructor(message:string,httpStatus:401 | 403,challenge?:string);
|
|
10
10
|
}
|
|
11
11
|
/** RFC 9728 metadata served by a protected pm MCP resource. */
|
|
12
12
|
export interface PmMcpProtectedResourceMetadata {
|
|
13
13
|
/** Canonical MCP resource URI used for token audience binding. */
|
|
14
|
-
resource:
|
|
14
|
+
resource:string;
|
|
15
15
|
/** Independent authorization-server issuers accepted by this resource. */
|
|
16
|
-
authorization_servers:
|
|
16
|
+
authorization_servers:string[];
|
|
17
17
|
/** Minimal scopes used for initial least-privilege authorization. */
|
|
18
|
-
scopes_supported?:
|
|
18
|
+
scopes_supported?:string[];
|
|
19
19
|
}
|
|
20
20
|
/** Validated authorization-server discovery fields needed by MCP clients. */
|
|
21
21
|
export interface PmMcpAuthorizationServerMetadata {
|
|
22
22
|
/** Exact issuer identifier. */
|
|
23
|
-
issuer:
|
|
23
|
+
issuer:string;
|
|
24
24
|
/** Authorization endpoint for code flows. */
|
|
25
|
-
authorization_endpoint?:
|
|
25
|
+
authorization_endpoint?:string;
|
|
26
26
|
/** Token endpoint used to redeem authorization codes. */
|
|
27
|
-
token_endpoint?:
|
|
27
|
+
token_endpoint?:string;
|
|
28
28
|
/** PKCE methods advertised by the authorization server. */
|
|
29
|
-
code_challenge_methods_supported:
|
|
29
|
+
code_challenge_methods_supported:string[];
|
|
30
30
|
/** Whether URL-form Client ID Metadata Documents are supported. */
|
|
31
|
-
client_id_metadata_document_supported?:
|
|
31
|
+
client_id_metadata_document_supported?:boolean;
|
|
32
32
|
/** Deprecated dynamic-registration fallback endpoint. */
|
|
33
|
-
registration_endpoint?:
|
|
33
|
+
registration_endpoint?:string;
|
|
34
34
|
}
|
|
35
35
|
/** Discovery metadata after endpoint and PKCE validation succeeds. */
|
|
36
36
|
export interface PmMcpValidatedAuthorizationServerMetadata extends PmMcpAuthorizationServerMetadata {
|
|
37
37
|
/** Validated HTTPS authorization endpoint for code flows. */
|
|
38
|
-
authorization_endpoint:
|
|
38
|
+
authorization_endpoint:string;
|
|
39
39
|
/** Validated HTTPS token endpoint used to redeem authorization codes. */
|
|
40
|
-
token_endpoint:
|
|
40
|
+
token_endpoint:string;
|
|
41
41
|
}
|
|
42
42
|
/** Client registration strategy ordered by current MCP preference. */
|
|
43
43
|
export type PmMcpClientRegistrationMode = "pre_registered" | "client_id_metadata_document" | "dynamic" | "user_supplied";
|
|
44
44
|
/** Bound access-token facts returned by a host-provided verifier. */
|
|
45
45
|
export interface PmMcpAccessTokenClaims {
|
|
46
46
|
/** Stable authenticated principal without raw token material. */
|
|
47
|
-
principal:
|
|
47
|
+
principal:string;
|
|
48
48
|
/** Issuer that minted the token. */
|
|
49
|
-
issuer:
|
|
49
|
+
issuer:string;
|
|
50
50
|
/** Intended resource audiences. */
|
|
51
|
-
audience:
|
|
51
|
+
audience:string | string[];
|
|
52
52
|
/** Granted OAuth scopes. */
|
|
53
|
-
scopes:
|
|
53
|
+
scopes:string[];
|
|
54
54
|
}
|
|
55
55
|
/** Policy a Streamable HTTP adapter enforces before dispatching MCP. */
|
|
56
56
|
export interface PmMcpHttpAuthorizationPolicy {
|
|
57
57
|
/** Exact accepted issuer. */
|
|
58
|
-
issuer:
|
|
58
|
+
issuer:string;
|
|
59
59
|
/** Exact canonical MCP resource audience. */
|
|
60
|
-
resource:
|
|
60
|
+
resource:string;
|
|
61
61
|
/** Scopes required for this endpoint or operation. */
|
|
62
|
-
requiredScopes?:
|
|
62
|
+
requiredScopes?:string[];
|
|
63
63
|
/** Protected-resource metadata location for RFC 6750 challenges. */
|
|
64
|
-
resourceMetadataUrl:
|
|
64
|
+
resourceMetadataUrl:string;
|
|
65
65
|
/** Validate an opaque or structured access token without passing it onward. */
|
|
66
|
-
verifyAccessToken:
|
|
66
|
+
verifyAccessToken:(token:string) => PmMcpAccessTokenClaims | Promise<PmMcpAccessTokenClaims>;
|
|
67
67
|
}
|
|
68
68
|
/** W3C trace context accepted from request `_meta`. */
|
|
69
69
|
export interface PmMcpTraceContext {
|
|
70
70
|
/** W3C trace-parent value. */
|
|
71
|
-
traceparent?:
|
|
71
|
+
traceparent?:string;
|
|
72
72
|
/** W3C trace-state value. */
|
|
73
|
-
tracestate?:
|
|
73
|
+
tracestate?:string;
|
|
74
74
|
/** Allowlisted W3C baggage members only. */
|
|
75
|
-
baggage?:
|
|
75
|
+
baggage?:string;
|
|
76
76
|
}
|
|
77
77
|
/** Build and validate protected-resource metadata for a remote pm endpoint. */
|
|
78
|
-
export declare function buildMcpProtectedResourceMetadata(input:
|
|
79
|
-
resource:
|
|
80
|
-
authorizationServers:
|
|
81
|
-
scopes?:
|
|
82
|
-
}):
|
|
78
|
+
export declare function buildMcpProtectedResourceMetadata(input:{
|
|
79
|
+
resource:string;
|
|
80
|
+
authorizationServers:readonly string[];
|
|
81
|
+
scopes?:readonly string[];
|
|
82
|
+
}):PmMcpProtectedResourceMetadata;
|
|
83
83
|
/** Construct OAuth and OIDC discovery URLs in the MCP-required order. */
|
|
84
|
-
export declare function buildMcpAuthorizationDiscoveryUrls(issuer:
|
|
84
|
+
export declare function buildMcpAuthorizationDiscoveryUrls(issuer:string):string[];
|
|
85
85
|
/** Validate authorization-server metadata, exact issuer binding, and S256 PKCE. */
|
|
86
|
-
export declare function validateMcpAuthorizationServerMetadata(value:
|
|
86
|
+
export declare function validateMcpAuthorizationServerMetadata(value:unknown,expectedIssuer:string):PmMcpValidatedAuthorizationServerMetadata;
|
|
87
87
|
/** Apply the current pre-registration, metadata-document, dynamic, prompt order. */
|
|
88
|
-
export declare function selectMcpClientRegistrationMode(input:
|
|
89
|
-
hasPreRegisteredClient:
|
|
90
|
-
metadata:
|
|
91
|
-
}):
|
|
88
|
+
export declare function selectMcpClientRegistrationMode(input:{
|
|
89
|
+
hasPreRegisteredClient:boolean;
|
|
90
|
+
metadata:Pick<PmMcpAuthorizationServerMetadata,"client_id_metadata_document_supported" | "registration_endpoint">;
|
|
91
|
+
}):PmMcpClientRegistrationMode;
|
|
92
92
|
/** Validate a present authorization-response issuer before code redemption. */
|
|
93
|
-
export declare function validateMcpAuthorizationResponseIssuer(input:
|
|
94
|
-
expectedIssuer:
|
|
95
|
-
responseIssuer?:
|
|
96
|
-
issuerParameterSupported?:
|
|
97
|
-
}):
|
|
93
|
+
export declare function validateMcpAuthorizationResponseIssuer(input:{
|
|
94
|
+
expectedIssuer:string;
|
|
95
|
+
responseIssuer?:string;
|
|
96
|
+
issuerParameterSupported?:boolean;
|
|
97
|
+
}):void;
|
|
98
98
|
/** Validate a self-hosted Client ID Metadata Document and exact redirect set. */
|
|
99
|
-
export declare function validateMcpClientMetadataDocument(value:
|
|
99
|
+
export declare function validateMcpClientMetadataDocument(value:unknown,documentUrl:string):Record<string,unknown>;
|
|
100
100
|
/** Build bounded dynamic-registration metadata for explicit legacy fallback. */
|
|
101
|
-
export declare function buildMcpDynamicRegistrationMetadata(input:
|
|
102
|
-
redirectUris:
|
|
103
|
-
applicationType:
|
|
104
|
-
clientName:
|
|
105
|
-
}):
|
|
101
|
+
export declare function buildMcpDynamicRegistrationMetadata(input:{
|
|
102
|
+
redirectUris:readonly string[];
|
|
103
|
+
applicationType:"native" | "web";
|
|
104
|
+
clientName:string;
|
|
105
|
+
}):Record<string,unknown>;
|
|
106
106
|
/** In-memory issuer-keyed credential primitive that never reuses cross-issuer state. */
|
|
107
|
-
export declare class PmMcpIssuerCredentialStore<Credential extends Record<string,
|
|
107
|
+
export declare class PmMcpIssuerCredentialStore<Credential extends Record<string,unknown>> {
|
|
108
108
|
#private;
|
|
109
109
|
/** Persist a cloned credential under the exact validated issuer. */
|
|
110
|
-
set(issuer:
|
|
110
|
+
set(issuer:string,credential:Credential):void;
|
|
111
111
|
/** Read a cloned credential only for the exact issuer. */
|
|
112
|
-
get(issuer:
|
|
112
|
+
get(issuer:string):Credential | undefined;
|
|
113
113
|
/** Remove credentials for one issuer during revocation or re-registration. */
|
|
114
|
-
delete(issuer:
|
|
114
|
+
delete(issuer:string):boolean;
|
|
115
115
|
}
|
|
116
116
|
/** Extract W3C trace context with strict syntax, size, and baggage allowlists. */
|
|
117
|
-
export declare function extractMcpTraceContext(params:
|
|
118
|
-
baggageAllowlist?:
|
|
119
|
-
}):
|
|
117
|
+
export declare function extractMcpTraceContext(params:unknown,options?:{
|
|
118
|
+
baggageAllowlist?:readonly string[];
|
|
119
|
+
}):PmMcpTraceContext;
|
|
120
120
|
/** Run one request with trace context isolated from every concurrent request. */
|
|
121
|
-
export declare function runWithMcpTraceContext<Result>(context:
|
|
121
|
+
export declare function runWithMcpTraceContext<Result>(context:PmMcpTraceContext,callback:() => Result):Result;
|
|
122
122
|
/** Read a defensive copy of the current request's trace context. */
|
|
123
|
-
export declare function getActiveMcpTraceContext():
|
|
123
|
+
export declare function getActiveMcpTraceContext():PmMcpTraceContext | undefined;
|
|
124
124
|
/** Enforce bearer location, issuer, audience, and least-privilege scopes. */
|
|
125
|
-
export declare function authorizeMcpHttpRequest(input:
|
|
126
|
-
headers:
|
|
127
|
-
requestUrl:
|
|
128
|
-
policy:
|
|
129
|
-
}):
|
|
125
|
+
export declare function authorizeMcpHttpRequest(input:{
|
|
126
|
+
headers:PmMcpHttpHeaders;
|
|
127
|
+
requestUrl:string;
|
|
128
|
+
policy:PmMcpHttpAuthorizationPolicy;
|
|
129
|
+
}):Promise<PmMcpAccessTokenClaims>;
|
|
130
130
|
/** Create an exact opaque-token verifier without exposing token values in results. */
|
|
131
|
-
export declare function createMcpStaticBearerVerifier(input:
|
|
132
|
-
token:
|
|
133
|
-
claims:
|
|
134
|
-
}):
|
|
131
|
+
export declare function createMcpStaticBearerVerifier(input:{
|
|
132
|
+
token:string;
|
|
133
|
+
claims:PmMcpAccessTokenClaims;
|
|
134
|
+
}):(token:string) => PmMcpAccessTokenClaims;
|