archon-executor-runtime

SDK helpers for external need executors in agent platforms:

• permanent vs transient error classification
• dual-read need parsing (archon-need-protocol)
• webhook resume client
• metrics / healthz process helpers

Part of the Archon open-source toolkit by @diogoX451.

Install

go get github.com/diogoX451/archon-executor-runtime@latest

Minimal executor sketch

ev, err := executorruntime.ParseNeedEvent(msg.Data())
if err != nil {
    return msg.Ack() // poison
}
// do work...
err = executorruntime.PostWebhook(ctx, executorruntime.WebhookConfig{
    BaseURL: os.Getenv("ORCHESTRATOR_URL"),
}, ev.Need.CorrelationID, resultJSON)
if err != nil {
    return err // transient redelivery
}
return msg.Ack()

Contributing

See CONTRIBUTING.md. Keep this package free of product domain logic.

License

Apache-2.0