Skip to main content

Crate agecli_skill_protocol

Crate agecli_skill_protocol 

Source
Expand description

Wire protocol contract for agecli skill ↔ host UDS communication.

This crate defines the binary message framing and JSON payload types used between the agecli host and skill processes. It is the shared contract consumed by both:

  • the host workspace (via agecli-skill-runtime for skill orchestration), and
  • the skills workspace (via agecli-skill-sdk for skill implementations).

Wire format: [type: u32 BE][length: u32 BE][payload: JSON bytes]

This crate has no dependencies on other agecli-* crates. Changes to this crate constitute a breaking wire-protocol change and must be versioned accordingly (semver).

Structs§

AckPayload
Skill→Server: acknowledge an Execute/StartSession request.
CompletedPayload
Skill→Server: execution completed.
DataChunkPayload
Skill→Server: a chunk of stdout or stderr data.
ErrorPayload
Skill→Server: error response.
ExecutePayload
Server→Skill: execute a command.
ProgressPayload
Skill→Server: progress update.
ProxyChunkPayload
Host→Skill: a chunk of proxied stdout (202) or stderr (203) output.
ProxyCompletedPayload
Host→Skill: a proxied submission completed (204).
ProxyRejectedPayload
Server↔Skill: a proxied submission was rejected.
ProxySubmitPayload
Server↔Skill: submit a command via the proxy relay.
ProxyTarget
Target of a proxied submission.
ResizePayload
Server→Skill: resize terminal.
SessionStartedPayload
Skill→Server: interactive session started.
SignalPayload
Server→Skill: send signal to process.
SkillMessage
A raw skill message with type and payload bytes.
SkillMessageReader
Reads binary-framed skill messages from a stream.
SkillMessageWriter
Writes binary-framed skill messages to a stream.
StartSessionPayload
Server→Skill: start an interactive session (PTY).
StdinDataPayload
Server→Skill: stdin data for an active execution or session.

Enums§

SkillMessageType
Message types for skill ↔ server communication.