Handbook
Artifact `PageProbe` v1
JSON snapshot produced by the source-ingest runtime after deterministic prelude steps (navigation freeze, scroll/wait policy, DOM inventory). Passed into LCDL tasks for routing, classification, or mechanics inference—not…
Artifact PageProbe v1
Summary
JSON snapshot produced by the source-ingest runtime after deterministic prelude steps (navigation freeze, scroll/wait policy, DOM inventory). Passed into LCDL tasks for routing, classification, or mechanics inference—not executed inside LCDL.
Root object
| Field | Type | Required | Notes |
|---|---|---|---|
schema_version |
string | yes | Must be exactly page_probe_v1. |
probe_id |
string | yes | Stable id for dedup / tracing (e.g. UUID or hash). |
url |
string | yes | Canonical page URL at probe time. |
title |
string | no | Document title if available; "" if unknown. |
captured_at |
string | no | ISO-8601 timestamp if available. |
operator_hints |
object | no | DOM contract hints (containers, patterns); may be {}. |
selector_inventory |
array | no | Short list of { "selector": string, "count": number, "sample_text": string } entries; avoid raw HTML dumps. |
text_density |
object | no | Opaque metrics (e.g. chars per viewport); may be {}. |
viewport |
object | no | { "width": number, "height": number } if known. |
notes |
string | no | Runtime notes; "" if none. |
Policy
- Prefer compact inventories over full HTML or base64 screenshots unless a separate vision contract applies.
- Secrets (cookies, tokens, auth headers) must not appear in probe payloads.
Changelog
- v1 — Initial probe interchange contract.