feat(server,sdk): Control Templates

engine/src/agent_control_engine/core.py

@@ -15,8 +15,9 @@
 from agent_control_evaluators import get_evaluator_instance
 from agent_control_models import (
     ConditionNode,
-    ControlDefinition,
+    ControlAction,
     ControlMatch,
+    ControlScope,
     EvaluationRequest,
     EvaluationResponse,
     EvaluatorResult,
@@ -42,12 +43,30 @@ def _compile_regex(pattern: str) -> Any:
     return re2.compile(pattern)
 
 
+class ControlDefinitionLike(Protocol):
+    """Runtime control shape required by the engine."""
+
+    enabled: bool
+    execution: Literal["server", "sdk"]
+    scope: ControlScope
+    condition: ConditionNode
+    action: ControlAction
+
+
 class ControlWithIdentity(Protocol):
     """Protocol for a control with identity information."""
 
-    id: int
-    name: str
-    control: ControlDefinition
+    @property
+    def id(self) -> int:
+        """Database identity for the control."""
+
+    @property
+    def name(self) -> str:
+        """Human-readable name for the control."""
+
+    @property
+    def control(self) -> ControlDefinitionLike:
+        """Runtime control payload used during evaluation."""
 
 
 @dataclass

models/src/agent_control_models/__init__.py

@@ -24,15 +24,28 @@
     StepSchema,
 )
 from .controls import (
+    BooleanTemplateParameter,
     ConditionNode,
     ControlAction,
     ControlDefinition,
+    ControlDefinitionRuntime,
     ControlMatch,
     ControlScope,
     ControlSelector,
+    EnumTemplateParameter,
     EvaluatorResult,
     EvaluatorSpec,
+    JsonValue,
+    RegexTemplateParameter,
     SteeringContext,
+    StringListTemplateParameter,
+    StringTemplateParameter,
+    TemplateControlInput,
+    TemplateDefinition,
+    TemplateParameterBase,
+    TemplateParameterDefinition,
+    TemplateValue,
+    UnrenderedTemplateControl,
 )
 from .errors import (
     ERROR_TITLES,
@@ -80,6 +93,8 @@
     PaginationInfo,
     PatchControlRequest,
     PatchControlResponse,
+    RenderControlTemplateRequest,
+    RenderControlTemplateResponse,
     StepKey,
     ValidateControlDataRequest,
     ValidateControlDataResponse,
@@ -111,9 +126,22 @@
     "ControlMatch",
     "ControlScope",
     "ControlSelector",
+    "ControlDefinitionRuntime",
     "EvaluatorSpec",
     "EvaluatorResult",
     "SteeringContext",
+    "JsonValue",
+    "TemplateValue",
+    "TemplateParameterBase",
+    "StringTemplateParameter",
+    "StringListTemplateParameter",
+    "EnumTemplateParameter",
+    "BooleanTemplateParameter",
+    "RegexTemplateParameter",
+    "TemplateParameterDefinition",
+    "TemplateDefinition",
+    "TemplateControlInput",
+    "UnrenderedTemplateControl",
     "normalize_action",
     "normalize_action_list",
     "expand_action_filter",
@@ -142,6 +170,8 @@
     "PaginationInfo",
     "PatchControlRequest",
     "PatchControlResponse",
+    "RenderControlTemplateRequest",
+    "RenderControlTemplateResponse",
     "StepKey",
     "ValidateControlDataRequest",
     "ValidateControlDataResponse",