PHPackages                             north-foundry/voyager-page-map-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. north-foundry/voyager-page-map-php

ActiveLibrary

north-foundry/voyager-page-map-php
==================================

Deterministic HTML-first page maps for language models and browser agents.

v0.2.0(1mo ago)05MITPHPPHP ^8.3CI passing

Since Jul 15Pushed 1mo agoCompare

[ Source](https://github.com/North-Foundry/voyager-page-map-php)[ Packagist](https://packagist.org/packages/north-foundry/voyager-page-map-php)[ RSS](/packages/north-foundry-voyager-page-map-php/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (8)Versions (3)Used By (0)

Voyager Page Map
================

[](#voyager-page-map)

[![CI](https://github.com/North-Foundry/voyager-page-map-php/actions/workflows/ci.yml/badge.svg)](https://github.com/North-Foundry/voyager-page-map-php/actions/workflows/ci.yml)[![Latest Stable Version](https://camo.githubusercontent.com/193222d742e6d75f01f565cdab31daa64df6a802d428c9d53c3a4491c149e1e7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f7274682d666f756e6472792f766f79616765722d706167652d6d61702d7068702e737667)](https://packagist.org/packages/north-foundry/voyager-page-map-php)[![Total Downloads](https://camo.githubusercontent.com/46738f4752444095699f2ab7f571543b6ff54de9e5e00a63ef60b6c5231698b5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f7274682d666f756e6472792f766f79616765722d706167652d6d61702d7068702e737667)](https://packagist.org/packages/north-foundry/voyager-page-map-php)[![PHP Version](https://camo.githubusercontent.com/10aa526b2c560c4c8683d702908198daa4b1f181324628185c12eca534b22682/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6e6f7274682d666f756e6472792f766f79616765722d706167652d6d61702d7068702f7068702e737667)](https://packagist.org/packages/north-foundry/voyager-page-map-php)[![License](https://camo.githubusercontent.com/6166170d6fbaa060113b3edbcbca9d1ec040fa08af4ce9ebf2d6dfd8082e8eb2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6e6f7274682d666f756e6472792f766f79616765722d706167652d6d61702d7068702e737667)](LICENSE)

**Turn static HTML into deterministic page context for LLMs.**

Voyager Page Map (VPM) is a PHP library that parses static HTML into `VPM/1`: a semantic, HTML-first text representation designed to be included in an LLM prompt.

```
static HTML -> Voyager Page Map -> VPM/1 text -> your LLM or agent

```

VPM preserves the information needed to understand and address a page—its structure, readable names, controls, declared state, link destinations, and potential actions—while filtering implementation noise such as scripts, styles, metadata, and irrelevant wrappers.

Every retained node receives a document-local reference such as `@e5`. That reference can also be resolved to a CSS or XPath selector for the source DOM.

Voyager Page Map is the context layer between your HTML source and your LLM. It does not fetch pages, execute JavaScript, control a browser, or call a language model.

Why VPM?
--------

[](#why-vpm)

Raw HTML contains presentation markup and implementation details that are often irrelevant to a language model. VPM produces a focused, predictable representation of page meaning and interaction without replacing familiar HTML semantics with a separate taxonomy.

Typical uses include:

- giving an LLM page context for extraction, classification, summarization, or question answering;
- grounding model output in explicit elements such as `@e5`;
- exposing controls, destinations, and potential actions so an agent can plan an interaction that another runtime will execute;
- creating deterministic semantic snapshots for tests or page-change analysis.

Requirements
------------

[](#requirements)

- PHP 8.3 or later
- DOM extension
- libxml extension

Installation
------------

[](#installation)

```
composer require north-foundry/voyager-page-map-php
```

Quick start
-----------

[](#quick-start)

```