makker 0.3.0rc1__tar.gz

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 (369) hide show
  1. makker-0.3.0rc1/.gitignore +55 -0
  2. makker-0.3.0rc1/AGENTS.md +190 -0
  3. makker-0.3.0rc1/LICENSE +21 -0
  4. makker-0.3.0rc1/PKG-INFO +157 -0
  5. makker-0.3.0rc1/README.md +116 -0
  6. makker-0.3.0rc1/bridge/jutul-agent/README.md +20 -0
  7. makker-0.3.0rc1/bridge/jutul-agent/pyproject.toml +38 -0
  8. makker-0.3.0rc1/docs/README.md +105 -0
  9. makker-0.3.0rc1/docs/adding-a-simulator.md +185 -0
  10. makker-0.3.0rc1/docs/agent-first.md +182 -0
  11. makker-0.3.0rc1/docs/approval.md +73 -0
  12. makker-0.3.0rc1/docs/architecture.md +232 -0
  13. makker-0.3.0rc1/docs/assets/architecture-dark.svg +708 -0
  14. makker-0.3.0rc1/docs/assets/architecture-light.svg +708 -0
  15. makker-0.3.0rc1/docs/assets/architecture.tex +170 -0
  16. makker-0.3.0rc1/docs/assets/favicon.svg +4 -0
  17. makker-0.3.0rc1/docs/assets/render-architecture.sh +14 -0
  18. makker-0.3.0rc1/docs/benchmark-records.jsonl +492 -0
  19. makker-0.3.0rc1/docs/benchmark.md +236 -0
  20. makker-0.3.0rc1/docs/cli.md +232 -0
  21. makker-0.3.0rc1/docs/configuration.md +115 -0
  22. makker-0.3.0rc1/docs/context.md +102 -0
  23. makker-0.3.0rc1/docs/development.md +179 -0
  24. makker-0.3.0rc1/docs/evaluation.md +281 -0
  25. makker-0.3.0rc1/docs/extending-for-your-application.md +160 -0
  26. makker-0.3.0rc1/docs/filesystem.md +59 -0
  27. makker-0.3.0rc1/docs/images/review-dashboard.png +0 -0
  28. makker-0.3.0rc1/docs/images/web-battmo.png +0 -0
  29. makker-0.3.0rc1/docs/images/web-fimbul.png +0 -0
  30. makker-0.3.0rc1/docs/images/web-jutuldarcy.png +0 -0
  31. makker-0.3.0rc1/docs/improving-the-agent.md +89 -0
  32. makker-0.3.0rc1/docs/julia-kernel.md +108 -0
  33. makker-0.3.0rc1/docs/lab.md +110 -0
  34. makker-0.3.0rc1/docs/memory.md +58 -0
  35. makker-0.3.0rc1/docs/models.md +116 -0
  36. makker-0.3.0rc1/docs/review.md +187 -0
  37. makker-0.3.0rc1/docs/server-interface.md +432 -0
  38. makker-0.3.0rc1/docs/stylesheets/extra.css +223 -0
  39. makker-0.3.0rc1/docs/sysimage.md +222 -0
  40. makker-0.3.0rc1/docs/testing.md +102 -0
  41. makker-0.3.0rc1/docs/trace.md +91 -0
  42. makker-0.3.0rc1/docs/turns.md +81 -0
  43. makker-0.3.0rc1/docs/usage.md +311 -0
  44. makker-0.3.0rc1/docs/web-ui.md +99 -0
  45. makker-0.3.0rc1/examples/demo-app/README.md +49 -0
  46. makker-0.3.0rc1/pyproject.toml +150 -0
  47. makker-0.3.0rc1/src/makker/__init__.py +33 -0
  48. makker-0.3.0rc1/src/makker/__main__.py +23 -0
  49. makker-0.3.0rc1/src/makker/_version.py +24 -0
  50. makker-0.3.0rc1/src/makker/agent/__init__.py +0 -0
  51. makker-0.3.0rc1/src/makker/agent/added_dirs.py +117 -0
  52. makker-0.3.0rc1/src/makker/agent/approval.py +278 -0
  53. makker-0.3.0rc1/src/makker/agent/backend.py +160 -0
  54. makker-0.3.0rc1/src/makker/agent/builder.py +530 -0
  55. makker-0.3.0rc1/src/makker/agent/capabilities.py +355 -0
  56. makker-0.3.0rc1/src/makker/agent/context_editing.py +74 -0
  57. makker-0.3.0rc1/src/makker/agent/memory.py +267 -0
  58. makker-0.3.0rc1/src/makker/agent/openrouter.py +34 -0
  59. makker-0.3.0rc1/src/makker/agent/plot_julia.py +784 -0
  60. makker-0.3.0rc1/src/makker/agent/plot_julia_src.py +806 -0
  61. makker-0.3.0rc1/src/makker/agent/prompts.py +244 -0
  62. makker-0.3.0rc1/src/makker/agent/recovery.py +127 -0
  63. makker-0.3.0rc1/src/makker/agent/summarization.py +163 -0
  64. makker-0.3.0rc1/src/makker/agent/titling.py +60 -0
  65. makker-0.3.0rc1/src/makker/agent/tool_output.py +86 -0
  66. makker-0.3.0rc1/src/makker/agent/tools.py +358 -0
  67. makker-0.3.0rc1/src/makker/agent/turns.py +431 -0
  68. makker-0.3.0rc1/src/makker/agent/windows_paths.py +133 -0
  69. makker-0.3.0rc1/src/makker/approval_preview.py +270 -0
  70. makker-0.3.0rc1/src/makker/context_panel.py +239 -0
  71. makker-0.3.0rc1/src/makker/credentials.py +163 -0
  72. makker-0.3.0rc1/src/makker/display.py +188 -0
  73. makker-0.3.0rc1/src/makker/eval/__init__.py +22 -0
  74. makker-0.3.0rc1/src/makker/eval/_gemini_compat.py +65 -0
  75. makker-0.3.0rc1/src/makker/eval/report.py +475 -0
  76. makker-0.3.0rc1/src/makker/eval/runconfig.py +91 -0
  77. makker-0.3.0rc1/src/makker/eval/scorers.py +712 -0
  78. makker-0.3.0rc1/src/makker/eval/solver.py +295 -0
  79. makker-0.3.0rc1/src/makker/eval/tasks/__init__.py +1 -0
  80. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/Project.toml +3 -0
  81. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/README.md +4 -0
  82. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/docs/api.md +7 -0
  83. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/examples/advanced/sweep.jl +8 -0
  84. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/examples/quickstart.jl +6 -0
  85. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/MiniRes.jl +13 -0
  86. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/grid.jl +8 -0
  87. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/physics/darcy.jl +13 -0
  88. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/physics/wells.jl +15 -0
  89. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/solver/newton.jl +15 -0
  90. makker-0.3.0rc1/src/makker/eval/tasks/_corpus/__init__.py +54 -0
  91. makker-0.3.0rc1/src/makker/eval/tasks/api_discovery.py +122 -0
  92. makker-0.3.0rc1/src/makker/eval/tasks/battmo.py +88 -0
  93. makker-0.3.0rc1/src/makker/eval/tasks/calibration.py +82 -0
  94. makker-0.3.0rc1/src/makker/eval/tasks/canary.py +41 -0
  95. makker-0.3.0rc1/src/makker/eval/tasks/ensembles.py +209 -0
  96. makker-0.3.0rc1/src/makker/eval/tasks/filesystem.py +290 -0
  97. makker-0.3.0rc1/src/makker/eval/tasks/filesystem_source.py +80 -0
  98. makker-0.3.0rc1/src/makker/eval/tasks/fimbul.py +51 -0
  99. makker-0.3.0rc1/src/makker/eval/tasks/guardrails.py +47 -0
  100. makker-0.3.0rc1/src/makker/eval/tasks/jutuldarcy.py +139 -0
  101. makker-0.3.0rc1/src/makker/eval/tasks/mocca.py +90 -0
  102. makker-0.3.0rc1/src/makker/eval/tasks/plotting.py +111 -0
  103. makker-0.3.0rc1/src/makker/eval/tasks/search.py +211 -0
  104. makker-0.3.0rc1/src/makker/eval/tasks/search_source.py +71 -0
  105. makker-0.3.0rc1/src/makker/eval/tasks/usage.py +138 -0
  106. makker-0.3.0rc1/src/makker/interfaces/__init__.py +0 -0
  107. makker-0.3.0rc1/src/makker/interfaces/cli/__init__.py +10 -0
  108. makker-0.3.0rc1/src/makker/interfaces/cli/_helpers.py +197 -0
  109. makker-0.3.0rc1/src/makker/interfaces/cli/doctor.py +427 -0
  110. makker-0.3.0rc1/src/makker/interfaces/cli/eval.py +198 -0
  111. makker-0.3.0rc1/src/makker/interfaces/cli/init.py +268 -0
  112. makker-0.3.0rc1/src/makker/interfaces/cli/key.py +117 -0
  113. makker-0.3.0rc1/src/makker/interfaces/cli/main.py +207 -0
  114. makker-0.3.0rc1/src/makker/interfaces/cli/review.py +538 -0
  115. makker-0.3.0rc1/src/makker/interfaces/cli/run.py +412 -0
  116. makker-0.3.0rc1/src/makker/interfaces/cli/sessions.py +45 -0
  117. makker-0.3.0rc1/src/makker/interfaces/cli/sysimage.py +223 -0
  118. makker-0.3.0rc1/src/makker/interfaces/cli/transcript.py +102 -0
  119. makker-0.3.0rc1/src/makker/interfaces/cli/upgrade.py +369 -0
  120. makker-0.3.0rc1/src/makker/interfaces/cli/web.py +314 -0
  121. makker-0.3.0rc1/src/makker/interfaces/server/__init__.py +13 -0
  122. makker-0.3.0rc1/src/makker/interfaces/server/access.py +148 -0
  123. makker-0.3.0rc1/src/makker/interfaces/server/app.py +2443 -0
  124. makker-0.3.0rc1/src/makker/interfaces/server/manager.py +292 -0
  125. makker-0.3.0rc1/src/makker/interfaces/server/protocol.py +321 -0
  126. makker-0.3.0rc1/src/makker/interfaces/server/update_helper.py +199 -0
  127. makker-0.3.0rc1/src/makker/interfaces/server/updates.py +446 -0
  128. makker-0.3.0rc1/src/makker/interfaces/server/web_dist/assets/index-BcWXsrUW.js +54 -0
  129. makker-0.3.0rc1/src/makker/interfaces/server/web_dist/assets/index-Cbigi-bs.css +1 -0
  130. makker-0.3.0rc1/src/makker/interfaces/server/web_dist/index.html +17 -0
  131. makker-0.3.0rc1/src/makker/interfaces/tui/__init__.py +5 -0
  132. makker-0.3.0rc1/src/makker/interfaces/tui/app.py +1779 -0
  133. makker-0.3.0rc1/src/makker/interfaces/tui/approval_menu.py +227 -0
  134. makker-0.3.0rc1/src/makker/interfaces/tui/commands.py +143 -0
  135. makker-0.3.0rc1/src/makker/interfaces/tui/model_menu.py +416 -0
  136. makker-0.3.0rc1/src/makker/interfaces/tui/prompt.py +210 -0
  137. makker-0.3.0rc1/src/makker/interfaces/tui/tool_display.py +440 -0
  138. makker-0.3.0rc1/src/makker/interfaces/tui/widgets.py +991 -0
  139. makker-0.3.0rc1/src/makker/julia/__init__.py +0 -0
  140. makker-0.3.0rc1/src/makker/julia/precompile.py +120 -0
  141. makker-0.3.0rc1/src/makker/julia/requirements.py +101 -0
  142. makker-0.3.0rc1/src/makker/julia/session.py +49 -0
  143. makker-0.3.0rc1/src/makker/julia/threads.py +126 -0
  144. makker-0.3.0rc1/src/makker/julia_runtime/Makker/Project.toml +21 -0
  145. makker-0.3.0rc1/src/makker/julia_runtime/Makker/src/Makker.jl +99 -0
  146. makker-0.3.0rc1/src/makker/julia_runtime/Makker/src/ensemble.jl +104 -0
  147. makker-0.3.0rc1/src/makker/julia_runtime/Makker/src/plots.jl +292 -0
  148. makker-0.3.0rc1/src/makker/julia_runtime/Makker/src/web_views.jl +77 -0
  149. makker-0.3.0rc1/src/makker/juliakernel/__init__.py +19 -0
  150. makker-0.3.0rc1/src/makker/juliakernel/config.py +35 -0
  151. makker-0.3.0rc1/src/makker/juliakernel/connection.py +261 -0
  152. makker-0.3.0rc1/src/makker/juliakernel/kernel.py +509 -0
  153. makker-0.3.0rc1/src/makker/juliakernel/result.py +37 -0
  154. makker-0.3.0rc1/src/makker/juliakernel/server.jl +263 -0
  155. makker-0.3.0rc1/src/makker/juliakernel/text.py +211 -0
  156. makker-0.3.0rc1/src/makker/lab/__init__.py +19 -0
  157. makker-0.3.0rc1/src/makker/lab/fakes.py +744 -0
  158. makker-0.3.0rc1/src/makker/lab/live.py +225 -0
  159. makker-0.3.0rc1/src/makker/lab/profile_startup.py +144 -0
  160. makker-0.3.0rc1/src/makker/lab/profile_turn.py +70 -0
  161. makker-0.3.0rc1/src/makker/lab/rasterize.py +73 -0
  162. makker-0.3.0rc1/src/makker/lab/scenarios.py +255 -0
  163. makker-0.3.0rc1/src/makker/lab/tui.py +194 -0
  164. makker-0.3.0rc1/src/makker/legacy.py +298 -0
  165. makker-0.3.0rc1/src/makker/models.py +441 -0
  166. makker-0.3.0rc1/src/makker/ollama_client.py +177 -0
  167. makker-0.3.0rc1/src/makker/open_file.py +54 -0
  168. makker-0.3.0rc1/src/makker/paths.py +205 -0
  169. makker-0.3.0rc1/src/makker/preview.py +70 -0
  170. makker-0.3.0rc1/src/makker/py.typed +0 -0
  171. makker-0.3.0rc1/src/makker/recent_models.py +47 -0
  172. makker-0.3.0rc1/src/makker/review/__init__.py +40 -0
  173. makker-0.3.0rc1/src/makker/review/curate.py +135 -0
  174. makker-0.3.0rc1/src/makker/review/dashboard.py +216 -0
  175. makker-0.3.0rc1/src/makker/review/dashboard_template.html +384 -0
  176. makker-0.3.0rc1/src/makker/review/discovery.py +159 -0
  177. makker-0.3.0rc1/src/makker/review/eval_link.py +81 -0
  178. makker-0.3.0rc1/src/makker/review/export.py +74 -0
  179. makker-0.3.0rc1/src/makker/review/findings.py +176 -0
  180. makker-0.3.0rc1/src/makker/review/issues.py +190 -0
  181. makker-0.3.0rc1/src/makker/review/prompt.py +195 -0
  182. makker-0.3.0rc1/src/makker/review/reviewer.py +195 -0
  183. makker-0.3.0rc1/src/makker/review/server.py +109 -0
  184. makker-0.3.0rc1/src/makker/review/settings.py +28 -0
  185. makker-0.3.0rc1/src/makker/session.py +510 -0
  186. makker-0.3.0rc1/src/makker/session_host.py +696 -0
  187. makker-0.3.0rc1/src/makker/simulators/README.md +50 -0
  188. makker-0.3.0rc1/src/makker/simulators/__init__.py +0 -0
  189. makker-0.3.0rc1/src/makker/simulators/base.py +63 -0
  190. makker-0.3.0rc1/src/makker/simulators/battmo/__init__.py +3 -0
  191. makker-0.3.0rc1/src/makker/simulators/battmo/adapter.py +39 -0
  192. makker-0.3.0rc1/src/makker/simulators/battmo/julia_env/MakkerBattMo/Project.toml +21 -0
  193. makker-0.3.0rc1/src/makker/simulators/battmo/julia_env/MakkerBattMo/src/MakkerBattMo.jl +43 -0
  194. makker-0.3.0rc1/src/makker/simulators/battmo/julia_env/Project.toml +34 -0
  195. makker-0.3.0rc1/src/makker/simulators/battmo/skills/battmo-cycling/SKILL.md +33 -0
  196. makker-0.3.0rc1/src/makker/simulators/battmo/skills/battmo-overview/SKILL.md +55 -0
  197. makker-0.3.0rc1/src/makker/simulators/battmo/skills/battmo-plotting/SKILL.md +46 -0
  198. makker-0.3.0rc1/src/makker/simulators/env_setup.py +980 -0
  199. makker-0.3.0rc1/src/makker/simulators/fimbul/__init__.py +3 -0
  200. makker-0.3.0rc1/src/makker/simulators/fimbul/adapter.py +43 -0
  201. makker-0.3.0rc1/src/makker/simulators/fimbul/julia_env/MakkerFimbul/Project.toml +23 -0
  202. makker-0.3.0rc1/src/makker/simulators/fimbul/julia_env/MakkerFimbul/src/MakkerFimbul.jl +89 -0
  203. makker-0.3.0rc1/src/makker/simulators/fimbul/julia_env/Project.toml +40 -0
  204. makker-0.3.0rc1/src/makker/simulators/fimbul/skills/fimbul-overview/SKILL.md +72 -0
  205. makker-0.3.0rc1/src/makker/simulators/fimbul/skills/fimbul-plotting/SKILL.md +69 -0
  206. makker-0.3.0rc1/src/makker/simulators/jutuldarcy/__init__.py +3 -0
  207. makker-0.3.0rc1/src/makker/simulators/jutuldarcy/adapter.py +41 -0
  208. makker-0.3.0rc1/src/makker/simulators/jutuldarcy/julia_env/MakkerJutulDarcy/Project.toml +24 -0
  209. makker-0.3.0rc1/src/makker/simulators/jutuldarcy/julia_env/MakkerJutulDarcy/src/MakkerJutulDarcy.jl +149 -0
  210. makker-0.3.0rc1/src/makker/simulators/jutuldarcy/julia_env/Project.toml +37 -0
  211. makker-0.3.0rc1/src/makker/simulators/jutuldarcy/skills/jutuldarcy-overview/SKILL.md +82 -0
  212. makker-0.3.0rc1/src/makker/simulators/jutuldarcy/skills/jutuldarcy-plotting/SKILL.md +74 -0
  213. makker-0.3.0rc1/src/makker/simulators/jutuldarcy/skills/jutuldarcy-wells/SKILL.md +67 -0
  214. makker-0.3.0rc1/src/makker/simulators/mocca/__init__.py +3 -0
  215. makker-0.3.0rc1/src/makker/simulators/mocca/adapter.py +40 -0
  216. makker-0.3.0rc1/src/makker/simulators/mocca/julia_env/MakkerMocca/Project.toml +22 -0
  217. makker-0.3.0rc1/src/makker/simulators/mocca/julia_env/MakkerMocca/src/MakkerMocca.jl +55 -0
  218. makker-0.3.0rc1/src/makker/simulators/mocca/julia_env/Project.toml +35 -0
  219. makker-0.3.0rc1/src/makker/simulators/mocca/skills/mocca-overview/SKILL.md +125 -0
  220. makker-0.3.0rc1/src/makker/simulators/registry.py +147 -0
  221. makker-0.3.0rc1/src/makker/simulators/shared_skills/ensembles/SKILL.md +94 -0
  222. makker-0.3.0rc1/src/makker/simulators/shared_skills/investigation-loop/SKILL.md +101 -0
  223. makker-0.3.0rc1/src/makker/simulators/shared_skills/julia-and-repl/SKILL.md +93 -0
  224. makker-0.3.0rc1/src/makker/simulators/shared_skills/plotting-basics/SKILL.md +138 -0
  225. makker-0.3.0rc1/src/makker/simulators/shared_skills/workspace-and-source/SKILL.md +110 -0
  226. makker-0.3.0rc1/src/makker/simulators/warmup.py +212 -0
  227. makker-0.3.0rc1/src/makker/sysimage.py +548 -0
  228. makker-0.3.0rc1/src/makker/sysimage_build.py +881 -0
  229. makker-0.3.0rc1/src/makker/tool_labels.py +35 -0
  230. makker-0.3.0rc1/src/makker/trace/__init__.py +10 -0
  231. makker-0.3.0rc1/src/makker/trace/log.py +155 -0
  232. makker-0.3.0rc1/src/makker/trace/messages.py +46 -0
  233. makker-0.3.0rc1/src/makker/trace/recorder.py +141 -0
  234. makker-0.3.0rc1/src/makker/trace/schema.py +129 -0
  235. makker-0.3.0rc1/src/makker/transcript/__init__.py +8 -0
  236. makker-0.3.0rc1/src/makker/transcript/attempts.py +67 -0
  237. makker-0.3.0rc1/src/makker/transcript/bundle.py +18 -0
  238. makker-0.3.0rc1/src/makker/transcript/embed.py +55 -0
  239. makker-0.3.0rc1/src/makker/transcript/events.py +77 -0
  240. makker-0.3.0rc1/src/makker/transcript/highlight.py +143 -0
  241. makker-0.3.0rc1/src/makker/transcript/html.py +1031 -0
  242. makker-0.3.0rc1/src/makker/transcript/markdown.py +176 -0
  243. makker-0.3.0rc1/src/makker/transcript/markdown_html.py +65 -0
  244. makker-0.3.0rc1/src/makker/transcript/report.py +1076 -0
  245. makker-0.3.0rc1/src/makker/update_check.py +329 -0
  246. makker-0.3.0rc1/src/makker/user_config.py +51 -0
  247. makker-0.3.0rc1/src/makker/workspace.py +1130 -0
  248. makker-0.3.0rc1/tests/__snapshots__/test_report_renderer.ambr +340 -0
  249. makker-0.3.0rc1/tests/__snapshots__/test_transcript.ambr +75 -0
  250. makker-0.3.0rc1/tests/__snapshots__/test_transcript_html.ambr +7149 -0
  251. makker-0.3.0rc1/tests/_tui.py +27 -0
  252. makker-0.3.0rc1/tests/conftest.py +113 -0
  253. makker-0.3.0rc1/tests/integration/test_julia_plot_integration.py +493 -0
  254. makker-0.3.0rc1/tests/integration/web_capture.jl +67 -0
  255. makker-0.3.0rc1/tests/integration/web_views.jl +66 -0
  256. makker-0.3.0rc1/tests/live/README.md +48 -0
  257. makker-0.3.0rc1/tests/live/test_live_smoke.py +90 -0
  258. makker-0.3.0rc1/tests/test_added_dirs.py +102 -0
  259. makker-0.3.0rc1/tests/test_approval.py +171 -0
  260. makker-0.3.0rc1/tests/test_approval_menu.py +28 -0
  261. makker-0.3.0rc1/tests/test_approval_mode.py +75 -0
  262. makker-0.3.0rc1/tests/test_attempt_tree.py +56 -0
  263. makker-0.3.0rc1/tests/test_bridge.py +151 -0
  264. makker-0.3.0rc1/tests/test_builder.py +364 -0
  265. makker-0.3.0rc1/tests/test_capabilities.py +304 -0
  266. makker-0.3.0rc1/tests/test_chat_app.py +1481 -0
  267. makker-0.3.0rc1/tests/test_chat_integration.py +166 -0
  268. makker-0.3.0rc1/tests/test_cli_init.py +152 -0
  269. makker-0.3.0rc1/tests/test_cli_key.py +58 -0
  270. makker-0.3.0rc1/tests/test_cli_resume.py +64 -0
  271. makker-0.3.0rc1/tests/test_cli_startup.py +57 -0
  272. makker-0.3.0rc1/tests/test_cli_transcript.py +182 -0
  273. makker-0.3.0rc1/tests/test_cli_upgrade.py +243 -0
  274. makker-0.3.0rc1/tests/test_cli_web.py +156 -0
  275. makker-0.3.0rc1/tests/test_context_editing.py +89 -0
  276. makker-0.3.0rc1/tests/test_context_panel.py +117 -0
  277. makker-0.3.0rc1/tests/test_credentials.py +148 -0
  278. makker-0.3.0rc1/tests/test_deepagents_canaries.py +55 -0
  279. makker-0.3.0rc1/tests/test_demo_app.py +77 -0
  280. makker-0.3.0rc1/tests/test_display.py +133 -0
  281. makker-0.3.0rc1/tests/test_doctor.py +85 -0
  282. makker-0.3.0rc1/tests/test_doctor_plotting.py +49 -0
  283. makker-0.3.0rc1/tests/test_doctor_sysimage.py +77 -0
  284. makker-0.3.0rc1/tests/test_end_to_end.py +383 -0
  285. makker-0.3.0rc1/tests/test_env_setup.py +913 -0
  286. makker-0.3.0rc1/tests/test_env_template_stamp.py +218 -0
  287. makker-0.3.0rc1/tests/test_ephemeral_memory.py +57 -0
  288. makker-0.3.0rc1/tests/test_eval_bench.py +684 -0
  289. makker-0.3.0rc1/tests/test_eval_report.py +156 -0
  290. makker-0.3.0rc1/tests/test_eval_scorers.py +35 -0
  291. makker-0.3.0rc1/tests/test_highlight.py +37 -0
  292. makker-0.3.0rc1/tests/test_host_context.py +459 -0
  293. makker-0.3.0rc1/tests/test_julia_precompile.py +114 -0
  294. makker-0.3.0rc1/tests/test_julia_requirements.py +94 -0
  295. makker-0.3.0rc1/tests/test_julia_streaming.py +75 -0
  296. makker-0.3.0rc1/tests/test_julia_text.py +62 -0
  297. makker-0.3.0rc1/tests/test_julia_threads.py +114 -0
  298. makker-0.3.0rc1/tests/test_juliakernel.py +427 -0
  299. makker-0.3.0rc1/tests/test_kernel_robustness.py +87 -0
  300. makker-0.3.0rc1/tests/test_lab.py +100 -0
  301. makker-0.3.0rc1/tests/test_legacy.py +350 -0
  302. makker-0.3.0rc1/tests/test_markdown_render.py +78 -0
  303. makker-0.3.0rc1/tests/test_memory.py +128 -0
  304. makker-0.3.0rc1/tests/test_messages.py +35 -0
  305. makker-0.3.0rc1/tests/test_model_menu.py +213 -0
  306. makker-0.3.0rc1/tests/test_models.py +275 -0
  307. makker-0.3.0rc1/tests/test_ollama_client.py +183 -0
  308. makker-0.3.0rc1/tests/test_openai_responses.py +72 -0
  309. makker-0.3.0rc1/tests/test_openrouter.py +100 -0
  310. makker-0.3.0rc1/tests/test_paths.py +93 -0
  311. makker-0.3.0rc1/tests/test_plot_julia_src.py +427 -0
  312. makker-0.3.0rc1/tests/test_plot_web.py +502 -0
  313. makker-0.3.0rc1/tests/test_prompts.py +73 -0
  314. makker-0.3.0rc1/tests/test_recent_models.py +42 -0
  315. makker-0.3.0rc1/tests/test_recorder.py +175 -0
  316. makker-0.3.0rc1/tests/test_recovery.py +127 -0
  317. makker-0.3.0rc1/tests/test_registry.py +115 -0
  318. makker-0.3.0rc1/tests/test_report_renderer.py +401 -0
  319. makker-0.3.0rc1/tests/test_reset_julia.py +112 -0
  320. makker-0.3.0rc1/tests/test_review.py +529 -0
  321. makker-0.3.0rc1/tests/test_server_access.py +138 -0
  322. makker-0.3.0rc1/tests/test_server_session.py +2513 -0
  323. makker-0.3.0rc1/tests/test_server_updates.py +584 -0
  324. makker-0.3.0rc1/tests/test_session_host_driver.py +84 -0
  325. makker-0.3.0rc1/tests/test_session_layout.py +308 -0
  326. makker-0.3.0rc1/tests/test_simulators_smoke.py +126 -0
  327. makker-0.3.0rc1/tests/test_skills_and_prompt.py +147 -0
  328. makker-0.3.0rc1/tests/test_smoke.py +167 -0
  329. makker-0.3.0rc1/tests/test_summarization.py +96 -0
  330. makker-0.3.0rc1/tests/test_sysimage.py +434 -0
  331. makker-0.3.0rc1/tests/test_sysimage_build.py +944 -0
  332. makker-0.3.0rc1/tests/test_sysimage_integration.py +164 -0
  333. makker-0.3.0rc1/tests/test_titling.py +52 -0
  334. makker-0.3.0rc1/tests/test_tool_display.py +251 -0
  335. makker-0.3.0rc1/tests/test_tool_eviction.py +58 -0
  336. makker-0.3.0rc1/tests/test_tool_output.py +47 -0
  337. makker-0.3.0rc1/tests/test_tools_julia_plot.py +414 -0
  338. makker-0.3.0rc1/tests/test_trace.py +61 -0
  339. makker-0.3.0rc1/tests/test_trace_schema.py +54 -0
  340. makker-0.3.0rc1/tests/test_transcript.py +84 -0
  341. makker-0.3.0rc1/tests/test_transcript_html.py +396 -0
  342. makker-0.3.0rc1/tests/test_turns.py +308 -0
  343. makker-0.3.0rc1/tests/test_update_check.py +192 -0
  344. makker-0.3.0rc1/tests/test_update_helper.py +217 -0
  345. makker-0.3.0rc1/tests/test_user_config.py +36 -0
  346. makker-0.3.0rc1/tests/test_warm_source_refresh.py +139 -0
  347. makker-0.3.0rc1/tests/test_warmup.py +326 -0
  348. makker-0.3.0rc1/tests/test_warmup_package.py +143 -0
  349. makker-0.3.0rc1/tests/test_web_serving.py +139 -0
  350. makker-0.3.0rc1/tests/test_widgets.py +186 -0
  351. makker-0.3.0rc1/tests/test_windows_paths.py +134 -0
  352. makker-0.3.0rc1/tests/test_wire_protocol.py +296 -0
  353. makker-0.3.0rc1/tests/test_workspace.py +765 -0
  354. makker-0.3.0rc1/tests/test_workspace_backend.py +185 -0
  355. makker-0.3.0rc1/tests/tui_captures/tui/answer.txt +32 -0
  356. makker-0.3.0rc1/tests/tui_captures/tui/approval.txt +32 -0
  357. makker-0.3.0rc1/tests/tui_captures/tui/approval_resolved.txt +32 -0
  358. makker-0.3.0rc1/tests/tui_captures/tui/empty_answer.txt +32 -0
  359. makker-0.3.0rc1/tests/tui_captures/tui/long_output.txt +32 -0
  360. makker-0.3.0rc1/tests/tui_captures/tui/multi_turn.txt +32 -0
  361. makker-0.3.0rc1/tests/tui_captures/tui/narrow.txt +24 -0
  362. makker-0.3.0rc1/tests/tui_captures/tui/reasoning.txt +32 -0
  363. makker-0.3.0rc1/tests/tui_captures/tui/streaming.txt +32 -0
  364. makker-0.3.0rc1/tests/tui_captures/tui/tool_call.txt +32 -0
  365. makker-0.3.0rc1/tests/tui_captures/tui/tool_error.txt +32 -0
  366. makker-0.3.0rc1/tests/tui_captures/tui/unicode_output.txt +32 -0
  367. makker-0.3.0rc1/tests/tui_captures/tui/welcome.txt +32 -0
  368. makker-0.3.0rc1/tests/tui_captures/tui/wide_line.txt +32 -0
  369. makker-0.3.0rc1/tests/upgrade/check_upgrade.py +262 -0
@@ -0,0 +1,55 @@
1
+ # Python
2
+ __pycache__/
3
+ *.py[cod]
4
+ *.egg-info/
5
+ .venv/
6
+ .pytest_cache/
7
+ .ruff_cache/
8
+ .mypy_cache/
9
+ dist/
10
+ build/
11
+
12
+ # uv.lock is committed for reproducible installs (see [tool.uv] in pyproject.toml).
13
+
14
+ # Generated by hatch-vcs at build time from the latest git tag (see pyproject.toml).
15
+ src/makker/_version.py
16
+
17
+ # Secrets and local editor config
18
+ .env
19
+ .env.*
20
+ !.env.example
21
+ .mcp.json
22
+
23
+ # Project state
24
+ .makker/
25
+ .jutul-agent/
26
+
27
+ # Julia lockfiles
28
+ src/makker/**/Manifest.toml
29
+
30
+ # The shared Makker package synced into a sim env template for in-place
31
+ # instantiate (CI/tests). The canonical source lives in julia_runtime/ and the
32
+ # per-sim Makker<Sim> packages are tracked; only these synced copies are not.
33
+ src/makker/simulators/*/julia_env/Makker/
34
+
35
+ # IDE
36
+ .vscode/
37
+ .idea/
38
+
39
+ # Claude Code: share project commands, keep local settings/worktrees out.
40
+ .claude/*
41
+ !.claude/commands/
42
+ .claude/settings.local.json
43
+
44
+ # Scratch findings the `/review-mine` command writes before ingesting.
45
+ .makker-review/
46
+
47
+ # OS
48
+ .DS_Store
49
+ Thumbs.db
50
+ site/
51
+
52
+ # Local scratch / lab output
53
+ .makker-review/
54
+ lab-out/
55
+ testbed/
@@ -0,0 +1,190 @@
1
+ # Makker
2
+
3
+ ## Purpose
4
+
5
+ Makker is an AI agent for computational science, built on Deep Agents.
6
+ Simulators plug in as adapters. The ones it ships with today come from the Jutul
7
+ ecosystem and run in Julia.
8
+
9
+ ## Working rules
10
+
11
+ - Prefer the live Julia session and simulator source code over model memory.
12
+ - Use the persistent Julia REPL incrementally. Run the smallest useful probe
13
+ first, inspect the result, then extend.
14
+ - Treat the installed simulator packages as the source of truth for APIs and
15
+ examples.
16
+ - Keep Julia execution serialized unless the runtime explicitly supports
17
+ concurrency.
18
+ - Reuse a prepared Julia environment when its simulator and dependencies match;
19
+ pass it with `--julia-project` instead of setting up a new env for each task.
20
+ Refresh it when dependencies or the bundled Julia runtime change.
21
+ - Prefer Deep Agents memory and skills for reusable guidance; keep custom
22
+ Python focused on Julia execution, simulator inspection, and trace capture.
23
+
24
+ ## Validation
25
+
26
+ - Default suite (no Julia): `uv run pytest -q -m "not integration"`
27
+ - Integration suite (requires Julia + an instantiated env): `uv run pytest -q -m integration`.
28
+ Envs instantiate from `Project.toml` + `[sources]`.
29
+ `tests/test_simulators_smoke.py` loads each simulator with `using <Sim>`.
30
+ - Live LLM (humans only, needs API key): `uv run pytest tests/live/`
31
+ - Update transcript / report snapshots after renderer changes:
32
+ `uv run pytest --snapshot-update tests/test_transcript_html.py tests/test_transcript.py tests/test_report_renderer.py`
33
+ - Python style (matches CI): `uv run ruff check .` then `uv run ruff format .`
34
+ - After editing Python, run `uv run ruff format` on touched paths (or rely on
35
+ format-on-save / pre-commit if installed).
36
+ - Web UI (React + TypeScript in `interfaces/server/webapp`): `npm install`, then
37
+ `npm test` (vitest) and `npm run typecheck`. It ships **pre-built** — after any
38
+ change under `webapp/src`, run `npm run build` and commit the regenerated
39
+ `interfaces/server/web_dist`. That committed bundle is what the server serves,
40
+ so end users install with `uv`/`pip` and never need Node.
41
+
42
+ ## Continuous integration
43
+
44
+ GitHub Actions workflows:
45
+
46
+ - `ci.yml`: every push/PR. `lint` (ruff); `test` across Linux/Windows/macOS
47
+ on Python 3.12, plus Linux on 3.14, the newest Python `uv tool install` tends
48
+ to pick (`pytest -m "not integration" -n 2 --dist loadfile`, no Julia).
49
+ - `simulators.yml`: runs JuliaKernel and all four simulator integration jobs
50
+ on every PR and push to `main`, plus weekly Monday and manual runs. The
51
+ JutulDarcy smoke job also runs real plot tests. Each smoke job instantiates
52
+ its env from current upstream, precompiles, and runs `test_simulators_smoke.py`.
53
+ Depots are cached by Julia version, simulator, resolved dependencies, and Julia
54
+ source; no Manifests are cached or committed for CI.
55
+ - `deps-canary.yml`: weekly and manual only. Resolves the newest stack,
56
+ ignoring the pin, and reports to the run summary without ever marking a
57
+ commit red. It is the early warning for when the pin can move.
58
+ - `docs.yml`: builds the MkDocs site on changes under `docs/`, publishing on
59
+ `main`.
60
+ - `release.yml`: on a published GitHub release tagged `vX.Y.Z`, builds and
61
+ uploads to PyPI. The tag is the only source of the version.
62
+ - `upgrade.yml`: every push/PR, temporary. Installs a released jutul-agent,
63
+ updates it to this checkout (`tests/upgrade/check_upgrade.py`), and checks the
64
+ data folder and workspace came along, on Linux, macOS and Windows.
65
+ - `release-bridge.yml`: manual, run from a release tag. Publishes the last
66
+ release of the old package, jutul-agent (`bridge/jutul-agent`), which installs
67
+ Makker and starts it so existing installs move across on their next update.
68
+
69
+ ## Local git hooks
70
+
71
+ One-time per clone: `uv run pre-commit install`. Commits then run Ruff format
72
+ and check on staged `.py` files. To verify the whole tree like CI:
73
+ `uv run pre-commit run --all-files`.
74
+
75
+ ## Important paths
76
+
77
+ - `src/makker/paths.py`: the three runtime anchors (`PACKAGE_ROOT`
78
+ (install), `workspace_root()` (CWD), `state_home()` (sessions)) and the path
79
+ policy (`resolve_in_workspace`, `is_host_path`), the one place that maps
80
+ agent-visible paths to real files.
81
+ - `src/makker/workspace.py`: workspace config
82
+ (`.makker/config.toml`), simulator auto-detect, Julia-env bootstrap.
83
+ - `src/makker/session.py`: `Session`, the unit of work for one
84
+ invocation.
85
+ - `src/makker/models.py`: provider metadata and the model catalog
86
+ discovery. `src/makker/display.py`: display detection and Xvfb
87
+ management for headless plotting.
88
+ - `src/makker/agent/builder.py`: deepagents wiring (composite backend,
89
+ HarnessProfile registration, `build_agent` entry point). Custom tools sit
90
+ alongside (`tools.py`, `plot_julia.py`, `memory.py`, `approval.py`,
91
+ `turns.py`, and `added_dirs.py`, which records `/add-dir` folders);
92
+ `tool_labels.py` holds the one friendly name per tool shared by the TUI,
93
+ approval prompt, and transcript. The Julia-side plot capture lives in the
94
+ `julia_runtime/Makker` package. The full system prompt is assembled in
95
+ `prompts.py` (each rule stated once).
96
+ - `src/makker/simulators/`: adapter dataclass, registry, env bootstrap +
97
+ launch-time preparation (`env_setup.prepare_workspace_env`), shared skills,
98
+ and one folder per simulator (see below).
99
+ - `src/makker/julia/`: the `JuliaSession` Protocol (`session.py`) and the
100
+ Julia toolchain checks (`requirements.py`).
101
+ - `src/makker/juliakernel/`: the backend, a self-contained, supervised
102
+ Julia runtime (`kernel.py` + stdlib-only `server.jl`) with live output and
103
+ SIGINT interrupt. Splittable into a standalone package.
104
+ - `src/makker/trace/`: SQLite event log and `TraceRecorder` middleware.
105
+ - `src/makker/transcript/`: renderers that consume a trace
106
+ (HTML transcript, markdown transcript, investigation report).
107
+ - `src/makker/approval_preview.py`: the approval card body every surface
108
+ renders for a pending tool call.
109
+ - `src/makker/session_host.py`: the one session bootstrap and turn-policy
110
+ loop behind every front end.
111
+ - `src/makker/interfaces/`: `cli`, the Textual `tui`, and the `server`
112
+ (FastAPI REST + per-session WebSocket). The browser UI is a React + TypeScript
113
+ app in `server/webapp/` (see its README), built into `server/web_dist/`
114
+ (committed and shipped, so an install needs no Node). `server/updates.py`
115
+ runs an update started from the browser: `uv tool upgrade`, the env step of
116
+ `makker upgrade`, then a restart of the server into the new version.
117
+ - `src/makker/legacy.py`: temporary. Everything that carries a jutul-agent
118
+ install over (data folder, workspace folder, Julia env, old output folders),
119
+ called from a few marked places. `bridge/` and `scripts/rename_to_makker.py`
120
+ belong to the same transition.
121
+ - `tests/`: end-to-end, chat, CLI, and tool coverage. `tests/integration/`
122
+ needs Julia; `tests/live/` needs an LLM provider key.
123
+
124
+ ## Per-simulator layout
125
+
126
+ Each simulator lives under `src/makker/simulators/<name>/` and owns
127
+ exactly three things:
128
+
129
+ - `adapter.py`: constructs the `SimulatorAdapter`. Set
130
+ `module_dir = Path(__file__).resolve().parent` so the base class can
131
+ derive `julia_env_template_path` and `skills_dir`.
132
+ - `julia_env/`: `Project.toml` declaring the deps the agent can `using`, plus a
133
+ per-simulator `Makker<Sim>/` warm package (a local `[sources]` path dep whose
134
+ `@recompile_invalidations` + `@compile_workload` bakes that simulator's
135
+ GLMakie-aware solve/plot into the precompile cache, so the first solve is fast).
136
+ The shared, sim-agnostic `Makker` package (figure capture, ensemble helpers,
137
+ generic-Makie warm-up) has a single source in `src/makker/julia_runtime/` and
138
+ is copied into the env at bootstrap (also a relative `[sources]` dep). The
139
+ `Manifest.toml` is generated on instantiate (gitignored). The whole `julia_env/`
140
+ folder is copied into a workspace on bootstrap, so the relative `[sources]` paths
141
+ keep resolving.
142
+ - `skills/<skill-name>/SKILL.md`: markdown skills surfaced via the
143
+ deep-agents skill system.
144
+
145
+ Add a simulator by creating that folder and one entry in
146
+ `simulators/registry.py`. Custom subagent factories, when they land, go on
147
+ the adapter's `subagent_factories` tuple.
148
+
149
+ ## deepagents / langgraph private-surface contacts
150
+
151
+ We pin deepagents (see `[tool.uv] exclude-newer` in `pyproject.toml`) and
152
+ touch a few non-public surfaces. `tests/test_deepagents_canaries.py` asserts
153
+ each one still exists, so a bump fails at test time rather than degrading
154
+ silently at runtime. The contacts:
155
+
156
+ - `agent/tools.py`: reads `langgraph.pregel._tools._tool_call_writer`
157
+ (ContextVar) to stream live Julia output as tool-output deltas.
158
+ Import-guarded: if it moves, streaming silently disables.
159
+ - `agent/turns.py` + `makker/lab/fakes.py`: consume the v3
160
+ `astream_events` typed projections (`run.messages` / `run.tool_calls` /
161
+ `run.interrupts` / `run.output`); the fakes mirror that shape, so a
162
+ projection change shows up as test failures.
163
+ - `agent/summarization.py`: manual `/compact` composes the summarization
164
+ middleware's private engine methods. Guarded by a `hasattr` sweep that
165
+ degrades to a clear "unavailable" message.
166
+ - `agent/openrouter.py`: overrides `ChatOpenRouter._create_message_dicts` to
167
+ serialize canonical tool images until upstream supports them. Tests exercise
168
+ the real SDK with mocked HTTP for ordinary and streaming requests.
169
+ - `agent/backend.py`: subclasses `CompositeBackend` (overriding `grep`/`glob`
170
+ so patterns recurse) and `LocalShellBackend` (overriding `write`/`edit`/
171
+ `delete`/`execute` to refuse depot writes, reading `cwd` to resolve relative
172
+ paths). A subclass breaks loudly if a base method's signature moves, but a
173
+ narrowed override degrades quietly, which is why the search overrides
174
+ forward `**kwargs`. After the real-paths refactor nothing routes through a
175
+ mount, so `added_dirs.py` only records the added folders; every tool already
176
+ reaches them by absolute path.
177
+ - `tests/test_builder.py`: imports
178
+ `deepagents.profiles.harness.harness_profiles._harness_profile_for_model`
179
+ to assert our profile resolves for built model instances. It also pins the
180
+ exact tool set the framework installs, since a bump can add or drop one.
181
+
182
+ ## WGLMakie private-surface contacts
183
+
184
+ Live web plots render through `julia_runtime/Makker/src/web_views.jl`: a new
185
+ browser connection closes the figure's earlier view and drops WGLMakie's cached
186
+ render data, because WGLMakie 0.13 closes a shared scene when any view closes. It
187
+ calls `WGLMakie.render_with_init` and `delete_wgl_robj!`, reads `Screen.session`,
188
+ and deletes the `:glyph_data` plot attribute. It runs on WGLMakie 0.13.13 up to
189
+ 0.14 and falls back to `WithConfig` elsewhere; `tests/integration/web_views.jl`
190
+ asserts CI's resolved version is in that range.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 SINTEF
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,157 @@
1
+ Metadata-Version: 2.5
2
+ Name: makker
3
+ Version: 0.3.0rc1
4
+ Summary: An AI agent for computational science: it plans, runs and analyses simulation studies, on its own or alongside you.
5
+ Project-URL: Homepage, https://github.com/SINTEF-agentlab/makker
6
+ Project-URL: Documentation, https://sintef-agentlab.github.io/makker/
7
+ Project-URL: Repository, https://github.com/SINTEF-agentlab/makker
8
+ Project-URL: Issues, https://github.com/SINTEF-agentlab/makker/issues
9
+ Author-email: Jakob Torben <jakob.torben@sintef.no>
10
+ License-Expression: MIT
11
+ License-File: LICENSE
12
+ Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Intended Audience :: Science/Research
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.12
16
+ Classifier: Programming Language :: Python :: 3.14
17
+ Classifier: Topic :: Scientific/Engineering
18
+ Requires-Python: >=3.12
19
+ Requires-Dist: deepagents>=0.7.26
20
+ Requires-Dist: fastapi>=0.115
21
+ Requires-Dist: httpx>=0.27
22
+ Requires-Dist: langchain-google-genai>=4.2.2
23
+ Requires-Dist: langchain-ollama>=1.1.0
24
+ Requires-Dist: langchain-openai>=0.2
25
+ Requires-Dist: langchain-openrouter>=0.2.9
26
+ Requires-Dist: langgraph-checkpoint-sqlite>=3.1.0
27
+ Requires-Dist: markdown-it-py[linkify]>=4.0
28
+ Requires-Dist: pillow>=12.2.0
29
+ Requires-Dist: pygments>=2.17
30
+ Requires-Dist: python-dotenv>=1.0
31
+ Requires-Dist: python-multipart>=0.0.9
32
+ Requires-Dist: textual>=8.2.6
33
+ Requires-Dist: tomli-w>=1.2.0
34
+ Requires-Dist: uvicorn[standard]>=0.30
35
+ Requires-Dist: websockets>=13
36
+ Provides-Extra: eval
37
+ Requires-Dist: anthropic>=1.0.0; extra == 'eval'
38
+ Requires-Dist: inspect-ai<0.4,>=0.3.263; extra == 'eval'
39
+ Requires-Dist: openai>=3.1.0; extra == 'eval'
40
+ Description-Content-Type: text/markdown
41
+
42
+ # Makker
43
+
44
+ [![CI](https://github.com/SINTEF-agentlab/makker/actions/workflows/ci.yml/badge.svg)](https://github.com/SINTEF-agentlab/makker/actions/workflows/ci.yml)
45
+ [![Simulators](https://github.com/SINTEF-agentlab/makker/actions/workflows/simulators.yml/badge.svg)](https://github.com/SINTEF-agentlab/makker/actions/workflows/simulators.yml)
46
+ [![Docs](https://img.shields.io/badge/docs-website-0f4c5c)](https://sintef-agentlab.github.io/makker/)
47
+ [![PyPI](https://img.shields.io/pypi/v/makker.svg)](https://pypi.org/project/makker/)
48
+ [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
49
+
50
+ An AI agent for computational science. Give Makker a question and it plans the
51
+ study, sets up and runs the simulations, analyses and plots the results, and
52
+ decides what to try next. It can carry an investigation on its own or work
53
+ through it with you, and it records every step so the result can be checked.
54
+
55
+ *Makker* (MAHK-er) is Norwegian for the partner you do a job with. The project
56
+ was formerly called jutul-agent.
57
+
58
+ Makker works across simulators and fields of science. The ones below come ready
59
+ to use, and you can
60
+ [add your own](https://sintef-agentlab.github.io/makker/extending-for-your-application/).
61
+
62
+ <p align="center">
63
+ <a href="https://github.com/sintefmath/JutulDarcy.jl"><img src="https://raw.githubusercontent.com/sintefmath/JutulDarcy.jl/main/docs/src/assets/logo_wide.png" alt="JutulDarcy" height="42"></a>&nbsp;&nbsp;&nbsp;
64
+ <a href="https://github.com/BattMoTeam/BattMo.jl"><img src="https://raw.githubusercontent.com/BattMoTeam/BattMo.jl/main/docs/src/assets/battmologo_text.png" alt="BattMo" height="74"></a>&nbsp;&nbsp;&nbsp;
65
+ <a href="https://github.com/sintefmath/Fimbul.jl"><img src="https://raw.githubusercontent.com/sintefmath/Fimbul.jl/main/docs/src/assets/logo_text_wide.png" alt="Fimbul" height="50"></a>&nbsp;&nbsp;&nbsp;
66
+ <a href="https://github.com/sintefmath/Mocca.jl"><img src="https://raw.githubusercontent.com/sintefmath/Mocca.jl/main/docs/src/assets/mocca_small_transparent.png" alt="Mocca" height="62"></a>
67
+ </p>
68
+
69
+ <p align="center">
70
+ <img src="docs/images/web-fimbul.png" alt="Makker web UI: a Fimbul geothermal doublet with the 3D temperature field over time" width="47%">
71
+ &nbsp;&nbsp;&nbsp;
72
+ <img src="docs/images/web-battmo.png" alt="Makker web UI: a BattMo discharge-rate investigation with plots and a report" width="47%">
73
+ </p>
74
+ <p align="center"><sub>The web UI (<code>makker</code>): chat on the left; interactive plots and reports pinned in a canvas on the right. On the left, a Fimbul geothermal doublet showing the 3D temperature field around the wells over time. On the right, a BattMo C-rate study with voltage curves, an attempts map, and a written report.</sub></p>
75
+
76
+ ## Quickstart
77
+
78
+ Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and Julia
79
+ (via [juliaup](https://github.com/JuliaLang/juliaup)). Then:
80
+
81
+ ```sh
82
+ uv tool install makker
83
+ makker key openai # save a key (Anthropic, Google, and OpenRouter work too)
84
+
85
+ mkdir my-study && cd my-study
86
+ makker init --sim battmo # jutuldarcy | battmo | fimbul | mocca
87
+ makker # start the web UI (or: makker tui)
88
+ ```
89
+
90
+ Local models through [Ollama](https://ollama.com) need no key. `init`
91
+ precompiles the Julia and plotting stacks once (a few minutes), so sessions
92
+ then start in seconds, and `makker doctor` checks the setup if anything
93
+ looks wrong. Keep it current with `makker upgrade`.
94
+
95
+ One folder is bound to one simulator and its Julia environment, so use a
96
+ separate folder for each. `makker` with no command serves the web UI at
97
+ <http://127.0.0.1:8742>, locally for a single trusted user; `makker tui`
98
+ is the terminal alternative. The full [installation and usage
99
+ guide](https://sintef-agentlab.github.io/makker/usage/) covers workspaces,
100
+ interfaces, and models; to work on Makker itself, clone the repo (see
101
+ [Development](#development)).
102
+
103
+ ## Supported simulators
104
+
105
+ | `--sim` | Package | Domain |
106
+ |---|---|---|
107
+ | `jutuldarcy` | [JutulDarcy.jl](https://github.com/sintefmath/JutulDarcy.jl) | Reservoir / multi-phase flow |
108
+ | `battmo` | [BattMo.jl](https://github.com/BattMoTeam/BattMo.jl) | Lithium-ion (and other) battery cells |
109
+ | `fimbul` | [Fimbul.jl](https://github.com/sintefmath/Fimbul.jl) | Geothermal (ATES, BTES, doublet, EGS) |
110
+ | `mocca` | [Mocca.jl](https://github.com/sintefmath/Mocca.jl) | Adsorption-based CO₂ capture (PSA / VSA / TSA) |
111
+
112
+ ## What makes it work for scientific computing
113
+
114
+ - A persistent Julia REPL per session. State, loaded packages, and compiled
115
+ methods carry across turns, and a first solve is fast because each
116
+ simulator ships a precompiled warm package.
117
+ - The agent reads real source. Every package in the environment is on disk at
118
+ its real `pkgdir` path (read-only in the shared depot), so answers come from
119
+ the installed version, not from memory.
120
+ - Everything is recorded. Each session writes a trace of every message, tool
121
+ call, and artifact. Transcripts and the benchmark grade against it.
122
+ - Models are interchangeable: OpenAI, Anthropic, Google, OpenRouter, or local models via
123
+ Ollama, switchable mid-session.
124
+ - Where the packages are fixed, such as a demo or a shared machine,
125
+ `init --sysimage` bakes the whole Julia environment into a [system
126
+ image](https://sintef-agentlab.github.io/makker/sysimage/) and sessions
127
+ start with it already loaded. It is checked against the environment before
128
+ every session, so an image that has fallen behind refuses to run instead of
129
+ quietly using the old code.
130
+
131
+ ## Documentation
132
+
133
+ The full documentation lives at
134
+ [sintef-agentlab.github.io/makker](https://sintef-agentlab.github.io/makker/)
135
+ (source in [docs/](docs/)): using the agent, how it works (architecture,
136
+ the Julia kernel, the trace), and extending it (adding a simulator,
137
+ improving the agent, evaluation).
138
+
139
+ ## Development
140
+
141
+ Work from a clone instead of a tool install. `uv run` resolves the
142
+ `makker` command from the checkout, so run every command through it
143
+ (`uv run makker ...`); upgrade with `git pull && uv sync`.
144
+
145
+ ```sh
146
+ git clone https://github.com/SINTEF-agentlab/makker
147
+ cd makker
148
+ uv sync --extra eval
149
+ uv run pre-commit install
150
+
151
+ uv run ruff check . # lint
152
+ uv run pytest # unit tests (integration and live skipped)
153
+ uv run pytest -m integration # adds the Julia-requiring tests
154
+ uv run makker eval canary # bench canary
155
+ ```
156
+
157
+ Developed at [SINTEF](https://www.sintef.no/en/).
@@ -0,0 +1,116 @@
1
+ # Makker
2
+
3
+ [![CI](https://github.com/SINTEF-agentlab/makker/actions/workflows/ci.yml/badge.svg)](https://github.com/SINTEF-agentlab/makker/actions/workflows/ci.yml)
4
+ [![Simulators](https://github.com/SINTEF-agentlab/makker/actions/workflows/simulators.yml/badge.svg)](https://github.com/SINTEF-agentlab/makker/actions/workflows/simulators.yml)
5
+ [![Docs](https://img.shields.io/badge/docs-website-0f4c5c)](https://sintef-agentlab.github.io/makker/)
6
+ [![PyPI](https://img.shields.io/pypi/v/makker.svg)](https://pypi.org/project/makker/)
7
+ [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
8
+
9
+ An AI agent for computational science. Give Makker a question and it plans the
10
+ study, sets up and runs the simulations, analyses and plots the results, and
11
+ decides what to try next. It can carry an investigation on its own or work
12
+ through it with you, and it records every step so the result can be checked.
13
+
14
+ *Makker* (MAHK-er) is Norwegian for the partner you do a job with. The project
15
+ was formerly called jutul-agent.
16
+
17
+ Makker works across simulators and fields of science. The ones below come ready
18
+ to use, and you can
19
+ [add your own](https://sintef-agentlab.github.io/makker/extending-for-your-application/).
20
+
21
+ <p align="center">
22
+ <a href="https://github.com/sintefmath/JutulDarcy.jl"><img src="https://raw.githubusercontent.com/sintefmath/JutulDarcy.jl/main/docs/src/assets/logo_wide.png" alt="JutulDarcy" height="42"></a>&nbsp;&nbsp;&nbsp;
23
+ <a href="https://github.com/BattMoTeam/BattMo.jl"><img src="https://raw.githubusercontent.com/BattMoTeam/BattMo.jl/main/docs/src/assets/battmologo_text.png" alt="BattMo" height="74"></a>&nbsp;&nbsp;&nbsp;
24
+ <a href="https://github.com/sintefmath/Fimbul.jl"><img src="https://raw.githubusercontent.com/sintefmath/Fimbul.jl/main/docs/src/assets/logo_text_wide.png" alt="Fimbul" height="50"></a>&nbsp;&nbsp;&nbsp;
25
+ <a href="https://github.com/sintefmath/Mocca.jl"><img src="https://raw.githubusercontent.com/sintefmath/Mocca.jl/main/docs/src/assets/mocca_small_transparent.png" alt="Mocca" height="62"></a>
26
+ </p>
27
+
28
+ <p align="center">
29
+ <img src="docs/images/web-fimbul.png" alt="Makker web UI: a Fimbul geothermal doublet with the 3D temperature field over time" width="47%">
30
+ &nbsp;&nbsp;&nbsp;
31
+ <img src="docs/images/web-battmo.png" alt="Makker web UI: a BattMo discharge-rate investigation with plots and a report" width="47%">
32
+ </p>
33
+ <p align="center"><sub>The web UI (<code>makker</code>): chat on the left; interactive plots and reports pinned in a canvas on the right. On the left, a Fimbul geothermal doublet showing the 3D temperature field around the wells over time. On the right, a BattMo C-rate study with voltage curves, an attempts map, and a written report.</sub></p>
34
+
35
+ ## Quickstart
36
+
37
+ Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and Julia
38
+ (via [juliaup](https://github.com/JuliaLang/juliaup)). Then:
39
+
40
+ ```sh
41
+ uv tool install makker
42
+ makker key openai # save a key (Anthropic, Google, and OpenRouter work too)
43
+
44
+ mkdir my-study && cd my-study
45
+ makker init --sim battmo # jutuldarcy | battmo | fimbul | mocca
46
+ makker # start the web UI (or: makker tui)
47
+ ```
48
+
49
+ Local models through [Ollama](https://ollama.com) need no key. `init`
50
+ precompiles the Julia and plotting stacks once (a few minutes), so sessions
51
+ then start in seconds, and `makker doctor` checks the setup if anything
52
+ looks wrong. Keep it current with `makker upgrade`.
53
+
54
+ One folder is bound to one simulator and its Julia environment, so use a
55
+ separate folder for each. `makker` with no command serves the web UI at
56
+ <http://127.0.0.1:8742>, locally for a single trusted user; `makker tui`
57
+ is the terminal alternative. The full [installation and usage
58
+ guide](https://sintef-agentlab.github.io/makker/usage/) covers workspaces,
59
+ interfaces, and models; to work on Makker itself, clone the repo (see
60
+ [Development](#development)).
61
+
62
+ ## Supported simulators
63
+
64
+ | `--sim` | Package | Domain |
65
+ |---|---|---|
66
+ | `jutuldarcy` | [JutulDarcy.jl](https://github.com/sintefmath/JutulDarcy.jl) | Reservoir / multi-phase flow |
67
+ | `battmo` | [BattMo.jl](https://github.com/BattMoTeam/BattMo.jl) | Lithium-ion (and other) battery cells |
68
+ | `fimbul` | [Fimbul.jl](https://github.com/sintefmath/Fimbul.jl) | Geothermal (ATES, BTES, doublet, EGS) |
69
+ | `mocca` | [Mocca.jl](https://github.com/sintefmath/Mocca.jl) | Adsorption-based CO₂ capture (PSA / VSA / TSA) |
70
+
71
+ ## What makes it work for scientific computing
72
+
73
+ - A persistent Julia REPL per session. State, loaded packages, and compiled
74
+ methods carry across turns, and a first solve is fast because each
75
+ simulator ships a precompiled warm package.
76
+ - The agent reads real source. Every package in the environment is on disk at
77
+ its real `pkgdir` path (read-only in the shared depot), so answers come from
78
+ the installed version, not from memory.
79
+ - Everything is recorded. Each session writes a trace of every message, tool
80
+ call, and artifact. Transcripts and the benchmark grade against it.
81
+ - Models are interchangeable: OpenAI, Anthropic, Google, OpenRouter, or local models via
82
+ Ollama, switchable mid-session.
83
+ - Where the packages are fixed, such as a demo or a shared machine,
84
+ `init --sysimage` bakes the whole Julia environment into a [system
85
+ image](https://sintef-agentlab.github.io/makker/sysimage/) and sessions
86
+ start with it already loaded. It is checked against the environment before
87
+ every session, so an image that has fallen behind refuses to run instead of
88
+ quietly using the old code.
89
+
90
+ ## Documentation
91
+
92
+ The full documentation lives at
93
+ [sintef-agentlab.github.io/makker](https://sintef-agentlab.github.io/makker/)
94
+ (source in [docs/](docs/)): using the agent, how it works (architecture,
95
+ the Julia kernel, the trace), and extending it (adding a simulator,
96
+ improving the agent, evaluation).
97
+
98
+ ## Development
99
+
100
+ Work from a clone instead of a tool install. `uv run` resolves the
101
+ `makker` command from the checkout, so run every command through it
102
+ (`uv run makker ...`); upgrade with `git pull && uv sync`.
103
+
104
+ ```sh
105
+ git clone https://github.com/SINTEF-agentlab/makker
106
+ cd makker
107
+ uv sync --extra eval
108
+ uv run pre-commit install
109
+
110
+ uv run ruff check . # lint
111
+ uv run pytest # unit tests (integration and live skipped)
112
+ uv run pytest -m integration # adds the Julia-requiring tests
113
+ uv run makker eval canary # bench canary
114
+ ```
115
+
116
+ Developed at [SINTEF](https://www.sintef.no/en/).
@@ -0,0 +1,20 @@
1
+ # jutul-agent is now Makker
2
+
3
+ jutul-agent has been renamed to [Makker](https://github.com/SINTEF-agentlab/makker),
4
+ an AI agent for computational science. Development continues there, under the
5
+ package name [`makker`](https://pypi.org/project/makker/).
6
+
7
+ ## New installs
8
+
9
+ ```sh
10
+ uv tool install makker
11
+ ```
12
+
13
+ ## Existing installs
14
+
15
+ Update as usual, with the Update button in the web UI or with
16
+ `uv tool upgrade jutul-agent`. This release then installs Makker and starts it:
17
+ your API keys, chats and workspaces are carried over, and the command is
18
+ `makker` from then on.
19
+
20
+ This is the last release under the old name.
@@ -0,0 +1,38 @@
1
+ # The last release of jutul-agent. The project is now Makker (the rest of this
2
+ # repository); this package only carries existing installs across. It is built
3
+ # and published by .github/workflows/release-bridge.yml, never by release.yml.
4
+ [project]
5
+ name = "jutul-agent"
6
+ version = "0.3.0rc1"
7
+ description = "jutul-agent is now Makker. This final release installs Makker and starts it."
8
+ readme = "README.md"
9
+ requires-python = ">=3.12"
10
+ authors = [
11
+ {name = "Jakob Torben", email = "jakob.torben@sintef.no"},
12
+ ]
13
+ license = "MIT"
14
+ classifiers = [
15
+ "Development Status :: 7 - Inactive",
16
+ "Intended Audience :: Science/Research",
17
+ "Programming Language :: Python :: 3",
18
+ "Topic :: Scientific/Engineering",
19
+ ]
20
+ # Keep this the only dependency, and keep it first: the release workflow reads
21
+ # the Makker version it names.
22
+ dependencies = [
23
+ "makker>=0.3.0rc1",
24
+ ]
25
+
26
+ [project.urls]
27
+ Homepage = "https://github.com/SINTEF-agentlab/makker"
28
+ Documentation = "https://sintef-agentlab.github.io/makker/"
29
+
30
+ [project.scripts]
31
+ jutul-agent = "jutul_agent.__main__:main"
32
+
33
+ [build-system]
34
+ requires = ["hatchling"]
35
+ build-backend = "hatchling.build"
36
+
37
+ [tool.hatch.build.targets.wheel]
38
+ packages = ["src/jutul_agent"]