# Chat

A Limnoria plugin that brings ChatGPT into your IRC channel

## Installation

1. Install the plugin
2. Put your API key in the plugin configuration registry like so:

```
/msg BotName config plugins.Chat.api_key YOUR_API_KEY
```

3. Load the plugin:

```
load Chat
```

## Configuration

The Chat plugin supports the following configuration parameters:

- **`api_key`**: The API key for accessing OpenAI's API. This must be set for the plugin to work.
- **`model`**: The OpenAI model to use for generating responses. Default: `gpt-4`.
- **`max_tokens`**: The maximum number of tokens to include in the response. Default: `256`.
- **`system_prompt`**: The system prompt to guide the assistant's behavior. Default: `You are a helpful assistant.`.
- **`scrollback_lines`**: The number of recent lines from the channel to include as context. Default: `10`.
- **`join_string`**: The string used to join multi-line responses into a single line. Default: ` / `.
- **`passive_mode`**: Controls passive participation. Options: `off`, `mention`, `smart`. Default: `off`.
- **`passive_probability`**: When `passive_mode` is `smart`, probability (0-1) that the bot considers replying when heuristics match. Default: `0.35`.
- **`passive_max_replies`**: Maximum passive replies per thread (`-1` disables the cap). Default: `3`.
- **`passive_engagement_timeout`**: Seconds before an active passive thread expires if the bot stays quiet. Default: `180`.
- **`passive_cooldown`**: Cooldown in seconds after ending a passive thread before starting a new one. Default: `120`.
- **`passive_trigger_words`**: Space-separated keywords that increase the chance of a passive response in `smart` mode. Default: *(empty)*.
- **`passive_prompt_addendum`**: Text appended to the system prompt while passive mode is active, shaping the bot's etiquette.
- **`history_service_url`**: Base URL for the optional history service (e.g. `http://127.0.0.1:8901`). Leave blank to disable.
- **`history_service_token`**: Bearer token to send with history service requests (if required).
- **`history_service_timeout`**: Timeout in seconds for history service HTTP requests. Default: `1.5`.
- **`history_include_files`**: Number of rotated log files the service should scan (`include_files` parameter). Default: `2`.
- **`history_result_limit`**: Maximum number of log lines to request from the service. Default: `60`.
- **`history_max_chars`**: Maximum characters of history context injected into the prompt. Default: `1800`.
- **`history_max_lines`**: Maximum history lines injected into the prompt. Default: `80`.
- **`history_trigger_words`**: Words/phrases that cause the bot to consult the history service. Default: `remember earlier history logs recap summary yesterday before`.

### Example Configuration

To set the API key:
```
/msg BotName config plugins.Chat.api_key YOUR_API_KEY
```

To change the model:
```
/msg BotName config plugins.Chat.model gpt-3.5-turbo
```

To adjust the maximum tokens:
```
/msg BotName config plugins.Chat.max_tokens 512
```

### Passive Mode

Enable light-weight participation by switching `passive_mode` to `mention` so the bot automatically answers when called by name:
```
/msg BotName config plugins.Chat.passive_mode mention
```

For a looser "hang out" presence, activate `smart` mode and adjust the heuristics:
```
/msg BotName config plugins.Chat.passive_mode smart
/msg BotName config plugins.Chat.passive_probability 0.25
/msg BotName config plugins.Chat.passive_trigger_words help thoughts idea
```

In smart mode the bot watches channel flow, but only jumps in when it is confident it can help or close an active thread. Direct `.chat`/`@Bot chat` commands still work exactly as before.

### History Service

Point the plugin at the local history API and let it pull in context when users ask for recaps:
```
/msg BotName config plugins.Chat.history_service_url http://127.0.0.1:8901
/msg BotName config plugins.Chat.history_trigger_words "remember earlier recap"
```

If the service expects a bearer token:
```
/msg BotName config plugins.Chat.history_service_token YOURTOKEN
```

When a `.chat` request (or passive interjection) contains one of the trigger phrases—or starts with `history:`/`log:`—the plugin calls the service, pulls any matching log lines, and appends a short “Recent channel facts” block to the OpenAI prompt before generating the final reply.

## Usage

Once configured, you can use the `chat` command to interact with the bot. For example:
```
@BotName chat What is the capital of France?
```
The bot will respond with the answer based on the configured model and context.

## Defaults

The plugin is designed to work out of the box with minimal configuration. Simply set the `api_key`, and the plugin will use sensible defaults for all other parameters.