dsh-ask-peer

Configuration

The full schema lives in src/config.ts; the table below is the summary. The profile patch is the bootstrap; UI-owned knobs are persisted to /settings-.json and override these values live.

Key	Type	Default	Meaning
callerName	string	'local'	Identity presented to peers on outbound asks; peers allowlist this name.
keyDir	string	~/.dsh-ask-peer/keys	Directory holding this agent's Ed25519 signing keys (private key never leaves).
description	string	''	Self-advertised description shown to asking agents (what you know).
tags	string[]	[]	Self-advertised topic tags used by asking agents for peer selection.
rosterRefreshMs	number	60000	Roster refresh interval in ms; 0 disables periodic refresh (initial fetch still runs).
listen	boolean	false	Start the inbound ask server.
listenHost	string	'127.0.0.1'	Bind host for the ask server; keep loopback unless you trust the LAN.
listenPort	number	3877	Bind port for the ask server.
peers	PeerConfig[]	[]	Friends we may ask; also the inbound caller allowlist.
requireToken	boolean	true	Require a matching shared token on every inbound ask.
workspace	string	process.cwd()	Workspace the answering agent runs in.
provider	string	—	Provider route for answering agents; harness default when omitted.
model	string	—	Model for answering agents; harness default when omitted.
timeoutMs	number	120000	Default outbound ask timeout in ms.
maxAnswerChars	number	48000	Answer character cap; longer answers are cut and marked truncated.
approvalTimeoutMs	number	120000	How long an inbound ask in ask mode waits for the owner before failing closed.
allowExecution	boolean	false	Let ask-owned agents request tool permissions (future execute-mode hook; not wired yet).

Each PeerConfig entry:

Key	Type	Default	Meaning
name	string	—	Peer name, matching the peer's callerName on its own side.
host	string	—	Host or IP of the peer's ask server.
port	number	3877	Port of the peer's ask server.
token	string	—	Optional shared secret; the peer requires it when requireToken is on.
publicKey	string	—	The peer's sign (ed25519:...); replaces the shared token as the trust root (asks/adverts must be signed by it).
mode	'ask' | 'auto' | 'deny'	'ask'	Inbound policy for this friend.
description	string	—	Optional note describing whose agent this is.