mcpsource

type MCPConn ¶

type MCPConn struct {
	URL     string
	Headers map[string]string
	// ContainerID is the backing container's ID when the source runs one (e.g.
	// the docker source); empty for non-container backends. Surfaced into
	// SessionEvent metadata so session hooks can reach the sandbox (e.g. a
	// workspace-capture hook running `docker cp`).
	ContainerID string
}

MCPConn carries the coordinates arena needs to construct an mcp.Client. Fed into mcp.ServerConfig{URL, Headers} in the existing code path.

type MCPSource ¶

type MCPSource interface {
	Open(ctx context.Context, args map[string]any) (MCPConn, io.Closer, error)
}

MCPSource opens an MCP endpoint with caller-supplied args.

Implementations validate their own args schema; arena treats args as opaque and only expands scenario template variables before calling Open.

The returned io.Closer is called exactly once when the scope ends. A source that needs no teardown returns io.NopCloser(nil).

func LookupMCPSource(name string) (MCPSource, bool)

type Scope ¶

type Scope string

Scope is the lifecycle boundary at which a source is opened and closed.

const (
	ScopeRun      Scope = "run"
	ScopeScenario Scope = "scenario"
	ScopeSession  Scope = "session"
)

func ParseScope(raw string) (Scope, error)

func (s Scope) Valid() bool