synth-ai 0.2.6.dev1__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 (738) 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/cli/demo_apps/core/cli.py +1735 -0
  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 +117 -51
  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/cli/demo_apps/demo_task_apps/math/_common.py +16 -0
  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} +21 -3
  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 -102
  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.6.dev1.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 -131
  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 -137
  364. synth_ai/cli/status.py +0 -133
  365. synth_ai/config/base_url.py +0 -98
  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/core/cli.py +0 -685
  370. synth_ai/demos/demo_task_apps/__init__.py +0 -1
  371. synth_ai/demos/demo_task_apps/math/config.toml +0 -44
  372. synth_ai/demos/demo_task_apps/math/deploy_task_app.sh +0 -22
  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 -724
  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 -91
  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/http.py +0 -102
  598. synth_ai/inference/client.py +0 -20
  599. synth_ai/install_sqld.sh +0 -40
  600. synth_ai/jobs/client.py +0 -246
  601. synth_ai/learning/__init__.py +0 -24
  602. synth_ai/learning/config.py +0 -43
  603. synth_ai/learning/filtering.py +0 -0
  604. synth_ai/learning/ft_client.py +0 -59
  605. synth_ai/learning/offline/dpo.py +0 -0
  606. synth_ai/learning/offline/providers.py +0 -7
  607. synth_ai/learning/offline/sft.py +0 -0
  608. synth_ai/learning/offline/shared.py +0 -0
  609. synth_ai/learning/online/grpo.py +0 -0
  610. synth_ai/learning/online/irft.py +0 -0
  611. synth_ai/learning/prompts/banking77_injection_eval.py +0 -168
  612. synth_ai/learning/prompts/gepa.py +0 -0
  613. synth_ai/learning/prompts/hello_world_in_context_injection_ex.py +0 -213
  614. synth_ai/learning/prompts/mipro.py +0 -289
  615. synth_ai/learning/prompts/random_search.py +0 -246
  616. synth_ai/learning/prompts/run_mipro_banking77.py +0 -172
  617. synth_ai/learning/prompts/run_random_search_banking77.py +0 -324
  618. synth_ai/learning/sse.py +0 -58
  619. synth_ai/learning/validators.py +0 -48
  620. synth_ai/lm/__init__.py +0 -51
  621. synth_ai/lm/caching/constants.py +0 -6
  622. synth_ai/lm/caching/dbs.py +0 -0
  623. synth_ai/lm/caching/ephemeral.py +0 -102
  624. synth_ai/lm/caching/handler.py +0 -137
  625. synth_ai/lm/caching/initialize.py +0 -11
  626. synth_ai/lm/caching/persistent.py +0 -114
  627. synth_ai/lm/config.py +0 -110
  628. synth_ai/lm/constants.py +0 -32
  629. synth_ai/lm/core/__init__.py +0 -8
  630. synth_ai/lm/core/all.py +0 -73
  631. synth_ai/lm/core/exceptions.py +0 -7
  632. synth_ai/lm/core/main.py +0 -319
  633. synth_ai/lm/core/main_v3.py +0 -594
  634. synth_ai/lm/core/synth_models.py +0 -48
  635. synth_ai/lm/core/vendor_clients.py +0 -188
  636. synth_ai/lm/cost/__init__.py +0 -0
  637. synth_ai/lm/cost/monitor.py +0 -1
  638. synth_ai/lm/cost/statefulness.py +0 -1
  639. synth_ai/lm/injection.py +0 -80
  640. synth_ai/lm/overrides.py +0 -206
  641. synth_ai/lm/provider_support/__init__.py +0 -8
  642. synth_ai/lm/provider_support/anthropic.py +0 -972
  643. synth_ai/lm/provider_support/openai.py +0 -1139
  644. synth_ai/lm/provider_support/suppress_logging.py +0 -31
  645. synth_ai/lm/structured_outputs/__init__.py +0 -0
  646. synth_ai/lm/structured_outputs/handler.py +0 -440
  647. synth_ai/lm/structured_outputs/inject.py +0 -297
  648. synth_ai/lm/structured_outputs/rehabilitate.py +0 -185
  649. synth_ai/lm/tools/__init__.py +0 -3
  650. synth_ai/lm/tools/base.py +0 -172
  651. synth_ai/lm/unified_interface.py +0 -202
  652. synth_ai/lm/vendors/__init__.py +0 -0
  653. synth_ai/lm/vendors/base.py +0 -81
  654. synth_ai/lm/vendors/core/__init__.py +0 -0
  655. synth_ai/lm/vendors/core/anthropic_api.py +0 -387
  656. synth_ai/lm/vendors/core/gemini_api.py +0 -292
  657. synth_ai/lm/vendors/core/mistral_api.py +0 -322
  658. synth_ai/lm/vendors/core/openai_api.py +0 -220
  659. synth_ai/lm/vendors/core/synth_dev_api.py +0 -0
  660. synth_ai/lm/vendors/local/__init__.py +0 -0
  661. synth_ai/lm/vendors/local/ollama.py +0 -0
  662. synth_ai/lm/vendors/openai_standard.py +0 -780
  663. synth_ai/lm/vendors/openai_standard_responses.py +0 -256
  664. synth_ai/lm/vendors/retries.py +0 -22
  665. synth_ai/lm/vendors/supported/__init__.py +0 -0
  666. synth_ai/lm/vendors/supported/custom_endpoint.py +0 -417
  667. synth_ai/lm/vendors/supported/deepseek.py +0 -69
  668. synth_ai/lm/vendors/supported/grok.py +0 -75
  669. synth_ai/lm/vendors/supported/groq.py +0 -16
  670. synth_ai/lm/vendors/supported/ollama.py +0 -15
  671. synth_ai/lm/vendors/supported/openrouter.py +0 -74
  672. synth_ai/lm/vendors/supported/together.py +0 -11
  673. synth_ai/lm/vendors/synth_client.py +0 -808
  674. synth_ai/lm/warmup.py +0 -186
  675. synth_ai/rl/secrets.py +0 -19
  676. synth_ai/scripts/verify_rewards.py +0 -100
  677. synth_ai/task/__init__.py +0 -10
  678. synth_ai/task/contracts.py +0 -120
  679. synth_ai/task/health.py +0 -28
  680. synth_ai/task/validators.py +0 -12
  681. synth_ai/tracing/__init__.py +0 -30
  682. synth_ai/tracing_v1/__init__.py +0 -33
  683. synth_ai/tracing_v3/config.py +0 -84
  684. synth_ai/tracing_v3/storage/config.py +0 -62
  685. synth_ai/tracing_v3/turso/__init__.py +0 -25
  686. synth_ai/tracing_v3/turso/daemon.py +0 -144
  687. synth_ai/tracing_v3/turso/manager.py +0 -760
  688. synth_ai/v0/tracing/__init__.py +0 -0
  689. synth_ai/v0/tracing/abstractions.py +0 -224
  690. synth_ai/v0/tracing/base_client.py +0 -91
  691. synth_ai/v0/tracing/client_manager.py +0 -131
  692. synth_ai/v0/tracing/config.py +0 -140
  693. synth_ai/v0/tracing/context.py +0 -146
  694. synth_ai/v0/tracing/decorators.py +0 -680
  695. synth_ai/v0/tracing/events/__init__.py +0 -0
  696. synth_ai/v0/tracing/events/manage.py +0 -147
  697. synth_ai/v0/tracing/events/scope.py +0 -86
  698. synth_ai/v0/tracing/events/store.py +0 -228
  699. synth_ai/v0/tracing/immediate_client.py +0 -151
  700. synth_ai/v0/tracing/local.py +0 -18
  701. synth_ai/v0/tracing/log_client_base.py +0 -73
  702. synth_ai/v0/tracing/retry_queue.py +0 -186
  703. synth_ai/v0/tracing/trackers.py +0 -515
  704. synth_ai/v0/tracing/upload.py +0 -510
  705. synth_ai/v0/tracing/utils.py +0 -9
  706. synth_ai/v0/tracing_v1/__init__.py +0 -16
  707. synth_ai/v0/tracing_v1/abstractions.py +0 -224
  708. synth_ai/v0/tracing_v1/base_client.py +0 -91
  709. synth_ai/v0/tracing_v1/client_manager.py +0 -131
  710. synth_ai/v0/tracing_v1/config.py +0 -140
  711. synth_ai/v0/tracing_v1/context.py +0 -146
  712. synth_ai/v0/tracing_v1/decorators.py +0 -701
  713. synth_ai/v0/tracing_v1/events/__init__.py +0 -0
  714. synth_ai/v0/tracing_v1/events/manage.py +0 -147
  715. synth_ai/v0/tracing_v1/events/scope.py +0 -86
  716. synth_ai/v0/tracing_v1/events/store.py +0 -228
  717. synth_ai/v0/tracing_v1/immediate_client.py +0 -151
  718. synth_ai/v0/tracing_v1/local.py +0 -18
  719. synth_ai/v0/tracing_v1/log_client_base.py +0 -73
  720. synth_ai/v0/tracing_v1/retry_queue.py +0 -186
  721. synth_ai/v0/tracing_v1/trackers.py +0 -515
  722. synth_ai/v0/tracing_v1/upload.py +0 -525
  723. synth_ai/v0/tracing_v1/utils.py +0 -9
  724. synth_ai/zyk/__init__.py +0 -30
  725. synth_ai-0.2.6.dev1.dist-info/METADATA +0 -106
  726. synth_ai-0.2.6.dev1.dist-info/RECORD +0 -416
  727. /synth_ai/{demos → cli/demo_apps}/demo_task_apps/math/__init__.py +0 -0
  728. /synth_ai/{lm/caching → core/apps}/__init__.py +0 -0
  729. /synth_ai/{tracing_v3 → core/tracing_v3}/lm_call_record_abstractions.py +0 -0
  730. /synth_ai/{tracing_v3 → core/tracing_v3}/storage/__init__.py +0 -0
  731. /synth_ai/{tracing_v3 → core/tracing_v3}/storage/exceptions.py +0 -0
  732. /synth_ai/{tracing_v3 → core/tracing_v3}/storage/types.py +0 -0
  733. /synth_ai/{compound/cais.py → py.typed} +0 -0
  734. /synth_ai/{learning → sdk/learning}/core.py +0 -0
  735. /synth_ai/{learning → sdk/learning}/gateway.py +0 -0
  736. {synth_ai-0.2.6.dev1.dist-info → synth_ai-0.4.3.dist-info}/WHEEL +0 -0
  737. {synth_ai-0.2.6.dev1.dist-info → synth_ai-0.4.3.dist-info}/licenses/LICENSE +0 -0
  738. {synth_ai-0.2.6.dev1.dist-info → synth_ai-0.4.3.dist-info}/top_level.txt +0 -0
@@ -1,984 +0,0 @@
1
- #!/usr/bin/env python3
2
- """
3
- Filter traces to create OpenAI 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
-
9
- import json
10
- import argparse
11
- from pathlib import Path
12
- from typing import List, Dict, Any, Tuple, Optional
13
- from collections import defaultdict
14
- import numpy as np
15
- import os
16
- import sys
17
- import toml
18
-
19
-
20
- def create_histogram(data: List[float], bins: int = 20, width: int = 60, height: int = 15,
21
- title: str = "", x_label: str = "", y_label: str = "") -> str:
22
- """Create a beautiful ASCII histogram."""
23
- if not data:
24
- return "No data to display"
25
-
26
- # Create histogram
27
- counts, edges = np.histogram(data, bins=bins)
28
- max_count = max(counts) if len(counts) > 0 else 1
29
-
30
- # Normalize heights
31
- if max_count > 0:
32
- heights = [int(c * height / max_count) for c in counts]
33
- else:
34
- heights = [0] * len(counts)
35
-
36
- # Build the plot
37
- lines = []
38
-
39
- # Title
40
- if title:
41
- lines.append(f"\n{title.center(width + 10)}")
42
- lines.append("=" * (width + 10))
43
-
44
- # Y-axis label
45
- if y_label:
46
- lines.append(f"{y_label}")
47
-
48
- # Plot area with y-axis
49
- for y in range(height, 0, -1):
50
- # Y-axis value
51
- y_val = int(max_count * y / height)
52
- line = f"{y_val:>6} │"
53
-
54
- # Bars
55
- for h in heights:
56
- if h >= y:
57
- line += "█"
58
- else:
59
- line += " "
60
-
61
- lines.append(line)
62
-
63
- # X-axis
64
- lines.append(f"{'':>6} └" + "─" * len(heights))
65
-
66
- # X-axis labels
67
- x_labels_line = " " * 8
68
- min_val, max_val = min(data), max(data)
69
-
70
- # Add labels at key positions
71
- label_positions = [0, len(heights)//4, len(heights)//2, 3*len(heights)//4, len(heights)-1]
72
- for i, pos in enumerate(label_positions):
73
- if pos < len(edges) - 1:
74
- val = edges[pos]
75
- label = f"{val:.1f}"
76
- # Calculate position
77
- target_pos = 8 + pos
78
- if i == 0:
79
- x_labels_line = label + x_labels_line[len(label):]
80
- elif i == len(label_positions) - 1:
81
- start = max(0, target_pos - len(label))
82
- x_labels_line = x_labels_line[:start] + label
83
- else:
84
- start = max(0, target_pos - len(label)//2)
85
- end = min(len(x_labels_line), start + len(label))
86
- if start < len(x_labels_line):
87
- x_labels_line = x_labels_line[:start] + label[:end-start] + x_labels_line[end:]
88
-
89
- lines.append(x_labels_line)
90
-
91
- # X-axis label
92
- if x_label:
93
- lines.append(f"\n{x_label.center(width + 10)}")
94
-
95
- return "\n".join(lines)
96
-
97
-
98
- def create_bar_chart(categories: List[str], values: List[int], width: int = 60,
99
- title: str = "", show_values: bool = True) -> str:
100
- """Create a horizontal bar chart."""
101
- if not categories:
102
- return "No data to display"
103
-
104
- max_val = max(values) if values else 1
105
- max_label_len = max(len(cat) for cat in categories)
106
-
107
- lines = []
108
-
109
- # Title
110
- if title:
111
- lines.append(f"\n{title}")
112
- lines.append("=" * (width + max_label_len + 15))
113
-
114
- # Bars
115
- for cat, val in zip(categories, values):
116
- bar_width = int(val * width / max_val) if max_val > 0 else 0
117
- bar = "█" * bar_width
118
-
119
- if show_values:
120
- line = f"{cat:<{max_label_len}} │ {bar} {val}"
121
- else:
122
- line = f"{cat:<{max_label_len}} │ {bar}"
123
-
124
- lines.append(line)
125
-
126
- return "\n".join(lines)
127
-
128
-
129
- def display_analysis_results(scores: List[float], achievements_per_trace: Dict[str, List[str]],
130
- window_scores: List[Tuple[str, int, int, float]] = None):
131
- """Display beautiful analysis results."""
132
- # Don't clear screen in analyze mode
133
- # os.system('clear' if os.name == 'posix' else 'cls')
134
-
135
- print("\n" + "╔" + "═" * 78 + "╗")
136
- print("║" + " CRAFTER TRACE ANALYSIS RESULTS ".center(78) + "║")
137
- print("╚" + "═" * 78 + "╝")
138
-
139
- # 1. Trajectory Score Distribution
140
- # For discrete scores, create custom histogram
141
- if scores:
142
- score_counts = {}
143
- for s in scores:
144
- score_counts[int(s)] = score_counts.get(int(s), 0) + 1
145
-
146
- # Create bar chart for scores
147
- max_score = int(max(scores))
148
- max_count = max(score_counts.values())
149
-
150
- print("\n" + "📊 Trajectory Score Distribution".center(70))
151
- print("=" * 70)
152
- print("Traces")
153
-
154
- # Y-axis scale
155
- for y in range(max_count, 0, -max(1, max_count // 10)):
156
- line = f"{y:>6} │"
157
- for score in range(max_score + 1):
158
- count = score_counts.get(score, 0)
159
- # Each score gets 10 characters width
160
- bar_height = int(count * 10 / max_count) if max_count > 0 else 0
161
- if count >= y:
162
- line += " ████████ "
163
- else:
164
- line += " "
165
- print(line)
166
-
167
- # X-axis
168
- print(f"{'':>6} └" + "─" * (10 * (max_score + 1)))
169
-
170
- # X-axis labels
171
- x_labels = " "
172
- for score in range(max_score + 1):
173
- x_labels += f" {score} "
174
- print(x_labels)
175
- print("\n" + "Number of Achievements (Score)".center(70))
176
-
177
- # Statistics box
178
- print("\n┌─ Statistics ─────────────────────────┐")
179
- print(f"│ Total traces: {len(scores):<23}│")
180
- print(f"│ Mean score: {np.mean(scores):<25.2f}│")
181
- print(f"│ Median score: {np.median(scores):<23.1f}│")
182
- print(f"│ Max score: {max(scores):<26.0f}│")
183
- print(f"│ Traces with score > 0: {sum(1 for s in scores if s > 0):<14}│")
184
- print("└──────────────────────────────────────┘")
185
-
186
- # 2. Achievement Distribution
187
- all_achievements = []
188
- for achievements in achievements_per_trace.values():
189
- all_achievements.extend(achievements)
190
-
191
- from collections import Counter
192
- achievement_counts = Counter(all_achievements)
193
-
194
- if achievement_counts:
195
- top_achievements = achievement_counts.most_common(10)
196
- categories = [ach for ach, _ in top_achievements]
197
- values = [count for _, count in top_achievements]
198
-
199
- print("\n" + create_bar_chart(
200
- categories,
201
- values,
202
- width=40,
203
- title="🏆 Top 10 Achievements Unlocked",
204
- show_values=True
205
- ))
206
-
207
- # 3. Window Analysis (if provided)
208
- if window_scores:
209
- window_score_values = [score for _, _, _, score in window_scores]
210
- unique_window_scores = sorted(set(window_score_values))
211
-
212
- print("\n┌─ Window Analysis ────────────────────┐")
213
- print(f"│ Total windows analyzed: {len(window_scores):<13}│")
214
- print(f"│ Windows with score > 0: {sum(1 for s in window_score_values if s > 0):<13}│")
215
- print(f"│ Unique score values: {unique_window_scores}".ljust(39) + "│")
216
- print("└──────────────────────────────────────┘")
217
-
218
- # 4. Filtering Recommendations
219
- print("\n" + "╔" + "═" * 78 + "╗")
220
- print("║" + " FILTERING RECOMMENDATIONS ".center(78) + "║")
221
- print("╚" + "═" * 78 + "╝")
222
-
223
- score_thresholds = [1, 2, 3]
224
- print("\n┌─ Trajectory Filtering ───────────────┐")
225
- for threshold in score_thresholds:
226
- count = sum(1 for s in scores if s >= threshold)
227
- pct = count / len(scores) * 100 if scores else 0
228
- print(f"│ Score ≥ {threshold}: {count:>3} traces ({pct:>5.1f}%) │")
229
- print("└──────────────────────────────────────┘")
230
-
231
- if window_scores:
232
- print("\n┌─ Window Filtering ───────────────────┐")
233
- window_thresholds = [1, 2]
234
- for threshold in window_thresholds:
235
- count = sum(1 for s in window_score_values if s >= threshold)
236
- pct = count / len(window_scores) * 100 if window_scores else 0
237
- print(f"│ Score ≥ {threshold}: {count:>3} windows ({pct:>5.1f}%) │")
238
- print("└──────────────────────────────────────┘")
239
-
240
-
241
- def load_trace(trace_file: Path) -> Dict[str, Any]:
242
- """Load a trace file."""
243
- with open(trace_file, 'r') as f:
244
- return json.load(f)
245
-
246
-
247
- def extract_trajectory_score(trace: Dict[str, Any]) -> float:
248
- """Extract the trajectory score from a trace."""
249
- # Look for episode results in metadata
250
- metadata = trace.get('session_metadata', [])
251
-
252
- # Handle list format with metadata_type
253
- if isinstance(metadata, list):
254
- # Find episode_results in the list
255
- for item in metadata:
256
- if isinstance(item, dict) and item.get('metadata_type') == 'episode_results':
257
- episode_results = item.get('data', {})
258
- break
259
- else:
260
- episode_results = {}
261
- else:
262
- episode_results = metadata.get('episode_results', {})
263
-
264
- # Use number of achievements as the primary score
265
- num_achievements = episode_results.get('num_achievements', 0)
266
-
267
- # Could also use shaped reward if available
268
- # total_reward = episode_results.get('total_reward', 0)
269
-
270
- return float(num_achievements)
271
-
272
-
273
- def extract_llm_calls(trace: Dict[str, Any], hook_config: Optional[Dict[str, Any]] = None) -> List[Tuple[int, Dict[str, Any], Dict[str, Any]]]:
274
- """Extract all LLM calls from a trace with their turn numbers and event metadata.
275
-
276
- Returns list of (turn_number, llm_record, event) tuples.
277
- """
278
- llm_calls = []
279
-
280
- # Get events that contain LLM calls
281
- events = trace.get('event_history', [])
282
-
283
- exclude_hooks = hook_config.get('exclude_hooks', []) if hook_config else []
284
- include_hooks = hook_config.get('include_hooks', []) if hook_config else []
285
-
286
- for event in events:
287
- # Look for CAISEvents from the agent
288
- if event.get('system_instance_id', '').startswith('crafter-react-agent'):
289
- # Check hook filtering
290
- event_hooks = event.get('hooks_triggered', [])
291
-
292
- # Skip if any exclude hooks were triggered
293
- if exclude_hooks and any(hook in event_hooks for hook in exclude_hooks):
294
- continue
295
-
296
- # Skip if include_hooks specified but none were triggered
297
- if include_hooks and not any(hook in event_hooks for hook in include_hooks):
298
- continue
299
-
300
- # Get the LLM call records
301
- llm_records = event.get('llm_call_records', [])
302
- turn = event.get('time_record', {}).get('message_time', 0)
303
-
304
- for record in llm_records:
305
- if record:
306
- llm_calls.append((turn, record, event))
307
-
308
- return llm_calls
309
-
310
-
311
- def calculate_window_score(trace: Dict[str, Any], start_turn: int, end_turn: int) -> float:
312
- """Calculate score for a window of turns."""
313
- # Count achievements unlocked in this window
314
- achievements_before = set()
315
- achievements_after = set()
316
-
317
- # Get messages to track achievement changes
318
- messages = trace.get('message_history', [])
319
-
320
- for message in messages:
321
- turn = message.get('time_record', {}).get('message_time', -1)
322
- if message.get('message_type') == 'observation':
323
- obs = message.get('content', {}).get('payload', {})
324
- achievements = obs.get('achievements_status', {})
325
-
326
- if turn == start_turn - 1:
327
- # Achievements before window
328
- achievements_before = {k for k, v in achievements.items() if v}
329
- elif turn == end_turn:
330
- # Achievements after window
331
- achievements_after = {k for k, v in achievements.items() if v}
332
-
333
- # Score is number of new achievements unlocked in window
334
- new_achievements = achievements_after - achievements_before
335
- return len(new_achievements)
336
-
337
-
338
- def convert_to_openai_format(llm_call: Dict[str, Any], quality_config: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
339
- """Convert an LLM call record to OpenAI fine-tuning format with quality filtering."""
340
- # Extract messages
341
- messages = llm_call.get('messages', [])
342
-
343
- # Extract the completion (assistant's response)
344
- response = llm_call.get('response', {})
345
- choices = response.get('choices', [])
346
-
347
- if choices:
348
- assistant_message = choices[0].get('message', {})
349
- content = assistant_message.get('content', '')
350
-
351
- # Apply quality filters if provided
352
- if quality_config:
353
- # Check minimum response length
354
- min_length = quality_config.get('min_response_length', 0)
355
- if content and len(content) < min_length:
356
- return None
357
- elif not content and min_length > 0:
358
- return None
359
-
360
- # Check if tool calls required
361
- require_tools = quality_config.get('require_tool_calls', False)
362
- tool_calls = assistant_message.get('tool_calls', [])
363
- if require_tools and not tool_calls:
364
- return None
365
-
366
- # Check excluded keywords
367
- exclude_keywords = quality_config.get('exclude_keywords', [])
368
- if content and exclude_keywords and any(keyword.lower() in content.lower() for keyword in exclude_keywords):
369
- return None
370
-
371
- # Build the completion message
372
- completion = {
373
- "role": "assistant",
374
- "content": content,
375
- }
376
-
377
- # Add tool calls if present
378
- tool_calls = assistant_message.get('tool_calls', [])
379
- if tool_calls:
380
- completion["tool_calls"] = tool_calls
381
-
382
- # Create the training example
383
- return {
384
- "messages": messages + [completion]
385
- }
386
-
387
- return None
388
-
389
-
390
- def filter_by_trajectory_score(traces_dir: Path, output_file: Path, config: Dict[str, Any]):
391
- """Filter entire trajectories by score threshold with hook and quality filtering."""
392
- examples = []
393
- trace_scores = []
394
- included_count = 0
395
- hook_filtered_count = 0
396
- quality_filtered_count = 0
397
- trace_contributions = {} # Track which traces contributed examples
398
- included_trace_scores = {} # Track scores of included traces
399
-
400
- score_threshold = config.get('trajectory_filtering', {}).get('score_threshold', 2.0)
401
- hook_config = config.get('hook_filtering', {})
402
- quality_config = config.get('quality_filtering', {})
403
-
404
- # Process all trace files
405
- trace_files = sorted(traces_dir.glob("*.json"))
406
- print(f"Processing {len(trace_files)} trace files...")
407
-
408
- for trace_file in trace_files:
409
- trace = load_trace(trace_file)
410
- score = extract_trajectory_score(trace)
411
- trace_scores.append((trace_file.name, score))
412
-
413
- if score >= score_threshold:
414
- # Extract all LLM calls from this trajectory
415
- llm_calls = extract_llm_calls(trace, hook_config)
416
- initial_count = len(llm_calls)
417
-
418
- trajectory_examples = []
419
- for turn, llm_call, event in llm_calls:
420
- example = convert_to_openai_format(llm_call, quality_config)
421
- if example:
422
- trajectory_examples.append(example)
423
- else:
424
- quality_filtered_count += 1
425
-
426
- if trajectory_examples:
427
- trace_contributions[trace_file.name] = len(trajectory_examples)
428
- included_trace_scores[trace_file.name] = score
429
-
430
- hook_filtered_count += initial_count - len(llm_calls)
431
- examples.extend(trajectory_examples)
432
- included_count += 1
433
-
434
- # Save examples
435
- with open(output_file, 'w') as f:
436
- for example in examples:
437
- f.write(json.dumps(example) + '\n')
438
-
439
- print(f"\n✓ Included {included_count}/{len(trace_files)} traces (score ≥ {score_threshold})")
440
- if hook_filtered_count > 0:
441
- print(f"✓ Filtered out {hook_filtered_count} events due to hook exclusions")
442
- if quality_filtered_count > 0:
443
- print(f"✓ Filtered out {quality_filtered_count} events due to quality filters")
444
- print(f"✓ Extracted {len(examples)} training examples from {len(trace_contributions)} unique traces")
445
-
446
- return trace_contributions, included_trace_scores
447
-
448
-
449
- def filter_by_window_score(traces_dir: Path, output_file: Path, config: Dict[str, Any]):
450
- """Filter by sliding window with greedy extraction and hook/quality filtering."""
451
- all_examples = []
452
- window_stats = defaultdict(int)
453
- traces_with_windows = 0
454
- hook_filtered_count = 0
455
- quality_filtered_count = 0
456
- trace_contributions = {} # Track which traces contributed examples
457
- window_scores_by_trace = defaultdict(list) # Track window scores per trace
458
- trace_overall_scores = {} # Track overall trace scores
459
-
460
- window_config = config.get('window_filtering', {})
461
- window_size = window_config.get('window_size', 5)
462
- score_threshold = window_config.get('score_threshold', 1.0)
463
- hook_config = config.get('hook_filtering', {})
464
- quality_config = config.get('quality_filtering', {})
465
-
466
- # Process all trace files
467
- trace_files = sorted(traces_dir.glob("*.json"))
468
- print(f"Processing {len(trace_files)} trace files with window_size={window_size}...")
469
-
470
- for trace_file in trace_files:
471
- trace = load_trace(trace_file)
472
- trace_score = extract_trajectory_score(trace) # Get overall trace score
473
- llm_calls = extract_llm_calls(trace, hook_config)
474
-
475
- if not llm_calls:
476
- continue
477
-
478
- # Extract examples using greedy window approach
479
- examples = []
480
- used_turns = set()
481
- found_window = False
482
- trace_window_count = 0
483
-
484
- # Get max turn number
485
- max_turn = max(turn for turn, _, _ in llm_calls)
486
-
487
- # Try all possible windows
488
- for start in range(0, max_turn - window_size + 2):
489
- end = start + window_size - 1
490
-
491
- # Skip if any turn in window already used
492
- if any(t in used_turns for t in range(start, end + 1)):
493
- continue
494
-
495
- # Calculate window score
496
- score = calculate_window_score(trace, start, end)
497
-
498
- if score >= score_threshold:
499
- # Extract LLM calls from this window
500
- window_examples = []
501
- for turn, llm_call, event in llm_calls:
502
- if start <= turn <= end:
503
- example = convert_to_openai_format(llm_call, quality_config)
504
- if example:
505
- window_examples.append(example)
506
- else:
507
- quality_filtered_count += 1
508
-
509
- if window_examples:
510
- examples.extend(window_examples)
511
- trace_window_count += len(window_examples)
512
- window_scores_by_trace[trace_file.name].append(score)
513
- # Mark all turns in window as used
514
- for t in range(start, end + 1):
515
- used_turns.add(t)
516
-
517
- window_stats[score] += 1
518
- found_window = True
519
-
520
- if found_window:
521
- traces_with_windows += 1
522
- trace_contributions[trace_file.name] = trace_window_count
523
- trace_overall_scores[trace_file.name] = trace_score
524
-
525
- all_examples.extend(examples)
526
-
527
- # Save examples
528
- with open(output_file, 'w') as f:
529
- for example in all_examples:
530
- f.write(json.dumps(example) + '\n')
531
-
532
- total_windows = sum(window_stats.values())
533
- print(f"\n✓ Found qualifying windows in {traces_with_windows}/{len(trace_files)} traces")
534
- print(f"✓ Extracted {total_windows} windows (score ≥ {score_threshold})")
535
- if hook_filtered_count > 0:
536
- print(f"✓ Filtered out {hook_filtered_count} events due to hook exclusions")
537
- if quality_filtered_count > 0:
538
- print(f"✓ Filtered out {quality_filtered_count} events due to quality filters")
539
- print(f"✓ Generated {len(all_examples)} training examples from {len(trace_contributions)} unique traces")
540
-
541
- return trace_contributions, window_scores_by_trace, trace_overall_scores
542
-
543
-
544
- def analyze_traces(traces_dir: Path, analyze_windows: bool = True, hook_config: Optional[Dict[str, Any]] = None):
545
- """Analyze traces to help choose thresholds."""
546
- scores = []
547
- achievements_per_trace = {}
548
- window_scores = []
549
-
550
- trace_files = sorted(traces_dir.glob("*.json"))
551
-
552
- print(f"Analyzing {len(trace_files)} trace files...")
553
-
554
- for trace_file in trace_files:
555
- trace = load_trace(trace_file)
556
- score = extract_trajectory_score(trace)
557
- scores.append(score)
558
-
559
- # Get achievement details
560
- metadata = trace.get('session_metadata', [])
561
-
562
- # Handle list format with metadata_type
563
- if isinstance(metadata, list):
564
- for item in metadata:
565
- if isinstance(item, dict) and item.get('metadata_type') == 'episode_results':
566
- episode_results = item.get('data', {})
567
- break
568
- else:
569
- episode_results = {}
570
- else:
571
- episode_results = metadata.get('episode_results', {})
572
-
573
- achievements = episode_results.get('achievements', {})
574
- unlocked = [k for k, v in achievements.items() if v]
575
- achievements_per_trace[trace_file.name] = unlocked
576
-
577
- # Analyze windows if requested
578
- if analyze_windows:
579
- llm_calls = extract_llm_calls(trace, hook_config)
580
- if llm_calls:
581
- max_turn = max(turn for turn, _, _ in llm_calls)
582
- # Check all possible 5-turn windows
583
- for start in range(0, max_turn - 4):
584
- end = start + 4 # 5-turn window
585
- window_score = calculate_window_score(trace, start, end)
586
- if window_score > 0: # Only track windows with achievements
587
- window_scores.append((trace_file.name, start, end, window_score))
588
-
589
- # Display results
590
- display_analysis_results(scores, achievements_per_trace, window_scores if analyze_windows else None)
591
-
592
-
593
- def main():
594
- parser = argparse.ArgumentParser(description="Filter traces for SFT data")
595
- parser.add_argument("traces_dir", type=Path, help="Directory containing trace files")
596
- parser.add_argument("--config", type=Path, default=None,
597
- help="Path to TOML configuration file")
598
- parser.add_argument("--analyze", action="store_true", help="Analyze traces to help choose thresholds")
599
- parser.add_argument("--interactive", "-i", action="store_true", help="Interactive mode for choosing thresholds")
600
-
601
- # Trajectory filtering options
602
- parser.add_argument("--trajectory-threshold", type=float, default=None,
603
- help="Minimum trajectory score for inclusion")
604
-
605
- # Window filtering options
606
- parser.add_argument("--window-size", type=int, default=None,
607
- help="Window size for window-based filtering")
608
- parser.add_argument("--window-threshold", type=float, default=None,
609
- help="Minimum window score for inclusion")
610
-
611
- args = parser.parse_args()
612
-
613
- # Load configuration
614
- config = {}
615
- if args.config and args.config.exists():
616
- config = toml.load(args.config)
617
- print(f"Loaded configuration from {args.config}")
618
- else:
619
- # Look for default config in same directory as traces
620
- default_config = args.traces_dir.parent / "filter_config.toml"
621
- if default_config.exists():
622
- config = toml.load(default_config)
623
- print(f"Loaded configuration from {default_config}")
624
-
625
- # Override config with command line arguments
626
- if args.trajectory_threshold is not None:
627
- config.setdefault('trajectory_filtering', {})['score_threshold'] = args.trajectory_threshold
628
- if args.window_size is not None:
629
- config.setdefault('window_filtering', {})['window_size'] = args.window_size
630
- if args.window_threshold is not None:
631
- config.setdefault('window_filtering', {})['score_threshold'] = args.window_threshold
632
-
633
- if not args.traces_dir.exists():
634
- print(f"Error: Traces directory not found: {args.traces_dir}")
635
- return
636
-
637
- if args.analyze:
638
- hook_config = config.get('hook_filtering', {})
639
- analyze_traces(args.traces_dir, hook_config=hook_config)
640
- return
641
-
642
- # Interactive mode or direct filtering
643
- traj_threshold = config.get('trajectory_filtering', {}).get('score_threshold')
644
- window_threshold = config.get('window_filtering', {}).get('score_threshold')
645
-
646
- if args.interactive or (traj_threshold is None and window_threshold is None):
647
- # First show analysis
648
- hook_config = config.get('hook_filtering', {})
649
- analyze_traces(args.traces_dir, hook_config=hook_config)
650
-
651
- print("\n" + "╔" + "═" * 78 + "╗")
652
- print("║" + " INTERACTIVE THRESHOLD SELECTION ".center(78) + "║")
653
- print("╚" + "═" * 78 + "╝")
654
-
655
- # Get thresholds interactively
656
- print("\nBased on the analysis above, please choose filtering thresholds:")
657
-
658
- if traj_threshold is None:
659
- while True:
660
- try:
661
- traj_input = input("\n📊 Trajectory score threshold (e.g., 2.0): ")
662
- traj_threshold = float(traj_input)
663
- config.setdefault('trajectory_filtering', {})['score_threshold'] = traj_threshold
664
- break
665
- except ValueError:
666
- print("Please enter a valid number.")
667
-
668
- if window_threshold is None:
669
- while True:
670
- try:
671
- window_input = input("📊 Window score threshold (e.g., 1.0): ")
672
- window_threshold = float(window_input)
673
- config.setdefault('window_filtering', {})['score_threshold'] = window_threshold
674
- break
675
- except ValueError:
676
- print("Please enter a valid number.")
677
-
678
- print(f"\nYou selected:")
679
- print(f" • Trajectory threshold: {traj_threshold}")
680
- print(f" • Window threshold: {window_threshold}")
681
-
682
- # Get custom filenames
683
- print(f"\nOutput file names:")
684
- traj_filename = input("📁 Trajectory output filename (default: trajectory_score.jsonl): ").strip()
685
- if not traj_filename:
686
- traj_filename = "trajectory_score.jsonl"
687
- elif not traj_filename.endswith('.jsonl'):
688
- traj_filename += '.jsonl'
689
-
690
- window_filename = input("📁 Window output filename (default: window_score.jsonl): ").strip()
691
- if not window_filename:
692
- window_filename = "window_score.jsonl"
693
- elif not window_filename.endswith('.jsonl'):
694
- window_filename += '.jsonl'
695
-
696
- # Store filenames in config for later use
697
- config.setdefault('output', {})['trajectory_file'] = traj_filename
698
- config.setdefault('output', {})['window_file'] = window_filename
699
-
700
- print(f"\nFiles will be saved as:")
701
- print(f" • Trajectory data: {traj_filename}")
702
- print(f" • Window data: {window_filename}")
703
-
704
- confirm = input("\nProceed with filtering? (y/n): ")
705
- if confirm.lower() != 'y':
706
- print("Filtering cancelled.")
707
- return
708
-
709
- # Ensure we have defaults if still None
710
- if traj_threshold is None:
711
- config.setdefault('trajectory_filtering', {})['score_threshold'] = 2.0
712
- if window_threshold is None:
713
- config.setdefault('window_filtering', {})['score_threshold'] = 1.0
714
-
715
- # Show configuration summary if hook or quality filtering enabled
716
- hook_config = config.get('hook_filtering', {})
717
- quality_config = config.get('quality_filtering', {})
718
-
719
- if hook_config.get('exclude_hooks') or hook_config.get('include_hooks') or quality_config:
720
- print("\n" + "Configuration Summary".center(50))
721
- print("=" * 50)
722
-
723
- if hook_config.get('exclude_hooks'):
724
- print(f"Excluding events with hooks: {hook_config['exclude_hooks']}")
725
- if hook_config.get('include_hooks'):
726
- print(f"Including only events with hooks: {hook_config['include_hooks']}")
727
-
728
- if quality_config.get('min_response_length'):
729
- print(f"Min response length: {quality_config['min_response_length']}")
730
- if quality_config.get('require_tool_calls'):
731
- print("Requiring tool calls in responses")
732
- if quality_config.get('exclude_keywords'):
733
- print(f"Excluding keywords: {quality_config['exclude_keywords']}")
734
-
735
- # Create ft_dataset directory
736
- # Get the agent_demos directory (where this script is located)
737
- script_dir = Path(__file__).parent
738
- ft_dataset_dir = script_dir / "ft_dataset"
739
- ft_dataset_dir.mkdir(exist_ok=True)
740
-
741
- # Get output file names from config
742
- output_config = config.get('output', {})
743
- traj_filename = output_config.get('trajectory_file', 'trajectory_score.jsonl')
744
- window_filename = output_config.get('window_file', 'window_score.jsonl')
745
-
746
- # Run both filtering methods
747
- print("\nRunning trajectory-based filtering...")
748
- print("=" * 50)
749
- traj_contributions, traj_trace_scores = filter_by_trajectory_score(
750
- args.traces_dir,
751
- ft_dataset_dir / traj_filename,
752
- config
753
- )
754
-
755
- print("\n\nRunning window-based filtering...")
756
- print("=" * 50)
757
- window_contributions, window_scores_by_trace, window_trace_scores = filter_by_window_score(
758
- args.traces_dir,
759
- ft_dataset_dir / window_filename,
760
- config
761
- )
762
-
763
- # Compare results
764
- traj_file = ft_dataset_dir / "trajectory_score.jsonl"
765
- window_file = ft_dataset_dir / "window_score.jsonl"
766
-
767
- if traj_file.exists() and window_file.exists():
768
- traj_count = sum(1 for _ in open(traj_file))
769
- window_count = sum(1 for _ in open(window_file))
770
-
771
- # Calculate yield rates
772
- total_traces = len(list(args.traces_dir.glob("*.json")))
773
-
774
- # For trajectory: count traces above threshold
775
- traj_threshold = config.get('trajectory_filtering', {}).get('score_threshold', 2.0)
776
- included_traces = 0
777
- for trace_file in args.traces_dir.glob("*.json"):
778
- trace = load_trace(trace_file)
779
- score = extract_trajectory_score(trace)
780
- if score >= traj_threshold:
781
- included_traces += 1
782
-
783
- traj_yield = (included_traces / total_traces * 100) if total_traces > 0 else 0
784
-
785
- # For windows: count traces with qualifying windows
786
- window_size = config.get('window_filtering', {}).get('window_size', 5)
787
- window_threshold = config.get('window_filtering', {}).get('score_threshold', 1.0)
788
- hook_config = config.get('hook_filtering', {})
789
-
790
- traces_with_windows = 0
791
- for trace_file in args.traces_dir.glob("*.json"):
792
- trace = load_trace(trace_file)
793
- llm_calls = extract_llm_calls(trace, hook_config)
794
- if llm_calls:
795
- max_turn = max(turn for turn, _, _ in llm_calls)
796
- for start in range(0, max_turn - window_size + 2):
797
- end = start + window_size - 1
798
- score = calculate_window_score(trace, start, end)
799
- if score >= window_threshold:
800
- traces_with_windows += 1
801
- break
802
-
803
- window_yield = (traces_with_windows / total_traces * 100) if total_traces > 0 else 0
804
-
805
- print("\n\nComparison:")
806
- print("=" * 50)
807
- print(f"Trajectory-based: {traj_count} examples ({traj_yield:.1f}% of traces)")
808
-
809
- # Show trajectory contribution distribution
810
- if traj_contributions:
811
- traj_unique_count = len(traj_contributions)
812
- print(f" └─ From {traj_unique_count} unique traces")
813
-
814
- # Show distribution of examples per trace
815
- example_counts = list(traj_contributions.values())
816
- if example_counts:
817
- avg_examples = sum(example_counts) / len(example_counts)
818
- min_examples = min(example_counts)
819
- max_examples = max(example_counts)
820
- print(f" └─ Examples per trace: min={min_examples}, avg={avg_examples:.1f}, max={max_examples}")
821
-
822
- # Show trace score distribution for included traces
823
- if traj_trace_scores:
824
- trace_score_counts = {}
825
- for score in traj_trace_scores.values():
826
- score_int = int(score)
827
- trace_score_counts[score_int] = trace_score_counts.get(score_int, 0) + 1
828
-
829
- print(" └─ Trace score distribution:")
830
- for score in sorted(trace_score_counts.keys()):
831
- count = trace_score_counts[score]
832
- print(f" Score {score}: {count} traces")
833
-
834
- print(f"\nWindow-based: {window_count} examples ({window_yield:.1f}% of traces)")
835
-
836
- # Show window contribution distribution
837
- if window_contributions:
838
- window_unique_count = len(window_contributions)
839
- print(f" └─ From {window_unique_count} unique traces")
840
-
841
- # Show distribution of examples per trace
842
- example_counts = list(window_contributions.values())
843
- if example_counts:
844
- avg_examples = sum(example_counts) / len(example_counts)
845
- min_examples = min(example_counts)
846
- max_examples = max(example_counts)
847
- print(f" └─ Examples per trace: min={min_examples}, avg={avg_examples:.1f}, max={max_examples}")
848
-
849
- # Show trace score distribution for traces with windows
850
- if window_trace_scores:
851
- trace_score_counts = {}
852
- for score in window_trace_scores.values():
853
- score_int = int(score)
854
- trace_score_counts[score_int] = trace_score_counts.get(score_int, 0) + 1
855
-
856
- print(" └─ Trace score distribution:")
857
- for score in sorted(trace_score_counts.keys()):
858
- count = trace_score_counts[score]
859
- print(f" Score {score}: {count} traces")
860
-
861
- # Show window score distribution
862
- all_window_scores = []
863
- for scores in window_scores_by_trace.values():
864
- all_window_scores.extend(scores)
865
-
866
- if all_window_scores:
867
- score_counts = {}
868
- for score in all_window_scores:
869
- score_counts[int(score)] = score_counts.get(int(score), 0) + 1
870
-
871
- print(" └─ Window score distribution:")
872
- for score in sorted(score_counts.keys()):
873
- count = score_counts[score]
874
- print(f" Score {score}: {count} windows")
875
-
876
- print(f"\nOutput files saved to: {ft_dataset_dir}/")
877
-
878
- # Generate metadata
879
- print("\nGenerating metadata...")
880
- generate_metadata(args.traces_dir, ft_dataset_dir, config)
881
-
882
-
883
- def generate_metadata(traces_dir: Path, output_dir: Path, config: Dict[str, Any]):
884
- """Generate comprehensive metadata for the filtered datasets."""
885
- metadata = {
886
- "dataset_creation": {
887
- "source_traces_dir": traces_dir.name,
888
- "num_source_traces": len(list(traces_dir.glob("*.json"))),
889
- "filtering_methods": ["trajectory_score", "window_score"],
890
- "config_used": config
891
- }
892
- }
893
-
894
- traj_threshold = config.get('trajectory_filtering', {}).get('score_threshold', 2.0)
895
- window_threshold = config.get('window_filtering', {}).get('score_threshold', 1.0)
896
- window_size = config.get('window_filtering', {}).get('window_size', 5)
897
- hook_config = config.get('hook_filtering', {})
898
- quality_config = config.get('quality_filtering', {})
899
-
900
- # Analyze trajectory filtering
901
- traj_file = output_dir / "trajectory_score.jsonl"
902
- if traj_file.exists():
903
- traj_examples = sum(1 for _ in open(traj_file))
904
-
905
- # Count included traces
906
- included_traces = set()
907
- trace_scores = {}
908
- achievements_by_trace = {}
909
-
910
- for trace_file in traces_dir.glob("*.json"):
911
- trace = load_trace(trace_file)
912
- score = extract_trajectory_score(trace)
913
- trace_scores[trace_file.name] = score
914
-
915
- if score >= traj_threshold:
916
- included_traces.add(trace_file.name)
917
- # Get achievements
918
- metadata_list = trace.get('session_metadata', [])
919
- if isinstance(metadata_list, list):
920
- for item in metadata_list:
921
- if isinstance(item, dict) and item.get('metadata_type') == 'episode_results':
922
- episode_results = item.get('data', {})
923
- break
924
- else:
925
- episode_results = {}
926
- else:
927
- episode_results = metadata_list.get('episode_results', {})
928
-
929
- achievements = episode_results.get('achievements', {})
930
- unlocked = [k for k, v in achievements.items() if v]
931
- achievements_by_trace[trace_file.name] = unlocked
932
-
933
- metadata["trajectory_filtering"] = {
934
- "threshold": traj_threshold,
935
- "total_traces": len(trace_scores),
936
- "included_traces": len(included_traces),
937
- "excluded_traces": len(trace_scores) - len(included_traces),
938
- "yield_rate": (len(included_traces) / len(trace_scores) * 100) if trace_scores else 0,
939
- "total_examples": traj_examples,
940
- "avg_examples_per_trace": traj_examples / len(included_traces) if included_traces else 0
941
- }
942
-
943
- # Analyze window filtering
944
- window_file = output_dir / "window_score.jsonl"
945
- if window_file.exists():
946
- window_examples = sum(1 for _ in open(window_file))
947
-
948
- # Count traces with qualifying windows
949
- traces_with_windows = set()
950
- window_count = 0
951
-
952
- for trace_file in traces_dir.glob("*.json"):
953
- trace = load_trace(trace_file)
954
- llm_calls = extract_llm_calls(trace, hook_config)
955
-
956
- if llm_calls:
957
- max_turn = max(turn for turn, _, _ in llm_calls)
958
- for start in range(0, max_turn - window_size + 2):
959
- end = start + window_size - 1
960
- score = calculate_window_score(trace, start, end)
961
- if score >= window_threshold:
962
- traces_with_windows.add(trace_file.name)
963
- window_count += 1
964
-
965
- metadata["window_filtering"] = {
966
- "window_size": window_size,
967
- "threshold": window_threshold,
968
- "total_traces": len(list(traces_dir.glob("*.json"))),
969
- "traces_with_qualifying_windows": len(traces_with_windows),
970
- "total_windows_extracted": window_count,
971
- "total_examples": window_examples,
972
- "avg_examples_per_window": window_size
973
- }
974
-
975
- # Save metadata
976
- metadata_file = config.get('output', {}).get('metadata_file', 'metadata.json')
977
- with open(output_dir / metadata_file, 'w') as f:
978
- json.dump(metadata, f, indent=2)
979
-
980
- print(f"✓ Metadata saved to {output_dir}/{metadata_file}")
981
-
982
-
983
- if __name__ == "__main__":
984
- main()