@heznpc/imcp 0.9.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ko.md +17 -2
- package/README.md +17 -2
- package/dist/calendar/scripts.js +11 -8
- package/dist/calendar/scripts.js.map +1 -1
- package/dist/finder/scripts.js +3 -3
- package/dist/finder/tools.js +3 -3
- package/dist/finder/tools.js.map +1 -1
- package/dist/index.js +186 -32
- package/dist/index.js.map +1 -1
- package/dist/mail/tools.js +2 -0
- package/dist/mail/tools.js.map +1 -1
- package/dist/messages/scripts.js +56 -19
- package/dist/messages/scripts.js.map +1 -1
- package/dist/messages/tools.d.ts +1 -1
- package/dist/messages/tools.js +6 -1
- package/dist/messages/tools.js.map +1 -1
- package/dist/shared/config.d.ts +23 -0
- package/dist/shared/config.js +111 -1
- package/dist/shared/config.js.map +1 -1
- package/dist/shared/hitl-guard.d.ts +8 -0
- package/dist/shared/hitl-guard.js +39 -0
- package/dist/shared/hitl-guard.js.map +1 -0
- package/dist/shared/hitl.d.ts +16 -0
- package/dist/shared/hitl.js +131 -0
- package/dist/shared/hitl.js.map +1 -0
- package/dist/shared/setup.d.ts +2 -1
- package/dist/shared/setup.js +22 -14
- package/dist/shared/setup.js.map +1 -1
- package/dist/shortcuts/prompts.d.ts +2 -0
- package/dist/shortcuts/prompts.js +148 -0
- package/dist/shortcuts/prompts.js.map +1 -0
- package/dist/system/scripts.js +4 -2
- package/dist/system/scripts.js.map +1 -1
- package/package.json +7 -4
package/dist/messages/tools.js
CHANGED
|
@@ -2,7 +2,8 @@ import { z } from "zod";
|
|
|
2
2
|
import { runJxa } from "../shared/jxa.js";
|
|
3
3
|
import { ok, err } from "../shared/result.js";
|
|
4
4
|
import { listChatsScript, readChatScript, searchMessagesScript, sendMessageScript, sendFileScript, listParticipantsScript, } from "./scripts.js";
|
|
5
|
-
export function registerMessagesTools(server,
|
|
5
|
+
export function registerMessagesTools(server, config) {
|
|
6
|
+
const { allowSendMessages } = config;
|
|
6
7
|
server.registerTool("list_chats", {
|
|
7
8
|
title: "List Chats",
|
|
8
9
|
description: "List recent chats in Messages with participants and last update time.",
|
|
@@ -58,6 +59,8 @@ export function registerMessagesTools(server, _config) {
|
|
|
58
59
|
},
|
|
59
60
|
annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
|
|
60
61
|
}, async ({ target, text }) => {
|
|
62
|
+
if (!allowSendMessages)
|
|
63
|
+
return err("Sending messages is disabled. Set IMCP_ALLOW_SEND_MESSAGES=true to enable.");
|
|
61
64
|
try {
|
|
62
65
|
return ok(await runJxa(sendMessageScript(target, text)));
|
|
63
66
|
}
|
|
@@ -74,6 +77,8 @@ export function registerMessagesTools(server, _config) {
|
|
|
74
77
|
},
|
|
75
78
|
annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
|
|
76
79
|
}, async ({ target, filePath }) => {
|
|
80
|
+
if (!allowSendMessages)
|
|
81
|
+
return err("Sending messages is disabled. Set IMCP_ALLOW_SEND_MESSAGES=true to enable.");
|
|
77
82
|
try {
|
|
78
83
|
return ok(await runJxa(sendFileScript(target, filePath)));
|
|
79
84
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/messages/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/messages/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAkB;IACzE,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SAC7G;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACxG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,yBAAyB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;SACvC;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACxG,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,wBAAwB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,yDAAyD;QACtE,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;YAC7F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SACrG;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACxG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,2BAA2B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,8FAA8F;QAC3G,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sFAAsF,CAAC;YACnH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;SACpE;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;KACzG,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC,iBAAiB;YAAE,OAAO,GAAG,CAAC,4EAA4E,CAAC,CAAC;QACjH,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,2BAA2B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,4FAA4F;QACzG,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SACnE;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;KACzG,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7B,IAAI,CAAC,iBAAiB;YAAE,OAAO,GAAG,CAAC,4EAA4E,CAAC,CAAC;QACjH,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,wBAAwB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,2CAA2C;QACxD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;SACvC;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACxG,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,CAAC,gCAAgC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC,CACF,CAAC;AAEJ,CAAC"}
|
package/dist/shared/config.d.ts
CHANGED
|
@@ -1,5 +1,28 @@
|
|
|
1
|
+
export type HitlLevel = "off" | "destructive-only" | "all-writes" | "all";
|
|
2
|
+
export interface HitlConfig {
|
|
3
|
+
level: HitlLevel;
|
|
4
|
+
whitelist: Set<string>;
|
|
5
|
+
timeout: number;
|
|
6
|
+
socketPath: string;
|
|
7
|
+
}
|
|
8
|
+
export declare const MODULE_NAMES: readonly ["notes", "reminders", "calendar", "contacts", "mail", "messages", "music", "finder", "safari", "system", "photos", "shortcuts", "intelligence"];
|
|
9
|
+
/** Core modules enabled by default when no config.json exists */
|
|
10
|
+
export declare const STARTER_MODULES: ReadonlySet<string>;
|
|
11
|
+
export type ModuleName = (typeof MODULE_NAMES)[number];
|
|
1
12
|
export interface ImcpConfig {
|
|
2
13
|
/** Include shared notes/folders in results. Default: false */
|
|
3
14
|
includeShared: boolean;
|
|
15
|
+
/** Set of disabled module names */
|
|
16
|
+
disabledModules: Set<string>;
|
|
17
|
+
/** Set of module names that require share approval */
|
|
18
|
+
shareApprovalModules: Set<string>;
|
|
19
|
+
/** Allow sending messages via Messages app. Default: true */
|
|
20
|
+
allowSendMessages: boolean;
|
|
21
|
+
/** Allow sending emails via Mail app. Default: true */
|
|
22
|
+
allowSendMail: boolean;
|
|
23
|
+
/** Human-in-the-loop confirmation config */
|
|
24
|
+
hitl: HitlConfig;
|
|
4
25
|
}
|
|
5
26
|
export declare function parseConfig(): ImcpConfig;
|
|
27
|
+
export declare function isModuleEnabled(config: ImcpConfig, moduleName: string): boolean;
|
|
28
|
+
export declare function needsShareApproval(config: ImcpConfig, moduleName: string): boolean;
|
package/dist/shared/config.js
CHANGED
|
@@ -1,6 +1,116 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
const HITL_LEVELS = ["off", "destructive-only", "all-writes", "all"];
|
|
4
|
+
export const MODULE_NAMES = [
|
|
5
|
+
"notes",
|
|
6
|
+
"reminders",
|
|
7
|
+
"calendar",
|
|
8
|
+
"contacts",
|
|
9
|
+
"mail",
|
|
10
|
+
"messages",
|
|
11
|
+
"music",
|
|
12
|
+
"finder",
|
|
13
|
+
"safari",
|
|
14
|
+
"system",
|
|
15
|
+
"photos",
|
|
16
|
+
"shortcuts",
|
|
17
|
+
"intelligence",
|
|
18
|
+
];
|
|
19
|
+
/** Core modules enabled by default when no config.json exists */
|
|
20
|
+
export const STARTER_MODULES = new Set([
|
|
21
|
+
"notes",
|
|
22
|
+
"reminders",
|
|
23
|
+
"calendar",
|
|
24
|
+
"shortcuts",
|
|
25
|
+
"system",
|
|
26
|
+
]);
|
|
27
|
+
function loadFileConfig() {
|
|
28
|
+
try {
|
|
29
|
+
const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
|
|
30
|
+
const file = join(home, ".config", "imcp", "config.json");
|
|
31
|
+
const data = readFileSync(file, "utf-8");
|
|
32
|
+
return { config: JSON.parse(data), fileExists: true };
|
|
33
|
+
}
|
|
34
|
+
catch {
|
|
35
|
+
return { config: {}, fileExists: false };
|
|
36
|
+
}
|
|
37
|
+
}
|
|
1
38
|
export function parseConfig() {
|
|
39
|
+
const { config: file, fileExists } = loadFileConfig();
|
|
40
|
+
const fullMode = process.env.IMCP_FULL === "true" || process.argv.includes("--full");
|
|
41
|
+
// Disabled modules: env vars override, then JSON fallback, then starter preset
|
|
42
|
+
const disabledModules = new Set();
|
|
43
|
+
const fileDisabled = new Set(file.disabledModules ?? []);
|
|
44
|
+
for (const mod of MODULE_NAMES) {
|
|
45
|
+
const envKey = `IMCP_DISABLE_${mod.toUpperCase()}`;
|
|
46
|
+
const envVal = process.env[envKey];
|
|
47
|
+
if (envVal === "true") {
|
|
48
|
+
disabledModules.add(mod);
|
|
49
|
+
}
|
|
50
|
+
else if (envVal === undefined && fileDisabled.has(mod)) {
|
|
51
|
+
disabledModules.add(mod);
|
|
52
|
+
}
|
|
53
|
+
else if (envVal === undefined && !fileExists && !fullMode && !STARTER_MODULES.has(mod)) {
|
|
54
|
+
// No config.json & not --full: apply starter preset
|
|
55
|
+
disabledModules.add(mod);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
// Share approval: env var overrides, then JSON fallback
|
|
59
|
+
const shareApprovalModules = new Set();
|
|
60
|
+
const shareApprovalEnv = process.env.IMCP_SHARE_APPROVAL;
|
|
61
|
+
if (shareApprovalEnv) {
|
|
62
|
+
for (const raw of shareApprovalEnv.split(",")) {
|
|
63
|
+
const mod = raw.trim().toLowerCase();
|
|
64
|
+
if (mod && MODULE_NAMES.includes(mod)) {
|
|
65
|
+
shareApprovalModules.add(mod);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
else if (file.shareApproval) {
|
|
70
|
+
for (const mod of file.shareApproval) {
|
|
71
|
+
if (MODULE_NAMES.includes(mod)) {
|
|
72
|
+
shareApprovalModules.add(mod);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
// Boolean configs: env var > JSON > default
|
|
77
|
+
const includeShared = process.env.IMCP_INCLUDE_SHARED !== undefined
|
|
78
|
+
? process.env.IMCP_INCLUDE_SHARED === "true"
|
|
79
|
+
: (file.includeShared ?? false);
|
|
80
|
+
const allowSendMessages = process.env.IMCP_ALLOW_SEND_MESSAGES !== undefined
|
|
81
|
+
? process.env.IMCP_ALLOW_SEND_MESSAGES !== "false"
|
|
82
|
+
: (file.allowSendMessages ?? true);
|
|
83
|
+
const allowSendMail = process.env.IMCP_ALLOW_SEND_MAIL !== undefined
|
|
84
|
+
? process.env.IMCP_ALLOW_SEND_MAIL !== "false"
|
|
85
|
+
: (file.allowSendMail ?? true);
|
|
86
|
+
// HITL config: env var > JSON > default
|
|
87
|
+
const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
|
|
88
|
+
const hitlLevelRaw = process.env.IMCP_HITL_LEVEL ?? file.hitl?.level ?? "off";
|
|
89
|
+
const hitlLevel = HITL_LEVELS.includes(hitlLevelRaw)
|
|
90
|
+
? hitlLevelRaw
|
|
91
|
+
: "off";
|
|
92
|
+
const hitlWhitelist = new Set(file.hitl?.whitelist ?? []);
|
|
93
|
+
const hitlTimeout = file.hitl?.timeout ?? 30;
|
|
94
|
+
const hitlSocketPath = join(home, ".config", "imcp", "hitl.sock");
|
|
95
|
+
const hitl = {
|
|
96
|
+
level: hitlLevel,
|
|
97
|
+
whitelist: hitlWhitelist,
|
|
98
|
+
timeout: hitlTimeout,
|
|
99
|
+
socketPath: hitlSocketPath,
|
|
100
|
+
};
|
|
2
101
|
return {
|
|
3
|
-
includeShared
|
|
102
|
+
includeShared,
|
|
103
|
+
disabledModules,
|
|
104
|
+
shareApprovalModules,
|
|
105
|
+
allowSendMessages,
|
|
106
|
+
allowSendMail,
|
|
107
|
+
hitl,
|
|
4
108
|
};
|
|
5
109
|
}
|
|
110
|
+
export function isModuleEnabled(config, moduleName) {
|
|
111
|
+
return !config.disabledModules.has(moduleName);
|
|
112
|
+
}
|
|
113
|
+
export function needsShareApproval(config, moduleName) {
|
|
114
|
+
return config.shareApprovalModules.has(moduleName);
|
|
115
|
+
}
|
|
6
116
|
//# sourceMappingURL=config.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { ImcpConfig } from "./config.js";
|
|
3
|
+
import type { HitlClient } from "./hitl.js";
|
|
4
|
+
/**
|
|
5
|
+
* Monkey-patches server.registerTool so every subsequent registration
|
|
6
|
+
* goes through HITL approval when the policy requires it.
|
|
7
|
+
*/
|
|
8
|
+
export declare function installHitlGuard(server: McpServer, hitlClient: HitlClient, config: ImcpConfig): void;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { err } from "./result.js";
|
|
2
|
+
function shouldRequireApproval(level, annotations, whitelist, toolName) {
|
|
3
|
+
if (whitelist.has(toolName))
|
|
4
|
+
return false;
|
|
5
|
+
switch (level) {
|
|
6
|
+
case "off":
|
|
7
|
+
return false;
|
|
8
|
+
case "destructive-only":
|
|
9
|
+
return annotations.destructiveHint === true;
|
|
10
|
+
case "all-writes":
|
|
11
|
+
return annotations.readOnlyHint === false;
|
|
12
|
+
case "all":
|
|
13
|
+
return true;
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Monkey-patches server.registerTool so every subsequent registration
|
|
18
|
+
* goes through HITL approval when the policy requires it.
|
|
19
|
+
*/
|
|
20
|
+
export function installHitlGuard(server, hitlClient, config) {
|
|
21
|
+
const original = server.registerTool.bind(server);
|
|
22
|
+
const patched = (name, toolConfig, callback) => {
|
|
23
|
+
const annotations = toolConfig.annotations ?? {};
|
|
24
|
+
if (!shouldRequireApproval(config.hitl.level, annotations, config.hitl.whitelist, name)) {
|
|
25
|
+
return original(name, toolConfig, callback);
|
|
26
|
+
}
|
|
27
|
+
const wrapped = async (...args) => {
|
|
28
|
+
const toolArgs = (args[0] ?? {});
|
|
29
|
+
const approved = await hitlClient.requestApproval(name, toolArgs, annotations.destructiveHint ?? false, annotations.openWorldHint ?? false);
|
|
30
|
+
if (!approved) {
|
|
31
|
+
return err(`Action denied: "${name}" requires user approval. The user denied or did not respond in time.`);
|
|
32
|
+
}
|
|
33
|
+
return callback(...args);
|
|
34
|
+
};
|
|
35
|
+
return original(name, toolConfig, wrapped);
|
|
36
|
+
};
|
|
37
|
+
server.registerTool = patched;
|
|
38
|
+
}
|
|
39
|
+
//# sourceMappingURL=hitl-guard.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hitl-guard.js","sourceRoot":"","sources":["../../src/shared/hitl-guard.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AASlC,SAAS,qBAAqB,CAC5B,KAAgB,EAChB,WAA4B,EAC5B,SAAsB,EACtB,QAAgB;IAEhB,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,kBAAkB;YACrB,OAAO,WAAW,CAAC,eAAe,KAAK,IAAI,CAAC;QAC9C,KAAK,YAAY;YACf,OAAO,WAAW,CAAC,YAAY,KAAK,KAAK,CAAC;QAC5C,KAAK,KAAK;YACR,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,UAAsB,EACtB,MAAkB;IAElB,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,CACd,IAAY,EACZ,UAAqE,EACrE,QAAyC,EACzC,EAAE;QACF,MAAM,WAAW,GAAoB,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC;QAElE,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;YACxF,OAAO,QAAQ,CAAC,IAAI,EAAE,UAA4C,EAAE,QAA0C,CAAC,CAAC;QAClH,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;YAC3C,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;YAC5D,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,eAAe,CAC/C,IAAI,EACJ,QAAQ,EACR,WAAW,CAAC,eAAe,IAAI,KAAK,EACpC,WAAW,CAAC,aAAa,IAAI,KAAK,CACnC,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,GAAG,CACR,mBAAmB,IAAI,uEAAuE,CAC/F,CAAC;YACJ,CAAC;YACD,OAAQ,QAAyC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,CAAC,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,EAAE,UAA4C,EAAE,OAAyC,CAAC,CAAC;IACjH,CAAC,CAAC;IACF,MAAM,CAAC,YAAY,GAAG,OAAqC,CAAC;AAC9D,CAAC"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { HitlConfig } from "./config.js";
|
|
2
|
+
export declare class HitlClient {
|
|
3
|
+
private config;
|
|
4
|
+
private socket;
|
|
5
|
+
private pending;
|
|
6
|
+
private buffer;
|
|
7
|
+
private connecting;
|
|
8
|
+
private connectPromise;
|
|
9
|
+
constructor(config: HitlConfig);
|
|
10
|
+
requestApproval(tool: string, args: Record<string, unknown>, destructive: boolean, openWorld: boolean): Promise<boolean>;
|
|
11
|
+
private ensureConnected;
|
|
12
|
+
private connect;
|
|
13
|
+
private onData;
|
|
14
|
+
private denyAllPending;
|
|
15
|
+
dispose(): void;
|
|
16
|
+
}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
import { createConnection } from "node:net";
|
|
2
|
+
import { randomUUID } from "node:crypto";
|
|
3
|
+
export class HitlClient {
|
|
4
|
+
config;
|
|
5
|
+
socket = null;
|
|
6
|
+
pending = new Map();
|
|
7
|
+
buffer = "";
|
|
8
|
+
connecting = false;
|
|
9
|
+
connectPromise = null;
|
|
10
|
+
constructor(config) {
|
|
11
|
+
this.config = config;
|
|
12
|
+
}
|
|
13
|
+
async requestApproval(tool, args, destructive, openWorld) {
|
|
14
|
+
try {
|
|
15
|
+
await this.ensureConnected();
|
|
16
|
+
}
|
|
17
|
+
catch {
|
|
18
|
+
console.error(`[hitl] socket unreachable at ${this.config.socketPath} — denying "${tool}"`);
|
|
19
|
+
return false;
|
|
20
|
+
}
|
|
21
|
+
const id = randomUUID();
|
|
22
|
+
const request = {
|
|
23
|
+
id,
|
|
24
|
+
type: "hitl_request",
|
|
25
|
+
tool,
|
|
26
|
+
args,
|
|
27
|
+
destructive,
|
|
28
|
+
openWorld,
|
|
29
|
+
};
|
|
30
|
+
return new Promise((resolve) => {
|
|
31
|
+
const timer = setTimeout(() => {
|
|
32
|
+
this.pending.delete(id);
|
|
33
|
+
console.error(`[hitl] timeout waiting for approval of "${tool}" — denying`);
|
|
34
|
+
resolve(false);
|
|
35
|
+
}, this.config.timeout * 1000);
|
|
36
|
+
this.pending.set(id, {
|
|
37
|
+
resolve: (approved) => {
|
|
38
|
+
clearTimeout(timer);
|
|
39
|
+
resolve(approved);
|
|
40
|
+
},
|
|
41
|
+
});
|
|
42
|
+
try {
|
|
43
|
+
this.socket.write(JSON.stringify(request) + "\n");
|
|
44
|
+
}
|
|
45
|
+
catch {
|
|
46
|
+
clearTimeout(timer);
|
|
47
|
+
this.pending.delete(id);
|
|
48
|
+
console.error(`[hitl] failed to send request for "${tool}" — denying`);
|
|
49
|
+
resolve(false);
|
|
50
|
+
}
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
ensureConnected() {
|
|
54
|
+
if (this.socket && !this.socket.destroyed) {
|
|
55
|
+
return Promise.resolve();
|
|
56
|
+
}
|
|
57
|
+
if (this.connectPromise) {
|
|
58
|
+
return this.connectPromise;
|
|
59
|
+
}
|
|
60
|
+
this.connectPromise = this.connect();
|
|
61
|
+
return this.connectPromise;
|
|
62
|
+
}
|
|
63
|
+
connect() {
|
|
64
|
+
return new Promise((resolve, reject) => {
|
|
65
|
+
this.connecting = true;
|
|
66
|
+
const socket = createConnection({ path: this.config.socketPath }, () => {
|
|
67
|
+
this.socket = socket;
|
|
68
|
+
this.connecting = false;
|
|
69
|
+
this.connectPromise = null;
|
|
70
|
+
this.buffer = "";
|
|
71
|
+
resolve();
|
|
72
|
+
});
|
|
73
|
+
socket.setEncoding("utf-8");
|
|
74
|
+
socket.on("data", (chunk) => {
|
|
75
|
+
this.onData(chunk);
|
|
76
|
+
});
|
|
77
|
+
socket.on("error", (error) => {
|
|
78
|
+
if (this.connecting) {
|
|
79
|
+
this.connecting = false;
|
|
80
|
+
this.connectPromise = null;
|
|
81
|
+
reject(error);
|
|
82
|
+
}
|
|
83
|
+
this.denyAllPending("socket error");
|
|
84
|
+
});
|
|
85
|
+
socket.on("close", () => {
|
|
86
|
+
this.socket = null;
|
|
87
|
+
this.connectPromise = null;
|
|
88
|
+
this.denyAllPending("socket closed");
|
|
89
|
+
});
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
onData(chunk) {
|
|
93
|
+
this.buffer += chunk;
|
|
94
|
+
const lines = this.buffer.split("\n");
|
|
95
|
+
// Keep the last incomplete line in the buffer
|
|
96
|
+
this.buffer = lines.pop() ?? "";
|
|
97
|
+
for (const line of lines) {
|
|
98
|
+
const trimmed = line.trim();
|
|
99
|
+
if (!trimmed)
|
|
100
|
+
continue;
|
|
101
|
+
try {
|
|
102
|
+
const msg = JSON.parse(trimmed);
|
|
103
|
+
if (msg.type === "hitl_response" && msg.id) {
|
|
104
|
+
const entry = this.pending.get(msg.id);
|
|
105
|
+
if (entry) {
|
|
106
|
+
this.pending.delete(msg.id);
|
|
107
|
+
entry.resolve(msg.approved);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
catch {
|
|
112
|
+
console.error("[hitl] failed to parse response:", trimmed);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
denyAllPending(reason) {
|
|
117
|
+
for (const [id, entry] of this.pending) {
|
|
118
|
+
console.error(`[hitl] ${reason} — denying pending request ${id}`);
|
|
119
|
+
entry.resolve(false);
|
|
120
|
+
}
|
|
121
|
+
this.pending.clear();
|
|
122
|
+
}
|
|
123
|
+
dispose() {
|
|
124
|
+
if (this.socket) {
|
|
125
|
+
this.socket.destroy();
|
|
126
|
+
this.socket = null;
|
|
127
|
+
}
|
|
128
|
+
this.denyAllPending("dispose");
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
//# sourceMappingURL=hitl.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hitl.js","sourceRoot":"","sources":["../../src/shared/hitl.ts"],"names":[],"mappings":"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"}
|
package/dist/shared/setup.d.ts
CHANGED
|
@@ -1,2 +1,3 @@
|
|
|
1
1
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
-
|
|
2
|
+
import { ImcpConfig } from "./config.js";
|
|
3
|
+
export declare function registerSetupTools(server: McpServer, config?: ImcpConfig): void;
|
package/dist/shared/setup.js
CHANGED
|
@@ -1,18 +1,21 @@
|
|
|
1
1
|
import { runJxa } from "./jxa.js";
|
|
2
2
|
import { ok } from "./result.js";
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
{ name: "
|
|
7
|
-
{ name: "
|
|
8
|
-
{ name: "
|
|
9
|
-
{ name: "
|
|
10
|
-
{ name: "
|
|
11
|
-
{ name: "
|
|
12
|
-
{
|
|
13
|
-
{ name: "
|
|
3
|
+
import { isModuleEnabled } from "./config.js";
|
|
4
|
+
/** Map: module name → macOS app name + permission-probe script */
|
|
5
|
+
const MODULE_APP_MAP = [
|
|
6
|
+
{ module: "notes", name: "Notes", script: "const Notes = Application('Notes'); JSON.stringify({app: 'Notes', accessible: true});" },
|
|
7
|
+
{ module: "reminders", name: "Reminders", script: "const Reminders = Application('Reminders'); JSON.stringify({app: 'Reminders', accessible: true});" },
|
|
8
|
+
{ module: "calendar", name: "Calendar", script: "const Calendar = Application('Calendar'); JSON.stringify({app: 'Calendar', accessible: true});" },
|
|
9
|
+
{ module: "contacts", name: "Contacts", script: "const Contacts = Application('Contacts'); JSON.stringify({app: 'Contacts', accessible: true});" },
|
|
10
|
+
{ module: "mail", name: "Mail", script: "const Mail = Application('Mail'); JSON.stringify({app: 'Mail', accessible: true});" },
|
|
11
|
+
{ module: "music", name: "Music", script: "const Music = Application('Music'); JSON.stringify({app: 'Music', accessible: true});" },
|
|
12
|
+
{ module: "finder", name: "Finder", script: "const Finder = Application('Finder'); JSON.stringify({app: 'Finder', accessible: true});" },
|
|
13
|
+
{ module: "safari", name: "Safari", script: "const Safari = Application('Safari'); JSON.stringify({app: 'Safari', accessible: true});" },
|
|
14
|
+
{ module: "system", name: "System Events", script: "const SE = Application('System Events'); JSON.stringify({app: 'System Events', accessible: true});" },
|
|
15
|
+
{ module: "photos", name: "Photos", script: "const Photos = Application('Photos'); JSON.stringify({app: 'Photos', accessible: true});" },
|
|
16
|
+
{ module: "messages", name: "Messages", script: "const Messages = Application('Messages'); JSON.stringify({app: 'Messages', accessible: true});" },
|
|
14
17
|
];
|
|
15
|
-
export function registerSetupTools(server) {
|
|
18
|
+
export function registerSetupTools(server, config) {
|
|
16
19
|
server.registerTool("setup_permissions", {
|
|
17
20
|
title: "Setup Permissions",
|
|
18
21
|
description: "Trigger macOS permission prompts for all Apple apps used by iMcp. Run this once after installation to grant all permissions at once. Each app will show a one-time macOS permission dialog.",
|
|
@@ -24,8 +27,12 @@ export function registerSetupTools(server) {
|
|
|
24
27
|
openWorldHint: false,
|
|
25
28
|
},
|
|
26
29
|
}, async () => {
|
|
30
|
+
// Only probe apps for enabled modules
|
|
31
|
+
const apps = config
|
|
32
|
+
? MODULE_APP_MAP.filter((a) => isModuleEnabled(config, a.module))
|
|
33
|
+
: MODULE_APP_MAP;
|
|
27
34
|
const results = [];
|
|
28
|
-
for (const app of
|
|
35
|
+
for (const app of apps) {
|
|
29
36
|
try {
|
|
30
37
|
await runJxa(app.script);
|
|
31
38
|
results.push({ app: app.name, status: "granted" });
|
|
@@ -38,7 +45,8 @@ export function registerSetupTools(server) {
|
|
|
38
45
|
}
|
|
39
46
|
}
|
|
40
47
|
const granted = results.filter((r) => r.status === "granted").length;
|
|
41
|
-
|
|
48
|
+
const skipped = MODULE_APP_MAP.length - apps.length;
|
|
49
|
+
return ok({ total: apps.length, granted, skipped, results });
|
|
42
50
|
});
|
|
43
51
|
}
|
|
44
52
|
//# sourceMappingURL=setup.js.map
|
package/dist/shared/setup.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/shared/setup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/shared/setup.ts"],"names":[],"mappings":"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"}
|