nativeconfig

type Action string

type Codec string

type CommittedCleanupError struct{ Err error }

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

type FileEffect string

type FileIO interface {
	ReadNoFollow(path string) (body []byte, mode os.FileMode, exists bool, err error)
	WriteAtomic(path string, body []byte, mode os.FileMode) error
	RemoveNoFollow(path string) error
}

type FileSnapshot struct {
	Body   []byte
	Mode   os.FileMode
	Exists bool
}

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

type OpenCodeNamespaceConflict struct {
	Proposed string
	Existing string
	Reason   string
}

type OpenCodeV2Options struct {
	Disabled bool               `json:"disabled"`
	Timeout  *OpenCodeV2Timeout `json:"timeout,omitempty"`
}

type OpenCodeV2Timeout struct {
	Startup   int `json:"startup,omitempty"`
	Catalog   int `json:"catalog,omitempty"`
	Execution int `json:"execution,omitempty"`
}

type Paths struct {
	JSON  string
	JSONC string
}

type Placeholders struct {
	PackageRoot string
	DataRoot    string
}

type PreparedTransition struct {
	Path                     string
	Original                 FileSnapshot
	TargetBytes              []byte
	TargetHash               string
	SourceCodec, TargetCodec Codec
	Entries                  []PreparedTransitionEntry
}

type PreparedTransitionEntry struct {
	LogicalID             string
	Name                  string
	SourceReceipt         Receipt
	PreviouslyOwnedTarget *Receipt
	TargetReceipt         Receipt
}

type Receipt struct {
	Version string `json:"version"`
	Path    string `json:"path"`
	Codec   Codec  `json:"codec"`
	Name    string `json:"name"`
	Digest  string `json:"digest"`
}

type Request struct {
	Paths        Paths
	Codec        Codec
	Action       Action
	Name         string
	Server       Server
	Placeholders Placeholders
	Owned        *Receipt
	// Desired optionally binds add/update to the exact projected receipt the
	// caller staged. ApplyBatch compares it before any config write, including
	// the selected JSON/JSONC path, so selection drift cannot commit first and
	// fail only during a provider postcondition.
	Desired *Receipt
}

type Server struct {
	// Trusted adapters set these only after portable expansion. They are not
	// native fields or persisted payload flags; projection readers restore them.
	StdioValuesResolved bool              `json:"-"`
	CWDResolved         bool              `json:"-"`
	Type                string            `json:"type"`
	Command             string            `json:"command,omitempty"`
	Args                []string          `json:"args,omitempty"`
	Env                 map[string]string `json:"env,omitempty"`
	CWD                 string            `json:"cwd,omitempty"`
	URL                 string            `json:"url,omitempty"`
	Headers             map[string]string `json:"headers,omitempty"`
	// RemoteTransport selects codec-specific native keys where supported.
	// OpenCode V2 accepts empty (native default) or streamable-http; V1 keeps
	// rejecting an explicit transport. Unsupported transports are never dropped.
	RemoteTransport string `json:"remote_transport,omitempty"`
	// OpenCodeV2 carries only the pinned V2 disabled/timeout contract. Other
	// codecs reject it rather than silently discard dialect-specific intent.
	OpenCodeV2 *OpenCodeV2Options `json:"opencode_v2,omitempty"`
}

type TransitionEntry struct {
	LogicalID          string
	Name               string
	SourceOwned        Receipt
	TargetOwned        *Receipt
	TargetServer       Server
	TargetPlaceholders Placeholders
	DesiredReceipt     Receipt
}

type TransitionObservation string

type TransitionRecoveryRequest struct {
	Paths    Paths
	Prepared PreparedTransition
	// Callbacks run under the same candidate lease as classification and restore.
	// An error alone grants no restore authority. Desired or unknown never restores.
	Decide   func(TransitionObservation) (TransitionStateDecision, error)
	Complete func(TransitionObservation) error
}

type TransitionRequest struct {
	Paths                    Paths
	SourceCodec, TargetCodec Codec
	Entries                  []TransitionEntry
	// PersistPrepared must durably persist the supplied facts before returning
	// nil. It runs under the native file locks: callers acquire their operation
	// lock first, and must not reenter the kernel here. The provider owns journal
	// IDs, projection/skill linkage and recovery/state publication. A callback is
	// required; kernel success alone does not complete that provider transaction.
	PersistPrepared func(PreparedTransition) error
}

type TransitionStateDecision string