prograph 1.3.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 (237) hide show
  1. prograph/__init__.py +36 -0
  2. prograph/__main__.py +5 -0
  3. prograph/_version.py +375 -0
  4. prograph/cli/__init__.py +1 -0
  5. prograph/cli/_iri_utils.py +124 -0
  6. prograph/cli/emit_genie_space.py +107 -0
  7. prograph/cli/generate_views.py +140 -0
  8. prograph/cli/main.py +420 -0
  9. prograph/cli/schema_inferrer.py +746 -0
  10. prograph/cli/ttl_loader.py +289 -0
  11. prograph/cli/upload_genie_space.py +84 -0
  12. prograph/config/__init__.py +27 -0
  13. prograph/config/yaml_config.py +848 -0
  14. prograph/demos/__init__.py +14 -0
  15. prograph/demos/turbofan/README.md +74 -0
  16. prograph/demos/turbofan/SCENARIO.md +209 -0
  17. prograph/demos/turbofan/__init__.py +75 -0
  18. prograph/demos/turbofan/create_tables.sql +206 -0
  19. prograph/demos/turbofan/data/engine-instances.ttl +1123 -0
  20. prograph/demos/turbofan/data/sensor-timeseries.csv +90 -0
  21. prograph/demos/turbofan/demo.py +162 -0
  22. prograph/demos/turbofan/genie_qa_notebook.py +434 -0
  23. prograph/demos/turbofan/graph.yaml +1098 -0
  24. prograph/demos/turbofan/instance_graph_demo.py +32 -0
  25. prograph/demos/turbofan/load.py +223 -0
  26. prograph/demos/turbofan/mapping.r2rml.ttl +991 -0
  27. prograph/demos/turbofan/ontology/engine-maintenance.ttl +606 -0
  28. prograph/demos/turbofan/payload-shapes.ttl +33 -0
  29. prograph/demos/turbofan/queries/example-queries.sparql +215 -0
  30. prograph/demos/turbofan/shapes.ttl +75 -0
  31. prograph/demos/turbofan/tables.py +106 -0
  32. prograph/demos/turbofan/turbofan_schema.py +393 -0
  33. prograph/demos/turbofan/validation_demo.py +153 -0
  34. prograph/describe.py +231 -0
  35. prograph/endpoint/__init__.py +12 -0
  36. prograph/endpoint/app.py +722 -0
  37. prograph/endpoint/cli.py +280 -0
  38. prograph/endpoint/credentials.py +240 -0
  39. prograph/endpoint/engines.py +418 -0
  40. prograph/endpoint/negotiate.py +101 -0
  41. prograph/endpoint/results.py +181 -0
  42. prograph/endpoint/service.py +31 -0
  43. prograph/engine.py +2718 -0
  44. prograph/execution.py +455 -0
  45. prograph/executors/__init__.py +6 -0
  46. prograph/executors/base.py +11 -0
  47. prograph/executors/databricks_sql_executor.py +51 -0
  48. prograph/executors/duckdb_executor.py +24 -0
  49. prograph/executors/mysql_executor.py +20 -0
  50. prograph/executors/oracle_executor.py +24 -0
  51. prograph/executors/pandas_executor.py +72 -0
  52. prograph/executors/postgresql_executor.py +35 -0
  53. prograph/executors/spark_executor.py +88 -0
  54. prograph/executors/sqlserver_executor.py +35 -0
  55. prograph/extras/__init__.py +1 -0
  56. prograph/extras/graphql/__init__.py +33 -0
  57. prograph/extras/graphql/execute.py +25 -0
  58. prograph/extras/graphql/schema.py +314 -0
  59. prograph/extras/instance_graph.py +559 -0
  60. prograph/genie/__init__.py +83 -0
  61. prograph/genie/databricks_uploader.py +306 -0
  62. prograph/genie/deploy.py +393 -0
  63. prograph/genie/formats.py +414 -0
  64. prograph/genie/instruction_generator.py +375 -0
  65. prograph/genie/sample_query_generator.py +256 -0
  66. prograph/genie/shacl_views.py +318 -0
  67. prograph/genie/space_emitter.py +329 -0
  68. prograph/genie/view_generator.py +628 -0
  69. prograph/genie/view_writer.py +172 -0
  70. prograph/graph/__init__.py +1 -0
  71. prograph/graph/ansi_session.py +348 -0
  72. prograph/graph/databricks_sql_graph.py +300 -0
  73. prograph/graph/drivers.py +143 -0
  74. prograph/graph/duckdb_graph.py +68 -0
  75. prograph/graph/mysql_graph.py +38 -0
  76. prograph/graph/oracle_graph.py +285 -0
  77. prograph/graph/pandas_graph.py +343 -0
  78. prograph/graph/postgresql_graph.py +644 -0
  79. prograph/graph/spark_graph.py +556 -0
  80. prograph/graph/sql_graph.py +83 -0
  81. prograph/graph/sqlserver_graph.py +72 -0
  82. prograph/hints.py +95 -0
  83. prograph/logging.py +550 -0
  84. prograph/mcp/__init__.py +29 -0
  85. prograph/mcp/__main__.py +180 -0
  86. prograph/mcp/bootstrap.py +98 -0
  87. prograph/mcp/server.py +601 -0
  88. prograph/mcp/sparql.py +397 -0
  89. prograph/mcp/tools.py +504 -0
  90. prograph/nlp/__init__.py +79 -0
  91. prograph/nlp/client.py +305 -0
  92. prograph/nlp/databricks_tools.py +369 -0
  93. prograph/nlp/graph_context.py +313 -0
  94. prograph/nlp/interface.py +652 -0
  95. prograph/nlp/prompts/__init__.py +19 -0
  96. prograph/nlp/prompts/examples.py +258 -0
  97. prograph/nlp/prompts/system.py +239 -0
  98. prograph/nlp/providers/__init__.py +14 -0
  99. prograph/nlp/providers/anthropic.py +274 -0
  100. prograph/nlp/providers/databricks.py +312 -0
  101. prograph/nlp/providers/openai.py +203 -0
  102. prograph/nlp/schema_context.py +78 -0
  103. prograph/ontology/__init__.py +53 -0
  104. prograph/ontology/alignment.py +542 -0
  105. prograph/ontology/hierarchy.py +310 -0
  106. prograph/ontology/imports.py +587 -0
  107. prograph/ontology/layer.py +991 -0
  108. prograph/ontology/skos.py +61 -0
  109. prograph/owl/__init__.py +27 -0
  110. prograph/owl/defined_classes.py +323 -0
  111. prograph/parameters.py +242 -0
  112. prograph/parser/__init__.py +1 -0
  113. prograph/parser/cypher/CypherLexer.py +836 -0
  114. prograph/parser/cypher/CypherListener.py +966 -0
  115. prograph/parser/cypher/CypherParser.py +10854 -0
  116. prograph/parser/cypher/CypherVisitor.py +543 -0
  117. prograph/parser/cypher/__init__.py +1 -0
  118. prograph/parser/sparql/SparqlLexer.py +801 -0
  119. prograph/parser/sparql/SparqlParser.py +10146 -0
  120. prograph/parser/sparql/SparqlParserListener.py +1056 -0
  121. prograph/parser/sparql/SparqlParserVisitor.py +593 -0
  122. prograph/parser/sparql/__init__.py +8 -0
  123. prograph/plan/__init__.py +3 -0
  124. prograph/plan/ir/__init__.py +1 -0
  125. prograph/plan/ir/casts.py +338 -0
  126. prograph/plan/ir/consistency.py +397 -0
  127. prograph/plan/ir/construct.py +90 -0
  128. prograph/plan/ir/cost.py +234 -0
  129. prograph/plan/ir/cypher_answer.py +1081 -0
  130. prograph/plan/ir/cypher_apoc.py +717 -0
  131. prograph/plan/ir/cypher_apoc_convert.py +505 -0
  132. prograph/plan/ir/cypher_apoc_date.py +845 -0
  133. prograph/plan/ir/cypher_apoc_map.py +496 -0
  134. prograph/plan/ir/cypher_apoc_meta.py +384 -0
  135. prograph/plan/ir/cypher_apoc_path.py +597 -0
  136. prograph/plan/ir/cypher_apoc_procedures.py +163 -0
  137. prograph/plan/ir/cypher_apoc_text.py +785 -0
  138. prograph/plan/ir/cypher_front.py +5474 -0
  139. prograph/plan/ir/cypher_functions.py +565 -0
  140. prograph/plan/ir/cypher_lists.py +935 -0
  141. prograph/plan/ir/cypher_maps.py +370 -0
  142. prograph/plan/ir/cypher_mixed.py +604 -0
  143. prograph/plan/ir/cypher_ontology.py +226 -0
  144. prograph/plan/ir/cypher_procedures.py +191 -0
  145. prograph/plan/ir/cypher_runtime_errors.py +107 -0
  146. prograph/plan/ir/cypher_temporal.py +1357 -0
  147. prograph/plan/ir/cypher_temporal_arith.py +339 -0
  148. prograph/plan/ir/cypher_values.py +546 -0
  149. prograph/plan/ir/cypher_write.py +612 -0
  150. prograph/plan/ir/dataset.py +643 -0
  151. prograph/plan/ir/dates.py +102 -0
  152. prograph/plan/ir/entry.py +992 -0
  153. prograph/plan/ir/expr.py +260 -0
  154. prograph/plan/ir/facts.py +1171 -0
  155. prograph/plan/ir/fresh.py +291 -0
  156. prograph/plan/ir/freshness.py +625 -0
  157. prograph/plan/ir/identity.py +797 -0
  158. prograph/plan/ir/java_datetime.py +265 -0
  159. prograph/plan/ir/java_regex.py +391 -0
  160. prograph/plan/ir/join_order.py +39 -0
  161. prograph/plan/ir/key_checks.py +433 -0
  162. prograph/plan/ir/keys.py +454 -0
  163. prograph/plan/ir/lower.py +5323 -0
  164. prograph/plan/ir/ops.py +619 -0
  165. prograph/plan/ir/owl_rl.py +1119 -0
  166. prograph/plan/ir/owl_rl_rules.py +725 -0
  167. prograph/plan/ir/profiles.py +694 -0
  168. prograph/plan/ir/ql.py +987 -0
  169. prograph/plan/ir/rdfs.py +342 -0
  170. prograph/plan/ir/rewrite.py +1782 -0
  171. prograph/plan/ir/saturate.py +339 -0
  172. prograph/plan/ir/semantics.py +103 -0
  173. prograph/plan/ir/slot.py +509 -0
  174. prograph/plan/ir/sparql_front.py +3418 -0
  175. prograph/plan/ir/strings.py +534 -0
  176. prograph/plan/ir/term_functions.py +274 -0
  177. prograph/plan/ir/terms.py +84 -0
  178. prograph/plan/ir/xpath_regex.py +264 -0
  179. prograph/plan/run_record.py +65 -0
  180. prograph/plan/sql/__init__.py +21 -0
  181. prograph/plan/sql/dialect.py +3726 -0
  182. prograph/plan/sql/mysql_serializer.py +103 -0
  183. prograph/plan/sql/names.py +65 -0
  184. prograph/plan/sql/oracle_serializer.py +306 -0
  185. prograph/plan/sql/pg_serializer.py +501 -0
  186. prograph/plan/sql/rel_algebra.py +781 -0
  187. prograph/plan/sql/sql_serializer.py +1419 -0
  188. prograph/plan/sql/sqlserver_serializer.py +603 -0
  189. prograph/provenance.py +222 -0
  190. prograph/r2rml/__init__.py +48 -0
  191. prograph/r2rml/catalog.py +259 -0
  192. prograph/r2rml/compile.py +372 -0
  193. prograph/r2rml/direct.py +140 -0
  194. prograph/r2rml/export.py +495 -0
  195. prograph/r2rml/model.py +180 -0
  196. prograph/r2rml/parser.py +546 -0
  197. prograph/r2rml/schema.py +120 -0
  198. prograph/read_only.py +122 -0
  199. prograph/results.py +157 -0
  200. prograph/rules/__init__.py +168 -0
  201. prograph/rules/__main__.py +32 -0
  202. prograph/schema/__init__.py +60 -0
  203. prograph/schema/change_set.py +50 -0
  204. prograph/schema/collations.py +198 -0
  205. prograph/schema/compile_schema.py +388 -0
  206. prograph/schema/context.py +845 -0
  207. prograph/schema/examples.py +234 -0
  208. prograph/schema/iri.py +817 -0
  209. prograph/schema/literals.py +94 -0
  210. prograph/schema/lpg_view.py +617 -0
  211. prograph/schema/mapping.py +1803 -0
  212. prograph/schema/maps_schema.py +40 -0
  213. prograph/schema/naming.py +77 -0
  214. prograph/schema/query_sources.py +59 -0
  215. prograph/schema/rows.py +215 -0
  216. prograph/schema/source_map.py +1103 -0
  217. prograph/schema/store_view.py +459 -0
  218. prograph/schema/types.py +569 -0
  219. prograph/schema/xsd.py +569 -0
  220. prograph/shacl/__init__.py +30 -0
  221. prograph/shacl/dqv.py +58 -0
  222. prograph/shacl/generate.py +255 -0
  223. prograph/shacl/report.py +138 -0
  224. prograph/shacl/validator.py +164 -0
  225. prograph/store.py +1737 -0
  226. prograph/utils/__init__.py +6 -0
  227. prograph/utils/exceptions.py +308 -0
  228. prograph/utils/helpers.py +126 -0
  229. prograph/warnings.py +46 -0
  230. prograph/writes.py +369 -0
  231. prograph-1.3.3.dist-info/METADATA +281 -0
  232. prograph-1.3.3.dist-info/RECORD +237 -0
  233. prograph-1.3.3.dist-info/WHEEL +5 -0
  234. prograph-1.3.3.dist-info/entry_points.txt +3 -0
  235. prograph-1.3.3.dist-info/licenses/LICENSE +201 -0
  236. prograph-1.3.3.dist-info/licenses/NOTICE +10 -0
  237. prograph-1.3.3.dist-info/top_level.txt +1 -0
@@ -0,0 +1,180 @@
1
+ """``python -m prograph.mcp``: run the ProGraph MCP server for one local user.
2
+
3
+ It runs as whoever starts it, with the engine's own credentials, over stdio or over HTTP on this
4
+ machine only (127.0.0.1, localhost, ::1). MCP over a network, where each request runs as the user
5
+ who sent it, is `prograph serve --mcp` (a Databricks App's forwarded token, or `--per-user` off one):
6
+ the one home of per-user serving. Bound to any other address, this module refuses to start
7
+ (`MCPNetworkRefused`)."""
8
+
9
+ from __future__ import annotations
10
+
11
+ import argparse
12
+ import sys
13
+
14
+ from prograph.mcp.bootstrap import BootstrapError, load_engine
15
+ from prograph.rules import home
16
+ from prograph.mcp.server import build_server
17
+
18
+
19
+ def _build_arg_parser() -> argparse.ArgumentParser:
20
+ p = argparse.ArgumentParser(
21
+ prog="prograph-mcp",
22
+ description=(
23
+ "Run an MCP server exposing a ProGraph engine to LLM clients. "
24
+ "Configure the engine via a YAML config or a Python entrypoint."
25
+ ),
26
+ )
27
+ source = p.add_mutually_exclusive_group(required=True)
28
+ source.add_argument(
29
+ "--config",
30
+ metavar="PATH",
31
+ help="YAML config consumed by ProGraph.from_config (pandas/local files).",
32
+ )
33
+ source.add_argument(
34
+ "--entrypoint",
35
+ metavar="MODULE:FUNCTION",
36
+ help=(
37
+ "Python entrypoint returning a configured ProGraph instance "
38
+ "(use this for Spark / Databricks / custom setups)."
39
+ ),
40
+ )
41
+ p.add_argument(
42
+ "--transport",
43
+ choices=["stdio", "streamable-http"],
44
+ default="stdio",
45
+ help="Transport for the MCP server (default: stdio).",
46
+ )
47
+ p.add_argument(
48
+ "--name",
49
+ default="prograph",
50
+ help="MCP server name shown to clients (default: prograph).",
51
+ )
52
+ p.add_argument(
53
+ "--host",
54
+ default=None,
55
+ help=(
56
+ "Bind address for streamable-http transport: this machine only (127.0.0.1, the "
57
+ "default; localhost; ::1). For MCP over a network, each request as its user, use "
58
+ "`prograph serve --mcp`."
59
+ ),
60
+ )
61
+ p.add_argument(
62
+ "--port",
63
+ type=int,
64
+ default=None,
65
+ help=(
66
+ "Port for streamable-http transport (default: FastMCP "
67
+ "default, usually 8000)."
68
+ ),
69
+ )
70
+ p.add_argument(
71
+ "--simple-http",
72
+ action="store_true",
73
+ help=(
74
+ "For streamable-http: serve plain JSON responses with no session "
75
+ "(json_response + stateless_http). Lets lightweight JSON-RPC MCP "
76
+ "clients that POST tools/call and read response.json(), and don't "
77
+ "parse SSE or run the initialize handshake, consume the server."
78
+ ),
79
+ )
80
+ p.add_argument(
81
+ "--sparql",
82
+ action="store_true",
83
+ help=(
84
+ "Serve the SPARQL tools (get_schema, run_sparql, ask, explain_sparql), "
85
+ "as `prograph serve --mcp` does at /mcp."
86
+ ),
87
+ )
88
+ from prograph.nlp.providers.databricks import DEFAULT_MODEL
89
+ p.add_argument("--model", default=None,
90
+ help="With --sparql: the model ask writes queries with (a Model Serving "
91
+ f"endpoint's name for the databricks provider; default {DEFAULT_MODEL}, "
92
+ "the model measured).")
93
+ p.add_argument("--provider", choices=["databricks", "anthropic", "openai"], default="databricks",
94
+ help="With --sparql: where the model is served (default databricks).")
95
+ return p
96
+
97
+
98
+ LOCAL_HOSTS = ("127.0.0.1", "localhost", "::1")
99
+
100
+
101
+ class MCPNetworkRefused(ValueError):
102
+ """`python -m prograph.mcp` bound to an address other than this machine's: network MCP, each
103
+ request as its user, is `prograph serve --mcp`."""
104
+
105
+
106
+ @home("network-mcp", "MCP over a network runs each request as its user, through prograph serve --mcp",
107
+ terms=("MCP", "network MCP", "per-user", "streamable-http", "prograph serve --mcp", "identity"))
108
+ def local_only(host) -> None:
109
+ """Refuse a bind address other than this machine's (`MCPNetworkRefused`)."""
110
+ if (host or "127.0.0.1") not in LOCAL_HOSTS:
111
+ raise MCPNetworkRefused(
112
+ f"serves this machine only (127.0.0.1, localhost, ::1), not {host}: for MCP over a network, "
113
+ "each request as the user who sent it, run `prograph serve --mcp` (on a Databricks App, or "
114
+ "with --per-user off one)")
115
+
116
+
117
+ def main(argv: list[str] | None = None) -> int:
118
+ args = _build_arg_parser().parse_args(argv)
119
+
120
+ if args.transport == "streamable-http":
121
+ # Before the engine is built: this machine only.
122
+ try:
123
+ local_only(args.host)
124
+ except MCPNetworkRefused as refused:
125
+ print(f"prograph-mcp: {refused}", file=sys.stderr)
126
+ return 2
127
+
128
+ try:
129
+ engine = load_engine(config=args.config, entrypoint=args.entrypoint)
130
+ except BootstrapError as e:
131
+ print(f"prograph-mcp: {e}", file=sys.stderr)
132
+ return 2
133
+
134
+ if args.sparql:
135
+ from types import SimpleNamespace
136
+ from prograph.endpoint.cli import model_client
137
+ from prograph.mcp.server import build_sparql_server
138
+ server = build_sparql_server(
139
+ engine,
140
+ llm=model_client(SimpleNamespace(mcp_model=args.model, mcp_provider=args.provider)),
141
+ name=args.name,
142
+ json_response=args.simple_http,
143
+ stateless_http=args.simple_http,
144
+ host=args.host or "127.0.0.1",
145
+ )
146
+ else:
147
+ server = build_server(
148
+ engine,
149
+ name=args.name,
150
+ json_response=args.simple_http,
151
+ stateless_http=args.simple_http,
152
+ )
153
+
154
+ # FastMCP exposes host/port as `settings` (older versions) or as
155
+ # direct attrs (newer versions). Set both forms to be safe.
156
+ if args.host is not None:
157
+ if hasattr(server, "settings") and hasattr(server.settings, "host"):
158
+ server.settings.host = args.host
159
+ if hasattr(server, "host"):
160
+ server.host = args.host
161
+ if args.port is not None:
162
+ if hasattr(server, "settings") and hasattr(server.settings, "port"):
163
+ server.settings.port = args.port
164
+ if hasattr(server, "port"):
165
+ server.port = args.port
166
+
167
+ if args.transport == "stdio":
168
+ import anyio
169
+ anyio.run(server.run_stdio_async)
170
+ else:
171
+ # FastMCP's own runner, on this machine only.
172
+ import uvicorn
173
+ uvicorn.run(server.streamable_http_app(),
174
+ host=server.settings.host, port=server.settings.port,
175
+ log_level=server.settings.log_level.lower())
176
+ return 0
177
+
178
+
179
+ if __name__ == "__main__":
180
+ sys.exit(main())
@@ -0,0 +1,98 @@
1
+ """Engine bootstrap for the MCP server.
2
+
3
+ Two ways to point the server at a ProGraph engine:
4
+
5
+ 1. ``--config <path.yaml>``: a YAML schema config consumed by
6
+ ``ProGraph.from_config``. Works for pandas / local-file setups.
7
+
8
+ 2. ``--entrypoint <module:function>``: a Python entrypoint that returns a
9
+ pre-built ``ProGraph`` instance. The escape hatch for Spark, Databricks,
10
+ or any setup where the engine needs a live session.
11
+ """
12
+
13
+ from __future__ import annotations
14
+
15
+ import importlib
16
+ from typing import TYPE_CHECKING, Optional
17
+
18
+ if TYPE_CHECKING:
19
+ from prograph import ProGraph
20
+
21
+
22
+ class BootstrapError(RuntimeError):
23
+ """Raised when the MCP server cannot construct a ProGraph engine."""
24
+
25
+
26
+ def load_engine(
27
+ *,
28
+ config: Optional[str] = None,
29
+ entrypoint: Optional[str] = None,
30
+ ) -> "ProGraph":
31
+ """Build a ProGraph engine from a YAML config or Python entrypoint.
32
+
33
+ Exactly one of ``config`` or ``entrypoint`` must be provided.
34
+
35
+ Args:
36
+ config: Path to a YAML config consumed by ``ProGraph.from_config``.
37
+ entrypoint: ``"module.path:function"`` returning a ``ProGraph``.
38
+
39
+ Raises:
40
+ BootstrapError: If neither or both are given, or if loading fails.
41
+ """
42
+ if (config is None) == (entrypoint is None):
43
+ raise BootstrapError(
44
+ "Provide exactly one of --config or --entrypoint."
45
+ )
46
+
47
+ if config is not None:
48
+ return _load_from_config(config)
49
+ return _load_from_entrypoint(entrypoint) # type: ignore[arg-type]
50
+
51
+
52
+ def _load_from_config(path: str) -> "ProGraph":
53
+ from prograph import ProGraph
54
+
55
+ try:
56
+ return ProGraph.from_config(path)
57
+ except FileNotFoundError as e:
58
+ raise BootstrapError(f"Config file not found: {path}") from e
59
+ except Exception as e:
60
+ raise BootstrapError(f"Failed to load engine from {path}: {e}") from e
61
+
62
+
63
+ def _load_from_entrypoint(spec: str) -> "ProGraph":
64
+ if ":" not in spec:
65
+ raise BootstrapError(
66
+ f"Entrypoint must be 'module.path:function', got {spec!r}"
67
+ )
68
+ module_name, func_name = spec.split(":", 1)
69
+
70
+ try:
71
+ module = importlib.import_module(module_name)
72
+ except ImportError as e:
73
+ raise BootstrapError(f"Could not import module {module_name!r}: {e}") from e
74
+
75
+ func = getattr(module, func_name, None)
76
+ if func is None:
77
+ raise BootstrapError(
78
+ f"Module {module_name!r} has no attribute {func_name!r}"
79
+ )
80
+ if not callable(func):
81
+ raise BootstrapError(
82
+ f"Entrypoint {spec!r} is not callable"
83
+ )
84
+
85
+ try:
86
+ engine = func()
87
+ except Exception as e:
88
+ raise BootstrapError(f"Entrypoint {spec!r} raised: {e}") from e
89
+
90
+ from prograph import ProGraph
91
+ if not isinstance(engine, ProGraph):
92
+ raise BootstrapError(
93
+ f"Entrypoint {spec!r} returned {type(engine).__name__}, expected ProGraph"
94
+ )
95
+ return engine
96
+
97
+
98
+ __all__ = ["load_engine", "BootstrapError"]