Components

Composable primitives for agentic network operations.

Last updated April 30, 2026 Read time 8 min Edit on GitHub →

These are the component families the Agent Kit would expose to docs, portal workflows, and AI-native developer tools. Each component is shaped so it can be consumed by an agent through MCP, by a developer through the CLI, or by a reviewer through a PR.

Primitives

PricingContract

Reads structured pricing records from pricing.md and marks unknowns as quote-required.

PreflightGate

Blocks apply when assets, permissions, billing scope, API apps, or quotes are missing.

McpTrace

Shows each read or mutating tool, its reason, result, and confirmation status.

TerraformIntent

Generates reviewable infrastructure intent with explicit apply guards.

PortalDeepLink

Routes humans to the right portal surface for missing setup and approvals.

AgentRunbook

Turns the plan into copyable CLI, MCP, and pull-request steps.

pricing.md record

The smallest unit of governed pricing is a single record. The agent reads these records by product, metro, and package, and refuses to estimate anything that is not represented here.

record_type: price
product: fabric_cloud_router
metro: Ashburn
package: BASIC
mrc_usd: 900
availability: available_for_estimate
agent_instruction: use_for_directional_estimate_only

Tool confirmation envelope

Every mutating MCP tool ships with a confirmation envelope. The blocked_by array is the exhaustive list of preflight failures the agent must resolve, in any order, before the tool will execute.

{
  "tool": "equinix_fabric_create_router",
  "mode": "mutating",
  "requires_confirmation": true,
  "blocked_by": [
    "official_quote_missing",
    "developer_app_missing",
    "account_assets_missing"
  ]
}

Trace record

The McpTrace renders a row per tool call with timestamp, duration, and either the result or the block reason. This is the artifact your security review will most often ask for.

{
  "timestamp": "2026-05-01T10:42:18.420Z",
  "tool": "equinix_fabric_search_service_profiles",
  "mode": "read",
  "duration_ms": 132,
  "args": { "category": "ai_inference", "metro": "AS" },
  "result_summary": "Provider category: AI Inference. Groq selected from Provider Spotlight evidence."
}