@sendsafely/mcp-server-local 0.0.0-stage → 1.0.5
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/LICENSE +201 -0
- package/NOTICE +22 -0
- package/README.md +390 -2
- package/dist/context.d.ts +2 -0
- package/dist/context.js +21 -0
- package/dist/credentials.d.ts +7 -0
- package/dist/credentials.js +59 -0
- package/dist/server.d.ts +2 -0
- package/dist/server.js +47 -0
- package/dist/setupCredentials.d.ts +2 -0
- package/dist/setupCredentials.js +151 -0
- package/dist/trustedDeviceKeyStore.d.ts +3 -0
- package/dist/trustedDeviceKeyStore.js +34 -0
- package/node_modules/@sendsafely/mcp-tools-core/LICENSE +201 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/approval.d.ts +51 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/approval.js +148 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/constants.d.ts +5 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/constants.js +8 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/context.d.ts +25 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/context.js +16 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/index.d.ts +18 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/index.js +17 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/instructions.d.ts +1 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/instructions.js +17 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/jsonResult.d.ts +3 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/jsonResult.js +15 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/recipientAddContext.d.ts +42 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/recipientAddContext.js +182 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/runTool.d.ts +2 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/runTool.js +22 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/safeHandler.d.ts +17 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/safeHandler.js +32 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/clientFactory.d.ts +17 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/clientFactory.js +29 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/oauthError.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/oauthError.js +34 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/sdkPromise.d.ts +53 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/sdkPromise.js +462 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/signedFetch.d.ts +6 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/signedFetch.js +28 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/store/keyStore.d.ts +6 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/store/keyStore.js +1 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/store/packageSecretCache.d.ts +18 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/store/packageSecretCache.js +39 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/createDirectory.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/createDirectory.js +53 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteDirectory.d.ts +10 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteDirectory.js +46 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteFile.d.ts +11 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteFile.js +53 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getActivityLog.d.ts +8 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getActivityLog.js +44 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getDirectory.d.ts +12 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getDirectory.js +51 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getEnterpriseInfo.d.ts +5 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getEnterpriseInfo.js +27 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getFileInformation.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getFileInformation.js +34 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getPackageInformation.d.ts +7 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getPackageInformation.js +41 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getReceivedPackages.d.ts +5 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getReceivedPackages.js +54 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getRecipient.d.ts +8 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getRecipient.js +30 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getSentPackages.d.ts +7 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getSentPackages.js +84 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getWorkspaces.d.ts +5 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getWorkspaces.js +114 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/index.d.ts +46 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/index.js +92 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/moveDirectory.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/moveDirectory.js +39 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/removeRecipient.d.ts +8 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/removeRecipient.js +34 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/renameDirectory.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/renameDirectory.js +34 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/setRecipientPhoneNumber.d.ts +10 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/setRecipientPhoneNumber.js +40 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addPackageMessage.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addPackageMessage.js +37 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipient.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipient.js +109 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientWithSms.d.ts +11 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientWithSms.js +115 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientsBulk.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientsBulk.js +110 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createPackage.d.ts +6 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createPackage.js +65 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createWorkspace.d.ts +10 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createWorkspace.js +107 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/deletePackage.d.ts +10 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/deletePackage.js +39 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadFileFromDirectory.d.ts +12 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadFileFromDirectory.js +91 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadPackageFiles.d.ts +12 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadPackageFiles.js +205 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizePackage.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizePackage.js +111 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizeUndisclosedPackage.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizeUndisclosedPackage.js +57 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/generateTrustedDeviceKeypair.d.ts +10 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/generateTrustedDeviceKeypair.js +75 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageInformationFromLink.d.ts +8 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageInformationFromLink.js +50 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageKeycode.d.ts +11 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageKeycode.js +120 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageMessage.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageMessage.js +59 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/listDownloadedFiles.d.ts +5 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/listDownloadedFiles.js +71 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/readDownloadedFile.d.ts +8 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/readDownloadedFile.js +176 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/uploadFile.d.ts +12 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/uploadFile.js +69 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateFile.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateFile.js +38 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updatePackage.d.ts +14 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updatePackage.js +122 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateRecipientRole.d.ts +9 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateRecipientRole.js +45 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/verifyCredentials.d.ts +5 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/tools/verifyCredentials.js +27 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/types/sendsafely.d.ts +432 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageChecksum.d.ts +1 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageChecksum.js +7 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageDir.d.ts +8 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageDir.js +50 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageLink.d.ts +2 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageLink.js +4 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/utils/sanitizeFilename.d.ts +4 -0
- package/node_modules/@sendsafely/mcp-tools-core/dist/utils/sanitizeFilename.js +8 -0
- package/node_modules/@sendsafely/mcp-tools-core/package.json +40 -0
- package/npm-shrinkwrap.json +1632 -0
- package/package.json +58 -4
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
import { jsonResult } from "../jsonResult.js";
|
|
2
|
+
import { runTool } from "../runTool.js";
|
|
3
|
+
import { safeHandler } from "../safeHandler.js";
|
|
4
|
+
import { getWorkspacesPage } from "../sdk/sdkPromise.js";
|
|
5
|
+
const MAX_WORKSPACES_SAFETY_CAP = 10_000;
|
|
6
|
+
function simplifyWorkspaceState(state) {
|
|
7
|
+
const upper = state.toUpperCase();
|
|
8
|
+
const core = upper.startsWith("PACKAGE_STATE_")
|
|
9
|
+
? upper.slice("PACKAGE_STATE_".length)
|
|
10
|
+
: upper;
|
|
11
|
+
if (core.startsWith("ACTIVE"))
|
|
12
|
+
return "Active";
|
|
13
|
+
if (core.startsWith("ARCHIVED") ||
|
|
14
|
+
core.startsWith("EXPIRED") ||
|
|
15
|
+
core.startsWith("DELETED")) {
|
|
16
|
+
return "Archived";
|
|
17
|
+
}
|
|
18
|
+
return state;
|
|
19
|
+
}
|
|
20
|
+
const STATUS_LIKE_FIELDS = ["state", "status"];
|
|
21
|
+
function simplifyWorkspaceEntry(pkg) {
|
|
22
|
+
if (typeof pkg !== "object" || pkg === null)
|
|
23
|
+
return pkg;
|
|
24
|
+
const obj = pkg;
|
|
25
|
+
let next;
|
|
26
|
+
for (const field of STATUS_LIKE_FIELDS) {
|
|
27
|
+
const value = obj[field];
|
|
28
|
+
if (typeof value !== "string")
|
|
29
|
+
continue;
|
|
30
|
+
const simplified = simplifyWorkspaceState(value);
|
|
31
|
+
if (simplified === value)
|
|
32
|
+
continue;
|
|
33
|
+
next ??= { ...obj };
|
|
34
|
+
next[field] = simplified;
|
|
35
|
+
}
|
|
36
|
+
return next ?? pkg;
|
|
37
|
+
}
|
|
38
|
+
async function collectAllWorkspaces(client) {
|
|
39
|
+
const all = [];
|
|
40
|
+
let rowIndex = 0;
|
|
41
|
+
let exhausted = false;
|
|
42
|
+
while (all.length < MAX_WORKSPACES_SAFETY_CAP) {
|
|
43
|
+
const page = await getWorkspacesPage(client, rowIndex);
|
|
44
|
+
const pkgs = page.packages ?? [];
|
|
45
|
+
if (pkgs.length === 0) {
|
|
46
|
+
exhausted = true;
|
|
47
|
+
break;
|
|
48
|
+
}
|
|
49
|
+
all.push(...pkgs);
|
|
50
|
+
if (page.totalPackages !== undefined && all.length >= page.totalPackages) {
|
|
51
|
+
exhausted = true;
|
|
52
|
+
break;
|
|
53
|
+
}
|
|
54
|
+
rowIndex += pkgs.length;
|
|
55
|
+
}
|
|
56
|
+
return { packages: all, truncated: !exhausted };
|
|
57
|
+
}
|
|
58
|
+
export async function handleGetWorkspaces(_args, extra, ctx) {
|
|
59
|
+
return runTool("get_workspaces", "Failed to retrieve workspaces", async () => {
|
|
60
|
+
const client = await ctx.getClient(extra);
|
|
61
|
+
const { packages, truncated } = await collectAllWorkspaces(client);
|
|
62
|
+
return jsonResult({
|
|
63
|
+
status: "success",
|
|
64
|
+
workspaces: packages.map(simplifyWorkspaceEntry),
|
|
65
|
+
truncated,
|
|
66
|
+
});
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
export function registerGetWorkspaces(mcp, ctx) {
|
|
70
|
+
mcp.registerTool("get_workspaces", {
|
|
71
|
+
title: "List Workspaces",
|
|
72
|
+
description: "Get the authenticated user's SendSafely workspaces (VDR packages). " +
|
|
73
|
+
"Pagination is handled internally up to a safety cap of 10,000 " +
|
|
74
|
+
"workspaces. The response always includes a top-level `truncated` " +
|
|
75
|
+
"boolean; when `true`, the cap was hit and additional workspaces " +
|
|
76
|
+
"exist beyond what was returned. Surface this to the user so they " +
|
|
77
|
+
"know the listing is incomplete. " +
|
|
78
|
+
"Each workspace's `state` field is collapsed to " +
|
|
79
|
+
"exactly one of two values for the listing: \"Active\" or " +
|
|
80
|
+
"\"Archived\". This covers both the raw API enum " +
|
|
81
|
+
"(PACKAGE_STATE_ACTIVE_* / PACKAGE_STATE_EXPIRED_* / " +
|
|
82
|
+
"PACKAGE_STATE_DELETED_*) AND SendSafely's UI display strings " +
|
|
83
|
+
"(\"Active – Pickup Complete\", \"Active – Waiting for Pickup\", " +
|
|
84
|
+
"\"Archived (Expired)\", \"Archived (Deleted)\", etc.). When " +
|
|
85
|
+
"summarising the list to the user, surface ONLY the words " +
|
|
86
|
+
"\"Active\" or \"Archived\" — do NOT include any qualifier like " +
|
|
87
|
+
"\"– Pickup Complete\" or \"(Expired)\" even if you remember " +
|
|
88
|
+
"seeing it in earlier output. If you need the precise state for " +
|
|
89
|
+
"a specific workspace (e.g. to distinguish expired vs. deleted " +
|
|
90
|
+
"before acting on it), call get_package_information on that " +
|
|
91
|
+
"workspace's package_id — the by-id endpoint preserves the full " +
|
|
92
|
+
"state enum. " +
|
|
93
|
+
"When rendering the list to the user, ALWAYS include the " +
|
|
94
|
+
"workspace owner. The owner is on each entry as the " +
|
|
95
|
+
"`packageOwner` field — surface it alongside the workspace name " +
|
|
96
|
+
"(`label`) and state. Owner is who the workspace is managed by; " +
|
|
97
|
+
"users typically scan a workspace list looking for theirs vs. " +
|
|
98
|
+
"someone else's, so omitting it loses critical context. " +
|
|
99
|
+
"SCOPE: the \"Active\" / \"Archived\" collapse rule above " +
|
|
100
|
+
"applies ONLY to workspace entries returned by THIS tool. Other " +
|
|
101
|
+
"package listings (get_received_packages, get_sent_packages) " +
|
|
102
|
+
"return TRANSFER and DROPZONE packages whose detailed state " +
|
|
103
|
+
"string is meaningful to the user — do NOT carry the collapse " +
|
|
104
|
+
"behaviour over to those tools' output. Each tool's description " +
|
|
105
|
+
"tells you how to render its own results.",
|
|
106
|
+
inputSchema: {},
|
|
107
|
+
annotations: {
|
|
108
|
+
readOnlyHint: true,
|
|
109
|
+
destructiveHint: false,
|
|
110
|
+
idempotentHint: true,
|
|
111
|
+
openWorldHint: true,
|
|
112
|
+
},
|
|
113
|
+
}, safeHandler("get_workspaces", (args, extra) => handleGetWorkspaces(args, extra, ctx)));
|
|
114
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { ToolContext } from "../context.js";
|
|
3
|
+
import type { KeyStore } from "../store/keyStore.js";
|
|
4
|
+
import { registerAddPackageMessage } from "./stdio/addPackageMessage.js";
|
|
5
|
+
import { registerAddRecipient } from "./stdio/addRecipient.js";
|
|
6
|
+
import { registerAddRecipientsBulk } from "./stdio/addRecipientsBulk.js";
|
|
7
|
+
import { registerAddRecipientWithSms } from "./stdio/addRecipientWithSms.js";
|
|
8
|
+
import { registerCreateDirectory } from "./createDirectory.js";
|
|
9
|
+
import { registerCreatePackage } from "./stdio/createPackage.js";
|
|
10
|
+
import { registerCreateWorkspace } from "./stdio/createWorkspace.js";
|
|
11
|
+
import { registerDeleteDirectory } from "./deleteDirectory.js";
|
|
12
|
+
import { registerDeleteFile } from "./deleteFile.js";
|
|
13
|
+
import { registerDeletePackage } from "./stdio/deletePackage.js";
|
|
14
|
+
import { registerDownloadFileFromDirectory } from "./stdio/downloadFileFromDirectory.js";
|
|
15
|
+
import { registerDownloadPackageFiles } from "./stdio/downloadPackageFiles.js";
|
|
16
|
+
import { registerFinalizePackage } from "./stdio/finalizePackage.js";
|
|
17
|
+
import { registerFinalizeUndisclosedPackage } from "./stdio/finalizeUndisclosedPackage.js";
|
|
18
|
+
import { registerGenerateTrustedDeviceKeypair } from "./stdio/generateTrustedDeviceKeypair.js";
|
|
19
|
+
import { registerGetActivityLog } from "./getActivityLog.js";
|
|
20
|
+
import { registerGetDirectory } from "./getDirectory.js";
|
|
21
|
+
import { registerGetEnterpriseInfo } from "./getEnterpriseInfo.js";
|
|
22
|
+
import { registerGetFileInformation } from "./getFileInformation.js";
|
|
23
|
+
import { registerGetPackageInformation } from "./getPackageInformation.js";
|
|
24
|
+
import { registerGetPackageInformationFromLink } from "./stdio/getPackageInformationFromLink.js";
|
|
25
|
+
import { registerGetPackageKeycode } from "./stdio/getPackageKeycode.js";
|
|
26
|
+
import { registerGetPackageMessage } from "./stdio/getPackageMessage.js";
|
|
27
|
+
import { registerGetReceivedPackages } from "./getReceivedPackages.js";
|
|
28
|
+
import { registerGetRecipient } from "./getRecipient.js";
|
|
29
|
+
import { registerGetSentPackages } from "./getSentPackages.js";
|
|
30
|
+
import { registerGetWorkspaces } from "./getWorkspaces.js";
|
|
31
|
+
import { registerListDownloadedFiles } from "./stdio/listDownloadedFiles.js";
|
|
32
|
+
import { registerMoveDirectory } from "./moveDirectory.js";
|
|
33
|
+
import { registerReadDownloadedFile } from "./stdio/readDownloadedFile.js";
|
|
34
|
+
import { registerRemoveRecipient } from "./removeRecipient.js";
|
|
35
|
+
import { registerRenameDirectory } from "./renameDirectory.js";
|
|
36
|
+
import { registerSetRecipientPhoneNumber } from "./setRecipientPhoneNumber.js";
|
|
37
|
+
import { registerUpdateFile } from "./updateFile.js";
|
|
38
|
+
import { registerUpdatePackage } from "./updatePackage.js";
|
|
39
|
+
import { registerUpdateRecipientRole } from "./updateRecipientRole.js";
|
|
40
|
+
import { registerUploadFile } from "./stdio/uploadFile.js";
|
|
41
|
+
import { registerVerifyCredentials } from "./verifyCredentials.js";
|
|
42
|
+
export { registerAddPackageMessage, registerAddRecipient, registerAddRecipientsBulk, registerAddRecipientWithSms, registerCreateDirectory, registerCreatePackage, registerCreateWorkspace, registerDeleteDirectory, registerDeleteFile, registerDeletePackage, registerDownloadFileFromDirectory, registerDownloadPackageFiles, registerFinalizePackage, registerFinalizeUndisclosedPackage, registerGenerateTrustedDeviceKeypair, registerGetActivityLog, registerGetDirectory, registerGetEnterpriseInfo, registerGetFileInformation, registerGetPackageInformation, registerGetPackageInformationFromLink, registerGetPackageKeycode, registerGetPackageMessage, registerGetReceivedPackages, registerGetRecipient, registerGetSentPackages, registerGetWorkspaces, registerListDownloadedFiles, registerMoveDirectory, registerReadDownloadedFile, registerRemoveRecipient, registerRenameDirectory, registerSetRecipientPhoneNumber, registerUpdateFile, registerUpdatePackage, registerUpdateRecipientRole, registerUploadFile, registerVerifyCredentials, };
|
|
43
|
+
export interface RegisterToolsOptions {
|
|
44
|
+
keyStore?: KeyStore;
|
|
45
|
+
}
|
|
46
|
+
export declare function registerTools(mcp: McpServer, ctx: ToolContext, options?: RegisterToolsOptions): void;
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { createPackageSecretCache, } from "../store/packageSecretCache.js";
|
|
2
|
+
import { registerAddPackageMessage } from "./stdio/addPackageMessage.js";
|
|
3
|
+
import { registerAddRecipient } from "./stdio/addRecipient.js";
|
|
4
|
+
import { registerAddRecipientsBulk } from "./stdio/addRecipientsBulk.js";
|
|
5
|
+
import { registerAddRecipientWithSms } from "./stdio/addRecipientWithSms.js";
|
|
6
|
+
import { registerCreateDirectory } from "./createDirectory.js";
|
|
7
|
+
import { registerCreatePackage } from "./stdio/createPackage.js";
|
|
8
|
+
import { registerCreateWorkspace } from "./stdio/createWorkspace.js";
|
|
9
|
+
import { registerDeleteDirectory } from "./deleteDirectory.js";
|
|
10
|
+
import { registerDeleteFile } from "./deleteFile.js";
|
|
11
|
+
import { registerDeletePackage } from "./stdio/deletePackage.js";
|
|
12
|
+
import { registerDownloadFileFromDirectory } from "./stdio/downloadFileFromDirectory.js";
|
|
13
|
+
import { registerDownloadPackageFiles } from "./stdio/downloadPackageFiles.js";
|
|
14
|
+
import { registerFinalizePackage } from "./stdio/finalizePackage.js";
|
|
15
|
+
import { registerFinalizeUndisclosedPackage } from "./stdio/finalizeUndisclosedPackage.js";
|
|
16
|
+
import { registerGenerateTrustedDeviceKeypair } from "./stdio/generateTrustedDeviceKeypair.js";
|
|
17
|
+
import { registerGetActivityLog } from "./getActivityLog.js";
|
|
18
|
+
import { registerGetDirectory } from "./getDirectory.js";
|
|
19
|
+
import { registerGetEnterpriseInfo } from "./getEnterpriseInfo.js";
|
|
20
|
+
import { registerGetFileInformation } from "./getFileInformation.js";
|
|
21
|
+
import { registerGetPackageInformation } from "./getPackageInformation.js";
|
|
22
|
+
import { registerGetPackageInformationFromLink } from "./stdio/getPackageInformationFromLink.js";
|
|
23
|
+
import { registerGetPackageKeycode } from "./stdio/getPackageKeycode.js";
|
|
24
|
+
import { registerGetPackageMessage } from "./stdio/getPackageMessage.js";
|
|
25
|
+
import { registerGetReceivedPackages } from "./getReceivedPackages.js";
|
|
26
|
+
import { registerGetRecipient } from "./getRecipient.js";
|
|
27
|
+
import { registerGetSentPackages } from "./getSentPackages.js";
|
|
28
|
+
import { registerGetWorkspaces } from "./getWorkspaces.js";
|
|
29
|
+
import { registerListDownloadedFiles } from "./stdio/listDownloadedFiles.js";
|
|
30
|
+
import { registerMoveDirectory } from "./moveDirectory.js";
|
|
31
|
+
import { registerReadDownloadedFile } from "./stdio/readDownloadedFile.js";
|
|
32
|
+
import { registerRemoveRecipient } from "./removeRecipient.js";
|
|
33
|
+
import { registerRenameDirectory } from "./renameDirectory.js";
|
|
34
|
+
import { registerSetRecipientPhoneNumber } from "./setRecipientPhoneNumber.js";
|
|
35
|
+
import { registerUpdateFile } from "./updateFile.js";
|
|
36
|
+
import { registerUpdatePackage } from "./updatePackage.js";
|
|
37
|
+
import { registerUpdateRecipientRole } from "./updateRecipientRole.js";
|
|
38
|
+
import { registerUploadFile } from "./stdio/uploadFile.js";
|
|
39
|
+
import { registerVerifyCredentials } from "./verifyCredentials.js";
|
|
40
|
+
export { registerAddPackageMessage, registerAddRecipient, registerAddRecipientsBulk, registerAddRecipientWithSms, registerCreateDirectory, registerCreatePackage, registerCreateWorkspace, registerDeleteDirectory, registerDeleteFile, registerDeletePackage, registerDownloadFileFromDirectory, registerDownloadPackageFiles, registerFinalizePackage, registerFinalizeUndisclosedPackage, registerGenerateTrustedDeviceKeypair, registerGetActivityLog, registerGetDirectory, registerGetEnterpriseInfo, registerGetFileInformation, registerGetPackageInformation, registerGetPackageInformationFromLink, registerGetPackageKeycode, registerGetPackageMessage, registerGetReceivedPackages, registerGetRecipient, registerGetSentPackages, registerGetWorkspaces, registerListDownloadedFiles, registerMoveDirectory, registerReadDownloadedFile, registerRemoveRecipient, registerRenameDirectory, registerSetRecipientPhoneNumber, registerUpdateFile, registerUpdatePackage, registerUpdateRecipientRole, registerUploadFile, registerVerifyCredentials, };
|
|
41
|
+
export function registerTools(mcp, ctx, options = {}) {
|
|
42
|
+
const sessionCaches = new Map();
|
|
43
|
+
const cacheFor = (extra) => {
|
|
44
|
+
const key = extra.sessionId ?? "_default";
|
|
45
|
+
let cache = sessionCaches.get(key);
|
|
46
|
+
if (!cache) {
|
|
47
|
+
cache = createPackageSecretCache();
|
|
48
|
+
sessionCaches.set(key, cache);
|
|
49
|
+
}
|
|
50
|
+
return cache;
|
|
51
|
+
};
|
|
52
|
+
registerVerifyCredentials(mcp, ctx);
|
|
53
|
+
registerGetEnterpriseInfo(mcp, ctx);
|
|
54
|
+
registerGetReceivedPackages(mcp, ctx);
|
|
55
|
+
registerGetSentPackages(mcp, ctx);
|
|
56
|
+
registerGetWorkspaces(mcp, ctx);
|
|
57
|
+
registerGetPackageInformation(mcp, ctx);
|
|
58
|
+
registerGetActivityLog(mcp, ctx);
|
|
59
|
+
registerGetFileInformation(mcp, ctx);
|
|
60
|
+
registerGetRecipient(mcp, ctx);
|
|
61
|
+
registerGetDirectory(mcp, ctx);
|
|
62
|
+
registerSetRecipientPhoneNumber(mcp, ctx);
|
|
63
|
+
registerUpdateRecipientRole(mcp, ctx);
|
|
64
|
+
registerRemoveRecipient(mcp, ctx);
|
|
65
|
+
registerUpdatePackage(mcp, ctx);
|
|
66
|
+
registerDeleteFile(mcp, ctx);
|
|
67
|
+
registerUpdateFile(mcp, ctx);
|
|
68
|
+
registerCreateDirectory(mcp, ctx);
|
|
69
|
+
registerRenameDirectory(mcp, ctx);
|
|
70
|
+
registerMoveDirectory(mcp, ctx);
|
|
71
|
+
registerDeleteDirectory(mcp, ctx);
|
|
72
|
+
registerListDownloadedFiles(mcp, ctx);
|
|
73
|
+
registerReadDownloadedFile(mcp, ctx);
|
|
74
|
+
registerGetPackageInformationFromLink(mcp, ctx, cacheFor);
|
|
75
|
+
registerGetPackageMessage(mcp, ctx, cacheFor);
|
|
76
|
+
registerDownloadPackageFiles(mcp, ctx, cacheFor);
|
|
77
|
+
registerDownloadFileFromDirectory(mcp, ctx, cacheFor);
|
|
78
|
+
registerCreatePackage(mcp, ctx, cacheFor);
|
|
79
|
+
registerCreateWorkspace(mcp, ctx, cacheFor);
|
|
80
|
+
registerUploadFile(mcp, ctx, cacheFor);
|
|
81
|
+
registerAddPackageMessage(mcp, ctx, cacheFor);
|
|
82
|
+
registerFinalizePackage(mcp, ctx, cacheFor);
|
|
83
|
+
registerFinalizeUndisclosedPackage(mcp, ctx, cacheFor);
|
|
84
|
+
registerAddRecipient(mcp, ctx, cacheFor);
|
|
85
|
+
registerAddRecipientsBulk(mcp, ctx, cacheFor);
|
|
86
|
+
registerAddRecipientWithSms(mcp, ctx, cacheFor);
|
|
87
|
+
registerDeletePackage(mcp, ctx, cacheFor);
|
|
88
|
+
if (options.keyStore) {
|
|
89
|
+
registerGenerateTrustedDeviceKeypair(mcp, ctx, options.keyStore);
|
|
90
|
+
registerGetPackageKeycode(mcp, ctx, cacheFor, options.keyStore);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import type { ToolContext, ToolExtra } from "../context.js";
|
|
4
|
+
export declare function handleMoveDirectory(args: {
|
|
5
|
+
package_id: string;
|
|
6
|
+
source_directory_id: string;
|
|
7
|
+
target_directory_id: string;
|
|
8
|
+
}, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
|
|
9
|
+
export declare function registerMoveDirectory(mcp: McpServer, ctx: ToolContext): void;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { jsonResult } from "../jsonResult.js";
|
|
3
|
+
import { runTool } from "../runTool.js";
|
|
4
|
+
import { safeHandler } from "../safeHandler.js";
|
|
5
|
+
import { moveDirectory } from "../sdk/sdkPromise.js";
|
|
6
|
+
export async function handleMoveDirectory(args, extra, ctx) {
|
|
7
|
+
return runTool("move_directory", "Failed to move directory", async () => {
|
|
8
|
+
const client = await ctx.getClient(extra);
|
|
9
|
+
await moveDirectory(client, args.package_id, args.source_directory_id, args.target_directory_id);
|
|
10
|
+
return jsonResult({
|
|
11
|
+
status: "success",
|
|
12
|
+
package_id: args.package_id,
|
|
13
|
+
source_directory_id: args.source_directory_id,
|
|
14
|
+
target_directory_id: args.target_directory_id,
|
|
15
|
+
});
|
|
16
|
+
});
|
|
17
|
+
}
|
|
18
|
+
export function registerMoveDirectory(mcp, ctx) {
|
|
19
|
+
mcp.registerTool("move_directory", {
|
|
20
|
+
title: "Move Directory",
|
|
21
|
+
description: "Move a directory to a new parent inside the same workspace " +
|
|
22
|
+
"package. Both directories must belong to the same package.",
|
|
23
|
+
inputSchema: {
|
|
24
|
+
package_id: z.string().describe("The unique SendSafely package ID."),
|
|
25
|
+
source_directory_id: z
|
|
26
|
+
.string()
|
|
27
|
+
.describe("The directory ID to move."),
|
|
28
|
+
target_directory_id: z
|
|
29
|
+
.string()
|
|
30
|
+
.describe("The destination parent directory ID."),
|
|
31
|
+
},
|
|
32
|
+
annotations: {
|
|
33
|
+
readOnlyHint: false,
|
|
34
|
+
destructiveHint: false,
|
|
35
|
+
idempotentHint: true,
|
|
36
|
+
openWorldHint: true,
|
|
37
|
+
},
|
|
38
|
+
}, safeHandler("move_directory", (args, extra) => handleMoveDirectory(args, extra, ctx)));
|
|
39
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import type { ToolContext, ToolExtra } from "../context.js";
|
|
4
|
+
export declare function handleRemoveRecipient(args: {
|
|
5
|
+
package_id: string;
|
|
6
|
+
recipient_id: string;
|
|
7
|
+
}, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
|
|
8
|
+
export declare function registerRemoveRecipient(mcp: McpServer, ctx: ToolContext): void;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { jsonResult } from "../jsonResult.js";
|
|
3
|
+
import { runTool } from "../runTool.js";
|
|
4
|
+
import { safeHandler } from "../safeHandler.js";
|
|
5
|
+
import { removeRecipient } from "../sdk/sdkPromise.js";
|
|
6
|
+
export async function handleRemoveRecipient(args, extra, ctx) {
|
|
7
|
+
return runTool("remove_recipient", "Failed to remove recipient", async () => {
|
|
8
|
+
const client = await ctx.getClient(extra);
|
|
9
|
+
await removeRecipient(client, args.package_id, args.recipient_id);
|
|
10
|
+
return jsonResult({
|
|
11
|
+
status: "success",
|
|
12
|
+
package_id: args.package_id,
|
|
13
|
+
recipient_id: args.recipient_id,
|
|
14
|
+
});
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
export function registerRemoveRecipient(mcp, ctx) {
|
|
18
|
+
mcp.registerTool("remove_recipient", {
|
|
19
|
+
title: "Remove Recipient",
|
|
20
|
+
description: "Remove a recipient from a SendSafely package by recipient ID. " +
|
|
21
|
+
"On an unfinalized package this is silent. On a finalized package " +
|
|
22
|
+
"the recipient loses access on their next request.",
|
|
23
|
+
inputSchema: {
|
|
24
|
+
package_id: z.string().describe("The unique SendSafely package ID."),
|
|
25
|
+
recipient_id: z.string().describe("The unique recipient ID to remove."),
|
|
26
|
+
},
|
|
27
|
+
annotations: {
|
|
28
|
+
readOnlyHint: false,
|
|
29
|
+
destructiveHint: true,
|
|
30
|
+
idempotentHint: true,
|
|
31
|
+
openWorldHint: true,
|
|
32
|
+
},
|
|
33
|
+
}, safeHandler("remove_recipient", (args, extra) => handleRemoveRecipient(args, extra, ctx)));
|
|
34
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import type { ToolContext, ToolExtra } from "../context.js";
|
|
4
|
+
export declare function handleRenameDirectory(args: {
|
|
5
|
+
package_id: string;
|
|
6
|
+
directory_id: string;
|
|
7
|
+
directory_name: string;
|
|
8
|
+
}, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
|
|
9
|
+
export declare function registerRenameDirectory(mcp: McpServer, ctx: ToolContext): void;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { jsonResult } from "../jsonResult.js";
|
|
3
|
+
import { runTool } from "../runTool.js";
|
|
4
|
+
import { safeHandler } from "../safeHandler.js";
|
|
5
|
+
import { renameDirectory } from "../sdk/sdkPromise.js";
|
|
6
|
+
export async function handleRenameDirectory(args, extra, ctx) {
|
|
7
|
+
return runTool("rename_directory", "Failed to rename directory", async () => {
|
|
8
|
+
const client = await ctx.getClient(extra);
|
|
9
|
+
await renameDirectory(client, args.package_id, args.directory_id, args.directory_name);
|
|
10
|
+
return jsonResult({
|
|
11
|
+
status: "success",
|
|
12
|
+
package_id: args.package_id,
|
|
13
|
+
directory_id: args.directory_id,
|
|
14
|
+
directory_name: args.directory_name,
|
|
15
|
+
});
|
|
16
|
+
});
|
|
17
|
+
}
|
|
18
|
+
export function registerRenameDirectory(mcp, ctx) {
|
|
19
|
+
mcp.registerTool("rename_directory", {
|
|
20
|
+
title: "Rename Directory",
|
|
21
|
+
description: "Rename a directory inside a workspace package.",
|
|
22
|
+
inputSchema: {
|
|
23
|
+
package_id: z.string().describe("The unique SendSafely package ID."),
|
|
24
|
+
directory_id: z.string().describe("The directory ID to rename."),
|
|
25
|
+
directory_name: z.string().describe("New name for the directory."),
|
|
26
|
+
},
|
|
27
|
+
annotations: {
|
|
28
|
+
readOnlyHint: false,
|
|
29
|
+
destructiveHint: false,
|
|
30
|
+
idempotentHint: true,
|
|
31
|
+
openWorldHint: true,
|
|
32
|
+
},
|
|
33
|
+
}, safeHandler("rename_directory", (args, extra) => handleRenameDirectory(args, extra, ctx)));
|
|
34
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import type { ToolContext, ToolExtra } from "../context.js";
|
|
4
|
+
export declare function handleSetRecipientPhoneNumber(args: {
|
|
5
|
+
package_id: string;
|
|
6
|
+
recipient_id: string;
|
|
7
|
+
phone_number: string;
|
|
8
|
+
country_code: string;
|
|
9
|
+
}, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
|
|
10
|
+
export declare function registerSetRecipientPhoneNumber(mcp: McpServer, ctx: ToolContext): void;
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { jsonResult } from "../jsonResult.js";
|
|
3
|
+
import { runTool } from "../runTool.js";
|
|
4
|
+
import { safeHandler } from "../safeHandler.js";
|
|
5
|
+
import { addRecipientPhonenumber } from "../sdk/sdkPromise.js";
|
|
6
|
+
export async function handleSetRecipientPhoneNumber(args, extra, ctx) {
|
|
7
|
+
return runTool("set_recipient_phone_number", "Failed to set recipient phone number", async () => {
|
|
8
|
+
const client = await ctx.getClient(extra);
|
|
9
|
+
await addRecipientPhonenumber(client, args.package_id, args.recipient_id, args.phone_number, args.country_code);
|
|
10
|
+
return jsonResult({
|
|
11
|
+
status: "success",
|
|
12
|
+
package_id: args.package_id,
|
|
13
|
+
recipient_id: args.recipient_id,
|
|
14
|
+
});
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
export function registerSetRecipientPhoneNumber(mcp, ctx) {
|
|
18
|
+
mcp.registerTool("set_recipient_phone_number", {
|
|
19
|
+
title: "Set Recipient Phone Number",
|
|
20
|
+
description: "Attach or update the phone number used for SMS verification on an " +
|
|
21
|
+
"existing recipient. No outbound SMS is sent at this point — it " +
|
|
22
|
+
"only configures the contact info.",
|
|
23
|
+
inputSchema: {
|
|
24
|
+
package_id: z.string().describe("The unique SendSafely package ID."),
|
|
25
|
+
recipient_id: z.string().describe("The unique recipient ID."),
|
|
26
|
+
phone_number: z
|
|
27
|
+
.string()
|
|
28
|
+
.describe("Phone number for SMS verification."),
|
|
29
|
+
country_code: z
|
|
30
|
+
.string()
|
|
31
|
+
.describe("Country code for the phone number (e.g. '1' for US)."),
|
|
32
|
+
},
|
|
33
|
+
annotations: {
|
|
34
|
+
readOnlyHint: false,
|
|
35
|
+
destructiveHint: false,
|
|
36
|
+
idempotentHint: true,
|
|
37
|
+
openWorldHint: true,
|
|
38
|
+
},
|
|
39
|
+
}, safeHandler("set_recipient_phone_number", (args, extra) => handleSetRecipientPhoneNumber(args, extra, ctx)));
|
|
40
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import type { ToolContext, ToolExtra } from "../../context.js";
|
|
4
|
+
import { type CacheFor } from "../../store/packageSecretCache.js";
|
|
5
|
+
export declare function handleAddPackageMessage(args: {
|
|
6
|
+
package_id: string;
|
|
7
|
+
message: string;
|
|
8
|
+
}, extra: ToolExtra, ctx: ToolContext, cacheFor: CacheFor): Promise<CallToolResult>;
|
|
9
|
+
export declare function registerAddPackageMessage(mcp: McpServer, ctx: ToolContext, cacheFor: CacheFor): void;
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { jsonResult } from "../../jsonResult.js";
|
|
3
|
+
import { MissingPackageSecretsError, } from "../../store/packageSecretCache.js";
|
|
4
|
+
import { runTool } from "../../runTool.js";
|
|
5
|
+
import { safeHandler } from "../../safeHandler.js";
|
|
6
|
+
import { encryptAndUploadMessage } from "../../sdk/sdkPromise.js";
|
|
7
|
+
export async function handleAddPackageMessage(args, extra, ctx, cacheFor) {
|
|
8
|
+
return runTool("add_package_message", "Failed to attach message", async () => {
|
|
9
|
+
const client = await ctx.getClient(extra);
|
|
10
|
+
const secrets = cacheFor(extra).get(args.package_id);
|
|
11
|
+
if (!secrets)
|
|
12
|
+
throw new MissingPackageSecretsError(args.package_id);
|
|
13
|
+
await encryptAndUploadMessage(client, args.package_id, secrets.keyCode, secrets.serverSecret, args.message);
|
|
14
|
+
return jsonResult({ status: "success", package_id: args.package_id });
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
export function registerAddPackageMessage(mcp, ctx, cacheFor) {
|
|
18
|
+
mcp.registerTool("add_package_message", {
|
|
19
|
+
title: "Attach Secure Message",
|
|
20
|
+
description: "Encrypt and attach a secure text message to an unfinalized " +
|
|
21
|
+
"SendSafely package. The package's secret material must be in the " +
|
|
22
|
+
"server-side cache — typically because create_package was called " +
|
|
23
|
+
"to author it, or because get_package_keycode unlocked it via a " +
|
|
24
|
+
"registered Trusted Device. The message is delivered alongside " +
|
|
25
|
+
"any attached files when finalize_package runs.",
|
|
26
|
+
inputSchema: {
|
|
27
|
+
package_id: z.string().describe("The unique SendSafely package ID."),
|
|
28
|
+
message: z.string().describe("The message text to encrypt and attach."),
|
|
29
|
+
},
|
|
30
|
+
annotations: {
|
|
31
|
+
readOnlyHint: false,
|
|
32
|
+
destructiveHint: false,
|
|
33
|
+
idempotentHint: false,
|
|
34
|
+
openWorldHint: true,
|
|
35
|
+
},
|
|
36
|
+
}, safeHandler("add_package_message", (args, extra) => handleAddPackageMessage(args, extra, ctx, cacheFor)));
|
|
37
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import type { ToolContext, ToolExtra } from "../../context.js";
|
|
4
|
+
import { type CacheFor } from "../../store/packageSecretCache.js";
|
|
5
|
+
export declare function handleAddRecipient(args: {
|
|
6
|
+
package_id: string;
|
|
7
|
+
email: string;
|
|
8
|
+
}, extra: ToolExtra, ctx: ToolContext, cacheFor: CacheFor): Promise<CallToolResult>;
|
|
9
|
+
export declare function registerAddRecipient(mcp: McpServer, ctx: ToolContext, cacheFor: CacheFor): void;
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { jsonError, jsonResult } from "../../jsonResult.js";
|
|
3
|
+
import { MissingPackageSecretsError, } from "../../store/packageSecretCache.js";
|
|
4
|
+
import { buildShareLinkMessage, classifyRecipientAddContext, promptAndApplyWorkspaceRole, tryBuildKeyedLink, } from "../../recipientAddContext.js";
|
|
5
|
+
import { runTool } from "../../runTool.js";
|
|
6
|
+
import { safeHandler } from "../../safeHandler.js";
|
|
7
|
+
import { addRecipient, packageInformation } from "../../sdk/sdkPromise.js";
|
|
8
|
+
export async function handleAddRecipient(args, extra, ctx, cacheFor) {
|
|
9
|
+
return runTool("add_recipient", "Failed to add recipient", async () => {
|
|
10
|
+
const client = await ctx.getClient(extra);
|
|
11
|
+
const secrets = cacheFor(extra).get(args.package_id);
|
|
12
|
+
if (!secrets)
|
|
13
|
+
throw new MissingPackageSecretsError(args.package_id);
|
|
14
|
+
const info = await packageInformation(client, args.package_id);
|
|
15
|
+
const context = classifyRecipientAddContext(info);
|
|
16
|
+
if (context.kind === "block_deleted") {
|
|
17
|
+
return jsonError(`Cannot add recipient: package '${args.package_id}' has been ` +
|
|
18
|
+
`deleted (state ${context.state}). Inform the user that the ` +
|
|
19
|
+
"package no longer exists and recipients cannot be added.");
|
|
20
|
+
}
|
|
21
|
+
const recipient = await addRecipient(client, args.package_id, args.email, secrets.keyCode);
|
|
22
|
+
if (context.kind === "unfinalized_or_unknown") {
|
|
23
|
+
return jsonResult({
|
|
24
|
+
status: "success",
|
|
25
|
+
package_id: args.package_id,
|
|
26
|
+
recipient,
|
|
27
|
+
message: `Recipient ${args.email} added. Recipients are notified when ` +
|
|
28
|
+
"finalize_package runs.",
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
const rolePrompt = context.kind === "active_workspace"
|
|
32
|
+
? await promptAndApplyWorkspaceRole(ctx, client, args.package_id, [{ recipient_id: recipient.recipientId, email: recipient.email }], `Collaborator ${args.email}`)
|
|
33
|
+
: undefined;
|
|
34
|
+
const secureLink = tryBuildKeyedLink(client, secrets.keyCode, secrets.packageCode);
|
|
35
|
+
if (!secureLink) {
|
|
36
|
+
const linkUnavailable = "Cache entry has no packageCode. Tell the user to fetch the " +
|
|
37
|
+
"keyed link via get_package_information_from_link or " +
|
|
38
|
+
"get_package_keycode and share it with the new recipient.";
|
|
39
|
+
const baseMessage = `Recipient ${args.email} added. SendSafely will NOT auto-notify ` +
|
|
40
|
+
"this recipient, but secure_link could not be reconstructed " +
|
|
41
|
+
"from the cache (see secure_link_unavailable).";
|
|
42
|
+
return jsonResult({
|
|
43
|
+
status: "success",
|
|
44
|
+
package_id: args.package_id,
|
|
45
|
+
recipient,
|
|
46
|
+
package_type: info.packageType,
|
|
47
|
+
package_state: info.state,
|
|
48
|
+
secure_link_unavailable: linkUnavailable,
|
|
49
|
+
...(rolePrompt ? { role_prompt: rolePrompt } : {}),
|
|
50
|
+
message: rolePrompt?.message
|
|
51
|
+
? `${baseMessage}\n\n${rolePrompt.message}`
|
|
52
|
+
: baseMessage,
|
|
53
|
+
});
|
|
54
|
+
}
|
|
55
|
+
const linkMessage = buildShareLinkMessage(context, `Recipient ${args.email}`, secureLink);
|
|
56
|
+
const message = rolePrompt?.message
|
|
57
|
+
? `${linkMessage}\n\n${rolePrompt.message}`
|
|
58
|
+
: linkMessage;
|
|
59
|
+
return jsonResult({
|
|
60
|
+
status: "success",
|
|
61
|
+
package_id: args.package_id,
|
|
62
|
+
recipient,
|
|
63
|
+
package_type: info.packageType,
|
|
64
|
+
package_state: info.state,
|
|
65
|
+
secure_link: secureLink,
|
|
66
|
+
...(rolePrompt ? { role_prompt: rolePrompt } : {}),
|
|
67
|
+
message,
|
|
68
|
+
});
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
export function registerAddRecipient(mcp, ctx, cacheFor) {
|
|
72
|
+
mcp.registerTool("add_recipient", {
|
|
73
|
+
title: "Add Recipient",
|
|
74
|
+
description: "Add a recipient (by email) to a SendSafely package. The package's " +
|
|
75
|
+
"secret material must be in the server-side cache (populated by " +
|
|
76
|
+
"create_package / create_workspace, get_package_information_from_link, " +
|
|
77
|
+
"or get_package_keycode via a registered Trusted Device). " +
|
|
78
|
+
"Behavior depends on the package's current state and type — the " +
|
|
79
|
+
"tool inspects the package automatically and adjusts: " +
|
|
80
|
+
"(1) DELETED package → add is refused; tell the user the package " +
|
|
81
|
+
"is gone. " +
|
|
82
|
+
"(2) Workspace (any non-deleted state) → add proceeds; response " +
|
|
83
|
+
"includes secure_link + a reminder. You MUST surface the link and " +
|
|
84
|
+
"tell the user to share it with the new collaborator, since " +
|
|
85
|
+
"SendSafely never auto-notifies workspace collaborators. The tool " +
|
|
86
|
+
"also prompts the user to pick the collaborator's role (default " +
|
|
87
|
+
"VIEWER; alternatives CONTRIBUTOR or MANAGER); the chosen role is " +
|
|
88
|
+
"applied via update_recipient_role automatically. " +
|
|
89
|
+
"(3) Already-finalized Transfer / Dropzone (PACKAGE_STATE_ACTIVE_*) " +
|
|
90
|
+
"→ same as workspaces. Surface secure_link and tell the user to " +
|
|
91
|
+
"share it; SendSafely does not auto-notify recipients added after " +
|
|
92
|
+
"finalize. " +
|
|
93
|
+
"(4) Expired Transfer / Dropzone (PACKAGE_STATE_EXPIRED_*) → add " +
|
|
94
|
+
"proceeds, but the response warns the user the package needs to " +
|
|
95
|
+
"be un-expired before the new recipient can access it. " +
|
|
96
|
+
"(5) Unfinalized Transfer / Dropzone being assembled → no reminder; " +
|
|
97
|
+
"finalize_package will handle notifications.",
|
|
98
|
+
inputSchema: {
|
|
99
|
+
package_id: z.string().describe("The unique SendSafely package ID."),
|
|
100
|
+
email: z.string().describe("Email address of the recipient to add."),
|
|
101
|
+
},
|
|
102
|
+
annotations: {
|
|
103
|
+
readOnlyHint: false,
|
|
104
|
+
destructiveHint: false,
|
|
105
|
+
idempotentHint: false,
|
|
106
|
+
openWorldHint: true,
|
|
107
|
+
},
|
|
108
|
+
}, safeHandler("add_recipient", (args, extra) => handleAddRecipient(args, extra, ctx, cacheFor)));
|
|
109
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
3
|
+
import type { ToolContext, ToolExtra } from "../../context.js";
|
|
4
|
+
import { type CacheFor } from "../../store/packageSecretCache.js";
|
|
5
|
+
export declare function handleAddRecipientWithSms(args: {
|
|
6
|
+
package_id: string;
|
|
7
|
+
email: string;
|
|
8
|
+
phone_number: string;
|
|
9
|
+
country_code: string;
|
|
10
|
+
}, extra: ToolExtra, ctx: ToolContext, cacheFor: CacheFor): Promise<CallToolResult>;
|
|
11
|
+
export declare function registerAddRecipientWithSms(mcp: McpServer, ctx: ToolContext, cacheFor: CacheFor): void;
|