@layervai/qurl-mcp 0.4.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/dist/client.d.ts +111 -22
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +161 -77
- package/dist/client.js.map +1 -1
- package/dist/index.js +3 -2
- package/dist/index.js.map +1 -1
- 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 +7 -3
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +8 -0
- package/dist/server.js.map +1 -1
- package/dist/tools/_shared.d.ts +4 -2
- package/dist/tools/_shared.d.ts.map +1 -1
- package/dist/tools/_shared.js +15 -3
- package/dist/tools/_shared.js.map +1 -1
- package/dist/tools/batch-create.d.ts +31 -339
- package/dist/tools/batch-create.d.ts.map +1 -1
- package/dist/tools/batch-create.js +1 -0
- package/dist/tools/batch-create.js.map +1 -1
- package/dist/tools/create-qurl.d.ts +37 -234
- package/dist/tools/create-qurl.d.ts.map +1 -1
- package/dist/tools/create-qurl.js +25 -28
- package/dist/tools/create-qurl.js.map +1 -1
- package/dist/tools/delete-qurl.d.ts +3 -21
- package/dist/tools/delete-qurl.d.ts.map +1 -1
- package/dist/tools/delete-qurl.js +18 -5
- package/dist/tools/delete-qurl.js.map +1 -1
- package/dist/tools/extend-qurl.d.ts +34 -188
- package/dist/tools/extend-qurl.d.ts.map +1 -1
- package/dist/tools/get-qurl.d.ts +34 -184
- package/dist/tools/get-qurl.d.ts.map +1 -1
- package/dist/tools/get-qurl.js +3 -2
- package/dist/tools/get-qurl.js.map +1 -1
- package/dist/tools/list-qurl-sessions.d.ts +44 -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 +36 -318
- package/dist/tools/list-qurls.d.ts.map +1 -1
- package/dist/tools/list-qurls.js +41 -18
- package/dist/tools/list-qurls.js.map +1 -1
- package/dist/tools/mint-link.d.ts +34 -301
- package/dist/tools/mint-link.d.ts.map +1 -1
- package/dist/tools/mint-link.js +12 -9
- package/dist/tools/mint-link.js.map +1 -1
- package/dist/tools/output-schemas.d.ts +266 -1109
- package/dist/tools/output-schemas.d.ts.map +1 -1
- package/dist/tools/output-schemas.js +96 -20
- package/dist/tools/output-schemas.js.map +1 -1
- package/dist/tools/resolve-qurl.d.ts +4 -36
- package/dist/tools/resolve-qurl.d.ts.map +1 -1
- package/dist/tools/resolve-qurl.js +2 -2
- package/dist/tools/resolve-qurl.js.map +1 -1
- package/dist/tools/revoke-qurl-token.d.ts +40 -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 +40 -0
- package/dist/tools/terminate-qurl-sessions.d.ts.map +1 -0
- package/dist/tools/terminate-qurl-sessions.js +64 -0
- package/dist/tools/terminate-qurl-sessions.js.map +1 -0
- package/dist/tools/update-qurl-token.d.ts +141 -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 +41 -263
- package/dist/tools/update-qurl.d.ts.map +1 -1
- package/dist/tools/update-qurl.js +56 -7
- package/dist/tools/update-qurl.js.map +1 -1
- package/package.json +4 -3
|
@@ -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()
|
|
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 an r_ resource ID",
|
|
41
55
|
})
|
|
42
56
|
.refine(
|
|
43
57
|
// Use `!== undefined` rather than truthy checks so the API's "clear"
|
|
@@ -58,9 +72,9 @@ export function updateQurlTool(client) {
|
|
|
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 both `r_` and `q_` IDs (q_ is auto-resolved)
|
|
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 both `r_` and `q_` IDs for expiration, tags, and description updates (q_ is auto-resolved); custom domain and preserve_host updates require an `r_` resource 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,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,4EAA4E;AAC5E,4EAA4E;AAC5E,uDAAuD;AACvD,MAAM,SAAS,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CACJ,8BAA8B,EAC9B,qGAAqG,CACtG,CAAC;AAEJ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACvC,SAAS,EAAE,CAAC,
|
|
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,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,4EAA4E;AAC5E,4EAA4E;AAC5E,uDAAuD;AACvD,MAAM,SAAS,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CACJ,8BAA8B,EAC9B,qGAAqG,CACtG,CAAC;AAEJ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACvC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qGAAqG;QACnG,mBAAmB,CACtB;IACH,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,oFAAoF;QAClF,2EAA2E,CAC9E;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB;KACjD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE;IACtD,OAAO,EAAE,kDAAkD;CAC5D,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAC,EAAE;IACjF,OAAO,EACL,6HAA6H;CAChI,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE;IACzF,OAAO,EAAE,mEAAmE;CAC7E,CAAC;KACD,MAAM;AACL,qEAAqE;AACrE,sEAAsE;AACtE,kEAAkE;AAClE,+DAA+D;AAC/D,wDAAwD;AACxD,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,SAAS,KAAK,SAAS;IAC5B,IAAI,CAAC,UAAU,KAAK,SAAS;IAC7B,IAAI,CAAC,IAAI,KAAK,SAAS;IACvB,IAAI,CAAC,WAAW,KAAK,SAAS;IAC9B,IAAI,CAAC,aAAa,KAAK,SAAS;IAChC,IAAI,CAAC,aAAa,KAAK,SAAS,EAClC;IACE,OAAO,EACL,mHAAmH;CACtH,CACF,CAAC;AAEJ,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,mNAAmN;YACnN,gPAAgP;YAChP,4RAA4R;YAC5R,oHAAoH;YACpH,kEAAkE;YAClE,sDAAsD;YACtD,0OAA0O;YAC1O,0DAA0D;QAC5D,uEAAuE;QACvE,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,aAAa;YACpB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,GAAyC,EAAE,EAAE;YACpF,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;YACpC,qEAAqE;YACrE,qEAAqE;YACrE,uEAAuE;YACvE,MAAM,MAAM,GAAG,yBAAyB,CAAC,MAAM,CAAC,IAAI,CAAC;gBACnD,CAAC,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAChF,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3E,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;AAID,SAAS,mBAAmB,CAAC,IAAsB;IACjD,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;AACvE,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAsB;IACvD,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC;AAC9E,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAsB;IACjD,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAClE,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACrE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACnD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAsB;IACrD,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACnD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACxE,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IAC9E,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IAC9E,OAAO,IAAI,CAAC;AACd,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@layervai/qurl-mcp",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.1",
|
|
4
4
|
"description": "MCP server for qURL™ — secure link management for AI agents. Quantum URL is how you enter the hidden layer of the internet.",
|
|
5
5
|
"mcpName": "io.github.layervai/qurl-mcp",
|
|
6
6
|
"type": "module",
|
|
@@ -33,8 +33,9 @@
|
|
|
33
33
|
"url": "https://github.com/layervai/qurl-mcp"
|
|
34
34
|
},
|
|
35
35
|
"dependencies": {
|
|
36
|
+
"@layervai/qurl": "^0.2.0",
|
|
36
37
|
"@modelcontextprotocol/sdk": "^1.12.1",
|
|
37
|
-
"zod": "^
|
|
38
|
+
"zod": "^4.4.3"
|
|
38
39
|
},
|
|
39
40
|
"devDependencies": {
|
|
40
41
|
"@eslint/js": "^9.27.0",
|
|
@@ -47,7 +48,7 @@
|
|
|
47
48
|
"vitest": "^4.1.5"
|
|
48
49
|
},
|
|
49
50
|
"engines": {
|
|
50
|
-
"node": ">=
|
|
51
|
+
"node": ">=20"
|
|
51
52
|
},
|
|
52
53
|
"files": [
|
|
53
54
|
"dist/"
|