A11 (C++ runtime)
Native C++ implementation of the A11 streaming action runtime
Loading...
Searching...
No Matches
runtime.h
Go to the documentation of this file.
1// Copyright 2026 The A11 Authors
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7// http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15#ifndef A11_WASM_RUNTIME_H_
16#define A11_WASM_RUNTIME_H_
17
18#include <cstdint>
19#include <deque>
20#include <optional>
21#include <string>
22#include <string_view>
23#include <vector>
24
25#include <absl/container/flat_hash_map.h>
26#include <absl/container/flat_hash_set.h>
27#include <absl/status/status.h>
28#include <absl/status/statusor.h>
29
30#include "a11/data/types.h"
31
32namespace a11::wasm {
33
34// Single-threaded runtime. The host drives action callbacks and persistence.
35class Runtime {
36 public:
37 explicit Runtime(std::string storage_id);
38
39 absl::Status RegisterAction(std::string name);
40 absl::Status Invoke(data::ActionMessage action);
41 absl::StatusOr<std::optional<data::ActionMessage>> NextAction();
42 absl::Status FinishAction(std::string_view id, absl::Status status);
43
44 absl::Status Append(data::NodeFragment fragment);
45 absl::StatusOr<std::uint32_t> Put(data::NodeFragment fragment);
46 absl::StatusOr<std::vector<std::uint32_t>> PutMany(
47 std::vector<data::NodeFragment> fragments);
48 absl::Status Close(std::string_view id, absl::Status status);
49 absl::StatusOr<data::NodeFragment> Read(std::string_view id,
50 size_t index) const;
51 absl::StatusOr<data::NodeFragment> ReadArrival(std::string_view id,
52 size_t arrival) const;
53 absl::StatusOr<data::NodeFragment> ClearData(std::string_view id,
54 std::uint32_t seq);
55 absl::StatusOr<size_t> Count(std::string_view id) const;
56 absl::StatusOr<std::uint32_t> ArrivalSeq(std::string_view id,
57 size_t arrival) const;
58 absl::StatusOr<std::optional<std::uint32_t>> FinalSeq(
59 std::string_view id) const;
60 absl::StatusOr<bool> Closed(std::string_view id) const;
61 absl::StatusOr<std::vector<data::Chunk>> Resolve(
62 const data::NodeRef& ref, size_t max_depth = 8,
63 size_t max_chunks = 1024) const;
64 absl::StatusOr<std::string> ExportSnapshot() const;
65 absl::Status ImportSnapshot(std::string_view bytes);
66
67 private:
68 struct Node {
69 absl::flat_hash_map<std::uint32_t, data::NodeFragment> fragments{};
70 std::vector<std::uint32_t> arrival{};
71 std::optional<std::uint32_t> final_seq{};
72 bool closed = false;
73 absl::Status status{};
74 };
75
76 struct Invocation {
77 data::ActionMessage message{};
78 bool running = false;
79 bool finished = false;
80 absl::Status status{};
81 };
82
83 absl::Status ResolveInto(const data::NodeRef& ref, size_t depth,
84 size_t max_chunks,
85 absl::flat_hash_set<std::string>* seen,
86 std::vector<data::Chunk>* output) const;
87
88 std::string storage_id_;
89 absl::flat_hash_map<std::string, Node> nodes_;
90 absl::flat_hash_set<std::string> actions_;
91 absl::flat_hash_map<std::string, Invocation> invocations_;
92 std::deque<std::string> pending_;
93};
94
95} // namespace a11::wasm
96
97#endif // A11_WASM_RUNTIME_H_
Definition runtime.h:35
absl::StatusOr< data::NodeFragment > ClearData(std::string_view id, std::uint32_t seq)
Definition runtime.cc:219
absl::StatusOr< std::uint32_t > ArrivalSeq(std::string_view id, size_t arrival) const
Definition runtime.cc:249
absl::Status Invoke(data::ActionMessage action)
Definition runtime.cc:35
absl::StatusOr< std::uint32_t > Put(data::NodeFragment fragment)
Definition runtime.cc:90
absl::StatusOr< std::vector< std::uint32_t > > PutMany(std::vector< data::NodeFragment > fragments)
Definition runtime.cc:136
absl::StatusOr< std::vector< data::Chunk > > Resolve(const data::NodeRef &ref, size_t max_depth=8, size_t max_chunks=1024) const
Definition runtime.cc:327
absl::Status FinishAction(std::string_view id, absl::Status status)
Definition runtime.cc:65
absl::Status RegisterAction(std::string name)
Definition runtime.cc:27
absl::StatusOr< std::optional< std::uint32_t > > FinalSeq(std::string_view id) const
Definition runtime.cc:261
absl::StatusOr< std::string > ExportSnapshot() const
Definition runtime.cc:336
absl::StatusOr< std::optional< data::ActionMessage > > NextAction()
Definition runtime.cc:55
absl::Status ImportSnapshot(std::string_view bytes)
Definition runtime.cc:359
absl::Status Close(std::string_view id, absl::Status status)
Definition runtime.cc:166
absl::StatusOr< bool > Closed(std::string_view id) const
Definition runtime.cc:270
absl::StatusOr< data::NodeFragment > ReadArrival(std::string_view id, size_t arrival) const
Definition runtime.cc:202
absl::StatusOr< size_t > Count(std::string_view id) const
Definition runtime.cc:241
absl::Status Append(data::NodeFragment fragment)
Definition runtime.cc:85
absl::StatusOr< data::NodeFragment > Read(std::string_view id, size_t index) const
Definition runtime.cc:177
const PortPlan * output
Definition contract.cc:36
std::string name
The declaration name and its colon.
Definition format.cc:50
size_t depth
Definition module.cc:55
Definition async_task.cc:27
bool fragments
Definition runtime_streams.cc:32
std::string ref
Definition sqlite_chunk_store.cc:193
std::uint32_t seq
Definition sqlite_chunk_store.cc:186
The wire description of an action invocation.
Definition types.h:466
One piece of a node's stream: an inline chunk or a node reference.
Definition types.h:366
A reference to a (slice of a) logical node, in lieu of inline data.
Definition types.h:311
A11's core wire value types: chunks, node fragments and messages.