@inetafrica/open-claudia 2.2.5 → 2.2.7

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## v2.2.7
+- Docker image now ships `git`, `jq`, `python3`, `python3-pip`, and `build-essential` so spawned coding agents don't fall back to curling random binaries into userspace when a basic tool is missing.
+- Symlink `/app/bin/cli.js` to `/usr/local/bin/open-claudia` so the CLI (used by agents for `send-file`, `task`, etc.) is on PATH from any cwd. Previously agents had to extract the packaged tgz to find it.
+- Grant the `claudia` user passwordless sudo for `apt-get` / `apt` so the model can install additional packages at runtime via the normal path rather than ad-hoc binary downloads.
+
+## v2.2.6
+- Kazee inbound photos: V2 socket emits attachments as `msg.media` (single) or `msg.medias` (array), not `msg.attachments`. The adapter now reads all three so images sent from Kazee web/mobile clients reach the bot instead of being silently dropped as zero-attachment text.
+- Kazee outbound files: rewrote `sendFile` to (a) upload via `POST /chat/media/:chatId` with field `media` (the actual route; the old code POSTed to `/upload` with field `file` and 404'd), then (b) post the message via the V2 socket event `message:send` with `mediaIds: [<uploadedId>]` instead of REST `sendMessage` with `media_url`. The REST path is currently broken upstream — `Chat/send_message` calls `Media.create` without the required `chat`/`bucketName`/`fileName`/`minioPath` fields and 500s with `Failed to create media record`. Going via the socket handler reuses the already-saved Media doc and avoids the duplicate create.
+- New `_socketEmit(event, payload, timeoutMs)` adapter helper that promisifies socket.io acks with a timeout, used by the new outbound path.
+
 ## v2.2.5
 - Fix `/codex` resume crash: `buildCodexArgs` no longer appends `--add-dir <transcripts-dir>`, which the Codex CLI does not accept and which caused every `codex exec resume` invocation to exit 2 with `error: unexpected argument '--add-dir' found`. Transcript pointer is still injected into the prompt via `promptWithTranscriptPointer`.
 - Backend-aware empty-output failure message: when a non-Claude backend exits with no assistant output, the reply now labels it correctly (`Codex` / `Cursor`) and points at the right diagnostic commands (`/codex_auth_status`, `/codex_login`, `/codex_setup_token`, or `agent login`) instead of always saying "Claude exited" and recommending Claude-only commands.

package/Dockerfile

@@ -5,6 +5,12 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     curl \
     ffmpeg \
     ca-certificates \
+    git \
+    jq \
+    python3 \
+    python3-pip \
+    build-essential \
+    sudo \
     && rm -rf /var/lib/apt/lists/*
 
 # Install Claude Code CLI
@@ -18,6 +24,10 @@ RUN npm install -g @openai/codex
 # node:20-slim already has uid/gid 1000 (node user). Create claudia with different IDs.
 RUN groupadd -g 1001 claudia && useradd -u 1001 -g 1001 -m -d /data claudia
 
+# Allow claudia to install packages at runtime without a password
+RUN echo "claudia ALL=(ALL) NOPASSWD: /usr/bin/apt-get, /usr/bin/apt" > /etc/sudoers.d/claudia-apt && \
+    chmod 0440 /etc/sudoers.d/claudia-apt
+
 # Create app directory
 WORKDIR /app
 
@@ -31,6 +41,9 @@ COPY . .
 # Ensure app files are readable regardless of host file perms
 RUN chmod -R a+rX /app
 
+# Expose the open-claudia CLI on PATH so spawned agents can send files, manage tasks, etc.
+RUN chmod +x /app/bin/cli.js && ln -s /app/bin/cli.js /usr/local/bin/open-claudia
+
 # 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/channels/kazee/adapter.js

@@ -138,8 +138,14 @@ class KazeeAdapter {
       raw: msg,
     };
 
-    if (msg.attachments && msg.attachments.length) {
-      envelope.media = msg.attachments.map((a) => {
+    // chat-central V2 emits attached media on msg.medias (array) or
+    // msg.media (single). Older shapes used msg.attachments — keep that
+    // as a fallback for safety.
+    const rawMedia = (Array.isArray(msg.medias) && msg.medias.length)
+      ? msg.medias
+      : (msg.media ? [msg.media] : (msg.attachments || []));
+    if (rawMedia.length) {
+      envelope.media = rawMedia.map((a) => {
         let kind = a.type;
         if (!kind) {
           const mime = (a.mimeType || "").toLowerCase();
@@ -229,22 +235,37 @@ class KazeeAdapter {
     try {
       const buffer = fs.readFileSync(filePath);
       const fileName = path.basename(filePath);
-      const upload = await this._uploadMultipart("/upload", { file: { buffer, fileName } });
-      const url = upload?.url || upload?.fileUrl || upload?.location;
-      if (!url) {
-        console.error("Kazee upload returned no url");
+      // chat-central action `uploadMedia` is mounted at
+      // POST /chat/media/:chatId and expects the file under the `media`
+      // multipart field. It responds with { success, media: [<savedDoc>] }
+      // where each saved doc carries `_id` and a presigned `url`.
+      const upload = await this._uploadMultipart(
+        `/chat/media/${encodeURIComponent(channelId)}`,
+        { media: { buffer, fileName } },
+      );
+      const savedMedia = Array.isArray(upload?.media) ? upload.media[0] : null;
+      const mediaId = savedMedia?._id;
+      if (!mediaId) {
+        console.error("Kazee upload returned no media id:", JSON.stringify(upload).slice(0, 300));
         return false;
       }
-      const body = {
-        chat_id: channelId,
-        sender: this.botUserId,
-        content: caption || fileName,
+      // Post the message via the v2 socket event `message:send`, which
+      // accepts `mediaIds` referencing already-saved Media docs. We avoid
+      // the REST sendMessage action because it tries to re-Media.create
+      // from media_url and that call omits required schema fields
+      // (chat/bucketName/fileName/minioPath) — it always 500s.
+      const payload = {
+        chatId: channelId,
+        content: caption || "",
         type: this._kazeeFileType(fileName),
         findMeCode: `oc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
-        media_url: url,
-        attachments: [{ url, name: fileName }],
+        mediaIds: [mediaId],
       };
-      await this._request("POST", `/chat/${encodeURIComponent(channelId)}/message`, body);
+      const res = await this._socketEmit("message:send", payload, 30000);
+      if (res && res.code) {
+        console.error("Kazee message:send error:", res.code, res.message);
+        return false;
+      }
       return true;
     } catch (e) {
       console.error("Kazee sendFile error:", e.message);
@@ -252,6 +273,30 @@ class KazeeAdapter {
     }
   }
 
+  // Promisified ack-style socket emit. chat-central v2 handlers respond
+  // either with a success body or an { code, message, action } error.
+  _socketEmit(event, payload, timeoutMs = 15000) {
+    return new Promise((resolve, reject) => {
+      const socket = this._socket;
+      if (!socket || !socket.connected) {
+        reject(new Error(`Kazee socket not connected for ${event}`));
+        return;
+      }
+      let settled = false;
+      const timer = setTimeout(() => {
+        if (settled) return;
+        settled = true;
+        reject(new Error(`Kazee ${event} ack timeout`));
+      }, timeoutMs);
+      socket.emit(event, payload, (ack) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        resolve(ack);
+      });
+    });
+  }
+
   _kazeeFileType(fileName) {
     const ext = path.extname(fileName).toLowerCase();
     if ([".jpg", ".jpeg", ".png", ".gif", ".webp"].includes(ext)) return "image";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "2.2.5",
+  "version": "2.2.7",
   "description": "Your always-on AI coding assistant — Claude Code, Cursor Agent, and OpenAI Codex via Telegram or Kazee Chat",
   "main": "bot.js",
   "bin": {