export interface InspectWiring {
    /** helix.json exists and its systems block pins engine-core. */
    engineCorePinned: boolean;
    /** Some file under src/ calls world.ready(...). 'no-src' — nothing to scan (not a source project). */
    worldReadyCalled: boolean | 'no-src';
}
export declare function detectInspectWiring(projectDir: string): InspectWiring;
export interface NpcWiring {
    /** Some file under src/ names NpcScene — the world builds NPCs. */
    usesNpcScene: boolean;
    /** A world.ready(...) call whose options object carries `npcs`. */
    npcsHandedOver: boolean;
    /** Set when this world builds NPCs the NPC inspect lane cannot see; null when there is nothing to say. */
    warning: string | null;
}
/**
 * Can `helix npc inspect` see this world's NPCs? A world can be perfectly inspect-wired and still hand
 * over no NPC pool — the helper then installs no npcSample at all, and the tools fail on a page that
 * looks healthy. Cheaper to say so here, where a fix-up session looks first, than after a boot.
 */
export declare function detectNpcWiring(projectDir: string): NpcWiring;