@murphai/hosted-execution
v1.0.0
Published
Shared hosted-execution helpers for the hosted `apps/web` control plane and the Cloudflare execution worker.
Readme
@murphai/hosted-execution
Shared hosted-execution helpers for the hosted apps/web control plane and the
Cloudflare execution worker.
Scope
- own the shared hosted execution ingress, run, cursor, and status contract types
- define hosted execution auth header names and request-canonicalization helpers
- normalize the shared hosted execution env variables that are deployment-vendor neutral
- build stable internal route paths for hosted-run control calls and transport helpers
- own the shared
HostedIngressEvent/HostedRun/HostedExecutionCursorcontracts, signed callback routes, and narrow execution status vocabulary - provide the typed shared ingress/control helpers while keeping deployed auth adapters app-local
Contract
- signed callback canonicalization stays timestamped and request-bound across app-local signers and verifiers
- the shared control/status path layout stays stable between callers and the worker
- vendor-neutral env naming stays canonical so hosted web and Cloudflare do not drift
- this package owns only the shared hosted-execution transport seam: ingress/run/cursor/status codecs, route builders, auth header names, and canonicalization helpers
- deployment topology stays app-local: shared packages must not own worker hostnames, callback base-url defaults, or proxy-vs-server inference
- app-local auth adapters still own deployment-specific bearer token acquisition plus callback signing and verification
- operator-facing hosted public-origin fallback and Cloudflare callback-key config stay app-local and are intentionally documented in
apps/web/README.md, not here - Cloudflare operational control routes are private owner APIs, not part of this public package
- device-sync runtime snapshot/apply/token contracts stay on
@murphai/device-syncd/hosted-runtime; this package only carries the outer hosted ingress/run-control seam plus the shared device-sync wake-hint shape needed by that seam
Migration note
This package now hard-cuts device-sync runtime snapshot/apply/token exports.
Consumers that previously imported those symbols from @murphai/hosted-execution or @murphai/hosted-execution/parsers must import them from @murphai/device-syncd/hosted-runtime instead.
