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-runtimefor skill orchestration), and - the skills workspace (via
agecli-skill-sdkfor 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.
- Completed
Payload - Skill→Server: execution completed.
- Data
Chunk Payload - Skill→Server: a chunk of stdout or stderr data.
- Error
Payload - Skill→Server: error response.
- Execute
Payload - Server→Skill: execute a command.
- Progress
Payload - Skill→Server: progress update.
- Proxy
Chunk Payload - Host→Skill: a chunk of proxied stdout (202) or stderr (203) output.
- Proxy
Completed Payload - Host→Skill: a proxied submission completed (204).
- Proxy
Rejected Payload - Server↔Skill: a proxied submission was rejected.
- Proxy
Submit Payload - Server↔Skill: submit a command via the proxy relay.
- Proxy
Target - Target of a proxied submission.
- Resize
Payload - Server→Skill: resize terminal.
- Session
Started Payload - Skill→Server: interactive session started.
- Signal
Payload - Server→Skill: send signal to process.
- Skill
Message - A raw skill message with type and payload bytes.
- Skill
Message Reader - Reads binary-framed skill messages from a stream.
- Skill
Message Writer - Writes binary-framed skill messages to a stream.
- Start
Session Payload - Server→Skill: start an interactive session (PTY).
- Stdin
Data Payload - Server→Skill: stdin data for an active execution or session.
Enums§
- Skill
Message Type - Message types for skill ↔ server communication.