runner

type Compilation struct {
	Program  action.AnyAction
	Meta     map[string]any
	Resolver core.CapabilityResolver
}

type Config struct {
	Resolver      core.CapabilityResolver
	Directives    *core.DirectiveTable
	Modifiers     *core.ModifierTable
	Operators     *core.OperatorTable
	Primaries     *core.PrimaryExtensionTable
	Materializers []core.Materializer
	CompileOpts   []core.CompileOption

	// Hooks are applied to every resolver action and to the top-level
	// program before execution. Callers that only want to see the
	// result set this to nil.
	Hooks []action.AnyHook

	// EventSink, when non-nil, is wrapped by observe.Hook and appended
	// to Hooks. Both paths end up on the execution-local resolver's
	// actions; use either, or both.
	EventSink observe.Sink

	// MeasureAllocs wraps the compile and run phases of Execute with
	// MemStats deltas so callers can attribute allocations to the
	// compiler versus the runtime. ReadMemStats triggers a brief
	// stop-the-world pause; leave false on production hot paths. This
	// mirrors the same precedent as CompileDuration and RunDuration:
	// Execute already reports per-phase diagnostics, and this is the
	// allocation counterpart.
	MeasureAllocs bool

	// ArgSchemas is the merged per-action argument schema published by
	// every mounted bundle. It is exposed so diagnostics (nflow lint
	// today) can validate @{...} capability references without building
	// the action tree. Build-time advisors are the runtime counterpart;
	// this field makes the same checks reachable from a pure parse.
	ArgSchemas map[string][]core.ArgFieldSpec
}

type Execution struct {
	Output          any
	Meta            map[string]any
	Resolver        core.CapabilityResolver
	CompileDuration time.Duration
	RunDuration     time.Duration

	CompileAllocs     uint64
	CompileAllocBytes uint64
	RunAllocs         uint64
	RunAllocBytes     uint64
}

type InfoShape struct {
	Path        string   `json:"path"`
	Description string   `json:"description,omitempty"`
	Asserts     []string `json:"asserts,omitempty"`
	Atoms       []string `json:"atoms"`
}

type Observer struct {
	// contains filtered or unexported fields
}

type Opts struct {
	Verbosity int
	Info      bool
	Asserts   []string
	Stdout    io.Writer
	Stderr    io.Writer
}

type Record struct {
	Action   string
	Duration time.Duration
	Err      error
	Start    time.Time
}

type SourcedModifier struct {
	Raw    string
	Source core.ModifierSource
}