ZacharyZhang-NY
a02b555e66
Sweep every first-party crate source (1956 .rs files) to the project comment guidelines: delete redundant restatements, decorative banners, change narration, and end-of-line comments; keep and tighten the crucial ones (invariants, bug rationale, SAFETY blocks, ported-source attribution). No functional code changed. Every edit is proven comment-only against the prior tree by a comment-stripping lexer (string/char/raw-string aware) plus a separate doctest-fence check. Where removing a comment made rustfmt or clippy want to re-lay-out adjacent code, the minimal triggering comment is restored so code tokens stay byte-identical. Gates green: cargo fmt --all --check (0 diffs), cargo check and cargo clippy --workspace --all-targets (0 warnings). Adds scripts/check_codegen_comment_guidelines.py — the enforcement gate for these guidelines (flags banners, end-of-line comments, change narration, and commented-out code).
68 lines
2.9 KiB
Rust
68 lines
2.9 KiB
Rust
//! Tool wire-protocol types.
|
|
|
|
#![forbid(unsafe_code)]
|
|
|
|
mod capabilities;
|
|
mod connection;
|
|
pub mod envelope;
|
|
pub mod error_codes;
|
|
pub mod error_wire;
|
|
pub mod frames;
|
|
mod handshake;
|
|
mod hook;
|
|
mod ids;
|
|
pub mod methods;
|
|
pub mod notification_wire;
|
|
pub mod output_wire;
|
|
mod registration;
|
|
mod registry_error;
|
|
pub mod session_event;
|
|
pub mod turn_hook;
|
|
|
|
pub use capabilities::{HookKind, NotificationSchemas, StreamingSpec, ToolCapabilities, ToolScope};
|
|
pub use connection::{ConnectionKind, ToolDefinitionMode};
|
|
pub use envelope::{
|
|
JsonRpcError, JsonRpcId, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcVersion,
|
|
ResponseOutcome,
|
|
};
|
|
pub use error_codes::{
|
|
ERROR_CODES, WORKSPACE_UNAVAILABLE_JSONRPC_CODE, WORKSPACE_UNAVAILABLE_MESSAGE,
|
|
WORKSPACE_UNAVAILABLE_SUBCODE, WorkspaceGonePhase, WorkspaceGoneReason,
|
|
WorkspaceUnavailableDetails, workspace_unavailable_wire,
|
|
};
|
|
pub use error_wire::ToolErrorWire;
|
|
pub use frames::{
|
|
AttachRoute, HookFrame, HookReplyFrame, LastSeq, LogsDonateParams, MAX_DONATION_BYTES,
|
|
MAX_LOG_RECORDS_PER_DONATION, MAX_METRICS_PER_DONATION, MAX_SPANS_PER_DONATION,
|
|
MAX_SYSTEM_NOTIFY_PAYLOAD_BYTES, MetricsDonateParams, NotificationFilter, PingFrame, PongFrame,
|
|
ServeParams, ServeResult, ServerBindAck, ServerBindOutcome, ServerBindParams, ServerInfo,
|
|
ServerUnbindAck, ServerUnbindOutcome, ServerUnbindParams, ServersListParams, ServersListResult,
|
|
SessionAttachServerParams, SessionAttachServerResult, SessionBindParams, SessionBindResult,
|
|
SessionBindServerParams, SessionBindServerResult, SessionCloseParams, SessionOpenParams,
|
|
SessionOpenResult, SessionUnbindParams, SessionUnbindServerParams, SubscribeAck,
|
|
SubscribeNotificationsParams, SubscribeOutcome, SystemNotifyParams, ToolCallParams,
|
|
ToolCallProgressFrame, ToolCallResult, ToolNotificationFrame, ToolSearchResult,
|
|
ToolServerConnectionStatus, ToolServerDisconnectReason, ToolServerEvictParams,
|
|
ToolServerGetStatusParams, ToolServerGetStatusResult, ToolServerLifecycleStatus,
|
|
ToolServerStatusPayload, ToolsChanged, ToolsListParams, ToolsListResult, ToolsSearchParams,
|
|
ToolsSearchResultBody, TracesDonateParams, UnsubscribeAck, UnsubscribeNotificationsParams,
|
|
UnsubscribeOutcome,
|
|
};
|
|
pub use handshake::{HelloAckMsg, HelloMsg, PROTOCOL_VERSION};
|
|
pub use hook::HookEvent;
|
|
pub use ids::{
|
|
ConnectionId, FrameSeq, IdError, RequestId, ServerId, SessionId, ToolCallId, ToolId, UserId,
|
|
};
|
|
pub use methods::{Method, UNKNOWN_METHOD_MSG_PREFIX};
|
|
pub use notification_wire::{
|
|
KNOWN_NOTIFICATION_KINDS, KnownVariantCollision, WireCustomNotification, WireToolNotification,
|
|
check_custom_kind, known_notification_kinds,
|
|
};
|
|
pub use output_wire::{McpBlock, ToolOutputWire};
|
|
pub use registration::{
|
|
RegistrationOutcome, ToolDescriptionWithSchema, ToolRegistration, ToolServerRegistration,
|
|
TransportKind,
|
|
};
|
|
pub use registry_error::RegistryError;
|
|
pub use session_event::{SessionEvent, SessionPhase, ToolCallOutcome};
|