Package support policy#
Pulse 1.0.0-beta.1 publishes one synchronized 18-package release set. Publication does not make every package an application-author SDK: the support tier and listed entry points define the release promise.
| Package | Support tier | Install directly | Release promise |
|---|---|---|---|
@pulse-compute/runtime | Canonical application surface | Yes | Supported application authoring and execution contract. |
@pulse-compute/pulse | Canonical application surface | Yes | Supported conventional application, project-configuration, and schema-authoring contract. |
@pulse-compute/cli | Canonical application surface | Yes | Supported Beta workflow and project-configuration contract. |
@pulse-compute/provider-fastly | Supported provider/extension surface | Yes | The listed entry points are supported for the Beta; all other exported subpaths are implementation-only. |
@pulse-compute/grip | Supported provider/extension surface | Yes | The package root has bounded JavaScript and Native HTTP-framing realization plus configured Node/Fastly broadcast; /pulsewasm remains compatibility-only. |
@pulse-compute/assets | Supported provider/extension surface | Yes | The package root is the supported JavaScript API and canonical Native authoring surface; /pulsewasm remains a compatibility subpath, while manifest/compiler subpaths are toolchain integration. |
@pulse-compute/crypto | Supported provider/extension surface | Yes | The package root is the supported bounded verification contract; realization and Native integration subpaths remain toolchain-only. |
@pulse-compute/jwt | Supported provider/extension surface | Yes | The package root is the supported provider-neutral verification contract; provider and compiler integration subpaths are not application APIs. |
@pulse-compute/entities | Supported provider/extension surface | Yes | The package root and first-party JSON-RPC adapter are supported Beta contracts; compiler integration subpaths remain toolchain-only. |
@pulse-compute/wasm-build-support | Implementation/transitive surface | No | Internal release-set interface; exported modules may change with compiler implementation needs. |
@pulse-compute/wasm-compiler | Implementation/transitive surface | No | Internal compiler interface; no application-author compatibility guarantee. |
@pulse-compute/wasm-guest-link | Implementation/transitive surface | No | Internal first-party prebuilt guest-link interface synchronized with the compiler; no application-author or third-party guest compatibility guarantee. |
@pulse-compute/wasm-contracts | Implementation/transitive surface | No | The provider toolchain contract is versioned and supported for the Beta; other protocol and proof interfaces remain internal. |
@pulse-compute/wasm-host-runtime | Implementation/transitive surface | No | Internal compiler/runtime interface synchronized with this release set. |
@pulse-compute/wasm-library-kit | Implementation/transitive surface | No | Internal package-lowering interface synchronized with this release set. |
@pulse-compute/provider-node | Implementation/transitive surface | No | The listed built-in toolchain entry is synchronized with the Beta bootstrap contract; other canonical Node provider interfaces remain internal. |
@pulse-compute/wasm-runtime-core-as | Implementation/transitive surface | No | Internal code-generation interface synchronized with this release set. |
@pulse-compute/wasm-schema-json | Implementation/transitive surface | No | Internal schema compiler interface synchronized with this release set. |
Tier definitions#
Canonical application surface#
Fully documented and supported as the Pulse application authoring or workflow contract.
Supported provider/extension surface#
Documented entry points are supported; implementation and toolchain subpaths are explicitly excluded.
Implementation/transitive surface#
Installable as part of the synchronized release set, without an application-author compatibility guarantee.
Reading package READMEs#
Every packed README begins with a generated status block covering audience, direct-install guidance, supported entry points, and stability. An export that is not listed in that block is not automatically a supported application-author entry point.
Extension and provider boundary in 1.0.0-beta.1#
Pulse supports the documented package-owned assets and GRIP facades and the documented Fastly provider entry points. Their implementation demonstrates the internal contract, but 1.0.0-beta.1 does not expose a general third-party plugin registry:
- lowerer manifests are accepted only from trusted first-party release packages;
- arbitrary external lowerer discovery and execution are not supported;
- provider selection is limited to
node,fastly, and compile-onlynone; - adding a new lowerer or provider currently means changing and testing the synchronized Pulse release set.
Documentation may explain lowering and the internal contract, but it must not promise that an external npm package can self-register a lowerer or provider. A future public plugin API requires an explicit trust model, discovery, version negotiation, security policy, and compatibility contract.
Installed documentation#
@pulse-compute/runtime ships its canonical API reference and Beta scope. @pulse-compute/cli ships the public documentation hierarchy, CLI/config/diagnostic references, bounded compatibility material, and runnable example sources. Package README links must resolve either inside their own tarball or to an exact-version hosted Pulse documentation URL.