@mcp-z/mcp-drive 1.0.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 (202) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +163 -0
  3. package/bin/server.js +5 -0
  4. package/dist/cjs/constants.d.cts +7 -0
  5. package/dist/cjs/constants.d.ts +7 -0
  6. package/dist/cjs/constants.js +18 -0
  7. package/dist/cjs/constants.js.map +1 -0
  8. package/dist/cjs/index.d.cts +8 -0
  9. package/dist/cjs/index.d.ts +8 -0
  10. package/dist/cjs/index.js +314 -0
  11. package/dist/cjs/index.js.map +1 -0
  12. package/dist/cjs/lib/create-store.d.cts +2 -0
  13. package/dist/cjs/lib/create-store.d.ts +2 -0
  14. package/dist/cjs/lib/create-store.js +166 -0
  15. package/dist/cjs/lib/create-store.js.map +1 -0
  16. package/dist/cjs/lib/query-builder.d.cts +45 -0
  17. package/dist/cjs/lib/query-builder.d.ts +45 -0
  18. package/dist/cjs/lib/query-builder.js +219 -0
  19. package/dist/cjs/lib/query-builder.js.map +1 -0
  20. package/dist/cjs/mcp/index.d.cts +3 -0
  21. package/dist/cjs/mcp/index.d.ts +3 -0
  22. package/dist/cjs/mcp/index.js +66 -0
  23. package/dist/cjs/mcp/index.js.map +1 -0
  24. package/dist/cjs/mcp/prompts/index.d.cts +2 -0
  25. package/dist/cjs/mcp/prompts/index.d.ts +2 -0
  26. package/dist/cjs/mcp/prompts/index.js +26 -0
  27. package/dist/cjs/mcp/prompts/index.js.map +1 -0
  28. package/dist/cjs/mcp/prompts/organize-files.d.cts +16 -0
  29. package/dist/cjs/mcp/prompts/organize-files.d.ts +16 -0
  30. package/dist/cjs/mcp/prompts/organize-files.js +169 -0
  31. package/dist/cjs/mcp/prompts/organize-files.js.map +1 -0
  32. package/dist/cjs/mcp/prompts/query-syntax.d.cts +19 -0
  33. package/dist/cjs/mcp/prompts/query-syntax.d.ts +19 -0
  34. package/dist/cjs/mcp/prompts/query-syntax.js +169 -0
  35. package/dist/cjs/mcp/prompts/query-syntax.js.map +1 -0
  36. package/dist/cjs/mcp/resources/file.d.cts +9 -0
  37. package/dist/cjs/mcp/resources/file.d.ts +9 -0
  38. package/dist/cjs/mcp/resources/file.js +247 -0
  39. package/dist/cjs/mcp/resources/file.js.map +1 -0
  40. package/dist/cjs/mcp/resources/index.d.cts +1 -0
  41. package/dist/cjs/mcp/resources/index.d.ts +1 -0
  42. package/dist/cjs/mcp/resources/index.js +17 -0
  43. package/dist/cjs/mcp/resources/index.js.map +1 -0
  44. package/dist/cjs/mcp/tools/file-move-to-trash.d.cts +59 -0
  45. package/dist/cjs/mcp/tools/file-move-to-trash.d.ts +59 -0
  46. package/dist/cjs/mcp/tools/file-move-to-trash.js +334 -0
  47. package/dist/cjs/mcp/tools/file-move-to-trash.js.map +1 -0
  48. package/dist/cjs/mcp/tools/file-move.d.cts +73 -0
  49. package/dist/cjs/mcp/tools/file-move.d.ts +73 -0
  50. package/dist/cjs/mcp/tools/file-move.js +613 -0
  51. package/dist/cjs/mcp/tools/file-move.js.map +1 -0
  52. package/dist/cjs/mcp/tools/files-search.d.cts +135 -0
  53. package/dist/cjs/mcp/tools/files-search.d.ts +135 -0
  54. package/dist/cjs/mcp/tools/files-search.js +558 -0
  55. package/dist/cjs/mcp/tools/files-search.js.map +1 -0
  56. package/dist/cjs/mcp/tools/folder-contents.d.cts +139 -0
  57. package/dist/cjs/mcp/tools/folder-contents.d.ts +139 -0
  58. package/dist/cjs/mcp/tools/folder-contents.js +513 -0
  59. package/dist/cjs/mcp/tools/folder-contents.js.map +1 -0
  60. package/dist/cjs/mcp/tools/folder-create.d.cts +59 -0
  61. package/dist/cjs/mcp/tools/folder-create.d.ts +59 -0
  62. package/dist/cjs/mcp/tools/folder-create.js +368 -0
  63. package/dist/cjs/mcp/tools/folder-create.js.map +1 -0
  64. package/dist/cjs/mcp/tools/folder-path.d.cts +49 -0
  65. package/dist/cjs/mcp/tools/folder-path.d.ts +49 -0
  66. package/dist/cjs/mcp/tools/folder-path.js +367 -0
  67. package/dist/cjs/mcp/tools/folder-path.js.map +1 -0
  68. package/dist/cjs/mcp/tools/folder-search.d.cts +139 -0
  69. package/dist/cjs/mcp/tools/folder-search.d.ts +139 -0
  70. package/dist/cjs/mcp/tools/folder-search.js +760 -0
  71. package/dist/cjs/mcp/tools/folder-search.js.map +1 -0
  72. package/dist/cjs/mcp/tools/index.d.cts +7 -0
  73. package/dist/cjs/mcp/tools/index.d.ts +7 -0
  74. package/dist/cjs/mcp/tools/index.js +46 -0
  75. package/dist/cjs/mcp/tools/index.js.map +1 -0
  76. package/dist/cjs/package.json +1 -0
  77. package/dist/cjs/schemas/drive-query-schema.d.cts +40 -0
  78. package/dist/cjs/schemas/drive-query-schema.d.ts +40 -0
  79. package/dist/cjs/schemas/drive-query-schema.js +90 -0
  80. package/dist/cjs/schemas/drive-query-schema.js.map +1 -0
  81. package/dist/cjs/schemas/drive-validation.d.cts +48 -0
  82. package/dist/cjs/schemas/drive-validation.d.ts +48 -0
  83. package/dist/cjs/schemas/drive-validation.js +96 -0
  84. package/dist/cjs/schemas/drive-validation.js.map +1 -0
  85. package/dist/cjs/schemas/index.d.cts +2 -0
  86. package/dist/cjs/schemas/index.d.ts +2 -0
  87. package/dist/cjs/schemas/index.js +20 -0
  88. package/dist/cjs/schemas/index.js.map +1 -0
  89. package/dist/cjs/setup/config.d.cts +44 -0
  90. package/dist/cjs/setup/config.d.ts +44 -0
  91. package/dist/cjs/setup/config.js +201 -0
  92. package/dist/cjs/setup/config.js.map +1 -0
  93. package/dist/cjs/setup/http.d.cts +8 -0
  94. package/dist/cjs/setup/http.d.ts +8 -0
  95. package/dist/cjs/setup/http.js +260 -0
  96. package/dist/cjs/setup/http.js.map +1 -0
  97. package/dist/cjs/setup/index.d.cts +5 -0
  98. package/dist/cjs/setup/index.d.ts +5 -0
  99. package/dist/cjs/setup/index.js +46 -0
  100. package/dist/cjs/setup/index.js.map +1 -0
  101. package/dist/cjs/setup/oauth-google.d.cts +64 -0
  102. package/dist/cjs/setup/oauth-google.d.ts +64 -0
  103. package/dist/cjs/setup/oauth-google.js +347 -0
  104. package/dist/cjs/setup/oauth-google.js.map +1 -0
  105. package/dist/cjs/setup/runtime.d.cts +10 -0
  106. package/dist/cjs/setup/runtime.d.ts +10 -0
  107. package/dist/cjs/setup/runtime.js +353 -0
  108. package/dist/cjs/setup/runtime.js.map +1 -0
  109. package/dist/cjs/setup/stdio.d.cts +7 -0
  110. package/dist/cjs/setup/stdio.d.ts +7 -0
  111. package/dist/cjs/setup/stdio.js +239 -0
  112. package/dist/cjs/setup/stdio.js.map +1 -0
  113. package/dist/cjs/types.d.cts +45 -0
  114. package/dist/cjs/types.d.ts +45 -0
  115. package/dist/cjs/types.js +5 -0
  116. package/dist/cjs/types.js.map +1 -0
  117. package/dist/esm/constants.d.ts +7 -0
  118. package/dist/esm/constants.js +7 -0
  119. package/dist/esm/constants.js.map +1 -0
  120. package/dist/esm/index.d.ts +8 -0
  121. package/dist/esm/index.js +34 -0
  122. package/dist/esm/index.js.map +1 -0
  123. package/dist/esm/lib/create-store.d.ts +2 -0
  124. package/dist/esm/lib/create-store.js +6 -0
  125. package/dist/esm/lib/create-store.js.map +1 -0
  126. package/dist/esm/lib/query-builder.d.ts +45 -0
  127. package/dist/esm/lib/query-builder.js +184 -0
  128. package/dist/esm/lib/query-builder.js.map +1 -0
  129. package/dist/esm/mcp/index.d.ts +3 -0
  130. package/dist/esm/mcp/index.js +6 -0
  131. package/dist/esm/mcp/index.js.map +1 -0
  132. package/dist/esm/mcp/prompts/index.d.ts +2 -0
  133. package/dist/esm/mcp/prompts/index.js +2 -0
  134. package/dist/esm/mcp/prompts/index.js.map +1 -0
  135. package/dist/esm/mcp/prompts/organize-files.d.ts +16 -0
  136. package/dist/esm/mcp/prompts/organize-files.js +21 -0
  137. package/dist/esm/mcp/prompts/organize-files.js.map +1 -0
  138. package/dist/esm/mcp/prompts/query-syntax.d.ts +19 -0
  139. package/dist/esm/mcp/prompts/query-syntax.js +82 -0
  140. package/dist/esm/mcp/prompts/query-syntax.js.map +1 -0
  141. package/dist/esm/mcp/resources/file.d.ts +9 -0
  142. package/dist/esm/mcp/resources/file.js +77 -0
  143. package/dist/esm/mcp/resources/file.js.map +1 -0
  144. package/dist/esm/mcp/resources/index.d.ts +1 -0
  145. package/dist/esm/mcp/resources/index.js +1 -0
  146. package/dist/esm/mcp/resources/index.js.map +1 -0
  147. package/dist/esm/mcp/tools/file-move-to-trash.d.ts +59 -0
  148. package/dist/esm/mcp/tools/file-move-to-trash.js +118 -0
  149. package/dist/esm/mcp/tools/file-move-to-trash.js.map +1 -0
  150. package/dist/esm/mcp/tools/file-move.d.ts +73 -0
  151. package/dist/esm/mcp/tools/file-move.js +274 -0
  152. package/dist/esm/mcp/tools/file-move.js.map +1 -0
  153. package/dist/esm/mcp/tools/files-search.d.ts +135 -0
  154. package/dist/esm/mcp/tools/files-search.js +254 -0
  155. package/dist/esm/mcp/tools/files-search.js.map +1 -0
  156. package/dist/esm/mcp/tools/folder-contents.d.ts +139 -0
  157. package/dist/esm/mcp/tools/folder-contents.js +214 -0
  158. package/dist/esm/mcp/tools/folder-contents.js.map +1 -0
  159. package/dist/esm/mcp/tools/folder-create.d.ts +59 -0
  160. package/dist/esm/mcp/tools/folder-create.js +140 -0
  161. package/dist/esm/mcp/tools/folder-create.js.map +1 -0
  162. package/dist/esm/mcp/tools/folder-path.d.ts +49 -0
  163. package/dist/esm/mcp/tools/folder-path.js +147 -0
  164. package/dist/esm/mcp/tools/folder-path.js.map +1 -0
  165. package/dist/esm/mcp/tools/folder-search.d.ts +139 -0
  166. package/dist/esm/mcp/tools/folder-search.js +343 -0
  167. package/dist/esm/mcp/tools/folder-search.js.map +1 -0
  168. package/dist/esm/mcp/tools/index.d.ts +7 -0
  169. package/dist/esm/mcp/tools/index.js +7 -0
  170. package/dist/esm/mcp/tools/index.js.map +1 -0
  171. package/dist/esm/package.json +1 -0
  172. package/dist/esm/schemas/drive-query-schema.d.ts +40 -0
  173. package/dist/esm/schemas/drive-query-schema.js +84 -0
  174. package/dist/esm/schemas/drive-query-schema.js.map +1 -0
  175. package/dist/esm/schemas/drive-validation.d.ts +48 -0
  176. package/dist/esm/schemas/drive-validation.js +73 -0
  177. package/dist/esm/schemas/drive-validation.js.map +1 -0
  178. package/dist/esm/schemas/index.d.ts +2 -0
  179. package/dist/esm/schemas/index.js +2 -0
  180. package/dist/esm/schemas/index.js.map +1 -0
  181. package/dist/esm/setup/config.d.ts +44 -0
  182. package/dist/esm/setup/config.js +151 -0
  183. package/dist/esm/setup/config.js.map +1 -0
  184. package/dist/esm/setup/http.d.ts +8 -0
  185. package/dist/esm/setup/http.js +54 -0
  186. package/dist/esm/setup/http.js.map +1 -0
  187. package/dist/esm/setup/index.d.ts +5 -0
  188. package/dist/esm/setup/index.js +5 -0
  189. package/dist/esm/setup/index.js.map +1 -0
  190. package/dist/esm/setup/oauth-google.d.ts +64 -0
  191. package/dist/esm/setup/oauth-google.js +168 -0
  192. package/dist/esm/setup/oauth-google.js.map +1 -0
  193. package/dist/esm/setup/runtime.d.ts +10 -0
  194. package/dist/esm/setup/runtime.js +84 -0
  195. package/dist/esm/setup/runtime.js.map +1 -0
  196. package/dist/esm/setup/stdio.d.ts +7 -0
  197. package/dist/esm/setup/stdio.js +38 -0
  198. package/dist/esm/setup/stdio.js.map +1 -0
  199. package/dist/esm/types.d.ts +45 -0
  200. package/dist/esm/types.js +1 -0
  201. package/dist/esm/types.js.map +1 -0
  202. package/package.json +108 -0
@@ -0,0 +1,214 @@
1
+ import { schemas } from '@mcp-z/oauth-google';
2
+ const { AuthRequiredBranchSchema } = schemas;
3
+ import { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, toColumnarFormat } from '@mcp-z/server';
4
+ import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
5
+ import { google } from 'googleapis';
6
+ import { z } from 'zod';
7
+ import { DRIVE_FILE_COMMON_PATTERNS, DRIVE_FILE_FIELD_DESCRIPTIONS, DRIVE_FILE_FIELDS, DriveFileSchema } from '../../schemas/index.js';
8
+ const inputSchema = z.object({
9
+ folderId: z.string().min(1).describe('Folder ID to list contents (use "root" for Drive root)'),
10
+ fields: createFieldsSchema({
11
+ availableFields: DRIVE_FILE_FIELDS,
12
+ fieldDescriptions: DRIVE_FILE_FIELD_DESCRIPTIONS,
13
+ commonPatterns: DRIVE_FILE_COMMON_PATTERNS,
14
+ resourceName: 'Drive item'
15
+ }),
16
+ ...createPaginationSchema({
17
+ defaultPageSize: 50,
18
+ maxPageSize: 1000,
19
+ provider: 'drive'
20
+ }).shape,
21
+ shape: createShapeSchema()
22
+ });
23
+ // Success branch schemas for different shapes
24
+ const successObjectsBranchSchema = z.object({
25
+ type: z.literal('success'),
26
+ shape: z.literal('objects'),
27
+ items: z.array(DriveFileSchema).describe('Files and folders in the specified folder'),
28
+ count: z.number().describe('Number of items in this page'),
29
+ folderId: z.string().describe('ID of the folder that was listed'),
30
+ nextPageToken: z.string().optional().describe('Token for fetching next page of results')
31
+ });
32
+ const successArraysBranchSchema = z.object({
33
+ type: z.literal('success'),
34
+ shape: z.literal('arrays'),
35
+ columns: z.array(z.string()).describe('Column names in canonical order'),
36
+ rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),
37
+ count: z.number().describe('Number of items in this page'),
38
+ folderId: z.string().describe('ID of the folder that was listed'),
39
+ nextPageToken: z.string().optional().describe('Token for fetching next page of results')
40
+ });
41
+ // Output schema with auth_required support
42
+ // Using z.union instead of discriminatedUnion since we have two success branches with different shapes
43
+ const outputSchema = z.union([
44
+ successObjectsBranchSchema,
45
+ successArraysBranchSchema,
46
+ AuthRequiredBranchSchema
47
+ ]);
48
+ const config = {
49
+ title: 'List Folder Contents',
50
+ description: 'List files and folders in a specific folder with field selection.',
51
+ inputSchema: inputSchema,
52
+ outputSchema: z.object({
53
+ result: outputSchema
54
+ })
55
+ };
56
+ async function handler({ folderId, pageSize = 50, pageToken, fields, shape = 'arrays' }, extra) {
57
+ const logger = extra.logger;
58
+ const requestedFields = parseFields(fields, DRIVE_FILE_FIELDS);
59
+ logger.info('drive.folder.contents called', {
60
+ folderId,
61
+ pageSize,
62
+ pageToken: pageToken ? '[provided]' : undefined,
63
+ fields: fields || 'all'
64
+ });
65
+ try {
66
+ const drive = google.drive({
67
+ version: 'v3',
68
+ auth: extra.authContext.auth
69
+ });
70
+ const qStr = `'${folderId}' in parents and trashed = false`;
71
+ const listOptions = {
72
+ q: qStr,
73
+ pageSize: Math.min(1000, pageSize),
74
+ fields: 'files(id,name,mimeType,webViewLink,modifiedTime,parents,shared,starred,owners),nextPageToken',
75
+ orderBy: 'folder,name'
76
+ };
77
+ if (pageToken && pageToken.trim().length > 0) {
78
+ listOptions.pageToken = pageToken;
79
+ }
80
+ const response = await drive.files.list(listOptions);
81
+ const res = response.data;
82
+ const items = Array.isArray(res === null || res === void 0 ? void 0 : res.files) ? res.files : [];
83
+ const parentIds = new Set();
84
+ for (const f of items){
85
+ if ((f === null || f === void 0 ? void 0 : f.parents) && f.parents.length > 0) {
86
+ for (const parentId of f.parents){
87
+ if (parentId && parentId !== 'root') {
88
+ parentIds.add(parentId);
89
+ }
90
+ }
91
+ }
92
+ }
93
+ const parentNameMap = new Map();
94
+ if (parentIds.size > 0) {
95
+ logger.info('Fetching parent names', {
96
+ count: parentIds.size
97
+ });
98
+ const parentFetches = Array.from(parentIds).map(async (parentId)=>{
99
+ try {
100
+ const parentRes = await drive.files.get({
101
+ fileId: parentId,
102
+ fields: 'id,name'
103
+ });
104
+ const parentName = parentRes.data.name || parentId;
105
+ parentNameMap.set(parentId, parentName);
106
+ } catch (e) {
107
+ logger.info('Failed to fetch parent name', {
108
+ parentId,
109
+ error: e
110
+ });
111
+ parentNameMap.set(parentId, parentId); // Fallback to ID
112
+ }
113
+ });
114
+ await Promise.all(parentFetches);
115
+ }
116
+ const driveFiles = items.map((f)=>{
117
+ const id = (f === null || f === void 0 ? void 0 : f.id) ? String(f.id) : 'unknown';
118
+ const name = (f === null || f === void 0 ? void 0 : f.name) || id;
119
+ const result = {
120
+ id,
121
+ name
122
+ };
123
+ // Only include properties that have actual values
124
+ if (f === null || f === void 0 ? void 0 : f.mimeType) result.mimeType = f.mimeType;
125
+ if (f === null || f === void 0 ? void 0 : f.webViewLink) result.webViewLink = f.webViewLink;
126
+ if (f === null || f === void 0 ? void 0 : f.modifiedTime) result.modifiedTime = f.modifiedTime;
127
+ // Build parent objects with names
128
+ if ((f === null || f === void 0 ? void 0 : f.parents) && f.parents.length > 0) {
129
+ result.parents = f.parents.map((parentId)=>{
130
+ if (parentId === 'root') {
131
+ return {
132
+ id: 'root',
133
+ name: 'My Drive'
134
+ };
135
+ }
136
+ const parentName = parentNameMap.get(parentId) || parentId;
137
+ return {
138
+ id: parentId,
139
+ name: parentName
140
+ };
141
+ });
142
+ }
143
+ if ((f === null || f === void 0 ? void 0 : f.shared) !== undefined) result.shared = f.shared;
144
+ if ((f === null || f === void 0 ? void 0 : f.starred) !== undefined) result.starred = f.starred;
145
+ if ((f === null || f === void 0 ? void 0 : f.owners) && f.owners.length > 0) {
146
+ result.owners = f.owners.map((o)=>{
147
+ const owner = {};
148
+ if (o === null || o === void 0 ? void 0 : o.displayName) owner.displayName = o.displayName;
149
+ if (o === null || o === void 0 ? void 0 : o.emailAddress) owner.emailAddress = o.emailAddress;
150
+ if (o === null || o === void 0 ? void 0 : o.kind) owner.kind = o.kind;
151
+ if ((o === null || o === void 0 ? void 0 : o.me) !== undefined) owner.me = o.me;
152
+ if (o === null || o === void 0 ? void 0 : o.permissionId) owner.permissionId = o.permissionId;
153
+ if (o === null || o === void 0 ? void 0 : o.photoLink) owner.photoLink = o.photoLink;
154
+ return owner;
155
+ });
156
+ }
157
+ return result;
158
+ });
159
+ const filteredItems = driveFiles.map((item)=>filterFields(item, requestedFields));
160
+ logger.info('drive.folder.contents returning', {
161
+ folderId,
162
+ resultCount: filteredItems.length,
163
+ fields: fields || 'all'
164
+ });
165
+ const nextPageToken = res.nextPageToken && res.nextPageToken.trim().length > 0 ? res.nextPageToken : undefined;
166
+ // Build result based on shape
167
+ const result = shape === 'arrays' ? {
168
+ type: 'success',
169
+ shape: 'arrays',
170
+ ...toColumnarFormat(filteredItems, requestedFields, DRIVE_FILE_FIELDS),
171
+ count: filteredItems.length,
172
+ folderId,
173
+ ...nextPageToken && {
174
+ nextPageToken
175
+ }
176
+ } : {
177
+ type: 'success',
178
+ shape: 'objects',
179
+ items: filteredItems,
180
+ count: filteredItems.length,
181
+ folderId,
182
+ ...nextPageToken && {
183
+ nextPageToken
184
+ }
185
+ };
186
+ return {
187
+ content: [
188
+ {
189
+ type: 'text',
190
+ text: JSON.stringify(result)
191
+ }
192
+ ],
193
+ structuredContent: {
194
+ result
195
+ }
196
+ };
197
+ } catch (error) {
198
+ const message = error instanceof Error ? error.message : String(error);
199
+ logger.error('drive.folder.contents error', {
200
+ error: message
201
+ });
202
+ // Throw McpError
203
+ throw new McpError(ErrorCode.InternalError, `Error listing folder contents: ${message}`, {
204
+ stack: error instanceof Error ? error.stack : undefined
205
+ });
206
+ }
207
+ }
208
+ export default function createTool() {
209
+ return {
210
+ name: 'folder-contents',
211
+ config,
212
+ handler
213
+ };
214
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/mcp/tools/folder-contents.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, toColumnarFormat } from '@mcp-z/server';\nimport { type CallToolResult, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { DRIVE_FILE_COMMON_PATTERNS, DRIVE_FILE_FIELD_DESCRIPTIONS, DRIVE_FILE_FIELDS, type DriveFile, DriveFileSchema } from '../../schemas/index.js';\n\nconst inputSchema = z.object({\n folderId: z.string().min(1).describe('Folder ID to list contents (use \"root\" for Drive root)'),\n fields: createFieldsSchema({\n availableFields: DRIVE_FILE_FIELDS,\n fieldDescriptions: DRIVE_FILE_FIELD_DESCRIPTIONS,\n commonPatterns: DRIVE_FILE_COMMON_PATTERNS,\n resourceName: 'Drive item',\n }),\n ...createPaginationSchema({\n defaultPageSize: 50,\n maxPageSize: 1000,\n provider: 'drive',\n }).shape,\n shape: createShapeSchema(),\n});\n\n// Success branch schemas for different shapes\nconst successObjectsBranchSchema = z.object({\n type: z.literal('success'),\n shape: z.literal('objects'),\n items: z.array(DriveFileSchema).describe('Files and folders in the specified folder'),\n count: z.number().describe('Number of items in this page'),\n folderId: z.string().describe('ID of the folder that was listed'),\n nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\nconst successArraysBranchSchema = z.object({\n type: z.literal('success'),\n shape: z.literal('arrays'),\n columns: z.array(z.string()).describe('Column names in canonical order'),\n rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),\n count: z.number().describe('Number of items in this page'),\n folderId: z.string().describe('ID of the folder that was listed'),\n nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\n// Output schema with auth_required support\n// Using z.union instead of discriminatedUnion since we have two success branches with different shapes\nconst outputSchema = z.union([successObjectsBranchSchema, successArraysBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n title: 'List Folder Contents',\n description: 'List files and folders in a specific folder with field selection.',\n inputSchema: inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Type for the raw Google Drive API response\ntype DriveItem = {\n id?: string;\n name?: string;\n mimeType?: string;\n webViewLink?: string;\n modifiedTime?: string;\n parents?: string[];\n shared?: boolean;\n starred?: boolean;\n owners?: Array<{\n displayName?: string;\n emailAddress?: string;\n kind?: string;\n me?: boolean;\n permissionId?: string;\n photoLink?: string;\n }>;\n};\n\ntype DriveResponse = {\n files?: DriveItem[];\n nextPageToken?: string;\n};\n\nasync function handler({ folderId, pageSize = 50, pageToken, fields, shape = 'arrays' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n\n const requestedFields = parseFields(fields, DRIVE_FILE_FIELDS);\n\n logger.info('drive.folder.contents called', {\n folderId,\n pageSize,\n pageToken: pageToken ? '[provided]' : undefined,\n fields: fields || 'all',\n });\n\n try {\n const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n const qStr = `'${folderId}' in parents and trashed = false`;\n\n const listOptions: {\n q: string;\n pageSize: number;\n fields: string;\n orderBy: string;\n pageToken?: string;\n } = {\n q: qStr,\n pageSize: Math.min(1000, pageSize),\n fields: 'files(id,name,mimeType,webViewLink,modifiedTime,parents,shared,starred,owners),nextPageToken',\n orderBy: 'folder,name', // Folders first, then by name\n };\n if (pageToken && pageToken.trim().length > 0) {\n listOptions.pageToken = pageToken;\n }\n\n const response = await drive.files.list(listOptions);\n\n const res = response.data as DriveResponse;\n const items = Array.isArray(res?.files) ? res.files : [];\n\n const parentIds = new Set<string>();\n for (const f of items) {\n if (f?.parents && f.parents.length > 0) {\n for (const parentId of f.parents) {\n if (parentId && parentId !== 'root') {\n parentIds.add(parentId);\n }\n }\n }\n }\n\n const parentNameMap = new Map<string, string>();\n if (parentIds.size > 0) {\n logger.info('Fetching parent names', { count: parentIds.size });\n const parentFetches = Array.from(parentIds).map(async (parentId) => {\n try {\n const parentRes = await drive.files.get({\n fileId: parentId,\n fields: 'id,name',\n });\n const parentName = (parentRes.data.name as string | undefined) || parentId;\n parentNameMap.set(parentId, parentName);\n } catch (e) {\n logger.info('Failed to fetch parent name', { parentId, error: e });\n parentNameMap.set(parentId, parentId); // Fallback to ID\n }\n });\n await Promise.all(parentFetches);\n }\n\n const driveFiles: DriveFile[] = items.map((f: DriveItem) => {\n const id = f?.id ? String(f.id) : 'unknown';\n const name = f?.name || id;\n const result: DriveFile = { id, name };\n\n // Only include properties that have actual values\n if (f?.mimeType) result.mimeType = f.mimeType;\n if (f?.webViewLink) result.webViewLink = f.webViewLink;\n if (f?.modifiedTime) result.modifiedTime = f.modifiedTime;\n\n // Build parent objects with names\n if (f?.parents && f.parents.length > 0) {\n result.parents = f.parents.map((parentId) => {\n if (parentId === 'root') {\n return { id: 'root', name: 'My Drive' };\n }\n const parentName = parentNameMap.get(parentId) || parentId;\n return { id: parentId, name: parentName };\n });\n }\n\n if (f?.shared !== undefined) result.shared = f.shared;\n if (f?.starred !== undefined) result.starred = f.starred;\n\n if (f?.owners && f.owners.length > 0) {\n result.owners = f.owners.map((o) => {\n const owner: NonNullable<DriveFile['owners']>[number] = {};\n if (o?.displayName) owner.displayName = o.displayName;\n if (o?.emailAddress) owner.emailAddress = o.emailAddress;\n if (o?.kind) owner.kind = o.kind;\n if (o?.me !== undefined) owner.me = o.me;\n if (o?.permissionId) owner.permissionId = o.permissionId;\n if (o?.photoLink) owner.photoLink = o.photoLink;\n return owner;\n });\n }\n\n return result;\n });\n\n const filteredItems = driveFiles.map((item) => filterFields(item, requestedFields));\n\n logger.info('drive.folder.contents returning', {\n folderId,\n resultCount: filteredItems.length,\n fields: fields || 'all',\n });\n\n const nextPageToken = res.nextPageToken && res.nextPageToken.trim().length > 0 ? res.nextPageToken : undefined;\n\n // Build result based on shape\n const result: Output =\n shape === 'arrays'\n ? {\n type: 'success' as const,\n shape: 'arrays' as const,\n ...toColumnarFormat(filteredItems, requestedFields, DRIVE_FILE_FIELDS),\n count: filteredItems.length,\n folderId,\n ...(nextPageToken && { nextPageToken }),\n }\n : {\n type: 'success' as const,\n shape: 'objects' as const,\n items: filteredItems,\n count: filteredItems.length,\n folderId,\n ...(nextPageToken && { nextPageToken }),\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('drive.folder.contents error', { error: message });\n\n // Throw McpError\n throw new McpError(ErrorCode.InternalError, `Error listing folder contents: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'folder-contents' as const,\n config,\n handler,\n };\n}\n"],"names":["schemas","AuthRequiredBranchSchema","createFieldsSchema","createPaginationSchema","createShapeSchema","filterFields","parseFields","toColumnarFormat","ErrorCode","McpError","google","z","DRIVE_FILE_COMMON_PATTERNS","DRIVE_FILE_FIELD_DESCRIPTIONS","DRIVE_FILE_FIELDS","DriveFileSchema","inputSchema","object","folderId","string","min","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","defaultPageSize","maxPageSize","provider","shape","successObjectsBranchSchema","type","literal","items","array","count","number","nextPageToken","optional","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","title","description","result","handler","pageSize","pageToken","extra","logger","requestedFields","info","undefined","drive","version","auth","authContext","qStr","listOptions","q","Math","orderBy","trim","length","response","files","list","res","data","Array","isArray","parentIds","Set","f","parents","parentId","add","parentNameMap","Map","size","parentFetches","from","map","parentRes","get","fileId","parentName","name","set","e","error","Promise","all","driveFiles","id","String","mimeType","webViewLink","modifiedTime","shared","starred","owners","o","owner","displayName","emailAddress","kind","me","permissionId","photoLink","filteredItems","item","resultCount","content","text","JSON","stringify","structuredContent","message","Error","InternalError","stack","createTool"],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ import type { EnrichedExtra } from '@mcp-z/oauth-google';
2
+ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
3
+ import { z } from 'zod';
4
+ declare const inputSchema: z.ZodObject<{
5
+ name: z.ZodString;
6
+ parentId: z.ZodOptional<z.ZodString>;
7
+ }, z.core.$strip>;
8
+ declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
9
+ type: z.ZodLiteral<"success">;
10
+ operationSummary: z.ZodString;
11
+ itemsProcessed: z.ZodNumber;
12
+ itemsChanged: z.ZodNumber;
13
+ completedAt: z.ZodString;
14
+ id: z.ZodString;
15
+ name: z.ZodString;
16
+ webViewLink: z.ZodString;
17
+ parentId: z.ZodOptional<z.ZodString>;
18
+ parentName: z.ZodOptional<z.ZodString>;
19
+ }, z.core.$strip>, z.ZodObject<{
20
+ type: z.ZodLiteral<"auth_required">;
21
+ provider: z.ZodString;
22
+ message: z.ZodString;
23
+ url: z.ZodOptional<z.ZodString>;
24
+ }, z.core.$strip>], "type">;
25
+ export type Input = z.infer<typeof inputSchema>;
26
+ export type Output = z.infer<typeof outputSchema>;
27
+ declare function handler({ name: folderName, parentId }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
28
+ export default function createTool(): {
29
+ name: "folder-create";
30
+ config: {
31
+ readonly title: "Create Folder";
32
+ readonly description: "Create a new folder in Google Drive. Returns folder ID for use in other operations.";
33
+ readonly inputSchema: z.ZodObject<{
34
+ name: z.ZodString;
35
+ parentId: z.ZodOptional<z.ZodString>;
36
+ }, z.core.$strip>;
37
+ readonly outputSchema: z.ZodObject<{
38
+ result: z.ZodDiscriminatedUnion<[z.ZodObject<{
39
+ type: z.ZodLiteral<"success">;
40
+ operationSummary: z.ZodString;
41
+ itemsProcessed: z.ZodNumber;
42
+ itemsChanged: z.ZodNumber;
43
+ completedAt: z.ZodString;
44
+ id: z.ZodString;
45
+ name: z.ZodString;
46
+ webViewLink: z.ZodString;
47
+ parentId: z.ZodOptional<z.ZodString>;
48
+ parentName: z.ZodOptional<z.ZodString>;
49
+ }, z.core.$strip>, z.ZodObject<{
50
+ type: z.ZodLiteral<"auth_required">;
51
+ provider: z.ZodString;
52
+ message: z.ZodString;
53
+ url: z.ZodOptional<z.ZodString>;
54
+ }, z.core.$strip>], "type">;
55
+ }, z.core.$strip>;
56
+ };
57
+ handler: typeof handler;
58
+ };
59
+ export {};
@@ -0,0 +1,140 @@
1
+ import { schemas } from '@mcp-z/oauth-google';
2
+ const { AuthRequiredBranchSchema } = schemas;
3
+ import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
4
+ import { google } from 'googleapis';
5
+ import { z } from 'zod';
6
+ const inputSchema = z.object({
7
+ name: z.string().trim().min(1).describe('Name for the new folder'),
8
+ parentId: z.string().optional().describe('Parent folder ID (omit to create in My Drive root)')
9
+ });
10
+ // Success branch schema
11
+ const successBranchSchema = z.object({
12
+ type: z.literal('success'),
13
+ operationSummary: z.string().describe('Summary of the folder creation operation'),
14
+ itemsProcessed: z.number().describe('Total items attempted (always 1 for single folder)'),
15
+ itemsChanged: z.number().describe('Successfully created folders (always 1 on success)'),
16
+ completedAt: z.string().describe('ISO datetime when operation completed'),
17
+ id: z.string().describe('ID of the created folder'),
18
+ name: z.string().describe('Name of the created folder'),
19
+ webViewLink: z.string().describe('URL to view the folder in Drive'),
20
+ parentId: z.string().optional().describe('ID of the parent folder'),
21
+ parentName: z.string().optional().describe('Name of the parent folder')
22
+ });
23
+ // Output schema with auth_required support
24
+ const outputSchema = z.discriminatedUnion('type', [
25
+ successBranchSchema,
26
+ AuthRequiredBranchSchema
27
+ ]);
28
+ const config = {
29
+ title: 'Create Folder',
30
+ description: 'Create a new folder in Google Drive. Returns folder ID for use in other operations.',
31
+ inputSchema,
32
+ outputSchema: z.object({
33
+ result: outputSchema
34
+ })
35
+ };
36
+ async function handler({ name: folderName, parentId }, extra) {
37
+ const logger = extra.logger;
38
+ logger.info('drive.folder.create called', {
39
+ name: folderName,
40
+ parentId: parentId || 'root'
41
+ });
42
+ try {
43
+ var _res_id, _res_name, _res_webViewLink;
44
+ const drive = google.drive({
45
+ version: 'v3',
46
+ auth: extra.authContext.auth
47
+ });
48
+ // Folder MIME type constant (consistent with folder-search.ts)
49
+ const folderMimeType = 'application/vnd.google-apps.folder';
50
+ // Create the folder
51
+ const response = await drive.files.create({
52
+ requestBody: {
53
+ name: folderName,
54
+ mimeType: folderMimeType,
55
+ parents: parentId ? [
56
+ parentId
57
+ ] : null
58
+ },
59
+ fields: 'id,name,webViewLink,parents'
60
+ });
61
+ const res = response.data;
62
+ const id = (_res_id = res.id) !== null && _res_id !== void 0 ? _res_id : '';
63
+ const name = (_res_name = res.name) !== null && _res_name !== void 0 ? _res_name : folderName;
64
+ const webViewLink = (_res_webViewLink = res.webViewLink) !== null && _res_webViewLink !== void 0 ? _res_webViewLink : '';
65
+ const parents = res.parents || [];
66
+ // Fetch parent name if parentId was provided
67
+ let parentName;
68
+ let actualParentId;
69
+ if (parents.length > 0) {
70
+ actualParentId = parents[0];
71
+ if (actualParentId === 'root') {
72
+ parentName = 'My Drive';
73
+ } else if (actualParentId) {
74
+ try {
75
+ const parentResponse = await drive.files.get({
76
+ fileId: actualParentId,
77
+ fields: 'name'
78
+ });
79
+ parentName = parentResponse.data.name || actualParentId;
80
+ } catch (e) {
81
+ logger.info('Failed to fetch parent name', {
82
+ parentId: actualParentId,
83
+ error: e
84
+ });
85
+ parentName = actualParentId; // Fallback to ID
86
+ }
87
+ }
88
+ }
89
+ const locationSummary = parentName ? ` in "${parentName}"` : ' in My Drive';
90
+ logger.info('drive.folder.create success', {
91
+ id,
92
+ name,
93
+ parentId: actualParentId
94
+ });
95
+ // Build result object with operation metadata
96
+ const result = {
97
+ type: 'success',
98
+ operationSummary: `Created folder "${name}"${locationSummary}`,
99
+ itemsProcessed: 1,
100
+ itemsChanged: 1,
101
+ completedAt: new Date().toISOString(),
102
+ id,
103
+ name,
104
+ webViewLink,
105
+ ...actualParentId && {
106
+ parentId: actualParentId
107
+ },
108
+ ...parentName && {
109
+ parentName
110
+ }
111
+ };
112
+ return {
113
+ content: [
114
+ {
115
+ type: 'text',
116
+ text: JSON.stringify(result)
117
+ }
118
+ ],
119
+ structuredContent: {
120
+ result
121
+ }
122
+ };
123
+ } catch (error) {
124
+ const message = error instanceof Error ? error.message : String(error);
125
+ logger.error('drive.folder.create error', {
126
+ error: message
127
+ });
128
+ // Throw McpError for proper MCP error handling
129
+ throw new McpError(ErrorCode.InternalError, `Error creating folder: ${message}`, {
130
+ stack: error instanceof Error ? error.stack : undefined
131
+ });
132
+ }
133
+ }
134
+ export default function createTool() {
135
+ return {
136
+ name: 'folder-create',
137
+ config,
138
+ handler
139
+ };
140
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-drive/src/mcp/tools/folder-create.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\n\nconst inputSchema = z.object({\n name: z.string().trim().min(1).describe('Name for the new folder'),\n parentId: z.string().optional().describe('Parent folder ID (omit to create in My Drive root)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the folder creation operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1 for single folder)'),\n itemsChanged: z.number().describe('Successfully created folders (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: z.string().describe('ID of the created folder'),\n name: z.string().describe('Name of the created folder'),\n webViewLink: z.string().describe('URL to view the folder in Drive'),\n parentId: z.string().optional().describe('ID of the parent folder'),\n parentName: z.string().optional().describe('Name of the parent folder'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n title: 'Create Folder',\n description: 'Create a new folder in Google Drive. Returns folder ID for use in other operations.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\n// Export types for strong typing in tests\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ name: folderName, parentId }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('drive.folder.create called', {\n name: folderName,\n parentId: parentId || 'root',\n });\n\n try {\n const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n // Folder MIME type constant (consistent with folder-search.ts)\n const folderMimeType = 'application/vnd.google-apps.folder';\n\n // Create the folder\n const response = await drive.files.create({\n requestBody: {\n name: folderName,\n mimeType: folderMimeType,\n parents: parentId ? [parentId] : null,\n },\n fields: 'id,name,webViewLink,parents',\n });\n\n const res = response.data;\n const id = res.id ?? '';\n const name = res.name ?? folderName;\n const webViewLink = res.webViewLink ?? '';\n const parents = (res.parents as string[] | undefined) || [];\n\n // Fetch parent name if parentId was provided\n let parentName: string | undefined;\n let actualParentId: string | undefined;\n\n if (parents.length > 0) {\n actualParentId = parents[0];\n\n if (actualParentId === 'root') {\n parentName = 'My Drive';\n } else if (actualParentId) {\n try {\n const parentResponse = await drive.files.get({\n fileId: actualParentId,\n fields: 'name',\n });\n parentName = (parentResponse.data.name as string | undefined) || actualParentId;\n } catch (e) {\n logger.info('Failed to fetch parent name', {\n parentId: actualParentId,\n error: e,\n });\n parentName = actualParentId; // Fallback to ID\n }\n }\n }\n\n const locationSummary = parentName ? ` in \"${parentName}\"` : ' in My Drive';\n\n logger.info('drive.folder.create success', {\n id,\n name,\n parentId: actualParentId,\n });\n\n // Build result object with operation metadata\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Created folder \"${name}\"${locationSummary}`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n id,\n name,\n webViewLink,\n ...(actualParentId && { parentId: actualParentId }),\n ...(parentName && { parentName }),\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('drive.folder.create error', { error: message });\n\n // Throw McpError for proper MCP error handling\n throw new McpError(ErrorCode.InternalError, `Error creating folder: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'folder-create' as const,\n config,\n handler,\n };\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","inputSchema","object","name","string","trim","min","describe","parentId","optional","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","id","webViewLink","parentName","outputSchema","discriminatedUnion","config","title","description","result","handler","folderName","extra","logger","info","res","drive","version","auth","authContext","folderMimeType","response","files","create","requestBody","mimeType","parents","fields","data","actualParentId","length","parentResponse","get","fileId","e","error","locationSummary","Date","toISOString","content","text","JSON","stringify","structuredContent","message","Error","String","InternalError","stack","undefined","createTool"],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ import type { EnrichedExtra } from '@mcp-z/oauth-google';
2
+ import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
3
+ import { z } from 'zod';
4
+ declare const inputSchema: z.ZodObject<{
5
+ folderId: z.ZodString;
6
+ }, z.core.$strip>;
7
+ declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
8
+ type: z.ZodLiteral<"success">;
9
+ path: z.ZodString;
10
+ items: z.ZodArray<z.ZodObject<{
11
+ id: z.ZodString;
12
+ name: z.ZodString;
13
+ }, z.core.$strip>>;
14
+ }, z.core.$strip>, z.ZodObject<{
15
+ type: z.ZodLiteral<"auth_required">;
16
+ provider: z.ZodString;
17
+ message: z.ZodString;
18
+ url: z.ZodOptional<z.ZodString>;
19
+ }, z.core.$strip>], "type">;
20
+ export type Input = z.infer<typeof inputSchema>;
21
+ export type Output = z.infer<typeof outputSchema>;
22
+ declare function handler({ folderId }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
23
+ export default function createTool(): {
24
+ name: "folder-path";
25
+ config: {
26
+ readonly title: "Get Folder Path";
27
+ readonly description: "Get full path from folder to root. Returns human-readable path and items with IDs.";
28
+ readonly inputSchema: z.ZodObject<{
29
+ folderId: z.ZodString;
30
+ }, z.core.$strip>;
31
+ readonly outputSchema: z.ZodObject<{
32
+ result: z.ZodDiscriminatedUnion<[z.ZodObject<{
33
+ type: z.ZodLiteral<"success">;
34
+ path: z.ZodString;
35
+ items: z.ZodArray<z.ZodObject<{
36
+ id: z.ZodString;
37
+ name: z.ZodString;
38
+ }, z.core.$strip>>;
39
+ }, z.core.$strip>, z.ZodObject<{
40
+ type: z.ZodLiteral<"auth_required">;
41
+ provider: z.ZodString;
42
+ message: z.ZodString;
43
+ url: z.ZodOptional<z.ZodString>;
44
+ }, z.core.$strip>], "type">;
45
+ }, z.core.$strip>;
46
+ };
47
+ handler: typeof handler;
48
+ };
49
+ export {};