export declare const WORKSPACE_KIT_RUNTIME_STAMP_RELATIVE_PATH = ".workspace-kit/runtime.json";
export declare const WORKSPACE_KIT_RUNTIME_LAUNCHER_RELATIVE_PATH = ".workspace-kit/bin/wk";
export declare const WORKSPACE_KIT_RUNTIME_CONTRACT_SCHEMA_VERSION = 1;
export declare const WORKSPACE_KIT_REQUIRED_NODE_MAJOR = 22;
export type WorkspaceKitRuntimeStampV1 = {
    schemaVersion: 1;
    nodeExecutable: string;
    nodeVersion: string;
    arch: string;
    platform: string;
    abi: string;
    packageRoot: string;
    checkedAt: string;
};
export type RuntimeContractIssueCode = "runtime-stamp-missing" | "runtime-stamp-invalid-json" | "runtime-stamp-invalid-shape" | "runtime-launcher-missing" | "runtime-launcher-not-executable" | "runtime-node-missing" | "runtime-node-wrong-major" | "runtime-arch-mismatch" | "runtime-abi-mismatch" | "runtime-platform-mismatch" | "runtime-package-root-missing" | "runtime-host-arch-mismatch" | "runtime-sqlite-load-failed";
export type RuntimeContractIssue = {
    code: RuntimeContractIssueCode;
    message: string;
    expected?: string | number;
    actual?: string | number | null;
};
export type RuntimeStampReadResult = {
    ok: true;
    stamp: WorkspaceKitRuntimeStampV1;
    stampPath: string;
} | {
    ok: false;
    stampPath: string;
    issues: RuntimeContractIssue[];
};
export type RuntimeVerificationResult = {
    ok: boolean;
    stamp: WorkspaceKitRuntimeStampV1 | null;
    issues: RuntimeContractIssue[];
};
export type NativeSqliteSmokeResult = {
    ok: true;
} | {
    ok: false;
    issue: RuntimeContractIssue;
};
export declare function runtimeStampPath(workspacePath: string): string;
export declare function runtimeLauncherPath(workspacePath: string): string;
export declare function generateWorkspaceKitLauncherContent(): string;
export declare function writeRuntimeLauncher(workspacePath: string): string;
export declare function runtimePackageRoot(): string;
export declare function currentRuntimeIdentity(packageRoot?: string, checkedAt?: string): WorkspaceKitRuntimeStampV1;
export declare function parseRuntimeStamp(raw: unknown): {
    ok: true;
    stamp: WorkspaceKitRuntimeStampV1;
} | {
    ok: false;
    issues: RuntimeContractIssue[];
};
export declare function readRuntimeStamp(workspacePath: string): RuntimeStampReadResult;
export declare function writeRuntimeStamp(workspacePath: string, stamp?: WorkspaceKitRuntimeStampV1): WorkspaceKitRuntimeStampV1;
export declare function smokeTestNativeSqlite(packageRoot: string): NativeSqliteSmokeResult;
export declare function verifyRuntimeStamp(stamp: WorkspaceKitRuntimeStampV1, options?: {
    requiredNodeMajor?: number;
    currentIdentity?: WorkspaceKitRuntimeStampV1;
    checkNativeSqlite?: boolean;
}): RuntimeVerificationResult;
export declare function verifyRuntimeStampFile(workspacePath: string, options?: Parameters<typeof verifyRuntimeStamp>[1]): RuntimeVerificationResult;
