behest 0.2.1

A Rust-native cloud agent runtime with typed tools, pluggable memory, queues, and observability.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

syntax = "proto3";

package agent.v1;

import "agent/v1/common.proto";

// Agent mode.
enum AgentMode {
  AGENT_MODE_UNSPECIFIED = 0;
  AGENT_MODE_PRIMARY = 1;
  AGENT_MODE_SUBAGENT = 2;
}

// Permission effect.
message PermissionEffect {
  oneof effect {
    bool allow = 1;
    bool deny = 2;
    bool ask = 3;
  }
}

// Permission rule.
message PermissionRule {
  string tool = 1;
  string resource = 2;
  PermissionEffect effect = 3;
}

// Agent definition.
message AgentDefinition {
  string name = 1;
  string description = 2;
  AgentMode mode = 3;
  string system_prompt = 4;
  bool hidden = 5;
  repeated PermissionRule permissions = 6;
  ModelName model = 7;       // optional
  uint32 max_steps = 8;      // optional, 0 = unset
}

// Register agent request.
message RegisterAgentRequest {
  AgentDefinition agent = 1;
}

// Register agent response.
message RegisterAgentResponse {}

// Get agent request.
message GetAgentRequest {
  string name = 1;
}

// Get agent response.
message GetAgentResponse {
  AgentDefinition agent = 1;
}

// List agents request.
message ListAgentsRequest {}

// List agents response.
message ListAgentsResponse {
  repeated AgentDefinition agents = 1;
  string default_agent = 2; // optional
}

// Set default agent request.
message SetDefaultAgentRequest {
  string name = 1;
}

// Set default agent response.
message SetDefaultAgentResponse {}

// Agent service.
service AgentService {
  rpc RegisterAgent(RegisterAgentRequest) returns (RegisterAgentResponse);
  rpc GetAgent(GetAgentRequest) returns (GetAgentResponse);
  rpc ListAgents(ListAgentsRequest) returns (ListAgentsResponse);
  rpc SetDefaultAgent(SetDefaultAgentRequest) returns (SetDefaultAgentResponse);
}