Expand description
Method-name string constants for the KLP v1 namespace (SPEC §2.12.5).
Centralised so the agent dispatcher and client call sites refer
to the same string literal — a typo on either side becomes a
compile error instead of a silent MethodNotFound at runtime.
The constants intentionally mirror the SPEC table 1:1; future v2 method additions add a new entry here, never edit an existing one (the protocol-version handshake in §2.12.6 is the deprecation path).
Constants§
- JOBS_
EXECUTE - Execute one of the listed jobs. Returns the synthesised
run_id. - JOBS_
KILL - Kill a run started via
jobs.executeon THIS connection (SPEC §2.12.4 — cross-connection kill isUnauthorized). - JOBS_
LIST - List manifests with
user_invokable: true(filter: category). - JOBS_
PROGRESS - Push (Agent → Client) with stdout/stderr chunks + status changes.
- JOBS_
SUBSCRIBE - Start streaming
jobs.progresspushes for this connection. - JOBS_
UNSUBSCRIBE - Stop streaming
jobs.progresspushes. - MAINTENANCE_
DEFER - User-initiated reboot-deferral (15m / 30m / 1h per SPEC §2.1).
- MAINTENANCE_
LIST - List the next N days’ scheduled jobs targeted at this PC.
- NOTIFICATIONS_
ACK - Mark a notification read for this user — agent publishes
events.notifications.acked.>on NATS with the OS-derived SID. - NOTIFICATIONS_
LIST - Paginated past-notifications listing (filter: unread/all).
- NOTIFICATIONS_
NEW - Push (Agent → Client) carrying a new notification.
- NOTIFICATIONS_
SUBSCRIBE - Start streaming
notifications.newpushes for this connection. - NOTIFICATIONS_
UNSUBSCRIBE - Stop streaming
notifications.newpushes. - STATE_
CHANGED - Push (Agent → Client) when health / vpn / version etc. flips.
- STATE_
SNAPSHOT - One-shot bundle of health + inventory + compliance checks.
- STATE_
SUBSCRIBE - Start streaming
state.changedpushes for this connection. - STATE_
UNSUBSCRIBE - Stop streaming
state.changedpushes (the matching unsubscribe). - SUPPORT_
UPLOAD_ DIAGNOSTICS - Bundle recent inventory + log tail + agent state, upload to the JetStream Object Store, return the resulting ticket / object id.
- SYSTEM_
HANDSHAKE - Handshake — every connection’s first request. SPEC §2.12.6.
- SYSTEM_
LOG_ TAIL - Last N lines of
agent.logfor support handoff (SPEC §2.12.5). - SYSTEM_
PING - Liveness check. No params, no return value beyond ack.
- SYSTEM_
VERSION - Returns the agent’s binary version + git rev.