opagent-runtime

README

OpAgent Runtime

简体中文

This module is the file-native multi-agent runtime behind OpAgent. It scans Agent, Tool, and Skill manifests, runs agent loops, persists thread JSONL, enforces permissions, starts sandboxed process endpoints, and publishes typed streaming notifications.

Module path:

github.com/colinagent/opagent/opagent-runtime

The public embedding API is in package runtime:

rt, err := runtime.New(runtime.Options{BaseDir: "/absolute/opagent-data"})
if err != nil { /* handle */ }
defer rt.Close(context.Background())

if err := rt.Run(ctx); err != nil && !errors.Is(err, context.Canceled) {
    /* handle */
}

Wait on rt.Ready() before calling HandleAgent or HandleNode. Use Subscribe(buffer) for runtime events. v0.1 permits one Runtime per process.

Standalone data defaults to ~/.opagent; OPAGENT_BASE_DIR or Options.BaseDir overrides it. There is no legacy-directory fallback.

go test ./...
go build ./cmd/opagent-runtime

See Runtime documentation, Embedding guide, and Sandbox documentation.

Apache-2.0. See LICENSE and the root NOTICE.