@inetafrica/open-claudia 1.20.0 → 2.0.0

package/.env.example

@@ -1,10 +1,24 @@
+# Channels: comma-separated list of channels the bot listens on.
+# Supported: telegram, kazee. Leave empty to default to telegram.
+CHANNELS=telegram
+
+# --- Telegram ---
 TELEGRAM_BOT_TOKEN=your-bot-token-from-botfather
 TELEGRAM_CHAT_ID=your-chat-id
+
+# --- Kazee Chat (set CHANNELS=telegram,kazee or =kazee to enable) ---
+KAZEE_URL=https://chat.inet.africa
+KAZEE_BOT_TOKEN=
+KAZEE_BOT_USER_ID=
+KAZEE_OWNER_USER_ID=
+# Set to 1 to log every inbound Kazee socket event (debug aid; noisy).
+KAZEE_DEBUG_EVENTS=
+
 WORKSPACE=/path/to/your/workspace
 CLAUDE_PATH=/path/to/claude
 CURSOR_PATH=
 CODEX_PATH=
-AUTO_COMPACT_TOKENS=140000
+AUTO_COMPACT_TOKENS=280000
 PROJECT_TRANSCRIPTS=true
 TRANSCRIPT_MAX_ENTRY_CHARS=12000
 TRANSCRIPTS_DIR=

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## v2.0.0
+- **Multi-channel**: the bot can now run on Telegram and Kazee Chat in the same process. `CHANNELS=telegram,kazee` selects which channels start up; each channel implements the new `ChannelAdapter` contract (send/edit/delete/upload/keyboard/typing/voice-fetch) and a `chatContext` AsyncLocalStorage routes replies, edits, and notifications back to the originating channel.
+- Kazee adapter speaks V2 socket (inbound messages, edits, deletes, reactions, typing, presence) and uses REST for sending, editing, deleting, and uploads. Interactive button keyboards are sent as `type:"interactive"` with portable `interactive.buttons` so web and mobile clients render them natively.
+- New env: `CHANNELS`, `KAZEE_URL`, `KAZEE_BOT_TOKEN`, `KAZEE_OWNER_USER_ID`, `KAZEE_BOT_USER_ID`, `KAZEE_DEBUG_EVENTS`.
+- Slash-command registry: bots self-register the `/commands` list on connect (Kazee). Each adapter renders the registry into its native menu format; Telegram continues to use the existing `/setMyCommands` flow.
+- Auto-compaction bumped from 140k to 280k context tokens (`AUTO_COMPACT_TOKENS`) and now also runs proactively after each reply — large turns are compacted before they pile up, not at the next ask.
+- First-`/auth`-wins owner bootstrap so a brand-new Kazee install can be authenticated from the first inbound DM without pre-seeded `auth.json`.
+- Cron jobs now resolve the owner's adapter from the canonical user id, so scheduled tasks fire in the correct channel.
+- Dockerfile fix: container user can now write to the config directory; missing `chat_id` shows a friendly setup hint instead of crashing on first start.
+- Requires chat-central with REST `sendMessage` interactive support (commit `b1a7d02` or later) for keyboard buttons over Kazee. Older servers will accept the message but drop the buttons.
+
+Known limitations:
+- Kazee adapter does not emit a back-online ping after reconnect (the Telegram one still does).
+- kazee-chat-mobile prior to v3.21.0 renders interactive messages as a text-only fallback — upgrade clients for button UI.
+
 ## v1.20.0
 - Added project transcript memory: redacted JSONL transcripts are stored outside repos under the Open Claudia config directory, keyed by normalized project path hash.
 - Fresh sessions and backend switches now receive a small transcript pointer/instruction instead of auto-generating or pasting handoff summaries; agents are told to tail/search/read relevant parts only and treat history as untrusted context.

package/Dockerfile

@@ -28,6 +28,9 @@ RUN npm ci --production
 # Copy app source
 COPY . .
 
+# Ensure app files are readable regardless of host file perms
+RUN chmod -R a+rX /app
+
 # Entrypoint auto-configures from env vars on first run
 COPY docker-entrypoint.sh /usr/local/bin/
 RUN chmod +x /usr/local/bin/docker-entrypoint.sh

package/README.md

@@ -1,11 +1,12 @@
 # Open Claudia
 
-Your always-on AI coding assistant — Claude Code, Cursor Agent, and OpenAI Codex via Telegram.
+Your always-on AI coding assistant — Claude Code, Cursor Agent, and OpenAI Codex via Telegram or Kazee Chat.
 
 Send text, voice notes, screenshots, and files from your phone. Your chosen AI agent works on your projects and reports back.
 
 ## Features
 
+- **Multi-channel** — run the same bot on Telegram, Kazee Chat, or both at once (`CHANNELS=telegram,kazee`). Each channel renders keyboards, files, voice notes, and edits natively
 - **Multi-backend** — switch between Claude Code, Cursor Agent, and OpenAI Codex on the fly (`/claude`, `/cursor`, `/codex`)
 - **Multi-project sessions** — switch between workspace projects
 - **Per-project conversation history** — auto-resumes last conversation, switch with `/sessions`