disable_entity

What disable_entity does on Ha Nexus Agent

AI agents use disable_entity to create or update resources in Ha Nexus Agent, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Ha Nexus Agent environment.

Why disable_entity is rated Medium

This tool modifies the state or configuration of a smart home entity by disabling it in the registry. While this is a reversible operation (entities can be re-enabled), it does alter system state and could disrupt automations or device control if misused. It does not delete data (Destructive), execute arbitrary code (Execute), involve financial transactions (Financial), or merely retrieve information (Read).

From the tool's definition Tool name 'disable_entity' and description 'Disable an entity in the registry' indicate modification of entity state/configuration. The action is reversible (entities can be re-enabled), and affects smart home automation behavior rather than causing data loss.

The rule that runs disable_entity safely

PolicyLayer is an MCP gateway: it sits between your AI agents and Ha Nexus Agent, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For disable_entity, this is the rule to start with:

{
  "version": "1",
  "default": "deny",
  "tools": {
    "disable_entity": {
      "limits": [
        {
          "counter": "disable_entity_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

Questions about disable_entity