synth-ai 0.2.8.dev2__py3-none-any.whl → 0.4.3__py3-none-any.whl

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 (740) hide show
  1. synth_ai/__init__.py +44 -24
  2. synth_ai/__main__.py +30 -3
  3. synth_ai/cli/__init__.py +103 -48
  4. synth_ai/cli/__main__.py +42 -0
  5. synth_ai/cli/_internal/__init__.py +5 -0
  6. synth_ai/cli/_internal/modal_wrapper.py +31 -0
  7. synth_ai/cli/_internal/storage.py +20 -0
  8. synth_ai/cli/_internal/typer_patch.py +47 -0
  9. synth_ai/cli/_internal/validate_task_app.py +29 -0
  10. synth_ai/cli/agents/__init__.py +17 -0
  11. synth_ai/cli/agents/claude.py +77 -0
  12. synth_ai/cli/agents/codex.py +265 -0
  13. synth_ai/cli/agents/opencode.py +253 -0
  14. synth_ai/cli/commands/__init__.py +18 -0
  15. synth_ai/cli/commands/artifacts/__init__.py +13 -0
  16. synth_ai/cli/commands/artifacts/client.py +119 -0
  17. synth_ai/cli/commands/artifacts/config.py +57 -0
  18. synth_ai/cli/commands/artifacts/core.py +24 -0
  19. synth_ai/cli/commands/artifacts/download.py +188 -0
  20. synth_ai/cli/commands/artifacts/export.py +186 -0
  21. synth_ai/cli/commands/artifacts/list.py +156 -0
  22. synth_ai/cli/commands/artifacts/parsing.py +250 -0
  23. synth_ai/cli/commands/artifacts/show.py +336 -0
  24. synth_ai/cli/commands/demo/__init__.py +3 -0
  25. synth_ai/cli/commands/demo/core.py +153 -0
  26. synth_ai/cli/commands/eval/__init__.py +10 -0
  27. synth_ai/cli/commands/eval/config.py +338 -0
  28. synth_ai/cli/commands/eval/core.py +256 -0
  29. synth_ai/cli/commands/eval/runner.py +704 -0
  30. synth_ai/cli/commands/eval/validation.py +60 -0
  31. synth_ai/cli/commands/filter/__init__.py +12 -0
  32. synth_ai/cli/commands/filter/core.py +424 -0
  33. synth_ai/cli/commands/filter/errors.py +55 -0
  34. synth_ai/cli/commands/filter/validation.py +77 -0
  35. synth_ai/cli/commands/help/__init__.py +185 -0
  36. synth_ai/cli/commands/help/core.py +72 -0
  37. synth_ai/cli/commands/scan/__init__.py +19 -0
  38. synth_ai/cli/commands/scan/cloudflare_scanner.py +403 -0
  39. synth_ai/cli/commands/scan/core.py +344 -0
  40. synth_ai/cli/commands/scan/health_checker.py +242 -0
  41. synth_ai/cli/commands/scan/local_scanner.py +278 -0
  42. synth_ai/cli/commands/scan/models.py +83 -0
  43. synth_ai/cli/commands/smoke/__init__.py +7 -0
  44. synth_ai/cli/commands/smoke/core.py +1428 -0
  45. synth_ai/cli/commands/status/__init__.py +3 -0
  46. synth_ai/cli/commands/status/client.py +91 -0
  47. synth_ai/cli/commands/status/config.py +12 -0
  48. synth_ai/cli/commands/status/errors.py +11 -0
  49. synth_ai/cli/commands/status/subcommands/__init__.py +3 -0
  50. synth_ai/cli/commands/status/subcommands/config.py +13 -0
  51. synth_ai/cli/commands/status/subcommands/files.py +34 -0
  52. synth_ai/cli/commands/status/subcommands/jobs.py +51 -0
  53. synth_ai/cli/commands/status/subcommands/models.py +35 -0
  54. synth_ai/cli/commands/status/subcommands/runs.py +34 -0
  55. synth_ai/cli/commands/status/subcommands/session.py +77 -0
  56. synth_ai/cli/commands/status/subcommands/summary.py +39 -0
  57. synth_ai/cli/commands/status/subcommands/utils.py +41 -0
  58. synth_ai/cli/commands/status/utils.py +23 -0
  59. synth_ai/cli/commands/train/__init__.py +53 -0
  60. synth_ai/cli/commands/train/core.py +22 -0
  61. synth_ai/cli/commands/train/errors.py +117 -0
  62. synth_ai/cli/commands/train/judge_schemas.py +201 -0
  63. synth_ai/cli/commands/train/judge_validation.py +305 -0
  64. synth_ai/cli/commands/train/prompt_learning_validation.py +633 -0
  65. synth_ai/cli/commands/train/validation.py +392 -0
  66. synth_ai/cli/demo_apps/__init__.py +10 -0
  67. synth_ai/cli/demo_apps/core/__init__.py +28 -0
  68. synth_ai/{demos → cli/demo_apps}/core/cli.py +783 -441
  69. synth_ai/cli/demo_apps/crafter/__init__.py +1 -0
  70. synth_ai/cli/demo_apps/crafter/crafter_fft_4b.toml +55 -0
  71. synth_ai/cli/demo_apps/crafter/grpo_crafter_task_app.py +186 -0
  72. synth_ai/cli/demo_apps/crafter/rl_from_base_qwen4b.toml +74 -0
  73. synth_ai/cli/demo_apps/demo_registry.py +176 -0
  74. synth_ai/cli/demo_apps/demo_task_apps/__init__.py +7 -0
  75. synth_ai/{demos → cli/demo_apps}/demo_task_apps/core.py +75 -37
  76. synth_ai/cli/demo_apps/demo_task_apps/crafter/__init__.py +1 -0
  77. synth_ai/cli/demo_apps/demo_task_apps/crafter/configs/crafter_fft_4b.toml +53 -0
  78. synth_ai/cli/demo_apps/demo_task_apps/crafter/configs/rl_from_base_qwen4b.toml +73 -0
  79. synth_ai/cli/demo_apps/demo_task_apps/crafter/grpo_crafter_task_app.py +185 -0
  80. synth_ai/{demos → cli/demo_apps}/demo_task_apps/math/_common.py +1 -2
  81. synth_ai/{demos → cli/demo_apps}/demo_task_apps/math/app.py +2 -1
  82. synth_ai/cli/demo_apps/demo_task_apps/math/config.toml +73 -0
  83. synth_ai/{demos → cli/demo_apps}/demo_task_apps/math/deploy_modal.py +3 -6
  84. synth_ai/cli/demo_apps/demo_task_apps/math/modal_task_app.py +738 -0
  85. synth_ai/cli/demo_apps/demo_task_apps/math/task_app_entry.py +39 -0
  86. synth_ai/cli/demo_apps/math/__init__.py +1 -0
  87. synth_ai/cli/demo_apps/math/_common.py +16 -0
  88. synth_ai/cli/demo_apps/math/app.py +38 -0
  89. synth_ai/cli/demo_apps/math/config.toml +75 -0
  90. synth_ai/cli/demo_apps/math/deploy_modal.py +54 -0
  91. synth_ai/cli/demo_apps/math/modal_task_app.py +698 -0
  92. synth_ai/cli/demo_apps/math/task_app_entry.py +53 -0
  93. synth_ai/cli/demo_apps/mipro/main.py +271 -0
  94. synth_ai/cli/demo_apps/mipro/task_app.py +922 -0
  95. synth_ai/cli/demo_apps/mipro/train_cfg.toml +92 -0
  96. synth_ai/cli/demos/__init__.py +12 -0
  97. synth_ai/cli/demos/demo.py +32 -0
  98. synth_ai/cli/demos/rl_demo.py +254 -0
  99. synth_ai/cli/deploy.py +216 -0
  100. synth_ai/cli/infra/__init__.py +14 -0
  101. synth_ai/cli/{balance.py → infra/balance.py} +16 -4
  102. synth_ai/cli/infra/mcp.py +35 -0
  103. synth_ai/cli/infra/modal_app.py +36 -0
  104. synth_ai/cli/infra/setup.py +69 -0
  105. synth_ai/cli/infra/status.py +16 -0
  106. synth_ai/cli/infra/turso.py +77 -0
  107. synth_ai/cli/lib/__init__.py +10 -0
  108. synth_ai/cli/lib/agents.py +76 -0
  109. synth_ai/cli/lib/apps/modal_app.py +101 -0
  110. synth_ai/cli/lib/apps/task_app.py +642 -0
  111. synth_ai/cli/lib/bin.py +39 -0
  112. synth_ai/cli/lib/env.py +375 -0
  113. synth_ai/cli/lib/errors.py +85 -0
  114. synth_ai/cli/lib/modal.py +315 -0
  115. synth_ai/cli/lib/plotting.py +126 -0
  116. synth_ai/cli/lib/prompt_args.py +39 -0
  117. synth_ai/cli/lib/prompts.py +284 -0
  118. synth_ai/cli/lib/sqld.py +122 -0
  119. synth_ai/cli/lib/task_app_discovery.py +884 -0
  120. synth_ai/cli/lib/task_app_env.py +295 -0
  121. synth_ai/cli/lib/train_cfgs.py +300 -0
  122. synth_ai/cli/lib/tunnel_records.py +207 -0
  123. synth_ai/cli/local/__init__.py +14 -0
  124. synth_ai/cli/local/experiment_queue/__init__.py +72 -0
  125. synth_ai/cli/local/experiment_queue/api_schemas.py +221 -0
  126. synth_ai/cli/local/experiment_queue/celery_app.py +208 -0
  127. synth_ai/cli/local/experiment_queue/config.py +128 -0
  128. synth_ai/cli/local/experiment_queue/config_utils.py +272 -0
  129. synth_ai/cli/local/experiment_queue/database.py +175 -0
  130. synth_ai/cli/local/experiment_queue/dispatcher.py +119 -0
  131. synth_ai/cli/local/experiment_queue/models.py +231 -0
  132. synth_ai/cli/local/experiment_queue/progress_info.py +160 -0
  133. synth_ai/cli/local/experiment_queue/results.py +373 -0
  134. synth_ai/cli/local/experiment_queue/schemas.py +131 -0
  135. synth_ai/cli/local/experiment_queue/service.py +344 -0
  136. synth_ai/cli/local/experiment_queue/status.py +372 -0
  137. synth_ai/cli/local/experiment_queue/status_tracker.py +360 -0
  138. synth_ai/cli/local/experiment_queue/tasks.py +1984 -0
  139. synth_ai/cli/local/experiment_queue/trace_storage.py +65 -0
  140. synth_ai/cli/local/experiment_queue/validation.py +157 -0
  141. synth_ai/cli/local/session/__init__.py +92 -0
  142. synth_ai/cli/local/session/client.py +383 -0
  143. synth_ai/cli/local/session/constants.py +63 -0
  144. synth_ai/cli/local/session/exceptions.py +105 -0
  145. synth_ai/cli/local/session/manager.py +139 -0
  146. synth_ai/cli/local/session/models.py +89 -0
  147. synth_ai/cli/local/session/query.py +110 -0
  148. synth_ai/cli/root.py +150 -108
  149. synth_ai/cli/task_apps/__init__.py +37 -0
  150. synth_ai/cli/task_apps/commands.py +3145 -0
  151. synth_ai/cli/task_apps/deploy.py +7 -0
  152. synth_ai/cli/task_apps/list.py +26 -0
  153. synth_ai/cli/task_apps/main.py +36 -0
  154. synth_ai/cli/task_apps/modal_serve.py +11 -0
  155. synth_ai/cli/task_apps/serve.py +11 -0
  156. synth_ai/cli/training/__init__.py +8 -0
  157. synth_ai/cli/training/train.py +5 -0
  158. synth_ai/cli/training/train_cfg.py +34 -0
  159. synth_ai/cli/{watch.py → training/watch.py} +13 -18
  160. synth_ai/cli/turso.py +52 -0
  161. synth_ai/cli/utils/__init__.py +8 -0
  162. synth_ai/cli/utils/experiments.py +235 -0
  163. synth_ai/cli/utils/queue.py +504 -0
  164. synth_ai/cli/{recent.py → utils/recent.py} +13 -7
  165. synth_ai/cli/{traces.py → utils/traces.py} +9 -5
  166. synth_ai/contracts/__init__.py +67 -0
  167. synth_ai/core/__init__.py +100 -0
  168. synth_ai/core/_utils/__init__.py +54 -0
  169. synth_ai/core/_utils/base_url.py +10 -0
  170. synth_ai/core/_utils/http.py +10 -0
  171. synth_ai/core/_utils/prompts.py +14 -0
  172. synth_ai/core/_utils/task_app_state.py +12 -0
  173. synth_ai/core/_utils/user_config.py +10 -0
  174. synth_ai/core/apps/common.py +116 -0
  175. synth_ai/core/auth.py +95 -0
  176. synth_ai/core/cfgs.py +240 -0
  177. synth_ai/core/config/__init__.py +16 -0
  178. synth_ai/core/config/base.py +168 -0
  179. synth_ai/core/config/resolver.py +89 -0
  180. synth_ai/core/env.py +231 -0
  181. synth_ai/core/errors.py +126 -0
  182. synth_ai/core/http.py +230 -0
  183. synth_ai/core/integrations/__init__.py +11 -0
  184. synth_ai/core/integrations/cloudflare.py +1710 -0
  185. synth_ai/core/integrations/mcp/__init__.py +6 -0
  186. synth_ai/core/integrations/mcp/__main__.py +8 -0
  187. synth_ai/core/integrations/mcp/claude.py +36 -0
  188. synth_ai/core/integrations/mcp/main.py +254 -0
  189. synth_ai/core/integrations/mcp/setup.py +100 -0
  190. synth_ai/core/integrations/modal.py +277 -0
  191. synth_ai/core/json.py +72 -0
  192. synth_ai/core/log_filter.py +99 -0
  193. synth_ai/core/logging.py +82 -0
  194. synth_ai/core/paths.py +107 -0
  195. synth_ai/core/pricing.py +109 -0
  196. synth_ai/core/process.py +233 -0
  197. synth_ai/core/ssl.py +25 -0
  198. synth_ai/core/storage/__init__.py +71 -0
  199. synth_ai/core/task_app_state.py +318 -0
  200. synth_ai/core/telemetry.py +282 -0
  201. synth_ai/{tracing_v3 → core/tracing_v3}/__init__.py +5 -1
  202. synth_ai/{tracing_v3 → core/tracing_v3}/abstractions.py +21 -4
  203. synth_ai/core/tracing_v3/config.py +229 -0
  204. synth_ai/core/tracing_v3/constants.py +21 -0
  205. synth_ai/{tracing_v3 → core/tracing_v3}/db_config.py +42 -29
  206. synth_ai/{tracing_v3 → core/tracing_v3}/decorators.py +80 -45
  207. synth_ai/{tracing_v3 → core/tracing_v3}/examples/basic_usage.py +15 -9
  208. synth_ai/{tracing_v3 → core/tracing_v3}/hooks.py +6 -4
  209. synth_ai/{tracing_v3 → core/tracing_v3}/llm_call_record_helpers.py +161 -61
  210. synth_ai/{tracing_v3 → core/tracing_v3}/migration_helper.py +1 -2
  211. synth_ai/{tracing_v3 → core/tracing_v3}/replica_sync.py +12 -7
  212. synth_ai/core/tracing_v3/serialization.py +130 -0
  213. synth_ai/{tracing_v3 → core/tracing_v3}/session_tracer.py +88 -21
  214. synth_ai/{tracing_v3 → core/tracing_v3}/storage/base.py +99 -12
  215. synth_ai/core/tracing_v3/storage/config.py +109 -0
  216. synth_ai/{tracing_v3 → core/tracing_v3}/storage/factory.py +11 -9
  217. synth_ai/{tracing_v3 → core/tracing_v3}/storage/utils.py +15 -11
  218. synth_ai/core/tracing_v3/trace_utils.py +326 -0
  219. synth_ai/core/tracing_v3/turso/__init__.py +12 -0
  220. synth_ai/core/tracing_v3/turso/daemon.py +278 -0
  221. synth_ai/{tracing_v3 → core/tracing_v3}/turso/models.py +7 -3
  222. synth_ai/core/tracing_v3/turso/native_manager.py +1385 -0
  223. synth_ai/{tracing_v3 → core/tracing_v3}/utils.py +5 -4
  224. synth_ai/core/urls.py +18 -0
  225. synth_ai/core/user_config.py +137 -0
  226. synth_ai/core/uvicorn.py +222 -0
  227. synth_ai/data/__init__.py +83 -0
  228. synth_ai/data/enums.py +123 -0
  229. synth_ai/data/rewards.py +152 -0
  230. synth_ai/data/traces.py +35 -0
  231. synth_ai/products/__init__.py +6 -0
  232. synth_ai/products/graph_evolve/__init__.py +46 -0
  233. synth_ai/products/graph_evolve/client.py +226 -0
  234. synth_ai/products/graph_evolve/config.py +591 -0
  235. synth_ai/products/graph_evolve/converters/__init__.py +42 -0
  236. synth_ai/products/graph_evolve/converters/openai_sft.py +484 -0
  237. synth_ai/products/graph_evolve/examples/hotpotqa/config.toml +109 -0
  238. synth_ai/products/graph_evolve/run.py +222 -0
  239. synth_ai/products/graph_gepa/__init__.py +23 -0
  240. synth_ai/products/graph_gepa/converters/__init__.py +19 -0
  241. synth_ai/products/graph_gepa/converters/openai_sft.py +29 -0
  242. synth_ai/sdk/__init__.py +123 -0
  243. synth_ai/sdk/api/__init__.py +1 -0
  244. synth_ai/sdk/api/models/supported.py +514 -0
  245. synth_ai/sdk/api/research_agent/__init__.py +296 -0
  246. synth_ai/sdk/api/train/__init__.py +85 -0
  247. synth_ai/sdk/api/train/builders.py +895 -0
  248. synth_ai/sdk/api/train/cli.py +2199 -0
  249. synth_ai/sdk/api/train/config_finder.py +267 -0
  250. synth_ai/sdk/api/train/configs/__init__.py +65 -0
  251. synth_ai/sdk/api/train/configs/prompt_learning.py +1706 -0
  252. synth_ai/sdk/api/train/configs/rl.py +187 -0
  253. synth_ai/sdk/api/train/configs/sft.py +99 -0
  254. synth_ai/sdk/api/train/configs/shared.py +81 -0
  255. synth_ai/sdk/api/train/context_learning.py +312 -0
  256. synth_ai/sdk/api/train/env_resolver.py +418 -0
  257. synth_ai/sdk/api/train/graph_validators.py +216 -0
  258. synth_ai/sdk/api/train/graphgen.py +984 -0
  259. synth_ai/sdk/api/train/graphgen_models.py +823 -0
  260. synth_ai/sdk/api/train/graphgen_validators.py +109 -0
  261. synth_ai/sdk/api/train/local_api.py +10 -0
  262. synth_ai/sdk/api/train/pollers.py +124 -0
  263. synth_ai/sdk/api/train/progress/__init__.py +97 -0
  264. synth_ai/sdk/api/train/progress/dataclasses.py +569 -0
  265. synth_ai/sdk/api/train/progress/events.py +326 -0
  266. synth_ai/sdk/api/train/progress/results.py +428 -0
  267. synth_ai/sdk/api/train/progress/tracker.py +641 -0
  268. synth_ai/sdk/api/train/prompt_learning.py +469 -0
  269. synth_ai/sdk/api/train/rl.py +441 -0
  270. synth_ai/sdk/api/train/sft.py +396 -0
  271. synth_ai/sdk/api/train/summary.py +522 -0
  272. synth_ai/sdk/api/train/supported_algos.py +147 -0
  273. synth_ai/sdk/api/train/task_app.py +351 -0
  274. synth_ai/sdk/api/train/utils.py +279 -0
  275. synth_ai/sdk/api/train/validators.py +2424 -0
  276. synth_ai/sdk/graphs/__init__.py +15 -0
  277. synth_ai/sdk/graphs/completions.py +570 -0
  278. synth_ai/{inference → sdk/inference}/__init__.py +0 -1
  279. synth_ai/sdk/inference/client.py +128 -0
  280. synth_ai/sdk/jobs/__init__.py +16 -0
  281. synth_ai/sdk/jobs/client.py +371 -0
  282. synth_ai/sdk/judging/__init__.py +14 -0
  283. synth_ai/sdk/judging/base.py +24 -0
  284. synth_ai/sdk/judging/client.py +40 -0
  285. synth_ai/sdk/judging/schemas.py +222 -0
  286. synth_ai/sdk/judging/types.py +42 -0
  287. synth_ai/sdk/learning/__init__.py +99 -0
  288. synth_ai/sdk/learning/algorithms.py +14 -0
  289. synth_ai/{learning → sdk/learning}/client.py +121 -30
  290. synth_ai/sdk/learning/config.py +5 -0
  291. synth_ai/{learning → sdk/learning}/constants.py +0 -2
  292. synth_ai/sdk/learning/context_learning_client.py +531 -0
  293. synth_ai/sdk/learning/context_learning_types.py +292 -0
  294. synth_ai/sdk/learning/ft_client.py +7 -0
  295. synth_ai/{learning → sdk/learning}/health.py +15 -9
  296. synth_ai/{learning → sdk/learning}/jobs.py +44 -47
  297. synth_ai/sdk/learning/prompt_extraction.py +334 -0
  298. synth_ai/sdk/learning/prompt_learning_client.py +455 -0
  299. synth_ai/sdk/learning/prompt_learning_types.py +186 -0
  300. synth_ai/{rl → sdk/learning/rl}/__init__.py +13 -8
  301. synth_ai/{learning/rl_client.py → sdk/learning/rl/client.py} +89 -77
  302. synth_ai/sdk/learning/rl/config.py +31 -0
  303. synth_ai/{rl → sdk/learning/rl}/contracts.py +5 -14
  304. synth_ai/{rl → sdk/learning/rl}/env_keys.py +45 -16
  305. synth_ai/sdk/learning/rl/secrets.py +13 -0
  306. synth_ai/sdk/learning/rl_client.py +5 -0
  307. synth_ai/sdk/learning/sft/__init__.py +29 -0
  308. synth_ai/sdk/learning/sft/client.py +95 -0
  309. synth_ai/sdk/learning/sft/config.py +270 -0
  310. synth_ai/sdk/learning/sft/data.py +698 -0
  311. synth_ai/sdk/learning/sse.py +57 -0
  312. synth_ai/sdk/learning/validators.py +52 -0
  313. synth_ai/sdk/localapi/__init__.py +40 -0
  314. synth_ai/sdk/localapi/apps/__init__.py +28 -0
  315. synth_ai/sdk/localapi/client.py +10 -0
  316. synth_ai/sdk/localapi/contracts.py +10 -0
  317. synth_ai/sdk/localapi/helpers.py +519 -0
  318. synth_ai/sdk/localapi/rollouts.py +87 -0
  319. synth_ai/sdk/localapi/server.py +29 -0
  320. synth_ai/sdk/localapi/template.py +70 -0
  321. synth_ai/sdk/streaming/__init__.py +35 -0
  322. synth_ai/sdk/streaming/config.py +94 -0
  323. synth_ai/sdk/streaming/handlers.py +1997 -0
  324. synth_ai/sdk/streaming/streamer.py +713 -0
  325. synth_ai/sdk/streaming/types.py +112 -0
  326. synth_ai/sdk/task/__init__.py +164 -0
  327. synth_ai/sdk/task/apps/__init__.py +169 -0
  328. synth_ai/sdk/task/auth.py +165 -0
  329. synth_ai/sdk/task/client.py +175 -0
  330. synth_ai/sdk/task/config.py +257 -0
  331. synth_ai/sdk/task/contracts.py +219 -0
  332. synth_ai/sdk/task/datasets.py +108 -0
  333. synth_ai/sdk/task/errors.py +50 -0
  334. synth_ai/sdk/task/health.py +34 -0
  335. synth_ai/sdk/task/in_process.py +1190 -0
  336. synth_ai/sdk/task/in_process_runner.py +314 -0
  337. synth_ai/sdk/task/inference_api.py +299 -0
  338. synth_ai/sdk/task/json.py +111 -0
  339. synth_ai/sdk/task/proxy.py +287 -0
  340. synth_ai/sdk/task/rubrics/__init__.py +55 -0
  341. synth_ai/sdk/task/rubrics/loaders.py +156 -0
  342. synth_ai/sdk/task/rubrics/models.py +57 -0
  343. synth_ai/sdk/task/rubrics/scoring.py +116 -0
  344. synth_ai/sdk/task/rubrics/strict.py +149 -0
  345. synth_ai/sdk/task/rubrics.py +219 -0
  346. synth_ai/sdk/task/server.py +631 -0
  347. synth_ai/sdk/task/trace_correlation_helpers.py +539 -0
  348. synth_ai/sdk/task/tracing_utils.py +95 -0
  349. synth_ai/sdk/task/validators.py +441 -0
  350. synth_ai/sdk/task/vendors.py +59 -0
  351. synth_ai/sdk/training/__init__.py +102 -0
  352. synth_ai/sdk/tunnels/__init__.py +83 -0
  353. synth_ai/sdk/tunnels/cleanup.py +83 -0
  354. synth_ai/sdk/tunnels/ports.py +120 -0
  355. synth_ai/utils/__init__.py +213 -0
  356. synth_ai-0.4.3.dist-info/METADATA +262 -0
  357. synth_ai-0.4.3.dist-info/RECORD +370 -0
  358. {synth_ai-0.2.8.dev2.dist-info → synth_ai-0.4.3.dist-info}/entry_points.txt +0 -1
  359. synth_ai/cli/calc.py +0 -69
  360. synth_ai/cli/demo.py +0 -144
  361. synth_ai/cli/legacy_root_backup.py +0 -470
  362. synth_ai/cli/man.py +0 -106
  363. synth_ai/cli/rl_demo.py +0 -202
  364. synth_ai/cli/status.py +0 -133
  365. synth_ai/config/base_url.py +0 -107
  366. synth_ai/core/experiment.py +0 -15
  367. synth_ai/core/system.py +0 -15
  368. synth_ai/demos/core/__init__.py +0 -1
  369. synth_ai/demos/demo_task_apps/__init__.py +0 -1
  370. synth_ai/demos/demo_task_apps/math/config.toml +0 -129
  371. synth_ai/demos/demo_task_apps/math/deploy_task_app.sh +0 -22
  372. synth_ai/demos/demo_task_apps/math/modal_task_app.py +0 -415
  373. synth_ai/environments/__init__.py +0 -31
  374. synth_ai/environments/environment/__init__.py +0 -1
  375. synth_ai/environments/environment/artifacts/__init__.py +0 -1
  376. synth_ai/environments/environment/artifacts/base.py +0 -52
  377. synth_ai/environments/environment/core.py +0 -67
  378. synth_ai/environments/environment/db/__init__.py +0 -1
  379. synth_ai/environments/environment/db/sqlite.py +0 -45
  380. synth_ai/environments/environment/registry.py +0 -233
  381. synth_ai/environments/environment/resources/sqlite.py +0 -45
  382. synth_ai/environments/environment/results.py +0 -1
  383. synth_ai/environments/environment/rewards/__init__.py +0 -1
  384. synth_ai/environments/environment/rewards/core.py +0 -29
  385. synth_ai/environments/environment/shared_engine.py +0 -26
  386. synth_ai/environments/environment/tools/__init__.py +0 -200
  387. synth_ai/environments/examples/__init__.py +0 -1
  388. synth_ai/environments/examples/bandit/__init__.py +0 -33
  389. synth_ai/environments/examples/bandit/engine.py +0 -294
  390. synth_ai/environments/examples/bandit/environment.py +0 -194
  391. synth_ai/environments/examples/bandit/taskset.py +0 -200
  392. synth_ai/environments/examples/crafter_classic/__init__.py +0 -8
  393. synth_ai/environments/examples/crafter_classic/agent_demos/analyze_semantic_words_markdown.py +0 -250
  394. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_comprehensive_evaluation.py +0 -59
  395. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_evaluation_browser.py +0 -152
  396. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_evaluation_config.toml +0 -24
  397. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_evaluation_framework.py +0 -1194
  398. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/crafter_synth_config.toml +0 -56
  399. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/filter_config_modal.toml +0 -32
  400. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/filter_traces_sft_turso.py +0 -738
  401. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/kick_off_ft_modal.py +0 -384
  402. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/analyze_action_results.py +0 -53
  403. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/analyze_agent_actions.py +0 -178
  404. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/analyze_latest_run.py +0 -222
  405. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/analyze_lm_traces.py +0 -183
  406. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/analyze_no_rewards.py +0 -210
  407. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/analyze_trace_issue.py +0 -206
  408. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/check_db_schema.py +0 -49
  409. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/check_latest_results.py +0 -64
  410. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/debug_agent_responses.py +0 -88
  411. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_modal_ft/old/quick_trace_check.py +0 -77
  412. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/compare_experiments.py +0 -324
  413. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/filter_traces_sft_turso.py +0 -580
  414. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/kick_off_ft_oai.py +0 -362
  415. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/multi_model_config.toml +0 -49
  416. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/analyze_enhanced_hooks.py +0 -332
  417. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/analyze_hook_events.py +0 -97
  418. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/analyze_hook_results.py +0 -217
  419. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/check_hook_storage.py +0 -87
  420. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/check_seeds.py +0 -88
  421. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/compare_seed_performance.py +0 -195
  422. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/custom_eval_pipelines.py +0 -400
  423. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/plot_hook_frequency.py +0 -195
  424. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/old/seed_analysis_summary.py +0 -56
  425. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_openai_ft/run_rollouts_for_models_and_compare_v3.py +0 -858
  426. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_quick_evaluation.py +0 -52
  427. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_react_agent.py +0 -874
  428. synth_ai/environments/examples/crafter_classic/agent_demos/crafter_trace_evaluation.py +0 -1412
  429. synth_ai/environments/examples/crafter_classic/agent_demos/example_v3_usage.py +0 -216
  430. synth_ai/environments/examples/crafter_classic/agent_demos/old/compare_traces.py +0 -296
  431. synth_ai/environments/examples/crafter_classic/agent_demos/old/crafter_comprehensive_evaluation.py +0 -58
  432. synth_ai/environments/examples/crafter_classic/agent_demos/old/crafter_env_serialization.py +0 -464
  433. synth_ai/environments/examples/crafter_classic/agent_demos/old/crafter_evaluation_browser.py +0 -152
  434. synth_ai/environments/examples/crafter_classic/agent_demos/old/crafter_quick_evaluation.py +0 -51
  435. synth_ai/environments/examples/crafter_classic/agent_demos/old/crafter_trace_evaluation.py +0 -1412
  436. synth_ai/environments/examples/crafter_classic/agent_demos/old/debug_player_loss.py +0 -112
  437. synth_ai/environments/examples/crafter_classic/agent_demos/old/diagnose_service.py +0 -203
  438. synth_ai/environments/examples/crafter_classic/agent_demos/old/diagnose_slowness.py +0 -305
  439. synth_ai/environments/examples/crafter_classic/agent_demos/old/eval_by_difficulty.py +0 -126
  440. synth_ai/environments/examples/crafter_classic/agent_demos/old/eval_example.py +0 -94
  441. synth_ai/environments/examples/crafter_classic/agent_demos/old/explore_saved_states.py +0 -142
  442. synth_ai/environments/examples/crafter_classic/agent_demos/old/filter_traces_sft.py +0 -26
  443. synth_ai/environments/examples/crafter_classic/agent_demos/old/filter_traces_sft_OLD.py +0 -984
  444. synth_ai/environments/examples/crafter_classic/agent_demos/old/generate_ft_data_gemini.py +0 -724
  445. synth_ai/environments/examples/crafter_classic/agent_demos/old/generate_ft_data_modal.py +0 -386
  446. synth_ai/environments/examples/crafter_classic/agent_demos/old/generate_ft_metadata.py +0 -205
  447. synth_ai/environments/examples/crafter_classic/agent_demos/old/kick_off_ft_gemini.py +0 -150
  448. synth_ai/environments/examples/crafter_classic/agent_demos/old/kick_off_ft_modal.py +0 -283
  449. synth_ai/environments/examples/crafter_classic/agent_demos/old/prepare_vertex_ft.py +0 -280
  450. synth_ai/environments/examples/crafter_classic/agent_demos/old/profile_env_slowness.py +0 -456
  451. synth_ai/environments/examples/crafter_classic/agent_demos/old/replicate_issue.py +0 -166
  452. synth_ai/environments/examples/crafter_classic/agent_demos/old/run_and_eval.py +0 -102
  453. synth_ai/environments/examples/crafter_classic/agent_demos/old/run_comparison.py +0 -128
  454. synth_ai/environments/examples/crafter_classic/agent_demos/old/run_qwen_rollouts.py +0 -655
  455. synth_ai/environments/examples/crafter_classic/agent_demos/old/trace_eval_OLD.py +0 -202
  456. synth_ai/environments/examples/crafter_classic/agent_demos/old/validate_openai_format.py +0 -166
  457. synth_ai/environments/examples/crafter_classic/config_logging.py +0 -111
  458. synth_ai/environments/examples/crafter_classic/debug_translation.py +0 -0
  459. synth_ai/environments/examples/crafter_classic/engine.py +0 -579
  460. synth_ai/environments/examples/crafter_classic/engine_deterministic_patch.py +0 -64
  461. synth_ai/environments/examples/crafter_classic/engine_helpers/action_map.py +0 -6
  462. synth_ai/environments/examples/crafter_classic/engine_helpers/serialization.py +0 -75
  463. synth_ai/environments/examples/crafter_classic/engine_serialization_patch_v3.py +0 -267
  464. synth_ai/environments/examples/crafter_classic/environment.py +0 -404
  465. synth_ai/environments/examples/crafter_classic/taskset.py +0 -233
  466. synth_ai/environments/examples/crafter_classic/trace_hooks_v3.py +0 -228
  467. synth_ai/environments/examples/crafter_classic/world_config_patch_simple.py +0 -299
  468. synth_ai/environments/examples/crafter_custom/__init__.py +0 -4
  469. synth_ai/environments/examples/crafter_custom/agent_demos/__init__.py +0 -1
  470. synth_ai/environments/examples/crafter_custom/agent_demos/trace_eval.py +0 -202
  471. synth_ai/environments/examples/crafter_custom/crafter/__init__.py +0 -7
  472. synth_ai/environments/examples/crafter_custom/crafter/config.py +0 -182
  473. synth_ai/environments/examples/crafter_custom/crafter/constants.py +0 -8
  474. synth_ai/environments/examples/crafter_custom/crafter/engine.py +0 -269
  475. synth_ai/environments/examples/crafter_custom/crafter/env.py +0 -262
  476. synth_ai/environments/examples/crafter_custom/crafter/objects.py +0 -417
  477. synth_ai/environments/examples/crafter_custom/crafter/recorder.py +0 -187
  478. synth_ai/environments/examples/crafter_custom/crafter/worldgen.py +0 -118
  479. synth_ai/environments/examples/crafter_custom/dataset_builder.py +0 -373
  480. synth_ai/environments/examples/crafter_custom/environment.py +0 -312
  481. synth_ai/environments/examples/crafter_custom/old/analyze_diamond_issue.py +0 -159
  482. synth_ai/environments/examples/crafter_custom/old/analyze_diamond_spawning.py +0 -158
  483. synth_ai/environments/examples/crafter_custom/old/compare_worlds.py +0 -71
  484. synth_ai/environments/examples/crafter_custom/old/dataset_stats.py +0 -105
  485. synth_ai/environments/examples/crafter_custom/old/diamond_spawning_summary.py +0 -119
  486. synth_ai/environments/examples/crafter_custom/old/example_dataset_usage.py +0 -52
  487. synth_ai/environments/examples/crafter_custom/run_dataset.py +0 -305
  488. synth_ai/environments/examples/enron/art_helpers/email_search_tools.py +0 -156
  489. synth_ai/environments/examples/enron/art_helpers/local_email_db.py +0 -281
  490. synth_ai/environments/examples/enron/art_helpers/types_enron.py +0 -25
  491. synth_ai/environments/examples/enron/engine.py +0 -295
  492. synth_ai/environments/examples/enron/environment.py +0 -166
  493. synth_ai/environments/examples/enron/taskset.py +0 -112
  494. synth_ai/environments/examples/enron/units/keyword_stats.py +0 -112
  495. synth_ai/environments/examples/minigrid/__init__.py +0 -48
  496. synth_ai/environments/examples/minigrid/agent_demos/minigrid_evaluation_framework.py +0 -1188
  497. synth_ai/environments/examples/minigrid/agent_demos/minigrid_quick_evaluation.py +0 -48
  498. synth_ai/environments/examples/minigrid/agent_demos/minigrid_react_agent.py +0 -562
  499. synth_ai/environments/examples/minigrid/agent_demos/minigrid_trace_evaluation.py +0 -221
  500. synth_ai/environments/examples/minigrid/engine.py +0 -589
  501. synth_ai/environments/examples/minigrid/environment.py +0 -274
  502. synth_ai/environments/examples/minigrid/environment_mapping.py +0 -242
  503. synth_ai/environments/examples/minigrid/puzzle_loader.py +0 -417
  504. synth_ai/environments/examples/minigrid/taskset.py +0 -583
  505. synth_ai/environments/examples/nethack/__init__.py +0 -7
  506. synth_ai/environments/examples/nethack/achievements.py +0 -337
  507. synth_ai/environments/examples/nethack/agent_demos/nethack_evaluation_framework.py +0 -981
  508. synth_ai/environments/examples/nethack/agent_demos/nethack_quick_evaluation.py +0 -74
  509. synth_ai/environments/examples/nethack/agent_demos/nethack_react_agent.py +0 -831
  510. synth_ai/environments/examples/nethack/engine.py +0 -739
  511. synth_ai/environments/examples/nethack/environment.py +0 -256
  512. synth_ai/environments/examples/nethack/helpers/__init__.py +0 -41
  513. synth_ai/environments/examples/nethack/helpers/action_mapping.py +0 -301
  514. synth_ai/environments/examples/nethack/helpers/nle_wrapper.py +0 -402
  515. synth_ai/environments/examples/nethack/helpers/observation_utils.py +0 -433
  516. synth_ai/environments/examples/nethack/helpers/recording_wrapper.py +0 -200
  517. synth_ai/environments/examples/nethack/helpers/trajectory_recorder.py +0 -269
  518. synth_ai/environments/examples/nethack/helpers/visualization/replay_viewer.py +0 -308
  519. synth_ai/environments/examples/nethack/helpers/visualization/visualizer.py +0 -431
  520. synth_ai/environments/examples/nethack/taskset.py +0 -323
  521. synth_ai/environments/examples/red/__init__.py +0 -7
  522. synth_ai/environments/examples/red/agent_demos/__init__.py +0 -1
  523. synth_ai/environments/examples/red/config_logging.py +0 -110
  524. synth_ai/environments/examples/red/engine.py +0 -694
  525. synth_ai/environments/examples/red/engine_helpers/__init__.py +0 -1
  526. synth_ai/environments/examples/red/engine_helpers/memory_map.py +0 -28
  527. synth_ai/environments/examples/red/engine_helpers/reward_components.py +0 -276
  528. synth_ai/environments/examples/red/engine_helpers/reward_library/__init__.py +0 -142
  529. synth_ai/environments/examples/red/engine_helpers/reward_library/adaptive_rewards.py +0 -57
  530. synth_ai/environments/examples/red/engine_helpers/reward_library/battle_rewards.py +0 -284
  531. synth_ai/environments/examples/red/engine_helpers/reward_library/composite_rewards.py +0 -150
  532. synth_ai/environments/examples/red/engine_helpers/reward_library/economy_rewards.py +0 -138
  533. synth_ai/environments/examples/red/engine_helpers/reward_library/efficiency_rewards.py +0 -57
  534. synth_ai/environments/examples/red/engine_helpers/reward_library/exploration_rewards.py +0 -331
  535. synth_ai/environments/examples/red/engine_helpers/reward_library/novelty_rewards.py +0 -121
  536. synth_ai/environments/examples/red/engine_helpers/reward_library/pallet_town_rewards.py +0 -559
  537. synth_ai/environments/examples/red/engine_helpers/reward_library/pokemon_rewards.py +0 -313
  538. synth_ai/environments/examples/red/engine_helpers/reward_library/social_rewards.py +0 -148
  539. synth_ai/environments/examples/red/engine_helpers/reward_library/story_rewards.py +0 -247
  540. synth_ai/environments/examples/red/engine_helpers/screen_analysis.py +0 -368
  541. synth_ai/environments/examples/red/engine_helpers/state_extraction.py +0 -140
  542. synth_ai/environments/examples/red/environment.py +0 -238
  543. synth_ai/environments/examples/red/taskset.py +0 -79
  544. synth_ai/environments/examples/red/units/__init__.py +0 -1
  545. synth_ai/environments/examples/sokoban/__init__.py +0 -1
  546. synth_ai/environments/examples/sokoban/agent_demos/sokoban_full_eval.py +0 -899
  547. synth_ai/environments/examples/sokoban/engine.py +0 -678
  548. synth_ai/environments/examples/sokoban/engine_helpers/__init__.py +0 -1
  549. synth_ai/environments/examples/sokoban/engine_helpers/room_utils.py +0 -657
  550. synth_ai/environments/examples/sokoban/engine_helpers/vendored/__init__.py +0 -18
  551. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/__init__.py +0 -3
  552. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/boxoban_env.py +0 -131
  553. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/render_utils.py +0 -370
  554. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/room_utils.py +0 -332
  555. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/sokoban_env.py +0 -306
  556. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/sokoban_env_fixed_targets.py +0 -67
  557. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/sokoban_env_pull.py +0 -115
  558. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/sokoban_env_two_player.py +0 -123
  559. synth_ai/environments/examples/sokoban/engine_helpers/vendored/envs/sokoban_env_variations.py +0 -394
  560. synth_ai/environments/examples/sokoban/environment.py +0 -229
  561. synth_ai/environments/examples/sokoban/generate_verified_puzzles.py +0 -440
  562. synth_ai/environments/examples/sokoban/puzzle_loader.py +0 -312
  563. synth_ai/environments/examples/sokoban/taskset.py +0 -428
  564. synth_ai/environments/examples/sokoban/units/astar_common.py +0 -95
  565. synth_ai/environments/examples/tictactoe/__init__.py +0 -1
  566. synth_ai/environments/examples/tictactoe/engine.py +0 -368
  567. synth_ai/environments/examples/tictactoe/environment.py +0 -240
  568. synth_ai/environments/examples/tictactoe/taskset.py +0 -215
  569. synth_ai/environments/examples/verilog/__init__.py +0 -10
  570. synth_ai/environments/examples/verilog/engine.py +0 -329
  571. synth_ai/environments/examples/verilog/environment.py +0 -350
  572. synth_ai/environments/examples/verilog/taskset.py +0 -420
  573. synth_ai/environments/examples/wordle/__init__.py +0 -29
  574. synth_ai/environments/examples/wordle/engine.py +0 -398
  575. synth_ai/environments/examples/wordle/environment.py +0 -159
  576. synth_ai/environments/examples/wordle/helpers/generate_instances_wordfreq.py +0 -75
  577. synth_ai/environments/examples/wordle/taskset.py +0 -230
  578. synth_ai/environments/reproducibility/core.py +0 -42
  579. synth_ai/environments/reproducibility/helpers.py +0 -0
  580. synth_ai/environments/reproducibility/tree.py +0 -364
  581. synth_ai/environments/service/app.py +0 -98
  582. synth_ai/environments/service/core_routes.py +0 -1020
  583. synth_ai/environments/service/external_registry.py +0 -56
  584. synth_ai/environments/service/registry.py +0 -9
  585. synth_ai/environments/stateful/__init__.py +0 -1
  586. synth_ai/environments/stateful/core.py +0 -163
  587. synth_ai/environments/stateful/engine.py +0 -21
  588. synth_ai/environments/stateful/state.py +0 -7
  589. synth_ai/environments/tasks/api.py +0 -19
  590. synth_ai/environments/tasks/core.py +0 -80
  591. synth_ai/environments/tasks/filters.py +0 -41
  592. synth_ai/environments/tasks/utils.py +0 -91
  593. synth_ai/environments/v0_observability/history.py +0 -3
  594. synth_ai/environments/v0_observability/log.py +0 -2
  595. synth_ai/evals/base.py +0 -15
  596. synth_ai/experimental/synth_oss.py +0 -446
  597. synth_ai/handshake.py +0 -63
  598. synth_ai/http.py +0 -26
  599. synth_ai/http_client.py +0 -104
  600. synth_ai/inference/client.py +0 -20
  601. synth_ai/install_sqld.sh +0 -40
  602. synth_ai/jobs/client.py +0 -246
  603. synth_ai/learning/__init__.py +0 -24
  604. synth_ai/learning/config.py +0 -43
  605. synth_ai/learning/filtering.py +0 -0
  606. synth_ai/learning/ft_client.py +0 -59
  607. synth_ai/learning/offline/dpo.py +0 -0
  608. synth_ai/learning/offline/providers.py +0 -7
  609. synth_ai/learning/offline/sft.py +0 -0
  610. synth_ai/learning/offline/shared.py +0 -0
  611. synth_ai/learning/online/grpo.py +0 -0
  612. synth_ai/learning/online/irft.py +0 -0
  613. synth_ai/learning/prompts/banking77_injection_eval.py +0 -168
  614. synth_ai/learning/prompts/gepa.py +0 -0
  615. synth_ai/learning/prompts/hello_world_in_context_injection_ex.py +0 -213
  616. synth_ai/learning/prompts/mipro.py +0 -289
  617. synth_ai/learning/prompts/random_search.py +0 -246
  618. synth_ai/learning/prompts/run_mipro_banking77.py +0 -172
  619. synth_ai/learning/prompts/run_random_search_banking77.py +0 -324
  620. synth_ai/learning/sse.py +0 -58
  621. synth_ai/learning/validators.py +0 -48
  622. synth_ai/lm/__init__.py +0 -51
  623. synth_ai/lm/caching/constants.py +0 -6
  624. synth_ai/lm/caching/dbs.py +0 -0
  625. synth_ai/lm/caching/ephemeral.py +0 -102
  626. synth_ai/lm/caching/handler.py +0 -137
  627. synth_ai/lm/caching/initialize.py +0 -11
  628. synth_ai/lm/caching/persistent.py +0 -114
  629. synth_ai/lm/config.py +0 -110
  630. synth_ai/lm/constants.py +0 -32
  631. synth_ai/lm/core/__init__.py +0 -8
  632. synth_ai/lm/core/all.py +0 -73
  633. synth_ai/lm/core/exceptions.py +0 -7
  634. synth_ai/lm/core/main.py +0 -319
  635. synth_ai/lm/core/main_v3.py +0 -594
  636. synth_ai/lm/core/synth_models.py +0 -48
  637. synth_ai/lm/core/vendor_clients.py +0 -188
  638. synth_ai/lm/cost/__init__.py +0 -0
  639. synth_ai/lm/cost/monitor.py +0 -1
  640. synth_ai/lm/cost/statefulness.py +0 -1
  641. synth_ai/lm/injection.py +0 -80
  642. synth_ai/lm/overrides.py +0 -206
  643. synth_ai/lm/provider_support/__init__.py +0 -8
  644. synth_ai/lm/provider_support/anthropic.py +0 -972
  645. synth_ai/lm/provider_support/openai.py +0 -1139
  646. synth_ai/lm/provider_support/suppress_logging.py +0 -31
  647. synth_ai/lm/structured_outputs/__init__.py +0 -0
  648. synth_ai/lm/structured_outputs/handler.py +0 -440
  649. synth_ai/lm/structured_outputs/inject.py +0 -297
  650. synth_ai/lm/structured_outputs/rehabilitate.py +0 -185
  651. synth_ai/lm/tools/__init__.py +0 -3
  652. synth_ai/lm/tools/base.py +0 -172
  653. synth_ai/lm/unified_interface.py +0 -202
  654. synth_ai/lm/vendors/__init__.py +0 -0
  655. synth_ai/lm/vendors/base.py +0 -81
  656. synth_ai/lm/vendors/core/__init__.py +0 -0
  657. synth_ai/lm/vendors/core/anthropic_api.py +0 -387
  658. synth_ai/lm/vendors/core/gemini_api.py +0 -292
  659. synth_ai/lm/vendors/core/mistral_api.py +0 -322
  660. synth_ai/lm/vendors/core/openai_api.py +0 -225
  661. synth_ai/lm/vendors/core/synth_dev_api.py +0 -0
  662. synth_ai/lm/vendors/local/__init__.py +0 -0
  663. synth_ai/lm/vendors/local/ollama.py +0 -0
  664. synth_ai/lm/vendors/openai_standard.py +0 -780
  665. synth_ai/lm/vendors/openai_standard_responses.py +0 -256
  666. synth_ai/lm/vendors/retries.py +0 -22
  667. synth_ai/lm/vendors/supported/__init__.py +0 -0
  668. synth_ai/lm/vendors/supported/custom_endpoint.py +0 -417
  669. synth_ai/lm/vendors/supported/deepseek.py +0 -69
  670. synth_ai/lm/vendors/supported/grok.py +0 -75
  671. synth_ai/lm/vendors/supported/groq.py +0 -16
  672. synth_ai/lm/vendors/supported/ollama.py +0 -15
  673. synth_ai/lm/vendors/supported/openrouter.py +0 -74
  674. synth_ai/lm/vendors/supported/together.py +0 -11
  675. synth_ai/lm/vendors/synth_client.py +0 -808
  676. synth_ai/lm/warmup.py +0 -186
  677. synth_ai/rl/secrets.py +0 -19
  678. synth_ai/scripts/verify_rewards.py +0 -100
  679. synth_ai/task/__init__.py +0 -10
  680. synth_ai/task/contracts.py +0 -120
  681. synth_ai/task/health.py +0 -28
  682. synth_ai/task/validators.py +0 -12
  683. synth_ai/tracing/__init__.py +0 -30
  684. synth_ai/tracing_v1/__init__.py +0 -33
  685. synth_ai/tracing_v3/config.py +0 -84
  686. synth_ai/tracing_v3/storage/config.py +0 -62
  687. synth_ai/tracing_v3/turso/__init__.py +0 -25
  688. synth_ai/tracing_v3/turso/daemon.py +0 -144
  689. synth_ai/tracing_v3/turso/manager.py +0 -760
  690. synth_ai/v0/tracing/__init__.py +0 -0
  691. synth_ai/v0/tracing/abstractions.py +0 -224
  692. synth_ai/v0/tracing/base_client.py +0 -91
  693. synth_ai/v0/tracing/client_manager.py +0 -131
  694. synth_ai/v0/tracing/config.py +0 -142
  695. synth_ai/v0/tracing/context.py +0 -146
  696. synth_ai/v0/tracing/decorators.py +0 -682
  697. synth_ai/v0/tracing/events/__init__.py +0 -0
  698. synth_ai/v0/tracing/events/manage.py +0 -147
  699. synth_ai/v0/tracing/events/scope.py +0 -86
  700. synth_ai/v0/tracing/events/store.py +0 -228
  701. synth_ai/v0/tracing/immediate_client.py +0 -151
  702. synth_ai/v0/tracing/local.py +0 -18
  703. synth_ai/v0/tracing/log_client_base.py +0 -73
  704. synth_ai/v0/tracing/retry_queue.py +0 -186
  705. synth_ai/v0/tracing/trackers.py +0 -515
  706. synth_ai/v0/tracing/upload.py +0 -512
  707. synth_ai/v0/tracing/utils.py +0 -9
  708. synth_ai/v0/tracing_v1/__init__.py +0 -16
  709. synth_ai/v0/tracing_v1/abstractions.py +0 -224
  710. synth_ai/v0/tracing_v1/base_client.py +0 -91
  711. synth_ai/v0/tracing_v1/client_manager.py +0 -131
  712. synth_ai/v0/tracing_v1/config.py +0 -142
  713. synth_ai/v0/tracing_v1/context.py +0 -146
  714. synth_ai/v0/tracing_v1/decorators.py +0 -703
  715. synth_ai/v0/tracing_v1/events/__init__.py +0 -0
  716. synth_ai/v0/tracing_v1/events/manage.py +0 -147
  717. synth_ai/v0/tracing_v1/events/scope.py +0 -86
  718. synth_ai/v0/tracing_v1/events/store.py +0 -228
  719. synth_ai/v0/tracing_v1/immediate_client.py +0 -151
  720. synth_ai/v0/tracing_v1/local.py +0 -18
  721. synth_ai/v0/tracing_v1/log_client_base.py +0 -73
  722. synth_ai/v0/tracing_v1/retry_queue.py +0 -186
  723. synth_ai/v0/tracing_v1/trackers.py +0 -515
  724. synth_ai/v0/tracing_v1/upload.py +0 -527
  725. synth_ai/v0/tracing_v1/utils.py +0 -9
  726. synth_ai/zyk/__init__.py +0 -30
  727. synth_ai-0.2.8.dev2.dist-info/METADATA +0 -129
  728. synth_ai-0.2.8.dev2.dist-info/RECORD +0 -420
  729. /synth_ai/{demos → cli/demo_apps}/demo_task_apps/math/__init__.py +0 -0
  730. /synth_ai/{lm/caching → core/apps}/__init__.py +0 -0
  731. /synth_ai/{tracing_v3 → core/tracing_v3}/lm_call_record_abstractions.py +0 -0
  732. /synth_ai/{tracing_v3 → core/tracing_v3}/storage/__init__.py +0 -0
  733. /synth_ai/{tracing_v3 → core/tracing_v3}/storage/exceptions.py +0 -0
  734. /synth_ai/{tracing_v3 → core/tracing_v3}/storage/types.py +0 -0
  735. /synth_ai/{compound/cais.py → py.typed} +0 -0
  736. /synth_ai/{learning → sdk/learning}/core.py +0 -0
  737. /synth_ai/{learning → sdk/learning}/gateway.py +0 -0
  738. {synth_ai-0.2.8.dev2.dist-info → synth_ai-0.4.3.dist-info}/WHEEL +0 -0
  739. {synth_ai-0.2.8.dev2.dist-info → synth_ai-0.4.3.dist-info}/licenses/LICENSE +0 -0
  740. {synth_ai-0.2.8.dev2.dist-info → synth_ai-0.4.3.dist-info}/top_level.txt +0 -0
@@ -1,738 +0,0 @@
1
- #!/usr/bin/env python3
2
- """
3
- Filter traces from Turso/SQLite (v3) to create Modal/Synth SFT-ready .jsonl files
4
- Supports two modes:
5
- 1. Trajectory-level filtering: Include entire trajectories above a score threshold
6
- 2. Window-based filtering: Extract high-scoring windows of actions
7
-
8
- This is the v3 version using the new async Turso-based tracing system.
9
- """
10
-
11
- import json
12
- import argparse
13
- import asyncio
14
- from pathlib import Path
15
- from typing import List, Dict, Any, Tuple, Optional
16
- from collections import defaultdict
17
- import numpy as np
18
- import os
19
- import sys
20
- import toml
21
- import pandas as pd
22
-
23
- # Add synth_ai to path
24
- sys.path.insert(0, str(Path(__file__).parent.parent.parent.parent.parent.parent))
25
-
26
- from synth_ai.tracing_v3 import SessionTracer
27
- from synth_ai.tracing_v3.turso.manager import AsyncSQLTraceManager
28
- from synth_ai.tracing_v3.abstractions import LMCAISEvent, EnvironmentEvent, RuntimeEvent
29
-
30
-
31
- def create_histogram(data: List[float], bins: int = 20, width: int = 60, height: int = 15,
32
- title: str = "", x_label: str = "", y_label: str = "") -> str:
33
- """Create a beautiful ASCII histogram."""
34
- if not data:
35
- return "No data to display"
36
-
37
- # Create histogram
38
- counts, edges = np.histogram(data, bins=bins)
39
- max_count = max(counts) if len(counts) > 0 else 1
40
-
41
- # Normalize heights
42
- if max_count > 0:
43
- heights = [int(c * height / max_count) for c in counts]
44
- else:
45
- heights = [0] * len(counts)
46
-
47
- # Build the plot
48
- lines = []
49
-
50
- # Title
51
- if title:
52
- lines.append(f"\n{title.center(width + 10)}")
53
- lines.append("=" * (width + 10))
54
-
55
- # Y-axis label
56
- if y_label:
57
- lines.append(f"{y_label}")
58
-
59
- # Plot area with y-axis
60
- for y in range(height, 0, -1):
61
- # Y-axis value
62
- y_val = int(max_count * y / height)
63
- line = f"{y_val:>6} │"
64
-
65
- # Bars
66
- for h in heights:
67
- if h >= y:
68
- line += "█"
69
- else:
70
- line += " "
71
-
72
- lines.append(line)
73
-
74
- # X-axis
75
- lines.append(f"{'':>6} └" + "─" * len(heights))
76
-
77
- # X-axis labels
78
- x_labels_line = " " * 8
79
- min_val, max_val = min(data), max(data)
80
-
81
- # Add labels at key positions
82
- label_positions = [0, len(heights)//4, len(heights)//2, 3*len(heights)//4, len(heights)-1]
83
- for i, pos in enumerate(label_positions):
84
- if pos < len(edges) - 1:
85
- val = edges[pos]
86
- label = f"{val:.1f}"
87
- # Calculate position
88
- target_pos = 8 + pos
89
- if i == 0:
90
- x_labels_line = label + x_labels_line[len(label):]
91
- elif i == len(label_positions) - 1:
92
- start = max(0, target_pos - len(label))
93
- x_labels_line = x_labels_line[:start] + label
94
- else:
95
- start = max(0, target_pos - len(label)//2)
96
- end = min(len(x_labels_line), start + len(label))
97
- if start < len(x_labels_line):
98
- x_labels_line = x_labels_line[:start] + label[:end-start] + x_labels_line[end:]
99
-
100
- lines.append(x_labels_line)
101
-
102
- # X-axis label
103
- if x_label:
104
- lines.append(f"\n{x_label.center(width + 10)}")
105
-
106
- return "\n".join(lines)
107
-
108
-
109
- def create_bar_chart(categories: List[str], values: List[int], width: int = 60,
110
- title: str = "", show_values: bool = True) -> str:
111
- """Create a horizontal bar chart."""
112
- if not categories or not values:
113
- return "No data to display"
114
-
115
- max_val = max(values) if values else 1
116
- lines = []
117
-
118
- # Title
119
- if title:
120
- lines.append(f"\n{title}")
121
- lines.append("=" * (width + 20))
122
-
123
- # Find longest category name for alignment
124
- max_cat_len = max(len(cat) for cat in categories)
125
-
126
- # Create bars
127
- for cat, val in zip(categories, values):
128
- # Normalize bar length
129
- bar_len = int(val * width / max_val) if max_val > 0 else 0
130
- bar = "█" * bar_len
131
-
132
- # Format line
133
- if show_values:
134
- line = f"{cat:<{max_cat_len}} │ {bar} {val}"
135
- else:
136
- line = f"{cat:<{max_cat_len}} │ {bar}"
137
-
138
- lines.append(line)
139
-
140
- return "\n".join(lines)
141
-
142
-
143
- class FinetuningDataExtractorV3:
144
- """Extract fine-tuning data from v3 Turso traces."""
145
-
146
- def __init__(self, db_url: str):
147
- self.db_manager = AsyncSQLTraceManager(db_url)
148
- self._initialized = False
149
-
150
- async def __aenter__(self):
151
- await self.db_manager.initialize()
152
- self._initialized = True
153
- return self
154
-
155
- async def __aexit__(self, exc_type, exc_val, exc_tb):
156
- await self.db_manager.close()
157
-
158
- async def get_all_sessions(self) -> pd.DataFrame:
159
- """Get all session IDs from the database."""
160
- query = """
161
- SELECT DISTINCT session_id, created_at
162
- FROM session_traces
163
- ORDER BY created_at DESC
164
- """
165
- return await self.db_manager.query_traces(query)
166
-
167
- async def get_session_metrics(self, session_id: str) -> Dict[str, Any]:
168
- """Get metrics for a specific session."""
169
- # Prefer outcome rewards table if present; fall back to environment event sums
170
- outcome_query = """
171
- SELECT COALESCE(MAX(total_reward), 0) as total_reward
172
- FROM outcome_rewards
173
- WHERE session_id = :session_id
174
- """
175
- outcome_df = await self.db_manager.query_traces(outcome_query, {"session_id": session_id})
176
- total_reward: float = 0.0
177
- try:
178
- if not outcome_df.empty:
179
- total_reward = float(outcome_df['total_reward'].iloc[0] or 0.0)
180
- except Exception:
181
- total_reward = 0.0
182
-
183
- if total_reward == 0.0:
184
- # Fallback: sum environment rewards
185
- reward_query = """
186
- SELECT COALESCE(SUM(reward), 0) as total_reward
187
- FROM events
188
- WHERE session_id = :session_id
189
- AND event_type = 'environment'
190
- AND reward IS NOT NULL
191
- """
192
- reward_df = await self.db_manager.query_traces(reward_query, {"session_id": session_id})
193
- total_reward = float(reward_df['total_reward'].iloc[0]) if not reward_df.empty else 0.0
194
-
195
- # Get total tokens and cost from LM events
196
- lm_query = """
197
- SELECT
198
- COALESCE(SUM(total_tokens), 0) as total_tokens,
199
- COALESCE(SUM(cost_usd) / 100.0, 0) as total_cost
200
- FROM events
201
- WHERE session_id = :session_id
202
- AND event_type = 'cais'
203
- """
204
- lm_df = await self.db_manager.query_traces(lm_query, {"session_id": session_id})
205
-
206
- total_tokens = int(lm_df['total_tokens'].iloc[0]) if not lm_df.empty else 0
207
- total_cost = float(lm_df['total_cost'].iloc[0]) if not lm_df.empty else 0.0
208
-
209
- return {
210
- 'session_id': session_id,
211
- 'total_reward': total_reward,
212
- 'total_tokens': total_tokens,
213
- 'total_cost': total_cost
214
- }
215
-
216
- async def get_session_achievements(self, session_id: str) -> List[str]:
217
- """Get list of achievements unlocked in a session.
218
-
219
- Aggregates across ALL environment events with a non-null system_state_after,
220
- unioning any flags that were ever true. This is more robust than inspecting
221
- only the last event, which can miss transient unlocks.
222
- """
223
- query = """
224
- SELECT system_state_after
225
- FROM events
226
- WHERE session_id = :session_id
227
- AND event_type = 'environment'
228
- AND system_state_after IS NOT NULL
229
- ORDER BY id ASC
230
- """
231
- df = await self.db_manager.query_traces(query, {"session_id": session_id})
232
-
233
- if df.empty:
234
- return []
235
-
236
- unlocked: Dict[str, bool] = {}
237
- for _, row in df.iterrows():
238
- try:
239
- state_after = row['system_state_after']
240
- if not state_after:
241
- continue
242
- if isinstance(state_after, str):
243
- state_after = json.loads(state_after)
244
- if not isinstance(state_after, dict):
245
- continue
246
- public_state = state_after.get('public_state')
247
- if not isinstance(public_state, dict):
248
- continue
249
- ach = public_state.get('achievements_status')
250
- if not isinstance(ach, dict):
251
- continue
252
- for name, flag in ach.items():
253
- if flag:
254
- unlocked[name] = True
255
- except Exception as e:
256
- print(f"Error parsing achievements row: {e}")
257
- continue
258
-
259
- return [k for k, v in unlocked.items() if v]
260
-
261
- async def filter_by_achievements(self, min_achievements: int) -> List[str]:
262
- """Get sessions with at least min_achievements unlocked."""
263
- all_sessions = await self.get_all_sessions()
264
- qualifying_sessions = []
265
-
266
- for _, row in all_sessions.iterrows():
267
- session_id = row['session_id']
268
- achievements = await self.get_session_achievements(session_id)
269
- if len(achievements) >= min_achievements:
270
- qualifying_sessions.append(session_id)
271
-
272
- return qualifying_sessions
273
-
274
- async def extract_openai_format(self, session_ids: List[str], min_reward: float = 0.0) -> List[Dict[str, Any]]:
275
- """Extract training data in OpenAI format from filtered sessions."""
276
- training_data = []
277
-
278
- for session_id in session_ids:
279
- # Get messages directly from the messages table
280
- messages_query = """
281
- SELECT m.message_type, m.content, m.message_time, st.turn_number
282
- FROM messages m
283
- LEFT JOIN session_timesteps st ON m.timestep_id = st.id
284
- WHERE m.session_id = :session_id
285
- ORDER BY COALESCE(st.turn_number, m.message_time), m.id
286
- """
287
-
288
- messages_df = await self.db_manager.query_traces(messages_query, {"session_id": session_id})
289
-
290
- if len(messages_df) == 0:
291
- continue
292
-
293
- # Build conversation history
294
- messages = []
295
- system_message = None
296
-
297
- for _, row in messages_df.iterrows():
298
- msg_type = row['message_type']
299
- content = row['content']
300
-
301
- # Parse content if it's JSON (from origin_system_id format)
302
- try:
303
- import json
304
- content_data = json.loads(content)
305
- if isinstance(content_data, dict) and 'payload' in content_data:
306
- content = content_data['payload']
307
- except:
308
- pass
309
-
310
- if msg_type == 'system' and system_message is None:
311
- # Extract system message from the first system message
312
- if isinstance(content, str):
313
- system_message = content
314
-
315
- elif msg_type == 'user':
316
- # Format user messages
317
- if isinstance(content, dict):
318
- # Convert observation dict to formatted string
319
- content = self._format_observation_content(content)
320
- messages.append({"role": "user", "content": str(content)})
321
-
322
- elif msg_type == 'assistant':
323
- messages.append({"role": "assistant", "content": str(content)})
324
-
325
- # Add system message at the beginning if found
326
- if system_message:
327
- messages.insert(0, {"role": "system", "content": system_message})
328
-
329
- # Only include if we have a complete conversation
330
- if len(messages) > 1:
331
- # Get total reward for this session
332
- reward_query = """
333
- SELECT COALESCE(SUM(reward), 0) as total_reward
334
- FROM events
335
- WHERE session_id = :session_id
336
- AND event_type = 'environment'
337
- AND reward IS NOT NULL
338
- """
339
- reward_df = await self.db_manager.query_traces(reward_query, {"session_id": session_id})
340
- total_reward = reward_df.iloc[0]['total_reward'] if len(reward_df) > 0 else 0
341
-
342
- training_data.append({
343
- "messages": messages,
344
- "metadata": {
345
- "session_id": session_id,
346
- "total_reward": float(total_reward) # Convert to float for JSON serialization
347
- }
348
- })
349
-
350
- return training_data
351
-
352
- async def extract_openai_window_format(self, session_ids: List[str]) -> List[Dict[str, Any]]:
353
- """Extract per-turn user→assistant pairs (window mode) for SFT.
354
-
355
- Emits one example per assistant message, pairing it with the preceding user
356
- message in the same turn (based on session_timesteps.turn_number).
357
- """
358
- window_data: List[Dict[str, Any]] = []
359
-
360
- for session_id in session_ids:
361
- messages_query = """
362
- SELECT st.turn_number, m.message_type, m.content, m.id AS message_id
363
- FROM messages m
364
- LEFT JOIN session_timesteps st ON m.timestep_id = st.id
365
- WHERE m.session_id = :session_id
366
- ORDER BY COALESCE(st.turn_number, m.message_time), m.id
367
- """
368
- df = await self.db_manager.query_traces(messages_query, {"session_id": session_id})
369
- if df is None or df.empty:
370
- continue
371
-
372
- # Parse content and group by turn_number
373
- parsed_rows: List[Dict[str, Any]] = []
374
- for _, row in df.iterrows():
375
- msg_type = row.get('message_type')
376
- content = row.get('content')
377
- try:
378
- content_data = json.loads(content)
379
- if isinstance(content_data, dict) and 'payload' in content_data:
380
- content = content_data['payload']
381
- except Exception:
382
- pass
383
- parsed_rows.append({
384
- 'turn_number': row.get('turn_number'),
385
- 'message_type': msg_type,
386
- 'content': content,
387
- })
388
-
389
- # Build windows per turn_number
390
- from collections import defaultdict
391
- turn_to_msgs: Dict[int, List[Dict[str, Any]]] = defaultdict(list)
392
- for r in parsed_rows:
393
- tn = r.get('turn_number')
394
- if tn is None:
395
- # Skip rows that aren't associated with a turn
396
- continue
397
- turn_to_msgs[int(tn)].append(r)
398
-
399
- # For each turn, find user -> assistant pair(s)
400
- for tn in sorted(turn_to_msgs.keys()):
401
- msgs = turn_to_msgs[tn]
402
- # find last user before first assistant
403
- user_content: Optional[str] = None
404
- assistant_content: Optional[str] = None
405
- for r in msgs:
406
- if r['message_type'] == 'user':
407
- user_content = r['content']
408
- elif r['message_type'] == 'assistant' and assistant_content is None:
409
- assistant_content = r['content']
410
- if user_content and assistant_content:
411
- window_data.append({
412
- 'messages': [
413
- { 'role': 'user', 'content': str(user_content) },
414
- { 'role': 'assistant', 'content': str(assistant_content) },
415
- ],
416
- 'metadata': {
417
- 'session_id': session_id,
418
- 'turn_number': tn,
419
- }
420
- })
421
-
422
- return window_data
423
-
424
- def _format_observation_content(self, obs: Dict[str, Any]) -> str:
425
- """Format observation dict into a readable string."""
426
- if not isinstance(obs, dict):
427
- return str(obs)
428
-
429
- # Extract key fields for a concise representation
430
- parts = []
431
-
432
- if 'inventory' in obs:
433
- inv = obs['inventory']
434
- inv_str = ", ".join([f"{k}: {v}" for k, v in inv.items() if v > 0])
435
- if inv_str:
436
- parts.append(f"Inventory: {inv_str}")
437
-
438
- if 'achievements_status' in obs:
439
- achievements = [k for k, v in obs['achievements_status'].items() if v]
440
- if achievements:
441
- parts.append(f"Achievements: {', '.join(achievements)}")
442
-
443
- if 'health' in obs:
444
- parts.append(f"Health: {obs.get('health', 0)}")
445
-
446
- return "; ".join(parts) if parts else "Empty observation"
447
-
448
-
449
- async def filter_traces_from_turso(
450
- db_url: str,
451
- output_path: str,
452
- config: Dict[str, Any]
453
- ) -> Tuple[int, Dict[str, Any]]:
454
- """
455
- Filter traces from Turso/SQLite v3 database based on configuration.
456
-
457
- Returns:
458
- Tuple of (num_examples, statistics_dict)
459
- """
460
- mode = config.get("mode", "trajectory")
461
- filters = config.get("filters", {})
462
-
463
- # Extract filtering parameters
464
- min_reward = filters.get("min_total_reward", 0.0)
465
- min_achievements = filters.get("min_achievements", 0)
466
- max_cost = filters.get("max_cost", float('inf'))
467
- max_tokens = filters.get("max_tokens", float('inf'))
468
-
469
- # Modal/Synth specific: filter by model if specified
470
- target_models = filters.get("models", [])
471
-
472
- statistics = {
473
- "total_sessions": 0,
474
- "filtered_sessions": 0,
475
- "total_examples": 0,
476
- "reward_distribution": [],
477
- "token_distribution": [],
478
- "cost_distribution": [],
479
- "model_distribution": defaultdict(int)
480
- }
481
-
482
- async with FinetuningDataExtractorV3(db_url) as extractor:
483
- # Get all sessions
484
- all_sessions = await extractor.get_all_sessions()
485
- statistics["total_sessions"] = len(all_sessions)
486
-
487
- # Filter sessions based on criteria
488
- filtered_sessions = []
489
-
490
- for _, row in all_sessions.iterrows():
491
- session_id = row['session_id']
492
- metrics = await extractor.get_session_metrics(session_id)
493
-
494
- # Apply filters
495
- if metrics['total_reward'] < min_reward:
496
- continue
497
- if metrics['total_cost'] > max_cost:
498
- continue
499
- if metrics['total_tokens'] > max_tokens:
500
- continue
501
-
502
- # Check achievements if required
503
- if min_achievements > 0:
504
- achievements = await extractor.get_session_achievements(session_id)
505
- if len(achievements) < min_achievements:
506
- continue
507
-
508
- # Check model filter if specified
509
- if target_models:
510
- model_query = """
511
- SELECT DISTINCT model_name
512
- FROM events
513
- WHERE session_id = :session_id
514
- AND event_type = 'cais'
515
- AND model_name IS NOT NULL
516
- """
517
- model_df = await extractor.db_manager.query_traces(
518
- model_query, {"session_id": session_id}
519
- )
520
- session_models = model_df['model_name'].tolist() if not model_df.empty else []
521
- if not any(model in target_models for model in session_models):
522
- continue
523
-
524
- filtered_sessions.append(session_id)
525
-
526
- # Collect statistics
527
- statistics["reward_distribution"].append(metrics['total_reward'])
528
- statistics["token_distribution"].append(metrics['total_tokens'])
529
- statistics["cost_distribution"].append(metrics['total_cost'])
530
-
531
- statistics["filtered_sessions"] = len(filtered_sessions)
532
-
533
- # Extract training data
534
- if mode == "trajectory":
535
- training_data = await extractor.extract_openai_format(
536
- session_ids=filtered_sessions,
537
- min_reward=min_reward
538
- )
539
- else: # window mode
540
- # For window mode, we need to implement window extraction
541
- # For now, use trajectory mode
542
- training_data = await extractor.extract_openai_format(
543
- session_ids=filtered_sessions,
544
- min_reward=min_reward
545
- )
546
-
547
- statistics["total_examples"] = len(training_data)
548
-
549
- # Write to output file
550
- output_file = Path(output_path)
551
- output_file.parent.mkdir(exist_ok=True)
552
-
553
- with open(output_file, 'w') as f:
554
- for example in training_data:
555
- f.write(json.dumps(example) + '\n')
556
-
557
- # Get model distribution
558
- model_query = """
559
- SELECT model_name, COUNT(*) as count
560
- FROM events
561
- WHERE event_type = 'cais'
562
- AND model_name IS NOT NULL
563
- GROUP BY model_name
564
- """
565
- model_stats = await extractor.db_manager.query_traces(model_query)
566
- for _, row in model_stats.iterrows():
567
- statistics["model_distribution"][row['model_name']] = int(row['count'])
568
-
569
- return len(training_data), statistics
570
-
571
-
572
- def print_statistics(stats: Dict[str, Any]):
573
- """Print filtering statistics with visualizations."""
574
- print("\n" + "="*80)
575
- print("FILTERING STATISTICS (Modal/Synth - v3)")
576
- print("="*80)
577
-
578
- # Basic counts
579
- print(f"\nTotal sessions in database: {stats['total_sessions']}")
580
- print(f"Sessions after filtering: {stats['filtered_sessions']}")
581
- print(f"Training examples generated: {stats['total_examples']}")
582
-
583
- filter_rate = (stats['filtered_sessions'] / stats['total_sessions'] * 100) if stats['total_sessions'] > 0 else 0
584
- print(f"Filter pass rate: {filter_rate:.1f}%")
585
-
586
- # Reward distribution
587
- if stats['reward_distribution'] and any(not np.isnan(x) for x in stats['reward_distribution']):
588
- valid_rewards = [x for x in stats['reward_distribution'] if not np.isnan(x)]
589
- if valid_rewards:
590
- print(create_histogram(
591
- valid_rewards,
592
- bins=20,
593
- title="Reward Distribution",
594
- x_label="Total Reward",
595
- y_label="Count"
596
- ))
597
-
598
- print(f"\nReward statistics:")
599
- print(f" Min: {min(valid_rewards):.2f}")
600
- print(f" Max: {max(valid_rewards):.2f}")
601
- print(f" Mean: {np.mean(valid_rewards):.2f}")
602
- print(f" Median: {np.median(valid_rewards):.2f}")
603
- else:
604
- print("\nNo valid reward data to display.")
605
-
606
- # Token distribution
607
- if stats['token_distribution'] and any(not np.isnan(x) for x in stats['token_distribution']):
608
- valid_tokens = [x for x in stats['token_distribution'] if not np.isnan(x)]
609
- if valid_tokens:
610
- print(create_histogram(
611
- valid_tokens,
612
- bins=20,
613
- title="Token Usage Distribution",
614
- x_label="Total Tokens",
615
- y_label="Count"
616
- ))
617
-
618
- # Model distribution
619
- if stats['model_distribution']:
620
- models = list(stats['model_distribution'].keys())
621
- counts = list(stats['model_distribution'].values())
622
- print(create_bar_chart(
623
- models,
624
- counts,
625
- title="Model Usage",
626
- show_values=True
627
- ))
628
-
629
- print("\n" + "="*80)
630
-
631
-
632
- def main():
633
- parser = argparse.ArgumentParser(
634
- description="Filter traces from Turso/SQLite v3 for Modal/Synth fine-tuning",
635
- formatter_class=argparse.RawDescriptionHelpFormatter,
636
- epilog="""
637
- Example usage:
638
- # Use default config
639
- python filter_traces_sft_turso.py -d sqlite:///traces.db -o ft_data/training.jsonl
640
-
641
- # Use custom config file
642
- python filter_traces_sft_turso.py -d sqlite:///traces.db -c filter_config.toml
643
-
644
- # Override config parameters
645
- python filter_traces_sft_turso.py -d sqlite:///traces.db --min-reward 5.0 --max-cost 0.1
646
-
647
- # Filter by model
648
- python filter_traces_sft_turso.py -d sqlite:///traces.db --models "Qwen/Qwen2.5-7B-Instruct"
649
- """
650
- )
651
-
652
- parser.add_argument('-d', '--database', required=True, help='Path to Turso/SQLite database or connection URL')
653
- parser.add_argument('-o', '--output', default='ft_data/training_modal.jsonl', help='Output JSONL file')
654
- parser.add_argument('-c', '--config', help='Configuration TOML file')
655
-
656
- # Filter overrides
657
- parser.add_argument('--mode', choices=['trajectory', 'window'], help='Filtering mode')
658
- parser.add_argument('--min-reward', type=float, help='Minimum total reward')
659
- parser.add_argument('--min-achievements', type=int, help='Minimum achievements')
660
- parser.add_argument('--max-cost', type=float, help='Maximum cost')
661
- parser.add_argument('--max-tokens', type=int, help='Maximum tokens')
662
- parser.add_argument('--models', nargs='+', help='Filter by model names (e.g., Qwen/Qwen2.5-7B-Instruct)')
663
-
664
- parser.add_argument('--dry-run', action='store_true', help='Show statistics without writing output')
665
-
666
- args = parser.parse_args()
667
-
668
- # Load config
669
- config = {
670
- "mode": "trajectory",
671
- "filters": {
672
- "min_total_reward": 1.0,
673
- "min_achievements": 0,
674
- "max_cost": 10.0,
675
- "max_tokens": 100000,
676
- "models": [] # Empty means all models
677
- }
678
- }
679
-
680
- if args.config:
681
- with open(args.config, 'r') as f:
682
- loaded_config = toml.load(f)
683
- config.update(loaded_config)
684
-
685
- # Apply command-line overrides
686
- if args.mode:
687
- config["mode"] = args.mode
688
- if args.min_reward is not None:
689
- config["filters"]["min_total_reward"] = args.min_reward
690
- if args.min_achievements is not None:
691
- config["filters"]["min_achievements"] = args.min_achievements
692
- if args.max_cost is not None:
693
- config["filters"]["max_cost"] = args.max_cost
694
- if args.max_tokens is not None:
695
- config["filters"]["max_tokens"] = args.max_tokens
696
- if args.models:
697
- config["filters"]["models"] = args.models
698
-
699
- # Convert database path to proper URL format if needed
700
- db_url = args.database
701
- if db_url.startswith("sqlite:///"):
702
- # Already in URL format
703
- pass
704
- elif db_url.endswith(".db"):
705
- # Convert file path to URL
706
- db_url = f"sqlite+aiosqlite:///{db_url}"
707
-
708
- print(f"🤖 Modal/Synth Fine-Tuning Data Filter (v3)")
709
- print(f"Using database: {db_url}")
710
- print(f"Output file: {args.output}")
711
- print(f"Mode: {config['mode']}")
712
- print(f"Filters: {json.dumps(config['filters'], indent=2)}")
713
-
714
- if args.dry_run:
715
- print("\n🔍 DRY RUN - No output will be written")
716
-
717
- # Run filtering
718
- async def run():
719
- num_examples, stats = await filter_traces_from_turso(
720
- db_url,
721
- args.output if not args.dry_run else "/dev/null",
722
- config
723
- )
724
-
725
- # Print statistics
726
- print_statistics(stats)
727
-
728
- if not args.dry_run:
729
- print(f"\n✅ Successfully wrote {num_examples} training examples to {args.output}")
730
- print(f" Ready for Modal/Synth fine-tuning!")
731
- else:
732
- print(f"\n✅ Would write {num_examples} training examples (dry run)")
733
-
734
- asyncio.run(run())
735
-
736
-
737
- if __name__ == "__main__":
738
- main()