@layervai/qurl-mcp 0.4.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. package/README.md +798 -50
  2. package/assets/fonts/NotoSansSC-Regular.ttf +0 -0
  3. package/assets/fonts/OFL.txt +93 -0
  4. package/assets/fonts/README.md +18 -0
  5. package/dist/auth/request-context.d.ts +13 -0
  6. package/dist/auth/request-context.d.ts.map +1 -0
  7. package/dist/auth/request-context.js +21 -0
  8. package/dist/auth/request-context.js.map +1 -0
  9. package/dist/auth/static-bearer.d.ts +12 -0
  10. package/dist/auth/static-bearer.d.ts.map +1 -0
  11. package/dist/auth/static-bearer.js +47 -0
  12. package/dist/auth/static-bearer.js.map +1 -0
  13. package/dist/client.d.ts +66 -11
  14. package/dist/client.d.ts.map +1 -1
  15. package/dist/client.js +116 -7
  16. package/dist/client.js.map +1 -1
  17. package/dist/config.d.ts +98 -0
  18. package/dist/config.d.ts.map +1 -0
  19. package/dist/config.js +543 -0
  20. package/dist/config.js.map +1 -0
  21. package/dist/credential-rate-limit-store.d.ts +38 -0
  22. package/dist/credential-rate-limit-store.d.ts.map +1 -0
  23. package/dist/credential-rate-limit-store.js +135 -0
  24. package/dist/credential-rate-limit-store.js.map +1 -0
  25. package/dist/email-addresses.d.ts +7 -0
  26. package/dist/email-addresses.d.ts.map +1 -0
  27. package/dist/email-addresses.js +36 -0
  28. package/dist/email-addresses.js.map +1 -0
  29. package/dist/email-types.d.ts +33 -0
  30. package/dist/email-types.d.ts.map +1 -0
  31. package/dist/email-types.js +28 -0
  32. package/dist/email-types.js.map +1 -0
  33. package/dist/emf-metrics.d.ts +25 -0
  34. package/dist/emf-metrics.d.ts.map +1 -0
  35. package/dist/emf-metrics.js +87 -0
  36. package/dist/emf-metrics.js.map +1 -0
  37. package/dist/http-config.d.ts +38 -0
  38. package/dist/http-config.d.ts.map +1 -0
  39. package/dist/http-config.js +243 -0
  40. package/dist/http-config.js.map +1 -0
  41. package/dist/http-routes.d.ts +5 -0
  42. package/dist/http-routes.d.ts.map +1 -0
  43. package/dist/http-routes.js +12 -0
  44. package/dist/http-routes.js.map +1 -0
  45. package/dist/http.d.ts +33 -0
  46. package/dist/http.d.ts.map +1 -0
  47. package/dist/http.js +1116 -0
  48. package/dist/http.js.map +1 -0
  49. package/dist/index.d.ts +1 -1
  50. package/dist/index.d.ts.map +1 -1
  51. package/dist/index.js +42 -26
  52. package/dist/index.js.map +1 -1
  53. package/dist/logging.d.ts +7 -0
  54. package/dist/logging.d.ts.map +1 -0
  55. package/dist/logging.js +110 -0
  56. package/dist/logging.js.map +1 -0
  57. package/dist/prompts/audit-links.js +1 -1
  58. package/dist/prompts/audit-links.js.map +1 -1
  59. package/dist/server.d.ts +14 -4
  60. package/dist/server.d.ts.map +1 -1
  61. package/dist/server.js +38 -8
  62. package/dist/server.js.map +1 -1
  63. package/dist/services/email.d.ts +17 -0
  64. package/dist/services/email.d.ts.map +1 -0
  65. package/dist/services/email.js +351 -0
  66. package/dist/services/email.js.map +1 -0
  67. package/dist/services/html.d.ts +5 -0
  68. package/dist/services/html.d.ts.map +1 -0
  69. package/dist/services/html.js +28 -0
  70. package/dist/services/html.js.map +1 -0
  71. package/dist/services/legal-pages.d.ts +12 -0
  72. package/dist/services/legal-pages.d.ts.map +1 -0
  73. package/dist/services/legal-pages.js +588 -0
  74. package/dist/services/legal-pages.js.map +1 -0
  75. package/dist/services/text-pdf.d.ts +16 -0
  76. package/dist/services/text-pdf.d.ts.map +1 -0
  77. package/dist/services/text-pdf.js +141 -0
  78. package/dist/services/text-pdf.js.map +1 -0
  79. package/dist/services/video-page.d.ts +4 -0
  80. package/dist/services/video-page.d.ts.map +1 -0
  81. package/dist/services/video-page.js +311 -0
  82. package/dist/services/video-page.js.map +1 -0
  83. package/dist/text.d.ts +4 -0
  84. package/dist/text.d.ts.map +1 -0
  85. package/dist/text.js +16 -0
  86. package/dist/text.js.map +1 -0
  87. package/dist/tools/_shared.d.ts +10 -1
  88. package/dist/tools/_shared.d.ts.map +1 -1
  89. package/dist/tools/_shared.js +25 -8
  90. package/dist/tools/_shared.js.map +1 -1
  91. package/dist/tools/batch-create.d.ts +12 -11
  92. package/dist/tools/batch-create.d.ts.map +1 -1
  93. package/dist/tools/batch-create.js +6 -4
  94. package/dist/tools/batch-create.js.map +1 -1
  95. package/dist/tools/consumer-access.d.ts +235 -0
  96. package/dist/tools/consumer-access.d.ts.map +1 -0
  97. package/dist/tools/consumer-access.js +231 -0
  98. package/dist/tools/consumer-access.js.map +1 -0
  99. package/dist/tools/create-qurl.d.ts +43 -4
  100. package/dist/tools/create-qurl.d.ts.map +1 -1
  101. package/dist/tools/create-qurl.js +69 -32
  102. package/dist/tools/create-qurl.js.map +1 -1
  103. package/dist/tools/delete-qurl.d.ts +3 -2
  104. package/dist/tools/delete-qurl.d.ts.map +1 -1
  105. package/dist/tools/delete-qurl.js +9 -13
  106. package/dist/tools/delete-qurl.js.map +1 -1
  107. package/dist/tools/duration.d.ts +13 -0
  108. package/dist/tools/duration.d.ts.map +1 -0
  109. package/dist/tools/duration.js +71 -0
  110. package/dist/tools/duration.js.map +1 -0
  111. package/dist/tools/email-delivery.d.ts +36 -0
  112. package/dist/tools/email-delivery.d.ts.map +1 -0
  113. package/dist/tools/email-delivery.js +114 -0
  114. package/dist/tools/email-delivery.js.map +1 -0
  115. package/dist/tools/extend-qurl.d.ts +20 -6
  116. package/dist/tools/extend-qurl.d.ts.map +1 -1
  117. package/dist/tools/extend-qurl.js +180 -19
  118. package/dist/tools/extend-qurl.js.map +1 -1
  119. package/dist/tools/get-qurl.d.ts +13 -5
  120. package/dist/tools/get-qurl.d.ts.map +1 -1
  121. package/dist/tools/get-qurl.js +5 -3
  122. package/dist/tools/get-qurl.js.map +1 -1
  123. package/dist/tools/list-qurl-sessions.d.ts +5 -4
  124. package/dist/tools/list-qurl-sessions.d.ts.map +1 -1
  125. package/dist/tools/list-qurl-sessions.js +2 -2
  126. package/dist/tools/list-qurl-sessions.js.map +1 -1
  127. package/dist/tools/list-qurls.d.ts +15 -7
  128. package/dist/tools/list-qurls.d.ts.map +1 -1
  129. package/dist/tools/list-qurls.js +9 -7
  130. package/dist/tools/list-qurls.js.map +1 -1
  131. package/dist/tools/mint-link.d.ts +39 -3
  132. package/dist/tools/mint-link.d.ts.map +1 -1
  133. package/dist/tools/mint-link.js +26 -14
  134. package/dist/tools/mint-link.js.map +1 -1
  135. package/dist/tools/output-schemas.d.ts +154 -45
  136. package/dist/tools/output-schemas.d.ts.map +1 -1
  137. package/dist/tools/output-schemas.js +106 -30
  138. package/dist/tools/output-schemas.js.map +1 -1
  139. package/dist/tools/resolve-qurl.d.ts +4 -3
  140. package/dist/tools/resolve-qurl.d.ts.map +1 -1
  141. package/dist/tools/resolve-qurl.js +3 -3
  142. package/dist/tools/resolve-qurl.js.map +1 -1
  143. package/dist/tools/revoke-qurl-token.d.ts +3 -2
  144. package/dist/tools/revoke-qurl-token.d.ts.map +1 -1
  145. package/dist/tools/revoke-qurl-token.js +2 -2
  146. package/dist/tools/revoke-qurl-token.js.map +1 -1
  147. package/dist/tools/share-by-crid.d.ts +50 -0
  148. package/dist/tools/share-by-crid.d.ts.map +1 -0
  149. package/dist/tools/share-by-crid.js +114 -0
  150. package/dist/tools/share-by-crid.js.map +1 -0
  151. package/dist/tools/terminate-qurl-sessions.d.ts +3 -2
  152. package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -1
  153. package/dist/tools/terminate-qurl-sessions.js +7 -3
  154. package/dist/tools/terminate-qurl-sessions.js.map +1 -1
  155. package/dist/tools/update-qurl-token.d.ts +5 -4
  156. package/dist/tools/update-qurl-token.d.ts.map +1 -1
  157. package/dist/tools/update-qurl-token.js +8 -9
  158. package/dist/tools/update-qurl-token.js.map +1 -1
  159. package/dist/tools/update-qurl.d.ts +13 -5
  160. package/dist/tools/update-qurl.d.ts.map +1 -1
  161. package/dist/tools/update-qurl.js +10 -11
  162. package/dist/tools/update-qurl.js.map +1 -1
  163. package/dist/tools/upload-file-data-qurl.d.ts +138 -0
  164. package/dist/tools/upload-file-data-qurl.d.ts.map +1 -0
  165. package/dist/tools/upload-file-data-qurl.js +207 -0
  166. package/dist/tools/upload-file-data-qurl.js.map +1 -0
  167. package/dist/tools/upload-file-qurl.d.ts +134 -0
  168. package/dist/tools/upload-file-qurl.d.ts.map +1 -0
  169. package/dist/tools/upload-file-qurl.js +174 -0
  170. package/dist/tools/upload-file-qurl.js.map +1 -0
  171. package/dist/tools/upload-file-shared.d.ts +53 -0
  172. package/dist/tools/upload-file-shared.d.ts.map +1 -0
  173. package/dist/tools/upload-file-shared.js +617 -0
  174. package/dist/tools/upload-file-shared.js.map +1 -0
  175. package/dist/tools/upload-mint-options.d.ts +22 -0
  176. package/dist/tools/upload-mint-options.d.ts.map +1 -0
  177. package/dist/tools/upload-mint-options.js +47 -0
  178. package/dist/tools/upload-mint-options.js.map +1 -0
  179. package/dist/tools/upload-text-qurl.d.ts +112 -0
  180. package/dist/tools/upload-text-qurl.d.ts.map +1 -0
  181. package/dist/tools/upload-text-qurl.js +106 -0
  182. package/dist/tools/upload-text-qurl.js.map +1 -0
  183. package/package.json +26 -8
@@ -1,6 +1,6 @@
1
1
  import { z } from "zod";
2
2
  import { QURLAPIError } from "../client.js";
3
- import { resourceOnlyIdSchema, toStructuredContent, withMissingApiKeyHandler } from "./_shared.js";
3
+ import { resourceOnlyIdSchema, toStructuredContent, withMissingApiKeyHandler, } from "./_shared.js";
4
4
  import { terminateQurlSessionsOutputSchema } from "./output-schemas.js";
5
5
  export const terminateQurlSessionsSchema = z.object({
6
6
  resource_id: resourceOnlyIdSchema("terminate sessions for"),
@@ -10,7 +10,7 @@ export const terminateQurlSessionsSchema = z.object({
10
10
  .optional()
11
11
  .describe("Specific session ID to terminate. Omit to terminate all active sessions for the resource."),
12
12
  });
13
- export function terminateQurlSessionsTool(client) {
13
+ export function terminateQurlSessionsTool(client, _runtime = { mode: "stdio" }) {
14
14
  return {
15
15
  name: "terminate_qurl_sessions",
16
16
  title: "Terminate qURL Sessions",
@@ -35,7 +35,9 @@ export function terminateQurlSessionsTool(client) {
35
35
  resource_id: input.resource_id,
36
36
  session_id: input.session_id,
37
37
  // The API returns 204 for a single session delete, so the tool
38
- // synthesizes the count from the successful operation.
38
+ // synthesizes the count from the successful operation. This means
39
+ // `terminated: 1` confirms accepted idempotent deletion semantics;
40
+ // it cannot prove that the session still existed at request time.
39
41
  terminated: 1,
40
42
  message: `qURL session ${input.session_id} is terminated.`,
41
43
  };
@@ -45,6 +47,8 @@ export function terminateQurlSessionsTool(client) {
45
47
  };
46
48
  }
47
49
  const result = await client.terminateAllResourceSessions(input.resource_id);
50
+ // The typed client contract requires this count; retain a runtime guard
51
+ // because the SDK response is untrusted at the wire boundary.
48
52
  const terminated = result.data?.terminated;
49
53
  if (typeof terminated !== "number") {
50
54
  throw new QURLAPIError(502, "invalid_response", "qURL API returned an invalid session termination response.");
@@ -1 +1 @@
1
- {"version":3,"file":"terminate-qurl-sessions.js","sourceRoot":"","sources":["../../src/tools/terminate-qurl-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,oBAAoB,CAAC,wBAAwB,CAAC;IAC3D,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,2FAA2F,CAC5F;CACJ,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,MAAmB;IAC3D,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,wDAAwD;YACxD,0IAA0I;YAC1I,gHAAgH;YAChH,iGAAiG;YACjG,gGAAgG;QAClG,WAAW,EAAE,2BAA2B;QACxC,YAAY,EAAE,iCAAiC;QAC/C,WAAW,EAAE;YACX,KAAK,EAAE,yBAAyB;YAChC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAC/B,KAAK,EAAE,KAAkD,EAAE,EAAE;YAC3D,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,MAAM,CAAC,wBAAwB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC3E,MAAM,OAAO,GAAG;oBACd,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,+DAA+D;oBAC/D,uDAAuD;oBACvD,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE,gBAAgB,KAAK,CAAC,UAAU,iBAAiB;iBAC3D,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;oBACnE,iBAAiB,EAAE,mBAAmB,CAAC,OAAO,CAAC;iBAChD,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC5E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC;YAC3C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,IAAI,YAAY,CACpB,GAAG,EACH,kBAAkB,EAClB,4DAA4D,CAC7D,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG;gBACd,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,UAAU;gBACV,OAAO,EAAE,cAAc,UAAU,mBAAmB;aACrD,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnE,iBAAiB,EAAE,mBAAmB,CAAC,OAAO,CAAC;aAChD,CAAC;QACJ,CAAC,CACF;KACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"terminate-qurl-sessions.js","sourceRoot":"","sources":["../../src/tools/terminate-qurl-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,oBAAoB,CAAC,wBAAwB,CAAC;IAC3D,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,2FAA2F,CAC5F;CACJ,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CACvC,MAAmB,EACnB,WAA+B,EAAE,IAAI,EAAE,OAAO,EAAE;IAEhD,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,wDAAwD;YACxD,0IAA0I;YAC1I,gHAAgH;YAChH,iGAAiG;YACjG,gGAAgG;QAClG,WAAW,EAAE,2BAA2B;QACxC,YAAY,EAAE,iCAAiC;QAC/C,WAAW,EAAE;YACX,KAAK,EAAE,yBAAyB;YAChC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAC/B,KAAK,EAAE,KAAkD,EAAE,EAAE;YAC3D,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,MAAM,CAAC,wBAAwB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC3E,MAAM,OAAO,GAAG;oBACd,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,+DAA+D;oBAC/D,kEAAkE;oBAClE,mEAAmE;oBACnE,kEAAkE;oBAClE,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE,gBAAgB,KAAK,CAAC,UAAU,iBAAiB;iBAC3D,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;oBACnE,iBAAiB,EAAE,mBAAmB,CAAC,OAAO,CAAC;iBAChD,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC5E,wEAAwE;YACxE,8DAA8D;YAC9D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC;YAC3C,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,IAAI,YAAY,CACpB,GAAG,EACH,kBAAkB,EAClB,4DAA4D,CAC7D,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG;gBACd,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,UAAU;gBACV,OAAO,EAAE,cAAc,UAAU,mBAAmB;aACrD,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnE,iBAAiB,EAAE,mBAAmB,CAAC,OAAO,CAAC;aAChD,CAAC;QACJ,CAAC,CACF;KACF,CAAC;AACJ,CAAC"}
@@ -1,5 +1,6 @@
1
1
  import { z } from "zod";
2
2
  import type { IQURLClient } from "../client.js";
3
+ import { type ToolRuntimeOptions } from "./_shared.js";
3
4
  export declare const updateQurlTokenBaseSchema: z.ZodObject<{
4
5
  resource_id: z.ZodString;
5
6
  qurl_id: z.ZodString;
@@ -44,7 +45,7 @@ export declare const updateQurlTokenSchema: z.ZodObject<{
44
45
  max_sessions: z.ZodOptional<z.ZodNumber>;
45
46
  session_duration: z.ZodOptional<z.ZodString>;
46
47
  }, z.core.$strip>;
47
- export declare function updateQurlTokenTool(client: IQURLClient): {
48
+ export declare function updateQurlTokenTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
48
49
  name: string;
49
50
  title: string;
50
51
  description: string;
@@ -96,11 +97,11 @@ export declare function updateQurlTokenTool(client: IQURLClient): {
96
97
  block_all: z.ZodOptional<z.ZodBoolean>;
97
98
  deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
98
99
  allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
99
- }, z.core.$strip>>;
100
- }, z.core.$strip>>;
100
+ }, z.core.$loose>>;
101
+ }, z.core.$loose>>;
101
102
  created_at: z.ZodOptional<z.ZodString>;
102
103
  expires_at: z.ZodOptional<z.ZodString>;
103
- }, z.core.$strip>;
104
+ }, z.core.$loose>;
104
105
  annotations: {
105
106
  title: string;
106
107
  readOnlyHint: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"update-qurl-token.d.ts","sourceRoot":"","sources":["../../src/tools/update-qurl-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAWhD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBA8BpC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;iBAgB/B,CAAC;AAEJ,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BtD"}
1
+ {"version":3,"file":"update-qurl-token.d.ts","sourceRoot":"","sources":["../../src/tools/update-qurl-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBA4BpC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;iBAgB/B,CAAC;AAEJ,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BjD"}
@@ -1,18 +1,17 @@
1
1
  import { z } from "zod";
2
2
  import { accessPolicySchema } from "./create-qurl.js";
3
+ import { durationSchema, MAX_EXPIRY_MS, MAX_SESSION_MS, MIN_EXPIRY_MS, MIN_SESSION_MS, } from "./duration.js";
3
4
  import { qurlDisplayIdSchema, resourceOnlyIdSchema, toStructuredContent, withMissingApiKeyHandler, zodErrorToToolResult, } from "./_shared.js";
4
5
  import { updateQurlTokenOutputSchema } from "./output-schemas.js";
5
6
  export const updateQurlTokenBaseSchema = z.object({
6
7
  resource_id: resourceOnlyIdSchema("update a specific qURL token under"),
7
8
  qurl_id: qurlDisplayIdSchema("update"),
8
- extend_by: z
9
- .string()
10
- .min(1)
9
+ extend_by: durationSchema(MIN_EXPIRY_MS, MAX_EXPIRY_MS, "1m to 30d")
11
10
  .optional()
12
- .describe('Duration to extend this token by (e.g., "24h", "7d"). Mutually exclusive with expires_at.'),
11
+ .describe('Duration to extend this token by (e.g., "24h", "7d"; 1m to 30d per call). Mutually exclusive with expires_at.'),
13
12
  expires_at: z
14
13
  .string()
15
- .datetime()
14
+ .datetime({ offset: true })
16
15
  .optional()
17
16
  .describe("Absolute token expiration timestamp (RFC 3339). Mutually exclusive with extend_by."),
18
17
  label: z.string().max(500).optional().describe("Human-readable label for this token"),
@@ -24,10 +23,10 @@ export const updateQurlTokenBaseSchema = z.object({
24
23
  .max(1000)
25
24
  .optional()
26
25
  .describe("Maximum concurrent sessions for this token (0 = unlimited, max 1000)"),
27
- session_duration: z
28
- .string()
26
+ // "" keeps its meaning (apply the parent resource cap); anything else is a bounded duration.
27
+ session_duration: durationSchema(MIN_SESSION_MS, MAX_SESSION_MS, "1s to 24h", true)
29
28
  .optional()
30
- .describe('How long access lasts after clicking (e.g., "1h"). Empty string applies the parent resource cap when one is set.'),
29
+ .describe('How long access lasts after clicking (e.g., "1h"; 1s to 24h). Empty string applies the parent resource cap when one is set.'),
31
30
  });
32
31
  export const updateQurlTokenSchema = updateQurlTokenBaseSchema
33
32
  .refine((data) => !(data.extend_by && data.expires_at), {
@@ -41,7 +40,7 @@ export const updateQurlTokenSchema = updateQurlTokenBaseSchema
41
40
  data.session_duration !== undefined, {
42
41
  message: "At least one update field (extend_by, expires_at, label, access_policy, max_sessions, or session_duration) is required",
43
42
  });
44
- export function updateQurlTokenTool(client) {
43
+ export function updateQurlTokenTool(client, _runtime = { mode: "stdio" }) {
45
44
  return {
46
45
  name: "update_qurl_token",
47
46
  title: "Update qURL Token",
@@ -1 +1 @@
1
- {"version":3,"file":"update-qurl-token.js","sourceRoot":"","sources":["../../src/tools/update-qurl-token.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"update-qurl-token.js","sourceRoot":"","sources":["../../src/tools/update-qurl-token.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  import { z } from "zod";
2
2
  import type { IQURLClient } from "../client.js";
3
+ import { type ToolRuntimeOptions } from "./_shared.js";
3
4
  export declare const updateQurlBaseSchema: z.ZodObject<{
4
5
  resource_id: z.ZodString;
5
6
  extend_by: z.ZodOptional<z.ZodString>;
@@ -18,7 +19,7 @@ export declare const updateQurlSchema: z.ZodObject<{
18
19
  custom_domain: z.ZodOptional<z.ZodString>;
19
20
  preserve_host: z.ZodOptional<z.ZodBoolean>;
20
21
  }, z.core.$strip>;
21
- export declare function updateQurlTool(client: IQURLClient): {
22
+ export declare function updateQurlTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
22
23
  name: string;
23
24
  title: string;
24
25
  description: string;
@@ -32,6 +33,13 @@ export declare function updateQurlTool(client: IQURLClient): {
32
33
  preserve_host: z.ZodOptional<z.ZodBoolean>;
33
34
  }, z.core.$strip>;
34
35
  outputSchema: z.ZodObject<{
36
+ crid: z.ZodOptional<z.ZodString>;
37
+ private: z.ZodOptional<z.ZodBoolean>;
38
+ consumer_access: z.ZodOptional<z.ZodObject<{
39
+ mode: z.ZodString;
40
+ version: z.ZodOptional<z.ZodNumber>;
41
+ contract_id: z.ZodOptional<z.ZodString>;
42
+ }, z.core.$strip>>;
35
43
  resource_id: z.ZodString;
36
44
  qurl_site: z.ZodOptional<z.ZodString>;
37
45
  target_url: z.ZodOptional<z.ZodString>;
@@ -75,12 +83,12 @@ export declare function updateQurlTool(client: IQURLClient): {
75
83
  block_all: z.ZodOptional<z.ZodBoolean>;
76
84
  deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
77
85
  allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
78
- }, z.core.$strip>>;
79
- }, z.core.$strip>>;
86
+ }, z.core.$loose>>;
87
+ }, z.core.$loose>>;
80
88
  created_at: z.ZodOptional<z.ZodString>;
81
89
  expires_at: z.ZodOptional<z.ZodString>;
82
- }, z.core.$strip>>>;
83
- }, z.core.$strip>;
90
+ }, z.core.$loose>>>;
91
+ }, z.core.$loose>;
84
92
  annotations: {
85
93
  title: string;
86
94
  readOnlyHint: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"update-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/update-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAwC,MAAM,cAAc,CAAC;AAqBtF,eAAO,MAAM,oBAAoB;;;;;;;;iBAqC/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;iBA4B1B,CAAC;AAEJ,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CjD"}
1
+ {"version":3,"file":"update-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/update-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAwC,MAAM,cAAc,CAAC;AAEtF,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAetB,eAAO,MAAM,oBAAoB;;;;;;;;iBAqC/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;iBA6B1B,CAAC;AAEJ,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CjD"}
@@ -1,4 +1,5 @@
1
1
  import { z } from "zod";
2
+ import { durationSchema, MAX_EXPIRY_MS, MIN_EXPIRY_MS } from "./duration.js";
2
3
  import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler, zodErrorToToolResult, } from "./_shared.js";
3
4
  import { updateQurlOutputSchema } from "./output-schemas.js";
4
5
  // Tags must match the API constraints: 1-50 chars, start with alphanumeric,
@@ -11,14 +12,12 @@ const tagSchema = z
11
12
  .regex(/^[a-zA-Z0-9][a-zA-Z0-9 _-]*$/, "Tag must start with alphanumeric and contain only letters, numbers, spaces, underscores, or hyphens");
12
13
  export const updateQurlBaseSchema = z.object({
13
14
  resource_id: resourceIdSchema("update"),
14
- extend_by: z
15
- .string()
16
- .min(1)
15
+ extend_by: durationSchema(MIN_EXPIRY_MS, MAX_EXPIRY_MS, "1m to 30d")
17
16
  .optional()
18
- .describe('Duration to extend by (e.g., "24h", "7d"). Mutually exclusive with expires_at.'),
17
+ .describe('Duration to extend by (e.g., "24h", "7d"; 1m to 30d per call; use expires_at for longer). Mutually exclusive with expires_at.'),
19
18
  expires_at: z
20
19
  .string()
21
- .datetime()
20
+ .datetime({ offset: true })
22
21
  .optional()
23
22
  .describe("Absolute expiration timestamp (RFC 3339). Mutually exclusive with extend_by."),
24
23
  tags: z
@@ -51,7 +50,7 @@ export const updateQurlSchema = updateQurlBaseSchema
51
50
  message: "custom_domain and preserve_host use the resource endpoint and cannot be combined with extend_by or expires_at in one update",
52
51
  })
53
52
  .refine((data) => !(hasResourceEndpointUpdate(data) && data.resource_id.startsWith("q_")), {
54
- message: "custom_domain and preserve_host updates require an r_ resource ID",
53
+ message: "custom_domain and preserve_host updates require a resource identifier (public key, CRID, or legacy r_ ID)",
55
54
  })
56
55
  .refine(
57
56
  // Use `!== undefined` rather than truthy checks so the API's "clear"
@@ -67,17 +66,17 @@ export const updateQurlSchema = updateQurlBaseSchema
67
66
  data.preserve_host !== undefined, {
68
67
  message: "At least one update field (extend_by, expires_at, tags, description, custom_domain, or preserve_host) is required",
69
68
  });
70
- export function updateQurlTool(client) {
69
+ export function updateQurlTool(client, _runtime = { mode: "stdio" }) {
71
70
  return {
72
71
  name: "update_qurl",
73
72
  title: "Update qURL",
74
- description: "Update a qURL's expiration, tags, description, custom domain, or proxy host-header behavior. The richer alternative to `extend_qurl` — use `update_qurl` whenever you need anything beyond a relative time push. " +
75
- "Accepts both `r_` and `q_` IDs for expiration, tags, and description updates (q_ is auto-resolved); custom domain and preserve_host updates require an `r_` resource ID because the qURL API now serves them from `PATCH /v1/resources/{id}`. " +
73
+ description: "Update a qURL resource's expiration ceiling, tags, description, custom domain, or proxy host-header behavior. " +
74
+ "`extend_by`/`expires_at` here move the resource's own expiry, which does not keep an individual link open longer; use `extend_qurl` or `update_qurl_token` to change a link's expiry. " +
75
+ "Accepts resource public keys, CRIDs, legacy `r_` IDs, and `q_` display IDs for expiration, tags, and description updates (q_ is auto-resolved); custom domain and preserve_host updates require a resource identifier (public key, CRID, or legacy `r_` ID) because the qURL API now serves them from `PATCH /v1/resources/{id}`. " +
76
76
  "**Constraints:** `extend_by` and `expires_at` are mutually exclusive; `custom_domain`/`preserve_host` cannot be combined with expiration changes in one call; at least one update field (`extend_by`, `expires_at`, `tags`, `description`, `custom_domain`, `preserve_host`) must be set. " +
77
77
  '**Clearing fields:** pass `description: ""`, `tags: []`, or `custom_domain: ""` to clear those fields explicitly. ' +
78
- "Use `extend_qurl` when the only change is a relative time push. " +
79
78
  "Use `delete_qurl` when you want to revoke entirely. " +
80
- "**Errors:** if the input fails schema refinements (both extend_by + expires_at, or no fields set), the handler returns an `isError: true` content block before any API call. Other API errors throw with the API's `code`/`statusCode`. " +
79
+ "**Errors:** a malformed or out-of-range `extend_by` is rejected by input validation; if the input fails schema refinements (both extend_by + expires_at, or no fields set), the handler returns an `isError: true` content block. Both happen before any API call. Other API errors throw with the API's `code`/`statusCode`. " +
81
80
  "Returns the updated resource (same shape as `get_qurl`).",
82
81
  // Base shape for MCP tool registration; refinements run in the handler
83
82
  inputSchema: updateQurlBaseSchema,
@@ -1 +1 @@
1
- {"version":3,"file":"update-qurl.js","sourceRoot":"","sources":["../../src/tools/update-qurl.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"update-qurl.js","sourceRoot":"","sources":["../../src/tools/update-qurl.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,138 @@
1
+ import { z } from "zod";
2
+ import type { IQURLClient } from "../client.js";
3
+ import { type ToolRuntimeOptions } from "./_shared.js";
4
+ export declare function maxBase64CharactersForBytes(maxBytes: number): number;
5
+ export declare const MAX_UPLOAD_FILE_BASE64_CHARACTERS: number;
6
+ export declare function createUploadFileDataQurlSchema(maxBase64Characters?: number): z.ZodObject<{
7
+ file_base64: z.ZodString;
8
+ file_name: z.ZodString;
9
+ content_type: z.ZodEnum<{
10
+ "application/pdf": "application/pdf";
11
+ "image/gif": "image/gif";
12
+ "image/jpeg": "image/jpeg";
13
+ "image/png": "image/png";
14
+ "image/webp": "image/webp";
15
+ }>;
16
+ email_delivery: z.ZodOptional<z.ZodObject<{
17
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
18
+ subject: z.ZodOptional<z.ZodString>;
19
+ message: z.ZodOptional<z.ZodString>;
20
+ }, z.core.$strip>>;
21
+ label: z.ZodOptional<z.ZodString>;
22
+ expires_in: z.ZodOptional<z.ZodString>;
23
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
24
+ session_duration: z.ZodOptional<z.ZodString>;
25
+ max_sessions: z.ZodOptional<z.ZodNull>;
26
+ access_policy: z.ZodOptional<z.ZodNull>;
27
+ }, z.core.$strip>;
28
+ export declare const uploadFileDataQurlSchema: z.ZodObject<{
29
+ file_base64: z.ZodString;
30
+ file_name: z.ZodString;
31
+ content_type: z.ZodEnum<{
32
+ "application/pdf": "application/pdf";
33
+ "image/gif": "image/gif";
34
+ "image/jpeg": "image/jpeg";
35
+ "image/png": "image/png";
36
+ "image/webp": "image/webp";
37
+ }>;
38
+ email_delivery: z.ZodOptional<z.ZodObject<{
39
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
40
+ subject: z.ZodOptional<z.ZodString>;
41
+ message: z.ZodOptional<z.ZodString>;
42
+ }, z.core.$strip>>;
43
+ label: z.ZodOptional<z.ZodString>;
44
+ expires_in: z.ZodOptional<z.ZodString>;
45
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
46
+ session_duration: z.ZodOptional<z.ZodString>;
47
+ max_sessions: z.ZodOptional<z.ZodNull>;
48
+ access_policy: z.ZodOptional<z.ZodNull>;
49
+ }, z.core.$strip>;
50
+ export declare function uploadFileDataQurlTool(_client: IQURLClient, runtime: ToolRuntimeOptions): {
51
+ name: string;
52
+ title: string;
53
+ description: string;
54
+ inputSchema: z.ZodObject<{
55
+ file_base64: z.ZodString;
56
+ file_name: z.ZodString;
57
+ content_type: z.ZodEnum<{
58
+ "application/pdf": "application/pdf";
59
+ "image/gif": "image/gif";
60
+ "image/jpeg": "image/jpeg";
61
+ "image/png": "image/png";
62
+ "image/webp": "image/webp";
63
+ }>;
64
+ email_delivery: z.ZodOptional<z.ZodObject<{
65
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
66
+ subject: z.ZodOptional<z.ZodString>;
67
+ message: z.ZodOptional<z.ZodString>;
68
+ }, z.core.$strip>>;
69
+ label: z.ZodOptional<z.ZodString>;
70
+ expires_in: z.ZodOptional<z.ZodString>;
71
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
72
+ session_duration: z.ZodOptional<z.ZodString>;
73
+ max_sessions: z.ZodOptional<z.ZodNull>;
74
+ access_policy: z.ZodOptional<z.ZodNull>;
75
+ }, z.core.$strip>;
76
+ outputSchema: z.ZodObject<{
77
+ resource_id: z.ZodString;
78
+ qurl_id: z.ZodOptional<z.ZodString>;
79
+ qurl_link: z.ZodString;
80
+ expires_at: z.ZodOptional<z.ZodString>;
81
+ requested_expires_at: z.ZodOptional<z.ZodString>;
82
+ expires_at_differs_from_request: z.ZodOptional<z.ZodBoolean>;
83
+ expires_at_later_than_requested: z.ZodOptional<z.ZodBoolean>;
84
+ expires_at_already_past: z.ZodOptional<z.ZodBoolean>;
85
+ expires_at_unconfirmed: z.ZodOptional<z.ZodBoolean>;
86
+ unexpected_extra_link_count: z.ZodOptional<z.ZodNumber>;
87
+ unexpected_extra_qurl_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
88
+ file_name: z.ZodString;
89
+ content_type: z.ZodString;
90
+ size_bytes: z.ZodNumber;
91
+ email_delivery: z.ZodOptional<z.ZodObject<{
92
+ attempted: z.ZodBoolean;
93
+ enabled: z.ZodBoolean;
94
+ recipients: z.ZodArray<z.ZodString>;
95
+ sent: z.ZodNumber;
96
+ failed: z.ZodNumber;
97
+ skipped_reason: z.ZodOptional<z.ZodString>;
98
+ results: z.ZodArray<z.ZodObject<{
99
+ email: z.ZodString;
100
+ success: z.ZodBoolean;
101
+ skipped: z.ZodBoolean;
102
+ error: z.ZodOptional<z.ZodString>;
103
+ message_id: z.ZodOptional<z.ZodString>;
104
+ }, z.core.$strip>>;
105
+ }, z.core.$strip>>;
106
+ }, z.core.$loose>;
107
+ annotations: {
108
+ title: string;
109
+ readOnlyHint: boolean;
110
+ destructiveHint: boolean;
111
+ idempotentHint: boolean;
112
+ openWorldHint: boolean;
113
+ };
114
+ handler: (input: {
115
+ file_base64: string;
116
+ file_name: string;
117
+ content_type: "application/pdf" | "image/gif" | "image/jpeg" | "image/png" | "image/webp";
118
+ email_delivery?: {
119
+ to: string[];
120
+ subject?: string | undefined;
121
+ message?: string | undefined;
122
+ } | undefined;
123
+ label?: string | undefined;
124
+ expires_in?: string | undefined;
125
+ one_time_use?: boolean | undefined;
126
+ session_duration?: string | undefined;
127
+ max_sessions?: null | undefined;
128
+ access_policy?: null | undefined;
129
+ }) => Promise<{
130
+ content: Array<{
131
+ type: "text";
132
+ text: string;
133
+ }>;
134
+ structuredContent?: Record<string, unknown>;
135
+ isError?: boolean;
136
+ }>;
137
+ };
138
+ //# sourceMappingURL=upload-file-data-qurl.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-file-data-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/upload-file-data-qurl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAkCtB,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,eAAO,MAAM,iCAAiC,QAE7C,CAAC;AAEF,wBAAgB,8BAA8B,CAC5C,mBAAmB,SAAoC;;;;;;;;;;;;;;;;;;;;;kBA8BxD;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;iBAAmC,CAAC;AA2HzE,wBAAgB,sBAAsB,CAEpC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoF5B"}
@@ -0,0 +1,207 @@
1
+ import { Buffer } from "node:buffer";
2
+ import { z } from "zod";
3
+ import { MAX_UPLOAD_FILE_DATA_BYTES } from "../config.js";
4
+ import { allowsServerApiKeyFallback, withMissingApiKeyHandler, } from "./_shared.js";
5
+ import { emailDeliveryInputSchema, maybeDeliverToolEmail, toEmailAugmentedResult, uploadEmailDetailLines, } from "./email-delivery.js";
6
+ import { getConnectorConfig, getMaxUploadFileBytes, mintUploadedFile, normalizeFileName, supportedMimeTypes, uploadToConnector, validateFileNameContentType, validateFileSignature, } from "./upload-file-shared.js";
7
+ import { uploadFileQurlOutputSchema } from "./output-schemas.js";
8
+ import { uploadMintOptionsShape, uploadMintOptionsSchema, UPLOAD_LINK_DESCRIPTION, UPLOAD_RETURNS_DESCRIPTION, } from "./upload-mint-options.js";
9
+ // Uploads pass three deliberate bounds: a runtime-derived raw-string schema
10
+ // ceiling, the HTTP JSON-body limit before tool dispatch, and
11
+ // getMaxUploadFileBytes on the normalized decoded payload. The exported schema
12
+ // uses the protocol-wide 100 MB hard maximum for direct consumers; registered
13
+ // tools advertise the operator's configured decoded-byte limit. HTTP only opens
14
+ // a parser ceiling above the 10 MB default for a session already validated by a
15
+ // successful downstream qURL API call (see createHttpRuntime).
16
+ const MAX_DATA_URL_PREFIX_CHARACTERS = 1024;
17
+ export function maxBase64CharactersForBytes(maxBytes) {
18
+ return Math.ceil((maxBytes * 4) / 3) + MAX_DATA_URL_PREFIX_CHARACTERS;
19
+ }
20
+ export const MAX_UPLOAD_FILE_BASE64_CHARACTERS = maxBase64CharactersForBytes(MAX_UPLOAD_FILE_DATA_BYTES);
21
+ export function createUploadFileDataQurlSchema(maxBase64Characters = MAX_UPLOAD_FILE_BASE64_CHARACTERS) {
22
+ return z
23
+ .object({
24
+ file_base64: z
25
+ .string()
26
+ .min(1)
27
+ .max(maxBase64Characters)
28
+ .describe("Base64-encoded PDF or raster image content. Raw base64 and data URLs are both accepted. For compressible images, compress them first and then convert them to base64 before calling this tool."),
29
+ file_name: z
30
+ .string()
31
+ .min(1)
32
+ .max(255)
33
+ .describe("Filename to register with the connector. `.jpg` and `.jpeg` files should use `image/jpeg`."),
34
+ content_type: z
35
+ .enum(supportedMimeTypes)
36
+ .describe("MIME type for the uploaded file. Supported: application/pdf, image/png, image/jpeg, image/webp, image/gif."),
37
+ email_delivery: emailDeliveryInputSchema
38
+ .optional()
39
+ .describe("Optional email notification settings for sending the uploaded file's qURL to one or more recipients."),
40
+ })
41
+ .extend(uploadMintOptionsShape);
42
+ }
43
+ export const uploadFileDataQurlSchema = createUploadFileDataQurlSchema();
44
+ /**
45
+ * Normalize and validate base64 input for file upload.
46
+ *
47
+ * Accepts multiple input formats:
48
+ * - Raw base64: "SGVsbG8gV29ybGQ="
49
+ * - Data URL: "data:image/png;base64,iVBORw0KGgo..."
50
+ * - Base64 with whitespace (e.g., line breaks from copy-paste)
51
+ * - URL-safe base64 (uses - and _ instead of + and /)
52
+ *
53
+ * @param input - Raw base64 string or data URL
54
+ * @returns Normalized standard base64 and the data URL media type, when present
55
+ * @throws Error if input is empty or contains invalid base64 characters
56
+ */
57
+ function normalizeBase64Input(input) {
58
+ const trimmed = input.trim();
59
+ if (!trimmed) {
60
+ throw new Error("file_base64 must not be empty");
61
+ }
62
+ // Step 1: Parse and strip the data URL prefix if present (e.g.,
63
+ // "data:image/png;base64,"). Return its media type so callers do not need
64
+ // to parse the same prefix again. Bound the regex probe independently of
65
+ // the payload ceiling so even a very large hostile string cannot make
66
+ // prefix parsing scale with the file body.
67
+ const dataUrlPrefixProbe = trimmed.slice(0, MAX_DATA_URL_PREFIX_CHARACTERS);
68
+ const dataUrl = /^data:([^;,]*)(?:;[a-z0-9!#$&^_.+-]+=[^;,\s]*)*;base64,/i.exec(dataUrlPrefixProbe);
69
+ if (!dataUrl && trimmed.toLowerCase().startsWith("data:")) {
70
+ throw new Error("Only base64-encoded data URLs are supported.");
71
+ }
72
+ const withoutDataUrl = dataUrl ? trimmed.slice(dataUrl[0].length) : trimmed;
73
+ // Step 2: Remove whitespace (base64 from copy-paste often has line breaks)
74
+ const withoutWhitespace = withoutDataUrl.replace(/\s+/g, "");
75
+ if (!withoutWhitespace) {
76
+ throw new Error("file_base64 must not be empty");
77
+ }
78
+ // Step 3: Accept either the standard or URL-safe alphabet, but reject a
79
+ // mixed alphabet because no conforming encoder emits that representation.
80
+ const usesStandardAlphabet = /^[A-Za-z0-9+/]*={0,2}$/.test(withoutWhitespace);
81
+ const usesUrlSafeAlphabet = !usesStandardAlphabet && /^[A-Za-z0-9_-]*={0,2}$/.test(withoutWhitespace);
82
+ if (!usesStandardAlphabet && !usesUrlSafeAlphabet) {
83
+ throw new Error("file_base64 must be valid base64-encoded content");
84
+ }
85
+ // Step 4: Convert URL-safe base64 to standard base64. URL-safe uses '-'
86
+ // instead of '+' and '_' instead of '/'.
87
+ const normalized = usesStandardAlphabet
88
+ ? withoutWhitespace
89
+ : withoutWhitespace.replace(/-/g, "+").replace(/_/g, "/");
90
+ // Step 5: Validate and fix padding
91
+ // Base64 length must be divisible by 4. Valid lengths mod 4 are: 0, 2, 3
92
+ // Length mod 4 = 1 is always invalid (would represent 6 bits, not enough for a byte)
93
+ const paddingNeeded = normalized.length % 4;
94
+ if (paddingNeeded === 1) {
95
+ throw new Error("file_base64 must be valid base64-encoded content");
96
+ }
97
+ const dataUrlContentType = dataUrl?.[1] ? dataUrl[1].toLowerCase() : undefined;
98
+ // Already properly padded
99
+ if (paddingNeeded === 0) {
100
+ return { base64: normalized, dataUrlContentType };
101
+ }
102
+ // Add missing padding (mod 4 = 2 needs "==", mod 4 = 3 needs "=")
103
+ return {
104
+ base64: normalized.padEnd(normalized.length + (4 - paddingNeeded), "="),
105
+ dataUrlContentType,
106
+ };
107
+ }
108
+ function decodeBase64File(input, maxBytes, contentType) {
109
+ const tooLargeMessage = "Decoded file exceeds the allowed upload size. Reduce the file size and try again.";
110
+ const encodedCharacterLimit = Math.ceil((maxBytes * 4) / 3);
111
+ // Allow normal MIME line wrapping plus a bounded data-URL prefix, but reject
112
+ // runtime-oversized strings before trim/replace normalization copies them.
113
+ const rawCharacterLimit = encodedCharacterLimit + Math.ceil(encodedCharacterLimit / 4) + MAX_DATA_URL_PREFIX_CHARACTERS;
114
+ if (input.length > rawCharacterLimit) {
115
+ throw new Error(tooLargeMessage);
116
+ }
117
+ const normalized = normalizeBase64Input(input);
118
+ if (normalized.dataUrlContentType && normalized.dataUrlContentType !== contentType) {
119
+ throw new Error("Data URL media type does not match content_type.");
120
+ }
121
+ const paddingBytes = normalized.base64.endsWith("==")
122
+ ? 2
123
+ : normalized.base64.endsWith("=")
124
+ ? 1
125
+ : 0;
126
+ const decodedByteLength = (normalized.base64.length / 4) * 3 - paddingBytes;
127
+ if (decodedByteLength > maxBytes) {
128
+ throw new Error(tooLargeMessage);
129
+ }
130
+ const fileData = Buffer.from(normalized.base64, "base64");
131
+ if (fileData.byteLength === 0) {
132
+ throw new Error("file_base64 decoded to an empty file");
133
+ }
134
+ // Keep an actual-byte check after the pre-allocation estimate so decoder or
135
+ // normalization behavior cannot silently weaken the configured limit.
136
+ if (fileData.byteLength > maxBytes) {
137
+ throw new Error(tooLargeMessage);
138
+ }
139
+ validateFileSignature(fileData, contentType);
140
+ return fileData;
141
+ }
142
+ export function uploadFileDataQurlTool(
143
+ // Unused since links are minted by the connector; kept for the shared tool factory signature.
144
+ _client, runtime) {
145
+ const inputSchema = createUploadFileDataQurlSchema(runtime.maxUploadFileDataBytes === undefined
146
+ ? MAX_UPLOAD_FILE_BASE64_CHARACTERS
147
+ : maxBase64CharactersForBytes(runtime.maxUploadFileDataBytes));
148
+ return {
149
+ name: "upload_file_data_qurl",
150
+ title: "Upload File Data qURL",
151
+ description: "Upload base64-encoded PDF or raster image content to a qURL connector, then mint an access link for it. " +
152
+ "This is the correct tool for a single in-chat image, PDF, or file attachment in either MCP transport, especially when the user wants 'the qURL of this image/file' or wants the generated link emailed. " +
153
+ "Use this when you have the file data available but cannot provide a server-local file path. " +
154
+ "Use `upload_file_qurl` when the file already exists on the MCP server host, use `create_qurl` when you already have a URL. Each call uploads the file again and returns one new link; `mint_link` cannot re-link an uploaded file. " +
155
+ "For compressible images, compress them before converting to base64 so the request is smaller and more reliable. " +
156
+ "When the server upload limit is configured above 10 MB, a fresh HTTP session must complete a smaller qURL API call (e.g. `list_qurls`) before its first larger upload; a smaller completed upload also counts. " +
157
+ "The tool decodes `file_base64`, uploads the file to `${QURL_CONNECTOR_URL}/api/upload`, then mints the link through `${QURL_CONNECTOR_URL}/api/mint_link/:resource_id`. " +
158
+ UPLOAD_LINK_DESCRIPTION +
159
+ "Supported MIME types are application/pdf, image/png, image/jpeg, image/webp, and image/gif. " +
160
+ "If `one_time_use` is omitted, the tool defaults it to `true` for safer file distribution. " +
161
+ "Requires `QURL_CONNECTOR_URL`; stdio reads `QURL_API_KEY` from server config, while HTTP uses the caller's bearer credential. " +
162
+ UPLOAD_RETURNS_DESCRIPTION,
163
+ inputSchema,
164
+ outputSchema: uploadFileQurlOutputSchema,
165
+ annotations: {
166
+ title: "Upload File Data qURL",
167
+ readOnlyHint: false,
168
+ destructiveHint: false,
169
+ idempotentHint: false,
170
+ openWorldHint: true,
171
+ },
172
+ handler: withMissingApiKeyHandler(async (input) => {
173
+ uploadMintOptionsSchema.parse(input);
174
+ const allowServerApiKeyFallback = allowsServerApiKeyFallback(runtime);
175
+ // Preflight connector config before decoding payloads so auth/config errors fail fast.
176
+ const connectorConfig = getConnectorConfig(allowServerApiKeyFallback);
177
+ const fileName = normalizeFileName(input.file_name);
178
+ validateFileNameContentType(fileName, input.content_type);
179
+ const fileData = decodeBase64File(input.file_base64, getMaxUploadFileBytes(), input.content_type);
180
+ const upload = await uploadToConnector(fileData, fileName, input.content_type, connectorConfig);
181
+ const result = await mintUploadedFile(connectorConfig, upload.resource_id, {
182
+ name: fileName,
183
+ contentType: input.content_type,
184
+ sizeBytes: fileData.byteLength,
185
+ }, {
186
+ expires_in: input.expires_in,
187
+ one_time_use: input.one_time_use,
188
+ session_duration: input.session_duration,
189
+ });
190
+ const emailResult = await maybeDeliverToolEmail({
191
+ allowServerApiKeyFallback,
192
+ delivery: input.email_delivery,
193
+ defaultSubject: "Your secure file access link is ready",
194
+ detailLines: uploadEmailDetailLines({
195
+ intro: "A secure qURL file link has been created for you.",
196
+ fileName,
197
+ contentType: input.content_type,
198
+ qurlLink: result.qurl_link,
199
+ expiresAt: result.expires_at,
200
+ label: input.label,
201
+ }),
202
+ });
203
+ return toEmailAugmentedResult(result, emailResult);
204
+ }),
205
+ };
206
+ }
207
+ //# sourceMappingURL=upload-file-data-qurl.js.map