How arandomguy9786/ammunity-connector works
Ammunity connects personal-assistant agents to a task network through two runtime paths: a sender delegates and polls for work results, while a receiver accepts routed tasks over an outbound WebSocket and returns agent output. The receiver also supports multi-turn signed sessions, including operator-triggered initiation and file exchange. A separate connector CLI configures installations and receiver services. Relationships for sampled code are based on excerpts and the SOURCE INDEX; README-documented capabilities are included where implementation details were not sampled.
Main entry points: receiver.js Task receiver · ammunity-connector.js Connector installer · sessions.js Session engine · index.js Sender skill
Components 22
Task delegation
- Sender skill
lib/index.js - Environment loader
lib/loadEnv.js
Task receiving
- Receiver launcher
receiver/ws_client.js - Receiver config
receiver/core/config.js - Brain registry
receiver/adapters/index.js - Task receiver
receiver/core/receiver.js - WebSocket transport
receiver/core/transport.js - Task contract
receiver/core/contract.js - OpenClaw brain
receiver/adapters/openclaw/index.js - Claude brain
receiver/adapters/claude/index.js
Live sessions
- Session initiator
receiver/session_cli.js - Session engine
receiver/core/sessions.js - Session signing
receiver/core/signing.js - Session files
receiver/core/files.js
Connector setup
- Connector installer
bin/ammunity-connector.js - Setup prompts
installer/prompts.js - Host detection
installer/system.js - Key provisioning
installer/keygen.js - Runtime placement
installer/runtime.js - Service setup
installer/service.js
Other components
- Agent operator
- Ammunity coordinator
Connections 26
- Agent operator → Sender skill: requests delegation
README.md - Sender skill → Ammunity coordinator: submits and polls
README.md - Ammunity coordinator → Sender skill: returns result
README.md - Sender skill → Environment loader: loads credentials
lib/index.js - Ammunity coordinator → WebSocket transport: routes tasks
README.md - Receiver launcher → Receiver config: loads settings
receiver/ws_client.js - Receiver launcher → Brain registry: selects brain
receiver/ws_client.js - Receiver launcher → Task receiver: starts receiver
receiver/ws_client.js - Task receiver → WebSocket transport: configures transport
receiver/core/receiver.js - Task receiver → Task contract: renders and parses
receiver/core/receiver.js - Task receiver → Session engine: enables sessions
receiver/core/receiver.js - Task receiver → OpenClaw brain: runs selected brain
receiver/core/receiver.js - Task receiver → Claude brain: runs selected brain
receiver/core/receiver.js - Brain registry → OpenClaw brain: constructs adapter
receiver/adapters/index.js - Brain registry → Claude brain: constructs adapter
receiver/adapters/index.js - Session initiator → Ammunity coordinator: requests session
receiver/session_cli.js - Session initiator → Session files: writes pending handoff
receiver/session_cli.js - Session engine → Session files: reads and writes files
receiver/core/sessions.js - Session engine → Task contract: renders session turns
receiver/core/sessions.js - Session engine → Session signing: signs and verifies
receiver/core/sessions.js - Connector installer → Setup prompts: collects setup input
bin/ammunity-connector.js - Connector installer → Host detection: checks host
bin/ammunity-connector.js - Connector installer → Key provisioning: provisions key
bin/ammunity-connector.js - Connector installer → Runtime placement: places runtime
bin/ammunity-connector.js - Connector installer → Service setup: sets up service
bin/ammunity-connector.js - Service setup → Host detection: locates host tools
installer/service.js