@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.
Files changed (134) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +22 -0
  3. package/README.md +390 -2
  4. package/dist/context.d.ts +2 -0
  5. package/dist/context.js +21 -0
  6. package/dist/credentials.d.ts +7 -0
  7. package/dist/credentials.js +59 -0
  8. package/dist/server.d.ts +2 -0
  9. package/dist/server.js +47 -0
  10. package/dist/setupCredentials.d.ts +2 -0
  11. package/dist/setupCredentials.js +151 -0
  12. package/dist/trustedDeviceKeyStore.d.ts +3 -0
  13. package/dist/trustedDeviceKeyStore.js +34 -0
  14. package/node_modules/@sendsafely/mcp-tools-core/LICENSE +201 -0
  15. package/node_modules/@sendsafely/mcp-tools-core/dist/approval.d.ts +51 -0
  16. package/node_modules/@sendsafely/mcp-tools-core/dist/approval.js +148 -0
  17. package/node_modules/@sendsafely/mcp-tools-core/dist/constants.d.ts +5 -0
  18. package/node_modules/@sendsafely/mcp-tools-core/dist/constants.js +8 -0
  19. package/node_modules/@sendsafely/mcp-tools-core/dist/context.d.ts +25 -0
  20. package/node_modules/@sendsafely/mcp-tools-core/dist/context.js +16 -0
  21. package/node_modules/@sendsafely/mcp-tools-core/dist/index.d.ts +18 -0
  22. package/node_modules/@sendsafely/mcp-tools-core/dist/index.js +17 -0
  23. package/node_modules/@sendsafely/mcp-tools-core/dist/instructions.d.ts +1 -0
  24. package/node_modules/@sendsafely/mcp-tools-core/dist/instructions.js +17 -0
  25. package/node_modules/@sendsafely/mcp-tools-core/dist/jsonResult.d.ts +3 -0
  26. package/node_modules/@sendsafely/mcp-tools-core/dist/jsonResult.js +15 -0
  27. package/node_modules/@sendsafely/mcp-tools-core/dist/recipientAddContext.d.ts +42 -0
  28. package/node_modules/@sendsafely/mcp-tools-core/dist/recipientAddContext.js +182 -0
  29. package/node_modules/@sendsafely/mcp-tools-core/dist/runTool.d.ts +2 -0
  30. package/node_modules/@sendsafely/mcp-tools-core/dist/runTool.js +22 -0
  31. package/node_modules/@sendsafely/mcp-tools-core/dist/safeHandler.d.ts +17 -0
  32. package/node_modules/@sendsafely/mcp-tools-core/dist/safeHandler.js +32 -0
  33. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/clientFactory.d.ts +17 -0
  34. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/clientFactory.js +29 -0
  35. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/oauthError.d.ts +9 -0
  36. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/oauthError.js +34 -0
  37. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/sdkPromise.d.ts +53 -0
  38. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/sdkPromise.js +462 -0
  39. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/signedFetch.d.ts +6 -0
  40. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/signedFetch.js +28 -0
  41. package/node_modules/@sendsafely/mcp-tools-core/dist/store/keyStore.d.ts +6 -0
  42. package/node_modules/@sendsafely/mcp-tools-core/dist/store/keyStore.js +1 -0
  43. package/node_modules/@sendsafely/mcp-tools-core/dist/store/packageSecretCache.d.ts +18 -0
  44. package/node_modules/@sendsafely/mcp-tools-core/dist/store/packageSecretCache.js +39 -0
  45. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/createDirectory.d.ts +9 -0
  46. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/createDirectory.js +53 -0
  47. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteDirectory.d.ts +10 -0
  48. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteDirectory.js +46 -0
  49. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteFile.d.ts +11 -0
  50. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteFile.js +53 -0
  51. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getActivityLog.d.ts +8 -0
  52. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getActivityLog.js +44 -0
  53. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getDirectory.d.ts +12 -0
  54. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getDirectory.js +51 -0
  55. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getEnterpriseInfo.d.ts +5 -0
  56. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getEnterpriseInfo.js +27 -0
  57. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getFileInformation.d.ts +9 -0
  58. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getFileInformation.js +34 -0
  59. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getPackageInformation.d.ts +7 -0
  60. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getPackageInformation.js +41 -0
  61. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getReceivedPackages.d.ts +5 -0
  62. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getReceivedPackages.js +54 -0
  63. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getRecipient.d.ts +8 -0
  64. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getRecipient.js +30 -0
  65. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getSentPackages.d.ts +7 -0
  66. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getSentPackages.js +84 -0
  67. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getWorkspaces.d.ts +5 -0
  68. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getWorkspaces.js +114 -0
  69. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/index.d.ts +46 -0
  70. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/index.js +92 -0
  71. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/moveDirectory.d.ts +9 -0
  72. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/moveDirectory.js +39 -0
  73. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/removeRecipient.d.ts +8 -0
  74. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/removeRecipient.js +34 -0
  75. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/renameDirectory.d.ts +9 -0
  76. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/renameDirectory.js +34 -0
  77. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/setRecipientPhoneNumber.d.ts +10 -0
  78. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/setRecipientPhoneNumber.js +40 -0
  79. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addPackageMessage.d.ts +9 -0
  80. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addPackageMessage.js +37 -0
  81. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipient.d.ts +9 -0
  82. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipient.js +109 -0
  83. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientWithSms.d.ts +11 -0
  84. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientWithSms.js +115 -0
  85. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientsBulk.d.ts +9 -0
  86. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientsBulk.js +110 -0
  87. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createPackage.d.ts +6 -0
  88. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createPackage.js +65 -0
  89. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createWorkspace.d.ts +10 -0
  90. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createWorkspace.js +107 -0
  91. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/deletePackage.d.ts +10 -0
  92. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/deletePackage.js +39 -0
  93. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadFileFromDirectory.d.ts +12 -0
  94. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadFileFromDirectory.js +91 -0
  95. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadPackageFiles.d.ts +12 -0
  96. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadPackageFiles.js +205 -0
  97. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizePackage.d.ts +9 -0
  98. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizePackage.js +111 -0
  99. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizeUndisclosedPackage.d.ts +9 -0
  100. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizeUndisclosedPackage.js +57 -0
  101. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/generateTrustedDeviceKeypair.d.ts +10 -0
  102. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/generateTrustedDeviceKeypair.js +75 -0
  103. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageInformationFromLink.d.ts +8 -0
  104. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageInformationFromLink.js +50 -0
  105. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageKeycode.d.ts +11 -0
  106. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageKeycode.js +120 -0
  107. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageMessage.d.ts +9 -0
  108. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageMessage.js +59 -0
  109. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/listDownloadedFiles.d.ts +5 -0
  110. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/listDownloadedFiles.js +71 -0
  111. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/readDownloadedFile.d.ts +8 -0
  112. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/readDownloadedFile.js +176 -0
  113. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/uploadFile.d.ts +12 -0
  114. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/uploadFile.js +69 -0
  115. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateFile.d.ts +9 -0
  116. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateFile.js +38 -0
  117. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updatePackage.d.ts +14 -0
  118. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updatePackage.js +122 -0
  119. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateRecipientRole.d.ts +9 -0
  120. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateRecipientRole.js +45 -0
  121. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/verifyCredentials.d.ts +5 -0
  122. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/verifyCredentials.js +27 -0
  123. package/node_modules/@sendsafely/mcp-tools-core/dist/types/sendsafely.d.ts +432 -0
  124. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageChecksum.d.ts +1 -0
  125. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageChecksum.js +7 -0
  126. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageDir.d.ts +8 -0
  127. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageDir.js +50 -0
  128. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageLink.d.ts +2 -0
  129. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageLink.js +4 -0
  130. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/sanitizeFilename.d.ts +4 -0
  131. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/sanitizeFilename.js +8 -0
  132. package/node_modules/@sendsafely/mcp-tools-core/package.json +40 -0
  133. package/npm-shrinkwrap.json +1632 -0
  134. package/package.json +58 -4
@@ -0,0 +1,53 @@
1
+ import { z } from "zod";
2
+ import { jsonError, jsonResult } from "../jsonResult.js";
3
+ import { runTool } from "../runTool.js";
4
+ import { safeHandler } from "../safeHandler.js";
5
+ import { createDirectory, packageInformation } from "../sdk/sdkPromise.js";
6
+ export async function handleCreateDirectory(args, extra, ctx) {
7
+ return runTool("create_directory", "Failed to create directory", async () => {
8
+ const client = await ctx.getClient(extra);
9
+ let parentDirectoryId = args.parent_directory_id;
10
+ if (!parentDirectoryId) {
11
+ const info = await packageInformation(client, args.package_id);
12
+ parentDirectoryId = info.rootDirectoryId;
13
+ if (!parentDirectoryId) {
14
+ return jsonError(`Could not determine workspace root for packageId '${args.package_id}'. ` +
15
+ "Pass parent_directory_id explicitly, or verify the package is a " +
16
+ "workspace (regular Transfer packages don't support directories).");
17
+ }
18
+ }
19
+ const result = await createDirectory(client, args.package_id, args.directory_name, parentDirectoryId);
20
+ return jsonResult({
21
+ status: "success",
22
+ package_id: args.package_id,
23
+ directory_name: args.directory_name,
24
+ parent_directory_id: parentDirectoryId,
25
+ result,
26
+ });
27
+ });
28
+ }
29
+ export function registerCreateDirectory(mcp, ctx) {
30
+ mcp.registerTool("create_directory", {
31
+ title: "Create Directory",
32
+ description: "Create a directory in a workspace package. Pass " +
33
+ "`parent_directory_id` to nest under an existing directory; " +
34
+ "omit it to create at the workspace root (the tool auto-resolves " +
35
+ "the workspace's root directory ID via an extra metadata lookup " +
36
+ "in that case). Workspace packages only — regular Transfer " +
37
+ "packages don't support directories.",
38
+ inputSchema: {
39
+ package_id: z.string().describe("The unique SendSafely workspace package ID."),
40
+ directory_name: z.string().describe("Name for the new directory."),
41
+ parent_directory_id: z
42
+ .string()
43
+ .optional()
44
+ .describe("Parent directory ID to nest under. Omit to create at the workspace root."),
45
+ },
46
+ annotations: {
47
+ readOnlyHint: false,
48
+ destructiveHint: false,
49
+ idempotentHint: false,
50
+ openWorldHint: true,
51
+ },
52
+ }, safeHandler("create_directory", (args, extra) => handleCreateDirectory(args, extra, ctx)));
53
+ }
@@ -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 interface DeleteDirectoryArgs {
5
+ package_id: string;
6
+ directory_id: string;
7
+ proceed_without_prompt?: boolean | undefined;
8
+ }
9
+ export declare function handleDeleteDirectory(args: DeleteDirectoryArgs, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
10
+ export declare function registerDeleteDirectory(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,46 @@
1
+ import { z } from "zod";
2
+ import { approvalGateError, CONSENT_FALLBACK_INSTRUCTIONS, proceedWithoutPromptSchema, } from "../approval.js";
3
+ import { jsonResult } from "../jsonResult.js";
4
+ import { runTool } from "../runTool.js";
5
+ import { safeHandler } from "../safeHandler.js";
6
+ import { deleteDirectory } from "../sdk/sdkPromise.js";
7
+ export async function handleDeleteDirectory(args, extra, ctx) {
8
+ return runTool("delete_directory", "Failed to delete directory", async () => {
9
+ const client = await ctx.getClient(extra);
10
+ const approval = await ctx.requireUserApproval(`Delete directory ${args.directory_id} from SendSafely package ` +
11
+ `${args.package_id}? Any files and subdirectories inside will also be ` +
12
+ "removed. This operation is irreversible.");
13
+ const denied = approvalGateError(approval, "permanently delete this directory and everything inside it", {
14
+ proceedWithoutPrompt: args.proceed_without_prompt,
15
+ });
16
+ if (denied)
17
+ return denied;
18
+ await deleteDirectory(client, args.package_id, args.directory_id);
19
+ return jsonResult({
20
+ status: "success",
21
+ package_id: args.package_id,
22
+ directory_id: args.directory_id,
23
+ });
24
+ });
25
+ }
26
+ export function registerDeleteDirectory(mcp, ctx) {
27
+ mcp.registerTool("delete_directory", {
28
+ title: "Delete Directory",
29
+ description: "Delete a directory from a workspace package. Files and " +
30
+ "subdirectories inside the deleted directory are also removed. " +
31
+ "Requires user approval — this operation is irreversible. " +
32
+ "Approval is collected via MCP elicitation. " +
33
+ CONSENT_FALLBACK_INSTRUCTIONS,
34
+ inputSchema: {
35
+ package_id: z.string().describe("The unique SendSafely package ID."),
36
+ directory_id: z.string().describe("The directory ID to delete."),
37
+ proceed_without_prompt: proceedWithoutPromptSchema,
38
+ },
39
+ annotations: {
40
+ readOnlyHint: false,
41
+ destructiveHint: true,
42
+ idempotentHint: true,
43
+ openWorldHint: true,
44
+ },
45
+ }, safeHandler("delete_directory", (args, extra) => handleDeleteDirectory(args, extra, ctx)));
46
+ }
@@ -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
+ export interface DeleteFileArgs {
5
+ package_id: string;
6
+ file_id: string;
7
+ directory_id?: string | undefined;
8
+ proceed_without_prompt?: boolean | undefined;
9
+ }
10
+ export declare function handleDeleteFile(args: DeleteFileArgs, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
11
+ export declare function registerDeleteFile(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,53 @@
1
+ import { z } from "zod";
2
+ import { approvalGateError, CONSENT_FALLBACK_INSTRUCTIONS, proceedWithoutPromptSchema, } from "../approval.js";
3
+ import { jsonResult } from "../jsonResult.js";
4
+ import { runTool } from "../runTool.js";
5
+ import { safeHandler } from "../safeHandler.js";
6
+ import { deleteFile } from "../sdk/sdkPromise.js";
7
+ export async function handleDeleteFile(args, extra, ctx) {
8
+ return runTool("delete_file", "Failed to delete file", async () => {
9
+ const approval = await ctx.requireUserApproval(`Delete file ${args.file_id} from SendSafely package ${args.package_id}? ` +
10
+ "This cannot be undone.");
11
+ const denied = approvalGateError(approval, "permanently delete this file from the package", {
12
+ proceedWithoutPrompt: args.proceed_without_prompt,
13
+ });
14
+ if (denied)
15
+ return denied;
16
+ const client = await ctx.getClient(extra);
17
+ await deleteFile(client, args.package_id, args.file_id, args.directory_id);
18
+ return jsonResult({
19
+ status: "success",
20
+ package_id: args.package_id,
21
+ file_id: args.file_id,
22
+ ...(args.directory_id ? { directory_id: args.directory_id } : {}),
23
+ });
24
+ });
25
+ }
26
+ export function registerDeleteFile(mcp, ctx) {
27
+ mcp.registerTool("delete_file", {
28
+ title: "Delete File",
29
+ description: "Permanently delete a file from a SendSafely package. Pass " +
30
+ "`directory_id` for files inside a workspace directory; omit for " +
31
+ "files at the package root. Works on WORKSPACE packages, and on " +
32
+ "TRANSFER/DROPZONE packages that haven't been sent yet. Files in a " +
33
+ "sent TRANSFER or DROPZONE package can't be deleted; delete the " +
34
+ "whole package instead. Requires user approval — irreversible. " +
35
+ "Approval is collected via MCP elicitation. " +
36
+ CONSENT_FALLBACK_INSTRUCTIONS,
37
+ inputSchema: {
38
+ package_id: z.string().describe("The unique SendSafely package ID."),
39
+ file_id: z.string().describe("The unique file ID."),
40
+ directory_id: z
41
+ .string()
42
+ .optional()
43
+ .describe("Workspace directory ID. Omit for root-level files."),
44
+ proceed_without_prompt: proceedWithoutPromptSchema,
45
+ },
46
+ annotations: {
47
+ readOnlyHint: false,
48
+ destructiveHint: true,
49
+ idempotentHint: true,
50
+ openWorldHint: true,
51
+ },
52
+ }, safeHandler("delete_file", (args, extra) => handleDeleteFile(args, extra, ctx)));
53
+ }
@@ -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 handleGetActivityLog(args: {
5
+ package_id: string;
6
+ row_index?: number | undefined;
7
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
8
+ export declare function registerGetActivityLog(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,44 @@
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 { getActivityLog } from "../sdk/sdkPromise.js";
6
+ export async function handleGetActivityLog(args, extra, ctx) {
7
+ return runTool("get_activity_log", "Failed to retrieve activity log", async () => {
8
+ const client = await ctx.getClient(extra);
9
+ const log = await getActivityLog(client, args.package_id, args.row_index ?? 0);
10
+ return jsonResult({ status: "success", activity_log: log });
11
+ });
12
+ }
13
+ export function registerGetActivityLog(mcp, ctx) {
14
+ mcp.registerTool("get_activity_log", {
15
+ title: "Get Package Activity Log",
16
+ description: "Retrieve the Activity Log for a SendSafely package — recipient " +
17
+ "downloads, views, and other access events, the same audit stream " +
18
+ "a Workspace owner sees in the SendSafely UI. Pagination is " +
19
+ "supported via `row_index`; pass 0 (default) to get the first " +
20
+ "page. Scope: this tool is meaningful only for WORKSPACE " +
21
+ "(virtual data room) packages — for TRANSFER and DROPZONE " +
22
+ "packages it returns an empty result, because their recipient " +
23
+ "download / view history lives on the package itself under " +
24
+ "`recipients[].confirmations` (surfaced to senders in the UI as " +
25
+ "the recipient's \"Recipient History\"; see get_package_information). " +
26
+ "Classify with `packageType` before choosing between this tool " +
27
+ "and get_package_information.",
28
+ inputSchema: {
29
+ package_id: z.string().describe("The unique SendSafely package ID."),
30
+ row_index: z
31
+ .number()
32
+ .int()
33
+ .nonnegative()
34
+ .optional()
35
+ .describe("Pagination offset; defaults to 0 (first page)."),
36
+ },
37
+ annotations: {
38
+ readOnlyHint: true,
39
+ destructiveHint: false,
40
+ idempotentHint: true,
41
+ openWorldHint: true,
42
+ },
43
+ }, safeHandler("get_activity_log", (args, extra) => handleGetActivityLog(args, extra, ctx)));
44
+ }
@@ -0,0 +1,12 @@
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 handleGetDirectory(args: {
5
+ package_id: string;
6
+ directory_id: string;
7
+ directory_index?: number | undefined;
8
+ file_index?: number | undefined;
9
+ sort_field?: string | undefined;
10
+ sort_order?: "asc" | "desc" | undefined;
11
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
12
+ export declare function registerGetDirectory(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,51 @@
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 { getDirectory } from "../sdk/sdkPromise.js";
6
+ export async function handleGetDirectory(args, extra, ctx) {
7
+ return runTool("get_directory", "Failed to retrieve directory listing", async () => {
8
+ const client = await ctx.getClient(extra);
9
+ const listing = await getDirectory(client, args.package_id, args.directory_id, args.directory_index ?? 0, args.file_index ?? 0, args.sort_field ?? "name", args.sort_order ?? "asc");
10
+ return jsonResult({ status: "success", directory: listing });
11
+ });
12
+ }
13
+ export function registerGetDirectory(mcp, ctx) {
14
+ mcp.registerTool("get_directory", {
15
+ title: "Get Directory Listing",
16
+ description: "List files and subdirectories in a workspace directory. " +
17
+ "`directory_index` and `file_index` are pagination offsets; " +
18
+ "`sort_field` and `sort_order` control ordering. Defaults are " +
19
+ "page 0, sort by name ascending.",
20
+ inputSchema: {
21
+ package_id: z.string().describe("The unique SendSafely package ID."),
22
+ directory_id: z.string().describe("The directory ID to list."),
23
+ directory_index: z
24
+ .number()
25
+ .int()
26
+ .nonnegative()
27
+ .optional()
28
+ .describe("Pagination offset for subdirectories."),
29
+ file_index: z
30
+ .number()
31
+ .int()
32
+ .nonnegative()
33
+ .optional()
34
+ .describe("Pagination offset for files."),
35
+ sort_field: z
36
+ .string()
37
+ .optional()
38
+ .describe("Field to sort by; defaults to 'name'."),
39
+ sort_order: z
40
+ .enum(["asc", "desc"])
41
+ .optional()
42
+ .describe("Sort direction; defaults to 'asc'."),
43
+ },
44
+ annotations: {
45
+ readOnlyHint: true,
46
+ destructiveHint: false,
47
+ idempotentHint: true,
48
+ openWorldHint: true,
49
+ },
50
+ }, safeHandler("get_directory", (args, extra) => handleGetDirectory(args, extra, ctx)));
51
+ }
@@ -0,0 +1,5 @@
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 handleGetEnterpriseInfo(_args: Record<string, never>, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
5
+ export declare function registerGetEnterpriseInfo(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,27 @@
1
+ import { jsonResult } from "../jsonResult.js";
2
+ import { runTool } from "../runTool.js";
3
+ import { safeHandler } from "../safeHandler.js";
4
+ import { enterpriseInfo } from "../sdk/sdkPromise.js";
5
+ export async function handleGetEnterpriseInfo(_args, extra, ctx) {
6
+ return runTool("get_enterprise_info", "Failed to retrieve enterprise info", async () => {
7
+ const client = await ctx.getClient(extra);
8
+ const info = await enterpriseInfo(client);
9
+ return jsonResult({ status: "success", enterprise_info: info });
10
+ });
11
+ }
12
+ export function registerGetEnterpriseInfo(mcp, ctx) {
13
+ mcp.registerTool("get_enterprise_info", {
14
+ title: "Get Enterprise Information",
15
+ description: "Retrieve organization-level information about the SendSafely " +
16
+ "enterprise account that the authenticated user belongs to. " +
17
+ "Returns host, system name, branding (header/link colors), and " +
18
+ "feature flags such as whether undisclosed recipients are allowed.",
19
+ inputSchema: {},
20
+ annotations: {
21
+ readOnlyHint: true,
22
+ destructiveHint: false,
23
+ idempotentHint: true,
24
+ openWorldHint: true,
25
+ },
26
+ }, safeHandler("get_enterprise_info", (args, extra) => handleGetEnterpriseInfo(args, extra, ctx)));
27
+ }
@@ -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 handleGetFileInformation(args: {
5
+ package_id: string;
6
+ file_id: string;
7
+ directory_id?: string | undefined;
8
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
9
+ export declare function registerGetFileInformation(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 { getFileInformation } from "../sdk/sdkPromise.js";
6
+ export async function handleGetFileInformation(args, extra, ctx) {
7
+ return runTool("get_file_information", "Failed to retrieve file information", async () => {
8
+ const client = await ctx.getClient(extra);
9
+ const info = await getFileInformation(client, args.package_id, args.directory_id, args.file_id);
10
+ return jsonResult({ status: "success", file_info: info });
11
+ });
12
+ }
13
+ export function registerGetFileInformation(mcp, ctx) {
14
+ mcp.registerTool("get_file_information", {
15
+ title: "Get File Information",
16
+ description: "Retrieve metadata for a single file inside a SendSafely package. " +
17
+ "Pass `directory_id` for files inside a workspace directory; omit " +
18
+ "for files at the package root.",
19
+ inputSchema: {
20
+ package_id: z.string().describe("The unique SendSafely package ID."),
21
+ file_id: z.string().describe("The unique file ID."),
22
+ directory_id: z
23
+ .string()
24
+ .optional()
25
+ .describe("Workspace directory ID; omit for root-level files."),
26
+ },
27
+ annotations: {
28
+ readOnlyHint: true,
29
+ destructiveHint: false,
30
+ idempotentHint: true,
31
+ openWorldHint: true,
32
+ },
33
+ }, safeHandler("get_file_information", (args, extra) => handleGetFileInformation(args, extra, ctx)));
34
+ }
@@ -0,0 +1,7 @@
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 handleGetPackageInformation(args: {
5
+ package_id: string;
6
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
7
+ export declare function registerGetPackageInformation(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,41 @@
1
+ import { z } from "zod";
2
+ import { jsonResult } from "../jsonResult.js";
3
+ import { stripPackageSecrets } from "../store/packageSecretCache.js";
4
+ import { runTool } from "../runTool.js";
5
+ import { safeHandler } from "../safeHandler.js";
6
+ import { packageInformation } from "../sdk/sdkPromise.js";
7
+ export async function handleGetPackageInformation(args, extra, ctx) {
8
+ return runTool("get_package_information", "Failed to retrieve package information", async () => {
9
+ const client = await ctx.getClient(extra);
10
+ const info = await packageInformation(client, args.package_id);
11
+ return jsonResult({
12
+ status: "success",
13
+ package_info: stripPackageSecrets(info),
14
+ });
15
+ });
16
+ }
17
+ export function registerGetPackageInformation(mcp, ctx) {
18
+ mcp.registerTool("get_package_information", {
19
+ title: "Get Package Information",
20
+ description: "Retrieve metadata for a SendSafely package by package ID. " +
21
+ "Returns subject, sender, recipients, files, state, timestamps, " +
22
+ "and — for TRANSFER and DROPZONE packages — per-recipient download " +
23
+ "and view history under `recipients[].confirmations` (one entry " +
24
+ "per recipient access event; surfaced to senders in the SendSafely " +
25
+ "UI as the recipient's \"Recipient History\"). For WORKSPACE " +
26
+ "(virtual data room) packages, recipient activity is NOT carried " +
27
+ "here; call get_activity_log for the Workspace's full Activity " +
28
+ "Log instead. Use `packageType` on the response to decide. " +
29
+ "This tool doesn't return the package Keycode, so it can't be " +
30
+ "used to unlock or read package contents.",
31
+ inputSchema: {
32
+ package_id: z.string().describe("The unique SendSafely package ID."),
33
+ },
34
+ annotations: {
35
+ readOnlyHint: true,
36
+ destructiveHint: false,
37
+ idempotentHint: true,
38
+ openWorldHint: true,
39
+ },
40
+ }, safeHandler("get_package_information", (args, extra) => handleGetPackageInformation(args, extra, ctx)));
41
+ }
@@ -0,0 +1,5 @@
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 handleGetReceivedPackages(_args: Record<string, never>, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
5
+ export declare function registerGetReceivedPackages(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,54 @@
1
+ import { jsonResult } from "../jsonResult.js";
2
+ import { stripPackageSecrets } from "../store/packageSecretCache.js";
3
+ import { runTool } from "../runTool.js";
4
+ import { safeHandler } from "../safeHandler.js";
5
+ import { getReceivedPackagesPage } from "../sdk/sdkPromise.js";
6
+ const MAX_PACKAGES_SAFETY_CAP = 10_000;
7
+ async function collectAllReceivedPackages(client) {
8
+ const all = [];
9
+ let rowIndex = 0;
10
+ while (all.length < MAX_PACKAGES_SAFETY_CAP) {
11
+ const page = await getReceivedPackagesPage(client, rowIndex);
12
+ const pkgs = page.packages ?? [];
13
+ if (pkgs.length === 0)
14
+ break;
15
+ all.push(...pkgs);
16
+ if (page.totalPackages !== undefined && all.length >= page.totalPackages) {
17
+ break;
18
+ }
19
+ rowIndex += pkgs.length;
20
+ }
21
+ return all;
22
+ }
23
+ export async function handleGetReceivedPackages(_args, extra, ctx) {
24
+ return runTool("get_received_packages", "Failed to retrieve packages", async () => {
25
+ const client = await ctx.getClient(extra);
26
+ const packages = await collectAllReceivedPackages(client);
27
+ return jsonResult({
28
+ status: "success",
29
+ packages: packages.map((p) => p !== null && typeof p === "object" ? stripPackageSecrets(p) : p),
30
+ });
31
+ });
32
+ }
33
+ export function registerGetReceivedPackages(mcp, ctx) {
34
+ mcp.registerTool("get_received_packages", {
35
+ title: "List Received Packages",
36
+ description: "Get all packages received by the authenticated user. " +
37
+ "Returns a list of received packages with metadata such as package ID, " +
38
+ "sender, state, and timestamps. " +
39
+ "State rendering: surface each package's state string AS-IS, " +
40
+ "exactly as the API returned it (e.g. \"Active – Pickup Complete\", " +
41
+ "\"Archived (Expired)\"). Do NOT collapse it to a generic " +
42
+ "\"Active\" / \"Archived\" bucket — that collapse is specific to " +
43
+ "get_workspaces and would lose useful detail here (received " +
44
+ "packages are TRANSFER / DROPZONE flows where pickup state, " +
45
+ "expiration, and similar qualifiers matter to the user).",
46
+ inputSchema: {},
47
+ annotations: {
48
+ readOnlyHint: true,
49
+ destructiveHint: false,
50
+ idempotentHint: true,
51
+ openWorldHint: true,
52
+ },
53
+ }, safeHandler("get_received_packages", (args, extra) => handleGetReceivedPackages(args, extra, ctx)));
54
+ }
@@ -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 handleGetRecipient(args: {
5
+ package_id: string;
6
+ recipient_id: string;
7
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
8
+ export declare function registerGetRecipient(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,30 @@
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 { getRecipient } from "../sdk/sdkPromise.js";
6
+ export async function handleGetRecipient(args, extra, ctx) {
7
+ return runTool("get_recipient", "Failed to retrieve recipient", async () => {
8
+ const client = await ctx.getClient(extra);
9
+ const recipient = await getRecipient(client, args.package_id, args.recipient_id);
10
+ return jsonResult({ status: "success", recipient });
11
+ });
12
+ }
13
+ export function registerGetRecipient(mcp, ctx) {
14
+ mcp.registerTool("get_recipient", {
15
+ title: "Get Recipient",
16
+ description: "Retrieve a single recipient on a SendSafely package by recipient " +
17
+ "ID. The full recipient list is also available inside " +
18
+ "get_package_information; use this tool when you only need one.",
19
+ inputSchema: {
20
+ package_id: z.string().describe("The unique SendSafely package ID."),
21
+ recipient_id: z.string().describe("The unique recipient ID."),
22
+ },
23
+ annotations: {
24
+ readOnlyHint: true,
25
+ destructiveHint: false,
26
+ idempotentHint: true,
27
+ openWorldHint: true,
28
+ },
29
+ }, safeHandler("get_recipient", (args, extra) => handleGetRecipient(args, extra, ctx)));
30
+ }
@@ -0,0 +1,7 @@
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 handleGetSentPackages(args: {
5
+ state?: "active" | "archived" | "all" | undefined;
6
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
7
+ export declare function registerGetSentPackages(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,84 @@
1
+ import { z } from "zod";
2
+ import { jsonResult } from "../jsonResult.js";
3
+ import { stripPackageSecrets } from "../store/packageSecretCache.js";
4
+ import { runTool } from "../runTool.js";
5
+ import { safeHandler } from "../safeHandler.js";
6
+ import { getActivePackagesPage, getArchivedPackagesPage, } from "../sdk/sdkPromise.js";
7
+ const MAX_PACKAGES_SAFETY_CAP = 10_000;
8
+ async function collectAllPackages(client, pageFn) {
9
+ const all = [];
10
+ let rowIndex = 0;
11
+ let exhausted = false;
12
+ while (all.length < MAX_PACKAGES_SAFETY_CAP) {
13
+ const page = await pageFn(client, rowIndex);
14
+ const pkgs = page.packages ?? [];
15
+ if (pkgs.length === 0) {
16
+ exhausted = true;
17
+ break;
18
+ }
19
+ all.push(...pkgs);
20
+ if (page.totalPackages !== undefined && all.length >= page.totalPackages) {
21
+ exhausted = true;
22
+ break;
23
+ }
24
+ rowIndex += pkgs.length;
25
+ }
26
+ return {
27
+ packages: all.map((p) => p !== null && typeof p === "object" ? stripPackageSecrets(p) : p),
28
+ truncated: !exhausted,
29
+ };
30
+ }
31
+ export async function handleGetSentPackages(args, extra, ctx) {
32
+ return runTool("get_sent_packages", "Failed to retrieve sent packages", async () => {
33
+ const client = await ctx.getClient(extra);
34
+ const state = args.state ?? "all";
35
+ const result = {};
36
+ let truncated = false;
37
+ if (state === "active" || state === "all") {
38
+ const r = await collectAllPackages(client, getActivePackagesPage);
39
+ result.active = r.packages;
40
+ if (r.truncated)
41
+ truncated = true;
42
+ }
43
+ if (state === "archived" || state === "all") {
44
+ const r = await collectAllPackages(client, getArchivedPackagesPage);
45
+ result.archived = r.packages;
46
+ if (r.truncated)
47
+ truncated = true;
48
+ }
49
+ return jsonResult({ status: "success", ...result, truncated });
50
+ });
51
+ }
52
+ export function registerGetSentPackages(mcp, ctx) {
53
+ mcp.registerTool("get_sent_packages", {
54
+ title: "List Sent Packages",
55
+ description: "Get packages sent by the authenticated user. Use the optional " +
56
+ "`state` parameter to filter to active or archived packages; the " +
57
+ "default returns both. Pagination is handled internally up to a " +
58
+ "safety cap of 10,000 packages per category. The response always " +
59
+ "includes a top-level `truncated` boolean; when `true`, the cap " +
60
+ "was hit and additional packages exist beyond what was returned. " +
61
+ "Surface this to the user so they know the listing is incomplete. " +
62
+ "State rendering: surface each package's per-entry state " +
63
+ "string AS-IS, exactly as the API returned it (e.g. \"Active – " +
64
+ "Pickup Complete\", \"Archived (Expired)\"). Do NOT collapse it " +
65
+ "to a generic \"Active\" / \"Archived\" bucket — that collapse " +
66
+ "is specific to get_workspaces. Sent packages are TRANSFER / " +
67
+ "DROPZONE flows where pickup state, expiration, and similar " +
68
+ "qualifiers matter to the sender.",
69
+ inputSchema: {
70
+ state: z
71
+ .enum(["active", "archived", "all"])
72
+ .optional()
73
+ .describe("Filter by package state. 'active' = packages still available " +
74
+ "to recipients; 'archived' = packages the sender has archived; " +
75
+ "'all' (default) returns both lists."),
76
+ },
77
+ annotations: {
78
+ readOnlyHint: true,
79
+ destructiveHint: false,
80
+ idempotentHint: true,
81
+ openWorldHint: true,
82
+ },
83
+ }, safeHandler("get_sent_packages", (args, extra) => handleGetSentPackages(args, extra, ctx)));
84
+ }
@@ -0,0 +1,5 @@
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 handleGetWorkspaces(_args: Record<string, never>, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
5
+ export declare function registerGetWorkspaces(mcp: McpServer, ctx: ToolContext): void;