@anarkhgatsby/deepseek-harness-channel-imessage 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mapan0424
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# harness-channel-imessage
+
+DeepSeek Harness 的本机 iMessage 通道插件。插件只通过 macOS 的 `Messages.app` 和本地 `chat.db` 收发消息，不使用 `imsg` CLI、Photon 或任何云中继。
+
+## 隐私设计
+
+- 消息数据不经过第三方云服务。
+- 入站消息从 `~/Library/Messages/chat.db` 只读轮询。
+- 出站消息通过 macOS `/usr/bin/osascript` 控制 `Messages.app` 发送。
+- 不需要安装额外的 CLI，也不需要配置云端 API Key。
+- 需要为 DeepSeek Harness 授予“完全磁盘访问”和“自动化 → 信息”权限。
+
+## 架构
+
+```
+Harness Agent
+     │
+     ▼
+Cordis 通道插件（host: index.js）
+     │
+     ▼
+GatewayCore（来自 @anarkhgatsby/deepseek-harness-core）
+     │  统一消息总线：路由 / 去重 / 投递 / 流式回复
+     ▼
+LocalAdapter
+     ├── chat.db：读取入站消息
+     └── Messages.app：发送出站消息
+```
+
+## 配置
+
+插件保留 `local` 模式作为兼容标识，但当前没有模式选择项。配置页面只展示：
+
+- `chatDb`：Messages 数据库路径，默认 `~/Library/Messages/chat.db`
+- `defaultWorkspace`：默认工作空间路径
+- 自动回复
+- 流式回复
+
+收到消息后，插件会根据 sender 路由到对应工作空间，并由 Harness Agent 自动回复。
+
+## 代码结构
+
+- `index.js` — 注册 `imessage` settings namespace、启动本地网关和 `message_imessage` 工具。
+- `client.js` — 导出本地模式的客户端元数据。
+- `lib/config.mjs` — 本地模式配置 schema 与归一化逻辑。
+- `lib/adapters/local.mjs` — `chat.db` 监听与 `Messages.app` AppleScript 发送。
+- `cordis.patch.yml` — Cordis 补丁入口。
+
+## 开发
+
+```bash
+node --check index.js
+node --check client.js
+node --check lib/config.mjs
+node --check lib/adapters/local.mjs
+```
+
+License: MIT。

package/client.js

@@ -0,0 +1,22 @@
+if (typeof window !== "undefined" && window.__ModuleLoader__) {
+  window.__ModuleLoader__.load({
+    id: "@anarkhgatsby/deepseek-harness-channel-imessage",
+    factory: (require) => {
+      const module = { exports: {} };
+      const exports = module.exports;
+      Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+
+      exports.IMESSAGE_GATEWAY = "imessageGateway";
+      exports.MODES = ["local"];
+      exports.modeMeta = {
+        local: {
+          label: "本机 Messages.app",
+          description: "通过本机 chat.db 与 Messages.app 直接收发 iMessage。数据不经过第三方云服务。",
+          fields: ["chatDb", "defaultWorkspace"],
+        },
+      };
+
+      return module.exports;
+    },
+  });
+}

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# harness-channel-imessage bundle patch
+# 插入 host 插件行：注册 imessage settings namespace + 网关监听 + 统一消息总线。
+# 通过 --patch 注入，与同名 Harness 插件一致，随 dsh web 启停。
+- insert:
+    - id: harness-channel-imessage
+      name: '@anarkhgatsby/deepseek-harness-channel-imessage'

package/index.js

@@ -0,0 +1,216 @@
+/**
+ * index.js — harness-channel-imessage host 入口（薄壳，托管消息总线）
+ *
+ * iMessage 仅使用本机 local 传输：通过 chat.db 监听，并由 Messages.app 发送消息。
+ * 消息总线（GatewayCore）与 logger 均从共享包 `@anarkhgatsby/deepseek-harness-core` 导入，
+ * 本插件只做"平台门面"：注册 imessage settings namespace、选适配器、注册 message 工具。
+ *
+ * 数据落盘：$DSH_HOME/settings.yaml 的 `imessage` 段 + $DSH_HOME/imessage-gateway-state.json
+ * （sender→session 映射）。client 通过 Typert remote `imessageGateway` 读写。
+ */
+import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import z from "@deepseek-ai/schemastery";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { GatewayCore, createChannelLogger } from "@anarkhgatsby/deepseek-harness-core";
+import { LocalAdapter } from "./lib/adapters/local.mjs";
+import { MODES, DEFAULT_MODE, normalizeSettings } from "./lib/config.mjs";
+
+export const name = "harness-channel-imessage";
+
+// 框架依赖：typert/settings（配置 remote）+ agents/agentPresets/workspaceRegistry/
+// sessionPersistence/sessionTitle/tools（网关投递 + message 工具）。
+export const inject = [
+  "typert",
+  "settings",
+  "agents",
+  "agentDefaultModel",
+  "agentPresets",
+  "sessions",
+  "workspaceRegistry",
+  "sessionPersistence",
+  "sessionTitle",
+  "tools",
+];
+
+/** 插件自身 schema：settingsPath（settings.yaml）+ statePath（sender→session 映射）。 */
+export const Config = z.object({
+  settingsPath: z.string().default(join(homedir(), ".dsh", "settings.yaml")),
+  statePath: z.string().default(join(homedir(), ".dsh", "imessage-gateway-state.json")),
+});
+
+/** `imessage` settings namespace schema（路由 + 通用开关 + 各通道专属配置）。 */
+const GatewaySchema = z.object({
+  routes: z.dict(z.string()),
+  mode: z.string(), // 兼容旧配置，当前仅支持 local
+  chatDb: z.string(),
+  defaultWorkspace: z.string(),
+  autoReply: z.boolean(),
+  streamReplies: z.boolean(),
+  toolCallReplies: z.boolean(),
+  stepTimeoutSec: z.number(),
+  allowlist: z.array(z.string()),
+});
+
+// ── Typert wire schemas ───────────────────────────────────────────────────
+function parseObj() {
+  return {
+    parse(value) {
+      if (typeof value !== "object" || value === null) throw new Error("expected object");
+      return value;
+    },
+  };
+}
+const getResultSchema = parseObj();
+const setPayloadSchema = parseObj();
+const setResultSchema = parseObj();
+
+/** Typert MANIFEST：注册给 API gateway 的远程方法。 */
+const MANIFEST = {
+  package: "harness-channel-imessage",
+  face: "host",
+  schemas: [],
+  invocations: [
+    {
+      id: "harness-channel-imessage#imessageGateway/getConfig",
+      service: "imessageGateway",
+      namespace: "imessageGateway",
+      method: "getConfig",
+      invocation: { kind: "direct" },
+      parameters: [],
+      result: { mode: "strict", typeSymbol: "harness-channel-imessage#GatewayConfig", schema: getResultSchema },
+    },
+    {
+      id: "harness-channel-imessage#imessageGateway/setConfig",
+      service: "imessageGateway",
+      namespace: "imessageGateway",
+      method: "setConfig",
+      invocation: { kind: "direct" },
+      parameters: [
+        {
+          name: "payload",
+          wire: "payload",
+          source: "json",
+          codec: { mode: "strict", typeSymbol: "harness-channel-imessage#SetPayload", schema: setPayloadSchema },
+        },
+      ],
+      result: { mode: "strict", typeSymbol: "harness-channel-imessage#SetResult", schema: setResultSchema },
+    },
+  ],
+  model: { services: [], events: [], objects: [] },
+};
+
+class GatewayService extends TypertRemoteService {
+  constructor(ctx, scope, adapter) {
+    super(ctx, "imessageGateway");
+    this.scope = scope;
+    this.adapter = adapter;
+  }
+
+  getConfig() {
+    const snap = this.scope.get();
+    return normalizeSettings(snap);
+  }
+
+  async setConfig(payload) {
+    const current = this.scope.get() ?? {};
+    // 用 replace（整体替换）避免 update 深合并导致删路由不生效。
+    const section = normalizeSettings({ ...current, ...payload });
+    await this.scope.replace(section);
+    return { ok: true };
+  }
+}
+
+export function apply(ctx, config) {
+  const scope = ctx.settings.register("imessage", GatewaySchema, {
+    base: {
+      routes: {},
+      mode: DEFAULT_MODE,
+      chatDb: join(homedir(), "Library/Messages/chat.db"),
+      defaultWorkspace: join(homedir(), "dsh", "default"),
+      autoReply: true,
+      streamReplies: true,
+      toolCallReplies: true,
+      stepTimeoutSec: 0,
+      allowlist: [],
+    },
+  });
+
+  const log = createChannelLogger("im", ctx.logger);
+
+  // iMessage 仅允许本机 local 适配器；热更新时由 scope.watch 重载配置。
+  const resolveAdapter = () => {
+    const getConfig = () => normalizeSettings(scope.get());
+    return new LocalAdapter({ getConfig, log });
+  };
+
+  const adapter = resolveAdapter();
+  const core = new GatewayCore({
+    tag: "im",
+    adapter,
+    agents: ctx.get("agents"),
+    defaultModel: ctx.get("agentDefaultModel"),
+    sessions: ctx.get("sessions"),
+    agentPresets: ctx.get("agentPresets"),
+    workspaceRegistry: ctx.get("workspaceRegistry"),
+    sessionPersistence: ctx.get("sessionPersistence"),
+    sessionTitle: ctx.get("sessionTitle"),
+    log,
+    statePath: config.statePath,
+  });
+
+  // 配置 remote（配置页读写）
+  new GatewayService(ctx, scope, adapter);
+  ctx.effect(() => ctx.typert.register(MANIFEST), "harness-channel-imessage: typert manifest");
+
+  // 启动网关监听
+  ctx.on("dispose", () => core.stopListener());
+  core.startListener().then(() => log.info("网关监听已启动")).catch((e) => log.error(`启动监听失败 ${e instanceof Error ? e.message : e}`));
+
+  // 配置热更新：配置页保存后立即推给运行中的网关
+  scope.watch((next) => {
+    const normalized = normalizeSettings(next);
+    core.applyConfig(normalized);
+    log.info(`配置热更新: mode=${normalized.mode} routes=${Object.keys(core.routes).length}条 autoReply=${core.autoReply}`);
+  });
+
+  // 注册全局 `message_imessage` 工具
+  const messageTool = defineTool({
+    name: "message_imessage",
+    description: "通过本机 Messages.app 的 iMessage 通道向联系人发送一条文本消息。用于主动通知/提醒用户。",
+    parameters: {
+      action: { type: "string", required: true, description: "操作类型，目前仅支持 send" },
+      channel: { type: "string", required: true, description: "发送渠道：imessage/local" },
+      target: { type: "string", required: true, description: "目标 handle（号码如 +8613800000000 或 email）" },
+      message: { type: "string", required: true, description: "要发送的文本内容" },
+    },
+    output: {
+      schema: { type: "object", additionalProperties: false, properties: { ok: { type: "boolean", required: true } } },
+      render(args, value) {
+        const target = (typeof args === "object" && args !== null && typeof args.target === "string") ? args.target : "?";
+        return [{ type: "text", text: value.ok ? `已发送到 ${target}` : "发送失败" }];
+      },
+    },
+    async execute(args) {
+      let a = args;
+      if (typeof args === "string") { try { a = JSON.parse(args); } catch { return { ok: false }; } }
+      const action = a?.action ?? "send";
+      const target = a?.target;
+      const text = a?.message;
+      if (action !== "send" || !target || !text) return { ok: false };
+      try {
+        await core.send(target, text);
+        log.info(`message 工具已发送到 ${target}: ${String(text).slice(0, 40)}`);
+        return { ok: true };
+      } catch (e) {
+        log.error(`message 工具发送失败: ${e instanceof Error ? e.message : e}`);
+        return { ok: false };
+      }
+    },
+  });
+  ctx.tools.register(messageTool);
+  log.info("已注册全局 message 工具（iMessage 发送）");
+}
+
+export { MODES, DEFAULT_MODE };

package/lib/adapters/local.mjs

@@ -0,0 +1,131 @@
+/**
+ * Native macOS iMessage transport.
+ *
+ * Incoming messages are read from the local Messages database; outgoing text
+ * is sent by Messages.app through AppleScript. No imsg CLI or third-party
+ * relay is required.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { DatabaseSync } from "node:sqlite";
+
+const POLL_INTERVAL_MS = 1000;
+
+const SEND_SCRIPT = `on run argv
+  set targetHandle to item 1 of argv
+  set outgoingText to item 2 of argv
+  tell application "Messages"
+    set targetService to first service whose service type = iMessage
+    set targetBuddy to buddy targetHandle of targetService
+    send outgoingText to targetBuddy
+  end tell
+end run`;
+
+function friendlyError(error, action) {
+  const detail = error instanceof Error ? error.message : String(error);
+  return `${action}失败：${detail}。请在“系统设置 → 隐私与安全性”中为 DeepSeek Harness 开启完全磁盘访问；首次发送时允许其自动化控制“信息”。`;
+}
+
+export class LocalAdapter {
+  constructor({ getConfig, log = console }) {
+    this.getConfig = getConfig;
+    this.log = log;
+    this.db = null;
+    this.timer = null;
+    this.lastRowId = 0;
+    this.handler = null;
+    this.polling = false;
+  }
+
+  async start(handler) {
+    this.handler = handler;
+    this._openDatabase();
+    this.lastRowId = this._latestRowId();
+    this.timer = setInterval(() => void this._poll(), POLL_INTERVAL_MS);
+    this.log.info?.(`[local] 正在监听 Messages chat.db（从第 ${this.lastRowId} 条之后开始）`);
+  }
+
+  _openDatabase() {
+    const chatDb = this.getConfig().chatDb;
+    if (!chatDb || !existsSync(chatDb)) {
+      throw new Error(`找不到 chat.db：${chatDb || "未配置路径"}`);
+    }
+    try {
+      this.db = new DatabaseSync(chatDb, { open: true, readOnly: true });
+    } catch (error) {
+      throw new Error(friendlyError(error, "打开 Messages 数据库"));
+    }
+  }
+
+  _latestRowId() {
+    const row = this.db.prepare("SELECT COALESCE(MAX(ROWID), 0) AS id FROM message").get();
+    return Number(row?.id || 0);
+  }
+
+  async _poll() {
+    if (this.polling || !this.db) return;
+    this.polling = true;
+    try {
+      const rows = this.db
+        .prepare(`
+          SELECT m.ROWID AS id, m.guid AS guid, m.text AS text,
+                 m.is_from_me AS is_from_me, h.id AS sender
+          FROM message AS m
+          LEFT JOIN handle AS h ON h.ROWID = m.handle_id
+          WHERE m.ROWID > ? AND COALESCE(m.is_from_me, 0) = 0
+          ORDER BY m.ROWID ASC
+        `)
+        .all(this.lastRowId);
+      for (const row of rows) {
+        this.lastRowId = Math.max(this.lastRowId, Number(row.id || 0));
+        const sender = typeof row.sender === "string" ? row.sender.trim() : "";
+        const text = typeof row.text === "string" ? row.text.trim() : "";
+        if (!sender || !text) continue;
+        await this.handler?.({
+          sender,
+          text,
+          images: [],
+          raw: { id: row.id, guid: row.guid },
+          dedupeId: row.guid || String(row.id),
+        });
+      }
+    } catch (error) {
+      this.log.error?.(`[local] ${friendlyError(error, "读取 Messages 消息")}`);
+    } finally {
+      this.polling = false;
+    }
+  }
+
+  async send(to, text) {
+    await new Promise((resolve, reject) => {
+      const child = spawn("/usr/bin/osascript", ["-e", SEND_SCRIPT, to, text], {
+        stdio: ["ignore", "ignore", "pipe"],
+      });
+      let stderr = "";
+      child.stderr?.setEncoding("utf8");
+      child.stderr?.on("data", (chunk) => (stderr += chunk));
+      child.on("error", reject);
+      child.on("close", (code) => {
+        if (code === 0) resolve();
+        else reject(new Error(stderr.trim() || `osascript 退出 code=${code}`));
+      });
+    }).catch((error) => {
+      throw new Error(friendlyError(error, "通过 Messages.app 发送消息"));
+    });
+  }
+
+  async setTyping() {
+    // Messages.app does not expose a stable typing indicator API.
+  }
+
+  async stop() {
+    if (this.timer) clearInterval(this.timer);
+    this.timer = null;
+    this.db?.close();
+    this.db = null;
+  }
+
+  describe() {
+    return "macOS 本地通道（chat.db + Messages.app）";
+  }
+}

package/lib/config.mjs

@@ -0,0 +1,81 @@
+/**
+ * config.mjs — harness-imessage 统一配置 schema 与校验
+ *
+ * iMessage 仅使用本机 `local` 传输：chat.db 监听 + Messages.app（无 CLI、无云中继）。
+ * 配置保留 mode 字段用于兼容已有 settings，但唯一允许的值是 "local"。
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+/** 导出供 client 渲染的模式列表与默认。 */
+export const MODES = ["local"];
+export const DEFAULT_MODE = "local";
+
+/** 当前运行环境默认 chat.db 路径（网关以 root 运行时可用环境变量覆盖）。 */
+export function defaults() {
+  return {
+    mode: DEFAULT_MODE,
+    // local（本机）
+    chatDb: process.env.IMSG_CHAT_DB || join(homedir(), "Library/Messages/chat.db"),
+    defaultWorkspace: process.env.IMSG_DEFAULT_WORKSPACE || join(homedir(), "dsh", "default"),
+    // 通用
+    autoReply: true,
+    streamReplies: true,
+    toolCallReplies: true,
+    stepTimeoutSec: 0,
+    allowlist: [],
+    routes: {},
+  };
+}
+
+/**
+ * 对一份 settings 快照做宽松校验/归一化。
+ * 返回归一化对象；非法值回退默认，不抛错（前端已做基本校验兜底）。
+ */
+export function normalizeSettings(input) {
+  const base = defaults();
+  if (!input || typeof input !== "object") return base;
+
+  const pick = (key, fallback) =>
+    typeof input[key] === "string" && input[key].trim() ? input[key].trim() : fallback;
+  const bool = (key, fallback) =>
+    typeof input[key] === "boolean" ? input[key] : fallback;
+  const num = (key, fallback) => {
+    const n = Number(input[key]);
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+  };
+
+  const mode = MODES.includes(input.mode) ? input.mode : base.mode;
+
+  const out = {
+    ...base,
+    mode,
+    chatDb: pick("chatDb", base.chatDb),
+    defaultWorkspace: pick("defaultWorkspace", base.defaultWorkspace),
+    autoReply: bool("autoReply", base.autoReply),
+    streamReplies: bool("streamReplies", base.streamReplies),
+    toolCallReplies: bool("toolCallReplies", base.toolCallReplies),
+    stepTimeoutSec: num("stepTimeoutSec", base.stepTimeoutSec),
+  };
+
+  // routes: handle → workspace 路径
+  if (input.routes && typeof input.routes === "object") {
+    const routes = {};
+    for (const [k, v] of Object.entries(input.routes)) {
+      if (typeof v === "string" && v.trim()) {
+        const key = typeof k === "string" ? k.trim() : String(k);
+        if (key) routes[key] = v.trim();
+      }
+    }
+    out.routes = routes;
+  }
+
+  // allowlist: 允许的用户/号码列表（字符串数组）
+  if (Array.isArray(input.allowlist)) {
+    out.allowlist = input.allowlist
+      .map((x) => (typeof x === "string" ? x.trim() : ""))
+      .filter(Boolean);
+  }
+
+  return out;
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@anarkhgatsby/deepseek-harness-channel-imessage",
+  "version": "0.1.1",
+  "description": "Channel plugin for DeepSeek Harness: local-only iMessage transport through Messages.app and chat.db. Thin facade on @anarkhgatsby/deepseek-harness-core.",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mapan0424/deepseek-harness-desktop.git"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "lib/config.mjs",
+    "lib/adapters/local.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@anarkhgatsby/deepseek-harness-core": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@deepseek-ai/schemastery": ">=3.18.0"
+  }
+}