@kynver-app/runtime 0.2.24 → 0.2.29

package/dist/context-budget-receipt.d.ts

@@ -1,96 +0,0 @@
-/** Pure context-budget receipt schema — no AgentOS/app dependencies. */
-export declare const RUNTIME_CONTEXT_BUDGET_RECEIPT_SCHEMA_VERSION: "runtime-context-budget-receipt.v1";
-export declare const RUNTIME_CONTEXT_BUDGET_RECEIPT_V2_SCHEMA_VERSION: "runtime-context-budget-receipt.v2";
-export type RuntimeContextBudgetReceiptSchemaVersion = typeof RUNTIME_CONTEXT_BUDGET_RECEIPT_SCHEMA_VERSION | typeof RUNTIME_CONTEXT_BUDGET_RECEIPT_V2_SCHEMA_VERSION;
-export type ContextEnvelopeMode = "routine" | "review" | "ops" | "debug" | "handoff";
-export type ContextBudgetReceiptSurface = "chat_default" | "context_envelope" | "harness_worker" | "runtime_prompt" | "mcp_tool_context" | "agentos_handoff" | "operator_debug" | "full_expansion";
-export type RuntimeContextSection = "instruction_policy" | "persona" | "task_envelope" | "active_state" | "memory_preview" | "memory_quality" | "recent_failures" | "onboarding" | "structural";
-export type RuntimeContextRehydrationKind = "memory" | "task" | "plan" | "active_state" | "source";
-export interface RuntimeContextRehydrationRoute {
-    handle: string;
-    kind: RuntimeContextRehydrationKind;
-}
-export interface RuntimeContextSectionReceipt {
-    section: RuntimeContextSection;
-    chars: number;
-    estimatedTokens: number;
-    fingerprint?: string | null;
-    selectedSlugs?: string[];
-    omittedCount?: number;
-    duplicatesCollapsed?: number;
-    policyFingerprint?: string | null;
-    rehydrationRoutes?: RuntimeContextRehydrationRoute[];
-}
-export type RuntimeContextActiveStateLookupKind = "pr" | "branch" | "deploy" | "daemon" | "task" | "worker";
-export type RuntimeContextActiveStateLookupStatus = "used" | "missing" | "error";
-export interface RuntimeContextActiveStateLookup {
-    kind: RuntimeContextActiveStateLookupKind;
-    handle: string;
-    status: RuntimeContextActiveStateLookupStatus;
-}
-export interface UsefulContextCoverage {
-    requiredOperatingRuleSlugsPresent: string[];
-    requiredOperatingRuleDenominator: number;
-    activeTaskHandlePresent: boolean;
-    planHandlePresent: boolean;
-    selectedHandles: string[];
-    omittedHandles: string[];
-    expansionRoutes: string[];
-    memoryQualityTraceId?: string | null;
-}
-export interface RuntimeContextBudgetReceipt {
-    schemaVersion: typeof RUNTIME_CONTEXT_BUDGET_RECEIPT_SCHEMA_VERSION;
-    agentOsId: string;
-    taskId: string;
-    planId: string | null;
-    personaSlug: string | null;
-    mode: ContextEnvelopeMode;
-    generatedAt: string;
-    totalChars: number;
-    estimatedTokens: number;
-    duplicatesCollapsed: number;
-    omittedCount: number;
-    activeStateLookups: RuntimeContextActiveStateLookup[];
-    sections: RuntimeContextSectionReceipt[];
-}
-export interface RuntimeContextBudgetReceiptV2 extends Omit<RuntimeContextBudgetReceipt, "schemaVersion" | "agentOsId" | "taskId"> {
-    schemaVersion: typeof RUNTIME_CONTEXT_BUDGET_RECEIPT_V2_SCHEMA_VERSION;
-    surface: ContextBudgetReceiptSurface;
-    agentOsId: string | null;
-    taskId: string | null;
-    finalSerializedChars: number;
-    finalSerializedTokens: number;
-    usefulContextCoverage: UsefulContextCoverage;
-    budgetSatisfied: boolean;
-    overBudgetReason: string | null;
-}
-/** Deterministic chars → token estimate (4 UTF-16 code units per token, ceiling). */
-export declare function estimateTokensFromChars(chars: number): number;
-export declare function sectionReceiptFromMarkdown(section: RuntimeContextSection, markdown: string | null | undefined, extras?: Partial<Pick<RuntimeContextSectionReceipt, "fingerprint" | "selectedSlugs" | "omittedCount" | "duplicatesCollapsed" | "policyFingerprint" | "rehydrationRoutes">>): RuntimeContextSectionReceipt;
-export declare function finalizeReceiptTotals(sections: RuntimeContextSectionReceipt[], overrides?: {
-    duplicatesCollapsed?: number;
-    omittedCount?: number;
-}): Pick<RuntimeContextBudgetReceipt, "totalChars" | "estimatedTokens" | "duplicatesCollapsed" | "omittedCount">;
-export interface BuildContextBudgetReceiptV2Input {
-    surface: ContextBudgetReceiptSurface;
-    agentOsId?: string | null;
-    taskId?: string | null;
-    planId?: string | null;
-    personaSlug?: string | null;
-    mode: ContextEnvelopeMode;
-    generatedAt: string;
-    finalSerializedChars: number;
-    sections: RuntimeContextSectionReceipt[];
-    usefulContextCoverage: UsefulContextCoverage;
-    activeStateLookups?: RuntimeContextActiveStateLookup[];
-    duplicatesCollapsed?: number;
-    omittedCount?: number;
-    budgetSatisfied?: boolean;
-    overBudgetReason?: string | null;
-}
-export declare function buildContextBudgetReceiptV2(input: BuildContextBudgetReceiptV2Input): RuntimeContextBudgetReceiptV2;
-export declare function upgradeReceiptToV2(v1: RuntimeContextBudgetReceipt, input: Omit<BuildContextBudgetReceiptV2Input, "sections" | "mode" | "generatedAt"> & {
-    mode?: ContextEnvelopeMode;
-    generatedAt?: string;
-}): RuntimeContextBudgetReceiptV2;
-export declare function isRuntimeContextBudgetReceiptV2(receipt: RuntimeContextBudgetReceipt | RuntimeContextBudgetReceiptV2): receipt is RuntimeContextBudgetReceiptV2;

package/dist/context-preview/chat-memory-preview.d.ts

@@ -1,33 +0,0 @@
-/** Shared with app memory-retrieval.constants — single source for MCP + server preview blocks. */
-export declare const MEMORY_LANE_PREVIEW_CHARS = 160;
-export interface ContextPreviewMemoryItem {
-    slug: string;
-    lane?: string | null;
-    trust?: string | null;
-    contentPreview: string;
-    selectedBecause?: string | null;
-    expansionRoute?: string | null;
-    expandable?: boolean;
-}
-export interface ContextPreviewBlockInput {
-    sectionTitle: string;
-    items: ContextPreviewMemoryItem[];
-    emptyFallback?: string;
-    previewCharsPerItem?: number;
-}
-/** Compact preview block — handles-first, never full memory bodies. */
-export declare function formatContextPreviewMemoryBlock(input: ContextPreviewBlockInput): string;
-export declare function chatMemoriesToPreviewItems(memories: {
-    content: string;
-    similarity?: number;
-}[]): ContextPreviewMemoryItem[];
-/** Legacy chat memory block — flag-invariant (PR1 baseline capture, diagnostics). */
-export declare function buildLegacyChatMemorySection(memories: {
-    content: string;
-    similarity?: number;
-}[]): string;
-/** Shadow chat preview — ignores dark flag (diagnostics / MCP comparison). */
-export declare function buildChatMemoryShadowPreview(memories: {
-    content: string;
-    similarity?: number;
-}[]): string;

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

@@ -1,7 +0,0 @@
-/**
- * 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-env-file.d.ts

@@ -1,22 +0,0 @@
-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 loadEnvFileIntoProcess(filePath?: string, options?: {
-    override?: boolean;
-}): {
-    path: string;
-    loaded: number;
-    skipped: number;
-};
-export declare function mergeEnvFile(updates: Record<string, string | undefined>, options?: {
-    filePath?: string;
-    removeKeys?: string[];
-}): EnvFileMergeResult;

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

@@ -1,21 +0,0 @@
-export interface KynverCronEnv {
-    storePath: string;
-    statePath: string;
-    lockPath: string;
-    fireBaseUrl: string | null;
-    secret: string | null;
-    tickEnabled: boolean;
-    tickIntervalMs: number;
-    missedRunPolicy: "catch_up" | "skip";
-    maxCatchUpPerTick: number;
-    maxRetries: number;
-    retryBackoffMs: number;
-    inflightLeaseMs: number;
-}
-export declare function defaultKynverCronStorePath(): string;
-export declare function defaultKynverCronStatePath(storePath?: string): string;
-export declare function resolveKynverCronFireBaseUrl(): string | null;
-export declare function resolveKynverCronSecret(): string | null;
-/** Whether the connected-box daemon should run the local cron tick loop. */
-export declare function resolveKynverCronEnv(): KynverCronEnv;
-export declare function isKynverCronDaemonPrimary(env?: KynverCronEnv): boolean;

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

@@ -1,8 +0,0 @@
-import type { CronFireResult, CronRegisteredJob } from "./cron-types.js";
-export declare function fireKynverCronJob(input: {
-    entry: CronRegisteredJob;
-    baseUrl: string;
-    secret: string;
-    jobId?: string | null;
-    fetchFn?: typeof fetch;
-}): Promise<CronFireResult>;

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

@@ -1,3 +0,0 @@
-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

@@ -1,27 +0,0 @@
-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

@@ -1,2 +0,0 @@
-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

@@ -1,34 +0,0 @@
-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 HOSTED_KYNVER_CRON_CUTOVER_STEPS: readonly ["Set KYNVER_SCHEDULER_PROVIDER=kynver-cron on the hosted Kynver deployment (the Railway production service).", "Set KYNVER_CRON_SECRET to the same value written to ~/.kynver/.env by this installer.", "Unset KYNVER_CRON_STORE_PATH on the Railway service — the connected box owns the local store.", "Keep QSTASH_TOKEN only if other non-watchdog schedules still use QStash (analyst/market jobs)."];
-/** @deprecated Renamed after the 2026-08 Railway cutover — use HOSTED_KYNVER_CRON_CUTOVER_STEPS. */
-export declare const VERCEL_KYNVER_CRON_CUTOVER_STEPS: readonly ["Set KYNVER_SCHEDULER_PROVIDER=kynver-cron on the hosted Kynver deployment (the Railway production service).", "Set KYNVER_CRON_SECRET to the same value written to ~/.kynver/.env by this installer.", "Unset KYNVER_CRON_STORE_PATH on the Railway service — 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

@@ -1,6 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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

@@ -1,15 +0,0 @@
-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

@@ -1,51 +0,0 @@
-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-lock.d.ts

@@ -1,9 +0,0 @@
-export interface CronTickLockInfo {
-    pid: number;
-    at: string;
-}
-export declare function tryAcquireCronTickLock(lockPath: string): {
-    acquired: boolean;
-    reason?: string;
-};
-export declare function releaseCronTickLock(lockPath: string): void;

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

@@ -1,8 +0,0 @@
-import type { CronJobSpec } from "./cron-types.js";
-export declare function isCronExpression(value: string): boolean;
-/** UTC 5-field cron match for a Date (minute resolution). */
-export declare function cronMatchesUtc(expr: string, at: Date): boolean;
-/** Next UTC fire at or strictly after `after` (minute resolution). */
-export declare function computeNextCronFireUtc(expr: string, after: Date): Date | null;
-export declare function computeInitialNextFire(spec: CronJobSpec, now: Date): string | null;
-export declare function advanceRecurringNextFire(spec: CronJobSpec, fromInclusive: Date): string | null;

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

@@ -1,35 +0,0 @@
-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/cron/cron-status.d.ts

@@ -1,10 +0,0 @@
-import type { KynverCronEnv } from "./cron-env.js";
-export interface KynverCronStatusReport {
-    primary: "kynver-cron-daemon" | "qstash" | "disabled";
-    env: Pick<KynverCronEnv, "storePath" | "statePath" | "tickEnabled" | "fireBaseUrl" | "missedRunPolicy" | "maxCatchUpPerTick" | "maxRetries">;
-    jobCount: number;
-    stateJobCount: number;
-    credentialsReady: boolean;
-    daemonPrimary: boolean;
-}
-export declare function buildKynverCronStatusReport(env?: KynverCronEnv): Promise<KynverCronStatusReport>;

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

@@ -1,8 +0,0 @@
-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;
-}>;

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

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

package/dist/cron/cron-tick-state.d.ts

@@ -1,5 +0,0 @@
-import type { CronTickJobState, CronTickStateFile } from "./cron-types.js";
-export declare function parseCronTickState(raw: string | null): CronTickStateFile;
-export declare function loadCronTickState(statePath: string): Promise<CronTickStateFile>;
-export declare function saveCronTickState(statePath: string, state: CronTickStateFile): Promise<void>;
-export declare function getOrCreateJobState(state: CronTickStateFile, providerScheduleId: string): CronTickJobState;

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

@@ -1,19 +0,0 @@
-import type { CronTickErrorDetail } from "./cron-types.js";
-import type { KynverCronEnv } from "./cron-env.js";
-export interface CronTickResult {
-    enabled: boolean;
-    skipped?: string;
-    scanned: number;
-    due: number;
-    fired: number;
-    skippedJobs: number;
-    errors: number;
-    lockHeld?: boolean;
-    errorDetails?: CronTickErrorDetail[];
-}
-export declare function runKynverCronTick(opts?: {
-    env?: KynverCronEnv;
-    now?: Date;
-    fetchFn?: typeof fetch;
-    agentOsIdFilter?: string | null;
-}): Promise<CronTickResult>;

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

@@ -1,53 +0,0 @@
-/** Minimal mirror of server `KynverCronRegisteredJob` / `SchedulerJobSpec` for the local store. */
-export interface CronJobTarget {
-    agentOsId: string;
-    taskId?: string | null;
-    planId?: string | null;
-    planVersionId?: string | null;
-    goalId?: string | null;
-    projectId?: string | null;
-}
-export interface CronJobSpec {
-    kind: string;
-    scheduleKind: "cron" | "runAt";
-    cron?: string | null;
-    runAt?: string | null;
-    callbackPath: string;
-    payload?: Record<string, unknown> | null;
-    target: CronJobTarget;
-    description?: string | null;
-    dedupeKey?: string | null;
-}
-export interface CronRegisteredJob {
-    providerScheduleId: string;
-    spec: CronJobSpec;
-    registeredAt: string;
-    paused: boolean;
-}
-export interface CronTickJobState {
-    providerScheduleId: string;
-    nextFireAt: string | null;
-    lastFiredAt: string | null;
-    lastAttemptAt: string | null;
-    consecutiveFailures: number;
-    completedAt: string | null;
-    inflightUntil: string | null;
-}
-export interface CronTickStateFile {
-    version: 1;
-    jobs: Record<string, CronTickJobState>;
-}
-export interface CronFireResult {
-    ok: boolean;
-    status: number;
-    body: unknown;
-    url: string;
-}
-export interface CronTickErrorDetail {
-    providerScheduleId: string;
-    callbackPath: string;
-    url?: string;
-    status?: number;
-    body?: unknown;
-    error?: string;
-}

package/dist/cron/hermes-provider-notice.d.ts

@@ -1 +0,0 @@
-export { classifyOpenAiCodexError, formatCronJobDeliveryFailure, formatOpenAiCodexFailureNotice, resolveOpenAiCodexRetryBudget, type ClassifiedOpenAiCodexError, type CodexFailureNoticeInput, } from "../providers/openai-codex-resilience.js";

package/dist/daemon-box-identity.d.ts

@@ -1,16 +0,0 @@
-import { type KynverUserConfig } from "./config.js";
-import { type ResolvedBoxIdentity } from "./box-identity.js";
-export interface DaemonInstallValidation {
-    ok: boolean;
-    box: ResolvedBoxIdentity;
-    workerCapSource: string;
-    maxConcurrentWorkers: number;
-    autoCap: number;
-    warnings: string[];
-    errors: string[];
-}
-/**
- * Validate box identity and worker-cap provenance before the daemon loop runs.
- * Loud warnings prevent Forge hosts from silently inheriting Ghost workspace slugs.
- */
-export declare function validateDaemonInstallIdentity(config?: KynverUserConfig, env?: NodeJS.ProcessEnv): DaemonInstallValidation;

package/dist/daemon-heartbeat.d.ts

@@ -1,30 +0,0 @@
-import { type RuntimeIdentityV1 } from "./runtime-identity.js";
-export interface DaemonHeartbeat {
-    observedAt: string;
-    pid: number;
-    runId: string;
-    agentOsId: string;
-    /** Active server-delivered instruction bundle version (M6); additive. */
-    instructionBundleVersion?: string;
-    /**
-     * Versioned runtime identity (Node 24 migration N2b); additive. Absent on
-     * pre-N2b payloads — consumers MUST map absence to `unknown`, never
-     * `compatible`.
-     */
-    runtimeIdentity?: RuntimeIdentityV1;
-}
-export declare function daemonHeartbeatPath(agentOsId: string): string;
-/** Best-effort atomic write (temp + rename). Never throws. */
-export declare function writeDaemonHeartbeat(input: {
-    agentOsId: string;
-    runId: string;
-    now?: Date;
-    instructionBundleVersion?: string;
-}): void;
-export declare function readDaemonHeartbeat(agentOsId: string): DaemonHeartbeat | null;
-/**
- * True when the heartbeat indicates a hung daemon. A missing heartbeat is NOT
- * stale — a freshly spawned child has not written one yet; the keeper grants a
- * startup grace window instead.
- */
-export declare function isDaemonHeartbeatStale(beat: DaemonHeartbeat | null, stallMs: number, nowMs?: number): boolean;

package/dist/daemon-keeper.d.ts

@@ -1,53 +0,0 @@
-/**
- * A child that dies nonzero this fast with a config-shaped error message will
- * die identically on every respawn — a bad `~/.kynver/config.json` must not
- * become an infinite keeper crash loop (respawn → same error → backoff → …).
- */
-export declare const KEEPER_PERMANENT_FAILURE_WINDOW_MS = 10000;
-export interface KeeperChildFailureVerdict {
-    permanent: boolean;
-    /** First stderr line that matched a permanent pattern (for the operator). */
-    matchedLine?: string;
-}
-/**
- * Decide whether a child exit is a permanent configuration failure (stop
- * respawning) or transient (keep exponential backoff). Permanent requires ALL
- * of: a nonzero exit code (signals are transient — OOM killer etc.), death
- * inside the startup grace window, and stderr matching a known config-error
- * class. Anything else keeps the resilient default: respawn with backoff.
- */
-export declare function classifyKeeperChildFailure(input: {
-    exitCode: number | null;
-    exitSignal: NodeJS.Signals | null;
-    uptimeMs: number;
-    stderrTail: string;
-}): KeeperChildFailureVerdict;
-/**
- * Remediation-formatted error for a missing daemon/keeper argument (modeled
- * on `formatAgentOsIdValidationError`): what is missing, where it normally
- * comes from (`~/.kynver/config.json`), and the command that sets it up. The
- * leading `missing --…` token is load-bearing — the keeper's permanent
- * config-error classifier and legacy log greps both key on it.
- */
-export declare function formatMissingDaemonArgError(flag: "--run" | "--agent-os-id"): string;
-export declare function resolveKeeperStallMs(flag: string | boolean | undefined, env?: NodeJS.ProcessEnv): number;
-/**
- * Supervision is the DEFAULT for `kynver daemon`. Opt out only when an
- * external supervisor (systemd, pm2, container restart policy) already owns
- * restarts: `--no-supervise`, `--supervised false`, or
- * `KYNVER_DAEMON_SUPERVISED=0|false|no|off`. The keeper's own child carries
- * the internal `--keeper-child` flag so it can never recurse into a second
- * keeper. `--supervised` stays accepted as a no-op for back-compat.
- */
-export declare function shouldRunDaemonKeeper(args: Record<string, string | boolean>, env?: NodeJS.ProcessEnv): boolean;
-/** Exponential backoff with cap; resets to base after a healthy stretch. */
-export declare function nextKeeperBackoffMs(consecutiveFailures: number, base?: number, cap?: number): number;
-/** True when the child ran long enough to count as healthy (resets backoff). */
-export declare function keeperRunWasHealthy(startedAtMs: number, endedAtMs: number, healthyMs?: number): boolean;
-/**
- * Rebuild the child argv: original daemon args minus keeper-only flags, plus
- * the internal `--keeper-child` marker that prevents keeper recursion now
- * that supervision is the default.
- */
-export declare function buildKeeperChildArgv(argv: readonly string[]): string[];
-export declare function runDaemonKeeper(args: Record<string, string | boolean>, rawArgv?: readonly string[]): Promise<void>;

package/dist/daemon-platform-guard.d.ts

@@ -1,2 +0,0 @@
-/** Block native Windows daemon unless explicitly overridden (console flash swarm). */
-export declare function assertNativeDaemonAllowed(): void;

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

@@ -1,4 +0,0 @@
-/** 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

@@ -1,6 +0,0 @@
-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";
-export { assessSupervisionHealth, type SupervisionHealth } from "./supervision-health.js";