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
« prev ^ index » next coverage.py v7.17.2, created at 2026-11-12 16:06 +0000
1from __future__ import annotations
3from typing import Any, Literal
5from pydantic import BaseModel, ConfigDict, Field
7from governed_harness.domain.enums import ResultStatus
10class ProtocolModel(BaseModel):
11 model_config = ConfigDict(extra="forbid", frozen=True, populate_by_name=True)
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")
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)
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], ...] = ()
59PLUGIN_EXIT_PROTOCOL_ERROR = 10
60PLUGIN_EXIT_CONFIGURATION_ERROR = 11
61PLUGIN_EXIT_INTERNAL_ERROR = 12
62PLUGIN_EXIT_TIMEOUT = 124
63PLUGIN_EXIT_CANCELLED = 130