notelm-mcp 1.2.1

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 (323) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +456 -0
  3. package/dist/auth/auth-manager.d.ts +139 -0
  4. package/dist/auth/auth-manager.d.ts.map +1 -0
  5. package/dist/auth/auth-manager.js +960 -0
  6. package/dist/auth/auth-manager.js.map +1 -0
  7. package/dist/config.d.ts +92 -0
  8. package/dist/config.d.ts.map +1 -0
  9. package/dist/config.js +219 -0
  10. package/dist/config.js.map +1 -0
  11. package/dist/constants.d.ts +58 -0
  12. package/dist/constants.d.ts.map +1 -0
  13. package/dist/constants.js +133 -0
  14. package/dist/constants.js.map +1 -0
  15. package/dist/errors.d.ts +26 -0
  16. package/dist/errors.d.ts.map +1 -0
  17. package/dist/errors.js +41 -0
  18. package/dist/errors.js.map +1 -0
  19. package/dist/index.d.ts +32 -0
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/index.js +325 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/library/notebook-library.d.ts +70 -0
  24. package/dist/library/notebook-library.d.ts.map +1 -0
  25. package/dist/library/notebook-library.js +279 -0
  26. package/dist/library/notebook-library.js.map +1 -0
  27. package/dist/library/types.d.ts +67 -0
  28. package/dist/library/types.d.ts.map +1 -0
  29. package/dist/library/types.js +8 -0
  30. package/dist/library/types.js.map +1 -0
  31. package/dist/playwright.config.d.ts +3 -0
  32. package/dist/playwright.config.d.ts.map +1 -0
  33. package/dist/playwright.config.js +38 -0
  34. package/dist/playwright.config.js.map +1 -0
  35. package/dist/resources/resource-handlers.d.ts +22 -0
  36. package/dist/resources/resource-handlers.d.ts.map +1 -0
  37. package/dist/resources/resource-handlers.js +216 -0
  38. package/dist/resources/resource-handlers.js.map +1 -0
  39. package/dist/scripts/save-auth-state.d.ts +2 -0
  40. package/dist/scripts/save-auth-state.d.ts.map +1 -0
  41. package/dist/scripts/save-auth-state.js +91 -0
  42. package/dist/scripts/save-auth-state.js.map +1 -0
  43. package/dist/session/browser-session.d.ts +108 -0
  44. package/dist/session/browser-session.d.ts.map +1 -0
  45. package/dist/session/browser-session.js +636 -0
  46. package/dist/session/browser-session.js.map +1 -0
  47. package/dist/session/session-manager.d.ts +76 -0
  48. package/dist/session/session-manager.d.ts.map +1 -0
  49. package/dist/session/session-manager.js +273 -0
  50. package/dist/session/session-manager.js.map +1 -0
  51. package/dist/session/shared-context-manager.d.ts +107 -0
  52. package/dist/session/shared-context-manager.d.ts.map +1 -0
  53. package/dist/session/shared-context-manager.js +447 -0
  54. package/dist/session/shared-context-manager.js.map +1 -0
  55. package/dist/src/auth/auth-manager.d.ts +139 -0
  56. package/dist/src/auth/auth-manager.d.ts.map +1 -0
  57. package/dist/src/auth/auth-manager.js +960 -0
  58. package/dist/src/auth/auth-manager.js.map +1 -0
  59. package/dist/src/config.d.ts +92 -0
  60. package/dist/src/config.d.ts.map +1 -0
  61. package/dist/src/config.js +219 -0
  62. package/dist/src/config.js.map +1 -0
  63. package/dist/src/constants.d.ts +58 -0
  64. package/dist/src/constants.d.ts.map +1 -0
  65. package/dist/src/constants.js +133 -0
  66. package/dist/src/constants.js.map +1 -0
  67. package/dist/src/errors.d.ts +26 -0
  68. package/dist/src/errors.d.ts.map +1 -0
  69. package/dist/src/errors.js +41 -0
  70. package/dist/src/errors.js.map +1 -0
  71. package/dist/src/index.d.ts +32 -0
  72. package/dist/src/index.d.ts.map +1 -0
  73. package/dist/src/index.js +325 -0
  74. package/dist/src/index.js.map +1 -0
  75. package/dist/src/library/notebook-library.d.ts +70 -0
  76. package/dist/src/library/notebook-library.d.ts.map +1 -0
  77. package/dist/src/library/notebook-library.js +279 -0
  78. package/dist/src/library/notebook-library.js.map +1 -0
  79. package/dist/src/library/types.d.ts +67 -0
  80. package/dist/src/library/types.d.ts.map +1 -0
  81. package/dist/src/library/types.js +8 -0
  82. package/dist/src/library/types.js.map +1 -0
  83. package/dist/src/resources/resource-handlers.d.ts +22 -0
  84. package/dist/src/resources/resource-handlers.d.ts.map +1 -0
  85. package/dist/src/resources/resource-handlers.js +216 -0
  86. package/dist/src/resources/resource-handlers.js.map +1 -0
  87. package/dist/src/scripts/health-check.d.ts +13 -0
  88. package/dist/src/scripts/health-check.d.ts.map +1 -0
  89. package/dist/src/scripts/health-check.js +100 -0
  90. package/dist/src/scripts/health-check.js.map +1 -0
  91. package/dist/src/session/browser-session.d.ts +108 -0
  92. package/dist/src/session/browser-session.d.ts.map +1 -0
  93. package/dist/src/session/browser-session.js +642 -0
  94. package/dist/src/session/browser-session.js.map +1 -0
  95. package/dist/src/session/session-manager.d.ts +76 -0
  96. package/dist/src/session/session-manager.d.ts.map +1 -0
  97. package/dist/src/session/session-manager.js +273 -0
  98. package/dist/src/session/session-manager.js.map +1 -0
  99. package/dist/src/session/shared-context-manager.d.ts +107 -0
  100. package/dist/src/session/shared-context-manager.d.ts.map +1 -0
  101. package/dist/src/session/shared-context-manager.js +447 -0
  102. package/dist/src/session/shared-context-manager.js.map +1 -0
  103. package/dist/src/tools/definitions/ask-question.d.ts +8 -0
  104. package/dist/src/tools/definitions/ask-question.d.ts.map +1 -0
  105. package/dist/src/tools/definitions/ask-question.js +211 -0
  106. package/dist/src/tools/definitions/ask-question.js.map +1 -0
  107. package/dist/src/tools/definitions/notebook-management.d.ts +3 -0
  108. package/dist/src/tools/definitions/notebook-management.d.ts.map +1 -0
  109. package/dist/src/tools/definitions/notebook-management.js +243 -0
  110. package/dist/src/tools/definitions/notebook-management.js.map +1 -0
  111. package/dist/src/tools/definitions/session-management.d.ts +3 -0
  112. package/dist/src/tools/definitions/session-management.d.ts.map +1 -0
  113. package/dist/src/tools/definitions/session-management.js +41 -0
  114. package/dist/src/tools/definitions/session-management.js.map +1 -0
  115. package/dist/src/tools/definitions/system.d.ts +3 -0
  116. package/dist/src/tools/definitions/system.d.ts.map +1 -0
  117. package/dist/src/tools/definitions/system.js +143 -0
  118. package/dist/src/tools/definitions/system.js.map +1 -0
  119. package/dist/src/tools/definitions.d.ts +12 -0
  120. package/dist/src/tools/definitions.d.ts.map +1 -0
  121. package/dist/src/tools/definitions.js +26 -0
  122. package/dist/src/tools/definitions.js.map +1 -0
  123. package/dist/src/tools/handlers.d.ts +212 -0
  124. package/dist/src/tools/handlers.d.ts.map +1 -0
  125. package/dist/src/tools/handlers.js +712 -0
  126. package/dist/src/tools/handlers.js.map +1 -0
  127. package/dist/src/tools/index.d.ts +8 -0
  128. package/dist/src/tools/index.d.ts.map +1 -0
  129. package/dist/src/tools/index.js +8 -0
  130. package/dist/src/tools/index.js.map +1 -0
  131. package/dist/src/types.d.ts +88 -0
  132. package/dist/src/types.d.ts.map +1 -0
  133. package/dist/src/types.js +5 -0
  134. package/dist/src/types.js.map +1 -0
  135. package/dist/src/utils/auth-manager.d.ts +2 -0
  136. package/dist/src/utils/auth-manager.d.ts.map +1 -0
  137. package/dist/src/utils/auth-manager.js +25 -0
  138. package/dist/src/utils/auth-manager.js.map +1 -0
  139. package/dist/src/utils/cleanup-manager.d.ts +133 -0
  140. package/dist/src/utils/cleanup-manager.d.ts.map +1 -0
  141. package/dist/src/utils/cleanup-manager.js +673 -0
  142. package/dist/src/utils/cleanup-manager.js.map +1 -0
  143. package/dist/src/utils/cli-handler.d.ts +16 -0
  144. package/dist/src/utils/cli-handler.d.ts.map +1 -0
  145. package/dist/src/utils/cli-handler.js +102 -0
  146. package/dist/src/utils/cli-handler.js.map +1 -0
  147. package/dist/src/utils/logger.d.ts +61 -0
  148. package/dist/src/utils/logger.d.ts.map +1 -0
  149. package/dist/src/utils/logger.js +92 -0
  150. package/dist/src/utils/logger.js.map +1 -0
  151. package/dist/src/utils/page-utils.d.ts +54 -0
  152. package/dist/src/utils/page-utils.d.ts.map +1 -0
  153. package/dist/src/utils/page-utils.js +381 -0
  154. package/dist/src/utils/page-utils.js.map +1 -0
  155. package/dist/src/utils/rate-limit-handler.d.ts +42 -0
  156. package/dist/src/utils/rate-limit-handler.d.ts.map +1 -0
  157. package/dist/src/utils/rate-limit-handler.js +88 -0
  158. package/dist/src/utils/rate-limit-handler.js.map +1 -0
  159. package/dist/src/utils/rate-limit-handler.test.d.ts +7 -0
  160. package/dist/src/utils/rate-limit-handler.test.d.ts.map +1 -0
  161. package/dist/src/utils/rate-limit-handler.test.js +86 -0
  162. package/dist/src/utils/rate-limit-handler.test.js.map +1 -0
  163. package/dist/src/utils/settings-manager.d.ts +37 -0
  164. package/dist/src/utils/settings-manager.d.ts.map +1 -0
  165. package/dist/src/utils/settings-manager.js +121 -0
  166. package/dist/src/utils/settings-manager.js.map +1 -0
  167. package/dist/src/utils/stealth-utils.d.ts +135 -0
  168. package/dist/src/utils/stealth-utils.d.ts.map +1 -0
  169. package/dist/src/utils/stealth-utils.js +396 -0
  170. package/dist/src/utils/stealth-utils.js.map +1 -0
  171. package/dist/src/utils/stealth-utils.test.d.ts +7 -0
  172. package/dist/src/utils/stealth-utils.test.d.ts.map +1 -0
  173. package/dist/src/utils/stealth-utils.test.js +72 -0
  174. package/dist/src/utils/stealth-utils.test.js.map +1 -0
  175. package/dist/tests/e2e/authenticated.spec.d.ts +2 -0
  176. package/dist/tests/e2e/authenticated.spec.d.ts.map +1 -0
  177. package/dist/tests/e2e/authenticated.spec.js +41 -0
  178. package/dist/tests/e2e/authenticated.spec.js.map +1 -0
  179. package/dist/tests/e2e/mocked.spec.d.ts +2 -0
  180. package/dist/tests/e2e/mocked.spec.d.ts.map +1 -0
  181. package/dist/tests/e2e/mocked.spec.js +32 -0
  182. package/dist/tests/e2e/mocked.spec.js.map +1 -0
  183. package/dist/tests/mocks/handlers.d.ts +4 -0
  184. package/dist/tests/mocks/handlers.d.ts.map +1 -0
  185. package/dist/tests/mocks/handlers.js +55 -0
  186. package/dist/tests/mocks/handlers.js.map +1 -0
  187. package/dist/tests/mocks/setup.d.ts +3 -0
  188. package/dist/tests/mocks/setup.d.ts.map +1 -0
  189. package/dist/tests/mocks/setup.js +77 -0
  190. package/dist/tests/mocks/setup.js.map +1 -0
  191. package/dist/tools/definitions/ask-question.d.ts +8 -0
  192. package/dist/tools/definitions/ask-question.d.ts.map +1 -0
  193. package/dist/tools/definitions/ask-question.js +211 -0
  194. package/dist/tools/definitions/ask-question.js.map +1 -0
  195. package/dist/tools/definitions/notebook-management.d.ts +3 -0
  196. package/dist/tools/definitions/notebook-management.d.ts.map +1 -0
  197. package/dist/tools/definitions/notebook-management.js +243 -0
  198. package/dist/tools/definitions/notebook-management.js.map +1 -0
  199. package/dist/tools/definitions/session-management.d.ts +3 -0
  200. package/dist/tools/definitions/session-management.d.ts.map +1 -0
  201. package/dist/tools/definitions/session-management.js +41 -0
  202. package/dist/tools/definitions/session-management.js.map +1 -0
  203. package/dist/tools/definitions/system.d.ts +3 -0
  204. package/dist/tools/definitions/system.d.ts.map +1 -0
  205. package/dist/tools/definitions/system.js +143 -0
  206. package/dist/tools/definitions/system.js.map +1 -0
  207. package/dist/tools/definitions.d.ts +12 -0
  208. package/dist/tools/definitions.d.ts.map +1 -0
  209. package/dist/tools/definitions.js +26 -0
  210. package/dist/tools/definitions.js.map +1 -0
  211. package/dist/tools/handlers.d.ts +212 -0
  212. package/dist/tools/handlers.d.ts.map +1 -0
  213. package/dist/tools/handlers.js +712 -0
  214. package/dist/tools/handlers.js.map +1 -0
  215. package/dist/tools/index.d.ts +8 -0
  216. package/dist/tools/index.d.ts.map +1 -0
  217. package/dist/tools/index.js +8 -0
  218. package/dist/tools/index.js.map +1 -0
  219. package/dist/types.d.ts +82 -0
  220. package/dist/types.d.ts.map +1 -0
  221. package/dist/types.js +5 -0
  222. package/dist/types.js.map +1 -0
  223. package/dist/utils/cleanup-manager.d.ts +133 -0
  224. package/dist/utils/cleanup-manager.d.ts.map +1 -0
  225. package/dist/utils/cleanup-manager.js +673 -0
  226. package/dist/utils/cleanup-manager.js.map +1 -0
  227. package/dist/utils/cli-handler.d.ts +16 -0
  228. package/dist/utils/cli-handler.d.ts.map +1 -0
  229. package/dist/utils/cli-handler.js +102 -0
  230. package/dist/utils/cli-handler.js.map +1 -0
  231. package/dist/utils/logger.d.ts +61 -0
  232. package/dist/utils/logger.d.ts.map +1 -0
  233. package/dist/utils/logger.js +92 -0
  234. package/dist/utils/logger.js.map +1 -0
  235. package/dist/utils/page-utils.d.ts +54 -0
  236. package/dist/utils/page-utils.d.ts.map +1 -0
  237. package/dist/utils/page-utils.js +381 -0
  238. package/dist/utils/page-utils.js.map +1 -0
  239. package/dist/utils/rate-limit-handler.d.ts +42 -0
  240. package/dist/utils/rate-limit-handler.d.ts.map +1 -0
  241. package/dist/utils/rate-limit-handler.js +88 -0
  242. package/dist/utils/rate-limit-handler.js.map +1 -0
  243. package/dist/utils/rate-limit-handler.test.d.ts +7 -0
  244. package/dist/utils/rate-limit-handler.test.d.ts.map +1 -0
  245. package/dist/utils/rate-limit-handler.test.js +91 -0
  246. package/dist/utils/rate-limit-handler.test.js.map +1 -0
  247. package/dist/utils/settings-manager.d.ts +37 -0
  248. package/dist/utils/settings-manager.d.ts.map +1 -0
  249. package/dist/utils/settings-manager.js +121 -0
  250. package/dist/utils/settings-manager.js.map +1 -0
  251. package/dist/utils/stealth-utils.d.ts +135 -0
  252. package/dist/utils/stealth-utils.d.ts.map +1 -0
  253. package/dist/utils/stealth-utils.js +396 -0
  254. package/dist/utils/stealth-utils.js.map +1 -0
  255. package/dist/utils/stealth-utils.test.d.ts +7 -0
  256. package/dist/utils/stealth-utils.test.d.ts.map +1 -0
  257. package/dist/utils/stealth-utils.test.js +72 -0
  258. package/dist/utils/stealth-utils.test.js.map +1 -0
  259. package/docs/01_configuration.md +94 -0
  260. package/docs/02_tools.md +34 -0
  261. package/docs/03_troubleshooting.md +59 -0
  262. package/docs/04_usage-guide.md +245 -0
  263. package/docs/05_project-analysis.qmd +309 -0
  264. package/docs/06_integration-analysis.html +914 -0
  265. package/docs/06_integration-analysis.qmd +255 -0
  266. package/docs/06_integration-analysis_files/libs/bootstrap/bootstrap-4f0954b6b0dd6bf39f4bb9151ba984db.min.css +12 -0
  267. package/docs/06_integration-analysis_files/libs/bootstrap/bootstrap-icons.css +2106 -0
  268. package/docs/06_integration-analysis_files/libs/bootstrap/bootstrap-icons.woff +0 -0
  269. package/docs/06_integration-analysis_files/libs/bootstrap/bootstrap.min.js +7 -0
  270. package/docs/06_integration-analysis_files/libs/clipboard/clipboard.min.js +7 -0
  271. package/docs/06_integration-analysis_files/libs/quarto-html/anchor.min.js +9 -0
  272. package/docs/06_integration-analysis_files/libs/quarto-html/axe/axe-check.js +145 -0
  273. package/docs/06_integration-analysis_files/libs/quarto-html/popper.min.js +6 -0
  274. package/docs/06_integration-analysis_files/libs/quarto-html/quarto-syntax-highlighting-587c61ba64f3a5504c4d52d930310e48.css +236 -0
  275. package/docs/06_integration-analysis_files/libs/quarto-html/quarto.js +847 -0
  276. package/docs/06_integration-analysis_files/libs/quarto-html/tabsets/tabsets.js +95 -0
  277. package/docs/06_integration-analysis_files/libs/quarto-html/tippy.css +1 -0
  278. package/docs/06_integration-analysis_files/libs/quarto-html/tippy.umd.min.js +2 -0
  279. package/docs/07_e2e-testing-safety.qmd +754 -0
  280. package/docs/08_project-re-evaluation.html +609 -0
  281. package/docs/08_project-re-evaluation.qmd +86 -0
  282. package/docs/08_project-re-evaluation_files/libs/bootstrap/bootstrap-4f0954b6b0dd6bf39f4bb9151ba984db.min.css +12 -0
  283. package/docs/08_project-re-evaluation_files/libs/bootstrap/bootstrap-icons.css +2106 -0
  284. package/docs/08_project-re-evaluation_files/libs/bootstrap/bootstrap-icons.woff +0 -0
  285. package/docs/08_project-re-evaluation_files/libs/bootstrap/bootstrap.min.js +7 -0
  286. package/docs/08_project-re-evaluation_files/libs/clipboard/clipboard.min.js +7 -0
  287. package/docs/08_project-re-evaluation_files/libs/quarto-html/anchor.min.js +9 -0
  288. package/docs/08_project-re-evaluation_files/libs/quarto-html/axe/axe-check.js +145 -0
  289. package/docs/08_project-re-evaluation_files/libs/quarto-html/popper.min.js +6 -0
  290. package/docs/08_project-re-evaluation_files/libs/quarto-html/quarto-syntax-highlighting-587c61ba64f3a5504c4d52d930310e48.css +236 -0
  291. package/docs/08_project-re-evaluation_files/libs/quarto-html/quarto.js +847 -0
  292. package/docs/08_project-re-evaluation_files/libs/quarto-html/tabsets/tabsets.js +95 -0
  293. package/docs/08_project-re-evaluation_files/libs/quarto-html/tippy.css +1 -0
  294. package/docs/08_project-re-evaluation_files/libs/quarto-html/tippy.umd.min.js +2 -0
  295. package/docs/notebooklm-mcp-usage.html +704 -0
  296. package/docs/notebooklm-mcp-usage.qmd +119 -0
  297. package/docs/notebooklm-mcp-usage_files/libs/bootstrap/bootstrap-6b71f2156b6a5230c6677325978bcf08.min.css +12 -0
  298. package/docs/notebooklm-mcp-usage_files/libs/bootstrap/bootstrap-icons.css +2106 -0
  299. package/docs/notebooklm-mcp-usage_files/libs/bootstrap/bootstrap-icons.woff +0 -0
  300. package/docs/notebooklm-mcp-usage_files/libs/bootstrap/bootstrap.min.js +7 -0
  301. package/docs/notebooklm-mcp-usage_files/libs/clipboard/clipboard.min.js +7 -0
  302. package/docs/notebooklm-mcp-usage_files/libs/quarto-html/anchor.min.js +9 -0
  303. package/docs/notebooklm-mcp-usage_files/libs/quarto-html/axe/axe-check.js +145 -0
  304. package/docs/notebooklm-mcp-usage_files/libs/quarto-html/popper.min.js +6 -0
  305. package/docs/notebooklm-mcp-usage_files/libs/quarto-html/quarto-syntax-highlighting-587c61ba64f3a5504c4d52d930310e48.css +236 -0
  306. package/docs/notebooklm-mcp-usage_files/libs/quarto-html/quarto.js +847 -0
  307. package/docs/notebooklm-mcp-usage_files/libs/quarto-html/tabsets/tabsets.js +95 -0
  308. package/docs/notebooklm-mcp-usage_files/libs/quarto-html/tippy.css +1 -0
  309. package/docs/notebooklm-mcp-usage_files/libs/quarto-html/tippy.umd.min.js +2 -0
  310. package/docs/repomix-usage_files/libs/bootstrap/bootstrap-6b71f2156b6a5230c6677325978bcf08.min.css +12 -0
  311. package/docs/repomix-usage_files/libs/bootstrap/bootstrap-icons.css +2106 -0
  312. package/docs/repomix-usage_files/libs/bootstrap/bootstrap-icons.woff +0 -0
  313. package/docs/repomix-usage_files/libs/bootstrap/bootstrap.min.js +7 -0
  314. package/docs/repomix-usage_files/libs/clipboard/clipboard.min.js +7 -0
  315. package/docs/repomix-usage_files/libs/quarto-html/anchor.min.js +9 -0
  316. package/docs/repomix-usage_files/libs/quarto-html/axe/axe-check.js +145 -0
  317. package/docs/repomix-usage_files/libs/quarto-html/popper.min.js +6 -0
  318. package/docs/repomix-usage_files/libs/quarto-html/quarto-syntax-highlighting-587c61ba64f3a5504c4d52d930310e48.css +236 -0
  319. package/docs/repomix-usage_files/libs/quarto-html/quarto.js +847 -0
  320. package/docs/repomix-usage_files/libs/quarto-html/tabsets/tabsets.js +95 -0
  321. package/docs/repomix-usage_files/libs/quarto-html/tippy.css +1 -0
  322. package/docs/repomix-usage_files/libs/quarto-html/tippy.umd.min.js +2 -0
  323. package/package.json +62 -0
package/docs/06_integration-analysis.html ADDED
@@ -0,0 +1,914 @@
1
+ <!DOCTYPE html>
2
+ <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
3
+
4
+ <meta charset="utf-8">
5
+ <meta name="generator" content="quarto-1.8.26">
6
+
7
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
8
+
9
+ <meta name="author" content="Antigravity AI">
10
+ <meta name="dcterms.date" content="2026-01-02">
11
+
12
+ <title>Chrome/NotebookLM/Gemini 통합 분석 보고서</title>
13
+ <style>
14
+ code{white-space: pre-wrap;}
15
+ span.smallcaps{font-variant: small-caps;}
16
+ div.columns{display: flex; gap: min(4vw, 1.5em);}
17
+ div.column{flex: auto; overflow-x: auto;}
18
+ div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
19
+ ul.task-list{list-style: none;}
20
+ ul.task-list li input[type="checkbox"] {
21
+ width: 0.8em;
22
+ margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */
23
+ vertical-align: middle;
24
+ }
25
+ /* CSS for syntax highlighting */
26
+ html { -webkit-text-size-adjust: 100%; }
27
+ pre > code.sourceCode { white-space: pre; position: relative; }
28
+ pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
29
+ pre > code.sourceCode > span:empty { height: 1.2em; }
30
+ .sourceCode { overflow: visible; }
31
+ code.sourceCode > span { color: inherit; text-decoration: inherit; }
32
+ div.sourceCode { margin: 1em 0; }
33
+ pre.sourceCode { margin: 0; }
34
+ @media screen {
35
+ div.sourceCode { overflow: auto; }
36
+ }
37
+ @media print {
38
+ pre > code.sourceCode { white-space: pre-wrap; }
39
+ pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
40
+ }
41
+ pre.numberSource code
42
+ { counter-reset: source-line 0; }
43
+ pre.numberSource code > span
44
+ { position: relative; left: -4em; counter-increment: source-line; }
45
+ pre.numberSource code > span > a:first-child::before
46
+ { content: counter(source-line);
47
+ position: relative; left: -1em; text-align: right; vertical-align: baseline;
48
+ border: none; display: inline-block;
49
+ -webkit-touch-callout: none; -webkit-user-select: none;
50
+ -khtml-user-select: none; -moz-user-select: none;
51
+ -ms-user-select: none; user-select: none;
52
+ padding: 0 4px; width: 4em;
53
+ }
54
+ pre.numberSource { margin-left: 3em; padding-left: 4px; }
55
+ div.sourceCode
56
+ { }
57
+ @media screen {
58
+ pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
59
+ }
60
+ </style>
61
+
62
+
63
+ <script src="06_integration-analysis_files/libs/clipboard/clipboard.min.js"></script>
64
+ <script src="06_integration-analysis_files/libs/quarto-html/quarto.js" type="module"></script>
65
+ <script src="06_integration-analysis_files/libs/quarto-html/tabsets/tabsets.js" type="module"></script>
66
+ <script src="06_integration-analysis_files/libs/quarto-html/axe/axe-check.js" type="module"></script>
67
+ <script src="06_integration-analysis_files/libs/quarto-html/popper.min.js"></script>
68
+ <script src="06_integration-analysis_files/libs/quarto-html/tippy.umd.min.js"></script>
69
+ <script src="06_integration-analysis_files/libs/quarto-html/anchor.min.js"></script>
70
+ <link href="06_integration-analysis_files/libs/quarto-html/tippy.css" rel="stylesheet">
71
+ <link href="06_integration-analysis_files/libs/quarto-html/quarto-syntax-highlighting-587c61ba64f3a5504c4d52d930310e48.css" rel="stylesheet" id="quarto-text-highlighting-styles">
72
+ <script src="06_integration-analysis_files/libs/bootstrap/bootstrap.min.js"></script>
73
+ <link href="06_integration-analysis_files/libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
74
+ <link href="06_integration-analysis_files/libs/bootstrap/bootstrap-4f0954b6b0dd6bf39f4bb9151ba984db.min.css" rel="stylesheet" append-hash="true" id="quarto-bootstrap" data-mode="light">
75
+
76
+
77
+ </head>
78
+
79
+ <body class="quarto-light">
80
+
81
+ <div id="quarto-content" class="page-columns page-rows-contents page-layout-article">
82
+ <div id="quarto-margin-sidebar" class="sidebar margin-sidebar">
83
+ <nav id="TOC" role="doc-toc" class="toc-active">
84
+ <h2 id="toc-title">Table of contents</h2>
85
+
86
+ <ul>
87
+ <li><a href="#개요" id="toc-개요" class="nav-link active" data-scroll-target="#개요"><span class="header-section-number">1</span> 개요</a></li>
88
+ <li><a href="#gemini-버전-확인" id="toc-gemini-버전-확인" class="nav-link" data-scroll-target="#gemini-버전-확인"><span class="header-section-number">2</span> Gemini 버전 확인</a>
89
+ <ul class="collapse">
90
+ <li><a href="#코드-내-확인-사항" id="toc-코드-내-확인-사항" class="nav-link" data-scroll-target="#코드-내-확인-사항"><span class="header-section-number">2.1</span> 코드 내 확인 사항</a></li>
91
+ <li><a href="#참고" id="toc-참고" class="nav-link" data-scroll-target="#참고"><span class="header-section-number">2.2</span> 참고</a></li>
92
+ </ul></li>
93
+ <li><a href="#chrome-자동화-분석" id="toc-chrome-자동화-분석" class="nav-link" data-scroll-target="#chrome-자동화-분석"><span class="header-section-number">3</span> Chrome 자동화 분석</a>
94
+ <ul class="collapse">
95
+ <li><a href="#사용-기술" id="toc-사용-기술" class="nav-link" data-scroll-target="#사용-기술"><span class="header-section-number">3.1</span> 사용 기술</a></li>
96
+ <li><a href="#핵심-구성요소" id="toc-핵심-구성요소" class="nav-link" data-scroll-target="#핵심-구성요소"><span class="header-section-number">3.2</span> 핵심 구성요소</a></li>
97
+ <li><a href="#아키텍처-흐름" id="toc-아키텍처-흐름" class="nav-link" data-scroll-target="#아키텍처-흐름"><span class="header-section-number">3.3</span> 아키텍처 흐름</a></li>
98
+ <li><a href="#잘-구현된-부분" id="toc-잘-구현된-부분" class="nav-link" data-scroll-target="#잘-구현된-부분"><span class="header-section-number">3.4</span> 잘 구현된 부분</a></li>
99
+ </ul></li>
100
+ <li><a href="#notebooklm-연동-분석" id="toc-notebooklm-연동-분석" class="nav-link" data-scroll-target="#notebooklm-연동-분석"><span class="header-section-number">4</span> NotebookLM 연동 분석</a>
101
+ <ul class="collapse">
102
+ <li><a href="#인증-흐름" id="toc-인증-흐름" class="nav-link" data-scroll-target="#인증-흐름"><span class="header-section-number">4.1</span> 인증 흐름</a></li>
103
+ <li><a href="#질문-응답-흐름" id="toc-질문-응답-흐름" class="nav-link" data-scroll-target="#질문-응답-흐름"><span class="header-section-number">4.2</span> 질문-응답 흐름</a></li>
104
+ <li><a href="#rate-limit-처리" id="toc-rate-limit-처리" class="nav-link" data-scroll-target="#rate-limit-처리"><span class="header-section-number">4.3</span> Rate Limit 처리</a></li>
105
+ </ul></li>
106
+ <li><a href="#개선-권장-사항" id="toc-개선-권장-사항" class="nav-link" data-scroll-target="#개선-권장-사항"><span class="header-section-number">5</span> 개선 권장 사항</a>
107
+ <ul class="collapse">
108
+ <li><a href="#우선순위-높음" id="toc-우선순위-높음" class="nav-link" data-scroll-target="#우선순위-높음"><span class="header-section-number">5.1</span> 우선순위: 높음</a>
109
+ <ul class="collapse">
110
+ <li><a href="#esm-호환성-문제" id="toc-esm-호환성-문제" class="nav-link" data-scroll-target="#esm-호환성-문제"><span class="header-section-number">5.1.1</span> 1. ESM 호환성 문제</a></li>
111
+ <li><a href="#타입-안전성-개선" id="toc-타입-안전성-개선" class="nav-link" data-scroll-target="#타입-안전성-개선"><span class="header-section-number">5.1.2</span> 2. 타입 안전성 개선</a></li>
112
+ </ul></li>
113
+ <li><a href="#우선순위-중간" id="toc-우선순위-중간" class="nav-link" data-scroll-target="#우선순위-중간"><span class="header-section-number">5.2</span> 우선순위: 중간</a>
114
+ <ul class="collapse">
115
+ <li><a href="#rate-limit-재시도-로직" id="toc-rate-limit-재시도-로직" class="nav-link" data-scroll-target="#rate-limit-재시도-로직"><span class="header-section-number">5.2.1</span> 3. Rate Limit 재시도 로직</a></li>
116
+ <li><a href="#테스트-추가" id="toc-테스트-추가" class="nav-link" data-scroll-target="#테스트-추가"><span class="header-section-number">5.2.2</span> 4. 테스트 추가</a></li>
117
+ <li><a href="#하드코딩된-타임아웃-개선" id="toc-하드코딩된-타임아웃-개선" class="nav-link" data-scroll-target="#하드코딩된-타임아웃-개선"><span class="header-section-number">5.2.3</span> 5. 하드코딩된 타임아웃 개선</a></li>
118
+ </ul></li>
119
+ <li><a href="#우선순위-낮음" id="toc-우선순위-낮음" class="nav-link" data-scroll-target="#우선순위-낮음"><span class="header-section-number">5.3</span> 우선순위: 낮음</a>
120
+ <ul class="collapse">
121
+ <li><a href="#상수-추출" id="toc-상수-추출" class="nav-link" data-scroll-target="#상수-추출"><span class="header-section-number">5.3.1</span> 6. 상수 추출</a></li>
122
+ <li><a href="#중복-코드-제거" id="toc-중복-코드-제거" class="nav-link" data-scroll-target="#중복-코드-제거"><span class="header-section-number">5.3.2</span> 7. 중복 코드 제거</a></li>
123
+ </ul></li>
124
+ </ul></li>
125
+ <li><a href="#프로젝트-강점-요약" id="toc-프로젝트-강점-요약" class="nav-link" data-scroll-target="#프로젝트-강점-요약"><span class="header-section-number">6</span> 프로젝트 강점 요약</a></li>
126
+ <li><a href="#결론" id="toc-결론" class="nav-link" data-scroll-target="#결론"><span class="header-section-number">7</span> 결론</a></li>
127
+ </ul>
128
+ </nav>
129
+ </div>
130
+ <main class="content" id="quarto-document-content">
131
+
132
+ <header id="title-block-header" class="quarto-title-block default">
133
+ <div class="quarto-title">
134
+ <h1 class="title">Chrome/NotebookLM/Gemini 통합 분석 보고서</h1>
135
+ </div>
136
+
137
+
138
+
139
+ <div class="quarto-title-meta">
140
+
141
+ <div>
142
+ <div class="quarto-title-meta-heading">Author</div>
143
+ <div class="quarto-title-meta-contents">
144
+ <p>Antigravity AI </p>
145
+ </div>
146
+ </div>
147
+
148
+ <div>
149
+ <div class="quarto-title-meta-heading">Published</div>
150
+ <div class="quarto-title-meta-contents">
151
+ <p class="date">January 2, 2026</p>
152
+ </div>
153
+ </div>
154
+
155
+
156
+ </div>
157
+
158
+
159
+
160
+ </header>
161
+
162
+
163
+ <section id="개요" class="level1" data-number="1">
164
+ <h1 data-number="1"><span class="header-section-number">1</span> 개요</h1>
165
+ <p>이 문서는 NotebookLM MCP 프로젝트의 Chrome 자동화, NotebookLM 연동, Gemini 통합 부분에 대한 분석 결과입니다.</p>
166
+ <hr>
167
+ </section>
168
+ <section id="gemini-버전-확인" class="level1" data-number="2">
169
+ <h1 data-number="2"><span class="header-section-number">2</span> Gemini 버전 확인</h1>
170
+ <div class="callout callout-style-default callout-important callout-titled">
171
+ <div class="callout-header d-flex align-content-center">
172
+ <div class="callout-icon-container">
173
+ <i class="callout-icon"></i>
174
+ </div>
175
+ <div class="callout-title-container flex-fill">
176
+ <span class="screen-reader-only">Important</span>결론: Gemini 2.5 사용 (Gemini 3 아님)
177
+ </div>
178
+ </div>
179
+ <div class="callout-body-container callout-body">
180
+ <p>NotebookLM은 현재 <strong>Gemini 2.5</strong>를 백엔드로 사용합니다.</p>
181
+ </div>
182
+ </div>
183
+ <section id="코드-내-확인-사항" class="level2" data-number="2.1">
184
+ <h2 data-number="2.1" class="anchored" data-anchor-id="코드-내-확인-사항"><span class="header-section-number">2.1</span> 코드 내 확인 사항</h2>
185
+ <table class="caption-top table">
186
+ <colgroup>
187
+ <col style="width: 50%">
188
+ <col style="width: 50%">
189
+ </colgroup>
190
+ <thead>
191
+ <tr class="header">
192
+ <th>파일</th>
193
+ <th>내용</th>
194
+ </tr>
195
+ </thead>
196
+ <tbody>
197
+ <tr class="odd">
198
+ <td><code>src/tools/definitions/ask-question.ts</code></td>
199
+ <td><code>"Gemini 2.5 • Session RAG"</code></td>
200
+ </tr>
201
+ <tr class="even">
202
+ <td><code>README.md</code></td>
203
+ <td><code>"Gemini 2.5 that provides intelligent, synthesized answers"</code></td>
204
+ </tr>
205
+ <tr class="odd">
206
+ <td><code>CHANGELOG.md</code></td>
207
+ <td><code>"Session-based conversations with Gemini 2.5"</code></td>
208
+ </tr>
209
+ </tbody>
210
+ </table>
211
+ </section>
212
+ <section id="참고" class="level2" data-number="2.2">
213
+ <h2 data-number="2.2" class="anchored" data-anchor-id="참고"><span class="header-section-number">2.2</span> 참고</h2>
214
+ <ul>
215
+ <li>NotebookLM은 Google의 관리형 서비스</li>
216
+ <li>Gemini 모델 버전은 Google에서 제어하며 MCP에서 직접 변경 불가</li>
217
+ <li>Google이 백엔드를 업그레이드하면 자동으로 최신 버전 사용</li>
218
+ </ul>
219
+ <hr>
220
+ </section>
221
+ </section>
222
+ <section id="chrome-자동화-분석" class="level1" data-number="3">
223
+ <h1 data-number="3"><span class="header-section-number">3</span> Chrome 자동화 분석</h1>
224
+ <section id="사용-기술" class="level2" data-number="3.1">
225
+ <h2 data-number="3.1" class="anchored" data-anchor-id="사용-기술"><span class="header-section-number">3.1</span> 사용 기술</h2>
226
+ <ul>
227
+ <li><strong>Patchright v1.48.2</strong>: Playwright 포크, 봇 탐지 회피 특화</li>
228
+ <li><strong>영구 Chrome 프로필</strong>: <code>launchPersistentContext</code>로 일관된 핑거프린트 유지</li>
229
+ </ul>
230
+ </section>
231
+ <section id="핵심-구성요소" class="level2" data-number="3.2">
232
+ <h2 data-number="3.2" class="anchored" data-anchor-id="핵심-구성요소"><span class="header-section-number">3.2</span> 핵심 구성요소</h2>
233
+ <table class="caption-top table">
234
+ <colgroup>
235
+ <col style="width: 50%">
236
+ <col style="width: 50%">
237
+ </colgroup>
238
+ <thead>
239
+ <tr class="header">
240
+ <th>파일</th>
241
+ <th>역할</th>
242
+ </tr>
243
+ </thead>
244
+ <tbody>
245
+ <tr class="odd">
246
+ <td><code>auth-manager.ts</code></td>
247
+ <td>Google 인증, 쿠키 관리, 상태 저장/복원</td>
248
+ </tr>
249
+ <tr class="even">
250
+ <td><code>browser-session.ts</code></td>
251
+ <td>개별 브라우저 세션, 질문 전송, 응답 수신</td>
252
+ </tr>
253
+ <tr class="odd">
254
+ <td><code>session-manager.ts</code></td>
255
+ <td>다중 세션 관리, 세션 풀링, 자동 정리</td>
256
+ </tr>
257
+ <tr class="even">
258
+ <td><code>shared-context-manager.ts</code></td>
259
+ <td>단일 브라우저 컨텍스트 공유, 프로필 관리</td>
260
+ </tr>
261
+ </tbody>
262
+ </table>
263
+ </section>
264
+ <section id="아키텍처-흐름" class="level2" data-number="3.3">
265
+ <h2 data-number="3.3" class="anchored" data-anchor-id="아키텍처-흐름"><span class="header-section-number">3.3</span> 아키텍처 흐름</h2>
266
+ <pre class="mermaid"><code>flowchart LR
267
+ A[MCP Client] --&gt; B[Tool Handler]
268
+ B --&gt; C[Session Manager]
269
+ C --&gt; D[Shared Context Manager]
270
+ D --&gt; E[Browser Session]
271
+ E --&gt; F[NotebookLM Page]
272
+ F --&gt; G[Gemini 2.5 Backend]</code></pre>
273
+ </section>
274
+ <section id="잘-구현된-부분" class="level2" data-number="3.4">
275
+ <h2 data-number="3.4" class="anchored" data-anchor-id="잘-구현된-부분"><span class="header-section-number">3.4</span> 잘 구현된 부분</h2>
276
+ <div class="callout callout-style-default callout-tip callout-titled">
277
+ <div class="callout-header d-flex align-content-center">
278
+ <div class="callout-icon-container">
279
+ <i class="callout-icon"></i>
280
+ </div>
281
+ <div class="callout-title-container flex-fill">
282
+ <span class="screen-reader-only">Tip</span>강점
283
+ </div>
284
+ </div>
285
+ <div class="callout-body-container callout-body">
286
+ <ol type="1">
287
+ <li><strong>자동 복구 메커니즘</strong>: 브라우저/컨텍스트 종료 시 자동 재연결</li>
288
+ <li><strong>다국어 셀렉터</strong>: 6개 언어 UI 대응 (영어, 독일어, 일본어, 한국어, 프랑스어, 스페인어)</li>
289
+ <li><strong>스텔스 모드</strong>: 휴먼 타이핑, 마우스 움직임, 랜덤 딜레이</li>
290
+ <li><strong>세션 기반 대화</strong>: 컨텍스트 유지를 통한 심층 연구 가능</li>
291
+ </ol>
292
+ </div>
293
+ </div>
294
+ <hr>
295
+ </section>
296
+ </section>
297
+ <section id="notebooklm-연동-분석" class="level1" data-number="4">
298
+ <h1 data-number="4"><span class="header-section-number">4</span> NotebookLM 연동 분석</h1>
299
+ <section id="인증-흐름" class="level2" data-number="4.1">
300
+ <h2 data-number="4.1" class="anchored" data-anchor-id="인증-흐름"><span class="header-section-number">4.1</span> 인증 흐름</h2>
301
+ <ol type="1">
302
+ <li>사용자가 <code>setup_auth</code> 호출</li>
303
+ <li>Chrome 브라우저 창 열림 (headful 모드)</li>
304
+ <li>Google 계정 수동 로그인 (최대 10분)</li>
305
+ <li>쿠키 및 sessionStorage 저장</li>
306
+ <li>이후 세션에서 자동 인증</li>
307
+ </ol>
308
+ </section>
309
+ <section id="질문-응답-흐름" class="level2" data-number="4.2">
310
+ <h2 data-number="4.2" class="anchored" data-anchor-id="질문-응답-흐름"><span class="header-section-number">4.2</span> 질문-응답 흐름</h2>
311
+ <pre class="mermaid"><code>sequenceDiagram
312
+ participant C as Claude
313
+ participant M as MCP Server
314
+ participant B as Browser Session
315
+ participant N as NotebookLM
316
+
317
+ C-&gt;&gt;M: ask_question(question)
318
+ M-&gt;&gt;B: getOrCreateSession()
319
+ B-&gt;&gt;N: Navigate to notebook
320
+ B-&gt;&gt;N: Type question (human-like)
321
+ B-&gt;&gt;N: Submit (Enter)
322
+ N--&gt;&gt;B: Stream response
323
+ B--&gt;&gt;M: Parse answer
324
+ M--&gt;&gt;C: Return formatted answer</code></pre>
325
+ </section>
326
+ <section id="rate-limit-처리" class="level2" data-number="4.3">
327
+ <h2 data-number="4.3" class="anchored" data-anchor-id="rate-limit-처리"><span class="header-section-number">4.3</span> Rate Limit 처리</h2>
328
+ <ul>
329
+ <li>무료 계정: 50 쿼리/일</li>
330
+ <li>Rate limit 감지: 에러 메시지 및 입력창 disabled 체크</li>
331
+ <li>우회: <code>re_auth</code> 도구로 다른 Google 계정 전환</li>
332
+ </ul>
333
+ <hr>
334
+ </section>
335
+ </section>
336
+ <section id="개선-권장-사항" class="level1" data-number="5">
337
+ <h1 data-number="5"><span class="header-section-number">5</span> 개선 권장 사항</h1>
338
+ <section id="우선순위-높음" class="level2" data-number="5.1">
339
+ <h2 data-number="5.1" class="anchored" data-anchor-id="우선순위-높음"><span class="header-section-number">5.1</span> 우선순위: 높음</h2>
340
+ <section id="esm-호환성-문제" class="level3" data-number="5.1.1">
341
+ <h3 data-number="5.1.1" class="anchored" data-anchor-id="esm-호환성-문제"><span class="header-section-number">5.1.1</span> 1. ESM 호환성 문제</h3>
342
+ <p><strong>위치</strong>: <code>src/utils/settings-manager.ts</code></p>
343
+ <div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb3"><pre class="sourceCode typescript code-with-copy"><code class="sourceCode typescript"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="co">// 현재 (비권장)</span></span>
344
+ <span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a><span class="kw">const</span> fsSync <span class="op">=</span> <span class="pp">require</span>(<span class="st">"fs"</span>)<span class="op">;</span></span>
345
+ <span id="cb3-3"><a href="#cb3-3" aria-hidden="true" tabindex="-1"></a><span class="kw">const</span> data <span class="op">=</span> fsSync<span class="op">.</span><span class="fu">readFileSync</span>(<span class="kw">this</span><span class="op">.</span><span class="at">settingsPath</span><span class="op">,</span> <span class="st">"utf-8"</span>)<span class="op">;</span></span>
346
+ <span id="cb3-4"><a href="#cb3-4" aria-hidden="true" tabindex="-1"></a></span>
347
+ <span id="cb3-5"><a href="#cb3-5" aria-hidden="true" tabindex="-1"></a><span class="co">// 개선안</span></span>
348
+ <span id="cb3-6"><a href="#cb3-6" aria-hidden="true" tabindex="-1"></a><span class="im">import</span> { readFileSync } <span class="im">from</span> <span class="st">"fs"</span><span class="op">;</span></span>
349
+ <span id="cb3-7"><a href="#cb3-7" aria-hidden="true" tabindex="-1"></a><span class="kw">const</span> data <span class="op">=</span> <span class="fu">readFileSync</span>(<span class="kw">this</span><span class="op">.</span><span class="at">settingsPath</span><span class="op">,</span> <span class="st">"utf-8"</span>)<span class="op">;</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
350
+ </section>
351
+ <section id="타입-안전성-개선" class="level3" data-number="5.1.2">
352
+ <h3 data-number="5.1.2" class="anchored" data-anchor-id="타입-안전성-개선"><span class="header-section-number">5.1.2</span> 2. 타입 안전성 개선</h3>
353
+ <p><code>@ts-expect-error</code> 사용 위치:</p>
354
+ <ul>
355
+ <li><code>auth-manager.ts</code>: sessionStorage 접근</li>
356
+ <li><code>browser-session.ts</code>: 브라우저 컨텍스트 평가</li>
357
+ <li><code>stealth-utils.ts</code>: 윈도우 객체 접근</li>
358
+ </ul>
359
+ <p><strong>개선안</strong>: 브라우저 컨텍스트용 타입 정의 생성</p>
360
+ <div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb4"><pre class="sourceCode typescript code-with-copy"><code class="sourceCode typescript"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="co">// src/types/browser-context.d.ts</span></span>
361
+ <span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a><span class="kw">interface</span> BrowserWindow <span class="kw">extends</span> <span class="bu">Window</span> {</span>
362
+ <span id="cb4-3"><a href="#cb4-3" aria-hidden="true" tabindex="-1"></a> sessionStorage<span class="op">:</span> <span class="bu">Storage</span><span class="op">;</span></span>
363
+ <span id="cb4-4"><a href="#cb4-4" aria-hidden="true" tabindex="-1"></a> localStorage<span class="op">:</span> <span class="bu">Storage</span><span class="op">;</span></span>
364
+ <span id="cb4-5"><a href="#cb4-5" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
365
+ <hr>
366
+ </section>
367
+ </section>
368
+ <section id="우선순위-중간" class="level2" data-number="5.2">
369
+ <h2 data-number="5.2" class="anchored" data-anchor-id="우선순위-중간"><span class="header-section-number">5.2</span> 우선순위: 중간</h2>
370
+ <section id="rate-limit-재시도-로직" class="level3" data-number="5.2.1">
371
+ <h3 data-number="5.2.1" class="anchored" data-anchor-id="rate-limit-재시도-로직"><span class="header-section-number">5.2.1</span> 3. Rate Limit 재시도 로직</h3>
372
+ <div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb5"><pre class="sourceCode typescript code-with-copy"><code class="sourceCode typescript"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="kw">class</span> RateLimitHandler {</span>
373
+ <span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a> <span class="kw">private</span> retryCount <span class="op">=</span> <span class="dv">0</span><span class="op">;</span></span>
374
+ <span id="cb5-3"><a href="#cb5-3" aria-hidden="true" tabindex="-1"></a> <span class="kw">private</span> maxRetries <span class="op">=</span> <span class="dv">3</span><span class="op">;</span></span>
375
+ <span id="cb5-4"><a href="#cb5-4" aria-hidden="true" tabindex="-1"></a> </span>
376
+ <span id="cb5-5"><a href="#cb5-5" aria-hidden="true" tabindex="-1"></a> <span class="kw">async</span> <span class="fu">executeWithRetry</span><span class="op">&lt;</span>T<span class="op">&gt;</span>(fn<span class="op">:</span> () <span class="kw">=&gt;</span> <span class="bu">Promise</span><span class="op">&lt;</span>T<span class="op">&gt;</span>)<span class="op">:</span> <span class="bu">Promise</span><span class="op">&lt;</span>T<span class="op">&gt;</span> {</span>
377
+ <span id="cb5-6"><a href="#cb5-6" aria-hidden="true" tabindex="-1"></a> <span class="cf">try</span> {</span>
378
+ <span id="cb5-7"><a href="#cb5-7" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="cf">await</span> <span class="fu">fn</span>()<span class="op">;</span></span>
379
+ <span id="cb5-8"><a href="#cb5-8" aria-hidden="true" tabindex="-1"></a> } <span class="cf">catch</span> (e) {</span>
380
+ <span id="cb5-9"><a href="#cb5-9" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> (e <span class="kw">instanceof</span> RateLimitError <span class="op">&amp;&amp;</span> <span class="kw">this</span><span class="op">.</span><span class="at">retryCount</span> <span class="op">&lt;</span> <span class="kw">this</span><span class="op">.</span><span class="at">maxRetries</span>) {</span>
381
+ <span id="cb5-10"><a href="#cb5-10" aria-hidden="true" tabindex="-1"></a> <span class="cf">await</span> <span class="kw">this</span><span class="op">.</span><span class="fu">exponentialBackoff</span>()<span class="op">;</span></span>
382
+ <span id="cb5-11"><a href="#cb5-11" aria-hidden="true" tabindex="-1"></a> <span class="kw">this</span><span class="op">.</span><span class="at">retryCount</span><span class="op">++;</span></span>
383
+ <span id="cb5-12"><a href="#cb5-12" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="kw">this</span><span class="op">.</span><span class="fu">executeWithRetry</span>(fn)<span class="op">;</span></span>
384
+ <span id="cb5-13"><a href="#cb5-13" aria-hidden="true" tabindex="-1"></a> }</span>
385
+ <span id="cb5-14"><a href="#cb5-14" aria-hidden="true" tabindex="-1"></a> <span class="cf">throw</span> e<span class="op">;</span></span>
386
+ <span id="cb5-15"><a href="#cb5-15" aria-hidden="true" tabindex="-1"></a> }</span>
387
+ <span id="cb5-16"><a href="#cb5-16" aria-hidden="true" tabindex="-1"></a> }</span>
388
+ <span id="cb5-17"><a href="#cb5-17" aria-hidden="true" tabindex="-1"></a> </span>
389
+ <span id="cb5-18"><a href="#cb5-18" aria-hidden="true" tabindex="-1"></a> <span class="kw">private</span> <span class="kw">async</span> <span class="fu">exponentialBackoff</span>()<span class="op">:</span> <span class="bu">Promise</span><span class="op">&lt;</span><span class="dt">void</span><span class="op">&gt;</span> {</span>
390
+ <span id="cb5-19"><a href="#cb5-19" aria-hidden="true" tabindex="-1"></a> <span class="kw">const</span> delay <span class="op">=</span> <span class="bu">Math</span><span class="op">.</span><span class="fu">pow</span>(<span class="dv">2</span><span class="op">,</span> <span class="kw">this</span><span class="op">.</span><span class="at">retryCount</span>) <span class="op">*</span> <span class="dv">1000</span><span class="op">;</span></span>
391
+ <span id="cb5-20"><a href="#cb5-20" aria-hidden="true" tabindex="-1"></a> <span class="cf">await</span> <span class="kw">new</span> <span class="bu">Promise</span>(resolve <span class="kw">=&gt;</span> <span class="pp">setTimeout</span>(resolve<span class="op">,</span> delay))<span class="op">;</span></span>
392
+ <span id="cb5-21"><a href="#cb5-21" aria-hidden="true" tabindex="-1"></a> }</span>
393
+ <span id="cb5-22"><a href="#cb5-22" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
394
+ </section>
395
+ <section id="테스트-추가" class="level3" data-number="5.2.2">
396
+ <h3 data-number="5.2.2" class="anchored" data-anchor-id="테스트-추가"><span class="header-section-number">5.2.2</span> 4. 테스트 추가</h3>
397
+ <p>현재 상태: - <code>package.json</code>에 테스트 스크립트 없음 - 테스트 파일 없음</p>
398
+ <p>권장 사항: - Jest 또는 Vitest 설정 - 핵심 모듈 단위 테스트 - E2E 테스트 (Playwright 활용)</p>
399
+ </section>
400
+ <section id="하드코딩된-타임아웃-개선" class="level3" data-number="5.2.3">
401
+ <h3 data-number="5.2.3" class="anchored" data-anchor-id="하드코딩된-타임아웃-개선"><span class="header-section-number">5.2.3</span> 5. 하드코딩된 타임아웃 개선</h3>
402
+ <div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb6"><pre class="sourceCode typescript code-with-copy"><code class="sourceCode typescript"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="co">// 현재</span></span>
403
+ <span id="cb6-2"><a href="#cb6-2" aria-hidden="true" tabindex="-1"></a><span class="cf">await</span> page<span class="op">.</span><span class="fu">waitForTimeout</span>(<span class="dv">2000</span>)<span class="op">;</span> <span class="co">// 매직 넘버</span></span>
404
+ <span id="cb6-3"><a href="#cb6-3" aria-hidden="true" tabindex="-1"></a></span>
405
+ <span id="cb6-4"><a href="#cb6-4" aria-hidden="true" tabindex="-1"></a><span class="co">// 개선안</span></span>
406
+ <span id="cb6-5"><a href="#cb6-5" aria-hidden="true" tabindex="-1"></a><span class="cf">await</span> page<span class="op">.</span><span class="fu">waitForTimeout</span>(CONFIG<span class="op">.</span><span class="at">delays</span><span class="op">.</span><span class="at">pageStabilize</span>)<span class="op">;</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
407
+ <hr>
408
+ </section>
409
+ </section>
410
+ <section id="우선순위-낮음" class="level2" data-number="5.3">
411
+ <h2 data-number="5.3" class="anchored" data-anchor-id="우선순위-낮음"><span class="header-section-number">5.3</span> 우선순위: 낮음</h2>
412
+ <section id="상수-추출" class="level3" data-number="5.3.1">
413
+ <h3 data-number="5.3.1" class="anchored" data-anchor-id="상수-추출"><span class="header-section-number">5.3.1</span> 6. 상수 추출</h3>
414
+ <div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb7"><pre class="sourceCode typescript code-with-copy"><code class="sourceCode typescript"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="co">// src/constants.ts</span></span>
415
+ <span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a><span class="im">export</span> <span class="kw">const</span> SELECTORS <span class="op">=</span> {</span>
416
+ <span id="cb7-3"><a href="#cb7-3" aria-hidden="true" tabindex="-1"></a> CHAT_INPUT<span class="op">:</span> <span class="st">"textarea.query-box-input"</span><span class="op">,</span></span>
417
+ <span id="cb7-4"><a href="#cb7-4" aria-hidden="true" tabindex="-1"></a> THINKING_MESSAGE<span class="op">:</span> <span class="st">"div.thinking-message"</span><span class="op">,</span></span>
418
+ <span id="cb7-5"><a href="#cb7-5" aria-hidden="true" tabindex="-1"></a> RESPONSE_CONTAINER<span class="op">:</span> <span class="st">".response-content"</span><span class="op">,</span></span>
419
+ <span id="cb7-6"><a href="#cb7-6" aria-hidden="true" tabindex="-1"></a>}<span class="op">;</span></span>
420
+ <span id="cb7-7"><a href="#cb7-7" aria-hidden="true" tabindex="-1"></a></span>
421
+ <span id="cb7-8"><a href="#cb7-8" aria-hidden="true" tabindex="-1"></a><span class="im">export</span> <span class="kw">const</span> URLS <span class="op">=</span> {</span>
422
+ <span id="cb7-9"><a href="#cb7-9" aria-hidden="true" tabindex="-1"></a> NOTEBOOKLM_AUTH<span class="op">:</span> <span class="st">"https://notebooklm.google.com/"</span><span class="op">,</span></span>
423
+ <span id="cb7-10"><a href="#cb7-10" aria-hidden="true" tabindex="-1"></a> GOOGLE_ACCOUNTS<span class="op">:</span> <span class="st">"https://accounts.google.com/"</span><span class="op">,</span></span>
424
+ <span id="cb7-11"><a href="#cb7-11" aria-hidden="true" tabindex="-1"></a>}<span class="op">;</span></span>
425
+ <span id="cb7-12"><a href="#cb7-12" aria-hidden="true" tabindex="-1"></a></span>
426
+ <span id="cb7-13"><a href="#cb7-13" aria-hidden="true" tabindex="-1"></a><span class="im">export</span> <span class="kw">const</span> ERROR_MESSAGES <span class="op">=</span> {</span>
427
+ <span id="cb7-14"><a href="#cb7-14" aria-hidden="true" tabindex="-1"></a> SESSION_EXPIRED<span class="op">:</span> <span class="st">"Session expired, re-authenticating..."</span><span class="op">,</span></span>
428
+ <span id="cb7-15"><a href="#cb7-15" aria-hidden="true" tabindex="-1"></a> RATE_LIMIT<span class="op">:</span> <span class="st">"Rate limit reached (50 queries/day)"</span><span class="op">,</span></span>
429
+ <span id="cb7-16"><a href="#cb7-16" aria-hidden="true" tabindex="-1"></a>}<span class="op">;</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
430
+ </section>
431
+ <section id="중복-코드-제거" class="level3" data-number="5.3.2">
432
+ <h3 data-number="5.3.2" class="anchored" data-anchor-id="중복-코드-제거"><span class="header-section-number">5.3.2</span> 7. 중복 코드 제거</h3>
433
+ <p>세션 초기화/복구 로직이 여러 곳에서 반복:</p>
434
+ <ul>
435
+ <li><code>BrowserSession.init()</code></li>
436
+ <li><code>BrowserSession.ask()</code> 내부 복구</li>
437
+ <li><code>BrowserSession.reset()</code></li>
438
+ </ul>
439
+ <p><strong>개선안</strong>: 공통 복구 유틸리티 함수 추출</p>
440
+ <hr>
441
+ </section>
442
+ </section>
443
+ </section>
444
+ <section id="프로젝트-강점-요약" class="level1" data-number="6">
445
+ <h1 data-number="6"><span class="header-section-number">6</span> 프로젝트 강점 요약</h1>
446
+ <div class="callout callout-style-default callout-note callout-titled">
447
+ <div class="callout-header d-flex align-content-center">
448
+ <div class="callout-icon-container">
449
+ <i class="callout-icon"></i>
450
+ </div>
451
+ <div class="callout-title-container flex-fill">
452
+ <span class="screen-reader-only">Note</span>전반적 평가
453
+ </div>
454
+ </div>
455
+ <div class="callout-body-container callout-body">
456
+ <p>NotebookLM MCP는 <strong>프로덕션 수준의 품질</strong>을 갖춘 잘 설계된 프로젝트입니다.</p>
457
+ </div>
458
+ </div>
459
+ <table class="caption-top table">
460
+ <thead>
461
+ <tr class="header">
462
+ <th>영역</th>
463
+ <th>평가</th>
464
+ </tr>
465
+ </thead>
466
+ <tbody>
467
+ <tr class="odd">
468
+ <td>에러 처리</td>
469
+ <td>✅ 견고함 (try-catch + 자동 복구)</td>
470
+ </tr>
471
+ <tr class="even">
472
+ <td>크로스 플랫폼</td>
473
+ <td>✅ Linux, macOS, Windows 지원</td>
474
+ </tr>
475
+ <tr class="odd">
476
+ <td>문서화</td>
477
+ <td>✅ 포괄적 (설정, 도구, 트러블슈팅)</td>
478
+ </tr>
479
+ <tr class="even">
480
+ <td>MCP 표준</td>
481
+ <td>✅ 16개 도구와 리소스 제공</td>
482
+ </tr>
483
+ <tr class="odd">
484
+ <td>보안</td>
485
+ <td>⚠️ 개선 필요 (이메일 마스킹 강화)</td>
486
+ </tr>
487
+ <tr class="even">
488
+ <td>테스트</td>
489
+ <td>❌ 부재 (추가 필요)</td>
490
+ </tr>
491
+ </tbody>
492
+ </table>
493
+ <hr>
494
+ </section>
495
+ <section id="결론" class="level1" data-number="7">
496
+ <h1 data-number="7"><span class="header-section-number">7</span> 결론</h1>
497
+ <p>NotebookLM MCP는 Gemini 2.5 기반 NotebookLM과의 통합이 견고하게 구현되어 있으며, Patchright를 활용한 Chrome 자동화가 봇 탐지를 효과적으로 회피합니다.</p>
498
+ <p><strong>즉시 개선 권장</strong>:</p>
499
+ <ol type="1">
500
+ <li>ESM 호환성 (<code>require()</code> → ESM import)</li>
501
+ <li>테스트 커버리지 추가</li>
502
+ <li>Rate limit 재시도 로직</li>
503
+ </ol>
504
+ <p>이러한 개선을 적용하면 더욱 안정적이고 유지보수 가능한 프로젝트가 될 것입니다.</p>
505
+ </section>
506
+
507
+ </main>
508
+ <!-- /main column -->
509
+ <script id="quarto-html-after-body" type="application/javascript">
510
+ window.document.addEventListener("DOMContentLoaded", function (event) {
511
+ const icon = "";
512
+ const anchorJS = new window.AnchorJS();
513
+ anchorJS.options = {
514
+ placement: 'right',
515
+ icon: icon
516
+ };
517
+ anchorJS.add('.anchored');
518
+ const isCodeAnnotation = (el) => {
519
+ for (const clz of el.classList) {
520
+ if (clz.startsWith('code-annotation-')) {
521
+ return true;
522
+ }
523
+ }
524
+ return false;
525
+ }
526
+ const onCopySuccess = function(e) {
527
+ // button target
528
+ const button = e.trigger;
529
+ // don't keep focus
530
+ button.blur();
531
+ // flash "checked"
532
+ button.classList.add('code-copy-button-checked');
533
+ var currentTitle = button.getAttribute("title");
534
+ button.setAttribute("title", "Copied!");
535
+ let tooltip;
536
+ if (window.bootstrap) {
537
+ button.setAttribute("data-bs-toggle", "tooltip");
538
+ button.setAttribute("data-bs-placement", "left");
539
+ button.setAttribute("data-bs-title", "Copied!");
540
+ tooltip = new bootstrap.Tooltip(button,
541
+ { trigger: "manual",
542
+ customClass: "code-copy-button-tooltip",
543
+ offset: [0, -8]});
544
+ tooltip.show();
545
+ }
546
+ setTimeout(function() {
547
+ if (tooltip) {
548
+ tooltip.hide();
549
+ button.removeAttribute("data-bs-title");
550
+ button.removeAttribute("data-bs-toggle");
551
+ button.removeAttribute("data-bs-placement");
552
+ }
553
+ button.setAttribute("title", currentTitle);
554
+ button.classList.remove('code-copy-button-checked');
555
+ }, 1000);
556
+ // clear code selection
557
+ e.clearSelection();
558
+ }
559
+ const getTextToCopy = function(trigger) {
560
+ const outerScaffold = trigger.parentElement.cloneNode(true);
561
+ const codeEl = outerScaffold.querySelector('code');
562
+ for (const childEl of codeEl.children) {
563
+ if (isCodeAnnotation(childEl)) {
564
+ childEl.remove();
565
+ }
566
+ }
567
+ return codeEl.innerText;
568
+ }
569
+ const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', {
570
+ text: getTextToCopy
571
+ });
572
+ clipboard.on('success', onCopySuccess);
573
+ if (window.document.getElementById('quarto-embedded-source-code-modal')) {
574
+ const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', {
575
+ text: getTextToCopy,
576
+ container: window.document.getElementById('quarto-embedded-source-code-modal')
577
+ });
578
+ clipboardModal.on('success', onCopySuccess);
579
+ }
580
+ var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//);
581
+ var mailtoRegex = new RegExp(/^mailto:/);
582
+ var filterRegex = new RegExp('/' + window.location.host + '/');
583
+ var isInternal = (href) => {
584
+ return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href);
585
+ }
586
+ // Inspect non-navigation links and adorn them if external
587
+ var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)');
588
+ for (var i=0; i<links.length; i++) {
589
+ const link = links[i];
590
+ if (!isInternal(link.href)) {
591
+ // undo the damage that might have been done by quarto-nav.js in the case of
592
+ // links that we want to consider external
593
+ if (link.dataset.originalHref !== undefined) {
594
+ link.href = link.dataset.originalHref;
595
+ }
596
+ }
597
+ }
598
+ function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) {
599
+ const config = {
600
+ allowHTML: true,
601
+ maxWidth: 500,
602
+ delay: 100,
603
+ arrow: false,
604
+ appendTo: function(el) {
605
+ return el.parentElement;
606
+ },
607
+ interactive: true,
608
+ interactiveBorder: 10,
609
+ theme: 'quarto',
610
+ placement: 'bottom-start',
611
+ };
612
+ if (contentFn) {
613
+ config.content = contentFn;
614
+ }
615
+ if (onTriggerFn) {
616
+ config.onTrigger = onTriggerFn;
617
+ }
618
+ if (onUntriggerFn) {
619
+ config.onUntrigger = onUntriggerFn;
620
+ }
621
+ window.tippy(el, config);
622
+ }
623
+ const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]');
624
+ for (var i=0; i<noterefs.length; i++) {
625
+ const ref = noterefs[i];
626
+ tippyHover(ref, function() {
627
+ // use id or data attribute instead here
628
+ let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
629
+ try { href = new URL(href).hash; } catch {}
630
+ const id = href.replace(/^#\/?/, "");
631
+ const note = window.document.getElementById(id);
632
+ if (note) {
633
+ return note.innerHTML;
634
+ } else {
635
+ return "";
636
+ }
637
+ });
638
+ }
639
+ const xrefs = window.document.querySelectorAll('a.quarto-xref');
640
+ const processXRef = (id, note) => {
641
+ // Strip column container classes
642
+ const stripColumnClz = (el) => {
643
+ el.classList.remove("page-full", "page-columns");
644
+ if (el.children) {
645
+ for (const child of el.children) {
646
+ stripColumnClz(child);
647
+ }
648
+ }
649
+ }
650
+ stripColumnClz(note)
651
+ if (id === null || id.startsWith('sec-')) {
652
+ // Special case sections, only their first couple elements
653
+ const container = document.createElement("div");
654
+ if (note.children && note.children.length > 2) {
655
+ container.appendChild(note.children[0].cloneNode(true));
656
+ for (let i = 1; i < note.children.length; i++) {
657
+ const child = note.children[i];
658
+ if (child.tagName === "P" && child.innerText === "") {
659
+ continue;
660
+ } else {
661
+ container.appendChild(child.cloneNode(true));
662
+ break;
663
+ }
664
+ }
665
+ if (window.Quarto?.typesetMath) {
666
+ window.Quarto.typesetMath(container);
667
+ }
668
+ return container.innerHTML
669
+ } else {
670
+ if (window.Quarto?.typesetMath) {
671
+ window.Quarto.typesetMath(note);
672
+ }
673
+ return note.innerHTML;
674
+ }
675
+ } else {
676
+ // Remove any anchor links if they are present
677
+ const anchorLink = note.querySelector('a.anchorjs-link');
678
+ if (anchorLink) {
679
+ anchorLink.remove();
680
+ }
681
+ if (window.Quarto?.typesetMath) {
682
+ window.Quarto.typesetMath(note);
683
+ }
684
+ if (note.classList.contains("callout")) {
685
+ return note.outerHTML;
686
+ } else {
687
+ return note.innerHTML;
688
+ }
689
+ }
690
+ }
691
+ for (var i=0; i<xrefs.length; i++) {
692
+ const xref = xrefs[i];
693
+ tippyHover(xref, undefined, function(instance) {
694
+ instance.disable();
695
+ let url = xref.getAttribute('href');
696
+ let hash = undefined;
697
+ if (url.startsWith('#')) {
698
+ hash = url;
699
+ } else {
700
+ try { hash = new URL(url).hash; } catch {}
701
+ }
702
+ if (hash) {
703
+ const id = hash.replace(/^#\/?/, "");
704
+ const note = window.document.getElementById(id);
705
+ if (note !== null) {
706
+ try {
707
+ const html = processXRef(id, note.cloneNode(true));
708
+ instance.setContent(html);
709
+ } finally {
710
+ instance.enable();
711
+ instance.show();
712
+ }
713
+ } else {
714
+ // See if we can fetch this
715
+ fetch(url.split('#')[0])
716
+ .then(res => res.text())
717
+ .then(html => {
718
+ const parser = new DOMParser();
719
+ const htmlDoc = parser.parseFromString(html, "text/html");
720
+ const note = htmlDoc.getElementById(id);
721
+ if (note !== null) {
722
+ const html = processXRef(id, note);
723
+ instance.setContent(html);
724
+ }
725
+ }).finally(() => {
726
+ instance.enable();
727
+ instance.show();
728
+ });
729
+ }
730
+ } else {
731
+ // See if we can fetch a full url (with no hash to target)
732
+ // This is a special case and we should probably do some content thinning / targeting
733
+ fetch(url)
734
+ .then(res => res.text())
735
+ .then(html => {
736
+ const parser = new DOMParser();
737
+ const htmlDoc = parser.parseFromString(html, "text/html");
738
+ const note = htmlDoc.querySelector('main.content');
739
+ if (note !== null) {
740
+ // This should only happen for chapter cross references
741
+ // (since there is no id in the URL)
742
+ // remove the first header
743
+ if (note.children.length > 0 && note.children[0].tagName === "HEADER") {
744
+ note.children[0].remove();
745
+ }
746
+ const html = processXRef(null, note);
747
+ instance.setContent(html);
748
+ }
749
+ }).finally(() => {
750
+ instance.enable();
751
+ instance.show();
752
+ });
753
+ }
754
+ }, function(instance) {
755
+ });
756
+ }
757
+ let selectedAnnoteEl;
758
+ const selectorForAnnotation = ( cell, annotation) => {
759
+ let cellAttr = 'data-code-cell="' + cell + '"';
760
+ let lineAttr = 'data-code-annotation="' + annotation + '"';
761
+ const selector = 'span[' + cellAttr + '][' + lineAttr + ']';
762
+ return selector;
763
+ }
764
+ const selectCodeLines = (annoteEl) => {
765
+ const doc = window.document;
766
+ const targetCell = annoteEl.getAttribute("data-target-cell");
767
+ const targetAnnotation = annoteEl.getAttribute("data-target-annotation");
768
+ const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation));
769
+ const lines = annoteSpan.getAttribute("data-code-lines").split(",");
770
+ const lineIds = lines.map((line) => {
771
+ return targetCell + "-" + line;
772
+ })
773
+ let top = null;
774
+ let height = null;
775
+ let parent = null;
776
+ if (lineIds.length > 0) {
777
+ //compute the position of the single el (top and bottom and make a div)
778
+ const el = window.document.getElementById(lineIds[0]);
779
+ top = el.offsetTop;
780
+ height = el.offsetHeight;
781
+ parent = el.parentElement.parentElement;
782
+ if (lineIds.length > 1) {
783
+ const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]);
784
+ const bottom = lastEl.offsetTop + lastEl.offsetHeight;
785
+ height = bottom - top;
786
+ }
787
+ if (top !== null && height !== null && parent !== null) {
788
+ // cook up a div (if necessary) and position it
789
+ let div = window.document.getElementById("code-annotation-line-highlight");
790
+ if (div === null) {
791
+ div = window.document.createElement("div");
792
+ div.setAttribute("id", "code-annotation-line-highlight");
793
+ div.style.position = 'absolute';
794
+ parent.appendChild(div);
795
+ }
796
+ div.style.top = top - 2 + "px";
797
+ div.style.height = height + 4 + "px";
798
+ div.style.left = 0;
799
+ let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter");
800
+ if (gutterDiv === null) {
801
+ gutterDiv = window.document.createElement("div");
802
+ gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter");
803
+ gutterDiv.style.position = 'absolute';
804
+ const codeCell = window.document.getElementById(targetCell);
805
+ const gutter = codeCell.querySelector('.code-annotation-gutter');
806
+ gutter.appendChild(gutterDiv);
807
+ }
808
+ gutterDiv.style.top = top - 2 + "px";
809
+ gutterDiv.style.height = height + 4 + "px";
810
+ }
811
+ selectedAnnoteEl = annoteEl;
812
+ }
813
+ };
814
+ const unselectCodeLines = () => {
815
+ const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"];
816
+ elementsIds.forEach((elId) => {
817
+ const div = window.document.getElementById(elId);
818
+ if (div) {
819
+ div.remove();
820
+ }
821
+ });
822
+ selectedAnnoteEl = undefined;
823
+ };
824
+ // Handle positioning of the toggle
825
+ window.addEventListener(
826
+ "resize",
827
+ throttle(() => {
828
+ elRect = undefined;
829
+ if (selectedAnnoteEl) {
830
+ selectCodeLines(selectedAnnoteEl);
831
+ }
832
+ }, 10)
833
+ );
834
+ function throttle(fn, ms) {
835
+ let throttle = false;
836
+ let timer;
837
+ return (...args) => {
838
+ if(!throttle) { // first call gets through
839
+ fn.apply(this, args);
840
+ throttle = true;
841
+ } else { // all the others get throttled
842
+ if(timer) clearTimeout(timer); // cancel #2
843
+ timer = setTimeout(() => {
844
+ fn.apply(this, args);
845
+ timer = throttle = false;
846
+ }, ms);
847
+ }
848
+ };
849
+ }
850
+ // Attach click handler to the DT
851
+ const annoteDls = window.document.querySelectorAll('dt[data-target-cell]');
852
+ for (const annoteDlNode of annoteDls) {
853
+ annoteDlNode.addEventListener('click', (event) => {
854
+ const clickedEl = event.target;
855
+ if (clickedEl !== selectedAnnoteEl) {
856
+ unselectCodeLines();
857
+ const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active');
858
+ if (activeEl) {
859
+ activeEl.classList.remove('code-annotation-active');
860
+ }
861
+ selectCodeLines(clickedEl);
862
+ clickedEl.classList.add('code-annotation-active');
863
+ } else {
864
+ // Unselect the line
865
+ unselectCodeLines();
866
+ clickedEl.classList.remove('code-annotation-active');
867
+ }
868
+ });
869
+ }
870
+ const findCites = (el) => {
871
+ const parentEl = el.parentElement;
872
+ if (parentEl) {
873
+ const cites = parentEl.dataset.cites;
874
+ if (cites) {
875
+ return {
876
+ el,
877
+ cites: cites.split(' ')
878
+ };
879
+ } else {
880
+ return findCites(el.parentElement)
881
+ }
882
+ } else {
883
+ return undefined;
884
+ }
885
+ };
886
+ var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
887
+ for (var i=0; i<bibliorefs.length; i++) {
888
+ const ref = bibliorefs[i];
889
+ const citeInfo = findCites(ref);
890
+ if (citeInfo) {
891
+ tippyHover(citeInfo.el, function() {
892
+ var popup = window.document.createElement('div');
893
+ citeInfo.cites.forEach(function(cite) {
894
+ var citeDiv = window.document.createElement('div');
895
+ citeDiv.classList.add('hanging-indent');
896
+ citeDiv.classList.add('csl-entry');
897
+ var biblioDiv = window.document.getElementById('ref-' + cite);
898
+ if (biblioDiv) {
899
+ citeDiv.innerHTML = biblioDiv.innerHTML;
900
+ }
901
+ popup.appendChild(citeDiv);
902
+ });
903
+ return popup.innerHTML;
904
+ });
905
+ }
906
+ }
907
+ });
908
+ </script>
909
+ </div> <!-- /content -->
910
+
911
+
912
+
913
+
914
+ </body></html>