/** @holoscript/core/world — Native world generation adapters/service */
export interface WorldGenerationRequest {
  prompt: string;
  input_image?: string;
  input_images?: string[];
  format: 'mesh' | '3dgs' | 'both' | 'neural_field';
  quality: 'low' | 'medium' | 'high' | 'ultra';
  seed?: number;
  navEnabled?: boolean;
  interactiveMode?: boolean;
}
export interface WorldMetadata {
  format: 'mesh' | '3dgs' | 'both' | 'neural_field';
  bounds: [number, number, number, number, number, number];
  agentStart?: [number, number, number];
  waypoints?: [number, number, number][];
  splatCount?: number;
  triangleCount?: number;
  generationMs?: number;
}
export interface WorldGenerationResult {
  generationId: string;
  assetUrl: string;
  navmeshUrl?: string;
  pointCloudUrl?: string;
  metadata: WorldMetadata;
}
export interface WorldGeneratorAdapter {
  readonly id: string;
  generate(req: WorldGenerationRequest): Promise<WorldGenerationResult>;
  getProgress?(generationId: string): Promise<number>;
  cancel?(generationId: string): Promise<void>;
}
export declare class WorldAdapterRegistry {
  register(adapter: WorldGeneratorAdapter): void;
  get(engineId: string): WorldGeneratorAdapter;
  has(engineId: string): boolean;
  list(): string[];
}
export declare const worldAdapterRegistry: WorldAdapterRegistry;
export interface SovereignWorldAdapterOptions {
  endpoint?: string;
  apiKey?: string;
}
export declare class SovereignWorldAdapter implements WorldGeneratorAdapter {
  readonly id: string;
  constructor(options?: SovereignWorldAdapterOptions);
  generate(req: WorldGenerationRequest): Promise<WorldGenerationResult>;
}
export interface Sovereign3DAdapterOptions {
  baseUrl?: string;
  apiKey?: string;
  timeoutMs?: number;
  pollIntervalMs?: number;
  mockMode?: boolean;
  mockLatencyMs?: number;
}
export declare class Sovereign3DAdapter implements WorldGeneratorAdapter {
  readonly id: string;
  constructor(options?: Sovereign3DAdapterOptions);
  generate(req: WorldGenerationRequest): Promise<WorldGenerationResult>;
  getProgress(generationId: string): Promise<number>;
}
export type GeneratorSource = 'sovereign-local' | 'sovereign-cloud' | 'keyword-fallback' | 'mock';
export interface TraitSuggestionResult {
  traits: string[];
  reasoning: Record<string, string>;
  confidence: number;
  metadata: { source: GeneratorSource };
}
export interface ObjectGenerationResult {
  code: string;
  metadata: {
    description: string;
    traits: string[];
    geometry: string;
    generationMs?: number;
    source: GeneratorSource;
  };
}
export interface SceneGenerationResult {
  code: string;
  metadata: {
    description: string;
    objectCount: number;
    traits: string[];
    generationMs?: number;
    source: GeneratorSource;
  };
}
export interface SovereignGeneratorAdapterOptions {
  localEndpoint?: string;
  cloudEndpoint?: string;
  cloudApiKey?: string;
  localModel?: string;
  cloudModel?: string;
  maxTokens?: number;
  timeoutMs?: number;
  offlineOnly?: boolean;
  mockMode?: boolean;
  mockLatencyMs?: number;
}
export declare class SovereignGeneratorAdapter {
  readonly id: string;
  constructor(options?: SovereignGeneratorAdapterOptions);
  suggestTraits(description: string, context?: string): Promise<TraitSuggestionResult>;
  generateObject(description: string): Promise<ObjectGenerationResult>;
  generateScene(description: string): Promise<SceneGenerationResult>;
}
export interface WorldGenerateEvent extends WorldGenerationRequest {
  nodeId: string;
  engine: string;
}
export interface WorldGenerationStartedEvent {
  nodeId: string;
  engine: string;
  generationId: string;
}
export interface WorldGenerationProgressEvent {
  nodeId: string;
  progress: number;
}
export interface WorldGenerationCompleteEvent {
  nodeId: string;
  assetUrl: string;
  navmeshUrl?: string;
  pointCloudUrl?: string;
  generationId: string;
  metadata: Record<string, unknown>;
}
export interface WorldGenerationErrorEvent {
  nodeId: string;
  error: string;
}
export interface WorldEventEmitter {
  on(event: string, listener: (data: unknown) => void): void;
  off?(event: string, listener: (data: unknown) => void): void;
  emit(event: string, data: unknown): void;
}
export declare class WorldGeneratorService {
  readonly registry: WorldAdapterRegistry;
  constructor(registry?: WorldAdapterRegistry);
  registerDefaultAdapters(): void;
  bindEventEmitter(emitter: WorldEventEmitter): () => void;
  handleGenerateEvent(emitter: WorldEventEmitter, event: WorldGenerateEvent): Promise<void>;
}
export declare const worldGeneratorService: WorldGeneratorService;