@layervai/qurl-mcp 0.4.0 → 0.4.1

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 (74) hide show
  1. package/README.md +5 -1
  2. package/dist/client.d.ts +111 -22
  3. package/dist/client.d.ts.map +1 -1
  4. package/dist/client.js +161 -77
  5. package/dist/client.js.map +1 -1
  6. package/dist/index.js +3 -2
  7. package/dist/index.js.map +1 -1
  8. package/dist/prompts/secure-a-service.d.ts +16 -4
  9. package/dist/prompts/secure-a-service.d.ts.map +1 -1
  10. package/dist/prompts/secure-a-service.js +7 -15
  11. package/dist/prompts/secure-a-service.js.map +1 -1
  12. package/dist/server.d.ts +7 -3
  13. package/dist/server.d.ts.map +1 -1
  14. package/dist/server.js +8 -0
  15. package/dist/server.js.map +1 -1
  16. package/dist/tools/_shared.d.ts +4 -2
  17. package/dist/tools/_shared.d.ts.map +1 -1
  18. package/dist/tools/_shared.js +15 -3
  19. package/dist/tools/_shared.js.map +1 -1
  20. package/dist/tools/batch-create.d.ts +31 -339
  21. package/dist/tools/batch-create.d.ts.map +1 -1
  22. package/dist/tools/batch-create.js +1 -0
  23. package/dist/tools/batch-create.js.map +1 -1
  24. package/dist/tools/create-qurl.d.ts +37 -234
  25. package/dist/tools/create-qurl.d.ts.map +1 -1
  26. package/dist/tools/create-qurl.js +25 -28
  27. package/dist/tools/create-qurl.js.map +1 -1
  28. package/dist/tools/delete-qurl.d.ts +3 -21
  29. package/dist/tools/delete-qurl.d.ts.map +1 -1
  30. package/dist/tools/delete-qurl.js +18 -5
  31. package/dist/tools/delete-qurl.js.map +1 -1
  32. package/dist/tools/extend-qurl.d.ts +34 -188
  33. package/dist/tools/extend-qurl.d.ts.map +1 -1
  34. package/dist/tools/get-qurl.d.ts +34 -184
  35. package/dist/tools/get-qurl.d.ts.map +1 -1
  36. package/dist/tools/get-qurl.js +3 -2
  37. package/dist/tools/get-qurl.js.map +1 -1
  38. package/dist/tools/list-qurl-sessions.d.ts +44 -0
  39. package/dist/tools/list-qurl-sessions.d.ts.map +1 -0
  40. package/dist/tools/list-qurl-sessions.js +33 -0
  41. package/dist/tools/list-qurl-sessions.js.map +1 -0
  42. package/dist/tools/list-qurls.d.ts +36 -318
  43. package/dist/tools/list-qurls.d.ts.map +1 -1
  44. package/dist/tools/list-qurls.js +41 -18
  45. package/dist/tools/list-qurls.js.map +1 -1
  46. package/dist/tools/mint-link.d.ts +34 -301
  47. package/dist/tools/mint-link.d.ts.map +1 -1
  48. package/dist/tools/mint-link.js +12 -9
  49. package/dist/tools/mint-link.js.map +1 -1
  50. package/dist/tools/output-schemas.d.ts +266 -1109
  51. package/dist/tools/output-schemas.d.ts.map +1 -1
  52. package/dist/tools/output-schemas.js +96 -20
  53. package/dist/tools/output-schemas.js.map +1 -1
  54. package/dist/tools/resolve-qurl.d.ts +4 -36
  55. package/dist/tools/resolve-qurl.d.ts.map +1 -1
  56. package/dist/tools/resolve-qurl.js +2 -2
  57. package/dist/tools/resolve-qurl.js.map +1 -1
  58. package/dist/tools/revoke-qurl-token.d.ts +40 -0
  59. package/dist/tools/revoke-qurl-token.d.ts.map +1 -0
  60. package/dist/tools/revoke-qurl-token.js +40 -0
  61. package/dist/tools/revoke-qurl-token.js.map +1 -0
  62. package/dist/tools/terminate-qurl-sessions.d.ts +40 -0
  63. package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -0
  64. package/dist/tools/terminate-qurl-sessions.js +64 -0
  65. package/dist/tools/terminate-qurl-sessions.js.map +1 -0
  66. package/dist/tools/update-qurl-token.d.ts +141 -0
  67. package/dist/tools/update-qurl-token.d.ts.map +1 -0
  68. package/dist/tools/update-qurl-token.js +75 -0
  69. package/dist/tools/update-qurl-token.js.map +1 -0
  70. package/dist/tools/update-qurl.d.ts +41 -263
  71. package/dist/tools/update-qurl.d.ts.map +1 -1
  72. package/dist/tools/update-qurl.js +56 -7
  73. package/dist/tools/update-qurl.js.map +1 -1
  74. package/package.json +4 -3
@@ -10,27 +10,7 @@ export declare const listQurlsSchema: z.ZodObject<{
10
10
  expires_after: z.ZodOptional<z.ZodString>;
11
11
  sort: z.ZodOptional<z.ZodString>;
12
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
- }>;
13
+ }, z.core.$strip>;
34
14
  export declare function listQurlsTool(client: IQURLClient): {
35
15
  name: string;
36
16
  title: string;
@@ -45,327 +25,65 @@ export declare function listQurlsTool(client: IQURLClient): {
45
25
  expires_after: z.ZodOptional<z.ZodString>;
46
26
  sort: z.ZodOptional<z.ZodString>;
47
27
  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
- }>;
28
+ }, z.core.$strip>;
69
29
  outputSchema: z.ZodObject<{
70
30
  data: z.ZodArray<z.ZodObject<{
71
31
  resource_id: z.ZodString;
72
32
  qurl_site: z.ZodOptional<z.ZodString>;
73
- target_url: z.ZodString;
33
+ target_url: z.ZodOptional<z.ZodString>;
74
34
  description: z.ZodOptional<z.ZodString>;
75
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
35
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
76
36
  expires_at: z.ZodString;
77
37
  created_at: z.ZodString;
78
- status: z.ZodEnum<["active", "revoked"]>;
38
+ status: z.ZodCatch<z.ZodEnum<{
39
+ active: "active";
40
+ expired: "expired";
41
+ revoked: "revoked";
42
+ unknown: "unknown";
43
+ }>>;
79
44
  custom_domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
45
+ slug: z.ZodOptional<z.ZodString>;
80
46
  preserve_host: z.ZodOptional<z.ZodBoolean>;
81
47
  qurl_count: z.ZodOptional<z.ZodNumber>;
82
48
  qurls: z.ZodOptional<z.ZodArray<z.ZodObject<{
83
49
  qurl_id: z.ZodString;
84
50
  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;
51
+ status: z.ZodCatch<z.ZodEnum<{
52
+ active: "active";
53
+ consumed: "consumed";
54
+ expired: "expired";
55
+ revoked: "revoked";
56
+ unknown: "unknown";
57
+ }>>;
58
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
59
+ max_sessions: z.ZodOptional<z.ZodNumber>;
60
+ session_duration: z.ZodOptional<z.ZodNumber>;
61
+ use_count: z.ZodOptional<z.ZodNumber>;
90
62
  qurl_site: z.ZodOptional<z.ZodString>;
91
63
  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">>;
64
+ ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
65
+ ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
66
+ geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
67
+ geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
96
68
  user_agent_allow_regex: z.ZodOptional<z.ZodString>;
97
69
  user_agent_deny_regex: z.ZodOptional<z.ZodString>;
98
70
  ai_agent_policy: z.ZodOptional<z.ZodObject<{
99
71
  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">;
72
+ deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
73
+ allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
74
+ }, z.core.$strip>>;
75
+ }, z.core.$strip>>;
76
+ created_at: z.ZodOptional<z.ZodString>;
77
+ expires_at: z.ZodOptional<z.ZodString>;
78
+ }, z.core.$strip>>>;
79
+ }, z.core.$strip>>;
262
80
  meta: z.ZodObject<{
263
81
  next_cursor: z.ZodOptional<z.ZodString>;
264
82
  has_more: z.ZodBoolean;
265
83
  page_size: z.ZodOptional<z.ZodNumber>;
266
84
  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
- }>;
85
+ }, z.core.$strip>;
86
+ }, z.core.$strip>;
369
87
  annotations: {
370
88
  title: string;
371
89
  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;AAIhD,eAAO,MAAM,eAAe;;;;;;;;;;iBAmD1B,CAAC;AAEH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8ChD"}
@@ -15,11 +15,28 @@ 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
+ created_after: z
21
+ .string()
22
+ .datetime()
23
+ .optional()
24
+ .describe("Filter: created after this date (RFC 3339)"),
25
+ created_before: z
26
+ .string()
27
+ .datetime()
28
+ .optional()
29
+ .describe("Filter: created before this date (RFC 3339)"),
30
+ expires_before: z
31
+ .string()
32
+ .datetime()
33
+ .optional()
34
+ .describe("Filter: expires before this date (RFC 3339)"),
35
+ expires_after: z
36
+ .string()
37
+ .datetime()
38
+ .optional()
39
+ .describe("Filter: expires after this date (RFC 3339)"),
23
40
  sort: z
24
41
  .string()
25
42
  .regex(/^(created_at|expires_at)(:(asc|desc))?$/, "sort must be 'created_at' or 'expires_at', optionally followed by ':asc' or ':desc'")
@@ -27,24 +44,30 @@ export const listQurlsSchema = z.object({
27
44
  .describe("Sort field and direction as 'field:direction'. " +
28
45
  "Valid fields: created_at, expires_at. Valid directions: asc, desc (default desc). " +
29
46
  "Example: 'created_at:desc'."),
30
- q: z
31
- .string()
32
- .min(1)
33
- .optional()
34
- .describe("Search query (searches description and target_url)"),
47
+ q: z.string().min(1).optional().describe("Search query (searches description and target_url)"),
35
48
  });
36
49
  export function listQurlsTool(client) {
37
50
  return {
38
51
  name: "list_qurls",
39
52
  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 })`.',
53
+ description: "List qURL resources, paginated and optionally filtered by status, date range, or search text. " +
54
+ "**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). " +
55
+ "Filters AND together (e.g. `status: 'active'` + `expires_before: '2026-05-01T00:00:00Z'` returns active qURLs about to expire). " +
56
+ "**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. " +
57
+ "Use `resolve_qurl` to actually open access to a target URL. " +
58
+ "**Behavior:** read-only and idempotent. " +
59
+ "An empty `data[]` with `meta.has_more: false` means no resource matched the filters (not an error). " +
60
+ "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. " +
61
+ "Default page size is 20, configurable via `limit` up to 100. " +
62
+ // TODO(#99): both the default-active claim above and the default-sort
63
+ // claim below are asserted from current API behavior — the spec only
64
+ // pins the sort *direction* default. The description intentionally
65
+ // drops the epistemics caveat (overhedging invites defensive
66
+ // over-specification) and pinning is tracked separately.
67
+ "By default only `active` qURLs are returned; pass `status: 'revoked'` to see only revoked qURLs or `'active,revoked'` to see both. " +
68
+ "Sort defaults to `created_at:desc`; override with `sort: 'expires_at:asc'` etc. " +
69
+ "**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
+ 'Example: `list_qurls({ status: "active", sort: "expires_at:asc", limit: 10 })` returns the 10 active qURLs expiring soonest.',
48
71
  inputSchema: listQurlsSchema,
49
72
  outputSchema: listQurlsOutputSchema,
50
73
  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":"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,CACP,6DAA6D;QAC3D,oFAAoF,CACvF;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;IACzD,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;IACzD,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,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;CAC/F,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC/C,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,gGAAgG;YAChG,8LAA8L;YAC9L,kIAAkI;YAClI,sNAAsN;YACtN,8DAA8D;YAC9D,0CAA0C;YAC1C,sGAAsG;YACtG,gJAAgJ;YAChJ,+DAA+D;YAC/D,sEAAsE;YACtE,qEAAqE;YACrE,mEAAmE;YACnE,6DAA6D;YAC7D,yDAAyD;YACzD,qIAAqI;YACrI,kFAAkF;YAClF,oOAAoO;YACpO,8HAA8H;QAChI,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"}