cogito

Feb 17, 2026

Changes in this version

+ func WithForceReasoningTool() func(o *Options)

+ type ReasoningResponse struct

+ Reasoning string

Feb 15, 2026

Changes in this version

+ func WithMessagesManipulator(fn func([]openai.ChatCompletionMessage) []openai.ChatCompletionMessage) func(o *Options)

+ type IntentionResponseMultiple struct

+ Reasoning string

+ Tools []string

+ type IntentionResponseSingle struct

+ Reasoning string

+ Tool string

+ type MessageRole string

+ const AssistantMessageRole

+ const SystemMessageRole

+ const ToolMessageRole

+ const UserMessageRole

+ func (m MessageRole) String() string

type Option

+ var EnableAlwaysPickTools Option = func(o *Options) { ... }

+ var EnableParallelToolExecution Option = func(o *Options) { ... }

type ToolStatus

+ ResultData any

type Tools

+ func (t Tools) Names() []string

Jan 15, 2026

Changes in this version

+ func ExtractTODOs(llm LLM, plan *structures.Plan, goal *structures.Goal, opts ...Option) (*structures.TODOList, error)

+ func WithReviewerLLM(reviewerLLM LLM) func(o *Options)

+ func WithTODOPersistence(path string) func(o *Options)

+ func WithTODOs(todoList *structures.TODOList) func(o *Options)

type Option

+ var EnableGuidedTools Option = func(o *Options) { ... }

type Status

+ TODOIteration int

+ TODOPhase string

+ TODOs *structures.TODOList

Dec 7, 2025

Changes in this version

+ var ErrToolCallCallbackInterrupted error = errors.New("interrupted via ToolCallCallback")

+ func WithMaxAdjustmentAttempts(attempts int) func(o *Options)

+ func WithStartWithAction(tool *ToolChoice) func(o *Options)

+ type SessionState struct

+ Fragment Fragment

+ ToolChoice *ToolChoice

+ func (s *SessionState) Resume(llm LLM, opts ...Option) (Fragment, error)

+ type ToolCallDecision struct

+ Adjustment string

+ Approved bool

+ Modified *ToolChoice

+ Skip bool

Dec 3, 2025

Changes in this version

+ func WithSinkState(tool ToolDefinitionInterface) func(o *Options)

type Option

+ var DisableSinkState Option = func(o *Options) { ... }

Nov 7, 2025

Changes in this version

type Fragment

+ func (r Fragment) AddToolMessage(content, toolCallID string) Fragment

Oct 29, 2025

Changes in this version

+ type ToolDefinition struct

+ Description string

+ InputArguments any

+ Name string

+ ToolRunner Tool[T]

+ func (t *ToolDefinition[T]) Execute(args map[string]any) (string, error)

+ func (t ToolDefinition[T]) Tool() openai.Tool

+ type ToolDefinitionInterface interface

+ Execute func(args map[string]any) (string, error)

+ Tool func() openai.Tool

+ func NewToolDefinition[T any](toolRunner Tool[T], inputArguments any, name, description string) ToolDefinitionInterface

Oct 28, 2025

Changes in this version

+ func WithReasoningCallback(fn func(string)) func(o *Options)

type ToolChoice

+ ID string

+ Reasoning string

Oct 26, 2025

Changes in this version

+ var ErrLoopDetected error = errors.New("loop detected: same tool called repeatedly with same parameters")

+ func WithForceReasoning() func(o *Options)

+ func WithLoopDetection(steps int) func(o *Options)

+ func WithMaxRetries(retries int) func(o *Options)

type Fragment

+ func (f Fragment) GetMessages() []openai.ChatCompletionMessage

+ type IntentionResponse struct

+ Reasoning string

+ Tool string

type Option

+ var DisableToolReEvaluator Option = func(o *Options) { ... }

type Status

+ PastActions []ToolStatus

+ ReasoningLog []string

type ToolChoice

+ func ToolReEvaluator(llm LLM, f Fragment, previousTool ToolStatus, tools Tools, ...) (*ToolChoice, string, error)

Oct 21, 2025

Changes in this version

+ var ErrGoalNotAchieved error = errors.New("goal not achieved")

Oct 21, 2025

Changes in this version

+ type PlanStatus struct

+ Plan structures.Plan

+ Tools []ToolStatus

type Status

+ Plans []PlanStatus

Oct 13, 2025

Changes in this version

+ func WithMCPArgs(args map[string]string) func(o *Options)

type Fragment

+ func (f Fragment) LastAssistantAndToolMessages() []openai.ChatCompletionMessage

type Option

+ var EnableAutoPlan Option = func(o *Options) { ... }

+ var EnableAutoPlanReEvaluator Option = func(o *Options) { ... }

+ var EnableMCPPrompts Option = func(o *Options) { ... }

Oct 8, 2025

Changes in this version

+ func WithMCPs(sessions ...*mcp.ClientSession) func(o *Options)

Oct 3, 2025

Changes in this version

+ var ErrNoToolSelected error = errors.New("no tool selected by the LLM")

+ func ExtractBoolean(llm LLM, f Fragment, opts ...Option) (*structures.Boolean, error)

+ func ExtractGoal(llm LLM, f Fragment, opts ...Option) (*structures.Goal, error)

+ func ExtractKnowledgeGaps(llm LLM, f Fragment, opts ...Option) ([]string, error)

+ func ExtractPlan(llm LLM, f Fragment, goal *structures.Goal, opts ...Option) (*structures.Plan, error)

+ func IsGoalAchieved(llm LLM, f Fragment, goal *structures.Goal, opts ...Option) (*structures.Boolean, error)

+ func ReEvaluatePlan(llm LLM, f, subtaskFragment Fragment, goal *structures.Goal, ...) (*structures.Plan, error)

+ func WithContext(ctx context.Context) func(o *Options)

+ func WithFeedbackCallback(fn func() *Fragment) func(o *Options)

+ func WithGaps(gaps ...string) func(o *Options)

+ func WithGuidelines(guidelines ...Guideline) func(o *Options)

+ func WithIterations(i int) func(o *Options)

+ func WithMaxAttempts(i int) func(o *Options)

+ func WithPrompt(t prompt.PromptType, p prompt.StaticPrompt) func(o *Options)

+ func WithStatusCallback(fn func(string)) func(o *Options)

+ func WithToolCallBack(fn func(*ToolChoice) bool) func(o *Options)

+ func WithToolCallResultCallback(fn func(Tool)) func(o *Options)

+ func WithTools(tools ...Tool) func(o *Options)

+ type Fragment struct

+ Messages []openai.ChatCompletionMessage

+ Multimedia []Multimedia

+ ParentFragment *Fragment

+ Status Status

+ func ContentReview(llm LLM, originalFragment Fragment, opts ...Option) (Fragment, error)

+ func ExecutePlan(llm LLM, conv Fragment, plan *structures.Plan, goal *structures.Goal, ...) (Fragment, error)

+ func ExecuteTools(llm LLM, f Fragment, opts ...Option) (Fragment, error)

+ func NewEmptyFragment() Fragment

+ func NewFragment(messages ...openai.ChatCompletionMessage) Fragment

+ func ToolReasoner(llm LLM, f Fragment, opts ...Option) (Fragment, error)

+ func (f Fragment) AddLastMessage(f2 Fragment) Fragment

+ func (f Fragment) AllFragmentsStrings() string

+ func (f Fragment) LastAssistantMessages() []openai.ChatCompletionMessage

+ func (f Fragment) LastMessage() *openai.ChatCompletionMessage

+ func (f Fragment) SelectTool(ctx context.Context, llm LLM, availableTools Tools, forceTool string) (Fragment, *ToolChoice, error)

+ func (f Fragment) String() string

+ func (r Fragment) AddMessage(role, content string, mm ...Multimedia) Fragment

+ func (r Fragment) AddStartMessage(role, content string, mm ...Multimedia) Fragment

+ func (r Fragment) ExtractStructure(ctx context.Context, llm LLM, s structures.Structure) error

+ type Guideline struct

+ Action string

+ Condition string

+ Tools Tools

+ type GuidelineMetadata struct

+ Action string

+ Condition string

+ Tools []string

+ type GuidelineMetadataList []GuidelineMetadata

+ type Guidelines []Guideline

+ func GetRelevantGuidelines(llm LLM, guidelines Guidelines, fragment Fragment, opts ...Option) (Guidelines, error)

+ func (g Guidelines) ToMetadata() GuidelineMetadataList

+ type LLM interface

+ Ask func(ctx context.Context, f Fragment) (Fragment, error)

+ CreateChatCompletion func(ctx context.Context, request openai.ChatCompletionRequest) (openai.ChatCompletionResponse, error)

+ type Multimedia interface

+ URL func() string

+ type OpenAIClient struct

+ func NewOpenAILLM(model, apiKey, baseURL string) *OpenAIClient

+ func (llm *OpenAIClient) Ask(ctx context.Context, f Fragment) (Fragment, error)

+ func (llm *OpenAIClient) CreateChatCompletion(ctx context.Context, request openai.ChatCompletionRequest) (openai.ChatCompletionResponse, error)

+ type Option func(*Options)

+ var EnableDeepContext Option = func(o *Options) { ... }

+ var EnableInfiniteExecution Option = func(o *Options) { ... }

+ var EnableStrictGuidelines Option = func(o *Options) { ... }

+ var EnableToolReEvaluator Option = func(o *Options) { ... }

+ var EnableToolReasoner Option = func(o *Options) { ... }

+ type Options struct

+ Context context.Context

+ DeepContext bool

+ FeedbackCallback func() *Fragment

+ Gaps []string

+ Guidelines Guidelines

+ InfiniteExecution bool

+ MaxAttempts int

+ MaxIterations int

+ Prompts prompt.PromptMap

+ StatusCallback func(string)

+ StrictGuidelines bool

+ ToolCallCallback func(*ToolChoice) bool

+ ToolCallResultCallback func(Tool)

+ ToolReEvaluator bool

+ ToolReasoner bool

+ Tools Tools

+ func (o *Options) Apply(opts ...Option)

+ type Status struct

+ Iterations int

+ ToolResults []ToolStatus

+ ToolsCalled Tools

+ type Tool interface

+ Run func(args map[string]any) (string, error)

+ Tool func() openai.Tool

+ type ToolChoice struct

+ Arguments map[string]any

+ Name string

+ type ToolStatus struct

+ Executed bool

+ Name string

+ Result string

+ ToolArguments ToolChoice

+ type Tools []Tool

+ func (t Tools) Definitions() []*openai.FunctionDefinition

+ func (t Tools) Find(name string) Tool

+ func (t Tools) ToOpenAI() []openai.Tool