import type { EntityServiceContext } from './types.js';
export interface ListEntitiesInput {
    entityTypeName: string;
    parentEntityId?: string;
}
/**
 * Lightweight entity stub returned by listEntities.
 */
export interface EntityStub {
    id: string;
    name: string;
    type: string;
}
/**
 * Lists all entities of a given type, returning lightweight stubs.
 *
 * For nested entity types, `parentEntityId` is required to scope the listing
 * to entities within a specific parent.
 *
 * @param container - The project definition container
 * @param entityTypeMap - The entity type map built from the schema
 * @param entityTypeName - The entity type to list
 * @param parentEntityId - Required for nested entity types
 * @returns Array of entity stubs with id, name, and type
 */
export declare function listEntities({ entityTypeName, parentEntityId }: ListEntitiesInput, context: EntityServiceContext): EntityStub[];
/**
 * Gets a single entity by ID, returning its full serialized (name-based) data.
 *
 * @param container - The project definition container
 * @param entityTypeMap - The entity type map built from the schema
 * @param serializedDef - The serialized project definition (with names)
 * @param entityTypeName - The entity type to get
 * @param entityId - The entity ID
 * @returns The serialized entity data, or undefined if not found
 */
export declare function getEntity(entityId: string, context: EntityServiceContext): Record<string, unknown> | undefined;
//# sourceMappingURL=entity-read.d.ts.map