@mweinbach/apple-docs-mcp 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 (267) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +560 -0
  3. package/dist/constants/browser-headers.d.ts +48 -0
  4. package/dist/constants/browser-headers.d.ts.map +1 -0
  5. package/dist/constants/browser-headers.js +166 -0
  6. package/dist/constants/browser-headers.js.map +1 -0
  7. package/dist/index.d.ts +83 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +215 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/schemas/analyze-api.schema.d.ts +42 -0
  12. package/dist/schemas/analyze-api.schema.d.ts.map +1 -0
  13. package/dist/schemas/analyze-api.schema.js +23 -0
  14. package/dist/schemas/analyze-api.schema.js.map +1 -0
  15. package/dist/schemas/apple-docs.schema.d.ts +18 -0
  16. package/dist/schemas/apple-docs.schema.d.ts.map +1 -0
  17. package/dist/schemas/apple-docs.schema.js +10 -0
  18. package/dist/schemas/apple-docs.schema.js.map +1 -0
  19. package/dist/schemas/doc-content.schema.d.ts +24 -0
  20. package/dist/schemas/doc-content.schema.d.ts.map +1 -0
  21. package/dist/schemas/doc-content.schema.js +10 -0
  22. package/dist/schemas/doc-content.schema.js.map +1 -0
  23. package/dist/schemas/documentation-updates.schema.d.ts +27 -0
  24. package/dist/schemas/documentation-updates.schema.d.ts.map +1 -0
  25. package/dist/schemas/documentation-updates.schema.js +12 -0
  26. package/dist/schemas/documentation-updates.schema.js.map +1 -0
  27. package/dist/schemas/framework-symbols.schema.d.ts +24 -0
  28. package/dist/schemas/framework-symbols.schema.d.ts.map +1 -0
  29. package/dist/schemas/framework-symbols.schema.js +11 -0
  30. package/dist/schemas/framework-symbols.schema.js.map +1 -0
  31. package/dist/schemas/index.d.ts +15 -0
  32. package/dist/schemas/index.d.ts.map +1 -0
  33. package/dist/schemas/index.js +15 -0
  34. package/dist/schemas/index.js.map +1 -0
  35. package/dist/schemas/platform-compatibility.schema.d.ts +18 -0
  36. package/dist/schemas/platform-compatibility.schema.d.ts.map +1 -0
  37. package/dist/schemas/platform-compatibility.schema.js +8 -0
  38. package/dist/schemas/platform-compatibility.schema.js.map +1 -0
  39. package/dist/schemas/references.schema.d.ts +18 -0
  40. package/dist/schemas/references.schema.d.ts.map +1 -0
  41. package/dist/schemas/references.schema.js +9 -0
  42. package/dist/schemas/references.schema.js.map +1 -0
  43. package/dist/schemas/related-apis.schema.d.ts +21 -0
  44. package/dist/schemas/related-apis.schema.d.ts.map +1 -0
  45. package/dist/schemas/related-apis.schema.js +9 -0
  46. package/dist/schemas/related-apis.schema.js.map +1 -0
  47. package/dist/schemas/sample-code.schema.d.ts +21 -0
  48. package/dist/schemas/sample-code.schema.d.ts.map +1 -0
  49. package/dist/schemas/sample-code.schema.js +10 -0
  50. package/dist/schemas/sample-code.schema.js.map +1 -0
  51. package/dist/schemas/search.schema.d.ts +15 -0
  52. package/dist/schemas/search.schema.d.ts.map +1 -0
  53. package/dist/schemas/search.schema.js +8 -0
  54. package/dist/schemas/search.schema.js.map +1 -0
  55. package/dist/schemas/similar-apis.schema.d.ts +21 -0
  56. package/dist/schemas/similar-apis.schema.d.ts.map +1 -0
  57. package/dist/schemas/similar-apis.schema.js +9 -0
  58. package/dist/schemas/similar-apis.schema.js.map +1 -0
  59. package/dist/schemas/technologies.schema.d.ts +21 -0
  60. package/dist/schemas/technologies.schema.d.ts.map +1 -0
  61. package/dist/schemas/technologies.schema.js +10 -0
  62. package/dist/schemas/technologies.schema.js.map +1 -0
  63. package/dist/schemas/technology-overviews.schema.d.ts +24 -0
  64. package/dist/schemas/technology-overviews.schema.d.ts.map +1 -0
  65. package/dist/schemas/technology-overviews.schema.js +11 -0
  66. package/dist/schemas/technology-overviews.schema.js.map +1 -0
  67. package/dist/schemas/wwdc.schemas.d.ts +208 -0
  68. package/dist/schemas/wwdc.schemas.d.ts.map +1 -0
  69. package/dist/schemas/wwdc.schemas.js +97 -0
  70. package/dist/schemas/wwdc.schemas.js.map +1 -0
  71. package/dist/tools/definitions.d.ts +10 -0
  72. package/dist/tools/definitions.d.ts.map +1 -0
  73. package/dist/tools/definitions.js +690 -0
  74. package/dist/tools/definitions.js.map +1 -0
  75. package/dist/tools/doc-fetcher.d.ts +19 -0
  76. package/dist/tools/doc-fetcher.d.ts.map +1 -0
  77. package/dist/tools/doc-fetcher.js +487 -0
  78. package/dist/tools/doc-fetcher.js.map +1 -0
  79. package/dist/tools/doc-formatter.d.ts +69 -0
  80. package/dist/tools/doc-formatter.d.ts.map +1 -0
  81. package/dist/tools/doc-formatter.js +208 -0
  82. package/dist/tools/doc-formatter.js.map +1 -0
  83. package/dist/tools/find-similar-apis.d.ts +5 -0
  84. package/dist/tools/find-similar-apis.d.ts.map +1 -0
  85. package/dist/tools/find-similar-apis.js +275 -0
  86. package/dist/tools/find-similar-apis.js.map +1 -0
  87. package/dist/tools/get-documentation-updates.d.ts +5 -0
  88. package/dist/tools/get-documentation-updates.d.ts.map +1 -0
  89. package/dist/tools/get-documentation-updates.js +244 -0
  90. package/dist/tools/get-documentation-updates.js.map +1 -0
  91. package/dist/tools/get-platform-compatibility.d.ts +5 -0
  92. package/dist/tools/get-platform-compatibility.d.ts.map +1 -0
  93. package/dist/tools/get-platform-compatibility.js +205 -0
  94. package/dist/tools/get-platform-compatibility.js.map +1 -0
  95. package/dist/tools/get-related-apis.d.ts +5 -0
  96. package/dist/tools/get-related-apis.d.ts.map +1 -0
  97. package/dist/tools/get-related-apis.js +155 -0
  98. package/dist/tools/get-related-apis.js.map +1 -0
  99. package/dist/tools/get-sample-code.d.ts +5 -0
  100. package/dist/tools/get-sample-code.d.ts.map +1 -0
  101. package/dist/tools/get-sample-code.js +375 -0
  102. package/dist/tools/get-sample-code.js.map +1 -0
  103. package/dist/tools/get-technology-overviews.d.ts +5 -0
  104. package/dist/tools/get-technology-overviews.d.ts.map +1 -0
  105. package/dist/tools/get-technology-overviews.js +306 -0
  106. package/dist/tools/get-technology-overviews.js.map +1 -0
  107. package/dist/tools/handlers.d.ts +29 -0
  108. package/dist/tools/handlers.d.ts.map +1 -0
  109. package/dist/tools/handlers.js +350 -0
  110. package/dist/tools/handlers.js.map +1 -0
  111. package/dist/tools/list-technologies.d.ts +5 -0
  112. package/dist/tools/list-technologies.d.ts.map +1 -0
  113. package/dist/tools/list-technologies.js +165 -0
  114. package/dist/tools/list-technologies.js.map +1 -0
  115. package/dist/tools/resolve-references-batch.d.ts +5 -0
  116. package/dist/tools/resolve-references-batch.d.ts.map +1 -0
  117. package/dist/tools/resolve-references-batch.js +199 -0
  118. package/dist/tools/resolve-references-batch.js.map +1 -0
  119. package/dist/tools/search-framework-symbols.d.ts +7 -0
  120. package/dist/tools/search-framework-symbols.d.ts.map +1 -0
  121. package/dist/tools/search-framework-symbols.js +235 -0
  122. package/dist/tools/search-framework-symbols.js.map +1 -0
  123. package/dist/tools/search-parser.d.ts +15 -0
  124. package/dist/tools/search-parser.d.ts.map +1 -0
  125. package/dist/tools/search-parser.js +188 -0
  126. package/dist/tools/search-parser.js.map +1 -0
  127. package/dist/tools/search-result-parser.d.ts +52 -0
  128. package/dist/tools/search-result-parser.d.ts.map +1 -0
  129. package/dist/tools/search-result-parser.js +137 -0
  130. package/dist/tools/search-result-parser.js.map +1 -0
  131. package/dist/tools/tools-guide.d.ts +124 -0
  132. package/dist/tools/tools-guide.d.ts.map +1 -0
  133. package/dist/tools/tools-guide.js +389 -0
  134. package/dist/tools/tools-guide.js.map +1 -0
  135. package/dist/tools/wwdc/content-extractor.d.ts +9 -0
  136. package/dist/tools/wwdc/content-extractor.d.ts.map +1 -0
  137. package/dist/tools/wwdc/content-extractor.js +520 -0
  138. package/dist/tools/wwdc/content-extractor.js.map +1 -0
  139. package/dist/tools/wwdc/topics-extractor.d.ts +32 -0
  140. package/dist/tools/wwdc/topics-extractor.d.ts.map +1 -0
  141. package/dist/tools/wwdc/topics-extractor.js +146 -0
  142. package/dist/tools/wwdc/topics-extractor.js.map +1 -0
  143. package/dist/tools/wwdc/video-list-extractor.d.ts +13 -0
  144. package/dist/tools/wwdc/video-list-extractor.d.ts.map +1 -0
  145. package/dist/tools/wwdc/video-list-extractor.js +238 -0
  146. package/dist/tools/wwdc/video-list-extractor.js.map +1 -0
  147. package/dist/tools/wwdc/wwdc-handlers.d.ts +32 -0
  148. package/dist/tools/wwdc/wwdc-handlers.d.ts.map +1 -0
  149. package/dist/tools/wwdc/wwdc-handlers.js +791 -0
  150. package/dist/tools/wwdc/wwdc-handlers.js.map +1 -0
  151. package/dist/types/apple-docs.d.ts +112 -0
  152. package/dist/types/apple-docs.d.ts.map +1 -0
  153. package/dist/types/apple-docs.js +5 -0
  154. package/dist/types/apple-docs.js.map +1 -0
  155. package/dist/types/cache.d.ts +28 -0
  156. package/dist/types/cache.d.ts.map +1 -0
  157. package/dist/types/cache.js +5 -0
  158. package/dist/types/cache.js.map +1 -0
  159. package/dist/types/content-sections.d.ts +37 -0
  160. package/dist/types/content-sections.d.ts.map +1 -0
  161. package/dist/types/content-sections.js +5 -0
  162. package/dist/types/content-sections.js.map +1 -0
  163. package/dist/types/error.d.ts +39 -0
  164. package/dist/types/error.d.ts.map +1 -0
  165. package/dist/types/error.js +21 -0
  166. package/dist/types/error.js.map +1 -0
  167. package/dist/types/headers.d.ts +95 -0
  168. package/dist/types/headers.d.ts.map +1 -0
  169. package/dist/types/headers.js +5 -0
  170. package/dist/types/headers.js.map +1 -0
  171. package/dist/types/http.d.ts +31 -0
  172. package/dist/types/http.d.ts.map +1 -0
  173. package/dist/types/http.js +5 -0
  174. package/dist/types/http.js.map +1 -0
  175. package/dist/types/index.d.ts +11 -0
  176. package/dist/types/index.d.ts.map +1 -0
  177. package/dist/types/index.js +12 -0
  178. package/dist/types/index.js.map +1 -0
  179. package/dist/types/search.d.ts +62 -0
  180. package/dist/types/search.d.ts.map +1 -0
  181. package/dist/types/search.js +5 -0
  182. package/dist/types/search.js.map +1 -0
  183. package/dist/types/sections.d.ts +64 -0
  184. package/dist/types/sections.d.ts.map +1 -0
  185. package/dist/types/sections.js +5 -0
  186. package/dist/types/sections.js.map +1 -0
  187. package/dist/types/tools/platform.d.ts +33 -0
  188. package/dist/types/tools/platform.d.ts.map +1 -0
  189. package/dist/types/tools/platform.js +5 -0
  190. package/dist/types/tools/platform.js.map +1 -0
  191. package/dist/types/tools/sample-code.d.ts +23 -0
  192. package/dist/types/tools/sample-code.d.ts.map +1 -0
  193. package/dist/types/tools/sample-code.js +5 -0
  194. package/dist/types/tools/sample-code.js.map +1 -0
  195. package/dist/types/tools/technology.d.ts +18 -0
  196. package/dist/types/tools/technology.d.ts.map +1 -0
  197. package/dist/types/tools/technology.js +5 -0
  198. package/dist/types/tools/technology.js.map +1 -0
  199. package/dist/types/tools/updates.d.ts +23 -0
  200. package/dist/types/tools/updates.d.ts.map +1 -0
  201. package/dist/types/tools/updates.js +5 -0
  202. package/dist/types/tools/updates.js.map +1 -0
  203. package/dist/types/wwdc.d.ts +200 -0
  204. package/dist/types/wwdc.d.ts.map +1 -0
  205. package/dist/types/wwdc.js +5 -0
  206. package/dist/types/wwdc.js.map +1 -0
  207. package/dist/utils/cache-warmer.d.ts +22 -0
  208. package/dist/utils/cache-warmer.d.ts.map +1 -0
  209. package/dist/utils/cache-warmer.js +115 -0
  210. package/dist/utils/cache-warmer.js.map +1 -0
  211. package/dist/utils/cache.d.ts +109 -0
  212. package/dist/utils/cache.d.ts.map +1 -0
  213. package/dist/utils/cache.js +302 -0
  214. package/dist/utils/cache.js.map +1 -0
  215. package/dist/utils/constants.d.ts +178 -0
  216. package/dist/utils/constants.d.ts.map +1 -0
  217. package/dist/utils/constants.js +266 -0
  218. package/dist/utils/constants.js.map +1 -0
  219. package/dist/utils/error-handler.d.ts +80 -0
  220. package/dist/utils/error-handler.d.ts.map +1 -0
  221. package/dist/utils/error-handler.js +437 -0
  222. package/dist/utils/error-handler.js.map +1 -0
  223. package/dist/utils/framework-mapper.d.ts +84 -0
  224. package/dist/utils/framework-mapper.d.ts.map +1 -0
  225. package/dist/utils/framework-mapper.js +534 -0
  226. package/dist/utils/framework-mapper.js.map +1 -0
  227. package/dist/utils/http-client.d.ts +130 -0
  228. package/dist/utils/http-client.d.ts.map +1 -0
  229. package/dist/utils/http-client.js +464 -0
  230. package/dist/utils/http-client.js.map +1 -0
  231. package/dist/utils/http-headers-generator.d.ts +151 -0
  232. package/dist/utils/http-headers-generator.d.ts.map +1 -0
  233. package/dist/utils/http-headers-generator.js +407 -0
  234. package/dist/utils/http-headers-generator.js.map +1 -0
  235. package/dist/utils/logger.d.ts +44 -0
  236. package/dist/utils/logger.d.ts.map +1 -0
  237. package/dist/utils/logger.js +73 -0
  238. package/dist/utils/logger.js.map +1 -0
  239. package/dist/utils/preloader.d.ts +20 -0
  240. package/dist/utils/preloader.d.ts.map +1 -0
  241. package/dist/utils/preloader.js +82 -0
  242. package/dist/utils/preloader.js.map +1 -0
  243. package/dist/utils/rate-limiter.d.ts +28 -0
  244. package/dist/utils/rate-limiter.d.ts.map +1 -0
  245. package/dist/utils/rate-limiter.js +48 -0
  246. package/dist/utils/rate-limiter.js.map +1 -0
  247. package/dist/utils/topic-mapper.d.ts +18 -0
  248. package/dist/utils/topic-mapper.d.ts.map +1 -0
  249. package/dist/utils/topic-mapper.js +182 -0
  250. package/dist/utils/topic-mapper.js.map +1 -0
  251. package/dist/utils/url-converter.d.ts +22 -0
  252. package/dist/utils/url-converter.d.ts.map +1 -0
  253. package/dist/utils/url-converter.js +70 -0
  254. package/dist/utils/url-converter.js.map +1 -0
  255. package/dist/utils/user-agent-pool.d.ts +241 -0
  256. package/dist/utils/user-agent-pool.d.ts.map +1 -0
  257. package/dist/utils/user-agent-pool.js +557 -0
  258. package/dist/utils/user-agent-pool.js.map +1 -0
  259. package/dist/utils/wwdc-data-source-path.d.ts +9 -0
  260. package/dist/utils/wwdc-data-source-path.d.ts.map +1 -0
  261. package/dist/utils/wwdc-data-source-path.js +22 -0
  262. package/dist/utils/wwdc-data-source-path.js.map +1 -0
  263. package/dist/utils/wwdc-data-source.d.ts +36 -0
  264. package/dist/utils/wwdc-data-source.d.ts.map +1 -0
  265. package/dist/utils/wwdc-data-source.js +133 -0
  266. package/dist/utils/wwdc-data-source.js.map +1 -0
  267. package/package.json +83 -0
@@ -0,0 +1,208 @@
1
+ /**
2
+ * Zod schemas for WWDC tools
3
+ */
4
+ import { z } from 'zod';
5
+ /**
6
+ * Schema for list_wwdc_videos
7
+ */
8
+ export declare const listWWDCVideosSchema: z.ZodObject<{
9
+ year: z.ZodOptional<z.ZodString>;
10
+ topic: z.ZodOptional<z.ZodString>;
11
+ hasCode: z.ZodOptional<z.ZodBoolean>;
12
+ limit: z.ZodDefault<z.ZodNumber>;
13
+ compact: z.ZodDefault<z.ZodBoolean>;
14
+ }, "strip", z.ZodTypeAny, {
15
+ limit: number;
16
+ compact: boolean;
17
+ year?: string | undefined;
18
+ topic?: string | undefined;
19
+ hasCode?: boolean | undefined;
20
+ }, {
21
+ limit?: number | undefined;
22
+ compact?: boolean | undefined;
23
+ year?: string | undefined;
24
+ topic?: string | undefined;
25
+ hasCode?: boolean | undefined;
26
+ }>;
27
+ /**
28
+ * Schema for search_wwdc_content
29
+ */
30
+ export declare const searchWWDCContentSchema: z.ZodObject<{
31
+ query: z.ZodString;
32
+ searchIn: z.ZodDefault<z.ZodEnum<["transcript", "code", "both"]>>;
33
+ year: z.ZodOptional<z.ZodString>;
34
+ language: z.ZodOptional<z.ZodString>;
35
+ limit: z.ZodDefault<z.ZodNumber>;
36
+ compact: z.ZodDefault<z.ZodBoolean>;
37
+ }, "strip", z.ZodTypeAny, {
38
+ limit: number;
39
+ compact: boolean;
40
+ query: string;
41
+ searchIn: "code" | "transcript" | "both";
42
+ language?: string | undefined;
43
+ year?: string | undefined;
44
+ }, {
45
+ query: string;
46
+ limit?: number | undefined;
47
+ compact?: boolean | undefined;
48
+ language?: string | undefined;
49
+ year?: string | undefined;
50
+ searchIn?: "code" | "transcript" | "both" | undefined;
51
+ }>;
52
+ /**
53
+ * Schema for get_wwdc_video
54
+ */
55
+ export declare const getWWDCVideoSchema: z.ZodObject<{
56
+ year: z.ZodString;
57
+ videoId: z.ZodString;
58
+ includeTranscript: z.ZodDefault<z.ZodBoolean>;
59
+ includeCode: z.ZodDefault<z.ZodBoolean>;
60
+ }, "strip", z.ZodTypeAny, {
61
+ year: string;
62
+ videoId: string;
63
+ includeTranscript: boolean;
64
+ includeCode: boolean;
65
+ }, {
66
+ year: string;
67
+ videoId: string;
68
+ includeTranscript?: boolean | undefined;
69
+ includeCode?: boolean | undefined;
70
+ }>;
71
+ /**
72
+ * Schema for get_wwdc_code_examples
73
+ */
74
+ export declare const getWWDCCodeExamplesSchema: z.ZodObject<{
75
+ framework: z.ZodOptional<z.ZodString>;
76
+ topic: z.ZodOptional<z.ZodString>;
77
+ year: z.ZodOptional<z.ZodString>;
78
+ language: z.ZodOptional<z.ZodString>;
79
+ limit: z.ZodDefault<z.ZodNumber>;
80
+ compact: z.ZodDefault<z.ZodBoolean>;
81
+ }, "strip", z.ZodTypeAny, {
82
+ limit: number;
83
+ compact: boolean;
84
+ framework?: string | undefined;
85
+ language?: string | undefined;
86
+ year?: string | undefined;
87
+ topic?: string | undefined;
88
+ }, {
89
+ framework?: string | undefined;
90
+ limit?: number | undefined;
91
+ compact?: boolean | undefined;
92
+ language?: string | undefined;
93
+ year?: string | undefined;
94
+ topic?: string | undefined;
95
+ }>;
96
+ /**
97
+ * Schema for browse_wwdc_topics
98
+ */
99
+ export declare const browseWWDCTopicsSchema: z.ZodObject<{
100
+ topicId: z.ZodOptional<z.ZodString>;
101
+ includeVideos: z.ZodDefault<z.ZodBoolean>;
102
+ year: z.ZodOptional<z.ZodString>;
103
+ limit: z.ZodDefault<z.ZodNumber>;
104
+ compact: z.ZodDefault<z.ZodBoolean>;
105
+ }, "strip", z.ZodTypeAny, {
106
+ limit: number;
107
+ compact: boolean;
108
+ includeVideos: boolean;
109
+ year?: string | undefined;
110
+ topicId?: string | undefined;
111
+ }, {
112
+ limit?: number | undefined;
113
+ compact?: boolean | undefined;
114
+ year?: string | undefined;
115
+ includeVideos?: boolean | undefined;
116
+ topicId?: string | undefined;
117
+ }>;
118
+ /**
119
+ * Schema for find_related_wwdc_videos
120
+ */
121
+ export declare const findRelatedWWDCVideosSchema: z.ZodObject<{
122
+ videoId: z.ZodString;
123
+ year: z.ZodString;
124
+ includeExplicitRelated: z.ZodDefault<z.ZodBoolean>;
125
+ includeTopicRelated: z.ZodDefault<z.ZodBoolean>;
126
+ includeYearRelated: z.ZodDefault<z.ZodBoolean>;
127
+ limit: z.ZodDefault<z.ZodNumber>;
128
+ compact: z.ZodDefault<z.ZodBoolean>;
129
+ }, "strip", z.ZodTypeAny, {
130
+ limit: number;
131
+ compact: boolean;
132
+ year: string;
133
+ videoId: string;
134
+ includeExplicitRelated: boolean;
135
+ includeTopicRelated: boolean;
136
+ includeYearRelated: boolean;
137
+ }, {
138
+ year: string;
139
+ videoId: string;
140
+ limit?: number | undefined;
141
+ compact?: boolean | undefined;
142
+ includeExplicitRelated?: boolean | undefined;
143
+ includeTopicRelated?: boolean | undefined;
144
+ includeYearRelated?: boolean | undefined;
145
+ }>;
146
+ /**
147
+ * Schema for list_wwdc_years
148
+ */
149
+ export declare const listWWDCYearsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
150
+ /**
151
+ * Unified WWDC tool schema
152
+ */
153
+ export declare const wwdcSchema: z.ZodObject<{
154
+ action: z.ZodEnum<["list", "search", "get", "code", "topics", "related", "years"]>;
155
+ year: z.ZodOptional<z.ZodString>;
156
+ videoId: z.ZodOptional<z.ZodString>;
157
+ query: z.ZodOptional<z.ZodString>;
158
+ topic: z.ZodOptional<z.ZodString>;
159
+ framework: z.ZodOptional<z.ZodString>;
160
+ limit: z.ZodOptional<z.ZodNumber>;
161
+ compact: z.ZodDefault<z.ZodBoolean>;
162
+ searchIn: z.ZodOptional<z.ZodEnum<["transcript", "code", "both"]>>;
163
+ hasCode: z.ZodOptional<z.ZodBoolean>;
164
+ includeTranscript: z.ZodOptional<z.ZodBoolean>;
165
+ includeCode: z.ZodOptional<z.ZodBoolean>;
166
+ includeVideos: z.ZodOptional<z.ZodBoolean>;
167
+ includeExplicitRelated: z.ZodOptional<z.ZodBoolean>;
168
+ includeTopicRelated: z.ZodOptional<z.ZodBoolean>;
169
+ includeYearRelated: z.ZodOptional<z.ZodBoolean>;
170
+ language: z.ZodOptional<z.ZodString>;
171
+ }, "strip", z.ZodTypeAny, {
172
+ compact: boolean;
173
+ action: "search" | "related" | "years" | "list" | "get" | "code" | "topics";
174
+ framework?: string | undefined;
175
+ limit?: number | undefined;
176
+ language?: string | undefined;
177
+ query?: string | undefined;
178
+ year?: string | undefined;
179
+ videoId?: string | undefined;
180
+ topic?: string | undefined;
181
+ searchIn?: "code" | "transcript" | "both" | undefined;
182
+ hasCode?: boolean | undefined;
183
+ includeTranscript?: boolean | undefined;
184
+ includeCode?: boolean | undefined;
185
+ includeVideos?: boolean | undefined;
186
+ includeExplicitRelated?: boolean | undefined;
187
+ includeTopicRelated?: boolean | undefined;
188
+ includeYearRelated?: boolean | undefined;
189
+ }, {
190
+ action: "search" | "related" | "years" | "list" | "get" | "code" | "topics";
191
+ framework?: string | undefined;
192
+ limit?: number | undefined;
193
+ compact?: boolean | undefined;
194
+ language?: string | undefined;
195
+ query?: string | undefined;
196
+ year?: string | undefined;
197
+ videoId?: string | undefined;
198
+ topic?: string | undefined;
199
+ searchIn?: "code" | "transcript" | "both" | undefined;
200
+ hasCode?: boolean | undefined;
201
+ includeTranscript?: boolean | undefined;
202
+ includeCode?: boolean | undefined;
203
+ includeVideos?: boolean | undefined;
204
+ includeExplicitRelated?: boolean | undefined;
205
+ includeTopicRelated?: boolean | undefined;
206
+ includeYearRelated?: boolean | undefined;
207
+ }>;
208
+ //# sourceMappingURL=wwdc.schemas.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wwdc.schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/wwdc.schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAOlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;EAOpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,gDAAe,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBrB,CAAC"}
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Zod schemas for WWDC tools
3
+ */
4
+ import { z } from 'zod';
5
+ import { WWDC_CONFIG } from '../utils/constants.js';
6
+ /**
7
+ * Schema for list_wwdc_videos
8
+ */
9
+ export const listWWDCVideosSchema = z.object({
10
+ year: z.string().optional().describe('Filter by WWDC year'),
11
+ topic: z.string().optional().describe('Filter by topic keyword'),
12
+ hasCode: z.boolean().optional().describe('Filter by code availability'),
13
+ limit: z.number().min(1).max(WWDC_CONFIG.MAX_VIDEO_LIMIT).default(WWDC_CONFIG.DEFAULT_VIDEO_LIMIT).describe('Maximum number of videos'),
14
+ compact: z.boolean().default(false).describe('Return minimal output (titles + URLs only). Recommended for discovery.'),
15
+ });
16
+ /**
17
+ * Schema for search_wwdc_content
18
+ */
19
+ export const searchWWDCContentSchema = z.object({
20
+ query: z.string().min(1).describe('Search query'),
21
+ searchIn: z.enum(['transcript', 'code', 'both']).default('both').describe('Where to search'),
22
+ year: z.string().optional().describe('Filter by WWDC year'),
23
+ language: z.string().optional().describe('Filter code by language'),
24
+ limit: z.number().min(1).max(WWDC_CONFIG.MAX_SEARCH_LIMIT).default(WWDC_CONFIG.DEFAULT_SEARCH_LIMIT).describe('Maximum number of results'),
25
+ compact: z.boolean().default(false).describe('Return minimal output (titles + URLs only). Recommended for discovery.'),
26
+ });
27
+ /**
28
+ * Schema for get_wwdc_video
29
+ */
30
+ export const getWWDCVideoSchema = z.object({
31
+ year: z.string().describe('WWDC year'),
32
+ videoId: z.string().describe('Video ID'),
33
+ includeTranscript: z.boolean().default(true).describe('Include transcript'),
34
+ includeCode: z.boolean().default(true).describe('Include code examples'),
35
+ });
36
+ /**
37
+ * Schema for get_wwdc_code_examples
38
+ */
39
+ export const getWWDCCodeExamplesSchema = z.object({
40
+ framework: z.string().optional().describe('Filter by framework'),
41
+ topic: z.string().optional().describe('Filter by topic'),
42
+ year: z.string().optional().describe('Filter by WWDC year'),
43
+ language: z.string().optional().describe('Filter by programming language'),
44
+ limit: z.number().min(1).max(WWDC_CONFIG.MAX_CODE_EXAMPLES_LIMIT).default(WWDC_CONFIG.DEFAULT_CODE_EXAMPLES_LIMIT).describe('Maximum number of examples'),
45
+ compact: z.boolean().default(false).describe('Return minimal output (titles + URLs only). Recommended for discovery.'),
46
+ });
47
+ /**
48
+ * Schema for browse_wwdc_topics
49
+ */
50
+ export const browseWWDCTopicsSchema = z.object({
51
+ topicId: z.string().optional().describe('Specific topic ID to browse'),
52
+ includeVideos: z.boolean().default(true).describe('Include video list'),
53
+ year: z.string().optional().describe('Filter videos by year'),
54
+ limit: z.number().min(1).max(WWDC_CONFIG.MAX_TOPIC_VIDEOS_LIMIT).default(WWDC_CONFIG.DEFAULT_TOPIC_VIDEOS_LIMIT).describe('Maximum number of videos per topic'),
55
+ compact: z.boolean().default(false).describe('Return minimal output (titles + URLs only). Recommended for discovery.'),
56
+ });
57
+ /**
58
+ * Schema for find_related_wwdc_videos
59
+ */
60
+ export const findRelatedWWDCVideosSchema = z.object({
61
+ videoId: z.string().describe('Video ID to find related videos for'),
62
+ year: z.string().describe('Year of the source video'),
63
+ includeExplicitRelated: z.boolean().default(true).describe('Include explicitly related videos'),
64
+ includeTopicRelated: z.boolean().default(true).describe('Include videos from same topics'),
65
+ includeYearRelated: z.boolean().default(false).describe('Include videos from same year'),
66
+ limit: z.number().min(1).max(WWDC_CONFIG.MAX_RELATED_VIDEOS_LIMIT).default(WWDC_CONFIG.DEFAULT_RELATED_VIDEOS_LIMIT).describe('Maximum number of related videos'),
67
+ compact: z.boolean().default(false).describe('Return minimal output (titles + URLs only). Recommended for discovery.'),
68
+ });
69
+ /**
70
+ * Schema for list_wwdc_years
71
+ */
72
+ export const listWWDCYearsSchema = z.object({});
73
+ /**
74
+ * Unified WWDC tool schema
75
+ */
76
+ export const wwdcSchema = z.object({
77
+ action: z.enum(['list', 'search', 'get', 'code', 'topics', 'related', 'years']).describe('Action to perform: list (browse videos), search (full-text search), get (video details), code (code examples), topics (browse topics), related (find related), years (list years)'),
78
+ // Common params
79
+ year: z.string().optional().describe('WWDC year (e.g., "2024", "2025")'),
80
+ videoId: z.string().optional().describe('Video ID (for get/related actions)'),
81
+ query: z.string().optional().describe('Search query (for search action)'),
82
+ topic: z.string().optional().describe('Topic filter'),
83
+ framework: z.string().optional().describe('Framework filter (for code action)'),
84
+ limit: z.number().min(1).max(WWDC_CONFIG.MAX_VIDEO_LIMIT).optional().describe('Max results'),
85
+ compact: z.boolean().default(false).describe('Return minimal output (titles + URLs only). Recommended for discovery.'),
86
+ // Action-specific
87
+ searchIn: z.enum(['transcript', 'code', 'both']).optional().describe('Search scope (for search action)'),
88
+ hasCode: z.boolean().optional().describe('Filter by code availability (for list action)'),
89
+ includeTranscript: z.boolean().optional().describe('Include transcript (for get action)'),
90
+ includeCode: z.boolean().optional().describe('Include code examples (for get action)'),
91
+ includeVideos: z.boolean().optional().describe('Include videos in topic (for topics action)'),
92
+ includeExplicitRelated: z.boolean().optional().describe('Include explicitly related videos (for related action)'),
93
+ includeTopicRelated: z.boolean().optional().describe('Include topic-related videos (for related action)'),
94
+ includeYearRelated: z.boolean().optional().describe('Include same-year videos (for related action)'),
95
+ language: z.string().optional().describe('Filter code by language'),
96
+ });
97
+ //# sourceMappingURL=wwdc.schemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wwdc.schemas.js","sourceRoot":"","sources":["../../src/schemas/wwdc.schemas.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Tool definitions for Apple Developer Documentation MCP Server
3
+ * Optimized for agent context windows with compact output support
4
+ */
5
+ import type { Tool } from '@modelcontextprotocol/sdk/types.js';
6
+ /**
7
+ * All available tools
8
+ */
9
+ export declare const toolDefinitions: Tool[];
10
+ //# sourceMappingURL=definitions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI/D;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,IAAI,EAyqBjC,CAAC"}