@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,215 +1,66 @@
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
- }, "strip", z.ZodTypeAny, {
6
- resource_id: string;
7
- }, {
8
- resource_id: string;
9
- }>;
10
- export declare function getQurlTool(client: IQURLClient): {
6
+ }, z.core.$strip>;
7
+ export declare function getQurlTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
11
8
  name: string;
12
9
  title: string;
13
10
  description: string;
14
11
  inputSchema: z.ZodObject<{
15
12
  resource_id: z.ZodString;
16
- }, "strip", z.ZodTypeAny, {
17
- resource_id: string;
18
- }, {
19
- resource_id: string;
20
- }>;
13
+ }, z.core.$strip>;
21
14
  outputSchema: z.ZodObject<{
22
15
  resource_id: z.ZodString;
23
16
  qurl_site: z.ZodOptional<z.ZodString>;
24
- target_url: z.ZodString;
17
+ target_url: z.ZodOptional<z.ZodString>;
25
18
  description: z.ZodOptional<z.ZodString>;
26
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
19
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
27
20
  expires_at: z.ZodString;
28
21
  created_at: z.ZodString;
29
- status: z.ZodEnum<["active", "revoked"]>;
22
+ status: z.ZodCatch<z.ZodEnum<{
23
+ active: "active";
24
+ expired: "expired";
25
+ revoked: "revoked";
26
+ unknown: "unknown";
27
+ }>>;
30
28
  custom_domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
29
+ slug: z.ZodOptional<z.ZodString>;
31
30
  preserve_host: z.ZodOptional<z.ZodBoolean>;
32
31
  qurl_count: z.ZodOptional<z.ZodNumber>;
33
32
  qurls: z.ZodOptional<z.ZodArray<z.ZodObject<{
34
33
  qurl_id: z.ZodString;
35
34
  label: z.ZodOptional<z.ZodString>;
36
- status: z.ZodEnum<["active", "consumed", "expired", "revoked"]>;
37
- one_time_use: z.ZodBoolean;
38
- max_sessions: z.ZodNumber;
39
- session_duration: z.ZodNumber;
40
- use_count: z.ZodNumber;
35
+ status: z.ZodCatch<z.ZodEnum<{
36
+ active: "active";
37
+ consumed: "consumed";
38
+ expired: "expired";
39
+ revoked: "revoked";
40
+ unknown: "unknown";
41
+ }>>;
42
+ one_time_use: z.ZodOptional<z.ZodBoolean>;
43
+ max_sessions: z.ZodOptional<z.ZodNumber>;
44
+ session_duration: z.ZodOptional<z.ZodNumber>;
45
+ use_count: z.ZodOptional<z.ZodNumber>;
41
46
  qurl_site: z.ZodOptional<z.ZodString>;
42
47
  access_policy: z.ZodOptional<z.ZodObject<{
43
- ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
44
- ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
45
- geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
46
- geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
48
+ ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
49
+ ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
50
+ geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
51
+ geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
47
52
  user_agent_allow_regex: z.ZodOptional<z.ZodString>;
48
53
  user_agent_deny_regex: z.ZodOptional<z.ZodString>;
49
54
  ai_agent_policy: z.ZodOptional<z.ZodObject<{
50
55
  block_all: z.ZodOptional<z.ZodBoolean>;
51
- deny_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
52
- allow_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
53
- }, "strip", z.ZodTypeAny, {
54
- block_all?: boolean | undefined;
55
- deny_categories?: string[] | undefined;
56
- allow_categories?: string[] | undefined;
57
- }, {
58
- block_all?: boolean | undefined;
59
- deny_categories?: string[] | undefined;
60
- allow_categories?: string[] | undefined;
61
- }>>;
62
- }, "strip", z.ZodTypeAny, {
63
- ip_allowlist?: string[] | undefined;
64
- ip_denylist?: string[] | undefined;
65
- geo_allowlist?: string[] | undefined;
66
- geo_denylist?: string[] | undefined;
67
- user_agent_allow_regex?: string | undefined;
68
- user_agent_deny_regex?: string | undefined;
69
- ai_agent_policy?: {
70
- block_all?: boolean | undefined;
71
- deny_categories?: string[] | undefined;
72
- allow_categories?: string[] | undefined;
73
- } | undefined;
74
- }, {
75
- ip_allowlist?: string[] | undefined;
76
- ip_denylist?: string[] | undefined;
77
- geo_allowlist?: string[] | undefined;
78
- geo_denylist?: string[] | undefined;
79
- user_agent_allow_regex?: string | undefined;
80
- user_agent_deny_regex?: string | undefined;
81
- ai_agent_policy?: {
82
- block_all?: boolean | undefined;
83
- deny_categories?: string[] | undefined;
84
- allow_categories?: string[] | undefined;
85
- } | undefined;
86
- }>>;
87
- created_at: z.ZodString;
88
- expires_at: z.ZodString;
89
- }, "strip", z.ZodTypeAny, {
90
- status: "active" | "consumed" | "expired" | "revoked";
91
- qurl_id: string;
92
- one_time_use: boolean;
93
- max_sessions: number;
94
- session_duration: number;
95
- use_count: number;
96
- created_at: string;
97
- expires_at: string;
98
- label?: string | undefined;
99
- qurl_site?: string | undefined;
100
- access_policy?: {
101
- ip_allowlist?: string[] | undefined;
102
- ip_denylist?: string[] | undefined;
103
- geo_allowlist?: string[] | undefined;
104
- geo_denylist?: string[] | undefined;
105
- user_agent_allow_regex?: string | undefined;
106
- user_agent_deny_regex?: string | undefined;
107
- ai_agent_policy?: {
108
- block_all?: boolean | undefined;
109
- deny_categories?: string[] | undefined;
110
- allow_categories?: string[] | undefined;
111
- } | undefined;
112
- } | undefined;
113
- }, {
114
- status: "active" | "consumed" | "expired" | "revoked";
115
- qurl_id: string;
116
- one_time_use: boolean;
117
- max_sessions: number;
118
- session_duration: number;
119
- use_count: number;
120
- created_at: string;
121
- expires_at: string;
122
- label?: string | undefined;
123
- qurl_site?: string | undefined;
124
- access_policy?: {
125
- ip_allowlist?: string[] | undefined;
126
- ip_denylist?: string[] | undefined;
127
- geo_allowlist?: string[] | undefined;
128
- geo_denylist?: string[] | undefined;
129
- user_agent_allow_regex?: string | undefined;
130
- user_agent_deny_regex?: string | undefined;
131
- ai_agent_policy?: {
132
- block_all?: boolean | undefined;
133
- deny_categories?: string[] | undefined;
134
- allow_categories?: string[] | undefined;
135
- } | undefined;
136
- } | undefined;
137
- }>, "many">>;
138
- }, "strip", z.ZodTypeAny, {
139
- status: "active" | "revoked";
140
- created_at: string;
141
- expires_at: string;
142
- resource_id: string;
143
- target_url: string;
144
- qurl_site?: string | undefined;
145
- description?: string | undefined;
146
- tags?: string[] | undefined;
147
- custom_domain?: string | null | undefined;
148
- preserve_host?: boolean | undefined;
149
- qurl_count?: number | undefined;
150
- qurls?: {
151
- status: "active" | "consumed" | "expired" | "revoked";
152
- qurl_id: string;
153
- one_time_use: boolean;
154
- max_sessions: number;
155
- session_duration: number;
156
- use_count: number;
157
- created_at: string;
158
- expires_at: string;
159
- label?: string | undefined;
160
- qurl_site?: string | undefined;
161
- access_policy?: {
162
- ip_allowlist?: string[] | undefined;
163
- ip_denylist?: string[] | undefined;
164
- geo_allowlist?: string[] | undefined;
165
- geo_denylist?: string[] | undefined;
166
- user_agent_allow_regex?: string | undefined;
167
- user_agent_deny_regex?: string | undefined;
168
- ai_agent_policy?: {
169
- block_all?: boolean | undefined;
170
- deny_categories?: string[] | undefined;
171
- allow_categories?: string[] | undefined;
172
- } | undefined;
173
- } | undefined;
174
- }[] | undefined;
175
- }, {
176
- status: "active" | "revoked";
177
- created_at: string;
178
- expires_at: string;
179
- resource_id: string;
180
- target_url: string;
181
- qurl_site?: string | undefined;
182
- description?: string | undefined;
183
- tags?: string[] | undefined;
184
- custom_domain?: string | null | undefined;
185
- preserve_host?: boolean | undefined;
186
- qurl_count?: number | undefined;
187
- qurls?: {
188
- status: "active" | "consumed" | "expired" | "revoked";
189
- qurl_id: string;
190
- one_time_use: boolean;
191
- max_sessions: number;
192
- session_duration: number;
193
- use_count: number;
194
- created_at: string;
195
- expires_at: string;
196
- label?: string | undefined;
197
- qurl_site?: string | undefined;
198
- access_policy?: {
199
- ip_allowlist?: string[] | undefined;
200
- ip_denylist?: string[] | undefined;
201
- geo_allowlist?: string[] | undefined;
202
- geo_denylist?: string[] | undefined;
203
- user_agent_allow_regex?: string | undefined;
204
- user_agent_deny_regex?: string | undefined;
205
- ai_agent_policy?: {
206
- block_all?: boolean | undefined;
207
- deny_categories?: string[] | undefined;
208
- allow_categories?: string[] | undefined;
209
- } | undefined;
210
- } | undefined;
211
- }[] | undefined;
212
- }>;
56
+ deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
57
+ allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
58
+ }, z.core.$loose>>;
59
+ }, z.core.$loose>>;
60
+ created_at: z.ZodOptional<z.ZodString>;
61
+ expires_at: z.ZodOptional<z.ZodString>;
62
+ }, z.core.$loose>>>;
63
+ }, z.core.$loose>;
213
64
  annotations: {
214
65
  title: string;
215
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;;;;;;EAExB,CAAC;AAEH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC9C"}
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,18 +1,21 @@
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
- description: "Fetch a single qURL resource by ID and return its current state plus all 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. " +
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 (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. " +
15
- "Returns the resource shape with embedded `qurls[]` (per-token state); the one-shot `qurl_link` from creation is never returned here.",
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`. " +
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. " +
18
+ "The one-shot `qurl_link` from creation is never returned here.",
16
19
  inputSchema: getQurlSchema,
17
20
  outputSchema: getQurlOutputSchema,
18
21
  annotations: {
@@ -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,0FAA0F;YAC1F,gJAAgJ;YAChJ,mGAAmG;YACnG,+HAA+H;YAC/H,sIAAsI;QACxI,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"}
@@ -0,0 +1,45 @@
1
+ import { z } from "zod";
2
+ import type { IQURLClient } from "../client.js";
3
+ import { type ToolRuntimeOptions } from "./_shared.js";
4
+ export declare const listQurlSessionsSchema: z.ZodObject<{
5
+ resource_id: z.ZodString;
6
+ }, z.core.$strip>;
7
+ export declare function listQurlSessionsTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
8
+ name: string;
9
+ title: string;
10
+ description: string;
11
+ inputSchema: z.ZodObject<{
12
+ resource_id: z.ZodString;
13
+ }, z.core.$strip>;
14
+ outputSchema: z.ZodObject<{
15
+ data: z.ZodArray<z.ZodObject<{
16
+ session_id: z.ZodString;
17
+ qurl_id: z.ZodOptional<z.ZodString>;
18
+ src_ip: z.ZodOptional<z.ZodString>;
19
+ user_agent: z.ZodOptional<z.ZodString>;
20
+ created_at: z.ZodOptional<z.ZodString>;
21
+ last_seen_at: z.ZodOptional<z.ZodString>;
22
+ }, z.core.$loose>>;
23
+ meta: z.ZodOptional<z.ZodObject<{
24
+ request_id: z.ZodOptional<z.ZodString>;
25
+ }, z.core.$loose>>;
26
+ }, z.core.$loose>;
27
+ annotations: {
28
+ title: string;
29
+ readOnlyHint: boolean;
30
+ destructiveHint: boolean;
31
+ idempotentHint: boolean;
32
+ openWorldHint: boolean;
33
+ };
34
+ handler: (input: {
35
+ resource_id: string;
36
+ }) => Promise<{
37
+ content: Array<{
38
+ type: "text";
39
+ text: string;
40
+ }>;
41
+ structuredContent?: Record<string, unknown>;
42
+ isError?: boolean;
43
+ }>;
44
+ };
45
+ //# sourceMappingURL=list-qurl-sessions.d.ts.map
@@ -0,0 +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;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"}
@@ -0,0 +1,33 @@
1
+ import { z } from "zod";
2
+ import { resourceOnlyIdSchema, toStructuredContent, withMissingApiKeyHandler, } from "./_shared.js";
3
+ import { listQurlSessionsOutputSchema } from "./output-schemas.js";
4
+ export const listQurlSessionsSchema = z.object({
5
+ resource_id: resourceOnlyIdSchema("list active sessions for"),
6
+ });
7
+ export function listQurlSessionsTool(client, _runtime = { mode: "stdio" }) {
8
+ return {
9
+ name: "list_qurl_sessions",
10
+ title: "List qURL Sessions",
11
+ description: "List active access sessions for a qURL resource. " +
12
+ "Use this to inspect who currently has live access before rotating, revoking, or terminating sessions. " +
13
+ "Use `terminate_qurl_sessions` when active sessions should be ended, and use `get_qurl` when you need token/resource metadata instead of active session state. " +
14
+ "**Behavior:** read-only and idempotent. Empty `data[]` means no active sessions for the resource.",
15
+ inputSchema: listQurlSessionsSchema,
16
+ outputSchema: listQurlSessionsOutputSchema,
17
+ annotations: {
18
+ title: "List qURL Sessions",
19
+ readOnlyHint: true,
20
+ destructiveHint: false,
21
+ idempotentHint: true,
22
+ openWorldHint: true,
23
+ },
24
+ handler: withMissingApiKeyHandler(async (input) => {
25
+ const result = await client.listResourceSessions(input.resource_id);
26
+ return {
27
+ content: [{ type: "text", text: JSON.stringify(result) }],
28
+ structuredContent: toStructuredContent(result),
29
+ };
30
+ }),
31
+ };
32
+ }
33
+ //# sourceMappingURL=list-qurl-sessions.js.map
@@ -0,0 +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,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"}