kami
67 lines
2.1 KiB
Go
67 lines
2.1 KiB
Go
// worker/frame.go — length-prefixed JSON framing.
|
|
//
|
|
// Identical shape to internal/ipc/frame.go with one difference: the cap is
|
|
// 64 MiB here vs 4 there. Audio bytes (base64-encoded in JSON) push frame
|
|
// sizes up to ~80% over their decoded size; 64 MiB on the wire comfortably
|
|
// allows minutes-long single utterances, while still bounding a confused
|
|
// peer's length prefix from allocating an unbounded buffer.
|
|
//
|
|
// Binary bytes are base64-encoded inside the JSON envelope. Local socket
|
|
// + single-user scale ⇒ the 33% expansion cost is invisible vs. a model
|
|
// forward pass; the benefit is one debuggable wire shape (socat shows a
|
|
// readable JSON frame, no separate byte-pump to inspect audio).
|
|
package worker
|
|
|
|
import (
|
|
"encoding/binary"
|
|
"encoding/json"
|
|
"errors"
|
|
"fmt"
|
|
"io"
|
|
)
|
|
|
|
// ErrFrameTooLarge — a frame exceeded maxFrame; the conn is now
|
|
// desynchronized (we read the length but not the body), so the caller must
|
|
// close it.
|
|
var ErrFrameTooLarge = errors.New("worker: frame too large")
|
|
|
|
func writeFrame(w io.Writer, v any) error {
|
|
body, err := json.Marshal(v)
|
|
if err != nil {
|
|
return fmt.Errorf("worker: marshal frame: %w", err)
|
|
}
|
|
if len(body) > maxFrame {
|
|
return fmt.Errorf("%w: %d bytes", ErrFrameTooLarge, len(body))
|
|
}
|
|
var hdr [4]byte
|
|
binary.BigEndian.PutUint32(hdr[:], uint32(len(body)))
|
|
if _, err := w.Write(hdr[:]); err != nil {
|
|
return fmt.Errorf("worker: write frame header: %w", err)
|
|
}
|
|
if _, err := w.Write(body); err != nil {
|
|
return fmt.Errorf("worker: write frame body: %w", err)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func readFrame(r io.Reader, v any) error {
|
|
var hdr [4]byte
|
|
if _, err := io.ReadFull(r, hdr[:]); err != nil {
|
|
if errors.Is(err, io.EOF) {
|
|
return io.EOF
|
|
}
|
|
return fmt.Errorf("worker: read frame header: %w", err)
|
|
}
|
|
n := binary.BigEndian.Uint32(hdr[:])
|
|
if n > maxFrame {
|
|
return fmt.Errorf("%w: %d bytes", ErrFrameTooLarge, n)
|
|
}
|
|
buf := make([]byte, n)
|
|
if _, err := io.ReadFull(r, buf); err != nil {
|
|
return fmt.Errorf("worker: read frame body: %w", err)
|
|
}
|
|
if err := json.Unmarshal(buf, v); err != nil {
|
|
return fmt.Errorf("worker: unmarshal frame: %w", err)
|
|
}
|
|
return nil
|
|
} |