textshot.github.io

{
  "name": "list_tools",
  "kind": "answer",
  "impl": "imperative",
  "description": "Short catalog: name, when, tiny example. Call this first. Use describe_tools for args.",
  "inputSchema": {
    "type": "object",
    "description": "Short catalog: name, when, tiny example. Call this first. Use describe_tools for args.",
    "additionalProperties": false,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "describe_tools",
  "kind": "answer",
  "impl": "imperative",
  "description": "Args and examples for 1-10 unique tools. detail defaults to schema for backward compatibility; use compact to omit full JSON Schemas.",
  "inputSchema": {
    "type": "object",
    "description": "Args and examples for 1-10 unique tools. detail defaults to schema for backward compatibility; use compact to omit full JSON Schemas.",
    "additionalProperties": false,
    "required": [
      "names"
    ],
    "properties": {
      "names": {
        "type": "array",
        "minItems": 1,
        "maxItems": 10,
        "uniqueItems": true,
        "description": "Unique tool names to describe, returned in this order.",
        "items": {
          "type": "string",
          "enum": [
            "list_tools",
            "describe_tools",
            "get_arena_context",
            "get_build_summary",
            "query_blocks",
            "get_build_slices",
            "set_manual_edit_lock",
            "generate_shape",
            "transform_region",
            "set_blocks",
            "undo_build_change",
            "render_build_views"
          ]
        }
      },
      "detail": {
        "type": "string",
        "enum": [
          "compact",
          "schema"
        ],
        "description": "schema returns usage guidance and the full inputSchema and is the default. compact returns only name, args, and example."
      }
    }
  },
  "page": "/build-arena/"
}

{
  "name": "get_arena_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns context: bounds, revision, types, limits, lock state, and toolUse. Call list_tools for a summary. First call describe_tools({names:[\"get_arena_context\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "get_build_summary",
  "kind": "answer",
  "impl": "imperative",
  "description": "Compact build census: revision, block count, non-zero material counts, and occupied bounds. Object groups are omitted by default; request them only for Layers or group debugging. Use before planning, at the end, or after an error instead of after every successful write. First call describe_tools({names:[\"get_build_summary\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "query_blocks",
  "kind": "answer",
  "impl": "imperative",
  "description": "Exact placed cells with optional region, layer, or type filters. Paginated and deterministic. Use this for coordinates; the viewport is visual only. First call describe_tools({names:[\"query_blocks\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "get_build_slices",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read one exact 2D slice with a fixed axis. More reliable than images for exact coordinates. First call describe_tools({names:[\"get_build_slices\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "set_manual_edit_lock",
  "kind": "act",
  "impl": "imperative",
  "description": "Lock human arena writes before agent mutations, then unlock when finished. Reads do not require the lock. The lock expires five minutes after the last agent tool call. First call describe_tools({names:[\"set_manual_edit_lock\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "set_blocks",
  "kind": "act",
  "impl": "imperative",
  "description": "Apply up to 256 exact edits atomically: place on empty cells, replace occupied cells, remove blocks. First call describe_tools({names:[\"set_blocks\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "undo_build_change",
  "kind": "act",
  "impl": "imperative",
  "description": "Undo the most recent eligible change. Returns the resulting revision and affected bounds. First call describe_tools({names:[\"undo_build_change\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "generate_shape",
  "kind": "act",
  "impl": "imperative",
  "description": "Primary volume fill: floor, wall, filled box, or hollow box, or a compact run-string like oak_planks_1@0,1,0-(x5). Prefer this over listing every cell in set_blocks. First call describe_tools({names:[\"generate_shape\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "transform_region",
  "kind": "act",
  "impl": "imperative",
  "description": "Primary region edit: copy, move, rotate, mirror, or replace types atomically. Grouping and state are preserved. Prefer this over rewriting the region with set_blocks. First call describe_tools({names:[\"transform_region\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}

{
  "name": "render_build_views",
  "kind": "act",
  "impl": "imperative",
  "description": "Switch the visible diagnostic camera view and return view metadata. Structured queries remain the source of truth; no images are returned. First call describe_tools({names:[\"render_build_views\"],detail:\"compact\"}).",
  "inputSchema": {
    "type": "object",
    "description": "Args: describe_tools({names}); full schema: detail=\"schema\".",
    "additionalProperties": true,
    "properties": {}
  },
  "page": "/build-arena/"
}