clearclaw 0.4.0 → 0.5.0

package/dist/channel/slack.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import type { Channel, Button, ButtonResponse, SendMessageOpts } from "../types.js";
+import type { Channel, Button, ButtonResponse, SendFileOpts, SendMessageOpts } from "../types.js";
 export declare class SlackChannel extends EventEmitter implements Channel {
     name: string;
     private app;
@@ -22,6 +22,7 @@ export declare class SlackChannel extends EventEmitter implements Channel {
     unpinAllMessages(chatId: string): Promise<void>;
     updateStatus(chatId: string, text: string): Promise<void>;
     setTyping(chatId: string, isTyping: boolean): Promise<void>;
+    sendFile(chatId: string, buffer: Buffer, filename: string, opts?: SendFileOpts): Promise<void>;
     private slackId;
     /** Download a file from Slack using bot token auth. */
     private downloadFile;

package/dist/channel/slack.js

@@ -344,6 +344,15 @@ export class SlackChannel extends EventEmitter {
             }
         }
     }
+    async sendFile(chatId, buffer, filename, opts) {
+        const channel = this.slackId(chatId);
+        await this.app.client.files.uploadV2({
+            channel_id: channel,
+            file: buffer,
+            filename,
+            initial_comment: opts?.caption,
+        });
+    }
     slackId(chatId) {
         return chatId.replace(/^slack:/, "");
     }

package/dist/channel/telegram.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import type { Channel, Button, ButtonResponse, SendMessageOpts } from "../types.js";
+import type { Channel, Button, ButtonResponse, SendFileOpts, SendMessageOpts } from "../types.js";
 export declare class TelegramChannel extends EventEmitter implements Channel {
     name: string;
     private bot;
@@ -24,7 +24,8 @@ export declare class TelegramChannel extends EventEmitter implements Channel {
     /** Extract auth-checked sender info from a grammY context. Returns null if unauthorized. */
     private extractSender;
     /** Shared handler for photo/document messages: download, emit attachment or fallback. */
-    private handleMediaMessage;
+    private handleFileMessage;
+    sendFile(chatId: string, buffer: Buffer, filename: string, opts?: SendFileOpts): Promise<void>;
     /** Download a Telegram file by file_id, returning the raw buffer. */
     private downloadFile;
     private numericId;

package/dist/channel/telegram.js

@@ -1,5 +1,6 @@
 import { EventEmitter } from "node:events";
-import { Bot, InlineKeyboard } from "grammy";
+import { Bot, InlineKeyboard, InputFile } from "grammy";
+import mime from "mime";
 import log from "../logger.js";
 export class TelegramChannel extends EventEmitter {
     name = "telegram";
@@ -38,12 +39,12 @@ export class TelegramChannel extends EventEmitter {
         this.bot.on("message:photo", async (ctx) => {
             const photo = ctx.message.photo;
             const largest = photo[photo.length - 1];
-            await this.handleMediaMessage(ctx, largest.file_id, "image/jpeg", undefined, ctx.message.caption);
+            await this.handleFileMessage(ctx, largest.file_id, "image/jpeg", undefined, ctx.message.caption);
         });
         // Documents: download with original MIME + filename
         this.bot.on("message:document", async (ctx) => {
             const doc = ctx.message.document;
-            await this.handleMediaMessage(ctx, doc.file_id, doc.mime_type ?? "application/octet-stream", doc.file_name, ctx.message.caption);
+            await this.handleFileMessage(ctx, doc.file_id, doc.mime_type ?? "application/octet-stream", doc.file_name, ctx.message.caption);
         });
         // Placeholder handlers for unsupported media types
         for (const [filter, label] of [
@@ -283,7 +284,7 @@ export class TelegramChannel extends EventEmitter {
         };
     }
     /** Shared handler for photo/document messages: download, emit attachment or fallback. */
-    async handleMediaMessage(ctx, fileId, mimeType, filename, caption) {
+    async handleFileMessage(ctx, fileId, mimeType, filename, caption) {
         const sender = this.extractSender(ctx);
         if (!sender)
             return;
@@ -305,6 +306,24 @@ export class TelegramChannel extends EventEmitter {
             });
         }
     }
+    async sendFile(chatId, buffer, filename, opts) {
+        const id = this.numericId(chatId);
+        const mimeType = opts?.mimeType ?? mime.getType(filename) ?? "application/octet-stream";
+        const file = new InputFile(buffer, filename);
+        const caption = opts?.caption;
+        if (mimeType.startsWith("image/")) {
+            await this.bot.api.sendPhoto(id, file, { caption });
+        }
+        else if (mimeType.startsWith("video/")) {
+            await this.bot.api.sendVideo(id, file, { caption });
+        }
+        else if (mimeType.startsWith("audio/")) {
+            await this.bot.api.sendAudio(id, file, { caption });
+        }
+        else {
+            await this.bot.api.sendDocument(id, file, { caption });
+        }
+    }
     /** Download a Telegram file by file_id, returning the raw buffer. */
     async downloadFile(fileId) {
         const file = await this.bot.api.getFile(fileId);

package/dist/engine/claude-code.js

@@ -15,7 +15,7 @@ export class ClaudeCodeEngine {
         }));
     }
     async *runTurn(opts) {
-        const { sessionId, cwd, prompt: textPrompt, attachments, permissionMode, onPermissionRequest, appendSystemPrompt, signal, } = opts;
+        const { sessionId, cwd, prompt: textPrompt, attachments, permissionMode, onPermissionRequest, appendSystemPrompt, mcpServers, signal, } = opts;
         const abortController = new AbortController();
         // Wire external signal to our abort controller
         if (signal) {
@@ -66,6 +66,7 @@ export class ClaudeCodeEngine {
                 canUseTool,
                 abortController,
                 settingSources: ["user", "project", "local"],
+                ...(mcpServers ? { mcpServers } : {}),
                 ...(appendSystemPrompt
                     ? {
                         systemPrompt: {

package/dist/files.js

@@ -1,23 +1,14 @@
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
+import mime from "mime";
 import path from "node:path";
-/** Map common MIME types to file extensions. */
-const MIME_TO_EXT = {
-    "image/jpeg": ".jpg",
-    "image/png": ".png",
-    "image/gif": ".gif",
-    "image/webp": ".webp",
-    "application/pdf": ".pdf",
-    "text/plain": ".txt",
-    "text/csv": ".csv",
-};
 /** Save an attachment to disk for audit logging. Returns the saved file path. */
 export async function saveFile(att, workspace, filesPath) {
     const epoch = Math.floor(Date.now() / 1000);
     const hex = crypto.randomBytes(2).toString("hex");
     const name = att.filename
         ? sanitizeFilename(att.filename)
-        : `file${MIME_TO_EXT[att.mimeType] ?? ""}`;
+        : `file${att.mimeType ? `.${mime.getExtension(att.mimeType) ?? "bin"}` : ""}`;
     const filename = `${workspace}-${epoch}-${hex}-${name}`;
     const filePath = path.join(filesPath, filename);
     await fs.writeFile(filePath, att.buffer);

package/dist/logger.js

@@ -16,7 +16,7 @@ export function initLogger(logPath) {
                         file: logPath,
                         frequency: "daily",
                         size: "10m",
-                        limit: { count: 5 },
+                        limit: { count: 5, removeOtherLogFiles: true },
                     },
                     level: process.env.LOG_LEVEL ?? "info",
                 },

package/dist/orchestrator.js

@@ -1,5 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
+import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
+import { z } from "zod";
 import log from "./logger.js";
 import { saveFile } from "./files.js";
 import { formatToolStatusLine, formatToolCallSummary, formatPermissionPrompt, timeAgo } from "./format.js";
@@ -185,6 +187,26 @@ export class Orchestrator {
                 if (saved > 0)
                     log.info("[turn] saved %d/%d attachment(s) for workspace %s", saved, msg.attachments.length, ws.name);
             }
+            const mcpServer = createSdkMcpServer({
+                name: "clearclaw",
+                tools: [
+                    tool("send_file", "Send a file or image to the current chat conversation", {
+                        file_path: z.string().optional().describe("Absolute path to the file to send"),
+                        data: z.string().optional().describe("Base64-encoded file data (alternative to file_path)"),
+                        filename: z.string().optional().describe("Filename (required when using data, optional with file_path)"),
+                        caption: z.string().optional().describe("Optional caption to accompany the file"),
+                    }, async (args) => {
+                        if (!args.file_path && !args.data)
+                            throw new Error("Either file_path or data must be provided");
+                        const buffer = args.file_path
+                            ? await fs.promises.readFile(args.file_path)
+                            : Buffer.from(args.data, "base64");
+                        const name = args.filename ?? path.basename(args.file_path ?? "file");
+                        await this.channel.sendFile(msg.chatId, buffer, name, { caption: args.caption });
+                        return { content: [{ type: "text", text: `Sent ${name} to chat` }] };
+                    }),
+                ],
+            });
             try {
                 for await (const event of this.engine.runTurn({
                     sessionId: ws.current_session_id,
@@ -193,8 +215,14 @@ export class Orchestrator {
                     attachments: msg.attachments,
                     permissionMode: state.permissionMode ?? this.permissionMode,
                     appendSystemPrompt,
+                    mcpServers: { clearclaw: mcpServer },
                     signal: abort.signal,
                     onPermissionRequest: async (req) => {
+                        // Auto-allow ClearClaw's own MCP tools — no chat prompt needed
+                        if (req.toolName.startsWith("mcp__clearclaw__")) {
+                            log.info(`[perm] ${req.toolName} → auto-allow`);
+                            return { decision: "allow" };
+                        }
                         log.info(`[perm] ${req.toolName}`);
                         try {
                             const promptText = formatPermissionPrompt(req.toolName, req.input, req.description);

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { PermissionMode } from "@anthropic-ai/claude-agent-sdk";
+import type { McpServerConfig, PermissionMode } from "@anthropic-ai/claude-agent-sdk";
 export interface ChannelEvents {
     message: [msg: InboundMessage];
 }
@@ -15,6 +15,7 @@ export interface Channel {
     unpinAllMessages(chatId: string): Promise<void>;
     updateStatus(chatId: string, text: string): Promise<void>;
     setTyping(chatId: string, isTyping: boolean): Promise<void>;
+    sendFile(chatId: string, buffer: Buffer, filename: string, opts?: SendFileOpts): Promise<void>;
     on<K extends keyof ChannelEvents>(event: K, listener: (...args: ChannelEvents[K]) => void): this;
     off<K extends keyof ChannelEvents>(event: K, listener: (...args: ChannelEvents[K]) => void): this;
     emit<K extends keyof ChannelEvents>(event: K, ...args: ChannelEvents[K]): boolean;
@@ -33,6 +34,10 @@ export interface SendMessageOpts {
     /** When false, skip consuming the typing placeholder (e.g. for tool status messages). */
     consumeTyping?: boolean;
 }
+export interface SendFileOpts {
+    caption?: string;
+    mimeType?: string;
+}
 export interface SessionInfo {
     sessionId: string;
     summary: string;
@@ -52,6 +57,7 @@ export interface RunTurnOpts {
     permissionMode: PermissionMode;
     onPermissionRequest: (req: PermissionRequest) => Promise<PermissionResponse>;
     appendSystemPrompt?: string;
+    mcpServers?: Record<string, McpServerConfig>;
     signal?: AbortSignal;
 }
 export interface PermissionRequest {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clearclaw",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Your coding agent, from your phone — personal assistant + project workspaces on your machine, built on the CLI's permissions, config, and memory instead of replacing them.",
   "type": "module",
   "license": "MIT",
@@ -40,6 +40,7 @@
     "@slack/bolt": "^4.6.0",
     "diff": "^8.0.3",
     "grammy": "^1.30.0",
+    "mime": "^4.1.0",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
     "pino-roll": "^4.0.0"