openforma 0.4.0__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 (288) hide show
  1. forma_cli/__init__.py +5 -0
  2. forma_cli/app.py +1139 -0
  3. forma_cli/config.py +112 -0
  4. forma_cli/credentials.py +141 -0
  5. forma_cli/local.py +562 -0
  6. forma_cli/metadata_api.py +138 -0
  7. forma_cli/project_artifacts.py +182 -0
  8. forma_cli/sdk.py +571 -0
  9. forma_core/__init__.py +9 -0
  10. forma_core/__main__.py +4 -0
  11. forma_core/_version.py +3 -0
  12. forma_core/agents/__init__.py +50 -0
  13. forma_core/agents/clarification.py +194 -0
  14. forma_core/agents/component_reconciliation.py +99 -0
  15. forma_core/agents/context_gathering.py +115 -0
  16. forma_core/agents/continuous.py +537 -0
  17. forma_core/agents/contracts.py +247 -0
  18. forma_core/agents/firecrawl_mcp.py +484 -0
  19. forma_core/agents/lattice.py +239 -0
  20. forma_core/agents/orchestrator.py +3724 -0
  21. forma_core/agents/pipeline.py +843 -0
  22. forma_core/agents/project_correction.py +83 -0
  23. forma_core/agents/prompt_compaction.py +428 -0
  24. forma_core/agents/system_architecture.py +345 -0
  25. forma_core/agents/video_correction.py +119 -0
  26. forma_core/agents/web_research_workflow.py +1256 -0
  27. forma_core/agents/workflows.py +176 -0
  28. forma_core/assets/__init__.py +1 -0
  29. forma_core/assets/models.py +156 -0
  30. forma_core/assets/project.py +17 -0
  31. forma_core/assets/repository.py +48 -0
  32. forma_core/assets/service.py +142 -0
  33. forma_core/assets/validation.py +35 -0
  34. forma_core/benchmarks/__init__.py +5 -0
  35. forma_core/benchmarks/ir_triad_v1.py +477 -0
  36. forma_core/biology/__init__.py +28 -0
  37. forma_core/biology/benchmark.py +80 -0
  38. forma_core/biology/ewart_liverchip.py +279 -0
  39. forma_core/biology/ir.py +25 -0
  40. forma_core/biology/liverbench.py +416 -0
  41. forma_core/biology/liverbench_assay.py +251 -0
  42. forma_core/biology/liverbench_baselines.py +133 -0
  43. forma_core/biology/liverbench_independent.py +229 -0
  44. forma_core/biology/liverchip_demo.py +154 -0
  45. forma_core/biology/liverchip_evidence.py +149 -0
  46. forma_core/biology/models.py +247 -0
  47. forma_core/biology/validation.py +72 -0
  48. forma_core/cad_migrations/__init__.py +6 -0
  49. forma_core/cad_migrations/cli.py +101 -0
  50. forma_core/cad_migrations/emitters.py +227 -0
  51. forma_core/cad_migrations/models.py +121 -0
  52. forma_core/cad_migrations/planner.py +68 -0
  53. forma_core/chemistry/__init__.py +5 -0
  54. forma_core/chemistry/models.py +215 -0
  55. forma_core/chemistry/stoichiometry.py +272 -0
  56. forma_core/chemistry/validation.py +179 -0
  57. forma_core/cli/__init__.py +1 -0
  58. forma_core/cli/__main__.py +4 -0
  59. forma_core/cli/main.py +370 -0
  60. forma_core/config/__init__.py +28 -0
  61. forma_core/config/compatibility.py +282 -0
  62. forma_core/config/contract.py +184 -0
  63. forma_core/config/environment.py +129 -0
  64. forma_core/config/parti.py +34 -0
  65. forma_core/config/runtime.py +303 -0
  66. forma_core/control/__init__.py +10 -0
  67. forma_core/control/actions.py +136 -0
  68. forma_core/control/adapters.py +36 -0
  69. forma_core/control/cli.py +49 -0
  70. forma_core/control/client.py +124 -0
  71. forma_core/control/models.py +168 -0
  72. forma_core/control/opencode_worker.py +80 -0
  73. forma_core/control/package.py +318 -0
  74. forma_core/control/rover_scene/__init__.py +1 -0
  75. forma_core/control/rover_scene/__main__.py +34 -0
  76. forma_core/control/rover_scene/assets.py +65 -0
  77. forma_core/control/rover_scene/fleet.py +214 -0
  78. forma_core/control/rover_scene/host.py +258 -0
  79. forma_core/control/rover_scene/kinematics.py +35 -0
  80. forma_core/control/rover_scene/machine.py +347 -0
  81. forma_core/control/rover_scene/robot.py +166 -0
  82. forma_core/control/rover_scene/scene.py +206 -0
  83. forma_core/control/rover_scene/view.py +80 -0
  84. forma_core/control/rover_scene/web/index.html +25 -0
  85. forma_core/control/rover_scene/web/viewer.js +148 -0
  86. forma_core/control/runtime.py +356 -0
  87. forma_core/control/so101.py +235 -0
  88. forma_core/control/tasks.py +287 -0
  89. forma_core/database.py +2362 -0
  90. forma_core/debug.py +314 -0
  91. forma_core/domains/__init__.py +7 -0
  92. forma_core/domains/agents.py +85 -0
  93. forma_core/domains/base.py +69 -0
  94. forma_core/domains/benchmark.py +87 -0
  95. forma_core/domains/cli.py +48 -0
  96. forma_core/domains/compatibility.py +234 -0
  97. forma_core/domains/composition.py +372 -0
  98. forma_core/domains/diagnostics.py +15 -0
  99. forma_core/domains/generation.py +479 -0
  100. forma_core/domains/interaction.py +301 -0
  101. forma_core/domains/planning.py +140 -0
  102. forma_core/domains/providers.py +214 -0
  103. forma_core/domains/registry.py +267 -0
  104. forma_core/domains/selection.py +75 -0
  105. forma_core/domains/storage.py +60 -0
  106. forma_core/domains/tools.py +180 -0
  107. forma_core/electronics/__init__.py +1 -0
  108. forma_core/electronics/models.py +84 -0
  109. forma_core/electronics/primitives.py +43 -0
  110. forma_core/electronics/rules.py +340 -0
  111. forma_core/external_sources.py +497 -0
  112. forma_core/fabricator/__init__.py +33 -0
  113. forma_core/fabricator/__main__.py +7 -0
  114. forma_core/fabricator/main.py +578 -0
  115. forma_core/firmware/__init__.py +60 -0
  116. forma_core/firmware/drivers.py +140 -0
  117. forma_core/firmware/examples.py +503 -0
  118. forma_core/firmware/generate.py +520 -0
  119. forma_core/firmware/models.py +34 -0
  120. forma_core/firmware/sil/__init__.py +5 -0
  121. forma_core/firmware/sil/adapter.py +71 -0
  122. forma_core/firmware/sil/build.py +49 -0
  123. forma_core/firmware/sil/native/CMakeLists.txt +9 -0
  124. forma_core/firmware/sil/native/bridge.cpp +112 -0
  125. forma_core/firmware/sil/native/controller.cpp +123 -0
  126. forma_core/firmware/sil/native/controller.h +49 -0
  127. forma_core/firmware/sil/simulator.py +139 -0
  128. forma_core/firmware/targets.py +111 -0
  129. forma_core/firmware/validation.py +130 -0
  130. forma_core/fluidics/__init__.py +6 -0
  131. forma_core/fluidics/benchmark.py +217 -0
  132. forma_core/fluidics/calculations.py +79 -0
  133. forma_core/fluidics/examples.py +54 -0
  134. forma_core/fluidics/ir.py +25 -0
  135. forma_core/fluidics/models.py +132 -0
  136. forma_core/fluidics/topology.py +47 -0
  137. forma_core/fluidics/validation.py +134 -0
  138. forma_core/generation.py +32 -0
  139. forma_core/geometry_bindings/__init__.py +20 -0
  140. forma_core/geometry_bindings/cad_adapter.py +80 -0
  141. forma_core/geometry_bindings/models.py +163 -0
  142. forma_core/geometry_bindings/resolution.py +340 -0
  143. forma_core/geometry_bindings/tools.py +125 -0
  144. forma_core/image_providers.py +3049 -0
  145. forma_core/images.py +3 -0
  146. forma_core/integrations/__init__.py +1 -0
  147. forma_core/integrations/huggingface/__init__.py +29 -0
  148. forma_core/integrations/huggingface/huggingface_artifacts.py +272 -0
  149. forma_core/jobs/__init__.py +1 -0
  150. forma_core/jobs/context.py +277 -0
  151. forma_core/jobs/continuous.py +719 -0
  152. forma_core/jobs/metrics.py +124 -0
  153. forma_core/jobs/migrations.py +161 -0
  154. forma_core/jobs/persistence.py +28 -0
  155. forma_core/jobs/repositories.py +422 -0
  156. forma_core/jobs/schema.py +28 -0
  157. forma_core/jobs/source_usage.py +230 -0
  158. forma_core/jobs/store.py +476 -0
  159. forma_core/llm.py +3 -0
  160. forma_core/llm_providers.py +2682 -0
  161. forma_core/logs.py +107 -0
  162. forma_core/mechanics/__init__.py +1 -0
  163. forma_core/mechanics/gear_benchmark.py +85 -0
  164. forma_core/mechanics/mechanism_benchmarks.py +345 -0
  165. forma_core/mechanics/models.py +72 -0
  166. forma_core/mechanics/primitives.py +109 -0
  167. forma_core/mechanics/solid_cad.py +83 -0
  168. forma_core/observability.py +237 -0
  169. forma_core/openai_streams.py +780 -0
  170. forma_core/opencode/__init__.py +25 -0
  171. forma_core/opencode/architecture.py +82 -0
  172. forma_core/opencode/capabilities.py +130 -0
  173. forma_core/opencode/models.py +419 -0
  174. forma_core/opencode/persistence.py +62 -0
  175. forma_core/opencode/public_events.py +91 -0
  176. forma_core/opencode/schema.py +28 -0
  177. forma_core/opencode/store.py +874 -0
  178. forma_core/persistence/__init__.py +16 -0
  179. forma_core/persistence/base.py +38 -0
  180. forma_core/persistence/images.py +598 -0
  181. forma_core/persistence/migrations.py +200 -0
  182. forma_core/persistence/models.py +439 -0
  183. forma_core/persistence/project_artifacts.py +341 -0
  184. forma_core/persistence/project_reconciliation.py +1094 -0
  185. forma_core/persistence/providers/__init__.py +4 -0
  186. forma_core/persistence/providers/sqlite.py +114 -0
  187. forma_core/persistence/providers/supabase.py +31 -0
  188. forma_core/persistence/repositories/__init__.py +9 -0
  189. forma_core/persistence/repositories/base.py +335 -0
  190. forma_core/persistence/repositories/sqlite.py +1571 -0
  191. forma_core/persistence/repositories/supabase.py +1576 -0
  192. forma_core/persistence/schema.py +176 -0
  193. forma_core/processes/__init__.py +5 -0
  194. forma_core/processes/models.py +338 -0
  195. forma_core/processes/validation.py +141 -0
  196. forma_core/project_list_cache.py +316 -0
  197. forma_core/prompt_continuity.py +387 -0
  198. forma_core/providers/__init__.py +39 -0
  199. forma_core/providers/base.py +28 -0
  200. forma_core/providers/models.py +138 -0
  201. forma_core/providers/openai.py +92 -0
  202. forma_core/providers/openai_compatible.py +190 -0
  203. forma_core/providers/registry.py +68 -0
  204. forma_core/providers/registry_utils.py +46 -0
  205. forma_core/py.typed +1 -0
  206. forma_core/runtime.py +3 -0
  207. forma_core/selectors.py +36 -0
  208. forma_core/signups/__init__.py +5 -0
  209. forma_core/signups/models.py +49 -0
  210. forma_core/terminal/__init__.py +1 -0
  211. forma_core/terminal/dashboard.py +475 -0
  212. forma_core/terminal/images.py +156 -0
  213. forma_core/thermal/__init__.py +5 -0
  214. forma_core/thermal/models.py +361 -0
  215. forma_core/thermal/validation.py +175 -0
  216. forma_core/user_integrations.py +2069 -0
  217. forma_core/utils.py +291 -0
  218. forma_core/validation.py +83 -0
  219. forma_core/vertex_auth.py +92 -0
  220. forma_core/video_prompts.py +193 -0
  221. forma_core/video_review.py +1006 -0
  222. forma_core/wiring.py +356 -0
  223. forma_core/workers/__init__.py +120 -0
  224. forma_core/workers/contracts.py +183 -0
  225. forma_core/workers/generation.py +753 -0
  226. forma_core/workers/orchestration.py +805 -0
  227. forma_core/workers/registry.py +222 -0
  228. forma_core/workers/reverse_engineering.py +272 -0
  229. forma_core/workers/validation.py +291 -0
  230. forma_core/workspaces/__init__.py +5 -0
  231. forma_core/workspaces/chats/__init__.py +11 -0
  232. forma_core/workspaces/chats/models.py +48 -0
  233. forma_core/workspaces/context/__init__.py +15 -0
  234. forma_core/workspaces/context/agent.py +260 -0
  235. forma_core/workspaces/context/models.py +117 -0
  236. forma_core/workspaces/context/pdf.py +418 -0
  237. forma_core/workspaces/design_briefs/__init__.py +25 -0
  238. forma_core/workspaces/design_briefs/models.py +85 -0
  239. forma_core/workspaces/design_briefs/references.py +56 -0
  240. forma_core/workspaces/models.py +41 -0
  241. forma_core/workspaces/projects/__init__.py +88 -0
  242. forma_core/workspaces/projects/cad_generation.py +1016 -0
  243. forma_core/workspaces/projects/context_governance.py +365 -0
  244. forma_core/workspaces/projects/design_lifecycle.py +668 -0
  245. forma_core/workspaces/projects/fabrication/__init__.py +54 -0
  246. forma_core/workspaces/projects/fabrication/demo_printers.py +236 -0
  247. forma_core/workspaces/projects/fabrication/models.py +120 -0
  248. forma_core/workspaces/projects/fabrication/printer_config.py +205 -0
  249. forma_core/workspaces/projects/fabrication/slicers/__init__.py +7 -0
  250. forma_core/workspaces/projects/fabrication/slicers/base.py +25 -0
  251. forma_core/workspaces/projects/fabrication/slicers/cura.py +125 -0
  252. forma_core/workspaces/projects/fabrication/slicers/orca.py +208 -0
  253. forma_core/workspaces/projects/fabrication/slicing.py +202 -0
  254. forma_core/workspaces/projects/fabrication/validation.py +103 -0
  255. forma_core/workspaces/projects/gear_benchmark.py +6 -0
  256. forma_core/workspaces/projects/generation_mode.py +70 -0
  257. forma_core/workspaces/projects/identity.py +28 -0
  258. forma_core/workspaces/projects/iteration.py +680 -0
  259. forma_core/workspaces/projects/manifest.py +362 -0
  260. forma_core/workspaces/projects/mechanism_benchmarks.py +12 -0
  261. forma_core/workspaces/projects/models.py +913 -0
  262. forma_core/workspaces/projects/objects.py +731 -0
  263. forma_core/workspaces/projects/outcomes.py +47 -0
  264. forma_core/workspaces/projects/output.py +735 -0
  265. forma_core/workspaces/projects/resolver.py +397 -0
  266. forma_core/workspaces/projects/solid_cad.py +8 -0
  267. forma_core/workspaces/projects/state.py +622 -0
  268. forma_core/workspaces/readiness/__init__.py +28 -0
  269. forma_core/workspaces/readiness/evaluator.py +103 -0
  270. forma_core/workspaces/readiness/models.py +97 -0
  271. forma_core/workspaces/readiness/service.py +225 -0
  272. forma_core/workspaces/reverse_engineering/__init__.py +37 -0
  273. forma_core/workspaces/reverse_engineering/analyzer.py +246 -0
  274. forma_core/workspaces/reverse_engineering/models.py +128 -0
  275. forma_core/workspaces/validation/__init__.py +37 -0
  276. forma_core/workspaces/validation/evaluator.py +327 -0
  277. forma_core/workspaces/validation/models.py +146 -0
  278. forma_core/workspaces/validation/service.py +212 -0
  279. forma_core/workspaces/workflow/__init__.py +29 -0
  280. forma_core/workspaces/workflow/guard.py +33 -0
  281. forma_core/workspaces/workflow/models.py +77 -0
  282. forma_core/workspaces/workflow/service.py +287 -0
  283. openforma-0.4.0.dist-info/METADATA +247 -0
  284. openforma-0.4.0.dist-info/RECORD +288 -0
  285. openforma-0.4.0.dist-info/WHEEL +5 -0
  286. openforma-0.4.0.dist-info/entry_points.txt +4 -0
  287. openforma-0.4.0.dist-info/licenses/LICENSE +373 -0
  288. openforma-0.4.0.dist-info/top_level.txt +2 -0
@@ -0,0 +1,190 @@
1
+ from __future__ import annotations
2
+
3
+ from dataclasses import replace
4
+ from pathlib import Path
5
+ from typing import Callable, Iterable, Protocol
6
+
7
+ from forma_core.openai_streams import (
8
+ DEFAULT_BASETEN_BASE_URL,
9
+ DEFAULT_BASETEN_STREAM_MODEL,
10
+ DEFAULT_GMI_BASE_URL,
11
+ DEFAULT_GMI_STREAM_MODEL,
12
+ DEFAULT_CLOUDFLARE_BASE_URL,
13
+ DEFAULT_CLOUDFLARE_STREAM_MODEL,
14
+ OpenAICompatibleChatCompletionsStreamer,
15
+ OpenAICompatibleChatConfig,
16
+ OpenAITextStreamChunk,
17
+ cloudflare_base_url,
18
+ first_env,
19
+ merged_env,
20
+ )
21
+ from forma_core.providers.models import (
22
+ ModelSpec,
23
+ PreparedProviderRequest,
24
+ ProviderAuth,
25
+ ProviderCapabilities,
26
+ ProviderEvent,
27
+ ProviderRequest,
28
+ ProviderSpec,
29
+ )
30
+ from forma_core.providers.registry_utils import model_name_for_provider, normalize_provider_name
31
+
32
+
33
+ class OpenAICompatibleStreamerProtocol(Protocol):
34
+ def stream_text(self) -> Iterable[OpenAITextStreamChunk]:
35
+ ...
36
+
37
+
38
+ OpenAICompatibleStreamerFactory = Callable[[OpenAICompatibleChatConfig], OpenAICompatibleStreamerProtocol]
39
+
40
+
41
+ class OpenAICompatibleChatProviderClient:
42
+ def __init__(
43
+ self,
44
+ *,
45
+ provider_name: str,
46
+ display_name: str,
47
+ env_file: Path,
48
+ default_model: str,
49
+ default_base_url: str,
50
+ api_key_env_names: tuple[str, ...],
51
+ base_url_env_names: tuple[str, ...],
52
+ model_env_names: tuple[str, ...],
53
+ streamer_factory: OpenAICompatibleStreamerFactory | None = None,
54
+ ) -> None:
55
+ self._provider_name = normalize_provider_name(provider_name)
56
+ self.display_name = display_name
57
+ self.env_file = env_file
58
+ self.default_model = default_model
59
+ self.default_base_url = default_base_url
60
+ self.api_key_env_names = api_key_env_names
61
+ self.base_url_env_names = base_url_env_names
62
+ self.model_env_names = model_env_names
63
+ self.streamer_factory = streamer_factory or OpenAICompatibleChatCompletionsStreamer
64
+
65
+ @classmethod
66
+ def baseten(
67
+ cls,
68
+ *,
69
+ env_file: Path,
70
+ streamer_factory: OpenAICompatibleStreamerFactory | None = None,
71
+ ) -> "OpenAICompatibleChatProviderClient":
72
+ return cls(
73
+ provider_name="baseten",
74
+ display_name="Baseten",
75
+ env_file=env_file,
76
+ default_model=DEFAULT_BASETEN_STREAM_MODEL,
77
+ default_base_url=DEFAULT_BASETEN_BASE_URL,
78
+ api_key_env_names=("BASETEN_API_KEY", "LLM_API_KEY"),
79
+ base_url_env_names=("BASETEN_BASE_URL", "LLM_BASE_URL"),
80
+ model_env_names=("BASETEN_STREAM_MODEL", "BASETEN_MODEL", "LLM_MODEL"),
81
+ streamer_factory=streamer_factory,
82
+ )
83
+
84
+ @classmethod
85
+ def gmi(
86
+ cls,
87
+ *,
88
+ env_file: Path,
89
+ streamer_factory: OpenAICompatibleStreamerFactory | None = None,
90
+ ) -> "OpenAICompatibleChatProviderClient":
91
+ return cls(
92
+ provider_name="gmi",
93
+ display_name="GMI Cloud",
94
+ env_file=env_file,
95
+ default_model=DEFAULT_GMI_STREAM_MODEL,
96
+ default_base_url=DEFAULT_GMI_BASE_URL,
97
+ api_key_env_names=("GMI_API_KEY", "GMI_CLOUD_API_KEY", "GMICLOUD_API_KEY", "LLM_API_KEY"),
98
+ base_url_env_names=("GMI_BASE_URL", "GMI_CLOUD_BASE_URL", "GMICLOUD_BASE_URL"),
99
+ model_env_names=("GMI_STREAM_MODEL", "GMI_MODEL", "GMI_CLOUD_MODEL", "GMICLOUD_MODEL", "LLM_MODEL"),
100
+ streamer_factory=streamer_factory,
101
+ )
102
+
103
+ @classmethod
104
+ def cloudflare(
105
+ cls,
106
+ *,
107
+ env_file: Path,
108
+ streamer_factory: OpenAICompatibleStreamerFactory | None = None,
109
+ ) -> "OpenAICompatibleChatProviderClient":
110
+ return cls(
111
+ provider_name="cloudflare",
112
+ display_name="Cloudflare AI",
113
+ env_file=env_file,
114
+ default_model=DEFAULT_CLOUDFLARE_STREAM_MODEL,
115
+ default_base_url=DEFAULT_CLOUDFLARE_BASE_URL,
116
+ api_key_env_names=("CLOUDFLARE_API_TOKEN", "CLOUDFLARE_AI_API_KEY", "CLOUDFLARE_API_KEY", "LLM_API_KEY"),
117
+ base_url_env_names=("CLOUDFLARE_BASE_URL",),
118
+ model_env_names=("CLOUDFLARE_STREAM_MODEL", "CLOUDFLARE_MODEL", "LLM_MODEL"),
119
+ streamer_factory=streamer_factory,
120
+ )
121
+
122
+ @property
123
+ def provider_name(self) -> str:
124
+ return self._provider_name
125
+
126
+ def spec(self) -> ProviderSpec:
127
+ env = merged_env(self.env_file)
128
+ api_key_source = next((name for name in self.api_key_env_names if first_env(env, name)), self.api_key_env_names[0])
129
+ api_key = first_env(env, *self.api_key_env_names) or ""
130
+ if self.provider_name == "cloudflare":
131
+ base_url = cloudflare_base_url(env)
132
+ else:
133
+ base_url = first_env(env, *self.base_url_env_names) or self.default_base_url
134
+ model = first_env(env, *self.model_env_names) or self.default_model
135
+ return ProviderSpec(
136
+ name=self.provider_name,
137
+ display_name=self.display_name,
138
+ base_url=base_url.rstrip("/"),
139
+ default_model=model,
140
+ auth=ProviderAuth(api_key=api_key, source_name=api_key_source),
141
+ capabilities=ProviderCapabilities(
142
+ supports_text=True,
143
+ supports_streaming=False,
144
+ supports_chat_completions=True,
145
+ supports_structured_output=True,
146
+ ),
147
+ )
148
+
149
+ def prepare(self, request: ProviderRequest) -> PreparedProviderRequest:
150
+ spec = self.spec()
151
+ timeout_seconds = request.timeout_seconds or spec.timeout_seconds
152
+ model = model_name_for_provider(self.provider_name, request.model or spec.default_model)
153
+ return PreparedProviderRequest(
154
+ spec=replace(spec, timeout_seconds=timeout_seconds),
155
+ model=ModelSpec(
156
+ provider=self.provider_name,
157
+ model=model,
158
+ supports_text=True,
159
+ supports_streaming=False,
160
+ supports_structured_output=True,
161
+ timeout_seconds=timeout_seconds,
162
+ ),
163
+ request=request,
164
+ endpoint_path="chat/completions",
165
+ )
166
+
167
+ def _config_for_prepared(self, prepared: PreparedProviderRequest) -> OpenAICompatibleChatConfig:
168
+ return OpenAICompatibleChatConfig.from_env_file(
169
+ self.env_file,
170
+ provider_name=self.provider_name,
171
+ model=prepared.model_name,
172
+ base_url=prepared.base_url,
173
+ prompt=prepared.request.prompt,
174
+ timeout_seconds=prepared.request.timeout_seconds,
175
+ max_output_tokens=prepared.request.max_output_tokens,
176
+ instructions=prepared.request.instructions,
177
+ temperature=prepared.request.temperature,
178
+ )
179
+
180
+ def stream_text(self, prepared: PreparedProviderRequest) -> Iterable[ProviderEvent]:
181
+ config = self._config_for_prepared(prepared)
182
+ for chunk in self.streamer_factory(config).stream_text():
183
+ yield ProviderEvent(
184
+ sequence=chunk.sequence,
185
+ content=chunk.content,
186
+ done=chunk.done,
187
+ event_type=chunk.response_event_type,
188
+ response_id=chunk.response_id,
189
+ error_message=chunk.error_message,
190
+ )
@@ -0,0 +1,68 @@
1
+ from __future__ import annotations
2
+
3
+ from pathlib import Path
4
+ from typing import Iterable
5
+
6
+ from forma_core.openai_streams import OpenAIStreamConfig
7
+ from forma_core.providers.base import ProviderClient, ProviderConfigurationError
8
+ from forma_core.providers.models import PreparedProviderRequest, ProviderEvent, ProviderRequest, ProviderSpec
9
+ from forma_core.providers.openai import OpenAIResponsesProviderClient, OpenAIResponsesStreamerFactory
10
+ from forma_core.providers.openai_compatible import OpenAICompatibleChatProviderClient, OpenAICompatibleStreamerFactory
11
+ from forma_core.providers.registry_utils import normalize_provider_name
12
+
13
+
14
+ class ProviderRegistry:
15
+ def __init__(self, clients: Iterable[ProviderClient]) -> None:
16
+ self._clients = {client.provider_name: client for client in clients}
17
+
18
+ @classmethod
19
+ def default(
20
+ cls,
21
+ *,
22
+ env_file: Path,
23
+ openai_config: OpenAIStreamConfig,
24
+ openai_streamer_factory: OpenAIResponsesStreamerFactory | None = None,
25
+ openai_compatible_streamer_factory: OpenAICompatibleStreamerFactory | None = None,
26
+ ) -> "ProviderRegistry":
27
+ return cls(
28
+ (
29
+ OpenAIResponsesProviderClient(
30
+ config=openai_config,
31
+ streamer_factory=openai_streamer_factory,
32
+ ),
33
+ OpenAICompatibleChatProviderClient.baseten(
34
+ env_file=env_file,
35
+ streamer_factory=openai_compatible_streamer_factory,
36
+ ),
37
+ OpenAICompatibleChatProviderClient.gmi(
38
+ env_file=env_file,
39
+ streamer_factory=openai_compatible_streamer_factory,
40
+ ),
41
+ OpenAICompatibleChatProviderClient.cloudflare(
42
+ env_file=env_file,
43
+ streamer_factory=openai_compatible_streamer_factory,
44
+ ),
45
+ )
46
+ )
47
+
48
+ def providers(self) -> tuple[str, ...]:
49
+ return tuple(sorted(self._clients))
50
+
51
+ def client(self, provider_name: str) -> ProviderClient:
52
+ provider = normalize_provider_name(provider_name)
53
+ client = self._clients.get(provider)
54
+ if client is None:
55
+ supported = ", ".join(self.providers()) or "none"
56
+ raise ProviderConfigurationError(f"Unsupported provider {provider_name!r}. Supported providers: {supported}.")
57
+ return client
58
+
59
+ def spec(self, provider_name: str) -> ProviderSpec:
60
+ return self.client(provider_name).spec()
61
+
62
+ def prepare(self, request: ProviderRequest) -> PreparedProviderRequest:
63
+ client = self.client(request.provider)
64
+ return client.prepare(request)
65
+
66
+ def stream_text(self, prepared: PreparedProviderRequest) -> Iterable[ProviderEvent]:
67
+ client = self.client(prepared.provider)
68
+ yield from client.stream_text(prepared)
@@ -0,0 +1,46 @@
1
+ from __future__ import annotations
2
+
3
+
4
+ def normalize_provider_name(value: str | None) -> str:
5
+ provider = (value or "openai").strip().lower().replace("_", "-")
6
+ aliases = {
7
+ "base10": "baseten",
8
+ "base-ten": "baseten",
9
+ "baseten-model-apis": "baseten",
10
+ "baseten-frontier": "baseten",
11
+ "gmi-cloud": "gmi",
12
+ "gmi_cloud": "gmi",
13
+ "gmicloud": "gmi",
14
+ "gemicloud": "gmi",
15
+ "gmi-serving": "gmi",
16
+ "cloudflare-ai": "cloudflare",
17
+ "cloudflare-workers-ai": "cloudflare",
18
+ "workers-ai": "cloudflare",
19
+ "workers_ai": "cloudflare",
20
+ }
21
+ return aliases.get(provider, provider or "openai")
22
+
23
+
24
+ def provider_slug(value: str | None) -> str:
25
+ provider = normalize_provider_name(value)
26
+ return "".join(char if char.isalnum() else "-" for char in provider).strip("-") or "provider"
27
+
28
+
29
+ def model_name_for_provider(provider_name: str | None, model: str | None) -> str:
30
+ resolved_provider = normalize_provider_name(provider_name)
31
+ resolved_model = (model or "").strip()
32
+ prefixes = {f"{resolved_provider}/", f"{provider_slug(resolved_provider)}/"}
33
+ if resolved_provider == "gmi":
34
+ prefixes.update({"gmi-cloud/", "gmicloud/", "gemicloud/", "gmi-serving/"})
35
+ for prefix in prefixes:
36
+ if resolved_model.lower().startswith(prefix.lower()):
37
+ resolved_model = resolved_model[len(prefix) :]
38
+ break
39
+ if resolved_provider == "gmi":
40
+ aliases = {
41
+ "fable": "anthropic/claude-fable-5",
42
+ "fable-5": "anthropic/claude-fable-5",
43
+ "claude-fable-5": "anthropic/claude-fable-5",
44
+ }
45
+ return aliases.get(resolved_model.lower(), resolved_model)
46
+ return resolved_model
forma_core/py.typed ADDED
@@ -0,0 +1 @@
1
+
forma_core/runtime.py ADDED
@@ -0,0 +1,3 @@
1
+ """Public runtime/deployment configuration API for Forma."""
2
+
3
+ from forma_core.config.runtime import * # noqa: F401,F403
@@ -0,0 +1,36 @@
1
+ from __future__ import annotations
2
+
3
+ from dataclasses import dataclass
4
+ from typing import Optional, Tuple
5
+
6
+
7
+ @dataclass(frozen=True)
8
+ class LLMSelector:
9
+ provider: str
10
+ model: str
11
+
12
+ @property
13
+ def key(self) -> str:
14
+ return f"{self.provider}/{self.model}"
15
+
16
+ def as_tuple(self) -> Tuple[str, str]:
17
+ return self.provider, self.model
18
+
19
+
20
+ def parse_llm_selector(value: Optional[str]) -> Optional[LLMSelector]:
21
+ """Parse a runtime selector formatted as provider/model."""
22
+ if value is None:
23
+ return None
24
+
25
+ provider, separator, model = value.strip().partition("/")
26
+ if not separator or not provider.strip() or not model.strip():
27
+ raise ValueError("LLM selector must look like provider/model, for example openai/gpt-5.6-sol.")
28
+
29
+ return LLMSelector(provider=provider.strip(), model=model.strip())
30
+
31
+
32
+ def split_llm_selector(value: Optional[str]) -> Tuple[Optional[str], Optional[str]]:
33
+ selector = parse_llm_selector(value)
34
+ if selector is None:
35
+ return None, None
36
+ return selector.provider, selector.model
@@ -0,0 +1,5 @@
1
+ """Signup domain models."""
2
+
3
+ from forma_core.signups.models import AlphaSignupRequest, AlphaSignupResponse
4
+
5
+ __all__ = ["AlphaSignupRequest", "AlphaSignupResponse"]
@@ -0,0 +1,49 @@
1
+ from __future__ import annotations
2
+
3
+ import re
4
+
5
+ from pydantic import BaseModel, Field, field_validator
6
+
7
+
8
+ class AlphaSignupRequest(BaseModel):
9
+ name: str = Field(..., min_length=1, max_length=120, description="Person's name")
10
+ email: str = Field(..., min_length=3, max_length=254, description="Contact email")
11
+ organization: str | None = Field(None, max_length=160, description="Organization or team")
12
+ additional_info: str | None = Field(None, max_length=1200, description="Optional launch or use-case context")
13
+
14
+ @field_validator("name", "email", mode="before")
15
+ @classmethod
16
+ def strip_required_text(cls, value: object) -> object:
17
+ if isinstance(value, str):
18
+ return value.strip()
19
+ return value
20
+
21
+ @field_validator("organization", "additional_info", mode="before")
22
+ @classmethod
23
+ def strip_optional_text(cls, value: object) -> object:
24
+ if isinstance(value, str):
25
+ stripped = value.strip()
26
+ return stripped or None
27
+ return value
28
+
29
+ @field_validator("name")
30
+ @classmethod
31
+ def require_name(cls, value: str | None) -> str:
32
+ if not value:
33
+ raise ValueError("Name is required.")
34
+ return value
35
+
36
+ @field_validator("email")
37
+ @classmethod
38
+ def validate_email(cls, value: str | None) -> str:
39
+ if not value:
40
+ raise ValueError("Email is required.")
41
+ normalized = value.lower()
42
+ if not re.match(r"^[^@\s]+@[^@\s]+\.[^@\s]+$", normalized):
43
+ raise ValueError("Enter a valid email address.")
44
+ return normalized
45
+
46
+
47
+ class AlphaSignupResponse(BaseModel):
48
+ ok: bool
49
+ message: str
@@ -0,0 +1 @@
1
+ """Terminal dashboard and image-rendering concerns."""