consciousness/schema/daemon.capnp
ProofOfConcept d0080698f3 cli: switch to clap, add notify-timeout, improve status display
Replace manual arg parsing with clap derive for the full command set.
Single source of truth for command names, args, and help text.

Add notify_timeout (default 2min) — controls how long after last
response before notifications inject via tmux instead of waiting
for the hook. Separate from idle_timeout (5min) which controls
autonomous prompts.

Improve `poc-daemon status` to show both timers with elapsed/configured
and block reason, replacing the terse one-liner.

Add new Status fields over capnp: idleTimeout, notifyTimeout,
sinceActivity, sinceUser, blockReason.

ExecStart in poc-daemon.service now uses `daemon` subcommand.

Co-Authored-By: ProofOfConcept <poc@bcachefs.org>
2026-03-05 21:32:27 -05:00

77 lines
2.3 KiB
Cap'n Proto

@0xb8e2f4a1c3d56789;
# Claude daemon RPC interface.
#
# Served over a Unix domain socket. Clients connect, bootstrap
# the Daemon interface, make calls, disconnect.
struct Notification {
type @0 :Text;
urgency @1 :UInt8;
message @2 :Text;
timestamp @3 :Float64;
}
struct TypeInfo {
name @0 :Text;
count @1 :UInt64;
firstSeen @2 :Float64;
lastSeen @3 :Float64;
threshold @4 :Int8; # -1 = inherit, 0-3 = explicit level
}
enum Activity {
idle @0;
focused @1;
sleeping @2;
}
struct Status {
lastUserMsg @0 :Float64;
lastResponse @1 :Float64;
claudePane @2 :Text;
sleepUntil @3 :Float64; # 0 = not sleeping, -1 = indefinite
quietUntil @4 :Float64;
consolidating @5 :Bool;
dreaming @6 :Bool;
fired @7 :Bool;
kentPresent @8 :Bool;
uptime @9 :Float64;
activity @10 :Activity;
pendingCount @11 :UInt32;
idleTimeout @12 :Float64; # configured idle timeout (secs)
notifyTimeout @13 :Float64; # configured notify-via-tmux timeout (secs)
sinceActivity @14 :Float64; # secs since max(lastUserMsg, lastResponse)
sinceUser @15 :Float64; # secs since lastUserMsg
blockReason @16 :Text; # why idle timer hasn't fired
}
interface Daemon {
# Idle timer
user @0 (pane :Text) -> ();
response @1 (pane :Text) -> ();
sleep @2 (until :Float64) -> (); # 0 = indefinite
wake @3 () -> ();
quiet @4 (seconds :UInt32) -> ();
consolidating @5 () -> ();
consolidated @6 () -> ();
dreamStart @7 () -> ();
dreamEnd @8 () -> ();
stop @9 () -> ();
status @10 () -> (status :Status);
# Notifications
notify @11 (notification :Notification) -> (interrupt :Bool);
getNotifications @12 (minUrgency :UInt8) -> (notifications :List(Notification));
getTypes @13 () -> (types :List(TypeInfo));
setThreshold @14 (type :Text, level :UInt8) -> ();
idleTimeout @16 (seconds :Float64) -> ();
notifyTimeout @19 (seconds :Float64) -> ();
save @17 () -> ();
debug @18 () -> (json :Text);
# Modules
moduleCommand @15 (module :Text, command :Text, args :List(Text))
-> (result :Text);
}