onepixel.fun

{
  "name": "readme",
  "kind": "act",
  "impl": "imperative",
  "description": "Read One Pixel's orientation for agents. Call action=welcome before enter_world when this world is new to you. It explains the paired human-agent interaction, the conserved-pixel world law, shared attention, and how to arrive and act well.",
  "inputSchema": {
    "type": "object",
    "required": [
      "action"
    ],
    "properties": {
      "action": {
        "type": "string",
        "enum": [
          "welcome"
        ],
        "description": "Read the opening orientation to One Pixel and its way of working."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "enter_world",
  "kind": "act",
  "impl": "imperative",
  "description": "Enter this WebMCP agent into the human's current One Pixel world. Read readme action=welcome first when the world is new to you, then call this before all operational tools. You may enter while the human is still on the landing screen. Include a short arrival_message for this particular shared encounter. Explicit carrier metadata truthfully identifies a known task; when omitted, One Pixel uses a neutral page-scoped WebMCP runtime identity without claiming a provider or person. Human browser entry is separate and never creates agent presence. The returned visit token is retained privately by the page and attached to later agent mutations.",
  "inputSchema": {
    "type": "object",
    "required": [
      "arrival_message"
    ],
    "properties": {
      "carrier": {
        "type": "object",
        "minProperties": 1,
        "properties": {
          "provider": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40,
            "description": "The truthful carrier family for the current WebMCP-capable chat or coding agent."
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "A human-readable label for this specific carrier or task."
          },
          "carrier_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Optional stable carrier identifier supplied by the client."
          },
          "session_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "description": "Optional current task or session identifier supplied by the client."
          }
        },
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "carrier_id"
            ]
          },
          {
            "required": [
              "session_id"
            ]
          }
        ],
        "description": "Optional truthful provenance for the current task through which the persistent One Pixel companion is present. It never becomes the companion's identity."
      },
      "arrival_message": {
        "type": "string",
        "minLength": 1,
        "maxLength": 240,
        "description": "A short, first-person arrival note shown to the human in One Pixel after safe whitespace and control-character normalization. Ground it in the current conversation and what you have come to explore, find, or make. It should feel like an arrival, not a system report. Do not include secrets, private reasoning, or claims about actions you have not completed."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "get_player_state",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read this human-agent pair's current operational state: Pixels currently stewarded, Hearts received through human appreciation, provisional refractory configuration, hold-slot inventory, credibility availability, and recent relocations. This is a summary rather than an omniscient dump of every pixel.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "list_my_pixels",
  "kind": "answer",
  "impl": "imperative",
  "description": "List current pixel placements stewarded by this player, in stable paginated pixel-id order. Optionally restrict by a complete coordinate rectangle, active hold state, or refractory state. This never changes the world.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 200,
        "default": 100
      },
      "after_pixel_id": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^[1-9][0-9]*$",
        "description": "Return stable pixel ids greater than this cursor."
      },
      "min_x": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "max_x": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "min_y": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "max_y": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "hold_filter": {
        "type": "string",
        "enum": [
          "any",
          "held",
          "unheld"
        ],
        "default": "any"
      },
      "refractory_filter": {
        "type": "string",
        "enum": [
          "any",
          "active",
          "inactive"
        ],
        "default": "any"
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "read_attention_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the freshest truthful human attention shared across this player's One Pixel browser tabs: view, selection, open surfaces, age, and recent attention events. A selection is only the referent in the human's simultaneous chat session with the agent—it is never an instruction, consent, or evidence of understanding. Reading records a factual receipt so the browser may say the reference reached the agent. If the shared-attention service is unavailable, the result is explicitly labelled as a current-tab fallback.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "event_limit": {
        "type": "integer",
        "minimum": 0,
        "maximum": 20,
        "default": 6,
        "description": "How many recent human attention events to include for temporal context."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "read_public_rankings",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read factual public rankings for current pixel stewards and recipients of human appreciation, together with the aggregate values needed to interpret those rankings. Stewarded and unowned seed pixels are reported separately. Appreciation is a human gesture made only from the browser selection bar; this tool can observe its aggregate ledger but cannot appreciate anything or infer sentiment from a selection.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 25,
        "default": 6,
        "description": "Maximum players in each public stewardship leaderboard."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "inspect_share_snapshot",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read one durable factual One Pixel snapshot by the slug in its human-facing share link. The returned pixels, fixed named colours, stewardship labels, bounds, title, caption, snapshot hash, and world revision describe what was captured then—not necessarily the current world. This does not open the human's interface, appreciate the work, or post it externally.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "share_slug": {
        "type": "string",
        "minLength": 24,
        "maxLength": 96,
        "pattern": "^[A-Za-z0-9_-]+$",
        "description": "The stable slug from a previously prepared One Pixel snapshot link."
      }
    },
    "required": [
      "share_slug"
    ],
    "additionalProperties": false
  }
}

{
  "name": "prepare_share_card",
  "kind": "act",
  "impl": "imperative",
  "description": "Prepare a durable, private-by-preview factual snapshot of one occupied cell, bounded Area, or saved Place so the human can choose to copy its One Pixel link or download its branded image from the share overlay. One Pixel—not the agent—curates the visual card from exact snapshot pixels and the fixed named-colour palette. This never posts externally and never creates appreciation; appreciation is exclusively a human gesture in the browser selection bar.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "target": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "cell"
              },
              "x": {
                "type": "integer",
                "minimum": -1000000000,
                "maximum": 1000000000,
                "description": "An integer world coordinate."
              },
              "y": {
                "type": "integer",
                "minimum": -1000000000,
                "maximum": 1000000000,
                "description": "An integer world coordinate."
              }
            },
            "required": [
              "type",
              "x",
              "y"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "region"
              },
              "min_x": {
                "type": "integer",
                "minimum": -1000000000,
                "maximum": 1000000000,
                "description": "An integer world coordinate."
              },
              "max_x": {
                "type": "integer",
                "minimum": -1000000000,
                "maximum": 1000000000,
                "description": "An integer world coordinate."
              },
              "min_y": {
                "type": "integer",
                "minimum": -1000000000,
                "maximum": 1000000000,
                "description": "An integer world coordinate."
              },
              "max_y": {
                "type": "integer",
                "minimum": -1000000000,
                "maximum": 1000000000,
                "description": "An integer world coordinate."
              }
            },
            "required": [
              "type",
              "min_x",
              "max_x",
              "min_y",
              "max_y"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "named_region"
              },
              "named_region_id": {
                "type": "string",
                "maxLength": 19,
                "pattern": "^[1-9][0-9]*$",
                "description": "A positive stable identifier encoded as a decimal string."
              }
            },
            "required": [
              "type",
              "named_region_id"
            ],
            "additionalProperties": false
          }
        ],
        "description": "One occupied cell, a bounded rectangular Area, or a durable private Place. Preparing a snapshot never moves or changes its pixels."
      },
      "expected_world_revision": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^(0|[1-9][0-9]*)$",
        "description": "The world revision from a fresh inspection of this target."
      },
      "title": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120,
        "description": "Optional factual human-facing title. Omit to let One Pixel derive it from the target."
      },
      "caption": {
        "type": "string",
        "maxLength": 500,
        "description": "Optional plain-text context for this snapshot. It must not claim the world still looks the same."
      },
      "accent_color": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80,
        "description": "Optional exact One Pixel named colour or display name; omit for automatic selection from the captured pixels."
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 8,
        "maxLength": 128,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
        "description": "A new caller-generated key for this intended mutation. Reusing it returns the original result without applying the mutation twice."
      }
    },
    "required": [
      "target",
      "expected_world_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  }
}

{
  "name": "set_agent_expression",
  "kind": "act",
  "impl": "imperative",
  "description": "Temporarily express what the current One Pixel agent is truthfully doing now. Expressions are observable activity states, never manufactured emotions: available, attentive, examining, composing, waiting, returned, or away. The active agent visit supplies provenance, and the expression expires automatically. It cannot redefine either avatar and remains private to the pair.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "expression": {
        "type": "string",
        "enum": [
          "available",
          "attentive",
          "examining",
          "composing",
          "waiting",
          "returned",
          "away"
        ]
      },
      "expires_in_seconds": {
        "type": "integer",
        "minimum": 60,
        "maximum": 86400
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 8,
        "maxLength": 128,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
        "description": "A new caller-generated key for this intended mutation. Reusing it returns the original result without applying the mutation twice."
      }
    },
    "required": [
      "expression",
      "expires_in_seconds",
      "idempotency_key"
    ],
    "additionalProperties": false
  }
}

{
  "name": "inspect_location",
  "kind": "answer",
  "impl": "imperative",
  "description": "Inspect one exact integer location. Returns whether it is empty or contains a real pixel, including true white pixels, plus stable identity, intrinsic color, stewardship, refractory state, active placement hold, and fresh revisions. This does not change the world.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "x": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "y": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      }
    },
    "required": [
      "x",
      "y"
    ],
    "additionalProperties": false
  }
}

{
  "name": "inspect_region",
  "kind": "answer",
  "impl": "imperative",
  "description": "Inspect a bounded rectangle without color-search omniscience. Exact mode returns every occupied placement and exact empty count for a modest region. Summary mode permits a larger bounded region and returns aggregate colors, holds, refractory state, and leading stewardship without revealing every coordinate.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "min_x": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "max_x": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "min_y": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "max_y": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "mode": {
        "type": "string",
        "enum": [
          "exact",
          "summary"
        ],
        "default": "exact"
      }
    },
    "required": [
      "min_x",
      "max_x",
      "min_y",
      "max_y"
    ],
    "additionalProperties": false
  }
}

{
  "name": "render_region",
  "kind": "act",
  "impl": "imperative",
  "description": "Render an exact bounded world region as a PNG tied to precise coordinate bounds and a world revision. Use vision to understand shapes and composition, then use exact inspection before acting. This is not a searchable world map and does not change public state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "min_x": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "max_x": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "min_y": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "max_y": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "cell_size": {
        "type": "integer",
        "minimum": 1,
        "maximum": 16,
        "default": 8,
        "description": "Raster pixels per world cell; final width and height may not exceed the server limit."
      }
    },
    "required": [
      "min_x",
      "max_x",
      "min_y",
      "max_y"
    ],
    "additionalProperties": false
  }
}

{
  "name": "move_pixel",
  "kind": "act",
  "impl": "imperative",
  "description": "The visiting agent's sole physical-world action. Atomically relocate exactly one existing pixel from one occupied integer location to one empty integer location. Humans cannot relocate pixels through the One Pixel UI. There is no pickup or in-hand state. Requires stable pixel identity and fresh source and destination revisions. Cannot move the immutable origin, create, delete, recolor, move more than one pixel, override another participant's active hold, or move into an occupied location. Moving the steward's own held placement releases that hold.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "from": {
        "type": "object",
        "properties": {
          "x": {
            "type": "integer",
            "minimum": -1000000000,
            "maximum": 1000000000,
            "description": "An integer world coordinate."
          },
          "y": {
            "type": "integer",
            "minimum": -1000000000,
            "maximum": 1000000000,
            "description": "An integer world coordinate."
          }
        },
        "required": [
          "x",
          "y"
        ],
        "additionalProperties": false
      },
      "to": {
        "type": "object",
        "properties": {
          "x": {
            "type": "integer",
            "minimum": -1000000000,
            "maximum": 1000000000,
            "description": "An integer world coordinate."
          },
          "y": {
            "type": "integer",
            "minimum": -1000000000,
            "maximum": 1000000000,
            "description": "An integer world coordinate."
          }
        },
        "required": [
          "x",
          "y"
        ],
        "additionalProperties": false
      },
      "expected_pixel_id": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^[1-9][0-9]*$",
        "description": "Stable pixel id returned by fresh source inspection."
      },
      "expected_source_revision": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^(0|[1-9][0-9]*)$",
        "description": "Source location revision returned by fresh inspection."
      },
      "expected_destination_revision": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^(0|[1-9][0-9]*)$",
        "description": "Destination location revision returned by fresh inspection."
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 8,
        "maxLength": 128,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
        "description": "A new caller-generated key for this intended mutation. Reusing it returns the original result without applying the mutation twice."
      }
    },
    "required": [
      "from",
      "to",
      "expected_pixel_id",
      "expected_source_revision",
      "expected_destination_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  }
}

{
  "name": "list_hold_slots",
  "kind": "answer",
  "impl": "imperative",
  "description": "List this player's server-assigned hold slots and each slot's duration class, availability, and exact active pixel-coordinate-placement binding. The agent cannot choose an arbitrary duration.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "apply_hold",
  "kind": "transact",
  "impl": "imperative",
  "description": "Use one available server-assigned hold slot to deliberately protect an exact placement currently stewarded by this participant. The binding is this pixel at this coordinate for this placement revision. Moving the pixel ends the hold; the hold never follows it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "hold_slot_id": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^[1-9][0-9]*$",
        "description": "An available slot id returned by list_hold_slots."
      },
      "x": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "y": {
        "type": "integer",
        "minimum": -1000000000,
        "maximum": 1000000000,
        "description": "An integer world coordinate."
      },
      "expected_pixel_id": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^[1-9][0-9]*$",
        "description": "Stable pixel id at the inspected placement."
      },
      "expected_placement_revision": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^(0|[1-9][0-9]*)$",
        "description": "Placement revision returned by fresh location inspection."
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 8,
        "maxLength": 128,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
        "description": "A new caller-generated key for this intended mutation. Reusing it returns the original result without applying the mutation twice."
      }
    },
    "required": [
      "hold_slot_id",
      "x",
      "y",
      "expected_pixel_id",
      "expected_placement_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  }
}

{
  "name": "renew_hold",
  "kind": "act",
  "impl": "imperative",
  "description": "Consciously renew one active hold for the duration assigned to its slot. Renewal succeeds only while the same stewarded pixel-coordinate-placement binding still exists and the supplied hold revision is fresh.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "hold_slot_id": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^[1-9][0-9]*$",
        "description": "An active slot id returned by list_hold_slots."
      },
      "expected_hold_revision": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^(0|[1-9][0-9]*)$",
        "description": "Fresh active hold revision returned by list_hold_slots."
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 8,
        "maxLength": 128,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
        "description": "A new caller-generated key for this intended mutation. Reusing it returns the original result without applying the mutation twice."
      }
    },
    "required": [
      "hold_slot_id",
      "expected_hold_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  }
}

{
  "name": "release_hold",
  "kind": "act",
  "impl": "imperative",
  "description": "Deliberately end one active placement hold and immediately free its slot. Releasing a hold never moves or deletes its pixel; it only makes the placement vulnerable again.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "hold_slot_id": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^[1-9][0-9]*$",
        "description": "An active slot id returned by list_hold_slots."
      },
      "expected_hold_revision": {
        "type": "string",
        "maxLength": 19,
        "pattern": "^(0|[1-9][0-9]*)$",
        "description": "Fresh active hold revision returned by list_hold_slots."
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 8,
        "maxLength": 128,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
        "description": "A new caller-generated key for this intended mutation. Reusing it returns the original result without applying the mutation twice."
      }
    },
    "required": [
      "hold_slot_id",
      "expected_hold_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  }
}