@kynver-app/runtime 0.1.139 → 0.1.142

package/dist/config.d.ts

@@ -14,6 +14,11 @@ export interface KynverUserConfig {
     deploymentSchedulerProvider?: "qstash" | "kynver-cron" | "openclaw-cron";
     /** Default harness run for `kynver daemon` / systemd user unit (set by `kynver cron install`). */
     defaultDaemonRunId?: string;
+    /**
+     * Kynver-owned daemon restart owner (`keeper` = in-process keeper; `systemd` = user unit).
+     * Set during `kynver setup` / `kynver start --install-systemd`.
+     */
+    daemonSupervisionOwner?: "keeper" | "systemd";
     /** Physical box pool for capacity snapshots (`forge` | `ghost`). Set via `kynver setup --box-kind`. */
     boxKind?: "ghost" | "forge";
     /**
@@ -33,6 +38,13 @@ export interface KynverUserConfig {
     /** @internal Advanced tuning — not required for setup. */
     memUtilization?: number;
 }
+export interface AgentOsIdValidationResult {
+    ok: boolean;
+    value?: string;
+    reason?: string;
+}
+export declare function validateAgentOsId(raw: unknown): AgentOsIdValidationResult;
+export declare function formatAgentOsIdValidationError(raw: unknown): string;
 export declare function loadUserConfig(): KynverUserConfig;
 export declare function saveUserConfig(config: KynverUserConfig): void;
 /** Persist path fields with `~` instead of absolute home directories. */

package/dist/daemon-supervision/host.d.ts

@@ -0,0 +1,4 @@
+/** Supported consumer host kinds for daemon restart ownership. */
+export type SupportedHostKind = "linux" | "wsl" | "darwin" | "win32";
+export declare function detectSupportedHostKind(): SupportedHostKind;
+export declare function hostSupportsSystemdUserUnit(host: SupportedHostKind): boolean;

package/dist/daemon-supervision/index.d.ts

@@ -0,0 +1,5 @@
+export { detectSupportedHostKind, hostSupportsSystemdUserUnit, type SupportedHostKind } from "./host.js";
+export { buildDaemonSupervisionPolicy, defaultSupervisionOwner, formatSupervisionGuidance, resolveSupervisionOwner, supervisionEnvUpdates, type DaemonSupervisionOwner, type DaemonSupervisionPolicy, } from "./policy.js";
+export { applyDaemonSupervisionSetup, defaultSystemdUserUnitPath, isSystemdSupervisionInstalled, supervisionOwnerForDoctor, type DaemonSupervisionSetupResult, } from "./setup.js";
+export { ensureDaemonSupervisionForStart, formatSystemdDelegationGuidance, shouldDelegateStartToSystemd, summarizeSupervisionForStart, type EnsureDaemonSupervisionInput, type EnsureDaemonSupervisionResult, } from "./start.js";
+export { assessDaemonSupervisionChecks, type AssessDaemonSupervisionOptions, type DaemonSupervisionVerifyCheck, } from "./verify.js";

package/dist/daemon-supervision/policy.d.ts

@@ -0,0 +1,16 @@
+import type { KynverUserConfig } from "../config.js";
+import { type SupportedHostKind } from "./host.js";
+/** Who owns daemon process restarts on this box (Kynver-owned, not Hermes cron). */
+export type DaemonSupervisionOwner = "keeper" | "systemd";
+export interface DaemonSupervisionPolicy {
+    hostKind: SupportedHostKind;
+    owner: DaemonSupervisionOwner;
+    /** Env keys written during setup/start so the server knows a local daemon owns cron. */
+    envUpdates: Record<string, string>;
+    guidance: string[];
+}
+export declare function defaultSupervisionOwner(hostKind: SupportedHostKind): DaemonSupervisionOwner;
+export declare function resolveSupervisionOwner(config: KynverUserConfig, hostKind: SupportedHostKind, args?: Record<string, string | boolean>): DaemonSupervisionOwner;
+export declare function supervisionEnvUpdates(): Record<string, string>;
+export declare function formatSupervisionGuidance(hostKind: SupportedHostKind, owner: DaemonSupervisionOwner): string[];
+export declare function buildDaemonSupervisionPolicy(config: KynverUserConfig, args?: Record<string, string | boolean>, hostKind?: SupportedHostKind): DaemonSupervisionPolicy;

package/dist/daemon-supervision/setup.d.ts

@@ -0,0 +1,14 @@
+import { type KynverUserConfig } from "../config.js";
+import { type DaemonSupervisionOwner, type DaemonSupervisionPolicy } from "./policy.js";
+import type { SupportedHostKind } from "./host.js";
+export interface DaemonSupervisionSetupResult {
+    policy: DaemonSupervisionPolicy;
+    configPath: string;
+    envFilePath: string;
+    envChanged: boolean;
+    configUpdated: boolean;
+}
+export declare function defaultSystemdUserUnitPath(): string;
+export declare function isSystemdSupervisionInstalled(): boolean;
+export declare function applyDaemonSupervisionSetup(config: KynverUserConfig, args?: Record<string, string | boolean>, hostKind?: SupportedHostKind): DaemonSupervisionSetupResult;
+export declare function supervisionOwnerForDoctor(config: KynverUserConfig, hostKind: SupportedHostKind): DaemonSupervisionOwner;

package/dist/daemon-supervision/start.d.ts

@@ -0,0 +1,26 @@
+import { installSystemdUserDaemon } from "../cron/cron-install-systemd.js";
+import { type KynverUserConfig } from "../config.js";
+export interface EnsureDaemonSupervisionInput {
+    config: KynverUserConfig;
+    agentOsId: string;
+    runId: string;
+    args: Record<string, string | boolean>;
+}
+export interface EnsureDaemonSupervisionResult {
+    action: "keeper" | "systemd_installed" | "systemd_guided" | "systemd_skipped";
+    owner: "keeper" | "systemd";
+    systemd?: ReturnType<typeof installSystemdUserDaemon>;
+    blockers?: string[];
+}
+/**
+ * Before `kynver start` hands off to the keeper, persist supervision env and
+ * optionally install the Linux systemd user unit (logout-surviving restarts).
+ */
+export declare function ensureDaemonSupervisionForStart(input: EnsureDaemonSupervisionInput): Promise<EnsureDaemonSupervisionResult>;
+/** When systemd install succeeds, `kynver start` must not spawn a foreground keeper. */
+export declare function shouldDelegateStartToSystemd(result: EnsureDaemonSupervisionResult): boolean;
+export declare function formatSystemdDelegationGuidance(unitName?: string): string[];
+export declare function summarizeSupervisionForStart(config: KynverUserConfig, args: Record<string, string | boolean>): {
+    owner: "keeper" | "systemd";
+    guidance: string[];
+};

package/dist/daemon-supervision/verify.d.ts

@@ -0,0 +1,12 @@
+import type { KynverUserConfig } from "../config.js";
+export interface AssessDaemonSupervisionOptions {
+    /** Override for tests; defaults to ~/.kynver/.env */
+    envFilePath?: string;
+}
+export interface DaemonSupervisionVerifyCheck {
+    id: string;
+    ok: boolean;
+    summary: string;
+    remediation?: string;
+}
+export declare function assessDaemonSupervisionChecks(config: KynverUserConfig, options?: AssessDaemonSupervisionOptions): DaemonSupervisionVerifyCheck[];

package/dist/dispatch-start-abort.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessWorkerRecord } from "./status.js";
+/** Stop a just-spawned worker when dispatch-start readback fails closed. */
+export declare function abortDispatchedWorkerAfterReadbackFailure(runId: string, worker: HarnessWorkerRecord, reason: string): HarnessWorkerRecord;

package/dist/dispatch-start-readback.d.ts

@@ -0,0 +1,27 @@
+import type { HarnessWorkerRecord } from "./status.js";
+import type { TaskLeaseSnapshot } from "./monitor/monitor.types.js";
+export declare const DISPATCH_START_READBACK_PREFIX = "dispatch_start_readback_failed:";
+export interface DispatchStartReadbackInput {
+    agentOsId: string;
+    taskId: string;
+    leaseOwner: string;
+    expectedLeaseToken: string;
+    worker: HarnessWorkerRecord;
+    baseUrl: string;
+    secret: string;
+}
+export interface DispatchStartReadbackResult {
+    ok: boolean;
+    error?: string;
+    detail?: Record<string, unknown>;
+    snapshot?: TaskLeaseSnapshot;
+}
+export declare function formatDispatchStartReadbackFailure(reason: string): string;
+export declare function assessDispatchStartReadback(input: {
+    snapshot: TaskLeaseSnapshot | null | undefined;
+    leaseOwner: string;
+    expectedLeaseToken: string;
+    worker: HarnessWorkerRecord;
+}): DispatchStartReadbackResult;
+/** Post-spawn AgentOS readback — board must show a live lease matching the claim token. */
+export declare function verifyDispatchStartReadback(input: DispatchStartReadbackInput): Promise<DispatchStartReadbackResult>;

package/dist/doctor/runtime-takeover-daemon-supervision.d.ts

@@ -0,0 +1,3 @@
+import type { DoctorSection } from "./doctor.types.js";
+import type { RuntimeTakeoverProbes } from "./runtime-takeover.probes.js";
+export declare function assessDaemonSupervision(probes: RuntimeTakeoverProbes): DoctorSection;