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
* 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 ¶
- Constants
- func HasStdin() bool
- func PreprocessArgs(args []string) []string
- type AgentMode
- type AnimationManager
- type ChatCLI
- func (cli *ChatCLI) ApplyOverrides(mgr manager.LLMManager, provider, model string) error
- func (cli *ChatCLI) CancelOperation()
- func (cli *ChatCLI) HandleOneShotOrFatal(ctx context.Context, opts *Options) bool
- func (cli *ChatCLI) IsExecuting() bool
- func (cli *ChatCLI) PrintWelcomeScreen()
- func (cli *ChatCLI) RunAgentOnce(ctx context.Context, input string, autoExecute bool) error
- 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
- type CommandOutput
- type FileChunk
- type HistoryManager
- type InteractionState
- type Logger
- type Options
- type SessionManager
- type SourceType
Constants ¶
const ( SourceTypeUserInput = agent.SourceTypeUserInput SourceTypeFile = agent.SourceTypeFile SourceTypeCommandOutput = agent.SourceTypeCommandOutput )
Constantes re-exportadas
const ( ColorReset = "\033[0m" ColorGreen = "\033[32m" ColorLime = "\033[92m" ColorCyan = "\033[36m" ColorGray = "\033[90m" ColorPurple = "\033[35m" ColorBold = "\033[1m" ColorYellow = "\033[33m" )
ANSI Color Codes
Variables ¶
This section is empty.
Functions ¶
func HasStdin ¶ added in v1.16.1
func HasStdin() bool
Detecta se há dados no stdin (pipe/arquivo ao invés de TTY).
func PreprocessArgs ¶ added in v1.16.2
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 ¶
NewAgentMode cria uma nova instância do modo agente
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
MaxTokensOverride int
UserMaxTokens int
// contains filtered or unexported fields
}
ChatCLI representa a interface de linha de comando do chat
func NewChatCLI ¶
NewChatCLI cria uma nova instância de ChatCLI
func (*ChatCLI) ApplyOverrides ¶ added in v1.16.0
func (cli *ChatCLI) ApplyOverrides(mgr manager.LLMManager, provider, model string) error
ApplyOverrides atualiza provider/model e reobtém o client correspondente
func (*ChatCLI) CancelOperation ¶ added in v1.22.0
func (cli *ChatCLI) CancelOperation()
CancelOperation cancela a operação atual se houver uma
func (*ChatCLI) HandleOneShotOrFatal ¶ added in v1.16.3
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) IsExecuting ¶ added in v1.22.0
IsExecuting retorna true se uma operação está em andamento
func (*ChatCLI) PrintWelcomeScreen ¶ added in v1.18.0
func (cli *ChatCLI) PrintWelcomeScreen()
PrintWelcomeScreen exibe a tela de boas-vindas completa.
func (*ChatCLI) RunAgentOnce ¶ added in v1.19.0
RunAgentOnce executa o modo agente de forma não-interativa (one-shot)
type CommandBlock ¶
type CommandBlock = agent.CommandBlock
Aliases de tipos para manter compatibilidade
type CommandContextInfo ¶
type CommandContextInfo = agent.CommandContextInfo
Aliases de tipos para manter compatibilidade
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 = agent.CommandOutput
Aliases de tipos para manter compatibilidade
type HistoryManager ¶
type HistoryManager struct {
// contains filtered or unexported fields
}
func NewHistoryManager ¶
func NewHistoryManager(logger *zap.Logger) *HistoryManager
func (*HistoryManager) AppendAndRotateHistory ¶ added in v1.19.1
func (hm *HistoryManager) AppendAndRotateHistory(newCommands []string) error
AppendAndRotateHistory salva o histórico no arquivo e faz backup se o tamanho exceder o limite
func (*HistoryManager) LoadHistory ¶
func (hm *HistoryManager) LoadHistory() ([]string, error)
LoadHistory carrega o histórico do arquivo
type InteractionState ¶ added in v1.22.0
type InteractionState int
const ( StateNormal InteractionState = iota StateSwitchingProvider StateProcessing StateAgentMode )
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 ¶ added in v1.16.0
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
AgentAutoExec bool // --agent-auto-exec
MaxTokens int // --max-tokens
Realm string // --realm
AgentID string // --agent-id
}
Options representa as flags suportadas pelo binário
func NewFlagSet ¶ added in v1.16.0
NewFlagSet cria um FlagSet isolado e as Options para parsing
type SessionManager ¶ added in v1.23.0
type SessionManager struct {
// contains filtered or unexported fields
}
SessionManager gerencia o salvamento e carregamento de sessões de conversa.
func NewSessionManager ¶ added in v1.23.0
func NewSessionManager(logger *zap.Logger) (*SessionManager, error)
NewSessionManager cria uma nova instância do SessionManager.
func (*SessionManager) DeleteSession ¶ added in v1.23.0
func (sm *SessionManager) DeleteSession(name string) error
DeleteSession apaga um arquivo de sessão.
func (*SessionManager) ListSessions ¶ added in v1.23.0
func (sm *SessionManager) ListSessions() ([]string, error)
ListSessions lista todas as sessões salvas.
func (*SessionManager) LoadSession ¶ added in v1.23.0
func (sm *SessionManager) LoadSession(name string) ([]models.Message, error)
LoadSession carrega o histórico de uma conversa de um arquivo JSON.
func (*SessionManager) SaveSession ¶ added in v1.23.0
func (sm *SessionManager) SaveSession(name string, history []models.Message) error
SaveSession salva o histórico da conversa em um arquivo JSON.