@layervai/qurl-mcp 0.4.0 → 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 (173) hide show
  1. package/README.md +742 -46
  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 +112 -23
  14. package/dist/client.d.ts.map +1 -1
  15. package/dist/client.js +173 -78
  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 -25
  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/secure-a-service.d.ts +16 -4
  58. package/dist/prompts/secure-a-service.d.ts.map +1 -1
  59. package/dist/prompts/secure-a-service.js +7 -15
  60. package/dist/prompts/secure-a-service.js.map +1 -1
  61. package/dist/server.d.ts +18 -6
  62. package/dist/server.d.ts.map +1 -1
  63. package/dist/server.js +41 -8
  64. package/dist/server.js.map +1 -1
  65. package/dist/services/email.d.ts +17 -0
  66. package/dist/services/email.d.ts.map +1 -0
  67. package/dist/services/email.js +351 -0
  68. package/dist/services/email.js.map +1 -0
  69. package/dist/services/html.d.ts +5 -0
  70. package/dist/services/html.d.ts.map +1 -0
  71. package/dist/services/html.js +28 -0
  72. package/dist/services/html.js.map +1 -0
  73. package/dist/services/legal-pages.d.ts +12 -0
  74. package/dist/services/legal-pages.d.ts.map +1 -0
  75. package/dist/services/legal-pages.js +588 -0
  76. package/dist/services/legal-pages.js.map +1 -0
  77. package/dist/services/text-pdf.d.ts +16 -0
  78. package/dist/services/text-pdf.d.ts.map +1 -0
  79. package/dist/services/text-pdf.js +141 -0
  80. package/dist/services/text-pdf.js.map +1 -0
  81. package/dist/services/video-page.d.ts +4 -0
  82. package/dist/services/video-page.d.ts.map +1 -0
  83. package/dist/services/video-page.js +311 -0
  84. package/dist/services/video-page.js.map +1 -0
  85. package/dist/text.d.ts +4 -0
  86. package/dist/text.d.ts.map +1 -0
  87. package/dist/text.js +16 -0
  88. package/dist/text.js.map +1 -0
  89. package/dist/tools/_shared.d.ts +13 -3
  90. package/dist/tools/_shared.d.ts.map +1 -1
  91. package/dist/tools/_shared.js +31 -7
  92. package/dist/tools/_shared.js.map +1 -1
  93. package/dist/tools/batch-create.d.ts +36 -343
  94. package/dist/tools/batch-create.d.ts.map +1 -1
  95. package/dist/tools/batch-create.js +7 -4
  96. package/dist/tools/batch-create.js.map +1 -1
  97. package/dist/tools/create-qurl.d.ts +79 -237
  98. package/dist/tools/create-qurl.d.ts.map +1 -1
  99. package/dist/tools/create-qurl.js +77 -47
  100. package/dist/tools/create-qurl.js.map +1 -1
  101. package/dist/tools/delete-qurl.d.ts +5 -22
  102. package/dist/tools/delete-qurl.d.ts.map +1 -1
  103. package/dist/tools/delete-qurl.js +19 -13
  104. package/dist/tools/delete-qurl.js.map +1 -1
  105. package/dist/tools/email-delivery.d.ts +37 -0
  106. package/dist/tools/email-delivery.d.ts.map +1 -0
  107. package/dist/tools/email-delivery.js +115 -0
  108. package/dist/tools/email-delivery.js.map +1 -0
  109. package/dist/tools/extend-qurl.d.ts +36 -189
  110. package/dist/tools/extend-qurl.d.ts.map +1 -1
  111. package/dist/tools/extend-qurl.js +3 -3
  112. package/dist/tools/extend-qurl.js.map +1 -1
  113. package/dist/tools/get-qurl.d.ts +36 -185
  114. package/dist/tools/get-qurl.d.ts.map +1 -1
  115. package/dist/tools/get-qurl.js +8 -5
  116. package/dist/tools/get-qurl.js.map +1 -1
  117. package/dist/tools/list-qurl-sessions.d.ts +45 -0
  118. package/dist/tools/list-qurl-sessions.d.ts.map +1 -0
  119. package/dist/tools/list-qurl-sessions.js +33 -0
  120. package/dist/tools/list-qurl-sessions.js.map +1 -0
  121. package/dist/tools/list-qurls.d.ts +38 -319
  122. package/dist/tools/list-qurls.d.ts.map +1 -1
  123. package/dist/tools/list-qurls.js +45 -20
  124. package/dist/tools/list-qurls.js.map +1 -1
  125. package/dist/tools/mint-link.d.ts +72 -303
  126. package/dist/tools/mint-link.d.ts.map +1 -1
  127. package/dist/tools/mint-link.js +35 -21
  128. package/dist/tools/mint-link.js.map +1 -1
  129. package/dist/tools/output-schemas.d.ts +326 -1112
  130. package/dist/tools/output-schemas.d.ts.map +1 -1
  131. package/dist/tools/output-schemas.js +141 -40
  132. package/dist/tools/output-schemas.js.map +1 -1
  133. package/dist/tools/resolve-qurl.d.ts +6 -37
  134. package/dist/tools/resolve-qurl.d.ts.map +1 -1
  135. package/dist/tools/resolve-qurl.js +5 -5
  136. package/dist/tools/resolve-qurl.js.map +1 -1
  137. package/dist/tools/revoke-qurl-token.d.ts +41 -0
  138. package/dist/tools/revoke-qurl-token.d.ts.map +1 -0
  139. package/dist/tools/revoke-qurl-token.js +40 -0
  140. package/dist/tools/revoke-qurl-token.js.map +1 -0
  141. package/dist/tools/terminate-qurl-sessions.d.ts +41 -0
  142. package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -0
  143. package/dist/tools/terminate-qurl-sessions.js +68 -0
  144. package/dist/tools/terminate-qurl-sessions.js.map +1 -0
  145. package/dist/tools/update-qurl-token.d.ts +142 -0
  146. package/dist/tools/update-qurl-token.d.ts.map +1 -0
  147. package/dist/tools/update-qurl-token.js +75 -0
  148. package/dist/tools/update-qurl-token.js.map +1 -0
  149. package/dist/tools/update-qurl.d.ts +43 -264
  150. package/dist/tools/update-qurl.d.ts.map +1 -1
  151. package/dist/tools/update-qurl.js +57 -8
  152. package/dist/tools/update-qurl.js.map +1 -1
  153. package/dist/tools/upload-file-data-qurl.d.ts +182 -0
  154. package/dist/tools/upload-file-data-qurl.d.ts.map +1 -0
  155. package/dist/tools/upload-file-data-qurl.js +200 -0
  156. package/dist/tools/upload-file-data-qurl.js.map +1 -0
  157. package/dist/tools/upload-file-qurl.d.ts +162 -0
  158. package/dist/tools/upload-file-qurl.d.ts.map +1 -0
  159. package/dist/tools/upload-file-qurl.js +167 -0
  160. package/dist/tools/upload-file-qurl.js.map +1 -0
  161. package/dist/tools/upload-file-shared.d.ts +36 -0
  162. package/dist/tools/upload-file-shared.d.ts.map +1 -0
  163. package/dist/tools/upload-file-shared.js +347 -0
  164. package/dist/tools/upload-file-shared.js.map +1 -0
  165. package/dist/tools/upload-mint-options.d.ts +22 -0
  166. package/dist/tools/upload-mint-options.d.ts.map +1 -0
  167. package/dist/tools/upload-mint-options.js +29 -0
  168. package/dist/tools/upload-mint-options.js.map +1 -0
  169. package/dist/tools/upload-text-qurl.d.ts +144 -0
  170. package/dist/tools/upload-text-qurl.d.ts.map +1 -0
  171. package/dist/tools/upload-text-qurl.js +102 -0
  172. package/dist/tools/upload-text-qurl.js.map +1 -0
  173. package/package.json +27 -8
@@ -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>;
@@ -10,28 +11,8 @@ export declare const listQurlsSchema: z.ZodObject<{
10
11
  expires_after: z.ZodOptional<z.ZodString>;
11
12
  sort: z.ZodOptional<z.ZodString>;
12
13
  q: z.ZodOptional<z.ZodString>;
13
- }, "strip", z.ZodTypeAny, {
14
- limit?: number | undefined;
15
- cursor?: string | undefined;
16
- status?: string | undefined;
17
- created_after?: string | undefined;
18
- created_before?: string | undefined;
19
- expires_before?: string | undefined;
20
- expires_after?: string | undefined;
21
- sort?: string | undefined;
22
- q?: string | undefined;
23
- }, {
24
- limit?: number | undefined;
25
- cursor?: string | undefined;
26
- status?: string | undefined;
27
- created_after?: string | undefined;
28
- created_before?: string | undefined;
29
- expires_before?: string | undefined;
30
- expires_after?: string | undefined;
31
- sort?: string | undefined;
32
- q?: string | undefined;
33
- }>;
34
- export declare function listQurlsTool(client: IQURLClient): {
14
+ }, z.core.$strip>;
15
+ export declare function listQurlsTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
35
16
  name: string;
36
17
  title: string;
37
18
  description: string;
@@ -45,327 +26,65 @@ export declare function listQurlsTool(client: IQURLClient): {
45
26
  expires_after: z.ZodOptional<z.ZodString>;
46
27
  sort: z.ZodOptional<z.ZodString>;
47
28
  q: z.ZodOptional<z.ZodString>;
48
- }, "strip", z.ZodTypeAny, {
49
- limit?: number | undefined;
50
- cursor?: string | undefined;
51
- status?: string | undefined;
52
- created_after?: string | undefined;
53
- created_before?: string | undefined;
54
- expires_before?: string | undefined;
55
- expires_after?: string | undefined;
56
- sort?: string | undefined;
57
- q?: string | undefined;
58
- }, {
59
- limit?: number | undefined;
60
- cursor?: string | undefined;
61
- status?: string | undefined;
62
- created_after?: string | undefined;
63
- created_before?: string | undefined;
64
- expires_before?: string | undefined;
65
- expires_after?: string | undefined;
66
- sort?: string | undefined;
67
- q?: string | undefined;
68
- }>;
29
+ }, z.core.$strip>;
69
30
  outputSchema: z.ZodObject<{
70
31
  data: z.ZodArray<z.ZodObject<{
71
32
  resource_id: z.ZodString;
72
33
  qurl_site: z.ZodOptional<z.ZodString>;
73
- target_url: z.ZodString;
34
+ target_url: z.ZodOptional<z.ZodString>;
74
35
  description: z.ZodOptional<z.ZodString>;
75
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
36
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
76
37
  expires_at: z.ZodString;
77
38
  created_at: z.ZodString;
78
- status: z.ZodEnum<["active", "revoked"]>;
39
+ status: z.ZodCatch<z.ZodEnum<{
40
+ active: "active";
41
+ expired: "expired";
42
+ revoked: "revoked";
43
+ unknown: "unknown";
44
+ }>>;
79
45
  custom_domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
46
+ slug: z.ZodOptional<z.ZodString>;
80
47
  preserve_host: z.ZodOptional<z.ZodBoolean>;
81
48
  qurl_count: z.ZodOptional<z.ZodNumber>;
82
49
  qurls: z.ZodOptional<z.ZodArray<z.ZodObject<{
83
50
  qurl_id: z.ZodString;
84
51
  label: z.ZodOptional<z.ZodString>;
85
- status: z.ZodEnum<["active", "consumed", "expired", "revoked"]>;
86
- one_time_use: z.ZodBoolean;
87
- max_sessions: z.ZodNumber;
88
- session_duration: z.ZodNumber;
89
- use_count: z.ZodNumber;
52
+ status: z.ZodCatch<z.ZodEnum<{
53
+ active: "active";
54
+ consumed: "consumed";
55
+ expired: "expired";
56
+ revoked: "revoked";
57
+ unknown: "unknown";
58
+ }>>;
59
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
60
+ max_sessions: z.ZodOptional<z.ZodNumber>;
61
+ session_duration: z.ZodOptional<z.ZodNumber>;
62
+ use_count: z.ZodOptional<z.ZodNumber>;
90
63
  qurl_site: z.ZodOptional<z.ZodString>;
91
64
  access_policy: z.ZodOptional<z.ZodObject<{
92
- ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
93
- ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
94
- geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
95
- geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
65
+ ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
66
+ ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
67
+ geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
68
+ geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
96
69
  user_agent_allow_regex: z.ZodOptional<z.ZodString>;
97
70
  user_agent_deny_regex: z.ZodOptional<z.ZodString>;
98
71
  ai_agent_policy: z.ZodOptional<z.ZodObject<{
99
72
  block_all: z.ZodOptional<z.ZodBoolean>;
100
- deny_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
101
- allow_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
102
- }, "strip", z.ZodTypeAny, {
103
- block_all?: boolean | undefined;
104
- deny_categories?: string[] | undefined;
105
- allow_categories?: string[] | undefined;
106
- }, {
107
- block_all?: boolean | undefined;
108
- deny_categories?: string[] | undefined;
109
- allow_categories?: string[] | undefined;
110
- }>>;
111
- }, "strip", z.ZodTypeAny, {
112
- ip_allowlist?: string[] | undefined;
113
- ip_denylist?: string[] | undefined;
114
- geo_allowlist?: string[] | undefined;
115
- geo_denylist?: string[] | undefined;
116
- user_agent_allow_regex?: string | undefined;
117
- user_agent_deny_regex?: string | undefined;
118
- ai_agent_policy?: {
119
- block_all?: boolean | undefined;
120
- deny_categories?: string[] | undefined;
121
- allow_categories?: string[] | undefined;
122
- } | undefined;
123
- }, {
124
- ip_allowlist?: string[] | undefined;
125
- ip_denylist?: string[] | undefined;
126
- geo_allowlist?: string[] | undefined;
127
- geo_denylist?: string[] | undefined;
128
- user_agent_allow_regex?: string | undefined;
129
- user_agent_deny_regex?: string | undefined;
130
- ai_agent_policy?: {
131
- block_all?: boolean | undefined;
132
- deny_categories?: string[] | undefined;
133
- allow_categories?: string[] | undefined;
134
- } | undefined;
135
- }>>;
136
- created_at: z.ZodString;
137
- expires_at: z.ZodString;
138
- }, "strip", z.ZodTypeAny, {
139
- status: "active" | "consumed" | "expired" | "revoked";
140
- qurl_id: string;
141
- one_time_use: boolean;
142
- max_sessions: number;
143
- session_duration: number;
144
- use_count: number;
145
- created_at: string;
146
- expires_at: string;
147
- label?: string | undefined;
148
- qurl_site?: string | undefined;
149
- access_policy?: {
150
- ip_allowlist?: string[] | undefined;
151
- ip_denylist?: string[] | undefined;
152
- geo_allowlist?: string[] | undefined;
153
- geo_denylist?: string[] | undefined;
154
- user_agent_allow_regex?: string | undefined;
155
- user_agent_deny_regex?: string | undefined;
156
- ai_agent_policy?: {
157
- block_all?: boolean | undefined;
158
- deny_categories?: string[] | undefined;
159
- allow_categories?: string[] | undefined;
160
- } | undefined;
161
- } | undefined;
162
- }, {
163
- status: "active" | "consumed" | "expired" | "revoked";
164
- qurl_id: string;
165
- one_time_use: boolean;
166
- max_sessions: number;
167
- session_duration: number;
168
- use_count: number;
169
- created_at: string;
170
- expires_at: string;
171
- label?: string | undefined;
172
- qurl_site?: string | undefined;
173
- access_policy?: {
174
- ip_allowlist?: string[] | undefined;
175
- ip_denylist?: string[] | undefined;
176
- geo_allowlist?: string[] | undefined;
177
- geo_denylist?: string[] | undefined;
178
- user_agent_allow_regex?: string | undefined;
179
- user_agent_deny_regex?: string | undefined;
180
- ai_agent_policy?: {
181
- block_all?: boolean | undefined;
182
- deny_categories?: string[] | undefined;
183
- allow_categories?: string[] | undefined;
184
- } | undefined;
185
- } | undefined;
186
- }>, "many">>;
187
- }, "strip", z.ZodTypeAny, {
188
- status: "active" | "revoked";
189
- created_at: string;
190
- expires_at: string;
191
- resource_id: string;
192
- target_url: string;
193
- qurl_site?: string | undefined;
194
- description?: string | undefined;
195
- tags?: string[] | undefined;
196
- custom_domain?: string | null | undefined;
197
- preserve_host?: boolean | undefined;
198
- qurl_count?: number | undefined;
199
- qurls?: {
200
- status: "active" | "consumed" | "expired" | "revoked";
201
- qurl_id: string;
202
- one_time_use: boolean;
203
- max_sessions: number;
204
- session_duration: number;
205
- use_count: number;
206
- created_at: string;
207
- expires_at: string;
208
- label?: string | undefined;
209
- qurl_site?: string | undefined;
210
- access_policy?: {
211
- ip_allowlist?: string[] | undefined;
212
- ip_denylist?: string[] | undefined;
213
- geo_allowlist?: string[] | undefined;
214
- geo_denylist?: string[] | undefined;
215
- user_agent_allow_regex?: string | undefined;
216
- user_agent_deny_regex?: string | undefined;
217
- ai_agent_policy?: {
218
- block_all?: boolean | undefined;
219
- deny_categories?: string[] | undefined;
220
- allow_categories?: string[] | undefined;
221
- } | undefined;
222
- } | undefined;
223
- }[] | undefined;
224
- }, {
225
- status: "active" | "revoked";
226
- created_at: string;
227
- expires_at: string;
228
- resource_id: string;
229
- target_url: string;
230
- qurl_site?: string | undefined;
231
- description?: string | undefined;
232
- tags?: string[] | undefined;
233
- custom_domain?: string | null | undefined;
234
- preserve_host?: boolean | undefined;
235
- qurl_count?: number | undefined;
236
- qurls?: {
237
- status: "active" | "consumed" | "expired" | "revoked";
238
- qurl_id: string;
239
- one_time_use: boolean;
240
- max_sessions: number;
241
- session_duration: number;
242
- use_count: number;
243
- created_at: string;
244
- expires_at: string;
245
- label?: string | undefined;
246
- qurl_site?: string | undefined;
247
- access_policy?: {
248
- ip_allowlist?: string[] | undefined;
249
- ip_denylist?: string[] | undefined;
250
- geo_allowlist?: string[] | undefined;
251
- geo_denylist?: string[] | undefined;
252
- user_agent_allow_regex?: string | undefined;
253
- user_agent_deny_regex?: string | undefined;
254
- ai_agent_policy?: {
255
- block_all?: boolean | undefined;
256
- deny_categories?: string[] | undefined;
257
- allow_categories?: string[] | undefined;
258
- } | undefined;
259
- } | undefined;
260
- }[] | undefined;
261
- }>, "many">;
73
+ deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
74
+ allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
75
+ }, z.core.$loose>>;
76
+ }, z.core.$loose>>;
77
+ created_at: z.ZodOptional<z.ZodString>;
78
+ expires_at: z.ZodOptional<z.ZodString>;
79
+ }, z.core.$loose>>>;
80
+ }, z.core.$loose>>;
262
81
  meta: z.ZodObject<{
263
82
  next_cursor: z.ZodOptional<z.ZodString>;
264
83
  has_more: z.ZodBoolean;
265
84
  page_size: z.ZodOptional<z.ZodNumber>;
266
85
  request_id: z.ZodOptional<z.ZodString>;
267
- }, "strip", z.ZodTypeAny, {
268
- has_more: boolean;
269
- next_cursor?: string | undefined;
270
- page_size?: number | undefined;
271
- request_id?: string | undefined;
272
- }, {
273
- has_more: boolean;
274
- next_cursor?: string | undefined;
275
- page_size?: number | undefined;
276
- request_id?: string | undefined;
277
- }>;
278
- }, "strip", z.ZodTypeAny, {
279
- meta: {
280
- has_more: boolean;
281
- next_cursor?: string | undefined;
282
- page_size?: number | undefined;
283
- request_id?: string | undefined;
284
- };
285
- data: {
286
- status: "active" | "revoked";
287
- created_at: string;
288
- expires_at: string;
289
- resource_id: string;
290
- target_url: string;
291
- qurl_site?: string | undefined;
292
- description?: string | undefined;
293
- tags?: string[] | undefined;
294
- custom_domain?: string | null | undefined;
295
- preserve_host?: boolean | undefined;
296
- qurl_count?: number | undefined;
297
- qurls?: {
298
- status: "active" | "consumed" | "expired" | "revoked";
299
- qurl_id: string;
300
- one_time_use: boolean;
301
- max_sessions: number;
302
- session_duration: number;
303
- use_count: number;
304
- created_at: string;
305
- expires_at: string;
306
- label?: string | undefined;
307
- qurl_site?: string | undefined;
308
- access_policy?: {
309
- ip_allowlist?: string[] | undefined;
310
- ip_denylist?: string[] | undefined;
311
- geo_allowlist?: string[] | undefined;
312
- geo_denylist?: string[] | undefined;
313
- user_agent_allow_regex?: string | undefined;
314
- user_agent_deny_regex?: string | undefined;
315
- ai_agent_policy?: {
316
- block_all?: boolean | undefined;
317
- deny_categories?: string[] | undefined;
318
- allow_categories?: string[] | undefined;
319
- } | undefined;
320
- } | undefined;
321
- }[] | undefined;
322
- }[];
323
- }, {
324
- meta: {
325
- has_more: boolean;
326
- next_cursor?: string | undefined;
327
- page_size?: number | undefined;
328
- request_id?: string | undefined;
329
- };
330
- data: {
331
- status: "active" | "revoked";
332
- created_at: string;
333
- expires_at: string;
334
- resource_id: string;
335
- target_url: string;
336
- qurl_site?: string | undefined;
337
- description?: string | undefined;
338
- tags?: string[] | undefined;
339
- custom_domain?: string | null | undefined;
340
- preserve_host?: boolean | undefined;
341
- qurl_count?: number | undefined;
342
- qurls?: {
343
- status: "active" | "consumed" | "expired" | "revoked";
344
- qurl_id: string;
345
- one_time_use: boolean;
346
- max_sessions: number;
347
- session_duration: number;
348
- use_count: number;
349
- created_at: string;
350
- expires_at: string;
351
- label?: string | undefined;
352
- qurl_site?: string | undefined;
353
- access_policy?: {
354
- ip_allowlist?: string[] | undefined;
355
- ip_denylist?: string[] | undefined;
356
- geo_allowlist?: string[] | undefined;
357
- geo_denylist?: string[] | undefined;
358
- user_agent_allow_regex?: string | undefined;
359
- user_agent_deny_regex?: string | undefined;
360
- ai_agent_policy?: {
361
- block_all?: boolean | undefined;
362
- deny_categories?: string[] | undefined;
363
- allow_categories?: string[] | undefined;
364
- } | undefined;
365
- } | undefined;
366
- }[] | undefined;
367
- }[];
368
- }>;
86
+ }, z.core.$loose>;
87
+ }, z.core.$loose>;
369
88
  annotations: {
370
89
  title: string;
371
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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoC1B,CAAC;AAEH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoChD"}
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
@@ -15,11 +15,29 @@ export const listQurlsSchema = z.object({
15
15
  .string()
16
16
  .min(1)
17
17
  .optional()
18
- .describe("Filter by status (comma-separated, e.g., 'active,revoked')"),
19
- created_after: z.string().datetime().optional().describe("Filter: created after this date (RFC 3339)"),
20
- created_before: z.string().datetime().optional().describe("Filter: created before this date (RFC 3339)"),
21
- expires_before: z.string().datetime().optional().describe("Filter: expires before this date (RFC 3339)"),
22
- expires_after: z.string().datetime().optional().describe("Filter: expires after this date (RFC 3339)"),
18
+ .describe("Filter by status (comma-separated, e.g. 'active,revoked'). " +
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."),
21
+ created_after: z
22
+ .string()
23
+ .datetime({ offset: true })
24
+ .optional()
25
+ .describe("Filter: created after this date (RFC 3339)"),
26
+ created_before: z
27
+ .string()
28
+ .datetime({ offset: true })
29
+ .optional()
30
+ .describe("Filter: created before this date (RFC 3339)"),
31
+ expires_before: z
32
+ .string()
33
+ .datetime({ offset: true })
34
+ .optional()
35
+ .describe("Filter: expires before this date (RFC 3339)"),
36
+ expires_after: z
37
+ .string()
38
+ .datetime({ offset: true })
39
+ .optional()
40
+ .describe("Filter: expires after this date (RFC 3339)"),
23
41
  sort: z
24
42
  .string()
25
43
  .regex(/^(created_at|expires_at)(:(asc|desc))?$/, "sort must be 'created_at' or 'expires_at', optionally followed by ':asc' or ':desc'")
@@ -27,24 +45,31 @@ export const listQurlsSchema = z.object({
27
45
  .describe("Sort field and direction as 'field:direction'. " +
28
46
  "Valid fields: created_at, expires_at. Valid directions: asc, desc (default desc). " +
29
47
  "Example: 'created_at:desc'."),
30
- q: z
31
- .string()
32
- .min(1)
33
- .optional()
34
- .describe("Search query (searches description and target_url)"),
48
+ q: z.string().min(1).optional().describe("Search query (searches description and target_url)"),
35
49
  });
36
- export function listQurlsTool(client) {
50
+ export function listQurlsTool(client, _runtime = { mode: "stdio" }) {
37
51
  return {
38
52
  name: "list_qurls",
39
53
  title: "List qURLs",
40
- description: "List qURL resources, paginated and optionally filtered. " +
41
- "Use this to discover qURLs by status (`active`, `revoked`), date range (created_*, expires_*), search text (`q`), or sort order. " +
42
- "Use `get_qurl` instead when you already have a specific resource ID. " +
43
- "**Pagination:** default page size is 20 (configurable via `limit` up to 100). " +
44
- "When the response sets `meta.has_more: true`, pass `meta.next_cursor` as the `cursor` argument on a subsequent call to fetch the next page. " +
45
- "**Sorting:** use `sort` like `created_at:desc` (default) or `expires_at:asc`. " +
46
- "**Response shape:** `{ data: QURL[], meta: { has_more, next_cursor?, page_size?, request_id? } }` — `data[]` items are the same stable resource shape returned by `get_qurl`, with no per-token detail (call `get_qurl` for `qurls[]`). " +
47
- 'Example: `list_qurls({ status: "active", sort: "expires_at:asc", limit: 10 })`.',
54
+ description: "List qURL resources, paginated and optionally filtered by status, date range, or search text. " +
55
+ "**When to use:** discovery — finding qURLs by status (e.g. everything still active), auditing date ranges, or full-text search across descriptions and target URLs (via the `q` parameter). " +
56
+ "Filters AND together (e.g. `status: 'active'` + `expires_before: '2026-05-01T00:00:00Z'` returns active qURLs about to expire). " +
57
+ "**When NOT to use:** use `get_qurl` instead when you already have a specific resource ID — it returns the same per-resource shape more cheaply and includes the `qurls[]` per-token detail that `list_qurls` omits. " +
58
+ "Use `resolve_qurl` to actually open access to a target URL. " +
59
+ "**Behavior:** read-only and idempotent. " +
60
+ "An empty `data[]` with `meta.has_more: false` means no resource matched the filters (not an error). " +
61
+ "Pagination is cursor-based: when `meta.has_more` is `true`, pass `meta.next_cursor` as `cursor` on the next call to fetch the following page. " +
62
+ "Default page size is 20, configurable via `limit` up to 100. " +
63
+ // TODO(#99): both the default-active claim above and the default-sort
64
+ // claim below are asserted from current API behavior — the spec only
65
+ // pins the sort *direction* default. The description intentionally
66
+ // drops the epistemics caveat (overhedging invites defensive
67
+ // over-specification) and pinning is tracked separately.
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. " +
70
+ "Sort defaults to `created_at:desc`; override with `sort: 'expires_at:asc'` etc. " +
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. " +
72
+ 'Example: `list_qurls({ status: "active", sort: "expires_at:asc", limit: 10 })` returns the 10 active qURLs expiring soonest.',
48
73
  inputSchema: listQurlsSchema,
49
74
  outputSchema: listQurlsOutputSchema,
50
75
  annotations: {
@@ -1 +1 @@
1
- {"version":3,"file":"list-qurls.js","sourceRoot":"","sources":["../../src/tools/list-qurls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACpF,iGAAiG;IACjG,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACzE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACtG,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACxG,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACxG,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACtG,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CACJ,yCAAyC,EACzC,qFAAqF,CACtF;SACA,QAAQ,EAAE;SACV,QAAQ,CACP,iDAAiD;QAC/C,oFAAoF;QACpF,6BAA6B,CAChC;IACH,CAAC,EAAE,CAAC;SACD,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC/C,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,0DAA0D;YAC1D,mIAAmI;YACnI,uEAAuE;YACvE,gFAAgF;YAChF,8IAA8I;YAC9I,gFAAgF;YAChF,0OAA0O;YAC1O,iFAAiF;QACnF,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE,qBAAqB;QACnC,WAAW,EAAE;YACX,KAAK,EAAE,YAAY;YACnB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAsC,EAAE,EAAE;YACjF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,qEAAqE;wBACrE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;qBAC7B;iBACF;gBACD,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC;aAC/C,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"list-qurls.js","sourceRoot":"","sources":["../../src/tools/list-qurls.ts"],"names":[],"mappings":"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"}