@kynver-app/runtime 0.1.118 → 0.1.119

package/dist/config.d.ts

@@ -12,6 +12,8 @@ export interface KynverUserConfig {
      * (set on user runners after Vercel env cutover — scheduling is deployment-owned).
      */
     deploymentSchedulerProvider?: "qstash" | "kynver-cron" | "openclaw-cron";
+    /** Default harness run for `kynver daemon` / systemd user unit (set by `kynver cron install`). */
+    defaultDaemonRunId?: string;
     /** Physical box pool for capacity snapshots (`forge` | `ghost`). Set via `kynver setup --box-kind`. */
     boxKind?: "ghost" | "forge";
     /** Max concurrent workers on this machine. Omit to auto-size from RAM. */

package/dist/cron/cron-env-file.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_KYNVER_ENV_FILE: string;
+export interface EnvFileMergeResult {
+    path: string;
+    changed: boolean;
+    keysWritten: string[];
+    keysRemoved: string[];
+}
+/** Parse `KEY=VALUE` lines; skips blanks and `#` comments. */
+export declare function parseEnvFile(content: string): Map<string, string>;
+export declare function serializeEnvFile(values: Map<string, string>, header?: string): string;
+export declare function readEnvFile(filePath?: string): Map<string, string>;
+export declare function mergeEnvFile(updates: Record<string, string | undefined>, options?: {
+    filePath?: string;
+    removeKeys?: string[];
+}): EnvFileMergeResult;

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

@@ -0,0 +1,3 @@
+import type { CronJobSpec } from "./cron-types.js";
+/** Match server `deterministicId` in scheduler.providers.kynver-cron.ts */
+export declare function deterministicCronProviderId(spec: CronJobSpec): string;

package/dist/cron/cron-install-api.d.ts

@@ -0,0 +1,27 @@
+import type { CronJobSpec } from "./cron-types.js";
+export interface SchedulerJobRow {
+    id: string;
+    kind: string;
+    provider: string;
+    status: string;
+    cron?: string | null;
+    dedupeKey?: string | null;
+}
+export declare function listSchedulerJobs(baseUrl: string, agentOsId: string, apiKey: string, query?: Record<string, string>): Promise<SchedulerJobRow[]>;
+export declare function ensureWatchdogScheduleRemote(baseUrl: string, agentOsId: string, apiKey: string, cron?: string, options?: {
+    requireProvider?: "kynver-cron";
+}): Promise<{
+    job: SchedulerJobRow;
+    route: string;
+    dedupeKey: string;
+    requestedCron: string;
+    selectedProvider: string | null;
+}>;
+export declare function cancelSchedulerJob(baseUrl: string, agentOsId: string, jobId: string, apiKey: string): Promise<void>;
+export declare function buildWatchdogCronSpec(agentOsId: string, cron: string, dedupeKey?: string): CronJobSpec;
+export declare function findQstashWatchdogLeftovers(jobs: SchedulerJobRow[]): SchedulerJobRow[];
+export declare function findKynverCronWatchdog(jobs: SchedulerJobRow[]): SchedulerJobRow | undefined;
+export declare function canCancelQstashWatchdogLeftovers(jobs: SchedulerJobRow[]): {
+    allowed: boolean;
+    reason?: string;
+};

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

@@ -0,0 +1,2 @@
+export declare function runCronInstallCli(args: Record<string, string | boolean>): Promise<void>;
+export declare function runCronVerifyCli(args: Record<string, string | boolean>): Promise<void>;

package/dist/cron/cron-install-plan.d.ts

@@ -0,0 +1,32 @@
+import type { KynverUserConfig } from "../config.js";
+export declare const WATCHDOG_DEDUPE_KEY = "watchdog:board-sweep";
+export declare const DEFAULT_WATCHDOG_CRON = "*/5 * * * *";
+export declare const VERCEL_KYNVER_CRON_CUTOVER_STEPS: readonly ["Set KYNVER_SCHEDULER_PROVIDER=kynver-cron on the hosted Kynver deployment (Vercel).", "Set KYNVER_CRON_SECRET to the same value written to ~/.kynver/.env by this installer.", "Unset KYNVER_CRON_STORE_PATH on Vercel — the connected box owns the local store.", "Keep QSTASH_TOKEN only if other non-watchdog schedules still use QStash (analyst/market jobs)."];
+export interface CronInstallPlanInput {
+    config: KynverUserConfig;
+    apiBaseUrl: string;
+    agentOsId: string;
+    cronSecret: string;
+    storePath?: string;
+    envFilePath?: string;
+    defaultDaemonRunId?: string;
+    installSystemd?: boolean;
+}
+export interface CronInstallPlan {
+    envFilePath: string;
+    configPath: string;
+    storePath: string;
+    envUpdates: Record<string, string>;
+    envRemovals: string[];
+    configUpdates: Partial<KynverUserConfig>;
+    deploymentSteps: readonly string[];
+    prerequisites: string[];
+    systemdSupported: boolean;
+    watchdogSpec: {
+        kind: "watchdog";
+        cron: string;
+        dedupeKey: string;
+        callbackPath: string;
+    };
+}
+export declare function buildCronInstallPlan(input: CronInstallPlanInput): CronInstallPlan;

package/dist/cron/cron-install-secrets.d.ts

@@ -0,0 +1,6 @@
+export declare function generateCronSecret(): string;
+export declare function resolveCronSecretForInstall(envFilePath?: string): {
+    secret: string;
+    generated: boolean;
+    source: "env" | "env-file" | "generated";
+};

package/dist/cron/cron-install-systemd.d.ts

@@ -0,0 +1,18 @@
+export declare const KYNVER_CRON_DAEMON_UNIT = "kynver-cron-daemon.service";
+export interface SystemdDaemonServiceInput {
+    envFilePath: string;
+    agentOsId: string;
+    runId: string;
+    kynverBin?: string;
+}
+export declare function defaultSystemdUserUnitDir(): string;
+export declare function renderKynverCronDaemonService(input: SystemdDaemonServiceInput): string;
+export interface SystemdInstallResult {
+    supported: boolean;
+    unitPath: string | null;
+    written: boolean;
+    enabled: boolean;
+    started: boolean;
+    note?: string;
+}
+export declare function installSystemdUserDaemon(input: SystemdDaemonServiceInput, execute: boolean): SystemdInstallResult;

package/dist/cron/cron-install-verify.d.ts

@@ -0,0 +1,15 @@
+import type { KynverUserConfig } from "../config.js";
+export interface CronVerifyCheck {
+    id: string;
+    ok: boolean;
+    summary: string;
+    remediation?: string;
+}
+export interface CronInstallVerifyReport {
+    ok: boolean;
+    checks: CronVerifyCheck[];
+}
+export declare function verifyCronInstall(input: {
+    config: KynverUserConfig;
+    envFilePath?: string;
+}): Promise<CronInstallVerifyReport>;

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

@@ -0,0 +1,51 @@
+import { buildCronInstallPlan } from "./cron-install-plan.js";
+import { installSystemdUserDaemon } from "./cron-install-systemd.js";
+import { verifyCronInstall } from "./cron-install-verify.js";
+export interface CronInstallOptions {
+    execute?: boolean;
+    json?: boolean;
+    installSystemd?: boolean;
+    confirmQstashRemoval?: boolean;
+    skipWatchdog?: boolean;
+    skipTestFire?: boolean;
+    agentOsId?: string;
+    apiBaseUrl?: string;
+    runId?: string;
+}
+export interface CronInstallResult {
+    ok: boolean;
+    dryRun: boolean;
+    plan: ReturnType<typeof buildCronInstallPlan>;
+    secretGenerated: boolean;
+    envFile?: {
+        path: string;
+        changed: boolean;
+        keysWritten: string[];
+    };
+    configPath: string;
+    storeInitialized: boolean;
+    watchdog?: {
+        remoteJobId?: string;
+        provider?: string;
+        localProviderScheduleId?: string;
+        error?: string;
+    };
+    qstashWatchdog?: {
+        found: Array<{
+            id: string;
+            provider: string;
+            status: string;
+        }>;
+        removed: string[];
+        manualSteps: string[];
+    };
+    systemd?: ReturnType<typeof installSystemdUserDaemon>;
+    testFire?: {
+        fired: number;
+        errors: number;
+        skipped?: boolean;
+    };
+    verify?: Awaited<ReturnType<typeof verifyCronInstall>>;
+    blockers: string[];
+}
+export declare function runCronInstall(opts?: CronInstallOptions): Promise<CronInstallResult>;

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

@@ -1,3 +1,8 @@
 import type { CronRegisteredJob } from "./cron-types.js";
 export declare function parseCronStore(raw: string | null): CronRegisteredJob[];
 export declare function loadCronJobs(storePath?: string): Promise<CronRegisteredJob[]>;
+/** Insert or replace a cron store entry (by `providerScheduleId`). */
+export declare function saveCronJob(entry: CronRegisteredJob, storePath?: string): Promise<void>;
+export declare function ensureCronStoreInitialized(storePath?: string): Promise<{
+    created: boolean;
+}>;