@kynver-app/runtime 0.1.122 → 0.1.128

package/dist/cron/cron-cli-bin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Portable absolute path to the `kynver` CLI entry for systemd/supervisors.
+ * systemd does not inherit shell PATH — bare `kynver` fails with status 203/EXEC.
+ */
+export declare function resolveKynverCliExecutable(cliEntry?: string): string;
+/** Quote an ExecStart binary path when it contains whitespace. */
+export declare function formatSystemdExecPath(executable: string): string;

package/dist/cron/cron-readiness.d.ts

@@ -0,0 +1,35 @@
+import type { KynverUserConfig } from "../config.js";
+import { type CronInstallVerifyReport, type CronVerifyCheck } from "./cron-install-verify.js";
+export type DeploymentSchedulerProvider = "qstash" | "kynver-cron" | "openclaw-cron";
+/** Local box checks that must pass before the daemon can own cron fires. */
+export declare const LOCAL_CRON_READINESS_CHECK_IDS: readonly ["deployment_provider", "cron_secret", "env_file", "cron_store"];
+export type LocalCronReadinessCheckId = (typeof LOCAL_CRON_READINESS_CHECK_IDS)[number];
+export interface CronReadinessReport {
+    expectsKynverCron: boolean;
+    ready: boolean;
+    failedChecks: CronVerifyCheck[];
+}
+/**
+ * Whether this connected runner should use the local Kynver Cron tick loop.
+ * QStash/OpenClaw attestations win; otherwise a linked box defaults to kynver-cron.
+ */
+export declare function expectsKynverCronOnRunner(config: KynverUserConfig): boolean;
+export declare function isCronLocallyReady(report: CronInstallVerifyReport): boolean;
+export declare function assessCronReadiness(config: KynverUserConfig): Promise<CronReadinessReport>;
+export declare function formatCronReadinessGuidance(failedChecks: CronVerifyCheck[]): string[];
+export interface EnsureCronForStartInput {
+    config: KynverUserConfig;
+    agentOsId: string;
+    runId: string;
+    args: Record<string, string | boolean>;
+}
+export interface EnsureCronForStartResult {
+    action: "skipped" | "ready" | "installed" | "guided";
+    installOk?: boolean;
+    blockers?: string[];
+}
+/**
+ * Before `kynver start` hands off to the daemon, ensure local Kynver Cron is configured
+ * when this box is expected to own schedule fires.
+ */
+export declare function ensureCronReadyForStart(input: EnsureCronForStartInput): Promise<EnsureCronForStartResult>;

package/dist/disk-gate.d.ts

@@ -12,3 +12,10 @@ export interface ObserveDiskGateInput {
     wslHost?: ObserveWslHostDiskOptions;
 }
 export declare function observeRunnerDiskGate(input?: ObserveDiskGateInput): DispatchNextDiskGateShape;
+/**
+ * Operator escape hatch (mirrors `KYNVER_CLEANUP_DISK_PRESSURE_FORCE`):
+ * `KYNVER_DISPATCH_DISK_GATE_FORCE=ok|open|none` pins the gate open with the
+ * suppressed reason kept visible; `block|pressured` forces it closed. The
+ * hosted server honors the same env on its side, so either end can unblock.
+ */
+export declare function applyDiskGateForce(gate: DispatchNextDiskGateShape): DispatchNextDiskGateShape;