offline

type BindingCatalog interface {
	DescribeBinding(context.Context, ExternalBinding, graph.Node, stepkind.StepKindSpec) (BindingDescription, error)
}

type BindingCatalogFunc func(context.Context, ExternalBinding, graph.Node, stepkind.StepKindSpec) (BindingDescription, error)

type BindingDescription struct {
	EffectiveEffects graph.EffectSet `json:"effective_effects,omitempty"`
	Capabilities     []string        `json:"capabilities,omitempty"`
	RemoteWait       bool            `json:"remote_wait,omitempty"`
}

type BuildOptions struct {
	Registry stepkind.Registry
	// SourceRegistry is the authoring/daemon catalog when Registry contains
	// explicit binding-backed executable proxies. Nil means Registry.
	SourceRegistry   stepkind.Registry
	Bindings         []ExternalBinding
	BindingCatalog   BindingCatalog
	Mode             Mode
	ToolName         string
	MaxManifestBytes int
	MaxBindingBytes  int
}

type BuildResult struct {
	Manifest    *Manifest
	Bytes       []byte
	Diagnostics []diagnostic.Diagnostic
}

type DiagnosticError struct{ Diagnostics []diagnostic.Diagnostic }

type ExecuteOptions struct {
	Registry       stepkind.Registry
	RegistryBinder RuntimeRegistryBinder
	Verifiers      verification.Registry
	Inputs         map[string]any
	Now            func() time.Time
	MaxSteps       int
	// PollInterval bounds durable external-operation observation cadence.
	// Zero selects 100ms; tests may inject a shorter positive cadence.
	PollInterval time.Duration
	// RunID and IdempotencyKey let an ordinary host use the embedded engine
	// while preserving its caller-visible identity. Generated/offline callers
	// may omit both and receive deterministic content-derived defaults.
	RunID          runtime.RunID
	IdempotencyKey string
}

type ExecutionResult struct {
	Run     runtime.RunSnapshot `json:"run"`
	Outputs values.ValueSet     `json:"outputs,omitempty"`
}

type ExecutionStore interface {
	runtime.StateStore
	runtime.RecoveryStore
	runtime.NodeInputStore
	runtime.ControlFlowStore
	runtime.RunPolicyStore
	runtime.FanOutStore
}

type ExternalBinding struct {
	NodeID       string          `json:"node_id"`
	Kind         string          `json:"kind"`
	Version      string          `json:"version"`
	Driver       string          `json:"driver"`
	Config       graph.Config    `json:"config,omitempty"`
	Effects      graph.EffectSet `json:"effects,omitempty"`
	Capabilities []string        `json:"capabilities,omitempty"`
}

type Manifest struct {
	SchemaVersion string                      `json:"schema_version"`
	Mode          Mode                        `json:"mode"`
	BuildDigest   string                      `json:"build_digest"`
	PlanDigest    string                      `json:"plan_digest"`
	Plan          compile.ExecutionPlan       `json:"plan"`
	Visibility    compile.ValueVisibilityPlan `json:"visibility"`
	Inputs        []SchemaField               `json:"inputs,omitempty"`
	Outputs       []SchemaField               `json:"outputs,omitempty"`
	StepKinds     []stepkind.StepKindSpec     `json:"step_kinds"`
	Bindings      []ResolvedBinding           `json:"bindings,omitempty"`
	ToolName      string                      `json:"tool_name,omitempty"`
}

type Mode string

type RemoteExecutionProfile struct {
	Driver              string          `json:"driver"`
	NodeID              string          `json:"node_id"`
	Kind                string          `json:"kind"`
	Version             string          `json:"version"`
	NodeConfigDigest    string          `json:"node_config_digest"`
	SourceSpecDigest    string          `json:"source_spec_digest"`
	ExecutionSpecDigest string          `json:"execution_spec_digest"`
	Effects             graph.EffectSet `json:"effects,omitempty"`
	Capabilities        []string        `json:"capabilities,omitempty"`
}

type ResolvedBinding struct {
	Binding     ExternalBinding    `json:"binding"`
	Description BindingDescription `json:"description"`
	// SourceSpec is the exact daemon kind contract adapted by the versioned
	// remote driver. Manifest StepKinds contains the actual executable proxy
	// contract; recording both makes the adaptation explicit and reviewable.
	SourceSpec stepkind.StepKindSpec `json:"source_spec"`
	// ExecutionProfile labels the binding-backed proxy rather than presenting
	// it as the original public adapter contract. It is sent on every remote
	// invocation so the daemon can enforce the exact build-time narrowing.
	ExecutionProfile RemoteExecutionProfile `json:"execution_profile"`
}

type RunFailureError struct {
	Run     runtime.RunSnapshot
	Failure *runtime.Failure
}

type RuntimeRegistryBinder interface {
	BindRuntimeRegistry(context.Context, stepkind.Registry, ExecutionStore, Manifest) (stepkind.Registry, error)
}

type RuntimeRegistryBinderFunc func(context.Context, stepkind.Registry, ExecutionStore, Manifest) (stepkind.Registry, error)

type SchemaField struct {
	Name        string       `json:"name"`
	Description string       `json:"description,omitempty"`
	Required    bool         `json:"required,omitempty"`
	Schema      graph.Schema `json:"schema"`
}