@layervai/qurl-mcp 0.4.1 → 0.5.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 (169) hide show
  1. package/README.md +742 -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 +1 -1
  14. package/dist/client.d.ts.map +1 -1
  15. package/dist/client.js +15 -4
  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/server.d.ts +12 -4
  58. package/dist/server.d.ts.map +1 -1
  59. package/dist/server.js +33 -8
  60. package/dist/server.js.map +1 -1
  61. package/dist/services/email.d.ts +17 -0
  62. package/dist/services/email.d.ts.map +1 -0
  63. package/dist/services/email.js +351 -0
  64. package/dist/services/email.js.map +1 -0
  65. package/dist/services/html.d.ts +5 -0
  66. package/dist/services/html.d.ts.map +1 -0
  67. package/dist/services/html.js +28 -0
  68. package/dist/services/html.js.map +1 -0
  69. package/dist/services/legal-pages.d.ts +12 -0
  70. package/dist/services/legal-pages.d.ts.map +1 -0
  71. package/dist/services/legal-pages.js +588 -0
  72. package/dist/services/legal-pages.js.map +1 -0
  73. package/dist/services/text-pdf.d.ts +16 -0
  74. package/dist/services/text-pdf.d.ts.map +1 -0
  75. package/dist/services/text-pdf.js +141 -0
  76. package/dist/services/text-pdf.js.map +1 -0
  77. package/dist/services/video-page.d.ts +4 -0
  78. package/dist/services/video-page.d.ts.map +1 -0
  79. package/dist/services/video-page.js +311 -0
  80. package/dist/services/video-page.js.map +1 -0
  81. package/dist/text.d.ts +4 -0
  82. package/dist/text.d.ts.map +1 -0
  83. package/dist/text.js +16 -0
  84. package/dist/text.js.map +1 -0
  85. package/dist/tools/_shared.d.ts +9 -1
  86. package/dist/tools/_shared.d.ts.map +1 -1
  87. package/dist/tools/_shared.js +20 -8
  88. package/dist/tools/_shared.js.map +1 -1
  89. package/dist/tools/batch-create.d.ts +12 -11
  90. package/dist/tools/batch-create.d.ts.map +1 -1
  91. package/dist/tools/batch-create.js +6 -4
  92. package/dist/tools/batch-create.js.map +1 -1
  93. package/dist/tools/create-qurl.d.ts +43 -4
  94. package/dist/tools/create-qurl.d.ts.map +1 -1
  95. package/dist/tools/create-qurl.js +63 -30
  96. package/dist/tools/create-qurl.js.map +1 -1
  97. package/dist/tools/delete-qurl.d.ts +3 -2
  98. package/dist/tools/delete-qurl.d.ts.map +1 -1
  99. package/dist/tools/delete-qurl.js +3 -10
  100. package/dist/tools/delete-qurl.js.map +1 -1
  101. package/dist/tools/email-delivery.d.ts +37 -0
  102. package/dist/tools/email-delivery.d.ts.map +1 -0
  103. package/dist/tools/email-delivery.js +115 -0
  104. package/dist/tools/email-delivery.js.map +1 -0
  105. package/dist/tools/extend-qurl.d.ts +6 -5
  106. package/dist/tools/extend-qurl.d.ts.map +1 -1
  107. package/dist/tools/extend-qurl.js +3 -3
  108. package/dist/tools/extend-qurl.js.map +1 -1
  109. package/dist/tools/get-qurl.d.ts +6 -5
  110. package/dist/tools/get-qurl.d.ts.map +1 -1
  111. package/dist/tools/get-qurl.js +5 -3
  112. package/dist/tools/get-qurl.js.map +1 -1
  113. package/dist/tools/list-qurl-sessions.d.ts +5 -4
  114. package/dist/tools/list-qurl-sessions.d.ts.map +1 -1
  115. package/dist/tools/list-qurl-sessions.js +2 -2
  116. package/dist/tools/list-qurl-sessions.js.map +1 -1
  117. package/dist/tools/list-qurls.d.ts +8 -7
  118. package/dist/tools/list-qurls.d.ts.map +1 -1
  119. package/dist/tools/list-qurls.js +9 -7
  120. package/dist/tools/list-qurls.js.map +1 -1
  121. package/dist/tools/mint-link.d.ts +39 -3
  122. package/dist/tools/mint-link.d.ts.map +1 -1
  123. package/dist/tools/mint-link.js +24 -13
  124. package/dist/tools/mint-link.js.map +1 -1
  125. package/dist/tools/output-schemas.d.ts +102 -45
  126. package/dist/tools/output-schemas.d.ts.map +1 -1
  127. package/dist/tools/output-schemas.js +54 -29
  128. package/dist/tools/output-schemas.js.map +1 -1
  129. package/dist/tools/resolve-qurl.d.ts +4 -3
  130. package/dist/tools/resolve-qurl.d.ts.map +1 -1
  131. package/dist/tools/resolve-qurl.js +3 -3
  132. package/dist/tools/resolve-qurl.js.map +1 -1
  133. package/dist/tools/revoke-qurl-token.d.ts +3 -2
  134. package/dist/tools/revoke-qurl-token.d.ts.map +1 -1
  135. package/dist/tools/revoke-qurl-token.js +2 -2
  136. package/dist/tools/revoke-qurl-token.js.map +1 -1
  137. package/dist/tools/terminate-qurl-sessions.d.ts +3 -2
  138. package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -1
  139. package/dist/tools/terminate-qurl-sessions.js +7 -3
  140. package/dist/tools/terminate-qurl-sessions.js.map +1 -1
  141. package/dist/tools/update-qurl-token.d.ts +5 -4
  142. package/dist/tools/update-qurl-token.d.ts.map +1 -1
  143. package/dist/tools/update-qurl-token.js +2 -2
  144. package/dist/tools/update-qurl-token.js.map +1 -1
  145. package/dist/tools/update-qurl.d.ts +6 -5
  146. package/dist/tools/update-qurl.d.ts.map +1 -1
  147. package/dist/tools/update-qurl.js +4 -4
  148. package/dist/tools/update-qurl.js.map +1 -1
  149. package/dist/tools/upload-file-data-qurl.d.ts +182 -0
  150. package/dist/tools/upload-file-data-qurl.d.ts.map +1 -0
  151. package/dist/tools/upload-file-data-qurl.js +200 -0
  152. package/dist/tools/upload-file-data-qurl.js.map +1 -0
  153. package/dist/tools/upload-file-qurl.d.ts +162 -0
  154. package/dist/tools/upload-file-qurl.d.ts.map +1 -0
  155. package/dist/tools/upload-file-qurl.js +167 -0
  156. package/dist/tools/upload-file-qurl.js.map +1 -0
  157. package/dist/tools/upload-file-shared.d.ts +36 -0
  158. package/dist/tools/upload-file-shared.d.ts.map +1 -0
  159. package/dist/tools/upload-file-shared.js +347 -0
  160. package/dist/tools/upload-file-shared.js.map +1 -0
  161. package/dist/tools/upload-mint-options.d.ts +22 -0
  162. package/dist/tools/upload-mint-options.d.ts.map +1 -0
  163. package/dist/tools/upload-mint-options.js +29 -0
  164. package/dist/tools/upload-mint-options.js.map +1 -0
  165. package/dist/tools/upload-text-qurl.d.ts +144 -0
  166. package/dist/tools/upload-text-qurl.d.ts.map +1 -0
  167. package/dist/tools/upload-text-qurl.js +102 -0
  168. package/dist/tools/upload-text-qurl.js.map +1 -0
  169. package/package.json +25 -7
@@ -0,0 +1 @@
1
+ {"version":3,"file":"email-delivery.js","sourceRoot":"","sources":["../../src/tools/email-delivery.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,11 @@
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 extendQurlSchema: z.ZodObject<{
4
5
  resource_id: z.ZodString;
5
6
  extend_by: z.ZodString;
6
7
  }, z.core.$strip>;
7
- export declare function extendQurlTool(client: IQURLClient): {
8
+ export declare function extendQurlTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
8
9
  name: string;
9
10
  title: string;
10
11
  description: string;
@@ -56,12 +57,12 @@ export declare function extendQurlTool(client: IQURLClient): {
56
57
  block_all: z.ZodOptional<z.ZodBoolean>;
57
58
  deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
58
59
  allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
59
- }, z.core.$strip>>;
60
- }, z.core.$strip>>;
60
+ }, z.core.$loose>>;
61
+ }, z.core.$loose>>;
61
62
  created_at: z.ZodOptional<z.ZodString>;
62
63
  expires_at: z.ZodOptional<z.ZodString>;
63
- }, z.core.$strip>>>;
64
- }, z.core.$strip>;
64
+ }, z.core.$loose>>>;
65
+ }, z.core.$loose>;
65
66
  annotations: {
66
67
  title: string;
67
68
  readOnlyHint: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"extend-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCjD"}
1
+ {"version":3,"file":"extend-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAEH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCjD"}
@@ -1,11 +1,11 @@
1
1
  import { z } from "zod";
2
- import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler } from "./_shared.js";
2
+ import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler, } from "./_shared.js";
3
3
  import { extendQurlOutputSchema } from "./output-schemas.js";
4
4
  export const extendQurlSchema = z.object({
5
5
  resource_id: resourceIdSchema("extend"),
6
6
  extend_by: z.string().min(1).describe('Duration to extend by (e.g., "24h", "7d")'),
7
7
  });
8
- export function extendQurlTool(client) {
8
+ export function extendQurlTool(client, _runtime = { mode: "stdio" }) {
9
9
  return {
10
10
  name: "extend_qurl",
11
11
  title: "Extend qURL Expiration",
@@ -14,7 +14,7 @@ export function extendQurlTool(client) {
14
14
  "Use this when the only change you need is more time on the clock. " +
15
15
  "Use `update_qurl` instead when you also need to change tags, description, or set an absolute `expires_at`. " +
16
16
  "Use `delete_qurl` when you want to cut off access entirely. " +
17
- "Accepts both `r_` and `q_` IDs (q_ is auto-resolved to its parent resource). " +
17
+ "Accepts resource public keys, CRIDs, legacy `r_` IDs, and `q_` display IDs (q_ is auto-resolved to its parent resource). " +
18
18
  "**Not idempotent:** calling twice with the same `extend_by` extends the expiration twice. If you need an absolute target, use `update_qurl` with `expires_at` so retries on transient errors don't double-push. " +
19
19
  "Returns the updated resource with the new `expires_at` (same shape as `get_qurl`).",
20
20
  inputSchema: extendQurlSchema,
@@ -1 +1 @@
1
- {"version":3,"file":"extend-qurl.js","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,oEAAoE;YACpE,4GAA4G;YAC5G,oEAAoE;YACpE,6GAA6G;YAC7G,8DAA8D;YAC9D,+EAA+E;YAC/E,kNAAkN;YAClN,oFAAoF;QACtF,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,wBAAwB;YAC/B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAuC,EAAE,EAAE;YAClF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE;gBACxD,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;qBAClC;iBACF;gBACD,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;aACpD,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"extend-qurl.js","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,WAA+B,EAAE,IAAI,EAAE,OAAO,EAAE;IAEhD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,oEAAoE;YACpE,4GAA4G;YAC5G,oEAAoE;YACpE,6GAA6G;YAC7G,8DAA8D;YAC9D,2HAA2H;YAC3H,kNAAkN;YAClN,oFAAoF;QACtF,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,wBAAwB;YAC/B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAuC,EAAE,EAAE;YAClF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE;gBACxD,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;qBAClC;iBACF;gBACD,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;aACpD,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
@@ -1,9 +1,10 @@
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 getQurlSchema: z.ZodObject<{
4
5
  resource_id: z.ZodString;
5
6
  }, z.core.$strip>;
6
- export declare function getQurlTool(client: IQURLClient): {
7
+ export declare function getQurlTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
7
8
  name: string;
8
9
  title: string;
9
10
  description: string;
@@ -54,12 +55,12 @@ export declare function getQurlTool(client: IQURLClient): {
54
55
  block_all: z.ZodOptional<z.ZodBoolean>;
55
56
  deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
56
57
  allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
57
- }, z.core.$strip>>;
58
- }, z.core.$strip>>;
58
+ }, z.core.$loose>>;
59
+ }, z.core.$loose>>;
59
60
  created_at: z.ZodOptional<z.ZodString>;
60
61
  expires_at: z.ZodOptional<z.ZodString>;
61
- }, z.core.$strip>>>;
62
- }, z.core.$strip>;
62
+ }, z.core.$loose>>>;
63
+ }, z.core.$loose>;
63
64
  annotations: {
64
65
  title: string;
65
66
  readOnlyHint: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"get-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/get-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC9C"}
1
+ {"version":3,"file":"get-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/get-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmChG"}
@@ -1,17 +1,19 @@
1
1
  import { z } from "zod";
2
- import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler } from "./_shared.js";
2
+ import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler, } from "./_shared.js";
3
3
  import { getQurlOutputSchema } from "./output-schemas.js";
4
4
  export const getQurlSchema = z.object({
5
5
  resource_id: resourceIdSchema("fetch"),
6
6
  });
7
- export function getQurlTool(client) {
7
+ export function getQurlTool(client, _runtime = { mode: "stdio" }) {
8
8
  return {
9
9
  name: "get_qurl",
10
10
  title: "Get qURL",
11
11
  description: "Fetch a single qURL resource by ID and return its current state plus a bounded preview of access tokens. " +
12
- "Use this when you have a specific resource ID (r_ prefix) or qURL display ID (q_ prefix) — q_ IDs are auto-resolved to their parent resource. " +
12
+ "Use this when you have a specific resource ID (public key, CRID, or legacy r_ ID) or qURL display ID (q_ prefix) — q_ IDs are auto-resolved to their parent resource. " +
13
+ "Do not use this to create a new qURL for a freshly uploaded image, PDF, screenshot, or file attachment. For chat-uploaded file content in HTTP MCP mode, use `upload_file_data_qurl` instead. " +
13
14
  "Use `list_qurls` instead when you need to discover qURLs by status, date range, or search query. " +
14
15
  "Use `resolve_qurl` instead when you have an end-user access token (at_ prefix) and need to redeem it for the underlying URL. " +
16
+ "If the user asks for 'the qURL of this image/file', this tool is only correct when you already know the existing `resource_id` or `qurl_id`. " +
15
17
  "`qurls[]` is an unordered preview capped by the API at 100 rows and may be omitted on list views, preview lookup failure, or redacted connector-owned resources; use `qurl_count` to detect that more token rows may exist. " +
16
18
  "The one-shot `qurl_link` from creation is never returned here.",
17
19
  inputSchema: getQurlSchema,
@@ -1 +1 @@
1
- {"version":3,"file":"get-qurl.js","sourceRoot":"","sources":["../../src/tools/get-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,WAAW,EAAE,gBAAgB,CAAC,OAAO,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,2GAA2G;YAC3G,gJAAgJ;YAChJ,mGAAmG;YACnG,+HAA+H;YAC/H,8NAA8N;YAC9N,gEAAgE;QAClE,WAAW,EAAE,aAAa;QAC1B,YAAY,EAAE,mBAAmB;QACjC,WAAW,EAAE;YACX,KAAK,EAAE,UAAU;YACjB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAoC,EAAE,EAAE;YAC/E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACvD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;qBAClC;iBACF;gBACD,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;aACpD,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"get-qurl.js","sourceRoot":"","sources":["../../src/tools/get-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,WAAW,EAAE,gBAAgB,CAAC,OAAO,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,MAAmB,EAAE,WAA+B,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/F,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,2GAA2G;YAC3G,wKAAwK;YACxK,gMAAgM;YAChM,mGAAmG;YACnG,+HAA+H;YAC/H,+IAA+I;YAC/I,8NAA8N;YAC9N,gEAAgE;QAClE,WAAW,EAAE,aAAa;QAC1B,YAAY,EAAE,mBAAmB;QACjC,WAAW,EAAE;YACX,KAAK,EAAE,UAAU;YACjB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAoC,EAAE,EAAE;YAC/E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACvD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;qBAClC;iBACF;gBACD,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC;aACpD,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
@@ -1,9 +1,10 @@
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 listQurlSessionsSchema: z.ZodObject<{
4
5
  resource_id: z.ZodString;
5
6
  }, z.core.$strip>;
6
- export declare function listQurlSessionsTool(client: IQURLClient): {
7
+ export declare function listQurlSessionsTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
7
8
  name: string;
8
9
  title: string;
9
10
  description: string;
@@ -18,11 +19,11 @@ export declare function listQurlSessionsTool(client: IQURLClient): {
18
19
  user_agent: z.ZodOptional<z.ZodString>;
19
20
  created_at: z.ZodOptional<z.ZodString>;
20
21
  last_seen_at: z.ZodOptional<z.ZodString>;
21
- }, z.core.$strip>>;
22
+ }, z.core.$loose>>;
22
23
  meta: z.ZodOptional<z.ZodObject<{
23
24
  request_id: z.ZodOptional<z.ZodString>;
24
- }, z.core.$strip>>;
25
- }, z.core.$strip>;
25
+ }, z.core.$loose>>;
26
+ }, z.core.$loose>;
26
27
  annotations: {
27
28
  title: string;
28
29
  readOnlyHint: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"list-qurl-sessions.d.ts","sourceRoot":"","sources":["../../src/tools/list-qurl-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BvD"}
1
+ {"version":3,"file":"list-qurl-sessions.d.ts","sourceRoot":"","sources":["../../src/tools/list-qurl-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BjD"}
@@ -1,10 +1,10 @@
1
1
  import { z } from "zod";
2
- import { resourceOnlyIdSchema, toStructuredContent, withMissingApiKeyHandler } from "./_shared.js";
2
+ import { resourceOnlyIdSchema, toStructuredContent, withMissingApiKeyHandler, } from "./_shared.js";
3
3
  import { listQurlSessionsOutputSchema } from "./output-schemas.js";
4
4
  export const listQurlSessionsSchema = z.object({
5
5
  resource_id: resourceOnlyIdSchema("list active sessions for"),
6
6
  });
7
- export function listQurlSessionsTool(client) {
7
+ export function listQurlSessionsTool(client, _runtime = { mode: "stdio" }) {
8
8
  return {
9
9
  name: "list_qurl_sessions",
10
10
  title: "List qURL Sessions",
@@ -1 +1 @@
1
- {"version":3,"file":"list-qurl-sessions.js","sourceRoot":"","sources":["../../src/tools/list-qurl-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,oBAAoB,CAAC,0BAA0B,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,mDAAmD;YACnD,wGAAwG;YACxG,gKAAgK;YAChK,mGAAmG;QACrG,WAAW,EAAE,sBAAsB;QACnC,YAAY,EAAE,4BAA4B;QAC1C,WAAW,EAAE;YACX,KAAK,EAAE,oBAAoB;YAC3B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAA6C,EAAE,EAAE;YACxF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC;aAC/C,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"list-qurl-sessions.js","sourceRoot":"","sources":["../../src/tools/list-qurl-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,oBAAoB,CAAC,0BAA0B,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,MAAmB,EACnB,WAA+B,EAAE,IAAI,EAAE,OAAO,EAAE;IAEhD,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,mDAAmD;YACnD,wGAAwG;YACxG,gKAAgK;YAChK,mGAAmG;QACrG,WAAW,EAAE,sBAAsB;QACnC,YAAY,EAAE,4BAA4B;QAC1C,WAAW,EAAE;YACX,KAAK,EAAE,oBAAoB;YAC3B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAA6C,EAAE,EAAE;YACxF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC;aAC/C,CAAC;QACJ,CAAC,CAAC;KACH,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 listQurlsSchema: z.ZodObject<{
4
5
  limit: z.ZodOptional<z.ZodNumber>;
5
6
  cursor: z.ZodOptional<z.ZodString>;
@@ -11,7 +12,7 @@ export declare const listQurlsSchema: z.ZodObject<{
11
12
  sort: z.ZodOptional<z.ZodString>;
12
13
  q: z.ZodOptional<z.ZodString>;
13
14
  }, z.core.$strip>;
14
- export declare function listQurlsTool(client: IQURLClient): {
15
+ export declare function listQurlsTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
15
16
  name: string;
16
17
  title: string;
17
18
  description: string;
@@ -71,19 +72,19 @@ export declare function listQurlsTool(client: IQURLClient): {
71
72
  block_all: z.ZodOptional<z.ZodBoolean>;
72
73
  deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
73
74
  allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
74
- }, z.core.$strip>>;
75
- }, z.core.$strip>>;
75
+ }, z.core.$loose>>;
76
+ }, z.core.$loose>>;
76
77
  created_at: z.ZodOptional<z.ZodString>;
77
78
  expires_at: z.ZodOptional<z.ZodString>;
78
- }, z.core.$strip>>>;
79
- }, z.core.$strip>>;
79
+ }, z.core.$loose>>>;
80
+ }, z.core.$loose>>;
80
81
  meta: z.ZodObject<{
81
82
  next_cursor: z.ZodOptional<z.ZodString>;
82
83
  has_more: z.ZodBoolean;
83
84
  page_size: z.ZodOptional<z.ZodNumber>;
84
85
  request_id: z.ZodOptional<z.ZodString>;
85
- }, z.core.$strip>;
86
- }, z.core.$strip>;
86
+ }, z.core.$loose>;
87
+ }, z.core.$loose>;
87
88
  annotations: {
88
89
  title: string;
89
90
  readOnlyHint: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"list-qurls.d.ts","sourceRoot":"","sources":["../../src/tools/list-qurls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,eAAe;;;;;;;;;;iBAmD1B,CAAC;AAEH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8ChD"}
1
+ {"version":3,"file":"list-qurls.d.ts","sourceRoot":"","sources":["../../src/tools/list-qurls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,eAAe;;;;;;;;;;iBAoD1B,CAAC;AAEH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDjD"}
@@ -1,5 +1,5 @@
1
1
  import { z } from "zod";
2
- import { toStructuredContent, withMissingApiKeyHandler } from "./_shared.js";
2
+ import { toStructuredContent, withMissingApiKeyHandler, } from "./_shared.js";
3
3
  import { listQurlsOutputSchema } from "./output-schemas.js";
4
4
  export const listQurlsSchema = z.object({
5
5
  limit: z
@@ -16,25 +16,26 @@ export const listQurlsSchema = z.object({
16
16
  .min(1)
17
17
  .optional()
18
18
  .describe("Filter by status (comma-separated, e.g. 'active,revoked'). " +
19
- "Defaults to 'active' when omitted; pass 'revoked' or 'active,revoked' to override."),
19
+ "Defaults to 'active' when omitted; pass 'revoked' or 'active,revoked' to override. " +
20
+ "Only active and revoked are valid resource filters; expired is not accepted."),
20
21
  created_after: z
21
22
  .string()
22
- .datetime()
23
+ .datetime({ offset: true })
23
24
  .optional()
24
25
  .describe("Filter: created after this date (RFC 3339)"),
25
26
  created_before: z
26
27
  .string()
27
- .datetime()
28
+ .datetime({ offset: true })
28
29
  .optional()
29
30
  .describe("Filter: created before this date (RFC 3339)"),
30
31
  expires_before: z
31
32
  .string()
32
- .datetime()
33
+ .datetime({ offset: true })
33
34
  .optional()
34
35
  .describe("Filter: expires before this date (RFC 3339)"),
35
36
  expires_after: z
36
37
  .string()
37
- .datetime()
38
+ .datetime({ offset: true })
38
39
  .optional()
39
40
  .describe("Filter: expires after this date (RFC 3339)"),
40
41
  sort: z
@@ -46,7 +47,7 @@ export const listQurlsSchema = z.object({
46
47
  "Example: 'created_at:desc'."),
47
48
  q: z.string().min(1).optional().describe("Search query (searches description and target_url)"),
48
49
  });
49
- export function listQurlsTool(client) {
50
+ export function listQurlsTool(client, _runtime = { mode: "stdio" }) {
50
51
  return {
51
52
  name: "list_qurls",
52
53
  title: "List qURLs",
@@ -65,6 +66,7 @@ export function listQurlsTool(client) {
65
66
  // drops the epistemics caveat (overhedging invites defensive
66
67
  // over-specification) and pinning is tracked separately.
67
68
  "By default only `active` qURLs are returned; pass `status: 'revoked'` to see only revoked qURLs or `'active,revoked'` to see both. " +
69
+ "A past resource expires_at does not change its status; individual access tokens can expire. `status: 'expired'` is not a valid resource filter. " +
68
70
  "Sort defaults to `created_at:desc`; override with `sort: 'expires_at:asc'` etc. " +
69
71
  "**Returns:** `{ data: QURL[], meta: { has_more: boolean, next_cursor?: string, page_size?: number, request_id?: string } }` — each `data[]` item is the same stable resource shape returned by `get_qurl` minus per-token detail. " +
70
72
  'Example: `list_qurls({ status: "active", sort: "expires_at:asc", limit: 10 })` returns the 10 active qURLs expiring soonest.',
@@ -1 +1 @@
1
- {"version":3,"file":"list-qurls.js","sourceRoot":"","sources":["../../src/tools/list-qurls.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"list-qurls.js","sourceRoot":"","sources":["../../src/tools/list-qurls.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 mintLinkBaseSchema: z.ZodObject<{
4
5
  resource_id: z.ZodString;
5
6
  label: z.ZodOptional<z.ZodString>;
@@ -21,6 +22,11 @@ export declare const mintLinkBaseSchema: z.ZodObject<{
21
22
  allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
22
23
  }, z.core.$strip>>;
23
24
  }, z.core.$strip>>;
25
+ email_delivery: z.ZodOptional<z.ZodObject<{
26
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
27
+ subject: z.ZodOptional<z.ZodString>;
28
+ message: z.ZodOptional<z.ZodString>;
29
+ }, z.core.$strip>>;
24
30
  }, z.core.$strip>;
25
31
  export declare const mintLinkSchema: z.ZodObject<{
26
32
  resource_id: z.ZodString;
@@ -43,8 +49,13 @@ export declare const mintLinkSchema: z.ZodObject<{
43
49
  allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
44
50
  }, z.core.$strip>>;
45
51
  }, z.core.$strip>>;
52
+ email_delivery: z.ZodOptional<z.ZodObject<{
53
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
54
+ subject: z.ZodOptional<z.ZodString>;
55
+ message: z.ZodOptional<z.ZodString>;
56
+ }, z.core.$strip>>;
46
57
  }, z.core.$strip>;
47
- export declare function mintLinkTool(client: IQURLClient): {
58
+ export declare function mintLinkTool(client: IQURLClient, runtime: ToolRuntimeOptions): {
48
59
  name: string;
49
60
  title: string;
50
61
  description: string;
@@ -69,14 +80,34 @@ export declare function mintLinkTool(client: IQURLClient): {
69
80
  allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
70
81
  }, z.core.$strip>>;
71
82
  }, z.core.$strip>>;
83
+ email_delivery: z.ZodOptional<z.ZodObject<{
84
+ to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
85
+ subject: z.ZodOptional<z.ZodString>;
86
+ message: z.ZodOptional<z.ZodString>;
87
+ }, z.core.$strip>>;
72
88
  }, z.core.$strip>;
73
89
  outputSchema: z.ZodObject<{
74
90
  qurl_id: z.ZodString;
75
91
  qurl_link: z.ZodString;
76
92
  branded_domain: z.ZodOptional<z.ZodString>;
77
- expires_at: z.ZodString;
93
+ expires_at: z.ZodOptional<z.ZodString>;
78
94
  type: z.ZodOptional<z.ZodString>;
79
- }, z.core.$strip>;
95
+ email_delivery: z.ZodOptional<z.ZodObject<{
96
+ attempted: z.ZodBoolean;
97
+ enabled: z.ZodBoolean;
98
+ recipients: z.ZodArray<z.ZodString>;
99
+ sent: z.ZodNumber;
100
+ failed: z.ZodNumber;
101
+ skipped_reason: z.ZodOptional<z.ZodString>;
102
+ results: z.ZodArray<z.ZodObject<{
103
+ email: z.ZodString;
104
+ success: z.ZodBoolean;
105
+ skipped: z.ZodBoolean;
106
+ error: z.ZodOptional<z.ZodString>;
107
+ message_id: z.ZodOptional<z.ZodString>;
108
+ }, z.core.$strip>>;
109
+ }, z.core.$strip>>;
110
+ }, z.core.$loose>;
80
111
  annotations: {
81
112
  title: string;
82
113
  readOnlyHint: boolean;
@@ -105,6 +136,11 @@ export declare function mintLinkTool(client: IQURLClient): {
105
136
  allow_categories?: string[] | undefined;
106
137
  } | undefined;
107
138
  } | undefined;
139
+ email_delivery?: {
140
+ to: string[];
141
+ subject?: string | undefined;
142
+ message?: string | undefined;
143
+ } | undefined;
108
144
  }) => Promise<{
109
145
  content: Array<{
110
146
  type: "text";
@@ -1 +1 @@
1
- {"version":3,"file":"mint-link.d.ts","sourceRoot":"","sources":["../../src/tools/mint-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAUhD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;iBAoC7B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;iBAG1B,CAAC;AAEF,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsC/C"}
1
+ {"version":3,"file":"mint-link.d.ts","sourceRoot":"","sources":["../../src/tools/mint-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyC7B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG1B,CAAC;AAEF,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6C5E"}
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
2
  import { accessPolicySchema } from "./create-qurl.js";
3
- import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler, zodErrorToToolResult, } from "./_shared.js";
3
+ import { emailDeliveryInputSchema, maybeDeliverToolEmail, singleLineEmailDetail, toEmailAugmentedResult, } from "./email-delivery.js";
4
+ import { allowsServerApiKeyFallback, resourceIdSchema, withMissingApiKeyHandler, zodErrorToToolResult, } from "./_shared.js";
4
5
  import { mintLinkOutputSchema } from "./output-schemas.js";
5
6
  export const mintLinkBaseSchema = z.object({
6
7
  resource_id: resourceIdSchema("mint a new access link for"),
@@ -16,7 +17,7 @@ export const mintLinkBaseSchema = z.object({
16
17
  .describe('Relative duration until expiration (e.g., "5m", "24h", "7d"). Mutually exclusive with expires_at'),
17
18
  expires_at: z
18
19
  .string()
19
- .datetime()
20
+ .datetime({ offset: true })
20
21
  .optional()
21
22
  .describe("Absolute expiration timestamp (RFC 3339). Mutually exclusive with expires_in"),
22
23
  one_time_use: z.boolean().optional().describe("Whether this link can only be used once"),
@@ -34,9 +35,12 @@ export const mintLinkBaseSchema = z.object({
34
35
  .describe('How long access lasts after clicking (e.g., "1h"). ' +
35
36
  "Rejected if it exceeds the parent resource's session-duration cap."),
36
37
  access_policy: accessPolicySchema.optional().describe("Access control policy for this link"),
38
+ email_delivery: emailDeliveryInputSchema
39
+ .optional()
40
+ .describe("Optional email notification settings for sending the minted access link to one or more recipients."),
37
41
  });
38
42
  export const mintLinkSchema = mintLinkBaseSchema.refine((data) => !(data.expires_in && data.expires_at), { message: "Provide either expires_in or expires_at, not both" });
39
- export function mintLinkTool(client) {
43
+ export function mintLinkTool(client, runtime) {
40
44
  return {
41
45
  name: "mint_link",
42
46
  title: "Mint Access Link",
@@ -44,7 +48,7 @@ export function mintLinkTool(client) {
44
48
  "Use this to issue additional access links to a resource without creating a brand-new qURL (e.g. a second recipient, a replacement after the original was lost). " +
45
49
  "Use `create_qurl` instead when you want a brand-new resource with its own target_url and policy. " +
46
50
  "Use `update_qurl` when you only want to change expiration/tags/description on the existing resource. " +
47
- "Accepts both `r_` and `q_` IDs. " +
51
+ "Accepts resource public keys, CRIDs, legacy `r_` IDs, and `q_` display IDs. " +
48
52
  "**Constraints:** `expires_in` and `expires_at` are mutually exclusive (handler returns an `isError: true` content block before any API call if both are set). " +
49
53
  "If neither expiry field is specified, the API defaults to 24 hours from now. " +
50
54
  "**Output:** the new `qurl_link` is shown ONCE — no subsequent call returns it. Capture `qurl_id` if you need to correlate future access events or update this specific token.",
@@ -61,17 +65,24 @@ export function mintLinkTool(client) {
61
65
  const parsed = mintLinkSchema.safeParse(raw);
62
66
  if (!parsed.success)
63
67
  return zodErrorToToolResult(parsed.error);
64
- const { resource_id, ...body } = parsed.data;
68
+ const { resource_id, email_delivery, ...body } = parsed.data;
65
69
  const result = await client.mintLink(resource_id, body);
66
- return {
67
- content: [
68
- {
69
- type: "text",
70
- text: JSON.stringify(result.data),
71
- },
70
+ const emailResult = await maybeDeliverToolEmail({
71
+ allowServerApiKeyFallback: allowsServerApiKeyFallback(runtime),
72
+ delivery: email_delivery,
73
+ defaultSubject: "Your qURL access link is ready",
74
+ detailLines: [
75
+ "A new qURL access link has been minted for you.",
76
+ `Resource ID: ${singleLineEmailDetail(resource_id)}`,
77
+ `Secure Link: ${singleLineEmailDetail(result.data.qurl_link)}`,
78
+ ...(result.data.expires_at
79
+ ? [`Expires At: ${singleLineEmailDetail(result.data.expires_at)}`]
80
+ : []),
81
+ ...(body.label ? [`Label: ${singleLineEmailDetail(body.label)}`] : []),
82
+ ...(result.data.type ? [`Type: ${singleLineEmailDetail(result.data.type)}`] : []),
72
83
  ],
73
- structuredContent: toStructuredContent(result.data),
74
- };
84
+ });
85
+ return toEmailAugmentedResult(result.data, emailResult);
75
86
  }),
76
87
  };
77
88
  }
@@ -1 +1 @@
1
- {"version":3,"file":"mint-link.js","sourceRoot":"","sources":["../../src/tools/mint-link.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"mint-link.js","sourceRoot":"","sources":["../../src/tools/mint-link.ts"],"names":[],"mappings":"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"}