Diagnostics and remediation#
Pulse 1.0.0-beta.1 treats the 114 codes on this page as the stable public CLI diagnostic catalog. Code, category, summary, remediation intent, exit class, and anchor are generated from the same source used by the CLI. Human wording may improve compatibly.
Every catalogued failure links to a versioned installed artifact under:
https://pulsecompute.io/v1.0.0-beta.1/reference/diagnostics/
Uncatalogued/internal or forward-compatible codes link to that reference root instead of inventing a nonexistent anchor. Internal PULSEWASM_* proof/compiler tokens are not part of this public catalog.
Source-form eligibility, trusted awaits, ctx.parallel static shape, Router terminal transfer, and body ownership are centralized in Managed handler TypeScript and JavaScript. Four-mode target claims are centralized in Provider and target compatibility. A Native eligibility diagnostic never authorizes automatic JavaScript fallback.
JSON failure envelope#
{
"status": "error",
"version": "1.0.0-beta.1",
"error": {
"name": "PulseProjectError",
"code": "PULSE_BUILD_OUT_UNSAFE",
"title": "Build Out Unsafe",
"summary": "The resolved build output can escape or alias outside the project root.",
"category": "safety",
"message": "Pulse build output must be a child directory of the project root.",
"remediation": [
"Choose an output directory that is a real child of the project root."
],
"stability": "preview-stable",
"scope": "public",
"docs": "https://pulsecompute.io/v1.0.0-beta.1/reference/diagnostics/#pulse-build-out-unsafe"
}
}
Configured secret values are redacted before diagnostics are serialized.
Fastly local execution boundary#
Pulse executes generated bin/main.wasm through an inspected local Compute launcher. PULSE_FASTLY_BIN selects CLI-owned fastly compute serve --file; PULSE_VICEROY_BIN selects direct viceroy serve when no explicit Fastly CLI launcher is selected. External Fastly execution remains an explicit environment-dependent gate.
Exit codes#
| Exit | Meaning |
|---|---|
0 | Command completed successfully. |
1 | Completed doctor/test failure where documented, or uncatalogued internal failure. |
2 | Usage, project configuration, provider selection, or output-safety error. |
3 | Canonical/schema/package-lowering/provider-binding failure. |
4 | Request, test, runtime, fetch, or continuation failure. |
5 | External toolchain or Fastly local-execution failure. |
Development HTTP responses#
When a diagnostic is converted into a response by pulse dev, an explicitly catalogued HTTP status takes precedence. Catalogued codes without an explicit HTTP mapping use 500 as a fail-closed development-server fallback. CLI exit codes remain independent from HTTP status.
| HTTP status | Explicitly mapped public diagnostics |
|---|---|
400 | PULSE_SCHEMA_JSON_MALFORMED, PULSE_BODY_DECODE, PULSE_SCHEMA_DECODE, PULSE_OPAQUE_BODY_INSPECTION, PULSE_FETCH_URL_INVALID |
413 | PULSE_BODY_TOO_LARGE, PULSE_REQUEST_BODY_TOO_LARGE |
415 | PULSE_SCHEMA_CONTENT_TYPE |
500 | PULSE_SCHEMA_ID_INVALID, PULSE_SCHEMA_REQUIRED, PULSE_SCHEMA_REFERENCE, PULSE_SCHEMA_CODECS_UNAVAILABLE, PULSE_RESPONSE_CASE_REFERENCE, PULSE_RESPONSE_DESCRIPTOR_INVALID, PULSE_FETCH_SCHEMA_WITHOUT_JSON, PULSE_BODY_UNAVAILABLE, PULSE_RESPONSE_ENCODE, PULSE_SCHEMA_ENCODE, PULSE_CONTINUATION_DOUBLE_RESUME |
501 | PULSE_PROVIDER_CAPABILITY_MISSING, PULSE_PROVIDER_CAPABILITY_UNSUPPORTED, PULSE_EVENT_TARGET_UNSUPPORTED, PULSE_FASTLY_EVENT_INGRESS_UNSUPPORTED, PULSE_FASTLY_EVENT_EMIT_UNSUPPORTED |
502 | PULSE_FETCH_NETWORK |
504 | PULSE_FETCH_TIMEOUT, PULSE_CONTINUATION_EXPIRED, PULSE_FASTLY_REQUEST_TIMEOUT |
Executable schema failure example#
The documented schema project includes an intentionally invalid case:
pulse test examples/02-request-schema --case invalid-user --json
{
"status": "passed",
"cases": [
{
"name": "invalid-user",
"status": "passed",
"expectedError": {
"code": "PULSE_SCHEMA_DECODE",
"category": "request",
"docs": "https://pulsecompute.io/v1.0.0-beta.1/reference/diagnostics/#pulse-schema-decode"
}
}
]
}
Complete public catalog#
Usage diagnostics#
PULSE_COMMAND_UNKNOWN — Command Unknown#
The requested pulse command is not part of the supported CLI.
- Category:
usage - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI reference
Remediation
- Run
pulse --helpand choose one of the documented commands.
PULSE_ARGUMENT_MISSING — Argument Missing#
A command-line option that requires a value was supplied without one.
- Category:
usage - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI reference
Remediation
- Provide the missing flag value and rerun the command.
- Run
pulse --helpfor the command signature.
PULSE_ARGUMENT_UNEXPECTED — Argument Unexpected#
The command received an option or positional argument it does not accept.
- Category:
usage - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI reference
Remediation
- Remove the unsupported argument or use the documented flag.
- Run
pulse --helpfor the command signature.
PULSE_PROVIDER_FLAG_REMOVED — Provider Flag Removed#
Provider selection is project configuration, not a command-line override.
- Category:
usage - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI reference
Remediation
- Select
hostandtargetin a.pulse/config.tsprofile. - Use
pulse compilefor provider-neutral Wasm orpulse buildfor the configured deployment target.
PULSE_SOURCE_ONLY_REMOVED — Source Only Removed#
The former source-only JavaScript packaging mode is no longer part of native builds.
- Category:
usage - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI reference
Remediation
- Run
pulse build; native builds emit generated source and provider Wasm together.
Project diagnostics#
PULSE_CONFIG_NOT_FOUND — Config Not Found#
Project discovery did not find an explicit Pulse configuration file.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Run
pulse initto create.pulse/config.ts. - Ensure the command runs inside the intended project directory.
PULSE_PROFILE_SELECTION_REQUIRED — Profile Selection Required#
No project profile was selected by CLI, environment, or default configuration.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Pass
--profile, setPULSE_PROFILE, or configurepulse.defaultProfile.
PULSE_PROFILE_UNKNOWN — Profile Unknown#
The selected profile is absent from the project declaration.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Select one of the profiles declared next to the reserved
pulseobject.
PULSE_CONFIG_PLAN_PARITY_FAILED — Config Plan Parity Failed#
Static and runtime configuration normalization produced different canonical plans.
- Category:
project - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Keep the config factory within the sealed static grammar and report the divergent plan hashes.
PULSE_JAVASCRIPT_APPLICATION_PLAN_INVALID — Javascript Application Plan Invalid#
The JavaScript loader received a value outside the normalized application-plan contract.
- Category:
project - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Rebuild the JavaScript application plan from the configured entry and sealed reachable graph.
PULSE_JAVASCRIPT_APPLICATION_ENTRY_INVALID — Javascript Application Entry Invalid#
The JavaScript plan entry is not a project-owned application module.
- Category:
project - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Default-export a Router, Pulse application, or managed handler from a project-owned entry module.
PULSE_JAVASCRIPT_APPLICATION_EXPORT_INVALID — Javascript Application Export Invalid#
The JavaScript entry does not export a managed Pulse application.
- Category:
project - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Default-export a Router, Pulse application, or managed handler.
PULSE_JAVASCRIPT_MODULE_NOT_FOUND — Javascript Module Not Found#
A graph-owned project module is absent at JavaScript load time.
- Category:
project - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Restore the graph-owned project module or rebuild the plan after the source change.
PULSE_RUNTIME_APPLICATION_EXPORT_INVALID — Runtime Application Export Invalid#
The application value is not a Router, Pulse application, or managed handler.
- Category:
project - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Default-export a Router, Pulse application, or managed handler.
PULSE_CONFIG_LOAD_FAILED — Config Load Failed#
The selected project configuration threw or failed while being loaded.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Fix the config import or runtime error.
- Use
pulse doctor --jsonto inspect the underlying cause.
PULSE_ENTRY_NOT_FOUND — Entry Not Found#
The configured canonical handler entry file does not exist.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Create the configured entry file or correct
pulse.entryin.pulse/config.ts.
PULSE_PROJECT_ROOT_MISSING — Project Root Missing#
The selected project directory does not exist.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Create or correct the positional project directory.
PULSE_INIT_NOT_EMPTY — Init Not Empty#
Project initialization would write into a non-empty directory without explicit force.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Choose an empty directory or pass
--forceonly when overwriting is intentional.
PULSE_INIT_FILE_EXISTS — Init File Exists#
Project initialization would replace an existing file that is not safe to overwrite.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Remove the conflicting file or choose another target directory.
PULSE_CONFIG_IMPLICIT — Config Implicit#
A command is relying on an implicit project shape instead of an explicit configuration.
- Category:
project - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project configuration
Remediation
- Run
pulse initor create.pulse/config.tsto make workspace ownership explicit.
Test diagnostics#
PULSE_TEST_HARNESS_NOT_FOUND — Test Harness Not Found#
The configured workspace-relative test harness does not exist.
- Category:
test - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI test behavior
Remediation
- Create the workspace-relative file configured by
pulse.tests.
PULSE_TEST_HARNESS_EXPORT_INVALID — Test Harness Export Invalid#
The configured harness does not export the required ordered case collection.
- Category:
test - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI test behavior
Remediation
- Export an ordered case array or an object containing a
casesarray.
PULSE_TEST_EXPECT_INVALID — Test Expect Invalid#
A project test case uses an invalid expectation shape for its HTTP or event discriminant.
- Category:
test - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI test behavior
Remediation
- Use the documented expectation shape for the selected HTTP or event case.
- Event emitted-frame expectations must be ordered arrays of canonical frames.
PULSE_TEST_EVENT_INVALID — Test Event Invalid#
A discriminated event test case is missing or violates the canonical bounded event-frame shape.
- Category:
test - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI test behavior
Remediation
- Use a discriminated
kind: "event"case with one bounded type, schema or schemaId, and schema-dependent payload. - Inspect the event catalog with
pulse inspect --json.
Capability diagnostics#
PULSE_TARGET_IMPLEMENTATION_PENDING — Target Implementation Pending#
The selected execution target is explicit but not implemented for this command.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Select a native profile for build, test, or dev.
- Use inspect or doctor to retain the JavaScript selection without fallback.
PULSE_JAVASCRIPT_APPLICATION_UNAVAILABLE — Javascript Application Unavailable#
The selected JavaScript application has one or more explicit target blockers.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Inspect the application-plan blockers and select only explicitly realized package and provider capabilities.
- Pulse will not fall back to native or another target automatically.
PULSE_JAVASCRIPT_PACKAGE_REALIZATION_UNAVAILABLE — Javascript Package Realization Unavailable#
A reachable Pulse-aware package has no JavaScript realization for the selected target.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Use a package with an explicit JavaScript realization or select a native target.
- Inspect package target support with
pulse inspect --json.
PULSE_PACKAGE_JAVASCRIPT_REALIZATION_NOT_IMPLEMENTED — Package Javascript Realization Not Implemented#
A reachable Pulse-aware package explicitly declares that its JavaScript realization is not implemented.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Select the native target for this package or wait for its declared JavaScript realization.
- No automatic fallback occurs.
PULSE_JAVASCRIPT_PACKAGE_ESM_UNSUPPORTED — Javascript Package Esm Unsupported#
The current graph-backed Node loader cannot require the selected ESM-only package entry.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Use a CommonJS-compatible package entry for the current Node loader or defer the package to a later JavaScript bundling contract.
PULSE_JAVASCRIPT_PACKAGE_MODULE_UNAVAILABLE — Javascript Package Module Unavailable#
The graph-selected JavaScript package module cannot be loaded from the application workspace.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Install the exact package selected by the reachable graph in the application workspace.
PULSE_JAVASCRIPT_EXTERNAL_MODULE_UNAVAILABLE — Javascript External Module Unavailable#
A declared external module is unavailable to the JavaScript application loader.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Install or explicitly declare the external module required by the JavaScript target.
PULSE_EXPERIMENTAL_NATIVE_SIZE_UNSUPPORTED — Experimental Native Size Unsupported#
The experimental Native size optimizer cannot be used for a JavaScript build target.
- Category:
capability - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Select a profile with
target: "native"or usepulse compile. - Remove
--experimental-native-sizefor JavaScript build output.
PULSE_PROVIDER_COMPILE_ONLY — Provider Compile Only#
The none provider cannot execute development-server or project-test behavior.
- Category:
capability - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Select an executable provider before running
pulse devorpulse test.
PULSE_TEST_PROVIDER_REQUIRED — Test Provider Required#
Project tests require an executable provider.
- Category:
capability - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Select an executable provider for
pulse test.
PULSE_DEV_PROVIDER_UNSUPPORTED — Dev Provider Unsupported#
The development server requires an executable provider.
- Category:
capability - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Select an executable provider for
pulse dev.
PULSE_PROVIDER_CAPABILITY_MISSING — Provider Capability Missing#
The selected provider lacks a binding required by the compiled application.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
501 - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Configure the required provider binding or select a provider that implements the capability.
- Run
pulse inspect --jsonto view required capabilities and bindings.
PULSE_PROVIDER_CAPABILITY_UNSUPPORTED — Provider Capability Unsupported#
The selected provider cannot realize a capability required by the application.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
501 - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Remove the unsupported capability or select a compatible provider.
PULSE_EVENT_TARGET_UNSUPPORTED — Event Target Unsupported#
The selected provider target cannot realize or test the reachable event plane.
- Category:
capability - CLI exit class:
3 - Development HTTP status:
501 - Stability/scope:
preview-stable/public - Related reference: Provider restrictions
Remediation
- Select a target whose descriptor and provider event driver satisfy every reachable event requirement.
- Use
pulse inspect --jsonto review event target support; Pulse will not select another target automatically.
Compile diagnostics#
PULSE_JAVASCRIPT_APPLICATION_GRAPH_FAILED — Javascript Application Graph Failed#
The sealed reachable graph could not be built for JavaScript application loading.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Fix the first reachable-graph diagnostic before loading the JavaScript application.
PULSE_JAVASCRIPT_IMPORT_NOT_IN_GRAPH — Javascript Import Not In Graph#
Runtime evaluation requested an import absent from the sealed reachable graph.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Keep runtime imports within the sealed reachable graph and avoid evaluation-time dynamic loading.
PULSE_JAVASCRIPT_MODULE_COMPILE_FAILED — Javascript Module Compile Failed#
A graph-owned TypeScript or JavaScript module could not be transpiled for the Node loader.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Fix the TypeScript or JavaScript syntax in the graph-owned project module.
PULSE_HANDLER_ASYNC_REQUIRED — Handler Async Required#
A managed handler in a conventional Pulse project is missing its required async wrapper.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Declare every managed handler, middleware function, and error handler with
async. - Native lowering erases the wrapper; no Promise runtime or Asyncify support is added.
PULSE_PROJECT_COMPILE_FAILED — Project Compile Failed#
Whole-project compilation failed and contains one or more nested diagnostics.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Read the nested diagnostics and fix the first reported source or schema error.
- Run
pulse inspect --jsonorpulse doctor --jsonfor structured diagnostics.
PULSE_CANONICAL_COMPILE_FAILED — Canonical Compile Failed#
The handler uses a source form outside the canonical Beta authoring subset.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Rewrite the handler using the documented canonical API subset.
- Run
pulse inspect --jsonto see unsupported source forms.
PULSE_CANONICAL_NATIVE_PLAN_FAILED — Canonical Native Plan Failed#
The canonical handler could not be represented by the provider-neutral native execution-plan contract.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Inspect the native-plan diagnostics and rewrite unsupported canonical control flow.
- Run
pulse inspect --jsonto view the provider-neutral plan boundary.
PULSE_CANONICAL_NATIVE_AS_GENERATION_FAILED — Canonical Native As Generation Failed#
The validated native plan could not be rendered into the bounded AssemblyScript state-machine source.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Inspect the generated-native diagnostic and rewrite unsupported canonical expressions.
- Retain the plan hash and diagnostic detail when reporting a compiler defect.
PULSE_PACKAGE_LOWERING_FAILED — Package Lowering Failed#
A package-owned API call could not be lowered into its canonical effect contract.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Fix the package-owned API call shape reported in the nested diagnostic.
- Keep package effects in the documented static positions.
PULSE_NATIVE_IMPORT_UNSUPPORTED — Native Import Unsupported#
A reachable runtime import has no trusted Pulse native contract.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Remove or isolate the runtime dependency, use a trusted Pulse capability, or select an explicit JavaScript target when available.
- Pulse will not change targets automatically.
PULSE_PACKAGE_SUBPATH_UNSUPPORTED — Package Subpath Unsupported#
A Pulse-aware package was imported through a subpath that is not native-lowerable.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Import the package through its documented Pulse lowerable facade, or keep the package behind a JavaScript-only boundary.
- Run
pulse inspect --jsonto review package ownership and native eligibility.
PULSE_PACKAGE_REEXPORT_LOWERING_DEFERRED — Package Reexport Lowering Deferred#
A package-owned helper is graph-owned but reaches application code through a project re-export whose lowering remains deferred.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Import the package-owned facade directly until helper/re-export lowering is enabled by the package contract.
- The graph records the owning package; no fallback occurs.
PULSE_APPLICATION_ENTRY_LIFECYCLE_SIDE_EFFECT — Application Entry Lifecycle Side Effect#
The configured application entry graph starts a known provider lifecycle during module evaluation.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Keep the configured application entry import-safe and move provider lifecycle startup to a separate runner.
- Use the provider lifecycle through CLI delegation rather than starting infrastructure during application import.
PULSE_PACKAGE_BINDING_OWNERSHIP_AMBIGUOUS — Package Binding Ownership Ambiguous#
A project binding or re-export resolves to more than one package-owned symbol.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Remove the ambiguous re-export or give each package-owned helper one unambiguous source owner.
PULSE_PACKAGE_CONTRACT_NOT_RECOGNIZED — Package Contract Not Recognized#
The graph selected a trusted package contract that the package recognizer did not recover from its owning source module.
- Category:
compile - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Verify the trusted package manifest and direct facade import, then retain the graph and package diagnostics when reporting the issue.
Internal diagnostics#
PULSE_JAVASCRIPT_PACKAGE_PLAN_MISSING — Javascript Package Plan Missing#
The graph selected a package module that is absent from the JavaScript application plan.
- Category:
internal - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Rebuild the JavaScript plan and retain the graph and plan hashes when reporting the inconsistency.
PULSE_JAVASCRIPT_GRAPH_EDGE_AMBIGUOUS — Javascript Graph Edge Ambiguous#
The sealed JavaScript graph contains more than one runtime edge for the same import.
- Category:
internal - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Retain the graph manifest and report the duplicate runtime edge.
PULSE_JAVASCRIPT_GRAPH_MODULE_MISSING — Javascript Graph Module Missing#
A JavaScript graph edge or entry references a missing graph module.
- Category:
internal - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Rebuild the JavaScript plan from the exact source tree and retain the graph manifest.
PULSE_JAVASCRIPT_MODULE_KIND_UNSUPPORTED — Javascript Module Kind Unsupported#
The JavaScript loader encountered a module kind outside its sealed contract.
- Category:
internal - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Retain the application plan and report the unsupported module kind.
Safety diagnostics#
PULSE_JAVASCRIPT_MODULE_OUTSIDE_WORKSPACE — Javascript Module Outside Workspace#
A graph-owned project module escapes the authoritative workspace.
- Category:
safety - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI build behavior
Remediation
- Keep every graph-owned project module inside the authoritative Pulse workspace.
PULSE_JAVASCRIPT_MODULE_SOURCE_CHANGED — Javascript Module Source Changed#
A graph-owned project module changed after the JavaScript plan was created.
- Category:
safety - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI build behavior
Remediation
- Rebuild the JavaScript application plan after changing a project module.
PULSE_BUILD_OUT_UNSAFE — Build Out Unsafe#
The resolved build output can escape or alias outside the project root.
- Category:
safety - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI build behavior
Remediation
- Choose an output directory that is a real child of the project root.
- Do not use
.., external absolute paths, or symbolic-link traversal.
Provider diagnostics#
PULSE_PROVIDER_UNSUPPORTED — Provider Unsupported#
The selected provider value is not a supported shorthand or package selection.
- Category:
provider - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Select a bare provider id or an exact installed scoped provider package name.
PULSE_PROVIDER_PACKAGE_NOT_FOUND — Provider Package Not Found#
The exact configured provider package does not expose a resolvable toolchain entry.
- Category:
provider - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Install the exact configured provider package in the project.
- Confirm that its package manifest exports
./toolchain.
PULSE_PROVIDER_TOOLCHAIN_LOAD_FAILED — Provider Toolchain Load Failed#
The selected provider package toolchain failed while loading.
- Category:
provider - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Inspect the selected provider package and its dependency installation.
- Treat provider toolchains as trusted project build code.
PULSE_PROVIDER_TOOLCHAIN_INVALID — Provider Toolchain Invalid#
The selected provider package does not satisfy the versioned toolchain contract.
- Category:
provider - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Use a provider package implementing
pulse.provider-toolchain.v1at./toolchain. - Confirm the declared package name, provider id, and driver shape.
PULSE_BUILD_PROVIDER_REQUIRED — Build Provider Required#
pulse build requires a configured deployment provider; provider-neutral output belongs to pulse compile.
- Category:
provider - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Select an executable host in the active
.pulse/config.tsprofile. - Use
pulse compilewhen only provider-neutral Wasm is required.
PULSE_FASTLY_EVENT_INGRESS_UNSUPPORTED — Fastly Event Ingress Unsupported#
Fastly does not expose the host-neutral event ingress required by the application.
- Category:
provider - CLI exit class:
3 - Development HTTP status:
501 - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Select Node JavaScript or Node Native for event execution, or use
nonefor compile-only inspection. - Do not map event ingress through HTTP or GRIP.
PULSE_FASTLY_EVENT_EMIT_UNSUPPORTED — Fastly Event Emit Unsupported#
Fastly does not expose the host-neutral event acceptance operation required by the application.
- Category:
provider - CLI exit class:
3 - Development HTTP status:
501 - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Remove the reachable event.emit requirement or select Node JavaScript or Node Native.
- Pulse will not substitute logging, HTTP, GRIP, or another target.
PULSE_FASTLY_BACKEND_REQUIRED — Fastly Backend Required#
A static Fastly outbound origin has no configured backend and dynamic backends are disabled.
- Category:
provider - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Declare a static Fastly backend binding for the requested origin, or explicitly enable dynamic backends.
PULSE_FASTLY_BACKEND_BINDINGS_INVALID — Fastly Backend Bindings Invalid#
The Fastly backend binding map is not a valid string-to-string mapping.
- Category:
provider - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Correct the Fastly
backendsmap in the active.pulse/config.tsprofile.
PULSE_FASTLY_KV_BINDINGS_INVALID — Fastly KV Bindings Invalid#
The Fastly KV binding map is not a valid string-to-string mapping.
- Category:
provider - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Correct the Fastly
kvbinding map in the active.pulse/config.tsprofile.
PULSE_FASTLY_GRIP_FANOUT_BACKEND_REQUIRED — Fastly GRIP Fanout Backend Required#
A GRIP hold operation requires a configured Fastly Fanout backend.
- Category:
provider - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Configure the Fastly Fanout backend required by
grip.hold.
PULSE_FASTLY_GRIP_PUBLISH_BINDING_REQUIRED — Fastly GRIP Publish Binding Required#
A GRIP publish operation requires configured Fastly publish URL and backend bindings.
- Category:
provider - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Fastly provider configuration
Remediation
- Configure the Fastly GRIP publish backend and URL binding.
Toolchain diagnostics#
PULSE_NODE_VERSION_UNSUPPORTED — Node Version Unsupported#
The active Node.js version is outside the supported release range.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Use a Node.js version matching
^22.14.0 || ^24.0.0and rerunpulse doctor.
PULSE_FETCH_IMPLEMENTATION_UNAVAILABLE — Fetch Implementation Unavailable#
No supported local fetch implementation is available for the requested operation.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Use a Node.js version matching
^22.14.0 || ^24.0.0, or disable live network fetch and configure deterministic fetch fixtures.
PULSE_CANONICAL_NATIVE_COMPILE_FAILED — Canonical Native Compile Failed#
The provider-neutral native plan could not be compiled into Pulse-owned WebAssembly.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Restore the lockfile-pinned AssemblyScript dependency and rerun
pulse doctor. - Retain the generated diagnostic detail if AssemblyScript rejects valid Pulse output.
PULSE_FASTLY_CLI_UNAVAILABLE — Fastly CLI Unavailable#
The Fastly executable required for local target execution is unavailable.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Install the Fastly CLI with Homebrew, a supported package manager, or an official release.
- Ensure
fastlyis on PATH, or setPULSE_FASTLY_BINin CI.
PULSE_FASTLY_CLI_INSPECTION_FAILED — Fastly CLI Inspection Failed#
Pulse could not inspect the installed Fastly CLI version.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Run
fastly versiondirectly and fix the Fastly CLI installation.
PULSE_VICEROY_UNAVAILABLE — Viceroy Unavailable#
The explicitly selected Viceroy override is unavailable.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Unset
PULSE_VICEROY_BINto let the Fastly CLI manage its local Compute engine. - If an override is required, point
PULSE_VICEROY_BINat an executable Viceroy binary.
PULSE_VICEROY_INSPECTION_FAILED — Viceroy Inspection Failed#
Pulse could not inspect the explicitly selected Viceroy override.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Inspect or replace the explicitly selected Viceroy override, or unset it to restore Fastly CLI ownership.
PULSE_FASTLY_SERVE_START_FAILED — Fastly Serve Start Failed#
The Fastly local Compute service failed before becoming ready.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Run
fastly compute servedirectly in the generated package and inspect its output.
PULSE_FASTLY_SERVE_START_TIMEOUT — Fastly Serve Start Timeout#
The Fastly local Compute service did not become ready before its startup timeout.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Inspect Fastly CLI output and local port availability, then retry.
PULSE_FASTLY_REQUEST_TIMEOUT — Fastly Request Timeout#
A request to the local Fastly Compute service exceeded its timeout.
- Category:
toolchain - CLI exit class:
5 - Development HTTP status:
504 - Stability/scope:
preview-stable/public - Related reference: CLI doctor behavior
Remediation
- Inspect the local Fastly Compute service and backend fixture before retrying.
Schema diagnostics#
PULSE_SCHEMA_COMPILE_FAILED — Schema Compile Failed#
An explicitly declared JSON schema could not be compiled.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Fix the declared schema source, exported type, or supported field shape.
- Run
pulse doctor --jsonto inspect schema diagnostics.
PULSE_CANONICAL_SCHEMA_MISSING — Canonical Schema Missing#
The handler references a schema ID that is absent from project configuration.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Declare the referenced schema ID in the default-exported registry selected by pulse.schema.
PULSE_SCHEMA_JSON_DECLARATIONS_RETIRED — Schema JSON Declarations Retired#
Legacy jsonSchemas declarations are no longer accepted as schema authority.
- Category:
schema - CLI exit class:
2 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Move schema declarations into a default-exported defineSchemaRegistry(...) module.
- Point pulse.schema at that workspace-relative module.
PULSE_SCHEMA_CODEC_REALIZATION_PENDING — Schema Codec Realization Pending#
The selected schema shape cannot be realized by every configured execution target.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Rebuild from the authoritative pulse.schema registry with a compiler that realizes the declared shape on both targets.
- Pulse will not fall back to generic JSON automatically.
PULSE_CANONICAL_SCHEMA_ID_LITERAL_REQUIRED — Canonical Schema Id Literal Required#
A schema operation uses a value that is not a static string literal ID.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Use a static string literal for the schema ID.
PULSE_SCHEMA_ID_INVALID — Schema Id Invalid#
A schema-bound operation received an invalid schema ID.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Use a non-empty schema ID declared by the authoritative pulse.schema registry.
PULSE_SCHEMA_REQUIRED — Schema Required#
Strict JSON operation omitted its required registered schema ID.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Supply a statically declared schema ID at every strict JSON boundary.
PULSE_SCHEMA_REFERENCE — Schema Reference#
A JSON operation references a schema absent from the compiled codec table.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Reference an ID declared by the authoritative pulse.schema registry.
PULSE_SCHEMA_CODECS_UNAVAILABLE — Schema Codecs Unavailable#
A schema-bound JSON operation has no compiled codec table.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Rebuild or redeploy the application with its generated schema codec table.
PULSE_RESPONSE_CASE_MISSING — Response Case Missing#
The handler references a response case absent from pulse.schema.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Declare the referenced response case in pulse.schema.
PULSE_RESPONSE_CASE_REFERENCE — Response Case Reference#
A runtime JSON response references an unknown compiled response case.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Use a response-case ID declared by pulse.schema.
PULSE_RESPONSE_DESCRIPTOR_INVALID — Response Descriptor Invalid#
A runtime JSON response received an invalid descriptor.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Pass an object descriptor or a registered response-case string to ctx.json.
PULSE_RESPONSE_DESCRIPTOR_LITERAL_REQUIRED — Response Descriptor Literal Required#
A JSON response descriptor cannot be resolved statically.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Use an object literal or a registered response-case string literal as the ctx.json response descriptor.
PULSE_SCHEMA_ID_DUPLICATE — Schema Id Duplicate#
Two or more configured schema declarations use the same stable ID.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Give every declared schema a unique stable ID.
PULSE_SCHEMA_SOURCE_REQUIRED — Schema Source Required#
A schema declaration is missing its project-relative TypeScript source file.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Set the schema declaration
sourceto a project-relative TypeScript file.
PULSE_SCHEMA_TYPE_REQUIRED — Schema Type Required#
A schema declaration is missing its exported TypeScript type name.
- Category:
schema - CLI exit class:
3 - Development HTTP status:
500 fallback when surfaced by the development server - Stability/scope:
preview-stable/public - Related reference: Project schema configuration
Remediation
- Set the schema declaration
typeto an exported TypeScript type name.
Request diagnostics#
PULSE_SCHEMA_CONTENT_TYPE — Schema Content Type#
A schema-bound JSON input uses a content type rejected by policy.
- Category:
request - CLI exit class:
4 - Development HTTP status:
415 - Stability/scope:
preview-stable/public - Related reference: Body and schema troubleshooting
Remediation
- Send a JSON content type accepted by the configured schema policy.
PULSE_SCHEMA_JSON_MALFORMED — Schema JSON Malformed#
A schema-bound JSON input is not syntactically valid JSON.
- Category:
request - CLI exit class:
4 - Development HTTP status:
400 - Stability/scope:
preview-stable/public - Related reference: Body and schema troubleshooting
Remediation
- Send syntactically valid JSON before schema validation.
PULSE_BODY_DECODE — Body Decode#
A structured request body could not be decoded in the requested representation.
- Category:
request - CLI exit class:
4 - Development HTTP status:
400 - Stability/scope:
preview-stable/public - Related reference: Body and schema troubleshooting
Remediation
- Send valid JSON or text matching the documented request shape.
PULSE_SCHEMA_DECODE — Schema Decode#
JSON input did not satisfy the explicitly declared schema and content-type policy.
- Category:
request - CLI exit class:
4 - Development HTTP status:
400 - Stability/scope:
preview-stable/public - Related reference: Body and schema troubleshooting
Remediation
- Send JSON with the required content type and schema fields.
- Use
pulse testwith a failing case to reproduce the validation error locally.
PULSE_BODY_TOO_LARGE — Body Too Large#
A structured body exceeded the configured bounded-body limit.
- Category:
request - CLI exit class:
4 - Development HTTP status:
413 - Stability/scope:
preview-stable/public - Related reference: Body and schema troubleshooting
Remediation
- Reduce the request payload or increase the configured structured-body limit deliberately.
PULSE_REQUEST_BODY_TOO_LARGE — Request Body Too Large#
An incoming development request exceeded dev.maxBodyBytes.
- Category:
request - CLI exit class:
4 - Development HTTP status:
413 - Stability/scope:
preview-stable/public - Related reference: Body and schema troubleshooting
Remediation
- Reduce the request payload or increase
dev.maxBodyBytesdeliberately.
Runtime diagnostics#
PULSE_FETCH_SCHEMA_WITHOUT_JSON — Fetch Schema Without JSON#
An outbound fetch schema was supplied without a semantic JSON payload.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Use schema only together with the outbound fetch json field.
PULSE_BODY_UNAVAILABLE — Body Unavailable#
A structured body was requested when the provider had not supplied one.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Ensure the provider supplied a structured body snapshot before decoding it.
PULSE_OPAQUE_BODY_INSPECTION — Opaque Body Inspection#
Application code attempted to inspect or transform an opaque host-owned body.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
400 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Return or proxy the opaque response directly; do not call JSON, text, bytes, or transform helpers.
PULSE_RESPONSE_ENCODE — Response Encode#
The selected response encoder cannot represent the returned value.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Return a value supported by the selected response or schema encoder.
PULSE_SCHEMA_ENCODE — Schema Encode#
The returned value does not satisfy its declared response schema.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Return a value that satisfies the declared response schema.
PULSE_FETCH_TIMEOUT — Fetch Timeout#
An outbound fetch did not complete before its timeout.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
504 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Check the origin and timeout policy, then retry.
- Use a configured fetch fixture in tests for deterministic reproduction.
PULSE_FETCH_NETWORK — Fetch Network#
An outbound fetch failed because the origin or network was unavailable.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
502 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Check the origin URL, backend binding, and local network access.
PULSE_FETCH_URL_INVALID — Fetch URL Invalid#
An outbound fetch uses an invalid or unsupported URL.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
400 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Use an absolute supported URL or a correctly configured provider backend.
PULSE_CONTINUATION_EXPIRED — Continuation Expired#
A pending continuation exceeded its configured lifetime before resumption.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
504 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Increase the continuation TTL only if the provider operation is expected to take longer.
PULSE_CONTINUATION_DOUBLE_RESUME — Continuation Double Resume#
A provider attempted to resume the same continuation more than once.
- Category:
runtime - CLI exit class:
4 - Development HTTP status:
500 - Stability/scope:
preview-stable/public - Related reference: Troubleshooting
Remediation
- Report this as a Pulse runtime/provider bug with the continuation trace.