contracts

package

v0.54.0 Latest Latest Go to latest Published: Oct 30, 2026 License: Apache-2.0 Imports: 5 Imported by: 5

Details

This section is empty.

This section is empty.

func FileResolverFromContext(ctx context.Context) xfile.Resolver

func PoolsFromContext(ctx context.Context) map[string][]string

func SignalReady(ctx context.Context)

SignalReady notifies the supervisor that the current service is ready. It is a no-op for standalone executions that have no bound service signal.

func WithActionResolver(ctx context.Context, resolver ActionResolver) context.Context

func WithCompiler(ctx context.Context, c PipelineCompiler) context.Context

func WithFileResolver(ctx context.Context, resolver xfile.Resolver) context.Context

func WithPools(ctx context.Context, pools map[string][]string) context.Context

func WithRecoveredError(ctx context.Context, r *RecoveredError) context.Context

func WithServiceReady(ctx context.Context, signal *ReadySignal) context.Context

WithServiceReady binds a readiness signal to a service invocation context.

type ActionResolver interface {
	Action(name string) (action.AnyAction, bool)
}

ActionResolver abstracts capability lookups without coupling to a static Registry.

func ActionResolverFromContext(ctx context.Context) ActionResolver

type PipelineCompiler interface {
	CompilePipeline(expr string) (action.Executable, error)
}

func CompilerFromContext(ctx context.Context) PipelineCompiler

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

ReadySignal is a one-shot readiness barrier for a long-lived service. MarkStopped prevents a late readiness notification after the service exits.

func NewReadySignal() *ReadySignal

NewReadySignal creates a readiness barrier.

func (s *ReadySignal) Done() <-chan struct{}

Done returns the channel closed when the service becomes ready.

func (s *ReadySignal) MarkReady()

MarkReady signals readiness once, unless the service has already stopped.

func (s *ReadySignal) MarkStopped()

MarkStopped makes later MarkReady calls no-ops. It does not close Done: dependents are released by the supervisor's cancellation on service exit.

type RecoveredError struct {
	Err       error
	Kind      string
	Suspended bool
}

func RecoveredErrorFrom(ctx context.Context) (*RecoveredError, bool)