{ "schema": "helixwright.ai.docs.manifest", "schema_version": 2, "doc_version": "2026-07-16", "updated_at": "2026-07-16T22:02:19+08:00", "sdk": { "name": "helixwright", "version": "1.0.2", "architecture": "Helix Browser Desktop Local API + namespaced Browser RPC V6", "release_state": "released" }, "runtime_requirements": { "browser_family": "chromium", "browser_version": "149.0.7827.156", "browser_rpc": { "protocol_version": 6, "endpoint": "/rpc/v6", "core_contract": "0075", "minimum_methods": [ "action.cancel", "action.reconcile", "action.status", "blob.close", "blob.open", "blob.read", "blob.renew", "console.unlisten", "downloads.unlisten", "element.await_ready_and_act", "element.screenshot", "events.read", "events.subscribe", "events.unsubscribe", "frames.list", "input.gesture", "network.unlisten", "page.back", "page.forward", "page.navigate", "page.reload", "page.screenshot", "state.snapshot", "target.activate", "target.close", "target.new", "targets.list" ], "authoring_methods": [ "action.cancel", "action.reconcile", "action.status", "blob.close", "blob.open", "blob.read", "blob.renew", "console.listen", "console.messages", "console.unlisten", "cookies.clear", "cookies.get", "cookies.set", "dialog.policy", "downloads.events", "downloads.listen", "downloads.unlisten", "element.await_ready_and_act", "element.screenshot", "events.read", "events.subscribe", "events.unsubscribe", "frames.list", "input.gesture", "network.body", "network.events", "network.listen", "network.route.clear", "network.route.set", "network.unlisten", "page.back", "page.forward", "page.navigate", "page.reload", "page.screenshot", "rpc.describe", "rpc.hello", "rpc.ping", "script.evaluate", "state.snapshot", "target.activate", "target.close", "target.new", "targets.list", "trace.clear", "trace.events", "trace.mark", "trace.snapshot", "trace.start", "trace.stop" ], "method_schema_versions": { "action.cancel": 1, "action.reconcile": 2, "action.status": 1, "blob.close": 1, "blob.open": 1, "blob.read": 3, "blob.renew": 1, "console.listen": 3, "console.messages": 3, "console.unlisten": 1, "cookies.clear": 2, "cookies.get": 2, "cookies.set": 2, "dialog.policy": 2, "downloads.events": 3, "downloads.listen": 3, "downloads.unlisten": 1, "element.await_ready_and_act": 2, "element.screenshot": 3, "events.read": 1, "events.subscribe": 3, "events.unsubscribe": 1, "frames.list": 2, "input.gesture": 3, "network.body": 3, "network.events": 3, "network.listen": 3, "network.route.clear": 2, "network.route.set": 2, "network.unlisten": 1, "page.back": 2, "page.forward": 2, "page.navigate": 2, "page.reload": 2, "page.screenshot": 2, "rpc.describe": 1, "rpc.hello": 1, "rpc.ping": 1, "script.evaluate": 4, "state.snapshot": 3, "target.activate": 2, "target.close": 2, "target.new": 2, "targets.list": 2, "trace.clear": 2, "trace.events": 3, "trace.mark": 2, "trace.snapshot": 3, "trace.start": 2, "trace.stop": 2 }, "wire_schema_sha256": "F0DF499446D95A09DF1B0308F8D331138853FC5C21D2ADD174D867CD6162F2E0", "capability_versions": { "action_journal_reconcile": 1, "atomic_element_screenshot": 1, "atomic_ready_action": 1, "atomic_state_snapshot": 1, "bounded_blob_handles": 2, "bounded_response_paging": 1, "canonical_schema_codegen": 1, "compensating_input_release": 1, "correlated_event_stream": 2, "during_move_readiness_checkpoints": 1, "explicit_blob_read_leases": 1, "full_fidelity_private_evidence": 1, "immutable_frame_chain": 1, "mutation_receipt_for_every_action": 1, "namespaced_v6_surface": 1, "one_shot_retry_authority": 1, "per_target_input_session": 1, "safe_integer_strict_json": 1, "session_capability_blobs": 2, "single_source_request_identity": 1, "strict_raw_json_admission": 1, "strict_wire_validation": 1, "subscription_lifecycle": 1 }, "receipt_fields": [ "action_id", "readiness_id", "dispatch_phase", "target_id", "frame_id", "document_epoch", "element_identity", "geometry_version", "action_point", "started_mono_ms", "dispatched_mono_ms", "completed_mono_ms", "compensating_release_ok", "input_session_id", "input_sequence_id", "motion_policy_digest", "request_gesture_digest", "executed_trajectory_digest", "trajectory_sample_count", "trajectory_duration_ms", "trajectory_max_step_css_px", "pointer_continuity_ok", "commit_state", "replay_allowed", "result" ], "action_transaction": { "compensating_release": true, "deadline_cancels_execution": true, "during_move_checkpoint": { "evaluation_order": "after_bound_move_before_next_input_event", "event_index_semantics": "executed_event_count", "evidence": "action_result.json_evidence_blob", "failure_behavior": "stop_input_compensating_release", "failure_code": "READINESS_LOST_DURING_MOVE", "max_event_gap": 64, "required_for_pointer_drag": true, "revalidate": [ "element_identity", "geometry_lease", "actionability", "scroll_owner" ], "same_document_epoch": true, "subjects": [ "source", "target" ] }, "final_pointerdown_recheck": true, "retry_authority": { "consume_atomically_with_new_action": true, "consume_scope": "original_action_retry_generation", "consumed_error": "RETRY_AUTHORITY_CONSUMED", "invalid_error": "INVALID_RETRY_AUTHORITY", "issuer": "action.reconcile", "max_ttl_ms": 600000, "mint_once_per_original_action": true, "reconcile_replay": "same_unconsumed_grant", "requires_new_action_id": true, "single_use": true }, "same_document_epoch": true, "unknown_dispatch_replay": false }, "evidence": { "full_fidelity": true, "redaction": false }, "state_snapshot": { "delivery": "atomic_frozen_json_blob", "document_fields": [ "url", "title", "html", "ready_state", "visibility_state", "active_element", "forms", "storage" ], "response_requires": [ "snapshot_id", "context.target_id", "context.frame_id", "context.document_epoch", "captured_mono_ms", "blob" ] }, "motion_receipt": { "digest_algorithm": "sha256_canonical_json", "input_sequence_must_bind_session_prefix": true, "input_session_and_sequence_are_required_evidence": true, "motion_policy_digest_is_distinct": true, "positive_samples_require_continuity_boolean": true, "positive_samples_require_executed_digest": true, "request_gesture_digest_is_distinct_from_executed_trajectory": true, "request_gesture_digest_scope": "canonical_json_events_and_checkpoints", "zero_samples_require_null_execution_evidence": true }, "transport": { "admission": { "event_sequence_max": 2147483647, "listen_backlog": 128, "max_connection_inflight": 16, "max_connection_subscriptions": 8, "max_connections": 256, "max_global_inflight": 256, "max_global_subscriptions": 128, "max_recent_request_ids": 8192, "max_target_inflight": 64, "max_target_subscriptions": 16, "recent_request_id_ttl_seconds": 600 }, "authoritative_deadline": "request_envelope.deadline_ms", "bounded_blob": { "active_reader_eviction": "forbidden", "active_reader_pin": true, "active_reader_pin_max_seconds": 600, "active_reader_pin_outlives_lease": true, "authorization_scope": "browser_session_and_rpc_principal", "blob_id_min_entropy_bits": 128, "capability_token_min_entropy_bits": 256, "chromium_writes_sdk_assets": false, "chunk_encoding": "base64", "close_idempotent": true, "close_replay": "same_lease_identity_returns_closed_already_closed_true_same_closed_mono_ms", "connection_binding": "quota_only", "connection_close_releases_lease": false, "cross_thread_read": true, "default_lease_ttl_seconds": 120, "default_ttl_seconds": 120, "errors": [ "BLOB_NOT_FOUND", "BLOB_SESSION_MISMATCH", "BLOB_PRINCIPAL_MISMATCH", "BLOB_CAPABILITY_MISMATCH", "BLOB_EXPIRED", "BLOB_EVICTED", "BLOB_RANGE_INVALID", "BLOB_INTEGRITY_MISMATCH", "BLOB_LEASE_NOT_FOUND", "BLOB_LEASE_IDENTITY_CONFLICT", "BLOB_LEASE_OWNER_MISMATCH", "BLOB_LEASE_GENERATION_MISMATCH", "BLOB_LEASE_EXPIRED", "BLOB_LEASE_CLOSED", "BLOB_ACTIVE_READER_EVICTION_FORBIDDEN", "BLOB_QUOTA_EXCEEDED" ], "eviction": "expired_unleased_then_owner_lru_unleased", "hash": "sha256", "initial_network_chunk": true, "lease_id_min_entropy_bits": 128, "lease_mode": "explicit_open_read_renew_close", "lease_owner_binding": [ "browser_session_id", "rpc_auth_principal_sha256", "lease_id", "generation" ], "lease_pins_blob": true, "max_chunk_base64_chars": 2796204, "max_chunk_bytes": 2097152, "max_global_bytes": 2147483648, "max_handles_per_owner": 64, "max_lease_ttl_seconds": 600, "max_leases_per_owner": 64, "max_owner_bytes": 536870912, "max_raw_headers_utf16_units": 65536, "max_single_blob_bytes": 268435456, "max_total_bytes": 268435456, "max_ttl_seconds": 600, "mode": "session_capability_handles", "offset_unit": "raw_bytes", "open_idempotent": true, "open_replay": "same_open_id_same_identity_returns_same_lease_else_BLOB_LEASE_IDENTITY_CONFLICT", "owner_binding": [ "browser_session_id", "rpc_auth_principal_sha256", "blob_capability_token" ], "read_refreshes_lease": false, "reject_capability_mismatch": true, "reject_principal_mismatch": true, "reject_session_mismatch": true, "renew_generation": "increment_once_per_new_renew_id", "renew_idempotent": true, "renew_replay": "same_renew_id_same_identity_returns_same_generation_and_expiry_else_BLOB_LEASE_IDENTITY_CONFLICT", "session_close_releases_leases": true, "small_payload_inline": false, "survives_connection_replacement": true, "trace_asset_scope": "owner_only", "trace_atomic_asset_write": true, "trace_verify_final_sha256": true, "trace_verify_final_size": true }, "duplicate_semantic_fields": "forbidden", "json_admission": { "duplicate_object_keys": "reject_before_value_parse", "encoding": "utf-8", "grammar": "rfc8259", "integer_model": "ieee754_safe_integer", "max_depth": 64, "maximum_integer": 9007199254740991, "minimum_integer": -9007199254740991, "non_finite_numbers": "reject", "request_limit_stage": "before_parse", "response_limit_stage": "before_send", "schema_validation_stage": "after_strict_parse" }, "length_unit": "utf16_code_units", "max_deadline_ms": 600000, "max_request_bytes": 4194304, "max_response_bytes": 4194304, "max_response_result_bytes": 3670016, "response_admission_metadata": "absolute_monotonic_interval_and_effective_identity", "response_envelope_reserve_bytes": 524288 }, "action_identity": { "conflict_error": "ACTION_IDENTITY_CONFLICT", "fields": [ "action_id", "request_id", "idempotency_key" ], "maximum_identifiers": 3, "minimum_identifiers": 1, "multiple_identifiers_must_resolve_same_record": true }, "release_blockers": [ "endpoint_request_response_schema_validator_integration", "runtime_owner_bound_blob_store_and_blob_read", "screenshot_inline_base64_to_blob_handle", "sdk_blob_reader_and_trace_asset_assembler", "rust_admission_validator_integration", "runtime_receipt_exact_25_field_normalization", "core_event_stream_generation_and_cursor_rollover", "endpoint_generated_limits_integration", "sdk_strict_json_and_generated_validator_integration", "core_exact_receipt_failure_and_action_result_integration", "sdk_motion_receipt_cross_field_validation_integration", "core_session_capability_blob_authorization", "endpoint_strict_raw_json_admission_before_jsonreader", "rust_strict_raw_json_admission", "core_frozen_snapshot_json_blob_materialization", "core_byte_budgeted_pagination", "core_subscription_listener_lifecycle", "sdk_transparent_json_blob_assembler", "endpoint_single_authoritative_deadline_and_admission_metadata", "sdk_remove_params_deadline_and_envelope_semantic_duplicates", "core_events_subscribe_read_unsubscribe_lifecycle", "core_listener_unlisten_generation_and_lease", "sdk_frozen_pagination_and_byte_budget", "runtime_blob_lease_open_read_renew_close", "runtime_blob_active_reader_pin_and_quota_ordering", "sdk_blob_lease_reader_and_trace_assembler", "core_one_shot_retry_authority_consumption", "core_during_move_checkpoint_execution_and_receipt", "rust_cpp_safe_integer_strict_json_integration", "core_generated_method_limit_hash_discovery_consumption", "sdk_one_shot_retry_authority_rearm_and_consumption", "sdk_during_move_immutable_checkpoint_serialization" ], "event_stream": { "cursor_bound_to": [ "generation", "target_id", "subscription_id" ], "cursor_opaque": true, "generation_required": true, "rollover": "increment_generation_clear_retained_reset_sequence", "sequence_max": 2147483647, "stale_cursor_error": "EVENT_STREAM_GENERATION_MISMATCH" }, "pagination": { "cursor_authorization": "browser_session_and_rpc_principal", "cursor_binding": [ "generation_or_snapshot_id", "query_identity", "position" ], "cursor_opaque": true, "frozen_list_snapshot_ttl_seconds": 120, "max_page_item_bytes": 3145728, "never_split_item": true, "oversized_item_escape": "json_evidence_blob", "response_result_max_bytes": 3670016, "stable_snapshot_required": true }, "subscription_lifecycle": { "active_waiter_pin_max_seconds": 600, "connection_close_releases": false, "default_idle_ttl_seconds": 120, "explicit_close_methods": [ "events.unsubscribe", "network.unlisten", "console.unlisten", "downloads.unlisten" ], "max_idle_ttl_seconds": 3600, "one_shot_completion_destroys": true, "open_same_id_changed_identity": "SUBSCRIPTION_IDENTITY_CONFLICT", "open_same_id_same_identity": "idempotent", "read_refreshes_idle_lease": true, "session_close_cleanup": true, "wait_completion_destroys": false }, "contract_hash": "651BE2EBDA048D463A8A2570830848CC5AA33D8AD744B0CE0E84B949430CDD4F", "minimum_launch": { "methods": [ "action.cancel", "action.reconcile", "action.status", "blob.close", "blob.open", "blob.read", "blob.renew", "console.unlisten", "downloads.unlisten", "element.await_ready_and_act", "element.screenshot", "events.read", "events.subscribe", "events.unsubscribe", "frames.list", "input.gesture", "network.unlisten", "page.back", "page.forward", "page.navigate", "page.reload", "page.screenshot", "state.snapshot", "target.activate", "target.close", "target.new", "targets.list" ], "capabilities": { "action_journal_reconcile": 1, "atomic_element_screenshot": 1, "atomic_ready_action": 1, "atomic_state_snapshot": 1, "bounded_blob_handles": 2, "bounded_response_paging": 1, "canonical_schema_codegen": 1, "compensating_input_release": 1, "correlated_event_stream": 2, "during_move_readiness_checkpoints": 1, "explicit_blob_read_leases": 1, "full_fidelity_private_evidence": 1, "immutable_frame_chain": 1, "mutation_receipt_for_every_action": 1, "namespaced_v6_surface": 1, "one_shot_retry_authority": 1, "per_target_input_session": 1, "safe_integer_strict_json": 1, "session_capability_blobs": 2, "single_source_request_identity": 1, "strict_raw_json_admission": 1, "strict_wire_validation": 1, "subscription_lifecycle": 1 } }, "full_authoring": { "methods": [ "action.cancel", "action.reconcile", "action.status", "blob.close", "blob.open", "blob.read", "blob.renew", "console.listen", "console.messages", "console.unlisten", "cookies.clear", "cookies.get", "cookies.set", "dialog.policy", "downloads.events", "downloads.listen", "downloads.unlisten", "element.await_ready_and_act", "element.screenshot", "events.read", "events.subscribe", "events.unsubscribe", "frames.list", "input.gesture", "network.body", "network.events", "network.listen", "network.route.clear", "network.route.set", "network.unlisten", "page.back", "page.forward", "page.navigate", "page.reload", "page.screenshot", "rpc.describe", "rpc.hello", "rpc.ping", "script.evaluate", "state.snapshot", "target.activate", "target.close", "target.new", "targets.list", "trace.clear", "trace.events", "trace.mark", "trace.snapshot", "trace.start", "trace.stop" ], "capabilities": { "action_journal_reconcile": 1, "atomic_element_screenshot": 1, "atomic_ready_action": 1, "atomic_state_snapshot": 1, "bounded_blob_handles": 2, "bounded_response_paging": 1, "canonical_schema_codegen": 1, "compensating_input_release": 1, "correlated_event_stream": 2, "during_move_readiness_checkpoints": 1, "explicit_blob_read_leases": 1, "full_fidelity_private_evidence": 1, "immutable_frame_chain": 1, "mutation_receipt_for_every_action": 1, "namespaced_v6_surface": 1, "one_shot_retry_authority": 1, "per_target_input_session": 1, "safe_integer_strict_json": 1, "session_capability_blobs": 2, "single_source_request_identity": 1, "strict_raw_json_admission": 1, "strict_wire_validation": 1, "subscription_lifecycle": 1 } }, "receipt_evidence_fields": [ "action_id", "readiness_id", "dispatch_phase", "target_id", "frame_id", "document_epoch", "element_identity", "geometry_version", "action_point", "started_mono_ms", "dispatched_mono_ms", "completed_mono_ms", "compensating_release_ok", "input_session_id", "input_sequence_id", "motion_policy_digest", "request_gesture_digest", "executed_trajectory_digest", "trajectory_sample_count", "trajectory_duration_ms", "trajectory_max_step_css_px", "pointer_continuity_ok", "commit_state", "replay_allowed", "result" ], "rpc_schema_version": 6 } }, "canonical": { "human_docs": "http://66.154.125.146:8000/helixwright", "llms_txt": "http://66.154.125.146:8000/helixwright/llms.txt", "manifest": "http://66.154.125.146:8000/helixwright/ai/manifest.json" }, "skill_contract": { "always_read": [ "rules", "statemachine" ], "prefer_remote_docs": true, "fallback_policy": "If remote docs are unreachable, use only the minimal local SKILL.md fallback and clearly state that current server docs could not be verified." }, "documents": [ { "id": "rules", "title": "Helixwright 1.0 mandatory rules", "read_when": "Always before writing or reviewing Helixwright 1.0 automation.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/rules.md", "size": 9350, "sha256": "ae291fd2f4fa204c2b8ca158794e19c2d53f8bc44f81e899c57dba1f64ed9fbb" }, { "id": "quickstart", "title": "Helixwright 1.0 launch and first script", "read_when": "When creating a script or explaining the default launch and attach model.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/quickstart.md", "size": 5192, "sha256": "aee8123cd81124c3c7e3b08fd45715752c92658f6adb83f51836b11f2203c8bc" }, { "id": "api", "title": "Helixwright 1.0 public API reference", "read_when": "When checking public namespaces, parameters, return objects, or exceptions.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/api.md", "size": 21937, "sha256": "fe713aec20ed006ab0cd5597cffb232c645e20cef5adcd00664c11440045c11b" }, { "id": "locator", "title": "Immutable contexts, locators, readiness, frames, shadow DOM, and trusted input", "read_when": "When locating or acting on elements, scrolling, or crossing iframe, OOPIF, or shadow boundaries.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/locator.md", "size": 7532, "sha256": "25bfb642b2cc080b8cc52e1450c1bc13f236a360027895f720e8ac9ce82e16db" }, { "id": "motion", "title": "MotionProfile, atomic gestures, and trajectory receipts", "read_when": "When configuring motion, drag, slider, wheel, or expert atomic gestures.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/motion.md", "size": 5466, "sha256": "3e1ed21edd8ce179c1a6bea62c33fdcf0fc9809c739ffffce3c33636ee47f40a" }, { "id": "statemachine", "title": "Event-driven statecharts, effects, and concurrent regions", "read_when": "Always before writing a multi-state, branchy, concurrent, challenge, OTP, or popup flow.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/statemachine.md", "size": 8698, "sha256": "fb89319d7c7ab1eff2de296a6a3fe79b8ad27608f31852d4f981764316fe68cc" }, { "id": "trace", "title": "Owner-private full-fidelity Trace and Authoring workflow", "read_when": "When discovering a site, deriving state signatures, debugging failures, or producing private evidence.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/trace.md", "size": 7905, "sha256": "4a240edbacaa3a23a2da36315cd68d5f14bccc54c9c9f90a572771163a833458" }, { "id": "errors", "title": "Errors, cancellation, reconciliation, and recovery", "read_when": "When handling Local API, Browser RPC, readiness, dispatch, timeout, transport, or statechart failures.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/errors.md", "size": 6859, "sha256": "8a591d4882ef37c0a6acae1c2029bda728598c659e054de274b3c21b47d46324" }, { "id": "migration", "title": "Breaking 1.0 migration and retired compatibility surfaces", "read_when": "When replacing a script written against any earlier Helixwright contract.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/migration.md", "size": 4158, "sha256": "ea711e2290854b5624bac6d3c86818e15c8aa1cf56496d53c3926f99b1880acb" }, { "id": "examples", "title": "Production 1.0 patterns and Flow IR examples", "read_when": "When implementing a production statechart, idempotent form flow, or verifiable Flow IR bundle.", "url": "http://66.154.125.146:8000/helixwright/ai/latest/examples.md", "size": 6916, "sha256": "40d611e84ead047c6bacac869d3aeced088219fbfd8752733aa30711c50764a8" } ] }