Module plugin 

Plugin protocol DTOs shared across plugin boundaries. Wire-format DTOs for the plugin protocol.

This module exists to define the stable boundary between osp-cli and external plugins. The app and plugin manager can evolve internally, but the JSON shapes in this module are the contract that both sides need to agree on.

In broad terms:

• Describe* types advertise commands, arguments, and policy metadata
• Response* types carry execution results, messages, and render hints
• validation helpers reject protocol-shape errors before higher-level code tries to trust the payload

Contract:

• these types may depend on shared core metadata, but they should stay free of host runtime concerns
• any parsing/validation here should enforce protocol rules, not business policy
• caller-facing docs should describe stable wire behavior rather than internal plugin manager details

Structs

DescribeArgV1

Positional argument description emitted by a plugin.

DescribeCommandAuthV1

Authorization metadata attached to a described command.

DescribeCommandV1

Recursive command description used in plugin metadata.

DescribeFlagV1

Flag description emitted by a plugin.

DescribeSuggestionV1

Suggested value emitted in plugin metadata.

DescribeV1

describe payload emitted by a plugin that speaks protocol v1.

ResponseErrorV1

Structured error payload returned when ok is false.

ResponseMessageV1

User-facing message emitted alongside a plugin response.

ResponseMetaV1

Rendering hints attached to a plugin response.

ResponseV1

Protocol v1 command response envelope.

Enums

ColumnAlignmentV1

Column alignment hint used in plugin response metadata.

DescribeValueTypeV1

Wire-format type hint for plugin argument values.

DescribeVisibilityModeV1

Wire-format visibility mode used by plugin metadata.

ResponseMessageLevelV1

Message severity carried in plugin responses.

Constants

PLUGIN_PROTOCOL_V1

Current plugin wire protocol version understood by this crate.