Development

Development

Connector is a Deno/TypeScript application and builds against the sibling ../portable-agents workspace and binary. A compatible dynamic Lua 5.5 runtime is required for PA and package native modules.

cd ../portable-agents
zig build -Doptimize=ReleaseSafe -Dsystem-lua=true
cd ../agent-connector
deno task check
deno task compile

Compilation writes generated files under dist/: the agc executable, matching agent binary and Lua shared library, package assets, and license/notice files. These are build outputs, not source files to commit. The standalone Deno build embeds the native keyring addon and requires FFI permission.

To test configuration and package loading, create an ac.yaml with at least one policy and run agc check .. agc connect . registers the Discord command and saves credentials; agc run . starts the gateway client. Development and test workflows should use test credentials and avoid live Discord operations unless explicitly intended.