control.h

Go to the documentation of this file.

// Copyright 2026 The Symbian SDK Authors.
// Licensed under the Apache License, Version 2.0.
 
#ifndef SYMBIAN_AGENT_CONTROL_H_
#define SYMBIAN_AGENT_CONTROL_H_
 
#include <cstddef>
#include <cstdint>
#include <string>
#include <string_view>
 
#include "absl/status/statusor.h"
#include "nlohmann/json.hpp"
 
namespace symbian::agent {
 
inline constexpr std::size_t kMaximumControlBytes = 4096;
 
enum class ControlKind : std::uint8_t {
  kHello = 1,
  kStatus = 2,
  kCancel = 3,
  kResult = 4,
  kError = 5,
  kLogs = 6,
  kWorkspaceList = 7,
};
 
struct ControlMessage {
  std::uint32_t version = 1;
  std::uint64_t request_id = 0;
  ControlKind kind = ControlKind::kHello;
  std::uint64_t deadline_millis = 0;
  nlohmann::json body = nlohmann::json::object();
  nlohmann::json extensions = nlohmann::json::object();
};
 
absl::StatusOr<ControlMessage> ParseControl(std::string_view encoded);
 
absl::StatusOr<std::string> PackControl(const ControlMessage& message);
 
}  // namespace symbian::agent
 
#endif  // SYMBIAN_AGENT_CONTROL_H_