@layervai/qurl-mcp 0.5.0 → 0.7.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 +209 -48
- package/dist/client.d.ts +65 -10
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +103 -5
- package/dist/client.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -3
- package/dist/index.js.map +1 -1
- package/dist/prompts/audit-links.js +1 -1
- package/dist/prompts/audit-links.js.map +1 -1
- package/dist/qurl-cli.d.ts +96 -0
- package/dist/qurl-cli.d.ts.map +1 -0
- package/dist/qurl-cli.js +331 -0
- package/dist/qurl-cli.js.map +1 -0
- package/dist/server.d.ts +14 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +39 -0
- package/dist/server.js.map +1 -1
- package/dist/tools/_shared.d.ts +1 -0
- package/dist/tools/_shared.d.ts.map +1 -1
- package/dist/tools/_shared.js +6 -1
- package/dist/tools/_shared.js.map +1 -1
- package/dist/tools/consumer-access.d.ts +235 -0
- package/dist/tools/consumer-access.d.ts.map +1 -0
- package/dist/tools/consumer-access.js +231 -0
- package/dist/tools/consumer-access.js.map +1 -0
- package/dist/tools/create-qurl.d.ts.map +1 -1
- package/dist/tools/create-qurl.js +6 -2
- package/dist/tools/create-qurl.js.map +1 -1
- package/dist/tools/delete-qurl.d.ts.map +1 -1
- package/dist/tools/delete-qurl.js +6 -3
- package/dist/tools/delete-qurl.js.map +1 -1
- package/dist/tools/duration.d.ts +13 -0
- package/dist/tools/duration.d.ts.map +1 -0
- package/dist/tools/duration.js +71 -0
- package/dist/tools/duration.js.map +1 -0
- package/dist/tools/email-delivery.d.ts +0 -1
- package/dist/tools/email-delivery.d.ts.map +1 -1
- package/dist/tools/email-delivery.js +0 -1
- package/dist/tools/email-delivery.js.map +1 -1
- package/dist/tools/extend-qurl.d.ts +14 -1
- package/dist/tools/extend-qurl.d.ts.map +1 -1
- package/dist/tools/extend-qurl.js +179 -18
- package/dist/tools/extend-qurl.js.map +1 -1
- package/dist/tools/get-qurl.d.ts +7 -0
- package/dist/tools/get-qurl.d.ts.map +1 -1
- package/dist/tools/list-qurls.d.ts +7 -0
- package/dist/tools/list-qurls.d.ts.map +1 -1
- package/dist/tools/local-cli.d.ts +44 -0
- package/dist/tools/local-cli.d.ts.map +1 -0
- package/dist/tools/local-cli.js +855 -0
- package/dist/tools/local-cli.js.map +1 -0
- package/dist/tools/mint-link.d.ts.map +1 -1
- package/dist/tools/mint-link.js +2 -1
- package/dist/tools/mint-link.js.map +1 -1
- package/dist/tools/output-schemas.d.ts +56 -4
- package/dist/tools/output-schemas.d.ts.map +1 -1
- package/dist/tools/output-schemas.js +62 -11
- package/dist/tools/output-schemas.js.map +1 -1
- package/dist/tools/share-by-crid.d.ts +52 -0
- package/dist/tools/share-by-crid.d.ts.map +1 -0
- package/dist/tools/share-by-crid.js +114 -0
- package/dist/tools/share-by-crid.js.map +1 -0
- package/dist/tools/update-qurl-token.d.ts.map +1 -1
- package/dist/tools/update-qurl-token.js +6 -7
- package/dist/tools/update-qurl-token.js.map +1 -1
- package/dist/tools/update-qurl.d.ts +7 -0
- package/dist/tools/update-qurl.d.ts.map +1 -1
- package/dist/tools/update-qurl.js +6 -7
- package/dist/tools/update-qurl.js.map +1 -1
- package/dist/tools/upload-file-data-qurl.d.ts +17 -61
- package/dist/tools/upload-file-data-qurl.d.ts.map +1 -1
- package/dist/tools/upload-file-data-qurl.js +16 -9
- package/dist/tools/upload-file-data-qurl.js.map +1 -1
- package/dist/tools/upload-file-qurl.d.ts +27 -55
- package/dist/tools/upload-file-qurl.d.ts.map +1 -1
- package/dist/tools/upload-file-qurl.js +19 -12
- package/dist/tools/upload-file-qurl.js.map +1 -1
- package/dist/tools/upload-file-shared.d.ts +27 -10
- package/dist/tools/upload-file-shared.d.ts.map +1 -1
- package/dist/tools/upload-file-shared.js +313 -43
- package/dist/tools/upload-file-shared.js.map +1 -1
- package/dist/tools/upload-mint-options.d.ts +14 -14
- package/dist/tools/upload-mint-options.d.ts.map +1 -1
- package/dist/tools/upload-mint-options.js +33 -15
- package/dist/tools/upload-mint-options.js.map +1 -1
- package/dist/tools/upload-text-qurl.d.ts +15 -47
- package/dist/tools/upload-text-qurl.d.ts.map +1 -1
- package/dist/tools/upload-text-qurl.js +11 -7
- package/dist/tools/upload-text-qurl.js.map +1 -1
- package/package.json +7 -7
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { type IQURLClient } from "../client.js";
|
|
3
|
+
import { type ToolRuntimeOptions } from "./_shared.js";
|
|
4
|
+
export declare function publishCridTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
|
|
5
|
+
name: string;
|
|
6
|
+
title: string;
|
|
7
|
+
description: string;
|
|
8
|
+
inputSchema: z.ZodObject<{
|
|
9
|
+
target_url: z.ZodString;
|
|
10
|
+
policy: z.ZodObject<{
|
|
11
|
+
mode: z.ZodEnum<{
|
|
12
|
+
keys: "keys";
|
|
13
|
+
contract: "contract";
|
|
14
|
+
invite_only: "invite_only";
|
|
15
|
+
email_capture: "email_capture";
|
|
16
|
+
review: "review";
|
|
17
|
+
}>;
|
|
18
|
+
version: z.ZodNumber;
|
|
19
|
+
contract_id: z.ZodOptional<z.ZodString>;
|
|
20
|
+
}, z.core.$strict>;
|
|
21
|
+
}, z.core.$strict>;
|
|
22
|
+
outputSchema: z.ZodObject<{
|
|
23
|
+
resource_id: z.ZodString;
|
|
24
|
+
crid: z.ZodString;
|
|
25
|
+
private: z.ZodLiteral<true>;
|
|
26
|
+
consumer_access: z.ZodObject<{
|
|
27
|
+
mode: z.ZodEnum<{
|
|
28
|
+
keys: "keys";
|
|
29
|
+
contract: "contract";
|
|
30
|
+
invite_only: "invite_only";
|
|
31
|
+
email_capture: "email_capture";
|
|
32
|
+
review: "review";
|
|
33
|
+
}>;
|
|
34
|
+
version: z.ZodNumber;
|
|
35
|
+
contract_id: z.ZodOptional<z.ZodString>;
|
|
36
|
+
}, z.core.$strip>;
|
|
37
|
+
}, z.core.$strip>;
|
|
38
|
+
annotations: {
|
|
39
|
+
title: string;
|
|
40
|
+
readOnlyHint: boolean;
|
|
41
|
+
destructiveHint: boolean;
|
|
42
|
+
idempotentHint: boolean;
|
|
43
|
+
openWorldHint: boolean;
|
|
44
|
+
};
|
|
45
|
+
handler: (input: {
|
|
46
|
+
target_url: string;
|
|
47
|
+
policy: {
|
|
48
|
+
mode: "keys" | "contract" | "invite_only" | "email_capture" | "review";
|
|
49
|
+
version: number;
|
|
50
|
+
contract_id?: string | undefined;
|
|
51
|
+
};
|
|
52
|
+
}) => Promise<{
|
|
53
|
+
content: Array<{
|
|
54
|
+
type: "text";
|
|
55
|
+
text: string;
|
|
56
|
+
}>;
|
|
57
|
+
structuredContent?: Record<string, unknown>;
|
|
58
|
+
isError?: boolean;
|
|
59
|
+
}>;
|
|
60
|
+
};
|
|
61
|
+
export declare function manageCridAccessTool(client: IQURLClient, _runtime?: ToolRuntimeOptions): {
|
|
62
|
+
name: string;
|
|
63
|
+
title: string;
|
|
64
|
+
description: string;
|
|
65
|
+
inputSchema: z.ZodObject<{
|
|
66
|
+
action: z.ZodEnum<{
|
|
67
|
+
configure: "configure";
|
|
68
|
+
invite: "invite";
|
|
69
|
+
list_invitations: "list_invitations";
|
|
70
|
+
resend: "resend";
|
|
71
|
+
revoke_invitation: "revoke_invitation";
|
|
72
|
+
list_grants: "list_grants";
|
|
73
|
+
approve: "approve";
|
|
74
|
+
deny: "deny";
|
|
75
|
+
revoke_grant: "revoke_grant";
|
|
76
|
+
}>;
|
|
77
|
+
resource_id: z.ZodString;
|
|
78
|
+
policy: z.ZodOptional<z.ZodObject<{
|
|
79
|
+
mode: z.ZodEnum<{
|
|
80
|
+
keys: "keys";
|
|
81
|
+
contract: "contract";
|
|
82
|
+
invite_only: "invite_only";
|
|
83
|
+
email_capture: "email_capture";
|
|
84
|
+
review: "review";
|
|
85
|
+
}>;
|
|
86
|
+
version: z.ZodNumber;
|
|
87
|
+
contract_id: z.ZodOptional<z.ZodString>;
|
|
88
|
+
}, z.core.$strict>>;
|
|
89
|
+
email: z.ZodOptional<z.ZodString>;
|
|
90
|
+
id: z.ZodOptional<z.ZodString>;
|
|
91
|
+
expected_version: z.ZodOptional<z.ZodNumber>;
|
|
92
|
+
approval: z.ZodOptional<z.ZodObject<{
|
|
93
|
+
expected_version: z.ZodNumber;
|
|
94
|
+
credential_kind: z.ZodOptional<z.ZodEnum<{
|
|
95
|
+
passkey: "passkey";
|
|
96
|
+
device: "device";
|
|
97
|
+
}>>;
|
|
98
|
+
credential_id: z.ZodOptional<z.ZodString>;
|
|
99
|
+
credential_public_key_b64: z.ZodOptional<z.ZodString>;
|
|
100
|
+
entitlement_id: z.ZodOptional<z.ZodString>;
|
|
101
|
+
expires_at: z.ZodOptional<z.ZodString>;
|
|
102
|
+
}, z.core.$strict>>;
|
|
103
|
+
cursor: z.ZodOptional<z.ZodString>;
|
|
104
|
+
limit: z.ZodOptional<z.ZodNumber>;
|
|
105
|
+
}, z.core.$strict>;
|
|
106
|
+
outputSchema: z.ZodObject<{
|
|
107
|
+
action: z.ZodEnum<{
|
|
108
|
+
configure: "configure";
|
|
109
|
+
invite: "invite";
|
|
110
|
+
list_invitations: "list_invitations";
|
|
111
|
+
resend: "resend";
|
|
112
|
+
revoke_invitation: "revoke_invitation";
|
|
113
|
+
list_grants: "list_grants";
|
|
114
|
+
approve: "approve";
|
|
115
|
+
deny: "deny";
|
|
116
|
+
revoke_grant: "revoke_grant";
|
|
117
|
+
}>;
|
|
118
|
+
resource: z.ZodOptional<z.ZodObject<{
|
|
119
|
+
resource_id: z.ZodString;
|
|
120
|
+
crid: z.ZodString;
|
|
121
|
+
private: z.ZodLiteral<true>;
|
|
122
|
+
consumer_access: z.ZodObject<{
|
|
123
|
+
mode: z.ZodEnum<{
|
|
124
|
+
keys: "keys";
|
|
125
|
+
contract: "contract";
|
|
126
|
+
invite_only: "invite_only";
|
|
127
|
+
email_capture: "email_capture";
|
|
128
|
+
review: "review";
|
|
129
|
+
}>;
|
|
130
|
+
version: z.ZodNumber;
|
|
131
|
+
contract_id: z.ZodOptional<z.ZodString>;
|
|
132
|
+
}, z.core.$strip>;
|
|
133
|
+
}, z.core.$strip>>;
|
|
134
|
+
invitation: z.ZodOptional<z.ZodObject<{
|
|
135
|
+
id: z.ZodString;
|
|
136
|
+
email: z.ZodString;
|
|
137
|
+
status: z.ZodString;
|
|
138
|
+
delivery: z.ZodString;
|
|
139
|
+
version: z.ZodNumber;
|
|
140
|
+
expires_at: z.ZodString;
|
|
141
|
+
session_cleanup: z.ZodOptional<z.ZodEnum<{
|
|
142
|
+
pending: "pending";
|
|
143
|
+
complete: "complete";
|
|
144
|
+
}>>;
|
|
145
|
+
}, z.core.$strip>>;
|
|
146
|
+
grant: z.ZodOptional<z.ZodObject<{
|
|
147
|
+
id: z.ZodString;
|
|
148
|
+
status: z.ZodString;
|
|
149
|
+
version: z.ZodNumber;
|
|
150
|
+
credential_kind: z.ZodOptional<z.ZodEnum<{
|
|
151
|
+
passkey: "passkey";
|
|
152
|
+
device: "device";
|
|
153
|
+
}>>;
|
|
154
|
+
credential_id: z.ZodOptional<z.ZodString>;
|
|
155
|
+
credential_public_key_b64: z.ZodOptional<z.ZodString>;
|
|
156
|
+
email: z.ZodOptional<z.ZodString>;
|
|
157
|
+
email_verified_at: z.ZodOptional<z.ZodString>;
|
|
158
|
+
entitlement_id: z.ZodOptional<z.ZodString>;
|
|
159
|
+
expires_at: z.ZodOptional<z.ZodString>;
|
|
160
|
+
session_cleanup: z.ZodOptional<z.ZodEnum<{
|
|
161
|
+
pending: "pending";
|
|
162
|
+
complete: "complete";
|
|
163
|
+
}>>;
|
|
164
|
+
}, z.core.$strip>>;
|
|
165
|
+
invitations: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
166
|
+
id: z.ZodString;
|
|
167
|
+
email: z.ZodString;
|
|
168
|
+
status: z.ZodString;
|
|
169
|
+
delivery: z.ZodString;
|
|
170
|
+
version: z.ZodNumber;
|
|
171
|
+
expires_at: z.ZodString;
|
|
172
|
+
session_cleanup: z.ZodOptional<z.ZodEnum<{
|
|
173
|
+
pending: "pending";
|
|
174
|
+
complete: "complete";
|
|
175
|
+
}>>;
|
|
176
|
+
}, z.core.$strip>>>;
|
|
177
|
+
grants: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
178
|
+
id: z.ZodString;
|
|
179
|
+
status: z.ZodString;
|
|
180
|
+
version: z.ZodNumber;
|
|
181
|
+
credential_kind: z.ZodOptional<z.ZodEnum<{
|
|
182
|
+
passkey: "passkey";
|
|
183
|
+
device: "device";
|
|
184
|
+
}>>;
|
|
185
|
+
credential_id: z.ZodOptional<z.ZodString>;
|
|
186
|
+
credential_public_key_b64: z.ZodOptional<z.ZodString>;
|
|
187
|
+
email: z.ZodOptional<z.ZodString>;
|
|
188
|
+
email_verified_at: z.ZodOptional<z.ZodString>;
|
|
189
|
+
entitlement_id: z.ZodOptional<z.ZodString>;
|
|
190
|
+
expires_at: z.ZodOptional<z.ZodString>;
|
|
191
|
+
session_cleanup: z.ZodOptional<z.ZodEnum<{
|
|
192
|
+
pending: "pending";
|
|
193
|
+
complete: "complete";
|
|
194
|
+
}>>;
|
|
195
|
+
}, z.core.$strip>>>;
|
|
196
|
+
next_cursor: z.ZodOptional<z.ZodString>;
|
|
197
|
+
}, z.core.$strict>;
|
|
198
|
+
annotations: {
|
|
199
|
+
title: string;
|
|
200
|
+
readOnlyHint: boolean;
|
|
201
|
+
destructiveHint: boolean;
|
|
202
|
+
idempotentHint: boolean;
|
|
203
|
+
openWorldHint: boolean;
|
|
204
|
+
};
|
|
205
|
+
handler: (input: {
|
|
206
|
+
action: "configure" | "invite" | "list_invitations" | "resend" | "revoke_invitation" | "list_grants" | "approve" | "deny" | "revoke_grant";
|
|
207
|
+
resource_id: string;
|
|
208
|
+
policy?: {
|
|
209
|
+
mode: "keys" | "contract" | "invite_only" | "email_capture" | "review";
|
|
210
|
+
version: number;
|
|
211
|
+
contract_id?: string | undefined;
|
|
212
|
+
} | undefined;
|
|
213
|
+
email?: string | undefined;
|
|
214
|
+
id?: string | undefined;
|
|
215
|
+
expected_version?: number | undefined;
|
|
216
|
+
approval?: {
|
|
217
|
+
expected_version: number;
|
|
218
|
+
credential_kind?: "passkey" | "device" | undefined;
|
|
219
|
+
credential_id?: string | undefined;
|
|
220
|
+
credential_public_key_b64?: string | undefined;
|
|
221
|
+
entitlement_id?: string | undefined;
|
|
222
|
+
expires_at?: string | undefined;
|
|
223
|
+
} | undefined;
|
|
224
|
+
cursor?: string | undefined;
|
|
225
|
+
limit?: number | undefined;
|
|
226
|
+
}) => Promise<{
|
|
227
|
+
content: Array<{
|
|
228
|
+
type: "text";
|
|
229
|
+
text: string;
|
|
230
|
+
}>;
|
|
231
|
+
structuredContent?: Record<string, unknown>;
|
|
232
|
+
isError?: boolean;
|
|
233
|
+
}>;
|
|
234
|
+
};
|
|
235
|
+
//# sourceMappingURL=consumer-access.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consumer-access.d.ts","sourceRoot":"","sources":["../../src/tools/consumer-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAyDtB,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BjD;AAkFD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyHjD"}
|
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { QURLAPIError } from "../client.js";
|
|
3
|
+
import { resourceOnlyIdSchema, toStructuredContent, withMissingApiKeyHandler, zodErrorToToolResult, } from "./_shared.js";
|
|
4
|
+
const version = z.number().int().min(1).max(Number.MAX_SAFE_INTEGER);
|
|
5
|
+
const initialVersion = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
|
|
6
|
+
const policy = z
|
|
7
|
+
.object({
|
|
8
|
+
mode: z.enum(["keys", "invite_only", "email_capture", "review", "contract"]),
|
|
9
|
+
version,
|
|
10
|
+
contract_id: z.string().trim().min(1).max(128).optional(),
|
|
11
|
+
})
|
|
12
|
+
.strict();
|
|
13
|
+
const validPolicy = policy.refine((p) => (p.mode === "contract") === (p.contract_id !== undefined), "Only contract access requires a contract identifier");
|
|
14
|
+
const resource = z.object({
|
|
15
|
+
resource_id: z.string(),
|
|
16
|
+
crid: z.string(),
|
|
17
|
+
private: z.literal(true),
|
|
18
|
+
consumer_access: policy.strip(),
|
|
19
|
+
});
|
|
20
|
+
const invitation = z.object({
|
|
21
|
+
id: z.string(),
|
|
22
|
+
email: z.string(),
|
|
23
|
+
status: z.string().min(1).max(64),
|
|
24
|
+
delivery: z.string().min(1).max(64),
|
|
25
|
+
version,
|
|
26
|
+
expires_at: z.string(),
|
|
27
|
+
session_cleanup: z.enum(["pending", "complete"]).optional(),
|
|
28
|
+
});
|
|
29
|
+
const grant = z.object({
|
|
30
|
+
id: z.string(),
|
|
31
|
+
status: z.string().min(1).max(64),
|
|
32
|
+
version,
|
|
33
|
+
credential_kind: z.enum(["passkey", "device"]).optional(),
|
|
34
|
+
credential_id: z.string().optional(),
|
|
35
|
+
credential_public_key_b64: z.string().optional(),
|
|
36
|
+
email: z.string().optional(),
|
|
37
|
+
email_verified_at: z.string().optional(),
|
|
38
|
+
entitlement_id: z.string().optional(),
|
|
39
|
+
expires_at: z.string().optional(),
|
|
40
|
+
session_cleanup: z.enum(["pending", "complete"]).optional(),
|
|
41
|
+
});
|
|
42
|
+
const publishInput = z.object({ target_url: z.string().url(), policy: validPolicy }).strict();
|
|
43
|
+
function receipt(schema, value, resourceId) {
|
|
44
|
+
const parsed = schema.safeParse(value);
|
|
45
|
+
if (!parsed.success) {
|
|
46
|
+
throw new QURLAPIError(0, "access_receipt_unconfirmed", `The service returned an unrecognized access receipt. A write may have been applied; read resource ${resourceId} and list its access before retrying.`);
|
|
47
|
+
}
|
|
48
|
+
return parsed.data;
|
|
49
|
+
}
|
|
50
|
+
export function publishCridTool(client, _runtime = { mode: "stdio" }) {
|
|
51
|
+
return {
|
|
52
|
+
name: "publish_crid",
|
|
53
|
+
title: "Publish a private CRID",
|
|
54
|
+
description: "Publish a URL with private access. Choose keys for approved credentials, invite_only for publisher email invitations with no access requests, email_capture for verified email capture with consent, review for verified email requests, or contract for a publisher backend entitlement receipt. This tool does not verify payment. Use version 1 for creation. Repeating this call creates another resource; after an uncertain result use get_qurl or list_qurls before retrying. For local apps use the qURL CLI. Public sharing uses create_qurl.",
|
|
55
|
+
inputSchema: publishInput,
|
|
56
|
+
outputSchema: resource,
|
|
57
|
+
annotations: {
|
|
58
|
+
title: "Publish a private CRID",
|
|
59
|
+
readOnlyHint: false,
|
|
60
|
+
destructiveHint: false,
|
|
61
|
+
idempotentHint: false,
|
|
62
|
+
openWorldHint: true,
|
|
63
|
+
},
|
|
64
|
+
handler: withMissingApiKeyHandler(async (raw) => {
|
|
65
|
+
const parsed = publishInput.safeParse(raw);
|
|
66
|
+
if (!parsed.success)
|
|
67
|
+
return zodErrorToToolResult(parsed.error);
|
|
68
|
+
const handle = await client.protectUrl(parsed.data.target_url, {
|
|
69
|
+
consumerAccess: parsed.data.policy,
|
|
70
|
+
});
|
|
71
|
+
const data = receipt(resource, handle.details, handle.crid);
|
|
72
|
+
return {
|
|
73
|
+
content: [{ type: "text", text: JSON.stringify(data) }],
|
|
74
|
+
structuredContent: toStructuredContent(data),
|
|
75
|
+
};
|
|
76
|
+
}),
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
const approval = z
|
|
80
|
+
.object({
|
|
81
|
+
expected_version: initialVersion,
|
|
82
|
+
credential_kind: z.enum(["passkey", "device"]).optional(),
|
|
83
|
+
credential_id: z.string().min(1).max(1024).optional(),
|
|
84
|
+
credential_public_key_b64: z.string().min(1).max(1024).optional(),
|
|
85
|
+
entitlement_id: z.string().min(1).max(256).optional(),
|
|
86
|
+
expires_at: z.string().datetime({ offset: true }).optional(),
|
|
87
|
+
})
|
|
88
|
+
.strict();
|
|
89
|
+
const base = z
|
|
90
|
+
.object({
|
|
91
|
+
action: z.enum([
|
|
92
|
+
"configure",
|
|
93
|
+
"invite",
|
|
94
|
+
"list_invitations",
|
|
95
|
+
"resend",
|
|
96
|
+
"revoke_invitation",
|
|
97
|
+
"list_grants",
|
|
98
|
+
"approve",
|
|
99
|
+
"deny",
|
|
100
|
+
"revoke_grant",
|
|
101
|
+
]),
|
|
102
|
+
resource_id: resourceOnlyIdSchema("manage access"),
|
|
103
|
+
policy: validPolicy.optional(),
|
|
104
|
+
email: z.string().email().max(320).optional(),
|
|
105
|
+
id: z.string().min(1).max(64).optional(),
|
|
106
|
+
expected_version: initialVersion.optional(),
|
|
107
|
+
approval: approval.optional(),
|
|
108
|
+
cursor: z.string().max(4096).optional(),
|
|
109
|
+
limit: z.number().int().min(1).max(100).optional(),
|
|
110
|
+
})
|
|
111
|
+
.strict();
|
|
112
|
+
const identity = z.object({ resource_id: resourceOnlyIdSchema("manage access") });
|
|
113
|
+
const decision = { id: z.string().regex(/^[a-f0-9]{64}$/), expected_version: version };
|
|
114
|
+
const page = {
|
|
115
|
+
cursor: z.string().max(4096).optional(),
|
|
116
|
+
limit: z.number().int().min(1).max(100).optional(),
|
|
117
|
+
};
|
|
118
|
+
const actions = z
|
|
119
|
+
.discriminatedUnion("action", [
|
|
120
|
+
identity
|
|
121
|
+
.extend({
|
|
122
|
+
action: z.literal("configure"),
|
|
123
|
+
policy: validPolicy,
|
|
124
|
+
expected_version: initialVersion,
|
|
125
|
+
})
|
|
126
|
+
.strict(),
|
|
127
|
+
identity.extend({ action: z.literal("invite"), email: z.string().email().max(320) }).strict(),
|
|
128
|
+
identity.extend({ action: z.literal("list_invitations"), ...page }).strict(),
|
|
129
|
+
identity.extend({ action: z.literal("list_grants"), ...page }).strict(),
|
|
130
|
+
identity.extend({ action: z.literal("resend"), ...decision }).strict(),
|
|
131
|
+
identity.extend({ action: z.literal("revoke_invitation"), ...decision }).strict(),
|
|
132
|
+
identity
|
|
133
|
+
.extend({
|
|
134
|
+
action: z.literal("approve"),
|
|
135
|
+
id: z.union([decision.id, z.literal("new")]),
|
|
136
|
+
approval,
|
|
137
|
+
})
|
|
138
|
+
.strict(),
|
|
139
|
+
identity.extend({ action: z.literal("deny"), ...decision }).strict(),
|
|
140
|
+
identity.extend({ action: z.literal("revoke_grant"), ...decision }).strict(),
|
|
141
|
+
])
|
|
142
|
+
.refine((input) => input.action !== "approve" || input.id === "new" || input.approval.expected_version >= 1, "Approval of an existing grant requires expected_version of at least 1");
|
|
143
|
+
const output = z
|
|
144
|
+
.object({
|
|
145
|
+
action: base.shape.action,
|
|
146
|
+
resource: resource.optional(),
|
|
147
|
+
invitation: invitation.optional(),
|
|
148
|
+
grant: grant.optional(),
|
|
149
|
+
invitations: z.array(invitation).optional(),
|
|
150
|
+
grants: z.array(grant).optional(),
|
|
151
|
+
next_cursor: z.string().optional(),
|
|
152
|
+
})
|
|
153
|
+
.strict();
|
|
154
|
+
export function manageCridAccessTool(client, _runtime = { mode: "stdio" }) {
|
|
155
|
+
return {
|
|
156
|
+
name: "manage_crid_access",
|
|
157
|
+
title: "Manage private CRID access",
|
|
158
|
+
description: "Publisher access control. Configure the next policy version, send or resend an email invitation, list invitations or consumer grants, approve or deny a request, approve a credential with id new, or revoke access. Read the current version before a decision; configuring the first policy on an existing private resource uses expected_version 0. For approve, put expected_version inside approval; zero is allowed only for id new. After an uncertain invite result, list invitations before retrying. Invite-only access has no consumer requests. Contract approval requires a trusted publisher entitlement receipt and expiry, not an unverified payment claim. A removal is complete only when session_cleanup is complete; retry the same removal/version while pending. Email proves mailbox control, not legal identity. Only listed fields are returned; invitation secrets and bearer links are never returned.",
|
|
159
|
+
inputSchema: base,
|
|
160
|
+
outputSchema: output,
|
|
161
|
+
annotations: {
|
|
162
|
+
title: "Manage private CRID access",
|
|
163
|
+
readOnlyHint: false,
|
|
164
|
+
destructiveHint: true,
|
|
165
|
+
idempotentHint: false,
|
|
166
|
+
openWorldHint: true,
|
|
167
|
+
},
|
|
168
|
+
handler: withMissingApiKeyHandler(async (raw) => {
|
|
169
|
+
const parsed = actions.safeParse(raw);
|
|
170
|
+
if (!parsed.success)
|
|
171
|
+
return zodErrorToToolResult(parsed.error);
|
|
172
|
+
const input = parsed.data;
|
|
173
|
+
let result = { action: input.action };
|
|
174
|
+
switch (input.action) {
|
|
175
|
+
case "configure":
|
|
176
|
+
result.resource = receipt(resource, (await client.updateResource(input.resource_id, {
|
|
177
|
+
consumer_access: input.policy,
|
|
178
|
+
expected_consumer_access_version: input.expected_version,
|
|
179
|
+
})).data, input.resource_id);
|
|
180
|
+
if (result.resource.consumer_access.mode !== input.policy.mode ||
|
|
181
|
+
result.resource.consumer_access.version !== input.policy.version ||
|
|
182
|
+
result.resource.consumer_access.contract_id !== input.policy.contract_id) {
|
|
183
|
+
throw new QURLAPIError(0, "access_receipt_unconfirmed", "The service did not confirm the private access policy; the update may have been applied. Re-read the resource before retrying.");
|
|
184
|
+
}
|
|
185
|
+
break;
|
|
186
|
+
case "invite":
|
|
187
|
+
result.invitation = receipt(invitation, await client.inviteConsumer(input.resource_id, input.email), input.resource_id);
|
|
188
|
+
break;
|
|
189
|
+
case "resend":
|
|
190
|
+
result.invitation = receipt(invitation, await client.resendConsumerInvitation(input.resource_id, input.id, input.expected_version), input.resource_id);
|
|
191
|
+
break;
|
|
192
|
+
case "revoke_invitation":
|
|
193
|
+
result.invitation = receipt(invitation, await client.revokeConsumerInvitation(input.resource_id, input.id, input.expected_version), input.resource_id);
|
|
194
|
+
break;
|
|
195
|
+
case "approve":
|
|
196
|
+
result.grant = receipt(grant, await client.approveConsumerGrant(input.resource_id, input.id, input.approval), input.resource_id);
|
|
197
|
+
break;
|
|
198
|
+
case "deny":
|
|
199
|
+
result.grant = receipt(grant, await client.denyConsumerGrant(input.resource_id, input.id, input.expected_version), input.resource_id);
|
|
200
|
+
break;
|
|
201
|
+
case "revoke_grant":
|
|
202
|
+
result.grant = receipt(grant, await client.revokeConsumerGrant(input.resource_id, input.id, input.expected_version), input.resource_id);
|
|
203
|
+
break;
|
|
204
|
+
case "list_invitations": {
|
|
205
|
+
const reply = await client.listConsumerInvitations(input.resource_id, {
|
|
206
|
+
cursor: input.cursor,
|
|
207
|
+
limit: input.limit,
|
|
208
|
+
});
|
|
209
|
+
result.invitations = receipt(z.array(invitation), reply.invitations, input.resource_id);
|
|
210
|
+
result.next_cursor = reply.next_cursor ?? undefined;
|
|
211
|
+
break;
|
|
212
|
+
}
|
|
213
|
+
case "list_grants": {
|
|
214
|
+
const reply = await client.listConsumerGrants(input.resource_id, {
|
|
215
|
+
cursor: input.cursor,
|
|
216
|
+
limit: input.limit,
|
|
217
|
+
});
|
|
218
|
+
result.grants = receipt(z.array(grant), reply.grants, input.resource_id);
|
|
219
|
+
result.next_cursor = reply.next_cursor ?? undefined;
|
|
220
|
+
break;
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
result = output.parse(result);
|
|
224
|
+
return {
|
|
225
|
+
content: [{ type: "text", text: JSON.stringify(result) }],
|
|
226
|
+
structuredContent: toStructuredContent(result),
|
|
227
|
+
};
|
|
228
|
+
}),
|
|
229
|
+
};
|
|
230
|
+
}
|
|
231
|
+
//# sourceMappingURL=consumer-access.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consumer-access.js","sourceRoot":"","sources":["../../src/tools/consumer-access.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/create-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAStB,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAI/C,eAAO,MAAM,mBAAmB;;;;iBAkB9B,CAAC;AAEH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAGnD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAgC7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"create-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/create-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAStB,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAI/C,eAAO,MAAM,mBAAmB;;;;iBAkB9B,CAAC;AAEH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAGnD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAgC7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkD3B,CAAC;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsD9E"}
|
|
@@ -54,7 +54,11 @@ export const createQurlSchema = z.object({
|
|
|
54
54
|
.max(500)
|
|
55
55
|
.optional()
|
|
56
56
|
.describe("Human-readable label identifying who this qURL is for (max 500 chars)"),
|
|
57
|
-
expires_in: z
|
|
57
|
+
expires_in: z
|
|
58
|
+
.string()
|
|
59
|
+
.min(1)
|
|
60
|
+
.optional()
|
|
61
|
+
.describe('Duration string (e.g., "1h", "24h", "7d"; the API enforces 1m to 30d)'),
|
|
58
62
|
one_time_use: z.boolean().optional().describe("Whether the link can only be used once"),
|
|
59
63
|
max_sessions: z
|
|
60
64
|
.number()
|
|
@@ -93,7 +97,7 @@ export function createQurlTool(client, runtime) {
|
|
|
93
97
|
"**Behavior:** not idempotent — calling twice produces two distinct qURL tokens, though both may share the same `resource_id` when the target URL groups to an existing same-type resource (this tool doesn't surface the underlying API's `Idempotency-Key` header). " +
|
|
94
98
|
"The returned `qurl_link` is shown ONCE in this response and is never recoverable through `get_qurl` or `list_qurls`; persist or share it immediately. " +
|
|
95
99
|
"A returned resource is in `active` status with the policy and per-token limits applied. " +
|
|
96
|
-
"
|
|
100
|
+
"Set `expires_in` explicitly for a predictable lifetime; otherwise the service uses its defaults. Read `expires_at` in the response. " +
|
|
97
101
|
"`max_sessions` is per minted qURL, not resource-wide; set `one_time_use: false` explicitly when you need `max_sessions: 0` to mean unlimited visitors. " +
|
|
98
102
|
"**Returns:** `{ qurl_id: string (q_…), resource_id: string, qurl_link: string (shown once), branded_domain?: string, qurl_site: string, expires_at: string (RFC 3339), label?: string, type?: string }`. " +
|
|
99
103
|
"`qurl_id` is the only `q_…` display ID an agent gets in this response — keep it if you plan a follow-up against `get_qurl`/`update_qurl`/`mint_link` (which accept either prefix). " +
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"create-qurl.js","sourceRoot":"","sources":["../../src/tools/create-qurl.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"create-qurl.js","sourceRoot":"","sources":["../../src/tools/create-qurl.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"delete-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/delete-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"delete-qurl.d.ts","sourceRoot":"","sources":["../../src/tools/delete-qurl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAQtB,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyEjD"}
|
|
@@ -2,6 +2,9 @@ import { z } from "zod";
|
|
|
2
2
|
import { QURLAPIError } from "../client.js";
|
|
3
3
|
import { resourceOnlyIdSchema, withMissingApiKeyHandler, } from "./_shared.js";
|
|
4
4
|
import { deleteQurlOutputSchema } from "./output-schemas.js";
|
|
5
|
+
// Upload links live on the connector's resource, so revoking this one leaves
|
|
6
|
+
// them serving (#281). Said in the result, which agents relay to the user.
|
|
7
|
+
const UPLOAD_LINKS_NOTE = "Links minted by the upload tools are served by the file connector and are not affected.";
|
|
5
8
|
export const deleteQurlSchema = z.object({
|
|
6
9
|
resource_id: resourceOnlyIdSchema("revoke (all tokens; q_ display IDs are not accepted)"),
|
|
7
10
|
});
|
|
@@ -11,8 +14,8 @@ export function deleteQurlTool(client, _runtime = { mode: "stdio" }) {
|
|
|
11
14
|
title: "Delete qURL",
|
|
12
15
|
description: "Permanently revoke a qURL — the link and every access token under it stop working immediately. " +
|
|
13
16
|
"**This action is irreversible.** Use this when you want to cut off access entirely (compromised link, departed user, end-of-engagement). " +
|
|
14
|
-
"
|
|
15
|
-
"Use `
|
|
17
|
+
"It does not revoke links minted by the upload tools, which belong to the file connector; those cannot be revoked from this server. " +
|
|
18
|
+
"Use `update_qurl` instead when you only need to shorten the resource's expiration, retag, or rename, and `extend_qurl` to keep a link open longer — those preserve the existing access tokens. " +
|
|
16
19
|
"**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
20
|
"Branch on `was_already_revoked` to distinguish the no-op case from a successful revoke on this call. " +
|
|
18
21
|
"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. " +
|
|
@@ -65,7 +68,7 @@ export function deleteQurlTool(client, _runtime = { mode: "stdio" }) {
|
|
|
65
68
|
resource_id: input.resource_id,
|
|
66
69
|
revoked: true,
|
|
67
70
|
was_already_revoked: wasAlreadyRevoked,
|
|
68
|
-
message: `qURL ${input.resource_id} is revoked
|
|
71
|
+
message: `qURL ${input.resource_id} is revoked. ${UPLOAD_LINKS_NOTE}`,
|
|
69
72
|
};
|
|
70
73
|
return {
|
|
71
74
|
content: [
|
|
@@ -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,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
|
|
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,6EAA6E;AAC7E,2EAA2E;AAC3E,MAAM,iBAAiB,GACrB,yFAAyF,CAAC;AAE5F,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,qIAAqI;YACrI,iMAAiM;YACjM,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,gBAAgB,iBAAiB,EAAE;aACtE,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,13 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
/**
|
|
3
|
+
* Milliseconds in a duration string, or undefined when the grammar rejects it.
|
|
4
|
+
* Fractions are Go-duration only ("1.5h"); whole days/weeks are integers
|
|
5
|
+
* ("1.5d" is rejected), matching ParseDuration's strconv.Atoi branch.
|
|
6
|
+
*/
|
|
7
|
+
export declare function parseDurationMs(value: string): number | undefined;
|
|
8
|
+
export declare const durationSchema: (minMs: number, maxMs: number, range: string, allowEmpty?: boolean) => z.ZodString;
|
|
9
|
+
export declare const MIN_EXPIRY_MS = 60000;
|
|
10
|
+
export declare const MAX_EXPIRY_MS: number;
|
|
11
|
+
export declare const MIN_SESSION_MS = 1000;
|
|
12
|
+
export declare const MAX_SESSION_MS = 86400000;
|
|
13
|
+
//# sourceMappingURL=duration.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/tools/duration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASjE;AAYD,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,oBAAkB,gBAgBzF,CAAC;AAMN,eAAO,MAAM,aAAa,QAAS,CAAC;AAGpC,eAAO,MAAM,aAAa,QAAkB,CAAC;AAK7C,eAAO,MAAM,cAAc,OAAQ,CAAC;AACpC,eAAO,MAAM,cAAc,WAAa,CAAC"}
|