node

type Config struct {
	// Home is the state directory (~/.awp by default in the CLI).
	Home string

	// Name and About are sent in hello.
	Name  string
	About string

	// Model is the model the agent runs on (claude-opus-5-5, gpt-5.5, ...),
	// shared in presence. The agent or its harness hooks report it, and it
	// can change while the node runs (SetModel). Remembered like the name.
	Model string

	// ShareWith lists the keys of hosts to mirror this node's conversations
	// to (wire/mirror.go). Nil keeps what was set before; empty stops.
	ShareWith []string

	// Harness is the agent harness this node runs in (internal/harness),
	// shared in presence. Remembered like the name.
	Harness string
	// DetectedHarness is the fallback when no harness was ever set: the one
	// the environment of whoever started the node points to. It is not
	// remembered, since the next start may come from another harness.
	DetectedHarness string

	// Listen lists addresses to accept connections on: "tailcat",
	// "tcp:host:port" or "unix:/path".
	Listen []string

	// Advertise is the address sent in hello.addr so the peer can dial us
	// back. Empty means the tailcat address if there is one, otherwise the
	// first listen address. "none" disables it.
	Advertise string

	PingInterval     time.Duration // idle time before a ping; default 30s
	HandshakeTimeout time.Duration // default 30s
	BlobLimit        int64         // largest blob accepted or sent; default 50 MiB
	OutboxTTL        time.Duration // outbox retention; default 7 days
	MaxBackoff       time.Duration // reconnect backoff cap; default 60s
	DialGrace        time.Duration // delay before dialing a hello-learned address; default 15s

	Policy Policy

	// Logf receives the daemon's log. Nil discards it.
	Logf func(format string, args ...any)
	// TailcatLogf receives tailcat's (verbose) diagnostics. Nil discards them.
	TailcatLogf func(format string, args ...any)
	// Trace logs every line sent and received.
	Trace bool
	// AllowPlaintext permits plain TCP to public addresses (see
	// transport.Transport.AllowPublicTCP).
	AllowPlaintext bool
	// Presence publishes this node's signed presence to its peers, who
	// gossip it on (presence.go). Receiving and forwarding other agents'
	// presence happens either way.
	Presence bool
}

type Conn struct {
	// contains filtered or unexported fields
}

type ConnInfo struct {
	Outbound bool          `json:"outbound"`
	Via      string        `json:"via"`
	Since    time.Time     `json:"since"`
	RTT      time.Duration `json:"rtt"` // last ping's round trip; zero until measured
}

type ExecRequest struct {
	Cmd     json.RawMessage   `json:"cmd"` // ["argv", ...] or "shell string"
	Cwd     string            `json:"cwd,omitempty"`
	Env     map[string]string `json:"env,omitempty"`
	Timeout float64           `json:"timeout,omitempty"` // seconds, default 600
	Stdin   string            `json:"stdin,omitempty"`
}

type FSReadRequest struct {
	Path   string `json:"path"`
	Offset int64  `json:"offset,omitempty"`
	Length int64  `json:"length,omitempty"`
}

type FSWriteRequest struct {
	Path     string `json:"path"`
	Content  string `json:"content"`
	Encoding string `json:"encoding,omitempty"` // "utf-8" (default) or "base64"
	Append   bool   `json:"append,omitempty"`
	Mkdir    bool   `json:"mkdir,omitempty"`
}

type Node struct {
	// contains filtered or unexported fields
}

type Policy struct {
	Accept string   `json:"accept,omitempty"` // AcceptAny or AcceptAllowlist
	Allow  []string `json:"allow,omitempty"`  // keys admitted under the allowlist
	Trust  []string `json:"trust,omitempty"`  // issuers whose grants we honor as our own

	// Serve lists capabilities this daemon fulfils by itself when a peer
	// with the matching grant asks (exec, fs:read, fs:write). Requests for
	// capabilities not listed here are delivered to the agent instead,
	// marked allowed or denied.
	Serve []string `json:"serve,omitempty"`
	// Root confines fs:read and fs:write and is the default working
	// directory for exec. Empty means the daemon's working directory.
	Root string `json:"root,omitempty"`
}

type Request struct {
	Part    int    `json:"part"`
	Mime    string `json:"mime"`
	Cap     string `json:"cap"`
	Allowed bool   `json:"allowed"`
	Served  bool   `json:"served,omitempty"`
}

type SendRequest struct {
	Peer    string      `json:"peer"`
	Th      string      `json:"th,omitempty"` // empty starts a new thread
	Subject string      `json:"subject,omitempty"`
	Re      string      `json:"re,omitempty"`
	Parts   []wire.Part `json:"parts,omitempty"`
	Files   []string    `json:"files,omitempty"` // attached as blobs
	// contains filtered or unexported fields
}

type SendResult struct {
	ID        string `json:"id"`
	Th        string `json:"th"`
	Peer      string `json:"peer"`
	NewThread bool   `json:"new_thread,omitempty"`
	Connected bool   `json:"connected"`
}