@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,120 @@
1
+ import { z } from "zod";
2
+ import { approvalGateError, CONSENT_FALLBACK_INSTRUCTIONS, proceedWithoutPromptSchema, } from "../../approval.js";
3
+ import { jsonError, jsonResult } from "../../jsonResult.js";
4
+ import { ACTIVE_KEY_ID } from "../../store/keyStore.js";
5
+ import {} from "../../store/packageSecretCache.js";
6
+ import { runTool } from "../../runTool.js";
7
+ import { safeHandler } from "../../safeHandler.js";
8
+ import { getKeycode, packageInformation } from "../../sdk/sdkPromise.js";
9
+ export async function handleGetPackageKeycode(args, extra, ctx, cacheFor, keyStore) {
10
+ return runTool("get_package_keycode", "Failed to cache package keycode", async () => {
11
+ let publicKeyId = args.public_key_id;
12
+ if (!publicKeyId) {
13
+ const active = await keyStore.get(ACTIVE_KEY_ID);
14
+ if (!active) {
15
+ return jsonError("No Trusted Device is registered on this MCP server, so the " +
16
+ "package's Keycode cannot be retrieved without a keyed link. " +
17
+ "ACTION FOR THE AGENT: Ask the user whether they want to set " +
18
+ "up a Trusted Device for this MCP server. Present this " +
19
+ "disclaimer verbatim so they understand what they're agreeing " +
20
+ "to:\n\n" +
21
+ " \"Setting up a Trusted Device means this MCP server (and " +
22
+ "the AI agent driving it) will be able to unlock any new " +
23
+ "SendSafely packages sent to you WITHOUT needing the keyed " +
24
+ "link each time. The private key is generated locally and " +
25
+ "stored only in this machine's OS keychain — SendSafely " +
26
+ "never sees it. But this does mean the agent inherits the " +
27
+ "ability to read those packages whenever it runs. Only " +
28
+ "agree if you trust this agent the same way you'd trust a " +
29
+ "logged-in browser session.\"\n\n" +
30
+ "If the user agrees, call generate_trusted_device_keypair " +
31
+ "(it requires its own approval prompt with the same security " +
32
+ "context). If they decline, fall back to asking them to " +
33
+ "paste the keyed link for the specific package they want to " +
34
+ "access and use get_package_information_from_link instead.");
35
+ }
36
+ publicKeyId = active;
37
+ }
38
+ const privateKey = await keyStore.get(publicKeyId);
39
+ if (!privateKey) {
40
+ return jsonError(`No Trusted Device private key found for public_key_id '${publicKeyId}'. ` +
41
+ "Register one with generate_trusted_device_keypair, or pass the public_key_id " +
42
+ "returned by that tool.");
43
+ }
44
+ const approval = await ctx.requireUserApproval(`Use the registered Trusted Device to unlock the decryption Keycode ` +
45
+ `for SendSafely package ${args.package_id}? This caches the Keycode ` +
46
+ `so the AI assistant can decrypt and read this package's files and ` +
47
+ `messages without the secure link.`);
48
+ const denied = approvalGateError(approval, "use the registered Trusted Device to unlock this package's decryption Keycode", {
49
+ proceedWithoutPrompt: args.proceed_without_prompt,
50
+ });
51
+ if (denied)
52
+ return denied;
53
+ const client = await ctx.getClient(extra);
54
+ const keyCode = await getKeycode(client, privateKey, publicKeyId, args.package_id);
55
+ const info = await packageInformation(client, args.package_id);
56
+ if (!info.serverSecret) {
57
+ return jsonError(`Package '${args.package_id}' returned no serverSecret; cannot cache ` +
58
+ "secrets for receive-flow tools.");
59
+ }
60
+ cacheFor(extra).set(args.package_id, {
61
+ keyCode,
62
+ serverSecret: info.serverSecret,
63
+ ...(info.packageCode ? { packageCode: info.packageCode } : {}),
64
+ });
65
+ return jsonResult({
66
+ status: "cached",
67
+ package_id: args.package_id,
68
+ message: "Package Keycode resolved via the Trusted Device and cached for " +
69
+ "this session. Downstream receive-flow tools (get_package_message, " +
70
+ "download_file_from_directory, download_package_files) can now " +
71
+ "operate by package_id without re-supplying the secure link.",
72
+ });
73
+ });
74
+ }
75
+ export function registerGetPackageKeycode(mcp, ctx, cacheFor, keyStore) {
76
+ mcp.registerTool("get_package_keycode", {
77
+ title: "Get Package Keycode (Trusted Device)",
78
+ description: "Resolve the Keycode for a SendSafely package using a registered " +
79
+ "Trusted Device key pair. Looks up the encrypted Keycode from " +
80
+ "SendSafely, decrypts it locally with the private key in the OS " +
81
+ "keychain, and caches the result server-side so subsequent " +
82
+ "receive-flow tools (get_package_message, download_file_from_directory, " +
83
+ "download_package_files) can operate by package_id without the " +
84
+ "caller pasting the secure link. By default the decrypted Keycode " +
85
+ "is held in the server-side cache rather than echoed back in this " +
86
+ "tool's result — downstream tools read it from the cache directly. " +
87
+ "If the user explicitly wants the keyed link for their own " +
88
+ "reference, surface it via finalize_package(auto_notify=false) or " +
89
+ "construct it from get_package_information_from_link. " +
90
+ "If public_key_id is omitted, the server uses " +
91
+ "the most recently registered Trusted Device on this machine — " +
92
+ "useful for clients that cannot read the OS keychain themselves to " +
93
+ "discover the id. Fails when the Trusted Device has not been " +
94
+ "authorized for the package (e.g., the package predates this " +
95
+ "device's registration). Available only on transports that provide " +
96
+ "a secure local key store (today: stdio). " +
97
+ "Requires user approval via MCP elicitation — unlocking the Keycode " +
98
+ "lets the assistant decrypt this package's files and messages, so the " +
99
+ "user is prompted before the Trusted Device is used. " +
100
+ CONSENT_FALLBACK_INSTRUCTIONS,
101
+ inputSchema: {
102
+ package_id: z.string().describe("The unique SendSafely package ID."),
103
+ public_key_id: z
104
+ .string()
105
+ .optional()
106
+ .describe("Optional. The publicKeyId of the Trusted Device key pair to " +
107
+ "use for decryption — the same id returned by " +
108
+ "generate_trusted_device_keypair. If omitted, the server " +
109
+ "falls back to the most recently registered Trusted Device " +
110
+ "on this machine."),
111
+ proceed_without_prompt: proceedWithoutPromptSchema,
112
+ },
113
+ annotations: {
114
+ readOnlyHint: true,
115
+ destructiveHint: false,
116
+ idempotentHint: true,
117
+ openWorldHint: true,
118
+ },
119
+ }, safeHandler("get_package_keycode", (args, extra) => handleGetPackageKeycode(args, extra, ctx, cacheFor, keyStore)));
120
+ }
@@ -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 handleGetPackageMessage(args: {
6
+ package_id: string;
7
+ proceed_without_prompt?: boolean | undefined;
8
+ }, extra: ToolExtra, ctx: ToolContext, cacheFor: CacheFor): Promise<CallToolResult>;
9
+ export declare function registerGetPackageMessage(mcp: McpServer, ctx: ToolContext, cacheFor: CacheFor): void;
@@ -0,0 +1,59 @@
1
+ import { z } from "zod";
2
+ import { approvalGateError, CONSENT_FALLBACK_INSTRUCTIONS, proceedWithoutPromptSchema, } from "../../approval.js";
3
+ import { jsonError, jsonResult } from "../../jsonResult.js";
4
+ import { MissingPackageSecretsError, } from "../../store/packageSecretCache.js";
5
+ import { runTool } from "../../runTool.js";
6
+ import { safeHandler } from "../../safeHandler.js";
7
+ import { getDecryptedPackageMessage } from "../../sdk/sdkPromise.js";
8
+ export async function handleGetPackageMessage(args, extra, ctx, cacheFor) {
9
+ return runTool("get_package_message", "Failed to retrieve package message", 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
+ if (!secrets.packageCode) {
15
+ return jsonError(`Cached secrets for packageId '${args.package_id}' do not include a ` +
16
+ "packageCode; resolve the package via get_package_information_from_link " +
17
+ "first (the by-id metadata endpoint does not surface the Keycode " +
18
+ "needed for receive-flow operations).");
19
+ }
20
+ const approval = await ctx.requireUserApproval(`Decrypt the secure message attached to SendSafely package ` +
21
+ `${args.package_id} and return its plaintext? The decrypted message ` +
22
+ "will be visible to the AI assistant.");
23
+ const denied = approvalGateError(approval, "decrypt this package's secure message and return its plaintext to the assistant", {
24
+ proceedWithoutPrompt: args.proceed_without_prompt,
25
+ });
26
+ if (denied)
27
+ return denied;
28
+ const message = await getDecryptedPackageMessage(client, args.package_id, secrets.packageCode, secrets.keyCode, secrets.serverSecret);
29
+ return jsonResult({
30
+ status: "success",
31
+ package_id: args.package_id,
32
+ message,
33
+ });
34
+ });
35
+ }
36
+ export function registerGetPackageMessage(mcp, ctx, cacheFor) {
37
+ mcp.registerTool("get_package_message", {
38
+ title: "Get Package Message",
39
+ description: "Decrypt and return the secure message attached to a SendSafely " +
40
+ "package. The package's Keycode must be in the server-side cache " +
41
+ "— populated by get_package_information_from_link when a keyed " +
42
+ "link is available, or by get_package_keycode when a Trusted " +
43
+ "Device private key is registered for the user. " +
44
+ "(get_package_information by ID does not populate the cache.) " +
45
+ "Requires user approval via MCP elicitation — decrypted message " +
46
+ "content is returned to the AI assistant. " +
47
+ CONSENT_FALLBACK_INSTRUCTIONS,
48
+ inputSchema: {
49
+ package_id: z.string().describe("The unique SendSafely package ID."),
50
+ proceed_without_prompt: proceedWithoutPromptSchema,
51
+ },
52
+ annotations: {
53
+ readOnlyHint: true,
54
+ destructiveHint: false,
55
+ idempotentHint: true,
56
+ openWorldHint: true,
57
+ },
58
+ }, safeHandler("get_package_message", (args, extra) => handleGetPackageMessage(args, extra, ctx, cacheFor)));
59
+ }
@@ -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 handleListDownloadedFiles(_args: Record<string, never>, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
5
+ export declare function registerListDownloadedFiles(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,71 @@
1
+ import { readdir, stat } from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { jsonError, jsonResult } from "../../jsonResult.js";
4
+ import { safeHandler } from "../../safeHandler.js";
5
+ async function walkDownloadDir(root) {
6
+ const entries = [];
7
+ const dirents = await readdir(root, {
8
+ recursive: true,
9
+ withFileTypes: true,
10
+ });
11
+ for (const dirent of dirents) {
12
+ if (!dirent.isFile())
13
+ continue;
14
+ if (dirent.name.startsWith("."))
15
+ continue;
16
+ const parentPath = dirent.parentPath ?? root;
17
+ const fullPath = path.join(parentPath, dirent.name);
18
+ try {
19
+ const st = await stat(fullPath);
20
+ entries.push({
21
+ file_name: dirent.name,
22
+ file_size: st.size,
23
+ local_path: fullPath,
24
+ modified: new Date(st.mtimeMs).toISOString(),
25
+ });
26
+ }
27
+ catch {
28
+ }
29
+ }
30
+ entries.sort((a, b) => (a.modified < b.modified ? 1 : -1));
31
+ return entries;
32
+ }
33
+ export async function handleListDownloadedFiles(_args, extra, ctx) {
34
+ const downloadDir = ctx.getDownloadDir(extra);
35
+ try {
36
+ let files = [];
37
+ try {
38
+ files = await walkDownloadDir(downloadDir);
39
+ }
40
+ catch (err) {
41
+ if (err.code === "ENOENT") {
42
+ return jsonResult({ status: "success", files: [] });
43
+ }
44
+ throw err;
45
+ }
46
+ return jsonResult({ status: "success", files });
47
+ }
48
+ catch (err) {
49
+ const msg = err instanceof Error ? err.message : String(err);
50
+ return jsonError(`Failed to list files: ${msg}`);
51
+ }
52
+ }
53
+ export function registerListDownloadedFiles(mcp, ctx) {
54
+ mcp.registerTool("list_downloaded_files", {
55
+ title: "List Downloaded Files",
56
+ description: "List all files that have been downloaded to the SendSafely download " +
57
+ "directory. Files are stored under <download_dir>/<packageId>/ with " +
58
+ "their sender-provided name (unsafe characters replaced by '_'). " +
59
+ "Returns file names, sizes, and paths. " +
60
+ "Does NOT return file contents. " +
61
+ "IMPORTANT: To read file contents, you must first ask the user for " +
62
+ "explicit permission, then use the read_downloaded_file tool.",
63
+ inputSchema: {},
64
+ annotations: {
65
+ readOnlyHint: true,
66
+ destructiveHint: false,
67
+ idempotentHint: true,
68
+ openWorldHint: false,
69
+ },
70
+ }, safeHandler("list_downloaded_files", (args, extra) => handleListDownloadedFiles(args, extra, ctx)));
71
+ }
@@ -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 handleReadDownloadedFile(args: {
5
+ file_path: string;
6
+ proceed_without_prompt?: boolean | undefined;
7
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
8
+ export declare function registerReadDownloadedFile(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,176 @@
1
+ import { open, readFile, realpath, stat } from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { pathToFileURL } from "node:url";
4
+ import mime from "mime-types";
5
+ import { pdfToPng } from "pdf-to-png-converter";
6
+ import { z } from "zod";
7
+ import { MAX_FILE_READ_SIZE, MAX_PDF_PAGES, MAX_TEXT_PREVIEW, } from "../../constants.js";
8
+ import { approvalGateError, CONSENT_FALLBACK_INSTRUCTIONS, proceedWithoutPromptSchema, } from "../../approval.js";
9
+ import { jsonError, jsonResult } from "../../jsonResult.js";
10
+ import { safeHandler } from "../../safeHandler.js";
11
+ const TEXT_APPLICATION_MIMES = new Set([
12
+ "application/json",
13
+ "application/xml",
14
+ "application/csv",
15
+ ]);
16
+ async function sampleIsText(filePath) {
17
+ const fh = await open(filePath, "r");
18
+ try {
19
+ const buf = Buffer.alloc(8192);
20
+ const { bytesRead } = await fh.read(buf, 0, 8192, 0);
21
+ const sample = buf.subarray(0, bytesRead);
22
+ return !sample.includes(0);
23
+ }
24
+ finally {
25
+ await fh.close();
26
+ }
27
+ }
28
+ export async function handleReadDownloadedFile(args, extra, ctx) {
29
+ try {
30
+ const downloadDir = ctx.getDownloadDir(extra);
31
+ const realDownloadDir = await realpath(downloadDir).catch(() => null);
32
+ const realPath = await realpath(args.file_path).catch(() => null);
33
+ if (!realPath ||
34
+ !realDownloadDir ||
35
+ !realPath.startsWith(realDownloadDir + path.sep)) {
36
+ return jsonError("Access denied: file path is outside the download directory.");
37
+ }
38
+ let fileStat;
39
+ try {
40
+ fileStat = await stat(realPath);
41
+ }
42
+ catch {
43
+ return jsonError(`File not found: ${args.file_path}`);
44
+ }
45
+ if (!fileStat.isFile()) {
46
+ return jsonError(`File not found: ${args.file_path}`);
47
+ }
48
+ const fileSize = fileStat.size;
49
+ const fileName = path.basename(realPath);
50
+ const packageId = path.basename(path.dirname(realPath));
51
+ const approvalMessage = `Read the contents of "${fileName}" (${fileSize.toLocaleString("en-US")} bytes) ` +
52
+ `from SendSafely package ${packageId}?\n\n` +
53
+ `This file was received via SendSafely's secure transfer and ` +
54
+ `may contain sensitive or confidential information. Approving ` +
55
+ `will expose its contents to the AI assistant.`;
56
+ const approval = await ctx.requireUserApproval(approvalMessage);
57
+ const denied = approvalGateError(approval, "read this file's contents and expose them to the assistant", {
58
+ proceedWithoutPrompt: args.proceed_without_prompt,
59
+ abortPrefix: "Read aborted",
60
+ });
61
+ if (denied)
62
+ return denied;
63
+ const mimeLookup = mime.lookup(realPath);
64
+ const mimeType = typeof mimeLookup === "string" ? mimeLookup : "";
65
+ let isText = false;
66
+ if (mimeType &&
67
+ (mimeType.startsWith("text/") || TEXT_APPLICATION_MIMES.has(mimeType))) {
68
+ isText = true;
69
+ }
70
+ else if (mimeType !== "application/pdf" && !mimeType.startsWith("image/")) {
71
+ isText = await sampleIsText(realPath);
72
+ }
73
+ if (fileSize > MAX_FILE_READ_SIZE) {
74
+ return jsonError(`File too large to read (${fileSize} bytes). ` +
75
+ `Maximum supported size is ${MAX_FILE_READ_SIZE} bytes.`);
76
+ }
77
+ if (isText) {
78
+ const content = await readFile(realPath, "utf8");
79
+ const truncated = content.length > MAX_TEXT_PREVIEW;
80
+ const result = {
81
+ status: "success",
82
+ file_name: fileName,
83
+ file_path: realPath,
84
+ file_size: fileSize,
85
+ content_type: "text",
86
+ content: truncated ? content.slice(0, MAX_TEXT_PREVIEW) : content,
87
+ };
88
+ if (truncated) {
89
+ result.truncated = true;
90
+ result.total_characters = content.length;
91
+ }
92
+ return jsonResult(result);
93
+ }
94
+ if (mimeType && mimeType.startsWith("image/")) {
95
+ const raw = await readFile(realPath);
96
+ return {
97
+ content: [{ type: "image", data: raw.toString("base64"), mimeType }],
98
+ isError: false,
99
+ };
100
+ }
101
+ if (mimeType === "application/pdf") {
102
+ const raw = await readFile(realPath);
103
+ const pagesToProcess = Array.from({ length: MAX_PDF_PAGES + 1 }, (_, i) => i + 1);
104
+ const rendered = await pdfToPng(raw, { viewportScale: 2.0, pagesToProcess });
105
+ if (rendered.length === 0) {
106
+ return jsonError("Failed to read file: PDF has no renderable pages");
107
+ }
108
+ const pages = rendered.slice(0, MAX_PDF_PAGES);
109
+ const truncated = rendered.length > MAX_PDF_PAGES;
110
+ if (truncated) {
111
+ process.stderr.write(`PDF truncated: rendered the first ${MAX_PDF_PAGES} pages of ${fileName} ` +
112
+ "(document may be longer)\n");
113
+ }
114
+ const content = pages.map((p) => ({
115
+ type: "image",
116
+ data: (p.content ?? Buffer.alloc(0)).toString("base64"),
117
+ mimeType: "image/png",
118
+ }));
119
+ if (truncated) {
120
+ content.push({
121
+ type: "text",
122
+ text: `[Truncated: showing the first ${MAX_PDF_PAGES} pages of ` +
123
+ `"${fileName}". The document continues beyond this point; tell ` +
124
+ "the user the remaining pages were not read.]",
125
+ });
126
+ }
127
+ return { content, isError: false };
128
+ }
129
+ const raw = await readFile(realPath);
130
+ return {
131
+ content: [
132
+ {
133
+ type: "resource",
134
+ resource: {
135
+ uri: pathToFileURL(realPath).toString(),
136
+ mimeType: mimeType || "application/octet-stream",
137
+ blob: raw.toString("base64"),
138
+ },
139
+ },
140
+ ],
141
+ isError: false,
142
+ };
143
+ }
144
+ catch (err) {
145
+ const msg = err instanceof Error ? err.message : String(err);
146
+ return jsonError(`Failed to read file: ${msg}`);
147
+ }
148
+ }
149
+ export function registerReadDownloadedFile(mcp, ctx) {
150
+ mcp.registerTool("read_downloaded_file", {
151
+ title: "Read Downloaded File",
152
+ description: "Read the contents of a previously downloaded SendSafely file. " +
153
+ "Files are stored under <download_dir>/<packageId>/<file_name>, " +
154
+ "where file_name is the sender-provided name with unsafe characters " +
155
+ "replaced by '_' by the SendSafely SDK. Always use the local_path " +
156
+ "from download_package_files or list_downloaded_files to reference " +
157
+ "files. " +
158
+ "CRITICAL: You MUST obtain explicit user permission before calling " +
159
+ "this tool. This file was received via SendSafely's secure file " +
160
+ "transfer and may contain sensitive or confidential information. " +
161
+ "Approval is collected via MCP elicitation. " +
162
+ CONSENT_FALLBACK_INSTRUCTIONS,
163
+ inputSchema: {
164
+ file_path: z
165
+ .string()
166
+ .describe("Absolute path to a file in the SendSafely download directory."),
167
+ proceed_without_prompt: proceedWithoutPromptSchema,
168
+ },
169
+ annotations: {
170
+ readOnlyHint: true,
171
+ destructiveHint: false,
172
+ idempotentHint: true,
173
+ openWorldHint: false,
174
+ },
175
+ }, safeHandler("read_downloaded_file", (args, extra) => handleReadDownloadedFile(args, extra, ctx)));
176
+ }
@@ -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
+ import { type CacheFor } from "../../store/packageSecretCache.js";
5
+ export interface UploadFileArgs {
6
+ package_id: string;
7
+ file_path: string;
8
+ directory_id?: string | undefined;
9
+ proceed_without_prompt?: boolean | undefined;
10
+ }
11
+ export declare function handleUploadFile(args: UploadFileArgs, extra: ToolExtra, ctx: ToolContext, cacheFor: CacheFor): Promise<CallToolResult>;
12
+ export declare function registerUploadFile(mcp: McpServer, ctx: ToolContext, cacheFor: CacheFor): void;
@@ -0,0 +1,69 @@
1
+ import path from "node:path";
2
+ import { z } from "zod";
3
+ import { approvalGateError, CONSENT_FALLBACK_INSTRUCTIONS, proceedWithoutPromptSchema, } from "../../approval.js";
4
+ import { jsonError, jsonResult } from "../../jsonResult.js";
5
+ import { MissingPackageSecretsError, } from "../../store/packageSecretCache.js";
6
+ import { runTool } from "../../runTool.js";
7
+ import { safeHandler } from "../../safeHandler.js";
8
+ import { encryptAndUploadFile } from "../../sdk/sdkPromise.js";
9
+ export async function handleUploadFile(args, extra, ctx, cacheFor) {
10
+ return runTool("upload_file", "Failed to upload file", async () => {
11
+ if (!path.isAbsolute(args.file_path)) {
12
+ return jsonError(`file_path must be absolute; received '${args.file_path}'.`);
13
+ }
14
+ const client = await ctx.getClient(extra);
15
+ const secrets = cacheFor(extra).get(args.package_id);
16
+ if (!secrets)
17
+ throw new MissingPackageSecretsError(args.package_id);
18
+ const approval = await ctx.requireUserApproval(`Read "${args.file_path}" from this machine, encrypt it, and upload it ` +
19
+ `to SendSafely package ${args.package_id}` +
20
+ `${args.directory_id ? ` (directory ${args.directory_id})` : ""}?`);
21
+ const denied = approvalGateError(approval, "read a local file and upload it to a SendSafely package", {
22
+ proceedWithoutPrompt: args.proceed_without_prompt,
23
+ abortPrefix: "Upload aborted",
24
+ });
25
+ if (denied)
26
+ return denied;
27
+ const uploaded = await encryptAndUploadFile(client, args.package_id, secrets.keyCode, secrets.serverSecret, args.file_path, args.directory_id);
28
+ return jsonResult({
29
+ status: "success",
30
+ package_id: uploaded.packageId,
31
+ file_id: uploaded.fileId,
32
+ file_name: uploaded.fileName,
33
+ file_size: uploaded.fileSize,
34
+ ...(args.directory_id ? { directory_id: args.directory_id } : {}),
35
+ });
36
+ });
37
+ }
38
+ export function registerUploadFile(mcp, ctx, cacheFor) {
39
+ mcp.registerTool("upload_file", {
40
+ title: "Upload File",
41
+ description: "Encrypt and upload a single file from the local filesystem to an " +
42
+ "unfinalized SendSafely package. Pass `directory_id` to upload " +
43
+ "into a workspace directory; omit for the package root. The " +
44
+ "package's secret material must be in the server-side cache — " +
45
+ "typically because create_package / create_workspace was called " +
46
+ "to author it, or because get_package_keycode unlocked it via a " +
47
+ "registered Trusted Device. " +
48
+ "CONSENT: this tool reads a file from the local machine, so it " +
49
+ "requires user approval, collected via MCP elicitation. " +
50
+ CONSENT_FALLBACK_INSTRUCTIONS,
51
+ inputSchema: {
52
+ package_id: z.string().describe("The unique SendSafely package ID."),
53
+ file_path: z
54
+ .string()
55
+ .describe("Absolute path to the local file to upload."),
56
+ directory_id: z
57
+ .string()
58
+ .optional()
59
+ .describe("Workspace directory ID. Omit to upload to the package root."),
60
+ proceed_without_prompt: proceedWithoutPromptSchema,
61
+ },
62
+ annotations: {
63
+ readOnlyHint: false,
64
+ destructiveHint: false,
65
+ idempotentHint: false,
66
+ openWorldHint: true,
67
+ },
68
+ }, safeHandler("upload_file", (args, extra) => handleUploadFile(args, extra, ctx, cacheFor)));
69
+ }
@@ -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 handleUpdateFile(args: {
5
+ package_id: string;
6
+ file_id: string;
7
+ file_name: string;
8
+ }, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
9
+ export declare function registerUpdateFile(mcp: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,38 @@
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 { updateFile } from "../sdk/sdkPromise.js";
6
+ export async function handleUpdateFile(args, extra, ctx) {
7
+ return runTool("update_file", "Failed to update file", async () => {
8
+ const client = await ctx.getClient(extra);
9
+ await updateFile(client, args.package_id, args.file_id, args.file_name);
10
+ return jsonResult({
11
+ status: "success",
12
+ package_id: args.package_id,
13
+ file_id: args.file_id,
14
+ file_name: args.file_name,
15
+ });
16
+ });
17
+ }
18
+ export function registerUpdateFile(mcp, ctx) {
19
+ mcp.registerTool("update_file", {
20
+ title: "Rename File",
21
+ description: "Rename a file inside a SendSafely package. Affects only the " +
22
+ "displayed name; the file ID and contents are unchanged. Only " +
23
+ "works on WORKSPACE and DROPZONE packages that are still active; " +
24
+ "TRANSFER packages can't have files renamed. Check `packageType` " +
25
+ "with get_package_information first if the packageType is not already known.",
26
+ inputSchema: {
27
+ package_id: z.string().describe("The unique SendSafely package ID."),
28
+ file_id: z.string().describe("The unique file ID."),
29
+ file_name: z.string().describe("New display name for the file."),
30
+ },
31
+ annotations: {
32
+ readOnlyHint: false,
33
+ destructiveHint: false,
34
+ idempotentHint: true,
35
+ openWorldHint: true,
36
+ },
37
+ }, safeHandler("update_file", (args, extra) => handleUpdateFile(args, extra, ctx)));
38
+ }
@@ -0,0 +1,14 @@
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
+ interface UpdatePackageArgs {
5
+ package_id: string;
6
+ label?: string | undefined;
7
+ expiration_days?: number | undefined;
8
+ enable_watermark?: boolean | undefined;
9
+ restrict_file_save_and_print?: boolean | undefined;
10
+ recipient_access_limit?: number | undefined;
11
+ }
12
+ export declare function handleUpdatePackage(args: UpdatePackageArgs, extra: ToolExtra, ctx: ToolContext): Promise<CallToolResult>;
13
+ export declare function registerUpdatePackage(mcp: McpServer, ctx: ToolContext): void;
14
+ export {};