VhyxSeal has four adoption levels. Each adds more precision for agents. Start at Level 0 — add detail incrementally as your needs grow.
Level 0 — Zero Effort
Use standard HTML and ARIA. VhyxSeal infers the contract automatically. Agents get something useful immediately — no extra code required.
Level 0 — Inferred
// Level 0 — no code required// VhyxSeal infers intent from HTML semantics and ARIA<button type="submit">Place Order</button>
Level 1 — Single Intent Prop
Add one intent prop. VhyxSeal looks up the intent in its built-in vocabulary and fills in safety level, confirmation requirements, and reversibility automatically.
Override specific fields. Everything you do not specify still comes from the intent vocabulary defaults. The agent gets a complete contract — you only wrote the parts that differ.
Level 2 — Partial overrides
// Level 2 — override specific fields<Button intent="place-order" contract={{ safetyLevel: "high", requiresConfirmation: true, }}> Place Order</Button>
Level 3 — Full Contract
Define the complete contract once outside JSX. Frozen, fingerprinted, and auto-versioned. Agents get the full picture — intent, preconditions, consequences, safety, error recovery, and navigation hints.
Level 3 — Full specification
// Level 3 — complete contract, frozen and fingerprintedimport { defineContract } from '@vhyxseal/core'import { withAgentContract, Button } from '@vhyxseal/react'const contract = defineContract({ id: "checkout-submit-btn", type: "action", intent: 'place-order', description: 'Submits the cart as a purchase order', requires: [ { field: 'user.authenticated', operator: '===', value: true, description: 'User must be logged in' }, { field: 'cart.hasItems', operator: '===', value: true, description: 'Cart must have at least one item' }, { field: 'user.hasPaymentMethod', operator: '===', value: true, description: 'Payment method must be saved' }, ], requiredPermissions: ['write:orders', 'read:payment'], consequence: 'charges payment method and triggers fulfillment', affects: ['cart', 'orders', 'payment', 'inventory'], reversible: true, reversibleWindow: 300, safetyLevel: 'high', requiresConfirmation: true, destructive: false, contractVersion: '1.0.0',})export const CheckoutButton = withAgentContract(Button, contract)
Your First Manifest
Wrap your app in SealProvider. VhyxSeal collects contracts from the component tree and auto-generates /__agent__/manifest.json whenever components mount or update.