https://github.com/strawpot/denden
CLI based Agent to Orchestrator Communication Layer for StrawPot
https://github.com/strawpot/denden
agent communications orchestrator
Last synced: 3 months ago
JSON representation
CLI based Agent to Orchestrator Communication Layer for StrawPot
- Host: GitHub
- URL: https://github.com/strawpot/denden
- Owner: strawpot
- License: mit
- Created: 2026-02-27T02:43:32.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-11T23:51:46.000Z (3 months ago)
- Last Synced: 2026-03-12T04:53:10.532Z (3 months ago)
- Topics: agent, communications, orchestrator
- Language: Python
- Homepage:
- Size: 99.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Den Den
Agent-to-orchestrator communication layer. A gRPC transport where agents call back to the orchestrator via the `denden` CLI.
```
Orchestrator (Python gRPC server)
├── spawns agents as subprocesses
└── handles ask_user / delegate / remember / recall requests
▲
│ gRPC (localhost)
│
denden CLI (Go binary)
└── called by agents to send requests
```
## Components
| Component | Language | Path |
|---|---|---|
| CLI client | Go | `cli/` |
| Server library | Python | `server/` |
| Protocol | Protobuf | `proto/denden.proto` |
## Quick start
### Install the server
```bash
cd server
pip install -e '.[dev]'
```
### Build the CLI
```bash
cd cli
go build -o denden .
```
### Run the server
```bash
denden-server --verbose
```
### Use the CLI
```bash
# Health check
./cli/denden status
# Ask user a question
./cli/denden send '{
"askUser": {
"question": "Which language?",
"choices": ["Python", "Go", "Rust"]
}
}'
# Delegate to a sub-agent
./cli/denden send '{
"delegate": {
"delegateTo": "implementer",
"task": {
"text": "implement auth module",
"returnFormat": "TEXT"
}
}
}'
# Remember information
./cli/denden send '{
"remember": {
"content": "This project uses pytest",
"keywords": ["testing", "pytest"],
"scope": "project"
}
}'
# Recall stored information
./cli/denden send '{
"recall": {
"query": "testing framework",
"scope": "project",
"maxResults": 5
}
}'
```
The CLI auto-fills `request_id`, `denden_version`, `trace.created_at`, and trace fields from environment variables.
### Environment variables
| Variable | Default | Description |
|---|---|---|
| `DENDEN_ADDR` | `127.0.0.1:9700` | Server address |
| `DENDEN_AGENT_ID` | | Agent instance ID (set by orchestrator) |
| `DENDEN_PARENT_AGENT_ID` | | Parent agent instance ID |
| `DENDEN_RUN_ID` | | Run ID |
| `DENDEN_TIMEOUT` | `30s` | CLI request timeout |
## Protocol
Single `.proto` file at `proto/denden.proto`. Two RPCs:
- **Send** — dispatches `ask_user`, `delegate`, `remember`, or `recall` requests (oneof payload)
- **Status** — health check
Response statuses: `OK`, `DENIED`, `ERROR`.
### Regenerate stubs
```bash
make proto
```
Requires `protoc`, `protoc-gen-go`, `protoc-gen-go-grpc`, and `grpcio-tools`.
## Server as a library
```python
from denden import DenDenServer, ok_response
from denden.gen import denden_pb2
server = DenDenServer(addr="127.0.0.1:9700")
def handle_ask_user(request):
answer = input(request.ask_user.question + " ")
return ok_response(
request.request_id,
ask_user_result=denden_pb2.AskUserResult(text=answer),
)
def handle_delegate(request):
# ... run the delegated task ...
return ok_response(
request.request_id,
delegate_result=denden_pb2.DelegateResult(text="done"),
)
server.on_ask_user(handle_ask_user)
server.on_delegate(handle_delegate)
server.on_remember(handle_remember)
server.on_recall(handle_recall)
server.run()
```
### Dynamic modules
The server CLI supports loading modules at startup:
```bash
denden-server --load-module my_custom_module
```
Modules must expose a `module` attribute or `create_module()` function returning a `denden.Module` subclass.