@layervai/qurl-mcp 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +98 -0
- package/dist/client.d.ts +278 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +156 -0
- package/dist/client.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +34 -0
- package/dist/index.js.map +1 -0
- package/dist/prompts/audit-links.d.ts +7 -0
- package/dist/prompts/audit-links.d.ts.map +1 -0
- package/dist/prompts/audit-links.js +31 -0
- package/dist/prompts/audit-links.js.map +1 -0
- package/dist/prompts/rotate-access.d.ts +18 -0
- package/dist/prompts/rotate-access.d.ts.map +1 -0
- package/dist/prompts/rotate-access.js +41 -0
- package/dist/prompts/rotate-access.js.map +1 -0
- package/dist/prompts/secure-a-service.d.ts +38 -0
- package/dist/prompts/secure-a-service.d.ts.map +1 -0
- package/dist/prompts/secure-a-service.js +141 -0
- package/dist/prompts/secure-a-service.js.map +1 -0
- package/dist/resources/_shared.d.ts +31 -0
- package/dist/resources/_shared.d.ts.map +1 -0
- package/dist/resources/_shared.js +42 -0
- package/dist/resources/_shared.js.map +1 -0
- package/dist/resources/links.d.ts +15 -0
- package/dist/resources/links.d.ts.map +1 -0
- package/dist/resources/links.js +22 -0
- package/dist/resources/links.js.map +1 -0
- package/dist/resources/usage.d.ts +15 -0
- package/dist/resources/usage.d.ts.map +1 -0
- package/dist/resources/usage.js +18 -0
- package/dist/resources/usage.js.map +1 -0
- package/dist/server.d.ts +37 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +58 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/_shared.d.ts +78 -0
- package/dist/tools/_shared.d.ts.map +1 -0
- package/dist/tools/_shared.js +80 -0
- package/dist/tools/_shared.js.map +1 -0
- package/dist/tools/batch-create.d.ts +426 -0
- package/dist/tools/batch-create.d.ts.map +1 -0
- package/dist/tools/batch-create.js +81 -0
- package/dist/tools/batch-create.js.map +1 -0
- package/dist/tools/create-qurl.d.ts +316 -0
- package/dist/tools/create-qurl.d.ts.map +1 -0
- package/dist/tools/create-qurl.js +106 -0
- package/dist/tools/create-qurl.js.map +1 -0
- package/dist/tools/delete-qurl.d.ts +55 -0
- package/dist/tools/delete-qurl.d.ts.map +1 -0
- package/dist/tools/delete-qurl.js +76 -0
- package/dist/tools/delete-qurl.js.map +1 -0
- package/dist/tools/extend-qurl.d.ts +238 -0
- package/dist/tools/extend-qurl.d.ts.map +1 -0
- package/dist/tools/extend-qurl.js +45 -0
- package/dist/tools/extend-qurl.js.map +1 -0
- package/dist/tools/get-qurl.d.ts +231 -0
- package/dist/tools/get-qurl.d.ts.map +1 -0
- package/dist/tools/get-qurl.js +39 -0
- package/dist/tools/get-qurl.js.map +1 -0
- package/dist/tools/list-qurls.d.ts +395 -0
- package/dist/tools/list-qurls.d.ts.map +1 -0
- package/dist/tools/list-qurls.js +72 -0
- package/dist/tools/list-qurls.js.map +1 -0
- package/dist/tools/mint-link.d.ts +384 -0
- package/dist/tools/mint-link.d.ts.map +1 -0
- package/dist/tools/mint-link.js +75 -0
- package/dist/tools/mint-link.js.map +1 -0
- package/dist/tools/output-schemas.d.ts +1261 -0
- package/dist/tools/output-schemas.d.ts.map +1 -0
- package/dist/tools/output-schemas.js +173 -0
- package/dist/tools/output-schemas.js.map +1 -0
- package/dist/tools/resolve-qurl.d.ts +72 -0
- package/dist/tools/resolve-qurl.d.ts.map +1 -0
- package/dist/tools/resolve-qurl.js +42 -0
- package/dist/tools/resolve-qurl.js.map +1 -0
- package/dist/tools/update-qurl.d.ts +330 -0
- package/dist/tools/update-qurl.d.ts.map +1 -0
- package/dist/tools/update-qurl.js +96 -0
- package/dist/tools/update-qurl.js.map +1 -0
- package/package.json +58 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"output-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/output-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6DxB,qEAAqE;AACrE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBrB,CAAC;AAEH,oEAAoE;AACpE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAa,CAAC;AAC9C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAa,CAAC;AACjD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAa,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQhC,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYlC,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AA4BH;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAUjC,CAAC"}
|
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
/**
|
|
3
|
+
* Output schemas for MCP tools.
|
|
4
|
+
*
|
|
5
|
+
* Each schema describes the **payload** a tool's `structuredContent` carries —
|
|
6
|
+
* the inner data shape, not the API envelope. The text content of every tool
|
|
7
|
+
* response already serializes this same payload, so structuredContent and
|
|
8
|
+
* text describe the same value in two formats.
|
|
9
|
+
*
|
|
10
|
+
* The MCP SDK validates `structuredContent` against the `outputSchema` we
|
|
11
|
+
* register on each tool. Hosts use the schema to render structured responses,
|
|
12
|
+
* and downstream agents use it to plan their call shape — so keeping these
|
|
13
|
+
* aligned with the API spec at `api-spec/qurls.yaml` is part of the API spec
|
|
14
|
+
* drift workflow.
|
|
15
|
+
*
|
|
16
|
+
* Why URLs and timestamps are plain `z.string()` (not `.url()`/`.datetime()`):
|
|
17
|
+
* these schemas validate API *responses*, not user input. A tighter local
|
|
18
|
+
* validator that disagrees with the server (e.g. an `https://` redirect that
|
|
19
|
+
* Zod's URL parser rejects, or a timestamp Go formats slightly differently
|
|
20
|
+
* from RFC 3339 strict mode) would turn a valid API response into a tool
|
|
21
|
+
* error for no benefit. We trust the server on shape and use `.string()` as
|
|
22
|
+
* an existence/typeof check.
|
|
23
|
+
*/
|
|
24
|
+
const accessPolicy = z
|
|
25
|
+
.object({
|
|
26
|
+
ip_allowlist: z.array(z.string()).optional(),
|
|
27
|
+
ip_denylist: z.array(z.string()).optional(),
|
|
28
|
+
geo_allowlist: z.array(z.string()).optional(),
|
|
29
|
+
geo_denylist: z.array(z.string()).optional(),
|
|
30
|
+
user_agent_allow_regex: z.string().optional(),
|
|
31
|
+
user_agent_deny_regex: z.string().optional(),
|
|
32
|
+
ai_agent_policy: z
|
|
33
|
+
.object({
|
|
34
|
+
block_all: z.boolean().optional(),
|
|
35
|
+
deny_categories: z.array(z.string()).optional(),
|
|
36
|
+
allow_categories: z.array(z.string()).optional(),
|
|
37
|
+
})
|
|
38
|
+
.optional(),
|
|
39
|
+
})
|
|
40
|
+
.describe("Access control policy snapshot for this token");
|
|
41
|
+
const accessTokenSchema = z
|
|
42
|
+
.object({
|
|
43
|
+
qurl_id: z.string(),
|
|
44
|
+
label: z.string().optional(),
|
|
45
|
+
status: z
|
|
46
|
+
.enum(["active", "consumed", "expired", "revoked"])
|
|
47
|
+
.describe("Per-token status (wider than resource status — tokens may be consumed/expired independently)"),
|
|
48
|
+
one_time_use: z.boolean(),
|
|
49
|
+
max_sessions: z.number(),
|
|
50
|
+
session_duration: z.number().describe("Seconds of access granted after a successful resolve"),
|
|
51
|
+
use_count: z.number(),
|
|
52
|
+
qurl_site: z.string().optional(),
|
|
53
|
+
access_policy: accessPolicy.optional(),
|
|
54
|
+
created_at: z.string(),
|
|
55
|
+
expires_at: z.string(),
|
|
56
|
+
})
|
|
57
|
+
.describe("Single access token belonging to a qURL resource");
|
|
58
|
+
/** Stable QURL resource shape returned by get/list/update/extend. */
|
|
59
|
+
export const qurlSchema = z.object({
|
|
60
|
+
resource_id: z.string().describe("Stable resource identifier (r_ prefix)"),
|
|
61
|
+
qurl_site: z.string().optional(),
|
|
62
|
+
target_url: z.string().describe("Underlying URL the qURL protects"),
|
|
63
|
+
description: z.string().optional(),
|
|
64
|
+
tags: z.array(z.string()).optional(),
|
|
65
|
+
expires_at: z.string(),
|
|
66
|
+
created_at: z.string(),
|
|
67
|
+
// Enum sourced from api-spec/qurls.yaml; if the API adds a value, the
|
|
68
|
+
// spec-drift workflow catches it before this validation hard-fails.
|
|
69
|
+
status: z.enum(["active", "revoked"]),
|
|
70
|
+
custom_domain: z.string().nullable().optional(),
|
|
71
|
+
preserve_host: z
|
|
72
|
+
.boolean()
|
|
73
|
+
.optional()
|
|
74
|
+
.describe("When true, the original Host header is preserved when proxying via the custom domain. " +
|
|
75
|
+
"Only meaningful when custom_domain is set; defaults to false on the API side."),
|
|
76
|
+
qurl_count: z.number().optional().describe("Number of access tokens minted for this resource"),
|
|
77
|
+
qurls: z.array(accessTokenSchema).optional(),
|
|
78
|
+
});
|
|
79
|
+
/** Ephemeral create-time payload — note `qurl_link` is one-shot. */
|
|
80
|
+
export const createQurlOutputSchema = z.object({
|
|
81
|
+
qurl_id: z.string().describe("Display-friendly qURL ID (q_ prefix)"),
|
|
82
|
+
resource_id: z.string().describe("Stable resource identifier (r_ prefix)"),
|
|
83
|
+
qurl_link: z
|
|
84
|
+
.string()
|
|
85
|
+
.describe("Single-use access link — shown ONCE on creation, never returned again. Share immediately."),
|
|
86
|
+
qurl_site: z.string(),
|
|
87
|
+
expires_at: z.string(),
|
|
88
|
+
label: z.string().optional(),
|
|
89
|
+
});
|
|
90
|
+
export const getQurlOutputSchema = qurlSchema;
|
|
91
|
+
export const updateQurlOutputSchema = qurlSchema;
|
|
92
|
+
export const extendQurlOutputSchema = qurlSchema;
|
|
93
|
+
/**
|
|
94
|
+
* Paginated list response. When `meta.has_more` is true, pass
|
|
95
|
+
* `meta.next_cursor` as the `cursor` argument on the next call.
|
|
96
|
+
*/
|
|
97
|
+
export const listQurlsOutputSchema = z.object({
|
|
98
|
+
data: z.array(qurlSchema),
|
|
99
|
+
meta: z.object({
|
|
100
|
+
next_cursor: z.string().optional().describe("Pass to a subsequent list_qurls call to fetch the next page"),
|
|
101
|
+
has_more: z.boolean().describe("True if more pages are available beyond this response"),
|
|
102
|
+
page_size: z.number().optional(),
|
|
103
|
+
request_id: z.string().optional(),
|
|
104
|
+
}),
|
|
105
|
+
});
|
|
106
|
+
/** Resolve response: target_url + the access_grant that opens the firewall. */
|
|
107
|
+
export const resolveQurlOutputSchema = z.object({
|
|
108
|
+
target_url: z.string().describe("Underlying URL revealed by the resolve"),
|
|
109
|
+
resource_id: z.string(),
|
|
110
|
+
access_grant: z
|
|
111
|
+
.object({
|
|
112
|
+
expires_in: z
|
|
113
|
+
.number()
|
|
114
|
+
.describe("Seconds the firewall will permit access from `src_ip` before re-resolution is required"),
|
|
115
|
+
granted_at: z.string(),
|
|
116
|
+
src_ip: z.string().describe("Caller IP that the access grant is bound to"),
|
|
117
|
+
})
|
|
118
|
+
.describe("Time-bound, IP-bound access grant — required for the qURL firewall to permit the next request"),
|
|
119
|
+
});
|
|
120
|
+
/** Mint response: a fresh `qurl_link` for an existing resource. One-shot, like create_qurl. */
|
|
121
|
+
export const mintLinkOutputSchema = z.object({
|
|
122
|
+
qurl_link: z.string().describe("Newly minted single-use access link (one-shot, like create_qurl)"),
|
|
123
|
+
expires_at: z.string(),
|
|
124
|
+
});
|
|
125
|
+
// Discriminated on `success` so the schema enforces the API's
|
|
126
|
+
// mutual-exclusivity contract — a host or planner generating UI from
|
|
127
|
+
// the schema will only show success-fields under `success: true` and
|
|
128
|
+
// the `error` block under `success: false`, never both.
|
|
129
|
+
const batchItemSuccessSchema = z.object({
|
|
130
|
+
index: z.number().describe("Index of the corresponding item in the input `items` array"),
|
|
131
|
+
success: z.literal(true),
|
|
132
|
+
resource_id: z.string(),
|
|
133
|
+
qurl_link: z.string().describe("One-shot access link — shown ONCE on creation"),
|
|
134
|
+
qurl_site: z.string(),
|
|
135
|
+
expires_at: z.string(),
|
|
136
|
+
});
|
|
137
|
+
const batchItemFailureSchema = z.object({
|
|
138
|
+
index: z.number().describe("Index of the corresponding item in the input `items` array"),
|
|
139
|
+
success: z.literal(false),
|
|
140
|
+
error: z.object({
|
|
141
|
+
code: z.string(),
|
|
142
|
+
message: z.string(),
|
|
143
|
+
}),
|
|
144
|
+
});
|
|
145
|
+
const batchItemResultSchema = z
|
|
146
|
+
.discriminatedUnion("success", [batchItemSuccessSchema, batchItemFailureSchema])
|
|
147
|
+
.describe("Per-item result. Discriminated on `success`.");
|
|
148
|
+
/**
|
|
149
|
+
* Batch creation response. The handler sets `isError: true` when `failed > 0`
|
|
150
|
+
* so agents can branch on partial failure without parsing JSON. `request_id`
|
|
151
|
+
* is hoisted from response metadata for support correlation.
|
|
152
|
+
*
|
|
153
|
+
* Schema flattens the `{ data, meta }` envelope on `BatchCreateOutput` —
|
|
154
|
+
* `output-schemas.types.test.ts` asserts the flattened shape against the
|
|
155
|
+
* client interface so drift on either side fails compilation.
|
|
156
|
+
*/
|
|
157
|
+
export const batchCreateOutputSchema = z.object({
|
|
158
|
+
succeeded: z.number(),
|
|
159
|
+
failed: z.number(),
|
|
160
|
+
results: z.array(batchItemResultSchema),
|
|
161
|
+
request_id: z.string().optional(),
|
|
162
|
+
});
|
|
163
|
+
/** Delete confirmation. The qURL is in a revoked state after this call. */
|
|
164
|
+
export const deleteQurlOutputSchema = z.object({
|
|
165
|
+
resource_id: z.string(),
|
|
166
|
+
revoked: z.literal(true),
|
|
167
|
+
was_already_revoked: z
|
|
168
|
+
.boolean()
|
|
169
|
+
.describe("True when the API responded 404 (resource was already revoked or never existed). " +
|
|
170
|
+
"Agents that need to distinguish 'I revoked it' from 'it was already gone' should branch on this."),
|
|
171
|
+
message: z.string().describe("Human-readable confirmation message"),
|
|
172
|
+
});
|
|
173
|
+
//# sourceMappingURL=output-schemas.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"output-schemas.js","sourceRoot":"","sources":["../../src/tools/output-schemas.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { IQURLClient } from "../client.js";
|
|
3
|
+
export declare const resolveQurlSchema: z.ZodObject<{
|
|
4
|
+
access_token: z.ZodString;
|
|
5
|
+
}, "strip", z.ZodTypeAny, {
|
|
6
|
+
access_token: string;
|
|
7
|
+
}, {
|
|
8
|
+
access_token: string;
|
|
9
|
+
}>;
|
|
10
|
+
export declare function resolveQurlTool(client: IQURLClient): {
|
|
11
|
+
name: string;
|
|
12
|
+
title: string;
|
|
13
|
+
description: string;
|
|
14
|
+
inputSchema: z.ZodObject<{
|
|
15
|
+
access_token: z.ZodString;
|
|
16
|
+
}, "strip", z.ZodTypeAny, {
|
|
17
|
+
access_token: string;
|
|
18
|
+
}, {
|
|
19
|
+
access_token: string;
|
|
20
|
+
}>;
|
|
21
|
+
outputSchema: z.ZodObject<{
|
|
22
|
+
target_url: z.ZodString;
|
|
23
|
+
resource_id: z.ZodString;
|
|
24
|
+
access_grant: z.ZodObject<{
|
|
25
|
+
expires_in: z.ZodNumber;
|
|
26
|
+
granted_at: z.ZodString;
|
|
27
|
+
src_ip: z.ZodString;
|
|
28
|
+
}, "strip", z.ZodTypeAny, {
|
|
29
|
+
expires_in: number;
|
|
30
|
+
granted_at: string;
|
|
31
|
+
src_ip: string;
|
|
32
|
+
}, {
|
|
33
|
+
expires_in: number;
|
|
34
|
+
granted_at: string;
|
|
35
|
+
src_ip: string;
|
|
36
|
+
}>;
|
|
37
|
+
}, "strip", z.ZodTypeAny, {
|
|
38
|
+
resource_id: string;
|
|
39
|
+
target_url: string;
|
|
40
|
+
access_grant: {
|
|
41
|
+
expires_in: number;
|
|
42
|
+
granted_at: string;
|
|
43
|
+
src_ip: string;
|
|
44
|
+
};
|
|
45
|
+
}, {
|
|
46
|
+
resource_id: string;
|
|
47
|
+
target_url: string;
|
|
48
|
+
access_grant: {
|
|
49
|
+
expires_in: number;
|
|
50
|
+
granted_at: string;
|
|
51
|
+
src_ip: string;
|
|
52
|
+
};
|
|
53
|
+
}>;
|
|
54
|
+
annotations: {
|
|
55
|
+
title: string;
|
|
56
|
+
readOnlyHint: boolean;
|
|
57
|
+
destructiveHint: boolean;
|
|
58
|
+
idempotentHint: boolean;
|
|
59
|
+
openWorldHint: boolean;
|
|
60
|
+
};
|
|
61
|
+
handler: (input: {
|
|
62
|
+
access_token: string;
|
|
63
|
+
}) => Promise<{
|
|
64
|
+
content: Array<{
|
|
65
|
+
type: "text";
|
|
66
|
+
text: string;
|
|
67
|
+
}>;
|
|
68
|
+
structuredContent?: Record<string, unknown>;
|
|
69
|
+
isError?: boolean;
|
|
70
|
+
}>;
|
|
71
|
+
};
|
|
72
|
+
//# sourceMappingURL=resolve-qurl.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolve-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/resolve-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,iBAAiB;;;;;;EAK5B,CAAC;AAEH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgClD"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { toStructuredContent, withMissingApiKeyHandler } from "./_shared.js";
|
|
3
|
+
import { resolveQurlOutputSchema } from "./output-schemas.js";
|
|
4
|
+
export const resolveQurlSchema = z.object({
|
|
5
|
+
access_token: z
|
|
6
|
+
.string()
|
|
7
|
+
.min(1)
|
|
8
|
+
.describe("The access token from a qURL link (e.g., at_k8xqp9h2sj9lx7r4a)"),
|
|
9
|
+
});
|
|
10
|
+
export function resolveQurlTool(client) {
|
|
11
|
+
return {
|
|
12
|
+
name: "resolve_qurl",
|
|
13
|
+
title: "Resolve qURL Access Token",
|
|
14
|
+
description: "Redeem a qURL access token (the `at_` prefix you pulled out of a `qurl_link`) to reveal the underlying URL and open a time-bound, IP-bound firewall grant. " +
|
|
15
|
+
"Use this when an agent has been handed an access token and needs to fetch the protected resource — after a successful resolve, requests from `access_grant.src_ip` will be permitted to the `target_url` for `access_grant.expires_in` seconds. " +
|
|
16
|
+
"Use `get_qurl` instead when you have a resource ID (`r_`) or qURL display ID (`q_`) and want admin-side details rather than end-user redemption. " +
|
|
17
|
+
"**Side-effects:** consumes one use on `one_time_use` tokens, decrements `max_sessions`, and may trip access policies (IP/geo/UA/AI-agent denylists). " +
|
|
18
|
+
"**`idempotentHint: false`** because one-time-use tokens consume on each call; for non-one-time tokens within an active grant window, repeats are effectively no-ops, but the conservative annotation reflects worst-case behavior.",
|
|
19
|
+
inputSchema: resolveQurlSchema,
|
|
20
|
+
outputSchema: resolveQurlOutputSchema,
|
|
21
|
+
annotations: {
|
|
22
|
+
title: "Resolve qURL Access Token",
|
|
23
|
+
readOnlyHint: false,
|
|
24
|
+
destructiveHint: false,
|
|
25
|
+
idempotentHint: false,
|
|
26
|
+
openWorldHint: true,
|
|
27
|
+
},
|
|
28
|
+
handler: withMissingApiKeyHandler(async (input) => {
|
|
29
|
+
const result = await client.resolveQURL(input);
|
|
30
|
+
return {
|
|
31
|
+
content: [
|
|
32
|
+
{
|
|
33
|
+
type: "text",
|
|
34
|
+
text: JSON.stringify(result.data),
|
|
35
|
+
},
|
|
36
|
+
],
|
|
37
|
+
structuredContent: toStructuredContent(result.data),
|
|
38
|
+
};
|
|
39
|
+
}),
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
//# sourceMappingURL=resolve-qurl.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolve-qurl.js","sourceRoot":"","sources":["../../src/tools/resolve-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,6JAA6J;YAC7J,kPAAkP;YAClP,mJAAmJ;YACnJ,uJAAuJ;YACvJ,oOAAoO;QACtO,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,KAAK,EAAE,2BAA2B;YAClC,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAwC,EAAE,EAAE;YACnF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC/C,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,330 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { IQURLClient } from "../client.js";
|
|
3
|
+
export declare const updateQurlBaseSchema: z.ZodObject<{
|
|
4
|
+
resource_id: z.ZodString;
|
|
5
|
+
extend_by: z.ZodOptional<z.ZodString>;
|
|
6
|
+
expires_at: z.ZodOptional<z.ZodString>;
|
|
7
|
+
tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
8
|
+
description: z.ZodOptional<z.ZodString>;
|
|
9
|
+
custom_domain: z.ZodOptional<z.ZodString>;
|
|
10
|
+
preserve_host: z.ZodOptional<z.ZodBoolean>;
|
|
11
|
+
}, "strip", z.ZodTypeAny, {
|
|
12
|
+
resource_id: string;
|
|
13
|
+
expires_at?: string | undefined;
|
|
14
|
+
description?: string | undefined;
|
|
15
|
+
tags?: string[] | undefined;
|
|
16
|
+
custom_domain?: string | undefined;
|
|
17
|
+
preserve_host?: boolean | undefined;
|
|
18
|
+
extend_by?: string | undefined;
|
|
19
|
+
}, {
|
|
20
|
+
resource_id: string;
|
|
21
|
+
expires_at?: string | undefined;
|
|
22
|
+
description?: string | undefined;
|
|
23
|
+
tags?: string[] | undefined;
|
|
24
|
+
custom_domain?: string | undefined;
|
|
25
|
+
preserve_host?: boolean | undefined;
|
|
26
|
+
extend_by?: string | undefined;
|
|
27
|
+
}>;
|
|
28
|
+
export declare const updateQurlSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
|
|
29
|
+
resource_id: z.ZodString;
|
|
30
|
+
extend_by: z.ZodOptional<z.ZodString>;
|
|
31
|
+
expires_at: z.ZodOptional<z.ZodString>;
|
|
32
|
+
tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
33
|
+
description: z.ZodOptional<z.ZodString>;
|
|
34
|
+
custom_domain: z.ZodOptional<z.ZodString>;
|
|
35
|
+
preserve_host: z.ZodOptional<z.ZodBoolean>;
|
|
36
|
+
}, "strip", z.ZodTypeAny, {
|
|
37
|
+
resource_id: string;
|
|
38
|
+
expires_at?: string | undefined;
|
|
39
|
+
description?: string | undefined;
|
|
40
|
+
tags?: string[] | undefined;
|
|
41
|
+
custom_domain?: string | undefined;
|
|
42
|
+
preserve_host?: boolean | undefined;
|
|
43
|
+
extend_by?: string | undefined;
|
|
44
|
+
}, {
|
|
45
|
+
resource_id: string;
|
|
46
|
+
expires_at?: string | undefined;
|
|
47
|
+
description?: string | undefined;
|
|
48
|
+
tags?: string[] | undefined;
|
|
49
|
+
custom_domain?: string | undefined;
|
|
50
|
+
preserve_host?: boolean | undefined;
|
|
51
|
+
extend_by?: string | undefined;
|
|
52
|
+
}>, {
|
|
53
|
+
resource_id: string;
|
|
54
|
+
expires_at?: string | undefined;
|
|
55
|
+
description?: string | undefined;
|
|
56
|
+
tags?: string[] | undefined;
|
|
57
|
+
custom_domain?: string | undefined;
|
|
58
|
+
preserve_host?: boolean | undefined;
|
|
59
|
+
extend_by?: string | undefined;
|
|
60
|
+
}, {
|
|
61
|
+
resource_id: string;
|
|
62
|
+
expires_at?: string | undefined;
|
|
63
|
+
description?: string | undefined;
|
|
64
|
+
tags?: string[] | undefined;
|
|
65
|
+
custom_domain?: string | undefined;
|
|
66
|
+
preserve_host?: boolean | undefined;
|
|
67
|
+
extend_by?: string | undefined;
|
|
68
|
+
}>, {
|
|
69
|
+
resource_id: string;
|
|
70
|
+
expires_at?: string | undefined;
|
|
71
|
+
description?: string | undefined;
|
|
72
|
+
tags?: string[] | undefined;
|
|
73
|
+
custom_domain?: string | undefined;
|
|
74
|
+
preserve_host?: boolean | undefined;
|
|
75
|
+
extend_by?: string | undefined;
|
|
76
|
+
}, {
|
|
77
|
+
resource_id: string;
|
|
78
|
+
expires_at?: string | undefined;
|
|
79
|
+
description?: string | undefined;
|
|
80
|
+
tags?: string[] | undefined;
|
|
81
|
+
custom_domain?: string | undefined;
|
|
82
|
+
preserve_host?: boolean | undefined;
|
|
83
|
+
extend_by?: string | undefined;
|
|
84
|
+
}>;
|
|
85
|
+
export declare function updateQurlTool(client: IQURLClient): {
|
|
86
|
+
name: string;
|
|
87
|
+
title: string;
|
|
88
|
+
description: string;
|
|
89
|
+
inputSchema: z.ZodObject<{
|
|
90
|
+
resource_id: z.ZodString;
|
|
91
|
+
extend_by: z.ZodOptional<z.ZodString>;
|
|
92
|
+
expires_at: z.ZodOptional<z.ZodString>;
|
|
93
|
+
tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
94
|
+
description: z.ZodOptional<z.ZodString>;
|
|
95
|
+
custom_domain: z.ZodOptional<z.ZodString>;
|
|
96
|
+
preserve_host: z.ZodOptional<z.ZodBoolean>;
|
|
97
|
+
}, "strip", z.ZodTypeAny, {
|
|
98
|
+
resource_id: string;
|
|
99
|
+
expires_at?: string | undefined;
|
|
100
|
+
description?: string | undefined;
|
|
101
|
+
tags?: string[] | undefined;
|
|
102
|
+
custom_domain?: string | undefined;
|
|
103
|
+
preserve_host?: boolean | undefined;
|
|
104
|
+
extend_by?: string | undefined;
|
|
105
|
+
}, {
|
|
106
|
+
resource_id: string;
|
|
107
|
+
expires_at?: string | undefined;
|
|
108
|
+
description?: string | undefined;
|
|
109
|
+
tags?: string[] | undefined;
|
|
110
|
+
custom_domain?: string | undefined;
|
|
111
|
+
preserve_host?: boolean | undefined;
|
|
112
|
+
extend_by?: string | undefined;
|
|
113
|
+
}>;
|
|
114
|
+
outputSchema: z.ZodObject<{
|
|
115
|
+
resource_id: z.ZodString;
|
|
116
|
+
qurl_site: z.ZodOptional<z.ZodString>;
|
|
117
|
+
target_url: z.ZodString;
|
|
118
|
+
description: z.ZodOptional<z.ZodString>;
|
|
119
|
+
tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
120
|
+
expires_at: z.ZodString;
|
|
121
|
+
created_at: z.ZodString;
|
|
122
|
+
status: z.ZodEnum<["active", "revoked"]>;
|
|
123
|
+
custom_domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
124
|
+
preserve_host: z.ZodOptional<z.ZodBoolean>;
|
|
125
|
+
qurl_count: z.ZodOptional<z.ZodNumber>;
|
|
126
|
+
qurls: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
127
|
+
qurl_id: z.ZodString;
|
|
128
|
+
label: z.ZodOptional<z.ZodString>;
|
|
129
|
+
status: z.ZodEnum<["active", "consumed", "expired", "revoked"]>;
|
|
130
|
+
one_time_use: z.ZodBoolean;
|
|
131
|
+
max_sessions: z.ZodNumber;
|
|
132
|
+
session_duration: z.ZodNumber;
|
|
133
|
+
use_count: z.ZodNumber;
|
|
134
|
+
qurl_site: z.ZodOptional<z.ZodString>;
|
|
135
|
+
access_policy: z.ZodOptional<z.ZodObject<{
|
|
136
|
+
ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
137
|
+
ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
138
|
+
geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
139
|
+
geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
140
|
+
user_agent_allow_regex: z.ZodOptional<z.ZodString>;
|
|
141
|
+
user_agent_deny_regex: z.ZodOptional<z.ZodString>;
|
|
142
|
+
ai_agent_policy: z.ZodOptional<z.ZodObject<{
|
|
143
|
+
block_all: z.ZodOptional<z.ZodBoolean>;
|
|
144
|
+
deny_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
145
|
+
allow_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
146
|
+
}, "strip", z.ZodTypeAny, {
|
|
147
|
+
block_all?: boolean | undefined;
|
|
148
|
+
deny_categories?: string[] | undefined;
|
|
149
|
+
allow_categories?: string[] | undefined;
|
|
150
|
+
}, {
|
|
151
|
+
block_all?: boolean | undefined;
|
|
152
|
+
deny_categories?: string[] | undefined;
|
|
153
|
+
allow_categories?: string[] | undefined;
|
|
154
|
+
}>>;
|
|
155
|
+
}, "strip", z.ZodTypeAny, {
|
|
156
|
+
ip_allowlist?: string[] | undefined;
|
|
157
|
+
ip_denylist?: string[] | undefined;
|
|
158
|
+
geo_allowlist?: string[] | undefined;
|
|
159
|
+
geo_denylist?: string[] | undefined;
|
|
160
|
+
user_agent_allow_regex?: string | undefined;
|
|
161
|
+
user_agent_deny_regex?: string | undefined;
|
|
162
|
+
ai_agent_policy?: {
|
|
163
|
+
block_all?: boolean | undefined;
|
|
164
|
+
deny_categories?: string[] | undefined;
|
|
165
|
+
allow_categories?: string[] | undefined;
|
|
166
|
+
} | undefined;
|
|
167
|
+
}, {
|
|
168
|
+
ip_allowlist?: string[] | undefined;
|
|
169
|
+
ip_denylist?: string[] | undefined;
|
|
170
|
+
geo_allowlist?: string[] | undefined;
|
|
171
|
+
geo_denylist?: string[] | undefined;
|
|
172
|
+
user_agent_allow_regex?: string | undefined;
|
|
173
|
+
user_agent_deny_regex?: string | undefined;
|
|
174
|
+
ai_agent_policy?: {
|
|
175
|
+
block_all?: boolean | undefined;
|
|
176
|
+
deny_categories?: string[] | undefined;
|
|
177
|
+
allow_categories?: string[] | undefined;
|
|
178
|
+
} | undefined;
|
|
179
|
+
}>>;
|
|
180
|
+
created_at: z.ZodString;
|
|
181
|
+
expires_at: z.ZodString;
|
|
182
|
+
}, "strip", z.ZodTypeAny, {
|
|
183
|
+
status: "active" | "consumed" | "expired" | "revoked";
|
|
184
|
+
qurl_id: string;
|
|
185
|
+
one_time_use: boolean;
|
|
186
|
+
max_sessions: number;
|
|
187
|
+
session_duration: number;
|
|
188
|
+
use_count: number;
|
|
189
|
+
created_at: string;
|
|
190
|
+
expires_at: string;
|
|
191
|
+
label?: string | undefined;
|
|
192
|
+
qurl_site?: string | undefined;
|
|
193
|
+
access_policy?: {
|
|
194
|
+
ip_allowlist?: string[] | undefined;
|
|
195
|
+
ip_denylist?: string[] | undefined;
|
|
196
|
+
geo_allowlist?: string[] | undefined;
|
|
197
|
+
geo_denylist?: string[] | undefined;
|
|
198
|
+
user_agent_allow_regex?: string | undefined;
|
|
199
|
+
user_agent_deny_regex?: string | undefined;
|
|
200
|
+
ai_agent_policy?: {
|
|
201
|
+
block_all?: boolean | undefined;
|
|
202
|
+
deny_categories?: string[] | undefined;
|
|
203
|
+
allow_categories?: string[] | undefined;
|
|
204
|
+
} | undefined;
|
|
205
|
+
} | undefined;
|
|
206
|
+
}, {
|
|
207
|
+
status: "active" | "consumed" | "expired" | "revoked";
|
|
208
|
+
qurl_id: string;
|
|
209
|
+
one_time_use: boolean;
|
|
210
|
+
max_sessions: number;
|
|
211
|
+
session_duration: number;
|
|
212
|
+
use_count: number;
|
|
213
|
+
created_at: string;
|
|
214
|
+
expires_at: string;
|
|
215
|
+
label?: string | undefined;
|
|
216
|
+
qurl_site?: string | undefined;
|
|
217
|
+
access_policy?: {
|
|
218
|
+
ip_allowlist?: string[] | undefined;
|
|
219
|
+
ip_denylist?: string[] | undefined;
|
|
220
|
+
geo_allowlist?: string[] | undefined;
|
|
221
|
+
geo_denylist?: string[] | undefined;
|
|
222
|
+
user_agent_allow_regex?: string | undefined;
|
|
223
|
+
user_agent_deny_regex?: string | undefined;
|
|
224
|
+
ai_agent_policy?: {
|
|
225
|
+
block_all?: boolean | undefined;
|
|
226
|
+
deny_categories?: string[] | undefined;
|
|
227
|
+
allow_categories?: string[] | undefined;
|
|
228
|
+
} | undefined;
|
|
229
|
+
} | undefined;
|
|
230
|
+
}>, "many">>;
|
|
231
|
+
}, "strip", z.ZodTypeAny, {
|
|
232
|
+
status: "active" | "revoked";
|
|
233
|
+
created_at: string;
|
|
234
|
+
expires_at: string;
|
|
235
|
+
resource_id: string;
|
|
236
|
+
target_url: string;
|
|
237
|
+
qurl_site?: string | undefined;
|
|
238
|
+
description?: string | undefined;
|
|
239
|
+
tags?: string[] | undefined;
|
|
240
|
+
custom_domain?: string | null | undefined;
|
|
241
|
+
preserve_host?: boolean | undefined;
|
|
242
|
+
qurl_count?: number | undefined;
|
|
243
|
+
qurls?: {
|
|
244
|
+
status: "active" | "consumed" | "expired" | "revoked";
|
|
245
|
+
qurl_id: string;
|
|
246
|
+
one_time_use: boolean;
|
|
247
|
+
max_sessions: number;
|
|
248
|
+
session_duration: number;
|
|
249
|
+
use_count: number;
|
|
250
|
+
created_at: string;
|
|
251
|
+
expires_at: string;
|
|
252
|
+
label?: string | undefined;
|
|
253
|
+
qurl_site?: string | undefined;
|
|
254
|
+
access_policy?: {
|
|
255
|
+
ip_allowlist?: string[] | undefined;
|
|
256
|
+
ip_denylist?: string[] | undefined;
|
|
257
|
+
geo_allowlist?: string[] | undefined;
|
|
258
|
+
geo_denylist?: string[] | undefined;
|
|
259
|
+
user_agent_allow_regex?: string | undefined;
|
|
260
|
+
user_agent_deny_regex?: string | undefined;
|
|
261
|
+
ai_agent_policy?: {
|
|
262
|
+
block_all?: boolean | undefined;
|
|
263
|
+
deny_categories?: string[] | undefined;
|
|
264
|
+
allow_categories?: string[] | undefined;
|
|
265
|
+
} | undefined;
|
|
266
|
+
} | undefined;
|
|
267
|
+
}[] | undefined;
|
|
268
|
+
}, {
|
|
269
|
+
status: "active" | "revoked";
|
|
270
|
+
created_at: string;
|
|
271
|
+
expires_at: string;
|
|
272
|
+
resource_id: string;
|
|
273
|
+
target_url: string;
|
|
274
|
+
qurl_site?: string | undefined;
|
|
275
|
+
description?: string | undefined;
|
|
276
|
+
tags?: string[] | undefined;
|
|
277
|
+
custom_domain?: string | null | undefined;
|
|
278
|
+
preserve_host?: boolean | undefined;
|
|
279
|
+
qurl_count?: number | undefined;
|
|
280
|
+
qurls?: {
|
|
281
|
+
status: "active" | "consumed" | "expired" | "revoked";
|
|
282
|
+
qurl_id: string;
|
|
283
|
+
one_time_use: boolean;
|
|
284
|
+
max_sessions: number;
|
|
285
|
+
session_duration: number;
|
|
286
|
+
use_count: number;
|
|
287
|
+
created_at: string;
|
|
288
|
+
expires_at: string;
|
|
289
|
+
label?: string | undefined;
|
|
290
|
+
qurl_site?: string | undefined;
|
|
291
|
+
access_policy?: {
|
|
292
|
+
ip_allowlist?: string[] | undefined;
|
|
293
|
+
ip_denylist?: string[] | undefined;
|
|
294
|
+
geo_allowlist?: string[] | undefined;
|
|
295
|
+
geo_denylist?: string[] | undefined;
|
|
296
|
+
user_agent_allow_regex?: string | undefined;
|
|
297
|
+
user_agent_deny_regex?: string | undefined;
|
|
298
|
+
ai_agent_policy?: {
|
|
299
|
+
block_all?: boolean | undefined;
|
|
300
|
+
deny_categories?: string[] | undefined;
|
|
301
|
+
allow_categories?: string[] | undefined;
|
|
302
|
+
} | undefined;
|
|
303
|
+
} | undefined;
|
|
304
|
+
}[] | undefined;
|
|
305
|
+
}>;
|
|
306
|
+
annotations: {
|
|
307
|
+
title: string;
|
|
308
|
+
readOnlyHint: boolean;
|
|
309
|
+
destructiveHint: boolean;
|
|
310
|
+
idempotentHint: boolean;
|
|
311
|
+
openWorldHint: boolean;
|
|
312
|
+
};
|
|
313
|
+
handler: (input: {
|
|
314
|
+
resource_id: string;
|
|
315
|
+
expires_at?: string | undefined;
|
|
316
|
+
description?: string | undefined;
|
|
317
|
+
tags?: string[] | undefined;
|
|
318
|
+
custom_domain?: string | undefined;
|
|
319
|
+
preserve_host?: boolean | undefined;
|
|
320
|
+
extend_by?: string | undefined;
|
|
321
|
+
}) => Promise<{
|
|
322
|
+
content: Array<{
|
|
323
|
+
type: "text";
|
|
324
|
+
text: string;
|
|
325
|
+
}>;
|
|
326
|
+
structuredContent?: Record<string, unknown>;
|
|
327
|
+
isError?: boolean;
|
|
328
|
+
}>;
|
|
329
|
+
};
|
|
330
|
+
//# sourceMappingURL=update-qurl.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"update-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/update-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAqBhD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EA6B/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB1B,CAAC;AAEJ,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCjD"}
|