hakimi 0.1.0 → 0.1.1

package/README.md

@@ -1,38 +1,50 @@
 # Hakimi
 
-Hakimi lets you chat with an AI assistant via Telegram/Slack/Feishu to remotely control your computer.
+Chat with an AI assistant via Telegram/Slack/Feishu to remotely control your computer.
 
-## Quick Start
+## Prerequisites
 
-### 1. Install
+Hakimi depends on [Kimi Code CLI](https://github.com/MoonshotAI/kimi-cli). Install it first:
 
 ```bash
-npm install
+# Linux/macOS
+curl -LsSf https://code.kimi.com/install.sh | bash
+
+# Windows (PowerShell)
+Invoke-RestMethod https://code.kimi.com/install.ps1 | Invoke-Expression
+```
+
+For detailed instructions, see the [Getting Started Guide](https://moonshotai.github.io/kimi-cli/en/guides/getting-started.html).
+
+## Install
+
+```bash
+npm install -g hakimi
 ```
 
-### 2. Run
+## Usage
 
 ```bash
-npm run dev
+hakimi
 ```
 
 Debug mode (show detailed logs):
 
 ```bash
-npm run dev -- --debug
+hakimi --debug
 ```
 
-### 3. Login to Kimi Code
+### 1. Login to Kimi Code
 
 Press `L` to login to your Kimi Code account. Follow the prompts to complete authorization in your browser.
 
-### 4. Configure
+### 2. Configure
 
 Press `C` to start the configuration wizard. The AI assistant will guide you through:
 - Naming your AI assistant
 - Setting up chat platforms (Telegram/Slack/Feishu)
 
-### 5. Start Using
+### 3. Start Service
 
 Press `S` to start the service, then send messages to your Bot on the chat platform.
 
@@ -55,11 +67,6 @@ Press `S` to start the service, then send messages to your Bot on the chat platf
 1. Go to https://open.feishu.cn to create an app
 2. Get the App ID and App Secret
 
-## Config File Locations
-
-- Kimi Code: `~/.kimi/config.toml`
-- Hakimi: `~/.hakimi/config.toml`
-
 ## Hotkeys
 
 | Key | Function |
@@ -69,3 +76,12 @@ Press `S` to start the service, then send messages to your Bot on the chat platf
 | S | Start/Stop service |
 | Q | Quit |
 | Esc | Back/Cancel |
+
+## Config Files
+
+- Kimi Code: `~/.kimi/config.toml`
+- Hakimi: `~/.hakimi/config.toml`
+
+## License
+
+MIT

package/dist/services/chatRouter.js

@@ -144,9 +144,14 @@ export class ChatRouter {
         }
     }
     handleMessage(koishiSession) {
-        // Only handle private messages
-        if (koishiSession.guildId)
+        this.log(`Received: platform=${koishiSession.platform}, guildId=${koishiSession.guildId}, channelId=${koishiSession.channelId}, userId=${koishiSession.userId}`);
+        // Only handle private messages (no guildId, or Slack DM channels starting with 'D')
+        const isPrivate = !koishiSession.guildId ||
+            (koishiSession.platform === 'slack' && koishiSession.channelId?.startsWith('D'));
+        if (!isPrivate) {
+            this.log(`Skipping non-private message`);
             return;
+        }
         const sessionId = `${koishiSession.platform}-${koishiSession.selfId}-${koishiSession.userId}`;
         const content = koishiSession.content || '';
         let chatSession = this.sessionCache.get(sessionId);

package/dist/services/configAgent.js

@@ -5,9 +5,11 @@ import { fileURLToPath } from 'node:url';
 import { createSession, createExternalTool } from '@moonshot-ai/kimi-agent-sdk';
 import { z } from 'zod';
 import { writeHakimiConfig } from '../utils/config.js';
-import { HAKIMI_DIR } from '../utils/paths.js';
+import { HAKIMI_DIR, getLanguageInstruction } from '../utils/paths.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const CONFIG_SESSION_ID = 'hakimi-config-wizard';
+function generateSessionId() {
+    return `hakimi-config-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
 export async function loadConfigPrompt() {
     const promptPath = join(__dirname, '../../prompts/config-agent.md');
     return readFile(promptPath, 'utf-8');
@@ -58,15 +60,14 @@ export class ConfigAgent {
         });
         this.session = createSession({
             workDir: HAKIMI_DIR,
-            sessionId: CONFIG_SESSION_ID,
+            sessionId: generateSessionId(),
             thinking: false,
             yoloMode: true,
             externalTools: [askUserTool, finishConfigTool],
         });
-        // Clear previous session context
-        await this.sendMessage('/clear');
         // Send initial prompt with system instructions
-        await this.sendMessage(this.systemPrompt + '\n\nPlease start by asking the user what they want to name their AI assistant.');
+        const langInstruction = getLanguageInstruction();
+        await this.sendMessage(this.systemPrompt + `\n\n${langInstruction}\n\nPlease start by asking the user what they want to name their AI assistant.`);
     }
     async sendMessage(content) {
         if (!this.session) {

package/dist/services/theAgent.js

@@ -4,9 +4,11 @@ import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { z } from 'zod';
+import { getLanguageInstruction } from '../utils/paths.js';
 const HOME_DIR = homedir();
 const AGENT_YAML_DIR = '/tmp/hakimi/agents';
 function generateAgentYaml(agentName) {
+    const langInstruction = getLanguageInstruction();
     return `version: 1
 agent:
   extend: default
@@ -16,6 +18,10 @@ agent:
 
       You are accessible via instant messaging platforms (Telegram/Slack/Feishu).
 
+      You have PERSISTENT conversation history with each user. Your session is preserved across messages and even across app restarts. You CAN and SHOULD remember what you discussed with the user earlier in this conversation. Never claim you "cannot access previous messages" or "don't have memory" - you do have full context of the conversation history.
+
+      ${langInstruction}
+
       IMPORTANT: You MUST use the SendMessage tool to reply to the user. Do NOT put your reply in the assistant message content - it will be ignored. Only messages sent via SendMessage will reach the user.
 
       IMPORTANT: Prefer calling SendMessage multiple times with shorter messages rather than one long message. This provides better user experience on IM platforms - users see responses progressively instead of waiting for a wall of text. For example:

package/dist/utils/paths.d.ts

@@ -2,3 +2,5 @@ export declare const KIMI_DIR: string;
 export declare const KIMI_CONFIG: string;
 export declare const HAKIMI_DIR: string;
 export declare const HAKIMI_CONFIG: string;
+export declare function getSystemLanguage(): string;
+export declare function getLanguageInstruction(): string;

package/dist/utils/paths.js

@@ -4,3 +4,31 @@ export const KIMI_DIR = join(homedir(), '.kimi');
 export const KIMI_CONFIG = join(KIMI_DIR, 'config.toml');
 export const HAKIMI_DIR = join(homedir(), '.hakimi');
 export const HAKIMI_CONFIG = join(HAKIMI_DIR, 'config.toml');
+export function getSystemLanguage() {
+    const lang = process.env.LANG || process.env.LC_ALL || process.env.LC_MESSAGES || 'en';
+    // Extract language code (e.g., "zh_CN.UTF-8" -> "zh_CN", "en_US.UTF-8" -> "en_US")
+    const match = lang.match(/^([a-z]{2}(?:_[A-Z]{2})?)/i);
+    return match ? match[1] : 'en';
+}
+export function getLanguageInstruction() {
+    const lang = getSystemLanguage();
+    if (lang.startsWith('zh')) {
+        return 'Please respond in Chinese (中文).';
+    }
+    else if (lang.startsWith('ja')) {
+        return 'Please respond in Japanese (日本語).';
+    }
+    else if (lang.startsWith('ko')) {
+        return 'Please respond in Korean (한국어).';
+    }
+    else if (lang.startsWith('es')) {
+        return 'Please respond in Spanish (Español).';
+    }
+    else if (lang.startsWith('fr')) {
+        return 'Please respond in French (Français).';
+    }
+    else if (lang.startsWith('de')) {
+        return 'Please respond in German (Deutsch).';
+    }
+    return 'Please respond in the user\'s language.';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hakimi",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Chat with AI assistant via Telegram/Slack/Feishu to remotely control your computer",
   "type": "module",
   "main": "dist/index.js",
@@ -55,4 +55,4 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   }
-}
+}

package/prompts/config-agent.md

@@ -41,6 +41,7 @@ Documentation:
 - Koishi Slack Adapter: https://koishi.chat/plugins/adapter/slack.html
 
 Required configuration:
+- `protocol`: Always use `"ws"` (WebSocket mode via Socket Mode)
 - `token`: App-level token (starts with `xapp-`)
 - `botToken`: Bot user OAuth token (starts with `xoxb-`)
 
@@ -49,9 +50,12 @@ Optional:
 
 To get these tokens:
 1. Go to https://api.slack.com/apps and create a new app
-2. Under "Basic Information", find the App-Level Token
-3. Under "OAuth & Permissions", install the app and copy the Bot User OAuth Token
-4. Under "Basic Information", find the Signing Secret (optional)
+2. Enable Socket Mode under "Socket Mode" settings
+3. Under "Basic Information", generate an App-Level Token with `connections:write` scope
+4. Under "OAuth & Permissions", install the app and copy the Bot User OAuth Token
+5. Under "Basic Information", find the Signing Secret (optional)
+
+**Always use `protocol: "ws"` for Slack.**
 
 ### Feishu (Lark)
 
@@ -61,12 +65,16 @@ Documentation:
 - Koishi Lark Adapter: https://koishi.chat/plugins/adapter/lark.html
 
 Required configuration:
+- `protocol`: Always use `"ws"` (WebSocket mode)
 - `appId`: Application ID
 - `appSecret`: Application Secret
 
 To get these:
 1. Go to https://open.feishu.cn and create an application
 2. Find the App ID and App Secret in the application credentials
+3. Enable "Events" and configure event subscription
+
+**Always use `protocol: "ws"` for Feishu.**
 
 ## Instructions