@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
|
@@ -1,19 +1,11 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { QURLAPIError } from "../client.js";
|
|
3
|
-
import { withMissingApiKeyHandler } from "./_shared.js";
|
|
3
|
+
import { resourceOnlyIdSchema, withMissingApiKeyHandler, } from "./_shared.js";
|
|
4
4
|
import { deleteQurlOutputSchema } from "./output-schemas.js";
|
|
5
5
|
export const deleteQurlSchema = z.object({
|
|
6
|
-
|
|
7
|
-
// get/update/extend/mint_link which also accept q_ prefixes. Reject
|
|
8
|
-
// non-r_ IDs at the schema boundary so agents get a clear error
|
|
9
|
-
// instead of a confusing API-side rejection.
|
|
10
|
-
resource_id: z
|
|
11
|
-
.string()
|
|
12
|
-
.min(1)
|
|
13
|
-
.startsWith("r_", "delete_qurl only accepts resource IDs (r_ prefix). Use update_qurl or mint_link for q_ IDs.")
|
|
14
|
-
.describe("The resource ID (must start with r_). delete_qurl does not accept q_ (qURL display) IDs."),
|
|
6
|
+
resource_id: resourceOnlyIdSchema("revoke (all tokens; q_ display IDs are not accepted)"),
|
|
15
7
|
});
|
|
16
|
-
export function deleteQurlTool(client) {
|
|
8
|
+
export function deleteQurlTool(client, _runtime = { mode: "stdio" }) {
|
|
17
9
|
return {
|
|
18
10
|
name: "delete_qurl",
|
|
19
11
|
title: "Delete qURL",
|
|
@@ -21,8 +13,10 @@ export function deleteQurlTool(client) {
|
|
|
21
13
|
"**This action is irreversible.** Use this when you want to cut off access entirely (compromised link, departed user, end-of-engagement). " +
|
|
22
14
|
"Use `update_qurl` instead when you only need to shorten/extend the expiration, retag, or rename — those preserve the existing access tokens. " +
|
|
23
15
|
"Use `extend_qurl` when you only need to push the expiration out. " +
|
|
24
|
-
"**Idempotent:**
|
|
25
|
-
"
|
|
16
|
+
"**Idempotent:** the API returns 404 for re-deletes, never-existed IDs, and resources owned by another API key (ownership-mismatch is collapsed into 404 server-side to avoid existence disclosure); this tool swallows all three. " +
|
|
17
|
+
"Branch on `was_already_revoked` to distinguish the no-op case from a successful revoke on this call. " +
|
|
18
|
+
"When the ID came from user input and ownership matters, call `get_qurl` first — a 200 confirms ownership; a thrown 404 is equally ambiguous on that endpoint too. " +
|
|
19
|
+
'Returns a confirmation payload. By default the resource is excluded from `list_qurls`; pass `status: "revoked"` to see it.',
|
|
26
20
|
inputSchema: deleteQurlSchema,
|
|
27
21
|
outputSchema: deleteQurlOutputSchema,
|
|
28
22
|
annotations: {
|
|
@@ -45,6 +39,18 @@ export function deleteQurlTool(client) {
|
|
|
45
39
|
// `was_already_revoked: true` in the payload so defensive
|
|
46
40
|
// agents can branch when they care.
|
|
47
41
|
//
|
|
42
|
+
// Verified against qurl-service: the service-layer
|
|
43
|
+
// `QurlService.RevokeQurl` and `QurlService.GetQurl` both
|
|
44
|
+
// collapse ownership-mismatch into `ErrResourceNotFound` — so
|
|
45
|
+
// 404 covers "you don't own this resource" on both endpoints.
|
|
46
|
+
// The collapse is server-side policy to avoid existence
|
|
47
|
+
// disclosure. The tool description tells callers that
|
|
48
|
+
// `get_qurl` only confirms ownership in the *positive* case
|
|
49
|
+
// (200), since `get_qurl`'s 404 is just as ambiguous as
|
|
50
|
+
// `delete_qurl`'s. (Function names only — line numbers in a
|
|
51
|
+
// separate repo rot on the next refactor; grep
|
|
52
|
+
// `func.*RevokeQurl\b` / `func.*GetQurl\b` in qurl-service.)
|
|
53
|
+
//
|
|
48
54
|
// Intentionally checks status only, not `code`. A 404 with a
|
|
49
55
|
// non-JSON body (e.g. an HTML error page from a proxy in front
|
|
50
56
|
// of the API) lands here as `code: "parse_error"` — the
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"delete-qurl.js","sourceRoot":"","sources":["../../src/tools/delete-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,
|
|
1
|
+
{"version":3,"file":"delete-qurl.js","sourceRoot":"","sources":["../../src/tools/delete-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GAEzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,oBAAoB,CAAC,sDAAsD,CAAC;CAC1F,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,WAA+B,EAAE,IAAI,EAAE,OAAO,EAAE;IAEhD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,iGAAiG;YACjG,2IAA2I;YAC3I,+IAA+I;YAC/I,mEAAmE;YACnE,oOAAoO;YACpO,uGAAuG;YACvG,oKAAoK;YACpK,4HAA4H;QAC9H,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,aAAa;YACpB,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAuC,EAAE,EAAE;YAClF,IAAI,iBAAiB,GAAG,KAAK,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,+DAA+D;gBAC/D,8DAA8D;gBAC9D,+DAA+D;gBAC/D,kDAAkD;gBAClD,0DAA0D;gBAC1D,oCAAoC;gBACpC,EAAE;gBACF,mDAAmD;gBACnD,0DAA0D;gBAC1D,8DAA8D;gBAC9D,8DAA8D;gBAC9D,wDAAwD;gBACxD,sDAAsD;gBACtD,4DAA4D;gBAC5D,wDAAwD;gBACxD,4DAA4D;gBAC5D,+CAA+C;gBAC/C,6DAA6D;gBAC7D,EAAE;gBACF,6DAA6D;gBAC7D,+DAA+D;gBAC/D,wDAAwD;gBACxD,+DAA+D;gBAC/D,2DAA2D;gBAC3D,8BAA8B;gBAC9B,IAAI,CAAC,CAAC,GAAG,YAAY,YAAY,CAAC,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG;oBAAE,MAAM,GAAG,CAAC;gBACxE,iBAAiB,GAAG,IAAI,CAAC;YAC3B,CAAC;YACD,MAAM,OAAO,GAAG;gBACd,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EAAE,IAAa;gBACtB,mBAAmB,EAAE,iBAAiB;gBACtC,OAAO,EAAE,QAAQ,KAAK,CAAC,WAAW,cAAc;aACjD,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,OAAO,CAAC,OAAO;qBACtB;iBACF;gBACD,iBAAiB,EAAE,OAAO;aAC3B,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { EmailDeliveryResult } from "../email-types.js";
|
|
3
|
+
export declare const emailDeliveryInputSchema: z.ZodObject<{
|
|
4
|
+
to: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEmail>>;
|
|
5
|
+
subject: z.ZodOptional<z.ZodString>;
|
|
6
|
+
message: z.ZodOptional<z.ZodString>;
|
|
7
|
+
}, z.core.$strip>;
|
|
8
|
+
export type EmailDeliveryInput = z.infer<typeof emailDeliveryInputSchema>;
|
|
9
|
+
export interface ToolEmailInput {
|
|
10
|
+
allowServerApiKeyFallback: boolean;
|
|
11
|
+
delivery?: EmailDeliveryInput;
|
|
12
|
+
defaultSubject: string;
|
|
13
|
+
detailLines: string[];
|
|
14
|
+
}
|
|
15
|
+
export interface UploadEmailDetails {
|
|
16
|
+
intro: string;
|
|
17
|
+
fileName: string;
|
|
18
|
+
contentType: string;
|
|
19
|
+
qurlLink: string;
|
|
20
|
+
expiresAt?: string;
|
|
21
|
+
qurlSite?: string;
|
|
22
|
+
label?: string;
|
|
23
|
+
extraLines?: string[];
|
|
24
|
+
}
|
|
25
|
+
export declare function singleLineEmailDetail(value: string): string;
|
|
26
|
+
export declare function uploadEmailDetailLines(details: UploadEmailDetails): string[];
|
|
27
|
+
export declare function toEmailAugmentedResult<T extends object & {
|
|
28
|
+
length?: never;
|
|
29
|
+
}>(base: T, emailResult: EmailDeliveryResult | undefined): {
|
|
30
|
+
content: {
|
|
31
|
+
type: "text";
|
|
32
|
+
text: string;
|
|
33
|
+
}[];
|
|
34
|
+
structuredContent: Record<string, unknown>;
|
|
35
|
+
};
|
|
36
|
+
export declare function maybeDeliverToolEmail(input: ToolEmailInput): Promise<EmailDeliveryResult | undefined>;
|
|
37
|
+
//# sourceMappingURL=email-delivery.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"email-delivery.d.ts","sourceRoot":"","sources":["../../src/tools/email-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM7D,eAAO,MAAM,wBAAwB;;;;iBAuBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,yBAAyB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAW5E;AAID,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,EAC1E,IAAI,EAAE,CAAC,EACP,WAAW,EAAE,mBAAmB,GAAG,SAAS;;;;;;EAO7C;AAiCD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CA2C1C"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { normalizedEmailAddressSchema, uniqueRecipients } from "../email-addresses.js";
|
|
3
|
+
import { EmailDeliverySetupError, MAX_EMAIL_SUBJECT_CHARACTERS, MAX_EMAIL_TEXT_CHARACTERS, } from "../email-types.js";
|
|
4
|
+
import { formatErrorForLog } from "../logging.js";
|
|
5
|
+
import { sendEmailMessage } from "../services/email.js";
|
|
6
|
+
import { flattenControlCharacters } from "../text.js";
|
|
7
|
+
import { toStructuredContent } from "./_shared.js";
|
|
8
|
+
export const emailDeliveryInputSchema = z.object({
|
|
9
|
+
to: z
|
|
10
|
+
.array(normalizedEmailAddressSchema)
|
|
11
|
+
.min(1)
|
|
12
|
+
.max(100)
|
|
13
|
+
.describe("One or more recipient email addresses. The server's SMTP recipient policy may enforce a lower limit."),
|
|
14
|
+
subject: z
|
|
15
|
+
.string()
|
|
16
|
+
.max(MAX_EMAIL_SUBJECT_CHARACTERS)
|
|
17
|
+
.refine((subject) => !/[\r\n]/.test(subject), "Subject must be a single line.")
|
|
18
|
+
.optional()
|
|
19
|
+
.describe("Optional single-line email subject. Defaults to a tool-specific subject when omitted."),
|
|
20
|
+
message: z
|
|
21
|
+
.string()
|
|
22
|
+
.max(5000)
|
|
23
|
+
.optional()
|
|
24
|
+
.describe(`Optional plain-text message to prepend above generated qURL details. The final assembled email is limited to ${MAX_EMAIL_TEXT_CHARACTERS.toLocaleString("en-US")} characters.`),
|
|
25
|
+
});
|
|
26
|
+
export function singleLineEmailDetail(value) {
|
|
27
|
+
return flattenControlCharacters(value);
|
|
28
|
+
}
|
|
29
|
+
export function uploadEmailDetailLines(details) {
|
|
30
|
+
return [
|
|
31
|
+
details.intro,
|
|
32
|
+
`File Name: ${singleLineEmailDetail(details.fileName)}`,
|
|
33
|
+
`Content Type: ${singleLineEmailDetail(details.contentType)}`,
|
|
34
|
+
`Secure Link: ${singleLineEmailDetail(details.qurlLink)}`,
|
|
35
|
+
...(details.expiresAt ? [`Expires At: ${singleLineEmailDetail(details.expiresAt)}`] : []),
|
|
36
|
+
...(details.qurlSite ? [`qURL Site: ${singleLineEmailDetail(details.qurlSite)}`] : []),
|
|
37
|
+
...(details.label ? [`Label: ${singleLineEmailDetail(details.label)}`] : []),
|
|
38
|
+
...(details.extraLines ?? []),
|
|
39
|
+
];
|
|
40
|
+
}
|
|
41
|
+
// Match toStructuredContent's plain-object boundary; `length?: never` keeps
|
|
42
|
+
// arrays from being silently spread into numeric object keys.
|
|
43
|
+
export function toEmailAugmentedResult(base, emailResult) {
|
|
44
|
+
const payload = emailResult ? { ...base, email_delivery: emailResult } : base;
|
|
45
|
+
return {
|
|
46
|
+
content: [{ type: "text", text: JSON.stringify(payload) }],
|
|
47
|
+
structuredContent: toStructuredContent(payload),
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
function getSanitizedDeliveryFailureReason(error) {
|
|
51
|
+
if (error instanceof EmailDeliverySetupError) {
|
|
52
|
+
switch (error.kind) {
|
|
53
|
+
case "authorization":
|
|
54
|
+
return "Email delivery authorization context was unavailable.";
|
|
55
|
+
case "smtp":
|
|
56
|
+
return "Email delivery was not attempted because SMTP configuration or connection failed.";
|
|
57
|
+
case "input":
|
|
58
|
+
return "Email delivery was not attempted because recipient or message validation failed.";
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
return "Email delivery was not attempted because delivery setup failed.";
|
|
62
|
+
}
|
|
63
|
+
function skippedDeliveryResult(recipients, skippedReason) {
|
|
64
|
+
return {
|
|
65
|
+
attempted: false,
|
|
66
|
+
enabled: true,
|
|
67
|
+
recipients,
|
|
68
|
+
sent: 0,
|
|
69
|
+
failed: recipients.length,
|
|
70
|
+
results: recipients.map((email) => ({
|
|
71
|
+
email,
|
|
72
|
+
success: false,
|
|
73
|
+
skipped: true,
|
|
74
|
+
error: skippedReason,
|
|
75
|
+
})),
|
|
76
|
+
skipped_reason: skippedReason,
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
export async function maybeDeliverToolEmail(input) {
|
|
80
|
+
if (!input.delivery)
|
|
81
|
+
return undefined;
|
|
82
|
+
const subject = flattenControlCharacters(input.delivery.subject?.trim() || input.defaultSubject.trim());
|
|
83
|
+
// Preserve formatting in the caller-authored message because it is sent only
|
|
84
|
+
// as the plain-text body. Generated detail fields are flattened separately
|
|
85
|
+
// so an untrusted value cannot visually create another structured detail row.
|
|
86
|
+
const sections = [
|
|
87
|
+
input.delivery.message?.trim(),
|
|
88
|
+
input.detailLines.join("\n"),
|
|
89
|
+
"Sent by qURL.",
|
|
90
|
+
].filter((section) => typeof section === "string" && section.length > 0);
|
|
91
|
+
const text = sections.join("\n\n");
|
|
92
|
+
const recipients = uniqueRecipients(input.delivery.to);
|
|
93
|
+
// Fail with a structured skipped result here for tool callers. The service
|
|
94
|
+
// repeats this boundary check because it is also exported for direct use.
|
|
95
|
+
// Match Zod's UTF-16-unit maxLength semantics for caller-provided sections.
|
|
96
|
+
if (text.length > MAX_EMAIL_TEXT_CHARACTERS) {
|
|
97
|
+
return skippedDeliveryResult(recipients, `Email delivery was not attempted because the assembled message exceeds ${MAX_EMAIL_TEXT_CHARACTERS.toLocaleString("en-US")} characters.`);
|
|
98
|
+
}
|
|
99
|
+
try {
|
|
100
|
+
return await sendEmailMessage({
|
|
101
|
+
to: recipients,
|
|
102
|
+
subject,
|
|
103
|
+
text,
|
|
104
|
+
}, { allowServerApiKeyFallback: input.allowServerApiKeyFallback });
|
|
105
|
+
}
|
|
106
|
+
catch (error) {
|
|
107
|
+
// Link creation has already succeeded when this helper runs. Never turn a
|
|
108
|
+
// delivery failure into a failed tool call because qurl_link is one-shot
|
|
109
|
+
// output that cannot be recovered later.
|
|
110
|
+
console.error(`Email delivery failed after qURL creation (${formatErrorForLog(error)})`);
|
|
111
|
+
const skippedReason = getSanitizedDeliveryFailureReason(error);
|
|
112
|
+
return skippedDeliveryResult(recipients, skippedReason);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=email-delivery.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"email-delivery.js","sourceRoot":"","sources":["../../src/tools/email-delivery.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,221 +1,68 @@
|
|
|
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 extendQurlSchema: z.ZodObject<{
|
|
4
5
|
resource_id: z.ZodString;
|
|
5
6
|
extend_by: z.ZodString;
|
|
6
|
-
},
|
|
7
|
-
|
|
8
|
-
extend_by: string;
|
|
9
|
-
}, {
|
|
10
|
-
resource_id: string;
|
|
11
|
-
extend_by: string;
|
|
12
|
-
}>;
|
|
13
|
-
export declare function extendQurlTool(client: IQURLClient): {
|
|
7
|
+
}, z.core.$strip>;
|
|
8
|
+
export declare function extendQurlTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
|
|
14
9
|
name: string;
|
|
15
10
|
title: string;
|
|
16
11
|
description: string;
|
|
17
12
|
inputSchema: z.ZodObject<{
|
|
18
13
|
resource_id: z.ZodString;
|
|
19
14
|
extend_by: z.ZodString;
|
|
20
|
-
},
|
|
21
|
-
resource_id: string;
|
|
22
|
-
extend_by: string;
|
|
23
|
-
}, {
|
|
24
|
-
resource_id: string;
|
|
25
|
-
extend_by: string;
|
|
26
|
-
}>;
|
|
15
|
+
}, z.core.$strip>;
|
|
27
16
|
outputSchema: z.ZodObject<{
|
|
28
17
|
resource_id: z.ZodString;
|
|
29
18
|
qurl_site: z.ZodOptional<z.ZodString>;
|
|
30
|
-
target_url: z.ZodString
|
|
19
|
+
target_url: z.ZodOptional<z.ZodString>;
|
|
31
20
|
description: z.ZodOptional<z.ZodString>;
|
|
32
|
-
tags: z.ZodOptional<z.ZodArray<z.ZodString
|
|
21
|
+
tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
33
22
|
expires_at: z.ZodString;
|
|
34
23
|
created_at: z.ZodString;
|
|
35
|
-
status: z.ZodEnum<
|
|
24
|
+
status: z.ZodCatch<z.ZodEnum<{
|
|
25
|
+
active: "active";
|
|
26
|
+
expired: "expired";
|
|
27
|
+
revoked: "revoked";
|
|
28
|
+
unknown: "unknown";
|
|
29
|
+
}>>;
|
|
36
30
|
custom_domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
31
|
+
slug: z.ZodOptional<z.ZodString>;
|
|
37
32
|
preserve_host: z.ZodOptional<z.ZodBoolean>;
|
|
38
33
|
qurl_count: z.ZodOptional<z.ZodNumber>;
|
|
39
34
|
qurls: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
40
35
|
qurl_id: z.ZodString;
|
|
41
36
|
label: z.ZodOptional<z.ZodString>;
|
|
42
|
-
status: z.ZodEnum<
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
37
|
+
status: z.ZodCatch<z.ZodEnum<{
|
|
38
|
+
active: "active";
|
|
39
|
+
consumed: "consumed";
|
|
40
|
+
expired: "expired";
|
|
41
|
+
revoked: "revoked";
|
|
42
|
+
unknown: "unknown";
|
|
43
|
+
}>>;
|
|
44
|
+
one_time_use: z.ZodOptional<z.ZodBoolean>;
|
|
45
|
+
max_sessions: z.ZodOptional<z.ZodNumber>;
|
|
46
|
+
session_duration: z.ZodOptional<z.ZodNumber>;
|
|
47
|
+
use_count: z.ZodOptional<z.ZodNumber>;
|
|
47
48
|
qurl_site: z.ZodOptional<z.ZodString>;
|
|
48
49
|
access_policy: z.ZodOptional<z.ZodObject<{
|
|
49
|
-
ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString
|
|
50
|
-
ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString
|
|
51
|
-
geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString
|
|
52
|
-
geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString
|
|
50
|
+
ip_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
51
|
+
ip_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
52
|
+
geo_allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
53
|
+
geo_denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
53
54
|
user_agent_allow_regex: z.ZodOptional<z.ZodString>;
|
|
54
55
|
user_agent_deny_regex: z.ZodOptional<z.ZodString>;
|
|
55
56
|
ai_agent_policy: z.ZodOptional<z.ZodObject<{
|
|
56
57
|
block_all: z.ZodOptional<z.ZodBoolean>;
|
|
57
|
-
deny_categories: z.ZodOptional<z.ZodArray<z.ZodString
|
|
58
|
-
allow_categories: z.ZodOptional<z.ZodArray<z.ZodString
|
|
59
|
-
},
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
deny_categories?: string[] | undefined;
|
|
66
|
-
allow_categories?: string[] | undefined;
|
|
67
|
-
}>>;
|
|
68
|
-
}, "strip", z.ZodTypeAny, {
|
|
69
|
-
ip_allowlist?: string[] | undefined;
|
|
70
|
-
ip_denylist?: string[] | undefined;
|
|
71
|
-
geo_allowlist?: string[] | undefined;
|
|
72
|
-
geo_denylist?: string[] | undefined;
|
|
73
|
-
user_agent_allow_regex?: string | undefined;
|
|
74
|
-
user_agent_deny_regex?: string | undefined;
|
|
75
|
-
ai_agent_policy?: {
|
|
76
|
-
block_all?: boolean | undefined;
|
|
77
|
-
deny_categories?: string[] | undefined;
|
|
78
|
-
allow_categories?: string[] | undefined;
|
|
79
|
-
} | undefined;
|
|
80
|
-
}, {
|
|
81
|
-
ip_allowlist?: string[] | undefined;
|
|
82
|
-
ip_denylist?: string[] | undefined;
|
|
83
|
-
geo_allowlist?: string[] | undefined;
|
|
84
|
-
geo_denylist?: string[] | undefined;
|
|
85
|
-
user_agent_allow_regex?: string | undefined;
|
|
86
|
-
user_agent_deny_regex?: string | undefined;
|
|
87
|
-
ai_agent_policy?: {
|
|
88
|
-
block_all?: boolean | undefined;
|
|
89
|
-
deny_categories?: string[] | undefined;
|
|
90
|
-
allow_categories?: string[] | undefined;
|
|
91
|
-
} | undefined;
|
|
92
|
-
}>>;
|
|
93
|
-
created_at: z.ZodString;
|
|
94
|
-
expires_at: z.ZodString;
|
|
95
|
-
}, "strip", z.ZodTypeAny, {
|
|
96
|
-
status: "active" | "consumed" | "expired" | "revoked";
|
|
97
|
-
qurl_id: string;
|
|
98
|
-
one_time_use: boolean;
|
|
99
|
-
max_sessions: number;
|
|
100
|
-
session_duration: number;
|
|
101
|
-
use_count: number;
|
|
102
|
-
created_at: string;
|
|
103
|
-
expires_at: string;
|
|
104
|
-
label?: string | undefined;
|
|
105
|
-
qurl_site?: string | undefined;
|
|
106
|
-
access_policy?: {
|
|
107
|
-
ip_allowlist?: string[] | undefined;
|
|
108
|
-
ip_denylist?: string[] | undefined;
|
|
109
|
-
geo_allowlist?: string[] | undefined;
|
|
110
|
-
geo_denylist?: string[] | undefined;
|
|
111
|
-
user_agent_allow_regex?: string | undefined;
|
|
112
|
-
user_agent_deny_regex?: string | undefined;
|
|
113
|
-
ai_agent_policy?: {
|
|
114
|
-
block_all?: boolean | undefined;
|
|
115
|
-
deny_categories?: string[] | undefined;
|
|
116
|
-
allow_categories?: string[] | undefined;
|
|
117
|
-
} | undefined;
|
|
118
|
-
} | undefined;
|
|
119
|
-
}, {
|
|
120
|
-
status: "active" | "consumed" | "expired" | "revoked";
|
|
121
|
-
qurl_id: string;
|
|
122
|
-
one_time_use: boolean;
|
|
123
|
-
max_sessions: number;
|
|
124
|
-
session_duration: number;
|
|
125
|
-
use_count: number;
|
|
126
|
-
created_at: string;
|
|
127
|
-
expires_at: string;
|
|
128
|
-
label?: string | undefined;
|
|
129
|
-
qurl_site?: string | undefined;
|
|
130
|
-
access_policy?: {
|
|
131
|
-
ip_allowlist?: string[] | undefined;
|
|
132
|
-
ip_denylist?: string[] | undefined;
|
|
133
|
-
geo_allowlist?: string[] | undefined;
|
|
134
|
-
geo_denylist?: string[] | undefined;
|
|
135
|
-
user_agent_allow_regex?: string | undefined;
|
|
136
|
-
user_agent_deny_regex?: string | undefined;
|
|
137
|
-
ai_agent_policy?: {
|
|
138
|
-
block_all?: boolean | undefined;
|
|
139
|
-
deny_categories?: string[] | undefined;
|
|
140
|
-
allow_categories?: string[] | undefined;
|
|
141
|
-
} | undefined;
|
|
142
|
-
} | undefined;
|
|
143
|
-
}>, "many">>;
|
|
144
|
-
}, "strip", z.ZodTypeAny, {
|
|
145
|
-
status: "active" | "revoked";
|
|
146
|
-
created_at: string;
|
|
147
|
-
expires_at: string;
|
|
148
|
-
resource_id: string;
|
|
149
|
-
target_url: string;
|
|
150
|
-
qurl_site?: string | undefined;
|
|
151
|
-
description?: string | undefined;
|
|
152
|
-
tags?: string[] | undefined;
|
|
153
|
-
custom_domain?: string | null | undefined;
|
|
154
|
-
preserve_host?: boolean | undefined;
|
|
155
|
-
qurl_count?: number | undefined;
|
|
156
|
-
qurls?: {
|
|
157
|
-
status: "active" | "consumed" | "expired" | "revoked";
|
|
158
|
-
qurl_id: string;
|
|
159
|
-
one_time_use: boolean;
|
|
160
|
-
max_sessions: number;
|
|
161
|
-
session_duration: number;
|
|
162
|
-
use_count: number;
|
|
163
|
-
created_at: string;
|
|
164
|
-
expires_at: string;
|
|
165
|
-
label?: string | undefined;
|
|
166
|
-
qurl_site?: string | undefined;
|
|
167
|
-
access_policy?: {
|
|
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
|
-
} | undefined;
|
|
180
|
-
}[] | undefined;
|
|
181
|
-
}, {
|
|
182
|
-
status: "active" | "revoked";
|
|
183
|
-
created_at: string;
|
|
184
|
-
expires_at: string;
|
|
185
|
-
resource_id: string;
|
|
186
|
-
target_url: string;
|
|
187
|
-
qurl_site?: string | undefined;
|
|
188
|
-
description?: string | undefined;
|
|
189
|
-
tags?: string[] | undefined;
|
|
190
|
-
custom_domain?: string | null | undefined;
|
|
191
|
-
preserve_host?: boolean | undefined;
|
|
192
|
-
qurl_count?: number | undefined;
|
|
193
|
-
qurls?: {
|
|
194
|
-
status: "active" | "consumed" | "expired" | "revoked";
|
|
195
|
-
qurl_id: string;
|
|
196
|
-
one_time_use: boolean;
|
|
197
|
-
max_sessions: number;
|
|
198
|
-
session_duration: number;
|
|
199
|
-
use_count: number;
|
|
200
|
-
created_at: string;
|
|
201
|
-
expires_at: string;
|
|
202
|
-
label?: string | undefined;
|
|
203
|
-
qurl_site?: string | undefined;
|
|
204
|
-
access_policy?: {
|
|
205
|
-
ip_allowlist?: string[] | undefined;
|
|
206
|
-
ip_denylist?: string[] | undefined;
|
|
207
|
-
geo_allowlist?: string[] | undefined;
|
|
208
|
-
geo_denylist?: string[] | undefined;
|
|
209
|
-
user_agent_allow_regex?: string | undefined;
|
|
210
|
-
user_agent_deny_regex?: string | undefined;
|
|
211
|
-
ai_agent_policy?: {
|
|
212
|
-
block_all?: boolean | undefined;
|
|
213
|
-
deny_categories?: string[] | undefined;
|
|
214
|
-
allow_categories?: string[] | undefined;
|
|
215
|
-
} | undefined;
|
|
216
|
-
} | undefined;
|
|
217
|
-
}[] | undefined;
|
|
218
|
-
}>;
|
|
58
|
+
deny_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
59
|
+
allow_categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
60
|
+
}, z.core.$loose>>;
|
|
61
|
+
}, z.core.$loose>>;
|
|
62
|
+
created_at: z.ZodOptional<z.ZodString>;
|
|
63
|
+
expires_at: z.ZodOptional<z.ZodString>;
|
|
64
|
+
}, z.core.$loose>>>;
|
|
65
|
+
}, z.core.$loose>;
|
|
219
66
|
annotations: {
|
|
220
67
|
title: string;
|
|
221
68
|
readOnlyHint: boolean;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extend-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"extend-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/extend-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,gBAAgB;;;iBAG3B,CAAC;AAEH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCjD"}
|
|
@@ -1,11 +1,11 @@
|
|
|
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 { extendQurlOutputSchema } from "./output-schemas.js";
|
|
4
4
|
export const extendQurlSchema = z.object({
|
|
5
5
|
resource_id: resourceIdSchema("extend"),
|
|
6
6
|
extend_by: z.string().min(1).describe('Duration to extend by (e.g., "24h", "7d")'),
|
|
7
7
|
});
|
|
8
|
-
export function extendQurlTool(client) {
|
|
8
|
+
export function extendQurlTool(client, _runtime = { mode: "stdio" }) {
|
|
9
9
|
return {
|
|
10
10
|
name: "extend_qurl",
|
|
11
11
|
title: "Extend qURL Expiration",
|
|
@@ -14,7 +14,7 @@ export function extendQurlTool(client) {
|
|
|
14
14
|
"Use this when the only change you need is more time on the clock. " +
|
|
15
15
|
"Use `update_qurl` instead when you also need to change tags, description, or set an absolute `expires_at`. " +
|
|
16
16
|
"Use `delete_qurl` when you want to cut off access entirely. " +
|
|
17
|
-
"Accepts
|
|
17
|
+
"Accepts resource public keys, CRIDs, legacy `r_` IDs, and `q_` display IDs (q_ is auto-resolved to its parent resource). " +
|
|
18
18
|
"**Not idempotent:** calling twice with the same `extend_by` extends the expiration twice. If you need an absolute target, use `update_qurl` with `expires_at` so retries on transient errors don't double-push. " +
|
|
19
19
|
"Returns the updated resource with the new `expires_at` (same shape as `get_qurl`).",
|
|
20
20
|
inputSchema: extendQurlSchema,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extend-qurl.js","sourceRoot":"","sources":["../../src/tools/extend-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,
|
|
1
|
+
{"version":3,"file":"extend-qurl.js","sourceRoot":"","sources":["../../src/tools/extend-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,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACnF,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,WAA+B,EAAE,IAAI,EAAE,OAAO,EAAE;IAEhD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,oEAAoE;YACpE,4GAA4G;YAC5G,oEAAoE;YACpE,6GAA6G;YAC7G,8DAA8D;YAC9D,2HAA2H;YAC3H,kNAAkN;YAClN,oFAAoF;QACtF,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE;YACX,KAAK,EAAE,wBAAwB;YAC/B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,wBAAwB,CAAC,KAAK,EAAE,KAAuC,EAAE,EAAE;YAClF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE;gBACxD,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,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"}
|