soul

type AuthoringError struct {
	Code        string
	Diagnostics []Diagnostic
	// contains filtered or unexported fields
}

type AuthoringIdentity struct {
	Kind string
	Ref  string
}

type AuthoringOption func(*ManagedSoulAuthoringService)

type AuthoringService interface {
	Validate(ctx context.Context, req ValidateRequest) (ValidateResult, error)
	Put(ctx context.Context, req PutRequest) (MutationResult, error)
	Delete(ctx context.Context, req DeleteRequest) (MutationResult, error)
	History(ctx context.Context, req HistoryRequest) (HistoryResult, error)
	Rollback(ctx context.Context, req RollbackRequest) (MutationResult, error)
}

type AuthoringStore interface {
	UpsertSoulSnapshot(ctx context.Context, snapshot Snapshot) (Snapshot, error)
	AppendSoulRevision(ctx context.Context, revision Revision) (Revision, error)
	ListSoulRevisions(ctx context.Context, query RevisionListQuery) ([]Revision, error)
	FindSoulRevisionForRollback(ctx context.Context, query RollbackLookup) (Revision, error)
}

type AuthoringTarget struct {
	WorkspaceID   string
	WorkspaceRoot string
	AgentName     string
	AgentPath     string
	Config        aghconfig.SoulConfig
	ConfigSource  string
}

type CompactProjection struct {
	Enabled      bool
	Present      bool
	Active       bool
	Digest       string
	SourcePath   string
	Role         string
	Tone         []string
	Principles   []string
	Truncated    bool
	MaxBytes     int64
	MaxBodyBytes int64
}

type ConfigProvenance struct {
	Digest                 string `json:"digest"`
	Source                 string `json:"source,omitempty"`
	Enabled                bool   `json:"enabled"`
	MaxBodyBytes           int64  `json:"max_body_bytes"`
	ContextProjectionBytes int64  `json:"context_projection_bytes"`
}

type DeleteRequest struct {
	Target         AuthoringTarget
	ExpectedDigest string
	Actor          AuthoringIdentity
	Origin         AuthoringIdentity
}

type Diagnostic struct {
	Code       string
	Field      string
	Section    string
	Message    string
	SourcePath string
	Line       int
	Column     int
}

type DiagnosticError struct {
	Diagnostics []Diagnostic
	// contains filtered or unexported fields
}

type Frontmatter struct {
	Version       string
	Role          string
	Tone          []string
	Principles    []string
	Constraints   []string
	Collaboration []string
	MemoryPolicy  []string
	Tags          []string
}

type HistoryRequest struct {
	Target AuthoringTarget
	Limit  int
}

type HistoryResult struct {
	Revisions []Revision
}

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

type MutationResult struct {
	Soul     ResolvedSoul
	Snapshot Snapshot
	Revision Revision
}

type ParseRequest struct {
	SourcePath    string
	WorkspaceRoot string
	Content       []byte
	Config        aghconfig.SoulConfig
}

type Profile struct {
	SourcePath    string
	Digest        string
	Version       string
	Role          string
	Tone          []string
	Principles    []string
	Constraints   []string
	Collaboration []string
	MemoryPolicy  []string
	Tags          []string
	Body          string
	Truncated     bool
}

type PutRequest struct {
	Target         AuthoringTarget
	Body           string
	ExpectedDigest string
	Actor          AuthoringIdentity
	Origin         AuthoringIdentity
}

type ReadModel struct {
	Enabled                bool
	Present                bool
	Active                 bool
	Valid                  bool
	SourcePath             string
	Digest                 string
	Frontmatter            Frontmatter
	Body                   string
	Truncated              bool
	MaxBodyBytes           int64
	ContextProjectionBytes int64
	Diagnostics            []Diagnostic
}

type ResolveRequest struct {
	AgentPath     string
	WorkspaceRoot string
	Config        aghconfig.SoulConfig
}

type ResolvedSoul struct {
	Enabled     bool
	Present     bool
	Active      bool
	Valid       bool
	SourcePath  string
	Digest      string
	Profile     Profile
	Compact     CompactProjection
	ReadModel   ReadModel
	Diagnostics []Diagnostic
}

type ResourceSpec struct {
	AgentName       string `json:"agent_name"`
	AgentResourceID string `json:"agent_resource_id"`
	SourcePath      string `json:"source_path"`
	Body            string `json:"body"`
}

type Revision struct {
	ID              string
	WorkspaceID     string
	AgentName       string
	SourcePath      string
	Action          RevisionAction
	PreviousDigest  string
	NewDigest       string
	Body            string
	DiagnosticsJSON json.RawMessage
	ActorKind       string
	ActorID         string
	OriginKind      string
	OriginRef       string
	CreatedAt       time.Time
}

type RevisionAction string

type RevisionListQuery struct {
	WorkspaceID string
	AgentName   string
	Action      RevisionAction
	Limit       int
}

type RollbackLookup struct {
	WorkspaceID string
	AgentName   string
	RevisionID  string
}

type RollbackRequest struct {
	Target         AuthoringTarget
	RevisionID     string
	ExpectedDigest string
	Actor          AuthoringIdentity
	Origin         AuthoringIdentity
}

type Snapshot struct {
	ID          string
	WorkspaceID string
	AgentName   string
	SourcePath  string
	Digest      string
	ProfileJSON json.RawMessage
	Body        string
	Truncated   bool
	CreatedAt   time.Time
}

type SnapshotListQuery struct {
	WorkspaceID string
	AgentName   string
	Digest      string
	Limit       int
}

type SnapshotProfile struct {
	SchemaVersion    int               `json:"schema_version"`
	Present          bool              `json:"present"`
	Active           bool              `json:"active"`
	Valid            bool              `json:"valid"`
	Profile          Profile           `json:"profile"`
	Compact          CompactProjection `json:"compact"`
	ReadModel        ReadModel         `json:"read_model"`
	ConfigProvenance ConfigProvenance  `json:"config_provenance"`
	Diagnostics      []Diagnostic      `json:"diagnostics,omitempty"`
}

type ValidateRequest struct {
	Target AuthoringTarget
	Body   *string
}

type ValidateResult struct {
	Soul ResolvedSoul
}