@unbrained/pm-cli 2026.10.14 → 2026.10.17
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/references/COMMAND_PLAYBOOK.md +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/AGENTS.md +1 -0
- package/CHANGELOG.md +74 -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 +18 -16
- package/dist/cli/extension-command-options.js +1 -1
- package/dist/cli/extension-recovery.d.ts +13 -13
- package/dist/cli/help-content.d.ts +22 -22
- package/dist/cli/help-content.js +3 -3
- 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-mutation.js +2 -2
- package/dist/cli/register-operations.d.ts +75 -75
- package/dist/cli/register-operations.js +1 -1
- package/dist/cli/register-setup.d.ts +4 -4
- package/dist/cli/register-structured-mutation.d.ts +8 -13
- package/dist/cli/register-structured-mutation.js +1 -1
- package/dist/cli/runtime/activation.d.ts +23 -23
- package/dist/cli/runtime/invocation-options.d.ts +12 -12
- package/dist/cli/runtime/invocation-options.js +1 -1
- 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-LKESCZEN.js → chunk-3QKI3XNX.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-4PNPDT2N.js +236 -0
- package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-6ZDKKOKM.js} +28 -28
- package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-B5QVGCZX.js} +2 -2
- package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-EA2CG7UM.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-HY7FQ7QX.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-J4LPQCET.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-JS3B2M4D.js +6 -0
- package/dist/cli-bundle/chunks/chunk-O4YBC3OM.js +30 -0
- package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-OZCSXX4D.js} +63 -64
- package/dist/cli-bundle/chunks/chunk-VMCSTFSO.js +2 -0
- package/dist/cli-bundle/chunks/chunk-W3KZ22DW.js +2 -0
- package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-X2ONXFBP.js} +2 -2
- package/dist/cli-bundle/chunks/chunk-X53HM753.js +20 -0
- package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-RU3QZSAQ.js} +7 -7
- package/dist/cli-bundle/chunks/register-mutation-EQYMT32A.js +20 -0
- package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-VXBGE4XI.js} +2 -2
- package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-UUDEGFRO.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-2IOHHNRT.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-5JEFDEL3.js +166 -0
- package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-AH6NX6GM.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-E33QA7PK.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-FTUZ3JF2.js} +6 -6
- package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-JXR6UKFM.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-LDKX4KYJ.js +2 -0
- package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-MBQF6HT6.js} +2 -2
- package/dist/cli-bundle/focused-chunks/chunk-NZO7GOXD.js +20 -0
- package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-PYC7BF6Z.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-QOSVJDOO.js} +61 -62
- package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-RBLSY6ML.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-RHTH5ILM.js} +2 -2
- package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-SIGIGZCG.js} +3 -3
- package/dist/cli-bundle/focused-chunks/chunk-TRFVAWF2.js +26 -0
- package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-UNTQE37U.js} +2 -2
- package/dist/cli-bundle/main.js +22 -22
- 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 +23 -23
- 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 +54 -54
- 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 +717 -702
- package/dist/core/extensions/extension-types.js +1 -1
- package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
- package/dist/core/extensions/flag-value-types.d.ts +32 -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-contracts.js +1 -1
- 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-format.js +3 -3
- 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 -25
- package/dist/core/output/mutation-projection.js +1 -1
- 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 +15 -15
- package/dist/core/schema/type-workflows.js +1 -1
- 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 +5 -3
- package/dist/core/shared/text-normalization.js +1 -1
- 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-mutation-precondition.d.ts +11 -0
- package/dist/core/store/item-mutation-precondition.js +2 -0
- 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/server.js +1 -1
- package/dist/mcp/tool-definitions.d.ts +27 -27
- package/dist/mcp/tool-definitions.js +1 -1
- 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/agent-output-contracts.js +1 -1
- 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/flag-lexicon-contracts.js +1 -1
- package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
- package/dist/sdk/cli-contracts/registration-helpers.d.ts +57 -57
- package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
- 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/tool-schema.js +1 -1
- 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-contracts.js +1 -1
- 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 +9 -8
- package/dist/sdk/core.js +1 -1
- 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-1.js +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-topics.js +1 -1
- 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 +70 -69
- package/dist/sdk/index.js +1 -1
- 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 +139 -76
- package/dist/sdk/item-transaction.js +1 -1
- package/dist/sdk/learnings.d.ts +23 -23
- package/dist/sdk/lifecycle/append.d.ts +8 -8
- package/dist/sdk/lifecycle/claim.d.ts +53 -39
- package/dist/sdk/lifecycle/claim.js +1 -1
- package/dist/sdk/lifecycle/close-many.d.ts +71 -71
- package/dist/sdk/lifecycle/close.d.ts +18 -24
- package/dist/sdk/lifecycle/close.js +1 -1
- package/dist/sdk/lifecycle/copy.d.ts +10 -10
- package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
- package/dist/sdk/lifecycle/core-item-fields.d.ts +6 -0
- package/dist/sdk/lifecycle/core-item-fields.js +2 -0
- 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/mcp-actions.js +1 -1
- 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/mutation-option-validation.d.ts +2 -0
- package/dist/sdk/lifecycle/mutation-option-validation.js +2 -0
- 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/release-handoff.d.ts +12 -0
- package/dist/sdk/lifecycle/release-handoff.js +2 -0
- 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/structured-mutation-plan.d.ts +33 -0
- package/dist/sdk/lifecycle/structured-mutation-plan.js +2 -0
- package/dist/sdk/lifecycle/task-composition.d.ts +9 -9
- package/dist/sdk/lifecycle/task-composition.js +1 -1
- package/dist/sdk/lifecycle/update-many.d.ts +61 -61
- package/dist/sdk/lifecycle/update.d.ts +113 -121
- package/dist/sdk/lifecycle/update.js +1 -1
- package/dist/sdk/lifecycle/workflow-transition.d.ts +13 -0
- package/dist/sdk/lifecycle/workflow-transition.js +2 -0
- package/dist/sdk/lifecycle-completion.d.ts +14 -14
- package/dist/sdk/lifecycle-policy.d.ts +42 -32
- package/dist/sdk/lifecycle-policy.js +1 -1
- 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-budget.js +1 -1
- 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-input.js +1 -1
- 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/runtime.js +1 -1
- 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 +64 -13
- package/dist/sdk/structured-mutations.js +1 -1
- 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-transaction.js +2 -2
- package/dist/sdk/workspace.d.ts +9 -9
- package/dist/types.d.ts +540 -540
- package/docs/AGENT_GUIDE.md +33 -4
- package/docs/CLOSE_EVIDENCE_RECOVERY.md +16 -7
- package/docs/COMMANDS.md +96 -12
- package/docs/ECOSYSTEM_PLANNING_REVIEW.md +5 -1
- package/docs/EXTENSIONS.md +1 -1
- package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
- package/docs/LINKED_TEST_EDITS.md +15 -0
- package/docs/RELEASING.md +2 -0
- package/docs/SDK.md +114 -2
- package/docs/TESTING.md +36 -1
- package/docs/generated/FLAG_LEXICON_BUDGETS.md +1 -1
- package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +17 -3
- package/marketplace.json +1 -1
- package/package.json +4 -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-LOSRTNNP.js +0 -2
- package/dist/cli-bundle/chunks/chunk-PP3BVMFL.js +0 -30
- package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
- package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
- package/dist/cli-bundle/chunks/register-mutation-TNRHNK4N.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-23ACMPGB.js +0 -2
- package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
- package/dist/cli-bundle/focused-chunks/chunk-LKWDWER4.js +0 -20
- package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
- package/docs/ecosystem-review-2026-09-28.json +0 -1
|
@@ -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;
|
|
@@ -1,147 +1,147 @@
|
|
|
1
|
-
import { type PmCommandCapabilityFamily,
|
|
1
|
+
import { type PmCommandCapabilityFamily,type PmCommandVisibilityTier,type PmMcpToolProfile } from "../agent-capability-contracts.js";
|
|
2
2
|
/** Namespaced MCP extension that opts a client into progressive tool discovery. */
|
|
3
3
|
export declare const PM_MCP_PROGRESSIVE_DISCOVERY_EXTENSION = "dev.unbrained.pm/progressive-tool-discovery";
|
|
4
4
|
/** Versioned server capability advertised for progressive tool discovery. */
|
|
5
|
-
export declare const PM_MCP_PROGRESSIVE_DISCOVERY_SERVER_CAPABILITY:
|
|
6
|
-
version:
|
|
7
|
-
discoveryTool:
|
|
8
|
-
canonicalResult:
|
|
9
|
-
compatibilityText:
|
|
5
|
+
export declare const PM_MCP_PROGRESSIVE_DISCOVERY_SERVER_CAPABILITY:Readonly<{
|
|
6
|
+
version:1;
|
|
7
|
+
discoveryTool:"pm_discover";
|
|
8
|
+
canonicalResult:"structuredContent.result";
|
|
9
|
+
compatibilityText:"pointer";
|
|
10
10
|
}>;
|
|
11
11
|
/** Small stable tool catalog returned to clients that negotiate the extension. */
|
|
12
|
-
export declare const PM_MCP_ENTRY_TOOL_NAMES:
|
|
12
|
+
export declare const PM_MCP_ENTRY_TOOL_NAMES:readonly string[];
|
|
13
13
|
/** Ranking signals composed by the public discovery contract. */
|
|
14
14
|
export type PmToolDiscoverySignalName = "lexical" | "semantic" | "graph" | "permission" | "freshness" | "usage";
|
|
15
15
|
/** Optional host-owned signals supplied for one tool. */
|
|
16
16
|
export interface PmToolDiscoverySignalInput {
|
|
17
17
|
/** Semantic relevance normalized to the inclusive range zero through one. */
|
|
18
|
-
semantic?:
|
|
18
|
+
semantic?:number;
|
|
19
19
|
/** Graph proximity normalized to the inclusive range zero through one. */
|
|
20
|
-
graph?:
|
|
20
|
+
graph?:number;
|
|
21
21
|
/** Definition freshness normalized to the inclusive range zero through one. */
|
|
22
|
-
freshness?:
|
|
22
|
+
freshness?:number;
|
|
23
23
|
/** Historical selection usefulness normalized to the inclusive range zero through one. */
|
|
24
|
-
usage?:
|
|
24
|
+
usage?:number;
|
|
25
25
|
}
|
|
26
26
|
/** One tool definition accepted by the SDK discovery engine. */
|
|
27
27
|
export interface PmToolDiscoveryCandidate {
|
|
28
28
|
/** Stable callable tool name. */
|
|
29
|
-
name:
|
|
29
|
+
name:string;
|
|
30
30
|
/** Agent-facing tool description. */
|
|
31
|
-
description:
|
|
31
|
+
description:string;
|
|
32
32
|
/** JSON Schema supplied when callers request schema expansion. */
|
|
33
|
-
inputSchema:
|
|
33
|
+
inputSchema:Record<string,unknown>;
|
|
34
34
|
/** Whether the current caller is authorized to invoke the tool. */
|
|
35
|
-
authorized?:
|
|
35
|
+
authorized?:boolean;
|
|
36
36
|
/** Optional host-owned ranking signals. */
|
|
37
|
-
signals?:
|
|
37
|
+
signals?:PmToolDiscoverySignalInput;
|
|
38
38
|
}
|
|
39
39
|
/** Options controlling one progressive discovery page. */
|
|
40
40
|
export interface PmToolDiscoveryOptions {
|
|
41
41
|
/** Free-text capability intent. Empty text lists by deterministic policy order. */
|
|
42
|
-
query?:
|
|
42
|
+
query?:string;
|
|
43
43
|
/** Restrict results to one stable capability family. */
|
|
44
|
-
family?:
|
|
44
|
+
family?:PmCommandCapabilityFamily;
|
|
45
45
|
/** Restrict results to tools visible at or below this tier. */
|
|
46
|
-
tier?:
|
|
46
|
+
tier?:Exclude<PmCommandVisibilityTier,"internal">;
|
|
47
47
|
/** Maximum result rows, from one through one hundred. */
|
|
48
|
-
limit?:
|
|
48
|
+
limit?:number;
|
|
49
49
|
/** Opaque continuation cursor from an equivalent discovery request. */
|
|
50
|
-
cursor?:
|
|
50
|
+
cursor?:string;
|
|
51
51
|
/** Include complete input schemas instead of the default compact projection. */
|
|
52
|
-
includeSchema?:
|
|
52
|
+
includeSchema?:boolean;
|
|
53
53
|
/** Estimated-token ceiling, or unbounded for the complete selected page. */
|
|
54
|
-
outputBudget?:
|
|
54
|
+
outputBudget?:number | "unbounded";
|
|
55
55
|
/** MCP profile that produced the authorized candidate catalog. */
|
|
56
|
-
profile?:
|
|
56
|
+
profile?:PmMcpToolProfile;
|
|
57
57
|
/** Host-owned HMAC key of at least 32 bytes for restart-stable cursors. */
|
|
58
|
-
cursorIntegrityKey?:
|
|
58
|
+
cursorIntegrityKey?:Uint8Array;
|
|
59
59
|
}
|
|
60
60
|
/** Applied score for one signal with explicit provenance. */
|
|
61
61
|
export interface PmToolDiscoveryAppliedSignal {
|
|
62
62
|
/** Normalized signal value. */
|
|
63
|
-
value:
|
|
63
|
+
value:number;
|
|
64
64
|
/** Public policy weight. */
|
|
65
|
-
weight:
|
|
65
|
+
weight:number;
|
|
66
66
|
/** Whether the signal was computed or supplied rather than defaulted. */
|
|
67
|
-
available:
|
|
67
|
+
available:boolean;
|
|
68
68
|
/** Transparent source of the normalized value. */
|
|
69
|
-
source:
|
|
69
|
+
source:"computed" | "host" | "authorization" | "unavailable";
|
|
70
70
|
}
|
|
71
71
|
/** One ranked discovery result. */
|
|
72
72
|
export interface PmToolDiscoveryResultRow {
|
|
73
73
|
/** Stable callable tool name. */
|
|
74
|
-
name:
|
|
74
|
+
name:string;
|
|
75
75
|
/** Agent-facing description. */
|
|
76
|
-
description:
|
|
76
|
+
description:string;
|
|
77
77
|
/** Canonical CLI command backing the tool. */
|
|
78
|
-
command:
|
|
78
|
+
command:string;
|
|
79
79
|
/** Minimum visibility tier inherited from the command contract. */
|
|
80
|
-
tier:
|
|
80
|
+
tier:PmCommandVisibilityTier;
|
|
81
81
|
/** Stable capability family inherited from the command contract. */
|
|
82
|
-
family:
|
|
82
|
+
family:PmCommandCapabilityFamily;
|
|
83
83
|
/** Weighted aggregate score used for ordering. */
|
|
84
|
-
score:
|
|
84
|
+
score:number;
|
|
85
85
|
/** Complete per-signal score explanation. */
|
|
86
|
-
signals:
|
|
86
|
+
signals:Readonly<Record<PmToolDiscoverySignalName,PmToolDiscoveryAppliedSignal>>;
|
|
87
87
|
/** Complete JSON Schema when explicitly requested. */
|
|
88
|
-
input_schema?:
|
|
88
|
+
input_schema?:Record<string,unknown>;
|
|
89
89
|
}
|
|
90
90
|
/** Explicit receipt for information omitted from a discovery page. */
|
|
91
91
|
export interface PmToolDiscoveryOmissionReceipt {
|
|
92
92
|
/** Whether any result rows or schemas were omitted. */
|
|
93
|
-
has_omissions:
|
|
93
|
+
has_omissions:boolean;
|
|
94
94
|
/** Stable omitted field groups. */
|
|
95
|
-
omitted:
|
|
96
|
-
name:
|
|
97
|
-
reason:
|
|
98
|
-
restore_with:
|
|
95
|
+
omitted:Array<{
|
|
96
|
+
name:"input_schema" | "tools";
|
|
97
|
+
reason:"compact_projection" | "limit" | "token_budget";
|
|
98
|
+
restore_with:string;
|
|
99
99
|
}>;
|
|
100
100
|
}
|
|
101
101
|
/** Deterministic progressive tool discovery response. */
|
|
102
102
|
export interface PmToolDiscoveryResult {
|
|
103
103
|
/** Stable result discriminator for model and host routing. */
|
|
104
|
-
result_type:
|
|
104
|
+
result_type:"pm_tool_discovery";
|
|
105
105
|
/** Public contract revision. */
|
|
106
|
-
contract_version:
|
|
106
|
+
contract_version:1;
|
|
107
107
|
/** Normalized query used by ranking and cursor binding. */
|
|
108
|
-
query:
|
|
108
|
+
query:string;
|
|
109
109
|
/** MCP profile that produced the candidate catalog. */
|
|
110
|
-
profile:
|
|
110
|
+
profile:PmMcpToolProfile;
|
|
111
111
|
/** Ranked page of authorized tools. */
|
|
112
|
-
tools:
|
|
112
|
+
tools:PmToolDiscoveryResultRow[];
|
|
113
113
|
/** Total authorized rows after filters and before pagination. */
|
|
114
|
-
total:
|
|
114
|
+
total:number;
|
|
115
115
|
/** Rows returned on this page. */
|
|
116
|
-
returned:
|
|
116
|
+
returned:number;
|
|
117
117
|
/** Whether a later ranked row remains. */
|
|
118
|
-
has_more:
|
|
118
|
+
has_more:boolean;
|
|
119
119
|
/** Opaque continuation cursor bound to query, filters, and catalog. */
|
|
120
|
-
next_cursor?:
|
|
120
|
+
next_cursor?:string;
|
|
121
121
|
/** Exact estimated serialized result cost. */
|
|
122
|
-
token_cost:
|
|
123
|
-
estimated_tokens:
|
|
124
|
-
budget:
|
|
125
|
-
within_budget:
|
|
122
|
+
token_cost:{
|
|
123
|
+
estimated_tokens:number;
|
|
124
|
+
budget:number | "unbounded";
|
|
125
|
+
within_budget:boolean;
|
|
126
126
|
};
|
|
127
127
|
/** Public ranking formula and weights. */
|
|
128
|
-
ranking_policy:
|
|
129
|
-
version:
|
|
130
|
-
formula:
|
|
131
|
-
weights:
|
|
128
|
+
ranking_policy:{
|
|
129
|
+
version:1;
|
|
130
|
+
formula:"weighted_sum_then_name";
|
|
131
|
+
weights:Readonly<Record<PmToolDiscoverySignalName,number>>;
|
|
132
132
|
};
|
|
133
133
|
/** Cache identity and invalidation contract for deterministic pages. */
|
|
134
|
-
cache:
|
|
135
|
-
key:
|
|
136
|
-
ttl_ms:
|
|
137
|
-
scope:
|
|
138
|
-
invalidates_on:
|
|
134
|
+
cache:{
|
|
135
|
+
key:string;
|
|
136
|
+
ttl_ms:number;
|
|
137
|
+
scope:"private";
|
|
138
|
+
invalidates_on:readonly string[];
|
|
139
139
|
};
|
|
140
140
|
/** Explicit recovery for compacted fields and rows. */
|
|
141
|
-
omission_receipt:
|
|
141
|
+
omission_receipt:PmToolDiscoveryOmissionReceipt;
|
|
142
142
|
}
|
|
143
143
|
/** Parse untrusted adapter input without discarding malformed discovery values. */
|
|
144
|
-
export declare function parsePmToolDiscoveryOptions(input:
|
|
144
|
+
export declare function parsePmToolDiscoveryOptions(input:Record<string,unknown>):PmToolDiscoveryOptions;
|
|
145
145
|
/**
|
|
146
146
|
* Rank and page an authorized MCP tool catalog under an explicit token budget.
|
|
147
147
|
*
|
|
@@ -149,4 +149,4 @@ export declare function parsePmToolDiscoveryOptions(input: Record<string, unknow
|
|
|
149
149
|
* catalog, or ranking inputs change. Host signals override documented local
|
|
150
150
|
* fallbacks without changing the public formula or hiding signal provenance.
|
|
151
151
|
*/
|
|
152
|
-
export declare function discoverPmTools(candidates:
|
|
152
|
+
export declare function discoverPmTools(candidates:readonly PmToolDiscoveryCandidate[],options?:PmToolDiscoveryOptions):PmToolDiscoveryResult;
|
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
import { type PmMcpImplementation,
|
|
1
|
+
import { type PmMcpImplementation,type PmMcpRequestContext } from "./protocol.js";
|
|
2
2
|
/** Methods permitted inside a 2026-07-28 MRTR input request map. */
|
|
3
|
-
export declare const PM_MCP_INPUT_REQUEST_METHODS:
|
|
3
|
+
export declare const PM_MCP_INPUT_REQUEST_METHODS:readonly ["elicitation/create","roots/list","sampling/createMessage"];
|
|
4
4
|
/** One typed request that a host must fulfill before retrying an operation. */
|
|
5
5
|
export interface PmMcpInputRequest {
|
|
6
6
|
/** Current MCP server-to-client request method. */
|
|
7
|
-
method:
|
|
7
|
+
method:(typeof PM_MCP_INPUT_REQUEST_METHODS)[number];
|
|
8
8
|
/** Method-specific parameters retained as an open protocol object. */
|
|
9
|
-
params:
|
|
9
|
+
params:Record<string,unknown>;
|
|
10
10
|
}
|
|
11
11
|
/** Server-assigned MRTR input identifiers mapped to bounded requests. */
|
|
12
|
-
export type PmMcpInputRequests = Record<string,
|
|
12
|
+
export type PmMcpInputRequests = Record<string,PmMcpInputRequest>;
|
|
13
13
|
/** Host responses keyed by the identifiers in an earlier input request map. */
|
|
14
|
-
export type PmMcpInputResponses = Record<string,
|
|
14
|
+
export type PmMcpInputResponses = Record<string,Record<string,unknown>>;
|
|
15
15
|
/** Modern interim result returned when an operation needs more host input. */
|
|
16
16
|
export interface PmMcpInputRequiredResult {
|
|
17
17
|
/** MRTR discriminator required by the current protocol. */
|
|
18
|
-
resultType:
|
|
18
|
+
resultType:"input_required";
|
|
19
19
|
/** Optional bounded requests the host must fulfill. */
|
|
20
|
-
inputRequests?:
|
|
20
|
+
inputRequests?:PmMcpInputRequests;
|
|
21
21
|
/** Optional integrity-protected state echoed unchanged on retry. */
|
|
22
|
-
requestState?:
|
|
22
|
+
requestState?:string;
|
|
23
23
|
/** Result-local MCP metadata. */
|
|
24
|
-
_meta:
|
|
24
|
+
_meta:{
|
|
25
25
|
/** Server identity repeated on every modern result. */
|
|
26
|
-
"io.modelcontextprotocol/serverInfo":
|
|
26
|
+
"io.modelcontextprotocol/serverInfo":PmMcpImplementation;
|
|
27
27
|
};
|
|
28
28
|
/** Additional forward-compatible result fields. */
|
|
29
|
-
[key:
|
|
29
|
+
[key:string]:unknown;
|
|
30
30
|
}
|
|
31
31
|
/**
|
|
32
32
|
* Transport-neutral control signal used by SDK handlers to request an MRTR
|
|
@@ -34,68 +34,68 @@ _meta: {
|
|
|
34
34
|
*/
|
|
35
35
|
export declare class PmMcpInputRequiredError extends Error {
|
|
36
36
|
/** Server-authored input requests validated by the adapter. */
|
|
37
|
-
readonly inputRequests?:
|
|
37
|
+
readonly inputRequests?:unknown;
|
|
38
38
|
/** Optional opaque continuation state echoed on retry. */
|
|
39
|
-
readonly requestState?:
|
|
39
|
+
readonly requestState?:string;
|
|
40
40
|
/** Create an input-required control signal. */
|
|
41
|
-
constructor(input:
|
|
42
|
-
inputRequests?:
|
|
43
|
-
requestState?:
|
|
41
|
+
constructor(input:{
|
|
42
|
+
inputRequests?:unknown;
|
|
43
|
+
requestState?:string;
|
|
44
44
|
});
|
|
45
45
|
}
|
|
46
46
|
/** Cache fields required on current list and read results. */
|
|
47
47
|
export interface PmMcpCachePolicy {
|
|
48
48
|
/** Milliseconds for which a client may consider the response fresh. */
|
|
49
|
-
ttlMs:
|
|
49
|
+
ttlMs:number;
|
|
50
50
|
/** Whether shared intermediaries may reuse the response. */
|
|
51
|
-
cacheScope:
|
|
51
|
+
cacheScope:"private" | "public";
|
|
52
52
|
/** Additional forward-compatible cache fields. */
|
|
53
|
-
[key:
|
|
53
|
+
[key:string]:unknown;
|
|
54
54
|
}
|
|
55
55
|
/** Work bounds applied while validating an advertised JSON Schema. */
|
|
56
56
|
export interface PmMcpJsonSchemaBounds {
|
|
57
57
|
/** Maximum serialized schema bytes. */
|
|
58
|
-
maxBytes?:
|
|
58
|
+
maxBytes?:number;
|
|
59
59
|
/** Maximum nested object or array depth. */
|
|
60
|
-
maxDepth?:
|
|
60
|
+
maxDepth?:number;
|
|
61
61
|
/** Maximum visited object, array, and scalar nodes. */
|
|
62
|
-
maxNodes?:
|
|
62
|
+
maxNodes?:number;
|
|
63
63
|
}
|
|
64
64
|
/** State sealed into an opaque MRTR requestState value. */
|
|
65
65
|
export interface PmMcpRequestStatePayload {
|
|
66
66
|
/** Absolute expiration timestamp in milliseconds. */
|
|
67
|
-
expiresAt:
|
|
67
|
+
expiresAt:number;
|
|
68
68
|
/** Original JSON-RPC method this state may resume. */
|
|
69
|
-
method:
|
|
69
|
+
method:string;
|
|
70
70
|
/** Digest of the original request's salient parameters. */
|
|
71
|
-
parameterDigest:
|
|
71
|
+
parameterDigest:string;
|
|
72
72
|
/** Principal binding chosen by the host or authorization layer. */
|
|
73
|
-
principal:
|
|
73
|
+
principal:string;
|
|
74
74
|
/** Application-owned continuation data. */
|
|
75
|
-
state:
|
|
75
|
+
state:unknown;
|
|
76
76
|
}
|
|
77
77
|
/** Validate and clone a server-authored MRTR request map. */
|
|
78
|
-
export declare function parseMcpInputRequests(value:
|
|
78
|
+
export declare function parseMcpInputRequests(value:unknown,requestContext:PmMcpRequestContext):PmMcpInputRequests;
|
|
79
79
|
/** Validate and clone client-supplied input responses from an MRTR retry. */
|
|
80
|
-
export declare function parseMcpInputResponses(value:
|
|
80
|
+
export declare function parseMcpInputResponses(value:unknown):PmMcpInputResponses;
|
|
81
81
|
/** Build a modern input-required result after validating capability and size bounds. */
|
|
82
|
-
export declare function buildMcpInputRequiredResult(input:
|
|
83
|
-
requestContext:
|
|
84
|
-
serverInfo:
|
|
85
|
-
inputRequests?:
|
|
86
|
-
requestState?:
|
|
87
|
-
}):
|
|
82
|
+
export declare function buildMcpInputRequiredResult(input:{
|
|
83
|
+
requestContext:PmMcpRequestContext;
|
|
84
|
+
serverInfo:PmMcpImplementation;
|
|
85
|
+
inputRequests?:unknown;
|
|
86
|
+
requestState?:string;
|
|
87
|
+
}):PmMcpInputRequiredResult;
|
|
88
88
|
/** Seal integrity-protected continuation state for an MRTR retry. */
|
|
89
|
-
export declare function sealMcpRequestState(payload:
|
|
89
|
+
export declare function sealMcpRequestState(payload:PmMcpRequestStatePayload,secret:string | Uint8Array):string;
|
|
90
90
|
/** Verify an MRTR requestState value against method, principal, digest, and expiry. */
|
|
91
|
-
export declare function openMcpRequestState(value:
|
|
92
|
-
method:
|
|
93
|
-
parameterDigest:
|
|
94
|
-
principal:
|
|
95
|
-
nowMs?:
|
|
96
|
-
}):
|
|
91
|
+
export declare function openMcpRequestState(value:string,secret:string | Uint8Array,expected:{
|
|
92
|
+
method:string;
|
|
93
|
+
parameterDigest:string;
|
|
94
|
+
principal:string;
|
|
95
|
+
nowMs?:number;
|
|
96
|
+
}):PmMcpRequestStatePayload;
|
|
97
97
|
/** Compute a stable-sized digest for application-selected salient request data. */
|
|
98
|
-
export declare function digestMcpRequestParameters(value:
|
|
98
|
+
export declare function digestMcpRequestParameters(value:unknown):string;
|
|
99
99
|
/**
|
|
100
100
|
* Bound single-use MRTR state consumption within one server process. Callers
|
|
101
101
|
* requiring cross-process one-time semantics should persist the resulting hash.
|
|
@@ -103,16 +103,16 @@ export declare function digestMcpRequestParameters(value: unknown): string;
|
|
|
103
103
|
export declare class PmMcpRequestStateReplayGuard {
|
|
104
104
|
#private;
|
|
105
105
|
/** Create a bounded in-process replay guard. */
|
|
106
|
-
constructor(maximumEntries?:
|
|
106
|
+
constructor(maximumEntries?:number);
|
|
107
107
|
/** Consume one opaque requestState value exactly once in this process. */
|
|
108
|
-
consume(value:
|
|
108
|
+
consume(value:string):void;
|
|
109
109
|
}
|
|
110
110
|
/** Validate and clone a required MCP cache policy. */
|
|
111
|
-
export declare function parseMcpCachePolicy(value:
|
|
111
|
+
export declare function parseMcpCachePolicy(value:PmMcpCachePolicy):PmMcpCachePolicy;
|
|
112
112
|
/** Attach required cache fields without mutating a method-specific payload. */
|
|
113
|
-
export declare function withMcpCachePolicy<Payload extends Record<string,
|
|
113
|
+
export declare function withMcpCachePolicy<Payload extends Record<string,unknown>>(payload:Payload,policy:PmMcpCachePolicy):Payload & PmMcpCachePolicy;
|
|
114
114
|
/**
|
|
115
115
|
* Validate JSON Schema 2020-12 structure under explicit byte, depth, node, and
|
|
116
116
|
* local-reference work bounds while allowing the complete keyword vocabulary.
|
|
117
117
|
*/
|
|
118
|
-
export declare function validateMcpJsonSchema(schema:
|
|
118
|
+
export declare function validateMcpJsonSchema(schema:unknown,bounds?:PmMcpJsonSchemaBounds):unknown;
|