Coverage for src/governed_harness/plugins/protocol.py: 100%

38 statements  

« prev     ^ index     » next       coverage.py v7.17.2, created at 2026-11-12 16:06 +0000

1from __future__ import annotations 

2 

3from typing import Any, Literal 

4 

5from pydantic import BaseModel, ConfigDict, Field 

6 

7from governed_harness.domain.enums import ResultStatus 

8 

9 

10class ProtocolModel(BaseModel): 

11 model_config = ConfigDict(extra="forbid", frozen=True, populate_by_name=True) 

12 

13 

14class PluginDescriptor(ProtocolModel): 

15 plugin_id: str = Field(alias="pluginId") 

16 plugin_version: str = Field(alias="pluginVersion") 

17 protocol_version: Literal["1.0"] = Field(alias="protocolVersion") 

18 digest: str | None = None 

19 operations: tuple[ 

20 Literal[ 

21 "handshake", 

22 "detect", 

23 "describeCapabilities", 

24 "plan", 

25 "execute", 

26 "interpret", 

27 "health", 

28 "cleanup", 

29 ], 

30 ..., 

31 ] 

32 capabilities: tuple[str, ...] = () 

33 result_schemas: tuple[str, ...] = Field(default=(), alias="resultSchemas") 

34 supported_platforms: tuple[str, ...] = Field(default=(), alias="supportedPlatforms") 

35 

36 

37class PluginRequest(ProtocolModel): 

38 protocol_version: Literal["1.0"] = Field(default="1.0", alias="protocolVersion") 

39 request_id: str = Field(alias="requestId") 

40 operation: str 

41 deadline: str | None = None 

42 context: dict[str, Any] = Field(default_factory=dict) 

43 capability_grant: dict[str, Any] = Field(default_factory=dict, alias="capabilityGrant") 

44 payload: dict[str, Any] = Field(default_factory=dict) 

45 

46 

47class PluginResponse(ProtocolModel): 

48 protocol_version: Literal["1.0"] = Field(default="1.0", alias="protocolVersion") 

49 request_id: str = Field(alias="requestId") 

50 status: ResultStatus 

51 kind: str 

52 summary: str 

53 payload: dict[str, Any] = Field(default_factory=dict) 

54 evidence: tuple[str, ...] = () 

55 findings: tuple[str, ...] = () 

56 errors: tuple[dict[str, Any], ...] = () 

57 

58 

59PLUGIN_EXIT_PROTOCOL_ERROR = 10 

60PLUGIN_EXIT_CONFIGURATION_ERROR = 11 

61PLUGIN_EXIT_INTERNAL_ERROR = 12 

62PLUGIN_EXIT_TIMEOUT = 124 

63PLUGIN_EXIT_CANCELLED = 130