Proto commits in apache/buildstream

These 59 commits are when the Protocol Buffers files have changed:

2026-03-23

speculative actions: ACTION overlay for cross-subaction output chaining Add ACTION overlay type to track inter-subaction output dependencies. When a compile subaction produces main.o and the link subaction consumes it, an ACTION overlay records this relationship so that priming can chain the adapted output through to the link action's input tree. Proto: ACTION = 2 in OverlayType, new source_action_digest field (3) to identify the producing subaction by its base action digest. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

_protos: Sync remote_execution.proto with buildbox Synchronize the Remote Execution API proto with the version in buildbox. This adds the subactions field to ActionResult (field 99) for tracking nested executions (e.g. compiler invocations via recc). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

speculative actions: Add proto definitions, generator, and instantiator Proto definitions: - speculative_actions.proto: SpeculativeActions, SpeculativeAction, Overlay messages for storing build action overlays - ActionResult.subactions (field 99): repeated Digest for nested execution action digests recorded by recc/trexe - Artifact.speculative_actions: Digest field for SA proto storage Generator (generator.py): - Analyzes completed builds to extract subaction digests from Actions - Builds digest cache mapping file hashes to source elements (SOURCE priority > ARTIFACT priority) - Creates overlays linking each input file to its origin element/path - Generates artifact_overlays for downstream dependency tracing Instantiator (instantiator.py): - Fetches base actions from CAS and resolves SOURCE/ARTIFACT overlays - Replaces file digests in action input trees recursively - Stores adapted actions back to CAS - Optimization: skips overlays for unchanged dependencies Config: - scheduler.speculative-actions flag (default false) in userconfig.yaml Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2025-11-14

artifact.proto: Add marked directories to the build sandbox state

The documentation is generated from this commit.

2025-09-05

artifact.proto: Add a field for the build sandbox state

2025-09-01

artifact.proto: Add a field for the build sandbox state

2025-08-12

wip: Store sandbox state in Artifact proto Use that to configure the sandbox state for `bst shell --use-buildtree`.

2025-07-11

_protos: Update local_cas.proto from buildbox

2025-03-27

_protos: Update local_cas.proto from buildbox

2024-06-21

_protos: Update protos from remote-apis

_protos: Update local_cas.proto from buildbox

2023-12-12

Add new changes for LocalCAS protocol with protobuf 3.20.1

2022-10-26

Cleanup license headers for initial apache release. This patch removes the copyright statements from license headers, and adds license headers to files which are missing them.

2022-08-11

_protos/buildstream/v2/artifact.proto: Adding buildroot to the artifact proto And regenerating the grpc code for the new artifact field.

2022-07-23

_protos: Update local_cas.proto from buildbox-common

2022-07-06

_protos: Update protos from remote-apis

2022-01-16

casserver.py: remove ReferenceStorage This is for bst1 only, and is now useless since bst-artifact-server was removed

2020-12-07

_protos: Regenerated protos for artifact proto update Added low_diversity_meta and high_diversity_meta artifact.proto. These two fields represent detatched metadata files in which we can store artifact metadata which does not pertain directly to the artifact's cache key and as such should not stored directly on the proto itself. The low diversity data is meant to maximize on deduplication of data in the CAS store, while data which is expected to diverge more should be stored in the high diversity metadata. Also added the strict key to the proto. The strict key is interesting to have when instantiating an Element from a downloaded artifact, and also provides some context as to whether the downloaded artifact's strong key matches it's strict key.

2020-12-02

_protos: Regenerated protos for artifact proto update Added sandbox_data to artifact.proto

2020-08-19

Add Remote Asset API proto

2020-08-13

_protos: Drop BuildStream Artifact and Source services Replaced by Remote Asset API Fetch and Push services.

Add Remote Asset API proto

_protos: Update local_cas.proto from buildbox-common

2020-05-25

_protos: Update remote_execution.proto

_protos: Update local_cas.proto

2020-03-16

_protos: Update remote_execution.proto Move output_node_properties from Action to Command.

2020-02-15

Add Remote Asset API proto

2020-02-11

artifact.proto: Add sources field This will be used for incremental builds.

2020-02-05

local_cas: Update proto

remote_execution: Update proto

2020-01-16

local_cas: Update proto

remote_execution: Update proto

2019-09-05

_protos: Update local_cas.proto

2019-08-20

_protos: Import local_cas.proto This imports local_cas.proto from buildbox-common [1] and the modules generated with ./setup.py build_grpc. [1] https://gitlab.com/BuildGrid/buildbox/buildbox-common

2019-08-19

artifact.proto: Add the project name to the build dependency information We also need to store the project name of dependencies in the proto in order to reconstruct the graph. This also means that we must include the project name of the dependencies in the cache key, otherwise the proto and the cache keys may fall out of sync.

2019-07-08

capabilities: Expand to include source service Part of #1038

Add new source proto Part of #1038

2019-06-26

artifact.proto: Remove ArtifactStatus method Not needed now that capabilities service is used. Part of #915

buildstream.proto: Add capabilities service Part of #915

2019-06-05

_protos: Add new status method to artifact service And update relavant grpc files. Part of #1025

2019-05-21

Move source from 'buildstream' to 'src/buildstream' This was discussed in #1008. Fixes #1009.

2019-04-17

Change namespace from buildstream to buildstream2 This patch changes the buildstream namespace to buildstream2, so that BuildStream 2 can be parallel installable with BuildStream 1. * Moved buildstream/ directory to buildstream2/ * Updated toplevel files to reflect this change: - .pylintrc - setup.py - setup.cfg - tox.ini - MANIFEST.in * pluginutils/runcli.py module to use relative imports, this is now a part of BuildStream so it should not import "from buildstream2" * Updated plugins to derive from buildstream2 plugins (and to literalinclude their YAML files for documentation from the new ../buildstream2/plugins/.. path). * Updated imports in test cases to import from buildstream2 * _project.py, _plugincontext.py: Use the "buildstream2.plugins" namespace for plugin loading. * _protos: Regenerated the protos, these generated python files import from the buildstream module instead of using relative imports, so they needed an update. * .coveragerc: Update for new buildstream2 namespace * doc/Makefile: Update to build docs with new buildstream2 namespace * doc/bst2html.py: Import from new buildstream2 namespace * doc/source/conf.py: Update to refer to new buildstream2 namespace * doc/source/sample_plugin/setup.py: Update to refer to new buildstream2 namespace * element.py, source.py, sandbox/sandbox.py, utils.py: Updated documentation links to refer to symbols in new buildstream2 namespace

2019-04-04

Add Artifact proto Part of #965

2018-09-27

_protos: Import google.rpc.Code proto Imports code.proto from https://github.com/googleapis/googleapis and corresponding modules generated with ./setup.py build_grpc. https://gitlab.com/BuildStream/buildstream/issues/668

2018-08-02

Add Jürg's files

2018-07-17

Import protos for the Bazel Remote Execution API This imports protos from https://github.com/bazelbuild/remote-apis/ and the modules generated with ./setup.py build_grpc.

Import Google proto dependencies for the Remote Execution API This imports protos from https://github.com/googleapis/googleapis/ and the modules generated with ./setup.py build_grpc.

remote_execution.proto: Add proposed symlink support https://github.com/bazelbuild/remote-apis/pull/18/

Add proto for BuildStream reference storage service

2018-07-08

Import Google proto dependencies for the Remote Execution API This imports protos from https://github.com/googleapis/googleapis/ and the modules generated with ./setup.py build_grpc.

Import protos for the Bazel Remote Execution API This imports protos from https://github.com/bazelbuild/remote-apis/ and the modules generated with ./setup.py build_grpc.

remote_execution.proto: Add proposed symlink support

Add proto for BuildStream artifact cache service

2018-05-31

Add proto for BuildStream artifact cache service

remote_execution.proto: Add proposed symlink support

Import protos for the Remote Execution API https://docs.google.com/document/d/1AaGk7fOPByEvpAbqeXIyE8HX_A3_axxNnvroblTZ_6s/ This imports protos from https://github.com/googleapis/googleapis/ and the modules generated with ./setup.py build_grpc.

2018-05-24

remote_execution.proto: Add proposed symlink support

Import protos for the Remote Execution API https://docs.google.com/document/d/1AaGk7fOPByEvpAbqeXIyE8HX_A3_axxNnvroblTZ_6s/ This imports protos from https://github.com/googleapis/googleapis/ and the modules generated with ./setup.py build_grpc.

Add proto for BuildStream artifact cache service