@xmanrui/dsh-im 4.17.1 → 4.18.0

package/src/channels/imessage/imessage-api.mjs

@@ -0,0 +1,194 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+
+const execFileAsync = promisify(execFile);
+const DEFAULT_DB_PATH = `${process.env.HOME ?? ''}/Library/Messages/chat.db`;
+const DEFAULT_TIMEOUT_MS = 15_000;
+// Self-chat has no separate bot sender. Keep the reply marker in Messages itself
+// so echoes are still recognizable after a Host restart or iCloud resync.
+export const IMESSAGE_BOT_REPLY_PREFIX = '🤖 DSH\n';
+
+function cleanString(value) {
+  return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+
+function normalizeChatGuid(value) {
+  const chatGuid = cleanString(value?.chatGuid ?? value);
+  if (!chatGuid || chatGuid.length > 512 || /[\r\n]/.test(chatGuid)) {
+    throw new TypeError('iMessage chatGuid is required');
+  }
+  return chatGuid;
+}
+
+function normalizeAddress(value) {
+  const address = cleanString(value);
+  if (!address || address.length > 512 || /[\r\n]/.test(address)) {
+    throw new TypeError('iMessage address is required');
+  }
+  return address;
+}
+
+function permissionError(kind, message, cause) {
+  const error = new Error(message, { cause });
+  error.code = kind;
+  return error;
+}
+
+function sqlString(value) {
+  return `'${String(value).replaceAll("'", "''")}'`;
+}
+
+function decodeRows(stdout) {
+  const text = String(stdout ?? '').trim();
+  if (!text) return [];
+  try {
+    const rows = JSON.parse(text);
+    return Array.isArray(rows) ? rows : [];
+  } catch (error) {
+    throw new Error('macOS Messages returned invalid database output', { cause: error });
+  }
+}
+
+function appleScriptString(value) {
+  return JSON.stringify(String(value));
+}
+
+export function normalizeIMessageTarget(value) {
+  return normalizeChatGuid(value);
+}
+
+export function normalizeIMessage(value, { botId } = {}) {
+  if (!value || typeof value !== 'object') return null;
+  if (value.serviceName !== undefined && value.serviceName !== 'iMessage') return null;
+  const guid = cleanString(value.guid ?? value.id);
+  const chatGuid = cleanString(value.chatGuid ?? value.chat_guid);
+  const text = cleanString(value.text);
+  const sender = cleanString(value.sender ?? value.handle_id);
+  if (!guid || !chatGuid || !text || !sender) return null;
+  if (text.startsWith(IMESSAGE_BOT_REPLY_PREFIX)) return null;
+  if (value.isFromMe === 1 || value.isFromMe === true) return null;
+  if (botId && sender === botId) return null;
+  return Object.freeze({
+    messageId: guid,
+    providerMessageId: guid,
+    conversationId: chatGuid,
+    kind: 'direct',
+    senderId: sender,
+    senderName: sender,
+    content: text,
+    addressed: true,
+    replyTarget: { chatGuid, address: sender, serviceName: 'iMessage' },
+    connectionTestTarget: { chatGuid, address: sender, serviceName: 'iMessage' },
+    ...(value.receivedAt ? { receivedAt: value.receivedAt } : {}),
+  });
+}
+
+export class MacOSMessagesApi {
+  #dbPath;
+  #execFile;
+  #execFileOptions;
+  #osascript;
+
+  constructor({ dbPath = DEFAULT_DB_PATH, execFileImpl = execFileAsync, osascriptImpl } = {}) {
+    this.#dbPath = dbPath;
+    this.#execFile = execFileImpl;
+    this.#execFileOptions = { timeout: DEFAULT_TIMEOUT_MS, maxBuffer: 4 * 1024 * 1024 };
+    this.#osascript = osascriptImpl ?? ((script) => this.#execFile('/usr/bin/osascript', ['-e', script], this.#execFileOptions));
+    if (typeof this.#execFile !== 'function' || typeof this.#osascript !== 'function') {
+      throw new TypeError('MacOSMessagesApi requires command runners');
+    }
+  }
+
+  async getPermissions() {
+    const result = { platform: process.platform, database: 'unknown', automation: 'unknown' };
+    if (process.platform !== 'darwin') {
+      return { ...result, database: 'unsupported', automation: 'unsupported' };
+    }
+    try {
+      await this.#execFile('/usr/bin/sqlite3', ['-json', this.#dbPath, 'SELECT 1 AS ok LIMIT 1;'], this.#execFileOptions);
+      result.database = 'granted';
+    } catch (error) {
+      result.database = /authorization denied|not authorized|unable to open database/i.test(String(error?.stderr ?? error))
+        ? 'required' : 'error';
+    }
+    try {
+      await this.#osascript('tell application "Messages" to get name');
+      result.automation = 'granted';
+    } catch (error) {
+      result.automation = /not authorized|(-1743)|assistive/i.test(String(error?.stderr ?? error))
+        ? 'required' : 'error';
+    }
+    return result;
+  }
+
+  async listMessages({ after = 0, limit = 50, chatGuid } = {}) {
+    const cursor = Number.isSafeInteger(after) && after >= 0 ? after : 0;
+    const boundedLimit = Math.max(1, Math.min(100, Number(limit) || 50));
+    const chatFilter = chatGuid ? ` AND c.guid = ${sqlString(normalizeChatGuid(chatGuid))}` : '';
+    // Messages delivers self-chat back as an incoming copy. Read that copy once,
+    // keeping all outgoing rows excluded, and filter bot replies by their marker.
+    const query = `SELECT m.ROWID AS rowid, m.guid AS guid, m.text AS text,
+      h.id AS sender, c.guid AS chatGuid, c.service_name AS serviceName,
+      m.is_from_me AS isFromMe,
+      datetime((m.date / 1000000000) + 978307200, 'unixepoch') AS receivedAt
+      FROM message m
+      JOIN chat_message_join cmj ON cmj.message_id = m.ROWID
+      JOIN chat c ON c.ROWID = cmj.chat_id
+      LEFT JOIN handle h ON h.ROWID = m.handle_id
+      WHERE m.ROWID > ${cursor} AND m.is_from_me = 0
+        AND m.text IS NOT NULL AND m.text != ''
+        AND c.service_name = 'iMessage'${chatFilter}
+      ORDER BY m.ROWID ASC LIMIT ${boundedLimit};`;
+    try {
+      const { stdout } = await this.#execFile('/usr/bin/sqlite3', ['-json', this.#dbPath, query], this.#execFileOptions);
+      return decodeRows(stdout);
+    } catch (error) {
+      if (/authorization denied|not authorized|unable to open database/i.test(String(error?.stderr ?? error))) {
+        throw permissionError('messages-database-permission-required', '请在系统设置中授予 DeepSeek Harness 完全磁盘访问权限。', error);
+      }
+      throw error;
+    }
+  }
+
+  async getLatestMessageRowId() {
+    if (process.platform !== 'darwin') return 0;
+    const query = `SELECT COALESCE(MAX(m.ROWID), 0) AS rowid
+      FROM message m
+      JOIN chat_message_join cmj ON cmj.message_id = m.ROWID
+      JOIN chat c ON c.ROWID = cmj.chat_id
+      WHERE c.service_name = 'iMessage';`;
+    const { stdout } = await this.#execFile(
+      '/usr/bin/sqlite3', ['-json', this.#dbPath, query], this.#execFileOptions,
+    );
+    const rows = decodeRows(stdout);
+    const rowid = Number(rows[0]?.rowid ?? 0);
+    return Number.isSafeInteger(rowid) && rowid >= 0 ? rowid : 0;
+  }
+
+  async sendText({ chatGuid, address, text } = {}) {
+    const target = normalizeChatGuid(chatGuid);
+    const recipient = address ? normalizeAddress(address) : target.split(';').at(-1) || target;
+    const content = cleanString(text);
+    if (!content) throw new TypeError('iMessage text is required');
+    const reply = content.startsWith(IMESSAGE_BOT_REPLY_PREFIX)
+      ? content : `${IMESSAGE_BOT_REPLY_PREFIX}${content}`;
+    const script = `tell application "Messages"
+      set serviceList to every service whose service type = iMessage
+      if (count of serviceList) is 0 then error "No iMessage service is available"
+      set targetService to item 1 of serviceList
+      set targetBuddy to buddy ${appleScriptString(recipient)} of targetService
+      send ${appleScriptString(reply)} to targetBuddy
+    end tell`;
+    try {
+      await this.#osascript(script);
+      return { sent: true };
+    } catch (error) {
+      if (/not authorized|(-1743)|assistive/i.test(String(error?.stderr ?? error))) {
+        throw permissionError('messages-automation-permission-required', '请在系统设置中允许 DeepSeek Harness 自动化控制 Messages。', error);
+      }
+      throw error;
+    }
+  }
+}
+
+export { DEFAULT_DB_PATH };

package/src/channels/imessage/imessage-bridge.mjs

@@ -0,0 +1,16 @@
+import { TextHarnessBridge, createTextBridgeStatus } from '../shared/text-harness-bridge.mjs';
+
+export const IMESSAGE_DESCRIPTOR = Object.freeze({
+  key: 'imessage',
+  label: 'iMessage',
+  connectionLabel: ' macOS Messages 连接',
+  reactions: Object.freeze({ processing: '👀', success: '✅', error: '❌' }),
+});
+
+export class IMessageHarnessBridge extends TextHarnessBridge {
+  constructor(options) {
+    super({ ...options, descriptor: IMESSAGE_DESCRIPTOR });
+  }
+}
+
+export { createTextBridgeStatus as createIMessageBridgeStatus };

package/src/channels/imessage/runtime.mjs

@@ -0,0 +1,98 @@
+import { sendRememberedConnectionTest } from '../shared/connection-test.mjs';
+import { MacOSMessagesApi, normalizeIMessage } from './imessage-api.mjs';
+import { createIMessageBridgeStatus, IMessageHarnessBridge } from './imessage-bridge.mjs';
+
+const DEFAULT_POLL_INTERVAL_MS = 2_000;
+
+class IMessageBotClient {
+  #api;
+  #signal;
+  constructor(api, signal) { this.#api = api; this.#signal = signal; }
+  sendText(target, text) {
+    return this.#api.sendText({
+      chatGuid: target.chatGuid,
+      address: target.address,
+      text,
+      signal: this.#signal,
+    });
+  }
+  sendTyping() { return Promise.resolve(); }
+}
+
+export function createIMessageRuntimeStatus() {
+  return { startedAt: null, ready: false, connectionState: 'idle', harnessReachable: false,
+    lastCheckedAt: null, lastConnectedAt: null, lastError: null, ...createIMessageBridgeStatus() };
+}
+
+export class IMessageRuntime {
+  #config; #token; #harness; #state; #contextEnhancement; #accessPolicy; #logger;
+  #replyTimeoutMs; #pollIntervalMs; #createApi; #status = createIMessageRuntimeStatus();
+  #api; #bridge; #abortController; #timer; #polling; #stopped = true;
+  constructor({ config, token, harness, state, contextEnhancement, accessPolicy, logger = console,
+    replyTimeoutMs = 600_000, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,
+    createApi = (options) => new MacOSMessagesApi(options) }) {
+    if (!config || !token || !harness || !state) throw new TypeError('IMessageRuntime requires config, token, Harness, and state');
+    this.#config = config; this.#token = token; this.#harness = harness; this.#state = state;
+    this.#contextEnhancement = contextEnhancement; this.#accessPolicy = accessPolicy; this.#logger = logger;
+    this.#replyTimeoutMs = replyTimeoutMs; this.#pollIntervalMs = pollIntervalMs; this.#createApi = createApi;
+  }
+  get status() { return structuredClone(this.#status); }
+  async sendConnectionTest(text) {
+    if (!this.#status.ready || !this.#api) { const error = new Error('iMessage gateway is not connected'); error.code = 'test-target-unavailable'; throw error; }
+    await sendRememberedConnectionTest({
+      state: this.#state,
+      text,
+      channelLabel: 'iMessage',
+      send: (target, value) => this.#api.sendText({
+        chatGuid: target.chatGuid, address: target.address, text: value,
+      }),
+    });
+  }
+  async sendProactiveText(target, text, options = {}) {
+    if (!this.#status.ready || !this.#api) { const error = new Error('iMessage gateway is not connected'); error.code = 'bot-not-connected'; throw error; }
+    const chatGuid = target?.route?.chatGuid;
+    if (!chatGuid) { const error = new TypeError('Invalid iMessage proactive delivery target'); error.code = 'invalid-target'; throw error; }
+    await this.#api.sendText({ chatGuid, text, signal: options.signal });
+    return { sent: true };
+  }
+  async start() {
+    if (this.#status.ready) return this.status;
+    await this.stop(); this.#stopped = false; this.#status.startedAt = new Date().toISOString(); this.#status.connectionState = 'connecting';
+    this.#abortController = new AbortController();
+    try {
+      await this.#harness.ensureRunning(); this.#status.harnessReachable = true;
+      this.#api = this.#createApi({ signal: this.#abortController.signal });
+      const permissions = await this.#api.getPermissions();
+      if (permissions.database !== 'granted' || permissions.automation !== 'granted') {
+        const error = new Error('macOS Messages permissions are required');
+        error.code = 'messages-permission-required';
+        error.permissions = permissions;
+        throw error;
+      }
+      if (this.#state.cursor() === null && typeof this.#api.getLatestMessageRowId === 'function') {
+        await this.#state.setCursor(await this.#api.getLatestMessageRowId());
+      }
+      const client = new IMessageBotClient(this.#api, this.#abortController.signal);
+      this.#bridge = new IMessageHarnessBridge({ bot: client, harness: this.#harness, state: this.#state,
+        contextEnhancement: this.#contextEnhancement, accessPolicy: this.#accessPolicy, status: this.#status,
+        logger: this.#logger, replyTimeoutMs: this.#replyTimeoutMs, signal: this.#abortController.signal });
+      this.#status.ready = true; this.#status.connectionState = 'connected'; this.#status.lastConnectedAt = Date.now();
+      this.#schedulePoll(0); return this.status;
+    } catch (error) { this.#status.ready = false; this.#status.connectionState = 'failed'; this.#status.lastError = error.message; await this.stop(); throw error; }
+  }
+  async stop() { this.#stopped = true; clearTimeout(this.#timer); this.#timer = null; this.#abortController?.abort(); await this.#polling?.catch(() => {}); this.#polling = null; this.#bridge = null; this.#api = null; this.#status.ready = false; }
+  #schedulePoll(delay) { if (this.#stopped) return; this.#timer = setTimeout(() => { this.#polling = this.#poll().finally(() => this.#schedulePoll(this.#pollIntervalMs)); }, delay); this.#timer.unref?.(); }
+  async #poll() {
+    if (!this.#api || !this.#bridge || this.#stopped) return;
+    try {
+      const rows = await this.#api.listMessages({ after: this.#state.cursor() ?? 0, limit: 100 });
+      const messages = Array.isArray(rows) ? rows : rows?.messages ?? rows?.data ?? [];
+      for (const raw of messages) {
+        const message = normalizeIMessage(raw, { botId: this.#config.platformId });
+        if (message) await this.#bridge.accept(message);
+        if (Number.isSafeInteger(raw.rowid)) await this.#state.setCursor(raw.rowid);
+      }
+      this.#status.lastCheckedAt = Date.now(); this.#status.lastError = null;
+    } catch (error) { if (!this.#stopped) { this.#status.lastError = error.message; this.#logger.warn?.('[dsh-im:imessage] polling failed', error); } }
+  }
+}

package/src/channels/imessage/state-store.mjs

@@ -0,0 +1,3 @@
+import { ConversationStateStore } from '../shared/conversation-state-store.mjs';
+
+export class IMessageStateStore extends ConversationStateStore {}

package/src/channels/shared/i18n-en/shared-a.mjs

@@ -89,8 +89,8 @@ export default {
     'The Workspace or Session state just changed. Please send this message again.',
   '当前工作区不存在或暂不可用。请重新选择工作区后重试。':
     'The current Workspace does not exist or is unavailable. Select another Workspace and try again.',
-  '当前 Agent Preset 不存在或暂不可用。请发送 /presetlist 后重新选择。':
-    'The current Agent Preset does not exist or is unavailable. Send /presetlist and select another one.',
+  '当前 Agent Preset 无法使用。请发送 /presetlist 查看可用项，使用 /preset <序号或 ID> 重新选择，再发送 /new 创建新会话后重试。如需继续原会话，请联系管理员恢复原 Preset。':
+    'The current Agent Preset is unavailable. Send /presetlist to see available options, select one with /preset <index or ID>, then send /new to create a new Session and try again. To continue the original Session, ask an administrator to restore the original Preset.',
   '回复已经生成，但机器人没有发送权限。请联系管理员检查渠道权限或重新绑定机器人。':
     'The reply was generated, but the bot cannot send it. Ask an administrator to check channel permissions or reconnect the bot.',
   '回复已经生成，但当前渠道正在限流，暂时无法发送。请稍后重试。':

package/src/channels/shared/message-failure.mjs

@@ -77,7 +77,7 @@ const FAILURE_MESSAGES = Object.freeze({
   WORKSPACE_UNAVAILABLE:
     '当前工作区不存在或暂不可用。请重新选择工作区后重试。',
   PRESET_UNAVAILABLE:
-    '当前 Agent Preset 不存在或暂不可用。请发送 /presetlist 后重新选择。',
+    '当前 Agent Preset 无法使用。请发送 /presetlist 查看可用项，使用 /preset <序号或 ID> 重新选择，再发送 /new 创建新会话后重试。如需继续原会话，请联系管理员恢复原 Preset。',
   CHANNEL_PERMISSION:
     '回复已经生成，但机器人没有发送权限。请联系管理员检查渠道权限或重新绑定机器人。',
   CHANNEL_RATE_LIMIT:
@@ -133,7 +133,7 @@ function failureCode(error) {
   if (code === 'agent-busy') return 'SESSION_BUSY';
   if (code === 'workspace-session-stale') return 'SESSION_STALE';
   if (code.startsWith('workspace-')) return 'WORKSPACE_UNAVAILABLE';
-  if (code.startsWith('agent-preset-')) return 'PRESET_UNAVAILABLE';
+  if (/^agent-preset[-/]/u.test(code)) return 'PRESET_UNAVAILABLE';
   if (code.startsWith('image-') || code.startsWith('inbound-file-')
     || code === 'attachment-error') return 'INPUT_INVALID';
 
@@ -170,8 +170,8 @@ function safeReferenceId(value) {
 }
 
 function safeFailureReason(value) {
-  if (typeof value !== 'string' || !/^[A-Za-z0-9_-]{1,64}$/u.test(value)) return null;
-  return value.toUpperCase().replaceAll('-', '_');
+  if (typeof value !== 'string' || !/^[A-Za-z0-9_/-]{1,64}$/u.test(value)) return null;
+  return value.toUpperCase().replace(/[-/]/gu, '_');
 }
 
 export function classifyMessageFailure(error, {
@@ -190,7 +190,7 @@ export function classifyMessageFailure(error, {
     : classifiedCode;
   return Object.freeze({
     code,
-    reason: safeReason ?? code,
+    reason: safeReason ?? safeFailureReason(error?.code) ?? code,
     message: typeof userMessage === 'string' && userMessage.trim()
       ? userMessage.trim()
       : t(FAILURE_MESSAGES[code]),

package/src/channels/shared/session-channel-labels.mjs

@@ -8,6 +8,7 @@ export const SESSION_CHANNEL_LABELS = Object.freeze(Object.fromEntries(Object.en
   telegram: ['Telegram', 'Telegram'],
   discord: ['Discord', 'Discord'],
   whatsapp: ['WhatsApp', 'WhatsApp'],
+  imessage: ['iMessage', 'iMessage'],
   office: ['AI Office', 'AI Office'],
 }).map(([channel, labels]) => [channel, Object.freeze(labels)])));