devagent-physical-engine 0.11.2__tar.gz → 0.11.3__tar.gz

{devagent_physical_engine-0.11.2/src/devagent_physical_engine.egg-info → devagent_physical_engine-0.11.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devagent-physical-engine
-Version: 0.11.2
+Version: 0.11.3
 Summary: Verification-first agentic planning runtime for robotic and industrial automation.
 Author: Tom Ha
 License: All Rights Reserved
@@ -49,10 +49,12 @@ DevAgent Smart Physical Engine adds AI-assisted engineering to existing automati
 
 ## Current version
 
-**v0.11.2 — Beta software / evidence-gated physical runtime**
+**v0.11.3 — Beta software / evidence-gated physical runtime**
 
 The Python software stack is regression-tested on Python 3.11, 3.12, and 3.13 with separate static/coverage, package-install, and runtime dependency security gates. The UR5e Gazebo/MoveIt path now contains production-candidate continuous-clearance, tool-collision, and workpiece-lifecycle capabilities, but those physical-simulation scopes remain **EXPERIMENTAL until the executable target-workstation v0.11 campaign passes**.
 
+v0.11.3 also normalizes provider-neutral agent schemas at the OpenAI transport boundary so strict Structured Outputs can represent DevAgent optional fields without changing Anthropic/Gemini or deterministic core semantics.
+
 Real robot execution remains locked. Functional-safety certification and site qualification are not claimed.
 
 ## v0.11 capability status
@@ -195,16 +197,16 @@ export ANTHROPIC_API_KEY='...'
 export GEMINI_API_KEY='...'
 ```
 
-Examples:
+Examples use the currently supported deterministic goal action `load`:
 
 ```bash
 devagent-physical-ai doctor --provider openai
 devagent-physical-ai qualify --provider openai --model <model-id>
 devagent-physical-ai request \
-  "Use a UR5e to move a part from conveyor_a to cnc_04" \
+  "Use a UR5e to load BOX_101 from conveyor_a to cnc_04. Simulate and verify the plan." \
   --provider openai --model <model-id>
 devagent-physical-ai engineer \
-  "Use a UR5e to move a part from conveyor_a to cnc_04" \
+  "Use a UR5e to load BOX_101 from conveyor_a to cnc_04. Simulate and verify the plan." \
   --provider openai --model <model-id>
 ```
 

{devagent_physical_engine-0.11.2 → devagent_physical_engine-0.11.3}/README.md

@@ -8,10 +8,12 @@ DevAgent Smart Physical Engine adds AI-assisted engineering to existing automati
 
 ## Current version
 
-**v0.11.2 — Beta software / evidence-gated physical runtime**
+**v0.11.3 — Beta software / evidence-gated physical runtime**
 
 The Python software stack is regression-tested on Python 3.11, 3.12, and 3.13 with separate static/coverage, package-install, and runtime dependency security gates. The UR5e Gazebo/MoveIt path now contains production-candidate continuous-clearance, tool-collision, and workpiece-lifecycle capabilities, but those physical-simulation scopes remain **EXPERIMENTAL until the executable target-workstation v0.11 campaign passes**.
 
+v0.11.3 also normalizes provider-neutral agent schemas at the OpenAI transport boundary so strict Structured Outputs can represent DevAgent optional fields without changing Anthropic/Gemini or deterministic core semantics.
+
 Real robot execution remains locked. Functional-safety certification and site qualification are not claimed.
 
 ## v0.11 capability status
@@ -154,16 +156,16 @@ export ANTHROPIC_API_KEY='...'
 export GEMINI_API_KEY='...'
 ```
 
-Examples:
+Examples use the currently supported deterministic goal action `load`:
 
 ```bash
 devagent-physical-ai doctor --provider openai
 devagent-physical-ai qualify --provider openai --model <model-id>
 devagent-physical-ai request \
-  "Use a UR5e to move a part from conveyor_a to cnc_04" \
+  "Use a UR5e to load BOX_101 from conveyor_a to cnc_04. Simulate and verify the plan." \
   --provider openai --model <model-id>
 devagent-physical-ai engineer \
-  "Use a UR5e to move a part from conveyor_a to cnc_04" \
+  "Use a UR5e to load BOX_101 from conveyor_a to cnc_04. Simulate and verify the plan." \
   --provider openai --model <model-id>
 ```
 

{devagent_physical_engine-0.11.2 → devagent_physical_engine-0.11.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devagent-physical-engine"
-version = "0.11.2"
+version = "0.11.3"
 description = "Verification-first agentic planning runtime for robotic and industrial automation."
 readme = "README.md"
 requires-python = ">=3.11"

{devagent_physical_engine-0.11.2 → devagent_physical_engine-0.11.3}/src/devagent_physical_engine/__init__.py

@@ -41,4 +41,4 @@ __all__ = [
     "TwinValidator",
 ]
 
-__version__ = "0.11.2"
+__version__ = "0.11.3"

{devagent_physical_engine-0.11.2 → devagent_physical_engine-0.11.3}/src/devagent_physical_engine/provider_adapters/openai.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Any, Callable
+from typing import Any, Callable, Mapping
 
 from ..agent.contracts import ModelRequest, ModelResponse
 from ..agent.runtime import ProviderError, ProviderProtocolError, ProviderUnavailable
@@ -17,6 +17,86 @@ from .common import (
 )
 
 
+def _nullable_openai_schema(value: Mapping[str, Any]) -> dict[str, Any]:
+    """Return an OpenAI-strict-compatible nullable schema for an optional field."""
+
+    result = dict(value)
+    schema_type = result.get("type")
+    if isinstance(schema_type, str):
+        if schema_type != "null":
+            result["type"] = [schema_type, "null"]
+        return result
+    if isinstance(schema_type, list):
+        types = list(schema_type)
+        if "null" not in types:
+            types.append("null")
+        result["type"] = types
+        return result
+
+    enum = result.get("enum")
+    if isinstance(enum, list):
+        values = list(enum)
+        if None not in values:
+            values.append(None)
+        result["enum"] = values
+        return result
+
+    any_of = result.get("anyOf")
+    if isinstance(any_of, list):
+        branches = list(any_of)
+        if not any(
+            isinstance(branch, Mapping) and branch.get("type") == "null"
+            for branch in branches
+        ):
+            branches.append({"type": "null"})
+        result["anyOf"] = branches
+        return result
+
+    return {"anyOf": [result, {"type": "null"}]}
+
+
+def _openai_strict_schema(schema: Mapping[str, Any]) -> dict[str, Any]:
+    """Normalize a provider-neutral schema for OpenAI strict Structured Outputs.
+
+    DevAgent's core schemas intentionally permit omitted optional fields because
+    Anthropic, Gemini, and deterministic parsers support that representation.
+    OpenAI strict Structured Outputs instead requires every property of every
+    object to appear in ``required``. Preserve provider-neutral core semantics by
+    making only those originally optional properties nullable in the OpenAI
+    transport schema, while keeping deterministic parsing/compilation as the
+    final authority.
+    """
+
+    clean = provider_schema(schema)
+
+    def normalize(value: Any) -> Any:
+        if isinstance(value, list):
+            return [normalize(item) for item in value]
+        if not isinstance(value, dict):
+            return value
+
+        result = {key: normalize(item) for key, item in value.items()}
+        properties = result.get("properties")
+        if isinstance(properties, dict):
+            required_raw = result.get("required", [])
+            required = set(required_raw) if isinstance(required_raw, list) else set()
+            normalized_properties: dict[str, Any] = {}
+            for name, property_schema in properties.items():
+                if name in required or not isinstance(property_schema, Mapping):
+                    normalized_properties[name] = property_schema
+                else:
+                    normalized_properties[name] = _nullable_openai_schema(property_schema)
+            result["properties"] = normalized_properties
+            result["required"] = list(normalized_properties)
+            result["additionalProperties"] = False
+        return result
+
+    normalized = normalize(clean)
+    if not isinstance(normalized, dict):  # pragma: no cover - schema contract is mapping
+        raise TypeError("openai_schema_must_be_object")
+    return normalized
+
+
 class OpenAIProvider:
     provider_name = "openai"
 
@@ -58,7 +138,7 @@ class OpenAIProvider:
                         "type": "json_schema",
                         "name": f"devagent_{request.role.value}",
                         "strict": True,
-                        "schema": provider_schema(request.output_schema),
+                        "schema": _openai_strict_schema(request.output_schema),
                     }
                 },
                 max_output_tokens=self._max_output_tokens,

{devagent_physical_engine-0.11.2 → devagent_physical_engine-0.11.3/src/devagent_physical_engine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devagent-physical-engine
-Version: 0.11.2
+Version: 0.11.3
 Summary: Verification-first agentic planning runtime for robotic and industrial automation.
 Author: Tom Ha
 License: All Rights Reserved
@@ -49,10 +49,12 @@ DevAgent Smart Physical Engine adds AI-assisted engineering to existing automati
 
 ## Current version
 
-**v0.11.2 — Beta software / evidence-gated physical runtime**
+**v0.11.3 — Beta software / evidence-gated physical runtime**
 
 The Python software stack is regression-tested on Python 3.11, 3.12, and 3.13 with separate static/coverage, package-install, and runtime dependency security gates. The UR5e Gazebo/MoveIt path now contains production-candidate continuous-clearance, tool-collision, and workpiece-lifecycle capabilities, but those physical-simulation scopes remain **EXPERIMENTAL until the executable target-workstation v0.11 campaign passes**.
 
+v0.11.3 also normalizes provider-neutral agent schemas at the OpenAI transport boundary so strict Structured Outputs can represent DevAgent optional fields without changing Anthropic/Gemini or deterministic core semantics.
+
 Real robot execution remains locked. Functional-safety certification and site qualification are not claimed.
 
 ## v0.11 capability status
@@ -195,16 +197,16 @@ export ANTHROPIC_API_KEY='...'
 export GEMINI_API_KEY='...'
 ```
 
-Examples:
+Examples use the currently supported deterministic goal action `load`:
 
 ```bash
 devagent-physical-ai doctor --provider openai
 devagent-physical-ai qualify --provider openai --model <model-id>
 devagent-physical-ai request \
-  "Use a UR5e to move a part from conveyor_a to cnc_04" \
+  "Use a UR5e to load BOX_101 from conveyor_a to cnc_04. Simulate and verify the plan." \
   --provider openai --model <model-id>
 devagent-physical-ai engineer \
-  "Use a UR5e to move a part from conveyor_a to cnc_04" \
+  "Use a UR5e to load BOX_101 from conveyor_a to cnc_04. Simulate and verify the plan." \
   --provider openai --model <model-id>
 ```
 

{devagent_physical_engine-0.11.2 → devagent_physical_engine-0.11.3}/src/devagent_physical_engine.egg-info/SOURCES.txt

@@ -106,6 +106,7 @@ tests/test_interpreter_profiles_v08.py
 tests/test_live_provider_qualification.py
 tests/test_measured_motion_v10.py
 tests/test_natural_language_agent_v07.py
+tests/test_openai_strict_schema_v0113.py
 tests/test_optimization_v05.py
 tests/test_physical_campaign_v09.py
 tests/test_physical_evidence_v09.py

devagent_physical_engine-0.11.3/tests/test_openai_strict_schema_v0113.py

@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+import unittest
+from typing import Any
+
+from devagent_physical_engine.agent.compiler import AGENT_PLAN_SCHEMA
+from devagent_physical_engine.agent.structured import CRITIQUE_SCHEMA, RECOVERY_SCHEMA
+from devagent_physical_engine.engineering_request import ENGINEERING_REQUEST_SCHEMA
+from devagent_physical_engine.provider_adapters.openai import _openai_strict_schema
+
+
+class OpenAIStrictSchemaV0113Tests(unittest.TestCase):
+    def assert_strict_objects(self, value: Any) -> None:
+        if isinstance(value, list):
+            for item in value:
+                self.assert_strict_objects(item)
+            return
+        if not isinstance(value, dict):
+            return
+
+        properties = value.get("properties")
+        if isinstance(properties, dict):
+            self.assertEqual(set(value.get("required", [])), set(properties))
+            self.assertIs(value.get("additionalProperties"), False)
+
+        for child in value.values():
+            self.assert_strict_objects(child)
+
+    def test_all_live_agent_schemas_are_openai_strict_compatible(self):
+        for schema in (
+            ENGINEERING_REQUEST_SCHEMA,
+            AGENT_PLAN_SCHEMA,
+            CRITIQUE_SCHEMA,
+            RECOVERY_SCHEMA,
+        ):
+            with self.subTest(schema=id(schema)):
+                self.assert_strict_objects(_openai_strict_schema(schema))
+
+    def test_planner_optional_fields_become_required_nullable_transport_fields(self):
+        original_task = AGENT_PLAN_SCHEMA["properties"]["tasks"]["items"]
+        self.assertNotIn("depends_on", original_task["required"])
+
+        strict = _openai_strict_schema(AGENT_PLAN_SCHEMA)
+        task = strict["properties"]["tasks"]["items"]
+        self.assertEqual(set(task["required"]), set(task["properties"]))
+        self.assertIn("null", task["properties"]["depends_on"]["type"])
+        self.assertIn("null", task["properties"]["object_id"]["type"])
+        self.assertIn("null", task["properties"]["source"]["type"])
+        self.assertIn("null", task["properties"]["destination"]["type"])
+
+        # Provider-specific normalization must not mutate the provider-neutral core schema.
+        self.assertNotIn("depends_on", original_task["required"])
+        self.assertEqual(original_task["properties"]["depends_on"]["type"], "array")
+
+    def test_recovery_optional_retry_field_is_required_nullable_for_openai_only(self):
+        self.assertNotIn("retry_after_ms", RECOVERY_SCHEMA["required"])
+
+        strict = _openai_strict_schema(RECOVERY_SCHEMA)
+        self.assertIn("retry_after_ms", strict["required"])
+        retry_type = strict["properties"]["retry_after_ms"]["type"]
+        self.assertIn("integer", retry_type)
+        self.assertIn("null", retry_type)
+
+        self.assertNotIn("retry_after_ms", RECOVERY_SCHEMA["required"])
+
+
+if __name__ == "__main__":
+    unittest.main()