Skip to content

Commit 8ca4334

Browse files
Rename project to AgentField
1 parent 7baa177 commit 8ca4334

347 files changed

Lines changed: 4344 additions & 4349 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/BRANCH_PROTECTION.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -65,16 +65,16 @@ cd control-plane
6565
go build ./...
6666

6767
# Test cross-compilation
68-
GOOS=linux GOARCH=amd64 go build ./cmd/haxen-server
69-
GOOS=darwin GOARCH=amd64 go build ./cmd/haxen-server
70-
GOOS=windows GOARCH=amd64 go build ./cmd/haxen-server
68+
GOOS=linux GOARCH=amd64 go build ./cmd/agentfield-server
69+
GOOS=darwin GOARCH=amd64 go build ./cmd/agentfield-server
70+
GOOS=windows GOARCH=amd64 go build ./cmd/agentfield-server
7171
```
7272

7373
### Docker Build Failures
7474
```bash
7575
# Test Docker build locally
76-
docker build -f deployments/docker/Dockerfile.control-plane -t haxen-control-plane:test .
77-
docker run --rm haxen-control-plane:test --help
76+
docker build -f deployments/docker/Dockerfile.control-plane -t agentfield-control-plane:test .
77+
docker run --rm agentfield-control-plane:test --help
7878
```
7979

8080
## Emergency Merges

.github/ISSUE_TEMPLATE/feature_request.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: Feature Request
3-
about: Suggest an idea for Haxen
3+
about: Suggest an idea for AgentField
44
labels: enhancement
55
---
66

.github/ISSUE_TEMPLATE/question.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: Question
3-
about: Ask a question about using Haxen
3+
about: Ask a question about using AgentField
44
labels: question
55
---
66

.github/workflows/control-plane.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ jobs:
113113
working-directory: control-plane
114114
run: |
115115
echo "Building for ${GOOS}/${GOARCH}"
116-
go build -o /tmp/haxen-server-${GOOS}-${GOARCH} ./cmd/haxen-server
116+
go build -o /tmp/agentfield-server-${GOOS}-${GOARCH} ./cmd/agentfield-server
117117
118118
# Summary job that depends on all critical checks
119119
required-checks:

.github/workflows/docker.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,10 +30,10 @@ jobs:
3030
context: .
3131
file: deployments/docker/Dockerfile.control-plane
3232
load: true
33-
tags: haxen-control-plane:test
33+
tags: agentfield-control-plane:test
3434

3535
- name: Smoke test control plane image
36-
run: docker run --rm haxen-control-plane:test --help
36+
run: docker run --rm agentfield-control-plane:test --help
3737

3838
# Summary job that depends on all critical checks
3939
required-checks:

.github/workflows/release.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ jobs:
150150
OWNER: ${{ github.repository_owner }}
151151
run: |
152152
owner="$(echo "${OWNER}" | tr '[:upper:]' '[:lower:]')"
153-
image="ghcr.io/${owner}/haxen-control-plane"
153+
image="ghcr.io/${owner}/agentfield-control-plane"
154154
if [ "${EVENT_NAME}" = "push" ]; then
155155
tag="${REF_NAME}"
156156
else

.goreleaser.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
1-
project_name: haxen-control-plane
1+
project_name: agentfield-control-plane
22

33
before:
44
hooks:
55
- npm --prefix control-plane/web/client ci
66
- npm --prefix control-plane/web/client run build
77

88
builds:
9-
- id: haxen-control-plane
9+
- id: agentfield-control-plane
1010
dir: control-plane
11-
main: ./cmd/server
12-
binary: haxen-server
11+
main: ./cmd/agentfield-server
12+
binary: agentfield-server
1313
env:
1414
- CGO_ENABLED=0
1515
goos:
@@ -26,9 +26,9 @@ builds:
2626
- -s -w
2727

2828
archives:
29-
- id: haxen-control-plane
29+
- id: agentfield-control-plane
3030
builds:
31-
- haxen-control-plane
31+
- agentfield-control-plane
3232
name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
3333
format_overrides:
3434
- goos: windows

CLAUDE.md

Lines changed: 42 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
44

55
## Project Overview
66

7-
Haxen is a Kubernetes-style control plane for AI agents. It provides production infrastructure for deploying, orchestrating, and observing multi-agent systems with cryptographic identity and audit trails.
7+
AgentField is a Kubernetes-style control plane for AI agents. It provides production infrastructure for deploying, orchestrating, and observing multi-agent systems with cryptographic identity and audit trails.
88

99
**Architecture:** Three-tier monorepo
1010
- **Control Plane** (Go): Orchestration server providing REST/gRPC APIs, workflow execution, observability, and cryptographic identity
@@ -36,21 +36,21 @@ make build
3636
**Local mode** (uses SQLite + BoltDB, no external dependencies):
3737
```bash
3838
cd control-plane
39-
go run ./cmd/haxen dev
40-
# Or: go run ./cmd/haxen-server
39+
go run ./cmd/af dev
40+
# Or: go run ./cmd/agentfield-server
4141
```
4242

4343
**Cloud mode** (requires PostgreSQL):
4444
```bash
4545
# Run migrations first
4646
cd control-plane
47-
export HAXEN_DATABASE_URL="postgres://haxen:haxen@localhost:5432/haxen?sslmode=disable"
48-
goose -dir ./migrations postgres "$HAXEN_DATABASE_URL" up
47+
export AGENTFIELD_DATABASE_URL="postgres://agentfield:agentfield@localhost:5432/agentfield?sslmode=disable"
48+
goose -dir ./migrations postgres "$AGENTFIELD_DATABASE_URL" up
4949

5050
# Start server
51-
HAXEN_STORAGE_MODE=postgresql \
52-
HAXEN_DATABASE_URL="postgres://haxen:haxen@localhost:5432/haxen?sslmode=disable" \
53-
go run ./cmd/haxen-server
51+
AGENTFIELD_STORAGE_MODE=postgresql \
52+
AGENTFIELD_DATABASE_URL="postgres://agentfield:agentfield@localhost:5432/agentfield?sslmode=disable" \
53+
go run ./cmd/agentfield-server
5454
```
5555

5656
**Docker Compose** (includes PostgreSQL):
@@ -82,7 +82,7 @@ cd sdk/go && go test ./...
8282
cd sdk/python && pytest
8383

8484
# Python tests with coverage:
85-
cd sdk/python && pytest --cov=haxen_sdk --cov-report=term-missing
85+
cd sdk/python && pytest --cov=agentfield --cov-report=term-missing
8686

8787
# Web UI linting:
8888
cd control-plane/web/client && npm run lint
@@ -103,13 +103,13 @@ cd sdk/python && ruff format .
103103
### Database Migrations
104104
```bash
105105
cd control-plane
106-
export HAXEN_DATABASE_URL="postgres://haxen:haxen@localhost:5432/haxen?sslmode=disable"
106+
export AGENTFIELD_DATABASE_URL="postgres://agentfield:agentfield@localhost:5432/agentfield?sslmode=disable"
107107

108108
# Check migration status
109-
goose -dir ./migrations postgres "$HAXEN_DATABASE_URL" status
109+
goose -dir ./migrations postgres "$AGENTFIELD_DATABASE_URL" status
110110

111111
# Apply all pending migrations
112-
goose -dir ./migrations postgres "$HAXEN_DATABASE_URL" up
112+
goose -dir ./migrations postgres "$AGENTFIELD_DATABASE_URL" up
113113

114114
# Create new migration
115115
goose -dir ./migrations create <migration_name> sql
@@ -123,7 +123,7 @@ npm run dev # Runs on http://localhost:5173
123123

124124
# In parallel, run the control plane server to handle API calls
125125
cd control-plane
126-
go run ./cmd/haxen-server
126+
go run ./cmd/agentfield-server
127127
```
128128

129129
The UI dev server proxies API requests to the control plane. In production, the UI is embedded via Go's `embed` package.
@@ -133,8 +133,8 @@ The UI dev server proxies API requests to the control plane. In production, the
133133
### Control Plane Structure (`control-plane/`)
134134

135135
**Entry Points:**
136-
- `cmd/haxen/` - Unified CLI with server + dev/init commands
137-
- `cmd/haxen-server/` - Standalone server binary
136+
- `cmd/agentfield/` - Unified CLI with server + dev/init commands
137+
- `cmd/agentfield-server/` - Standalone server binary
138138

139139
**Core Packages (`internal/`):**
140140
- `cli/` - CLI command definitions and routing
@@ -149,26 +149,26 @@ The UI dev server proxies API requests to the control plane. In production, the
149149
- `mcp/` - Model Context Protocol integration
150150
- `logger/` - Structured logging (zerolog)
151151
- `config/` - Configuration management (Viper)
152-
- `templates/` - Code generation templates for `haxen init`
152+
- `templates/` - Code generation templates for `af init`
153153
- `utils/` - Shared utilities
154154
- `encryption/` - Cryptographic primitives for DID/VC
155155
- `packages/` - Shared internal packages
156156
- `embedded/` - Embedded assets (web UI dist)
157157

158158
**Configuration:**
159-
- Environment variables take precedence over `config/haxen.yaml`
159+
- Environment variables take precedence over `config/agentfield.yaml`
160160
- See `control-plane/.env.example` for all options
161-
- Key modes: `HAXEN_MODE=local` (SQLite/BoltDB) vs `HAXEN_STORAGE_MODE=postgresql` (cloud)
161+
- Key modes: `AGENTFIELD_MODE=local` (SQLite/BoltDB) vs `AGENTFIELD_STORAGE_MODE=postgresql` (cloud)
162162

163163
**Database Schema:**
164164
- `migrations/` - SQL migrations managed by Goose
165165
- Always run migrations before starting the server in PostgreSQL mode
166166

167167
### SDK Structure
168168

169-
**Python SDK (`sdk/python/haxen_sdk/`):**
169+
**Python SDK (`sdk/python/agentfield/`):**
170170
- Built on FastAPI/Uvicorn for agent HTTP servers
171-
- Key modules: `Agent`, `agent_haxen`, `client`, `execution_context`, `memory`, `ai`
171+
- Key modules: `Agent`, `agent_field_handler`, `client`, `execution_context`, `memory`, `ai`
172172
- Agents register "reasoners" (decorated functions) that become REST endpoints
173173
- Test with: `pytest` (see `pyproject.toml` for test markers: unit, functional, integration)
174174
- Install locally: `pip install -e .[dev]`
@@ -189,21 +189,21 @@ The UI dev server proxies API requests to the control plane. In production, the
189189
### Creating a New Agent (Python)
190190
```bash
191191
# Generate agent scaffold (run from repo root or any directory)
192-
haxen init my-agent
192+
af init my-agent
193193
cd my-agent
194194

195195
# Edit agent code (auto-generated template)
196-
# Run agent locally (connects to control plane at HAXEN_SERVER env var or --server flag)
197-
haxen run
196+
# Run agent locally (connects to control plane at AGENTFIELD_SERVER env var or --server flag)
197+
af run
198198
```
199199

200200
### Creating a New Agent (Go)
201201
```go
202-
import haxenagent "github.com/agentfield/haxen/sdk/go/agent"
202+
import agentfieldagent "github.com/agentfield/agentfield/sdk/go/agent"
203203

204-
agent, _ := haxenagent.New(haxenagent.Config{
204+
agent, _ := agentfieldagent.New(agentfieldagent.Config{
205205
NodeID: "my-agent",
206-
HaxenURL: "http://localhost:8080",
206+
AgentFieldURL: "http://localhost:8080",
207207
})
208208
agent.RegisterSkill("greet", func(ctx context.Context, input map[string]any) (any, error) {
209209
return map[string]any{"message": "hello"}, nil
@@ -249,7 +249,7 @@ Storage interface is unified—services call storage layer methods, storage laye
249249

250250
### Configuration Precedence
251251
1. Environment variables (highest priority)
252-
2. Config file (`config/haxen.yaml` or `HAXEN_CONFIG_FILE` path)
252+
2. Config file (`config/agentfield.yaml` or `AGENTFIELD_CONFIG_FILE` path)
253253
3. Defaults in code
254254

255255
### Agent-to-Agent Communication
@@ -269,17 +269,17 @@ Automatically synced by control plane. Agents access via SDK methods: `agent.mem
269269
- Opt-in per agent: Set `app.vc_generator.set_enabled(True)` in Python or equivalent in Go
270270
- Control plane generates W3C Verifiable Credentials for each execution
271271
- Export audit trails: `GET /api/v1/did/workflow/{workflow_id}/vc-chain`
272-
- Verify offline: `haxen verify audit.json`
272+
- Verify offline: `af verify audit.json`
273273

274274
## Module Naming
275275

276276
**Control Plane (Go):**
277-
- Use `github.com/your-org/haxen/control-plane` as module path
278-
- Internal packages: `github.com/your-org/haxen/control-plane/internal/<package>`
277+
- Use `github.com/your-org/agentfield/control-plane` as module path
278+
- Internal packages: `github.com/your-org/agentfield/control-plane/internal/<package>`
279279

280280
**SDKs:**
281-
- Python: `haxen_sdk` (PyPI package)
282-
- Go: `github.com/agentfield/haxen/sdk/go` (import path)
281+
- Python: `agentfield` (PyPI package)
282+
- Go: `github.com/agentfield/agentfield/sdk/go` (import path)
283283

284284
## Release Process
285285

@@ -290,23 +290,23 @@ Releases are automated via `.github/workflows/release.yml` and `.goreleaser.yml`
290290

291291
## Debugging Tips
292292

293-
- **Control plane not starting:** Check `HAXEN_DATABASE_URL` is set correctly (PostgreSQL mode) or ensure SQLite file path is writable (local mode)
293+
- **Control plane not starting:** Check `AGENTFIELD_DATABASE_URL` is set correctly (PostgreSQL mode) or ensure SQLite file path is writable (local mode)
294294
- **Migrations failing:** Ensure PostgreSQL is running and connection string is correct. Check migration status with `goose status`
295-
- **Agent can't connect:** Verify `HAXEN_SERVER` env var points to control plane (default: `http://localhost:8080`)
295+
- **Agent can't connect:** Verify `AGENTFIELD_SERVER` env var points to control plane (default: `http://localhost:8080`)
296296
- **UI not loading:** In dev, ensure both Vite dev server (`npm run dev`) and control plane server are running. In prod, ensure `make build` was run to embed UI in binary
297297
- **Agent execution stuck:** Check workflow DAG in UI (`/ui/workflows`) for errors. Check agent logs for exceptions.
298-
- **Database connection pool exhausted:** Increase `HAXEN_STORAGE_POSTGRES_MAX_CONNECTIONS` in config
298+
- **Database connection pool exhausted:** Increase `AGENTFIELD_STORAGE_POSTGRES_MAX_CONNECTIONS` in config
299299

300300
## Environment Variables Reference
301301

302302
See `control-plane/.env.example` for comprehensive list. Key vars:
303-
- `HAXEN_PORT` - HTTP server port (default: 8080)
304-
- `HAXEN_MODE` - `local` or `cloud`
305-
- `HAXEN_STORAGE_MODE` - `local`, `postgresql`, or `cloud`
306-
- `HAXEN_DATABASE_URL` - PostgreSQL connection string
307-
- `HAXEN_UI_ENABLED` - Enable/disable web UI
308-
- `HAXEN_UI_MODE` - `embedded` (production) or `development` (Vite proxy)
309-
- `HAXEN_CONFIG_FILE` - Path to config YAML
303+
- `AGENTFIELD_PORT` - HTTP server port (default: 8080)
304+
- `AGENTFIELD_MODE` - `local` or `cloud`
305+
- `AGENTFIELD_STORAGE_MODE` - `local`, `postgresql`, or `cloud`
306+
- `AGENTFIELD_DATABASE_URL` - PostgreSQL connection string
307+
- `AGENTFIELD_UI_ENABLED` - Enable/disable web UI
308+
- `AGENTFIELD_UI_MODE` - `embedded` (production) or `development` (Vite proxy)
309+
- `AGENTFIELD_CONFIG_FILE` - Path to config YAML
310310
- `GIN_MODE` - `debug` or `release`
311311
- `LOG_LEVEL` - `debug`, `info`, `warn`, `error`
312312

CODE_OF_CONDUCT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Our Pledge
44

5-
We as members, contributors, and leaders pledge to make participation in the Haxen project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
5+
We as members, contributors, and leaders pledge to make participation in the AgentField project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
66

77
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
88

0 commit comments

Comments
 (0)