Handbook

Artifact `InteractionProbe` v1

JSON record of one executed interaction (or attempted step) from the source-ingest runtime, returned after running an action from a PageMechanicsSpec or an internal probe step. Used by LCDL for diagnose / repair…

Updated

Artifact InteractionProbe v1

Summary

JSON record of one executed interaction (or attempted step) from the source-ingest runtime, returned after running an action from a PageMechanicsSpec or an internal probe step. Used by LCDL for diagnose / repair loops—not executed inside LCDL.

Root object

Field Type Required Notes
schema_version string yes Must be exactly interaction_probe_v1.
probe_id string yes Correlates with parent PageProbe / run id.
action_index integer yes Zero-based index into the mechanics actions array (or sentinel agreed by runtime).
kind string yes Echo of the action kind that was run.
ok boolean yes Whether the step completed without runtime error.
error_code string no Normalized code when ok is false (e.g. timeout, selector_not_found).
error_message string no Short message safe for logs (no secrets).
url_after string no URL after the step if navigation occurred.
observed_snippet string no Truncated text or attribute snapshot for LCDL feedback.
metadata object no Opaque; may be {}.

Changelog

  • v1 — Initial interaction outcome contract.

Inputs

See contract.json input_schema for fields and types.

Output

See contract.json output_schema for the validated result object.

Failure modes

  • TransportFailure — chat transport errors.
  • ParseFailure — assistant output not valid JSON.
  • SchemaFailure — input or output rejected vs contract schemas.
  • GatewayFailure — upstream/provider errors.

Verification

Task-internal validation and JSON schema checks per contract.json verification_policy.