@kynver-app/runtime 0.1.123 → 0.1.129

package/dist/config.d.ts

@@ -46,6 +46,8 @@ export declare function saveApiKey(apiKey: string): void;
 export declare function loadRunnerToken(agentOsId?: string): string | undefined;
 export declare function saveRunnerToken(agentOsId: string, token: string): void;
 export declare function resolveBaseUrl(argsBaseUrl?: string): string;
+/** Non-exiting sibling of `resolveBaseUrl` for long-lived callers (the daemon). */
+export declare function tryResolveBaseUrl(argsBaseUrl?: string): string | undefined;
 export declare function resolveCallbackSecret(argsSecret?: string, agentOsId?: string): string;
 /**
  * Non-exiting sibling of `resolveCallbackSecretWithMint` for long-lived

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/daemon-heartbeat.d.ts

@@ -3,6 +3,8 @@ export interface DaemonHeartbeat {
     pid: number;
     runId: string;
     agentOsId: string;
+    /** Active server-delivered instruction bundle version (M6); additive. */
+    instructionBundleVersion?: string;
 }
 export declare function daemonHeartbeatPath(agentOsId: string): string;
 /** Best-effort atomic write (temp + rename). Never throws. */
@@ -10,6 +12,7 @@ export declare function writeDaemonHeartbeat(input: {
     agentOsId: string;
     runId: string;
     now?: Date;
+    instructionBundleVersion?: string;
 }): void;
 export declare function readDaemonHeartbeat(agentOsId: string): DaemonHeartbeat | null;
 /**

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;

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export { isEngagementRequiredSkip } from "./fortress-engagement-gate.js";
 export { assessWorkerLandingContract, landingContractAttentionReason, type WorkerLandingContract, type WorkerLandingContractVerdict, type TargetPrReconciliation, } from "./landing-contract-gate.js";
 export { assessExitedWorkerSalvage, type ExitedSalvageAssessment, type ExitedSalvageKind, } from "./exited-salvage.js";
 export { buildPrompt } from "./prompt.js";
+export { canonicalJsonStringify, computeInstructionBundleVersion, deriveInstructionBundleKeyId, parseRawEd25519Key, isSignedInstructionBundleShape, PINNED_INSTRUCTION_BUNDLE_PUBLIC_KEYS, resolveInstructionBundlePublicKey, verifyInstructionBundleSignatureWithKey, verifySignedInstructionBundle, EMBEDDED_INSTRUCTION_BUNDLE, EMBEDDED_INSTRUCTION_BUNDLE_VERSION, getActiveInstructionBundle, getActiveInstructionBundleSource, getActiveInstructionBundleVersion, setActiveInstructionBundle, resolveInstructionText, resolvePolicyThreshold, resolveBundlePersona, ensureInstructionBundle, instructionBundleCachePath, loadInstructionBundleCache, saveInstructionBundleCache, INSTRUCTION_BUNDLE_REFRESH_TTL_MS, type InstructionBundle, type InstructionBundleContent, type InstructionBundlePersona, type SignedInstructionBundle, type InstructionBundleSource, type InstructionBundleVerifyResult, type EnsureInstructionBundleOptions, type EnsureInstructionBundleResult, } from "./instruction-bundle/index.js";
 export { WORKER_PERSONA_CATALOG, getWorkerPersonaCatalogEntry, getPersonaDispatchLane, getPersonaDefaultRoleLane, isKnownWorkerPersonaSlug, workerPersonaReviewSlugs, workerPersonaLandingSlugs, type WorkerPersonaCatalogEntry, type WorkerPersonaCatalogSlug, type WorkerPersonaDispatchLane, type WorkerPersonaDefaultRoleLane, } from "./worker-persona-catalog.js";
 export { assessPrHandoffRequirement, ensurePrReadyHandoff, extractPrUrlFromText, } from "./pr-handoff/index.js";
 export { normalizeCursorModelAlias, preflightClaudeModel, preflightCodexModel, preflightCursorModel, } from "./providers/model-preflight.js";