Go Packages

type Config struct {
    cortex.Entity
    ID, AppID, Name, Description, SystemPrompt, Model string
    Tools []string                    // flat mode
    PersonaRef string                 // persona mode
    MaxSteps, MaxTokens int
    Temperature float64
    ReasoningLoop string
    InlineSkills, InlineTraits, InlineBehaviors []string
    Guardrails, Metadata map[string]any
}

type Store interface {  // 6 methods
    Create, Get, GetByName, Update, Delete, List
}

type Skill struct {
    cortex.Entity
    ID, AppID, Name, Description string
    Tools []ToolBinding
    Knowledge []KnowledgeRef
    SystemPromptFragment, DefaultProficiency string
    Dependencies []string
}

// Proficiency levels: Novice (0.2), Beginner (0.4),
// Competent (0.6), Proficient (0.8), Expert (1.0)

type Store interface {  // 6 methods
    CreateSkill, GetSkill, GetSkillByName, UpdateSkill, DeleteSkill, ListSkills
}

type Trait struct {
    cortex.Entity
    ID, AppID, Name, Description string
    Dimensions []Dimension    // bipolar axes (e.g. detached - empathetic)
    Influences []Influence    // 5 targets: tone, vocabulary, reasoning, etc.
    Category TraitCategory    // cognitive, emotional, social, behavioral
}

type Store interface {  // 6 methods
    CreateTrait, GetTrait, GetTraitByName, UpdateTrait, DeleteTrait, ListTraits
}

type Behavior struct {
    cortex.Entity
    ID, AppID, Name, Description string
    Triggers []Trigger      // 6 types: keyword_match, sentiment_below, etc.
    Actions  []Action       // 6 types: inject_prompt, modify_tone, etc.
    Priority int
    RequiresSkill, RequiresTrait string
}

type Store interface {  // 6 methods
    CreateBehavior, GetBehavior, GetBehaviorByName, UpdateBehavior, DeleteBehavior, ListBehaviors
}

type Persona struct {
    cortex.Entity
    ID, AppID, Name, Description, Identity string
    Skills []SkillAssignment
    Traits []TraitAssignment
    Behaviors []string
    CognitiveStyle *cognitive.Style
    CommunicationStyle *communication.Style
    Perception *perception.Model
}

type Store interface {  // 6 methods
    CreatePersona, GetPersona, GetPersonaByName, UpdatePersona, DeletePersona, ListPersonas
}

type Style struct {
    Phases []Phase
}
type Phase struct {
    Name, Prompt string
    Strategy Strategy      // analytical, creative, methodical, intuitive, critical, collaborative
    TransitionCondition    // on_complete, on_confidence, on_timeout, on_external
}

type Style struct {
    Tone, Formality, Verbosity string
    TechnicalLevel, EmojiUsage, PreferredFormat string
    AdaptToUser bool
}

type Model struct {
    AttentionFilter AttentionFilter
    ContextWindow, DetailOrientation string
}
type AttentionFilter struct {
    Name string
    Keywords, Patterns []string
    Prompt string
}

type Run struct {
    ID id.AgentRunID
    AgentID, TenantID, State, Input, Output, Error string
    StepCount, TokensUsed int
    StartedAt, CompletedAt *time.Time
}
// RunStates: created, running, completed, failed, cancelled, paused

type Step struct { ID, RunID, Index, Type, Input, Output, TokensUsed, ... }
type ToolCall struct { ID, StepID, RunID, ToolName, Arguments, Result, Error, ... }

type Store interface {  // 8 methods
    CreateRun, GetRun, UpdateRun, ListRuns,
    CreateStep, ListSteps,
    CreateToolCall, ListToolCalls
}

type Message struct {
    Role, Content string
    ToolCalls []ToolCallRef
    Metadata map[string]any
    Timestamp time.Time
}

type Store interface {  // 8 methods
    SaveConversation, LoadConversation, ClearConversation,
    SaveWorking, LoadWorking, ClearWorking,
    SaveSummary, LoadSummaries
}

type Checkpoint struct {
    ID id.CheckpointID
    RunID, AgentID, TenantID string
    Reason, State string
    Decision *Decision
}
type Decision struct {
    Approved bool
    DecidedBy, Reason string
    DecidedAt time.Time
}

type Store interface {  // 4 methods
    CreateCheckpoint, GetCheckpoint, Resolve, ListPending
}

// 12 type aliases
type AgentID, SkillID, TraitID, BehaviorID, PersonaID string
type AgentRunID, StepID, ToolCallID, CheckpointID string
type MemoryID, OrchestrationID, HandoffID string

// Constructors: NewAgentID(), NewSkillID(), ...
// Parsers: ParseAgentID(s), ParseSkillID(s), ...

// Prefixes: agt_, skl_, trt_, bhv_, prs_, arun_, astp_, tcall_, cp_, mem_, orch_, hoff_

type Store interface {
    agent.Store      // 6 methods
    skill.Store      // 6 methods
    trait.Store      // 6 methods
    behavior.Store   // 6 methods
    persona.Store    // 6 methods
    run.Store        // 8 methods
    memory.Store     // 8 methods
    checkpoint.Store // 4 methods
    Migrate(ctx) error
    Ping(ctx) error
    Close() error
}

func New(db *bun.DB) *Store

func New() *Store

type Extension interface { Name() string }

// 16 hook interfaces: RunStarted, RunCompleted, RunFailed,
// StepStarted, StepCompleted, ToolCalled, ToolCompleted, ToolFailed,
// PersonaResolved, BehaviorTriggered, CognitivePhaseChanged,
// CheckpointCreated, CheckpointResolved,
// OrchestrationStarted, OrchestrationCompleted, AgentHandoff,
// Shutdown

type Registry struct { ... }
func NewRegistry(logger) *Registry
func (r *Registry) Register(Extension)
func (r *Registry) Extensions() []Extension
// 16 Emit methods: EmitRunStarted, EmitRunCompleted, ...

func NewMetricsExtension() *MetricsExtension
func NewMetricsExtensionWithFactory(factory gu.MetricFactory) *MetricsExtension

func New(recorder Recorder, opts ...Option) *Extension
type Recorder interface { Record(ctx, AuditEvent) error }
type RecorderFunc func(ctx, AuditEvent) error   // adapter
// Options: WithActions(...), WithLogger(...)
// 18 action constants, 8 resource constants

func New(eng *engine.Engine, router forge.Router) *API
func (a *API) Handler() http.Handler
func (a *API) RegisterRoutes(router forge.Router)

func New(opts ...ExtOption) *Extension
func (e *Extension) Engine() *engine.Engine
func (e *Extension) API() *api.API
// Implements forge.Extension: Name, Description, Version, Dependencies,
// Register, Start, Stop, Health, RegisterRoutes, Handler
// Options: WithStore, WithExtension, WithEngineOption, WithConfig,
// WithDisableRoutes, WithDisableMigrate, WithBasePath, WithLogger