cli

Documentation

Overview

* ChatCLI - Command Line Interface for LLM interaction * Copyright (c) 2024 Edilson Freitas * License: MIT

* ChatCLI - Command Line Interface for LLM interaction * Copyright (c) 2024 Edilson Freitas * License: MIT

* ChatCLI - Command Line Interface for LLM interaction * Copyright (c) 2024 Edilson Freitas * License: MIT

* ChatCLI - Command Line Interface for LLM interaction * Copyright (c) 2024 Edilson Freitas * License: MIT

Index

• func HasStdin() bool
• func PreprocessArgs(args []string) []string
• type AgentMode
  • func NewAgentMode(cli *ChatCLI, logger *zap.Logger) *AgentMode
  • func (a *AgentMode) Run(ctx context.Context, query string, additionalContext string) error
• type AnimationManager
  • func NewAnimationManager() *AnimationManager
  • func (am *AnimationManager) ShowThinkingAnimation(message string)
  • func (am *AnimationManager) StopThinkingAnimation()
  • func (am *AnimationManager) UpdateMessage(message string)
• type ChatCLI
  • func NewChatCLI(manager manager.LLMManager, logger *zap.Logger) (*ChatCLI, error)
  • func (cli *ChatCLI) ApplyOverrides(mgr manager.LLMManager, provider, model string) error
  • func (cli *ChatCLI) HandleOneShotOrFatal(ctx context.Context, opts *Options) bool
  • func (cli *ChatCLI) RunOnce(ctx context.Context, input string, disableAnimation bool) error
  • func (cli *ChatCLI) Start(ctx context.Context)
• type CommandBlock
• type CommandContextInfo
• type CommandHandler
  • func NewCommandHandler(cli *ChatCLI) *CommandHandler
  • func (ch *CommandHandler) HandleCommand(userInput string) bool
• type CommandOutput
• type FileChunk
• type HistoryManager
  • func NewHistoryManager(logger *zap.Logger) *HistoryManager
  • func (hm *HistoryManager) LoadHistory() ([]string, error)
  • func (hm *HistoryManager) SaveHistory(commandHistory []string) error
• type Liner
• type Logger
• type Options
  • func NewFlagSet() (*flag.FlagSet, *Options)
  • func Parse(args []string) (*Options, error)
• type SourceType

Functions

func HasStdin

func HasStdin() bool

Detecta se há dados no stdin (pipe/arquivo ao invés de TTY).

func PreprocessArgs

func PreprocessArgs(args []string) []string

PreprocessArgs normaliza o caso de -p/--prompt sem valor, convertendo para -p= / --prompt= Ex.: echo "msg" | chatcli -p -> trata como prompt vazio + stdin (não quebra o flag parser)

Types

type AgentMode

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

AgentMode representa a funcionalidade de agente autônomo no ChatCLI

func NewAgentMode

func NewAgentMode(cli *ChatCLI, logger *zap.Logger) *AgentMode

NewAgentMode cria uma nova instância do modo agente

func (*AgentMode) Run

func (a *AgentMode) Run(ctx context.Context, query string, additionalContext string) error

Run inicia o modo agente com uma pergunta do usuário

type AnimationManager

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

func NewAnimationManager

func NewAnimationManager() *AnimationManager

func (*AnimationManager) ShowThinkingAnimation

func (am *AnimationManager) ShowThinkingAnimation(message string)

ShowThinkingAnimation inicia ou atualiza a animação "pensando"

func (*AnimationManager) StopThinkingAnimation

func (am *AnimationManager) StopThinkingAnimation()

StopThinkingAnimation para a animação de forma segura

func (*AnimationManager) UpdateMessage

func (am *AnimationManager) UpdateMessage(message string)

UpdateMessage atualiza a mensagem sem parar e reiniciar a animação

type ChatCLI

type ChatCLI struct {
	Client client.LLMClient

	Provider string
	Model    string
	// contains filtered or unexported fields
}

ChatCLI representa a interface de linha de comando do chat

func NewChatCLI

func NewChatCLI(manager manager.LLMManager, logger *zap.Logger) (*ChatCLI, error)

NewChatCLI cria uma nova instância de ChatCLI

func (*ChatCLI) ApplyOverrides

func (cli *ChatCLI) ApplyOverrides(mgr manager.LLMManager, provider, model string) error

ApplyOverrides atualiza provider/model e reobtém o client correspondente

func (*ChatCLI) HandleOneShotOrFatal

func (cli *ChatCLI) HandleOneShotOrFatal(ctx context.Context, opts *Options) bool

HandleOneShotOrFatal executa o modo one-shot se solicitado (flag -p usada ou stdin presente). - Em caso de erro, imprime mensagem em Markdown (stderr) e faz logger.Fatal (sem fallback). - Retorna true se o one-shot foi tratado (com sucesso ou erro fatal). Retorna false se não foi acionado.

func (*ChatCLI) RunOnce

func (cli *ChatCLI) RunOnce(ctx context.Context, input string, disableAnimation bool) error

func (*ChatCLI) Start

func (cli *ChatCLI) Start(ctx context.Context)

Start inicia o loop principal do ChatCLI

type CommandBlock

type CommandBlock struct {
	Description string
	Commands    []string
	Language    string
	ContextInfo CommandContextInfo
}

CommandBlock representa um bloco de comandos executáveis

type CommandContextInfo

type CommandContextInfo struct {
	SourceType    SourceType
	FileExtension string
	IsScript      bool
	ScriptType    string // shell, python, etc.
}

CommandContextInfo contém metadados sobre a origem e natureza de um comando

type CommandHandler

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

func NewCommandHandler

func NewCommandHandler(cli *ChatCLI) *CommandHandler

func (*CommandHandler) HandleCommand

func (ch *CommandHandler) HandleCommand(userInput string) bool

Atualizar o método HandleCommand no CommandHandler para incluir os novos comandos

type CommandOutput

type CommandOutput struct {
	CommandBlock CommandBlock
	Output       string
	ErrorMsg     string
}

type FileChunk

type FileChunk struct {
	Index   int
	Total   int
	Content string
}

FileChunk representa um pedaço do conteúdo de arquivos

type HistoryManager

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

func NewHistoryManager

func NewHistoryManager(logger *zap.Logger) *HistoryManager

func (*HistoryManager) LoadHistory

func (hm *HistoryManager) LoadHistory() ([]string, error)

LoadHistory carrega o histórico do arquivo

func (*HistoryManager) SaveHistory

func (hm *HistoryManager) SaveHistory(commandHistory []string) error

SaveHistory salva o histórico no arquivo e faz backup se o tamanho exceder o limite

type Liner

type Liner interface {
	Prompt(string) (string, error)
	Close() error
	SetCtrlCAborts(bool)
	AppendHistory(string)
	SetCompleter(liner.Completer)
}

Adicione a interface Liner

type Logger

type Logger interface {
	Info(msg string, fields ...zap.Field)
	Error(msg string, fields ...zap.Field)
	Warn(msg string, fields ...zap.Field)
	Sync() error
}

Logger interface para facilitar a testabilidade

type Options

type Options struct {
	// Geral
	Version bool // --version | -v
	Help    bool // --help | -h

	// Modo one-shot
	Prompt         string        // -p | --prompt
	Provider       string        // --provider
	Model          string        // --model
	Timeout        time.Duration // --timeout
	NoAnim         bool          // --no-anim
	PromptFlagUsed bool          // indica se -p/--prompt foi passado explicitamente
}

Options representa as flags suportadas pelo binário

func NewFlagSet

func NewFlagSet() (*flag.FlagSet, *Options)

NewFlagSet cria um FlagSet isolado e as Options para parsing

func Parse

func Parse(args []string) (*Options, error)

Parse analisa os args, valida e retorna Options

type SourceType

type SourceType int

const (
	SourceTypeUserInput SourceType = iota
	SourceTypeFile
	SourceTypeCommandOutput
)