@layervai/qurl-mcp 0.4.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 (83) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +98 -0
  3. package/dist/client.d.ts +278 -0
  4. package/dist/client.d.ts.map +1 -0
  5. package/dist/client.js +156 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/index.d.ts +3 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +34 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/prompts/audit-links.d.ts +7 -0
  12. package/dist/prompts/audit-links.d.ts.map +1 -0
  13. package/dist/prompts/audit-links.js +31 -0
  14. package/dist/prompts/audit-links.js.map +1 -0
  15. package/dist/prompts/rotate-access.d.ts +18 -0
  16. package/dist/prompts/rotate-access.d.ts.map +1 -0
  17. package/dist/prompts/rotate-access.js +41 -0
  18. package/dist/prompts/rotate-access.js.map +1 -0
  19. package/dist/prompts/secure-a-service.d.ts +38 -0
  20. package/dist/prompts/secure-a-service.d.ts.map +1 -0
  21. package/dist/prompts/secure-a-service.js +141 -0
  22. package/dist/prompts/secure-a-service.js.map +1 -0
  23. package/dist/resources/_shared.d.ts +31 -0
  24. package/dist/resources/_shared.d.ts.map +1 -0
  25. package/dist/resources/_shared.js +42 -0
  26. package/dist/resources/_shared.js.map +1 -0
  27. package/dist/resources/links.d.ts +15 -0
  28. package/dist/resources/links.d.ts.map +1 -0
  29. package/dist/resources/links.js +22 -0
  30. package/dist/resources/links.js.map +1 -0
  31. package/dist/resources/usage.d.ts +15 -0
  32. package/dist/resources/usage.d.ts.map +1 -0
  33. package/dist/resources/usage.js +18 -0
  34. package/dist/resources/usage.js.map +1 -0
  35. package/dist/server.d.ts +37 -0
  36. package/dist/server.d.ts.map +1 -0
  37. package/dist/server.js +58 -0
  38. package/dist/server.js.map +1 -0
  39. package/dist/tools/_shared.d.ts +78 -0
  40. package/dist/tools/_shared.d.ts.map +1 -0
  41. package/dist/tools/_shared.js +80 -0
  42. package/dist/tools/_shared.js.map +1 -0
  43. package/dist/tools/batch-create.d.ts +426 -0
  44. package/dist/tools/batch-create.d.ts.map +1 -0
  45. package/dist/tools/batch-create.js +81 -0
  46. package/dist/tools/batch-create.js.map +1 -0
  47. package/dist/tools/create-qurl.d.ts +316 -0
  48. package/dist/tools/create-qurl.d.ts.map +1 -0
  49. package/dist/tools/create-qurl.js +106 -0
  50. package/dist/tools/create-qurl.js.map +1 -0
  51. package/dist/tools/delete-qurl.d.ts +55 -0
  52. package/dist/tools/delete-qurl.d.ts.map +1 -0
  53. package/dist/tools/delete-qurl.js +76 -0
  54. package/dist/tools/delete-qurl.js.map +1 -0
  55. package/dist/tools/extend-qurl.d.ts +238 -0
  56. package/dist/tools/extend-qurl.d.ts.map +1 -0
  57. package/dist/tools/extend-qurl.js +45 -0
  58. package/dist/tools/extend-qurl.js.map +1 -0
  59. package/dist/tools/get-qurl.d.ts +231 -0
  60. package/dist/tools/get-qurl.d.ts.map +1 -0
  61. package/dist/tools/get-qurl.js +39 -0
  62. package/dist/tools/get-qurl.js.map +1 -0
  63. package/dist/tools/list-qurls.d.ts +395 -0
  64. package/dist/tools/list-qurls.d.ts.map +1 -0
  65. package/dist/tools/list-qurls.js +72 -0
  66. package/dist/tools/list-qurls.js.map +1 -0
  67. package/dist/tools/mint-link.d.ts +384 -0
  68. package/dist/tools/mint-link.d.ts.map +1 -0
  69. package/dist/tools/mint-link.js +75 -0
  70. package/dist/tools/mint-link.js.map +1 -0
  71. package/dist/tools/output-schemas.d.ts +1261 -0
  72. package/dist/tools/output-schemas.d.ts.map +1 -0
  73. package/dist/tools/output-schemas.js +173 -0
  74. package/dist/tools/output-schemas.js.map +1 -0
  75. package/dist/tools/resolve-qurl.d.ts +72 -0
  76. package/dist/tools/resolve-qurl.d.ts.map +1 -0
  77. package/dist/tools/resolve-qurl.js +42 -0
  78. package/dist/tools/resolve-qurl.js.map +1 -0
  79. package/dist/tools/update-qurl.d.ts +330 -0
  80. package/dist/tools/update-qurl.d.ts.map +1 -0
  81. package/dist/tools/update-qurl.js +96 -0
  82. package/dist/tools/update-qurl.js.map +1 -0
  83. package/package.json +58 -0
@@ -0,0 +1,395 @@
1
+ import { z } from "zod";
2
+ import type { IQURLClient } from "../client.js";
3
+ export declare const listQurlsSchema: z.ZodObject<{
4
+ limit: z.ZodOptional<z.ZodNumber>;
5
+ cursor: z.ZodOptional<z.ZodString>;
6
+ status: z.ZodOptional<z.ZodString>;
7
+ created_after: z.ZodOptional<z.ZodString>;
8
+ created_before: z.ZodOptional<z.ZodString>;
9
+ expires_before: z.ZodOptional<z.ZodString>;
10
+ expires_after: z.ZodOptional<z.ZodString>;
11
+ sort: z.ZodOptional<z.ZodString>;
12
+ 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): {
35
+ name: string;
36
+ title: string;
37
+ description: string;
38
+ inputSchema: z.ZodObject<{
39
+ limit: z.ZodOptional<z.ZodNumber>;
40
+ cursor: z.ZodOptional<z.ZodString>;
41
+ status: z.ZodOptional<z.ZodString>;
42
+ created_after: z.ZodOptional<z.ZodString>;
43
+ created_before: z.ZodOptional<z.ZodString>;
44
+ expires_before: z.ZodOptional<z.ZodString>;
45
+ expires_after: z.ZodOptional<z.ZodString>;
46
+ sort: z.ZodOptional<z.ZodString>;
47
+ 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
+ }>;
69
+ outputSchema: z.ZodObject<{
70
+ data: z.ZodArray<z.ZodObject<{
71
+ resource_id: z.ZodString;
72
+ qurl_site: z.ZodOptional<z.ZodString>;
73
+ target_url: z.ZodString;
74
+ description: z.ZodOptional<z.ZodString>;
75
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
76
+ expires_at: z.ZodString;
77
+ created_at: z.ZodString;
78
+ status: z.ZodEnum<["active", "revoked"]>;
79
+ custom_domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
80
+ preserve_host: z.ZodOptional<z.ZodBoolean>;
81
+ qurl_count: z.ZodOptional<z.ZodNumber>;
82
+ qurls: z.ZodOptional<z.ZodArray<z.ZodObject<{
83
+ qurl_id: z.ZodString;
84
+ 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;
90
+ qurl_site: z.ZodOptional<z.ZodString>;
91
+ 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">>;
96
+ user_agent_allow_regex: z.ZodOptional<z.ZodString>;
97
+ user_agent_deny_regex: z.ZodOptional<z.ZodString>;
98
+ ai_agent_policy: z.ZodOptional<z.ZodObject<{
99
+ 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">;
262
+ meta: z.ZodObject<{
263
+ next_cursor: z.ZodOptional<z.ZodString>;
264
+ has_more: z.ZodBoolean;
265
+ page_size: z.ZodOptional<z.ZodNumber>;
266
+ 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
+ }>;
369
+ annotations: {
370
+ title: string;
371
+ readOnlyHint: boolean;
372
+ destructiveHint: boolean;
373
+ idempotentHint: boolean;
374
+ openWorldHint: boolean;
375
+ };
376
+ handler: (input: {
377
+ limit?: number | undefined;
378
+ cursor?: string | undefined;
379
+ status?: string | undefined;
380
+ created_after?: string | undefined;
381
+ created_before?: string | undefined;
382
+ expires_before?: string | undefined;
383
+ expires_after?: string | undefined;
384
+ sort?: string | undefined;
385
+ q?: string | undefined;
386
+ }) => Promise<{
387
+ content: Array<{
388
+ type: "text";
389
+ text: string;
390
+ }>;
391
+ structuredContent?: Record<string, unknown>;
392
+ isError?: boolean;
393
+ }>;
394
+ };
395
+ //# sourceMappingURL=list-qurls.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,72 @@
1
+ import { z } from "zod";
2
+ import { toStructuredContent, withMissingApiKeyHandler } from "./_shared.js";
3
+ import { listQurlsOutputSchema } from "./output-schemas.js";
4
+ export const listQurlsSchema = z.object({
5
+ limit: z
6
+ .number()
7
+ .int()
8
+ .min(1)
9
+ .max(100)
10
+ .optional()
11
+ .describe("Maximum number of qURLs to return (default: 20)"),
12
+ cursor: z.string().optional().describe("Pagination cursor from a previous response"),
13
+ // Plain string (not z.enum) because the API accepts comma-separated values like "active,revoked"
14
+ status: z
15
+ .string()
16
+ .min(1)
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)"),
23
+ sort: z
24
+ .string()
25
+ .regex(/^(created_at|expires_at)(:(asc|desc))?$/, "sort must be 'created_at' or 'expires_at', optionally followed by ':asc' or ':desc'")
26
+ .optional()
27
+ .describe("Sort field and direction as 'field:direction'. " +
28
+ "Valid fields: created_at, expires_at. Valid directions: asc, desc (default desc). " +
29
+ "Example: 'created_at:desc'."),
30
+ q: z
31
+ .string()
32
+ .min(1)
33
+ .optional()
34
+ .describe("Search query (searches description and target_url)"),
35
+ });
36
+ export function listQurlsTool(client) {
37
+ return {
38
+ name: "list_qurls",
39
+ 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 })`.',
48
+ inputSchema: listQurlsSchema,
49
+ outputSchema: listQurlsOutputSchema,
50
+ annotations: {
51
+ title: "List qURLs",
52
+ readOnlyHint: true,
53
+ destructiveHint: false,
54
+ idempotentHint: true,
55
+ openWorldHint: true,
56
+ },
57
+ handler: withMissingApiKeyHandler(async (input) => {
58
+ const result = await client.listQURLs(input);
59
+ return {
60
+ content: [
61
+ {
62
+ type: "text",
63
+ // Full result (not .data) — includes meta.next_cursor for pagination
64
+ text: JSON.stringify(result),
65
+ },
66
+ ],
67
+ structuredContent: toStructuredContent(result),
68
+ };
69
+ }),
70
+ };
71
+ }
72
+ //# sourceMappingURL=list-qurls.js.map
@@ -0,0 +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"}