{
  "openapi": "3.0.3",
  "info": {
    "title": "n3 Agent Server",
    "version": "6.0.0"
  },
  "servers": [
    {
      "url": "http://127.0.0.1:17631"
    }
  ],
  "paths": {
    "/api/v1/health": {
      "get": {
        "operationId": "health",
        "summary": "health",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "health",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/ready": {
      "get": {
        "operationId": "ready",
        "summary": "ready",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "ready",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/diagnostics": {
      "get": {
        "operationId": "diagnostics",
        "summary": "diagnostics",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-mcp-name": "n3_get_diagnostics",
        "x-n3-handler-key": "diagnostics",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/debug/context": {
      "get": {
        "operationId": "debug.context",
        "summary": "debug.context",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-mcp-name": "n3_get_debug_context",
        "x-n3-handler-key": "debug.context",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/lease/status": {
      "get": {
        "operationId": "lease.status",
        "summary": "lease.status",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-mcp-name": "n3_get_lease_status",
        "x-n3-handler-key": "lease.status",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/sessions": {
      "post": {
        "operationId": "session.create",
        "summary": "session.create",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-mcp-name": "n3_create_session",
        "x-n3-handler-key": "session.create",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/lease/acquire": {
      "post": {
        "operationId": "lease.acquire",
        "summary": "lease.acquire",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-mcp-name": "n3_acquire_lease",
        "x-n3-handler-key": "lease.acquire",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/lease/renew": {
      "post": {
        "operationId": "lease.renew",
        "summary": "lease.renew",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-mcp-name": "n3_renew_lease",
        "x-n3-handler-key": "lease.renew",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/lease/release": {
      "post": {
        "operationId": "lease.release",
        "summary": "lease.release",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-mcp-name": "n3_release_lease",
        "x-n3-handler-key": "lease.release",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/state": {
      "get": {
        "operationId": "state",
        "summary": "state",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "state",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/stream/status": {
      "get": {
        "operationId": "stream.status",
        "summary": "stream.status",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "stream.status",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/workflow/status": {
      "get": {
        "operationId": "workflow.status",
        "summary": "workflow.status",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "workflow.status",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/widgets/list": {
      "get": {
        "operationId": "widgets.list",
        "summary": "widgets.list",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "widgets.list",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/widgets/search": {
      "get": {
        "operationId": "widgets.search",
        "summary": "widgets.search",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "widgets.search",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/widgets/describe": {
      "get": {
        "operationId": "widgets.describe",
        "summary": "widgets.describe",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "widgets.describe",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/inventory": {
      "get": {
        "operationId": "inventory",
        "summary": "inventory",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "inventory",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/players": {
      "get": {
        "operationId": "players",
        "summary": "players",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "players",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/npcs": {
      "get": {
        "operationId": "npcs",
        "summary": "npcs",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "npcs",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/objects": {
      "get": {
        "operationId": "objects",
        "summary": "objects",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "objects",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/ground-items": {
      "get": {
        "operationId": "ground-items",
        "summary": "ground-items",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "ground-items",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/skills": {
      "get": {
        "operationId": "skills",
        "summary": "skills",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "skills",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/developer/metrics": {
      "get": {
        "operationId": "developer.metrics",
        "summary": "developer.metrics",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "developer.metrics",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/bank/status": {
      "get": {
        "operationId": "bank.status",
        "summary": "bank.status",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "bank.status",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/navigation/status": {
      "get": {
        "operationId": "navigation.status",
        "summary": "navigation.status",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "navigation.status",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/login/modes": {
      "get": {
        "operationId": "login.modes",
        "summary": "login.modes",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "login.modes",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/login/status": {
      "get": {
        "operationId": "login.status",
        "summary": "login.status",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "login.status",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/bank": {
      "get": {
        "operationId": "bank",
        "summary": "bank",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "bank",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins": {
      "get": {
        "operationId": "plugins",
        "summary": "plugins",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins/status": {
      "get": {
        "operationId": "plugins.status",
        "summary": "plugins.status",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins.status",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins/config": {
      "get": {
        "operationId": "plugins.config",
        "summary": "plugins.config",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins.config",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins/configs": {
      "get": {
        "operationId": "plugins.configs",
        "summary": "plugins.configs",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins.configs",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins/logs": {
      "get": {
        "operationId": "plugins.logs",
        "summary": "plugins.logs",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins.logs",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/menu-entries": {
      "get": {
        "operationId": "menu-entries",
        "summary": "menu-entries",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "menu-entries",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/last-interactions": {
      "get": {
        "operationId": "last-interactions",
        "summary": "last-interactions",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "last-interactions",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/varbit": {
      "get": {
        "operationId": "varbit",
        "summary": "varbit",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "varbit",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/varplayer": {
      "get": {
        "operationId": "varplayer",
        "summary": "varplayer",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "varplayer",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/varbit-changes": {
      "get": {
        "operationId": "varbit-changes",
        "summary": "varbit-changes",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "varbit-changes",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/suite/capabilities": {
      "get": {
        "operationId": "suite.capabilities",
        "summary": "suite.capabilities",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "suite.capabilities",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/sdk/read": {
      "get": {
        "operationId": "sdk.read",
        "summary": "sdk.read",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "sdk.read",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      },
      "post": {
        "operationId": "sdk.read.post",
        "summary": "Read SDK helper",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-mcp-name": "n3_read_sdk",
        "x-n3-handler-key": "sdk.read",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/world": {
      "get": {
        "operationId": "world",
        "summary": "world",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "world",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/world-map": {
      "get": {
        "operationId": "world-map",
        "summary": "world-map",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "world-map",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/camera": {
      "get": {
        "operationId": "camera",
        "summary": "camera",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "camera",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/line-of-sight": {
      "get": {
        "operationId": "line-of-sight",
        "summary": "line-of-sight",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "line-of-sight",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/item-metadata": {
      "get": {
        "operationId": "item-metadata",
        "summary": "item-metadata",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "item-metadata",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/prices": {
      "get": {
        "operationId": "prices",
        "summary": "prices",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "prices",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/social": {
      "get": {
        "operationId": "social",
        "summary": "social",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "social",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/progress": {
      "get": {
        "operationId": "progress",
        "summary": "progress",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "progress",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/recent-events": {
      "get": {
        "operationId": "recent-events",
        "summary": "recent-events",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "recent-events",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/questhelper": {
      "get": {
        "operationId": "questhelper",
        "summary": "questhelper",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "questhelper",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/production": {
      "get": {
        "operationId": "production",
        "summary": "production",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "production",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/minigames": {
      "get": {
        "operationId": "minigames",
        "summary": "minigames",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "minigames",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/loadout/state": {
      "get": {
        "operationId": "loadout.state",
        "summary": "loadout.state",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "loadout.state",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/navigation/preview": {
      "post": {
        "operationId": "navigation.preview",
        "summary": "Preview navigation",
        "x-n3-access": "READ",
        "x-n3-permission": "read",
        "x-n3-cost": "EXPENSIVE",
        "x-n3-mcp-name": "n3_preview_navigation",
        "x-n3-handler-key": "navigation.preview",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/login/profile/apply": {
      "post": {
        "operationId": "login.profile.apply",
        "summary": "login.profile.apply",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "login.profile.apply",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/login/start": {
      "post": {
        "operationId": "login.start",
        "summary": "login.start",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "login.start",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/login/clear": {
      "post": {
        "operationId": "login.clear",
        "summary": "login.clear",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "login.clear",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/developer/heartbeat": {
      "post": {
        "operationId": "developer.heartbeat",
        "summary": "developer.heartbeat",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "developer.heartbeat",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins/enable": {
      "post": {
        "operationId": "plugins.enable",
        "summary": "plugins.enable",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins.enable",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins/disable": {
      "post": {
        "operationId": "plugins.disable",
        "summary": "plugins.disable",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins.disable",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins/config/set": {
      "post": {
        "operationId": "plugins.config.set",
        "summary": "plugins.config.set",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins.config.set",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/plugins/config/unset": {
      "post": {
        "operationId": "plugins.config.unset",
        "summary": "plugins.config.unset",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "plugins.config.unset",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/widgets/click": {
      "post": {
        "operationId": "widgets.click",
        "summary": "widgets.click",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "widgets.click",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/inventory/interact": {
      "post": {
        "operationId": "inventory.interact",
        "summary": "inventory.interact; requires visible Inventory tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "inventory.interact",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/drop": {
      "post": {
        "operationId": "drop",
        "summary": "drop; requires visible Inventory tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "drop",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/npcs/interact": {
      "post": {
        "operationId": "npcs.interact",
        "summary": "npcs.interact",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "npcs.interact",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/players/interact": {
      "post": {
        "operationId": "players.interact",
        "summary": "players.interact",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "players.interact",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/objects/interact": {
      "post": {
        "operationId": "objects.interact",
        "summary": "objects.interact",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "objects.interact",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/ground-items/pickup": {
      "post": {
        "operationId": "ground-items.pickup",
        "summary": "ground-items.pickup",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "ground-items.pickup",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/walk": {
      "post": {
        "operationId": "walk",
        "summary": "walk",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "EXPENSIVE",
        "x-n3-handler-key": "walk",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/bank/open": {
      "post": {
        "operationId": "bank.open",
        "summary": "bank.open",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "bank.open",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/bank/close": {
      "post": {
        "operationId": "bank.close",
        "summary": "bank.close",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "bank.close",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/bank/transact": {
      "post": {
        "operationId": "bank.transact",
        "summary": "bank.transact",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "bank.transact",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/deposit": {
      "post": {
        "operationId": "deposit",
        "summary": "deposit",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "deposit",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/withdraw": {
      "post": {
        "operationId": "withdraw",
        "summary": "withdraw",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "withdraw",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/dialogue/continue": {
      "post": {
        "operationId": "dialogue.continue",
        "summary": "dialogue.continue",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "dialogue.continue",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/dialogue/select": {
      "post": {
        "operationId": "dialogue.select",
        "summary": "dialogue.select",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "dialogue.select",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/dialogue/amount": {
      "post": {
        "operationId": "dialogue.amount",
        "summary": "dialogue.amount",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "dialogue.amount",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/dialogue/text": {
      "post": {
        "operationId": "dialogue.text",
        "summary": "dialogue.text",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "dialogue.text",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/use-item/item": {
      "post": {
        "operationId": "use-item.item",
        "summary": "use-item.item; requires visible Inventory tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "use-item.item",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/use-item/npc": {
      "post": {
        "operationId": "use-item.npc",
        "summary": "use-item.npc; requires visible Inventory tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "use-item.npc",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/use-item/object": {
      "post": {
        "operationId": "use-item.object",
        "summary": "use-item.object; requires visible Inventory tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "use-item.object",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/use-item/ground-item": {
      "post": {
        "operationId": "use-item.ground-item",
        "summary": "use-item.ground-item; requires visible Inventory tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "use-item.ground-item",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/ge/open": {
      "post": {
        "operationId": "ge.open",
        "summary": "ge.open",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "ge.open",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/ge/close": {
      "post": {
        "operationId": "ge.close",
        "summary": "ge.close",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "ge.close",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/ge/collect": {
      "post": {
        "operationId": "ge.collect",
        "summary": "ge.collect",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "ge.collect",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/ge/cancel": {
      "post": {
        "operationId": "ge.cancel",
        "summary": "ge.cancel",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "ge.cancel",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/shop/buy": {
      "post": {
        "operationId": "shop.buy",
        "summary": "shop.buy",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "shop.buy",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/trade/accept": {
      "post": {
        "operationId": "trade.accept",
        "summary": "trade.accept",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "trade.accept",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/trade/decline": {
      "post": {
        "operationId": "trade.decline",
        "summary": "trade.decline",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "trade.decline",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/trade/offer": {
      "post": {
        "operationId": "trade.offer",
        "summary": "trade.offer",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "trade.offer",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/equipment/equip": {
      "post": {
        "operationId": "equipment.equip",
        "summary": "equipment.equip; requires visible Inventory tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "equipment.equip",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/equipment/unequip": {
      "post": {
        "operationId": "equipment.unequip",
        "summary": "equipment.unequip; requires visible Equipment tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "equipment.unequip",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/prayer/set": {
      "post": {
        "operationId": "prayer.set",
        "summary": "prayer.set; state changes require visible Prayer tab and never open it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "prayer.set",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/prayer/set-only": {
      "post": {
        "operationId": "prayer.set-only",
        "summary": "prayer.set-only; state changes require visible Prayer tab and never open it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "prayer.set-only",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/prayer/disable-all": {
      "post": {
        "operationId": "prayer.disable-all",
        "summary": "prayer.disable-all; state changes require visible Prayer tab and never open it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "prayer.disable-all",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/prayer/quick-toggle": {
      "post": {
        "operationId": "prayer.quick-toggle",
        "summary": "prayer.quick-toggle",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "prayer.quick-toggle",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/prayer/quick-open": {
      "post": {
        "operationId": "prayer.quick-open",
        "summary": "prayer.quick-open",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "prayer.quick-open",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/prayer/quick-set": {
      "post": {
        "operationId": "prayer.quick-set",
        "summary": "prayer.quick-set",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "prayer.quick-set",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/magic/cast": {
      "post": {
        "operationId": "magic.cast",
        "summary": "magic.cast; requires visible Magic tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "magic.cast",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/magic/select": {
      "post": {
        "operationId": "magic.select",
        "summary": "magic.select; requires visible Magic tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "magic.select",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/magic/deselect": {
      "post": {
        "operationId": "magic.deselect",
        "summary": "magic.deselect; requires visible Magic tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "magic.deselect",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/combat/toggle-spec": {
      "post": {
        "operationId": "combat.toggle-spec",
        "summary": "combat.toggle-spec",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "combat.toggle-spec",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/combat/set-attack-style": {
      "post": {
        "operationId": "combat.set-attack-style",
        "summary": "combat.set-attack-style; requires visible Combat tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "combat.set-attack-style",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/combat/auto-retaliate": {
      "post": {
        "operationId": "combat.auto-retaliate",
        "summary": "combat.auto-retaliate; requires visible Combat tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "combat.auto-retaliate",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/tab/open": {
      "post": {
        "operationId": "tab.open",
        "summary": "tab.open",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "tab.open",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/production/choose": {
      "post": {
        "operationId": "production.choose",
        "summary": "production.choose",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "production.choose",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/production/quantity": {
      "post": {
        "operationId": "production.quantity",
        "summary": "production.quantity",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "production.quantity",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/production/amount": {
      "post": {
        "operationId": "production.amount",
        "summary": "production.amount",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "production.amount",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/transport/travel": {
      "post": {
        "operationId": "transport.travel",
        "summary": "transport.travel",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "transport.travel",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/deposit-box/deposit-all": {
      "post": {
        "operationId": "deposit-box.deposit-all",
        "summary": "deposit-box.deposit-all",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "deposit-box.deposit-all",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/deposit-box/deposit-equipment": {
      "post": {
        "operationId": "deposit-box.deposit-equipment",
        "summary": "deposit-box.deposit-equipment",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "deposit-box.deposit-equipment",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/deposit-box/deposit": {
      "post": {
        "operationId": "deposit-box.deposit",
        "summary": "deposit-box.deposit",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "deposit-box.deposit",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/deposit-box/close": {
      "post": {
        "operationId": "deposit-box.close",
        "summary": "deposit-box.close",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "deposit-box.close",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/bank-inventory/deposit": {
      "post": {
        "operationId": "bank-inventory.deposit",
        "summary": "bank-inventory.deposit",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "bank-inventory.deposit",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/bank-worn-equipment/deposit-all": {
      "post": {
        "operationId": "bank-worn-equipment.deposit-all",
        "summary": "bank-worn-equipment.deposit-all",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "bank-worn-equipment.deposit-all",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/drop-pattern": {
      "post": {
        "operationId": "drop-pattern",
        "summary": "drop-pattern; requires visible Inventory tab and never opens it implicitly",
        "x-n3-access": "WRITE",
        "x-n3-permission": "mutate",
        "x-n3-cost": "NORMAL",
        "x-n3-handler-key": "drop-pattern",
        "responses": {
          "default": {
            "description": "Agent Server response"
          }
        }
      }
    },
    "/api/v1/operations/{id}": {
      "get": {
        "operationId": "operation.status",
        "summary": "Get sanitized idempotent operation record",
        "x-n3-access": "READ",
        "responses": {
          "200": {
            "description": "Operation record"
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "operationId": "mcp.streamableHttp",
        "summary": "Direct MCP Streamable HTTP",
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          },
          "202": {
            "description": "Accepted notification"
          }
        }
      }
    }
  }
}