omp-wechat 1.1.0 → 1.2.1

package/README.md

@@ -86,13 +86,14 @@ To remove: `/wechat uninstall`
 
 ## Configuration
 
-Configuration is loaded from `~/.omp-wechat/config.yml`, falling back to built-in defaults. Model, working directory, and tools are inherited from the OMP/Pi session automatically.
+Configuration is loaded from `~/.omp-wechat/config.yml`, falling back to built-in defaults.
 
 ```yaml
 # ~/.omp-wechat/config.yml
 maxSessions: 50
 dmPolicy: pairing
 model: "@smol"              # default model (role alias or provider/id)
+cwd: ~/projects/my-app      # working directory for AI sessions
 systemPrompt: |
   You are an AI assistant chatting via WeChat.
   Keep replies concise and in plain text.
@@ -103,8 +104,10 @@ systemPrompt: |
 | `maxSessions` | `50` | Session pool cap (LRU eviction) |
 | `dmPolicy` | `pairing` | Access policy: `pairing` / `allowlist` / `disabled` |
 | `model` | OMP default | Default model: role alias (`@smol`, `@slow`) or `provider/id` |
+| `cwd` | `process.cwd()` | Working directory for AI sessions — determines which project context (CLAUDE.md, .omp/) the agent loads |
 | `systemPrompt` | Built-in | System prompt for WeChat chat sessions |
-> **Model, working directory, and tools are managed by OMP/Pi.** `createAgentSession()` automatically calls `discoverAuthStorage()`, reusing your existing `omp login` / `pi login` OAuth, `~/.omp/agent/agent.db` API keys, or `models.yml` config. This project never touches API keys.
+
+> **Model and tools are managed by OMP/Pi.** `createAgentSession()` automatically calls `discoverAuthStorage()`, reusing your existing `omp login` / `pi login` OAuth, `~/.omp/agent/agent.db` API keys, or `models.yml` config. This project never touches API keys.
 
 ## Slash Commands
 
@@ -127,6 +130,7 @@ systemPrompt: |
 | `/model` | Show current AI model |
 | `/models` | List all available models |
 | `/model provider/id` | Switch model for this chat (e.g. `/model anthropic/claude-haiku-4-5`) |
+| `/new` | Reset session — clear context and start fresh |
 
 ## Access Control
 

package/dist/index.js

@@ -1054,15 +1054,93 @@ import {
   readFileSync,
   writeFileSync,
   mkdirSync as mkdirSync2,
-  renameSync
+  renameSync as renameSync2
 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 
 // src/utils/logger.ts
 import { homedir } from "os";
-import { join } from "path";
-import { mkdirSync, appendFileSync } from "fs";
+import { join as join2 } from "path";
+import { mkdirSync } from "fs";
+
+// src/utils/rotating-log.ts
+import { appendFileSync, statSync, renameSync, unlinkSync, readdirSync } from "fs";
+import { dirname, join, basename } from "path";
+var DEFAULT_MAX_BYTES = 5 * 1024 * 1024;
+var DEFAULT_MAX_FILES = 3;
+var DEFAULT_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
+
+class RotatingLog {
+  filePath;
+  maxBytes;
+  maxFiles;
+  maxAgeMs;
+  baseName;
+  dir;
+  activeFileName;
+  constructor(opts) {
+    this.filePath = opts.filePath;
+    this.maxBytes = opts.maxBytes ?? DEFAULT_MAX_BYTES;
+    this.maxFiles = opts.maxFiles ?? DEFAULT_MAX_FILES;
+    this.maxAgeMs = opts.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
+    this.dir = dirname(this.filePath);
+    this.activeFileName = basename(this.filePath);
+    this.baseName = basename(this.filePath, ".log");
+  }
+  write(line) {
+    try {
+      this.maybeRotate();
+      appendFileSync(this.filePath, line, "utf-8");
+    } catch {}
+  }
+  cleanStale() {
+    const cutoff = Date.now() - this.maxAgeMs;
+    try {
+      for (const name of readdirSync(this.dir)) {
+        if (name === this.activeFileName)
+          continue;
+        if (!name.startsWith(this.baseName) || !name.endsWith(".log"))
+          continue;
+        const fullPath = join(this.dir, name);
+        try {
+          const stat = statSync(fullPath);
+          if (stat.mtimeMs < cutoff)
+            unlinkSync(fullPath);
+        } catch {}
+      }
+    } catch {}
+  }
+  maybeRotate() {
+    let size;
+    try {
+      size = statSync(this.filePath).size;
+    } catch {
+      return;
+    }
+    if (size < this.maxBytes)
+      return;
+    const oldest = this.rotatedPath(this.maxFiles);
+    try {
+      unlinkSync(oldest);
+    } catch {}
+    for (let i = this.maxFiles - 1;i >= 1; i--) {
+      const src = this.rotatedPath(i);
+      const dst = this.rotatedPath(i + 1);
+      try {
+        renameSync(src, dst);
+      } catch {}
+    }
+    try {
+      renameSync(this.filePath, this.rotatedPath(1));
+    } catch {}
+  }
+  rotatedPath(index) {
+    return join(this.dir, `${this.baseName}.${index}.log`);
+  }
+}
+
+// src/utils/logger.ts
 var LEVEL_ORDER = {
   debug: 0,
   info: 1,
@@ -1070,11 +1148,18 @@ var LEVEL_ORDER = {
   error: 3
 };
 var minLevel = process.env.OMP_WECHAT_LOG ?? "info";
-var LOG_DIR = join(homedir(), ".omp", "logs");
-var LOG_FILE = join(LOG_DIR, "wechat.log");
+var LOG_DIR = join2(homedir(), ".omp", "logs");
+var LOG_FILE = join2(LOG_DIR, "wechat.log");
 try {
   mkdirSync(LOG_DIR, { recursive: true });
 } catch {}
+var rotatingLog = new RotatingLog({
+  filePath: LOG_FILE,
+  maxBytes: 5 * 1024 * 1024,
+  maxFiles: 3,
+  maxAgeMs: 30 * 24 * 60 * 60 * 1000
+});
+rotatingLog.cleanStale();
 function ts() {
   return new Date().toISOString();
 }
@@ -1085,10 +1170,7 @@ function log(level, msg, meta) {
   const line = meta !== undefined ? `${prefix} ${msg} ${JSON.stringify(meta)}
 ` : `${prefix} ${msg}
 `;
-  process.stderr.write(line);
-  try {
-    appendFileSync(LOG_FILE, line);
-  } catch {}
+  rotatingLog.write(line);
 }
 var logger = {
   debug: (msg, meta) => log("debug", msg, meta),
@@ -1098,9 +1180,9 @@ var logger = {
 };
 
 // src/ilink/client.ts
-var STATE_DIR = join2(homedir2(), ".omp-wechat");
-var CREDENTIALS_FILE = join2(STATE_DIR, "credentials.json");
-var SYNC_BUF_FILE = join2(STATE_DIR, "sync_buf.txt");
+var STATE_DIR = join3(homedir2(), ".omp-wechat");
+var CREDENTIALS_FILE = join3(STATE_DIR, "credentials.json");
+var SYNC_BUF_FILE = join3(STATE_DIR, "sync_buf.txt");
 function loadCredentials() {
   try {
     return JSON.parse(readFileSync(CREDENTIALS_FILE, "utf8"));
@@ -1113,7 +1195,7 @@ function saveCredentials(creds) {
   const tmp = CREDENTIALS_FILE + ".tmp";
   writeFileSync(tmp, JSON.stringify(creds, null, 2) + `
 `, { mode: 384 });
-  renameSync(tmp, CREDENTIALS_FILE);
+  renameSync2(tmp, CREDENTIALS_FILE);
 }
 function getCredentials() {
   const creds = loadCredentials();
@@ -1240,9 +1322,10 @@ function saveSyncBuf(buf) {
   mkdirSync2(STATE_DIR, { recursive: true });
   writeFileSync(SYNC_BUF_FILE, buf);
 }
-function extractInboundText(msg) {
+function extractInboundText(msg, includeImagePlaceholder = true) {
   const items = msg.item_list ?? [];
   const parts = [];
+  let imgCount = 0;
   for (const item of items) {
     switch (item.type) {
       case 1:
@@ -1250,7 +1333,7 @@ function extractInboundText(msg) {
           parts.push(item.text_item.text);
         break;
       case 2:
-        parts.push("(image)");
+        imgCount++;
         break;
       case 3:
         parts.push(item.voice_item?.text ?? "(voice)");
@@ -1263,9 +1346,17 @@ function extractInboundText(msg) {
         break;
     }
   }
+  if (includeImagePlaceholder && imgCount > 0 && parts.length === 0) {
+    parts.push(`(user sent ${imgCount} image${imgCount > 1 ? "s" : ""})`);
+  } else if (includeImagePlaceholder && imgCount > 0) {
+    parts.push(`(+${imgCount} image${imgCount > 1 ? "s" : ""})`);
+  }
   return parts.join(`
 `) || "";
 }
+function extractInboundImages(msg) {
+  return (msg.item_list ?? []).filter((item) => item.type === 2);
+}
 
 // src/access/control.ts
 import { randomBytes as randomBytes2 } from "crypto";
@@ -1273,12 +1364,12 @@ import {
   readFileSync as readFileSync2,
   writeFileSync as writeFileSync2,
   mkdirSync as mkdirSync3,
-  renameSync as renameSync2
+  renameSync as renameSync3
 } from "fs";
 import { homedir as homedir3 } from "os";
-import { join as join3 } from "path";
-var STATE_DIR2 = join3(homedir3(), ".omp-wechat");
-var ACCESS_FILE = join3(STATE_DIR2, "access.json");
+import { join as join4 } from "path";
+var STATE_DIR2 = join4(homedir3(), ".omp-wechat");
+var ACCESS_FILE = join4(STATE_DIR2, "access.json");
 function defaultAccess() {
   return { dmPolicy: "pairing", allowFrom: [], pending: {} };
 }
@@ -1295,7 +1386,7 @@ function readAccessFile() {
     if (err.code === "ENOENT")
       return defaultAccess();
     try {
-      renameSync2(ACCESS_FILE, `${ACCESS_FILE}.corrupt-${Date.now()}`);
+      renameSync3(ACCESS_FILE, `${ACCESS_FILE}.corrupt-${Date.now()}`);
     } catch {}
     logger.warn("access.json is corrupt, moved aside, using defaults");
     return defaultAccess();
@@ -1306,7 +1397,7 @@ function saveAccess(a) {
   const tmp = ACCESS_FILE + ".tmp";
   writeFileSync2(tmp, JSON.stringify(a, null, 2) + `
 `, { mode: 384 });
-  renameSync2(tmp, ACCESS_FILE);
+  renameSync3(tmp, ACCESS_FILE);
 }
 function loadAccess() {
   return readAccessFile();
@@ -1481,7 +1572,7 @@ import { randomBytes as randomBytes3 } from "crypto";
 
 // src/config.ts
 import { homedir as homedir4 } from "os";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 import { existsSync, readFileSync as readFileSync3 } from "fs";
 var DEFAULT_SYSTEM_PROMPT = `You are an AI assistant chatting with users via WeChat.
 
@@ -1490,8 +1581,8 @@ Constraints:
 - Keep replies concise; WeChat has a ~2000 character limit per message
 - If you need to write code or long documents, summarize the key points; the user will review on their computer
 - Users may send short or incomplete messages from their phone; proactively understand their intent`;
-var CONFIG_DIR = join4(homedir4(), ".omp-wechat");
-var CONFIG_FILE = join4(CONFIG_DIR, "config.yml");
+var CONFIG_DIR = join5(homedir4(), ".omp-wechat");
+var CONFIG_FILE = join5(CONFIG_DIR, "config.yml");
 function loadConfig() {
   const config = {
     maxSessions: 50,
@@ -1506,16 +1597,25 @@ function loadConfig() {
         config.maxSessions = parseInt(parsed.maxSessions, 10);
       if (parsed.dmPolicy)
         config.dmPolicy = parsed.dmPolicy;
-      if (parsed.systemPrompt)
-        config.systemPrompt = parsed.systemPrompt;
       if (parsed.model)
         config.model = parsed.model;
+      if (parsed.cwd)
+        config.cwd = expandTilde(parsed.cwd);
+      if (parsed.systemPrompt)
+        config.systemPrompt = parsed.systemPrompt;
     }
   } catch (err) {
     logger.warn("Failed to load config.yml, using defaults", err);
   }
   return config;
 }
+function expandTilde(p) {
+  if (p.startsWith("~/"))
+    return join5(homedir4(), p.slice(2));
+  if (p === "~")
+    return homedir4();
+  return p;
+}
 function parseSimpleYaml(yaml) {
   const result = {};
   let inMultiline = false;
@@ -1580,11 +1680,11 @@ function chunkText(text, limit = 2000) {
 }
 
 // src/utils/dedup.ts
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4, renameSync as renameSync3 } from "fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4, renameSync as renameSync4 } from "fs";
 import { homedir as homedir5 } from "os";
-import { join as join5 } from "path";
-var STATE_DIR3 = join5(homedir5(), ".omp-wechat");
-var DEDUP_FILE = join5(STATE_DIR3, "seen_msgs.json");
+import { join as join6 } from "path";
+var STATE_DIR3 = join6(homedir5(), ".omp-wechat");
+var DEDUP_FILE = join6(STATE_DIR3, "seen_msgs.json");
 var MAX_ENTRIES = 500;
 var DEDUP_TTL_MS = 5 * 60 * 1000;
 var entries = null;
@@ -1617,7 +1717,7 @@ function persist(s) {
     const tmp = DEDUP_FILE + ".tmp";
     writeFileSync3(tmp, JSON.stringify(arr) + `
 `, { mode: 384 });
-    renameSync3(tmp, DEDUP_FILE);
+    renameSync4(tmp, DEDUP_FILE);
   } catch (err) {
     logger.debug(`dedup persist failed: ${err}`);
   }
@@ -1637,38 +1737,107 @@ function isDuplicate(key) {
   return false;
 }
 
+// src/ilink/cdn.ts
+import { createDecipheriv } from "crypto";
+var CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
+function parseAesKey(aeskeyHex, aesKeyBase64) {
+  if (aeskeyHex && /^[0-9a-fA-F]{32}$/.test(aeskeyHex)) {
+    return Buffer.from(aeskeyHex, "hex");
+  }
+  if (!aesKeyBase64)
+    return null;
+  const decoded = Buffer.from(aesKeyBase64, "base64");
+  if (decoded.length === 16)
+    return decoded;
+  if (decoded.length === 32 && /^[0-9a-fA-F]{32}$/.test(decoded.toString("ascii"))) {
+    return Buffer.from(decoded.toString("ascii"), "hex");
+  }
+  return null;
+}
+function decryptAesEcb(ciphertext, key) {
+  const decipher = createDecipheriv("aes-128-ecb", key, null);
+  return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+}
+function buildCdnUrl(fileUrl, fullUrl) {
+  if (fullUrl)
+    return fullUrl;
+  if (!fileUrl)
+    return null;
+  if (fileUrl.startsWith("http"))
+    return fileUrl;
+  return `${CDN_BASE_URL}/download?encrypted_query_param=${encodeURIComponent(fileUrl)}`;
+}
+async function downloadAndDecrypt(fileUrl, fullUrl, aeskeyHex, aesKeyBase64, label = "media") {
+  const url = buildCdnUrl(fileUrl, fullUrl);
+  if (!url) {
+    logger.warn(`[${label}] No CDN URL available`);
+    return null;
+  }
+  const key = parseAesKey(aeskeyHex, aesKeyBase64);
+  if (!key) {
+    logger.warn(`[${label}] Could not parse AES key`);
+    return null;
+  }
+  try {
+    const resp = await fetch(url);
+    if (!resp.ok) {
+      logger.warn(`[${label}] CDN download failed: ${resp.status} ${resp.statusText}`);
+      return null;
+    }
+    const encrypted = Buffer.from(await resp.arrayBuffer());
+    const plaintext = decryptAesEcb(encrypted, key);
+    logger.info(`[${label}] Downloaded + decrypted: ${encrypted.length} \u2192 ${plaintext.length} bytes`);
+    return plaintext;
+  } catch (err) {
+    logger.error(`[${label}] CDN download/decrypt error:`, err);
+    return null;
+  }
+}
+
 // src/engine/session.ts
 import { createAgentSession, SessionManager } from "@oh-my-pi/pi-coding-agent";
 
 // src/engine/session-store.ts
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 import { homedir as homedir6 } from "os";
-import { existsSync as existsSync2, mkdirSync as mkdirSync5, readdirSync, statSync, rmSync } from "fs";
-var STATE_DIR4 = join6(homedir6(), ".omp-wechat");
-var SESSIONS_DIR = join6(STATE_DIR4, "sessions");
+import { existsSync as existsSync2, mkdirSync as mkdirSync5, readdirSync as readdirSync2, statSync as statSync2, rmSync } from "fs";
+var STATE_DIR4 = join7(homedir6(), ".omp-wechat");
+var SESSIONS_DIR = join7(STATE_DIR4, "sessions");
 var STALE_THRESHOLD_MS = 30 * 24 * 60 * 60 * 1000;
 function sanitizeChatId(chatId) {
   return chatId.replace(/[^a-zA-Z0-9_@.-]/g, "_").slice(0, 200);
 }
 function sessionDirFor(chatId) {
-  return join6(SESSIONS_DIR, sanitizeChatId(chatId));
+  return join7(SESSIONS_DIR, sanitizeChatId(chatId));
 }
 function ensureSessionsDir() {
   mkdirSync5(SESSIONS_DIR, { recursive: true, mode: 448 });
 }
+function removeSessionDir(chatId) {
+  const dir = sessionDirFor(chatId);
+  if (!existsSync2(dir))
+    return false;
+  try {
+    rmSync(dir, { recursive: true, force: true });
+    return true;
+  } catch (err) {
+    logger.warn(`Failed to remove session dir ${dir}: ${err}`);
+    return false;
+  }
+}
 function cleanupStaleSessions() {
   if (!existsSync2(SESSIONS_DIR))
     return 0;
   const now = Date.now();
   let removed = 0;
-  for (const entry of readdirSync(SESSIONS_DIR, { withFileTypes: true })) {
+  for (const entry of readdirSync2(SESSIONS_DIR, { withFileTypes: true })) {
     if (!entry.isDirectory())
       continue;
-    const dir = join6(SESSIONS_DIR, entry.name);
+    const dir = join7(SESSIONS_DIR, entry.name);
     let newestMtime = 0;
     try {
-      for (const file of readdirSync(dir)) {
-        const mtime = statSync(join6(dir, file)).mtimeMs;
+      for (const file of readdirSync2(dir)) {
+        const mtime = statSync2(join7(dir, file)).mtimeMs;
         if (mtime > newestMtime)
           newestMtime = mtime;
       }
@@ -1694,11 +1863,11 @@ function clearAllSessions() {
   if (!existsSync2(SESSIONS_DIR))
     return 0;
   let removed = 0;
-  for (const entry of readdirSync(SESSIONS_DIR, { withFileTypes: true })) {
+  for (const entry of readdirSync2(SESSIONS_DIR, { withFileTypes: true })) {
     if (!entry.isDirectory())
       continue;
     try {
-      rmSync(join6(SESSIONS_DIR, entry.name), { recursive: true, force: true });
+      rmSync(join7(SESSIONS_DIR, entry.name), { recursive: true, force: true });
       removed++;
     } catch (err) {
       logger.warn(`Failed to remove session dir ${entry.name}: ${err}`);
@@ -1738,7 +1907,7 @@ class ChatSession {
     logger.info(`Creating session: ${chatId}`);
     ensureSessionsDir();
     const sessionDir = sessionDirFor(chatId);
-    const sessionManager = await SessionManager.continueRecent(process.cwd(), sessionDir);
+    const sessionManager = await SessionManager.continueRecent(config.cwd || process.cwd(), sessionDir);
     logger.info(`Session dir: ${sessionDir} (resumed=${sessionManager.getSessionFile() !== null})`);
     const { session, modelFallbackMessage } = await createAgentSession({
       sessionManager,
@@ -1751,6 +1920,8 @@ class ChatSession {
       logger.warn(`Model fallback: ${modelFallbackMessage}`);
     }
     const wrapper = new ChatSession(session, chatId, contextToken);
+    const visionRole = session.settings.getModelRole("vision");
+    logger.info(`[${chatId}] Model: ${session.model?.id ?? "unknown"}, vision role: ${visionRole ?? "(not configured)"}`);
     session.subscribe((event) => {
       if (event.type !== "message_end")
         return;
@@ -1765,9 +1936,12 @@ class ChatSession {
     });
     return wrapper;
   }
-  async prompt(text) {
+  async prompt(text, images) {
     this.lastActive = Date.now();
-    await this.session.prompt(text);
+    await this.session.prompt(text, images?.length ? { images } : undefined);
+  }
+  supportsVision() {
+    return this.session.settings.getModelRole("vision") !== undefined;
   }
   setContextToken(token) {
     this.contextToken = token;
@@ -1808,16 +1982,27 @@ class SessionPool {
     this.pool.set(chatId, entry);
     return entry;
   }
-  async prompt(chatId, contextToken, text, config) {
+  async prompt(chatId, contextToken, text, config, images) {
     const entry = await this.ensure(chatId, contextToken, config);
-    await entry.prompt(text);
+    await entry.prompt(text, images);
   }
   get(chatId) {
     return this.pool.get(chatId);
   }
+  async resetSession(chatId) {
+    const entry = this.pool.get(chatId);
+    if (entry) {
+      await entry.dispose();
+      this.pool.delete(chatId);
+    }
+    removeSessionDir(chatId);
+  }
   getContextToken(chatId) {
     return this.pool.get(chatId)?.getContextToken() ?? "";
   }
+  supportsVision(chatId) {
+    return this.pool.get(chatId)?.supportsVision() ?? false;
+  }
   evictOldest() {
     let oldestId = null;
     let oldestTime = Infinity;
@@ -2010,6 +2195,24 @@ class ModelCommand {
   }
 }
 
+// src/command/new-session-command.ts
+class NewSessionInvocation {
+  async execute(ctx) {
+    await ctx.pool.resetSession(ctx.chatId);
+    return "Session reset. Your next message starts a fresh conversation.";
+  }
+}
+
+class NewSessionCommand {
+  name = "new";
+  parse(text) {
+    if (text === "/new" || text === "/reset") {
+      return new NewSessionInvocation;
+    }
+    return null;
+  }
+}
+
 // src/bridge.ts
 var MAX_FAILURES = 3;
 var BACKOFF_MS = 30000;
@@ -2027,6 +2230,7 @@ class WeChatBridge {
   commands = new CommandRegistry;
   constructor() {
     this.commands.register(new ModelCommand);
+    this.commands.register(new NewSessionCommand);
   }
   start() {
     const config = loadConfig();
@@ -2153,39 +2357,75 @@ class WeChatBridge {
     if (result.action === "pair") {
       if (contextToken) {
         const lead = result.isResend ? "Still waiting for pairing" : "Pairing required";
-        const text2 = `${lead} \u2014 approve in OMP with: /wechat pair ${result.code}`;
-        await sendMessage(creds, senderId, text2, contextToken).catch((err) => {
+        const text = `${lead} \u2014 approve in OMP with: /wechat pair ${result.code}`;
+        await sendMessage(creds, senderId, text, contextToken).catch((err) => {
           logger.warn("Pairing reply send failed:", err);
         });
       }
       return;
     }
-    const text = extractInboundText(msg);
-    if (!text)
+    if (!(msg.item_list ?? []).length)
       return;
-    const dedupKey = makeDedupKey(senderId, msg.create_time_ms, text);
+    const rawText = (msg.item_list ?? []).filter((item) => item.type === 1).map((item) => item.text_item?.text ?? "").filter(Boolean).join(`
+`);
+    const hasImages = (msg.item_list ?? []).some((item) => item.type === 2);
+    const dedupKey = makeDedupKey(senderId, msg.create_time_ms, rawText || "(image)");
     if (dedupKey && isDuplicate(dedupKey)) {
-      logger.info(`[${senderId}] Skipping duplicate message: ${text.slice(0, 80)}`);
+      logger.info(`[${senderId}] Skipping duplicate message: ${(rawText || "(image)").slice(0, 80)}`);
       return;
     }
     const config = loadConfig();
-    logger.info(`[${senderId}] Inbound (ts=${msg.create_time_ms ?? "n/a"}): ${text.slice(0, 80)}`);
-    const invocation = this.commands.tryParse(text);
-    if (invocation) {
-      const reply = await invocation.execute({ pool: this.pool, config, chatId: senderId }).catch((err) => `Command failed: ${err instanceof Error ? err.message : String(err)}`);
-      await sendMessage(creds, senderId, reply, contextToken).catch((err) => {
-        logger.warn(`[${senderId}] Command reply send failed:`, err);
-      });
-      return;
+    logger.info(`[${senderId}] Inbound (ts=${msg.create_time_ms ?? "n/a"}): ${(rawText || "(image)").slice(0, 80)}`);
+    if (rawText) {
+      const invocation = this.commands.tryParse(rawText);
+      if (invocation) {
+        const reply = await invocation.execute({ pool: this.pool, config, chatId: senderId }).catch((err) => `Command failed: ${err instanceof Error ? err.message : String(err)}`);
+        await sendMessage(creds, senderId, reply, contextToken).catch((err) => {
+          logger.warn(`[${senderId}] Command reply send failed:`, err);
+        });
+        return;
+      }
     }
     await sendTyping(creds, senderId, 1).catch(() => {});
     try {
-      await this.pool.prompt(senderId, contextToken, text, config);
+      const session = await this.pool.ensure(senderId, contextToken, config);
+      const hasVision = session.supportsVision();
+      const text = extractInboundText(msg, !hasVision);
+      if (!text && !hasImages)
+        return;
+      const images = await this.downloadImages(creds, msg, senderId);
+      await session.prompt(text, images);
     } catch (err) {
       logger.error(`[${senderId}] prompt failed:`, err);
       await this.sendReply(creds, senderId, "Processing failed, please try again.");
     }
   }
+  async downloadImages(_creds, msg, chatId) {
+    const imageItems = extractInboundImages(msg);
+    if (imageItems.length === 0)
+      return [];
+    if (!this.pool?.supportsVision(chatId)) {
+      logger.info(`[${chatId}] Skipping image download \u2014 model does not support vision`);
+      return [];
+    }
+    const results = [];
+    for (const item of imageItems) {
+      const img = item.image_item;
+      const buf = await downloadAndDecrypt(img.file_url, img.full_url, img.aeskey, img.aes_key ?? img.media?.aes_key, `image[${chatId}]`);
+      if (buf) {
+        const mimeType = buf.length > 4 && buf[0] === 137 && buf[1] === 80 ? "image/png" : "image/jpeg";
+        results.push({
+          type: "image",
+          data: buf.toString("base64"),
+          mimeType
+        });
+      }
+    }
+    if (results.length > 0) {
+      logger.info(`[${chatId}] Downloaded ${results.length}/${imageItems.length} images for AI`);
+    }
+    return results;
+  }
   async sendReply(creds, chatId, text) {
     const contextToken = this.pool?.getContextToken(chatId) ?? "";
     if (!contextToken) {
@@ -2216,7 +2456,7 @@ class WeChatBridge {
 
 // src/service.ts
 import { platform, homedir as homedir7 } from "os";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 import { existsSync as existsSync3, mkdirSync as mkdirSync6, writeFileSync as writeFileSync4, rmSync as rmSync2 } from "fs";
 var PLIST_LABEL = "com.omp-wechat";
 var SERVICE_NAME = "omp-wechat";
@@ -2229,13 +2469,13 @@ function detectPlatform() {
   return "other";
 }
 function getLogDir() {
-  return join7(homedir7(), ".omp", "logs");
+  return join8(homedir7(), ".omp", "logs");
 }
 function resolveHostBinary() {
   return process.execPath || "omp";
 }
 function plistPath() {
-  return join7(homedir7(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
+  return join8(homedir7(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
 }
 function generatePlist() {
   const omp = resolveHostBinary();
@@ -2284,7 +2524,7 @@ function generatePlist() {
 `;
 }
 function installLaunchd() {
-  const dir = join7(homedir7(), "Library", "LaunchAgents");
+  const dir = join8(homedir7(), "Library", "LaunchAgents");
   mkdirSync6(dir, { recursive: true });
   mkdirSync6(getLogDir(), { recursive: true });
   const plist = plistPath();
@@ -2336,7 +2576,7 @@ StandardError=append:${logDir}/rpc.log
 NoNewPrivileges=true
 ProtectSystem=strict
 ProtectHome=read-only
-ReadWritePaths=${logDir} ${join7(homedir7(), ".omp-wechat")} ${join7(homedir7(), ".omp")}
+ReadWritePaths=${logDir} ${join8(homedir7(), ".omp-wechat")} ${join8(homedir7(), ".omp")}
 PrivateTmp=true
 
 [Install]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omp-wechat",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "OMP/Pi extension: bridge WeChat messages to OMP's AI engine via the iLink Bot API",
   "type": "module",
   "main": "dist/index.js",