Block Protocol Packages

We’ve published a range of packages for folks developing Block Protocol blocks and applications. These include two major utilities:

• Mock Block Dock (mock-block-dock): a lightweight environment and mock datastore for developing and testing Block Protocol blocks.
• Create Block App (create-block-app): a command-line utility to help you quickly create the scaffolding required for new Block Protocol blocks, using our block-template.

Developer Microsite: hash.dev

We’ve launched a dedicated site for developers working with HASH, HASH Engine, and the Block Protocol.

The homepage provides an overview of our projects, and how they fit together, while the HASH Developer Blog will contain our developer-facing news and announcements going forward.

We’ll be adding reference guides and tutorials for engineers working with the Block Protocol and HASH’s other projects to the hash.dev site soon.

Create schemas from the Block Protocol Hub

A lightweight version of the schema editor from our open-source HASH workspace software has been made available via the Block Protocol website. While this was already available to folks self-hosting HASH, it was not yet available hosted online.

Using the schema editor, properties of entity types can be individually defined as well as linked or ‘crosswalked’ to their equivalents in other schemas to make them interpretable as RDF or JSON-LD. For example, a firstName field might be linked to its schema.org equivalent of givenName (https://schema.org/givenName).

Schemas created through the Block Protocol Hub will be hosted in perpetuity at an immutable permalink provided at the point of creation, and accessible via your Block Protocol user profile page. To view your schemas as raw JSON instead of as web pages, request the URLs with application/json in an “Accept” HTTP header.

HASH pre-release

We’ve published the code behind our forthcoming HASH workspace application under the open-source AGPL license.

You can find this within the hash package of the HASH public monorepo. It is currently in pre-release and we welcome early feedback.

Block Protocol API keys

You can now create an account on the Block Protocol website and generate an API key. If you already have a hosted HASH user account, your namespace on the Block Protocol site has been reserved. Simply enter the same email address you used to sign up for hash.ai to claim this.

API keys are usable by embedding applications who want to search the Block Protocol Hub for blocks (or allow their users to do the same). Further down the line you’ll also be able to publish and update blocks listed on the Block Protocol Hub using your API key.

Open-source blocks

We’ve open-sourced an initial set of blocks under the MIT license. Although basic, these give a sense for the types of things we expect users to build. You can find them in the blocks package within the HASH public monorepo on GitHub.

Block Protocol specification

We’ve published the draft specification of the Block Protocol at blockprotocol.org/spec alongside an implementation guide for application maintainers wishing to support the standard, and a developer guide for block creators interested in contributing new blocks to the ecosystem. We’ll be evolving the standard a lot in the coming weeks in response to feedback. To read more about the Block Protocol, and why we’re building it, check out our recent Block Protocol announcement.

The public hEngine is here

We have published the code at the heart of HASH simulations: you can view hEngine, the open computational engine, in this public repository. This is an alpha-stage product under active development, made available to allow developers and interested parties to explore and provide feedback on the code.

By making our simulation engine public we are delivering on several key principles:

• flexibility: you can run simulations in your own environment, using your own editor, and feed data to and from the engine in any way you please
• transparency: the inner workings of our simulation engine are free to inspect, to debate, and to improve
• extensibility: by making the code public we enable and encourage you to extend it or modify it to meet your own needs (subject to the Server Side Public License)
• portability: when you build HASH simulations, there’s no risk of platform lock-in: you’re not reliant on us, and can self-host at any time

We will now be working towards a first formal release, shipping a number of improvements and exciting new features in the weeks to come. We’d love for you to get involved, whether through contributing, raising issues, or getting in touch to share feedback and feature requests. 

Download projects from hCore

You can start using your existing projects with the open engine straight away, by exporting a project’s files and dependencies from hCore. This allows it to be downloaded for local use with hEngine, and enables you to backup your simulation code and data offline.

To do this, open up the File menubar and hit the Export Project button.

Coming soon: We’ll be introducing the ability to upload simulation project files to HASH, enabling seamless transition between developing on your machine and running simulations in-browser (in hCore) and at scale (with hCloud).

Waypoint Navigation Library

Using the new waypoint navigation library, agents will move towards their next waypoint until they are close enough to receive their next destination. Once agents have reached the waypoint closest to their final destination, they navigate directly to the location. This allows for manual or assisted creation of realistic and efficient agent movement paths around obstacles.

Simulation School

We’re launching Simulation School to complement our existing HASH Docs. Simulation School takes a topic-based approach teaching you how to use and apply simulation models in the real-world.

Our first course delves into computational economics and introduces users to five basic agent-based models, explaining step-by-step how to use those models in HASH.

We’re releasing two new simulation templates that make it easy to use your data to generate realistic models.

Modern Warehouse

Modern Warehouse: A simulation template for generating a warehouse with realistic proportions and picking operations. Forklifts move between the racks and crates picking up orders following a series of waypoints that determine their routes. Forklifts will orient to the nearest waypoint and make sensible decisions to get to their pickup and delivery location.

Cloud Infrastructure

Cloud Infrastructure: A simulation template for creating representations of cloud infrastructure with Terraform. Using either a terraform file or manual specification, the simulation generates a model of a Kubernetes cluster with requests coming in from real request data or estimated distributions.

Run bigger, longer simulations with better memory handling in hCore

By default, hCore retains all the state data from each step in a simulation. This limits how long you can run a sim for, as the state data eventually uses all the available memory.

We’ve introduced an option to retain only the most recent data – for any number of steps you choose – allowing sims to run with a much, much lower memory footprint.

Analysis can still be computed for the entire run by watching the analysis tab as the sim is computing.

Memory efficiency has also been improved elsewhere, most significantly by plugging a memory leak in the 3D viewer, which overall leads to memory use around a third of that previous for typical simulations, even when retaining all step data.

Export CSV of your analysis to inspect elsewhere

Until now, analysis metrics could only be exported as JSON, requiring further transformation in order to use this data in traditional spreadsheet-based software like Excel or Google Sheets.

Metrics can now additionally be downloaded as a structured CSV file for direct easy import into third-party applications, allowing you to complement in-IDE analysis with your other favourite tools.

To download simulation state and analysis data, right click on a run in the activity history, and click ‘Export run data’.

Quality of life improvements

This week we’ve shipped a bunch of smaller changes that improve platform quality of life.

• You can now use markdown in your simulation release notes to improve their readability
• Simulation models using the HASH process modeling library now run far more smoothly in hCloud
• Default settings for certain built-in 3D meshes have been improved

We squashed a ton of bugs, including a couple of notable nasties:

• Fixed a rare bug that could cause optimization experiments to fail and prematurely exit under certain circumstances
• Fixed a regression that meant line numbers for errors and warnings could appear off-by-one in the hCore Console when running Python behaviors client-side
• Fixed an issue that could cause activity for projects with extremely long histories to sometimes fail to load

We’ve also moved the HASH glossary into our open-source monorepo, so you can add pages or edit definitions directly. Feel free to check out our contributor guidelines and open up a Pull Request! We’ve also migrated our docs away from GitBook and into a new unified learn HASH website.