@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.
- package/README.md +742 -46
- package/assets/fonts/NotoSansSC-Regular.ttf +0 -0
- package/assets/fonts/OFL.txt +93 -0
- package/assets/fonts/README.md +18 -0
- package/dist/auth/request-context.d.ts +13 -0
- package/dist/auth/request-context.d.ts.map +1 -0
- package/dist/auth/request-context.js +21 -0
- package/dist/auth/request-context.js.map +1 -0
- package/dist/auth/static-bearer.d.ts +12 -0
- package/dist/auth/static-bearer.d.ts.map +1 -0
- package/dist/auth/static-bearer.js +47 -0
- package/dist/auth/static-bearer.js.map +1 -0
- package/dist/client.d.ts +112 -23
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +173 -78
- package/dist/client.js.map +1 -1
- package/dist/config.d.ts +98 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +543 -0
- package/dist/config.js.map +1 -0
- package/dist/credential-rate-limit-store.d.ts +38 -0
- package/dist/credential-rate-limit-store.d.ts.map +1 -0
- package/dist/credential-rate-limit-store.js +135 -0
- package/dist/credential-rate-limit-store.js.map +1 -0
- package/dist/email-addresses.d.ts +7 -0
- package/dist/email-addresses.d.ts.map +1 -0
- package/dist/email-addresses.js +36 -0
- package/dist/email-addresses.js.map +1 -0
- package/dist/email-types.d.ts +33 -0
- package/dist/email-types.d.ts.map +1 -0
- package/dist/email-types.js +28 -0
- package/dist/email-types.js.map +1 -0
- package/dist/emf-metrics.d.ts +25 -0
- package/dist/emf-metrics.d.ts.map +1 -0
- package/dist/emf-metrics.js +87 -0
- package/dist/emf-metrics.js.map +1 -0
- package/dist/http-config.d.ts +38 -0
- package/dist/http-config.d.ts.map +1 -0
- package/dist/http-config.js +243 -0
- package/dist/http-config.js.map +1 -0
- package/dist/http-routes.d.ts +5 -0
- package/dist/http-routes.d.ts.map +1 -0
- package/dist/http-routes.js +12 -0
- package/dist/http-routes.js.map +1 -0
- package/dist/http.d.ts +33 -0
- package/dist/http.d.ts.map +1 -0
- package/dist/http.js +1116 -0
- package/dist/http.js.map +1 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +42 -25
- package/dist/index.js.map +1 -1
- package/dist/logging.d.ts +7 -0
- package/dist/logging.d.ts.map +1 -0
- package/dist/logging.js +110 -0
- package/dist/logging.js.map +1 -0
- package/dist/prompts/secure-a-service.d.ts +16 -4
- package/dist/prompts/secure-a-service.d.ts.map +1 -1
- package/dist/prompts/secure-a-service.js +7 -15
- package/dist/prompts/secure-a-service.js.map +1 -1
- package/dist/server.d.ts +18 -6
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +41 -8
- package/dist/server.js.map +1 -1
- package/dist/services/email.d.ts +17 -0
- package/dist/services/email.d.ts.map +1 -0
- package/dist/services/email.js +351 -0
- package/dist/services/email.js.map +1 -0
- package/dist/services/html.d.ts +5 -0
- package/dist/services/html.d.ts.map +1 -0
- package/dist/services/html.js +28 -0
- package/dist/services/html.js.map +1 -0
- package/dist/services/legal-pages.d.ts +12 -0
- package/dist/services/legal-pages.d.ts.map +1 -0
- package/dist/services/legal-pages.js +588 -0
- package/dist/services/legal-pages.js.map +1 -0
- package/dist/services/text-pdf.d.ts +16 -0
- package/dist/services/text-pdf.d.ts.map +1 -0
- package/dist/services/text-pdf.js +141 -0
- package/dist/services/text-pdf.js.map +1 -0
- package/dist/services/video-page.d.ts +4 -0
- package/dist/services/video-page.d.ts.map +1 -0
- package/dist/services/video-page.js +311 -0
- package/dist/services/video-page.js.map +1 -0
- package/dist/text.d.ts +4 -0
- package/dist/text.d.ts.map +1 -0
- package/dist/text.js +16 -0
- package/dist/text.js.map +1 -0
- package/dist/tools/_shared.d.ts +13 -3
- package/dist/tools/_shared.d.ts.map +1 -1
- package/dist/tools/_shared.js +31 -7
- package/dist/tools/_shared.js.map +1 -1
- package/dist/tools/batch-create.d.ts +36 -343
- package/dist/tools/batch-create.d.ts.map +1 -1
- package/dist/tools/batch-create.js +7 -4
- package/dist/tools/batch-create.js.map +1 -1
- package/dist/tools/create-qurl.d.ts +79 -237
- package/dist/tools/create-qurl.d.ts.map +1 -1
- package/dist/tools/create-qurl.js +77 -47
- package/dist/tools/create-qurl.js.map +1 -1
- package/dist/tools/delete-qurl.d.ts +5 -22
- package/dist/tools/delete-qurl.d.ts.map +1 -1
- package/dist/tools/delete-qurl.js +19 -13
- package/dist/tools/delete-qurl.js.map +1 -1
- package/dist/tools/email-delivery.d.ts +37 -0
- package/dist/tools/email-delivery.d.ts.map +1 -0
- package/dist/tools/email-delivery.js +115 -0
- package/dist/tools/email-delivery.js.map +1 -0
- package/dist/tools/extend-qurl.d.ts +36 -189
- package/dist/tools/extend-qurl.d.ts.map +1 -1
- package/dist/tools/extend-qurl.js +3 -3
- package/dist/tools/extend-qurl.js.map +1 -1
- package/dist/tools/get-qurl.d.ts +36 -185
- package/dist/tools/get-qurl.d.ts.map +1 -1
- package/dist/tools/get-qurl.js +8 -5
- package/dist/tools/get-qurl.js.map +1 -1
- package/dist/tools/list-qurl-sessions.d.ts +45 -0
- package/dist/tools/list-qurl-sessions.d.ts.map +1 -0
- package/dist/tools/list-qurl-sessions.js +33 -0
- package/dist/tools/list-qurl-sessions.js.map +1 -0
- package/dist/tools/list-qurls.d.ts +38 -319
- package/dist/tools/list-qurls.d.ts.map +1 -1
- package/dist/tools/list-qurls.js +45 -20
- package/dist/tools/list-qurls.js.map +1 -1
- package/dist/tools/mint-link.d.ts +72 -303
- package/dist/tools/mint-link.d.ts.map +1 -1
- package/dist/tools/mint-link.js +35 -21
- package/dist/tools/mint-link.js.map +1 -1
- package/dist/tools/output-schemas.d.ts +326 -1112
- package/dist/tools/output-schemas.d.ts.map +1 -1
- package/dist/tools/output-schemas.js +141 -40
- package/dist/tools/output-schemas.js.map +1 -1
- package/dist/tools/resolve-qurl.d.ts +6 -37
- package/dist/tools/resolve-qurl.d.ts.map +1 -1
- package/dist/tools/resolve-qurl.js +5 -5
- package/dist/tools/resolve-qurl.js.map +1 -1
- package/dist/tools/revoke-qurl-token.d.ts +41 -0
- package/dist/tools/revoke-qurl-token.d.ts.map +1 -0
- package/dist/tools/revoke-qurl-token.js +40 -0
- package/dist/tools/revoke-qurl-token.js.map +1 -0
- package/dist/tools/terminate-qurl-sessions.d.ts +41 -0
- package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -0
- package/dist/tools/terminate-qurl-sessions.js +68 -0
- package/dist/tools/terminate-qurl-sessions.js.map +1 -0
- package/dist/tools/update-qurl-token.d.ts +142 -0
- package/dist/tools/update-qurl-token.d.ts.map +1 -0
- package/dist/tools/update-qurl-token.js +75 -0
- package/dist/tools/update-qurl-token.js.map +1 -0
- package/dist/tools/update-qurl.d.ts +43 -264
- package/dist/tools/update-qurl.d.ts.map +1 -1
- package/dist/tools/update-qurl.js +57 -8
- package/dist/tools/update-qurl.js.map +1 -1
- package/dist/tools/upload-file-data-qurl.d.ts +182 -0
- package/dist/tools/upload-file-data-qurl.d.ts.map +1 -0
- package/dist/tools/upload-file-data-qurl.js +200 -0
- package/dist/tools/upload-file-data-qurl.js.map +1 -0
- package/dist/tools/upload-file-qurl.d.ts +162 -0
- package/dist/tools/upload-file-qurl.d.ts.map +1 -0
- package/dist/tools/upload-file-qurl.js +167 -0
- package/dist/tools/upload-file-qurl.js.map +1 -0
- package/dist/tools/upload-file-shared.d.ts +36 -0
- package/dist/tools/upload-file-shared.d.ts.map +1 -0
- package/dist/tools/upload-file-shared.js +347 -0
- package/dist/tools/upload-file-shared.js.map +1 -0
- package/dist/tools/upload-mint-options.d.ts +22 -0
- package/dist/tools/upload-mint-options.d.ts.map +1 -0
- package/dist/tools/upload-mint-options.js +29 -0
- package/dist/tools/upload-mint-options.js.map +1 -0
- package/dist/tools/upload-text-qurl.d.ts +144 -0
- package/dist/tools/upload-text-qurl.d.ts.map +1 -0
- package/dist/tools/upload-text-qurl.js +102 -0
- package/dist/tools/upload-text-qurl.js.map +1 -0
- package/package.json +27 -8
|
@@ -11,8 +11,16 @@ const tagSchema = z
|
|
|
11
11
|
.regex(/^[a-zA-Z0-9][a-zA-Z0-9 _-]*$/, "Tag must start with alphanumeric and contain only letters, numbers, spaces, underscores, or hyphens");
|
|
12
12
|
export const updateQurlBaseSchema = z.object({
|
|
13
13
|
resource_id: resourceIdSchema("update"),
|
|
14
|
-
extend_by: z
|
|
15
|
-
|
|
14
|
+
extend_by: z
|
|
15
|
+
.string()
|
|
16
|
+
.min(1)
|
|
17
|
+
.optional()
|
|
18
|
+
.describe('Duration to extend by (e.g., "24h", "7d"). Mutually exclusive with expires_at.'),
|
|
19
|
+
expires_at: z
|
|
20
|
+
.string()
|
|
21
|
+
.datetime({ offset: true })
|
|
22
|
+
.optional()
|
|
23
|
+
.describe("Absolute expiration timestamp (RFC 3339). Mutually exclusive with extend_by."),
|
|
16
24
|
tags: z
|
|
17
25
|
.array(tagSchema)
|
|
18
26
|
.max(10)
|
|
@@ -38,6 +46,12 @@ export const updateQurlBaseSchema = z.object({
|
|
|
38
46
|
export const updateQurlSchema = updateQurlBaseSchema
|
|
39
47
|
.refine((data) => !(data.extend_by && data.expires_at), {
|
|
40
48
|
message: "Provide either extend_by or expires_at, not both",
|
|
49
|
+
})
|
|
50
|
+
.refine((data) => !(hasExpirationUpdate(data) && hasResourceEndpointUpdate(data)), {
|
|
51
|
+
message: "custom_domain and preserve_host use the resource endpoint and cannot be combined with extend_by or expires_at in one update",
|
|
52
|
+
})
|
|
53
|
+
.refine((data) => !(hasResourceEndpointUpdate(data) && data.resource_id.startsWith("q_")), {
|
|
54
|
+
message: "custom_domain and preserve_host updates require a resource identifier (public key, CRID, or legacy r_ ID)",
|
|
41
55
|
})
|
|
42
56
|
.refine(
|
|
43
57
|
// Use `!== undefined` rather than truthy checks so the API's "clear"
|
|
@@ -53,14 +67,14 @@ export const updateQurlSchema = updateQurlBaseSchema
|
|
|
53
67
|
data.preserve_host !== undefined, {
|
|
54
68
|
message: "At least one update field (extend_by, expires_at, tags, description, custom_domain, or preserve_host) is required",
|
|
55
69
|
});
|
|
56
|
-
export function updateQurlTool(client) {
|
|
70
|
+
export function updateQurlTool(client, _runtime = { mode: "stdio" }) {
|
|
57
71
|
return {
|
|
58
72
|
name: "update_qurl",
|
|
59
73
|
title: "Update qURL",
|
|
60
74
|
description: "Update a qURL's expiration, tags, description, custom domain, or proxy host-header behavior. The richer alternative to `extend_qurl` — use `update_qurl` whenever you need anything beyond a relative time push. " +
|
|
61
|
-
"Accepts
|
|
62
|
-
"**Constraints:** `extend_by` and `expires_at` are mutually exclusive; at least one update field (`extend_by`, `expires_at`, `tags`, `description`, `custom_domain`, `preserve_host`) must be set. " +
|
|
63
|
-
|
|
75
|
+
"Accepts resource public keys, CRIDs, legacy `r_` IDs, and `q_` display IDs for expiration, tags, and description updates (q_ is auto-resolved); custom domain and preserve_host updates require a resource identifier (public key, CRID, or legacy `r_` ID) because the qURL API now serves them from `PATCH /v1/resources/{id}`. " +
|
|
76
|
+
"**Constraints:** `extend_by` and `expires_at` are mutually exclusive; `custom_domain`/`preserve_host` cannot be combined with expiration changes in one call; at least one update field (`extend_by`, `expires_at`, `tags`, `description`, `custom_domain`, `preserve_host`) must be set. " +
|
|
77
|
+
'**Clearing fields:** pass `description: ""`, `tags: []`, or `custom_domain: ""` to clear those fields explicitly. ' +
|
|
64
78
|
"Use `extend_qurl` when the only change is a relative time push. " +
|
|
65
79
|
"Use `delete_qurl` when you want to revoke entirely. " +
|
|
66
80
|
"**Errors:** if the input fails schema refinements (both extend_by + expires_at, or no fields set), the handler returns an `isError: true` content block before any API call. Other API errors throw with the API's `code`/`statusCode`. " +
|
|
@@ -79,8 +93,13 @@ export function updateQurlTool(client) {
|
|
|
79
93
|
const parsed = updateQurlSchema.safeParse(raw);
|
|
80
94
|
if (!parsed.success)
|
|
81
95
|
return zodErrorToToolResult(parsed.error);
|
|
82
|
-
const { resource_id
|
|
83
|
-
|
|
96
|
+
const { resource_id } = parsed.data;
|
|
97
|
+
// Both API endpoints accept tags/description; keep qURL-only updates
|
|
98
|
+
// on /v1/qurls/{id} for q_ auto-resolution, and move custom-domain /
|
|
99
|
+
// host-header changes to /v1/resources/{id} per UpdateResourceRequest.
|
|
100
|
+
const result = hasResourceEndpointUpdate(parsed.data)
|
|
101
|
+
? await client.updateResource(resource_id, buildResourceUpdateBody(parsed.data))
|
|
102
|
+
: await client.updateQURL(resource_id, buildQurlUpdateBody(parsed.data));
|
|
84
103
|
return {
|
|
85
104
|
content: [
|
|
86
105
|
{
|
|
@@ -93,4 +112,34 @@ export function updateQurlTool(client) {
|
|
|
93
112
|
}),
|
|
94
113
|
};
|
|
95
114
|
}
|
|
115
|
+
function hasExpirationUpdate(data) {
|
|
116
|
+
return data.extend_by !== undefined || data.expires_at !== undefined;
|
|
117
|
+
}
|
|
118
|
+
function hasResourceEndpointUpdate(data) {
|
|
119
|
+
return data.custom_domain !== undefined || data.preserve_host !== undefined;
|
|
120
|
+
}
|
|
121
|
+
function buildQurlUpdateBody(data) {
|
|
122
|
+
const body = {};
|
|
123
|
+
if (data.extend_by !== undefined)
|
|
124
|
+
body.extend_by = data.extend_by;
|
|
125
|
+
if (data.expires_at !== undefined)
|
|
126
|
+
body.expires_at = data.expires_at;
|
|
127
|
+
if (data.tags !== undefined)
|
|
128
|
+
body.tags = data.tags;
|
|
129
|
+
if (data.description !== undefined)
|
|
130
|
+
body.description = data.description;
|
|
131
|
+
return body;
|
|
132
|
+
}
|
|
133
|
+
function buildResourceUpdateBody(data) {
|
|
134
|
+
const body = {};
|
|
135
|
+
if (data.tags !== undefined)
|
|
136
|
+
body.tags = data.tags;
|
|
137
|
+
if (data.description !== undefined)
|
|
138
|
+
body.description = data.description;
|
|
139
|
+
if (data.custom_domain !== undefined)
|
|
140
|
+
body.custom_domain = data.custom_domain;
|
|
141
|
+
if (data.preserve_host !== undefined)
|
|
142
|
+
body.preserve_host = data.preserve_host;
|
|
143
|
+
return body;
|
|
144
|
+
}
|
|
96
145
|
//# sourceMappingURL=update-qurl.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"update-qurl.js","sourceRoot":"","sources":["../../src/tools/update-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,
|
|
1
|
+
{"version":3,"file":"update-qurl.js","sourceRoot":"","sources":["../../src/tools/update-qurl.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { IQURLClient } from "../client.js";
|
|
3
|
+
import { type ToolRuntimeOptions } from "./_shared.js";
|
|
4
|
+
export declare function maxBase64CharactersForBytes(maxBytes: number): number;
|
|
5
|
+
export declare const MAX_UPLOAD_FILE_BASE64_CHARACTERS: number;
|
|
6
|
+
export declare function createUploadFileDataQurlSchema(maxBase64Characters?: number): z.ZodObject<{
|
|
7
|
+
file_base64: z.ZodString;
|
|
8
|
+
file_name: z.ZodString;
|
|
9
|
+
content_type: z.ZodEnum<{
|
|
10
|
+
"application/pdf": "application/pdf";
|
|
11
|
+
"image/gif": "image/gif";
|
|
12
|
+
"image/jpeg": "image/jpeg";
|
|
13
|
+
"image/png": "image/png";
|
|
14
|
+
"image/webp": "image/webp";
|
|
15
|
+
}>;
|
|
16
|
+
email_delivery: z.ZodOptional<z.ZodObject<{
|
|
17
|
+
to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
|
|
18
|
+
subject: z.ZodOptional<z.ZodString>;
|
|
19
|
+
message: z.ZodOptional<z.ZodString>;
|
|
20
|
+
}, z.core.$strip>>;
|
|
21
|
+
label: z.ZodOptional<z.ZodString>;
|
|
22
|
+
expires_in: z.ZodOptional<z.ZodString>;
|
|
23
|
+
one_time_use: z.ZodOptional<z.ZodBoolean>;
|
|
24
|
+
max_sessions: z.ZodOptional<z.ZodNumber>;
|
|
25
|
+
session_duration: z.ZodOptional<z.ZodString>;
|
|
26
|
+
access_policy: z.ZodOptional<z.ZodObject<{
|
|
27
|
+
ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
28
|
+
ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
29
|
+
geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
30
|
+
geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
31
|
+
user_agent_allow_regex: z.ZodOptional<z.ZodString>;
|
|
32
|
+
user_agent_deny_regex: z.ZodOptional<z.ZodString>;
|
|
33
|
+
ai_agent_policy: z.ZodOptional<z.ZodObject<{
|
|
34
|
+
block_all: z.ZodOptional<z.ZodBoolean>;
|
|
35
|
+
deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
36
|
+
allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
37
|
+
}, z.core.$strip>>;
|
|
38
|
+
}, z.core.$strip>>;
|
|
39
|
+
}, z.core.$strip>;
|
|
40
|
+
export declare const uploadFileDataQurlSchema: z.ZodObject<{
|
|
41
|
+
file_base64: z.ZodString;
|
|
42
|
+
file_name: z.ZodString;
|
|
43
|
+
content_type: z.ZodEnum<{
|
|
44
|
+
"application/pdf": "application/pdf";
|
|
45
|
+
"image/gif": "image/gif";
|
|
46
|
+
"image/jpeg": "image/jpeg";
|
|
47
|
+
"image/png": "image/png";
|
|
48
|
+
"image/webp": "image/webp";
|
|
49
|
+
}>;
|
|
50
|
+
email_delivery: z.ZodOptional<z.ZodObject<{
|
|
51
|
+
to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
|
|
52
|
+
subject: z.ZodOptional<z.ZodString>;
|
|
53
|
+
message: z.ZodOptional<z.ZodString>;
|
|
54
|
+
}, z.core.$strip>>;
|
|
55
|
+
label: z.ZodOptional<z.ZodString>;
|
|
56
|
+
expires_in: z.ZodOptional<z.ZodString>;
|
|
57
|
+
one_time_use: z.ZodOptional<z.ZodBoolean>;
|
|
58
|
+
max_sessions: z.ZodOptional<z.ZodNumber>;
|
|
59
|
+
session_duration: z.ZodOptional<z.ZodString>;
|
|
60
|
+
access_policy: z.ZodOptional<z.ZodObject<{
|
|
61
|
+
ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
62
|
+
ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
63
|
+
geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
64
|
+
geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
65
|
+
user_agent_allow_regex: z.ZodOptional<z.ZodString>;
|
|
66
|
+
user_agent_deny_regex: z.ZodOptional<z.ZodString>;
|
|
67
|
+
ai_agent_policy: z.ZodOptional<z.ZodObject<{
|
|
68
|
+
block_all: z.ZodOptional<z.ZodBoolean>;
|
|
69
|
+
deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
70
|
+
allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
71
|
+
}, z.core.$strip>>;
|
|
72
|
+
}, z.core.$strip>>;
|
|
73
|
+
}, z.core.$strip>;
|
|
74
|
+
export declare function uploadFileDataQurlTool(client: IQURLClient, runtime: ToolRuntimeOptions): {
|
|
75
|
+
name: string;
|
|
76
|
+
title: string;
|
|
77
|
+
description: string;
|
|
78
|
+
inputSchema: z.ZodObject<{
|
|
79
|
+
file_base64: z.ZodString;
|
|
80
|
+
file_name: z.ZodString;
|
|
81
|
+
content_type: z.ZodEnum<{
|
|
82
|
+
"application/pdf": "application/pdf";
|
|
83
|
+
"image/gif": "image/gif";
|
|
84
|
+
"image/jpeg": "image/jpeg";
|
|
85
|
+
"image/png": "image/png";
|
|
86
|
+
"image/webp": "image/webp";
|
|
87
|
+
}>;
|
|
88
|
+
email_delivery: z.ZodOptional<z.ZodObject<{
|
|
89
|
+
to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
|
|
90
|
+
subject: z.ZodOptional<z.ZodString>;
|
|
91
|
+
message: z.ZodOptional<z.ZodString>;
|
|
92
|
+
}, z.core.$strip>>;
|
|
93
|
+
label: z.ZodOptional<z.ZodString>;
|
|
94
|
+
expires_in: z.ZodOptional<z.ZodString>;
|
|
95
|
+
one_time_use: z.ZodOptional<z.ZodBoolean>;
|
|
96
|
+
max_sessions: z.ZodOptional<z.ZodNumber>;
|
|
97
|
+
session_duration: z.ZodOptional<z.ZodString>;
|
|
98
|
+
access_policy: z.ZodOptional<z.ZodObject<{
|
|
99
|
+
ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
100
|
+
ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
101
|
+
geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
102
|
+
geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
103
|
+
user_agent_allow_regex: z.ZodOptional<z.ZodString>;
|
|
104
|
+
user_agent_deny_regex: z.ZodOptional<z.ZodString>;
|
|
105
|
+
ai_agent_policy: z.ZodOptional<z.ZodObject<{
|
|
106
|
+
block_all: z.ZodOptional<z.ZodBoolean>;
|
|
107
|
+
deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
108
|
+
allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
109
|
+
}, z.core.$strip>>;
|
|
110
|
+
}, z.core.$strip>>;
|
|
111
|
+
}, z.core.$strip>;
|
|
112
|
+
outputSchema: z.ZodObject<{
|
|
113
|
+
resource_id: z.ZodString;
|
|
114
|
+
qurl_id: z.ZodString;
|
|
115
|
+
qurl_link: z.ZodString;
|
|
116
|
+
qurl_site: z.ZodOptional<z.ZodString>;
|
|
117
|
+
expires_at: z.ZodOptional<z.ZodString>;
|
|
118
|
+
file_name: z.ZodString;
|
|
119
|
+
content_type: z.ZodString;
|
|
120
|
+
size_bytes: z.ZodNumber;
|
|
121
|
+
branded_domain: z.ZodOptional<z.ZodString>;
|
|
122
|
+
type: z.ZodOptional<z.ZodString>;
|
|
123
|
+
email_delivery: z.ZodOptional<z.ZodObject<{
|
|
124
|
+
attempted: z.ZodBoolean;
|
|
125
|
+
enabled: z.ZodBoolean;
|
|
126
|
+
recipients: z.ZodArray<z.ZodString>;
|
|
127
|
+
sent: z.ZodNumber;
|
|
128
|
+
failed: z.ZodNumber;
|
|
129
|
+
skipped_reason: z.ZodOptional<z.ZodString>;
|
|
130
|
+
results: z.ZodArray<z.ZodObject<{
|
|
131
|
+
email: z.ZodString;
|
|
132
|
+
success: z.ZodBoolean;
|
|
133
|
+
skipped: z.ZodBoolean;
|
|
134
|
+
error: z.ZodOptional<z.ZodString>;
|
|
135
|
+
message_id: z.ZodOptional<z.ZodString>;
|
|
136
|
+
}, z.core.$strip>>;
|
|
137
|
+
}, z.core.$strip>>;
|
|
138
|
+
}, z.core.$loose>;
|
|
139
|
+
annotations: {
|
|
140
|
+
title: string;
|
|
141
|
+
readOnlyHint: boolean;
|
|
142
|
+
destructiveHint: boolean;
|
|
143
|
+
idempotentHint: boolean;
|
|
144
|
+
openWorldHint: boolean;
|
|
145
|
+
};
|
|
146
|
+
handler: (input: {
|
|
147
|
+
file_base64: string;
|
|
148
|
+
file_name: string;
|
|
149
|
+
content_type: "application/pdf" | "image/gif" | "image/jpeg" | "image/png" | "image/webp";
|
|
150
|
+
email_delivery?: {
|
|
151
|
+
to: string[];
|
|
152
|
+
subject?: string | undefined;
|
|
153
|
+
message?: string | undefined;
|
|
154
|
+
} | undefined;
|
|
155
|
+
label?: string | undefined;
|
|
156
|
+
expires_in?: string | undefined;
|
|
157
|
+
one_time_use?: boolean | undefined;
|
|
158
|
+
max_sessions?: number | undefined;
|
|
159
|
+
session_duration?: string | undefined;
|
|
160
|
+
access_policy?: {
|
|
161
|
+
ip_allowlist?: string[] | undefined;
|
|
162
|
+
ip_denylist?: string[] | undefined;
|
|
163
|
+
geo_allowlist?: string[] | undefined;
|
|
164
|
+
geo_denylist?: string[] | undefined;
|
|
165
|
+
user_agent_allow_regex?: string | undefined;
|
|
166
|
+
user_agent_deny_regex?: string | undefined;
|
|
167
|
+
ai_agent_policy?: {
|
|
168
|
+
block_all?: boolean | undefined;
|
|
169
|
+
deny_categories?: string[] | undefined;
|
|
170
|
+
allow_categories?: string[] | undefined;
|
|
171
|
+
} | undefined;
|
|
172
|
+
} | undefined;
|
|
173
|
+
}) => Promise<{
|
|
174
|
+
content: Array<{
|
|
175
|
+
type: "text";
|
|
176
|
+
text: string;
|
|
177
|
+
}>;
|
|
178
|
+
structuredContent?: Record<string, unknown>;
|
|
179
|
+
isError?: boolean;
|
|
180
|
+
}>;
|
|
181
|
+
};
|
|
182
|
+
//# sourceMappingURL=upload-file-data-qurl.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"upload-file-data-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/upload-file-data-qurl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AA6BtB,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,eAAO,MAAM,iCAAiC,QAE7C,CAAC;AAEF,wBAAgB,8BAA8B,CAC5C,mBAAmB,SAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8BxD;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAmC,CAAC;AA2HzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8EtF"}
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
import { Buffer } from "node:buffer";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { MAX_UPLOAD_FILE_DATA_BYTES } from "../config.js";
|
|
4
|
+
import { allowsServerApiKeyFallback, withMissingApiKeyHandler, } from "./_shared.js";
|
|
5
|
+
import { emailDeliveryInputSchema, maybeDeliverToolEmail, toEmailAugmentedResult, uploadEmailDetailLines, } from "./email-delivery.js";
|
|
6
|
+
import { getConnectorConfig, getMaxUploadFileBytes, mintUploadedFile, normalizeFileName, supportedMimeTypes, uploadToConnector, validateFileNameContentType, validateFileSignature, } from "./upload-file-shared.js";
|
|
7
|
+
import { uploadFileQurlOutputSchema } from "./output-schemas.js";
|
|
8
|
+
import { uploadMintOptionsShape } from "./upload-mint-options.js";
|
|
9
|
+
// Uploads pass three deliberate bounds: a runtime-derived raw-string schema
|
|
10
|
+
// ceiling, the HTTP JSON-body limit before tool dispatch, and
|
|
11
|
+
// getMaxUploadFileBytes on the normalized decoded payload. The exported schema
|
|
12
|
+
// uses the protocol-wide 100 MB hard maximum for direct consumers; registered
|
|
13
|
+
// tools advertise the operator's configured decoded-byte limit. HTTP only opens
|
|
14
|
+
// a parser ceiling above the 10 MB default for a session already validated by a
|
|
15
|
+
// successful downstream qURL API call (see createHttpRuntime).
|
|
16
|
+
const MAX_DATA_URL_PREFIX_CHARACTERS = 1024;
|
|
17
|
+
export function maxBase64CharactersForBytes(maxBytes) {
|
|
18
|
+
return Math.ceil((maxBytes * 4) / 3) + MAX_DATA_URL_PREFIX_CHARACTERS;
|
|
19
|
+
}
|
|
20
|
+
export const MAX_UPLOAD_FILE_BASE64_CHARACTERS = maxBase64CharactersForBytes(MAX_UPLOAD_FILE_DATA_BYTES);
|
|
21
|
+
export function createUploadFileDataQurlSchema(maxBase64Characters = MAX_UPLOAD_FILE_BASE64_CHARACTERS) {
|
|
22
|
+
return z
|
|
23
|
+
.object({
|
|
24
|
+
file_base64: z
|
|
25
|
+
.string()
|
|
26
|
+
.min(1)
|
|
27
|
+
.max(maxBase64Characters)
|
|
28
|
+
.describe("Base64-encoded PDF or raster image content. Raw base64 and data URLs are both accepted. For compressible images, compress them first and then convert them to base64 before calling this tool."),
|
|
29
|
+
file_name: z
|
|
30
|
+
.string()
|
|
31
|
+
.min(1)
|
|
32
|
+
.max(255)
|
|
33
|
+
.describe("Filename to register with the connector. `.jpg` and `.jpeg` files should use `image/jpeg`."),
|
|
34
|
+
content_type: z
|
|
35
|
+
.enum(supportedMimeTypes)
|
|
36
|
+
.describe("MIME type for the uploaded file. Supported: application/pdf, image/png, image/jpeg, image/webp, image/gif."),
|
|
37
|
+
email_delivery: emailDeliveryInputSchema
|
|
38
|
+
.optional()
|
|
39
|
+
.describe("Optional email notification settings for sending the uploaded file's qURL to one or more recipients."),
|
|
40
|
+
})
|
|
41
|
+
.extend(uploadMintOptionsShape);
|
|
42
|
+
}
|
|
43
|
+
export const uploadFileDataQurlSchema = createUploadFileDataQurlSchema();
|
|
44
|
+
/**
|
|
45
|
+
* Normalize and validate base64 input for file upload.
|
|
46
|
+
*
|
|
47
|
+
* Accepts multiple input formats:
|
|
48
|
+
* - Raw base64: "SGVsbG8gV29ybGQ="
|
|
49
|
+
* - Data URL: "data:image/png;base64,iVBORw0KGgo..."
|
|
50
|
+
* - Base64 with whitespace (e.g., line breaks from copy-paste)
|
|
51
|
+
* - URL-safe base64 (uses - and _ instead of + and /)
|
|
52
|
+
*
|
|
53
|
+
* @param input - Raw base64 string or data URL
|
|
54
|
+
* @returns Normalized standard base64 and the data URL media type, when present
|
|
55
|
+
* @throws Error if input is empty or contains invalid base64 characters
|
|
56
|
+
*/
|
|
57
|
+
function normalizeBase64Input(input) {
|
|
58
|
+
const trimmed = input.trim();
|
|
59
|
+
if (!trimmed) {
|
|
60
|
+
throw new Error("file_base64 must not be empty");
|
|
61
|
+
}
|
|
62
|
+
// Step 1: Parse and strip the data URL prefix if present (e.g.,
|
|
63
|
+
// "data:image/png;base64,"). Return its media type so callers do not need
|
|
64
|
+
// to parse the same prefix again. Bound the regex probe independently of
|
|
65
|
+
// the payload ceiling so even a very large hostile string cannot make
|
|
66
|
+
// prefix parsing scale with the file body.
|
|
67
|
+
const dataUrlPrefixProbe = trimmed.slice(0, MAX_DATA_URL_PREFIX_CHARACTERS);
|
|
68
|
+
const dataUrl = /^data:([^;,]*)(?:;[a-z0-9!#$&^_.+-]+=[^;,\s]*)*;base64,/i.exec(dataUrlPrefixProbe);
|
|
69
|
+
if (!dataUrl && trimmed.toLowerCase().startsWith("data:")) {
|
|
70
|
+
throw new Error("Only base64-encoded data URLs are supported.");
|
|
71
|
+
}
|
|
72
|
+
const withoutDataUrl = dataUrl ? trimmed.slice(dataUrl[0].length) : trimmed;
|
|
73
|
+
// Step 2: Remove whitespace (base64 from copy-paste often has line breaks)
|
|
74
|
+
const withoutWhitespace = withoutDataUrl.replace(/\s+/g, "");
|
|
75
|
+
if (!withoutWhitespace) {
|
|
76
|
+
throw new Error("file_base64 must not be empty");
|
|
77
|
+
}
|
|
78
|
+
// Step 3: Accept either the standard or URL-safe alphabet, but reject a
|
|
79
|
+
// mixed alphabet because no conforming encoder emits that representation.
|
|
80
|
+
const usesStandardAlphabet = /^[A-Za-z0-9+/]*={0,2}$/.test(withoutWhitespace);
|
|
81
|
+
const usesUrlSafeAlphabet = !usesStandardAlphabet && /^[A-Za-z0-9_-]*={0,2}$/.test(withoutWhitespace);
|
|
82
|
+
if (!usesStandardAlphabet && !usesUrlSafeAlphabet) {
|
|
83
|
+
throw new Error("file_base64 must be valid base64-encoded content");
|
|
84
|
+
}
|
|
85
|
+
// Step 4: Convert URL-safe base64 to standard base64. URL-safe uses '-'
|
|
86
|
+
// instead of '+' and '_' instead of '/'.
|
|
87
|
+
const normalized = usesStandardAlphabet
|
|
88
|
+
? withoutWhitespace
|
|
89
|
+
: withoutWhitespace.replace(/-/g, "+").replace(/_/g, "/");
|
|
90
|
+
// Step 5: Validate and fix padding
|
|
91
|
+
// Base64 length must be divisible by 4. Valid lengths mod 4 are: 0, 2, 3
|
|
92
|
+
// Length mod 4 = 1 is always invalid (would represent 6 bits, not enough for a byte)
|
|
93
|
+
const paddingNeeded = normalized.length % 4;
|
|
94
|
+
if (paddingNeeded === 1) {
|
|
95
|
+
throw new Error("file_base64 must be valid base64-encoded content");
|
|
96
|
+
}
|
|
97
|
+
const dataUrlContentType = dataUrl?.[1] ? dataUrl[1].toLowerCase() : undefined;
|
|
98
|
+
// Already properly padded
|
|
99
|
+
if (paddingNeeded === 0) {
|
|
100
|
+
return { base64: normalized, dataUrlContentType };
|
|
101
|
+
}
|
|
102
|
+
// Add missing padding (mod 4 = 2 needs "==", mod 4 = 3 needs "=")
|
|
103
|
+
return {
|
|
104
|
+
base64: normalized.padEnd(normalized.length + (4 - paddingNeeded), "="),
|
|
105
|
+
dataUrlContentType,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
function decodeBase64File(input, maxBytes, contentType) {
|
|
109
|
+
const tooLargeMessage = "Decoded file exceeds the allowed upload size. Reduce the file size and try again.";
|
|
110
|
+
const encodedCharacterLimit = Math.ceil((maxBytes * 4) / 3);
|
|
111
|
+
// Allow normal MIME line wrapping plus a bounded data-URL prefix, but reject
|
|
112
|
+
// runtime-oversized strings before trim/replace normalization copies them.
|
|
113
|
+
const rawCharacterLimit = encodedCharacterLimit + Math.ceil(encodedCharacterLimit / 4) + MAX_DATA_URL_PREFIX_CHARACTERS;
|
|
114
|
+
if (input.length > rawCharacterLimit) {
|
|
115
|
+
throw new Error(tooLargeMessage);
|
|
116
|
+
}
|
|
117
|
+
const normalized = normalizeBase64Input(input);
|
|
118
|
+
if (normalized.dataUrlContentType && normalized.dataUrlContentType !== contentType) {
|
|
119
|
+
throw new Error("Data URL media type does not match content_type.");
|
|
120
|
+
}
|
|
121
|
+
const paddingBytes = normalized.base64.endsWith("==")
|
|
122
|
+
? 2
|
|
123
|
+
: normalized.base64.endsWith("=")
|
|
124
|
+
? 1
|
|
125
|
+
: 0;
|
|
126
|
+
const decodedByteLength = (normalized.base64.length / 4) * 3 - paddingBytes;
|
|
127
|
+
if (decodedByteLength > maxBytes) {
|
|
128
|
+
throw new Error(tooLargeMessage);
|
|
129
|
+
}
|
|
130
|
+
const fileData = Buffer.from(normalized.base64, "base64");
|
|
131
|
+
if (fileData.byteLength === 0) {
|
|
132
|
+
throw new Error("file_base64 decoded to an empty file");
|
|
133
|
+
}
|
|
134
|
+
// Keep an actual-byte check after the pre-allocation estimate so decoder or
|
|
135
|
+
// normalization behavior cannot silently weaken the configured limit.
|
|
136
|
+
if (fileData.byteLength > maxBytes) {
|
|
137
|
+
throw new Error(tooLargeMessage);
|
|
138
|
+
}
|
|
139
|
+
validateFileSignature(fileData, contentType);
|
|
140
|
+
return fileData;
|
|
141
|
+
}
|
|
142
|
+
export function uploadFileDataQurlTool(client, runtime) {
|
|
143
|
+
const inputSchema = createUploadFileDataQurlSchema(runtime.maxUploadFileDataBytes === undefined
|
|
144
|
+
? MAX_UPLOAD_FILE_BASE64_CHARACTERS
|
|
145
|
+
: maxBase64CharactersForBytes(runtime.maxUploadFileDataBytes));
|
|
146
|
+
return {
|
|
147
|
+
name: "upload_file_data_qurl",
|
|
148
|
+
title: "Upload File Data qURL",
|
|
149
|
+
description: "Upload base64-encoded PDF or raster image content to a qURL connector, then mint an access link for it. " +
|
|
150
|
+
"This is the correct tool for a single in-chat image, PDF, or file attachment in either MCP transport, especially when the user wants 'the qURL of this image/file' or wants the generated link emailed. " +
|
|
151
|
+
"Use this when you have the file data available but cannot provide a server-local file path. " +
|
|
152
|
+
"Use `upload_file_qurl` when the file already exists on the MCP server host, use `create_qurl` when you already have a URL, and use `mint_link` when the file has already been uploaded and you only need another token. " +
|
|
153
|
+
"For compressible images, compress them before converting to base64 so the request is smaller and more reliable. " +
|
|
154
|
+
"When the server upload limit is configured above 10 MB, a fresh HTTP session must complete a smaller qURL API call before its first larger upload. " +
|
|
155
|
+
"The tool decodes `file_base64`, uploads the file to `${QURL_CONNECTOR_URL}/api/upload`, then mints a qURL from the returned `resource_id`. " +
|
|
156
|
+
"Supported MIME types are application/pdf, image/png, image/jpeg, image/webp, and image/gif. " +
|
|
157
|
+
"If `one_time_use` is omitted, the tool defaults it to `true` for safer file distribution. " +
|
|
158
|
+
"Requires `QURL_CONNECTOR_URL`; stdio reads `QURL_API_KEY` from server config, while HTTP uses the caller's bearer credential. " +
|
|
159
|
+
"**Returns:** `{ resource_id: string, qurl_id: string, qurl_link: string, qurl_site?: string, expires_at?: string, file_name: string, content_type: string, size_bytes: number, branded_domain?: string, type?: string, email_delivery?: object }`.",
|
|
160
|
+
inputSchema,
|
|
161
|
+
outputSchema: uploadFileQurlOutputSchema,
|
|
162
|
+
annotations: {
|
|
163
|
+
title: "Upload File Data qURL",
|
|
164
|
+
readOnlyHint: false,
|
|
165
|
+
destructiveHint: false,
|
|
166
|
+
idempotentHint: false,
|
|
167
|
+
openWorldHint: true,
|
|
168
|
+
},
|
|
169
|
+
handler: withMissingApiKeyHandler(async (input) => {
|
|
170
|
+
const allowServerApiKeyFallback = allowsServerApiKeyFallback(runtime);
|
|
171
|
+
// Preflight connector config before decoding payloads so auth/config errors fail fast.
|
|
172
|
+
const connectorConfig = getConnectorConfig(allowServerApiKeyFallback);
|
|
173
|
+
const fileName = normalizeFileName(input.file_name);
|
|
174
|
+
validateFileNameContentType(fileName, input.content_type);
|
|
175
|
+
const fileData = decodeBase64File(input.file_base64, getMaxUploadFileBytes(), input.content_type);
|
|
176
|
+
const upload = await uploadToConnector(fileData, fileName, input.content_type, connectorConfig);
|
|
177
|
+
const result = await mintUploadedFile(client, upload.resource_id, {
|
|
178
|
+
name: fileName,
|
|
179
|
+
contentType: input.content_type,
|
|
180
|
+
sizeBytes: fileData.byteLength,
|
|
181
|
+
}, input);
|
|
182
|
+
const emailResult = await maybeDeliverToolEmail({
|
|
183
|
+
allowServerApiKeyFallback,
|
|
184
|
+
delivery: input.email_delivery,
|
|
185
|
+
defaultSubject: "Your secure file access link is ready",
|
|
186
|
+
detailLines: uploadEmailDetailLines({
|
|
187
|
+
intro: "A secure qURL file link has been created for you.",
|
|
188
|
+
fileName,
|
|
189
|
+
contentType: input.content_type,
|
|
190
|
+
qurlLink: result.qurl_link,
|
|
191
|
+
expiresAt: result.expires_at,
|
|
192
|
+
qurlSite: result.qurl_site,
|
|
193
|
+
label: input.label,
|
|
194
|
+
}),
|
|
195
|
+
});
|
|
196
|
+
return toEmailAugmentedResult(result, emailResult);
|
|
197
|
+
}),
|
|
198
|
+
};
|
|
199
|
+
}
|
|
200
|
+
//# sourceMappingURL=upload-file-data-qurl.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"upload-file-data-qurl.js","sourceRoot":"","sources":["../../src/tools/upload-file-data-qurl.ts"],"names":[],"mappings":"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"}
|