clearclaw 0.2.0 → 0.4.0

package/dist/types.d.ts

@@ -7,8 +7,13 @@ export interface Channel {
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     ownsId(chatId: string): boolean;
-    sendMessage(chatId: string, text: string, opts?: SendMessageOpts): Promise<void>;
-    sendInteractive(chatId: string, text: string, buttons: Button[]): Promise<ButtonResponse>;
+    sendMessage(chatId: string, text: string, opts?: SendMessageOpts): Promise<string[]>;
+    sendInteractive(chatId: string, text: string, buttons: Button[][]): Promise<ButtonResponse>;
+    editMessage(chatId: string, handle: string, text: string): Promise<void>;
+    deleteMessage(chatId: string, handle: string): Promise<void>;
+    pinMessage(chatId: string, handle: string): Promise<void>;
+    unpinAllMessages(chatId: string): Promise<void>;
+    updateStatus(chatId: string, text: string): Promise<void>;
     setTyping(chatId: string, isTyping: boolean): 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;
@@ -25,15 +30,25 @@ export interface ButtonResponse {
 }
 export interface SendMessageOpts {
     parseMode?: "MarkdownV2" | "HTML";
+    /** When false, skip consuming the typing placeholder (e.g. for tool status messages). */
+    consumeTyping?: boolean;
+}
+export interface SessionInfo {
+    sessionId: string;
+    summary: string;
+    lastModified: number;
+    gitBranch?: string;
 }
 export interface Engine {
     name: string;
     runTurn(opts: RunTurnOpts): AsyncIterable<EngineEvent>;
+    listSessions(cwd: string): Promise<SessionInfo[]>;
 }
 export interface RunTurnOpts {
     sessionId: string | null;
     cwd: string;
     prompt: string;
+    attachments?: Attachment[];
     permissionMode: PermissionMode;
     onPermissionRequest: (req: PermissionRequest) => Promise<PermissionResponse>;
     appendSystemPrompt?: string;
@@ -44,11 +59,18 @@ export interface PermissionRequest {
     input: Record<string, unknown>;
     description: string;
     reason?: string;
+    toolUseId: string;
 }
 export interface PermissionResponse {
     decision: "allow" | "deny";
     message?: string;
 }
+export interface TurnStats {
+    model: string;
+    contextUsed: number;
+    contextWindow: number;
+    toolCalls: Record<string, number>;
+}
 export type EngineEvent = {
     type: "text";
     text: string;
@@ -56,6 +78,7 @@ export type EngineEvent = {
     type: "tool_use";
     toolName: string;
     input: Record<string, unknown>;
+    toolUseId: string;
 } | {
     type: "tool_result";
     toolName: string;
@@ -67,6 +90,7 @@ export type EngineEvent = {
 } | {
     type: "done";
     sessionId: string;
+    stats?: TurnStats;
 } | {
     type: "error";
     message: string;
@@ -82,9 +106,16 @@ export interface UserInfo {
     name: string;
     handle?: string;
 }
+/** File data from a channel, kept in memory for engine consumption. */
+export interface Attachment {
+    buffer: Buffer;
+    mimeType: string;
+    filename?: string;
+}
 export interface InboundMessage {
     chatId: string;
     user: UserInfo;
     text: string;
+    attachments?: Attachment[];
 }
 export type { PermissionMode };

package/package.json

@@ -1,7 +1,26 @@
 {
   "name": "clearclaw",
-  "version": "0.2.0",
+  "version": "0.4.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",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alleriasun/clearclaw.git"
+  },
+  "homepage": "https://github.com/alleriasun/clearclaw",
+  "keywords": [
+    "claude-code",
+    "telegram",
+    "relay",
+    "agent-sdk",
+    "cli",
+    "remote",
+    "mobile",
+    "openclaw",
+    "nanoclaw",
+    "remotecode"
+  ],
   "bin": {
     "clearclaw": "dist/index.js"
   },
@@ -18,6 +37,7 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.50",
+    "@slack/bolt": "^4.6.0",
     "diff": "^8.0.3",
     "grammy": "^1.30.0",
     "pino": "^10.3.1",
@@ -25,6 +45,7 @@
     "pino-roll": "^4.0.0"
   },
   "devDependencies": {
+    "@anthropic-ai/sdk": "^0.78.0",
     "@types/diff": "^7.0.2",
     "@types/node": "^22.0.0",
     "nodemon": "^3.1.14",