@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.
Files changed (91) hide show
  1. package/README.md +209 -48
  2. package/dist/client.d.ts +65 -10
  3. package/dist/client.d.ts.map +1 -1
  4. package/dist/client.js +103 -5
  5. package/dist/client.js.map +1 -1
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +10 -3
  8. package/dist/index.js.map +1 -1
  9. package/dist/prompts/audit-links.js +1 -1
  10. package/dist/prompts/audit-links.js.map +1 -1
  11. package/dist/qurl-cli.d.ts +96 -0
  12. package/dist/qurl-cli.d.ts.map +1 -0
  13. package/dist/qurl-cli.js +331 -0
  14. package/dist/qurl-cli.js.map +1 -0
  15. package/dist/server.d.ts +14 -1
  16. package/dist/server.d.ts.map +1 -1
  17. package/dist/server.js +39 -0
  18. package/dist/server.js.map +1 -1
  19. package/dist/tools/_shared.d.ts +1 -0
  20. package/dist/tools/_shared.d.ts.map +1 -1
  21. package/dist/tools/_shared.js +6 -1
  22. package/dist/tools/_shared.js.map +1 -1
  23. package/dist/tools/consumer-access.d.ts +235 -0
  24. package/dist/tools/consumer-access.d.ts.map +1 -0
  25. package/dist/tools/consumer-access.js +231 -0
  26. package/dist/tools/consumer-access.js.map +1 -0
  27. package/dist/tools/create-qurl.d.ts.map +1 -1
  28. package/dist/tools/create-qurl.js +6 -2
  29. package/dist/tools/create-qurl.js.map +1 -1
  30. package/dist/tools/delete-qurl.d.ts.map +1 -1
  31. package/dist/tools/delete-qurl.js +6 -3
  32. package/dist/tools/delete-qurl.js.map +1 -1
  33. package/dist/tools/duration.d.ts +13 -0
  34. package/dist/tools/duration.d.ts.map +1 -0
  35. package/dist/tools/duration.js +71 -0
  36. package/dist/tools/duration.js.map +1 -0
  37. package/dist/tools/email-delivery.d.ts +0 -1
  38. package/dist/tools/email-delivery.d.ts.map +1 -1
  39. package/dist/tools/email-delivery.js +0 -1
  40. package/dist/tools/email-delivery.js.map +1 -1
  41. package/dist/tools/extend-qurl.d.ts +14 -1
  42. package/dist/tools/extend-qurl.d.ts.map +1 -1
  43. package/dist/tools/extend-qurl.js +179 -18
  44. package/dist/tools/extend-qurl.js.map +1 -1
  45. package/dist/tools/get-qurl.d.ts +7 -0
  46. package/dist/tools/get-qurl.d.ts.map +1 -1
  47. package/dist/tools/list-qurls.d.ts +7 -0
  48. package/dist/tools/list-qurls.d.ts.map +1 -1
  49. package/dist/tools/local-cli.d.ts +44 -0
  50. package/dist/tools/local-cli.d.ts.map +1 -0
  51. package/dist/tools/local-cli.js +855 -0
  52. package/dist/tools/local-cli.js.map +1 -0
  53. package/dist/tools/mint-link.d.ts.map +1 -1
  54. package/dist/tools/mint-link.js +2 -1
  55. package/dist/tools/mint-link.js.map +1 -1
  56. package/dist/tools/output-schemas.d.ts +56 -4
  57. package/dist/tools/output-schemas.d.ts.map +1 -1
  58. package/dist/tools/output-schemas.js +62 -11
  59. package/dist/tools/output-schemas.js.map +1 -1
  60. package/dist/tools/share-by-crid.d.ts +52 -0
  61. package/dist/tools/share-by-crid.d.ts.map +1 -0
  62. package/dist/tools/share-by-crid.js +114 -0
  63. package/dist/tools/share-by-crid.js.map +1 -0
  64. package/dist/tools/update-qurl-token.d.ts.map +1 -1
  65. package/dist/tools/update-qurl-token.js +6 -7
  66. package/dist/tools/update-qurl-token.js.map +1 -1
  67. package/dist/tools/update-qurl.d.ts +7 -0
  68. package/dist/tools/update-qurl.d.ts.map +1 -1
  69. package/dist/tools/update-qurl.js +6 -7
  70. package/dist/tools/update-qurl.js.map +1 -1
  71. package/dist/tools/upload-file-data-qurl.d.ts +17 -61
  72. package/dist/tools/upload-file-data-qurl.d.ts.map +1 -1
  73. package/dist/tools/upload-file-data-qurl.js +16 -9
  74. package/dist/tools/upload-file-data-qurl.js.map +1 -1
  75. package/dist/tools/upload-file-qurl.d.ts +27 -55
  76. package/dist/tools/upload-file-qurl.d.ts.map +1 -1
  77. package/dist/tools/upload-file-qurl.js +19 -12
  78. package/dist/tools/upload-file-qurl.js.map +1 -1
  79. package/dist/tools/upload-file-shared.d.ts +27 -10
  80. package/dist/tools/upload-file-shared.d.ts.map +1 -1
  81. package/dist/tools/upload-file-shared.js +313 -43
  82. package/dist/tools/upload-file-shared.js.map +1 -1
  83. package/dist/tools/upload-mint-options.d.ts +14 -14
  84. package/dist/tools/upload-mint-options.d.ts.map +1 -1
  85. package/dist/tools/upload-mint-options.js +33 -15
  86. package/dist/tools/upload-mint-options.js.map +1 -1
  87. package/dist/tools/upload-text-qurl.d.ts +15 -47
  88. package/dist/tools/upload-text-qurl.d.ts.map +1 -1
  89. package/dist/tools/upload-text-qurl.js +11 -7
  90. package/dist/tools/upload-text-qurl.js.map +1 -1
  91. 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;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8C3B,CAAC;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsD9E"}
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.string().min(1).optional().describe('Duration string (e.g., "1h", "24h", "7d")'),
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
- "If `expires_in` is omitted the API defaults to **24h** — do not assume the link is permanent. " +
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;AAGtB,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,QAAQ,GAAE,kBAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyEjD"}
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
- "Use `update_qurl` instead when you only need to shorten/extend the expiration, retag, or rename — those preserve the existing access tokens. " +
15
- "Use `extend_qurl` when you only need to push the expiration out. " +
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,+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"}
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"}