@the-seeker/server-agent 0.1.0

package/dist/protocol.d.ts

@@ -0,0 +1,736 @@
+import { z } from "zod";
+export declare const PROTOCOL_VERSION = 1;
+export declare const MAX_HEARTBEAT_BYTES = 131072;
+export declare const MAX_RESPONSE_BYTES = 393216;
+export declare const LOG_LINES_OPTIONS: readonly [100, 200, 500];
+export declare const LOG_MAX_BYTES = 262144;
+export declare const REQUEST_TIMEOUT_MS = 20000;
+export declare const OFFLINE_AFTER_MS = 90000;
+export declare const PROCESS_HISTORY_INTERVAL_MS = 60000;
+export declare const SourceKindSchema: z.ZodEnum<{
+    pm2_out: "pm2_out";
+    pm2_err: "pm2_err";
+    nginx_access: "nginx_access";
+    nginx_error: "nginx_error";
+    systemd_journal: "systemd_journal";
+}>;
+export declare const SourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        pm2_out: "pm2_out";
+        pm2_err: "pm2_err";
+        nginx_access: "nginx_access";
+        nginx_error: "nginx_error";
+        systemd_journal: "systemd_journal";
+    }>;
+    label: z.ZodString;
+    group: z.ZodString;
+}, z.core.$strict>;
+export type SourceKind = z.infer<typeof SourceKindSchema>;
+export type Source = z.infer<typeof SourceSchema>;
+export declare function makeSourceId(kind: SourceKind, rawName: string): string;
+export declare const CapabilityStateSchema: z.ZodEnum<{
+    error: "error";
+    available: "available";
+    unsupported: "unsupported";
+    not_installed: "not_installed";
+    permission_denied: "permission_denied";
+}>;
+export declare const CapabilitiesSchema: z.ZodObject<{
+    host: z.ZodEnum<{
+        error: "error";
+        available: "available";
+        unsupported: "unsupported";
+        not_installed: "not_installed";
+        permission_denied: "permission_denied";
+    }>;
+    pm2: z.ZodEnum<{
+        error: "error";
+        available: "available";
+        unsupported: "unsupported";
+        not_installed: "not_installed";
+        permission_denied: "permission_denied";
+    }>;
+    systemd: z.ZodEnum<{
+        error: "error";
+        available: "available";
+        unsupported: "unsupported";
+        not_installed: "not_installed";
+        permission_denied: "permission_denied";
+    }>;
+    nginx: z.ZodEnum<{
+        error: "error";
+        available: "available";
+        unsupported: "unsupported";
+        not_installed: "not_installed";
+        permission_denied: "permission_denied";
+    }>;
+}, z.core.$strict>;
+export type CapabilityState = z.infer<typeof CapabilityStateSchema>;
+export type Capabilities = z.infer<typeof CapabilitiesSchema>;
+export declare const HostSchema: z.ZodObject<{
+    cpu_pct: z.ZodNullable<z.ZodNumber>;
+    cpu_count: z.ZodNumber;
+    load: z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    mem: z.ZodNullable<z.ZodObject<{
+        used: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strict>>;
+    swap: z.ZodNullable<z.ZodObject<{
+        used: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strict>>;
+    disks: z.ZodArray<z.ZodObject<{
+        mount: z.ZodString;
+        fs: z.ZodString;
+        used: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strict>>;
+    net: z.ZodObject<{
+        rx_bps: z.ZodNullable<z.ZodNumber>;
+        tx_bps: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    uptime_sec: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ProcessSchema: z.ZodObject<{
+    name: z.ZodString;
+    pm_id: z.ZodNumber;
+    status: z.ZodString;
+    cpu_pct: z.ZodNumber;
+    memory_bytes: z.ZodNumber;
+    restarts: z.ZodNumber;
+    unstable_restarts: z.ZodNumber;
+    uptime_ms: z.ZodNullable<z.ZodNumber>;
+    version: z.ZodNullable<z.ZodString>;
+    exec_mode: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const ServiceSchema: z.ZodObject<{
+    unit: z.ZodString;
+    active_state: z.ZodString;
+    sub_state: z.ZodString;
+}, z.core.$strict>;
+export type Host = z.infer<typeof HostSchema>;
+export type Process = z.infer<typeof ProcessSchema>;
+export type Service = z.infer<typeof ServiceSchema>;
+export declare const HelloFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    protocol_version: z.ZodLiteral<1>;
+    agent_version: z.ZodString;
+    hostname: z.ZodString;
+    os: z.ZodObject<{
+        platform: z.ZodEnum<{
+            linux: "linux";
+            darwin: "darwin";
+        }>;
+        release: z.ZodString;
+        arch: z.ZodString;
+    }, z.core.$strict>;
+    cpu_count: z.ZodNumber;
+    boot_time: z.ZodISODateTime;
+    capabilities: z.ZodObject<{
+        host: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        pm2: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        systemd: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        nginx: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+    }, z.core.$strict>;
+    sources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            pm2_out: "pm2_out";
+            pm2_err: "pm2_err";
+            nginx_access: "nginx_access";
+            nginx_error: "nginx_error";
+            systemd_journal: "systemd_journal";
+        }>;
+        label: z.ZodString;
+        group: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const HeartbeatFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat">;
+    seq: z.ZodNumber;
+    collected_at: z.ZodISODateTime;
+    host: z.ZodObject<{
+        cpu_pct: z.ZodNullable<z.ZodNumber>;
+        cpu_count: z.ZodNumber;
+        load: z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        mem: z.ZodNullable<z.ZodObject<{
+            used: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strict>>;
+        swap: z.ZodNullable<z.ZodObject<{
+            used: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strict>>;
+        disks: z.ZodArray<z.ZodObject<{
+            mount: z.ZodString;
+            fs: z.ZodString;
+            used: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strict>>;
+        net: z.ZodObject<{
+            rx_bps: z.ZodNullable<z.ZodNumber>;
+            tx_bps: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        uptime_sec: z.ZodNumber;
+    }, z.core.$strict>;
+    processes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        pm_id: z.ZodNumber;
+        status: z.ZodString;
+        cpu_pct: z.ZodNumber;
+        memory_bytes: z.ZodNumber;
+        restarts: z.ZodNumber;
+        unstable_restarts: z.ZodNumber;
+        uptime_ms: z.ZodNullable<z.ZodNumber>;
+        version: z.ZodNullable<z.ZodString>;
+        exec_mode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    services: z.ZodArray<z.ZodObject<{
+        unit: z.ZodString;
+        active_state: z.ZodString;
+        sub_state: z.ZodString;
+    }, z.core.$strict>>;
+    capabilities: z.ZodObject<{
+        host: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        pm2: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        systemd: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        nginx: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+    }, z.core.$strict>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            pm2_out: "pm2_out";
+            pm2_err: "pm2_err";
+            nginx_access: "nginx_access";
+            nginx_error: "nginx_error";
+            systemd_journal: "systemd_journal";
+        }>;
+        label: z.ZodString;
+        group: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const WelcomeFrameSchema: z.ZodObject<{
+    interval_sec: z.ZodNumber;
+    watched_services: z.ZodArray<z.ZodString>;
+    nginx_enabled: z.ZodBoolean;
+    type: z.ZodLiteral<"welcome">;
+    server_id: z.ZodString;
+    connection_generation: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ConfigFrameSchema: z.ZodObject<{
+    interval_sec: z.ZodNumber;
+    watched_services: z.ZodArray<z.ZodString>;
+    nginx_enabled: z.ZodBoolean;
+    type: z.ZodLiteral<"config">;
+}, z.core.$strict>;
+export declare const LogsTailParamsSchema: z.ZodObject<{
+    source_id: z.ZodString;
+    lines: z.ZodLiteral<100 | 200 | 500>;
+}, z.core.$strict>;
+export declare const ServiceStatusParamsSchema: z.ZodObject<{
+    unit: z.ZodString;
+}, z.core.$strict>;
+export declare const Pm2DescribeParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strict>;
+export declare const NginxSourcesParamsSchema: z.ZodObject<{}, z.core.$strict>;
+export type LogsTailParams = z.infer<typeof LogsTailParamsSchema>;
+export type ServiceStatusParams = z.infer<typeof ServiceStatusParamsSchema>;
+export type Pm2DescribeParams = z.infer<typeof Pm2DescribeParamsSchema>;
+export type NginxSourcesParams = z.infer<typeof NginxSourcesParamsSchema>;
+export declare const RequestFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"logs.tail">;
+    params: z.ZodObject<{
+        source_id: z.ZodString;
+        lines: z.ZodLiteral<100 | 200 | 500>;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"request">;
+    request_id: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"service.status">;
+    params: z.ZodObject<{
+        unit: z.ZodString;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"request">;
+    request_id: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"pm2.describe">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"request">;
+    request_id: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"nginx.sources">;
+    params: z.ZodObject<{}, z.core.$strict>;
+    type: z.ZodLiteral<"request">;
+    request_id: z.ZodUUID;
+}, z.core.$strict>], "action">;
+export declare const LogsTailPayloadSchema: z.ZodObject<{
+    lines: z.ZodArray<z.ZodString>;
+    truncated: z.ZodBoolean;
+    bytes: z.ZodNumber;
+    source_id: z.ZodString;
+}, z.core.$strict>;
+export declare const ServiceStatusPayloadSchema: z.ZodObject<{
+    unit: z.ZodString;
+    active_state: z.ZodString;
+    sub_state: z.ZodString;
+}, z.core.$strict>;
+export declare const Pm2DescribePayloadSchema: z.ZodObject<{
+    name: z.ZodString;
+    pm_id: z.ZodNumber;
+    status: z.ZodString;
+    cpu_pct: z.ZodNumber;
+    memory_bytes: z.ZodNumber;
+    restarts: z.ZodNumber;
+    unstable_restarts: z.ZodNumber;
+    uptime_ms: z.ZodNullable<z.ZodNumber>;
+    version: z.ZodNullable<z.ZodString>;
+    exec_mode: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const NginxSourcesPayloadSchema: z.ZodObject<{
+    sources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            pm2_out: "pm2_out";
+            pm2_err: "pm2_err";
+            nginx_access: "nginx_access";
+            nginx_error: "nginx_error";
+            systemd_journal: "systemd_journal";
+        }>;
+        label: z.ZodString;
+        group: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LogsTailPayload = z.infer<typeof LogsTailPayloadSchema>;
+export type ServiceStatusPayload = z.infer<typeof ServiceStatusPayloadSchema>;
+export type Pm2DescribePayload = z.infer<typeof Pm2DescribePayloadSchema>;
+export type NginxSourcesPayload = z.infer<typeof NginxSourcesPayloadSchema>;
+export declare const ResponseErrorSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        unsupported: "unsupported";
+        permission_denied: "permission_denied";
+        not_found: "not_found";
+        timeout: "timeout";
+        too_large: "too_large";
+        internal: "internal";
+    }>;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const SuccessResponseFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response">;
+    request_id: z.ZodString;
+    ok: z.ZodLiteral<true>;
+    payload: z.ZodUnion<readonly [z.ZodObject<{
+        lines: z.ZodArray<z.ZodString>;
+        truncated: z.ZodBoolean;
+        bytes: z.ZodNumber;
+        source_id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        unit: z.ZodString;
+        active_state: z.ZodString;
+        sub_state: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        pm_id: z.ZodNumber;
+        status: z.ZodString;
+        cpu_pct: z.ZodNumber;
+        memory_bytes: z.ZodNumber;
+        restarts: z.ZodNumber;
+        unstable_restarts: z.ZodNumber;
+        uptime_ms: z.ZodNullable<z.ZodNumber>;
+        version: z.ZodNullable<z.ZodString>;
+        exec_mode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        sources: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                pm2_out: "pm2_out";
+                pm2_err: "pm2_err";
+                nginx_access: "nginx_access";
+                nginx_error: "nginx_error";
+                systemd_journal: "systemd_journal";
+            }>;
+            label: z.ZodString;
+            group: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export declare const ErrorResponseFrameSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response">;
+    request_id: z.ZodString;
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            unsupported: "unsupported";
+            permission_denied: "permission_denied";
+            not_found: "not_found";
+            timeout: "timeout";
+            too_large: "too_large";
+            internal: "internal";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const ResponseFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"response">;
+    request_id: z.ZodString;
+    ok: z.ZodLiteral<true>;
+    payload: z.ZodUnion<readonly [z.ZodObject<{
+        lines: z.ZodArray<z.ZodString>;
+        truncated: z.ZodBoolean;
+        bytes: z.ZodNumber;
+        source_id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        unit: z.ZodString;
+        active_state: z.ZodString;
+        sub_state: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        pm_id: z.ZodNumber;
+        status: z.ZodString;
+        cpu_pct: z.ZodNumber;
+        memory_bytes: z.ZodNumber;
+        restarts: z.ZodNumber;
+        unstable_restarts: z.ZodNumber;
+        uptime_ms: z.ZodNullable<z.ZodNumber>;
+        version: z.ZodNullable<z.ZodString>;
+        exec_mode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        sources: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                pm2_out: "pm2_out";
+                pm2_err: "pm2_err";
+                nginx_access: "nginx_access";
+                nginx_error: "nginx_error";
+                systemd_journal: "systemd_journal";
+            }>;
+            label: z.ZodString;
+            group: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"response">;
+    request_id: z.ZodString;
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            unsupported: "unsupported";
+            permission_denied: "permission_denied";
+            not_found: "not_found";
+            timeout: "timeout";
+            too_large: "too_large";
+            internal: "internal";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>], "ok">;
+export declare const AgentFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    protocol_version: z.ZodLiteral<1>;
+    agent_version: z.ZodString;
+    hostname: z.ZodString;
+    os: z.ZodObject<{
+        platform: z.ZodEnum<{
+            linux: "linux";
+            darwin: "darwin";
+        }>;
+        release: z.ZodString;
+        arch: z.ZodString;
+    }, z.core.$strict>;
+    cpu_count: z.ZodNumber;
+    boot_time: z.ZodISODateTime;
+    capabilities: z.ZodObject<{
+        host: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        pm2: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        systemd: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        nginx: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+    }, z.core.$strict>;
+    sources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            pm2_out: "pm2_out";
+            pm2_err: "pm2_err";
+            nginx_access: "nginx_access";
+            nginx_error: "nginx_error";
+            systemd_journal: "systemd_journal";
+        }>;
+        label: z.ZodString;
+        group: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat">;
+    seq: z.ZodNumber;
+    collected_at: z.ZodISODateTime;
+    host: z.ZodObject<{
+        cpu_pct: z.ZodNullable<z.ZodNumber>;
+        cpu_count: z.ZodNumber;
+        load: z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        mem: z.ZodNullable<z.ZodObject<{
+            used: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strict>>;
+        swap: z.ZodNullable<z.ZodObject<{
+            used: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strict>>;
+        disks: z.ZodArray<z.ZodObject<{
+            mount: z.ZodString;
+            fs: z.ZodString;
+            used: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strict>>;
+        net: z.ZodObject<{
+            rx_bps: z.ZodNullable<z.ZodNumber>;
+            tx_bps: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        uptime_sec: z.ZodNumber;
+    }, z.core.$strict>;
+    processes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        pm_id: z.ZodNumber;
+        status: z.ZodString;
+        cpu_pct: z.ZodNumber;
+        memory_bytes: z.ZodNumber;
+        restarts: z.ZodNumber;
+        unstable_restarts: z.ZodNumber;
+        uptime_ms: z.ZodNullable<z.ZodNumber>;
+        version: z.ZodNullable<z.ZodString>;
+        exec_mode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    services: z.ZodArray<z.ZodObject<{
+        unit: z.ZodString;
+        active_state: z.ZodString;
+        sub_state: z.ZodString;
+    }, z.core.$strict>>;
+    capabilities: z.ZodObject<{
+        host: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        pm2: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        systemd: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+        nginx: z.ZodEnum<{
+            error: "error";
+            available: "available";
+            unsupported: "unsupported";
+            not_installed: "not_installed";
+            permission_denied: "permission_denied";
+        }>;
+    }, z.core.$strict>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            pm2_out: "pm2_out";
+            pm2_err: "pm2_err";
+            nginx_access: "nginx_access";
+            nginx_error: "nginx_error";
+            systemd_journal: "systemd_journal";
+        }>;
+        label: z.ZodString;
+        group: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"response">;
+    request_id: z.ZodString;
+    ok: z.ZodLiteral<true>;
+    payload: z.ZodUnion<readonly [z.ZodObject<{
+        lines: z.ZodArray<z.ZodString>;
+        truncated: z.ZodBoolean;
+        bytes: z.ZodNumber;
+        source_id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        unit: z.ZodString;
+        active_state: z.ZodString;
+        sub_state: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        pm_id: z.ZodNumber;
+        status: z.ZodString;
+        cpu_pct: z.ZodNumber;
+        memory_bytes: z.ZodNumber;
+        restarts: z.ZodNumber;
+        unstable_restarts: z.ZodNumber;
+        uptime_ms: z.ZodNullable<z.ZodNumber>;
+        version: z.ZodNullable<z.ZodString>;
+        exec_mode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        sources: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                pm2_out: "pm2_out";
+                pm2_err: "pm2_err";
+                nginx_access: "nginx_access";
+                nginx_error: "nginx_error";
+                systemd_journal: "systemd_journal";
+            }>;
+            label: z.ZodString;
+            group: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"response">;
+    request_id: z.ZodString;
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            unsupported: "unsupported";
+            permission_denied: "permission_denied";
+            not_found: "not_found";
+            timeout: "timeout";
+            too_large: "too_large";
+            internal: "internal";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>], "ok">], "type">;
+export declare const GatewayFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    interval_sec: z.ZodNumber;
+    watched_services: z.ZodArray<z.ZodString>;
+    nginx_enabled: z.ZodBoolean;
+    type: z.ZodLiteral<"welcome">;
+    server_id: z.ZodString;
+    connection_generation: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    interval_sec: z.ZodNumber;
+    watched_services: z.ZodArray<z.ZodString>;
+    nginx_enabled: z.ZodBoolean;
+    type: z.ZodLiteral<"config">;
+}, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"logs.tail">;
+    params: z.ZodObject<{
+        source_id: z.ZodString;
+        lines: z.ZodLiteral<100 | 200 | 500>;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"request">;
+    request_id: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"service.status">;
+    params: z.ZodObject<{
+        unit: z.ZodString;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"request">;
+    request_id: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"pm2.describe">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"request">;
+    request_id: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"nginx.sources">;
+    params: z.ZodObject<{}, z.core.$strict>;
+    type: z.ZodLiteral<"request">;
+    request_id: z.ZodUUID;
+}, z.core.$strict>], "action">], "type">;
+export type HelloFrame = z.infer<typeof HelloFrameSchema>;
+export type HeartbeatFrame = z.infer<typeof HeartbeatFrameSchema>;
+export type WelcomeFrame = z.infer<typeof WelcomeFrameSchema>;
+export type ConfigFrame = z.infer<typeof ConfigFrameSchema>;
+export type RequestFrame = z.infer<typeof RequestFrameSchema>;
+export type ResponseError = z.infer<typeof ResponseErrorSchema>;
+export type SuccessResponseFrame = z.infer<typeof SuccessResponseFrameSchema>;
+export type ErrorResponseFrame = z.infer<typeof ErrorResponseFrameSchema>;
+export type ResponseFrame = z.infer<typeof ResponseFrameSchema>;
+export type AgentFrame = z.infer<typeof AgentFrameSchema>;
+export type GatewayFrame = z.infer<typeof GatewayFrameSchema>;
+export type ParseResult<Frame> = {
+    readonly ok: true;
+    readonly frame: Frame;
+} | {
+    readonly ok: false;
+    readonly error: SyntaxError | z.ZodError;
+};
+export declare function parseAgentFrame(text: string): ParseResult<AgentFrame>;
+export declare function parseGatewayFrame(text: string): ParseResult<GatewayFrame>;