improve: add depth param

[cavramoniu-ionos]

Summary

• Added depth optional parameter to cloudapi-v6 tools (compute and k8s)
• Updated docs for all affected tools

[Copilot]

Pull request overview

This PR adds an optional depth parameter to CloudAPI v6 MCP tools (Compute + Managed Kubernetes) so callers can control the nesting depth of returned objects, and updates routing tests/docs to reflect the new query parameter behavior.

Changes:

• Added Depth *int32 to relevant tool input structs (and introduced new List*Input types for list tools that previously used struct{}).
• Updated Compute + K8s tool handlers to pass depth through to the SDK request builders (defaulting list operations to depth=1).
• Updated endpoint routing tests to assert depth=1 is sent for list operations; updated multiple docs pages (with some remaining gaps noted in PR comments).

Reviewed changes

Copilot reviewed 50 out of 50 changed files in this pull request and generated 18 comments.

Show a summary per file

File	Description
tools/k8s/nodepool.go	Adds depth support to list/get nodepool calls.
tools/k8s/node.go	Adds depth support to list/get node calls.
tools/k8s/cluster.go	Adds depth support to list/get cluster calls (list defaults to 1).
tools/inputs.go	Extends input schemas with optional depth and introduces new List*Input structs.
tools/compute/volume.go	Adds depth support to list/get volume calls (list defaults to 1).
tools/compute/template.go	Adds depth support to list/get template calls (list defaults to 1).
tools/compute/target_group.go	Adds depth support to list/get target group calls (list defaults to 1).
tools/compute/snapshot.go	Adds depth support to list/get snapshot calls (list defaults to 1).
tools/compute/server.go	Adds depth support to server + server-subresource tools (lists default to 1).
tools/compute/security_group.go	Adds depth support to security group + rules tools (lists default to 1).
tools/compute/request.go	Adds depth support to request tools (list defaults to 1).
tools/compute/private_cross_connect.go	Adds depth support to PCC tools (list defaults to 1).
tools/compute/nic.go	Adds depth support to NIC tools (list defaults to 1).
tools/compute/network_loadbalancer.go	Adds depth support to NLB + forwarding rules tools (lists default to 1).
tools/compute/nat_gateway.go	Adds depth support to NAT gateway + rules tools (lists default to 1).
tools/compute/location.go	Adds depth support to location listing (defaults to 1).
tools/compute/loadbalancer.go	Adds depth support to LB + balanced NICs tools (lists default to 1).
tools/compute/lan.go	Adds depth support to LAN + LAN NICs tools (lists default to 1).
tools/compute/ip_block.go	Adds depth support to IP block tools (list defaults to 1).
tools/compute/image.go	Adds depth support to image listing (defaults to 1).
tools/compute/firewall_rule.go	Adds depth support to firewall rule tools (list defaults to 1).
tools/compute/datacenter.go	Adds depth support to datacenter tools (list defaults to 1) and updates tool description.
tools/compute/contract.go	Adds optional depth support to get_contract.
tools/compute/application_loadbalancer.go	Adds depth support to ALB + forwarding rules tools (lists default to 1).
test/k8s_test.go	Asserts depth=1 query param for affected K8s list tools.
test/compute_test.go	Asserts depth=1 query param for affected Compute list tools.
docs/k8s/nodepool.md	Documents depth for list_k8s_nodepools.
docs/k8s/node.md	Documents depth for node list/get tools.
docs/k8s/cluster.md	Documents depth for list_k8s_clusters.
docs/compute/volume.md	Documents depth for volume list/get tools.
docs/compute/template.md	Documents depth for get_template.
docs/compute/target-group.md	Documents depth for get_target_group.
docs/compute/snapshot.md	Documents depth for snapshot list/get tools.
docs/compute/server.md	Documents depth for list_servers.
docs/compute/server-subresources.md	Documents depth for get_server_gpu and get_server_remote_console.
docs/compute/security-group.md	Documents depth for list_security_groups and get_security_group_rule.
docs/compute/request.md	Documents depth for get_request and get_request_status.
docs/compute/private-cross-connect.md	Documents depth for get_private_cross_connect.
docs/compute/nic.md	Documents depth for list_nics.
docs/compute/network-loadbalancer.md	Documents depth for list_network_loadbalancers.
docs/compute/nat-gateway.md	Documents depth for list_nat_gateways.
docs/compute/location.md	Documents depth for list_locations.
docs/compute/loadbalancer.md	Documents depth for list_loadbalancers.
docs/compute/lan.md	Documents depth for list_lans.
docs/compute/ip-block.md	Documents depth for get_ip_block.
docs/compute/image.md	Documents depth for list_images.
docs/compute/firewall-rule.md	Documents depth for firewall rule list/get tools.
docs/compute/datacenter.md	Documents depth for list_datacenters.
docs/compute/contract.md	Documents depth for get_contract.
docs/compute/application-loadbalancer.md	Documents depth for list_application_loadbalancers.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 66 out of 66 changed files in this pull request and generated 3 comments.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Pull request overview

Copilot reviewed 51 out of 51 changed files in this pull request and generated 10 comments.

[avirtopeanu-ionos]

Nice work, can you also add to the CHANGELOG.md ?