# Navigation Semantics Decision

> Navigation Semantics Decision is a paid API for AI agents from agentreadiness.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Passively fetches public evidence from a target URL and evaluates whether its navigation semantics meet a documented criterion, returning a verdict, observation, threshold, evidence source, limitations, and recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/navigation-semantics-decision?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/navigation-semantics-decision-74fc6533
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DZNrqqzVQna7BPBZftjne

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability navigation-semantics-decision-74fc6533 -d '<json body>'
```

Example prompt: Can you check whether https://example.com has proper navigation semantics for AI agents — I need to know if it passes, what evidence was found, and what action I should take if it fails?

## When to prefer this

Choose this endpoint when you need a fast, passive, structured verdict on whether a specific URL's navigation semantics meet agent-readiness criteria — particularly when you want an actionable recommendation alongside the verdict. Prefer it over generic HTML validators or full-site crawlers when you need a lightweight, per-URL semantic check scoped specifically to navigation structure and AI-agent parseability.

## Known failure modes

- Target URL is unreachable or returns a non-200 status — check will fail or return inconclusive verdict
- Target requires authentication — passive check cannot access gated content
- Malformed or non-HTTP(S) URL supplied — normalization may fail or return an error
- Target has bot-blocking or rate limiting — evidence may be incomplete
- Compare URL is invalid or inaccessible when baseline comparison is requested

## How this service works

Navigation semantics decision fetches current public evidence from the supplied target and evaluates the documented criterion. It returns the observation, threshold, verdict, exact evidence source, limitations and a mode-specific action. The check is passive: no login attempt, payload injection, exploit, purchase, form submission or load test is performed.

## Output

Returns a structured response containing: the observation (what was found on the target), the threshold criterion being evaluated, a pass/fail verdict, the exact evidence source URL, any limitations of the check, and a mode-specific action recommendation. No login, form submission, or active exploitation is performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Public HTTP(S) URL or domain to inspect. A bare domain is normalized to HTTPS."
  },
  "context": {
   "type": "object",
   "description": "Optional non-secret correlation labels returned unchanged only in the request lifecycle.",
   "maxProperties": 12,
   "additionalProperties": {
    "type": [
     "string",
     "number",
     "boolean",
     "null"
    ]
   }
  },
  "baseline": {
   "type": [
    "object",
    "null"
   ],
   "description": "Optional baseline returned by a previous snapshot call.",
   "additionalProperties": true
  },
  "compare_url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Optional public comparison URL. Used by change and monitoring services."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/navigation-semantics-decision-74fc6533/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreadiness.halowerk.com](https://www.zero.xyz/host/agentreadiness.halowerk.com/llms.txt)