cmpnd 0.18.2__tar.gz → 0.18.3__tar.gz

{cmpnd-0.18.2 → cmpnd-0.18.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cmpnd
-Version: 0.18.2
+Version: 0.18.3
 Summary: DSPy observability and deployment SDK for cmpnd
 Project-URL: Homepage, https://cmpnd.ai
 Author-email: cmpnd <hello@cmpnd.ai>

{cmpnd-0.18.2 → cmpnd-0.18.3}/cmpnd/optimization.py

@@ -704,6 +704,7 @@ def optimize(
     lms: dict[str, Any] | None = None,
     max_metric_calls: int | None = None,
     auto: str | None = None,
+    may_author_code: bool | None = None,
     max_steps: int = 10,
     patience: int = 2,
     seed: int = 0,
@@ -842,6 +843,16 @@ def optimize(
             ``"heavy"`` — sized from the program's predictor count and the
             valset, using GEPA's own settings. Easier to reach for than a call
             count when you do not yet know what a run costs.
+        may_author_code: Whether this run may rewrite the SOURCE of the program's
+            ``dspy.Flex`` submodules, rather than only their instructions. Left
+            unset, the platform's answer is yes — writing a ``dspy.Flex`` is
+            already asking for its source to be optimized.
+
+            Pass ``False`` for "improve my prompts, don't rewrite my code" on a
+            program that has both: a cheaper, lower-variance search that still
+            optimizes every ordinary predictor and leaves each ``dspy.Flex`` at
+            the source you deployed. A program with no ``dspy.Flex`` in it is
+            unaffected either way.
         max_steps: How many times to re-optimize the winner, each step a fresh
             ``optimize`` call with an advanced seed (default 10). Distinct from
             the budget above, which bounds ONE step's search: total spend is
@@ -901,7 +912,14 @@ def optimize(
             step_config["seed"] = seed
 
             initiated = _initiate_step(
-                client, cfg.endpoint, headers, current_deployment_id, optimizer, data, step_config
+                client,
+                cfg.endpoint,
+                headers,
+                current_deployment_id,
+                optimizer,
+                data,
+                step_config,
+                may_author_code,
             )
             optimization_id = initiated["optimization_id"]
 
@@ -1040,6 +1058,7 @@ def _initiate_step(
     optimizer: str,
     data: str,
     config: dict[str, Any],
+    may_author_code: bool | None = None,
 ) -> dict[str, Any]:
     """POST one optimize step to serve; return the 201 body. Raises
     OptimizeError carrying the server's error on any non-2xx (e.g. 409/422).
@@ -1058,7 +1077,11 @@ def _initiate_step(
     resp = _request(
         lambda: client.post(
             f"{endpoint}/api/v1/deployments/{deployment_id}/optimize/{optimizer}",
-            json={"data": data, "config": config},
+            json=(
+                {"data": data, "config": config}
+                if may_author_code is None
+                else {"data": data, "config": config, "may_author_code": may_author_code}
+            ),
             headers=headers,
         ),
         what,

{cmpnd-0.18.2 → cmpnd-0.18.3}/pyproject.toml

@@ -5,7 +5,7 @@ name = "cmpnd"
 # it's new) — no git tags. Bump with `uv version --bump {minor,patch}` or by
 # hand. Runtime `cmpnd.__version__` reads installed metadata, so it tracks
 # this automatically. See docs/plans/2026-07-02-sdk-pypi-tag-free-publish.md.
-version = "0.18.2"
+version = "0.18.3"
 description = "DSPy observability and deployment SDK for cmpnd"
 readme = "README.md"
 requires-python = ">=3.10"

{cmpnd-0.18.2 → cmpnd-0.18.3}/tests/test_optimize_budget.py

@@ -14,9 +14,11 @@ before ``configuration.require_config()``.
 
 from __future__ import annotations
 
+import httpx
 import pytest
 
 import cmpnd
+from cmpnd import optimization
 
 
 def _feedback_metric(gold, pred, trace, pred_name, pred_trace):
@@ -103,3 +105,37 @@ def test_a_budget_passes_the_check_and_the_run_proceeds(budget):
             **budget,
         )
     assert "budget" not in str(exc.value)
+
+
+def test_the_declaration_about_code_travels_only_when_it_is_made():
+    """`may_author_code` reaches serve as the caller's word, or not at all.
+
+    Omitted when unset, because the DEFAULT is the platform's — writing a `dspy.Flex` is
+    already the declaration — and an SDK that stamped `true` would put a second copy of
+    that default in the place hardest to change, since every released SDK keeps sending
+    whatever it was built with.
+    """
+    sent: list[dict] = []
+
+    class Recorder:
+        def post(self, url, json, headers):  # noqa: A002 — httpx's own parameter name
+            sent.append(json)
+            return httpx.Response(201, json={"optimization_id": "op_1", "status": "awaiting_data"})
+
+    for declared, want in ((None, None), (False, False), (True, True)):
+        sent.clear()
+        optimization._initiate_step(
+            Recorder(),  # pyright: ignore[reportArgumentType] — only `.post` is reached
+            "https://serve.test",
+            {},
+            "d_1",
+            "gepa",
+            "upload",
+            {"max_metric_calls": 10},
+            declared,
+        )
+        assert len(sent) == 1
+        if want is None:
+            assert "may_author_code" not in sent[0], "an unset declaration must not be sent"
+        else:
+            assert sent[0]["may_author_code"] is want

{cmpnd-0.18.2 → cmpnd-0.18.3}/uv.lock

@@ -496,7 +496,7 @@ wheels = [
 
 [[package]]
 name = "cmpnd"
-version = "0.18.2"
+version = "0.18.3"
 source = { editable = "." }
 dependencies = [
     { name = "dspy" },