boid

type AgentPosition struct {
	// LoopID is the unique identifier for the agentic loop.
	LoopID string `json:"loop_id"`

	// Role is the agent's role (general, architect, editor, reviewer).
	Role string `json:"role"`

	// FocusEntities are the entity IDs the agent is currently working on.
	FocusEntities []string `json:"focus_entities"`

	// TraversalVector contains the relationship predicates being followed.
	// This represents the agent's "heading" in graph space.
	TraversalVector []string `json:"traversal_vector"`

	// Velocity represents the rate of position change (0.0-1.0).
	// Higher values indicate more active exploration.
	Velocity float64 `json:"velocity"`

	// Iteration is the current loop iteration number.
	Iteration int `json:"iteration"`

	// LastUpdate is when this position was last updated.
	LastUpdate time.Time `json:"last_update"`
}

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

type CentralityProvider interface {
	// GetPageRankScores returns PageRank scores for a set of entities.
	// Returns a map of entity ID to score (0.0-1.0).
	GetPageRankScores(ctx context.Context, entityIDs []string) (map[string]float64, error)
}

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

type Config struct {
	// BoidRule specifies the rule type: separation, cohesion, or alignment.
	BoidRule string `json:"boid_rule"`

	// RoleFilter limits the rule to agents with this role (empty = all roles).
	RoleFilter string `json:"role_filter,omitempty"`

	// RoleThresholds maps role names to k-hop separation thresholds.
	// Used by separation rules to allow different thresholds per role.
	RoleThresholds map[string]int `json:"role_thresholds,omitempty"`

	// SeparationThreshold is the default k-hop distance for separation (if RoleThresholds not set).
	SeparationThreshold int `json:"separation_threshold,omitempty"`

	// CentralityWeight is the weight for centrality attraction in cohesion rules (0.0-1.0).
	CentralityWeight float64 `json:"centrality_weight,omitempty"`

	// AlignmentWindow is the number of recent traversals to consider for alignment.
	AlignmentWindow int `json:"alignment_window,omitempty"`

	// SteeringStrength is how much to influence agent behavior (0.0-1.0).
	SteeringStrength float64 `json:"steering_strength"`

	// Cooldown specifies minimum time between signal emissions.
	Cooldown string `json:"cooldown,omitempty"`
}

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

type PositionProvider interface {
	Get(ctx context.Context, loopID string) (*AgentPosition, error)
	ListOthers(ctx context.Context, excludeLoopID string) ([]*AgentPosition, error)
}

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

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

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

type SignalGenerator interface {
	GetPendingSignals() []*SteeringSignal
}

type SteeringSignal struct {
	// LoopID identifies which agent loop should receive this signal.
	LoopID string `json:"loop_id"`

	// SignalType identifies the rule type: separation, cohesion, or alignment.
	SignalType string `json:"signal_type"`

	// SuggestedFocus contains entity IDs to prioritize (cohesion signals).
	SuggestedFocus []string `json:"suggested_focus,omitempty"`

	// AvoidEntities contains entity IDs to deprioritize (separation signals).
	AvoidEntities []string `json:"avoid_entities,omitempty"`

	// AlignWith contains predicate patterns to favor (alignment signals).
	AlignWith []string `json:"align_with,omitempty"`

	// Strength indicates how strongly to apply the signal (0.0-1.0).
	Strength float64 `json:"strength"`

	// SourceRule identifies which rule generated this signal.
	SourceRule string `json:"source_rule,omitempty"`

	// Timestamp is when this signal was generated.
	Timestamp time.Time `json:"timestamp"`

	// Metadata contains additional context about the signal.
	Metadata map[string]any `json:"metadata,omitempty"`
}